transduck 0.1.5 → 0.2.1

package/dist/providers/openai-provider.js

@@ -0,0 +1,40 @@
+/**
+ * OpenAI translation provider.
+ */
+import OpenAI from 'openai';
+import { buildMessages, buildPluralMessages } from './prompts.js';
+export async function translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    const apiKey = process.env[config.apiKeyEnv];
+    const client = _clientOverride ?? new OpenAI({
+        apiKey,
+        timeout: config.backendTimeout * 1000,
+        maxRetries: config.backendMaxRetries,
+    });
+    const messages = buildMessages({
+        sourceText, sourceLang, targetLang, projectContext, stringContext,
+    });
+    const response = await client.chat.completions.create({
+        model: config.backendModel,
+        messages,
+        temperature: 0.3,
+    });
+    return response.choices[0].message.content.trim();
+}
+export async function translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    const apiKey = process.env[config.apiKeyEnv];
+    const client = _clientOverride ?? new OpenAI({
+        apiKey,
+        timeout: config.backendTimeout * 1000,
+        maxRetries: config.backendMaxRetries,
+    });
+    const messages = buildPluralMessages({
+        one, other, sourceLang, targetLang, projectContext, stringContext,
+    });
+    const response = await client.chat.completions.create({
+        model: config.backendModel,
+        messages,
+        temperature: 0.3,
+    });
+    const raw = response.choices[0].message.content.trim();
+    return JSON.parse(raw);
+}

package/dist/providers/prompts.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Safe string replacement that only replaces known keys.
+ * Does NOT use str.replace with regex — avoids issues with ${value} patterns.
+ */
+export declare function safeRender(template: string, vars: Record<string, string>): string;
+export interface BuildMessagesParams {
+    sourceText: string;
+    sourceLang: string;
+    targetLang: string;
+    projectContext: string;
+    stringContext: string | null;
+}
+export interface BuildPluralMessagesParams {
+    one: string;
+    other: string;
+    sourceLang: string;
+    targetLang: string;
+    projectContext: string;
+    stringContext: string | null;
+}
+/**
+ * Build system + user messages for chat-based providers (OpenAI, Claude API).
+ */
+export declare function buildMessages(params: BuildMessagesParams): Array<{
+    role: string;
+    content: string;
+}>;
+/**
+ * Build system + user messages for plural chat-based providers.
+ */
+export declare function buildPluralMessages(params: BuildPluralMessagesParams): Array<{
+    role: string;
+    content: string;
+}>;
+/**
+ * Build a single combined prompt for non-chat providers (Claude Code).
+ */
+export declare function buildSinglePrompt(params: BuildMessagesParams): string;
+/**
+ * Build a single combined plural prompt for non-chat providers.
+ */
+export declare function buildPluralSinglePrompt(params: BuildPluralMessagesParams): string;

package/dist/providers/prompts.js

