@kubb/cli 5.10.1 → 5.10.3

package/dist/background-DVZB1n4j.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-DVZB1n4j.cjs","names":["path","getProjectKubbHome","readFile","connectSocket","Diagnostics","delay","prepareConnection","createRequire","x"],"sources":["../src/runners/studio/background.ts"],"sourcesContent":["import { hash, randomBytes } from 'node:crypto'\nimport { readFile, rename, writeFile } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { connect as connectSocket, createServer } from 'node:net'\nimport path from 'node:path'\nimport { setTimeout as delay } from 'node:timers/promises'\nimport { Diagnostics } from '@kubb/core'\nimport { x } from 'tinyexec'\nimport { getProjectKubbHome } from './credentials.ts'\nimport { prepareConnection, type PreparedConnection, type StudioOptions, type WorkerState } from './run.ts'\n\nexport type WorkerRecord = { id: string; pid: number; port: number; state: WorkerState }\nconst states: Array<WorkerState> = ['starting', 'connected', 'reconnecting', 'authentication required', 'stopped']\nexport const getWorkerLogPath = () => path.join(getProjectKubbHome(), 'worker.log')\nconst statePath = () => path.join(getProjectKubbHome(), 'worker.json')\n\nasync function readWorker(): Promise<WorkerRecord | null> {\n  try {\n    const value: unknown = JSON.parse(await readFile(statePath(), 'utf8'))\n    if (!value || typeof value !== 'object') return null\n    const record = value as Partial<WorkerRecord>\n    return typeof record.id === 'string' &&\n      /^[a-f0-9]{32}$/.test(record.id) &&\n      Number.isInteger(record.pid) &&\n      (record.pid ?? 0) > 1 &&\n      Number.isInteger(record.port) &&\n      (record.port ?? 0) > 0 &&\n      (record.port ?? 0) <= 65535 &&\n      states.includes(record.state as WorkerState)\n      ? (record as WorkerRecord)\n      : null\n  } catch {\n    return null\n  }\n}\n\nfunction isAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0)\n    return true\n  } catch (error) {\n    return (error as NodeJS.ErrnoException).code === 'EPERM'\n  }\n}\n\n/** Authenticated loopback IPC; a stored PID never authorizes sending a process signal. */\nfunction requestWorker(record: WorkerRecord, command: 'status' | 'stop'): Promise<WorkerRecord> {\n  return new Promise((resolve, reject) => {\n    const socket = connectSocket({ host: '127.0.0.1', port: record.port })\n    let received = ''\n    socket.setTimeout(2_000, () => socket.destroy(new Error('Worker control timed out')))\n    socket.once('error', reject)\n    socket.once('connect', () => socket.write(JSON.stringify({ id: record.id, command }) + '\\n'))\n    socket.on('data', (chunk: Buffer) => {\n      received += chunk.toString()\n      if (received.length > 4096) socket.destroy(new Error('Invalid worker response'))\n    })\n    socket.once('end', () => {\n      try {\n        const response = JSON.parse(received) as WorkerRecord\n        if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state))\n          throw new Diagnostics.Error({ code: Diagnostics.code.internalError, severity: 'error', message: 'Worker identity changed' })\n        resolve(response)\n      } catch (error) {\n        reject(error)\n      }\n    })\n  })\n}\n\nexport async function getWorkerStatus(): Promise<{ running: boolean; state: WorkerState; pid?: number }> {\n  const record = await readWorker()\n  if (!record) return { running: false, state: 'stopped' }\n  try {\n    const response = await requestWorker(record, 'status')\n    return { running: true, state: response.state, pid: response.pid }\n  } catch {\n    return { running: false, state: record.state === 'authentication required' ? record.state : 'stopped' }\n  }\n}\n\nexport async function stopWorker(): Promise<void> {\n  const record = await readWorker()\n  if (!record) return\n  try {\n    await requestWorker(record, 'stop')\n  } catch (error) {\n    if (\n      (error as NodeJS.ErrnoException).code !== 'ECONNREFUSED' &&\n      isAlive(record.pid) &&\n      record.state !== 'stopped' &&\n      record.state !== 'authentication required'\n    ) {\n      throw new Diagnostics.Error({\n        code: Diagnostics.code.unknown,\n        severity: 'error',\n        message: 'Cannot verify the background worker. No process was signaled.',\n        help: 'Check `worker.log`, then stop the process by hand if it is still running.',\n      })\n    }\n    return\n  }\n  const deadline = Date.now() + 15_000\n  while (Date.now() < deadline) {\n    try {\n      await requestWorker(record, 'status')\n    } catch {\n      return\n    }\n    await delay(100)\n  }\n  throw new Diagnostics.Error({\n    code: Diagnostics.code.unknown,\n    severity: 'error',\n    message: 'The worker has not finished shutting down. Check worker.log and try again.',\n  })\n}\n\n/** The listening port is the project lock, so stale state never needs a PID-based takeover. */\nexport async function serveWorker(shutdown: AbortController) {\n  const record: WorkerRecord = { id: randomBytes(16).toString('hex'), pid: process.pid, port: 0, state: 'starting' }\n  const server = createServer((socket) => {\n    let input = ''\n    socket.setTimeout(2_000, () => socket.destroy())\n    socket.on('error', () => {})\n    socket.on('data', (chunk: Buffer) => {\n      input += chunk.toString()\n      if (input.length > 4096) {\n        socket.destroy()\n        return\n      }\n      if (!input.includes('\\n')) return\n      try {\n        const request = JSON.parse(input) as { id?: unknown; command?: unknown }\n        if (request.id !== record.id || !['status', 'stop'].includes(String(request.command))) {\n          socket.destroy()\n          return\n        }\n        socket.end(JSON.stringify(record))\n        if (request.command === 'stop') shutdown.abort()\n      } catch {\n        socket.destroy()\n      }\n    })\n  })\n  // Hash the project directory to choose its loopback port; fail on collisions.\n  const port = 20_000 + (Number.parseInt(hash('sha256', getProjectKubbHome()).slice(0, 8), 16) % 30_000)\n  try {\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject)\n      server.listen(port, '127.0.0.1', resolve)\n    })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'EADDRINUSE') throw error\n    // Let a simultaneous starter finish writing its record before checking ownership.\n    await delay(100)\n    const existing = await readWorker()\n    if (existing?.port === port) {\n      try {\n        return { existing: await requestWorker(existing, 'status') }\n      } catch {\n        /* Refuse an unverified listener. */\n      }\n    }\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'The project control port is occupied or another worker is starting. Try again after stopping that listener.',\n    })\n  }\n  record.port = port\n  let saving = Promise.resolve()\n  const save = () => {\n    const value = JSON.stringify(record)\n    saving = saving.then(async () => {\n      const temporary = `${statePath()}.${record.id}`\n      await writeFile(temporary, value, { mode: 0o600 })\n      await rename(temporary, statePath())\n    })\n    return saving\n  }\n  try {\n    await save()\n  } catch (error) {\n    server.close()\n    throw error\n  }\n  return {\n    async state(state: WorkerState) {\n      record.state = state\n      await save()\n    },\n    async close() {\n      try {\n        if (record.state !== 'authentication required') {\n          record.state = 'stopped'\n          await save()\n        }\n      } finally {\n        await new Promise<void>((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())))\n      }\n    },\n  }\n}\n\nexport type WorkerLaunch = { options: StudioOptions; prepared: PreparedConnection }\n\nexport async function startWorker(options: StudioOptions): Promise<void> {\n  const current = await getWorkerStatus()\n  if (current.running) {\n    console.log(`Already running (${current.state}, PID ${current.pid}).`)\n    return\n  }\n  const prepared = await prepareConnection(options)\n  const entry = path.join(path.dirname(createRequire(import.meta.url).resolve('@kubb/cli/package.json')), 'dist', 'studioWorker.js')\n  const child = x(process.execPath, [...process.execArgv, entry], {\n    nodeOptions: { cwd: process.cwd(), detached: true, stdio: ['ignore', 'ignore', 'ignore', 'ipc'] },\n  }).process\n  if (!child)\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'Background worker failed to start',\n      help: 'Run `kubb studio` in the foreground to see why it fails.',\n    })\n  try {\n    const started = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => done(new Error('Background worker startup timed out')), 20_000)\n      const done = (error?: Error) => {\n        clearTimeout(timer)\n        child.removeListener('error', failed)\n        child.removeListener('exit', exited)\n        child.removeListener('message', ready)\n        if (error) reject(error)\n        else resolve()\n      }\n      const failed = (error: Error) => done(error)\n      const exited = () => done(new Error(`Background worker exited during startup. Check ${getWorkerLogPath()}`))\n      child.once('error', failed)\n      child.once('exit', exited)\n      const ready = (message: unknown) => {\n        if (!message || typeof message !== 'object' || !('started' in message) || message.started !== true)\n          return done(new Error('Invalid worker startup response'))\n        done()\n      }\n      child.once('message', ready)\n      child.send({ options: { ...options, autoOpen: false }, prepared } satisfies WorkerLaunch, (error) => {\n        if (error) done(error)\n      })\n    })\n    await started\n    if (child.connected) child.disconnect()\n    child.unref()\n    const status = await getWorkerStatus()\n    console.log(`Background worker ${status.state} (PID ${status.pid ?? child.pid}). Logs: ${getWorkerLogPath()}`)\n  } catch (error) {\n    // This is the child we just spawned, not a PID recovered from disk.\n    child.kill('SIGTERM')\n    throw error\n  }\n}\n"],"mappings":"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"}

package/dist/background-WaKtfQWr.cjs

@@ -0,0 +1,192 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+const require_credentials = require("./credentials-xOkTTDWj.cjs");
+const require_run = require("./run-CSOEGpWZ.cjs");
+require("node:crypto");
+let tinyexec = require("tinyexec");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let _kubb_core = require("@kubb/core");
+let node_module = require("node:module");
+let node_net = require("node:net");
+let node_timers_promises = require("node:timers/promises");
+//#region src/runners/studio/background.ts
+const states = [
+	"starting",
+	"connected",
+	"reconnecting",
+	"authentication required",
+	"stopped"
+];
+const getWorkerLogPath = () => node_path.default.join(require_credentials.getProjectKubbHome(), "worker.log");
+const statePath = () => node_path.default.join(require_credentials.getProjectKubbHome(), "worker.json");
+async function readWorker() {
+	try {
+		const value = JSON.parse(await (0, node_fs_promises.readFile)(statePath(), "utf8"));
+		if (!value || typeof value !== "object") return null;
+		const record = value;
+		return typeof record.id === "string" && /^[a-f0-9]{32}$/.test(record.id) && Number.isInteger(record.pid) && (record.pid ?? 0) > 1 && Number.isInteger(record.port) && (record.port ?? 0) > 0 && (record.port ?? 0) <= 65535 && states.includes(record.state) ? record : null;
+	} catch {
+		return null;
+	}
+}
+function isAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (error) {
+		return error.code === "EPERM";
+	}
+}
+/** Authenticated loopback IPC; a stored PID never authorizes sending a process signal. */
+function requestWorker(record, command) {
+	return new Promise((resolve, reject) => {
+		const socket = (0, node_net.connect)({
+			host: "127.0.0.1",
+			port: record.port
+		});
+		let received = "";
+		socket.setTimeout(2e3, () => socket.destroy(/* @__PURE__ */ new Error("Worker control timed out")));
+		socket.once("error", reject);
+		socket.once("connect", () => socket.write(JSON.stringify({
+			id: record.id,
+			command
+		}) + "\n"));
+		socket.on("data", (chunk) => {
+			received += chunk.toString();
+			if (received.length > 4096) socket.destroy(/* @__PURE__ */ new Error("Invalid worker response"));
+		});
+		socket.once("end", () => {
+			try {
+				const response = JSON.parse(received);
+				if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state)) throw new _kubb_core.Diagnostics.Error({
+					code: _kubb_core.Diagnostics.code.internalError,
+					severity: "error",
+					message: "Worker identity changed"
+				});
+				resolve(response);
+			} catch (error) {
+				reject(error);
+			}
+		});
+	});
+}
+async function getWorkerStatus() {
+	const record = await readWorker();
+	if (!record) return {
+		running: false,
+		state: "stopped"
+	};
+	try {
+		const response = await requestWorker(record, "status");
+		return {
+			running: true,
+			state: response.state,
+			pid: response.pid
+		};
+	} catch {
+		return {
+			running: false,
+			state: record.state === "authentication required" ? record.state : "stopped"
+		};
+	}
+}
+async function stopWorker() {
+	const record = await readWorker();
+	if (!record) return;
+	try {
+		await requestWorker(record, "stop");
+	} catch (error) {
+		if (error.code !== "ECONNREFUSED" && isAlive(record.pid) && record.state !== "stopped" && record.state !== "authentication required") throw new _kubb_core.Diagnostics.Error({
+			code: _kubb_core.Diagnostics.code.unknown,
+			severity: "error",
+			message: "Cannot verify the background worker. No process was signaled.",
+			help: "Check `worker.log`, then stop the process by hand if it is still running."
+		});
+		return;
+	}
+	const deadline = Date.now() + 15e3;
+	while (Date.now() < deadline) {
+		try {
+			await requestWorker(record, "status");
+		} catch {
+			return;
+		}
+		await (0, node_timers_promises.setTimeout)(100);
+	}
+	throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: "The worker has not finished shutting down. Check worker.log and try again."
+	});
+}
+async function startWorker(options) {
+	const current = await getWorkerStatus();
+	if (current.running) {
+		console.log(`Already running (${current.state}, PID ${current.pid}).`);
+		return;
+	}
+	const prepared = await require_run.prepareConnection(options);
+	const entry = node_path.default.join(node_path.default.dirname((0, node_module.createRequire)(require("url").pathToFileURL(__filename).href).resolve("@kubb/cli/package.json")), "dist", "studioWorker.js");
+	const child = (0, tinyexec.x)(process.execPath, [...process.execArgv, entry], { nodeOptions: {
+		cwd: process.cwd(),
+		detached: true,
+		stdio: [
+			"ignore",
+			"ignore",
+			"ignore",
+			"ipc"
+		]
+	} }).process;
+	if (!child) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: "Background worker failed to start",
+		help: "Run `kubb studio` in the foreground to see why it fails."
+	});
+	try {
+		await new Promise((resolve, reject) => {
+			const timer = setTimeout(() => done(/* @__PURE__ */ new Error("Background worker startup timed out")), 2e4);
+			const done = (error) => {
+				clearTimeout(timer);
+				child.removeListener("error", failed);
+				child.removeListener("exit", exited);
+				child.removeListener("message", ready);
+				if (error) reject(error);
+				else resolve();
+			};
+			const failed = (error) => done(error);
+			const exited = () => done(/* @__PURE__ */ new Error(`Background worker exited during startup. Check ${getWorkerLogPath()}`));
+			child.once("error", failed);
+			child.once("exit", exited);
+			const ready = (message) => {
+				if (!message || typeof message !== "object" || !("started" in message) || message.started !== true) return done(/* @__PURE__ */ new Error("Invalid worker startup response"));
+				done();
+			};
+			child.once("message", ready);
+			child.send({
+				options: {
+					...options,
+					autoOpen: false
+				},
+				prepared
+			}, (error) => {
+				if (error) done(error);
+			});
+		});
+		if (child.connected) child.disconnect();
+		child.unref();
+		const status = await getWorkerStatus();
+		console.log(`Background worker ${status.state} (PID ${status.pid ?? child.pid}). Logs: ${getWorkerLogPath()}`);
+	} catch (error) {
+		child.kill("SIGTERM");
+		throw error;
+	}
+}
+//#endregion
+exports.getWorkerLogPath = getWorkerLogPath;
+exports.getWorkerStatus = getWorkerStatus;
+exports.startWorker = startWorker;
+exports.stopWorker = stopWorker;
+
+//# sourceMappingURL=background-WaKtfQWr.cjs.map

