@vercube/cli 1.2.1 → 1.3.1

package/dist/index.mjs

@@ -4,12 +4,12 @@ import { createRequire } from "node:module";
 import { defineCommand, runMain } from "citty";
 import { Container } from "@vercube/di";
 import { BaseLogger, Logger } from "@vercube/logger";
-import { dirname, resolve } from "node:path";
+import { dirname, join, resolve } from "node:path";
 import { loadVercubeConfig } from "@vercube/core";
 import { createJiti } from "jiti";
 import { build, createDevServer, createVercube, watch } from "@vercube/devkit";
 import { cliFetch } from "srvx/cli";
-import { existsSync } from "node:fs";
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { consola } from "consola";
 import { colors } from "consola/utils";
 import { downloadTemplate, startShell } from "giget";
@@ -17,8 +17,10 @@ import { installDependencies } from "nypm";
 import { relative, resolve as resolve$1 } from "pathe";
 import { hasTTY } from "std-env";
 import { x } from "tinyexec";
+import { spawn } from "node:child_process";
+import { tmpdir } from "node:os";
 //#region package.json
-var version = "1.2.1";
+var version = "1.3.1";
 //#endregion
 //#region src/Utils/CommandUtils.ts
 /**
@@ -212,7 +214,7 @@ async function loadUserCommands(cwd) {
 	}
 }
 //#endregion
-//#region \0@oxc-project+runtime@0.140.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -228,7 +230,8 @@ let BuildCommand = class BuildCommand extends BaseCommand {
 	* @returns resolves when the build is done
 	*/
 	async run() {
-		await build(await createVercube({ build: { entry: this.entry } }));
+		const app = await createVercube({ build: { entry: this.entry } });
+		await build(app);
 	}
 };
 __decorate([Flag({
@@ -511,6 +514,97 @@ InitCommand = __decorate([Command({
 	description: "Initialize a new Vercube app"
 })], InitCommand);
 //#endregion
+//#region src/Commands/Inspect.ts
+let InspectCommand = class InspectCommand extends BaseCommand {
+	/** Entry file relative to the output directory. */
+	entry;
+	/** Comma-separated section ids. Every section when omitted. */
+	section;
+	/**
+	* @returns Resolves once the JSON has been printed
+	*/
+	async run() {
+		const app = await onlyStderr(async () => {
+			const instance = await createVercube({ build: { dts: false } });
+			await build(instance);
+			return instance;
+		});
+		const entry = resolve(app.config.build?.output?.dir ?? "dist", this.entry);
+		const directory = mkdtempSync(join(tmpdir(), "vercube-inspect-"));
+		const output = join(directory, "introspection.json");
+		try {
+			await this.runEntry(entry, output);
+			process.stdout.write(readFileSync(output, "utf8"));
+		} finally {
+			rmSync(directory, {
+				recursive: true,
+				force: true
+			});
+		}
+	}
+	/**
+	* Runs the built entry with introspection enabled.
+	*
+	* The child's stdout is pointed at this process's stderr: an application is
+	* free to log while it boots, and none of that belongs in the payload.
+	*
+	* @param entry - Absolute path of the built entry file
+	* @param output - File the child writes the JSON to
+	* @returns Resolves when the child exits successfully
+	*/
+	runEntry(entry, output) {
+		return new Promise((done, fail) => {
+			const child = spawn(process.execPath, [entry], {
+				env: {
+					...process.env,
+					VERCUBE_INSPECT: this.section ?? "*",
+					VERCUBE_INSPECT_OUT: output
+				},
+				stdio: [
+					"ignore",
+					process.stderr,
+					"inherit"
+				]
+			});
+			child.on("error", fail);
+			child.on("exit", (code) => code === 0 ? done() : fail(/* @__PURE__ */ new Error(`Inspect exited with code ${code}`)));
+		});
+	}
+};
+__decorate([Flag({
+	name: "entry",
+	description: "Entry point for the application",
+	default: "index.mjs"
+})], InspectCommand.prototype, "entry", void 0);
+__decorate([Flag({
+	name: "section",
+	description: "Only print these sections (comma-separated)",
+	type: "string"
+})], InspectCommand.prototype, "section", void 0);
+InspectCommand = __decorate([Command({
+	name: "inspect",
+	description: "Print the application structure as JSON"
+})], InspectCommand);
+/**
+* Runs `fn` with everything written to stdout diverted to stderr.
+*
+* The build pipeline logs progress through several loggers, and reaching into
+* each of them to reconfigure it would be both fragile and incomplete.
+* Diverting the stream catches all of them.
+*
+* @param fn - The work to run
+* @returns Whatever `fn` returned
+*/
+async function onlyStderr(fn) {
+	const write = process.stdout.write.bind(process.stdout);
+	process.stdout.write = process.stderr.write.bind(process.stderr);
+	try {
+		return await fn();
+	} finally {
+		process.stdout.write = write;
+	}
+}
+//#endregion
 //#region src/index.ts
 const container = createCliContainer();
 const registry = container.resolve(CommandRegistry);
@@ -518,15 +612,17 @@ registry.register(BuildCommand);
 registry.register(DevCommand);
 registry.register(InitCommand);
 registry.register(FetchCommand);
+registry.register(InspectCommand);
 const userCommands = await loadUserCommands(process.cwd());
 for (const UserCommand of userCommands) registry.register(UserCommand);
-runMain(defineCommand({
+const main = defineCommand({
 	meta: {
 		name: "vercube",
 		version,
 		description: "Vercube CLI"
 	},
 	subCommands: registry.buildCittyTree(container)
-}));
+});
+runMain(main);
 //#endregion
 export {};

package/dist/toolkit.d.mts

@@ -19,7 +19,7 @@ import { Container } from "@vercube/di";
  * }
  * ```
  */
-declare abstract class BaseCommand {
+export declare abstract class BaseCommand {
   /**
    * CLI DI container, injected by CommandRegistry before `run()`.
    * Prefer `@Inject` decorators over accessing this directly.
@@ -80,7 +80,7 @@ declare namespace CliTypes {
  * export class BuildCommand extends BaseCommand { ... }
  * ```
  */
-declare function Command(meta: CliTypes.CommandMeta): Function;
+export declare function Command(meta: CliTypes.CommandMeta): Function;
 //#endregion
 //#region src/Decorators/Arg.d.ts
 interface ArgOptions {
@@ -101,7 +101,7 @@ interface ArgOptions {
  * public query: string;
  * ```
  */
-declare function Arg(options: ArgOptions): Function;
+export declare function Arg(options: ArgOptions): Function;
 //#endregion
 //#region src/Decorators/Flag.d.ts
 interface FlagOptions {
@@ -129,6 +129,6 @@ interface FlagOptions {
  * public json: boolean;
  * ```
  */
-declare function Flag(options: FlagOptions): Function;
+export declare function Flag(options: FlagOptions): Function;
 //#endregion
-export { Arg, BaseCommand, type CliTypes, Command, Flag };
+export type { CliTypes };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercube/cli",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "CLI module for Vercube framework",
   "repository": {
     "type": "git",
@@ -26,20 +26,20 @@
     "vercube": "./dist/index.mjs"
   },
   "dependencies": {
-    "c12": "4.0.0-beta.5",
+    "@vercube/core": "1.3.1",
+    "@vercube/devkit": "1.3.1",
+    "@vercube/di": "1.3.1",
+    "@vercube/logger": "1.3.1",
+    "c12": "4.0.0-rc.2",
     "citty": "0.2.2",
     "consola": "3.4.2",
     "giget": "3.3.1",
     "jiti": "2.7.0",
-    "nypm": "0.6.9",
+    "nypm": "0.6.10",
     "pathe": "2.0.3",
-    "srvx": "0.12.5",
-    "std-env": "4.2.0",
-    "tinyexec": "1.3.0",
-    "@vercube/core": "1.2.1",
-    "@vercube/devkit": "1.2.1",
-    "@vercube/di": "1.2.1",
-    "@vercube/logger": "1.2.1"
+    "srvx": "1.0.5",
+    "std-env": "4.3.0",
+    "tinyexec": "1.3.1"
   },
   "publishConfig": {
     "access": "public"