@happyvertical/translator 0.79.0 → 0.80.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/metadata.json CHANGED
@@ -2,8 +2,8 @@
2
2
  "name": "@happyvertical/translator",
3
3
  "path": "packages/translator",
4
4
  "position": {
5
- "index": 28,
6
- "count": 31
5
+ "index": 29,
6
+ "count": 32
7
7
  },
8
8
  "description": "Standardized translation interface supporting Google Translate, DeepL, and LibreTranslate",
9
9
  "provides": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@happyvertical/translator",
3
- "version": "0.79.0",
3
+ "version": "0.80.1",
4
4
  "description": "Standardized translation interface supporting Google Translate, DeepL, and LibreTranslate",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -47,15 +47,15 @@
47
47
  "dependencies": {
48
48
  "@google-cloud/translate": "^9.3.0",
49
49
  "deepl-node": "^1.26.0",
50
- "@happyvertical/cache": "0.79.0",
51
- "@happyvertical/utils": "0.79.0"
50
+ "@happyvertical/cache": "0.80.1",
51
+ "@happyvertical/utils": "0.80.1"
52
52
  },
53
53
  "devDependencies": {
54
54
  "@types/node": "25.0.10",
55
- "typescript": "^5.9.3",
56
- "vite": "7.3.2",
55
+ "typescript": "5.9.3",
56
+ "vite": "8.1.4",
57
57
  "vite-plugin-dts": "4.5.4",
58
- "vitest": "^4.1.5"
58
+ "vitest": "4.1.10"
59
59
  },
