SDKs & Tools

# npm
npm install @samva/sdk

# yarn
yarn add @samva/sdk

# bun
bun add @samva/sdk

pip install samva

go get github.com/samva/samva-go

import { SamvaClient } from '@samva/sdk';

const client = new SamvaClient({
  apiKey: process.env.SAMVA_API_KEY
});

// Send email
await client.messages.send({
  channel: 'email',
  to: 'user@example.com',
  content: {
    subject: 'Welcome to Samva',
    html: '<h1>Welcome!</h1><p>Thanks for joining.</p>',
    from: 'noreply@yourdomain.com'
  }
});

// Get email threads
const threads = await client.email.threads.list({
  limit: 10
});

// TypeScript knows all available options
const message = await client.messages.send({
  channel: 'email',  // Fully typed channel options
  // IDE shows all required and optional fields
  to: 'user@example.com',
  content: {
    subject: string,  // Type hints
    html: string,
    // ...
  }
});

try {
  await client.messages.send({...});
} catch (error) {
  if (error.code === 'INSUFFICIENT_CREDITS') {
    // Handle specific error
  }
}

const client = new SamvaClient({
  apiKey: 'your_key',
  maxRetries: 3,
  retryDelay: 1000
});

const isValid = client.webhooks.verifySignature(
  payload,
  signature,
  secret
);

const client = new SamvaClient({
  apiKey: 'sk_test_your_test_key',
  testMode: true  // Optional, auto-detected from key
});

// Test mode features:
// - No charges
// - Simulated delivery
// - Test phone numbers
// - Webhook testing