@ts-cloud/core 0.2.2 → 0.2.4

package/dist/email/analytics.d.ts

@@ -0,0 +1,189 @@
+/**
+ * SES Email Analytics
+ * Email tracking, analytics, and reporting
+ */
+export interface EmailEvent {
+    id: string;
+    messageId: string;
+    eventType: 'send' | 'delivery' | 'open' | 'click' | 'bounce' | 'complaint' | 'reject' | 'renderingFailure';
+    timestamp: Date;
+    recipient: string;
+    subject?: string;
+    tags?: Record<string, string>;
+}
+export interface OpenEvent extends EmailEvent {
+    eventType: 'open';
+    ipAddress: string;
+    userAgent: string;
+}
+export interface ClickEvent extends EmailEvent {
+    eventType: 'click';
+    link: string;
+    ipAddress: string;
+    userAgent: string;
+}
+export interface EmailCampaign {
+    id: string;
+    name: string;
+    subject: string;
+    fromEmail: string;
+    tags: Record<string, string>;
+    sentCount: number;
+    deliveredCount: number;
+    openCount: number;
+    clickCount: number;
+    bounceCount: number;
+    complaintCount: number;
+    createdAt: Date;
+}
+export interface AnalyticsReport {
+    id: string;
+    campaignId?: string;
+    startDate: Date;
+    endDate: Date;
+    totalSent: number;
+    totalDelivered: number;
+    totalOpened: number;
+    totalClicked: number;
+    totalBounced: number;
+    totalComplaints: number;
+    deliveryRate: number;
+    openRate: number;
+    clickRate: number;
+    clickToOpenRate: number;
+    bounceRate: number;
+    complaintRate: number;
+    topLinks: Array<{
+        link: string;
+        clicks: number;
+    }>;
+    deviceBreakdown: Record<string, number>;
+    locationBreakdown: Record<string, number>;
+}
+export interface ABTest {
+    id: string;
+    name: string;
+    variants: ABTestVariant[];
+    status: 'draft' | 'running' | 'completed';
+    startedAt?: Date;
+    completedAt?: Date;
+    winner?: string;
+}
+export interface ABTestVariant {
+    id: string;
+    name: string;
+    subject: string;
+    content: string;
+    weight: number;
+    sentCount: number;
+    openCount: number;
+    clickCount: number;
+    conversionCount: number;
+}
+/**
+ * Email analytics manager
+ */
+export declare class EmailAnalyticsManager {
+    private events;
+    private campaigns;
+    private reports;
+    private abTests;
+    private eventCounter;
+    private campaignCounter;
+    private reportCounter;
+    private abTestCounter;
+    /**
+     * Track email event
+     */
+    trackEvent(event: Omit<EmailEvent, 'id'>): EmailEvent;
+    /**
+     * Track open event
+     */
+    trackOpen(options: {
+        messageId: string;
+        recipient: string;
+        ipAddress: string;
+        userAgent: string;
+        tags?: Record<string, string>;
+    }): OpenEvent;
+    /**
+     * Track click event
+     */
+    trackClick(options: {
+        messageId: string;
+        recipient: string;
+        link: string;
+        ipAddress: string;
+        userAgent: string;
+        tags?: Record<string, string>;
+    }): ClickEvent;
+    /**
+     * Create campaign
+     */
+    createCampaign(campaign: Omit<EmailCampaign, 'id' | 'sentCount' | 'deliveredCount' | 'openCount' | 'clickCount' | 'bounceCount' | 'complaintCount' | 'createdAt'>): EmailCampaign;
+    /**
+     * Update campaign stats
+     */
+    private updateCampaignStats;
+    /**
+     * Generate analytics report
+     */
+    generateReport(options: {
+        campaignId?: string;
+        startDate: Date;
+        endDate: Date;
+    }): AnalyticsReport;
+    /**
+     * Create A/B test
+     */
+    createABTest(options: {
+        name: string;
+        variants: Array<{
+            name: string;
+            subject: string;
+            content: string;
+            weight: number;
+        }>;
+    }): ABTest;
+    /**
+     * Start A/B test
+     */
+    startABTest(abTestId: string): ABTest;
+    /**
+     * Complete A/B test
+     */
+    completeABTest(abTestId: string): ABTest;
+    /**
+     * Get campaign
+     */
+    getCampaign(id: string): EmailCampaign | undefined;
+    /**
+     * List campaigns
+     */
+    listCampaigns(): EmailCampaign[];
+    /**
+     * Get events
+     */
+    getEvents(options?: {
+        messageId?: string;
+        eventType?: string;
+        startDate?: Date;
+        endDate?: Date;
+    }): EmailEvent[];
+    /**
+     * Generate CloudFormation for tracking configuration
+     */
+    generateTrackingConfigurationCF(options: {
+        configurationSetName: string;
+        openTracking?: boolean;
+        clickTracking?: boolean;
+    }): any;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+}
+/**
+ * Global email analytics manager instance
+ */
+export declare const emailAnalyticsManager: EmailAnalyticsManager;

package/dist/email/bounce-handling.d.ts

