glotfile 0.1.1 → 0.2.0

package/README.md

@@ -8,7 +8,7 @@ to make.
 
 - **One source of truth** — every string and translation lives in `glotfile.json`, committed alongside your code. Versioning, review, and rollback come from git. For large catalogs, run `glotfile split` to store the catalog as a `glotfile/` directory with one file per locale — so a one-locale change is a one-file `git diff` instead of a multi-megabyte one. The in-app experience is identical.
 - **Local web UI** — run one command, edit in the browser, changes save straight back to the file.
-- **AI translation** — fill in missing languages with Anthropic, OpenAI, or AWS Bedrock, using per-key context, a glossary, and screenshots.
+- **AI translation** — fill in missing languages with Anthropic, OpenAI, AWS Bedrock, or OpenRouter, using per-key context, a glossary, and screenshots.
 - **Export anywhere** — generate Flutter ARB, Laravel PHP, i18next JSON, gettext `.po`, and Apple `.stringsdict` from the same source.
 
 ---
@@ -181,9 +181,9 @@ in the project directory. For example:
 ANTHROPIC_API_KEY=sk-ant-...
 ```
 
-Three providers are supported — Anthropic (default), OpenAI, and AWS Bedrock
-(Amazon Nova, Claude, and Meta Llama). For the full setup of each — required
-env vars, model ids, regions, and the optional SDKs to install — see
+Four providers are supported — Anthropic (default), OpenAI, AWS Bedrock
+(Amazon Nova, Claude, and Meta Llama), and OpenRouter. For the full setup of
+each — required env vars, model ids, regions, and the optional SDKs to install — see
 **[docs/ai-providers.md](docs/ai-providers.md)**.
 
 What the translator does for you:

package/dist/server/cli.js

@@ -277,7 +277,7 @@ var init_schema = __esm({
     PLURAL_CATEGORIES = ["zero", "one", "two", "few", "many", "other"];
     EXACT_SELECTOR_RE = /^=\d+$/;
     LOCALE_CASES = ["lower-hyphen", "lower-underscore", "bcp47-hyphen", "bcp47-underscore"];
-    PROVIDERS = ["anthropic", "openai", "bedrock"];
+    PROVIDERS = ["anthropic", "openai", "bedrock", "openrouter"];
     GlotfileError = class extends Error {
     };
   }
@@ -1768,6 +1768,17 @@ var init_anthropic = __esm({
 
 // src/server/ai/openai.ts
 import { createRequire } from "module";
+function loadOpenAIClient(opts) {
+  const require2 = createRequire(import.meta.url);
+  let OpenAICtor;
+  try {
+    const mod = require2("openai");
+    OpenAICtor = mod.OpenAI ?? mod.default ?? mod;
+  } catch {
+    throw new Error("The OpenAI SDK is required for this provider. Install it: npm i openai");
+  }
+  return new OpenAICtor(opts);
+}
 var OpenAIProvider;
 var init_openai = __esm({
   "src/server/ai/openai.ts"() {
@@ -1784,15 +1795,7 @@ var init_openai = __esm({
         if (!process.env.OPENAI_API_KEY) {
           throw new Error("OPENAI_API_KEY is not set. AI translation requires it; every other feature works offline.");
         }
-        const require2 = createRequire(import.meta.url);
-        let OpenAICtor;
-        try {
-          const mod = require2("openai");
-          OpenAICtor = mod.OpenAI ?? mod.default ?? mod;
-        } catch {
-          throw new Error('Provider "openai" requires the OpenAI SDK. Install it: npm i openai');
-        }
-        this.client = new OpenAICtor({ baseURL: config.endpoint ?? void 0 });
+        this.client = loadOpenAIClient({ baseURL: config.endpoint ?? void 0 });
       }
       config;
       client;
@@ -1985,6 +1988,34 @@ var init_bedrock = __esm({
   }
 });
 
+// src/server/ai/openrouter.ts
+function openRouterClientOptions(config) {
+  const apiKey = process.env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    throw new Error("OPENROUTER_API_KEY is not set. AI translation requires it; every other feature works offline.");
+  }
+  return {
+    apiKey,
+    baseURL: config.endpoint ?? OPENROUTER_BASE_URL,
+    defaultHeaders: { "HTTP-Referer": OPENROUTER_REFERER, "X-Title": OPENROUTER_TITLE }
+  };
+}
+var OPENROUTER_BASE_URL, OPENROUTER_REFERER, OPENROUTER_TITLE, OpenRouterProvider;
+var init_openrouter = __esm({
+  "src/server/ai/openrouter.ts"() {
+    "use strict";
+    init_openai();
+    OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+    OPENROUTER_REFERER = "https://www.npmjs.com/package/glotfile";
+    OPENROUTER_TITLE = "glotfile";
+    OpenRouterProvider = class extends OpenAIProvider {
+      constructor(config, client) {
+        super(config, client ?? loadOpenAIClient(openRouterClientOptions(config)));
+      }
+    };
+  }
+});
+
 // src/server/ai/index.ts
 function makeProvider(config) {
   const ai = config.ai;
@@ -1995,8 +2026,10 @@ function makeProvider(config) {
       return new OpenAIProvider(ai);
     case "bedrock":
       return new BedrockProvider(ai);
+    case "openrouter":
+      return new OpenRouterProvider(ai);
     default:
-      throw new Error(`Unknown AI provider "${String(ai.provider)}". Supported: anthropic, openai, bedrock.`);
+      throw new Error(`Unknown AI provider "${String(ai.provider)}". Supported: anthropic, openai, bedrock, openrouter.`);
   }
 }
 var init_ai = __esm({
@@ -2005,6 +2038,7 @@ var init_ai = __esm({
     init_anthropic();
     init_openai();
     init_bedrock();
+    init_openrouter();
   }
 });
 

package/dist/server/server.js

@@ -83,7 +83,7 @@ function isPluralForm(key) {
   return PLURAL_CATEGORIES.includes(key) || EXACT_SELECTOR_RE.test(key);
 }
 var LOCALE_CASES = ["lower-hyphen", "lower-underscore", "bcp47-hyphen", "bcp47-underscore"];
-var PROVIDERS = ["anthropic", "openai", "bedrock"];
+var PROVIDERS = ["anthropic", "openai", "bedrock", "openrouter"];
 var GlotfileError = class extends Error {
 };
 function isObject(v) {
@@ -2517,6 +2517,17 @@ var AnthropicProvider = class {
 
 // src/server/ai/openai.ts
 import { createRequire } from "module";
+function loadOpenAIClient(opts) {
+  const require2 = createRequire(import.meta.url);
+  let OpenAICtor;
+  try {
+    const mod = require2("openai");
+    OpenAICtor = mod.OpenAI ?? mod.default ?? mod;
+  } catch {
+    throw new Error("The OpenAI SDK is required for this provider. Install it: npm i openai");
+  }
+  return new OpenAICtor(opts);
+}
 var OpenAIProvider = class {
   constructor(config, client) {
     this.config = config;
@@ -2527,15 +2538,7 @@ var OpenAIProvider = class {
     if (!process.env.OPENAI_API_KEY) {
       throw new Error("OPENAI_API_KEY is not set. AI translation requires it; every other feature works offline.");
     }
-    const require2 = createRequire(import.meta.url);
-    let OpenAICtor;
-    try {
-      const mod = require2("openai");
-      OpenAICtor = mod.OpenAI ?? mod.default ?? mod;
-    } catch {
-      throw new Error('Provider "openai" requires the OpenAI SDK. Install it: npm i openai');
-    }
-    this.client = new OpenAICtor({ baseURL: config.endpoint ?? void 0 });
+    this.client = loadOpenAIClient({ baseURL: config.endpoint ?? void 0 });
   }
   config;
   client;
@@ -2718,6 +2721,27 @@ var BedrockProvider = class {
   }
 };
 
+// src/server/ai/openrouter.ts
+var OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1";
+var OPENROUTER_REFERER = "https://www.npmjs.com/package/glotfile";
+var OPENROUTER_TITLE = "glotfile";
+function openRouterClientOptions(config) {
+  const apiKey = process.env.OPENROUTER_API_KEY;
+  if (!apiKey) {
+    throw new Error("OPENROUTER_API_KEY is not set. AI translation requires it; every other feature works offline.");
+  }
+  return {
+    apiKey,
+    baseURL: config.endpoint ?? OPENROUTER_BASE_URL,
+    defaultHeaders: { "HTTP-Referer": OPENROUTER_REFERER, "X-Title": OPENROUTER_TITLE }
+  };
+}
+var OpenRouterProvider = class extends OpenAIProvider {
+  constructor(config, client) {
+    super(config, client ?? loadOpenAIClient(openRouterClientOptions(config)));
+  }
+};
+
 // src/server/ai/index.ts
 function makeProvider(config) {
   const ai = config.ai;
@@ -2728,8 +2752,10 @@ function makeProvider(config) {
       return new OpenAIProvider(ai);
     case "bedrock":
       return new BedrockProvider(ai);
+    case "openrouter":
+      return new OpenRouterProvider(ai);
     default:
-      throw new Error(`Unknown AI provider "${String(ai.provider)}". Supported: anthropic, openai, bedrock.`);
+      throw new Error(`Unknown AI provider "${String(ai.provider)}". Supported: anthropic, openai, bedrock, openrouter.`);
   }
 }