@lingo.dev/_sdk 0.15.3 → 0.16.1

package/build/index.cjs

@@ -63,10 +63,10 @@ async function getDistinctId(apiKey, apiUrl) {
   const cached = identityCache.get(apiKey);
   if (cached) return cached;
   try {
-    const res = await fetch(`${apiUrl}/whoami`, {
-      method: "POST",
+    const res = await fetch(`${apiUrl}/users/me`, {
+      method: "GET",
       headers: {
-        Authorization: `Bearer ${apiKey}`,
+        "X-API-Key": apiKey,
         "Content-Type": "application/json"
       }
     });
@@ -95,7 +95,7 @@ async function getDistinctId(apiKey, apiUrl) {
 // src/index.ts
 var engineParamsSchema = _zod2.default.object({
   apiKey: _zod2.default.string(),
-  apiUrl: _zod2.default.string().url().default("https://engine.lingo.dev"),
+  apiUrl: _zod2.default.string().url().default("https://api.lingo.dev"),
   batchSize: _zod2.default.number().int().gt(0).lte(250).default(25),
   idealBatchItemSize: _zod2.default.number().int().gt(0).lte(2500).default(250),
   engineId: _zod2.default.string().optional()
@@ -112,31 +112,49 @@ var localizationParamsSchema = _zod2.default.object({
   filePath: _zod2.default.string().optional(),
   triggerType: _zod2.default.enum(["cli", "ci"]).optional()
 });
-var LingoDotDevEngine = (_class = class {
+var LingoDotDevEngine = (_class = class _LingoDotDevEngine {
   
   __init() {this.sessionId = _cuid2.createId.call(void 0, )}
-  get isVNext() {
-    return !!this.config.engineId;
-  }
   get headers() {
-    return this.isVNext ? {
+    return {
       "Content-Type": "application/json; charset=utf-8",
       "X-API-Key": this.config.apiKey
-    } : {
-      "Content-Type": "application/json; charset=utf-8",
-      Authorization: `Bearer ${this.config.apiKey}`
     };
   }
+  static async extractErrorMessage(res) {
+    try {
+      const text = await res.text();
+      const parsed = JSON.parse(text);
+      if (parsed && typeof parsed.message === "string") {
+        return parsed.message;
+      }
+      if (_optionalChain([parsed, 'optionalAccess', _2 => _2._tag]) === "NotFoundError") {
+        return `${parsed.entityType} not found: ${parsed.id}`;
+      }
+      return text;
+    } catch (e2) {
+      return `Unexpected error (${res.status})`;
+    }
+  }
+  static async throwOnHttpError(res, context) {
+    if (res.ok) return;
+    const msg = await _LingoDotDevEngine.extractErrorMessage(res);
+    if (res.status >= 500 && res.status < 600) {
+      throw new Error(
+        `Server error (${res.status}): ${msg}. This may be due to temporary service issues.`
+      );
+    }
+    if (res.status === 400) {
+      throw new Error(`Invalid request: ${msg}`);
+    }
+    throw new Error(context ? `${context}: ${msg}` : msg);
+  }
   /**
    * Create a new LingoDotDevEngine instance
    * @param config - Configuration options for the Engine
    */
   constructor(config) {;_class.prototype.__init.call(this);
-    const parsed = engineParamsSchema.parse(config);
-    if (!config.apiUrl && parsed.engineId) {
-      parsed.apiUrl = "https://api.lingo.dev";
-    }
-    this.config = parsed;
+    this.config = engineParamsSchema.parse(config);
   }
   /**
    * Localize content using the Lingo.dev API
@@ -152,7 +170,6 @@ var LingoDotDevEngine = (_class = class {
     const finalParams = localizationParamsSchema.parse(params);
     const chunkedPayload = this.extractPayloadChunks(finalPayload);
     const processedPayloadChunks = [];
-    const workflowId = _cuid2.createId.call(void 0, );
     for (let i = 0; i < chunkedPayload.length; i++) {
       const chunk = chunkedPayload[i];
       const percentageCompleted = Math.round(
@@ -162,7 +179,6 @@ var LingoDotDevEngine = (_class = class {
         finalParams.sourceLocale,
         finalParams.targetLocale,
         { data: chunk, reference: params.reference, hints: params.hints },
-        workflowId,
         params.fast || false,
         params.filePath,
         params.triggerType,
@@ -180,16 +196,15 @@ var LingoDotDevEngine = (_class = class {
    * @param sourceLocale - Source locale
    * @param targetLocale - Target locale
    * @param payload - Payload containing the chunk to be localized
-   * @param workflowId - Workflow ID for tracking
    * @param fast - Whether to use fast mode
    * @param filePath - Optional file path for metadata
-   * @param triggerType - Optional trigger type for vNext requests
+   * @param triggerType - Optional trigger type
    * @param signal - Optional AbortSignal to cancel the operation
    * @returns Localized chunk
    */
-  async localizeChunk(sourceLocale, targetLocale, payload, workflowId, fast, filePath, triggerType, signal) {
-    const url = this.isVNext ? `${this.config.apiUrl}/process/${this.config.engineId}/localize` : `${this.config.apiUrl}/i18n`;
-    const body = this.isVNext ? {
+  async localizeChunk(sourceLocale, targetLocale, payload, fast, filePath, triggerType, signal) {
+    const url = `${this.config.apiUrl}/process/localize`;
+    const body = {
       params: { fast },
       sourceLocale,
       targetLocale,
@@ -198,16 +213,8 @@ var LingoDotDevEngine = (_class = class {
       hints: payload.hints,
       sessionId: this.sessionId,
       triggerType,
-      metadata: filePath ? { filePath } : void 0
-    } : {
-      params: { workflowId, fast },
-      locale: {
-        source: sourceLocale,
-        target: targetLocale
-      },
-      data: payload.data,
-      reference: payload.reference,
-      hints: payload.hints
+      metadata: filePath ? { filePath } : void 0,
+      ...this.config.engineId && { engineId: this.config.engineId }
     };
     const res = await fetch(url, {
       method: "POST",
@@ -215,19 +222,7 @@ var LingoDotDevEngine = (_class = class {
       body: JSON.stringify(body, null, 2),
       signal
     });
-    if (!res.ok) {
-      if (res.status >= 500 && res.status < 600) {
-        const errorText = await res.text();
-        throw new Error(
-          `Server error (${res.status}): ${res.statusText}. ${errorText}. This may be due to temporary service issues.`
-        );
-      } else if (res.status === 400) {
-        throw new Error(`Invalid request: ${res.statusText}`);
-      } else {
-        const errorText = await res.text();
-        throw new Error(errorText);
-      }
-    }
+    await _LingoDotDevEngine.throwOnHttpError(res);
     const jsonResponse = await res.json();
     if (!jsonResponse.data && jsonResponse.error) {
       throw new Error(jsonResponse.error);
@@ -567,7 +562,7 @@ var LingoDotDevEngine = (_class = class {
             break;
           }
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _2 => _2.textContent, 'optionalAccess', _3 => _3.trim, 'call', _4 => _4()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _3 => _3.textContent, 'optionalAccess', _4 => _4.trim, 'call', _5 => _5()])
           );
           const index = siblings.indexOf(current);
           if (index !== -1) {
@@ -587,7 +582,7 @@ var LingoDotDevEngine = (_class = class {
           parent = parent.parentElement;
         }
         if (node.nodeType === 3) {
-          const text = _optionalChain([node, 'access', _5 => _5.textContent, 'optionalAccess', _6 => _6.trim, 'call', _7 => _7()]) || "";
+          const text = _optionalChain([node, 'access', _6 => _6.textContent, 'optionalAccess', _7 => _7.trim, 'call', _8 => _8()]) || "";
           if (text) {
             extractedContent[getPath(node)] = text;
           }
@@ -602,15 +597,15 @@ var LingoDotDevEngine = (_class = class {
             }
           });
           Array.from(element.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _8 => _8.textContent, 'optionalAccess', _9 => _9.trim, 'call', _10 => _10()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _9 => _9.textContent, 'optionalAccess', _10 => _10.trim, 'call', _11 => _11()])
           ).forEach(processNode);
         }
       };
       Array.from(document.head.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _11 => _11.textContent, 'optionalAccess', _12 => _12.trim, 'call', _13 => _13()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _12 => _12.textContent, 'optionalAccess', _13 => _13.trim, 'call', _14 => _14()])
       ).forEach(processNode);
       Array.from(document.body.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _14 => _14.textContent, 'optionalAccess', _15 => _15.trim, 'call', _16 => _16()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _15 => _15.textContent, 'optionalAccess', _16 => _16.trim, 'call', _17 => _17()])
       ).forEach(processNode);
       const localizedContent = await this._localizeRaw(
         extractedContent,
@@ -626,10 +621,10 @@ var LingoDotDevEngine = (_class = class {
         let current = parent;
         for (const index of indices) {
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _17 => _17.textContent, 'optionalAccess', _18 => _18.trim, 'call', _19 => _19()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _18 => _18.textContent, 'optionalAccess', _19 => _19.trim, 'call', _20 => _20()])
           );
           current = siblings[parseInt(index)] || null;
-          if (_optionalChain([current, 'optionalAccess', _20 => _20.nodeType]) === 1) {
+          if (_optionalChain([current, 'optionalAccess', _21 => _21.nodeType]) === 1) {
             parent = current;
           }
         }
@@ -677,21 +672,17 @@ var LingoDotDevEngine = (_class = class {
       trackProps
     );
     try {
-      const url = this.isVNext ? `${this.config.apiUrl}/process/recognize` : `${this.config.apiUrl}/recognize`;
+      const url = `${this.config.apiUrl}/process/recognize`;
       const response = await fetch(url, {
         method: "POST",
         headers: this.headers,
         body: JSON.stringify({ text }),
         signal
       });
-      if (!response.ok) {
-        if (response.status >= 500 && response.status < 600) {
-          throw new Error(
-            `Server error (${response.status}): ${response.statusText}. This may be due to temporary service issues.`
-          );
-        }
-        throw new Error(`Error recognizing locale: ${response.statusText}`);
-      }
+      await _LingoDotDevEngine.throwOnHttpError(
+        response,
+        "Error recognizing locale"
+      );
       const jsonResponse = await response.json();
       trackEvent(
         this.config.apiKey,
@@ -714,35 +705,29 @@ var LingoDotDevEngine = (_class = class {
     }
   }
   async whoami(signal) {
-    const url = this.isVNext ? `${this.config.apiUrl}/users/me` : `${this.config.apiUrl}/whoami`;
-    try {
-      const res = await fetch(url, {
-        method: this.isVNext ? "GET" : "POST",
-        headers: this.headers,
-        signal
-      });
-      if (res.ok) {
-        const payload = await res.json();
-        if (!_optionalChain([payload, 'optionalAccess', _21 => _21.email])) {
-          return null;
-        }
-        return {
-          email: payload.email,
-          id: payload.id
-        };
-      }
-      if (res.status >= 500 && res.status < 600) {
-        throw new Error(
-          `Server error (${res.status}): ${res.statusText}. This may be due to temporary service issues.`
-        );
-      }
-      return null;
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("Server error")) {
-        throw error;
+    const url = `${this.config.apiUrl}/users/me`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: this.headers,
+      signal
+    });
+    if (res.ok) {
+      const payload = await res.json();
+      if (!_optionalChain([payload, 'optionalAccess', _22 => _22.email])) {
+        return null;
       }
-      return null;
+      return {
+        email: payload.email,
+        id: payload.id
+      };
+    }
+    if (res.status >= 500 && res.status < 600) {
+      const msg = await _LingoDotDevEngine.extractErrorMessage(res);
+      throw new Error(
+        `Server error (${res.status}): ${msg}. This may be due to temporary service issues.`
+      );
     }
+    return null;
   }
 }, _class);
 var ReplexicaEngine = (_class2 = class _ReplexicaEngine extends LingoDotDevEngine {

package/build/index.d.cts

@@ -29,8 +29,9 @@ declare const localizationParamsSchema: Z.ZodObject<{
 declare class LingoDotDevEngine {
     protected config: Z.infer<typeof engineParamsSchema>;
     private readonly sessionId;
-    private get isVNext();
     private get headers();
+    private static extractErrorMessage;
+    private static throwOnHttpError;
     /**
      * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
@@ -51,10 +52,9 @@ declare class LingoDotDevEngine {
      * @param sourceLocale - Source locale
      * @param targetLocale - Target locale
      * @param payload - Payload containing the chunk to be localized
-     * @param workflowId - Workflow ID for tracking
      * @param fast - Whether to use fast mode
      * @param filePath - Optional file path for metadata
-     * @param triggerType - Optional trigger type for vNext requests
+     * @param triggerType - Optional trigger type
      * @param signal - Optional AbortSignal to cancel the operation
      * @returns Localized chunk
      */

package/build/index.d.ts

@@ -29,8 +29,9 @@ declare const localizationParamsSchema: Z.ZodObject<{
 declare class LingoDotDevEngine {
     protected config: Z.infer<typeof engineParamsSchema>;
     private readonly sessionId;
-    private get isVNext();
     private get headers();
+    private static extractErrorMessage;
+    private static throwOnHttpError;
     /**
      * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
@@ -51,10 +52,9 @@ declare class LingoDotDevEngine {
      * @param sourceLocale - Source locale
      * @param targetLocale - Target locale
      * @param payload - Payload containing the chunk to be localized
-     * @param workflowId - Workflow ID for tracking
      * @param fast - Whether to use fast mode
      * @param filePath - Optional file path for metadata
-     * @param triggerType - Optional trigger type for vNext requests
+     * @param triggerType - Optional trigger type
      * @param signal - Optional AbortSignal to cancel the operation
      * @returns Localized chunk
      */

package/build/index.mjs

@@ -63,10 +63,10 @@ async function getDistinctId(apiKey, apiUrl) {
   const cached = identityCache.get(apiKey);
   if (cached) return cached;
   try {
-    const res = await fetch(`${apiUrl}/whoami`, {
-      method: "POST",
+    const res = await fetch(`${apiUrl}/users/me`, {
+      method: "GET",
       headers: {
-        Authorization: `Bearer ${apiKey}`,
+        "X-API-Key": apiKey,
         "Content-Type": "application/json"
       }
     });
@@ -95,7 +95,7 @@ async function getDistinctId(apiKey, apiUrl) {
 // src/index.ts
 var engineParamsSchema = Z.object({
   apiKey: Z.string(),
-  apiUrl: Z.string().url().default("https://engine.lingo.dev"),
+  apiUrl: Z.string().url().default("https://api.lingo.dev"),
   batchSize: Z.number().int().gt(0).lte(250).default(25),
   idealBatchItemSize: Z.number().int().gt(0).lte(2500).default(250),
   engineId: Z.string().optional()
@@ -112,31 +112,49 @@ var localizationParamsSchema = Z.object({
   filePath: Z.string().optional(),
   triggerType: Z.enum(["cli", "ci"]).optional()
 });
-var LingoDotDevEngine = class {
+var LingoDotDevEngine = class _LingoDotDevEngine {
   config;
   sessionId = createId();
-  get isVNext() {
-    return !!this.config.engineId;
-  }
   get headers() {
-    return this.isVNext ? {
+    return {
       "Content-Type": "application/json; charset=utf-8",
       "X-API-Key": this.config.apiKey
-    } : {
-      "Content-Type": "application/json; charset=utf-8",
-      Authorization: `Bearer ${this.config.apiKey}`
     };
   }
+  static async extractErrorMessage(res) {
+    try {
+      const text = await res.text();
+      const parsed = JSON.parse(text);
+      if (parsed && typeof parsed.message === "string") {
+        return parsed.message;
+      }
+      if (parsed?._tag === "NotFoundError") {
+        return `${parsed.entityType} not found: ${parsed.id}`;
+      }
+      return text;
+    } catch {
+      return `Unexpected error (${res.status})`;
+    }
+  }
+  static async throwOnHttpError(res, context) {
+    if (res.ok) return;
+    const msg = await _LingoDotDevEngine.extractErrorMessage(res);
+    if (res.status >= 500 && res.status < 600) {
+      throw new Error(
+        `Server error (${res.status}): ${msg}. This may be due to temporary service issues.`
+      );
+    }
+    if (res.status === 400) {
+      throw new Error(`Invalid request: ${msg}`);
+    }
+    throw new Error(context ? `${context}: ${msg}` : msg);
+  }
   /**
    * Create a new LingoDotDevEngine instance
    * @param config - Configuration options for the Engine
    */
   constructor(config) {
-    const parsed = engineParamsSchema.parse(config);
-    if (!config.apiUrl && parsed.engineId) {
-      parsed.apiUrl = "https://api.lingo.dev";
-    }
-    this.config = parsed;
+    this.config = engineParamsSchema.parse(config);
   }
   /**
    * Localize content using the Lingo.dev API
@@ -152,7 +170,6 @@ var LingoDotDevEngine = class {
     const finalParams = localizationParamsSchema.parse(params);
     const chunkedPayload = this.extractPayloadChunks(finalPayload);
     const processedPayloadChunks = [];
-    const workflowId = createId();
     for (let i = 0; i < chunkedPayload.length; i++) {
       const chunk = chunkedPayload[i];
       const percentageCompleted = Math.round(
@@ -162,7 +179,6 @@ var LingoDotDevEngine = class {
         finalParams.sourceLocale,
         finalParams.targetLocale,
         { data: chunk, reference: params.reference, hints: params.hints },
-        workflowId,
         params.fast || false,
         params.filePath,
         params.triggerType,
@@ -180,16 +196,15 @@ var LingoDotDevEngine = class {
    * @param sourceLocale - Source locale
    * @param targetLocale - Target locale
    * @param payload - Payload containing the chunk to be localized
-   * @param workflowId - Workflow ID for tracking
    * @param fast - Whether to use fast mode
    * @param filePath - Optional file path for metadata
-   * @param triggerType - Optional trigger type for vNext requests
+   * @param triggerType - Optional trigger type
    * @param signal - Optional AbortSignal to cancel the operation
    * @returns Localized chunk
    */
-  async localizeChunk(sourceLocale, targetLocale, payload, workflowId, fast, filePath, triggerType, signal) {
-    const url = this.isVNext ? `${this.config.apiUrl}/process/${this.config.engineId}/localize` : `${this.config.apiUrl}/i18n`;
-    const body = this.isVNext ? {
+  async localizeChunk(sourceLocale, targetLocale, payload, fast, filePath, triggerType, signal) {
+    const url = `${this.config.apiUrl}/process/localize`;
+    const body = {
       params: { fast },
       sourceLocale,
       targetLocale,
@@ -198,16 +213,8 @@ var LingoDotDevEngine = class {
       hints: payload.hints,
       sessionId: this.sessionId,
       triggerType,
-      metadata: filePath ? { filePath } : void 0
-    } : {
-      params: { workflowId, fast },
-      locale: {
-        source: sourceLocale,
-        target: targetLocale
-      },
-      data: payload.data,
-      reference: payload.reference,
-      hints: payload.hints
+      metadata: filePath ? { filePath } : void 0,
+      ...this.config.engineId && { engineId: this.config.engineId }
     };
     const res = await fetch(url, {
       method: "POST",
@@ -215,19 +222,7 @@ var LingoDotDevEngine = class {
       body: JSON.stringify(body, null, 2),
       signal
     });
-    if (!res.ok) {
-      if (res.status >= 500 && res.status < 600) {
-        const errorText = await res.text();
-        throw new Error(
-          `Server error (${res.status}): ${res.statusText}. ${errorText}. This may be due to temporary service issues.`
-        );
-      } else if (res.status === 400) {
-        throw new Error(`Invalid request: ${res.statusText}`);
-      } else {
-        const errorText = await res.text();
-        throw new Error(errorText);
-      }
-    }
+    await _LingoDotDevEngine.throwOnHttpError(res);
     const jsonResponse = await res.json();
     if (!jsonResponse.data && jsonResponse.error) {
       throw new Error(jsonResponse.error);
@@ -677,21 +672,17 @@ var LingoDotDevEngine = class {
       trackProps
     );
     try {
-      const url = this.isVNext ? `${this.config.apiUrl}/process/recognize` : `${this.config.apiUrl}/recognize`;
+      const url = `${this.config.apiUrl}/process/recognize`;
       const response = await fetch(url, {
         method: "POST",
         headers: this.headers,
         body: JSON.stringify({ text }),
         signal
       });
-      if (!response.ok) {
-        if (response.status >= 500 && response.status < 600) {
-          throw new Error(
-            `Server error (${response.status}): ${response.statusText}. This may be due to temporary service issues.`
-          );
-        }
-        throw new Error(`Error recognizing locale: ${response.statusText}`);
-      }
+      await _LingoDotDevEngine.throwOnHttpError(
+        response,
+        "Error recognizing locale"
+      );
       const jsonResponse = await response.json();
       trackEvent(
         this.config.apiKey,
@@ -714,35 +705,29 @@ var LingoDotDevEngine = class {
     }
   }
   async whoami(signal) {
-    const url = this.isVNext ? `${this.config.apiUrl}/users/me` : `${this.config.apiUrl}/whoami`;
-    try {
-      const res = await fetch(url, {
-        method: this.isVNext ? "GET" : "POST",
-        headers: this.headers,
-        signal
-      });
-      if (res.ok) {
-        const payload = await res.json();
-        if (!payload?.email) {
-          return null;
-        }
-        return {
-          email: payload.email,
-          id: payload.id
-        };
-      }
-      if (res.status >= 500 && res.status < 600) {
-        throw new Error(
-          `Server error (${res.status}): ${res.statusText}. This may be due to temporary service issues.`
-        );
-      }
-      return null;
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("Server error")) {
-        throw error;
+    const url = `${this.config.apiUrl}/users/me`;
+    const res = await fetch(url, {
+      method: "GET",
+      headers: this.headers,
+      signal
+    });
+    if (res.ok) {
+      const payload = await res.json();
+      if (!payload?.email) {
+        return null;
       }
-      return null;
+      return {
+        email: payload.email,
+        id: payload.id
+      };
+    }
+    if (res.status >= 500 && res.status < 600) {
+      const msg = await _LingoDotDevEngine.extractErrorMessage(res);
+      throw new Error(
+        `Server error (${res.status}): ${msg}. This may be due to temporary service issues.`
+      );
     }
+    return null;
   }
 };
 var ReplexicaEngine = class _ReplexicaEngine extends LingoDotDevEngine {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/_sdk",
-  "version": "0.15.3",
+  "version": "0.16.1",
   "description": "Lingo.dev JS SDK",
   "private": false,
   "repository": {
@@ -28,7 +28,7 @@
     "jsdom": "25.0.1",
     "posthog-node": "5.14.0",
     "zod": "4.1.12",
-    "@lingo.dev/_spec": "0.48.1"
+    "@lingo.dev/_spec": "0.49.0"
   },
   "devDependencies": {
     "@types/jsdom": "21.1.7",