@form-engine-ts/translator-cache 2.9.0 → 2.9.2

package/README.md

@@ -26,6 +26,8 @@ Keys isolate adapter name, source locale, target locale, and a deterministic UTF
 are deduplicated, translated once in source order, cached, and restored to their original positions. The built-in memory
 cache applies both TTL expiration and bounded LRU eviction and exposes `size`, `evictionCount`, and `clear()` diagnostics.
 Use `variant` to isolate glossary/model/configuration revisions, or `buildKey` for complete key control.
+Adapters that expose a locale-aware cache variant (such as `@form-engine-ts/translator-google-v3` with a glossary)
+are isolated automatically; an explicit `variant` is combined with that adapter variant.
 `onStatsReport` receives cumulative real cache hits, misses, evictions, and current size after successful translations.
 Cache backend failures default to `cacheErrorPolicy: "bypass"`: `onCacheError` is notified and translation continues
 through the wrapped adapter. Use `cacheErrorPolicy: "throw"` when cache availability is mandatory.

package/dist/index.cjs

@@ -48,6 +48,11 @@ function nonNegativeDuration(value, fallback, name) {
   }
   return resolved;
 }
+function getVariantProvider(adapter) {
+  if (typeof adapter !== "object" || adapter === null) return void 0;
+  const candidate = adapter;
+  return typeof candidate.getCacheVariant === "function" ? { getCacheVariant: candidate.getCacheVariant.bind(adapter) } : void 0;
+}
 function createMemoryTranslationCache(options = {}) {
   const maxEntries = options.maxEntries ?? 500;
   if (!Number.isSafeInteger(maxEntries) || maxEntries < 1) {
@@ -120,6 +125,7 @@ function withTranslationCache(baseAdapter, cache, options = {}) {
   const initialEvictionCount = cache.evictionCount ?? 0;
   let hits = 0;
   let misses = 0;
+  const variantProvider = getVariantProvider(baseAdapter);
   const handleCacheError = (cause, operation) => {
     const error = cause instanceof Error ? cause : new Error(String(cause));
     try {
@@ -160,14 +166,19 @@ function withTranslationCache(baseAdapter, cache, options = {}) {
     }
     const target = requireLocale(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? "auto" : requireLocale(sourceLocale, "sourceLocale");
+    const automaticVariant = variantProvider?.getCacheVariant(target, sourceLocale);
+    if (automaticVariant !== void 0 && automaticVariant.trim().length === 0) {
+      throw new TypeError("baseAdapter cache variant must not be empty.");
+    }
+    const variant = options.variant === void 0 ? automaticVariant : automaticVariant === void 0 ? options.variant : `${options.variant}:${automaticVariant}`;
     const keys = texts.map((text) => {
       const context = {
         sourceText: text,
         sourceLocale: source,
         targetLocale: target,
-        ...options.variant === void 0 ? {} : { variant: options.variant }
+        ...variant === void 0 ? {} : { variant }
       };
-      const key = options.buildKey?.(context) ?? `${prefix}:${adapterName}:${options.variant === void 0 ? "" : `${options.variant}:`}${source}:${target}:${hashTranslationText(text)}`;
+      const key = options.buildKey?.(context) ?? `${prefix}:${adapterName}:${variant === void 0 ? "" : `${variant}:`}${source}:${target}:${hashTranslationText(text)}`;
       if (typeof key !== "string" || key.length === 0) throw new TypeError("Translation cache key must not be empty.");
       return key;
     });

package/dist/index.js

@@ -22,6 +22,11 @@ function nonNegativeDuration(value, fallback, name) {
   }
   return resolved;
 }
+function getVariantProvider(adapter) {
+  if (typeof adapter !== "object" || adapter === null) return void 0;
+  const candidate = adapter;
+  return typeof candidate.getCacheVariant === "function" ? { getCacheVariant: candidate.getCacheVariant.bind(adapter) } : void 0;
+}
 function createMemoryTranslationCache(options = {}) {
   const maxEntries = options.maxEntries ?? 500;
   if (!Number.isSafeInteger(maxEntries) || maxEntries < 1) {
@@ -94,6 +99,7 @@ function withTranslationCache(baseAdapter, cache, options = {}) {
   const initialEvictionCount = cache.evictionCount ?? 0;
   let hits = 0;
   let misses = 0;
+  const variantProvider = getVariantProvider(baseAdapter);
   const handleCacheError = (cause, operation) => {
     const error = cause instanceof Error ? cause : new Error(String(cause));
     try {
@@ -134,14 +140,19 @@ function withTranslationCache(baseAdapter, cache, options = {}) {
     }
     const target = requireLocale(targetLocale, "targetLocale");
     const source = sourceLocale === void 0 ? "auto" : requireLocale(sourceLocale, "sourceLocale");
+    const automaticVariant = variantProvider?.getCacheVariant(target, sourceLocale);
+    if (automaticVariant !== void 0 && automaticVariant.trim().length === 0) {
+      throw new TypeError("baseAdapter cache variant must not be empty.");
+    }
+    const variant = options.variant === void 0 ? automaticVariant : automaticVariant === void 0 ? options.variant : `${options.variant}:${automaticVariant}`;
     const keys = texts.map((text) => {
       const context = {
         sourceText: text,
         sourceLocale: source,
         targetLocale: target,
-        ...options.variant === void 0 ? {} : { variant: options.variant }
+        ...variant === void 0 ? {} : { variant }
       };
-      const key = options.buildKey?.(context) ?? `${prefix}:${adapterName}:${options.variant === void 0 ? "" : `${options.variant}:`}${source}:${target}:${hashTranslationText(text)}`;
+      const key = options.buildKey?.(context) ?? `${prefix}:${adapterName}:${variant === void 0 ? "" : `${variant}:`}${source}:${target}:${hashTranslationText(text)}`;
       if (typeof key !== "string" || key.length === 0) throw new TypeError("Translation cache key must not be empty.");
       return key;
     });

package/package.json

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