vitecache 0.3.0 → 0.4.0

package/dist/disk.js

@@ -1,116 +1,17 @@
-import { randomUUID } from 'node:crypto';
-import { appendFile, mkdir, readFile, realpath, rename, unlink, utimes, writeFile } from 'node:fs/promises';
-import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
-function code(error) {
-    return error instanceof Error && 'code' in error ? error.code : undefined;
-}
+import { readFile } from 'node:fs/promises';
 export function missing(error) {
-    return code(error) === 'ENOENT';
-}
-/** A filesystem error for a path that does not exist, also below a path component that is a file. */
-export function notFound(error) {
-    return missing(error) || code(error) === 'ENOTDIR';
-}
-/** Whether `path` is `root` or below it, compared lexically. */
-export function inside(root, path) {
-    const name = relative(root, path);
-    return name !== '..' && !name.startsWith(`..${sep}`) && !isAbsolute(name);
-}
-/**
- * `file` relative to `root`, with `/` separators. A file that lies outside `root` only lexically, as through a symlinked
- * root, is related by real paths instead.
- */
-export async function rootRelative(root, file) {
-    const path = inside(root, file) ? relative(root, file) : relative(await realpath(root), await realpath(file));
-    return path.split(sep).join('/');
-}
-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 || !inside(root, directory))
-        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`);
-}
-/**
- * A file's bytes as a plain Uint8Array that owns its whole ArrayBuffer, as a browser's response gives them. A Buffer's
- * slice() shares its memory, so a slice whose buffer is transferred to a worker would detach the bytes it came from.
- */
-export async function load(path) {
-    try {
-        const bytes = await readFile(path);
-        const owned = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength;
-        return owned ? new Uint8Array(bytes.buffer) : new Uint8Array(bytes);
-    }
-    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;
-        }
-    }
+    return error instanceof Error && 'code' in error && (error.code === 'ENOENT' || error.code === 'ENOTDIR');
 }
-const unrecorded = new Set();
-/**
- * Sets a file's modification time to now; a file that no longer exists is left alone. Where this process may not change
- * it, as on a read-only deployment, it warns once per directory instead of failing the read that called it.
- */
-export async function touch(path) {
+/** The file's bytes, or undefined when it does not exist. */
+export async function read(path) {
     try {
-        const now = new Date();
-        await utimes(path, now, now);
+        // 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))
-            return;
-        const reason = code(error);
-        if (reason !== 'EROFS' && reason !== 'EACCES' && reason !== 'EPERM')
-            throw error;
-        const directory = dirname(path);
-        if (!unrecorded.has(directory))
-            console.warn(`vitecache: cannot record use of entries in ${directory} (${reason}), so prune() treats them as unused.`);
-        unrecorded.add(directory);
+            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, realpath, rename, unlink, utimes, writeFile } from 'node:fs/promises';\nimport { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';\nimport type { CacheEntryOptions } from './types.js';\n\nfunction code(error: unknown): unknown {\n  return error instanceof Error && 'code' in error ? error.code : undefined;\n}\n\nexport function missing(error: unknown): boolean {\n  return code(error) === 'ENOENT';\n}\n\n/** A filesystem error for a path that does not exist, also below a path component that is a file. */\nexport function notFound(error: unknown): boolean {\n  return missing(error) || code(error) === 'ENOTDIR';\n}\n\n/** Whether `path` is `root` or below it, compared lexically. */\nexport function inside(root: string, path: string): boolean {\n  const name = relative(root, path);\n  return name !== '..' && !name.startsWith(`..${sep}`) && !isAbsolute(name);\n}\n\n/**\n * `file` relative to `root`, with `/` separators. A file that lies outside `root` only lexically, as through a symlinked\n * root, is related by real paths instead.\n */\nexport async function rootRelative(root: string, file: string): Promise<string> {\n  const path = inside(root, file) ? relative(root, file) : relative(await realpath(root), await realpath(file));\n  return path.split(sep).join('/');\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 || !inside(root, directory)) 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\n/**\n * A file's bytes as a plain Uint8Array that owns its whole ArrayBuffer, as a browser's response gives them. A Buffer's\n * slice() shares its memory, so a slice whose buffer is transferred to a worker would detach the bytes it came from.\n */\nexport async function load(path: string): Promise<Uint8Array | undefined> {\n  try {\n    const bytes = await readFile(path);\n    const owned = bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength;\n    return owned ? new Uint8Array(bytes.buffer) : new Uint8Array(bytes);\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\nconst unrecorded = new Set<string>();\n\n/**\n * Sets a file's modification time to now; a file that no longer exists is left alone. Where this process may not change\n * it, as on a read-only deployment, it warns once per directory instead of failing the read that called it.\n */\nexport async function touch(path: string): Promise<void> {\n  try {\n    const now = new Date();\n    await utimes(path, now, now);\n  } catch (error) {\n    if (missing(error)) return;\n    const reason = code(error);\n    if (reason !== 'EROFS' && reason !== 'EACCES' && reason !== 'EPERM') throw error;\n    const directory = dirname(path);\n    if (!unrecorded.has(directory)) console.warn(`vitecache: cannot record use of entries in ${directory} (${reason}), so prune() treats them as unused.`);\n    unrecorded.add(directory);\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"]}

package/dist/entry.d.ts

@@ -1,20 +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>;
+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>>;
     /**
-     * Returns undefined for missing dependencies or missing/stale results, saved dependencies included. A miss captures
-     * dependency hashes until the next save attempt finishes. A hit is a plain Uint8Array, not a Node Buffer, that owns
-     * its whole ArrayBuffer in Node and browsers alike: its slice() copies, and its buffer can be transferred.
+     * 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().
      */
-    load(): Promise<Uint8Array | undefined>;
-    /**
-     * Saves bytes on disk. With file or package dependencies, call load()/has() before computing: a dependency that changed
-     * since then rejects with ChangedDependenciesError, and one without a backing file, such as a server route, a virtual
-     * module or a package the app does not install, with MissingDependencyError. Without the Vite plugin, browser saves
-     * warn and skip the write.
-     */
-    save(value: Uint8Array, options?: SaveOptions): Promise<void>;
+    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,116 +1,13 @@
-import { dependencies, equalHashes, hashableDependencies, isChecked, MissingDependencyError, savedDependencies } from './dependencies.js';
-import { key } from './key.js';
-export class Entry {
-    #version;
-    #resolution;
-    #dependencies;
-    #hasChecked;
-    #backend;
-    #baseline;
-    #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.#hasChecked = Object.values(this.#dependencies).some(isChecked);
-        this.#version = options.version;
-        this.#backend = backend;
-    }
-    #resolve() {
-        this.#resolution ??= this.#backend.resolve(this.#dependencies).then((dependencies) => ({
-            key: key(this.#version, dependencies),
-            // Values are fully captured by the key, so only the rest is checked.
-            checked: Object.fromEntries(Object.entries(dependencies).flatMap(([name, dependency]) => isChecked(dependency) ? [[name, dependency]] : [])),
-        })).catch((error) => {
-            this.#resolution = undefined;
-            throw error;
-        });
-        return this.#resolution;
-    }
-    async #snapshot() {
-        try {
-            return await this.#backend.snapshot((await this.#resolve()).checked);
-        }
-        catch (error) {
-            if (!(error instanceof MissingDependencyError))
-                throw error;
-            return { status: 'missing', message: error.message };
-        }
-    }
-    /** 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. A hit is a plain Uint8Array, not a Node Buffer, that owns
-     * its whole ArrayBuffer in Node and browsers alike: its slice() copies, and its buffer can be transferred.
-     */
-    async load() {
-        // Value dependencies are fully captured by the key, so there is nothing to validate or baseline.
-        if (!this.#hasChecked)
-            return (await this.#backend.load((await this.#resolve()).key))?.bytes;
-        const snapshot = await this.#snapshot();
-        if (!this.#pending) {
-            this.#baseline = snapshot;
-        }
-        if (snapshot.status === 'missing') {
-            this.#pending = true;
-            return undefined;
-        }
-        const { key } = await this.#resolve();
-        const stored = await this.#backend.load(key);
-        if (!stored) {
-            this.#pending = true;
-            return undefined;
-        }
-        if (snapshot.status === 'current') {
-            // A backend that checked dependencies serves their hashes with every entry.
-            if (!stored.hashes)
-                throw new Error('vitecache served an entry without its dependency hashes.');
-            if (!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: a dependency that changed
-     * since then rejects with ChangedDependenciesError, and one without a backing file, such as a server route, a virtual
-     * module or a package the app does not install, with MissingDependencyError. 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.#hasChecked && expected === undefined) {
-                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 a missing dependency. ${expected.message}`);
-            const resolved = await this.#resolve();
-            const hashes = expected?.status === 'current' ? expected.hashes : {};
-            await this.#backend.save(resolved.key, bytes, {
-                checked: resolved.checked,
-                expected: hashes,
-                saved: hashableDependencies(await this.#backend.resolve(saved)),
-            });
-        }
-        finally {
-            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, hashableDependencies, isChecked, MissingDependencyError, savedDependencies } from './dependencies.js';\nimport { key } from './key.js';\nimport type { Backend, CacheEntryOptions, Dependencies, Hashable, SaveOptions, Snapshot } from './types.js';\n\nexport class Entry {\n  readonly #version: string;\n  #resolution: Promise<{ key: string; checked: Dependencies<Hashable> }> | undefined;\n  readonly #dependencies: Dependencies;\n  readonly #hasChecked: boolean;\n  readonly #backend: Backend;\n  #baseline: Snapshot | undefined;\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.#hasChecked = Object.values(this.#dependencies).some(isChecked);\n    this.#version = options.version;\n    this.#backend = backend;\n  }\n\n  #resolve(): Promise<{ key: string; checked: Dependencies<Hashable> }> {\n    this.#resolution ??= this.#backend.resolve(this.#dependencies).then((dependencies) => ({\n      key: key(this.#version, dependencies),\n      // Values are fully captured by the key, so only the rest is checked.\n      checked: Object.fromEntries(Object.entries(dependencies).flatMap(([name, dependency]) => isChecked(dependency) ? [[name, dependency] as const] : [])),\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()).checked);\n    } catch (error) {\n      if (!(error instanceof MissingDependencyError)) throw error;\n      return { status: 'missing', message: error.message };\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  /**\n   * Returns undefined for missing dependencies or missing/stale results, saved dependencies included. A miss captures\n   * dependency hashes until the next save attempt finishes. A hit is a plain Uint8Array, not a Node Buffer, that owns\n   * its whole ArrayBuffer in Node and browsers alike: its slice() copies, and its buffer can be transferred.\n   */\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.#hasChecked) return (await this.#backend.load((await this.#resolve()).key))?.bytes;\n    const snapshot = await this.#snapshot();\n    if (!this.#pending) {\n      this.#baseline = snapshot;\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);\n    if (!stored) {\n      this.#pending = true;\n      return undefined;\n    }\n    if (snapshot.status === 'current') {\n      // A backend that checked dependencies serves their hashes with every entry.\n      if (!stored.hashes) throw new Error('vitecache served an entry without its dependency hashes.');\n      if (!equalHashes(snapshot.hashes, stored.hashes)) {\n        this.#pending = true;\n        return undefined;\n      }\n    }\n    return stored.bytes;\n  }\n\n  /**\n   * Saves bytes on disk. With file or package dependencies, call load()/has() before computing: a dependency that changed\n   * since then rejects with ChangedDependenciesError, and one without a backing file, such as a server route, a virtual\n   * module or a package the app does not install, with MissingDependencyError. Without the Vite plugin, browser saves\n   * warn and skip the write.\n   */\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.#hasChecked && expected === undefined) {\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 a missing dependency. ${expected.message}`);\n      const resolved = await this.#resolve();\n      const hashes = expected?.status === 'current' ? expected.hashes : {};\n      await this.#backend.save(resolved.key, bytes, {\n        checked: resolved.checked,\n        expected: hashes,\n        saved: hashableDependencies(await this.#backend.resolve(saved)),\n      });\n    } finally {\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 { ChangedDependenciesError, 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 { ChangedDependenciesError, 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,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAGrF,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 { ChangedDependenciesError, 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;