@ibgib/node-gib 0.0.9 → 0.0.13

package/dist/email/email-helpers.mjs

@@ -0,0 +1,144 @@
+/**
+ * Helper functions for email parsing, validation, and MIME string formatting.
+ */
+import { DEFAULT_EMAIL_CHARSET } from './email-constants.mjs';
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+/**
+ * Validates whether an email string matches standard email formatting.
+ */
+export function validateEmail(email) {
+    if (!email || typeof email !== 'string') {
+        return false;
+    }
+    return EMAIL_REGEX.test(email.trim());
+}
+/** Alias for validateEmail for email address format checking. */
+export function validateEmailAddress(email) {
+    return validateEmail(email);
+}
+/**
+ * Sanitizes header values by stripping carriage return (\r) and newline (\n) characters
+ * to prevent MIME header injection.
+ */
+export function sanitizeHeaderValue(val) {
+    if (!val || typeof val !== 'string') {
+        return '';
+    }
+    return val.replace(/[\r\n]/g, '').trim();
+}
+/**
+ * Parses a string or EmailAddress object into a normalized EmailAddress object.
+ * Examples:
+ * - "Alice <alice@example.com>" -> { name: "Alice", address: "alice@example.com" }
+ * - "alice@example.com" -> { address: "alice@example.com" }
+ */
+export function parseEmailAddress(addr) {
+    if (typeof addr === 'object' && addr !== null) {
+        return {
+            address: sanitizeHeaderValue(addr.address).toLowerCase(),
+            name: addr.name ? sanitizeHeaderValue(addr.name) : undefined,
+        };
+    }
+    const str = sanitizeHeaderValue(addr || '');
+    const match = str.match(/^(?:"?([^"]*)"?\s+)?<([^>]+)>$/);
+    if (match) {
+        const name = match[1]?.trim();
+        const address = match[2]?.trim().toLowerCase();
+        return {
+            address,
+            name: name || undefined,
+        };
+    }
+    return { address: str.toLowerCase() };
+}
+/**
+ * Formats an EmailAddress or string into RFC 2822 format (e.g. `"Alice" <alice@example.com>`).
+ */
+export function formatEmailAddress(addr) {
+    const parsed = parseEmailAddress(addr);
+    if (parsed.name) {
+        return `"${parsed.name}" <${parsed.address}>`;
+    }
+    return parsed.address;
+}
+/**
+ * Parses raw MIME headers string or header record into a key-value record with normalized header names.
+ */
+export function parseRawMimeHeaders(raw) {
+    if (typeof raw === 'object' && raw !== null) {
+        return { ...raw };
+    }
+    const headers = {};
+    if (!raw || typeof raw !== 'string') {
+        return headers;
+    }
+    // Header block ends at double newline
+    const headerBlock = raw.split(/\r?\n\r?\n/)[0] || raw;
+    // Unfold multi-line headers
+    const unfolded = headerBlock.replace(/\r?\n[ \t]+/g, ' ');
+    const lines = unfolded.split(/\r?\n/);
+    for (const line of lines) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx > 0) {
+            const key = line.slice(0, colonIdx).trim();
+            const value = line.slice(colonIdx + 1).trim();
+            headers[key] = value;
+        }
+    }
+    return headers;
+}
+/**
+ * Formats an OutboundEmail object into a raw MIME string (RFC 2822).
+ */
+export function formatRawMimeString(email, charset = DEFAULT_EMAIL_CHARSET) {
+    const fromStr = formatEmailAddress(email.from);
+    const toStrs = email.to.map(t => formatEmailAddress(t)).join(', ');
+    const lines = [
+        `From: ${fromStr}`,
+        `To: ${toStrs}`,
+    ];
+    if (email.cc && email.cc.length > 0) {
+        lines.push(`Cc: ${email.cc.map(c => formatEmailAddress(c)).join(', ')}`);
+    }
+    if (email.replyTo) {
+        lines.push(`Reply-To: ${formatEmailAddress(email.replyTo)}`);
+    }
+    lines.push(`Subject: ${sanitizeHeaderValue(email.subject)}`);
+    if (email.headers) {
+        for (const [key, val] of Object.entries(email.headers)) {
+            lines.push(`${sanitizeHeaderValue(key)}: ${sanitizeHeaderValue(val)}`);
+        }
+    }
+    const hasText = Boolean(email.textBody);
+    const hasHtml = Boolean(email.htmlBody);
+    if (hasText && hasHtml) {
+        const boundary = `----=_Part_${Date.now()}_${Math.random().toString(36).substring(2)}`;
+        lines.push(`Content-Type: multipart/alternative; boundary="${boundary}"`);
+        lines.push('');
+        lines.push(`--${boundary}`);
+        lines.push(`Content-Type: text/plain; charset=${charset}`);
+        lines.push('Content-Transfer-Encoding: 7bit');
+        lines.push('');
+        lines.push(email.textBody || '');
+        lines.push(`--${boundary}`);
+        lines.push(`Content-Type: text/html; charset=${charset}`);
+        lines.push('Content-Transfer-Encoding: 7bit');
+        lines.push('');
+        lines.push(email.htmlBody || '');
+        lines.push(`--${boundary}--`);
+    }
+    else if (hasHtml) {
+        lines.push(`Content-Type: text/html; charset=${charset}`);
+        lines.push('Content-Transfer-Encoding: 7bit');
+        lines.push('');
+        lines.push(email.htmlBody || '');
+    }
+    else {
+        lines.push(`Content-Type: text/plain; charset=${charset}`);
+        lines.push('Content-Transfer-Encoding: 7bit');
+        lines.push('');
+        lines.push(email.textBody || '');
+    }
+    return lines.join('\r\n');
+}
+//# sourceMappingURL=email-helpers.mjs.map

