npm install @devotel/sdk

pnpm add @devotel/sdk
yarn add @devotel/sdk

import { Devotel } from '@devotel/sdk';

const orbit = new Devotel({
  apiKey: 'dv_live_sk_your_key_here',
});

// Send an SMS
const message = await orbit.messages.send({
  channel: 'sms',
  to: '+14155552671',
  body: 'Hello from Orbit!',
});

console.log(message.data.message_id); // msg_abc123

// Send WhatsApp template
const waMessage = await orbit.messages.send({
  channel: 'whatsapp',
  to: '+14155552671',
  type: 'template',
  template: {
    name: 'order_confirmation',
    language: 'en',
    components: [
      { type: 'body', parameters: [{ type: 'text', text: 'ORD-12345' }] },
    ],
  },
});

// Send Email
const email = await orbit.messages.send({
  channel: 'email',
  to: 'user@example.com',
  from: 'hello@yourdomain.com',
  subject: 'Welcome!',
  html: '<h1>Welcome to Acme</h1>',
});

// Make an outbound call
const call = await orbit.voice.calls.create({
  to: '+14155552671',
  from: '+18005551234',
  webhookUrl: 'https://yourapp.com/webhooks/voice',
});

// Connect to an AI agent
const agentCall = await orbit.voice.calls.create({
  to: '+14155552671',
  from: '+18005551234',
  agentId: 'agent_support_bot',
});

// Retrieve call details
const callDetails = await orbit.voice.calls.get(call.data.id);

// Send OTP
const verification = await orbit.verify.send('+14155552671', 'sms');

// Check OTP
const result = await orbit.verify.check('+14155552671', '482901');

console.log(result.data.status); // 'approved'

// Verify webhook signature in an Express handler
import { verifyWebhookSignature } from '@devotel/sdk';

app.post('/webhooks/orbit', (req, res) => {
  const isValid = verifyWebhookSignature(
    req.rawBody,
    req.headers['x-devotel-signature'],
    'whsec_your_secret',
  );

  if (!isValid) return res.status(401).send('Invalid signature');

  const event = req.body;
  switch (event.type) {
    case 'message.delivered':
      // Handle delivery confirmation
      break;
    case 'call.completed':
      // Handle call completion
      break;
  }

  res.status(200).json({ received: true });
});

import { Devotel, OrbitApiError } from '@devotel/sdk'

try {
  await orbit.messages.send({ channel: 'sms', to: 'invalid', body: 'Hi' });
} catch (error) {
  if (error instanceof OrbitApiError) {
    console.error(error.code);       // 'INVALID_PHONE_NUMBER'
    console.error(error.statusCode); // 422
    console.error(error.message);    // 'The to field must be a valid E.164 phone number'
  }
}