chromadb 3.2.1 → 3.2.2

package/dist/chromadb.d.ts

@@ -865,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;
@@ -1665,7 +1665,14 @@ 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

package/dist/chromadb.legacy-esm.js

@@ -1649,7 +1649,9 @@ var WhereExpression = class _WhereExpression extends WhereExpressionBase {
       return void 0;
     }
     if (!isPlainObject(input)) {
-      throw new TypeError("Where input must be a WhereExpression or plain object");
+      throw new TypeError(
+        "Where input must be a WhereExpression or plain object"
+      );
     }
     return parseWhereDict(input);
   }
@@ -1735,7 +1737,10 @@ var comparisonOperatorMap = /* @__PURE__ */ new Map([
   ["$in", (key, value) => new ComparisonWhere(key, "$in", value)],
   ["$nin", (key, value) => new ComparisonWhere(key, "$nin", value)],
   ["$contains", (key, value) => new ComparisonWhere(key, "$contains", value)],
-  ["$not_contains", (key, value) => new ComparisonWhere(key, "$not_contains", value)],
+  [
+    "$not_contains",
+    (key, value) => new ComparisonWhere(key, "$not_contains", value)
+  ],
   ["$regex", (key, value) => new ComparisonWhere(key, "$regex", value)],
   ["$not_regex", (key, value) => new ComparisonWhere(key, "$not_regex", value)]
 ]);
@@ -1758,7 +1763,10 @@ var parseWhereDict = (data) => {
     if (conditions.length === 1) {
       return conditions[0];
     }
-    return conditions.slice(1).reduce((acc, condition) => AndWhere.combine(acc, condition), conditions[0]);
+    return conditions.slice(1).reduce(
+      (acc, condition) => AndWhere.combine(acc, condition),
+      conditions[0]
+    );
   }
   if ("$or" in data) {
     if (Object.keys(data).length !== 1) {
@@ -1778,7 +1786,10 @@ var parseWhereDict = (data) => {
     if (conditions.length === 1) {
       return conditions[0];
     }
-    return conditions.slice(1).reduce((acc, condition) => OrWhere.combine(acc, condition), conditions[0]);
+    return conditions.slice(1).reduce(
+      (acc, condition) => OrWhere.combine(acc, condition),
+      conditions[0]
+    );
   }
   const entries = Object.entries(data);
   if (entries.length !== 1) {
@@ -1790,7 +1801,9 @@ var parseWhereDict = (data) => {
   }
   const operatorEntries = Object.entries(value);
   if (operatorEntries.length !== 1) {
-    throw new Error(`Operator dictionary for field "${field}" must contain exactly one operator`);
+    throw new Error(
+      `Operator dictionary for field "${field}" must contain exactly one operator`
+    );
   }
   const [operator, operand] = operatorEntries[0];
   const factory = comparisonOperatorMap.get(operator);
@@ -1985,7 +1998,9 @@ var RankExpressionBase = class {
     }
     const expressions = [
       this,
-      ...others.map((item, index) => requireRank(item, `multiply operand ${index}`))
+      ...others.map(
+        (item, index) => requireRank(item, `multiply operand ${index}`)
+      )
     ];
     return MulRankExpression.create(expressions);
   }
@@ -2042,7 +2057,9 @@ var RankExpression = 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"
+    );
   }
 };
 var RawRankExpression = class extends RankExpression {
@@ -2298,14 +2315,21 @@ var requireRank = (input, context) => {
 };
 var Val = (value) => new ValueRankExpression(requireNumber(value, "Val requires a numeric value"));
 var Knn = (options) => new KnnRankExpression(normalizeKnnOptions(options));
-var Rrf = ({ ranks, k = 60, weights, normalize = false }) => {
+var Rrf = ({
+  ranks,
+  k = 60,
+  weights,
+  normalize = false
+}) => {
   if (!Number.isInteger(k) || k <= 0) {
     throw new TypeError("Rrf k must be a positive integer");
   }
   if (!Array.isArray(ranks) || ranks.length === 0) {
     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);
   if (weightValues.length !== expressions.length) {
     throw new Error("Number of weights must match number of ranks");
@@ -2316,7 +2340,9 @@ var Rrf = ({ ranks, k = 60, weights, normalize = false }) => {
   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);
   }
@@ -2333,18 +2359,28 @@ var Sum = (...inputs) => {
   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);
 };
-var Sub = (left, right) => new SubRankExpression(requireRank(left, "Sub left"), requireRank(right, "Sub right"));
+var Sub = (left, right) => new SubRankExpression(
+  requireRank(left, "Sub left"),
+  requireRank(right, "Sub right")
+);
 var Mul = (...inputs) => {
   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);
 };
-var Div = (left, right) => new DivRankExpression(requireRank(left, "Div left"), requireRank(right, "Div right"));
+var Div = (left, right) => new DivRankExpression(
+  requireRank(left, "Div left"),
+  requireRank(right, "Div right")
+);
 var Abs = (input) => requireRank(input, "Abs").abs();
 var Exp = (input) => requireRank(input, "Exp").exp();
 var Log = (input) => requireRank(input, "Log").log();
@@ -2352,14 +2388,18 @@ var Max = (...inputs) => {
   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);
 };
 var Min = (...inputs) => {
   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);
 };
 
