@ccgp/i18n-ai 0.2.0 → 0.2.1

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/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");
@@ -288,7 +289,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.1";
 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 +352,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

@@ -4,12 +4,14 @@ import {
 } from "./chunk-5QO2MVWV.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.1";
 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccgp/i18n-ai",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "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",