chromadb 3.2.0 → 3.2.1

package/dist/chromadb.d.ts

@@ -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.
@@ -1643,6 +1666,11 @@ interface Collection {
      * @returns Promise resolving to column-major search results
      */
     search(searches: SearchLike | SearchLike[]): 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 +1890,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/dist/chromadb.legacy-esm.js

@@ -24,6 +24,10 @@ if (typeof globalThis.Deno !== "undefined") {
 }
 
 // src/types.ts
+var ReadLevel = {
+  INDEX_AND_WAL: "index_and_wal",
+  INDEX_ONLY: "index_only"
+};
 var baseRecordSetFields = [
   "ids",
   "embeddings",
@@ -640,6 +644,15 @@ var DefaultService = class {
       }
     });
   }
+  /**
+   * Retrieves the indexing status of a collection.
+   */
+  static indexingStatus(options) {
+    return (options.client ?? client).get({
+      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
    */
@@ -4094,7 +4107,7 @@ var CollectionImpl = class _CollectionImpl {
       uris: data.uris ?? []
     });
   }
-  async search(searches) {
+  async search(searches, options) {
     const items = Array.isArray(searches) ? searches : [searches];
     if (items.length === 0) {
       throw new ChromaValueError(
@@ -4110,7 +4123,10 @@ var CollectionImpl = class _CollectionImpl {
     const { data } = await DefaultService.collectionSearch({
       client: this.apiClient,
       path: await this.path(),
-      body: { searches: payloads }
+      body: {
+        searches: payloads,
+        read_level: options?.readLevel
+      }
     });
     return new SearchResult(data);
   }
@@ -4244,6 +4260,13 @@ var CollectionImpl = class _CollectionImpl {
       }
     });
   }
+  async getIndexingStatus() {
+    const { data } = await DefaultService.indexingStatus({
+      client: this.apiClient,
+      path: await this.path()
+    });
+    return data;
+  }
 };
 
 // src/next.ts
@@ -5000,6 +5023,7 @@ export {
   Mul,
   QueryResult,
   RankExpression,
+  ReadLevel,
   Rrf,
   Schema,
   Search,

package/dist/chromadb.mjs

@@ -24,6 +24,10 @@ if (typeof globalThis.Deno !== "undefined") {
 }
 
 // src/types.ts
+var ReadLevel = {
+  INDEX_AND_WAL: "index_and_wal",
+  INDEX_ONLY: "index_only"
+};
 var baseRecordSetFields = [
   "ids",
   "embeddings",
@@ -640,6 +644,15 @@ var DefaultService = class {
       }
     });
   }
+  /**
+   * Retrieves the indexing status of a collection.
+   */
+  static indexingStatus(options) {
+    return (options.client ?? client).get({
+      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
    */
@@ -4094,7 +4107,7 @@ var CollectionImpl = class _CollectionImpl {
       uris: data.uris ?? []
     });
   }
-  async search(searches) {
+  async search(searches, options) {
     const items = Array.isArray(searches) ? searches : [searches];
     if (items.length === 0) {
       throw new ChromaValueError(
@@ -4110,7 +4123,10 @@ var CollectionImpl = class _CollectionImpl {
     const { data } = await DefaultService.collectionSearch({
       client: this.apiClient,
       path: await this.path(),
-      body: { searches: payloads }
+      body: {
+        searches: payloads,
+        read_level: options?.readLevel
+      }
     });
     return new SearchResult(data);
   }
@@ -4244,6 +4260,13 @@ var CollectionImpl = class _CollectionImpl {
       }
     });
   }
+  async getIndexingStatus() {
+    const { data } = await DefaultService.indexingStatus({
+      client: this.apiClient,
+      path: await this.path()
+    });
+    return data;
+  }
 };
 
 // src/next.ts
@@ -5000,6 +5023,7 @@ export {
   Mul,
   QueryResult,
   RankExpression,
+  ReadLevel,
   Rrf,
   Schema,
   Search,