@seedprotocol/query 0.6.6 → 0.6.8

package/dist/FileCache-BZ2cHsU3.js

@@ -0,0 +1,95 @@
+import { n as e } from "./types-DHRoT30t.js";
+import { promises as t } from "fs";
+import { join as n } from "path";
+//#region src/cache/FileCache.ts
+var r = class {
+	cacheDir;
+	config;
+	constructor(e) {
+		this.cacheDir = e.cacheDir, this.config = e, this.ensureCacheDir().catch((e) => {
+			console.error("Failed to create query cache directory:", e);
+		});
+	}
+	async ensureCacheDir() {
+		try {
+			await t.mkdir(this.cacheDir, { recursive: !0 });
+		} catch (e) {
+			if (e.code !== "EEXIST") throw e;
+		}
+	}
+	async ensureItemsDir() {
+		try {
+			await t.mkdir(n(this.cacheDir, "items"), { recursive: !0 });
+		} catch (e) {
+			if (e.code !== "EEXIST") throw e;
+		}
+	}
+	collectionPath(e) {
+		return n(this.cacheDir, `${e}.json`);
+	}
+	itemPath(t, r) {
+		let i = e(t);
+		return n(this.cacheDir, "items", `${i}-${r}.json`);
+	}
+	async getCollection(e) {
+		try {
+			let n = await t.readFile(this.collectionPath(e), "utf-8"), r = JSON.parse(n);
+			return Math.floor(Date.now() / 1e3) - r.lastUpdated > this.config.ttl ? (await this.clearCollection(e), null) : r;
+		} catch (t) {
+			return t.code === "ENOENT" || console.error(`Error reading query collection cache for ${e}:`, t), null;
+		}
+	}
+	async setCollection(e, n) {
+		try {
+			await this.ensureCacheDir(), await t.writeFile(this.collectionPath(e), JSON.stringify(n, null, 2), "utf-8");
+		} catch (t) {
+			console.error(`Error writing query collection cache for ${e}:`, t);
+		}
+	}
+	async getItem(e, n) {
+		try {
+			let r = await t.readFile(this.itemPath(e, n), "utf-8"), i = JSON.parse(r);
+			return Math.floor(Date.now() / 1e3) - i.lastUpdated > this.config.ttl ? (await this.clearItem(e, n), null) : i;
+		} catch (t) {
+			return t.code === "ENOENT" || console.error(`Error reading query item cache for ${e}:`, t), null;
+		}
+	}
+	async setItem(e) {
+		try {
+			await this.ensureItemsDir(), await t.writeFile(this.itemPath(e.record.seedUid, e.optionsKey), JSON.stringify(e, null, 2), "utf-8");
+		} catch (t) {
+			console.error(`Error writing query item cache for ${e.record.seedUid}:`, t);
+		}
+	}
+	async clearCollection(e) {
+		try {
+			await t.unlink(this.collectionPath(e));
+		} catch (t) {
+			t.code !== "ENOENT" && console.error(`Error clearing query collection cache for ${e}:`, t);
+		}
+	}
+	async clearItem(e, n) {
+		try {
+			await t.unlink(this.itemPath(e, n));
+		} catch (t) {
+			t.code !== "ENOENT" && console.error(`Error clearing query item cache for ${e}:`, t);
+		}
+	}
+	async clearAll() {
+		try {
+			let e = await t.readdir(this.cacheDir);
+			for (let r of e) r.endsWith(".json") && await t.unlink(n(this.cacheDir, r));
+			let r = n(this.cacheDir, "items");
+			try {
+				let e = await t.readdir(r);
+				for (let i of e) i.endsWith(".json") && await t.unlink(n(r, i));
+			} catch {}
+		} catch (e) {
+			console.error("Error clearing all query caches:", e);
+		}
+	}
+};
+//#endregion
+export { r as t };
+
+//# sourceMappingURL=FileCache-BZ2cHsU3.js.map

