@noy-db/hub 0.2.0-pre.15 → 0.2.0-pre.16

package/dist/blobs/index.d.cts

@@ -1,11 +1,11 @@
-import { B as BlobStrategy } from '../types-BpPV5uyy.cjs';
-export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-BpPV5uyy.cjs';
+import { B as BlobStrategy } from '../types-Bze6vkwm.cjs';
+export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-Bze6vkwm.cjs';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.cjs';
 import '../lazy-builder-eYZzLEL1.cjs';
 import '../predicate-BmhBSPCH.cjs';
-import '../strategy-CbneC7bS.cjs';
+import '../strategy-BtW8fAjz.cjs';
 import '../strategy-BSxFXGzb.cjs';
-import '../index-D95VK1Qy.cjs';
+import '../index-C8Bk3-VF.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/blobs/index.d.ts

@@ -1,11 +1,11 @@
-import { B as BlobStrategy } from '../types-4t1-tWS4.js';
-export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-4t1-tWS4.js';
+import { B as BlobStrategy } from '../types-DrmBTscX.js';
+export { z as BLOB_CHUNKS_COLLECTION, A as BLOB_COLLECTION, C as BLOB_EVICTION_AUDIT_COLLECTION, E as BLOB_INDEX_COLLECTION, F as BLOB_SLOTS_PREFIX, G as BLOB_VERSIONS_PREFIX, H as BlobEvictionEntry, J as BlobFieldPolicy, K as BlobFieldsConfig, M as BlobObject, N as BlobPutOptions, Q as BlobResponseOptions, T as BlobSet, U as BlobStrategyOpenArgs, V as CompactRunOptions, W as CompactionContext, X as CompactionResult, Y as DEFAULT_CHUNK_SIZE, Z as EXPORT_AUDIT_COLLECTION, _ as ExportBlobsAbortedError, $ as ExportBlobsAuditEntry, a0 as ExportBlobsHandle, a1 as ExportBlobsOptions, a2 as ExportedBlob, a3 as SlotInfo, a4 as SlotRecord, a5 as VersionRecord, a6 as createExportBlobsHandle, a7 as runCompaction } from '../types-DrmBTscX.js';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
-import '../strategy-CbneC7bS.js';
+import '../strategy-BtW8fAjz.js';
 import '../strategy-BSxFXGzb.js';
-import '../index-XNB2r6bX.js';
+import '../index-nP99bXLg.js';
 import '@noy-db/attestation';
 
 /**

package/dist/blobs/index.js

@@ -9,15 +9,15 @@ import {
   detectMagic,
   detectMimeType,
   isPreCompressed
-} from "../chunk-LX3CB26H.js";
+} from "../chunk-KABJXG2F.js";
 import {
   BLOB_EVICTION_AUDIT_COLLECTION,
   EXPORT_AUDIT_COLLECTION,
   ExportBlobsAbortedError,
   createExportBlobsHandle,
   runCompaction
-} from "../chunk-6AJBSQU4.js";
-import "../chunk-GC4V7RU7.js";
+} from "../chunk-XL35NSEN.js";
+import "../chunk-F3BPIPLS.js";
 import "../chunk-YULZKK4F.js";
 import "../chunk-535SSHBS.js";
 

package/dist/bundle/index.cjs

@@ -4834,13 +4834,22 @@ var init_strategy4 = __esm({
 });
 
 // src/money/money-reducer.ts
-function toScaledInt(v) {
-  if (typeof v === "string" || typeof v === "number" || typeof v === "bigint") {
-    try {
-      return BigInt(v);
-    } catch {
-      return null;
+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;
 }
@@ -4848,13 +4857,15 @@ function readMoney(record, field, desc) {
   const raw = readPath(record, field);
   if (raw === null || raw === void 0) return null;
   if (desc.mode === "fixed") {
-    const value2 = toScaledInt(raw);
-    return value2 === null ? null : { currency: desc.fixedCurrency, value: value2 };
+    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 value = toScaledInt(o.amount);
+  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) {
@@ -6005,11 +6016,14 @@ function warnCardinalityApproaching(fields, observed) {
     `[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) {
+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) {
@@ -6065,6 +6079,7 @@ var init_groupby = __esm({
     init_predicate();
     init_canonical_key();
     init_errors();
+    init_money_reducer();
     GROUPBY_WARN_CARDINALITY = 1e4;
     GROUPBY_MAX_CARDINALITY = 1e5;
     warnedCardinalityFields = /* @__PURE__ */ new Set();
