@ccgp/i18n-ai 0.2.2 → 0.2.3

package/dist/{chunk-OQMB7A4T.mjs → chunk-IOH4K3A3.mjs}

@@ -83,71 +83,79 @@ function updateLock(lock, locale, base, final) {
 // src/core/translator.ts
 import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { generateText, Output } from "ai";
-import z from "zod";
-var translate = async ({ text, lang, targetLang, apiKey, model }) => {
-  const token = apiKey || process.env.OPENROUTER_API_KEY;
-  if (!token) {
-    throw new Error("Missing API Key. Please provide apiKey or set OPENROUTER_API_KEY environment variable.");
-  }
-  const openrouter = createOpenRouter({
-    apiKey: token
-  });
-  const system = `
-    You are a professional translator. Your main task is to translate text from "${lang}" to "${targetLang}".
-    
-    IMPORTANT RULES:
-    1. Return ONLY the translated text. No explanations, no quotes around the output.
-    2. Do NOT translate text inside curly braces, e.g., "{name}", "{count}". These are variables and must remain exactly as they are.
-    3. Maintain the original tone and context.
-    4. If the text is a single word or short phrase, translate it directly.
-    
-    Examples:
-    - Input: "Hello {name}, welcome back!" -> Output (ES): "Hola {name}, \xA1bienvenido de nuevo!"
-    - Input: "Contact us calling to {number}" -> Output (FR): "Contactez-nous en appelant le {number}"
-  `;
-  const { output } = await generateText({
-    model: openrouter.languageModel(model || "google/gemini-2.5-flash"),
-    system,
-    prompt: `Text to translate: "${text}"`,
-    output: Output.object({
-      schema: z.object({
-        translatedText: z.string()
-      })
+import * as z2 from "zod";
+
+// src/env.ts
+import { createEnv } from "@t3-oss/env-core";
+import * as z from "zod";
+var env = createEnv({
+  server: {
+    OPENROUTER_API_KEY: z.string()
+  },
+  runtimeEnv: process.env
+});
+
+// src/core/translator.ts
+var DEFAULT_MODEL = "google/gemini-2.5-flash";
+var translationSchema = z2.object({
+  translations: z2.array(
+    z2.object({
+      key: z2.string(),
+      value: z2.string()
     })
-  });
-  return output.translatedText;
-};
+  )
+});
+var openrouter = null;
+var getOpenRouter = () => openrouter ?? (openrouter = createOpenRouter({ apiKey: env.OPENROUTER_API_KEY }));
+var SYSTEM_PROMPT = `You are a professional translator.
+
+RULES:
+1. Translate the provided key-value pairs from the source language to the target language
+2. Return an array of translations with the EXACT same keys and their translated values
+3. Do NOT translate variables in curly braces: {name}, {count}, etc. Keep them exactly as-is
+4. Maintain original tone and context
+5. For single words or short phrases, translate directly`;
+async function withRetry(fn, maxAttempts = 3) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      const msg = error.message?.toLowerCase() ?? "";
+      const retryable = msg.includes("network") || msg.includes("timeout") || msg.includes("econnreset") || msg.includes("429") || msg.includes("503") || msg.includes("502");
+      if (attempt === maxAttempts || !retryable) throw error;
+      await new Promise((r) => setTimeout(r, 2 ** (attempt - 1) * 1e3));
+    }
+  }
+  throw new Error("Unreachable");
+}
 async function translateBatch(batch) {
   if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const token = batch.apiKey || process.env.OPENROUTER_API_KEY;
-  if (!token) {
-    throw new Error("Missing API Key. Please provide apiKey or set OPENROUTER_API_KEY environment variable.");
-  }
-  const openrouter = createOpenRouter({
-    apiKey: token
-  });
-  const inputPayload = Object.fromEntries(
-    batch.entries.map((e) => [e.key, e.text])
-  );
-  const system = `
-    You are a professional translator.
-    Task: Translate the values of the JSON object from "${batch.sourceLang}" to "${batch.targetLang}".
-    
-    Rules:
-    - Keep the keys exactly the same.
-    - Translate only the values.
-    - Do not translate variables inside curly braces like "{name}".
-    - Return a valid JSON object.
-  `;
-  const { output } = await generateText({
-    model: openrouter.languageModel(batch.model || "google/gemini-2.5-flash"),
-    system,
-    prompt: JSON.stringify(inputPayload, null, 2),
-    output: Output.object({
-      schema: z.record(z.string(), z.string())
-    })
+  const inputArray = batch.entries.map((e) => ({ key: e.key, text: e.text }));
+  return withRetry(async () => {
+    const { output } = await generateText({
+      model: getOpenRouter().languageModel(DEFAULT_MODEL),
+      output: Output.object({
+        schema: translationSchema
+      }),
+      system: SYSTEM_PROMPT,
+      prompt: `Translate from "${batch.sourceLang}" to "${batch.targetLang}":
+
+${JSON.stringify(inputArray, null, 2)}
+
+Return the translations array with the same keys and translated values.`
+    });
+    if (!output.translations || output.translations.length === 0) {
+      throw new Error("Translation returned empty result");
+    }
+    const resultMap = new Map(output.translations.map((t) => [t.key, t.value]));
+    const missingKeys = batch.entries.filter((e) => !resultMap.has(e.key));
+    if (missingKeys.length > 0) {
+      throw new Error(
+        `Missing translations for keys: ${missingKeys.map((e) => e.key).join(", ")}`
+      );
+    }
+    return resultMap;
   });
-  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts
@@ -273,7 +281,6 @@ export {
   withLockFile,
   analyzeLocale,
   updateLock,
-  translate,
   translateBatch,
   TranslationService
 };

package/dist/cli.js

@@ -119,38 +119,79 @@ function updateLock(lock, locale, base, final) {
 // src/core/translator.ts
 var import_ai_sdk_provider = require("@openrouter/ai-sdk-provider");
 var import_ai = require("ai");
-var import_zod = __toESM(require("zod"));
+var z2 = __toESM(require("zod"));
+
+// src/env.ts
+var import_env_core = require("@t3-oss/env-core");
+var z = __toESM(require("zod"));
+var env = (0, import_env_core.createEnv)({
+  server: {
+    OPENROUTER_API_KEY: z.string()
+  },
+  runtimeEnv: process.env
+});
+
+// src/core/translator.ts
+var DEFAULT_MODEL = "google/gemini-2.5-flash";
+var translationSchema = z2.object({
+  translations: z2.array(
+    z2.object({
+      key: z2.string(),
+      value: z2.string()
+    })
+  )
+});
+var openrouter = null;
+var getOpenRouter = () => openrouter ?? (openrouter = (0, import_ai_sdk_provider.createOpenRouter)({ apiKey: env.OPENROUTER_API_KEY }));
+var SYSTEM_PROMPT = `You are a professional translator.
+
+RULES:
+1. Translate the provided key-value pairs from the source language to the target language
+2. Return an array of translations with the EXACT same keys and their translated values
+3. Do NOT translate variables in curly braces: {name}, {count}, etc. Keep them exactly as-is
+4. Maintain original tone and context
+5. For single words or short phrases, translate directly`;
+async function withRetry(fn, maxAttempts = 3) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      const msg = error.message?.toLowerCase() ?? "";
+      const retryable = msg.includes("network") || msg.includes("timeout") || msg.includes("econnreset") || msg.includes("429") || msg.includes("503") || msg.includes("502");
+      if (attempt === maxAttempts || !retryable) throw error;
+      await new Promise((r) => setTimeout(r, 2 ** (attempt - 1) * 1e3));
+    }
+  }
+  throw new Error("Unreachable");
+}
 async function translateBatch(batch) {
   if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const token = batch.apiKey || process.env.OPENROUTER_API_KEY;
-  if (!token) {
-    throw new Error("Missing API Key. Please provide apiKey or set OPENROUTER_API_KEY environment variable.");
-  }
-  const openrouter = (0, import_ai_sdk_provider.createOpenRouter)({
-    apiKey: token
-  });
-  const inputPayload = Object.fromEntries(
-    batch.entries.map((e) => [e.key, e.text])
-  );
-  const system = `
-    You are a professional translator.
-    Task: Translate the values of the JSON object from "${batch.sourceLang}" to "${batch.targetLang}".
-    
-    Rules:
-    - Keep the keys exactly the same.
-    - Translate only the values.
-    - Do not translate variables inside curly braces like "{name}".
-    - Return a valid JSON object.
-  `;
-  const { output } = await (0, import_ai.generateText)({
-    model: openrouter.languageModel(batch.model || "google/gemini-2.5-flash"),
-    system,
-    prompt: JSON.stringify(inputPayload, null, 2),
-    output: import_ai.Output.object({
-      schema: import_zod.default.record(import_zod.default.string(), import_zod.default.string())
-    })
+  const inputArray = batch.entries.map((e) => ({ key: e.key, text: e.text }));
+  return withRetry(async () => {
+    const { output } = await (0, import_ai.generateText)({
+      model: getOpenRouter().languageModel(DEFAULT_MODEL),
+      output: import_ai.Output.object({
+        schema: translationSchema
+      }),
+      system: SYSTEM_PROMPT,
+      prompt: `Translate from "${batch.sourceLang}" to "${batch.targetLang}":
+
+${JSON.stringify(inputArray, null, 2)}
+
+Return the translations array with the same keys and translated values.`
+    });
+    if (!output.translations || output.translations.length === 0) {
+      throw new Error("Translation returned empty result");
+    }
+    const resultMap = new Map(output.translations.map((t) => [t.key, t.value]));
+    const missingKeys = batch.entries.filter((e) => !resultMap.has(e.key));
+    if (missingKeys.length > 0) {
+      throw new Error(
+        `Missing translations for keys: ${missingKeys.map((e) => e.key).join(", ")}`
+      );
+    }
+    return resultMap;
   });
-  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts
@@ -273,7 +314,7 @@ var TranslationService = class {
 var import_prompts = __toESM(require("prompts"));
 var import_chalk = __toESM(require("chalk"));
 (0, import_dotenv.config)({ path: (0, import_node_path2.resolve)(process.cwd(), ".env") });
-var VERSION = "0.2.2";
+var VERSION = "0.2.3";
 var program = new import_commander.Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version(VERSION);
 var CONFIG_FILE = "i18n.config.json";

package/dist/cli.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   TranslationService
-} from "./chunk-OQMB7A4T.mjs";
+} from "./chunk-IOH4K3A3.mjs";
 
 // src/cli.ts
 import { config as loadEnv } from "dotenv";
@@ -11,7 +11,7 @@ import { readFile, writeFile, mkdir } from "fs/promises";
 import prompts from "prompts";
 import chalk from "chalk";
 loadEnv({ path: resolve(process.cwd(), ".env") });
-var VERSION = "0.2.2";
+var VERSION = "0.2.3";
 var program = new Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version(VERSION);
 var CONFIG_FILE = "i18n.config.json";

package/dist/index.d.mts

@@ -21,14 +21,6 @@ declare function withLockFile<T>(path: string, fn: (lock: TranslationLock) => Pr
 declare function analyzeLocale(base: Map<string, string>, target: Map<string, string>, locale: string, lock: TranslationLock): LocaleChanges;
 declare function updateLock(lock: TranslationLock, locale: string, base: Map<string, string>, final: Map<string, string>): void;
 
-interface TranslateProps {
-    text: string;
-    lang: string;
-    targetLang: string;
-    apiKey?: string;
-    model?: string;
-}
-declare const translate: ({ text, lang, targetLang, apiKey, model }: TranslateProps) => Promise<string>;
 interface TranslationBatch {
     entries: Array<{
         key: string;
@@ -61,4 +53,4 @@ declare class TranslationService {
     private translateAll;
 }
 
-export { type LocaleChanges, type LockEntry, type SyncConfig, type TranslationBatch, type TranslationLock, TranslationService, analyzeLocale, translate, translateBatch, updateLock, withLockFile };
+export { type LocaleChanges, type LockEntry, type SyncConfig, type TranslationBatch, type TranslationLock, TranslationService, analyzeLocale, translateBatch, updateLock, withLockFile };

package/dist/index.d.ts

@@ -21,14 +21,6 @@ declare function withLockFile<T>(path: string, fn: (lock: TranslationLock) => Pr
 declare function analyzeLocale(base: Map<string, string>, target: Map<string, string>, locale: string, lock: TranslationLock): LocaleChanges;
 declare function updateLock(lock: TranslationLock, locale: string, base: Map<string, string>, final: Map<string, string>): void;
 
-interface TranslateProps {
-    text: string;
-    lang: string;
-    targetLang: string;
-    apiKey?: string;
-    model?: string;
-}
-declare const translate: ({ text, lang, targetLang, apiKey, model }: TranslateProps) => Promise<string>;
 interface TranslationBatch {
     entries: Array<{
         key: string;
@@ -61,4 +53,4 @@ declare class TranslationService {
     private translateAll;
 }
 
-export { type LocaleChanges, type LockEntry, type SyncConfig, type TranslationBatch, type TranslationLock, TranslationService, analyzeLocale, translate, translateBatch, updateLock, withLockFile };
+export { type LocaleChanges, type LockEntry, type SyncConfig, type TranslationBatch, type TranslationLock, TranslationService, analyzeLocale, translateBatch, updateLock, withLockFile };

package/dist/index.js

@@ -32,7 +32,6 @@ var index_exports = {};
 __export(index_exports, {
   TranslationService: () => TranslationService,
   analyzeLocale: () => analyzeLocale,
-  translate: () => translate,
   translateBatch: () => translateBatch,
   updateLock: () => updateLock,
   withLockFile: () => withLockFile
@@ -124,71 +123,79 @@ function updateLock(lock, locale, base, final) {
 // src/core/translator.ts
 var import_ai_sdk_provider = require("@openrouter/ai-sdk-provider");
 var import_ai = require("ai");
-var import_zod = __toESM(require("zod"));
-var translate = async ({ text, lang, targetLang, apiKey, model }) => {
-  const token = apiKey || process.env.OPENROUTER_API_KEY;
-  if (!token) {
-    throw new Error("Missing API Key. Please provide apiKey or set OPENROUTER_API_KEY environment variable.");
-  }
-  const openrouter = (0, import_ai_sdk_provider.createOpenRouter)({
-    apiKey: token
-  });
-  const system = `
-    You are a professional translator. Your main task is to translate text from "${lang}" to "${targetLang}".
-    
-    IMPORTANT RULES:
-    1. Return ONLY the translated text. No explanations, no quotes around the output.
-    2. Do NOT translate text inside curly braces, e.g., "{name}", "{count}". These are variables and must remain exactly as they are.
-    3. Maintain the original tone and context.
-    4. If the text is a single word or short phrase, translate it directly.
-    
-    Examples:
-    - Input: "Hello {name}, welcome back!" -> Output (ES): "Hola {name}, \xA1bienvenido de nuevo!"
-    - Input: "Contact us calling to {number}" -> Output (FR): "Contactez-nous en appelant le {number}"
-  `;
-  const { output } = await (0, import_ai.generateText)({
-    model: openrouter.languageModel(model || "google/gemini-2.5-flash"),
-    system,
-    prompt: `Text to translate: "${text}"`,
-    output: import_ai.Output.object({
-      schema: import_zod.default.object({
-        translatedText: import_zod.default.string()
-      })
+var z2 = __toESM(require("zod"));
+
+// src/env.ts
+var import_env_core = require("@t3-oss/env-core");
+var z = __toESM(require("zod"));
+var env = (0, import_env_core.createEnv)({
+  server: {
+    OPENROUTER_API_KEY: z.string()
+  },
+  runtimeEnv: process.env
+});
+
+// src/core/translator.ts
+var DEFAULT_MODEL = "google/gemini-2.5-flash";
+var translationSchema = z2.object({
+  translations: z2.array(
+    z2.object({
+      key: z2.string(),
+      value: z2.string()
     })
-  });
-  return output.translatedText;
-};
+  )
+});
+var openrouter = null;
+var getOpenRouter = () => openrouter ?? (openrouter = (0, import_ai_sdk_provider.createOpenRouter)({ apiKey: env.OPENROUTER_API_KEY }));
+var SYSTEM_PROMPT = `You are a professional translator.
+
+RULES:
+1. Translate the provided key-value pairs from the source language to the target language
+2. Return an array of translations with the EXACT same keys and their translated values
+3. Do NOT translate variables in curly braces: {name}, {count}, etc. Keep them exactly as-is
+4. Maintain original tone and context
+5. For single words or short phrases, translate directly`;
+async function withRetry(fn, maxAttempts = 3) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      const msg = error.message?.toLowerCase() ?? "";
+      const retryable = msg.includes("network") || msg.includes("timeout") || msg.includes("econnreset") || msg.includes("429") || msg.includes("503") || msg.includes("502");
+      if (attempt === maxAttempts || !retryable) throw error;
+      await new Promise((r) => setTimeout(r, 2 ** (attempt - 1) * 1e3));
+    }
+  }
+  throw new Error("Unreachable");
+}
 async function translateBatch(batch) {
   if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const token = batch.apiKey || process.env.OPENROUTER_API_KEY;
-  if (!token) {
-    throw new Error("Missing API Key. Please provide apiKey or set OPENROUTER_API_KEY environment variable.");
-  }
-  const openrouter = (0, import_ai_sdk_provider.createOpenRouter)({
-    apiKey: token
-  });
-  const inputPayload = Object.fromEntries(
-    batch.entries.map((e) => [e.key, e.text])
-  );
-  const system = `
-    You are a professional translator.
-    Task: Translate the values of the JSON object from "${batch.sourceLang}" to "${batch.targetLang}".
-    
-    Rules:
-    - Keep the keys exactly the same.
-    - Translate only the values.
-    - Do not translate variables inside curly braces like "{name}".
-    - Return a valid JSON object.
-  `;
-  const { output } = await (0, import_ai.generateText)({
-    model: openrouter.languageModel(batch.model || "google/gemini-2.5-flash"),
-    system,
-    prompt: JSON.stringify(inputPayload, null, 2),
-    output: import_ai.Output.object({
-      schema: import_zod.default.record(import_zod.default.string(), import_zod.default.string())
-    })
+  const inputArray = batch.entries.map((e) => ({ key: e.key, text: e.text }));
+  return withRetry(async () => {
+    const { output } = await (0, import_ai.generateText)({
+      model: getOpenRouter().languageModel(DEFAULT_MODEL),
+      output: import_ai.Output.object({
+        schema: translationSchema
+      }),
+      system: SYSTEM_PROMPT,
+      prompt: `Translate from "${batch.sourceLang}" to "${batch.targetLang}":
+
+${JSON.stringify(inputArray, null, 2)}
+
+Return the translations array with the same keys and translated values.`
+    });
+    if (!output.translations || output.translations.length === 0) {
+      throw new Error("Translation returned empty result");
+    }
+    const resultMap = new Map(output.translations.map((t) => [t.key, t.value]));
+    const missingKeys = batch.entries.filter((e) => !resultMap.has(e.key));
+    if (missingKeys.length > 0) {
+      throw new Error(
+        `Missing translations for keys: ${missingKeys.map((e) => e.key).join(", ")}`
+      );
+    }
+    return resultMap;
   });
-  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts
@@ -313,7 +320,6 @@ var TranslationService = class {
 0 && (module.exports = {
   TranslationService,
   analyzeLocale,
-  translate,
   translateBatch,
   updateLock,
   withLockFile

package/dist/index.mjs

@@ -1,15 +1,13 @@
 import {
   TranslationService,
   analyzeLocale,
-  translate,
   translateBatch,
   updateLock,
   withLockFile
-} from "./chunk-OQMB7A4T.mjs";
+} from "./chunk-IOH4K3A3.mjs";
 export {
   TranslationService,
   analyzeLocale,
-  translate,
   translateBatch,
   updateLock,
   withLockFile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "AI-powered i18n translation and synchronization library",
   "main": "dist/index.js",
   "module": "dist/index.mjs",