alepha 0.15.3 → 0.15.5

package/dist/cli/index.js

@@ -1814,9 +1814,9 @@ var ShellProvider = class {};
 //#endregion
 //#region ../../src/system/index.ts
 /**
-* | type | quality | stability |
-* |------|---------|-----------|
-* | tooling | standard | stable |
+* | Stability | Since | Runtime |
+* |-----------|-------|---------|
+* | 3 - stable | 0.14.0 | node, bun, browser|
 *
 * System-level abstractions for portable code across runtimes.
 *
@@ -2238,6 +2238,18 @@ ${models.map((it) => `export const ${it} = models["${it}"];`).join("\n")}
 			return "unknown";
 		}
 	}
+	/**
+	* Get the user's email from git config.
+	*
+	* @returns The git user email or undefined if not configured
+	*/
+	async getGitEmail() {
+		try {
+			return (await this.shell.run("git config user.email", { capture: true })).trim() || void 0;
+		} catch {
+			return;
+		}
+	}
 };
 
 //#endregion
@@ -2257,13 +2269,16 @@ var devDependencies = {
 	"cron-schedule": "^6.0.0",
 	"jose": "^6.1.3",
 	"jsdom": "^27.4.0",
+	"nodemailer": "^7.0.13",
 	"openid-client": "^6.8.1",
 	"prom-client": "^15.1.3",
 	"react": "^19.2.4",
 	"react-dom": "^19.2.4",
 	"swagger-ui-dist": "^5.31.0",
 	"tsdown": "^0.20.1",
-	"vitest": "^4.0.18"
+	"vite": "^7.3.1",
+	"vitest": "^4.0.18",
+	"worker-mailer": "^1.2.1"
 };
 
 //#endregion
