Skip to content
ContractSpec
Start here

Package manual · integrations

·Communication and notifications

integration.communication-channel-sms

CommunicationOS SMS channel adapter: inbound normalization (Twilio webhook parse), outbound send (provider-sms/Twilio), and documented-retention erasure.

integrationsintegrationv2.0.5experimentalservernode
@lssm-tech/integration.communication-channel-sms
bun add @lssm-tech/integration.communication-channel-sms
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

This package owns the canonical Twilio SMS channel adapter for CommunicationOS. It supports signature-verified inbound form webhooks, provider-backed outbound delivery, normalized ecosystem events and receipts, and explicit provider-retention behavior.

The adapter uses an explicit Node-compatible build profile, including Bun server hosts. Its credential and webhook boundary does not advertise a browser export condition. Existing package entry points and provider contracts remain unchanged.

Ecosystem composition

Use createTwilioSmsEcosystemAdapter from @lssm-tech/integration.communication-channel-sms/ecosystem-adapter when composing the current CommunicationOS ecosystem port. The adapter requires an injected SmsProvider, an E.164 sender number, and the Twilio auth token used to verify inbound signatures.

Managed connections store only an opaque credential reference. The resolved secret document is expected to contain:

json
{
  "network": "sms",
  "provider": "twilio",
  "accountSid": "...",
  "authToken": "...",
  "fromNumber": "+..."
}

The managed API accepts only application/x-www-form-urlencoded payloads with an X-Twilio-Signature that verifies against the exact callback URL. The managed worker rejects other providers or incomplete credential material.

Local conformance is not live provider qualification. Production activation still requires consent and opt-out enforcement, credentialed callback/send tests, delivery-status reconciliation, and an accepted Runtime Node effect path.

Relationships

THIS PACKAGEintegration.communication-channel-sms3 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

7 declarations

Declared capabilities

Integration Communication Channel Sms

CommunicationOS SMS channel adapter: inbound normalization (Twilio webhook parse), outbound send (provider-sms/Twilio), and documented-retention erasure.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lint:checknode ../../../scripts/biome.cjs check .
  • lint:fixnode ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .
  • testbun test
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit