Biblioteca oficială Node.js pentru Calisero este disponibilă

Biblioteca oficială Node.js pentru Calisero este publicată și gata de folosit în producție. Acoperă tot API-ul — mesaje, verificări OTP, opt-out și detaliile contului — pentru orice aplicație Node.js, de la un server Express la un worker care rulează în fundal.

Ce include

Complet tipizată. Scrisă în TypeScript strict, cu declarațiile de tipuri incluse în pachet. Editorul îți completează fiecare opțiune pe care o trimiți și fiecare câmp din răspunsul API-ului.

Fără dependențe. Biblioteca folosește fetch-ul inclus în Node.js: nimic de instalat în plus, nimic de auditat. Funcționează atât cu import, cât și cu require().

OTP în două apeluri. Pornești o verificare, apoi validezi codul introdus de utilizator. Calisero generează, trimite și verifică codul, așa că aplicația ta nu îl stochează niciodată.

Webhooks de livrare. Un handler gata făcut pentru node:http și Express citește și validează fiecare raport de livrare, apoi îl predă codului tău ca obiect tipizat. Un token secret opțional în adresa de callback respinge cererile care nu îl conțin.

Erori clare. Fiecare tip de eșec are propria clasă de eroare — date invalide, cheie respinsă, prea multe cereri, eroare de server — cu mesajul API-ului și trace ID-ul cererii, cel pe care ți-l cere echipa de suport.

Ora României, gestionată. Transmiți un Date ca să programezi un mesaj, iar biblioteca îl convertește în fusul orar pe care îl așteaptă API-ul.

Scurtarea link-urilor. Activezi scurtarea link-urilor pentru un mesaj și urmărești click-urile pe ele.

Cum începi

Instalezi pachetul din npm:

npm install @calisero/calisero-node

Apoi trimiți primul mesaj cu cheia ta API:

import { SmsClient } from '@calisero/calisero-node';

const client = SmsClient.create(process.env.CALISERO_API_KEY);

const { data: message } = await client.messages.create({
    recipient: '+40742123456',
    body: 'Comanda ta a fost expediată și ajunge mâine.',
});

console.log(message.id, message.status);

Cu o cheie API de sandbox încerci fiecare apel fără să trimiți sau să plătești mesaje reale.

Biblioteca are nevoie de Node.js 20.19 sau mai nou și este testată pe Node.js 20, 22, 24 și 26, pe Linux, macOS și Windows. Codul sursă este public pe GitHub, cu exemple care rulează pentru fiecare operație, iar pagina de integrări listează versiunea curentă.

Păstrează cheia API pe server: biblioteca este făcută pentru cod care rulează pe server, niciodată în browser.

Ce urmează

Bundle-ul Symfony s-a lansat în aceeași zi, așa că pagina de integrări listează acum patru biblioteci oficiale: PHP, Laravel, Symfony și Node.js. Urmează bibliotecile Go și Python, care vor apărea pe aceeași pagină la lansare.