@lingo.dev/compiler 0.1.1 → 0.1.3

package/build/translators/lingo/model-factory.cjs

@@ -1,4 +1,5 @@
 const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+const require_provider_details = require('./provider-details.cjs');
 let path = require("path");
 path = require_rolldown_runtime.__toESM(path);
 let _ai_sdk_groq = require("@ai-sdk/groq");
@@ -121,7 +122,7 @@ function parseModelString(modelString) {
 */
 function validateAndGetApiKeys(config) {
 	const keys = {};
-	const missingKeys = [];
+	const missingProviders = [];
 	let providersToValidate;
 	if (config === "lingo.dev") providersToValidate = ["lingo.dev"];
 	else {
@@ -134,19 +135,13 @@ function validateAndGetApiKeys(config) {
 	}
 	for (const provider of providersToValidate) {
 		const providerConfig = providerDetails[provider];
-		if (!providerConfig) throw new Error(`⚠️  Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+		if (!providerConfig) throw new Error(`⚠️ Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
 		if (!providerConfig.apiKeyEnvVar) continue;
 		const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);
 		if (key) keys[provider] = key;
-		else missingKeys.push({
-			provider: providerConfig.name,
-			envVar: providerConfig.apiKeyEnvVar
-		});
-	}
-	if (missingKeys.length > 0) {
-		const errorLines = missingKeys.map(({ provider, envVar }) => `  - ${provider}: ${envVar}`);
-		throw new Error(`⚠️  Missing API keys for configured providers:\n${errorLines.join("\n")}\n\nPlease set the required environment variables.`);
+		else missingProviders.push(provider);
 	}
+	if (missingProviders.length > 0) throw new Error(require_provider_details.formatNoApiKeysError(missingProviders));
 	return keys;
 }
 /**

package/build/translators/lingo/model-factory.mjs

@@ -1,3 +1,4 @@
+import { formatNoApiKeysError } from "./provider-details.mjs";
 import * as path$1 from "path";
 import { createGroq } from "@ai-sdk/groq";
 import { createGoogleGenerativeAI } from "@ai-sdk/google";
@@ -118,7 +119,7 @@ function parseModelString(modelString) {
 */
 function validateAndGetApiKeys(config) {
 	const keys = {};
-	const missingKeys = [];
+	const missingProviders = [];
 	let providersToValidate;
 	if (config === "lingo.dev") providersToValidate = ["lingo.dev"];
 	else {
@@ -131,19 +132,13 @@ function validateAndGetApiKeys(config) {
 	}
 	for (const provider of providersToValidate) {
 		const providerConfig = providerDetails[provider];
-		if (!providerConfig) throw new Error(`⚠️  Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
+		if (!providerConfig) throw new Error(`⚠️ Unknown provider "${provider}". Supported providers: ${Object.keys(providerDetails).join(", ")}`);
 		if (!providerConfig.apiKeyEnvVar) continue;
 		const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);
 		if (key) keys[provider] = key;
-		else missingKeys.push({
-			provider: providerConfig.name,
-			envVar: providerConfig.apiKeyEnvVar
-		});
-	}
-	if (missingKeys.length > 0) {
-		const errorLines = missingKeys.map(({ provider, envVar }) => `  - ${provider}: ${envVar}`);
-		throw new Error(`⚠️  Missing API keys for configured providers:\n${errorLines.join("\n")}\n\nPlease set the required environment variables.`);
+		else missingProviders.push(provider);
 	}
+	if (missingProviders.length > 0) throw new Error(formatNoApiKeysError(missingProviders));
 	return keys;
 }
 /**

package/build/translators/lingo/model-factory.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"model-factory.mjs","names":["path","providerDetails: Record<string, ProviderConfig>","keys: ValidatedApiKeys","missingKeys: Array<{ provider: string; envVar: string }>","providersToValidate: string[]"],"sources":["../../../src/translators/lingo/model-factory.ts"],"sourcesContent":["/**\n * Shared utilities for creating AI model instances\n */\n\nimport { createGroq } from \"@ai-sdk/groq\";\nimport { createGoogleGenerativeAI } from \"@ai-sdk/google\";\nimport { createOpenRouter } from \"@openrouter/ai-sdk-provider\";\nimport { ollama } from \"ai-sdk-ollama\";\nimport { createMistral } from \"@ai-sdk/mistral\";\nimport type { LanguageModel } from \"ai\";\nimport * as dotenv from \"dotenv\";\nimport * as path from \"path\";\n\nexport type LocaleModel = {\n  provider: string;\n  name: string;\n};\n\nexport function getKeyFromEnv(envVarName: string): string | undefined {\n  if (process.env[envVarName]) {\n    return process.env[envVarName];\n  }\n\n  const projectRoot = process.cwd();\n\n  const result = dotenv.config({\n    path: [\n      path.resolve(projectRoot, \".env\"),\n      path.resolve(projectRoot, \".env.local\"),\n      path.resolve(projectRoot, \".env.development\"),\n    ],\n  });\n\n  return result?.parsed?.[envVarName];\n}\n\n/**\n * Pre-validated API keys for all providers\n * Keys are fetched and validated once at initialization\n */\nexport type ValidatedApiKeys = Record<string, string>;\n\n/**\n * Provider configuration including env var names and requirements\n */\ntype ProviderConfig = {\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, ProviderConfig> = {\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  openai: {\n    name: \"OpenAI\",\n    apiKeyEnvVar: \"OPENAI_API_KEY\",\n    apiKeyConfigKey: \"llm.openaiApiKey\",\n    getKeyLink: \"https://platform.openai.com/account/api-keys\",\n    docsLink: \"https://platform.openai.com/docs\",\n  },\n  anthropic: {\n    name: \"Anthropic\",\n    apiKeyEnvVar: \"ANTHROPIC_API_KEY\",\n    apiKeyConfigKey: \"llm.anthropicApiKey\",\n    getKeyLink: \"https://console.anthropic.com/get-api-key\",\n    docsLink: \"https://console.anthropic.com/docs\",\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, // Ollama doesn't require an API key\n    apiKeyConfigKey: undefined, // Ollama doesn't require an API key\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 * Get provider and model for a specific locale pair\n */\nexport function getLocaleModel(\n  localeModels: Record<string, string>,\n  sourceLocale: string,\n  targetLocale: string,\n): LocaleModel | undefined {\n  const localeKeys = [\n    `${sourceLocale}:${targetLocale}`,\n    `*:${targetLocale}`,\n    `${sourceLocale}:*`,\n    \"*:*\",\n  ];\n\n  const modelKey = localeKeys.find((key) => key in localeModels);\n  if (!modelKey) {\n    return undefined;\n  }\n\n  const value = localeModels[modelKey];\n  if (!value) {\n    return undefined;\n  }\n\n  return parseModelString(value);\n}\n\n/**\n * Parse provider and model from model string\n * Format: \"provider:model\" (e.g., \"groq:llama3-8b-8192\")\n *\n * @param modelString Model string to parse\n * @returns Object with provider and model\n * @throws Error if format is invalid\n */\nexport function parseModelString(modelString: string): LocaleModel | undefined {\n  // Split on first colon only\n  const [provider, name] = modelString.split(\":\", 2);\n\n  if (!provider || !name) {\n    return undefined;\n  }\n\n  return { provider, name };\n}\n\n/**\n * Validate and fetch all necessary API keys for the given configuration\n * This should be called once at initialization time\n *\n * @param config Model configuration (\"lingo.dev\" or locale-pair mapping)\n * @returns Validated API keys (provider ID -> API key)\n * @throws Error if required keys are missing\n */\nexport function validateAndGetApiKeys(\n  config: \"lingo.dev\" | Record<string, string>,\n): ValidatedApiKeys {\n  const keys: ValidatedApiKeys = {};\n  const missingKeys: Array<{ provider: string; envVar: string }> = [];\n\n  // Determine which providers are configured\n  let providersToValidate: string[];\n\n  if (config === \"lingo.dev\") {\n    // Only need lingo.dev provider\n    providersToValidate = [\"lingo.dev\"];\n  } else {\n    // Extract unique providers from model strings\n    const providerSet = new Set<string>();\n    Object.values(config).forEach((modelString) => {\n      const model = parseModelString(modelString);\n      if (model) {\n        providerSet.add(model.provider);\n      }\n    });\n    providersToValidate = Array.from(providerSet);\n  }\n\n  // Validate and fetch keys for each provider\n  for (const provider of providersToValidate) {\n    const providerConfig = providerDetails[provider];\n\n    if (!providerConfig) {\n      throw new Error(\n        `⚠️  Unknown provider \"${provider}\". Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n      );\n    }\n\n    // Skip providers that don't require keys (like Ollama)\n    if (!providerConfig.apiKeyEnvVar) {\n      continue;\n    }\n\n    const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);\n    if (key) {\n      keys[provider] = key;\n    } else {\n      missingKeys.push({\n        provider: providerConfig.name,\n        envVar: providerConfig.apiKeyEnvVar,\n      });\n    }\n  }\n\n  // If any keys are missing, throw with detailed error\n  if (missingKeys.length > 0) {\n    const errorLines = missingKeys.map(\n      ({ provider, envVar }) => `  - ${provider}: ${envVar}`,\n    );\n    throw new Error(\n      `⚠️  Missing API keys for configured providers:\\n${errorLines.join(\"\\n\")}\\n\\nPlease set the required environment variables.`,\n    );\n  }\n\n  return keys;\n}\n\n/**\n * Create AI model instance from provider and model ID\n *\n * @param model Provider name (groq, google, openrouter, ollama, mistral) and model identifier\n * @param validatedKeys Pre-validated API keys from validateAndFetchApiKeys()\n * @returns LanguageModel instance\n * @throws Error if provider is not supported or API key is missing\n */\nexport function createAiModel(\n  model: LocaleModel,\n  validatedKeys: ValidatedApiKeys,\n): LanguageModel {\n  const providerConfig = providerDetails[model.provider];\n\n  if (!providerConfig) {\n    throw new Error(\n      `⚠️  Provider \"${model.provider}\" is not supported. Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n    );\n  }\n\n  // Get API key if required\n  const apiKey = providerConfig.apiKeyEnvVar\n    ? validatedKeys[model.provider]\n    : undefined;\n\n  // Verify key is present for providers that require it\n  if (providerConfig.apiKeyEnvVar && !apiKey) {\n    throw new Error(\n      `⚠️  ${providerConfig.name} API key not found. Please set ${providerConfig.apiKeyEnvVar} environment variable.\\n\\n` +\n        `This should not happen if validateAndFetchApiKeys() was called. Please restart the service.`,\n    );\n  }\n\n  // Create the appropriate model instance\n  switch (model.provider) {\n    case \"groq\":\n      return createGroq({ apiKey: apiKey! })(model.name);\n\n    case \"google\":\n      return createGoogleGenerativeAI({ apiKey: apiKey! })(model.name);\n\n    case \"openrouter\":\n      return createOpenRouter({ apiKey: apiKey! })(model.name);\n\n    case \"ollama\":\n      return ollama(model.name);\n\n    case \"mistral\":\n      return createMistral({ apiKey: apiKey! })(model.name);\n\n    default:\n      // This should be unreachable due to check above\n      throw new Error(`⚠️  Provider \"${model.provider}\" is not implemented`);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"model-factory.mjs","names":["path","providerDetails: Record<string, ProviderConfig>","keys: ValidatedApiKeys","missingProviders: string[]","providersToValidate: string[]"],"sources":["../../../src/translators/lingo/model-factory.ts"],"sourcesContent":["/**\n * Shared utilities for creating AI model instances\n */\n\nimport { createGroq } from \"@ai-sdk/groq\";\nimport { createGoogleGenerativeAI } from \"@ai-sdk/google\";\nimport { createOpenRouter } from \"@openrouter/ai-sdk-provider\";\nimport { ollama } from \"ai-sdk-ollama\";\nimport { createMistral } from \"@ai-sdk/mistral\";\nimport type { LanguageModel } from \"ai\";\nimport * as dotenv from \"dotenv\";\nimport * as path from \"path\";\nimport { formatNoApiKeysError } from \"./provider-details\";\n\nexport type LocaleModel = {\n  provider: string;\n  name: string;\n};\n\nexport function getKeyFromEnv(envVarName: string): string | undefined {\n  if (process.env[envVarName]) {\n    return process.env[envVarName];\n  }\n\n  const projectRoot = process.cwd();\n\n  const result = dotenv.config({\n    path: [\n      path.resolve(projectRoot, \".env\"),\n      path.resolve(projectRoot, \".env.local\"),\n      path.resolve(projectRoot, \".env.development\"),\n    ],\n  });\n\n  return result?.parsed?.[envVarName];\n}\n\n/**\n * Pre-validated API keys for all providers\n * Keys are fetched and validated once at initialization\n */\nexport type ValidatedApiKeys = Record<string, string>;\n\n/**\n * Provider configuration including env var names and requirements\n */\ntype ProviderConfig = {\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, ProviderConfig> = {\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  openai: {\n    name: \"OpenAI\",\n    apiKeyEnvVar: \"OPENAI_API_KEY\",\n    apiKeyConfigKey: \"llm.openaiApiKey\",\n    getKeyLink: \"https://platform.openai.com/account/api-keys\",\n    docsLink: \"https://platform.openai.com/docs\",\n  },\n  anthropic: {\n    name: \"Anthropic\",\n    apiKeyEnvVar: \"ANTHROPIC_API_KEY\",\n    apiKeyConfigKey: \"llm.anthropicApiKey\",\n    getKeyLink: \"https://console.anthropic.com/get-api-key\",\n    docsLink: \"https://console.anthropic.com/docs\",\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, // Ollama doesn't require an API key\n    apiKeyConfigKey: undefined, // Ollama doesn't require an API key\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 * Get provider and model for a specific locale pair\n */\nexport function getLocaleModel(\n  localeModels: Record<string, string>,\n  sourceLocale: string,\n  targetLocale: string,\n): LocaleModel | undefined {\n  const localeKeys = [\n    `${sourceLocale}:${targetLocale}`,\n    `*:${targetLocale}`,\n    `${sourceLocale}:*`,\n    \"*:*\",\n  ];\n\n  const modelKey = localeKeys.find((key) => key in localeModels);\n  if (!modelKey) {\n    return undefined;\n  }\n\n  const value = localeModels[modelKey];\n  if (!value) {\n    return undefined;\n  }\n\n  return parseModelString(value);\n}\n\n/**\n * Parse provider and model from model string\n * Format: \"provider:model\" (e.g., \"groq:llama3-8b-8192\")\n *\n * @param modelString Model string to parse\n * @returns Object with provider and model\n * @throws Error if format is invalid\n */\nexport function parseModelString(modelString: string): LocaleModel | undefined {\n  // Split on first colon only\n  const [provider, name] = modelString.split(\":\", 2);\n\n  if (!provider || !name) {\n    return undefined;\n  }\n\n  return { provider, name };\n}\n\n/**\n * Validate and fetch all necessary API keys for the given configuration\n * This should be called once at initialization time\n *\n * @param config Model configuration (\"lingo.dev\" or locale-pair mapping)\n * @returns Validated API keys (provider ID -> API key)\n * @throws Error if required keys are missing\n */\nexport function validateAndGetApiKeys(\n  config: \"lingo.dev\" | Record<string, string>,\n): ValidatedApiKeys {\n  const keys: ValidatedApiKeys = {};\n  const missingProviders: string[] = [];\n\n  // Determine which providers are configured\n  let providersToValidate: string[];\n\n  if (config === \"lingo.dev\") {\n    // Only need lingo.dev provider\n    providersToValidate = [\"lingo.dev\"];\n  } else {\n    // Extract unique providers from model strings\n    const providerSet = new Set<string>();\n    Object.values(config).forEach((modelString) => {\n      const model = parseModelString(modelString);\n      if (model) {\n        providerSet.add(model.provider);\n      }\n    });\n    providersToValidate = Array.from(providerSet);\n  }\n\n  // Validate and fetch keys for each provider\n  for (const provider of providersToValidate) {\n    const providerConfig = providerDetails[provider];\n\n    if (!providerConfig) {\n      throw new Error(\n        `⚠️ Unknown provider \"${provider}\". Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n      );\n    }\n\n    // Skip providers that don't require keys (like Ollama)\n    if (!providerConfig.apiKeyEnvVar) {\n      continue;\n    }\n\n    const key = getKeyFromEnv(providerConfig.apiKeyEnvVar);\n    if (key) {\n      keys[provider] = key;\n    } else {\n      missingProviders.push(provider);\n    }\n  }\n\n  // If any keys are missing, throw with detailed error\n  if (missingProviders.length > 0) {\n    throw new Error(formatNoApiKeysError(missingProviders));\n  }\n\n  return keys;\n}\n\n/**\n * Create AI model instance from provider and model ID\n *\n * @param model Provider name (groq, google, openrouter, ollama, mistral) and model identifier\n * @param validatedKeys Pre-validated API keys from validateAndFetchApiKeys()\n * @returns LanguageModel instance\n * @throws Error if provider is not supported or API key is missing\n */\nexport function createAiModel(\n  model: LocaleModel,\n  validatedKeys: ValidatedApiKeys,\n): LanguageModel {\n  const providerConfig = providerDetails[model.provider];\n\n  if (!providerConfig) {\n    throw new Error(\n      `⚠️  Provider \"${model.provider}\" is not supported. Supported providers: ${Object.keys(providerDetails).join(\", \")}`,\n    );\n  }\n\n  // Get API key if required\n  const apiKey = providerConfig.apiKeyEnvVar\n    ? validatedKeys[model.provider]\n    : undefined;\n\n  // TODO (AleksandrSl 25/12/2025): Do we really need to make a second check? Maybe creation should be combined with validation.\n  // Verify key is present for providers that require it\n  if (providerConfig.apiKeyEnvVar && !apiKey) {\n    throw new Error(\n      `⚠️  ${providerConfig.name} API key not found. Please set ${providerConfig.apiKeyEnvVar} environment variable.\\n\\n` +\n        `This should not happen if validateAndFetchApiKeys() was called. Please restart the service.`,\n    );\n  }\n\n  // Create the appropriate model instance\n  switch (model.provider) {\n    case \"groq\":\n      return createGroq({ apiKey: apiKey! })(model.name);\n\n    case \"google\":\n      return createGoogleGenerativeAI({ apiKey: apiKey! })(model.name);\n\n    case \"openrouter\":\n      return createOpenRouter({ apiKey: apiKey! })(model.name);\n\n    case \"ollama\":\n      return ollama(model.name);\n\n    case \"mistral\":\n      return createMistral({ apiKey: apiKey! })(model.name);\n\n    default:\n      // This should be unreachable due to check above\n      throw new Error(`⚠️  Provider \"${model.provider}\" is not implemented`);\n  }\n}\n"],"mappings":"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"}

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

@@ -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
+exports.formatNoApiKeysError = formatNoApiKeysError;

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;