@groundbrick/email-service 1.1.3 → 1.1.4

package/dist/EmailService.d.ts

@@ -0,0 +1,24 @@
+import { EmailConfig, EmailMessage, EmailResult, DeliveryReport, WebhookValidationResult, WebhookValidationOptions } from './interfaces/IEmailProvider.js';
+/**
+ * EmailService - Main entry point for sending emails
+ *
+ * Unlike SmsService, this class allows multiple instances to support
+ * different configurations (useful for multi-tenancy or different email contexts)
+ */
+export declare class EmailService {
+    private provider;
+    constructor(config: EmailConfig);
+    /**
+     * Send an email message
+     */
+    send(message: EmailMessage): Promise<EmailResult>;
+    /**
+     * Get delivery report for a sent email
+     */
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    /**
+     * Validate a webhook payload from the email provider
+     */
+    validateWebhook(payload: any, signature?: string, options?: WebhookValidationOptions): WebhookValidationResult;
+}
+//# sourceMappingURL=EmailService.d.ts.map

package/dist/EmailService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailService.d.ts","sourceRoot":"","sources":["../src/EmailService.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AAGxC;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAiB;gBAErB,MAAM,EAAE,WAAW;IAI/B;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAIvD;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI1E;;OAEG;IACH,eAAe,CACb,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB;CAG3B"}

package/dist/EmailService.js

@@ -0,0 +1,32 @@
+import { EmailServiceFactory } from './EmailServiceFactory.js';
+/**
+ * EmailService - Main entry point for sending emails
+ *
+ * Unlike SmsService, this class allows multiple instances to support
+ * different configurations (useful for multi-tenancy or different email contexts)
+ */
+export class EmailService {
+    provider;
+    constructor(config) {
+        this.provider = EmailServiceFactory.create(config);
+    }
+    /**
+     * Send an email message
+     */
+    async send(message) {
+        return this.provider.send(message);
+    }
+    /**
+     * Get delivery report for a sent email
+     */
+    async getDeliveryReport(messageId) {
+        return this.provider.getDeliveryReport(messageId);
+    }
+    /**
+     * Validate a webhook payload from the email provider
+     */
+    validateWebhook(payload, signature, options) {
+        return this.provider.validateWebhook(payload, signature, options);
+    }
+}
+//# sourceMappingURL=EmailService.js.map

package/dist/EmailService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailService.js","sourceRoot":"","sources":["../src/EmailService.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IACf,QAAQ,CAAiB;IAEjC,YAAY,MAAmB;QAC7B,IAAI,CAAC,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAqB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,eAAe,CACb,OAAY,EACZ,SAAkB,EAClB,OAAkC;QAElC,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/EmailServiceFactory.d.ts

@@ -0,0 +1,5 @@
+import { IEmailProvider, EmailConfig } from './interfaces/IEmailProvider.js';
+export declare class EmailServiceFactory {
+    static create(config: EmailConfig): IEmailProvider;
+}
+//# sourceMappingURL=EmailServiceFactory.d.ts.map

package/dist/EmailServiceFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailServiceFactory.d.ts","sourceRoot":"","sources":["../src/EmailServiceFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAM7E,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc;CAkBnD"}

package/dist/EmailServiceFactory.js

@@ -0,0 +1,21 @@
+import { GatewayApiEmailProvider } from './providers/GatewayApiEmailProvider.js';
+import { MockEmailProvider } from './providers/MockEmailProvider.js';
+import { RedirectEmailProvider } from './providers/RedirectEmailProvider.js';
+import { SweegoEmailProvider } from './providers/SweegoEmailProvider.js';
+export class EmailServiceFactory {
+    static create(config) {
+        switch (config.provider) {
+            case 'gatewayapi':
+                return new GatewayApiEmailProvider(config.config);
+            case 'mock':
+                return new MockEmailProvider(config.config);
+            case 'redirect':
+                return new RedirectEmailProvider(config.config);
+            case 'sweego':
+                return new SweegoEmailProvider(config.config);
+            default:
+                throw new Error(`Provider ${config.provider} not supported`);
+        }
+    }
+}
+//# sourceMappingURL=EmailServiceFactory.js.map

