glasswork 0.9.2 → 0.11.0

package/dist/email/config.d.ts

@@ -0,0 +1,89 @@
+import * as v from 'valibot';
+/**
+ * Valibot schema for SES transport configuration
+ */
+export declare const SESTransportConfigSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"ses", undefined>;
+    readonly region: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly configurationSet: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly endpoint: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * Valibot schema for SMTP transport configuration
+ */
+export declare const SMTPTransportConfigSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"smtp", undefined>;
+    readonly host: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly port: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 65535, undefined>]>;
+    readonly secure: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly auth: v.OptionalSchema<v.ObjectSchema<{
+        readonly user: v.StringSchema<undefined>;
+        readonly pass: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/**
+ * Valibot schema for mock transport configuration (testing)
+ */
+export declare const MockTransportConfigSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"mock", undefined>;
+}, undefined>;
+/**
+ * Union of all transport configurations
+ */
+export declare const TransportConfigSchema: v.UnionSchema<[v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"ses", undefined>;
+    readonly region: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly configurationSet: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly endpoint: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"smtp", undefined>;
+    readonly host: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+    readonly port: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 65535, undefined>]>;
+    readonly secure: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly auth: v.OptionalSchema<v.ObjectSchema<{
+        readonly user: v.StringSchema<undefined>;
+        readonly pass: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"mock", undefined>;
+}, undefined>], undefined>;
+/**
+ * Valibot schema for email module configuration
+ */
+export declare const EmailConfigSchema: v.ObjectSchema<{
+    /** Default sender email address */
+    readonly from: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.EmailAction<string, undefined>]>;
+    /** Default reply-to address */
+    readonly replyTo: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.EmailAction<string, undefined>]>, undefined>;
+    /** Transport configuration */
+    readonly transport: v.UnionSchema<[v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"ses", undefined>;
+        readonly region: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly configurationSet: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly endpoint: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"smtp", undefined>;
+        readonly host: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+        readonly port: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 65535, undefined>]>;
+        readonly secure: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly auth: v.OptionalSchema<v.ObjectSchema<{
+            readonly user: v.StringSchema<undefined>;
+            readonly pass: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"mock", undefined>;
+    }, undefined>], undefined>;
+}, undefined>;
+/**
+ * Inferred types from schemas
+ */
+export type SESTransportConfigInput = v.InferInput<typeof SESTransportConfigSchema>;
+export type SMTPTransportConfigInput = v.InferInput<typeof SMTPTransportConfigSchema>;
+export type MockTransportConfigInput = v.InferInput<typeof MockTransportConfigSchema>;
+export type TransportConfigInput = v.InferInput<typeof TransportConfigSchema>;
+export type EmailConfigInput = v.InferInput<typeof EmailConfigSchema>;
+/**
+ * Validates email configuration
+ */
+export declare function validateEmailConfig(config: unknown): EmailConfigInput;
+//# sourceMappingURL=config.d.ts.map

package/dist/email/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/email/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;aAKnC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;aAWpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB;;aAEpC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;0BAIhC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,mCAAmC;;IAEnC,+BAA+B;;IAE/B,8BAA8B;;;;;;;;;;;;;;;;;;aAE9B,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtF,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEtE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,CAErE"}

package/dist/email/config.js

@@ -0,0 +1,55 @@
+import * as v from 'valibot';
+/**
+ * Valibot schema for SES transport configuration
+ */
+export const SESTransportConfigSchema = v.object({
+    type: v.literal('ses'),
+    region: v.pipe(v.string(), v.minLength(1)),
+    configurationSet: v.optional(v.string()),
+    endpoint: v.optional(v.string()),
+});
+/**
+ * Valibot schema for SMTP transport configuration
+ */
+export const SMTPTransportConfigSchema = v.object({
+    type: v.literal('smtp'),
+    host: v.pipe(v.string(), v.minLength(1)),
+    port: v.pipe(v.number(), v.minValue(1), v.maxValue(65535)),
+    secure: v.optional(v.boolean()),
+    auth: v.optional(v.object({
+        user: v.string(),
+        pass: v.string(),
+    })),
+});
+/**
+ * Valibot schema for mock transport configuration (testing)
+ */
+export const MockTransportConfigSchema = v.object({
+    type: v.literal('mock'),
+});
+/**
+ * Union of all transport configurations
+ */
+export const TransportConfigSchema = v.union([
+    SESTransportConfigSchema,
+    SMTPTransportConfigSchema,
+    MockTransportConfigSchema,
+]);
+/**
+ * Valibot schema for email module configuration
+ */
+export const EmailConfigSchema = v.object({
+    /** Default sender email address */
+    from: v.pipe(v.string(), v.email()),
+    /** Default reply-to address */
+    replyTo: v.optional(v.pipe(v.string(), v.email())),
+    /** Transport configuration */
+    transport: TransportConfigSchema,
+});
+/**
+ * Validates email configuration
+ */
+export function validateEmailConfig(config) {
+    return v.parse(EmailConfigSchema, config);
+}
+//# sourceMappingURL=config.js.map

