البداية السريعة

import { KalimaLab } from 'kalimalab'​const client = new KalimaLab({ apiKey: process.env.KALIMALAB_API_KEY! })​// Get today's word of the day (0 DP if cached)const word = await client.words.daily()console.log(word.lemma)        // كَتَبَconsole.log(word.primaryGloss) // "to write"console.log(word.primaryPos)   // "verb"console.log(word.pattern)      // "فَعَلَ"​// Search for 5-letter nounsconst results = await client.words.search({ letters: 5, pos: 'noun', limit: 10 })console.log(`Found ${results.meta.total} lemmas`)results.data.forEach((w) => console.log(w.lemma))

{  "data": {    "lemma": "كَتَبَ",    "primaryPos": "verb",    "primaryGloss": "to write",    "root": "كتب",    "pattern": "فَعَلَ",    "transliteration": "kataba",    "frequencyRank": 143  },  "error": null,  "meta": {    "requestId": "req_01j9xyz...",    "responseTimeMs": 8  }}

{  "data": [    {      "lemma": "كَتَبَ",      "primaryPos": "verb",      "primaryGloss": "to write",      "root": "كتب",      "pattern": "فَعَلَ",      "transliteration": "kataba",      "frequencyRank": 47    }  ],  "error": null,  "meta": {    "requestId": "req_abc123",    "responseTimeMs": 12,    "page": 1,    "limit": 20,    "total": 47,    "totalPages": 3  }}

import { KalimaLab, AuthError, RateLimitError } from 'kalimalab'​const client = new KalimaLab({ apiKey: process.env.KALIMALAB_API_KEY! })​async function safeSearch(letters: number, root: string) {  try {    const results = await client.words.search({ letters, root, limit: 20 })    return results.data  } catch (err) {    if (err instanceof AuthError) {      // 401 — key is missing, invalid, or revoked      console.error('Check your KALIMALAB_API_KEY environment variable.')      throw err    }​    if (err instanceof RateLimitError) {      // 429 — too many requests; wait until the limit resets      const waitMs = err.resetAt.getTime() - Date.now()      console.warn(`Rate limited. Retrying in ${Math.ceil(waitMs / 1000)}s.`)      await new Promise((r) => setTimeout(r, waitMs))      return safeSearch(letters, root) // retry once    }​    throw err // unexpected error — let it bubble up  }}​const words = await safeSearch(3, 'كتب')console.log(words)