package/dist/email/email-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-helpers.mjs","sourceRoot":"","sources":["../../src/email/email-helpers.mts"],"names":[],"mappings":"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"}

package/dist/email/email-receiver.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Abstract base class for EmailReceiver drivers.
+ */
+import { EmailReceiver, EmailSpamVerdicts, InboundEmail } from './email-types.mjs';
+export declare abstract class EmailReceiverBase implements EmailReceiver {
+    abstract parseInboundPayload(payload: any): Promise<InboundEmail>;
+    /**
+     * Evaluates spam/SPF/DKIM/virus verdicts to determine folder classification ("inbox" vs "junk").
+     */
+    evaluateSpamVerdicts(verdicts: EmailSpamVerdicts): 'inbox' | 'junk';
+}
+//# sourceMappingURL=email-receiver.d.mts.map

package/dist/email/email-receiver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-receiver.d.mts","sourceRoot":"","sources":["../../src/email/email-receiver.mts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEnF,8BAAsB,iBAAkB,YAAW,aAAa;IAC5D,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAclE;CACJ"}

package/dist/email/email-receiver.mjs

@@ -0,0 +1,23 @@
+/**
+ * Abstract base class for EmailReceiver drivers.
+ */
+import { FOLDER_INBOX, FOLDER_JUNK, VERDICT_FAIL } from './email-constants.mjs';
+export class EmailReceiverBase {
+    /**
+     * Evaluates spam/SPF/DKIM/virus verdicts to determine folder classification ("inbox" vs "junk").
+     */
+    evaluateSpamVerdicts(verdicts) {
+        if (!verdicts) {
+            return FOLDER_INBOX;
+        }
+        const { spamVerdict, virusVerdict, spfVerdict, dkimVerdict } = verdicts;
+        if (spamVerdict === VERDICT_FAIL ||
+            virusVerdict === VERDICT_FAIL ||
+            spfVerdict === VERDICT_FAIL ||
+            dkimVerdict === VERDICT_FAIL) {
+            return FOLDER_JUNK;
+        }
+        return FOLDER_INBOX;
+    }
+}
+//# sourceMappingURL=email-receiver.mjs.map

