@wraps.dev/email SDK

const email = new WrapsEmail({  region: 'us-west-2',  credentials: {    accessKeyId: process.env.AWS_ACCESS_KEY_ID,    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,    sessionToken: process.env.AWS_SESSION_TOKEN, // optional  },});

// Testing with LocalStackconst email = new WrapsEmail({  region: 'us-east-1',  endpoint: 'http://localhost:4566',});

type WrapsEmailConfig = {  client?: SESClient;           // Pre-configured SES client (takes precedence)  s3Client?: S3Client;          // Pre-configured S3 client for inbox  inboxBucketName?: string;     // S3 bucket for inbound email storage  region?: string;              // AWS region (default: 'us-east-1')  credentials?: {               // Explicit AWS credentials (static or provider)    accessKeyId: string;    secretAccessKey: string;    sessionToken?: string;  } | AwsCredentialIdentityProvider;  roleArn?: string;             // IAM role for OIDC assumption  roleSessionName?: string;     // Session name for AssumeRole  endpoint?: string;            // Custom endpoint (e.g., LocalStack)  historyTableName?: string;    // DynamoDB table for email event history  dynamodbClient?: DynamoDBDocumentClient; // Pre-configured DynamoDB client  sesv2Client?: SESv2Client;    // Pre-configured SES v2 client for suppression};

const result = await email.send({  from: 'hello@yourdomain.com',  to: 'user@example.com',  subject: 'Welcome to our app',  html: '<h1>Welcome!</h1><p>Thanks for signing up.</p>',  text: 'Welcome! Thanks for signing up.',});console.log('Message ID:', result.messageId);console.log('Request ID:', result.requestId);

const result = await email.send({  from: 'newsletter@yourdomain.com',  to: ['user1@example.com', 'user2@example.com'],  cc: 'manager@yourdomain.com',  bcc: ['archive@yourdomain.com'],  replyTo: 'support@yourdomain.com',  subject: 'Weekly Newsletter',  html: '<h1>This week\'s updates</h1>',});

// Add SES tags for tracking and analyticsawait email.send({  from: 'you@yourdomain.com',  to: 'user@example.com',  subject: 'Newsletter',  html: '<p>Content</p>',  tags: {    campaign: 'newsletter-2025-01',    type: 'marketing',  },  configurationSetName: 'wraps-email-tracking', // optional});

// Create a template with variablesawait email.templates.create({  name: 'welcome-email',  subject: 'Welcome to {{companyName}}, {{name}}!',  html: `    <h1>Welcome {{name}}!</h1>    <p>Click to confirm: <a href="{{confirmUrl}}">Confirm Account</a></p>  `,  text: 'Welcome {{name}}! Click to confirm: {{confirmUrl}}',});

import { WelcomeEmailTemplate } from './emails/Welcome';// Create template from React.email componentawait email.templates.createFromReact({  name: 'welcome-email-v2',  subject: 'Welcome to {{companyName}}, {{name}}!',  react: <WelcomeEmailTemplate />,  // React component should use {{variable}} syntax});

// Get template detailsconst template = await email.templates.get('welcome-email');console.log(template.name, template.subject);// List all templatesconst templates = await email.templates.list();templates.forEach(t => console.log(t.name, t.createdTimestamp));// Update a templateawait email.templates.update({  name: 'welcome-email',  subject: 'Welcome aboard, {{name}}!',  html: '<h1>Welcome {{name}}!</h1>...',});// Delete a templateawait email.templates.delete('welcome-email');

const email = new WrapsEmail({  inboxBucketName: 'your-inbound-bucket-name',});

const { emails, nextToken } = await email.inbox.list({  maxResults: 20,  continuationToken: undefined, // for pagination});for (const summary of emails) {  console.log(summary.emailId, summary.key, summary.lastModified);}

const inboundEmail = await email.inbox.get('email-abc123');console.log('From:', inboundEmail.from.address);console.log('Subject:', inboundEmail.subject);console.log('HTML:', inboundEmail.html);console.log('Attachments:', inboundEmail.attachments.length);console.log('Spam:', inboundEmail.spamVerdict);console.log('Virus:', inboundEmail.virusVerdict);

// Reply with proper threading headers (In-Reply-To, References)const result = await email.inbox.reply('email-abc123', {  from: 'support@yourdomain.com',  text: 'Thanks for reaching out!',  html: '<p>Thanks for reaching out!</p>',  attachments: [], // optional});console.log('Reply sent:', result.messageId);

// Passthrough mode (default): rewrites headers, keeps original bodyconst result = await email.inbox.forward('email-abc123', {  from: 'noreply@yourdomain.com',  to: 'team@yourdomain.com',  addPrefix: '[Customer]', // optional subject prefix});// Wrapped mode: builds new message with forwarded contentconst result2 = await email.inbox.forward('email-abc123', {  from: 'noreply@yourdomain.com',  to: 'team@yourdomain.com',  passthrough: false,  text: 'FYI - see below', // optional intro text});

// Get presigned URL for an attachment (valid for 1 hour by default)const url = await email.inbox.getAttachment('email-abc123', 'attachment-id', {  expiresIn: 3600, // seconds});

// Get a presigned URL for the raw MIME email (valid for 1 hour)const rawUrl = await email.inbox.getRaw('email-abc123');// Download the raw emailconst response = await fetch(rawUrl);const rawMime = await response.text();console.log('Raw MIME:', rawMime.substring(0, 200));

// Delete email and all associated files (parsed JSON, raw MIME, attachments)await email.inbox.delete('email-abc123');

const email = new WrapsEmail({  historyTableName: 'wraps-email-history',});

// Get full status and event timeline for an emailconst status = await email.events.get('message-id-from-send');if (status) {  console.log('Status:', status.status);     // 'delivered', 'opened', 'bounced', etc.  console.log('From:', status.from);  console.log('To:', status.to);  console.log('Subject:', status.subject);  console.log('Sent at:', new Date(status.sentAt));  console.log('Last event:', new Date(status.lastEventAt));  // Full event timeline  for (const event of status.events) {    console.log(`  ${event.type} at ${new Date(event.timestamp)}`);    if (event.metadata) console.log('    metadata:', event.metadata);  }}

// List recent emails with status (paginated)const { emails, nextToken } = await email.events.list({  accountId: '123456789012',  startTime: new Date('2025-01-01'),  maxResults: 20,});for (const item of emails) {  console.log(`${item.messageId}: ${item.status} - ${item.subject}`);}// Fetch next pageif (nextToken) {  const nextPage = await email.events.list({    accountId: '123456789012',    continuationToken: nextToken,  });}

// Check if an email is suppressedconst entry = await email.suppression.get('user@example.com');if (entry) {  console.log('Suppressed:', entry.email);  console.log('Reason:', entry.reason);       // 'BOUNCE' or 'COMPLAINT'  console.log('Since:', entry.lastUpdated);  console.log('Message ID:', entry.messageId); // original bounce/complaint message} else {  console.log('Email is not suppressed');}

// Manually add an email to the suppression listawait email.suppression.add('bad-address@example.com', 'BOUNCE');// Also works for complaintsawait email.suppression.add('unsubscribed@example.com', 'COMPLAINT');

// Remove from suppression list (idempotent — won't throw if not found)await email.suppression.remove('user@example.com');

// List all suppressed emails (paginated)const { entries, nextToken } = await email.suppression.list({  reason: 'BOUNCE',                    // optional: filter by reason  startDate: new Date('2025-01-01'),   // optional  maxResults: 100,                     // default: 100, max: 1000});for (const entry of entries) {  console.log(`${entry.email}: ${entry.reason} (since ${entry.lastUpdated})`);}// Paginateif (nextToken) {  const nextPage = await email.suppression.list({    continuationToken: nextToken,  });}