@noy-db/hub 0.2.0-pre.6 → 0.2.0-pre.8

package/dist/history/index.d.cts

@@ -1,11 +1,11 @@
-import { aP as HistoryStrategy, aQ as NoydbStore, aR as HistoryOptions, aS as EncryptedEnvelope, aT as PruneOptions } from '../types-DVlvNn2c.cjs';
-export { aU as AppendInput, aV as ChangeType, aW as CollectionInstant, aX as DiffEntry, aY as JsonPatch, aZ as JsonPatchOp, a_ as LedgerEntry, a$ as LedgerStore, b0 as VaultEngine, b1 as VaultInstant, b2 as VerifyResult, b3 as applyPatch, b4 as canonicalJson, b5 as computePatch, b6 as diff, b7 as formatDiff, b8 as hashEntry, b9 as paddedIndex, ba as parseIndex, bb as sha256Hex } from '../types-DVlvNn2c.cjs';
-export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-BgEQklQc.cjs';
-import '../lazy-builder-DXlSCNCJ.cjs';
-import '../predicate-B0IKeBXx.cjs';
+import { b0 as HistoryStrategy, b1 as NoydbStore, b2 as HistoryOptions, b3 as EncryptedEnvelope, b4 as PruneOptions } from '../types-DjunxzJa.cjs';
+export { b5 as AppendInput, b6 as ChangeType, b7 as CollectionInstant, b8 as DiffEntry, b9 as JsonPatch, ba as JsonPatchOp, bb as LedgerEntry, bc as LedgerStore, bd as VaultEngine, be as VaultInstant, bf as VerifyResult, bg as applyPatch, bh as canonicalJson, bi as computePatch, bj as diff, bk as formatDiff, bl as hashEntry, bm as paddedIndex, bn as parseIndex, bo as sha256Hex } from '../types-DjunxzJa.cjs';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-BPsYPcv_.cjs';
+import '../lazy-builder-wY4pMCEe.cjs';
+import '../predicate-BSAGEyu5.cjs';
 import '../strategy-DSTrsZ8t.cjs';
 import '../strategy-BSxFXGzb.cjs';
-import '../index-5I0MZ0jQ.cjs';
+import '../index-4fBVt8j9.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/history/index.d.ts

@@ -1,11 +1,11 @@
-import { aP as HistoryStrategy, aQ as NoydbStore, aR as HistoryOptions, aS as EncryptedEnvelope, aT as PruneOptions } from '../types-DlnZh1_i.js';
-export { aU as AppendInput, aV as ChangeType, aW as CollectionInstant, aX as DiffEntry, aY as JsonPatch, aZ as JsonPatchOp, a_ as LedgerEntry, a$ as LedgerStore, b0 as VaultEngine, b1 as VaultInstant, b2 as VerifyResult, b3 as applyPatch, b4 as canonicalJson, b5 as computePatch, b6 as diff, b7 as formatDiff, b8 as hashEntry, b9 as paddedIndex, ba as parseIndex, bb as sha256Hex } from '../types-DlnZh1_i.js';
-export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-BAlWR4WD.js';
-import '../lazy-builder-D1MyR1qH.js';
-import '../predicate-B0IKeBXx.js';
+import { b0 as HistoryStrategy, b1 as NoydbStore, b2 as HistoryOptions, b3 as EncryptedEnvelope, b4 as PruneOptions } from '../types-DGU60JDt.js';
+export { b5 as AppendInput, b6 as ChangeType, b7 as CollectionInstant, b8 as DiffEntry, b9 as JsonPatch, ba as JsonPatchOp, bb as LedgerEntry, bc as LedgerStore, bd as VaultEngine, be as VaultInstant, bf as VerifyResult, bg as applyPatch, bh as canonicalJson, bi as computePatch, bj as diff, bk as formatDiff, bl as hashEntry, bm as paddedIndex, bn as parseIndex, bo as sha256Hex } from '../types-DGU60JDt.js';
+export { L as LEDGER_COLLECTION, a as LEDGER_DELTAS_COLLECTION, e as envelopePayloadHash } from '../hash-C1GtiOhR.js';
+import '../lazy-builder-7tIpFyWN.js';
+import '../predicate-BSAGEyu5.js';
 import '../strategy-DSTrsZ8t.js';
 import '../strategy-BSxFXGzb.js';
