easy-ping 0.1.0

package/dist/plugins/push.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/push/index.ts"],"names":[],"mappings":"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","file":"push.cjs","sourcesContent":["import type { DeliveryOutcome } from \"../../core/adapter\";\nimport type { DeliverContext, EasyPingPlugin, PluginInitContext } from \"../../core/plugin\";\n\nconst DEVICE = \"notification_push_device\";\n\nexport type PushSubscription = {\n  endpoint: string;\n  keys: { p256dh: string; auth: string };\n};\n\nexport type PushMessage = {\n  subscription: PushSubscription;\n  title: string;\n  body: string;\n  data?: Record<string, unknown> | undefined;\n  signal?: AbortSignal | undefined;\n};\n\nexport type PushSendResult = {\n  /** True when the endpoint is permanently gone (404/410) and must be pruned. */\n  expired?: boolean;\n  retryable?: boolean;\n};\n\nexport type PushProvider = {\n  name: string;\n  send(message: PushMessage): Promise<PushSendResult>;\n};\n\nexport type PushDevice = {\n  id: string;\n  userId: string;\n  endpoint: string;\n  p256dh: string;\n  auth: string;\n  userAgent: string | null;\n  createdAt: Date;\n  lastSeenAt: Date;\n};\n\nexport type PushOptions = {\n  provider: PushProvider;\n  /** Builds the notification shown on the device. */\n  render: (input: { type: string; payload: unknown }) => { title: string; body: string };\n  /** Devices untouched for this long are pruned on next delivery. */\n  staleAfterDays?: number;\n};\n\n/**\n * Web push over the device registry.\n *\n * Tokens are per device, not per user, so a delivery fans out and succeeds if\n * any endpoint accepts. Endpoints that report themselves gone are deleted\n * immediately: an unpruned registry accumulates dead subscriptions forever and\n * every send slows down behind them.\n */\nexport function push(options: PushOptions): EasyPingPlugin<\"push\"> {\n  let ctx: PluginInitContext;\n  const staleAfterDays = options.staleAfterDays ?? 180;\n\n  return {\n    id: \"push\",\n    channels: [\"push\"],\n\n    init: (context) => {\n      ctx = context;\n    },\n\n    schema: {\n      pushDevice: {\n        tableName: DEVICE,\n        fields: {\n          id: { type: \"string\", required: true },\n          userId: { type: \"string\", required: true },\n          endpoint: { type: \"string\", required: true },\n          p256dh: { type: \"string\", required: true },\n          auth: { type: \"string\", required: true },\n          userAgent: { type: \"string\" },\n          createdAt: { type: \"date\", required: true, defaultNow: true },\n          lastSeenAt: { type: \"date\", required: true, defaultNow: true },\n        },\n        primaryKey: [\"id\"],\n        indexes: [\n          { on: [\"userId\"], name: \"push_device_user_idx\" },\n          // One row per endpoint: re-registering the same browser must update,\n          // not duplicate, or every send goes out N times to one device.\n          { on: [\"endpoint\"], unique: true, name: \"push_device_endpoint_idx\" },\n        ],\n      },\n    },\n\n    hooks: {\n      deliver: async (context: DeliverContext): Promise<DeliveryOutcome> => {\n        const devices = await ctx.store.find<PushDevice>(DEVICE, {\n          userId: context.notification.userId,\n        });\n\n        if (devices.length === 0) {\n          return { result: \"failed\", error: \"no registered devices\", retryable: false };\n        }\n\n        const content = options.render({\n          type: context.notification.type,\n          payload: context.notification.payload,\n        });\n\n        const expired: string[] = [];\n        let delivered = 0;\n        let retryable = false;\n        let lastError = \"\";\n\n        for (const device of devices) {\n          try {\n            const result = await options.provider.send({\n              subscription: {\n                endpoint: device.endpoint,\n                keys: { p256dh: device.p256dh, auth: device.auth },\n              },\n              ...content,\n              data: { notificationId: context.notification.id, type: context.notification.type },\n              signal: context.signal,\n            });\n\n            if (result.expired) expired.push(device.id);\n            else {\n              delivered += 1;\n              if (result.retryable) retryable = true;\n            }\n          } catch (error) {\n            lastError = error instanceof Error ? error.message : String(error);\n            retryable = true;\n          }\n        }\n\n        if (expired.length > 0) await ctx.store.remove(DEVICE, { id: { in: expired } });\n\n        if (delivered > 0) return { result: \"sent\" };\n\n        // Every endpoint was gone: retrying cannot help, and the rows are\n        // already deleted.\n        if (expired.length === devices.length) {\n          return { result: \"failed\", error: \"all devices expired\", retryable: false };\n        }\n\n        return {\n          result: \"failed\",\n          error: lastError || \"no device accepted the push\",\n          retryable,\n        };\n      },\n    },\n\n    routes: [\n      {\n        path: \"/push/devices\",\n        method: \"POST\",\n        scope: { type: \"user\" },\n        handler: async ({ request, userId }) => {\n          const body = (await request.json().catch(() => null)) as PushSubscription | null;\n          if (!body?.endpoint || !body.keys?.p256dh || !body.keys?.auth) {\n            return Response.json({ error: \"endpoint and keys are required\" }, { status: 400 });\n          }\n\n          // Upsert on endpoint: the same browser re-registering after a\n          // service-worker update must not create a second row.\n          await ctx.store.upsert(\n            DEVICE,\n            [\n              {\n                id: crypto.randomUUID(),\n                userId: userId ?? \"\",\n                endpoint: body.endpoint,\n                p256dh: body.keys.p256dh,\n                auth: body.keys.auth,\n                userAgent: request.headers.get(\"user-agent\"),\n                createdAt: new Date(),\n                lastSeenAt: new Date(),\n              },\n            ],\n            { onConflict: [\"endpoint\"] },\n          );\n\n          return Response.json({ ok: true });\n        },\n      },\n\n      {\n        path: \"/push/devices/remove\",\n        method: \"POST\",\n        scope: { type: \"user\" },\n        handler: async ({ request, userId }) => {\n          const body = (await request.json().catch(() => null)) as { endpoint?: string } | null;\n          if (!body?.endpoint) {\n            return Response.json({ error: \"endpoint is required\" }, { status: 400 });\n          }\n\n          // Scoped by userId as well as endpoint: an endpoint string is not a\n          // secret, and must not let one user unregister another's device.\n          const removed = await ctx.store.remove(DEVICE, {\n            userId: userId ?? \"\",\n            endpoint: body.endpoint,\n          });\n\n          return removed === 0 ? new Response(null, { status: 404 }) : Response.json({ ok: true });\n        },\n      },\n\n      {\n        path: \"/push/prune\",\n        method: \"POST\",\n        scope: { type: \"machine\" },\n        handler: async () => {\n          const cutoff = new Date(Date.now() - staleAfterDays * 86_400_000);\n          const removed = await ctx.store.remove(DEVICE, { lastSeenAt: { lt: cutoff } });\n          return Response.json({ removed });\n        },\n      },\n    ],\n  };\n}\n"]}