package/dist/email/email-receiver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-receiver.mjs","sourceRoot":"","sources":["../../src/email/email-receiver.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAGhF,MAAM,OAAgB,iBAAiB;IAGnC;;OAEG;IACH,oBAAoB,CAAC,QAA2B;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAC,OAAO,YAAuB,CAAC;QAAC,CAAC;QAElD,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;QACxE,IACI,WAAW,KAAK,YAAY;YAC5B,YAAY,KAAK,YAAY;YAC7B,UAAU,KAAK,YAAY;YAC3B,WAAW,KAAK,YAAY,EAC9B,CAAC;YACC,OAAO,WAAqB,CAAC;QACjC,CAAC;QAED,OAAO,YAAuB,CAAC;IACnC,CAAC;CACJ"}

package/dist/email/email-sender.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Abstract base class for EmailSender drivers.
+ */
+import { EmailSender, EmailSendResult, OutboundEmail } from './email-types.mjs';
+export declare abstract class EmailSenderBase implements EmailSender {
+    abstract sendEmail(email: OutboundEmail): Promise<EmailSendResult>;
+    /**
+     * Validates required fields on an outbound email object.
+     * Throws an error if required fields are missing or invalid.
+     */
+    protected validateOutboundEmail(email: OutboundEmail): void;
+}
+//# sourceMappingURL=email-sender.d.mts.map

package/dist/email/email-sender.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender.d.mts","sourceRoot":"","sources":["../../src/email/email-sender.mts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEhF,8BAAsB,eAAgB,YAAW,WAAW;IACxD,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnE;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CA4B1D;CACJ"}

package/dist/email/email-sender.mjs

@@ -0,0 +1,35 @@
+/**
+ * Abstract base class for EmailSender drivers.
+ */
+import { parseEmailAddress, validateEmail } from './email-helpers.mjs';
+export class EmailSenderBase {
+    /**
+     * Validates required fields on an outbound email object.
+     * Throws an error if required fields are missing or invalid.
+     */
+    validateOutboundEmail(email) {
+        if (!email) {
+            throw new Error('OutboundEmail is required. (E: 8f4e2a1b9c3d4e5f6a7b8c9d0e1f2a3b)');
+        }
+        const fromParsed = parseEmailAddress(email.from);
+        if (!fromParsed.address || !validateEmail(fromParsed.address)) {
+            throw new Error(`Invalid "from" email address: ${fromParsed.address} (E: a1b2c3d4e5f67890123456789abcdef0)`);
+        }
+        if (!email.to || !Array.isArray(email.to) || email.to.length === 0) {
+            throw new Error('Outbound email must contain at least one recipient in "to". (E: 1a2b3c4d5e6f7890123456789abcdef1)');
+        }
+        for (const recipient of email.to) {
+            const parsed = parseEmailAddress(recipient);
+            if (!parsed.address || !validateEmail(parsed.address)) {
+                throw new Error(`Invalid "to" email address: ${parsed.address} (E: 2b3c4d5e6f7890123456789abcdef2)`);
+            }
+        }
+        if (!email.subject || typeof email.subject !== 'string') {
+            throw new Error('Outbound email must contain a "subject" string. (E: 3c4d5e6f7890123456789abcdef3)');
+        }
+        if (!email.textBody && !email.htmlBody) {
+            throw new Error('Outbound email must contain either "textBody" or "htmlBody". (E: 4d5e6f7890123456789abcdef4)');
+        }
+    }
+}
+//# sourceMappingURL=email-sender.mjs.map

package/dist/email/email-sender.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender.mjs","sourceRoot":"","sources":["../../src/email/email-sender.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGvE,MAAM,OAAgB,eAAe;IAGjC;;;OAGG;IACO,qBAAqB,CAAC,KAAoB;QAChD,IAAI,CAAC,KAAK,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,iCAAiC,UAAU,CAAC,OAAO,wCAAwC,CAAC,CAAC;QACjH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;QACzH,CAAC;QAED,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,OAAO,sCAAsC,CAAC,CAAC;YACzG,CAAC;QACL,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACzG,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,8FAA8F,CAAC,CAAC;QACpH,CAAC;IACL,CAAC;CACJ"}

package/dist/email/email-service.respec.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=email-service.respec.d.mts.map

package/dist/email/email-service.respec.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-service.respec.d.mts","sourceRoot":"","sources":["../../src/email/email-service.respec.mts"],"names":[],"mappings":""}

package/dist/email/email-service.respec.mjs