@@ -2288,6 +2303,7 @@ var PackageManagerUtils = class {
 	alepha = $inject(Alepha);
 	/**
 	* Detect the package manager used in the project.
+	* Checks current directory first, then workspace root if in a monorepo.
 	*/
 	async getPackageManager(root, pm) {
 		if (pm) return pm;
@@ -2295,6 +2311,9 @@ var PackageManagerUtils = class {
 		if (await this.fs.exists(this.fs.join(root, "bun.lock"))) return "bun";
 		if (await this.fs.exists(this.fs.join(root, "yarn.lock"))) return "yarn";
 		if (await this.fs.exists(this.fs.join(root, "pnpm-lock.yaml"))) return "pnpm";
+		if (await this.fs.exists(this.fs.join(root, "package-lock.json"))) return "npm";
+		const workspace = await this.getWorkspaceContext(root);
+		if (workspace.packageManager) return workspace.packageManager;
 		return "npm";
 	}
 	/**
@@ -2491,7 +2510,7 @@ var PackageManagerUtils = class {
 	generatePackageJsonContent(modes) {
 		const alephaDeps = devDependencies;
 		const dependencies = { alepha: `^${version}` };
-		const devDependencies$1 = {};
+		const devDependencies$1 = { vite: alephaDeps.vite };
 		if (!modes.isPackage) {
 			devDependencies$1["@biomejs/biome"] = alephaDeps["@biomejs/biome"];
 			if (modes.test) devDependencies$1.vitest = alephaDeps.vitest;
@@ -2543,6 +2562,7 @@ This file provides guidance to AI coding assistants when working with this Aleph
 
 ### Pages with \`$page\`
 \`\`\`tsx
+import { t } from "alepha";
 import { $page } from "alepha/react/router";
 import { $client } from "alepha/server/links";
 import type { UserController } from "./UserController.ts";
@@ -2707,31 +2727,6 @@ class AppRouter {
 }
 \`\`\`
 
-### Modules with \`$module\`
-\`\`\`typescript
-// src/api/index.ts - Groups all API services
-import { $module } from "alepha";
-
-export const ApiModule = $module({
-  name: "app.api",
-  services: [
-    UserController,
-    OrderController,
-    UserService,
-  ],
-});
-
-// src/web/index.ts - Groups all web services (React only)
-export const WebModule = $module({
-  name: "app.web",
-  services: [AppRouter, Toaster],
-  register(alepha) {
-    // Optional: configure additional services
-    alepha.with(SomeLibrary);
-  },
-});
-\`\`\`
-
 ### Environment Variables
 \`\`\`typescript
 import { $env, t } from "alepha";
@@ -2775,6 +2770,7 @@ describe("UserService", () => {
   it("should create user", async () => {
     const alepha = Alepha.create().with(UserService);
     const service = alepha.inject(UserService);
+    await alepha.start();
 
     const user = await service.create({ email: "test@example.com" });
     expect(user.email).toBe("test@example.com");
@@ -2829,13 +2825,46 @@ Full framework source available at \`node_modules/alepha/src/\`.
 
 //#endregion
 //#region ../../src/cli/templates/apiAppSecurityTs.ts
-const apiAppSecurityTs = () => {
+const apiAppSecurityTs = (opts = {}) => {
 	return `
 import { $realm } from "alepha/api/users";
 
 export class AppSecurity {
   users = $realm({
-    // configure your realm here
+    settings: {
+      // Auto-promote these users to admin on login
+      adminEmails: ${opts.adminEmail ? `["${opts.adminEmail}"]` : "[]"},
+      adminUsernames: [],
+
+      // Registration & login options
+      registrationAllowed: true,
+      emailEnabled: true,
+      emailRequired: true,
+      usernameEnabled: false,
+      usernameRequired: false,
+      phoneEnabled: false,
+      phoneRequired: false,
+
+      // Verification (requires notifications feature)
+      verifyEmailRequired: false,
+      verifyPhoneRequired: false,
+      resetPasswordAllowed: false,
+    },
+    features: {
+      // Enable additional features
+      notifications: false,
+      audits: false,
+      apiKeys: false,
+      jobs: false,
+      files: false,
+      parameters: false,
+    },
+    identities: {
+      // Enable authentication providers
+      credentials: true,
+      // google: true,
+      // github: true,
+    },
   });
 }
 `.trim();
@@ -3002,31 +3031,8 @@ run(alepha);
 
 //#endregion
 //#region ../../src/cli/templates/mainCss.ts
-const mainCss = (options = {}) => {
-	if (options.ui) return `@import "@alepha/ui/styles";`;
-	return `
-* {
-  box-sizing: border-box;
-  margin: 0;
-  padding: 0;
-}
-
-html,
-body {
-  height: 100%;
-}
-
-body {
-  font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
-    "Helvetica Neue", Arial, sans-serif;
-  line-height: 1.5;
-  -webkit-font-smoothing: antialiased;
-}
-
-#root {
-  height: 100%;
-}
-`.trim();
+const mainCss = () => {
+	return `@import "@alepha/ui/styles";`;
 };
 
 //#endregion
@@ -3080,18 +3086,18 @@ const webAppRouterTs = (options) => {
 		if (options.auth) classMembers.push("  uiAuth = $uiAuth();");
 		if (options.admin) classMembers.push("  uiAdmin = $uiAdmin();");
 		classMembers.push(`  layout = $page({
-    parent: this.ui.root,
-    children: () => [this.home],
-  });`);
+      parent: this.ui.root,
+      children: () => [this.home],
+    });`);
 	}
 	if (options.api) classMembers.push(`  home = $page({
     path: "/",
-    lazy: () => import("./components/Hello.tsx"),
+    lazy: () => import("./components/Home.tsx"),
     loader: () => this.api.hello(),
   });`);
 	else classMembers.push(`  home = $page({
     path: "/",
-    lazy: () => import("./components/Hello.tsx"),
+    lazy: () => import("./components/Home.tsx"),
   });`);
 	return `${imports.join("\n")}
 
@@ -3101,30 +3107,15 @@ ${classMembers.join("\n\n")}
 };
 
 //#endregion
-//#region ../../src/cli/templates/webHelloComponentTsx.ts
-const webHelloComponentTsx = (options = {}) => {
-	const imports = [];
-	if (options.auth) imports.push("import { UserButton } from \"@alepha/ui/auth\";");
-	imports.push("import { useState } from \"react\";");
-	const userButton = options.auth ? "\n      <UserButton />" : "";
-	return `${imports.join("\n")}
-
-interface Props {
-  message?: string;
-}
+//#region ../../src/cli/templates/webHomeComponentTsx.ts
+const webHomeComponentTsx = () => {
+	return `import { GettingStarted } from "alepha/react/intro";
 
-const Hello = (props: Props) => {
-  const [message, setMessage] = useState(props.message ?? "");
-  return (
-    <div>
-      <h1>{message}</h1>
-      <input value={message} onChange={(e) => setMessage(e.target.value)} />
-      <p>Edit this component in src/web/components/Hello.tsx</p>${userButton}
-    </div>
-  );
+const Home = () => {
+  return <GettingStarted />;
 };
 
-export default Hello;
+export default Home;
 `;
 };
 
@@ -3152,7 +3143,7 @@ export const WebModule = $module({
 * - Project structure (src/api, src/web)
 * - Configuration files (tsconfig, biome, editorconfig)
 * - Entry points (main.server.ts, main.browser.ts)
-* - Example code (HelloController, Hello component)
+* - Example code (HelloController, Home component)
 */
 var ProjectScaffolder = class {
 	log = $logger();
@@ -3251,7 +3242,7 @@ var ProjectScaffolder = class {
 			auth: opts.auth
 		}), opts.force);
 		await this.ensureFile(root, "src/api/controllers/HelloController.ts", apiHelloControllerTs(), opts.force);
-		if (opts.auth) await this.ensureFile(root, "src/api/AppSecurity.ts", apiAppSecurityTs(), opts.force);
+		if (opts.auth) await this.ensureFile(root, "src/api/AppSecurity.ts", apiAppSecurityTs({ adminEmail: opts.adminEmail }), opts.force);
 	}
 	/**
 	* Ensure web/React project structure exists.
@@ -3259,12 +3250,12 @@ var ProjectScaffolder = class {
 	* Creates:
 	* - src/main.browser.ts
 	* - src/main.css
-	* - src/web/index.ts, src/web/AppRouter.ts, src/web/components/Hello.tsx
+	* - src/web/index.ts, src/web/AppRouter.ts, src/web/components/Home.tsx
 	*/
 	async ensureWebProject(root, opts = {}) {
 		const appName = this.getAppName(root);
 		await this.fs.mkdir(this.fs.join(root, "src/web/components"), { recursive: true });
-		await this.ensureFile(root, "src/main.css", mainCss({ ui: opts.ui }), opts.force);
+		await this.ensureFile(root, "src/main.css", mainCss(), opts.force);
 		await this.ensureFile(root, "src/web/index.ts", webIndexTs({ appName }), opts.force);
 		await this.ensureFile(root, "src/web/AppRouter.ts", webAppRouterTs({
 			api: opts.api,
@@ -3272,7 +3263,7 @@ var ProjectScaffolder = class {
 			auth: opts.auth,
 			admin: opts.admin
 		}), opts.force);
-		await this.ensureFile(root, "src/web/components/Hello.tsx", webHelloComponentTsx({ auth: opts.auth }), opts.force);
+		await this.ensureFile(root, "src/web/components/Home.tsx", webHomeComponentTsx(), opts.force);
 		await this.ensureFile(root, "src/main.browser.ts", mainBrowserTs(), opts.force);
 	}
 	/**
@@ -3473,7 +3464,8 @@ var BuildCommand = class {
 				name: "add Cloudflare config",
 				handler: () => generateCloudflare({
 					distDir,
-					config: options.cloudflare?.config
+					config: options.cloudflare?.config,
+					alepha
 				})
 			});
 			if (target === "docker") {
@@ -3548,6 +3540,7 @@ var DbCommand = class {
 	log = $logger();
 	fs = $inject(FileSystemProvider);
 	utils = $inject(AlephaCliUtils);
+	pm = $inject(PackageManagerUtils);
 	entryProvider = $inject(AppEntryProvider);
 	/**
 	* Check if database migrations are up to date.
@@ -3752,6 +3745,10 @@ var DbCommand = class {
 			}
 			this.log.info("");
 			this.log.info(options.logMessage(providerName, dialect));
+			if (dialect === "sqlite") await this.pm.ensureDependency(options.root, "better-sqlite3", {
+				dev: true,
+				exec: (cmd, opts) => this.utils.exec(cmd, opts)
+			});
 			const drizzleConfigJsPath = await this.prepareDrizzleConfig({
 				kit: drizzleKitProvider,
 				provider,
@@ -4047,6 +4044,7 @@ var ViteDevServerProvider = class {
 		await this.server.ssrLoadModule(this.options.entry.server);
 		const alepha = globalThis.__alepha;
 		if (!alepha) throw new AlephaError("Alepha instance not found after loading entry module");
+		alepha.store.set("alepha.vite.server", this.server);
 		this.alepha = alepha;
 		await this.setupAlepha();
 		this.hasError = false;
@@ -4066,6 +4064,8 @@ var ViteDevServerProvider = class {
 	*/
 	async setupAlepha() {
 		if (!this.alepha || !this.hasReact()) return;
+		const devHead = await this.generateDevHead();
+		this.alepha.store.set("alepha.react.ssr.manifest", { devHead });
 		this.alepha.events.on("server:onRequest", {
 			priority: "first",
 			callback: async ({ request }) => {
@@ -4079,6 +4079,18 @@ var ViteDevServerProvider = class {
 		});
 	}
 	/**
+	* Generate dev head content by transforming a minimal HTML through Vite.
+	* This lets Vite and all plugins inject their scripts (HMR client, React Fast Refresh, etc.).
+	*/
+	async generateDevHead() {
+		const { browser, style } = this.options.entry;
+		const scripts = [];
+		if (style) scripts.push(`<link rel="stylesheet" href="/${style}">`);
+		if (browser) scripts.push(`<script type="module" src="/${browser}"><\/script>`);
+		const minimalHtml = `<!DOCTYPE html><html><head>${scripts.join("\n")}</head><body></body></html>`;
+		return (await this.server.transformIndexHtml("/", minimalHtml)).match(/<head>([\s\S]*?)<\/head>/i)?.[1]?.trim() ?? "";
+	}
+	/**
 	* Check if request is for an HTML page (not an asset).
 	*/
 	isPageRequest(req) {
@@ -4106,7 +4118,7 @@ var ViteDevServerProvider = class {
 			const originalWrite = res.write.bind(res);
 			const originalEnd = res.end.bind(res);
 			const guardedCall = (fn, ...args) => {
-				if (resolved && !ctx.metadata.vite) return;
+				if (resolved && ctx.metadata.vite) return;
 				return fn(...args);
 			};
 			res.setHeader = (...args) => guardedCall(originalSetHeader, ...args);
@@ -4488,6 +4500,8 @@ var GenCommand = class {
 //#endregion
 //#region ../../src/cli/commands/init.ts
 var InitCommand = class {
+	log = $logger();
+	colors = $inject(ConsoleColorProvider);
 	utils = $inject(AlephaCliUtils);
 	pm = $inject(PackageManagerUtils);
 	scaffolder = $inject(ProjectScaffolder);
@@ -4541,17 +4555,18 @@ var InitCommand = class {
 			let agentType = false;
 			if (flags.ai) agentType = await this.utils.isInstalledAsync("claude") ? "claude" : "agents";
 			const isExpo = await this.pm.hasExpo(root);
+			const adminEmail = flags.auth ? await this.utils.getGitEmail() : void 0;
 			const force = !!flags.force;
 			await run({
 				name: "ensuring configuration files",
 				handler: async () => {
 					await this.scaffolder.ensureConfig(root, {
 						force,
-						tsconfigJson: !workspace.config.tsconfigJson,
 						packageJson: {
 							...flags,
 							isPackage: workspace.isPackage
 						},
+						tsconfigJson: !workspace.config.tsconfigJson,
 						biomeJson: !workspace.config.biomeJson,
 						editorconfig: !workspace.config.editorconfig,
 						agentMd: agentType ? {
@@ -4567,6 +4582,7 @@ var InitCommand = class {
 					});
 					if (flags.api) await this.scaffolder.ensureApiProject(root, {
 						auth: !!flags.auth,
+						adminEmail,
 						force
 					});
 					if (flags.react && !isExpo) await this.scaffolder.ensureWebProject(root, {
@@ -4601,6 +4617,21 @@ var InitCommand = class {
 					root
 				});
 			}
+			run.end();
+			const projectName = args || ".";
+			const pmRun = pmName === "npm" ? "npm run" : pmName;
+			const c = this.colors;
+			this.log.info("");
+			this.log.info(`  ${c.set("GREEN", "✓")} Project ready!`);
+			this.log.info("");
+			this.log.info(`  ${c.set("GREY_DARK", "$")} cd ${c.set("CYAN", projectName)}`);
+			this.log.info(`  ${c.set("GREY_DARK", "$")} ${c.set("CYAN", `${pmRun} dev`)}`);
+			if (adminEmail) {
+				this.log.info("");
+				this.log.info(`  Admin email: ${c.set("GREEN", adminEmail)}`);
+				this.log.info(`  ${c.set("GREY_DARK", "(from git config, change in src/api/AppSecurity.ts)")}`);
+			}
+			this.log.info("");
 		}
 	});
 };