package/dist/plugins/push.d.cts

@@ -0,0 +1,60 @@
+import { h as EasyPingPlugin } from '../plugin-Bqj9xAOS.cjs';
+import '../adapter-f0OR2DhY.cjs';
+
+type PushSubscription = {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+};
+type PushMessage = {
+    subscription: PushSubscription;
+    title: string;
+    body: string;
+    data?: Record<string, unknown> | undefined;
+    signal?: AbortSignal | undefined;
+};
+type PushSendResult = {
+    /** True when the endpoint is permanently gone (404/410) and must be pruned. */
+    expired?: boolean;
+    retryable?: boolean;
+};
+type PushProvider = {
+    name: string;
+    send(message: PushMessage): Promise<PushSendResult>;
+};
+type PushDevice = {
+    id: string;
+    userId: string;
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+    userAgent: string | null;
+    createdAt: Date;
+    lastSeenAt: Date;
+};
+type PushOptions = {
+    provider: PushProvider;
+    /** Builds the notification shown on the device. */
+    render: (input: {
+        type: string;
+        payload: unknown;
+    }) => {
+        title: string;
+        body: string;
+    };
+    /** Devices untouched for this long are pruned on next delivery. */
+    staleAfterDays?: number;
+};
+/**
+ * Web push over the device registry.
+ *
+ * Tokens are per device, not per user, so a delivery fans out and succeeds if
+ * any endpoint accepts. Endpoints that report themselves gone are deleted
+ * immediately: an unpruned registry accumulates dead subscriptions forever and
+ * every send slows down behind them.
+ */
+declare function push(options: PushOptions): EasyPingPlugin<"push">;
+
+export { type PushDevice, type PushMessage, type PushOptions, type PushProvider, type PushSendResult, type PushSubscription, push };

package/dist/plugins/push.d.ts

@@ -0,0 +1,60 @@
+import { h as EasyPingPlugin } from '../plugin-bTJKmnlq.js';
+import '../adapter-f0OR2DhY.js';
+
+type PushSubscription = {
+    endpoint: string;
+    keys: {
+        p256dh: string;
+        auth: string;
+    };
+};
+type PushMessage = {
+    subscription: PushSubscription;
+    title: string;
+    body: string;
+    data?: Record<string, unknown> | undefined;
+    signal?: AbortSignal | undefined;
+};
+type PushSendResult = {
+    /** True when the endpoint is permanently gone (404/410) and must be pruned. */
+    expired?: boolean;
+    retryable?: boolean;
+};
+type PushProvider = {
+    name: string;
+    send(message: PushMessage): Promise<PushSendResult>;
+};
+type PushDevice = {
+    id: string;
+    userId: string;
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+    userAgent: string | null;
+    createdAt: Date;
+    lastSeenAt: Date;
+};
+type PushOptions = {
+    provider: PushProvider;
+    /** Builds the notification shown on the device. */
+    render: (input: {
+        type: string;
+        payload: unknown;
+    }) => {
+        title: string;
+        body: string;
+    };
+    /** Devices untouched for this long are pruned on next delivery. */
+    staleAfterDays?: number;
+};
+/**
+ * Web push over the device registry.
+ *
+ * Tokens are per device, not per user, so a delivery fans out and succeeds if
+ * any endpoint accepts. Endpoints that report themselves gone are deleted
+ * immediately: an unpruned registry accumulates dead subscriptions forever and
+ * every send slows down behind them.
+ */
+declare function push(options: PushOptions): EasyPingPlugin<"push">;
+
+export { type PushDevice, type PushMessage, type PushOptions, type PushProvider, type PushSendResult, type PushSubscription, push };

package/dist/plugins/push.js

@@ -0,0 +1,144 @@
+// src/plugins/push/index.ts
+var DEVICE = "notification_push_device";
+function push(options) {
+  let ctx;
+  const staleAfterDays = options.staleAfterDays ?? 180;
+  return {
+    id: "push",
+    channels: ["push"],
+    init: (context) => {
+      ctx = context;
+    },
+    schema: {
+      pushDevice: {
+        tableName: DEVICE,
+        fields: {
+          id: { type: "string", required: true },
+          userId: { type: "string", required: true },
+          endpoint: { type: "string", required: true },
+          p256dh: { type: "string", required: true },
+          auth: { type: "string", required: true },
+          userAgent: { type: "string" },
+          createdAt: { type: "date", required: true, defaultNow: true },
+          lastSeenAt: { type: "date", required: true, defaultNow: true }
+        },
+        primaryKey: ["id"],
+        indexes: [
+          { on: ["userId"], name: "push_device_user_idx" },
+          // One row per endpoint: re-registering the same browser must update,
+          // not duplicate, or every send goes out N times to one device.
+          { on: ["endpoint"], unique: true, name: "push_device_endpoint_idx" }
+        ]
+      }
+    },
+    hooks: {
+      deliver: async (context) => {
+        const devices = await ctx.store.find(DEVICE, {
+          userId: context.notification.userId
+        });
+        if (devices.length === 0) {
+          return { result: "failed", error: "no registered devices", retryable: false };
+        }
+        const content = options.render({
+          type: context.notification.type,
+          payload: context.notification.payload
+        });
+        const expired = [];
+        let delivered = 0;
+        let retryable = false;
+        let lastError = "";
+        for (const device of devices) {
+          try {
+            const result = await options.provider.send({
+              subscription: {
+                endpoint: device.endpoint,
+                keys: { p256dh: device.p256dh, auth: device.auth }
+              },
+              ...content,
+              data: { notificationId: context.notification.id, type: context.notification.type },
+              signal: context.signal
+            });
+            if (result.expired) expired.push(device.id);
+            else {
+              delivered += 1;
+              if (result.retryable) retryable = true;
+            }
+          } catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+            retryable = true;
+          }
+        }
+        if (expired.length > 0) await ctx.store.remove(DEVICE, { id: { in: expired } });
+        if (delivered > 0) return { result: "sent" };
+        if (expired.length === devices.length) {
+          return { result: "failed", error: "all devices expired", retryable: false };
+        }
+        return {
+          result: "failed",
+          error: lastError || "no device accepted the push",
+          retryable
+        };
+      }
+    },
+    routes: [
+      {
+        path: "/push/devices",
+        method: "POST",
+        scope: { type: "user" },
+        handler: async ({ request, userId }) => {
+          const body = await request.json().catch(() => null);
+          if (!body?.endpoint || !body.keys?.p256dh || !body.keys?.auth) {
+            return Response.json({ error: "endpoint and keys are required" }, { status: 400 });
+          }
+          await ctx.store.upsert(
+            DEVICE,
+            [
+              {
+                id: crypto.randomUUID(),
+                userId: userId ?? "",
+                endpoint: body.endpoint,
+                p256dh: body.keys.p256dh,
+                auth: body.keys.auth,
+                userAgent: request.headers.get("user-agent"),
+                createdAt: /* @__PURE__ */ new Date(),
+                lastSeenAt: /* @__PURE__ */ new Date()
+              }
+            ],
+            { onConflict: ["endpoint"] }
+          );
+          return Response.json({ ok: true });
+        }
+      },
+      {
+        path: "/push/devices/remove",
+        method: "POST",
+        scope: { type: "user" },
+        handler: async ({ request, userId }) => {
+          const body = await request.json().catch(() => null);
+          if (!body?.endpoint) {
+            return Response.json({ error: "endpoint is required" }, { status: 400 });
+          }
+          const removed = await ctx.store.remove(DEVICE, {
+            userId: userId ?? "",
+            endpoint: body.endpoint
+          });
+          return removed === 0 ? new Response(null, { status: 404 }) : Response.json({ ok: true });
+        }
+      },
+      {
+        path: "/push/prune",
+        method: "POST",
+        scope: { type: "machine" },
+        handler: async () => {
+          const cutoff = new Date(Date.now() - staleAfterDays * 864e5);
+          const removed = await ctx.store.remove(DEVICE, { lastSeenAt: { lt: cutoff } });
+          return Response.json({ removed });
+        }
+      }
+    ]
+  };
+}
+
+export { push };
+//# sourceMappingURL=push.js.map
+//# sourceMappingURL=push.js.map

package/dist/plugins/push.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/plugins/push/index.ts"],"names":[],"mappings":"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","file":"push.js","sourcesContent":["import type { DeliveryOutcome } from \"../../core/adapter\";\nimport type { DeliverContext, EasyPingPlugin, PluginInitContext } from \"../../core/plugin\";\n\nconst DEVICE = \"notification_push_device\";\n\nexport type PushSubscription = {\n  endpoint: string;\n  keys: { p256dh: string; auth: string };\n};\n\nexport type PushMessage = {\n  subscription: PushSubscription;\n  title: string;\n  body: string;\n  data?: Record<string, unknown> | undefined;\n  signal?: AbortSignal | undefined;\n};\n\nexport type PushSendResult = {\n  /** True when the endpoint is permanently gone (404/410) and must be pruned. */\n  expired?: boolean;\n  retryable?: boolean;\n};\n\nexport type PushProvider = {\n  name: string;\n  send(message: PushMessage): Promise<PushSendResult>;\n};\n\nexport type PushDevice = {\n  id: string;\n  userId: string;\n  endpoint: string;\n  p256dh: string;\n  auth: string;\n  userAgent: string | null;\n  createdAt: Date;\n  lastSeenAt: Date;\n};\n\nexport type PushOptions = {\n  provider: PushProvider;\n  /** Builds the notification shown on the device. */\n  render: (input: { type: string; payload: unknown }) => { title: string; body: string };\n  /** Devices untouched for this long are pruned on next delivery. */\n  staleAfterDays?: number;\n};\n\n/**\n * Web push over the device registry.\n *\n * Tokens are per device, not per user, so a delivery fans out and succeeds if\n * any endpoint accepts. Endpoints that report themselves gone are deleted\n * immediately: an unpruned registry accumulates dead subscriptions forever and\n * every send slows down behind them.\n */\nexport function push(options: PushOptions): EasyPingPlugin<\"push\"> {\n  let ctx: PluginInitContext;\n  const staleAfterDays = options.staleAfterDays ?? 180;\n\n  return {\n    id: \"push\",\n    channels: [\"push\"],\n\n    init: (context) => {\n      ctx = context;\n    },\n\n    schema: {\n      pushDevice: {\n        tableName: DEVICE,\n        fields: {\n          id: { type: \"string\", required: true },\n          userId: { type: \"string\", required: true },\n          endpoint: { type: \"string\", required: true },\n          p256dh: { type: \"string\", required: true },\n          auth: { type: \"string\", required: true },\n          userAgent: { type: \"string\" },\n          createdAt: { type: \"date\", required: true, defaultNow: true },\n          lastSeenAt: { type: \"date\", required: true, defaultNow: true },\n        },\n        primaryKey: [\"id\"],\n        indexes: [\n          { on: [\"userId\"], name: \"push_device_user_idx\" },\n          // One row per endpoint: re-registering the same browser must update,\n          // not duplicate, or every send goes out N times to one device.\n          { on: [\"endpoint\"], unique: true, name: \"push_device_endpoint_idx\" },\n        ],\n      },\n    },\n\n    hooks: {\n      deliver: async (context: DeliverContext): Promise<DeliveryOutcome> => {\n        const devices = await ctx.store.find<PushDevice>(DEVICE, {\n          userId: context.notification.userId,\n        });\n\n        if (devices.length === 0) {\n          return { result: \"failed\", error: \"no registered devices\", retryable: false };\n        }\n\n        const content = options.render({\n          type: context.notification.type,\n          payload: context.notification.payload,\n        });\n\n        const expired: string[] = [];\n        let delivered = 0;\n        let retryable = false;\n        let lastError = \"\";\n\n        for (const device of devices) {\n          try {\n            const result = await options.provider.send({\n              subscription: {\n                endpoint: device.endpoint,\n                keys: { p256dh: device.p256dh, auth: device.auth },\n              },\n              ...content,\n              data: { notificationId: context.notification.id, type: context.notification.type },\n              signal: context.signal,\n            });\n\n            if (result.expired) expired.push(device.id);\n            else {\n              delivered += 1;\n              if (result.retryable) retryable = true;\n            }\n          } catch (error) {\n            lastError = error instanceof Error ? error.message : String(error);\n            retryable = true;\n          }\n        }\n\n        if (expired.length > 0) await ctx.store.remove(DEVICE, { id: { in: expired } });\n\n        if (delivered > 0) return { result: \"sent\" };\n\n        // Every endpoint was gone: retrying cannot help, and the rows are\n        // already deleted.\n        if (expired.length === devices.length) {\n          return { result: \"failed\", error: \"all devices expired\", retryable: false };\n        }\n\n        return {\n          result: \"failed\",\n          error: lastError || \"no device accepted the push\",\n          retryable,\n        };\n      },\n    },\n\n    routes: [\n      {\n        path: \"/push/devices\",\n        method: \"POST\",\n        scope: { type: \"user\" },\n        handler: async ({ request, userId }) => {\n          const body = (await request.json().catch(() => null)) as PushSubscription | null;\n          if (!body?.endpoint || !body.keys?.p256dh || !body.keys?.auth) {\n            return Response.json({ error: \"endpoint and keys are required\" }, { status: 400 });\n          }\n\n          // Upsert on endpoint: the same browser re-registering after a\n          // service-worker update must not create a second row.\n          await ctx.store.upsert(\n            DEVICE,\n            [\n              {\n                id: crypto.randomUUID(),\n                userId: userId ?? \"\",\n                endpoint: body.endpoint,\n                p256dh: body.keys.p256dh,\n                auth: body.keys.auth,\n                userAgent: request.headers.get(\"user-agent\"),\n                createdAt: new Date(),\n                lastSeenAt: new Date(),\n              },\n            ],\n            { onConflict: [\"endpoint\"] },\n          );\n\n          return Response.json({ ok: true });\n        },\n      },\n\n      {\n        path: \"/push/devices/remove\",\n        method: \"POST\",\n        scope: { type: \"user\" },\n        handler: async ({ request, userId }) => {\n          const body = (await request.json().catch(() => null)) as { endpoint?: string } | null;\n          if (!body?.endpoint) {\n            return Response.json({ error: \"endpoint is required\" }, { status: 400 });\n          }\n\n          // Scoped by userId as well as endpoint: an endpoint string is not a\n          // secret, and must not let one user unregister another's device.\n          const removed = await ctx.store.remove(DEVICE, {\n            userId: userId ?? \"\",\n            endpoint: body.endpoint,\n          });\n\n          return removed === 0 ? new Response(null, { status: 404 }) : Response.json({ ok: true });\n        },\n      },\n\n      {\n        path: \"/push/prune\",\n        method: \"POST\",\n        scope: { type: \"machine\" },\n        handler: async () => {\n          const cutoff = new Date(Date.now() - staleAfterDays * 86_400_000);\n          const removed = await ctx.store.remove(DEVICE, { lastSeenAt: { lt: cutoff } });\n          return Response.json({ removed });\n        },\n      },\n    ],\n  };\n}\n"]}