package/dist/EmailServiceFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailServiceFactory.js","sourceRoot":"","sources":["../src/EmailServiceFactory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,MAAM,CAAC,MAAmB;QAC/B,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;YACxB,KAAK,YAAY;gBACf,OAAO,IAAI,uBAAuB,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;YAE3D,KAAK,MAAM;gBACT,OAAO,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;YAErD,KAAK,UAAU;gBACb,OAAO,IAAI,qBAAqB,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;YAEzD,KAAK,QAAQ;gBACX,OAAO,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;YAEvD;gBACE,MAAM,IAAI,KAAK,CAAC,YAAY,MAAM,CAAC,QAAQ,gBAAgB,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { EmailService } from './EmailService.js';
+export { EmailServiceFactory } from './EmailServiceFactory.js';
+export * from './interfaces/IEmailProvider.js';
+export * from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,cAAc,gCAAgC,CAAC;AAG/C,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+// Main service
+export { EmailService } from './EmailService.js';
+export { EmailServiceFactory } from './EmailServiceFactory.js';
+// Interfaces and types
+export * from './interfaces/IEmailProvider.js';
+// Providers
+export * from './providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAe;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,uBAAuB;AACvB,cAAc,gCAAgC,CAAC;AAE/C,YAAY;AACZ,cAAc,sBAAsB,CAAC"}

package/dist/interfaces/IEmailProvider.d.ts

@@ -0,0 +1,103 @@
+export interface IEmailProvider {
+    send(message: EmailMessage): Promise<EmailResult>;
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    validateWebhook(payload: any, signature?: string, options?: WebhookValidationOptions): WebhookValidationResult;
+}
+export interface WebhookValidationOptions {
+    headers?: Record<string, string | string[] | undefined>;
+    rawBody?: string;
+}
+export interface EmailAddress {
+    address: string;
+    name?: string;
+}
+export interface EmailAttachment {
+    filename: string;
+    content: Buffer | string;
+    contentType: string;
+}
+export interface EmailTemplate {
+    id?: string;
+    variables: Record<string, string>;
+}
+export interface EmailTracking {
+    opens: boolean;
+    clicks: boolean;
+}
+export interface EmailMessage {
+    to: EmailAddress | EmailAddress[];
+    from?: EmailAddress;
+    cc?: EmailAddress[];
+    bcc?: EmailAddress[];
+    replyTo?: EmailAddress;
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: EmailAttachment[];
+    template?: EmailTemplate;
+    tracking?: EmailTracking;
+    metadata?: Record<string, any>;
+}
+export interface EmailResult {
+    success: boolean;
+    messageId?: string;
+    status: EmailStatus;
+    timestamp: Date;
+    error?: string;
+    providerResponse?: any;
+}
+export declare enum EmailStatus {
+    QUEUED = "queued",
+    SENT = "sent",
+    DELIVERED = "delivered",
+    BOUNCED = "bounced",
+    FAILED = "failed",
+    DEFERRED = "deferred",
+    BLOCKED = "blocked"
+}
+export interface DeliveryReport {
+    messageId: string;
+    status: EmailStatus;
+    timestamp: Date;
+    recipient?: string;
+    error?: string;
+    providerData?: any;
+}
+export interface WebhookValidationResult {
+    isValid: boolean;
+    payload?: DeliveryReport;
+    error?: string;
+}
+export type EmailProviderType = 'gatewayapi' | 'mock' | 'redirect' | 'sweego';
+export interface EmailConfig {
+    provider: EmailProviderType;
+    config: GatewayApiEmailConfig | MockEmailConfig | RedirectEmailConfig | SweegoEmailConfig;
+}
+export interface GatewayApiEmailConfig {
+    token: string;
+    baseUrl?: string;
+    webhookSecret?: string;
+    defaultFrom: EmailAddress;
+}
+export interface MockEmailConfig {
+    simulateDelay?: number;
+    simulateFailures?: boolean;
+    defaultFrom: EmailAddress;
+}
+export interface RedirectEmailConfig {
+    redirectTo: string;
+    defaultFrom: EmailAddress;
+    addOriginalToSubject?: boolean;
+    baseProvider?: IEmailProvider;
+}
+export interface SweegoEmailConfig {
+    defaultFrom: EmailAddress;
+    apiKey?: string;
+    accessToken?: string;
+    baseUrl?: string;
+    providerSlug?: string;
+    clientId?: string;
+    channel?: string;
+    webhookSecret?: string;
+}
+//# sourceMappingURL=IEmailProvider.d.ts.map

