create-alepha 0.12.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Nicolas Foures
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# Alepha Create Alepha
+
+Create a new Alepha project with a single command.
+
+## Installation
+
+This package is part of the Alepha framework and can be installed via the all-in-one package:
+
+```bash
+npm install alepha
+```
+

package/dist/index.cjs

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let alepha = require("alepha");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+let node_stream = require("node:stream");
+let node_stream_promises = require("node:stream/promises");
+let alepha_command = require("alepha/command");
+let alepha_logger = require("alepha/logger");
+let tar = require("tar");
+tar = __toESM(tar);
+let node_fs = require("node:fs");
+
+//#region src/CreateAlephaCoreCommands.ts
+var CreateAlephaCoreCommands = class {
+	log = (0, alepha_logger.$logger)();
+	cli = (0, alepha.$inject)(alepha_command.CliProvider);
+	detectPackageManager() {
+		const ua = process.env.npm_config_user_agent || "";
+		if (ua.startsWith("yarn")) return "yarn";
+		if (ua.startsWith("pnpm")) return "pnpm";
+		if (ua.startsWith("bun")) return "bun";
+		return "npm";
+	}
+	/**
+	* Download Alepha starter project from GitHub.
+	*/
+	async downloadSampleProject(targetDir) {
+		const response = await fetch("https://api.github.com/repos/feunard/alepha/tarball/main", { headers: { "User-Agent": "Alepha-CLI" } });
+		if (!response.ok) throw new alepha.AlephaError(`Failed to download: ${response.statusText}`);
+		await (0, node_stream_promises.pipeline)(node_stream.Readable.fromWeb(response.body), tar.extract({
+			cwd: targetDir,
+			strip: 3,
+			filter: (path) => {
+				const parts = path.split("/");
+				return parts.length >= 3 && parts[1] === "apps" && parts[2] === "starter";
+			}
+		}));
+	}
+	/**
+	* Called when no command is provided - shows help or creates a new project
+	*/
+	root = (0, alepha_command.$command)({
+		root: true,
+		description: "Create a new Alepha project",
+		args: alepha.t.optional(alepha.t.text({ title: "name" })),
+		summary: false,
+		handler: async ({ run: run$1, args, root }) => {
+			const name = args ?? "my-app";
+			const dest = (0, node_path.join)(root, name);
+			try {
+				await (0, node_fs_promises.access)(dest);
+				this.log.error(`Directory "${name}" already exists. Please choose a different project name.`);
+				return;
+			} catch {}
+			const pm = this.detectPackageManager();
+			await (0, node_fs_promises.mkdir)(dest, { recursive: true }).catch(() => null);
+			await run$1("Downloading sample project", () => this.downloadSampleProject(dest));
+			await run$1(`cd ${name} && ${pm} install`, { alias: "Installing dependencies" });
+			await run$1(`cd ${name} && ${pm} run lint`, { alias: "Linting code" });
+			await run$1(`cd ${name} && ${pm} run typecheck`, { alias: "Type checking" });
+			await run$1(`cd ${name} && ${pm} run test`, { alias: "Running tests" });
+			await run$1(`cd ${name} && ${pm} run build`, { alias: "Building project" });
+			this.log.info("");
+			this.log.info(`$ cd ${name} && ${pm} run dev`.trim());
+			this.log.info("");
+		}
+	});
+};
+
+//#endregion
+//#region src/version.ts
+const packageJson = JSON.parse((0, node_fs.readFileSync)(new URL("../package.json", require("url").pathToFileURL(__filename).href), "utf-8"));
+const version = packageJson.version;
+
+//#endregion
+//#region src/index.ts
+const alepha$1 = alepha.Alepha.create({ env: {
+	LOG_LEVEL: "alepha.core:warn,info",
+	LOG_FORMAT: "raw",
+	CLI_NAME: "create-alepha",
+	CLI_DESCRIPTION: `Create Alepha v${version} - Create a new Alepha project.`
+} });
+alepha$1.with(CreateAlephaCoreCommands);
+(0, alepha.run)(alepha$1);
+
+//#endregion
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["CliProvider","AlephaError","Readable","t","run","alepha","Alepha"],"sources":["../src/CreateAlephaCoreCommands.ts","../src/version.ts","../src/index.ts"],"sourcesContent":["import { access, mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { $inject, AlephaError, t } from \"alepha\";\nimport { $command, CliProvider } from \"alepha/command\";\nimport { $logger } from \"alepha/logger\";\nimport * as tar from \"tar\";\n\nexport class CreateAlephaCoreCommands {\n  protected readonly log = $logger();\n  protected readonly cli = $inject(CliProvider);\n\n  protected detectPackageManager(): \"npm\" | \"yarn\" | \"pnpm\" | \"bun\" {\n    const ua = process.env.npm_config_user_agent || \"\";\n    if (ua.startsWith(\"yarn\")) return \"yarn\";\n    if (ua.startsWith(\"pnpm\")) return \"pnpm\";\n    if (ua.startsWith(\"bun\")) return \"bun\";\n    return \"npm\";\n  }\n\n  /**\n   * Download Alepha starter project from GitHub.\n   */\n  public async downloadSampleProject(targetDir: string): Promise<void> {\n    const url = \"https://api.github.com/repos/feunard/alepha/tarball/main\";\n    const response = await fetch(url, {\n      headers: {\n        \"User-Agent\": \"Alepha-CLI\",\n      },\n    });\n\n    if (!response.ok) {\n      throw new AlephaError(`Failed to download: ${response.statusText}`);\n    }\n\n    const tarStream = Readable.fromWeb(response.body as any);\n    await pipeline(\n      tarStream,\n      tar.extract({\n        cwd: targetDir,\n        strip: 3, // Remove feunard-alepha-<hash>/apps/starter prefix\n        filter: (path) => {\n          const parts = path.split(\"/\");\n          return (\n            parts.length >= 3 && parts[1] === \"apps\" && parts[2] === \"starter\"\n          );\n        },\n      }),\n    );\n  }\n\n  /**\n   * Called when no command is provided - shows help or creates a new project\n   */\n  public readonly root = $command({\n    root: true,\n    description: \"Create a new Alepha project\",\n    args: t.optional(\n      t.text({\n        title: \"name\",\n      }),\n    ),\n    summary: false,\n    handler: async ({ run, args, root }) => {\n      const name = args ?? \"my-app\";\n      const dest = join(root, name);\n\n      try {\n        await access(dest);\n        this.log.error(\n          `Directory \"${name}\" already exists. Please choose a different project name.`,\n        );\n        return;\n      } catch {\n        // Directory does not exist, proceed\n      }\n\n      const pm = this.detectPackageManager();\n\n      await mkdir(dest, { recursive: true }).catch(() => null);\n\n      await run(\"Downloading sample project\", () =>\n        this.downloadSampleProject(dest),\n      );\n\n      await run(`cd ${name} && ${pm} install`, {\n        alias: \"Installing dependencies\",\n      });\n\n      await run(`cd ${name} && ${pm} run lint`, {\n        alias: \"Linting code\",\n      });\n\n      await run(`cd ${name} && ${pm} run typecheck`, {\n        alias: \"Type checking\",\n      });\n\n      await run(`cd ${name} && ${pm} run test`, {\n        alias: \"Running tests\",\n      });\n\n      await run(`cd ${name} && ${pm} run build`, {\n        alias: \"Building project\",\n      });\n\n      this.log.info(\"\");\n      this.log.info(`$ cd ${name} && ${pm} run dev`.trim());\n      this.log.info(\"\");\n    },\n  });\n}\n","import { readFileSync } from \"node:fs\";\n\nconst packageJson = JSON.parse(\n  readFileSync(new URL(\"../package.json\", import.meta.url), \"utf-8\"),\n);\n\nexport const version = packageJson.version;\n","#!/usr/bin/env node\nimport { Alepha, run } from \"alepha\";\nimport { CreateAlephaCoreCommands } from \"./CreateAlephaCoreCommands.ts\";\nimport { version } from \"./version.ts\";\n\nconst alepha = Alepha.create({\n  env: {\n    LOG_LEVEL: \"alepha.core:warn,info\",\n    LOG_FORMAT: \"raw\",\n    CLI_NAME: \"create-alepha\",\n    CLI_DESCRIPTION: `Create Alepha v${version} - Create a new Alepha project.`,\n  },\n});\n\nalepha.with(CreateAlephaCoreCommands);\n\nrun(alepha);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,IAAa,2BAAb,MAAsC;CACpC,AAAmB,kCAAe;CAClC,AAAmB,0BAAcA,2BAAY;CAE7C,AAAU,uBAAwD;EAChE,MAAM,KAAK,QAAQ,IAAI,yBAAyB;AAChD,MAAI,GAAG,WAAW,OAAO,CAAE,QAAO;AAClC,MAAI,GAAG,WAAW,OAAO,CAAE,QAAO;AAClC,MAAI,GAAG,WAAW,MAAM,CAAE,QAAO;AACjC,SAAO;;;;;CAMT,MAAa,sBAAsB,WAAkC;EAEnE,MAAM,WAAW,MAAM,MADX,4DACsB,EAChC,SAAS,EACP,cAAc,cACf,EACF,CAAC;AAEF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAIC,mBAAY,uBAAuB,SAAS,aAAa;AAIrE,2CADkBC,qBAAS,QAAQ,SAAS,KAAY,EAGtD,IAAI,QAAQ;GACV,KAAK;GACL,OAAO;GACP,SAAS,SAAS;IAChB,MAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,WACE,MAAM,UAAU,KAAK,MAAM,OAAO,UAAU,MAAM,OAAO;;GAG9D,CAAC,CACH;;;;;CAMH,AAAgB,oCAAgB;EAC9B,MAAM;EACN,aAAa;EACb,MAAMC,SAAE,SACNA,SAAE,KAAK,EACL,OAAO,QACR,CAAC,CACH;EACD,SAAS;EACT,SAAS,OAAO,EAAE,YAAK,MAAM,WAAW;GACtC,MAAM,OAAO,QAAQ;GACrB,MAAM,2BAAY,MAAM,KAAK;AAE7B,OAAI;AACF,uCAAa,KAAK;AAClB,SAAK,IAAI,MACP,cAAc,KAAK,2DACpB;AACD;WACM;GAIR,MAAM,KAAK,KAAK,sBAAsB;AAEtC,qCAAY,MAAM,EAAE,WAAW,MAAM,CAAC,CAAC,YAAY,KAAK;AAExD,SAAMC,MAAI,oCACR,KAAK,sBAAsB,KAAK,CACjC;AAED,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,WAAW,EACvC,OAAO,2BACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,YAAY,EACxC,OAAO,gBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,iBAAiB,EAC7C,OAAO,iBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,YAAY,EACxC,OAAO,iBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,aAAa,EACzC,OAAO,oBACR,CAAC;AAEF,QAAK,IAAI,KAAK,GAAG;AACjB,QAAK,IAAI,KAAK,QAAQ,KAAK,MAAM,GAAG,UAAU,MAAM,CAAC;AACrD,QAAK,IAAI,KAAK,GAAG;;EAEpB,CAAC;;;;;AC5GJ,MAAM,cAAc,KAAK,gCACV,IAAI,IAAI,iEAAmC,EAAE,QAAQ,CACnE;AAED,MAAa,UAAU,YAAY;;;;ACDnC,MAAMC,WAASC,cAAO,OAAO,EAC3B,KAAK;CACH,WAAW;CACX,YAAY;CACZ,UAAU;CACV,iBAAiB,kBAAkB,QAAQ;CAC5C,EACF,CAAC;AAEFD,SAAO,KAAK,yBAAyB;gBAEjCA,SAAO"}

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { $inject, Alepha, AlephaError, run, t } from "alepha";
+import { access, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { $command, CliProvider } from "alepha/command";
+import { $logger } from "alepha/logger";
+import * as tar from "tar";
+import { readFileSync } from "node:fs";
+
+//#region src/CreateAlephaCoreCommands.ts
+var CreateAlephaCoreCommands = class {
+	log = $logger();
+	cli = $inject(CliProvider);
+	detectPackageManager() {
+		const ua = process.env.npm_config_user_agent || "";
+		if (ua.startsWith("yarn")) return "yarn";
+		if (ua.startsWith("pnpm")) return "pnpm";
+		if (ua.startsWith("bun")) return "bun";
+		return "npm";
+	}
+	/**
+	* Download Alepha starter project from GitHub.
+	*/
+	async downloadSampleProject(targetDir) {
+		const response = await fetch("https://api.github.com/repos/feunard/alepha/tarball/main", { headers: { "User-Agent": "Alepha-CLI" } });
+		if (!response.ok) throw new AlephaError(`Failed to download: ${response.statusText}`);
+		await pipeline(Readable.fromWeb(response.body), tar.extract({
+			cwd: targetDir,
+			strip: 3,
+			filter: (path) => {
+				const parts = path.split("/");
+				return parts.length >= 3 && parts[1] === "apps" && parts[2] === "starter";
+			}
+		}));
+	}
+	/**
+	* Called when no command is provided - shows help or creates a new project
+	*/
+	root = $command({
+		root: true,
+		description: "Create a new Alepha project",
+		args: t.optional(t.text({ title: "name" })),
+		summary: false,
+		handler: async ({ run: run$1, args, root }) => {
+			const name = args ?? "my-app";
+			const dest = join(root, name);
+			try {
+				await access(dest);
+				this.log.error(`Directory "${name}" already exists. Please choose a different project name.`);
+				return;
+			} catch {}
+			const pm = this.detectPackageManager();
+			await mkdir(dest, { recursive: true }).catch(() => null);
+			await run$1("Downloading sample project", () => this.downloadSampleProject(dest));
+			await run$1(`cd ${name} && ${pm} install`, { alias: "Installing dependencies" });
+			await run$1(`cd ${name} && ${pm} run lint`, { alias: "Linting code" });
+			await run$1(`cd ${name} && ${pm} run typecheck`, { alias: "Type checking" });
+			await run$1(`cd ${name} && ${pm} run test`, { alias: "Running tests" });
+			await run$1(`cd ${name} && ${pm} run build`, { alias: "Building project" });
+			this.log.info("");
+			this.log.info(`$ cd ${name} && ${pm} run dev`.trim());
+			this.log.info("");
+		}
+	});
+};
+
+//#endregion
+//#region src/version.ts
+const packageJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+const version = packageJson.version;
+
+//#endregion
+//#region src/index.ts
+const alepha = Alepha.create({ env: {
+	LOG_LEVEL: "alepha.core:warn,info",
+	LOG_FORMAT: "raw",
+	CLI_NAME: "create-alepha",
+	CLI_DESCRIPTION: `Create Alepha v${version} - Create a new Alepha project.`
+} });
+alepha.with(CreateAlephaCoreCommands);
+run(alepha);
+
+//#endregion
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["run"],"sources":["../src/CreateAlephaCoreCommands.ts","../src/version.ts","../src/index.ts"],"sourcesContent":["import { access, mkdir } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport { $inject, AlephaError, t } from \"alepha\";\nimport { $command, CliProvider } from \"alepha/command\";\nimport { $logger } from \"alepha/logger\";\nimport * as tar from \"tar\";\n\nexport class CreateAlephaCoreCommands {\n  protected readonly log = $logger();\n  protected readonly cli = $inject(CliProvider);\n\n  protected detectPackageManager(): \"npm\" | \"yarn\" | \"pnpm\" | \"bun\" {\n    const ua = process.env.npm_config_user_agent || \"\";\n    if (ua.startsWith(\"yarn\")) return \"yarn\";\n    if (ua.startsWith(\"pnpm\")) return \"pnpm\";\n    if (ua.startsWith(\"bun\")) return \"bun\";\n    return \"npm\";\n  }\n\n  /**\n   * Download Alepha starter project from GitHub.\n   */\n  public async downloadSampleProject(targetDir: string): Promise<void> {\n    const url = \"https://api.github.com/repos/feunard/alepha/tarball/main\";\n    const response = await fetch(url, {\n      headers: {\n        \"User-Agent\": \"Alepha-CLI\",\n      },\n    });\n\n    if (!response.ok) {\n      throw new AlephaError(`Failed to download: ${response.statusText}`);\n    }\n\n    const tarStream = Readable.fromWeb(response.body as any);\n    await pipeline(\n      tarStream,\n      tar.extract({\n        cwd: targetDir,\n        strip: 3, // Remove feunard-alepha-<hash>/apps/starter prefix\n        filter: (path) => {\n          const parts = path.split(\"/\");\n          return (\n            parts.length >= 3 && parts[1] === \"apps\" && parts[2] === \"starter\"\n          );\n        },\n      }),\n    );\n  }\n\n  /**\n   * Called when no command is provided - shows help or creates a new project\n   */\n  public readonly root = $command({\n    root: true,\n    description: \"Create a new Alepha project\",\n    args: t.optional(\n      t.text({\n        title: \"name\",\n      }),\n    ),\n    summary: false,\n    handler: async ({ run, args, root }) => {\n      const name = args ?? \"my-app\";\n      const dest = join(root, name);\n\n      try {\n        await access(dest);\n        this.log.error(\n          `Directory \"${name}\" already exists. Please choose a different project name.`,\n        );\n        return;\n      } catch {\n        // Directory does not exist, proceed\n      }\n\n      const pm = this.detectPackageManager();\n\n      await mkdir(dest, { recursive: true }).catch(() => null);\n\n      await run(\"Downloading sample project\", () =>\n        this.downloadSampleProject(dest),\n      );\n\n      await run(`cd ${name} && ${pm} install`, {\n        alias: \"Installing dependencies\",\n      });\n\n      await run(`cd ${name} && ${pm} run lint`, {\n        alias: \"Linting code\",\n      });\n\n      await run(`cd ${name} && ${pm} run typecheck`, {\n        alias: \"Type checking\",\n      });\n\n      await run(`cd ${name} && ${pm} run test`, {\n        alias: \"Running tests\",\n      });\n\n      await run(`cd ${name} && ${pm} run build`, {\n        alias: \"Building project\",\n      });\n\n      this.log.info(\"\");\n      this.log.info(`$ cd ${name} && ${pm} run dev`.trim());\n      this.log.info(\"\");\n    },\n  });\n}\n","import { readFileSync } from \"node:fs\";\n\nconst packageJson = JSON.parse(\n  readFileSync(new URL(\"../package.json\", import.meta.url), \"utf-8\"),\n);\n\nexport const version = packageJson.version;\n","#!/usr/bin/env node\nimport { Alepha, run } from \"alepha\";\nimport { CreateAlephaCoreCommands } from \"./CreateAlephaCoreCommands.ts\";\nimport { version } from \"./version.ts\";\n\nconst alepha = Alepha.create({\n  env: {\n    LOG_LEVEL: \"alepha.core:warn,info\",\n    LOG_FORMAT: \"raw\",\n    CLI_NAME: \"create-alepha\",\n    CLI_DESCRIPTION: `Create Alepha v${version} - Create a new Alepha project.`,\n  },\n});\n\nalepha.with(CreateAlephaCoreCommands);\n\nrun(alepha);\n"],"mappings":";;;;;;;;;;;;AASA,IAAa,2BAAb,MAAsC;CACpC,AAAmB,MAAM,SAAS;CAClC,AAAmB,MAAM,QAAQ,YAAY;CAE7C,AAAU,uBAAwD;EAChE,MAAM,KAAK,QAAQ,IAAI,yBAAyB;AAChD,MAAI,GAAG,WAAW,OAAO,CAAE,QAAO;AAClC,MAAI,GAAG,WAAW,OAAO,CAAE,QAAO;AAClC,MAAI,GAAG,WAAW,MAAM,CAAE,QAAO;AACjC,SAAO;;;;;CAMT,MAAa,sBAAsB,WAAkC;EAEnE,MAAM,WAAW,MAAM,MADX,4DACsB,EAChC,SAAS,EACP,cAAc,cACf,EACF,CAAC;AAEF,MAAI,CAAC,SAAS,GACZ,OAAM,IAAI,YAAY,uBAAuB,SAAS,aAAa;AAIrE,QAAM,SADY,SAAS,QAAQ,SAAS,KAAY,EAGtD,IAAI,QAAQ;GACV,KAAK;GACL,OAAO;GACP,SAAS,SAAS;IAChB,MAAM,QAAQ,KAAK,MAAM,IAAI;AAC7B,WACE,MAAM,UAAU,KAAK,MAAM,OAAO,UAAU,MAAM,OAAO;;GAG9D,CAAC,CACH;;;;;CAMH,AAAgB,OAAO,SAAS;EAC9B,MAAM;EACN,aAAa;EACb,MAAM,EAAE,SACN,EAAE,KAAK,EACL,OAAO,QACR,CAAC,CACH;EACD,SAAS;EACT,SAAS,OAAO,EAAE,YAAK,MAAM,WAAW;GACtC,MAAM,OAAO,QAAQ;GACrB,MAAM,OAAO,KAAK,MAAM,KAAK;AAE7B,OAAI;AACF,UAAM,OAAO,KAAK;AAClB,SAAK,IAAI,MACP,cAAc,KAAK,2DACpB;AACD;WACM;GAIR,MAAM,KAAK,KAAK,sBAAsB;AAEtC,SAAM,MAAM,MAAM,EAAE,WAAW,MAAM,CAAC,CAAC,YAAY,KAAK;AAExD,SAAMA,MAAI,oCACR,KAAK,sBAAsB,KAAK,CACjC;AAED,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,WAAW,EACvC,OAAO,2BACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,YAAY,EACxC,OAAO,gBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,iBAAiB,EAC7C,OAAO,iBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,YAAY,EACxC,OAAO,iBACR,CAAC;AAEF,SAAMA,MAAI,MAAM,KAAK,MAAM,GAAG,aAAa,EACzC,OAAO,oBACR,CAAC;AAEF,QAAK,IAAI,KAAK,GAAG;AACjB,QAAK,IAAI,KAAK,QAAQ,KAAK,MAAM,GAAG,UAAU,MAAM,CAAC;AACrD,QAAK,IAAI,KAAK,GAAG;;EAEpB,CAAC;;;;;AC5GJ,MAAM,cAAc,KAAK,MACvB,aAAa,IAAI,IAAI,mBAAmB,OAAO,KAAK,IAAI,EAAE,QAAQ,CACnE;AAED,MAAa,UAAU,YAAY;;;;ACDnC,MAAM,SAAS,OAAO,OAAO,EAC3B,KAAK;CACH,WAAW;CACX,YAAY;CACZ,UAAU;CACV,iBAAiB,kBAAkB,QAAQ;CAC5C,EACF,CAAC;AAEF,OAAO,KAAK,yBAAyB;AAErC,IAAI,OAAO"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "create-alepha",
+  "description": "Create a new Alepha project with a single command.",
+  "author": "Nicolas Foures",
+  "version": "0.12.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "license": "MIT",
+  "bin": "./dist/index.js",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "alepha": "0.12.0",
+    "tar": "^7.5.2"
+  },
+  "devDependencies": {
+    "tsdown": "^0.16.7",
+    "vitest": "^4.0.14"
+  },
+  "scripts": {
+    "lint": "biome check --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "build": "tsdown -c=../../tsdown.config.ts"
+  },
+  "homepage": "https://github.com/feunard/alepha",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/feunard/alepha.git"
+  },
+  "keywords": [
+    "alepha",
+    "create",
+    "scaffold",
+    "typescript",
+    "framework"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/CreateAlephaCoreCommands.ts

@@ -0,0 +1,112 @@
+import { access, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { $inject, AlephaError, t } from "alepha";
+import { $command, CliProvider } from "alepha/command";
+import { $logger } from "alepha/logger";
+import * as tar from "tar";
+
+export class CreateAlephaCoreCommands {
+  protected readonly log = $logger();
+  protected readonly cli = $inject(CliProvider);
+
+  protected detectPackageManager(): "npm" | "yarn" | "pnpm" | "bun" {
+    const ua = process.env.npm_config_user_agent || "";
+    if (ua.startsWith("yarn")) return "yarn";
+    if (ua.startsWith("pnpm")) return "pnpm";
+    if (ua.startsWith("bun")) return "bun";
+    return "npm";
+  }
+
+  /**
+   * Download Alepha starter project from GitHub.
+   */
+  public async downloadSampleProject(targetDir: string): Promise<void> {
+    const url = "https://api.github.com/repos/feunard/alepha/tarball/main";
+    const response = await fetch(url, {
+      headers: {
+        "User-Agent": "Alepha-CLI",
+      },
+    });
+
+    if (!response.ok) {
+      throw new AlephaError(`Failed to download: ${response.statusText}`);
+    }
+
+    const tarStream = Readable.fromWeb(response.body as any);
+    await pipeline(
+      tarStream,
+      tar.extract({
+        cwd: targetDir,
+        strip: 3, // Remove feunard-alepha-<hash>/apps/starter prefix
+        filter: (path) => {
+          const parts = path.split("/");
+          return (
+            parts.length >= 3 && parts[1] === "apps" && parts[2] === "starter"
+          );
+        },
+      }),
+    );
+  }
+
+  /**
+   * Called when no command is provided - shows help or creates a new project
+   */
+  public readonly root = $command({
+    root: true,
+    description: "Create a new Alepha project",
+    args: t.optional(
+      t.text({
+        title: "name",
+      }),
+    ),
+    summary: false,
+    handler: async ({ run, args, root }) => {
+      const name = args ?? "my-app";
+      const dest = join(root, name);
+
+      try {
+        await access(dest);
+        this.log.error(
+          `Directory "${name}" already exists. Please choose a different project name.`,
+        );
+        return;
+      } catch {
+        // Directory does not exist, proceed
+      }
+
+      const pm = this.detectPackageManager();
+
+      await mkdir(dest, { recursive: true }).catch(() => null);
+
+      await run("Downloading sample project", () =>
+        this.downloadSampleProject(dest),
+      );
+
+      await run(`cd ${name} && ${pm} install`, {
+        alias: "Installing dependencies",
+      });
+
+      await run(`cd ${name} && ${pm} run lint`, {
+        alias: "Linting code",
+      });
+
+      await run(`cd ${name} && ${pm} run typecheck`, {
+        alias: "Type checking",
+      });
+
+      await run(`cd ${name} && ${pm} run test`, {
+        alias: "Running tests",
+      });
+
+      await run(`cd ${name} && ${pm} run build`, {
+        alias: "Building project",
+      });
+
+      this.log.info("");
+      this.log.info(`$ cd ${name} && ${pm} run dev`.trim());
+      this.log.info("");
+    },
+  });
+}

package/src/index.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { Alepha, run } from "alepha";
+import { CreateAlephaCoreCommands } from "./CreateAlephaCoreCommands.ts";
+import { version } from "./version.ts";
+
+const alepha = Alepha.create({
+  env: {
+    LOG_LEVEL: "alepha.core:warn,info",
+    LOG_FORMAT: "raw",
+    CLI_NAME: "create-alepha",
+    CLI_DESCRIPTION: `Create Alepha v${version} - Create a new Alepha project.`,
+  },
+});
+
+alepha.with(CreateAlephaCoreCommands);
+
+run(alepha);

package/src/version.ts

@@ -0,0 +1,7 @@
+import { readFileSync } from "node:fs";
+
+const packageJson = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf-8"),
+);
+
+export const version = packageJson.version;