@kubb/cli 5.3.8 → 5.3.9

package/dist/shared-C5doIqKD.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-C5doIqKD.js","names":[],"sources":["../src/commands/shared.ts"],"sourcesContent":["export const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowInput: {\n    type: 'boolean',\n    description: 'Generate from an OpenAPI spec sent by Studio instead of the one on disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n"],"mappings":";AAAA,MAAa,YAAY,EACvB,QAAQ;CACN,MAAM;CACN,aAAa;CACb,OAAO;AACT,EACF;AAEA,MAAa,cAAc,EACzB,UAAU;CACR,MAAM;CACN,SAAS;EAAC;EAAU;EAAQ;CAAS;CACrC,aAAa;CACb,OAAO;CACP,SAAS;CACT,SAAS;AACX,EACF;AAEA,MAAa,uBAAuB;CAClC,KAAK;EACH,MAAM;EACN,aAAa;CACf;CACA,OAAO;EACL,MAAM;EACN,aAAa;CACf;AACF;AAEA,MAAa,uBAAuB;CAClC,WAAW;EACT,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,YAAY;EACV,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,iBAAiB;EACf,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,YAAY;EACV,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,WAAW;EACT,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;AACF"}

package/dist/shared-CaRlFkWL.cjs

@@ -0,0 +1,87 @@
+//#region src/commands/shared.ts
+const configArg = { config: {
+	type: "string",
+	description: "Path to the Kubb config",
+	short: "c"
+} };
+const logLevelArg = { logLevel: {
+	type: "enum",
+	choices: [
+		"silent",
+		"info",
+		"verbose"
+	],
+	description: "Info, silent or verbose",
+	short: "l",
+	default: "info",
+	toKebab: true
+} };
+const studioConnectionArgs = {
+	url: {
+		type: "string",
+		description: "Base URL of the Kubb Studio instance"
+	},
+	token: {
+		type: "string",
+		description: "Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN"
+	}
+};
+const studioPermissionArgs = {
+	allowRead: {
+		type: "boolean",
+		description: "Read the source of files a generation produced. Asked for once per project when omitted",
+		default: false,
+		toKebab: true
+	},
+	allowWrite: {
+		type: "boolean",
+		description: "Write generated files to disk. Asked for once per project when omitted",
+		default: false,
+		toKebab: true
+	},
+	allowConfigEdit: {
+		type: "boolean",
+		description: "Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted",
+		default: false,
+		toKebab: true
+	},
+	allowInput: {
+		type: "boolean",
+		description: "Generate from an OpenAPI spec sent by Studio instead of the one on disk. Asked for once per project when omitted",
+		default: false,
+		toKebab: true
+	},
+	allowExec: {
+		type: "boolean",
+		description: "Run the formatter, the linter, and output.postGenerate after a generation",
+		default: false,
+		toKebab: true
+	}
+};
+//#endregion
+Object.defineProperty(exports, "configArg", {
+	enumerable: true,
+	get: function() {
+		return configArg;
+	}
+});
+Object.defineProperty(exports, "logLevelArg", {
+	enumerable: true,
+	get: function() {
+		return logLevelArg;
+	}
+});
+Object.defineProperty(exports, "studioConnectionArgs", {
+	enumerable: true,
+	get: function() {
+		return studioConnectionArgs;
+	}
+});
+Object.defineProperty(exports, "studioPermissionArgs", {
+	enumerable: true,
+	get: function() {
+		return studioPermissionArgs;
+	}
+});
+
+//# sourceMappingURL=shared-CaRlFkWL.cjs.map

package/dist/shared-CaRlFkWL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-CaRlFkWL.cjs","names":[],"sources":["../src/commands/shared.ts"],"sourcesContent":["export const configArg = {\n  config: {\n    type: 'string',\n    description: 'Path to the Kubb config',\n    short: 'c',\n  },\n} as const\n\nexport const logLevelArg = {\n  logLevel: {\n    type: 'enum',\n    choices: ['silent', 'info', 'verbose'] as const,\n    description: 'Info, silent or verbose',\n    short: 'l',\n    default: 'info',\n    toKebab: true,\n  },\n} as const\n\nexport const studioConnectionArgs = {\n  url: {\n    type: 'string',\n    description: 'Base URL of the Kubb Studio instance',\n  },\n  token: {\n    type: 'string',\n    description: 'Organization CI API key for `snapshot`. Defaults to KUBB_TOKEN',\n  },\n} as const\n\nexport const studioPermissionArgs = {\n  allowRead: {\n    type: 'boolean',\n    description: 'Read the source of files a generation produced. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowWrite: {\n    type: 'boolean',\n    description: 'Write generated files to disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowConfigEdit: {\n    type: 'boolean',\n    description: 'Let Studio change plugin options in kubb.config.ts. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowInput: {\n    type: 'boolean',\n    description: 'Generate from an OpenAPI spec sent by Studio instead of the one on disk. Asked for once per project when omitted',\n    default: false,\n    toKebab: true,\n  },\n  allowExec: {\n    type: 'boolean',\n    description: 'Run the formatter, the linter, and output.postGenerate after a generation',\n    default: false,\n    toKebab: true,\n  },\n} as const\n"],"mappings":";AAAA,MAAa,YAAY,EACvB,QAAQ;CACN,MAAM;CACN,aAAa;CACb,OAAO;AACT,EACF;AAEA,MAAa,cAAc,EACzB,UAAU;CACR,MAAM;CACN,SAAS;EAAC;EAAU;EAAQ;CAAS;CACrC,aAAa;CACb,OAAO;CACP,SAAS;CACT,SAAS;AACX,EACF;AAEA,MAAa,uBAAuB;CAClC,KAAK;EACH,MAAM;EACN,aAAa;CACf;CACA,OAAO;EACL,MAAM;EACN,aAAa;CACf;AACF;AAEA,MAAa,uBAAuB;CAClC,WAAW;EACT,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,YAAY;EACV,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,iBAAiB;EACf,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,YAAY;EACV,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;CACA,WAAW;EACT,MAAM;EACN,aAAa;EACb,SAAS;EACT,SAAS;CACX;AACF"}

package/dist/snapshot-DWNiluEm.cjs

@@ -0,0 +1,261 @@
+const require_rolldown_runtime = require("./rolldown-runtime-qbf5tadS.cjs");
+const require_run = require("./run-CIonyF_t.cjs");
+const require_output = require("./output-DBBTlqPw.cjs");
+let node_util = require("node:util");
+let node_process = require("node:process");
+node_process = require_rolldown_runtime.__toESM(node_process, 1);
+let node_path = require("node:path");
+let node_fs = require("node:fs");
+let _kubb_core = require("@kubb/core");
+let _kubb_studio = require("@kubb/studio");
+//#region src/runners/studio/ci.ts
+function readGithubPullRequestNumber(eventPath) {
+	if (!eventPath) return;
+	try {
+		const event = JSON.parse((0, node_fs.readFileSync)(eventPath, "utf8"));
+		return event.pull_request?.number ? String(event.pull_request.number) : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Detects the CI provider from its environment variables and derives a stable identity from it.
+* The GitHub row reproduces `gh:<repositoryId>:<prNumber>`, the identity `kubb-labs/action` has
+* always registered agents under, so an existing repository keeps reusing its agent.
+*/
+function detectCi(env = node_process.default.env) {
+	if (env.GITHUB_ACTIONS) {
+		const pullRequestNumber = readGithubPullRequestNumber(env.GITHUB_EVENT_PATH);
+		const repositoryId = env.GITHUB_REPOSITORY_ID ?? env.GITHUB_REPOSITORY ?? "";
+		const scope = pullRequestNumber ?? env.GITHUB_RUN_ID ?? "";
+		return {
+			id: `gh:${repositoryId}:${scope}`,
+			name: `${env.GITHUB_REPOSITORY ?? "github"}#${scope}`
+		};
+	}
+	if (env.GITLAB_CI) {
+		const scope = env.CI_MERGE_REQUEST_IID ?? env.CI_COMMIT_REF_SLUG ?? "";
+		return {
+			id: `gl:${env.CI_PROJECT_ID ?? ""}:${scope}`,
+			name: `${env.CI_PROJECT_PATH ?? "gitlab"}#${scope}`
+		};
+	}
+	if (env.BITBUCKET_BUILD_NUMBER) {
+		const scope = env.BITBUCKET_PR_ID ?? env.BITBUCKET_BRANCH ?? "";
+		return {
+			id: `bb:${env.BITBUCKET_REPO_UUID ?? ""}:${scope}`,
+			name: `${env.BITBUCKET_REPO_FULL_NAME ?? "bitbucket"}#${scope}`
+		};
+	}
+	if (env.CIRCLECI) {
+		const owner = env.CIRCLE_PROJECT_USERNAME ?? "";
+		const project = env.CIRCLE_PROJECT_REPONAME ?? "circleci";
+		const scope = env.CIRCLE_PR_NUMBER ?? env.CIRCLE_BRANCH ?? "";
+		return {
+			id: `circle:${owner}:${project}:${scope}`,
+			name: `${owner ? `${owner}/` : ""}${project}#${scope}`
+		};
+	}
+	return null;
+}
+//#endregion
+//#region src/runners/studio/snapshot.ts
+/**
+* How long to wait for Studio's `studio:ready` acknowledgement, above the client's own 10s
+* handshake-ack timeout.
+*/
+const READY_TIMEOUT_MS = 15e3;
+/**
+* Longest `--timeout` accepted. Job records expire from Studio's storage after an hour.
+*/
+const MAX_TIMEOUT_SECONDS = 3600;
+const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"::1"
+]);
+async function findPackageJson(startDirectory) {
+	let directory = startDirectory;
+	for (;;) {
+		const file = (0, node_path.join)(directory, "package.json");
+		if (await require_run.exists(file)) {
+			const packageJson = JSON.parse(await require_run.read(file));
+			if (packageJson.name && packageJson.version) return {
+				name: packageJson.name,
+				version: packageJson.version
+			};
+		}
+		const parent = (0, node_path.dirname)(directory);
+		if (parent === directory) break;
+		directory = parent;
+	}
+	throw new Error(`No package.json with a name and a version found above ${startDirectory}`);
+}
+/** Reads package.json only for whichever of name/version --name and --version did not supply. */
+async function resolvePackageMetadata(options) {
+	if (options.name && options.packageVersion) return {
+		name: options.name,
+		version: options.packageVersion
+	};
+	const packageMetadata = await findPackageJson(node_process.default.cwd());
+	return {
+		name: options.name ?? packageMetadata.name,
+		version: options.packageVersion ?? packageMetadata.version
+	};
+}
+function resolveToken(options) {
+	const token = options.token ?? node_process.default.env.KUBB_TOKEN;
+	if (!token) throw new Error("An organization CI API key is required. Pass --token or set KUBB_TOKEN.");
+	return token;
+}
+function resolveCiIdentity(options) {
+	const detected = detectCi();
+	if (options.id) return {
+		id: options.id,
+		name: detected?.name ?? options.id
+	};
+	if (!detected) throw new Error("Could not detect a supported CI provider (GitHub Actions, GitLab CI, Bitbucket Pipelines, CircleCI). Pass --id.");
+	return detected;
+}
+/** Rejects a bad `--timeout` up front instead of letting it reach `waitForJob` as NaN or <= 0. */
+function resolveTimeoutMs(options) {
+	const seconds = options.timeout ?? 600;
+	if (!Number.isFinite(seconds) || seconds <= 0) throw new Error("--timeout must be a positive number of seconds");
+	return Math.min(seconds, MAX_TIMEOUT_SECONDS) * 1e3;
+}
+/** The CI key is a credential, so refuse to send it anywhere but HTTPS or a loopback dev host. */
+function assertSecureStudioUrl(studioUrl) {
+	const url = new URL(studioUrl);
+	if (url.protocol !== "https:" && !LOOPBACK_HOSTS.has(url.hostname)) throw new Error(`Refusing to send the CI API key to ${studioUrl}. Use an https:// Studio URL, or a loopback host for local development.`);
+}
+function absoluteUrl(studioUrl, path) {
+	return new URL(path, `${studioUrl}/`).toString();
+}
+function toResult(studioUrl, snapshot, agentSlug) {
+	return {
+		id: snapshot.id,
+		name: snapshot.name,
+		version: snapshot.version,
+		integrity: snapshot.integrity,
+		url: absoluteUrl(studioUrl, snapshot.url),
+		snapshotIdUrl: absoluteUrl(studioUrl, snapshot.snapshotIdUrl),
+		expiresAt: snapshot.expiresAt,
+		agentUrl: absoluteUrl(studioUrl, `/agents/${agentSlug}`)
+	};
+}
+function printSummary(result) {
+	require_output.logBlock([
+		`${(0, node_util.styleText)("dim", "Package".padEnd(10))}  ${result.name ?? "(unnamed)"}@${result.version ?? "0.0.0"}`,
+		`${(0, node_util.styleText)("dim", "Tarball".padEnd(10))}  ${(0, node_util.styleText)("cyan", result.url)}`,
+		`${(0, node_util.styleText)("dim", "Agent".padEnd(10))}  ${result.agentUrl}`,
+		`${(0, node_util.styleText)("dim", "Expires".padEnd(10))}  ${result.expiresAt}`
+	]);
+}
+/**
+* Generates a Kubb Studio snapshot from a script: registers or reuses a CI agent, connects it,
+* queues a snapshot job, and polls until the tarball is ready. A snapshot job runs generation and
+* packs the tarball in one step, so this needs no separate generation run.
+*/
+async function snapshot(options) {
+	const timeoutMs = resolveTimeoutMs(options);
+	const token = resolveToken(options);
+	assertSecureStudioUrl(options.studioUrl);
+	const { configPath } = await require_run.loadConfigs(options);
+	const ci = resolveCiIdentity(options);
+	const { name, version: packageVersion } = await resolvePackageMetadata(options);
+	node_process.default.env.KUBB_AGENT_SECRET = ci.id;
+	const spinner = options.json ? null : require_output.createSpinner();
+	const log = (message) => {
+		if (options.json) {
+			console.error(message);
+			return;
+		}
+		spinner?.message(message);
+	};
+	if (options.json) log("Creating Kubb Studio agent");
+	if (!options.json) spinner?.start("Creating Kubb Studio agent");
+	const agent = await (0, _kubb_studio.createAgent)({
+		studioUrl: options.studioUrl,
+		token,
+		name: ci.name,
+		machineToken: (0, _kubb_studio.machineTokenFrom)(ci.id)
+	});
+	const { promise: ready, reject: markFailed, resolve: markReady } = Promise.withResolvers();
+	const client = (0, _kubb_studio.createClient)({
+		studioUrl: options.studioUrl,
+		token: agent.token,
+		configPath,
+		root: node_process.default.cwd(),
+		version: options.version,
+		client: { kind: "cli" },
+		logLevel: _kubb_core.logLevel[options.logLevel ?? "info"],
+		loadConfig: async () => (await require_run.loadConfigs(options)).config,
+		installLogger: (hooks) => {
+			hooks.hook("studio:connecting", ({ url }) => log(`Connecting to Kubb Studio at ${url}`));
+			hooks.hook("studio:connected", ({ url }) => log(`Connected to Kubb Studio at ${url}`));
+			hooks.hook("studio:ready", () => {
+				log("Kubb Studio connection ready");
+				markReady();
+			});
+			hooks.hook("studio:warn", ({ message }) => log(`Kubb Studio warning: ${message}`));
+			hooks.hook("studio:error", ({ error }) => markFailed(error));
+		}
+	});
+	await client.connect();
+	try {
+		let readyTimeoutHandle;
+		try {
+			await Promise.race([ready, new Promise((_, reject) => {
+				readyTimeoutHandle = setTimeout(() => reject(/* @__PURE__ */ new Error("Timed out waiting for Kubb Studio to confirm the agent was ready")), READY_TIMEOUT_MS);
+			})]);
+		} finally {
+			clearTimeout(readyTimeoutHandle);
+		}
+		log("Creating snapshot job");
+		const job = await (0, _kubb_studio.createJob)({
+			studioUrl: options.studioUrl,
+			token,
+			type: "snapshot",
+			agentId: agent.id,
+			name,
+			version: packageVersion
+		});
+		log(`Snapshot job queued: ${job.id}`);
+		const finished = await (0, _kubb_studio.waitForJob)({
+			studioUrl: options.studioUrl,
+			token,
+			id: job.id,
+			timeoutMs
+		});
+		if (finished.status === "failed") throw new Error(finished.error ?? "Snapshot job failed");
+		if (!finished.snapshot) throw new Error("Snapshot job succeeded without a snapshot");
+		const result = toResult(options.studioUrl, finished.snapshot, agent.slug);
+		if (options.json) log("Snapshot published");
+		if (!options.json) spinner?.stop("Snapshot published");
+		if (options.json) console.log(JSON.stringify(result));
+		if (!options.json) printSummary(result);
+	} catch (error) {
+		if (options.json) log("Snapshot failed");
+		if (!options.json) spinner?.stop("Snapshot failed");
+		throw error;
+	} finally {
+		if (options.json) log("Disconnecting from Kubb Studio");
+		client.disconnect();
+	}
+}
+const runner = async ({ values }) => {
+	const options = {
+		...require_run.createStudioOptions(values),
+		token: values.token,
+		id: values.id,
+		name: values.name,
+		packageVersion: values.packageVersion,
+		timeout: values.timeout,
+		json: values.json
+	};
+	await require_run.run(options, () => snapshot(options), { json: options.json });
+};
+//#endregion
+exports.runner = runner;
+
+//# sourceMappingURL=snapshot-DWNiluEm.cjs.map

package/dist/snapshot-DWNiluEm.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-DWNiluEm.cjs","names":["readFileSync","process","join","exists","read","dirname","process","styleText","loadConfigs","createSpinner","createAgent","machineTokenFrom","createClient","logLevelMap","createJob","waitForJob","createStudioOptions","run"],"sources":["../src/runners/studio/ci.ts","../src/runners/studio/snapshot.ts"],"sourcesContent":["import { readFileSync } from 'node:fs'\nimport process from 'node:process'\n\n/**\n * Stable identity for the CI agent a snapshot run registers or reuses.\n */\nexport type CiContext = {\n  /**\n   * Fed into the machine token, so the same merge or pull request reuses one agent.\n   */\n  id: string\n  /**\n   * Agent display name shown in Studio.\n   */\n  name: string\n}\n\nfunction readGithubPullRequestNumber(eventPath: string | undefined): string | undefined {\n  if (!eventPath) {\n    return undefined\n  }\n\n  try {\n    const event = JSON.parse(readFileSync(eventPath, 'utf8')) as { pull_request?: { number?: number } }\n    return event.pull_request?.number ? String(event.pull_request.number) : undefined\n  } catch {\n    return undefined\n  }\n}\n\n/**\n * Detects the CI provider from its environment variables and derives a stable identity from it.\n * The GitHub row reproduces `gh:<repositoryId>:<prNumber>`, the identity `kubb-labs/action` has\n * always registered agents under, so an existing repository keeps reusing its agent.\n */\nexport function detectCi(env: Record<string, string | undefined> = process.env): CiContext | null {\n  if (env.GITHUB_ACTIONS) {\n    const pullRequestNumber = readGithubPullRequestNumber(env.GITHUB_EVENT_PATH)\n    const repositoryId = env.GITHUB_REPOSITORY_ID ?? env.GITHUB_REPOSITORY ?? ''\n    const scope = pullRequestNumber ?? env.GITHUB_RUN_ID ?? ''\n\n    return { id: `gh:${repositoryId}:${scope}`, name: `${env.GITHUB_REPOSITORY ?? 'github'}#${scope}` }\n  }\n\n  if (env.GITLAB_CI) {\n    const scope = env.CI_MERGE_REQUEST_IID ?? env.CI_COMMIT_REF_SLUG ?? ''\n\n    return { id: `gl:${env.CI_PROJECT_ID ?? ''}:${scope}`, name: `${env.CI_PROJECT_PATH ?? 'gitlab'}#${scope}` }\n  }\n\n  if (env.BITBUCKET_BUILD_NUMBER) {\n    const scope = env.BITBUCKET_PR_ID ?? env.BITBUCKET_BRANCH ?? ''\n\n    return { id: `bb:${env.BITBUCKET_REPO_UUID ?? ''}:${scope}`, name: `${env.BITBUCKET_REPO_FULL_NAME ?? 'bitbucket'}#${scope}` }\n  }\n\n  if (env.CIRCLECI) {\n    // Owner-qualified: two projects with the same name under different CircleCI orgs must not\n    // collide on one agent, since registering it purges the other project's live sessions.\n    const owner = env.CIRCLE_PROJECT_USERNAME ?? ''\n    const project = env.CIRCLE_PROJECT_REPONAME ?? 'circleci'\n    const scope = env.CIRCLE_PR_NUMBER ?? env.CIRCLE_BRANCH ?? ''\n\n    return { id: `circle:${owner}:${project}:${scope}`, name: `${owner ? `${owner}/` : ''}${project}#${scope}` }\n  }\n\n  return null\n}\n","import { dirname, join } from 'node:path'\nimport process from 'node:process'\nimport { styleText } from 'node:util'\nimport { exists, read } from '@internals/utils'\nimport { logLevel as logLevelMap } from '@kubb/core'\nimport { createAgent, createClient, createJob, machineTokenFrom, waitForJob, type StudioSnapshot } from '@kubb/studio'\nimport { createSpinner, logBlock } from '../../loggers/output.ts'\nimport { detectCi } from './ci.ts'\nimport { createStudioOptions, loadConfigs, run, type SnapshotOptions } from './run.ts'\nimport type { definition } from '../../commands/studio/snapshot.ts'\nimport type { CommandRunner } from 'gunshi'\n\n/**\n * How long to wait for Studio's `studio:ready` acknowledgement, above the client's own 10s\n * handshake-ack timeout.\n */\nconst READY_TIMEOUT_MS = 15_000\n\n/**\n * Longest `--timeout` accepted. Job records expire from Studio's storage after an hour.\n */\nconst MAX_TIMEOUT_SECONDS = 3600\n\nconst LOOPBACK_HOSTS = new Set(['localhost', '127.0.0.1', '::1'])\n\nasync function findPackageJson(startDirectory: string): Promise<{ name: string; version: string }> {\n  let directory = startDirectory\n\n  for (;;) {\n    const file = join(directory, 'package.json')\n\n    if (await exists(file)) {\n      const packageJson = JSON.parse(await read(file)) as Partial<{ name: string; version: string }>\n\n      if (packageJson.name && packageJson.version) {\n        return { name: packageJson.name, version: packageJson.version }\n      }\n    }\n\n    const parent = dirname(directory)\n\n    if (parent === directory) {\n      break\n    }\n\n    directory = parent\n  }\n\n  throw new Error(`No package.json with a name and a version found above ${startDirectory}`)\n}\n\n/** Reads package.json only for whichever of name/version --name and --version did not supply. */\nasync function resolvePackageMetadata(options: SnapshotOptions): Promise<{ name: string; version: string }> {\n  if (options.name && options.packageVersion) {\n    return { name: options.name, version: options.packageVersion }\n  }\n\n  const packageMetadata = await findPackageJson(process.cwd())\n\n  return { name: options.name ?? packageMetadata.name, version: options.packageVersion ?? packageMetadata.version }\n}\n\nfunction resolveToken(options: SnapshotOptions): string {\n  const token = options.token ?? process.env.KUBB_TOKEN\n\n  if (!token) {\n    throw new Error('An organization CI API key is required. Pass --token or set KUBB_TOKEN.')\n  }\n\n  return token\n}\n\nfunction resolveCiIdentity(options: SnapshotOptions): { id: string; name: string } {\n  const detected = detectCi()\n\n  if (options.id) {\n    return { id: options.id, name: detected?.name ?? options.id }\n  }\n\n  if (!detected) {\n    throw new Error('Could not detect a supported CI provider (GitHub Actions, GitLab CI, Bitbucket Pipelines, CircleCI). Pass --id.')\n  }\n\n  return detected\n}\n\n/** Rejects a bad `--timeout` up front instead of letting it reach `waitForJob` as NaN or <= 0. */\nfunction resolveTimeoutMs(options: SnapshotOptions): number {\n  const seconds = options.timeout ?? 600\n\n  if (!Number.isFinite(seconds) || seconds <= 0) {\n    throw new Error('--timeout must be a positive number of seconds')\n  }\n\n  return Math.min(seconds, MAX_TIMEOUT_SECONDS) * 1000\n}\n\n/** The CI key is a credential, so refuse to send it anywhere but HTTPS or a loopback dev host. */\nfunction assertSecureStudioUrl(studioUrl: string): void {\n  const url = new URL(studioUrl)\n\n  if (url.protocol !== 'https:' && !LOOPBACK_HOSTS.has(url.hostname)) {\n    throw new Error(`Refusing to send the CI API key to ${studioUrl}. Use an https:// Studio URL, or a loopback host for local development.`)\n  }\n}\n\nfunction absoluteUrl(studioUrl: string, path: string): string {\n  return new URL(path, `${studioUrl}/`).toString()\n}\n\ntype SnapshotResult = {\n  id: string\n  name: string | null\n  version: string | null\n  integrity: string | null\n  url: string\n  snapshotIdUrl: string\n  expiresAt: string\n  agentUrl: string\n}\n\nfunction toResult(studioUrl: string, snapshot: StudioSnapshot, agentSlug: string): SnapshotResult {\n  return {\n    id: snapshot.id,\n    name: snapshot.name,\n    version: snapshot.version,\n    integrity: snapshot.integrity,\n    url: absoluteUrl(studioUrl, snapshot.url),\n    snapshotIdUrl: absoluteUrl(studioUrl, snapshot.snapshotIdUrl),\n    expiresAt: snapshot.expiresAt,\n    agentUrl: absoluteUrl(studioUrl, `/agents/${agentSlug}`),\n  }\n}\n\nfunction printSummary(result: SnapshotResult): void {\n  logBlock([\n    `${styleText('dim', 'Package'.padEnd(10))}  ${result.name ?? '(unnamed)'}@${result.version ?? '0.0.0'}`,\n    `${styleText('dim', 'Tarball'.padEnd(10))}  ${styleText('cyan', result.url)}`,\n    `${styleText('dim', 'Agent'.padEnd(10))}  ${result.agentUrl}`,\n    `${styleText('dim', 'Expires'.padEnd(10))}  ${result.expiresAt}`,\n  ])\n}\n\n/**\n * Generates a Kubb Studio snapshot from a script: registers or reuses a CI agent, connects it,\n * queues a snapshot job, and polls until the tarball is ready. A snapshot job runs generation and\n * packs the tarball in one step, so this needs no separate generation run.\n */\nexport async function snapshot(options: SnapshotOptions): Promise<void> {\n  const timeoutMs = resolveTimeoutMs(options)\n  const token = resolveToken(options)\n  assertSecureStudioUrl(options.studioUrl)\n  const { configPath } = await loadConfigs(options)\n  const ci = resolveCiIdentity(options)\n  const { name, version: packageVersion } = await resolvePackageMetadata(options)\n\n  // Set before the first `getMachineToken()` call (inside `client.connect()`), so the WebSocket\n  // session registers under the same machine token `createAgent` just registered with Studio.\n  process.env.KUBB_AGENT_SECRET = ci.id\n\n  const spinner = options.json ? null : createSpinner()\n  const log = (message: string) => {\n    if (options.json) {\n      console.error(message)\n      return\n    }\n\n    spinner?.message(message)\n  }\n\n  if (options.json) {\n    log('Creating Kubb Studio agent')\n  }\n  if (!options.json) {\n    spinner?.start('Creating Kubb Studio agent')\n  }\n\n  const agent = await createAgent({ studioUrl: options.studioUrl, token, name: ci.name, machineToken: machineTokenFrom(ci.id) })\n\n  const { promise: ready, reject: markFailed, resolve: markReady } = Promise.withResolvers<void>()\n\n  const client = createClient({\n    studioUrl: options.studioUrl,\n    token: agent.token,\n    configPath,\n    root: process.cwd(),\n    version: options.version,\n    client: { kind: 'cli' },\n    logLevel: logLevelMap[options.logLevel ?? 'info'],\n    loadConfig: async () => (await loadConfigs(options)).config,\n    installLogger: (hooks) => {\n      hooks.hook('studio:connecting', ({ url }) => log(`Connecting to Kubb Studio at ${url}`))\n      hooks.hook('studio:connected', ({ url }) => log(`Connected to Kubb Studio at ${url}`))\n      hooks.hook('studio:ready', () => {\n        log('Kubb Studio connection ready')\n        markReady()\n      })\n      hooks.hook('studio:warn', ({ message }) => log(`Kubb Studio warning: ${message}`))\n      hooks.hook('studio:error', ({ error }) => markFailed(error))\n    },\n  })\n\n  await client.connect()\n\n  try {\n    let readyTimeoutHandle: ReturnType<typeof setTimeout> | undefined\n\n    try {\n      await Promise.race([\n        ready,\n        new Promise<void>((_, reject) => {\n          readyTimeoutHandle = setTimeout(() => reject(new Error('Timed out waiting for Kubb Studio to confirm the agent was ready')), READY_TIMEOUT_MS)\n        }),\n      ])\n    } finally {\n      clearTimeout(readyTimeoutHandle)\n    }\n\n    log('Creating snapshot job')\n\n    const job = await createJob({ studioUrl: options.studioUrl, token, type: 'snapshot', agentId: agent.id, name, version: packageVersion })\n    log(`Snapshot job queued: ${job.id}`)\n    const finished = await waitForJob({ studioUrl: options.studioUrl, token, id: job.id, timeoutMs })\n\n    if (finished.status === 'failed') {\n      throw new Error(finished.error ?? 'Snapshot job failed')\n    }\n\n    if (!finished.snapshot) {\n      throw new Error('Snapshot job succeeded without a snapshot')\n    }\n\n    const result = toResult(options.studioUrl, finished.snapshot, agent.slug)\n\n    if (options.json) {\n      log('Snapshot published')\n    }\n    if (!options.json) {\n      spinner?.stop('Snapshot published')\n    }\n\n    if (options.json) {\n      console.log(JSON.stringify(result))\n    }\n    if (!options.json) {\n      printSummary(result)\n    }\n  } catch (error) {\n    if (options.json) {\n      log('Snapshot failed')\n    }\n    if (!options.json) {\n      spinner?.stop('Snapshot failed')\n    }\n    throw error\n  } finally {\n    if (options.json) {\n      log('Disconnecting from Kubb Studio')\n    }\n    client.disconnect()\n  }\n}\n\nexport const runner: CommandRunner<{ args: typeof definition.args; extensions: {} }> = async ({ values }) => {\n  const options: SnapshotOptions = {\n    ...createStudioOptions(values),\n    token: values.token,\n    id: values.id,\n    name: values.name,\n    packageVersion: values.packageVersion,\n    timeout: values.timeout,\n    json: values.json,\n  }\n  await run(options, () => snapshot(options), { json: options.json })\n}\n"],"mappings":"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"}

package/dist/snapshot-Dhwz_MpL.js

@@ -0,0 +1,260 @@
+import "./rolldown-runtime-C0LytTxp.js";
+import { a as run, c as exists, l as read, n as createStudioOptions, r as loadConfigs } from "./run-Bd-IwEch.js";
+import { r as logBlock, t as createSpinner } from "./output-CdnsdD1b.js";
+import { styleText } from "node:util";
+import process from "node:process";
+import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
+import { logLevel } from "@kubb/core";
+import { createAgent, createClient, createJob, machineTokenFrom, waitForJob } from "@kubb/studio";
+//#region src/runners/studio/ci.ts
+function readGithubPullRequestNumber(eventPath) {
+	if (!eventPath) return;
+	try {
+		const event = JSON.parse(readFileSync(eventPath, "utf8"));
+		return event.pull_request?.number ? String(event.pull_request.number) : void 0;
+	} catch {
+		return;
+	}
+}
+/**
+* Detects the CI provider from its environment variables and derives a stable identity from it.
+* The GitHub row reproduces `gh:<repositoryId>:<prNumber>`, the identity `kubb-labs/action` has
+* always registered agents under, so an existing repository keeps reusing its agent.
+*/
+function detectCi(env = process.env) {
+	if (env.GITHUB_ACTIONS) {
+		const pullRequestNumber = readGithubPullRequestNumber(env.GITHUB_EVENT_PATH);
+		const repositoryId = env.GITHUB_REPOSITORY_ID ?? env.GITHUB_REPOSITORY ?? "";
+		const scope = pullRequestNumber ?? env.GITHUB_RUN_ID ?? "";
+		return {
+			id: `gh:${repositoryId}:${scope}`,
+			name: `${env.GITHUB_REPOSITORY ?? "github"}#${scope}`
+		};
+	}
+	if (env.GITLAB_CI) {
+		const scope = env.CI_MERGE_REQUEST_IID ?? env.CI_COMMIT_REF_SLUG ?? "";
+		return {
+			id: `gl:${env.CI_PROJECT_ID ?? ""}:${scope}`,
+			name: `${env.CI_PROJECT_PATH ?? "gitlab"}#${scope}`
+		};
+	}
+	if (env.BITBUCKET_BUILD_NUMBER) {
+		const scope = env.BITBUCKET_PR_ID ?? env.BITBUCKET_BRANCH ?? "";
+		return {
+			id: `bb:${env.BITBUCKET_REPO_UUID ?? ""}:${scope}`,
+			name: `${env.BITBUCKET_REPO_FULL_NAME ?? "bitbucket"}#${scope}`
+		};
+	}
+	if (env.CIRCLECI) {
+		const owner = env.CIRCLE_PROJECT_USERNAME ?? "";
+		const project = env.CIRCLE_PROJECT_REPONAME ?? "circleci";
+		const scope = env.CIRCLE_PR_NUMBER ?? env.CIRCLE_BRANCH ?? "";
+		return {
+			id: `circle:${owner}:${project}:${scope}`,
+			name: `${owner ? `${owner}/` : ""}${project}#${scope}`
+		};
+	}
+	return null;
+}
+//#endregion
+//#region src/runners/studio/snapshot.ts
+/**
+* How long to wait for Studio's `studio:ready` acknowledgement, above the client's own 10s
+* handshake-ack timeout.
+*/
+const READY_TIMEOUT_MS = 15e3;
+/**
+* Longest `--timeout` accepted. Job records expire from Studio's storage after an hour.
+*/
+const MAX_TIMEOUT_SECONDS = 3600;
+const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
+	"localhost",
+	"127.0.0.1",
+	"::1"
+]);
+async function findPackageJson(startDirectory) {
+	let directory = startDirectory;
+	for (;;) {
+		const file = join(directory, "package.json");
+		if (await exists(file)) {
+			const packageJson = JSON.parse(await read(file));
+			if (packageJson.name && packageJson.version) return {
+				name: packageJson.name,
+				version: packageJson.version
+			};
+		}
+		const parent = dirname(directory);
+		if (parent === directory) break;
+		directory = parent;
+	}
+	throw new Error(`No package.json with a name and a version found above ${startDirectory}`);
+}
+/** Reads package.json only for whichever of name/version --name and --version did not supply. */
+async function resolvePackageMetadata(options) {
+	if (options.name && options.packageVersion) return {
+		name: options.name,
+		version: options.packageVersion
+	};
+	const packageMetadata = await findPackageJson(process.cwd());
+	return {
+		name: options.name ?? packageMetadata.name,
+		version: options.packageVersion ?? packageMetadata.version
+	};
+}
+function resolveToken(options) {
+	const token = options.token ?? process.env.KUBB_TOKEN;
+	if (!token) throw new Error("An organization CI API key is required. Pass --token or set KUBB_TOKEN.");
+	return token;
+}
+function resolveCiIdentity(options) {
+	const detected = detectCi();
+	if (options.id) return {
+		id: options.id,
+		name: detected?.name ?? options.id
+	};
+	if (!detected) throw new Error("Could not detect a supported CI provider (GitHub Actions, GitLab CI, Bitbucket Pipelines, CircleCI). Pass --id.");
+	return detected;
+}
+/** Rejects a bad `--timeout` up front instead of letting it reach `waitForJob` as NaN or <= 0. */
+function resolveTimeoutMs(options) {
+	const seconds = options.timeout ?? 600;
+	if (!Number.isFinite(seconds) || seconds <= 0) throw new Error("--timeout must be a positive number of seconds");
+	return Math.min(seconds, MAX_TIMEOUT_SECONDS) * 1e3;
+}
+/** The CI key is a credential, so refuse to send it anywhere but HTTPS or a loopback dev host. */
+function assertSecureStudioUrl(studioUrl) {
+	const url = new URL(studioUrl);
+	if (url.protocol !== "https:" && !LOOPBACK_HOSTS.has(url.hostname)) throw new Error(`Refusing to send the CI API key to ${studioUrl}. Use an https:// Studio URL, or a loopback host for local development.`);
+}
+function absoluteUrl(studioUrl, path) {
+	return new URL(path, `${studioUrl}/`).toString();
+}
+function toResult(studioUrl, snapshot, agentSlug) {
+	return {
+		id: snapshot.id,
+		name: snapshot.name,
+		version: snapshot.version,
+		integrity: snapshot.integrity,
+		url: absoluteUrl(studioUrl, snapshot.url),
+		snapshotIdUrl: absoluteUrl(studioUrl, snapshot.snapshotIdUrl),
+		expiresAt: snapshot.expiresAt,
+		agentUrl: absoluteUrl(studioUrl, `/agents/${agentSlug}`)
+	};
+}
+function printSummary(result) {
+	logBlock([
+		`${styleText("dim", "Package".padEnd(10))}  ${result.name ?? "(unnamed)"}@${result.version ?? "0.0.0"}`,
+		`${styleText("dim", "Tarball".padEnd(10))}  ${styleText("cyan", result.url)}`,
+		`${styleText("dim", "Agent".padEnd(10))}  ${result.agentUrl}`,
+		`${styleText("dim", "Expires".padEnd(10))}  ${result.expiresAt}`
+	]);
+}
+/**
+* Generates a Kubb Studio snapshot from a script: registers or reuses a CI agent, connects it,
+* queues a snapshot job, and polls until the tarball is ready. A snapshot job runs generation and
+* packs the tarball in one step, so this needs no separate generation run.
+*/
+async function snapshot(options) {
+	const timeoutMs = resolveTimeoutMs(options);
+	const token = resolveToken(options);
+	assertSecureStudioUrl(options.studioUrl);
+	const { configPath } = await loadConfigs(options);
+	const ci = resolveCiIdentity(options);
+	const { name, version: packageVersion } = await resolvePackageMetadata(options);
+	process.env.KUBB_AGENT_SECRET = ci.id;
+	const spinner = options.json ? null : createSpinner();
+	const log = (message) => {
+		if (options.json) {
+			console.error(message);
+			return;
+		}
+		spinner?.message(message);
+	};
+	if (options.json) log("Creating Kubb Studio agent");
+	if (!options.json) spinner?.start("Creating Kubb Studio agent");
+	const agent = await createAgent({
+		studioUrl: options.studioUrl,
+		token,
+		name: ci.name,
+		machineToken: machineTokenFrom(ci.id)
+	});
+	const { promise: ready, reject: markFailed, resolve: markReady } = Promise.withResolvers();
+	const client = createClient({
+		studioUrl: options.studioUrl,
+		token: agent.token,
+		configPath,
+		root: process.cwd(),
+		version: options.version,
+		client: { kind: "cli" },
+		logLevel: logLevel[options.logLevel ?? "info"],
+		loadConfig: async () => (await loadConfigs(options)).config,
+		installLogger: (hooks) => {
+			hooks.hook("studio:connecting", ({ url }) => log(`Connecting to Kubb Studio at ${url}`));
+			hooks.hook("studio:connected", ({ url }) => log(`Connected to Kubb Studio at ${url}`));
+			hooks.hook("studio:ready", () => {
+				log("Kubb Studio connection ready");
+				markReady();
+			});
+			hooks.hook("studio:warn", ({ message }) => log(`Kubb Studio warning: ${message}`));
+			hooks.hook("studio:error", ({ error }) => markFailed(error));
+		}
+	});
+	await client.connect();
+	try {
+		let readyTimeoutHandle;
+		try {
+			await Promise.race([ready, new Promise((_, reject) => {
+				readyTimeoutHandle = setTimeout(() => reject(/* @__PURE__ */ new Error("Timed out waiting for Kubb Studio to confirm the agent was ready")), READY_TIMEOUT_MS);
+			})]);
+		} finally {
+			clearTimeout(readyTimeoutHandle);
+		}
+		log("Creating snapshot job");
+		const job = await createJob({
+			studioUrl: options.studioUrl,
+			token,
+			type: "snapshot",
+			agentId: agent.id,
+			name,
+			version: packageVersion
+		});
+		log(`Snapshot job queued: ${job.id}`);
+		const finished = await waitForJob({
+			studioUrl: options.studioUrl,
+			token,
+			id: job.id,
+			timeoutMs
+		});
+		if (finished.status === "failed") throw new Error(finished.error ?? "Snapshot job failed");
+		if (!finished.snapshot) throw new Error("Snapshot job succeeded without a snapshot");
+		const result = toResult(options.studioUrl, finished.snapshot, agent.slug);
+		if (options.json) log("Snapshot published");
+		if (!options.json) spinner?.stop("Snapshot published");
+		if (options.json) console.log(JSON.stringify(result));
+		if (!options.json) printSummary(result);
+	} catch (error) {
+		if (options.json) log("Snapshot failed");
+		if (!options.json) spinner?.stop("Snapshot failed");
+		throw error;
+	} finally {
+		if (options.json) log("Disconnecting from Kubb Studio");
+		client.disconnect();
+	}
+}
+const runner = async ({ values }) => {
+	const options = {
+		...createStudioOptions(values),
+		token: values.token,
+		id: values.id,
+		name: values.name,
+		packageVersion: values.packageVersion,
+		timeout: values.timeout,
+		json: values.json
+	};
+	await run(options, () => snapshot(options), { json: options.json });
+};
+//#endregion
+export { runner };
+
+//# sourceMappingURL=snapshot-Dhwz_MpL.js.map