@happyvertical/translator 0.80.0 → 0.80.2

package/dist/chunks/deepl-C9iR9zJ1.js

@@ -0,0 +1,164 @@
+import { AuthenticationError, InvalidTextError, QuotaExceededError, TranslationError, UnsupportedLanguageError, isValidText } from "../index.js";
+import { getCache } from "@happyvertical/cache";
+import * as deepl from "deepl-node";
+//#region src/providers/deepl.ts
+/**
+* DeepL provider implementation with in-memory caching
+*/
+var DeepLProvider = class {
+	client;
+	timeout;
+	cache = null;
+	constructor(options) {
+		this.client = new deepl.Translator(options.apiKey, { serverUrl: options.freeApi ? "https://api-free.deepl.com" : void 0 });
+		this.timeout = options.timeout || 3e4;
+		this.initCache();
+	}
+	/**
+	* Initializes the memory cache for translation results
+	*/
+	async initCache() {
+		try {
+			this.cache = await getCache({
+				provider: "memory",
+				namespace: "translator:deepl",
+				defaultTTL: 3600,
+				maxSize: 10 * 1024 * 1024,
+				maxEntries: 1e3,
+				evictionPolicy: "lru"
+			});
+		} catch (error) {
+			console.warn("Failed to initialize translation cache:", error);
+		}
+	}
+	/**
+	* Generates a cache key for translation requests
+	*/
+	getCacheKey(type, ...parts) {
+		return `${type}:${parts.join(":")}`;
+	}
+	/**
+	* Translates text from source language to target language
+	*/
+	async translate(text, targetLanguage, sourceLanguage) {
+		if (!isValidText(text)) throw new InvalidTextError("Text cannot be empty", "deepl");
+		const cacheKey = this.getCacheKey("translate", text, sourceLanguage || "auto", targetLanguage);
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const result = await this.client.translateText(text, sourceLanguage || null, targetLanguage);
+			const translationResult = {
+				translatedText: result.text,
+				sourceText: text,
+				sourceLanguage: result.detectedSourceLang.toLowerCase(),
+				targetLanguage: targetLanguage.toLowerCase(),
+				detectedSourceLanguage: !sourceLanguage,
+				raw: result
+			};
+			if (this.cache) await this.cache.set(cacheKey, translationResult);
+			return translationResult;
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* 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
+	*/
+	async detectLanguage(text) {
+		if (!isValidText(text)) throw new InvalidTextError("Text cannot be empty", "deepl");
+		const cacheKey = this.getCacheKey("detect", text);
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const result = await this.client.translateText(text, null, "en-US");
+			const detectionResult = {
+				language: result.detectedSourceLang.toLowerCase(),
+				confidence: 1,
+				raw: result
+			};
+			if (this.cache) await this.cache.set(cacheKey, detectionResult);
+			return detectionResult;
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Gets the list of languages supported by this provider
+	*/
+	async getSupportedLanguages() {
+		const cacheKey = this.getCacheKey("languages");
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const [sourceLanguages, targetLanguages] = await Promise.all([this.client.getSourceLanguages(), this.client.getTargetLanguages()]);
+			const languageMap = /* @__PURE__ */ new Map();
+			for (const lang of sourceLanguages) languageMap.set(lang.code.toLowerCase(), {
+				code: lang.code.toLowerCase(),
+				name: lang.name
+			});
+			for (const lang of targetLanguages) {
+				const code = lang.code.toLowerCase();
+				if (!languageMap.has(code)) languageMap.set(code, {
+					code,
+					name: lang.name
+				});
+			}
+			const result = Array.from(languageMap.values());
+			if (this.cache) await this.cache.set(cacheKey, result, 86400);
+			return result;
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Translates multiple texts in a single batch operation
+	*/
+	async translateBatch(texts, targetLanguage, sourceLanguage) {
+		if (texts.length === 0) return [];
+		try {
+			const results = await this.client.translateText(texts, sourceLanguage || null, targetLanguage);
+			const resultsArray = Array.isArray(results) ? results : [results];
+			return texts.map((text, index) => {
+				const result = resultsArray[index];
+				return {
+					translatedText: result.text,
+					sourceText: text,
+					sourceLanguage: result.detectedSourceLang.toLowerCase(),
+					targetLanguage: targetLanguage.toLowerCase(),
+					detectedSourceLanguage: !sourceLanguage,
+					raw: result
+				};
+			});
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Maps DeepL errors to standardized error types
+	*/
+	mapError(error) {
+		if (error instanceof deepl.DeepLError) {
+			if (error.message.includes("401") || error.message.includes("403")) return new AuthenticationError("deepl");
+			if (error.message.includes("429") || error.message.includes("quota")) return new QuotaExceededError("deepl");
+			if (error.message.includes("language") || error.message.includes("not supported")) {
+				const match = error.message.match(/language[:\s]+([a-z-]+)/i);
+				return new UnsupportedLanguageError(match ? match[1] : "unknown", "deepl");
+			}
+			return new TranslationError(error.message, "DEEPL_ERROR", "deepl");
+		}
+		const err = error;
+		return new TranslationError(err?.message || "Translation failed", err?.code || "UNKNOWN_ERROR", "deepl");
+	}
+};
+//#endregion
+export { DeepLProvider };
+
+//# sourceMappingURL=deepl-C9iR9zJ1.js.map

package/dist/chunks/deepl-C9iR9zJ1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepl-C9iR9zJ1.js","names":[],"sources":["../../src/providers/deepl.ts"],"sourcesContent":["/**\n * DeepL provider implementation\n */\n\nimport type { CacheAdapter } from '@happyvertical/cache';\nimport { getCache } from '@happyvertical/cache';\nimport * as deepl from 'deepl-node';\nimport type {\n  DeepLOptions,\n  LanguageDetectionResult,\n  SupportedLanguage,\n  TranslationProvider,\n  TranslationResult,\n} from '../shared/types';\nimport {\n  AuthenticationError,\n  InvalidTextError,\n  QuotaExceededError,\n  TranslationError,\n  UnsupportedLanguageError,\n} from '../shared/types';\nimport { isValidText } from '../shared/utils';\n\n/**\n * DeepL provider implementation with in-memory caching\n */\nexport class DeepLProvider implements TranslationProvider {\n  private client: deepl.Translator;\n  private timeout: number;\n  private cache: CacheAdapter | null = null;\n\n  constructor(options: DeepLOptions) {\n    this.client = new deepl.Translator(options.apiKey, {\n      serverUrl: options.freeApi ? 'https://api-free.deepl.com' : undefined,\n    });\n    this.timeout = options.timeout || 30000;\n\n    // Initialize memory cache asynchronously\n    this.initCache();\n  }\n\n  /**\n   * Initializes the memory cache for translation results\n   */\n  private async initCache(): Promise<void> {\n    try {\n      this.cache = await getCache({\n        provider: 'memory',\n        namespace: 'translator:deepl',\n        defaultTTL: 3600, // 1 hour cache\n        maxSize: 10 * 1024 * 1024, // 10MB\n        maxEntries: 1000,\n        evictionPolicy: 'lru',\n      });\n    } catch (error) {\n      // Cache initialization failure shouldn't break the provider\n      console.warn('Failed to initialize translation cache:', error);\n    }\n  }\n\n  /**\n   * Generates a cache key for translation requests\n   */\n  private getCacheKey(type: string, ...parts: string[]): string {\n    return `${type}:${parts.join(':')}`;\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', 'deepl');\n    }\n\n    // Check cache first\n    const cacheKey = this.getCacheKey(\n      'translate',\n      text,\n      sourceLanguage || 'auto',\n      targetLanguage,\n    );\n    if (this.cache) {\n      const cached = await this.cache.get<TranslationResult>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      const result = await this.client.translateText(\n        text,\n        (sourceLanguage as any) || null,\n        targetLanguage as any,\n      );\n\n      const translationResult: TranslationResult = {\n        translatedText: result.text,\n        sourceText: text,\n        sourceLanguage: result.detectedSourceLang.toLowerCase(),\n        targetLanguage: targetLanguage.toLowerCase(),\n        detectedSourceLanguage: !sourceLanguage,\n        raw: result,\n      };\n\n      // Cache the result\n      if (this.cache) {\n        await this.cache.set(cacheKey, translationResult);\n      }\n\n      return translationResult;\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Detects the language of the provided text\n   * Note: DeepL doesn't have a dedicated language detection API,\n   * so we translate to English and use the detected source language\n   */\n  async detectLanguage(text: string): Promise<LanguageDetectionResult> {\n    if (!isValidText(text)) {\n      throw new InvalidTextError('Text cannot be empty', 'deepl');\n    }\n\n    // Check cache first\n    const cacheKey = this.getCacheKey('detect', text);\n    if (this.cache) {\n      const cached = await this.cache.get<LanguageDetectionResult>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      // Translate to English to get source language detection\n      const result = await this.client.translateText(\n        text,\n        null,\n        'en-US' as any,\n      );\n\n      const detectionResult: LanguageDetectionResult = {\n        language: result.detectedSourceLang.toLowerCase(),\n        confidence: 1.0, // DeepL doesn't provide confidence scores\n        raw: result,\n      };\n\n      // Cache the result\n      if (this.cache) {\n        await this.cache.set(cacheKey, detectionResult);\n      }\n\n      return detectionResult;\n    } catch (error) {\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    // Check cache first (this data rarely changes)\n    const cacheKey = this.getCacheKey('languages');\n    if (this.cache) {\n      const cached = await this.cache.get<SupportedLanguage[]>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      const [sourceLanguages, targetLanguages] = await Promise.all([\n        this.client.getSourceLanguages(),\n        this.client.getTargetLanguages(),\n      ]);\n\n      // Combine source and target languages, removing duplicates\n      const languageMap = new Map<string, SupportedLanguage>();\n\n      for (const lang of sourceLanguages) {\n        languageMap.set(lang.code.toLowerCase(), {\n          code: lang.code.toLowerCase(),\n          name: lang.name,\n        });\n      }\n\n      for (const lang of targetLanguages) {\n        const code = lang.code.toLowerCase();\n        if (!languageMap.has(code)) {\n          languageMap.set(code, {\n            code,\n            name: lang.name,\n          });\n        }\n      }\n\n      const result = Array.from(languageMap.values());\n\n      // Cache for longer (24 hours) as language lists rarely change\n      if (this.cache) {\n        await this.cache.set(cacheKey, result, 86400);\n      }\n\n      return result;\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Translates multiple texts in a single batch operation\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    try {\n      const results = await this.client.translateText(\n        texts,\n        (sourceLanguage as any) || null,\n        targetLanguage as any,\n      );\n\n      const resultsArray = Array.isArray(results) ? results : [results];\n\n      return texts.map((text, index) => {\n        const result = resultsArray[index];\n        return {\n          translatedText: result.text,\n          sourceText: text,\n          sourceLanguage: result.detectedSourceLang.toLowerCase(),\n          targetLanguage: targetLanguage.toLowerCase(),\n          detectedSourceLanguage: !sourceLanguage,\n          raw: result,\n        };\n      });\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Maps DeepL errors to standardized error types\n   */\n  private mapError(error: unknown): TranslationError {\n    if (error instanceof deepl.DeepLError) {\n      if (error.message.includes('401') || error.message.includes('403')) {\n        return new AuthenticationError('deepl');\n      }\n\n      if (error.message.includes('429') || error.message.includes('quota')) {\n        return new QuotaExceededError('deepl');\n      }\n\n      if (\n        error.message.includes('language') ||\n        error.message.includes('not supported')\n      ) {\n        const match = error.message.match(/language[:\\s]+([a-z-]+)/i);\n        const language = match ? match[1] : 'unknown';\n        return new UnsupportedLanguageError(language, 'deepl');\n      }\n\n      return new TranslationError(error.message, 'DEEPL_ERROR', 'deepl');\n    }\n\n    const err = error as any;\n    return new TranslationError(\n      err?.message || 'Translation failed',\n      err?.code || 'UNKNOWN_ERROR',\n      'deepl',\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/chunks/google-jZMDn2Ru.js

@@ -0,0 +1,180 @@
+import { AuthenticationError, InvalidTextError, QuotaExceededError, TranslationError, UnsupportedLanguageError, getLanguageName, isValidText, normalizeConfidence } from "../index.js";
+import { getCache } from "@happyvertical/cache";
+import { v2 } from "@google-cloud/translate";
+//#region src/providers/google.ts
+/**
+* Google Translate provider implementation
+*/
+var { Translate } = v2;
+/**
+* Google Translate provider implementation with in-memory caching
+*/
+var GoogleTranslateProvider = class {
+	client;
+	timeout;
+	cache = null;
+	constructor(options) {
+		this.client = new Translate({
+			key: options.apiKey,
+			projectId: options.projectId
+		});
+		this.timeout = options.timeout || 3e4;
+		this.initCache();
+	}
+	/**
+	* Initializes the memory cache for translation results
+	*/
+	async initCache() {
+		try {
+			this.cache = await getCache({
+				provider: "memory",
+				namespace: "translator:google",
+				defaultTTL: 3600,
+				maxSize: 10 * 1024 * 1024,
+				maxEntries: 1e3,
+				evictionPolicy: "lru"
+			});
+		} catch (error) {
+			console.warn("Failed to initialize translation cache:", error);
+		}
+	}
+	/**
+	* Generates a cache key for translation requests
+	*/
+	getCacheKey(type, ...parts) {
+		return `${type}:${parts.join(":")}`;
+	}
+	/**
+	* Translates text from source language to target language
+	*/
+	async translate(text, targetLanguage, sourceLanguage) {
+		if (!isValidText(text)) throw new InvalidTextError("Text cannot be empty", "google");
+		const cacheKey = this.getCacheKey("translate", text, sourceLanguage || "auto", targetLanguage);
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const [translation] = await this.client.translate(text, {
+				from: sourceLanguage,
+				to: targetLanguage
+			});
+			const detectedSourceLanguage = !sourceLanguage;
+			let actualSourceLanguage = sourceLanguage;
+			if (!actualSourceLanguage) {
+				const [detection] = await this.client.detect(text);
+				actualSourceLanguage = Array.isArray(detection) ? detection[0].language : detection.language;
+			}
+			const result = {
+				translatedText: translation,
+				sourceText: text,
+				sourceLanguage: actualSourceLanguage || "unknown",
+				targetLanguage,
+				detectedSourceLanguage,
+				raw: translation
+			};
+			if (this.cache) await this.cache.set(cacheKey, result);
+			return result;
+		} 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", "google");
+		const cacheKey = this.getCacheKey("detect", text);
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const [detections] = await this.client.detect(text);
+			const detectionsArray = Array.isArray(detections) ? detections : [detections];
+			if (detectionsArray.length === 0) throw new TranslationError("No language detected", "NO_DETECTION", "google");
+			const primary = detectionsArray[0];
+			const result = {
+				language: primary.language,
+				confidence: normalizeConfidence(primary.confidence || 0),
+				alternatives: detectionsArray.slice(1).map((d) => ({
+					language: d.language,
+					confidence: normalizeConfidence(d.confidence || 0)
+				})),
+				raw: detections
+			};
+			if (this.cache) await this.cache.set(cacheKey, result);
+			return result;
+		} catch (error) {
+			if (error instanceof TranslationError) throw error;
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Gets the list of languages supported by this provider
+	*/
+	async getSupportedLanguages() {
+		const cacheKey = this.getCacheKey("languages");
+		if (this.cache) {
+			const cached = await this.cache.get(cacheKey);
+			if (cached) return cached;
+		}
+		try {
+			const [languages] = await this.client.getLanguages();
+			const result = languages.map((lang) => ({
+				code: lang.code,
+				name: lang.name || getLanguageName(lang.code)
+			}));
+			if (this.cache) await this.cache.set(cacheKey, result, 86400);
+			return result;
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Translates multiple texts in a single batch operation
+	*/
+	async translateBatch(texts, targetLanguage, sourceLanguage) {
+		if (texts.length === 0) return [];
+		try {
+			const [translations] = await this.client.translate(texts, {
+				from: sourceLanguage,
+				to: targetLanguage
+			});
+			const translationsArray = Array.isArray(translations) ? translations : [translations];
+			const detectedSourceLanguage = !sourceLanguage;
+			let actualSourceLanguage = sourceLanguage;
+			if (!actualSourceLanguage && texts.length > 0) {
+				const [detection] = await this.client.detect(texts[0]);
+				actualSourceLanguage = Array.isArray(detection) ? detection[0].language : detection.language;
+			}
+			return texts.map((text, index) => ({
+				translatedText: translationsArray[index] || text,
+				sourceText: text,
+				sourceLanguage: actualSourceLanguage || "unknown",
+				targetLanguage,
+				detectedSourceLanguage,
+				raw: translationsArray[index]
+			}));
+		} catch (error) {
+			throw this.mapError(error);
+		}
+	}
+	/**
+	* Maps Google Translate errors to standardized error types
+	*/
+	mapError(error) {
+		const err = error;
+		if (err.code === 403 || err.code === 401) return new AuthenticationError("google");
+		if (err.code === 429) return new QuotaExceededError("google");
+		if (err.code === 400 && err.message?.includes("language")) {
+			const match = err.message.match(/language[:\s]+([a-z-]+)/i);
+			return new UnsupportedLanguageError(match ? match[1] : "unknown", "google");
+		}
+		return new TranslationError(err.message || "Translation failed", err.code || "UNKNOWN_ERROR", "google");
+	}
+};
+//#endregion
+export { GoogleTranslateProvider };
+
+//# sourceMappingURL=google-jZMDn2Ru.js.map

package/dist/chunks/google-jZMDn2Ru.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-jZMDn2Ru.js","names":[],"sources":["../../src/providers/google.ts"],"sourcesContent":["/**\n * Google Translate provider implementation\n */\n\nimport { v2 } from '@google-cloud/translate';\nimport type { CacheAdapter } from '@happyvertical/cache';\nimport { getCache } from '@happyvertical/cache';\nimport type {\n  GoogleTranslateOptions,\n  LanguageDetectionResult,\n  SupportedLanguage,\n  TranslationProvider,\n  TranslationResult,\n} from '../shared/types';\nimport {\n  AuthenticationError,\n  InvalidTextError,\n  QuotaExceededError,\n  TranslationError,\n  UnsupportedLanguageError,\n} from '../shared/types';\nimport {\n  getLanguageName,\n  isValidText,\n  normalizeConfidence,\n} from '../shared/utils';\n\nconst { Translate } = v2;\n\n/**\n * Google Translate provider implementation with in-memory caching\n */\nexport class GoogleTranslateProvider implements TranslationProvider {\n  private client: InstanceType<typeof Translate>;\n  private timeout: number;\n  private cache: CacheAdapter | null = null;\n\n  constructor(options: GoogleTranslateOptions) {\n    this.client = new Translate({\n      key: options.apiKey,\n      projectId: options.projectId,\n    });\n    this.timeout = options.timeout || 30000;\n\n    // Initialize memory cache asynchronously\n    this.initCache();\n  }\n\n  /**\n   * Initializes the memory cache for translation results\n   */\n  private async initCache(): Promise<void> {\n    try {\n      this.cache = await getCache({\n        provider: 'memory',\n        namespace: 'translator:google',\n        defaultTTL: 3600, // 1 hour cache\n        maxSize: 10 * 1024 * 1024, // 10MB\n        maxEntries: 1000,\n        evictionPolicy: 'lru',\n      });\n    } catch (error) {\n      // Cache initialization failure shouldn't break the provider\n      console.warn('Failed to initialize translation cache:', error);\n    }\n  }\n\n  /**\n   * Generates a cache key for translation requests\n   */\n  private getCacheKey(type: string, ...parts: string[]): string {\n    return `${type}:${parts.join(':')}`;\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', 'google');\n    }\n\n    // Check cache first\n    const cacheKey = this.getCacheKey(\n      'translate',\n      text,\n      sourceLanguage || 'auto',\n      targetLanguage,\n    );\n    if (this.cache) {\n      const cached = await this.cache.get<TranslationResult>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      const [translation] = await this.client.translate(text, {\n        from: sourceLanguage,\n        to: targetLanguage,\n      });\n\n      // Detect if source language was auto-detected\n      const detectedSourceLanguage = !sourceLanguage;\n\n      // Get detected language if not provided\n      let actualSourceLanguage = sourceLanguage;\n      if (!actualSourceLanguage) {\n        const [detection] = await this.client.detect(text);\n        actualSourceLanguage = Array.isArray(detection)\n          ? detection[0].language\n          : detection.language;\n      }\n\n      const result: TranslationResult = {\n        translatedText: translation,\n        sourceText: text,\n        sourceLanguage: actualSourceLanguage || 'unknown',\n        targetLanguage,\n        detectedSourceLanguage,\n        raw: translation,\n      };\n\n      // Cache the result\n      if (this.cache) {\n        await this.cache.set(cacheKey, result);\n      }\n\n      return result;\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', 'google');\n    }\n\n    // Check cache first\n    const cacheKey = this.getCacheKey('detect', text);\n    if (this.cache) {\n      const cached = await this.cache.get<LanguageDetectionResult>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      const [detections] = await this.client.detect(text);\n      const detectionsArray = Array.isArray(detections)\n        ? detections\n        : [detections];\n\n      if (detectionsArray.length === 0) {\n        throw new TranslationError(\n          'No language detected',\n          'NO_DETECTION',\n          'google',\n        );\n      }\n\n      const primary = detectionsArray[0];\n\n      const result: LanguageDetectionResult = {\n        language: primary.language,\n        confidence: normalizeConfidence(primary.confidence || 0),\n        alternatives: detectionsArray.slice(1).map((d) => ({\n          language: d.language,\n          confidence: normalizeConfidence(d.confidence || 0),\n        })),\n        raw: detections,\n      };\n\n      // Cache the result\n      if (this.cache) {\n        await this.cache.set(cacheKey, result);\n      }\n\n      return result;\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    // Check cache first (this data rarely changes)\n    const cacheKey = this.getCacheKey('languages');\n    if (this.cache) {\n      const cached = await this.cache.get<SupportedLanguage[]>(cacheKey);\n      if (cached) {\n        return cached;\n      }\n    }\n\n    try {\n      const [languages] = await this.client.getLanguages();\n\n      const result = languages.map((lang) => ({\n        code: lang.code,\n        name: lang.name || getLanguageName(lang.code),\n      }));\n\n      // Cache for longer (24 hours) as language lists rarely change\n      if (this.cache) {\n        await this.cache.set(cacheKey, result, 86400);\n      }\n\n      return result;\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Translates multiple texts in a single batch operation\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    try {\n      const [translations] = await this.client.translate(texts, {\n        from: sourceLanguage,\n        to: targetLanguage,\n      });\n\n      const translationsArray = Array.isArray(translations)\n        ? translations\n        : [translations];\n\n      const detectedSourceLanguage = !sourceLanguage;\n      let actualSourceLanguage = sourceLanguage;\n\n      // Detect source language for first text if not provided\n      if (!actualSourceLanguage && texts.length > 0) {\n        const [detection] = await this.client.detect(texts[0]);\n        actualSourceLanguage = Array.isArray(detection)\n          ? detection[0].language\n          : detection.language;\n      }\n\n      return texts.map((text, index) => ({\n        translatedText: translationsArray[index] || text,\n        sourceText: text,\n        sourceLanguage: actualSourceLanguage || 'unknown',\n        targetLanguage,\n        detectedSourceLanguage,\n        raw: translationsArray[index],\n      }));\n    } catch (error) {\n      throw this.mapError(error);\n    }\n  }\n\n  /**\n   * Maps Google Translate errors to standardized error types\n   */\n  private mapError(error: unknown): TranslationError {\n    const err = error as any;\n\n    // Check for common error codes\n    if (err.code === 403 || err.code === 401) {\n      return new AuthenticationError('google');\n    }\n\n    if (err.code === 429) {\n      return new QuotaExceededError('google');\n    }\n\n    if (err.code === 400 && err.message?.includes('language')) {\n      const match = err.message.match(/language[:\\s]+([a-z-]+)/i);\n      const language = match ? match[1] : 'unknown';\n      return new UnsupportedLanguageError(language, 'google');\n    }\n\n    return new TranslationError(\n      err.message || 'Translation failed',\n      err.code || 'UNKNOWN_ERROR',\n      'google',\n    );\n  }\n}\n"],"mappings":"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"}

package/dist/chunks/libretranslate-oJr-l5MM.js

@@ -0,0 +1,146 @@
+import { AuthenticationError, InvalidTextError, TranslationError, UnsupportedLanguageError, getLanguageName, isValidText } from "../index.js";
+//#region src/providers/libretranslate.ts
+/**
+* LibreTranslate provider implementation
+*/
+var LibreTranslateProvider = class {
+	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 data = await this.fetchLibreTranslate("/translate", body);
+			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)) return response.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) {
+					if ((await response.json().catch(() => ({}))).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");
+	}
+};
+//#endregion
+export { LibreTranslateProvider };
+
+//# sourceMappingURL=libretranslate-oJr-l5MM.js.map

package/dist/chunks/libretranslate-oJr-l5MM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"libretranslate-oJr-l5MM.js","names":[],"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"],"mappings":";;;;;AA2CA,IAAa,yBAAb,MAAmE;CACjE;CACA;CACA;CAEA,YAAY,SAAgC;EAC1C,KAAK,UAAU,QAAQ,UAAU;EACjC,KAAK,SAAS,QAAQ;EACtB,KAAK,UAAU,QAAQ,WAAW;CACpC;;;;CAKA,MAAM,UACJ,MACA,gBACA,gBAC4B;EAC5B,IAAI,CAAC,YAAY,IAAI,GACnB,MAAM,IAAI,iBAAiB,wBAAwB,gBAAgB;EAGrE,IAAI;GACF,MAAM,OAAY;IAChB,GAAG;IACH,QAAQ;IACR,QAAQ;GACV;GAEA,IAAI,gBACF,KAAK,SAAS;QAEd,KAAK,SAAS;GAGhB,IAAI,KAAK,QACP,KAAK,UAAU,KAAK;GAKtB,MAAM,OAAO,MAFU,KAAK,oBAAoB,cAAc,IAAI;GAIlE,OAAO;IACL,gBAAgB,KAAK;IACrB,YAAY;IACZ,gBACE,KAAK,kBAAkB,YAAY,kBAAkB;IACvD;IACA,YAAY,KAAK,kBAAkB;IACnC,wBAAwB,CAAC;IACzB,KAAK;GACP;EACF,SAAS,OAAO;GACd,MAAM,KAAK,SAAS,KAAK;EAC3B;CACF;;;;CAKA,MAAM,eAAe,MAAgD;EACnE,IAAI,CAAC,YAAY,IAAI,GACnB,MAAM,IAAI,iBAAiB,wBAAwB,gBAAgB;EAGrE,IAAI;GACF,MAAM,OAAY,EAChB,GAAG,KACL;GAEA,IAAI,KAAK,QACP,KAAK,UAAU,KAAK;GAGtB,MAAM,WAAW,MAAM,KAAK,oBAAoB,WAAW,IAAI;GAE/D,IAAI,MAAM,QAAQ,QAAQ,GAAG;IAC3B,MAAM,aAAa;IAEnB,IAAI,WAAW,WAAW,GACxB,MAAM,IAAI,iBACR,wBACA,gBACA,gBACF;IAGF,OAAO;KACL,UAAU,WAAW,EAAE,CAAC;KACxB,YAAY,WAAW,EAAE,CAAC;KAC1B,cAAc,WAAW,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO;MAC5C,UAAU,EAAE;MACZ,YAAY,EAAE;KAChB,EAAE;KACF,KAAK;IACP;GACF;GAEA,MAAM,IAAI,iBACR,8BACA,oBACA,gBACF;EACF,SAAS,OAAO;GACd,IAAI,iBAAiB,kBACnB,MAAM;GAER,MAAM,KAAK,SAAS,KAAK;EAC3B;CACF;;;;CAKA,MAAM,wBAAsD;EAC1D,IAAI;GACF,MAAM,WAAW,MAAM,KAAK,oBAC1B,cACA,KAAA,GACA,KACF;GAEA,IAAI,MAAM,QAAQ,QAAQ,GAExB,OAAO,SAAU,KAAK,UAAU;IAC9B,MAAM,KAAK;IACX,MAAM,KAAK,QAAQ,gBAAgB,KAAK,IAAI;GAC9C,EAAE;GAGJ,MAAM,IAAI,iBACR,8BACA,oBACA,gBACF;EACF,SAAS,OAAO;GACd,IAAI,iBAAiB,kBACnB,MAAM;GAER,MAAM,KAAK,SAAS,KAAK;EAC3B;CACF;;;;;;CAOA,MAAM,eACJ,OACA,gBACA,gBAC8B;EAC9B,IAAI,MAAM,WAAW,GACnB,OAAO,CAAC;EAIV,MAAM,UAA+B,CAAC;EACtC,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,SAAS,MAAM,KAAK,UAAU,MAAM,gBAAgB,cAAc;GACxE,QAAQ,KAAK,MAAM;EACrB;EAEA,OAAO;CACT;;;;CAKA,MAAc,oBACZ,UACA,MACA,SAAyB,QACX;EACd,MAAM,MAAM,GAAG,KAAK,UAAU;EAE9B,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,YAAY,iBAAiB,WAAW,MAAM,GAAG,KAAK,OAAO;EAEnE,IAAI;GACF,MAAM,UAAuB;IAC3B;IACA,QAAQ,WAAW;GACrB;GAEA,IAAI,WAAW,UAAU,MAAM;IAC7B,QAAQ,UAAU,EAChB,gBAAgB,mBAClB;IACA,QAAQ,OAAO,KAAK,UAAU,IAAI;GACpC;GAEA,MAAM,WAAW,MAAM,MAAM,KAAK,OAAO;GAEzC,aAAa,SAAS;GAEtB,IAAI,CAAC,SAAS,IAAI;IAChB,IAAI,SAAS,WAAW,OAAO,SAAS,WAAW,KACjD,MAAM,IAAI,oBAAoB,gBAAgB;IAGhD,IAAI,SAAS,WAAW;UAElB,MADqB,SAAS,KAAK,CAAC,CAAC,aAAa,CAAC,EAAE,EAAA,CAC3C,OAAO,SAAS,UAAU,GACtC,MAAM,IAAI,yBACR,KAAK,UAAU,KAAK,UAAU,WAC9B,gBACF;IAAA;IAIJ,MAAM,IAAI,iBACR,QAAQ,SAAS,OAAO,IAAI,SAAS,cACrC,cACA,gBACF;GACF;GAEA,OAAO,MAAM,SAAS,KAAK;EAC7B,SAAS,OAAO;GACd,aAAa,SAAS;GAEtB,IAAI,iBAAiB,kBACnB,MAAM;GAGR,IAAK,MAAgB,SAAS,cAC5B,MAAM,IAAI,iBACR,mBACA,WACA,gBACF;GAGF,MAAM;EACR;CACF;;;;CAKA,SAAiB,OAAkC;EACjD,IAAI,iBAAiB,kBACnB,OAAO;EAGT,MAAM,MAAM;EACZ,OAAO,IAAI,iBACT,KAAK,WAAW,sBAChB,KAAK,QAAQ,iBACb,gBACF;CACF;AACF"}

package/dist/cli/claude-context.js

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
-import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { copyFileSync, existsSync, mkdirSync } 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`));
-}
+//#region src/cli/claude-context.ts
+/**
+* CLI script to install agent context for @happyvertical/translator
+* Run the published context installer binary for this package.
+*/
+var pkgRoot = join(dirname(fileURLToPath(import.meta.url)), "../..");
+var targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
+var pkgName = "translator";
+var agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+var 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
+//#endregion
+
+//# sourceMappingURL=claude-context.js.map

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

@@ -1 +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;"}
+{"version":3,"file":"claude-context.js","names":[],"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"],"mappings":";;;;;;;;;AAUA,IAAM,UAAU,KADA,QAAQ,cAAc,OAAO,KAAK,GAAG,CAChC,GAAS,OAAO;AACrC,IAAM,YAAY,KAAK,QAAQ,IAAI,GAAG,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GACvB,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAG1C,IAAM,UAAU;AAChB,IAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,IAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GACvB,aAAa,YAAY,KAAK,WAAW,QAAQ,QAAQ,IAAI,CAAC;AAGhE,IAAI,WAAW,OAAO,GACpB,aAAa,SAAS,KAAK,WAAW,QAAQ,QAAQ,WAAW,CAAC;AAGpE,QAAQ,IAAI,8BAA8B,QAAQ,qBAAqB"}