glotfile 0.1.0 → 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();
   }
 });
 
@@ -4189,6 +4223,7 @@ import { serve } from "@hono/node-server";
 import { fileURLToPath } from "url";
 import { dirname as dirname6, join as join7, resolve as resolve8, extname as extname3, sep as sep2 } from "path";
 import { readFile, stat } from "fs/promises";
+import { createServer } from "net";
 import open from "open";
 async function readFileResponse(absPath) {
   try {
@@ -4236,10 +4271,25 @@ function buildApp(opts) {
   }
   return app;
 }
-function startServer(opts) {
+function findAvailablePort(start) {
+  return new Promise((resolveP, reject) => {
+    const probe = createServer();
+    probe.listen(start, "127.0.0.1", () => {
+      probe.close(() => resolveP(start));
+    });
+    probe.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        findAvailablePort(start + 1).then(resolveP, reject);
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+async function startServer(opts) {
   const app = buildApp(opts);
+  const port = await findAvailablePort(opts.dev ? DEV_PORT : DEFAULT_PORT);
   return new Promise((resolveP) => {
-    const port = opts.dev ? 8787 : 0;
     const server = serve({ fetch: app.fetch, hostname: "127.0.0.1", port }, (info) => {
       const url = `http://127.0.0.1:${info.port}`;
       if (opts.open !== false && !opts.dev) void open(url);
@@ -4261,7 +4311,7 @@ function backgroundScan(statePath) {
     console.warn("[scan] failed:", err instanceof Error ? err.message : String(err));
   });
 }
-var here, DEFAULT_UI_DIR, MIME;
+var here, DEFAULT_UI_DIR, MIME, DEFAULT_PORT, DEV_PORT;
 var init_server = __esm({
   "src/server/server.ts"() {
     "use strict";
@@ -4285,6 +4335,8 @@ var init_server = __esm({
       ".woff2": "font/woff2",
       ".woff": "font/woff"
     };
+    DEFAULT_PORT = 3e3;
+    DEV_PORT = 8787;
   }
 });
 

package/dist/server/server.js

@@ -31,6 +31,7 @@ import { serve } from "@hono/node-server";
 import { fileURLToPath } from "url";
 import { dirname as dirname6, join as join7, resolve as resolve7, extname as extname3, sep as sep2 } from "path";
 import { readFile, stat } from "fs/promises";
+import { createServer } from "net";
 import open from "open";
 
 // src/server/api.ts
@@ -82,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) {
@@ -2516,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;
@@ -2526,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;
@@ -2717,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;
@@ -2727,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.`);
   }
 }
 
@@ -3905,10 +3932,27 @@ function buildApp(opts) {
   }
   return app;
 }
-function startServer(opts) {
+var DEFAULT_PORT = 3e3;
+var DEV_PORT = 8787;
+function findAvailablePort(start) {
+  return new Promise((resolveP, reject) => {
+    const probe = createServer();
+    probe.listen(start, "127.0.0.1", () => {
+      probe.close(() => resolveP(start));
+    });
+    probe.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        findAvailablePort(start + 1).then(resolveP, reject);
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+async function startServer(opts) {
   const app = buildApp(opts);
+  const port = await findAvailablePort(opts.dev ? DEV_PORT : DEFAULT_PORT);
   return new Promise((resolveP) => {
-    const port = opts.dev ? 8787 : 0;
     const server = serve({ fetch: app.fetch, hostname: "127.0.0.1", port }, (info) => {
       const url = `http://127.0.0.1:${info.port}`;
       if (opts.open !== false && !opts.dev) void open(url);