alepha 0.15.3 → 0.15.5

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/email/providers/WorkermailerEmailProvider.ts

@@ -0,0 +1,221 @@
+import { $atom, $env, $use, type Static, t } from "alepha";
+import { $logger } from "alepha/logger";
+import { WorkerMailer } from "worker-mailer";
+import { EmailError } from "../errors/EmailError.ts";
+import type { EmailProvider, EmailSendOptions } from "./EmailProvider.ts";
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+/**
+ * Environment variables for worker-mailer configuration
+ */
+const envSchema = t.object({
+  EMAIL_HOST: t.optional(
+    t.text({
+      description: "SMTP server host",
+    }),
+  ),
+  EMAIL_PORT: t.number({
+    default: 587,
+    description: "SMTP server port (465 or 587, not 25)",
+  }),
+  EMAIL_USER: t.optional(
+    t.text({
+      description: "SMTP authentication username",
+    }),
+  ),
+  EMAIL_PASS: t.optional(
+    t.text({
+      description: "SMTP authentication password",
+    }),
+  ),
+  EMAIL_FROM: t.optional(
+    t.text({
+      description: "Default from email address",
+    }),
+  ),
+  EMAIL_FROM_NAME: t.optional(
+    t.text({
+      description: "Default from name",
+    }),
+  ),
+  EMAIL_SECURE: t.boolean({
+    default: true,
+    description: "Use secure connection (TLS/STARTTLS)",
+  }),
+  EMAIL_AUTH_TYPE: t.optional(
+    t.enum(["plain", "login", "cram-md5"], {
+      default: "plain",
+      description: "SMTP authentication type",
+    }),
+  ),
+});
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+/**
+ * Worker-mailer specific options
+ */
+export const workermailerEmailOptions = $atom({
+  name: "alepha.email.workermailer.options",
+  schema: t.object({
+    authType: t.optional(
+      t.enum(["plain", "login", "cram-md5"], {
+        description: "SMTP authentication type (default: plain)",
+      }),
+    ),
+  }),
+  default: {},
+});
+
+export type WorkermailerEmailProviderOptions = Static<
+  typeof workermailerEmailOptions.schema
+>;
+
+declare module "alepha" {
+  interface State {
+    [workermailerEmailOptions.key]: WorkermailerEmailProviderOptions;
+  }
+}
+
+// ---------------------------------------------------------------------------------------------------------------------
+
+/**
+ * Email provider using worker-mailer for Cloudflare Workers.
+ *
+ * This provider uses Cloudflare's TCP Sockets API to send emails via SMTP,
+ * making it suitable for edge runtime environments.
+ *
+ * Configuration is provided via environment variables:
+ * - EMAIL_HOST: SMTP server host
+ * - EMAIL_PORT: SMTP server port (default: 587, note: port 25 is blocked)
+ * - EMAIL_USER: SMTP authentication username
+ * - EMAIL_PASS: SMTP authentication password
+ * - EMAIL_FROM: Default from email address
+ * - EMAIL_FROM_NAME: Default from name (optional)
+ * - EMAIL_SECURE: Use secure connection (default: true)
+ * - EMAIL_AUTH_TYPE: Authentication type - plain, login, or cram-md5 (default: plain)
+ *
+ * @example
+ * ```typescript
+ * // Configure via environment variables
+ * // EMAIL_HOST=smtp.example.com
+ * // EMAIL_PORT=587
+ * // EMAIL_USER=user@example.com
+ * // EMAIL_PASS=secret
+ * // EMAIL_FROM=noreply@example.com
+ * // EMAIL_FROM_NAME=My App
+ * // EMAIL_SECURE=true
+ * // EMAIL_AUTH_TYPE=plain
+ * ```
+ *
+ * @see https://github.com/zou-yu/worker-mailer
+ */
+export class WorkermailerEmailProvider implements EmailProvider {
+  protected readonly env = $env(envSchema);
+  protected readonly log = $logger();
+  protected readonly options = $use(workermailerEmailOptions);
+
+  protected get host(): string {
+    const host = this.env.EMAIL_HOST;
+    if (!host) {
+      throw new EmailError(
+        "Email host not configured. Set EMAIL_HOST env var.",
+      );
+    }
+    return host;
+  }
+
+  protected get port(): number {
+    return this.env.EMAIL_PORT;
+  }
+
+  protected get secure(): boolean {
+    return this.env.EMAIL_SECURE;
+  }
+
+  protected get user(): string | undefined {
+    return this.env.EMAIL_USER;
+  }
+
+  protected get pass(): string | undefined {
+    return this.env.EMAIL_PASS;
+  }
+
+  protected get fromAddress(): string {
+    const from = this.env.EMAIL_FROM;
+    if (!from) {
+      throw new EmailError(
+        "Email from address not configured. Set EMAIL_FROM env var.",
+      );
+    }
+    return from;
+  }
+
+  protected get fromName(): string | undefined {
+    return this.env.EMAIL_FROM_NAME;
+  }
+
+  protected get authType(): "plain" | "login" | "cram-md5" {
+    return this.options.authType ?? this.env.EMAIL_AUTH_TYPE ?? "plain";
+  }
+
+  public async send(options: EmailSendOptions): Promise<void> {
+    const { to, subject, body } = options;
+    this.log.debug("Sending email via worker-mailer", { to, subject });
+
+    const user = this.user;
+    const pass = this.pass;
+
+    if (!user || !pass) {
+      throw new EmailError(
+        "Email credentials not configured. Set EMAIL_USER and EMAIL_PASS env vars.",
+      );
+    }
+
+    let mailer: WorkerMailer | undefined;
+
+    try {
+      mailer = await WorkerMailer.connect({
+        credentials: {
+          username: user,
+          password: pass,
+        },
+        authType: this.authType,
+        host: this.host,
+        port: this.port,
+        secure: this.secure,
+      });
+
+      const recipients = Array.isArray(to) ? to : [to];
+
+      for (const recipient of recipients) {
+        await mailer.send({
+          from: this.fromName
+            ? { name: this.fromName, email: this.fromAddress }
+            : { email: this.fromAddress },
+          to: { email: recipient },
+          subject,
+          html: body,
+        });
+
+        this.log.info("Email sent successfully", {
+          to: recipient,
+          subject,
+        });
+      }
+    } catch (error) {
+      const message = `Failed to send email via worker-mailer: ${error instanceof Error ? error.message : String(error)}`;
+      this.log.error(message, { to, subject });
+      throw new EmailError(message, error instanceof Error ? error : undefined);
+    } finally {
+      if (mailer) {
+        try {
+          await mailer.close();
+        } catch {
+          // Ignore close errors
+        }
+      }
+    }
+  }
+}

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/lock/core/primitives/$lock.ts

