@abwaters/cicd-plugin-twilio 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bryan Waters
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,68 @@
+# @abwaters/cicd-plugin-twilio
+
+[![CI](https://img.shields.io/github/actions/workflow/status/abwaters/cicd-plugin-twilio/ci.yml?branch=main&label=CI)](https://github.com/abwaters/cicd-plugin-twilio/actions/workflows/ci.yml)
+[![Version](https://img.shields.io/github/package-json/v/abwaters/cicd-plugin-twilio)](https://github.com/abwaters/cicd-plugin-twilio/blob/main/package.json)
+[![License](https://img.shields.io/github/license/abwaters/cicd-plugin-twilio)](LICENSE)
+
+Twilio webhook plugin for [`@abwaters/cicd`](https://github.com/abwaters/cicd).
+
+During `deploy` and `rollback`, this plugin points a Twilio phone number's SMS webhook (or a messaging service's inbound webhook) at the deployed API Gateway URL for the stage. During `info --verbose`, it reports the current webhook configuration.
+
+## Install
+
+```bash
+npm install @abwaters/cicd-plugin-twilio
+```
+
+The package is published to both the public **npm registry** and **GitHub Packages**.
+
+Installing from npm works with no extra configuration. To install from GitHub Packages instead, point the `@abwaters` scope at it in your `~/.npmrc` (or project `.npmrc`):
+
+```
+@abwaters:registry=https://npm.pkg.github.com
+```
+
+Then add it to your `cicd.json`:
+
+```json
+{
+  "plugins": ["@abwaters/cicd-plugin-twilio"],
+  "stages": [
+    {
+      "stage": "prod",
+      "mapping": { "domain": "api.example.com", "path": "" },
+      "twilio": {
+        "messagingSid": "MGxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+        "smsWebhookApi": "myapp-sms-api"
+      }
+    }
+  ]
+}
+```
+
+`messagingSid` accepts a Twilio phone number SID (`PN...`) or a messaging service SID (`MG...`), and supports the standard `!ImportValue`, `!ParameterStore`, and `!SetEnv` prefixes for runtime resolution.
+
+`smsWebhookApi` must be the `name` of an `api` export in `cicd.json`; the plugin composes the webhook URL from that API's stage mapping.
+
+## Credentials
+
+Set in the environment of whoever runs `cicd deploy`:
+
+```
+TWILIO_ACCOUNT_SID=AC...
+TWILIO_AUTH_TOKEN=...
+```
+
+If either is missing, the plugin logs a verbose-mode skip and does nothing — useful for stages that aren't using Twilio.
+
+## CLI flags
+
+- `--no-twilio` — skip the plugin for a single invocation, even when listed
+- `--env`, `--api`, `--sns`, `--sqs`, `--workers`, `--web` — all auto-skip plugins (existing core behavior)
+
+## Build
+
+```bash
+npm install
+npm run build
+```

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import type { CICDPlugin } from '@abwaters/cicd';
+import { TwilioStageConfig } from './types';
+declare const plugin: CICDPlugin;
+export default plugin;
+export { TwilioStageConfig };

package/dist/index.js

@@ -0,0 +1,174 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const sdk = __importStar(require("./twilio-sdk"));
+const schema_1 = require("./schema");
+async function resolveSid(ctx, raw) {
+    if (raw.startsWith('!')) {
+        const resolved = await ctx.resolveVariable(raw);
+        if (!resolved)
+            return null;
+        return resolved;
+    }
+    return raw;
+}
+function getCreds(ctx) {
+    const accountSid = ctx.env.TWILIO_ACCOUNT_SID;
+    const authToken = ctx.env.TWILIO_AUTH_TOKEN;
+    if (!accountSid || !authToken)
+        return null;
+    return { accountSid, authToken };
+}
+async function deployHandler(ctx) {
+    const cfg = ctx.pluginConfig;
+    if (!cfg)
+        return null;
+    const creds = getCreds(ctx);
+    if (!creds) {
+        ctx.logger.verbose(`   - Twilio credentials not found in environment, skipping`);
+        return null;
+    }
+    const apiExport = await ctx.getExport(cfg.smsWebhookApi);
+    if (!apiExport) {
+        ctx.logger.verbose(`   - Twilio smsWebhookApi '${cfg.smsWebhookApi}' not found in exports, skipping`);
+        return null;
+    }
+    const mappingPath = ctx.composeMappingPath(apiExport);
+    const webhookUrl = 'https://' + ctx.stageConfig.mapping.domain + (mappingPath ? '/' + mappingPath : '');
+    const sid = await resolveSid(ctx, cfg.messagingSid);
+    if (!sid) {
+        ctx.logger.verbose(`   - Could not resolve Twilio messagingSid, skipping`);
+        return null;
+    }
+    const isMessagingService = sdk.isMessagingServiceSid(sid);
+    if (ctx.dryRun) {
+        const type = isMessagingService ? 'messaging service' : 'phone number';
+        ctx.logger.verbose(`   - WOULD update Twilio ${type} ${sid} webhook to ${webhookUrl}`);
+        return {
+            summaryLines: [`\nTwilio:`, `  ${sid.padEnd(40)} ${webhookUrl}`],
+            summaryParts: ['Twilio webhook updated'],
+            raw: { messagingSid: sid, webhookUrl, action: 'updated' },
+        };
+    }
+    if (isMessagingService) {
+        ctx.logger.verbose(`\n * Updating Twilio messaging service webhook:`);
+        ctx.logger.verbose(`   - messaging service SID: ${sid}`);
+        ctx.logger.verbose(`   - webhook URL: ${webhookUrl}`);
+        const result = await sdk.updateMessagingServiceWebhook(creds.accountSid, creds.authToken, sid, webhookUrl);
+        ctx.logger.verbose(`   - updated ${result.friendlyName} → ${result.inboundRequestUrl}`);
+        return {
+            summaryLines: [`\nTwilio:`, `  ${sid.padEnd(40)} ${result.inboundRequestUrl}`],
+            summaryParts: ['Twilio webhook updated'],
+            raw: {
+                messagingSid: sid,
+                friendlyName: result.friendlyName,
+                webhookUrl: result.inboundRequestUrl,
+                action: 'updated',
+            },
+        };
+    }
+    else {
+        ctx.logger.verbose(`\n * Updating Twilio phone number webhook:`);
+        ctx.logger.verbose(`   - phone number SID: ${sid}`);
+        ctx.logger.verbose(`   - webhook URL: ${webhookUrl}`);
+        const result = await sdk.updatePhoneNumberWebhook(creds.accountSid, creds.authToken, sid, webhookUrl);
+        ctx.logger.verbose(`   - updated ${result.phoneNumber} → ${result.smsUrl}`);
+        return {
+            summaryLines: [`\nTwilio:`, `  ${sid.padEnd(40)} ${result.smsUrl}`],
+            summaryParts: ['Twilio webhook updated'],
+            raw: {
+                messagingSid: sid,
+                phoneNumber: result.phoneNumber,
+                webhookUrl: result.smsUrl,
+                action: 'updated',
+            },
+        };
+    }
+}
+async function infoHandler(ctx) {
+    const creds = getCreds(ctx);
+    if (!creds)
+        return null;
+    const rows = [];
+    for (const stage of ctx.stages) {
+        const cfg = stage.twilio;
+        if (!cfg)
+            continue;
+        const sid = await resolveSid(ctx, cfg.messagingSid);
+        if (!sid) {
+            ctx.logger.verbose(`   - Could not resolve Twilio messagingSid for stage ${stage.stage}, skipping`);
+            continue;
+        }
+        if (sdk.isMessagingServiceSid(sid)) {
+            try {
+                const svc = await sdk.getMessagingService(creds.accountSid, creds.authToken, sid);
+                rows.push({ stage: stage.stage, label: svc.friendlyName, webhookUrl: svc.inboundRequestUrl || 'not set', type: 'messaging-service' });
+            }
+            catch (e) {
+                ctx.logger.verbose(`   - Error fetching messaging service ${sid}: ${e.message}`);
+                rows.push({ stage: stage.stage, label: sid, webhookUrl: `error: ${e.message}`, type: 'messaging-service' });
+            }
+        }
+        else {
+            try {
+                const phone = await sdk.getPhoneNumber(creds.accountSid, creds.authToken, sid);
+                rows.push({ stage: stage.stage, label: phone.phoneNumber, webhookUrl: phone.smsUrl, type: 'phone-number' });
+            }
+            catch (e) {
+                ctx.logger.verbose(`   - Error fetching phone number ${sid}: ${e.message}`);
+                rows.push({ stage: stage.stage, label: sid, webhookUrl: `error: ${e.message}`, type: 'phone-number' });
+            }
+        }
+    }
+    if (rows.length === 0)
+        return null;
+    const labelWidth = Math.max(0, ...rows.map(r => r.label.length));
+    const lines = [`\nTwilio:`];
+    for (const r of rows) {
+        const typeTag = r.type === 'messaging-service' ? '[svc] ' : '[num] ';
+        lines.push(`  ${r.stage.padEnd(15)} ${typeTag}${r.label.padEnd(labelWidth)}  ${r.webhookUrl}`);
+    }
+    return { summaryLines: lines, summaryParts: [], raw: rows };
+}
+const plugin = {
+    name: 'twilio',
+    scopeFlag: 'noTwilio',
+    stageSchema: schema_1.stageSchema,
+    deploy: deployHandler,
+    rollback: deployHandler,
+    info: infoHandler,
+};
+exports.default = plugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -0,0 +1,18 @@
+export declare const stageSchema: {
+    type: string;
+    description: string;
+    required: string[];
+    properties: {
+        messagingSid: {
+            type: string;
+            description: string;
+            pattern: string;
+        };
+        smsWebhookApi: {
+            type: string;
+            description: string;
+            minLength: number;
+        };
+    };
+    additionalProperties: boolean;
+};

package/dist/schema.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stageSchema = void 0;
+exports.stageSchema = {
+    type: 'object',
+    description: 'Twilio webhook configuration for this stage. Accepts a phone number SID (PNxxxxxxxx) or messaging service SID (MGxxxxxxxx).',
+    required: ['messagingSid', 'smsWebhookApi'],
+    properties: {
+        messagingSid: {
+            type: 'string',
+            description: 'Twilio phone number SID (PNxxxxxxxx) or messaging service SID (MGxxxxxxxx). Supports !ImportValue, !ParameterStore, !SetEnv.',
+            pattern: '^(PN|MG)[a-f0-9]{32}$|^!',
+        },
+        smsWebhookApi: {
+            type: 'string',
+            description: 'Name of the API export to use for building the SMS webhook URL',
+            minLength: 1,
+        },
+    },
+    additionalProperties: false,
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG;IACvB,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,6HAA6H;IAC1I,QAAQ,EAAE,CAAC,cAAc,EAAE,eAAe,CAAC;IAC3C,UAAU,EAAE;QACR,YAAY,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,8HAA8H;YAC3I,OAAO,EAAE,0BAA0B;SACtC;QACD,aAAa,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,gEAAgE;YAC7E,SAAS,EAAE,CAAC;SACf;KACJ;IACD,oBAAoB,EAAE,KAAK;CAC9B,CAAC"}

package/dist/twilio-sdk.d.ts

@@ -0,0 +1,6 @@
+import { TwilioPhoneResult, TwilioPhoneInfo, TwilioMessagingResult, TwilioMessagingInfo } from './types';
+export declare function updatePhoneNumberWebhook(accountSid: string, authToken: string, phoneNumberSid: string, smsUrl: string): Promise<TwilioPhoneResult>;
+export declare function getPhoneNumber(accountSid: string, authToken: string, phoneNumberSid: string): Promise<TwilioPhoneInfo>;
+export declare function updateMessagingServiceWebhook(accountSid: string, authToken: string, messagingServiceSid: string, inboundRequestUrl: string): Promise<TwilioMessagingResult>;
+export declare function getMessagingService(accountSid: string, authToken: string, messagingServiceSid: string): Promise<TwilioMessagingInfo>;
+export declare function isMessagingServiceSid(sid: string): boolean;

package/dist/twilio-sdk.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updatePhoneNumberWebhook = updatePhoneNumberWebhook;
+exports.getPhoneNumber = getPhoneNumber;
+exports.updateMessagingServiceWebhook = updateMessagingServiceWebhook;
+exports.getMessagingService = getMessagingService;
+exports.isMessagingServiceSid = isMessagingServiceSid;
+const twilio_1 = __importDefault(require("twilio"));
+async function updatePhoneNumberWebhook(accountSid, authToken, phoneNumberSid, smsUrl) {
+    const client = (0, twilio_1.default)(accountSid, authToken);
+    const result = await client.incomingPhoneNumbers(phoneNumberSid).update({
+        smsUrl,
+        smsMethod: 'POST'
+    });
+    return {
+        sid: result.sid,
+        phoneNumber: result.phoneNumber,
+        smsUrl: result.smsUrl
+    };
+}
+async function getPhoneNumber(accountSid, authToken, phoneNumberSid) {
+    const client = (0, twilio_1.default)(accountSid, authToken);
+    const result = await client.incomingPhoneNumbers(phoneNumberSid).fetch();
+    return {
+        sid: result.sid,
+        phoneNumber: result.phoneNumber,
+        friendlyName: result.friendlyName,
+        smsUrl: result.smsUrl,
+        smsMethod: result.smsMethod
+    };
+}
+async function updateMessagingServiceWebhook(accountSid, authToken, messagingServiceSid, inboundRequestUrl) {
+    const client = (0, twilio_1.default)(accountSid, authToken);
+    const result = await client.messaging.v1.services(messagingServiceSid).update({
+        inboundRequestUrl,
+        inboundMethod: 'POST'
+    });
+    return {
+        sid: result.sid,
+        friendlyName: result.friendlyName,
+        inboundRequestUrl: result.inboundRequestUrl
+    };
+}
+async function getMessagingService(accountSid, authToken, messagingServiceSid) {
+    const client = (0, twilio_1.default)(accountSid, authToken);
+    const result = await client.messaging.v1.services(messagingServiceSid).fetch();
+    return {
+        sid: result.sid,
+        friendlyName: result.friendlyName,
+        inboundRequestUrl: result.inboundRequestUrl,
+        inboundMethod: result.inboundMethod
+    };
+}
+function isMessagingServiceSid(sid) {
+    return !!sid && sid.startsWith('MG');
+}
+//# sourceMappingURL=twilio-sdk.js.map

package/dist/twilio-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twilio-sdk.js","sourceRoot":"","sources":["../src/twilio-sdk.ts"],"names":[],"mappings":";;;;;AAQA,4DAWC;AAED,wCAUC;AAED,sEAWC;AAED,kDASC;AAED,sDAEC;AA3DD,oDAA4B;AAQrB,KAAK,UAAU,wBAAwB,CAAC,UAAkB,EAAE,SAAiB,EAAE,cAAsB,EAAE,MAAc;IACxH,MAAM,MAAM,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;QACpE,MAAM;QACN,SAAS,EAAE,MAAM;KACpB,CAAC,CAAC;IACH,OAAO;QACH,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;KACxB,CAAC;AACN,CAAC;AAEM,KAAK,UAAU,cAAc,CAAC,UAAkB,EAAE,SAAiB,EAAE,cAAsB;IAC9F,MAAM,MAAM,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,CAAC;IACzE,OAAO;QACH,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;KAC9B,CAAC;AACN,CAAC;AAEM,KAAK,UAAU,6BAA6B,CAAC,UAAkB,EAAE,SAAiB,EAAE,mBAA2B,EAAE,iBAAyB;IAC7I,MAAM,MAAM,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC;QAC1E,iBAAiB;QACjB,aAAa,EAAE,MAAM;KACxB,CAAC,CAAC;IACH,OAAO;QACH,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC9C,CAAC;AACN,CAAC;AAEM,KAAK,UAAU,mBAAmB,CAAC,UAAkB,EAAE,SAAiB,EAAE,mBAA2B;IACxG,MAAM,MAAM,GAAG,IAAA,gBAAM,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,KAAK,EAAE,CAAC;IAC/E,OAAO;QACH,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,aAAa,EAAE,MAAM,CAAC,aAAa;KACtC,CAAC;AACN,CAAC;AAED,SAAgB,qBAAqB,CAAC,GAAW;IAC7C,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+export interface TwilioStageConfig {
+    messagingSid: string;
+    smsWebhookApi: string;
+}
+export interface TwilioPhoneResult {
+    sid: string;
+    phoneNumber: string;
+    smsUrl: string;
+}
+export interface TwilioPhoneInfo {
+    sid: string;
+    phoneNumber: string;
+    friendlyName: string;
+    smsUrl: string;
+    smsMethod: string;
+}
+export interface TwilioMessagingResult {
+    sid: string;
+    friendlyName: string;
+    inboundRequestUrl: string;
+}
+export interface TwilioMessagingInfo {
+    sid: string;
+    friendlyName: string;
+    inboundRequestUrl: string;
+    inboundMethod: string;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@abwaters/cicd-plugin-twilio",
+  "version": "1.0.0",
+  "description": "Twilio webhook plugin for @abwaters/cicd — keeps phone-number/messaging-service SMS webhooks pointed at the deployed API stage",
+  "license": "MIT",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/abwaters/cicd-plugin-twilio.git"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@abwaters/cicd": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@abwaters/cicd": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "twilio": "^6.0.2"
+  },
+  "devDependencies": {
+    "@abwaters/cicd": "^1.1.0",
+    "@types/node": "^25.9.0",
+    "typescript": "^6.0.3"
+  }
+}