Emails

const email = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome to our platform!',
  html: `
    <h1>Welcome, {{name}}!</h1>
    <p>Thanks for signing up.</p>
  `,
  templateData: {
    name: 'John',
  },
  tags: ['welcome', 'onboarding'],
});

const result = await client.emails.sendBatch([
  {
    from: 'hello@yourdomain.com',
    to: 'user1@example.com',
    subject: 'Hello User 1',
    html: '<p>Welcome!</p>',
  },
  {
    from: 'hello@yourdomain.com',
    to: 'user2@example.com',
    subject: 'Hello User 2',
    html: '<p>Welcome!</p>',
  },
]);

console.log(result.successful); // 2
console.log(result.failed);     // 0
console.log(result.results);
// [
//   { index: 0, id: 'email_xxx', status: 'sent' },
//   { index: 1, id: 'email_yyy', status: 'sent' },
// ]

const email = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  templateId: 'template_xxxxx',
  templateData: {
    firstName: 'John',
    orderNumber: '12345',
    items: [
      { name: 'Widget', price: 29.99 },
      { name: 'Gadget', price: 49.99 },
    ],
  },
});

const email = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Your weekly digest',
  html: '<h1>Weekly Digest</h1>',
  scheduledFor: '2024-12-25T09:00:00Z',
});

// Cancel a scheduled email
await client.emails.cancel(email.id);

// Reschedule to a different time
await client.emails.update(email.id, {
  scheduledFor: '2025-01-01T09:00:00Z',
});

// List all emails
const { data, hasMore, nextCursor } = await client.emails.list();

// Filter by status
const delivered = await client.emails.list({
  status: 'delivered',
  limit: 50,
});

// Paginate through results
let cursor;
do {
  const page = await client.emails.list({ cursor, limit: 100 });
  console.log(page.data);
  cursor = page.nextCursor;
} while (cursor);

const email = await client.emails.get('email_xxxxx');

console.log(email.status);     // 'delivered'
console.log(email.sentAt);     // '2024-01-01T12:00:00Z'
console.log(email.piiDetected); // false

// Marketing email with automatic compliance
const email = await client.emails.send({
  from: 'news@yourdomain.com',
  to: 'subscriber@example.com',
  subject: 'Monthly Newsletter',
  html: '<h1>December Updates</h1>',
  type: 'marketing',
});

// Custom unsubscribe URL (for transactional emails with opt-in compliance)
const email2 = await client.emails.send({
  from: 'updates@yourdomain.com',
  to: 'user@example.com',
  subject: 'Product Update',
  html: '<h1>New Features</h1>',
  unsubscribeUrl: 'https://yourdomain.com/unsubscribe?token=abc',
});

try {
  await client.emails.send({
    from: 'hello@yourdomain.com',
    to: 'bounced-user@example.com',
    subject: 'Hello!',
    html: '<h1>Hi there</h1>',
  });
} catch (error) {
  // error.code === 'recipient_suppressed'
  // error.details.suppressedRecipients === [
  //   { email: 'bounced-user@example.com', reason: 'hard_bounce' }
  // ]
}

import { readFileSync } from 'fs';

const pdf = readFileSync('invoice.pdf');

const email = await client.emails.send({
  from: 'billing@yourdomain.com',
  to: 'customer@example.com',
  subject: 'Your Invoice',
  html: '<p>Please find your invoice attached.</p>',
  attachments: [
    {
      filename: 'invoice.pdf',
      content: pdf.toString('base64'),
      contentType: 'application/pdf',
    },
  ],
});

// Inline image attachment
const email2 = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Check this out',
  html: '<p>Here is the image: <img src="cid:logo" /></p>',
  attachments: [
    {
      filename: 'logo.png',
      content: logoBase64,
      contentType: 'image/png',
      contentId: 'logo',
    },
  ],
});

// Test a successful delivery
const email = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'delivered@test.veilmail.xyz',
  subject: 'Test delivery',
  html: '<p>Testing!</p>',
});

console.log(email.status); // 'delivered'

// Test a bounce
const bounced = await client.emails.send({
  from: 'hello@yourdomain.com',
  to: 'bounced@test.veilmail.xyz',
  subject: 'Test bounce',
  html: '<p>This will bounce</p>',
});

// Check events
const detail = await client.emails.get(bounced.id);
console.log(detail.events);
// [{ type: 'sent', ... }, { type: 'bounced', ... }]

import { PiiDetectedError } from '@resonia/veilmail-sdk';

try {
  await client.emails.send({
    from: 'hello@yourdomain.com',
    to: 'user@example.com',
    subject: 'Your order',
    html: 'Your SSN is 123-45-6789', // Contains PII!
  });
} catch (error) {
  if (error instanceof PiiDetectedError) {
    console.log('PII detected:', error.piiTypes);
    // ['US_SOCIAL_SECURITY_NUMBER']
  }
}