package/dist/email/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/email/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IACtB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC1C,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACxC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CACjC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAC,QAAQ,CACd,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;KACjB,CAAC,CACH;CACF,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;CACxB,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC3C,wBAAwB;IACxB,yBAAyB;IACzB,yBAAyB;CAC1B,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,mCAAmC;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACnC,+BAA+B;IAC/B,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,8BAA8B;IAC9B,SAAS,EAAE,qBAAqB;CACjC,CAAC,CAAC;AAWH;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,OAAO,CAAC,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/email/email-service.d.ts

@@ -0,0 +1,54 @@
+import type { EmailConfig, EmailMessage, EmailResult, OnSentHook } from './types.js';
+/**
+ * Options for sending an email
+ */
+export interface SendOptions {
+    /** Override the default sender */
+    from?: string;
+    /** Override the default reply-to */
+    replyTo?: string;
+}
+/**
+ * Email service for sending emails through configured transport
+ *
+ * @example
+ * ```typescript
+ * const emailService = new EmailService({
+ *   transport: new SESTransport({ region: 'eu-west-1' }),
+ *   from: 'noreply@example.com',
+ * });
+ *
+ * // Send raw email
+ * await emailService.sendRaw({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   html: '<h1>Welcome to our app!</h1>',
+ * });
+ * ```
+ */
+export declare class EmailService {
+    private readonly transport;
+    private readonly defaultFrom;
+    private readonly defaultReplyTo?;
+    private readonly onSent?;
+    constructor(config: EmailConfig, onSent?: OnSentHook);
+    /**
+     * Sends a raw email message
+     *
+     * @param message - Email message to send
+     * @param options - Optional overrides for sender/reply-to
+     * @returns The send result with message ID
+     */
+    sendRaw(message: Omit<EmailMessage, 'from'> & {
+        from?: string;
+    }, options?: SendOptions): Promise<EmailResult>;
+    /**
+     * Gets the transport name for debugging
+     */
+    get transportName(): string;
+    /**
+     * Converts HTML to plain text for email clients that don't support HTML
+     */
+    private htmlToText;
+}
+//# sourceMappingURL=email-service.d.ts.map

package/dist/email/email-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-service.d.ts","sourceRoot":"","sources":["../../src/email/email-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EAEX,UAAU,EACX,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAa;gBAEzB,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,UAAU;IAOpD;;;;;;OAMG;IACG,OAAO,CACX,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,WAAW,CAAC;IAuBvB;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;OAEG;IACH,OAAO,CAAC,UAAU;CA2BnB"}

package/dist/email/email-service.js

