vitecache 0.2.1 → 0.4.0

package/dist/entry.d.ts

@@ -1,11 +1,32 @@
-import type { Backend, CacheEntryOptions, SaveOptions } 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 dependencies or missing/stale results, saved dependencies included. 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, options?: SaveOptions): Promise<void>;
+export type JsonValue = null | boolean | number | string | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+/** A file, relative to the project root, or an installed package, whose current state an entry is checked against. */
+export type Input = {
+    readonly path: string;
+} | {
+    readonly package: string;
+};
+/** A JSON value selects which result an entry holds; an input invalidates it when it changes. */
+export type Dependency = {
+    readonly value: JsonValue;
+} | Input;
+export interface CacheEntryOptions {
+    /** Identifies the computation and its implementation, for example "simplify@2". */
+    version: string;
+    /** Named dependencies. Names and declarations make up the entry's key; file contents and package versions do not. */
+    dependencies?: Readonly<Record<string, Dependency>>;
+    /**
+     * Node: the project root, whose public/_vitecache is the cache directory. Defaults to the Vite project, and its
+     * publicDir, while the vitecache plugin runs, else to process.cwd().
+     */
+    root?: string;
+    /** Browsers: the URL the cache directory is served at, including any Vite base. Defaults to /_vitecache/. */
+    basePath?: string;
 }
+export interface SaveOptions {
+    /** Inputs the computation turned out to read. Checked on every load like declared ones, without changing the key. */
+    dependencies?: readonly Input[];
+}
+/** The entry's name in the cache directory. */
+export declare function key(options: CacheEntryOptions): string;

package/dist/entry.js