-import '../index-fIPPh5dg.js';
+import '../index-D8I_pyJD.js';
 import '@noy-db/attestation';
 
 /**

package/dist/history/index.js

@@ -8,14 +8,14 @@ import {
   getVersionEnvelope,
   pruneHistory,
   saveHistory
-} from "../chunk-ARZAHCCF.js";
+} from "../chunk-F3GDRNUT.js";
 import {
   LEDGER_COLLECTION,
   LEDGER_DELTAS_COLLECTION,
   LedgerStore,
   applyPatch,
   computePatch
-} from "../chunk-6A4AMQ2H.js";
+} from "../chunk-PE2FR4J3.js";
 import {
   canonicalJson,
   envelopePayloadHash,
@@ -24,9 +24,9 @@ import {
   parseIndex,
   sha256Hex
 } from "../chunk-Z6FNBOTC.js";
-import "../chunk-5OVIFUQE.js";
-import "../chunk-EKTOYEZ3.js";
-import "../chunk-6HJ2ZALB.js";
+import "../chunk-WIRRPTFH.js";
+import "../chunk-PP6W64Y3.js";
+import "../chunk-B6PB7JLN.js";
 
 // src/history/active.ts
 function withHistory() {

package/dist/i18n/index.cjs

@@ -27,16 +27,20 @@ __export(i18n_exports, {
   LocaleNotSpecifiedError: () => LocaleNotSpecifiedError,
   MissingTranslationError: () => MissingTranslationError,
   ReservedCollectionNameError: () => ReservedCollectionNameError,
+  ScriptViolationError: () => ScriptViolationError,
   TranslatorNotConfiguredError: () => TranslatorNotConfiguredError,
   applyI18nLocale: () => applyI18nLocale,
   dictCollectionName: () => dictCollectionName,
   dictKey: () => dictKey,
+  enforceScript: () => enforceScript,
   getAtPath: () => getAtPath,
   i18nText: () => i18nText,
+  inferScripts: () => inferScripts,
   isDictCollectionName: () => isDictCollectionName,
   isDictKeyDescriptor: () => isDictKeyDescriptor,
   isI18nTextDescriptor: () => isI18nTextDescriptor,
   resolveI18nText: () => resolveI18nText,
+  resolvePolicy: () => resolvePolicy,
   setAtPathInPlace: () => setAtPathInPlace,
   validateI18nTextValue: () => validateI18nTextValue,
   withI18n: () => withI18n
@@ -152,6 +156,27 @@ var LocaleNotSpecifiedError = class extends NoydbError {
     this.field = field;
   }
 };
+var ScriptViolationError = class extends NoydbError {
+  /** The field whose value violated its script constraint. */
+  field;
+  /** The locale slot (e.g. `'en'`) that was checked. */
+  locale;
+  /** The Unicode scripts allowed for this slot. */
+  expected;
+  /** A short sample of the offending characters, for diagnostics. */
+  sample;
+  constructor(field, locale, expected, sample, message) {
+    super(
+      "SCRIPT_VIOLATION",
+      message ?? `Field "${field}" slot "${locale}" expects script(s) [${expected.join(", ")}] but contains disallowed character(s): "${sample}".`
+    );
+    this.name = "ScriptViolationError";
+    this.field = field;
+    this.locale = locale;
+    this.expected = expected;
+    this.sample = sample;
+  }
+};
 var TranslatorNotConfiguredError = class extends NoydbError {
   /** The field that requested auto-translation. */
   field;
@@ -168,6 +193,14 @@ var TranslatorNotConfiguredError = class extends NoydbError {
   }
 };
 
+// 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";
+}
+
 // src/i18n/core.ts
 function i18nText(options) {
   return { _noydbI18nText: true, options };
@@ -231,7 +264,21 @@ function validateI18nTextValue(value, field, descriptor) {
     }
   }
 }
-function resolveI18nText(value, locale, fallback, field) {
+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;
   }
@@ -241,19 +288,21 @@ function resolveI18nText(value, locale, fallback, field) {
   if (value[locale] !== void 0 && value[locale] !== "") {
     return value[locale];
   }
-  const chain = Array.isArray(fallback) ? fallback : fallback ? [fallback] : [];
-  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];
-    }
+  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;
   }
-  throw new LocaleNotSpecifiedError(
-    field ?? "<unknown>",
-    `No translation available for locale "${locale}"` + (chain.length > 0 ? ` or fallback chain [${chain.join(", ")}]` : "") + "."
-  );
+  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 getAtPath(obj, path) {
   const arrayIdx = path.indexOf("[].");
@@ -290,7 +339,7 @@ function setAtPathInPlace(obj, path, value) {
   }
   obj[path] = value;
 }
