@infino-ai/infino 0.9.3 → 0.11.0

package/infino/index.d.ts

@@ -8,9 +8,6 @@ export declare const BUILDER_ID: string;
 export type Metric = "cosine" | "l2sq" | "l2" | "negdot" | "dot";
 /** Boolean mode for multi-term FTS queries. */
 export type BoolMode = "or" | "and";
-/** BM25 statistics scope: corpus-wide `"global"` IDF across superfiles
- * (the default) or `"per_superfile"` segment-local IDF. */
-export type Bm25Stats = "per_superfile" | "global";
 /** A row from a query/search when not materializing to Arrow. */
 export type RowRecord = Record<string, unknown>;
 /** A plain `{ column: type }` schema descriptor for `createTable`. */
@@ -168,15 +165,6 @@ export interface ReindexOptions {
     /** How old a sealed tombstone sidecar has to be, in milliseconds, before a
      * rewrite takes it over. Omit to use the table's compaction setting. */
     staleSealTimeoutMs?: number;
-    /**
-     * Credit a superfile that records no analysis revision with the one its
-     * writer emitted (default `false`). **Only sound when the table never held
-     * superfiles older than that writer**: an older compaction can have folded
-     * stale terms into a newer-stamped file, and crediting it reports the table
-     * migrated with those terms still in place. Leave unset unless the table's
-     * whole history is known.
-     */
-    trustWriterAnalysis?: boolean;
 }
 /** What a `reindex` did. */
 export interface ReindexReport {
@@ -226,8 +214,6 @@ export interface PlannedRepair {
 }
 export interface Bm25SearchOptions {
     mode?: BoolMode;
-    /** BM25 statistics scope: `"global"` (default) or `"per_superfile"`. */
-    stats?: Bm25Stats;
     /** Columns to return, e.g. `["_id", "score"]`; omit for full rows. */
     projection?: string[];
     /** BM25 `k1` for this search only, overriding the column's declared value.

package/infino/index.js

@@ -47,6 +47,24 @@ Object.defineProperty(exports, "IndexSpec", { enumerable: true, get: function ()
 /** Infino's build identifier (version + build hash). */
 exports.BUILDER_ID = (0, native_js_1.builderId)();
 const STREAM = "stream";
+// Options the engine no longer takes, with what replaces each. The addon
+// drops unknown keys, so these throw rather than be silently ignored.
+const REMOVED_SEARCH_OPTIONS = {
+    stats: "term search scores with table-wide statistics; prefix search and lazily loaded tables score each segment with its own",
+};
+const REMOVED_REINDEX_OPTIONS = {
+    trustWriterAnalysis: "every superfile records its analysis revision",
+};
+/** Throws a `TypeError` naming the first removed option `opts` carries. */
+function rejectRemovedOptions(call, opts, removed) {
+    if (opts == null)
+        return;
+    for (const key of Object.keys(opts)) {
+        if (Object.hasOwn(removed, key)) {
+            throw new TypeError(`${call}: option \`${key}\` is not supported: ${removed[key]}`);
+        }
+    }
+}
 // --- Arrow <-> IPC helpers (the boundary this layer hides) ---
 // Rebuild an arrow type in our instance from the consumer's type. When
 // apache-arrow is loaded as two module instances, our `makeData` can't
@@ -288,7 +306,8 @@ class Table {
         guard(this.remote, () => "rows" in input ? this.inner.appendRowsNamed(input.rows, sourceName) : this.inner.appendNamed(input.ipc, sourceName));
     }
     bm25Search(column, query, k, opts = {}) {
-        const buf = guard(this.remote, () => this.inner.bm25Search(column, query, k, opts.mode, opts.stats, opts.projection, opts.k1, opts.b));
+        rejectRemovedOptions("bm25Search", opts, REMOVED_SEARCH_OPTIONS);
+        const buf = guard(this.remote, () => this.inner.bm25Search(column, query, k, opts.mode, opts.projection, opts.k1, opts.b));
         return decode(buf, opts.arrow);
     }
     vectorSearch(column, query, k, opts = {}) {
@@ -359,16 +378,19 @@ class Table {
      * and `reindexPlan` / `indexStaleness` — throws with `code` `"InvalidArg"`.
      */
     reindex(options) {
+        rejectRemovedOptions("reindex", options, REMOVED_REINDEX_OPTIONS);
         return guard(this.remote, () => this.inner.reindex(options));
     }
     /** The superfiles {@link Table.reindex} would repair under `options`, and
      * the repair each gets — without repairing anything. Writes nothing. */
     reindexPlan(options) {
+        rejectRemovedOptions("reindexPlan", options, REMOVED_REINDEX_OPTIONS);
         return guard(this.remote, () => this.inner.reindexPlan(options));
     }
     /** What is behind and what repairing it would cost. Writes nothing, so it is
      * safe against a live table. */
     indexStaleness(options) {
+        rejectRemovedOptions("indexStaleness", options, REMOVED_REINDEX_OPTIONS);
         return guard(this.remote, () => this.inner.indexStaleness(options));
     }
 }

package/infino/native.d.ts

@@ -102,15 +102,6 @@ export interface ReindexOptions {
    * rewrite takes it over. Omit to use the table's compaction setting.
    */
   staleSealTimeoutMs?: number
-  /**
-   * Credit a superfile that records no analysis revision with the one its
-   * writer emitted (default `false`). **Only sound when the table never held
-   * superfiles older than that writer**: an older compaction can have folded
-   * stale terms into a newer-stamped file, and crediting it reports the
-   * table migrated with those terms still in place. Leave unset unless the
-   * table's whole history is known.
-   */
-  trustWriterAnalysis?: boolean
 }
 /** What a `reindex` did. */
 export interface ReindexReport {
@@ -183,12 +174,7 @@ export interface VectorFilter {
 }
 /** Per-column FTS options for `IndexSpec.fts`. */
 export interface FtsOptions {
-  /**
-   * Tokenizer: `"standard"` (the default — the Unicode-aware UAX #29
-   * tokenizer that keeps non-ASCII text) or `"ascii_lower"` (ASCII
-   * split + lowercase, non-ASCII dropped). It is recorded with the
-   * table and cannot be changed afterwards.
-   */
+  /** Base tokenizer: `"standard"`, the default, is the only one. */
   analyzer?: string
   /**
    * Remove this column's stopwords — the very common words whose
@@ -272,8 +258,8 @@ export declare class IndexSpec {
   constructor()
   /**
    * Mark `column` (a UTF-8 string column) as full-text indexed, with
-   * optional per-column `options` (analyzer, stopwords, stemmer,
-   * positions, stored, k1/b).
+   * optional per-column `options` (stopwords, stemmer, positions,
+   * stored, k1/b).
    */
   fts(column: string, options?: FtsOptions | undefined | null): IndexSpec
   /**
@@ -376,7 +362,7 @@ export declare class Table {
    * to keep belongs on the column (`IndexSpec.fts`), where the
    * bounds are built with it and the correction disappears.
    */
-  bm25Search(column: string, query: string, k: number, mode?: string | undefined | null, stats?: string | undefined | null, projection?: Array<string> | undefined | null, k1?: number | undefined | null, b?: number | undefined | null): Buffer
+  bm25Search(column: string, query: string, k: number, mode?: string | undefined | null, projection?: Array<string> | undefined | null, k1?: number | undefined | null, b?: number | undefined | null): Buffer
   /**
    * Vector kNN over one vector column. `query` is a `Float32Array`
    * (crosses by reference — no copy). Returns matching rows as an Arrow

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infino-ai/infino",
-  "version": "0.9.3",
+  "version": "0.11.0",
   "description": "Fast search on object storage — SQL, full-text, and vector search.",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -82,12 +82,12 @@
     "apache-arrow": "^17"
   },
   "optionalDependencies": {
-    "infx-darwin-x64": "0.9.3",
-    "infx-darwin-arm64": "0.9.3",
-    "infx-linux-x64-gnu": "0.9.3",
-    "infx-linux-arm64-gnu": "0.9.3",
-    "infx-linux-x64-musl": "0.9.3",
-    "infx-linux-arm64-musl": "0.9.3"
+    "infx-darwin-x64": "0.11.0",
+    "infx-darwin-arm64": "0.11.0",
+    "infx-linux-x64-gnu": "0.11.0",
+    "infx-linux-arm64-gnu": "0.11.0",
+    "infx-linux-x64-musl": "0.11.0",
+    "infx-linux-arm64-musl": "0.11.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.0",