Senviok SDK

import { Senviok } from 'senviok';

// Initialize with your API key
const senviok = new Senviok('svk_live_your_api_key');

// Or with a custom base URL
const senviok = new Senviok('svk_live_your_api_key', {
  BASE: 'https://your-custom-api.example.com'
});

await senviok.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome to Acme!',
  html: '<h1>Hello!</h1><p>Welcome aboard.</p>',
  text: 'Hello! Welcome aboard.'
});

await senviok.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome {{name}}!',
  templateId: 'tmpl_welcome',
  templateData: { name: 'John', company: 'Acme' }
});

await senviok.emails.send({
  from: 'hello@yourdomain.com',
  fromName: 'Acme Support',
  to: 'user@example.com',
  subject: 'Your Invoice',
  html: '<p>Please find your invoice attached.</p>',
  cc: 'manager@acme.com',
  bcc: 'records@acme.com',
  replyTo: 'support@acme.com',
  addUnsubscribeFooter: true,
  addListUnsubscribeHeader: true
});

await senviok.sms.send({
  from: 'Acme',
  to: '+2348012345678',
  text: 'Your verification code is 4829. Valid for 10 minutes.'
});

await senviok.whatsapp.send({
  from: '+14155238886',
  to: '+2348012345678',
  text: 'Your order #1234 has been shipped! Track at https://acme.com/track/1234'
});

// Create a template
const template = await senviok.templates.create({
  name: 'Welcome Email',
  subject: 'Welcome {{name}}!',
  htmlContent: '<h1>Hello {{name}}</h1><p>Welcome to {{company}}.</p>'
});

// List all templates
const templates = await senviok.templates.list();

// Get a single template
const tmpl = await senviok.templates.get('tmpl_abc123');

// Update a template
await senviok.templates.update('tmpl_abc123', {
  name: 'Updated Welcome',
  subject: 'Hey {{name}}!',
  htmlContent: '<h1>Hey {{name}}</h1><p>Great to have you.</p>'
});

// Delete a template
await senviok.templates.delete('tmpl_abc123');

await senviok.emails.send({
  from: 'hello@yourdomain.com',
  to: 'user@example.com',
  subject: 'Welcome {{name}}!',
  templateId: template.id,
  templateData: {
    name: 'Sarah',
    company: 'Acme Inc'
  }
});

// Add a domain
const domain = await senviok.domains.create({ name: 'yourdomain.com' });

// List all domains
const domains = await senviok.domains.list();

// Get DKIM DNS records (add these to your DNS provider)
const dkim = await senviok.domains.getDkim('dom_abc123');
// Returns: { tokens: [...] } — add these as CNAME records

// Verify domain after adding DNS records
const result = await senviok.domains.verify('dom_abc123');
// Returns: { verified: true }

// Create an audience
const audience = await senviok.audiences.create({
  name: 'Newsletter Subscribers'
});

// List all audiences
const audiences = await senviok.audiences.list();

// Delete an audience
await senviok.audiences.delete('aud_abc123');

// Add a contact to an audience
const contact = await senviok.contacts.create('aud_abc123', {
  email: 'john@example.com',
  firstName: 'John',
  lastName: 'Doe',
  unsubscribed: false
});

// List contacts in an audience
const contacts = await senviok.contacts.list('aud_abc123');

// Remove a contact from an audience
await senviok.contacts.delete('aud_abc123', 'ct_xyz789');

// Add an address to the suppression list
await senviok.suppressions.create({
  email: 'bounced@example.com',
  reason: 'hard_bounce'
});

// List all suppressed addresses
const suppressions = await senviok.suppressions.list();

// Remove from suppression list (re-enable sending)
await senviok.suppressions.delete('sup_abc123');

// Get recent messages
const logs = await senviok.messages.list({
  take: 50,
  sortOrder: 'desc'
});

// Filter by channel and status
const emailLogs = await senviok.messages.list({
  channel: 'email',
  status: 'sent',
  take: 100
});

// Filter by date range and recipient
const filtered = await senviok.messages.list({
  startDate: '2024-01-01',
  endDate: '2024-01-31',
  toAddress: 'user@example.com'
});

// Filter by sender and subject
const specific = await senviok.messages.list({
  fromAddress: 'hello@yourdomain.com',
  subject: 'Welcome',
  skip: 0,
  take: 20
});

// Create a webhook
const webhook = await senviok.webhooks.create({
  url: 'https://your-app.com/webhooks/senviok',
  events: ['message.sent', 'message.failed', 'message.delivered', 'message.bounced']
});
console.log(webhook.secret); // Save this for signature verification

// List all webhooks
const webhooks = await senviok.webhooks.list();

// Get delivery logs for a webhook
const deliveries = await senviok.webhooks.logs('wh_abc123');

// Delete a webhook
await senviok.webhooks.delete('wh_abc123');

import { Senviok, ApiError } from 'senviok';

try {
  await senviok.emails.send({
    from: 'hello@yourdomain.com',
    to: 'user@example.com',
    subject: 'Hello!',
    html: '<p>Hi there</p>'
  });
} catch (error) {
  if (error instanceof ApiError) {
    console.error('Status:', error.status);   // 400, 401, 403, 429, 500
    console.error('Message:', error.message); // Human-readable error
    console.error('Body:', error.body);       // Full error response
  }
}