@kitcn/resend 0.12.4 → 0.12.6

package/dist/index.d.ts

@@ -0,0 +1,140 @@
+import { Plugin } from "kitcn/plugins";
+
+//#region src/shared.d.ts
+type Status = 'waiting' | 'queued' | 'cancelled' | 'sent' | 'delivered' | 'delivery_delayed' | 'bounced' | 'failed';
+type Template = {
+  id: string;
+  variables?: Record<string, string | number>;
+};
+type RuntimeConfig = {
+  initialBackoffMs: number;
+  retryAttempts: number;
+  apiKey: string;
+  testMode: boolean;
+};
+type Recipient = string | string[];
+type Header$1 = {
+  name: string;
+  value: string;
+};
+type CommonEventFields = {
+  broadcast_id?: string;
+  created_at: string;
+  email_id: string;
+  from: Recipient;
+  to: Recipient;
+  cc?: Recipient;
+  bcc?: Recipient;
+  reply_to?: Recipient;
+  headers?: Header$1[];
+  subject: string;
+};
+declare const ACCEPTED_EVENT_TYPES: readonly ["email.sent", "email.delivered", "email.bounced", "email.complained", "email.failed", "email.delivery_delayed", "email.opened", "email.clicked"];
+type BaseEmailEvent<TType extends (typeof ACCEPTED_EVENT_TYPES)[number]> = {
+  type: TType;
+  created_at: string;
+  data: CommonEventFields;
+};
+type BouncedEmailEvent = BaseEmailEvent<'email.bounced'> & {
+  data: CommonEventFields & {
+    bounce: {
+      message: string;
+      subType: string;
+      type: string;
+    };
+  };
+};
+type OpenedEmailEvent = BaseEmailEvent<'email.opened'> & {
+  data: CommonEventFields & {
+    open: {
+      ipAddress: string;
+      timestamp: string;
+      userAgent: string;
+    };
+  };
+};
+type ClickedEmailEvent = BaseEmailEvent<'email.clicked'> & {
+  data: CommonEventFields & {
+    click: {
+      ipAddress: string;
+      link: string;
+      timestamp: string;
+      userAgent: string;
+    };
+  };
+};
+type FailedEmailEvent = BaseEmailEvent<'email.failed'> & {
+  data: CommonEventFields & {
+    failed: {
+      reason: string;
+    };
+  };
+};
+type EmailEvent = BaseEmailEvent<'email.sent'> | BaseEmailEvent<'email.delivered'> | BaseEmailEvent<'email.delivery_delayed'> | BaseEmailEvent<'email.complained'> | BouncedEmailEvent | OpenedEmailEvent | ClickedEmailEvent | FailedEmailEvent;
+type SendEmailOptions = {
+  from: string;
+  to: string | string[];
+  cc?: string | string[];
+  bcc?: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  replyTo?: string[];
+  headers?: {
+    name: string;
+    value: string;
+  }[];
+} | {
+  from: string;
+  to: string | string[];
+  cc?: string | string[];
+  bcc?: string | string[];
+  subject?: string;
+  template: {
+    id: string;
+    variables?: Record<string, string | number>;
+  };
+  html?: never;
+  text?: never;
+  replyTo?: string[];
+  headers?: {
+    name: string;
+    value: string;
+  }[];
+};
+type EmailStatus = {
+  status: Status;
+  errorMessage: string | null;
+  bounced: boolean;
+  complained: boolean;
+  failed: boolean;
+  deliveryDelayed: boolean;
+  opened: boolean;
+  clicked: boolean;
+};
+//#endregion
+//#region src/runtime-helpers.d.ts
+type Header = {
+  name: string;
+  value: string;
+};
+type ResendOptions = Partial<RuntimeConfig> & {
+  webhookSecret?: string;
+};
+type ResendApi = RuntimeConfig & {
+  webhookSecret: string;
+  verifyWebhookEvent(req: Request): Promise<EmailEvent>;
+};
+declare function getSegment(now: number): number;
+declare function isTestEmail(email: string): boolean;
+declare function normalizeRecipientList(value: string | string[] | undefined): string[];
+declare function normalizeHeaders(headers: Header[] | undefined, idempotencyKey: string): Record<string, string>;
+declare function shouldRetry(status: number, attempt: number, retryAttempts: number): boolean;
+declare function getRetryDelayMs(initialBackoffMs: number, attempt: number): number;
+declare function parseEmailEvent(value: unknown): EmailEvent | null;
+declare function canUpgradeStatus(currentStatus: Status, nextStatus: Status): boolean;
+//#endregion
+//#region src/index.d.ts
+declare const ResendPlugin: Plugin<'resend', ResendOptions, ResendApi>;
+//#endregion
+export { type EmailEvent, type EmailStatus, type ResendApi, type ResendOptions, ResendPlugin, type RuntimeConfig, type SendEmailOptions, type Status, type Template, canUpgradeStatus, getRetryDelayMs, getSegment, isTestEmail, normalizeHeaders, normalizeRecipientList, parseEmailEvent, shouldRetry };

