@lingo.dev/_sdk 0.16.5 → 0.17.1

package/build/index.cjs

@@ -135,6 +135,12 @@ var localizationParamsSchema = _zod2.default.object({
   filePath: _zod2.default.string().optional(),
   triggerType: _zod2.default.enum(["cli", "ci"]).optional()
 });
+var estimateItemsSchema = _zod2.default.array(
+  _zod2.default.object({
+    targetLocale: normalizedLocaleCodeSchema,
+    sourceChars: _zod2.default.number().int().nonnegative()
+  })
+).min(1);
 var LingoDotDevEngine = (_class = class _LingoDotDevEngine {
   
   __init() {this.sessionId = _cuid2.createId.call(void 0, )}
@@ -799,6 +805,27 @@ var LingoDotDevEngine = (_class = class _LingoDotDevEngine {
       throw error;
     }
   }
+  /**
+   * Estimate the cost of localizing content BEFORE submitting it.
+   * Pure computation server-side — nothing is translated, stored, or billed.
+   * @param items - Per-target-locale character counts of translatable source
+   * text (sum of source string lengths, excluding keys and markup). Duplicate
+   * locales are summed by the server.
+   * @param signal - Optional AbortSignal to cancel the operation
+   * @returns Promise resolving to an approximate cost with per-locale breakdown
+   */
+  async estimate(items, signal) {
+    const parsedItems = estimateItemsSchema.parse(items);
+    const url = `${this.config.apiUrl}/process/estimate`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({ items: parsedItems }),
+      signal
+    });
+    await _LingoDotDevEngine.throwOnHttpError(res, "Error estimating cost");
+    return res.json();
+  }
   async whoami(signal) {
     const url = `${this.config.apiUrl}/users/me`;
     const res = await fetch(url, {

package/build/index.d.cts

@@ -23,6 +23,27 @@ declare const localizationParamsSchema: Z.ZodObject<{
         ci: "ci";
     }>>;
 }, Z.core.$strip>;
+/**
+ * Approximate localization cost returned by `/process/estimate`.
+ * `approximate` is always true — the estimate is a chars→tokens heuristic,
+ * not a quote. Actual cost may differ.
+ */
+type CostEstimate = {
+    approximate: boolean;
+    totals: {
+        sourceChars: number;
+        estimatedOutputTokens: number;
+        estimatedLlmCostUsd: number;
+        estimatedLocalizationCostUsd: number;
+        estimatedTotalCostUsd: number;
+    };
+    byLocale: {
+        targetLocale: string;
+        sourceChars: number;
+        estimatedOutputTokens: number;
+        estimatedCostUsd: number;
+    }[];
+};
 /**
  * LingoDotDevEngine class for interacting with the LingoDotDev API
  * A powerful localization engine that supports various content types including
@@ -182,6 +203,19 @@ declare class LingoDotDevEngine {
      * @returns Promise resolving to a locale code (e.g., 'en', 'es', 'fr')
      */
     recognizeLocale(text: string, signal?: AbortSignal): Promise<LocaleCode>;
+    /**
+     * Estimate the cost of localizing content BEFORE submitting it.
+     * Pure computation server-side — nothing is translated, stored, or billed.
+     * @param items - Per-target-locale character counts of translatable source
+     * text (sum of source string lengths, excluding keys and markup). Duplicate
+     * locales are summed by the server.
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns Promise resolving to an approximate cost with per-locale breakdown
+     */
+    estimate(items: {
+        targetLocale: string;
+        sourceChars: number;
+    }[], signal?: AbortSignal): Promise<CostEstimate>;
     whoami(signal?: AbortSignal): Promise<{
         email: string;
         id: string;
@@ -202,4 +236,4 @@ declare class LingoEngine extends LingoDotDevEngine {
     constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
 }
 
-export { LingoDotDevEngine, LingoEngine, ReplexicaEngine };
+export { type CostEstimate, LingoDotDevEngine, LingoEngine, ReplexicaEngine };

package/build/index.d.ts

@@ -23,6 +23,27 @@ declare const localizationParamsSchema: Z.ZodObject<{
         ci: "ci";
     }>>;
 }, Z.core.$strip>;
+/**
+ * Approximate localization cost returned by `/process/estimate`.
+ * `approximate` is always true — the estimate is a chars→tokens heuristic,
+ * not a quote. Actual cost may differ.
+ */
+type CostEstimate = {
+    approximate: boolean;
+    totals: {
+        sourceChars: number;
+        estimatedOutputTokens: number;
+        estimatedLlmCostUsd: number;
+        estimatedLocalizationCostUsd: number;
+        estimatedTotalCostUsd: number;
+    };
+    byLocale: {
+        targetLocale: string;
+        sourceChars: number;
+        estimatedOutputTokens: number;
+        estimatedCostUsd: number;
+    }[];
+};
 /**
  * LingoDotDevEngine class for interacting with the LingoDotDev API
  * A powerful localization engine that supports various content types including
@@ -182,6 +203,19 @@ declare class LingoDotDevEngine {
      * @returns Promise resolving to a locale code (e.g., 'en', 'es', 'fr')
      */
     recognizeLocale(text: string, signal?: AbortSignal): Promise<LocaleCode>;
+    /**
+     * Estimate the cost of localizing content BEFORE submitting it.
+     * Pure computation server-side — nothing is translated, stored, or billed.
+     * @param items - Per-target-locale character counts of translatable source
+     * text (sum of source string lengths, excluding keys and markup). Duplicate
+     * locales are summed by the server.
+     * @param signal - Optional AbortSignal to cancel the operation
+     * @returns Promise resolving to an approximate cost with per-locale breakdown
+     */
+    estimate(items: {
+        targetLocale: string;
+        sourceChars: number;
+    }[], signal?: AbortSignal): Promise<CostEstimate>;
     whoami(signal?: AbortSignal): Promise<{
         email: string;
         id: string;
@@ -202,4 +236,4 @@ declare class LingoEngine extends LingoDotDevEngine {
     constructor(config: Partial<Z.infer<typeof engineParamsSchema>>);
 }
 
-export { LingoDotDevEngine, LingoEngine, ReplexicaEngine };
+export { type CostEstimate, LingoDotDevEngine, LingoEngine, ReplexicaEngine };

package/build/index.mjs

@@ -135,6 +135,12 @@ var localizationParamsSchema = Z.object({
   filePath: Z.string().optional(),
   triggerType: Z.enum(["cli", "ci"]).optional()
 });
+var estimateItemsSchema = Z.array(
+  Z.object({
+    targetLocale: normalizedLocaleCodeSchema,
+    sourceChars: Z.number().int().nonnegative()
+  })
+).min(1);
 var LingoDotDevEngine = class _LingoDotDevEngine {
   config;
   sessionId = createId();
@@ -799,6 +805,27 @@ var LingoDotDevEngine = class _LingoDotDevEngine {
       throw error;
     }
   }
+  /**
+   * Estimate the cost of localizing content BEFORE submitting it.
+   * Pure computation server-side — nothing is translated, stored, or billed.
+   * @param items - Per-target-locale character counts of translatable source
+   * text (sum of source string lengths, excluding keys and markup). Duplicate
+   * locales are summed by the server.
+   * @param signal - Optional AbortSignal to cancel the operation
+   * @returns Promise resolving to an approximate cost with per-locale breakdown
+   */
+  async estimate(items, signal) {
+    const parsedItems = estimateItemsSchema.parse(items);
+    const url = `${this.config.apiUrl}/process/estimate`;
+    const res = await fetch(url, {
+      method: "POST",
+      headers: this.headers,
+      body: JSON.stringify({ items: parsedItems }),
+      signal
+    });
+    await _LingoDotDevEngine.throwOnHttpError(res, "Error estimating cost");
+    return res.json();
+  }
   async whoami(signal) {
     const url = `${this.config.apiUrl}/users/me`;
     const res = await fetch(url, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_sdk",
-  "version": "0.16.5",
+  "version": "0.17.1",
   "description": "Lingo.dev JS SDK",
   "private": false,
   "repository": {
@@ -27,14 +27,14 @@
     "@paralleldrive/cuid2": "2.2.2",
     "jsdom": "25.0.1",
     "posthog-node": "5.14.0",
-    "zod": "4.1.12",
-    "@lingo.dev/_spec": "0.49.1"
+    "zod": "4.4.3",
+    "@lingo.dev/_spec": "0.49.2"
   },
   "devDependencies": {
     "@types/jsdom": "21.1.7",
     "tsup": "8.5.1",
     "typescript": "5.9.3",
-    "vitest": "3.1.2"
+    "vitest": "3.2.6"
   },
   "scripts": {
     "dev": "tsup --watch",