SDK changelog
Releases of @smsfabric/sdk on npm. The package follows semantic versioning: a minor version adds methods, a major version may change or remove them.
1.1.0 (2026-11-19)
Section titled “1.1.0 (2026-11-19)”- Standalone
verifySignatureandconstructEventexports. A webhook receiver no longer needs a client or an API key. See Webhooks. - The
RawBodytype. A raw webhook body may also be aUint8Array, for example fromawait request.arrayBuffer(). SMSFabricError.headersandSMSFabricError.retryAfter(seconds, fromRetry-After). See Errors.- Network errors keep the original error on
causeand name it in the message, for examplefetch failed (connect ECONNREFUSED 127.0.0.1:3000). isRetryable(status, code): the client’s retry rule.
- An explicit
accessTokenis used even whenSMSFABRIC_API_KEYis set. Before, the environment key won and user-only endpoints answered403 api_key_not_allowed. - Only
409 idempotency_in_progressis retried. Conflicts such as409 contact_existsare thrown at once. - A
DELETEretried after a network error, timeout or5xxresolves when the retry gets404. constructEventthrowsSignatureVerificationErrorfor a correctly signed body that is not a JSON object, instead of aSyntaxError.- Empty
apiKey,accessToken,baseUrl,SMSFABRIC_API_KEYandSMSFABRIC_BASE_URLvalues count as not set.
Behaviour changes
Section titled “Behaviour changes”- Credential order: an
apiKeyyou pass, then anaccessTokenyou pass, thenSMSFABRIC_API_KEY. 409is retried only foridempotency_in_progress.- A retried
DELETEmay resolve on404. - An unparsable signed webhook body throws
SignatureVerificationError.
1.0.0 (2026-11-19)
Section titled “1.0.0 (2026-11-19)”First public release on npm.
- Messages:
send,list,listAll,get,stats,exportCsv. - Verify (OTP):
verifications.send,check,get,list,listAll;verifications.settings.get,update. - Devices and SIMs:
devices.createPairingToken,list,get,update,delete,updateSim,setDefaultSim. - Pools:
pools.list,create,update,delete. - Webhooks:
webhooks.list,create,update,delete,deliveries,deliveriesAll,replay,test, plusverifySignatureandconstructEvent;webhooks.listenstreams the organization’s events to your machine for development (GET /v1/webhooks/listen), rotating and reconnecting on its own. - Blacklist:
blacklist.list,listAll,add,remove. - Contacts:
contacts.*,contacts.groups.*,contacts.imports.*(CSV upload and start), withlistAllon every list. - Templates and campaigns:
templates.*(withpreview),campaigns.*(withestimate,start,pause,resume,cancel,report). - Organization:
org.get,update;org.members.list,update,remove;org.invitations.list,create,revoke. - Plan:
plan.getreturns the plan, its limits with add-ons, the features and the usage (GET /v1/org/plan). - Preferences:
preferences.get,update. - Audit log:
audit.list,listAll. - API keys:
apiKeys.list,create,rotate,revoke. - Retries on
429,5xxand network errors with backoff that honoursRetry-After; anIdempotency-Keyon every create.429 quota_exceeded(a used-up plan allowance) is thrown at once, never retried. SMSFabricErrorcarriesstatus,code,detail,errors,requestIdand, on plan refusals,params.- ESM and CommonJS builds with type declarations; no runtime dependencies.