alepha 0.10.5 → 0.10.7

package/email.d.ts

@@ -1,6 +1,5 @@
 import * as _alepha_core1 from "alepha";
-import { Descriptor, KIND, Service, Static, TSchema } from "alepha";
-import * as _alepha_logger1 from "alepha/logger";
+import * as _alepha_logger0 from "alepha/logger";
 import { Transporter } from "nodemailer";
 
 //#region src/providers/EmailProvider.d.ts
@@ -13,230 +12,15 @@ declare abstract class EmailProvider {
   /**
    * Send an email.
    *
-   * @param to The recipient email address.
-   * @param subject The email subject.
-   * @param body The email body (HTML content).
-   *
    * @return Promise that resolves when the email is sent.
    */
-  abstract send(to: string, subject: string, body: string): Promise<void>;
+  abstract send(options: EmailSendOptions): Promise<void>;
 }
-//#endregion
-//#region src/providers/MemoryEmailProvider.d.ts
-interface EmailRecord {
-  to: string;
+type EmailSendOptions = {
+  to: string | string[];
   subject: string;
   body: string;
-  sentAt: Date;
-}
-declare class MemoryEmailProvider implements EmailProvider {
-  protected readonly log: _alepha_logger1.Logger;
-  protected emails: EmailRecord[];
-  send(to: string, subject: string, body: string): Promise<void>;
-  /**
-   * Get all emails sent through this provider (for testing purposes).
-   */
-  getEmails(): EmailRecord[];
-  /**
-   * Clear all stored emails (for testing purposes).
-   */
-  clearEmails(): void;
-  /**
-   * Get the last email sent (for testing purposes).
-   */
-  getLastEmail(): EmailRecord | undefined;
-}
-//#endregion
-//#region src/services/TemplateService.d.ts
-/**
- * Minimal template service with Handlebars-like syntax for email templating.
- * Supports simple variable substitution with {{variableName}} syntax.
- */
-declare class TemplateService {
-  /**
-   * Compile a template string with the provided values.
-   *
-   * @param template Template string with {{variableName}} placeholders
-   * @param values Object containing values to substitute
-   * @returns Compiled template string with values substituted
-   *
-   * @example
-   * ```ts
-   * const service = new TemplateService();
-   * const result = service.compile("Hello {{name}}!", { name: "John" });
-   * // Result: "Hello John!"
-   * ```
-   */
-  compile(template: string, values: Record<string, unknown>): string;
-  /**
-   * Validate that all required template variables are provided.
-   *
-   * @param template Template string
-   * @param values Values object
-   * @returns Array of missing variable names
-   */
-  validateTemplate(template: string, values: Record<string, unknown>): string[];
-  /**
-   * Extract all variable names from a template.
-   *
-   * @param template Template string
-   * @returns Array of variable names found in the template
-   */
-  extractVariables(template: string): string[];
-}
-//#endregion
-//#region src/descriptors/$email.d.ts
-/**
- * Creates an email descriptor for sending type-safe templated emails.
- *
- * The $email descriptor provides a powerful templating system for creating and sending emails
- * with full type safety and validation. It supports multiple email providers, template variable
- * validation, and automatic HTML rendering.
- *
- * **Template Engine**
- * - Simple {{variable}} syntax for dynamic content
- * - Automatic template variable validation at runtime
- * - Support for nested object properties in templates
- * - HTML email support with rich formatting
- *
- * **Type Safety**
- * - Full TypeScript support with schema validation using TypeBox
- * - Compile-time type checking for template variables
- * - Runtime validation of email data before sending
- * - Automatic type inference from schema definitions
- *
- * **Provider Flexibility**
- * - Memory provider for development and testing
- * - Support for SMTP, SendGrid, AWS SES, and other providers
- * - Custom provider implementation for specialized services
- * - Automatic fallback and error handling
- *
- * **Template Management**
- * - Reusable email templates across your application
- * - Centralized template configuration and maintenance
- * - Template variable documentation through schemas
- * - Easy testing and preview capabilities
- *
- * **Development Experience**
- * - Clear error messages for missing template variables
- * - Comprehensive logging for debugging email delivery
- * - Memory provider captures emails for testing
- * - Template validation before sending
- *
- * @example Welcome email template
- * ```typescript
- * const welcomeEmail = $email({
- *   subject: "Welcome to {{companyName}}, {{firstName}}!",
- *   body: `
- *     <h1>Welcome {{firstName}} {{lastName}}!</h1>
- *     <p>Thank you for joining {{companyName}}.</p>
- *     <p>Your account role is: <strong>{{role}}</strong></p>
- *     <p>Get started by visiting your <a href="{{dashboardUrl}}">dashboard</a>.</p>
- *   `,
- *   schema: t.object({
- *     firstName: t.text(),
- *     lastName: t.text(),
- *     companyName: t.text(),
- *     role: t.enum(["admin", "user", "manager"]),
- *     dashboardUrl: t.text()
- *   })
- * });
- *
- * // Send with full type safety
- * await welcomeEmail.send("user@example.com", {
- *   firstName: "John",
- *   lastName: "Doe",
- *   companyName: "Acme Corp",
- *   role: "user",
- *   dashboardUrl: "https://app.acme.com/dashboard"
- * });
- * ```
- *
- * @example Order confirmation email
- * ```typescript
- * const orderConfirmation = $email({
- *   subject: "Order #{{orderNumber}} confirmed - {{totalAmount}}",
- *   body: `
- *     <h1>Order Confirmed!</h1>
- *     <p>Hi {{customerName}},</p>
- *     <p>Your order #{{orderNumber}} has been confirmed.</p>
- *     <h2>Order Details:</h2>
- *     <p><strong>Total: {{totalAmount}}</strong></p>
- *     <p>Estimated delivery: {{deliveryDate}}</p>
- *   `,
- *   schema: t.object({
- *     customerName: t.text(),
- *     orderNumber: t.text(),
- *     totalAmount: t.text(),
- *     deliveryDate: t.text()
- *   })
- * });
- * ```
- *
- * @example Development with memory provider
- * ```typescript
- * const testEmail = $email({
- *   subject: "Test: {{subject}}",
- *   body: "<p>{{message}}</p>",
- *   provider: "memory", // Captures emails for testing
- *   schema: t.object({
- *     subject: t.text(),
- *     message: t.text()
- *   })
- * });
- *
- * // In tests - emails are captured, not actually sent
- * await testEmail.send("test@example.com", {
- *   subject: "Unit Test",
- *   message: "This email was captured for testing"
- * });
- * ```
- */
-declare const $email: {
-  <T extends TSchema>(options: EmailDescriptorOptions<T>): EmailDescriptor<T>;
-  [KIND]: typeof EmailDescriptor;
 };
-interface EmailDescriptorOptions<T extends TSchema> {
-  /**
-   * Email subject template. Supports {{variableName}} syntax.
-   */
-  subject: string;
-  /**
-   * Email body template (HTML content). Supports {{variableName}} syntax.
-   */
-  body: string;
-  /**
-   * Schema defining the structure of template variables.
-   */
-  schema: T;
-  /**
-   * Optional name of the email template.
-   * @default Descriptor key
-   */
-  name?: string;
-  /**
-   * Optional description of the email template.
-   */
-  description?: string;
-  /**
-   * Email provider to use. If not provided, the default provider will be used.
-   */
-  provider?: Service<EmailProvider> | "memory";
-}
-declare class EmailDescriptor<T extends TSchema> extends Descriptor<EmailDescriptorOptions<T>> {
-  protected readonly log: _alepha_logger1.Logger;
-  protected readonly templateService: TemplateService;
-  readonly provider: EmailProvider | MemoryEmailProvider;
-  get name(): string;
-  /**
-   * Send an email using the template with the provided values.
-   *
-   * @param to Recipient email address
-   * @param values Template variable values
-   */
-  send(to: string, values: Static<T>): Promise<void>;
-  protected $provider(): EmailProvider | MemoryEmailProvider;
-}
 //#endregion
 //#region src/errors/EmailError.d.ts
 declare class EmailError extends Error {
@@ -247,17 +31,38 @@ declare class EmailError extends Error {
 interface LocalEmailProviderOptions {
   /**
    * Directory to save email files.
-   * @default "email" (relative to project root)
+   * @default "node_modules/.email" (relative to project root)
    */
   directory?: string;
 }
 declare class LocalEmailProvider implements EmailProvider {
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected readonly directory: string;
   constructor(options?: LocalEmailProviderOptions);
-  send(to: string, subject: string, body: string): Promise<void>;
-  protected createEmailHtml(to: string, subject: string, body: string): string;
-  protected escapeHtml(text: string): string;
+  send(options: EmailSendOptions): Promise<void>;
+  createEmailHtml(options: {
+    to: string;
+    subject: string;
+    body: string;
+  }): string;
+  escapeHtml(text: string): string;
+}
+//#endregion
+//#region src/providers/MemoryEmailProvider.d.ts
+interface EmailRecord {
+  to: string;
+  subject: string;
+  body: string;
+  sentAt: Date;
+}
+declare class MemoryEmailProvider implements EmailProvider {
+  protected readonly log: _alepha_logger0.Logger;
+  records: EmailRecord[];
+  send(options: EmailSendOptions): Promise<void>;
+  /**
+   * Get the last email sent (for testing purposes).
+   */
+  get last(): EmailRecord | undefined;
 }
 //#endregion
 //#region src/providers/NodemailerEmailProvider.d.ts
@@ -292,12 +97,12 @@ declare class NodemailerEmailProvider implements EmailProvider {
     EMAIL_FROM: string;
     EMAIL_SECURE: boolean;
   };
-  protected readonly log: _alepha_logger1.Logger;
+  protected readonly log: _alepha_logger0.Logger;
   protected transporter: Transporter;
   protected fromAddress: string;
   readonly options: NodemailerEmailProviderOptions;
   constructor();
-  send(to: string, subject: string, body: string): Promise<void>;
+  send(options: EmailSendOptions): Promise<void>;
   protected createTransporter(): Transporter;
   /**
    * Verify the connection to the email server.
@@ -312,6 +117,17 @@ declare class NodemailerEmailProvider implements EmailProvider {
 }
 //#endregion
 //#region src/index.d.ts
+declare module "alepha" {
+  interface Hooks {
+    "email:sending": {
+      to: string | string[];
+      template: string;
+      variables: Record<string, unknown>;
+      provider: EmailProvider;
+      abort(): void;
+    };
+  }
+}
 /**
  * Provides email sending capabilities for Alepha applications with multiple provider backends.
  *
@@ -324,5 +140,5 @@ declare class NodemailerEmailProvider implements EmailProvider {
  */
 declare const AlephaEmail: _alepha_core1.Service<_alepha_core1.Module<{}>>;
 //#endregion
-export { $email, AlephaEmail, EmailDescriptor, EmailDescriptorOptions, EmailError, EmailProvider, EmailRecord, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions, TemplateService };
+export { AlephaEmail, EmailError, EmailProvider, EmailRecord, EmailSendOptions, LocalEmailProvider, LocalEmailProviderOptions, MemoryEmailProvider, NodemailerEmailProvider, NodemailerEmailProviderOptions };
 //# sourceMappingURL=index.d.ts.map

package/lock.d.ts

@@ -273,7 +273,7 @@ declare const $lock: {
   <TFunc extends AsyncFn>(options: LockDescriptorOptions<TFunc>): LockDescriptor<TFunc>;
   [KIND]: typeof LockDescriptor;
 };
-interface LockDescriptorOptions<TFunc extends AsyncFn> {
+interface LockDescriptorOptions<TFunc$1 extends AsyncFn> {
   /**
    * The function to execute when the lock is successfully acquired.
    *
@@ -308,7 +308,7 @@ interface LockDescriptorOptions<TFunc extends AsyncFn> {
    * }
    * ```
    */
-  handler: TFunc;
+  handler: TFunc$1;
   /**
    * Whether the lock should wait for other instances to complete before giving up.
    *
@@ -388,7 +388,7 @@ interface LockDescriptorOptions<TFunc extends AsyncFn> {
    * });
    * ```
    */
-  name?: string | ((...args: Parameters<TFunc>) => string);
+  name?: string | ((...args: Parameters<TFunc$1>) => string);
   /**
    * Maximum duration the lock can be held before it expires automatically.
    *
@@ -474,7 +474,7 @@ interface LockDescriptorOptions<TFunc extends AsyncFn> {
    * });
    * ```
    */
-  gracePeriod?: ((...args: Parameters<TFunc>) => DurationLike | undefined) | DurationLike;
+  gracePeriod?: ((...args: Parameters<TFunc$1>) => DurationLike | undefined) | DurationLike;
 }
 declare const envSchema: _alepha_core1.TObject<{
   LOCK_PREFIX_KEY: _alepha_core1.TString;
@@ -482,7 +482,7 @@ declare const envSchema: _alepha_core1.TObject<{
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
 }
-declare class LockDescriptor<TFunc extends AsyncFn> extends Descriptor<LockDescriptorOptions<TFunc>> {
+declare class LockDescriptor<TFunc$1 extends AsyncFn> extends Descriptor<LockDescriptorOptions<TFunc$1>> {
   protected readonly log: _alepha_logger0.Logger;
   protected readonly provider: LockProvider;
   protected readonly env: {
@@ -496,14 +496,14 @@ declare class LockDescriptor<TFunc extends AsyncFn> extends Descriptor<LockDescr
       name: _alepha_core1.TString;
     }>;
   }>;
-  run(...args: Parameters<TFunc>): Promise<void>;
+  run(...args: Parameters<TFunc$1>): Promise<void>;
   /**
    * Set the lock for the given key.
    */
   protected lock(key: string): Promise<LockResult>;
-  protected setGracePeriod(key: string, lock: LockResult, ...args: Parameters<TFunc>): Promise<void>;
+  protected setGracePeriod(key: string, lock: LockResult, ...args: Parameters<TFunc$1>): Promise<void>;
   protected wait(key: string, maxDuration: DurationLike): Promise<void>;
-  protected key(...args: Parameters<TFunc>): string;
+  protected key(...args: Parameters<TFunc$1>): string;
   protected parse(value: string): LockResult;
 }
 interface LockResult {

package/logger.d.ts

@@ -269,7 +269,6 @@ declare module "alepha" {
   }
 }
 //# sourceMappingURL=index.d.ts.map
-
 //#endregion
 export { $logger, AlephaLogger, ConsoleColorProvider, ConsoleDestinationProvider, JsonFormatterProvider, LogDestinationProvider, LogEntry, LogFormatterProvider, Logger, LoggerDescriptorOptions, MemoryDestinationProvider, SimpleFormatterProvider, logEntrySchema };
 //# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "alepha",
-	"version": "0.10.5",
+	"version": "0.10.7",
 	"type": "module",
 	"engines": {
 		"node": ">=22.0.0"
@@ -15,55 +15,58 @@
 	"main": "./core.js",
 	"types": "./core.d.ts",
 	"dependencies": {
-		"@alepha/api-files": "0.10.5",
-		"@alepha/api-jobs": "0.10.5",
-		"@alepha/api-users": "0.10.5",
-		"@alepha/batch": "0.10.5",
-		"@alepha/bucket": "0.10.5",
-		"@alepha/cache": "0.10.5",
-		"@alepha/cache-redis": "0.10.5",
-		"@alepha/command": "0.10.5",
-		"@alepha/core": "0.10.5",
-		"@alepha/datetime": "0.10.5",
-		"@alepha/devtools": "0.10.5",
-		"@alepha/email": "0.10.5",
-		"@alepha/file": "0.10.5",
-		"@alepha/lock": "0.10.5",
-		"@alepha/lock-redis": "0.10.5",
-		"@alepha/logger": "0.10.5",
-		"@alepha/postgres": "0.10.5",
-		"@alepha/queue": "0.10.5",
-		"@alepha/queue-redis": "0.10.5",
-		"@alepha/react": "0.10.5",
-		"@alepha/react-auth": "0.10.5",
-		"@alepha/react-form": "0.10.5",
-		"@alepha/react-head": "0.10.5",
-		"@alepha/react-i18n": "0.10.5",
-		"@alepha/redis": "0.10.5",
-		"@alepha/retry": "0.10.5",
-		"@alepha/router": "0.10.5",
-		"@alepha/scheduler": "0.10.5",
-		"@alepha/security": "0.10.5",
-		"@alepha/server": "0.10.5",
-		"@alepha/server-cache": "0.10.5",
-		"@alepha/server-compress": "0.10.5",
-		"@alepha/server-cookies": "0.10.5",
-		"@alepha/server-cors": "0.10.5",
-		"@alepha/server-health": "0.10.5",
-		"@alepha/server-helmet": "0.10.5",
-		"@alepha/server-links": "0.10.5",
-		"@alepha/server-metrics": "0.10.5",
-		"@alepha/server-multipart": "0.10.5",
-		"@alepha/server-proxy": "0.10.5",
-		"@alepha/server-security": "0.10.5",
-		"@alepha/server-static": "0.10.5",
-		"@alepha/server-swagger": "0.10.5",
-		"@alepha/topic": "0.10.5",
-		"@alepha/topic-redis": "0.10.5",
-		"@alepha/vite": "0.10.5"
+		"@alepha/api-files": "0.10.7",
+		"@alepha/api-jobs": "0.10.7",
+		"@alepha/api-notifications": "0.10.7",
+		"@alepha/api-users": "0.10.7",
+		"@alepha/api-verifications": "0.10.7",
+		"@alepha/batch": "0.10.7",
+		"@alepha/bucket": "0.10.7",
+		"@alepha/cache": "0.10.7",
+		"@alepha/cache-redis": "0.10.7",
+		"@alepha/command": "0.10.7",
+		"@alepha/core": "0.10.7",
+		"@alepha/datetime": "0.10.7",
+		"@alepha/devtools": "0.10.7",
+		"@alepha/email": "0.10.7",
+		"@alepha/file": "0.10.7",
+		"@alepha/lock": "0.10.7",
+		"@alepha/lock-redis": "0.10.7",
+		"@alepha/logger": "0.10.7",
+		"@alepha/postgres": "0.10.7",
+		"@alepha/queue": "0.10.7",
+		"@alepha/queue-redis": "0.10.7",
+		"@alepha/react": "0.10.7",
+		"@alepha/react-auth": "0.10.7",
+		"@alepha/react-form": "0.10.7",
+		"@alepha/react-head": "0.10.7",
+		"@alepha/react-i18n": "0.10.7",
+		"@alepha/redis": "0.10.7",
+		"@alepha/retry": "0.10.7",
+		"@alepha/router": "0.10.7",
+		"@alepha/scheduler": "0.10.7",
+		"@alepha/security": "0.10.7",
+		"@alepha/server": "0.10.7",
+		"@alepha/server-cache": "0.10.7",
+		"@alepha/server-compress": "0.10.7",
+		"@alepha/server-cookies": "0.10.7",
+		"@alepha/server-cors": "0.10.7",
+		"@alepha/server-health": "0.10.7",
+		"@alepha/server-helmet": "0.10.7",
+		"@alepha/server-links": "0.10.7",
+		"@alepha/server-metrics": "0.10.7",
+		"@alepha/server-multipart": "0.10.7",
+		"@alepha/server-proxy": "0.10.7",
+		"@alepha/server-security": "0.10.7",
+		"@alepha/server-static": "0.10.7",
+		"@alepha/server-swagger": "0.10.7",
+		"@alepha/topic": "0.10.7",
+		"@alepha/topic-redis": "0.10.7",
+		"@alepha/ui": "0.10.7",
+		"@alepha/vite": "0.10.7"
 	},
 	"devDependencies": {
-		"tsdown": "^0.15.6"
+		"tsdown": "^0.15.9"
 	},
 	"scripts": {
 		"build": "node build.ts"
@@ -101,11 +104,21 @@
 			"require": "./api/jobs.cjs",
 			"types": "./api/jobs.d.ts"
 		},
+		"./api/notifications": {
+			"import": "./api/notifications.js",
+			"require": "./api/notifications.cjs",
+			"types": "./api/notifications.d.ts"
+		},
 		"./api/users": {
 			"import": "./api/users.js",
 			"require": "./api/users.cjs",
 			"types": "./api/users.d.ts"
 		},
+		"./api/verifications": {
+			"import": "./api/verifications.js",
+			"require": "./api/verifications.cjs",
+			"types": "./api/verifications.d.ts"
+		},
 		"./batch": {
 			"import": "./batch.js",
 			"require": "./batch.cjs",
@@ -316,6 +329,11 @@
 			"require": "./topic/redis.cjs",
 			"types": "./topic/redis.d.ts"
 		},
+		"./ui": {
+			"import": "./ui.js",
+			"require": "./ui.cjs",
+			"types": "./ui.d.ts"
+		},
 		"./vite": {
 			"import": "./vite.js",
 			"require": "./vite.cjs",
@@ -326,7 +344,9 @@
 		"alepha",
 		"api-files",
 		"api-jobs",
+		"api-notifications",
 		"api-users",
+		"api-verifications",
 		"batch",
 		"bucket",
 		"cache",
@@ -369,6 +389,7 @@
 		"server-swagger",
 		"topic",
 		"topic-redis",
+		"ui",
 		"vite"
 	]
 }