@objectstack/core 12.1.0 → 12.3.0

package/dist/index.cjs

@@ -66,6 +66,7 @@ __export(index_exports, {
   createMemoryQueue: () => createMemoryQueue,
   createPluginConfigValidator: () => createPluginConfigValidator,
   createPluginPermissionEnforcer: () => createPluginPermissionEnforcer,
+  deepMerge: () => deepMerge,
   evaluateAuthGate: () => evaluateAuthGate,
   extractApiKey: () => extractApiKey,
   generateApiKey: () => generateApiKey,
@@ -78,6 +79,7 @@ __export(index_exports, {
   isNode: () => isNode,
   parseScopes: () => parseScopes,
   parseSignature: () => parseSignature,
+  readAuthoredTranslationLayer: () => readAuthoredTranslationLayer,
   resolveApiKeyPrincipal: () => resolveApiKeyPrincipal,
   resolveAuthzContext: () => resolveAuthzContext,
   resolveLocale: () => resolveLocale,
@@ -87,7 +89,8 @@ __export(index_exports, {
   verifyPayload: () => verifyPayload,
   verifyPlatformSignature: () => verifyPlatformSignature,
   verifyPluginArtifact: () => verifyPluginArtifact,
-  verifyPublisherSignature: () => verifyPublisherSignature
+  verifyPublisherSignature: () => verifyPublisherSignature,
+  wireAuthoredTranslationSync: () => wireAuthoredTranslationSync
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -1142,6 +1145,7 @@ function resolveLocale(requestedLocale, availableLocales) {
 }
 function createMemoryI18n() {
   const translations = /* @__PURE__ */ new Map();
+  const authored = /* @__PURE__ */ new Map();
   let defaultLocale = "en";
   function resolveKey(data, key) {
     const parts = key.split(".");
@@ -1152,17 +1156,25 @@ function createMemoryI18n() {
     }
     return typeof current === "string" ? current : void 0;
   }
+  function mergedLocale(locale) {
+    const stat = translations.get(locale);
+    const auth = authored.get(locale);
+    if (stat && auth) return deepMerge(stat, auth);
+    return auth ?? stat;
+  }
   function resolveTranslations(locale) {
-    if (translations.has(locale)) return translations.get(locale);
-    const resolved = resolveLocale(locale, [...translations.keys()]);
-    if (resolved) return translations.get(resolved);
+    const exact = mergedLocale(locale);
+    if (exact) return exact;
+    const allLocales = [.../* @__PURE__ */ new Set([...translations.keys(), ...authored.keys()])];
+    const resolved = resolveLocale(locale, allLocales);
+    if (resolved) return mergedLocale(resolved);
     return void 0;
   }
   return {
     _fallback: true,
     _serviceName: "i18n",
     t(key, locale, params) {
-      const data = resolveTranslations(locale) ?? translations.get(defaultLocale);
+      const data = resolveTranslations(locale) ?? mergedLocale(defaultLocale);
       const value = data ? resolveKey(data, key) : void 0;
       if (value == null) return key;
       if (!params) return value;
@@ -1179,8 +1191,21 @@ function createMemoryI18n() {
         translations.set(locale, { ...data });
       }
     },
+    /**
+     * Replace the ENTIRE runtime-authored translation layer (#2591). Called
+     * by the authored-translation sync with the full current set of active
+     * `translation` metadata items keyed by locale. Wholesale replacement —
+     * not a merge — so deleted items/keys stop resolving on the next sync.
+     */
+    replaceAuthoredTranslations(byLocale) {
+      authored.clear();
+      for (const [locale, data] of Object.entries(byLocale ?? {})) {
+        if (!data || typeof data !== "object") continue;
+        authored.set(locale, { ...data });
+      }
+    },
     getLocales() {
-      return [...translations.keys()];
+      return [.../* @__PURE__ */ new Set([...translations.keys(), ...authored.keys()])];
     },
     getDefaultLocale() {
       return defaultLocale;
@@ -1245,6 +1270,114 @@ function createMemoryMetadata() {
   };
 }
 
+// src/fallbacks/authored-translation-sync.ts
+var OWNER_PROP = "__authoredTranslationSyncOwner";
+var LOCALE_LIKE = /^[a-z]{2,3}([_-]([A-Za-z]{4}|[A-Za-z]{2}|[0-9]{3}))?$/;
+async function readAuthoredTranslationLayer(engine, logger) {
+  let rows;
+  try {
+    rows = await engine.find("sys_metadata", {
+      where: { type: "translation", state: "active" }
+    }) ?? [];
+    if (rows.length === 0) {
+      rows = await engine.find("sys_metadata", {
+        where: { type: "translations", state: "active" }
+      }) ?? [];
+    }
+  } catch (err) {
+    logger?.debug?.("[i18n] authored-translation read failed \u2014 keeping current layer", {
+      error: err?.message
+    });
+    return null;
+  }
+  const byLocale = {};
+  const sorted = [...rows].sort((a, b) => String(a?.name ?? "").localeCompare(String(b?.name ?? "")));
+  for (const row of sorted) {
+    let data;
+    try {
+      data = typeof row.metadata === "string" ? JSON.parse(row.metadata) : row.metadata;
+    } catch {
+      continue;
+    }
+    if (!data || typeof data !== "object") continue;
+    const locale = typeof data?._meta?.locale === "string" && data._meta.locale || typeof data?.locale === "string" && data.locale || (typeof row?.name === "string" && LOCALE_LIKE.test(row.name) ? row.name : void 0) || void 0;
+    if (!locale) {
+      logger?.warn?.(
+        `[i18n] authored translation '${row?.name}' has no resolvable locale (set _meta.locale, or name the item after its BCP-47 locale) \u2014 skipped`
+      );
+      continue;
+    }
+    const { name: _n, locale: _l, _packageId: _p, _provenance: _pr, _lock: _lk, ...payload } = data;
+    byLocale[locale] = deepMerge(byLocale[locale] ?? {}, payload);
+  }
+  return byLocale;
+}
+function wireAuthoredTranslationSync(ctx) {
+  if (typeof ctx.hook !== "function") return;
+  const token = /* @__PURE__ */ Symbol("authored-translation-sync");
+  const resolveOwnedI18n = () => {
+    let i18n;
+    try {
+      i18n = ctx.getService("i18n");
+    } catch {
+      return null;
+    }
+    if (!i18n || typeof i18n.replaceAuthoredTranslations !== "function") return null;
+    const current = i18n[OWNER_PROP];
+    if (current === void 0) {
+      i18n[OWNER_PROP] = token;
+      return i18n;
+    }
+    return current === token ? i18n : null;
+  };
+  let chain = Promise.resolve();
+  const sync = () => {
+    const run = chain.then(async () => {
+      const i18n = resolveOwnedI18n();
+      if (!i18n) return;
+      let engine;
+      try {
+        engine = ctx.getService("objectql");
+      } catch {
+        return;
+      }
+      if (!engine || typeof engine.find !== "function") return;
+      const layer = await readAuthoredTranslationLayer(engine, ctx.logger);
+      if (layer === null) return;
+      i18n.replaceAuthoredTranslations(layer);
+      ctx.logger.info?.("[i18n] synced runtime-authored translations", {
+        locales: Object.keys(layer)
+      });
+    });
+    chain = run.catch(() => void 0);
+    return run;
+  };
+  ctx.hook("kernel:ready", async () => {
+    if (resolveOwnedI18n()) {
+      let protocol = null;
+      try {
+        protocol = ctx.getService("protocol");
+      } catch {
+      }
+      if (protocol && typeof protocol.onMetadataMutation === "function") {
+        protocol.onMetadataMutation((evt) => {
+          if (evt?.type !== "translation" || evt.state === "draft") return;
+          void sync().catch((err) => {
+            ctx.logger.warn?.("[i18n] authored-translation re-sync after mutation failed", {
+              item: evt.name,
+              error: err?.message
+            });
+          });
+        });
+      }
+    }
+    await sync();
+  });
+  ctx.hook("metadata:reloaded", async () => {
+    await sync();
+  });
+}
+
 // src/fallbacks/index.ts
 var CORE_FALLBACK_FACTORIES = {
   metadata: createMemoryMetadata,
@@ -5281,6 +5414,7 @@ var NamespaceResolver = class {
   createMemoryQueue,
   createPluginConfigValidator,
   createPluginPermissionEnforcer,
+  deepMerge,
   evaluateAuthGate,
   extractApiKey,
   generateApiKey,
@@ -5293,6 +5427,7 @@ var NamespaceResolver = class {
   isNode,
   parseScopes,
   parseSignature,
+  readAuthoredTranslationLayer,
   resolveApiKeyPrincipal,
   resolveAuthzContext,
   resolveLocale,
@@ -5302,6 +5437,7 @@ var NamespaceResolver = class {
   verifyPayload,
   verifyPlatformSignature,
   verifyPluginArtifact,
-  verifyPublisherSignature
+  verifyPublisherSignature,
+  wireAuthoredTranslationSync
 });
 //# sourceMappingURL=index.cjs.map