@belocal/js-sdk 0.7.0 → 1.0.0

package/dist/node.d.ts

@@ -46,63 +46,14 @@ interface BelocalEngineOptions {
     debug?: boolean;
 }
 
-interface BaseNodeTransportConfig {
-    headers?: Record<string, string>;
-    timeoutMs?: number;
-    retries?: number;
-    debug?: boolean;
-}
-declare class BaseNodeTransport implements BaseTransport {
-    private config;
-    constructor(config: BaseNodeTransportConfig);
-    post(data: any, endpointPath: string): Promise<any>;
-}
-declare function createBaseNodeTransport(config: BaseNodeTransportConfig): BaseTransport;
-
-interface MultiTransportConfig {
-    baseTransport: BaseTransport;
-    debug?: boolean;
-    batchWindowMs?: number;
-}
-declare function createMultiTransport(config: MultiTransportConfig): Transport;
-
 /**
- * BeLocal translation engine for Node.js environments.
- *
- * Provides on-demand translation with automatic request batching, caching, and deduplication.
- * Optimized for Node.js environments using HTTP/2 with connection pooling and automatic retries.
- *
- * @example
- * ```typescript
- * const engine = new BelocalEngine({
- *   apiKey: 'your-api-key',
- *   debug: true
- * });
- *
- * const translated = await engine.translate('Hello world', 'es');
- * ```
+ * Base engine implementation shared between browser and Node.js environments.
  */
-declare class BelocalEngine {
+declare class BelocalEngine$1 {
     private transport;
     private debug;
     private cache;
-    /**
-     * 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: BelocalEngineOptions);
+    constructor(options: BelocalEngineOptions, baseTransportFactory: (opts: any) => BaseTransport);
     /**
      * Translates a single text string to the target language.
      *
@@ -112,7 +63,7 @@ declare class BelocalEngine {
      * @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)
+     * @param ctx - Optional key-value pairs for translation context. Supported keys: `user_ctx` (string - descriptive context), `cache_type` ('managed')
      * @returns Promise resolving to the translated text
      * @throws {Error} If the translation request fails (network error, API error, timeout)
      *
@@ -218,4 +169,60 @@ declare class BelocalEngine {
     private generateCacheKey;
 }
 
+interface BaseNodeTransportConfig {
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    retries?: number;
+    debug?: boolean;
+}
+declare class BaseNodeTransport implements BaseTransport {
+    private config;
+    constructor(config: BaseNodeTransportConfig);
+    post(data: any, endpointPath: string): Promise<any>;
+}
+declare function createBaseNodeTransport(config: BaseNodeTransportConfig): BaseTransport;
+
+interface MultiTransportConfig {
+    baseTransport: BaseTransport;
+    debug?: boolean;
+    batchWindowMs?: number;
+}
+declare function createMultiTransport(config: MultiTransportConfig): Transport;
+
+/**
+ * BeLocal translation engine for Node.js environments.
+ *
+ * Provides on-demand translation with automatic request batching, caching, and deduplication.
+ * Optimized for Node.js environments using HTTP/2 with connection pooling and automatic retries.
+ *
+ * @example
+ * ```typescript
+ * const engine = new BelocalEngine({
+ *   apiKey: 'your-api-key',
+ *   debug: true
+ * });
+ *
+ * const translated = await engine.translate('Hello world', 'es');
+ * ```
+ */
+declare class BelocalEngine extends BelocalEngine$1 {
+    /**
+     * Creates a new BelocalEngine instance for Node.js environments.
+     *
+     * @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: BelocalEngineOptions);
+}
+
 export { BaseNodeTransport, type BaseTransport, BelocalEngine, type BelocalEngineOptions, type KV, type Lang, createBaseNodeTransport, createMultiTransport };

package/dist/node.mjs

@@ -1,152 +1,13 @@
-import { md5 } from 'js-md5';
 import * as http2 from 'http2';
 import { URL } from 'url';
+import { md5 } from 'js-md5';
 
-// 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 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 = 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";
+    return true ? "1.0.0" : "undefined";
   } catch {
     return "undefined";
   }
@@ -351,6 +212,145 @@ function createBaseNodeTransport(config) {
   const transport = new BaseNodeTransport(config);
   return new DedupeTransport(transport, config.debug);
 }
+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 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 {
+        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));
+  } 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 = 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 {
@@ -368,23 +368,7 @@ var LocalCache = class {
   }
 };
 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,
@@ -393,13 +377,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
@@ -426,7 +407,7 @@ var BelocalEngine = class {
    * @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)
+   * @param ctx - Optional key-value pairs for translation context. Supported keys: `user_ctx` (string - descriptive context), `cache_type` ('managed')
    * @returns Promise resolving to the translated text
    * @throws {Error} If the translation request fails (network error, API error, timeout)
    * 
@@ -512,7 +493,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;
       }
@@ -527,7 +508,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) {
@@ -592,6 +573,29 @@ var BelocalEngine = class {
   }
 };
 
-export { BaseNodeTransport, BelocalEngine, createBaseNodeTransport, createMultiTransport };
+// src/core/engine/node.ts
+var BelocalEngine2 = class extends BelocalEngine {
+  /**
+   * Creates a new BelocalEngine instance for Node.js environments.
+   * 
+   * @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) {
+    super(options, createBaseNodeTransport);
+  }
+};
+
+export { BaseNodeTransport, BelocalEngine2 as BelocalEngine, createBaseNodeTransport, createMultiTransport };
 //# sourceMappingURL=node.mjs.map
 //# sourceMappingURL=node.mjs.map