Node.js SDK email client

const pbMail  = require('paubox-node');

// Read the API key from environment variables
const service = pbMail.emailService();

// Or pass the API key directly
const service = pbMail.emailService({ apiKey: 'YOUR_API_KEY' });

const message = pbMail.message({
  from:         'sender@yourdomain.com',  // required
  to:           ['alice@example.com'],    // required; array of recipients
  subject:      'Your results are ready', // optional
  reply_to:     'support@yourdomain.com', // optional
  cc:           ['manager@example.com'],  // optional
  bcc:          ['audit@example.com'],    // optional
  text_content: 'Plain text body.',       // at least one of text/html required
  html_content: '<p>HTML body.</p>',      // optional; auto base64-encoded
  allowNonTLS:  false,                    // optional; default false
  forceSecureNotification: false,         // optional; default false
  custom_headers: { 'X-Custom': 'value' },// optional; keys must start with X-
  list_unsubscribe:      '<mailto:unsub@yourdomain.com>', // optional
  list_unsubscribe_post: 'List-Unsubscribe=One-Click',   // optional
  attachments: [attachment]               // optional; see below
});

const fs = require('fs');

const attachment = {
  fileName:    'report.pdf',
  contentType: 'application/pdf',
  content:     fs.readFileSync('report.pdf').toString('base64')
};

const response = await service.sendMessage(message);
console.log('Tracking ID:', response.sourceTrackingId);

const messages = [
  pbMail.message({ from: 'f@yourdomain.com', to: ['alice@example.com'], subject: 'Hi Alice', text_content: 'Hello Alice' }),
  pbMail.message({ from: 'f@yourdomain.com', to: ['bob@example.com'],   subject: 'Hi Bob',   text_content: 'Hello Bob' }),
];

const response = await service.sendBulkMessages(messages);

for (const msg of response.messages) {
  console.log('Tracking ID:', msg.sourceTrackingId);
}

const disposition = await service.getEmailDisposition(sourceTrackingId);

for (const delivery of disposition.data.message.message_deliveries) {
  console.log(`${delivery.recipient} → ${delivery.status.deliveryStatus}`);
}

const fs = require('fs');

const response = await service.createDynamicTemplate(
  'appointment-confirmation',
  fs.createReadStream('templates/appointment.html')
);

const templates = await service.listDynamicTemplates();
for (const t of templates) {
  console.log(t.id, t.name);
}

const template = await service.getDynamicTemplate(templateId);

await service.updateDynamicTemplate(
  templateId,
  'appointment-confirmation-v2', // new name, or null to keep current
  null                            // content unchanged
);

await service.deleteDynamicTemplate(templateId);

const message = pbMail.templatedMessage({
  from:            'appointments@yourclinic.com',
  to:              ['jane@example.com'],
  subject:         'Your appointment is confirmed',
  template_name:   'appointment-confirmation',
  template_values: {
    first_name: 'Jane',
    date:       '2024-03-15',
    time:       '2:00 PM'
  }
});

const response = await service.sendTemplatedMessage(message);

const response = await service.scheduleMessage(message, '2025-12-25T15:00:00Z');
console.log('Tracking ID:', response.sourceTrackingId);
console.log('Scheduled for:', response.scheduledAt);

const status = await service.getScheduledMessage(sourceTrackingId);
console.log('State:', status.state);        // "pending", "sent", "cancelled"
console.log('Scheduled for:', status.scheduledAt);

const response = await service.rescheduleMessage(sourceTrackingId, '2025-12-26T10:00:00Z');
console.log('New time:', response.scheduledAt);

const response = await service.cancelScheduledMessage(sourceTrackingId);
console.log('State:', response.state);      // "cancelled"

try {
  const response = await service.sendMessage(message);
  console.log('Sent:', response.sourceTrackingId);
} catch (err) {
  console.error('Send failed:', err.message);
}