@@ -2472,7 +2512,9 @@ var GroupBy = 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"
+    );
   }
   toJSON() {
     return {
@@ -2581,7 +2623,9 @@ var normalizePayloadArray = (payload, count) => {
   if (payload.length === count) {
     return payload.map((item) => item ? item.slice() : null);
   }
-  const result = payload.map((item) => item ? item.slice() : null);
+  const result = payload.map(
+    (item) => item ? item.slice() : null
+  );
   while (result.length < count) {
     result.push(null);
   }
@@ -2593,7 +2637,10 @@ var SearchResult = class {
     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;
@@ -3298,7 +3345,9 @@ var Schema = class _Schema {
   validateSparseVectorConfig(config) {
     if (config.sourceKey !== null && config.sourceKey !== void 0 && !config.embeddingFunction) {
       throw new Error(
-        `If sourceKey is provided then embeddingFunction must also be provided since there is no default embedding function. Config: ${JSON.stringify(config)}`
+        `If sourceKey is provided then embeddingFunction must also be provided since there is no default embedding function. Config: ${JSON.stringify(
+          config
+        )}`
       );
     }
   }
@@ -4356,7 +4405,9 @@ var chromaFetch = async (input, init) => {
         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/dist/chromadb.mjs

@@ -1649,7 +1649,9 @@ var WhereExpression = class _WhereExpression extends WhereExpressionBase {
       return void 0;
     }
     if (!isPlainObject(input)) {
-      throw new TypeError("Where input must be a WhereExpression or plain object");
+      throw new TypeError(
+        "Where input must be a WhereExpression or plain object"
+      );
     }
     return parseWhereDict(input);
   }
@@ -1735,7 +1737,10 @@ var comparisonOperatorMap = /* @__PURE__ */ new Map([
   ["$in", (key, value) => new ComparisonWhere(key, "$in", value)],
   ["$nin", (key, value) => new ComparisonWhere(key, "$nin", value)],
   ["$contains", (key, value) => new ComparisonWhere(key, "$contains", value)],
-  ["$not_contains", (key, value) => new ComparisonWhere(key, "$not_contains", value)],
+  [
+    "$not_contains",
+    (key, value) => new ComparisonWhere(key, "$not_contains", value)
+  ],
   ["$regex", (key, value) => new ComparisonWhere(key, "$regex", value)],
   ["$not_regex", (key, value) => new ComparisonWhere(key, "$not_regex", value)]
 ]);
@@ -1758,7 +1763,10 @@ var parseWhereDict = (data) => {
     if (conditions.length === 1) {
       return conditions[0];
     }
-    return conditions.slice(1).reduce((acc, condition) => AndWhere.combine(acc, condition), conditions[0]);
+    return conditions.slice(1).reduce(
+      (acc, condition) => AndWhere.combine(acc, condition),
+      conditions[0]
+    );
   }
   if ("$or" in data) {
     if (Object.keys(data).length !== 1) {
@@ -1778,7 +1786,10 @@ var parseWhereDict = (data) => {
     if (conditions.length === 1) {
       return conditions[0];
     }
-    return conditions.slice(1).reduce((acc, condition) => OrWhere.combine(acc, condition), conditions[0]);
+    return conditions.slice(1).reduce(
+      (acc, condition) => OrWhere.combine(acc, condition),
+      conditions[0]
+    );
   }
   const entries = Object.entries(data);
   if (entries.length !== 1) {
@@ -1790,7 +1801,9 @@ var parseWhereDict = (data) => {
   }
   const operatorEntries = Object.entries(value);
   if (operatorEntries.length !== 1) {
-    throw new Error(`Operator dictionary for field "${field}" must contain exactly one operator`);
+    throw new Error(
+      `Operator dictionary for field "${field}" must contain exactly one operator`
+    );
   }
   const [operator, operand] = operatorEntries[0];
   const factory = comparisonOperatorMap.get(operator);
@@ -1985,7 +1998,9 @@ var RankExpressionBase = class {
     }
     const expressions = [
       this,
-      ...others.map((item, index) => requireRank(item, `multiply operand ${index}`))
+      ...others.map(
+        (item, index) => requireRank(item, `multiply operand ${index}`)
+      )
     ];
     return MulRankExpression.create(expressions);
   }
@@ -2042,7 +2057,9 @@ var RankExpression = 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"
+    );
   }
 };
 var RawRankExpression = class extends RankExpression {
@@ -2298,14 +2315,21 @@ var requireRank = (input, context) => {
 };
 var Val = (value) => new ValueRankExpression(requireNumber(value, "Val requires a numeric value"));
 var Knn = (options) => new KnnRankExpression(normalizeKnnOptions(options));
-var Rrf = ({ ranks, k = 60, weights, normalize = false }) => {
+var Rrf = ({
+  ranks,
+  k = 60,
+  weights,
+  normalize = false
+}) => {
   if (!Number.isInteger(k) || k <= 0) {
     throw new TypeError("Rrf k must be a positive integer");
   }
   if (!Array.isArray(ranks) || ranks.length === 0) {
     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);
   if (weightValues.length !== expressions.length) {
     throw new Error("Number of weights must match number of ranks");
@@ -2316,7 +2340,9 @@ var Rrf = ({ ranks, k = 60, weights, normalize = false }) => {
   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);
   }
@@ -2333,18 +2359,28 @@ var Sum = (...inputs) => {
   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);
 };
-var Sub = (left, right) => new SubRankExpression(requireRank(left, "Sub left"), requireRank(right, "Sub right"));
+var Sub = (left, right) => new SubRankExpression(
+  requireRank(left, "Sub left"),
+  requireRank(right, "Sub right")
+);
 var Mul = (...inputs) => {
   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);
 };
-var Div = (left, right) => new DivRankExpression(requireRank(left, "Div left"), requireRank(right, "Div right"));
+var Div = (left, right) => new DivRankExpression(
+  requireRank(left, "Div left"),
+  requireRank(right, "Div right")
+);
 var Abs = (input) => requireRank(input, "Abs").abs();
 var Exp = (input) => requireRank(input, "Exp").exp();
 var Log = (input) => requireRank(input, "Log").log();
@@ -2352,14 +2388,18 @@ var Max = (...inputs) => {
   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);
 };
 var Min = (...inputs) => {
   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);
 };
 
@@ -2472,7 +2512,9 @@ var GroupBy = 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"
+    );
   }
   toJSON() {
     return {
@@ -2581,7 +2623,9 @@ var normalizePayloadArray = (payload, count) => {
   if (payload.length === count) {
     return payload.map((item) => item ? item.slice() : null);
   }
-  const result = payload.map((item) => item ? item.slice() : null);
+  const result = payload.map(
+    (item) => item ? item.slice() : null
+  );
   while (result.length < count) {
     result.push(null);
   }
@@ -2593,7 +2637,10 @@ var SearchResult = class {
     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;
@@ -3298,7 +3345,9 @@ var Schema = class _Schema {
   validateSparseVectorConfig(config) {
     if (config.sourceKey !== null && config.sourceKey !== void 0 && !config.embeddingFunction) {
       throw new Error(
-        `If sourceKey is provided then embeddingFunction must also be provided since there is no default embedding function. Config: ${JSON.stringify(config)}`
+        `If sourceKey is provided then embeddingFunction must also be provided since there is no default embedding function. Config: ${JSON.stringify(
+          config
+        )}`
       );
     }
   }
@@ -4356,7 +4405,9 @@ var chromaFetch = async (input, init) => {
         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");