@absolutejs/dispatch-resend 0.0.1

package/README.md

@@ -0,0 +1,86 @@
+# @absolutejs/dispatch-resend
+
+Resend-backed `EmailAdapter` for
+[@absolutejs/dispatch](https://github.com/absolutejs/dispatch).
+
+## Install
+
+```sh
+bun add @absolutejs/dispatch @absolutejs/dispatch-resend resend
+```
+
+## Usage
+
+```ts
+import { Resend } from 'resend';
+import { createDispatcher } from '@absolutejs/dispatch';
+import { createResendAdapter } from '@absolutejs/dispatch-resend';
+
+const resend = new Resend(process.env.RESEND_KEY!);
+
+const dispatcher = createDispatcher({
+  email: createResendAdapter({
+    client: resend,
+    defaultFrom: 'no-reply@acme.io',
+  }),
+});
+
+const result = await dispatcher.email({
+  to: 'alice@example.com',
+  subject: 'Welcome to Acme',
+  text: 'Click here to verify: ...',
+  // String metadata becomes Resend tags by default:
+  metadata: { campaign: 'welcome-v2', priority: 'high' },
+});
+
+console.log(result.id); // Resend's message id
+```
+
+## API
+
+```ts
+createResendAdapter({
+  client,         // Required — your `new Resend(apiKey)`
+  defaultFrom?,   // Required if your messages don't set `from`
+  tagsFromMetadata?,  // Customize metadata → Resend tags mapping
+})
+```
+
+### `tagsFromMetadata`
+
+By default the adapter maps every **string-valued** entry in
+`message.metadata` to a Resend tag. Non-string values (numbers,
+booleans, objects) are filtered out — Resend requires `string` for
+both `name` and `value`.
+
+Override to customize:
+
+```ts
+createResendAdapter({
+  client: resend,
+  tagsFromMetadata: (metadata) => [
+    // Always include the tenant
+    ...(typeof metadata.tenant === 'string'
+      ? [{ name: 'tenant', value: metadata.tenant }]
+      : []),
+    // Drop debug-only entries
+  ],
+});
+```
+
+## Error mapping
+
+Resend's `{ data, error }` response shape becomes:
+
+- `error` set → adapter throws (`@absolutejs/dispatch` records the
+  exception on the `dispatch.email.send` span, bumps `failed`
+  counter, emits `dispatch.email.failed` audit event).
+- `data.id` present → `DispatchResult.id` = the Resend message id.
+- `data.id` missing → `DispatchResult.id` is `undefined`,
+  `result.provider` still `'resend'`.
+
+## License
+
+[Apache 2.0](../LICENSE). Tier B substrate-adjacent under the
+AbsoluteJS licensing policy — rides `@absolutejs/dispatch` (BSL Tier
+A) and `resend` (MIT).

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @absolutejs/dispatch-resend — Resend-backed `EmailAdapter` for
+ * `@absolutejs/dispatch`.
+ *
+ * Takes the user's Resend client (so they control the API key, the
+ * fetch impl, the timeout config — everything the Resend SDK accepts
+ * directly). Maps `EmailMessage` to Resend's request shape and the
+ * response's `id` to `DispatchResult.id`.
+ *
+ * Resend errors propagate as Promise rejections — `@absolutejs/dispatch`
+ * captures them on the `dispatch.email.send` span, bumps the failed
+ * counter, emits the `dispatch.email.failed` audit event, and re-throws.
+ */
+import type { EmailAdapter } from '@absolutejs/dispatch';
+/**
+ * Minimal subset of Resend's `Resend` client we use. Declaring it
+ * locally keeps `resend` a true peer dep — its types aren't required
+ * at compile time, only its tag-template-style API at runtime.
+ */
+export type ResendClientLike = {
+    emails: {
+        send: (params: {
+            from: string;
+            to: string | string[];
+            subject: string;
+            text?: string;
+            html?: string;
+            reply_to?: string | string[];
+            cc?: string | string[];
+            bcc?: string | string[];
+            headers?: Record<string, string>;
+            tags?: Array<{
+                name: string;
+                value: string;
+            }>;
+        }) => Promise<{
+            data?: {
+                id?: string;
+            } | null;
+            error?: unknown;
+        }>;
+    };
+};
+export type CreateResendAdapterOptions = {
+    /** The Resend client (`new Resend(process.env.RESEND_KEY)`). */
+    client: ResendClientLike;
+    /**
+     * Default `from` address. Resend REQUIRES `from`; if neither the
+     * message nor this default is set, the adapter throws.
+     */
+    defaultFrom?: string;
+    /**
+     * Map `EmailMessage.metadata` to Resend's `tags` array. The default
+     * passes through string-valued entries (Resend tags must be strings).
+     * Override to filter / transform / drop based on your conventions.
+     */
+    tagsFromMetadata?: (metadata: Record<string, unknown>) => Array<{
+        name: string;
+        value: string;
+    }> | undefined;
+};
+export declare const createResendAdapter: (options: CreateResendAdapterOptions) => EmailAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,sBAAsB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,MAAM,EAAE;QACP,IAAI,EAAE,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,MAAM,CAAC;YACb,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YACtB,OAAO,EAAE,MAAM,CAAC;YAChB,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YAC7B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;YACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjC,IAAI,CAAC,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9C,KAAK,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,EAAE,CAAC,EAAE,MAAM,CAAA;aAAE,GAAG,IAAI,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;KAClE,CAAC;CACF,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,gEAAgE;IAChE,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,CAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CACxD,CAAC;AAsBF,eAAO,MAAM,mBAAmB,GAC/B,SAAS,0BAA0B,KACjC,YA4DF,CAAC"}

