@lionrapid/core 0.6.5 → 0.7.0

package/dist/browser/lionrapid.esm.js

@@ -2,6 +2,216 @@ var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
+// src/browser/md5.ts
+function safeAdd(x, y) {
+  const lsw = (x & 65535) + (y & 65535);
+  const msw = (x >> 16) + (y >> 16) + (lsw >> 16);
+  return msw << 16 | lsw & 65535;
+}
+function bitRotateLeft(num, cnt) {
+  return num << cnt | num >>> 32 - cnt;
+}
+function md5cmn(q, a, b, x, s, t) {
+  return safeAdd(bitRotateLeft(safeAdd(safeAdd(a, q), safeAdd(x, t)), s), b);
+}
+function md5ff(a, b, c, d, x, s, t) {
+  return md5cmn(b & c | ~b & d, a, b, x, s, t);
+}
+function md5gg(a, b, c, d, x, s, t) {
+  return md5cmn(b & d | c & ~d, a, b, x, s, t);
+}
+function md5hh(a, b, c, d, x, s, t) {
+  return md5cmn(b ^ c ^ d, a, b, x, s, t);
+}
+function md5ii(a, b, c, d, x, s, t) {
+  return md5cmn(c ^ (b | ~d), a, b, x, s, t);
+}
+function binlMD5(x, len) {
+  x[len >> 5] |= 128 << len % 32;
+  x[(len + 64 >>> 9 << 4) + 14] = len;
+  let a = 1732584193;
+  let b = -271733879;
+  let c = -1732584194;
+  let d = 271733878;
+  for (let i = 0; i < x.length; i += 16) {
+    const olda = a;
+    const oldb = b;
+    const oldc = c;
+    const oldd = d;
+    a = md5ff(a, b, c, d, x[i], 7, -680876936);
+    d = md5ff(d, a, b, c, x[i + 1], 12, -389564586);
+    c = md5ff(c, d, a, b, x[i + 2], 17, 606105819);
+    b = md5ff(b, c, d, a, x[i + 3], 22, -1044525330);
+    a = md5ff(a, b, c, d, x[i + 4], 7, -176418897);
+    d = md5ff(d, a, b, c, x[i + 5], 12, 1200080426);
+    c = md5ff(c, d, a, b, x[i + 6], 17, -1473231341);
+    b = md5ff(b, c, d, a, x[i + 7], 22, -45705983);
+    a = md5ff(a, b, c, d, x[i + 8], 7, 1770035416);
+    d = md5ff(d, a, b, c, x[i + 9], 12, -1958414417);
+    c = md5ff(c, d, a, b, x[i + 10], 17, -42063);
+    b = md5ff(b, c, d, a, x[i + 11], 22, -1990404162);
+    a = md5ff(a, b, c, d, x[i + 12], 7, 1804603682);
+    d = md5ff(d, a, b, c, x[i + 13], 12, -40341101);
+    c = md5ff(c, d, a, b, x[i + 14], 17, -1502002290);
+    b = md5ff(b, c, d, a, x[i + 15], 22, 1236535329);
+    a = md5gg(a, b, c, d, x[i + 1], 5, -165796510);
+    d = md5gg(d, a, b, c, x[i + 6], 9, -1069501632);
+    c = md5gg(c, d, a, b, x[i + 11], 14, 643717713);
+    b = md5gg(b, c, d, a, x[i], 20, -373897302);
+    a = md5gg(a, b, c, d, x[i + 5], 5, -701558691);
+    d = md5gg(d, a, b, c, x[i + 10], 9, 38016083);
+    c = md5gg(c, d, a, b, x[i + 15], 14, -660478335);
+    b = md5gg(b, c, d, a, x[i + 4], 20, -405537848);
+    a = md5gg(a, b, c, d, x[i + 9], 5, 568446438);
+    d = md5gg(d, a, b, c, x[i + 14], 9, -1019803690);
+    c = md5gg(c, d, a, b, x[i + 3], 14, -187363961);
+    b = md5gg(b, c, d, a, x[i + 8], 20, 1163531501);
+    a = md5gg(a, b, c, d, x[i + 13], 5, -1444681467);
+    d = md5gg(d, a, b, c, x[i + 2], 9, -51403784);
+    c = md5gg(c, d, a, b, x[i + 7], 14, 1735328473);
+    b = md5gg(b, c, d, a, x[i + 12], 20, -1926607734);
+    a = md5hh(a, b, c, d, x[i + 5], 4, -378558);
+    d = md5hh(d, a, b, c, x[i + 8], 11, -2022574463);
+    c = md5hh(c, d, a, b, x[i + 11], 16, 1839030562);
+    b = md5hh(b, c, d, a, x[i + 14], 23, -35309556);
+    a = md5hh(a, b, c, d, x[i + 1], 4, -1530992060);
+    d = md5hh(d, a, b, c, x[i + 4], 11, 1272893353);
+    c = md5hh(c, d, a, b, x[i + 7], 16, -155497632);
+    b = md5hh(b, c, d, a, x[i + 10], 23, -1094730640);
+    a = md5hh(a, b, c, d, x[i + 13], 4, 681279174);
+    d = md5hh(d, a, b, c, x[i + 0], 11, -358537222);
+    c = md5hh(c, d, a, b, x[i + 3], 16, -722521979);
+    b = md5hh(b, c, d, a, x[i + 6], 23, 76029189);
+    a = md5hh(a, b, c, d, x[i + 9], 4, -640364487);
+    d = md5hh(d, a, b, c, x[i + 12], 11, -421815835);
+    c = md5hh(c, d, a, b, x[i + 15], 16, 530742520);
+    b = md5hh(b, c, d, a, x[i + 2], 23, -995338651);
+    a = md5ii(a, b, c, d, x[i], 6, -198630844);
+    d = md5ii(d, a, b, c, x[i + 7], 10, 1126891415);
+    c = md5ii(c, d, a, b, x[i + 14], 15, -1416354905);
+    b = md5ii(b, c, d, a, x[i + 5], 21, -57434055);
+    a = md5ii(a, b, c, d, x[i + 12], 6, 1700485571);
+    d = md5ii(d, a, b, c, x[i + 3], 10, -1894986606);
+    c = md5ii(c, d, a, b, x[i + 10], 15, -1051523);
+    b = md5ii(b, c, d, a, x[i + 1], 21, -2054922799);
+    a = md5ii(a, b, c, d, x[i + 8], 6, 1873313359);
+    d = md5ii(d, a, b, c, x[i + 15], 10, -30611744);
+    c = md5ii(c, d, a, b, x[i + 6], 15, -1560198380);
+    b = md5ii(b, c, d, a, x[i + 13], 21, 1309151649);
+    a = md5ii(a, b, c, d, x[i + 4], 6, -145523070);
+    d = md5ii(d, a, b, c, x[i + 11], 10, -1120210379);
+    c = md5ii(c, d, a, b, x[i + 2], 15, 718787259);
+    b = md5ii(b, c, d, a, x[i + 9], 21, -343485551);
+    a = safeAdd(a, olda);
+    b = safeAdd(b, oldb);
+    c = safeAdd(c, oldc);
+    d = safeAdd(d, oldd);
+  }
+  return [a, b, c, d];
+}
+function binl2hex(binarray) {
+  const hexTab = "0123456789abcdef";
+  let str = "";
+  for (let i = 0; i < binarray.length * 4; i++) {
+    str += hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 + 4 & 15) + hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 & 15);
+  }
+  return str;
+}
+function utf8Bytes(str) {
+  if (typeof TextEncoder !== "undefined") {
+    return new TextEncoder().encode(str);
+  }
+  const out = [];
+  for (let i = 0; i < str.length; i++) {
+    const c = str.charCodeAt(i);
+    if (c < 128) {
+      out.push(c);
+    } else if (c < 2048) {
+      out.push(192 | c >> 6, 128 | c & 63);
+    } else if (c >= 55296 && c < 56320 && i + 1 < str.length) {
+      const c2 = str.charCodeAt(++i);
+      const cp = 65536 + (c - 55296 << 10) + (c2 - 56320);
+      out.push(
+        240 | cp >> 18,
+        128 | cp >> 12 & 63,
+        128 | cp >> 6 & 63,
+        128 | cp & 63
+      );
+    } else {
+      out.push(
+        224 | c >> 12,
+        128 | c >> 6 & 63,
+        128 | c & 63
+      );
+    }
+  }
+  return new Uint8Array(out);
+}
+function bytes2binl(bytes) {
+  const bin = [];
+  for (let i = 0; i < bytes.length; i++) {
+    bin[i >> 2] |= bytes[i] << i % 4 * 8;
+  }
+  return bin;
+}
+function md5(str) {
+  const bytes = utf8Bytes(str);
+  return binl2hex(binlMD5(bytes2binl(bytes), bytes.length * 8));
+}
+function generateAutoKey(text) {
+  const trimmed = text.trim();
+  return "auto_" + md5(trimmed).substring(0, 12);
+}
+
+// src/utils/log-safe.ts
+var LOG_VALUE_FULL_MAX = 200;
+var LOG_VALUE_EDGE = 90;
+function contentIdentity(value) {
+  return `${value.length} chars, md5:${md5(value.trim()).slice(0, 12)}`;
+}
+function contentExcerpt(value) {
+  if (value.length <= LOG_VALUE_FULL_MAX) {
+    return JSON.stringify(value);
+  }
+  return JSON.stringify(
+    `${value.slice(0, LOG_VALUE_EDGE)}\u2026${value.slice(-LOG_VALUE_EDGE)}`
+  );
+}
+var LOG_ERROR_MAX = 200;
+var LOG_DATA_MAX = 500;
+var LOG_STACK_FRAMES = 2;
+var LOG_FRAME_MAX = 120;
+function bound(text, max) {
+  return text.length <= max ? text : `${text.slice(0, max)}\u2026 (${text.length} chars)`;
+}
+function oneLine(text) {
+  return JSON.stringify(text).slice(1, -1);
+}
+function describeError(error) {
+  if (error instanceof Error) {
+    const name = error.name || "Error";
+    return bound(oneLine(`${name}: ${error.message}`), LOG_ERROR_MAX);
+  }
+  return bound(oneLine(String(error)), LOG_ERROR_MAX);
+}
+function describeLogData(data) {
+  if (data instanceof Error) {
+    const headerLines = String(data.message ?? "").split("\n").length;
+    const frames = (data.stack ?? "").split("\n").slice(headerLines).map((frame) => frame.trim()).filter((frame) => frame.startsWith("at ")).slice(0, LOG_STACK_FRAMES).map((frame) => bound(frame, LOG_FRAME_MAX));
+    return [describeError(data), ...frames].join(" | ");
+  }
+  let rendered;
+  try {
+    rendered = JSON.stringify(data);
+  } catch {
+    return "[unserializable]";
+  }
+  return bound(rendered ?? oneLine(String(data)), LOG_DATA_MAX);
+}
+function describeContent(value) {
+  return `${contentIdentity(value)}, ${contentExcerpt(value)}`;
+}
+
 // src/config/logger.config.ts
 var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
   LogLevel2[LogLevel2["DEBUG"] = 0] = "DEBUG";
@@ -129,7 +339,7 @@ var DevelopmentLogger = class _DevelopmentLogger {
       const locationInfo2 = callSite ? ` (${callSite.fileName}:${callSite.lineNumber})` : "";
       let logMessage = `${this.config.prefix} ${emoji} ${levelName} ${message}${locationInfo2}`;
       if (data !== void 0) {
-        logMessage += ` ${JSON.stringify(data)}`;
+        logMessage += ` ${describeLogData(data)}`;
       }
       return logMessage;
     }
@@ -140,7 +350,7 @@ var DevelopmentLogger = class _DevelopmentLogger {
     const coloredLevel = `${levelColor}${Colors.BOLD}${levelName}${reset}`;
     const coloredMessage = `${levelColor}${message}${reset}`;
     const locationInfo = callSite ? `${Colors.DIM}${Colors.BRIGHT_BLACK} (${callSite.fileName}:${callSite.lineNumber})${reset}` : "";
-    const dataInfo = data !== void 0 ? `${Colors.DIM}${Colors.CYAN} ${JSON.stringify(data)}${reset}` : "";
+    const dataInfo = data !== void 0 ? `${Colors.DIM}${Colors.CYAN} ${describeLogData(data)}${reset}` : "";
     return `${coloredPrefix} ${coloredEmoji} ${coloredLevel} ${coloredMessage}${locationInfo}${dataInfo}`;
   }
   getLevelColor(level) {
@@ -939,6 +1149,24 @@ var HandlerChain = class {
     });
     await Promise.allSettled(savePromises);
   }