@@ -1,96 +1,13 @@
-import { dependencies, equalHashes, MissingDependencyError, savedDependencies } 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;
-    }
-    async #snapshot() {
-        try {
-            return await this.#backend.snapshot((await this.#resolve()).validation);
-        }
-        catch (error) {
-            if (!(error instanceof MissingDependencyError))
-                throw error;
-            return { status: 'missing' };
-        }
-    }
-    /** Checks validity like load(). Warns on browser misses without the Vite plugin. */
-    async has() {
-        const found = await this.load() !== undefined;
-        if (!found && !await this.#backend.canSave()) {
-            console.warn(`vitecache: cache miss for ${this.#version}. Install the vitecache Vite plugin to generate cache files.`);
-        }
-        return found;
-    }
-    /** Returns undefined for missing dependencies or missing/stale results, saved dependencies included. A miss captures dependency hashes until the next save attempt finishes. */
-    async load() {
-        // Value dependencies are fully captured by the key, so there is nothing to validate or baseline.
-        if (!this.#validates)
-            return (await this.#backend.load((await this.#resolve()).key, false))?.bytes;
-        const snapshot = await this.#snapshot();
-        if (!this.#pending) {
-            this.#baseline = snapshot;
-            this.#prepared = true;
-        }
-        if (snapshot.status === 'missing') {
-            this.#pending = true;
-            return undefined;
-        }
-        const { key } = await this.#resolve();
-        const stored = await this.#backend.load(key, snapshot.status === 'available');
-        if (!stored || (snapshot.status === 'available' && (!stored.hashes || !equalHashes(snapshot.hashes, 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, options = {}) {
-        const bytes = new Uint8Array(value);
-        const saved = savedDependencies(options.dependencies ?? {});
-        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?.status === 'missing')
-                throw new MissingDependencyError('Cannot save a cache entry with missing file or package dependencies.');
-            const resolved = await this.#resolve();
-            const hashes = expected?.status === 'available' ? expected.hashes : {};
-            await this.#backend.save(resolved.key, bytes, resolved.validation, hashes, await this.#backend.resolve(saved));
-        }
-        finally {
-            this.#prepared = false;
-            this.#pending = false;
-            this.#baseline = undefined;
-        }
-    }
+import { sha256 } from '@noble/hashes/sha2.js';
+import { bytesToHex } from '@noble/hashes/utils.js';
+import { configure } from 'safe-stable-stringify';
+/** JSON with sorted object keys, so that declaration order does not change the key; anything else throws. */
+const stringify = configure({ strict: true });
+/** The entry's name in the cache directory. */
+export function key(options) {
+    if (!options.version)
+        throw new TypeError('CacheEntry requires a version.');
+    const declaration = stringify({ version: options.version, dependencies: options.dependencies ?? {} });
+    return bytesToHex(sha256(new TextEncoder().encode(declaration)));
 }
 //# sourceMappingURL=entry.js.map

package/dist/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"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","sourcesContent":["import { dependencies, equalHashes, MissingDependencyError, savedDependencies } from './dependencies.js';\nimport { key } from './key.js';\nimport type { Backend, CacheEntryOptions, Dependencies, ResolvedDependencies, SaveOptions, Snapshot } 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: Snapshot | 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  async #snapshot(): Promise<Snapshot> {\n    try {\n      return await this.#backend.snapshot((await this.#resolve()).validation);\n    } catch (error) {\n      if (!(error instanceof MissingDependencyError)) throw error;\n      return { status: 'missing' };\n    }\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 && !await this.#backend.canSave()) {\n      console.warn(`vitecache: cache miss for ${this.#version}. Install the vitecache Vite plugin to generate cache files.`);\n    }\n    return found;\n  }\n\n  /** Returns undefined for missing dependencies or missing/stale results, saved dependencies included. A miss captures dependency hashes until the next save attempt finishes. */\n  async load(): Promise<Uint8Array | undefined> {\n    // Value dependencies are fully captured by the key, so there is nothing to validate or baseline.\n    if (!this.#validates) return (await this.#backend.load((await this.#resolve()).key, false))?.bytes;\n    const snapshot = await this.#snapshot();\n    if (!this.#pending) {\n      this.#baseline = snapshot;\n      this.#prepared = true;\n    }\n    if (snapshot.status === 'missing') {\n      this.#pending = true;\n      return undefined;\n    }\n    const { key } = await this.#resolve();\n    const stored = await this.#backend.load(key, snapshot.status === 'available');\n    if (!stored || (snapshot.status === 'available' && (!stored.hashes || !equalHashes(snapshot.hashes, 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, options: SaveOptions = {}): Promise<void> {\n    const bytes = new Uint8Array(value);\n    const saved = savedDependencies(options.dependencies ?? {});\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?.status === 'missing') throw new MissingDependencyError('Cannot save a cache entry with missing file or package dependencies.');\n      const resolved = await this.#resolve();\n      const hashes = expected?.status === 'available' ? expected.hashes : {};\n      await this.#backend.save(resolved.key, bytes, resolved.validation, hashes, await this.#backend.resolve(saved));\n    } finally {\n      this.#prepared = false;\n      this.#pending = false;\n      this.#baseline = undefined;\n    }\n  }\n}\n"]}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AA6BlD,6GAA6G;AAC7G,MAAM,SAAS,GAAG,SAAS,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9C,+CAA+C;AAC/C,MAAM,UAAU,GAAG,CAAC,OAA0B;IAC5C,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC,CAAC;IAC5E,MAAM,WAAW,GAAG,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC,CAAC;IACtG,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AACnE,CAAC","sourcesContent":["import { sha256 } from '@noble/hashes/sha2.js';\nimport { bytesToHex } from '@noble/hashes/utils.js';\nimport { configure } from 'safe-stable-stringify';\n\nexport type JsonValue = null | boolean | number | string | readonly JsonValue[] | { readonly [key: string]: JsonValue };\n\n/** A file, relative to the project root, or an installed package, whose current state an entry is checked against. */\nexport type Input = { readonly path: string } | { readonly package: string };\n\n/** A JSON value selects which result an entry holds; an input invalidates it when it changes. */\nexport type Dependency = { readonly value: JsonValue } | Input;\n\nexport interface CacheEntryOptions {\n  /** Identifies the computation and its implementation, for example \"simplify@2\". */\n  version: string;\n  /** Named dependencies. Names and declarations make up the entry's key; file contents and package versions do not. */\n  dependencies?: Readonly<Record<string, Dependency>>;\n  /**\n   * Node: the project root, whose public/_vitecache is the cache directory. Defaults to the Vite project, and its\n   * publicDir, while the vitecache plugin runs, else to process.cwd().\n   */\n  root?: string;\n  /** Browsers: the URL the cache directory is served at, including any Vite base. Defaults to /_vitecache/. */\n  basePath?: string;\n}\n\nexport interface SaveOptions {\n  /** Inputs the computation turned out to read. Checked on every load like declared ones, without changing the key. */\n  dependencies?: readonly Input[];\n}\n\n/** JSON with sorted object keys, so that declaration order does not change the key; anything else throws. */\nconst stringify = configure({ strict: true });\n\n/** The entry's name in the cache directory. */\nexport function key(options: CacheEntryOptions): string {\n  if (!options.version) throw new TypeError('CacheEntry requires a version.');\n  const declaration = stringify({ version: options.version, dependencies: options.dependencies ?? {} });\n  return bytesToHex(sha256(new TextEncoder().encode(declaration)));\n}\n"]}

package/dist/node.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, Dependencies, Dependency, JsonValue, SavedDependencies, SavedDependency, SaveOptions } from './types.js';
-/** A persistent binary computation result with content-based dependency validation. */
-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 in the cache directory on disk, which Node computes and saves for every environment. */
+export declare class CacheEntry {
+    #private;
     constructor(options: CacheEntryOptions);
+    /** The saved bytes while every input they were built from is unchanged, otherwise undefined. */
+    load(): Promise<Uint8Array | undefined>;
+    /** Saves the result computed after load(), built from the inputs as that load() found them, plus `dependencies`. */
+    save(value: Uint8Array, options?: SaveOptions): Promise<void>;
 }

package/dist/node.js

@@ -1,10 +1,105 @@
-import { Entry } from './entry.js';
-import { createStorage } from './storage.js';
-export { MissingDependencyError } from './dependencies.js';
-/** A persistent binary computation result with content-based dependency validation. */
-export class CacheEntry extends Entry {
+import { createHash } from 'node:crypto';
+import { mkdir, stat } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { join, resolve } from 'node:path';
+import writeFileAtomic from 'write-file-atomic';
+import { missing, read } from './disk.js';
+import { key } from './entry.js';
+import { shared } from './shared.js';
+/**
+ * File hashes by path, reused while size, mtime and ctime are unchanged. As git does, a hash taken within two seconds
+ * of the file's mtime is not kept, since a write in the same timestamp tick could follow it unseen.
+ */
+const fileHashes = new Map();
+async function fileHash(path) {
+    const stats = await stat(path, { bigint: true }).catch((error) => {
+        if (missing(error))
+            return undefined;
+        throw error;
+    });
+    if (!stats)
+        return undefined;
+    const signature = [stats.ino, stats.size, stats.mtimeNs, stats.ctimeNs].join();
+    const known = fileHashes.get(path);
+    if (known?.stats === signature)
+        return known.hash;
+    const hash = read(path).then((bytes) => bytes && createHash('sha256').update(bytes).digest('hex'));
+    if (BigInt(Date.now()) * 1000000n - stats.mtimeNs < 2000000000n)
+        fileHashes.delete(path);
+    else
+        fileHashes.set(path, { stats: signature, hash });
+    return hash;
+}
+/** The installed version of a package as `root` resolves it, its own name included. */
+async function packageVersion(root, name) {
+    const own = join(root, 'package.json');
+    const directories = createRequire(own).resolve.paths(name) ?? [];
+    for (const file of [own, ...directories.map((directory) => join(directory, name, 'package.json'))]) {
+        const bytes = await read(file);
+        if (!bytes)
+            continue;
+        const manifest = JSON.parse(new TextDecoder().decode(bytes));
+        if (file === own && manifest.name !== name)
+            continue;
+        if (typeof manifest.version !== 'string')
+            throw new TypeError(`${file} declares no version.`);
+        return manifest.version;
+    }
+    return undefined;
+}
+/** A cached result in the cache directory on disk, which Node computes and saves for every environment. */
+export class CacheEntry {
+    #key;
+    #inputs;
+    #root;
+    #directory;
+    /** The declared inputs as the last load() found them, which save() records as what the result was built from. */
+    #loaded;
     constructor(options) {
-        super(options, createStorage(options));
+        this.#key = key(options);
+        const dependencies = Object.values(options.dependencies ?? {});
+        this.#inputs = dependencies.filter((dependency) => !('value' in dependency));
+        this.#root = resolve(options.root ?? shared.root ?? process.cwd());
+        const plugin = options.root === undefined ? shared.directory : undefined;
+        this.#directory = plugin ?? join(this.#root, 'public/_vitecache');
+    }
+    #record(inputs) {
+        return Promise.all(inputs.map(async (dependency) => ({
+            dependency,
+            state: 'path' in dependency
+                ? await fileHash(resolve(this.#root, dependency.path))
+                : await packageVersion(this.#root, dependency.package),
+        })));
+    }
+    /** The saved bytes while every input they were built from is unchanged, otherwise undefined. */
+    async load() {
+        shared.used.set(this.#key, Date.now());
+        this.#loaded = await this.#record(this.#inputs);
+        const metadata = await read(join(this.#directory, `${this.#key}.json`));
+        if (!metadata)
+            return undefined;
+        // Written by save() below; any other shape compares unequal. Metadata from before 0.4 has no inputs, and misses.
+        const { inputs } = JSON.parse(new TextDecoder().decode(metadata));
+        if (!inputs)
+            return undefined;
+        const current = await this.#record(inputs.map((input) => input.dependency));
+        if (JSON.stringify(current) !== JSON.stringify(inputs))
+            return undefined;
+        return read(join(this.#directory, `${this.#key}.bin`));
+    }
+    /** Saves the result computed after load(), built from the inputs as that load() found them, plus `dependencies`. */
+    async save(value, options = {}) {
+        if (!this.#loaded)
+            throw new Error('Call CacheEntry.load() before computing the result to save.');
+        const inputs = [...this.#loaded, ...(await this.#record(options.dependencies ?? []))];
+        const missing = inputs.find((input) => input.state === undefined);
+        if (missing)
+            throw new Error(`vitecache input has no file or package: ${JSON.stringify(missing.dependency)}`);
+        shared.saves++;
+        // Atomic writes, so that a reader sees the old file or the new one.
+        await mkdir(this.#directory, { recursive: true });
+        await writeFileAtomic(join(this.#directory, `${this.#key}.bin`), Buffer.from(value.buffer, value.byteOffset, value.byteLength));
+        await writeFileAtomic(join(this.#directory, `${this.#key}.json`), JSON.stringify({ inputs }));
     }
 }
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,uFAAuF;AACvF,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAA0B;QACpC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;CACF","sourcesContent":["import { Entry } from './entry.js';\nimport { createStorage } from './storage.js';\nimport type { CacheEntryOptions } from './types.js';\nexport { MissingDependencyError } from './dependencies.js';\nexport type { CacheEntryOptions, Dependencies, Dependency, JsonValue, SavedDependencies, SavedDependency, SaveOptions } from './types.js';\n\n/** A persistent binary computation result with content-based dependency validation. */\nexport class CacheEntry extends Entry {\n  constructor(options: CacheEntryOptions) {\n    super(options, createStorage(options));\n  }\n}\n"]}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdir, stat } from 'node:fs/promises';\nimport { createRequire } from 'node:module';\nimport { join, resolve } from 'node:path';\nimport writeFileAtomic from 'write-file-atomic';\nimport { missing, read } from './disk.js';\nimport { key, type CacheEntryOptions, type Input, type SaveOptions } from './entry.js';\nimport { shared } from './shared.js';\nexport type { CacheEntryOptions, Dependency, Input, JsonValue, SaveOptions } from './entry.js';\n\n/** An input and its state when it was read: a file's hash or a package's version, undefined when it has neither. */\ninterface Recorded {\n  dependency: Input;\n  state: string | undefined;\n}\n\n/**\n * File hashes by path, reused while size, mtime and ctime are unchanged. As git does, a hash taken within two seconds\n * of the file's mtime is not kept, since a write in the same timestamp tick could follow it unseen.\n */\nconst fileHashes = new Map<string, { stats: string; hash: Promise<string | undefined> }>();\n\nasync function fileHash(path: string): Promise<string | undefined> {\n  const stats = await stat(path, { bigint: true }).catch((error: unknown) => {\n    if (missing(error)) return undefined;\n    throw error;\n  });\n  if (!stats) return undefined;\n  const signature = [stats.ino, stats.size, stats.mtimeNs, stats.ctimeNs].join();\n  const known = fileHashes.get(path);\n  if (known?.stats === signature) return known.hash;\n  const hash = read(path).then((bytes) => bytes && createHash('sha256').update(bytes).digest('hex'));\n  if (BigInt(Date.now()) * 1_000_000n - stats.mtimeNs < 2_000_000_000n) fileHashes.delete(path);\n  else fileHashes.set(path, { stats: signature, hash });\n  return hash;\n}\n\n/** The installed version of a package as `root` resolves it, its own name included. */\nasync function packageVersion(root: string, name: string): Promise<string | undefined> {\n  const own = join(root, 'package.json');\n  const directories = createRequire(own).resolve.paths(name) ?? [];\n  for (const file of [own, ...directories.map((directory) => join(directory, name, 'package.json'))]) {\n    const bytes = await read(file);\n    if (!bytes) continue;\n    const manifest: { name?: unknown; version?: unknown } = JSON.parse(new TextDecoder().decode(bytes));\n    if (file === own && manifest.name !== name) continue;\n    if (typeof manifest.version !== 'string') throw new TypeError(`${file} declares no version.`);\n    return manifest.version;\n  }\n  return undefined;\n}\n\n/** A cached result in the cache directory on disk, which Node computes and saves for every environment. */\nexport class CacheEntry {\n  readonly #key: string;\n  readonly #inputs: Input[];\n  readonly #root: string;\n  readonly #directory: string;\n  /** The declared inputs as the last load() found them, which save() records as what the result was built from. */\n  #loaded: Recorded[] | undefined;\n\n  constructor(options: CacheEntryOptions) {\n    this.#key = key(options);\n    const dependencies = Object.values(options.dependencies ?? {});\n    this.#inputs = dependencies.filter((dependency): dependency is Input => !('value' in dependency));\n    this.#root = resolve(options.root ?? shared.root ?? process.cwd());\n    const plugin = options.root === undefined ? shared.directory : undefined;\n    this.#directory = plugin ?? join(this.#root, 'public/_vitecache');\n  }\n\n  #record(inputs: readonly Input[]): Promise<Recorded[]> {\n    return Promise.all(\n      inputs.map(async (dependency) => ({\n        dependency,\n        state:\n          'path' in dependency\n            ? await fileHash(resolve(this.#root, dependency.path))\n            : await packageVersion(this.#root, dependency.package),\n      })),\n    );\n  }\n\n  /** The saved bytes while every input they were built from is unchanged, otherwise undefined. */\n  async load(): Promise<Uint8Array | undefined> {\n    shared.used.set(this.#key, Date.now());\n    this.#loaded = await this.#record(this.#inputs);\n    const metadata = await read(join(this.#directory, `${this.#key}.json`));\n    if (!metadata) return undefined;\n    // Written by save() below; any other shape compares unequal. Metadata from before 0.4 has no inputs, and misses.\n    const { inputs }: { inputs?: Recorded[] } = JSON.parse(new TextDecoder().decode(metadata));\n    if (!inputs) return undefined;\n    const current = await this.#record(inputs.map((input) => input.dependency));\n    if (JSON.stringify(current) !== JSON.stringify(inputs)) return undefined;\n    return read(join(this.#directory, `${this.#key}.bin`));\n  }\n\n  /** Saves the result computed after load(), built from the inputs as that load() found them, plus `dependencies`. */\n  async save(value: Uint8Array, options: SaveOptions = {}): Promise<void> {\n    if (!this.#loaded) throw new Error('Call CacheEntry.load() before computing the result to save.');\n    const inputs = [...this.#loaded, ...(await this.#record(options.dependencies ?? []))];\n    const missing = inputs.find((input) => input.state === undefined);\n    if (missing) throw new Error(`vitecache input has no file or package: ${JSON.stringify(missing.dependency)}`);\n    shared.saves++;\n    // Atomic writes, so that a reader sees the old file or the new one.\n    await mkdir(this.#directory, { recursive: true });\n    await writeFileAtomic(\n      join(this.#directory, `${this.#key}.bin`),\n      Buffer.from(value.buffer, value.byteOffset, value.byteLength),\n    );\n    await writeFileAtomic(join(this.#directory, `${this.#key}.json`), JSON.stringify({ inputs }));\n  }\n}\n"]}

package/dist/shared.d.ts

@@ -0,0 +1,17 @@
+declare global {
+    /** Set by the vitecache Vite plugin. On globalThis, since Vite's module runner can load a second copy of this. */
+    var vitecache: Shared | undefined;
+}
+interface Shared {
+    /** The plugin's project. */
+    root?: string;
+    directory?: string;
+    /** When each key was last loaded in this process, which the plugin prunes by. */
+    used: Map<string, number>;
+    /** How many entries this process saved, which a build's second pass checks. */
+    saves: number;
+    /** Whether a build is starting the server it runs loaders with. */
+    running?: boolean;
+}
+export declare const shared: Shared;
+export {};

package/dist/shared.js

@@ -0,0 +1,5 @@
+export const shared = (globalThis.vitecache ??= { used: new Map(), saves: 0 });
+// Another vitecache version in this process may have made it, as when Vite restarts its server after a rebuild.
+shared.used ??= new Map();
+shared.saves ??= 0;
+//# sourceMappingURL=shared.js.map

package/dist/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../src/shared.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,MAAM,GAAW,CAAC,UAAU,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AACvF,gHAAgH;AAChH,MAAM,CAAC,IAAI,KAAK,IAAI,GAAG,EAAE,CAAC;AAC1B,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC","sourcesContent":["declare global {\n  /** Set by the vitecache Vite plugin. On globalThis, since Vite's module runner can load a second copy of this. */\n  var vitecache: Shared | undefined;\n}\n\ninterface Shared {\n  /** The plugin's project. */\n  root?: string;\n  directory?: string;\n  /** When each key was last loaded in this process, which the plugin prunes by. */\n  used: Map<string, number>;\n  /** How many entries this process saved, which a build's second pass checks. */\n  saves: number;\n  /** Whether a build is starting the server it runs loaders with. */\n  running?: boolean;\n}\n\nexport const shared: Shared = (globalThis.vitecache ??= { used: new Map(), saves: 0 });\n// Another vitecache version in this process may have made it, as when Vite restarts its server after a rebuild.\nshared.used ??= new Map();\nshared.saves ??= 0;\n"]}

package/dist/vite.d.ts

@@ -0,0 +1,12 @@
+import { type Plugin } from 'vite';
+export interface VitecacheOptions {
+    /** Development: milliseconds an entry stays after the last load that used it, so that an undone edit reuses it. */
+    pruneAfter?: number;
+}
+/**
+ * Finds cached loader loads in the project's source files and warms them in Node, so that browsers read what Node
+ * saved, then deletes the entries no load uses. In development it scans and warms at startup and again after every
+ * file change, holds cache requests until warming finishes, and deletes entries unused for `pruneAfter`. A build scans
+ * and warms once, checks that a second pass saves nothing, and deletes every entry it did not use.
+ */
+export declare function vitecache({ pruneAfter }?: VitecacheOptions): Plugin;