@happyvertical/translator 0.74.8

package/dist/chunks/libretranslate-BeC38-0r.js

@@ -0,0 +1,211 @@
+import { isValidText, InvalidTextError, TranslationError, getLanguageName, AuthenticationError, UnsupportedLanguageError } from "../index.js";
+class LibreTranslateProvider {
+  baseUrl;
+  apiKey;
+  timeout;
+  constructor(options) {
+    this.baseUrl = options.apiUrl || "https://libretranslate.com";
+    this.apiKey = options.apiKey;
+    this.timeout = options.timeout || 3e4;
+  }
+  /**
+   * Translates text from source language to target language
+   */
+  async translate(text, targetLanguage, sourceLanguage) {
+    if (!isValidText(text)) {
+      throw new InvalidTextError("Text cannot be empty", "libretranslate");
+    }
+    try {
+      const body = {
+        q: text,
+        target: targetLanguage,
+        format: "text"
+      };
+      if (sourceLanguage) {
+        body.source = sourceLanguage;
+      } else {
+        body.source = "auto";
+      }
+      if (this.apiKey) {
+        body.api_key = this.apiKey;
+      }
+      const response = await this.fetchLibreTranslate("/translate", body);
+      const data = response;
+      return {
+        translatedText: data.translatedText,
+        sourceText: text,
+        sourceLanguage: data.detectedLanguage?.language || sourceLanguage || "unknown",
+        targetLanguage,
+        confidence: data.detectedLanguage?.confidence,
+        detectedSourceLanguage: !sourceLanguage,
+        raw: data
+      };
+    } catch (error) {
+      throw this.mapError(error);
+    }
+  }
+  /**
+   * Detects the language of the provided text
+   */
+  async detectLanguage(text) {
+    if (!isValidText(text)) {
+      throw new InvalidTextError("Text cannot be empty", "libretranslate");
+    }
+    try {
+      const body = {
+        q: text
+      };
+      if (this.apiKey) {
+        body.api_key = this.apiKey;
+      }
+      const response = await this.fetchLibreTranslate("/detect", body);
+      if (Array.isArray(response)) {
+        const detections = response;
+        if (detections.length === 0) {
+          throw new TranslationError(
+            "No language detected",
+            "NO_DETECTION",
+            "libretranslate"
+          );
+        }
+        return {
+          language: detections[0].language,
+          confidence: detections[0].confidence,
+          alternatives: detections.slice(1).map((d) => ({
+            language: d.language,
+            confidence: d.confidence
+          })),
+          raw: response
+        };
+      }
+      throw new TranslationError(
+        "Invalid detection response",
+        "INVALID_RESPONSE",
+        "libretranslate"
+      );
+    } catch (error) {
+      if (error instanceof TranslationError) {
+        throw error;
+      }
+      throw this.mapError(error);
+    }
+  }
+  /**
+   * Gets the list of languages supported by this provider
+   */
+  async getSupportedLanguages() {
+    try {
+      const response = await this.fetchLibreTranslate(
+        "/languages",
+        void 0,
+        "GET"
+      );
+      if (Array.isArray(response)) {
+        const languages = response;
+        return languages.map((lang) => ({
+          code: lang.code,
+          name: lang.name || getLanguageName(lang.code)
+        }));
+      }
+      throw new TranslationError(
+        "Invalid languages response",
+        "INVALID_RESPONSE",
+        "libretranslate"
+      );
+    } catch (error) {
+      if (error instanceof TranslationError) {
+        throw error;
+      }
+      throw this.mapError(error);
+    }
+  }
+  /**
+   * Translates multiple texts in a single batch operation
+   * Note: LibreTranslate doesn't have native batch support,
+   * so we translate texts sequentially
+   */
+  async translateBatch(texts, targetLanguage, sourceLanguage) {
+    if (texts.length === 0) {
+      return [];
+    }
+    const results = [];
+    for (const text of texts) {
+      const result = await this.translate(text, targetLanguage, sourceLanguage);
+      results.push(result);
+    }
+    return results;
+  }
+  /**
+   * Makes an HTTP request to LibreTranslate API
+   */
+  async fetchLibreTranslate(endpoint, body, method = "POST") {
+    const url = `${this.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+    try {
+      const options = {
+        method,
+        signal: controller.signal
+      };
+      if (method === "POST" && body) {
+        options.headers = {
+          "Content-Type": "application/json"
+        };
+        options.body = JSON.stringify(body);
+      }
+      const response = await fetch(url, options);
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        if (response.status === 401 || response.status === 403) {
+          throw new AuthenticationError("libretranslate");
+        }
+        if (response.status === 400) {
+          const errorData = await response.json().catch(() => ({}));
+          if (errorData.error?.includes("language")) {
+            throw new UnsupportedLanguageError(
+              body.source || body.target || "unknown",
+              "libretranslate"
+            );
+          }
+        }
+        throw new TranslationError(
+          `HTTP ${response.status}: ${response.statusText}`,
+          "HTTP_ERROR",
+          "libretranslate"
+        );
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof TranslationError) {
+        throw error;
+      }
+      if (error.name === "AbortError") {
+        throw new TranslationError(
+          "Request timeout",
+          "TIMEOUT",
+          "libretranslate"
+        );
+      }
+      throw error;
+    }
+  }
+  /**
+   * Maps LibreTranslate errors to standardized error types
+   */
+  mapError(error) {
+    if (error instanceof TranslationError) {
+      return error;
+    }
+    const err = error;
+    return new TranslationError(
+      err?.message || "Translation failed",
+      err?.code || "UNKNOWN_ERROR",
+      "libretranslate"
+    );
+  }
+}
+export {
+  LibreTranslateProvider
+};
+//# sourceMappingURL=libretranslate-BeC38-0r.js.map

package/dist/chunks/libretranslate-BeC38-0r.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libretranslate-BeC38-0r.js","sources":["../../src/providers/libretranslate.ts"],"sourcesContent":["/**\n * LibreTranslate provider implementation\n */\n\nimport type {\n  LanguageDetectionResult,\n  LibreTranslateOptions,\n  SupportedLanguage,\n  TranslationProvider,\n  TranslationResult,\n} from '../shared/types';\nimport {\n  AuthenticationError,\n  InvalidTextError,\n  TranslationError,\n  UnsupportedLanguageError,\n} from '../shared/types';\nimport { getLanguageName, isValidText } from '../shared/utils';\n\n/**\n * LibreTranslate API response structures\n */\ninterface LibreTranslateTranslateResponse {\n  translatedText: string;\n  detectedLanguage?: {\n    confidence: number;\n    language: string;\n  };\n}\n\ninterface LibreTranslateDetectResponse {\n  confidence: number;\n  language: string;\n}\n\ninterface LibreTranslateLanguage {\n  code: string;\n  name: string;\n}\n\n/**\n * LibreTranslate provider implementation\n */\nexport class LibreTranslateProvider implements TranslationProvider {\n  private baseUrl: string;\n  private apiKey?: string;\n  private timeout: number;\n\n  constructor(options: LibreTranslateOptions) {\n    this.baseUrl = options.apiUrl || 'https://libretranslate.com';\n    this.apiKey = options.apiKey;\n    this.timeout = options.timeout || 30000;\n  }\n\n  /**\n   * Translates text from source language to target language\n   */\n  async translate(\n    text: string,\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult> {\n    if (!isValidText(text)) {\n      throw new InvalidTextError('Text cannot be empty', 'libretranslate');\n    }\n\n    try {\n      const body: any = {\n        q: text,\n        target: targetLanguage,\n        format: 'text',\n      };\n\n      if (sourceLanguage) {\n        body.source = sourceLanguage;\n      } else {\n        body.source = 'auto';\n      }\n\n      if (this.apiKey) {\n        body.api_key = this.apiKey;\n      }\n\n      const response = await this.fetchLibreTranslate('/translate', body);\n\n      const data = response as LibreTranslateTranslateResponse;\n\n      return {\n        translatedText: data.translatedText,\n        sourceText: text,\n        sourceLanguage:\n          data.detectedLanguage?.language || sourceLanguage || 'unknown',\n        targetLanguage,\n        confidence: data.detectedLanguage?.confidence,\n        detectedSourceLanguage: !sourceLanguage,\n        raw: data,\n      };\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Detects the language of the provided text\n   */\n  async detectLanguage(text: string): Promise<LanguageDetectionResult> {\n    if (!isValidText(text)) {\n      throw new InvalidTextError('Text cannot be empty', 'libretranslate');\n    }\n\n    try {\n      const body: any = {\n        q: text,\n      };\n\n      if (this.apiKey) {\n        body.api_key = this.apiKey;\n      }\n\n      const response = await this.fetchLibreTranslate('/detect', body);\n\n      if (Array.isArray(response)) {\n        const detections = response as LibreTranslateDetectResponse[];\n\n        if (detections.length === 0) {\n          throw new TranslationError(\n            'No language detected',\n            'NO_DETECTION',\n            'libretranslate',\n          );\n        }\n\n        return {\n          language: detections[0].language,\n          confidence: detections[0].confidence,\n          alternatives: detections.slice(1).map((d) => ({\n            language: d.language,\n            confidence: d.confidence,\n          })),\n          raw: response,\n        };\n      }\n\n      throw new TranslationError(\n        'Invalid detection response',\n        'INVALID_RESPONSE',\n        'libretranslate',\n      );\n    } catch (error) {\n      if (error instanceof TranslationError) {\n        throw error;\n      }\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Gets the list of languages supported by this provider\n   */\n  async getSupportedLanguages(): Promise<SupportedLanguage[]> {\n    try {\n      const response = await this.fetchLibreTranslate(\n        '/languages',\n        undefined,\n        'GET',\n      );\n\n      if (Array.isArray(response)) {\n        const languages = response as LibreTranslateLanguage[];\n        return languages.map((lang) => ({\n          code: lang.code,\n          name: lang.name || getLanguageName(lang.code),\n        }));\n      }\n\n      throw new TranslationError(\n        'Invalid languages response',\n        'INVALID_RESPONSE',\n        'libretranslate',\n      );\n    } catch (error) {\n      if (error instanceof TranslationError) {\n        throw error;\n      }\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Translates multiple texts in a single batch operation\n   * Note: LibreTranslate doesn't have native batch support,\n   * so we translate texts sequentially\n   */\n  async translateBatch(\n    texts: string[],\n    targetLanguage: string,\n    sourceLanguage?: string,\n  ): Promise<TranslationResult[]> {\n    if (texts.length === 0) {\n      return [];\n    }\n\n    // Translate each text sequentially\n    const results: TranslationResult[] = [];\n    for (const text of texts) {\n      const result = await this.translate(text, targetLanguage, sourceLanguage);\n      results.push(result);\n    }\n\n    return results;\n  }\n\n  /**\n   * Makes an HTTP request to LibreTranslate API\n   */\n  private async fetchLibreTranslate(\n    endpoint: string,\n    body?: any,\n    method: 'GET' | 'POST' = 'POST',\n  ): Promise<any> {\n    const url = `${this.baseUrl}${endpoint}`;\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const options: RequestInit = {\n        method,\n        signal: controller.signal,\n      };\n\n      if (method === 'POST' && body) {\n        options.headers = {\n          'Content-Type': 'application/json',\n        };\n        options.body = JSON.stringify(body);\n      }\n\n      const response = await fetch(url, options);\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        if (response.status === 401 || response.status === 403) {\n          throw new AuthenticationError('libretranslate');\n        }\n\n        if (response.status === 400) {\n          const errorData = (await response.json().catch(() => ({}))) as any;\n          if (errorData.error?.includes('language')) {\n            throw new UnsupportedLanguageError(\n              body.source || body.target || 'unknown',\n              'libretranslate',\n            );\n          }\n        }\n\n        throw new TranslationError(\n          `HTTP ${response.status}: ${response.statusText}`,\n          'HTTP_ERROR',\n          'libretranslate',\n        );\n      }\n\n      return await response.json();\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (error instanceof TranslationError) {\n        throw error;\n      }\n\n      if ((error as Error).name === 'AbortError') {\n        throw new TranslationError(\n          'Request timeout',\n          'TIMEOUT',\n          'libretranslate',\n        );\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Maps LibreTranslate errors to standardized error types\n   */\n  private mapError(error: unknown): TranslationError {\n    if (error instanceof TranslationError) {\n      return error;\n    }\n\n    const err = error as any;\n    return new TranslationError(\n      err?.message || 'Translation failed',\n      err?.code || 'UNKNOWN_ERROR',\n      'libretranslate',\n    );\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.d.ts","sourceRoot":"","sources":["../../src/cli/claude-context.ts"],"names":[],"mappings":""}

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "translator";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/translator\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'translator';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/index.d.ts

@@ -0,0 +1,48 @@
+import { Translator, TranslatorOptions } from './shared/types';
+export * from './shared/types';
+export * from './shared/utils';
+/**
+ * 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');
+ * ```
+ */
+export declare function getTranslator(options?: Partial<TranslatorOptions>): Promise<Translator>;
+/** @internal */
+export declare const PACKAGE_VERSION_INITIALIZED = true;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAQV,UAAU,EACV,iBAAiB,EAClB,MAAM,gBAAgB,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AA4E/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,aAAa,CACjC,OAAO,GAAE,OAAO,CAAC,iBAAiB,CAAM,GACvC,OAAO,CAAC,UAAU,CAAC,CAkDrB;AAED,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,252 @@
+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"
+};
+function isValidLanguageCode(code) {
+  return code.length === 2 && /^[a-z]{2}$/.test(code);
+}
+function getLanguageName(code) {
+  return LANGUAGE_NAMES[code] || code;
+}
+function normalizeConfidence(score) {
+  if (score > 1 && score <= 100) {
+    return score / 100;
+  }
+  return Math.max(0, Math.min(1, score));
+}
+function isValidText(text) {
+  return typeof text === "string" && text.trim().length > 0;
+}
+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;
+    };
+  }
+}
+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 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