@@ -0,0 +1,89 @@
+/* eslint-disable no-template-curly-in-string */
+/**
+ * Shared prompt templates for all translation providers.
+ *
+ * IMPORTANT: Uses string concatenation (NOT template literals) because the
+ * prompt text contains ${value} patterns that must be preserved literally.
+ */
+const SYSTEM_TEMPLATE = 'You are a professional translator. Translate the given text from {source_lang} ' +
+    'to {target_lang}. Return ONLY the translated text, nothing else. Preserve any ' +
+    'placeholders like {name}, {{count}}, %s, ${value} exactly as they appear. ' +
+    'Preserve brand names. Match the tone and formality of the original.\n\n' +
+    'Project context: {project_context}';
+const USER_TEMPLATE = 'Translate: "{source_text}"\nString context: {string_context}';
+const PLURAL_SYSTEM_TEMPLATE = 'You are a professional translator. You will be given two plural forms ' +
+    '(one and other) in {source_lang}. Generate ALL plural forms needed in ' +
+    '{target_lang} according to CLDR plural rules. Return ONLY a JSON object ' +
+    'mapping plural categories to translated strings. Do not include explanation.\n\n' +
+    'CRITICAL: Placeholders like {count}, {name}, %s, ${value} are SOFTWARE VARIABLES ' +
+    'that will be replaced by code at runtime. You MUST include them exactly as written ' +
+    'in EVERY plural form, even for zero, one, and two categories where the language ' +
+    'would not normally use a numeral. For example, for Arabic zero: use "{count} ..." ' +
+    'not "\u0644\u0627 \u062a\u0648\u062c\u062f ...". For Arabic one: use "{count} ..." not "\u0648\u0627\u062d\u062f\u0629 ...".\n\n' +
+    'Preserve brand names. Match the tone and formality of the original.\n\n' +
+    'CLDR plural categories are: zero, one, two, few, many, other.\n' +
+    'Only include categories that {target_lang} actually uses.\n\n' +
+    'Project context: {project_context}';
+const PLURAL_USER_TEMPLATE = 'Source one form: "{one}"\n' +
+    'Source other form: "{other}"\n' +
+    'String context: {string_context}';
+/**
+ * Safe string replacement that only replaces known keys.
+ * Does NOT use str.replace with regex — avoids issues with ${value} patterns.
+ */
+export function safeRender(template, vars) {
+    let result = template;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll('{' + key + '}', value);
+    }
+    return result;
+}
+/**
+ * Build system + user messages for chat-based providers (OpenAI, Claude API).
+ */
+export function buildMessages(params) {
+    const systemMsg = SYSTEM_TEMPLATE
+        .replace('{source_lang}', params.sourceLang)
+        .replace('{target_lang}', params.targetLang)
+        .replace('{project_context}', params.projectContext);
+    const userMsg = USER_TEMPLATE
+        .replace('{source_text}', params.sourceText)
+        .replace('{string_context}', params.stringContext || 'none');
+    return [
+        { role: 'system', content: systemMsg },
+        { role: 'user', content: userMsg },
+    ];
+}
+/**
+ * Build system + user messages for plural chat-based providers.
+ */
+export function buildPluralMessages(params) {
+    const systemMsg = safeRender(PLURAL_SYSTEM_TEMPLATE, {
+        source_lang: params.sourceLang,
+        target_lang: params.targetLang,
+        project_context: params.projectContext,
+    });
+    const userMsg = safeRender(PLURAL_USER_TEMPLATE, {
+        one: params.one,
+        other: params.other,
+        string_context: params.stringContext || 'none',
+    });
+    return [
+        { role: 'system', content: systemMsg },
+        { role: 'user', content: userMsg },
+    ];
+}
+/**
+ * Build a single combined prompt for non-chat providers (Claude Code).
+ */
+export function buildSinglePrompt(params) {
+    const messages = buildMessages(params);
+    return messages[0].content + '\n\n' + messages[1].content;
+}
+/**
+ * Build a single combined plural prompt for non-chat providers.
+ */
+export function buildPluralSinglePrompt(params) {
+    const messages = buildPluralMessages(params);
+    return messages[0].content + '\n\n' + messages[1].content;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transduck",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "description": "AI-native translation tool using source text as keys",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,10 +42,14 @@
   },
   "peerDependencies": {
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0"
+    "react-dom": ">=18.0.0",
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
   },
   "peerDependenciesMeta": {
     "react": { "optional": true },
-    "react-dom": { "optional": true }
+    "react-dom": { "optional": true },
+    "@anthropic-ai/sdk": { "optional": true },
+    "@anthropic-ai/claude-agent-sdk": { "optional": true }
   }
 }

package/src/backend.ts

