@happyvertical/translator 0.74.8

package/dist/providers/deepl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepl.d.ts","sourceRoot":"","sources":["../../src/providers/deepl.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAUzB;;GAEG;AACH,qBAAa,aAAc,YAAW,mBAAmB;IACvD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA6B;gBAE9B,OAAO,EAAE,YAAY;IAUjC;;OAEG;YACW,SAAS;IAgBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,CAAC;IA8C7B;;;;OAIG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAuCpE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAiD3D;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA8B/B;;OAEG;IACH,OAAO,CAAC,QAAQ;CA6BjB"}

package/dist/providers/google.d.ts

@@ -0,0 +1,39 @@
+import { GoogleTranslateOptions, LanguageDetectionResult, SupportedLanguage, TranslationProvider, TranslationResult } from '../shared/types';
+/**
+ * Google Translate provider implementation with in-memory caching
+ */
+export declare class GoogleTranslateProvider implements TranslationProvider {
+    private client;
+    private timeout;
+    private cache;
+    constructor(options: GoogleTranslateOptions);
+    /**
+     * 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
+     */
+    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 Google Translate errors to standardized error types
+     */
+    private mapError;
+}
+//# sourceMappingURL=google.d.ts.map

package/dist/providers/google.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.d.ts","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAgBzB;;GAEG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAA6B;gBAE9B,OAAO,EAAE,sBAAsB;IAW3C;;OAEG;YACW,SAAS;IAgBvB;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAyD7B;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAsDpE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B3D;;OAEG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAuC/B;;OAEG;IACH,OAAO,CAAC,QAAQ;CAwBjB"}

package/dist/providers/libretranslate.d.ts

