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

package/dist/tx/index.d.cts

@@ -1,5 +1,5 @@
-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 { aH as TxStrategy } from '../types-V5R2-pd4.cjs';
+export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-V5R2-pd4.cjs';
 import '../lazy-builder-Ci5_YG73.cjs';
 import '../predicate-Bt5ft-9c.cjs';
 import '../strategy-CrS7PnbE.cjs';

package/dist/tx/index.d.ts

@@ -1,5 +1,5 @@
-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 { aH as TxStrategy } from '../types-BFHQUjdy.js';
+export { aI as AmendmentTxOptions, aJ as TxCollection, aK as TxContext, aL as TxVault, aM as runTransaction } from '../types-BFHQUjdy.js';
 import '../lazy-builder-D5GU14TS.js';
 import '../predicate-Bt5ft-9c.js';
 import '../strategy-CrS7PnbE.js';

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-BFHQUjdy.d.ts}

@@ -1,7 +1,7 @@
 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 { 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 { 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-Cqzp4tt9.js';
 import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-Bt5ft-9c.js';
 import { AttestationFieldSchema, RevocationList } from '@noy-db/attestation';
 
@@ -5272,6 +5272,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 +5442,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. */

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

@@ -1,7 +1,7 @@
 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 { 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 { 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-CUVOMtgg.cjs';
 import { I as IndexDef, O as Operator, F as FieldClause, C as CollectionIndexes } from './predicate-Bt5ft-9c.cjs';
 import { AttestationFieldSchema, RevocationList } from '@noy-db/attestation';
 
@@ -5272,6 +5272,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 +5442,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. */

package/dist/{ulid-7bCSgIgb.d.cts → ulid-CwNf9e6-.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-V5R2-pd4.cjs';
 
 /**
  * `.noydb` container format — byte layout, header schema, validators.

package/dist/{ulid-C_t4hL3d.d.ts → ulid-p2nKiiKg.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-BFHQUjdy.js';
 
 /**
  * `.noydb` container format — byte layout, header schema, validators.