chromadb 3.2.0 → 3.2.2

package/dist/cjs/chromadb.d.cts

@@ -86,6 +86,12 @@ type HnswIndexConfig = {
     sync_threshold?: number | null;
 };
 type Include = 'distances' | 'documents' | 'embeddings' | 'metadatas' | 'uris';
+type IndexStatusResponse = {
+    num_indexed_ops: number;
+    num_unindexed_ops: number;
+    op_indexing_progress: number;
+    total_ops: number;
+};
 type IntInvertedIndexConfig$1 = {
     [key: string]: never;
 };
@@ -366,6 +372,19 @@ type VectorIndexType$1 = {
  * User identity information including tenant and database access.
  */
 type UserIdentity = GetUserIdentityResponse;
+/**
+ * Read level controls whether queries read from the write-ahead log (WAL).
+ *
+ * - INDEX_AND_WAL: Read from both the compacted index and the WAL.
+ *   All committed writes will be visible. This is the default.
+ * - INDEX_ONLY: Read only from the compacted index, skipping the WAL.
+ *   Recent writes that haven't been compacted may not be visible, but queries are faster.
+ */
+declare const ReadLevel: {
+    readonly INDEX_AND_WAL: "index_and_wal";
+    readonly INDEX_ONLY: "index_only";
+};
+type ReadLevel = (typeof ReadLevel)[keyof typeof ReadLevel];
 
 /**
  * Metadata that can be associated with a collection.
@@ -567,6 +586,10 @@ declare class QueryResult<TMeta extends Metadata = Metadata> {
      */
     rows(): QueryRowResult<TMeta>[][];
 }
+/**
+ * Re-export IndexStatusResponse type for external use
+ */
+type IndexingStatus = IndexStatusResponse;
 
 /**
  * Supported vector space types.
@@ -842,7 +865,7 @@ interface RrfOptions {
     weights?: number[];
     normalize?: boolean;
 }
-declare const Rrf: ({ ranks, k, weights, normalize }: RrfOptions) => RankExpression;
+declare const Rrf: ({ ranks, k, weights, normalize, }: RrfOptions) => RankExpression;
 declare const Sum: (...inputs: RankInput[]) => RankExpression;
 declare const Sub: (left: RankInput, right: RankInput) => RankExpression;
 declare const Mul: (...inputs: RankInput[]) => RankExpression;
@@ -1642,7 +1665,19 @@ interface Collection {
      * @param searches - Single search payload or array of payloads
      * @returns Promise resolving to column-major search results
      */
-    search(searches: SearchLike | SearchLike[]): Promise<SearchResult>;
+    search(searches: SearchLike | SearchLike[], options?: {
+        /**
+         * Controls whether to read from the write-ahead log.
+         * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
+         * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+         */
+        readLevel?: ReadLevel;
+    }): Promise<SearchResult>;
+    /**
+     * Gets the indexing status of the collection.
+     * @returns Promise resolving to indexing status information
+     */
+    getIndexingStatus(): Promise<IndexingStatus>;
 }
 
 declare function withChroma(userNextConfig?: any): any;
@@ -1862,4 +1897,4 @@ declare class ChromaRateLimitError extends Error {
 }
 declare function createErrorByType(type: string, message: string): InvalidCollectionError | InvalidArgumentError | undefined;
 
