@noy-db/hub 0.2.0-pre.28 → 0.2.0-pre.29

package/dist/i18n/index.d.cts

@@ -1,12 +1,12 @@
-export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-DDNvt_UD.cjs';
-import { I as I18nStrategy } from '../types-B_eCkuEI.cjs';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-B_eCkuEI.cjs';
-export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dwk2k1xY.cjs';
+export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-mJExw4LQ.cjs';
+import { I as I18nStrategy } from '../types-Ba1vQ3AY.cjs';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-Ba1vQ3AY.cjs';
+export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-BAWO5Z5a.cjs';
 import '../lazy-builder-eYZzLEL1.cjs';
 import '../predicate-BmhBSPCH.cjs';
 import '../strategy-BSxFXGzb.cjs';
 import '../index-BMmajblo.cjs';
-import '../index-CVnt2Qmq.cjs';
+import '../index-C1SC1EPe.cjs';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.d.ts

@@ -1,12 +1,12 @@
-export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-BoITAb2H.js';
-import { I as I18nStrategy } from '../types-84nsWSDF.js';
-export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-84nsWSDF.js';
-export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-Dwk2k1xY.js';
+export { I as I18nMap, a as I18nTextDescriptor, b as I18nTextOptions, L as Layer, O as OnMissing, c as OnMissingPolicy, R as ResolveI18nOptions, d as applyI18nLocale, g as getAtPath, i as i18nText, e as isI18nTextDescriptor, r as resolveI18nText, f as resolvePolicy, s as setAtPathInPlace, h as stripI18nFilled, v as validateI18nTextValue } from '../strategy-8QGs5KQE.js';
+import { I as I18nStrategy } from '../types-CUmZYJwN.js';
+export { D as DICT_COLLECTION_PREFIX, a as DictEntry, b as DictKeyDescriptor, c as DictionaryHandle, d as DictionaryOptions, S as ScriptWarning, e as StaticDictDescriptor, f as dictCollectionName, g as dictKey, h as enforceScript, i as inferScripts, j as isDictCollectionName, k as isDictKeyDescriptor, l as isStaticDictDescriptor, s as staticDict } from '../types-CUmZYJwN.js';
+export { D as DictKeyInUseError, a as DictKeyMissingError, L as LocaleNotSpecifiedError, M as MissingTranslationError, R as ReservedCollectionNameError, S as ScriptViolationError, b as StaticDictReadonlyError, T as TranslatorNotConfiguredError, U as UnknownDictCodeError } from '../errors-BAWO5Z5a.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
 import '../strategy-BSxFXGzb.js';
 import '../index-BMmajblo.js';
-import '../index-DxBNV54L.js';
+import '../index-Ddm8D3Oo.js';
 import '@noy-db/attestation';
 
 /**

package/dist/i18n/index.js

@@ -7,7 +7,7 @@ import {
   isDictKeyDescriptor,
   isStaticDictDescriptor,
   staticDict
-} from "../chunk-HQ242WNG.js";
+} from "../chunk-REHF3HSJ.js";
 import {
   applyI18nLocale,
   enforceScript,
@@ -20,11 +20,11 @@ import {
   setAtPathInPlace,
   stripI18nFilled,
   validateI18nTextValue
-} from "../chunk-6LD37AMK.js";
-import "../chunk-VSL3W2MO.js";
+} from "../chunk-QXWJQ7UU.js";
+import "../chunk-ZCMOS4H2.js";
 import "../chunk-PDVP3C2I.js";
-import "../chunk-QSLIT4JZ.js";
-import "../chunk-7JSP3E67.js";
+import "../chunk-A7DNZVAV.js";
+import "../chunk-E2MDPPOC.js";
 import {
   DictKeyInUseError,
   DictKeyMissingError,
@@ -35,7 +35,7 @@ import {
   StaticDictReadonlyError,
   TranslatorNotConfiguredError,
   UnknownDictCodeError
-} from "../chunk-DDOYOMAD.js";
+} from "../chunk-JZ5DS4DP.js";
 
 // src/i18n/densify.ts
 var MARKER = "_i18nFilled";

package/dist/{index-CVnt2Qmq.d.cts → index-C1SC1EPe.d.cts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.cjs';
-import { N as NoydbError } from './errors-Dwk2k1xY.cjs';
-import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-DDNvt_UD.cjs';
+import { N as NoydbError } from './errors-BAWO5Z5a.cjs';
+import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-mJExw4LQ.cjs';
 
 /**
  * Foreign-key references — the soft-FK mechanism.
@@ -591,6 +591,14 @@ interface QuerySource<T> {
      * `sum`/`min`/`max` over money fields into exact BigInt reducers.
      */
     moneyFields?: Record<string, MoneyDescriptor>;