@@ -0,0 +1,94 @@
+import { createLogger } from '../utils/logger.js';
+const logger = createLogger('EmailService');
+/**
+ * Email service for sending emails through configured transport
+ *
+ * @example
+ * ```typescript
+ * const emailService = new EmailService({
+ *   transport: new SESTransport({ region: 'eu-west-1' }),
+ *   from: 'noreply@example.com',
+ * });
+ *
+ * // Send raw email
+ * await emailService.sendRaw({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome!',
+ *   html: '<h1>Welcome to our app!</h1>',
+ * });
+ * ```
+ */
+export class EmailService {
+    transport;
+    defaultFrom;
+    defaultReplyTo;
+    onSent;
+    constructor(config, onSent) {
+        this.transport = config.transport;
+        this.defaultFrom = config.from;
+        this.defaultReplyTo = config.replyTo;
+        this.onSent = onSent;
+    }
+    /**
+     * Sends a raw email message
+     *
+     * @param message - Email message to send
+     * @param options - Optional overrides for sender/reply-to
+     * @returns The send result with message ID
+     */
+    async sendRaw(message, options) {
+        const fullMessage = {
+            ...message,
+            from: options?.from || message.from || this.defaultFrom,
+            replyTo: options?.replyTo || message.replyTo || this.defaultReplyTo,
+            text: message.text || this.htmlToText(message.html),
+        };
+        const result = await this.transport.send(fullMessage);
+        // Call onSent hook if configured
+        if (this.onSent && result.success) {
+            try {
+                await this.onSent(result, fullMessage);
+            }
+            catch (error) {
+                // Log but don't fail the send
+                logger.error('onSent hook failed:', error);
+            }
+        }
+        return result;
+    }
+    /**
+     * Gets the transport name for debugging
+     */
+    get transportName() {
+        return this.transport.name;
+    }
+    /**
+     * Converts HTML to plain text for email clients that don't support HTML
+     */
+    htmlToText(html) {
+        return (html
+            // Remove style and script tags with content
+            .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, '')
+            .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, '')
+            // Convert line breaks
+            .replace(/<br\s*\/?>/gi, '\n')
+            // Convert block elements to newlines
+            .replace(/<\/(p|div|tr|h[1-6])>/gi, '\n')
+            // Convert list items
+            .replace(/<li[^>]*>/gi, '• ')
+            .replace(/<\/li>/gi, '\n')
+            // Remove remaining HTML tags
+            .replace(/<[^>]+>/g, '')
+            // Decode common HTML entities
+            .replace(/&nbsp;/gi, ' ')
+            .replace(/&amp;/gi, '&')
+            .replace(/&lt;/gi, '<')
+            .replace(/&gt;/gi, '>')
+            .replace(/&quot;/gi, '"')
+            .replace(/&#39;/gi, "'")
+            // Clean up whitespace
+            .replace(/\n\s*\n\s*\n/g, '\n\n')
+            .trim());
+    }
+}
+//# sourceMappingURL=email-service.js.map

package/dist/email/email-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-service.js","sourceRoot":"","sources":["../../src/email/email-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AASlD,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;AAY5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,YAAY;IACN,SAAS,CAAiB;IAC1B,WAAW,CAAS;IACpB,cAAc,CAAU;IACxB,MAAM,CAAc;IAErC,YAAY,MAAmB,EAAE,MAAmB;QAClD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CACX,OAAuD,EACvD,OAAqB;QAErB,MAAM,WAAW,GAAiB;YAChC,GAAG,OAAO;YACV,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW;YACvD,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc;YACnE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;SACpD,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEtD,iCAAiC;QACjC,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,8BAA8B;gBAC9B,MAAM,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,IAAY;QAC7B,OAAO,CACL,IAAI;YACF,4CAA4C;aAC3C,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC;aAC9C,OAAO,CAAC,mCAAmC,EAAE,EAAE,CAAC;YACjD,sBAAsB;aACrB,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC;YAC9B,qCAAqC;aACpC,OAAO,CAAC,yBAAyB,EAAE,IAAI,CAAC;YACzC,qBAAqB;aACpB,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC;aAC5B,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;YAC1B,6BAA6B;aAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACxB,8BAA8B;aAC7B,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;aACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;aACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;aACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;YACxB,sBAAsB;aACrB,OAAO,CAAC,eAAe,EAAE,MAAM,CAAC;aAChC,IAAI,EAAE,CACV,CAAC;IACJ,CAAC;CACF"}

package/dist/email/index.d.ts

@@ -0,0 +1,12 @@
+export { type CompileOptions, type CompileResult, compileTemplates, } from './compiler/compile-templates.js';
+export type { CompiledTemplate, CompilerOptions, InferredType, Token, TokenType, } from './compiler/index.js';
+export { compile, extractTypes, generateInterface, tokenize } from './compiler/index.js';
+export { type EmailConfigInput, EmailConfigSchema, type MockTransportConfigInput, MockTransportConfigSchema, type SESTransportConfigInput, SESTransportConfigSchema, type SMTPTransportConfigInput, SMTPTransportConfigSchema, type TransportConfigInput, TransportConfigSchema, validateEmailConfig, } from './config.js';
+export { EmailService, type SendOptions } from './email-service.js';
+export { createTemplateRegistry, type TemplateDefinition, TemplateRegistry, type TemplateRenderFn, } from './template-registry.js';
+export { type SendTemplateOptions, TemplatedEmailService, } from './templated-email-service.js';
+export { MockTransport, type StoredEmail } from './transports/mock-transport.js';
+export { SESTransport } from './transports/ses-transport.js';
+export type { EmailAttachment, EmailConfig, EmailMessage, EmailModuleOptions, EmailResult, EmailTransport, OnSentHook, SESTransportConfig, SMTPTransportConfig, } from './types.js';
+export { type BouncedEvent, type ComplaintEvent, type CreateWebhookHandlerOptions, clearCertCache, createSESWebhookHandler, type DeliveredEvent, type HandleSubscriptionOptions, handleSNSSubscription, parseSESNotification, parseSNSMessage, type SESBounceNotification, type SESComplaintNotification, type SESDeliveryNotification, type SESEvent, type SESNotification, type SESWebhookHandlers, type SNSMessage, type VerifySignatureOptions, verifySNSSignature, } from './webhooks/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AACzC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,KAAK,EACL,SAAS,GACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EACL,KAAK,gBAAgB,EACrB,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,uBAAuB,EAC5B,wBAAwB,EACxB,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EACL,sBAAsB,EACtB,KAAK,kBAAkB,EACvB,gBAAgB,EAChB,KAAK,gBAAgB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,mBAAmB,EACxB,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,YAAY,EACV,eAAe,EACf,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,2BAA2B,EAChC,cAAc,EAEd,uBAAuB,EACvB,KAAK,cAAc,EACnB,KAAK,yBAAyB,EAC9B,qBAAqB,EAErB,oBAAoB,EACpB,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAE5B,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAE3B,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/email/index.js

@@ -0,0 +1,23 @@
+// Email module main exports
+export { compileTemplates, } from './compiler/compile-templates.js';
+// Compiler (for build-time usage)
+export { compile, extractTypes, generateInterface, tokenize } from './compiler/index.js';
+// Configuration
+export { EmailConfigSchema, MockTransportConfigSchema, SESTransportConfigSchema, SMTPTransportConfigSchema, TransportConfigSchema, validateEmailConfig, } from './config.js';
+// Services
+export { EmailService } from './email-service.js';
+// Template registry
+export { createTemplateRegistry, TemplateRegistry, } from './template-registry.js';
+export { TemplatedEmailService, } from './templated-email-service.js';
+export { MockTransport } from './transports/mock-transport.js';
+// Transports
+export { SESTransport } from './transports/ses-transport.js';
+// Webhooks (delivery tracking)
+export { clearCertCache, 
+// Handler factory
+createSESWebhookHandler, handleSNSSubscription, 
+// Parsers
+parseSESNotification, parseSNSMessage, 
+// Middleware
+verifySNSSignature, } from './webhooks/index.js';
+//# sourceMappingURL=index.js.map

package/dist/email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/email/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAE5B,OAAO,EAGL,gBAAgB,GACjB,MAAM,iCAAiC,CAAC;AAQzC,kCAAkC;AAClC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACzF,gBAAgB;AAChB,OAAO,EAEL,iBAAiB,EAEjB,yBAAyB,EAEzB,wBAAwB,EAExB,yBAAyB,EAEzB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,WAAW;AACX,OAAO,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC;AACpE,oBAAoB;AACpB,OAAO,EACL,sBAAsB,EAEtB,gBAAgB,GAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,aAAa,EAAoB,MAAM,gCAAgC,CAAC;AACjF,aAAa;AACb,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAc7D,+BAA+B;AAC/B,OAAO,EAIL,cAAc;AACd,kBAAkB;AAClB,uBAAuB,EAGvB,qBAAqB;AACrB,UAAU;AACV,oBAAoB,EACpB,eAAe;AAUf,aAAa;AACb,kBAAkB,GACnB,MAAM,qBAAqB,CAAC"}