-export { Abs, AdminClient, type AdminClientArgs, AdminCloudClient, Aggregate, type AggregateInput, type AggregateJSON, type AnyEmbeddingFunction, type BaseRecordSet, BoolInvertedIndexConfig, BoolInvertedIndexType, BoolValueType, ChromaClient, type ChromaClientArgs, ChromaClientError, ChromaConnectionError, ChromaError, ChromaForbiddenError, ChromaNotFoundError, ChromaQuotaExceededError, ChromaRateLimitError, ChromaServerError, ChromaUnauthorizedError, ChromaUniqueError, ChromaValueError, CloudClient, Cmek, CmekProvider, type Collection, type CollectionConfiguration, type CollectionMetadata, type CreateCollectionConfiguration, DOCUMENT_KEY, Div, EMBEDDING_KEY, type EmbeddingFunction, type EmbeddingFunctionClass, type EmbeddingFunctionSpace, Exp, FloatInvertedIndexConfig, FloatInvertedIndexType, FloatListValueType, FloatValueType, FtsIndexConfig, FtsIndexType, GetResult, GroupBy, type GroupByInput, type GroupByJSON, type HNSWConfiguration, IncludeEnum, type IndexConfig, IntInvertedIndexConfig, IntInvertedIndexType, IntValueType, InvalidArgumentError, InvalidCollectionError, K, Key, type KeyFactory, Knn, type KnnOptions, Limit, type LimitInput, type LimitOptions, type ListDatabasesArgs, Log, Max, MaxK, type Metadata, Min, MinK, Mul, type PreparedInsertRecordSet, type PreparedRecordSet, type QueryRecordSet, QueryResult, type QueryRowResult, RankExpression, type RankInput, type RankLiteral, type RecordSet, Rrf, type RrfOptions, Schema, Search, type SearchInit, type SearchLike, SearchResult, type SearchResultRow, Select, type SelectInput, type SelectKeyInput, type SparseEmbeddingFunction, type SparseEmbeddingFunctionClass, type SparseVector, SparseVectorIndexConfig, type SparseVectorIndexConfigOptions, SparseVectorIndexType, SparseVectorValueType, StringInvertedIndexConfig, StringInvertedIndexType, StringValueType, Sub, Sum, type UpdateCollectionConfiguration, type UpdateHNSWConfiguration, type UpdateSPANNConfiguration, type UserIdentity, Val, ValueTypes, VectorIndexConfig, type VectorIndexConfigOptions, VectorIndexType, type Where, type WhereDocument, WhereExpression, type WhereInput, type WhereJSON, baseRecordSetFields, createErrorByType, getDefaultEFConfig, getEmbeddingFunction, getSparseEmbeddingFunction, knownEmbeddingFunctions, knownSparseEmbeddingFunctions, processCreateCollectionConfig, processUpdateCollectionConfig, recordSetFields, registerEmbeddingFunction, registerSparseEmbeddingFunction, serializeEmbeddingFunction, toSearch, withChroma };
+export { Abs, AdminClient, type AdminClientArgs, AdminCloudClient, Aggregate, type AggregateInput, type AggregateJSON, type AnyEmbeddingFunction, type BaseRecordSet, BoolInvertedIndexConfig, BoolInvertedIndexType, BoolValueType, ChromaClient, type ChromaClientArgs, ChromaClientError, ChromaConnectionError, ChromaError, ChromaForbiddenError, ChromaNotFoundError, ChromaQuotaExceededError, ChromaRateLimitError, ChromaServerError, ChromaUnauthorizedError, ChromaUniqueError, ChromaValueError, CloudClient, Cmek, CmekProvider, type Collection, type CollectionConfiguration, type CollectionMetadata, type CreateCollectionConfiguration, DOCUMENT_KEY, Div, EMBEDDING_KEY, type EmbeddingFunction, type EmbeddingFunctionClass, type EmbeddingFunctionSpace, Exp, FloatInvertedIndexConfig, FloatInvertedIndexType, FloatListValueType, FloatValueType, FtsIndexConfig, FtsIndexType, GetResult, GroupBy, type GroupByInput, type GroupByJSON, type HNSWConfiguration, IncludeEnum, type IndexConfig, type IndexingStatus, IntInvertedIndexConfig, IntInvertedIndexType, IntValueType, InvalidArgumentError, InvalidCollectionError, K, Key, type KeyFactory, Knn, type KnnOptions, Limit, type LimitInput, type LimitOptions, type ListDatabasesArgs, Log, Max, MaxK, type Metadata, Min, MinK, Mul, type PreparedInsertRecordSet, type PreparedRecordSet, type QueryRecordSet, QueryResult, type QueryRowResult, RankExpression, type RankInput, type RankLiteral, ReadLevel, type RecordSet, Rrf, type RrfOptions, Schema, Search, type SearchInit, type SearchLike, SearchResult, type SearchResultRow, Select, type SelectInput, type SelectKeyInput, type SparseEmbeddingFunction, type SparseEmbeddingFunctionClass, type SparseVector, SparseVectorIndexConfig, type SparseVectorIndexConfigOptions, SparseVectorIndexType, SparseVectorValueType, StringInvertedIndexConfig, StringInvertedIndexType, StringValueType, Sub, Sum, type UpdateCollectionConfiguration, type UpdateHNSWConfiguration, type UpdateSPANNConfiguration, type UserIdentity, Val, ValueTypes, VectorIndexConfig, type VectorIndexConfigOptions, VectorIndexType, type Where, type WhereDocument, WhereExpression, type WhereInput, type WhereJSON, baseRecordSetFields, createErrorByType, getDefaultEFConfig, getEmbeddingFunction, getSparseEmbeddingFunction, knownEmbeddingFunctions, knownSparseEmbeddingFunctions, processCreateCollectionConfig, processUpdateCollectionConfig, recordSetFields, registerEmbeddingFunction, registerSparseEmbeddingFunction, serializeEmbeddingFunction, toSearch, withChroma };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromadb",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "A JavaScript interface for chroma",
   "keywords": [
     "chroma",
@@ -60,11 +60,11 @@
     "@chroma-core/default-embed": "^0.1.9"
   },
   "optionalDependencies": {
-    "chromadb-js-bindings-darwin-arm64": "^1.2.0",
-    "chromadb-js-bindings-darwin-x64": "^1.2.0",
-    "chromadb-js-bindings-linux-arm64-gnu": "^1.2.0",
-    "chromadb-js-bindings-linux-x64-gnu": "^1.2.0",
-    "chromadb-js-bindings-win32-x64-msvc": "^1.2.0"
+    "chromadb-js-bindings-darwin-arm64": "^1.2.1",
+    "chromadb-js-bindings-darwin-x64": "^1.2.1",
+    "chromadb-js-bindings-linux-arm64-gnu": "^1.2.1",
+    "chromadb-js-bindings-linux-x64-gnu": "^1.2.1",
+    "chromadb-js-bindings-win32-x64-msvc": "^1.2.1"
   },
   "engines": {
     "node": ">=20"

package/src/api/sdk.gen.ts

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { GetUserIdentityData, GetUserIdentityResponse2, GetUserIdentityError, GetCollectionByCrnData, GetCollectionByCrnResponse, GetCollectionByCrnError, HealthcheckData, HealthcheckResponse, HealthcheckError, HeartbeatData, HeartbeatResponse2, HeartbeatError, PreFlightChecksData, PreFlightChecksResponse, PreFlightChecksError, ResetData, ResetResponse, ResetError, CreateTenantData, CreateTenantResponse2, CreateTenantError, GetTenantData, GetTenantResponse2, GetTenantError, UpdateTenantData, UpdateTenantResponse2, UpdateTenantError, ListDatabasesData, ListDatabasesResponse, ListDatabasesError, CreateDatabaseData, CreateDatabaseResponse2, CreateDatabaseError, DeleteDatabaseData, DeleteDatabaseResponse2, DeleteDatabaseError, GetDatabaseData, GetDatabaseResponse, GetDatabaseError, ListCollectionsData, ListCollectionsResponse, ListCollectionsError, CreateCollectionData, CreateCollectionResponse, CreateCollectionError, DeleteCollectionData, DeleteCollectionResponse, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, AttachFunctionData, AttachFunctionResponse2, AttachFunctionError, GetAttachedFunctionData, GetAttachedFunctionResponse2, GetAttachedFunctionError, CollectionGetData, CollectionGetResponse, CollectionGetError, CollectionQueryData, CollectionQueryResponse, CollectionQueryError, CollectionSearchData, CollectionSearchResponse, CollectionSearchError, CollectionUpdateData, CollectionUpdateResponse, CollectionUpsertData, CollectionUpsertResponse, CollectionUpsertError, CountCollectionsData, CountCollectionsResponse, CountCollectionsError, VersionData, VersionResponse } from './types.gen';
+import type { GetUserIdentityData, GetUserIdentityResponse2, GetUserIdentityError, GetCollectionByCrnData, GetCollectionByCrnResponse, GetCollectionByCrnError, HealthcheckData, HealthcheckResponse, HealthcheckError, HeartbeatData, HeartbeatResponse2, HeartbeatError, PreFlightChecksData, PreFlightChecksResponse, PreFlightChecksError, ResetData, ResetResponse, ResetError, CreateTenantData, CreateTenantResponse2, CreateTenantError, GetTenantData, GetTenantResponse2, GetTenantError, UpdateTenantData, UpdateTenantResponse2, UpdateTenantError, ListDatabasesData, ListDatabasesResponse, ListDatabasesError, CreateDatabaseData, CreateDatabaseResponse2, CreateDatabaseError, DeleteDatabaseData, DeleteDatabaseResponse2, DeleteDatabaseError, GetDatabaseData, GetDatabaseResponse, GetDatabaseError, ListCollectionsData, ListCollectionsResponse, ListCollectionsError, CreateCollectionData, CreateCollectionResponse, CreateCollectionError, DeleteCollectionData, DeleteCollectionResponse, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, AttachFunctionData, AttachFunctionResponse2, AttachFunctionError, GetAttachedFunctionData, GetAttachedFunctionResponse2, GetAttachedFunctionError, CollectionGetData, CollectionGetResponse, CollectionGetError, IndexingStatusData, IndexingStatusResponse, IndexingStatusError, CollectionQueryData, CollectionQueryResponse, CollectionQueryError, CollectionSearchData, CollectionSearchResponse, CollectionSearchError, CollectionUpdateData, CollectionUpdateResponse, CollectionUpsertData, CollectionUpsertResponse, CollectionUpsertError, CountCollectionsData, CountCollectionsResponse, CountCollectionsError, VersionData, VersionResponse } from './types.gen';
 import { client as _heyApiClient } from './client.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
@@ -323,6 +323,16 @@ export class DefaultService {
         });
     }
     
