@noy-db/hub 0.2.0-pre.30 → 0.2.0-pre.31

package/dist/materialized-views/index.cjs

@@ -1,1518 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function __init() {
-  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/errors.ts
-var NoydbError, ValidationError, GroupCardinalityError, LocaleNotSpecifiedError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, MaterializedViewConfigError;
-var init_errors = __esm({
-  "src/errors.ts"() {
-    "use strict";
-    NoydbError = class extends Error {
-      /** Machine-readable error code. Stable across library versions. */
-      code;
-      constructor(code, message) {
-        super(message);
-        this.name = "NoydbError";
-        this.code = code;
-      }
-    };
-    ValidationError = class extends NoydbError {
-      constructor(message = "Validation error") {
-        super("VALIDATION_ERROR", message);
-        this.name = "ValidationError";
-      }
-    };
-    GroupCardinalityError = class extends NoydbError {
-      /** The field being grouped on. */
-      field;
-      /** Observed number of distinct groups at the moment the cap tripped. */
-      cardinality;
-      /** The cap that was exceeded. */
-      maxGroups;
-      constructor(field, cardinality, maxGroups) {
-        super(
-          "GROUP_CARDINALITY",
-          `.groupBy("${field}") produced ${cardinality} distinct groups, exceeding the ${maxGroups}-group ceiling. This is almost always a query mistake \u2014 grouping on a high-uniqueness field like "id" or "createdAt" produces one bucket per record. Narrow the query with .where() before grouping, or group on a lower-cardinality field (status, category, clientId). If you genuinely need high-cardinality grouping, file an issue with your use case.`
-        );
-        this.name = "GroupCardinalityError";
-        this.field = field;
-        this.cardinality = cardinality;
-        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) {
-        super(
-          "MATERIALIZED_VIEW_CYCLE",
-          `Materialized-view graph contains a cycle: ${path.join(" \u2192 ")}. Refusing to open vault \u2014 break the cycle before retrying.`
-        );
-        this.name = "MaterializedViewCycleError";
-        this.path = path;
-      }
-    };
-    MaterializedViewSourceUnknownError = class extends NoydbError {
-      mvName;
-      collection;
-      constructor(mvName, collection) {
-        super(
-          "MATERIALIZED_VIEW_SOURCE_UNKNOWN",
-          `Materialized view "${mvName}" references unknown source collection "${collection}". Declare the collection (e.g. via schema or by writing to it once) before registering the MV.`
-        );
-        this.name = "MaterializedViewSourceUnknownError";
-        this.mvName = mvName;
-        this.collection = collection;
-      }
-    };
-    MaterializedViewTooLargeError = class extends NoydbError {
-      mvName;
-      expected;
-      limit;
-      constructor(mvName, expected, limit) {
-        super(
-          "MATERIALIZED_VIEW_TOO_LARGE",
-          `Materialized view "${mvName}" would emit ${expected} rows, exceeding the configured limit of ${limit}. Override via { maxRows: N } on the MV strategy if intentional, or tighten the query's filter/groupBy.`
-        );
-        this.name = "MaterializedViewTooLargeError";
-        this.mvName = mvName;
-        this.expected = expected;
-        this.limit = limit;
-      }
-    };
-    MaterializedViewConfigError = class extends NoydbError {
-      constructor(message) {
-        super(
-          "MATERIALIZED_VIEW_CONFIG",
-          `[noy-db] withMaterializedView: ${message}`
-        );
-        this.name = "MaterializedViewConfigError";
-      }
-    };
-  }
-});
-
-// src/materialized-views/dependency-analyzer.ts
-function analyzeDependencies(query) {
-  const deps = /* @__PURE__ */ new Set();
-  const plan = query._plan();
-  const ctx = query._joinContext();
-  if (ctx?.leftCollection) {
-    deps.add(ctx.leftCollection);
-  }
-  for (const leg of plan.joins) {
-    deps.add(leg.target);
-  }
-  for (const clause of plan.clauses) {
-    if (clause.type === "crossJoin") {
-      deps.add(clause.target);
-    }
-  }
-  walkClausesForJoins(plan, deps, ctx);
-  return deps;
-}
-function walkClausesForJoins(plan, deps, ctx) {
-  void ctx;
-  for (const clause of plan.clauses) {
-    if (clause.type === "group") {
-    }
-  }
-}
-function summarizeQueryPlan(query) {
-  const plan = query._plan();
-  const ctx = query._joinContext();
-  return JSON.stringify({
-    root: ctx?.leftCollection ?? null,
-    clauses: plan.clauses.map((c) => {
-      if (c.type === "crossJoin") {
-        return {
-          type: "crossJoin",
-          target: c.target,
-          as: c.as,
-          // Inline on: callback: use sentinel — drift detection disabled for this MV
-          onPredicateName: c.onPredicateName ?? (c.on ? "[inline]" : null),
-          maxRows: c.maxRows ?? null
-        };
-      }
-      return c;
-    }),
-    orderBy: plan.orderBy,
-    limit: plan.limit ?? null,
-    offset: plan.offset,
-    joins: plan.joins.map((j) => ({ field: j.field, as: j.as, target: j.target, mode: j.mode }))
-  });
-}
-function summarizeUnionPlan(spec) {
-  const arms = (spec.unionSources ?? []).map((s) => {
-    const joins = s.join?.length ? `[${s.join.map((j) => `${j.field}\u2192${j.as}`).join(";")}]` : "";
-    return `${s.collection}${joins}`;
-  }).join(",");
-  const groupBy = Array.isArray(spec.groupBy) ? [...spec.groupBy].sort().join(",") : typeof spec.groupBy === "string" ? spec.groupBy : "";
-  const aggKeys = spec.aggregate ? Object.keys(spec.aggregate).sort().join(",") : "";
-  const moneyKeys = spec.moneyFields ? Object.keys(spec.moneyFields).sort().join(",") : "";
-  return `union(${arms})|groupBy(${groupBy})|aggregate(${aggKeys})|money(${moneyKeys})`;
-}
-var init_dependency_analyzer = __esm({
-  "src/materialized-views/dependency-analyzer.ts"() {
-    "use strict";
-  }
-});
-
-// src/materialized-views/query-hash.ts
-async function computeQueryHash(mvName, dependencies, queryPlanSummary) {
-  const canonical = JSON.stringify({
-    mvName,
-    dependencies: [...dependencies].sort(),
-    queryPlanSummary
-  });
-  const bytes = new TextEncoder().encode(canonical);
-  const digest = await crypto.subtle.digest("SHA-256", bytes);
-  return Array.from(new Uint8Array(digest)).map((b) => b.toString(16).padStart(2, "0")).join("");
-}
-function canonicalizeQueryPlan(plan) {
-  return JSON.stringify(plan, (_key, value) => {
-    if (value && typeof value === "object" && !Array.isArray(value)) {
-      const sorted = {};
-      for (const k of Object.keys(value).sort()) {
-        sorted[k] = value[k];
-      }
-      return sorted;
-    }
-    return value;
-  });
-}
-var init_query_hash = __esm({
-  "src/materialized-views/query-hash.ts"() {
-    "use strict";
-  }
-});
-
-// src/materialized-views/registry.ts
-function isFieldClauseOnField(clause, field) {
-  return clause.type === "field" && clause.field === field;
-}
-function wrapDbWithPredicates(db, predicates) {
-  const map = /* @__PURE__ */ new Map();
-  for (const [name, decl] of Object.entries(predicates)) {
-    map.set(name, {
-      hash: decl.hash,
-      fn: decl.fn
-    });
-  }
-  return {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    collection(name) {
-      const c = db.collection(name);
-      return new Proxy(c, {
-        get(target, prop, receiver) {
-          if (prop === "query") {
-            return (...args) => {
-              const q = target.query(...args);
-              if (q && typeof q._withPredicates === "function") {
-                return q._withPredicates(map);
-              }
-              return q;
-            };
-          }
-          return Reflect.get(target, prop, receiver);
-        }
-      });
-    }
-  };
-}
-function extractPredicateRefs(plan) {
-  const refs = [];
-  const walk = (clauses) => {
-    for (const c of clauses) {
-      if (c.type === "wherePredicate") {
-        refs.push({ name: c.name, predicateHash: c.predicateHash, ctxHash: c.ctxHash });
-      } else if (c.type === "group") {
-        walk(c.clauses);
-      }
-    }
-  };
-  walk(plan.clauses);
-  refs.sort((a, b) => {
-    if (a.name !== b.name) return a.name < b.name ? -1 : 1;
-    if (a.predicateHash !== b.predicateHash) return a.predicateHash < b.predicateHash ? -1 : 1;
-    return a.ctxHash < b.ctxHash ? -1 : a.ctxHash > b.ctxHash ? 1 : 0;
-  });
-  return refs;
-}
-function partitionDisjoint(reg) {
-  const partition = reg.spec.output?.partition;
-  if (partition === void 0) return false;
-  const value = partition.value;
-  for (const c of reg.partitionClauses) {
-    if (c.op === "==" && c.value !== value) return true;
-    if (c.op === "!=" && c.value === value) return true;
-    if (c.op === "in" && Array.isArray(c.value)) {
-      const list = c.value;
-      if (!list.includes(value)) return true;
-    }
-  }
-  return false;
-}
-var MaterializedViewRegistry;
-var init_registry = __esm({
-  "src/materialized-views/registry.ts"() {
-    "use strict";
-    init_errors();
-    init_dependency_analyzer();
-    init_query_hash();
-    MaterializedViewRegistry = class {
-      /** Keyed by `spec.name`. */
-      _byName = /* @__PURE__ */ new Map();
-      /** Keyed by dependency source-collection → MVs that depend on it. */
-      _bySource = /* @__PURE__ */ new Map();
-      /**
-       * Register an MV. Invokes `spec.query()` once at registration time to
-       * read the plan + join context; the resulting `Query<T>` is discarded
-       * after dependency extraction. `vault.collection(...)` must therefore
-       * be functional by the time this runs — typically wired from
-       * `Vault._initMaterializedViews` after collection bootstrap.
-       *
-       * Throws `MaterializedViewSourceUnknownError` if the analyzer
-       * surfaces a dependency the vault doesn't know about (when a
-       * `knownCollections` checker is supplied).
-       */
-      async register(spec, db, options) {
-        const dbForQuery = spec.predicates ? wrapDbWithPredicates(db, spec.predicates) : db;
-        let dependencies;
-        let queryPlanSummary;
-        let qAny = null;
-        let isQuery = false;
-        if (spec.unionSources) {
-          dependencies = new Set(spec.unionSources.map((s) => s.collection));
-          if (spec.sources) for (const s of spec.sources) dependencies.add(s);
-          queryPlanSummary = summarizeUnionPlan(spec);
-        } else {
-          const q = spec.query(dbForQuery);
-          qAny = q;
-          isQuery = typeof qAny._plan === "function";
-          if (isQuery) {
-            dependencies = analyzeDependencies(q);
-            queryPlanSummary = summarizeQueryPlan(q);
-            const predicateRefs = extractPredicateRefs(qAny._plan());
-            if (predicateRefs.length > 0) {
-              queryPlanSummary = JSON.stringify({ plan: queryPlanSummary, predicates: predicateRefs });
-            }
-            if (spec.sources) for (const s of spec.sources) dependencies.add(s);
-          } else {
-            if (!spec.sources || spec.sources.length === 0) {
-              throw new Error(
-                `withMaterializedView "${spec.name}": query() returned an aggregate (Aggregation or GroupedAggregation) but no \`sources\` field is declared. The dependency analyzer cannot walk through groupBy().aggregate() back to the source \u2014 declare sources: [...] explicitly.`
-              );
-            }
-            dependencies = new Set(spec.sources);
-            queryPlanSummary = JSON.stringify({ aggregate: true, sources: [...spec.sources].sort() });
-          }
-        }
-        if (options?.knownCollections) {
-          for (const dep of dependencies) {
-            if (!options.knownCollections(dep)) {
-              throw new MaterializedViewSourceUnknownError(spec.name, dep);
-            }
-          }
-        }
-        const outputCollection = spec.output?.collection ?? spec.name;
-        const queryHash = await computeQueryHash(spec.name, dependencies, queryPlanSummary);
-        const partitionClauses = [];
-        const partitionField = spec.output?.partition?.field;
-        if (partitionField !== void 0 && isQuery) {
-          const plan = qAny._plan();
-          for (const clause of plan.clauses) {
-            if (isFieldClauseOnField(clause, partitionField)) partitionClauses.push(clause);
-          }
-        }
-        const reg = { spec, outputCollection, dependencies, queryHash, partitionClauses };
-        this._byName.set(spec.name, reg);
-        for (const dep of dependencies) {
-          const arr = this._bySource.get(dep);
-          if (arr) arr.push(reg);
-          else this._bySource.set(dep, [reg]);
-        }
-      }
-      /** All MVs that depend on `source`, in registration order. */
-      mvsForSource(source) {
-        return this._bySource.get(source) ?? [];
-      }
-      /** Single MV by name, or `undefined`. */
-      byName(name) {
-        return this._byName.get(name);
-      }
-      /** Iterate over every registered MV. */
-      all() {
-        return [...this._byName.values()];
-      }
-      /**
-       * Cycle detection over the combined derivation + MV graph. Edges:
-       *   - Derivation: derivation.source → output.collection (each output)
-       *   - MV: every dep in MV.dependencies → MV.outputCollection
-       *
-       * Throws `MaterializedViewCycleError` if the cycle's terminal node
-       * is an MV output collection; otherwise (a pure-derivation cycle)
-       * the caller's `DerivationRegistry.validate()` will surface
-       * `DerivationCycleError` separately at vault open.
-       *
-       * Call AFTER all `register()` calls complete.
-       */
-      validate(derivationRegistry) {
-        const visited = /* @__PURE__ */ new Set();
-        const stack = [];
-        const mvOutputs = /* @__PURE__ */ new Set();
-        for (const reg of this._byName.values()) mvOutputs.add(reg.outputCollection);
-        const edges = /* @__PURE__ */ new Map();
-        for (const reg of this._byName.values()) {
-          for (const dep of reg.dependencies) {
-            if (dep === reg.outputCollection && partitionDisjoint(reg)) continue;
-            const arr = edges.get(dep);
-            if (arr) arr.push(reg.outputCollection);
-            else edges.set(dep, [reg.outputCollection]);
-          }
-        }
-        if (derivationRegistry) {
-          for (const reg of this._byName.values()) {
-            void reg;
-          }
-          const sourcesToScan = /* @__PURE__ */ new Set();
-          for (const reg of this._byName.values()) {
-            for (const dep of reg.dependencies) sourcesToScan.add(dep);
-            sourcesToScan.add(reg.outputCollection);
-          }
-          for (const src of sourcesToScan) {
-            const strategies = derivationRegistry.strategiesForSource(src);
-            if (strategies.length === 0) continue;
-            for (const s of strategies) {
-              for (const key of Object.keys(s.spec.outputs)) {
-                const o = s.spec.outputs[key];
-                if (!o) continue;
-                const arr = edges.get(src);
-                if (arr) arr.push(o.collection);
-                else edges.set(src, [o.collection]);
-              }
-            }
-          }
-        }
-        const visit = (node) => {
-          if (stack.includes(node)) {
-            const cycle = stack.slice(stack.indexOf(node)).concat(node);
-            if (cycle.some((n) => mvOutputs.has(n))) {
-              throw new MaterializedViewCycleError(cycle);
-            }
-            return;
-          }
-          if (visited.has(node)) return;
-          stack.push(node);
-          const outs = edges.get(node);
-          if (outs) for (const o of outs) visit(o);
-          stack.pop();
-          visited.add(node);
-        };
-        for (const node of edges.keys()) visit(node);
-      }
-    };
-  }
-});
-
-// src/money/fixed-point.ts
-function expandExponent(s) {
-  const m = /^([+-]?)(\d+)(?:\.(\d+))?[eE]([+-]?\d+)$/.exec(s);
-  if (!m) return s;
-  const sign = m[1] === "-" ? "-" : "";
-  const intp = m[2];
-  const frac = m[3] ?? "";
-  const exp = Number(m[4]);
-  const digits = intp + frac;
-  const pointPos = intp.length + exp;
-  let body;
-  if (pointPos <= 0) {
-    body = "0." + "0".repeat(-pointPos) + digits;
-  } else if (pointPos >= digits.length) {
-    body = digits + "0".repeat(pointPos - digits.length);
-  } else {
-    body = digits.slice(0, pointPos) + "." + digits.slice(pointPos);
-  }
-  return sign + body;
-}
-function toCanonicalDecimalString(input) {
-  let s;
-  if (typeof input === "number") {
-    if (!Number.isFinite(input)) return null;
-    s = String(input);
-  } else {
-    s = input.trim();
-  }
-  s = expandExponent(s);
-  if (s.startsWith("+")) s = s.slice(1);
-  if (!/^-?(\d+(\.\d*)?|\.\d+)$/.test(s)) return null;
-  return s;
-}
-function shouldRoundUp(negative, lastKeptDigit, firstDiscarded, hasMoreNonZeroAfterFirst, mode) {
-  switch (mode) {
-    case "up":
-      return true;
-    case "down":
-      return false;
-    case "ceil":
-      return !negative;
-    case "floor":
-      return negative;
-    case "half-up":
-      return firstDiscarded >= 5;
-    case "half-down":
-      return firstDiscarded > 5 || firstDiscarded === 5 && hasMoreNonZeroAfterFirst;
-    case "half-even":
-      if (firstDiscarded > 5) return true;
-      if (firstDiscarded < 5) return false;
-      return hasMoreNonZeroAfterFirst || lastKeptDigit % 2 === 1;
-  }
-}
-function parseToScaledInt(input, scale, rounding) {
-  const canonical = toCanonicalDecimalString(input);
-  if (canonical === null) return { ok: false, reason: "nonfinite" };
-  const negative = canonical.startsWith("-");
-  const unsigned = negative ? canonical.slice(1) : canonical;
-  const dot = unsigned.indexOf(".");
-  const intPart = dot === -1 ? unsigned : unsigned.slice(0, dot);
-  const fracPart = dot === -1 ? "" : unsigned.slice(dot + 1);
-  const intDigits = intPart === "" ? "0" : intPart;
-  if (fracPart.length <= scale) {
-    const keep2 = fracPart.padEnd(scale, "0");
-    const magnitude2 = BigInt(intDigits + keep2);
-    return { ok: true, value: negative && magnitude2 !== 0n ? -magnitude2 : magnitude2 };
-  }
-  const keep = fracPart.slice(0, scale);
-  const tail = fracPart.slice(scale);
-  const magnitudeDigits = intDigits + keep;
-  let magnitude = BigInt(magnitudeDigits);
-  if (/^0+$/.test(tail)) {
-    return { ok: true, value: negative && magnitude !== 0n ? -magnitude : magnitude };
-  }
-  if (rounding === void 0) return { ok: false, reason: "precision" };
-  const lastKeptDigit = Number(magnitudeDigits[magnitudeDigits.length - 1]);
-  const firstDiscarded = Number(tail[0]);
-  const hasMoreNonZeroAfterFirst = /[1-9]/.test(tail.slice(1));
-  if (shouldRoundUp(negative, lastKeptDigit, firstDiscarded, hasMoreNonZeroAfterFirst, rounding)) {
-    magnitude += 1n;
-  }
-  return { ok: true, value: negative && magnitude !== 0n ? -magnitude : magnitude };
-}
-function formatScaledInt(value, scale) {
-  const negative = value < 0n;
-  const abs = (negative ? -value : value).toString();
-  if (scale === 0) return (negative ? "-" : "") + abs;
-  const padded = abs.padStart(scale + 1, "0");
-  const cut = padded.length - scale;
-  const intPart = padded.slice(0, cut);
-  const fracPart = padded.slice(cut);
-  return (negative ? "-" : "") + intPart + "." + fracPart;
-}
-var init_fixed_point = __esm({
-  "src/money/fixed-point.ts"() {
-    "use strict";
-  }
-});
-
-// src/money/iso4217.ts
-function scaleForCurrency(code) {
-  const v = MINOR_UNITS[code];
-  return v === void 0 ? null : v;
-}
-var MINOR_UNITS;
-var init_iso4217 = __esm({
-  "src/money/iso4217.ts"() {
-    "use strict";
-    MINOR_UNITS = {
-      // 2-decimal majors
-      EUR: 2,
-      USD: 2,
-      GBP: 2,
-      CHF: 2,
-      CAD: 2,
-      AUD: 2,
-      NZD: 2,
-      SGD: 2,
-      HKD: 2,
-      CNY: 2,
-      INR: 2,
-      BRL: 2,
-      MXN: 2,
-      ZAR: 2,
-      RUB: 2,
-      TRY: 2,
-      PLN: 2,
-      SEK: 2,
-      NOK: 2,
-      DKK: 2,
-      CZK: 2,
-      HUF: 2,
-      RON: 2,
-      ILS: 2,
-      THB: 2,
-      PHP: 2,
-      MYR: 2,
-      IDR: 2,
-      AED: 2,
-      SAR: 2,
-      QAR: 2,
-      EGP: 2,
-      // 0-decimal
-      JPY: 0,
-      KRW: 0,
-      ISK: 0,
-      CLP: 0,
-      VND: 0,
-      XOF: 0,
-      XAF: 0,
-      PYG: 0,
-      // 3-decimal
-      BHD: 3,
-      KWD: 3,
-      OMR: 3,
-      TND: 3,
-      JOD: 3,
-      IQD: 3,
-      LYD: 3
-    };
-  }
-});
-
-// src/money/descriptor.ts
-var MoneyUnsupportedError;
-var init_descriptor = __esm({
-  "src/money/descriptor.ts"() {
-    "use strict";
-    init_errors();
-    MoneyUnsupportedError = class extends NoydbError {
-      constructor(field, message) {
-        super(
-          "MONEY_UNSUPPORTED",
-          message ?? `money: operation is not supported on field "${field}" \u2014 use sum() and count() and divide at the boundary`
-        );
-        this.field = field;
-        this.name = "MoneyUnsupportedError";
-      }
-      field;
-    };
-  }
-});
-
-// src/query/predicate.ts
-function readPath(record, path) {
-  if (record === null || record === void 0) return void 0;
-  if (!path.includes(".")) {
-    return record[path];
-  }
-  const segments = path.split(".");
-  let cursor = record;
-  for (const segment of segments) {
-    if (cursor === null || cursor === void 0) return void 0;
-    cursor = cursor[segment];
-  }
-  return cursor;
-}
-var init_predicate = __esm({
-  "src/query/predicate.ts"() {
-    "use strict";
-  }
-});
-
-// src/aggregate/canonical-key.ts
-function canonicalGroupKey(fields, row) {
-  const sorted = [...fields].sort();
-  const parts = [];
-  for (const name of sorted) {
-    const v = row[name];
-    const serialised = v === void 0 ? "undefined" : JSON.stringify(v);
-    parts.push(`${name}=${serialised}`);
-  }
-  return parts.join("|");
-}
-var init_canonical_key = __esm({
-  "src/aggregate/canonical-key.ts"() {
-    "use strict";
-  }
-});
-
-// src/money/money-reducer.ts
-function toScaledIntFromAny(v, scale) {
-  if (typeof v === "bigint") return v;
-  if (typeof v === "number") {
-    const r = parseToScaledInt(v, scale);
-    return r.ok ? r.value : null;
-  }
-  if (typeof v === "string") {
-    if (!v.includes(".")) {
-      try {
-        return BigInt(v);
-      } catch {
-        return null;
-      }
-    }
-    const r = parseToScaledInt(v, scale);
-    return r.ok ? r.value : null;
-  }
-  return null;
-}
-function readMoney(record, field, desc) {
-  const raw = readPath(record, field);
-  if (raw === null || raw === void 0) return null;
-  if (desc.mode === "fixed") {
-    const cur = desc.fixedCurrency;
-    const value2 = toScaledIntFromAny(raw, desc.scaleFor(cur));
-    return value2 === null ? null : { currency: cur, value: value2 };
-  }
-  if (typeof raw !== "object") return null;
-  const o = raw;
-  if (typeof o.currency !== "string") return null;
-  const scale = desc.allows(o.currency) ? desc.scaleFor(o.currency) : 0;
-  const value = toScaledIntFromAny(o.amount, scale);
-  return value === null ? null : { currency: o.currency, value };
-}
-function targetScaleFor(desc, currency) {
-  if (desc.allows(currency)) return desc.scaleFor(currency);
-  const s = scaleForCurrency(currency);
-  if (s === null) {
-    throw new Error(`money: cannot determine scale for conversion target "${currency}"`);
-  }
-  return s;
-}
-function parseRate(rate) {
-  const s = String(rate).trim();
-  const neg = s.startsWith("-");
-  const body = neg ? s.slice(1) : s;
-  const dot = body.indexOf(".");
-  const intPart = dot === -1 ? body : body.slice(0, dot);
-  const fracPart = dot === -1 ? "" : body.slice(dot + 1);
-  const int = BigInt((intPart === "" ? "0" : intPart) + fracPart);
-  return { int: neg ? -int : int, scale: fracPart.length };
-}
-function divRoundHalfEven(n, d) {
-  const q = n / d;
-  const r = n % d;
-  const twiceR = (r < 0n ? -r : r) * 2n;
-  if (twiceR < d) return q;
-  if (twiceR > d) return q + (n < 0n ? -1n : 1n);
-  return q % 2n === 0n ? q : q + (n < 0n ? -1n : 1n);
-}
-function convertScaled(value, srcScale, rate, targetScale) {
-  const { int: rateInt, scale: rateScale } = parseRate(rate);
-  const product = value * rateInt;
-  const curScale = srcScale + rateScale;
-  if (curScale === targetScale) return product;
-  if (curScale < targetScale) return product * 10n ** BigInt(targetScale - curScale);
-  return divRoundHalfEven(product, 10n ** BigInt(curScale - targetScale));
-}
-function finalizeSum(state, desc, convertTo, fx) {
-  if (convertTo !== void 0) {
-    if (fx === void 0) {
-      throw new Error(`money: sum convertTo "${convertTo}" requires an fx rate map`);
-    }
-    const targetScale = targetScaleFor(desc, convertTo);
-    let total = 0n;
-    for (const [cur, v] of state) {
-      if (cur === convertTo) {
-        total += convertScaled(v, desc.scaleFor(cur), 1, targetScale);
-        continue;
-      }
-      const rate = fx[`${cur}->${convertTo}`];
-      if (rate === void 0) {
-        throw new Error(`money: no fx rate for "${cur}->${convertTo}"`);
-      }
-      total += convertScaled(v, desc.scaleFor(cur), rate, targetScale);
-    }
-    return formatScaledInt(total, targetScale);
-  }
-  if (desc.mode === "fixed") {
-    const cur = desc.fixedCurrency;
-    return formatScaledInt(state.get(cur) ?? 0n, desc.scaleFor(cur));
-  }
-  const out = {};
-  for (const [cur, v] of state) out[cur] = formatScaledInt(v, desc.scaleFor(cur));
-  return out;
-}
-function moneySumReducer(field, desc, convertTo, fx) {
-  return {
-    op: "sum",
-    field,
-    init: () => /* @__PURE__ */ new Map(),
-    step: (state, record) => {
-      const m = readMoney(record, field, desc);
-      if (m) state.set(m.currency, (state.get(m.currency) ?? 0n) + m.value);
-      return state;
-    },
-    remove: (state, record) => {
-      const m = readMoney(record, field, desc);
-      if (m) state.set(m.currency, (state.get(m.currency) ?? 0n) - m.value);
-      return state;
-    },
-    finalize: (state) => finalizeSum(state, desc, convertTo, fx)
-  };
-}
-function extremum(values, op) {
-  let out = values[0];
-  for (let i = 1; i < values.length; i++) {
-    const v = values[i];
-    if (op === "min" ? v < out : v > out) out = v;
-  }
-  return out;
-}
-function moneyMinMaxReducer(op, field, desc) {
-  return {
-    op,
-    field,
-    init: () => /* @__PURE__ */ new Map(),
-    step: (state, record) => {
-      const m = readMoney(record, field, desc);
-      if (m) {
-        const arr = state.get(m.currency);
-        if (arr) arr.push(m.value);
-        else state.set(m.currency, [m.value]);
-      }
-      return state;
-    },
-    remove: (state, record) => {
-      const m = readMoney(record, field, desc);
-      if (m) {
-        const arr = state.get(m.currency);
-        if (arr) {
-          const idx = arr.indexOf(m.value);
-          if (idx >= 0) arr.splice(idx, 1);
-        }
-      }
-      return state;
-    },
-    finalize: (state) => {
-      if (desc.mode === "fixed") {
-        const cur = desc.fixedCurrency;
-        const arr = state.get(cur);
-        if (!arr || arr.length === 0) return null;
-        return formatScaledInt(extremum(arr, op), desc.scaleFor(cur));
-      }
-      const out = {};
-      for (const [cur, arr] of state) {
-        if (arr.length > 0) out[cur] = formatScaledInt(extremum(arr, op), desc.scaleFor(cur));
-      }
-      return out;
-    }
-  };
-}
-function wrapMoneyReducers(spec, moneyFields) {
-  let changed = false;
-  const out = {};
-  for (const [key, reducer] of Object.entries(spec)) {
-    const field = reducer.field;
-    const desc = field ? moneyFields[field] : void 0;
-    if (desc && reducer.op === "avg") {
-      throw new MoneyUnsupportedError(
-        field,
-        `avg() is not supported on money field "${field}" in v1 \u2014 use sum() and count() and divide at the boundary.`
-      );
-    }
-    if (desc && (reducer.op === "sum" || reducer.op === "min" || reducer.op === "max")) {
-      changed = true;
-      out[key] = reducer.op === "sum" ? moneySumReducer(field, desc, reducer.convertTo, reducer.fx) : moneyMinMaxReducer(reducer.op, field, desc);
-    } else {
-      out[key] = reducer;
-    }
-  }
-  return changed ? out : spec;
-}
-var init_money_reducer = __esm({
-  "src/money/money-reducer.ts"() {
-    "use strict";
-    init_predicate();
-    init_fixed_point();
-    init_iso4217();
-    init_descriptor();
-  }
-});
-
-// 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);
-  }
-  result = stripI18nFilled(result);
-  return result;
-}
-function stripI18nFilled(record) {
-  if (!Object.prototype.hasOwnProperty.call(record, "_i18nFilled")) return record;
-  const rest = { ...record };
-  delete rest._i18nFilled;
-  return rest;
-}
-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());
-  if (warnedCardinalityFields.has(key)) return;
-  warnedCardinalityFields.add(key);
-  const label = `[${fields.join(", ")}]`;
-  console.warn(
-    `[noy-db] .groupBy(${label}) produced ${observed} distinct groups, ${Math.round(observed / GROUPBY_MAX_CARDINALITY * 100)}% of the ${GROUPBY_MAX_CARDINALITY}-group ceiling. Narrow the query with .where() before grouping, or switch to a lower-cardinality field.`
-  );
-}
-function groupAndReduce(records, fieldOrFields, spec, moneyFields) {
-  const fields = typeof fieldOrFields === "string" ? [fieldOrFields] : fieldOrFields;
-  if (fields.length === 0) {
-    throw new Error(".groupBy() requires at least one field");
-  }
-  if (moneyFields) {
-    spec = wrapMoneyReducers(spec, moneyFields);
-  }
-  const buckets = /* @__PURE__ */ new Map();
-  const fieldLabel = fields.length === 1 ? fields[0] : `[${fields.join(", ")}]`;
-  for (const record of records) {
-    const keyValues = {};
-    for (const f of fields) {
-      keyValues[f] = readPath(record, f);
-    }
-    const dedupKey = canonicalGroupKey(fields, keyValues);
-    let bucket = buckets.get(dedupKey);
-    if (bucket === void 0) {
-      if (buckets.size >= GROUPBY_MAX_CARDINALITY) {
-        throw new GroupCardinalityError(
-          fieldLabel,
-          buckets.size + 1,
-          GROUPBY_MAX_CARDINALITY
-        );
-      }
-      bucket = { keyValues, records: [] };
-      buckets.set(dedupKey, bucket);
-    }
-    bucket.records.push(record);
-  }
-  if (buckets.size >= GROUPBY_WARN_CARDINALITY) {
-    warnCardinalityApproaching(fields, buckets.size);
-  }
-  const reducerKeys = Object.keys(spec);
-  const out = [];
-  for (const bucket of buckets.values()) {
-    const state = {};
-    for (const rk of reducerKeys) {
-      state[rk] = spec[rk].init();
-    }
-    for (const record of bucket.records) {
-      for (const rk of reducerKeys) {
-        state[rk] = spec[rk].step(state[rk], record);
-      }
-    }
-    const row = {};
-    for (const f of fields) {
-      row[f] = bucket.keyValues[f];
-    }
-    for (const rk of reducerKeys) {
-      row[rk] = spec[rk].finalize(state[rk]);
-    }
-    out.push(row);
-  }
-  return out;
-}
-var GROUPBY_WARN_CARDINALITY, GROUPBY_MAX_CARDINALITY, warnedCardinalityFields;
-var init_groupby = __esm({
-  "src/aggregate/groupby.ts"() {
-    "use strict";
-    init_predicate();
-    init_canonical_key();
-    init_errors();
-    init_money_reducer();
-    GROUPBY_WARN_CARDINALITY = 1e4;
-    GROUPBY_MAX_CARDINALITY = 1e5;
-    warnedCardinalityFields = /* @__PURE__ */ new Set();
-  }
-});
-
-// src/materialized-views/executor.ts
-var executor_exports = {};
-__export(executor_exports, {
-  MaterializedViewExecutor: () => MaterializedViewExecutor
-});
-async function materializeQueryResult(q, mvName, i18nLocale, i18nFields) {
-  if (typeof q?.toArray === "function") {
-    return await q.toArray();
-  }
-  if (typeof q?.run === "function") {
-    const runOpts = i18nLocale !== void 0 ? { locale: i18nLocale, i18nFields } : void 0;
-    const result = await Promise.resolve(q.run(runOpts));
-    if (Array.isArray(result)) {
-      return result;
-    }
-    return [result];
-  }
-  throw new Error(
-    `MV "${mvName}": query() must return a Query<T>, Aggregation, or GroupedAggregation. Got something without a .toArray() or .run() terminal.`
-  );
-}
-async function materializeUnionResult(spec, db) {
-  const unified = [];
-  for (const arm of spec.unionSources) {
-    const coll = db.collection(arm.collection);
-    let q = coll.query();
-    if (arm.join?.length) {
-      for (const leg of arm.join) {
-        q = q.join(leg.field, { as: leg.as, maxRows: leg.maxRows, strategy: leg.strategy });
-      }
-    }
-    const sourceRows = q.toArray();
-    for (const r of sourceRows) {
-      const mapped = arm.map(r);
-      if (mapped == null) continue;
-      unified.push(mapped);
-    }
-  }
-  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) {
-      const k = canonicalGroupKey(groupFields, row);
-      if (!seen.has(k)) seen.set(k, row);
-    }
-    return [...seen.values()];
-  }
-  return groupAndReduce(unified, groupFields, spec.aggregate, spec.moneyFields);
-}
-async function listOutputIds(outputColl) {
-  const cAny = outputColl;
-  const adapter = cAny.adapter;
-  const vault = cAny.vault;
-  const name = cAny.name;
-  if (typeof adapter?.list !== "function") return [];
-  try {
-    const ids = await adapter.list(vault, name);
-    return [...ids];
-  } catch {
-    return [];
-  }
-}
-var DEFAULT_MAX_ROWS, MaterializedViewExecutor;
-var init_executor = __esm({
-  "src/materialized-views/executor.ts"() {
-    "use strict";
-    init_errors();
-    init_registry();
-    init_groupby();
-    init_canonical_key();
-    init_core();
-    DEFAULT_MAX_ROWS = 1e5;
-    MaterializedViewExecutor = {
-      async refresh(reg, accessor) {
-        const spec = reg.spec;
-        const outputColl = accessor.getCollection(reg.outputCollection);
-        const maxRows = spec.maxRows ?? DEFAULT_MAX_ROWS;
-        const onEmpty = spec.onEmpty ?? "delete";
-        const strict = spec.strict ?? false;
-        const baseCtx = accessor.getQueryContext();
-        const ctxForQuery = spec.predicates ? wrapDbWithPredicates(baseCtx, spec.predicates) : baseCtx;
-        let rows;
-        if (spec.unionSources) {
-          rows = await materializeUnionResult(spec, ctxForQuery);
-        } else {
-          const q = spec.query(ctxForQuery);
-          rows = await materializeQueryResult(q, spec.name, spec.i18nLocale, spec.i18nFields);
-        }
-        if (rows.length > maxRows) {
-          throw new MaterializedViewTooLargeError(spec.name, rows.length, maxRows);
-        }
-        const txCtx = accessor.getActiveTxContext();
-        const adapter = outputColl.adapter;
-        const vaultName = outputColl.vault;
-        const newIds = /* @__PURE__ */ new Set();
-        const enrichedRows = [];
-        for (const row of rows) {
-          const id = spec.rowKey(row);
-          newIds.add(id);
-          const meta = {
-            mvName: spec.name,
-            queryHash: reg.queryHash,
-            sourceVersions: {},
-            materializedAt: (/* @__PURE__ */ new Date()).toISOString()
-          };
-          enrichedRows.push({ id, record: { ...row, _materializedFrom: meta } });
-        }
-        let written = 0;
-        let failed = 0;
-        for (const { id, record } of enrichedRows) {
-          try {
-            if (txCtx !== null) {
-              const prior = await adapter.get(vaultName, reg.outputCollection, id);
-              txCtx._executed.push({
-                op: { type: "put", vaultName, collectionName: reg.outputCollection, id },
-                priorEnvelope: prior
-              });
-            }
-            await outputColl.put(id, record);
-            written++;
-          } catch (err) {
-            failed++;
-            if (strict) throw err;
-            console.warn(`[mv] "${spec.name}" row write failed:`, err);
-          }
-        }
-        let deleted = 0;
-        if (onEmpty === "delete") {
-          const priorIds = await listOutputIds(outputColl);
-          for (const priorId of priorIds) {
-            if (newIds.has(priorId)) continue;
-            try {
-              const outAny = outputColl;
-              if (typeof outAny._internalDelete === "function") {
-                await outAny._internalDelete(priorId, txCtx);
-                deleted++;
-              } else {
-                await outputColl.delete(priorId);
-                deleted++;
-              }
-            } catch (err) {
-              failed++;
-              if (strict) throw err;
-              console.warn(`[mv] "${spec.name}" tombstone failed for id="${priorId}":`, err);
-            }
-          }
-        }
-        return { written, deleted, failed };
-      }
-    };
-  }
-});
-
-// src/materialized-views/index.ts
-var materialized_views_exports = {};
-__export(materialized_views_exports, {
-  MaterializedViewConfigError: () => MaterializedViewConfigError,
-  MaterializedViewCycleError: () => MaterializedViewCycleError,
-  MaterializedViewExecutor: () => MaterializedViewExecutor,
-  MaterializedViewRegistry: () => MaterializedViewRegistry,
-  MaterializedViewSourceUnknownError: () => MaterializedViewSourceUnknownError,
-  MaterializedViewTooLargeError: () => MaterializedViewTooLargeError,
-  analyzeDependencies: () => analyzeDependencies,
-  canonicalizeQueryPlan: () => canonicalizeQueryPlan,
-  clearMVStale: () => clearMVStale,
-  computeQueryHash: () => computeQueryHash,
-  isMVStale: () => isMVStale,
-  markMVStale: () => markMVStale,
-  resolveStaleMVOnRead: () => resolveStaleMVOnRead,
-  summarizeQueryPlan: () => summarizeQueryPlan,
-  withMaterializedView: () => withMaterializedView
-});
-module.exports = __toCommonJS(materialized_views_exports);
-
-// src/materialized-views/with-materialized-view.ts
-init_errors();
-function withMaterializedView(spec) {
-  if (!spec.name || spec.name.length === 0) {
-    throw new ValidationError("withMaterializedView: name is required");
-  }
-  if (spec.query && spec.unionSources) {
-    throw new MaterializedViewConfigError(
-      "query and unionSources are mutually exclusive \u2014 pick one"
-    );
-  }
-  if (!spec.query && !spec.unionSources) {
-    throw new MaterializedViewConfigError(
-      "strategy must declare either query or unionSources"
-    );
-  }
-  if (spec.query !== void 0 && typeof spec.query !== "function") {
-    throw new ValidationError("withMaterializedView: query must be a function returning a Query<T>");
-  }
-  if (spec.unionSources) {
-    if (spec.unionSources.length < 1) {
-      throw new MaterializedViewConfigError(
-        "unionSources requires at least 1 source collection"
-      );
-    }
-    const seen = /* @__PURE__ */ new Set();
-    for (const s of spec.unionSources) {
-      if (typeof s?.collection !== "string" || s.collection.length === 0) {
-        throw new MaterializedViewConfigError(
-          "each unionSources entry must declare a non-empty `collection` string"
-        );
-      }
-      if (typeof s.map !== "function") {
-        throw new MaterializedViewConfigError(
-          `unionSources entry for "${s.collection}" is missing a \`map\` function`
-        );
-      }
-      if (seen.has(s.collection)) {
-        throw new MaterializedViewConfigError(
-          `unionSources must reference distinct collections (duplicate: "${s.collection}")`
-        );
-      }
-      seen.add(s.collection);
-    }
-    if (Array.isArray(spec.groupBy) && spec.groupBy.length === 0) {
-      throw new MaterializedViewConfigError(
-        `withMaterializedView "${spec.name}": groupBy must not be an empty array \u2014 omit it or provide at least one field name`
-      );
-    }
-    if (spec.aggregate && !spec.groupBy) {
-      throw new MaterializedViewConfigError(
-        `withMaterializedView "${spec.name}": UNION strategy with aggregate requires groupBy \u2014 use groupBy to declare the bucketing keys, or remove aggregate for a pure dedup MV`
-      );
-    }
-    if (spec.moneyFields && !spec.aggregate) {
-      throw new MaterializedViewConfigError(
-        `withMaterializedView "${spec.name}": moneyFields requires aggregate \u2014 moneyFields rewrites sum/min/max reducers over money output fields, so it is meaningless without an aggregate spec`
-      );
-    }
-    if (spec.unionSources.some((s) => s.join && s.join.length > 0) && (!spec.sources || spec.sources.length === 0)) {
-      throw new MaterializedViewConfigError(
-        `withMaterializedView "${spec.name}": a unionSources arm declares join(s) but no \`sources\` are listed \u2014 declare sources: [...] with the right-side (join-target) collection names so writes to them trigger MV refresh`
-      );
-    }
-    if (spec.predicates) {
-      throw new MaterializedViewConfigError(
-        `withMaterializedView "${spec.name}": predicates are not supported on UNION strategies \u2014 UNION mode does not use a Query<T> chain, so .wherePredicate() cannot fire. Use the query() form, or open an issue if per-arm predicates are needed`
-      );
-    }
-  }
-  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)");
-  }
-  if (spec.refresh !== "eager" && spec.refresh !== "lazy" && spec.refresh !== "manual") {
-    throw new ValidationError(
-      `withMaterializedView: refresh must be 'eager' | 'lazy' | 'manual', got "${String(spec.refresh)}"`
-    );
-  }
-  return {
-    __noydb_strategy: "materialized-view",
-    spec
-  };
-}
-
-// src/materialized-views/index.ts
-init_registry();
-init_executor();
-init_dependency_analyzer();
-init_query_hash();
-
-// src/materialized-views/stale.ts
-var _staleByRegistry = /* @__PURE__ */ new WeakMap();
-function markMVStale(registry, mvName) {
-  let set = _staleByRegistry.get(registry);
-  if (!set) {
-    set = /* @__PURE__ */ new Set();
-    _staleByRegistry.set(registry, set);
-  }
-  set.add(mvName);
-}
-function isMVStale(registry, mvName) {
-  return _staleByRegistry.get(registry)?.has(mvName) ?? false;
-}
-async function resolveStaleMVOnRead(accessor, outputCollection) {
-  const registry = accessor.registry();
-  const pending = _staleByRegistry.get(registry);
-  if (!pending || pending.size === 0) return;
-  const candidates = [];
-  for (const mv of registry.all()) {
-    if (mv.outputCollection !== outputCollection) continue;
-    if (!pending.has(mv.spec.name)) continue;
-    candidates.push(mv.spec.name);
-  }
-  if (candidates.length === 0) return;
-  let executor = null;
-  for (const name of candidates) {
-    const reg = registry.byName(name);
-    if (!reg) {
-      pending.delete(name);
-      continue;
-    }
-    if (executor === null) {
-      ({ MaterializedViewExecutor: executor } = await Promise.resolve().then(() => (init_executor(), executor_exports)));
-    }
-    await executor.refresh(reg, {
-      getCollection: (n) => accessor.getCollection(n),
-      getActiveTxContext: () => accessor.getActiveTxContext(),
-      getQueryContext: () => accessor.getQueryContext()
-    });
-    pending.delete(name);
-  }
-}
-function clearMVStale(registry, mvName) {
-  _staleByRegistry.get(registry)?.delete(mvName);
-}
-
-// src/materialized-views/index.ts
-init_errors();
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  MaterializedViewConfigError,
-  MaterializedViewCycleError,
-  MaterializedViewExecutor,
-  MaterializedViewRegistry,
-  MaterializedViewSourceUnknownError,
-  MaterializedViewTooLargeError,
-  analyzeDependencies,
-  canonicalizeQueryPlan,
-  clearMVStale,
-  computeQueryHash,
-  isMVStale,
-  markMVStale,
-  resolveStaleMVOnRead,
-  summarizeQueryPlan,
-  withMaterializedView
-});
-//# sourceMappingURL=index.cjs.map