zod-compiler 1.23.0 → 1.23.2

package/dist/unplugin/disk-cache.d.ts

@@ -1,3 +1,4 @@
+//#region src/unplugin/disk-cache.d.ts
 /**
  * Persistent transform-result cache.
  *
@@ -40,102 +41,130 @@
  * Writes are atomic (tmp file + rename) so concurrent bundler processes
  * (vitest workspace projects) can share one cache directory safely.
  */
-export interface CacheEntryStats {
-    schemas: number;
-    optimized: number;
+interface CacheEntryStats {
+  schemas: number;
+  optimized: number;
 }
-export interface CacheEntry {
-    /** Transformed code, or null when the transform produced no change. */
-    result: string | null;
-    /** Content-addressed id of the shared dep-set file (deps/<id>.json). */
-    depset: string;
-    /** Build stats to replay on cache hits (only present when schemas compiled). */
-    stats?: CacheEntryStats;
-    /** Composed sourcemap for `result` (original → transformed). */
-    map?: CacheSourceMap | null;
+interface CacheEntry {
+  /** Transformed code, or null when the transform produced no change. */
+  result: string | null;
+  /** Content-addressed id of the shared dep-set file (deps/<id>.json). */
+  depset: string;
+  /** Build stats to replay on cache hits (only present when schemas compiled). */
+  stats?: CacheEntryStats;
+  /** Composed sourcemap for `result` (original → transformed). */
+  map?: CacheSourceMap | null;
 }
 /** JSON shape of the persisted sourcemap (mirrors TransformSourceMap). */
-export interface CacheSourceMap {
-    version: number;
-    sources: (string | null)[];
-    sourcesContent?: (string | null)[];
-    names: string[];
-    mappings: string;
-    file?: string | null;
+interface CacheSourceMap {
+  version: number;
+  sources: (string | null)[];
+  sourcesContent?: (string | null)[];
+  names: string[];
+  mappings: string;
+  file?: string | null;
 }
+/**
+ * Build fingerprint: a content hash of the package's own source trees.
+ *
+ * The published version string alone is not enough — file: installs, linked
+ * monorepo packages, and canary builds rebuild the compiler without a version
+ * bump, and serving codegen from an older compiler build would be silently
+ * stale.
+ *
+ * CONTENT-addressed, for the same reason depset ids are: mtimes do not survive
+ * an install. pnpm rewrites every mtime under its `copy` import method, and
+ * copy is what you get whenever the store sits on a different filesystem than
+ * the workspace — the default on CI runners that mount the store as its own
+ * volume (`npm_config_package_import_method=copy`). An mtime fingerprint
+ * therefore rotates on every `pnpm install --frozen-lockfile`, which changes
+ * every cache key and makes a restored CI cache wholly unreachable: the archive
+ * unpacks, and nothing in it is ever looked up. Hardlink and APFS-clone installs
+ * DO preserve mtimes, so the bug hides locally and reproduces only on the
+ * runners that need the cache most.
+ *
+ * A content hash is also strictly tighter than mtime for the stated purpose: a
+ * rebuild that reproduces identical bytes no longer discards the whole cache.
+ *
+ * Hashing ~0.7 MB across ~250 files costs ~5ms — once per process, and only if
+ * a key is actually built (see `keyPrefix`).
+ */
+declare function computeBuildFingerprint(root: string): string;
 /** Reset the per-process dep validation memos (watch-mode file changes). */
-export declare function resetDepValidationMemo(): void;
-export declare class DiskCache {
-    private readonly dir;
-    private readonly optionsKey;
-    /** Superset snapshot provider (loader's executed first-party modules). */
-    private readonly superset;
-    private pending;
-    private initialized;
-    constructor(dir: string, optionsKey: string, superset?: () => string[] | null);
-    /**
-     * Resolve the cache directory: an explicit string wins; otherwise
-     * node_modules/.cache/zod-compiler under cwd (falling back to a
-     * project-local .zod-compiler-cache when node_modules doesn't exist).
-     */
-    static resolveDir(cacheOption: string | true): string;
-    key(id: string, code: string): string;
-    private entryPath;
-    private depsetPath;
-    /**
-     * One-time directory init: wipe on format mismatch (v1 inline-deps caches
-     * reached 283 MB in the field — disposable by definition), then a
-     * throttled GC pass. Best-effort throughout; a concurrent wipe/GC from
-     * another process can only cause cache misses, never stale hits.
-     */
-    private ensureDir;
-    /**
-     * Throttled sweep: entries older than MAX_ENTRY_AGE_MS (orphaned by key
-     * churn — content/version/options keys never repeat once inputs change)
-     * and dep-set files no surviving entry references. Runs at most once per
-     * GC_INTERVAL_MS per directory; the marker is claimed BEFORE sweeping so
-     * concurrent processes skip. Deleting a dep-set raced by a concurrent
-     * entry write only costs that entry a future miss — save() re-creates
-     * absent dep-set files.
-     */
-    private maybeGc;
-    /** Load an entry and validate its dep-set. Any failure → null. */
-    load(key: string): CacheEntry | null;
-    /**
-     * Validate every dep in a dep-set, once per process per set: superset
-     * entries all share one set, so the ~N-file validation (and the JSON
-     * parse) happens once instead of once per entry.
-     */
-    private validateDepset;
-    /**
-     * Stat + hash every dep into a content-addressed record map. The id hashes
-     * sorted (path, content-hash) pairs ONLY — mtimes are validation fast-path
-     * hints and must not fork the file name across checkouts/touches. Returns
-     * null when any dep cannot be read (an unvalidatable set must not persist).
-     */
-    private buildDepset;
-    /** Write a dep-set file if absent (content-addressed: same id ⟹ same bytes). */
-    private writeDepset;
-    private writeEntry;
-    /** Persist an entry whose dependency set is fully known (static crawl complete). */
-    save(key: string, result: string | null, depPaths: readonly string[], stats?: CacheEntryStats, map?: CacheSourceMap | null): void;
-    /**
-     * Queue an entry whose static dep crawl was incomplete. Persisted by
-     * flushDeferred() against ONE end-of-build superset snapshot — recording
-     * the snapshot at save time gave every entry a distinct point-in-time
-     * copy (the executed-modules set grows as discovery progresses).
-     */
-    saveDeferred(key: string, result: string | null, stats?: CacheEntryStats, map?: CacheSourceMap | null): void;
-    /**
-     * Flush queued superset entries against the current loader snapshot.
-     * Wired to buildEnd and (as a fallback) process exit; idempotent.
-     */
-    flushDeferred(): void;
-    /**
-     * Discard queued superset entries (watch-mode file change): their results
-     * predate the change, but a flush would record post-change dep hashes —
-     * the one pairing that could validate a stale result.
-     */
-    dropDeferred(): void;
+declare function resetDepValidationMemo(): void;
+declare class DiskCache {
+  private readonly dir;
+  private readonly optionsKey;
+  /** Superset snapshot provider (loader's executed first-party modules). */
+  private readonly superset;
+  private pending;
+  private initialized;
+  constructor(dir: string, optionsKey: string, superset?: () => string[] | null);
+  /**
+   * Resolve the cache directory: an explicit string wins; otherwise
+   * node_modules/.cache/zod-compiler under cwd (falling back to a
+   * project-local .zod-compiler-cache when node_modules doesn't exist).
+   */
+  static resolveDir(cacheOption: string | true): string;
+  key(id: string, code: string): string;
+  private entryPath;
+  private depsetPath;
+  /**
+   * One-time directory init: wipe on format mismatch (v1 inline-deps caches
+   * reached 283 MB in the field — disposable by definition), then a
+   * throttled GC pass. Best-effort throughout; a concurrent wipe/GC from
+   * another process can only cause cache misses, never stale hits.
+   */
+  private ensureDir;
+  /**
+   * Throttled sweep: entries older than MAX_ENTRY_AGE_MS (orphaned by key
+   * churn — content/version/options keys never repeat once inputs change)
+   * and dep-set files no surviving entry references. Runs at most once per
+   * GC_INTERVAL_MS per directory; the marker is claimed BEFORE sweeping so
+   * concurrent processes skip. Deleting a dep-set raced by a concurrent
+   * entry write only costs that entry a future miss — save() re-creates
+   * absent dep-set files.
+   */
+  private maybeGc;
+  /** Load an entry and validate its dep-set. Any failure → null. */
+  load(key: string): CacheEntry | null;
+  /**
+   * Validate every dep in a dep-set, once per process per set: superset
+   * entries all share one set, so the ~N-file validation (and the JSON
+   * parse) happens once instead of once per entry.
+   */
+  private validateDepset;
+  /**
+   * Stat + hash every dep into a content-addressed record map. The id hashes
+   * sorted (path, content-hash) pairs ONLY — mtimes are validation fast-path
+   * hints and must not fork the file name across checkouts/touches. Returns
+   * null when any dep cannot be read (an unvalidatable set must not persist).
+   */
+  private buildDepset;
+  /** Write a dep-set file if absent (content-addressed: same id ⟹ same bytes). */
+  private writeDepset;
+  private writeEntry;
+  /** Persist an entry whose dependency set is fully known (static crawl complete). */
+  save(key: string, result: string | null, depPaths: readonly string[], stats?: CacheEntryStats, map?: CacheSourceMap | null): void;
+  /**
+   * Queue an entry whose static dep crawl was incomplete. Persisted by
+   * flushDeferred() against ONE end-of-build superset snapshot — recording
+   * the snapshot at save time gave every entry a distinct point-in-time
+   * copy (the executed-modules set grows as discovery progresses).
+   */
+  saveDeferred(key: string, result: string | null, stats?: CacheEntryStats, map?: CacheSourceMap | null): void;
+  /**
+   * Flush queued superset entries against the current loader snapshot.
+   * Wired to buildEnd and (as a fallback) process exit; idempotent.
+   */
+  flushDeferred(): void;
+  /**
+   * Discard queued superset entries (watch-mode file change): their results
+   * predate the change, but a flush would record post-change dep hashes —
+   * the one pairing that could validate a stale result.
+   */
+  dropDeferred(): void;
 }
+//#endregion
+export { CacheEntry, CacheEntryStats, CacheSourceMap, DiskCache, computeBuildFingerprint, resetDepValidationMemo };
 //# sourceMappingURL=disk-cache.d.ts.map

package/dist/unplugin/disk-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disk-cache.d.ts","sourceRoot":"","sources":["../../src/unplugin/disk-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAmBH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,gEAAgE;IAChE,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AA2HD,4EAA4E;AAC5E,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAiBD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,OAAO,CAAsB;IACrC,OAAO,CAAC,WAAW,CAAS;gBAEhB,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,MAAM,EAAE,GAAG,IAAI;IAM7E;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM;IAOrD,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAMrC,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAwBjB;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO;IAyCf,kEAAkE;IAClE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAepC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA8BtB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAcnB,gFAAgF;IAChF,OAAO,CAAC,WAAW;IAanB,OAAO,CAAC,UAAU;IA8BlB,oFAAoF;IACpF,IAAI,CACF,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,KAAK,CAAC,EAAE,eAAe,EACvB,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,GAC1B,IAAI;IAQP;;;;;OAKG;IACH,YAAY,CACV,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,CAAC,EAAE,eAAe,EACvB,GAAG,CAAC,EAAE,cAAc,GAAG,IAAI,GAC1B,IAAI;IAMP;;;OAGG;IACH,aAAa,IAAI,IAAI;IAerB;;;;OAIG;IACH,YAAY,IAAI,IAAI;CAGrB"}
+{"version":3,"file":"disk-cache.d.ts","names":[],"sources":["../../src/unplugin/disk-cache.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA4DiB;EACf;EACA;;UASe;;EAEf;;EAEA;;EAEA,QAAQ;;EAER,MAAM;;;UAIS;EACf;EACA;EACA;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiEc,wBAAwB;;iBAiGxB;cAoBH;mBACM;mBACA;;mBAEA;UACT;UACA;EAEI,YAAA,aAAa,oBAAoB;;;;;;SAWtC,WAAW;EAOlB,IAAI,YAAY;UAIR;UAIA;;;;;;;UAUA;;;;;;;;;;UAiCA;;EA0CR,KAAK,cAAc;;;;;;UAoBX;;;;;;;UAoCA;;UAeA;UAaA;;EA+BR,KACE,aACA,uBACA,6BACA,QAAQ,iBACR,MAAM;;;;;;;EAeR,aACE,aACA,uBACA,QAAQ,iBACR,MAAM;;;;;EAWR;;;;;;EAoBA"}