+    /**
+     * Retrieves the indexing status of a collection.
+     */
+    public static indexingStatus<ThrowOnError extends boolean = true>(options: Options<IndexingStatusData, ThrowOnError>) {
+        return (options.client ?? _heyApiClient).get<IndexingStatusResponse, IndexingStatusError, ThrowOnError>({
+            url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/indexing_status',
+            ...options
+        });
+    }
+    
     /**
      * Query a collection in a variety of ways, including vector search, metadata filtering, and full-text search
      */

package/src/api/types.gen.ts

@@ -304,6 +304,13 @@ export type Include = 'distances' | 'documents' | 'embeddings' | 'metadatas' | '
 
 export type IncludeList = Array<Include>;
 
+export type IndexStatusResponse = {
+    num_indexed_ops: number;
+    num_unindexed_ops: number;
+    op_indexing_progress: number;
+    total_ops: number;
+};
+
 export type IntInvertedIndexConfig = {
     [key: string]: never;
 };
@@ -412,6 +419,8 @@ export type RawWhereFields = {
     where_document?: unknown;
 };
 
+export type ReadLevel = 'index_and_wal' | 'index_only';
+
 /**
  * Schema representation for collection index configurations
  *
@@ -467,6 +476,11 @@ export type SearchPayload = {
 };
 
 export type SearchRequestPayload = {
+    /**
+     * Specifies the read level for consistency vs performance tradeoffs.
+     * Defaults to IndexAndWal (full consistency).
+     */
+    read_level?: ReadLevel;
     searches: Array<SearchPayload>;
 };
 