@@ -0,0 +1,171 @@
+/**
+ * SES Bounce and Complaint Handling
+ * Automated bounce processing and reputation management
+ */
+export interface BounceEvent {
+    id: string;
+    timestamp: Date;
+    messageId: string;
+    recipient: string;
+    bounceType: 'Permanent' | 'Transient' | 'Undetermined';
+    bounceSubType: string;
+    diagnosticCode?: string;
+    feedbackId: string;
+}
+export interface ComplaintEvent {
+    id: string;
+    timestamp: Date;
+    messageId: string;
+    recipients: string[];
+    complaintFeedbackType?: string;
+    userAgent?: string;
+    feedbackId: string;
+    arrivalDate?: Date;
+}
+export interface BounceHandler {
+    id: string;
+    name: string;
+    bounceThreshold: number;
+    complaintThreshold: number;
+    suppressionDuration: number;
+    autoSuppress: boolean;
+    notificationTopicArn?: string;
+}
+export interface SuppressionListEntry {
+    id: string;
+    emailAddress: string;
+    reason: 'BOUNCE' | 'COMPLAINT';
+    suppressedAt: Date;
+    expiresAt?: Date;
+    bounceCount?: number;
+    complaintCount?: number;
+}
+export interface ReputationMetrics {
+    id: string;
+    timestamp: Date;
+    bounceRate: number;
+    complaintRate: number;
+    sendingQuota: number;
+    maxSendRate: number;
+    sentLast24Hours: number;
+    reputationStatus: 'Good' | 'Warning' | 'Probation' | 'Shutdown';
+}
+/**
+ * Bounce and complaint handler
+ */
+export declare class BounceComplaintHandler {
+    private bounces;
+    private complaints;
+    private handlers;
+    private suppressionList;
+    private metrics;
+    private bounceCounter;
+    private complaintCounter;
+    private handlerCounter;
+    private suppressionCounter;
+    private metricsCounter;
+    /**
+     * Record bounce event
+     */
+    recordBounce(bounce: Omit<BounceEvent, 'id'>): BounceEvent;
+    /**
+     * Record complaint event
+     */
+    recordComplaint(complaint: Omit<ComplaintEvent, 'id'>): ComplaintEvent;
+    /**
+     * Create bounce handler
+     */
+    createBounceHandler(handler: Omit<BounceHandler, 'id'>): BounceHandler;
+    /**
+     * Create automatic bounce handler
+     */
+    createAutomaticBounceHandler(options: {
+        name: string;
+        notificationTopicArn: string;
+    }): BounceHandler;
+    /**
+     * Add to suppression list
+     */
+    addToSuppressionList(entry: {
+        emailAddress: string;
+        reason: 'BOUNCE' | 'COMPLAINT';
+        expirationDays?: number;
+    }): SuppressionListEntry;
+    /**
+     * Remove from suppression list
+     */
+    removeFromSuppressionList(emailAddress: string): boolean;
+    /**
+     * Check if email is suppressed
+     */
+    isSuppressed(emailAddress: string): boolean;
+    /**
+     * Get bounce statistics
+     */
+    getBounceStatistics(startDate: Date, endDate: Date): {
+        totalBounces: number;
+        permanentBounces: number;
+        transientBounces: number;
+        bounceRate: number;
+        topRecipients: Array<{
+            email: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Get complaint statistics
+     */
+    getComplaintStatistics(startDate: Date, endDate: Date): {
+        totalComplaints: number;
+        uniqueComplainters: number;
+        complaintRate: number;
+    };
+    /**
+     * Calculate reputation metrics
+     */
+    calculateReputationMetrics(): ReputationMetrics;
+    /**
+     * Get bounce events
+     */
+    getBounces(messageId?: string): BounceEvent[];
+    /**
+     * Get complaint events
+     */
+    getComplaints(messageId?: string): ComplaintEvent[];
+    /**
+     * List suppression list
+     */
+    listSuppressionList(reason?: 'BOUNCE' | 'COMPLAINT'): SuppressionListEntry[];
+    /**
+     * Generate CloudFormation for SNS topic subscription
+     */
+    generateSNSSubscriptionCF(options: {
+        topicArn: string;
+        endpoint: string;
+        protocol: 'email' | 'email-json' | 'http' | 'https' | 'sqs' | 'lambda';
+    }): any;
+    /**
+     * Generate CloudFormation for SES configuration set event destination
+     */
+    generateEventDestinationCF(options: {
+        configurationSetName: string;
+        eventDestinationName: string;
+        eventTypes: Array<'send' | 'reject' | 'bounce' | 'complaint' | 'delivery' | 'open' | 'click' | 'renderingFailure'>;
+        snsTopicArn?: string;
+        cloudWatchDestination?: {
+            dimensionConfigurations: Array<{
+                dimensionName: string;
+                dimensionValueSource: 'messageTag' | 'emailHeader' | 'linkTag';
+                defaultDimensionValue: string;
+            }>;
+        };
+    }): any;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+}
+/**
+ * Global bounce and complaint handler instance
+ */
+export declare const bounceComplaintHandler: BounceComplaintHandler;

package/dist/email/email.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/email/handlers/__tests__/inbound.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/email/handlers/__tests__/outbound.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/email/handlers/converter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Email Conversion Lambda Handler
+ *
+ * Converts raw MIME emails to readable formats:
+ * - Converts raw MIME to HTML/text
+ * - Extracts and saves attachments separately
+ * - Generates email previews
+ * - Creates searchable metadata JSON
+ */
+export declare const handler = "\nconst { S3Client, GetObjectCommand, PutObjectCommand } = require('@aws-sdk/client-s3');\nconst s3 = new S3Client({});\n\nexports.handler = async (event) => {\n  console.log('Email conversion event:', JSON.stringify(event, null, 2));\n\n  const bucket = process.env.EMAIL_BUCKET;\n\n  for (const record of event.Records) {\n    try {\n      const s3Event = record.s3 || {};\n      const key = decodeURIComponent(s3Event.object?.key?.replace(/\\+/g, ' ') || '');\n\n      // Only process raw.eml files in mailboxes\n      if (!key.endsWith('/raw.eml') || !key.startsWith('mailboxes/')) {\n        continue;\n      }\n\n      const basePath = key.replace('/raw.eml', '');\n\n      // Get raw email\n      const getResult = await s3.send(new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n      }));\n\n      const rawEmail = await getResult.Body.transformToString();\n\n      // Parse email\n      const parsed = parseEmail(rawEmail);\n\n      // Save HTML version\n      if (parsed.html) {\n        await s3.send(new PutObjectCommand({\n          Bucket: bucket,\n          Key: `${basePath}/body.html`,\n          Body: parsed.html,\n          ContentType: 'text/html',\n        }));\n      }\n\n      // Save text version\n      if (parsed.text) {\n        await s3.send(new PutObjectCommand({\n          Bucket: bucket,\n          Key: `${basePath}/body.txt`,\n          Body: parsed.text,\n          ContentType: 'text/plain',\n        }));\n      }\n\n      // Save attachments\n      if (parsed.attachments && parsed.attachments.length > 0) {\n        for (let i = 0; i < parsed.attachments.length; i++) {\n          const attachment = parsed.attachments[i];\n          await s3.send(new PutObjectCommand({\n            Bucket: bucket,\n            Key: `${basePath}/attachments/${attachment.filename}`,\n            Body: Buffer.from(attachment.content, 'base64'),\n            ContentType: attachment.contentType,\n          }));\n        }\n\n        // Update metadata with attachment info\n        try {\n          const metaResult = await s3.send(new GetObjectCommand({\n            Bucket: bucket,\n            Key: `${basePath}/metadata.json`,\n          }));\n          const metadata = JSON.parse(await metaResult.Body.transformToString());\n\n          metadata.attachments = parsed.attachments.map(a => ({\n            filename: a.filename,\n            contentType: a.contentType,\n            size: a.size,\n          }));\n          metadata.converted = true;\n          metadata.convertedAt = new Date().toISOString();\n\n          await s3.send(new PutObjectCommand({\n            Bucket: bucket,\n            Key: `${basePath}/metadata.json`,\n            Body: JSON.stringify(metadata, null, 2),\n            ContentType: 'application/json',\n          }));\n        }\ncatch (err) {\n          console.log('Could not update metadata:', err.message);\n        }\n      }\n\n      // Generate preview (first 200 chars of text)\n      const preview = (parsed.text || parsed.html?.replace(/<[^>]+>/g, '') || '')\n        .substring(0, 200)\n        .replace(/\\s+/g, ' ')\n        .trim();\n\n      await s3.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: `${basePath}/preview.txt`,\n        Body: preview,\n        ContentType: 'text/plain',\n      }));\n\n      console.log(`Converted email: ${key}`);\n\n    }\ncatch (error) {\n      console.error('Error converting email:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n\n// Simple MIME parser\nfunction parseEmail(rawEmail) {\n  const result = {\n    headers: {},\n    text: null,\n    html: null,\n    attachments: [],\n  };\n\n  // Split headers and body\n  const parts = rawEmail.split(/\\r?\\n\\r?\\n/);\n  const headerSection = parts[0];\n  const bodySection = parts.slice(1).join('\\n\\n');\n\n  // Parse headers\n  let currentHeader = '';\n  for (const line of headerSection.split(/\\r?\\n/)) {\n    if (line.match(/^[A-Za-z-]+:/)) {\n      const colonIndex = line.indexOf(':');\n      currentHeader = line.substring(0, colonIndex).toLowerCase();\n      result.headers[currentHeader] = line.substring(colonIndex + 1).trim();\n    }\nelse if (currentHeader && (line.startsWith(' ') || line.startsWith('\\t'))) {\n      result.headers[currentHeader] += ' ' + line.trim();\n    }\n  }\n\n  // Check content type\n  const contentType = result.headers['content-type'] || 'text/plain';\n\n  if (contentType.includes('multipart/')) {\n    // Extract boundary\n    const boundaryMatch = contentType.match(/boundary=\"?([^\";]+)\"?/);\n    if (boundaryMatch) {\n      const boundary = boundaryMatch[1];\n      const mimeParts = bodySection.split('--' + boundary);\n\n      for (const part of mimeParts) {\n        if (part.trim() === '' || part.trim() === '--') continue;\n\n        const partParts = part.split(/\\r?\\n\\r?\\n/);\n        const partHeaders = partParts[0];\n        const partBody = partParts.slice(1).join('\\n\\n').trim();\n\n        const partContentType = (partHeaders.match(/Content-Type:\\s*([^;\\r\\n]+)/i) || [])[1] || '';\n        const partEncoding = (partHeaders.match(/Content-Transfer-Encoding:\\s*([^\\r\\n]+)/i) || [])[1] || '';\n        const partDisposition = (partHeaders.match(/Content-Disposition:\\s*([^;\\r\\n]+)/i) || [])[1] || '';\n\n        if (partDisposition.includes('attachment') || partContentType.includes('application/')) {\n          // Attachment\n          const filenameMatch = partHeaders.match(/filename=\"?([^\"\\r\\n]+)\"?/i);\n          const filename = filenameMatch ? filenameMatch[1] : `attachment_${result.attachments.length + 1}`;\n\n          let content = partBody;\n          if (partEncoding.toLowerCase() === 'base64') {\n            content = partBody.replace(/\\s/g, '');\n          }\n\n          result.attachments.push({\n            filename,\n            contentType: partContentType.trim(),\n            content,\n            size: Buffer.from(content, 'base64').length,\n          });\n        }\nelse if (partContentType.includes('text/html')) {\n          result.html = decodeContent(partBody, partEncoding);\n        }\nelse if (partContentType.includes('text/plain')) {\n          result.text = decodeContent(partBody, partEncoding);\n        }\nelse if (partContentType.includes('multipart/')) {\n          // Nested multipart - recursively parse\n          const nestedResult = parseEmail(partHeaders + '\\n\\n' + partBody);\n          if (nestedResult.html) result.html = nestedResult.html;\n          if (nestedResult.text) result.text = nestedResult.text;\n          result.attachments.push(...nestedResult.attachments);\n        }\n      }\n    }\n  }\nelse if (contentType.includes('text/html')) {\n    result.html = bodySection;\n  }\nelse {\n    result.text = bodySection;\n  }\n\n  return result;\n}\n\nfunction decodeContent(content, encoding) {\n  if (!encoding) return content;\n\n  encoding = encoding.toLowerCase().trim();\n\n  if (encoding === 'base64') {\n    return Buffer.from(content.replace(/\\s/g, ''), 'base64').toString('utf-8');\n  }\nelse if (encoding === 'quoted-printable') {\n    return content\n      .replace(/=\\r?\\n/g, '')\n      .replace(/=([0-9A-F]{2})/gi, (_, hex) => String.fromCharCode(parseInt(hex, 16)));\n  }\n\n  return content;\n}\n";
+export default handler;

package/dist/email/handlers/feedback.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Email Feedback Lambda Handler
+ *
+ * Processes SES bounce and complaint notifications:
+ * - Processes SES bounce notifications
+ * - Processes complaint notifications
+ * - Updates suppression list
+ * - Sends admin notifications
+ */
+export declare const handler = "\nconst { S3Client, GetObjectCommand, PutObjectCommand } = require('@aws-sdk/client-s3');\nconst { SNSClient, PublishCommand } = require('@aws-sdk/client-sns');\n\nconst s3 = new S3Client({});\nconst sns = new SNSClient({});\n\nexports.handler = async (event) => {\n  console.log('Email feedback event:', JSON.stringify(event, null, 2));\n\n  const bucket = process.env.EMAIL_BUCKET;\n  const adminTopicArn = process.env.ADMIN_TOPIC_ARN;\n\n  for (const record of event.Records) {\n    try {\n      const message = JSON.parse(record.Sns?.Message || record.body || '{}');\n      const notificationType = message.notificationType || message.eventType;\n\n      if (!notificationType) {\n        console.log('Unknown notification type, skipping');\n        continue;\n      }\n\n      const timestamp = new Date().toISOString();\n\n      if (notificationType === 'Bounce') {\n        await handleBounce(message, bucket, adminTopicArn, timestamp);\n      }\nelse if (notificationType === 'Complaint') {\n        await handleComplaint(message, bucket, adminTopicArn, timestamp);\n      }\nelse if (notificationType === 'Delivery') {\n        await handleDelivery(message, bucket, timestamp);\n      }\n\n    }\ncatch (error) {\n      console.error('Error processing feedback:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n\nasync function handleBounce(message, bucket, adminTopicArn, timestamp) {\n  const bounce = message.bounce || {};\n  const mail = message.mail || {};\n\n  console.log(`Processing bounce: ${bounce.bounceType} - ${bounce.bounceSubType}`);\n\n  // Get bounced recipients\n  const bouncedRecipients = bounce.bouncedRecipients || [];\n\n  for (const recipient of bouncedRecipients) {\n    const email = recipient.emailAddress;\n\n    // Add to suppression list\n    await addToSuppressionList(bucket, email, 'bounce', {\n      type: bounce.bounceType,\n      subType: bounce.bounceSubType,\n      diagnosticCode: recipient.diagnosticCode,\n      action: recipient.action,\n      status: recipient.status,\n      timestamp,\n      originalMessageId: mail.messageId,\n    });\n\n    console.log(`Added ${email} to suppression list (bounce)`);\n  }\n\n  // Log bounce event\n  await logFeedbackEvent(bucket, 'bounces', {\n    type: 'bounce',\n    bounceType: bounce.bounceType,\n    bounceSubType: bounce.bounceSubType,\n    recipients: bouncedRecipients.map(r => r.emailAddress),\n    messageId: mail.messageId,\n    timestamp,\n  });\n\n  // Notify admin for hard bounces\n  if (bounce.bounceType === 'Permanent' && adminTopicArn) {\n    await sns.send(new PublishCommand({\n      TopicArn: adminTopicArn,\n      Subject: `Email Bounce Alert: ${bounce.bounceSubType}`,\n      Message: JSON.stringify({\n        type: 'bounce',\n        bounceType: bounce.bounceType,\n        bounceSubType: bounce.bounceSubType,\n        recipients: bouncedRecipients.map(r => ({\n          email: r.emailAddress,\n          diagnosticCode: r.diagnosticCode,\n        })),\n        originalSubject: mail.commonHeaders?.subject,\n        timestamp,\n      }, null, 2),\n    }));\n  }\n}\n\nasync function handleComplaint(message, bucket, adminTopicArn, timestamp) {\n  const complaint = message.complaint || {};\n  const mail = message.mail || {};\n\n  console.log(`Processing complaint: ${complaint.complaintFeedbackType}`);\n\n  // Get complained recipients\n  const complainedRecipients = complaint.complainedRecipients || [];\n\n  for (const recipient of complainedRecipients) {\n    const email = recipient.emailAddress;\n\n    // Add to suppression list\n    await addToSuppressionList(bucket, email, 'complaint', {\n      feedbackType: complaint.complaintFeedbackType,\n      userAgent: complaint.userAgent,\n      timestamp,\n      originalMessageId: mail.messageId,\n    });\n\n    console.log(`Added ${email} to suppression list (complaint)`);\n  }\n\n  // Log complaint event\n  await logFeedbackEvent(bucket, 'complaints', {\n    type: 'complaint',\n    feedbackType: complaint.complaintFeedbackType,\n    recipients: complainedRecipients.map(r => r.emailAddress),\n    messageId: mail.messageId,\n    timestamp,\n  });\n\n  // Always notify admin for complaints\n  if (adminTopicArn) {\n    await sns.send(new PublishCommand({\n      TopicArn: adminTopicArn,\n      Subject: `Email Complaint Alert: ${complaint.complaintFeedbackType || 'Unknown'}`,\n      Message: JSON.stringify({\n        type: 'complaint',\n        feedbackType: complaint.complaintFeedbackType,\n        recipients: complainedRecipients.map(r => r.emailAddress),\n        originalSubject: mail.commonHeaders?.subject,\n        timestamp,\n      }, null, 2),\n    }));\n  }\n}\n\nasync function handleDelivery(message, bucket, timestamp) {\n  const delivery = message.delivery || {};\n  const mail = message.mail || {};\n\n  console.log(`Processing delivery confirmation for ${delivery.recipients?.join(', ')}`);\n\n  // Log delivery event\n  await logFeedbackEvent(bucket, 'deliveries', {\n    type: 'delivery',\n    recipients: delivery.recipients,\n    messageId: mail.messageId,\n    processingTimeMillis: delivery.processingTimeMillis,\n    smtpResponse: delivery.smtpResponse,\n    timestamp,\n  });\n}\n\nasync function addToSuppressionList(bucket, email, reason, details) {\n  const key = 'suppression/list.json';\n  let list = [];\n\n  try {\n    const result = await s3.send(new GetObjectCommand({\n      Bucket: bucket,\n      Key: key,\n    }));\n    list = JSON.parse(await result.Body.transformToString());\n  }\ncatch {\n    // List doesn't exist yet\n  }\n\n  // Check if already in list\n  const existing = list.find(item => item.email === email);\n  if (existing) {\n    existing.lastUpdated = details.timestamp;\n    existing.count = (existing.count || 1) + 1;\n  }\nelse {\n    list.push({\n      email,\n      reason,\n      addedAt: details.timestamp,\n      lastUpdated: details.timestamp,\n      count: 1,\n      details,\n    });\n  }\n\n  await s3.send(new PutObjectCommand({\n    Bucket: bucket,\n    Key: key,\n    Body: JSON.stringify(list, null, 2),\n    ContentType: 'application/json',\n  }));\n}\n\nasync function logFeedbackEvent(bucket, type, event) {\n  const date = new Date();\n  const year = date.getFullYear();\n  const month = String(date.getMonth() + 1).padStart(2, '0');\n  const day = String(date.getDate()).padStart(2, '0');\n\n  const key = `feedback/${type}/${year}/${month}/${day}/${Date.now()}-${Math.random().toString(36).substr(2)}.json`;\n\n  await s3.send(new PutObjectCommand({\n    Bucket: bucket,\n    Key: key,\n    Body: JSON.stringify(event, null, 2),\n    ContentType: 'application/json',\n  }));\n}\n";
+export default handler;

package/dist/email/handlers/inbound.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Inbound Email Lambda Handler
+ *
+ * Processes incoming emails from SES:
+ * - Parses raw MIME emails
+ * - Extracts metadata (from, to, subject, date, attachments)
+ * - Organizes by domain/account/sender structure
+ * - Supports + addressing (user+tag@domain.com)
+ * - Stores in S3 with proper structure
+ * - Triggers SNS notifications
+ */
+export declare const handler = "\nconst { S3Client, GetObjectCommand, PutObjectCommand, CopyObjectCommand } = require('@aws-sdk/client-s3');\nconst s3 = new S3Client({});\n\nexports.handler = async (event) => {\n  console.log('Inbound email event:', JSON.stringify(event, null, 2));\n\n  for (const record of event.Records) {\n    try {\n      // Handle SES notification via SNS\n      const sesNotification = JSON.parse(record.Sns?.Message || record.body || '{}');\n      const mail = sesNotification.mail || {};\n      const receipt = sesNotification.receipt || {};\n\n      const bucket = process.env.EMAIL_BUCKET;\n      const messageId = mail.messageId;\n\n      if (!messageId) {\n        console.log('No messageId found, skipping');\n        continue;\n      }\n\n      // Get the raw email from S3\n      const sourceKey = `incoming/${messageId}`;\n      let rawEmail;\n\n      try {\n        const getResult = await s3.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: sourceKey,\n        }));\n        rawEmail = await getResult.Body.transformToString();\n      }\ncatch (err) {\n        console.log('Could not retrieve raw email:', err.message);\n        continue;\n      }\n\n      // Parse email headers\n      const headers = {};\n      const headerSection = rawEmail.split('\\n\\n')[0];\n      let currentHeader = '';\n\n      for (const line of headerSection.split('\\n')) {\n        if (line.match(/^[A-Za-z-]+:/)) {\n          const colonIndex = line.indexOf(':');\n          currentHeader = line.substring(0, colonIndex).toLowerCase();\n          headers[currentHeader] = line.substring(colonIndex + 1).trim();\n        }\nelse if (currentHeader && (line.startsWith(' ') || line.startsWith('\\t'))) {\n          headers[currentHeader] += ' ' + line.trim();\n        }\n      }\n\n      // Extract key metadata\n      const from = headers['from'] || '';\n      const to = headers['to'] || '';\n      const subject = headers['subject'] || '(no subject)';\n      const date = headers['date'] || new Date().toISOString();\n\n      // Parse sender email\n      const fromMatch = from.match(/<([^>]+)>/) || [null, from];\n      const fromEmail = fromMatch[1] || from;\n      const fromDomain = fromEmail.split('@')[1] || 'unknown';\n\n      // Parse recipient email (handle + addressing)\n      const toMatch = to.match(/<([^>]+)>/) || [null, to];\n      const toEmail = toMatch[1] || to;\n      const [localPart, toDomain] = toEmail.split('@');\n      const baseLocalPart = localPart.split('+')[0]; // Handle user+tag@domain.com\n      const tag = localPart.includes('+') ? localPart.split('+')[1] : null;\n\n      // Create timestamp-based path\n      const timestamp = new Date(date);\n      const year = timestamp.getFullYear();\n      const month = String(timestamp.getMonth() + 1).padStart(2, '0');\n      const day = String(timestamp.getDate()).padStart(2, '0');\n\n      // Organize by: domain/mailbox/year/month/day/sender/messageId\n      const destPath = `mailboxes/${toDomain}/${baseLocalPart}/${year}/${month}/${day}/${fromDomain}/${messageId}`;\n\n      // Copy raw email to organized location\n      await s3.send(CopyObjectCommand({\n        Bucket: bucket,\n        CopySource: `${bucket}/${sourceKey}`,\n        Key: `${destPath}/raw.eml`,\n      }));\n\n      // Create metadata JSON\n      const metadata = {\n        messageId,\n        from: fromEmail,\n        fromName: from.replace(/<[^>]+>/, '').trim(),\n        to: toEmail,\n        toName: to.replace(/<[^>]+>/, '').trim(),\n        subject,\n        date: timestamp.toISOString(),\n        receivedAt: new Date().toISOString(),\n        tag,\n        spamVerdict: receipt.spamVerdict?.status || 'UNKNOWN',\n        virusVerdict: receipt.virusVerdict?.status || 'UNKNOWN',\n        spfVerdict: receipt.spfVerdict?.status || 'UNKNOWN',\n        dkimVerdict: receipt.dkimVerdict?.status || 'UNKNOWN',\n        dmarcVerdict: receipt.dmarcVerdict?.status || 'UNKNOWN',\n        hasAttachments: rawEmail.includes('Content-Disposition: attachment'),\n      };\n\n      await s3.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: `${destPath}/metadata.json`,\n        Body: JSON.stringify(metadata, null, 2),\n        ContentType: 'application/json',\n      }));\n\n      // Update inbox index\n      const indexKey = `mailboxes/${toDomain}/${baseLocalPart}/inbox.json`;\n      let inbox = [];\n\n      try {\n        const indexResult = await s3.send(new GetObjectCommand({\n          Bucket: bucket,\n          Key: indexKey,\n        }));\n        inbox = JSON.parse(await indexResult.Body.transformToString());\n      }\ncatch {\n        // Index doesn't exist yet\n      }\n\n      inbox.unshift({\n        messageId,\n        from: fromEmail,\n        subject,\n        date: timestamp.toISOString(),\n        read: false,\n        path: destPath,\n      });\n\n      // Keep only last 1000 emails in index\n      inbox = inbox.slice(0, 1000);\n\n      await s3.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: indexKey,\n        Body: JSON.stringify(inbox, null, 2),\n        ContentType: 'application/json',\n      }));\n\n      console.log(`Processed email: ${messageId} from ${fromEmail} to ${toEmail}`);\n\n    }\ncatch (error) {\n      console.error('Error processing email:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n";
+export default handler;

package/dist/email/handlers/outbound.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Outbound Email Lambda Handler
+ *
+ * Processes outgoing emails:
+ * - Accepts JSON email payloads from S3
+ * - Generates proper MIME messages
+ * - Supports HTML and plain text
+ * - Handles attachments (base64 encoded)
+ * - Tracks via configuration set
+ * - Stores sent emails in S3
+ */
+export declare const handler = "\nconst { S3Client, GetObjectCommand, PutObjectCommand, DeleteObjectCommand } = require('@aws-sdk/client-s3');\nconst { SESClient, SendRawEmailCommand } = require('@aws-sdk/client-ses');\n\nconst s3 = new S3Client({});\nconst ses = new SESClient({});\n\nexports.handler = async (event) => {\n  console.log('Outbound email event:', JSON.stringify(event, null, 2));\n\n  const bucket = process.env.EMAIL_BUCKET;\n  const configSet = process.env.CONFIG_SET || 'default';\n\n  for (const record of event.Records) {\n    try {\n      // Get the email payload from S3\n      const s3Event = record.s3 || {};\n      const key = decodeURIComponent(s3Event.object?.key?.replace(/\\+/g, ' ') || '');\n\n      if (!key || !key.startsWith('outbox/')) {\n        continue;\n      }\n\n      const getResult = await s3.send(new GetObjectCommand({\n        Bucket: bucket,\n        Key: key,\n      }));\n\n      const emailData = JSON.parse(await getResult.Body.transformToString());\n\n      // Build MIME message\n      const boundary = `----=_Part_${Date.now()}_${Math.random().toString(36).substr(2)}`;\n      const mixedBoundary = `----=_Mixed_${Date.now()}_${Math.random().toString(36).substr(2)}`;\n\n      let rawMessage = '';\n\n      // Headers\n      rawMessage += `From: ${emailData.from}\\r\\n`;\n      rawMessage += `To: ${Array.isArray(emailData.to) ? emailData.to.join(', ') : emailData.to}\\r\\n`;\n\n      if (emailData.cc) {\n        rawMessage += `Cc: ${Array.isArray(emailData.cc) ? emailData.cc.join(', ') : emailData.cc}\\r\\n`;\n      }\n\n      if (emailData.replyTo) {\n        rawMessage += `Reply-To: ${emailData.replyTo}\\r\\n`;\n      }\n\n      rawMessage += `Subject: =?UTF-8?B?${Buffer.from(emailData.subject || '').toString('base64')}?=\\r\\n`;\n      rawMessage += `Date: ${new Date().toUTCString()}\\r\\n`;\n      rawMessage += `Message-ID: <${Date.now()}.${Math.random().toString(36)}@${emailData.from.split('@')[1] || 'local'}>\\r\\n`;\n      rawMessage += 'MIME-Version: 1.0\\r\\n';\n\n      const hasAttachments = emailData.attachments && emailData.attachments.length > 0;\n\n      if (hasAttachments) {\n        rawMessage += `Content-Type: multipart/mixed; boundary=\"${mixedBoundary}\"\\r\\n\\r\\n`;\n        rawMessage += `--${mixedBoundary}\\r\\n`;\n      }\n\n      // Body (multipart alternative for HTML + text)\n      if (emailData.html && emailData.text) {\n        rawMessage += `Content-Type: multipart/alternative; boundary=\"${boundary}\"\\r\\n\\r\\n`;\n\n        // Plain text part\n        rawMessage += `--${boundary}\\r\\n`;\n        rawMessage += 'Content-Type: text/plain; charset=UTF-8\\r\\n';\n        rawMessage += 'Content-Transfer-Encoding: quoted-printable\\r\\n\\r\\n';\n        rawMessage += emailData.text + '\\r\\n\\r\\n';\n\n        // HTML part\n        rawMessage += `--${boundary}\\r\\n`;\n        rawMessage += 'Content-Type: text/html; charset=UTF-8\\r\\n';\n        rawMessage += 'Content-Transfer-Encoding: quoted-printable\\r\\n\\r\\n';\n        rawMessage += emailData.html + '\\r\\n\\r\\n';\n\n        rawMessage += `--${boundary}--\\r\\n`;\n      }\nelse if (emailData.html) {\n        if (!hasAttachments) {\n          rawMessage += 'Content-Type: text/html; charset=UTF-8\\r\\n';\n          rawMessage += 'Content-Transfer-Encoding: quoted-printable\\r\\n\\r\\n';\n        }\nelse {\n          rawMessage += 'Content-Type: text/html; charset=UTF-8\\r\\n\\r\\n';\n        }\n        rawMessage += emailData.html + '\\r\\n';\n      }\nelse {\n        if (!hasAttachments) {\n          rawMessage += 'Content-Type: text/plain; charset=UTF-8\\r\\n';\n          rawMessage += 'Content-Transfer-Encoding: quoted-printable\\r\\n\\r\\n';\n        }\nelse {\n          rawMessage += 'Content-Type: text/plain; charset=UTF-8\\r\\n\\r\\n';\n        }\n        rawMessage += (emailData.text || emailData.body || '') + '\\r\\n';\n      }\n\n      // Attachments\n      if (hasAttachments) {\n        for (const attachment of emailData.attachments) {\n          rawMessage += `--${mixedBoundary}\\r\\n`;\n          rawMessage += `Content-Type: ${attachment.contentType || 'application/octet-stream'}; name=\"${attachment.filename}\"\\r\\n`;\n          rawMessage += 'Content-Transfer-Encoding: base64\\r\\n';\n          rawMessage += `Content-Disposition: attachment; filename=\"${attachment.filename}\"\\r\\n\\r\\n`;\n          rawMessage += attachment.content + '\\r\\n';\n        }\n        rawMessage += `--${mixedBoundary}--\\r\\n`;\n      }\n\n      // Send via SES\n      const sendResult = await ses.send(new SendRawEmailCommand({\n        RawMessage: { Data: Buffer.from(rawMessage) },\n        ConfigurationSetName: configSet,\n      }));\n\n      console.log(`Email sent: ${sendResult.MessageId}`);\n\n      // Store in sent folder\n      const timestamp = new Date();\n      const year = timestamp.getFullYear();\n      const month = String(timestamp.getMonth() + 1).padStart(2, '0');\n      const day = String(timestamp.getDate()).padStart(2, '0');\n\n      const fromEmail = emailData.from.match(/<([^>]+)>/) ? emailData.from.match(/<([^>]+)>/)[1] : emailData.from;\n      const [localPart, domain] = fromEmail.split('@');\n\n      const sentPath = `mailboxes/${domain}/${localPart}/sent/${year}/${month}/${day}/${sendResult.MessageId}`;\n\n      // Save sent email metadata\n      await s3.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: `${sentPath}/metadata.json`,\n        Body: JSON.stringify({\n          messageId: sendResult.MessageId,\n          from: emailData.from,\n          to: emailData.to,\n          cc: emailData.cc,\n          subject: emailData.subject,\n          sentAt: timestamp.toISOString(),\n          hasAttachments,\n        }, null, 2),\n        ContentType: 'application/json',\n      }));\n\n      // Save raw message\n      await s3.send(new PutObjectCommand({\n        Bucket: bucket,\n        Key: `${sentPath}/raw.eml`,\n        Body: rawMessage,\n        ContentType: 'message/rfc822',\n      }));\n\n      // Delete from outbox\n      await s3.send(new DeleteObjectCommand({\n        Bucket: bucket,\n        Key: key,\n      }));\n\n    }\ncatch (error) {\n      console.error('Error sending email:', error);\n    }\n  }\n\n  return { statusCode: 200, body: 'OK' };\n};\n";
+export default handler;

package/dist/email/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Email Advanced Features
+ * Bounce handling, analytics, reputation monitoring, and template management
+ */
+export * from './bounce-handling';
+export * from './analytics';
+export * from './reputation';
+export * from './templates';
+export * as EmailAdvanced from './advanced';
+export * as EmailHandlers from './handlers/inbound';

package/dist/email/reputation.d.ts

@@ -0,0 +1,133 @@
+/**
+ * SES Sender Reputation Monitoring
+ * Reputation tracking, sending limits, and deliverability monitoring
+ */
+export interface ReputationDashboard {
+    id: string;
+    timestamp: Date;
+    overallScore: number;
+    bounceRate: number;
+    complaintRate: number;
+    spamReports: number;
+    blacklistStatus: BlacklistStatus[];
+    dkimStatus: 'VERIFIED' | 'PENDING' | 'FAILED';
+    spfStatus: 'PASS' | 'FAIL' | 'SOFTFAIL';
+    dmarcStatus: 'PASS' | 'FAIL' | 'NONE';
+    sendingLimits: SendingLimits;
+    recommendations: string[];
+}
+export interface BlacklistStatus {
+    listName: string;
+    listed: boolean;
+    listedAt?: Date;
+    delistUrl?: string;
+}
+export interface SendingLimits {
+    maxSendRate: number;
+    max24HourSend: number;
+    sentLast24Hours: number;
+    remainingQuota: number;
+    quotaResetTime: Date;
+}
+export interface WarmupPlan {
+    id: string;
+    name: string;
+    startDate: Date;
+    currentDay: number;
+    totalDays: number;
+    dailyLimits: number[];
+    currentLimit: number;
+    status: 'active' | 'paused' | 'completed';
+}
+export interface DomainReputation {
+    id: string;
+    domain: string;
+    reputationScore: number;
+    totalSent: number;
+    deliveryRate: number;
+    openRate: number;
+    clickRate: number;
+    bounceRate: number;
+    complaintRate: number;
+    engagementScore: number;
+}
+/**
+ * Sender reputation manager
+ */
+export declare class SenderReputationManager {
+    private dashboards;
+    private warmupPlans;
+    private domainReputations;
+    private dashboardCounter;
+    private warmupCounter;
+    private domainCounter;
+    /**
+     * Get reputation dashboard
+     */
+    getReputationDashboard(): ReputationDashboard;
+    /**
+     * Check blacklists
+     */
+    private checkBlacklists;
+    /**
+     * Create warmup plan
+     */
+    createWarmupPlan(options: {
+        name: string;
+        initialDailyLimit: number;
+        targetDailyLimit: number;
+        durationDays: number;
+    }): WarmupPlan;
+    /**
+     * Create aggressive warmup plan
+     */
+    createAggressiveWarmupPlan(options: {
+        name: string;
+    }): WarmupPlan;
+    /**
+     * Create conservative warmup plan
+     */
+    createConservativeWarmupPlan(options: {
+        name: string;
+    }): WarmupPlan;
+    /**
+     * Advance warmup plan
+     */
+    advanceWarmupPlan(warmupId: string): WarmupPlan;
+    /**
+     * Track domain reputation
+     */
+    trackDomainReputation(options: {
+        domain: string;
+        totalSent: number;
+        delivered: number;
+        opened: number;
+        clicked: number;
+        bounced: number;
+        complained: number;
+    }): DomainReputation;
+    /**
+     * Get domain reputation
+     */
+    getDomainReputation(domain: string): DomainReputation | undefined;
+    /**
+     * List all domain reputations
+     */
+    listDomainReputations(): DomainReputation[];
+    /**
+     * Get warmup plan
+     */
+    getWarmupPlan(id: string): WarmupPlan | undefined;
+    /**
+     * List warmup plans
+     */
+    listWarmupPlans(): WarmupPlan[];
+    /**
+     * Clear all data
+     */
+    clear(): void;
+}
+/**
+ * Global sender reputation manager instance
+ */
+export declare const senderReputationManager: SenderReputationManager;