@lingo.dev/_sdk 0.16.0 → 0.16.2

package/build/index.cjs

@@ -35,10 +35,10 @@ function trackEvent(apiKey, apiUrl, event, properties) {
   );
 }
 async function resolveIdentityAndCapture(apiKey, apiUrl, event, properties) {
-  const identityInfo = await getDistinctId(apiKey, apiUrl);
+  const { identity, email } = await getDistinctId(apiKey, apiUrl);
   if (process.env.DEBUG === "true") {
     console.log(
-      `[Tracking] Event: ${event}, ID: ${identityInfo.distinct_id}, Source: ${identityInfo.distinct_id_source}`
+      `[Tracking] Event: ${event}, ID: ${identity.distinct_id}, Source: ${identity.distinct_id_source}`
     );
   }
   const { PostHog } = await Promise.resolve().then(() => _interopRequireWildcard(require("posthog-node")));
@@ -47,17 +47,27 @@ async function resolveIdentityAndCapture(apiKey, apiUrl, event, properties) {
     flushAt: 1,
     flushInterval: 0
   });
-  await posthog.capture({
-    distinctId: identityInfo.distinct_id,
-    event,
-    properties: {
-      ...properties,
-      tracking_version: TRACKING_VERSION,
-      sdk_package: SDK_PACKAGE,
-      distinct_id_source: identityInfo.distinct_id_source
+  try {
+    await posthog.capture({
+      distinctId: identity.distinct_id,
+      event,
+      properties: {
+        ...properties,
+        $set: { ..._optionalChain([properties, 'optionalAccess', _ => _.$set]) || {}, ...email ? { email } : {} },
+        tracking_version: TRACKING_VERSION,
+        sdk_package: SDK_PACKAGE,
+        distinct_id_source: identity.distinct_id_source
+      }
+    });
+    if (email) {
+      await posthog.alias({
+        distinctId: identity.distinct_id,
+        alias: email
+      });
     }
-  });
-  await posthog.shutdown();
+  } finally {
+    await posthog.shutdown();
+  }
 }
 async function getDistinctId(apiKey, apiUrl) {
   const cached = identityCache.get(apiKey);
@@ -72,24 +82,27 @@ async function getDistinctId(apiKey, apiUrl) {
     });
     if (res.ok) {
       const payload = await res.json();
-      if (_optionalChain([payload, 'optionalAccess', _ => _.email])) {
-        const identity2 = {
-          distinct_id: payload.email,
-          distinct_id_source: "email"
+      if (_optionalChain([payload, 'optionalAccess', _2 => _2.id])) {
+        const result = {
+          identity: {
+            distinct_id: payload.id,
+            distinct_id_source: "database_id"
+          },
+          email: payload.email || void 0
         };
-        identityCache.set(apiKey, identity2);
-        return identity2;
+        identityCache.set(apiKey, result);
+        return result;
       }
     }
   } catch (e) {
   }
   const hash = _crypto.createHash.call(void 0, "sha256").update(apiKey).digest("hex").slice(0, 16);
-  const identity = {
-    distinct_id: `apikey-${hash}`,
-    distinct_id_source: "api_key_hash"
+  return {
+    identity: {
+      distinct_id: `apikey-${hash}`,
+      distinct_id_source: "api_key_hash"
+    }
   };
-  identityCache.set(apiKey, identity);
-  return identity;
 }
 
 // src/index.ts
@@ -112,7 +125,7 @@ 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 headers() {
@@ -121,6 +134,34 @@ var LingoDotDevEngine = (_class = class {
       "X-API-Key": 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', _3 => _3._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
@@ -142,7 +183,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(
@@ -152,7 +192,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,
@@ -170,14 +209,13 @@ 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
    * @param signal - Optional AbortSignal to cancel the operation
    * @returns Localized chunk
    */
-  async localizeChunk(sourceLocale, targetLocale, payload, workflowId, fast, filePath, triggerType, signal) {
+  async localizeChunk(sourceLocale, targetLocale, payload, fast, filePath, triggerType, signal) {
     const url = `${this.config.apiUrl}/process/localize`;
     const body = {
       params: { fast },
@@ -197,19 +235,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);
@@ -549,7 +575,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', _4 => _4.textContent, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6()])
           );
           const index = siblings.indexOf(current);
           if (index !== -1) {
@@ -569,7 +595,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', _7 => _7.textContent, 'optionalAccess', _8 => _8.trim, 'call', _9 => _9()]) || "";
           if (text) {
             extractedContent[getPath(node)] = text;
           }
@@ -584,15 +610,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', _10 => _10.textContent, 'optionalAccess', _11 => _11.trim, 'call', _12 => _12()])
           ).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', _13 => _13.textContent, 'optionalAccess', _14 => _14.trim, 'call', _15 => _15()])
       ).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', _16 => _16.textContent, 'optionalAccess', _17 => _17.trim, 'call', _18 => _18()])
       ).forEach(processNode);
       const localizedContent = await this._localizeRaw(
         extractedContent,
@@ -608,10 +634,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', _19 => _19.textContent, 'optionalAccess', _20 => _20.trim, 'call', _21 => _21()])
           );
           current = siblings[parseInt(index)] || null;
-          if (_optionalChain([current, 'optionalAccess', _20 => _20.nodeType]) === 1) {
+          if (_optionalChain([current, 'optionalAccess', _22 => _22.nodeType]) === 1) {
             parent = current;
           }
         }
@@ -666,14 +692,10 @@ var LingoDotDevEngine = (_class = class {
         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,
@@ -697,34 +719,28 @@ var LingoDotDevEngine = (_class = class {
   }
   async whoami(signal) {
     const url = `${this.config.apiUrl}/users/me`;
-    try {
-      const res = await fetch(url, {
-        method: "GET",
-        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 res = await fetch(url, {
+      method: "GET",
+      headers: this.headers,
+      signal
+    });
+    if (res.ok) {
+      const payload = await res.json();
+      if (!_optionalChain([payload, 'optionalAccess', _23 => _23.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

@@ -30,6 +30,8 @@ declare class LingoDotDevEngine {
     protected config: Z.infer<typeof engineParamsSchema>;
     private readonly sessionId;
     private get headers();
+    private static extractErrorMessage;
+    private static throwOnHttpError;
     /**
      * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
@@ -50,7 +52,6 @@ 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

package/build/index.d.ts

@@ -30,6 +30,8 @@ declare class LingoDotDevEngine {
     protected config: Z.infer<typeof engineParamsSchema>;
     private readonly sessionId;
     private get headers();
+    private static extractErrorMessage;
+    private static throwOnHttpError;
     /**
      * Create a new LingoDotDevEngine instance
      * @param config - Configuration options for the Engine
@@ -50,7 +52,6 @@ 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

package/build/index.mjs

@@ -35,10 +35,10 @@ function trackEvent(apiKey, apiUrl, event, properties) {
   );
 }
 async function resolveIdentityAndCapture(apiKey, apiUrl, event, properties) {
-  const identityInfo = await getDistinctId(apiKey, apiUrl);
+  const { identity, email } = await getDistinctId(apiKey, apiUrl);
   if (process.env.DEBUG === "true") {
     console.log(
-      `[Tracking] Event: ${event}, ID: ${identityInfo.distinct_id}, Source: ${identityInfo.distinct_id_source}`
+      `[Tracking] Event: ${event}, ID: ${identity.distinct_id}, Source: ${identity.distinct_id_source}`
     );
   }
   const { PostHog } = await import("posthog-node");
@@ -47,17 +47,27 @@ async function resolveIdentityAndCapture(apiKey, apiUrl, event, properties) {
     flushAt: 1,
     flushInterval: 0
   });
-  await posthog.capture({
-    distinctId: identityInfo.distinct_id,
-    event,
-    properties: {
-      ...properties,
-      tracking_version: TRACKING_VERSION,
-      sdk_package: SDK_PACKAGE,
-      distinct_id_source: identityInfo.distinct_id_source
+  try {
+    await posthog.capture({
+      distinctId: identity.distinct_id,
+      event,
+      properties: {
+        ...properties,
+        $set: { ...properties?.$set || {}, ...email ? { email } : {} },
+        tracking_version: TRACKING_VERSION,
+        sdk_package: SDK_PACKAGE,
+        distinct_id_source: identity.distinct_id_source
+      }
+    });
+    if (email) {
+      await posthog.alias({
+        distinctId: identity.distinct_id,
+        alias: email
+      });
     }
-  });
-  await posthog.shutdown();
+  } finally {
+    await posthog.shutdown();
+  }
 }
 async function getDistinctId(apiKey, apiUrl) {
   const cached = identityCache.get(apiKey);
@@ -72,24 +82,27 @@ async function getDistinctId(apiKey, apiUrl) {
     });
     if (res.ok) {
       const payload = await res.json();
-      if (payload?.email) {
-        const identity2 = {
-          distinct_id: payload.email,
-          distinct_id_source: "email"
+      if (payload?.id) {
+        const result = {
+          identity: {
+            distinct_id: payload.id,
+            distinct_id_source: "database_id"
+          },
+          email: payload.email || void 0
         };
-        identityCache.set(apiKey, identity2);
-        return identity2;
+        identityCache.set(apiKey, result);
+        return result;
       }
     }
   } catch {
   }
   const hash = createHash("sha256").update(apiKey).digest("hex").slice(0, 16);
-  const identity = {
-    distinct_id: `apikey-${hash}`,
-    distinct_id_source: "api_key_hash"
+  return {
+    identity: {
+      distinct_id: `apikey-${hash}`,
+      distinct_id_source: "api_key_hash"
+    }
   };
-  identityCache.set(apiKey, identity);
-  return identity;
 }
 
 // src/index.ts
@@ -112,7 +125,7 @@ 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 headers() {
@@ -121,6 +134,34 @@ var LingoDotDevEngine = class {
       "X-API-Key": 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
@@ -142,7 +183,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(
@@ -152,7 +192,6 @@ var LingoDotDevEngine = class {
         finalParams.sourceLocale,
         finalParams.targetLocale,
         { data: chunk, reference: params.reference, hints: params.hints },
-        workflowId,
         params.fast || false,
         params.filePath,
         params.triggerType,
@@ -170,14 +209,13 @@ 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
    * @param signal - Optional AbortSignal to cancel the operation
    * @returns Localized chunk
    */
-  async localizeChunk(sourceLocale, targetLocale, payload, workflowId, fast, filePath, triggerType, signal) {
+  async localizeChunk(sourceLocale, targetLocale, payload, fast, filePath, triggerType, signal) {
     const url = `${this.config.apiUrl}/process/localize`;
     const body = {
       params: { fast },
@@ -197,19 +235,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);
@@ -666,14 +692,10 @@ var LingoDotDevEngine = class {
         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,
@@ -697,34 +719,28 @@ var LingoDotDevEngine = class {
   }
   async whoami(signal) {
     const url = `${this.config.apiUrl}/users/me`;
-    try {
-      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 {
-          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 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.16.0",
+  "version": "0.16.2",
   "description": "Lingo.dev JS SDK",
   "private": false,
   "repository": {