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

package/README.md

@@ -32,5 +32,6 @@ Keep OAuth access tokens on a trusted server. `translateBatch` defaults to at mo
 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.
+Blank and whitespace-only inputs are omitted from API requests and restored as empty output strings in their original
+positions. `onBatchReport` receives `totalChunks`, Unicode-code-point `totalCharacters`, aggregate retry attempts, total
+duration, `cacheHitCount`, `cacheMissCount`, and `evictionCount` after each `translateBatch` call.

package/dist/index.cjs

@@ -203,7 +203,9 @@ function createGoogleV3Translator(options) {
     }
     const target = requireNonEmpty(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? void 0 : requireNonEmpty(sourceLocale, "sourceLocale");
-    const chunks = splitTranslationBatch(texts, batchLimits);
+    const nonEmptyEntries = texts.flatMap((text, index) => text.trim().length === 0 ? [] : [{ text, index }]);
+    const nonEmptyTexts = nonEmptyEntries.map((entry) => entry.text);
+    const chunks = splitTranslationBatch(nonEmptyTexts, batchLimits);
     const startedAt = now();
     const translated = [];
     let retryAttempts = 0;
@@ -212,13 +214,22 @@ function createGoogleV3Translator(options) {
       translated.push(...result.translations);
       retryAttempts += result.retryAttempts;
     }
+    const restored = Array.from({ length: texts.length }, () => "");
+    for (const [translatedIndex, entry] of nonEmptyEntries.entries()) {
+      const value = translated[translatedIndex];
+      if (value === void 0) throw new Error("Google Translation Advanced returned an incomplete translation batch.");
+      restored[entry.index] = value;
+    }
     options.onBatchReport?.({
       totalChunks: chunks.length,
-      totalCharacters: texts.reduce((total, text) => total + [...text].length, 0),
+      totalCharacters: nonEmptyTexts.reduce((total, text) => total + [...text].length, 0),
       retryAttempts,
-      durationMs: Math.max(0, now() - startedAt)
+      durationMs: Math.max(0, now() - startedAt),
+      cacheHitCount: 0,
+      cacheMissCount: nonEmptyTexts.length,
+      evictionCount: 0
     });
-    return translated;
+    return restored;
   };
   return {
     async translateText(text, targetLocale, sourceLocale) {

package/dist/index.d.cts

@@ -38,6 +38,9 @@ interface TranslationBatchReport {
     readonly totalCharacters: number;
     readonly retryAttempts: number;
     readonly durationMs: number;
+    readonly cacheHitCount: number;
+    readonly cacheMissCount: number;
+    readonly evictionCount: number;
 }
 declare function splitTranslationBatch(texts: readonly string[], limits?: BatchSplitLimits): string[][];
 declare function createGoogleV3Translator(options: GoogleV3TranslatorOptions): AsyncTranslationAdapter;

package/dist/index.d.ts

@@ -38,6 +38,9 @@ interface TranslationBatchReport {
     readonly totalCharacters: number;
     readonly retryAttempts: number;
     readonly durationMs: number;
+    readonly cacheHitCount: number;
+    readonly cacheMissCount: number;
+    readonly evictionCount: number;
 }
 declare function splitTranslationBatch(texts: readonly string[], limits?: BatchSplitLimits): string[][];
 declare function createGoogleV3Translator(options: GoogleV3TranslatorOptions): AsyncTranslationAdapter;

package/dist/index.js

@@ -178,7 +178,9 @@ function createGoogleV3Translator(options) {
     }
     const target = requireNonEmpty(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? void 0 : requireNonEmpty(sourceLocale, "sourceLocale");
-    const chunks = splitTranslationBatch(texts, batchLimits);
+    const nonEmptyEntries = texts.flatMap((text, index) => text.trim().length === 0 ? [] : [{ text, index }]);
+    const nonEmptyTexts = nonEmptyEntries.map((entry) => entry.text);
+    const chunks = splitTranslationBatch(nonEmptyTexts, batchLimits);
     const startedAt = now();
     const translated = [];
     let retryAttempts = 0;
@@ -187,13 +189,22 @@ function createGoogleV3Translator(options) {
       translated.push(...result.translations);
       retryAttempts += result.retryAttempts;
     }
+    const restored = Array.from({ length: texts.length }, () => "");
+    for (const [translatedIndex, entry] of nonEmptyEntries.entries()) {
+      const value = translated[translatedIndex];
+      if (value === void 0) throw new Error("Google Translation Advanced returned an incomplete translation batch.");
+      restored[entry.index] = value;
+    }
     options.onBatchReport?.({
       totalChunks: chunks.length,
-      totalCharacters: texts.reduce((total, text) => total + [...text].length, 0),
+      totalCharacters: nonEmptyTexts.reduce((total, text) => total + [...text].length, 0),
       retryAttempts,
-      durationMs: Math.max(0, now() - startedAt)
+      durationMs: Math.max(0, now() - startedAt),
+      cacheHitCount: 0,
+      cacheMissCount: nonEmptyTexts.length,
+      evictionCount: 0
     });
-    return translated;
+    return restored;
   };
   return {
     async translateText(text, targetLocale, sourceLocale) {

package/package.json

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