-function applyAtPath(obj, path, locale, fallback) {
+function applyAtPath(obj, path, locale, fallback, opts) {
   const arrayIdx = path.indexOf("[].");
   if (arrayIdx !== -1) {
     const arrayKey = path.slice(0, arrayIdx);
@@ -301,7 +350,7 @@ function applyAtPath(obj, path, locale, fallback) {
       ...obj,
       [arrayKey]: arr.map((item) => {
         if (!item || typeof item !== "object" || Array.isArray(item)) return item;
-        return applyAtPath(item, restPath, locale, fallback);
+        return applyAtPath(item, restPath, locale, fallback, opts);
       })
     };
   }
@@ -313,7 +362,7 @@ function applyAtPath(obj, path, locale, fallback) {
     if (!nested || typeof nested !== "object" || Array.isArray(nested)) return obj;
     return {
       ...obj,
-      [head]: applyAtPath(nested, rest, locale, fallback)
+      [head]: applyAtPath(nested, rest, locale, fallback, opts)
     };
   }
   const raw = obj[path];
@@ -321,15 +370,20 @@ function applyAtPath(obj, path, locale, fallback) {
   if (typeof raw !== "object" || Array.isArray(raw)) return obj;
   return {
     ...obj,
-    [path]: resolveI18nText(raw, locale, fallback, path)
+    [path]: resolveI18nText(raw, locale, fallback, path, opts)
   };
 }
-function applyI18nLocale(record, i18nFields, locale, fallback) {
+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 of fieldNames) {
-    result = applyAtPath(result, field, locale, fallback);
+  for (const [field, descriptor] of Object.entries(i18nFields)) {
+    const { onMissing, substitute } = descriptor.options;
+    const opts = {
+      policy: resolvePolicy(onMissing, layer),
+      ...substitute !== void 0 ? { substitute } : {}
+    };
+    result = applyAtPath(result, field, locale, fallback, opts);
   }
   return result;
 }
@@ -515,8 +569,14 @@ function dictCollectionName(dictionaryName) {
 function isDictCollectionName(name) {
   return name.startsWith(DICT_COLLECTION_PREFIX);
 }
-function dictKey(name, keys) {
-  return { _noydbDictKey: true, name, keys };
+function dictKey(name, keys, opts) {
+  return {
+    _noydbDictKey: true,
+    name,
+    keys,
+    ...opts?.onMissing !== void 0 ? { onMissing: opts.onMissing } : {},
+    ...opts?.substitute !== void 0 ? { substitute: opts.substitute } : {}
+  };
 }
 function isDictKeyDescriptor(x) {
   return typeof x === "object" && x !== null && x._noydbDictKey === true;
@@ -858,11 +918,142 @@ var DictionaryHandle = class {
   }
 };
 
+// src/i18n/script.ts
+var 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"
+]);
+var 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"]
+};
+var SUBTAG_SCRIPTS = {
+  Latn: ["Latin"],
+  Cyrl: ["Cyrillic", "Latin"],
+  Hans: ["Han", "Latin"],
+  Hant: ["Han", "Latin"],
+  Thai: ["Thai", "Latin"],
+  Arab: ["Arabic", "Latin"]
+};
+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"];
+}
+function allowedFor(descriptor, locale) {
+  const script = descriptor.options.script;
+  if (script && script !== "auto") {
+    const explicit = script[locale];
+    if (explicit) return explicit;
+  }
+  return inferScripts(locale);
+}
+var BASELINE = String.raw`\p{White_Space}\p{Script=Common}\p{Script=Inherited}\p{Mark}`;
+function fullMatcher(scripts) {
+  const cls = scripts.map((s) => `\\p{Script=${s}}`).join("");
+  return new RegExp(`^[${BASELINE}${cls}]*$`, "u");
+}
+function charMatcher(scripts) {
+  const cls = scripts.map((s) => `\\p{Script=${s}}`).join("");
+  return new RegExp(`[${BASELINE}${cls}]`, "u");
+}
+function offendingSample(str, scripts) {
+  const ok = charMatcher(scripts);
+  const bad = [];
+  for (const ch of str) {
+    if (!ok.test(ch)) bad.push(ch);
+    if (bad.length >= 8) break;
+  }
+  return bad.join("");
+}
+function stripDisallowed(str, scripts) {
+  const ok = charMatcher(scripts);
+  let out = "";
+  for (const ch of str) if (ok.test(ch)) out += ch;
+  return out;
+}
+function enforceScript(value, field, descriptor) {
+  const opt = descriptor.options;
+  if (!opt.script) return { value, warnings: [] };
+  const mode = opt.onScriptViolation ?? "reject";
+  const warnings = [];
+  let out = value;
+  for (const [locale, raw] of Object.entries(value)) {
+    if (typeof raw !== "string") continue;
+    const allowed = allowedFor(descriptor, locale);
+    if (fullMatcher(allowed).test(raw)) continue;
+    const sample = offendingSample(raw, allowed);
+    if (mode === "reject") {
+      throw new ScriptViolationError(field, locale, allowed, sample);
+    }
+    warnings.push({ field, locale, expected: allowed, sample });
+    if (mode === "filter") {
+      if (out === value) out = { ...value };
+      out[locale] = stripDisallowed(raw, allowed);
+    }
+  }
+  return { value: out, warnings };
+}
+
 // src/i18n/active.ts
 function withI18n() {
   return {
     applyI18nLocale,
     validateI18nTextValue,
+    enforceScript,
     buildDictionaryHandle(opts) {
       return new DictionaryHandle(
         opts.adapter,
@@ -888,16 +1079,20 @@ function withI18n() {
   LocaleNotSpecifiedError,
   MissingTranslationError,
   ReservedCollectionNameError,
+  ScriptViolationError,
   TranslatorNotConfiguredError,
   applyI18nLocale,
   dictCollectionName,
   dictKey,
+  enforceScript,
   getAtPath,
   i18nText,
+  inferScripts,
   isDictCollectionName,
   isDictKeyDescriptor,
   isI18nTextDescriptor,
   resolveI18nText,
+  resolvePolicy,
   setAtPathInPlace,
   validateI18nTextValue,
   withI18n