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

package/dist/blobs/index.d.cts

@@ -1,5 +1,5 @@
-import { B as BlobStrategy } from '../types-CDwSSXiI.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-CDwSSXiI.cjs';
+import { B as BlobStrategy } from '../types-V5R2-pd4.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-V5R2-pd4.cjs';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.cjs';
 import '../lazy-builder-Ci5_YG73.cjs';
 import '../predicate-Bt5ft-9c.cjs';

package/dist/blobs/index.d.ts

@@ -1,5 +1,5 @@
-import { B as BlobStrategy } from '../types-pax34sec.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-pax34sec.js';
+import { B as BlobStrategy } from '../types-BFHQUjdy.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-BFHQUjdy.js';
 export { d as detectMagic, a as detectMimeType, i as isPreCompressed } from '../mime-magic-CBBSOkjm.js';
 import '../lazy-builder-D5GU14TS.js';
 import '../predicate-Bt5ft-9c.js';

package/dist/blobs/index.js

@@ -9,17 +9,17 @@ import {
   detectMagic,
   detectMimeType,
   isPreCompressed
-} from "../chunk-QAWCVWCX.js";
+} from "../chunk-LX3CB26H.js";
 import {
   BLOB_EVICTION_AUDIT_COLLECTION,
   EXPORT_AUDIT_COLLECTION,
   ExportBlobsAbortedError,
   createExportBlobsHandle,
   runCompaction
-} from "../chunk-TDECYU4Y.js";
+} from "../chunk-6AJBSQU4.js";
 import "../chunk-GC4V7RU7.js";
