@noy-db/hub 0.2.0-pre.2 → 0.2.0-pre.21

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

@@ -1,27 +1,31 @@
-export { w as withOverlayedView } from '../with-overlayed-view-Ct1fSJt-.js';
-import { aG as OverlayedViewStrategy, aH as Collection } from '../types-BoFFiskX.js';
-export { aI as OverlayedViewRegistry, aJ as OverlayedViewStrategyHandle } from '../types-BoFFiskX.js';
-export { O as OverlayBaseIsVirtualError, j as OverlayCollectionUnavailableError, k as OverlayIdMismatchError, l as OverlayNameCollisionError } from '../index-BCKdioeh.js';
-import '../lazy-builder-Rpd-V3jP.js';
-import '../predicate-Dnu81tsS.js';
-import '../strategy-DSTrsZ8t.js';
+export { w as withOverlayedView } from '../with-overlayed-view-C9joG7UZ.js';
+import { aM as OverlayedViewStrategy, aN as Collection } from '../types-DLfWFr6U.js';
+export { aO as OverlayFieldMergeMode, aP as OverlayFieldMergeRule, aQ as OverlayedViewRegistry, aR as OverlayedViewStrategyHandle } from '../types-DLfWFr6U.js';
+export { O as OverlayBaseIsVirtualError, n as OverlayCollectionUnavailableError, o as OverlayIdMismatchError, p as OverlayNameCollisionError } from '../errors-Dkc_fi-S.js';
+import '../lazy-builder-ChSqcF5t.js';
+import '../predicate-BmhBSPCH.js';
+import '../strategy-54eIwox5.js';
 import '../strategy-BSxFXGzb.js';
+import '../index-BMmajblo.js';
+import '../index-Bm9hIY7t.js';
 import '@noy-db/attestation';
 
 /**
  * Virtual-collection proxy returned by `vault.collection(overlayName)`
- * when `overlayName` is a registered `withOverlayedView` (#154).
+ * when `overlayName` is a registered `withOverlayedView`.
  *
  * 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)
  *   - `delete(id)`: removes the overlay row only; base stays
  *
  * Reactive APIs (`live`, `subscribe`, `query().live()`) are out of
- * scope for #154 and surface as "not yet implemented" — wired in a
+ * scope for this release and surface as "not yet implemented" — wired in a
  * future sub-issue.
  */
 declare class OverlayedCollection<T extends Record<string, unknown> = any> {
@@ -57,8 +61,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

@@ -1,18 +1,18 @@
 import {
   withOverlayedView
-} from "../chunk-3S4BJX25.js";
-import {
-  OverlayedCollection
-} from "../chunk-YTXSFG3C.js";
+} from "../chunk-JBBWALNI.js";
 import {
   OverlayedViewRegistry
-} from "../chunk-FAQVNJD4.js";
+} from "../chunk-SQOK5UM6.js";
+import {
+  OverlayedCollection
+} from "../chunk-MBXKRHSS.js";
 import {
   OverlayBaseIsVirtualError,
   OverlayCollectionUnavailableError,
   OverlayIdMismatchError,
   OverlayNameCollisionError
-} from "../chunk-W3XXT26A.js";
+} from "../chunk-OTWT6BAJ.js";
 export {
   OverlayBaseIsVirtualError,
   OverlayCollectionUnavailableError,