@lingo.dev/compiler 0.1.2 → 0.1.3

package/build/translators/lingo/provider-details.mjs

@@ -0,0 +1,69 @@
+//#region src/translators/lingo/provider-details.ts
+const providerDetails = {
+	groq: {
+		name: "Groq",
+		apiKeyEnvVar: "GROQ_API_KEY",
+		apiKeyConfigKey: "llm.groqApiKey",
+		getKeyLink: "https://groq.com",
+		docsLink: "https://console.groq.com/docs/errors"
+	},
+	google: {
+		name: "Google",
+		apiKeyEnvVar: "GOOGLE_API_KEY",
+		apiKeyConfigKey: "llm.googleApiKey",
+		getKeyLink: "https://ai.google.dev/",
+		docsLink: "https://ai.google.dev/gemini-api/docs/troubleshooting"
+	},
+	openrouter: {
+		name: "OpenRouter",
+		apiKeyEnvVar: "OPENROUTER_API_KEY",
+		apiKeyConfigKey: "llm.openrouterApiKey",
+		getKeyLink: "https://openrouter.ai",
+		docsLink: "https://openrouter.ai/docs"
+	},
+	ollama: {
+		name: "Ollama",
+		apiKeyEnvVar: void 0,
+		apiKeyConfigKey: void 0,
+		getKeyLink: "https://ollama.com/download",
+		docsLink: "https://github.com/ollama/ollama/tree/main/docs"
+	},
+	mistral: {
+		name: "Mistral",
+		apiKeyEnvVar: "MISTRAL_API_KEY",
+		apiKeyConfigKey: "llm.mistralApiKey",
+		getKeyLink: "https://console.mistral.ai",
+		docsLink: "https://docs.mistral.ai"
+	},
+	"lingo.dev": {
+		name: "Lingo.dev",
+		apiKeyEnvVar: "LINGODOTDEV_API_KEY",
+		apiKeyConfigKey: "auth.apiKey",
+		getKeyLink: "https://lingo.dev",
+		docsLink: "https://lingo.dev/docs"
+	}
+};
+/**
+* Format error message when API keys are missing for configured providers
+* @param missingProviders List of providers that are missing API keys
+* @param allProviders Optional: list of all configured providers for context
+*/
+function formatNoApiKeysError(missingProviders, allProviders) {
+	const lines = [];
+	if (missingProviders.length === 0) return "Translation API keys validated successfully.";
+	if (allProviders && allProviders.length > missingProviders.length) lines.push(`Missing API keys for ${missingProviders.length} of ${allProviders.length} configured providers.`);
+	else lines.push(`Missing API keys for configured translation providers.`);
+	lines.push(`Missing API keys for:`);
+	for (const providerId of missingProviders) {
+		const details = providerDetails[providerId];
+		if (details) if (details.apiKeyEnvVar) lines.push(`   • ${details.name}: ${details.apiKeyEnvVar}  →  ${details.getKeyLink}`);
+		else lines.push(`   • ${details.name}: ${details.getKeyLink}`);
+		else lines.push(`   • ${providerId}: (unknown provider)`);
+	}
+	lines.push(``, `👉 Set the required API keys:`, `   1. Add to .env file (recommended)`, `   2. Or export in terminal: export API_KEY_NAME=<your-key>`, ``);
+	return lines.join("\n");
+}
+
+//#endregion
+export { formatNoApiKeysError };
+//# sourceMappingURL=provider-details.mjs.map

