chromadb 3.4.3 → 3.5.0

package/dist/cjs/chromadb.d.cts

@@ -55,8 +55,21 @@ type FloatListValueType$1 = {
 type FloatValueType$1 = {
     float_inverted_index?: null | FloatInvertedIndexType$1;
 };
+/**
+ * Full-text search index algorithm.
+ *
+ * Controls which index format and query pipeline are used for
+ * document substring search within a collection.
+ */
+type FtsAlgorithm = 'trigram' | 'token_bitmap';
 type FtsIndexConfig$1 = {
-    [key: string]: never;
+    /**
+     * FTS index algorithm.
+     * Omitted from JSON when set to the default (Trigram) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: FtsAlgorithm;
 };
 type FtsIndexType$1 = {
     config: FtsIndexConfig$1;
@@ -209,10 +222,6 @@ type Schema$1 = {
     keys: {
         [key: string]: ValueTypes$1;
     };
-    /**
-     * ID of the attached function that created this output collection (if applicable)
-     */
-    source_attached_function_id?: string | null;
 };
 type SearchPayload = {
     filter?: {
@@ -284,6 +293,13 @@ type SpannIndexConfig = {
     write_rng_epsilon?: number | null;
     write_rng_factor?: number | null;
 };
+/**
+ * Sparse vector index algorithm.
+ *
+ * Controls which posting list format and query engine are used for
+ * sparse vector search within a collection.
+ */
+type SparseIndexAlgorithm = 'wand' | 'max_score';
 /**
  * Represents a sparse vector using parallel arrays for indices and values.
  *
@@ -307,6 +323,13 @@ type SparseVector = {
     values: Array<number>;
 };
 type SparseVectorIndexConfig$1 = {
+    /**
+     * Sparse index algorithm (cloud-only, tenant-gated).
+     * Omitted from JSON when set to the default (Wand) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: SparseIndexAlgorithm;
     /**
      * Whether this embedding is BM25
      */
@@ -396,10 +419,13 @@ type UserIdentity = GetUserIdentityResponse;
  *   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.
+ * - INDEX_AND_BOUNDED_WAL: Read from the index and up to a server-configured number of
+ *   WAL entries for bounded query latency.
  */
 declare const ReadLevel: {
     readonly INDEX_AND_WAL: "index_and_wal";
     readonly INDEX_ONLY: "index_only";
+    readonly INDEX_AND_BOUNDED_WAL: "index_and_bounded_wal";
 };
 type ReadLevel = (typeof ReadLevel)[keyof typeof ReadLevel];
 
@@ -1290,7 +1316,6 @@ declare class Schema {
     private setIndexForKey;
     private enableAllIndexesForKey;
     private disableAllIndexesForKey;
-    private validateSingleSparseVectorIndex;
     private validateSparseVectorConfig;
     private initializeDefaults;
     private initializeKeys;
@@ -1601,6 +1626,7 @@ interface Collection {
          * 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.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
          */
         readLevel?: ReadLevel;
     }): Promise<number>;
@@ -1754,6 +1780,7 @@ interface Collection {
          * 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.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
          */
         readLevel?: ReadLevel;
     }): Promise<SearchResult>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromadb",
-  "version": "3.4.3",
+  "version": "3.5.0",
   "description": "A JavaScript interface for chroma",
   "keywords": [
     "chroma",
@@ -30,10 +30,24 @@
     "src",
     "dist"
   ],
+  "scripts": {
+    "test": "jest --runInBand",
+    "test:functional": "jest --runInBand --testPathIgnorePatterns=test/auth.*.test.ts",
+    "test:update": "jest --runInBand --updateSnapshot",
+    "prebuild": "rimraf dist",
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "genapi": "node --loader ts-node/esm scripts/gen-api.ts",
+    "prettier": "prettier --write .",
+    "release": "run-s build test && npm publish",
+    "release_alpha": "run-s build test && npm publish --tag alpha",
+    "release_dev": "run-s build test && npm version ${NEW_VERSION} --no-git-tag-version && npm publish"
+  },
   "dependencies": {
     "semver": "^7.7.1"
   },
   "devDependencies": {
+    "@chroma-core/default-embed": "workspace:^",
     "@hey-api/client-fetch": "^0.10.0",
     "@hey-api/openapi-ts": "^0.67.3",
     "@jest/globals": "^29.7.0",
@@ -56,33 +70,19 @@
     "tsd": "^0.28.1",
     "tsup": "^8.3.5",
     "typescript": "^5.0.4",
-    "wait-on": "^8.0.3",
-    "@chroma-core/default-embed": "^0.1.9"
+    "wait-on": "^8.0.3"
   },
   "optionalDependencies": {
-    "chromadb-js-bindings-darwin-arm64": "^1.3.3",
-    "chromadb-js-bindings-darwin-x64": "^1.3.3",
-    "chromadb-js-bindings-linux-arm64-gnu": "^1.3.3",
-    "chromadb-js-bindings-linux-x64-gnu": "^1.3.3",
-    "chromadb-js-bindings-win32-x64-msvc": "^1.3.3"
+    "chromadb-js-bindings-darwin-arm64": "^1.3.4",
+    "chromadb-js-bindings-darwin-x64": "^1.3.4",
+    "chromadb-js-bindings-linux-arm64-gnu": "^1.3.4",
+    "chromadb-js-bindings-linux-x64-gnu": "^1.3.4",
+    "chromadb-js-bindings-win32-x64-msvc": "^1.3.4"
   },
   "engines": {
     "node": ">=20"
   },
   "bin": {
     "chroma": "dist/cli.mjs"
-  },
-  "scripts": {
-    "test": "jest --runInBand",
-    "test:functional": "jest --runInBand --testPathIgnorePatterns=test/auth.*.test.ts",
-    "test:update": "jest --runInBand --updateSnapshot",
-    "prebuild": "rimraf dist",
-    "build": "tsup",
-    "watch": "tsup --watch",
-    "genapi": "node --loader ts-node/esm scripts/gen-api.ts",
-    "prettier": "prettier --write .",
-    "release": "run-s build test && npm publish",
-    "release_alpha": "run-s build test && npm publish --tag alpha",
-    "release_dev": "run-s build test && npm version ${NEW_VERSION} --no-git-tag-version && npm publish"
   }
-}
+}

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, GetCollectionByIdData, GetCollectionByIdResponse, GetCollectionByIdError, DeleteCollectionData, DeleteCollectionResponse2, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, ForkCountData, ForkCountResponse2, ForkCountError, 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 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, GetCollectionByIdData, GetCollectionByIdResponse, GetCollectionByIdError, DeleteCollectionData, DeleteCollectionResponse2, DeleteCollectionError, GetCollectionData, GetCollectionResponse, GetCollectionError, UpdateCollectionData, UpdateCollectionResponse2, UpdateCollectionError, CollectionAddData, CollectionAddResponse, AddAttachedFunctionInputData, AddAttachedFunctionInputResponse2, AddAttachedFunctionInputError, DetachFunctionData, DetachFunctionResponse2, DetachFunctionError, CollectionCountData, CollectionCountResponse, CollectionCountError, CollectionDeleteData, CollectionDeleteResponse, CollectionDeleteError, ForkCollectionData, ForkCollectionResponse, ForkCollectionError, ForkCountData, ForkCountResponse2, ForkCountError, 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> & {
@@ -609,6 +609,27 @@ export class RecordService {
 }
 
 export class FunctionService {
+    /**
+     * Add attached function input
+     * Adds a new input collection to an existing async attached function.
+     */
+    public static addAttachedFunctionInput<ThrowOnError extends boolean = true>(options: Options<AddAttachedFunctionInputData, ThrowOnError>) {
+        return (options.client ?? _heyApiClient).post<AddAttachedFunctionInputResponse2, AddAttachedFunctionInputError, ThrowOnError>({
+            security: [
+                {
+                    name: 'x-chroma-token',
+                    type: 'apiKey'
+                }
+            ],
+            url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/attached_functions/{name}/add_input',
+            ...options,
+            headers: {
+                'Content-Type': 'application/json',
+                ...options?.headers
+            }
+        });
+    }
+    
     /**
      * Detach function
      * Detaches a function from a collection.

package/src/api/types.gen.ts

@@ -1,5 +1,14 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
+export type AddAttachedFunctionInputRequest = {
+    input_collection_id: CollectionUuid;
+};
+
+export type AddAttachedFunctionInputResponse = {
+    attached_function: AttachedFunctionApiResponse;
+    created: boolean;
+};
+
 /**
  * Payload for adding records to a collection.
  *
@@ -270,8 +279,22 @@ export type ForkCountResponse = {
     count: number;
 };
 
+/**
+ * Full-text search index algorithm.
+ *
+ * Controls which index format and query pipeline are used for
+ * document substring search within a collection.
+ */
+export type FtsAlgorithm = 'trigram' | 'token_bitmap';
+
 export type FtsIndexConfig = {
-    [key: string]: never;
+    /**
+     * FTS index algorithm.
+     * Omitted from JSON when set to the default (Trigram) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: FtsAlgorithm;
 };
 
 export type FtsIndexType = {
@@ -478,7 +501,7 @@ export type RawWhereFields = {
     where_document?: unknown;
 };
 
-export type ReadLevel = 'index_and_wal' | 'index_only';
+export type ReadLevel = 'index_and_wal' | 'index_only' | 'index_and_bounded_wal';
 
 /**
  * Schema representation for collection index configurations
@@ -503,10 +526,6 @@ export type Schema = {
     keys: {
         [key: string]: ValueTypes;
     };
-    /**
-     * ID of the attached function that created this output collection (if applicable)
-     */
-    source_attached_function_id?: string | null;
 };
 
 export type SearchPayload = {
@@ -592,6 +611,14 @@ export type SpannIndexConfig = {
     write_rng_factor?: number | null;
 };
 
+/**
+ * Sparse vector index algorithm.
+ *
+ * Controls which posting list format and query engine are used for
+ * sparse vector search within a collection.
+ */
+export type SparseIndexAlgorithm = 'wand' | 'max_score';
+
 /**
  * Represents a sparse vector using parallel arrays for indices and values.
  *
@@ -616,6 +643,13 @@ export type SparseVector = {
 };
 
 export type SparseVectorIndexConfig = {
+    /**
+     * Sparse index algorithm (cloud-only, tenant-gated).
+     * Omitted from JSON when set to the default (Wand) so that old
+     * servers/clients that do not know about this field can still
+     * deserialize the schema.
+     */
+    algorithm?: SparseIndexAlgorithm;
     /**
      * Whether this embedding is BM25
      */
@@ -1530,6 +1564,52 @@ export type CollectionAddResponses = {
 
 export type CollectionAddResponse = CollectionAddResponses[keyof CollectionAddResponses];
 
+export type AddAttachedFunctionInputData = {
+    body: AddAttachedFunctionInputRequest;
+    path: {
+        /**
+         * Tenant UUID
+         */
+        tenant: string;
+        /**
+         * Database name
+         */
+        database: string;
+        /**
+         * Collection UUID
+         */
+        collection_id: string;
+        /**
+         * Function name
+         */
+        name: string;
+    };
+    query?: never;
+    url: '/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/attached_functions/{name}/add_input';
+};
+
+export type AddAttachedFunctionInputErrors = {
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Server error
+     */
+    500: ErrorResponse;
+};
+
+export type AddAttachedFunctionInputError = AddAttachedFunctionInputErrors[keyof AddAttachedFunctionInputErrors];
+
+export type AddAttachedFunctionInputResponses = {
+    /**
+     * Attached function input added successfully
+     */
+    200: AddAttachedFunctionInputResponse;
+};
+
+export type AddAttachedFunctionInputResponse2 = AddAttachedFunctionInputResponses[keyof AddAttachedFunctionInputResponses];
+
 export type DetachFunctionData = {
     body: DetachFunctionRequest;
     path: {

package/src/collection.ts

@@ -80,6 +80,7 @@ export interface Collection {
      * 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.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
      */
     readLevel?: ReadLevel;
   }): Promise<number>;
@@ -231,6 +232,7 @@ export interface Collection {
        * 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.INDEX_AND_BOUNDED_WAL: Read up to a server-configured number of WAL entries
        */
       readLevel?: ReadLevel;
     },

package/src/schema.ts

@@ -251,72 +251,72 @@ export class SparseVectorIndexConfig {
 }
 
 export class FtsIndexType {
-  constructor(public enabled: boolean, public config: FtsIndexConfig) { }
+  constructor(public enabled: boolean, public config: FtsIndexConfig) {}
 }
 
 export class StringInvertedIndexType {
   constructor(
     public enabled: boolean,
     public config: StringInvertedIndexConfig,
-  ) { }
+  ) {}
 }
 
 export class VectorIndexType {
-  constructor(public enabled: boolean, public config: VectorIndexConfig) { }
+  constructor(public enabled: boolean, public config: VectorIndexConfig) {}
 }
 
 export class SparseVectorIndexType {
   constructor(
     public enabled: boolean,
     public config: SparseVectorIndexConfig,
-  ) { }
+  ) {}
 }
 
 export class IntInvertedIndexType {
-  constructor(public enabled: boolean, public config: IntInvertedIndexConfig) { }
+  constructor(public enabled: boolean, public config: IntInvertedIndexConfig) {}
 }
 
 export class FloatInvertedIndexType {
   constructor(
     public enabled: boolean,
     public config: FloatInvertedIndexConfig,
-  ) { }
+  ) {}
 }
 
 export class BoolInvertedIndexType {
   constructor(
     public enabled: boolean,
     public config: BoolInvertedIndexConfig,
-  ) { }
+  ) {}
 }
 
 export class StringValueType {
   constructor(
     public ftsIndex: FtsIndexType | null = null,
     public stringInvertedIndex: StringInvertedIndexType | null = null,
-  ) { }
+  ) {}
 }
 
 export class FloatListValueType {
-  constructor(public vectorIndex: VectorIndexType | null = null) { }
+  constructor(public vectorIndex: VectorIndexType | null = null) {}
 }
 
 export class SparseVectorValueType {
-  constructor(public sparseVectorIndex: SparseVectorIndexType | null = null) { }
+  constructor(public sparseVectorIndex: SparseVectorIndexType | null = null) {}
 }
 
 export class IntValueType {
-  constructor(public intInvertedIndex: IntInvertedIndexType | null = null) { }
+  constructor(public intInvertedIndex: IntInvertedIndexType | null = null) {}
 }
 
 export class FloatValueType {
   constructor(
     public floatInvertedIndex: FloatInvertedIndexType | null = null,
-  ) { }
+  ) {}
 }
 
 export class BoolValueType {
-  constructor(public boolInvertedIndex: BoolInvertedIndexType | null = null) { }
+  constructor(public boolInvertedIndex: BoolInvertedIndexType | null = null) {}
 }
 
 export class ValueTypes {
@@ -351,11 +351,11 @@ const cloneObject = <T>(value: T): T => {
   return Array.isArray(value)
     ? (value.map((item) => cloneObject(item)) as T)
     : (Object.fromEntries(
-      Object.entries(value as Record<string, unknown>).map(([k, v]) => [
-        k,
-        cloneObject(v),
-      ]),
-    ) as T);
+        Object.entries(value as Record<string, unknown>).map(([k, v]) => [
+          k,
+          cloneObject(v),
+        ]),
+      ) as T);
 };
 
 const resolveEmbeddingFunctionName = (
@@ -520,7 +520,11 @@ export class Schema {
     }
 
     // Only allow #document with FtsIndexConfig
-    if (keyProvided && key === DOCUMENT_KEY && !(config instanceof FtsIndexConfig)) {
+    if (
+      keyProvided &&
+      key === DOCUMENT_KEY &&
+      !(config instanceof FtsIndexConfig)
+    ) {
       throw new Error(
         `Cannot create index on special key '${key}' with this config. Only FtsIndexConfig is allowed for #document.`,
       );
@@ -545,7 +549,10 @@ export class Schema {
     }
 
     // FTS index is only allowed on #document key
-    if (config instanceof FtsIndexConfig && (!keyProvided || key !== DOCUMENT_KEY)) {
+    if (
+      config instanceof FtsIndexConfig &&
+      (!keyProvided || key !== DOCUMENT_KEY)
+    ) {
       throw new Error(
         "FTS index can only be enabled on #document key. Use createIndex(new FtsIndexConfig(), '#document')",
       );
@@ -586,13 +593,15 @@ export class Schema {
 
     // Disallow using special internal key #embedding
     if (keyProvided && key && key === EMBEDDING_KEY) {
-      throw new Error(
-        "Cannot modify #embedding. Currently not supported",
-      );
+      throw new Error("Cannot modify #embedding. Currently not supported");
     }
 
     // Only allow #document with FtsIndexConfig (to disable FTS)
-    if (keyProvided && key === DOCUMENT_KEY && !(config instanceof FtsIndexConfig)) {
+    if (
+      keyProvided &&
+      key === DOCUMENT_KEY &&
+      !(config instanceof FtsIndexConfig)
+    ) {
       throw new Error(
         `Cannot delete index on special key '${key}' with this config. Only FtsIndexConfig is allowed for #document.`,
       );
@@ -619,7 +628,10 @@ export class Schema {
     }
 
     // FTS deletion is only allowed on #document key
-    if (config instanceof FtsIndexConfig && (!keyProvided || key !== DOCUMENT_KEY)) {
+    if (
+      config instanceof FtsIndexConfig &&
+      (!keyProvided || key !== DOCUMENT_KEY)
+    ) {
       throw new Error("Deleting FTS index is only supported on #document key.");
     }
 
@@ -769,7 +781,6 @@ export class Schema {
     enabled: boolean,
   ): void {
     if (config instanceof SparseVectorIndexConfig && enabled) {
-      this.validateSingleSparseVectorIndex(key);
       this.validateSparseVectorConfig(config);
     }
 
@@ -865,18 +876,6 @@ export class Schema {
     );
   }
 
-  private validateSingleSparseVectorIndex(targetKey: string): void {
-    for (const [existingKey, valueTypes] of Object.entries(this.keys)) {
-      if (existingKey === targetKey) continue;
-      const sparseIndex = valueTypes.sparseVector?.sparseVectorIndex;
-      if (sparseIndex?.enabled) {
-        throw new Error(
-          `Cannot enable sparse vector index on key '${targetKey}'. A sparse vector index is already enabled on key '${existingKey}'. Only one sparse vector index is allowed per collection.`,
-        );
-      }
-    }
-  }
-
   private validateSparseVectorConfig(config: SparseVectorIndexConfig): void {
     // Validate that if source_key is provided then embedding_function is also provided
     // since there is no default embedding function
@@ -1087,7 +1086,8 @@ export class Schema {
       !embeddingFunction.supportedSpaces().includes(resolvedSpace)
     ) {
       console.warn(
-        `Space '${resolvedSpace}' is not supported by embedding function '${resolveEmbeddingFunctionName(embeddingFunction) ?? "unknown"
+        `Space '${resolvedSpace}' is not supported by embedding function '${
+          resolveEmbeddingFunctionName(embeddingFunction) ?? "unknown"
         }'. Supported spaces: ${embeddingFunction
           .supportedSpaces()
           .join(", ")}`,

package/src/types.ts

@@ -18,10 +18,13 @@ export type UserIdentity = GetUserIdentityResponse;
  *   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.
+ * - INDEX_AND_BOUNDED_WAL: Read from the index and up to a server-configured number of
+ *   WAL entries for bounded query latency.
  */
 export const ReadLevel = {
   INDEX_AND_WAL: "index_and_wal",
   INDEX_ONLY: "index_only",
+  INDEX_AND_BOUNDED_WAL: "index_and_bounded_wal",
 } as const;
 
 export type ReadLevel = (typeof ReadLevel)[keyof typeof ReadLevel];