+  /** Forget `locale:namespace` in every memory and storage handler (a 404). */
+  async forgetNamespaceInHandlers(context) {
+    for (const handler of this.syncHandlers) {
+      try {
+        handler.forgetNamespace?.(context);
+      } catch (error) {
+        logger.warn(`Failed to clear namespace in ${handler.name}`, error);
+      }
+    }
+    for (const handler of this.asyncHandlers) {
+      if (handler.type !== "storage" && handler.type !== "memory") continue;
+      try {
+        await handler.forgetNamespace?.(context);
+      } catch (error) {
+        logger.warn(`Failed to clear namespace in ${handler.name}`, error);
+      }
+    }
+  }
   async saveNamespaceToHandlers(translations, context) {
     this.saveNamespaceToMemoryHandlers(translations, context);
     await this.saveNamespaceToStorageHandlers(translations, context);
@@ -1040,6 +1268,10 @@ var HandlerChain = class {
           });
           return result.data;
         }
+        if (result && result.status === 404) {
+          await this.forgetNamespaceInHandlers({ namespace, locale });
+          return null;
+        }
       } catch (error) {
         logger.warn(
           `Failed to load namespace: ${locale}:${namespace} from ${handler.name}`,
@@ -1423,6 +1655,7 @@ var SyncHandler = class {
       context.locale + ":" + context.namespace,
       this.name
     );
+    const previousKeys = this.storedNamespaceKeys(context.locale, context.namespace);
     const namespaceCacheKey = createNamespaceCacheKey(
       context.locale,
       context.namespace
@@ -1434,11 +1667,38 @@ var SyncHandler = class {
       context.locale,
       context.namespace
     );
+    for (const key of previousKeys) {
+      if (!(key in flattened)) this.removeQuietly(key);
+    }
     for (const [flatKey, flatValue] of Object.entries(flattened)) {
       this.setWithTTL(flatKey, flatValue);
     }
     repoBus.setSuccess(JSON.stringify(translations));
   }
+  /** Forget a namespace the server says does not exist (404). See AsyncStorageHandler. */
+  forgetNamespace(context) {
+    if (!context.namespace) return;
+    for (const key of this.storedNamespaceKeys(context.locale, context.namespace)) {
+      this.removeQuietly(key);
+    }
+    this.clearNamespace(context.locale, context.namespace);
+  }
+  storedNamespaceKeys(locale, namespace) {
+    try {
+      const blob = this.repository.get(createNamespaceCacheKey(locale, namespace));
+      if (!blob) return [];
+      return Object.keys(flattenTranslations(JSON.parse(blob), "", locale, namespace));
+    } catch {
+      return [];
+    }
+  }
+  removeQuietly(cacheKey) {
+    this.ttlMap.delete(cacheKey);
+    try {
+      this.repository.remove(cacheKey);
+    } catch {
+    }
+  }
   /**
    * ✅ Strategy 1: Direct cache lookup using unified pattern
    * Returns parsed ContentUnit (text + styles) or null
@@ -1692,6 +1952,7 @@ var AsyncHandler = class {
     logger.debug(
       `Saving namespace: ${context.locale}:${context.namespace} (${keyCount} keys)`
     );
+    const previousKeys = await this.storedNamespaceKeys(context.locale, context.namespace);
     const namespaceCacheKey = createNamespaceCacheKey(
       context.locale,
       context.namespace
@@ -1703,6 +1964,9 @@ var AsyncHandler = class {
       context.locale,
       context.namespace
     );
+    for (const key of previousKeys) {
+      if (!(key in flattened)) await this.removeQuietly(key);
+    }
     let savedCount = 0;
     for (const [flatKey, flatValue] of Object.entries(flattened)) {
       await this.setWithTTL(flatKey, flatValue);
@@ -1711,6 +1975,35 @@ var AsyncHandler = class {
     logger.debug(`Saved: ${savedCount} keys + namespace blob`);
     repoBus.setSuccess(JSON.stringify(translations));
   }
+  /**
+   * Forget a namespace the server says does not exist (404): its blob and
+   * every per-key entry the blob listed. A network failure never gets here,
+   * so the offline floor still serves when the server is unreachable.
+   */
+  async forgetNamespace(context) {
+    if (!context.namespace) return;
+    for (const key of await this.storedNamespaceKeys(context.locale, context.namespace)) {
+      await this.removeQuietly(key);
+    }
+    await this.removeQuietly(createNamespaceCacheKey(context.locale, context.namespace));
+  }
+  /** The per-key cache keys (`locale:namespace:key`) the stored blob lists. */
+  async storedNamespaceKeys(locale, namespace) {
+    try {
+      const blob = await this.repository.get(createNamespaceCacheKey(locale, namespace));
+      if (!blob) return [];
+      return Object.keys(flattenTranslations(JSON.parse(blob), "", locale, namespace));
+    } catch {
+      return [];
+    }
+  }
+  async removeQuietly(cacheKey) {
+    this.ttlMap.delete(cacheKey);
+    try {
+      await this.repository.remove(cacheKey);
+    } catch {
+    }
+  }
   /**
    * ✅ Strategy 1: Direct cache lookup using unified pattern
    * Returns parsed ContentUnit (text + styles) or null
@@ -2261,6 +2554,15 @@ var NetworkHandler = class {
     const config = this.repository.getConfig();
     return config.options?.preloadNamespaces || [];
   }
+  /**
+   * The host this handler talks to. Exposed so a failure can NAME it: "the
+   * server is unreachable" is not actionable, and a default pointing at a dead
+   * host is exactly the case where the reader needs to be told which host.
+   */
+  getBaseUrl() {
+    const config = this.repository.getConfig();
+    return config.options?.baseUrl || "";
+  }
 };
 
 // src/content/canonical-tag.ts
@@ -3133,7 +3435,9 @@ var LionRapidCore = class {
       const processedText = this.processTranslationValue(unit.text, request);
       return processedText.replace(/<\/?[0-9]+\/?>/g, "");
     } catch (error) {
-      logger.warn(`ContentUnit processing failed for "${value}":`, error);
+      logger.warn(
+        `ContentUnit processing failed for key "${request.cleanKey}" \u2014 ${describeContent(value)}: ${describeError(error)}`
+      );
       return this.processTranslationValue(value, request);
     }
   }
