@form-engine-ts/translator-google-v3 2.5.1 → 2.6.0

package/README.md

@@ -21,7 +21,8 @@ const translator = createGoogleV3Translator({
   glossaryConfig: {
     glossary: "projects/my-project/locations/us-central1/glossaries/product-terms"
   },
-  labels: { application: "survey" }
+  labels: { application: "survey" },
+  onBatchReport: (report) => console.info(report)
 });
 
 const japanese = await translator.translateText("Thank you", "ja", "en");
@@ -30,3 +31,6 @@ const japanese = await translator.translateText("Thank you", "ja", "en");
 Keep OAuth access tokens on a trusted server. `translateBatch` defaults to at most 250 items and 25,000 UTF-8 bytes per
 request (hard limits: 1,024 items and 30,000 bytes). Network errors, HTTP 429, and HTTP 5xx responses are retried; customize
 batch and retry behavior with `batchLimits` and `retry`.
+
+`onBatchReport` receives `totalChunks`, Unicode-code-point `totalCharacters`, aggregate retry attempts, and total duration
+after each `translateBatch` call.

package/dist/index.cjs

@@ -176,7 +176,10 @@ function createGoogleV3Translator(options) {
         }
       }
       if (response?.ok === true) {
-        return parseTranslations(await response.text(), texts.length, glossaryConfig !== void 0);
+        return {
+          translations: parseTranslations(await response.text(), texts.length, glossaryConfig !== void 0),
+          retryAttempts: attempt
+        };
       }
       const retryable = response === void 0 || response.status === 429 || response.status >= 500 && response.status <= 599;
       if (retryable && attempt < maxRetries) {
@@ -200,10 +203,21 @@ function createGoogleV3Translator(options) {
     }
     const target = requireNonEmpty(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? void 0 : requireNonEmpty(sourceLocale, "sourceLocale");
+    const chunks = splitTranslationBatch(texts, batchLimits);
+    const startedAt = now();
     const translated = [];
-    for (const chunk of splitTranslationBatch(texts, batchLimits)) {
-      translated.push(...await translateChunk(chunk, target, source));
+    let retryAttempts = 0;
+    for (const chunk of chunks) {
+      const result = await translateChunk(chunk, target, source);
+      translated.push(...result.translations);
+      retryAttempts += result.retryAttempts;
     }
+    options.onBatchReport?.({
+      totalChunks: chunks.length,
+      totalCharacters: texts.reduce((total, text) => total + [...text].length, 0),
+      retryAttempts,
+      durationMs: Math.max(0, now() - startedAt)
+    });
     return translated;
   };
   return {

package/dist/index.d.cts

@@ -21,6 +21,7 @@ interface GoogleV3TranslatorOptions {
     readonly sleep?: (milliseconds: number) => Promise<void>;
     readonly random?: () => number;
     readonly now?: () => number;
+    readonly onBatchReport?: (report: TranslationBatchReport) => void;
 }
 interface BatchSplitLimits {
     readonly maxItems?: number;
@@ -32,7 +33,13 @@ interface RetryConfig {
     readonly baseDelayMs?: number;
     readonly maxDelayMs?: number;
 }
+interface TranslationBatchReport {
+    readonly totalChunks: number;
+    readonly totalCharacters: number;
+    readonly retryAttempts: number;
+    readonly durationMs: number;
+}
 declare function splitTranslationBatch(texts: readonly string[], limits?: BatchSplitLimits): string[][];
 declare function createGoogleV3Translator(options: GoogleV3TranslatorOptions): AsyncTranslationAdapter;
 
-export { type BatchSplitLimits, type GoogleV3GlossaryConfig, type GoogleV3TranslatorOptions, type RetryConfig, createGoogleV3Translator, splitTranslationBatch };
+export { type BatchSplitLimits, type GoogleV3GlossaryConfig, type GoogleV3TranslatorOptions, type RetryConfig, type TranslationBatchReport, createGoogleV3Translator, splitTranslationBatch };

package/dist/index.d.ts

@@ -21,6 +21,7 @@ interface GoogleV3TranslatorOptions {
     readonly sleep?: (milliseconds: number) => Promise<void>;
     readonly random?: () => number;
     readonly now?: () => number;
+    readonly onBatchReport?: (report: TranslationBatchReport) => void;
 }
 interface BatchSplitLimits {
     readonly maxItems?: number;
@@ -32,7 +33,13 @@ interface RetryConfig {
     readonly baseDelayMs?: number;
     readonly maxDelayMs?: number;
 }
+interface TranslationBatchReport {
+    readonly totalChunks: number;
+    readonly totalCharacters: number;
+    readonly retryAttempts: number;
+    readonly durationMs: number;
+}
 declare function splitTranslationBatch(texts: readonly string[], limits?: BatchSplitLimits): string[][];
 declare function createGoogleV3Translator(options: GoogleV3TranslatorOptions): AsyncTranslationAdapter;
 
-export { type BatchSplitLimits, type GoogleV3GlossaryConfig, type GoogleV3TranslatorOptions, type RetryConfig, createGoogleV3Translator, splitTranslationBatch };
+export { type BatchSplitLimits, type GoogleV3GlossaryConfig, type GoogleV3TranslatorOptions, type RetryConfig, type TranslationBatchReport, createGoogleV3Translator, splitTranslationBatch };

package/dist/index.js

@@ -151,7 +151,10 @@ function createGoogleV3Translator(options) {
         }
       }
       if (response?.ok === true) {
-        return parseTranslations(await response.text(), texts.length, glossaryConfig !== void 0);
+        return {
+          translations: parseTranslations(await response.text(), texts.length, glossaryConfig !== void 0),
+          retryAttempts: attempt
+        };
       }
       const retryable = response === void 0 || response.status === 429 || response.status >= 500 && response.status <= 599;
       if (retryable && attempt < maxRetries) {
@@ -175,10 +178,21 @@ function createGoogleV3Translator(options) {
     }
     const target = requireNonEmpty(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? void 0 : requireNonEmpty(sourceLocale, "sourceLocale");
+    const chunks = splitTranslationBatch(texts, batchLimits);
+    const startedAt = now();
     const translated = [];
-    for (const chunk of splitTranslationBatch(texts, batchLimits)) {
-      translated.push(...await translateChunk(chunk, target, source));
+    let retryAttempts = 0;
+    for (const chunk of chunks) {
+      const result = await translateChunk(chunk, target, source);
+      translated.push(...result.translations);
+      retryAttempts += result.retryAttempts;
     }
+    options.onBatchReport?.({
+      totalChunks: chunks.length,
+      totalCharacters: texts.reduce((total, text) => total + [...text].length, 0),
+      retryAttempts,
+      durationMs: Math.max(0, now() - startedAt)
+    });
     return translated;
   };
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@form-engine-ts/translator-google-v3",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "publishConfig": {
     "access": "public"
   },
@@ -40,7 +40,7 @@
     "typescript"
   ],
   "dependencies": {
-    "@form-engine-ts/core": "2.5.1"
+    "@form-engine-ts/core": "2.6.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean --external @form-engine-ts/core",