@@ -1696,6 +1710,52 @@ export type CollectionGetResponses = {
 
 export type CollectionGetResponse = CollectionGetResponses[keyof CollectionGetResponses];
 
+export type IndexingStatusData = {
+    body?: never;
+    path: {
+        /**
+         * Tenant ID
+         */
+        tenant: string;
+        /**
+         * Database name for the collection
+         */
+        database: string;
+        /**
+         * Collection ID to get index status for
+         */
+        collection_id: string;
+    };
+    query?: never;
+    url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/indexing_status';
+};
+
+export type IndexingStatusErrors = {
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Collection not found
+     */
+    404: ErrorResponse;
+    /**
+     * Server error
+     */
+    500: ErrorResponse;
+};
+
+export type IndexingStatusError = IndexingStatusErrors[keyof IndexingStatusErrors];
+
+export type IndexingStatusResponses = {
+    /**
+     * Index status retrieved successfully
+     */
+    200: IndexStatusResponse;
+};
+
+export type IndexingStatusResponse = IndexingStatusResponses[keyof IndexingStatusResponses];
+
 export type CollectionQueryData = {
     body: QueryRequestPayload;
     path: {

package/src/chroma-fetch.ts

@@ -14,16 +14,18 @@ import {
 const offlineError = (error: any): boolean => {
   return Boolean(
     (error?.name === "TypeError" || error?.name === "FetchError") &&
-    (error.message?.includes("fetch failed") ||
-      error.message?.includes("Failed to fetch") ||
-      error.message?.includes("ENOTFOUND")),
+      (error.message?.includes("fetch failed") ||
+        error.message?.includes("Failed to fetch") ||
+        error.message?.includes("ENOTFOUND")),
   );
 };
 
 const getErrorMessage = async (response: Response): Promise<string> => {
   try {
     const body = await response.clone().json();
-    return body.message || body.error || `${response.status}: ${response.statusText}`;
+    return (
+      body.message || body.error || `${response.status}: ${response.statusText}`
+    );
   } catch {
     return `${response.status}: ${response.statusText}`;
   }
@@ -52,9 +54,10 @@ export const chromaFetch: typeof fetch = async (input, init) => {
       try {
         const responseBody = await response.json();
         status = responseBody.message || status;
-      } catch { }
+      } catch {}
       throw new ChromaClientError(
-        `Bad request to ${(input as Request).url || "Chroma"
+        `Bad request to ${
+          (input as Request).url || "Chroma"
         } with status: ${status}`,
       );
     case 401:
@@ -82,10 +85,15 @@ export const chromaFetch: typeof fetch = async (input, init) => {
         }
         throw new ChromaClientError(body?.message || "Unprocessable Entity");
       } catch (error) {
-        if (error instanceof ChromaQuotaExceededError || error instanceof ChromaClientError) {
+        if (
+          error instanceof ChromaQuotaExceededError ||
+          error instanceof ChromaClientError
+        ) {
           throw error;
         }
-        throw new ChromaClientError(`Unprocessable Entity: ${response.statusText}`);
+        throw new ChromaClientError(
+          `Unprocessable Entity: ${response.statusText}`,
+        );
       }
     case 429:
       throw new ChromaRateLimitError("Rate limit exceeded");

package/src/collection-configuration.ts

@@ -126,8 +126,11 @@ export const processCreateCollectionConfig = async ({
         !supportedSpaces.includes(configuration.hnsw.space)
       ) {
         console.warn(
-          `Space '${configuration.hnsw.space}' is not supported by embedding function '${overallEf.name || "unknown"}'. ` +
-            `Supported spaces: ${supportedSpaces.join(", ")}`,
+          `Space '${
+            configuration.hnsw.space
+          }' is not supported by embedding function '${
+            overallEf.name || "unknown"
+          }'. ` + `Supported spaces: ${supportedSpaces.join(", ")}`,
         );
       }
 
@@ -136,8 +139,11 @@ export const processCreateCollectionConfig = async ({
         !supportedSpaces.includes(configuration.spann.space)
       ) {
         console.warn(
-          `Space '${configuration.spann.space}' is not supported by embedding function '${overallEf.name || "unknown"}'. ` +
-            `Supported spaces: ${supportedSpaces.join(", ")}`,
+          `Space '${
+            configuration.spann.space
+          }' is not supported by embedding function '${
+            overallEf.name || "unknown"
+          }'. ` + `Supported spaces: ${supportedSpaces.join(", ")}`,
         );
       }
 
@@ -151,8 +157,11 @@ export const processCreateCollectionConfig = async ({
         )
       ) {
         console.warn(
-          `Space '${metadata["hnsw:space"]}' from metadata is not supported by embedding function '${overallEf.name || "unknown"}'. ` +
-            `Supported spaces: ${supportedSpaces.join(", ")}`,
+          `Space '${
+            metadata["hnsw:space"]
+          }' from metadata is not supported by embedding function '${
+            overallEf.name || "unknown"
+          }'. ` + `Supported spaces: ${supportedSpaces.join(", ")}`,
         );
       }
     }

package/src/collection.ts

@@ -7,11 +7,13 @@ import {
   BaseRecordSet,
   CollectionMetadata,
   GetResult,
+  IndexingStatus,
   Metadata,
   PreparedRecordSet,
   PreparedInsertRecordSet,
   QueryRecordSet,
   QueryResult,
+  ReadLevel,
   RecordSet,
   Where,
   WhereDocument,
@@ -203,7 +205,22 @@ export interface Collection {
    * @param searches - Single search payload or array of payloads
    * @returns Promise resolving to column-major search results
    */
-  search(searches: SearchLike | SearchLike[]): Promise<SearchResult>;
+  search(
+    searches: SearchLike | SearchLike[],
+    options?: {
+      /**
+       * Controls whether to read from the write-ahead log.
+       * - ReadLevel.INDEX_AND_WAL: Read from both index and WAL (default)
+       * - ReadLevel.INDEX_ONLY: Read only from index, faster but recent writes may not be visible
+       */
+      readLevel?: ReadLevel;
+    },
+  ): Promise<SearchResult>;
+  /**
+   * Gets the indexing status of the collection.
+   * @returns Promise resolving to indexing status information
+   */
+  getIndexingStatus(): Promise<IndexingStatus>;
 }
 
 /**
@@ -887,6 +904,9 @@ export class CollectionImpl implements Collection {
 
   public async search(
     searches: SearchLike | SearchLike[],
+    options?: {
+      readLevel?: ReadLevel;
+    },
   ): Promise<SearchResult> {
     const items = Array.isArray(searches) ? searches : [searches];
 
@@ -906,7 +926,10 @@ export class CollectionImpl implements Collection {
     const { data } = await Api.collectionSearch({
       client: this.apiClient,
       path: await this.path(),
-      body: { searches: payloads },
+      body: {
+        searches: payloads,
+        read_level: options?.readLevel,
+      },
     });
 
     return new SearchResult(data);
@@ -1079,4 +1102,13 @@ export class CollectionImpl implements Collection {
       },
     });
   }
+
+  public async getIndexingStatus(): Promise<IndexingStatus> {
+    const { data } = await Api.indexingStatus({
+      client: this.apiClient,
+      path: await this.path(),
+    });
+
+    return data;
+  }
 }

package/src/execution/expression/common.ts

@@ -1,6 +1,8 @@
 export type IterableInput<T> = Iterable<T> | ArrayLike<T>;
 
-export const isPlainObject = (value: unknown): value is Record<string, unknown> => {
+export const isPlainObject = (
+  value: unknown,
+): value is Record<string, unknown> => {
   if (typeof value !== "object" || value === null) {
     return false;
   }

package/src/execution/expression/groupBy.ts

@@ -59,10 +59,7 @@ export abstract class Aggregate {
 }
 
 export class MinK extends Aggregate {
-  constructor(
-    public readonly keys: Key[],
-    public readonly k: number,
-  ) {
+  constructor(public readonly keys: Key[], public readonly k: number) {
     super();
     if (keys.length === 0) {
       throw new Error("MinK keys cannot be empty");
@@ -83,10 +80,7 @@ export class MinK extends Aggregate {
 }
 
 export class MaxK extends Aggregate {
-  constructor(
-    public readonly keys: Key[],
-    public readonly k: number,
-  ) {
+  constructor(public readonly keys: Key[], public readonly k: number) {
     super();
     if (keys.length === 0) {
       throw new Error("MaxK keys cannot be empty");
@@ -143,7 +137,9 @@ export class GroupBy {
         Aggregate.from(data.aggregate),
       );
     }
-    throw new TypeError("GroupBy input must be a GroupBy instance or plain object");
+    throw new TypeError(
+      "GroupBy input must be a GroupBy instance or plain object",
+    );
   }
 
   public toJSON(): GroupByJSON {

package/src/execution/expression/rank.ts

@@ -3,10 +3,19 @@ import { deepClone, isPlainObject, IterableInput } from "./common";
 import { Key } from "./key";
 
 export type RankLiteral = Record<string, unknown>;
-export type RankInput = RankExpression | RankLiteral | number | null | undefined;
+export type RankInput =
+  | RankExpression
+  | RankLiteral
+  | number
+  | null
+  | undefined;
 
 const requireNumber = (value: unknown, message: string): number => {
-  if (typeof value !== "number" || Number.isNaN(value) || !Number.isFinite(value)) {
+  if (
+    typeof value !== "number" ||
+    Number.isNaN(value) ||
+    !Number.isFinite(value)
+  ) {
     throw new TypeError(message);
   }
   return value;
@@ -39,7 +48,9 @@ abstract class RankExpressionBase {
     }
     const expressions = [
       this as unknown as RankExpression,
-      ...others.map((item, index) => requireRank(item, `multiply operand ${index}`)),
+      ...others.map((item, index) =>
+        requireRank(item, `multiply operand ${index}`),
+      ),
     ];
     return MulRankExpression.create(expressions);
   }
@@ -104,7 +115,9 @@ export abstract class RankExpression extends RankExpressionBase {
     if (isPlainObject(input)) {
       return new RawRankExpression(input);
     }
-    throw new TypeError("Rank input must be a RankExpression, number, or plain object");
+    throw new TypeError(
+      "Rank input must be a RankExpression, number, or plain object",
+    );
   }
 }
 
@@ -355,7 +368,11 @@ const normalizeDenseVector = (vector: IterableInput<number>): number[] => {
     return vector.slice();
   }
   return Array.from(vector as Iterable<number>, (value) => {
-    if (typeof value !== "number" || Number.isNaN(value) || !Number.isFinite(value)) {
+    if (
+      typeof value !== "number" ||
+      Number.isNaN(value) ||
+      !Number.isFinite(value)
+    ) {
       throw new TypeError("Dense query vector values must be finite numbers");
     }
     return value;
@@ -387,7 +404,8 @@ const normalizeKnnOptions = (options: KnnOptions): KnnOptionsNormalized => {
     query = normalizeDenseVector(queryInput as IterableInput<number>);
   }
 
-  const key = options.key instanceof Key ? options.key.name : options.key ?? "#embedding";
+  const key =
+    options.key instanceof Key ? options.key.name : options.key ?? "#embedding";
   if (typeof key !== "string") {
     throw new TypeError("Knn key must be a string or Key instance");
   }
@@ -402,7 +420,10 @@ const normalizeKnnOptions = (options: KnnOptions): KnnOptionsNormalized => {
   }
 
   return {
-    query: Array.isArray(query) || typeof query === "string" ? query : deepClone(query),
+    query:
+      Array.isArray(query) || typeof query === "string"
+        ? query
+        : deepClone(query),
     key,
     limit,
     defaultValue,
@@ -431,7 +452,12 @@ export interface RrfOptions {
   normalize?: boolean;
 }
 
-export const Rrf = ({ ranks, k = 60, weights, normalize = false }: RrfOptions): RankExpression => {
+export const Rrf = ({
+  ranks,
+  k = 60,
+  weights,
+  normalize = false,
+}: RrfOptions): RankExpression => {
   if (!Number.isInteger(k) || k <= 0) {
     throw new TypeError("Rrf k must be a positive integer");
   }
@@ -439,9 +465,13 @@ export const Rrf = ({ ranks, k = 60, weights, normalize = false }: RrfOptions):
     throw new TypeError("Rrf requires at least one rank expression");
   }
 
-  const expressions = ranks.map((rank, index) => requireRank(rank, `ranks[${index}]`));
+  const expressions = ranks.map((rank, index) =>
+    requireRank(rank, `ranks[${index}]`),
+  );
 
-  let weightValues = weights ? weights.slice() : new Array(expressions.length).fill(1);
+  let weightValues = weights
+    ? weights.slice()
+    : new Array(expressions.length).fill(1);
   if (weightValues.length !== expressions.length) {
     throw new Error("Number of weights must match number of ranks");
   }
@@ -452,7 +482,9 @@ export const Rrf = ({ ranks, k = 60, weights, normalize = false }: RrfOptions):
   if (normalize) {
     const total = weightValues.reduce((sum, value) => sum + value, 0);
     if (total <= 0) {
-      throw new Error("Weights must sum to a positive value when normalize=true");
+      throw new Error(
+        "Weights must sum to a positive value when normalize=true",
+      );
     }
     weightValues = weightValues.map((value) => value / total);
   }
@@ -472,35 +504,50 @@ export const Sum = (...inputs: RankInput[]): RankExpression => {
   if (inputs.length === 0) {
     throw new Error("Sum requires at least one rank expression");
   }
-  const expressions = inputs.map((rank, index) => requireRank(rank, `Sum operand ${index}`));
+  const expressions = inputs.map((rank, index) =>
+    requireRank(rank, `Sum operand ${index}`),
+  );
   return SumRankExpression.create(expressions);
 };
 
 export const Sub = (left: RankInput, right: RankInput): RankExpression =>
-  new SubRankExpression(requireRank(left, "Sub left"), requireRank(right, "Sub right"));
+  new SubRankExpression(
+    requireRank(left, "Sub left"),
+    requireRank(right, "Sub right"),
+  );
 
 export const Mul = (...inputs: RankInput[]): RankExpression => {
   if (inputs.length === 0) {
     throw new Error("Mul requires at least one rank expression");
   }
-  const expressions = inputs.map((rank, index) => requireRank(rank, `Mul operand ${index}`));
+  const expressions = inputs.map((rank, index) =>
+    requireRank(rank, `Mul operand ${index}`),
+  );
   return MulRankExpression.create(expressions);
 };
 
 export const Div = (left: RankInput, right: RankInput): RankExpression =>
-  new DivRankExpression(requireRank(left, "Div left"), requireRank(right, "Div right"));
+  new DivRankExpression(
+    requireRank(left, "Div left"),
+    requireRank(right, "Div right"),
+  );
 
-export const Abs = (input: RankInput): RankExpression => requireRank(input, "Abs").abs();
+export const Abs = (input: RankInput): RankExpression =>
+  requireRank(input, "Abs").abs();
 
-export const Exp = (input: RankInput): RankExpression => requireRank(input, "Exp").exp();
+export const Exp = (input: RankInput): RankExpression =>
+  requireRank(input, "Exp").exp();
 
-export const Log = (input: RankInput): RankExpression => requireRank(input, "Log").log();
+export const Log = (input: RankInput): RankExpression =>
+  requireRank(input, "Log").log();
 
 export const Max = (...inputs: RankInput[]): RankExpression => {
   if (inputs.length === 0) {
     throw new Error("Max requires at least one rank expression");
   }
-  const expressions = inputs.map((rank, index) => requireRank(rank, `Max operand ${index}`));
+  const expressions = inputs.map((rank, index) =>
+    requireRank(rank, `Max operand ${index}`),
+  );
   return MaxRankExpression.create(expressions);
 };
 
@@ -508,6 +555,8 @@ export const Min = (...inputs: RankInput[]): RankExpression => {
   if (inputs.length === 0) {
     throw new Error("Min requires at least one rank expression");
   }
-  const expressions = inputs.map((rank, index) => requireRank(rank, `Min operand ${index}`));
+  const expressions = inputs.map((rank, index) =>
+    requireRank(rank, `Min operand ${index}`),
+  );
   return MinRankExpression.create(expressions);
 };

package/src/execution/expression/searchResult.ts

@@ -20,7 +20,9 @@ const normalizePayloadArray = <T>(
   if (payload.length === count) {
     return payload.map((item) => (item ? item.slice() : null));
   }
-  const result: Array<T[] | null> = payload.map((item) => (item ? item.slice() : null));
+  const result: Array<T[] | null> = payload.map((item) =>
+    item ? item.slice() : null,
+  );
   while (result.length < count) {
     result.push(null);
   }
@@ -40,7 +42,10 @@ export class SearchResult {
     const payloadCount = this.ids.length;
     this.documents = normalizePayloadArray(response.documents, payloadCount);
     this.embeddings = normalizePayloadArray(response.embeddings, payloadCount);
-    const rawMetadatas = normalizePayloadArray(response.metadatas, payloadCount);
+    const rawMetadatas = normalizePayloadArray(
+      response.metadatas,
+      payloadCount,
+    );
     this.metadatas = rawMetadatas.map((payload) => {
       if (!payload) {
         return null;
@@ -54,7 +59,11 @@ export class SearchResult {
   public rows(): SearchResultRow[][] {
     const results: SearchResultRow[][] = [];
 
-    for (let payloadIndex = 0; payloadIndex < this.ids.length; payloadIndex += 1) {
+    for (
+      let payloadIndex = 0;
+      payloadIndex < this.ids.length;
+      payloadIndex += 1
+    ) {
       const ids = this.ids[payloadIndex];
       const docPayload = this.documents[payloadIndex] ?? [];
       const embedPayload = this.embeddings[payloadIndex] ?? [];