package/dist/interfaces/IEmailProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEmailProvider.d.ts","sourceRoot":"","sources":["../../src/interfaces/IEmailProvider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAClD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrE,eAAe,CACb,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,uBAAuB,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,GAAG,CAAC;CACxB;AAED,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,OAAO,YAAY;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EACF,qBAAqB,GACrB,eAAe,GACf,mBAAmB,GACnB,iBAAiB,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,YAAY,CAAC;CAC3B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,YAAY,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,YAAY,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/interfaces/IEmailProvider.js

@@ -0,0 +1,11 @@
+export var EmailStatus;
+(function (EmailStatus) {
+    EmailStatus["QUEUED"] = "queued";
+    EmailStatus["SENT"] = "sent";
+    EmailStatus["DELIVERED"] = "delivered";
+    EmailStatus["BOUNCED"] = "bounced";
+    EmailStatus["FAILED"] = "failed";
+    EmailStatus["DEFERRED"] = "deferred";
+    EmailStatus["BLOCKED"] = "blocked";
+})(EmailStatus || (EmailStatus = {}));
+//# sourceMappingURL=IEmailProvider.js.map

package/dist/interfaces/IEmailProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEmailProvider.js","sourceRoot":"","sources":["../../src/interfaces/IEmailProvider.ts"],"names":[],"mappings":"AA4DA,MAAM,CAAN,IAAY,WAQX;AARD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,4BAAa,CAAA;IACb,sCAAuB,CAAA;IACvB,kCAAmB,CAAA;IACnB,gCAAiB,CAAA;IACjB,oCAAqB,CAAA;IACrB,kCAAmB,CAAA;AACrB,CAAC,EARW,WAAW,KAAX,WAAW,QAQtB"}

package/dist/providers/GatewayApiEmailProvider.d.ts

@@ -0,0 +1,41 @@
+import { IEmailProvider, EmailMessage, EmailResult, DeliveryReport, WebhookValidationResult, GatewayApiEmailConfig, WebhookValidationOptions } from '../interfaces/IEmailProvider.js';
+export declare class GatewayApiEmailProvider implements IEmailProvider {
+    private token;
+    private baseUrl;
+    private webhookSecret?;
+    private defaultFrom;
+    constructor(config: GatewayApiEmailConfig);
+    send(message: EmailMessage): Promise<EmailResult>;
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    validateWebhook(payload: any, signature?: string, _options?: WebhookValidationOptions): WebhookValidationResult;
+    /**
+     * Format email address to string format (Name <email@example.com> or email@example.com)
+     */
+    private formatAddress;
+    /**
+     * Build recipients array for GatewayAPI format
+     */
+    private buildRecipients;
+    private mapRecipientAddress;
+    /**
+     * Encode attachments to base64
+     */
+    private encodeAttachments;
+    private convertTextToHtml;
+    private convertHtmlToPlainText;
+    /**
+     * Build callback URL, adding https:// if needed
+     */
+    private buildCallbackUrl;
+    /**
+     * Map GatewayAPI email status codes to our EmailStatus enum
+     * Based on GatewayAPI documentation:
+     * - PROCESSED: successfully received and ready to send
+     * - DELIVERED: successfully delivered
+     * - DEFERRED: delayed (temporary issue with recipient server)
+     * - BOUNCED: could not be delivered (typically unknown address)
+     * - BLOCKED: blocked by the server
+     */
+    private mapGatewayApiStatus;
+}
+//# sourceMappingURL=GatewayApiEmailProvider.d.ts.map