-import "../chunk-E3DIBDKA.js";
-import "../chunk-NKGY3C53.js";
+import "../chunk-YULZKK4F.js";
+import "../chunk-535SSHBS.js";
 
 // src/blobs/active.ts
 function withBlobs() {

package/dist/bundle/index.cjs

@@ -31,7 +31,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/errors.ts
-var NoydbError, DecryptionError, TamperedError, InvalidKeyError, KeyringCorruptError, NoAccessError, ReadOnlyError, PermissionDeniedError, ExportCapabilityError, KeyringExpiredError, ImportCapabilityError, StoreCapabilityError, PrivilegeEscalationError, ReservedVaultNameError, FieldFrozenError, InvariantError, AmendmentForbiddenError, TierNotGrantedError, ElevationExpiredError, AlreadyElevatedError, TierDemoteDeniedError, DelegationTargetMissingError, ConflictError, LedgerContentionError, SequenceContentionError, SequenceOfflineError, NumberingUncertaintyError, BundleVersionConflictError, ValidationError, SchemaValidationError, SchemaUpdateError, SchemaFenceError, MigrationRequiredError, QuiesceTimeoutError, GroupCardinalityError, IndexRequiredError, UniqueConstraintError, UnsupportedIndexOptionError, IndexWriteFailureError, BundleIntegrityError, BundleSealMismatchError, ReservedCollectionNameError, LocaleNotSpecifiedError, TranslatorNotConfiguredError, BackupLedgerError, BackupCorruptedError, PartitionExtractionError, TransferSealError, AdoptionStateError, AttestationError, JoinTooLargeError, CrossJoinTooLargeError, CrossJoinSourceUnknownError, DanglingReferenceError, DerivationCycleError, DerivationOutputShapeError, DerivationCapExceededError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, OverlayBaseIsVirtualError, OverlayCollectionUnavailableError, OverlayNameCollisionError, OverlayIdMismatchError, UnknownShardError, ShardProvisioningError, VaultTemplateNotFoundError;
+var NoydbError, DecryptionError, TamperedError, InvalidKeyError, KeyringCorruptError, NoAccessError, ReadOnlyError, PermissionDeniedError, ExportCapabilityError, KeyringExpiredError, ImportCapabilityError, StoreCapabilityError, PrivilegeEscalationError, ReservedVaultNameError, FieldFrozenError, InvariantError, AmendmentForbiddenError, TierNotGrantedError, ElevationExpiredError, AlreadyElevatedError, TierDemoteDeniedError, DelegationTargetMissingError, ConflictError, LedgerContentionError, SequenceContentionError, SequenceOfflineError, NumberingUncertaintyError, BundleVersionConflictError, ValidationError, SchemaValidationError, SchemaUpdateError, SchemaFenceError, MigrationRequiredError, QuiesceTimeoutError, GroupCardinalityError, IndexRequiredError, UniqueConstraintError, UnsupportedIndexOptionError, IndexWriteFailureError, BundleIntegrityError, BundleSealMismatchError, ReservedCollectionNameError, LocaleNotSpecifiedError, TranslatorNotConfiguredError, BackupLedgerError, BackupCorruptedError, PartitionExtractionError, TransferSealError, AdoptionStateError, AttestationError, JoinTooLargeError, CrossJoinTooLargeError, CrossJoinSourceUnknownError, DanglingReferenceError, DerivationCycleError, DerivationOutputShapeError, DerivationCapExceededError, MaterializedViewCycleError, MaterializedViewSourceUnknownError, MaterializedViewTooLargeError, OverlayBaseIsVirtualError, OverlayCollectionUnavailableError, OverlayNameCollisionError, OverlayIdMismatchError, UnknownShardError, ShardProvisioningError, CrossShardJoinError, VaultTemplateNotFoundError;
 var init_errors = __esm({
   "src/errors.ts"() {
     "use strict";
@@ -746,6 +746,12 @@ Resolutions:
         this.vaultId = vaultId;
       }
     };
+    CrossShardJoinError = class extends NoydbError {
+      constructor(message) {
+        super("CROSS_SHARD_JOIN", message);
+        this.name = "CrossShardJoinError";
+      }
+    };
     VaultTemplateNotFoundError = class extends NoydbError {
       templateName;
       constructor(templateName) {
@@ -17203,6 +17209,54 @@ var init_classify_skip = __esm({
   }
 });
 
+// src/federation/cross-shard-join.ts
+function coerceKey(value) {
+  if (value === null || value === void 0) return null;
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "bigint") return String(value);
+  return null;
+}
+function warnOnceBroadcastMiss(field, as, key) {
+  const dedup = `${field}\u2192${as}:${key}`;
+  if (warnedBroadcastKeys.has(dedup)) return;
+  warnedBroadcastKeys.add(dedup);
+  console.warn(
+    `[noy-db] broadcastJoin: no "${as}" dimension row for ${field}="${key}". Attaching null. Use mode: 'cascade' to silence.`
+  );
+}
+async function applyBroadcastLegs(rows, legs) {
+  if (legs.length === 0) return [...rows];
+  const indexes = [];
+  for (const leg of legs) {
+    const map = /* @__PURE__ */ new Map();
+    for (const rec of await leg.from.list()) {
+      const k = coerceKey(readPath(rec, leg.on));
+      if (k !== null && !map.has(k)) map.set(k, rec);
+    }
+    indexes.push({ leg, map });
+  }
+  return rows.map((row) => {
+    const out = { ...row };
+    for (const { leg, map } of indexes) {
+      const key = coerceKey(readPath(row, leg.field));
+      const match = key === null ? null : map.get(key) ?? null;
+      if (match === null && leg.mode === "warn") {
+        warnOnceBroadcastMiss(leg.field, leg.as, key ?? "<null>");
+      }
+      out[leg.as] = match;
+    }
+    return out;
+  });
+}
+var warnedBroadcastKeys;
+var init_cross_shard_join = __esm({
+  "src/federation/cross-shard-join.ts"() {
+    "use strict";
+    init_predicate();
+    warnedBroadcastKeys = /* @__PURE__ */ new Set();
+  }
+});
+
 // src/federation/cross-vault-live.ts
 var CrossVaultLive;
 var init_cross_vault_live = __esm({
@@ -17431,6 +17485,7 @@ var init_vault_group = __esm({
     init_errors();
     init_constants2();
     init_classify_skip();
+    init_cross_shard_join();
     init_cross_vault_live();
     init_aggregate_across();
     SHARD_SEPARATOR = "--";
@@ -17594,31 +17649,89 @@ var init_vault_group = __esm({
       }
     };
     ShardedQuery = class _ShardedQuery {
-      constructor(group, collectionName, clauses) {
+      constructor(group, collectionName, clauses, coPartitionedLegs = [], broadcastLegs = []) {
         this.group = group;
         this.collectionName = collectionName;
         this.clauses = clauses;
+        this.coPartitionedLegs = coPartitionedLegs;
+        this.broadcastLegs = broadcastLegs;
       }
       group;
       collectionName;
       clauses;
+      coPartitionedLegs;
+      broadcastLegs;
       where(field, op, value) {
-        return new _ShardedQuery(this.group, this.collectionName, [
-          ...this.clauses,
-          { field, op, value }
-        ]);
+        return new _ShardedQuery(
+          this.group,
+          this.collectionName,
+          [...this.clauses, { field, op, value }],
+          this.coPartitionedLegs,
+          this.broadcastLegs
+        );
+      }
+      /** Co-partitioned join: each shard joins its own same-vault right collection (resolved via ref()), then union. */
+      crossShardJoin(field, opts) {
+        const leg = { field, as: opts.as, maxRows: opts.maxRows, strategy: opts.strategy };
+        return new _ShardedQuery(
+          this.group,
+          this.collectionName,
+          this.clauses,
+          [...this.coPartitionedLegs, leg],
+          this.broadcastLegs
+        );
+      }
+      /** Broadcast dimension join: enrich every merged row from a single shared collection. */
+      broadcastJoin(field, opts) {
+        const leg = {
+          field,
+          as: opts.as,
+          from: opts.from,
+          on: opts.on ?? "id",
+          mode: opts.mode ?? "warn"
+        };
+        return new _ShardedQuery(
+          this.group,
+          this.collectionName,
+          this.clauses,
+          this.coPartitionedLegs,
+          [...this.broadcastLegs, leg]
+        );
       }
       /** @internal — fan out the where-filtered records across eligible shards. */
       async fanoutRecords(options = {}) {
         const { eligible, skipped } = await this.group.resolveEligible(options);
+        const probeRow = eligible[0];
+        if (this.coPartitionedLegs.length > 0 && probeRow) {
+          const probe = await this.group.openShard(probeRow.partitionKey);
+          this.group.template.configure(probe);
+          for (const leg of this.coPartitionedLegs) {
+            if (!probe.resolveRef(this.collectionName, leg.field)) {
+              throw new CrossShardJoinError(
+                `crossShardJoin("${leg.field}"): no ref() declared for "${leg.field}" on collection "${this.collectionName}" in template "${this.group.sharding.vaultTemplate}". Add refs: { ${leg.field}: ref('<target>') } to the template's collection options.`
+              );
+            }
+          }
+        }
         const across = await this.group.db.queryAcross(
           eligible.map((r) => r.vaultId),
           async (vault) => {
             this.group.template.configure(vault);
             const coll = vault.collection(this.collectionName);
             await coll.list();
+            for (const leg of this.coPartitionedLegs) {
+              const desc = vault.resolveRef(this.collectionName, leg.field);
+              if (desc) await vault.collection(desc.target).list();
+            }
             let q = coll.query();
             for (const c of this.clauses) q = q.where(c.field, c.op, c.value);
+            for (const leg of this.coPartitionedLegs) {
+              q = q.join(leg.field, {
+                as: leg.as,
+                ...leg.maxRows !== void 0 ? { maxRows: leg.maxRows } : {},
+                ...leg.strategy ? { strategy: leg.strategy } : {}
+              });
+            }
             return q.toArray();
           },
           { concurrency: options.concurrency ?? 1, create: false }
@@ -17630,10 +17743,11 @@ var init_vault_group = __esm({
         }
         return { records: results, skippedVaults: skipped };
       }
-      /** Fan out across eligible shards and merge results. */
+      /** Fan out across eligible shards, merge, then apply any broadcast dimension legs. */
       async toArray(options = {}) {
         const { records, skippedVaults } = await this.fanoutRecords(options);
-        return { results: records, skippedVaults };
+        const results = await applyBroadcastLegs(records, this.broadcastLegs);
+        return { results, skippedVaults };
       }
       /** @internal — build the change-subscription + relevance binding for this query's group+collection. */
       liveBinding() {
@@ -17647,8 +17761,17 @@ var init_vault_group = __esm({
           isRelevant: (e) => e.collection === collectionName && e.vault.startsWith(`${group.name}--`)
         };
       }
+      /** @internal — joined queries don't support reactive/aggregate surfaces in v1. */
+      assertNoJoinLegs(surface) {
+        if (this.coPartitionedLegs.length || this.broadcastLegs.length) {
+          throw new CrossShardJoinError(
+            `${surface}() is not supported on a ShardedQuery with crossShardJoin/broadcastJoin legs in v1. Use toArray() for joined cross-shard queries.`
+          );
+        }
+      }
       /** Returns a reactive cross-shard live query — a facade over CrossVaultLive. */
       live(options = {}) {
+        this.assertNoJoinLegs("live");
         const bind = this.liveBinding();
         const core = new CrossVaultLive({
           ...bind,
@@ -17676,10 +17799,12 @@ var init_vault_group = __esm({
       }
       /** One-shot distributed aggregate — central reduce over all shard records. */
       aggregate(spec) {
+        this.assertNoJoinLegs("aggregate");
         return new CrossVaultAggregation(this, spec, this.liveBinding());
       }
       /** Begin a grouped cross-shard aggregate. */
       groupBy(field) {
+        this.assertNoJoinLegs("groupBy");
         return new ShardedGroupedQuery(this, field);
       }
     };