vitecache 0.2.1 → 0.4.0

package/README.md

@@ -1,41 +1,32 @@
 # vitecache
 
-Cache expensive computation as bytes, then reuse it across browser sessions and Node runs.
+Cache expensive computation as bytes: the Vite plugin computes it once in Node, then browsers and Node reuse it.
 
 ```sh
 pnpm add vitecache
 ```
 
+Wrap a computation in a class named `Cached…Loader` and load with literal arguments:
+
 ```ts
 import { CacheEntry } from "vitecache"
-import modelUrl from "./models/chair.glb?url"
-
-const entry = new CacheEntry({
-  version: "simplify@2",
-  dependencies: {
-    settings: { value: { ratio: 0.5, preserveUVs: true } },
-    algorithm: { path: "src/simplify.ts" },
-    model: { url: modelUrl },
-  },
-})
-
-let bytes = await entry.load()
-
-if (bytes === undefined) {
-  bytes = await simplify()
-  await entry.save(bytes)
+
+export class CachedMeshLoader {
+  async loadAsync(settings: { ratio: number }) {
+    const entry = new CacheEntry({ version: "simplify@2", dependencies: { settings: { value: settings } } })
+    let bytes = await entry.load()
+    if (bytes === undefined) {
+      bytes = await simplify(settings)
+      await entry.save(bytes)
+    }
+    return bytes
+  }
 }
 
-useMeshBytes(bytes)
+const mesh = await new CachedMeshLoader().loadAsync({ ratio: 0.5 })
 ```
 
-Entries identify computations by version and named dependencies: JSON `{ value }`, file `{ path }` or `{ url }`, and installed library `{ package: "elkjs" }`. Node and the Vite development plugin validate file contents and package versions without changing entry keys.
-
-Paths are always relative to the project root: `root` in Node (the working directory by default), or the Vite project root in browsers. The Vite plugin resolves served URLs to their source paths and preserves mappings for public files and emitted assets in production builds; Node accepts local file URLs.
-
-Package installation paths are excluded from identity; transitive packages need their own declarations. Load before computing so saving can detect dependencies that changed during computation.
-
-Node reads and writes `<project_root>/public/_vitecache/`. Add the plugin to save browser results into the same directory during development:
+Add the plugin:
 
 ```ts
 import { defineConfig } from "vite"
@@ -44,6 +35,6 @@ import { vitecache } from "vitecache/vite"
 export default defineConfig({ plugins: [vitecache()] })
 ```
 
-Node saves and the plugin add the cache directory to `.gitignore`. Generate caches before building and include them in your deployment. Browsers without the plugin read public cache files, assume dependencies unchanged, and warn and skip writes when `save()` is called.
+The plugin finds these loads by scanning the project's source files, computes them in Node during development and builds, and deletes entries no load uses. Browsers read the saved bytes.
 
 For usage patterns, see the [vitecache skill](skills/vitecache/SKILL.md), also shipped in this package.

package/dist/browser.d.ts