@@ -302,7 +302,19 @@ export class LockPrimitive<TFunc extends AsyncFn> extends Primitive<
   protected readonly provider = $inject(LockProvider);
   protected readonly env = $env(envSchema);
   protected readonly dateTimeProvider = $inject(DateTimeProvider);
-  protected readonly id = crypto.randomUUID();
+
+  /**
+   * Lazy-initialized UUID to avoid calling crypto.randomUUID() in global scope.
+   * Cloudflare Workers doesn't allow random value generation during initialization.
+   */
+  protected _id?: string;
+  protected get id(): string {
+    if (!this._id) {
+      this._id = crypto.randomUUID();
+    }
+    return this._id;
+  }
+
   public readonly maxDuration = this.dateTimeProvider.duration(
     this.options.maxDuration ?? [5, "minutes"],
   );

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/auth/services/ReactAuth.ts

@@ -130,6 +130,8 @@ export class ReactAuth {
   }
 
   public logout() {
-    window.location.href = `${alephaServerAuthRoutes.logout}?post_logout_redirect_uri=${encodeURIComponent(window.location.origin)}`;
+    // Add cache-busting parameter to prevent browser from using cached redirect
+    const cacheBuster = Date.now();
+    window.location.href = `${alephaServerAuthRoutes.logout}?post_logout_redirect_uri=${encodeURIComponent(window.location.origin)}&_=${cacheBuster}`;
   }
 }

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.
  *