@kubb/core 5.0.0-beta.40 → 5.0.0-beta.42

package/dist/index.d.ts

@@ -1,7 +1,13 @@
 import { t as __name } from "./chunk-C0LytTxp.js";
-import { $ as Override, A as KubbHookEndContext, At as logLevel, B as createKubb, Bt as AsyncEventEmitter, C as KubbErrorContext, Ct as createReporter, D as KubbFilesProcessingUpdateContext, Dt as LoggerOptions, E as KubbFilesProcessingStartContext, Et as LoggerContext, F as KubbPluginsEndContext, Ft as createStorage, G as Exclude, H as GeneratorContext, I as KubbSuccessContext, It as Adapter, J as KubbPluginEndContext, K as Group, L as KubbWarnContext, Lt as AdapterFactoryOptions, M as KubbHooks, Mt as RendererFactory, N as KubbInfoContext, Nt as createRenderer, O as KubbGenerationEndContext, Ot as UserLogger, P as KubbLifecycleStartContext, Pt as Storage, Q as Output, R as PossibleConfig, Rt as AdapterSource, S as KubbDiagnosticContext, St as UserReporter, T as KubbFilesProcessingEndContext, Tt as Logger, U as defineGenerator, V as Generator, W as KubbDriver, X as KubbPluginStartContext, Y as KubbPluginSetupContext, Z as NormalizedPlugin, _ as InputPath, _t as defineParser, a as DiagnosticLocation, at as ResolveBannerFile, b as KubbBuildStartContext, bt as ReporterContext, c as PerformanceDiagnostic, ct as ResolverContext, d as SerializedDiagnostic, dt as defineResolver, et as Plugin, f as UpdateDiagnostic, ft as Middleware, g as InputData, gt as Parser, h as Config, ht as ParsedFile, i as DiagnosticKind, it as ResolveBannerContext, j as KubbHookStartContext, jt as Renderer, k as KubbGenerationStartContext, kt as defineLogger, l as ProblemCode, lt as ResolverFileParams, m as CLIOptions, mt as FileProcessorHooks, n as DiagnosticByCode, nt as definePlugin, o as DiagnosticSeverity, ot as ResolveOptionsContext, p as BuildOutput, pt as defineMiddleware, q as Include, r as DiagnosticDoc, rt as BannerMeta, s as Diagnostics, st as Resolver, t as Diagnostic, tt as PluginFactoryOptions, u as ProblemDiagnostic, ut as ResolverPathParams, v as Kubb, vt as GenerationResult, w as KubbFileProcessingUpdate, wt as selectReporters, x as KubbConfigEndContext, xt as ReporterName, y as KubbBuildEndContext, yt as Reporter, z as UserConfig, zt as createAdapter } from "./diagnostics-DhfW8YpT.js";
+import { $ as Output, A as KubbHookEndContext, At as defineLogger, B as UserConfig, Bt as CachedSnapshot, C as KubbErrorContext, Ct as UserReporter, D as KubbFilesProcessingUpdateContext, Dt as LoggerContext, E as KubbFilesProcessingStartContext, Et as Logger, F as KubbLifecycleStartContext, Ft as RendererFactory, G as KubbDriver, Gt as createAdapter, H as Generator, Ht as Adapter, I as KubbPluginsEndContext, It as createRenderer, J as Include, K as Exclude, Kt as AsyncEventEmitter, L as KubbSuccessContext, Lt as Storage, M as KubbHookStartContext, Mt as FsCacheOptions, N as KubbHooks, Nt as fsCache, O as KubbGenerationEndContext, Ot as LoggerOptions, P as KubbInfoContext, Pt as Renderer, Q as NormalizedPlugin, R as KubbWarnContext, Rt as createStorage, S as KubbDiagnosticContext, St as ReporterName, T as KubbFilesProcessingEndContext, Tt as selectReporters, U as GeneratorContext, Ut as AdapterFactoryOptions, V as createKubb, Vt as createCache, W as defineGenerator, Wt as AdapterSource, X as KubbPluginSetupContext, Y as KubbPluginEndContext, Z as KubbPluginStartContext, _ as InputPath, _t as Parser, a as DiagnosticLocation, at as ResolveBannerContext, b as KubbBuildStartContext, bt as Reporter, c as PerformanceDiagnostic, ct as Resolver, d as SerializedDiagnostic, dt as ResolverPathParams, et as Override, f as UpdateDiagnostic, ft as defineResolver, g as InputData, gt as ParsedFile, h as Config, ht as FileProcessorHooks, i as DiagnosticKind, it as BannerMeta, j as KubbHookLineContext, jt as logLevel, k as KubbGenerationStartContext, kt as UserLogger, l as ProblemCode, lt as ResolverContext, m as CLIOptions, mt as defineMiddleware, n as DiagnosticByCode, nt as PluginFactoryOptions, o as DiagnosticSeverity, ot as ResolveBannerFile, p as BuildOutput, pt as Middleware, q as Group, r as DiagnosticDoc, rt as definePlugin, s as Diagnostics, st as ResolveOptionsContext, t as Diagnostic, tt as Plugin, u as ProblemDiagnostic, ut as ResolverFileParams, v as Kubb, vt as defineParser, w as KubbFileProcessingUpdate, wt as createReporter, x as KubbConfigEndContext, xt as ReporterContext, y as KubbBuildEndContext, yt as GenerationResult, z as PossibleConfig, zt as Cache } from "./diagnostics-DZGgDzSv.js";
 import * as ast from "@kubb/ast";
 