package/dist/provider-CA45WVqt.d.cts

@@ -0,0 +1,23 @@
+type ProviderSendResult = {
+    providerMessageId?: string | undefined;
+};
+type EmailMessage = {
+    to: string;
+    subject: string;
+    html: string;
+    text?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    /** Derived from the delivery id. Delivery is at-least-once; see RFC 0003. */
+    idempotencyKey: string;
+    /** Aborted on timeout; honour it or the request outlives the recorded failure. */
+    signal?: AbortSignal | undefined;
+};
+type EmailProvider = {
+    name: string;
+    timeoutMs?: number;
+    send(message: EmailMessage): Promise<ProviderSendResult>;
+    /** False fails the delivery outright; a revoked key is not worth 45min of backoff. */
+    isRetryable(error: unknown): boolean;
+};
+
+export type { EmailProvider as E, ProviderSendResult as P, EmailMessage as a };

package/dist/provider-CA45WVqt.d.ts

@@ -0,0 +1,23 @@
+type ProviderSendResult = {
+    providerMessageId?: string | undefined;
+};
+type EmailMessage = {
+    to: string;
+    subject: string;
+    html: string;
+    text?: string | undefined;
+    headers?: Record<string, string> | undefined;
+    /** Derived from the delivery id. Delivery is at-least-once; see RFC 0003. */
+    idempotencyKey: string;
+    /** Aborted on timeout; honour it or the request outlives the recorded failure. */
+    signal?: AbortSignal | undefined;
+};
+type EmailProvider = {
+    name: string;
+    timeoutMs?: number;
+    send(message: EmailMessage): Promise<ProviderSendResult>;
+    /** False fails the delivery outright; a revoked key is not worth 45min of backoff. */
+    isRetryable(error: unknown): boolean;
+};
+
+export type { EmailProvider as E, ProviderSendResult as P, EmailMessage as a };