package/dist/index.js.map

@@ -0,0 +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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"}

package/dist/providers/deepl.d.ts

@@ -0,0 +1,41 @@
+import { DeepLOptions, LanguageDetectionResult, SupportedLanguage, TranslationProvider, TranslationResult } from '../shared/types';
+/**
+ * DeepL provider implementation with in-memory caching
+ */
+export declare class DeepLProvider implements TranslationProvider {
+    private client;
+    private timeout;
+    private cache;
+    constructor(options: DeepLOptions);
+    /**
+     * Initializes the memory cache for translation results
+     */
+    private initCache;
+    /**
+     * Generates a cache key for translation requests
+     */
+    private getCacheKey;
+    /**
+     * Translates text from source language to target language
+     */
+    translate(text: string, targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult>;
+    /**
+     * Detects the language of the provided text
+     * Note: DeepL doesn't have a dedicated language detection API,
+     * so we translate to English and use the detected source language
+     */
+    detectLanguage(text: string): Promise<LanguageDetectionResult>;
+    /**
+     * Gets the list of languages supported by this provider
+     */
+    getSupportedLanguages(): Promise<SupportedLanguage[]>;
+    /**
+     * Translates multiple texts in a single batch operation
+     */
+    translateBatch(texts: string[], targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult[]>;
+    /**
+     * Maps DeepL errors to standardized error types
+     */
+    private mapError;
+}
+//# sourceMappingURL=deepl.d.ts.map