@@ -0,0 +1,115 @@
+import { iReckon, ifWe, respecfully } from '@ibgib/helper-gib/dist/respec-gib/respec-gib.mjs';
+import { createAwsSigV4Headers } from './aws/aws-sigv4-helper.mjs';
+import { EmailReceiverAws } from './aws/email-receiver-aws.mjs';
+import { formatEmailAddress, formatRawMimeString, parseEmailAddress, parseRawMimeHeaders, validateEmail } from './email-helpers.mjs';
+import { EmailSenderMock } from './mock/email-sender-mock.mjs';
+const sir = `[${import.meta.url}]`;
+await respecfully(sir, 'Email Infrastructure & Drivers', async () => {
+    await ifWe(sir, 'validate email addresses accurately using validateEmail', async () => {
+        iReckon(sir, validateEmail('user@example.com')).asTo('valid email').isGonnaBe(true);
+        iReckon(sir, validateEmail('user.name+tag@domain.co.uk')).asTo('valid tagged email').isGonnaBe(true);
+        iReckon(sir, validateEmail('invalid-email')).asTo('invalid format without @').isGonnaBe(false);
+        iReckon(sir, validateEmail('user@')).asTo('missing domain').isGonnaBe(false);
+        iReckon(sir, validateEmail('')).asTo('empty string').isGonnaBe(false);
+    });
+    await ifWe(sir, 'parse and format email addresses correctly', async () => {
+        const parsed1 = parseEmailAddress('Alice <alice@example.com>');
+        iReckon(sir, parsed1.address).asTo('parsed address').isGonnaBe('alice@example.com');
+        iReckon(sir, parsed1.name).asTo('parsed name').isGonnaBe('Alice');
+        const formatted = formatEmailAddress({ name: 'Bob', address: 'bob@example.com' });
+        iReckon(sir, formatted).asTo('formatted address').isGonnaBe('"Bob" <bob@example.com>');
+    });
+    await ifWe(sir, 'format and parse raw MIME headers and strings', async () => {
+        const mimeStr = formatRawMimeString({
+            from: { name: 'Sender', address: 'sender@example.com' },
+            to: ['receiver@example.com'],
+            subject: 'Test Subject',
+            textBody: 'Hello World',
+        });
+        const headers = parseRawMimeHeaders(mimeStr);
+        iReckon(sir, headers['From']).asTo('MIME From header').isGonnaBe('"Sender" <sender@example.com>');
+        iReckon(sir, headers['Subject']).asTo('MIME Subject header').isGonnaBe('Test Subject');
+    });
+    await ifWe(sir, 'dispatch emails using EmailSenderMock and maintain history', async () => {
+        const mockSender = new EmailSenderMock();
+        mockSender.clearSentEmails();
+        const result = await mockSender.sendEmail({
+            from: 'test@example.com',
+            to: ['target@example.com'],
+            subject: 'Mock Subject',
+            textBody: 'Mock body',
+        });
+        iReckon(sir, result.success).asTo('mock send result success').isGonnaBe(true);
+        iReckon(sir, Boolean(result.messageId)).asTo('mock messageId generated').isGonnaBe(true);
+        const sent = mockSender.getSentEmails();
+        iReckon(sir, sent.length).asTo('sent emails count').isGonnaBe(1);
+        iReckon(sir, sent[0].subject).asTo('sent email subject').isGonnaBe('Mock Subject');
+        // Verify failure mode
+        mockSender.shouldFail = true;
+        const failResult = await mockSender.sendEmail({
+            from: 'test@example.com',
+            to: ['target@example.com'],
+            subject: 'Fail Subject',
+            textBody: 'Fail body',
+        });
+        iReckon(sir, failResult.success).asTo('mock send failure result success').isGonnaBe(false);
+    });
+    await ifWe(sir, 'calculate valid AWS SigV4 headers with createAwsSigV4Headers', async () => {
+        const sigResult = createAwsSigV4Headers({
+            method: 'POST',
+            url: 'https://email.us-east-1.amazonaws.com/',
+            region: 'us-east-1',
+            service: 'ses',
+            accessKeyId: 'AKIAIOSFODNN7EXAMPLE',
+            secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+            body: 'Action=SendEmail&Version=2010-12-01',
+            timestamp: new Date('2026-07-30T18:00:00.000Z'),
+        });
+        iReckon(sir, sigResult.amzDate).asTo('formatted X-Amz-Date').isGonnaBe('20260730T180000Z');
+        iReckon(sir, sigResult.headers['Host']).asTo('Host header').isGonnaBe('email.us-east-1.amazonaws.com');
+        iReckon(sir, sigResult.authorization.startsWith('AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20260730/us-east-1/ses/aws4_request')).asTo('authorization header credential prefix').isGonnaBe(true);
+        iReckon(sir, Boolean(sigResult.signature)).asTo('signature computed').isGonnaBe(true);
+    });
+    await ifWe(sir, 'parse SES webhook payloads and evaluate spam verdicts into inbox/junk folders', async () => {
+        const receiver = new EmailReceiverAws();
+        // Pass verdict payload
+        const passPayload = {
+            mail: {
+                messageId: 'msg-pass-123',
+                source: 'alice@example.com',
+                destination: ['bob@example.com'],
+                commonHeaders: { subject: 'Clean Mail' },
+                timestamp: '2026-07-30T18:00:00Z',
+            },
+            receipt: {
+                spamVerdict: { status: 'PASS' },
+                virusVerdict: { status: 'PASS' },
+                spfVerdict: { status: 'PASS' },
+                dkimVerdict: { status: 'PASS' },
+            },
+            content: 'Clean body',
+        };
+        const parsedPass = await receiver.parseInboundPayload(passPayload);
+        iReckon(sir, parsedPass.folder).asTo('clean email folder').isGonnaBe('inbox');
+        iReckon(sir, parsedPass.from.address).asTo('parsed from address').isGonnaBe('alice@example.com');
+        iReckon(sir, parsedPass.subject).asTo('parsed subject').isGonnaBe('Clean Mail');
+        // Fail verdict payload
+        const failPayload = {
+            mail: {
+                messageId: 'msg-spam-456',
+                source: 'spammer@badsite.com',
+                destination: ['bob@example.com'],
+                commonHeaders: { subject: 'Buy Cheap Stuff' },
+            },
+            receipt: {
+                spamVerdict: { status: 'FAIL' },
+                virusVerdict: { status: 'PASS' },
+                spfVerdict: { status: 'FAIL' },
+                dkimVerdict: { status: 'PASS' },
+            },
+        };
+        const parsedFail = await receiver.parseInboundPayload(failPayload);
+        iReckon(sir, parsedFail.folder).asTo('spam email folder').isGonnaBe('junk');
+    });
+});
+//# sourceMappingURL=email-service.respec.mjs.map