package/dist/providers/resend.cjs

@@ -0,0 +1,69 @@
+'use strict';
+
+// src/providers/resend/index.ts
+var ResendError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "ResendError";
+    this.status = status;
+  }
+};
+function classify(status) {
+  if (status === 408 || status === 429) return true;
+  return status >= 500;
+}
+function resend(options) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const baseUrl = options.baseUrl ?? "https://api.resend.com";
+  return {
+    name: "resend",
+    ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+    async send(message) {
+      let response;
+      try {
+        response = await doFetch(`${baseUrl}/emails`, {
+          method: "POST",
+          ...message.signal ? { signal: message.signal } : {},
+          headers: {
+            Authorization: `Bearer ${options.apiKey}`,
+            "Content-Type": "application/json",
+            // Delivery is at-least-once; a retry must not send twice.
+            "Idempotency-Key": message.idempotencyKey
+          },
+          body: JSON.stringify({
+            from: options.from,
+            to: message.to,
+            subject: message.subject,
+            html: message.html,
+            ...message.text ? { text: message.text } : {},
+            ...options.replyTo ? { reply_to: options.replyTo } : {},
+            ...message.headers ? { headers: message.headers } : {}
+          })
+        });
+      } catch (error) {
+        throw new ResendError(error instanceof Error ? error.message : String(error));
+      }
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new ResendError(
+          `resend responded ${response.status}${body ? `: ${body.slice(0, 500)}` : ""}`,
+          response.status
+        );
+      }
+      const payload = await response.json().catch(() => null);
+      return payload?.id ? { providerMessageId: payload.id } : {};
+    },
+    isRetryable(error) {
+      if (error instanceof ResendError) {
+        return error.status === void 0 ? true : classify(error.status);
+      }
+      return error instanceof Error && error.message.includes("timed out");
+    }
+  };
+}
+
+exports.ResendError = ResendError;
+exports.resend = resend;
+//# sourceMappingURL=resend.cjs.map
+//# sourceMappingURL=resend.cjs.map

