alepha 0.14.2 → 0.14.3

package/dist/cli/index.js

@@ -1,15 +1,15 @@
 import { createRequire } from "node:module";
-import { join } from "node:path";
 import { $atom, $hook, $inject, $module, $use, Alepha, AlephaError, OPTIONS, t } from "alepha";
 import { FileSystemProvider } from "alepha/file";
 import { access, mkdir, readFile, readdir, unlink, writeFile } from "node:fs/promises";
+import { join } from "node:path";
 import { $command, CliProvider, EnvUtils } from "alepha/command";
-import { $logger } from "alepha/logger";
+import { $logger, ConsoleColorProvider } from "alepha/logger";
 import { boot, buildClient, buildServer, copyAssets, generateCloudflare, generateDocker, generateSitemap, generateVercel, prerenderPages } from "alepha/vite";
 import { exec, spawn } from "node:child_process";
-import { tsImport } from "tsx/esm/api";
 import { readFileSync } from "node:fs";
 import { promisify } from "node:util";
+import { ServerSwaggerProvider } from "alepha/server/swagger";
 import * as os from "node:os";
 
 //#region ../../src/cli/assets/appRouterTs.ts
@@ -174,6 +174,7 @@ var AlephaCliUtils = class {
 	log = $logger();
 	fs = $inject(FileSystemProvider);
 	envUtils = $inject(EnvUtils);
+	alepha = $inject(Alepha);
 	/**
 	* Execute a command using npx with inherited stdio.
 	*
@@ -235,6 +236,34 @@ var AlephaCliUtils = class {
 		this.log.debug(`Config file written: ${path}`);
 		return path;
 	}
+	async removeFiles(root, files) {
+		await Promise.all(files.map((file) => this.fs.rm(join(root, file), {
+			force: true,
+			recursive: true
+		})));
+	}
+	async removeYarn(root) {
+		await this.removeFiles(root, [
+			".yarn",
+			".yarnrc.yml",
+			".yarn"
+		]);
+	}
+	async removePnpm(root) {
+		await this.removeFiles(root, ["pnpm-lock.yaml", "pnpm-workspace.yaml"]);
+	}
+	async removeNpm(root) {
+		await this.removeFiles(root, ["package-lock.json"]);
+	}
+	async removeBun(root) {
+		await this.removeFiles(root, ["bun.lockb"]);
+	}
+	async removeAllPmFilesExcept(root, except) {
+		if (except !== "yarn") await this.removeYarn(root);
+		if (except !== "pnpm") await this.removePnpm(root);
+		if (except !== "npm") await this.removeNpm(root);
+		if (except !== "bun") await this.removeBun(root);
+	}
 	/**
 	* Ensure Yarn is configured in the project directory.
 	*
@@ -244,26 +273,16 @@ var AlephaCliUtils = class {
 	*/
 	async ensureYarn(root) {
 		await this.ensureFileExists(root, ".yarnrc.yml", "nodeLinker: node-modules", false);
-		await this.fs.rm(join(root, "package-lock.json"), { force: true });
-		await this.fs.rm(join(root, "pnpm-lock.yaml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "yarn");
+	}
+	async ensureBun(root) {
+		await this.removeAllPmFilesExcept(root, "bun");
 	}
 	async ensurePnpm(root) {
-		await this.fs.rm(join(root, "package-lock.json"), { force: true });
-		await this.fs.rm(join(root, "yarn.lock"), { force: true });
-		await this.fs.rm(join(root, ".yarn"), {
-			force: true,
-			recursive: true
-		});
-		await this.fs.rm(join(root, ".yarnrc.yml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "pnpm");
 	}
 	async ensureNpm(root) {
-		await this.fs.rm(join(root, "pnpm-lock.yaml"), { force: true });
-		await this.fs.rm(join(root, "yarn.lock"), { force: true });
-		await this.fs.rm(join(root, ".yarn"), {
-			force: true,
-			recursive: true
-		});
-		await this.fs.rm(join(root, ".yarnrc.yml"), { force: true });
+		await this.removeAllPmFilesExcept(root, "npm");
 	}
 	/**
 	* Generate package.json content with Alepha dependencies.
@@ -418,7 +437,8 @@ var AlephaCliUtils = class {
 	async loadAlephaFromServerEntryFile(rootDir, explicitEntry) {
 		process.env.ALEPHA_CLI_IMPORT = "true";
 		const entry = await boot.getServerEntry(rootDir, explicitEntry);
-		const mod = await tsImport(entry, { parentURL: import.meta.url });
+		delete global.__alepha;
+		const mod = await import(entry);
 		this.log.debug(`Load entry: ${entry}`);
 		if (mod.default instanceof Alepha) return {
 			alepha: mod.default,
@@ -470,6 +490,7 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 		if (flags?.pnpm) return "pnpm";
 		if (flags?.npm) return "npm";
 		if (flags?.bun) return "bun";
+		if (this.alepha.isBun()) return "bun";
 		if (await this.checkFileExists(root, "yarn.lock", true)) return "yarn";
 		if (await this.checkFileExists(root, "pnpm-lock.yaml", true)) return "pnpm";
 		return "npm";
@@ -554,6 +575,23 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 	async hasExpo(root) {
 		return this.hasDependency(root, "expo");
 	}
+	async getInstallCommand(root, packageName, dev = true) {
+		const pm = await this.getPackageManager(root);
+		let cmd;
+		switch (pm) {
+			case "yarn":
+				cmd = `yarn add ${dev ? "-D" : ""} ${packageName}`;
+				break;
+			case "pnpm":
+				cmd = `pnpm add ${dev ? "-D" : ""} ${packageName}`;
+				break;
+			case "bun":
+				cmd = `bun add ${dev ? "-d" : ""} ${packageName}`;
+				break;
+			default: cmd = `npm install ${dev ? "--save-dev" : ""} ${packageName}`;
+		}
+		return cmd.replace(/\s+/g, " ").trim();
+	}
 	/**
 	* Install a dependency if it's missing from the project.
 	*
@@ -566,18 +604,7 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 			this.log.debug(`Dependency '${packageName}' is already installed`);
 			return;
 		}
-		const pm = await this.getPackageManager(root);
-		let cmd;
-		switch (pm) {
-			case "yarn":
-				cmd = `yarn add ${dev ? "-D" : ""} ${packageName}`;
-				break;
-			case "pnpm":
-				cmd = `pnpm add ${dev ? "-D" : ""} ${packageName}`;
-				break;
-			default: cmd = `npm install ${dev ? "--save-dev" : ""} ${packageName}`;
-		}
-		cmd = cmd.replace(/\s+/g, " ").trim();
+		const cmd = await this.getInstallCommand(root, packageName, dev);
 		if (options.run) await options.run(cmd, { alias: `installing ${packageName}` });
 		else {
 			this.log.debug(`Installing ${packageName}`);
@@ -719,222 +746,6 @@ var BuildCommand = class {
 	});
 };
 
-//#endregion
-//#region ../../src/cli/atoms/changelogOptions.ts
-/**
-* Default scopes to ignore in changelog generation.
-* Commits with these scopes won't appear in release notes.
-*/
-const DEFAULT_IGNORE = [
-	"project",
-	"release",
-	"starter",
-	"example",
-	"chore",
-	"ci",
-	"build",
-	"test",
-	"style"
-];
-/**
-* Changelog configuration atom.
-*
-* Configure in `alepha.config.ts`:
-* ```ts
-* import { changelogOptions } from "alepha/cli";
-*
-* alepha.set(changelogOptions, {
-*   ignore: ["project", "release", "chore", "docs"],
-* });
-* ```
-*/
-const changelogOptions = $atom({
-	name: "alepha.changelog",
-	schema: t.object({ ignore: t.optional(t.array(t.string())) }),
-	default: { ignore: DEFAULT_IGNORE }
-});
-
-//#endregion
-//#region ../../src/cli/services/GitMessageParser.ts
-/**
-* Service for parsing git commit messages into structured format.
-*
-* Only parses **conventional commits with a scope**:
-* - `feat(scope): description` → feature
-* - `fix(scope): description` → bug fix
-* - `feat(scope)!: description` → breaking change
-*
-* Commits without scope are ignored, allowing developers to commit
-* work-in-progress changes without polluting release notes:
-* - `cli: work in progress` → ignored (no type)
-* - `fix: quick patch` → ignored (no scope)
-* - `feat(cli): add command` → included
-*/
-var GitMessageParser = class {
-	log = $logger();
-	/**
-	* Parse a git commit line into a structured Commit object.
-	*
-	* **Format:** `type(scope): description` or `type(scope)!: description`
-	*
-	* **Supported types:** feat, fix, docs, refactor, perf, revert
-	*
-	* **Breaking changes:** Use `!` before `:` (e.g., `feat(api)!: remove endpoint`)
-	*
-	* @returns Commit object or null if not matching/ignored
-	*/
-	parseCommit(line, config) {
-		const match = line.match(/^([a-f0-9]+)\s+(.+)$/);
-		if (!match) return null;
-		const [, hash, message] = match;
-		const ignore = config.ignore ?? DEFAULT_IGNORE;
-		const conventionalMatch = message.match(/^(feat|fix|docs|refactor|perf|revert)\(([^)]+)\)(!)?:\s*(.+)$/i);
-		if (!conventionalMatch) return null;
-		const [, type, scope, breakingMark, description] = conventionalMatch;
-		const baseScope = scope.split("/")[0];
-		if (ignore.includes(baseScope) || ignore.includes(scope)) return null;
-		const breaking = breakingMark === "!" || description.toLowerCase().includes("breaking");
-		return {
-			hash: hash.substring(0, 8),
-			type: type.toLowerCase(),
-			scope,
-			description: description.trim(),
-			breaking
-		};
-	}
-};
-
-//#endregion
-//#region ../../src/cli/commands/changelog.ts
-const execAsync = promisify(exec);
-/**
-* Git provider for executing git commands.
-* Can be substituted in tests with a mock implementation.
-*/
-var GitProvider = class {
-	async exec(cmd, cwd) {
-		const { stdout } = await execAsync(`git ${cmd}`, { cwd });
-		return stdout;
-	}
-};
-/**
-* Changelog command for generating release notes from git commits.
-*
-* Usage:
-* - `alepha changelog` - Show unreleased changes since latest tag to HEAD
-* - `alepha changelog --from=1.0.0` - Show changes from version to HEAD
-* - `alepha changelog --from=1.0.0 --to=1.1.0` - Show changes between two refs
-* - `alepha changelog | tee -a CHANGELOG.md` - Append to file
-*/
-var ChangelogCommand = class {
-	log = $logger();
-	git = $inject(GitProvider);
-	parser = $inject(GitMessageParser);
-	config = $use(changelogOptions);
-	/**
-	* Format a single commit line.
-	* Example: `- **cli**: add new command (\`abc1234\`)`
-	* Breaking changes are flagged: `- **cli**: add new command [BREAKING] (\`abc1234\`)`
-	*/
-	formatCommit(commit) {
-		const breaking = commit.breaking ? " [BREAKING]" : "";
-		return `- **${commit.scope}**: ${commit.description}${breaking} (\`${commit.hash}\`)`;
-	}
-	/**
-	* Format the changelog entry with sections.
-	*/
-	formatEntry(entry) {
-		const sections = [];
-		if (entry.features.length > 0) {
-			sections.push("### Features\n");
-			for (const commit of entry.features) sections.push(this.formatCommit(commit));
-			sections.push("");
-		}
-		if (entry.fixes.length > 0) {
-			sections.push("### Bug Fixes\n");
-			for (const commit of entry.fixes) sections.push(this.formatCommit(commit));
-			sections.push("");
-		}
-		return sections.join("\n");
-	}
-	/**
-	* Parse git log output into a changelog entry.
-	*/
-	parseCommits(commitsOutput) {
-		const entry = {
-			features: [],
-			fixes: []
-		};
-		for (const line of commitsOutput.trim().split("\n")) {
-			if (!line.trim()) continue;
-			const commit = this.parser.parseCommit(line, this.config);
-			if (!commit) {
-				this.log.trace("Skipping commit", { line });
-				continue;
-			}
-			this.log.trace("Parsed commit", { commit });
-			if (commit.type === "feat") entry.features.push(commit);
-			else if (commit.type === "fix") entry.fixes.push(commit);
-		}
-		return entry;
-	}
-	/**
-	* Check if entry has any public commits.
-	*/
-	hasChanges(entry) {
-		return entry.features.length > 0 || entry.fixes.length > 0;
-	}
-	/**
-	* Get the latest version tag.
-	*/
-	async getLatestTag(git) {
-		return (await git("tag --sort=-version:refname")).trim().split("\n").filter((tag) => tag.match(/^\d+\.\d+\.\d+$/))[0] || null;
-	}
-	changelog = $command({
-		name: "changelog",
-		description: "Generate changelog from conventional commits (outputs to stdout)",
-		flags: t.object({
-			from: t.optional(t.string({
-				aliases: ["f"],
-				description: "Starting ref (default: latest tag)"
-			})),
-			to: t.optional(t.string({
-				aliases: ["t"],
-				description: "Ending ref (default: HEAD)"
-			}))
-		}),
-		handler: async ({ flags, root }) => {
-			const git = (cmd) => this.git.exec(cmd, root);
-			let fromRef;
-			if (flags.from) {
-				fromRef = flags.from;
-				this.log.debug("Using specified from ref", { from: fromRef });
-			} else {
-				const latestTag = await this.getLatestTag(git);
-				if (!latestTag) {
-					process.stdout.write("No version tags found in repository\n");
-					return;
-				}
-				fromRef = latestTag;
-				this.log.debug("Using latest tag", { from: fromRef });
-			}
-			const toRef = flags.to || "HEAD";
-			this.log.debug("Using to ref", { to: toRef });
-			const commitsOutput = await git(`log ${fromRef}..${toRef} --oneline`);
-			if (!commitsOutput.trim()) {
-				process.stdout.write(`No changes in range ${fromRef}..${toRef}\n`);
-				return;
-			}
-			const entry = this.parseCommits(commitsOutput);
-			if (!this.hasChanges(entry)) {
-				process.stdout.write(`No public changes in range ${fromRef}..${toRef}\n`);
-				return;
-			}
-			process.stdout.write(this.formatEntry(entry));
-		}
-	});
-};
-
 //#endregion
 //#region ../../src/cli/commands/clean.ts
 var CleanCommand = class {
@@ -1295,6 +1106,7 @@ var DeployCommand = class {
 var DevCommand = class {
 	log = $logger();
 	utils = $inject(AlephaCliUtils);
+	alepha = $inject(Alepha);
 	/**
 	* Will run the project in watch mode.
 	*
@@ -1320,20 +1132,26 @@ var DevCommand = class {
 			}
 			const entry = await boot.getServerEntry(root, args);
 			this.log.trace("Entry file found", { entry });
-			try {
-				await access(join(root, "index.html"));
-			} catch {
-				this.log.trace("No index.html found, running entry file with tsx");
-				let cmd = "tsx --watch";
+			if (!await this.isFullstackProject(root)) {
+				const exe = this.alepha.isBun() ? "bun" : "tsx";
+				let cmd = `${exe} --watch`;
 				if (await this.utils.exists(root, ".env")) cmd += " --env-file=./.env";
 				cmd += ` ${entry}`;
-				await this.utils.exec(cmd);
+				await this.utils.exec(cmd, { global: exe === "bun" });
 				return;
 			}
 			await this.utils.ensureDependency(root, "vite");
 			await this.utils.exec("vite");
 		}
 	});
+	async isFullstackProject(root) {
+		try {
+			await access(join(root, "index.html"));
+			return true;
+		} catch {
+			return false;
+		}
+	}
 };
 
 //#endregion
@@ -1351,6 +1169,278 @@ var FormatCommand = class {
 	});
 };
 
+//#endregion
+//#region ../../src/cli/atoms/changelogOptions.ts
+/**
+* Default scopes to ignore in changelog generation.
+* Commits with these scopes won't appear in release notes.
+*/
+const DEFAULT_IGNORE = [
+	"project",
+	"release",
+	"starter",
+	"example",
+	"chore",
+	"ci",
+	"build",
+	"test",
+	"style"
+];
+/**
+* Changelog configuration atom.
+*
+* Configure in `alepha.config.ts`:
+* ```ts
+* import { changelogOptions } from "alepha/cli";
+*
+* alepha.set(changelogOptions, {
+*   ignore: ["project", "release", "chore", "docs"],
+* });
+* ```
+*/
+const changelogOptions = $atom({
+	name: "alepha.changelog",
+	schema: t.object({ ignore: t.optional(t.array(t.string())) }),
+	default: { ignore: DEFAULT_IGNORE }
+});
+
+//#endregion
+//#region ../../src/cli/services/GitMessageParser.ts
+/**
+* Service for parsing git commit messages into structured format.
+*
+* Only parses **conventional commits with a scope**:
+* - `feat(scope): description` → feature
+* - `fix(scope): description` → bug fix
+* - `feat(scope)!: description` → breaking change
+*
+* Commits without scope are ignored, allowing developers to commit
+* work-in-progress changes without polluting release notes:
+* - `cli: work in progress` → ignored (no type)
+* - `fix: quick patch` → ignored (no scope)
+* - `feat(cli): add command` → included
+*/
+var GitMessageParser = class {
+	log = $logger();
+	/**
+	* Parse a git commit line into a structured Commit object.
+	*
+	* **Format:** `type(scope): description` or `type(scope)!: description`
+	*
+	* **Supported types:** feat, fix, docs, refactor, perf, revert
+	*
+	* **Breaking changes:** Use `!` before `:` (e.g., `feat(api)!: remove endpoint`)
+	*
+	* @returns Commit object or null if not matching/ignored
+	*/
+	parseCommit(line, config) {
+		const match = line.match(/^([a-f0-9]+)\s+(.+)$/);
+		if (!match) return null;
+		const [, hash, message] = match;
+		const ignore = config.ignore ?? DEFAULT_IGNORE;
+		const conventionalMatch = message.match(/^(feat|fix|docs|refactor|perf|revert)\(([^)]+)\)(!)?:\s*(.+)$/i);
+		if (!conventionalMatch) return null;
+		const [, type, scope, breakingMark, description] = conventionalMatch;
+		const baseScope = scope.split("/")[0];
+		if (ignore.includes(baseScope) || ignore.includes(scope)) return null;
+		const breaking = breakingMark === "!" || description.toLowerCase().includes("breaking");
+		return {
+			hash: hash.substring(0, 8),
+			type: type.toLowerCase(),
+			scope,
+			description: description.trim(),
+			breaking
+		};
+	}
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen/changelog.ts
+const execAsync = promisify(exec);
+/**
+* Git provider for executing git commands.
+* Can be substituted in tests with a mock implementation.
+*/
+var GitProvider = class {
+	async exec(cmd, cwd) {
+		const { stdout } = await execAsync(`git ${cmd}`, { cwd });
+		return stdout;
+	}
+};
+/**
+* Changelog command for generating release notes from git commits.
+*
+* Usage:
+* - `alepha gen changelog` - Show unreleased changes since latest tag to HEAD
+* - `alepha gen changelog --from=1.0.0` - Show changes from version to HEAD
+* - `alepha gen changelog --from=1.0.0 --to=1.1.0` - Show changes between two refs
+* - `alepha gen changelog | tee -a CHANGELOG.md` - Append to file
+*/
+var ChangelogCommand = class {
+	log = $logger();
+	git = $inject(GitProvider);
+	parser = $inject(GitMessageParser);
+	config = $use(changelogOptions);
+	/**
+	* Format a single commit line.
+	* Example: `- **cli**: add new command (\`abc1234\`)`
+	* Breaking changes are flagged: `- **cli**: add new command [BREAKING] (\`abc1234\`)`
+	*/
+	formatCommit(commit) {
+		const breaking = commit.breaking ? " [BREAKING]" : "";
+		return `- **${commit.scope}**: ${commit.description}${breaking} (\`${commit.hash}\`)`;
+	}
+	/**
+	* Format the changelog entry with sections.
+	*/
+	formatEntry(entry) {
+		const sections = [];
+		if (entry.features.length > 0) {
+			sections.push("### Features\n");
+			for (const commit of entry.features) sections.push(this.formatCommit(commit));
+			sections.push("");
+		}
+		if (entry.fixes.length > 0) {
+			sections.push("### Bug Fixes\n");
+			for (const commit of entry.fixes) sections.push(this.formatCommit(commit));
+			sections.push("");
+		}
+		return sections.join("\n");
+	}
+	/**
+	* Parse git log output into a changelog entry.
+	*/
+	parseCommits(commitsOutput) {
+		const entry = {
+			features: [],
+			fixes: []
+		};
+		for (const line of commitsOutput.trim().split("\n")) {
+			if (!line.trim()) continue;
+			const commit = this.parser.parseCommit(line, this.config);
+			if (!commit) {
+				this.log.trace("Skipping commit", { line });
+				continue;
+			}
+			this.log.trace("Parsed commit", { commit });
+			if (commit.type === "feat") entry.features.push(commit);
+			else if (commit.type === "fix") entry.fixes.push(commit);
+		}
+		return entry;
+	}
+	/**
+	* Check if entry has any public commits.
+	*/
+	hasChanges(entry) {
+		return entry.features.length > 0 || entry.fixes.length > 0;
+	}
+	/**
+	* Get the latest version tag.
+	*/
+	async getLatestTag(git) {
+		return (await git("tag --sort=-version:refname")).trim().split("\n").filter((tag) => tag.match(/^\d+\.\d+\.\d+$/))[0] || null;
+	}
+	command = $command({
+		name: "changelog",
+		description: "Generate changelog from conventional commits (outputs to stdout)",
+		flags: t.object({
+			from: t.optional(t.string({
+				aliases: ["f"],
+				description: "Starting ref (default: latest tag)"
+			})),
+			to: t.optional(t.string({
+				aliases: ["t"],
+				description: "Ending ref (default: HEAD)"
+			}))
+		}),
+		handler: async ({ flags, root }) => {
+			const git = (cmd) => this.git.exec(cmd, root);
+			let fromRef;
+			if (flags.from) {
+				fromRef = flags.from;
+				this.log.debug("Using specified from ref", { from: fromRef });
+			} else {
+				const latestTag = await this.getLatestTag(git);
+				if (!latestTag) {
+					process.stdout.write("No version tags found in repository\n");
+					return;
+				}
+				fromRef = latestTag;
+				this.log.debug("Using latest tag", { from: fromRef });
+			}
+			const toRef = flags.to || "HEAD";
+			this.log.debug("Using to ref", { to: toRef });
+			const commitsOutput = await git(`log ${fromRef}..${toRef} --oneline`);
+			if (!commitsOutput.trim()) {
+				process.stdout.write(`No changes in range ${fromRef}..${toRef}\n`);
+				return;
+			}
+			const entry = this.parseCommits(commitsOutput);
+			if (!this.hasChanges(entry)) {
+				process.stdout.write(`No public changes in range ${fromRef}..${toRef}\n`);
+				return;
+			}
+			process.stdout.write(this.formatEntry(entry));
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen/openapi.ts
+var OpenApiCommand = class {
+	log = $logger();
+	utils = $inject(AlephaCliUtils);
+	fs = $inject(FileSystemProvider);
+	command = $command({
+		name: "openapi",
+		description: "Generate OpenAPI specification from actions",
+		flags: t.object({ out: t.optional(t.text({
+			aliases: ["o"],
+			description: "Output file path"
+		})) }),
+		handler: async ({ root, flags }) => {
+			const { alepha } = await this.utils.loadAlephaFromServerEntryFile(root);
+			try {
+				const openapiProvider = alepha.inject(ServerSwaggerProvider);
+				await alepha.events.emit("configure", alepha);
+				let json = openapiProvider.json;
+				if (!json) json = openapiProvider.generateSwaggerDoc({ info: {
+					title: "API Documentation",
+					version: "1.0.0"
+				} });
+				if (!json) {
+					this.log.error("No actions found to generate OpenAPI specification.");
+					return;
+				}
+				if (flags.out) await this.fs.writeFile(this.fs.join(root, flags.out), JSON.stringify(json, null, 2));
+				else this.log.info(JSON.stringify(json, null, 2));
+			} catch (err) {
+				const message = err instanceof Error ? err.message : String(err);
+				if (message.includes("Service not found")) {
+					this.log.error("Missing $swagger() primitive in your server configuration.");
+					return;
+				}
+				this.log.error(`OpenAPI generation failed - ${message}`, { err });
+			}
+		}
+	});
+};
+
+//#endregion
+//#region ../../src/cli/commands/gen.ts
+var GenCommand = class {
+	changelog = $inject(ChangelogCommand);
+	openapi = $inject(OpenApiCommand);
+	gen = $command({
+		name: "gen",
+		description: "Generate code, documentation, ...",
+		children: [this.changelog.command, this.openapi.command],
+		handler: async ({ help }) => {
+			help();
+		}
+	});
+};
+
 //#endregion
 //#region ../../src/cli/commands/init.ts
 var InitCommand = class {
@@ -1392,7 +1482,8 @@ var InitCommand = class {
 			if (pm === "yarn") {
 				await this.utils.ensureYarn(root);
 				await run("yarn set version stable");
-			} else if (pm === "pnpm") await this.utils.ensurePnpm(root);
+			} else if (pm === "bun") await this.utils.ensureBun(root);
+			else if (pm === "pnpm") await this.utils.ensurePnpm(root);
 			else await this.utils.ensureNpm(root);
 			await run(`${pm} install`, { alias: `installing dependencies with ${pm}` });
 			if (!isExpo) await this.utils.ensureDependency(root, "vite", { run });
@@ -1425,6 +1516,8 @@ var LintCommand = class {
 var RootCommand = class {
 	log = $logger();
 	cli = $inject(CliProvider);
+	alepha = $inject(Alepha);
+	color = $inject(ConsoleColorProvider);
 	/**
 	* Called when no command is provided
 	*/
@@ -1436,7 +1529,9 @@ var RootCommand = class {
 		})) }),
 		handler: async ({ flags }) => {
 			if (flags.version) {
-				this.log.info(version);
+				this.log.info(this.color.set("WHITE_BOLD", `Alepha v${version}`));
+				if (this.alepha.isBun()) this.log.info(this.color.set("GREY_DARK", `└─ Bun v${Bun.version}`));
+				else this.log.info(this.color.set("GREY_DARK", `└─ Node ${process.version}`));
 				return;
 			}
 			this.cli.printHelp();
@@ -1499,15 +1594,19 @@ var TestCommand = class {
 //#region ../../src/cli/commands/typecheck.ts
 var TypecheckCommand = class {
 	utils = $inject(AlephaCliUtils);
+	log = $logger();
 	/**
 	* Run TypeScript type checking across the codebase with no emit.
 	*/
 	typecheck = $command({
 		name: "typecheck",
+		aliases: ["tc"],
 		description: "Check TypeScript types across the codebase",
 		handler: async ({ root }) => {
+			this.log.info("Starting TypeScript type checking...");
 			await this.utils.ensureDependency(root, "typescript");
 			await this.utils.exec("tsc --noEmit");
+			this.log.info("TypeScript type checking completed successfully.");
 		}
 	});
 };
@@ -1547,13 +1646,26 @@ var VerifyCommand = class {
 
 //#endregion
 //#region ../../src/cli/apps/AlephaCli.ts
+/**
+* Register `tsx` when running in Node.js, ignore for Bun.
+*
+* It's required to have a full TypeScript support. (mostly .tsx files)
+*/
+if (typeof Bun === "undefined") {
+	const { register } = await import("tsx/esm/api");
+	register();
+}
+/**
+* Allow to extend Alepha CLI via `alepha.config.ts` file located in the project root.
+*/
 var AlephaCliExtension = class {
 	alepha = $inject(Alepha);
 	fs = $inject(FileSystemProvider);
 	onConfigure = $hook({
 		on: "configure",
 		handler: async () => {
-			const extensionPath = join(process.cwd(), "alepha.config.ts");
+			const root = process.cwd();
+			const extensionPath = this.fs.join(root, "alepha.config.ts");
 			if (!await this.fs.exists(extensionPath)) return;
 			const { default: Extension } = await import(extensionPath);
 			if (typeof Extension !== "function") return;
@@ -1566,7 +1678,6 @@ const AlephaCli = $module({
 	services: [
 		AlephaCliExtension,
 		BuildCommand,
-		ChangelogCommand,
 		CleanCommand,
 		DbCommand,
 		DeployCommand,
@@ -1579,6 +1690,7 @@ const AlephaCli = $module({
 		TestCommand,
 		TypecheckCommand,
 		VerifyCommand,
+		GenCommand,
 		GitProvider
 	]
 });
@@ -1791,5 +1903,5 @@ const defineConfig = (config) => {
 const defineAlephaConfig = defineConfig;
 
 //#endregion
-export { AlephaCli, AlephaCliUtils, AlephaPackageBuilderCli, BuildCommand, ChangelogCommand, CleanCommand, DEFAULT_IGNORE, DbCommand, DeployCommand, DevCommand, FormatCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, RootCommand, RunCommand, TestCommand, TypecheckCommand, VerifyCommand, analyzeModules, changelogOptions, defineAlephaConfig, defineConfig, version };
+export { AlephaCli, AlephaCliUtils, AlephaPackageBuilderCli, BuildCommand, ChangelogCommand, CleanCommand, DEFAULT_IGNORE, DbCommand, DeployCommand, DevCommand, FormatCommand, GitMessageParser, GitProvider, InitCommand, LintCommand, OpenApiCommand, RootCommand, RunCommand, TestCommand, TypecheckCommand, VerifyCommand, analyzeModules, changelogOptions, defineAlephaConfig, defineConfig, version };
 //# sourceMappingURL=index.js.map