+//#region ../../internals/utils/src/runtime.d.ts
+/**
+ * Name of the JavaScript runtime executing the current process.
+ */
+type RuntimeName = 'bun' | 'deno' | 'node';
+//#endregion
 //#region ../../internals/utils/src/urlPath.d.ts
 type URLObject = {
   /**
@@ -279,6 +285,14 @@ type TelemetryEvent = {
   command: string;
   kubbVersion: string;
   nodeVersion: string;
+  /**
+   * Name of the JavaScript runtime that executed the run, `'bun'`, `'deno'`, or `'node'`.
+   */
+  runtime: RuntimeName;
+  /**
+   * Major version of the active runtime, e.g. `'1'` under Bun or `'22'` under Node.
+   */
+  runtimeVersion: string;
   platform: string;
   ci: boolean;
   plugins: Array<TelemetryPlugin>;
@@ -369,5 +383,5 @@ declare const fsStorage: (options?: Record<string, never> | undefined) => Storag
  */
 declare const memoryStorage: (options?: Record<string, never> | undefined) => Storage;
 //#endregion
-export { type Adapter, type AdapterFactoryOptions, type AdapterSource, AsyncEventEmitter, type BannerMeta, type BuildOutput, type CLIOptions, type Config, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileProcessorHooks, type GenerationResult, type Generator, type GeneratorContext, type Group, type Include, type InputData, type InputPath, type Kubb, type KubbBuildEndContext, type KubbBuildStartContext, type KubbConfigEndContext, type KubbDiagnosticContext, KubbDriver, type KubbErrorContext, type KubbFileProcessingUpdate, type KubbFilesProcessingEndContext, type KubbFilesProcessingStartContext, type KubbFilesProcessingUpdateContext, type KubbGenerationEndContext, type KubbGenerationStartContext, type KubbHookEndContext, type KubbHookStartContext, type KubbHooks, type KubbInfoContext, type KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, type KubbPluginsEndContext, type KubbSuccessContext, type KubbWarnContext, type Logger, type LoggerContext, type LoggerOptions, type Middleware, type NormalizedPlugin, type Output, type Override, type ParsedFile, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, type PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveOptionsContext, type Resolver, type ResolverContext, type ResolverFileParams, type ResolverPathParams, type SerializedDiagnostic, type Storage, Telemetry, URLPath, type UpdateDiagnostic, type UserConfig, type UserLogger, type UserReporter, ast, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage, selectReporters };
+export { type Adapter, type AdapterFactoryOptions, type AdapterSource, AsyncEventEmitter, type BannerMeta, type BuildOutput, type CLIOptions, type Cache, type CachedSnapshot, type Config, type Diagnostic, type DiagnosticByCode, type DiagnosticDoc, type DiagnosticKind, type DiagnosticLocation, type DiagnosticSeverity, Diagnostics, type Exclude, type FileProcessorHooks, type FsCacheOptions, type GenerationResult, type Generator, type GeneratorContext, type Group, type Include, type InputData, type InputPath, type Kubb, type KubbBuildEndContext, type KubbBuildStartContext, type KubbConfigEndContext, type KubbDiagnosticContext, KubbDriver, type KubbErrorContext, type KubbFileProcessingUpdate, type KubbFilesProcessingEndContext, type KubbFilesProcessingStartContext, type KubbFilesProcessingUpdateContext, type KubbGenerationEndContext, type KubbGenerationStartContext, type KubbHookEndContext, type KubbHookLineContext, type KubbHookStartContext, type KubbHooks, type KubbInfoContext, type KubbLifecycleStartContext, type KubbPluginEndContext, type KubbPluginSetupContext, type KubbPluginStartContext, type KubbPluginsEndContext, type KubbSuccessContext, type KubbWarnContext, type Logger, type LoggerContext, type LoggerOptions, type Middleware, type NormalizedPlugin, type Output, type Override, type ParsedFile, type Parser, type PerformanceDiagnostic, type Plugin, type PluginFactoryOptions, type PossibleConfig, type ProblemCode, type ProblemDiagnostic, type Renderer, type RendererFactory, type Reporter, type ReporterContext, type ReporterName, type ResolveBannerContext, type ResolveBannerFile, type ResolveOptionsContext, type Resolver, type ResolverContext, type ResolverFileParams, type ResolverPathParams, type SerializedDiagnostic, type Storage, Telemetry, URLPath, type UpdateDiagnostic, type UserConfig, type UserLogger, type UserReporter, ast, cliReporter, createAdapter, createCache, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fileReporter, fsCache, fsStorage, jsonReporter, logLevel, memoryStorage, selectReporters };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,8 +1,8 @@
 import "./chunk-C0LytTxp.js";
-import { c as createStorage, d as URLPath, f as formatMs, g as BuildError, h as AsyncEventEmitter, l as Diagnostics, n as KubbDriver, o as defineResolver, p as getElapsedMs, r as _usingCtx, s as definePlugin, t as memoryStorage, u as OTLP_ENDPOINT } from "./memoryStorage-DTv1Kub1.js";
+import { c as createStorage, d as URLPath, f as formatMs, g as BuildError, h as AsyncEventEmitter, l as Diagnostics, n as KubbDriver, o as defineResolver, p as getElapsedMs, r as _usingCtx, s as definePlugin, t as memoryStorage, u as OTLP_ENDPOINT } from "./memoryStorage-BOnaknb7.js";
 import { stripVTControlCharacters, styleText } from "node:util";
-import { createHash, randomBytes } from "node:crypto";
-import { access, mkdir, readFile, readdir, rm, writeFile } from "node:fs/promises";
+import { createHash, hash, randomBytes } from "node:crypto";
+import { access, glob, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve } from "node:path";
 import { promises } from "node:dns";
 import * as ast from "@kubb/ast";
@@ -58,7 +58,26 @@ const randomColors = [
 */
 function randomCliColor(text) {
 	if (!text) return "";
-	return styleText(randomColors[createHash("sha256").update(text).digest().readUInt32BE(0) % randomColors.length] ?? "white", text);
+	return styleText(randomColors[hash("sha256", text, "buffer").readUInt32BE(0) % randomColors.length] ?? "white", text);
+}
+//#endregion
+//#region ../../internals/utils/src/path.ts
+/**
+* Converts a filesystem path to use POSIX (`/`) separators.
+*
+* Most of the codebase compares and composes paths as strings (prefix matching, joining for
+* import specifiers, splitting on `/`). On POSIX `path.resolve` already returns `/`-separated
+* paths, but on Windows it returns `\`-separated paths, which breaks every such comparison.
+*
+* Routing every path that crosses a module boundary through `toPosixPath` keeps the rest of the
+* code platform-agnostic. The conversion runs unconditionally so Windows-specific behavior is
+* exercisable from POSIX CI.
+*
+* @example
+* toPosixPath('C:\\repo\\src\\pet.ts') // 'C:/repo/src/pet.ts'
+*/
+function toPosixPath(filePath) {
+	return filePath.replaceAll("\\", "/");
 }
 //#endregion
 //#region ../../internals/utils/src/env.ts
@@ -78,8 +97,72 @@ function isCIEnvironment() {
 	return !!(process.env.CI || process.env.GITHUB_ACTIONS || process.env.GITLAB_CI || process.env.BITBUCKET_BUILD_NUMBER || process.env.JENKINS_URL || process.env.CIRCLECI || process.env.TRAVIS || process.env.TEAMCITY_VERSION || process.env.BUILDKITE || process.env.TF_BUILD);
 }
 //#endregion
+//#region ../../internals/utils/src/runtime.ts
+/**
+* Returns `true` when the current process is running under Bun.
+*
+* Detection keys off the global `Bun` object rather than `process.versions`,
+* because Bun polyfills `process.versions.node` for Node compatibility and would
+* otherwise look like Node.
+*
+* @example
+* ```ts
+* if (isBun()) {
+*   await Bun.write(path, data)
+* }
+* ```
+*/
+function isBun() {
+	return typeof Bun !== "undefined";
+}
+/**
+* Returns `true` when the current process is running under Deno.
+*/
+function isDeno() {
+	return typeof globalThis.Deno !== "undefined";
+}
+/**
+* Returns the name of the runtime executing the current process.
+*
+* @example
+* ```ts
+* getRuntimeName() // 'bun' when run with `bun kubb`, 'node' otherwise
+* ```
+*/
+function getRuntimeName() {
+	if (isBun()) return "bun";
+	if (isDeno()) return "deno";
+	return "node";
+}
+/**
+* Returns the version of the active runtime, or an empty string when it cannot be read.
+*
+* @example
+* ```ts
+* getRuntimeVersion() // '1.3.11' under Bun, '22.22.2' under Node
+* ```
+*/
+function getRuntimeVersion() {
+	if (isBun()) return process.versions.bun ?? "";
+	if (isDeno()) return globalThis.Deno?.version?.deno ?? "";
+	return process.versions?.node ?? "";
+}
+//#endregion
 //#region ../../internals/utils/src/fs.ts
 /**
+* Reads the file at `path` as a UTF-8 string.
+* Uses `Bun.file().text()` when running under Bun, `fs.readFile` otherwise.
+*
+* @example
+* ```ts
+* const source = await read('./src/Pet.ts')
+* ```
+*/
+async function read(path) {
+	if (isBun()) return Bun.file(path).text();
+	return readFile(path, { encoding: "utf8" });
+}
+/**
 * Writes `data` to `path`, trimming leading/trailing whitespace before saving.
 * Skips the write when the trimmed content is empty or identical to what is already on disk.
 * Creates any missing parent directories automatically.
@@ -96,7 +179,7 @@ async function write(path, data, options = {}) {
 	const trimmed = data.trim();
 	if (trimmed === "") return null;
 	const resolved = resolve(path);
-	if (typeof Bun !== "undefined") {
+	if (isBun()) {
 		const file = Bun.file(resolved);
 		if ((await file.exists() ? await file.text() : null) === trimmed) return null;
 		await Bun.write(resolved, trimmed);
@@ -209,6 +292,35 @@ function createAdapter(build) {
 	return (options) => build(options ?? {});
 }
 //#endregion
+//#region src/createCache.ts
+/**
+* Defines a custom cache backend. The builder receives user options and returns a
+* {@link Cache}. Reach for this when the filesystem backend doesn't fit, for
+* example to store snapshots in Redis or a database.
+*
+* @example In-memory cache (the built-in implementation)
+* ```ts
+* import { createCache } from '@kubb/core'
+*
+* export const memoryCache = createCache(() => {
+*   const store = new Map<string, CachedSnapshot>()
+*
+*   return {
+*     name: 'memory',
+*     async restore({ key }) {
+*       return store.get(key) ?? null
+*     },
+*     async persist({ key, snapshot }) {
+*       store.set(key, snapshot)
+*     },
+*   }
+* })
+* ```
+*/
+function createCache(build) {
+	return (options) => build(options ?? {});
+}
+//#endregion
 //#region src/storages/fsStorage.ts
 /**
 * Built-in filesystem storage driver.
@@ -260,21 +372,21 @@ const fsStorage = createStorage(() => ({
 	},
 	async getKeys(base) {
 		const resolvedBase = resolve(base ?? process.cwd());
-		async function* walk(dir, prefix) {
-			let entries;
-			try {
-				entries = await readdir(dir, { withFileTypes: true });
-			} catch (_error) {
-				return;
-			}
-			for (const entry of entries) {
-				const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
-				if (entry.isDirectory()) yield* walk(join(dir, entry.name), rel);
-				else yield rel;
-			}
+		if (isBun()) {
+			const bunGlob = new Bun.Glob("**/*");
+			return Array.fromAsync(bunGlob.scan({
+				cwd: resolvedBase,
+				onlyFiles: true,
+				dot: true
+			}));
 		}
 		const keys = [];
-		for await (const key of walk(resolvedBase, "")) keys.push(key);
+		try {
+			for await (const entry of glob("**/*", {
+				cwd: resolvedBase,
+				withFileTypes: true
+			})) if (entry.isFile()) keys.push(toPosixPath(relative(resolvedBase, join(entry.parentPath, entry.name))));
+		} catch (_error) {}
 		return keys;
 	},
 	async clear(base) {
@@ -333,6 +445,7 @@ function resolveConfig(userConfig) {
 			...userConfig.output
 		},
 		storage: userConfig.storage ?? fsStorage(),
+		cache: userConfig.cache === false ? void 0 : userConfig.cache,
 		reporters: userConfig.reporters ?? [],
 		plugins: userConfig.plugins ?? []
 	};