package/dist/providers/resend.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/resend/index.ts"],"names":[],"mappings":"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","file":"resend.cjs","sourcesContent":["import type { EmailProvider } from \"../../core/provider\";\n\nexport type ResendOptions = {\n  apiKey: string;\n  /** Verified sender, e.g. \"Acme <notifications@acme.dev>\". */\n  from: string;\n  replyTo?: string;\n  timeoutMs?: number;\n  /** Overridable for tests. */\n  fetch?: typeof globalThis.fetch;\n  baseUrl?: string;\n};\n\nexport class ResendError extends Error {\n  readonly status: number | undefined;\n\n  constructor(message: string, status?: number) {\n    super(message);\n    this.name = \"ResendError\";\n    this.status = status;\n  }\n}\n\n/** Rate limits, timeouts and 5xx may work later. Auth and validation never will. */\nfunction classify(status: number): boolean {\n  if (status === 408 || status === 429) return true;\n  return status >= 500;\n}\n\n/** Plain fetch, no SDK: it is one POST, and adapters should not add deps. */\nexport function resend(options: ResendOptions): EmailProvider {\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const baseUrl = options.baseUrl ?? \"https://api.resend.com\";\n\n  return {\n    name: \"resend\",\n    ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),\n\n    async send(message) {\n      let response: Response;\n      try {\n        response = await doFetch(`${baseUrl}/emails`, {\n          method: \"POST\",\n          ...(message.signal ? { signal: message.signal } : {}),\n          headers: {\n            Authorization: `Bearer ${options.apiKey}`,\n            \"Content-Type\": \"application/json\",\n            // Delivery is at-least-once; a retry must not send twice.\n            \"Idempotency-Key\": message.idempotencyKey,\n          },\n          body: JSON.stringify({\n            from: options.from,\n            to: message.to,\n            subject: message.subject,\n            html: message.html,\n            ...(message.text ? { text: message.text } : {}),\n            ...(options.replyTo ? { reply_to: options.replyTo } : {}),\n            ...(message.headers ? { headers: message.headers } : {}),\n          }),\n        });\n      } catch (error) {\n        // Network-level failure — no status, always worth retrying.\n        throw new ResendError(error instanceof Error ? error.message : String(error));\n      }\n\n      if (!response.ok) {\n        const body = await response.text().catch(() => \"\");\n        throw new ResendError(\n          `resend responded ${response.status}${body ? `: ${body.slice(0, 500)}` : \"\"}`,\n          response.status,\n        );\n      }\n\n      const payload = (await response.json().catch(() => null)) as { id?: string } | null;\n      return payload?.id ? { providerMessageId: payload.id } : {};\n    },\n\n    isRetryable(error) {\n      if (error instanceof ResendError) {\n        // No status means the request never landed: DNS, socket, timeout.\n        return error.status === undefined ? true : classify(error.status);\n      }\n      // Timeouts from the runner's own guard arrive as plain Errors.\n      return error instanceof Error && error.message.includes(\"timed out\");\n    },\n  };\n}\n"]}

package/dist/providers/resend.d.cts

@@ -0,0 +1,20 @@
+import { E as EmailProvider } from '../provider-CA45WVqt.cjs';
+
+type ResendOptions = {
+    apiKey: string;
+    /** Verified sender, e.g. "Acme <notifications@acme.dev>". */
+    from: string;
+    replyTo?: string;
+    timeoutMs?: number;
+    /** Overridable for tests. */
+    fetch?: typeof globalThis.fetch;
+    baseUrl?: string;
+};
+declare class ResendError extends Error {
+    readonly status: number | undefined;
+    constructor(message: string, status?: number);
+}
+/** Plain fetch, no SDK: it is one POST, and adapters should not add deps. */
+declare function resend(options: ResendOptions): EmailProvider;
+
+export { ResendError, type ResendOptions, resend };

package/dist/providers/resend.d.ts

@@ -0,0 +1,20 @@
+import { E as EmailProvider } from '../provider-CA45WVqt.js';
+
+type ResendOptions = {
+    apiKey: string;
+    /** Verified sender, e.g. "Acme <notifications@acme.dev>". */
+    from: string;
+    replyTo?: string;
+    timeoutMs?: number;
+    /** Overridable for tests. */
+    fetch?: typeof globalThis.fetch;
+    baseUrl?: string;
+};
+declare class ResendError extends Error {
+    readonly status: number | undefined;
+    constructor(message: string, status?: number);
+}
+/** Plain fetch, no SDK: it is one POST, and adapters should not add deps. */
+declare function resend(options: ResendOptions): EmailProvider;
+
+export { ResendError, type ResendOptions, resend };

package/dist/providers/resend.js

