alepha 0.15.4 → 0.15.5

package/src/cli/templates/agentMd.ts

@@ -27,6 +27,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";
@@ -196,31 +197,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";
@@ -268,6 +244,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");

package/src/cli/templates/apiAppSecurityTs.ts

@@ -1,10 +1,45 @@
-export const apiAppSecurityTs = () => {
+export const apiAppSecurityTs = (opts: { adminEmail?: string } = {}) => {
+  const adminEmailsValue = opts.adminEmail ? `["${opts.adminEmail}"]` : "[]";
+
   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: ${adminEmailsValue},
+      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();

package/src/cli/templates/mainCss.ts

@@ -1,33 +1,3 @@
-export interface MainCssOptions {
-  ui?: boolean;
-}
-
-export const mainCss = (options: MainCssOptions = {}) => {
-  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();
+export const mainCss = () => {
+  return `@import "@alepha/ui/styles";`;
 };

package/src/cli/templates/webAppRouterTs.ts

@@ -47,22 +47,22 @@ export const webAppRouterTs = (options: {
     }
 
     classMembers.push(`  layout = $page({
-    parent: this.ui.root,
-    children: () => [this.home],
-  });`);
+      parent: this.ui.root,
+      children: () => [this.home],
+    });`);
   }
 
   // Home page - with or without loader
   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"),
   });`);
   }
 

package/src/cli/templates/webHomeComponentTsx.ts

@@ -0,0 +1,10 @@
+export const webHomeComponentTsx = () => {
+  return `import { GettingStarted } from "alepha/react/intro";
+
+const Home = () => {
+  return <GettingStarted />;
+};
+
+export default Home;
+`;
+};

package/src/command/helpers/Runner.ts

@@ -34,11 +34,19 @@ export interface RunnerMethod {
   ): Promise<string>;
   rm: (glob: string | string[], options?: RunOptions) => Promise<string>;
   cp: (source: string, dest: string, options?: RunOptions) => Promise<string>;
+
+  /**
+   * Ends the runner and prints a summary of executed tasks.
+   *
+   * > This is automatically called at the end of command execution.
+   * > But can be called manually if needed to print more stuff before the command ends.
+   */
+  end: () => void;
 }
 
 export class Runner {
   protected readonly log = $logger();
-  protected readonly timers: Timer[] = [];
+  protected timers: Timer[] = [];
   protected readonly startTime: number = Date.now();
   protected readonly prettyPrint = $inject(PrettyPrint);
   protected readonly alepha = $inject(Alepha);
@@ -149,6 +157,8 @@ export class Runner {
       );
     };
 
+    runFn.end = () => this.end();
+
     return runFn;
   }
 