60
60
  "scripts": {
61
61
  "test": "vitest --config ../../vitest.package.config.ts run",
@@ -1,216 +0,0 @@
1
- import { getCache } from "@happyvertical/cache";
2
- import * as deepl from "deepl-node";
3
- import { isValidText, InvalidTextError, AuthenticationError, QuotaExceededError, UnsupportedLanguageError, TranslationError } from "../index.js";
4
- class DeepLProvider {
5
- client;
6
- timeout;
7
- cache = null;
8
- constructor(options) {
9
- this.client = new deepl.Translator(options.apiKey, {
10
- serverUrl: options.freeApi ? "https://api-free.deepl.com" : void 0
11
- });
12
- this.timeout = options.timeout || 3e4;
13
- this.initCache();
14
- }
15
- /**
16
- * Initializes the memory cache for translation results
17
- */
18
- async initCache() {
19
- try {
20
- this.cache = await getCache({
21
- provider: "memory",
22
- namespace: "translator:deepl",
23
- defaultTTL: 3600,
24
- // 1 hour cache
25
- maxSize: 10 * 1024 * 1024,
26
- // 10MB
27
- maxEntries: 1e3,
28
- evictionPolicy: "lru"
29
- });
30
- } catch (error) {
31
- console.warn("Failed to initialize translation cache:", error);
32
- }
33
- }
34
- /**
35
- * Generates a cache key for translation requests
36
- */
37
- getCacheKey(type, ...parts) {
38
- return `${type}:${parts.join(":")}`;
39
- }
40
- /**
41
- * Translates text from source language to target language
42
- */
43
- async translate(text, targetLanguage, sourceLanguage) {
44
- if (!isValidText(text)) {
45
- throw new InvalidTextError("Text cannot be empty", "deepl");
46
- }
47
- const cacheKey = this.getCacheKey(
48
- "translate",
49
- text,
50
- sourceLanguage || "auto",
51
- targetLanguage
52
- );
53
- if (this.cache) {
54
- const cached = await this.cache.get(cacheKey);
55
- if (cached) {
56
- return cached;
57
- }
58
- }
59
- try {
60
- const result = await this.client.translateText(
61
- text,
62
- sourceLanguage || null,
63
- targetLanguage
64
- );
65
- const translationResult = {
66
- translatedText: result.text,
67
- sourceText: text,
68
- sourceLanguage: result.detectedSourceLang.toLowerCase(),
69
- targetLanguage: targetLanguage.toLowerCase(),
70
- detectedSourceLanguage: !sourceLanguage,
71
- raw: result
72
- };
73
- if (this.cache) {
74
- await this.cache.set(cacheKey, translationResult);
75
- }
76
- return translationResult;
77
- } catch (error) {
78
- throw this.mapError(error);
79
- }
80
- }
81
- /**
82
- * Detects the language of the provided text
83
- * Note: DeepL doesn't have a dedicated language detection API,
84
- * so we translate to English and use the detected source language
85
- */
86
- async detectLanguage(text) {
87
- if (!isValidText(text)) {
88
- throw new InvalidTextError("Text cannot be empty", "deepl");
89
- }
90
- const cacheKey = this.getCacheKey("detect", text);
91
- if (this.cache) {
92
- const cached = await this.cache.get(cacheKey);
93
- if (cached) {
94
- return cached;
95
- }
96
- }
97
- try {
98
- const result = await this.client.translateText(
99
- text,
100
- null,
101
- "en-US"
102
- );
103
- const detectionResult = {
104
- language: result.detectedSourceLang.toLowerCase(),
105
- confidence: 1,
106
- // DeepL doesn't provide confidence scores
107
- raw: result
108
- };
109
- if (this.cache) {
110
- await this.cache.set(cacheKey, detectionResult);
111
- }
112
- return detectionResult;
113
- } catch (error) {
114
- throw this.mapError(error);
115
- }
116
- }
117
- /**
118
- * Gets the list of languages supported by this provider
119
- */
120
- async getSupportedLanguages() {
121
- const cacheKey = this.getCacheKey("languages");
122
- if (this.cache) {
123
- const cached = await this.cache.get(cacheKey);
124
- if (cached) {
125
- return cached;
126
- }
127
- }
128
- try {
129
- const [sourceLanguages, targetLanguages] = await Promise.all([
130
- this.client.getSourceLanguages(),
131
- this.client.getTargetLanguages()
132
- ]);
133
- const languageMap = /* @__PURE__ */ new Map();
134
- for (const lang of sourceLanguages) {
135
- languageMap.set(lang.code.toLowerCase(), {
136
- code: lang.code.toLowerCase(),
137
- name: lang.name
138
- });
139
- }
140
- for (const lang of targetLanguages) {
141
- const code = lang.code.toLowerCase();
142
- if (!languageMap.has(code)) {
143
- languageMap.set(code, {
144
- code,
145
- name: lang.name
146
- });
147
- }
148
- }
149
- const result = Array.from(languageMap.values());
150
- if (this.cache) {
151
- await this.cache.set(cacheKey, result, 86400);
152
- }
153
- return result;
154
- } catch (error) {
155
- throw this.mapError(error);
156
- }
157
- }
158
- /**
159
- * Translates multiple texts in a single batch operation
160
- */
161
- async translateBatch(texts, targetLanguage, sourceLanguage) {
162
- if (texts.length === 0) {
163
- return [];
164
- }
165
- try {
166
- const results = await this.client.translateText(
167
- texts,
168
- sourceLanguage || null,
169
- targetLanguage
170
- );
171
- const resultsArray = Array.isArray(results) ? results : [results];
172
- return texts.map((text, index) => {
173
- const result = resultsArray[index];
174
- return {
175
- translatedText: result.text,
176
- sourceText: text,
177
- sourceLanguage: result.detectedSourceLang.toLowerCase(),
178
- targetLanguage: targetLanguage.toLowerCase(),
179
- detectedSourceLanguage: !sourceLanguage,
180
- raw: result
181
- };
182
- });
183
- } catch (error) {
184
- throw this.mapError(error);
185
- }
186
- }
187
- /**
188
- * Maps DeepL errors to standardized error types
189
- */
190
- mapError(error) {
191
- if (error instanceof deepl.DeepLError) {
192
- if (error.message.includes("401") || error.message.includes("403")) {
193
- return new AuthenticationError("deepl");
194
- }
195
- if (error.message.includes("429") || error.message.includes("quota")) {
196
- return new QuotaExceededError("deepl");
197
- }
198
- if (error.message.includes("language") || error.message.includes("not supported")) {
199
- const match = error.message.match(/language[:\s]+([a-z-]+)/i);
200
- const language = match ? match[1] : "unknown";
201
- return new UnsupportedLanguageError(language, "deepl");
202
- }
203
- return new TranslationError(error.message, "DEEPL_ERROR", "deepl");
204
- }
205
- const err = error;
206
- return new TranslationError(
207
- err?.message || "Translation failed",
208
- err?.code || "UNKNOWN_ERROR",
209
- "deepl"
210
- );
211
- }
212
- }
213
- export {
214
- DeepLProvider
215
- };
216
- //# sourceMappingURL=deepl-CWEP0MSh.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"deepl-CWEP0MSh.js","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"],"names":[],"mappings":"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"}
@@ -1,215 +0,0 @@
1
- import { v2 } from "@google-cloud/translate";
2
- import { getCache } from "@happyvertical/cache";
3
- import { isValidText, InvalidTextError, TranslationError, normalizeConfidence, getLanguageName, AuthenticationError, QuotaExceededError, UnsupportedLanguageError } from "../index.js";
4
- const { Translate } = v2;
5
- class GoogleTranslateProvider {
6
- client;
7
- timeout;
8
- cache = null;
9
- constructor(options) {
10
- this.client = new Translate({
11
- key: options.apiKey,
12
- projectId: options.projectId
13
- });
14
- this.timeout = options.timeout || 3e4;
15
- this.initCache();
16
- }
17
- /**
18
- * Initializes the memory cache for translation results
19
- */
20
- async initCache() {
21
- try {
22
- this.cache = await getCache({
23
- provider: "memory",
24
- namespace: "translator:google",
25
- defaultTTL: 3600,
26
- // 1 hour cache
27
- maxSize: 10 * 1024 * 1024,
28
- // 10MB
29
- maxEntries: 1e3,
30
- evictionPolicy: "lru"
31
- });
32
- } catch (error) {
33
- console.warn("Failed to initialize translation cache:", error);
34
- }
35
- }
36
- /**
37
- * Generates a cache key for translation requests
38
- */
39
- getCacheKey(type, ...parts) {
40
- return `${type}:${parts.join(":")}`;
41
- }
42
- /**
43
- * Translates text from source language to target language
44
- */
45
- async translate(text, targetLanguage, sourceLanguage) {
46
- if (!isValidText(text)) {
47
- throw new InvalidTextError("Text cannot be empty", "google");
48
- }
49
- const cacheKey = this.getCacheKey(
50
- "translate",
51
- text,
52
- sourceLanguage || "auto",
53
- targetLanguage
54
- );
55
- if (this.cache) {
56
- const cached = await this.cache.get(cacheKey);
57
- if (cached) {
58
- return cached;
59
- }
60
- }
61
- try {
62
- const [translation] = await this.client.translate(text, {
63
- from: sourceLanguage,
64
- to: targetLanguage
65
- });
66
- const detectedSourceLanguage = !sourceLanguage;
67
- let actualSourceLanguage = sourceLanguage;
68
- if (!actualSourceLanguage) {
69
- const [detection] = await this.client.detect(text);
70
- actualSourceLanguage = Array.isArray(detection) ? detection[0].language : detection.language;
71
- }
72
- const result = {
73
- translatedText: translation,
74
- sourceText: text,
75
- sourceLanguage: actualSourceLanguage || "unknown",
76
- targetLanguage,
77
- detectedSourceLanguage,
78
- raw: translation
79
- };
80
- if (this.cache) {
81
- await this.cache.set(cacheKey, result);
82
- }
83
- return result;
84
- } catch (error) {
85
- throw this.mapError(error);
86
- }
87
- }
88
- /**
89
- * Detects the language of the provided text
90
- */
91
- async detectLanguage(text) {
92
- if (!isValidText(text)) {
93
- throw new InvalidTextError("Text cannot be empty", "google");
94
- }
95
- const cacheKey = this.getCacheKey("detect", text);
96
- if (this.cache) {
97
- const cached = await this.cache.get(cacheKey);
98
- if (cached) {
99
- return cached;
100
- }
101
- }
102
- try {
103
- const [detections] = await this.client.detect(text);
104
- const detectionsArray = Array.isArray(detections) ? detections : [detections];
105
- if (detectionsArray.length === 0) {
106
- throw new TranslationError(
107
- "No language detected",
108
- "NO_DETECTION",
109
- "google"
110
- );
111
- }
112
- const primary = detectionsArray[0];
113
- const result = {
114
- language: primary.language,
115
- confidence: normalizeConfidence(primary.confidence || 0),
116
- alternatives: detectionsArray.slice(1).map((d) => ({
117
- language: d.language,
118
- confidence: normalizeConfidence(d.confidence || 0)
119
- })),
120
- raw: detections
121
- };
122
- if (this.cache) {
123
- await this.cache.set(cacheKey, result);
124
- }
125
- return result;
126
- } catch (error) {
127
- if (error instanceof TranslationError) {
128
- throw error;
129
- }
130
- throw this.mapError(error);
131
- }
132
- }
133
- /**
134
- * Gets the list of languages supported by this provider
135
- */
136
- async getSupportedLanguages() {
137
- const cacheKey = this.getCacheKey("languages");
138
- if (this.cache) {
139
- const cached = await this.cache.get(cacheKey);
140
- if (cached) {
141
- return cached;
142
- }
143
- }
144
- try {
145
- const [languages] = await this.client.getLanguages();
146
- const result = languages.map((lang) => ({
147
- code: lang.code,
148
- name: lang.name || getLanguageName(lang.code)
149
- }));
150
- if (this.cache) {
151
- await this.cache.set(cacheKey, result, 86400);
152
- }
153
- return result;
154
- } catch (error) {
155
- throw this.mapError(error);
156
- }
157
- }
158
- /**
159
- * Translates multiple texts in a single batch operation
160
- */
161
- async translateBatch(texts, targetLanguage, sourceLanguage) {
162
- if (texts.length === 0) {
163
- return [];
164
- }
165
- try {
166
- const [translations] = await this.client.translate(texts, {
167
- from: sourceLanguage,
168
- to: targetLanguage
169
- });
170
- const translationsArray = Array.isArray(translations) ? translations : [translations];
171
- const detectedSourceLanguage = !sourceLanguage;
172
- let actualSourceLanguage = sourceLanguage;
173
- if (!actualSourceLanguage && texts.length > 0) {
174
- const [detection] = await this.client.detect(texts[0]);
175
- actualSourceLanguage = Array.isArray(detection) ? detection[0].language : detection.language;
176
- }
177
- return texts.map((text, index) => ({
178
- translatedText: translationsArray[index] || text,
179
- sourceText: text,
180
- sourceLanguage: actualSourceLanguage || "unknown",
181
- targetLanguage,
182
- detectedSourceLanguage,
183
- raw: translationsArray[index]
184
- }));
185
- } catch (error) {
186
- throw this.mapError(error);
187
- }
188
- }
189
- /**
190
- * Maps Google Translate errors to standardized error types
191
- */
192
- mapError(error) {
193
- const err = error;
194
- if (err.code === 403 || err.code === 401) {
195
- return new AuthenticationError("google");
196
- }
197
- if (err.code === 429) {
198
- return new QuotaExceededError("google");
199
- }
200
- if (err.code === 400 && err.message?.includes("language")) {
201
- const match = err.message.match(/language[:\s]+([a-z-]+)/i);
202
- const language = match ? match[1] : "unknown";
203
- return new UnsupportedLanguageError(language, "google");
204
- }
205
- return new TranslationError(
206
- err.message || "Translation failed",
207
- err.code || "UNKNOWN_ERROR",
208
- "google"
209
- );
210
- }
211
- }
212
- export {
213
- GoogleTranslateProvider
214
- };
215
- //# sourceMappingURL=google-KGGP9X0w.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"google-KGGP9X0w.js","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"],"names":[],"mappings":"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"}