@kubb/cli 5.14.6 → 5.15.1

package/dist/utils-BdibacYq.js

@@ -0,0 +1,244 @@
+import "./rolldown-runtime-xo6NMXYd.js";
+import { a as matchesStored, o as read } from "./spinner-BZaln7O8.js";
+import { styleText } from "node:util";
+import process from "node:process";
+import { readdir } from "node:fs/promises";
+import { join, relative } from "node:path";
+// ../../internals/utils/src/promise.ts
+/**
+* Runs `run` over every item with at most `limit` in flight. Workers share one iterator, so each
+* takes the next item the moment it frees up instead of waiting for a batch to drain.
+*
+* @example
+* ```ts
+* await inParallel({ items: files, limit: 50, run: (file) => storage.writeItem(file.path, file.source) })
+* ```
+*/
+async function inParallel({ items, limit, run }) {
+	const queue = items.entries();
+	const worker = async () => {
+		for (const [index, item] of queue) await run(item, index);
+	};
+	await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => worker()));
+}
+// src/runners/generate/utils.ts
+/** Glob pattern for paths the file watcher ignores. */
+const WATCHER_IGNORED_PATHS = "**/{.git,node_modules}/**";
+/**
+* Quiet window in milliseconds that collapses a burst of watcher events (an editor save emits several) into one rebuild.
+* It outlasts chokidar's 100 ms atomic-save window, which holds back the event of a write-then-rename save.
+*/
+const WATCHER_DEBOUNCE_MS = 250;
+/** `14:02:11  petStore.yaml changed`, the line a watcher prints when its input changes. */
+function formatChange({ target, removed = false, now = /* @__PURE__ */ new Date() }) {
+	return `${styleText("dim", now.toTimeString().slice(0, 8))}  ${styleText("bold", target)} ${removed ? "removed" : "changed"}`;
+}
+/**
+* Starts a file watcher on the given paths and calls `cb` on any change.
+* Ignores `.git` and `node_modules` directories. Event bursts (an editor save emits several)
+* are debounced into one call. `cb` must never reject: its result is not awaited, so the caller
+* serializes and reports its own builds. Resolves to a function that stops watching.
+*/
+async function startWatcher(path, cb, log = {
+	info: console.log,
+	error: console.log
+}) {
+	const { watch } = await import("chokidar");
+	const watcher = watch(path, {
+		ignorePermissionErrors: true,
+		ignored: WATCHER_IGNORED_PATHS,
+		ignoreInitial: true
+	});
+	for (const signal of ["SIGINT", "SIGTERM"]) process.once(signal, () => void watcher.close());
+	let debounceTimer = null;
+	watcher.on("all", (type, file) => {
+		log.info(formatChange({
+			target: relative(process.cwd(), file),
+			removed: type === "unlink"
+		}));
+		if (debounceTimer) clearTimeout(debounceTimer);
+		debounceTimer = setTimeout(() => {
+			debounceTimer = null;
+			cb(path);
+		}, WATCHER_DEBOUNCE_MS);
+	});
+	return async () => {
+		if (debounceTimer) clearTimeout(debounceTimer);
+		await watcher.close();
+	};
+}
+function createSnapshot() {
+	return {
+		schemas: /* @__PURE__ */ new Set(),
+		operations: /* @__PURE__ */ new Set()
+	};
+}
+/**
+* Collects a {@link BuildSnapshot} from the hooks while a build runs. `take` hands back the finished
+* build's snapshot and starts the next one.
+*/
+function trackBuild(hooks) {
+	let current = createSnapshot();
+	hooks.hook("kubb:generate:schema", (node) => {
+		if (node.name) current.schemas.add(node.name);
+	});
+	hooks.hook("kubb:generate:operation", (node) => {
+		current.operations.add(node.operationId);
+	});
+	return { take() {
+		const snapshot = current;
+		current = createSnapshot();
+		return snapshot;
+	} };
+}
+function diffNames(previous, next) {
+	return {
+		added: [...next].filter((name) => !previous.has(name)).length,
+		removed: [...previous].filter((name) => !next.has(name)).length
+	};
+}
+/**
+* Compares two {@link BuildSnapshot}s by name.
+*/
+function diffBuilds(previous, next) {
+	return {
+		schemas: diffNames(previous.schemas, next.schemas),
+		operations: diffNames(previous.operations, next.operations)
+	};
+}
+/**
+* Compares file contents or fingerprints by path.
+*/
+function diffFiles(previous, next) {
+	const files = [];
+	let unchanged = 0;
+	for (const [path, fingerprint] of next) {
+		const before = previous.get(path);
+		if (before === fingerprint) unchanged++;
+		else files.push({
+			status: before === void 0 ? "A" : "M",
+			path
+		});
+	}
+	for (const path of previous.keys()) if (!next.has(path)) files.push({
+		status: "D",
+		path
+	});
+	return {
+		files,
+		unchanged
+	};
+}
+function countLineChanges(before, after) {
+	const remaining = /* @__PURE__ */ new Map();
+	for (const line of before ? before.split("\n") : []) remaining.set(line, (remaining.get(line) ?? 0) + 1);
+	let added = 0;
+	for (const line of after ? after.split("\n") : []) {
+		const count = remaining.get(line) ?? 0;
+		if (count > 0) remaining.set(line, count - 1);
+		else added++;
+	}
+	const removed = [...remaining.values()].reduce((sum, count) => sum + count, 0);
+	return {
+		added,
+		removed
+	};
+}
+/**
+* Reads the output before generation, so cleaning the directory cannot erase the diff baseline.
+* A missing directory or an unreadable file is skipped.
+*/
+async function readOutputFiles(outputPath) {
+	const entries = await readdir(outputPath, {
+		recursive: true,
+		withFileTypes: true
+	}).catch(() => []);
+	const files = /* @__PURE__ */ new Map();
+	await inParallel({
+		items: entries.filter((entry) => entry.isFile()).map((entry) => join(entry.parentPath, entry.name)),
+		limit: 50,
+		run: async (filePath) => {
+			const source = await read(filePath).catch(() => null);
+			if (source !== null) files.set(filePath, source);
+		}
+	});
+	return files;
+}
+/**
+* Compares generated output with the files captured before generation. The manifest recognizes
+* output rewritten by a formatter, and `clean` includes files the run would delete.
+*/
+async function diffOutput({ storage, paths, clean, manifest, previousFiles }) {
+	const generated = new Set(paths);
+	const changes = [];
+	let unchanged = 0;
+	await inParallel({
+		items: paths,
+		limit: 50,
+		run: async (filePath, index) => {
+			const next = await storage.readItem(filePath);
+			if (next === null) return;
+			const previous = previousFiles.get(filePath) ?? null;
+			if (previous !== null && (matchesStored({
+				stored: previous,
+				source: next
+			}) || manifest?.isUpToDate({
+				key: filePath,
+				source: next,
+				disk: previous
+			}))) {
+				unchanged++;
+				return;
+			}
+			changes[index] = {
+				status: previous === null ? "A" : "M",
+				path: filePath,
+				...countLineChanges(previous?.trim() ?? "", previous === null ? next.trimEnd() : next.trim())
+			};
+		}
+	});
+	const files = changes.filter((file) => file !== void 0);
+	if (clean) {
+		for (const [filePath, source] of previousFiles) if (!generated.has(filePath)) files.push({
+			status: "D",
+			path: filePath,
+			...countLineChanges(source.trimEnd(), "")
+		});
+	}
+	return {
+		files,
+		unchanged
+	};
+}
+/**
+* Reads `r` (rebuild) and `q` (quit) from an interactive stdin in raw mode, and keeps ctrl+c
+* working. Returns `undefined` when stdin is not a TTY. Otherwise returns `arm`, which turns raw
+* mode back on: a spinner restores the terminal when it stops, so call it after each build. Raw mode
+* is restored on exit.
+*/
+function listenForKeys({ rebuild, quit, input = process.stdin }) {
+	if (!input.isTTY) return void 0;
+	const arm = () => {
+		input.setRawMode(true);
+		input.resume();
+	};
+	input.setEncoding("utf8");
+	input.on("data", (data) => {
+		const key = data.trim();
+		if (key === "r") {
+			rebuild();
+			return;
+		}
+		if (key === "q" || data === "") {
+			input.setRawMode(false);
+			input.pause();
+			quit(key === "q" ? 0 : 130);
+		}
+	});
+	process.once("exit", () => input.setRawMode(false));
+	arm();
+	return arm;
+}
+export { readOutputFiles as a, listenForKeys as i, diffFiles as n, startWatcher as o, diffOutput as r, trackBuild as s, diffBuilds as t };
+
+//# sourceMappingURL=utils-BdibacYq.js.map

