@noy-db/hub 0.3.0-pre.9 → 0.3.0

package/dist/chunk-SZCHEDML.js

@@ -1,209 +0,0 @@
-import {
-  OverlayIdMismatchError
-} from "./chunk-CU62BBRB.js";
-
-// src/with-formula/overlay-views/virtual-collection.ts
-var OverlayedCollection = class {
-  constructor(spec, baseCollection, overlayCollection, baseRowKey) {
-    this.spec = spec;
-    this.baseCollection = baseCollection;
-    this.overlayCollection = overlayCollection;
-    this.baseRowKey = baseRowKey;
-  }
-  spec;
-  baseCollection;
-  overlayCollection;
-  baseRowKey;
-  /**
-   * Convenience accessors for advanced callers that need to bypass the
-   * virtual layer (bulk imports, direct overlay queries). Mirrors the
-   * spec's "direct writes to the underlying overlay collection skip
-   * the validation" escape hatch.
-   */
-  overlay = {
-    rowKey: (row) => {
-      if (!this.baseRowKey) {
-        throw new Error(
-          `Overlay "${this.spec.name}": base "${this.spec.base}" is not an MV \u2014 cannot auto-derive id from the row. Use \`put(id, record)\` instead.`
-        );
-      }
-      return this.baseRowKey(row);
-    }
-  };
-  /** Get the merged row by id. */
-  async get(id) {
-    const overlayRow = await this.overlayCollection.get(id);
-    const baseRow = await this.baseCollection.get(id);
-    return this.mergeRows(overlayRow, baseRow);
-  }
-  /** List union of base + overlay ids, applying the merge per row. */
-  async list() {
-    const baseRows = await this.baseCollection.list();
-    const overlayRows = await this.overlayCollection.list();
-    const idOf = (row) => {
-      if (this.baseRowKey) return this.baseRowKey(row);
-      const idField = row.id;
-      return typeof idField === "string" ? idField : "";
-    };
-    const baseById = /* @__PURE__ */ new Map();
-    const overlayById = /* @__PURE__ */ new Map();
-    for (const row of baseRows) {
-      const id = idOf(row);
-      if (id) baseById.set(id, row);
-    }
-    for (const row of overlayRows) {
-      const id = idOf(row);
-      if (id) overlayById.set(id, row);
-    }
-    const out = [];
-    for (const id of /* @__PURE__ */ new Set([...baseById.keys(), ...overlayById.keys()])) {
-      const merged = this.mergeRows(overlayById.get(id) ?? null, baseById.get(id) ?? null);
-      if (merged !== null) out.push(merged);
-    }
-    return out;
-  }
-  /**
-   * Write to the overlay. Two forms:
-   * - `put(record)`: id is derived via the base MV's `rowKey(record)`.
-   *   Throws if the base isn't an MV.
-   * - `put(id, record)`: validates `id === rowKey(record)`; throws
-   *   `OverlayIdMismatchError` on mismatch.
-   */
-  async put(idOrRecord, maybeRecord) {
-    let id;
-    let record;
-    if (maybeRecord === void 0) {
-      record = idOrRecord;
-      if (!this.baseRowKey) {
-        throw new Error(
-          `Overlay "${this.spec.name}".put(record): base "${this.spec.base}" is not an MV. Use put(id, record) explicitly.`
-        );
-      }
-      id = this.baseRowKey(record);
-    } else {
-      id = idOrRecord;
-      record = maybeRecord;
-      if (this.baseRowKey) {
-        const expected = this.baseRowKey(record);
-        if (id !== expected) {
-          throw new OverlayIdMismatchError(id, expected);
-        }
-      }
-    }
-    await this.overlayCollection.put(id, record);
-  }
-  /**
-   * Remove the overlay row only. Idempotent (no-op on absent).
-   * The base row is untouched — if a base row exists for `id`,
-   * subsequent reads return it.
-   */
-  async delete(id) {
-    await this.overlayCollection.delete(id);
-  }
-  /**
-   * Merge a single id's overlay + base rows into the visible row.
-   *
-   * Priority (first match wins):
-   *  1. Binary shadow win — overlay present AND
-   *     `overlay[shadowField] === shadowValue` → return the overlay row
-   *     entirely. This stays FIRST so the original binary behaviour is
-   *     unchanged whether or not `mergeMode` is configured.
-   *  2. Field-level merge — overlay present, `mergeMode` configured,
-   *     and a rule whose `whenStatus` equals `overlay[shadowField]`.
-   *     The matched rule pulls its `overlayFields` (those present on
-   *     the overlay row) on top of the base row. With no base row, the
-   *     overlay row is returned as-is.
-   *  3. Fallback — return the base row (possibly `null`). An
-   *     overlay-only row that qualifies under neither (1) nor (2) and
-   *     has no base is therefore NOT surfaced.
-   */
-  mergeRows(overlayRow, baseRow) {
-    const shadowField = this.spec.shadowField;
-    if (overlayRow !== null && overlayRow[shadowField] === this.spec.shadowValue) {
-      return overlayRow;
-    }
-    if (overlayRow !== null && this.spec.mergeMode) {
-      const status = overlayRow[shadowField];
-      const rule = this.spec.mergeMode.rules.find((r) => r.whenStatus === status);
-      if (rule) {
-        if (baseRow === null) return overlayRow;
-        const overlaySrc = overlayRow;
-        const picked = {};
-        for (const field of rule.overlayFields) {
-          if (field in overlaySrc) picked[field] = overlaySrc[field];
-        }
-        return { ...baseRow, ...picked };
-      }
-    }
-    return baseRow;
-  }
-  // ─── Throw-stubs for the unimplemented Collection<T> surface ───────
-  //
-  // `Vault.collection(name)` widens the return type to `Collection<T>`
-  // for the overlay intercept, but `OverlayedCollection` doesn't
-  // implement the full surface. These stubs catch the common
-  // reactive / chainable APIs with a clear "not yet implemented"
-  // error pointing at the relevant issue — so consumers don't hit a
-  // cryptic `undefined is not a function` runtime crash.
-  //
-  // Throw-stubs so consumers get actionable errors rather than cryptic crashes.
-  /** @throws — chainable Query<T> over a virtual collection is deferred. */
-  query() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".query() is not yet implemented for overlay views (#154). Use \`list()\` + filter for now, or read from the underlying \`${this.spec.base}\` / \`${this.spec.overlay}\` collections directly. Reactive APIs land in a future MV sub-issue.`
-    );
-  }
-  /** @throws — change-stream subscription over a virtual collection is deferred. */
-  subscribe() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".subscribe() is not yet implemented for overlay views (#154). Subscribe to the underlying \`${this.spec.base}\` / \`${this.spec.overlay}\` collections individually for now. Merged change-stream lands in a future MV sub-issue.`
-    );
-  }
-  /** @throws — live query over a virtual collection is deferred. */
-  live() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".live() is not yet implemented for overlay views (#154). Reactive APIs land in a future MV sub-issue.`
-    );
-  }
-  /** @throws — async iteration over a virtual collection is deferred. */
-  scan() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".scan() is not yet implemented for overlay views (#154). Use \`list()\` for now (no row-count ceiling at niwat scale), or scan the underlying collections directly.`
-    );
-  }
-  /** @throws — lazy-mode query is not applicable to virtual collections. */
-  lazyQuery() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".lazyQuery() is not supported. Virtual collections always materialize through base + overlay reads \u2014 lazy-mode indexed lookups don't apply.`
-    );
-  }
-  /** @throws — bulk-atomic put is deferred to a future MV sub-issue. */
-  putManyAtomic() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".putManyAtomic() is not yet implemented for overlay views (#154). Use sequential \`.put(record)\` calls for now, or write to \`${this.spec.overlay}\` directly.`
-    );
-  }
-  /** @throws — bulk delete is deferred to a future MV sub-issue. */
-  deleteMany() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".deleteMany() is not yet implemented for overlay views (#154). Use sequential \`.delete(id)\` calls for now, or operate on \`${this.spec.overlay}\` directly.`
-    );
-  }
-  /** @throws — `.first()` over a virtual collection is deferred. */
-  first() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".first() is not yet implemented for overlay views (#154). Use \`(await list())[0]\` for now.`
-    );
-  }
-  /** @throws — `.count()` over a virtual collection is deferred. */
-  count() {
-    throw new Error(
-      `OverlayedCollection "${this.spec.name}".count() is not yet implemented for overlay views (#154). Use \`(await list()).length\` for now.`
-    );
-  }
-};
-
-export {
-  OverlayedCollection
-};
-//# sourceMappingURL=chunk-SZCHEDML.js.map