package/dist/email/email-service.respec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-service.respec.mjs","sourceRoot":"","sources":["../../src/email/email-service.respec.mts"],"names":[],"mappings":"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"}

package/dist/email/email-types.d.mts

@@ -0,0 +1,53 @@
+/**
+ * Interfaces and types for email architecture in node-gib.
+ */
+export interface EmailAddress {
+    address: string;
+    name?: string;
+}
+export interface OutboundEmail {
+    from: EmailAddress | string;
+    to: (EmailAddress | string)[];
+    cc?: (EmailAddress | string)[];
+    bcc?: (EmailAddress | string)[];
+    subject: string;
+    textBody?: string;
+    htmlBody?: string;
+    replyTo?: EmailAddress | string;
+    headers?: Record<string, string>;
+}
+export interface EmailSpamVerdicts {
+    spamVerdict: 'PASS' | 'FAIL' | 'GRAY' | string;
+    virusVerdict?: 'PASS' | 'FAIL' | 'GRAY' | string;
+    spfVerdict?: 'PASS' | 'FAIL' | 'GRAY' | string;
+    dkimVerdict?: 'PASS' | 'FAIL' | 'GRAY' | string;
+    dmarcVerdict?: 'PASS' | 'FAIL' | 'GRAY' | string;
+}
+export interface InboundEmail {
+    messageId: string;
+    from: EmailAddress;
+    to: EmailAddress[];
+    cc?: EmailAddress[];
+    subject: string;
+    textBody?: string;
+    htmlBody?: string;
+    rawMime?: string;
+    receivedAt: string;
+    spamVerdicts?: EmailSpamVerdicts;
+    folder?: 'inbox' | 'junk' | string;
+    headers?: Record<string, string>;
+}
+export interface EmailSendResult {
+    success: boolean;
+    messageId?: string;
+    error?: string;
+    statusCode?: number;
+}
+export interface EmailSender {
+    sendEmail(email: OutboundEmail): Promise<EmailSendResult>;
+}
+export interface EmailReceiver {
+    parseInboundPayload(payload: any): Promise<InboundEmail>;
+    evaluateSpamVerdicts(verdicts: EmailSpamVerdicts): 'inbox' | 'junk';
+}
+//# sourceMappingURL=email-types.d.mts.map

