@dreamlake/dreamdb 0.5.3 → 0.5.4

package/README.md

@@ -1,10 +1,11 @@
 # @dreamlake/dreamdb
 
-Documentation scope: the public npm release is 0.5.2 as checked on 2026-09-10.
-New APIs merged on main (entity keys, progressive geometry and structured arrays)
-require a source build until a corresponding package is published. See the
-[main/unreleased guide](https://dreamdb.dreamlake.ai/main-features) separately
-from the [released SDK reference](https://dreamdb.dreamlake.ai/typescript-sdk-api).
+Package scope: npm 0.5.4 retains entity keys, progressive geometry and structured
+arrays, and adds query-local rerank policy/pool options. Shared-core fixes include
+reference-mode GC retention; Rust operator APIs are not automatically JS exports.
+See the [release notes](https://github.com/dreamlake-ai/dreamdb-core/blob/main/docs/releases/python-0.0.12-npm-0.5.4.md),
+[feature guide](https://dreamdb.dreamlake.ai/main-features) and
+[SDK reference](https://dreamdb.dreamlake.ai/typescript-sdk-api).
 
 The DreamDB SDK — read and write, in the browser and on the server, compiled to
 WebAssembly from the same Rust core the CLI and Python SDK use.

package/browser/dreamdb.d.ts

@@ -177,7 +177,11 @@ export class Space {
     queryText(field: string, query: string, top_k: number): Promise<Array<any>>;
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/browser/dreamdb_bg.js

@@ -386,7 +386,11 @@ export class Space {
     }
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/index.d.ts

@@ -315,7 +315,11 @@ export class Space {
     queryText(field: string, query: string, top_k: number): Promise<Array<any>>;
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/node/dreamdb.cjs

@@ -718,7 +718,11 @@ class Space {
     }
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/node/dreamdb.d.cts

@@ -300,7 +300,11 @@ export class Space {
     queryText(field: string, query: string, top_k: number): Promise<Array<any>>;
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dreamlake/dreamdb",
-  "version": "0.5.3",
+  "version": "0.5.4",
   "description": "DreamDB SDK — isomorphic (browser + Node) read and write, compiled from the Rust core",
   "license": "MIT OR Apache-2.0",
   "type": "module",

package/web/dreamdb.d.ts

@@ -177,7 +177,11 @@ export class Space {
     queryText(field: string, query: string, top_k: number): Promise<Array<any>>;
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +

package/web/dreamdb.js

@@ -388,7 +388,11 @@ export class Space {
     }
     /**
      * Top-K cosine vector search over an embedding `field`. `opts` may be a
-     * number (topK) or `{ topK?, probeCount? }`. Returns `[{ anchor, score }]`
+     * number (topK) or `{ topK?, probeCount?, specId?, rerankPoolSize?, rerankMode? }`.
+     * The optional pool must be a positive integer at least topK; it changes
+     * neither probe coverage nor Schema exactness. rerankMode explicitly selects
+     * inherit (default), approximate or exact. Graphs reject explicit overrides.
+     * Returns `[{ anchor, score }]`
      * sorted by score descending — the shape dreamdb-ts's `queryVector` yields.
      *
      * Delegates to the real (tested) `dreamdb-dataset` query path: ADC cull +