@@ -0,0 +1,37 @@
+import { LanguageDetectionResult, LibreTranslateOptions, SupportedLanguage, TranslationProvider, TranslationResult } from '../shared/types';
+/**
+ * LibreTranslate provider implementation
+ */
+export declare class LibreTranslateProvider implements TranslationProvider {
+    private baseUrl;
+    private apiKey?;
+    private timeout;
+    constructor(options: LibreTranslateOptions);
+    /**
+     * Translates text from source language to target language
+     */
+    translate(text: string, targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult>;
+    /**
+     * Detects the language of the provided text
+     */
+    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
+     * Note: LibreTranslate doesn't have native batch support,
+     * so we translate texts sequentially
+     */
+    translateBatch(texts: string[], targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult[]>;
+    /**
+     * Makes an HTTP request to LibreTranslate API
+     */
+    private fetchLibreTranslate;
+    /**
+     * Maps LibreTranslate errors to standardized error types
+     */
+    private mapError;
+}
+//# sourceMappingURL=libretranslate.d.ts.map

package/dist/providers/libretranslate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"libretranslate.d.ts","sourceRoot":"","sources":["../../src/providers/libretranslate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AA8BzB;;GAEG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAChE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,qBAAqB;IAM1C;;OAEG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,CAAC;IAyC7B;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAmDpE;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B3D;;;;OAIG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAe/B;;OAEG;YACW,mBAAmB;IAqEjC;;OAEG;IACH,OAAO,CAAC,QAAQ;CAYjB"}

package/dist/shared/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Core types and interfaces for the Translator library
+ */
+/**
+ * Standardized translation result
+ */
+export interface TranslationResult {
+    /**
+     * The translated text
+     */
+    translatedText: string;
+    /**
+     * The original source text
+     */
+    sourceText: string;
+    /**
+     * The detected or specified source language (ISO 639-1 code)
+     */
+    sourceLanguage: string;
+    /**
+     * The target language (ISO 639-1 code)
+     */
+    targetLanguage: string;
+    /**
+     * Confidence score for the translation (0-1), if available
+     */
+    confidence?: number;
+    /**
+     * Alternative translations, if available
+     */
+    alternatives?: string[];
+    /**
+     * Whether the source language was automatically detected
+     */
+    detectedSourceLanguage: boolean;
+    /**
+     * The original, raw response from the provider
+     */
+    raw: any;
+}
+/**
+ * Language detection result
+ */
+export interface LanguageDetectionResult {
+    /**
+     * The detected language (ISO 639-1 code)
+     */
+    language: string;
+    /**
+     * Confidence score for the detection (0-1)
+     */
+    confidence: number;
+    /**
+     * Alternative detected languages with confidence scores, if available
+     */
+    alternatives?: Array<{
+        language: string;
+        confidence: number;
+    }>;
+    /**
+     * The original, raw response from the provider
+     */
+    raw: any;
+}
+/**
+ * Supported language information
+ */
+export interface SupportedLanguage {
+    /**
+     * ISO 639-1 language code (e.g., 'en', 'es', 'fr')
+     */
+    code: string;
+    /**
+     * Human-readable language name in English
+     */
+    name: string;
+    /**
+     * Native name of the language (optional)
+     */
+    nativeName?: string;
+}
+/**
+ * Translation provider interface - all providers must implement this
+ */
+export interface TranslationProvider {
+    /**
+     * Translates text from source language to target language
+     * @param text The text to translate
+     * @param targetLanguage The target language code (ISO 639-1)
+     * @param sourceLanguage Optional source language code. If not provided, auto-detect
+     * @returns A promise that resolves to a TranslationResult object
+     */
+    translate(text: string, targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult>;
+    /**
+     * Detects the language of the provided text
+     * @param text The text to analyze
+     * @returns A promise that resolves to a LanguageDetectionResult object
+     */
+    detectLanguage(text: string): Promise<LanguageDetectionResult>;
+    /**
+     * Gets the list of languages supported by this provider
+     * @returns A promise that resolves to an array of SupportedLanguage objects
+     */
+    getSupportedLanguages(): Promise<SupportedLanguage[]>;
+    /**
+     * Translates multiple texts in a single batch operation
+     * @param texts Array of texts to translate
+     * @param targetLanguage The target language code (ISO 639-1)
+     * @param sourceLanguage Optional source language code. If not provided, auto-detect
+     * @returns A promise that resolves to an array of TranslationResult objects
+     */
+    translateBatch(texts: string[], targetLanguage: string, sourceLanguage?: string): Promise<TranslationResult[]>;
+}
+/**
+ * Translator interface - extends provider interface with convenience methods
+ */
+export interface Translator extends TranslationProvider {
+    /**
+     * Creates a pre-configured translation function for repeated translations
+     * @param sourceLanguage Optional source language code (ISO 639-1). If undefined, auto-detects
+     * @param targetLanguage Optional target language code (ISO 639-1). Defaults to 'en'
+     * @returns A function that translates text with the pre-configured languages
+     */
+    templateFunction(sourceLanguage?: string, targetLanguage?: string): (text: string) => Promise<string>;
+}
+/**
+ * Base configuration options for all providers
+ */
+export interface BaseTranslatorOptions {
+    /**
+     * Request timeout in milliseconds
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retries for failed requests
+     */
+    maxRetries?: number;
+}
+/**
+ * Google Translate provider options
+ */
+export interface GoogleTranslateOptions extends BaseTranslatorOptions {
+    provider: 'google';
+    /**
+     * Google Cloud API key or credentials
+     */
+    apiKey: string;
+    /**
+     * Optional Google Cloud project ID
+     */
+    projectId?: string;
+}
+/**
+ * DeepL provider options
+ */
+export interface DeepLOptions extends BaseTranslatorOptions {
+    provider: 'deepl';
+    /**
+     * DeepL API key
+     */
+    apiKey: string;
+    /**
+     * Whether to use free or pro API endpoint (default: false = pro)
+     */
+    freeApi?: boolean;
+}
+/**
+ * LibreTranslate provider options
+ */
+export interface LibreTranslateOptions extends BaseTranslatorOptions {
+    provider: 'libretranslate';
+    /**
+     * Custom instance URL (default: https://libretranslate.com)
+     */
+    apiUrl?: string;
+    /**
+     * Optional API key for some instances
+     */
+    apiKey?: string;
+}
+/**
+ * Union type for all provider options
+ */
+export type TranslatorOptions = GoogleTranslateOptions | DeepLOptions | LibreTranslateOptions;
+/**
+ * Base error class for translation operations
+ *
+ * @param message - Human-readable error description
+ * @param code - Machine-readable error code (e.g., 'QUOTA_EXCEEDED', 'AUTH_ERROR', 'TIMEOUT')
+ * @param provider - The provider that produced the error (e.g., 'google', 'deepl', 'libretranslate')
+ */
+export declare class TranslationError extends Error {
+    code: string;
+    provider?: string | undefined;
+    constructor(message: string, code: string, provider?: string | undefined);
+}
+/**
+ * Thrown when a requested language code is not supported by the provider
+ *
+ * @param language - The unsupported ISO 639-1 language code
+ * @param provider - The provider that rejected the language
+ */
+export declare class UnsupportedLanguageError extends TranslationError {
+    constructor(language: string, provider?: string);
+}
+/**
+ * Thrown when the provider's translation quota or rate limit has been exceeded
+ *
+ * @param provider - The provider that reported the quota limit
+ */
+export declare class QuotaExceededError extends TranslationError {
+    constructor(provider?: string);
+}
+/**
+ * Thrown when the provider rejects the API key or credentials
+ *
+ * @param provider - The provider that rejected authentication
+ */
+export declare class AuthenticationError extends TranslationError {
+    constructor(provider?: string);
+}
+/**
+ * Thrown when the input text is empty or otherwise invalid for translation
+ *
+ * @param reason - Description of why the text is invalid
+ * @param provider - The provider that rejected the text
+ */
+export declare class InvalidTextError extends TranslationError {
+    constructor(reason: string, provider?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/shared/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/shared/types.ts"],"names":[],"mappings":"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"}

package/dist/shared/utils.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Utility functions for translation operations
+ */
+/**
+ * Common ISO 639-1 language codes and their names
+ */
+export declare const LANGUAGE_NAMES: Record<string, string>;
+/**
+ * Validates an ISO 639-1 language code
+ * @param code Language code to validate
+ * @returns True if valid
+ */
+export declare function isValidLanguageCode(code: string): boolean;
+/**
+ * Gets the language name from a language code
+ * @param code ISO 639-1 language code
+ * @returns Language name or the code if not found
+ */
+export declare function getLanguageName(code: string): string;
+/**
+ * Normalizes a confidence score to 0-1 range
+ * @param score Confidence score (may be 0-1 or 0-100)
+ * @returns Normalized score between 0 and 1
+ */
+export declare function normalizeConfidence(score: number): number;
+/**
+ * Validates that text is not empty
+ * @param text Text to validate
+ * @returns True if text is valid
+ */
+export declare function isValidText(text: string): boolean;
+/**
+ * Truncates text to a maximum length
+ * @param text Text to truncate
+ * @param maxLength Maximum length
+ * @returns Truncated text
+ */
+export declare function truncateText(text: string, maxLength: number): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/shared/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAyGjD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKpE"}

package/metadata.json

@@ -0,0 +1,32 @@
+{
+  "name": "@happyvertical/translator",
+  "path": "packages/translator",
+  "position": {
+    "index": 27,
+    "count": 30
+  },
+  "description": "Standardized translation interface supporting Google Translate, DeepL, and LibreTranslate",
+  "provides": [
+    "Standardized translation interface supporting Google Translate, DeepL, and LibreTranslate"
+  ],
+  "implements": [],
+  "requires": {
+    "workspace": [
+      "@happyvertical/cache",
+      "@happyvertical/utils"
+    ],
+    "externalHappyVertical": [],
+    "external": [
+      "@google-cloud/translate",
+      "deepl-node"
+    ]
+  },
+  "dependents": [],
+  "stability": {
+    "level": "stable",
+    "reason": "Primary package surface is described as implemented and production-oriented."
+  },
+  "keywords": [
+    "translator"
+  ]
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@happyvertical/translator",
+  "version": "0.74.8",
+  "description": "Standardized translation interface supporting Google Translate, DeepL, and LibreTranslate",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "bin": {
+    "have-translator-context": "./dist/cli/claude-context.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "AGENT.md",
+    "metadata.json"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/happyvertical/sdk.git",
+    "directory": "packages/translator"
+  },
+  "bugs": {
+    "url": "https://github.com/happyvertical/sdk/issues"
+  },
+  "homepage": "https://github.com/happyvertical/sdk/tree/main/packages/translator#readme",
+  "keywords": [
+    "translation",
+    "i18n",
+    "google-translate",
+    "deepl",
+    "libretranslate",
+    "language-detection"
+  ],
+  "author": "willgriffin@gmail.com",
+  "license": "ISC",
+  "dependencies": {
+    "@google-cloud/translate": "^9.3.0",
+    "deepl-node": "^1.26.0",
+    "@happyvertical/cache": "0.74.8",
+    "@happyvertical/utils": "0.74.8"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.10",
+    "typescript": "^5.9.3",
+    "vite": "7.3.2",
+    "vite-plugin-dts": "4.5.4",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "test": "npx vitest run",
+    "test:watch": "npx vitest",
+    "build": "vite build",
+    "build:watch": "vite build --watch",
+    "docs": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules",
+    "docs:watch": "typedoc --plugin typedoc-plugin-markdown --out docs --entryPoints ./src/index.ts --tsconfig ./tsconfig.json --excludePrivate --excludeInternal --hideGenerator --fileExtension .md --readme none --categorizeByGroup false --includeVersion false --hidePageHeader --hidePageTitle false --outputFileStrategy modules --watch",
+    "clean": "rm -rf dist docs *.tsbuildinfo",
+    "dev": "npm run build:watch & npm run test:watch"
+  }
+}