package/dist/providers/GatewayApiEmailProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayApiEmailProvider.d.ts","sourceRoot":"","sources":["../../src/providers/GatewayApiEmailProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EAIrB,wBAAwB,EAC3B,MAAM,iCAAiC,CAAC;AAGzC,qBAAa,uBAAwB,YAAW,cAAc;IAC1D,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAe;gBAEtB,MAAM,EAAE,qBAAqB;IAOnC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAmFjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IA8B1E,eAAe,CACX,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,wBAAwB,GACpC,uBAAuB;IA0C1B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;CAY9B"}

package/dist/providers/GatewayApiEmailProvider.js

@@ -0,0 +1,270 @@
+import { EmailStatus } from '../interfaces/IEmailProvider.js';
+import jwt from 'jsonwebtoken';
+export class GatewayApiEmailProvider {
+    token;
+    baseUrl;
+    webhookSecret;
+    defaultFrom;
+    constructor(config) {
+        this.token = config.token;
+        this.baseUrl = config.baseUrl;
+        this.webhookSecret = config.webhookSecret;
+        this.defaultFrom = config.defaultFrom;
+    }
+    async send(message) {
+        try {
+            // Encode token as Base64 for Basic Auth
+            const authHeader = `Basic ${Buffer.from(this.token + ':').toString('base64')}`;
+            const templateKeys = message.template?.variables
+                ? Object.keys(message.template.variables)
+                : undefined;
+            const htmlContent = message.html ?? this.convertTextToHtml(message.text);
+            if (!htmlContent) {
+                throw new Error('Email message must include html or text content');
+            }
+            const plainTextContent = message.text ?? this.convertHtmlToPlainText(message.html);
+            // Build request body according to GatewayAPI Email docs
+            const requestBody = {
+                html: htmlContent,
+                plaintext: plainTextContent,
+                subject: message.subject,
+                from: this.formatAddress(message.from || this.defaultFrom),
+                recipients: this.buildRecipients(message, templateKeys),
+                userref: message.metadata?.reference,
+                callback_url: this.buildCallbackUrl(message.metadata?.callbackUrl)
+            };
+            if (message.replyTo) {
+                requestBody.reply = this.formatAddress(message.replyTo);
+            }
+            // Handle templates with tags
+            if (templateKeys && templateKeys.length > 0) {
+                requestBody.tags = templateKeys.map(key => `%${key}`);
+            }
+            // Handle attachments
+            if (message.attachments && message.attachments.length > 0) {
+                requestBody.attachments = this.encodeAttachments(message.attachments);
+            }
+            const response = await fetch(`${this.baseUrl}/rest/email`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': authHeader,
+                    'Content-Type': 'application/json'
+                },
+                body: JSON.stringify(requestBody)
+            });
+            const responseData = await response.json();
+            if (!response.ok) {
+                return {
+                    success: false,
+                    status: EmailStatus.FAILED,
+                    timestamp: new Date(),
+                    error: responseData.message || `HTTP ${response.status}`,
+                    providerResponse: responseData
+                };
+            }
+            // GatewayAPI returns an array of message IDs
+            const messageId = responseData.ids?.[0]?.toString();
+            return {
+                success: true,
+                messageId,
+                status: EmailStatus.QUEUED, // GatewayAPI returns PROCESSED initially
+                timestamp: new Date(),
+                providerResponse: responseData
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                status: EmailStatus.FAILED,
+                timestamp: new Date(),
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    async getDeliveryReport(messageId) {
+        try {
+            const authHeader = `Basic ${Buffer.from(this.token + ':').toString('base64')}`;
+            const response = await fetch(`${this.baseUrl}/rest/email/${messageId}`, {
+                method: 'GET',
+                headers: {
+                    'Authorization': authHeader
+                }
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = await response.json();
+            return {
+                messageId,
+                status: this.mapGatewayApiStatus(data.status),
+                timestamp: data.time ? new Date(data.time * 1000) : new Date(),
+                recipient: data.email_address,
+                providerData: data
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    validateWebhook(payload, signature, _options) {
+        try {
+            // If webhook secret is configured, validate the signature
+            if (this.webhookSecret && signature) {
+                try {
+                    jwt.verify(signature, this.webhookSecret);
+                }
+                catch {
+                    return { isValid: false, error: 'Invalid webhook signature' };
+                }
+            }
+            // Validate payload structure (delivery report)
+            if (!payload.id || !payload.status) {
+                return {
+                    isValid: false,
+                    error: 'Invalid webhook payload: missing id or status'
+                };
+            }
+            // Parse delivery report from GatewayAPI webhook
+            const deliveryReport = {
+                messageId: payload.id?.toString() || '',
+                status: this.mapGatewayApiStatus(payload.status),
+                timestamp: payload.time ? new Date(payload.time * 1000) : new Date(),
+                recipient: payload.email_address,
+                error: payload.details,
+                providerData: payload
+            };
+            return {
+                isValid: true,
+                payload: deliveryReport
+            };
+        }
+        catch (error) {
+            return {
+                isValid: false,
+                error: error instanceof Error ? error.message : String(error)
+            };
+        }
+    }
+    /**
+     * Format email address to string format (Name <email@example.com> or email@example.com)
+     */
+    formatAddress(address) {
+        const normalizedAddress = (address.address || '').trim();
+        if (!normalizedAddress) {
+            throw new Error('Sender address is required');
+        }
+        // GatewayAPI email endpoint expects a single RFC5322 mailbox string without extra metadata.
+        return normalizedAddress;
+    }
+    /**
+     * Build recipients array for GatewayAPI format
+     */
+    buildRecipients(message, templateKeys) {
+        const recipients = [];
+        // Main recipients (to)
+        const toAddresses = Array.isArray(message.to) ? message.to : [message.to];
+        for (const to of toAddresses) {
+            const recipient = {
+                address: to.address
+            };
+            if (to.name) {
+                recipient.name = to.name;
+            }
+            // Add template variables if provided
+            if (templateKeys && templateKeys.length && message.template?.variables) {
+                recipient.tagvalues = templateKeys.map(key => message.template.variables[key] ?? '');
+            }
+            if (message.cc && message.cc.length > 0) {
+                recipient.cc = message.cc.map(cc => this.mapRecipientAddress(cc));
+            }
+            if (message.bcc && message.bcc.length > 0) {
+                recipient.bcc = message.bcc.map(bcc => this.mapRecipientAddress(bcc));
+            }
+            recipients.push(recipient);
+        }
+        return recipients;
+    }
+    mapRecipientAddress(address) {
+        return address.name
+            ? { address: address.address, name: address.name }
+            : { address: address.address };
+    }
+    /**
+     * Encode attachments to base64
+     */
+    encodeAttachments(attachments) {
+        return attachments.map(attachment => {
+            const content = attachment.content instanceof Buffer
+                ? attachment.content.toString('base64')
+                : Buffer.from(attachment.content).toString('base64');
+            return {
+                filename: attachment.filename,
+                data: content,
+                mimetype: attachment.contentType
+            };
+        });
+    }
+    convertTextToHtml(text) {
+        if (!text) {
+            return undefined;
+        }
+        const escaped = text
+            .replace(/&/g, '&amp;')
+            .replace(/</g, '&lt;')
+            .replace(/>/g, '&gt;');
+        return `<pre style="font-family:inherit;white-space:pre-wrap;">${escaped}</pre>`;
+    }
+    convertHtmlToPlainText(html) {
+        if (!html) {
+            return undefined;
+        }
+        return html
+            .replace(/<style[\s\S]*?<\/style>/gi, '')
+            .replace(/<script[\s\S]*?<\/script>/gi, '')
+            .replace(/<br\s*\/>/gi, '\n')
+            .replace(/<\/(p|div|li|tr|h[1-6])>/gi, '\n')
+            .replace(/<[^>]+>/g, '')
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            .replace(/&#039;/g, "'")
+            .replace(/\n{3,}/g, '\n\n')
+            .trim();
+    }
+    /**
+     * Build callback URL, adding https:// if needed
+     */
+    buildCallbackUrl(callbackUrl) {
+        if (!callbackUrl) {
+            return undefined;
+        }
+        // Avoid duplicating schemes if caller already provided one
+        if (callbackUrl.startsWith('http://') || callbackUrl.startsWith('https://')) {
+            return callbackUrl;
+        }
+        return `https://${callbackUrl}`;
+    }
+    /**
+     * Map GatewayAPI email status codes to our EmailStatus enum
+     * Based on GatewayAPI documentation:
+     * - PROCESSED: successfully received and ready to send
+     * - DELIVERED: successfully delivered
+     * - DEFERRED: delayed (temporary issue with recipient server)
+     * - BOUNCED: could not be delivered (typically unknown address)
+     * - BLOCKED: blocked by the server
+     */
+    mapGatewayApiStatus(status) {
+        const statusMap = {
+            'PROCESSED': EmailStatus.QUEUED,
+            'DELIVERED': EmailStatus.DELIVERED,
+            'DEFERRED': EmailStatus.DEFERRED,
+            'BOUNCED': EmailStatus.BOUNCED,
+            'BLOCKED': EmailStatus.BLOCKED,
+            'FAILED': EmailStatus.FAILED
+        };
+        return statusMap[status?.toUpperCase()] || EmailStatus.QUEUED;
+    }
+}
+//# sourceMappingURL=GatewayApiEmailProvider.js.map

package/dist/providers/GatewayApiEmailProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GatewayApiEmailProvider.js","sourceRoot":"","sources":["../../src/providers/GatewayApiEmailProvider.ts"],"names":[],"mappings":"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"}

package/dist/providers/MockEmailProvider.d.ts

@@ -0,0 +1,49 @@
+import { IEmailProvider, EmailMessage, EmailResult, DeliveryReport, WebhookValidationResult, MockEmailConfig, EmailStatus, WebhookValidationOptions } from '../interfaces/IEmailProvider.js';
+interface SentEmail {
+    id: string;
+    message: EmailMessage;
+    sentAt: Date;
+    status: EmailStatus;
+}
+export declare class MockEmailProvider implements IEmailProvider {
+    private simulateDelay;
+    private simulateFailures;
+    private defaultFrom;
+    private sentEmails;
+    private messageIdCounter;
+    constructor(config: MockEmailConfig);
+    send(message: EmailMessage): Promise<EmailResult>;
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    validateWebhook(payload: any, signature?: string, _options?: WebhookValidationOptions): WebhookValidationResult;
+    /**
+     * Get all sent emails (useful for testing)
+     */
+    getSentEmails(): SentEmail[];
+    /**
+     * Clear all sent emails (useful for testing)
+     */
+    clearSentEmails(): void;
+    /**
+     * Get a specific sent email by ID (useful for testing)
+     */
+    getSentEmail(messageId: string): SentEmail | undefined;
+    /**
+     * Log email to console (only in development)
+     */
+    private logEmail;
+    /**
+     * Convert HTML to plain text (basic implementation)
+     */
+    private htmlToPlainText;
+    /**
+     * Extract 2FA/verification code from email content
+     * Looks for 6-digit codes commonly used in 2FA
+     */
+    private extract2FACode;
+    /**
+     * Simple delay helper
+     */
+    private delay;
+}
+export {};
+//# sourceMappingURL=MockEmailProvider.d.ts.map

package/dist/providers/MockEmailProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockEmailProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockEmailProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,eAAe,EACf,WAAW,EAEX,wBAAwB,EAC3B,MAAM,iCAAiC,CAAC;AAEzC,UAAU,SAAS;IACf,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,IAAI,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;CACvB;AAED,qBAAa,iBAAkB,YAAW,cAAc;IACpD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,MAAM,EAAE,eAAe;IAM7B,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAyCjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAoB1E,eAAe,CACX,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,wBAAwB,GACpC,uBAAuB;IAQ1B;;OAEG;IACH,aAAa,IAAI,SAAS,EAAE;IAI5B;;OAEG;IACH,eAAe,IAAI,IAAI;IAKvB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAItD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuDhB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGhB"}