package/dist/utils-BdibacYq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-BdibacYq.js","names":[],"sources":["../../../internals/utils/src/promise.ts","../src/runners/generate/utils.ts"],"sourcesContent":["/** A value that may already be resolved or still pending.\n *\n * @example\n * ```ts\n * function load(id: string): PossiblePromise<string> {\n *   return cache.get(id) ?? fetchRemote(id)\n * }\n * ```\n */\nexport type PossiblePromise<T> = Promise<T> | T\n\ntype Store<TKey, TValue> = {\n  has(key: TKey): boolean\n  get(key: TKey): TValue | undefined\n  set(key: TKey, value: TValue): unknown\n}\n\n/**\n * Wraps `factory` with a keyed cache backed by the provided store.\n *\n * Pass a `WeakMap` for object keys (results are GC-eligible when the key is\n * collected) or a `Map` for primitive keys. For multi-argument functions,\n * nest two `memoize` calls — the outer keyed by the first argument, the\n * inner (created once per outer miss) keyed by the second.\n *\n * Because the cache is owned by the caller, it can be shared, inspected, or\n * cleared independently of the memoized function.\n *\n * @example Single WeakMap key\n * ```ts\n * const cache = new WeakMap<SchemaNode, Set<string>>()\n * const getRefs = memoize(cache, (node) => collectRefs(node))\n * ```\n *\n * @example Single Map key (primitive)\n * ```ts\n * const cache = new Map<string, Resolver>()\n * const getResolver = memoize(cache, (name) => buildResolver(name))\n * ```\n *\n * @example Two-level (object + primitive)\n * ```ts\n * const outer = new WeakMap<Params[], Map<string, Params[]>>()\n * const fn = memoize(outer, (params) => memoize(new Map(), (key) => transform(params, key)))\n * fn(params)('camelcase')\n * ```\n */\nexport function memoize<TKey, TValue>(store: Store<TKey, TValue>, factory: (key: TKey) => TValue): (key: TKey) => TValue {\n  return (key: TKey): TValue => {\n    if (store.has(key)) return store.get(key)!\n    const value = factory(key)\n    store.set(key, value)\n    return value\n  }\n}\n\ntype ParallelOptions<TItem> = {\n  /**\n   * Items to work through, handed out in order.\n   */\n  items: ReadonlyArray<TItem>\n  /**\n   * How many items may be in flight at once.\n   */\n  limit: number\n  /**\n   * Runs once per item, with the item's position so a caller can report progress.\n   */\n  run(item: TItem, index: number): Promise<void>\n}\n\n/**\n * Runs `run` over every item with at most `limit` in flight. Workers share one iterator, so each\n * takes the next item the moment it frees up instead of waiting for a batch to drain.\n *\n * @example\n * ```ts\n * await inParallel({ items: files, limit: 50, run: (file) => storage.writeItem(file.path, file.source) })\n * ```\n */\nexport async function inParallel<TItem>({ items, limit, run }: ParallelOptions<TItem>): Promise<void> {\n  const queue = items.entries()\n\n  const worker = async (): Promise<void> => {\n    for (const [index, item] of queue) await run(item, index)\n  }\n\n  await Promise.all(Array.from({ length: Math.min(limit, items.length) }, () => worker()))\n}\n","import { readdir } from 'node:fs/promises'\nimport { join, relative } from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport { inParallel, matchesStored, read } from '@internals/utils'\nimport type { Hookable, KubbHooks, OutputManifest, Storage } from '@kubb/core'\n\n/** Glob pattern for paths the file watcher ignores. */\nconst WATCHER_IGNORED_PATHS = '**/{.git,node_modules}/**' as const\n\n/**\n * Quiet window in milliseconds that collapses a burst of watcher events (an editor save emits several) into one rebuild.\n * It outlasts chokidar's 100 ms atomic-save window, which holds back the event of a write-then-rename save.\n */\nconst WATCHER_DEBOUNCE_MS = 250\n\n/** `14:02:11  petStore.yaml changed`, the line a watcher prints when its input changes. */\nexport function formatChange({ target, removed = false, now = new Date() }: { target: string; removed?: boolean; now?: Date }): string {\n  return `${styleText('dim', now.toTimeString().slice(0, 8))}  ${styleText('bold', target)} ${removed ? 'removed' : 'changed'}`\n}\n\ntype WatcherLog = {\n  info: (message: string) => void\n  error: (message: string) => void\n}\n\n/**\n * Starts a file watcher on the given paths and calls `cb` on any change.\n * Ignores `.git` and `node_modules` directories. Event bursts (an editor save emits several)\n * are debounced into one call. `cb` must never reject: its result is not awaited, so the caller\n * serializes and reports its own builds. Resolves to a function that stops watching.\n */\nexport async function startWatcher(\n  path: Array<string>,\n  cb: (path: Array<string>) => Promise<void>,\n  log: WatcherLog = { info: console.log, error: console.log },\n): Promise<() => Promise<void>> {\n  const { watch } = await import('chokidar')\n  // `ignoreInitial` skips the `add` events chokidar fires for existing files at startup, which\n  // would otherwise rebuild right after the initial run.\n  const watcher = watch(path, { ignorePermissionErrors: true, ignored: WATCHER_IGNORED_PATHS, ignoreInitial: true })\n\n  for (const signal of ['SIGINT', 'SIGTERM'] as const) {\n    process.once(signal, () => void watcher.close())\n  }\n\n  let debounceTimer: ReturnType<typeof setTimeout> | null = null\n\n  watcher.on('all', (type, file) => {\n    log.info(formatChange({ target: relative(process.cwd(), file), removed: type === 'unlink' }))\n    if (debounceTimer) clearTimeout(debounceTimer)\n    debounceTimer = setTimeout(() => {\n      debounceTimer = null\n      void cb(path)\n    }, WATCHER_DEBOUNCE_MS)\n  })\n\n  return async () => {\n    if (debounceTimer) clearTimeout(debounceTimer)\n    await watcher.close()\n  }\n}\n\n/**\n * What one build produced: the schema and operation names the plugins generated.\n */\nexport type BuildSnapshot = {\n  schemas: Set<string>\n  operations: Set<string>\n}\n\nfunction createSnapshot(): BuildSnapshot {\n  return { schemas: new Set(), operations: new Set() }\n}\n\n/**\n * Collects a {@link BuildSnapshot} from the hooks while a build runs. `take` hands back the finished\n * build's snapshot and starts the next one.\n */\nexport function trackBuild(hooks: Hookable<KubbHooks>): { take(): BuildSnapshot } {\n  let current = createSnapshot()\n\n  hooks.hook('kubb:generate:schema', (node) => {\n    if (node.name) current.schemas.add(node.name)\n  })\n  hooks.hook('kubb:generate:operation', (node) => {\n    current.operations.add(node.operationId)\n  })\n\n  return {\n    take() {\n      const snapshot = current\n      current = createSnapshot()\n      return snapshot\n    },\n  }\n}\n\ntype NameChange = { added: number; removed: number }\n\n/**\n * How a rebuild differs from the build before it: the spec's added and removed schemas and operations.\n */\nexport type BuildDiff = {\n  schemas: NameChange\n  operations: NameChange\n}\n\nfunction diffNames(previous: Set<string>, next: Set<string>): NameChange {\n  return { added: [...next].filter((name) => !previous.has(name)).length, removed: [...previous].filter((name) => !next.has(name)).length }\n}\n\n/**\n * Compares two {@link BuildSnapshot}s by name.\n */\nexport function diffBuilds(previous: BuildSnapshot, next: BuildSnapshot): BuildDiff {\n  return {\n    schemas: diffNames(previous.schemas, next.schemas),\n    operations: diffNames(previous.operations, next.operations),\n  }\n}\n\n/**\n * Compares file contents or fingerprints by path.\n */\nexport function diffFiles(previous: ReadonlyMap<string, string>, next: ReadonlyMap<string, string>): { files: Array<FileChange>; unchanged: number } {\n  const files: Array<FileChange> = []\n  let unchanged = 0\n  for (const [path, fingerprint] of next) {\n    const before = previous.get(path)\n    if (before === fingerprint) unchanged++\n    else files.push({ status: before === undefined ? 'A' : 'M', path })\n  }\n  for (const path of previous.keys()) {\n    if (!next.has(path)) files.push({ status: 'D', path })\n  }\n\n  return { files, unchanged }\n}\n\n/** A changed file with how many lines it gains and loses, counted as a multiset, which is cheap and close enough for a plan. */\nexport type FileChange = { status: 'A' | 'M' | 'D'; path: string; added?: number; removed?: number }\n\nfunction countLineChanges(before: string, after: string): { added: number; removed: number } {\n  const remaining = new Map<string, number>()\n  for (const line of before ? before.split('\\n') : []) remaining.set(line, (remaining.get(line) ?? 0) + 1)\n  let added = 0\n  for (const line of after ? after.split('\\n') : []) {\n    const count = remaining.get(line) ?? 0\n    if (count > 0) remaining.set(line, count - 1)\n    else added++\n  }\n  const removed = [...remaining.values()].reduce((sum, count) => sum + count, 0)\n  return { added, removed }\n}\n\n/**\n * Reads the output before generation, so cleaning the directory cannot erase the diff baseline.\n * A missing directory or an unreadable file is skipped.\n */\nexport async function readOutputFiles(outputPath: string): Promise<Map<string, string>> {\n  const entries = await readdir(outputPath, { recursive: true, withFileTypes: true }).catch(() => [])\n  const files = new Map<string, string>()\n  await inParallel({\n    items: entries.filter((entry) => entry.isFile()).map((entry) => join(entry.parentPath, entry.name)),\n    limit: 50,\n    run: async (filePath) => {\n      const source = await read(filePath).catch(() => null)\n      if (source !== null) files.set(filePath, source)\n    },\n  })\n  return files\n}\n\n/**\n * Compares generated output with the files captured before generation. The manifest recognizes\n * output rewritten by a formatter, and `clean` includes files the run would delete.\n */\nexport async function diffOutput({\n  storage,\n  paths,\n  clean,\n  manifest,\n  previousFiles,\n}: {\n  storage: Storage\n  paths: ReadonlyArray<string>\n  clean: boolean\n  manifest?: Pick<OutputManifest, 'isUpToDate'>\n  /**\n   * The output captured before a real run, including files removed by cleaning.\n   */\n  previousFiles: ReadonlyMap<string, string>\n}): Promise<{ files: Array<FileChange>; unchanged: number }> {\n  const generated = new Set(paths)\n  const changes: Array<FileChange | undefined> = []\n  let unchanged = 0\n  await inParallel({\n    items: paths,\n    limit: 50,\n    run: async (filePath, index) => {\n      const next = await storage.readItem(filePath)\n      if (next === null) return\n      const previous = previousFiles.get(filePath) ?? null\n      if (previous !== null && (matchesStored({ stored: previous, source: next }) || manifest?.isUpToDate({ key: filePath, source: next, disk: previous }))) {\n        unchanged++\n        return\n      }\n      changes[index] = {\n        status: previous === null ? 'A' : 'M',\n        path: filePath,\n        ...countLineChanges(previous?.trim() ?? '', previous === null ? next.trimEnd() : next.trim()),\n      }\n    },\n  })\n  const files = changes.filter((file) => file !== undefined)\n  if (clean) {\n    for (const [filePath, source] of previousFiles) {\n      if (!generated.has(filePath)) files.push({ status: 'D', path: filePath, ...countLineChanges(source.trimEnd(), '') })\n    }\n  }\n\n  return { files, unchanged }\n}\n\ntype KeyInput = Pick<NodeJS.ReadStream, 'isTTY' | 'setRawMode' | 'resume' | 'pause' | 'setEncoding' | 'on'>\n\ntype KeyOptions = {\n  rebuild: () => void\n  /**\n   * Ends the process with this exit code: `0` for `q`, `130` for ctrl+c, which raw mode turns into a key.\n   */\n  quit: (code: number) => void\n  input?: KeyInput\n}\n\n/**\n * Reads `r` (rebuild) and `q` (quit) from an interactive stdin in raw mode, and keeps ctrl+c\n * working. Returns `undefined` when stdin is not a TTY. Otherwise returns `arm`, which turns raw\n * mode back on: a spinner restores the terminal when it stops, so call it after each build. Raw mode\n * is restored on exit.\n */\nexport function listenForKeys({ rebuild, quit, input = process.stdin }: KeyOptions): (() => void) | undefined {\n  if (!input.isTTY) return undefined\n\n  const arm = () => {\n    input.setRawMode(true)\n    input.resume()\n  }\n  input.setEncoding('utf8')\n  input.on('data', (data: string) => {\n    const key = data.trim()\n    if (key === 'r') {\n      rebuild()\n      return\n    }\n    if (key === 'q' || data === '\\u0003') {\n      input.setRawMode(false)\n      input.pause()\n      quit(key === 'q' ? 0 : 130)\n    }\n  })\n  process.once('exit', () => input.setRawMode(false))\n  arm()\n\n  return arm\n}\n"],"mappings":"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"}

package/dist/utils-CO89mxRU.cjs

@@ -0,0 +1,290 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C3-Zg-KD.cjs");
+const require_spinner = require("./spinner-CfB0sIPy.cjs");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+let tinyexec = require("tinyexec");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
+let _kubb_core = require("@kubb/core");
+// src/runners/init/utils.ts
+/** Metadata for each supported package manager, keyed by its short name. */
+const packageManagers = {
+	pnpm: {
+		name: "pnpm",
+		lockFiles: ["pnpm-lock.yaml"],
+		initCommand: ["init"],
+		installCommand: ["add", "-D"],
+		removeCommand: ["remove"],
+		runCommand: []
+	},
+	yarn: {
+		name: "yarn",
+		lockFiles: ["yarn.lock"],
+		initCommand: ["init", "-y"],
+		installCommand: ["add", "-D"],
+		removeCommand: ["remove"],
+		runCommand: []
+	},
+	bun: {
+		name: "bun",
+		lockFiles: ["bun.lock", "bun.lockb"],
+		initCommand: ["init", "-y"],
+		installCommand: ["add", "-d"],
+		removeCommand: ["remove"],
+		runCommand: ["run"]
+	},
+	npm: {
+		name: "npm",
+		lockFiles: ["package-lock.json"],
+		initCommand: ["init", "-y"],
+		installCommand: ["install", "--save-dev"],
+		removeCommand: ["uninstall"],
+		runCommand: ["run"]
+	}
+};
+/** Detects the package manager for `cwd`: the `packageManager` field in `package.json`, then a lock file, then `npm`. */
+function detectPackageManager(cwd = node_process.default.cwd()) {
+	const packageJsonPath = node_path.default.join(cwd, "package.json");
+	if (node_fs.default.existsSync(packageJsonPath)) try {
+		const pmField = JSON.parse(node_fs.default.readFileSync(packageJsonPath, "utf-8")).packageManager;
+		if (typeof pmField === "string") {
+			const name = pmField.split("@")[0];
+			if (name && name in packageManagers) return packageManagers[name];
+		}
+	} catch {}
+	for (const pm of Object.values(packageManagers)) if (pm.lockFiles.some((lockFile) => node_fs.default.existsSync(node_path.default.join(cwd, lockFile)))) return pm;
+	return packageManagers.npm;
+}
+/**
+* Initializes a new `package.json` at `cwd` using the detected package manager.
+*/
+async function initPackageJson(cwd, packageManager) {
+	await (0, tinyexec.x)(packageManager.name, [...packageManager.initCommand], {
+		nodeOptions: {
+			cwd,
+			stdio: "inherit"
+		},
+		throwOnError: true
+	});
+}
+const INSTALL_TIMEOUT_MS = 3e5;
+/**
+* Installs the given packages at `cwd` using the detected package manager. Each output line goes
+* to `onLine`, so the caller can show it while the install runs; a failed install also keeps the
+* end of the output in the error.
+*/
+async function installPackages(packages, packageManager, cwd = node_process.default.cwd(), onLine, command = packageManager.installCommand) {
+	const args = [...command, ...packages];
+	const result = (0, tinyexec.x)(packageManager.name, args, {
+		nodeOptions: {
+			cwd,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		},
+		timeout: INSTALL_TIMEOUT_MS,
+		throwOnError: false
+	});
+	const lines = [];
+	for await (const line of result) {
+		lines.push(line);
+		onLine?.(line);
+	}
+	if (result.exitCode === 0) return;
+	if (result.exitCode === void 0) throw new Error(`\`${packageManager.name} ${args.join(" ")}\` timed out after ${INSTALL_TIMEOUT_MS / 6e4} minutes`);
+	const output = lines.slice(-20).join("\n");
+	throw new Error(`\`${packageManager.name} ${args.join(" ")}\` failed with exit code ${result.exitCode}${output ? `:\n${output}` : ""}`);
+}
+/**
+* Uninstalls the given packages at `cwd` with the package manager's remove command, like {@link installPackages}.
+*/
+function uninstallPackages(packages, packageManager, cwd = node_process.default.cwd()) {
+	return installPackages(packages, packageManager, cwd, void 0, packageManager.removeCommand);
+}
+/**
+* What the selected plugins' `manifests` say is missing from the selection: a `dependencies`
+* entry, or a `client` plugin next to a `consumer`. Empty when nothing is missing.
+* `optionalDependencies` are skipped, since `kubb init` writes the default options.
+*/
+function missingPluginDependencies(manifests) {
+	const selected = manifests.map((manifest) => manifest.name);
+	const hasClient = manifests.some((manifest) => manifest.role === "client");
+	return manifests.flatMap((manifest) => [...(manifest.dependencies ?? []).filter((name) => !selected.includes(name)).map((name) => `${manifest.name} needs ${name}.`), ...manifest.role === "consumer" && !hasClient ? [`${manifest.name} needs a client plugin, such as plugin-axios or plugin-fetch.`] : []]);
+}
+async function readPackageJson(cwd) {
+	try {
+		return JSON.parse(await require_spinner.read(node_path.default.join(cwd, "package.json")));
+	} catch {
+		return {};
+	}
+}
+const SPEC_FILE = /^(openapi|swagger)[\w.-]*\.(ya?ml|json)$/i;
+const SKIPPED_DIRS = /* @__PURE__ */ new Set([
+	"node_modules",
+	"dist",
+	"build",
+	"coverage"
+]);
+/**
+* Finds OpenAPI spec files up to `depth` folders below `cwd`, shallowest first, as `./`-relative
+* paths. Walks one level at a time and stops after `limit` files, so a large repo stays fast.
+*/
+async function findSpecFiles(cwd, { depth = 3, limit = 20 } = {}) {
+	const found = [];
+	let level = [""];
+	for (let current = 0; current <= depth && level.length && found.length < limit; current++) {
+		const listings = await Promise.all(level.map(async (dir) => ({
+			dir,
+			entries: await node_fs.default.promises.readdir(node_path.default.join(cwd, dir), { withFileTypes: true }).catch(() => [])
+		})));
+		level = [];
+		for (const { dir, entries } of listings) for (const entry of entries.toSorted((a, b) => a.name.localeCompare(b.name))) {
+			if (entry.isFile() && SPEC_FILE.test(entry.name)) found.push(`./${node_path.default.posix.join(dir, entry.name)}`);
+			if (entry.isDirectory() && !entry.name.startsWith(".") && !SKIPPED_DIRS.has(entry.name)) level.push(node_path.default.posix.join(dir, entry.name));
+		}
+	}
+	return found.slice(0, limit);
+}
+const SPEC_HEAD_BYTES = 262144;
+const METHOD = "(?:get|put|post|delete|options|head|patch|trace)";
+/**
+* Reads the OpenAPI or Swagger version and counts the operations from the first 256 KB of the
+* file, so a large spec is never parsed. The count is left out when the file is longer.
+*/
+async function readSpecInfo(file) {
+	const handle = await node_fs.default.promises.open(file);
+	try {
+		const buffer = Buffer.alloc(SPEC_HEAD_BYTES);
+		const { bytesRead } = await handle.read(buffer, 0, SPEC_HEAD_BYTES, 0);
+		const head = buffer.toString("utf-8", 0, bytesRead);
+		const complete = bytesRead < SPEC_HEAD_BYTES;
+		const version = head.match(/^\s*["']?(?:openapi|swagger)["']?\s*:\s*["']?(\d[\d.]*)/m)?.[1];
+		const methods = new RegExp(`^\\s*["']?${METHOD}["']?\\s*:\\s*(?:\\{|$)`, "gm");
+		return {
+			version,
+			operations: complete ? head.match(methods)?.length ?? 0 : void 0
+		};
+	} finally {
+		await handle.close();
+	}
+}
+/** Finds a plugin by registry id, slug, or short name, so `ts`, `plugin-ts`, and `kubb-labs/plugin-ts` all match. */
+function findPlugin({ plugins, id }) {
+	const ids = id.includes("/") ? [id] : [`kubb-labs/${id}`, `kubb-labs/plugin-${id}`];
+	return plugins.find((entry) => ids.includes(entry.id));
+}
+/**
+* Turns the comma-separated `--plugins` value into registry entries.
+*
+* @throws when an id is not in `plugins`.
+*/
+function parsePluginsFlag({ plugins, value }) {
+	const ids = value.split(",").map((id) => id.trim()).filter(Boolean);
+	const unknown = ids.filter((id) => !findPlugin({
+		plugins,
+		id
+	}));
+	if (unknown.length) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.pluginNotFound,
+		severity: "error",
+		message: `Not in the Kubb registry: ${unknown.join(", ")}. Browse the plugins at https://kubb.dev/extensions.`,
+		help: "Use plugin ids from https://kubb.dev/extensions, such as plugin-ts or ts."
+	});
+	return ids.map((id) => findPlugin({
+		plugins,
+		id
+	}));
+}
+/** Adds `"generate": "kubb generate"` to the `package.json` scripts at `cwd`. Returns `false`, and changes nothing, when a `generate` script exists. */
+async function addGenerateScript(cwd) {
+	const file = node_path.default.join(cwd, "package.json");
+	const source = await require_spinner.read(file);
+	const packageJson = JSON.parse(source);
+	if (packageJson.scripts?.generate !== void 0) return false;
+	const indent = source.match(/^[ \t]+/m)?.[0] ?? "  ";
+	const updated = {
+		...packageJson,
+		scripts: {
+			...packageJson.scripts,
+			generate: "kubb generate"
+		}
+	};
+	await require_spinner.write(file, JSON.stringify(updated, null, indent));
+	return true;
+}
+/** Reads the `generate` script from the `package.json` at `cwd`. */
+async function generateScript(cwd) {
+	return (await readPackageJson(cwd)).scripts?.generate;
+}
+Object.defineProperty(exports, "addGenerateScript", {
+	enumerable: true,
+	get: function() {
+		return addGenerateScript;
+	}
+});
+Object.defineProperty(exports, "detectPackageManager", {
+	enumerable: true,
+	get: function() {
+		return detectPackageManager;
+	}
+});
+Object.defineProperty(exports, "findPlugin", {
+	enumerable: true,
+	get: function() {
+		return findPlugin;
+	}
+});
+Object.defineProperty(exports, "findSpecFiles", {
+	enumerable: true,
+	get: function() {
+		return findSpecFiles;
+	}
+});
+Object.defineProperty(exports, "generateScript", {
+	enumerable: true,
+	get: function() {
+		return generateScript;
+	}
+});
+Object.defineProperty(exports, "initPackageJson", {
+	enumerable: true,
+	get: function() {
+		return initPackageJson;
+	}
+});
+Object.defineProperty(exports, "installPackages", {
+	enumerable: true,
+	get: function() {
+		return installPackages;
+	}
+});
+Object.defineProperty(exports, "missingPluginDependencies", {
+	enumerable: true,
+	get: function() {
+		return missingPluginDependencies;
+	}
+});
+Object.defineProperty(exports, "parsePluginsFlag", {
+	enumerable: true,
+	get: function() {
+		return parsePluginsFlag;
+	}
+});
+Object.defineProperty(exports, "readSpecInfo", {
+	enumerable: true,
+	get: function() {
+		return readSpecInfo;
+	}
+});
+Object.defineProperty(exports, "uninstallPackages", {
+	enumerable: true,
+	get: function() {
+		return uninstallPackages;
+	}
+});
+
+//# sourceMappingURL=utils-CO89mxRU.cjs.map