package/dist/FileCache-BZ2cHsU3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileCache-BZ2cHsU3.js","names":[],"sources":["../src/cache/FileCache.ts"],"sourcesContent":["import { promises as fs } from 'fs'\nimport { join } from 'path'\nimport type {\n  CachedCollectionData,\n  CachedItemData,\n  QueryCacheConfig,\n} from './types.js'\nimport { sanitizeSeedUidForPath } from './types.js'\n\n/**\n * File-based persistent cache for collections and items (Node / best-effort).\n */\nexport class FileCache {\n  private cacheDir: string\n  private config: QueryCacheConfig\n\n  constructor(config: QueryCacheConfig) {\n    this.cacheDir = config.cacheDir\n    this.config = config\n    this.ensureCacheDir().catch((err) => {\n      console.error('Failed to create query cache directory:', err)\n    })\n  }\n\n  private async ensureCacheDir(): Promise<void> {\n    try {\n      await fs.mkdir(this.cacheDir, { recursive: true })\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n        throw error\n      }\n    }\n  }\n\n  private async ensureItemsDir(): Promise<void> {\n    try {\n      await fs.mkdir(join(this.cacheDir, 'items'), { recursive: true })\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'EEXIST') {\n        throw error\n      }\n    }\n  }\n\n  private collectionPath(schemaName: string): string {\n    return join(this.cacheDir, `${schemaName}.json`)\n  }\n\n  private itemPath(seedUid: string, optionsKey: string): string {\n    const safe = sanitizeSeedUidForPath(seedUid)\n    return join(this.cacheDir, 'items', `${safe}-${optionsKey}.json`)\n  }\n\n  async getCollection(schemaName: string): Promise<CachedCollectionData | null> {\n    try {\n      const data = await fs.readFile(this.collectionPath(schemaName), 'utf-8')\n      const cached: CachedCollectionData = JSON.parse(data)\n      const now = Math.floor(Date.now() / 1000)\n      if (now - cached.lastUpdated > this.config.ttl) {\n        await this.clearCollection(schemaName)\n        return null\n      }\n      return cached\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n        return null\n      }\n      console.error(\n        `Error reading query collection cache for ${schemaName}:`,\n        error,\n      )\n      return null\n    }\n  }\n\n  async setCollection(\n    schemaName: string,\n    data: CachedCollectionData,\n  ): Promise<void> {\n    try {\n      await this.ensureCacheDir()\n      await fs.writeFile(\n        this.collectionPath(schemaName),\n        JSON.stringify(data, null, 2),\n        'utf-8',\n      )\n    } catch (error) {\n      console.error(\n        `Error writing query collection cache for ${schemaName}:`,\n        error,\n      )\n    }\n  }\n\n  async getItem(\n    seedUid: string,\n    optionsKey: string,\n  ): Promise<CachedItemData | null> {\n    try {\n      const data = await fs.readFile(\n        this.itemPath(seedUid, optionsKey),\n        'utf-8',\n      )\n      const cached: CachedItemData = JSON.parse(data)\n      const now = Math.floor(Date.now() / 1000)\n      if (now - cached.lastUpdated > this.config.ttl) {\n        await this.clearItem(seedUid, optionsKey)\n        return null\n      }\n      return cached\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') {\n        return null\n      }\n      console.error(`Error reading query item cache for ${seedUid}:`, error)\n      return null\n    }\n  }\n\n  async setItem(data: CachedItemData): Promise<void> {\n    try {\n      await this.ensureItemsDir()\n      await fs.writeFile(\n        this.itemPath(data.record.seedUid, data.optionsKey),\n        JSON.stringify(data, null, 2),\n        'utf-8',\n      )\n    } catch (error) {\n      console.error(\n        `Error writing query item cache for ${data.record.seedUid}:`,\n        error,\n      )\n    }\n  }\n\n  async clearCollection(schemaName: string): Promise<void> {\n    try {\n      await fs.unlink(this.collectionPath(schemaName))\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        console.error(\n          `Error clearing query collection cache for ${schemaName}:`,\n          error,\n        )\n      }\n    }\n  }\n\n  async clearItem(seedUid: string, optionsKey: string): Promise<void> {\n    try {\n      await fs.unlink(this.itemPath(seedUid, optionsKey))\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code !== 'ENOENT') {\n        console.error(\n          `Error clearing query item cache for ${seedUid}:`,\n          error,\n        )\n      }\n    }\n  }\n\n  async clearAll(): Promise<void> {\n    try {\n      const files = await fs.readdir(this.cacheDir)\n      for (const file of files) {\n        if (file.endsWith('.json')) {\n          await fs.unlink(join(this.cacheDir, file))\n        }\n      }\n      const itemsDir = join(this.cacheDir, 'items')\n      try {\n        const itemFiles = await fs.readdir(itemsDir)\n        for (const file of itemFiles) {\n          if (file.endsWith('.json')) {\n            await fs.unlink(join(itemsDir, file))\n          }\n        }\n      } catch {\n        // items dir may not exist\n      }\n    } catch (error) {\n      console.error('Error clearing all query caches:', error)\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/cache/CacheManager.d.ts

@@ -1,15 +1,21 @@
 import type { GetSeedResult, SeedRecord } from '../types.js';
 import { MemoryCache } from './MemoryCache.js';
-import type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats } from './types.js';
+import type { CachedCollectionData, CachedItemData, PersistentCache, QueryCacheConfig, QueryCacheStats } from './types.js';
+type PersistentCacheFactory = (config: QueryCacheConfig) => PersistentCache | null;
 /**
- * Unified query cache: memory → disk for collections and items.
+ * Node entry (`index.node.ts`) registers FileCache here so the browser
+ * graph never statically imports `fs` / `path`.
+ */
+export declare function configurePersistentCacheFactory(factory: PersistentCacheFactory): void;
+/**
+ * Unified query cache: memory, with optional persistent (disk) layer.
  */
 export declare class CacheManager {
     private memoryCache;
-    private fileCache;
+    private persistent;
     private config;
     private stats;
-    constructor(config: QueryCacheConfig);
+    constructor(config: QueryCacheConfig, persistent?: PersistentCache | null);
     get enabled(): boolean;
     getConfig(): QueryCacheConfig;
     getCollection(schemaName: string): Promise<CachedCollectionData | null>;
@@ -34,4 +40,5 @@ export declare class CacheManager {
     };
     resetStats(): void;
 }
+export {};
 //# sourceMappingURL=CacheManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAKZ;gBAEW,MAAM,EAAE,gBAAgB;IAMpC,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,SAAS,IAAI,gBAAgB;IAIvB,aAAa,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA6BjC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAiBjC,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0B3B,OAAO,CACX,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiB3B,iBAAiB,CACrB,KAAK,EAAE,UAAU,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAOV,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACH,YAAY,CACV,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,UAAU,EAAE,GACrB,UAAU,EAAE;IAmBf;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EAAE,EACnB,sBAAsB,EAAE,MAAM,GAC7B,UAAU,EAAE;IAMf,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAKrD,QAAQ,IAAI,eAAe,GAAG;QAC5B,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;KACjD;IAOD,UAAU,IAAI,IAAI;CAQnB"}
+{"version":3,"file":"CacheManager.d.ts","sourceRoot":"","sources":["../../src/cache/CacheManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,KAAK,sBAAsB,GAAG,CAAC,MAAM,EAAE,gBAAgB,KAAK,eAAe,GAAG,IAAI,CAAA;AAIlF;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,sBAAsB,GAC9B,IAAI,CAEN;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAKZ;gBAEW,MAAM,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI;IAUzE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,SAAS,IAAI,gBAAgB;IAIvB,aAAa,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA6BjC,aAAa,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,EAAE,GAClB,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAiBjC,OAAO,CACX,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA0B3B,OAAO,CACX,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiB3B,iBAAiB,CACrB,KAAK,EAAE,UAAU,EAAE,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAOV,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,eAAe,CAAC,CAAC,EACrB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;IACH,YAAY,CACV,WAAW,EAAE,UAAU,EAAE,EACzB,QAAQ,EAAE,UAAU,EAAE,GACrB,UAAU,EAAE;IAmBf;;OAEG;IACH,gBAAgB,CACd,KAAK,EAAE,UAAU,EAAE,EACnB,sBAAsB,EAAE,MAAM,GAC7B,UAAU,EAAE;IAMf,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAKrD,QAAQ,IAAI,eAAe,GAAG;QAC5B,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAA;KACjD;IAOD,UAAU,IAAI,IAAI;CAQnB"}

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAuCvD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/cache/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAQlD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,CAqCvD"}

package/dist/cache/etag.d.ts

@@ -1,5 +1,5 @@
 /**
- * Generate an ETag from a string value (MD5, first 16 hex chars, quoted).
+ * Generate an ETag from a string value (SHA-256, first 16 hex chars, quoted).
  */
 export declare function generateETag(value: string): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/cache/etag.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,sBAAsB,EAAE,MAAM,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR"}
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../src/cache/etag.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,sBAAsB,EAAE,MAAM,EAC9B,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAIR"}

package/dist/cache/index.d.ts

@@ -1,14 +1,14 @@
 import { CacheManager } from './CacheManager.js';
-import { loadQueryCacheConfig } from './config.js';
-export { CacheManager } from './CacheManager.js';
+import type { PersistentCache, QueryCacheConfig } from './types.js';
+export { CacheManager, configurePersistentCacheFactory } from './CacheManager.js';
 export { MemoryCache } from './MemoryCache.js';
-export { FileCache } from './FileCache.js';
 export { loadQueryCacheConfig } from './config.js';
 export { generateETag, generateCollectionETag, generateItemETag, } from './etag.js';
 export { buildAssembleOptionsKey, sanitizeSeedUidForPath, } from './types.js';
-export type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats, } from './types.js';
+export type { CachedCollectionData, CachedItemData, PersistentCache, QueryCacheConfig, QueryCacheStats, } from './types.js';
 /**
  * Get the singleton query CacheManager (lazy-init from env).
+ * Browser graphs are memory-only. Node `index.node` registers FileCache.
  */
 export declare function getQueryCacheManager(): CacheManager;
 /**
@@ -17,6 +17,7 @@ export declare function getQueryCacheManager(): CacheManager;
 export declare function resetQueryCacheManager(): void;
 /**
  * Create a CacheManager with an explicit config (tests).
+ * Pass a PersistentCache (e.g. FileCache) to enable the disk layer.
  */
-export declare function createQueryCacheManager(config?: Partial<ReturnType<typeof loadQueryCacheConfig>>): CacheManager;
+export declare function createQueryCacheManager(config?: Partial<QueryCacheConfig>, persistent?: PersistentCache | null): CacheManager;
 //# 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,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAA;AAInB;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAKnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,GACxD,YAAY,CAKd"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEnE,OAAO,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,WAAW,CAAA;AAClB,OAAO,EACL,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,YAAY,CAAA;AAInB;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,YAAY,CAKnD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,UAAU,CAAC,EAAE,eAAe,GAAG,IAAI,GAClC,YAAY,CAQd"}

package/dist/cache/types.d.ts

@@ -32,6 +32,15 @@ export type QueryCacheStats = {
     refreshes: number;
     errors: number;
 };
+/** Optional disk (or other) layer under CacheManager. Browser graphs omit this. */
+export type PersistentCache = {
+    getCollection(schemaName: string): Promise<CachedCollectionData | null>;
+    setCollection(schemaName: string, data: CachedCollectionData): Promise<void>;
+    getItem(seedUid: string, optionsKey: string): Promise<CachedItemData | null>;
+    setItem(data: CachedItemData): Promise<void>;
+    clearCollection(schemaName: string): Promise<void>;
+    clearAll(): Promise<void>;
+};
 /**
  * Build a stable key for assemble options that affect cached payloads.
  * Default latest-only (`include: 'data'`) keeps Phase 2 key `e1-h1`.

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,UAAU,EACX,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CACxC,GAAG,MAAM,CAkBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cache/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,UAAU,EACX,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,aAAa,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG;IAC5B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAA;IACvE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAA;IAC5E,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B,CAAA;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,SAAS,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC,CAAA;CACxC,GAAG,MAAM,CAkBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/index.d.ts

@@ -8,7 +8,7 @@ export type { QueryDataSource, ResolvedQuerySource } from './source/index.js';
 export { buildFlatSnapshotFromProperties, diffVersionSnapshots, diffPropertyAttestations, applyChangelogFilters, decodePropertyAttestation, changelogValuesEqual, } from './changelog.js';
 export type { SeedRecord, AssembleOptions, QuerySourceMode, GetSeedOptions, GetSeedResult, ChangelogInclude, ChangelogOptions, ChangelogEntry, VersionChangelogEntry, PropertyChangelogEntry, QueryBySchemaOptions, QueryBySchemaResult, AttestationLike, } from './types.js';
 export { getQueryCacheManager, resetQueryCacheManager, createQueryCacheManager, loadQueryCacheConfig, CacheManager, buildAssembleOptionsKey, } from './cache/index.js';
-export type { CachedCollectionData, CachedItemData, QueryCacheConfig, QueryCacheStats, } from './cache/index.js';
+export type { CachedCollectionData, CachedItemData, PersistentCache, QueryCacheConfig, QueryCacheStats, } from './cache/index.js';
 export { getArweaveUrlForTransaction } from './arweaveUrl.js';
 export { publicListRelationPropertyKey, stripListRelationStorageAliasesForPublicKey, tryCoerceJsonStringArray, } from './listRelationKey.js';
 export { parseEasPropertyMetadata, parseEasPropertyMetadataForFeed, } from './parseEasPropertyMetadata.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAExE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE7E,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,EACL,6BAA6B,EAC7B,2CAA2C,EAC3C,wBAAwB,GACzB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qCAAqC,GACtC,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,YAAY,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAA;AAEtF,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAExE,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,6BAA6B,EAC7B,mBAAmB,EACnB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE7E,OAAO,EACL,+BAA+B,EAC/B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,YAAY,EACZ,uBAAuB,GACxB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EACV,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAE7D,OAAO,EACL,6BAA6B,EAC7B,2CAA2C,EAC3C,wBAAwB,GACzB,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,+BAA+B,CAAA;AACtC,YAAY,EACV,mBAAmB,EACnB,0BAA0B,EAC1B,8BAA8B,EAC9B,qCAAqC,GACtC,MAAM,+BAA+B,CAAA;AAEtC,OAAO,EAAE,4BAA4B,EAAE,MAAM,mCAAmC,CAAA;AAChF,YAAY,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAA;AAEtF,OAAO,EACL,yBAAyB,EACzB,8BAA8B,EAC9B,uBAAuB,EACvB,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,+BAA+B,EAC/B,oBAAoB,EACpB,wBAAwB,EACxB,2BAA2B,EAC3B,+BAA+B,GAChC,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAA;AAErC,OAAO,EACL,6BAA6B,EAC7B,iCAAiC,EACjC,8BAA8B,GAC/B,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAA"}