@infino-ai/infino 0.7.0 → 0.8.0

package/infino/index.d.ts

@@ -7,8 +7,8 @@ export declare const BUILDER_ID: string;
 export type Metric = "cosine" | "l2sq" | "negdot";
 /** Boolean mode for multi-term FTS queries. */
 export type BoolMode = "or" | "and";
-/** BM25 statistics scope: per-superfile IDF (default) or corpus-wide
- * `"global"` IDF across superfiles. */
+/** 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>;
@@ -97,7 +97,7 @@ export interface OptimizeOptions {
 }
 export interface Bm25SearchOptions {
     mode?: BoolMode;
-    /** BM25 statistics scope: `"per_superfile"` (default) or `"global"`. */
+    /** BM25 statistics scope: `"global"` (default) or `"per_superfile"`. */
     stats?: Bm25Stats;
     /** Columns to return, e.g. `["_id", "score"]`; omit for full rows. */
     projection?: string[];

package/infino/native.d.ts

@@ -106,6 +106,18 @@ export interface FtsOptions {
    * batches still carry it).
    */
   stored?: boolean
+  /**
+   * BM25 term-frequency saturation, `> 0`; defaults to 1.2. Recorded
+   * with the table, and the stored score bounds are built with it,
+   * so a search that does not override it pays nothing. Pass with
+   * `b` or not at all.
+   */
+  k1?: number
+  /**
+   * BM25 length normalization, in `[0, 1]`; defaults to 0.75. Pass
+   * with `k1` or not at all.
+   */
+  b?: number
 }
 /**
  * Open (or create) a catalog rooted at `uri` (local dir, `memory://`, or
@@ -129,7 +141,7 @@ export declare class IndexSpec {
   constructor()
   /**
    * Mark `column` (a UTF-8 string column) as full-text indexed,
-   * with optional per-column `options` (analyzer, stored).
+   * with optional per-column `options` (analyzer, stored, k1/b).
    */
   fts(column: string, options?: FtsOptions | undefined | null): IndexSpec
   /**
@@ -188,8 +200,16 @@ export declare class Table {
    * `["_id", "score"]` for just id + score, or omit for full rows.
    * `score` is a similarity (higher is better) — opposite direction
    * from `vectorSearch`'s distance. Fuse with `hybridSearch`.
+   *
+   * `k1` / `b` override the columns' declared BM25 similarity
+   * parameters for this search only — pass both or neither. The
+   * stored score bounds belong to the declared pair, so the reader
+   * corrects them for the difference: results stay exact and only
+   * pruning power is traded, and nothing is rebuilt. A pair you mean
+   * 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): Buffer
+  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
   /**
    * 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.7.0",
+  "version": "0.8.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.7.0",
-    "infx-darwin-arm64": "0.7.0",
-    "infx-linux-x64-gnu": "0.7.0",
-    "infx-linux-arm64-gnu": "0.7.0",
-    "infx-linux-x64-musl": "0.7.0",
-    "infx-linux-arm64-musl": "0.7.0"
+    "infx-darwin-x64": "0.8.0",
+    "infx-darwin-arm64": "0.8.0",
+    "infx-linux-x64-gnu": "0.8.0",
+    "infx-linux-arm64-gnu": "0.8.0",
+    "infx-linux-x64-musl": "0.8.0",
+    "infx-linux-arm64-musl": "0.8.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^2.18.0",