@noy-db/hub 0.2.0-pre.17 → 0.2.0-pre.19

package/dist/indexing/index.js

@@ -7,12 +7,12 @@ import {
   decodeIdxId,
   encodeIdxId,
   isIdxId
-} from "../chunk-NYSYPFXJ.js";
+} from "../chunk-B6E5IRPJ.js";
 import {
   CollectionIndexes
-} from "../chunk-5AXTH4QZ.js";
-import "../chunk-J7RWBXFY.js";
-import "../chunk-ZEGSDPB7.js";
+} from "../chunk-Q5MCHUXZ.js";
+import "../chunk-LSIIPKYT.js";
+import "../chunk-DJF3FXW5.js";
 
 // src/indexing/active.ts
 function withIndexing() {

package/dist/issue-EPA2PSWP.js

@@ -0,0 +1,12 @@
+import {
+  issueAttestationCore
+} from "./chunk-Y5J63SMF.js";
+import "./chunk-V5FZWQNN.js";
+import "./chunk-FZU343FL.js";
+import "./chunk-SHIUFIPW.js";
+import "./chunk-OKOKPYWH.js";
+import "./chunk-DJF3FXW5.js";
+export {
+  issueAttestationCore
+};
+//# sourceMappingURL=issue-EPA2PSWP.js.map

package/dist/{ledger-LFVLHE5H.js → ledger-LS6GXCBP.js}

@@ -5,7 +5,7 @@ import {
   LedgerStore,
   applyPatch,
   computePatch
-} from "./chunk-DWEBTE2W.js";
+} from "./chunk-YX333DPS.js";
 import {
   canonicalJson,
   envelopePayloadHash,
@@ -14,9 +14,9 @@ import {
   parseIndex,
   sha256Hex
 } from "./chunk-PDVP3C2I.js";
-import "./chunk-SISBMAPO.js";
-import "./chunk-UNTGHX5A.js";
-import "./chunk-ZEGSDPB7.js";
+import "./chunk-SHIUFIPW.js";
+import "./chunk-OKOKPYWH.js";
+import "./chunk-DJF3FXW5.js";
 export {
   LEDGER_COLLECTION,
   LEDGER_DELTAS_COLLECTION,
@@ -30,4 +30,4 @@ export {
   parseIndex,
   sha256Hex
 };
-//# sourceMappingURL=ledger-LFVLHE5H.js.map
+//# sourceMappingURL=ledger-LS6GXCBP.js.map

package/dist/materialized-views/index.cjs

@@ -21,7 +21,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/errors.ts
-var NoydbError, ValidationError, GroupCardinalityError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, MaterializedViewConfigError;
+var NoydbError, ValidationError, GroupCardinalityError, LocaleNotSpecifiedError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, MaterializedViewConfigError;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -58,6 +58,18 @@ var init_errors = __esm({
         this.maxGroups = maxGroups;
       }
     };
+    LocaleNotSpecifiedError = class extends NoydbError {
+      /** The field name that required a locale. */
+      field;
+      constructor(field, message) {
+        super(
+          "LOCALE_NOT_SPECIFIED",
+          message ?? `Cannot read i18nText field "${field}" without a locale. Pass { locale } to get()/list()/query() or set a default via openVault(name, { locale }).`
+        );
+        this.name = "LocaleNotSpecifiedError";
+        this.field = field;
+      }
+    };
     MaterializedViewCycleError = class extends NoydbError {
       path;
       constructor(path) {
@@ -846,6 +858,217 @@ var init_money_reducer = __esm({
   }
 });
 
+// src/i18n/policy.ts
+function resolvePolicy(onMissing, layer) {
+  const explicit = onMissing && typeof onMissing === "object" ? onMissing[layer] : void 0;
+  const scalar = typeof onMissing === "string" ? onMissing : void 0;
+  const layerDefault = layer === "guard" ? "substitute" : void 0;
+  return explicit ?? layerDefault ?? scalar ?? "throw";
+}
+var init_policy = __esm({
+  "src/i18n/policy.ts"() {
+    "use strict";
+  }
+});
+
+// src/i18n/script.ts
+function inferScripts(locale) {
+  const parts = locale.split("-");
+  const subtag = parts.find((t) => /^[A-Z][a-z]{3}$/.test(t));
+  if (subtag && SUBTAG_SCRIPTS[subtag]) return SUBTAG_SCRIPTS[subtag];
+  const base = (parts[0] ?? "").toLowerCase();
+  if (LATIN_BASE.has(base)) return ["Latin"];
+  const primary = SCRIPT_TABLE[base];
+  if (primary) return [...primary, "Latin"];
+  return ["Latin"];
+}
+var LATIN_BASE, SCRIPT_TABLE, SUBTAG_SCRIPTS, BASELINE;
+var init_script = __esm({
+  "src/i18n/script.ts"() {
+    "use strict";
+    LATIN_BASE = /* @__PURE__ */ new Set([
+      "en",
+      "fr",
+      "de",
+      "es",
+      "it",
+      "pt",
+      "nl",
+      "sv",
+      "no",
+      "da",
+      "fi",
+      "is",
+      "pl",
+      "cs",
+      "sk",
+      "hu",
+      "ro",
+      "hr",
+      "sl",
+      "et",
+      "lv",
+      "lt",
+      "tr",
+      "vi",
+      "id",
+      "ms",
+      "tl",
+      "sw",
+      "af",
+      "ca",
+      "gl",
+      "eu",
+      "cy",
+      "ga"
+    ]);
+    SCRIPT_TABLE = {
+      th: ["Thai"],
+      ko: ["Hangul", "Han"],
+      ja: ["Han", "Hiragana", "Katakana"],
+      zh: ["Han"],
+      ar: ["Arabic"],
+      fa: ["Arabic"],
+      ur: ["Arabic"],
+      ru: ["Cyrillic"],
+      uk: ["Cyrillic"],
+      bg: ["Cyrillic"],
+      sr: ["Cyrillic"],
+      he: ["Hebrew"],
+      el: ["Greek"],
+      hi: ["Devanagari"],
+      ta: ["Tamil"],
+      km: ["Khmer"],
+      lo: ["Lao"],
+      my: ["Myanmar"]
+    };
+    SUBTAG_SCRIPTS = {
+      Latn: ["Latin"],
+      Cyrl: ["Cyrillic", "Latin"],
+      Hans: ["Han", "Latin"],
+      Hant: ["Han", "Latin"],
+      Thai: ["Thai", "Latin"],
+      Arab: ["Arabic", "Latin"]
+    };
+    BASELINE = String.raw`\p{White_Space}\p{Script=Common}\p{Script=Inherited}\p{Mark}`;
+  }
+});
+
+// src/i18n/core.ts
+function toChain(fallback) {
+  return Array.isArray(fallback) ? fallback : fallback ? [fallback] : [];
+}
+function pickFromChain(value, chain) {
+  for (const fb of chain) {
+    if (fb === "any") {
+      const any = Object.values(value).find((v) => v !== "");
+      if (any !== void 0) return any;
+    } else if (value[fb] !== void 0 && value[fb] !== "") {
+      return value[fb];
+    }
+  }
+  return void 0;
+}
+function resolveI18nText(value, locale, fallback, field, opts) {
+  if (locale === "raw") {
+    return value;
+  }
+  if (!locale) {
+    throw new LocaleNotSpecifiedError(field ?? "<unknown>");
+  }
+  if (value[locale] !== void 0 && value[locale] !== "") {
+    return value[locale];
+  }
+  const policy = opts?.policy ?? "throw";
+  const callerChain = toChain(fallback);
+  const callerHit = pickFromChain(value, callerChain);
+  if (callerHit !== void 0) return callerHit;
+  if (policy === "substitute") {
+    const subHit = pickFromChain(value, toChain(opts?.substitute));
+    if (subHit !== void 0) return subHit;
+    if (opts?.smartSubstitute) {
+      const smartHit = pickNearestScript(value, locale);
+      if (smartHit !== void 0) return smartHit;
+    }
+  }
+  if (policy === "throw") {
+    throw new LocaleNotSpecifiedError(
+      field ?? "<unknown>",
+      `No translation available for locale "${locale}"` + (callerChain.length > 0 ? ` or fallback chain [${callerChain.join(", ")}]` : "") + "."
+    );
+  }
+  return null;
+}
+function pickNearestScript(value, target) {
+  const targetScript = inferScripts(target)[0] ?? "Latin";
+  let best;
+  for (const [loc, v] of Object.entries(value)) {
+    if (typeof v !== "string" || v === "") continue;
+    const s = inferScripts(loc)[0] ?? "Latin";
+    const score = s === targetScript ? 0 : s === "Latin" ? 1 : 2;
+    if (best === void 0 || score < best.score) best = { score, v };
+    if (score === 0) break;
+  }
+  return best?.v;
+}
+function applyAtPath(obj, path, locale, fallback, opts) {
+  const arrayIdx = path.indexOf("[].");
+  if (arrayIdx !== -1) {
+    const arrayKey = path.slice(0, arrayIdx);
+    const restPath = path.slice(arrayIdx + 3);
+    const arr = obj[arrayKey];
+    if (!Array.isArray(arr)) return obj;
+    return {
+      ...obj,
+      [arrayKey]: arr.map((item) => {
+        if (!item || typeof item !== "object" || Array.isArray(item)) return item;
+        return applyAtPath(item, restPath, locale, fallback, opts);
+      })
+    };
+  }
+  const dotIdx = path.indexOf(".");
+  if (dotIdx !== -1) {
+    const head = path.slice(0, dotIdx);
+    const rest = path.slice(dotIdx + 1);
+    const nested = obj[head];
+    if (!nested || typeof nested !== "object" || Array.isArray(nested)) return obj;
+    return {
+      ...obj,
+      [head]: applyAtPath(nested, rest, locale, fallback, opts)
+    };
+  }
+  const raw = obj[path];
+  if (raw === void 0 || raw === null) return obj;
+  if (typeof raw !== "object" || Array.isArray(raw)) return obj;
+  return {
+    ...obj,
+    [path]: resolveI18nText(raw, locale, fallback, path, opts)
+  };
+}
+function applyI18nLocale(record, i18nFields, locale, fallback, layer = "read") {
+  const fieldNames = Object.keys(i18nFields);
+  if (fieldNames.length === 0) return record;
+  let result = record;
+  for (const [field, descriptor] of Object.entries(i18nFields)) {
+    const { onMissing, substitute, smartSubstitute } = descriptor.options;
+    const opts = {
+      policy: resolvePolicy(onMissing, layer),
+      ...substitute !== void 0 ? { substitute } : {},
+      ...smartSubstitute ? { smartSubstitute } : {}
+    };
+    result = applyAtPath(result, field, locale, fallback, opts);
+  }
+  return result;
+}
+var init_core = __esm({
+  "src/i18n/core.ts"() {
+    "use strict";
+    init_errors();
+    init_policy();
+    init_script();
+  }
+});
+
 // src/aggregate/groupby.ts
 function warnCardinalityApproaching(fields, observed) {
   const key = JSON.stringify([...fields].sort());
@@ -931,12 +1154,13 @@ var executor_exports = {};
 __export(executor_exports, {
   MaterializedViewExecutor: () => MaterializedViewExecutor
 });
-async function materializeQueryResult(q, mvName) {
+async function materializeQueryResult(q, mvName, i18nLocale, i18nFields) {
   if (typeof q?.toArray === "function") {
     return await q.toArray();
   }
   if (typeof q?.run === "function") {
-    const result = await Promise.resolve(q.run());
+    const runOpts = i18nLocale !== void 0 ? { locale: i18nLocale, i18nFields } : void 0;
+    const result = await Promise.resolve(q.run(runOpts));
     if (Array.isArray(result)) {
       return result;
     }
@@ -965,6 +1189,29 @@ async function materializeUnionResult(spec, db) {
   }
   if (!spec.groupBy) return unified;
   const groupFields = typeof spec.groupBy === "string" ? [spec.groupBy] : spec.groupBy;
+  if (spec.i18nLocale !== void 0 && spec.i18nFields !== void 0) {
+    const groupI18n = {};
+    for (const f of groupFields) {
+      const d = spec.i18nFields[f];
+      if (d !== void 0) groupI18n[f] = d;
+    }
+    if (Object.keys(groupI18n).length > 0) {
+      for (let i = 0; i < unified.length; i++) {
+        unified[i] = applyI18nLocale(unified[i], groupI18n, spec.i18nLocale, void 0, "mv");
+      }
+    }
+  }
+  for (const f of groupFields) {
+    for (const row of unified) {
+      const v = row[f];
+      if (v !== null && typeof v === "object") {
+        throw new LocaleNotSpecifiedError(
+          f,
+          `Materialized view "${spec.name}" groups by "${f}", whose value is a raw i18n locale map \u2014 an unstable object group key. Declare { i18nLocale, i18nFields } on the MV to resolve it at the 'mv' layer, or group by a dictKey/staticDict code (the stable key) and resolve the label at read time.`
+        );
+      }
+    }
+  }
   if (!spec.aggregate) {
     const seen = /* @__PURE__ */ new Map();
     for (const row of unified) {
@@ -996,6 +1243,7 @@ var init_executor = __esm({
     init_registry();
     init_groupby();
     init_canonical_key();
+    init_core();
     DEFAULT_MAX_ROWS = 1e5;
     MaterializedViewExecutor = {
       async refresh(reg, accessor) {
@@ -1011,7 +1259,7 @@ var init_executor = __esm({
           rows = await materializeUnionResult(spec, ctxForQuery);
         } else {
           const q = spec.query(ctxForQuery);
-          rows = await materializeQueryResult(q, spec.name);
+          rows = await materializeQueryResult(q, spec.name, spec.i18nLocale, spec.i18nFields);
         }
         if (rows.length > maxRows) {
           throw new MaterializedViewTooLargeError(spec.name, rows.length, maxRows);
@@ -1169,6 +1417,11 @@ function withMaterializedView(spec) {
       );
     }
   }
+  if (spec.i18nLocale !== void 0 && spec.i18nFields === void 0) {
+    throw new MaterializedViewConfigError(
+      `withMaterializedView "${spec.name}": i18nLocale requires i18nFields \u2014 declare the i18nText descriptors of the group-key fields so they can be resolved at the mv layer before bucketing.`
+    );
+  }
   if (typeof spec.rowKey !== "function") {
     throw new ValidationError("withMaterializedView: rowKey is required (no default; see spec \xA7 Type surface)");
   }