Initialization
import { coss } from '@coss';coss.sms.init({apiKey: process.env.COSS_KEY,environment: 'production', // or 'sandbox'});
Sending Messages
// Send an SMS messageawait coss.sms.messages.send({to: '+15551234567',from: '+15559876543',body: 'Your verification code is 123456',});
Messages
// Retrieve a messageawait coss.sms.messages.retrieve('msg_abc123');// List sent messagesawait coss.sms.messages.list({to: '+15551234567',});
Phone Numbers
// Buy a new phone numberawait coss.sms.numbers.purchase({country: 'US',areaCode: '415',});// List owned numbersawait coss.sms.numbers.list();// Release a phone numberawait coss.sms.numbers.release('+15559876543');
Webhooks
// Webhook eventscoss.sms.webhooks.on('message.delivered', (event) => {console.log('Message delivered:', event.data);});coss.sms.webhooks.on('message.failed', (event) => {console.log('Message failed:', event.data);});
Utilities
// Validate webhook signatureconst isValid = coss.sms.utils.verifySignature({payload: req.body,signature: req.headers['coss-sms-signature'],secret: 'whsec_sms_123',});