@theokit/gateway-sms 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +62 -0
- package/dist/index.cjs +5 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +32 -1
- package/dist/index.d.ts +32 -1
- package/dist/index.js +5 -1
- package/dist/index.js.map +1 -1
- package/package.json +14 -6
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,67 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.1.4
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Drop the unused `@theokit/sdk` peer dependency, so a TheoKit app can install an adapter.
|
|
8
|
+
|
|
9
|
+
Every adapter declared `peer @theokit/sdk@^2.18.0` and imported the SDK in **zero** source files.
|
|
10
|
+
The framework ships `@theokit/sdk@4.x`, so `npm install @theokit/gateway-line` into a TheoKit app
|
|
11
|
+
failed outright with `ERESOLVE`.
|
|
12
|
+
|
|
13
|
+
The core's range was widened in `@theokit/gateway@0.7.0`, which was not enough on its own: an
|
|
14
|
+
adapter's own manifest still carried the pin, so installing one still failed even against the fixed
|
|
15
|
+
core. Measured in a real app before and after.
|
|
16
|
+
|
|
17
|
+
## 0.1.3
|
|
18
|
+
|
|
19
|
+
### Patch Changes
|
|
20
|
+
|
|
21
|
+
- 8cbf136: **Every published export now carries documentation.** Forty-seven public symbols shipped with no docblock at all, so a consumer hovering `DiscordAdapter`, `SlackAdapter`, `WhatsAppCloudBackend`, `ThreadStore` or any of the error classes got an empty tooltip. Coverage across the eleven packages went from 71.2% to 100% (163/163), measured over the published declarations rather than the source, because a docblock is not documentation until it survives the build.
|
|
22
|
+
|
|
23
|
+
The text says what each symbol is for and what constrains it, not what its name already says. `TelegramAdapter` records that a bot cannot enumerate its chats nor speak into one that has not spoken first. `DiscordAdapter` records that reading message content needs a privileged intent enabled in the developer portal, without which every `event.text` arrives empty and nothing says why. `WhatsAppWebBackend` records that it is unofficial and can get a number banned. `shouldDispatchSyncEvent` records that Matrix replays history on sync, which is why a freshly started bot would otherwise answer every message it can still see.
|
|
24
|
+
|
|
25
|
+
**`gateway-slack`'s README documented a type that does not exist.** Its usage example imported `GatewayMessageEvent` from `@theokit/gateway`. That name is an internal alias inside the Discord and Telegram adapters (`MessageEvent as GatewayMessageEvent`), never an export. A reader who copied the example got code that did not compile. It now imports `MessageEvent`, which is what `onInbound` actually hands the handler.
|
|
26
|
+
|
|
27
|
+
Two docblocks that attached to nothing were reattached: `acquirePidLock` in `gateway-whatsapp` had its documentation stranded thirty lines above, over a different function, and shipped undocumented as a result.
|
|
28
|
+
|
|
29
|
+
- 82a5099: **A webhook dispatch that rejects no longer ends the process.** Both servers answer the provider before running the handler — deliberately, because LINE and the SMS providers retry a webhook they did not see a 200 for, and waiting on a slow handler turns latency into a duplicate delivery. The cost of answering early is that the dispatch is floated, and a floated rejection is an unhandled one, which terminates Node. It is now caught and written to stderr.
|
|
30
|
+
|
|
31
|
+
This is the same defect that was fixed across the other adapters in #41; these two were missed because the gate that catches it only recognised the shape `void this.…`, and both float through a local (`void adapter.dispatch…`). The gate now matches any floated call, which is how these two surfaced.
|
|
32
|
+
|
|
33
|
+
- b8ef098: **Every package now ships the licence it declares.** All twelve manifests in this repository declare `Apache-2.0`, and the repository had no `LICENSE` file at all — not at the root, and not in any package directory except `gateway-email`. So each published tarball asserted a licence while carrying none of its terms, and §4(a) of that licence requires a copy to travel with the distribution. Worse than a missing file: with no licence text anywhere, everything outside the manifests fell back to default copyright, which grants a recipient nothing.
|
|
34
|
+
|
|
35
|
+
The text is now at the repository root and inside every publishable package, byte-identical to the canonical Apache License 2.0 with the appendix filled in (`Copyright 2026 usetheo.dev`). The one pre-existing copy, in `gateway-email`, was replaced along with the rest: it carried the same truncated paragraph 4(d) found across the ecosystem, dropping "reasonable and customary use" from the NOTICE clause — a modified body under an unmodified SPDX identifier.
|
|
36
|
+
|
|
37
|
+
**The repository moved to the official `usetheokit` organization.** Existing clones and published URLs keep working through GitHub's permanent redirect; the root manifest now declares `Apache-2.0` explicitly rather than leaving the workspace root silent.
|
|
38
|
+
|
|
39
|
+
- 5bae032: Six defects that broke real conversations, found by testing the adapters against the live platforms instead of against fakes.
|
|
40
|
+
|
|
41
|
+
**LINE — no outbound message was ever delivered.** The adapter called the v9 SDK client with positional arguments while that client takes a single request object, so LINE received an empty request and rejected every send with a 400. Upgrade if you use this adapter at all: nothing it sent reached anyone.
|
|
42
|
+
|
|
43
|
+
**Telegram — the bot froze on long replies.** Any message over 4096 characters that began with an unclosed code span (a stray backtick) put the splitter into an infinite loop, hanging the process until it ran out of memory. Long agent answers now split correctly whatever markdown they contain.
|
|
44
|
+
|
|
45
|
+
**Mattermost — long messages silently vanished.** The adapter never split anything, so any reply over 16,383 characters was rejected by the server and the user simply saw nothing. Long replies are now split into parts Mattermost accepts.
|
|
46
|
+
|
|
47
|
+
**SMS — long messages were rejected from the hundredth part onward.** The `(i/N)` prefix outgrew the space reserved for it, pushing every later part past the provider's limit.
|
|
48
|
+
|
|
49
|
+
**Matrix and LINE — `connect()` reported success with an invalid token.** Both now verify the credential with the server before returning `true`, so a wrong token fails at startup instead of silently receiving nothing forever.
|
|
50
|
+
|
|
51
|
+
**Email and Teams — the bot could go permanently deaf.** Replacing an inbound handler and then disposing of the previous one removed the new handler as well, and the gateway stopped receiving messages with nothing logged.
|
|
52
|
+
|
|
53
|
+
Also: a `pre_inbound` hook that threw put its raw error text into the user's chat, which could expose internal details such as connection strings or tokens. Users now see only which hook failed; the detail goes to the server log, redacted.
|
|
54
|
+
|
|
55
|
+
WhatsApp additionally stops opening a second session when `connect()` is called twice, and its group mention filter no longer treats unrelated digits scattered through a message as a mention of the bot.
|
|
56
|
+
|
|
57
|
+
- 4e6ae26: **The published type declarations now compile.** Five of these packages shipped a `.d.ts` (and matching `.d.cts`) containing type references that resolve to nothing — nine names, replicated across both module formats. `skipLibCheck: true` is on by default in most consumer projects, so the packages installed, imported and looked correct; under type-aware lint, which resolves the real type graph and has no such escape, every type reached through a broken reference degrades to `error`, and ordinary correct calls into these adapters come back flagged `no-unsafe-*`.
|
|
58
|
+
|
|
59
|
+
The names, all now bound: `EmailMessageEvent` (email), `SendResult` and `SlackMessageEvent` (slack), `GatewayConfigurationError` and `GatewayConfigurationErrorOptions` (sms), `TeamsMessageEvent` (teams), `ChildProcess` and `WhatsAppSendResult` (whatsapp).
|
|
60
|
+
|
|
61
|
+
Nothing was wrong with the source — every package's own `tsc --noEmit` was green throughout, which is exactly why this survived. The defect is in how tsup's declaration rollup emits the bundle: it re-exports a name without binding it locally, drops a type-only import from an external module while inlining the declarations that use it, or renames a declaration to avoid a collision and misses one use site. The `sms` names are the newest instance — the shared `GatewayConfigurationError` base introduced in `@theokit/gateway` 0.5.0 turned a local type into an external one, which is the shape the rollup drops.
|
|
62
|
+
|
|
63
|
+
The public surface of every package is unchanged: the same names are exported, and the repair that rewrites a re-export verifies that before and after. What changed is where a name is bound inside the declaration file.
|
|
64
|
+
|
|
3
65
|
## 0.1.2
|
|
4
66
|
|
|
5
67
|
### Patch Changes
|
package/dist/index.cjs
CHANGED
|
@@ -629,7 +629,11 @@ async function createWebhookServer(opts) {
|
|
|
629
629
|
res.status(400).type("text/plain").send(`parse failed: ${msg}`);
|
|
630
630
|
return;
|
|
631
631
|
}
|
|
632
|
-
void opts.adapter.dispatchEvent(event)
|
|
632
|
+
void opts.adapter.dispatchEvent(event).catch((err) => {
|
|
633
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
634
|
+
process.stderr.write(`[gateway-sms] webhook dispatch failed: ${message}
|
|
635
|
+
`);
|
|
636
|
+
});
|
|
633
637
|
res.status(204).end();
|
|
634
638
|
};
|
|
635
639
|
app.post(`${prefix}/${backend}`, rawCapture, handler);
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/errors.ts","../src/phone.ts","../src/backend/plivo.ts","../src/backend/twilio.ts","../src/backend/vonage.ts","../src/backend/index.ts","../src/normalize.ts","../src/split.ts","../src/adapter.ts","../src/webhook-server.ts"],"names":["GatewayConfigurationError","parsePhoneNumberFromString","parseFormUrlEncoded","chunkByGrapheme","BasePlatformAdapter"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-sms` (D389-D396).\n *\n * - `ConfigurationError` — programmer error at construction time\n * (missing signing secret, missing backend SDK install, malformed\n * phone number on outbound). Thrown synchronously.\n * - `BackendNotInstalledError` — peer-dep optional backend (twilio /\n * plivo / @vonage/server-sdk) was selected but the npm package is\n * not installed. Carries actionable install hint.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2); the SDK still consumes structured errors via\n * `metadata.code`. Behavior byte-identical (pinned by `tests/errors.test.ts`).\n *\n * @internal — re-exported by `src/index.ts`.\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-sms\", opts);\n }\n}\n\nexport class BackendNotInstalledError extends ConfigurationError {\n constructor(backend: \"twilio\" | \"plivo\" | \"vonage\", pkgName: string) {\n super({\n code: \"backend_not_installed\",\n message: `gateway-sms: peer-dep \"${pkgName}\" not installed but backend=\"${backend}\" was selected. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * E.164 phone normalization (D391, EC-6).\n *\n * Wraps `libphonenumber-js` (full — accepts mobile + toll-free; the\n * `/mobile` sub-bundle was inadequate because it rejects toll-free\n * US 1-800 numbers).\n *\n * @internal\n */\n\nimport { parsePhoneNumberFromString } from \"libphonenumber-js\";\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/**\n * Normalize a free-form phone number to canonical E.164 (`+5511999999999`).\n *\n * Accepts:\n * - International with `+`: `\"+5511999999999\"` → unchanged.\n * - National without `+` when `defaultCountry` is provided: `(\"11999999999\", \"BR\")` → `\"+5511999999999\"`.\n * - Toll-free US (EC-6): `\"+18001234567\"` → unchanged.\n *\n * Throws `ConfigurationError({ code: \"invalid_phone_number\" })` on any\n * input that cannot be parsed to a valid number.\n */\nexport function normalizeE164(input: string, defaultCountry?: string): string {\n if (input.length === 0) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: \"gateway-sms: phone number is empty\",\n detail: \"<empty>\",\n });\n }\n const parsed = parsePhoneNumberFromString(\n input,\n defaultCountry as Parameters<typeof parsePhoneNumberFromString>[1],\n );\n if (parsed === undefined || !parsed.isValid()) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: `gateway-sms: invalid phone number ${JSON.stringify(input)}`,\n detail: input,\n });\n }\n return parsed.format(\"E.164\");\n}\n","/**\n * Plivo backend impl.\n *\n * - SDK: `plivo` (peer-dep, optional).\n * - Signature: `X-Plivo-Signature-V3` is HMAC-SHA256 of the request URL\n * + nonce + body. `validateV3Signature` is exposed by the SDK; we\n * delegate to avoid reimplementation.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { PlivoOptions } from \"../types.js\";\n\ninterface PlivoCreateResponse {\n apiId?: string;\n messageUuid?: string[];\n message_uuid?: string[];\n}\n\ninterface PlivoClient {\n messages: {\n // The actual SDK uses positional args: create(src, dst, text, ...).\n create(src: string, dst: string, text: string): Promise<PlivoCreateResponse>;\n };\n}\n\ninterface PlivoModule {\n Client: new (authId?: string, authToken?: string) => PlivoClient;\n // Real SDK signature: validateV3Signature(method, uri, nonce, authToken, v3Signature)\n validateV3Signature?: (\n method: string,\n uri: string,\n nonce: string,\n authToken: string,\n signature: string,\n ) => boolean;\n}\n\nasync function loadPlivo(): Promise<PlivoModule> {\n try {\n // Plivo's published types are stricter (positional args) than our\n // generic mock; we narrow at call sites and pass through unknown.\n const mod = (await import(\"plivo\")) as unknown as PlivoModule;\n return mod;\n } catch {\n throw new BackendNotInstalledError(\"plivo\", \"plivo\");\n }\n}\n\nexport class PlivoBackend implements SMSBackend {\n readonly kind = \"plivo\" as const;\n private mod: PlivoModule | undefined;\n private client: PlivoClient | undefined;\n\n constructor(private readonly opts: PlivoOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.mod = await loadPlivo();\n this.client = new this.mod.Client(this.opts.authId, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.mod?.validateV3Signature === undefined) return false;\n const signature = ctx.headers[\"x-plivo-signature-v3\"];\n const nonce = ctx.headers[\"x-plivo-signature-v3-nonce\"];\n if (signature === undefined || nonce === undefined) return false;\n try {\n return this.mod.validateV3Signature(\"POST\", ctx.url, nonce, this.opts.authToken, signature);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let params: Record<string, string> = {};\n // Plivo posts JSON or form-encoded depending on application config.\n if ((ctx.headers[\"content-type\"] ?? \"\").includes(\"application/json\")) {\n try {\n params = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n params = {};\n }\n } else {\n params = parseFormUrlEncoded(ctx.rawBody);\n }\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Text ?? params.text ?? \"\",\n messageId: params.MessageUUID ?? params.message_uuid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"PlivoBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.client.messages.create(this.opts.fromNumber, to, body);\n const id = resp.messageUuid?.[0] ?? resp.message_uuid?.[0] ?? resp.apiId ?? \"\";\n return { ok: true, messageId: id };\n } catch (err) {\n return mapPlivoError(err);\n }\n }\n}\n\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface PlivoRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n}\n\nfunction mapPlivoError(err: unknown): SendResult {\n const e = err as PlivoRestError;\n const status = e.statusCode ?? e.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Plivo rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Plivo auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Plivo rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Twilio backend impl.\n *\n * - SDK: `twilio` (peer-dep, optional). Loaded lazily so packages\n * that pick other backends don't pay the cost.\n * - Signature: `X-Twilio-Signature` is HMAC-SHA1 of `(fullUrl + sortedParams)`.\n * We delegate to `twilio.validateRequest` so we don't reimplement.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { TwilioOptions } from \"../types.js\";\n\ninterface TwilioCreateArgs {\n from: string;\n to: string;\n body: string;\n}\n\ninterface TwilioMessageInstance {\n sid: string;\n status?: string;\n}\n\ninterface TwilioClientInstance {\n messages: {\n create(args: TwilioCreateArgs): Promise<TwilioMessageInstance>;\n };\n}\n\ninterface TwilioFactory {\n (accountSid: string, authToken: string): TwilioClientInstance;\n validateRequest(\n authToken: string,\n signature: string,\n url: string,\n params: Record<string, string>,\n ): boolean;\n}\n\nasync function loadTwilio(): Promise<TwilioFactory> {\n try {\n const mod = await import(\"twilio\");\n // ESM ships { default: factory }; CJS ships factory.\n const candidate =\n (mod as { default?: TwilioFactory }).default ?? (mod as unknown as TwilioFactory);\n return candidate;\n } catch {\n throw new BackendNotInstalledError(\"twilio\", \"twilio\");\n }\n}\n\nexport class TwilioBackend implements SMSBackend {\n readonly kind = \"twilio\" as const;\n private client: TwilioClientInstance | undefined;\n private twilio: TwilioFactory | undefined;\n\n constructor(private readonly opts: TwilioOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.twilio = await loadTwilio();\n this.client = this.twilio(this.opts.accountSid, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n // No persistent connection — REST client is GC'd on dereference.\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.twilio === undefined) return false;\n const signature = ctx.headers[\"x-twilio-signature\"];\n if (signature === undefined) return false;\n const params = parseFormUrlEncoded(ctx.rawBody);\n try {\n return this.twilio.validateRequest(this.opts.authToken, signature, ctx.url, params);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n const params = parseFormUrlEncoded(ctx.rawBody);\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Body ?? \"\",\n messageId: params.MessageSid ?? params.SmsMessageSid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"TwilioBackend.connect() not called\" },\n };\n }\n try {\n const msg = await this.client.messages.create({ from: this.opts.fromNumber, to, body });\n return { ok: true, messageId: msg.sid };\n } catch (err) {\n return mapTwilioError(err);\n }\n }\n}\n\n/**\n * Parse `application/x-www-form-urlencoded` request body to a flat\n * `Record<string, string>`. Twilio POSTs in this format.\n *\n * @internal\n */\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface TwilioRestError {\n status?: number;\n code?: number | string;\n message?: string;\n}\n\nfunction mapTwilioError(err: unknown): SendResult {\n const e = err as TwilioRestError;\n const status = e.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Twilio rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Twilio auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Twilio rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Vonage backend impl.\n *\n * - SDK: `@vonage/server-sdk` (peer-dep, optional).\n * - Signature: `Authorization: Bearer <JWT>` signed with the Signature\n * Secret (NOT the API secret). The SDK exposes `Auth.verifySignature`\n * for this purpose.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { VonageOptions } from \"../types.js\";\n\ninterface VonageSmsClient {\n send(args: { to: string; from: string; text: string }): Promise<{\n messages?: Array<{ \"message-id\"?: string; messageId?: string; status?: string }>;\n }>;\n}\n\ninterface VonageInstance {\n sms: VonageSmsClient;\n}\n\ninterface VonageModule {\n Vonage: new (creds: {\n apiKey: string;\n apiSecret: string;\n signatureSecret?: string;\n }) => VonageInstance;\n Auth?: {\n verifySignature?: (token: string, secret: string) => boolean;\n };\n}\n\nasync function loadVonage(): Promise<VonageModule> {\n try {\n // SDK ships ESM/CJS variants; we narrow at call sites and pass through.\n const raw = await import(\"@vonage/server-sdk\");\n return raw as unknown as VonageModule;\n } catch {\n throw new BackendNotInstalledError(\"vonage\", \"@vonage/server-sdk\");\n }\n}\n\nexport class VonageBackend implements SMSBackend {\n readonly kind = \"vonage\" as const;\n private mod: VonageModule | undefined;\n private vonage: VonageInstance | undefined;\n\n constructor(private readonly opts: VonageOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.vonage !== undefined) return true;\n this.mod = await loadVonage();\n this.vonage = new this.mod.Vonage({\n apiKey: this.opts.apiKey,\n apiSecret: this.opts.apiSecret,\n signatureSecret: this.opts.signatureSecret,\n });\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.vonage = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n const auth = ctx.headers.authorization;\n if (auth === undefined) return false;\n const m = auth.match(/^Bearer\\s+(.+)$/i);\n if (m === null) return false;\n const token = m[1] ?? \"\";\n if (token.length === 0) return false;\n if (this.mod?.Auth?.verifySignature === undefined) return false;\n try {\n return this.mod.Auth.verifySignature(token, this.opts.signatureSecret);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let payload: Record<string, string> = {};\n try {\n payload = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n payload = {};\n }\n return {\n from: normalizeE164(payload.msisdn ?? payload.from ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(payload.to ?? \"\", this.opts.defaultCountry),\n body: payload.text ?? \"\",\n messageId: payload.messageId ?? payload[\"message-id\"] ?? \"\",\n receivedAt: Date.now(),\n raw: payload,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.vonage === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"VonageBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.vonage.sms.send({ from: this.opts.fromNumber, to, text: body });\n const msg = resp.messages?.[0];\n const id = msg?.[\"message-id\"] ?? msg?.messageId ?? \"\";\n if (msg?.status !== undefined && msg.status !== \"0\") {\n return {\n ok: false,\n error: { code: \"send_failed\", message: `Vonage returned status=${msg.status}` },\n };\n }\n return { ok: true, messageId: id };\n } catch (err) {\n return mapVonageError(err);\n }\n }\n}\n\ninterface VonageRestError {\n status?: number;\n response?: { status?: number };\n message?: string;\n}\n\nfunction mapVonageError(err: unknown): SendResult {\n const e = err as VonageRestError;\n const status = e.status ?? e.response?.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Vonage rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Vonage auth error\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Backend factory — picks the right impl from `opts.backend`.\n *\n * @internal\n */\n\nimport type { SMSBackend } from \"../backend-types.js\";\nimport type { SMSAdapterOptions } from \"../types.js\";\nimport { PlivoBackend } from \"./plivo.js\";\nimport { TwilioBackend } from \"./twilio.js\";\nimport { VonageBackend } from \"./vonage.js\";\n\nexport function createBackend(opts: SMSAdapterOptions): SMSBackend {\n switch (opts.backend) {\n case \"twilio\":\n return new TwilioBackend(opts);\n case \"plivo\":\n return new PlivoBackend(opts);\n case \"vonage\":\n return new VonageBackend(opts);\n default: {\n const _exhaustive: never = opts;\n throw new Error(`unknown backend: ${JSON.stringify(_exhaustive)}`);\n }\n }\n}\n","/**\n * Inbound normalization: `SMSInbound` → `SMSMessageEvent`.\n *\n * `from` and `to` are already E.164 (backend.parseInbound enforces this).\n * `channel.id` is `from` because SMS conversations are flat per-pair\n * (D394 — no threading).\n *\n * @internal\n */\n\nimport type { SMSMessageEvent } from \"@theokit/gateway\";\n\nimport type { SMSInbound } from \"./backend-types.js\";\n\nexport function inboundToMessageEvent(\n inbound: SMSInbound,\n backend: \"twilio\" | \"plivo\" | \"vonage\",\n): SMSMessageEvent {\n return {\n id: inbound.messageId,\n platform: \"sms\",\n sender: { id: inbound.from },\n channel: { id: inbound.from, type: \"dm\" },\n text: inbound.body,\n receivedAt: inbound.receivedAt,\n sms: {\n backend,\n messageId: inbound.messageId,\n from: inbound.from,\n to: inbound.to,\n raw: inbound.raw,\n },\n };\n}\n","/**\n * `splitForSMS` — grapheme-cluster-safe multipart segmentation (D393, EC-7).\n *\n * Concatenated SMS (UDH) on modern carriers reassemble at the recipient,\n * but each TCP/IP-layer chunk is one billed message. We segment at\n * 1600 chars (default) so the API call doesn't reject and each part is\n * prefixed with `(i/N) ` to allow manual reordering when carriers\n * deliver out of sequence (EC-7).\n *\n * Thin wrapper over core `chunkByGrapheme` (roadmap M1) — single-sources the\n * `Intl.Segmenter` grapheme walk so emoji (🇧🇷) and combining sequences are\n * never severed. The `(i/N) ` prefix (and its reserved width) stays here since\n * it is SMS-specific. Output is byte-identical to the previous implementation\n * (pinned by `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\n/**\n * Width of `\"(i/total) \"` when `i` has as many digits as `total` — the widest\n * the prefix can get for a given part count. `(99/99) ` is 8, `(100/126) ` is\n * 10, `(1000/1234) ` is 12.\n *\n * This used to be the constant 8, commented `\"(99/99) \" worst case`. It is the\n * worst case only below 100 parts; from the hundredth part on, every prefix\n * overflowed its reservation and each part exceeded the caller's declared cap\n * by 2 chars, which the provider rejects.\n */\nfunction prefixWidthFor(total: number): number {\n return 2 * String(total).length + 4;\n}\n\nexport function splitForSMS(text: string, limit = 1600): string[] {\n // Chicken and egg: the reservation depends on the part count, and the part\n // count depends on the reservation. Widening the prefix shrinks the payload,\n // which can push the count into another digit — so iterate to a fixed point.\n // It converges fast because the width grows with the LOGARITHM of the count;\n // the bound is a backstop against a pathological input, not the expected path.\n let reserved = prefixWidthFor(1);\n for (let pass = 0; pass < 8; pass += 1) {\n const partLimit = limit - reserved;\n if (partLimit <= 0) {\n throw new RangeError(\n `limit ${limit} is too small to carry an SMS part: the \"(i/N) \" prefix alone needs ${reserved} chars`,\n );\n }\n const parts = chunkByGrapheme(text, { limit, partLimit });\n if (parts.length <= 1) return parts; // short-circuit / single part: skip prefix\n const needed = prefixWidthFor(parts.length);\n if (needed <= reserved) {\n const total = parts.length;\n return parts.map((p, i) => `(${i + 1}/${total}) ${p}`);\n }\n reserved = needed;\n }\n /* c8 ignore next 3 -- unreachable: 8 passes cover part counts up to 10^8. */\n throw new RangeError(\n `could not settle the \"(i/N) \" prefix width for a ${text.length}-char message at limit ${limit}`,\n );\n}\n","/**\n * `SMSAdapter` — implements `BasePlatformAdapter` over a backend\n * (twilio / plivo / vonage). ADRs D389-D396.\n *\n * Lifecycle:\n * - `connect()` initializes the chosen backend (lazy peer-dep import).\n * - `disconnect()` releases the backend; idempotent.\n * - `sendMessage()` splits multipart (D393) and sends each part via backend.\n * - `onInbound(handler)` replaces previous handler (EC-H, mirror D276).\n *\n * Inbound dispatch is driven by the webhook server (`webhook-server.ts`)\n * which calls `adapter.dispatchInbound(ctx)` after signature verification.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\nimport { createBackend } from \"./backend/index.js\";\nimport type { SignatureContext, SMSBackend } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { inboundToMessageEvent } from \"./normalize.js\";\nimport { normalizeE164 } from \"./phone.js\";\nimport { splitForSMS } from \"./split.js\";\nimport type { SMSAdapterOptions } from \"./types.js\";\n\nexport class SMSAdapter extends BasePlatformAdapter {\n readonly platform = \"sms\" as const;\n private readonly backend: SMSBackend;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n private readonly defaultCountry: string | undefined;\n\n constructor(opts: SMSAdapterOptions) {\n super();\n // EC-1: refuse to operate without signing secret.\n const secret = secretFromOpts(opts);\n if (secret.length === 0) {\n throw new ConfigurationError({\n code: \"signing_secret_required\",\n message: `gateway-sms: backend=\"${opts.backend}\" requires a signing secret (would accept unsigned webhooks)`,\n });\n }\n this.defaultCountry = opts.defaultCountry;\n this.backend = createBackend(opts);\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n const ok = await this.backend.connect();\n this.connected = ok;\n return ok;\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n await this.backend.disconnect();\n this.connected = false;\n this.inboundHandler = undefined;\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n let toE164: string;\n try {\n toE164 = normalizeE164(out.channel.id, this.defaultCountry);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return { ok: false, error: { code: \"invalid_phone_number\", message: msg } };\n }\n const parts = splitForSMS(out.text);\n // Send sequentially so the recipient sees them in order; concurrent\n // submit would still cost the same but breaks ordering at carriers.\n let lastResult: SendResult | undefined;\n for (const part of parts) {\n lastResult = await this.backend.sendMessage(toE164, part);\n if (lastResult.ok !== true) {\n return {\n ok: false,\n error: {\n code: lastResult.error?.code ?? \"partial_send_failure\",\n message: `partial send failed after ${parts.indexOf(part)}/${parts.length}: ${lastResult.error?.message ?? \"unknown\"}`,\n },\n };\n }\n }\n return lastResult ?? { ok: false, error: { code: \"send_failed\", message: \"no parts sent\" } };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /**\n * Webhook hook — called by `createWebhookServer` AFTER signature\n * verification + parseInbound. Returns dispatch outcome (used for\n * 200/204 vs 500 by the webhook handler).\n *\n * @internal\n */\n async dispatchInbound(ctx: SignatureContext): Promise<\"ok\" | \"no_handler\" | \"parse_failed\"> {\n if (!this.backend.verifySignature(ctx)) {\n // Caller (webhook-server) inspects this via verifySignature directly,\n // but we re-check defensively if anyone calls dispatch directly.\n return \"parse_failed\";\n }\n let inbound: ReturnType<SMSBackend[\"parseInbound\"]>;\n try {\n inbound = this.backend.parseInbound(ctx);\n } catch {\n return \"parse_failed\";\n }\n if (this.inboundHandler === undefined) return \"no_handler\";\n const event = inboundToMessageEvent(inbound, this.backend.kind);\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /**\n * Direct signature check — used by the webhook server to respond\n * `401` BEFORE dispatch when signature is invalid.\n *\n * @internal\n */\n verifySignature(ctx: SignatureContext): boolean {\n return this.backend.verifySignature(ctx);\n }\n\n /**\n * Direct parse — used by the webhook server when signature was already\n * validated upstream. Returns the normalized `SMSMessageEvent` to be\n * dispatched.\n *\n * @internal\n */\n buildEventFromCtx(ctx: SignatureContext): GatewayMessageEvent {\n const inbound = this.backend.parseInbound(ctx);\n return inboundToMessageEvent(inbound, this.backend.kind);\n }\n\n /**\n * Dispatch a pre-built event (used by webhook server after manual\n * signature + parse). Honors EC-H replace semantics and isolates\n * handler exceptions per `gateway-runner` contract.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\"> {\n if (this.inboundHandler === undefined) return \"no_handler\";\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /** Backend kind (escape hatch for callers needing to introspect). */\n getBackendKind(): \"twilio\" | \"plivo\" | \"vonage\" {\n return this.backend.kind;\n }\n}\n\nfunction secretFromOpts(opts: SMSAdapterOptions): string {\n switch (opts.backend) {\n case \"twilio\":\n return opts.authToken;\n case \"plivo\":\n return opts.authToken;\n case \"vonage\":\n return opts.signatureSecret;\n default: {\n const _exhaustive: never = opts;\n void _exhaustive;\n return \"\";\n }\n }\n}\n","/**\n * `createWebhookServer` — Express helper for inbound SMS webhooks.\n *\n * Registers per-backend routes (`/sms/twilio`, `/sms/plivo`, `/sms/vonage`)\n * each with the matching parser middleware. All three:\n *\n * 1. Read the raw body verbatim (signature verification depends on the\n * exact bytes — even one extra `\\r\\n` invalidates the HMAC).\n * 2. Call `adapter.verifySignature(ctx)` → 401 if false.\n * 3. Call `adapter.buildEventFromCtx(ctx)` → `dispatchEvent(event)`.\n * 4. Return 204 No Content.\n *\n * Caller can pass an existing Express app (`opts.app`) or let the helper\n * create one. `start()` / `stop()` are idempotent.\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\nimport type { SMSAdapter } from \"./adapter.js\";\nimport type { SignatureContext } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: SMSAdapter;\n /** Mount path prefix; default `\"/sms\"`. The full path is `${path}/${backend}`. */\n readonly path?: string;\n /** Listen port. Ignored when `app` is provided. Default `3000`. */\n readonly port?: number;\n /** Inject an existing Express app instead of creating one. */\n readonly app?: Express;\n}\n\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n // Both ESM and CJS forms; normalize to { default }.\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-sms: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction buildSignatureContext(req: Request): SignatureContext {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const headers: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.headers)) {\n headers[k.toLowerCase()] = Array.isArray(v) ? v.join(\",\") : (v ?? \"\");\n }\n const protoHeader = headers[\"x-forwarded-proto\"];\n const proto = protoHeader ?? (req.secure ? \"https\" : \"http\");\n const host = req.get(\"host\") ?? \"localhost\";\n const url = `${proto}://${host}${req.originalUrl}`;\n return { headers, rawBody, url };\n}\n\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const prefix = opts.path ?? \"/sms\";\n const backend = opts.adapter.getBackendKind();\n\n // Raw-body capture middleware — must run BEFORE express.urlencoded/json,\n // since signature verification needs the exact byte sequence.\n const rawCapture = (req: Request, _res: Response, next: NextFunction) => {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response:\n // the provider times out and retries, and nothing is logged. Failing loudly\n // and continuing is strictly better — verification then refuses the empty\n // body with a 401, a visible symptom that points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway-sms] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n };\n\n const handler = (req: Request, res: Response): void => {\n const ctx = buildSignatureContext(req);\n if (!opts.adapter.verifySignature(ctx)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let event: ReturnType<typeof opts.adapter.buildEventFromCtx>;\n try {\n event = opts.adapter.buildEventFromCtx(ctx);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.status(400).type(\"text/plain\").send(`parse failed: ${msg}`);\n return;\n }\n void opts.adapter.dispatchEvent(event);\n // Twilio expects either TwiML or 204; 204 keeps things simple\n // and avoids accidentally double-replying.\n res.status(204).end();\n };\n\n app.post(`${prefix}/${backend}`, rawCapture, handler);\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n // When caller injected its own app, we don't manage the listener.\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/phone.ts","../src/backend/plivo.ts","../src/backend/twilio.ts","../src/backend/vonage.ts","../src/backend/index.ts","../src/normalize.ts","../src/split.ts","../src/adapter.ts","../src/webhook-server.ts"],"names":["GatewayConfigurationError","parsePhoneNumberFromString","parseFormUrlEncoded","chunkByGrapheme","BasePlatformAdapter"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-sms` (D389-D396).\n *\n * - `ConfigurationError` — programmer error at construction time\n * (missing signing secret, missing backend SDK install, malformed\n * phone number on outbound). Thrown synchronously.\n * - `BackendNotInstalledError` — peer-dep optional backend (twilio /\n * plivo / @vonage/server-sdk) was selected but the npm package is\n * not installed. Carries actionable install hint.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2); the SDK still consumes structured errors via\n * `metadata.code`. Behavior byte-identical (pinned by `tests/errors.test.ts`).\n *\n * @internal — re-exported by `src/index.ts`.\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-sms\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-sms\", opts);\n }\n}\n\n/**\n * The provider SDK for the selected backend is not installed.\n *\n * `gateway-sms` speaks to Twilio, Plivo or Vonage, and declares all three as optional peers — a\n * project installs only the one it uses. Selecting a backend whose SDK is absent is caught here, at\n * connect time, with the package name and the command that installs it.\n */\nexport class BackendNotInstalledError extends ConfigurationError {\n constructor(backend: \"twilio\" | \"plivo\" | \"vonage\", pkgName: string) {\n super({\n code: \"backend_not_installed\",\n message: `gateway-sms: peer-dep \"${pkgName}\" not installed but backend=\"${backend}\" was selected. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * E.164 phone normalization (D391, EC-6).\n *\n * Wraps `libphonenumber-js` (full — accepts mobile + toll-free; the\n * `/mobile` sub-bundle was inadequate because it rejects toll-free\n * US 1-800 numbers).\n *\n * @internal\n */\n\nimport { parsePhoneNumberFromString } from \"libphonenumber-js\";\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/**\n * Normalize a free-form phone number to canonical E.164 (`+5511999999999`).\n *\n * Accepts:\n * - International with `+`: `\"+5511999999999\"` → unchanged.\n * - National without `+` when `defaultCountry` is provided: `(\"11999999999\", \"BR\")` → `\"+5511999999999\"`.\n * - Toll-free US (EC-6): `\"+18001234567\"` → unchanged.\n *\n * Throws `ConfigurationError({ code: \"invalid_phone_number\" })` on any\n * input that cannot be parsed to a valid number.\n */\nexport function normalizeE164(input: string, defaultCountry?: string): string {\n if (input.length === 0) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: \"gateway-sms: phone number is empty\",\n detail: \"<empty>\",\n });\n }\n const parsed = parsePhoneNumberFromString(\n input,\n defaultCountry as Parameters<typeof parsePhoneNumberFromString>[1],\n );\n if (parsed === undefined || !parsed.isValid()) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: `gateway-sms: invalid phone number ${JSON.stringify(input)}`,\n detail: input,\n });\n }\n return parsed.format(\"E.164\");\n}\n","/**\n * Plivo backend impl.\n *\n * - SDK: `plivo` (peer-dep, optional).\n * - Signature: `X-Plivo-Signature-V3` is HMAC-SHA256 of the request URL\n * + nonce + body. `validateV3Signature` is exposed by the SDK; we\n * delegate to avoid reimplementation.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { PlivoOptions } from \"../types.js\";\n\ninterface PlivoCreateResponse {\n apiId?: string;\n messageUuid?: string[];\n message_uuid?: string[];\n}\n\ninterface PlivoClient {\n messages: {\n // The actual SDK uses positional args: create(src, dst, text, ...).\n create(src: string, dst: string, text: string): Promise<PlivoCreateResponse>;\n };\n}\n\ninterface PlivoModule {\n Client: new (authId?: string, authToken?: string) => PlivoClient;\n // Real SDK signature: validateV3Signature(method, uri, nonce, authToken, v3Signature)\n validateV3Signature?: (\n method: string,\n uri: string,\n nonce: string,\n authToken: string,\n signature: string,\n ) => boolean;\n}\n\nasync function loadPlivo(): Promise<PlivoModule> {\n try {\n // Plivo's published types are stricter (positional args) than our\n // generic mock; we narrow at call sites and pass through unknown.\n const mod = (await import(\"plivo\")) as unknown as PlivoModule;\n return mod;\n } catch {\n throw new BackendNotInstalledError(\"plivo\", \"plivo\");\n }\n}\n\nexport class PlivoBackend implements SMSBackend {\n readonly kind = \"plivo\" as const;\n private mod: PlivoModule | undefined;\n private client: PlivoClient | undefined;\n\n constructor(private readonly opts: PlivoOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.mod = await loadPlivo();\n this.client = new this.mod.Client(this.opts.authId, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.mod?.validateV3Signature === undefined) return false;\n const signature = ctx.headers[\"x-plivo-signature-v3\"];\n const nonce = ctx.headers[\"x-plivo-signature-v3-nonce\"];\n if (signature === undefined || nonce === undefined) return false;\n try {\n return this.mod.validateV3Signature(\"POST\", ctx.url, nonce, this.opts.authToken, signature);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let params: Record<string, string> = {};\n // Plivo posts JSON or form-encoded depending on application config.\n if ((ctx.headers[\"content-type\"] ?? \"\").includes(\"application/json\")) {\n try {\n params = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n params = {};\n }\n } else {\n params = parseFormUrlEncoded(ctx.rawBody);\n }\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Text ?? params.text ?? \"\",\n messageId: params.MessageUUID ?? params.message_uuid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"PlivoBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.client.messages.create(this.opts.fromNumber, to, body);\n const id = resp.messageUuid?.[0] ?? resp.message_uuid?.[0] ?? resp.apiId ?? \"\";\n return { ok: true, messageId: id };\n } catch (err) {\n return mapPlivoError(err);\n }\n }\n}\n\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface PlivoRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n}\n\nfunction mapPlivoError(err: unknown): SendResult {\n const e = err as PlivoRestError;\n const status = e.statusCode ?? e.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Plivo rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Plivo auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Plivo rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Twilio backend impl.\n *\n * - SDK: `twilio` (peer-dep, optional). Loaded lazily so packages\n * that pick other backends don't pay the cost.\n * - Signature: `X-Twilio-Signature` is HMAC-SHA1 of `(fullUrl + sortedParams)`.\n * We delegate to `twilio.validateRequest` so we don't reimplement.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { TwilioOptions } from \"../types.js\";\n\ninterface TwilioCreateArgs {\n from: string;\n to: string;\n body: string;\n}\n\ninterface TwilioMessageInstance {\n sid: string;\n status?: string;\n}\n\ninterface TwilioClientInstance {\n messages: {\n create(args: TwilioCreateArgs): Promise<TwilioMessageInstance>;\n };\n}\n\ninterface TwilioFactory {\n (accountSid: string, authToken: string): TwilioClientInstance;\n validateRequest(\n authToken: string,\n signature: string,\n url: string,\n params: Record<string, string>,\n ): boolean;\n}\n\nasync function loadTwilio(): Promise<TwilioFactory> {\n try {\n const mod = await import(\"twilio\");\n // ESM ships { default: factory }; CJS ships factory.\n const candidate =\n (mod as { default?: TwilioFactory }).default ?? (mod as unknown as TwilioFactory);\n return candidate;\n } catch {\n throw new BackendNotInstalledError(\"twilio\", \"twilio\");\n }\n}\n\nexport class TwilioBackend implements SMSBackend {\n readonly kind = \"twilio\" as const;\n private client: TwilioClientInstance | undefined;\n private twilio: TwilioFactory | undefined;\n\n constructor(private readonly opts: TwilioOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.twilio = await loadTwilio();\n this.client = this.twilio(this.opts.accountSid, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n // No persistent connection — REST client is GC'd on dereference.\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.twilio === undefined) return false;\n const signature = ctx.headers[\"x-twilio-signature\"];\n if (signature === undefined) return false;\n const params = parseFormUrlEncoded(ctx.rawBody);\n try {\n return this.twilio.validateRequest(this.opts.authToken, signature, ctx.url, params);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n const params = parseFormUrlEncoded(ctx.rawBody);\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Body ?? \"\",\n messageId: params.MessageSid ?? params.SmsMessageSid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"TwilioBackend.connect() not called\" },\n };\n }\n try {\n const msg = await this.client.messages.create({ from: this.opts.fromNumber, to, body });\n return { ok: true, messageId: msg.sid };\n } catch (err) {\n return mapTwilioError(err);\n }\n }\n}\n\n/**\n * Parse `application/x-www-form-urlencoded` request body to a flat\n * `Record<string, string>`. Twilio POSTs in this format.\n *\n * @internal\n */\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface TwilioRestError {\n status?: number;\n code?: number | string;\n message?: string;\n}\n\nfunction mapTwilioError(err: unknown): SendResult {\n const e = err as TwilioRestError;\n const status = e.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Twilio rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Twilio auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Twilio rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Vonage backend impl.\n *\n * - SDK: `@vonage/server-sdk` (peer-dep, optional).\n * - Signature: `Authorization: Bearer <JWT>` signed with the Signature\n * Secret (NOT the API secret). The SDK exposes `Auth.verifySignature`\n * for this purpose.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { VonageOptions } from \"../types.js\";\n\ninterface VonageSmsClient {\n send(args: { to: string; from: string; text: string }): Promise<{\n messages?: Array<{ \"message-id\"?: string; messageId?: string; status?: string }>;\n }>;\n}\n\ninterface VonageInstance {\n sms: VonageSmsClient;\n}\n\ninterface VonageModule {\n Vonage: new (creds: {\n apiKey: string;\n apiSecret: string;\n signatureSecret?: string;\n }) => VonageInstance;\n Auth?: {\n verifySignature?: (token: string, secret: string) => boolean;\n };\n}\n\nasync function loadVonage(): Promise<VonageModule> {\n try {\n // SDK ships ESM/CJS variants; we narrow at call sites and pass through.\n const raw = await import(\"@vonage/server-sdk\");\n return raw as unknown as VonageModule;\n } catch {\n throw new BackendNotInstalledError(\"vonage\", \"@vonage/server-sdk\");\n }\n}\n\nexport class VonageBackend implements SMSBackend {\n readonly kind = \"vonage\" as const;\n private mod: VonageModule | undefined;\n private vonage: VonageInstance | undefined;\n\n constructor(private readonly opts: VonageOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.vonage !== undefined) return true;\n this.mod = await loadVonage();\n this.vonage = new this.mod.Vonage({\n apiKey: this.opts.apiKey,\n apiSecret: this.opts.apiSecret,\n signatureSecret: this.opts.signatureSecret,\n });\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.vonage = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n const auth = ctx.headers.authorization;\n if (auth === undefined) return false;\n const m = auth.match(/^Bearer\\s+(.+)$/i);\n if (m === null) return false;\n const token = m[1] ?? \"\";\n if (token.length === 0) return false;\n if (this.mod?.Auth?.verifySignature === undefined) return false;\n try {\n return this.mod.Auth.verifySignature(token, this.opts.signatureSecret);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let payload: Record<string, string> = {};\n try {\n payload = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n payload = {};\n }\n return {\n from: normalizeE164(payload.msisdn ?? payload.from ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(payload.to ?? \"\", this.opts.defaultCountry),\n body: payload.text ?? \"\",\n messageId: payload.messageId ?? payload[\"message-id\"] ?? \"\",\n receivedAt: Date.now(),\n raw: payload,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.vonage === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"VonageBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.vonage.sms.send({ from: this.opts.fromNumber, to, text: body });\n const msg = resp.messages?.[0];\n const id = msg?.[\"message-id\"] ?? msg?.messageId ?? \"\";\n if (msg?.status !== undefined && msg.status !== \"0\") {\n return {\n ok: false,\n error: { code: \"send_failed\", message: `Vonage returned status=${msg.status}` },\n };\n }\n return { ok: true, messageId: id };\n } catch (err) {\n return mapVonageError(err);\n }\n }\n}\n\ninterface VonageRestError {\n status?: number;\n response?: { status?: number };\n message?: string;\n}\n\nfunction mapVonageError(err: unknown): SendResult {\n const e = err as VonageRestError;\n const status = e.status ?? e.response?.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Vonage rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Vonage auth error\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Backend factory — picks the right impl from `opts.backend`.\n *\n * @internal\n */\n\nimport type { SMSBackend } from \"../backend-types.js\";\nimport type { SMSAdapterOptions } from \"../types.js\";\nimport { PlivoBackend } from \"./plivo.js\";\nimport { TwilioBackend } from \"./twilio.js\";\nimport { VonageBackend } from \"./vonage.js\";\n\nexport function createBackend(opts: SMSAdapterOptions): SMSBackend {\n switch (opts.backend) {\n case \"twilio\":\n return new TwilioBackend(opts);\n case \"plivo\":\n return new PlivoBackend(opts);\n case \"vonage\":\n return new VonageBackend(opts);\n default: {\n const _exhaustive: never = opts;\n throw new Error(`unknown backend: ${JSON.stringify(_exhaustive)}`);\n }\n }\n}\n","/**\n * Inbound normalization: `SMSInbound` → `SMSMessageEvent`.\n *\n * `from` and `to` are already E.164 (backend.parseInbound enforces this).\n * `channel.id` is `from` because SMS conversations are flat per-pair\n * (D394 — no threading).\n *\n * @internal\n */\n\nimport type { SMSMessageEvent } from \"@theokit/gateway\";\n\nimport type { SMSInbound } from \"./backend-types.js\";\n\nexport function inboundToMessageEvent(\n inbound: SMSInbound,\n backend: \"twilio\" | \"plivo\" | \"vonage\",\n): SMSMessageEvent {\n return {\n id: inbound.messageId,\n platform: \"sms\",\n sender: { id: inbound.from },\n channel: { id: inbound.from, type: \"dm\" },\n text: inbound.body,\n receivedAt: inbound.receivedAt,\n sms: {\n backend,\n messageId: inbound.messageId,\n from: inbound.from,\n to: inbound.to,\n raw: inbound.raw,\n },\n };\n}\n","/**\n * `splitForSMS` — grapheme-cluster-safe multipart segmentation (D393, EC-7).\n *\n * Concatenated SMS (UDH) on modern carriers reassemble at the recipient,\n * but each TCP/IP-layer chunk is one billed message. We segment at\n * 1600 chars (default) so the API call doesn't reject and each part is\n * prefixed with `(i/N) ` to allow manual reordering when carriers\n * deliver out of sequence (EC-7).\n *\n * Thin wrapper over core `chunkByGrapheme` (roadmap M1) — single-sources the\n * `Intl.Segmenter` grapheme walk so emoji (🇧🇷) and combining sequences are\n * never severed. The `(i/N) ` prefix (and its reserved width) stays here since\n * it is SMS-specific. Output is byte-identical to the previous implementation\n * (pinned by `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\n/**\n * Width of `\"(i/total) \"` when `i` has as many digits as `total` — the widest\n * the prefix can get for a given part count. `(99/99) ` is 8, `(100/126) ` is\n * 10, `(1000/1234) ` is 12.\n *\n * This used to be the constant 8, commented `\"(99/99) \" worst case`. It is the\n * worst case only below 100 parts; from the hundredth part on, every prefix\n * overflowed its reservation and each part exceeded the caller's declared cap\n * by 2 chars, which the provider rejects.\n */\nfunction prefixWidthFor(total: number): number {\n return 2 * String(total).length + 4;\n}\n\nexport function splitForSMS(text: string, limit = 1600): string[] {\n // Chicken and egg: the reservation depends on the part count, and the part\n // count depends on the reservation. Widening the prefix shrinks the payload,\n // which can push the count into another digit — so iterate to a fixed point.\n // It converges fast because the width grows with the LOGARITHM of the count;\n // the bound is a backstop against a pathological input, not the expected path.\n let reserved = prefixWidthFor(1);\n for (let pass = 0; pass < 8; pass += 1) {\n const partLimit = limit - reserved;\n if (partLimit <= 0) {\n throw new RangeError(\n `limit ${limit} is too small to carry an SMS part: the \"(i/N) \" prefix alone needs ${reserved} chars`,\n );\n }\n const parts = chunkByGrapheme(text, { limit, partLimit });\n if (parts.length <= 1) return parts; // short-circuit / single part: skip prefix\n const needed = prefixWidthFor(parts.length);\n if (needed <= reserved) {\n const total = parts.length;\n return parts.map((p, i) => `(${i + 1}/${total}) ${p}`);\n }\n reserved = needed;\n }\n /* c8 ignore next 3 -- unreachable: 8 passes cover part counts up to 10^8. */\n throw new RangeError(\n `could not settle the \"(i/N) \" prefix width for a ${text.length}-char message at limit ${limit}`,\n );\n}\n","/**\n * `SMSAdapter` — implements `BasePlatformAdapter` over a backend\n * (twilio / plivo / vonage). ADRs D389-D396.\n *\n * Lifecycle:\n * - `connect()` initializes the chosen backend (lazy peer-dep import).\n * - `disconnect()` releases the backend; idempotent.\n * - `sendMessage()` splits multipart (D393) and sends each part via backend.\n * - `onInbound(handler)` replaces previous handler (EC-H, mirror D276).\n *\n * Inbound dispatch is driven by the webhook server (`webhook-server.ts`)\n * which calls `adapter.dispatchInbound(ctx)` after signature verification.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\nimport { createBackend } from \"./backend/index.js\";\nimport type { SignatureContext, SMSBackend } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { inboundToMessageEvent } from \"./normalize.js\";\nimport { normalizeE164 } from \"./phone.js\";\nimport { splitForSMS } from \"./split.js\";\nimport type { SMSAdapterOptions } from \"./types.js\";\n\nexport class SMSAdapter extends BasePlatformAdapter {\n readonly platform = \"sms\" as const;\n private readonly backend: SMSBackend;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n private readonly defaultCountry: string | undefined;\n\n constructor(opts: SMSAdapterOptions) {\n super();\n // EC-1: refuse to operate without signing secret.\n const secret = secretFromOpts(opts);\n if (secret.length === 0) {\n throw new ConfigurationError({\n code: \"signing_secret_required\",\n message: `gateway-sms: backend=\"${opts.backend}\" requires a signing secret (would accept unsigned webhooks)`,\n });\n }\n this.defaultCountry = opts.defaultCountry;\n this.backend = createBackend(opts);\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n const ok = await this.backend.connect();\n this.connected = ok;\n return ok;\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n await this.backend.disconnect();\n this.connected = false;\n this.inboundHandler = undefined;\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n let toE164: string;\n try {\n toE164 = normalizeE164(out.channel.id, this.defaultCountry);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return { ok: false, error: { code: \"invalid_phone_number\", message: msg } };\n }\n const parts = splitForSMS(out.text);\n // Send sequentially so the recipient sees them in order; concurrent\n // submit would still cost the same but breaks ordering at carriers.\n let lastResult: SendResult | undefined;\n for (const part of parts) {\n lastResult = await this.backend.sendMessage(toE164, part);\n if (lastResult.ok !== true) {\n return {\n ok: false,\n error: {\n code: lastResult.error?.code ?? \"partial_send_failure\",\n message: `partial send failed after ${parts.indexOf(part)}/${parts.length}: ${lastResult.error?.message ?? \"unknown\"}`,\n },\n };\n }\n }\n return lastResult ?? { ok: false, error: { code: \"send_failed\", message: \"no parts sent\" } };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /**\n * Webhook hook — called by `createWebhookServer` AFTER signature\n * verification + parseInbound. Returns dispatch outcome (used for\n * 200/204 vs 500 by the webhook handler).\n *\n * @internal\n */\n async dispatchInbound(ctx: SignatureContext): Promise<\"ok\" | \"no_handler\" | \"parse_failed\"> {\n if (!this.backend.verifySignature(ctx)) {\n // Caller (webhook-server) inspects this via verifySignature directly,\n // but we re-check defensively if anyone calls dispatch directly.\n return \"parse_failed\";\n }\n let inbound: ReturnType<SMSBackend[\"parseInbound\"]>;\n try {\n inbound = this.backend.parseInbound(ctx);\n } catch {\n return \"parse_failed\";\n }\n if (this.inboundHandler === undefined) return \"no_handler\";\n const event = inboundToMessageEvent(inbound, this.backend.kind);\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /**\n * Direct signature check — used by the webhook server to respond\n * `401` BEFORE dispatch when signature is invalid.\n *\n * @internal\n */\n verifySignature(ctx: SignatureContext): boolean {\n return this.backend.verifySignature(ctx);\n }\n\n /**\n * Direct parse — used by the webhook server when signature was already\n * validated upstream. Returns the normalized `SMSMessageEvent` to be\n * dispatched.\n *\n * @internal\n */\n buildEventFromCtx(ctx: SignatureContext): GatewayMessageEvent {\n const inbound = this.backend.parseInbound(ctx);\n return inboundToMessageEvent(inbound, this.backend.kind);\n }\n\n /**\n * Dispatch a pre-built event (used by webhook server after manual\n * signature + parse). Honors EC-H replace semantics and isolates\n * handler exceptions per `gateway-runner` contract.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\"> {\n if (this.inboundHandler === undefined) return \"no_handler\";\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /** Backend kind (escape hatch for callers needing to introspect). */\n getBackendKind(): \"twilio\" | \"plivo\" | \"vonage\" {\n return this.backend.kind;\n }\n}\n\nfunction secretFromOpts(opts: SMSAdapterOptions): string {\n switch (opts.backend) {\n case \"twilio\":\n return opts.authToken;\n case \"plivo\":\n return opts.authToken;\n case \"vonage\":\n return opts.signatureSecret;\n default: {\n const _exhaustive: never = opts;\n void _exhaustive;\n return \"\";\n }\n }\n}\n","/**\n * `createWebhookServer` — Express helper for inbound SMS webhooks.\n *\n * Registers per-backend routes (`/sms/twilio`, `/sms/plivo`, `/sms/vonage`)\n * each with the matching parser middleware. All three:\n *\n * 1. Read the raw body verbatim (signature verification depends on the\n * exact bytes — even one extra `\\r\\n` invalidates the HMAC).\n * 2. Call `adapter.verifySignature(ctx)` → 401 if false.\n * 3. Call `adapter.buildEventFromCtx(ctx)` → `dispatchEvent(event)`.\n * 4. Return 204 No Content.\n *\n * Caller can pass an existing Express app (`opts.app`) or let the helper\n * create one. `start()` / `stop()` are idempotent.\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\nimport type { SMSAdapter } from \"./adapter.js\";\nimport type { SignatureContext } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: SMSAdapter;\n /** Mount path prefix; default `\"/sms\"`. The full path is `${path}/${backend}`. */\n readonly path?: string;\n /** Listen port. Ignored when `app` is provided. Default `3000`. */\n readonly port?: number;\n /** Inject an existing Express app instead of creating one. */\n readonly app?: Express;\n}\n\n/** A started HTTP listener, with the handle needed to shut it down again. */\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n // Both ESM and CJS forms; normalize to { default }.\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-sms: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction buildSignatureContext(req: Request): SignatureContext {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const headers: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.headers)) {\n headers[k.toLowerCase()] = Array.isArray(v) ? v.join(\",\") : (v ?? \"\");\n }\n const protoHeader = headers[\"x-forwarded-proto\"];\n const proto = protoHeader ?? (req.secure ? \"https\" : \"http\");\n const host = req.get(\"host\") ?? \"localhost\";\n const url = `${proto}://${host}${req.originalUrl}`;\n return { headers, rawBody, url };\n}\n\n/**\n * Build the HTTP listener that receives the provider's inbound-SMS callbacks.\n *\n * The provider dials in, so this endpoint must be reachable over public HTTPS and registered in the\n * provider console — inbound cannot work behind a firewall. `express` is loaded lazily, so a project\n * that only sends messages never pays for it.\n */\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const prefix = opts.path ?? \"/sms\";\n const backend = opts.adapter.getBackendKind();\n\n // Raw-body capture middleware — must run BEFORE express.urlencoded/json,\n // since signature verification needs the exact byte sequence.\n const rawCapture = (req: Request, _res: Response, next: NextFunction) => {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response:\n // the provider times out and retries, and nothing is logged. Failing loudly\n // and continuing is strictly better — verification then refuses the empty\n // body with a 401, a visible symptom that points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway-sms] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n };\n\n const handler = (req: Request, res: Response): void => {\n const ctx = buildSignatureContext(req);\n if (!opts.adapter.verifySignature(ctx)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let event: ReturnType<typeof opts.adapter.buildEventFromCtx>;\n try {\n event = opts.adapter.buildEventFromCtx(ctx);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.status(400).type(\"text/plain\").send(`parse failed: ${msg}`);\n return;\n }\n // Same contract as the LINE server: the provider is answered before the handler runs, so a\n // slow handler cannot become a provider retry. That makes the dispatch floated, and a floated\n // rejection ends the process — so it is caught here rather than left to the runtime (#41).\n void opts.adapter.dispatchEvent(event).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] webhook dispatch failed: ${message}\\n`);\n });\n // Twilio expects either TwiML or 204; 204 keeps things simple\n // and avoids accidentally double-replying.\n res.status(204).end();\n };\n\n app.post(`${prefix}/${backend}`, rawCapture, handler);\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n // When caller injected its own app, we don't manage the listener.\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { BasePlatformAdapter, OutboundMessage, SendResult, MessageEvent } from '@theokit/gateway';
|
|
1
|
+
import { GatewayConfigurationError, GatewayConfigurationErrorOptions, BasePlatformAdapter, OutboundMessage, SendResult, MessageEvent } from '@theokit/gateway';
|
|
2
2
|
import { Express } from 'express';
|
|
3
3
|
|
|
4
4
|
/**
|
|
@@ -23,6 +23,7 @@ interface TwilioOptions {
|
|
|
23
23
|
/** Default country for unprefixed inbound `from` numbers. Optional. */
|
|
24
24
|
readonly defaultCountry?: string;
|
|
25
25
|
}
|
|
26
|
+
/** Construction options for the Plivo backend. */
|
|
26
27
|
interface PlivoOptions {
|
|
27
28
|
readonly backend: "plivo";
|
|
28
29
|
readonly authId: string;
|
|
@@ -32,6 +33,7 @@ interface PlivoOptions {
|
|
|
32
33
|
readonly publicUrl: string;
|
|
33
34
|
readonly defaultCountry?: string;
|
|
34
35
|
}
|
|
36
|
+
/** Construction options for the Vonage backend. */
|
|
35
37
|
interface VonageOptions {
|
|
36
38
|
readonly backend: "vonage";
|
|
37
39
|
readonly apiKey: string;
|
|
@@ -42,6 +44,12 @@ interface VonageOptions {
|
|
|
42
44
|
readonly publicUrl: string;
|
|
43
45
|
readonly defaultCountry?: string;
|
|
44
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* Construction options for the SMS adapter — one variant per supported provider.
|
|
49
|
+
*
|
|
50
|
+
* Discriminated by `backend`, so choosing a provider narrows the object to exactly the credentials
|
|
51
|
+
* that provider needs; a Twilio account SID cannot be passed to Vonage by accident.
|
|
52
|
+
*/
|
|
45
53
|
type SMSAdapterOptions = TwilioOptions | PlivoOptions | VonageOptions;
|
|
46
54
|
|
|
47
55
|
/**
|
|
@@ -93,10 +101,25 @@ declare class SMSAdapter extends BasePlatformAdapter {
|
|
|
93
101
|
*/
|
|
94
102
|
/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */
|
|
95
103
|
type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;
|
|
104
|
+
/**
|
|
105
|
+
* Misconfiguration of this adapter, raised before any network call.
|
|
106
|
+
*
|
|
107
|
+
* Extends the shared core base so every gateway package reports configuration faults in one shape:
|
|
108
|
+
* a structured `code` the caller can branch on, tagged with `"gateway-sms"` as the origin. A
|
|
109
|
+
* missing credential or an unsupported option is a programmer error, not a transient failure —
|
|
110
|
+
* these are never retried.
|
|
111
|
+
*/
|
|
96
112
|
declare class ConfigurationError extends GatewayConfigurationError {
|
|
97
113
|
readonly name = "ConfigurationError";
|
|
98
114
|
constructor(opts: ConfigurationErrorOptions);
|
|
99
115
|
}
|
|
116
|
+
/**
|
|
117
|
+
* The provider SDK for the selected backend is not installed.
|
|
118
|
+
*
|
|
119
|
+
* `gateway-sms` speaks to Twilio, Plivo or Vonage, and declares all three as optional peers — a
|
|
120
|
+
* project installs only the one it uses. Selecting a backend whose SDK is absent is caught here, at
|
|
121
|
+
* connect time, with the package name and the command that installs it.
|
|
122
|
+
*/
|
|
100
123
|
declare class BackendNotInstalledError extends ConfigurationError {
|
|
101
124
|
constructor(backend: "twilio" | "plivo" | "vonage", pkgName: string);
|
|
102
125
|
}
|
|
@@ -169,10 +192,18 @@ interface WebhookServerOptions {
|
|
|
169
192
|
/** Inject an existing Express app instead of creating one. */
|
|
170
193
|
readonly app?: Express;
|
|
171
194
|
}
|
|
195
|
+
/** A started HTTP listener, with the handle needed to shut it down again. */
|
|
172
196
|
interface WebhookServer {
|
|
173
197
|
start(): Promise<void>;
|
|
174
198
|
stop(): Promise<void>;
|
|
175
199
|
}
|
|
200
|
+
/**
|
|
201
|
+
* Build the HTTP listener that receives the provider's inbound-SMS callbacks.
|
|
202
|
+
*
|
|
203
|
+
* The provider dials in, so this endpoint must be reachable over public HTTPS and registered in the
|
|
204
|
+
* provider console — inbound cannot work behind a firewall. `express` is loaded lazily, so a project
|
|
205
|
+
* that only sends messages never pays for it.
|
|
206
|
+
*/
|
|
176
207
|
declare function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer>;
|
|
177
208
|
|
|
178
209
|
export { BackendNotInstalledError, ConfigurationError, type PlivoOptions, SMSAdapter, type SMSAdapterOptions, type TwilioOptions, type VonageOptions, type WebhookServer, type WebhookServerOptions, createWebhookServer, normalizeE164, splitForSMS };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { BasePlatformAdapter, OutboundMessage, SendResult, MessageEvent } from '@theokit/gateway';
|
|
1
|
+
import { GatewayConfigurationError, GatewayConfigurationErrorOptions, BasePlatformAdapter, OutboundMessage, SendResult, MessageEvent } from '@theokit/gateway';
|
|
2
2
|
import { Express } from 'express';
|
|
3
3
|
|
|
4
4
|
/**
|
|
@@ -23,6 +23,7 @@ interface TwilioOptions {
|
|
|
23
23
|
/** Default country for unprefixed inbound `from` numbers. Optional. */
|
|
24
24
|
readonly defaultCountry?: string;
|
|
25
25
|
}
|
|
26
|
+
/** Construction options for the Plivo backend. */
|
|
26
27
|
interface PlivoOptions {
|
|
27
28
|
readonly backend: "plivo";
|
|
28
29
|
readonly authId: string;
|
|
@@ -32,6 +33,7 @@ interface PlivoOptions {
|
|
|
32
33
|
readonly publicUrl: string;
|
|
33
34
|
readonly defaultCountry?: string;
|
|
34
35
|
}
|
|
36
|
+
/** Construction options for the Vonage backend. */
|
|
35
37
|
interface VonageOptions {
|
|
36
38
|
readonly backend: "vonage";
|
|
37
39
|
readonly apiKey: string;
|
|
@@ -42,6 +44,12 @@ interface VonageOptions {
|
|
|
42
44
|
readonly publicUrl: string;
|
|
43
45
|
readonly defaultCountry?: string;
|
|
44
46
|
}
|
|
47
|
+
/**
|
|
48
|
+
* Construction options for the SMS adapter — one variant per supported provider.
|
|
49
|
+
*
|
|
50
|
+
* Discriminated by `backend`, so choosing a provider narrows the object to exactly the credentials
|
|
51
|
+
* that provider needs; a Twilio account SID cannot be passed to Vonage by accident.
|
|
52
|
+
*/
|
|
45
53
|
type SMSAdapterOptions = TwilioOptions | PlivoOptions | VonageOptions;
|
|
46
54
|
|
|
47
55
|
/**
|
|
@@ -93,10 +101,25 @@ declare class SMSAdapter extends BasePlatformAdapter {
|
|
|
93
101
|
*/
|
|
94
102
|
/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */
|
|
95
103
|
type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;
|
|
104
|
+
/**
|
|
105
|
+
* Misconfiguration of this adapter, raised before any network call.
|
|
106
|
+
*
|
|
107
|
+
* Extends the shared core base so every gateway package reports configuration faults in one shape:
|
|
108
|
+
* a structured `code` the caller can branch on, tagged with `"gateway-sms"` as the origin. A
|
|
109
|
+
* missing credential or an unsupported option is a programmer error, not a transient failure —
|
|
110
|
+
* these are never retried.
|
|
111
|
+
*/
|
|
96
112
|
declare class ConfigurationError extends GatewayConfigurationError {
|
|
97
113
|
readonly name = "ConfigurationError";
|
|
98
114
|
constructor(opts: ConfigurationErrorOptions);
|
|
99
115
|
}
|
|
116
|
+
/**
|
|
117
|
+
* The provider SDK for the selected backend is not installed.
|
|
118
|
+
*
|
|
119
|
+
* `gateway-sms` speaks to Twilio, Plivo or Vonage, and declares all three as optional peers — a
|
|
120
|
+
* project installs only the one it uses. Selecting a backend whose SDK is absent is caught here, at
|
|
121
|
+
* connect time, with the package name and the command that installs it.
|
|
122
|
+
*/
|
|
100
123
|
declare class BackendNotInstalledError extends ConfigurationError {
|
|
101
124
|
constructor(backend: "twilio" | "plivo" | "vonage", pkgName: string);
|
|
102
125
|
}
|
|
@@ -169,10 +192,18 @@ interface WebhookServerOptions {
|
|
|
169
192
|
/** Inject an existing Express app instead of creating one. */
|
|
170
193
|
readonly app?: Express;
|
|
171
194
|
}
|
|
195
|
+
/** A started HTTP listener, with the handle needed to shut it down again. */
|
|
172
196
|
interface WebhookServer {
|
|
173
197
|
start(): Promise<void>;
|
|
174
198
|
stop(): Promise<void>;
|
|
175
199
|
}
|
|
200
|
+
/**
|
|
201
|
+
* Build the HTTP listener that receives the provider's inbound-SMS callbacks.
|
|
202
|
+
*
|
|
203
|
+
* The provider dials in, so this endpoint must be reachable over public HTTPS and registered in the
|
|
204
|
+
* provider console — inbound cannot work behind a firewall. `express` is loaded lazily, so a project
|
|
205
|
+
* that only sends messages never pays for it.
|
|
206
|
+
*/
|
|
176
207
|
declare function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer>;
|
|
177
208
|
|
|
178
209
|
export { BackendNotInstalledError, ConfigurationError, type PlivoOptions, SMSAdapter, type SMSAdapterOptions, type TwilioOptions, type VonageOptions, type WebhookServer, type WebhookServerOptions, createWebhookServer, normalizeE164, splitForSMS };
|
package/dist/index.js
CHANGED
|
@@ -627,7 +627,11 @@ async function createWebhookServer(opts) {
|
|
|
627
627
|
res.status(400).type("text/plain").send(`parse failed: ${msg}`);
|
|
628
628
|
return;
|
|
629
629
|
}
|
|
630
|
-
void opts.adapter.dispatchEvent(event)
|
|
630
|
+
void opts.adapter.dispatchEvent(event).catch((err) => {
|
|
631
|
+
const message = err instanceof Error ? err.message : String(err);
|
|
632
|
+
process.stderr.write(`[gateway-sms] webhook dispatch failed: ${message}
|
|
633
|
+
`);
|
|
634
|
+
});
|
|
631
635
|
res.status(204).end();
|
|
632
636
|
};
|
|
633
637
|
app.post(`${prefix}/${backend}`, rawCapture, handler);
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/errors.ts","../src/phone.ts","../src/backend/plivo.ts","../src/backend/twilio.ts","../src/backend/vonage.ts","../src/backend/index.ts","../src/normalize.ts","../src/split.ts","../src/adapter.ts","../src/webhook-server.ts"],"names":["parseFormUrlEncoded"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-sms` (D389-D396).\n *\n * - `ConfigurationError` — programmer error at construction time\n * (missing signing secret, missing backend SDK install, malformed\n * phone number on outbound). Thrown synchronously.\n * - `BackendNotInstalledError` — peer-dep optional backend (twilio /\n * plivo / @vonage/server-sdk) was selected but the npm package is\n * not installed. Carries actionable install hint.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2); the SDK still consumes structured errors via\n * `metadata.code`. Behavior byte-identical (pinned by `tests/errors.test.ts`).\n *\n * @internal — re-exported by `src/index.ts`.\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-sms\", opts);\n }\n}\n\nexport class BackendNotInstalledError extends ConfigurationError {\n constructor(backend: \"twilio\" | \"plivo\" | \"vonage\", pkgName: string) {\n super({\n code: \"backend_not_installed\",\n message: `gateway-sms: peer-dep \"${pkgName}\" not installed but backend=\"${backend}\" was selected. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * E.164 phone normalization (D391, EC-6).\n *\n * Wraps `libphonenumber-js` (full — accepts mobile + toll-free; the\n * `/mobile` sub-bundle was inadequate because it rejects toll-free\n * US 1-800 numbers).\n *\n * @internal\n */\n\nimport { parsePhoneNumberFromString } from \"libphonenumber-js\";\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/**\n * Normalize a free-form phone number to canonical E.164 (`+5511999999999`).\n *\n * Accepts:\n * - International with `+`: `\"+5511999999999\"` → unchanged.\n * - National without `+` when `defaultCountry` is provided: `(\"11999999999\", \"BR\")` → `\"+5511999999999\"`.\n * - Toll-free US (EC-6): `\"+18001234567\"` → unchanged.\n *\n * Throws `ConfigurationError({ code: \"invalid_phone_number\" })` on any\n * input that cannot be parsed to a valid number.\n */\nexport function normalizeE164(input: string, defaultCountry?: string): string {\n if (input.length === 0) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: \"gateway-sms: phone number is empty\",\n detail: \"<empty>\",\n });\n }\n const parsed = parsePhoneNumberFromString(\n input,\n defaultCountry as Parameters<typeof parsePhoneNumberFromString>[1],\n );\n if (parsed === undefined || !parsed.isValid()) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: `gateway-sms: invalid phone number ${JSON.stringify(input)}`,\n detail: input,\n });\n }\n return parsed.format(\"E.164\");\n}\n","/**\n * Plivo backend impl.\n *\n * - SDK: `plivo` (peer-dep, optional).\n * - Signature: `X-Plivo-Signature-V3` is HMAC-SHA256 of the request URL\n * + nonce + body. `validateV3Signature` is exposed by the SDK; we\n * delegate to avoid reimplementation.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { PlivoOptions } from \"../types.js\";\n\ninterface PlivoCreateResponse {\n apiId?: string;\n messageUuid?: string[];\n message_uuid?: string[];\n}\n\ninterface PlivoClient {\n messages: {\n // The actual SDK uses positional args: create(src, dst, text, ...).\n create(src: string, dst: string, text: string): Promise<PlivoCreateResponse>;\n };\n}\n\ninterface PlivoModule {\n Client: new (authId?: string, authToken?: string) => PlivoClient;\n // Real SDK signature: validateV3Signature(method, uri, nonce, authToken, v3Signature)\n validateV3Signature?: (\n method: string,\n uri: string,\n nonce: string,\n authToken: string,\n signature: string,\n ) => boolean;\n}\n\nasync function loadPlivo(): Promise<PlivoModule> {\n try {\n // Plivo's published types are stricter (positional args) than our\n // generic mock; we narrow at call sites and pass through unknown.\n const mod = (await import(\"plivo\")) as unknown as PlivoModule;\n return mod;\n } catch {\n throw new BackendNotInstalledError(\"plivo\", \"plivo\");\n }\n}\n\nexport class PlivoBackend implements SMSBackend {\n readonly kind = \"plivo\" as const;\n private mod: PlivoModule | undefined;\n private client: PlivoClient | undefined;\n\n constructor(private readonly opts: PlivoOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.mod = await loadPlivo();\n this.client = new this.mod.Client(this.opts.authId, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.mod?.validateV3Signature === undefined) return false;\n const signature = ctx.headers[\"x-plivo-signature-v3\"];\n const nonce = ctx.headers[\"x-plivo-signature-v3-nonce\"];\n if (signature === undefined || nonce === undefined) return false;\n try {\n return this.mod.validateV3Signature(\"POST\", ctx.url, nonce, this.opts.authToken, signature);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let params: Record<string, string> = {};\n // Plivo posts JSON or form-encoded depending on application config.\n if ((ctx.headers[\"content-type\"] ?? \"\").includes(\"application/json\")) {\n try {\n params = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n params = {};\n }\n } else {\n params = parseFormUrlEncoded(ctx.rawBody);\n }\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Text ?? params.text ?? \"\",\n messageId: params.MessageUUID ?? params.message_uuid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"PlivoBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.client.messages.create(this.opts.fromNumber, to, body);\n const id = resp.messageUuid?.[0] ?? resp.message_uuid?.[0] ?? resp.apiId ?? \"\";\n return { ok: true, messageId: id };\n } catch (err) {\n return mapPlivoError(err);\n }\n }\n}\n\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface PlivoRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n}\n\nfunction mapPlivoError(err: unknown): SendResult {\n const e = err as PlivoRestError;\n const status = e.statusCode ?? e.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Plivo rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Plivo auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Plivo rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Twilio backend impl.\n *\n * - SDK: `twilio` (peer-dep, optional). Loaded lazily so packages\n * that pick other backends don't pay the cost.\n * - Signature: `X-Twilio-Signature` is HMAC-SHA1 of `(fullUrl + sortedParams)`.\n * We delegate to `twilio.validateRequest` so we don't reimplement.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { TwilioOptions } from \"../types.js\";\n\ninterface TwilioCreateArgs {\n from: string;\n to: string;\n body: string;\n}\n\ninterface TwilioMessageInstance {\n sid: string;\n status?: string;\n}\n\ninterface TwilioClientInstance {\n messages: {\n create(args: TwilioCreateArgs): Promise<TwilioMessageInstance>;\n };\n}\n\ninterface TwilioFactory {\n (accountSid: string, authToken: string): TwilioClientInstance;\n validateRequest(\n authToken: string,\n signature: string,\n url: string,\n params: Record<string, string>,\n ): boolean;\n}\n\nasync function loadTwilio(): Promise<TwilioFactory> {\n try {\n const mod = await import(\"twilio\");\n // ESM ships { default: factory }; CJS ships factory.\n const candidate =\n (mod as { default?: TwilioFactory }).default ?? (mod as unknown as TwilioFactory);\n return candidate;\n } catch {\n throw new BackendNotInstalledError(\"twilio\", \"twilio\");\n }\n}\n\nexport class TwilioBackend implements SMSBackend {\n readonly kind = \"twilio\" as const;\n private client: TwilioClientInstance | undefined;\n private twilio: TwilioFactory | undefined;\n\n constructor(private readonly opts: TwilioOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.twilio = await loadTwilio();\n this.client = this.twilio(this.opts.accountSid, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n // No persistent connection — REST client is GC'd on dereference.\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.twilio === undefined) return false;\n const signature = ctx.headers[\"x-twilio-signature\"];\n if (signature === undefined) return false;\n const params = parseFormUrlEncoded(ctx.rawBody);\n try {\n return this.twilio.validateRequest(this.opts.authToken, signature, ctx.url, params);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n const params = parseFormUrlEncoded(ctx.rawBody);\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Body ?? \"\",\n messageId: params.MessageSid ?? params.SmsMessageSid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"TwilioBackend.connect() not called\" },\n };\n }\n try {\n const msg = await this.client.messages.create({ from: this.opts.fromNumber, to, body });\n return { ok: true, messageId: msg.sid };\n } catch (err) {\n return mapTwilioError(err);\n }\n }\n}\n\n/**\n * Parse `application/x-www-form-urlencoded` request body to a flat\n * `Record<string, string>`. Twilio POSTs in this format.\n *\n * @internal\n */\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface TwilioRestError {\n status?: number;\n code?: number | string;\n message?: string;\n}\n\nfunction mapTwilioError(err: unknown): SendResult {\n const e = err as TwilioRestError;\n const status = e.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Twilio rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Twilio auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Twilio rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Vonage backend impl.\n *\n * - SDK: `@vonage/server-sdk` (peer-dep, optional).\n * - Signature: `Authorization: Bearer <JWT>` signed with the Signature\n * Secret (NOT the API secret). The SDK exposes `Auth.verifySignature`\n * for this purpose.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { VonageOptions } from \"../types.js\";\n\ninterface VonageSmsClient {\n send(args: { to: string; from: string; text: string }): Promise<{\n messages?: Array<{ \"message-id\"?: string; messageId?: string; status?: string }>;\n }>;\n}\n\ninterface VonageInstance {\n sms: VonageSmsClient;\n}\n\ninterface VonageModule {\n Vonage: new (creds: {\n apiKey: string;\n apiSecret: string;\n signatureSecret?: string;\n }) => VonageInstance;\n Auth?: {\n verifySignature?: (token: string, secret: string) => boolean;\n };\n}\n\nasync function loadVonage(): Promise<VonageModule> {\n try {\n // SDK ships ESM/CJS variants; we narrow at call sites and pass through.\n const raw = await import(\"@vonage/server-sdk\");\n return raw as unknown as VonageModule;\n } catch {\n throw new BackendNotInstalledError(\"vonage\", \"@vonage/server-sdk\");\n }\n}\n\nexport class VonageBackend implements SMSBackend {\n readonly kind = \"vonage\" as const;\n private mod: VonageModule | undefined;\n private vonage: VonageInstance | undefined;\n\n constructor(private readonly opts: VonageOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.vonage !== undefined) return true;\n this.mod = await loadVonage();\n this.vonage = new this.mod.Vonage({\n apiKey: this.opts.apiKey,\n apiSecret: this.opts.apiSecret,\n signatureSecret: this.opts.signatureSecret,\n });\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.vonage = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n const auth = ctx.headers.authorization;\n if (auth === undefined) return false;\n const m = auth.match(/^Bearer\\s+(.+)$/i);\n if (m === null) return false;\n const token = m[1] ?? \"\";\n if (token.length === 0) return false;\n if (this.mod?.Auth?.verifySignature === undefined) return false;\n try {\n return this.mod.Auth.verifySignature(token, this.opts.signatureSecret);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let payload: Record<string, string> = {};\n try {\n payload = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n payload = {};\n }\n return {\n from: normalizeE164(payload.msisdn ?? payload.from ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(payload.to ?? \"\", this.opts.defaultCountry),\n body: payload.text ?? \"\",\n messageId: payload.messageId ?? payload[\"message-id\"] ?? \"\",\n receivedAt: Date.now(),\n raw: payload,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.vonage === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"VonageBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.vonage.sms.send({ from: this.opts.fromNumber, to, text: body });\n const msg = resp.messages?.[0];\n const id = msg?.[\"message-id\"] ?? msg?.messageId ?? \"\";\n if (msg?.status !== undefined && msg.status !== \"0\") {\n return {\n ok: false,\n error: { code: \"send_failed\", message: `Vonage returned status=${msg.status}` },\n };\n }\n return { ok: true, messageId: id };\n } catch (err) {\n return mapVonageError(err);\n }\n }\n}\n\ninterface VonageRestError {\n status?: number;\n response?: { status?: number };\n message?: string;\n}\n\nfunction mapVonageError(err: unknown): SendResult {\n const e = err as VonageRestError;\n const status = e.status ?? e.response?.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Vonage rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Vonage auth error\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Backend factory — picks the right impl from `opts.backend`.\n *\n * @internal\n */\n\nimport type { SMSBackend } from \"../backend-types.js\";\nimport type { SMSAdapterOptions } from \"../types.js\";\nimport { PlivoBackend } from \"./plivo.js\";\nimport { TwilioBackend } from \"./twilio.js\";\nimport { VonageBackend } from \"./vonage.js\";\n\nexport function createBackend(opts: SMSAdapterOptions): SMSBackend {\n switch (opts.backend) {\n case \"twilio\":\n return new TwilioBackend(opts);\n case \"plivo\":\n return new PlivoBackend(opts);\n case \"vonage\":\n return new VonageBackend(opts);\n default: {\n const _exhaustive: never = opts;\n throw new Error(`unknown backend: ${JSON.stringify(_exhaustive)}`);\n }\n }\n}\n","/**\n * Inbound normalization: `SMSInbound` → `SMSMessageEvent`.\n *\n * `from` and `to` are already E.164 (backend.parseInbound enforces this).\n * `channel.id` is `from` because SMS conversations are flat per-pair\n * (D394 — no threading).\n *\n * @internal\n */\n\nimport type { SMSMessageEvent } from \"@theokit/gateway\";\n\nimport type { SMSInbound } from \"./backend-types.js\";\n\nexport function inboundToMessageEvent(\n inbound: SMSInbound,\n backend: \"twilio\" | \"plivo\" | \"vonage\",\n): SMSMessageEvent {\n return {\n id: inbound.messageId,\n platform: \"sms\",\n sender: { id: inbound.from },\n channel: { id: inbound.from, type: \"dm\" },\n text: inbound.body,\n receivedAt: inbound.receivedAt,\n sms: {\n backend,\n messageId: inbound.messageId,\n from: inbound.from,\n to: inbound.to,\n raw: inbound.raw,\n },\n };\n}\n","/**\n * `splitForSMS` — grapheme-cluster-safe multipart segmentation (D393, EC-7).\n *\n * Concatenated SMS (UDH) on modern carriers reassemble at the recipient,\n * but each TCP/IP-layer chunk is one billed message. We segment at\n * 1600 chars (default) so the API call doesn't reject and each part is\n * prefixed with `(i/N) ` to allow manual reordering when carriers\n * deliver out of sequence (EC-7).\n *\n * Thin wrapper over core `chunkByGrapheme` (roadmap M1) — single-sources the\n * `Intl.Segmenter` grapheme walk so emoji (🇧🇷) and combining sequences are\n * never severed. The `(i/N) ` prefix (and its reserved width) stays here since\n * it is SMS-specific. Output is byte-identical to the previous implementation\n * (pinned by `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\n/**\n * Width of `\"(i/total) \"` when `i` has as many digits as `total` — the widest\n * the prefix can get for a given part count. `(99/99) ` is 8, `(100/126) ` is\n * 10, `(1000/1234) ` is 12.\n *\n * This used to be the constant 8, commented `\"(99/99) \" worst case`. It is the\n * worst case only below 100 parts; from the hundredth part on, every prefix\n * overflowed its reservation and each part exceeded the caller's declared cap\n * by 2 chars, which the provider rejects.\n */\nfunction prefixWidthFor(total: number): number {\n return 2 * String(total).length + 4;\n}\n\nexport function splitForSMS(text: string, limit = 1600): string[] {\n // Chicken and egg: the reservation depends on the part count, and the part\n // count depends on the reservation. Widening the prefix shrinks the payload,\n // which can push the count into another digit — so iterate to a fixed point.\n // It converges fast because the width grows with the LOGARITHM of the count;\n // the bound is a backstop against a pathological input, not the expected path.\n let reserved = prefixWidthFor(1);\n for (let pass = 0; pass < 8; pass += 1) {\n const partLimit = limit - reserved;\n if (partLimit <= 0) {\n throw new RangeError(\n `limit ${limit} is too small to carry an SMS part: the \"(i/N) \" prefix alone needs ${reserved} chars`,\n );\n }\n const parts = chunkByGrapheme(text, { limit, partLimit });\n if (parts.length <= 1) return parts; // short-circuit / single part: skip prefix\n const needed = prefixWidthFor(parts.length);\n if (needed <= reserved) {\n const total = parts.length;\n return parts.map((p, i) => `(${i + 1}/${total}) ${p}`);\n }\n reserved = needed;\n }\n /* c8 ignore next 3 -- unreachable: 8 passes cover part counts up to 10^8. */\n throw new RangeError(\n `could not settle the \"(i/N) \" prefix width for a ${text.length}-char message at limit ${limit}`,\n );\n}\n","/**\n * `SMSAdapter` — implements `BasePlatformAdapter` over a backend\n * (twilio / plivo / vonage). ADRs D389-D396.\n *\n * Lifecycle:\n * - `connect()` initializes the chosen backend (lazy peer-dep import).\n * - `disconnect()` releases the backend; idempotent.\n * - `sendMessage()` splits multipart (D393) and sends each part via backend.\n * - `onInbound(handler)` replaces previous handler (EC-H, mirror D276).\n *\n * Inbound dispatch is driven by the webhook server (`webhook-server.ts`)\n * which calls `adapter.dispatchInbound(ctx)` after signature verification.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\nimport { createBackend } from \"./backend/index.js\";\nimport type { SignatureContext, SMSBackend } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { inboundToMessageEvent } from \"./normalize.js\";\nimport { normalizeE164 } from \"./phone.js\";\nimport { splitForSMS } from \"./split.js\";\nimport type { SMSAdapterOptions } from \"./types.js\";\n\nexport class SMSAdapter extends BasePlatformAdapter {\n readonly platform = \"sms\" as const;\n private readonly backend: SMSBackend;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n private readonly defaultCountry: string | undefined;\n\n constructor(opts: SMSAdapterOptions) {\n super();\n // EC-1: refuse to operate without signing secret.\n const secret = secretFromOpts(opts);\n if (secret.length === 0) {\n throw new ConfigurationError({\n code: \"signing_secret_required\",\n message: `gateway-sms: backend=\"${opts.backend}\" requires a signing secret (would accept unsigned webhooks)`,\n });\n }\n this.defaultCountry = opts.defaultCountry;\n this.backend = createBackend(opts);\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n const ok = await this.backend.connect();\n this.connected = ok;\n return ok;\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n await this.backend.disconnect();\n this.connected = false;\n this.inboundHandler = undefined;\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n let toE164: string;\n try {\n toE164 = normalizeE164(out.channel.id, this.defaultCountry);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return { ok: false, error: { code: \"invalid_phone_number\", message: msg } };\n }\n const parts = splitForSMS(out.text);\n // Send sequentially so the recipient sees them in order; concurrent\n // submit would still cost the same but breaks ordering at carriers.\n let lastResult: SendResult | undefined;\n for (const part of parts) {\n lastResult = await this.backend.sendMessage(toE164, part);\n if (lastResult.ok !== true) {\n return {\n ok: false,\n error: {\n code: lastResult.error?.code ?? \"partial_send_failure\",\n message: `partial send failed after ${parts.indexOf(part)}/${parts.length}: ${lastResult.error?.message ?? \"unknown\"}`,\n },\n };\n }\n }\n return lastResult ?? { ok: false, error: { code: \"send_failed\", message: \"no parts sent\" } };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /**\n * Webhook hook — called by `createWebhookServer` AFTER signature\n * verification + parseInbound. Returns dispatch outcome (used for\n * 200/204 vs 500 by the webhook handler).\n *\n * @internal\n */\n async dispatchInbound(ctx: SignatureContext): Promise<\"ok\" | \"no_handler\" | \"parse_failed\"> {\n if (!this.backend.verifySignature(ctx)) {\n // Caller (webhook-server) inspects this via verifySignature directly,\n // but we re-check defensively if anyone calls dispatch directly.\n return \"parse_failed\";\n }\n let inbound: ReturnType<SMSBackend[\"parseInbound\"]>;\n try {\n inbound = this.backend.parseInbound(ctx);\n } catch {\n return \"parse_failed\";\n }\n if (this.inboundHandler === undefined) return \"no_handler\";\n const event = inboundToMessageEvent(inbound, this.backend.kind);\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /**\n * Direct signature check — used by the webhook server to respond\n * `401` BEFORE dispatch when signature is invalid.\n *\n * @internal\n */\n verifySignature(ctx: SignatureContext): boolean {\n return this.backend.verifySignature(ctx);\n }\n\n /**\n * Direct parse — used by the webhook server when signature was already\n * validated upstream. Returns the normalized `SMSMessageEvent` to be\n * dispatched.\n *\n * @internal\n */\n buildEventFromCtx(ctx: SignatureContext): GatewayMessageEvent {\n const inbound = this.backend.parseInbound(ctx);\n return inboundToMessageEvent(inbound, this.backend.kind);\n }\n\n /**\n * Dispatch a pre-built event (used by webhook server after manual\n * signature + parse). Honors EC-H replace semantics and isolates\n * handler exceptions per `gateway-runner` contract.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\"> {\n if (this.inboundHandler === undefined) return \"no_handler\";\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /** Backend kind (escape hatch for callers needing to introspect). */\n getBackendKind(): \"twilio\" | \"plivo\" | \"vonage\" {\n return this.backend.kind;\n }\n}\n\nfunction secretFromOpts(opts: SMSAdapterOptions): string {\n switch (opts.backend) {\n case \"twilio\":\n return opts.authToken;\n case \"plivo\":\n return opts.authToken;\n case \"vonage\":\n return opts.signatureSecret;\n default: {\n const _exhaustive: never = opts;\n void _exhaustive;\n return \"\";\n }\n }\n}\n","/**\n * `createWebhookServer` — Express helper for inbound SMS webhooks.\n *\n * Registers per-backend routes (`/sms/twilio`, `/sms/plivo`, `/sms/vonage`)\n * each with the matching parser middleware. All three:\n *\n * 1. Read the raw body verbatim (signature verification depends on the\n * exact bytes — even one extra `\\r\\n` invalidates the HMAC).\n * 2. Call `adapter.verifySignature(ctx)` → 401 if false.\n * 3. Call `adapter.buildEventFromCtx(ctx)` → `dispatchEvent(event)`.\n * 4. Return 204 No Content.\n *\n * Caller can pass an existing Express app (`opts.app`) or let the helper\n * create one. `start()` / `stop()` are idempotent.\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\nimport type { SMSAdapter } from \"./adapter.js\";\nimport type { SignatureContext } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: SMSAdapter;\n /** Mount path prefix; default `\"/sms\"`. The full path is `${path}/${backend}`. */\n readonly path?: string;\n /** Listen port. Ignored when `app` is provided. Default `3000`. */\n readonly port?: number;\n /** Inject an existing Express app instead of creating one. */\n readonly app?: Express;\n}\n\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n // Both ESM and CJS forms; normalize to { default }.\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-sms: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction buildSignatureContext(req: Request): SignatureContext {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const headers: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.headers)) {\n headers[k.toLowerCase()] = Array.isArray(v) ? v.join(\",\") : (v ?? \"\");\n }\n const protoHeader = headers[\"x-forwarded-proto\"];\n const proto = protoHeader ?? (req.secure ? \"https\" : \"http\");\n const host = req.get(\"host\") ?? \"localhost\";\n const url = `${proto}://${host}${req.originalUrl}`;\n return { headers, rawBody, url };\n}\n\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const prefix = opts.path ?? \"/sms\";\n const backend = opts.adapter.getBackendKind();\n\n // Raw-body capture middleware — must run BEFORE express.urlencoded/json,\n // since signature verification needs the exact byte sequence.\n const rawCapture = (req: Request, _res: Response, next: NextFunction) => {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response:\n // the provider times out and retries, and nothing is logged. Failing loudly\n // and continuing is strictly better — verification then refuses the empty\n // body with a 401, a visible symptom that points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway-sms] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n };\n\n const handler = (req: Request, res: Response): void => {\n const ctx = buildSignatureContext(req);\n if (!opts.adapter.verifySignature(ctx)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let event: ReturnType<typeof opts.adapter.buildEventFromCtx>;\n try {\n event = opts.adapter.buildEventFromCtx(ctx);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.status(400).type(\"text/plain\").send(`parse failed: ${msg}`);\n return;\n }\n void opts.adapter.dispatchEvent(event);\n // Twilio expects either TwiML or 204; 204 keeps things simple\n // and avoids accidentally double-replying.\n res.status(204).end();\n };\n\n app.post(`${prefix}/${backend}`, rawCapture, handler);\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n // When caller injected its own app, we don't manage the listener.\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/phone.ts","../src/backend/plivo.ts","../src/backend/twilio.ts","../src/backend/vonage.ts","../src/backend/index.ts","../src/normalize.ts","../src/split.ts","../src/adapter.ts","../src/webhook-server.ts"],"names":["parseFormUrlEncoded"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-sms` (D389-D396).\n *\n * - `ConfigurationError` — programmer error at construction time\n * (missing signing secret, missing backend SDK install, malformed\n * phone number on outbound). Thrown synchronously.\n * - `BackendNotInstalledError` — peer-dep optional backend (twilio /\n * plivo / @vonage/server-sdk) was selected but the npm package is\n * not installed. Carries actionable install hint.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2); the SDK still consumes structured errors via\n * `metadata.code`. Behavior byte-identical (pinned by `tests/errors.test.ts`).\n *\n * @internal — re-exported by `src/index.ts`.\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-sms\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-sms\", opts);\n }\n}\n\n/**\n * The provider SDK for the selected backend is not installed.\n *\n * `gateway-sms` speaks to Twilio, Plivo or Vonage, and declares all three as optional peers — a\n * project installs only the one it uses. Selecting a backend whose SDK is absent is caught here, at\n * connect time, with the package name and the command that installs it.\n */\nexport class BackendNotInstalledError extends ConfigurationError {\n constructor(backend: \"twilio\" | \"plivo\" | \"vonage\", pkgName: string) {\n super({\n code: \"backend_not_installed\",\n message: `gateway-sms: peer-dep \"${pkgName}\" not installed but backend=\"${backend}\" was selected. Run: pnpm add ${pkgName}`,\n detail: pkgName,\n });\n }\n}\n","/**\n * E.164 phone normalization (D391, EC-6).\n *\n * Wraps `libphonenumber-js` (full — accepts mobile + toll-free; the\n * `/mobile` sub-bundle was inadequate because it rejects toll-free\n * US 1-800 numbers).\n *\n * @internal\n */\n\nimport { parsePhoneNumberFromString } from \"libphonenumber-js\";\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/**\n * Normalize a free-form phone number to canonical E.164 (`+5511999999999`).\n *\n * Accepts:\n * - International with `+`: `\"+5511999999999\"` → unchanged.\n * - National without `+` when `defaultCountry` is provided: `(\"11999999999\", \"BR\")` → `\"+5511999999999\"`.\n * - Toll-free US (EC-6): `\"+18001234567\"` → unchanged.\n *\n * Throws `ConfigurationError({ code: \"invalid_phone_number\" })` on any\n * input that cannot be parsed to a valid number.\n */\nexport function normalizeE164(input: string, defaultCountry?: string): string {\n if (input.length === 0) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: \"gateway-sms: phone number is empty\",\n detail: \"<empty>\",\n });\n }\n const parsed = parsePhoneNumberFromString(\n input,\n defaultCountry as Parameters<typeof parsePhoneNumberFromString>[1],\n );\n if (parsed === undefined || !parsed.isValid()) {\n throw new ConfigurationError({\n code: \"invalid_phone_number\",\n message: `gateway-sms: invalid phone number ${JSON.stringify(input)}`,\n detail: input,\n });\n }\n return parsed.format(\"E.164\");\n}\n","/**\n * Plivo backend impl.\n *\n * - SDK: `plivo` (peer-dep, optional).\n * - Signature: `X-Plivo-Signature-V3` is HMAC-SHA256 of the request URL\n * + nonce + body. `validateV3Signature` is exposed by the SDK; we\n * delegate to avoid reimplementation.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { PlivoOptions } from \"../types.js\";\n\ninterface PlivoCreateResponse {\n apiId?: string;\n messageUuid?: string[];\n message_uuid?: string[];\n}\n\ninterface PlivoClient {\n messages: {\n // The actual SDK uses positional args: create(src, dst, text, ...).\n create(src: string, dst: string, text: string): Promise<PlivoCreateResponse>;\n };\n}\n\ninterface PlivoModule {\n Client: new (authId?: string, authToken?: string) => PlivoClient;\n // Real SDK signature: validateV3Signature(method, uri, nonce, authToken, v3Signature)\n validateV3Signature?: (\n method: string,\n uri: string,\n nonce: string,\n authToken: string,\n signature: string,\n ) => boolean;\n}\n\nasync function loadPlivo(): Promise<PlivoModule> {\n try {\n // Plivo's published types are stricter (positional args) than our\n // generic mock; we narrow at call sites and pass through unknown.\n const mod = (await import(\"plivo\")) as unknown as PlivoModule;\n return mod;\n } catch {\n throw new BackendNotInstalledError(\"plivo\", \"plivo\");\n }\n}\n\nexport class PlivoBackend implements SMSBackend {\n readonly kind = \"plivo\" as const;\n private mod: PlivoModule | undefined;\n private client: PlivoClient | undefined;\n\n constructor(private readonly opts: PlivoOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.mod = await loadPlivo();\n this.client = new this.mod.Client(this.opts.authId, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.mod?.validateV3Signature === undefined) return false;\n const signature = ctx.headers[\"x-plivo-signature-v3\"];\n const nonce = ctx.headers[\"x-plivo-signature-v3-nonce\"];\n if (signature === undefined || nonce === undefined) return false;\n try {\n return this.mod.validateV3Signature(\"POST\", ctx.url, nonce, this.opts.authToken, signature);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let params: Record<string, string> = {};\n // Plivo posts JSON or form-encoded depending on application config.\n if ((ctx.headers[\"content-type\"] ?? \"\").includes(\"application/json\")) {\n try {\n params = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n params = {};\n }\n } else {\n params = parseFormUrlEncoded(ctx.rawBody);\n }\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Text ?? params.text ?? \"\",\n messageId: params.MessageUUID ?? params.message_uuid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"PlivoBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.client.messages.create(this.opts.fromNumber, to, body);\n const id = resp.messageUuid?.[0] ?? resp.message_uuid?.[0] ?? resp.apiId ?? \"\";\n return { ok: true, messageId: id };\n } catch (err) {\n return mapPlivoError(err);\n }\n }\n}\n\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface PlivoRestError {\n statusCode?: number;\n status?: number;\n message?: string;\n}\n\nfunction mapPlivoError(err: unknown): SendResult {\n const e = err as PlivoRestError;\n const status = e.statusCode ?? e.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Plivo rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Plivo auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Plivo rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Twilio backend impl.\n *\n * - SDK: `twilio` (peer-dep, optional). Loaded lazily so packages\n * that pick other backends don't pay the cost.\n * - Signature: `X-Twilio-Signature` is HMAC-SHA1 of `(fullUrl + sortedParams)`.\n * We delegate to `twilio.validateRequest` so we don't reimplement.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { TwilioOptions } from \"../types.js\";\n\ninterface TwilioCreateArgs {\n from: string;\n to: string;\n body: string;\n}\n\ninterface TwilioMessageInstance {\n sid: string;\n status?: string;\n}\n\ninterface TwilioClientInstance {\n messages: {\n create(args: TwilioCreateArgs): Promise<TwilioMessageInstance>;\n };\n}\n\ninterface TwilioFactory {\n (accountSid: string, authToken: string): TwilioClientInstance;\n validateRequest(\n authToken: string,\n signature: string,\n url: string,\n params: Record<string, string>,\n ): boolean;\n}\n\nasync function loadTwilio(): Promise<TwilioFactory> {\n try {\n const mod = await import(\"twilio\");\n // ESM ships { default: factory }; CJS ships factory.\n const candidate =\n (mod as { default?: TwilioFactory }).default ?? (mod as unknown as TwilioFactory);\n return candidate;\n } catch {\n throw new BackendNotInstalledError(\"twilio\", \"twilio\");\n }\n}\n\nexport class TwilioBackend implements SMSBackend {\n readonly kind = \"twilio\" as const;\n private client: TwilioClientInstance | undefined;\n private twilio: TwilioFactory | undefined;\n\n constructor(private readonly opts: TwilioOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.client !== undefined) return true;\n this.twilio = await loadTwilio();\n this.client = this.twilio(this.opts.accountSid, this.opts.authToken);\n return true;\n }\n\n async disconnect(): Promise<void> {\n // No persistent connection — REST client is GC'd on dereference.\n this.client = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n if (this.twilio === undefined) return false;\n const signature = ctx.headers[\"x-twilio-signature\"];\n if (signature === undefined) return false;\n const params = parseFormUrlEncoded(ctx.rawBody);\n try {\n return this.twilio.validateRequest(this.opts.authToken, signature, ctx.url, params);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n const params = parseFormUrlEncoded(ctx.rawBody);\n return {\n from: normalizeE164(params.From ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(params.To ?? \"\", this.opts.defaultCountry),\n body: params.Body ?? \"\",\n messageId: params.MessageSid ?? params.SmsMessageSid ?? \"\",\n receivedAt: Date.now(),\n raw: params,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"TwilioBackend.connect() not called\" },\n };\n }\n try {\n const msg = await this.client.messages.create({ from: this.opts.fromNumber, to, body });\n return { ok: true, messageId: msg.sid };\n } catch (err) {\n return mapTwilioError(err);\n }\n }\n}\n\n/**\n * Parse `application/x-www-form-urlencoded` request body to a flat\n * `Record<string, string>`. Twilio POSTs in this format.\n *\n * @internal\n */\nfunction parseFormUrlEncoded(body: string): Record<string, string> {\n const params: Record<string, string> = {};\n for (const pair of body.split(\"&\")) {\n if (pair.length === 0) continue;\n const eqIdx = pair.indexOf(\"=\");\n const k = eqIdx < 0 ? pair : pair.slice(0, eqIdx);\n const v = eqIdx < 0 ? \"\" : pair.slice(eqIdx + 1);\n params[decodeURIComponent(k.replace(/\\+/g, \" \"))] = decodeURIComponent(v.replace(/\\+/g, \" \"));\n }\n return params;\n}\n\ninterface TwilioRestError {\n status?: number;\n code?: number | string;\n message?: string;\n}\n\nfunction mapTwilioError(err: unknown): SendResult {\n const e = err as TwilioRestError;\n const status = e.status ?? 0;\n if (status === 429) {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Twilio rate limit\" } };\n }\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Twilio auth error\" },\n };\n }\n if (status === 400) {\n return {\n ok: false,\n error: { code: \"invalid_request\", message: e.message ?? \"Twilio rejected request\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Vonage backend impl.\n *\n * - SDK: `@vonage/server-sdk` (peer-dep, optional).\n * - Signature: `Authorization: Bearer <JWT>` signed with the Signature\n * Secret (NOT the API secret). The SDK exposes `Auth.verifySignature`\n * for this purpose.\n *\n * @internal\n */\n\nimport type { SendResult } from \"@theokit/gateway\";\nimport type { SignatureContext, SMSBackend, SMSInbound } from \"../backend-types.js\";\nimport { BackendNotInstalledError } from \"../errors.js\";\nimport { normalizeE164 } from \"../phone.js\";\nimport type { VonageOptions } from \"../types.js\";\n\ninterface VonageSmsClient {\n send(args: { to: string; from: string; text: string }): Promise<{\n messages?: Array<{ \"message-id\"?: string; messageId?: string; status?: string }>;\n }>;\n}\n\ninterface VonageInstance {\n sms: VonageSmsClient;\n}\n\ninterface VonageModule {\n Vonage: new (creds: {\n apiKey: string;\n apiSecret: string;\n signatureSecret?: string;\n }) => VonageInstance;\n Auth?: {\n verifySignature?: (token: string, secret: string) => boolean;\n };\n}\n\nasync function loadVonage(): Promise<VonageModule> {\n try {\n // SDK ships ESM/CJS variants; we narrow at call sites and pass through.\n const raw = await import(\"@vonage/server-sdk\");\n return raw as unknown as VonageModule;\n } catch {\n throw new BackendNotInstalledError(\"vonage\", \"@vonage/server-sdk\");\n }\n}\n\nexport class VonageBackend implements SMSBackend {\n readonly kind = \"vonage\" as const;\n private mod: VonageModule | undefined;\n private vonage: VonageInstance | undefined;\n\n constructor(private readonly opts: VonageOptions) {}\n\n async connect(): Promise<boolean> {\n if (this.vonage !== undefined) return true;\n this.mod = await loadVonage();\n this.vonage = new this.mod.Vonage({\n apiKey: this.opts.apiKey,\n apiSecret: this.opts.apiSecret,\n signatureSecret: this.opts.signatureSecret,\n });\n return true;\n }\n\n async disconnect(): Promise<void> {\n this.vonage = undefined;\n }\n\n verifySignature(ctx: SignatureContext): boolean {\n const auth = ctx.headers.authorization;\n if (auth === undefined) return false;\n const m = auth.match(/^Bearer\\s+(.+)$/i);\n if (m === null) return false;\n const token = m[1] ?? \"\";\n if (token.length === 0) return false;\n if (this.mod?.Auth?.verifySignature === undefined) return false;\n try {\n return this.mod.Auth.verifySignature(token, this.opts.signatureSecret);\n } catch {\n return false;\n }\n }\n\n parseInbound(ctx: SignatureContext): SMSInbound {\n let payload: Record<string, string> = {};\n try {\n payload = JSON.parse(ctx.rawBody) as Record<string, string>;\n } catch {\n payload = {};\n }\n return {\n from: normalizeE164(payload.msisdn ?? payload.from ?? \"\", this.opts.defaultCountry),\n to: normalizeE164(payload.to ?? \"\", this.opts.defaultCountry),\n body: payload.text ?? \"\",\n messageId: payload.messageId ?? payload[\"message-id\"] ?? \"\",\n receivedAt: Date.now(),\n raw: payload,\n };\n }\n\n async sendMessage(to: string, body: string): Promise<SendResult> {\n if (this.vonage === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"VonageBackend.connect() not called\" },\n };\n }\n try {\n const resp = await this.vonage.sms.send({ from: this.opts.fromNumber, to, text: body });\n const msg = resp.messages?.[0];\n const id = msg?.[\"message-id\"] ?? msg?.messageId ?? \"\";\n if (msg?.status !== undefined && msg.status !== \"0\") {\n return {\n ok: false,\n error: { code: \"send_failed\", message: `Vonage returned status=${msg.status}` },\n };\n }\n return { ok: true, messageId: id };\n } catch (err) {\n return mapVonageError(err);\n }\n }\n}\n\ninterface VonageRestError {\n status?: number;\n response?: { status?: number };\n message?: string;\n}\n\nfunction mapVonageError(err: unknown): SendResult {\n const e = err as VonageRestError;\n const status = e.status ?? e.response?.status ?? 0;\n if (status === 429)\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Vonage rate limit\" } };\n if (status === 401 || status === 403) {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Vonage auth error\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n","/**\n * Backend factory — picks the right impl from `opts.backend`.\n *\n * @internal\n */\n\nimport type { SMSBackend } from \"../backend-types.js\";\nimport type { SMSAdapterOptions } from \"../types.js\";\nimport { PlivoBackend } from \"./plivo.js\";\nimport { TwilioBackend } from \"./twilio.js\";\nimport { VonageBackend } from \"./vonage.js\";\n\nexport function createBackend(opts: SMSAdapterOptions): SMSBackend {\n switch (opts.backend) {\n case \"twilio\":\n return new TwilioBackend(opts);\n case \"plivo\":\n return new PlivoBackend(opts);\n case \"vonage\":\n return new VonageBackend(opts);\n default: {\n const _exhaustive: never = opts;\n throw new Error(`unknown backend: ${JSON.stringify(_exhaustive)}`);\n }\n }\n}\n","/**\n * Inbound normalization: `SMSInbound` → `SMSMessageEvent`.\n *\n * `from` and `to` are already E.164 (backend.parseInbound enforces this).\n * `channel.id` is `from` because SMS conversations are flat per-pair\n * (D394 — no threading).\n *\n * @internal\n */\n\nimport type { SMSMessageEvent } from \"@theokit/gateway\";\n\nimport type { SMSInbound } from \"./backend-types.js\";\n\nexport function inboundToMessageEvent(\n inbound: SMSInbound,\n backend: \"twilio\" | \"plivo\" | \"vonage\",\n): SMSMessageEvent {\n return {\n id: inbound.messageId,\n platform: \"sms\",\n sender: { id: inbound.from },\n channel: { id: inbound.from, type: \"dm\" },\n text: inbound.body,\n receivedAt: inbound.receivedAt,\n sms: {\n backend,\n messageId: inbound.messageId,\n from: inbound.from,\n to: inbound.to,\n raw: inbound.raw,\n },\n };\n}\n","/**\n * `splitForSMS` — grapheme-cluster-safe multipart segmentation (D393, EC-7).\n *\n * Concatenated SMS (UDH) on modern carriers reassemble at the recipient,\n * but each TCP/IP-layer chunk is one billed message. We segment at\n * 1600 chars (default) so the API call doesn't reject and each part is\n * prefixed with `(i/N) ` to allow manual reordering when carriers\n * deliver out of sequence (EC-7).\n *\n * Thin wrapper over core `chunkByGrapheme` (roadmap M1) — single-sources the\n * `Intl.Segmenter` grapheme walk so emoji (🇧🇷) and combining sequences are\n * never severed. The `(i/N) ` prefix (and its reserved width) stays here since\n * it is SMS-specific. Output is byte-identical to the previous implementation\n * (pinned by `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkByGrapheme } from \"@theokit/gateway\";\n\n/**\n * Width of `\"(i/total) \"` when `i` has as many digits as `total` — the widest\n * the prefix can get for a given part count. `(99/99) ` is 8, `(100/126) ` is\n * 10, `(1000/1234) ` is 12.\n *\n * This used to be the constant 8, commented `\"(99/99) \" worst case`. It is the\n * worst case only below 100 parts; from the hundredth part on, every prefix\n * overflowed its reservation and each part exceeded the caller's declared cap\n * by 2 chars, which the provider rejects.\n */\nfunction prefixWidthFor(total: number): number {\n return 2 * String(total).length + 4;\n}\n\nexport function splitForSMS(text: string, limit = 1600): string[] {\n // Chicken and egg: the reservation depends on the part count, and the part\n // count depends on the reservation. Widening the prefix shrinks the payload,\n // which can push the count into another digit — so iterate to a fixed point.\n // It converges fast because the width grows with the LOGARITHM of the count;\n // the bound is a backstop against a pathological input, not the expected path.\n let reserved = prefixWidthFor(1);\n for (let pass = 0; pass < 8; pass += 1) {\n const partLimit = limit - reserved;\n if (partLimit <= 0) {\n throw new RangeError(\n `limit ${limit} is too small to carry an SMS part: the \"(i/N) \" prefix alone needs ${reserved} chars`,\n );\n }\n const parts = chunkByGrapheme(text, { limit, partLimit });\n if (parts.length <= 1) return parts; // short-circuit / single part: skip prefix\n const needed = prefixWidthFor(parts.length);\n if (needed <= reserved) {\n const total = parts.length;\n return parts.map((p, i) => `(${i + 1}/${total}) ${p}`);\n }\n reserved = needed;\n }\n /* c8 ignore next 3 -- unreachable: 8 passes cover part counts up to 10^8. */\n throw new RangeError(\n `could not settle the \"(i/N) \" prefix width for a ${text.length}-char message at limit ${limit}`,\n );\n}\n","/**\n * `SMSAdapter` — implements `BasePlatformAdapter` over a backend\n * (twilio / plivo / vonage). ADRs D389-D396.\n *\n * Lifecycle:\n * - `connect()` initializes the chosen backend (lazy peer-dep import).\n * - `disconnect()` releases the backend; idempotent.\n * - `sendMessage()` splits multipart (D393) and sends each part via backend.\n * - `onInbound(handler)` replaces previous handler (EC-H, mirror D276).\n *\n * Inbound dispatch is driven by the webhook server (`webhook-server.ts`)\n * which calls `adapter.dispatchInbound(ctx)` after signature verification.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\nimport { createBackend } from \"./backend/index.js\";\nimport type { SignatureContext, SMSBackend } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { inboundToMessageEvent } from \"./normalize.js\";\nimport { normalizeE164 } from \"./phone.js\";\nimport { splitForSMS } from \"./split.js\";\nimport type { SMSAdapterOptions } from \"./types.js\";\n\nexport class SMSAdapter extends BasePlatformAdapter {\n readonly platform = \"sms\" as const;\n private readonly backend: SMSBackend;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private connected = false;\n private readonly defaultCountry: string | undefined;\n\n constructor(opts: SMSAdapterOptions) {\n super();\n // EC-1: refuse to operate without signing secret.\n const secret = secretFromOpts(opts);\n if (secret.length === 0) {\n throw new ConfigurationError({\n code: \"signing_secret_required\",\n message: `gateway-sms: backend=\"${opts.backend}\" requires a signing secret (would accept unsigned webhooks)`,\n });\n }\n this.defaultCountry = opts.defaultCountry;\n this.backend = createBackend(opts);\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n const ok = await this.backend.connect();\n this.connected = ok;\n return ok;\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n await this.backend.disconnect();\n this.connected = false;\n this.inboundHandler = undefined;\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n let toE164: string;\n try {\n toE164 = normalizeE164(out.channel.id, this.defaultCountry);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n return { ok: false, error: { code: \"invalid_phone_number\", message: msg } };\n }\n const parts = splitForSMS(out.text);\n // Send sequentially so the recipient sees them in order; concurrent\n // submit would still cost the same but breaks ordering at carriers.\n let lastResult: SendResult | undefined;\n for (const part of parts) {\n lastResult = await this.backend.sendMessage(toE164, part);\n if (lastResult.ok !== true) {\n return {\n ok: false,\n error: {\n code: lastResult.error?.code ?? \"partial_send_failure\",\n message: `partial send failed after ${parts.indexOf(part)}/${parts.length}: ${lastResult.error?.message ?? \"unknown\"}`,\n },\n };\n }\n }\n return lastResult ?? { ok: false, error: { code: \"send_failed\", message: \"no parts sent\" } };\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /**\n * Webhook hook — called by `createWebhookServer` AFTER signature\n * verification + parseInbound. Returns dispatch outcome (used for\n * 200/204 vs 500 by the webhook handler).\n *\n * @internal\n */\n async dispatchInbound(ctx: SignatureContext): Promise<\"ok\" | \"no_handler\" | \"parse_failed\"> {\n if (!this.backend.verifySignature(ctx)) {\n // Caller (webhook-server) inspects this via verifySignature directly,\n // but we re-check defensively if anyone calls dispatch directly.\n return \"parse_failed\";\n }\n let inbound: ReturnType<SMSBackend[\"parseInbound\"]>;\n try {\n inbound = this.backend.parseInbound(ctx);\n } catch {\n return \"parse_failed\";\n }\n if (this.inboundHandler === undefined) return \"no_handler\";\n const event = inboundToMessageEvent(inbound, this.backend.kind);\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /**\n * Direct signature check — used by the webhook server to respond\n * `401` BEFORE dispatch when signature is invalid.\n *\n * @internal\n */\n verifySignature(ctx: SignatureContext): boolean {\n return this.backend.verifySignature(ctx);\n }\n\n /**\n * Direct parse — used by the webhook server when signature was already\n * validated upstream. Returns the normalized `SMSMessageEvent` to be\n * dispatched.\n *\n * @internal\n */\n buildEventFromCtx(ctx: SignatureContext): GatewayMessageEvent {\n const inbound = this.backend.parseInbound(ctx);\n return inboundToMessageEvent(inbound, this.backend.kind);\n }\n\n /**\n * Dispatch a pre-built event (used by webhook server after manual\n * signature + parse). Honors EC-H replace semantics and isolates\n * handler exceptions per `gateway-runner` contract.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\"> {\n if (this.inboundHandler === undefined) return \"no_handler\";\n try {\n await this.inboundHandler(event);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] handler threw: ${msg}\\n`);\n }\n return \"ok\";\n }\n\n /** Backend kind (escape hatch for callers needing to introspect). */\n getBackendKind(): \"twilio\" | \"plivo\" | \"vonage\" {\n return this.backend.kind;\n }\n}\n\nfunction secretFromOpts(opts: SMSAdapterOptions): string {\n switch (opts.backend) {\n case \"twilio\":\n return opts.authToken;\n case \"plivo\":\n return opts.authToken;\n case \"vonage\":\n return opts.signatureSecret;\n default: {\n const _exhaustive: never = opts;\n void _exhaustive;\n return \"\";\n }\n }\n}\n","/**\n * `createWebhookServer` — Express helper for inbound SMS webhooks.\n *\n * Registers per-backend routes (`/sms/twilio`, `/sms/plivo`, `/sms/vonage`)\n * each with the matching parser middleware. All three:\n *\n * 1. Read the raw body verbatim (signature verification depends on the\n * exact bytes — even one extra `\\r\\n` invalidates the HMAC).\n * 2. Call `adapter.verifySignature(ctx)` → 401 if false.\n * 3. Call `adapter.buildEventFromCtx(ctx)` → `dispatchEvent(event)`.\n * 4. Return 204 No Content.\n *\n * Caller can pass an existing Express app (`opts.app`) or let the helper\n * create one. `start()` / `stop()` are idempotent.\n *\n * @public\n */\n\nimport type { Express, NextFunction, Request, Response } from \"express\";\nimport type { SMSAdapter } from \"./adapter.js\";\nimport type { SignatureContext } from \"./backend-types.js\";\nimport { ConfigurationError } from \"./errors.js\";\n\nexport interface WebhookServerOptions {\n readonly adapter: SMSAdapter;\n /** Mount path prefix; default `\"/sms\"`. The full path is `${path}/${backend}`. */\n readonly path?: string;\n /** Listen port. Ignored when `app` is provided. Default `3000`. */\n readonly port?: number;\n /** Inject an existing Express app instead of creating one. */\n readonly app?: Express;\n}\n\n/** A started HTTP listener, with the handle needed to shut it down again. */\nexport interface WebhookServer {\n start(): Promise<void>;\n stop(): Promise<void>;\n}\n\nasync function loadExpress(): Promise<{ default: () => Express }> {\n try {\n const mod = await import(\"express\");\n // Both ESM and CJS forms; normalize to { default }.\n const fn = (mod as { default?: () => Express }).default ?? (mod as unknown as () => Express);\n return { default: fn };\n } catch {\n throw new ConfigurationError({\n code: \"express_not_installed\",\n message: 'gateway-sms: peer-dep \"express\" not installed. Run: pnpm add express',\n });\n }\n}\n\nfunction buildSignatureContext(req: Request): SignatureContext {\n const rawBody = (req as Request & { rawBody?: string }).rawBody ?? \"\";\n const headers: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.headers)) {\n headers[k.toLowerCase()] = Array.isArray(v) ? v.join(\",\") : (v ?? \"\");\n }\n const protoHeader = headers[\"x-forwarded-proto\"];\n const proto = protoHeader ?? (req.secure ? \"https\" : \"http\");\n const host = req.get(\"host\") ?? \"localhost\";\n const url = `${proto}://${host}${req.originalUrl}`;\n return { headers, rawBody, url };\n}\n\n/**\n * Build the HTTP listener that receives the provider's inbound-SMS callbacks.\n *\n * The provider dials in, so this endpoint must be reachable over public HTTPS and registered in the\n * provider console — inbound cannot work behind a firewall. `express` is loaded lazily, so a project\n * that only sends messages never pays for it.\n */\nexport async function createWebhookServer(opts: WebhookServerOptions): Promise<WebhookServer> {\n const expressMod = await loadExpress();\n const app: Express = opts.app ?? expressMod.default();\n const prefix = opts.path ?? \"/sms\";\n const backend = opts.adapter.getBackendKind();\n\n // Raw-body capture middleware — must run BEFORE express.urlencoded/json,\n // since signature verification needs the exact byte sequence.\n const rawCapture = (req: Request, _res: Response, next: NextFunction) => {\n // Someone else already drained the stream — a global `express.json()` or\n // `express.urlencoded()` mounted ahead of this router is the usual cause.\n // Without this branch, `req.on(\"end\")` never fires for a stream that already\n // ended, `next()` is never called, and the request HANGS with no response:\n // the provider times out and retries, and nothing is logged. Failing loudly\n // and continuing is strictly better — verification then refuses the empty\n // body with a 401, a visible symptom that points at the real cause.\n if (req.readableEnded || req.complete) {\n process.stderr.write(\n \"[gateway-sms] raw body already consumed before signature capture — mount this router \" +\n \"BEFORE any global body parser, or signature verification cannot see the bytes it \" +\n \"must hash\\n\",\n );\n (req as Request & { rawBody: string }).rawBody = \"\";\n next();\n return;\n }\n let buf = \"\";\n req.setEncoding(\"utf8\");\n req.on(\"data\", (chunk: string) => {\n buf += chunk;\n });\n req.on(\"end\", () => {\n (req as Request & { rawBody: string }).rawBody = buf;\n next();\n });\n req.on(\"error\", (err) => next(err));\n };\n\n const handler = (req: Request, res: Response): void => {\n const ctx = buildSignatureContext(req);\n if (!opts.adapter.verifySignature(ctx)) {\n res.status(401).type(\"text/plain\").send(\"invalid signature\");\n return;\n }\n let event: ReturnType<typeof opts.adapter.buildEventFromCtx>;\n try {\n event = opts.adapter.buildEventFromCtx(ctx);\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n res.status(400).type(\"text/plain\").send(`parse failed: ${msg}`);\n return;\n }\n // Same contract as the LINE server: the provider is answered before the handler runs, so a\n // slow handler cannot become a provider retry. That makes the dispatch floated, and a floated\n // rejection ends the process — so it is caught here rather than left to the runtime (#41).\n void opts.adapter.dispatchEvent(event).catch((err: unknown) => {\n const message = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-sms] webhook dispatch failed: ${message}\\n`);\n });\n // Twilio expects either TwiML or 204; 204 keeps things simple\n // and avoids accidentally double-replying.\n res.status(204).end();\n };\n\n app.post(`${prefix}/${backend}`, rawCapture, handler);\n\n let server: import(\"node:http\").Server | undefined;\n let started = false;\n let stopped = false;\n\n return {\n async start(): Promise<void> {\n if (started || opts.app !== undefined) {\n // When caller injected its own app, we don't manage the listener.\n started = true;\n return;\n }\n const port = opts.port ?? 3000;\n await new Promise<void>((resolve) => {\n server = app.listen(port, () => resolve());\n });\n started = true;\n },\n async stop(): Promise<void> {\n if (stopped) return;\n stopped = true;\n if (server === undefined) return;\n await new Promise<void>((resolve) => {\n server?.close(() => resolve());\n });\n server = undefined;\n },\n };\n}\n"]}
|
package/package.json
CHANGED
|
@@ -1,8 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@theokit/gateway-sms",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.4",
|
|
4
4
|
"description": "SMS platform adapter for @theokit/gateway. Multi-backend (Twilio + Plivo + Vonage). ADRs D389-D396.",
|
|
5
5
|
"license": "Apache-2.0",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/usetheokit/theokit-gateways.git",
|
|
9
|
+
"directory": "packages/gateway-sms"
|
|
10
|
+
},
|
|
6
11
|
"type": "module",
|
|
7
12
|
"engines": {
|
|
8
13
|
"node": ">=22.12.0"
|
|
@@ -30,13 +35,12 @@
|
|
|
30
35
|
"CHANGELOG.md"
|
|
31
36
|
],
|
|
32
37
|
"peerDependencies": {
|
|
33
|
-
"@theokit/
|
|
38
|
+
"@theokit/gateway": ">=0.6.0 <1.0.0",
|
|
34
39
|
"@vonage/server-sdk": "^3.0.0",
|
|
35
40
|
"express": "^4.18.0",
|
|
36
41
|
"libphonenumber-js": "^1.10.0",
|
|
37
42
|
"plivo": "^4.0.0",
|
|
38
|
-
"twilio": "^5.0.0"
|
|
39
|
-
"@theokit/gateway": "^0.5.1"
|
|
43
|
+
"twilio": "^5.0.0"
|
|
40
44
|
},
|
|
41
45
|
"peerDependenciesMeta": {
|
|
42
46
|
"twilio": {
|
|
@@ -53,7 +57,7 @@
|
|
|
53
57
|
}
|
|
54
58
|
},
|
|
55
59
|
"devDependencies": {
|
|
56
|
-
"@theokit/sdk": "^
|
|
60
|
+
"@theokit/sdk": "^4.53.1",
|
|
57
61
|
"@types/express": "^4.17.0",
|
|
58
62
|
"@vonage/server-sdk": "^3.0.0",
|
|
59
63
|
"express": "^4.18.0",
|
|
@@ -64,7 +68,11 @@
|
|
|
64
68
|
"typescript": "^5.8.0",
|
|
65
69
|
"vitest": "^4.1.8",
|
|
66
70
|
"zod": "^4.0.0",
|
|
67
|
-
"@theokit/gateway": "0.
|
|
71
|
+
"@theokit/gateway": "0.7.0"
|
|
72
|
+
},
|
|
73
|
+
"publishConfig": {
|
|
74
|
+
"access": "public",
|
|
75
|
+
"provenance": true
|
|
68
76
|
},
|
|
69
77
|
"scripts": {
|
|
70
78
|
"build": "tsup",
|