@@ -528,11 +641,10 @@ const logLevel = {
 	verbose: 4
 };
 /**
-* Defines a typed logger. Use the second type parameter to declare a return
-* value from `install`, which is handy when the logger exposes a sink factory
-* or cleanup callback to the caller.
+* Defines a typed logger. The `install` method subscribes to lifecycle events
+* on the shared emitter and forwards them to the logger's destination.
 *
-* @example Basic logger
+* @example
 * ```ts
 * import { defineLogger } from '@kubb/core'
 *
@@ -544,20 +656,6 @@ const logLevel = {
 *   },
 * })
 * ```
-*
-* @example Logger that returns a hook sink factory
-* ```ts
-* import { defineLogger, type LoggerOptions } from '@kubb/core'
-* import type { HookSinkFactory } from './sinks'
-*
-* export const myLogger = defineLogger<LoggerOptions, HookSinkFactory>({
-*   name: 'my-logger',
-*   install(context) {
-*     // … register event handlers …
-*     return () => ({ onStdout: console.log })
-*   },
-* })
-* ```
 */
 function defineLogger(logger) {
 	return logger;
@@ -778,6 +876,8 @@ var Telemetry = class Telemetry {
 			command: options.command,
 			kubbVersion: options.kubbVersion,
 			nodeVersion: process$1.versions.node.split(".")[0],
+			runtime: getRuntimeName(),
+			runtimeVersion: getRuntimeVersion().split(".")[0],
 			platform: os.platform(),
 			ci: isCIEnvironment(),
 			plugins: options.plugins ?? [],
@@ -808,6 +908,14 @@ var Telemetry = class Telemetry {
 				key: "kubb.node_version",
 				value: { stringValue: event.nodeVersion }
 			},
+			{
+				key: "kubb.runtime",
+				value: { stringValue: event.runtime }
+			},
+			{
+				key: "kubb.runtime_version",
+				value: { stringValue: event.runtimeVersion }
+			},
 			{
 				key: "kubb.platform",
 				value: { stringValue: event.platform }
@@ -1039,6 +1147,132 @@ function defineParser(parser) {
 	return parser;
 }
 //#endregion
-export { AsyncEventEmitter, Diagnostics, KubbDriver, Telemetry, URLPath, ast, cliReporter, createAdapter, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fileReporter, fsStorage, jsonReporter, logLevel, memoryStorage, selectReporters };
+//#region src/Manifest.ts
+/**
+* Reads and prunes the local cache manifest. All methods are static, so call them as
+* `Manifest.read(dir)` and `Manifest.prune(data, ...)`. A damaged manifest reads as empty so the
+* cache degrades to misses instead of throwing. Writing goes through `write` from `@internals/utils`.
+*/
+var Manifest = class Manifest {
+	/**
+	* On-disk layout version for the manifest itself. Bumped when the manifest shape changes; a
+	* mismatch makes the whole local cache read as empty.
+	*/
+	static version = 1;
+	/**
+	* Reads the manifest at `dir/manifest.json`. A missing, corrupt, or version-mismatched file reads
+	* as an empty manifest.
+	*/
+	static async read(dir) {
+		try {
+			const parsed = JSON.parse(await read(join(dir, "manifest.json")));
+			if (parsed.version !== Manifest.version || typeof parsed.entries !== "object") return Manifest.#empty();
+			return parsed;
+		} catch {
+			return Manifest.#empty();
+		}
+	}
+	/**
+	* Selects the keys to evict so the cache stays within `ttlDays` and `maxEntries`. Returns the
+	* surviving manifest plus the evicted keys (the caller deletes their blobs). Pure, does no IO.
+	*/
+	static prune(manifest, { maxEntries, ttlDays, now }) {
+		const ttlMs = ttlDays * 24 * 60 * 60 * 1e3;
+		const removed = [];
+		const kept = [];
+		for (const [key, entry] of Object.entries(manifest.entries)) if (now - entry.lastAccess > ttlMs) removed.push(key);
+		else kept.push([key, entry]);
+		if (kept.length > maxEntries) {
+			kept.sort((a, b) => b[1].lastAccess - a[1].lastAccess);
+			for (const [key] of kept.splice(maxEntries)) removed.push(key);
+		}
+		return {
+			manifest: {
+				version: Manifest.version,
+				entries: Object.fromEntries(kept)
+			},
+			removed
+		};
+	}
+	static #empty() {
+		return {
+			version: Manifest.version,
+			entries: {}
+		};
+	}
+};
+//#endregion
+//#region src/caches/fsCache.ts
+function blobName(relativePath) {
+	return `${createHash("sha256").update(relativePath).digest("hex")}.blob`;
+}
+/**
+* Local filesystem cache. Stores each build snapshot as content blobs plus an index,
+* tracked by a manifest under `node_modules/.cache/kubb/` (the Nx and Vitest
+* convention). Least-recently-used and expired entries are pruned on every persist.
+*
+* @example
+* ```ts
+* import { fsCache } from '@kubb/core'
+*
+* export default defineConfig({
+*   cache: fsCache(),
+* })
+* ```
+*/
+const fsCache = createCache((options = {}) => {
+	const dir = resolve(options.dir ?? join("node_modules", ".cache", "kubb"));
+	const maxEntries = options.maxEntries ?? 50;
+	const ttlDays = options.ttlDays ?? 7;
+	const blobsDir = join(dir, "blobs");
+	const manifestPath = join(dir, "manifest.json");
+	return {
+		name: "fs",
+		async restore({ key }) {
+			const manifest = await Manifest.read(dir);
+			const entry = manifest.entries[key];
+			if (!entry) return null;
+			try {
+				const index = JSON.parse(await read(join(blobsDir, key, "index.json")));
+				const files = {};
+				for (const { path, blob } of index) files[path] = await read(join(blobsDir, key, blob));
+				entry.lastAccess = Date.now();
+				await write(manifestPath, JSON.stringify(manifest)).catch(() => {});
+				return { files };
+			} catch {
+				return null;
+			}
+		},
+		async persist({ key, snapshot }) {
+			const entryDir = join(blobsDir, key);
+			const index = [];
+			for (const [path, source] of Object.entries(snapshot.files)) {
+				const blob = blobName(path);
+				await write(join(entryDir, blob), source);
+				index.push({
+					path,
+					blob
+				});
+			}
+			await write(join(entryDir, "index.json"), JSON.stringify(index));
+			const manifest = await Manifest.read(dir);
+			const now = Date.now();
+			manifest.entries[key] = {
+				files: index.map((item) => item.path),
+				createdAt: now,
+				lastAccess: now
+			};
+			const pruned = Manifest.prune(manifest, {
+				maxEntries,
+				ttlDays,
+				now
+			});
+			await Promise.all(pruned.removed.map((removedKey) => clean(join(blobsDir, removedKey))));
+			await write(manifestPath, JSON.stringify(pruned.manifest));
+		}
+	};
+});
+//#endregion
+export { AsyncEventEmitter, Diagnostics, KubbDriver, Telemetry, URLPath, ast, cliReporter, createAdapter, createCache, createKubb, createRenderer, createReporter, createStorage, defineGenerator, defineLogger, defineMiddleware, defineParser, definePlugin, defineResolver, fileReporter, fsCache, fsStorage, jsonReporter, logLevel, memoryStorage, selectReporters };
 
 //# sourceMappingURL=index.js.map