TypeScript SDK

npm install samva

# yarn
yarn add samva

# bun
bun add samva

# pnpm
pnpm add samva

import { createSamvaClient } from "samva";

const samva = createSamvaClient({
  apiKey: process.env.SAMVA_API_KEY!,
});

// Send an email
const emailResult = await samva.email.send({
  body: {
    to: "user@example.com",
    subject: "Welcome to Samva",
    html: "<h1>Hello!</h1><p>Welcome to our platform.</p>",
    text: "Hello! Welcome to our platform.",
  },
});

console.log("Email sent:", emailResult.data?.id);

// Send SMS
const smsResult = await samva.sms.send({
  body: {
    to: "+14155552671",
    message: "Your verification code is 123456",
  },
});

console.log("SMS sent:", smsResult.data?.id);

// Send email
await samva.email.send({
  body: {
    to: "user@example.com",
    subject: "Hello",
    html: "<p>Hi there!</p>",
  },
});

// List email templates
const templates = await samva.email.listTemplates({});

// Get email stats
const stats = await samva.email.getStats({
  query: { startDate: "2024-01-01" },
});

// Send SMS
await samva.sms.send({
  body: {
    to: "+14155552671",
    message: "Your code is 123456",
  },
});

// Get SMS stats
const stats = await samva.sms.getStats({});

// Send WhatsApp message
await samva.whatsapp.send({
  body: {
    to: "+14155552671",
    message: "Hello from Samva!",
  },
});

// Send template message
await samva.whatsapp.sendTemplate({
  body: {
    to: "+14155552671",
    templateId: "welcome_template",
    variables: { name: "John" },
  },
});

// List all messages
const messages = await samva.messages.list({
  query: { channel: "email", limit: 20 },
});

// Get message by ID
const message = await samva.messages.get({
  path: { id: "msg_123" },
});

// Get message events
const events = await samva.messages.getEvents({
  path: { id: "msg_123" },
});

const result = await samva.email.send({
  body: {
    to: "user@example.com",
    subject: "Test",
    text: "Hello",
  },
});

if (result.error) {
  console.error("Failed to send:", result.error.message);
} else {
  console.log("Sent:", result.data?.id);
}

const samva = createSamvaClient({
  apiKey: process.env.SAMVA_API_KEY!,
  // Optional: Override base URL for testing
  baseUrl: "https://api.samva.app",
});

# .env
SAMVA_API_KEY=sk_live_your_api_key_here

import { createSamvaClient } from "samva";

const samva = createSamvaClient({
  apiKey: process.env.SAMVA_API_KEY!,
});