+    /**
+     * #308 L3 — id-paired snapshot for `Query._idArray()` (the `retrieve({within})`
+     * id projection). Optional: only collection-backed queries supply it.
+     */
+    snapshotEntries?(): readonly {
+        id: string;
+        record: T;
+    }[];
 }
 /**
  * The chainable builder. All methods return a new Query — the original
@@ -643,6 +651,15 @@ declare class Query<T> {
      * Consumers don't call this directly.
      */
     _withPredicates(predicates: ReadonlyMap<string, DeclaredPredicate>): Query<T>;
+    /**
+     * @internal — #308 L3. The ids of records matching this query's plan,
+     * recovered by reference identity: `executePlanWithSource` returns the
+     * ORIGINAL snapshot record references (money-decode and joins are applied
+     * later, in `toArray`), so each matched record is found in the id-paired
+     * `snapshotEntries()` map. Used by `collection.retrieve({ within })`.
+     * Throws if the source is not collection-backed (no `snapshotEntries`).
+     */
+    _idArray(): string[];
     /**
      * Filter by a registered deterministic predicate. Requires
      * the Query to have been augmented with a predicates map (typically

package/dist/{index-CP24aYCp.d.cts → index-DPG2nFmT.d.cts}

@@ -1,9 +1,32 @@
 import './predicate-BmhBSPCH.cjs';
-import './strategy-DDNvt_UD.cjs';
+import './strategy-mJExw4LQ.cjs';
 import './ulid-DRH25k3y.cjs';
-import './types-B_eCkuEI.cjs';
-import './errors-Dwk2k1xY.cjs';
-import './index-CVnt2Qmq.cjs';
+import { dX as RetrieveHit } from './types-Ba1vQ3AY.cjs';
+import './errors-BAWO5Z5a.cjs';
+import './index-C1SC1EPe.cjs';
+
+/**
+ * #308 L3 — Reciprocal Rank Fusion. Merges N ranked `RetrieveHit` lists into
+ * one, scoring each id by Σ 1/(k + rank) across the lists it appears in. Pure,
+ * deterministic, no I/O — which is why it serves BOTH hybrid lexical⊕semantic
+ * fusion AND klum-db's cross-vault federation (the lists are per-vault). The
+ * fused `score` is the RRF score, NOT BM25 or cosine.
+ */
+
+interface FuseOptions {
+    /** Only 'rrf' in v1 (default). */
+    readonly strategy?: 'rrf';
+    /** RRF constant; larger flattens the rank weighting. Default 60. */
+    readonly k?: number;
+    /** Truncate the fused output to this many hits. */
+    readonly limit?: number;
+}
+/**
+ * Callers must supply hits with `rank >= 1` (the retrieve contract guarantees
+ * it; a federation caller passing `rank: 0` with `k: 0` would divide by zero).
+ * Doc-only note — no runtime guard; rank ≥ 1 is the retrieve contract.
+ */
+declare function fuseRetrieval<T>(lists: ReadonlyArray<ReadonlyArray<RetrieveHit<T>>>, opts?: FuseOptions): RetrieveHit<T>[];
 
 interface EncryptResult {
     iv: string;
@@ -67,4 +90,4 @@ declare function decryptDeterministic(ivBase64: string, dataBase64: string, dek:
 declare function bufferToBase64(buffer: ArrayBuffer | Uint8Array): string;
 declare function base64ToBuffer(base64: string): Uint8Array<ArrayBuffer>;
 
-export { bufferToBase64 as a, base64ToBuffer as b, decryptDeterministic as c, decryptBytes as d, derivePresenceKey as e, encryptBytes as f, encryptDeterministic as g, sha256Hex as s };
+export { type FuseOptions as F, bufferToBase64 as a, base64ToBuffer as b, decryptDeterministic as c, decryptBytes as d, derivePresenceKey as e, encryptBytes as f, encryptDeterministic as g, fuseRetrieval as h, sha256Hex as s };

package/dist/{index-BidHvmWf.d.ts → index-DcxTv3zx.d.ts}

@@ -1,9 +1,32 @@
 import './predicate-BmhBSPCH.js';
-import './strategy-BoITAb2H.js';
+import './strategy-8QGs5KQE.js';
 import './ulid-DRH25k3y.js';
-import './types-84nsWSDF.js';
-import './errors-Dwk2k1xY.js';
-import './index-DxBNV54L.js';
+import { dX as RetrieveHit } from './types-CUmZYJwN.js';
+import './errors-BAWO5Z5a.js';
+import './index-Ddm8D3Oo.js';
+
+/**
+ * #308 L3 — Reciprocal Rank Fusion. Merges N ranked `RetrieveHit` lists into
+ * one, scoring each id by Σ 1/(k + rank) across the lists it appears in. Pure,
+ * deterministic, no I/O — which is why it serves BOTH hybrid lexical⊕semantic
+ * fusion AND klum-db's cross-vault federation (the lists are per-vault). The
+ * fused `score` is the RRF score, NOT BM25 or cosine.
+ */
+
+interface FuseOptions {
+    /** Only 'rrf' in v1 (default). */
+    readonly strategy?: 'rrf';
+    /** RRF constant; larger flattens the rank weighting. Default 60. */
+    readonly k?: number;
+    /** Truncate the fused output to this many hits. */
+    readonly limit?: number;
+}
+/**
+ * Callers must supply hits with `rank >= 1` (the retrieve contract guarantees
+ * it; a federation caller passing `rank: 0` with `k: 0` would divide by zero).
+ * Doc-only note — no runtime guard; rank ≥ 1 is the retrieve contract.
+ */
+declare function fuseRetrieval<T>(lists: ReadonlyArray<ReadonlyArray<RetrieveHit<T>>>, opts?: FuseOptions): RetrieveHit<T>[];
 
 interface EncryptResult {
     iv: string;
@@ -67,4 +90,4 @@ declare function decryptDeterministic(ivBase64: string, dataBase64: string, dek:
 declare function bufferToBase64(buffer: ArrayBuffer | Uint8Array): string;
 declare function base64ToBuffer(base64: string): Uint8Array<ArrayBuffer>;
 
-export { bufferToBase64 as a, base64ToBuffer as b, decryptDeterministic as c, decryptBytes as d, derivePresenceKey as e, encryptBytes as f, encryptDeterministic as g, sha256Hex as s };
+export { type FuseOptions as F, bufferToBase64 as a, base64ToBuffer as b, decryptDeterministic as c, decryptBytes as d, derivePresenceKey as e, encryptBytes as f, encryptDeterministic as g, fuseRetrieval as h, sha256Hex as s };

package/dist/{index-DxBNV54L.d.ts → index-Ddm8D3Oo.d.ts}

@@ -1,6 +1,6 @@
 import { C as CollectionIndexes, a as Clause, O as Operator } from './predicate-BmhBSPCH.js';
-import { N as NoydbError } from './errors-Dwk2k1xY.js';
-import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-BoITAb2H.js';
+import { N as NoydbError } from './errors-BAWO5Z5a.js';
+import { a as I18nTextDescriptor, P as MoneyDescriptor, A as AggregateStrategy, k as AggregateSpec, l as Aggregation, j as AggregateResult, p as GroupedQuery, q as GroupedQueryN } from './strategy-8QGs5KQE.js';
 
 /**
  * Foreign-key references — the soft-FK mechanism.
@@ -591,6 +591,14 @@ interface QuerySource<T> {
      * `sum`/`min`/`max` over money fields into exact BigInt reducers.
      */
     moneyFields?: Record<string, MoneyDescriptor>;
+    /**
+     * #308 L3 — id-paired snapshot for `Query._idArray()` (the `retrieve({within})`
+     * id projection). Optional: only collection-backed queries supply it.
+     */
+    snapshotEntries?(): readonly {
+        id: string;
+        record: T;
+    }[];
 }
 /**
  * The chainable builder. All methods return a new Query — the original
@@ -643,6 +651,15 @@ declare class Query<T> {
      * Consumers don't call this directly.
      */
     _withPredicates(predicates: ReadonlyMap<string, DeclaredPredicate>): Query<T>;
+    /**
+     * @internal — #308 L3. The ids of records matching this query's plan,
+     * recovered by reference identity: `executePlanWithSource` returns the
+     * ORIGINAL snapshot record references (money-decode and joins are applied
+     * later, in `toArray`), so each matched record is found in the id-paired
+     * `snapshotEntries()` map. Used by `collection.retrieve({ within })`.
+     * Throws if the source is not collection-backed (no `snapshotEntries`).
+     */
+    _idArray(): string[];
     /**
      * Filter by a registered deterministic predicate. Requires
      * the Query to have been augmented with a predicates map (typically