vitecache 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Drawcall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,49 @@
-# Temporary Holding Version
+# vitecache
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Cache expensive computation as bytes, then reuse it across browser sessions and Node runs.
+
+```sh
+pnpm add vitecache
+```
+
+```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)
+}
+
+useMeshBytes(bytes)
+```
+
+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:
+
+```ts
+import { defineConfig } from "vite"
+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.
+
+For usage patterns, see the [vitecache skill](skills/vitecache/SKILL.md), also shipped in this package.

package/dist/browser.d.ts

@@ -0,0 +1,7 @@
+import { Entry } from './entry.js';
+import type { CacheEntryOptions } from './types.js';
+export type { CacheEntryOptions, Dependency, Dependencies, JsonValue } 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 {
+    constructor(options: CacheEntryOptions);
+}

package/dist/browser.js

@@ -0,0 +1,136 @@
+import { hashes, paths, record, resolvedDependencies } from './dependencies.js';
+import { Entry } from './entry.js';
+function createBackend(options) {
+    const base = new URL(`${(options.basePath ?? '/_vitecache/').replace(/\/+$/, '')}/`, globalThis.location.href);
+    let discovery;
+    async function discover() {
+        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 plugin() {
+        discovery ??= discover().catch((error) => {
+            discovery = undefined;
+            throw error;
+        });
+        return discovery;
+    }
+    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',
+                });
+                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];
+                if (path === undefined)
+                    throw new Error(`No vitecache source file mapping for URL: ${pathname}`);
+                return [name, { path }];
+            });
+            return resolvedDependencies(Object.fromEntries(resolved));
+        },
+        async snapshot(dependencies) {
+            if (!await plugin())
+                return undefined;
+            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 || !('hashes' in data)) {
+                throw new TypeError('Invalid vitecache dependency response.');
+            }
+            return data.hashes === null ? null : hashes(data.hashes);
+        },
+        async load(key, validate) {
+            const response = await fetch(new URL(`${key}.bin`, base), { cache: 'no-store' });
+            if (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, dependencies, expected) {
+            const response = await fetch(new URL(`${key}.bin`, base), {
+                method: 'PUT',
+                headers: {
+                    'Content-Type': 'application/octet-stream',
+                    'X-Vitecache-Dependencies': encodeURIComponent(JSON.stringify(dependencies)),
+                    'X-Vitecache-Hashes': encodeURIComponent(JSON.stringify(expected)),
+                },
+                body: new Uint8Array(value),
+            });
+            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));
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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","sourcesContent":["import { hashes, paths, record, resolvedDependencies } from './dependencies.js';\nimport { Entry } from './entry.js';\nimport type { Backend, CacheEntryOptions, Dependency, ResolvedDependency } from './types.js';\nexport type { CacheEntryOptions, Dependency, Dependencies, JsonValue } from './types.js';\n\nfunction createBackend(options: CacheEntryOptions): Backend {\n  const base = new URL(`${(options.basePath ?? '/_vitecache/').replace(/\\/+$/, '')}/`, globalThis.location.href);\n  let discovery: Promise<boolean> | undefined;\n\n  async function discover(): 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\n  function plugin(): Promise<boolean> {\n    discovery ??= discover().catch((error: unknown) => {\n      discovery = undefined;\n      throw error;\n    });\n    return discovery;\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        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        if (path === undefined) throw new Error(`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 undefined;\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 || !('hashes' in data)) {\n        throw new TypeError('Invalid vitecache dependency response.');\n      }\n      return data.hashes === null ? null : hashes(data.hashes);\n    },\n    async load(key, validate) {\n      const response = await fetch(new URL(`${key}.bin`, base), { cache: 'no-store' });\n      if (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, dependencies, expected) {\n      const response = await fetch(new URL(`${key}.bin`, base), {\n        method: 'PUT',\n        headers: {\n          'Content-Type': 'application/octet-stream',\n          'X-Vitecache-Dependencies': encodeURIComponent(JSON.stringify(dependencies)),\n          'X-Vitecache-Hashes': encodeURIComponent(JSON.stringify(expected)),\n        },\n        body: new Uint8Array(value),\n      });\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"]}

package/dist/dependencies.d.ts

@@ -0,0 +1,9 @@
+import type { Dependencies, Hashes, JsonValue, Paths, ResolvedDependencies } from './types.js';
+export declare function record(value: unknown): Record<string, unknown>;
+export declare function paths(value: unknown): Paths;
+/** Validate and snapshot JSON before asynchronous dependency resolution starts. */
+export declare function json(value: unknown, ancestors?: Set<object>): JsonValue;
+export declare function dependencies(value: unknown): Dependencies;
+export declare function resolvedDependencies(value: unknown): ResolvedDependencies;
+export declare function hashes(value: unknown): Hashes;
+export declare function equalHashes(first: Hashes, second: Hashes): boolean;

package/dist/dependencies.js

@@ -0,0 +1,118 @@
+export function record(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw new TypeError('Expected a named dependency record.');
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null)
+        throw new TypeError('Expected a plain dependency record.');
+    if (Object.getOwnPropertySymbols(value).length)
+        throw new TypeError('Dependency names must be strings.');
+    return Object.fromEntries(Object.keys(value).sort().map((name) => {
+        const property = Object.getOwnPropertyDescriptor(value, name);
+        if (!property || !('value' in property))
+            throw new TypeError('Dependency getters are not supported.');
+        const item = property.value;
+        return [name, item];
+    }));
+}
+function path(value) {
+    if (typeof value !== 'string' || !value || value.includes('\0'))
+        throw new TypeError('File dependencies require nonempty paths.');
+    if (/^(?:[\\/]|[a-z]:|[a-z][a-z\d+.-]*:\/\/)/i.test(value)) {
+        throw new TypeError('File dependency paths must be relative to the project root.');
+    }
+    const parts = [];
+    for (const part of value.replace(/\\/g, '/').split('/')) {
+        if (!part || part === '.')
+            continue;
+        if (part !== '..') {
+            parts.push(part);
+            continue;
+        }
+        if (!parts.length)
+            throw new TypeError('File dependency paths must stay inside the project root.');
+        parts.pop();
+    }
+    if (!parts.length)
+        throw new TypeError('File dependencies must identify files, not the project root.');
+    return parts.join('/');
+}
+export function paths(value) {
+    return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, value]) => {
+        if (!name)
+            throw new TypeError('File dependencies require nonempty names.');
+        return [name, path(value)];
+    })));
+}
+/** Validate and snapshot JSON before asynchronous dependency resolution starts. */
+export function json(value, ancestors = new Set()) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value !== 'object')
+        throw new TypeError('Dependency values must contain only JSON values.');
+    if (ancestors.has(value))
+        throw new TypeError('Dependency values must not contain cycles.');
+    ancestors.add(value);
+    try {
+        if (!Array.isArray(value))
+            return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, item]) => [name, json(item, ancestors)])));
+        if (Object.getOwnPropertySymbols(value).length)
+            throw new TypeError('Dependency values must not contain symbol properties.');
+        const items = [];
+        for (let index = 0; index < value.length; index++) {
+            const property = Object.getOwnPropertyDescriptor(value, index);
+            if (!property || !('value' in property))
+                throw new TypeError('Dependency values must not contain sparse arrays or getters.');
+            const item = property.value;
+            items.push(json(item, ancestors));
+        }
+        return Object.freeze(items);
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+export function dependencies(value) {
+    const entries = Object.entries(record(value)).map(([name, value]) => {
+        if (!name)
+            throw new TypeError('Dependencies require nonempty names.');
+        const source = record(value);
+        if (Object.keys(source).length !== 1)
+            throw new TypeError('Each dependency must have exactly one value, path, url, or package.');
+        if (Object.hasOwn(source, 'value'))
+            return [name, Object.freeze({ value: json(source.value) })];
+        if (Object.hasOwn(source, 'path'))
+            return [name, Object.freeze({ path: path(source.path) })];
+        if (Object.hasOwn(source, 'url') && typeof source.url === 'string' && source.url && !source.url.includes('\0')) {
+            return [name, Object.freeze({ url: source.url })];
+        }
+        if (Object.hasOwn(source, 'package') && typeof source.package === 'string' && /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/i.test(source.package)) {
+            return [name, Object.freeze({ package: source.package })];
+        }
+        throw new TypeError('Each dependency must have a JSON value, root-relative path, nonempty URL, or package name without a subpath.');
+    });
+    return Object.freeze(Object.fromEntries(entries));
+}
+export function resolvedDependencies(value) {
+    const entries = Object.entries(dependencies(value)).map(([name, dependency]) => {
+        if (dependency.url !== undefined)
+            throw new TypeError('Expected resolved dependencies, not URLs.');
+        return [name, dependency];
+    });
+    return Object.freeze(Object.fromEntries(entries));
+}
+export function hashes(value) {
+    return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, hash]) => {
+        if (!name || typeof hash !== 'string' || !/^[a-f0-9]{64}$/.test(hash)) {
+            throw new TypeError('Invalid file dependency hash.');
+        }
+        return [name, hash];
+    })));
+}
+export function equalHashes(first, second) {
+    const names = Object.keys(first);
+    return names.length === Object.keys(second).length && names.every((name) => first[name] === second[name]);
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.js","sourceRoot":"","sources":["../src/dependencies.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Dependencies, Dependency, Hashes, JsonValue, Paths, ResolvedDependencies, ResolvedDependency } from './types.js';\n\nexport function record(value: unknown): Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    throw new TypeError('Expected a named dependency record.');\n  }\n  const prototype: unknown = Object.getPrototypeOf(value);\n  if (prototype !== Object.prototype && prototype !== null) throw new TypeError('Expected a plain dependency record.');\n  if (Object.getOwnPropertySymbols(value).length) throw new TypeError('Dependency names must be strings.');\n  return Object.fromEntries(Object.keys(value).sort().map((name) => {\n    const property = Object.getOwnPropertyDescriptor(value, name);\n    if (!property || !('value' in property)) throw new TypeError('Dependency getters are not supported.');\n    const item: unknown = property.value;\n    return [name, item];\n  }));\n}\n\nfunction path(value: unknown): string {\n  if (typeof value !== 'string' || !value || value.includes('\\0')) throw new TypeError('File dependencies require nonempty paths.');\n  if (/^(?:[\\\\/]|[a-z]:|[a-z][a-z\\d+.-]*:\\/\\/)/i.test(value)) {\n    throw new TypeError('File dependency paths must be relative to the project root.');\n  }\n  const parts: string[] = [];\n  for (const part of value.replace(/\\\\/g, '/').split('/')) {\n    if (!part || part === '.') continue;\n    if (part !== '..') {\n      parts.push(part);\n      continue;\n    }\n    if (!parts.length) throw new TypeError('File dependency paths must stay inside the project root.');\n    parts.pop();\n  }\n  if (!parts.length) throw new TypeError('File dependencies must identify files, not the project root.');\n  return parts.join('/');\n}\n\nexport function paths(value: unknown): Paths {\n  return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, value]) => {\n    if (!name) throw new TypeError('File dependencies require nonempty names.');\n    return [name, path(value)];\n  })));\n}\n\n/** Validate and snapshot JSON before asynchronous dependency resolution starts. */\nexport function json(value: unknown, ancestors = new Set<object>()): JsonValue {\n  if (value === null || typeof value === 'string' || typeof value === 'boolean') return value;\n  if (typeof value === 'number' && Number.isFinite(value)) return value;\n  if (typeof value !== 'object') throw new TypeError('Dependency values must contain only JSON values.');\n  if (ancestors.has(value)) throw new TypeError('Dependency values must not contain cycles.');\n  ancestors.add(value);\n  try {\n    if (!Array.isArray(value)) return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, item]) => [name, json(item, ancestors)])));\n    if (Object.getOwnPropertySymbols(value).length) throw new TypeError('Dependency values must not contain symbol properties.');\n    const items: JsonValue[] = [];\n    for (let index = 0; index < value.length; index++) {\n      const property = Object.getOwnPropertyDescriptor(value, index);\n      if (!property || !('value' in property)) throw new TypeError('Dependency values must not contain sparse arrays or getters.');\n      const item: unknown = property.value;\n      items.push(json(item, ancestors));\n    }\n    return Object.freeze(items);\n  } finally {\n    ancestors.delete(value);\n  }\n}\n\nexport function dependencies(value: unknown): Dependencies {\n  const entries = Object.entries(record(value)).map(([name, value]): [string, Dependency] => {\n    if (!name) throw new TypeError('Dependencies require nonempty names.');\n    const source = record(value);\n    if (Object.keys(source).length !== 1) throw new TypeError('Each dependency must have exactly one value, path, url, or package.');\n    if (Object.hasOwn(source, 'value')) return [name, Object.freeze({ value: json(source.value) })];\n    if (Object.hasOwn(source, 'path')) return [name, Object.freeze({ path: path(source.path) })];\n    if (Object.hasOwn(source, 'url') && typeof source.url === 'string' && source.url && !source.url.includes('\\0')) {\n      return [name, Object.freeze({ url: source.url })];\n    }\n    if (Object.hasOwn(source, 'package') && typeof source.package === 'string' && /^(?:@[a-z0-9][a-z0-9._-]*\\/)?[a-z0-9][a-z0-9._-]*$/i.test(source.package)) {\n      return [name, Object.freeze({ package: source.package })];\n    }\n    throw new TypeError('Each dependency must have a JSON value, root-relative path, nonempty URL, or package name without a subpath.');\n  });\n  return Object.freeze(Object.fromEntries(entries));\n}\n\nexport function resolvedDependencies(value: unknown): ResolvedDependencies {\n  const entries = Object.entries(dependencies(value)).map(([name, dependency]): [string, ResolvedDependency] => {\n    if (dependency.url !== undefined) throw new TypeError('Expected resolved dependencies, not URLs.');\n    return [name, dependency];\n  });\n  return Object.freeze(Object.fromEntries(entries));\n}\n\nexport function hashes(value: unknown): Hashes {\n  return Object.freeze(Object.fromEntries(Object.entries(record(value)).map(([name, hash]) => {\n    if (!name || typeof hash !== 'string' || !/^[a-f0-9]{64}$/.test(hash)) {\n      throw new TypeError('Invalid file dependency hash.');\n    }\n    return [name, hash];\n  })));\n}\n\nexport function equalHashes(first: Hashes, second: Hashes): boolean {\n  const names = Object.keys(first);\n  return names.length === Object.keys(second).length && names.every((name) => first[name] === second[name]);\n}\n"]}

