@effect-native/fetch-hooks 0.0.1-placeholder → 0.0.2

package/dist/filesystem-storage.d.ts

@@ -0,0 +1,10 @@
+import type { CacheKey, CacheStorage, KV, KVStream, TimedChunk } from "./types.js";
+/** Create a KV store backed by JSON files */
+export declare function createJsonFileKV<T>(baseDir: string, filename: string): KV<CacheKey, T>;
+/** Create a KV store backed by binary files */
+export declare function createBinaryFileKV(baseDir: string, filename: string): KV<CacheKey, Uint8Array>;
+/** Create a streaming KV store for SSE chunks backed by JSONL files */
+export declare function createJsonlFileKVStream(baseDir: string, filename: string): KVStream<CacheKey, TimedChunk>;
+/** Create a complete CacheStorage backed by the filesystem */
+export declare function createFilesystemStorage(baseDir: string): CacheStorage;
+//# sourceMappingURL=filesystem-storage.d.ts.map

package/dist/filesystem-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-storage.d.ts","sourceRoot":"","sources":["../src/filesystem-storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqC,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAqBrH,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAsBtF;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAsB9F;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAyCzG;AAED,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAQrE"}

package/dist/filesystem-storage.js

@@ -0,0 +1,112 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { jsonlToTimedChunks, timedChunksToJsonl } from "./sse-handler.js";
+function ensureCacheDir(baseDir, cacheKey) {
+    const cacheDir = join(baseDir, cacheKey);
+    if (!existsSync(cacheDir)) {
+        try {
+            mkdirSync(cacheDir, { recursive: true });
+        }
+        catch (error) {
+            // Handle race condition where directory was created between check and mkdir
+            if (!(error instanceof Error && error.code === "EEXIST")) {
+                throw error;
+            }
+        }
+    }
+    return cacheDir;
+}
+/** Create a KV store backed by JSON files */
+export function createJsonFileKV(baseDir, filename) {
+    return {
+        async get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return null;
+            }
+            const content = readFileSync(filePath, "utf-8");
+            return JSON.parse(content);
+        },
+        async set([key], value) {
+            const cacheDir = ensureCacheDir(baseDir, key);
+            const filePath = join(cacheDir, filename);
+            writeFileSync(filePath, JSON.stringify(value, null, 2), "utf-8");
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a KV store backed by binary files */
+export function createBinaryFileKV(baseDir, filename) {
+    return {
+        async get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return null;
+            }
+            const buffer = readFileSync(filePath);
+            return new Uint8Array(buffer);
+        },
+        async set([key], value) {
+            const cacheDir = ensureCacheDir(baseDir, key);
+            const filePath = join(cacheDir, filename);
+            writeFileSync(filePath, value);
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a streaming KV store for SSE chunks backed by JSONL files */
+export function createJsonlFileKVStream(baseDir, filename) {
+    return {
+        async *get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return;
+            }
+            // Read entire file and parse - streaming line-by-line is complex due to JSONL format
+            // Future optimization: could stream lines and parse incrementally
+            const content = readFileSync(filePath, "utf-8");
+            const chunks = jsonlToTimedChunks(content);
+            for (const chunk of chunks) {
+                yield chunk;
+            }
+        },
+        async set([key], values) {
+            const cacheDir = ensureCacheDir(baseDir, key);
+            const filePath = join(cacheDir, filename);
+            // Collect all values if async iterable
+            let chunks;
+            if (Array.isArray(values)) {
+                chunks = values;
+            }
+            else {
+                chunks = [];
+                for await (const chunk of values) {
+                    chunks.push(chunk);
+                }
+            }
+            const jsonl = timedChunksToJsonl(chunks);
+            writeFileSync(filePath, jsonl, "utf-8");
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a complete CacheStorage backed by the filesystem */
+export function createFilesystemStorage(baseDir) {
+    return {
+        requests: createJsonFileKV(baseDir, "request.json"),
+        responseMeta: createJsonFileKV(baseDir, "response.meta.json"),
+        responseBody: createJsonFileKV(baseDir, "response.json"),
+        binaryBody: createBinaryFileKV(baseDir, "response.bin"),
+        sseChunks: createJsonlFileKVStream(baseDir, "response.jsonl")
+    };
+}
+//# sourceMappingURL=filesystem-storage.js.map

package/dist/filesystem-storage.js.map

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

package/dist/flat-file-storage.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Flat file storage - stores cache files in subdirectories named by the key.
+ * Each key gets its own folder with standard cache filenames inside:
+ *   baseDir/001/request.json
+ *   baseDir/001/response.meta.json
+ *   baseDir/001/response.jsonl
+ *   baseDir/002/request.json
+ *   ...
+ *
+ * This is similar to filesystem-storage but the key IS the subdirectory name
+ * (no hashing), making it suitable for conversation turn folders.
+ */
+import type { CacheKey, CacheStorage, KV, KVStream, TimedChunk } from "./types.js";
+/** Create a KV store backed by JSON files in subdirectories: baseDir/{key}/{filename} */
+export declare function createFlatJsonFileKV<T>(baseDir: string, filename: string): KV<CacheKey, T>;
+/** Create a KV store backed by plain text files in subdirectories (no JSON serialization) */
+export declare function createFlatTextFileKV(baseDir: string, filename: string): KV<CacheKey, string>;
+/** Create a KV store backed by binary files in subdirectories */
+export declare function createFlatBinaryFileKV(baseDir: string, filename: string): KV<CacheKey, Uint8Array>;
+/** Create a streaming KV store for SSE chunks in subdirectories */
+export declare function createFlatJsonlFileKVStream(baseDir: string, filename: string): KVStream<CacheKey, TimedChunk>;
+/**
+ * Create a CacheStorage that stores files in subdirectories named by the key.
+ *
+ * @example
+ * const storage = createFlatFileStorage("/path/to/conversation")
+ * // With transformCacheKey returning "001", files will be:
+ * //   /path/to/conversation/001/request.json
+ * //   /path/to/conversation/001/response.meta.json
+ * //   /path/to/conversation/001/response.jsonl
+ */
+export declare function createFlatFileStorage(baseDir: string): CacheStorage;
+//# sourceMappingURL=flat-file-storage.d.ts.map

package/dist/flat-file-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat-file-storage.d.ts","sourceRoot":"","sources":["../src/flat-file-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAqC,QAAQ,EAAE,YAAY,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAkBrH,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAuB1F;AAED,6FAA6F;AAC7F,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAsB5F;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,CAuBlG;AAED,mEAAmE;AACnE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,CAuC7G;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CASnE"}

package/dist/flat-file-storage.js

@@ -0,0 +1,153 @@
+/**
+ * Flat file storage - stores cache files in subdirectories named by the key.
+ * Each key gets its own folder with standard cache filenames inside:
+ *   baseDir/001/request.json
+ *   baseDir/001/response.meta.json
+ *   baseDir/001/response.jsonl
+ *   baseDir/002/request.json
+ *   ...
+ *
+ * This is similar to filesystem-storage but the key IS the subdirectory name
+ * (no hashing), making it suitable for conversation turn folders.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { jsonlToTimedChunks, timedChunksToJsonl } from "./sse-handler.js";
+function ensureDir(dir) {
+    if (!existsSync(dir)) {
+        try {
+            mkdirSync(dir, { recursive: true });
+        }
+        catch (error) {
+            if (!(error instanceof Error && error.code === "EEXIST")) {
+                throw error;
+            }
+        }
+    }
+}
+/** Create a KV store backed by JSON files in subdirectories: baseDir/{key}/{filename} */
+export function createFlatJsonFileKV(baseDir, filename) {
+    return {
+        async get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return null;
+            }
+            const content = readFileSync(filePath, "utf-8");
+            return JSON.parse(content);
+        },
+        async set([key], value) {
+            const dir = join(baseDir, key);
+            ensureDir(dir);
+            const filePath = join(dir, filename);
+            writeFileSync(filePath, JSON.stringify(value, null, 2), "utf-8");
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a KV store backed by plain text files in subdirectories (no JSON serialization) */
+export function createFlatTextFileKV(baseDir, filename) {
+    return {
+        async get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return null;
+            }
+            return readFileSync(filePath, "utf-8");
+        },
+        async set([key], value) {
+            const dir = join(baseDir, key);
+            ensureDir(dir);
+            const filePath = join(dir, filename);
+            writeFileSync(filePath, value, "utf-8");
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a KV store backed by binary files in subdirectories */
+export function createFlatBinaryFileKV(baseDir, filename) {
+    return {
+        async get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return null;
+            }
+            const buffer = readFileSync(filePath);
+            return new Uint8Array(buffer);
+        },
+        async set([key], value) {
+            const dir = join(baseDir, key);
+            ensureDir(dir);
+            const filePath = join(dir, filename);
+            writeFileSync(filePath, value);
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/** Create a streaming KV store for SSE chunks in subdirectories */
+export function createFlatJsonlFileKVStream(baseDir, filename) {
+    return {
+        async *get([key]) {
+            const filePath = join(baseDir, key, filename);
+            if (!existsSync(filePath)) {
+                return;
+            }
+            const content = readFileSync(filePath, "utf-8");
+            const chunks = jsonlToTimedChunks(content);
+            for (const chunk of chunks) {
+                yield chunk;
+            }
+        },
+        async set([key], values) {
+            const dir = join(baseDir, key);
+            ensureDir(dir);
+            const filePath = join(dir, filename);
+            let chunks;
+            if (Array.isArray(values)) {
+                chunks = values;
+            }
+            else {
+                chunks = [];
+                for await (const chunk of values) {
+                    chunks.push(chunk);
+                }
+            }
+            const jsonl = timedChunksToJsonl(chunks);
+            writeFileSync(filePath, jsonl, "utf-8");
+        },
+        async has([key]) {
+            const filePath = join(baseDir, key, filename);
+            return existsSync(filePath);
+        }
+    };
+}
+/**
+ * Create a CacheStorage that stores files in subdirectories named by the key.
+ *
+ * @example
+ * const storage = createFlatFileStorage("/path/to/conversation")
+ * // With transformCacheKey returning "001", files will be:
+ * //   /path/to/conversation/001/request.json
+ * //   /path/to/conversation/001/response.meta.json
+ * //   /path/to/conversation/001/response.jsonl
+ */
+export function createFlatFileStorage(baseDir) {
+    return {
+        requests: createFlatJsonFileKV(baseDir, "request.json"),
+        responseMeta: createFlatJsonFileKV(baseDir, "response.meta.json"),
+        // Use text storage for responseBody to preserve raw JSON without double-escaping
+        responseBody: createFlatTextFileKV(baseDir, "response.json"),
+        binaryBody: createFlatBinaryFileKV(baseDir, "response.bin"),
+        sseChunks: createFlatJsonlFileKVStream(baseDir, "response.jsonl")
+    };
+}
+//# sourceMappingURL=flat-file-storage.js.map

package/dist/flat-file-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flat-file-storage.js","sourceRoot":"","sources":["../src/flat-file-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAEzE,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACpF,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,oBAAoB,CAAI,OAAe,EAAE,QAAgB;IACvE,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAA;QACjC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW,EAAE,KAAQ;YACjC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC9B,SAAS,CAAC,GAAG,CAAC,CAAA;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YACpC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;QAClE,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,oBAAoB,CAAC,OAAe,EAAE,QAAgB;IACpE,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAA;YACb,CAAC;YACD,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACxC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW,EAAE,KAAa;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC9B,SAAS,CAAC,GAAG,CAAC,CAAA;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YACpC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QACzC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,QAAgB;IACtE,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAO,IAAI,CAAA;YACb,CAAC;YACD,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;YACrC,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAA;QAC/B,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW,EAAE,KAAiB;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC9B,SAAS,CAAC,GAAG,CAAC,CAAA;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YACpC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QAChC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,2BAA2B,CAAC,OAAe,EAAE,QAAgB;IAC3E,OAAO;QACL,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,OAAM;YACR,CAAC;YAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAC/C,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAA;YAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,CAAA;YACb,CAAC;QACH,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW,EAAE,MAAqD;YAC9E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAA;YAC9B,SAAS,CAAC,GAAG,CAAC,CAAA;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAEpC,IAAI,MAAyB,CAAA;YAC7B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,MAAM,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,EAAE,CAAA;gBACX,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;oBACjC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC;YAED,MAAM,KAAK,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;YACxC,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAA;QACzC,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAW;YACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC7C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAA;QAC7B,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,QAAQ,EAAE,oBAAoB,CAAgB,OAAO,EAAE,cAAc,CAAC;QACtE,YAAY,EAAE,oBAAoB,CAAqB,OAAO,EAAE,oBAAoB,CAAC;QACrF,iFAAiF;QACjF,YAAY,EAAE,oBAAoB,CAAC,OAAO,EAAE,eAAe,CAAC;QAC5D,UAAU,EAAE,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC;QAC3D,SAAS,EAAE,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,CAAC;KAClE,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { CacheOptions } from "./types.js";
+export type { CacheKey, CacheOptions, CacheStorage, GeneratorTransformHook, HashableRequest, KV, KVStream, StorableResponse, TimedChunk, TransformHook } from "./types.js";
+export { createFilesystemStorage } from "./filesystem-storage.js";
+export { createFlatFileStorage } from "./flat-file-storage.js";
+export declare function createCachedFetch(baseFetch: typeof globalThis.fetch, options?: CacheOptions): (input: Request | string | URL, init?: RequestInit) => Promise<Response>;
+export declare function enableDevFetchCache(options?: CacheOptions): void;
+export declare function disableDevFetchCache(): void;
+export declare function isDevFetchCacheEnabled(): boolean;
+//# 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,KAAK,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAA;AAc5D,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,EAAE,EACF,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAsF9D,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,YAAY,IAYxD,OAAO,OAAO,GAAG,MAAM,GAAG,GAAG,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,QAAQ,CAAC,CAkFxG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAwBhE;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAO3C;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}

package/dist/index.js

@@ -0,0 +1,183 @@
+import { getCachedResponse, getCacheKeyFromUrl, setInternalFetchForCache, storeRequest, storeResponse } from "./cache-manager.js";
+import { getCacheDir, isCacheEnabled, isProduction, isReplayOnly } from "./environment.js";
+import { createFilesystemStorage } from "./filesystem-storage.js";
+import { hashRequest, headersToRecord } from "./request-hasher.js";
+// Export storage factories for custom implementations
+export { createFilesystemStorage } from "./filesystem-storage.js";
+export { createFlatFileStorage } from "./flat-file-storage.js";
+const CACHE_ENABLED_BANNER = `
+╔══════════════════════════════════════════════════════════════╗
+║  DEV-FETCH-CACHE ENABLED                                     ║
+║  Responses are being cached/replayed from .cache/fetch/      ║
+║  To disable: DEV_FETCH_CACHE=0 or --no-fetch-cache           ║
+╚══════════════════════════════════════════════════════════════╝
+`;
+let originalFetch = null;
+function getUrlFromInput(input) {
+    if (typeof input === "string") {
+        return input;
+    }
+    if (input instanceof URL) {
+        return input.href;
+    }
+    return input.url;
+}
+function normalizeHeadersInit(headersInit) {
+    if (!headersInit) {
+        return {};
+    }
+    if (headersInit instanceof Headers) {
+        return headersToRecord(headersInit);
+    }
+    if (Array.isArray(headersInit)) {
+        return Object.fromEntries(headersInit);
+    }
+    return headersInit;
+}
+async function extractBodyInit(bodyInit) {
+    if (!bodyInit) {
+        return undefined;
+    }
+    if (typeof bodyInit === "string") {
+        return bodyInit;
+    }
+    if (bodyInit instanceof URLSearchParams) {
+        return bodyInit.toString();
+    }
+    if (bodyInit instanceof Blob) {
+        return bodyInit.text();
+    }
+    if (bodyInit instanceof FormData) {
+        const pairs = [];
+        for (const [key, value] of bodyInit.entries()) {
+            // FormDataEntryValue can be File or string; File needs to be converted to string
+            const stringValue = typeof value === "string" ? value : value.name;
+            pairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(stringValue)}`);
+        }
+        return pairs.join("&");
+    }
+    if (bodyInit instanceof ArrayBuffer) {
+        return new TextDecoder().decode(bodyInit);
+    }
+    if (ArrayBuffer.isView(bodyInit)) {
+        return new TextDecoder().decode(new Uint8Array(bodyInit.buffer, bodyInit.byteOffset, bodyInit.byteLength));
+    }
+    if (bodyInit instanceof ReadableStream) {
+        const reader = bodyInit.getReader();
+        const chunks = [];
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            if (value)
+                chunks.push(value);
+        }
+        const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+        const combined = new Uint8Array(totalLength);
+        let offset = 0;
+        for (const chunk of chunks) {
+            combined.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return new TextDecoder().decode(combined);
+    }
+    return undefined;
+}
+/** Default identity transform hook */
+const identity = (value) => value;
+export function createCachedFetch(baseFetch, options) {
+    const replayOnly = options?.replayOnly ?? isReplayOnly();
+    const beforeHash = options?.beforeHash ?? identity;
+    const beforeStoreRequest = options?.beforeStoreRequest ?? identity;
+    const transformCacheKey = options?.transformCacheKey ?? ((key) => key);
+    // Create or use provided storage
+    const storage = options?.storage ?? createFilesystemStorage(getCacheDir());
+    // Set internal fetch for dev-fs-logs communication (defaults to baseFetch)
+    setInternalFetchForCache(options?.internalFetch ?? baseFetch);
+    return async function cachedFetch(input, init) {
+        if (isProduction()) {
+            return baseFetch(input, init);
+        }
+        const url = getUrlFromInput(input);
+        // Skip caching for localhost requests (including dev-fs-logs on port 1090)
+        if (url.includes("localhost") || url.includes("127.0.0.1")) {
+            return baseFetch(input, init);
+        }
+        const method = init?.method ?? (typeof input === "object" && "method" in input ? input.method : "GET");
+        const cacheKeyFromUrl = getCacheKeyFromUrl(url);
+        if (cacheKeyFromUrl) {
+            const cached = await getCachedResponse(cacheKeyFromUrl, options?.afterLoadResponse, options?.transformSSEChunk, storage);
+            if (cached) {
+                return cached;
+            }
+            return new Response("Cache entry not found", {
+                status: 404
+            });
+        }
+        const headersInit = init?.headers ?? (typeof input === "object" && "headers" in input ? input.headers : undefined);
+        const headers = normalizeHeadersInit(headersInit);
+        let body;
+        // Extract body from Request object or init
+        if (input instanceof Request && input.body) {
+            // Clone the request so we can read the body without consuming the original
+            const clonedRequest = input.clone();
+            body = await extractBodyInit(clonedRequest.body);
+        }
+        else if (init?.body !== null && init?.body !== undefined) {
+            body = await extractBodyInit(init.body);
+        }
+        // Apply beforeHash transform to affect cache key generation, then transformCacheKey for custom prefixes/suffixes
+        const hashableRequest = await beforeHash({ url, method, headers, body });
+        const cacheKey = transformCacheKey(hashRequest(hashableRequest), hashableRequest);
+        const cached = await getCachedResponse(cacheKey, options?.afterLoadResponse, options?.transformSSEChunk, storage);
+        if (cached) {
+            return cached;
+        }
+        if (replayOnly) {
+            return new Response("Cache miss in replay-only mode", {
+                status: 503
+            });
+        }
+        const requestToStore = await beforeStoreRequest({ url, method, headers, body });
+        await storeRequest({
+            url: requestToStore.url,
+            method: requestToStore.method,
+            headers: requestToStore.headers,
+            body: requestToStore.body
+        }, cacheKey, options?.beforeStoreRequest !== undefined, // skip header filtering if hook provided
+        storage, hashableRequest);
+        const response = await baseFetch(input, init);
+        return storeResponse(cacheKey, response, options?.beforeStoreResponse, storage, hashableRequest);
+    };
+}
+export function enableDevFetchCache(options) {
+    if (isProduction()) {
+        return;
+    }
+    if (!isCacheEnabled()) {
+        return;
+    }
+    if (originalFetch !== null) {
+        return;
+    }
+    originalFetch = globalThis.fetch;
+    const cachedFetch = createCachedFetch(originalFetch, {
+        ...options,
+        internalFetch: options?.internalFetch ?? originalFetch
+    });
+    // Cast to typeof fetch to include preconnect method
+    globalThis.fetch = cachedFetch;
+    // biome-ignore lint/suspicious/noConsole: Banner display is intentional for dev tooling
+    console.info(CACHE_ENABLED_BANNER);
+}
+export function disableDevFetchCache() {
+    if (originalFetch === null) {
+        return;
+    }
+    globalThis.fetch = originalFetch;
+    originalFetch = null;
+}
+export function isDevFetchCacheEnabled() {
+    return originalFetch !== null;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC1F,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAgBlE,sDAAsD;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,MAAM,oBAAoB,GAAG;;;;;;CAM5B,CAAA;AAED,IAAI,aAAa,GAAmC,IAAI,CAAA;AAExD,SAAS,eAAe,CAAC,KAA6B;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAA;IACd,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,IAAI,CAAA;IACnB,CAAC;IACD,OAAO,KAAK,CAAC,GAAG,CAAA;AAClB,CAAC;AAED,SAAS,oBAAoB,CAAC,WAAoB;IAChD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,EAAE,CAAA;IACX,CAAC;IACD,IAAI,WAAW,YAAY,OAAO,EAAE,CAAC;QACnC,OAAO,eAAe,CAAC,WAAW,CAAC,CAAA;IACrC,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;IACxC,CAAC;IACD,OAAO,WAAqC,CAAA;AAC9C,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAA6B;IAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,IAAI,QAAQ,YAAY,eAAe,EAAE,CAAC;QACxC,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAC5B,CAAC;IACD,IAAI,QAAQ,YAAY,IAAI,EAAE,CAAC;QAC7B,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;IACxB,CAAC;IACD,IAAI,QAAQ,YAAY,QAAQ,EAAE,CAAC;QACjC,MAAM,KAAK,GAAkB,EAAE,CAAA;QAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,iFAAiF;YACjF,MAAM,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAA;YAClE,KAAK,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,WAAW,CAAC,EAAE,CAAC,CAAA;QAC7E,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACxB,CAAC;IACD,IAAI,QAAQ,YAAY,WAAW,EAAE,CAAC;QACpC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC;IACD,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAA;IAC5G,CAAC;IACD,IAAI,QAAQ,YAAY,cAAc,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;QACnC,MAAM,MAAM,GAAsB,EAAE,CAAA;QACpC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,IAAI,IAAI;gBAAE,MAAK;YACf,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/B,CAAC;QACD,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACxE,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAA;QAC5C,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;YAC3B,MAAM,IAAI,KAAK,CAAC,MAAM,CAAA;QACxB,CAAC;QACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3C,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,sCAAsC;AACtC,MAAM,QAAQ,GAAG,CAAI,KAAQ,EAAK,EAAE,CAAC,KAAK,CAAA;AAE1C,MAAM,UAAU,iBAAiB,CAAC,SAAkC,EAAE,OAAsB;IAC1F,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,YAAY,EAAE,CAAA;IACxD,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,QAAQ,CAAA;IAClD,MAAM,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,IAAI,QAAQ,CAAA;IAClE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAA;IAE9E,iCAAiC;IACjC,MAAM,OAAO,GAAiB,OAAO,EAAE,OAAO,IAAI,uBAAuB,CAAC,WAAW,EAAE,CAAC,CAAA;IAExF,2EAA2E;IAC3E,wBAAwB,CAAC,OAAO,EAAE,aAAa,IAAI,SAAS,CAAC,CAAA;IAE7D,OAAO,KAAK,UAAU,WAAW,CAAC,KAA6B,EAAE,IAAkB;QACjF,IAAI,YAAY,EAAE,EAAE,CAAC;YACnB,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,CAAA;QAElC,2EAA2E;QAC3E,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3D,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAEtG,MAAM,eAAe,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAA;QAC/C,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,eAAe,EACf,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CACR,CAAA;YACD,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,MAAM,CAAA;YACf,CAAC;YACD,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE;gBAC3C,MAAM,EAAE,GAAG;aACZ,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;QAClH,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;QAEjD,IAAI,IAAwB,CAAA;QAE5B,2CAA2C;QAC3C,IAAI,KAAK,YAAY,OAAO,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,2EAA2E;YAC3E,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,EAAE,CAAA;YACnC,IAAI,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,IAAK,CAAC,CAAA;QACnD,CAAC;aAAM,IAAI,IAAI,EAAE,IAAI,KAAK,IAAI,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS,EAAE,CAAC;YAC3D,IAAI,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACzC,CAAC;QAED,iHAAiH;QACjH,MAAM,eAAe,GAAG,MAAM,UAAU,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACxE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC,CAAA;QAEjF,MAAM,MAAM,GAAG,MAAM,iBAAiB,CACpC,QAAQ,EACR,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,iBAAiB,EAC1B,OAAO,CACR,CAAA;QACD,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAA;QACf,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,IAAI,QAAQ,CAAC,gCAAgC,EAAE;gBACpD,MAAM,EAAE,GAAG;aACZ,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,cAAc,GAAG,MAAM,kBAAkB,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QAC/E,MAAM,YAAY,CAChB;YACE,GAAG,EAAE,cAAc,CAAC,GAAG;YACvB,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,OAAO,EAAE,cAAc,CAAC,OAAO;YAC/B,IAAI,EAAE,cAAc,CAAC,IAAI;SAC1B,EACD,QAAQ,EACR,OAAO,EAAE,kBAAkB,KAAK,SAAS,EAAE,yCAAyC;QACpF,OAAO,EACP,eAAe,CAChB,CAAA;QAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;QAE7C,OAAO,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,eAAe,CAAC,CAAA;IAClG,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAsB;IACxD,IAAI,YAAY,EAAE,EAAE,CAAC;QACnB,OAAM;IACR,CAAC;IAED,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;QACtB,OAAM;IACR,CAAC;IAED,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAM;IACR,CAAC;IAED,aAAa,GAAG,UAAU,CAAC,KAAK,CAAA;IAChC,MAAM,WAAW,GAAG,iBAAiB,CAAC,aAAa,EAAE;QACnD,GAAG,OAAO;QACV,aAAa,EAAE,OAAO,EAAE,aAAa,IAAI,aAAa;KACvD,CAAC,CAAA;IAEF,oDAAoD;IACpD,UAAU,CAAC,KAAK,GAAG,WAAsC,CAAA;IAEzD,wFAAwF;IACxF,OAAO,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAM;IACR,CAAC;IAED,UAAU,CAAC,KAAK,GAAG,aAAa,CAAA;IAChC,aAAa,GAAG,IAAI,CAAA;AACtB,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,OAAO,aAAa,KAAK,IAAI,CAAA;AAC/B,CAAC"}

package/dist/request-hasher.d.ts

@@ -0,0 +1,5 @@
+import type { RawCachedRequest } from "./types.js";
+export declare function hashRequest({ body, headers, method, url }: RawCachedRequest): string;
+export declare function getStorableHeaders(headers: Record<string, string>): Record<string, string>;
+export declare function headersToRecord(headers: Headers): Record<string, string>;
+//# sourceMappingURL=request-hasher.d.ts.map

package/dist/request-hasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-hasher.d.ts","sourceRoot":"","sources":["../src/request-hasher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAyDlD,wBAAgB,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAepF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMxE"}

package/dist/request-hasher.js

@@ -0,0 +1,74 @@
+import { createHash } from "node:crypto";
+const BASE62 = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+function toBase62(n) {
+    if (n === 0n)
+        return "0";
+    let result = "";
+    while (n > 0n) {
+        result = BASE62[Number(n % 62n)] + result;
+        n = n / 62n;
+    }
+    return result;
+}
+const SENSITIVE_HEADERS = new Set([
+    "authorization",
+    "x-api-key",
+    "api-key",
+    "x-openrouter-api-key",
+    "cookie",
+    "set-cookie",
+    "x-auth-token",
+    "x-access-token",
+    "bearer"
+]);
+function normalizeUrl(url) {
+    const parsed = new URL(url);
+    parsed.searchParams.sort();
+    const pathname = parsed.pathname.replace(/\/+$/, "") || "/";
+    return `${parsed.protocol}//${parsed.host}${pathname}${parsed.search}`;
+}
+function filterHeaders(headers, getOutputKey) {
+    const result = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const lowerKey = key.toLowerCase();
+        if (SENSITIVE_HEADERS.has(lowerKey)) {
+            continue;
+        }
+        const outputKey = getOutputKey(key, lowerKey);
+        result[outputKey] = value;
+    }
+    return result;
+}
+function normalizeHeaders(headers) {
+    return filterHeaders(headers, (_originalKey, lowerKey) => lowerKey);
+}
+function filterSensitiveHeaders(headers) {
+    return filterHeaders(headers, (originalKey) => originalKey);
+}
+export function hashRequest({ body, headers, method, url }) {
+    // Build content string for hashing
+    let content = normalizeUrl(url) + "\n" + method.toUpperCase();
+    const normalizedHeaders = normalizeHeaders(headers);
+    const sortedHeaderKeys = Object.keys(normalizedHeaders).sort();
+    for (const key of sortedHeaderKeys) {
+        content += `\n${key}:${normalizedHeaders[key]}`;
+    }
+    if (body) {
+        content += `\n${body}`;
+    }
+    // Create a SHA256 hash and convert to base62 for a short string
+    const hash = createHash("sha256").update(content).digest();
+    const hashBigInt = BigInt("0x" + hash.toString("hex"));
+    return toBase62(hashBigInt % 62n ** 11n); // Limit to base62 with ~11 chars max
+}
+export function getStorableHeaders(headers) {
+    return filterSensitiveHeaders(headers);
+}
+export function headersToRecord(headers) {
+    const record = {};
+    headers.forEach((value, key) => {
+        record[key] = value;
+    });
+    return record;
+}
+//# sourceMappingURL=request-hasher.js.map

package/dist/request-hasher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-hasher.js","sourceRoot":"","sources":["../src/request-hasher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGxC,MAAM,MAAM,GAAG,gEAAgE,CAAA;AAE/E,SAAS,QAAQ,CAAC,CAAS;IACzB,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,GAAG,CAAA;IACxB,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QACd,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,MAAM,CAAA;QACzC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IACb,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,eAAe;IACf,WAAW;IACX,SAAS;IACT,sBAAsB;IACtB,QAAQ;IACR,YAAY;IACZ,cAAc;IACd,gBAAgB;IAChB,QAAQ;CACT,CAAC,CAAA;AAEF,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAC3B,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAA;IAC3D,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,GAAG,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAA;AACxE,CAAC;AAED,SAAS,aAAa,CACpB,OAA+B,EAC/B,YAA+D;IAE/D,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,CAAA;QAClC,IAAI,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,SAAQ;QACV,CAAC;QACD,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;QAC7C,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAA;IAC3B,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA+B;IACvD,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAA;AACrE,CAAC;AAED,SAAS,sBAAsB,CAAC,OAA+B;IAC7D,OAAO,aAAa,CAAC,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,CAAA;AAC7D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAoB;IAC1E,mCAAmC;IACnC,IAAI,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAA;IAC7D,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACnD,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9D,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,OAAO,IAAI,KAAK,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAA;IACjD,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,KAAK,IAAI,EAAE,CAAA;IACxB,CAAC;IACD,gEAAgE;IAChE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAA;IAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAA;IACtD,OAAO,QAAQ,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,CAAA,CAAC,qCAAqC;AAChF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAA+B;IAChE,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAA;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,MAAM,GAA2B,EAAE,CAAA;IACzC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IACrB,CAAC,CAAC,CAAA;IACF,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/sse-handler.d.ts

@@ -0,0 +1,9 @@
+import type { TimedChunk } from "./types.js";
+export declare function isSSEResponse(headers: Headers): boolean;
+export declare function recordStreamWithTiming(stream: ReadableStream<Uint8Array>): Promise<Array<TimedChunk>>;
+export declare function replayStreamWithTiming(timedChunks: Array<TimedChunk>): ReadableStream<Uint8Array>;
+/** Replay stream from an async iterable of timed chunks (for generator transforms) */
+export declare function replayStreamFromAsyncIterable(chunks: AsyncIterable<TimedChunk>): ReadableStream<Uint8Array>;
+export declare function timedChunksToJsonl(chunks: Array<TimedChunk>): string;
+export declare function jsonlToTimedChunks(jsonl: string): Array<TimedChunk>;
+//# sourceMappingURL=sse-handler.d.ts.map