@kubb/studio 5.12.2 → 5.12.4

package/dist/index.cjs

@@ -24,6 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 const require_protocol = require("./protocol.cjs");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
+let node_fs_promises = require("node:fs/promises");
 let node_module = require("node:module");
 let node_os = require("node:os");
 let node_path = require("node:path");
@@ -32,7 +33,6 @@ let node_process = require("node:process");
 node_process = __toESM(node_process, 1);
 let node_timers_promises = require("node:timers/promises");
 let tinyexec = require("tinyexec");
-let node_fs_promises = require("node:fs/promises");
 let _kubb_core = require("@kubb/core");
 let capnweb = require("capnweb");
 let magicast = require("magicast");
@@ -230,7 +230,7 @@ function getElapsedMs(hrStart) {
 }
 //#endregion
 //#region package.json
-var version = "5.12.2";
+var version = "5.12.4";
 //#endregion
 //#region src/resolveConfig.ts
 /**
@@ -586,6 +586,44 @@ async function rebuildExtension({ disk, studioOptions, kind, extensions }) {
 		});
 	}))(mergeOptions(disk.options ?? {}, studioOptions));
 }
+/** The root `output` members Studio may set, with the values each takes. The rest, `path` and `postGenerate` among them, stay with the config file. */
+const OUTPUT_VALUES = {
+	barrel: (value) => value === false || isPlainObject(value) && Object.keys(value).length === 1 && (value.type === "named" || value.type === "all"),
+	format: (value) => value === false || [
+		"auto",
+		"prettier",
+		"biome",
+		"oxfmt"
+	].includes(value),
+	lint: (value) => value === false || [
+		"auto",
+		"eslint",
+		"biome",
+		"oxlint"
+	].includes(value),
+	clean: (value) => typeof value === "boolean",
+	defaultBanner: (value) => value === false || value === "simple" || value === "full"
+};
+/** Whether Studio may set the root `output` member `key`. */
+function isOutputKey(key) {
+	return Object.hasOwn(OUTPUT_VALUES, key);
+}
+/** Whether Studio may set the root `output` member `key` to `value`. */
+function isOutputValue({ key, value }) {
+	return isOutputKey(key) && OUTPUT_VALUES[key](value);
+}
+/** The members of `output` Studio may see and set. */
+function pickOutput(output) {
+	return Object.fromEntries(Object.entries(output).filter(([key]) => isOutputKey(key)));
+}
+/** Merges Studio's valid `output` overrides, with `null` unsetting a member. */
+function mergeOutput({ output, studio }) {
+	if (!isPlainObject(studio)) return output;
+	return mergeOptions(output, Object.fromEntries(Object.entries(studio).filter(([key, value]) => value === null ? isOutputKey(key) : isOutputValue({
+		key,
+		value
+	}))));
+}
 /**
 * Merges Studio-provided adapter option overrides into the disk config's adapter, see {@link rebuildExtension}.
 */
@@ -628,13 +666,7 @@ const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
 * line count, so `enable-plugin` restores exactly those lines and not whatever comments follow.
 */
 const DISABLED_MARKER = /^\/\/ kubb:disabled (.+)\s+(\d+)$/;
-const OPERATIONS = /* @__PURE__ */ new Set([
-	"set",
-	"remove",
-	"add-plugin",
-	"disable-plugin",
-	"enable-plugin"
-]);
+const OPERATIONS = new Set(Object.values(require_protocol.ConfigEditOperation));
 const KINDS = /* @__PURE__ */ new Set([
 	"plugin",
 	"adapter",
@@ -645,17 +677,20 @@ const KINDS = /* @__PURE__ */ new Set([
 * The edit crossed the wire, so its declared type is a promise the sender may not have kept.
 */
 function invalidEdit(edit) {
-	const { operation, plugin, config, path, kind } = typeof edit === "object" && edit !== null ? edit : {};
+	const { operation, plugin, config, path, kind, input } = typeof edit === "object" && edit !== null ? edit : {};
 	if (typeof operation !== "string" || !OPERATIONS.has(operation)) return `unknown operation ${JSON.stringify(operation)}`;
-	if (typeof plugin !== "string" || !plugin) return "the edit names no plugin";
-	if (kind !== void 0 && (typeof kind !== "string" || !KINDS.has(kind))) return `unknown kind ${JSON.stringify(kind)}`;
-	if (kind !== void 0 && operation !== "set" && operation !== "remove") return `${operation} edits the plugins array, so it takes no kind`;
 	if (config !== void 0 && typeof config !== "string" && !Number.isSafeInteger(config)) return "config must name an entry or give its index";
-	if (operation === "set" || operation === "remove") {
+	if (operation === require_protocol.ConfigEditOperation.SET_INPUT) return typeof input === "string" && input.trim() ? void 0 : "the edit names no input";
+	const isOutput = operation === require_protocol.ConfigEditOperation.SET_OUTPUT || operation === require_protocol.ConfigEditOperation.REMOVE_OUTPUT;
+	if (!isOutput && (typeof plugin !== "string" || !plugin)) return "the edit names no plugin";
+	if (kind !== void 0 && (typeof kind !== "string" || !KINDS.has(kind))) return `unknown kind ${JSON.stringify(kind)}`;
+	if (kind !== void 0 && operation !== require_protocol.ConfigEditOperation.SET && operation !== require_protocol.ConfigEditOperation.REMOVE) return `${operation} edits the plugins array, so it takes no kind`;
+	if (isOutput || operation === require_protocol.ConfigEditOperation.SET || operation === require_protocol.ConfigEditOperation.REMOVE) {
 		if (!Array.isArray(path) || !path.every((key) => typeof key === "string" && key)) return "path must be a list of option names";
 		if (!path.length) return "no option path given";
 		const unsafe = path.find((key) => !isSafeKey(key));
 		if (unsafe !== void 0) return `${unsafe} cannot be used as an option name`;
+		if (isOutput && !isOutputKey(path[0])) return `output.${path[0]} can only be changed in the config file`;
 	}
 }
 /** Where a node sits in the source text. */
@@ -956,9 +991,12 @@ function readPartial(node, prefix = []) {
 }
 /** The top-level options of a plugin call, each flagged with whether Studio may write it. */
 function readOptions(call) {
-	const entries = {};
 	const options = call.arguments[0];
-	if (options?.type !== "ObjectExpression") return entries;
+	return options?.type === "ObjectExpression" ? readObject(options) : {};
+}
+/** The members of an object literal, each flagged with whether Studio may write it. */
+function readObject(options) {
+	const entries = {};
 	for (const [index, entry] of options.properties.entries()) {
 		const key = memberKey(entry);
 		if (key === void 0 || !isSafeKey(key)) continue;
@@ -1031,11 +1069,13 @@ function readConfig(source) {
 			});
 			const [adapter] = factoryCalls(mod, config, "adapter").map(toView);
 			const parsers = factoryCalls(mod, config, "parser").map(toView);
+			const output = outputObject(config);
 			return {
 				name: configName(config),
 				plugins,
 				...adapter && { adapter },
-				...parsers.length ? { parsers } : {}
+				...parsers.length ? { parsers } : {},
+				...!("reason" in output) && { output: pickOutput(readObject(output.object)) }
 			};
 		})
 	};
@@ -1084,6 +1124,16 @@ function applySet(source, call, path, value, quote) {
 		return { source: splice(source, closing, closing, printValue(nest(path, value), quote)) };
 	}
 	if (options.type !== "ObjectExpression") return { reason: "the factory was not called with an object literal" };
+	return setIn({
+		source,
+		options,
+		path,
+		value,
+		quote
+	});
+}
+/** Writes the literal `value` at `path` inside `options`, adding any intermediate object it needs. */
+function setIn({ source, options, path, value, quote }) {
 	const target = walk(options, path);
 	if ("reason" in target) return target;
 	if ("missing" in target) {
@@ -1092,6 +1142,43 @@ function applySet(source, call, path, value, quote) {
 	}
 	return { source: splice(source, rangeOf(target.value).start, rangeOf(target.value).end, printValue(value, quote)) };
 }
+/** Writes the config's top-level `input` as a string literal, replacing what it held. */
+function applySetInput(source, config, input, quote) {
+	const value = printValue(input, quote);
+	const found = findMember(config, "input");
+	if (!found) return { source: insertItem(source, config, `input: ${value}`) };
+	if (found.member.type !== "ObjectProperty") return { reason: "input is not a plain property" };
+	if (isShadowed(config, found.index)) return { reason: "a spread after input could override it" };
+	return { source: splice(source, rangeOf(found.member.value).start, rangeOf(found.member.value).end, value) };
+}
+/** The config's root `output` object literal, or why Studio cannot edit inside it. */
+function outputObject(config) {
+	const found = findMember(config, "output");
+	if (found?.member.type !== "ObjectProperty" || found.member.value.type !== "ObjectExpression") return { reason: "output is not an object literal" };
+	if (isShadowed(config, found.index)) return { reason: "a spread after output could override it" };
+	return { object: found.member.value };
+}
+/** Writes or drops a member of the config's root `output` object. */
+function applyOutputEdit({ source, config, edit, quote }) {
+	const output = outputObject(config);
+	if ("reason" in output) return output;
+	if (edit.operation === require_protocol.ConfigEditOperation.REMOVE_OUTPUT) return removeIn({
+		source,
+		options: output.object,
+		path: edit.path
+	});
+	if (!isOptionValue(edit.value) || !isOutputValue({
+		key: edit.path[0],
+		value: nest(edit.path.slice(1), edit.value)
+	})) return { reason: `the value is not one output.${edit.path[0]} takes` };
+	return setIn({
+		source,
+		options: output.object,
+		path: edit.path,
+		value: edit.value,
+		quote
+	});
+}
 /**
 * Deletes the option at `path`, falling the plugin back to its default for it. An option the file
 * does not set already has its default, so removing it changes nothing.
@@ -1100,6 +1187,14 @@ function applyRemove(source, call, path) {
 	const options = call.arguments[0];
 	if (!options) return { source };
 	if (options.type !== "ObjectExpression") return { reason: "the factory was not called with an object literal" };
+	return removeIn({
+		source,
+		options,
+		path
+	});
+}
+/** Deletes the member at `path` inside `options`. A path that is not there already holds its default. */
+function removeIn({ source, options, path }) {
 	const target = walk(options, path);
 	if ("reason" in target) return target;
 	if ("missing" in target) return { source };
@@ -1188,7 +1283,14 @@ function applyEdit({ source, edit, quote, extensions }) {
 	const findConfig = (entries) => typeof ref === "string" ? entries.configs.find((entry) => configName(entry) === ref) : entries.configs[ref ?? 0];
 	const config = findConfig(parsed);
 	if (!config) return { reason: `no config entry found for ${JSON.stringify(ref)}` };
-	if (edit.operation === "disable-plugin") {
+	if (edit.operation === require_protocol.ConfigEditOperation.SET_INPUT) return applySetInput(source, config, edit.input, quote);
+	if (edit.operation === require_protocol.ConfigEditOperation.SET_OUTPUT || edit.operation === require_protocol.ConfigEditOperation.REMOVE_OUTPUT) return applyOutputEdit({
+		source,
+		config,
+		edit,
+		quote
+	});
+	if (edit.operation === require_protocol.ConfigEditOperation.DISABLE_PLUGIN) {
 		const result = disablePlugin(source, parsed.mod, config, edit.plugin);
 		if (!("reason" in result) || !result.reason.includes("shares a line")) return result;
 		const expanded = expandPluginsArray(source, config);
@@ -1196,8 +1298,8 @@ function applyEdit({ source, edit, quote, extensions }) {
 		const reparsedConfig = reparsed && !("reason" in reparsed) ? findConfig(reparsed) : void 0;
 		return expanded !== void 0 && reparsed && !("reason" in reparsed) && reparsedConfig ? disablePlugin(expanded, reparsed.mod, reparsedConfig, edit.plugin) : result;
 	}
-	if (edit.operation === "enable-plugin") return enablePlugin(source, config, edit.plugin);
-	if (edit.operation === "add-plugin") return applyAddPlugin({
+	if (edit.operation === require_protocol.ConfigEditOperation.ENABLE_PLUGIN) return enablePlugin(source, config, edit.plugin);
+	if (edit.operation === require_protocol.ConfigEditOperation.ADD_PLUGIN) return applyAddPlugin({
 		source,
 		parsed,
 		config,
@@ -1213,7 +1315,7 @@ function applyEdit({ source, edit, quote, extensions }) {
 		if (kind === "adapter") return { reason: `${edit.plugin} is not the config's adapter` };
 		return { reason: kind === "plugin" && disabledBlocks(source, config).some((block) => block.packageName === edit.plugin) ? `${edit.plugin} is disabled, enable it first` : `${edit.plugin} is not in the ${kind}s array` };
 	}
-	return edit.operation === "set" ? applySet(source, call, edit.path, edit.value, quote) : applyRemove(source, call, edit.path);
+	return edit.operation === require_protocol.ConfigEditOperation.SET ? applySet(source, call, edit.path, edit.value, quote) : applyRemove(source, call, edit.path);
 }
 /**
 * Applies edits to a `kubb.config.ts` in place. Each edit rewrites only the text it targets, so
@@ -2151,6 +2253,7 @@ var Agent = class extends capnweb.RpcTarget {
 			allowConfigEdit: false,
 			allowInstall: false,
 			allowUpdate: false,
+			allowSaveInput: false,
 			allowRead: true,
 			allowReadAst: true
 		} : permissions;
@@ -2176,13 +2279,13 @@ var Agent = class extends capnweb.RpcTarget {
 			permission
 		});
 	}
-	async #refuse({ message, permission }) {
+	async #refuse({ message, permission, code = _kubb_core.Diagnostics.code.unknown }) {
 		await this.#warn({
 			message,
 			permission
 		});
 		throw new _kubb_core.Diagnostics.Error({
-			code: _kubb_core.Diagnostics.code.unknown,
+			code,
 			severity: "error",
 			message
 		});
@@ -2374,12 +2477,22 @@ var Agent = class extends capnweb.RpcTarget {
 		});
 		const activePlugins = plugins ?? config.plugins;
 		if (patch?.input && !this.#sandbox && !this.#managed) await emit(this.#options.hooks, "kubb:warn", { message: "Ignored the spec from Studio: generating from a Studio spec is only available to a sandbox or managed agent" });
-		const checkout = this.#managed && studioInput !== void 0 && (0, _kubb_core.getInputKind)(studioInput) === "git" ? await (0, _kubb_core.checkoutGitInput)(studioInput, signal, { publicOnly: true }).catch((error) => this.#refuse({ message: getErrorMessage(error) })) : void 0;
+		const checkout = this.#managed && studioInput !== void 0 && (0, _kubb_core.getInputKind)(studioInput) === "git" ? await (0, _kubb_core.checkoutGitInput)(studioInput, signal, {
+			publicOnly: true,
+			authorization: input.gitAuth?.authorization
+		}).catch((error) => this.#refuse({
+			message: getErrorMessage(error),
+			code: _kubb_core.Diagnostics.code.gitInputFailed
+		})) : void 0;
 		const run = () => generate({
 			config: {
 				...config,
 				root,
 				input: checkout?.path ?? studioInput ?? config.input,
+				output: mergeOutput({
+					output: config.output,
+					studio: patch?.output
+				}),
 				storage: outputRoot ? stagingStorage({
 					root,
 					directory: outputRoot
@@ -2448,11 +2561,29 @@ var Agent = class extends capnweb.RpcTarget {
 		if (busy) return refuse(busy);
 		this.#session.saving = true;
 		try {
-			const { outcomes, changed } = await writeConfigEdits({
+			const kept = [];
+			for (const edit of edits) kept.push(await this.#keepInput(edit));
+			const written = await writeConfigEdits({
 				filePath: configFile,
-				edits,
+				edits: kept.flatMap((edit) => "reason" in edit ? [] : [edit]),
 				extensions: await this.#installedExtensions()
 			});
+			let next = 0;
+			const outcomes = kept.map((edit, index) => "reason" in edit ? {
+				edit: edits[index],
+				applied: false,
+				reason: edit.reason
+			} : {
+				...written.outcomes[next++],
+				edit: edits[index]
+			});
+			let wroteDocument = false;
+			for (const [index, edit] of kept.entries()) {
+				if (!("document" in edit) || !edit.document || !outcomes[index].applied) continue;
+				await (0, node_fs_promises.writeFile)(node_path.default.join(this.#options.root, edit.document.fileName), edit.document.text, "utf-8");
+				wroteDocument = true;
+			}
+			const changed = written.changed || wroteDocument;
 			const applied = outcomes.filter((outcome) => outcome.applied).length;
 			await this.#logCommand("saveConfig", `applied ${applied}/${outcomes.length} edits to ${configPath}`, input.requestedBy);
 			return {
@@ -2467,6 +2598,33 @@ var Agent = class extends capnweb.RpcTarget {
 		}
 	}
 	/**
+	* Readies a `set-input` edit for the config file: a document is pointed at `openapi.yaml` (`openapi.json`
+	* for JSON) in the project, one file per config entry, for `saveConfig` to write once the edit applies.
+	* A managed agent refuses a file path, as in a generation.
+	*/
+	async #keepInput(edit) {
+		if (edit?.operation !== require_protocol.ConfigEditOperation.SET_INPUT || typeof edit.input !== "string" || !edit.input.trim()) return edit;
+		if (!this.#permissions.allowSaveInput) {
+			await this.#warn({
+				message: "Ignored the spec to save: saving the input was not granted",
+				permission: require_protocol.AgentPermission.SAVE_INPUT
+			});
+			return { reason: "the agent was not granted permission to save the input" };
+		}
+		const kind = (0, _kubb_core.getInputKind)(edit.input);
+		if (this.#managed && !MANAGED_INPUT_KINDS.has(kind)) return { reason: require_protocol.AgentMessage.MANAGED_INPUT_KIND };
+		if (kind !== "inline") return edit;
+		const fileName = `openapi${edit.config === void 0 || edit.config === 0 ? "" : `-${String(edit.config).replace(/[^\w.-]/g, "-")}`}.${isJson(edit.input) ? "json" : "yaml"}`;
+		return {
+			...edit,
+			input: `./${fileName}`,
+			document: {
+				fileName,
+				text: edit.input
+			}
+		};
+	}
+	/**
 	* Installs a registry extension into the project with `kubb add <id> --yes`, which also adds a
 	* plugin to `kubb.config.ts`. Studio calls `connect()` again afterwards to see the result.
 	*/
@@ -2767,6 +2925,15 @@ function pickConfig(configs, ref) {
 	if (ref !== void 0 && !Number.isSafeInteger(ref)) return void 0;
 	return configs[ref ?? 0];
 }
+/** Whether `text` parses as JSON, so a pasted document is saved under the matching extension. */
+function isJson(text) {
+	try {
+		JSON.parse(text);
+		return true;
+	} catch {
+		return false;
+	}
+}
 /** The input path or URL Studio may show: no inline document, and no credentials from a URL. */
 function reportedInput(input) {
 	if (typeof input !== "string") return void 0;
@@ -2785,6 +2952,7 @@ function toEntryView(config, extensions) {
 		...config.name !== void 0 && { name: config.name },
 		...input !== void 0 && { input },
 		output: config.output.path,
+		outputOptions: toJSONOptions(pickOutput(config.output)),
 		plugins: config.plugins.map((plugin) => ({
 			name: toStudioName({
 				name: (0, _kubb_core.resolveMeta)(plugin).name,
@@ -2822,6 +2990,7 @@ async function runAgent({ options, openRpc }) {
 			allowConfigEdit: false,
 			allowInstall: false,
 			allowUpdate: false,
+			allowSaveInput: false,
 			allowExec: false,
 			allowRead: false,
 			allowReadAst: false,