stratal 0.0.21 → 0.0.23

package/dist/email/index.d.mts

@@ -1,46 +1,41 @@
-import { d as ApplicationError, gn as AsyncModuleOptions, vn as DynamicModule } from "../index-ByOyTmqf.mjs";
-import { o as z } from "../index-Bnpfq6uk.mjs";
-import { g as QueueName, h as IQueueSender } from "../index-DUzWs0z7.mjs";
+import { Dn as AsyncModuleOptions, Dr as ApplicationError, kn as DynamicModule } from "../index-B_JoEl3V.mjs";
+import { a as z } from "../zod-wecrEVAs.mjs";
+import { a as QueueBinding } from "../consumer-registry-D3iMTSdy.mjs";
+import { m as IQueueSender } from "../index-B5JBRcWD.mjs";
 import { ReactElement } from "react";
 
+//#region src/email/email.error.d.ts
+declare class EmailError extends ApplicationError {}
+//#endregion
 //#region src/email/email.module.d.ts
 /**
  * SMTP configuration options
+ *
+ * URL format: `smtp://user:pass@host:port` or `smtps://user:pass@host:port`
+ * - `smtp://` → STARTTLS on port 587 (default)
+ * - `smtps://` → implicit TLS on port 465 (default)
  */
 interface SmtpConfig {
-  /** SMTP server host */
-  host: string;
-  /** SMTP server port */
-  port: number;
-  /** Use TLS */
-  secure?: boolean;
-  /** SMTP username */
-  username?: string;
-  /** SMTP password */
-  password?: string;
+  url: string;
 }
 /**
  * Email module configuration options
  */
 interface EmailModuleOptions {
-  /** Email provider type */
-  provider: 'resend' | 'smtp';
   /** Default from address */
   from: {
     name: string;
     email: string;
   };
-  /** Resend API key (required for resend provider) */
-  apiKey?: string;
-  /** SMTP configuration (required for smtp provider) */
-  smtp?: SmtpConfig;
+  /** SMTP configuration */
+  smtp: SmtpConfig;
   /** Default reply-to address */
   replyTo?: string;
   /**
-   * Queue name for email dispatch.
-   * The queue must be registered via QueueModule.registerQueue(name).
+   * Queue binding for email dispatch.
+   * The binding must be registered via QueueModule.registerQueue(binding).
    */
-  queue: QueueName;
+  queue: QueueBinding;
 }
 declare class EmailModule {
   /**
@@ -52,10 +47,9 @@ declare class EmailModule {
    * @example
    * ```typescript
    * EmailModule.forRoot({
-   *   provider: 'resend',
-   *   apiKey: env.RESEND_API_KEY,
    *   from: { name: 'App', email: 'noreply@example.com' },
-   *   queue: 'notifications-queue',
+   *   smtp: { url: 'smtp://user:pass@smtp.example.com:587' },
+   *   queue: 'NOTIFICATIONS_QUEUE',
    * })
    * ```
    */
@@ -73,8 +67,6 @@ declare class EmailModule {
    * EmailModule.forRootAsync({
    *   inject: [emailConfig.KEY],
    *   useFactory: (email) => ({
-   *     provider: email.provider,
-   *     apiKey: email.apiKey,
    *     from: email.from,
    *     smtp: email.smtp,
    *     queue: email.queue,
@@ -114,7 +106,7 @@ declare const EMAIL_TOKENS: {
   readonly EmailProvider: symbol;
   /**
    * Queue sender for email dispatch.
-   * Bound via EmailModule.forRoot({ queue: 'queue-name' })
+   * Bound via EmailModule.forRoot({ queue: 'QUEUE_BINDING_NAME' })
    */
   readonly EmailQueue: symbol;
 };
@@ -172,7 +164,6 @@ type EmailAttachment = z.infer<typeof emailAttachmentSchema>;
  *
  * Attachment after resolution, ready for email provider.
  * Content can be Buffer (for inline) or ReadableStream (for storage-based).
- * Both nodemailer and Resend support these formats directly.
  */
 interface ResolvedEmailAttachment {
   filename: string;
@@ -321,7 +312,7 @@ type SendBatchEmailInputWithTemplate = Omit<SendBatchEmailInput, 'messages'> & {
  *
  * Main facade for sending emails. Routes emails to queues for async processing.
  * The queue is injected via EMAIL_TOKENS.EmailQueue, configured by the application
- * via EmailModule.forRoot({ queue: 'queue-name' }).
+ * via EmailModule.forRoot({ queue: 'QUEUE_BINDING_NAME' }).
  *
  * @example Basic usage
  * ```typescript
@@ -407,7 +398,7 @@ interface EmailBatchSendResult {
 /**
  * Email Provider Interface
  *
- * All email provider implementations (Resend, SMTP, etc.) must implement this interface.
+ * All email provider implementations must implement this interface.
  * This allows the EmailService to work with any provider without knowing the implementation details.
  */
 interface IEmailProvider {
@@ -428,105 +419,32 @@ interface IEmailProvider {
 }
 //#endregion
 //#region src/email/services/email-provider-factory.d.ts
-/**
- * Email Provider Factory
- *
- * Creates email provider instances based on configuration.
- * Supports automatic provider selection from module options.
- *
- * Providers are loaded lazily via dynamic imports to avoid pulling in
- * heavy Node.js-only dependencies (e.g. nodemailer) at module parse time,
- * which would break Cloudflare Workers and vitest-pool-workers environments.
- */
 declare class EmailProviderFactory {
   private readonly options;
   constructor(options: EmailModuleOptions);
-  /**
-   * Create email provider instance based on configuration
-   *
-   * @returns Email provider implementation
-   * @throws EmailProviderNotSupportedError if provider is not supported
-   */
-  create(): Promise<IEmailProvider>;
-}
-//#endregion
-//#region src/email/errors/resend-api-key-missing.error.d.ts
-/**
- * ResendApiKeyMissingError
- *
- * Thrown when the Resend API key is not configured in environment variables.
- * This prevents the Resend email provider from initializing.
- *
- * Resolution: Set the RESEND_EMAIL_API_KEY environment variable.
- */
-declare class ResendApiKeyMissingError extends ApplicationError {
-  constructor();
-}
-//#endregion
-//#region src/email/errors/smtp-configuration-missing.error.d.ts
-/**
- * SmtpConfigurationMissingError
- *
- * Thrown when SMTP configuration is not found in environment variables.
- * This prevents the SMTP email provider from initializing.
- *
- * Resolution: Set the SMTP_URL environment variable with format: smtp://user:pass@host:port
- */
-declare class SmtpConfigurationMissingError extends ApplicationError {
-  constructor();
+  create(): IEmailProvider;
 }
 //#endregion
-//#region src/email/errors/smtp-host-missing.error.d.ts
+//#region src/email/providers/base-email.provider.d.ts
 /**
- * SmtpHostMissingError
+ * Base Email Provider
  *
- * Thrown when SMTP host could not be parsed from SMTP_URL or is empty.
- * This prevents the SMTP email provider from initializing.
- *
- * Resolution: Ensure SMTP_URL is correctly formatted: smtp://user:pass@host:port
+ * Abstract base class for email providers.
+ * Provides shared implementation of sendBatch() to reduce code duplication.
  */
-declare class SmtpHostMissingError extends ApplicationError {
-  constructor();
-}
-//#endregion
-//#region src/email/errors/email-smtp-connection-failed.error.d.ts
-/**
- * EmailSmtpConnectionFailedError
- *
- * Thrown when connection to SMTP server fails during email sending.
- * This is a runtime error that may be temporary.
- *
- * Resolution: Check SMTP server availability, network connectivity, or wait and retry.
- */
-declare class EmailSmtpConnectionFailedError extends ApplicationError {
-  constructor(smtpHost: string, smtpPort: number);
-}
-//#endregion
-//#region src/email/errors/email-resend-api-failed.error.d.ts
-/**
- * EmailResendApiFailedError
- *
- * Thrown when Resend API returns an error during email sending.
- * This is a runtime error from the Resend service.
- *
- * Resolution: Check Resend API status, API key validity, or wait and retry.
- */
-declare class EmailResendApiFailedError extends ApplicationError {
-  constructor();
-}
-//#endregion
-//#region src/email/errors/email-provider-not-supported.error.d.ts
-/**
- * EmailProviderNotSupportedError
- *
- * Thrown when an unsupported email provider is configured.
- * Only 'resend' and 'smtp' providers are currently supported.
- *
- * Resolution: Set EMAIL_PROVIDER to either 'resend' or 'smtp'.
- */
-declare class EmailProviderNotSupportedError extends ApplicationError {
-  constructor(provider: string);
+declare abstract class BaseEmailProvider implements IEmailProvider {
+  /**
+   * Send a single email - must be implemented by concrete providers
+   */
+  abstract send(message: ResolvedEmailMessage): Promise<EmailSendResult>;
+  /**
+   * Send multiple emails in a batch
+   *
+   * Default implementation sends emails sequentially.
+   * Concrete providers can override for optimized batch sending.
+   */
+  sendBatch(messages: ResolvedEmailMessage[]): Promise<EmailBatchSendResult>;
 }
 //#endregion
-export { EMAIL_TOKENS, EmailAddress, EmailAttachment, EmailMessage, EmailModule, EmailModuleOptions, EmailProviderFactory, EmailProviderNotSupportedError, EmailResendApiFailedError, EmailService, EmailSmtpConnectionFailedError, InlineEmailAttachment, ResendApiKeyMissingError, ResolvedEmailAttachment, ResolvedEmailMessage, SendBatchEmailInput, SendBatchEmailInputWithTemplate, SendEmailInput, SendEmailInputWithTemplate, SmtpConfig, SmtpConfigurationMissingError, SmtpHostMissingError, StorageEmailAttachment, emailAddressSchema, emailAttachmentSchema, emailMessageSchema, inlineEmailAttachmentSchema, sendBatchEmailInputSchema, sendEmailInputSchema, storageEmailAttachmentSchema };
+export { BaseEmailProvider, EMAIL_TOKENS, EmailAddress, EmailAttachment, EmailBatchSendResult, EmailError, EmailMessage, EmailModule, EmailModuleOptions, EmailProviderFactory, EmailSendResult, EmailService, IEmailProvider, InlineEmailAttachment, ResolvedEmailAttachment, ResolvedEmailMessage, SendBatchEmailInput, SendBatchEmailInputWithTemplate, SendEmailInput, SendEmailInputWithTemplate, SmtpConfig, StorageEmailAttachment, emailAddressSchema, emailAttachmentSchema, emailMessageSchema, inlineEmailAttachmentSchema, sendBatchEmailInputSchema, sendEmailInputSchema, storageEmailAttachmentSchema };
 //# sourceMappingURL=index.d.mts.map

package/dist/email/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/email/email.module.ts","../../src/email/email.tokens.ts","../../src/email/contracts/email-attachment.ts","../../src/email/contracts/email-message.contract.ts","../../src/email/contracts/send-email.input.ts","../../src/email/services/email.service.ts","../../src/email/providers/email-provider.interface.ts","../../src/email/services/email-provider-factory.ts","../../src/email/errors/resend-api-key-missing.error.ts","../../src/email/errors/smtp-configuration-missing.error.ts","../../src/email/errors/smtp-host-missing.error.ts","../../src/email/errors/email-smtp-connection-failed.error.ts","../../src/email/errors/email-resend-api-failed.error.ts","../../src/email/errors/email-provider-not-supported.error.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/email/email.error.ts","../../src/email/email.module.ts","../../src/email/email.tokens.ts","../../src/email/contracts/email-attachment.ts","../../src/email/contracts/email-message.contract.ts","../../src/email/contracts/send-email.input.ts","../../src/email/services/email.service.ts","../../src/email/providers/email-provider.interface.ts","../../src/email/services/email-provider-factory.ts","../../src/email/providers/base-email.provider.ts"],"mappings":";;;;;;;cAEa,UAAA,SAAmB,gBAAgB;;;;;;;;;;UCmD/B,UAAA;EACf,GAAG;AAAA;;;;UAMY,kBAAA;EAsEuD;EApEtE,IAAA;IAAQ,IAAA;IAAc,KAAA;EAAA;;EAGtB,IAAA,EAAM,UAAA;EC7BE;EDgCR,OAAA;EChCQ;;;;EDsCR,KAAA,EAAO,YAAY;AAAA;AAAA,cAUR,WAAA;;;;;AE5Eb;;;;;;;;;;;SF4FS,OAAA,CAAQ,OAAA,EAAS,kBAAA,GAAqB,aAAA;EE5FP;;;;;;;;;;;;;;;;;;;;EAAA,OF0H/B,YAAA,CAAa,OAAA,EAAS,kBAAA,CAAmB,kBAAA,IAAsB,aAAA;AAAA;;;;;;;;;;;ADhIxE;cEQa,YAAA;;;AFRmC;;;;ACmDhD;;;;AACK;;EAM8B;;;EAAA;EAEzB;;;;EAAA;;;;;;;;;;cEtDG,2BAAA,EAA2B,CAAA,CAAA,SAAA;;;;;;;;;AF6CxC;;;;cEhBa,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;;;;;;;;;cAwB5B,qBAAA,EAAqB,CAAA,CAAA,QAAA,WAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;KAQtB,qBAAA,GAAwB,CAAA,CAAE,KAAK,QAAQ,2BAAA;AAAA,KACvC,sBAAA,GAAyB,CAAA,CAAE,KAAK,QAAQ,4BAAA;AAAA,KACxC,eAAA,GAAkB,CAAA,CAAE,KAAK,QAAQ,qBAAA;;;;;;;UAQ5B,uBAAA;EACf,QAAA;EACA,OAAA,EAAS,MAAA,GAAS,cAAc;EAChC,WAAA;AAAA;;;;;;;;cC1EW,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;AJNiB;;;;ACmDhD;cGlCa,kBAAA,EAAkB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;KA2DnB,YAAA,GAAe,CAAA,CAAE,KAAK,QAAQ,kBAAA;;;;KAK9B,YAAA,GAAe,CAAA,CAAE,KAAK,QAAQ,kBAAA;;;;;;;KAQ9B,oBAAA,GAAuB,IAAA,CAAK,YAAA;EACtC,WAAA,GAAc,uBAAA;AAAA;;;;;;;;;;cClFH,oBAAA,EAAoB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AJgEZ;KIrDT,cAAA,GAAiB,CAAA,CAAE,KAAK,QAAQ,oBAAA;;;;;;cAO/B,yBAAA,EAAyB,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAU1B,mBAAA,GAAsB,CAAA,CAAE,KAAK,QAAQ,yBAAA;;;KC/BrC,0BAAA,GAA6B,IAAA,CAAK,cAAA;EAC5C,QAAA,GAAW,YAAA;AAAA;AAAA,KAGD,+BAAA,GAAkC,IAAA,CAAK,mBAAA;EACjD,QAAA,EAAU,0BAAA;AAAA;;;;ANVoC;;;;ACmDhD;;;;AACK;AAML;;;;;;;cKzBa,YAAA;EAAA,mBAGU,KAAA,EAAO,YAAA;cAAP,KAAA,EAAO,YAAA;ELoC5B;;;AAAmB;AAGrB;;;;EK5BQ,IAAA;IAAO,QAAA;IAAA,GAAa;EAAA,GAAS,0BAAA,GAA6B,OAAA;ELiFhB;;;;;;;;EKzD1C,SAAA,CAAU,KAAA,EAAO,+BAAA,GAAkC,OAAA;AAAA;;;;;;;;UClE1C,eAAA;;APLjB;;EOSE,SAAA;EPT8C;AAAA;;EOc9C,QAAA;;ANqCF;;EMhCE,QAAA,GAAW,MAAM;AAAA;ANiCd;AAML;;;;AANK,UMzBY,oBAAA;ENiCP;;;EM7BR,KAAA;ENmCA;;;EM9BA,UAAA;ENoCmB;AAGrB;;EMlCE,MAAA;ENyDwB;;;EMpDxB,OAAA,EAAS,eAAe;AAAA;;;;;;;UAST,cAAA;ENyEc;;;;;AAAsD;EMlEnF,IAAA,CAAK,OAAA,EAAS,oBAAA,GAAuB,OAAA,CAAQ,eAAA;;;ALtD/C;;;;EK8DE,SAAA,CAAU,QAAA,EAAU,oBAAA,KAAyB,OAAA,CAAQ,oBAAA;AAAA;;;cChE1C,oBAAA;EAAA,iBAGQ,OAAA;cAAA,OAAA,EAAS,kBAAA;EAG5B,MAAA,IAAU,cAAc;AAAA;;;;;;;;;uBCLJ,iBAAA,YAA6B,cAAA;ETP3B;;;EAAA,SSWb,IAAA,CAAK,OAAA,EAAS,oBAAA,GAAuB,OAAA,CAAQ,eAAA;;;;ARwCxD;;;EQhCQ,SAAA,CAAU,QAAA,EAAU,oBAAA,KAAyB,OAAA,CAAQ,oBAAA;AAAA"}