@jadedm/nestjs-verify-twilio 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+import { SmsProvider, SmsSendParams, SmsSendResult } from '@jadedm/nestjs-verify';
+
+interface TwilioSmsProviderOptions {
+    accountSid: string;
+    authToken: string;
+    /** E.164 sender number, or Messaging Service SID (starts with MG…). */
+    from: string;
+    /** Retry budget for transient (5xx, network) failures. Default 2. */
+    maxRetries?: number;
+    /** Base delay in ms for exponential backoff. Default 250. */
+    retryBaseMs?: number;
+}
+declare class TwilioSmsProvider implements SmsProvider {
+    readonly name = "twilio";
+    private readonly client;
+    private readonly from;
+    private readonly maxRetries;
+    private readonly retryBaseMs;
+    constructor(opts: TwilioSmsProviderOptions);
+    send(params: SmsSendParams): Promise<SmsSendResult>;
+    private sleep;
+}
+
+export { TwilioSmsProvider, type TwilioSmsProviderOptions };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { SmsProvider, SmsSendParams, SmsSendResult } from '@jadedm/nestjs-verify';
+
+interface TwilioSmsProviderOptions {
+    accountSid: string;
+    authToken: string;
+    /** E.164 sender number, or Messaging Service SID (starts with MG…). */
+    from: string;
+    /** Retry budget for transient (5xx, network) failures. Default 2. */
+    maxRetries?: number;
+    /** Base delay in ms for exponential backoff. Default 250. */
+    retryBaseMs?: number;
+}
+declare class TwilioSmsProvider implements SmsProvider {
+    readonly name = "twilio";
+    private readonly client;
+    private readonly from;
+    private readonly maxRetries;
+    private readonly retryBaseMs;
+    constructor(opts: TwilioSmsProviderOptions);
+    send(params: SmsSendParams): Promise<SmsSendResult>;
+    private sleep;
+}
+
+export { TwilioSmsProvider, type TwilioSmsProviderOptions };

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  TwilioSmsProvider: () => TwilioSmsProvider
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/twilio-sms.provider.ts
+var import_twilio = require("twilio");
+var TRANSIENT_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var TwilioSmsProvider = class {
+  name = "twilio";
+  client;
+  from;
+  maxRetries;
+  retryBaseMs;
+  constructor(opts) {
+    this.client = new import_twilio.Twilio(opts.accountSid, opts.authToken);
+    this.from = opts.from;
+    this.maxRetries = opts.maxRetries ?? 2;
+    this.retryBaseMs = opts.retryBaseMs ?? 250;
+  }
+  async send(params) {
+    const useMessagingService = this.from.startsWith("MG");
+    let attempt = 0;
+    let lastErr;
+    while (attempt <= this.maxRetries) {
+      try {
+        const message = await this.client.messages.create({
+          to: params.to,
+          body: params.body,
+          ...useMessagingService ? { messagingServiceSid: this.from } : { from: this.from }
+        });
+        return { providerMessageId: message.sid, provider: this.name };
+      } catch (err) {
+        lastErr = err;
+        const status = err.status;
+        if (status && !TRANSIENT_STATUS_CODES.has(status)) throw err;
+        if (attempt === this.maxRetries) break;
+        await this.sleep(this.retryBaseMs * 2 ** attempt);
+        attempt++;
+      }
+    }
+    throw lastErr;
+  }
+  sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TwilioSmsProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/twilio-sms.provider.ts"],"sourcesContent":["export * from './twilio-sms.provider.js';\n","import type {\n  SmsProvider,\n  SmsSendParams,\n  SmsSendResult,\n} from '@jadedm/nestjs-verify';\nimport { Twilio } from 'twilio';\n\nexport interface TwilioSmsProviderOptions {\n  accountSid: string;\n  authToken: string;\n  /** E.164 sender number, or Messaging Service SID (starts with MG…). */\n  from: string;\n  /** Retry budget for transient (5xx, network) failures. Default 2. */\n  maxRetries?: number;\n  /** Base delay in ms for exponential backoff. Default 250. */\n  retryBaseMs?: number;\n}\n\n/**\n * Errors Twilio considers transient — worth retrying. Everything else\n * (invalid number, blocked recipient, geo-permission) is terminal.\n */\nconst TRANSIENT_STATUS_CODES = new Set([429, 500, 502, 503, 504]);\n\nexport class TwilioSmsProvider implements SmsProvider {\n  readonly name = 'twilio';\n  private readonly client: Twilio;\n  private readonly from: string;\n  private readonly maxRetries: number;\n  private readonly retryBaseMs: number;\n\n  constructor(opts: TwilioSmsProviderOptions) {\n    this.client = new Twilio(opts.accountSid, opts.authToken);\n    this.from = opts.from;\n    this.maxRetries = opts.maxRetries ?? 2;\n    this.retryBaseMs = opts.retryBaseMs ?? 250;\n  }\n\n  async send(params: SmsSendParams): Promise<SmsSendResult> {\n    const useMessagingService = this.from.startsWith('MG');\n    let attempt = 0;\n    let lastErr: unknown;\n    while (attempt <= this.maxRetries) {\n      try {\n        const message = await this.client.messages.create({\n          to: params.to,\n          body: params.body,\n          ...(useMessagingService\n            ? { messagingServiceSid: this.from }\n            : { from: this.from }),\n        });\n        return { providerMessageId: message.sid, provider: this.name };\n      } catch (err) {\n        lastErr = err;\n        const status = (err as { status?: number }).status;\n        if (status && !TRANSIENT_STATUS_CODES.has(status)) throw err;\n        if (attempt === this.maxRetries) break;\n        await this.sleep(this.retryBaseMs * 2 ** attempt);\n        attempt++;\n      }\n    }\n    throw lastErr;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,oBAAuB;AAiBvB,IAAM,yBAAyB,oBAAI,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,GAAG,CAAC;AAEzD,IAAM,oBAAN,MAA+C;AAAA,EAC3C,OAAO;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAgC;AAC1C,SAAK,SAAS,IAAI,qBAAO,KAAK,YAAY,KAAK,SAAS;AACxD,SAAK,OAAO,KAAK;AACjB,SAAK,aAAa,KAAK,cAAc;AACrC,SAAK,cAAc,KAAK,eAAe;AAAA,EACzC;AAAA,EAEA,MAAM,KAAK,QAA+C;AACxD,UAAM,sBAAsB,KAAK,KAAK,WAAW,IAAI;AACrD,QAAI,UAAU;AACd,QAAI;AACJ,WAAO,WAAW,KAAK,YAAY;AACjC,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,OAAO,SAAS,OAAO;AAAA,UAChD,IAAI,OAAO;AAAA,UACX,MAAM,OAAO;AAAA,UACb,GAAI,sBACA,EAAE,qBAAqB,KAAK,KAAK,IACjC,EAAE,MAAM,KAAK,KAAK;AAAA,QACxB,CAAC;AACD,eAAO,EAAE,mBAAmB,QAAQ,KAAK,UAAU,KAAK,KAAK;AAAA,MAC/D,SAAS,KAAK;AACZ,kBAAU;AACV,cAAM,SAAU,IAA4B;AAC5C,YAAI,UAAU,CAAC,uBAAuB,IAAI,MAAM,EAAG,OAAM;AACzD,YAAI,YAAY,KAAK,WAAY;AACjC,cAAM,KAAK,MAAM,KAAK,cAAc,KAAK,OAAO;AAChD;AAAA,MACF;AAAA,IACF;AACA,UAAM;AAAA,EACR;AAAA,EAEQ,MAAM,IAA2B;AACvC,WAAO,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAAA,EAC7C;AACF;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,46 @@
+// src/twilio-sms.provider.ts
+import { Twilio } from "twilio";
+var TRANSIENT_STATUS_CODES = /* @__PURE__ */ new Set([429, 500, 502, 503, 504]);
+var TwilioSmsProvider = class {
+  name = "twilio";
+  client;
+  from;
+  maxRetries;
+  retryBaseMs;
+  constructor(opts) {
+    this.client = new Twilio(opts.accountSid, opts.authToken);
+    this.from = opts.from;
+    this.maxRetries = opts.maxRetries ?? 2;
+    this.retryBaseMs = opts.retryBaseMs ?? 250;
+  }
+  async send(params) {
+    const useMessagingService = this.from.startsWith("MG");
+    let attempt = 0;
+    let lastErr;
+    while (attempt <= this.maxRetries) {
+      try {
+        const message = await this.client.messages.create({
+          to: params.to,
+          body: params.body,
+          ...useMessagingService ? { messagingServiceSid: this.from } : { from: this.from }
+        });
+        return { providerMessageId: message.sid, provider: this.name };
+      } catch (err) {
+        lastErr = err;
+        const status = err.status;
+        if (status && !TRANSIENT_STATUS_CODES.has(status)) throw err;
+        if (attempt === this.maxRetries) break;
+        await this.sleep(this.retryBaseMs * 2 ** attempt);
+        attempt++;
+      }
+    }
+    throw lastErr;
+  }
+  sleep(ms) {
+    return new Promise((r) => setTimeout(r, ms));
+  }
+};
+export {
+  TwilioSmsProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/twilio-sms.provider.ts"],"sourcesContent":["import type {\n  SmsProvider,\n  SmsSendParams,\n  SmsSendResult,\n} from '@jadedm/nestjs-verify';\nimport { Twilio } from 'twilio';\n\nexport interface TwilioSmsProviderOptions {\n  accountSid: string;\n  authToken: string;\n  /** E.164 sender number, or Messaging Service SID (starts with MG…). */\n  from: string;\n  /** Retry budget for transient (5xx, network) failures. Default 2. */\n  maxRetries?: number;\n  /** Base delay in ms for exponential backoff. Default 250. */\n  retryBaseMs?: number;\n}\n\n/**\n * Errors Twilio considers transient — worth retrying. Everything else\n * (invalid number, blocked recipient, geo-permission) is terminal.\n */\nconst TRANSIENT_STATUS_CODES = new Set([429, 500, 502, 503, 504]);\n\nexport class TwilioSmsProvider implements SmsProvider {\n  readonly name = 'twilio';\n  private readonly client: Twilio;\n  private readonly from: string;\n  private readonly maxRetries: number;\n  private readonly retryBaseMs: number;\n\n  constructor(opts: TwilioSmsProviderOptions) {\n    this.client = new Twilio(opts.accountSid, opts.authToken);\n    this.from = opts.from;\n    this.maxRetries = opts.maxRetries ?? 2;\n    this.retryBaseMs = opts.retryBaseMs ?? 250;\n  }\n\n  async send(params: SmsSendParams): Promise<SmsSendResult> {\n    const useMessagingService = this.from.startsWith('MG');\n    let attempt = 0;\n    let lastErr: unknown;\n    while (attempt <= this.maxRetries) {\n      try {\n        const message = await this.client.messages.create({\n          to: params.to,\n          body: params.body,\n          ...(useMessagingService\n            ? { messagingServiceSid: this.from }\n            : { from: this.from }),\n        });\n        return { providerMessageId: message.sid, provider: this.name };\n      } catch (err) {\n        lastErr = err;\n        const status = (err as { status?: number }).status;\n        if (status && !TRANSIENT_STATUS_CODES.has(status)) throw err;\n        if (attempt === this.maxRetries) break;\n        await this.sleep(this.retryBaseMs * 2 ** attempt);\n        attempt++;\n      }\n    }\n    throw lastErr;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise((r) => setTimeout(r, ms));\n  }\n}\n"],"mappings":";AAKA,SAAS,cAAc;AAiBvB,IAAM,yBAAyB,oBAAI,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,GAAG,CAAC;AAEzD,IAAM,oBAAN,MAA+C;AAAA,EAC3C,OAAO;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,MAAgC;AAC1C,SAAK,SAAS,IAAI,OAAO,KAAK,YAAY,KAAK,SAAS;AACxD,SAAK,OAAO,KAAK;AACjB,SAAK,aAAa,KAAK,cAAc;AACrC,SAAK,cAAc,KAAK,eAAe;AAAA,EACzC;AAAA,EAEA,MAAM,KAAK,QAA+C;AACxD,UAAM,sBAAsB,KAAK,KAAK,WAAW,IAAI;AACrD,QAAI,UAAU;AACd,QAAI;AACJ,WAAO,WAAW,KAAK,YAAY;AACjC,UAAI;AACF,cAAM,UAAU,MAAM,KAAK,OAAO,SAAS,OAAO;AAAA,UAChD,IAAI,OAAO;AAAA,UACX,MAAM,OAAO;AAAA,UACb,GAAI,sBACA,EAAE,qBAAqB,KAAK,KAAK,IACjC,EAAE,MAAM,KAAK,KAAK;AAAA,QACxB,CAAC;AACD,eAAO,EAAE,mBAAmB,QAAQ,KAAK,UAAU,KAAK,KAAK;AAAA,MAC/D,SAAS,KAAK;AACZ,kBAAU;AACV,cAAM,SAAU,IAA4B;AAC5C,YAAI,UAAU,CAAC,uBAAuB,IAAI,MAAM,EAAG,OAAM;AACzD,YAAI,YAAY,KAAK,WAAY;AACjC,cAAM,KAAK,MAAM,KAAK,cAAc,KAAK,OAAO;AAChD;AAAA,MACF;AAAA,IACF;AACA,UAAM;AAAA,EACR;AAAA,EAEQ,MAAM,IAA2B;AACvC,WAAO,IAAI,QAAQ,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC;AAAA,EAC7C;AACF;","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@jadedm/nestjs-verify-twilio",
+  "version": "0.1.0",
+  "description": "Twilio SMS provider adapter for @jadedm/nestjs-verify.",
+  "keywords": [
+    "nestjs",
+    "otp",
+    "verify",
+    "twilio",
+    "sms"
+  ],
+  "license": "MIT",
+  "author": "jadedm <jadedmanish@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jadedm/nestjs-verify.git",
+    "directory": "packages/provider-twilio"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  },
+  "peerDependencies": {
+    "@jadedm/nestjs-verify": "workspace:^",
+    "twilio": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@jadedm/nestjs-verify": "workspace:*",
+    "twilio": "^5.0.0"
+  }
+}