@@ -0,0 +1,66 @@
+// src/providers/resend/index.ts
+var ResendError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.name = "ResendError";
+    this.status = status;
+  }
+};
+function classify(status) {
+  if (status === 408 || status === 429) return true;
+  return status >= 500;
+}
+function resend(options) {
+  const doFetch = options.fetch ?? globalThis.fetch;
+  const baseUrl = options.baseUrl ?? "https://api.resend.com";
+  return {
+    name: "resend",
+    ...options.timeoutMs === void 0 ? {} : { timeoutMs: options.timeoutMs },
+    async send(message) {
+      let response;
+      try {
+        response = await doFetch(`${baseUrl}/emails`, {
+          method: "POST",
+          ...message.signal ? { signal: message.signal } : {},
+          headers: {
+            Authorization: `Bearer ${options.apiKey}`,
+            "Content-Type": "application/json",
+            // Delivery is at-least-once; a retry must not send twice.
+            "Idempotency-Key": message.idempotencyKey
+          },
+          body: JSON.stringify({
+            from: options.from,
+            to: message.to,
+            subject: message.subject,
+            html: message.html,
+            ...message.text ? { text: message.text } : {},
+            ...options.replyTo ? { reply_to: options.replyTo } : {},
+            ...message.headers ? { headers: message.headers } : {}
+          })
+        });
+      } catch (error) {
+        throw new ResendError(error instanceof Error ? error.message : String(error));
+      }
+      if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        throw new ResendError(
+          `resend responded ${response.status}${body ? `: ${body.slice(0, 500)}` : ""}`,
+          response.status
+        );
+      }
+      const payload = await response.json().catch(() => null);
+      return payload?.id ? { providerMessageId: payload.id } : {};
+    },
+    isRetryable(error) {
+      if (error instanceof ResendError) {
+        return error.status === void 0 ? true : classify(error.status);
+      }
+      return error instanceof Error && error.message.includes("timed out");
+    }
+  };
+}
+
+export { ResendError, resend };
+//# sourceMappingURL=resend.js.map
+//# sourceMappingURL=resend.js.map

package/dist/providers/resend.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/providers/resend/index.ts"],"names":[],"mappings":"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","file":"resend.js","sourcesContent":["import type { EmailProvider } from \"../../core/provider\";\n\nexport type ResendOptions = {\n  apiKey: string;\n  /** Verified sender, e.g. \"Acme <notifications@acme.dev>\". */\n  from: string;\n  replyTo?: string;\n  timeoutMs?: number;\n  /** Overridable for tests. */\n  fetch?: typeof globalThis.fetch;\n  baseUrl?: string;\n};\n\nexport class ResendError extends Error {\n  readonly status: number | undefined;\n\n  constructor(message: string, status?: number) {\n    super(message);\n    this.name = \"ResendError\";\n    this.status = status;\n  }\n}\n\n/** Rate limits, timeouts and 5xx may work later. Auth and validation never will. */\nfunction classify(status: number): boolean {\n  if (status === 408 || status === 429) return true;\n  return status >= 500;\n}\n\n/** Plain fetch, no SDK: it is one POST, and adapters should not add deps. */\nexport function resend(options: ResendOptions): EmailProvider {\n  const doFetch = options.fetch ?? globalThis.fetch;\n  const baseUrl = options.baseUrl ?? \"https://api.resend.com\";\n\n  return {\n    name: \"resend\",\n    ...(options.timeoutMs === undefined ? {} : { timeoutMs: options.timeoutMs }),\n\n    async send(message) {\n      let response: Response;\n      try {\n        response = await doFetch(`${baseUrl}/emails`, {\n          method: \"POST\",\n          ...(message.signal ? { signal: message.signal } : {}),\n          headers: {\n            Authorization: `Bearer ${options.apiKey}`,\n            \"Content-Type\": \"application/json\",\n            // Delivery is at-least-once; a retry must not send twice.\n            \"Idempotency-Key\": message.idempotencyKey,\n          },\n          body: JSON.stringify({\n            from: options.from,\n            to: message.to,\n            subject: message.subject,\n            html: message.html,\n            ...(message.text ? { text: message.text } : {}),\n            ...(options.replyTo ? { reply_to: options.replyTo } : {}),\n            ...(message.headers ? { headers: message.headers } : {}),\n          }),\n        });\n      } catch (error) {\n        // Network-level failure — no status, always worth retrying.\n        throw new ResendError(error instanceof Error ? error.message : String(error));\n      }\n\n      if (!response.ok) {\n        const body = await response.text().catch(() => \"\");\n        throw new ResendError(\n          `resend responded ${response.status}${body ? `: ${body.slice(0, 500)}` : \"\"}`,\n          response.status,\n        );\n      }\n\n      const payload = (await response.json().catch(() => null)) as { id?: string } | null;\n      return payload?.id ? { providerMessageId: payload.id } : {};\n    },\n\n    isRetryable(error) {\n      if (error instanceof ResendError) {\n        // No status means the request never landed: DNS, socket, timeout.\n        return error.status === undefined ? true : classify(error.status);\n      }\n      // Timeouts from the runner's own guard arrive as plain Errors.\n      return error instanceof Error && error.message.includes(\"timed out\");\n    },\n  };\n}\n"]}