package/dist/index.js

@@ -0,0 +1,58 @@
+// @bun
+// src/index.ts
+var defaultTagsFromMetadata = (metadata) => {
+  const tags = [];
+  for (const [name, value] of Object.entries(metadata)) {
+    if (typeof value === "string") {
+      tags.push({ name, value });
+    }
+  }
+  return tags.length > 0 ? tags : undefined;
+};
+var arrayOrUndefined = (value) => {
+  if (value === undefined)
+    return;
+  if (typeof value === "string")
+    return value;
+  return [...value];
+};
+var createResendAdapter = (options) => {
+  const { client } = options;
+  const tagsFromMetadata = options.tagsFromMetadata ?? defaultTagsFromMetadata;
+  return {
+    name: "resend",
+    send: async (message) => {
+      const from = message.from ?? options.defaultFrom;
+      if (from === undefined || from.length === 0) {
+        throw new Error("[dispatch-resend] no `from` address \u2014 Resend requires one. " + "Pass `message.from` per send, or `createResendAdapter({ defaultFrom })`.");
+      }
+      const tags = message.metadata !== undefined ? tagsFromMetadata(message.metadata) : undefined;
+      const response = await client.emails.send({
+        from,
+        to: typeof message.to === "string" ? message.to : [...message.to],
+        subject: message.subject,
+        ...message.text !== undefined ? { text: message.text } : {},
+        ...message.html !== undefined ? { html: message.html } : {},
+        ...message.replyTo !== undefined ? { reply_to: message.replyTo } : {},
+        ...arrayOrUndefined(message.cc) !== undefined ? { cc: arrayOrUndefined(message.cc) } : {},
+        ...arrayOrUndefined(message.bcc) !== undefined ? { bcc: arrayOrUndefined(message.bcc) } : {},
+        ...message.headers !== undefined ? { headers: message.headers } : {},
+        ...tags !== undefined ? { tags } : {}
+      });
+      if (response.error !== undefined && response.error !== null) {
+        throw new Error(typeof response.error === "object" && response.error !== null && "message" in response.error ? String(response.error.message) : `[dispatch-resend] Resend error: ${JSON.stringify(response.error)}`);
+      }
+      return {
+        at: Date.now(),
+        ...response.data?.id !== undefined ? { id: response.data.id } : {},
+        provider: "resend"
+      };
+    }
+  };
+};
+export {
+  createResendAdapter
+};
+
+//# debugId=00F1909FAADE107B64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": [
+    "/**\n * @absolutejs/dispatch-resend — Resend-backed `EmailAdapter` for\n * `@absolutejs/dispatch`.\n *\n * Takes the user's Resend client (so they control the API key, the\n * fetch impl, the timeout config — everything the Resend SDK accepts\n * directly). Maps `EmailMessage` to Resend's request shape and the\n * response's `id` to `DispatchResult.id`.\n *\n * Resend errors propagate as Promise rejections — `@absolutejs/dispatch`\n * captures them on the `dispatch.email.send` span, bumps the failed\n * counter, emits the `dispatch.email.failed` audit event, and re-throws.\n */\nimport type { EmailAdapter, EmailMessage } from '@absolutejs/dispatch';\n\n/**\n * Minimal subset of Resend's `Resend` client we use. Declaring it\n * locally keeps `resend` a true peer dep — its types aren't required\n * at compile time, only its tag-template-style API at runtime.\n */\nexport type ResendClientLike = {\n\temails: {\n\t\tsend: (params: {\n\t\t\tfrom: string;\n\t\t\tto: string | string[];\n\t\t\tsubject: string;\n\t\t\ttext?: string;\n\t\t\thtml?: string;\n\t\t\treply_to?: string | string[];\n\t\t\tcc?: string | string[];\n\t\t\tbcc?: string | string[];\n\t\t\theaders?: Record<string, string>;\n\t\t\ttags?: Array<{ name: string; value: string }>;\n\t\t}) => Promise<{ data?: { id?: string } | null; error?: unknown }>;\n\t};\n};\n\nexport type CreateResendAdapterOptions = {\n\t/** The Resend client (`new Resend(process.env.RESEND_KEY)`). */\n\tclient: ResendClientLike;\n\t/**\n\t * Default `from` address. Resend REQUIRES `from`; if neither the\n\t * message nor this default is set, the adapter throws.\n\t */\n\tdefaultFrom?: string;\n\t/**\n\t * Map `EmailMessage.metadata` to Resend's `tags` array. The default\n\t * passes through string-valued entries (Resend tags must be strings).\n\t * Override to filter / transform / drop based on your conventions.\n\t */\n\ttagsFromMetadata?: (\n\t\tmetadata: Record<string, unknown>\n\t) => Array<{ name: string; value: string }> | undefined;\n};\n\nconst defaultTagsFromMetadata = (\n\tmetadata: Record<string, unknown>\n): Array<{ name: string; value: string }> | undefined => {\n\tconst tags: Array<{ name: string; value: string }> = [];\n\tfor (const [name, value] of Object.entries(metadata)) {\n\t\tif (typeof value === 'string') {\n\t\t\ttags.push({ name, value });\n\t\t}\n\t}\n\treturn tags.length > 0 ? tags : undefined;\n};\n\nconst arrayOrUndefined = (\n\tvalue: string | ReadonlyArray<string> | undefined\n): string | string[] | undefined => {\n\tif (value === undefined) return undefined;\n\tif (typeof value === 'string') return value;\n\treturn [...value];\n};\n\nexport const createResendAdapter = (\n\toptions: CreateResendAdapterOptions\n): EmailAdapter => {\n\tconst { client } = options;\n\tconst tagsFromMetadata =\n\t\toptions.tagsFromMetadata ?? defaultTagsFromMetadata;\n\n\treturn {\n\t\tname: 'resend',\n\t\tsend: async (message: EmailMessage) => {\n\t\t\tconst from = message.from ?? options.defaultFrom;\n\t\t\tif (from === undefined || from.length === 0) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\t'[dispatch-resend] no `from` address — Resend requires one. ' +\n\t\t\t\t\t\t'Pass `message.from` per send, or `createResendAdapter({ defaultFrom })`.'\n\t\t\t\t);\n\t\t\t}\n\t\t\tconst tags =\n\t\t\t\tmessage.metadata !== undefined\n\t\t\t\t\t? tagsFromMetadata(message.metadata)\n\t\t\t\t\t: undefined;\n\t\t\tconst response = await client.emails.send({\n\t\t\t\tfrom,\n\t\t\t\tto:\n\t\t\t\t\ttypeof message.to === 'string' ? message.to : [...message.to],\n\t\t\t\tsubject: message.subject,\n\t\t\t\t...(message.text !== undefined ? { text: message.text } : {}),\n\t\t\t\t...(message.html !== undefined ? { html: message.html } : {}),\n\t\t\t\t...(message.replyTo !== undefined\n\t\t\t\t\t? { reply_to: message.replyTo }\n\t\t\t\t\t: {}),\n\t\t\t\t...(arrayOrUndefined(message.cc) !== undefined\n\t\t\t\t\t? { cc: arrayOrUndefined(message.cc) }\n\t\t\t\t\t: {}),\n\t\t\t\t...(arrayOrUndefined(message.bcc) !== undefined\n\t\t\t\t\t? { bcc: arrayOrUndefined(message.bcc) }\n\t\t\t\t\t: {}),\n\t\t\t\t...(message.headers !== undefined\n\t\t\t\t\t? { headers: message.headers }\n\t\t\t\t\t: {}),\n\t\t\t\t...(tags !== undefined ? { tags } : {})\n\t\t\t});\n\t\t\tif (response.error !== undefined && response.error !== null) {\n\t\t\t\tthrow new Error(\n\t\t\t\t\ttypeof response.error === 'object' &&\n\t\t\t\t\tresponse.error !== null &&\n\t\t\t\t\t'message' in response.error\n\t\t\t\t\t\t? String(\n\t\t\t\t\t\t\t\t(response.error as { message: unknown }).message\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: `[dispatch-resend] Resend error: ${JSON.stringify(response.error)}`\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tat: Date.now(),\n\t\t\t\t...(response.data?.id !== undefined\n\t\t\t\t\t? { id: response.data.id }\n\t\t\t\t\t: {}),\n\t\t\t\tprovider: 'resend'\n\t\t\t};\n\t\t}\n\t};\n};\n"
+  ],
+  "mappings": ";;AAuDA,IAAM,0BAA0B,CAC/B,aACwD;AAAA,EACxD,MAAM,OAA+C,CAAC;AAAA,EACtD,YAAY,MAAM,UAAU,OAAO,QAAQ,QAAQ,GAAG;AAAA,IACrD,IAAI,OAAO,UAAU,UAAU;AAAA,MAC9B,KAAK,KAAK,EAAE,MAAM,MAAM,CAAC;AAAA,IAC1B;AAAA,EACD;AAAA,EACA,OAAO,KAAK,SAAS,IAAI,OAAO;AAAA;AAGjC,IAAM,mBAAmB,CACxB,UACmC;AAAA,EACnC,IAAI,UAAU;AAAA,IAAW;AAAA,EACzB,IAAI,OAAO,UAAU;AAAA,IAAU,OAAO;AAAA,EACtC,OAAO,CAAC,GAAG,KAAK;AAAA;AAGV,IAAM,sBAAsB,CAClC,YACkB;AAAA,EAClB,QAAQ,WAAW;AAAA,EACnB,MAAM,mBACL,QAAQ,oBAAoB;AAAA,EAE7B,OAAO;AAAA,IACN,MAAM;AAAA,IACN,MAAM,OAAO,YAA0B;AAAA,MACtC,MAAM,OAAO,QAAQ,QAAQ,QAAQ;AAAA,MACrC,IAAI,SAAS,aAAa,KAAK,WAAW,GAAG;AAAA,QAC5C,MAAM,IAAI,MACT,qEACC,0EACF;AAAA,MACD;AAAA,MACA,MAAM,OACL,QAAQ,aAAa,YAClB,iBAAiB,QAAQ,QAAQ,IACjC;AAAA,MACJ,MAAM,WAAW,MAAM,OAAO,OAAO,KAAK;AAAA,QACzC;AAAA,QACA,IACC,OAAO,QAAQ,OAAO,WAAW,QAAQ,KAAK,CAAC,GAAG,QAAQ,EAAE;AAAA,QAC7D,SAAS,QAAQ;AAAA,WACb,QAAQ,SAAS,YAAY,EAAE,MAAM,QAAQ,KAAK,IAAI,CAAC;AAAA,WACvD,QAAQ,SAAS,YAAY,EAAE,MAAM,QAAQ,KAAK,IAAI,CAAC;AAAA,WACvD,QAAQ,YAAY,YACrB,EAAE,UAAU,QAAQ,QAAQ,IAC5B,CAAC;AAAA,WACA,iBAAiB,QAAQ,EAAE,MAAM,YAClC,EAAE,IAAI,iBAAiB,QAAQ,EAAE,EAAE,IACnC,CAAC;AAAA,WACA,iBAAiB,QAAQ,GAAG,MAAM,YACnC,EAAE,KAAK,iBAAiB,QAAQ,GAAG,EAAE,IACrC,CAAC;AAAA,WACA,QAAQ,YAAY,YACrB,EAAE,SAAS,QAAQ,QAAQ,IAC3B,CAAC;AAAA,WACA,SAAS,YAAY,EAAE,KAAK,IAAI,CAAC;AAAA,MACtC,CAAC;AAAA,MACD,IAAI,SAAS,UAAU,aAAa,SAAS,UAAU,MAAM;AAAA,QAC5D,MAAM,IAAI,MACT,OAAO,SAAS,UAAU,YAC1B,SAAS,UAAU,QACnB,aAAa,SAAS,QACnB,OACC,SAAS,MAA+B,OAC1C,IACC,mCAAmC,KAAK,UAAU,SAAS,KAAK,GACpE;AAAA,MACD;AAAA,MACA,OAAO;AAAA,QACN,IAAI,KAAK,IAAI;AAAA,WACT,SAAS,MAAM,OAAO,YACvB,EAAE,IAAI,SAAS,KAAK,GAAG,IACvB,CAAC;AAAA,QACJ,UAAU;AAAA,MACX;AAAA;AAAA,EAEF;AAAA;",
+  "debugId": "00F1909FAADE107B64756E2164756E21",
+  "names": []
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+	"name": "@absolutejs/dispatch-resend",
+	"version": "0.0.1",
+	"description": "Resend-backed EmailAdapter for @absolutejs/dispatch. Takes your Resend client; emits standard DispatchResult with the Resend message id.",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/absolutejs/dispatch-adapters.git",
+		"directory": "resend"
+	},
+	"main": "./dist/index.js",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"license": "Apache-2.0",
+	"author": "Alex Kahn",
+	"publishConfig": {
+		"access": "public"
+	},
+	"keywords": [
+		"dispatch",
+		"email",
+		"resend",
+		"absolutejs",
+		"transactional"
+	],
+	"scripts": {
+		"build": "rm -rf dist && bun build src/index.ts --outdir dist --sourcemap --target=bun --external @absolutejs/dispatch --external resend && tsc --project tsconfig.build.json",
+		"test": "bun test",
+		"typecheck": "tsc --noEmit",
+		"format": "prettier --write \"./**/*.{ts,json,md}\"",
+		"release": "bun run format && bun run build && bun publish"
+	},
+	"peerDependencies": {
+		"@absolutejs/dispatch": ">= 0.0.1",
+		"resend": ">= 4.0.0"
+	},
+	"devDependencies": {
+		"@absolutejs/dispatch": "^0.0.1",
+		"@types/bun": "1.3.14",
+		"prettier": "3.5.3",
+		"resend": "^4.5.0",
+		"typescript": "5.8.3"
+	},
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	]
+}