package/build/translators/lingo/provider-details.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-details.mjs","names":["providerDetails: Record<string, ProviderDetails>","lines: string[]"],"sources":["../../../src/translators/lingo/provider-details.ts"],"sourcesContent":["/**\n * Provider details for error messages and documentation links\n */\n\nexport interface ProviderDetails {\n  name: string; // Display name (e.g., \"Groq\", \"Google\")\n  apiKeyEnvVar?: string; // Environment variable name (e.g., \"GROQ_API_KEY\")\n  apiKeyConfigKey?: string; // Config key if applicable (e.g., \"llm.groqApiKey\")\n  getKeyLink: string; // Link to get API key\n  docsLink: string; // Link to API docs for troubleshooting\n}\n\nexport const providerDetails: Record<string, ProviderDetails> = {\n  groq: {\n    name: \"Groq\",\n    apiKeyEnvVar: \"GROQ_API_KEY\",\n    apiKeyConfigKey: \"llm.groqApiKey\",\n    getKeyLink: \"https://groq.com\",\n    docsLink: \"https://console.groq.com/docs/errors\",\n  },\n  google: {\n    name: \"Google\",\n    apiKeyEnvVar: \"GOOGLE_API_KEY\",\n    apiKeyConfigKey: \"llm.googleApiKey\",\n    getKeyLink: \"https://ai.google.dev/\",\n    docsLink: \"https://ai.google.dev/gemini-api/docs/troubleshooting\",\n  },\n  openrouter: {\n    name: \"OpenRouter\",\n    apiKeyEnvVar: \"OPENROUTER_API_KEY\",\n    apiKeyConfigKey: \"llm.openrouterApiKey\",\n    getKeyLink: \"https://openrouter.ai\",\n    docsLink: \"https://openrouter.ai/docs\",\n  },\n  ollama: {\n    name: \"Ollama\",\n    apiKeyEnvVar: undefined,\n    apiKeyConfigKey: undefined,\n    getKeyLink: \"https://ollama.com/download\",\n    docsLink: \"https://github.com/ollama/ollama/tree/main/docs\",\n  },\n  mistral: {\n    name: \"Mistral\",\n    apiKeyEnvVar: \"MISTRAL_API_KEY\",\n    apiKeyConfigKey: \"llm.mistralApiKey\",\n    getKeyLink: \"https://console.mistral.ai\",\n    docsLink: \"https://docs.mistral.ai\",\n  },\n  \"lingo.dev\": {\n    name: \"Lingo.dev\",\n    apiKeyEnvVar: \"LINGODOTDEV_API_KEY\",\n    apiKeyConfigKey: \"auth.apiKey\",\n    getKeyLink: \"https://lingo.dev\",\n    docsLink: \"https://lingo.dev/docs\",\n  },\n};\n\n/**\n * Format error message when API keys are missing for configured providers\n * @param missingProviders List of providers that are missing API keys\n * @param allProviders Optional: list of all configured providers for context\n */\nexport function formatNoApiKeysError(\n  missingProviders: string[],\n  allProviders?: string[],\n): string {\n  const lines: string[] = [];\n\n  if (missingProviders.length === 0) {\n    // No missing providers (shouldn't happen, but handle it)\n    return \"Translation API keys validated successfully.\";\n  }\n\n  // Header\n  if (allProviders && allProviders.length > missingProviders.length) {\n    lines.push(\n      `Missing API keys for ${missingProviders.length} of ${allProviders.length} configured providers.`,\n    );\n  } else {\n    lines.push(`Missing API keys for configured translation providers.`);\n  }\n\n  // List missing providers with their environment variables and links\n  lines.push(`Missing API keys for:`);\n  for (const providerId of missingProviders) {\n    const details = providerDetails[providerId];\n    if (details) {\n      if (details.apiKeyEnvVar) {\n        lines.push(\n          `   • ${details.name}: ${details.apiKeyEnvVar}  →  ${details.getKeyLink}`,\n        );\n      } else {\n        lines.push(`   • ${details.name}: ${details.getKeyLink}`);\n      }\n    } else {\n      lines.push(`   • ${providerId}: (unknown provider)`);\n    }\n  }\n\n  lines.push(\n    ``,\n    `👉 Set the required API keys:`,\n    `   1. Add to .env file (recommended)`,\n    `   2. Or export in terminal: export API_KEY_NAME=<your-key>`,\n    ``,\n  );\n\n  return lines.join(\"\\n\");\n}\n"],"mappings":";AAYA,MAAaA,kBAAmD;CAC9D,MAAM;EACJ,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,QAAQ;EACN,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,YAAY;EACV,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,QAAQ;EACN,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,SAAS;EACP,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACD,aAAa;EACX,MAAM;EACN,cAAc;EACd,iBAAiB;EACjB,YAAY;EACZ,UAAU;EACX;CACF;;;;;;AAOD,SAAgB,qBACd,kBACA,cACQ;CACR,MAAMC,QAAkB,EAAE;AAE1B,KAAI,iBAAiB,WAAW,EAE9B,QAAO;AAIT,KAAI,gBAAgB,aAAa,SAAS,iBAAiB,OACzD,OAAM,KACJ,wBAAwB,iBAAiB,OAAO,MAAM,aAAa,OAAO,wBAC3E;KAED,OAAM,KAAK,yDAAyD;AAItE,OAAM,KAAK,wBAAwB;AACnC,MAAK,MAAM,cAAc,kBAAkB;EACzC,MAAM,UAAU,gBAAgB;AAChC,MAAI,QACF,KAAI,QAAQ,aACV,OAAM,KACJ,QAAQ,QAAQ,KAAK,IAAI,QAAQ,aAAa,OAAO,QAAQ,aAC9D;MAED,OAAM,KAAK,QAAQ,QAAQ,KAAK,IAAI,QAAQ,aAAa;MAG3D,OAAM,KAAK,QAAQ,WAAW,sBAAsB;;AAIxD,OAAM,KACJ,IACA,iCACA,wCACA,+DACA,GACD;AAED,QAAO,MAAM,KAAK,KAAK"}

package/build/translators/lingo/{service.cjs → translator.cjs}

@@ -8,11 +8,11 @@ const require_timeout = require('../../utils/timeout.cjs');
 let ai = require("ai");
 let lingo_dev_sdk = require("lingo.dev/sdk");
 
-//#region src/translators/lingo/service.ts
+//#region src/translators/lingo/translator.ts
 /**
 * Lingo translator using AI models
 */
-var Service = class {
+var LingoTranslator = class {
 	validatedKeys;
 	constructor(config, logger) {
 		this.config = config;
@@ -25,31 +25,29 @@ var Service = class {
 	* Translate multiple entries
 	*/
 	async translate(locale, entriesMap) {
-		this.logger.debug(`[TRACE-LINGO] translate() called for ${locale} with ${Object.keys(entriesMap).length} entries`);
+		this.logger.debug(`translate() called for ${locale} with ${Object.keys(entriesMap).length} entries`);
 		const sourceDictionary = require_api.dictionaryFrom(this.config.sourceLocale, Object.fromEntries(Object.entries(entriesMap).map(([hash, entry]) => [hash, entry.text])));
-		this.logger.debug(`[TRACE-LINGO] Created source dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
+		this.logger.debug(`Created source dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
 		return (await this.translateDictionary(sourceDictionary, locale)).entries || {};
 	}
 	/**
 	* Translate a complete dictionary
 	*/
 	async translateDictionary(sourceDictionary, targetLocale) {
-		this.logger.debug(`[TRACE-LINGO] Chunking dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
 		const chunks = this.chunkDictionary(sourceDictionary);
-		this.logger.debug(`[TRACE-LINGO] Split into ${chunks.length} chunks`);
+		this.logger.debug(`Split dictionary with ${Object.keys(sourceDictionary.entries).length} into ${chunks.length} chunks`);
 		const translatedChunks = [];
 		for (let i = 0; i < chunks.length; i++) {
 			const chunk = chunks[i];
-			this.logger.debug(`[TRACE-LINGO] Translating chunk ${i + 1}/${chunks.length} with ${Object.keys(chunk.entries).length} entries`);
+			this.logger.debug(`Translating chunk ${i + 1}/${chunks.length} with ${Object.keys(chunk.entries).length} entries`);
 			const chunkStartTime = performance.now();
 			const translatedChunk = await this.translateChunk(chunk, targetLocale);
 			const chunkEndTime = performance.now();
-			this.logger.debug(`[TRACE-LINGO] Chunk ${i + 1}/${chunks.length} completed in ${(chunkEndTime - chunkStartTime).toFixed(2)}ms`);
+			this.logger.debug(`Chunk ${i + 1}/${chunks.length} completed in ${(chunkEndTime - chunkStartTime).toFixed(2)}ms`);
 			translatedChunks.push(translatedChunk);
 		}
-		this.logger.debug(`[TRACE-LINGO] All chunks translated, merging results`);
 		const result = this.mergeDictionaries(translatedChunks);
-		this.logger.debug(`[TRACE-LINGO] Merge completed, final dictionary has ${Object.keys(result.entries).length} entries`);
+		this.logger.debug(`Merge completed, final dictionary has ${Object.keys(result.entries).length} entries`);
 		return result;
 	}
 	/**
@@ -66,7 +64,7 @@ var Service = class {
 	async translateWithLingoDotDev(sourceDictionary, targetLocale) {
 		const apiKey = this.validatedKeys["lingo.dev"];
 		if (!apiKey) throw new Error("Internal error: Lingo.dev API key not found after validation. Please restart the service.");
-		this.logger.info(`Using Lingo.dev Engine to localize from "${this.config.sourceLocale}" to "${targetLocale}"`);
+		this.logger.debug(`Using Lingo.dev Engine to localize from "${this.config.sourceLocale}" to "${targetLocale}"`);
 		const engine = new lingo_dev_sdk.LingoDotDevEngine({ apiKey });
 		try {
 			return await require_timeout.withTimeout(engine.localizeObject(sourceDictionary, {
@@ -85,7 +83,7 @@ var Service = class {
 	async translateWithLLM(sourceDictionary, targetLocale) {
 		const localeModel = require_model_factory.getLocaleModel(this.config.models, this.config.sourceLocale, targetLocale);
 		if (!localeModel) throw new Error(`No model configured for translation from ${this.config.sourceLocale} to ${targetLocale}`);
-		this.logger.info(`Using LLM ("${localeModel.provider}":"${localeModel.name}") to translate from "${this.config.sourceLocale}" to "${targetLocale}"`);
+		this.logger.debug(`Using LLM ("${localeModel.provider}":"${localeModel.name}") to translate from "${this.config.sourceLocale}" to "${targetLocale}"`);
 		const aiModel = require_model_factory.createAiModel(localeModel, this.validatedKeys);
 		try {
 			return require_parse_xml.parseXmlFromResponseText((await require_timeout.withTimeout((0, ai.generateText)({
@@ -149,4 +147,4 @@ var Service = class {
 };
 
 //#endregion
-exports.Service = Service;
+exports.LingoTranslator = LingoTranslator;

package/build/translators/lingo/{service.mjs → translator.mjs}

@@ -7,11 +7,11 @@ import { DEFAULT_TIMEOUTS, withTimeout } from "../../utils/timeout.mjs";
 import { generateText } from "ai";
 import { LingoDotDevEngine } from "lingo.dev/sdk";
 
-//#region src/translators/lingo/service.ts
+//#region src/translators/lingo/translator.ts
 /**
 * Lingo translator using AI models
 */
-var Service = class {
+var LingoTranslator = class {
 	validatedKeys;
 	constructor(config, logger) {
 		this.config = config;
@@ -24,31 +24,29 @@ var Service = class {
 	* Translate multiple entries
 	*/
 	async translate(locale, entriesMap) {
-		this.logger.debug(`[TRACE-LINGO] translate() called for ${locale} with ${Object.keys(entriesMap).length} entries`);
+		this.logger.debug(`translate() called for ${locale} with ${Object.keys(entriesMap).length} entries`);
 		const sourceDictionary = dictionaryFrom(this.config.sourceLocale, Object.fromEntries(Object.entries(entriesMap).map(([hash, entry]) => [hash, entry.text])));
-		this.logger.debug(`[TRACE-LINGO] Created source dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
+		this.logger.debug(`Created source dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
 		return (await this.translateDictionary(sourceDictionary, locale)).entries || {};
 	}
 	/**
 	* Translate a complete dictionary
 	*/
 	async translateDictionary(sourceDictionary, targetLocale) {
-		this.logger.debug(`[TRACE-LINGO] Chunking dictionary with ${Object.keys(sourceDictionary.entries).length} entries`);
 		const chunks = this.chunkDictionary(sourceDictionary);
-		this.logger.debug(`[TRACE-LINGO] Split into ${chunks.length} chunks`);
+		this.logger.debug(`Split dictionary with ${Object.keys(sourceDictionary.entries).length} into ${chunks.length} chunks`);
 		const translatedChunks = [];
 		for (let i = 0; i < chunks.length; i++) {
 			const chunk = chunks[i];
-			this.logger.debug(`[TRACE-LINGO] Translating chunk ${i + 1}/${chunks.length} with ${Object.keys(chunk.entries).length} entries`);
+			this.logger.debug(`Translating chunk ${i + 1}/${chunks.length} with ${Object.keys(chunk.entries).length} entries`);
 			const chunkStartTime = performance.now();
 			const translatedChunk = await this.translateChunk(chunk, targetLocale);
 			const chunkEndTime = performance.now();
-			this.logger.debug(`[TRACE-LINGO] Chunk ${i + 1}/${chunks.length} completed in ${(chunkEndTime - chunkStartTime).toFixed(2)}ms`);
+			this.logger.debug(`Chunk ${i + 1}/${chunks.length} completed in ${(chunkEndTime - chunkStartTime).toFixed(2)}ms`);
 			translatedChunks.push(translatedChunk);
 		}
-		this.logger.debug(`[TRACE-LINGO] All chunks translated, merging results`);
 		const result = this.mergeDictionaries(translatedChunks);
-		this.logger.debug(`[TRACE-LINGO] Merge completed, final dictionary has ${Object.keys(result.entries).length} entries`);
+		this.logger.debug(`Merge completed, final dictionary has ${Object.keys(result.entries).length} entries`);
 		return result;
 	}
 	/**
@@ -65,7 +63,7 @@ var Service = class {
 	async translateWithLingoDotDev(sourceDictionary, targetLocale) {
 		const apiKey = this.validatedKeys["lingo.dev"];
 		if (!apiKey) throw new Error("Internal error: Lingo.dev API key not found after validation. Please restart the service.");
-		this.logger.info(`Using Lingo.dev Engine to localize from "${this.config.sourceLocale}" to "${targetLocale}"`);
+		this.logger.debug(`Using Lingo.dev Engine to localize from "${this.config.sourceLocale}" to "${targetLocale}"`);
 		const engine = new LingoDotDevEngine({ apiKey });
 		try {
 			return await withTimeout(engine.localizeObject(sourceDictionary, {
@@ -84,7 +82,7 @@ var Service = class {
 	async translateWithLLM(sourceDictionary, targetLocale) {
 		const localeModel = getLocaleModel(this.config.models, this.config.sourceLocale, targetLocale);
 		if (!localeModel) throw new Error(`No model configured for translation from ${this.config.sourceLocale} to ${targetLocale}`);
-		this.logger.info(`Using LLM ("${localeModel.provider}":"${localeModel.name}") to translate from "${this.config.sourceLocale}" to "${targetLocale}"`);
+		this.logger.debug(`Using LLM ("${localeModel.provider}":"${localeModel.name}") to translate from "${this.config.sourceLocale}" to "${targetLocale}"`);
 		const aiModel = createAiModel(localeModel, this.validatedKeys);
 		try {
 			return parseXmlFromResponseText((await withTimeout(generateText({
@@ -148,5 +146,5 @@ var Service = class {
 };
 
 //#endregion
-export { Service };
-//# sourceMappingURL=service.mjs.map
+export { LingoTranslator };
+//# sourceMappingURL=translator.mjs.map

package/build/translators/lingo/translator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"translator.mjs","names":["config: LingoTranslatorConfig","logger: Logger","sourceDictionary: DictionarySchema","translatedChunks: DictionarySchema[]","chunks: DictionarySchema[]","mergedEntries: Record<string, string>"],"sources":["../../../src/translators/lingo/translator.ts"],"sourcesContent":["import { generateText } from \"ai\";\nimport { LingoDotDevEngine } from \"lingo.dev/sdk\";\nimport { dictionaryFrom, type DictionarySchema, type TranslatableEntry, type Translator, } from \"../api\";\nimport { getSystemPrompt } from \"./prompt\";\nimport { obj2xml, parseXmlFromResponseText } from \"../parse-xml\";\nimport { shots } from \"./shots\";\nimport { createAiModel, getLocaleModel, validateAndGetApiKeys, type ValidatedApiKeys, } from \"./model-factory\";\nimport { Logger } from \"../../utils/logger\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../../utils/timeout\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Lingo Translator configuration\n */\nexport interface LingoTranslatorConfig {\n  models: \"lingo.dev\" | Record<string, string>;\n  sourceLocale: LocaleCode;\n  prompt?: string;\n}\n\n/**\n * Lingo translator using AI models\n */\nexport class LingoTranslator implements Translator<LingoTranslatorConfig> {\n  private readonly validatedKeys: ValidatedApiKeys;\n\n  constructor(\n    readonly config: LingoTranslatorConfig,\n    private logger: Logger,\n  ) {\n    this.logger.info(\"Validating API keys for translation...\");\n    this.validatedKeys = validateAndGetApiKeys(config.models);\n    this.logger.info(\"✅ API keys validated successfully\");\n  }\n\n  /**\n   * Translate multiple entries\n   */\n  async translate(\n    locale: LocaleCode,\n    entriesMap: Record<string, TranslatableEntry>,\n  ): Promise<Record<string, string>> {\n    this.logger.debug(\n      `translate() called for ${locale} with ${Object.keys(entriesMap).length} entries`,\n    );\n\n    const sourceDictionary: DictionarySchema = dictionaryFrom(\n      this.config.sourceLocale,\n      Object.fromEntries(\n        Object.entries(entriesMap).map(([hash, entry]) => [hash, entry.text]),\n      ),\n    );\n\n    this.logger.debug(\n      `Created source dictionary with ${Object.keys(sourceDictionary.entries).length} entries`,\n    );\n    const translated = await this.translateDictionary(sourceDictionary, locale);\n\n    return translated.entries || {};\n  }\n\n  /**\n   * Translate a complete dictionary\n   */\n  private async translateDictionary(\n    sourceDictionary: DictionarySchema,\n    targetLocale: string,\n  ): Promise<DictionarySchema> {\n    const chunks = this.chunkDictionary(sourceDictionary);\n    this.logger.debug(\n      `Split dictionary with ${Object.keys(sourceDictionary.entries).length} into ${chunks.length} chunks`,\n    );\n\n    const translatedChunks: DictionarySchema[] = [];\n\n    for (let i = 0; i < chunks.length; i++) {\n      const chunk = chunks[i];\n      this.logger.debug(\n        `Translating chunk ${i + 1}/${chunks.length} with ${Object.keys(chunk.entries).length} entries`,\n      );\n      const chunkStartTime = performance.now();\n\n      const translatedChunk = await this.translateChunk(chunk, targetLocale);\n\n      const chunkEndTime = performance.now();\n      this.logger.debug(\n        `Chunk ${i + 1}/${chunks.length} completed in ${(chunkEndTime - chunkStartTime).toFixed(2)}ms`,\n      );\n\n      translatedChunks.push(translatedChunk);\n    }\n\n    const result = this.mergeDictionaries(translatedChunks);\n    this.logger.debug(\n      `Merge completed, final dictionary has ${Object.keys(result.entries).length} entries`,\n    );\n\n    return result;\n  }\n\n  /**\n   * Translate a single chunk\n   */\n  private async translateChunk(\n    sourceDictionary: DictionarySchema,\n    targetLocale: string,\n  ): Promise<DictionarySchema> {\n    if (this.config.models === \"lingo.dev\") {\n      return this.translateWithLingoDotDev(sourceDictionary, targetLocale);\n    } else {\n      return this.translateWithLLM(sourceDictionary, targetLocale);\n    }\n  }\n\n  /**\n   * Translate using Lingo.dev Engine\n   * Times out after 60 seconds to prevent indefinite hangs\n   */\n  private async translateWithLingoDotDev(\n    sourceDictionary: DictionarySchema,\n    targetLocale: string,\n  ): Promise<DictionarySchema> {\n    const apiKey = this.validatedKeys[\"lingo.dev\"];\n    if (!apiKey) {\n      throw new Error(\n        \"Internal error: Lingo.dev API key not found after validation. Please restart the service.\",\n      );\n    }\n\n    this.logger.debug(\n      `Using Lingo.dev Engine to localize from \"${this.config.sourceLocale}\" to \"${targetLocale}\"`,\n    );\n\n    const engine = new LingoDotDevEngine({ apiKey });\n\n    try {\n      const result = await withTimeout(\n        engine.localizeObject(sourceDictionary, {\n          sourceLocale: this.config.sourceLocale,\n          targetLocale: targetLocale,\n        }),\n        DEFAULT_TIMEOUTS.AI_API,\n        `Lingo.dev API translation to ${targetLocale}`,\n      );\n\n      return result as DictionarySchema;\n    } catch (error) {\n      this.logger.error(`translateWithLingoDotDev() failed:`, error);\n      throw new Error(\n        `Lingo.dev translation failed: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Translate using generic LLM\n   * Times out after 60 seconds to prevent indefinite hangs\n   */\n  private async translateWithLLM(\n    sourceDictionary: DictionarySchema,\n    targetLocale: string,\n  ): Promise<DictionarySchema> {\n    const localeModel = getLocaleModel(\n      this.config.models as Record<string, string>,\n      this.config.sourceLocale,\n      targetLocale,\n    );\n\n    if (!localeModel) {\n      throw new Error(\n        `No model configured for translation from ${this.config.sourceLocale} to ${targetLocale}`,\n      );\n    }\n\n    this.logger.debug(\n      `Using LLM (\"${localeModel.provider}\":\"${localeModel.name}\") to translate from \"${this.config.sourceLocale}\" to \"${targetLocale}\"`,\n    );\n\n    const aiModel = createAiModel(localeModel, this.validatedKeys);\n\n    try {\n      const response = await withTimeout(\n        generateText({\n          model: aiModel,\n          messages: [\n            {\n              role: \"system\",\n              content: getSystemPrompt({\n                sourceLocale: this.config.sourceLocale,\n                targetLocale,\n                prompt: this.config.prompt,\n              }),\n            },\n            // Add few-shot examples\n            ...shots.flatMap((shotsTuple) => [\n              {\n                role: \"user\" as const,\n                content: obj2xml(shotsTuple[0]),\n              },\n              {\n                role: \"assistant\" as const,\n                content: obj2xml(shotsTuple[1]),\n              },\n            ]),\n            {\n              role: \"user\",\n              content: obj2xml(sourceDictionary),\n            },\n          ],\n        }),\n        DEFAULT_TIMEOUTS.AI_API,\n        `${localeModel.provider} LLM translation to ${targetLocale}`,\n      );\n\n      return parseXmlFromResponseText<DictionarySchema>(response.text);\n    } catch (error) {\n      throw new Error(\n        `LLM translation failed with ${localeModel.provider}: ${error instanceof Error ? error.message : \"Unknown error\"}`,\n      );\n    }\n  }\n\n  /**\n   * Split dictionary into chunks for processing\n   */\n  private chunkDictionary(dictionary: DictionarySchema): DictionarySchema[] {\n    const MAX_ENTRIES_PER_CHUNK = 100;\n    const { entries, ...rest } = dictionary;\n    const chunks: DictionarySchema[] = [];\n\n    const entryPairs = Object.entries(entries);\n\n    // Split entries into chunks of MAX_ENTRIES_PER_CHUNK\n    for (let i = 0; i < entryPairs.length; i += MAX_ENTRIES_PER_CHUNK) {\n      const chunkEntries = entryPairs.slice(i, i + MAX_ENTRIES_PER_CHUNK);\n      chunks.push({\n        ...rest,\n        entries: Object.fromEntries(chunkEntries),\n      });\n    }\n\n    return chunks;\n  }\n\n  /**\n   * Merge multiple dictionaries into one\n   */\n  private mergeDictionaries(\n    dictionaries: DictionarySchema[],\n  ): DictionarySchema {\n    if (dictionaries.length === 0) {\n      return dictionaryFrom(this.config.sourceLocale, {});\n    }\n\n    // Merge all entries from all dictionaries\n    const mergedEntries: Record<string, string> = {};\n    for (const dict of dictionaries) {\n      Object.assign(mergedEntries, dict.entries);\n    }\n\n    return {\n      version: dictionaries[0].version,\n      locale: dictionaries[0].locale,\n      entries: mergedEntries,\n    };\n  }\n}\n"],"mappings":"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"}

package/build/translators/local-cache.mjs

@@ -1,6 +1,6 @@
 import { dictionaryFrom } from "./api.mjs";
 import { DEFAULT_TIMEOUTS, withTimeout } from "../utils/timeout.mjs";
-import * as fs from "fs/promises";
+import * as fs$1 from "fs/promises";
 import * as path$1 from "path";
 
 //#region src/translators/local-cache.ts
@@ -27,7 +27,7 @@ var LocalTranslationCache = class {
 	async getDictionary(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			const content = await withTimeout(fs.readFile(cachePath, "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Read cache for ${locale}`);
+			const content = await withTimeout(fs$1.readFile(cachePath, "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Read cache for ${locale}`);
 			return JSON.parse(content);
 		} catch {
 			return null;
@@ -41,8 +41,8 @@ var LocalTranslationCache = class {
 		try {
 			const cachePath = this.getCachePath(locale);
 			const cacheDir = path$1.dirname(cachePath);
-			await withTimeout(fs.mkdir(cacheDir, { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, `Create cache directory for ${locale}`);
-			await withTimeout(fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Write cache for ${locale}`);
+			await withTimeout(fs$1.mkdir(cacheDir, { recursive: true }), DEFAULT_TIMEOUTS.FILE_IO, `Create cache directory for ${locale}`);
+			await withTimeout(fs$1.writeFile(cachePath, JSON.stringify(dictionary, null, 2), "utf-8"), DEFAULT_TIMEOUTS.FILE_IO, `Write cache for ${locale}`);
 		} catch (error) {
 			this.logger.error(`Failed to write cache for locale ${locale}:`, error);
 			throw error;
@@ -82,7 +82,7 @@ var LocalTranslationCache = class {
 	async has(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			await fs.access(cachePath);
+			await fs$1.access(cachePath);
 			return true;
 		} catch {
 			return false;
@@ -94,7 +94,7 @@ var LocalTranslationCache = class {
 	async clear(locale) {
 		try {
 			const cachePath = this.getCachePath(locale);
-			await fs.unlink(cachePath);
+			await fs$1.unlink(cachePath);
 		} catch {}
 	}
 	/**
@@ -102,8 +102,8 @@ var LocalTranslationCache = class {
 	*/
 	async clearAll() {
 		try {
-			const files = await fs.readdir(this.config.cacheDir);
-			await Promise.all(files.filter((file) => file.endsWith(".json")).map((file) => fs.unlink(path$1.join(this.config.cacheDir, file))));
+			const files = await fs$1.readdir(this.config.cacheDir);
+			await Promise.all(files.filter((file) => file.endsWith(".json")).map((file) => fs$1.unlink(path$1.join(this.config.cacheDir, file))));
 		} catch {}
 	}
 };

package/build/translators/local-cache.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"local-cache.mjs","names":["logger: Logger","path"],"sources":["../../src/translators/local-cache.ts"],"sourcesContent":["/**\n * Local disk-based translation cache implementation\n */\n\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport type { LocalCacheConfig, TranslationCache } from \"./cache\";\nimport { dictionaryFrom, type DictionarySchema } from \"./api\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Local file system cache for translations\n * Stores translations as JSON files in .lingo/cache/\n */\nexport class LocalTranslationCache implements TranslationCache {\n  private config: LocalCacheConfig;\n\n  constructor(\n    config: LocalCacheConfig,\n    private logger: Logger,\n  ) {\n    this.config = config;\n  }\n\n  private getCachePath(locale: LocaleCode): string {\n    return path.join(this.config.cacheDir, `${locale}.json`);\n  }\n\n  /**\n   * Read dictionary file from disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  async getDictionary(locale: LocaleCode): Promise<DictionarySchema | null> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const content = await withTimeout(\n        fs.readFile(cachePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Read cache for ${locale}`,\n      );\n      return JSON.parse(content);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Write dictionary file to disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  private async setDictionary(\n    locale: LocaleCode,\n    dictionary: DictionarySchema,\n  ): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const cacheDir = path.dirname(cachePath);\n\n      // Ensure cache directory exists\n      await withTimeout(\n        fs.mkdir(cacheDir, { recursive: true }),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Create cache directory for ${locale}`,\n      );\n\n      // Write cache file\n      await withTimeout(\n        fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Write cache for ${locale}`,\n      );\n    } catch (error) {\n      this.logger.error(`Failed to write cache for locale ${locale}:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get cached translations for a locale\n   */\n  async get(\n    locale: LocaleCode,\n    hashes?: string[],\n  ): Promise<Record<string, string>> {\n    const dictionary = await this.getDictionary(locale);\n    if (!dictionary) {\n      return {};\n    }\n    if (hashes) {\n      return hashes.reduce(\n        (acc, hash) => ({ ...acc, [hash]: dictionary.entries[hash] }),\n        {},\n      );\n    }\n    return dictionary.entries || {};\n  }\n\n  /**\n   * Update cache with new translations (merge)\n   */\n  async update(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    const existing = await this.get(locale);\n\n    const merged = { ...existing, ...translations };\n\n    await this.set(locale, merged);\n  }\n\n  /**\n   * Replace entire cache for a locale\n   */\n  async set(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    await this.setDictionary(locale, dictionaryFrom(locale, translations));\n  }\n\n  /**\n   * Check if cache exists for a locale\n   */\n  async has(locale: LocaleCode): Promise<boolean> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.access(cachePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Clear cache for a specific locale\n   */\n  async clear(locale: LocaleCode): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.unlink(cachePath);\n    } catch {\n      // Ignore errors if file doesn't exist\n    }\n  }\n\n  /**\n   * Clear all cached translations\n   */\n  async clearAll(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDir);\n\n      await Promise.all(\n        files\n          .filter((file) => file.endsWith(\".json\"))\n          .map((file) => fs.unlink(path.join(this.config.cacheDir, file))),\n      );\n    } catch {\n      // Ignore errors if directory doesn't exist\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,wBAAb,MAA+D;CAC7D,AAAQ;CAER,YACE,QACA,AAAQA,QACR;EADQ;AAER,OAAK,SAAS;;CAGhB,AAAQ,aAAa,QAA4B;AAC/C,SAAOC,OAAK,KAAK,KAAK,OAAO,UAAU,GAAG,OAAO,OAAO;;;;;;CAO1D,MAAM,cAAc,QAAsD;AACxE,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,UAAU,MAAM,YACpB,GAAG,SAAS,WAAW,QAAQ,EAC/B,iBAAiB,SACjB,kBAAkB,SACnB;AACD,UAAO,KAAK,MAAM,QAAQ;UACpB;AACN,UAAO;;;;;;;CAQX,MAAc,cACZ,QACA,YACe;AACf,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,WAAWA,OAAK,QAAQ,UAAU;AAGxC,SAAM,YACJ,GAAG,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC,EACvC,iBAAiB,SACjB,8BAA8B,SAC/B;AAGD,SAAM,YACJ,GAAG,UAAU,WAAW,KAAK,UAAU,YAAY,MAAM,EAAE,EAAE,QAAQ,EACrE,iBAAiB,SACjB,mBAAmB,SACpB;WACM,OAAO;AACd,QAAK,OAAO,MAAM,oCAAoC,OAAO,IAAI,MAAM;AACvE,SAAM;;;;;;CAOV,MAAM,IACJ,QACA,QACiC;EACjC,MAAM,aAAa,MAAM,KAAK,cAAc,OAAO;AACnD,MAAI,CAAC,WACH,QAAO,EAAE;AAEX,MAAI,OACF,QAAO,OAAO,QACX,KAAK,UAAU;GAAE,GAAG;IAAM,OAAO,WAAW,QAAQ;GAAO,GAC5D,EAAE,CACH;AAEH,SAAO,WAAW,WAAW,EAAE;;;;;CAMjC,MAAM,OACJ,QACA,cACe;EAGf,MAAM,SAAS;GAAE,GAFA,MAAM,KAAK,IAAI,OAAO;GAET,GAAG;GAAc;AAE/C,QAAM,KAAK,IAAI,QAAQ,OAAO;;;;;CAMhC,MAAM,IACJ,QACA,cACe;AACf,QAAM,KAAK,cAAc,QAAQ,eAAe,QAAQ,aAAa,CAAC;;;;;CAMxE,MAAM,IAAI,QAAsC;AAC9C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAM,GAAG,OAAO,UAAU;AAC1B,UAAO;UACD;AACN,UAAO;;;;;;CAOX,MAAM,MAAM,QAAmC;AAC7C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAM,GAAG,OAAO,UAAU;UACpB;;;;;CAQV,MAAM,WAA0B;AAC9B,MAAI;GACF,MAAM,QAAQ,MAAM,GAAG,QAAQ,KAAK,OAAO,SAAS;AAEpD,SAAM,QAAQ,IACZ,MACG,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CACxC,KAAK,SAAS,GAAG,OAAOA,OAAK,KAAK,KAAK,OAAO,UAAU,KAAK,CAAC,CAAC,CACnE;UACK"}
+{"version":3,"file":"local-cache.mjs","names":["logger: Logger","path","fs"],"sources":["../../src/translators/local-cache.ts"],"sourcesContent":["/**\n * Local disk-based translation cache implementation\n */\n\nimport * as fs from \"fs/promises\";\nimport * as path from \"path\";\nimport type { LocalCacheConfig, TranslationCache } from \"./cache\";\nimport { dictionaryFrom, type DictionarySchema } from \"./api\";\nimport { DEFAULT_TIMEOUTS, withTimeout } from \"../utils/timeout\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Local file system cache for translations\n * Stores translations as JSON files in .lingo/cache/\n */\nexport class LocalTranslationCache implements TranslationCache {\n  private config: LocalCacheConfig;\n\n  constructor(\n    config: LocalCacheConfig,\n    private logger: Logger,\n  ) {\n    this.config = config;\n  }\n\n  private getCachePath(locale: LocaleCode): string {\n    return path.join(this.config.cacheDir, `${locale}.json`);\n  }\n\n  /**\n   * Read dictionary file from disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  async getDictionary(locale: LocaleCode): Promise<DictionarySchema | null> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const content = await withTimeout(\n        fs.readFile(cachePath, \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Read cache for ${locale}`,\n      );\n      return JSON.parse(content);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Write dictionary file to disk\n   * Times out after 10 seconds to prevent indefinite hangs\n   */\n  private async setDictionary(\n    locale: LocaleCode,\n    dictionary: DictionarySchema,\n  ): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      const cacheDir = path.dirname(cachePath);\n\n      // Ensure cache directory exists\n      await withTimeout(\n        fs.mkdir(cacheDir, { recursive: true }),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Create cache directory for ${locale}`,\n      );\n\n      // Write cache file\n      await withTimeout(\n        fs.writeFile(cachePath, JSON.stringify(dictionary, null, 2), \"utf-8\"),\n        DEFAULT_TIMEOUTS.FILE_IO,\n        `Write cache for ${locale}`,\n      );\n    } catch (error) {\n      this.logger.error(`Failed to write cache for locale ${locale}:`, error);\n      throw error;\n    }\n  }\n\n  /**\n   * Get cached translations for a locale\n   */\n  async get(\n    locale: LocaleCode,\n    hashes?: string[],\n  ): Promise<Record<string, string>> {\n    const dictionary = await this.getDictionary(locale);\n    if (!dictionary) {\n      return {};\n    }\n    if (hashes) {\n      return hashes.reduce(\n        (acc, hash) => ({ ...acc, [hash]: dictionary.entries[hash] }),\n        {},\n      );\n    }\n    return dictionary.entries || {};\n  }\n\n  /**\n   * Update cache with new translations (merge)\n   */\n  async update(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    const existing = await this.get(locale);\n\n    const merged = { ...existing, ...translations };\n\n    await this.set(locale, merged);\n  }\n\n  /**\n   * Replace entire cache for a locale\n   */\n  async set(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    await this.setDictionary(locale, dictionaryFrom(locale, translations));\n  }\n\n  /**\n   * Check if cache exists for a locale\n   */\n  async has(locale: LocaleCode): Promise<boolean> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.access(cachePath);\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Clear cache for a specific locale\n   */\n  async clear(locale: LocaleCode): Promise<void> {\n    try {\n      const cachePath = this.getCachePath(locale);\n      await fs.unlink(cachePath);\n    } catch {\n      // Ignore errors if file doesn't exist\n    }\n  }\n\n  /**\n   * Clear all cached translations\n   */\n  async clearAll(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.config.cacheDir);\n\n      await Promise.all(\n        files\n          .filter((file) => file.endsWith(\".json\"))\n          .map((file) => fs.unlink(path.join(this.config.cacheDir, file))),\n      );\n    } catch {\n      // Ignore errors if directory doesn't exist\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAgBA,IAAa,wBAAb,MAA+D;CAC7D,AAAQ;CAER,YACE,QACA,AAAQA,QACR;EADQ;AAER,OAAK,SAAS;;CAGhB,AAAQ,aAAa,QAA4B;AAC/C,SAAOC,OAAK,KAAK,KAAK,OAAO,UAAU,GAAG,OAAO,OAAO;;;;;;CAO1D,MAAM,cAAc,QAAsD;AACxE,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,UAAU,MAAM,YACpBC,KAAG,SAAS,WAAW,QAAQ,EAC/B,iBAAiB,SACjB,kBAAkB,SACnB;AACD,UAAO,KAAK,MAAM,QAAQ;UACpB;AACN,UAAO;;;;;;;CAQX,MAAc,cACZ,QACA,YACe;AACf,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;GAC3C,MAAM,WAAWD,OAAK,QAAQ,UAAU;AAGxC,SAAM,YACJC,KAAG,MAAM,UAAU,EAAE,WAAW,MAAM,CAAC,EACvC,iBAAiB,SACjB,8BAA8B,SAC/B;AAGD,SAAM,YACJA,KAAG,UAAU,WAAW,KAAK,UAAU,YAAY,MAAM,EAAE,EAAE,QAAQ,EACrE,iBAAiB,SACjB,mBAAmB,SACpB;WACM,OAAO;AACd,QAAK,OAAO,MAAM,oCAAoC,OAAO,IAAI,MAAM;AACvE,SAAM;;;;;;CAOV,MAAM,IACJ,QACA,QACiC;EACjC,MAAM,aAAa,MAAM,KAAK,cAAc,OAAO;AACnD,MAAI,CAAC,WACH,QAAO,EAAE;AAEX,MAAI,OACF,QAAO,OAAO,QACX,KAAK,UAAU;GAAE,GAAG;IAAM,OAAO,WAAW,QAAQ;GAAO,GAC5D,EAAE,CACH;AAEH,SAAO,WAAW,WAAW,EAAE;;;;;CAMjC,MAAM,OACJ,QACA,cACe;EAGf,MAAM,SAAS;GAAE,GAFA,MAAM,KAAK,IAAI,OAAO;GAET,GAAG;GAAc;AAE/C,QAAM,KAAK,IAAI,QAAQ,OAAO;;;;;CAMhC,MAAM,IACJ,QACA,cACe;AACf,QAAM,KAAK,cAAc,QAAQ,eAAe,QAAQ,aAAa,CAAC;;;;;CAMxE,MAAM,IAAI,QAAsC;AAC9C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAMA,KAAG,OAAO,UAAU;AAC1B,UAAO;UACD;AACN,UAAO;;;;;;CAOX,MAAM,MAAM,QAAmC;AAC7C,MAAI;GACF,MAAM,YAAY,KAAK,aAAa,OAAO;AAC3C,SAAMA,KAAG,OAAO,UAAU;UACpB;;;;;CAQV,MAAM,WAA0B;AAC9B,MAAI;GACF,MAAM,QAAQ,MAAMA,KAAG,QAAQ,KAAK,OAAO,SAAS;AAEpD,SAAM,QAAQ,IACZ,MACG,QAAQ,SAAS,KAAK,SAAS,QAAQ,CAAC,CACxC,KAAK,SAASA,KAAG,OAAOD,OAAK,KAAK,KAAK,OAAO,UAAU,KAAK,CAAC,CAAC,CACnE;UACK"}

package/build/translators/memory-cache.cjs

@@ -0,0 +1,47 @@
+
+//#region src/translators/memory-cache.ts
+/**
+* In memory translation cache implementation
+*/
+var MemoryTranslationCache = class {
+	cache = /* @__PURE__ */ new Map();
+	constructor() {}
+	async get(locale, hashes) {
+		const localeCache = this.cache.get(locale);
+		if (!localeCache) return {};
+		if (hashes) return hashes.reduce((acc, hash) => ({
+			...acc,
+			[hash]: localeCache.get(hash)
+		}), {});
+		return Object.fromEntries(localeCache);
+	}
+	/**
+	* Update cache with new translations (merge)
+	*/
+	async update(locale, translations) {
+		let localeCache = this.cache.get(locale);
+		if (!localeCache) {
+			localeCache = /* @__PURE__ */ new Map();
+			this.cache.set(locale, localeCache);
+		}
+		for (const [key, value] of Object.entries(translations)) localeCache.set(key, value);
+	}
+	/**
+	* Replace entire cache for a locale
+	*/
+	async set(locale, translations) {
+		this.cache.set(locale, new Map(Object.entries(translations)));
+	}
+	async has(locale) {
+		return this.cache.has(locale);
+	}
+	async clear(locale) {
+		this.cache.delete(locale);
+	}
+	async clearAll() {
+		this.cache.clear();
+	}
+};
+
+//#endregion
+exports.MemoryTranslationCache = MemoryTranslationCache;

package/build/translators/memory-cache.mjs

@@ -0,0 +1,47 @@
+//#region src/translators/memory-cache.ts
+/**
+* In memory translation cache implementation
+*/
+var MemoryTranslationCache = class {
+	cache = /* @__PURE__ */ new Map();
+	constructor() {}
+	async get(locale, hashes) {
+		const localeCache = this.cache.get(locale);
+		if (!localeCache) return {};
+		if (hashes) return hashes.reduce((acc, hash) => ({
+			...acc,
+			[hash]: localeCache.get(hash)
+		}), {});
+		return Object.fromEntries(localeCache);
+	}
+	/**
+	* Update cache with new translations (merge)
+	*/
+	async update(locale, translations) {
+		let localeCache = this.cache.get(locale);
+		if (!localeCache) {
+			localeCache = /* @__PURE__ */ new Map();
+			this.cache.set(locale, localeCache);
+		}
+		for (const [key, value] of Object.entries(translations)) localeCache.set(key, value);
+	}
+	/**
+	* Replace entire cache for a locale
+	*/
+	async set(locale, translations) {
+		this.cache.set(locale, new Map(Object.entries(translations)));
+	}
+	async has(locale) {
+		return this.cache.has(locale);
+	}
+	async clear(locale) {
+		this.cache.delete(locale);
+	}
+	async clearAll() {
+		this.cache.clear();
+	}
+};
+
+//#endregion
+export { MemoryTranslationCache };
+//# sourceMappingURL=memory-cache.mjs.map

package/build/translators/memory-cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cache.mjs","names":[],"sources":["../../src/translators/memory-cache.ts"],"sourcesContent":["import type { TranslationCache } from \"./cache\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * In memory translation cache implementation\n */\nexport class MemoryTranslationCache implements TranslationCache {\n  private cache: Map<LocaleCode, Map<string, string>> = new Map();\n\n  constructor() {}\n\n  async get(\n    locale: LocaleCode,\n    hashes?: string[],\n  ): Promise<Record<string, string>> {\n    const localeCache = this.cache.get(locale);\n    if (!localeCache) {\n      return {};\n    }\n    if (hashes) {\n      return hashes.reduce(\n        (acc, hash) => ({ ...acc, [hash]: localeCache.get(hash) }),\n        {},\n      );\n    }\n    return Object.fromEntries(localeCache);\n  }\n\n  /**\n   * Update cache with new translations (merge)\n   */\n  async update(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    let localeCache = this.cache.get(locale);\n    if (!localeCache) {\n      localeCache = new Map();\n      this.cache.set(locale, localeCache);\n    }\n    for (const [key, value] of Object.entries(translations)) {\n      localeCache.set(key, value);\n    }\n  }\n\n  /**\n   * Replace entire cache for a locale\n   */\n  async set(\n    locale: LocaleCode,\n    translations: Record<string, string>,\n  ): Promise<void> {\n    this.cache.set(locale, new Map(Object.entries(translations)));\n  }\n\n  async has(locale: LocaleCode): Promise<boolean> {\n    return this.cache.has(locale);\n  }\n\n  async clear(locale: LocaleCode): Promise<void> {\n    this.cache.delete(locale);\n  }\n\n  async clearAll(): Promise<void> {\n    this.cache.clear();\n  }\n}\n"],"mappings":";;;;AAMA,IAAa,yBAAb,MAAgE;CAC9D,AAAQ,wBAA8C,IAAI,KAAK;CAE/D,cAAc;CAEd,MAAM,IACJ,QACA,QACiC;EACjC,MAAM,cAAc,KAAK,MAAM,IAAI,OAAO;AAC1C,MAAI,CAAC,YACH,QAAO,EAAE;AAEX,MAAI,OACF,QAAO,OAAO,QACX,KAAK,UAAU;GAAE,GAAG;IAAM,OAAO,YAAY,IAAI,KAAK;GAAE,GACzD,EAAE,CACH;AAEH,SAAO,OAAO,YAAY,YAAY;;;;;CAMxC,MAAM,OACJ,QACA,cACe;EACf,IAAI,cAAc,KAAK,MAAM,IAAI,OAAO;AACxC,MAAI,CAAC,aAAa;AAChB,iCAAc,IAAI,KAAK;AACvB,QAAK,MAAM,IAAI,QAAQ,YAAY;;AAErC,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,aAAa,CACrD,aAAY,IAAI,KAAK,MAAM;;;;;CAO/B,MAAM,IACJ,QACA,cACe;AACf,OAAK,MAAM,IAAI,QAAQ,IAAI,IAAI,OAAO,QAAQ,aAAa,CAAC,CAAC;;CAG/D,MAAM,IAAI,QAAsC;AAC9C,SAAO,KAAK,MAAM,IAAI,OAAO;;CAG/B,MAAM,MAAM,QAAmC;AAC7C,OAAK,MAAM,OAAO,OAAO;;CAG3B,MAAM,WAA0B;AAC9B,OAAK,MAAM,OAAO"}

package/build/translators/pluralization/service.cjs

@@ -14,23 +14,17 @@ let ai = require("ai");
 */
 var PluralizationService = class {
 	languageModel;
-	modelName;
 	cache = /* @__PURE__ */ new Map();
 	prompt;
 	sourceLocale;
 	constructor(config, logger) {
 		this.logger = logger;
 		const localeModel = require_model_factory.parseModelString(config.model);
-		if (!localeModel) throw new Error(`Invalid model format: "${config.model}"`);
-		const modelsConfig = { "*:*": config.model };
-		this.logger.info("Validating API keys for pluralization...");
-		const validatedKeys = require_model_factory.validateAndGetApiKeys(modelsConfig);
-		this.logger.info("✅ API keys validated for pluralization");
-		this.languageModel = require_model_factory.createAiModel(localeModel, validatedKeys);
-		this.modelName = `${localeModel.provider}:${localeModel.name}`;
+		if (!localeModel) throw new Error(`Invalid model format in pluralization service: "${config.model}"`);
+		this.languageModel = require_model_factory.createAiModel(localeModel, require_model_factory.validateAndGetApiKeys({ "*:*": config.model }));
 		this.sourceLocale = config.sourceLocale;
 		this.prompt = require_prompt.getSystemPrompt({ sourceLocale: config.sourceLocale });
-		this.logger.info(`Initialized pluralization service with ${this.modelName}`);
+		this.logger.debug(`Initialized pluralization service with ${localeModel.provider}:${localeModel.name}`);
 	}
 	/**
 	* Generate ICU formats for multiple candidates in a single batch
@@ -40,23 +34,20 @@ var PluralizationService = class {
 	* @returns Map of hash -> ICU generation result
 	*/
 	async generateBatch(candidates, batchSize = 10) {
-		const results = /* @__PURE__ */ new Map();
-		const uncachedCandidates = candidates.filter((c) => {
+		const { uncachedCandidates, results } = candidates.reduce((acc, c) => {
 			const cached = this.cache.get(c.hash);
-			if (cached) {
-				results.set(c.hash, cached);
-				return false;
-			}
-			return true;
+			if (cached) acc.results.set(c.hash, cached);
+			else acc.uncachedCandidates.push(c);
+			return acc;
+		}, {
+			uncachedCandidates: [],
+			results: /* @__PURE__ */ new Map()
 		});
-		if (uncachedCandidates.length === 0) {
-			this.logger.debug(`All ${candidates.length} candidates found in cache, skipping LLM call`);
-			return results;
-		}
-		this.logger.info(`Processing ${uncachedCandidates.length} candidates (${candidates.length - uncachedCandidates.length} cached)`);
+		if (uncachedCandidates.length === 0) return results;
+		this.logger.debug(`Processing ${uncachedCandidates.length} candidates (${candidates.length - uncachedCandidates.length} cached)`);
 		for (let i = 0; i < uncachedCandidates.length; i += batchSize) {
 			const batch = uncachedCandidates.slice(i, i + batchSize);
-			this.logger.info(`Processing batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(uncachedCandidates.length / batchSize)} (${batch.length} candidates)`);
+			this.logger.debug(`Processing batch ${Math.floor(i / batchSize) + 1}/${Math.ceil(uncachedCandidates.length / batchSize)} (${batch.length} candidates)`);
 			const batchResults = await this.processBatch(batch);
 			for (const [hash, result] of batchResults) {
 				results.set(hash, result);
@@ -98,7 +89,7 @@ var PluralizationService = class {
 						content: require_parse_xml.obj2xml(batchRequest)
 					}
 				]
-			}), require_timeout.DEFAULT_TIMEOUTS.AI_API * 2, `Pluralization with ${this.modelName}`)).text.trim();
+			}), require_timeout.DEFAULT_TIMEOUTS.AI_API * 2, `Pluralization with ${this.languageModel}`)).text.trim();
 			this.logger.debug(`LLM XML response: ${responseText.substring(0, 200)}...`);
 			const parsed = require_parse_xml.parseXmlFromResponseText(responseText);
 			const resultArray = Array.isArray(parsed.results.result) ? parsed.results.result : [parsed.results.result];
@@ -124,7 +115,7 @@ var PluralizationService = class {
 				}
 			}
 			for (const candidate of candidates) if (!results.has(candidate.hash)) {
-				this.logger.warn(`No result returned for candidate: ${candidate.sourceText}`);
+				this.logger.warn(`No result returned for a candidate: ${candidate.sourceText}`);
 				results.set(candidate.hash, {
 					success: false,
 					error: "No result returned by LLM"
@@ -164,9 +155,9 @@ var PluralizationService = class {
 			failed: 0,
 			durationMs: 0
 		};
-		this.logger.info(`Starting pluralization processing for ${totalEntries} entries`);
+		this.logger.debug(`Starting pluralization processing for ${totalEntries} entries`);
 		const candidates = require_pattern_detector.detectPluralCandidates(Object.fromEntries(Object.entries(metadata.entries).map(([hash, entry]) => [hash, entry.sourceText])), this.logger);
-		this.logger.info(`Found ${candidates.length} plural candidates (${(candidates.length / totalEntries * 100).toFixed(1)}%)`);
+		this.logger.debug(`Found ${candidates.length} plural candidates (${(candidates.length / totalEntries * 100).toFixed(1)}%)`);
 		if (candidates.length === 0) return {
 			total: totalEntries,
 			candidates: 0,
@@ -210,12 +201,12 @@ var PluralizationService = class {
 				failed++;
 				continue;
 			}
-			this.logger.info(`Pluralizing: "${entry.sourceText}" -> "${result.icuText}"`);
+			this.logger.debug(`Pluralizing: "${entry.sourceText}" -> "${result.icuText}"`);
 			entry.sourceText = result.icuText;
 			pluralized++;
 		}
 		const duration = performance.now() - startTime;
-		this.logger.info(`Pluralization completed: ${pluralized} pluralized, ${rejected} rejected, ${failed} failed in ${duration.toFixed(0)}ms`);
+		this.logger.debug(`Pluralization completed: ${pluralized} pluralized, ${rejected} rejected, ${failed} failed in ${duration.toFixed(0)}ms`);
 		return {
 			total: totalEntries,
 			candidates: candidates.length,
@@ -225,22 +216,6 @@ var PluralizationService = class {
 			durationMs: duration
 		};
 	}
-	/**
-	* Clear the cache
-	*/
-	clearCache() {
-		this.cache.clear();
-		this.logger.debug("Pluralization cache cleared");
-	}
-	/**
-	* Get cache statistics
-	*/
-	getCacheStats() {
-		return {
-			size: this.cache.size,
-			hits: 0
-		};
-	}
 };
 
 //#endregion