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

import { KalimaLab } from '@kalimalab/sdk'const client = new KalimaLab({ apiKey: process.env.KALIMALAB_API_KEY! })// Get a random Arabic wordconst word = await client.words.random()console.log(word.arabic)     // e.g. "كَتَبَ"console.log(word.meaning_en) // "to write"console.log(word.root)       // "كتب"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} words`)results.data.forEach((w) => console.log(w.arabic))

{  "data": {    "id": "word_01j9abc123",    "arabic": "كَتَبَ",    "root": "كتب",    "pattern": "فَعَلَ",    "pos": "verb",    "meaning_en": "to write",    "meaning_ar": "قام بالكتابة",    "transliteration": "kataba",    "frequency_rank": 143,    "example_sentence": "كَتَبَ الطالبُ الدرسَ"  },  "error": null,  "meta": {    "requestId": "req_01j9xyz...",    "responseTimeMs": 8  }}

{  "data": [    {      "id": "wrd_001",      "word": "كَتَبَ",      "meaning_en": "to write",      "meaning_ar": "قام بفعل الكتابة",      "part_of_speech": "verb",      "letter_count": 3,      "root": "كتب",      "pattern": "فَعَلَ",      "frequency_rank": 47,      "is_verb": true    }  ],  "error": null,  "meta": {    "requestId": "req_abc123",    "responseTimeMs": 12,    "page": 1,    "limit": 20,    "total": 47,    "totalPages": 3  }}

import { KalimaLab, AuthError, RateLimitError } from '@kalimalab/sdk'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)