@mandarvl/befiana-sms

Lightweight TypeScript client for the Befiana SMS API.

Installation

npm install @mandarvl/befiana-sms

Quick usage

import BefianaSMS from '@mandarvl/befiana-sms';

const client = new BefianaSMS(process.env.BEFIANA_API_KEY || 'your-api-key');

// Send single SMS
await client.send('340000000', 'Hello World!, this is a test message!');

// Schedule SMS
await client.schedule('320000000', 'Scheduled message', '2026-07-06 23:05');

// Bulk
await client.sendBulk(['340000000','320000001','330000002'], 'Bulk message', '2026-07-06 00:00');

// Upsert contact
await client.upsertContact('380000003', 'John Doe');

// Balance
const balance = await client.getBalance();

// Delivery status
const status = await client.getDeliveryStatus('befiana-1234567890');

Notes

• All requests require the Authorization header to be the API key value.
• The client uses cross-fetch for universal fetch support.