@jadedm/nestjs-verify-ses 0.6.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Manish Jadhav (jadedm)
+
+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,43 @@
+# @jadedm/nestjs-verify-ses
+
+Amazon SES email provider for [`@jadedm/nestjs-verify`](https://www.npmjs.com/package/@jadedm/nestjs-verify). Sends verification codes by email through the SES v2 API.
+
+```bash
+pnpm add @jadedm/nestjs-verify-ses @aws-sdk/client-sesv2
+```
+
+## Usage
+
+```ts
+import { VerifyModule } from '@jadedm/nestjs-verify';
+import { SesEmailProvider } from '@jadedm/nestjs-verify-ses';
+
+VerifyModule.forRoot({
+  email: {
+    provider: new SesEmailProvider({
+      from: 'Example <no-reply@example.com>', // a verified SES identity
+      region: 'ap-south-1',
+      configurationSetName: 'otp',            // optional
+    }),
+    subject: 'Your Example sign-in code',
+  },
+  stores: { /* ... */ },
+});
+```
+
+Start a verification with `channel: 'email'` and an email address in `to`.
+
+Credentials come from the AWS SDK's default chain (environment, shared config, instance or task role). Pass `client` to use your own `SESv2Client`.
+
+## Errors and retries
+
+The AWS SDK retries throttling and server errors itself (three attempts by default). Anything it gives up on, and any rejection such as an unverified identity or a recipient outside the sandbox, is thrown, so `nestjs-verify` moves on to the next provider in `email.fallbacks`.
+
+## Requirements
+
+Node 20 or newer: current `@aws-sdk/client-sesv2` releases require it, though the core package still supports Node 18.
+
+## Peers
+
+- `@jadedm/nestjs-verify` 0.x
+- `@aws-sdk/client-sesv2` 3.x

package/dist/index.d.mts

@@ -0,0 +1,28 @@
+import { EmailProvider, EmailSendParams, EmailSendResult } from '@jadedm/nestjs-verify';
+import { SESv2Client } from '@aws-sdk/client-sesv2';
+
+interface SesEmailProviderOptions {
+    /** Verified SES identity to send from, e.g. 'no-reply@example.com' or 'Example <no-reply@example.com>'. */
+    from: string;
+    /** Region of the SES identity, e.g. 'ap-south-1'. Ignored when `client` is given. */
+    region?: string;
+    /** A configured client, for custom credentials or endpoints. */
+    client?: SESv2Client;
+    /** Optional SES configuration set, for event publishing. */
+    configurationSetName?: string;
+}
+/**
+ * Sends verification codes through Amazon SES (API v2). Credentials come from
+ * the AWS SDK's default chain unless a client is passed. The SDK retries
+ * throttling and server errors itself; anything it gives up on is thrown, so
+ * the core can try a fallback provider.
+ */
+declare class SesEmailProvider implements EmailProvider {
+    private readonly opts;
+    readonly name = "ses";
+    private readonly client;
+    constructor(opts: SesEmailProviderOptions);
+    send(params: EmailSendParams): Promise<EmailSendResult>;
+}
+
+export { SesEmailProvider, type SesEmailProviderOptions };

package/dist/index.d.ts

@@ -0,0 +1,28 @@
+import { EmailProvider, EmailSendParams, EmailSendResult } from '@jadedm/nestjs-verify';
+import { SESv2Client } from '@aws-sdk/client-sesv2';
+
+interface SesEmailProviderOptions {
+    /** Verified SES identity to send from, e.g. 'no-reply@example.com' or 'Example <no-reply@example.com>'. */
+    from: string;
+    /** Region of the SES identity, e.g. 'ap-south-1'. Ignored when `client` is given. */
+    region?: string;
+    /** A configured client, for custom credentials or endpoints. */
+    client?: SESv2Client;
+    /** Optional SES configuration set, for event publishing. */
+    configurationSetName?: string;
+}
+/**
+ * Sends verification codes through Amazon SES (API v2). Credentials come from
+ * the AWS SDK's default chain unless a client is passed. The SDK retries
+ * throttling and server errors itself; anything it gives up on is thrown, so
+ * the core can try a fallback provider.
+ */
+declare class SesEmailProvider implements EmailProvider {
+    private readonly opts;
+    readonly name = "ses";
+    private readonly client;
+    constructor(opts: SesEmailProviderOptions);
+    send(params: EmailSendParams): Promise<EmailSendResult>;
+}
+
+export { SesEmailProvider, type SesEmailProviderOptions };

package/dist/index.js

@@ -0,0 +1,78 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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, {
+  SesEmailProvider: () => SesEmailProvider
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/ses-email.provider.ts
+var import_client_sesv2 = require("@aws-sdk/client-sesv2");
+var SesEmailProvider = class {
+  static {
+    __name(this, "SesEmailProvider");
+  }
+  opts;
+  name = "ses";
+  client;
+  constructor(opts) {
+    this.opts = opts;
+    this.client = opts.client ?? new import_client_sesv2.SESv2Client({
+      region: opts.region
+    });
+  }
+  async send(params) {
+    const result = await this.client.send(new import_client_sesv2.SendEmailCommand({
+      FromEmailAddress: this.opts.from,
+      Destination: {
+        ToAddresses: [
+          params.to
+        ]
+      },
+      Content: {
+        Simple: {
+          Subject: {
+            Data: params.subject,
+            Charset: "UTF-8"
+          },
+          Body: {
+            Text: {
+              Data: params.text,
+              Charset: "UTF-8"
+            }
+          }
+        }
+      },
+      ConfigurationSetName: this.opts.configurationSetName
+    }));
+    if (!result.MessageId) throw new Error("SES returned no MessageId");
+    return {
+      providerMessageId: result.MessageId,
+      provider: this.name
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SesEmailProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/ses-email.provider.ts"],"sourcesContent":["export * from './ses-email.provider.js';\n","import type {\n  EmailProvider,\n  EmailSendParams,\n  EmailSendResult,\n} from '@jadedm/nestjs-verify';\nimport { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\n\nexport interface SesEmailProviderOptions {\n  /** Verified SES identity to send from, e.g. 'no-reply@example.com' or 'Example <no-reply@example.com>'. */\n  from: string;\n  /** Region of the SES identity, e.g. 'ap-south-1'. Ignored when `client` is given. */\n  region?: string;\n  /** A configured client, for custom credentials or endpoints. */\n  client?: SESv2Client;\n  /** Optional SES configuration set, for event publishing. */\n  configurationSetName?: string;\n}\n\n/**\n * Sends verification codes through Amazon SES (API v2). Credentials come from\n * the AWS SDK's default chain unless a client is passed. The SDK retries\n * throttling and server errors itself; anything it gives up on is thrown, so\n * the core can try a fallback provider.\n */\nexport class SesEmailProvider implements EmailProvider {\n  readonly name = 'ses';\n  private readonly client: SESv2Client;\n\n  constructor(private readonly opts: SesEmailProviderOptions) {\n    this.client = opts.client ?? new SESv2Client({ region: opts.region });\n  }\n\n  async send(params: EmailSendParams): Promise<EmailSendResult> {\n    const result = await this.client.send(\n      new SendEmailCommand({\n        FromEmailAddress: this.opts.from,\n        Destination: { ToAddresses: [params.to] },\n        Content: {\n          Simple: {\n            Subject: { Data: params.subject, Charset: 'UTF-8' },\n            Body: { Text: { Data: params.text, Charset: 'UTF-8' } },\n          },\n        },\n        ConfigurationSetName: this.opts.configurationSetName,\n      }),\n    );\n    if (!result.MessageId) throw new Error('SES returned no MessageId');\n    return { providerMessageId: result.MessageId, provider: this.name };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;ACKA,0BAA8C;AAmBvC,IAAMA,mBAAN,MAAMA;EAnBb,OAmBaA;;;;EACFC,OAAO;EACCC;EAEjB,YAA6BC,MAA+B;SAA/BA,OAAAA;AAC3B,SAAKD,SAASC,KAAKD,UAAU,IAAIE,gCAAY;MAAEC,QAAQF,KAAKE;IAAO,CAAA;EACrE;EAEA,MAAMC,KAAKC,QAAmD;AAC5D,UAAMC,SAAS,MAAM,KAAKN,OAAOI,KAC/B,IAAIG,qCAAiB;MACnBC,kBAAkB,KAAKP,KAAKQ;MAC5BC,aAAa;QAAEC,aAAa;UAACN,OAAOO;;MAAI;MACxCC,SAAS;QACPC,QAAQ;UACNC,SAAS;YAAEC,MAAMX,OAAOY;YAASC,SAAS;UAAQ;UAClDC,MAAM;YAAEC,MAAM;cAAEJ,MAAMX,OAAOgB;cAAMH,SAAS;YAAQ;UAAE;QACxD;MACF;MACAI,sBAAsB,KAAKrB,KAAKsB;IAClC,CAAA,CAAA;AAEF,QAAI,CAACjB,OAAOkB,UAAW,OAAM,IAAIC,MAAM,2BAAA;AACvC,WAAO;MAAEC,mBAAmBpB,OAAOkB;MAAWG,UAAU,KAAK5B;IAAK;EACpE;AACF;","names":["SesEmailProvider","name","client","opts","SESv2Client","region","send","params","result","SendEmailCommand","FromEmailAddress","from","Destination","ToAddresses","to","Content","Simple","Subject","Data","subject","Charset","Body","Text","text","ConfigurationSetName","configurationSetName","MessageId","Error","providerMessageId","provider"]}

package/dist/index.mjs

@@ -0,0 +1,53 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/ses-email.provider.ts
+import { SendEmailCommand, SESv2Client } from "@aws-sdk/client-sesv2";
+var SesEmailProvider = class {
+  static {
+    __name(this, "SesEmailProvider");
+  }
+  opts;
+  name = "ses";
+  client;
+  constructor(opts) {
+    this.opts = opts;
+    this.client = opts.client ?? new SESv2Client({
+      region: opts.region
+    });
+  }
+  async send(params) {
+    const result = await this.client.send(new SendEmailCommand({
+      FromEmailAddress: this.opts.from,
+      Destination: {
+        ToAddresses: [
+          params.to
+        ]
+      },
+      Content: {
+        Simple: {
+          Subject: {
+            Data: params.subject,
+            Charset: "UTF-8"
+          },
+          Body: {
+            Text: {
+              Data: params.text,
+              Charset: "UTF-8"
+            }
+          }
+        }
+      },
+      ConfigurationSetName: this.opts.configurationSetName
+    }));
+    if (!result.MessageId) throw new Error("SES returned no MessageId");
+    return {
+      providerMessageId: result.MessageId,
+      provider: this.name
+    };
+  }
+};
+export {
+  SesEmailProvider
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ses-email.provider.ts"],"sourcesContent":["import type {\n  EmailProvider,\n  EmailSendParams,\n  EmailSendResult,\n} from '@jadedm/nestjs-verify';\nimport { SendEmailCommand, SESv2Client } from '@aws-sdk/client-sesv2';\n\nexport interface SesEmailProviderOptions {\n  /** Verified SES identity to send from, e.g. 'no-reply@example.com' or 'Example <no-reply@example.com>'. */\n  from: string;\n  /** Region of the SES identity, e.g. 'ap-south-1'. Ignored when `client` is given. */\n  region?: string;\n  /** A configured client, for custom credentials or endpoints. */\n  client?: SESv2Client;\n  /** Optional SES configuration set, for event publishing. */\n  configurationSetName?: string;\n}\n\n/**\n * Sends verification codes through Amazon SES (API v2). Credentials come from\n * the AWS SDK's default chain unless a client is passed. The SDK retries\n * throttling and server errors itself; anything it gives up on is thrown, so\n * the core can try a fallback provider.\n */\nexport class SesEmailProvider implements EmailProvider {\n  readonly name = 'ses';\n  private readonly client: SESv2Client;\n\n  constructor(private readonly opts: SesEmailProviderOptions) {\n    this.client = opts.client ?? new SESv2Client({ region: opts.region });\n  }\n\n  async send(params: EmailSendParams): Promise<EmailSendResult> {\n    const result = await this.client.send(\n      new SendEmailCommand({\n        FromEmailAddress: this.opts.from,\n        Destination: { ToAddresses: [params.to] },\n        Content: {\n          Simple: {\n            Subject: { Data: params.subject, Charset: 'UTF-8' },\n            Body: { Text: { Data: params.text, Charset: 'UTF-8' } },\n          },\n        },\n        ConfigurationSetName: this.opts.configurationSetName,\n      }),\n    );\n    if (!result.MessageId) throw new Error('SES returned no MessageId');\n    return { providerMessageId: result.MessageId, provider: this.name };\n  }\n}\n"],"mappings":";;;;AAKA,SAASA,kBAAkBC,mBAAmB;AAmBvC,IAAMC,mBAAN,MAAMA;EAnBb,OAmBaA;;;;EACFC,OAAO;EACCC;EAEjB,YAA6BC,MAA+B;SAA/BA,OAAAA;AAC3B,SAAKD,SAASC,KAAKD,UAAU,IAAIE,YAAY;MAAEC,QAAQF,KAAKE;IAAO,CAAA;EACrE;EAEA,MAAMC,KAAKC,QAAmD;AAC5D,UAAMC,SAAS,MAAM,KAAKN,OAAOI,KAC/B,IAAIG,iBAAiB;MACnBC,kBAAkB,KAAKP,KAAKQ;MAC5BC,aAAa;QAAEC,aAAa;UAACN,OAAOO;;MAAI;MACxCC,SAAS;QACPC,QAAQ;UACNC,SAAS;YAAEC,MAAMX,OAAOY;YAASC,SAAS;UAAQ;UAClDC,MAAM;YAAEC,MAAM;cAAEJ,MAAMX,OAAOgB;cAAMH,SAAS;YAAQ;UAAE;QACxD;MACF;MACAI,sBAAsB,KAAKrB,KAAKsB;IAClC,CAAA,CAAA;AAEF,QAAI,CAACjB,OAAOkB,UAAW,OAAM,IAAIC,MAAM,2BAAA;AACvC,WAAO;MAAEC,mBAAmBpB,OAAOkB;MAAWG,UAAU,KAAK5B;IAAK;EACpE;AACF;","names":["SendEmailCommand","SESv2Client","SesEmailProvider","name","client","opts","SESv2Client","region","send","params","result","SendEmailCommand","FromEmailAddress","from","Destination","ToAddresses","to","Content","Simple","Subject","Data","subject","Charset","Body","Text","text","ConfigurationSetName","configurationSetName","MessageId","Error","providerMessageId","provider"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@jadedm/nestjs-verify-ses",
+  "version": "0.6.0",
+  "description": "Amazon SES email provider adapter for @jadedm/nestjs-verify.",
+  "keywords": [
+    "nestjs",
+    "otp",
+    "verify",
+    "ses",
+    "email",
+    "aws"
+  ],
+  "license": "MIT",
+  "author": "jadedm <jadedmanish@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jadedm/nestjs-verify.git",
+    "directory": "packages/provider-ses"
+  },
+  "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"
+  ],
+  "peerDependencies": {
+    "@aws-sdk/client-sesv2": "^3.500.0",
+    "@jadedm/nestjs-verify": "^0.6.0"
+  },
+  "devDependencies": {
+    "@aws-sdk/client-sesv2": "^3.500.0",
+    "@jadedm/nestjs-verify": "0.6.0"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}