transduck 0.1.5 → 0.2.2

package/dist/providers/claude-api.js

@@ -0,0 +1,50 @@
+/**
+ * Claude API translation provider.
+ * Uses the @anthropic-ai/sdk package (optional peer dependency, lazy imported).
+ */
+import { buildMessages, buildPluralMessages } from './prompts.js';
+async function getClient(config) {
+    let Anthropic;
+    try {
+        // @ts-ignore — optional peer dependency, may not be installed
+        const mod = await import('@anthropic-ai/sdk');
+        Anthropic = mod.default ?? mod.Anthropic;
+    }
+    catch {
+        throw new Error('Install the required package: npm install @anthropic-ai/sdk');
+    }
+    const apiKey = process.env[config.apiKeyEnv];
+    if (!apiKey) {
+        throw new Error(`Set ${config.apiKeyEnv} environment variable`);
+    }
+    return new Anthropic({ apiKey });
+}
+export async function translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config) {
+    const client = await getClient(config);
+    const messages = buildMessages({
+        sourceText, sourceLang, targetLang, projectContext, stringContext,
+    });
+    const response = await client.messages.create({
+        model: config.backendModel,
+        max_tokens: 1024,
+        temperature: 0.3,
+        system: messages[0].content,
+        messages: [{ role: 'user', content: messages[1].content }],
+    });
+    return response.content[0].text.trim();
+}
+export async function translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config) {
+    const client = await getClient(config);
+    const messages = buildPluralMessages({
+        one, other, sourceLang, targetLang, projectContext, stringContext,
+    });
+    const response = await client.messages.create({
+        model: config.backendModel,
+        max_tokens: 2048,
+        temperature: 0.3,
+        system: messages[0].content,
+        messages: [{ role: 'user', content: messages[1].content }],
+    });
+    const raw = response.content[0].text.trim();
+    return JSON.parse(raw);
+}

package/dist/providers/claude-code.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Claude Code translation provider (uses Claude Agent SDK with subscription auth).
+ * Uses the @anthropic-ai/claude-agent-sdk package (optional peer dependency, lazy imported).
+ * Already async in JS — no asyncio bridge needed like Python.
+ */
+import type { TransduckConfig } from '../config.js';
+export declare function translate(sourceText: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig): Promise<string>;
+export declare function translatePlural(one: string, other: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig): Promise<Record<string, string>>;

package/dist/providers/claude-code.js

@@ -0,0 +1,47 @@
+/**
+ * Claude Code translation provider (uses Claude Agent SDK with subscription auth).
+ * Uses the @anthropic-ai/claude-agent-sdk package (optional peer dependency, lazy imported).
+ * Already async in JS — no asyncio bridge needed like Python.
+ */
+import { buildSinglePrompt, buildPluralSinglePrompt } from './prompts.js';
+function ensureToken(config) {
+    const token = process.env[config.tokenEnv];
+    if (!token) {
+        throw new Error(`Set ${config.tokenEnv} \u2014 run 'claude setup-token' to get your OAuth token`);
+    }
+}
+async function translateWithSdk(prompt) {
+    let query;
+    try {
+        // @ts-ignore — optional peer dependency, may not be installed
+        const mod = await import('@anthropic-ai/claude-agent-sdk');
+        query = mod.query;
+    }
+    catch {
+        throw new Error('Install the required package: npm install @anthropic-ai/claude-agent-sdk');
+    }
+    for await (const message of query({
+        prompt,
+        options: { allowedTools: [] },
+    })) {
+        if ('result' in message) {
+            return message.result.trim();
+        }
+    }
+    throw new Error('No result from Claude Agent SDK');
+}
+export async function translate(sourceText, sourceLang, targetLang, projectContext, stringContext, config) {
+    ensureToken(config);
+    const prompt = buildSinglePrompt({
+        sourceText, sourceLang, targetLang, projectContext, stringContext,
+    });
+    return translateWithSdk(prompt);
+}
+export async function translatePlural(one, other, sourceLang, targetLang, projectContext, stringContext, config) {
+    ensureToken(config);
+    const prompt = buildPluralSinglePrompt({
+        one, other, sourceLang, targetLang, projectContext, stringContext,
+    });
+    const raw = await translateWithSdk(prompt);
+    return JSON.parse(raw);
+}

package/dist/providers/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Translation provider abstraction.
+ */
+import type { TransduckConfig } from '../config.js';
+export interface TranslationProvider {
+    translate(sourceText: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig, _clientOverride?: any): Promise<string>;
+    translatePlural(one: string, other: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig, _clientOverride?: any): Promise<Record<string, string>>;
+}
+/**
+ * Return the provider module for the configured provider.
+ */
+export declare function getProvider(config: TransduckConfig): Promise<TranslationProvider>;

package/dist/providers/index.js

@@ -0,0 +1,20 @@
+/**
+ * Translation provider abstraction.
+ */
+/**
+ * Return the provider module for the configured provider.
+ */
+export async function getProvider(config) {
+    if (config.provider === 'openai') {
+        return await import('./openai-provider.js');
+    }
+    else if (config.provider === 'claude_api') {
+        return await import('./claude-api.js');
+    }
+    else if (config.provider === 'claude_code') {
+        return await import('./claude-code.js');
+    }
+    else {
+        throw new Error(`Unknown provider: ${config.provider}. Valid: openai, claude_api, claude_code`);
+    }
+}

package/dist/providers/openai-provider.d.ts

@@ -0,0 +1,6 @@
+/**
+ * OpenAI translation provider.
+ */
+import type { TransduckConfig } from '../config.js';
+export declare function translate(sourceText: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig, _clientOverride?: any): Promise<string>;
+export declare function translatePlural(one: string, other: string, sourceLang: string, targetLang: string, projectContext: string, stringContext: string | null, config: TransduckConfig, _clientOverride?: any): Promise<Record<string, string>>;

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/dist/react/index.js

@@ -1 +1,2 @@
+'use client';
 export { TransDuckProvider, t, ait, tPlural, aitPlural, useTransDuck, _resetReactState } from './provider.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "transduck",
-  "version": "0.1.5",
+  "version": "0.2.2",
   "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);
 }