@otp-service/provider-email-resend 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 otp-service contributors
+
+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/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { DeliveryRequest, OtpDelivery } from '@otp-service/core';
+
+interface ResendHttpClient {
+    post(url: string, input: {
+        body: string;
+        headers: Record<string, string>;
+    }): Promise<ResendHttpResponse>;
+}
+interface ResendHttpResponse {
+    json(): Promise<unknown>;
+    status: number;
+}
+interface CreateResendEmailProviderOptions {
+    apiBaseUrl?: string;
+    apiKey: string;
+    from: string;
+    httpClient: ResendHttpClient;
+    subjectFormatter?: (request: DeliveryRequest) => string;
+    textFormatter?: (request: DeliveryRequest) => string;
+}
+declare function createResendEmailProvider(options: CreateResendEmailProviderOptions): OtpDelivery;
+
+export { type CreateResendEmailProviderOptions, type ResendHttpClient, type ResendHttpResponse, createResendEmailProvider };

package/dist/index.js

@@ -0,0 +1,113 @@
+import { OtpDeliveryError } from '@otp-service/core';
+
+// src/index.ts
+function createResendEmailProvider(options) {
+  validateOptions(options);
+  return {
+    async sendChallenge(request) {
+      if (request.channel !== "email") {
+        throw new OtpDeliveryError({
+          code: "UNSUPPORTED_CHANNEL",
+          deliveryOutcome: "DEFINITIVE_FAILURE",
+          message: "Resend email provider only supports email delivery.",
+          provider: "resend",
+          retryable: false
+        });
+      }
+      let response;
+      try {
+        response = await options.httpClient.post(buildEmailsUrl(options), {
+          body: JSON.stringify({
+            from: options.from,
+            subject: formatSubject(options, request),
+            text: formatText(options, request),
+            to: [request.recipient]
+          }),
+          headers: {
+            authorization: `Bearer ${options.apiKey}`,
+            "content-type": "application/json"
+          }
+        });
+      } catch (cause) {
+        throw new OtpDeliveryError({
+          cause,
+          code: "EMAIL_DELIVERY_TRANSPORT_ERROR",
+          deliveryOutcome: "OUTCOME_UNKNOWN",
+          message: "Resend email delivery transport failed before provider acceptance was confirmed.",
+          provider: "resend",
+          retryable: true
+        });
+      }
+      let payload;
+      try {
+        payload = await response.json();
+      } catch (cause) {
+        throw new OtpDeliveryError({
+          cause,
+          code: "INVALID_PROVIDER_RESPONSE",
+          deliveryOutcome: response.status >= 200 && response.status < 300 ? "OUTCOME_UNKNOWN" : "DEFINITIVE_FAILURE",
+          message: "Resend email provider returned an unreadable response payload.",
+          provider: "resend",
+          retryable: response.status >= 500 || response.status === 429
+        });
+      }
+      if (response.status < 200 || response.status >= 300) {
+        throw new OtpDeliveryError({
+          cause: payload,
+          code: "EMAIL_DELIVERY_FAILED",
+          deliveryOutcome: "DEFINITIVE_FAILURE",
+          message: "Resend email delivery request failed.",
+          provider: "resend",
+          retryable: response.status >= 500 || response.status === 429
+        });
+      }
+      assertResendSuccessResponse(payload);
+    }
+  };
+}
+function assertResendSuccessResponse(payload) {
+  if (typeof payload !== "object" || payload === null) {
+    throw new OtpDeliveryError({
+      code: "INVALID_PROVIDER_RESPONSE",
+      deliveryOutcome: "OUTCOME_UNKNOWN",
+      message: "Resend email provider returned a non-object response.",
+      provider: "resend",
+      retryable: false
+    });
+  }
+  const record = payload;
+  if (typeof record.id !== "string" || record.id.trim().length === 0) {
+    throw new OtpDeliveryError({
+      cause: payload,
+      code: "INVALID_PROVIDER_RESPONSE",
+      deliveryOutcome: "OUTCOME_UNKNOWN",
+      message: "Resend email provider response is missing an email ID.",
+      provider: "resend",
+      retryable: false
+    });
+  }
+}
+function buildEmailsUrl(options) {
+  const baseUrl = options.apiBaseUrl ?? "https://api.resend.com";
+  return `${baseUrl}/emails`;
+}
+function formatSubject(options, request) {
+  const formatter = options.subjectFormatter ?? ((deliveryRequest) => `${deliveryRequest.purpose} OTP`);
+  return formatter(request);
+}
+function formatText(options, request) {
+  const formatter = options.textFormatter ?? ((deliveryRequest) => `Your ${deliveryRequest.purpose} OTP is ${deliveryRequest.otp}. It expires at ${deliveryRequest.expiresAt.toISOString()}.`);
+  return formatter(request);
+}
+function validateOptions(options) {
+  if (options.apiKey.trim().length === 0) {
+    throw new Error("Resend apiKey must not be empty.");
+  }
+  if (options.from.trim().length === 0) {
+    throw new Error("Resend from address must not be empty.");
+  }
+}
+
+export { createResendEmailProvider };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { OtpDeliveryError, type DeliveryRequest, type OtpDelivery } from \"@otp-service/core\";\n\nexport interface ResendHttpClient {\n  post(\n    url: string,\n    input: {\n      body: string;\n      headers: Record<string, string>;\n    }\n  ): Promise<ResendHttpResponse>;\n}\n\nexport interface ResendHttpResponse {\n  json(): Promise<unknown>;\n  status: number;\n}\n\nexport interface CreateResendEmailProviderOptions {\n  apiBaseUrl?: string;\n  apiKey: string;\n  from: string;\n  httpClient: ResendHttpClient;\n  subjectFormatter?: (request: DeliveryRequest) => string;\n  textFormatter?: (request: DeliveryRequest) => string;\n}\n\ninterface ResendSuccessResponse {\n  id: string;\n}\n\nexport function createResendEmailProvider(\n  options: CreateResendEmailProviderOptions\n): OtpDelivery {\n  validateOptions(options);\n\n  return {\n    async sendChallenge(request: DeliveryRequest) {\n      if (request.channel !== \"email\") {\n        throw new OtpDeliveryError({\n          code: \"UNSUPPORTED_CHANNEL\",\n          deliveryOutcome: \"DEFINITIVE_FAILURE\",\n          message: \"Resend email provider only supports email delivery.\",\n          provider: \"resend\",\n          retryable: false\n        });\n      }\n\n      let response: ResendHttpResponse;\n\n      try {\n        response = await options.httpClient.post(buildEmailsUrl(options), {\n          body: JSON.stringify({\n            from: options.from,\n            subject: formatSubject(options, request),\n            text: formatText(options, request),\n            to: [request.recipient]\n          }),\n          headers: {\n            authorization: `Bearer ${options.apiKey}`,\n            \"content-type\": \"application/json\"\n          }\n        });\n      } catch (cause) {\n        throw new OtpDeliveryError({\n          cause,\n          code: \"EMAIL_DELIVERY_TRANSPORT_ERROR\",\n          deliveryOutcome: \"OUTCOME_UNKNOWN\",\n          message: \"Resend email delivery transport failed before provider acceptance was confirmed.\",\n          provider: \"resend\",\n          retryable: true\n        });\n      }\n\n      let payload: unknown;\n\n      try {\n        payload = await response.json();\n      } catch (cause) {\n        throw new OtpDeliveryError({\n          cause,\n          code: \"INVALID_PROVIDER_RESPONSE\",\n          deliveryOutcome: response.status >= 200 && response.status < 300 ? \"OUTCOME_UNKNOWN\" : \"DEFINITIVE_FAILURE\",\n          message: \"Resend email provider returned an unreadable response payload.\",\n          provider: \"resend\",\n          retryable: response.status >= 500 || response.status === 429\n        });\n      }\n\n      if (response.status < 200 || response.status >= 300) {\n        throw new OtpDeliveryError({\n          cause: payload,\n          code: \"EMAIL_DELIVERY_FAILED\",\n          deliveryOutcome: \"DEFINITIVE_FAILURE\",\n          message: \"Resend email delivery request failed.\",\n          provider: \"resend\",\n          retryable: response.status >= 500 || response.status === 429\n        });\n      }\n\n      assertResendSuccessResponse(payload);\n    }\n  };\n}\n\nfunction assertResendSuccessResponse(payload: unknown): asserts payload is ResendSuccessResponse {\n  if (typeof payload !== \"object\" || payload === null) {\n    throw new OtpDeliveryError({\n      code: \"INVALID_PROVIDER_RESPONSE\",\n      deliveryOutcome: \"OUTCOME_UNKNOWN\",\n      message: \"Resend email provider returned a non-object response.\",\n      provider: \"resend\",\n      retryable: false\n    });\n  }\n\n  const record = payload as Record<string, unknown>;\n  if (typeof record.id !== \"string\" || record.id.trim().length === 0) {\n    throw new OtpDeliveryError({\n      cause: payload,\n      code: \"INVALID_PROVIDER_RESPONSE\",\n      deliveryOutcome: \"OUTCOME_UNKNOWN\",\n      message: \"Resend email provider response is missing an email ID.\",\n      provider: \"resend\",\n      retryable: false\n    });\n  }\n}\n\nfunction buildEmailsUrl(options: CreateResendEmailProviderOptions): string {\n  const baseUrl = options.apiBaseUrl ?? \"https://api.resend.com\";\n  return `${baseUrl}/emails`;\n}\n\nfunction formatSubject(\n  options: CreateResendEmailProviderOptions,\n  request: DeliveryRequest\n): string {\n  const formatter =\n    options.subjectFormatter ??\n    ((deliveryRequest: DeliveryRequest) => `${deliveryRequest.purpose} OTP`);\n\n  return formatter(request);\n}\n\nfunction formatText(\n  options: CreateResendEmailProviderOptions,\n  request: DeliveryRequest\n): string {\n  const formatter =\n    options.textFormatter ??\n    ((deliveryRequest: DeliveryRequest) =>\n      `Your ${deliveryRequest.purpose} OTP is ${deliveryRequest.otp}. It expires at ${deliveryRequest.expiresAt.toISOString()}.`);\n\n  return formatter(request);\n}\n\nfunction validateOptions(options: CreateResendEmailProviderOptions): void {\n  if (options.apiKey.trim().length === 0) {\n    throw new Error(\"Resend apiKey must not be empty.\");\n  }\n\n  if (options.from.trim().length === 0) {\n    throw new Error(\"Resend from address must not be empty.\");\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@otp-service/provider-email-resend",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Resend email delivery adapter for OTP challenges.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Suraj-H/otp-service-package-v2.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Suraj-H/otp-service-package-v2/issues"
+  },
+  "homepage": "https://github.com/Suraj-H/otp-service-package-v2/tree/main/packages/provider-email-resend#readme",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@otp-service/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsup --config tsup.config.ts",
+    "clean": "rm -rf dist",
+    "lint": "eslint src test",
+    "test": "vitest run --config vitest.config.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}