package/dist/email/template-registry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Template render function signature
+ */
+export type TemplateRenderFn<TContext> = (ctx: TContext) => {
+    html: string;
+    text: string;
+};
+/**
+ * Template definition with metadata
+ */
+export interface TemplateDefinition<TContext = unknown> {
+    /** Template name/identifier */
+    name: string;
+    /** The render function generated by the compiler */
+    render: TemplateRenderFn<TContext>;
+    /** Default subject line (can be overridden) */
+    subject?: string;
+}
+/**
+ * Registry for compiled email templates
+ *
+ * Provides type-safe access to templates and their context types.
+ *
+ * @example
+ * ```typescript
+ * // templates.compiled/index.ts
+ * import * as welcomeEmail from './welcome-email.js';
+ * import * as passwordReset from './password-reset.js';
+ *
+ * export const templates = new TemplateRegistry()
+ *   .register('welcome', welcomeEmail.render, { subject: 'Welcome!' })
+ *   .register('password-reset', passwordReset.render, { subject: 'Reset your password' });
+ *
+ * // Usage
+ * const { html, text } = templates.render('welcome', { name: 'Alice' });
+ * ```
+ */
+export declare class TemplateRegistry<TTemplates extends Record<string, TemplateDefinition> = Record<string, never>> {
+    private readonly templates;
+    /**
+     * Registers a template with the registry
+     *
+     * @param name - Unique template identifier
+     * @param render - The compiled render function
+     * @param options - Optional template metadata
+     * @returns A new registry with the template added (for chaining)
+     */
+    register<TName extends string, TContext>(name: TName, render: TemplateRenderFn<TContext>, options?: {
+        subject?: string;
+    }): TemplateRegistry<TTemplates & Record<TName, TemplateDefinition<TContext>>>;
+    /**
+     * Renders a template with the given context
+     *
+     * @param name - Template name
+     * @param context - Template context data
+     * @returns The rendered HTML and text
+     */
+    render<TName extends keyof TTemplates>(name: TName, context: TTemplates[TName] extends TemplateDefinition<infer TContext> ? TContext : never): {
+        html: string;
+        text: string;
+    };
+    /**
+     * Gets the default subject for a template
+     */
+    getSubject<TName extends keyof TTemplates>(name: TName): string | undefined;
+    /**
+     * Checks if a template exists
+     */
+    has(name: string): boolean;
+    /**
+     * Gets all registered template names
+     */
+    get names(): string[];
+    /**
+     * Gets the number of registered templates
+     */
+    get size(): number;
+}
+/**
+ * Creates a new empty template registry
+ */
+export declare function createTemplateRegistry(): TemplateRegistry;
+//# sourceMappingURL=template-registry.d.ts.map

package/dist/email/template-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-registry.d.ts","sourceRoot":"","sources":["../../src/email/template-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,QAAQ,KAAK;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3F;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,OAAO;IACpD,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB,CAC3B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8C;IAExE;;;;;;;OAOG;IACH,QAAQ,CAAC,KAAK,SAAS,MAAM,EAAE,QAAQ,EACrC,IAAI,EAAE,KAAK,EACX,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,EAClC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7B,gBAAgB,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAa7E;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,SAAS,MAAM,UAAU,EACnC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,kBAAkB,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,GACvF;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQjC;;OAEG;IACH,UAAU,CAAC,KAAK,SAAS,MAAM,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS;IAK3E;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/email/template-registry.js

@@ -0,0 +1,85 @@
+/**
+ * Registry for compiled email templates
+ *
+ * Provides type-safe access to templates and their context types.
+ *
+ * @example
+ * ```typescript
+ * // templates.compiled/index.ts
+ * import * as welcomeEmail from './welcome-email.js';
+ * import * as passwordReset from './password-reset.js';
+ *
+ * export const templates = new TemplateRegistry()
+ *   .register('welcome', welcomeEmail.render, { subject: 'Welcome!' })
+ *   .register('password-reset', passwordReset.render, { subject: 'Reset your password' });
+ *
+ * // Usage
+ * const { html, text } = templates.render('welcome', { name: 'Alice' });
+ * ```
+ */
+export class TemplateRegistry {
+    templates = new Map();
+    /**
+     * Registers a template with the registry
+     *
+     * @param name - Unique template identifier
+     * @param render - The compiled render function
+     * @param options - Optional template metadata
+     * @returns A new registry with the template added (for chaining)
+     */
+    register(name, render, options) {
+        this.templates.set(name, {
+            name,
+            render: render,
+            subject: options?.subject,
+        });
+        // Return this for chaining (type-safe)
+        return this;
+    }
+    /**
+     * Renders a template with the given context
+     *
+     * @param name - Template name
+     * @param context - Template context data
+     * @returns The rendered HTML and text
+     */
+    render(name, context) {
+        const template = this.templates.get(name);
+        if (!template) {
+            throw new Error(`Template "${String(name)}" not found in registry`);
+        }
+        return template.render(context);
+    }
+    /**
+     * Gets the default subject for a template
+     */
+    getSubject(name) {
+        const template = this.templates.get(name);
+        return template?.subject;
+    }
+    /**
+     * Checks if a template exists
+     */
+    has(name) {
+        return this.templates.has(name);
+    }
+    /**
+     * Gets all registered template names
+     */
+    get names() {
+        return [...this.templates.keys()];
+    }
+    /**
+     * Gets the number of registered templates
+     */
+    get size() {
+        return this.templates.size;
+    }
+}
+/**
+ * Creates a new empty template registry
+ */
+export function createTemplateRegistry() {
+    return new TemplateRegistry();
+}
+//# sourceMappingURL=template-registry.js.map

