@galaxy-tool-util/core 0.2.0 → 1.0.0

package/README.md

@@ -8,6 +8,39 @@ Galaxy tool cache, ToolShed client, and ParsedTool models.
 npm install @galaxy-tool-util/core
 ```
 
+## Usage
+
+The package ships two entry points:
+
+- **`@galaxy-tool-util/core`** — universal (browser + Node). Models, schemas,
+  `ToolCache` (with injected storage), `IndexedDBCacheStorage`, `ToolInfoService`,
+  `cacheKey`, ToolShed/Galaxy clients, YAML config schemas.
+- **`@galaxy-tool-util/core/node`** — Node-only helpers that pull in `fs`, `path`,
+  `os`: `FilesystemCacheStorage`, `getCacheDir`, `DEFAULT_CACHE_DIR`,
+  `CACHE_DIR_ENV_VAR`, `loadWorkflowToolConfig`, plus convenience factories
+  `makeNodeToolCache` and `makeNodeToolInfoService`.
+
+### Browser / Web Worker
+
+```ts
+import { ToolCache, IndexedDBCacheStorage } from "@galaxy-tool-util/core";
+
+const cache = new ToolCache({
+  storage: new IndexedDBCacheStorage("gxwf-tool-cache"),
+});
+```
+
+### Node
+
+```ts
+import { makeNodeToolCache } from "@galaxy-tool-util/core/node";
+
+const cache = makeNodeToolCache(); // defaults to ~/.galaxy/tool_info_cache
+```
+
+Bundlers targeting the browser will fail fast if `/node` is imported — by
+design. Keep Node-only imports on the server side of your application.
+
 ## License
 
 MIT

package/dist/cache/cache-index.d.ts

@@ -1,3 +1,4 @@
+import type { CacheStorage } from "./storage/interface.js";
 /** Metadata for a single cached tool entry. */
 export interface CacheIndexEntry {
     tool_id: string;
@@ -8,29 +9,32 @@ export interface CacheIndexEntry {
     /** ISO 8601 timestamp of when the tool was cached. */
     cached_at: string;
 }
-/** Serialized cache index structure (persisted as index.json). */
+/** Serialized cache index structure. */
 export interface CacheIndexData {
     entries: Record<string, CacheIndexEntry>;
 }
 /**
- * Manages the cache index file (index.json) that tracks metadata about cached tools.
- * Supports lazy loading, add/remove, and listing operations.
+ * Manages the cache index that tracks metadata about cached tools.
+ * Backed by a {@link CacheStorage} — works on both filesystem (Node.js) and
+ * IndexedDB (browser/Web Worker).
+ *
+ * Call `await load()` before using `has()` or `listAll()` if you need
+ * the persisted state. ToolCache calls load() automatically on first use.
  */
 export declare class CacheIndex {
-    readonly cacheDir: string;
-    private indexPath;
+    private readonly storage;
     private entries;
-    constructor(cacheDir: string);
-    private getEntries;
-    private loadSync;
+    private loaded;
+    constructor(storage: CacheStorage);
     load(): Promise<void>;
-    save(): Promise<void>;
+    private ensureLoaded;
+    private save;
     add(key: string, toolId: string, toolVersion: string, source: string, sourceUrl?: string): Promise<void>;
     remove(key: string): Promise<void>;
-    has(key: string): boolean;
-    listAll(): Array<CacheIndexEntry & {
+    has(key: string): Promise<boolean>;
+    listAll(): Promise<Array<CacheIndexEntry & {
         cache_key: string;
-    }>;
+    }>>;
     clear(): Promise<void>;
 }
 //# sourceMappingURL=cache-index.d.ts.map

package/dist/cache/cache-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-index.d.ts","sourceRoot":"","sources":["../../src/cache/cache-index.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,qBAAa,UAAU;IAIT,QAAQ,CAAC,QAAQ,EAAE,MAAM;IAHrC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAgD;gBAE1C,QAAQ,EAAE,MAAM;IAIrC,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ;IAcV,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAMrB,GAAG,CACP,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC;IAWV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,OAAO,IAAI,KAAK,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}
+{"version":3,"file":"cache-index.d.ts","sourceRoot":"","sources":["../../src/cache/cache-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAK3D,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wCAAwC;AACxC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IAIT,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,MAAM,CAAS;gBAEM,OAAO,EAAE,YAAY;IAE5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAMb,YAAY;YAIZ,IAAI;IAKZ,GAAG,CACP,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC;IAYV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKlC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,eAAe,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAQlE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/cache/cache-index.js

@@ -1,60 +1,36 @@
-import { readFile, writeFile, mkdir } from "node:fs/promises";
-import { existsSync, readFileSync } from "node:fs";
-import { join } from "node:path";
+/** Reserved storage key for the index metadata object. */
+const INDEX_KEY = "__index__";
 /**
- * Manages the cache index file (index.json) that tracks metadata about cached tools.
- * Supports lazy loading, add/remove, and listing operations.
+ * Manages the cache index that tracks metadata about cached tools.
+ * Backed by a {@link CacheStorage} — works on both filesystem (Node.js) and
+ * IndexedDB (browser/Web Worker).
+ *
+ * Call `await load()` before using `has()` or `listAll()` if you need
+ * the persisted state. ToolCache calls load() automatically on first use.
  */
 export class CacheIndex {
-    cacheDir;
-    indexPath;
-    entries = null;
-    constructor(cacheDir) {
-        this.cacheDir = cacheDir;
-        this.indexPath = join(cacheDir, "index.json");
-    }
-    getEntries() {
-        if (this.entries === null) {
-            this.entries = this.loadSync();
-        }
-        return this.entries;
-    }
-    loadSync() {
-        if (!existsSync(this.indexPath)) {
-            return {};
-        }
-        try {
-            const raw = readFileSync(this.indexPath, "utf-8");
-            const data = JSON.parse(raw);
-            return data.entries ?? {};
-        }
-        catch (err) {
-            console.debug(`Failed to load cache index (sync): ${err}`);
-            return {};
-        }
+    storage;
+    entries = {};
+    loaded = false;
+    constructor(storage) {
+        this.storage = storage;
     }
     async load() {
-        if (!existsSync(this.indexPath)) {
-            this.entries = {};
-            return;
-        }
-        try {
-            const raw = await readFile(this.indexPath, "utf-8");
-            const data = JSON.parse(raw);
-            this.entries = data.entries ?? {};
-        }
-        catch (err) {
-            console.debug(`Failed to load cache index: ${err}`);
-            this.entries = {};
-        }
+        const data = (await this.storage.load(INDEX_KEY));
+        this.entries = data?.entries ?? {};
+        this.loaded = true;
+    }
+    async ensureLoaded() {
+        if (!this.loaded)
+            await this.load();
     }
     async save() {
-        await mkdir(this.cacheDir, { recursive: true });
-        const data = { entries: this.getEntries() };
-        await writeFile(this.indexPath, JSON.stringify(data, null, 2));
+        const data = { entries: this.entries };
+        await this.storage.save(INDEX_KEY, data);
     }
     async add(key, toolId, toolVersion, source, sourceUrl = "") {
-        this.getEntries()[key] = {
+        await this.ensureLoaded();
+        this.entries[key] = {
             tool_id: toolId,
             tool_version: toolVersion,
             source,
@@ -64,23 +40,26 @@ export class CacheIndex {
         await this.save();
     }
     async remove(key) {
-        const entries = this.getEntries();
-        if (key in entries) {
-            delete entries[key];
+        await this.ensureLoaded();
+        if (key in this.entries) {
+            delete this.entries[key];
             await this.save();
         }
     }
-    has(key) {
-        return key in this.getEntries();
+    async has(key) {
+        await this.ensureLoaded();
+        return key in this.entries;
     }
-    listAll() {
-        return Object.entries(this.getEntries()).map(([key, entry]) => ({
+    async listAll() {
+        await this.ensureLoaded();
+        return Object.entries(this.entries).map(([key, entry]) => ({
             cache_key: key,
             ...entry,
         }));
     }
     async clear() {
         this.entries = {};
+        this.loaded = true;
         await this.save();
     }
 }

package/dist/cache/cache-index.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-index.js","sourceRoot":"","sources":["../../src/cache/cache-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache-index.js","sourceRoot":"","sources":["../../src/cache/cache-index.ts"],"names":[],"mappings":"AAEA,0DAA0D;AAC1D,MAAM,SAAS,GAAG,WAAW,CAAC;AAkB9B;;;;;;;GAOG;AACH,MAAM,OAAO,UAAU;IAIQ;IAHrB,OAAO,GAAoC,EAAE,CAAC;IAC9C,MAAM,GAAG,KAAK,CAAC;IAEvB,YAA6B,OAAqB;QAArB,YAAO,GAAP,OAAO,CAAc;IAAG,CAAC;IAEtD,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAA0B,CAAC;QAC3E,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,MAAM,IAAI,GAAmB,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACvD,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW,EACX,MAAc,EACd,WAAmB,EACnB,MAAc,EACd,YAAoB,EAAE;QAEtB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG;YAClB,OAAO,EAAE,MAAM;YACf,YAAY,EAAE,WAAW;YACzB,MAAM;YACN,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACzB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,SAAS,EAAE,GAAG;YACd,GAAG,KAAK;SACT,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/cache/cache-key.d.ts

@@ -1,6 +1,7 @@
 /**
  * Compute a deterministic cache key (SHA-256 hex) for a tool.
  * The key is derived from the ToolShed URL, TRS tool ID, and version.
+ * Uses the Web Crypto API (available in Node.js ≥15 and all modern browsers/Web Workers).
  */
-export declare function cacheKey(toolshedUrl: string, trsToolId: string, toolVersion: string): string;
+export declare function cacheKey(toolshedUrl: string, trsToolId: string, toolVersion: string): Promise<string>;
 //# sourceMappingURL=cache-key.d.ts.map

package/dist/cache/cache-key.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAG5F"}
+{"version":3,"file":"cache-key.d.ts","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/cache/cache-key.js

@@ -1,10 +1,14 @@
-import { createHash } from "node:crypto";
 /**
  * Compute a deterministic cache key (SHA-256 hex) for a tool.
  * The key is derived from the ToolShed URL, TRS tool ID, and version.
+ * Uses the Web Crypto API (available in Node.js ≥15 and all modern browsers/Web Workers).
  */
-export function cacheKey(toolshedUrl, trsToolId, toolVersion) {
+export async function cacheKey(toolshedUrl, trsToolId, toolVersion) {
     const raw = `${toolshedUrl}/${trsToolId}/${toolVersion}`;
-    return createHash("sha256").update(raw).digest("hex");
+    const encoded = new TextEncoder().encode(raw);
+    const hashBuffer = await globalThis.crypto.subtle.digest("SHA-256", encoded);
+    return Array.from(new Uint8Array(hashBuffer))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
 }
 //# sourceMappingURL=cache-key.js.map

package/dist/cache/cache-key.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB,EAAE,SAAiB,EAAE,WAAmB;IAClF,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;IACzD,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"cache-key.js","sourceRoot":"","sources":["../../src/cache/cache-key.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,WAAmB,EACnB,SAAiB,EACjB,WAAmB;IAEnB,MAAM,GAAG,GAAG,GAAG,WAAW,IAAI,SAAS,IAAI,WAAW,EAAE,CAAC;IACzD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;SAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/cache/index.d.ts

@@ -3,5 +3,9 @@ export type { ToolCoordinates } from "./tool-id.js";
 export { cacheKey } from "./cache-key.js";
 export { CacheIndex } from "./cache-index.js";
 export type { CacheIndexEntry, CacheIndexData } from "./cache-index.js";
-export { ToolCache, getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./tool-cache.js";
+export { ToolCache } from "./tool-cache.js";
+export type { ResolvedCoordinates } from "./tool-cache.js";
+export { DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR } from "./tool-cache-defaults.js";
+export type { CacheStorage } from "./storage/interface.js";
+export { IndexedDBCacheStorage } from "./storage/indexeddb.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACtF,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cache/index.js

@@ -1,5 +1,7 @@
 export { parseToolshedToolId, toolIdFromTrs } from "./tool-id.js";
 export { cacheKey } from "./cache-key.js";
 export { CacheIndex } from "./cache-index.js";
-export { ToolCache, getCacheDir, DEFAULT_CACHE_DIR, CACHE_DIR_ENV_VAR, DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR, } from "./tool-cache.js";
+export { ToolCache } from "./tool-cache.js";
+export { DEFAULT_TOOLSHED_URL, TOOLSHED_URL_ENV_VAR } from "./tool-cache-defaults.js";
+export { IndexedDBCacheStorage } from "./storage/indexeddb.js";
 //# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EACL,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cache/node.d.ts

@@ -0,0 +1,30 @@
+import { ToolCache } from "./tool-cache.js";
+import type { ToolInfoOptions, ToolSource } from "../tool-info.js";
+import { ToolInfoService } from "../tool-info.js";
+export { FilesystemCacheStorage } from "./storage/filesystem.js";
+export { CACHE_DIR_ENV_VAR } from "./tool-cache-defaults.js";
+/** Default cache directory: `~/.galaxy/tool_info_cache`. */
+export declare const DEFAULT_CACHE_DIR: string;
+/** Resolve cache directory: explicit override > env var > default. */
+export declare function getCacheDir(override?: string): string;
+/** Options for `makeNodeToolCache` — same as ToolCache minus `storage`, plus `cacheDir`. */
+export interface NodeToolCacheOptions {
+    cacheDir?: string;
+    defaultToolshedUrl?: string;
+}
+/**
+ * Construct a ToolCache backed by the default filesystem storage.
+ * `cacheDir` resolves via {@link getCacheDir} (explicit > env var > default).
+ */
+export declare function makeNodeToolCache(opts?: NodeToolCacheOptions): ToolCache;
+/** Options for `makeNodeToolInfoService` — ToolInfoOptions without `storage`, plus `cacheDir`. */
+export interface NodeToolInfoOptions extends Omit<ToolInfoOptions, "storage"> {
+    cacheDir?: string;
+    sources?: ToolSource[];
+}
+/**
+ * Construct a ToolInfoService backed by the default filesystem storage.
+ * `cacheDir` resolves via {@link getCacheDir}.
+ */
+export declare function makeNodeToolInfoService(opts?: NodeToolInfoOptions): ToolInfoService;
+//# sourceMappingURL=node.d.ts.map

package/dist/cache/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/cache/node.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,QAAgD,CAAC;AAE/E,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,4FAA4F;AAC5F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAMxE;AAED,kGAAkG;AAClG,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,CAAC,EAAE,mBAAmB,GAAG,eAAe,CAMnF"}

package/dist/cache/node.js

@@ -0,0 +1,37 @@
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { FilesystemCacheStorage } from "./storage/filesystem.js";
+import { ToolCache } from "./tool-cache.js";
+import { CACHE_DIR_ENV_VAR } from "./tool-cache-defaults.js";
+import { ToolInfoService } from "../tool-info.js";
+export { FilesystemCacheStorage } from "./storage/filesystem.js";
+export { CACHE_DIR_ENV_VAR } from "./tool-cache-defaults.js";
+/** Default cache directory: `~/.galaxy/tool_info_cache`. */
+export const DEFAULT_CACHE_DIR = join(homedir(), ".galaxy", "tool_info_cache");
+/** Resolve cache directory: explicit override > env var > default. */
+export function getCacheDir(override) {
+    return override ?? process.env[CACHE_DIR_ENV_VAR] ?? DEFAULT_CACHE_DIR;
+}
+/**
+ * Construct a ToolCache backed by the default filesystem storage.
+ * `cacheDir` resolves via {@link getCacheDir} (explicit > env var > default).
+ */
+export function makeNodeToolCache(opts) {
+    const cacheDir = getCacheDir(opts?.cacheDir);
+    return new ToolCache({
+        storage: new FilesystemCacheStorage(cacheDir),
+        defaultToolshedUrl: opts?.defaultToolshedUrl,
+    });
+}
+/**
+ * Construct a ToolInfoService backed by the default filesystem storage.
+ * `cacheDir` resolves via {@link getCacheDir}.
+ */
+export function makeNodeToolInfoService(opts) {
+    const cacheDir = getCacheDir(opts?.cacheDir);
+    return new ToolInfoService({
+        ...opts,
+        storage: new FilesystemCacheStorage(cacheDir),
+    });
+}
+//# sourceMappingURL=node.js.map

package/dist/cache/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/cache/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,4DAA4D;AAC5D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;AAE/E,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,QAAiB;IAC3C,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;AACzE,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAA2B;IAC3D,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,IAAI,SAAS,CAAC;QACnB,OAAO,EAAE,IAAI,sBAAsB,CAAC,QAAQ,CAAC;QAC7C,kBAAkB,EAAE,IAAI,EAAE,kBAAkB;KAC7C,CAAC,CAAC;AACL,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA0B;IAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,IAAI,eAAe,CAAC;QACzB,GAAG,IAAI;QACP,OAAO,EAAE,IAAI,sBAAsB,CAAC,QAAQ,CAAC;KAC9C,CAAC,CAAC;AACL,CAAC"}

package/dist/cache/storage/filesystem.d.ts

@@ -0,0 +1,17 @@
+import type { CacheStorage } from "./interface.js";
+/**
+ * Node.js filesystem-backed CacheStorage.
+ * Stores each entry as `<cacheDir>/<key>.json`.
+ * The internal `__index__` key maps to `index.json` for backward compatibility.
+ */
+export declare class FilesystemCacheStorage implements CacheStorage {
+    readonly cacheDir: string;
+    constructor(cacheDir: string);
+    private keyToPath;
+    load(key: string): Promise<unknown | null>;
+    save(key: string, data: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+    saveAll(entries: ReadonlyArray<[string, unknown]>): Promise<void>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../src/cache/storage/filesystem.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AASnD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;IAErC,OAAO,CAAC,SAAS;IAKX,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAW1C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQzB,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAMxE"}

package/dist/cache/storage/filesystem.js

@@ -0,0 +1,61 @@
+import { readFile, writeFile, mkdir, unlink, readdir } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Key used by CacheIndex to store the index metadata.
+ * Mapped to "index.json" on disk for backward compatibility with existing caches.
+ */
+const INDEX_KEY = "__index__";
+const INDEX_FILENAME = "index.json";
+/**
+ * Node.js filesystem-backed CacheStorage.
+ * Stores each entry as `<cacheDir>/<key>.json`.
+ * The internal `__index__` key maps to `index.json` for backward compatibility.
+ */
+export class FilesystemCacheStorage {
+    cacheDir;
+    constructor(cacheDir) {
+        this.cacheDir = cacheDir;
+    }
+    keyToPath(key) {
+        if (key === INDEX_KEY)
+            return join(this.cacheDir, INDEX_FILENAME);
+        return join(this.cacheDir, `${key}.json`);
+    }
+    async load(key) {
+        const path = this.keyToPath(key);
+        if (!existsSync(path))
+            return null;
+        try {
+            const raw = await readFile(path, "utf-8");
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(key, data) {
+        await mkdir(this.cacheDir, { recursive: true });
+        await writeFile(this.keyToPath(key), JSON.stringify(data, null, 2));
+    }
+    async delete(key) {
+        const path = this.keyToPath(key);
+        if (existsSync(path))
+            await unlink(path);
+    }
+    async list() {
+        if (!existsSync(this.cacheDir))
+            return [];
+        const files = await readdir(this.cacheDir);
+        return files
+            .filter((f) => f.endsWith(".json") && f !== INDEX_FILENAME)
+            .map((f) => f.slice(0, -5));
+    }
+    async saveAll(entries) {
+        await mkdir(this.cacheDir, { recursive: true });
+        for (const [key, data] of entries) {
+            await writeFile(this.keyToPath(key), JSON.stringify(data, null, 2));
+        }
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/cache/storage/filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.js","sourceRoot":"","sources":["../../../src/cache/storage/filesystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC;;;GAGG;AACH,MAAM,SAAS,GAAG,WAAW,CAAC;AAC9B,MAAM,cAAc,GAAG,YAAY,CAAC;AAEpC;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IACZ;IAArB,YAAqB,QAAgB;QAAhB,aAAQ,GAAR,QAAQ,CAAQ;IAAG,CAAC;IAEjC,SAAS,CAAC,GAAW;QAC3B,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAClE,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QACpC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,GAAW,EAAE,IAAa;QACnC,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3C,OAAO,KAAK;aACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,cAAc,CAAC;aAC1D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAyC;QACrD,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;YAClC,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;CACF"}

package/dist/cache/storage/indexeddb.d.ts

@@ -0,0 +1,21 @@
+import type { CacheStorage } from "./interface.js";
+/**
+ * IndexedDB-backed CacheStorage for browser and Web Worker contexts.
+ * Suitable for VS Code web extension language servers running as Web Workers.
+ *
+ * Storage quota: ~80% of free disk space per origin via the Storage Quota API.
+ * A large cache (10,000 tools × 50 KB avg) ≈ 500 MB — well within typical limits.
+ */
+export declare class IndexedDBCacheStorage implements CacheStorage {
+    private readonly dbName;
+    private db;
+    constructor(dbName?: string);
+    private getDb;
+    load(key: string): Promise<unknown | null>;
+    save(key: string, data: unknown): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(): Promise<string[]>;
+    /** Bulk insert using a single transaction — efficient for pre-populating from a bundled dataset. */
+    saveAll(entries: ReadonlyArray<[string, unknown]>): Promise<void>;
+}
+//# sourceMappingURL=indexeddb.d.ts.map

package/dist/cache/storage/indexeddb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../../../src/cache/storage/indexeddb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAQnD;;;;;;GAMG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IAG5C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,EAAE,CAA4B;gBAET,MAAM,GAAE,MAAwB;IAE7D,OAAO,CAAC,KAAK;IAkBP,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAU1C,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/B,oGAAoG;IAC9F,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAYxE"}

package/dist/cache/storage/indexeddb.js

@@ -0,0 +1,87 @@
+/** Stable database name — increment version suffix on schema changes. */
+const DEFAULT_DB_NAME = "galaxy-tool-cache-v1";
+const STORE_NAME = "data";
+/** Reserved key used by CacheIndex to store the index metadata object. */
+const INDEX_KEY = "__index__";
+/**
+ * IndexedDB-backed CacheStorage for browser and Web Worker contexts.
+ * Suitable for VS Code web extension language servers running as Web Workers.
+ *
+ * Storage quota: ~80% of free disk space per origin via the Storage Quota API.
+ * A large cache (10,000 tools × 50 KB avg) ≈ 500 MB — well within typical limits.
+ */
+export class IndexedDBCacheStorage {
+    dbName;
+    db = null;
+    constructor(dbName = DEFAULT_DB_NAME) {
+        this.dbName = dbName;
+    }
+    getDb() {
+        if (this.db !== null)
+            return Promise.resolve(this.db);
+        return new Promise((resolve, reject) => {
+            const req = indexedDB.open(this.dbName, 1);
+            req.onupgradeneeded = (e) => {
+                const db = e.target.result;
+                if (!db.objectStoreNames.contains(STORE_NAME)) {
+                    db.createObjectStore(STORE_NAME);
+                }
+            };
+            req.onsuccess = (e) => {
+                this.db = e.target.result;
+                resolve(this.db);
+            };
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async load(key) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, "readonly");
+            const req = tx.objectStore(STORE_NAME).get(key);
+            req.onsuccess = () => resolve(req.result ?? null);
+            req.onerror = () => reject(req.error);
+        });
+    }
+    async save(key, data) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, "readwrite");
+            tx.objectStore(STORE_NAME).put(data, key);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async delete(key) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, "readwrite");
+            tx.objectStore(STORE_NAME).delete(key);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    async list() {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, "readonly");
+            const req = tx.objectStore(STORE_NAME).getAllKeys();
+            req.onsuccess = () => resolve(req.result.filter((k) => k !== INDEX_KEY));
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /** Bulk insert using a single transaction — efficient for pre-populating from a bundled dataset. */
+    async saveAll(entries) {
+        const db = await this.getDb();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(STORE_NAME, "readwrite");
+            const store = tx.objectStore(STORE_NAME);
+            for (const [key, data] of entries) {
+                store.put(data, key);
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+//# sourceMappingURL=indexeddb.js.map

package/dist/cache/storage/indexeddb.js.map

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

package/dist/cache/storage/interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Pluggable storage backend for the tool cache.
+ * Implementations: FilesystemCacheStorage (Node.js), IndexedDBCacheStorage (browser/Web Worker).
+ */
+export interface CacheStorage {
+    /** Load a value by key. Returns null if not found. */
+    load(key: string): Promise<unknown | null>;
+    /** Persist a value under key. Creates storage if needed. */
+    save(key: string, data: unknown): Promise<void>;
+    /** Remove a key. No-op if not found. */
+    delete(key: string): Promise<void>;
+    /** List all tool keys (excludes internal metadata keys). */
+    list(): Promise<string[]>;
+    /** Optional bulk insert — single transaction for efficiency (e.g. pre-populating from bundle). */
+    saveAll?(entries: ReadonlyArray<[string, unknown]>): Promise<void>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/cache/storage/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/cache/storage/interface.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC3C,4DAA4D;IAC5D,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,wCAAwC;IACxC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,4DAA4D;IAC5D,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1B,kGAAkG;IAClG,OAAO,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpE"}

package/dist/cache/storage/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/cache/storage/interface.js.map

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