chromadb 3.4.2 → 3.4.3

package/dist/cjs/chromadb.d.cts

@@ -1492,6 +1492,13 @@ declare class ChromaClient {
      * @throws Error if the collection does not exist
      */
     getCollectionByCrn(crn: string): Promise<Collection>;
+    /**
+     * Retrieves an existing collection by its ID.
+     * @param id - The UUID of the collection to retrieve
+     * @returns Promise resolving to the Collection instance
+     * @throws Error if the collection does not exist
+     */
+    getCollectionById(id: string): Promise<Collection>;
     /**
      * Retrieves multiple collections by name.
      * @param items - Array of collection names or objects with name and optional embedding function (should match the ones used to create the collections)

package/dist/cjs/cli.cjs

@@ -104,6 +104,9 @@ var main = async () => {
     await update();
     return;
   }
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
   bindings_default.cli(["chroma", ...args]);
 };
 main().finally();

package/dist/cjs/cli.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli.ts","../../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oBAAmB;;;ACDnB,oBAA8B;AAC9B,gBAAe;AADf;AAGA,IAAMA,eAAU,6BAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,UAAAC,QAAG,SAAS;AAC7B,IAAM,OAAO,UAAAA,QAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUD,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,cAAAE,QAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require","os","semver"]}
+{"version":3,"sources":["../../src/cli.ts","../../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  process.on(\"SIGINT\", () => {\n    process.exit(0);\n  });\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AACA,oBAAmB;;;ACDnB,oBAA8B;AAC9B,gBAAe;AADf;AAGA,IAAMA,eAAU,6BAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,UAAAC,QAAG,SAAS;AAC7B,IAAM,OAAO,UAAAA,QAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUD,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,cAAAE,QAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,UAAQ,GAAG,UAAU,MAAM;AACzB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require","os","semver"]}

package/dist/cli.mjs

@@ -81,6 +81,9 @@ var main = async () => {
     await update();
     return;
   }
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
   bindings_default.cli(["chroma", ...args]);
 };
 main().finally();

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts","../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;AACA,OAAO,YAAY;;;ACDnB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,GAAG,SAAS;AAC7B,IAAM,OAAO,GAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,OAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require"]}
+{"version":3,"sources":["../src/cli.ts","../src/bindings.ts"],"sourcesContent":["#!/usr/bin/env node\nimport semver from \"semver\";\nimport binding from \"./bindings\";\n\ninterface NpmPackageData {\n  \"dist-tags\": {\n    latest: string;\n    [tag: string]: string;\n  };\n}\n\nconst getLatestVersion = async (packageName: string): Promise<string> => {\n  const response = await fetch(`https://registry.npmjs.org/${packageName}`);\n  if (!response.ok) {\n    throw new Error(`Failed to fetch package data: ${response.statusText}`);\n  }\n  const data: NpmPackageData = await response.json();\n  return data[\"dist-tags\"].latest;\n};\n\nconst update = async (): Promise<void> => {\n  try {\n    const installedVersion = process.env.CHROMADB_VERSION || \"0.0.0\";\n    const latestVersion = await getLatestVersion(\"chromadb\");\n\n    if (semver.lt(installedVersion, latestVersion)) {\n      console.log(`\\nA new chromadb version (${latestVersion}) is available!`);\n      console.log(\"\\n\\x1b[4mUpdat with npm\\x1b[0m\");\n      console.log(\"npm install chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with pnpm\\x1b[0m\");\n      console.log(\"pnpm add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with yarn\\x1b[0m\");\n      console.log(\"yarn add chromadb@latest\");\n\n      console.log(\"\\n\\x1b[4mUpdat with bun\\x1b[0m\");\n      console.log(\"bun add chromadb@latest\\n\");\n    } else {\n      console.log(\n        `\\nYour chromadb version (${latestVersion}) is up-to-date!\\n`,\n      );\n    }\n  } catch (error) {\n    console.error(\"Error checking versions:\", error);\n  }\n};\n\nconst main = async () => {\n  const args: string[] = process.argv.slice(2);\n  if (args.length > 0 && args[0] === \"update\") {\n    await update();\n    return;\n  }\n\n  process.on(\"SIGINT\", () => {\n    process.exit(0);\n  });\n\n  binding.cli([\"chroma\", ...args]);\n};\n\nmain().finally();\n","import { createRequire } from \"module\";\nimport os from \"os\";\n\nconst require = createRequire(import.meta.url);\nconst platform = os.platform();\nconst arch = os.arch();\n\nlet binding: any;\n\nif (platform === \"darwin\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-darwin-arm64\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-darwin-x64\");\n  } else {\n    throw new Error(`Unsupported architecture on macOS: ${arch}`);\n  }\n} else if (platform === \"linux\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-linux-arm64-gnu\");\n  } else if (arch === \"x64\") {\n    binding = require(\"chromadb-js-bindings-linux-x64-gnu\");\n  } else {\n    throw new Error(`Unsupported architecture on Linux: ${arch}`);\n  }\n} else if (platform === \"win32\") {\n  if (arch === \"arm64\") {\n    binding = require(\"chromadb-js-bindings-win32-arm64-msvc\");\n  } else {\n    throw new Error(\n      `Unsupported Windows architecture: ${arch}. Only ARM64 is supported.`,\n    );\n  }\n} else {\n  throw new Error(`Unsupported platform: ${platform}`);\n}\n\nexport default binding;\n"],"mappings":";;;;AACA,OAAO,YAAY;;;ACDnB,SAAS,qBAAqB;AAC9B,OAAO,QAAQ;AAEf,IAAMA,WAAU,cAAc,YAAY,GAAG;AAC7C,IAAM,WAAW,GAAG,SAAS;AAC7B,IAAM,OAAO,GAAG,KAAK;AAErB,IAAI;AAEJ,IAAI,aAAa,UAAU;AACzB,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,mCAAmC;AAAA,EACvD,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,iCAAiC;AAAA,EACrD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,sCAAsC;AAAA,EAC1D,WAAW,SAAS,OAAO;AACzB,cAAUA,SAAQ,oCAAoC;AAAA,EACxD,OAAO;AACL,UAAM,IAAI,MAAM,sCAAsC,IAAI,EAAE;AAAA,EAC9D;AACF,WAAW,aAAa,SAAS;AAC/B,MAAI,SAAS,SAAS;AACpB,cAAUA,SAAQ,uCAAuC;AAAA,EAC3D,OAAO;AACL,UAAM,IAAI;AAAA,MACR,qCAAqC,IAAI;AAAA,IAC3C;AAAA,EACF;AACF,OAAO;AACL,QAAM,IAAI,MAAM,yBAAyB,QAAQ,EAAE;AACrD;AAEA,IAAO,mBAAQ;;;AD1Bf,IAAM,mBAAmB,OAAO,gBAAyC;AACvE,QAAM,WAAW,MAAM,MAAM,8BAA8B,WAAW,EAAE;AACxE,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,iCAAiC,SAAS,UAAU,EAAE;AAAA,EACxE;AACA,QAAM,OAAuB,MAAM,SAAS,KAAK;AACjD,SAAO,KAAK,WAAW,EAAE;AAC3B;AAEA,IAAM,SAAS,YAA2B;AACxC,MAAI;AACF,UAAM,mBAAmB,QAAQ,IAAI,oBAAoB;AACzD,UAAM,gBAAgB,MAAM,iBAAiB,UAAU;AAEvD,QAAI,OAAO,GAAG,kBAAkB,aAAa,GAAG;AAC9C,cAAQ,IAAI;AAAA,0BAA6B,aAAa,iBAAiB;AACvE,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,6BAA6B;AAEzC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,iCAAiC;AAC7C,cAAQ,IAAI,0BAA0B;AAEtC,cAAQ,IAAI,gCAAgC;AAC5C,cAAQ,IAAI,2BAA2B;AAAA,IACzC,OAAO;AACL,cAAQ;AAAA,QACN;AAAA,yBAA4B,aAAa;AAAA;AAAA,MAC3C;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,YAAQ,MAAM,4BAA4B,KAAK;AAAA,EACjD;AACF;AAEA,IAAM,OAAO,YAAY;AACvB,QAAM,OAAiB,QAAQ,KAAK,MAAM,CAAC;AAC3C,MAAI,KAAK,SAAS,KAAK,KAAK,CAAC,MAAM,UAAU;AAC3C,UAAM,OAAO;AACb;AAAA,EACF;AAEA,UAAQ,GAAG,UAAU,MAAM;AACzB,YAAQ,KAAK,CAAC;AAAA,EAChB,CAAC;AAED,mBAAQ,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;AACjC;AAEA,KAAK,EAAE,QAAQ;","names":["require"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chromadb",
-  "version": "3.4.2",
+  "version": "3.4.3",
   "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.3.2",
-    "chromadb-js-bindings-darwin-x64": "^1.3.2",
-    "chromadb-js-bindings-linux-arm64-gnu": "^1.3.2",
-    "chromadb-js-bindings-linux-x64-gnu": "^1.3.2",
-    "chromadb-js-bindings-win32-x64-msvc": "^1.3.2"
+    "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"
   },
   "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, 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, 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> & {
@@ -94,6 +94,23 @@ export class CollectionService {
         });
     }
     
+    /**
+     * Get collection by ID
+     * Returns a collection by its UUID within a specific tenant and database.
+     */
+    public static getCollectionById<ThrowOnError extends boolean = true>(options: Options<GetCollectionByIdData, ThrowOnError>) {
+        return (options.client ?? _heyApiClient).get<GetCollectionByIdResponse, GetCollectionByIdError, ThrowOnError>({
+            security: [
+                {
+                    name: 'x-chroma-token',
+                    type: 'apiKey'
+                }
+            ],
+            url: '/api/v2/tenants/{tenant}/databases/{database}/collections/by-id/{collection_id}',
+            ...options
+        });
+    }
+    
     /**
      * Delete collection
      * Deletes a collection in a database.

package/src/api/types.gen.ts

@@ -1307,6 +1307,52 @@ export type CreateCollectionResponses = {
 
 export type CreateCollectionResponse = CreateCollectionResponses[keyof CreateCollectionResponses];
 
+export type GetCollectionByIdData = {
+    body?: never;
+    path: {
+        /**
+         * Tenant ID
+         */
+        tenant: string;
+        /**
+         * Database name
+         */
+        database: string;
+        /**
+         * Collection UUID
+         */
+        collection_id: string;
+    };
+    query?: never;
+    url: '/api/v2/tenants/{tenant}/databases/{database}/collections/by-id/{collection_id}';
+};
+
+export type GetCollectionByIdErrors = {
+    /**
+     * Unauthorized
+     */
+    401: ErrorResponse;
+    /**
+     * Collection not found
+     */
+    404: ErrorResponse;
+    /**
+     * Server error
+     */
+    500: ErrorResponse;
+};
+
+export type GetCollectionByIdError = GetCollectionByIdErrors[keyof GetCollectionByIdErrors];
+
+export type GetCollectionByIdResponses = {
+    /**
+     * Collection found
+     */
+    200: Collection;
+};
+
+export type GetCollectionByIdResponse = GetCollectionByIdResponses[keyof GetCollectionByIdResponses];
+
 export type DeleteCollectionData = {
     body?: never;
     path: {

package/src/chroma-client.ts

@@ -440,6 +440,38 @@ export class ChromaClient {
     });
   }
 
