transduck 0.5.0 → 0.5.2

package/dist/backend.js

@@ -4,11 +4,31 @@
 import { getProvider } from './providers/index.js';
 // Re-export prompts for backward compat (tests import buildMessages from backend)
 export { buildMessages, buildPluralMessages } from './providers/prompts.js';
+function checkApiKey(config) {
+    if (config.provider === 'claude_code') {
+        const token = process.env[config.tokenEnv];
+        if (!token) {
+            throw new Error(`Missing API token: ${config.tokenEnv} environment variable is not set.\n` +
+                `Run: export ${config.tokenEnv}=your-token-here`);
+        }
+        return;
+    }
+    const apiKey = process.env[config.apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Missing API key: ${config.apiKeyEnv} environment variable is not set.\n` +
+            `Run: export ${config.apiKeyEnv}=your-key-here\n` +
+            `Or add it to your .env file.`);
+    }
+}
 export async function translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    if (!_clientOverride)
+        checkApiKey(config);
     const provider = await getProvider(config);
     return provider.translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }
 export async function translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride) {
+    if (!_clientOverride)
+        checkApiKey(config);
     const provider = await getProvider(config);
     return provider.translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }

package/dist/cli.d.ts

@@ -43,6 +43,13 @@ export declare function runScan(opts: ScanOptions): Promise<string>;
 export interface StatsOptions {
     configPath?: string;
 }
+export interface ClearOptions {
+    lang?: string;
+    failedOnly?: boolean;
+    yes?: boolean;
+    configPath?: string;
+}
+export declare function runClear(opts: ClearOptions): Promise<string>;
 export declare function runStats(opts: StatsOptions): Promise<string>;
 declare const program: Command;
 export { program };

package/dist/cli.js

@@ -434,6 +434,45 @@ export async function runScan(opts) {
     }
     return lines.join('\n');
 }
+export async function runClear(opts) {
+    const cfg = loadConfig(opts.configPath);
+    const store = new TranslationStore(cfg.storagePath);
+    await store.initialize();
+    const targetLang = opts.lang?.toUpperCase();
+    const entryCount = store.count(targetLang, opts.failedOnly);
+    let desc;
+    if (targetLang && opts.failedOnly) {
+        desc = `${entryCount} failed translation(s) for ${targetLang}`;
+    }
+    else if (targetLang) {
+        desc = `${entryCount} translation(s) for ${targetLang}`;
+    }
+    else if (opts.failedOnly) {
+        desc = `${entryCount} failed translation(s) across all languages`;
+    }
+    else {
+        desc = `${entryCount} translation(s) across all languages`;
+    }
+    if (entryCount === 0) {
+        store.close();
+        return 'Nothing to clear.';
+    }
+    if (!opts.yes) {
+        const readline = await import('readline');
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const answer = await new Promise(resolve => {
+            rl.question(`This will delete ${desc}. Type "Yes" to confirm: `, resolve);
+        });
+        rl.close();
+        if (answer !== 'Yes') {
+            store.close();
+            return 'Cancelled.';
+        }
+    }
+    await store.clear(targetLang, opts.failedOnly);
+    store.close();
+    return `Deleted ${desc}.`;
+}
 export async function runStats(opts) {
     const cfg = loadConfig(opts.configPath);
     const store = new TranslationStore(cfg.storagePath);
@@ -454,7 +493,7 @@ export async function runStats(opts) {
 }
 // CLI entry point
 const program = new Command();
-program.name('transduck').description('AI-native translation tool').version('0.5.0');
+program.name('transduck').description('AI-native translation tool').version('0.5.2');
 program.command('init')
     .description('Initialize a new transduck project')
     .action(async () => {
@@ -539,6 +578,21 @@ program.command('warm')
     });
     console.log(output);
 });
+program.command('clear')
+    .description('Clear cached translations from the database')
+    .option('--lang <code>', 'Only clear translations for this language')
+    .option('--failed-only', 'Only clear failed translations')
+    .option('-y, --yes', 'Skip confirmation prompt')
+    .option('--config <path>', 'Path to transduck.yaml')
+    .action(async (opts) => {
+    const output = await runClear({
+        lang: opts.lang,
+        failedOnly: opts.failedOnly,
+        yes: opts.yes,
+        configPath: opts.config ?? '',
+    });
+    console.log(output);
+});
 program.command('stats')
     .description('Show translation database statistics')
     .option('--config <path>', 'Path to transduck.yaml')

package/dist/storage.js

@@ -47,7 +47,7 @@ export class TranslationStore {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
         db.prepare(`INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
-       VALUES (?, ?, ?, '', ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext);
+       VALUES (?, ?, ?, '', ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext ?? '');
     }
     async lookupPlural(params) {
         const db = this.getDb();
@@ -64,7 +64,7 @@ export class TranslationStore {
         const db = this.getDb();
         const chash = contentHash(params.sourceText, params.projectContextHash, params.stringContextHash);
         db.prepare(`INSERT OR IGNORE INTO translations (source_lang, target_lang, content_hash, plural_category, source_text, translated_text, model, status, created_at, project_context_hash, string_context_hash, string_context)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.pluralCategory, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext);
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(params.sourceLang, params.targetLang, chash, params.pluralCategory, params.sourceText, params.translatedText, params.model, params.status, new Date().toISOString(), params.projectContextHash, params.stringContextHash, params.stringContext ?? '');
     }
     async stats() {
         const db = this.getDb();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transduck",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "AI-native translation tool using source text as keys",
   "type": "module",
   "main": "./dist/index.js",

package/src/backend.ts

@@ -8,6 +8,27 @@ import { getProvider } from './providers/index.js';
 // Re-export prompts for backward compat (tests import buildMessages from backend)
 export { buildMessages, buildPluralMessages } from './providers/prompts.js';
 
+function checkApiKey(config: TransduckConfig): void {
+  if (config.provider === 'claude_code') {
+    const token = process.env[config.tokenEnv];
+    if (!token) {
+      throw new Error(
+        `Missing API token: ${config.tokenEnv} environment variable is not set.\n` +
+        `Run: export ${config.tokenEnv}=your-token-here`
+      );
+    }
+    return;
+  }
+  const apiKey = process.env[config.apiKeyEnv];
+  if (!apiKey) {
+    throw new Error(
+      `Missing API key: ${config.apiKeyEnv} environment variable is not set.\n` +
+      `Run: export ${config.apiKeyEnv}=your-key-here\n` +
+      `Or add it to your .env file.`
+    );
+  }
+}
+
 export async function translate(
   sourceText: string,
   sourceLang: string,
@@ -17,6 +38,7 @@ export async function translate(
   config: TransduckConfig,
   _clientOverride?: any,
 ): Promise<string> {
+  if (!_clientOverride) checkApiKey(config);
   const provider = await getProvider(config);
   return provider.translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }
@@ -31,6 +53,7 @@ export async function translatePlural(
   config: TransduckConfig,
   _clientOverride?: any,
 ): Promise<Record<string, string>> {
+  if (!_clientOverride) checkApiKey(config);
   const provider = await getProvider(config);
   return provider.translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config, _clientOverride);
 }

package/src/cli.ts

@@ -539,6 +539,55 @@ export interface StatsOptions {
   configPath?: string;
 }
 
+export interface ClearOptions {
+  lang?: string;
+  failedOnly?: boolean;
+  yes?: boolean;
+  configPath?: string;
+}
+
+export async function runClear(opts: ClearOptions): Promise<string> {
+  const cfg = loadConfig(opts.configPath);
+  const store = new TranslationStore(cfg.storagePath);
+  await store.initialize();
+
+  const targetLang = opts.lang?.toUpperCase();
+  const entryCount = store.count(targetLang, opts.failedOnly);
+
+  let desc: string;
+  if (targetLang && opts.failedOnly) {
+    desc = `${entryCount} failed translation(s) for ${targetLang}`;
+  } else if (targetLang) {
+    desc = `${entryCount} translation(s) for ${targetLang}`;
+  } else if (opts.failedOnly) {
+    desc = `${entryCount} failed translation(s) across all languages`;
+  } else {
+    desc = `${entryCount} translation(s) across all languages`;
+  }
+
+  if (entryCount === 0) {
+    store.close();
+    return 'Nothing to clear.';
+  }
+
+  if (!opts.yes) {
+    const readline = await import('readline');
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise<string>(resolve => {
+      rl.question(`This will delete ${desc}. Type "Yes" to confirm: `, resolve);
+    });
+    rl.close();
+    if (answer !== 'Yes') {
+      store.close();
+      return 'Cancelled.';
+    }
+  }
+
+  await store.clear(targetLang, opts.failedOnly);
+  store.close();
+  return `Deleted ${desc}.`;
+}
+
 export async function runStats(opts: StatsOptions): Promise<string> {
   const cfg = loadConfig(opts.configPath);
   const store = new TranslationStore(cfg.storagePath);
@@ -562,7 +611,7 @@ export async function runStats(opts: StatsOptions): Promise<string> {
 // CLI entry point
 const program = new Command();
 
-program.name('transduck').description('AI-native translation tool').version('0.5.0');
+program.name('transduck').description('AI-native translation tool').version('0.5.2');
 
 program.command('init')
   .description('Initialize a new transduck project')
@@ -659,6 +708,22 @@ program.command('warm')
     console.log(output);
   });
 
+program.command('clear')
+  .description('Clear cached translations from the database')
+  .option('--lang <code>', 'Only clear translations for this language')
+  .option('--failed-only', 'Only clear failed translations')
+  .option('-y, --yes', 'Skip confirmation prompt')
+  .option('--config <path>', 'Path to transduck.yaml')
+  .action(async (opts: { lang?: string; failedOnly?: boolean; yes?: boolean; config?: string }) => {
+    const output = await runClear({
+      lang: opts.lang,
+      failedOnly: opts.failedOnly,
+      yes: opts.yes,
+      configPath: opts.config ?? '',
+    });
+    console.log(output);
+  });
+
 program.command('stats')
   .description('Show translation database statistics')
   .option('--config <path>', 'Path to transduck.yaml')

package/src/storage.ts

@@ -90,7 +90,7 @@ export class TranslationStore {
       params.sourceLang, params.targetLang, chash,
       params.sourceText, params.translatedText, params.model, params.status,
       new Date().toISOString(),
-      params.projectContextHash, params.stringContextHash, params.stringContext,
+      params.projectContextHash, params.stringContextHash, params.stringContext ?? '',
     );
   }
 
@@ -118,7 +118,7 @@ export class TranslationStore {
       params.sourceLang, params.targetLang, chash, params.pluralCategory,
       params.sourceText, params.translatedText, params.model, params.status,
       new Date().toISOString(),
-      params.projectContextHash, params.stringContextHash, params.stringContext,
+      params.projectContextHash, params.stringContextHash, params.stringContext ?? '',
     );
   }