embed-cache 0.1.0

package/README.md

@@ -0,0 +1,91 @@
+# embed-cache
+
+Content-addressable embedding cache with deduplication, LRU eviction, TTL support, and batch optimization. Zero external runtime dependencies — caller supplies the embedder function.
+
+## Install
+
+```bash
+npm install embed-cache
+```
+
+## Quick start
+
+```typescript
+import { createCache } from 'embed-cache'
+
+// Provide your own embedder function
+const cache = createCache({
+  embedder: async (texts) => {
+    // call OpenAI, Cohere, or any embedding API
+    const resp = await openai.embeddings.create({ model: 'text-embedding-3-small', input: texts })
+    return resp.data.map(d => d.embedding)
+  },
+  model: 'text-embedding-3-small',
+  maxSize: 50000,
+  ttl: 60 * 60 * 1000,  // 1 hour
+})
+
+// Single embed — repeated calls never call the embedder twice for the same text
+const vec = await cache.embed('Hello world')
+
+// Batch embed — collects all cache misses and makes ONE embedder call
+const vecs = await cache.embedBatch(['Hello', 'World', 'Hello'])
+// ^ only calls embedder with ['World'] if 'Hello' is already cached
+```
+
+## Batch optimization
+
+`embedBatch()` separates hits from misses before calling the embedder:
+
+1. Check the cache for every text in the batch.
+2. Collect all misses into a single array.
+3. Call `embedder(missTexts)` once.
+4. Store the new vectors and return the full results in original order.
+
+This minimises API calls when a batch contains repeated or previously seen texts.
+
+## Stats
+
+```typescript
+const s = cache.stats()
+console.log(s.hitRate)              // 0–1
+console.log(s.tokensEstimatedSaved) // rough token count saved via cache hits
+console.log(s.costEstimatedSaved)   // USD saved (uses modelPricePerMillion option)
+```
+
+## Change detection
+
+Track documents so you can skip re-indexing when content has not changed:
+
+```typescript
+await cache.trackDocument('doc-42', content)
+
+// later...
+if (await cache.hasChanged('doc-42', newContent)) {
+  // re-index
+  await cache.trackDocument('doc-42', newContent)
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `embedder` | `(texts: string[]) => Promise<number[][]>` | required | Embedding function |
+| `model` | `string` | required | Model identifier (used as part of cache key) |
+| `ttl` | `number` | none | Milliseconds before an entry expires |
+| `maxSize` | `number` | `10000` | Maximum number of entries (LRU eviction) |
+| `modelPricePerMillion` | `number` | `0.1` | USD per 1M tokens (for cost estimation) |
+| `algorithm` | `'sha256'\|'sha1'\|'md5'` | `'sha256'` | Hash algorithm for key derivation |
+| `normalizeText` | `boolean` | `true` | NFC + trim + collapse whitespace before hashing |
+
+## Per-call options
+
+```typescript
+await cache.embed(text, { bypassCache: true })        // always call embedder
+await cache.embed(text, { ttl: 5000 })                // override TTL for this entry
+```
+
+## License
+
+MIT

package/dist/__tests__/cache.test.d.ts

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

package/dist/__tests__/cache.test.d.ts.map

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

package/dist/__tests__/cache.test.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const cache_1 = require("../cache");
+function makeEmbedder(dim = 4) {
+    let count = 0;
+    let last = [];
+    const fn = async (texts) => {
+        count++;
+        last = texts;
+        return texts.map((t, i) => Array.from({ length: dim }, (_, j) => (i + 1) * (j + 1) + t.length * 0.001));
+    };
+    return { fn, callCount: () => count, lastInput: () => last };
+}
+(0, vitest_1.describe)('embed()', () => {
+    (0, vitest_1.it)('caches result: second call does not invoke embedder', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        const v1 = await cache.embed('hello');
+        const v2 = await cache.embed('hello');
+        (0, vitest_1.expect)(callCount()).toBe(1);
+        (0, vitest_1.expect)(v1).toEqual(v2);
+    });
+    (0, vitest_1.it)('different text triggers a cache miss', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.embed('hello');
+        await cache.embed('world');
+        (0, vitest_1.expect)(callCount()).toBe(2);
+    });
+    (0, vitest_1.it)('same text different case maps to same key when normalize=true', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model', normalizeText: true });
+        await cache.embed('  Hello  ');
+        await cache.embed('Hello');
+        // both normalize to "Hello" so second call is a hit
+        (0, vitest_1.expect)(callCount()).toBe(1);
+    });
+    (0, vitest_1.it)('bypassCache always calls embedder', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.embed('hello');
+        await cache.embed('hello', { bypassCache: true });
+        (0, vitest_1.expect)(callCount()).toBe(2);
+    });
+});
+(0, vitest_1.describe)('embedBatch()', () => {
+    (0, vitest_1.it)('collects misses: 3 texts with 1 cached → embedder called with 2 texts', async () => {
+        const { fn, callCount, lastInput } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        // pre-warm 'alpha'
+        await cache.embed('alpha');
+        (0, vitest_1.expect)(callCount()).toBe(1);
+        const results = await cache.embedBatch(['alpha', 'beta', 'gamma']);
+        (0, vitest_1.expect)(callCount()).toBe(2);
+        (0, vitest_1.expect)(lastInput()).toEqual(['beta', 'gamma']);
+        (0, vitest_1.expect)(results).toHaveLength(3);
+        (0, vitest_1.expect)(results[0]).toBeDefined();
+        (0, vitest_1.expect)(results[1]).toBeDefined();
+        (0, vitest_1.expect)(results[2]).toBeDefined();
+    });
+    (0, vitest_1.it)('bypassCache calls embedder for all texts', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.embedBatch(['a', 'b']);
+        await cache.embedBatch(['a', 'b'], { bypassCache: true });
+        (0, vitest_1.expect)(callCount()).toBe(2);
+    });
+    (0, vitest_1.it)('returns vectors in correct order', async () => {
+        const embedder = async (texts) => texts.map((t) => [t.length]);
+        const cache = (0, cache_1.createCache)({ embedder, model: 'test-model' });
+        const results = await cache.embedBatch(['ab', 'abc', 'abcd']);
+        (0, vitest_1.expect)(results[0]).toEqual([2]);
+        (0, vitest_1.expect)(results[1]).toEqual([3]);
+        (0, vitest_1.expect)(results[2]).toEqual([4]);
+    });
+});
+(0, vitest_1.describe)('stats', () => {
+    (0, vitest_1.it)('tracks hits, misses and hitRate correctly', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'my-model' });
+        await cache.embed('x'); // miss
+        await cache.embed('x'); // hit
+        await cache.embed('x'); // hit
+        await cache.embed('y'); // miss
+        const s = cache.stats();
+        (0, vitest_1.expect)(s.hits).toBe(2);
+        (0, vitest_1.expect)(s.misses).toBe(2);
+        (0, vitest_1.expect)(s.totalRequests).toBe(4);
+        (0, vitest_1.expect)(s.hitRate).toBeCloseTo(0.5);
+        (0, vitest_1.expect)(s.model).toBe('my-model');
+    });
+    (0, vitest_1.it)('reports size and token/cost estimates', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'my-model', modelPricePerMillion: 2.0 });
+        await cache.embed('hello'); // miss
+        await cache.embed('hello'); // hit — 'hello'.length / 4 = ~1 token saved
+        const s = cache.stats();
+        (0, vitest_1.expect)(s.size).toBe(1);
+        (0, vitest_1.expect)(s.tokensEstimatedSaved).toBeGreaterThan(0);
+        (0, vitest_1.expect)(s.costEstimatedSaved).toBeGreaterThan(0);
+        (0, vitest_1.expect)(typeof s.createdAt).toBe('string');
+    });
+});
+(0, vitest_1.describe)('clear()', () => {
+    (0, vitest_1.it)('resets cache entries and stats', async () => {
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.embed('hello');
+        (0, vitest_1.expect)(cache.size).toBe(1);
+        cache.clear();
+        (0, vitest_1.expect)(cache.size).toBe(0);
+        await cache.embed('hello');
+        (0, vitest_1.expect)(callCount()).toBe(2); // had to re-embed after clear
+        const s = cache.stats();
+        (0, vitest_1.expect)(s.hits).toBe(0);
+        (0, vitest_1.expect)(s.misses).toBe(1);
+    });
+});
+(0, vitest_1.describe)('hasChanged / trackDocument', () => {
+    (0, vitest_1.it)('hasChanged returns true for unseen docId', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        (0, vitest_1.expect)(await cache.hasChanged('doc-1', 'content')).toBe(true);
+    });
+    (0, vitest_1.it)('hasChanged returns false after trackDocument with same content', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.trackDocument('doc-1', 'content');
+        (0, vitest_1.expect)(await cache.hasChanged('doc-1', 'content')).toBe(false);
+    });
+    (0, vitest_1.it)('hasChanged returns true after content changes', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.trackDocument('doc-1', 'original');
+        (0, vitest_1.expect)(await cache.hasChanged('doc-1', 'modified')).toBe(true);
+    });
+});
+(0, vitest_1.describe)('size property', () => {
+    (0, vitest_1.it)('reflects number of cached entries', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        (0, vitest_1.expect)(cache.size).toBe(0);
+        await cache.embed('a');
+        (0, vitest_1.expect)(cache.size).toBe(1);
+        await cache.embed('b');
+        (0, vitest_1.expect)(cache.size).toBe(2);
+        await cache.embed('a');
+        (0, vitest_1.expect)(cache.size).toBe(2);
+    });
+});
+(0, vitest_1.describe)('serialize()', () => {
+    (0, vitest_1.it)('returns valid JSON with entries and model', async () => {
+        const { fn } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model' });
+        await cache.embed('hello');
+        const raw = cache.serialize();
+        const parsed = JSON.parse(raw);
+        (0, vitest_1.expect)(parsed.model).toBe('test-model');
+        (0, vitest_1.expect)(parsed.version).toBe(1);
+        (0, vitest_1.expect)(Array.isArray(parsed.entries)).toBe(true);
+        (0, vitest_1.expect)(parsed.entries).toHaveLength(1);
+        (0, vitest_1.expect)(parsed.entries[0]).toHaveProperty('key');
+        (0, vitest_1.expect)(Array.isArray(parsed.entries[0].vector)).toBe(true);
+    });
+});
+(0, vitest_1.describe)('LRU eviction', () => {
+    (0, vitest_1.it)('evicts least recently used entry when maxSize is exceeded', async () => {
+        const calls = [];
+        const embedder = async (texts) => {
+            calls.push(texts);
+            return texts.map(() => [1, 2, 3]);
+        };
+        const cache = (0, cache_1.createCache)({ embedder, model: 'test-model', maxSize: 2 });
+        await cache.embed('a');
+        await cache.embed('b');
+        (0, vitest_1.expect)(cache.size).toBe(2);
+        // access 'a' to make it MRU, 'b' becomes LRU
+        await cache.embed('a');
+        // adding 'c' should evict 'b'
+        await cache.embed('c');
+        (0, vitest_1.expect)(cache.size).toBe(2);
+        // 'b' was evicted so embedding it again calls embedder
+        const beforeCount = calls.length;
+        await cache.embed('b');
+        (0, vitest_1.expect)(calls.length).toBe(beforeCount + 1);
+    });
+});
+(0, vitest_1.describe)('TTL', () => {
+    (0, vitest_1.it)('entry expires after TTL and re-embeds on next call', async () => {
+        vitest_1.vi.useFakeTimers();
+        const { fn, callCount } = makeEmbedder();
+        const cache = (0, cache_1.createCache)({ embedder: fn, model: 'test-model', ttl: 100 });
+        await cache.embed('hello');
+        (0, vitest_1.expect)(callCount()).toBe(1);
+        vitest_1.vi.advanceTimersByTime(200);
+        await cache.embed('hello');
+        (0, vitest_1.expect)(callCount()).toBe(2);
+        vitest_1.vi.useRealTimers();
+    });
+});
+//# sourceMappingURL=cache.test.js.map

package/dist/__tests__/cache.test.js.map

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

package/dist/cache.d.ts

@@ -0,0 +1,3 @@
+import type { EmbedCacheOptions, EmbedCache } from './types';
+export declare function createCache(options: EmbedCacheOptions): EmbedCache;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,UAAU,EAAE,MAAM,SAAS,CAAA;AAE1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAqGlE"}

package/dist/cache.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCache = createCache;
+const store_1 = require("./store");
+const stats_1 = require("./stats");
+const key_1 = require("./key");
+function createCache(options) {
+    const store = new store_1.MemoryStore(options.maxSize ?? 10000);
+    const statsTracker = new stats_1.StatsTracker();
+    const algorithm = options.algorithm ?? 'sha256';
+    const normalize = options.normalizeText !== false;
+    const pricePerMillion = options.modelPricePerMillion ?? 0.1;
+    const docHashes = new Map();
+    function getKey(text) {
+        return (0, key_1.computeKey)(text, options.model, algorithm, normalize);
+    }
+    function estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+    return {
+        async embed(text, embedOptions) {
+            if (embedOptions?.bypassCache) {
+                const [vec] = await options.embedder([text]);
+                return vec;
+            }
+            const key = getKey(text);
+            const cached = store.get(key);
+            if (cached) {
+                statsTracker.recordHit(estimateTokens(text));
+                return cached;
+            }
+            statsTracker.recordMiss();
+            const [vec] = await options.embedder([text]);
+            store.set(key, vec, { ttl: embedOptions?.ttl ?? options.ttl });
+            return store.get(key) ?? vec;
+        },
+        async embedBatch(texts, embedOptions) {
+            if (embedOptions?.bypassCache) {
+                return options.embedder(texts);
+            }
+            const results = new Array(texts.length);
+            const missIndices = [];
+            const missTexts = [];
+            for (let i = 0; i < texts.length; i++) {
+                const key = getKey(texts[i]);
+                const cached = store.get(key);
+                if (cached) {
+                    results[i] = cached;
+                    statsTracker.recordHit(estimateTokens(texts[i]));
+                }
+                else {
+                    missIndices.push(i);
+                    missTexts.push(texts[i]);
+                    statsTracker.recordMiss();
+                }
+            }
+            if (missTexts.length > 0) {
+                const newVectors = await options.embedder(missTexts);
+                for (let j = 0; j < missIndices.length; j++) {
+                    const i = missIndices[j];
+                    store.set(getKey(texts[i]), newVectors[j], { ttl: embedOptions?.ttl ?? options.ttl });
+                    results[i] = store.get(getKey(texts[i])) ?? newVectors[j];
+                }
+            }
+            return results;
+        },
+        async hasChanged(docId, content) {
+            const newHash = (0, key_1.computeKey)(content, 'doc', 'sha256', normalize);
+            const oldHash = docHashes.get(docId);
+            return oldHash !== newHash;
+        },
+        async trackDocument(docId, content) {
+            const hash = (0, key_1.computeKey)(content, 'doc', 'sha256', normalize);
+            docHashes.set(docId, hash);
+        },
+        stats() {
+            return statsTracker.get(options.model, store.size(), pricePerMillion);
+        },
+        serialize() {
+            const entries = [];
+            for (const key of store.keys()) {
+                const v = store.get(key);
+                if (v)
+                    entries.push({ key, vector: v });
+            }
+            return JSON.stringify({ entries, model: options.model, version: 1 });
+        },
+        clear() {
+            store.clear();
+            statsTracker.reset();
+        },
+        get size() {
+            return store.size();
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createCache } from './cache';
+export type { EmbedderFn, EmbedCacheOptions, EmbedOptions, CacheStats, EmbedCache } from './types';
+//# 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AACrC,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCache = void 0;
+// embed-cache - Content-addressable embedding cache with deduplication and TTL
+var cache_1 = require("./cache");
+Object.defineProperty(exports, "createCache", { enumerable: true, get: function () { return cache_1.createCache; } });
+//# 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,+EAA+E;AAC/E,iCAAqC;AAA5B,oGAAA,WAAW,OAAA"}

package/dist/key.d.ts

@@ -0,0 +1,2 @@
+export declare function computeKey(text: string, model: string, algorithm: 'sha256' | 'sha1' | 'md5', normalize: boolean): string;
+//# sourceMappingURL=key.d.ts.map

package/dist/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../src/key.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,EACpC,SAAS,EAAE,OAAO,GACjB,MAAM,CAKR"}

package/dist/key.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeKey = computeKey;
+const crypto_1 = require("crypto");
+const normalize_1 = require("./normalize");
+function computeKey(text, model, algorithm, normalize) {
+    const normalizedText = normalize ? (0, normalize_1.normalizeText)(text) : text;
+    const canonicalModel = (0, normalize_1.canonicalizeModel)(model);
+    const input = `${normalizedText}\x00${canonicalModel}`;
+    return (0, crypto_1.createHash)(algorithm).update(input, 'utf8').digest('hex');
+}
+//# sourceMappingURL=key.js.map

package/dist/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../src/key.ts"],"names":[],"mappings":";;AAGA,gCAUC;AAbD,mCAAmC;AACnC,2CAA8D;AAE9D,SAAgB,UAAU,CACxB,IAAY,EACZ,KAAa,EACb,SAAoC,EACpC,SAAkB;IAElB,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,CAAC,IAAA,yBAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IAC7D,MAAM,cAAc,GAAG,IAAA,6BAAiB,EAAC,KAAK,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAG,GAAG,cAAc,OAAO,cAAc,EAAE,CAAA;IACtD,OAAO,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAClE,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizeText(text: string): string;
+export declare function canonicalizeModel(model: string): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD"}

package/dist/normalize.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeText = normalizeText;
+exports.canonicalizeModel = canonicalizeModel;
+function normalizeText(text) {
+    return text.normalize('NFC').trim().replace(/\s+/g, ' ');
+}
+function canonicalizeModel(model) {
+    const KNOWN = {
+        'text-embedding-3-small': 'openai/text-embedding-3-small',
+        'text-embedding-3-large': 'openai/text-embedding-3-large',
+        'text-embedding-ada-002': 'openai/text-embedding-ada-002',
+        'embed-english-v3.0': 'cohere/embed-english-v3.0',
+        'embed-multilingual-v3.0': 'cohere/embed-multilingual-v3.0',
+    };
+    return KNOWN[model] ?? model.toLowerCase();
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":";;AAAA,sCAEC;AAED,8CASC;AAbD,SAAgB,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAC1D,CAAC;AAED,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,KAAK,GAA2B;QACpC,wBAAwB,EAAE,+BAA+B;QACzD,wBAAwB,EAAE,+BAA+B;QACzD,wBAAwB,EAAE,+BAA+B;QACzD,oBAAoB,EAAE,2BAA2B;QACjD,yBAAyB,EAAE,gCAAgC;KAC5D,CAAA;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAA;AAC5C,CAAC"}

package/dist/stats.d.ts

@@ -0,0 +1,13 @@
+import type { CacheStats } from './types';
+export declare class StatsTracker {
+    private _hits;
+    private _misses;
+    private _totalRequests;
+    private _tokensEstimated;
+    private createdAt;
+    recordHit(estimatedTokens: number): void;
+    recordMiss(): void;
+    get(model: string, size: number, pricePerMillion: number): CacheStats;
+    reset(): void;
+}
+//# 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,SAAS,CAAA;AAEzC,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,OAAO,CAAI;IACnB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,SAAS,CAA2B;IAE5C,SAAS,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAMxC,UAAU,IAAI,IAAI;IAKlB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,UAAU;IAcrE,KAAK,IAAI,IAAI;CAMd"}

package/dist/stats.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatsTracker = void 0;
+class StatsTracker {
+    _hits = 0;
+    _misses = 0;
+    _totalRequests = 0;
+    _tokensEstimated = 0;
+    createdAt = new Date().toISOString();
+    recordHit(estimatedTokens) {
+        this._hits++;
+        this._totalRequests++;
+        this._tokensEstimated += estimatedTokens;
+    }
+    recordMiss() {
+        this._misses++;
+        this._totalRequests++;
+    }
+    get(model, size, pricePerMillion) {
+        return {
+            totalRequests: this._totalRequests,
+            hits: this._hits,
+            misses: this._misses,
+            hitRate: this._totalRequests > 0 ? this._hits / this._totalRequests : 0,
+            size,
+            tokensEstimatedSaved: this._tokensEstimated,
+            costEstimatedSaved: (this._tokensEstimated / 1_000_000) * pricePerMillion,
+            model,
+            createdAt: this.createdAt,
+        };
+    }
+    reset() {
+        this._hits = 0;
+        this._misses = 0;
+        this._totalRequests = 0;
+        this._tokensEstimated = 0;
+    }
+}
+exports.StatsTracker = StatsTracker;
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":";;;AAEA,MAAa,YAAY;IACf,KAAK,GAAG,CAAC,CAAA;IACT,OAAO,GAAG,CAAC,CAAA;IACX,cAAc,GAAG,CAAC,CAAA;IAClB,gBAAgB,GAAG,CAAC,CAAA;IACpB,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAE5C,SAAS,CAAC,eAAuB;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,IAAI,CAAC,cAAc,EAAE,CAAA;QACrB,IAAI,CAAC,gBAAgB,IAAI,eAAe,CAAA;IAC1C,CAAC;IAED,UAAU;QACR,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,IAAI,CAAC,cAAc,EAAE,CAAA;IACvB,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,IAAY,EAAE,eAAuB;QACtD,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,cAAc;YAClC,IAAI,EAAE,IAAI,CAAC,KAAK;YAChB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,OAAO,EAAE,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;YACvE,IAAI;YACJ,oBAAoB,EAAE,IAAI,CAAC,gBAAgB;YAC3C,kBAAkB,EAAE,CAAC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,GAAG,eAAe;YACzE,KAAK;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAA;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,CAAC,CAAA;QACd,IAAI,CAAC,OAAO,GAAG,CAAC,CAAA;QAChB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAA;QACvB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAA;IAC3B,CAAC;CACF;AAtCD,oCAsCC"}

package/dist/store.d.ts

@@ -0,0 +1,22 @@
+export declare class MemoryStore {
+    private maxSize;
+    private entries;
+    private nodes;
+    private head;
+    private tail;
+    constructor(maxSize: number);
+    get(key: string): number[] | null;
+    set(key: string, vector: number[], options?: {
+        ttl?: number;
+    }): void;
+    has(key: string): boolean;
+    delete(key: string): void;
+    clear(): void;
+    size(): number;
+    keys(): string[];
+    private addToFront;
+    private removeNode;
+    private moveToFront;
+    private evictLRU;
+}
+//# 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":"AAWA,qBAAa,WAAW;IAMV,OAAO,CAAC,OAAO;IAL3B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,IAAI,CAAsB;gBAEd,OAAO,EAAE,MAAM;IAEnC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAYjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAgBpE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,MAAM;IAId,IAAI,IAAI,MAAM,EAAE;IAIhB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,UAAU;IAkBlB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,QAAQ;CAMjB"}

package/dist/store.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+class MemoryStore {
+    maxSize;
+    entries = new Map();
+    nodes = new Map();
+    head = null; // MRU
+    tail = null; // LRU
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const entry = this.entries.get(key);
+        if (!entry)
+            return null;
+        if (entry.ttl != null && Date.now() > entry.createdAt + entry.ttl) {
+            this.removeNode(key);
+            this.entries.delete(key);
+            return null;
+        }
+        this.moveToFront(key);
+        return Array.from(entry.vector);
+    }
+    set(key, vector, options) {
+        if (this.entries.has(key)) {
+            this.moveToFront(key);
+            return;
+        }
+        if (this.entries.size >= this.maxSize) {
+            this.evictLRU();
+        }
+        this.entries.set(key, {
+            vector: new Float32Array(vector),
+            createdAt: Date.now(),
+            ttl: options?.ttl,
+        });
+        this.addToFront(key);
+    }
+    has(key) {
+        return this.get(key) !== null;
+    }
+    delete(key) {
+        this.removeNode(key);
+        this.entries.delete(key);
+    }
+    clear() {
+        this.entries.clear();
+        this.nodes.clear();
+        this.head = null;
+        this.tail = null;
+    }
+    size() {
+        return this.entries.size;
+    }
+    keys() {
+        return Array.from(this.entries.keys());
+    }
+    addToFront(key) {
+        const node = { prev: null, next: this.head };
+        this.nodes.set(key, node);
+        if (this.head !== null) {
+            const headNode = this.nodes.get(this.head);
+            if (headNode)
+                headNode.prev = key;
+        }
+        this.head = key;
+        if (this.tail === null) {
+            this.tail = key;
+        }
+    }
+    removeNode(key) {
+        const node = this.nodes.get(key);
+        if (!node)
+            return;
+        if (node.prev !== null) {
+            const prevNode = this.nodes.get(node.prev);
+            if (prevNode)
+                prevNode.next = node.next;
+        }
+        else {
+            this.head = node.next;
+        }
+        if (node.next !== null) {
+            const nextNode = this.nodes.get(node.next);
+            if (nextNode)
+                nextNode.prev = node.prev;
+        }
+        else {
+            this.tail = node.prev;
+        }
+        this.nodes.delete(key);
+    }
+    moveToFront(key) {
+        if (this.head === key)
+            return;
+        this.removeNode(key);
+        this.addToFront(key);
+    }
+    evictLRU() {
+        if (this.tail === null)
+            return;
+        const lruKey = this.tail;
+        this.removeNode(lruKey);
+        this.entries.delete(lruKey);
+    }
+}
+exports.MemoryStore = MemoryStore;
+//# 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/dist/types.d.ts

@@ -0,0 +1,36 @@
+export type EmbedderFn = (texts: string[]) => Promise<number[][]>;
+export interface EmbedCacheOptions {
+    embedder: EmbedderFn;
+    model: string;
+    ttl?: number;
+    maxSize?: number;
+    modelPricePerMillion?: number;
+    algorithm?: 'sha256' | 'sha1' | 'md5';
+    normalizeText?: boolean;
+}
+export interface EmbedOptions {
+    ttl?: number;
+    bypassCache?: boolean;
+}
+export interface CacheStats {
+    totalRequests: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    size: number;
+    tokensEstimatedSaved: number;
+    costEstimatedSaved: number;
+    model: string;
+    createdAt: string;
+}
+export interface EmbedCache {
+    embed(text: string, options?: EmbedOptions): Promise<number[]>;
+    embedBatch(texts: string[], options?: EmbedOptions): Promise<number[][]>;
+    hasChanged(docId: string, content: string): Promise<boolean>;
+    trackDocument(docId: string, content: string): Promise<void>;
+    stats(): CacheStats;
+    serialize(): string;
+    clear(): void;
+    readonly size: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAEjE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,UAAU,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAA;IACrC,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB,EAAE,MAAM,CAAA;IAC5B,kBAAkB,EAAE,MAAM,CAAA;IAC1B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAC9D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IACxE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5D,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,KAAK,IAAI,UAAU,CAAA;IACnB,SAAS,IAAI,MAAM,CAAA;IACnB,KAAK,IAAI,IAAI,CAAA;IACb,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "embed-cache",
+  "version": "0.1.0",
+  "description": "Content-addressable embedding cache with deduplication and TTL",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^10.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}