@belocal/js-sdk 0.7.0 → 1.0.1

package/dist/node.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var jsMd5 = require('js-md5');
 var http2 = require('http2');
 var url = require('url');
+var jsMd5 = require('js-md5');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -24,155 +24,10 @@ function _interopNamespace(e) {
 
 var http2__namespace = /*#__PURE__*/_interopNamespace(http2);
 
-// src/transports/multi.ts
-function generateRequestId(texts, lang, sourceLang, context) {
-  const sortedTexts = [...texts].sort();
-  let sortedContext = null;
-  if (context && Object.keys(context).length > 0) {
-    sortedContext = {};
-    const sortedKeys = Object.keys(context).sort();
-    for (const key of sortedKeys) {
-      sortedContext[key] = context[key];
-    }
-  }
-  const data = [sortedTexts, lang, sourceLang || null, sortedContext];
-  const json = JSON.stringify(data);
-  return jsMd5.md5(json);
-}
-async function sendMulti(config, items, state) {
-  if (config.debug) {
-    console.log(`[BeLocal Multi Transport] Sending multi request with ${items.length} texts`);
-  }
-  try {
-    const groups = /* @__PURE__ */ new Map();
-    items.forEach((item) => {
-      const groupKey = JSON.stringify({
-        lang: item.lang,
-        sourceLang: item.sourceLang || null,
-        context: item.context || null
-      });
-      if (!groups.has(groupKey)) {
-        groups.set(groupKey, []);
-      }
-      groups.get(groupKey).push(item);
-    });
-    const requestIdToGroupItems = /* @__PURE__ */ new Map();
-    const requests = Array.from(groups.entries()).map(([groupKey, groupItems]) => {
-      const firstItem = groupItems[0];
-      const texts = groupItems.map((item) => item.text);
-      const requestId = generateRequestId(
-        texts,
-        firstItem.lang,
-        firstItem.sourceLang,
-        firstItem.context
-      );
-      requestIdToGroupItems.set(requestId, groupItems);
-      return {
-        requestId,
-        texts,
-        lang: firstItem.lang,
-        sourceLang: firstItem.sourceLang,
-        context: firstItem.context
-      };
-    });
-    const multiResponse = await config.baseTransport.post({ requests }, "/v1/translate/multi");
-    if (config.debug) {
-      console.log(`[BeLocal Multi Transport] Multi response received with ${multiResponse.results.length} groups`);
-    }
-    const resultMap = /* @__PURE__ */ new Map();
-    multiResponse.results.forEach((result) => {
-      resultMap.set(result.requestId, { texts: result.data.texts, status: result.data.status });
-    });
-    requestIdToGroupItems.forEach((groupItems, requestId) => {
-      const result = resultMap.get(requestId);
-      if (!result) {
-        if (config.debug) {
-          console.error(`[BeLocal Multi Transport] No result found for requestId: ${requestId}`);
-        }
-        groupItems.forEach((item) => {
-          item.reject(new Error(`No result found for request ${requestId}`));
-        });
-        return;
-      }
-      if (result.texts.length !== groupItems.length) {
-        const error = new Error(`Mismatch: expected ${groupItems.length} texts, got ${result.texts.length} for requestId ${requestId}`);
-        if (config.debug) {
-          console.error(`[BeLocal Multi Transport]`, error.message);
-        }
-        groupItems.forEach((item) => item.reject(error));
-        return;
-      }
-      groupItems.forEach((item, index) => {
-        const translatedText = result.texts[index];
-        const status = result.status || "success";
-        if (config.debug) {
-          console.log(`[BeLocal Multi Transport] Success for requestId ${requestId}[${index}]: "${translatedText}"`);
-        }
-        item.resolve({ text: translatedText, status });
-      });
-    });
-  } catch (error) {
-    if (config.debug) {
-      console.error(`[BeLocal Multi Transport] Multi request error:`, error);
-    }
-    const errorToReject = error instanceof Error ? error : new Error(String(error));
-    items.forEach((item) => item.reject(errorToReject));
-  } finally {
-  }
-}
-function processMulti(config, state) {
-  if (state.currentMulti.length === 0 || state.isRequestInFlight) {
-    return;
-  }
-  const itemsToSend = [...state.currentMulti];
-  state.currentMulti = [];
-  state.multiTimer = null;
-  state.isRequestInFlight = true;
-  sendMulti(config, itemsToSend).finally(() => {
-    state.isRequestInFlight = false;
-    if (state.currentMulti.length > 0) {
-      const windowMs = config.batchWindowMs ?? 50;
-      state.multiTimer = setTimeout(() => processMulti(config, state), windowMs);
-    }
-  });
-}
-function createMultiTransport(config) {
-  const windowMs = config.batchWindowMs ?? 50;
-  const state = {
-    currentMulti: [],
-    multiTimer: null,
-    isRequestInFlight: false
-  };
-  return ({ text, lang, source_lang, ctx }) => {
-    return new Promise((resolve, reject) => {
-      if (config.debug) {
-        const tempRequestId = jsMd5.md5(JSON.stringify([text, lang, source_lang || null, ctx || null]));
-        console.log(`[BeLocal Multi Transport] Queuing request ${tempRequestId}: "${text}" to ${lang}`);
-      }
-      const requestItem = {
-        text,
-        lang,
-        sourceLang: source_lang,
-        context: ctx,
-        resolve,
-        reject
-      };
-      state.currentMulti.push(requestItem);
-      if (state.multiTimer === null && !state.isRequestInFlight) {
-        state.multiTimer = setTimeout(() => processMulti(config, state), windowMs);
-      }
-    });
-  };
-}
+// src/transports/base/node.ts
 
 // src/version.ts
-var SDK_VERSION = (() => {
-  try {
-    return true ? "0.7.0" : "undefined";
-  } catch {
-    return "undefined";
-  }
-})();
+var SDK_VERSION = "1.0.1" ;
 var SDK_NAME = "js";
 
 // src/transports/base/dedupe.ts
@@ -373,6 +228,136 @@ function createBaseNodeTransport(config) {
   const transport = new BaseNodeTransport(config);
   return new DedupeTransport(transport, config.debug);
 }
+function generateRequestId(texts, lang, sourceLang, context) {
+  const sortedTexts = [...texts].sort();
+  const sortedContext = context && Object.keys(context).length > 0 ? Object.fromEntries(Object.entries(context).sort(([a], [b]) => a.localeCompare(b))) : null;
+  const data = [sortedTexts, lang, sourceLang || null, sortedContext];
+  return jsMd5.md5(JSON.stringify(data));
+}
+async function sendMulti(config, items, state) {
+  if (config.debug) {
+    console.log(`[BeLocal Multi Transport] Sending multi request with ${items.length} texts`);
+  }
+  try {
+    const groups = /* @__PURE__ */ new Map();
+    items.forEach((item) => {
+      const groupKey = JSON.stringify({
+        lang: item.lang,
+        sourceLang: item.sourceLang || null,
+        context: item.context || null
+      });
+      if (!groups.has(groupKey)) {
+        groups.set(groupKey, []);
+      }
+      groups.get(groupKey).push(item);
+    });
+    const requestIdToGroupItems = /* @__PURE__ */ new Map();
+    const requests = Array.from(groups.entries()).map(([groupKey, groupItems]) => {
+      const firstItem = groupItems[0];
+      const texts = groupItems.map((item) => item.text);
+      const requestId = generateRequestId(
+        texts,
+        firstItem.lang,
+        firstItem.sourceLang,
+        firstItem.context
+      );
+      requestIdToGroupItems.set(requestId, groupItems);
+      return {
+        request_id: requestId,
+        texts,
+        lang: firstItem.lang,
+        source_lang: firstItem.sourceLang,
+        ctx: firstItem.context
+      };
+    });
+    const multiResponse = await config.baseTransport.post({ requests }, "/v1/translate/multi");
+    if (config.debug) {
+      console.log(`[BeLocal Multi Transport] Multi response received with ${multiResponse.results.length} groups`);
+    }
+    const resultMap = /* @__PURE__ */ new Map();
+    multiResponse.results.forEach((result) => {
+      resultMap.set(result.request_id, { texts: result.data.texts, status: result.data.status });
+    });
+    requestIdToGroupItems.forEach((groupItems, requestId) => {
+      const result = resultMap.get(requestId);
+      if (!result) {
+        if (config.debug) {
+          console.error(`[BeLocal Multi Transport] No result found for request_id: ${requestId}`);
+        }
+        groupItems.forEach((item) => {
+          item.reject(new Error(`No result found for request ${requestId}`));
+        });
+        return;
+      }
+      if (result.texts.length !== groupItems.length) {
+        const error = new Error(`Mismatch: expected ${groupItems.length} texts, got ${result.texts.length} for request_id ${requestId}`);
+        if (config.debug) {
+          console.error(`[BeLocal Multi Transport]`, error.message);
+        }
+        groupItems.forEach((item) => item.reject(error));
+        return;
+      }
+      groupItems.forEach((item, index) => {
+        const translatedText = result.texts[index];
+        const status = result.status || "success";
+        if (config.debug) {
+          console.log(`[BeLocal Multi Transport] Success for request_id ${requestId}[${index}]: "${translatedText}"`);
+        }
+        item.resolve({ text: translatedText, status });
+      });
+    });
+  } catch (error) {
+    if (config.debug) {
+      console.error(`[BeLocal Multi Transport] Multi request error:`, error);
+    }
+    const errorToReject = error instanceof Error ? error : new Error(String(error));
+    items.forEach((item) => item.reject(errorToReject));
+  }
+}
+function processMulti(config, state) {
+  if (state.currentMulti.length === 0 || state.isRequestInFlight) {
+    return;
+  }
+  const itemsToSend = [...state.currentMulti];
+  state.currentMulti = [];
+  state.multiTimer = null;
+  state.isRequestInFlight = true;
+  sendMulti(config, itemsToSend).finally(() => {
+    state.isRequestInFlight = false;
+    if (state.currentMulti.length > 0) {
+      const windowMs = config.batchWindowMs ?? 50;
+      state.multiTimer = setTimeout(() => processMulti(config, state), windowMs);
+    }
+  });
+}
+function createMultiTransport(config) {
+  const windowMs = config.batchWindowMs ?? 50;
+  const state = {
+    currentMulti: [],
+    multiTimer: null,
+    isRequestInFlight: false
+  };
+  return ({ text, lang, source_lang, ctx }) => {
+    return new Promise((resolve, reject) => {
+      if (config.debug) {
+        const tempRequestId = jsMd5.md5(JSON.stringify([text, lang, source_lang || null, ctx || null]));
+        console.log(`[BeLocal Multi Transport] Queuing request ${tempRequestId}: "${text}" to ${lang}`);
+      }
+      const requestItem = {
+        text,
+        lang,
+        sourceLang: source_lang,
+        context: ctx,
+        resolve,
+        reject
+      };
+      state.currentMulti.push(requestItem);
+      if (state.multiTimer === null && !state.isRequestInFlight) {
+        state.multiTimer = setTimeout(() => processMulti(config, state), windowMs);
+      }
+    });
+  };
+}
 
 // src/cache/local.ts
 var LocalCache = class {
@@ -385,28 +370,9 @@ var LocalCache = class {
   set(key, value) {
     this.storage.set(key, value);
   }
-  isAvailable() {
-    return true;
-  }
 };
 var BelocalEngine = class {
-  /**
-   * Creates a new BelocalEngine instance.
-   * 
-   * @param options - Configuration options for the engine
-   * @throws {Error} If apiKey is not provided or invalid
-   * 
-   * @example
-   * ```typescript
-   * const engine = new BelocalEngine({
-   *   apiKey: 'your-api-key',
-   *   batchWindowMs: 100,
-   *   timeoutMs: 10000,
-   *   debug: false
-   * });
-   * ```
-   */
-  constructor(options) {
+  constructor(options, baseTransportFactory) {
     const {
       apiKey,
       batchWindowMs = 50,
@@ -415,13 +381,10 @@ var BelocalEngine = class {
     } = options;
     this.debug = debug;
     this.cache = new LocalCache();
-    if (this.debug) {
-      console.log("[BeLocal Engine] Using local (memory) cache");
-    }
     const authHeaders = {
       "Authorization": `Bearer ${apiKey}`
     };
-    const baseTransport = createBaseNodeTransport({
+    const baseTransport = baseTransportFactory({
       headers: authHeaders,
       timeoutMs,
       debug: this.debug
@@ -439,91 +402,12 @@ var BelocalEngine = class {
       });
     }
   }
-  /**
-   * Translates a single text string to the target language.
-   * 
-   * Uses in-memory cache to avoid redundant API calls. Results are automatically cached
-   * for subsequent requests with the same parameters.
-   * 
-   * @param text - The text to translate
-   * @param lang - Target language code (e.g., 'es', 'fr', 'ru')
-   * @param source_lang - Optional source language code. If not provided, auto-detection is used
-   * @param ctx - Optional key-value pairs for translation context. Supported keys: `user_ctx` (string - descriptive context in English), `cache_type` ('managed' | string)
-   * @returns Promise resolving to the translated text
-   * @throws {Error} If the translation request fails (network error, API error, timeout)
-   * 
-   * @example
-   * ```typescript
-   * // Simple translation
-   * const result = await engine.translate('Hello world', 'es');
-   * 
-   * // With source language
-   * const result = await engine.translate('Hello world', 'es', 'en');
-   * 
-   * // With context (user_ctx) - descriptive context helps improve translation quality
-   * const result = await engine.translate('Hello world', 'es', undefined, { 
-   *   user_ctx: 'greeting message on the homepage' 
-   * });
-   * 
-   * // With cache_type
-   * const result = await engine.translate('Hello world', 'es', undefined, { cache_type: 'managed' });
-   * 
-   * // With source language and context
-   * const result = await engine.translate('Hello world', 'es', 'en', { 
-   *   user_ctx: 'greeting message on the homepage' 
-   * });
-   * ```
-   */
+  /** Translates a single text string to the target language. */
   async translate(text, lang, source_lang, ctx) {
     const results = await this.translateMany([text], lang, source_lang, ctx);
     return results[0];
   }
-  /**
-   * Translates multiple text strings to the target language in a single batch.
-   * 
-   * This method is more efficient than calling `translate()` multiple times as it:
-   * - Batches requests together to reduce API calls
-   * - Checks cache for each text individually
-   * - Only requests translations for cache misses
-   * - Maintains the order of input texts in the result array
-   * 
-   * @param texts - Array of texts to translate
-   * @param lang - Target language code (e.g., 'es', 'fr', 'ru')
-   * @param source_lang - Optional source language code. If not provided, auto-detection is used
-   * @param ctx - Optional key-value pairs for translation context. Supported keys: `user_ctx` (string - descriptive context in English), `cache_type` ('managed' | string)
-   * @returns Promise resolving to an array of translated texts in the same order as input
-   * @throws {Error} If the translation request fails (network error, API error, timeout)
-   * 
-   * @example
-   * ```typescript
-   * // Translate multiple texts
-   * const results = await engine.translateMany(['Hello', 'World', 'Test'], 'es');
-   * // Returns: ['Hola', 'Mundo', 'Prueba']
-   * 
-   * // With source language
-   * const results = await engine.translateMany(['Hello', 'World'], 'fr', 'en');
-   * 
-   * // With context (user_ctx) - descriptive context helps improve translation quality
-   * const results = await engine.translateMany(
-   *   ['Hello', 'World'], 
-   *   'es', 
-   *   undefined, 
-   *   { user_ctx: 'greeting message on the homepage' }
-   * );
-   * 
-   * // With cache_type
-   * const results = await engine.translateMany(
-   *   ['Hello', 'World'], 
-   *   'es', 
-   *   undefined, 
-   *   { cache_type: 'managed' }
-   * );
-   * 
-   * // Empty array returns empty array
-   * const results = await engine.translateMany([], 'es');
-   * // Returns: []
-   * ```
-   */
+  /** Translates multiple text strings to the target language in a single batch. */
   async translateMany(texts, lang, source_lang, ctx) {
     const results = new Array(texts.length);
     const cacheMisses = [];
@@ -534,7 +418,7 @@ var BelocalEngine = class {
       if (cachedResult) {
         results[i] = cachedResult;
         if (this.debug) {
-          console.log("[BeLocal Engine] Translation from local cache:", text);
+          console.log("[BeLocal Engine] Translation from cache:", text);
         }
         continue;
       }
@@ -549,7 +433,7 @@ var BelocalEngine = class {
             const cacheKey = this.generateCacheKey(text, lang, source_lang, ctx);
             this.cache.set(cacheKey, result.text);
             if (this.debug) {
-              console.log("[BeLocal Engine] Translation from API, cached in local:", text);
+              console.log("[BeLocal Engine] Translation from API, cached:", text);
             }
           } else {
             if (this.debug) {
@@ -565,45 +449,13 @@ var BelocalEngine = class {
     }
     return results;
   }
-  /**
-   * Shortcut method for translation with simplified API.
-   * 
-   * This is a convenience method that wraps `translate()`. When `context` is provided as a string,
-   * it is automatically wrapped in `{user_ctx: context}` object.
-   * 
-   * @param text - The text to translate
-   * @param lang - Target language code (e.g., 'es', 'fr', 'ru')
-   * @param source_lang - Optional source language code
-   * @param context - Optional descriptive context string in English (will be wrapped as {user_ctx: context})
-   * @returns Promise resolving to the translated text
-   * @throws {Error} If the translation request fails (network error, API error, timeout)
-   * 
-   * @example
-   * ```typescript
-   * // Simple translation
-   * const result = await engine.t('Hello world', 'es');
-   * 
-   * // With source language
-   * const result = await engine.t('Hello world', 'fr', 'en');
-   * 
-   * // With context string (automatically wrapped as {user_ctx: 'greeting message on the homepage'})
-   * const result = await engine.t('Hello world', 'es', undefined, 'greeting message on the homepage');
-   * 
-   * // With source language and context
-   * const result = await engine.t('Hello world', 'es', 'en', 'greeting message on the homepage');
-   * ```
-   */
-  async t(text, lang, source_lang, context) {
-    if (context) {
-      return this.translate(text, lang, source_lang, { user_ctx: context });
-    }
-    return this.translate(text, lang, source_lang);
+  /** Shortcut for translate() */
+  async t(text, lang, source_lang, context, managed = false) {
+    const ctx = context || managed ? { ...context ? { user_ctx: context } : {}, ...managed ? { cache_type: "managed" } : {} } : void 0;
+    return this.translate(text, lang, source_lang, ctx);
   }
   generateCacheKey(text, lang, source_lang, ctx) {
-    const sortedCtx = ctx ? Object.keys(ctx).sort().reduce((acc, key) => {
-      acc[key] = ctx[key];
-      return acc;
-    }, {}) : null;
+    const sortedCtx = ctx ? Object.fromEntries(Object.entries(ctx).sort(([a], [b]) => a.localeCompare(b))) : null;
     const data = {
       text,
       lang,
@@ -614,8 +466,21 @@ var BelocalEngine = class {
   }
 };
 
+// src/core/types.ts
+var USER_TYPE_PRODUCT = "product";
+var USER_TYPE_CHAT = "chat";
+
+// src/core/engine/node.ts
+var BelocalEngine2 = class extends BelocalEngine {
+  constructor(options) {
+    super(options, createBaseNodeTransport);
+  }
+};
+
 exports.BaseNodeTransport = BaseNodeTransport;
-exports.BelocalEngine = BelocalEngine;
+exports.BelocalEngine = BelocalEngine2;
+exports.USER_TYPE_CHAT = USER_TYPE_CHAT;
+exports.USER_TYPE_PRODUCT = USER_TYPE_PRODUCT;
 exports.createBaseNodeTransport = createBaseNodeTransport;
 exports.createMultiTransport = createMultiTransport;
 //# sourceMappingURL=node.cjs.map