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

package/dist/tx/index.d.cts

@@ -1,10 +1,10 @@
-import { aH as TxStrategy } from '../types-CDwSSXiI.cjs';
-export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-CDwSSXiI.cjs';
-import '../lazy-builder-Ci5_YG73.cjs';
-import '../predicate-Bt5ft-9c.cjs';
-import '../strategy-CrS7PnbE.cjs';
+import { aH as TxStrategy } from '../types-BpPV5uyy.cjs';
+export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-BpPV5uyy.cjs';
+import '../lazy-builder-eYZzLEL1.cjs';
+import '../predicate-BmhBSPCH.cjs';
+import '../strategy-CbneC7bS.cjs';
 import '../strategy-BSxFXGzb.cjs';
-import '../index-CUVOMtgg.cjs';
+import '../index-D95VK1Qy.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/tx/index.d.ts

@@ -1,10 +1,10 @@
-import { aH as TxStrategy } from '../types-pax34sec.js';
-export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-pax34sec.js';
-import '../lazy-builder-D5GU14TS.js';
-import '../predicate-Bt5ft-9c.js';
-import '../strategy-CrS7PnbE.js';
+import { aH as TxStrategy } from '../types-4t1-tWS4.js';
+export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-4t1-tWS4.js';
+import '../lazy-builder-ChSqcF5t.js';
+import '../predicate-BmhBSPCH.js';
+import '../strategy-CbneC7bS.js';
 import '../strategy-BSxFXGzb.js';
-import '../index-Cqzp4tt9.js';
+import '../index-XNB2r6bX.js';
 import '@noy-db/attestation';
 
 /**

package/dist/tx/index.js

@@ -3,9 +3,9 @@ import {
   TxContext,
   TxVault,
   runTransaction
-} from "../chunk-M6KXHRIA.js";
+} from "../chunk-YHPM5D7Y.js";
 import "../chunk-FZU343FL.js";
-import "../chunk-NKGY3C53.js";
+import "../chunk-535SSHBS.js";
 
 // src/tx/dry-run.ts
 var SEP = " ";
@@ -43,7 +43,7 @@ async function runDryRun(db, fn) {
     const gctx = { existing: before, vault: facade, userId: v.userId, role: v.role };
     try {
       await registry.runChecks(op.collectionName, after, gctx);
-      const { GuardExecutor } = await import("../executor-VT7TKGE4.js");
+      const { GuardExecutor } = await import("../executor-IDZDAFNH.js");
       for (const g of guards) {
         await GuardExecutor.checkFrozenFields(g, op.id, before, after);
       }

package/dist/{types-pax34sec.d.ts → types-4t1-tWS4.d.ts}

@@ -1,8 +1,8 @@
-import { I as IndexStrategy, d as LazyQuery } from './lazy-builder-D5GU14TS.js';
-import { a7 as NoydbError, o as LiveAggregation, f as AggregateSpec, e as AggregateResult, A as AggregateStrategy, au as MoneyDescriptor } from './strategy-CrS7PnbE.js';
+import { I as IndexStrategy, d as LazyQuery } from './lazy-builder-ChSqcF5t.js';
+import { a7 as NoydbError, o as LiveAggregation, f as AggregateSpec, e as AggregateResult, A as AggregateStrategy, av as MoneyDescriptor } from './strategy-CbneC7bS.js';
 import { C as CrdtStrategy, a as CrdtMode, b as CrdtState } from './strategy-BSxFXGzb.js';
-import { L as LiveQuery, Q as Query, j as RefRegistry, R as RefDescriptor, d as JoinableSource, l as RefViolation, S as ScanBuilder } from './index-Cqzp4tt9.js';
-import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-Bt5ft-9c.js';
+import { L as LiveQuery, Q as Query, c as JoinStrategy, j as RefRegistry, R as RefDescriptor, d as JoinableSource, l as RefViolation, S as ScanBuilder } from './index-XNB2r6bX.js';
+import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-BmhBSPCH.js';
 import { AttestationFieldSchema, RevocationList } from '@noy-db/attestation';
 
 /**
@@ -2972,9 +2972,18 @@ interface GatePutEvent {
     readonly vault: string;
     readonly collection: string;
     readonly docId: string;
-    /** The record about to be written (pre schema-validation). */
+    /**
+     * The record about to be written (pre schema-validation). Money fields
+     * are presented in their canonical decoded form (#332) — equal on both
+     * sides for an unchanged value, regardless of how the caller wrote them.
+     */
     readonly incoming: unknown;
