@happyvertical/translator 0.80.0 → 0.80.1

package/dist/index.js

@@ -1,252 +1,333 @@
 import { loadEnvConfig } from "@happyvertical/utils";
-class TranslationError extends Error {
-  constructor(message, code, provider) {
-    super(message);
-    this.code = code;
-    this.provider = provider;
-    this.name = "TranslationError";
-  }
-}
-class UnsupportedLanguageError extends TranslationError {
-  constructor(language, provider) {
-    super(
-      `Unsupported language: ${language}`,
-      "UNSUPPORTED_LANGUAGE",
-      provider
-    );
-    this.name = "UnsupportedLanguageError";
-  }
-}
-class QuotaExceededError extends TranslationError {
-  constructor(provider) {
-    super("Translation quota exceeded", "QUOTA_EXCEEDED", provider);
-    this.name = "QuotaExceededError";
-  }
-}
-class AuthenticationError extends TranslationError {
-  constructor(provider) {
-    super("Authentication failed", "AUTH_ERROR", provider);
-    this.name = "AuthenticationError";
-  }
-}
-class InvalidTextError extends TranslationError {
-  constructor(reason, provider) {
-    super(`Invalid text: ${reason}`, "INVALID_TEXT", provider);
-    this.name = "InvalidTextError";
-  }
-}
-const LANGUAGE_NAMES = {
-  en: "English",
-  es: "Spanish",
-  fr: "French",
-  de: "German",
-  it: "Italian",
-  pt: "Portuguese",
-  ru: "Russian",
-  ja: "Japanese",
-  ko: "Korean",
-  zh: "Chinese",
-  ar: "Arabic",
-  hi: "Hindi",
-  nl: "Dutch",
-  pl: "Polish",
-  tr: "Turkish",
-  sv: "Swedish",
-  da: "Danish",
-  no: "Norwegian",
-  fi: "Finnish",
-  cs: "Czech",
-  el: "Greek",
-  he: "Hebrew",
-  th: "Thai",
-  vi: "Vietnamese",
-  id: "Indonesian",
-  ro: "Romanian",
-  uk: "Ukrainian",
-  bg: "Bulgarian",
-  hr: "Croatian",
-  sk: "Slovak",
-  sl: "Slovenian",
-  lt: "Lithuanian",
-  lv: "Latvian",
-  et: "Estonian",
-  hu: "Hungarian",
-  ca: "Catalan",
-  gl: "Galician",
-  eu: "Basque",
-  fa: "Persian",
-  ur: "Urdu",
-  bn: "Bengali",
-  ta: "Tamil",
-  te: "Telugu",
-  mr: "Marathi",
-  ml: "Malayalam",
-  kn: "Kannada",
-  gu: "Gujarati",
-  pa: "Punjabi",
-  sw: "Swahili",
-  ms: "Malay",
-  tl: "Tagalog",
-  af: "Afrikaans",
-  sq: "Albanian",
-  am: "Amharic",
-  hy: "Armenian",
-  az: "Azerbaijani",
-  be: "Belarusian",
-  bs: "Bosnian",
-  my: "Burmese",
-  ceb: "Cebuano",
-  ny: "Chichewa",
-  co: "Corsican",
-  eo: "Esperanto",
-  fy: "Frisian",
-  ka: "Georgian",
-  haw: "Hawaiian",
-  hmn: "Hmong",
-  is: "Icelandic",
-  ig: "Igbo",
-  ga: "Irish",
-  jw: "Javanese",
-  kk: "Kazakh",
-  km: "Khmer",
-  ku: "Kurdish",
-  ky: "Kyrgyz",
-  lo: "Lao",
-  la: "Latin",
-  lb: "Luxembourgish",
-  mk: "Macedonian",
-  mg: "Malagasy",
-  mt: "Maltese",
-  mi: "Maori",
-  mn: "Mongolian",
-  ne: "Nepali",
-  ps: "Pashto",
-  sm: "Samoan",
-  gd: "Scots Gaelic",
-  sr: "Serbian",
-  st: "Sesotho",
-  sn: "Shona",
-  sd: "Sindhi",
-  si: "Sinhala",
-  so: "Somali",
-  su: "Sundanese",
-  tg: "Tajik",
-  tt: "Tatar",
-  tk: "Turkmen",
-  ug: "Uyghur",
-  uz: "Uzbek",
-  cy: "Welsh",
-  xh: "Xhosa",
-  yi: "Yiddish",
-  yo: "Yoruba",
-  zu: "Zulu"
+//#region src/shared/types.ts
+/**
+* Base error class for translation operations
+*
+* @param message - Human-readable error description
+* @param code - Machine-readable error code (e.g., 'QUOTA_EXCEEDED', 'AUTH_ERROR', 'TIMEOUT')
+* @param provider - The provider that produced the error (e.g., 'google', 'deepl', 'libretranslate')
+*/
+var TranslationError = class extends Error {
+	code;
+	provider;
+	constructor(message, code, provider) {
+		super(message);
+		this.code = code;
+		this.provider = provider;
+		this.name = "TranslationError";
+	}
+};
+/**
+* Thrown when a requested language code is not supported by the provider
+*
+* @param language - The unsupported ISO 639-1 language code
+* @param provider - The provider that rejected the language
+*/
+var UnsupportedLanguageError = class extends TranslationError {
+	constructor(language, provider) {
+		super(`Unsupported language: ${language}`, "UNSUPPORTED_LANGUAGE", provider);
+		this.name = "UnsupportedLanguageError";
+	}
+};
+/**
+* Thrown when the provider's translation quota or rate limit has been exceeded
+*
+* @param provider - The provider that reported the quota limit
+*/
+var QuotaExceededError = class extends TranslationError {
+	constructor(provider) {
+		super("Translation quota exceeded", "QUOTA_EXCEEDED", provider);
+		this.name = "QuotaExceededError";
+	}
 };
+/**
+* Thrown when the provider rejects the API key or credentials
+*
+* @param provider - The provider that rejected authentication
+*/
+var AuthenticationError = class extends TranslationError {
+	constructor(provider) {
+		super("Authentication failed", "AUTH_ERROR", provider);
+		this.name = "AuthenticationError";
+	}
+};
+/**
+* Thrown when the input text is empty or otherwise invalid for translation
+*
+* @param reason - Description of why the text is invalid
+* @param provider - The provider that rejected the text
+*/
+var InvalidTextError = class extends TranslationError {
+	constructor(reason, provider) {
+		super(`Invalid text: ${reason}`, "INVALID_TEXT", provider);
+		this.name = "InvalidTextError";
+	}
+};
+//#endregion
+//#region src/shared/utils.ts
+/**
+* Utility functions for translation operations
+*/
+/**
+* Common ISO 639-1 language codes and their names
+*/
+var LANGUAGE_NAMES = {
+	en: "English",
+	es: "Spanish",
+	fr: "French",
+	de: "German",
+	it: "Italian",
+	pt: "Portuguese",
+	ru: "Russian",
+	ja: "Japanese",
+	ko: "Korean",
+	zh: "Chinese",
+	ar: "Arabic",
+	hi: "Hindi",
+	nl: "Dutch",
+	pl: "Polish",
+	tr: "Turkish",
+	sv: "Swedish",
+	da: "Danish",
+	no: "Norwegian",
+	fi: "Finnish",
+	cs: "Czech",
+	el: "Greek",
+	he: "Hebrew",
+	th: "Thai",
+	vi: "Vietnamese",
+	id: "Indonesian",
+	ro: "Romanian",
+	uk: "Ukrainian",
+	bg: "Bulgarian",
+	hr: "Croatian",
+	sk: "Slovak",
+	sl: "Slovenian",
+	lt: "Lithuanian",
+	lv: "Latvian",
+	et: "Estonian",
+	hu: "Hungarian",
+	ca: "Catalan",
+	gl: "Galician",
+	eu: "Basque",
+	fa: "Persian",
+	ur: "Urdu",
+	bn: "Bengali",
+	ta: "Tamil",
+	te: "Telugu",
+	mr: "Marathi",
+	ml: "Malayalam",
+	kn: "Kannada",
+	gu: "Gujarati",
+	pa: "Punjabi",
+	sw: "Swahili",
+	ms: "Malay",
+	tl: "Tagalog",
+	af: "Afrikaans",
+	sq: "Albanian",
+	am: "Amharic",
+	hy: "Armenian",
+	az: "Azerbaijani",
+	be: "Belarusian",
+	bs: "Bosnian",
+	my: "Burmese",
+	ceb: "Cebuano",
+	ny: "Chichewa",
+	co: "Corsican",
+	eo: "Esperanto",
+	fy: "Frisian",
+	ka: "Georgian",
+	haw: "Hawaiian",
+	hmn: "Hmong",
+	is: "Icelandic",
+	ig: "Igbo",
+	ga: "Irish",
+	jw: "Javanese",
+	kk: "Kazakh",
+	km: "Khmer",
+	ku: "Kurdish",
+	ky: "Kyrgyz",
+	lo: "Lao",
+	la: "Latin",
+	lb: "Luxembourgish",
+	mk: "Macedonian",
+	mg: "Malagasy",
+	mt: "Maltese",
+	mi: "Maori",
+	mn: "Mongolian",
+	ne: "Nepali",
+	ps: "Pashto",
+	sm: "Samoan",
+	gd: "Scots Gaelic",
+	sr: "Serbian",
+	st: "Sesotho",
+	sn: "Shona",
+	sd: "Sindhi",
+	si: "Sinhala",
+	so: "Somali",
+	su: "Sundanese",
+	tg: "Tajik",
+	tt: "Tatar",
+	tk: "Turkmen",
+	ug: "Uyghur",
+	uz: "Uzbek",
+	cy: "Welsh",
+	xh: "Xhosa",
+	yi: "Yiddish",
+	yo: "Yoruba",
+	zu: "Zulu"
+};
+/**
+* Validates an ISO 639-1 language code
+* @param code Language code to validate
+* @returns True if valid
+*/
 function isValidLanguageCode(code) {
-  return code.length === 2 && /^[a-z]{2}$/.test(code);
+	return code.length === 2 && /^[a-z]{2}$/.test(code);
 }
+/**
+* Gets the language name from a language code
+* @param code ISO 639-1 language code
+* @returns Language name or the code if not found
+*/
 function getLanguageName(code) {
-  return LANGUAGE_NAMES[code] || code;
+	return LANGUAGE_NAMES[code] || code;
 }
+/**
+* Normalizes a confidence score to 0-1 range
+* @param score Confidence score (may be 0-1 or 0-100)
+* @returns Normalized score between 0 and 1
+*/
 function normalizeConfidence(score) {
-  if (score > 1 && score <= 100) {
-    return score / 100;
-  }
-  return Math.max(0, Math.min(1, score));
+	if (score > 1 && score <= 100) return score / 100;
+	return Math.max(0, Math.min(1, score));
 }
+/**
+* Validates that text is not empty
+* @param text Text to validate
+* @returns True if text is valid
+*/
 function isValidText(text) {
-  return typeof text === "string" && text.trim().length > 0;
+	return typeof text === "string" && text.trim().length > 0;
 }
+/**
+* Truncates text to a maximum length
+* @param text Text to truncate
+* @param maxLength Maximum length
+* @returns Truncated text
+*/
 function truncateText(text, maxLength) {
-  if (text.length <= maxLength) {
-    return text;
-  }
-  return `${text.substring(0, maxLength - 3)}...`;
-}
-class TranslatorWrapper {
-  constructor(provider) {
-    this.provider = provider;
-  }
-  async translate(text, targetLanguage, sourceLanguage) {
-    return this.provider.translate(text, targetLanguage, sourceLanguage);
-  }
-  async detectLanguage(text) {
-    return this.provider.detectLanguage(text);
-  }
-  async getSupportedLanguages() {
-    return this.provider.getSupportedLanguages();
-  }
-  async translateBatch(texts, targetLanguage, sourceLanguage) {
-    return this.provider.translateBatch(texts, targetLanguage, sourceLanguage);
-  }
-  /**
-   * Creates a pre-configured translation function
-   * This is the key ergonomic feature that makes repeated translations simple
-   */
-  templateFunction(sourceLanguage, targetLanguage = "en") {
-    return async (text) => {
-      const result = await this.provider.translate(
-        text,
-        targetLanguage,
-        sourceLanguage
-      );
-      return result.translatedText;
-    };
-  }
+	if (text.length <= maxLength) return text;
+	return `${text.substring(0, maxLength - 3)}...`;
 }
+//#endregion
+//#region src/index.ts
+/**
+* Translator package entry point
+* Provides standardized translation interface
+*/
+/**
+* Translator wrapper class that adds templateFunction to providers
+*/
+var TranslatorWrapper = class {
+	provider;
+	constructor(provider) {
+		this.provider = provider;
+	}
+	async translate(text, targetLanguage, sourceLanguage) {
+		return this.provider.translate(text, targetLanguage, sourceLanguage);
+	}
+	async detectLanguage(text) {
+		return this.provider.detectLanguage(text);
+	}
+	async getSupportedLanguages() {
+		return this.provider.getSupportedLanguages();
+	}
+	async translateBatch(texts, targetLanguage, sourceLanguage) {
+		return this.provider.translateBatch(texts, targetLanguage, sourceLanguage);
+	}
+	/**
+	* Creates a pre-configured translation function
+	* This is the key ergonomic feature that makes repeated translations simple
+	*/
+	templateFunction(sourceLanguage, targetLanguage = "en") {
+		return async (text) => {
+			return (await this.provider.translate(text, targetLanguage, sourceLanguage)).translatedText;
+		};
+	}
+};
+/**
+* Factory function to create a translator instance
+*
+* Supports environment variable configuration using HAVE_TRANSLATOR_* pattern:
+* - HAVE_TRANSLATOR_PROVIDER: Translation provider ('google'|'deepl'|'libretranslate')
+*
+* Provider-specific API keys are loaded from their respective environment variables:
+* - GOOGLE_TRANSLATE_API_KEY: Google Translate API key
+* - DEEPL_API_KEY: DeepL API key
+*
+* @param options - Configuration options for the translation provider (optional if using env vars)
+* @returns Promise resolving to a translator that implements Translator
+*
+* @example
+* ```typescript
+* // Using explicit options
+* const translator = await getTranslator({
+*   provider: 'google',
+*   apiKey: process.env.GOOGLE_TRANSLATE_API_KEY!
+* });
+*
+* // Using environment variables
+* // Set: HAVE_TRANSLATOR_PROVIDER=deepl
+* //      DEEPL_API_KEY=your_key_here
+* const translator = await getTranslator();
+*
+* // Mix of env vars and explicit options (explicit takes precedence)
+* // Set: HAVE_TRANSLATOR_PROVIDER=google
+* const translator = await getTranslator({
+*   apiKey: 'explicit_key' // Overrides env var
+* });
+*
+* // Use the translator
+* const result = await translator.translate('Hello, world!', 'es');
+*
+* // Use template function for repeated translations
+* const t = translator.templateFunction('en', 'es');
+* const greeting = await t('Hello');
+* const farewell = await t('Goodbye');
+* ```
+*/
 async function getTranslator(options = {}) {
-  const config = loadEnvConfig(
-    options,
-    {
-      packageName: "translator",
-      schema: {
-        provider: "string",
-        timeout: "number",
-        maxRetries: "number"
-      },
-      allowUnknown: true
-    }
-  );
-  if (!config.apiKey) {
-    if (config.provider === "google" && process.env.GOOGLE_TRANSLATE_API_KEY) {
-      config.apiKey = process.env.GOOGLE_TRANSLATE_API_KEY;
-    } else if (config.provider === "deepl" && process.env.DEEPL_API_KEY) {
-      config.apiKey = process.env.DEEPL_API_KEY;
-    }
-  }
-  if (!config.provider) {
-    throw new Error(
-      "Translation provider not specified. Set HAVE_TRANSLATOR_PROVIDER environment variable or pass provider in options."
-    );
-  }
-  let provider;
-  if (config.provider === "google") {
-    const { GoogleTranslateProvider } = await import("./chunks/google-KGGP9X0w.js");
-    provider = new GoogleTranslateProvider(config);
-  } else if (config.provider === "deepl") {
-    const { DeepLProvider } = await import("./chunks/deepl-CWEP0MSh.js");
-    provider = new DeepLProvider(config);
-  } else if (config.provider === "libretranslate") {
-    const { LibreTranslateProvider } = await import("./chunks/libretranslate-BeC38-0r.js");
-    provider = new LibreTranslateProvider(config);
-  } else {
-    throw new Error(`Unsupported provider: ${config.provider}`);
-  }
-  return new TranslatorWrapper(provider);
+	const config = loadEnvConfig(options, {
+		packageName: "translator",
+		schema: {
+			provider: "string",
+			timeout: "number",
+			maxRetries: "number"
+		},
+		allowUnknown: true
+	});
+	if (!config.apiKey) {
+		if (config.provider === "google" && process.env.GOOGLE_TRANSLATE_API_KEY) config.apiKey = process.env.GOOGLE_TRANSLATE_API_KEY;
+		else if (config.provider === "deepl" && process.env.DEEPL_API_KEY) config.apiKey = process.env.DEEPL_API_KEY;
+	}
+	if (!config.provider) throw new Error("Translation provider not specified. Set HAVE_TRANSLATOR_PROVIDER environment variable or pass provider in options.");
+	let provider;
+	if (config.provider === "google") {
+		const { GoogleTranslateProvider } = await import("./chunks/google-jZMDn2Ru.js");
+		provider = new GoogleTranslateProvider(config);
+	} else if (config.provider === "deepl") {
+		const { DeepLProvider } = await import("./chunks/deepl-C9iR9zJ1.js");
+		provider = new DeepLProvider(config);
+	} else if (config.provider === "libretranslate") {
+		const { LibreTranslateProvider } = await import("./chunks/libretranslate-oJr-l5MM.js");
+		provider = new LibreTranslateProvider(config);
+	} else throw new Error(`Unsupported provider: ${config.provider}`);
+	return new TranslatorWrapper(provider);
 }
-const PACKAGE_VERSION_INITIALIZED = true;
-export {
-  AuthenticationError,
-  InvalidTextError,
-  LANGUAGE_NAMES,
-  PACKAGE_VERSION_INITIALIZED,
-  QuotaExceededError,
-  TranslationError,
-  UnsupportedLanguageError,
-  getLanguageName,
-  getTranslator,
-  isValidLanguageCode,
-  isValidText,
-  normalizeConfidence,
-  truncateText
-};
-//# sourceMappingURL=index.js.map
+/** @internal */
+var PACKAGE_VERSION_INITIALIZED = true;
+//#endregion
+export { AuthenticationError, InvalidTextError, LANGUAGE_NAMES, PACKAGE_VERSION_INITIALIZED, QuotaExceededError, TranslationError, UnsupportedLanguageError, getLanguageName, getTranslator, isValidLanguageCode, isValidText, normalizeConfidence, truncateText };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/shared/types.ts","../src/shared/utils.ts","../src/index.ts"],"sourcesContent":["/**\n * Core types and interfaces for the Translator library\n */\n\n/**\n * Standardized translation result\n */\nexport interface TranslationResult {\n  /**\n   * The translated text\n   */\n  translatedText: string;\n\n  /**\n   * The original source text\n   */\n  sourceText: string;\n\n  /**\n   * The detected or specified source language (ISO 639-1 code)\n   */\n  sourceLanguage: string;\n\n  /**\n   * The target language (ISO 639-1 code)\n   */\n  targetLanguage: string;\n\n  /**\n   * Confidence score for the translation (0-1), if available\n   */\n  confidence?: number;\n\n  /**\n   * Alternative translations, if available\n   */\n  alternatives?: string[];\n\n  /**\n   * Whether the source language was automatically detected\n   */\n  detectedSourceLanguage: boolean;\n\n  /**\n   * The original, raw response from the provider\n   */\n  raw: any;\n}\n\n/**\n * Language detection result\n */\nexport interface LanguageDetectionResult {\n  /**\n   * The detected language (ISO 639-1 code)\n   */\n  language: string;\n\n  /**\n   * Confidence score for the detection (0-1)\n   */\n  confidence: number;\n\n  /**\n   * Alternative detected languages with confidence scores, if available\n   */\n  alternatives?: Array<{\n    language: string;\n    confidence: number;\n  }>;\n\n  /**\n   * The original, raw response from the provider\n   */\n  raw: any;\n}\n\n/**\n * Supported language information\n */\nexport interface SupportedLanguage {\n  /**\n   * ISO 639-1 language code (e.g., 'en', 'es', 'fr')\n   */\n  code: string;\n\n  /**\n   * Human-readable language name in English\n   */\n  name: string;\n\n  /**\n   * Native name of the language (optional)\n   */\n  nativeName?: string;\n}\n\n/**\n * Translation provider interface - all providers must implement this\n */\nexport interface TranslationProvider {\n  /**\n   * Translates text from source language to target language\n   * @param text The text to translate\n   * @param targetLanguage The target language code (ISO 639-1)\n   * @param sourceLanguage Optional source language code. If not provided, auto-detect\n   * @returns A promise that resolves to a TranslationResult object\n   */\n  translate(\n    text: string,\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult>;\n\n  /**\n   * Detects the language of the provided text\n   * @param text The text to analyze\n   * @returns A promise that resolves to a LanguageDetectionResult object\n   */\n  detectLanguage(text: string): Promise<LanguageDetectionResult>;\n\n  /**\n   * Gets the list of languages supported by this provider\n   * @returns A promise that resolves to an array of SupportedLanguage objects\n   */\n  getSupportedLanguages(): Promise<SupportedLanguage[]>;\n\n  /**\n   * Translates multiple texts in a single batch operation\n   * @param texts Array of texts to translate\n   * @param targetLanguage The target language code (ISO 639-1)\n   * @param sourceLanguage Optional source language code. If not provided, auto-detect\n   * @returns A promise that resolves to an array of TranslationResult objects\n   */\n  translateBatch(\n    texts: string[],\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult[]>;\n}\n\n/**\n * Translator interface - extends provider interface with convenience methods\n */\nexport interface Translator extends TranslationProvider {\n  /**\n   * Creates a pre-configured translation function for repeated translations\n   * @param sourceLanguage Optional source language code (ISO 639-1). If undefined, auto-detects\n   * @param targetLanguage Optional target language code (ISO 639-1). Defaults to 'en'\n   * @returns A function that translates text with the pre-configured languages\n   */\n  templateFunction(\n    sourceLanguage?: string,\n    targetLanguage?: string,\n  ): (text: string) => Promise<string>;\n}\n\n/**\n * Base configuration options for all providers\n */\nexport interface BaseTranslatorOptions {\n  /**\n   * Request timeout in milliseconds\n   */\n  timeout?: number;\n\n  /**\n   * Maximum number of retries for failed requests\n   */\n  maxRetries?: number;\n}\n\n/**\n * Google Translate provider options\n */\nexport interface GoogleTranslateOptions extends BaseTranslatorOptions {\n  provider: 'google';\n  /**\n   * Google Cloud API key or credentials\n   */\n  apiKey: string;\n  /**\n   * Optional Google Cloud project ID\n   */\n  projectId?: string;\n}\n\n/**\n * DeepL provider options\n */\nexport interface DeepLOptions extends BaseTranslatorOptions {\n  provider: 'deepl';\n  /**\n   * DeepL API key\n   */\n  apiKey: string;\n  /**\n   * Whether to use free or pro API endpoint (default: false = pro)\n   */\n  freeApi?: boolean;\n}\n\n/**\n * LibreTranslate provider options\n */\nexport interface LibreTranslateOptions extends BaseTranslatorOptions {\n  provider: 'libretranslate';\n  /**\n   * Custom instance URL (default: https://libretranslate.com)\n   */\n  apiUrl?: string;\n  /**\n   * Optional API key for some instances\n   */\n  apiKey?: string;\n}\n\n/**\n * Union type for all provider options\n */\nexport type TranslatorOptions =\n  | GoogleTranslateOptions\n  | DeepLOptions\n  | LibreTranslateOptions;\n\n/**\n * Base error class for translation operations\n *\n * @param message - Human-readable error description\n * @param code - Machine-readable error code (e.g., 'QUOTA_EXCEEDED', 'AUTH_ERROR', 'TIMEOUT')\n * @param provider - The provider that produced the error (e.g., 'google', 'deepl', 'libretranslate')\n */\nexport class TranslationError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public provider?: string,\n  ) {\n    super(message);\n    this.name = 'TranslationError';\n  }\n}\n\n/**\n * Thrown when a requested language code is not supported by the provider\n *\n * @param language - The unsupported ISO 639-1 language code\n * @param provider - The provider that rejected the language\n */\nexport class UnsupportedLanguageError extends TranslationError {\n  constructor(language: string, provider?: string) {\n    super(\n      `Unsupported language: ${language}`,\n      'UNSUPPORTED_LANGUAGE',\n      provider,\n    );\n    this.name = 'UnsupportedLanguageError';\n  }\n}\n\n/**\n * Thrown when the provider's translation quota or rate limit has been exceeded\n *\n * @param provider - The provider that reported the quota limit\n */\nexport class QuotaExceededError extends TranslationError {\n  constructor(provider?: string) {\n    super('Translation quota exceeded', 'QUOTA_EXCEEDED', provider);\n    this.name = 'QuotaExceededError';\n  }\n}\n\n/**\n * Thrown when the provider rejects the API key or credentials\n *\n * @param provider - The provider that rejected authentication\n */\nexport class AuthenticationError extends TranslationError {\n  constructor(provider?: string) {\n    super('Authentication failed', 'AUTH_ERROR', provider);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the input text is empty or otherwise invalid for translation\n *\n * @param reason - Description of why the text is invalid\n * @param provider - The provider that rejected the text\n */\nexport class InvalidTextError extends TranslationError {\n  constructor(reason: string, provider?: string) {\n    super(`Invalid text: ${reason}`, 'INVALID_TEXT', provider);\n    this.name = 'InvalidTextError';\n  }\n}\n","/**\n * Utility functions for translation operations\n */\n\n/**\n * Common ISO 639-1 language codes and their names\n */\nexport const LANGUAGE_NAMES: Record<string, string> = {\n  en: 'English',\n  es: 'Spanish',\n  fr: 'French',\n  de: 'German',\n  it: 'Italian',\n  pt: 'Portuguese',\n  ru: 'Russian',\n  ja: 'Japanese',\n  ko: 'Korean',\n  zh: 'Chinese',\n  ar: 'Arabic',\n  hi: 'Hindi',\n  nl: 'Dutch',\n  pl: 'Polish',\n  tr: 'Turkish',\n  sv: 'Swedish',\n  da: 'Danish',\n  no: 'Norwegian',\n  fi: 'Finnish',\n  cs: 'Czech',\n  el: 'Greek',\n  he: 'Hebrew',\n  th: 'Thai',\n  vi: 'Vietnamese',\n  id: 'Indonesian',\n  ro: 'Romanian',\n  uk: 'Ukrainian',\n  bg: 'Bulgarian',\n  hr: 'Croatian',\n  sk: 'Slovak',\n  sl: 'Slovenian',\n  lt: 'Lithuanian',\n  lv: 'Latvian',\n  et: 'Estonian',\n  hu: 'Hungarian',\n  ca: 'Catalan',\n  gl: 'Galician',\n  eu: 'Basque',\n  fa: 'Persian',\n  ur: 'Urdu',\n  bn: 'Bengali',\n  ta: 'Tamil',\n  te: 'Telugu',\n  mr: 'Marathi',\n  ml: 'Malayalam',\n  kn: 'Kannada',\n  gu: 'Gujarati',\n  pa: 'Punjabi',\n  sw: 'Swahili',\n  ms: 'Malay',\n  tl: 'Tagalog',\n  af: 'Afrikaans',\n  sq: 'Albanian',\n  am: 'Amharic',\n  hy: 'Armenian',\n  az: 'Azerbaijani',\n  be: 'Belarusian',\n  bs: 'Bosnian',\n  my: 'Burmese',\n  ceb: 'Cebuano',\n  ny: 'Chichewa',\n  co: 'Corsican',\n  eo: 'Esperanto',\n  fy: 'Frisian',\n  ka: 'Georgian',\n  haw: 'Hawaiian',\n  hmn: 'Hmong',\n  is: 'Icelandic',\n  ig: 'Igbo',\n  ga: 'Irish',\n  jw: 'Javanese',\n  kk: 'Kazakh',\n  km: 'Khmer',\n  ku: 'Kurdish',\n  ky: 'Kyrgyz',\n  lo: 'Lao',\n  la: 'Latin',\n  lb: 'Luxembourgish',\n  mk: 'Macedonian',\n  mg: 'Malagasy',\n  mt: 'Maltese',\n  mi: 'Maori',\n  mn: 'Mongolian',\n  ne: 'Nepali',\n  ps: 'Pashto',\n  sm: 'Samoan',\n  gd: 'Scots Gaelic',\n  sr: 'Serbian',\n  st: 'Sesotho',\n  sn: 'Shona',\n  sd: 'Sindhi',\n  si: 'Sinhala',\n  so: 'Somali',\n  su: 'Sundanese',\n  tg: 'Tajik',\n  tt: 'Tatar',\n  tk: 'Turkmen',\n  ug: 'Uyghur',\n  uz: 'Uzbek',\n  cy: 'Welsh',\n  xh: 'Xhosa',\n  yi: 'Yiddish',\n  yo: 'Yoruba',\n  zu: 'Zulu',\n};\n\n/**\n * Validates an ISO 639-1 language code\n * @param code Language code to validate\n * @returns True if valid\n */\nexport function isValidLanguageCode(code: string): boolean {\n  return code.length === 2 && /^[a-z]{2}$/.test(code);\n}\n\n/**\n * Gets the language name from a language code\n * @param code ISO 639-1 language code\n * @returns Language name or the code if not found\n */\nexport function getLanguageName(code: string): string {\n  return LANGUAGE_NAMES[code] || code;\n}\n\n/**\n * Normalizes a confidence score to 0-1 range\n * @param score Confidence score (may be 0-1 or 0-100)\n * @returns Normalized score between 0 and 1\n */\nexport function normalizeConfidence(score: number): number {\n  if (score > 1 && score <= 100) {\n    return score / 100;\n  }\n  return Math.max(0, Math.min(1, score));\n}\n\n/**\n * Validates that text is not empty\n * @param text Text to validate\n * @returns True if text is valid\n */\nexport function isValidText(text: string): boolean {\n  return typeof text === 'string' && text.trim().length > 0;\n}\n\n/**\n * Truncates text to a maximum length\n * @param text Text to truncate\n * @param maxLength Maximum length\n * @returns Truncated text\n */\nexport function truncateText(text: string, maxLength: number): string {\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return `${text.substring(0, maxLength - 3)}...`;\n}\n","/**\n * Translator package entry point\n * Provides standardized translation interface\n */\n\nimport { loadEnvConfig } from '@happyvertical/utils';\nimport type {\n  DeepLOptions,\n  GoogleTranslateOptions,\n  LanguageDetectionResult,\n  LibreTranslateOptions,\n  SupportedLanguage,\n  TranslationProvider,\n  TranslationResult,\n  Translator,\n  TranslatorOptions,\n} from './shared/types';\n\n// Export all types\nexport * from './shared/types';\nexport * from './shared/utils';\n\n/**\n * Type guard for Google Translate options\n */\nfunction _isGoogleTranslateOptions(\n  options: TranslatorOptions,\n): options is GoogleTranslateOptions {\n  return options.provider === 'google';\n}\n\n/**\n * Type guard for DeepL options\n */\nfunction _isDeepLOptions(options: TranslatorOptions): options is DeepLOptions {\n  return options.provider === 'deepl';\n}\n\n/**\n * Type guard for LibreTranslate options\n */\nfunction _isLibreTranslateOptions(\n  options: TranslatorOptions,\n): options is LibreTranslateOptions {\n  return options.provider === 'libretranslate';\n}\n\n/**\n * Translator wrapper class that adds templateFunction to providers\n */\nclass TranslatorWrapper implements Translator {\n  constructor(private provider: TranslationProvider) {}\n\n  async translate(\n    text: string,\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult> {\n    return this.provider.translate(text, targetLanguage, sourceLanguage);\n  }\n\n  async detectLanguage(text: string): Promise<LanguageDetectionResult> {\n    return this.provider.detectLanguage(text);\n  }\n\n  async getSupportedLanguages(): Promise<SupportedLanguage[]> {\n    return this.provider.getSupportedLanguages();\n  }\n\n  async translateBatch(\n    texts: string[],\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult[]> {\n    return this.provider.translateBatch(texts, targetLanguage, sourceLanguage);\n  }\n\n  /**\n   * Creates a pre-configured translation function\n   * This is the key ergonomic feature that makes repeated translations simple\n   */\n  templateFunction(\n    sourceLanguage?: string,\n    targetLanguage: string = 'en',\n  ): (text: string) => Promise<string> {\n    return async (text: string): Promise<string> => {\n      const result = await this.provider.translate(\n        text,\n        targetLanguage,\n        sourceLanguage,\n      );\n      return result.translatedText;\n    };\n  }\n}\n\n/**\n * Factory function to create a translator instance\n *\n * Supports environment variable configuration using HAVE_TRANSLATOR_* pattern:\n * - HAVE_TRANSLATOR_PROVIDER: Translation provider ('google'|'deepl'|'libretranslate')\n *\n * Provider-specific API keys are loaded from their respective environment variables:\n * - GOOGLE_TRANSLATE_API_KEY: Google Translate API key\n * - DEEPL_API_KEY: DeepL API key\n *\n * @param options - Configuration options for the translation provider (optional if using env vars)\n * @returns Promise resolving to a translator that implements Translator\n *\n * @example\n * ```typescript\n * // Using explicit options\n * const translator = await getTranslator({\n *   provider: 'google',\n *   apiKey: process.env.GOOGLE_TRANSLATE_API_KEY!\n * });\n *\n * // Using environment variables\n * // Set: HAVE_TRANSLATOR_PROVIDER=deepl\n * //      DEEPL_API_KEY=your_key_here\n * const translator = await getTranslator();\n *\n * // Mix of env vars and explicit options (explicit takes precedence)\n * // Set: HAVE_TRANSLATOR_PROVIDER=google\n * const translator = await getTranslator({\n *   apiKey: 'explicit_key' // Overrides env var\n * });\n *\n * // Use the translator\n * const result = await translator.translate('Hello, world!', 'es');\n *\n * // Use template function for repeated translations\n * const t = translator.templateFunction('en', 'es');\n * const greeting = await t('Hello');\n * const farewell = await t('Goodbye');\n * ```\n */\nexport async function getTranslator(\n  options: Partial<TranslatorOptions> = {},\n): Promise<Translator> {\n  // Load configuration from environment variables with user options taking precedence\n  const config: Record<string, any> = loadEnvConfig(\n    options as Record<string, any>,\n    {\n      packageName: 'translator',\n      schema: {\n        provider: 'string',\n        timeout: 'number',\n        maxRetries: 'number',\n      },\n      allowUnknown: true,\n    },\n  );\n\n  // Load provider-specific API keys from their respective env vars\n  // This maintains backward compatibility with existing env var patterns\n  if (!config.apiKey) {\n    if (config.provider === 'google' && process.env.GOOGLE_TRANSLATE_API_KEY) {\n      config.apiKey = process.env.GOOGLE_TRANSLATE_API_KEY;\n    } else if (config.provider === 'deepl' && process.env.DEEPL_API_KEY) {\n      config.apiKey = process.env.DEEPL_API_KEY;\n    }\n  }\n\n  // Validate provider is set\n  if (!config.provider) {\n    throw new Error(\n      'Translation provider not specified. Set HAVE_TRANSLATOR_PROVIDER environment variable or pass provider in options.',\n    );\n  }\n\n  let provider: TranslationProvider;\n\n  if (config.provider === 'google') {\n    const { GoogleTranslateProvider } = await import('./providers/google.js');\n    provider = new GoogleTranslateProvider(config as GoogleTranslateOptions);\n  } else if (config.provider === 'deepl') {\n    const { DeepLProvider } = await import('./providers/deepl.js');\n    provider = new DeepLProvider(config as DeepLOptions);\n  } else if (config.provider === 'libretranslate') {\n    const { LibreTranslateProvider } = await import(\n      './providers/libretranslate.js'\n    );\n    provider = new LibreTranslateProvider(config as LibreTranslateOptions);\n  } else {\n    throw new Error(`Unsupported provider: ${config.provider}`);\n  }\n\n  return new TranslatorWrapper(provider);\n}\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/shared/types.ts","../src/shared/utils.ts","../src/index.ts"],"sourcesContent":["/**\n * Core types and interfaces for the Translator library\n */\n\n/**\n * Standardized translation result\n */\nexport interface TranslationResult {\n  /**\n   * The translated text\n   */\n  translatedText: string;\n\n  /**\n   * The original source text\n   */\n  sourceText: string;\n\n  /**\n   * The detected or specified source language (ISO 639-1 code)\n   */\n  sourceLanguage: string;\n\n  /**\n   * The target language (ISO 639-1 code)\n   */\n  targetLanguage: string;\n\n  /**\n   * Confidence score for the translation (0-1), if available\n   */\n  confidence?: number;\n\n  /**\n   * Alternative translations, if available\n   */\n  alternatives?: string[];\n\n  /**\n   * Whether the source language was automatically detected\n   */\n  detectedSourceLanguage: boolean;\n\n  /**\n   * The original, raw response from the provider\n   */\n  raw: any;\n}\n\n/**\n * Language detection result\n */\nexport interface LanguageDetectionResult {\n  /**\n   * The detected language (ISO 639-1 code)\n   */\n  language: string;\n\n  /**\n   * Confidence score for the detection (0-1)\n   */\n  confidence: number;\n\n  /**\n   * Alternative detected languages with confidence scores, if available\n   */\n  alternatives?: Array<{\n    language: string;\n    confidence: number;\n  }>;\n\n  /**\n   * The original, raw response from the provider\n   */\n  raw: any;\n}\n\n/**\n * Supported language information\n */\nexport interface SupportedLanguage {\n  /**\n   * ISO 639-1 language code (e.g., 'en', 'es', 'fr')\n   */\n  code: string;\n\n  /**\n   * Human-readable language name in English\n   */\n  name: string;\n\n  /**\n   * Native name of the language (optional)\n   */\n  nativeName?: string;\n}\n\n/**\n * Translation provider interface - all providers must implement this\n */\nexport interface TranslationProvider {\n  /**\n   * Translates text from source language to target language\n   * @param text The text to translate\n   * @param targetLanguage The target language code (ISO 639-1)\n   * @param sourceLanguage Optional source language code. If not provided, auto-detect\n   * @returns A promise that resolves to a TranslationResult object\n   */\n  translate(\n    text: string,\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult>;\n\n  /**\n   * Detects the language of the provided text\n   * @param text The text to analyze\n   * @returns A promise that resolves to a LanguageDetectionResult object\n   */\n  detectLanguage(text: string): Promise<LanguageDetectionResult>;\n\n  /**\n   * Gets the list of languages supported by this provider\n   * @returns A promise that resolves to an array of SupportedLanguage objects\n   */\n  getSupportedLanguages(): Promise<SupportedLanguage[]>;\n\n  /**\n   * Translates multiple texts in a single batch operation\n   * @param texts Array of texts to translate\n   * @param targetLanguage The target language code (ISO 639-1)\n   * @param sourceLanguage Optional source language code. If not provided, auto-detect\n   * @returns A promise that resolves to an array of TranslationResult objects\n   */\n  translateBatch(\n    texts: string[],\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult[]>;\n}\n\n/**\n * Translator interface - extends provider interface with convenience methods\n */\nexport interface Translator extends TranslationProvider {\n  /**\n   * Creates a pre-configured translation function for repeated translations\n   * @param sourceLanguage Optional source language code (ISO 639-1). If undefined, auto-detects\n   * @param targetLanguage Optional target language code (ISO 639-1). Defaults to 'en'\n   * @returns A function that translates text with the pre-configured languages\n   */\n  templateFunction(\n    sourceLanguage?: string,\n    targetLanguage?: string,\n  ): (text: string) => Promise<string>;\n}\n\n/**\n * Base configuration options for all providers\n */\nexport interface BaseTranslatorOptions {\n  /**\n   * Request timeout in milliseconds\n   */\n  timeout?: number;\n\n  /**\n   * Maximum number of retries for failed requests\n   */\n  maxRetries?: number;\n}\n\n/**\n * Google Translate provider options\n */\nexport interface GoogleTranslateOptions extends BaseTranslatorOptions {\n  provider: 'google';\n  /**\n   * Google Cloud API key or credentials\n   */\n  apiKey: string;\n  /**\n   * Optional Google Cloud project ID\n   */\n  projectId?: string;\n}\n\n/**\n * DeepL provider options\n */\nexport interface DeepLOptions extends BaseTranslatorOptions {\n  provider: 'deepl';\n  /**\n   * DeepL API key\n   */\n  apiKey: string;\n  /**\n   * Whether to use free or pro API endpoint (default: false = pro)\n   */\n  freeApi?: boolean;\n}\n\n/**\n * LibreTranslate provider options\n */\nexport interface LibreTranslateOptions extends BaseTranslatorOptions {\n  provider: 'libretranslate';\n  /**\n   * Custom instance URL (default: https://libretranslate.com)\n   */\n  apiUrl?: string;\n  /**\n   * Optional API key for some instances\n   */\n  apiKey?: string;\n}\n\n/**\n * Union type for all provider options\n */\nexport type TranslatorOptions =\n  | GoogleTranslateOptions\n  | DeepLOptions\n  | LibreTranslateOptions;\n\n/**\n * Base error class for translation operations\n *\n * @param message - Human-readable error description\n * @param code - Machine-readable error code (e.g., 'QUOTA_EXCEEDED', 'AUTH_ERROR', 'TIMEOUT')\n * @param provider - The provider that produced the error (e.g., 'google', 'deepl', 'libretranslate')\n */\nexport class TranslationError extends Error {\n  constructor(\n    message: string,\n    public code: string,\n    public provider?: string,\n  ) {\n    super(message);\n    this.name = 'TranslationError';\n  }\n}\n\n/**\n * Thrown when a requested language code is not supported by the provider\n *\n * @param language - The unsupported ISO 639-1 language code\n * @param provider - The provider that rejected the language\n */\nexport class UnsupportedLanguageError extends TranslationError {\n  constructor(language: string, provider?: string) {\n    super(\n      `Unsupported language: ${language}`,\n      'UNSUPPORTED_LANGUAGE',\n      provider,\n    );\n    this.name = 'UnsupportedLanguageError';\n  }\n}\n\n/**\n * Thrown when the provider's translation quota or rate limit has been exceeded\n *\n * @param provider - The provider that reported the quota limit\n */\nexport class QuotaExceededError extends TranslationError {\n  constructor(provider?: string) {\n    super('Translation quota exceeded', 'QUOTA_EXCEEDED', provider);\n    this.name = 'QuotaExceededError';\n  }\n}\n\n/**\n * Thrown when the provider rejects the API key or credentials\n *\n * @param provider - The provider that rejected authentication\n */\nexport class AuthenticationError extends TranslationError {\n  constructor(provider?: string) {\n    super('Authentication failed', 'AUTH_ERROR', provider);\n    this.name = 'AuthenticationError';\n  }\n}\n\n/**\n * Thrown when the input text is empty or otherwise invalid for translation\n *\n * @param reason - Description of why the text is invalid\n * @param provider - The provider that rejected the text\n */\nexport class InvalidTextError extends TranslationError {\n  constructor(reason: string, provider?: string) {\n    super(`Invalid text: ${reason}`, 'INVALID_TEXT', provider);\n    this.name = 'InvalidTextError';\n  }\n}\n","/**\n * Utility functions for translation operations\n */\n\n/**\n * Common ISO 639-1 language codes and their names\n */\nexport const LANGUAGE_NAMES: Record<string, string> = {\n  en: 'English',\n  es: 'Spanish',\n  fr: 'French',\n  de: 'German',\n  it: 'Italian',\n  pt: 'Portuguese',\n  ru: 'Russian',\n  ja: 'Japanese',\n  ko: 'Korean',\n  zh: 'Chinese',\n  ar: 'Arabic',\n  hi: 'Hindi',\n  nl: 'Dutch',\n  pl: 'Polish',\n  tr: 'Turkish',\n  sv: 'Swedish',\n  da: 'Danish',\n  no: 'Norwegian',\n  fi: 'Finnish',\n  cs: 'Czech',\n  el: 'Greek',\n  he: 'Hebrew',\n  th: 'Thai',\n  vi: 'Vietnamese',\n  id: 'Indonesian',\n  ro: 'Romanian',\n  uk: 'Ukrainian',\n  bg: 'Bulgarian',\n  hr: 'Croatian',\n  sk: 'Slovak',\n  sl: 'Slovenian',\n  lt: 'Lithuanian',\n  lv: 'Latvian',\n  et: 'Estonian',\n  hu: 'Hungarian',\n  ca: 'Catalan',\n  gl: 'Galician',\n  eu: 'Basque',\n  fa: 'Persian',\n  ur: 'Urdu',\n  bn: 'Bengali',\n  ta: 'Tamil',\n  te: 'Telugu',\n  mr: 'Marathi',\n  ml: 'Malayalam',\n  kn: 'Kannada',\n  gu: 'Gujarati',\n  pa: 'Punjabi',\n  sw: 'Swahili',\n  ms: 'Malay',\n  tl: 'Tagalog',\n  af: 'Afrikaans',\n  sq: 'Albanian',\n  am: 'Amharic',\n  hy: 'Armenian',\n  az: 'Azerbaijani',\n  be: 'Belarusian',\n  bs: 'Bosnian',\n  my: 'Burmese',\n  ceb: 'Cebuano',\n  ny: 'Chichewa',\n  co: 'Corsican',\n  eo: 'Esperanto',\n  fy: 'Frisian',\n  ka: 'Georgian',\n  haw: 'Hawaiian',\n  hmn: 'Hmong',\n  is: 'Icelandic',\n  ig: 'Igbo',\n  ga: 'Irish',\n  jw: 'Javanese',\n  kk: 'Kazakh',\n  km: 'Khmer',\n  ku: 'Kurdish',\n  ky: 'Kyrgyz',\n  lo: 'Lao',\n  la: 'Latin',\n  lb: 'Luxembourgish',\n  mk: 'Macedonian',\n  mg: 'Malagasy',\n  mt: 'Maltese',\n  mi: 'Maori',\n  mn: 'Mongolian',\n  ne: 'Nepali',\n  ps: 'Pashto',\n  sm: 'Samoan',\n  gd: 'Scots Gaelic',\n  sr: 'Serbian',\n  st: 'Sesotho',\n  sn: 'Shona',\n  sd: 'Sindhi',\n  si: 'Sinhala',\n  so: 'Somali',\n  su: 'Sundanese',\n  tg: 'Tajik',\n  tt: 'Tatar',\n  tk: 'Turkmen',\n  ug: 'Uyghur',\n  uz: 'Uzbek',\n  cy: 'Welsh',\n  xh: 'Xhosa',\n  yi: 'Yiddish',\n  yo: 'Yoruba',\n  zu: 'Zulu',\n};\n\n/**\n * Validates an ISO 639-1 language code\n * @param code Language code to validate\n * @returns True if valid\n */\nexport function isValidLanguageCode(code: string): boolean {\n  return code.length === 2 && /^[a-z]{2}$/.test(code);\n}\n\n/**\n * Gets the language name from a language code\n * @param code ISO 639-1 language code\n * @returns Language name or the code if not found\n */\nexport function getLanguageName(code: string): string {\n  return LANGUAGE_NAMES[code] || code;\n}\n\n/**\n * Normalizes a confidence score to 0-1 range\n * @param score Confidence score (may be 0-1 or 0-100)\n * @returns Normalized score between 0 and 1\n */\nexport function normalizeConfidence(score: number): number {\n  if (score > 1 && score <= 100) {\n    return score / 100;\n  }\n  return Math.max(0, Math.min(1, score));\n}\n\n/**\n * Validates that text is not empty\n * @param text Text to validate\n * @returns True if text is valid\n */\nexport function isValidText(text: string): boolean {\n  return typeof text === 'string' && text.trim().length > 0;\n}\n\n/**\n * Truncates text to a maximum length\n * @param text Text to truncate\n * @param maxLength Maximum length\n * @returns Truncated text\n */\nexport function truncateText(text: string, maxLength: number): string {\n  if (text.length <= maxLength) {\n    return text;\n  }\n  return `${text.substring(0, maxLength - 3)}...`;\n}\n","/**\n * Translator package entry point\n * Provides standardized translation interface\n */\n\nimport { loadEnvConfig } from '@happyvertical/utils';\nimport type {\n  DeepLOptions,\n  GoogleTranslateOptions,\n  LanguageDetectionResult,\n  LibreTranslateOptions,\n  SupportedLanguage,\n  TranslationProvider,\n  TranslationResult,\n  Translator,\n  TranslatorOptions,\n} from './shared/types';\n\n// Export all types\nexport * from './shared/types';\nexport * from './shared/utils';\n\n/**\n * Type guard for Google Translate options\n */\nfunction _isGoogleTranslateOptions(\n  options: TranslatorOptions,\n): options is GoogleTranslateOptions {\n  return options.provider === 'google';\n}\n\n/**\n * Type guard for DeepL options\n */\nfunction _isDeepLOptions(options: TranslatorOptions): options is DeepLOptions {\n  return options.provider === 'deepl';\n}\n\n/**\n * Type guard for LibreTranslate options\n */\nfunction _isLibreTranslateOptions(\n  options: TranslatorOptions,\n): options is LibreTranslateOptions {\n  return options.provider === 'libretranslate';\n}\n\n/**\n * Translator wrapper class that adds templateFunction to providers\n */\nclass TranslatorWrapper implements Translator {\n  constructor(private provider: TranslationProvider) {}\n\n  async translate(\n    text: string,\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult> {\n    return this.provider.translate(text, targetLanguage, sourceLanguage);\n  }\n\n  async detectLanguage(text: string): Promise<LanguageDetectionResult> {\n    return this.provider.detectLanguage(text);\n  }\n\n  async getSupportedLanguages(): Promise<SupportedLanguage[]> {\n    return this.provider.getSupportedLanguages();\n  }\n\n  async translateBatch(\n    texts: string[],\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult[]> {\n    return this.provider.translateBatch(texts, targetLanguage, sourceLanguage);\n  }\n\n  /**\n   * Creates a pre-configured translation function\n   * This is the key ergonomic feature that makes repeated translations simple\n   */\n  templateFunction(\n    sourceLanguage?: string,\n    targetLanguage: string = 'en',\n  ): (text: string) => Promise<string> {\n    return async (text: string): Promise<string> => {\n      const result = await this.provider.translate(\n        text,\n        targetLanguage,\n        sourceLanguage,\n      );\n      return result.translatedText;\n    };\n  }\n}\n\n/**\n * Factory function to create a translator instance\n *\n * Supports environment variable configuration using HAVE_TRANSLATOR_* pattern:\n * - HAVE_TRANSLATOR_PROVIDER: Translation provider ('google'|'deepl'|'libretranslate')\n *\n * Provider-specific API keys are loaded from their respective environment variables:\n * - GOOGLE_TRANSLATE_API_KEY: Google Translate API key\n * - DEEPL_API_KEY: DeepL API key\n *\n * @param options - Configuration options for the translation provider (optional if using env vars)\n * @returns Promise resolving to a translator that implements Translator\n *\n * @example\n * ```typescript\n * // Using explicit options\n * const translator = await getTranslator({\n *   provider: 'google',\n *   apiKey: process.env.GOOGLE_TRANSLATE_API_KEY!\n * });\n *\n * // Using environment variables\n * // Set: HAVE_TRANSLATOR_PROVIDER=deepl\n * //      DEEPL_API_KEY=your_key_here\n * const translator = await getTranslator();\n *\n * // Mix of env vars and explicit options (explicit takes precedence)\n * // Set: HAVE_TRANSLATOR_PROVIDER=google\n * const translator = await getTranslator({\n *   apiKey: 'explicit_key' // Overrides env var\n * });\n *\n * // Use the translator\n * const result = await translator.translate('Hello, world!', 'es');\n *\n * // Use template function for repeated translations\n * const t = translator.templateFunction('en', 'es');\n * const greeting = await t('Hello');\n * const farewell = await t('Goodbye');\n * ```\n */\nexport async function getTranslator(\n  options: Partial<TranslatorOptions> = {},\n): Promise<Translator> {\n  // Load configuration from environment variables with user options taking precedence\n  const config: Record<string, any> = loadEnvConfig(\n    options as Record<string, any>,\n    {\n      packageName: 'translator',\n      schema: {\n        provider: 'string',\n        timeout: 'number',\n        maxRetries: 'number',\n      },\n      allowUnknown: true,\n    },\n  );\n\n  // Load provider-specific API keys from their respective env vars\n  // This maintains backward compatibility with existing env var patterns\n  if (!config.apiKey) {\n    if (config.provider === 'google' && process.env.GOOGLE_TRANSLATE_API_KEY) {\n      config.apiKey = process.env.GOOGLE_TRANSLATE_API_KEY;\n    } else if (config.provider === 'deepl' && process.env.DEEPL_API_KEY) {\n      config.apiKey = process.env.DEEPL_API_KEY;\n    }\n  }\n\n  // Validate provider is set\n  if (!config.provider) {\n    throw new Error(\n      'Translation provider not specified. Set HAVE_TRANSLATOR_PROVIDER environment variable or pass provider in options.',\n    );\n  }\n\n  let provider: TranslationProvider;\n\n  if (config.provider === 'google') {\n    const { GoogleTranslateProvider } = await import('./providers/google.js');\n    provider = new GoogleTranslateProvider(config as GoogleTranslateOptions);\n  } else if (config.provider === 'deepl') {\n    const { DeepLProvider } = await import('./providers/deepl.js');\n    provider = new DeepLProvider(config as DeepLOptions);\n  } else if (config.provider === 'libretranslate') {\n    const { LibreTranslateProvider } = await import(\n      './providers/libretranslate.js'\n    );\n    provider = new LibreTranslateProvider(config as LibreTranslateOptions);\n  } else {\n    throw new Error(`Unsupported provider: ${config.provider}`);\n  }\n\n  return new TranslatorWrapper(provider);\n}\n\n/** @internal */\nexport const PACKAGE_VERSION_INITIALIZED = true;\n"],"mappings":"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"}