package/dist/background-WaKtfQWr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-WaKtfQWr.cjs","names":["path","getProjectKubbHome","readFile","connectSocket","Diagnostics","delay","prepareConnection","createRequire","x"],"sources":["../src/runners/studio/background.ts"],"sourcesContent":["import { hash, randomBytes } from 'node:crypto'\nimport { readFile, rename, writeFile } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { connect as connectSocket, createServer } from 'node:net'\nimport path from 'node:path'\nimport { setTimeout as delay } from 'node:timers/promises'\nimport { Diagnostics } from '@kubb/core'\nimport { x } from 'tinyexec'\nimport { getProjectKubbHome } from './credentials.ts'\nimport { prepareConnection, type PreparedConnection, type StudioOptions, type WorkerState } from './run.ts'\n\nexport type WorkerRecord = { id: string; pid: number; port: number; state: WorkerState }\nconst states: Array<WorkerState> = ['starting', 'connected', 'reconnecting', 'authentication required', 'stopped']\nexport const getWorkerLogPath = () => path.join(getProjectKubbHome(), 'worker.log')\nconst statePath = () => path.join(getProjectKubbHome(), 'worker.json')\n\nasync function readWorker(): Promise<WorkerRecord | null> {\n  try {\n    const value: unknown = JSON.parse(await readFile(statePath(), 'utf8'))\n    if (!value || typeof value !== 'object') return null\n    const record = value as Partial<WorkerRecord>\n    return typeof record.id === 'string' &&\n      /^[a-f0-9]{32}$/.test(record.id) &&\n      Number.isInteger(record.pid) &&\n      (record.pid ?? 0) > 1 &&\n      Number.isInteger(record.port) &&\n      (record.port ?? 0) > 0 &&\n      (record.port ?? 0) <= 65535 &&\n      states.includes(record.state as WorkerState)\n      ? (record as WorkerRecord)\n      : null\n  } catch {\n    return null\n  }\n}\n\nfunction isAlive(pid: number): boolean {\n  try {\n    process.kill(pid, 0)\n    return true\n  } catch (error) {\n    return (error as NodeJS.ErrnoException).code === 'EPERM'\n  }\n}\n\n/** Authenticated loopback IPC; a stored PID never authorizes sending a process signal. */\nfunction requestWorker(record: WorkerRecord, command: 'status' | 'stop'): Promise<WorkerRecord> {\n  return new Promise((resolve, reject) => {\n    const socket = connectSocket({ host: '127.0.0.1', port: record.port })\n    let received = ''\n    socket.setTimeout(2_000, () => socket.destroy(new Error('Worker control timed out')))\n    socket.once('error', reject)\n    socket.once('connect', () => socket.write(JSON.stringify({ id: record.id, command }) + '\\n'))\n    socket.on('data', (chunk: Buffer) => {\n      received += chunk.toString()\n      if (received.length > 4096) socket.destroy(new Error('Invalid worker response'))\n    })\n    socket.once('end', () => {\n      try {\n        const response = JSON.parse(received) as WorkerRecord\n        if (response.id !== record.id || response.pid !== record.pid || !states.includes(response.state))\n          throw new Diagnostics.Error({ code: Diagnostics.code.internalError, severity: 'error', message: 'Worker identity changed' })\n        resolve(response)\n      } catch (error) {\n        reject(error)\n      }\n    })\n  })\n}\n\nexport async function getWorkerStatus(): Promise<{ running: boolean; state: WorkerState; pid?: number }> {\n  const record = await readWorker()\n  if (!record) return { running: false, state: 'stopped' }\n  try {\n    const response = await requestWorker(record, 'status')\n    return { running: true, state: response.state, pid: response.pid }\n  } catch {\n    return { running: false, state: record.state === 'authentication required' ? record.state : 'stopped' }\n  }\n}\n\nexport async function stopWorker(): Promise<void> {\n  const record = await readWorker()\n  if (!record) return\n  try {\n    await requestWorker(record, 'stop')\n  } catch (error) {\n    if (\n      (error as NodeJS.ErrnoException).code !== 'ECONNREFUSED' &&\n      isAlive(record.pid) &&\n      record.state !== 'stopped' &&\n      record.state !== 'authentication required'\n    ) {\n      throw new Diagnostics.Error({\n        code: Diagnostics.code.unknown,\n        severity: 'error',\n        message: 'Cannot verify the background worker. No process was signaled.',\n        help: 'Check `worker.log`, then stop the process by hand if it is still running.',\n      })\n    }\n    return\n  }\n  const deadline = Date.now() + 15_000\n  while (Date.now() < deadline) {\n    try {\n      await requestWorker(record, 'status')\n    } catch {\n      return\n    }\n    await delay(100)\n  }\n  throw new Diagnostics.Error({\n    code: Diagnostics.code.unknown,\n    severity: 'error',\n    message: 'The worker has not finished shutting down. Check worker.log and try again.',\n  })\n}\n\n/** The listening port is the project lock, so stale state never needs a PID-based takeover. */\nexport async function serveWorker(shutdown: AbortController) {\n  const record: WorkerRecord = { id: randomBytes(16).toString('hex'), pid: process.pid, port: 0, state: 'starting' }\n  const server = createServer((socket) => {\n    let input = ''\n    socket.setTimeout(2_000, () => socket.destroy())\n    socket.on('error', () => {})\n    socket.on('data', (chunk: Buffer) => {\n      input += chunk.toString()\n      if (input.length > 4096) {\n        socket.destroy()\n        return\n      }\n      if (!input.includes('\\n')) return\n      try {\n        const request = JSON.parse(input) as { id?: unknown; command?: unknown }\n        if (request.id !== record.id || !['status', 'stop'].includes(String(request.command))) {\n          socket.destroy()\n          return\n        }\n        socket.end(JSON.stringify(record))\n        if (request.command === 'stop') shutdown.abort()\n      } catch {\n        socket.destroy()\n      }\n    })\n  })\n  // Hash the project directory to choose its loopback port; fail on collisions.\n  const port = 20_000 + (Number.parseInt(hash('sha256', getProjectKubbHome()).slice(0, 8), 16) % 30_000)\n  try {\n    await new Promise<void>((resolve, reject) => {\n      server.once('error', reject)\n      server.listen(port, '127.0.0.1', resolve)\n    })\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code !== 'EADDRINUSE') throw error\n    // Let a simultaneous starter finish writing its record before checking ownership.\n    await delay(100)\n    const existing = await readWorker()\n    if (existing?.port === port) {\n      try {\n        return { existing: await requestWorker(existing, 'status') }\n      } catch {\n        /* Refuse an unverified listener. */\n      }\n    }\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'The project control port is occupied or another worker is starting. Try again after stopping that listener.',\n    })\n  }\n  record.port = port\n  let saving = Promise.resolve()\n  const save = () => {\n    const value = JSON.stringify(record)\n    saving = saving.then(async () => {\n      const temporary = `${statePath()}.${record.id}`\n      await writeFile(temporary, value, { mode: 0o600 })\n      await rename(temporary, statePath())\n    })\n    return saving\n  }\n  try {\n    await save()\n  } catch (error) {\n    server.close()\n    throw error\n  }\n  return {\n    async state(state: WorkerState) {\n      record.state = state\n      await save()\n    },\n    async close() {\n      try {\n        if (record.state !== 'authentication required') {\n          record.state = 'stopped'\n          await save()\n        }\n      } finally {\n        await new Promise<void>((resolve, reject) => server.close((error) => (error ? reject(error) : resolve())))\n      }\n    },\n  }\n}\n\nexport type WorkerLaunch = { options: StudioOptions; prepared: PreparedConnection }\n\nexport async function startWorker(options: StudioOptions): Promise<void> {\n  const current = await getWorkerStatus()\n  if (current.running) {\n    console.log(`Already running (${current.state}, PID ${current.pid}).`)\n    return\n  }\n  const prepared = await prepareConnection(options)\n  const entry = path.join(path.dirname(createRequire(import.meta.url).resolve('@kubb/cli/package.json')), 'dist', 'studioWorker.js')\n  const child = x(process.execPath, [...process.execArgv, entry], {\n    nodeOptions: { cwd: process.cwd(), detached: true, stdio: ['ignore', 'ignore', 'ignore', 'ipc'] },\n  }).process\n  if (!child)\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: 'Background worker failed to start',\n      help: 'Run `kubb studio` in the foreground to see why it fails.',\n    })\n  try {\n    const started = new Promise<void>((resolve, reject) => {\n      const timer = setTimeout(() => done(new Error('Background worker startup timed out')), 20_000)\n      const done = (error?: Error) => {\n        clearTimeout(timer)\n        child.removeListener('error', failed)\n        child.removeListener('exit', exited)\n        child.removeListener('message', ready)\n        if (error) reject(error)\n        else resolve()\n      }\n      const failed = (error: Error) => done(error)\n      const exited = () => done(new Error(`Background worker exited during startup. Check ${getWorkerLogPath()}`))\n      child.once('error', failed)\n      child.once('exit', exited)\n      const ready = (message: unknown) => {\n        if (!message || typeof message !== 'object' || !('started' in message) || message.started !== true)\n          return done(new Error('Invalid worker startup response'))\n        done()\n      }\n      child.once('message', ready)\n      child.send({ options: { ...options, autoOpen: false }, prepared } satisfies WorkerLaunch, (error) => {\n        if (error) done(error)\n      })\n    })\n    await started\n    if (child.connected) child.disconnect()\n    child.unref()\n    const status = await getWorkerStatus()\n    console.log(`Background worker ${status.state} (PID ${status.pid ?? child.pid}). Logs: ${getWorkerLogPath()}`)\n  } catch (error) {\n    // This is the child we just spawned, not a PID recovered from disk.\n    child.kill('SIGTERM')\n    throw error\n  }\n}\n"],"mappings":"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"}

package/dist/{background-C8doa9-4.js → background-_A5NwvYH.js}

@@ -1 +1 @@
-export { t as getWorkerLogPath, n as getWorkerStatus, i as startWorker, a as stopWorker } from "./background-D5K6ecEo.js";
+export { t as getWorkerLogPath, n as getWorkerStatus, i as startWorker, a as stopWorker } from "./background-DFME5huR.js";

package/dist/{config-CcqzzfB7.cjs → config-DKAqX5sW.cjs}

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require("./rolldown-runtime-CPE0t6oh.cjs");
-const require_output = require("./output-DLrxGtuN.cjs");
+const require_Telemetry = require("./Telemetry-BV4GonCV.cjs");
+const require_output = require("./output-nieBFDgM.cjs");
 let node_process = require("node:process");
 node_process = require_rolldown_runtime.__toESM(node_process, 1);
 let node_path = require("node:path");
@@ -56,7 +57,13 @@ function selectReporters(reporters, names) {
 /** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */
 async function getConfigs({ configPath, input, watch, logLevel }) {
 	const file = configPath ? (0, node_path.resolve)(configPath) : require_output.findConfigFile();
-	if (!file) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
+	if (!file) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${require_output.CONFIG_EXTENSIONS.join(", ")}) in ${node_process.default.cwd()}, its .config/ and configs/ folders, and each parent folder.`,
+		help: "Run `kubb init` to create one, or pass a path with `--config`.",
+		location: { kind: "config" }
+	});
 	let configs;
 	try {
 		configs = await require_output.loadConfigFile(file, {
@@ -66,7 +73,14 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 			logLevel
 		});
 	} catch (error) {
-		throw new Error("Config failed loading", { cause: error });
+		throw new _kubb_core.Diagnostics.Error({
+			code: _kubb_core.Diagnostics.code.unknown,
+			severity: "error",
+			message: `Config failed loading: ${file}`,
+			help: "Fix the error the config file throws, shown under `caused by:`.",
+			location: { kind: "config" },
+			cause: require_Telemetry.toError(error)
+		});
 	}
 	return {
 		configPath: file,
@@ -96,4 +110,4 @@ Object.defineProperty(exports, "setupReporters", {
 	}
 });
 
-//# sourceMappingURL=config-CcqzzfB7.cjs.map
+//# sourceMappingURL=config-DKAqX5sW.cjs.map

package/dist/config-DKAqX5sW.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DKAqX5sW.cjs","names":["process","isRichOutput","clackLogger","plainLogger","createCliReporter","resolve","findConfigFile","Diagnostics","CONFIG_EXTENSIONS","process","loadConfigFile","toError"],"sources":["../src/loggers/reporters.ts","../src/config.ts"],"sourcesContent":["import process from 'node:process'\nimport type { Config, Hookable, KubbHooks, Reporter, ReporterContext, ReporterPluginFiles } from '@kubb/core'\nimport { createCliReporter } from '@kubb/core'\nimport { isRichOutput } from '../utils/env.ts'\nimport type { Logger, LoggerOptions } from './defineLogger.ts'\nimport { clackLogger } from './clackLogger.ts'\nimport { plainLogger } from './plainLogger.ts'\n\n/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */\nfunction installReporter(context: Hookable<KubbHooks>, reporter: Reporter, ctx: ReporterContext): void {\n  const pluginFiles = reporter.needsPluginFiles ? new Map<Config, Map<string, Set<string>>>() : undefined\n\n  if (pluginFiles) {\n    context.hook('kubb:plugin:end', ({ config, plugin, files }) => {\n      const filesByPlugin = pluginFiles.get(config) ?? new Map<string, Set<string>>()\n      const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]))\n      const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path)\n\n      if (added.length) filesByPlugin.set(plugin.name, new Set([...(filesByPlugin.get(plugin.name) ?? []), ...added]))\n\n      pluginFiles.set(config, filesByPlugin)\n    })\n  }\n\n  context.hook('kubb:generation:end', async ({ config, diagnostics = [], filesCreated = 0, status = 'success', hrStart = process.hrtime() }) => {\n    const files = pluginFiles?.get(config)\n    const grouped: ReporterPluginFiles | undefined = files && [...files].map(([plugin, paths]) => ({ plugin, files: [...paths] }))\n\n    await reporter.report({ config, diagnostics, filesCreated, status, hrStart, pluginFiles: grouped }, ctx)\n\n    pluginFiles?.delete(config)\n  })\n\n  if (reporter.drain) {\n    context.hook('kubb:lifecycle:end', () => reporter.drain?.(ctx))\n  }\n}\n\n/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */\nfunction setupReporters(\n  context: Hookable<KubbHooks>,\n  {\n    logLevel,\n    reporters,\n    logger: forcedLogger,\n  }: LoggerOptions & {\n    reporters: ReadonlyArray<Reporter>\n    /** Overrides the terminal-based pick, e.g. the plain logger for `kubb studio snapshot`. */\n    logger?: Logger\n  },\n): void {\n  const hasJson = reporters.some((reporter) => reporter.name === 'json')\n  const ctx: ReporterContext = { logLevel }\n\n  for (const reporter of reporters) {\n    if (reporter.name !== 'cli') {\n      installReporter(context, reporter, ctx)\n      continue\n    }\n\n    if (hasJson) {\n      continue\n    }\n\n    const logger = forcedLogger ?? (isRichOutput() ? clackLogger : plainLogger)\n    const handle = logger(context, { logLevel })\n\n    // The summary belongs inside the group the logger opened for this config, so the logger writes it.\n    installReporter(context, createCliReporter({ render: handle?.renderSummary }), ctx)\n  }\n}\n\nexport default setupReporters\n\n/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */\nexport function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {\n  return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? [])\n}\n","import { resolve } from 'node:path'\nimport process from 'node:process'\nimport { CONFIG_EXTENSIONS, findConfigFile, loadConfigFile } from '@internals/shared'\nimport { type CLIOptions, type Config, Diagnostics } from '@kubb/core'\nimport { toError } from '@internals/utils'\n\ntype GetConfigsOptions = {\n  /** Explicit path to the Kubb config file. When omitted, the loader searches up from `process.cwd()`. */\n  configPath?: string\n  /** OpenAPI input path or URL that overrides `config.input` for this run. */\n  input?: string\n  /** Watch flag forwarded to the user's `defineConfig` function. */\n  watch?: boolean\n  /** Log level forwarded to the user's `defineConfig` function. */\n  logLevel?: CLIOptions['logLevel']\n}\n\ntype GetConfigsResult = {\n  /** Absolute path to the resolved config file. */\n  configPath: string\n  /** Resolved and normalized Kubb configs, each guaranteed to have a `plugins` array. */\n  configs: Array<Config>\n}\n\n/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */\nexport async function getConfigs({ configPath, input, watch, logLevel }: GetConfigsOptions): Promise<GetConfigsResult> {\n  const file = configPath ? resolve(configPath) : findConfigFile()\n  if (!file) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(', ')}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,\n      help: 'Run `kubb init` to create one, or pass a path with `--config`.',\n      location: { kind: 'config' },\n    })\n  }\n\n  let configs: Array<Config>\n  try {\n    configs = await loadConfigFile<Config>(file, { config: configPath, input, watch, logLevel } satisfies CLIOptions)\n  } catch (error) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `Config failed loading: ${file}`,\n      help: 'Fix the error the config file throws, shown under `caused by:`.',\n      location: { kind: 'config' },\n      cause: toError(error),\n    })\n  }\n\n  return { configPath: file, configs: configs.map((item) => ({ ...item, plugins: item.plugins ?? [] })) }\n}\n"],"mappings":"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"}

package/dist/{config-IMZ26zcb.js → config-DV_7s1m-.js}

@@ -1,8 +1,9 @@
 import "./rolldown-runtime-CRm0XQPb.js";
-import { _ as isRichOutput, m as clackLogger, p as plainLogger, v as findConfigFile, y as loadConfigFile } from "./output-mwVt_Vj9.js";
+import { l as toError } from "./Telemetry-Cz9QCzRo.js";
+import { _ as isRichOutput, b as CONFIG_EXTENSIONS, m as clackLogger, p as plainLogger, v as findConfigFile, y as loadConfigFile } from "./output-D_gc1nrM.js";
 import process from "node:process";
 import { resolve } from "node:path";
-import { createCliReporter } from "@kubb/core";
+import { Diagnostics, createCliReporter } from "@kubb/core";
 //#region src/loggers/reporters.ts
 /** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */
 function installReporter(context, reporter, ctx) {
@@ -55,7 +56,13 @@ function selectReporters(reporters, names) {
 /** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */
 async function getConfigs({ configPath, input, watch, logLevel }) {
 	const file = configPath ? resolve(configPath) : findConfigFile();
-	if (!file) throw new Error("Config not defined, create a kubb.config.js or pass through your config with the option --config");
+	if (!file) throw new Diagnostics.Error({
+		code: Diagnostics.code.unknown,
+		severity: "error",
+		message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(", ")}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,
+		help: "Run `kubb init` to create one, or pass a path with `--config`.",
+		location: { kind: "config" }
+	});
 	let configs;
 	try {
 		configs = await loadConfigFile(file, {
@@ -65,7 +72,14 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 			logLevel
 		});
 	} catch (error) {
-		throw new Error("Config failed loading", { cause: error });
+		throw new Diagnostics.Error({
+			code: Diagnostics.code.unknown,
+			severity: "error",
+			message: `Config failed loading: ${file}`,
+			help: "Fix the error the config file throws, shown under `caused by:`.",
+			location: { kind: "config" },
+			cause: toError(error)
+		});
 	}
 	return {
 		configPath: file,
@@ -78,4 +92,4 @@ async function getConfigs({ configPath, input, watch, logLevel }) {
 //#endregion
 export { selectReporters as n, setupReporters as r, getConfigs as t };
 
-//# sourceMappingURL=config-IMZ26zcb.js.map
+//# sourceMappingURL=config-DV_7s1m-.js.map

package/dist/config-DV_7s1m-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DV_7s1m-.js","names":[],"sources":["../src/loggers/reporters.ts","../src/config.ts"],"sourcesContent":["import process from 'node:process'\nimport type { Config, Hookable, KubbHooks, Reporter, ReporterContext, ReporterPluginFiles } from '@kubb/core'\nimport { createCliReporter } from '@kubb/core'\nimport { isRichOutput } from '../utils/env.ts'\nimport type { Logger, LoggerOptions } from './defineLogger.ts'\nimport { clackLogger } from './clackLogger.ts'\nimport { plainLogger } from './plainLogger.ts'\n\n/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */\nfunction installReporter(context: Hookable<KubbHooks>, reporter: Reporter, ctx: ReporterContext): void {\n  const pluginFiles = reporter.needsPluginFiles ? new Map<Config, Map<string, Set<string>>>() : undefined\n\n  if (pluginFiles) {\n    context.hook('kubb:plugin:end', ({ config, plugin, files }) => {\n      const filesByPlugin = pluginFiles.get(config) ?? new Map<string, Set<string>>()\n      const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]))\n      const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path)\n\n      if (added.length) filesByPlugin.set(plugin.name, new Set([...(filesByPlugin.get(plugin.name) ?? []), ...added]))\n\n      pluginFiles.set(config, filesByPlugin)\n    })\n  }\n\n  context.hook('kubb:generation:end', async ({ config, diagnostics = [], filesCreated = 0, status = 'success', hrStart = process.hrtime() }) => {\n    const files = pluginFiles?.get(config)\n    const grouped: ReporterPluginFiles | undefined = files && [...files].map(([plugin, paths]) => ({ plugin, files: [...paths] }))\n\n    await reporter.report({ config, diagnostics, filesCreated, status, hrStart, pluginFiles: grouped }, ctx)\n\n    pluginFiles?.delete(config)\n  })\n\n  if (reporter.drain) {\n    context.hook('kubb:lifecycle:end', () => reporter.drain?.(ctx))\n  }\n}\n\n/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */\nfunction setupReporters(\n  context: Hookable<KubbHooks>,\n  {\n    logLevel,\n    reporters,\n    logger: forcedLogger,\n  }: LoggerOptions & {\n    reporters: ReadonlyArray<Reporter>\n    /** Overrides the terminal-based pick, e.g. the plain logger for `kubb studio snapshot`. */\n    logger?: Logger\n  },\n): void {\n  const hasJson = reporters.some((reporter) => reporter.name === 'json')\n  const ctx: ReporterContext = { logLevel }\n\n  for (const reporter of reporters) {\n    if (reporter.name !== 'cli') {\n      installReporter(context, reporter, ctx)\n      continue\n    }\n\n    if (hasJson) {\n      continue\n    }\n\n    const logger = forcedLogger ?? (isRichOutput() ? clackLogger : plainLogger)\n    const handle = logger(context, { logLevel })\n\n    // The summary belongs inside the group the logger opened for this config, so the logger writes it.\n    installReporter(context, createCliReporter({ render: handle?.renderSummary }), ctx)\n  }\n}\n\nexport default setupReporters\n\n/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */\nexport function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {\n  return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? [])\n}\n","import { resolve } from 'node:path'\nimport process from 'node:process'\nimport { CONFIG_EXTENSIONS, findConfigFile, loadConfigFile } from '@internals/shared'\nimport { type CLIOptions, type Config, Diagnostics } from '@kubb/core'\nimport { toError } from '@internals/utils'\n\ntype GetConfigsOptions = {\n  /** Explicit path to the Kubb config file. When omitted, the loader searches up from `process.cwd()`. */\n  configPath?: string\n  /** OpenAPI input path or URL that overrides `config.input` for this run. */\n  input?: string\n  /** Watch flag forwarded to the user's `defineConfig` function. */\n  watch?: boolean\n  /** Log level forwarded to the user's `defineConfig` function. */\n  logLevel?: CLIOptions['logLevel']\n}\n\ntype GetConfigsResult = {\n  /** Absolute path to the resolved config file. */\n  configPath: string\n  /** Resolved and normalized Kubb configs, each guaranteed to have a `plugins` array. */\n  configs: Array<Config>\n}\n\n/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */\nexport async function getConfigs({ configPath, input, watch, logLevel }: GetConfigsOptions): Promise<GetConfigsResult> {\n  const file = configPath ? resolve(configPath) : findConfigFile()\n  if (!file) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(', ')}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,\n      help: 'Run `kubb init` to create one, or pass a path with `--config`.',\n      location: { kind: 'config' },\n    })\n  }\n\n  let configs: Array<Config>\n  try {\n    configs = await loadConfigFile<Config>(file, { config: configPath, input, watch, logLevel } satisfies CLIOptions)\n  } catch (error) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `Config failed loading: ${file}`,\n      help: 'Fix the error the config file throws, shown under `caused by:`.',\n      location: { kind: 'config' },\n      cause: toError(error),\n    })\n  }\n\n  return { configPath: file, configs: configs.map((item) => ({ ...item, plugins: item.plugins ?? [] })) }\n}\n"],"mappings":"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"}

package/dist/config-OL_izsmp.cjs

@@ -0,0 +1,113 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+const require_Telemetry = require("./Telemetry-CH2kkxWK.cjs");
+const require_output = require("./output-C5g7AtWH.cjs");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+let node_path = require("node:path");
+let _kubb_core = require("@kubb/core");
+//#region src/loggers/reporters.ts
+/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */
+function installReporter(context, reporter, ctx) {
+	const pluginFiles = reporter.needsPluginFiles ? /* @__PURE__ */ new Map() : void 0;
+	if (pluginFiles) context.hook("kubb:plugin:end", ({ config, plugin, files }) => {
+		const filesByPlugin = pluginFiles.get(config) ?? /* @__PURE__ */ new Map();
+		const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]));
+		const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path);
+		if (added.length) filesByPlugin.set(plugin.name, /* @__PURE__ */ new Set([...filesByPlugin.get(plugin.name) ?? [], ...added]));
+		pluginFiles.set(config, filesByPlugin);
+	});
+	context.hook("kubb:generation:end", async ({ config, diagnostics = [], filesCreated = 0, status = "success", hrStart = node_process.default.hrtime() }) => {
+		const files = pluginFiles?.get(config);
+		const grouped = files && [...files].map(([plugin, paths]) => ({
+			plugin,
+			files: [...paths]
+		}));
+		await reporter.report({
+			config,
+			diagnostics,
+			filesCreated,
+			status,
+			hrStart,
+			pluginFiles: grouped
+		}, ctx);
+		pluginFiles?.delete(config);
+	});
+	if (reporter.drain) context.hook("kubb:lifecycle:end", () => reporter.drain?.(ctx));
+}
+/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */
+function setupReporters(context, { logLevel, reporters, logger: forcedLogger }) {
+	const hasJson = reporters.some((reporter) => reporter.name === "json");
+	const ctx = { logLevel };
+	for (const reporter of reporters) {
+		if (reporter.name !== "cli") {
+			installReporter(context, reporter, ctx);
+			continue;
+		}
+		if (hasJson) continue;
+		const handle = (forcedLogger ?? (require_output.isRichOutput() ? require_output.clackLogger : require_output.plainLogger))(context, { logLevel });
+		installReporter(context, (0, _kubb_core.createCliReporter)({ render: handle?.renderSummary }), ctx);
+	}
+}
+/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */
+function selectReporters(reporters, names) {
+	return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? []);
+}
+//#endregion
+//#region src/config.ts
+/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */
+async function getConfigs({ configPath, input, watch, logLevel }) {
+	const file = configPath ? (0, node_path.resolve)(configPath) : require_output.findConfigFile();
+	if (!file) throw new _kubb_core.Diagnostics.Error({
+		code: _kubb_core.Diagnostics.code.unknown,
+		severity: "error",
+		message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${require_output.CONFIG_EXTENSIONS.join(", ")}) in ${node_process.default.cwd()}, its .config/ and configs/ folders, and each parent folder.`,
+		help: "Run `kubb init` to create one, or pass a path with `--config`.",
+		location: { kind: "config" }
+	});
+	let configs;
+	try {
+		configs = await require_output.loadConfigFile(file, {
+			config: configPath,
+			input,
+			watch,
+			logLevel
+		});
+	} catch (error) {
+		throw new _kubb_core.Diagnostics.Error({
+			code: _kubb_core.Diagnostics.code.unknown,
+			severity: "error",
+			message: `Config failed loading: ${file}`,
+			help: "Fix the error the config file throws, shown under `caused by:`.",
+			location: { kind: "config" },
+			cause: require_Telemetry.toError(error)
+		});
+	}
+	return {
+		configPath: file,
+		configs: configs.map((item) => ({
+			...item,
+			plugins: item.plugins ?? []
+		}))
+	};
+}
+//#endregion
+Object.defineProperty(exports, "getConfigs", {
+	enumerable: true,
+	get: function() {
+		return getConfigs;
+	}
+});
+Object.defineProperty(exports, "selectReporters", {
+	enumerable: true,
+	get: function() {
+		return selectReporters;
+	}
+});
+Object.defineProperty(exports, "setupReporters", {
+	enumerable: true,
+	get: function() {
+		return setupReporters;
+	}
+});
+
+//# sourceMappingURL=config-OL_izsmp.cjs.map