package/dist/email/email-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-types.d.mts","sourceRoot":"","sources":["../../src/email/email-types.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC5B,EAAE,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC;IAC9B,EAAE,CAAC,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC;IAC/B,GAAG,CAAC,EAAE,CAAC,YAAY,GAAG,MAAM,CAAC,EAAE,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAC9B,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAChD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;CACpD;AAED,MAAM,WAAW,YAAY;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,YAAY,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,iBAAiB,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,aAAa;IAC1B,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD,oBAAoB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,GAAG,MAAM,CAAC;CACvE"}

package/dist/email/email-types.mjs

@@ -0,0 +1,5 @@
+/**
+ * Interfaces and types for email architecture in node-gib.
+ */
+export {};
+//# sourceMappingURL=email-types.mjs.map

package/dist/email/email-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-types.mjs","sourceRoot":"","sources":["../../src/email/email-types.mts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/email/index.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Email infrastructure module exports.
+ */
+export * from './email-constants.mjs';
+export * from './email-types.mjs';
+export * from './email-helpers.mjs';
+export * from './email-sender.mjs';
+export * from './email-receiver.mjs';
+export * from './aws/index.mjs';
+export * from './mock/index.mjs';
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/email/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/email/index.mjs

@@ -0,0 +1,11 @@
+/**
+ * Email infrastructure module exports.
+ */
+export * from './email-constants.mjs';
+export * from './email-types.mjs';
+export * from './email-helpers.mjs';
+export * from './email-sender.mjs';
+export * from './email-receiver.mjs';
+export * from './aws/index.mjs';
+export * from './mock/index.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/email/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/email/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/email/mock/email-sender-mock.d.mts

@@ -0,0 +1,20 @@
+/**
+ * In-memory mock implementation of EmailSenderBase for unit testing.
+ */
+import { EmailSenderBase } from '../email-sender.mjs';
+import { EmailSendResult, OutboundEmail } from '../email-types.mjs';
+export declare class EmailSenderMock extends EmailSenderBase {
+    private sentEmails;
+    shouldFail: boolean;
+    failureMessage: string;
+    sendEmail(email: OutboundEmail): Promise<EmailSendResult>;
+    /**
+     * Gets array of all emails sent through this mock sender.
+     */
+    getSentEmails(): OutboundEmail[];
+    /**
+     * Clears recorded sent emails.
+     */
+    clearSentEmails(): void;
+}
+//# sourceMappingURL=email-sender-mock.d.mts.map

package/dist/email/mock/email-sender-mock.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender-mock.d.mts","sourceRoot":"","sources":["../../../src/email/mock/email-sender-mock.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,qBAAa,eAAgB,SAAQ,eAAe;IAChD,OAAO,CAAC,UAAU,CAAuB;IAClC,UAAU,EAAE,OAAO,CAAS;IAC5B,cAAc,EAAE,MAAM,CAAuB;IAE9C,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC,CA0B9D;IAED;;OAEG;IACH,aAAa,IAAI,aAAa,EAAE,CAE/B;IAED;;OAEG;IACH,eAAe,IAAI,IAAI,CAEtB;CACJ"}

package/dist/email/mock/email-sender-mock.mjs