@@ -1,142 +1,36 @@
-import OpenAI from 'openai';
-
-/* eslint-disable no-template-curly-in-string */
-const SYSTEM_TEMPLATE =
-  'You are a professional translator. Translate the given text from {source_lang} ' +
-  'to {target_lang}. Return ONLY the translated text, nothing else. Preserve any ' +
-  'placeholders like {name}, {{count}}, %s, ${value} exactly as they appear. ' +
-  'Preserve brand names. Match the tone and formality of the original.\n\n' +
-  'Project context: {project_context}';
-
-const USER_TEMPLATE = `Translate: "{source_text}"\nString context: {string_context}`;
-
-const PLURAL_SYSTEM_TEMPLATE =
-  'You are a professional translator. You will be given two plural forms ' +
-  '(one and other) in {source_lang}. Generate ALL plural forms needed in ' +
-  '{target_lang} according to CLDR plural rules. Return ONLY a JSON object ' +
-  'mapping plural categories to translated strings. Do not include explanation.\n\n' +
-  'CRITICAL: Placeholders like {count}, {name}, %s, ${value} are SOFTWARE VARIABLES ' +
-  'that will be replaced by code at runtime. You MUST include them exactly as written ' +
-  'in EVERY plural form, even for zero, one, and two categories where the language ' +
-  'would not normally use a numeral. For example, for Arabic zero: use "{count} ..." ' +
-  'not "لا توجد ...". For Arabic one: use "{count} ..." not "واحدة ...".\n\n' +
-  'Preserve brand names. Match the tone and formality of the original.\n\n' +
-  'CLDR plural categories are: zero, one, two, few, many, other.\n' +
-  'Only include categories that {target_lang} actually uses.\n\n' +
-  'Project context: {project_context}';
-
-const PLURAL_USER_TEMPLATE =
-  'Source one form: "{one}"\n' +
-  'Source other form: "{other}"\n' +
-  'String context: {string_context}';
-
-function safeRender(template: string, vars: Record<string, string>): string {
-  let result = template;
-  for (const [key, value] of Object.entries(vars)) {
-    result = result.replaceAll(`{${key}}`, value);
-  }
-  return result;
-}
-
-interface BuildMessagesParams {
-  sourceText: string;
-  sourceLang: string;
-  targetLang: string;
-  projectContext: string;
-  stringContext: string | null;
-}
-
-interface TranslateParams extends BuildMessagesParams {
-  apiKey: string;
-  model: string;
-  timeout: number;
-  maxRetries: number;
-  _clientOverride?: any;
-}
-
-interface BuildPluralMessagesParams {
-  one: string;
-  other: string;
-  sourceLang: string;
-  targetLang: string;
-  projectContext: string;
-  stringContext: string | null;
-}
-
-interface TranslatePluralParams extends BuildPluralMessagesParams {
-  apiKey: string;
-  model: string;
-  timeout: number;
-  maxRetries: number;
-  _clientOverride?: any;
-}
-
-export function buildMessages(params: BuildMessagesParams): Array<{ role: string; content: string }> {
-  const systemMsg = SYSTEM_TEMPLATE
-    .replace('{source_lang}', params.sourceLang)
-    .replace('{target_lang}', params.targetLang)
-    .replace('{project_context}', params.projectContext);
-
-  const userMsg = USER_TEMPLATE
-    .replace('{source_text}', params.sourceText)
-    .replace('{string_context}', params.stringContext || 'none');
-
-  return [
-    { role: 'system', content: systemMsg },
-    { role: 'user', content: userMsg },
-  ];
-}
-
-export async function translate(params: TranslateParams): Promise<string> {
-  const client = params._clientOverride ?? new OpenAI({
-    apiKey: params.apiKey,
-    timeout: params.timeout * 1000,
-    maxRetries: params.maxRetries,
-  });
-
-  const messages = buildMessages(params);
-  const response = await client.chat.completions.create({
-    model: params.model,
-    messages,
-    temperature: 0.3,
-  });
-
-  return response.choices[0].message.content.trim();
-}
-
-export function buildPluralMessages(params: BuildPluralMessagesParams): Array<{ role: string; content: string }> {
-  const systemMsg = safeRender(PLURAL_SYSTEM_TEMPLATE, {
-    source_lang: params.sourceLang,
-    target_lang: params.targetLang,
-    project_context: params.projectContext,
-  });
-
-  const userMsg = safeRender(PLURAL_USER_TEMPLATE, {
-    one: params.one,
-    other: params.other,
-    string_context: params.stringContext || 'none',
-  });
-
-  return [
-    { role: 'system', content: systemMsg },
-    { role: 'user', content: userMsg },
-  ];
-}
-
-export async function translatePlural(params: TranslatePluralParams): Promise<Record<string, string>> {
-  const client = params._clientOverride ?? new OpenAI({
-    apiKey: params.apiKey,
-    timeout: params.timeout * 1000,
-    maxRetries: params.maxRetries,
-  });
-
-  const messages = buildPluralMessages(params);
-  const response = await client.chat.completions.create({
-    model: params.model,
-    messages,
-    temperature: 0.3,
-  });
-
-  const raw = response.choices[0].message.content.trim();
-  return JSON.parse(raw);
+/**
+ * Translation backend router -- delegates to the configured provider.
+ */
+
+import type { TransduckConfig } from './config.js';
+import { getProvider } from './providers/index.js';
+
+// Re-export prompts for backward compat (tests import buildMessages from backend)
+export { buildMessages, buildPluralMessages } from './providers/prompts.js';
+
+export async function translate(
+  sourceText: string,
+  sourceLang: string,
+  targetLang: string,
+  projectContext: string,
+  stringContext: string | null,
+  config: TransduckConfig,
+  _clientOverride?: any,
+): Promise<string> {
+  const provider = await getProvider(config);
+  return provider.translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
+}
+
+export async function translatePlural(
+  one: string,
+  other: string,
+  sourceLang: string,
+  targetLang: string,
+  projectContext: string,
+  stringContext: string | null,
+  config: TransduckConfig,
+  _clientOverride?: any,
+): Promise<Record<string, string>> {
+  const provider = await getProvider(config);
+  return provider.translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }

package/src/cli.ts

@@ -22,16 +22,41 @@ export interface InitOptions {
   context: string;
   sourceLang: string;
   targetLangs: string[];
+  provider?: number;
 }
 
 export async function runInit(opts: InitOptions): Promise<string> {
-  const config = {
+  const providerChoice = opts.provider ?? 1;
+
+  const config: Record<string, any> = {
     project: { name: opts.name, context: opts.context },
     languages: { source: opts.sourceLang.toUpperCase(), targets: opts.targetLangs.map(l => l.toUpperCase()) },
     storage: { path: './translations.duckdb' },
-    backend: { api_key_env: 'OPENAI_API_KEY', model: 'gpt-4.1-mini', timeout_seconds: 10, max_retries: 2 },
   };
 
+  if (providerChoice === 2) {
+    config.backend = {
+      provider: 'claude_api',
+      api_key_env: 'ANTHROPIC_API_KEY',
+      model: 'claude-haiku-4-5-20251001',
+      timeout_seconds: 10,
+      max_retries: 2,
+    };
+  } else if (providerChoice === 3) {
+    config.backend = {
+      provider: 'claude_code',
+      token_env: 'CLAUDE_CODE_OAUTH_TOKEN',
+    };
+  } else {
+    config.backend = {
+      provider: 'openai',
+      api_key_env: 'OPENAI_API_KEY',
+      model: 'gpt-4.1-mini',
+      timeout_seconds: 10,
+      max_retries: 2,
+    };
+  }
+
   const configPath = join(opts.dir, 'transduck.yaml');
   writeFileSync(configPath, yamlStringify(config));
 
@@ -40,7 +65,23 @@ export async function runInit(opts: InitOptions): Promise<string> {
   await store.initialize();
   store.close();
 
-  return `Created ${configPath}\nCreated ${dbPath}`;
+  const lines = [`Created ${configPath}`, `Created ${dbPath}`];
+
+  if (providerChoice === 2) {
+    lines.push('', 'Add to your .env file: ANTHROPIC_API_KEY=your-key-here');
+  } else if (providerChoice === 3) {
+    lines.push(
+      '',
+      "Run 'claude setup-token' to get your OAuth token, then add to your .env file:",
+      '  CLAUDE_CODE_OAUTH_TOKEN=your-token-here',
+      '',
+      'Note: claude_code works for CLI warming only. Your app will run in read-only mode.',
+    );
+  } else {
+    lines.push('', 'Add to your .env file: OPENAI_API_KEY=your-key-here');
+  }
+
+  return lines.join('\n');
 }
 
 export interface TranslateOptions {
@@ -71,13 +112,10 @@ export async function runTranslate(opts: TranslateOptions): Promise<string> {
     return `[cached] ${interpolateVars(cached, opts.vars)}`;
   }
 
-  const apiKey = process.env[cfg.apiKeyEnv];
-  const translated = await backendTranslate({
-    sourceText: opts.text, sourceLang: cfg.sourceLang, targetLang,
-    projectContext: cfg.projectContext, stringContext: opts.stringContext ?? null,
-    apiKey: apiKey!, model: cfg.backendModel,
-    timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-  });
+  const translated = await backendTranslate(
+    opts.text, cfg.sourceLang, targetLang,
+    cfg.projectContext, opts.stringContext ?? null, cfg,
+  );
 
   if (!validateTranslation(opts.text, translated)) {
     await store.insert({
@@ -141,14 +179,11 @@ export async function runTranslatePlural(opts: TranslatePluralOptions): Promise<
 
   // Cache miss — call backend
   try {
-    const apiKey = process.env[cfg.apiKeyEnv];
-    const forms = await backendTranslatePlural({
-      one: opts.one, other: opts.other,
-      sourceLang: cfg.sourceLang, targetLang,
-      projectContext: cfg.projectContext, stringContext: opts.stringContext ?? null,
-      apiKey: apiKey!, model: cfg.backendModel,
-      timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-    });
+    const forms = await backendTranslatePlural(
+      opts.one, opts.other,
+      cfg.sourceLang, targetLang,
+      cfg.projectContext, opts.stringContext ?? null, cfg,
+    );
 
     // Validate each form
     const sourcePlaceholders = new Set([
@@ -233,7 +268,6 @@ export async function runWarm(opts: WarmOptions): Promise<string> {
     entries = content.split('\n').filter(l => l.trim()).map(text => ({ text: text.trim() }));
   }
 
-  const apiKey = process.env[cfg.apiKeyEnv];
   const projectContextHash = hash(cfg.projectContext);
   let translated = 0, skipped = 0, failed = 0;
 
@@ -255,13 +289,11 @@ export async function runWarm(opts: WarmOptions): Promise<string> {
         }
 
         try {
-          const forms = await backendTranslatePlural({
-            one: entry.one, other: entry.other,
-            sourceLang: cfg.sourceLang, targetLang: lang,
-            projectContext: cfg.projectContext, stringContext: entry.context ?? null,
-            apiKey: apiKey!, model: cfg.backendModel,
-            timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-          });
+          const forms = await backendTranslatePlural(
+            entry.one, entry.other,
+            cfg.sourceLang, lang,
+            cfg.projectContext, entry.context ?? null, cfg,
+          );
 
           const sourcePlaceholders = new Set([
             ...extractPlaceholders(entry.one),
@@ -304,12 +336,10 @@ export async function runWarm(opts: WarmOptions): Promise<string> {
         if (cached !== null) { skipped++; continue; }
 
         try {
-          const result = await backendTranslate({
-            sourceText: entry.text, sourceLang: cfg.sourceLang, targetLang: lang,
-            projectContext: cfg.projectContext, stringContext: entry.context ?? null,
-            apiKey: apiKey!, model: cfg.backendModel,
-            timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-          });
+          const result = await backendTranslate(
+            entry.text, cfg.sourceLang, lang,
+            cfg.projectContext, entry.context ?? null, cfg,
+          );
 
           if (validateTranslation(entry.text, result)) {
             await store.insert({
@@ -397,7 +427,6 @@ export async function runScan(opts: ScanOptions): Promise<string> {
 
     const store = new TranslationStore(cfg.storagePath);
     await store.initialize();
-    const apiKey = process.env[cfg.apiKeyEnv];
     const projectContextHash = hash(cfg.projectContext);
 
     let translated = 0;
@@ -421,13 +450,11 @@ export async function runScan(opts: ScanOptions): Promise<string> {
           }
 
           try {
-            const forms = await backendTranslatePlural({
-              one: entry.one!, other: entry.other!,
-              sourceLang: cfg.sourceLang, targetLang: lang,
-              projectContext: cfg.projectContext, stringContext: entry.context ?? null,
-              apiKey: apiKey!, model: cfg.backendModel,
-              timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-            });
+            const forms = await backendTranslatePlural(
+              entry.one!, entry.other!,
+              cfg.sourceLang, lang,
+              cfg.projectContext, entry.context ?? null, cfg,
+            );
 
             for (const [cat, translatedText] of Object.entries(forms)) {
               await store.insertPlural({
@@ -457,12 +484,10 @@ export async function runScan(opts: ScanOptions): Promise<string> {
           }
 
           try {
-            const result = await backendTranslate({
-              sourceText: entry.text!, sourceLang: cfg.sourceLang, targetLang: lang,
-              projectContext: cfg.projectContext, stringContext: entry.context ?? null,
-              apiKey: apiKey!, model: cfg.backendModel,
-              timeout: cfg.backendTimeout, maxRetries: cfg.backendMaxRetries,
-            });
+            const result = await backendTranslate(
+              entry.text!, cfg.sourceLang, lang,
+              cfg.projectContext, entry.context ?? null, cfg,
+            );
 
             if (validateTranslation(entry.text!, result)) {
               await store.insert({
@@ -533,11 +558,19 @@ program.command('init')
     const context = await ask('Project context: ');
     const sourceLang = await ask('Source language (e.g. EN): ');
     const targetsRaw = await ask('Target languages (comma-separated): ');
+
+    console.log('\nTranslation provider:');
+    console.log('  1. OpenAI (requires API key)');
+    console.log('  2. Claude API (requires API key)');
+    console.log('  3. Claude Code (uses your Claude Code subscription, warming only)');
+    const providerRaw = await ask('Select provider [1]: ');
+    const providerChoice = parseInt(providerRaw, 10) || 1;
     rl.close();
 
     const output = await runInit({
       dir, name, context, sourceLang,
       targetLangs: targetsRaw.split(',').map(s => s.trim()),
+      provider: providerChoice,
     });
     console.log(output);
 

package/src/config.ts

@@ -10,7 +10,9 @@ export interface TransduckConfig {
   sourceLang: string;
   targetLangs: string[];
   storagePath: string;
+  provider: string;
   apiKeyEnv: string;
+  tokenEnv: string;
   backendModel: string;
   backendTimeout: number;
   backendMaxRetries: number;
@@ -49,16 +51,31 @@ export function loadConfig(path?: string): TransduckConfig {
   const configDir = dirname(configPath);
   const storagePath = resolve(configDir, raw.storage.path);
 
+  const backend = raw.backend ?? {};
+  const provider = backend.provider ?? 'openai';
+  const apiKeyEnv = backend.api_key_env ?? 'OPENAI_API_KEY';
+  const tokenEnv = backend.token_env ?? 'CLAUDE_CODE_OAUTH_TOKEN';
+  const backendModel = backend.model ?? 'gpt-4.1-mini';
+  const backendTimeout = backend.timeout_seconds ?? 10;
+  const backendMaxRetries = backend.max_retries ?? 2;
+
+  let readOnly = raw.runtime?.read_only ?? false;
+  if (provider === 'claude_code') {
+    readOnly = true;
+  }
+
   return {
     projectName: raw.project.name,
     projectContext: raw.project.context,
     sourceLang: String(raw.languages.source).toUpperCase(),
     targetLangs: raw.languages.targets.map((l: string) => String(l).toUpperCase()),
     storagePath,
-    apiKeyEnv: raw.backend.api_key_env,
-    backendModel: raw.backend.model,
-    backendTimeout: raw.backend.timeout_seconds,
-    backendMaxRetries: raw.backend.max_retries,
-    readOnly: raw.runtime?.read_only ?? false,
+    provider,
+    apiKeyEnv,
+    tokenEnv,
+    backendModel,
+    backendTimeout,
+    backendMaxRetries,
+    readOnly,
   };
 }