@@ -1,8 +1,11 @@
-import { Entry } from './entry.js';
-import type { CacheEntryOptions } from './types.js';
-export { MissingDependencyError } from './dependencies.js';
-export type { CacheEntryOptions, Dependency, Dependencies, JsonValue, SavedDependencies, SavedDependency, SaveOptions } from './types.js';
-/** A persistent binary computation result. Pass a browser basePath matching the public cache URL, including any Vite base. */
-export declare class CacheEntry extends Entry {
+import { type CacheEntryOptions, type SaveOptions } from './entry.js';
+export type { CacheEntryOptions, Dependency, Input, JsonValue, SaveOptions } from './entry.js';
+/** A cached result, read from the cache directory the app serves. Only Node writes entries. */
+export declare class CacheEntry {
+    #private;
     constructor(options: CacheEntryOptions);
+    /** The saved bytes, or undefined when the app serves none. */
+    load(): Promise<Uint8Array | undefined>;
+    /** Writes nothing, since browsers only read. Warns once per version that its result was computed here. */
+    save(_value: Uint8Array, _options?: SaveOptions): Promise<void>;
 }

package/dist/browser.js

@@ -1,164 +1,33 @@
-import { hashes, MissingDependencyError, paths, record, resolvedDependencies } from './dependencies.js';
-import { Entry } from './entry.js';
-export { MissingDependencyError } from './dependencies.js';
-const discoveries = new Map();
-async function discover(base) {
-    const response = await fetch(new URL('__vitecache', base), { cache: 'no-store' });
-    if (response.status === 404)
-        return false;
-    if (!response.ok)
-        throw new Error(`vitecache discovery failed: HTTP ${response.status}`);
-    // Static SPA servers may return index.html for unknown paths.
-    if (!response.headers.get('content-type')?.includes('application/json'))
-        return false;
-    const data = await response.json();
-    return typeof data === 'object' && data !== null && 'vitecache' in data && data.vitecache === 1;
-}
-function discovery(base) {
-    const existing = discoveries.get(base.href);
-    if (existing)
-        return existing;
-    const pending = discover(base).catch((error) => {
-        discoveries.delete(base.href);
-        throw error;
-    });
-    discoveries.set(base.href, pending);
-    return pending;
-}
-/** The plugin answers a missing file or package dependency with 404 and a JSON reason. */
-async function rejectMissing(response) {
-    if (response.status !== 404 || !response.headers.get('content-type')?.includes('application/json'))
-        return;
-    const error = await response.json();
-    if (typeof error === 'object' && error !== null && 'error' in error && error.error === 'missing-dependency' && 'message' in error && typeof error.message === 'string') {
-        throw new MissingDependencyError(error.message);
+import { key } from './entry.js';
+const warned = new Set();
+/** A cached result, read from the cache directory the app serves. Only Node writes entries. */
+export class CacheEntry {
+    #version;
+    #url;
+    constructor(options) {
+        this.#version = options.version;
+        const base = new URL((options.basePath ?? '/_vitecache/').replace(/\/?$/, '/'), globalThis.location.href);
+        this.#url = new URL(`${key(options)}.bin`, base);
     }
-}
-function createBackend(options) {
-    const base = new URL(options.basePath ?? '/_vitecache/', globalThis.location.href);
-    base.pathname = `${base.pathname.replace(/\/+$/, '')}/`;
-    base.search = '';
-    base.hash = '';
-    function plugin() {
-        return discovery(base);
+    /** The saved bytes, or undefined when the app serves none. */
+    async load() {
+        // An entry keeps its name when its bytes change, so the HTTP cache must revalidate them.
+        const response = await fetch(this.#url, { cache: 'no-cache' });
+        if (response.status === 404)
+            return undefined;
+        if (!response.ok)
+            throw new Error(`vitecache load failed: HTTP ${response.status}`);
+        // Vite's dev server and SPA hosts answer a missing file with index.html.
+        if (response.headers.get('content-type')?.startsWith('text/html'))
+            return undefined;
+        return new Uint8Array(await response.arrayBuffer());
     }
-    return {
-        canSave: plugin,
-        async resolve(dependencies) {
-            const locators = Object.entries(dependencies).map(([name, locator]) => {
-                if (locator.url === undefined)
-                    return [name, locator];
-                const url = new URL(locator.url, globalThis.location.href);
-                if (url.origin !== new URL(globalThis.location.href).origin)
-                    throw new Error('URL dependencies must be served by the same Vite project origin.');
-                return [name, { url: url.href }];
-            });
-            if (locators.every(([, locator]) => locator.url === undefined)) {
-                return resolvedDependencies(Object.fromEntries(locators));
-            }
-            if (await plugin()) {
-                const response = await fetch(new URL('__vitecache/resolve', base), {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ dependencies: Object.fromEntries(locators) }),
-                    cache: 'no-store',
-                });
-                await rejectMissing(response);
-                if (!response.ok)
-                    throw new Error(`vitecache URL resolution failed: HTTP ${response.status}`);
-                const data = await response.json();
-                const resolved = resolvedDependencies(record(data).dependencies);
-                if (Object.keys(resolved).length !== locators.length || !locators.every(([name]) => Object.hasOwn(resolved, name))) {
-                    throw new Error('Invalid vitecache resolved dependencies.');
-                }
-                return resolved;
-            }
-            const manifestUrl = new URL('__vitecache/paths.json', base);
-            const response = await fetch(manifestUrl, { cache: 'no-store' });
-            if (!response.ok || !response.headers.get('content-type')?.includes('application/json')) {
-                throw new Error('URL dependencies require the vitecache Vite plugin during development and build. Missing production URL mapping.');
-            }
-            const data = await response.json();
-            const manifest = record(data);
-            const mapping = paths(manifest.paths);
-            if (typeof manifest.root !== 'string' || !/^(?:\.\.\/)+$/.test(manifest.root))
-                throw new Error('Invalid vitecache production mapping root.');
-            const projectRoot = new URL(manifest.root, manifestUrl);
-            const mapped = Object.fromEntries(Object.entries(mapping).map(([url, path]) => [new URL(url, projectRoot).pathname, path]));
-            const resolved = locators.map(([name, locator]) => {
-                if (locator.url === undefined)
-                    return [name, locator];
-                const pathname = new URL(locator.url).pathname;
-                const path = mapped[pathname];
-                // The build maps every file it deployed, so an unmapped URL has no backing file, as the plugin reports in development.
-                if (path === undefined)
-                    throw new MissingDependencyError(`No vitecache source file mapping for URL: ${pathname}`);
-                return [name, { path }];
-            });
-            return resolvedDependencies(Object.fromEntries(resolved));
-        },
-        async snapshot(dependencies) {
-            if (!await plugin())
-                return { status: 'unavailable' };
-            const response = await fetch(new URL('__vitecache/snapshot', base), {
-                method: 'POST',
-                headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ dependencies }),
-                cache: 'no-store',
-            });
-            if (!response.ok)
-                throw new Error(`vitecache dependency validation failed: HTTP ${response.status}`);
-            const data = await response.json();
-            if (typeof data === 'object' && data !== null && 'status' in data && data.status === 'missing')
-                return { status: 'missing' };
-            if (typeof data !== 'object' || data === null || !('status' in data) || data.status !== 'available' || !('hashes' in data)) {
-                throw new TypeError('Invalid vitecache dependency response.');
-            }
-            return { status: 'available', hashes: hashes(data.hashes) };
-        },
-        async load(key, validate) {
-            const response = await fetch(new URL(`${key}.bin`, base), { cache: 'no-store' });
-            // The plugin answers misses with 204 so they stay out of the console; static hosts answer 404.
-            if (response.status === 204 || response.status === 404)
-                return undefined;
-            if (!response.ok)
-                throw new Error(`vitecache load failed: HTTP ${response.status}`);
-            const contentType = response.headers.get('content-type')?.split(';')[0]?.trim();
-            if (contentType === 'text/html')
-                return undefined;
-            if (contentType !== 'application/octet-stream')
-                throw new Error(`Unexpected vitecache content type: ${contentType ?? 'missing'}`);
-            const bytes = new Uint8Array(await response.arrayBuffer());
-            if (!validate)
-                return { bytes };
-            const header = response.headers.get('X-Vitecache-Dependencies');
-            if (header === null)
-                throw new Error('Missing vitecache dependency metadata.');
-            const value = JSON.parse(decodeURIComponent(header));
-            return { bytes, hashes: hashes(value) };
-        },
-        async save(key, value, validation, expected, saved) {
-            // Metadata travels in the body: headers are capped near 16 KiB, and saved dependencies can be many.
-            const metadata = new TextEncoder().encode(JSON.stringify({ dependencies: validation, hashes: expected, saved }));
-            const body = new Uint8Array(4 + metadata.byteLength + value.byteLength);
-            new DataView(body.buffer).setUint32(0, metadata.byteLength);
-            body.set(metadata, 4);
-            body.set(value, 4 + metadata.byteLength);
-            const response = await fetch(new URL(`${key}.bin`, base), {
-                method: 'PUT',
-                headers: { 'Content-Type': 'application/octet-stream' },
-                body,
-            });
-            await rejectMissing(response);
-            if (!response.ok)
-                throw new Error(`vitecache save failed: HTTP ${response.status}`);
-        },
-    };
-}
-/** A persistent binary computation result. Pass a browser basePath matching the public cache URL, including any Vite base. */
-export class CacheEntry extends Entry {
-    constructor(options) {
-        super(options, createBackend(options));
+    /** Writes nothing, since browsers only read. Warns once per version that its result was computed here. */
+    async save(_value, _options) {
+        if (warned.has(this.#version))
+            return;
+        warned.add(this.#version);
+        console.warn(`vitecache: ${this.#version} was computed in the browser, which does not save it.`);
     }
 }
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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","sourcesContent":["import { hashes, MissingDependencyError, paths, record, resolvedDependencies } from './dependencies.js';\nimport { Entry } from './entry.js';\nimport type { Backend, CacheEntryOptions, Dependency, ResolvedDependency } from './types.js';\nexport { MissingDependencyError } from './dependencies.js';\nexport type { CacheEntryOptions, Dependency, Dependencies, JsonValue, SavedDependencies, SavedDependency, SaveOptions } from './types.js';\n\nconst discoveries = new Map<string, Promise<boolean>>();\n\nasync function discover(base: URL): Promise<boolean> {\n  const response = await fetch(new URL('__vitecache', base), { cache: 'no-store' });\n  if (response.status === 404) return false;\n  if (!response.ok) throw new Error(`vitecache discovery failed: HTTP ${response.status}`);\n  // Static SPA servers may return index.html for unknown paths.\n  if (!response.headers.get('content-type')?.includes('application/json')) return false;\n  const data: unknown = await response.json();\n  return typeof data === 'object' && data !== null && 'vitecache' in data && data.vitecache === 1;\n}\n\nfunction discovery(base: URL): Promise<boolean> {\n  const existing = discoveries.get(base.href);\n  if (existing) return existing;\n  const pending = discover(base).catch((error: unknown) => {\n    discoveries.delete(base.href);\n    throw error;\n  });\n  discoveries.set(base.href, pending);\n  return pending;\n}\n\n/** The plugin answers a missing file or package dependency with 404 and a JSON reason. */\nasync function rejectMissing(response: Response): Promise<void> {\n  if (response.status !== 404 || !response.headers.get('content-type')?.includes('application/json')) return;\n  const error: unknown = await response.json();\n  if (typeof error === 'object' && error !== null && 'error' in error && error.error === 'missing-dependency' && 'message' in error && typeof error.message === 'string') {\n    throw new MissingDependencyError(error.message);\n  }\n}\n\nfunction createBackend(options: CacheEntryOptions): Backend {\n  const base = new URL(options.basePath ?? '/_vitecache/', globalThis.location.href);\n  base.pathname = `${base.pathname.replace(/\\/+$/, '')}/`;\n  base.search = '';\n  base.hash = '';\n\n  function plugin(): Promise<boolean> {\n    return discovery(base);\n  }\n\n  return {\n    canSave: plugin,\n    async resolve(dependencies) {\n      const locators = Object.entries(dependencies).map(([name, locator]): [string, Dependency] => {\n        if (locator.url === undefined) return [name, locator];\n        const url = new URL(locator.url, globalThis.location.href);\n        if (url.origin !== new URL(globalThis.location.href).origin) throw new Error('URL dependencies must be served by the same Vite project origin.');\n        return [name, { url: url.href }];\n      });\n      if (locators.every(([, locator]) => locator.url === undefined)) {\n        return resolvedDependencies(Object.fromEntries(locators));\n      }\n      if (await plugin()) {\n        const response = await fetch(new URL('__vitecache/resolve', base), {\n          method: 'POST',\n          headers: { 'Content-Type': 'application/json' },\n          body: JSON.stringify({ dependencies: Object.fromEntries(locators) }),\n          cache: 'no-store',\n        });\n        await rejectMissing(response);\n        if (!response.ok) throw new Error(`vitecache URL resolution failed: HTTP ${response.status}`);\n        const data: unknown = await response.json();\n        const resolved = resolvedDependencies(record(data).dependencies);\n        if (Object.keys(resolved).length !== locators.length || !locators.every(([name]) => Object.hasOwn(resolved, name))) {\n          throw new Error('Invalid vitecache resolved dependencies.');\n        }\n        return resolved;\n      }\n      const manifestUrl = new URL('__vitecache/paths.json', base);\n      const response = await fetch(manifestUrl, { cache: 'no-store' });\n      if (!response.ok || !response.headers.get('content-type')?.includes('application/json')) {\n        throw new Error('URL dependencies require the vitecache Vite plugin during development and build. Missing production URL mapping.');\n      }\n      const data: unknown = await response.json();\n      const manifest = record(data);\n      const mapping = paths(manifest.paths);\n      if (typeof manifest.root !== 'string' || !/^(?:\\.\\.\\/)+$/.test(manifest.root)) throw new Error('Invalid vitecache production mapping root.');\n      const projectRoot = new URL(manifest.root, manifestUrl);\n      const mapped = Object.fromEntries(Object.entries(mapping).map(([url, path]) => [new URL(url, projectRoot).pathname, path]));\n      const resolved = locators.map(([name, locator]): [string, ResolvedDependency] => {\n        if (locator.url === undefined) return [name, locator];\n        const pathname = new URL(locator.url).pathname;\n        const path = mapped[pathname];\n        // The build maps every file it deployed, so an unmapped URL has no backing file, as the plugin reports in development.\n        if (path === undefined) throw new MissingDependencyError(`No vitecache source file mapping for URL: ${pathname}`);\n        return [name, { path }];\n      });\n      return resolvedDependencies(Object.fromEntries(resolved));\n    },\n    async snapshot(dependencies) {\n      if (!await plugin()) return { status: 'unavailable' };\n      const response = await fetch(new URL('__vitecache/snapshot', base), {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ dependencies }),\n        cache: 'no-store',\n      });\n      if (!response.ok) throw new Error(`vitecache dependency validation failed: HTTP ${response.status}`);\n      const data: unknown = await response.json();\n      if (typeof data === 'object' && data !== null && 'status' in data && data.status === 'missing') return { status: 'missing' };\n      if (typeof data !== 'object' || data === null || !('status' in data) || data.status !== 'available' || !('hashes' in data)) {\n        throw new TypeError('Invalid vitecache dependency response.');\n      }\n      return { status: 'available', hashes: hashes(data.hashes) };\n    },\n    async load(key, validate) {\n      const response = await fetch(new URL(`${key}.bin`, base), { cache: 'no-store' });\n      // The plugin answers misses with 204 so they stay out of the console; static hosts answer 404.\n      if (response.status === 204 || response.status === 404) return undefined;\n      if (!response.ok) throw new Error(`vitecache load failed: HTTP ${response.status}`);\n      const contentType = response.headers.get('content-type')?.split(';')[0]?.trim();\n      if (contentType === 'text/html') return undefined;\n      if (contentType !== 'application/octet-stream') throw new Error(`Unexpected vitecache content type: ${contentType ?? 'missing'}`);\n      const bytes = new Uint8Array(await response.arrayBuffer());\n      if (!validate) return { bytes };\n      const header = response.headers.get('X-Vitecache-Dependencies');\n      if (header === null) throw new Error('Missing vitecache dependency metadata.');\n      const value: unknown = JSON.parse(decodeURIComponent(header));\n      return { bytes, hashes: hashes(value) };\n    },\n    async save(key, value, validation, expected, saved) {\n      // Metadata travels in the body: headers are capped near 16 KiB, and saved dependencies can be many.\n      const metadata = new TextEncoder().encode(JSON.stringify({ dependencies: validation, hashes: expected, saved }));\n      const body = new Uint8Array(4 + metadata.byteLength + value.byteLength);\n      new DataView(body.buffer).setUint32(0, metadata.byteLength);\n      body.set(metadata, 4);\n      body.set(value, 4 + metadata.byteLength);\n      const response = await fetch(new URL(`${key}.bin`, base), {\n        method: 'PUT',\n        headers: { 'Content-Type': 'application/octet-stream' },\n        body,\n      });\n      await rejectMissing(response);\n      if (!response.ok) throw new Error(`vitecache save failed: HTTP ${response.status}`);\n    },\n  };\n}\n\n/** A persistent binary computation result. Pass a browser basePath matching the public cache URL, including any Vite base. */\nexport class CacheEntry extends Entry {\n  constructor(options: CacheEntryOptions) {\n    super(options, createBackend(options));\n  }\n}\n"]}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAA4C,MAAM,YAAY,CAAC;AAG3E,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjC,+FAA+F;AAC/F,MAAM,OAAO,UAAU;IACZ,QAAQ,CAAS;IACjB,IAAI,CAAM;IAEnB,YAAY,OAA0B;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1G,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,IAAI;QACR,yFAAyF;QACzF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAS,CAAC;QAC9C,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACpF,yEAAyE;QACzE,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QACpF,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,0GAA0G;IAC1G,KAAK,CAAC,IAAI,CAAC,MAAkB,EAAE,QAAsB;QACnD,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QACtC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,cAAc,IAAI,CAAC,QAAQ,uDAAuD,CAAC,CAAC;IACnG,CAAC;CACF","sourcesContent":["import { key, type CacheEntryOptions, type SaveOptions } from './entry.js';\nexport type { CacheEntryOptions, Dependency, Input, JsonValue, SaveOptions } from './entry.js';\n\nconst warned = new Set<string>();\n\n/** A cached result, read from the cache directory the app serves. Only Node writes entries. */\nexport class CacheEntry {\n  readonly #version: string;\n  readonly #url: URL;\n\n  constructor(options: CacheEntryOptions) {\n    this.#version = options.version;\n    const base = new URL((options.basePath ?? '/_vitecache/').replace(/\\/?$/, '/'), globalThis.location.href);\n    this.#url = new URL(`${key(options)}.bin`, base);\n  }\n\n  /** The saved bytes, or undefined when the app serves none. */\n  async load(): Promise<Uint8Array | undefined> {\n    // An entry keeps its name when its bytes change, so the HTTP cache must revalidate them.\n    const response = await fetch(this.#url, { cache: 'no-cache' });\n    if (response.status === 404) return undefined;\n    if (!response.ok) throw new Error(`vitecache load failed: HTTP ${response.status}`);\n    // Vite's dev server and SPA hosts answer a missing file with index.html.\n    if (response.headers.get('content-type')?.startsWith('text/html')) return undefined;\n    return new Uint8Array(await response.arrayBuffer());\n  }\n\n  /** Writes nothing, since browsers only read. Warns once per version that its result was computed here. */\n  async save(_value: Uint8Array, _options?: SaveOptions): Promise<void> {\n    if (warned.has(this.#version)) return;\n    warned.add(this.#version);\n    console.warn(`vitecache: ${this.#version} was computed in the browser, which does not save it.`);\n  }\n}\n"]}

package/dist/discover.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from './entry.js';
+/** A `loadAsync(...args)` of a cached loader that discovery found, which warming repeats on a `new` loader in Node. */
+export interface Load {
+    importer: string;
+    /** Where in the importer the load is, as `line:column`. */
+    position: string;
+    source: string;
+    name: string;
+    args: JsonValue[];
+}
+/**
+ * The cached loader loads in a module: `new Loader(...).loadAsync(...)`, or `loadAsync(...)` on a variable initialized
+ * with `new Loader(...)`. Any other use of a loader or such a variable fails, since warming could not repeat it.
+ */
+export declare function discover(code: string, importer: string): Load[];

package/dist/discover.js

@@ -0,0 +1,131 @@
+import JSON5 from 'json5';
+import { parseSync, Visitor } from 'vite';
+/**
+ * The convention that marks a class as a cached loader: its loadAsync computes a result once and saves it. Warming
+ * constructs it without arguments, so only loadAsync's arguments may select the result.
+ */
+const loader = /^Cached\w*Loader$/;
+/**
+ * The cached loader loads in a module: `new Loader(...).loadAsync(...)`, or `loadAsync(...)` on a variable initialized
+ * with `new Loader(...)`. Any other use of a loader or such a variable fails, since warming could not repeat it.
+ */
+export function discover(code, importer) {
+    const at = (offset) => {
+        const lines = code.slice(0, offset).split('\n');
+        return `${lines.length}:${(lines.at(-1)?.length ?? 0) + 1}`;
+    };
+    const fail = (message, offset) => {
+        throw new Error(`${message} at ${importer}:${at(offset)}`);
+    };
+    const { program, errors } = parseSync(importer, code);
+    if (errors[0])
+        fail(errors[0].message, errors[0].labels[0]?.start ?? 0);
+    const imports = new Map();
+    const namespaces = new Map();
+    for (const statement of program.body) {
+        if (statement.type !== 'ImportDeclaration')
+            continue;
+        for (const specifier of statement.specifiers) {
+            if (specifier.type === 'ImportNamespaceSpecifier')
+                namespaces.set(specifier.local.name, statement.source.value);
+            if (specifier.type !== 'ImportSpecifier')
+                continue;
+            const name = specifier.imported.type === 'Literal' ? specifier.imported.value : specifier.imported.name;
+            if (loader.test(name))
+                imports.set(specifier.local.name, { source: statement.source.value, name });
+        }
+    }
+    /** Nodes that name a loader or loader variable without using its value. */
+    const allowed = new Set();
+    // JSON5 is the literal subset of JavaScript: unquoted keys, single quotes, signed numbers.
+    const literal = (node) => {
+        try {
+            return JSON5.parse(code.slice(node.start, node.end));
+        }
+        catch {
+            return fail('Cached loader loadAsync arguments must be literal JSON', node.start);
+        }
+    };
+    const target = (node) => {
+        if (node.type === 'Identifier')
+            return imports.get(node.name);
+        if (node.type !== 'MemberExpression' || node.computed || node.object.type !== 'Identifier')
+            return undefined;
+        const source = namespaces.get(node.object.name);
+        return source !== undefined && loader.test(node.property.name) ? { source, name: node.property.name } : undefined;
+    };
+    const created = (node) => {
+        const loaded = target(node.callee);
+        if (loaded)
+            allowed.add(node.callee);
+        return loaded;
+    };
+    // A first pass, since a variable can be used above its declaration, as in a function declared earlier.
+    const instances = new Map();
+    new Visitor({
+        VariableDeclarator(node) {
+            if (node.id.type !== 'Identifier' || node.init?.type !== 'NewExpression')
+                return;
+            const instance = created(node.init);
+            if (!instance)
+                return;
+            instances.set(node.id.name, instance);
+            allowed.add(node.id);
+        },
+    }).visit(program);
+    const member = (node) => {
+        if (!node.computed)
+            allowed.add(node.key);
+    };
+    const misused = (node) => fail('Use cached loaders only as new Loader().loadAsync(), or a variable of one', node.start);
+    const loads = [];
+    new Visitor({
+        ImportSpecifier: (node) => allowed.add(node.local).add(node.imported),
+        // Loads through an exported loader variable happen in other modules, out of discovery's reach.
+        ExportSpecifier(node) {
+            if (node.local.type === 'Identifier' && instances.has(node.local.name))
+                misused(node);
+            allowed.add(node.local).add(node.exported);
+        },
+        ExportNamedDeclaration(node) {
+            if (node.declaration?.type !== 'VariableDeclaration')
+                return;
+            for (const { id } of node.declaration.declarations)
+                if (id.type === 'Identifier' && instances.has(id.name))
+                    misused(id);
+        },
+        Property(node) {
+            if (!node.shorthand)
+                member(node);
+        },
+        MethodDefinition: member,
+        PropertyDefinition: member,
+        CallExpression(node) {
+            const { callee } = node;
+            if (callee.type !== 'MemberExpression' || callee.computed || callee.property.name !== 'loadAsync')
+                return;
+            const { object } = callee;
+            const instance = object.type === 'NewExpression'
+                ? created(object)
+                : object.type === 'Identifier'
+                    ? instances.get(object.name)
+                    : undefined;
+            if (!instance)
+                return;
+            allowed.add(object);
+            loads.push({ importer, position: at(node.start), ...instance, args: node.arguments.map(literal) });
+        },
+        MemberExpression(node) {
+            if (!node.computed)
+                allowed.add(node.property);
+            if (target(node) && !allowed.has(node))
+                misused(node);
+        },
+        Identifier(node) {
+            if ((imports.has(node.name) || instances.has(node.name)) && !allowed.has(node))
+                misused(node);
+        },
+    }).visit(program);
+    return loads;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,OAAO,EAAe,MAAM,MAAM,CAAC;AAavD;;;GAGG;AACH,MAAM,MAAM,GAAG,mBAAmB,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,EAAE,GAAG,CAAC,MAAc,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,MAAc,EAAS,EAAE;QACtD,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,OAAO,QAAQ,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,CAAC,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IACxE,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4C,CAAC;IACpE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,IAAI,KAAK,mBAAmB;YAAE,SAAS;QACrD,KAAK,MAAM,SAAS,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YAC7C,IAAI,SAAS,CAAC,IAAI,KAAK,0BAA0B;gBAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChH,IAAI,SAAS,CAAC,IAAI,KAAK,iBAAiB;gBAAE,SAAS;YACnD,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;YACxG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;IACD,2EAA2E;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAe,CAAC;IACvC,2FAA2F;IAC3F,MAAM,OAAO,GAAG,CAAC,IAAqB,EAAE,EAAE;QACxC,IAAI,CAAC;YACH,OAAO,KAAK,CAAC,KAAK,CAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,wDAAwD,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACpF,CAAC;IACH,CAAC,CAAC;IACF,MAAM,MAAM,GAAG,CAAC,IAAiB,EAAE,EAAE;QACnC,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,SAAS,CAAC;QAC7G,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACpH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,IAA0B,EAAE,EAAE;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IACF,uGAAuG;IACvG,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4C,CAAC;IACtE,IAAI,OAAO,CAAC;QACV,kBAAkB,CAAC,IAAI;YACrB,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,KAAK,eAAe;gBAAE,OAAO;YACjF,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;KACF,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClB,MAAM,MAAM,GAAG,CAAC,IAA6C,EAAE,EAAE;QAC/D,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,IAAiB,EAAE,EAAE,CACpC,IAAI,CAAC,2EAA2E,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAChG,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,OAAO,CAAC;QACV,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;QACrE,+FAA+F;QAC/F,eAAe,CAAC,IAAI;YAClB,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YACtF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,sBAAsB,CAAC,IAAI;YACzB,IAAI,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,qBAAqB;gBAAE,OAAO;YAC7D,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,YAAY;gBAChD,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC;oBAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,QAAQ,CAAC,IAAI;YACX,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,gBAAgB,EAAE,MAAM;QACxB,kBAAkB,EAAE,MAAM;QAC1B,cAAc,CAAC,IAAI;YACjB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;YACxB,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW;gBAAE,OAAO;YAC1G,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;YAC1B,MAAM,QAAQ,GACZ,MAAM,CAAC,IAAI,KAAK,eAAe;gBAC7B,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;gBACjB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;oBAC5B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC5B,CAAC,CAAC,SAAS,CAAC;YAClB,IAAI,CAAC,QAAQ;gBAAE,OAAO;YACtB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,gBAAgB,CAAC,IAAI;YACnB,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QACD,UAAU,CAAC,IAAI;YACb,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChG,CAAC;KACF,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClB,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import JSON5 from 'json5';\nimport { parseSync, Visitor, type ESTree } from 'vite';\nimport type { JsonValue } from './entry.js';\n\n/** A `loadAsync(...args)` of a cached loader that discovery found, which warming repeats on a `new` loader in Node. */\nexport interface Load {\n  importer: string;\n  /** Where in the importer the load is, as `line:column`. */\n  position: string;\n  source: string;\n  name: string;\n  args: JsonValue[];\n}\n\n/**\n * The convention that marks a class as a cached loader: its loadAsync computes a result once and saves it. Warming\n * constructs it without arguments, so only loadAsync's arguments may select the result.\n */\nconst loader = /^Cached\\w*Loader$/;\n\n/**\n * The cached loader loads in a module: `new Loader(...).loadAsync(...)`, or `loadAsync(...)` on a variable initialized\n * with `new Loader(...)`. Any other use of a loader or such a variable fails, since warming could not repeat it.\n */\nexport function discover(code: string, importer: string): Load[] {\n  const at = (offset: number) => {\n    const lines = code.slice(0, offset).split('\\n');\n    return `${lines.length}:${(lines.at(-1)?.length ?? 0) + 1}`;\n  };\n  const fail = (message: string, offset: number): never => {\n    throw new Error(`${message} at ${importer}:${at(offset)}`);\n  };\n  const { program, errors } = parseSync(importer, code);\n  if (errors[0]) fail(errors[0].message, errors[0].labels[0]?.start ?? 0);\n  const imports = new Map<string, { source: string; name: string }>();\n  const namespaces = new Map<string, string>();\n  for (const statement of program.body) {\n    if (statement.type !== 'ImportDeclaration') continue;\n    for (const specifier of statement.specifiers) {\n      if (specifier.type === 'ImportNamespaceSpecifier') namespaces.set(specifier.local.name, statement.source.value);\n      if (specifier.type !== 'ImportSpecifier') continue;\n      const name = specifier.imported.type === 'Literal' ? specifier.imported.value : specifier.imported.name;\n      if (loader.test(name)) imports.set(specifier.local.name, { source: statement.source.value, name });\n    }\n  }\n  /** Nodes that name a loader or loader variable without using its value. */\n  const allowed = new Set<ESTree.Node>();\n  // JSON5 is the literal subset of JavaScript: unquoted keys, single quotes, signed numbers.\n  const literal = (node: ESTree.Argument) => {\n    try {\n      return JSON5.parse<JsonValue>(code.slice(node.start, node.end));\n    } catch {\n      return fail('Cached loader loadAsync arguments must be literal JSON', node.start);\n    }\n  };\n  const target = (node: ESTree.Node) => {\n    if (node.type === 'Identifier') return imports.get(node.name);\n    if (node.type !== 'MemberExpression' || node.computed || node.object.type !== 'Identifier') return undefined;\n    const source = namespaces.get(node.object.name);\n    return source !== undefined && loader.test(node.property.name) ? { source, name: node.property.name } : undefined;\n  };\n  const created = (node: ESTree.NewExpression) => {\n    const loaded = target(node.callee);\n    if (loaded) allowed.add(node.callee);\n    return loaded;\n  };\n  // A first pass, since a variable can be used above its declaration, as in a function declared earlier.\n  const instances = new Map<string, { source: string; name: string }>();\n  new Visitor({\n    VariableDeclarator(node) {\n      if (node.id.type !== 'Identifier' || node.init?.type !== 'NewExpression') return;\n      const instance = created(node.init);\n      if (!instance) return;\n      instances.set(node.id.name, instance);\n      allowed.add(node.id);\n    },\n  }).visit(program);\n  const member = (node: { computed: boolean; key: ESTree.Node }) => {\n    if (!node.computed) allowed.add(node.key);\n  };\n  const misused = (node: ESTree.Node) =>\n    fail('Use cached loaders only as new Loader().loadAsync(), or a variable of one', node.start);\n  const loads: Load[] = [];\n  new Visitor({\n    ImportSpecifier: (node) => allowed.add(node.local).add(node.imported),\n    // Loads through an exported loader variable happen in other modules, out of discovery's reach.\n    ExportSpecifier(node) {\n      if (node.local.type === 'Identifier' && instances.has(node.local.name)) misused(node);\n      allowed.add(node.local).add(node.exported);\n    },\n    ExportNamedDeclaration(node) {\n      if (node.declaration?.type !== 'VariableDeclaration') return;\n      for (const { id } of node.declaration.declarations)\n        if (id.type === 'Identifier' && instances.has(id.name)) misused(id);\n    },\n    Property(node) {\n      if (!node.shorthand) member(node);\n    },\n    MethodDefinition: member,\n    PropertyDefinition: member,\n    CallExpression(node) {\n      const { callee } = node;\n      if (callee.type !== 'MemberExpression' || callee.computed || callee.property.name !== 'loadAsync') return;\n      const { object } = callee;\n      const instance =\n        object.type === 'NewExpression'\n          ? created(object)\n          : object.type === 'Identifier'\n            ? instances.get(object.name)\n            : undefined;\n      if (!instance) return;\n      allowed.add(object);\n      loads.push({ importer, position: at(node.start), ...instance, args: node.arguments.map(literal) });\n    },\n    MemberExpression(node) {\n      if (!node.computed) allowed.add(node.property);\n      if (target(node) && !allowed.has(node)) misused(node);\n    },\n    Identifier(node) {\n      if ((imports.has(node.name) || instances.has(node.name)) && !allowed.has(node)) misused(node);\n    },\n  }).visit(program);\n  return loads;\n}\n"]}

package/dist/disk.d.ts

@@ -1,10 +1,3 @@
-import type { CacheEntryOptions } from './types.js';
 export declare function missing(error: unknown): boolean;
-export declare function missingDependency(error: unknown): boolean;
-export declare function location(options: Pick<CacheEntryOptions, 'root' | 'basePath'>): {
-    root: string;
-    directory: string;
-};
-export declare function ignore(root: string, directory: string): Promise<void>;
-export declare function load(path: string): Promise<Uint8Array | undefined>;
-export declare function save(path: string, value: Uint8Array, beforeCommit?: () => Promise<void>): Promise<void>;
+/** The file's bytes, or undefined when it does not exist. */
+export declare function read(path: string): Promise<Uint8Array | undefined>;

package/dist/disk.js

@@ -1,71 +1,17 @@
-import { randomUUID } from 'node:crypto';
-import { appendFile, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { readFile } from 'node:fs/promises';
 export function missing(error) {
-    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+    return error instanceof Error && 'code' in error && (error.code === 'ENOENT' || error.code === 'ENOTDIR');
 }
-export function missingDependency(error) {
-    return missing(error) || (error instanceof Error && 'code' in error && error.code === 'ENOTDIR');
-}
-export function location(options) {
-    const root = resolve(options.root ?? process.cwd());
-    return { root, directory: resolve(root, options.basePath ?? 'public/_vitecache') };
-}
-const pending = new Map();
-export function ignore(root, directory) {
-    const key = `${root}\0${directory}`;
-    const existing = pending.get(key);
-    if (existing)
-        return existing;
-    const result = updateIgnore(root, directory).finally(() => pending.delete(key));
-    pending.set(key, result);
-    return result;
-}
-async function updateIgnore(root, directory) {
-    const path = relative(root, directory);
-    if (!path || path === '..' || path.startsWith(`..${sep}`) || isAbsolute(path))
-        return;
-    const entry = `${path.split(sep).join('/').replace(/[!*?[\]# ]/g, '\\$&')}/*`;
-    const file = join(root, '.gitignore');
-    await mkdir(root, { recursive: true });
-    let contents = '';
-    try {
-        contents = await readFile(file, 'utf8');
-    }
-    catch (error) {
-        if (!missing(error))
-            throw error;
-    }
-    if (contents.split(/\r?\n/).includes(entry))
-        return;
-    await appendFile(file, `${contents && !contents.endsWith('\n') ? '\n' : ''}${entry}\n`);
-}
-export async function load(path) {
+/** The file's bytes, or undefined when it does not exist. */
+export async function read(path) {
     try {
-        return await readFile(path);
+        // A plain Uint8Array owning its buffer, as a browser's response gives, rather than a Buffer.
+        return new Uint8Array(await readFile(path));
     }
     catch (error) {
-        if (!missing(error))
-            throw error;
-        return undefined;
-    }
-}
-export async function save(path, value, beforeCommit) {
-    await mkdir(dirname(path), { recursive: true });
-    const temporary = `${path}.${randomUUID()}.tmp`;
-    try {
-        await writeFile(temporary, value, { flag: 'wx' });
-        await beforeCommit?.();
-        await rename(temporary, path);
-    }
-    finally {
-        try {
-            await unlink(temporary);
-        }
-        catch (error) {
-            if (!missing(error))
-                throw error;
-        }
+        if (missing(error))
+            return undefined;
+        throw error;
     }
 }
 //# sourceMappingURL=disk.js.map

package/dist/disk.js.map

@@ -1 +1 @@
-{"version":3,"file":"disk.js","sourceRoot":"","sources":["../src/disk.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { appendFile, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport type { CacheEntryOptions } from './types.js';\n\nexport function missing(error: unknown): boolean {\n  return error instanceof Error && 'code' in error && error.code === 'ENOENT';\n}\n\nexport function missingDependency(error: unknown): boolean {\n  return missing(error) || (error instanceof Error && 'code' in error && error.code === 'ENOTDIR');\n}\n\nexport function location(options: Pick<CacheEntryOptions, 'root' | 'basePath'>): { root: string; directory: string } {\n  const root = resolve(options.root ?? process.cwd());\n  return { root, directory: resolve(root, options.basePath ?? 'public/_vitecache') };\n}\n\nconst pending = new Map<string, Promise<void>>();\n\nexport function ignore(root: string, directory: string): Promise<void> {\n  const key = `${root}\\0${directory}`;\n  const existing = pending.get(key);\n  if (existing) return existing;\n  const result = updateIgnore(root, directory).finally(() => pending.delete(key));\n  pending.set(key, result);\n  return result;\n}\n\nasync function updateIgnore(root: string, directory: string): Promise<void> {\n  const path = relative(root, directory);\n  if (!path || path === '..' || path.startsWith(`..${sep}`) || isAbsolute(path)) return;\n  const entry = `${path.split(sep).join('/').replace(/[!*?[\\]# ]/g, '\\\\$&')}/*`;\n  const file = join(root, '.gitignore');\n  await mkdir(root, { recursive: true });\n  let contents = '';\n  try {\n    contents = await readFile(file, 'utf8');\n  } catch (error) {\n    if (!missing(error)) throw error;\n  }\n  if (contents.split(/\\r?\\n/).includes(entry)) return;\n  await appendFile(file, `${contents && !contents.endsWith('\\n') ? '\\n' : ''}${entry}\\n`);\n}\n\nexport async function load(path: string): Promise<Uint8Array | undefined> {\n  try {\n    return await readFile(path);\n  } catch (error) {\n    if (!missing(error)) throw error;\n    return undefined;\n  }\n}\n\nexport async function save(path: string, value: Uint8Array, beforeCommit?: () => Promise<void>): Promise<void> {\n  await mkdir(dirname(path), { recursive: true });\n  const temporary = `${path}.${randomUUID()}.tmp`;\n  try {\n    await writeFile(temporary, value, { flag: 'wx' });\n    await beforeCommit?.();\n    await rename(temporary, path);\n  } finally {\n    try {\n      await unlink(temporary);\n    } catch (error) {\n      if (!missing(error)) throw error;\n    }\n  }\n}\n"]}
+{"version":3,"file":"disk.js","sourceRoot":"","sources":["../src/disk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC5G,CAAC;AAED,6DAA6D;AAC7D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAY;IACrC,IAAI,CAAC;QACH,6FAA6F;QAC7F,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\n\nexport function missing(error: unknown): boolean {\n  return error instanceof Error && 'code' in error && (error.code === 'ENOENT' || error.code === 'ENOTDIR');\n}\n\n/** The file's bytes, or undefined when it does not exist. */\nexport async function read(path: string): Promise<Uint8Array | undefined> {\n  try {\n    // A plain Uint8Array owning its buffer, as a browser's response gives, rather than a Buffer.\n    return new Uint8Array(await readFile(path));\n  } catch (error) {\n    if (missing(error)) return undefined;\n    throw error;\n  }\n}\n"]}