package/dist/chunk-TDPEJINP.js

@@ -1,188 +0,0 @@
-import {
-  putDerivedOutput
-} from "./chunk-H57P2SJB.js";
-import {
-  wrapDbWithPredicates
-} from "./chunk-GZ2MOPVX.js";
-import {
-  canonicalGroupKey,
-  groupAndReduce
-} from "./chunk-2XE6LIXT.js";
-import {
-  applyI18nLocale
-} from "./chunk-3C5CKXFI.js";
-import {
-  LocaleNotSpecifiedError,
-  MaterializedViewTooLargeError
-} from "./chunk-CU62BBRB.js";
-
-// src/with-formula/materialized-views/executor.ts
-var DEFAULT_MAX_ROWS = 1e5;
-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);
-}
-var 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
-          });
-        }
-        if (accessor.dispatchCtx) {
-          if (await putDerivedOutput(outputColl, id, record, accessor.dispatchCtx) === "written") written++;
-        } else {
-          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 };
-  }
-};
-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 [];
-  }
-}
-
-export {
-  MaterializedViewExecutor
-};
-//# sourceMappingURL=chunk-TDPEJINP.js.map

package/dist/chunk-TDPEJINP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/with-formula/materialized-views/executor.ts"],"sourcesContent":["import type { Collection } from '../../kernel/collection.js'\nimport type { TxContext } from '../../with-commit/tx/transaction.js'\nimport type { EncryptedEnvelope } from '../../kernel/types.js'\nimport { MaterializedViewTooLargeError, LocaleNotSpecifiedError } from '../../kernel/errors.js'\nimport type { MaterializedFromMeta, MVQueryContext, MaterializedViewStrategy } from './types.js'\nimport type { RegisteredMV } from './registry.js'\nimport { wrapDbWithPredicates } from './registry.js'\nimport { groupAndReduce } from '../../with-lookup/aggregate/groupby.js'\nimport { canonicalGroupKey } from '../../with-lookup/aggregate/canonical-key.js'\nimport { applyI18nLocale, type I18nTextDescriptor } from '../../shape/via-i18n/core.js'\nimport { putDerivedOutput, type PutDerivedOutputCtx } from '../../kernel/via-dispatch.js'\n\n/**\n * Accessor shape passed in from the owning Vault. Mirrors v1's\n * `DerivationStaleAccessor` — provides the per-collection resolver\n * and the active TxContext so refresh writes/tombstones register on\n * `_executed` for rollback symmetry.\n */\nexport interface MVExecutorAccessor {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  getCollection(name: string): Collection<any>\n  getActiveTxContext(): TxContext | null\n  /**\n   * Vault-shaped accessor passed to the MV's `query()` callback at\n   * each refresh. Same instance the registry used at registration\n   * time; threading through the executor lets the refresh path\n   * re-evaluate the closure against the live vault state.\n   */\n  getQueryContext(): MVQueryContext\n  /**\n   * #638 Task 5 — ctx for `putDerivedOutput`'s frozen-period skip+audit. Optional:\n   * the lazy resolve-on-read caller (`stale.ts#resolveStaleMVOnRead`) does not supply\n   * one (no natural \"reacting write\" for a read-triggered materialize — out of this\n   * task's scope), so row writes there stay byte-identical to today (a closed-period\n   * row throws `PeriodClosedError` same as before). Every write/manual-refresh caller\n   * (`dispatchMaterializedViews`, `dispatchMaterializedViewsOnDelete`, `refreshView`)\n   * supplies one.\n   */\n  dispatchCtx?: PutDerivedOutputCtx\n}\n\nexport interface RefreshResult {\n  /** Rows newly written / overwritten. */\n  written: number\n  /** Rows tombstoned via `_internalDelete` (only when `onEmpty: 'delete'`). */\n  deleted: number\n  /** Failed row writes (non-strict mode). */\n  failed: number\n}\n\n/** Default cost ceiling — overridable per-MV via `spec.maxRows`. */\nconst DEFAULT_MAX_ROWS = 100_000\n\n/**\n * Materialize a query terminal that may be a `Query<T>` (call\n * `.toArray()`), an `Aggregation<R>` (call `.run()` returning a\n * single object — wrap as a one-row array), or a `GroupedAggregation<R>`\n * (call `.run()` returning an array of grouped rows). Branches on\n * available terminal at runtime — no type-discrimination at registration.\n */\nasync function materializeQueryResult(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  q: any,\n  mvName: string,\n  i18nLocale?: string,\n  i18nFields?: Record<string, I18nTextDescriptor>,\n): Promise<ReadonlyArray<Record<string, unknown>>> {\n  if (typeof q?.toArray === 'function') {\n    // Query<T> — non-aggregate path. `.toArray()` returns Promise<T[]>.\n    return await q.toArray()\n  }\n  if (typeof q?.run === 'function') {\n    // Aggregation<R> or GroupedAggregation<R>. `.run()` is synchronous\n    // and returns either a single object (Aggregation) or an array of\n    // rows (GroupedAggregation). Promise.resolve() normalizes both\n    // sync and async (future) variants.\n    // Query-form MV grouping: when the MV declares i18nLocale, pass it +\n    // i18nFields so a GroupedAggregation resolves i18n group keys before\n    // bucketing (the Aggregation path ignores the extra arg).\n    const runOpts = i18nLocale !== undefined ? { locale: i18nLocale, i18nFields } : undefined\n    const result: unknown = await Promise.resolve(q.run(runOpts))\n    if (Array.isArray(result)) {\n      return result as ReadonlyArray<Record<string, unknown>>\n    }\n    // Single-aggregate result — wrap as one-row array. The consumer's\n    // `rowKey()` should return a stable identity (often a literal\n    // constant like `'total'`) since there's only one row.\n    return [result as Record<string, unknown>]\n  }\n  throw new Error(\n    `MV \"${mvName}\": query() must return a Query<T>, Aggregation, or GroupedAggregation. ` +\n      `Got something without a .toArray() or .run() terminal.`,\n  )\n}\n\n/**\n * Materialize a UNION-form MV: read every arm's source\n * collection, apply each arm's `map` to project rows into the unified\n * MV row shape, concatenate the mapped streams, then optionally run\n * `groupBy` + `aggregate` over the result.\n *\n * Modes (driven by `spec.groupBy` / `spec.aggregate`):\n *\n *   - No `groupBy` → return the concatenated mapped rows unchanged.\n *   - `groupBy` without `aggregate` → dedupe by composite group key,\n *     keep the first row seen per key (later arms don't overwrite\n *     earlier arms — Map insertion order rules).\n *   - `groupBy` + `aggregate` → delegate to the shared `groupAndReduce`\n *     pipeline used by `Query.groupBy().aggregate()`.\n *\n * Per-arm `map` is the schema-unification boundary; the strategy's\n * `TRow` type parameter enforces that every arm projects into the\n * same shape at compile time.\n *\n * @internal\n */\nasync function materializeUnionResult<TRow extends Record<string, unknown>>(\n  spec: MaterializedViewStrategy<TRow>,\n  db: MVQueryContext,\n): Promise<ReadonlyArray<Record<string, unknown>>> {\n  const unified: TRow[] = []\n  for (const arm of spec.unionSources!) {\n    const coll = db.collection<Record<string, unknown>>(arm.collection)\n    // Optional per-arm FK joins: chain `.join(field, { as, ... })` for\n    // each declared leg before terminating. The aliased right-side\n    // record lands at `sourceRow[leg.as]`, where the arm's `map` reads\n    // it. Cast to `any` because the chained join widens the row type but\n    // the executor treats every row as `Record<string, unknown>` — same\n    // pattern the query-form join path uses.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let q: any = coll.query()\n    if (arm.join?.length) {\n      for (const leg of arm.join) {\n        q = q.join(leg.field, { as: leg.as, maxRows: leg.maxRows, strategy: leg.strategy })\n      }\n    }\n    const sourceRows = q.toArray() as ReadonlyArray<Record<string, unknown>>\n    for (const r of sourceRows) {\n      const mapped = arm.map(r)\n      // null / undefined means \"omit this source row\" — skip without\n      // pushing so groupBy/aggregate never see a null entry.\n      if (mapped == null) continue\n      unified.push(mapped)\n    }\n  }\n\n  if (!spec.groupBy) return unified\n\n  const groupFields: readonly string[] =\n    typeof spec.groupBy === 'string' ? [spec.groupBy] : spec.groupBy\n\n  // i18n-aware group keys. An `i18nText` group field carries a raw\n  // `{ locale: string }` map, an unstable object key. When `i18nLocale` is\n  // declared (with `i18nFields` describing those fields), resolve the declared\n  // group-key i18n fields to it at the `mv` layer FIRST — the same unified-rows\n  // boundary where money is threaded — so buckets are stable strings and the\n  // `mv`-layer `onMissing` policy fires here.\n  if (spec.i18nLocale !== undefined && spec.i18nFields !== undefined) {\n    const groupI18n: Record<string, I18nTextDescriptor> = {}\n    for (const f of groupFields) {\n      const d = spec.i18nFields[f]\n      if (d !== undefined) groupI18n[f] = d\n    }\n    if (Object.keys(groupI18n).length > 0) {\n      for (let i = 0; i < unified.length; i++) {\n        unified[i] = applyI18nLocale(unified[i] as Record<string, unknown>, groupI18n, spec.i18nLocale, undefined, 'mv') as TRow\n      }\n    }\n  }\n  // Guard (always): a remaining object-valued group key — an undeclared i18n\n  // field or a locale-less MV — would bucket on a map. Refuse, don't bucket wrong.\n  for (const f of groupFields) {\n    for (const row of unified) {\n      const v = (row as Record<string, unknown>)[f]\n      if (v !== null && typeof v === 'object') {\n        throw new LocaleNotSpecifiedError(\n          f,\n          `Materialized view \"${spec.name}\" groups by \"${f}\", whose value is a raw i18n locale map — ` +\n            `an unstable object group key. Declare { i18nLocale, i18nFields } on the MV to resolve it at ` +\n            `the 'mv' layer, or group by a dictKey/staticDict code (the stable key) and resolve the label at read time.`,\n        )\n      }\n    }\n  }\n\n  // groupBy without aggregate — dedupe by composite key, keep first\n  // seen row per key. Useful for cross-arm uniqueness (e.g. unify two\n  // sibling collections, keeping one row per natural key).\n  if (!spec.aggregate) {\n    const seen = new Map<string, TRow>()\n    for (const row of unified) {\n      const k = canonicalGroupKey(groupFields, row as Record<string, unknown>)\n      if (!seen.has(k)) seen.set(k, row)\n    }\n    return [...seen.values()]\n  }\n\n  // groupBy + aggregate — delegate to the shared pipeline used by\n  // `Query.groupBy().aggregate()`. Result rows carry each grouped\n  // field in declaration order followed by the spec's reducer outputs.\n  return groupAndReduce<Record<string, unknown>>(unified, groupFields, spec.aggregate, spec.moneyFields)\n}\n\n/**\n * Run an MV's `query()` and write the result rows to the output\n * collection. Same-DEK encryption: routes through the standard\n * `Collection.put` pipeline, so the output collection's DEK is what\n * gets used (matches the v2 spec's \"same DEK as the left-most source\"\n * invariant — `Collection.put` looks up the DEK by collection name,\n * and the output collection IS the MV's owned collection).\n *\n * Stamps `_materializedFrom` onto every emitted row.\n *\n * **Tombstoning:** when `spec.onEmpty: 'delete'` (default), rows\n * that existed in a prior refresh but no longer appear in the new\n * materialized result are deleted via `Collection._internalDelete` —\n * the housekeeping bypass primitive prevents user\n * `onDelete` guards on the output collection from firing on these\n * system-internal deletes. `onEmpty: 'keep'` opts out (rows from\n * prior refreshes linger even when the new result lacks them).\n *\n * **Cost ceiling:** if the materialized row count exceeds\n * `spec.maxRows` (default 100k), throws `MaterializedViewTooLargeError`\n * before any writes hit the store — so strict-mode rollback is\n * clean.\n *\n * **Strict mode:** `spec.strict === true` re-throws on any\n * row-write failure; the active TxContext registration means the\n * source-write rolls back atomically via `revertExecuted`.\n *\n * @internal\n */\nexport const MaterializedViewExecutor = {\n  async refresh(\n    reg: RegisteredMV,\n    accessor: MVExecutorAccessor,\n  ): Promise<RefreshResult> {\n    const spec = reg.spec\n    const outputColl = accessor.getCollection(reg.outputCollection)\n    const maxRows = spec.maxRows ?? DEFAULT_MAX_ROWS\n    const onEmpty = spec.onEmpty ?? 'delete'\n    const strict = spec.strict ?? false\n\n    // 1. Materialize the query (branches on terminal shape). If the\n    //    MV declared predicates, wrap the query context the same way\n    //    the registry did at registration time so `.wherePredicate()`\n    //    calls resolve to the registered functions.\n    const baseCtx = accessor.getQueryContext()\n    const ctxForQuery: MVQueryContext = spec.predicates\n      ? wrapDbWithPredicates(baseCtx, spec.predicates)\n      : baseCtx\n    // UNION-form strategies: read every arm, map to the unified\n    // row shape, concatenate, then optionally groupBy + aggregate. The\n    // single-source `query()` path is untouched.\n    let rows: ReadonlyArray<Record<string, unknown>>\n    if (spec.unionSources) {\n      rows = await materializeUnionResult(spec, ctxForQuery)\n    } else {\n      const q = spec.query!(ctxForQuery)\n      rows = await materializeQueryResult(q, spec.name, spec.i18nLocale, spec.i18nFields)\n    }\n\n    // 2. Cost ceiling check BEFORE any writes — keeps the rollback\n    //    clean if the source-write is wrapped in a transaction.\n    if (rows.length > maxRows) {\n      throw new MaterializedViewTooLargeError(spec.name, rows.length, maxRows)\n    }\n\n    const txCtx = accessor.getActiveTxContext()\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const adapter = (outputColl as any).adapter as {\n      get(v: string, c: string, i: string): Promise<EncryptedEnvelope | null>\n    }\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const vaultName = (outputColl as any).vault as string\n\n    // 3. Compute the post-refresh id set so we can diff against the\n    //    prior-emitted id set for tombstoning (when onEmpty === 'delete').\n    const newIds = new Set<string>()\n    const enrichedRows: Array<{ id: string; record: Record<string, unknown> }> = []\n    for (const row of rows) {\n      const id = spec.rowKey(row)\n      newIds.add(id)\n      const meta: MaterializedFromMeta = {\n        mvName: spec.name,\n        queryHash: reg.queryHash,\n        sourceVersions: {},\n        materializedAt: new Date().toISOString(),\n      }\n      enrichedRows.push({ id, record: { ...row, _materializedFrom: meta } })\n    }\n\n    // 4. Write the new rows.\n    let written = 0\n    let failed = 0\n    for (const { id, record } of enrichedRows) {\n      try {\n        if (txCtx !== null) {\n          const prior = await adapter.get(vaultName, reg.outputCollection, id)\n          txCtx._executed.push({\n            op: { type: 'put', vaultName, collectionName: reg.outputCollection, id },\n            priorEnvelope: prior,\n          })\n        }\n        if (accessor.dispatchCtx) {\n          if (await putDerivedOutput(outputColl, id, record, accessor.dispatchCtx) === 'written') written++\n        } else {\n          await outputColl.put(id, record)\n          written++\n        }\n      } catch (err) {\n        failed++\n        if (strict) throw err\n         \n        console.warn(`[mv] \"${spec.name}\" row write failed:`, err)\n      }\n    }\n\n    // 5. Tombstone rows that existed before but don't appear now.\n    //    `onEmpty: 'keep'` skips this pass entirely. Uses\n    //    `_internalDelete` so a user-registered `onDelete` on the\n    //    output collection does NOT fire on housekeeping (composition fix).\n    let deleted = 0\n    if (onEmpty === 'delete') {\n      const priorIds = await listOutputIds(outputColl)\n      for (const priorId of priorIds) {\n        if (newIds.has(priorId)) continue\n        try {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const outAny = outputColl as any\n          if (typeof outAny._internalDelete === 'function') {\n            await outAny._internalDelete(priorId, txCtx)\n            deleted++\n          } else {\n            // Defensive fallback — should never hit in real flow since\n            // every Collection has `_internalDelete`.\n            await outputColl.delete(priorId)\n            deleted++\n          }\n        } catch (err) {\n          failed++\n          if (strict) throw err\n           \n          console.warn(`[mv] \"${spec.name}\" tombstone failed for id=\"${priorId}\":`, err)\n        }\n      }\n    }\n\n    return { written, deleted, failed }\n  },\n}\n\n/**\n * List ids currently present in the MV's output collection via the\n * adapter directly (avoids triggering the lazy resolve-on-read path\n * we're INSIDE). Returns an empty array if the collection doesn't\n * exist or the adapter doesn't surface a list method.\n *\n * @internal\n */\nasync function listOutputIds(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  outputColl: Collection<any>,\n): Promise<string[]> {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const cAny = outputColl as any\n  const adapter = cAny.adapter as { list?: (v: string, c: string) => Promise<readonly string[]> }\n  const vault = cAny.vault as string\n  const name = cAny.name as string\n  if (typeof adapter?.list !== 'function') return []\n  try {\n    const ids = await adapter.list(vault, name)\n    return [...ids]\n  } catch {\n    return []\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-TQ3REHVF.js

@@ -1,95 +0,0 @@
-// src/with-shape/introspection/fields.ts
-function jsonSchemaType(node) {
-  if (Array.isArray(node.type)) {
-    const non = node.type.filter((t) => t !== "null");
-    return non[0] ?? "opaque";
-  }
-  if (node.enum && Array.isArray(node.enum)) return "enum";
-  if (node.const !== void 0) return "enum";
-  if (typeof node.type === "string") return node.type;
-  return "opaque";
-}
-function constraintsFor(node) {
-  const out = {};
-  if (node.enum) out.values = node.enum;
-  if (node.const !== void 0) out.values = [node.const];
-  if (node.minLength !== void 0) out.minLength = node.minLength;
-  if (node.maxLength !== void 0) out.maxLength = node.maxLength;
-  if (node.pattern !== void 0) out.pattern = node.pattern;
-  if (node.format !== void 0) out.format = node.format;
-  if (node.minimum !== void 0) out.minimum = node.minimum;
-  if (node.maximum !== void 0) out.maximum = node.maximum;
-  if (node.exclusiveMinimum !== void 0) out.gt = node.exclusiveMinimum;
-  if (node.exclusiveMaximum !== void 0) out.lt = node.exclusiveMaximum;
-  return Object.keys(out).length === 0 ? void 0 : out;
-}
-function extractObjectFields(obj, source, refs) {
-  const required = new Set(Array.isArray(obj.required) ? obj.required : []);
-  const fields = {};
-  if (!obj.properties || typeof obj.properties !== "object") return { fields, required };
-  for (const [name, node] of Object.entries(obj.properties)) {
-    const descriptor = {
-      type: jsonSchemaType(node),
-      source,
-      ...required.has(name) ? {} : { optional: true },
-      ...refs?.[name] ? { references: `${refs[name].target}.id` } : {}
-    };
-    const constraints = constraintsFor(node);
-    if (constraints) descriptor.constraints = constraints;
-    fields[name] = descriptor;
-  }
-  return { fields, required };
-}
-function mergeUnionMembers(members, source, refs) {
-  if (members.length === 0) return {};
-  const extracted = members.filter((m) => m.properties && typeof m.properties === "object").map((m) => extractObjectFields(m, source, refs));
-  if (extracted.length === 0) return {};
-  const allNames = /* @__PURE__ */ new Set();
-  for (const { fields } of extracted) {
-    for (const name of Object.keys(fields)) allNames.add(name);
-  }
-  const memberCount = extracted.length;
-  const out = {};
-  for (const name of allNames) {
-    const presentIn = extracted.filter(({ fields }) => name in fields);
-    const requiredInAll = presentIn.length === memberCount && presentIn.every(({ required }) => required.has(name));
-    const base = presentIn[0].fields[name];
-    const allValues = [];
-    for (const { fields } of presentIn) {
-      const fd = fields[name];
-      if (fd?.constraints?.values && Array.isArray(fd.constraints.values)) {
-        for (const v of fd.constraints.values) {
-          if (!allValues.includes(v)) allValues.push(v);
-        }
-      }
-    }
-    const mergedConstraints = allValues.length > 0 ? { ...base.constraints ?? {}, values: allValues } : base.constraints;
-    const descriptor = {
-      type: base.type,
-      source,
-      ...requiredInAll ? {} : { optional: true },
-      ...base.references ? { references: base.references } : {}
-    };
-    if (mergedConstraints) {
-      descriptor.constraints = mergedConstraints;
-    }
-    out[name] = descriptor;
-  }
-  return out;
-}
-function jsonSchemaToFields(jsonSchema, source, refs) {
-  if (!jsonSchema || typeof jsonSchema !== "object") return {};
-  const root = jsonSchema;
-  const unionMembers = root.anyOf ?? root.oneOf;
-  if (Array.isArray(unionMembers) && unionMembers.length > 0) {
-    return mergeUnionMembers(unionMembers, source, refs);
-  }
-  if (!root.properties || typeof root.properties !== "object") return {};
-  const { fields } = extractObjectFields(root, source, refs);
-  return fields;
-}
-
-export {
-  jsonSchemaToFields
-};
-//# sourceMappingURL=chunk-TQ3REHVF.js.map

package/dist/chunk-TQ3REHVF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/with-shape/introspection/fields.ts"],"sourcesContent":["/**\n * Map a JSON Schema (Draft 2020-12 produced by `zod-to-json-schema`) into\n * the {@link FieldDescriptor} map consumed by {@link VaultSchemaSnapshot}.\n *\n * Used by both the persisted-schema path (decrypted envelope body) and the\n * live-validator path (in-process derivation).\n *\n * @module\n */\n\nimport type { FieldDescriptor, FieldSource } from './types.js'\n\ninterface JsonSchemaShape {\n  type?: string | string[]\n  properties?: Record<string, JsonSchemaShape>\n  required?: string[]\n  enum?: unknown[]\n  const?: unknown\n  minLength?: number\n  maxLength?: number\n  pattern?: string\n  minimum?: number\n  maximum?: number\n  exclusiveMinimum?: number\n  exclusiveMaximum?: number\n  format?: string\n  items?: JsonSchemaShape\n  oneOf?: JsonSchemaShape[]\n  anyOf?: JsonSchemaShape[]\n}\n\nfunction jsonSchemaType(node: JsonSchemaShape): string {\n  if (Array.isArray(node.type)) {\n    const non = node.type.filter((t) => t !== 'null')\n    return non[0] ?? 'opaque'\n  }\n  if (node.enum && Array.isArray(node.enum)) return 'enum'\n  // JSON Schema `const` is used by zod-to-json-schema for z.literal(...)\n  if (node.const !== undefined) return 'enum'\n  if (typeof node.type === 'string') return node.type\n  return 'opaque'\n}\n\nfunction constraintsFor(node: JsonSchemaShape): Record<string, unknown> | undefined {\n  const out: Record<string, unknown> = {}\n  if (node.enum) out.values = node.enum\n  // JSON Schema `const` (used by zod-to-json-schema for z.literal) — treat like a single-value enum\n  if (node.const !== undefined) out.values = [node.const]\n  if (node.minLength !== undefined) out.minLength = node.minLength\n  if (node.maxLength !== undefined) out.maxLength = node.maxLength\n  if (node.pattern !== undefined) out.pattern = node.pattern\n  if (node.format !== undefined) out.format = node.format\n  if (node.minimum !== undefined) out.minimum = node.minimum\n  if (node.maximum !== undefined) out.maximum = node.maximum\n  if (node.exclusiveMinimum !== undefined) out.gt = node.exclusiveMinimum\n  if (node.exclusiveMaximum !== undefined) out.lt = node.exclusiveMaximum\n  return Object.keys(out).length === 0 ? undefined : out\n}\n\n/**\n * Extract fields from a single JSON Schema object node (must have `properties`).\n * Used by both the plain-object path and the per-member extraction in the union path.\n */\nfunction extractObjectFields(\n  obj: JsonSchemaShape,\n  source: FieldSource,\n  refs?: Record<string, { target: string; mode: string }>,\n): { fields: Record<string, FieldDescriptor>; required: Set<string> } {\n  const required = new Set(Array.isArray(obj.required) ? obj.required : [])\n  const fields: Record<string, FieldDescriptor> = {}\n  if (!obj.properties || typeof obj.properties !== 'object') return { fields, required }\n\n  for (const [name, node] of Object.entries(obj.properties)) {\n    const descriptor: FieldDescriptor = {\n      type: jsonSchemaType(node),\n      source,\n      ...(required.has(name) ? {} : { optional: true }),\n      ...(refs?.[name] ? { references: `${refs[name].target}.id` } : {}),\n    }\n    const constraints = constraintsFor(node)\n    if (constraints) (descriptor as { constraints?: Record<string, unknown> }).constraints = constraints\n    fields[name] = descriptor\n  }\n\n  return { fields, required }\n}\n\n/**\n * Merge field descriptors from multiple union members.\n *\n * Merge rules:\n * - Emit the UNION of all field names so no member's fields are hidden.\n * - A field is required (optional=false/absent) only when it is required in\n *   EVERY member; otherwise it is marked optional=true.\n * - For the discriminator field (appears in every member with a `const` value),\n *   collect the const values from all members and surface them as constraints.values\n *   so the caller can see the full literal set.\n * - For conflicting types across members, first-seen wins.\n */\nfunction mergeUnionMembers(\n  members: JsonSchemaShape[],\n  source: FieldSource,\n  refs?: Record<string, { target: string; mode: string }>,\n): Record<string, FieldDescriptor> {\n  if (members.length === 0) return {}\n\n  // Extract per-member fields + required sets\n  const extracted = members\n    .filter((m) => m.properties && typeof m.properties === 'object')\n    .map((m) => extractObjectFields(m, source, refs))\n\n  if (extracted.length === 0) return {}\n\n  // Collect all field names across all members\n  const allNames = new Set<string>()\n  for (const { fields } of extracted) {\n    for (const name of Object.keys(fields)) allNames.add(name)\n  }\n\n  const memberCount = extracted.length\n  const out: Record<string, FieldDescriptor> = {}\n\n  for (const name of allNames) {\n    // Which members contain this field?\n    const presentIn = extracted.filter(({ fields }) => name in fields)\n    const requiredInAll = presentIn.length === memberCount\n      && presentIn.every(({ required }) => required.has(name))\n\n    // Use first-seen descriptor as the base (presentIn is always non-empty here since\n    // we iterate names that appeared in at least one member's fields)\n    const base = presentIn[0]!.fields[name]!\n\n    // For discriminator-like fields: collect const/enum values across all members\n    // to surface the full literal set in constraints.values\n    const allValues: unknown[] = []\n    for (const { fields } of presentIn) {\n      const fd = fields[name]\n      if (fd?.constraints?.values && Array.isArray(fd.constraints.values)) {\n        for (const v of fd.constraints.values) {\n          if (!allValues.includes(v)) allValues.push(v)\n        }\n      }\n    }\n\n    const mergedConstraints: Record<string, unknown> | undefined =\n      allValues.length > 0\n        ? { ...(base.constraints ?? {}), values: allValues }\n        : base.constraints\n\n    const descriptor: FieldDescriptor = {\n      type: base.type,\n      source,\n      ...(requiredInAll ? {} : { optional: true }),\n      ...(base.references ? { references: base.references } : {}),\n    }\n    if (mergedConstraints) {\n      (descriptor as { constraints?: Record<string, unknown> }).constraints = mergedConstraints\n    }\n    out[name] = descriptor\n  }\n\n  return out\n}\n\nexport function jsonSchemaToFields(\n  jsonSchema: unknown,\n  source: FieldSource,\n  refs?: Record<string, { target: string; mode: string }>,\n): Record<string, FieldDescriptor> {\n  if (!jsonSchema || typeof jsonSchema !== 'object') return {}\n  const root = jsonSchema as JsonSchemaShape\n\n  // Handle discriminated unions: zod-to-json-schema emits anyOf/oneOf for z.discriminatedUnion\n  const unionMembers = root.anyOf ?? root.oneOf\n  if (Array.isArray(unionMembers) && unionMembers.length > 0) {\n    return mergeUnionMembers(unionMembers, source, refs)\n  }\n\n  if (!root.properties || typeof root.properties !== 'object') return {}\n\n  const { fields } = extractObjectFields(root, source, refs)\n  return fields\n}\n"],"mappings":";AA+BA,SAAS,eAAe,MAA+B;AACrD,MAAI,MAAM,QAAQ,KAAK,IAAI,GAAG;AAC5B,UAAM,MAAM,KAAK,KAAK,OAAO,CAAC,MAAM,MAAM,MAAM;AAChD,WAAO,IAAI,CAAC,KAAK;AAAA,EACnB;AACA,MAAI,KAAK,QAAQ,MAAM,QAAQ,KAAK,IAAI,EAAG,QAAO;AAElD,MAAI,KAAK,UAAU,OAAW,QAAO;AACrC,MAAI,OAAO,KAAK,SAAS,SAAU,QAAO,KAAK;AAC/C,SAAO;AACT;AAEA,SAAS,eAAe,MAA4D;AAClF,QAAM,MAA+B,CAAC;AACtC,MAAI,KAAK,KAAM,KAAI,SAAS,KAAK;AAEjC,MAAI,KAAK,UAAU,OAAW,KAAI,SAAS,CAAC,KAAK,KAAK;AACtD,MAAI,KAAK,cAAc,OAAW,KAAI,YAAY,KAAK;AACvD,MAAI,KAAK,cAAc,OAAW,KAAI,YAAY,KAAK;AACvD,MAAI,KAAK,YAAY,OAAW,KAAI,UAAU,KAAK;AACnD,MAAI,KAAK,WAAW,OAAW,KAAI,SAAS,KAAK;AACjD,MAAI,KAAK,YAAY,OAAW,KAAI,UAAU,KAAK;AACnD,MAAI,KAAK,YAAY,OAAW,KAAI,UAAU,KAAK;AACnD,MAAI,KAAK,qBAAqB,OAAW,KAAI,KAAK,KAAK;AACvD,MAAI,KAAK,qBAAqB,OAAW,KAAI,KAAK,KAAK;AACvD,SAAO,OAAO,KAAK,GAAG,EAAE,WAAW,IAAI,SAAY;AACrD;AAMA,SAAS,oBACP,KACA,QACA,MACoE;AACpE,QAAM,WAAW,IAAI,IAAI,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,WAAW,CAAC,CAAC;AACxE,QAAM,SAA0C,CAAC;AACjD,MAAI,CAAC,IAAI,cAAc,OAAO,IAAI,eAAe,SAAU,QAAO,EAAE,QAAQ,SAAS;AAErF,aAAW,CAAC,MAAM,IAAI,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AACzD,UAAM,aAA8B;AAAA,MAClC,MAAM,eAAe,IAAI;AAAA,MACzB;AAAA,MACA,GAAI,SAAS,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,UAAU,KAAK;AAAA,MAC/C,GAAI,OAAO,IAAI,IAAI,EAAE,YAAY,GAAG,KAAK,IAAI,EAAE,MAAM,MAAM,IAAI,CAAC;AAAA,IAClE;AACA,UAAM,cAAc,eAAe,IAAI;AACvC,QAAI,YAAa,CAAC,WAAyD,cAAc;AACzF,WAAO,IAAI,IAAI;AAAA,EACjB;AAEA,SAAO,EAAE,QAAQ,SAAS;AAC5B;AAcA,SAAS,kBACP,SACA,QACA,MACiC;AACjC,MAAI,QAAQ,WAAW,EAAG,QAAO,CAAC;AAGlC,QAAM,YAAY,QACf,OAAO,CAAC,MAAM,EAAE,cAAc,OAAO,EAAE,eAAe,QAAQ,EAC9D,IAAI,CAAC,MAAM,oBAAoB,GAAG,QAAQ,IAAI,CAAC;AAElD,MAAI,UAAU,WAAW,EAAG,QAAO,CAAC;AAGpC,QAAM,WAAW,oBAAI,IAAY;AACjC,aAAW,EAAE,OAAO,KAAK,WAAW;AAClC,eAAW,QAAQ,OAAO,KAAK,MAAM,EAAG,UAAS,IAAI,IAAI;AAAA,EAC3D;AAEA,QAAM,cAAc,UAAU;AAC9B,QAAM,MAAuC,CAAC;AAE9C,aAAW,QAAQ,UAAU;AAE3B,UAAM,YAAY,UAAU,OAAO,CAAC,EAAE,OAAO,MAAM,QAAQ,MAAM;AACjE,UAAM,gBAAgB,UAAU,WAAW,eACtC,UAAU,MAAM,CAAC,EAAE,SAAS,MAAM,SAAS,IAAI,IAAI,CAAC;AAIzD,UAAM,OAAO,UAAU,CAAC,EAAG,OAAO,IAAI;AAItC,UAAM,YAAuB,CAAC;AAC9B,eAAW,EAAE,OAAO,KAAK,WAAW;AAClC,YAAM,KAAK,OAAO,IAAI;AACtB,UAAI,IAAI,aAAa,UAAU,MAAM,QAAQ,GAAG,YAAY,MAAM,GAAG;AACnE,mBAAW,KAAK,GAAG,YAAY,QAAQ;AACrC,cAAI,CAAC,UAAU,SAAS,CAAC,EAAG,WAAU,KAAK,CAAC;AAAA,QAC9C;AAAA,MACF;AAAA,IACF;AAEA,UAAM,oBACJ,UAAU,SAAS,IACf,EAAE,GAAI,KAAK,eAAe,CAAC,GAAI,QAAQ,UAAU,IACjD,KAAK;AAEX,UAAM,aAA8B;AAAA,MAClC,MAAM,KAAK;AAAA,MACX;AAAA,MACA,GAAI,gBAAgB,CAAC,IAAI,EAAE,UAAU,KAAK;AAAA,MAC1C,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;AAAA,IAC3D;AACA,QAAI,mBAAmB;AACrB,MAAC,WAAyD,cAAc;AAAA,IAC1E;AACA,QAAI,IAAI,IAAI;AAAA,EACd;AAEA,SAAO;AACT;AAEO,SAAS,mBACd,YACA,QACA,MACiC;AACjC,MAAI,CAAC,cAAc,OAAO,eAAe,SAAU,QAAO,CAAC;AAC3D,QAAM,OAAO;AAGb,QAAM,eAAe,KAAK,SAAS,KAAK;AACxC,MAAI,MAAM,QAAQ,YAAY,KAAK,aAAa,SAAS,GAAG;AAC1D,WAAO,kBAAkB,cAAc,QAAQ,IAAI;AAAA,EACrD;AAEA,MAAI,CAAC,KAAK,cAAc,OAAO,KAAK,eAAe,SAAU,QAAO,CAAC;AAErE,QAAM,EAAE,OAAO,IAAI,oBAAoB,MAAM,QAAQ,IAAI;AACzD,SAAO;AACT;","names":[]}

package/dist/chunk-UNJU345Q.js

@@ -1,32 +0,0 @@
-// src/kernel/types.ts
-var NOYDB_FORMAT_VERSION = 1;
-var NOYDB_KEYRING_VERSION = 1;
-var NOYDB_BACKUP_VERSION = 1;
-var NOYDB_SYNC_VERSION = 1;
-var SealedHandle = class {
-  sealed = true;
-  #reveal;
-  constructor(reveal) {
-    this.#reveal = reveal;
-  }
-  reveal() {
-    return this.#reveal();
-  }
-  /** Non-leaking serialisation marker — never the underlying value. */
-  toJSON() {
-    return "[sealed]";
-  }
-};
-function createStore(factory) {
-  return factory;
-}
-
-export {
-  NOYDB_FORMAT_VERSION,
-  NOYDB_KEYRING_VERSION,
-  NOYDB_BACKUP_VERSION,
-  NOYDB_SYNC_VERSION,
-  SealedHandle,
-  createStore
-};
-//# sourceMappingURL=chunk-UNJU345Q.js.map