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

package/dist/overlay-views/index.d.ts

@@ -1,11 +1,11 @@
-export { w as withOverlayedView } from '../with-overlayed-view-eDvMs6LO.js';
-import { aX as OverlayedViewStrategy, aY as Collection } from '../types-4t1-tWS4.js';
-export { aZ as OverlayedViewRegistry, a_ as OverlayedViewStrategyHandle } from '../types-4t1-tWS4.js';
-export { P as OverlayBaseIsVirtualError, Q as OverlayCollectionUnavailableError, U as OverlayIdMismatchError, V as OverlayNameCollisionError } from '../strategy-CbneC7bS.js';
+export { w as withOverlayedView } from '../with-overlayed-view-BEXfpzSb.js';
+import { aR as OverlayedViewStrategy, aS as Collection } from '../types-DrmBTscX.js';
+export { aT as OverlayFieldMergeMode, aU as OverlayFieldMergeRule, aV as OverlayedViewRegistry, aW as OverlayedViewStrategyHandle } from '../types-DrmBTscX.js';
+export { P as OverlayBaseIsVirtualError, Q as OverlayCollectionUnavailableError, U as OverlayIdMismatchError, V as OverlayNameCollisionError } from '../strategy-BtW8fAjz.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
 import '../strategy-BSxFXGzb.js';
-import '../index-XNB2r6bX.js';
+import '../index-nP99bXLg.js';
 import '@noy-db/attestation';
 
 /**
@@ -14,7 +14,9 @@ import '@noy-db/attestation';
  *
  * Implements the core `Collection<T>`-shaped read/write surface with
  * merge-on-read semantics:
- *   - `get(id)`: overlay row wins iff `overlay[shadowField] === shadowValue`
+ *   - `get(id)`: overlay row wins iff `overlay[shadowField] === shadowValue`;
+ *     when `spec.mergeMode` is set, an intermediate status may instead pull
+ *     a declared subset of fields from the overlay over the base (#348)
  *   - `list()` / `.query()`: union of ids, per-id merge applied
  *   - `put(record)` / `put(id, record)`: routes to overlay; id derived
  *     via the base MV's `rowKey` (validated on the two-arg form)
@@ -57,8 +59,24 @@ declare class OverlayedCollection<T extends Record<string, unknown> = any> {
      * subsequent reads return it.
      */
     delete(id: string): Promise<void>;
-    /** True when `overlay[shadowField] === shadowValue`. */
-    private shadowPredicateApplies;
+    /**
+     * 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.
+     */
+    private mergeRows;
     /** @throws — chainable Query<T> over a virtual collection is deferred. */
     query(): never;
     /** @throws — change-stream subscription over a virtual collection is deferred. */

package/dist/overlay-views/index.js

@@ -6,7 +6,7 @@ import {
 } from "../chunk-TS26M2SB.js";
 import {
   OverlayedCollection
-} from "../chunk-OHVFWCJP.js";
+} from "../chunk-VLMPU56Q.js";
 import {
   OverlayBaseIsVirtualError,
   OverlayCollectionUnavailableError,