@vivantel/rag-store-chromadb 1.2.1

package/README.md

@@ -0,0 +1,83 @@
+# @vivantel/rag-store-chromadb
+
+[![npm](https://img.shields.io/npm/v/@vivantel/rag-store-chromadb.svg)](https://www.npmjs.com/package/@vivantel/rag-store-chromadb)
+
+ChromaDB vector store for [`@vivantel/rag-core`](../rag-core/README.md). Works with a locally-running Chroma server or hosted Chroma Cloud.
+
+## Installation
+
+```bash
+npm install @vivantel/rag-store-chromadb @vivantel/rag-core
+```
+
+## Quick start (JSON config)
+
+Local Chroma server:
+
+```json
+{
+  "vectorStore": {
+    "package": "@vivantel/rag-store-chromadb",
+    "config": {
+      "path": "http://localhost:8000"
+    }
+  }
+}
+```
+
+## Running Chroma locally
+
+```bash
+docker run -p 8000:8000 chromadb/chroma
+```
+
+## Hosted Chroma
+
+Pass your Chroma Cloud URL and API key:
+
+```json
+{
+  "vectorStore": {
+    "package": "@vivantel/rag-store-chromadb",
+    "config": {
+      "path": "${CHROMA_URL}",
+      "apiKey": "${CHROMA_API_KEY}"
+    }
+  }
+}
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `path` | `string` | `"http://localhost:8000"` | Chroma server URL |
+| `apiKey` | `string` | `undefined` | API key for hosted Chroma (token auth) |
+| `collectionName` | `string` | `"documents"` | Collection name |
+| `dimensions` | `number` | `undefined` | Vector size (inferred from first upsert if omitted) |
+
+## TypeScript usage
+
+```typescript
+import { ChromaVectorStore } from "@vivantel/rag-store-chromadb";
+
+const store = new ChromaVectorStore({
+  path: "http://localhost:8000",
+  collectionName: "my-docs",
+});
+```
+
+## Self-registration
+
+This package declares a `"rag-plugin"` field in its `package.json`. Once installed, `rag-update init` discovers it automatically — no manual config required.
+
+```jsonc
+// package.json (excerpt)
+"rag-plugin": {
+  "type": "vectorStore",
+  "label": "ChromaDB (local or hosted)",
+  "key": "chromadb",
+  "envVars": [],
+  "defaultConfig": { "path": "http://localhost:8000" }
+}
+```

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ChromaVectorStore, type ChromaVectorStoreOptions } from "./store.js";
+import type { VectorStore } from "@vivantel/rag-core";
+/** Factory used by the JSON config loader. */
+export declare function createVectorStore(config: Record<string, unknown>): VectorStore;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAE9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,WAAW,CAWb"}

package/dist/index.js

@@ -0,0 +1,14 @@
+export { ChromaVectorStore } from "./store.js";
+import { ChromaVectorStore } from "./store.js";
+/** Factory used by the JSON config loader. */
+export function createVectorStore(config) {
+    return new ChromaVectorStore({
+        path: typeof config.path === "string" ? config.path : undefined,
+        collectionName: typeof config.collectionName === "string"
+            ? config.collectionName
+            : undefined,
+        dimensions: typeof config.dimensions === "number" ? config.dimensions : undefined,
+        apiKey: typeof config.apiKey === "string" ? config.apiKey : undefined,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAiC,MAAM,YAAY,CAAC;AAG9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAC/B,MAA+B;IAE/B,OAAO,IAAI,iBAAiB,CAAC;QAC3B,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC/D,cAAc,EACZ,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;YACvC,CAAC,CAAC,MAAM,CAAC,cAAc;YACvB,CAAC,CAAC,SAAS;QACf,UAAU,EACR,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACvE,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KACtE,CAAC,CAAC;AACL,CAAC"}

package/dist/query-perf.d.ts

@@ -0,0 +1,4 @@
+import type { QueryPerfReport } from "@vivantel/rag-core";
+import type { Collection } from "chromadb";
+export declare function getQueryPerfReport(collection: Collection, dimensions: number, timeframeHours: number): Promise<QueryPerfReport>;
+//# sourceMappingURL=query-perf.d.ts.map

package/dist/query-perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-perf.d.ts","sourceRoot":"","sources":["../src/query-perf.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAa3C,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC,CAiE1B"}

package/dist/query-perf.js

@@ -0,0 +1,65 @@
+import { IncludeEnum } from "chromadb";
+const SAMPLE_COUNT = 20;
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return -1;
+    return (sorted[Math.floor((p / 100) * sorted.length)] ??
+        sorted[sorted.length - 1] ??
+        0);
+}
+export async function getQueryPerfReport(collection, dimensions, timeframeHours) {
+    // Try to fetch real embeddings for representative queries; fall back to zero vectors.
+    let sampleEmbeddings = [];
+    try {
+        const result = await collection.get({
+            include: [IncludeEnum.Embeddings],
+            limit: SAMPLE_COUNT,
+        });
+        if (result.embeddings && result.embeddings.length > 0) {
+            sampleEmbeddings = result.embeddings.map((e) => Array.from(e));
+        }
+    }
+    catch {
+        // Fall through to synthetic vectors
+    }
+    if (sampleEmbeddings.length === 0) {
+        sampleEmbeddings = Array.from({ length: SAMPLE_COUNT }, () => Array(dimensions).fill(0));
+    }
+    const latencies = [];
+    for (const embedding of sampleEmbeddings) {
+        const start = performance.now();
+        try {
+            await collection.query({
+                queryEmbeddings: [embedding],
+                nResults: 10,
+                include: [],
+            });
+        }
+        catch {
+            // Empty collection or other transient error — still record timing
+        }
+        latencies.push(performance.now() - start);
+    }
+    latencies.sort((a, b) => a - b);
+    const p50 = percentile(latencies, 50);
+    const p95 = percentile(latencies, 95);
+    const p99 = percentile(latencies, 99);
+    const slowQueryCount = latencies.filter((ms) => ms > 100).length;
+    const suggestedIndexes = [];
+    if (p95 > 100) {
+        suggestedIndexes.push(`p95 latency (${p95.toFixed(1)} ms) is high. ` +
+            `Consider increasing ChromaDB server resources or tuning HNSW ef_search.`);
+    }
+    else {
+        suggestedIndexes.push("Query performance looks healthy.");
+    }
+    return {
+        timeframeHours,
+        p50LatencyMs: Math.round(p50 * 10) / 10,
+        p95LatencyMs: Math.round(p95 * 10) / 10,
+        p99LatencyMs: Math.round(p99 * 10) / 10,
+        slowQueryCount,
+        suggestedIndexes,
+    };
+}
+//# sourceMappingURL=query-perf.js.map

package/dist/query-perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-perf.js","sourceRoot":"","sources":["../src/query-perf.ts"],"names":[],"mappings":"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"}

package/dist/query-perf.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-perf.test.d.ts.map

package/dist/query-perf.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-perf.test.d.ts","sourceRoot":"","sources":["../src/query-perf.test.ts"],"names":[],"mappings":""}

package/dist/query-perf.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect, vi } from "vitest";
+import { getQueryPerfReport } from "./query-perf.js";
+function makeCollection(overrides = {}) {
+    const delay = overrides.queryDelayMs ?? 2;
+    return {
+        get: overrides.get ?? vi.fn().mockResolvedValue({ embeddings: [], ids: [] }),
+        query: overrides.query ??
+            vi
+                .fn()
+                .mockImplementation(() => new Promise((resolve) => setTimeout(() => resolve({ ids: [[]] }), delay))),
+    };
+}
+describe("getQueryPerfReport (ChromaDB)", () => {
+    it("returns valid latency percentiles (p50 ≤ p95 ≤ p99)", async () => {
+        const report = await getQueryPerfReport(makeCollection({ queryDelayMs: 2 }), 384, 24);
+        expect(report.timeframeHours).toBe(24);
+        expect(report.p50LatencyMs).toBeGreaterThanOrEqual(0);
+        expect(report.p95LatencyMs).toBeGreaterThanOrEqual(report.p50LatencyMs);
+        expect(report.p99LatencyMs).toBeGreaterThanOrEqual(report.p95LatencyMs);
+    });
+    it("timeframeHours is reflected in the report", async () => {
+        const report = await getQueryPerfReport(makeCollection(), 384, 48);
+        expect(report.timeframeHours).toBe(48);
+    });
+    it("slowQueryCount is 0 for fast queries (< 100 ms)", async () => {
+        const report = await getQueryPerfReport(makeCollection({ queryDelayMs: 1 }), 384, 24);
+        expect(report.slowQueryCount).toBe(0);
+    });
+    it("returns healthy suggestion when p95 ≤ 100 ms", async () => {
+        const report = await getQueryPerfReport(makeCollection({ queryDelayMs: 1 }), 384, 24);
+        expect(report.suggestedIndexes[0]).toMatch(/healthy/i);
+    });
+    it("uses real embeddings from collection.get() when available", async () => {
+        const fakeEmbeddings = [Array(4).fill(0.1), Array(4).fill(0.2)];
+        const querySpy = vi.fn().mockResolvedValue({ ids: [[]] });
+        const collection = makeCollection({
+            get: vi
+                .fn()
+                .mockResolvedValue({ embeddings: fakeEmbeddings, ids: ["a", "b"] }),
+            query: querySpy,
+        });
+        await getQueryPerfReport(collection, 4, 24);
+        // Exactly 2 real embeddings → exactly 2 query calls
+        expect(querySpy).toHaveBeenCalledTimes(2);
+        const firstArg = querySpy.mock.calls[0][0];
+        expect(firstArg.queryEmbeddings[0]).toEqual(expect.arrayContaining([0.1]));
+    });
+    it("falls back to 20 synthetic zero-vectors when collection.get() fails", async () => {
+        const querySpy = vi.fn().mockResolvedValue({ ids: [[]] });
+        const collection = makeCollection({
+            get: vi.fn().mockRejectedValue(new Error("not supported")),
+            query: querySpy,
+        });
+        const report = await getQueryPerfReport(collection, 384, 24);
+        expect(report.p50LatencyMs).toBeGreaterThanOrEqual(0);
+        // 20 synthetic samples (SAMPLE_COUNT)
+        expect(querySpy).toHaveBeenCalledTimes(20);
+    });
+    it("suggests HNSW tuning when p95 > 100 ms", async () => {
+        const report = await getQueryPerfReport(makeCollection({ queryDelayMs: 120 }), 384, 24);
+        expect(report.suggestedIndexes[0]).toMatch(/HNSW|hnsw/i);
+    }, 15_000);
+    it("handles query errors gracefully (still returns a complete report)", async () => {
+        const collection = makeCollection({
+            query: vi.fn().mockRejectedValue(new Error("connection refused")),
+        });
+        const report = await getQueryPerfReport(collection, 384, 24);
+        expect(report.p50LatencyMs).toBeGreaterThanOrEqual(0);
+        expect(report.slowQueryCount).toBeGreaterThanOrEqual(0);
+        expect(report.suggestedIndexes.length).toBeGreaterThan(0);
+    });
+}, 60_000);
+//# sourceMappingURL=query-perf.test.js.map

package/dist/query-perf.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-perf.test.js","sourceRoot":"","sources":["../src/query-perf.test.ts"],"names":[],"mappings":"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"}

package/dist/stats.d.ts

@@ -0,0 +1,4 @@
+import type { IndexStats } from "@vivantel/rag-core";
+import type { Collection } from "chromadb";
+export declare function getIndexStats(collection: Collection): Promise<IndexStats>;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,UAAU,CAAC,CAoBrB"}

package/dist/stats.js

@@ -0,0 +1,19 @@
+export async function getIndexStats(collection) {
+    const totalVectors = await collection.count();
+    const suggestions = [];
+    if (totalVectors === 0) {
+        suggestions.push("Collection is empty.");
+    }
+    else {
+        suggestions.push("ChromaDB uses HNSW internally — no manual reindex needed.");
+    }
+    return {
+        totalVectors,
+        indexType: "hnsw",
+        annRecallAt10: -1,
+        indexAgeHours: -1,
+        deadTupleFraction: 0,
+        suggestions,
+    };
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAsB;IAEtB,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC;IAC9C,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;QACvB,WAAW,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,IAAI,CACd,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,MAAM;QACjB,aAAa,EAAE,CAAC,CAAC;QACjB,aAAa,EAAE,CAAC,CAAC;QACjB,iBAAiB,EAAE,CAAC;QACpB,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist/stats.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stats.test.d.ts.map

package/dist/stats.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.test.d.ts","sourceRoot":"","sources":["../src/stats.test.ts"],"names":[],"mappings":""}

package/dist/stats.test.js

@@ -0,0 +1,41 @@
+import { describe, it, expect, vi } from "vitest";
+import { getIndexStats } from "./stats.js";
+function makeCollection(count) {
+    return {
+        count: vi.fn().mockResolvedValue(count),
+    };
+}
+describe("getIndexStats (ChromaDB)", () => {
+    it("always returns hnsw indexType", async () => {
+        const stats = await getIndexStats(makeCollection(100));
+        expect(stats.indexType).toBe("hnsw");
+    });
+    it("reflects the collection count as totalVectors", async () => {
+        const stats = await getIndexStats(makeCollection(4200));
+        expect(stats.totalVectors).toBe(4200);
+    });
+    it("totalVectors is 0 for an empty collection", async () => {
+        const stats = await getIndexStats(makeCollection(0));
+        expect(stats.totalVectors).toBe(0);
+    });
+    it("suggestion mentions HNSW for a non-empty collection", async () => {
+        const stats = await getIndexStats(makeCollection(50));
+        expect(stats.suggestions[0]).toMatch(/HNSW/i);
+        expect(stats.suggestions[0]).not.toMatch(/empty/i);
+    });
+    it("suggestion mentions empty for a zero-count collection", async () => {
+        const stats = await getIndexStats(makeCollection(0));
+        expect(stats.suggestions[0]).toMatch(/empty/i);
+    });
+    it("always returns annRecallAt10 = -1, indexAgeHours = -1, deadTupleFraction = 0", async () => {
+        const stats = await getIndexStats(makeCollection(10));
+        expect(stats.annRecallAt10).toBe(-1);
+        expect(stats.indexAgeHours).toBe(-1);
+        expect(stats.deadTupleFraction).toBe(0);
+    });
+    it("returns exactly one suggestion", async () => {
+        const stats = await getIndexStats(makeCollection(100));
+        expect(stats.suggestions).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=stats.test.js.map

package/dist/stats.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.test.js","sourceRoot":"","sources":["../src/stats.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO;QACL,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC;KACf,CAAC;AAC7B,CAAC;AAED,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,+BAA+B,EAAE,KAAK,IAAI,EAAE;QAC7C,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACnE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC9C,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/store.d.ts

@@ -0,0 +1,25 @@
+import type { VectorDocument, VectorSearchResult, VectorStore, IndexStats, QueryPerfReport } from "@vivantel/rag-core";
+export interface ChromaVectorStoreOptions {
+    path?: string;
+    collectionName?: string;
+    dimensions?: number;
+    apiKey?: string;
+}
+export declare class ChromaVectorStore implements VectorStore {
+    readonly name = "chromadb";
+    private readonly path;
+    private readonly collectionName;
+    private readonly dimensions;
+    private readonly apiKey;
+    private client;
+    private collection;
+    constructor(options: ChromaVectorStoreOptions);
+    initialize(): Promise<void>;
+    upsert(documents: VectorDocument[]): Promise<void>;
+    deleteBySourceFile(sourceFiles: string[]): Promise<void>;
+    getCurrentState(): Promise<Map<string, string>>;
+    getIndexStats(): Promise<IndexStats>;
+    getQueryPerfReport(timeframeHours: number): Promise<QueryPerfReport>;
+    search(queryEmbedding: number[], topK: number): Promise<VectorSearchResult[]>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,UAAU,EACV,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAK5B,MAAM,WAAW,wBAAwB;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD,qBAAa,iBAAkB,YAAW,WAAW;IACnD,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAc;gBAEpB,OAAO,EAAE,wBAAwB;IAOvC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlD,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IA6B/C,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAIpC,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIpE,MAAM,CACV,cAAc,EAAE,MAAM,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAgCjC"}

package/dist/store.js

@@ -0,0 +1,118 @@
+import { ChromaClient, IncludeEnum } from "chromadb";
+import { getIndexStats } from "./stats.js";
+import { getQueryPerfReport } from "./query-perf.js";
+const DEFAULT_COLLECTION = "documents";
+const DEFAULT_DIMENSIONS = 1536;
+const UPSERT_BATCH_SIZE = 100;
+const SCROLL_PAGE_SIZE = 1000;
+export class ChromaVectorStore {
+    name = "chromadb";
+    path;
+    collectionName;
+    dimensions;
+    apiKey;
+    client;
+    collection;
+    constructor(options) {
+        this.path = options.path ?? "http://localhost:8000";
+        this.collectionName = options.collectionName ?? DEFAULT_COLLECTION;
+        this.dimensions = options.dimensions ?? DEFAULT_DIMENSIONS;
+        this.apiKey = options.apiKey;
+    }
+    async initialize() {
+        this.client = new ChromaClient({
+            path: this.path,
+            auth: this.apiKey
+                ? { provider: "token", credentials: this.apiKey }
+                : undefined,
+        });
+        this.collection = await this.client.getOrCreateCollection({
+            name: this.collectionName,
+            metadata: { "hnsw:space": "cosine" },
+        });
+    }
+    async upsert(documents) {
+        for (let i = 0; i < documents.length; i += UPSERT_BATCH_SIZE) {
+            const batch = documents.slice(i, i + UPSERT_BATCH_SIZE);
+            await this.collection.upsert({
+                ids: batch.map((doc) => doc.id ?? crypto.randomUUID()),
+                embeddings: batch.map((doc) => doc.embedding),
+                documents: batch.map((doc) => doc.content),
+                metadatas: batch.map((doc) => ({
+                    source_file: doc.sourceFile,
+                    commit_hash: doc.commitHash,
+                    content_hash: doc.contentHash,
+                    ...doc.metadata,
+                })),
+            });
+        }
+    }
+    async deleteBySourceFile(sourceFiles) {
+        if (sourceFiles.length === 0)
+            return;
+        await this.collection.delete({
+            where: { source_file: { $in: sourceFiles } },
+        });
+    }
+    async getCurrentState() {
+        const state = new Map();
+        let offset = 0;
+        while (true) {
+            const result = await this.collection.get({
+                include: [IncludeEnum.Metadatas],
+                limit: SCROLL_PAGE_SIZE,
+                offset,
+            });
+            for (const meta of result.metadatas) {
+                if (!meta)
+                    continue;
+                const sourceFile = typeof meta.source_file === "string" ? meta.source_file : null;
+                const commitHash = typeof meta.commit_hash === "string" ? meta.commit_hash : null;
+                if (sourceFile && commitHash) {
+                    state.set(sourceFile, commitHash);
+                }
+            }
+            if (result.ids.length < SCROLL_PAGE_SIZE)
+                break;
+            offset += SCROLL_PAGE_SIZE;
+        }
+        return state;
+    }
+    async getIndexStats() {
+        return getIndexStats(this.collection);
+    }
+    async getQueryPerfReport(timeframeHours) {
+        return getQueryPerfReport(this.collection, this.dimensions, timeframeHours);
+    }
+    async search(queryEmbedding, topK) {
+        const result = await this.collection.query({
+            queryEmbeddings: [queryEmbedding],
+            nResults: topK,
+            include: [
+                IncludeEnum.Documents,
+                IncludeEnum.Metadatas,
+                IncludeEnum.Distances,
+            ],
+        });
+        const ids = result.ids[0] ?? [];
+        const documents = result.documents[0] ?? [];
+        const metadatas = result.metadatas[0] ?? [];
+        const distances = result.distances?.[0] ?? [];
+        return ids.map((id, i) => ({
+            id,
+            content: documents[i] ?? "",
+            metadata: (() => {
+                const meta = metadatas[i];
+                if (!meta || typeof meta !== "object")
+                    return {};
+                const { source_file, commit_hash, content_hash, ...rest } = meta;
+                void source_file;
+                void commit_hash;
+                void content_hash;
+                return rest;
+            })(),
+            similarity: 1 - (distances[i] ?? 1),
+        }));
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@vivantel/rag-store-chromadb",
+  "version": "1.2.1",
+  "description": "ChromaDB vector store for @vivantel/rag-core (local or hosted)",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "rag-plugin": {
+    "type": "vectorStore",
+    "label": "ChromaDB (local or hosted)",
+    "key": "chromadb",
+    "envVars": [],
+    "defaultConfig": {
+      "path": "http://localhost:8000"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "fix": "npm run lint:fix && npm run format"
+  },
+  "keywords": [
+    "rag",
+    "vector-store",
+    "chromadb",
+    "vector-database",
+    "semantic-search"
+  ],
+  "author": "Vivantel",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vivantel/rag_core",
+    "directory": "packages/rag-store-chromadb"
+  },
+  "dependencies": {
+    "chromadb": "^1.10.0"
+  },
+  "peerDependencies": {
+    "@vivantel/rag-core": "^2.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@vivantel/rag-core": "file:../rag-core",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}