@lingo.dev/compiler 0.1.2 → 0.1.4

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/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