@belocal/js-sdk 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belocal/js-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "BeLocal runtime JS SDK for on-demand translation (browser + node)",
   "main": "index.js",
   "scripts": {

package/src/core/engine.ts

@@ -4,6 +4,7 @@ import { createNodeTransport } from '../transports/node';
 
 export class BelocalEngine {
   private transport: Transport;
+  private debug: boolean;
 
   constructor(options: BelocalEngineOptions) {
     const {
@@ -14,9 +15,12 @@ export class BelocalEngine {
       retries = 3,
       credentials,
       headers = {},
-      agent
+      agent,
+      debug = false
     } = options;
 
+    this.debug = debug;
+
     const authHeaders = {
       'Authorization': `Bearer ${apiKey}`,
       ...headers
@@ -28,7 +32,8 @@ export class BelocalEngine {
       retries,
       credentials,
       headers: authHeaders,
-      agent
+      agent,
+      debug: this.debug
     });
   }
 
@@ -45,12 +50,22 @@ export class BelocalEngine {
       credentials?: RequestCredentials;
       headers: Record<string, string>;
       agent?: unknown;
+      debug: boolean;
     }
   ): Transport {
     const actualTransport = transportType === 'auto' ? this.detectEnvironment() : transportType;
-
     const path = '/v1/translate';
 
+    if (config.debug) {
+      console.log(`[BeLocal Engine] Creating ${actualTransport} transport with config:`, {
+        baseUrl: config.baseUrl,
+        path,
+        timeoutMs: config.timeoutMs,
+        ...(actualTransport === 'browser' && { credentials: config.credentials }),
+        ...(actualTransport === 'node' && { retries: config.retries, hasAgent: !!config.agent })
+      });
+    }
+
     if (actualTransport === 'browser') {
       return createBrowserTransport({
         baseUrl: config.baseUrl,
@@ -58,6 +73,7 @@ export class BelocalEngine {
         credentials: config.credentials,
         headers: config.headers,
         timeoutMs: config.timeoutMs,
+        debug: config.debug,
       });
     } else {
       return createNodeTransport({
@@ -67,6 +83,7 @@ export class BelocalEngine {
         timeoutMs: config.timeoutMs,
         agent: config.agent,
         retries: config.retries,
+        debug: config.debug,
       });
     }
   }

package/src/core/types.ts

@@ -16,4 +16,5 @@ export interface BelocalEngineOptions {
   credentials?: RequestCredentials;
   headers?: Record<string, string>;
   agent?: unknown;
+  debug?: boolean; // default: false - включает логирование
 }

package/src/transports/browser.ts

@@ -6,6 +6,7 @@ export interface BrowserTransportConfig {
   credentials?: RequestCredentials;
   headers?: Record<string, string>;
   timeoutMs?: number;
+  debug?: boolean;
 }
 
 export function createBrowserTransport(config: BrowserTransportConfig): Transport {
@@ -14,6 +15,10 @@ export function createBrowserTransport(config: BrowserTransportConfig): Transpor
     const controller = new AbortController();
     const timeoutId = config.timeoutMs ? setTimeout(() => controller.abort(), config.timeoutMs) : null;
 
+    if (config.debug) {
+      console.log(`[BeLocal Browser Transport] Translating "${text}" to ${lang} with url ${url}`);
+    }
+
     try {
       const response = await fetch(url, {
         method: 'POST',
@@ -27,10 +32,17 @@ export function createBrowserTransport(config: BrowserTransportConfig): Transpor
       });
 
       if (!response.ok) {
-        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        const errorMsg = `HTTP ${response.status}: ${response.statusText}`;
+        if (config.debug) {
+          console.error(`[BeLocal Browser Transport] Request failed:`, errorMsg);
+        }
+        throw new Error(errorMsg);
       }
 
       const result = await response.json();
+      if (config.debug) {
+        console.log(`[BeLocal Browser Transport] Translation successful: "${result.text || text}"`);
+      }
       return result.text || text;
     } finally {
       if (timeoutId) {

package/src/transports/node.ts

@@ -7,6 +7,7 @@ export interface NodeTransportConfig {
   timeoutMs?: number;
   agent?: unknown;
   retries?: number;
+  debug?: boolean;
 }
 
 export function createNodeTransport(config: NodeTransportConfig): Transport {
@@ -15,6 +16,10 @@ export function createNodeTransport(config: NodeTransportConfig): Transport {
     const maxRetries = config.retries || 0;
     let attempt = 0;
 
+    if (config.debug) {
+      console.log(`[BeLocal Node Transport] Translating "${text}" to ${lang} with url ${url}`);
+    }
+
     while (attempt <= maxRetries) {
       try {
         const controller = new AbortController();
@@ -36,6 +41,9 @@ export function createNodeTransport(config: NodeTransportConfig): Transport {
           }
 
           const result = await response.json();
+          if (config.debug) {
+            console.log(`[BeLocal Node Transport] Translation successful: "${result.text || text}"`);
+          }
           return result.text || text;
         } finally {
           if (timeoutId) {
@@ -44,6 +52,9 @@ export function createNodeTransport(config: NodeTransportConfig): Transport {
         }
       } catch (error) {
         attempt++;
+        if (config.debug) {
+          console.error(`[BeLocal Node Transport] Attempt ${attempt} failed:`, error instanceof Error ? error.message : String(error));
+        }
         if (attempt > maxRetries) {
           throw error;
         }