package/dist/utils-CO89mxRU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils-CO89mxRU.cjs","names":["process","path","fs","x","read","Diagnostics","write"],"sources":["../src/runners/init/utils.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport process from 'node:process'\nimport { read, write } from '@internals/utils'\nimport { Diagnostics, type ExtensionManifest, type RegistryEntry } from '@kubb/core'\nimport { x } from 'tinyexec'\n\nexport type PackageManagerName = 'npm' | 'pnpm' | 'yarn' | 'bun'\n\n/** Metadata describing a package manager's lock file and commands. */\nexport type PackageManagerInfo = {\n  /** Identifier used in CLI commands, e.g. `pnpm`, `yarn`. */\n  name: PackageManagerName\n  /** Lock file names that identify this package manager in a project root. */\n  lockFiles: ReadonlyArray<string>\n  /** Subcommands passed to the package manager binary to create a `package.json`. */\n  initCommand: ReadonlyArray<string>\n  /** Subcommands passed to the package manager binary to install a dev dependency. */\n  installCommand: ReadonlyArray<string>\n  /** Subcommands passed to the package manager binary to uninstall a dependency. */\n  removeCommand: ReadonlyArray<string>\n  /** Subcommands passed to the package manager binary before a `package.json` script name. */\n  runCommand: ReadonlyArray<string>\n}\n\n/** Metadata for each supported package manager, keyed by its short name. */\nexport const packageManagers: Record<PackageManagerName, PackageManagerInfo> = {\n  pnpm: {\n    name: 'pnpm',\n    lockFiles: ['pnpm-lock.yaml'],\n    initCommand: ['init'],\n    installCommand: ['add', '-D'],\n    removeCommand: ['remove'],\n    runCommand: [],\n  },\n  yarn: {\n    name: 'yarn',\n    lockFiles: ['yarn.lock'],\n    initCommand: ['init', '-y'],\n    installCommand: ['add', '-D'],\n    removeCommand: ['remove'],\n    runCommand: [],\n  },\n  bun: {\n    name: 'bun',\n    lockFiles: ['bun.lock', 'bun.lockb'],\n    initCommand: ['init', '-y'],\n    installCommand: ['add', '-d'],\n    removeCommand: ['remove'],\n    runCommand: ['run'],\n  },\n  npm: {\n    name: 'npm',\n    lockFiles: ['package-lock.json'],\n    initCommand: ['init', '-y'],\n    installCommand: ['install', '--save-dev'],\n    removeCommand: ['uninstall'],\n    runCommand: ['run'],\n  },\n}\n\n/** Minimal shape of `package.json` fields read during detection. */\ntype PackageJson = {\n  /** The `packageManager` field from `package.json` (e.g. `\"pnpm@9.0.0\"`). */\n  packageManager?: string\n  scripts?: Record<string, string>\n}\n\n/** Detects the package manager for `cwd`: the `packageManager` field in `package.json`, then a lock file, then `npm`. */\nexport function detectPackageManager(cwd: string = process.cwd()): PackageManagerInfo {\n  const packageJsonPath = path.join(cwd, 'package.json')\n  if (fs.existsSync(packageJsonPath)) {\n    try {\n      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8')) as PackageJson\n      const pmField = packageJson.packageManager\n      if (typeof pmField === 'string') {\n        const name = pmField.split('@')[0]\n        if (name && name in packageManagers) {\n          return packageManagers[name as PackageManagerName]\n        }\n      }\n    } catch {\n      // Continue to lock file detection\n    }\n  }\n\n  for (const pm of Object.values(packageManagers)) {\n    if (pm.lockFiles.some((lockFile) => fs.existsSync(path.join(cwd, lockFile)))) {\n      return pm\n    }\n  }\n\n  return packageManagers.npm\n}\n\n/**\n * Initializes a new `package.json` at `cwd` using the detected package manager.\n */\nexport async function initPackageJson(cwd: string, packageManager: PackageManagerInfo): Promise<void> {\n  await x(packageManager.name, [...packageManager.initCommand], {\n    nodeOptions: { cwd, stdio: 'inherit' },\n    throwOnError: true,\n  })\n}\n\n/** How many trailing lines of a failed install's output the error keeps. */\nconst INSTALL_OUTPUT_LINES = 20\nconst INSTALL_TIMEOUT_MS = 5 * 60_000\n\n/**\n * Installs the given packages at `cwd` using the detected package manager. Each output line goes\n * to `onLine`, so the caller can show it while the install runs; a failed install also keeps the\n * end of the output in the error.\n */\nexport async function installPackages(\n  packages: Array<string>,\n  packageManager: PackageManagerInfo,\n  cwd: string = process.cwd(),\n  onLine?: (line: string) => void,\n  command: ReadonlyArray<string> = packageManager.installCommand,\n): Promise<void> {\n  const args = [...command, ...packages]\n  // No stdin, so a package manager that wants input fails instead of waiting. The timeout ends a stalled install.\n  const result = x(packageManager.name, args, {\n    nodeOptions: { cwd, stdio: ['ignore', 'pipe', 'pipe'] },\n    timeout: INSTALL_TIMEOUT_MS,\n    throwOnError: false,\n  })\n  const lines: Array<string> = []\n  for await (const line of result) {\n    lines.push(line)\n    onLine?.(line)\n  }\n  if (result.exitCode === 0) return\n  if (result.exitCode === undefined) throw new Error(`\\`${packageManager.name} ${args.join(' ')}\\` timed out after ${INSTALL_TIMEOUT_MS / 60_000} minutes`)\n\n  const output = lines.slice(-INSTALL_OUTPUT_LINES).join('\\n')\n  throw new Error(`\\`${packageManager.name} ${args.join(' ')}\\` failed with exit code ${result.exitCode}${output ? `:\\n${output}` : ''}`)\n}\n\n/**\n * Uninstalls the given packages at `cwd` with the package manager's remove command, like {@link installPackages}.\n */\nexport function uninstallPackages(packages: Array<string>, packageManager: PackageManagerInfo, cwd: string = process.cwd()): Promise<void> {\n  return installPackages(packages, packageManager, cwd, undefined, packageManager.removeCommand)\n}\n\n/**\n * What the selected plugins' `manifests` say is missing from the selection: a `dependencies`\n * entry, or a `client` plugin next to a `consumer`. Empty when nothing is missing.\n * `optionalDependencies` are skipped, since `kubb init` writes the default options.\n */\nexport function missingPluginDependencies(manifests: Array<ExtensionManifest>): Array<string> {\n  const selected = manifests.map((manifest) => manifest.name)\n  const hasClient = manifests.some((manifest) => manifest.role === 'client')\n  return manifests.flatMap((manifest) => [\n    ...(manifest.dependencies ?? []).filter((name) => !selected.includes(name)).map((name) => `${manifest.name} needs ${name}.`),\n    ...(manifest.role === 'consumer' && !hasClient ? [`${manifest.name} needs a client plugin, such as plugin-axios or plugin-fetch.`] : []),\n  ])\n}\n\nasync function readPackageJson(cwd: string): Promise<PackageJson> {\n  try {\n    return JSON.parse(await read(path.join(cwd, 'package.json'))) as PackageJson\n  } catch {\n    return {}\n  }\n}\n\nconst SPEC_FILE = /^(openapi|swagger)[\\w.-]*\\.(ya?ml|json)$/i\nconst SKIPPED_DIRS = new Set(['node_modules', 'dist', 'build', 'coverage'])\n\n/**\n * Finds OpenAPI spec files up to `depth` folders below `cwd`, shallowest first, as `./`-relative\n * paths. Walks one level at a time and stops after `limit` files, so a large repo stays fast.\n */\nexport async function findSpecFiles(cwd: string, { depth = 3, limit = 20 }: { depth?: number; limit?: number } = {}): Promise<Array<string>> {\n  const found: Array<string> = []\n  let level: Array<string> = ['']\n  for (let current = 0; current <= depth && level.length && found.length < limit; current++) {\n    const listings = await Promise.all(\n      level.map(async (dir) => ({ dir, entries: await fs.promises.readdir(path.join(cwd, dir), { withFileTypes: true }).catch(() => []) })),\n    )\n    level = []\n    for (const { dir, entries } of listings) {\n      for (const entry of entries.toSorted((a, b) => a.name.localeCompare(b.name))) {\n        if (entry.isFile() && SPEC_FILE.test(entry.name)) found.push(`./${path.posix.join(dir, entry.name)}`)\n        if (entry.isDirectory() && !entry.name.startsWith('.') && !SKIPPED_DIRS.has(entry.name)) level.push(path.posix.join(dir, entry.name))\n      }\n    }\n  }\n  return found.slice(0, limit)\n}\n\n/** The spec version and operation count, when the file states them. */\nexport type SpecInfo = { version?: string; operations?: number }\n\nconst SPEC_HEAD_BYTES = 256 * 1024\nconst METHOD = '(?:get|put|post|delete|options|head|patch|trace)'\n\n/**\n * Reads the OpenAPI or Swagger version and counts the operations from the first 256 KB of the\n * file, so a large spec is never parsed. The count is left out when the file is longer.\n */\nexport async function readSpecInfo(file: string): Promise<SpecInfo> {\n  const handle = await fs.promises.open(file)\n  try {\n    const buffer = Buffer.alloc(SPEC_HEAD_BYTES)\n    const { bytesRead } = await handle.read(buffer, 0, SPEC_HEAD_BYTES, 0)\n    const head = buffer.toString('utf-8', 0, bytesRead)\n    const complete = bytesRead < SPEC_HEAD_BYTES\n    const version = head.match(/^\\s*[\"']?(?:openapi|swagger)[\"']?\\s*:\\s*[\"']?(\\d[\\d.]*)/m)?.[1]\n    // shortcut: counts method keys at any depth, so a schema property named `get` counts too; use the adapter when that matters.\n    const methods = new RegExp(`^\\\\s*[\"']?${METHOD}[\"']?\\\\s*:\\\\s*(?:\\\\{|$)`, 'gm')\n    return { version, operations: complete ? (head.match(methods)?.length ?? 0) : undefined }\n  } finally {\n    await handle.close()\n  }\n}\n\n/** Finds a plugin by registry id, slug, or short name, so `ts`, `plugin-ts`, and `kubb-labs/plugin-ts` all match. */\nexport function findPlugin({ plugins, id }: { plugins: Array<RegistryEntry>; id: string }): RegistryEntry | undefined {\n  const ids = id.includes('/') ? [id] : [`kubb-labs/${id}`, `kubb-labs/plugin-${id}`]\n  return plugins.find((entry) => ids.includes(entry.id))\n}\n\n/**\n * Turns the comma-separated `--plugins` value into registry entries.\n *\n * @throws when an id is not in `plugins`.\n */\nexport function parsePluginsFlag({ plugins, value }: { plugins: Array<RegistryEntry>; value: string }): Array<RegistryEntry> {\n  const ids = value\n    .split(',')\n    .map((id) => id.trim())\n    .filter(Boolean)\n  const unknown = ids.filter((id) => !findPlugin({ plugins, id }))\n  if (unknown.length)\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.pluginNotFound,\n      severity: 'error',\n      message: `Not in the Kubb registry: ${unknown.join(', ')}. Browse the plugins at https://kubb.dev/extensions.`,\n      help: 'Use plugin ids from https://kubb.dev/extensions, such as plugin-ts or ts.',\n    })\n  return ids.map((id) => findPlugin({ plugins, id })!)\n}\n\n/** Adds `\"generate\": \"kubb generate\"` to the `package.json` scripts at `cwd`. Returns `false`, and changes nothing, when a `generate` script exists. */\nexport async function addGenerateScript(cwd: string): Promise<boolean> {\n  const file = path.join(cwd, 'package.json')\n  const source = await read(file)\n  const packageJson = JSON.parse(source) as PackageJson\n  if (packageJson.scripts?.generate !== undefined) return false\n  const indent = source.match(/^[ \\t]+/m)?.[0] ?? '  '\n  const updated = { ...packageJson, scripts: { ...packageJson.scripts, generate: 'kubb generate' } }\n  await write(file, JSON.stringify(updated, null, indent))\n  return true\n}\n\n/** Reads the `generate` script from the `package.json` at `cwd`. */\nexport async function generateScript(cwd: string): Promise<string | undefined> {\n  return (await readPackageJson(cwd)).scripts?.generate\n}\n"],"mappings":"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"}