tdk-api-wrapper 1.1.0 → 1.2.0

package/README.md

@@ -34,6 +34,7 @@ tdk kurallar
 tdk kural kısaltmalar
 tdk karsilastir kalem kağıt
 tdk analiz "Bu güzel kalem masanın üstünde duruyor"
+tdk oneri kale
 ```
 
 Herhangi bir komuta `--json` bayrağı eklendiğinde çıktı, insan-okunur metin yerine tek satırlık JSON olarak basılır (script/otomasyon kullanımı için):
@@ -81,7 +82,7 @@ Aşağıdaki metotlar `TDK` sınıfı üzerinden statik olarak erişilebilir dur
 - **`TDK.analyzeText(text)`**: Bir metindeki (Türkçe bağlaçlar/edatlar hariç) her benzersiz kelimeyi tek tek arayıp ilk anlamını ve kökenini döner.
 
 ### 4. Yardımcı Metotlar
-- **`TDK.getSuggestions(prefix)`**: Kelimenin sadece ilk birkaç harfini girdiğinizde otomatik tamamlama önerilerini çeker.
+- **`TDK.getSuggestions(prefix)`**: TDK'nin ~81 bin kelimelik tam madde listesi üzerinden önek bazlı otomatik tamamlama önerileri döner (ilk çağrıda listeyi indirip önbelleğe alır, sonraki çağrılar anlıktır).
 - **`TDK.getAudioUrl(word)`**: TDK'nin bu kelime için gerçekten bir ses kaydı varsa doğrudan indirme URL'sini döner, yoksa `null`. `downloadAudio(word, destPath)` ile cihazınıza indirebilirsiniz.
 - **`TDK.getDailyContent()`**: TDK anasayfasında yer alan "Günün Kelimesi, Atasözü ve Kuralı" içeriklerini çeker.
 - **`TDK.getWordOfTheDay()`**: `getDailyContent()`'in üzerine ince bir katman; günün kelimesini ve tüm anlamlarını `{ word, meanings }` şeklinde döner.

package/dist/{chunk-P3GX7I53.mjs → chunk-2TA5PMVZ.mjs}

@@ -119,23 +119,60 @@ var TDK = class {
     return meanings;
   }
   /**
-   * Returns suggestions (autocomplete) for a given prefix.
+   * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+   * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+   * The full ~81k-word headword list the site's own autocomplete UI uses is
+   * instead bundled directly into its main JS asset as a
+   * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+   * page to find that asset's current hashed filename, downloads it (a few
+   * MB, only once per process), and extracts the literal out of it. Fragile
+   * scraping of an implementation detail — if TDK's build stops embedding
+   * this, this fails closed to `[]` rather than throwing.
+   */
+  static async fetchAutocompleteData() {
+    try {
+      const homeResponse = await fetch(`${this.BASE_URL}/`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!homeResponse.ok)
+        return [];
+      const html = await homeResponse.text();
+      const scriptMatch = html.match(/src="(\/assets\/index-[^"]+\.js)"/);
+      if (!scriptMatch)
+        return [];
+      const bundleResponse = await fetch(`${this.BASE_URL}${scriptMatch[1]}`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!bundleResponse.ok)
+        return [];
+      const bundleJs = await bundleResponse.text();
+      const startMarker = 'JSON.parse(`[{"madde":';
+      const startIdx = bundleJs.indexOf(startMarker);
+      if (startIdx === -1)
+        return [];
+      const jsonStart = startIdx + "JSON.parse(".length + 1;
+      const jsonEnd = bundleJs.indexOf("`)", jsonStart);
+      if (jsonEnd === -1)
+        return [];
+      const data = JSON.parse(bundleJs.slice(jsonStart, jsonEnd));
+      return data.map((item) => item.madde).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Returns autocomplete suggestions for a given prefix, searched over TDK's
+   * full headword list (see `fetchAutocompleteData`). The list is fetched
+   * and cached once per process regardless of `enableCache()` — the same
+   * caching behavior as before — and only cleared by `clearCache()`.
    */
   static async getSuggestions(prefix) {
+    if (!prefix || prefix.trim() === "")
+      return [];
     if (this.autocompleteCache.length === 0) {
-      try {
-        const response = await fetch(`${this.BASE_URL}/autocomplete.json`, {
-          headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
-        });
-        if (response.ok) {
-          const data = await response.json();
-          this.autocompleteCache = data.map((item) => item.madde);
-        }
-      } catch (e) {
-        return [];
-      }
+      this.autocompleteCache = await this.fetchAutocompleteData();
     }
-    const cleanPrefix = prefix.toLocaleLowerCase("tr-TR");
+    const cleanPrefix = prefix.trim().toLocaleLowerCase("tr-TR");
     return this.autocompleteCache.filter((w) => w.toLocaleLowerCase("tr-TR").startsWith(cleanPrefix)).slice(0, 10);
   }
   /**

package/dist/cli.js

@@ -144,23 +144,60 @@ var TDK = class {
     return meanings;
   }
   /**
-   * Returns suggestions (autocomplete) for a given prefix.
+   * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+   * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+   * The full ~81k-word headword list the site's own autocomplete UI uses is
+   * instead bundled directly into its main JS asset as a
+   * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+   * page to find that asset's current hashed filename, downloads it (a few
+   * MB, only once per process), and extracts the literal out of it. Fragile
+   * scraping of an implementation detail — if TDK's build stops embedding
+   * this, this fails closed to `[]` rather than throwing.
+   */
+  static async fetchAutocompleteData() {
+    try {
+      const homeResponse = await fetch(`${this.BASE_URL}/`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!homeResponse.ok)
+        return [];
+      const html = await homeResponse.text();
+      const scriptMatch = html.match(/src="(\/assets\/index-[^"]+\.js)"/);
+      if (!scriptMatch)
+        return [];
+      const bundleResponse = await fetch(`${this.BASE_URL}${scriptMatch[1]}`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!bundleResponse.ok)
+        return [];
+      const bundleJs = await bundleResponse.text();
+      const startMarker = 'JSON.parse(`[{"madde":';
+      const startIdx = bundleJs.indexOf(startMarker);
+      if (startIdx === -1)
+        return [];
+      const jsonStart = startIdx + "JSON.parse(".length + 1;
+      const jsonEnd = bundleJs.indexOf("`)", jsonStart);
+      if (jsonEnd === -1)
+        return [];
+      const data = JSON.parse(bundleJs.slice(jsonStart, jsonEnd));
+      return data.map((item) => item.madde).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Returns autocomplete suggestions for a given prefix, searched over TDK's
+   * full headword list (see `fetchAutocompleteData`). The list is fetched
+   * and cached once per process regardless of `enableCache()` — the same
+   * caching behavior as before — and only cleared by `clearCache()`.
    */
   static async getSuggestions(prefix) {
+    if (!prefix || prefix.trim() === "")
+      return [];
     if (this.autocompleteCache.length === 0) {
-      try {
-        const response = await fetch(`${this.BASE_URL}/autocomplete.json`, {
-          headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
-        });
-        if (response.ok) {
-          const data = await response.json();
-          this.autocompleteCache = data.map((item) => item.madde);
-        }
-      } catch (e) {
-        return [];
-      }
+      this.autocompleteCache = await this.fetchAutocompleteData();
     }
-    const cleanPrefix = prefix.toLocaleLowerCase("tr-TR");
+    const cleanPrefix = prefix.trim().toLocaleLowerCase("tr-TR");
     return this.autocompleteCache.filter((w) => w.toLocaleLowerCase("tr-TR").startsWith(cleanPrefix)).slice(0, 10);
   }
   /**
@@ -741,7 +778,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "kurallar",
   "kural",
   "karsilastir",
-  "analiz"
+  "analiz",
+  "oneri"
 ]);
 var command = args[0];
 var word = args.slice(1).join(" ");
@@ -767,7 +805,7 @@ async function run() {
   if (!command || command === "--help" || command === "-h") {
     console.log("Kullan\u0131m: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(command ? 0 : 1);
@@ -957,6 +995,19 @@ async function run() {
         });
         break;
       }
+      case "oneri": {
+        if (!word)
+          throw new Error("\xD6nek belirtmelisiniz.");
+        const suggestions = await TDK.getSuggestions(word);
+        printResult(suggestions, () => {
+          if (suggestions.length === 0) {
+            console.log("\xD6neri bulunamad\u0131.");
+          } else {
+            suggestions.forEach((s, i) => console.log(`${i + 1}. ${s}`));
+          }
+        });
+        break;
+      }
       default:
         printError("Bilinmeyen komut.");
     }

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TDK
-} from "./chunk-P3GX7I53.mjs";
+} from "./chunk-2TA5PMVZ.mjs";
 
 // src/cli.ts
 var rawArgs = process.argv.slice(2);
@@ -23,7 +23,8 @@ var KNOWN_COMMANDS = /* @__PURE__ */ new Set([
   "kurallar",
   "kural",
   "karsilastir",
-  "analiz"
+  "analiz",
+  "oneri"
 ]);
 var command = args[0];
 var word = args.slice(1).join(" ");
@@ -49,7 +50,7 @@ async function run() {
   if (!command || command === "--help" || command === "-h") {
     console.log("Kullan\u0131m: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri"
     );
     console.log("Not: Komut belirtilmezse do\u011Frudan kelime anlam\u0131 aran\u0131r (\xF6rn: tdk selam)");
     process.exit(command ? 0 : 1);
@@ -239,6 +240,19 @@ async function run() {
         });
         break;
       }
+      case "oneri": {
+        if (!word)
+          throw new Error("\xD6nek belirtmelisiniz.");
+        const suggestions = await TDK.getSuggestions(word);
+        printResult(suggestions, () => {
+          if (suggestions.length === 0) {
+            console.log("\xD6neri bulunamad\u0131.");
+          } else {
+            suggestions.forEach((s, i) => console.log(`${i + 1}. ${s}`));
+          }
+        });
+        break;
+      }
       default:
         printError("Bilinmeyen komut.");
     }

package/dist/index.d.mts

@@ -158,7 +158,22 @@ declare class TDK {
      */
     static getMeanings(word: string): Promise<string[]>;
     /**
-     * Returns suggestions (autocomplete) for a given prefix.
+     * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+     * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+     * The full ~81k-word headword list the site's own autocomplete UI uses is
+     * instead bundled directly into its main JS asset as a
+     * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+     * page to find that asset's current hashed filename, downloads it (a few
+     * MB, only once per process), and extracts the literal out of it. Fragile
+     * scraping of an implementation detail — if TDK's build stops embedding
+     * this, this fails closed to `[]` rather than throwing.
+     */
+    private static fetchAutocompleteData;
+    /**
+     * Returns autocomplete suggestions for a given prefix, searched over TDK's
+     * full headword list (see `fetchAutocompleteData`). The list is fetched
+     * and cached once per process regardless of `enableCache()` — the same
+     * caching behavior as before — and only cleared by `clearCache()`.
      */
     static getSuggestions(prefix: string): Promise<string[]>;
     /**

package/dist/index.d.ts

@@ -158,7 +158,22 @@ declare class TDK {
      */
     static getMeanings(word: string): Promise<string[]>;
     /**
-     * Returns suggestions (autocomplete) for a given prefix.
+     * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+     * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+     * The full ~81k-word headword list the site's own autocomplete UI uses is
+     * instead bundled directly into its main JS asset as a
+     * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+     * page to find that asset's current hashed filename, downloads it (a few
+     * MB, only once per process), and extracts the literal out of it. Fragile
+     * scraping of an implementation detail — if TDK's build stops embedding
+     * this, this fails closed to `[]` rather than throwing.
+     */
+    private static fetchAutocompleteData;
+    /**
+     * Returns autocomplete suggestions for a given prefix, searched over TDK's
+     * full headword list (see `fetchAutocompleteData`). The list is fetched
+     * and cached once per process regardless of `enableCache()` — the same
+     * caching behavior as before — and only cleared by `clearCache()`.
      */
     static getSuggestions(prefix: string): Promise<string[]>;
     /**

package/dist/index.js

@@ -158,23 +158,60 @@ var TDK = class {
     return meanings;
   }
   /**
-   * Returns suggestions (autocomplete) for a given prefix.
+   * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+   * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+   * The full ~81k-word headword list the site's own autocomplete UI uses is
+   * instead bundled directly into its main JS asset as a
+   * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+   * page to find that asset's current hashed filename, downloads it (a few
+   * MB, only once per process), and extracts the literal out of it. Fragile
+   * scraping of an implementation detail — if TDK's build stops embedding
+   * this, this fails closed to `[]` rather than throwing.
+   */
+  static async fetchAutocompleteData() {
+    try {
+      const homeResponse = await fetch(`${this.BASE_URL}/`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!homeResponse.ok)
+        return [];
+      const html = await homeResponse.text();
+      const scriptMatch = html.match(/src="(\/assets\/index-[^"]+\.js)"/);
+      if (!scriptMatch)
+        return [];
+      const bundleResponse = await fetch(`${this.BASE_URL}${scriptMatch[1]}`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
+      });
+      if (!bundleResponse.ok)
+        return [];
+      const bundleJs = await bundleResponse.text();
+      const startMarker = 'JSON.parse(`[{"madde":';
+      const startIdx = bundleJs.indexOf(startMarker);
+      if (startIdx === -1)
+        return [];
+      const jsonStart = startIdx + "JSON.parse(".length + 1;
+      const jsonEnd = bundleJs.indexOf("`)", jsonStart);
+      if (jsonEnd === -1)
+        return [];
+      const data = JSON.parse(bundleJs.slice(jsonStart, jsonEnd));
+      return data.map((item) => item.madde).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+  /**
+   * Returns autocomplete suggestions for a given prefix, searched over TDK's
+   * full headword list (see `fetchAutocompleteData`). The list is fetched
+   * and cached once per process regardless of `enableCache()` — the same
+   * caching behavior as before — and only cleared by `clearCache()`.
    */
   static async getSuggestions(prefix) {
+    if (!prefix || prefix.trim() === "")
+      return [];
     if (this.autocompleteCache.length === 0) {
-      try {
-        const response = await fetch(`${this.BASE_URL}/autocomplete.json`, {
-          headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" }
-        });
-        if (response.ok) {
-          const data = await response.json();
-          this.autocompleteCache = data.map((item) => item.madde);
-        }
-      } catch (e) {
-        return [];
-      }
+      this.autocompleteCache = await this.fetchAutocompleteData();
     }
-    const cleanPrefix = prefix.toLocaleLowerCase("tr-TR");
+    const cleanPrefix = prefix.trim().toLocaleLowerCase("tr-TR");
     return this.autocompleteCache.filter((w) => w.toLocaleLowerCase("tr-TR").startsWith(cleanPrefix)).slice(0, 10);
   }
   /**

package/dist/index.mjs

@@ -3,7 +3,7 @@ import {
   TDKError,
   TDKNetworkError,
   TDKValidationError
-} from "./chunk-P3GX7I53.mjs";
+} from "./chunk-2TA5PMVZ.mjs";
 export {
   TDK,
   TDKError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tdk-api-wrapper",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "TDK (Türk Dil Kurumu) unofficial live data API wrapper for Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/cli.ts

@@ -21,6 +21,7 @@ const KNOWN_COMMANDS = new Set([
   "kural",
   "karsilastir",
   "analiz",
+  "oneri",
 ]);
 
 let command = args[0];
@@ -51,7 +52,7 @@ async function run() {
   if (!command || command === "--help" || command === "-h") {
     console.log("Kullanım: tdk [komut] <kelime> [--json]");
     console.log(
-      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz"
+      "Komutlar: ara, anlam, koken, ornek, hece, uyum, yazim, gunun, rastgele, esanlam, karsit, yabanci, kurallar, kural, karsilastir, analiz, oneri"
     );
     console.log("Not: Komut belirtilmezse doğrudan kelime anlamı aranır (örn: tdk selam)");
     process.exit(command ? 0 : 1);
@@ -245,6 +246,19 @@ async function run() {
         break;
       }
 
+      case "oneri": {
+        if (!word) throw new Error("Önek belirtmelisiniz.");
+        const suggestions = await TDK.getSuggestions(word);
+        printResult(suggestions, () => {
+          if (suggestions.length === 0) {
+            console.log("Öneri bulunamadı.");
+          } else {
+            suggestions.forEach((s, i) => console.log(`${i + 1}. ${s}`));
+          }
+        });
+        break;
+      }
+
       default:
         printError("Bilinmeyen komut.");
     }

package/src/tdk.ts

@@ -119,24 +119,61 @@ export class TDK {
   }
 
   /**
-   * Returns suggestions (autocomplete) for a given prefix.
+   * `sozluk.gov.tr`'s dedicated `/autocomplete.json` (and `/data/autocomplete.json`)
+   * routes no longer serve JSON — they fall through to the SPA's `index.html`.
+   * The full ~81k-word headword list the site's own autocomplete UI uses is
+   * instead bundled directly into its main JS asset as a
+   * `JSON.parse(\`[{"madde":"..."}]\`)` literal, so this fetches the home
+   * page to find that asset's current hashed filename, downloads it (a few
+   * MB, only once per process), and extracts the literal out of it. Fragile
+   * scraping of an implementation detail — if TDK's build stops embedding
+   * this, this fails closed to `[]` rather than throwing.
+   */
+  private static async fetchAutocompleteData(): Promise<string[]> {
+    try {
+      const homeResponse = await fetch(`${this.BASE_URL}/`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" },
+      });
+      if (!homeResponse.ok) return [];
+      const html = await homeResponse.text();
+
+      const scriptMatch = html.match(/src="(\/assets\/index-[^"]+\.js)"/);
+      if (!scriptMatch) return [];
+
+      const bundleResponse = await fetch(`${this.BASE_URL}${scriptMatch[1]}`, {
+        headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" },
+      });
+      if (!bundleResponse.ok) return [];
+      const bundleJs = await bundleResponse.text();
+
+      const startMarker = 'JSON.parse(`[{"madde":';
+      const startIdx = bundleJs.indexOf(startMarker);
+      if (startIdx === -1) return [];
+      const jsonStart = startIdx + "JSON.parse(".length + 1;
+      const jsonEnd = bundleJs.indexOf("`)", jsonStart);
+      if (jsonEnd === -1) return [];
+
+      const data = JSON.parse(bundleJs.slice(jsonStart, jsonEnd)) as { madde: string }[];
+      return data.map((item) => item.madde).filter(Boolean);
+    } catch {
+      return [];
+    }
+  }
+
+  /**
+   * Returns autocomplete suggestions for a given prefix, searched over TDK's
+   * full headword list (see `fetchAutocompleteData`). The list is fetched
+   * and cached once per process regardless of `enableCache()` — the same
+   * caching behavior as before — and only cleared by `clearCache()`.
    */
   public static async getSuggestions(prefix: string): Promise<string[]> {
+    if (!prefix || prefix.trim() === "") return [];
+
     if (this.autocompleteCache.length === 0) {
-      try {
-        const response = await fetch(`${this.BASE_URL}/autocomplete.json`, {
-          headers: { "User-Agent": "TDK-API-Nodejs-Wrapper/1.0" },
-        });
-        if (response.ok) {
-          const data = await response.json() as { madde: string }[];
-          this.autocompleteCache = data.map(item => item.madde);
-        }
-      } catch (e) {
-        return [];
-      }
+      this.autocompleteCache = await this.fetchAutocompleteData();
     }
-    
-    const cleanPrefix = prefix.toLocaleLowerCase("tr-TR");
+
+    const cleanPrefix = prefix.trim().toLocaleLowerCase("tr-TR");
     return this.autocompleteCache
       .filter(w => w.toLocaleLowerCase("tr-TR").startsWith(cleanPrefix))
       .slice(0, 10);