+  /**
+   * Retrieves an existing collection by its ID.
+   * @param id - The UUID of the collection to retrieve
+   * @returns Promise resolving to the Collection instance
+   * @throws Error if the collection does not exist
+   */
+  public async getCollectionById(id: string): Promise<Collection> {
+    const { data } = await CollectionService.getCollectionById({
+      client: this.apiClient,
+      path: { ...(await this._path()), collection_id: id },
+    });
+    const schema = await Schema.deserializeFromJSON(data.schema ?? null, this);
+    const schemaEmbeddingFunction = resolveSchemaEmbeddingFunction(schema);
+    const resolvedEmbeddingFunction =
+      (await getEmbeddingFunction({
+        efConfig: data.configuration_json.embedding_function ?? undefined,
+        client: this,
+      })) ?? schemaEmbeddingFunction;
+    return new CollectionImpl({
+      chromaClient: this,
+      apiClient: this.apiClient,
+      name: data.name,
+      tenant: data.tenant,
+      database: data.database,
+      configuration: data.configuration_json,
+      metadata: deserializeMetadata(data.metadata ?? undefined) ?? undefined,
+      embeddingFunction: resolvedEmbeddingFunction,
+      id: data.id,
+      schema,
+    });
+  }
+
   /**
    * Retrieves multiple collections by name.
    * @param items - Array of collection names or objects with name and optional embedding function (should match the ones used to create the collections)

package/src/cli.ts

@@ -53,6 +53,10 @@ const main = async () => {
     return;
   }
 
+  process.on("SIGINT", () => {
+    process.exit(0);
+  });
+
   binding.cli(["chroma", ...args]);
 };