package/dist/config-OL_izsmp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-OL_izsmp.cjs","names":["process","isRichOutput","clackLogger","plainLogger","createCliReporter","resolve","findConfigFile","Diagnostics","CONFIG_EXTENSIONS","process","loadConfigFile","toError"],"sources":["../src/loggers/reporters.ts","../src/config.ts"],"sourcesContent":["import process from 'node:process'\nimport type { Config, Hookable, KubbHooks, Reporter, ReporterContext, ReporterPluginFiles } from '@kubb/core'\nimport { createCliReporter } from '@kubb/core'\nimport { isRichOutput } from '../utils/env.ts'\nimport type { Logger, LoggerOptions } from './defineLogger.ts'\nimport { clackLogger } from './clackLogger.ts'\nimport { plainLogger } from './plainLogger.ts'\n\n/** Bridges a {@link Reporter} onto the hook emitter: calls `report` with each config's {@link GenerationResult} on `kubb:generation:end`. */\nfunction installReporter(context: Hookable<KubbHooks>, reporter: Reporter, ctx: ReporterContext): void {\n  const pluginFiles = reporter.needsPluginFiles ? new Map<Config, Map<string, Set<string>>>() : undefined\n\n  if (pluginFiles) {\n    context.hook('kubb:plugin:end', ({ config, plugin, files }) => {\n      const filesByPlugin = pluginFiles.get(config) ?? new Map<string, Set<string>>()\n      const seen = new Set([...filesByPlugin.values()].flatMap((paths) => [...paths]))\n      const added = files.filter((file) => !seen.has(file.path)).map((file) => file.path)\n\n      if (added.length) filesByPlugin.set(plugin.name, new Set([...(filesByPlugin.get(plugin.name) ?? []), ...added]))\n\n      pluginFiles.set(config, filesByPlugin)\n    })\n  }\n\n  context.hook('kubb:generation:end', async ({ config, diagnostics = [], filesCreated = 0, status = 'success', hrStart = process.hrtime() }) => {\n    const files = pluginFiles?.get(config)\n    const grouped: ReporterPluginFiles | undefined = files && [...files].map(([plugin, paths]) => ({ plugin, files: [...paths] }))\n\n    await reporter.report({ config, diagnostics, filesCreated, status, hrStart, pluginFiles: grouped }, ctx)\n\n    pluginFiles?.delete(config)\n  })\n\n  if (reporter.drain) {\n    context.hook('kubb:lifecycle:end', () => reporter.drain?.(ctx))\n  }\n}\n\n/** Installs the live logger and wires the selected reporters. `cli` renders its summary through the logger, and is skipped when `json` owns stdout. */\nfunction setupReporters(\n  context: Hookable<KubbHooks>,\n  {\n    logLevel,\n    reporters,\n    logger: forcedLogger,\n  }: LoggerOptions & {\n    reporters: ReadonlyArray<Reporter>\n    /** Overrides the terminal-based pick, e.g. the plain logger for `kubb studio snapshot`. */\n    logger?: Logger\n  },\n): void {\n  const hasJson = reporters.some((reporter) => reporter.name === 'json')\n  const ctx: ReporterContext = { logLevel }\n\n  for (const reporter of reporters) {\n    if (reporter.name !== 'cli') {\n      installReporter(context, reporter, ctx)\n      continue\n    }\n\n    if (hasJson) {\n      continue\n    }\n\n    const logger = forcedLogger ?? (isRichOutput() ? clackLogger : plainLogger)\n    const handle = logger(context, { logLevel })\n\n    // The summary belongs inside the group the logger opened for this config, so the logger writes it.\n    installReporter(context, createCliReporter({ render: handle?.renderSummary }), ctx)\n  }\n}\n\nexport default setupReporters\n\n/** Picks the reporters whose `name` is in `names`, in the given order (the CLI maps `--reporter` to this); duplicates and unknown names are skipped. */\nexport function selectReporters(reporters: ReadonlyArray<Reporter>, names: ReadonlyArray<string>): Array<Reporter> {\n  return [...new Set(names)].flatMap((name) => reporters.find((reporter) => reporter.name === name) ?? [])\n}\n","import { resolve } from 'node:path'\nimport process from 'node:process'\nimport { CONFIG_EXTENSIONS, findConfigFile, loadConfigFile } from '@internals/shared'\nimport { type CLIOptions, type Config, Diagnostics } from '@kubb/core'\nimport { toError } from '@internals/utils'\n\ntype GetConfigsOptions = {\n  /** Explicit path to the Kubb config file. When omitted, the loader searches up from `process.cwd()`. */\n  configPath?: string\n  /** OpenAPI input path or URL that overrides `config.input` for this run. */\n  input?: string\n  /** Watch flag forwarded to the user's `defineConfig` function. */\n  watch?: boolean\n  /** Log level forwarded to the user's `defineConfig` function. */\n  logLevel?: CLIOptions['logLevel']\n}\n\ntype GetConfigsResult = {\n  /** Absolute path to the resolved config file. */\n  configPath: string\n  /** Resolved and normalized Kubb configs, each guaranteed to have a `plugins` array. */\n  configs: Array<Config>\n}\n\n/** Discovers the Kubb config and resolves it into normalized configs, each guaranteed to have a `plugins` array. */\nexport async function getConfigs({ configPath, input, watch, logLevel }: GetConfigsOptions): Promise<GetConfigsResult> {\n  const file = configPath ? resolve(configPath) : findConfigFile()\n  if (!file) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `No Kubb config found. Looked for kubb.config.* and .kubbrc.* (${CONFIG_EXTENSIONS.join(', ')}) in ${process.cwd()}, its .config/ and configs/ folders, and each parent folder.`,\n      help: 'Run `kubb init` to create one, or pass a path with `--config`.',\n      location: { kind: 'config' },\n    })\n  }\n\n  let configs: Array<Config>\n  try {\n    configs = await loadConfigFile<Config>(file, { config: configPath, input, watch, logLevel } satisfies CLIOptions)\n  } catch (error) {\n    throw new Diagnostics.Error({\n      code: Diagnostics.code.unknown,\n      severity: 'error',\n      message: `Config failed loading: ${file}`,\n      help: 'Fix the error the config file throws, shown under `caused by:`.',\n      location: { kind: 'config' },\n      cause: toError(error),\n    })\n  }\n\n  return { configPath: file, configs: configs.map((item) => ({ ...item, plugins: item.plugins ?? [] })) }\n}\n"],"mappings":"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"}

package/dist/credentials-xOkTTDWj.cjs

@@ -0,0 +1,113 @@
+const require_rolldown_runtime = require("./rolldown-runtime-C0BPl7ul.cjs");
+let node_crypto = require("node:crypto");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path, 1);
+let _kubb_core = require("@kubb/core");
+//#region src/runners/studio/credentials.ts
+var credentials_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
+	clearCredentials: () => clearCredentials,
+	getCredentialsPath: () => getCredentialsPath,
+	getMachineId: () => getMachineId,
+	getProjectKubbHome: () => getProjectKubbHome,
+	readCredentials: () => readCredentials,
+	writeCredentials: () => writeCredentials
+});
+const projectBase = (project = node_process.default.cwd()) => node_path.default.join("projects", (0, node_crypto.hash)("sha256", project));
+/**
+* Root for the credential and machine identity of the current project, inside `KUBB_HOME`.
+*
+* Studio agents are project connections, so two projects on one machine must not share the same
+* persisted token or machine secret.
+*/
+function getProjectKubbHome(project = node_process.default.cwd()) {
+	return (0, _kubb_core.resolveKubbDir)(projectBase(project));
+}
+const projectStorage = () => (0, _kubb_core.kubbStorage)({ base: projectBase() });
+const CREDENTIALS_FILENAME = "credentials.json";
+/**
+* Absolute path of the stored credential, so callers can name it in output without rebuilding it.
+*/
+function getCredentialsPath() {
+	return node_path.default.join(getProjectKubbHome(), CREDENTIALS_FILENAME);
+}
+/**
+* Reads the stored credential, or null when this machine has not paired yet or the file is
+* unreadable or corrupt. A bad file is treated as "not paired" so `kubb studio login` can
+* overwrite it rather than the CLI dying on it.
+*/
+async function readCredentials() {
+	const stored = await projectStorage().getItem(CREDENTIALS_FILENAME).catch(() => null);
+	return typeof stored?.token === "string" && stored.token !== "" ? stored : null;
+}
+/**
+* Writes the credential into the project folder, which only its owner can open.
+*/
+async function writeCredentials(credentials) {
+	await projectStorage().setItem(CREDENTIALS_FILENAME, credentials);
+}
+/**
+* Forgets the stored credential. Succeeds when there was nothing to forget.
+*/
+async function clearCredentials() {
+	await projectStorage().removeItem(CREDENTIALS_FILENAME);
+}
+/**
+* Reads this project's machine secret, creating it on first use. Pairing sends its hash, so pairing
+* the same project again rotates one agent's token instead of creating a second agent. It lives
+* apart from the credential, which {@link clearCredentials} deletes.
+*/
+async function getMachineId() {
+	const storage = projectStorage();
+	const stored = await storage.getItem("machine-secret").catch(() => null);
+	if (typeof stored === "string" && stored.trim()) return stored.trim();
+	const secret = (0, node_crypto.randomBytes)(32).toString("hex");
+	await storage.setItem("machine-secret", secret);
+	return secret;
+}
+//#endregion
+Object.defineProperty(exports, "clearCredentials", {
+	enumerable: true,
+	get: function() {
+		return clearCredentials;
+	}
+});
+Object.defineProperty(exports, "credentials_exports", {
+	enumerable: true,
+	get: function() {
+		return credentials_exports;
+	}
+});
+Object.defineProperty(exports, "getCredentialsPath", {
+	enumerable: true,
+	get: function() {
+		return getCredentialsPath;
+	}
+});
+Object.defineProperty(exports, "getMachineId", {
+	enumerable: true,
+	get: function() {
+		return getMachineId;
+	}
+});
+Object.defineProperty(exports, "getProjectKubbHome", {
+	enumerable: true,
+	get: function() {
+		return getProjectKubbHome;
+	}
+});
+Object.defineProperty(exports, "readCredentials", {
+	enumerable: true,
+	get: function() {
+		return readCredentials;
+	}
+});
+Object.defineProperty(exports, "writeCredentials", {
+	enumerable: true,
+	get: function() {
+		return writeCredentials;
+	}
+});
+
+//# sourceMappingURL=credentials-xOkTTDWj.cjs.map