@ccgp/i18n-ai 0.2.0 → 0.2.2

package/README.md

@@ -5,10 +5,10 @@ AI-powered internationalization (i18n) translation and synchronization library.
 ## Features
 
 - 🤖 **AI-Powered**: Uses Google Gemini (via OpenRouter) to generate context-aware translations.
-- � **Parallel Processing**: Translations run concurrently for maximum speed (5x faster).
-- �🔄 **Smart Synchronization**: Detects new, modified, and obsolete keys.
-- �️ **Variable Protection**: Automatically preserves variables like `{name}` or `{count}`.
-- �🔒 **Lock File System**: Prevents unnecessary re-translations of already translated content.
+- ⚡ **Parallel Processing**: Translations run concurrently for maximum speed (5x faster).
+- 🔄 **Smart Synchronization**: Detects new, modified, and obsolete keys.
+- ⛔ **Variable Protection**: Automatically preserves variables like `{name}` or `{count}`.
+- 🔒 **Lock File System**: Prevents unnecessary re-translations of already translated content.
 - 🧩 **Framework Agnostic**: Works with any i18n library that uses JSON files (next-intl, react-i18next, etc.).
 
 ## Installation
@@ -47,6 +47,25 @@ This will create an `i18n-ai.config.json` file:
 bun x i18n-ai sync
 ```
 
+### CLI Options
+
+The `sync` command supports these options:
+
+| Option | Description |
+|--------|-------------|
+| `-d, --dir <path>` | Messages directory (default: `messages`) |
+| `-l, --locales <items>` | Comma-separated list of locales |
+| `--default <locale>` | Default locale (default: `en`) |
+| `--lock <path>` | Lock file path (default: `translation-lock.json`) |
+| `--api-key <key>` | OpenRouter API key (or set `OPENROUTER_API_KEY`) |
+| `--model <model>` | AI model to use (default: `google/gemini-2.5-flash`) |
+
+Example with custom options:
+
+```bash
+bun x i18n-ai sync --locales es,fr,de --model anthropic/claude-3-haiku
+```
+
 ### Environment Variables
 
 You need to provide an API key for the AI provider.
@@ -79,10 +98,8 @@ jobs:
     steps:
       - uses: actions/checkout@v4
       - uses: oven-sh/setup-bun@v1
-      - run: bun install
-      - run: bun x i18n-ai sync
-        env:
-          OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
+       - run: bun install
+       - run: bun x i18n-ai sync --api-key ${{ secrets.OPENROUTER_API_KEY }}
       - run: |
           git config --global user.name "github-actions[bot]"
           git config --global user.email "github-actions[bot]@users.noreply.github.com"

package/dist/{chunk-5QO2MVWV.mjs → chunk-OQMB7A4T.mjs}

@@ -119,19 +119,35 @@ var translate = async ({ text, lang, targetLang, apiKey, model }) => {
 };
 async function translateBatch(batch) {
   if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const results = await Promise.all(
-    batch.entries.map(async (entry) => {
-      const translatedText = await translate({
-        text: entry.text,
-        lang: batch.sourceLang,
-        targetLang: batch.targetLang,
-        apiKey: batch.apiKey,
-        model: batch.model
-      });
-      return [entry.key, translatedText];
-    })
+  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])
   );
-  return new Map(results);
+  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())
+    })
+  });
+  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts

package/dist/cli.js

@@ -24,6 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // src/cli.ts
+var import_dotenv = require("dotenv");
 var import_commander = require("commander");
 var import_node_path2 = require("path");
 var import_promises3 = require("fs/promises");
@@ -119,54 +120,37 @@ function updateLock(lock, locale, base, final) {
 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;
+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. Your main task is to translate text from "${lang}" to "${targetLang}".
+    You are a professional translator.
+    Task: Translate the values of the JSON object from "${batch.sourceLang}" to "${batch.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}"
+    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(model || "google/gemini-2.5-flash"),
+    model: openrouter.languageModel(batch.model || "google/gemini-2.5-flash"),
     system,
-    prompt: `Text to translate: "${text}"`,
+    prompt: JSON.stringify(inputPayload, null, 2),
     output: import_ai.Output.object({
-      schema: import_zod.default.object({
-        translatedText: import_zod.default.string()
-      })
+      schema: import_zod.default.record(import_zod.default.string(), import_zod.default.string())
     })
   });
-  return output.translatedText;
-};
-async function translateBatch(batch) {
-  if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const results = await Promise.all(
-    batch.entries.map(async (entry) => {
-      const translatedText = await translate({
-        text: entry.text,
-        lang: batch.sourceLang,
-        targetLang: batch.targetLang,
-        apiKey: batch.apiKey,
-        model: batch.model
-      });
-      return [entry.key, translatedText];
-    })
-  );
-  return new Map(results);
+  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts
@@ -288,7 +272,8 @@ var TranslationService = class {
 // src/cli.ts
 var import_prompts = __toESM(require("prompts"));
 var import_chalk = __toESM(require("chalk"));
-var VERSION = "0.2.0";
+(0, import_dotenv.config)({ path: (0, import_node_path2.resolve)(process.cwd(), ".env") });
+var VERSION = "0.2.2";
 var program = new import_commander.Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version(VERSION);
 var CONFIG_FILE = "i18n.config.json";
@@ -350,6 +335,13 @@ program.command("init").description("Initialize i18n-ai configuration").action(a
     await (0, import_promises3.writeFile)(baseFilePath, JSON.stringify({ welcome: "Hello World" }, null, 2));
     console.log(import_chalk.default.green(`\u2705 Created base file ${response.messagesDir}/${response.defaultLocale}.json`));
   }
+  if (process.env.OPENROUTER_API_KEY) {
+    console.log(import_chalk.default.green("\u2705 OPENROUTER_API_KEY detected in .env"));
+  } else {
+    console.log(import_chalk.default.yellow("\n\u26A0\uFE0F  OPENROUTER_API_KEY not found in .env"));
+    console.log(import_chalk.default.dim("   Add it to your .env file: OPENROUTER_API_KEY=your_key"));
+    console.log(import_chalk.default.dim("   Get one at: https://openrouter.ai"));
+  }
   console.log(import_chalk.default.blue('\n\u{1F389} Setup complete! You can now run "i18n-ai sync"'));
 });
 program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale").option("--lock <path>", "Lock file path", "translation-lock.json").option("--api-key <key>", "OpenRouter API key (or set OPENROUTER_API_KEY)").option("--model <model>", "AI model to use", "google/gemini-2.5-flash").action(async (options) => {

package/dist/cli.mjs

@@ -1,15 +1,17 @@
 #!/usr/bin/env node
 import {
   TranslationService
-} from "./chunk-5QO2MVWV.mjs";
+} from "./chunk-OQMB7A4T.mjs";
 
 // src/cli.ts
+import { config as loadEnv } from "dotenv";
 import { Command } from "commander";
 import { resolve, join } from "path";
 import { readFile, writeFile, mkdir } from "fs/promises";
 import prompts from "prompts";
 import chalk from "chalk";
-var VERSION = "0.2.0";
+loadEnv({ path: resolve(process.cwd(), ".env") });
+var VERSION = "0.2.2";
 var program = new Command();
 program.name("i18n-ai").description("AI-powered translation CLI").version(VERSION);
 var CONFIG_FILE = "i18n.config.json";
@@ -71,6 +73,13 @@ program.command("init").description("Initialize i18n-ai configuration").action(a
     await writeFile(baseFilePath, JSON.stringify({ welcome: "Hello World" }, null, 2));
     console.log(chalk.green(`\u2705 Created base file ${response.messagesDir}/${response.defaultLocale}.json`));
   }
+  if (process.env.OPENROUTER_API_KEY) {
+    console.log(chalk.green("\u2705 OPENROUTER_API_KEY detected in .env"));
+  } else {
+    console.log(chalk.yellow("\n\u26A0\uFE0F  OPENROUTER_API_KEY not found in .env"));
+    console.log(chalk.dim("   Add it to your .env file: OPENROUTER_API_KEY=your_key"));
+    console.log(chalk.dim("   Get one at: https://openrouter.ai"));
+  }
   console.log(chalk.blue('\n\u{1F389} Setup complete! You can now run "i18n-ai sync"'));
 });
 program.command("sync").description("Synchronize translations using AI").option("-d, --dir <path>", "Messages directory").option("-l, --locales <items>", "Comma separated list of locales").option("--default <locale>", "Default locale").option("--lock <path>", "Lock file path", "translation-lock.json").option("--api-key <key>", "OpenRouter API key (or set OPENROUTER_API_KEY)").option("--model <model>", "AI model to use", "google/gemini-2.5-flash").action(async (options) => {

package/dist/index.js

@@ -160,19 +160,35 @@ var translate = async ({ text, lang, targetLang, apiKey, model }) => {
 };
 async function translateBatch(batch) {
   if (batch.entries.length === 0) return /* @__PURE__ */ new Map();
-  const results = await Promise.all(
-    batch.entries.map(async (entry) => {
-      const translatedText = await translate({
-        text: entry.text,
-        lang: batch.sourceLang,
-        targetLang: batch.targetLang,
-        apiKey: batch.apiKey,
-        model: batch.model
-      });
-      return [entry.key, translatedText];
-    })
+  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])
   );
-  return new Map(results);
+  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())
+    })
+  });
+  return new Map(Object.entries(output));
 }
 
 // src/core/sync.ts

package/dist/index.mjs

@@ -5,7 +5,7 @@ import {
   translateBatch,
   updateLock,
   withLockFile
-} from "./chunk-5QO2MVWV.mjs";
+} from "./chunk-OQMB7A4T.mjs";
 export {
   TranslationService,
   analyzeLocale,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AI-powered i18n translation and synchronization library",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -39,6 +39,7 @@
     "ai": "^6.0.37",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
+    "dotenv": "^17.2.3",
     "p-queue": "^9.1.0",
     "prompts": "^2.4.2",
     "proper-lockfile": "^4.1.2",