@@ -189,6 +199,9 @@ export class Runner {
     const totalTime = ((Date.now() - this.startTime) / 1000).toFixed(1);
     this.log.info(`Total time: ${totalTime}s`);
     this.log.info(``);
+
+    // clear timers after rendering
+    this.timers = [];
   }
 
   protected async executeTask(task: Task): Promise<string> {

package/src/command/index.ts

@@ -19,9 +19,9 @@ export * from "./providers/CliProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | tooling | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.6.0 | node, bun|
  *
  * Declarative CLI command framework.
  *

package/src/core/helpers/primitive.ts

@@ -47,11 +47,6 @@ export abstract class Primitive<T extends object = {}> {
 
 // ---------------------------------------------------------------------------------------------------------------------
 
-export type PrimitiveFactory<TPrimitive extends Primitive = Primitive> = {
-  (options: TPrimitive["options"]): TPrimitive;
-  [KIND]: InstantiableClass<TPrimitive>;
-};
-
 export type PrimitiveFactoryLike<T extends object = any> = {
   (options: T): any;
   [KIND]: any;

package/src/core/index.ts

@@ -23,9 +23,9 @@ export * from "./index.shared.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | tooling | epic | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.1.0 | node, bun, workerd, browser, expo|
  *
  * Foundation of the entire framework with dependency injection and lifecycle management.
  *

package/src/datetime/index.ts

@@ -8,9 +8,9 @@ export * from "./providers/DateTimeProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | tooling | standard | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.10.0 | node, bun, workerd, browser, expo|
  *
  * Date and time operations.
  *

package/src/email/index.ts

@@ -36,9 +36,9 @@ declare module "alepha" {
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.4.0 | node, bun, workerd|
  *
  * Email delivery with template support.
  *

package/src/email/providers/LocalEmailProvider.ts

@@ -46,11 +46,11 @@ export class LocalEmailProvider implements EmailProvider {
       try {
         await this.fs.mkdir(this.directory, { recursive: true });
         this.log.info("Email directory OK", {
-          directory: this.directory,
+          at: this.directory,
         });
       } catch (error) {
         const message = `Failed to create email directory: ${error instanceof Error ? error.message : String(error)}`;
-        this.log.error(message, { directory: this.directory });
+        this.log.error(message, { at: this.directory });
         throw new EmailError(
           message,
           error instanceof Error ? error : undefined,

package/src/fake/index.ts

@@ -9,9 +9,9 @@ export * from "./providers/FakeProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | tooling | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.11.0 | node, bun, workerd, browser|
  *
  * Test data generation with Faker.js.
  *

package/src/lock/core/index.ts

@@ -15,9 +15,9 @@ export * from "./providers/MemoryLockProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.8.0 | node, bun, workerd|
  *
  * Resource locking for distributed systems.
  *

package/src/logger/index.ts

@@ -27,9 +27,9 @@ export * from "./services/Logger.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | tooling | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.5.0 | node, bun, workerd, browser, expo|
  *
  * Configurable logging with multiple outputs.
  *

package/src/logger/providers/PrettyFormatterProvider.ts

@@ -107,10 +107,17 @@ export class PrettyFormatterProvider extends LogFormatterProvider {
       return "";
     }
 
+    // hack: use vite's stack trace formatter if available
+    const vite = this.alepha.store.get("alepha.vite.server" as any);
+
+    vite?.ssrFixStacktrace(error);
+
     let str = error.stack ?? error.message;
 
     const anyError = error as any;
     while (anyError.cause && anyError.cause instanceof Error) {
+      vite?.ssrFixStacktrace(anyError.cause);
+
       str += `\nCaused by: ${anyError.cause.stack ?? anyError.cause.message}`;
       anyError.cause = anyError.cause.cause;
     }

package/src/mcp/index.ts

@@ -93,9 +93,9 @@ export { StdioMcpTransport } from "./transports/StdioMcpTransport.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | standard | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.18.0 | node, bun|
  *
  * Model Context Protocol for AI tool integration.
  *

package/src/orm/index.ts

@@ -99,9 +99,9 @@ export const SqliteProvider = NodeSqliteProvider;
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | epic | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.1.0 | node, bun, workerd|
  *
  * Full-featured database abstraction built on Drizzle ORM with complete type safety.
  *

package/src/orm/providers/drivers/NodeSqliteProvider.ts

@@ -162,7 +162,7 @@ export class NodeSqliteProvider extends DatabaseProvider {
         await this.migrate();
       }
 
-      this.log.info(`Using SQLite database at ${filepath}`);
+      this.log.info(`SQLite database OK`, { at: filepath });
     },
   });
 

package/src/queue/core/index.ts

@@ -16,9 +16,9 @@ export * from "./providers/WorkerProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | backend | epic | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.6.0 | node, bun|
  *
  * Asynchronous message processing with automatic worker management.
  *

package/src/react/auth/index.ts

@@ -22,9 +22,9 @@ declare module "alepha/react/router" {
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | frontend | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.8.0 | node, bun, browser|
  *
  * Auth-related React components and hooks.
  *

package/src/react/core/index.ts

@@ -58,9 +58,9 @@ declare module "alepha" {
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | frontend | epic | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.2.0 | node, bun, workerd, browser, expo|
  *
  * Full-stack React framework with server-side rendering.
  *

package/src/react/form/index.ts

@@ -24,9 +24,9 @@ declare module "alepha" {
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | frontend | rare | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.12.0 | node, bun, workerd, browser|
  *
  * Type-safe forms with validation.
  *

package/src/react/head/index.ts

@@ -18,9 +18,9 @@ export * from "./providers/ServerHeadProvider.ts";
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | frontend | standard | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.4.0 | node, bun, browser|
  *
  * HTML head element management.
  *

package/src/react/i18n/index.ts

@@ -21,9 +21,9 @@ declare module "alepha" {
 // ---------------------------------------------------------------------------------------------------------------------
 
 /**
- * | type | quality | stability |
- * |------|---------|-----------|
- * | frontend | standard | stable |
+ * | Stability | Since | Runtime |
+ * |-----------|-------|---------|
+ * | 3 - stable | 0.10.0 | node, bun, workerd, browser|
  *
  * Multi-language support.
  *