package/dist/disk.d.ts

@@ -0,0 +1,10 @@
+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>;

package/dist/disk.js

@@ -0,0 +1,71 @@
+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';
+export function missing(error) {
+    return error instanceof Error && 'code' in error && error.code === 'ENOENT';
+}
+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) {
+    try {
+        return 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;
+        }
+    }
+}
+//# sourceMappingURL=disk.js.map

package/dist/disk.js.map

@@ -0,0 +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"]}

package/dist/entry.d.ts

@@ -0,0 +1,11 @@
+import type { Backend, CacheEntryOptions } from './types.js';
+export declare class Entry {
+    #private;
+    constructor(options: CacheEntryOptions, backend: Backend);
+    /** Checks validity like load(). Warns on browser misses without the Vite plugin. */
+    has(): Promise<boolean>;
+    /** Returns undefined for missing or stale results. A miss captures dependency hashes until the next save attempt finishes. */
+    load(): Promise<Uint8Array | undefined>;
+    /** Saves bytes on disk. With file or package dependencies, call load()/has() before computing; changed dependencies reject the save. Without the Vite plugin, browser saves warn and skip the write. */
+    save(value: Uint8Array): Promise<void>;
+}

package/dist/entry.js

@@ -0,0 +1,81 @@
+import { dependencies, equalHashes } from './dependencies.js';
+import { key } from './key.js';
+export class Entry {
+    #version;
+    #resolution;
+    #dependencies;
+    #validates;
+    #backend;
+    #baseline;
+    #prepared = false;
+    #pending = false;
+    constructor(options, backend) {
+        if (typeof options.version !== 'string' || !options.version)
+            throw new TypeError('CacheEntry requires a nonempty version.');
+        this.#dependencies = dependencies(options.dependencies ?? {});
+        this.#validates = Object.values(this.#dependencies).some((dependency) => !Object.hasOwn(dependency, 'value'));
+        this.#version = options.version;
+        this.#backend = backend;
+    }
+    #resolve() {
+        this.#resolution ??= this.#backend.resolve(this.#dependencies).then((dependencies) => ({
+            key: key(this.#version, dependencies),
+            validation: Object.fromEntries(Object.entries(dependencies).filter(([, dependency]) => !Object.hasOwn(dependency, 'value'))),
+        })).catch((error) => {
+            this.#resolution = undefined;
+            throw error;
+        });
+        return this.#resolution;
+    }
+    /** Checks validity like load(). Warns on browser misses without the Vite plugin. */
+    async has() {
+        const found = await this.load() !== undefined;
+        if (!found && this.#baseline === undefined) {
+            console.warn(`vitecache: cache miss for ${(await this.#resolve()).key}. Install the vitecache Vite plugin to generate cache files.`);
+        }
+        return found;
+    }
+    /** Returns undefined for missing or stale results. A miss captures dependency hashes until the next save attempt finishes. */
+    async load() {
+        const resolved = await this.#resolve();
+        const snapshot = await this.#backend.snapshot(resolved.validation);
+        if (!this.#pending) {
+            this.#baseline = snapshot;
+            this.#prepared = true;
+        }
+        if (snapshot === null) {
+            this.#pending = true;
+            return undefined;
+        }
+        const stored = await this.#backend.load(resolved.key, snapshot !== undefined);
+        if (!stored || (snapshot !== undefined && (!stored.hashes || !equalHashes(snapshot, stored.hashes)))) {
+            this.#pending = true;
+            return undefined;
+        }
+        return stored.bytes;
+    }
+    /** Saves bytes on disk. With file or package dependencies, call load()/has() before computing; changed dependencies reject the save. Without the Vite plugin, browser saves warn and skip the write. */
+    async save(value) {
+        const bytes = new Uint8Array(value);
+        const expected = this.#baseline;
+        try {
+            if (!await this.#backend.canSave()) {
+                console.warn('vitecache: save skipped. Install the vitecache Vite plugin to write cache files from the browser.');
+                return;
+            }
+            if (this.#validates && !this.#prepared) {
+                throw new Error('Call CacheEntry.load() or has() before computing a result with file or package dependencies.');
+            }
+            if (expected === null)
+                throw new Error('Cannot save a cache entry with missing file or package dependencies.');
+            const resolved = await this.#resolve();
+            await this.#backend.save(resolved.key, bytes, resolved.validation, expected ?? {});
+        }
+        finally {
+            this.#prepared = false;
+            this.#pending = false;
+            this.#baseline = undefined;
+        }
+    }
+}
+//# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAG/B,MAAM,OAAO,KAAK;IACP,QAAQ,CAAS;IAC1B,WAAW,CAAyE;IAC3E,aAAa,CAAe;IAC5B,UAAU,CAAU;IACpB,QAAQ,CAAU;IAC3B,SAAS,CAA4B;IACrC,SAAS,GAAG,KAAK,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IAEjB,YAAY,OAA0B,EAAE,OAAgB;QACtD,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,MAAM,IAAI,SAAS,CAAC,yCAAyC,CAAC,CAAC;QAC5H,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9G,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,WAAW,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;YACrF,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC;YACrC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;SAC7H,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC3B,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;YAC7B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,SAAS,CAAC;QAC9C,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,GAAG,8DAA8D,CAAC,CAAC;QACvI,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,8HAA8H;IAC9H,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;YACrG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,wMAAwM;IACxM,KAAK,CAAC,IAAI,CAAC,KAAiB;QAC1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;gBACnC,OAAO,CAAC,IAAI,CAAC,mGAAmG,CAAC,CAAC;gBAClH,OAAO;YACT,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8FAA8F,CAAC,CAAC;YAClH,CAAC;YACD,IAAI,QAAQ,KAAK,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;YAC/G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,UAAU,EAAE,QAAQ,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;IACH,CAAC;CACF","sourcesContent":["import { dependencies, equalHashes } from './dependencies.js';\nimport { key } from './key.js';\nimport type { Backend, CacheEntryOptions, Dependencies, Hashes, ResolvedDependencies } from './types.js';\n\nexport class Entry {\n  readonly #version: string;\n  #resolution: Promise<{ key: string; validation: ResolvedDependencies }> | undefined;\n  readonly #dependencies: Dependencies;\n  readonly #validates: boolean;\n  readonly #backend: Backend;\n  #baseline: Hashes | null | undefined;\n  #prepared = false;\n  #pending = false;\n\n  constructor(options: CacheEntryOptions, backend: Backend) {\n    if (typeof options.version !== 'string' || !options.version) throw new TypeError('CacheEntry requires a nonempty version.');\n    this.#dependencies = dependencies(options.dependencies ?? {});\n    this.#validates = Object.values(this.#dependencies).some((dependency) => !Object.hasOwn(dependency, 'value'));\n    this.#version = options.version;\n    this.#backend = backend;\n  }\n\n  #resolve(): Promise<{ key: string; validation: ResolvedDependencies }> {\n    this.#resolution ??= this.#backend.resolve(this.#dependencies).then((dependencies) => ({\n      key: key(this.#version, dependencies),\n      validation: Object.fromEntries(Object.entries(dependencies).filter(([, dependency]) => !Object.hasOwn(dependency, 'value'))),\n    })).catch((error: unknown) => {\n      this.#resolution = undefined;\n      throw error;\n    });\n    return this.#resolution;\n  }\n\n  /** Checks validity like load(). Warns on browser misses without the Vite plugin. */\n  async has(): Promise<boolean> {\n    const found = await this.load() !== undefined;\n    if (!found && this.#baseline === undefined) {\n      console.warn(`vitecache: cache miss for ${(await this.#resolve()).key}. Install the vitecache Vite plugin to generate cache files.`);\n    }\n    return found;\n  }\n\n  /** Returns undefined for missing or stale results. A miss captures dependency hashes until the next save attempt finishes. */\n  async load(): Promise<Uint8Array | undefined> {\n    const resolved = await this.#resolve();\n    const snapshot = await this.#backend.snapshot(resolved.validation);\n    if (!this.#pending) {\n      this.#baseline = snapshot;\n      this.#prepared = true;\n    }\n    if (snapshot === null) {\n      this.#pending = true;\n      return undefined;\n    }\n    const stored = await this.#backend.load(resolved.key, snapshot !== undefined);\n    if (!stored || (snapshot !== undefined && (!stored.hashes || !equalHashes(snapshot, stored.hashes)))) {\n      this.#pending = true;\n      return undefined;\n    }\n    return stored.bytes;\n  }\n\n  /** Saves bytes on disk. With file or package dependencies, call load()/has() before computing; changed dependencies reject the save. Without the Vite plugin, browser saves warn and skip the write. */\n  async save(value: Uint8Array): Promise<void> {\n    const bytes = new Uint8Array(value);\n    const expected = this.#baseline;\n    try {\n      if (!await this.#backend.canSave()) {\n        console.warn('vitecache: save skipped. Install the vitecache Vite plugin to write cache files from the browser.');\n        return;\n      }\n      if (this.#validates && !this.#prepared) {\n        throw new Error('Call CacheEntry.load() or has() before computing a result with file or package dependencies.');\n      }\n      if (expected === null) throw new Error('Cannot save a cache entry with missing file or package dependencies.');\n      const resolved = await this.#resolve();\n      await this.#backend.save(resolved.key, bytes, resolved.validation, expected ?? {});\n    } finally {\n      this.#prepared = false;\n      this.#pending = false;\n      this.#baseline = undefined;\n    }\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { CacheEntry } from './browser.js';
+export type { CacheEntryOptions, Dependency, Dependencies, JsonValue } from './types.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { CacheEntry } from './browser.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC","sourcesContent":["export { CacheEntry } from './browser.js';\nexport type { CacheEntryOptions, Dependency, Dependencies, JsonValue } from './types.js';\n"]}

package/dist/key.d.ts

@@ -0,0 +1,3 @@
+import type { ResolvedDependencies } from './types.js';
+export declare function digest(bytes: Uint8Array): string;
+export declare function key(version: string, dependencies: ResolvedDependencies): string;