@@ -3186,7 +3490,9 @@ var LionRapidCore = class {
       }
       return processedValue;
     } catch (error) {
-      logger.warn(`Translation processing failed for "${value}":`, error);
+      logger.warn(
+        `Translation processing failed for key "${resolvedKey ?? "(no key)"}" \u2014 ${describeContent(value)}: ${describeError(error)}`
+      );
       return value;
     }
   }
@@ -3903,8 +4209,9 @@ var LionRapidBuilder = class _LionRapidBuilder {
     const warnLoudlyOnce = (namespaceKey, error) => {
       if (!isLoudPreloadFailure(error) || warnedLoudly) return;
       warnedLoudly = true;
+      const baseUrl = networkHandler.getBaseUrl() || "(no base URL configured)";
       console.warn(
-        `[LionRapid] Could not load translations for ${namespaceKey} \u2014 the page stays untranslated until the server is reachable.`,
+        `[LionRapid] Could not load translations for ${namespaceKey} from ${baseUrl} \u2014 the page stays untranslated until that host is reachable. If it is wrong, set data-base-url on the snippet tag (or \`baseUrl\` in the network repository options).`,
         error
       );
     };
@@ -3924,6 +4231,12 @@ var LionRapidBuilder = class _LionRapidBuilder {
           logger.debug(`Preloaded: ${namespaceKey}`);
           return;
         }
+        if (result?.status === 404) {
+          await handlerChain.forgetNamespaceInHandlers({
+            locale: preloadConfig.locale,
+            namespace: preloadConfig.namespace
+          });
+        }
         if (result?.error) {
           warnLoudlyOnce(namespaceKey, result.error);
           logger.warn(`Preload failed: ${namespaceKey}`, result.error);
@@ -4032,7 +4345,7 @@ var _NetworkRepository = class _NetworkRepository {
         throw new TranslationNotFoundError(key);
       }
       if (typeof translation === "object" && "text" in translation) {
-        logger.debug(`ContentUnit text: "${translation.text}"`);
+        logger.debug(`ContentUnit text: ${describeContent(translation.text)}`);
         return translation.text;
       }
       return String(translation);
@@ -4067,13 +4380,18 @@ var _NetworkRepository = class _NetworkRepository {
         throw new TranslationNotFoundError(key);
       }
       if (typeof translation === "object" && "text" in translation) {
-        logger.debug(`ContentUnit for "${key}": text="${translation.text}", styles=`, translation.styles);
+        logger.debug(
+          `ContentUnit for "${key}": text=${describeContent(translation.text)}, styles=`,
+          translation.styles
+        );
         return {
           text: translation.text,
           styles: translation.styles || {}
         };
       }
-      logger.debug(`Plain string for "${key}": "${translation}" (no styles)`);
+      logger.debug(
+        `Plain string for "${key}": ${describeContent(String(translation))} (no styles)`
+      );
       return {
         text: String(translation),
         styles: {}
@@ -4881,167 +5199,6 @@ function replaceBlockInners(html, replacements) {
   return result;
 }
 
-// src/browser/md5.ts
-function safeAdd(x, y) {
-  const lsw = (x & 65535) + (y & 65535);
-  const msw = (x >> 16) + (y >> 16) + (lsw >> 16);
-  return msw << 16 | lsw & 65535;
-}
-function bitRotateLeft(num, cnt) {
-  return num << cnt | num >>> 32 - cnt;
-}
-function md5cmn(q, a, b, x, s, t) {
-  return safeAdd(bitRotateLeft(safeAdd(safeAdd(a, q), safeAdd(x, t)), s), b);
-}
-function md5ff(a, b, c, d, x, s, t) {
-  return md5cmn(b & c | ~b & d, a, b, x, s, t);
-}
-function md5gg(a, b, c, d, x, s, t) {
-  return md5cmn(b & d | c & ~d, a, b, x, s, t);
-}
-function md5hh(a, b, c, d, x, s, t) {
-  return md5cmn(b ^ c ^ d, a, b, x, s, t);
-}
-function md5ii(a, b, c, d, x, s, t) {
-  return md5cmn(c ^ (b | ~d), a, b, x, s, t);
-}
-function binlMD5(x, len) {
-  x[len >> 5] |= 128 << len % 32;
-  x[(len + 64 >>> 9 << 4) + 14] = len;
-  let a = 1732584193;
-  let b = -271733879;
-  let c = -1732584194;
-  let d = 271733878;
-  for (let i = 0; i < x.length; i += 16) {
-    const olda = a;
-    const oldb = b;
-    const oldc = c;
-    const oldd = d;
-    a = md5ff(a, b, c, d, x[i], 7, -680876936);
-    d = md5ff(d, a, b, c, x[i + 1], 12, -389564586);
-    c = md5ff(c, d, a, b, x[i + 2], 17, 606105819);
-    b = md5ff(b, c, d, a, x[i + 3], 22, -1044525330);
-    a = md5ff(a, b, c, d, x[i + 4], 7, -176418897);
-    d = md5ff(d, a, b, c, x[i + 5], 12, 1200080426);
-    c = md5ff(c, d, a, b, x[i + 6], 17, -1473231341);
-    b = md5ff(b, c, d, a, x[i + 7], 22, -45705983);
-    a = md5ff(a, b, c, d, x[i + 8], 7, 1770035416);
-    d = md5ff(d, a, b, c, x[i + 9], 12, -1958414417);
-    c = md5ff(c, d, a, b, x[i + 10], 17, -42063);
-    b = md5ff(b, c, d, a, x[i + 11], 22, -1990404162);
-    a = md5ff(a, b, c, d, x[i + 12], 7, 1804603682);
-    d = md5ff(d, a, b, c, x[i + 13], 12, -40341101);
-    c = md5ff(c, d, a, b, x[i + 14], 17, -1502002290);
-    b = md5ff(b, c, d, a, x[i + 15], 22, 1236535329);
-    a = md5gg(a, b, c, d, x[i + 1], 5, -165796510);
-    d = md5gg(d, a, b, c, x[i + 6], 9, -1069501632);
-    c = md5gg(c, d, a, b, x[i + 11], 14, 643717713);
-    b = md5gg(b, c, d, a, x[i], 20, -373897302);
-    a = md5gg(a, b, c, d, x[i + 5], 5, -701558691);
-    d = md5gg(d, a, b, c, x[i + 10], 9, 38016083);
-    c = md5gg(c, d, a, b, x[i + 15], 14, -660478335);
-    b = md5gg(b, c, d, a, x[i + 4], 20, -405537848);
-    a = md5gg(a, b, c, d, x[i + 9], 5, 568446438);
-    d = md5gg(d, a, b, c, x[i + 14], 9, -1019803690);
-    c = md5gg(c, d, a, b, x[i + 3], 14, -187363961);
-    b = md5gg(b, c, d, a, x[i + 8], 20, 1163531501);
-    a = md5gg(a, b, c, d, x[i + 13], 5, -1444681467);
-    d = md5gg(d, a, b, c, x[i + 2], 9, -51403784);
-    c = md5gg(c, d, a, b, x[i + 7], 14, 1735328473);
-    b = md5gg(b, c, d, a, x[i + 12], 20, -1926607734);
-    a = md5hh(a, b, c, d, x[i + 5], 4, -378558);
-    d = md5hh(d, a, b, c, x[i + 8], 11, -2022574463);
-    c = md5hh(c, d, a, b, x[i + 11], 16, 1839030562);
-    b = md5hh(b, c, d, a, x[i + 14], 23, -35309556);
-    a = md5hh(a, b, c, d, x[i + 1], 4, -1530992060);
-    d = md5hh(d, a, b, c, x[i + 4], 11, 1272893353);
-    c = md5hh(c, d, a, b, x[i + 7], 16, -155497632);
-    b = md5hh(b, c, d, a, x[i + 10], 23, -1094730640);
-    a = md5hh(a, b, c, d, x[i + 13], 4, 681279174);
-    d = md5hh(d, a, b, c, x[i + 0], 11, -358537222);
-    c = md5hh(c, d, a, b, x[i + 3], 16, -722521979);
-    b = md5hh(b, c, d, a, x[i + 6], 23, 76029189);
-    a = md5hh(a, b, c, d, x[i + 9], 4, -640364487);
-    d = md5hh(d, a, b, c, x[i + 12], 11, -421815835);
-    c = md5hh(c, d, a, b, x[i + 15], 16, 530742520);
-    b = md5hh(b, c, d, a, x[i + 2], 23, -995338651);
-    a = md5ii(a, b, c, d, x[i], 6, -198630844);
-    d = md5ii(d, a, b, c, x[i + 7], 10, 1126891415);
-    c = md5ii(c, d, a, b, x[i + 14], 15, -1416354905);
-    b = md5ii(b, c, d, a, x[i + 5], 21, -57434055);
-    a = md5ii(a, b, c, d, x[i + 12], 6, 1700485571);
-    d = md5ii(d, a, b, c, x[i + 3], 10, -1894986606);
-    c = md5ii(c, d, a, b, x[i + 10], 15, -1051523);
-    b = md5ii(b, c, d, a, x[i + 1], 21, -2054922799);
-    a = md5ii(a, b, c, d, x[i + 8], 6, 1873313359);
-    d = md5ii(d, a, b, c, x[i + 15], 10, -30611744);
-    c = md5ii(c, d, a, b, x[i + 6], 15, -1560198380);
-    b = md5ii(b, c, d, a, x[i + 13], 21, 1309151649);
-    a = md5ii(a, b, c, d, x[i + 4], 6, -145523070);
-    d = md5ii(d, a, b, c, x[i + 11], 10, -1120210379);
-    c = md5ii(c, d, a, b, x[i + 2], 15, 718787259);
-    b = md5ii(b, c, d, a, x[i + 9], 21, -343485551);
-    a = safeAdd(a, olda);
-    b = safeAdd(b, oldb);
-    c = safeAdd(c, oldc);
-    d = safeAdd(d, oldd);
-  }
-  return [a, b, c, d];
-}
-function binl2hex(binarray) {
-  const hexTab = "0123456789abcdef";
-  let str = "";
-  for (let i = 0; i < binarray.length * 4; i++) {
-    str += hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 + 4 & 15) + hexTab.charAt(binarray[i >> 2] >> i % 4 * 8 & 15);
-  }
-  return str;
-}
-function utf8Bytes(str) {
-  if (typeof TextEncoder !== "undefined") {
-    return new TextEncoder().encode(str);
-  }
-  const out = [];
-  for (let i = 0; i < str.length; i++) {
-    const c = str.charCodeAt(i);
-    if (c < 128) {
-      out.push(c);
-    } else if (c < 2048) {
-      out.push(192 | c >> 6, 128 | c & 63);
-    } else if (c >= 55296 && c < 56320 && i + 1 < str.length) {
-      const c2 = str.charCodeAt(++i);
-      const cp = 65536 + (c - 55296 << 10) + (c2 - 56320);
-      out.push(
-        240 | cp >> 18,
-        128 | cp >> 12 & 63,
-        128 | cp >> 6 & 63,
-        128 | cp & 63
-      );
-    } else {
-      out.push(
-        224 | c >> 12,
-        128 | c >> 6 & 63,
-        128 | c & 63
-      );
-    }
-  }
-  return new Uint8Array(out);
-}
-function bytes2binl(bytes) {
-  const bin = [];
-  for (let i = 0; i < bytes.length; i++) {
-    bin[i >> 2] |= bytes[i] << i % 4 * 8;
-  }
-  return bin;
-}
-function md5(str) {
-  const bytes = utf8Bytes(str);
-  return binl2hex(binlMD5(bytes2binl(bytes), bytes.length * 8));
-}
-function generateAutoKey(text) {
-  const trimmed = text.trim();
-  return "auto_" + md5(trimmed).substring(0, 12);
-}
-
 // src/browser/exclude-filter.ts
 var DEFAULT_PATTERNS = {
   emails: true,
@@ -5456,6 +5613,8 @@ var CacheStorageRepository = class {
     __publicField(this, "type", "storage");
     __publicField(this, "config");
     __publicField(this, "cacheName");
+    /** CACHE_PREFIX, plus `<scope>/` when scoped. */
+    __publicField(this, "entryPrefix");
     __publicField(this, "defaultTTL");
     __publicField(this, "available");
     this.config = {
@@ -5469,6 +5628,8 @@ var CacheStorageRepository = class {
       }
     };
     this.cacheName = this.config.options?.cacheName ?? CACHE_NAME;
+    const scope = this.config.options?.scope;
+    this.entryPrefix = scope ? `${CACHE_PREFIX}${encodeURIComponent(scope)}/` : CACHE_PREFIX;
     this.defaultTTL = this.config.options?.ttl ?? 7 * 24 * 60 * 60 * 1e3;
     this.available = this.checkAvailability();
   }
@@ -5489,13 +5650,13 @@ var CacheStorageRepository = class {
     }
     try {
       const cache = await caches.open(this.cacheName);
-      const response = await cache.match(CACHE_PREFIX + key);
+      const response = await cache.match(this.entryPrefix + key);
       if (!response) {
         throw new TranslationNotFoundError(key);
       }
       const data = await response.json();
       if (data.expiry !== null && Date.now() > data.expiry) {
-        await cache.delete(CACHE_PREFIX + key);
+        await cache.delete(this.entryPrefix + key);
         throw new TranslationNotFoundError(key);
       }
       return data.value;
@@ -5519,7 +5680,7 @@ var CacheStorageRepository = class {
         timestamp: Date.now()
       };
       await cache.put(
-        CACHE_PREFIX + key,
+        this.entryPrefix + key,
         new Response(JSON.stringify(data), {
           headers: { "Content-Type": "application/json" }
         })
@@ -5534,7 +5695,7 @@ var CacheStorageRepository = class {
     if (!this.available) return;
     try {
       const cache = await caches.open(this.cacheName);
-      await cache.delete(CACHE_PREFIX + key);
+      await cache.delete(this.entryPrefix + key);
     } catch {
     }
   }
@@ -5547,7 +5708,7 @@ var CacheStorageRepository = class {
       const cache = await caches.open(this.cacheName);
       const keys = await cache.keys();
       await Promise.all(
-        keys.filter((request) => request.url.includes(CACHE_PREFIX)).map((request) => cache.delete(request))
+        keys.filter((request) => request.url.includes(this.entryPrefix)).map((request) => cache.delete(request))
       );
     } catch {
     }
@@ -5565,7 +5726,7 @@ var CacheStorageRepository = class {
       await Promise.all(
         keys.filter((request) => {
           const url = request.url;
-          const key = url.includes(CACHE_PREFIX) ? url.substring(url.indexOf(CACHE_PREFIX) + CACHE_PREFIX.length) : "";
+          const key = url.includes(this.entryPrefix) ? url.substring(url.indexOf(this.entryPrefix) + this.entryPrefix.length) : "";
           return key === namespaceCacheKey || key.startsWith(keyPrefix);
         }).map((request) => cache.delete(request))
       );
@@ -5617,9 +5778,9 @@ var CacheStorageRepository = class {
       const keys = await cache.keys();
       for (const request of keys) {
         const url = request.url;
-        if (!url.includes(CACHE_PREFIX)) continue;
+        if (!url.includes(this.entryPrefix)) continue;
         const key = url.substring(
-          url.indexOf(CACHE_PREFIX) + CACHE_PREFIX.length
+          url.indexOf(this.entryPrefix) + this.entryPrefix.length
         );
         try {
           const value = await this.get(key);
@@ -5641,7 +5802,7 @@ var CacheStorageRepository = class {
     try {
       const cache = await caches.open(this.cacheName);
       const keys = await cache.keys();
-      const size = keys.filter((r) => r.url.includes(CACHE_PREFIX)).length;
+      const size = keys.filter((r) => r.url.includes(this.entryPrefix)).length;
       return { size, cacheName: this.cacheName };
     } catch {
       return { size: 0, cacheName: this.cacheName };
@@ -5649,8 +5810,11 @@ var CacheStorageRepository = class {
   }
 };
 
+// src/config/api.config.ts
+var DEFAULT_API_BASE_URL = "https://app.lionrapid.com";
+
 // src/index.ts
-var VERSION = "0.6.5";
+var VERSION = "0.7.0";
 export {
   CORE_CACHE_ENTRY_PREFIX,
   CORE_CACHE_NAMES,
@@ -5658,6 +5822,7 @@ export {
   CacheStorageRepository,
   Colors,
   ContentValidator,
+  DEFAULT_API_BASE_URL,
   EventEmitter,
   ExcludeFilter,
   HTMLSerializer,