@@ -0,0 +1,47 @@
+/**
+ * In-memory mock implementation of EmailSenderBase for unit testing.
+ */
+import { EmailSenderBase } from '../email-sender.mjs';
+export class EmailSenderMock extends EmailSenderBase {
+    sentEmails = [];
+    shouldFail = false;
+    failureMessage = 'Mock send failure';
+    async sendEmail(email) {
+        try {
+            this.validateOutboundEmail(email);
+            if (this.shouldFail) {
+                return {
+                    success: false,
+                    error: this.failureMessage,
+                    statusCode: 500,
+                };
+            }
+            this.sentEmails.push({ ...email });
+            const messageId = `mock-msg-${Date.now()}-${this.sentEmails.length}`;
+            return {
+                success: true,
+                messageId,
+                statusCode: 200,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error?.message || String(error),
+            };
+        }
+    }
+    /**
+     * Gets array of all emails sent through this mock sender.
+     */
+    getSentEmails() {
+        return [...this.sentEmails];
+    }
+    /**
+     * Clears recorded sent emails.
+     */
+    clearSentEmails() {
+        this.sentEmails = [];
+    }
+}
+//# sourceMappingURL=email-sender-mock.mjs.map

package/dist/email/mock/email-sender-mock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-sender-mock.mjs","sourceRoot":"","sources":["../../../src/email/mock/email-sender-mock.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACxC,UAAU,GAAoB,EAAE,CAAC;IAClC,UAAU,GAAY,KAAK,CAAC;IAC5B,cAAc,GAAW,mBAAmB,CAAC;IAEpD,KAAK,CAAC,SAAS,CAAC,KAAoB;QAChC,IAAI,CAAC;YACD,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAElC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,OAAO;oBACH,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,CAAC,cAAc;oBAC1B,UAAU,EAAE,GAAG;iBAClB,CAAC;YACN,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;YACnC,MAAM,SAAS,GAAG,YAAY,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;YAErE,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,UAAU,EAAE,GAAG;aAClB,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;aACzC,CAAC;QACN,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,eAAe;QACX,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACzB,CAAC;CACJ"}

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

@@ -0,0 +1,5 @@
+/**
+ * Mock email driver exports.
+ */
+export * from './email-sender-mock.mjs';
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/email/mock/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC"}

package/dist/email/mock/index.mjs

@@ -0,0 +1,5 @@
+/**
+ * Mock email driver exports.
+ */
+export * from './email-sender-mock.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/email/mock/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/email/mock/index.mts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,yBAAyB,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @module @ibgib/node-gib
+ *
+ * Node.js-specific ibgib witnesses, filesystem spaces, and serve-gib microframework.
+ */
+export * from './constants.mjs';
+export * from './foo.mjs';
+export * from './helpers.mjs';
+export * from './types.mjs';
+export * from './serve-gib/index.mjs';
+export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, } from './email/index.mjs';
+export type * from './email/email-types.mjs';
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.mts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAG5B,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,eAAe,GAClB,MAAM,mBAAmB,CAAC;AAC3B,mBAAmB,yBAAyB,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,14 @@
+/**
+ * @module @ibgib/node-gib
+ *
+ * Node.js-specific ibgib witnesses, filesystem spaces, and serve-gib microframework.
+ */
+export * from './constants.mjs';
+export * from './foo.mjs';
+export * from './helpers.mjs';
+export * from './types.mjs';
+// serve-gib microframework
+export * from './serve-gib/index.mjs';
+// email infrastructure
+export { DEFAULT_EMAIL_CHARSET, EMAIL_MODE_AWS, EMAIL_MODE_MOCK, DEFAULT_AWS_REGION, DEFAULT_AWS_SES_ENDPOINT, DEFAULT_AWS_SERVICE, VERDICT_PASS, VERDICT_FAIL, VERDICT_GRAY, FOLDER_INBOX, FOLDER_JUNK, parseEmailAddress, formatEmailAddress, parseRawMimeHeaders, formatRawMimeString, validateEmail, validateEmailAddress, EmailSenderBase, EmailReceiverBase, createAwsSigV4Headers, EmailSenderAws, EmailReceiverAws, EmailSenderMock, } from './email/index.mjs';
+//# sourceMappingURL=index.mjs.map