@kubb/core 5.12.8 → 5.13.0

package/dist/index.d.cts

@@ -848,9 +848,13 @@ declare class FileManager {
   add(...files: Array<FileNode>): Array<FileNode>;
   upsert(...files: Array<FileNode>): Array<FileNode>;
   /** Stores a generator result: a file array is upserted as is, an element renders through `renderer` first, falsy is a no-op. */
-  dispatch<TElement = unknown>({ result, renderer }: {
+  dispatch<TElement = unknown>({ result, renderer, pointer }: {
     result: TElement | Array<FileNode> | undefined | null;
     renderer?: RendererFactory<TElement> | null;
+    /**
+     * Pointer of the node the result was generated from, set on each source that carries none.
+     */
+    pointer?: string;
   }): Promise<void>;
   /**
    * Releases all stored files. Called by the core after `kubb:build:end`.
@@ -3185,6 +3189,11 @@ type Adapter<TOptions extends AdapterFactoryOptions = AdapterFactoryOptions> = {
   validate: (input: string, options?: {
     throwOnError?: boolean;
   }) => Promise<void>;
+  /**
+   * Waits for work `parse` left running alongside generation, such as spec validation in a worker thread.
+   * Kubb awaits it before `kubb:build:end`, inside the build's diagnostics scope. Must not reject.
+   */
+  settle?: () => Promise<void>;
   /**
    * Zero-based UTF-16 offsets of a diagnostic in `source` for a code frame, `end` exclusive; `undefined` when it cannot be found.
    */
@@ -3663,8 +3672,9 @@ type KubbStorageOptions = {
  */
 export declare function resolveKubbDir(base?: string): string;
 /**
- * unstorage on the fs driver, rooted at {@link resolveKubbDir}. The fs driver cannot set a file
- * mode, so the 0700 folder keeps files such as a stored token private.
+ * Key-value files rooted at {@link resolveKubbDir}. Each key is a file path inside that folder.
+ * Strings are stored as is and other values as JSON. `getItem` parses JSON and falls back to the
+ * raw string. The 0700 folder keeps files such as a stored token private.
  *
  * @example
  * ```ts
@@ -3672,7 +3682,11 @@ export declare function resolveKubbDir(base?: string): string;
  * await storage.setItem('machine-secret', secret)
  * ```
  */
-export declare function kubbStorage({ base }?: KubbStorageOptions): import("unstorage").Storage<import("unstorage").StorageValue>;
+export declare function kubbStorage({ base }?: KubbStorageOptions): {
+  getItem<T = unknown>(key: string): Promise<T | null>;
+  setItem(key: string, value: unknown): Promise<void>;
+  removeItem(key: string): Promise<void>;
+};
 //#endregion
 //#region src/storages/memoryStorage.d.ts
 /**

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as NodeCache, $t as ReporterContext, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as createOutputManifest, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createRenderer, K as ResolverFileParams, Kt as Renderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as Reporter, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as OutputManifest, X as Generator, Xt as createStorage, Y as ResolverPathParams, Yt as Storage, Z as GeneratorContext, Zt as GenerationResult, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as DiagnosticFormatOptions, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as ParserDefinition, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as ReporterName, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as logLevel, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, ln as ParserFactory, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as UserReporter, nt as DiagnosticKind, o as createAdapter, on as SerializedDiagnostic, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as RendererFactory, r as AdapterFactory, rn as createReporter, rt as DiagnosticLocation, s as ExtensionDependencies, sn as Parser, st as ProblemCode, t as Adapter, tn as ReporterPluginFiles, tt as DiagnosticDoc, u as ExtensionFactory, un as defineParser, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-DFXvZLZC.js";
+import { $ as NodeCache, $t as ReporterContext, A as PluginFactory, At as KubbInfoContext, B as ResolveImportsOptions, Bt as RunHookOptions, C as NormalizedPlugin, Ct as KubbGenerationEndContext, D as Override, Dt as KubbHookLineContext, E as OutputOptions, Et as KubbHookEndContext, F as definePlugin, Ft as KubbWarnContext, G as ResolverFile, Gt as createOutputManifest, H as ResolvePathOptions, Ht as KubbDriver, I as BannerMeta, It as PossibleConfig, J as ResolverPatch, Jt as createRenderer, K as ResolverFileParams, Kt as Renderer, L as ResolveBannerContext, Lt as PostGenerateCommand, M as PluginType, Mt as KubbMessageContext, N as ResolvePluginOptions, Nt as KubbPluginsEndContext, O as Plugin, Ot as KubbHookStartContext, P as assertPluginOption, Pt as KubbSuccessContext, Q as defineGenerator, Qt as Reporter, R as ResolveBannerFile, Rt as UserConfig, S as KubbPluginStartContext, St as KubbFilesProcessingUpdateContext, T as OutputMode, Tt as KubbGenerationSummaryContext, U as Resolver, Ut as Hookable, V as ResolveOptionsContext, Vt as runHook, W as ResolverDefault, Wt as OutputManifest, X as Generator, Xt as createStorage, Y as ResolverPathParams, Yt as Storage, Z as GeneratorContext, Zt as GenerationResult, _ as Filter, _t as KubbDiagnosticContext, a as AdapterSource, an as DiagnosticFormatOptions, at as Diagnostics, b as KubbPluginEndContext, bt as KubbFilesProcessingEndContext, c as ExtensionDependency, cn as ParserDefinition, ct as ProblemDiagnostic, d as ExtensionKind, dt as CLIOptions, en as ReporterName, et as Diagnostic, f as ExtensionMeta, ft as Config, g as Exclude, gt as KubbBuildStartContext, h as resolveMeta, ht as KubbBuildEndContext, i as AdapterFactoryOptions, in as logLevel, it as DiagnosticSeverity, j as PluginName, jt as KubbLifecycleStartContext, k as PluginDefinition, kt as KubbHooks, l as ExtensionDependencyRecord, ln as ParserFactory, lt as UpdateDiagnostic, m as defineExtension, mt as Input, n as AdapterDefinition, nn as UserReporter, nt as DiagnosticKind, o as createAdapter, on as SerializedDiagnostic, ot as PerformanceDiagnostic, p as checkCompatibility, pt as FilesContext, q as ResolverFilePathParams, qt as RendererFactory, r as AdapterFactory, rn as createReporter, rt as DiagnosticLocation, s as ExtensionDependencies, sn as Parser, st as ProblemCode, t as Adapter, tn as ReporterPluginFiles, tt as DiagnosticDoc, u as ExtensionFactory, un as defineParser, ut as BuildOutput, v as Group, vt as KubbErrorContext, w as Output, wt as KubbGenerationStartContext, x as KubbPluginSetupContext, xt as KubbFilesProcessingStartContext, y as Include, yt as KubbFileProcessingUpdate, z as ResolveFileOptions, zt as HookResult } from "./createAdapter-BNUEQcw9.js";
 import { FileNode, Macro, UserFileNode } from "@kubb/ast";
 import { AsyncLocalStorage } from "node:async_hooks";
 import net from "node:net";
@@ -441,8 +441,9 @@ type KubbStorageOptions = {
  */
 export declare function resolveKubbDir(base?: string): string;
 /**
- * unstorage on the fs driver, rooted at {@link resolveKubbDir}. The fs driver cannot set a file
- * mode, so the 0700 folder keeps files such as a stored token private.
+ * Key-value files rooted at {@link resolveKubbDir}. Each key is a file path inside that folder.
+ * Strings are stored as is and other values as JSON. `getItem` parses JSON and falls back to the
+ * raw string. The 0700 folder keeps files such as a stored token private.
  *
  * @example
  * ```ts
@@ -450,7 +451,11 @@ export declare function resolveKubbDir(base?: string): string;
  * await storage.setItem('machine-secret', secret)
  * ```
  */
-export declare function kubbStorage({ base }?: KubbStorageOptions): import("unstorage").Storage<import("unstorage").StorageValue>;
+export declare function kubbStorage({ base }?: KubbStorageOptions): {
+  getItem<T = unknown>(key: string): Promise<T | null>;
+  setItem(key: string, value: unknown): Promise<void>;
+  removeItem(key: string): Promise<void>;
+};
 //#endregion
 //#region src/storages/memoryStorage.d.ts
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as formatMs, B as toError, C as useConfig, D as defineExtension, E as checkCompatibility, F as listFiles, I as read, L as rm$1, M as inParallel, N as existsSync$1, O as resolveMeta, P as isPathInside, R as write, S as tryUseKubb, T as useOptions, _ as kubbContext, b as setOptions, c as Resolver, d as isPublicAddress, f as assertPluginOption, g as injectFile, h as addMacro, j as getElapsedMs, k as Diagnostics, l as getInputKind, m as addGenerator, n as KubbDriver, o as _usingCtx, p as definePlugin, s as createResolver, t as Hookable, u as checkoutGitInput, v as requirePlugin, w as useKubb, x as setResolver, y as setMacros, z as writeRaw } from "./Hookable-CsDHibJ8.js";
+import { A as formatMs, B as writeRaw, C as useConfig, D as defineExtension, E as checkCompatibility, F as isPathInside, I as listFiles, L as read, M as inParallel, N as exists, O as resolveMeta, P as existsSync$1, R as rm$1, S as tryUseKubb, T as useOptions, V as toError, _ as kubbContext, b as setOptions, c as Resolver, d as isPublicAddress, f as assertPluginOption, g as injectFile, h as addMacro, j as getElapsedMs, k as Diagnostics, l as getInputKind, m as addGenerator, n as KubbDriver, o as _usingCtx, p as definePlugin, s as createResolver, t as Hookable, u as checkoutGitInput, v as requirePlugin, w as useKubb, x as setResolver, y as setMacros, z as write } from "./Hookable-BR69O7aj.js";
 import { createRequire } from "node:module";
 import { isValid } from "verkit";
 import process$1 from "node:process";
@@ -10,8 +10,6 @@ import { stripVTControlCharacters, styleText } from "node:util";
 import { homedir, tmpdir } from "node:os";
 import { hash, randomUUID } from "node:crypto";
 import { createInterface } from "node:readline";
-import { createStorage as createStorage$1 } from "unstorage";
-import fsDriver from "unstorage/drivers/fs";
 import { fileURLToPath } from "node:url";
 //#region ../../internals/utils/src/isCIEnvironment.ts
 /**
@@ -1016,8 +1014,9 @@ function resolveKubbDir(base = "") {
 	}
 }
 /**
-* unstorage on the fs driver, rooted at {@link resolveKubbDir}. The fs driver cannot set a file
-* mode, so the 0700 folder keeps files such as a stored token private.
+* Key-value files rooted at {@link resolveKubbDir}. Each key is a file path inside that folder.
+* Strings are stored as is and other values as JSON. `getItem` parses JSON and falls back to the
+* raw string. The 0700 folder keeps files such as a stored token private.
 *
 * @example
 * ```ts
@@ -1026,7 +1025,30 @@ function resolveKubbDir(base = "") {
 * ```
 */
 function kubbStorage({ base } = {}) {
-	return createStorage$1({ driver: fsDriver({ base: resolveKubbDir(base) }) });
+	const dir = resolveKubbDir(base);
+	const pathOf = (key) => {
+		const path = resolve(dir, key.replaceAll(":", "/"));
+		if (path === dir || !isPathInside(path, dir)) throw new Error(`Invalid key: ${JSON.stringify(key)}. It should not leave the storage folder`);
+		return path;
+	};
+	return {
+		async getItem(key) {
+			const path = pathOf(key);
+			if (!await exists(path)) return null;
+			const raw = await read(path);
+			try {
+				return JSON.parse(raw);
+			} catch {
+				return raw;
+			}
+		},
+		async setItem(key, value) {
+			await writeRaw(pathOf(key), typeof value === "string" ? value : JSON.stringify(value));
+		},
+		async removeItem(key) {
+			await rm$1(pathOf(key), { force: true });
+		}
+	};
 }
 //#endregion
 //#region src/reporters/fileReporter.ts