@@ -7466,10 +7481,14 @@ function summarizeQueryPlan(query) {
   });
 }
 function summarizeUnionPlan(spec) {
-  const arms = (spec.unionSources ?? []).map((s) => s.collection).join(",");
+  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(",") : "";
-  return `union(${arms})|groupBy(${groupBy})|aggregate(${aggKeys})`;
+  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"() {
@@ -7596,6 +7615,7 @@ var init_registry = __esm({
         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);
@@ -7750,7 +7770,13 @@ async function materializeUnionResult(spec, db) {
   const unified = [];
   for (const arm of spec.unionSources) {
     const coll = db.collection(arm.collection);
-    const sourceRows = coll.query().toArray();
+    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;
@@ -7767,7 +7793,7 @@ async function materializeUnionResult(spec, db) {
     }
     return [...seen.values()];
   }
-  return groupAndReduce(unified, groupFields, spec.aggregate);
+  return groupAndReduce(unified, groupFields, spec.aggregate, spec.moneyFields);
 }
 async function listOutputIds(outputColl) {
   const cAny = outputColl;
@@ -8963,9 +8989,18 @@ var init_collection = __esm({
             if (DerivationExecutor2 === null) {
               ({ DerivationExecutor: DerivationExecutor2 } = await Promise.resolve().then(() => (init_executor(), executor_exports)));
             }
-            const sourceWithId = { ...incoming, id };
+            let sourceWithId;
+            let sourceVersion = version;
+            if (spec.source === this.name) {
+              sourceWithId = { ...incoming, id };
+            } else {
+              const primary = await this.derivationSource.getCollection(spec.source).get(id);
+              if (primary === null || primary === void 0) continue;
+              sourceWithId = { ...primary, id };
+              sourceVersion = 0;
+            }
             const ctx = { vault: this.derivationSource.getReadOnlyFacade() };
-            const result = await DerivationExecutor2.run(spec, sourceWithId, version, strategyHash, ctx);
+            const result = await DerivationExecutor2.run(spec, sourceWithId, sourceVersion, strategyHash, ctx);
             for (const key of Object.keys(spec.outputs)) {
               const out = result.outputs[key];
               if (!out) continue;
@@ -10917,37 +10952,34 @@ var init_virtual_collection = __esm({
       /** Get the merged row by id. */
       async get(id) {
         const overlayRow = await this.overlayCollection.get(id);
-        if (overlayRow !== null && this.shadowPredicateApplies(overlayRow)) {
-          return overlayRow;
-        }
         const baseRow = await this.baseCollection.get(id);
-        if (baseRow !== null) return baseRow;
-        return null;
+        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 merged = /* @__PURE__ */ new Map();
         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) merged.set(id, row);
+          if (id) baseById.set(id, row);
         }
         for (const row of overlayRows) {
           const id = idOf(row);
-          if (!id) continue;
-          if (this.shadowPredicateApplies(row)) {
-            merged.set(id, row);
-          } else if (!merged.has(id)) {
-            continue;
-          }
+          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 [...merged.values()];
+        return out;
       }
       /**
        * Write to the overlay. Two forms:
@@ -10987,9 +11019,42 @@ var init_virtual_collection = __esm({
       async delete(id) {
         await this.overlayCollection.delete(id);
       }
-      /** True when `overlay[shadowField] === shadowValue`. */
-      shadowPredicateApplies(row) {
-        return row[this.spec.shadowField] === this.spec.shadowValue;
+      /**
+       * 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 ───────
       //
@@ -11139,6 +11204,21 @@ var init_archive = __esm({
 });
 
 // src/sequence/index.ts
+function resolveSequenceKey(series, opts) {
+  const partition = opts?.partition;
+  if (!partition || partition.length === 0) return series;
+  const parts = partition.map((p) => {
+    if (typeof p === "number" && !Number.isFinite(p)) {
+      throw new ValidationError(`sequence partition component must be a finite number, got ${p}`);
+    }
+    const s = String(p);
+    if (s === "") {
+      throw new ValidationError("sequence partition component must not be empty");
+    }
+    return encodeURIComponent(s);
+  });
+  return `${series}\0${parts.join("/")}`;
+}
 async function sleepBackoff2(attempt) {
   const ceil = Math.min(2 ** attempt, 32);
   const ms = Math.floor(Math.random() * ceil);
@@ -11178,7 +11258,8 @@ var init_sequence = __esm({
       handle(name) {
         return {
           next: () => this.next(name),
-          peek: () => this.peek(name)
+          peek: () => this.peek(name),
+          seedTo: (n) => this.seedTo(name, n)
         };
       }
       assertOnline() {
@@ -11231,6 +11312,30 @@ var init_sequence = __esm({
         void lastConflict;
         throw new SequenceContentionError(name, MAX_NEXT_ATTEMPTS);
       }
+      async seedTo(name, n) {
+        this.assertOnline();
+        if (n <= 0) return;
+        let lastConflict;
+        for (let attempt = 0; attempt < MAX_NEXT_ATTEMPTS; attempt++) {
+          const { env, value } = await this.read(name);
+          if (value >= n) return;
+          const expectedVersion = env?._v ?? 0;
+          const envelope = await this.encryptState({ value: n }, expectedVersion + 1);
+          try {
+            await this.adapter.put(this.vault, SEQUENCE_COLLECTION, name, envelope, expectedVersion);
+            return;
+          } catch (err) {
+            if (err instanceof ConflictError) {
+              lastConflict = err;
+              if (attempt < MAX_NEXT_ATTEMPTS - 1) await sleepBackoff2(attempt);
+              continue;
+            }
+            throw err;
+          }
+        }
+        void lastConflict;
+        throw new SequenceContentionError(name, MAX_NEXT_ATTEMPTS);
+      }
     };
   }
 });
@@ -13245,11 +13350,15 @@ var init_read_only_facade = __esm({
 });
 
 // src/derivations/strategy-hash.ts
-async function computeStrategyHash(source, outputKeys, derive) {
+async function computeStrategyHash(source, outputKeys, derive, sources) {
   const canonical2 = JSON.stringify({
     source,
     outputs: [...outputKeys].sort(),
-    derive: derive.toString()
+    derive: derive.toString(),
+    // Declared sibling sources (#344) — adding/removing a trigger
+    // collection invalidates cached derived records. Omitted when empty
+    // so strategies without siblings keep their existing hash.
+    ...sources?.length ? { sources: [...sources].sort() } : {}
   });
   const bytes = new TextEncoder().encode(canonical2);
   const digest = await crypto.subtle.digest("SHA-256", bytes);
@@ -13278,11 +13387,16 @@ var init_registry3 = __esm({
       // eslint-disable-next-line @typescript-eslint/no-explicit-any
       async register(spec) {
         const outputKeys = Object.keys(spec.outputs);
-        const strategyHash = await computeStrategyHash(spec.source, outputKeys, spec.derive);
+        const strategyHash = await computeStrategyHash(spec.source, outputKeys, spec.derive, spec.sources);
         const reg = { spec, strategyHash };
         const fromSource = this._bySource.get(spec.source);
         if (fromSource) fromSource.push(reg);
         else this._bySource.set(spec.source, [reg]);
+        for (const extra of spec.sources ?? []) {
+          const fromExtra = this._bySource.get(extra);
+          if (fromExtra) fromExtra.push(reg);
+          else this._bySource.set(extra, [reg]);
+        }
         for (const key of outputKeys) {
           const output = spec.outputs[key];
           if (!output) continue;
@@ -14458,17 +14572,23 @@ var init_vault = __esm({
        * const cur = await vault.sequence('invoice-2026').peek()  // current value, no allocation
        * ```
        */
-      sequence(name) {
-        if (this.numberingConfigs.has(name)) {
+      sequence(series, opts) {
+        if (series.includes("\0")) {
+          throw new ValidationError(`sequence("${series}"): series name must not contain a null byte (\\x00).`);
+        }
+        if (this.numberingConfigs.has(series)) {
           const eng = this.deferred();
           return {
-            next: async (opts) => {
-              if (!opts?.for) {
-                throw new ValidationError(`sequence("${name}") is a deferred-numbering series; call next({ for: recordId }).`);
+            next: async (nextOpts) => {
+              if (!nextOpts?.for) {
+                throw new ValidationError(`sequence("${series}") is a deferred-numbering series; call next({ for: recordId }).`);
               }
-              return (await eng.enqueue(name, opts.for)).assigned;
+              return (await eng.enqueue(series, nextOpts.for)).assigned;
             },
-            peek: () => eng.peek(name)
+            peek: () => eng.peek(series),
+            seedTo: () => {
+              throw new ValidationError(`sequence("${series}") is a deferred-numbering series; seedTo is CAS-only.`);
+            }
           };
         }
         if (!this.sequenceStore) {
@@ -14480,7 +14600,7 @@ var init_vault = __esm({
             actor: this.keyring.userId
           });
         }
-        return this.sequenceStore.handle(name);
+        return this.sequenceStore.handle(resolveSequenceKey(series, opts));
       }
       /** @internal — lazily build the deferred-numbering engine with a cache-coherent stamp. */
       deferred() {
@@ -14772,9 +14892,24 @@ var init_vault = __esm({
               });
             }
             if (rule.mode === "cascade") {
+              const txCtx = this.noydb._activeTxContextOrNull;
               for (const match of matches) {
                 const matchId = match["id"] ?? null;
                 if (matchId === null) continue;
+                if (txCtx !== null) {
+                  const prior = await this.adapter.get(this.name, rule.collection, matchId);
+                  if (prior !== null) {
+                    txCtx._executed.push({
+                      op: {
+                        type: "delete",
+                        vaultName: this.name,
+                        collectionName: rule.collection,
+                        id: matchId
+                      },
+                      priorEnvelope: prior
+                    });
+                  }
+                }
                 await fromCollection.delete(matchId);
               }
             }
@@ -17163,7 +17298,7 @@ var init_strategy11 = __esm({
       'Multi-record transactions require the tx strategy. Import `{ withTransactions }` from "@noy-db/hub/tx" and pass it to `createNoydb({ txStrategy: withTransactions() })`.'
     );
     NO_TX = {
-      async runTransaction() {
+      async runTransaction(_db, _fn, _options, _txInvariants) {
         throw NOT_ENABLED6;
       },
       async runDryRun() {