@superdangerous/app-framework 4.9.2 → 4.15.0

package/dist/services/emailService.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Email Service supporting Resend API and Nodemailer SMTP
+ * A generic, reusable email service for the app framework.
+ * Resend is preferred when API key is configured.
+ */
+import { EventEmitter } from "events";
+export interface EmailOptions {
+    to: string | string[];
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: Array<{
+        filename: string;
+        content?: string | Buffer;
+        path?: string;
+    }>;
+}
+export interface EmailConfig {
+    enabled?: boolean;
+    provider?: "resend" | "smtp";
+    resend?: {
+        apiKey: string;
+    };
+    smtp?: {
+        host: string;
+        port: number;
+        secure?: boolean;
+        auth?: {
+            user: string;
+            pass: string;
+        };
+    };
+    from?: string;
+    to?: string[];
+    appName?: string;
+    appTitle?: string;
+    logoUrl?: string;
+    brandColor?: string;
+    footerText?: string;
+    footerLink?: string;
+}
+export type NotificationEventType = "startup" | "shutdown" | "error" | "warning" | "info" | "success" | "custom";
+export interface NotificationEvent {
+    type: NotificationEventType;
+    title?: string;
+    data: Record<string, unknown>;
+    timestamp: Date;
+}
+export interface EmailServiceStatus {
+    enabled: boolean;
+    provider: "Resend" | "SMTP" | "None";
+    recipients: string[];
+}
+export declare class EmailService extends EventEmitter {
+    private transporter?;
+    private resend?;
+    private enabled;
+    private useResend;
+    private notificationQueue;
+    private processingInterval?;
+    private fromAddress;
+    private defaultRecipients;
+    private config;
+    private appName;
+    private appTitle;
+    private logoUrl?;
+    private brandColor;
+    private footerText?;
+    private footerLink?;
+    constructor(config?: EmailConfig);
+    /**
+     * Initialize the email service
+     */
+    initialize(): Promise<void>;
+    /**
+     * Update branding configuration
+     */
+    setBranding(options: {
+        appName?: string;
+        appTitle?: string;
+        logoUrl?: string;
+        brandColor?: string;
+        footerText?: string;
+        footerLink?: string;
+    }): void;
+    /**
+     * Send an email
+     */
+    sendEmail(options: EmailOptions): Promise<void>;
+    /**
+     * Queue a notification event
+     */
+    queueNotification(event: NotificationEvent): void;
+    /**
+     * Send immediate notification (bypasses queue)
+     */
+    sendImmediateNotification(event: NotificationEvent): Promise<void>;
+    /**
+     * Send a notification with custom type and data
+     */
+    notify(type: NotificationEventType, title: string, data: Record<string, unknown>, immediate?: boolean): Promise<void>;
+    /**
+     * Send startup notification
+     */
+    notifyStartup(data?: Record<string, unknown>): Promise<void>;
+    /**
+     * Send error notification
+     */
+    notifyError(errorMessage: string, details?: Record<string, unknown>): Promise<void>;
+    /**
+     * Send test email
+     */
+    sendTestEmail(): Promise<void>;
+    /**
+     * Get service status
+     */
+    getStatus(): EmailServiceStatus;
+    /**
+     * Shutdown the service
+     */
+    shutdown(): Promise<void>;
+    private startNotificationProcessor;
+    private processNotificationQueue;
+    private groupNotificationsByType;
+    private sendNotificationEmail;
+    private getNotificationSubject;
+    private getNotificationIcon;
+    private getAccentColor;
+    private formatDateTime;
+    private formatEventDataHtml;
+    private formatNotificationHtml;
+    private formatNotificationText;
+    private formatEventDataText;
+    private getNotificationTitle;
+    private generateTestEmailHtml;
+}
+/**
+ * Get the email service instance (singleton)
+ */
+export declare function getEmailService(): EmailService | null;
+/**
+ * Create and initialize the email service
+ */
+export declare function createEmailService(config: EmailConfig): Promise<EmailService>;
+export default EmailService;
+//# sourceMappingURL=emailService.d.ts.map

package/dist/services/emailService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailService.d.ts","sourceRoot":"","sources":["../../src/services/emailService.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAmBtC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE;YACL,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,UAAU,GACV,OAAO,GACP,SAAS,GACT,MAAM,GACN,SAAS,GACT,QAAQ,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAMD,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,kBAAkB,CAAC,CAAiB;IAC5C,OAAO,CAAC,WAAW,CAAuC;IAC1D,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,MAAM,CAAc;IAG5B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAS;gBAEhB,MAAM,GAAE,WAAgB;IAmBpC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAyDjC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,IAAI;IASR;;OAEG;IACG,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmDrD;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAUjD;;OAEG;IACG,yBAAyB,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxE;;OAEG;IACG,MAAM,CACV,IAAI,EAAE,qBAAqB,EAC3B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,SAAS,GAAE,OAAc,GACxB,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;IACG,aAAa,CACjB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACG,WAAW,CACf,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAYhB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAQ/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB/B,OAAO,CAAC,0BAA0B;YAOpB,wBAAwB;IAkBtC,OAAO,CAAC,wBAAwB;YAalB,qBAAqB;IAgBnC,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,cAAc;IAiBtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,sBAAsB;IA6F9B,OAAO,CAAC,sBAAsB;IAuB9B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,oBAAoB;IAqB5B,OAAO,CAAC,qBAAqB;CAuE9B;AAQD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,GAAG,IAAI,CAErD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED,eAAe,YAAY,CAAC"}