package/dist/index.js

@@ -0,0 +1,125 @@
+import { definePlugin } from "kitcn/plugins";
+import { Webhook } from "svix";
+
+//#region src/shared.ts
+const ACCEPTED_EVENT_TYPES = [
+	"email.sent",
+	"email.delivered",
+	"email.bounced",
+	"email.complained",
+	"email.failed",
+	"email.delivery_delayed",
+	"email.opened",
+	"email.clicked"
+];
+
+//#endregion
+//#region src/runtime-helpers.ts
+const SEGMENT_MS = 125;
+const PERMANENT_ERROR_CODES = new Set([
+	400,
+	401,
+	403,
+	404,
+	405,
+	406,
+	407,
+	408,
+	410,
+	411,
+	413,
+	414,
+	415,
+	416,
+	418,
+	421,
+	422,
+	426,
+	427,
+	428,
+	431
+]);
+const RESEND_TEST_EMAIL_REGEX = /^(delivered|bounced|complained)(\+[a-zA-Z0-9_-]*)?@resend\.dev$/;
+const EMAIL_STATUS_RANK = {
+	waiting: 0,
+	queued: 1,
+	sent: 2,
+	delivery_delayed: 3,
+	delivered: 4,
+	bounced: 5,
+	failed: 5,
+	cancelled: 100
+};
+function getSegment(now) {
+	return Math.floor(now / SEGMENT_MS);
+}
+function isTestEmail(email) {
+	return RESEND_TEST_EMAIL_REGEX.test(email);
+}
+function normalizeRecipientList(value) {
+	if (!value) return [];
+	return Array.isArray(value) ? value : [value];
+}
+function normalizeHeaders(headers, idempotencyKey) {
+	const merged = Object.fromEntries((headers ?? []).map((header) => [header.name, header.value]));
+	if (!Object.keys(merged).some((headerName) => headerName.toLowerCase() === "idempotency-key")) merged["Idempotency-Key"] = idempotencyKey;
+	return merged;
+}
+function shouldRetry(status, attempt, retryAttempts) {
+	if (attempt >= retryAttempts) return false;
+	if (status === 429) return true;
+	if (status >= 500) return true;
+	return !PERMANENT_ERROR_CODES.has(status);
+}
+function getRetryDelayMs(initialBackoffMs, attempt) {
+	return initialBackoffMs * 2 ** attempt;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function parseEmailEvent(value) {
+	if (!isRecord(value)) return null;
+	const eventType = value.type;
+	const createdAt = value.created_at;
+	const eventData = value.data;
+	if (typeof eventType !== "string" || typeof createdAt !== "string" || !isRecord(eventData)) return null;
+	if (!ACCEPTED_EVENT_TYPES.includes(eventType)) return null;
+	if (typeof eventData.email_id !== "string") return null;
+	if (eventType === "email.bounced" && (!isRecord(eventData.bounce) || typeof eventData.bounce.message !== "string")) return null;
+	if (eventType === "email.failed" && (!isRecord(eventData.failed) || typeof eventData.failed.reason !== "string")) return null;
+	return value;
+}
+function canUpgradeStatus(currentStatus, nextStatus) {
+	if (currentStatus === "cancelled") return false;
+	return EMAIL_STATUS_RANK[nextStatus] > EMAIL_STATUS_RANK[currentStatus];
+}
+async function verifyResendWebhookEvent(req, webhookSecret) {
+	if (!webhookSecret) throw new Error("Webhook secret is not set");
+	const webhook = new Webhook(webhookSecret);
+	const raw = await req.text();
+	const parsed = parseEmailEvent(webhook.verify(raw, {
+		"svix-id": req.headers.get("svix-id") ?? "",
+		"svix-timestamp": req.headers.get("svix-timestamp") ?? "",
+		"svix-signature": req.headers.get("svix-signature") ?? ""
+	}));
+	if (!parsed) throw new Error("Invalid Resend webhook payload");
+	return parsed;
+}
+
+//#endregion
+//#region src/index.ts
+/** biome-ignore-all lint/performance/noBarrelFile: package entry */
+const ResendPlugin = definePlugin("resend", ({ options }) => {
+	const webhookSecret = options?.webhookSecret ?? "";
+	return {
+		apiKey: options?.apiKey ?? "",
+		webhookSecret,
+		initialBackoffMs: options?.initialBackoffMs ?? 3e4,
+		retryAttempts: options?.retryAttempts ?? 5,
+		testMode: options?.testMode ?? true,
+		verifyWebhookEvent: (req) => verifyResendWebhookEvent(req, webhookSecret)
+	};
+});
+
+//#endregion
+export { ResendPlugin, canUpgradeStatus, getRetryDelayMs, getSegment, isTestEmail, normalizeHeaders, normalizeRecipientList, parseEmailEvent, shouldRetry };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitcn/resend",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "description": "kitcn Resend plugin",
   "type": "module",
   "sideEffects": false,
@@ -13,6 +13,7 @@
   ],
   "scripts": {
     "build": "tsdown",
+    "prepack": "bun run build",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {