@znight/openapi 0.0.0-stage → 0.1.1

package/dist/emit-child.mjs

@@ -0,0 +1,124 @@
+import { n as buildOpenApiDocument } from "./build-DXunOzlI.mjs";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+import { readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+// src/emit/child.ts
+const payload = JSON.parse(readFileSync(process.argv[2] ?? "", "utf8"));
+/** Imports a package as installed in the project (falls back to `@znight/openapi`'s resolution). */
+function importFromProject(specifier) {
+	let resolved;
+	try {
+		resolved = createRequire(join(payload.root, "package.json")).resolve(specifier);
+	} catch {
+		resolved = void 0;
+	}
+	return resolved === void 0 ? import(specifier) : import(pathToFileURL(resolved).href);
+}
+function convertersOf(module, file) {
+	const value = module?.default;
+	if (!Array.isArray(value) || value.some((converter) => typeof converter?.convert !== "function")) throw new Error(`${file} must export an array of SchemaConverter as default export`);
+	return value;
+}
+async function loadWithBun() {
+	const compiler = await importFromProject("@znight/compiler");
+	const config = await compiler.loadZnightConfig(payload.root);
+	const options = config.file === void 0 ? payload.compilerOptions : config.options;
+	await compiler.createPreload({
+		...options,
+		root: payload.root,
+		mode: "serve",
+		logLevel: "silent"
+	});
+	const module = await import(pathToFileURL(payload.outFile).href);
+	const converters = payload.converters === void 0 ? [] : convertersOf(await import(pathToFileURL(payload.converters).href), payload.converters);
+	return {
+		metadata: module.__ZNIGHT_METADATA__,
+		converters,
+		close: async () => {}
+	};
+}
+async function loadWithVite() {
+	const vite = await importFromProject("vite");
+	const plugins = [];
+	if (payload.viteConfig === false) {
+		const compiler = await importFromProject("@znight/compiler");
+		plugins.push(compiler.znight({
+			...payload.compilerOptions,
+			root: payload.root
+		}));
+	}
+	const server = await vite.createServer({
+		root: payload.root,
+		configFile: payload.viteConfig,
+		...payload.configLoader === void 0 ? {} : { configLoader: payload.configLoader },
+		appType: "custom",
+		logLevel: "error",
+		clearScreen: false,
+		server: {
+			middlewareMode: true,
+			hmr: false,
+			watch: null,
+			ws: false
+		},
+		plugins,
+		...payload.sourceConditions === true ? { environments: { ssr: { resolve: {
+			conditions: [
+				"@znight/source",
+				"module",
+				"node",
+				"development|production"
+			],
+			externalConditions: ["@znight/source", "node"]
+		} } } } : {}
+	});
+	try {
+		const environment = server.environments["ssr"];
+		if (typeof vite.isRunnableDevEnvironment === "function" && !vite.isRunnableDevEnvironment(environment)) throw new Error("the ssr environment of the Vite config cannot run modules (isRunnableDevEnvironment)");
+		const runner = environment.runner;
+		if (runner === void 0) throw new Error("the ssr environment of the Vite config has no module runner");
+		const module = await runner.import(payload.outFile);
+		const converters = payload.converters === void 0 ? [] : convertersOf(await runner.import(payload.converters), payload.converters);
+		return {
+			metadata: module.__ZNIGHT_METADATA__,
+			converters,
+			close: () => server.close()
+		};
+	} catch (error) {
+		await server.close();
+		throw error;
+	}
+}
+let result;
+try {
+	const loaded = payload.runtime === "bun" ? await loadWithBun() : await loadWithVite();
+	try {
+		const built = await buildOpenApiDocument(loaded.metadata, {
+			...payload.prefix === void 0 ? {} : { prefix: payload.prefix },
+			converters: loaded.converters
+		});
+		result = {
+			ok: true,
+			json: built.json,
+			warnings: built.warnings,
+			stats: built.stats
+		};
+	} finally {
+		await loaded.close();
+	}
+} catch (error) {
+	const details = error;
+	result = {
+		ok: false,
+		error: {
+			code: typeof details.code === "string" ? details.code : void 0,
+			message: error instanceof Error ? error.message : String(error),
+			hints: Array.isArray(details.hints) ? details.hints : []
+		}
+	};
+}
+writeFileSync(payload.result, JSON.stringify(result));
+process.exit(0);
+export {};
+
+//# sourceMappingURL=emit-child.mjs.map

package/dist/emit-child.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-child.mjs","names":[],"sources":["../src/emit/child.ts"],"sourcesContent":["/**\n * The child process of `emitOpenApi()` (§7.5 of RFC 0002): loads the generated module of the\n * application (nothing is instantiated: no container, no plugin, no port), builds the document and\n * writes the result as JSON. Module side effects and globals stay in this process.\n *\n * - Bun: the compiler's preload serves the generated module and blanks the decorators.\n * - Node.js: a Vite server in middleware mode runs the module with the project config (the\n *   `znight()` plugin serves the generated module from memory).\n *\n * Usage: `<runtime> child <payload.json>` (the payload says where to write the result).\n */\nimport type { ZnightMetadata } from '@znight/core'\nimport type { SchemaConverter } from '../converters.ts'\nimport type { ChildPayload, ChildResult } from './protocol.ts'\n\nimport { readFileSync, writeFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { join } from 'node:path'\nimport { pathToFileURL } from 'node:url'\n\nimport { buildOpenApiDocument } from '../build.ts'\n\nconst payload = JSON.parse(readFileSync(process.argv[2] ?? '', 'utf8')) as ChildPayload\n\n/** Imports a package as installed in the project (falls back to `@znight/openapi`'s resolution). */\nfunction importFromProject(specifier: string): Promise<unknown> {\n  let resolved: string | undefined\n  try {\n    resolved = createRequire(join(payload.root, 'package.json')).resolve(specifier)\n  } catch {\n    resolved = undefined\n  }\n  return import(resolved === undefined ? specifier : pathToFileURL(resolved).href)\n}\n\nfunction convertersOf(module: unknown, file: string): SchemaConverter[] {\n  const value = (module as { default?: unknown } | undefined)?.default\n  if (!Array.isArray(value) || value.some(converter => typeof (converter as SchemaConverter)?.convert !== 'function')) {\n    throw new Error(`${file} must export an array of SchemaConverter as default export`)\n  }\n  return value as SchemaConverter[]\n}\n\ninterface Loaded {\n  readonly metadata: ZnightMetadata\n  readonly converters: SchemaConverter[]\n  close(): Promise<void>\n}\n\nasync function loadWithBun(): Promise<Loaded> {\n  const compiler = (await importFromProject('@znight/compiler')) as {\n    createPreload(options: Record<string, unknown>): Promise<unknown>\n    loadZnightConfig(cwd: string): Promise<{ file: string | undefined; options: Record<string, unknown> }>\n  }\n  const config = await compiler.loadZnightConfig(payload.root)\n  const options = config.file === undefined ? payload.compilerOptions : config.options\n  await compiler.createPreload({ ...options, root: payload.root, mode: 'serve', logLevel: 'silent' })\n  const module = (await import(pathToFileURL(payload.outFile).href)) as { __ZNIGHT_METADATA__: ZnightMetadata }\n  const converters =\n    payload.converters === undefined\n      ? []\n      : convertersOf(await import(pathToFileURL(payload.converters).href), payload.converters)\n  return { metadata: module.__ZNIGHT_METADATA__, converters, close: async () => {} }\n}\n\ninterface ViteLike {\n  createServer(config: Record<string, unknown>): Promise<{\n    readonly environments: Record<string, unknown>\n    close(): Promise<void>\n  }>\n  isRunnableDevEnvironment?(environment: unknown): boolean\n}\n\nasync function loadWithVite(): Promise<Loaded> {\n  const vite = (await importFromProject('vite')) as ViteLike\n  const plugins: unknown[] = []\n  if (payload.viteConfig === false) {\n    const compiler = (await importFromProject('@znight/compiler')) as { znight(options: unknown): unknown }\n    plugins.push(compiler.znight({ ...payload.compilerOptions, root: payload.root }))\n  }\n  const server = await vite.createServer({\n    root: payload.root,\n    configFile: payload.viteConfig,\n    ...(payload.configLoader === undefined ? {} : { configLoader: payload.configLoader }),\n    appType: 'custom',\n    logLevel: 'error',\n    clearScreen: false,\n    server: { middlewareMode: true, hmr: false, watch: null, ws: false },\n    plugins,\n    ...(payload.sourceConditions === true\n      ? {\n          environments: {\n            ssr: {\n              resolve: {\n                conditions: ['@znight/source', 'module', 'node', 'development|production'],\n                externalConditions: ['@znight/source', 'node'],\n              },\n            },\n          },\n        }\n      : {}),\n  })\n  try {\n    const environment = server.environments['ssr'] as { runner?: { import(url: string): Promise<unknown> } }\n    if (typeof vite.isRunnableDevEnvironment === 'function' && !vite.isRunnableDevEnvironment(environment)) {\n      throw new Error('the ssr environment of the Vite config cannot run modules (isRunnableDevEnvironment)')\n    }\n    const runner = environment.runner\n    if (runner === undefined) throw new Error('the ssr environment of the Vite config has no module runner')\n    const module = (await runner.import(payload.outFile)) as { __ZNIGHT_METADATA__: ZnightMetadata }\n    const converters =\n      payload.converters === undefined ? [] : convertersOf(await runner.import(payload.converters), payload.converters)\n    return { metadata: module.__ZNIGHT_METADATA__, converters, close: () => server.close() }\n  } catch (error) {\n    await server.close()\n    throw error\n  }\n}\n\nlet result: ChildResult\ntry {\n  const loaded = payload.runtime === 'bun' ? await loadWithBun() : await loadWithVite()\n  try {\n    const built = await buildOpenApiDocument(loaded.metadata, {\n      ...(payload.prefix === undefined ? {} : { prefix: payload.prefix }),\n      converters: loaded.converters,\n    })\n    result = { ok: true, json: built.json, warnings: built.warnings, stats: built.stats }\n  } finally {\n    await loaded.close()\n  }\n} catch (error) {\n  const details = error as { code?: unknown; hints?: unknown; message?: unknown }\n  result = {\n    ok: false,\n    error: {\n      code: typeof details.code === 'string' ? details.code : undefined,\n      message: error instanceof Error ? error.message : String(error),\n      hints: Array.isArray(details.hints) ? (details.hints as string[]) : [],\n    },\n  }\n}\nwriteFileSync(payload.result, JSON.stringify(result))\nprocess.exit(0)\n"],"mappings":"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"}

package/dist/emit.d.mts

@@ -0,0 +1,2 @@
+import { a as findViteConfig, i as emitOpenApi, n as EmitOpenApiResult, r as EmitRuntime, t as EmitOpenApiOptions } from "./index-CqQ6IRnN.mjs";
+export { EmitOpenApiOptions, EmitOpenApiResult, EmitRuntime, emitOpenApi, findViteConfig };

package/dist/emit.mjs

@@ -0,0 +1,252 @@
+import { r as toYaml } from "./openapi-CQk5dHqc.mjs";
+import { createRequire } from "node:module";
+import { ErrorCode, ZnightError } from "@znight/core";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { spawn } from "node:child_process";
+import { tmpdir } from "node:os";
+// src/emit/index.ts
+const VITE_CONFIGS = [
+	"vite.config.js",
+	"vite.config.mjs",
+	"vite.config.ts",
+	"vite.config.cjs",
+	"vite.config.mts",
+	"vite.config.cts"
+];
+/** Compiles the application and writes (or checks) its OpenAPI document. */
+async function emitOpenApi(options = {}) {
+	const root = resolve(options.root ?? process.cwd());
+	const outputs = (typeof options.output === "string" ? [options.output] : options.output ?? ["openapi.json"]).map((file) => resolve(root, file));
+	const checked = checkedOutputs(root, outputs, options.check);
+	const runtime = resolveRuntime(options.runtime ?? "auto");
+	const compiler = await importFromProject(root, "@znight/compiler");
+	const viteConfig = findViteConfig(root, options.config);
+	const compilerOptions = options.compilerOptions ?? await resolveCompilerOptions(root, compiler, viteConfig, options.configLoader);
+	const compiled = await compiler.compile({
+		...compilerOptions,
+		root: resolve(root, String(compilerOptions["root"] ?? ".")),
+		mode: "serve"
+	});
+	const base = {
+		outputs,
+		runtime,
+		diagnostics: compiled.diagnostics
+	};
+	if (!compiled.ok) return {
+		...base,
+		ok: false,
+		written: [],
+		stale: false,
+		staleFiles: [],
+		document: void 0,
+		warnings: []
+	};
+	const converters = options.converters === void 0 ? void 0 : resolve(root, options.converters);
+	if (converters !== void 0 && !existsSync(converters)) throw new ZnightError(ErrorCode.InvalidOpenApiDefinition, `The converters module ${options.converters} does not exist`);
+	const result = await runChild({
+		root,
+		runtime,
+		outFile: compiled.outFile,
+		viteConfig: viteConfig ?? false,
+		...options.configLoader === void 0 ? {} : { configLoader: options.configLoader },
+		compilerOptions: jsonOnly(compilerOptions),
+		...converters === void 0 ? {} : { converters },
+		...options.prefix === void 0 ? {} : { prefix: options.prefix }
+	}, options.env ?? process.env);
+	if (!result.ok) {
+		const code = Object.values(ErrorCode).find((candidate) => candidate === result.error.code) ?? ErrorCode.SchemaConversionFailed;
+		const message = result.error.message.replace(/^ZNIGHT\d{3}: /, "");
+		throw new ZnightError(code, message, { hints: result.error.hints });
+	}
+	const document = JSON.parse(result.json);
+	const contents = /* @__PURE__ */ new Map();
+	for (const output of outputs) contents.set(output, /\.ya?ml$/i.test(output) ? await toYaml(document) : result.json);
+	const changed = outputs.filter((output) => readText(output) !== contents.get(output));
+	const staleFiles = changed.filter((output) => checked.has(output));
+	const written = [];
+	for (const output of changed) {
+		if (checked.has(output)) continue;
+		writeAtomically(output, contents.get(output) ?? "");
+		written.push(output);
+	}
+	return {
+		...base,
+		ok: true,
+		written,
+		stale: staleFiles.length > 0,
+		staleFiles,
+		document,
+		warnings: result.warnings
+	};
+}
+/** The outputs that `check` checks (absolute paths). */
+function checkedOutputs(root, outputs, check) {
+	if (check === void 0 || check === false) return /* @__PURE__ */ new Set();
+	if (check === true) return new Set(outputs);
+	const checked = new Set(check.map((file) => resolve(root, file)));
+	const unknown = check.filter((file) => !outputs.includes(resolve(root, file)));
+	if (unknown.length > 0) throw new ZnightError(ErrorCode.InvalidOpenApiDefinition, `check lists ${unknown.join(", ")}, which ${unknown.length > 1 ? "are not outputs" : "is not an output"}`, { hints: ["check: true checks every output; a list names outputs (relative to the root)"] });
+	return checked;
+}
+function resolveRuntime(runtime) {
+	if (runtime === "node" || runtime === "bun") return runtime;
+	return process.versions["bun"] === void 0 ? "node" : "bun";
+}
+/** The Vite config file of the project, if any. */
+function findViteConfig(root, config) {
+	if (config !== void 0) return resolve(root, config);
+	return VITE_CONFIGS.map((file) => join(root, file)).find((file) => existsSync(file));
+}
+async function resolveCompilerOptions(root, compiler, viteConfig, configLoader) {
+	const config = await compiler.loadZnightConfig?.(root);
+	if (config?.file !== void 0) {
+		const { logLevel: _logLevel, ...rest } = config.options;
+		return {
+			...rest,
+			root: resolve(root, String(rest["root"] ?? "."))
+		};
+	}
+	if (viteConfig === void 0) return { root };
+	const vite = await importFromProject(root, "vite");
+	if (typeof vite.resolveConfig !== "function") return { root };
+	const nodeEnv = process.env["NODE_ENV"];
+	let resolved;
+	try {
+		resolved = await vite.resolveConfig({
+			configFile: viteConfig,
+			root,
+			mode: "production",
+			logLevel: "silent",
+			...configLoader === void 0 ? {} : { configLoader }
+		}, "build", "production", "production");
+	} finally {
+		if (nodeEnv === void 0) delete process.env["NODE_ENV"];
+		else process.env["NODE_ENV"] = nodeEnv;
+	}
+	for (const plugin of resolved.plugins) {
+		const api = plugin.api;
+		if (plugin.name !== "znight" || api === void 0) continue;
+		const given = typeof api.options === "object" && api.options !== null ? api.options : {};
+		const compilerRoot = api.compiler?.options?.root;
+		return {
+			...given,
+			root: typeof compilerRoot === "string" ? compilerRoot : resolve(resolved.root, String(given["root"] ?? "."))
+		};
+	}
+	return { root };
+}
+async function importFromProject(root, specifier) {
+	let resolved;
+	try {
+		resolved = createRequire(join(root, "package.json")).resolve(specifier);
+	} catch {
+		resolved = void 0;
+	}
+	try {
+		return await (resolved === void 0 ? import(specifier) : import(pathToFileURL(resolved).href));
+	} catch (error) {
+		throw new ZnightError(ErrorCode.InvalidOpenApiDefinition, `Cannot load ${specifier}`, {
+			cause: error,
+			hints: [`Install it in the project: npm install -D ${specifier}`]
+		});
+	}
+}
+/** The JSON-compatible part of the compiler options (sent to the child process). */
+function jsonOnly(options) {
+	const result = {};
+	for (const [key, value] of Object.entries(options)) try {
+		const json = JSON.stringify(value);
+		if (json !== void 0 && JSON.stringify(JSON.parse(json)) === json && typeof value !== "function") result[key] = JSON.parse(json);
+	} catch {}
+	return result;
+}
+/** The script of the child process (source or built). */
+function childScript() {
+	const source = import.meta.url.endsWith(".ts");
+	return {
+		file: fileURLToPath(new URL(source ? "./child.ts" : "./emit-child.mjs", import.meta.url)),
+		source
+	};
+}
+function runChild(payload, env) {
+	const directory = mkdtempSync(join(tmpdir(), "znight-openapi-emit-"));
+	const payloadFile = join(directory, "payload.json");
+	const resultFile = join(directory, "result.json");
+	const script = childScript();
+	writeFileSync(payloadFile, JSON.stringify({
+		...payload,
+		...script.source ? { sourceConditions: true } : {},
+		result: resultFile
+	}));
+	const bun = process.versions["bun"] !== void 0;
+	let executable;
+	if (payload.runtime === "bun") executable = bun ? process.execPath : "bun";
+	else executable = bun ? "node" : process.execPath;
+	const args = [
+		...script.source ? ["--conditions=@znight/source"] : [],
+		script.file,
+		payloadFile
+	];
+	const childEnv = {};
+	for (const [key, value] of Object.entries(env)) if (value !== void 0) childEnv[key] = value;
+	childEnv["NODE_ENV"] ??= "production";
+	return new Promise((resolvePromise, reject) => {
+		const child = spawn(executable, args, {
+			cwd: payload.root,
+			env: childEnv,
+			stdio: [
+				"ignore",
+				"pipe",
+				"pipe"
+			]
+		});
+		let output = "";
+		child.stdout?.on("data", (chunk) => {
+			output += chunk.toString();
+		});
+		child.stderr?.on("data", (chunk) => {
+			output += chunk.toString();
+		});
+		child.on("error", (error) => {
+			rmSync(directory, {
+				recursive: true,
+				force: true
+			});
+			reject(new ZnightError(ErrorCode.InvalidOpenApiDefinition, `Cannot start ${executable} to load the application modules`, {
+				cause: error,
+				hints: [payload.runtime === "bun" ? "Install Bun, or use --runtime node" : "Install Node.js 24, or use --runtime bun"]
+			}));
+		});
+		child.on("close", (code) => {
+			const text = readText(resultFile);
+			rmSync(directory, {
+				recursive: true,
+				force: true
+			});
+			if (text === void 0) {
+				reject(new ZnightError(ErrorCode.InvalidOpenApiDefinition, `Loading the application modules failed (${executable} exited with code ${String(code)})${output.trim() === "" ? "" : `:\n${output.trim()}`}`));
+				return;
+			}
+			resolvePromise(JSON.parse(text));
+		});
+	});
+}
+function readText(file) {
+	try {
+		return readFileSync(file, "utf8");
+	} catch {
+		return;
+	}
+}
+/** Writes through a temporary file and a rename (readers never see a partial file). */
+function writeAtomically(file, content) {
+	mkdirSync(dirname(file), { recursive: true });
+	const temporary = `${file}.${process.pid}.tmp`;
+	writeFileSync(temporary, content);
+	renameSync(temporary, file);
+}
+export { emitOpenApi, findViteConfig };
+
+//# sourceMappingURL=emit.mjs.map

package/dist/emit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit.mjs","names":[],"sources":["../src/emit/index.ts"],"sourcesContent":["/**\n * `@znight/openapi/emit`: writes `openapi.json` (or YAML) at build time (§7.5 of RFC 0002), for\n * `znight openapi`, `znight build --openapi` and the `openapi()` Vite plugin.\n *\n * 1. the compiler options are resolved like `znight generate` does (`znight.config.*`, else the\n *    `znight()` plugin of the Vite config);\n * 2. `compile()` in `serve` mode: errors stop everything before any module runs;\n * 3. a **child process** loads the generated module (Bun: the compiler preload; Node.js: a Vite\n *    server in middleware mode) and runs `buildOpenApiDocument`;\n * 4. each output is written atomically, only when it changed; a checked output (`check`) is never\n *    written: when it is missing or stale, it is reported.\n */\nimport type { Diagnostic } from '@znight/compiler'\nimport type { OpenApiWarning } from '../build.ts'\nimport type { OpenApiObject } from '../types.ts'\nimport type { ChildPayload, ChildResult } from './protocol.ts'\n\nimport { spawn } from 'node:child_process'\nimport { existsSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'\nimport { createRequire } from 'node:module'\nimport { tmpdir } from 'node:os'\nimport { dirname, join, resolve } from 'node:path'\nimport { fileURLToPath, pathToFileURL } from 'node:url'\nimport { ErrorCode, ZnightError } from '@znight/core'\n\nimport { toYaml } from '../openapi.ts'\n\n/** Runtime loading the application modules: `'auto'` is the runtime running the caller. */\nexport type EmitRuntime = 'auto' | 'node' | 'bun'\n\n/** Options of {@link emitOpenApi}. */\nexport interface EmitOpenApiOptions {\n  /** Project root. Default `process.cwd()`. */\n  readonly root?: string\n  /** Output files, relative to `root`; `.yaml` / `.yml` write YAML (optional peer `yaml`). Default `'openapi.json'`. */\n  readonly output?: string | readonly string[]\n  /**\n   * Never write: report missing or stale outputs (`stale`, `staleFiles`). `true` checks every output;\n   * a list checks only these outputs (relative to `root`, each one an `output`) and writes the others\n   * as usual (the `openapi()` Vite plugin checks the committed file and writes the build output).\n   */\n  readonly check?: boolean | readonly string[]\n  /** The HTTP prefix: `servers` defaults to `[{ url: prefix }]` when `@OpenApiDocument` declares none. */\n  readonly prefix?: string\n  /** Default `'auto'`. */\n  readonly runtime?: EmitRuntime\n  /** Module (relative to `root`) whose default export is a `SchemaConverter[]`. */\n  readonly converters?: string\n  /** Vite config file (default: `vite.config.*` of the root). */\n  readonly config?: string\n  /** How Vite loads its config (`bundle`, `runner`, `native`). */\n  readonly configLoader?: string\n  /**\n   * The compiler options, already resolved (the CLI and the Vite plugin pass theirs). Default:\n   * `znight.config.*`, else the options of the `znight()` plugin of the Vite config.\n   */\n  readonly compilerOptions?: Readonly<Record<string, unknown>>\n  /** Environment of the child process. Default `process.env`, with `NODE_ENV` defaulting to `production`. */\n  readonly env?: Readonly<Record<string, string | undefined>>\n}\n\n/** Result of {@link emitOpenApi}. */\nexport interface EmitOpenApiResult {\n  /** `false` when the compile failed (see `diagnostics`): nothing ran and nothing was written. */\n  readonly ok: boolean\n  /** Outputs written (absolute paths); never a checked output. */\n  readonly written: readonly string[]\n  /** `check`: a checked output is missing or differs (listed in `staleFiles`). */\n  readonly stale: boolean\n  readonly staleFiles: readonly string[]\n  /** The document (`undefined` when the compile failed). */\n  readonly document: OpenApiObject | undefined\n  /** Compiler diagnostics (warnings included). */\n  readonly diagnostics: readonly Diagnostic[]\n  /** Warnings of the assembly (`unrepresentable: 'warn'`...). */\n  readonly warnings: readonly OpenApiWarning[]\n  /** Absolute paths of the outputs. */\n  readonly outputs: readonly string[]\n  readonly runtime: 'node' | 'bun'\n}\n\ninterface CompilerModule {\n  compile(options: Record<string, unknown>): Promise<{\n    readonly ok: boolean\n    readonly diagnostics: readonly Diagnostic[]\n    readonly outFile: string\n  }>\n  loadZnightConfig?(cwd: string): Promise<{ file: string | undefined; options: Record<string, unknown> }>\n}\n\nconst VITE_CONFIGS = [\n  'vite.config.js',\n  'vite.config.mjs',\n  'vite.config.ts',\n  'vite.config.cjs',\n  'vite.config.mts',\n  'vite.config.cts',\n]\n\n/** Compiles the application and writes (or checks) its OpenAPI document. */\nexport async function emitOpenApi(options: EmitOpenApiOptions = {}): Promise<EmitOpenApiResult> {\n  const root = resolve(options.root ?? process.cwd())\n  const outputs = (typeof options.output === 'string' ? [options.output] : (options.output ?? ['openapi.json'])).map(\n    file => resolve(root, file),\n  )\n  const checked = checkedOutputs(root, outputs, options.check)\n  const runtime = resolveRuntime(options.runtime ?? 'auto')\n  const compiler = (await importFromProject(root, '@znight/compiler')) as CompilerModule\n  const viteConfig = findViteConfig(root, options.config)\n  const compilerOptions =\n    options.compilerOptions ?? (await resolveCompilerOptions(root, compiler, viteConfig, options.configLoader))\n  const compiled = await compiler.compile({\n    ...compilerOptions,\n    root: resolve(root, String(compilerOptions['root'] ?? '.')),\n    mode: 'serve',\n  })\n  const base = { outputs, runtime, diagnostics: compiled.diagnostics }\n  if (!compiled.ok) {\n    return { ...base, ok: false, written: [], stale: false, staleFiles: [], document: undefined, warnings: [] }\n  }\n  const converters = options.converters === undefined ? undefined : resolve(root, options.converters)\n  if (converters !== undefined && !existsSync(converters)) {\n    throw new ZnightError(\n      ErrorCode.InvalidOpenApiDefinition,\n      `The converters module ${options.converters} does not exist`,\n    )\n  }\n  const result = await runChild(\n    {\n      root,\n      runtime,\n      outFile: compiled.outFile,\n      viteConfig: viteConfig ?? false,\n      ...(options.configLoader === undefined ? {} : { configLoader: options.configLoader }),\n      compilerOptions: jsonOnly(compilerOptions),\n      ...(converters === undefined ? {} : { converters }),\n      ...(options.prefix === undefined ? {} : { prefix: options.prefix }),\n    },\n    options.env ?? process.env,\n  )\n  if (!result.ok) {\n    const code =\n      Object.values(ErrorCode).find(candidate => candidate === result.error.code) ?? ErrorCode.SchemaConversionFailed\n    const message = result.error.message.replace(/^ZNIGHT\\d{3}: /, '')\n    throw new ZnightError(code, message, { hints: result.error.hints })\n  }\n  const document = JSON.parse(result.json) as OpenApiObject\n  const contents = new Map<string, string>()\n  for (const output of outputs) {\n    contents.set(output, /\\.ya?ml$/i.test(output) ? await toYaml(document) : result.json)\n  }\n  const changed = outputs.filter(output => readText(output) !== contents.get(output))\n  const staleFiles = changed.filter(output => checked.has(output))\n  const written: string[] = []\n  for (const output of changed) {\n    if (checked.has(output)) continue\n    writeAtomically(output, contents.get(output) ?? '')\n    written.push(output)\n  }\n  return {\n    ...base,\n    ok: true,\n    written,\n    stale: staleFiles.length > 0,\n    staleFiles,\n    document,\n    warnings: result.warnings,\n  }\n}\n\n/** The outputs that `check` checks (absolute paths). */\nfunction checkedOutputs(\n  root: string,\n  outputs: readonly string[],\n  check: EmitOpenApiOptions['check'],\n): ReadonlySet<string> {\n  if (check === undefined || check === false) return new Set()\n  if (check === true) return new Set(outputs)\n  const checked = new Set(check.map(file => resolve(root, file)))\n  const unknown = check.filter(file => !outputs.includes(resolve(root, file)))\n  if (unknown.length > 0) {\n    throw new ZnightError(\n      ErrorCode.InvalidOpenApiDefinition,\n      `check lists ${unknown.join(', ')}, which ${unknown.length > 1 ? 'are not outputs' : 'is not an output'}`,\n      { hints: ['check: true checks every output; a list names outputs (relative to the root)'] },\n    )\n  }\n  return checked\n}\n\nfunction resolveRuntime(runtime: EmitRuntime): 'node' | 'bun' {\n  if (runtime === 'node' || runtime === 'bun') return runtime\n  return process.versions['bun'] === undefined ? 'node' : 'bun'\n}\n\n/** The Vite config file of the project, if any. */\nexport function findViteConfig(root: string, config?: string): string | undefined {\n  if (config !== undefined) return resolve(root, config)\n  return VITE_CONFIGS.map(file => join(root, file)).find(file => existsSync(file))\n}\n\nasync function resolveCompilerOptions(\n  root: string,\n  compiler: CompilerModule,\n  viteConfig: string | undefined,\n  configLoader: string | undefined,\n): Promise<Record<string, unknown>> {\n  const config = await compiler.loadZnightConfig?.(root)\n  if (config?.file !== undefined) {\n    const { logLevel: _logLevel, ...rest } = config.options\n    return { ...rest, root: resolve(root, String(rest['root'] ?? '.')) }\n  }\n  if (viteConfig === undefined) return { root }\n  const vite = (await importFromProject(root, 'vite')) as {\n    resolveConfig?(\n      config: Record<string, unknown>,\n      command: string,\n      mode?: string,\n      env?: string,\n    ): Promise<{ plugins: readonly unknown[]; root: string }>\n  }\n  if (typeof vite.resolveConfig !== 'function') return { root }\n  const nodeEnv = process.env['NODE_ENV']\n  let resolved: { plugins: readonly unknown[]; root: string }\n  try {\n    resolved = await vite.resolveConfig(\n      {\n        configFile: viteConfig,\n        root,\n        mode: 'production',\n        logLevel: 'silent',\n        ...(configLoader === undefined ? {} : { configLoader }),\n      },\n      'build',\n      'production',\n      'production',\n    )\n  } finally {\n    if (nodeEnv === undefined) delete process.env['NODE_ENV']\n    else process.env['NODE_ENV'] = nodeEnv\n  }\n  for (const plugin of resolved.plugins) {\n    const api = (plugin as { name?: unknown; api?: { options?: unknown; compiler?: { options?: { root?: unknown } } } })\n      .api\n    if ((plugin as { name?: unknown }).name !== 'znight' || api === undefined) continue\n    const given =\n      typeof api.options === 'object' && api.options !== null ? (api.options as Record<string, unknown>) : {}\n    const compilerRoot = api.compiler?.options?.root\n    return {\n      ...given,\n      root: typeof compilerRoot === 'string' ? compilerRoot : resolve(resolved.root, String(given['root'] ?? '.')),\n    }\n  }\n  return { root }\n}\n\nasync function importFromProject(root: string, specifier: string): Promise<unknown> {\n  let resolved: string | undefined\n  try {\n    resolved = createRequire(join(root, 'package.json')).resolve(specifier)\n  } catch {\n    resolved = undefined\n  }\n  try {\n    return await import(resolved === undefined ? specifier : pathToFileURL(resolved).href)\n  } catch (error) {\n    throw new ZnightError(ErrorCode.InvalidOpenApiDefinition, `Cannot load ${specifier}`, {\n      cause: error,\n      hints: [`Install it in the project: npm install -D ${specifier}`],\n    })\n  }\n}\n\n/** The JSON-compatible part of the compiler options (sent to the child process). */\nfunction jsonOnly(options: Readonly<Record<string, unknown>>): Record<string, unknown> {\n  const result: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(options)) {\n    try {\n      const json = JSON.stringify(value)\n      if (json !== undefined && JSON.stringify(JSON.parse(json)) === json && typeof value !== 'function') {\n        result[key] = JSON.parse(json)\n      }\n    } catch {\n      // functions, extension objects: the child reads znight.config.* itself\n    }\n  }\n  return result\n}\n\n/** The script of the child process (source or built). */\nfunction childScript(): { file: string; source: boolean } {\n  const source = import.meta.url.endsWith('.ts')\n  return { file: fileURLToPath(new URL(source ? './child.ts' : './emit-child.mjs', import.meta.url)), source }\n}\n\nfunction runChild(\n  payload: Omit<ChildPayload, 'result'>,\n  env: Readonly<Record<string, string | undefined>>,\n): Promise<ChildResult> {\n  const directory = mkdtempSync(join(tmpdir(), 'znight-openapi-emit-'))\n  const payloadFile = join(directory, 'payload.json')\n  const resultFile = join(directory, 'result.json')\n  const script = childScript()\n  writeFileSync(\n    payloadFile,\n    JSON.stringify({\n      ...payload,\n      ...(script.source ? { sourceConditions: true } : {}),\n      result: resultFile,\n    } satisfies ChildPayload),\n  )\n  const bun = process.versions['bun'] !== undefined\n  let executable: string\n  if (payload.runtime === 'bun') executable = bun ? process.execPath : 'bun'\n  else executable = bun ? 'node' : process.execPath\n  const args = [...(script.source ? ['--conditions=@znight/source'] : []), script.file, payloadFile]\n  const childEnv: Record<string, string> = {}\n  for (const [key, value] of Object.entries(env)) if (value !== undefined) childEnv[key] = value\n  childEnv['NODE_ENV'] ??= 'production'\n  return new Promise<ChildResult>((resolvePromise, reject) => {\n    const child = spawn(executable, args, { cwd: payload.root, env: childEnv, stdio: ['ignore', 'pipe', 'pipe'] })\n    let output = ''\n    child.stdout?.on('data', (chunk: Buffer) => {\n      output += chunk.toString()\n    })\n    child.stderr?.on('data', (chunk: Buffer) => {\n      output += chunk.toString()\n    })\n    child.on('error', error => {\n      rmSync(directory, { recursive: true, force: true })\n      reject(\n        new ZnightError(\n          ErrorCode.InvalidOpenApiDefinition,\n          `Cannot start ${executable} to load the application modules`,\n          {\n            cause: error,\n            hints: [\n              payload.runtime === 'bun'\n                ? 'Install Bun, or use --runtime node'\n                : 'Install Node.js 24, or use --runtime bun',\n            ],\n          },\n        ),\n      )\n    })\n    child.on('close', code => {\n      const text = readText(resultFile)\n      rmSync(directory, { recursive: true, force: true })\n      if (text === undefined) {\n        reject(\n          new ZnightError(\n            ErrorCode.InvalidOpenApiDefinition,\n            `Loading the application modules failed (${executable} exited with code ${String(code)})${output.trim() === '' ? '' : `:\\n${output.trim()}`}`,\n          ),\n        )\n        return\n      }\n      resolvePromise(JSON.parse(text) as ChildResult)\n    })\n  })\n}\n\nfunction readText(file: string): string | undefined {\n  try {\n    return readFileSync(file, 'utf8')\n  } catch {\n    return undefined\n  }\n}\n\n/** Writes through a temporary file and a rename (readers never see a partial file). */\nfunction writeAtomically(file: string, content: string): void {\n  mkdirSync(dirname(file), { recursive: true })\n  const temporary = `${file}.${process.pid}.tmp`\n  writeFileSync(temporary, content)\n  renameSync(temporary, file)\n}\n"],"mappings":"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"}

package/dist/index-CqQ6IRnN.d.mts

@@ -0,0 +1,60 @@
+import { _ as OpenApiObject } from "./types-VzBexMKj.mjs";
+import { i as OpenApiWarning } from "./build-BTUC96mY.mjs";
+import { Diagnostic } from "@znight/compiler";
+/** Runtime loading the application modules: `'auto'` is the runtime running the caller. */
+type EmitRuntime = "auto" | "node" | "bun";
+/** Options of {@link emitOpenApi}. */
+interface EmitOpenApiOptions {
+  /** Project root. Default `process.cwd()`. */
+  readonly root?: string;
+  /** Output files, relative to `root`; `.yaml` / `.yml` write YAML (optional peer `yaml`). Default `'openapi.json'`. */
+  readonly output?: string | readonly string[];
+  /**
+   * Never write: report missing or stale outputs (`stale`, `staleFiles`). `true` checks every output;
+   * a list checks only these outputs (relative to `root`, each one an `output`) and writes the others
+   * as usual (the `openapi()` Vite plugin checks the committed file and writes the build output).
+   */
+  readonly check?: boolean | readonly string[];
+  /** The HTTP prefix: `servers` defaults to `[{ url: prefix }]` when `@OpenApiDocument` declares none. */
+  readonly prefix?: string;
+  /** Default `'auto'`. */
+  readonly runtime?: EmitRuntime;
+  /** Module (relative to `root`) whose default export is a `SchemaConverter[]`. */
+  readonly converters?: string;
+  /** Vite config file (default: `vite.config.*` of the root). */
+  readonly config?: string;
+  /** How Vite loads its config (`bundle`, `runner`, `native`). */
+  readonly configLoader?: string;
+  /**
+   * The compiler options, already resolved (the CLI and the Vite plugin pass theirs). Default:
+   * `znight.config.*`, else the options of the `znight()` plugin of the Vite config.
+   */
+  readonly compilerOptions?: Readonly<Record<string, unknown>>;
+  /** Environment of the child process. Default `process.env`, with `NODE_ENV` defaulting to `production`. */
+  readonly env?: Readonly<Record<string, string | undefined>>;
+}
+/** Result of {@link emitOpenApi}. */
+interface EmitOpenApiResult {
+  /** `false` when the compile failed (see `diagnostics`): nothing ran and nothing was written. */
+  readonly ok: boolean;
+  /** Outputs written (absolute paths); never a checked output. */
+  readonly written: readonly string[];
+  /** `check`: a checked output is missing or differs (listed in `staleFiles`). */
+  readonly stale: boolean;
+  readonly staleFiles: readonly string[];
+  /** The document (`undefined` when the compile failed). */
+  readonly document: OpenApiObject | undefined;
+  /** Compiler diagnostics (warnings included). */
+  readonly diagnostics: readonly Diagnostic[];
+  /** Warnings of the assembly (`unrepresentable: 'warn'`...). */
+  readonly warnings: readonly OpenApiWarning[];
+  /** Absolute paths of the outputs. */
+  readonly outputs: readonly string[];
+  readonly runtime: "node" | "bun";
+}
+/** Compiles the application and writes (or checks) its OpenAPI document. */
+declare function emitOpenApi(options?: EmitOpenApiOptions): Promise<EmitOpenApiResult>;
+/** The Vite config file of the project, if any. */
+declare function findViteConfig(root: string, config?: string): string | undefined;
+export { findViteConfig as a, emitOpenApi as i, EmitOpenApiResult as n, EmitRuntime as r, EmitOpenApiOptions as t };
+//# sourceMappingURL=index-CqQ6IRnN.d.mts.map