chromadb 3.0.14 → 3.0.15

package/dist/chromadb.d.ts

@@ -42,6 +42,19 @@ type SpannConfiguration = {
     split_threshold?: number | null;
     write_nprobe?: number | null;
 };
+/**
+ * Represents a sparse vector using parallel arrays for indices and values.
+ */
+type SparseVector = {
+    /**
+     * Dimension indices
+     */
+    indices: Array<number>;
+    /**
+     * Values corresponding to each index
+     */
+    values: Array<number>;
+};
 type UpdateCollectionConfiguration$1 = {
     embedding_function?: null | EmbeddingFunctionConfiguration;
     hnsw?: null | UpdateHnswConfiguration;
@@ -68,12 +81,12 @@ type UserIdentity = GetUserIdentityResponse;
  * Metadata that can be associated with a collection.
  * Values must be boolean, number, or string types.
  */
-type CollectionMetadata = Record<string, boolean | number | string | null>;
+type CollectionMetadata = Record<string, boolean | number | string | SparseVector | null>;
 /**
  * Metadata that can be associated with individual records.
  * Values must be boolean, number, or string types.
  */
-type Metadata = Record<string, boolean | number | string | null>;
+type Metadata = Record<string, boolean | number | string | SparseVector | null>;
 /**
  * Base interface for record sets containing optional fields.
  */

package/dist/chromadb.legacy-esm.js

@@ -371,6 +371,15 @@ var DefaultService = class {
       ...options
     });
   }
+  /**
+   * Retrieves a collection by Chroma Resource Name.
+   */
+  static getCollectionByCrn(options) {
+    return (options.client ?? client).get({
+      url: "/api/v2/collections/{crn}",
+      ...options
+    });
+  }
   /**
    * Health check endpoint that returns 200 if the server and executor are ready
    */
@@ -609,6 +618,19 @@ var DefaultService = class {
       }
     });
   }
+  /**
+   * Search records from a collection with hybrid criterias.
+   */
+  static collectionSearch(options) {
+    return (options.client ?? client).post({
+      url: "/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/search",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
   /**
    * Updates records in a collection by ID.
    */
@@ -901,6 +923,9 @@ var validateIDs = (ids) => {
     );
   }
 };
+var validateSparseVector = (v) => {
+  return typeof v === "object" && v !== null && "indices" in v && "values" in v && Array.isArray(v.indices) && v.indices.every((e) => typeof e === "number") && Array.isArray(v.values) && v.values.every((e) => typeof e === "number");
+};
 var validateMetadata = (metadata) => {
   if (!metadata) {
     return;
@@ -909,10 +934,10 @@ var validateMetadata = (metadata) => {
     throw new ChromaValueError("Expected metadata to be non-empty");
   }
   if (!Object.values(metadata).every(
-    (v) => v === null || v === void 0 || typeof v === "string" || typeof v === "number" || typeof v === "boolean"
+    (v) => v === null || v === void 0 || typeof v === "string" || typeof v === "number" || typeof v === "boolean" || validateSparseVector(v)
   )) {
     throw new ChromaValueError(
-      "Expected metadata to be a string, number, boolean, or nullable"
+      "Expected metadata to be a string, number, boolean, SparseVector, or nullable"
     );
   }
 };

package/dist/chromadb.mjs

@@ -371,6 +371,15 @@ var DefaultService = class {
       ...options
     });
   }
+  /**
+   * Retrieves a collection by Chroma Resource Name.
+   */
+  static getCollectionByCrn(options) {
+    return (options.client ?? client).get({
+      url: "/api/v2/collections/{crn}",
+      ...options
+    });
+  }
   /**
    * Health check endpoint that returns 200 if the server and executor are ready
    */
@@ -609,6 +618,19 @@ var DefaultService = class {
       }
     });
   }
+  /**
+   * Search records from a collection with hybrid criterias.
+   */
+  static collectionSearch(options) {
+    return (options.client ?? client).post({
+      url: "/api/v2/tenants/{tenant}/databases/{database}/collections/{collection_id}/search",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
   /**
    * Updates records in a collection by ID.
    */
@@ -901,6 +923,9 @@ var validateIDs = (ids) => {
     );
   }
 };
+var validateSparseVector = (v) => {
+  return typeof v === "object" && v !== null && "indices" in v && "values" in v && Array.isArray(v.indices) && v.indices.every((e) => typeof e === "number") && Array.isArray(v.values) && v.values.every((e) => typeof e === "number");
+};
 var validateMetadata = (metadata) => {
   if (!metadata) {
     return;
@@ -909,10 +934,10 @@ var validateMetadata = (metadata) => {
     throw new ChromaValueError("Expected metadata to be non-empty");
   }
   if (!Object.values(metadata).every(
-    (v) => v === null || v === void 0 || typeof v === "string" || typeof v === "number" || typeof v === "boolean"
+    (v) => v === null || v === void 0 || typeof v === "string" || typeof v === "number" || typeof v === "boolean" || validateSparseVector(v)
   )) {
     throw new ChromaValueError(
-      "Expected metadata to be a string, number, boolean, or nullable"
+      "Expected metadata to be a string, number, boolean, SparseVector, or nullable"
     );
   }
 };