package/dist/email/template-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-registry.js","sourceRoot":"","sources":["../../src/email/template-registry.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,gBAAgB;IAGV,SAAS,GAAoC,IAAI,GAAG,EAAE,CAAC;IAExE;;;;;;;OAOG;IACH,QAAQ,CACN,IAAW,EACX,MAAkC,EAClC,OAA8B;QAE9B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE;YACvB,IAAI;YACJ,MAAM,EAAE,MAAmC;YAC3C,OAAO,EAAE,OAAO,EAAE,OAAO;SAC1B,CAAC,CAAC;QAEH,uCAAuC;QACvC,OAAO,IAEN,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CACJ,IAAW,EACX,OAAwF;QAExF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU,CAAiC,IAAW;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;QACpD,OAAO,QAAQ,EAAE,OAAO,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}

package/dist/email/templated-email-service.d.ts

@@ -0,0 +1,59 @@
+import { EmailService, type SendOptions } from './email-service.js';
+import type { TemplateDefinition, TemplateRegistry } from './template-registry.js';
+import type { EmailConfig, EmailResult, OnSentHook } from './types.js';
+/**
+ * Options for sending a templated email
+ */
+export interface SendTemplateOptions extends SendOptions {
+    /** Recipient email address(es) */
+    to: string | string[];
+    /** Override the template's default subject */
+    subject?: string;
+    /** CC recipients */
+    cc?: string | string[];
+    /** BCC recipients */
+    bcc?: string | string[];
+}
+/**
+ * Templated email service with type-safe template sending
+ *
+ * Extends the base EmailService with template-aware sending methods.
+ *
+ * @example
+ * ```typescript
+ * // Create service with templates
+ * const emailService = new TemplatedEmailService({
+ *   config: { transport, from: 'noreply@example.com' },
+ *   templates,
+ * });
+ *
+ * // Send with full type safety
+ * await emailService.send('welcome', {
+ *   to: 'user@example.com',
+ *   context: { name: 'Alice', verificationLink: '...' },
+ * });
+ * ```
+ */
+export declare class TemplatedEmailService<TTemplates extends Record<string, TemplateDefinition>> extends EmailService {
+    private readonly templates;
+    constructor(options: {
+        config: EmailConfig;
+        templates: TemplateRegistry<TTemplates>;
+        onSent?: OnSentHook;
+    });
+    /**
+     * Sends a templated email
+     *
+     * @param template - Template name (type-safe)
+     * @param options - Send options including recipient and context
+     * @returns The send result with message ID
+     */
+    send<TName extends keyof TTemplates & string>(template: TName, options: SendTemplateOptions & {
+        context: TTemplates[TName] extends TemplateDefinition<infer TContext> ? TContext : never;
+    }): Promise<EmailResult>;
+    /**
+     * Gets the template registry
+     */
+    getTemplates(): TemplateRegistry<TTemplates>;
+}
+//# sourceMappingURL=templated-email-service.d.ts.map

package/dist/email/templated-email-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templated-email-service.d.ts","sourceRoot":"","sources":["../../src/email/templated-email-service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,kCAAkC;IAClC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAqB,CAChC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CACrD,SAAQ,YAAY;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;gBAE7C,OAAO,EAAE;QACnB,MAAM,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,MAAM,CAAC,EAAE,UAAU,CAAC;KACrB;IAKD;;;;;;OAMG;IACG,IAAI,CAAC,KAAK,SAAS,MAAM,UAAU,GAAG,MAAM,EAChD,QAAQ,EAAE,KAAK,EACf,OAAO,EAAE,mBAAmB,GAAG;QAC7B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,SAAS,kBAAkB,CAAC,MAAM,QAAQ,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAC;KAC1F,GACA,OAAO,CAAC,WAAW,CAAC;IA2BvB;;OAEG;IACH,YAAY,IAAI,gBAAgB,CAAC,UAAU,CAAC;CAG7C"}