-    /** Decrypted prior record, or null on create / when prior is unreadable. */
+    /**
+     * Decrypted prior record, or null on create / when prior is unreadable.
+     * Money fields are decoded to the canonical decimal `get()` shape, NOT
+     * the stored scaled-int (#332) — `incoming[f] === existing[f]` holds
+     * for an unchanged money field.
+     */
     readonly existing: unknown;
     /** Prior envelope version, or 0 when none. */
     readonly existingVersion: number;
@@ -2998,6 +3007,7 @@ interface GateDeleteEvent {
     readonly docId: string;
     /** True for system-internal (housekeeping) deletes — handlers branch on this. */
     readonly internal: boolean;
+    /** Decrypted prior record; money fields decoded to the canonical `get()` shape (#332). */
     readonly existing: unknown;
     readonly existingVersion: number;
     readonly existingTs: string | undefined;
@@ -5272,6 +5282,51 @@ interface FactorProofBundle {
 /** Active session tier — what the engine compares against `gate.minTier`. */
 type ActiveTier = 1 | 2 | 3;
 
+/** Public options for `ShardedQuery.crossShardJoin`. */
+interface CrossShardJoinOptions {
+    /** Alias key under which the joined same-shard record attaches. */
+    readonly as: string;
+    /** Per-shard row ceiling override (default DEFAULT_JOIN_MAX_ROWS). */
+    readonly maxRows?: number;
+    /** Planner strategy override, passed through to intra-vault `.join()`. */
+    readonly strategy?: JoinStrategy;
+}
+/**
+ * Minimal structural shape of a broadcast dimension source. A
+ * `Collection` satisfies this natively: `list()` hydrates and returns
+ * the decoded records. Kept as a one-method interface so plain test
+ * sources are trivial to construct.
+ */
+interface BroadcastSource {
+    list(): Promise<readonly unknown[]>;
+}
+/** Public options for `ShardedQuery.broadcastJoin`. */
+interface BroadcastJoinOptions {
+    /** Alias key under which the dimension record attaches. */
+    readonly as: string;
+    /** The shared dimension collection (an opened handle in another vault). */
+    readonly from: BroadcastSource;
+    /** Right-side key to match `field` against. Default 'id'. */
+    readonly on?: string;
+    /** Miss behavior. 'warn' (default) attaches null + one-shot warning; 'cascade' is silent. */
+    readonly mode?: 'warn' | 'cascade';
+}
+/** Internal co-partitioned leg carried on ShardedQuery. */
+interface CoPartitionedLeg {
+    readonly field: string;
+    readonly as: string;
+    readonly maxRows: number | undefined;
+    readonly strategy: JoinStrategy | undefined;
+}
+/** Internal broadcast leg carried on ShardedQuery. */
+interface BroadcastLeg {
+    readonly field: string;
+    readonly as: string;
+    readonly from: BroadcastSource;
+    readonly on: string;
+    readonly mode: 'warn' | 'cascade';
+}
+
 /** A source that can fan out records across shards. Satisfied by ShardedQuery. */
 interface FanoutRecordSource<R> {
     fanoutRecords(options: FanoutQueryOptions): Promise<{
@@ -5397,17 +5452,25 @@ declare class ShardedQuery<T, R = T> {
     private readonly group;
     private readonly collectionName;
     private readonly clauses;
-    constructor(group: VaultGroup<T>, collectionName: string, clauses: readonly WhereClause[]);
+    private readonly coPartitionedLegs;
+    private readonly broadcastLegs;
+    constructor(group: VaultGroup<T>, collectionName: string, clauses: readonly WhereClause[], coPartitionedLegs?: readonly CoPartitionedLeg[], broadcastLegs?: readonly BroadcastLeg[]);
     where(field: string, op: WhereClause['op'], value: unknown): ShardedQuery<T, R>;
+    /** Co-partitioned join: each shard joins its own same-vault right collection (resolved via ref()), then union. */
+    crossShardJoin(field: string, opts: CrossShardJoinOptions): ShardedQuery<T, R>;
+    /** Broadcast dimension join: enrich every merged row from a single shared collection. */
+    broadcastJoin(field: string, opts: BroadcastJoinOptions): ShardedQuery<T, R>;
     /** @internal — fan out the where-filtered records across eligible shards. */
     fanoutRecords(options?: FanoutQueryOptions): Promise<{
         records: R[];
         skippedVaults: SkippedVault[];
     }>;
-    /** Fan out across eligible shards and merge results. */
+    /** Fan out across eligible shards, merge, then apply any broadcast dimension legs. */
     toArray(options?: FanoutQueryOptions): Promise<FanoutResult<R>>;
     /** @internal — build the change-subscription + relevance binding for this query's group+collection. */
     liveBinding(): LiveBinding;
+    /** @internal — joined queries don't support reactive/aggregate surfaces in v1. */
+    private assertNoJoinLegs;
     /** Returns a reactive cross-shard live query — a facade over CrossVaultLive. */
     live(options?: LiveQueryOptions): CrossVaultLiveQuery<R>;
     /** One-shot distributed aggregate — central reduce over all shard records. */
@@ -7030,7 +7093,12 @@ interface MaterializedViewStrategy<TRow extends Record<string, unknown>> {
      *
      * Mutually exclusive with {@link query}. Registration throws
      * `MaterializedViewConfigError` if both are set, if `unionSources`
-     * has fewer than 2 arms, or if two arms name the same `collection`.
+     * is empty, or if two arms name the same `collection`.
+     *
+     * A SINGLE arm is valid (#331): it expresses map→group→aggregate
+     * over one collection with a COMPUTED bucket key (e.g. a month
+     * sliced from a date field). The query form's `.groupBy()` accepts
+     * stored field names only, so a derived key needs the arm's `map`.
      *
      * UNION mode replaces the dependency-analyzer path: the source
      * collections come directly from `unionSources[].collection`, and

package/dist/{types-CDwSSXiI.d.cts → types-BpPV5uyy.d.cts}

@@ -1,8 +1,8 @@
-import { I as IndexStrategy, d as LazyQuery } from './lazy-builder-Ci5_YG73.cjs';
-import { a7 as NoydbError, o as LiveAggregation, f as AggregateSpec, e as AggregateResult, A as AggregateStrategy, au as MoneyDescriptor } from './strategy-CrS7PnbE.cjs';
+import { I as IndexStrategy, d as LazyQuery } from './lazy-builder-eYZzLEL1.cjs';
+import { a7 as NoydbError, o as LiveAggregation, f as AggregateSpec, e as AggregateResult, A as AggregateStrategy, av as MoneyDescriptor } from './strategy-CbneC7bS.cjs';
 import { C as CrdtStrategy, a as CrdtMode, b as CrdtState } from './strategy-BSxFXGzb.cjs';
-import { L as LiveQuery, Q as Query, j as RefRegistry, R as RefDescriptor, d as JoinableSource, l as RefViolation, S as ScanBuilder } from './index-CUVOMtgg.cjs';
-import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-Bt5ft-9c.cjs';
+import { L as LiveQuery, Q as Query, c as JoinStrategy, j as RefRegistry, R as RefDescriptor, d as JoinableSource, l as RefViolation, S as ScanBuilder } from './index-D95VK1Qy.cjs';
+import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-BmhBSPCH.cjs';
 import { AttestationFieldSchema, RevocationList } from '@noy-db/attestation';
 
 /**
@@ -2972,9 +2972,18 @@ interface GatePutEvent {
     readonly vault: string;
     readonly collection: string;
     readonly docId: string;
-    /** The record about to be written (pre schema-validation). */
+    /**
+     * The record about to be written (pre schema-validation). Money fields
+     * are presented in their canonical decoded form (#332) — equal on both
+     * sides for an unchanged value, regardless of how the caller wrote them.
+     */
     readonly incoming: unknown;
-    /** Decrypted prior record, or null on create / when prior is unreadable. */
+    /**
+     * Decrypted prior record, or null on create / when prior is unreadable.
+     * Money fields are decoded to the canonical decimal `get()` shape, NOT
+     * the stored scaled-int (#332) — `incoming[f] === existing[f]` holds
+     * for an unchanged money field.
+     */
     readonly existing: unknown;
     /** Prior envelope version, or 0 when none. */
     readonly existingVersion: number;
@@ -2998,6 +3007,7 @@ interface GateDeleteEvent {
     readonly docId: string;
     /** True for system-internal (housekeeping) deletes — handlers branch on this. */
     readonly internal: boolean;
+    /** Decrypted prior record; money fields decoded to the canonical `get()` shape (#332). */
     readonly existing: unknown;
     readonly existingVersion: number;
     readonly existingTs: string | undefined;
@@ -5272,6 +5282,51 @@ interface FactorProofBundle {
 /** Active session tier — what the engine compares against `gate.minTier`. */
 type ActiveTier = 1 | 2 | 3;
 
+/** Public options for `ShardedQuery.crossShardJoin`. */
+interface CrossShardJoinOptions {
+    /** Alias key under which the joined same-shard record attaches. */
+    readonly as: string;
+    /** Per-shard row ceiling override (default DEFAULT_JOIN_MAX_ROWS). */
+    readonly maxRows?: number;
+    /** Planner strategy override, passed through to intra-vault `.join()`. */
+    readonly strategy?: JoinStrategy;
+}
+/**
+ * Minimal structural shape of a broadcast dimension source. A
+ * `Collection` satisfies this natively: `list()` hydrates and returns
+ * the decoded records. Kept as a one-method interface so plain test
+ * sources are trivial to construct.
+ */
+interface BroadcastSource {
+    list(): Promise<readonly unknown[]>;
+}
+/** Public options for `ShardedQuery.broadcastJoin`. */
+interface BroadcastJoinOptions {
+    /** Alias key under which the dimension record attaches. */
+    readonly as: string;
+    /** The shared dimension collection (an opened handle in another vault). */
+    readonly from: BroadcastSource;
+    /** Right-side key to match `field` against. Default 'id'. */
+    readonly on?: string;
+    /** Miss behavior. 'warn' (default) attaches null + one-shot warning; 'cascade' is silent. */
+    readonly mode?: 'warn' | 'cascade';
+}
+/** Internal co-partitioned leg carried on ShardedQuery. */
+interface CoPartitionedLeg {
+    readonly field: string;
+    readonly as: string;
+    readonly maxRows: number | undefined;
+    readonly strategy: JoinStrategy | undefined;
+}
+/** Internal broadcast leg carried on ShardedQuery. */
+interface BroadcastLeg {
+    readonly field: string;
+    readonly as: string;
+    readonly from: BroadcastSource;
+    readonly on: string;
+    readonly mode: 'warn' | 'cascade';
+}
+
 /** A source that can fan out records across shards. Satisfied by ShardedQuery. */
 interface FanoutRecordSource<R> {
     fanoutRecords(options: FanoutQueryOptions): Promise<{
@@ -5397,17 +5452,25 @@ declare class ShardedQuery<T, R = T> {
     private readonly group;
     private readonly collectionName;
     private readonly clauses;
-    constructor(group: VaultGroup<T>, collectionName: string, clauses: readonly WhereClause[]);
+    private readonly coPartitionedLegs;
+    private readonly broadcastLegs;
+    constructor(group: VaultGroup<T>, collectionName: string, clauses: readonly WhereClause[], coPartitionedLegs?: readonly CoPartitionedLeg[], broadcastLegs?: readonly BroadcastLeg[]);
     where(field: string, op: WhereClause['op'], value: unknown): ShardedQuery<T, R>;
+    /** Co-partitioned join: each shard joins its own same-vault right collection (resolved via ref()), then union. */
+    crossShardJoin(field: string, opts: CrossShardJoinOptions): ShardedQuery<T, R>;
+    /** Broadcast dimension join: enrich every merged row from a single shared collection. */
+    broadcastJoin(field: string, opts: BroadcastJoinOptions): ShardedQuery<T, R>;
     /** @internal — fan out the where-filtered records across eligible shards. */
     fanoutRecords(options?: FanoutQueryOptions): Promise<{
         records: R[];
         skippedVaults: SkippedVault[];
     }>;
-    /** Fan out across eligible shards and merge results. */
+    /** Fan out across eligible shards, merge, then apply any broadcast dimension legs. */
     toArray(options?: FanoutQueryOptions): Promise<FanoutResult<R>>;
     /** @internal — build the change-subscription + relevance binding for this query's group+collection. */
     liveBinding(): LiveBinding;
+    /** @internal — joined queries don't support reactive/aggregate surfaces in v1. */
+    private assertNoJoinLegs;
     /** Returns a reactive cross-shard live query — a facade over CrossVaultLive. */
     live(options?: LiveQueryOptions): CrossVaultLiveQuery<R>;
     /** One-shot distributed aggregate — central reduce over all shard records. */
@@ -7030,7 +7093,12 @@ interface MaterializedViewStrategy<TRow extends Record<string, unknown>> {
      *
      * Mutually exclusive with {@link query}. Registration throws
      * `MaterializedViewConfigError` if both are set, if `unionSources`
-     * has fewer than 2 arms, or if two arms name the same `collection`.
+     * is empty, or if two arms name the same `collection`.
+     *
+     * A SINGLE arm is valid (#331): it expresses map→group→aggregate
+     * over one collection with a COMPUTED bucket key (e.g. a month
+     * sliced from a date field). The query form's `.groupBy()` accepts
+     * stored field names only, so a derived key needs the arm's `map`.
      *
      * UNION mode replaces the dependency-analyzer path: the source
      * collections come directly from `unionSources[].collection`, and

package/dist/{ulid-7bCSgIgb.d.cts → ulid-CiPrpGqm.d.cts}

@@ -1,4 +1,4 @@
-import { br as PublicEnvelope, bs as SealingKeyProvider, bt as BundleRecipient, bu as RecipientSealer, bv as RecipientHint, bw as Vault } from './types-CDwSSXiI.cjs';
+import { br as PublicEnvelope, bs as SealingKeyProvider, bt as BundleRecipient, bu as RecipientSealer, bv as RecipientHint, bw as Vault } from './types-BpPV5uyy.cjs';
 
 /**
  * `.noydb` container format — byte layout, header schema, validators.

package/dist/{ulid-C_t4hL3d.d.ts → ulid-DAfenvFd.d.ts}

@@ -1,4 +1,4 @@
-import { br as PublicEnvelope, bs as SealingKeyProvider, bt as BundleRecipient, bu as RecipientSealer, bv as RecipientHint, bw as Vault } from './types-pax34sec.js';
+import { br as PublicEnvelope, bs as SealingKeyProvider, bt as BundleRecipient, bu as RecipientSealer, bv as RecipientHint, bw as Vault } from './types-4t1-tWS4.js';
 
 /**
  * `.noydb` container format — byte layout, header schema, validators.