@particle-academy/resend-js 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+# Changelog
+
+All notable changes to `@particle-academy/resend-ui`, `@particle-academy/resend-js`,
+`particle-academy/resend-php` and `fancy-resend`.
+
+The four packages share one version, because they are generated from one
+`provider/` definition and a version that meant something different in each
+would be a version nobody could reason about.
+
+## [0.1.0] — 2026-08-20
+
+First release. Ported from the vendored connector at
+`px-ui-sandbox/resources/flow-nodes/_resend`.
+
+### Added
+
+- `email_send` — send an email. `POST /emails`, JSON body.
+- A faker for it, so the node runs on a canvas with no key, no network and no
+  Resend account.
+- Webhook signature verification is NOT included; see below.
+
+### The reason this provider exists in the set
+
+**Resend has no test estate.** Roughly a third of the providers worth
+connecting do not — and for every one of them "just try it" means writing to
+production. So `mode` here offers `fake` and `live` and nothing else: offering
+a choice the provider cannot honour is an invitation to pick it and read an
+error.
+
+Resend's simulator recipients (`delivered@resend.dev`, `bounced@resend.dev`, …)
+look like a sandbox and are not one. Those sends are real, billed, and counted
+against the quota. Modelling them as an estate would put a live send behind a
+control labelled "test".
+
+### Two places this deliberately diverges from what it ported
+
+- **The faker returns only `id`.** The predecessor's returned `from`, `to`,
+  `subject`, `created_at` and `last_event` too. Those belong to
+  `GET /emails/{id}`; `POST /emails` answers with one field. A faker richer
+  than the provider lets an author wire a path that works against the fake and
+  is `undefined` on the first real send.
+- **An idempotency key is sent.** The predecessor accepted one and did not
+  supply it. The generated executor derives it from the run and the node, so a
+  resumed durable run mails nobody twice.
+
+### Not here yet
+
+Resend signs its webhooks with **Svix**, and three things about that scheme are
+outside the generator's verification vocabulary today: the signed payload is
+`{svix-id}.{svix-timestamp}.{body}` and `{svix-id}` is not a payload slot; the
+signature header carries a space-separated list of `v1,<sig>` pairs, which is
+neither `compound` nor `prefixed`; and the secret is base64 *after* its
+`whsec_` prefix and must be decoded to raw bytes before it is used as the HMAC
+key. Adding it means extending the vocabulary in three directions at once, and
+it is the next thing that will genuinely stress it — Stripe is currently the
+only webhook the vocabulary has ever described.
+
+[0.1.0]: https://github.com/Fancy-Friends/resend/releases/tag/v0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Particle Academy
+
+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,51 @@
+# Resend
+
+Resend for [fancy-flow][flow] — as **four imported, versioned packages**, one
+per runtime. Not vendored source: a copy cannot be upgraded, and third-party APIs
+change.
+
+[flow]: https://github.com/Particle-Academy/fancy-flow
+
+| Runtime | Package | Install |
+|---|---|---|
+| Authoring surface (every host) | `@particle-academy/resend-ui` | `npm install @particle-academy/resend-ui` |
+| Node | `@particle-academy/resend-js` | `npm install @particle-academy/resend-js` |
+| PHP 8.4+ | `particle-academy/resend-php` | `composer require particle-academy/resend-php` |
+| Python 3.11+ | `fancy-resend` | `pip install fancy-resend` |
+
+The `ui` package is the editor surface and is React on every host — a PHP or
+Python project installs it *and* its own runtime package, and never the `js` one.
+
+## What it costs you
+
+One dependency: `@particle-academy/fancy-connector-core` (or
+`particle-academy/fancy-connector-core` on Composer), which the `js` and `php`
+packages pull in themselves. The Python package has **zero** runtime
+dependencies.
+
+**No Resend SDK.** Plain HTTP, deliberately: a vendor SDK is third-party code
+subject to the kit's full approval bar, and one per provider is hundreds of
+dependencies nobody is tracking.
+
+## Run it before you have credentials
+
+Every operation ships a **faker**, whether or not Resend has a sandbox. Set a
+node's mode to `fake` and it returns the shape Resend actually publishes — the
+same field names, deterministically — so you can wire the downstream nodes before
+touching an account, a key, or a network.
+
+## This repository is generated
+
+`provider/` is the source. Everything under `packages/` is emitted from it and
+**must not be hand-edited** — CI regenerates and diffs on every push, and the
+next protocol sync destroys anything it finds. See [`AGENTS.md`](AGENTS.md).
+
+## Two namespaces, which do not match on purpose
+
+The repo is `github.com/Fancy-Friends/resend`; the packages publish under
+`particle-academy`. Nothing derives one from the other — the names come from
+weaver's `friends.json` and nowhere else.
+
+## Licence
+
+MIT.

package/dist/chunk-QIYVVKWU.js

@@ -0,0 +1,99 @@
+import { callConnector } from '@particle-academy/fancy-connector-core';
+
+// src/faker.ts
+function fakeEmailSend({ config, fake }) {
+  return {
+    "id": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`
+  };
+}
+var resendFaker = (operation, request) => {
+  switch (operation) {
+    case "email_send":
+      return fakeEmailSend(request);
+    default:
+      throw new Error(
+        `resend: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var RESEND_BASE_URLS = {
+  "live": "https://api.resend.com"
+};
+var RESEND_REQUIRES = [
+  "apiKey"
+];
+function resendAuthorize(credentials, request, _mode) {
+  request.headers["User-Agent"] = "fancy-flow-connector";
+  request.headers.Authorization = `Bearer ${credentials.apiKey ?? ""}`;
+}
+var RESEND = {
+  service: "resend",
+  title: "Resend",
+  sandbox: "none",
+  baseUrls: { ...RESEND_BASE_URLS },
+  requires: [...RESEND_REQUIRES],
+  authorize: resendAuthorize,
+  // Resend honours this for 24 hours. It is what makes a retried durable run
+  // resend nothing instead of mailing the recipient twice -- the difference
+  // between `idempotent` and `unsafe-to-replay` is that this one is merely
+  // embarrassing, not financial, but the header costs nothing and removes it
+  // entirely.
+  idempotencyHeader: "Idempotency-Key",
+  faker: resendFaker
+};
+var EMAIL_SEND_OPERATION = "email_send";
+async function resendEmailSend(options) {
+  const config = options.config ?? {};
+  if (config.from === void 0 || config.from === null || config.from === "") {
+    throw new Error(`email_send: "from" is required (From).`);
+  }
+  if (config.to === void 0 || config.to === null || config.to === "") {
+    throw new Error(`email_send: "to" is required (To).`);
+  }
+  if (!(config.html !== void 0 && config.html !== null && config.html !== "" || config.text !== void 0 && config.text !== null && config.text !== "")) {
+    throw new Error(`email_send: needs an "html" or "text" body \u2014 an empty email is never intended.`);
+  }
+  return callConnector(RESEND, {
+    operation: EMAIL_SEND_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    ...options.idempotencyKey === void 0 ? {} : { idempotencyKey: options.idempotencyKey },
+    request: {
+      method: "POST",
+      path: "/emails",
+      json: {
+        "from": String(config.from),
+        "to": toList(config.to),
+        "subject": config.subject !== void 0 && config.subject !== null && config.subject !== "" ? String(config.subject) : "",
+        ...config.html !== void 0 && config.html !== null && config.html !== "" ? { "html": String(config.html) } : {},
+        ...config.text !== void 0 && config.text !== null && config.text !== "" ? { "text": String(config.text) } : {},
+        ...config.replyTo !== void 0 && config.replyTo !== null && config.replyTo !== "" ? { "reply_to": String(config.replyTo) } : {},
+        "headers": headersMap(config.headers)
+      }
+    }
+  });
+}
+function toList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function headersMap(value) {
+  if (!value || typeof value !== "object") return {};
+  const out = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (item !== void 0 && item !== null && item !== "") out[key] = String(item);
+  }
+  return out;
+}
+
+export { CONNECTOR_API_VERSION, EMAIL_SEND_OPERATION, RESEND, RESEND_BASE_URLS, RESEND_REQUIRES, resendAuthorize, resendEmailSend, resendFaker };
+//# sourceMappingURL=chunk-QIYVVKWU.js.map
+//# sourceMappingURL=chunk-QIYVVKWU.js.map

package/dist/chunk-QIYVVKWU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/email-send.ts"],"names":[],"mappings":"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","file":"chunk-QIYVVKWU.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * The Resend faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Resend actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeEmailSend({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n  };\n}\n\nexport const resendFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"email_send\":\n      return fakeEmailSend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `resend: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Resend, as one service descriptor shared by every Resend operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Resend: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Resend has NO test estate, and somebody checked. Its simulator RECIPIENTS --\n * delivered@resend.dev, bounced@resend.dev, complained@resend.dev,\n * suppressed@resend.dev -- are not one: the send is real, it is billed, and it\n * counts against the quota. Modelling them as a sandbox would put a live send\n * behind a control labelled \"test\", so `mode` does not offer sandbox at all\n * and `fake` is the primary development mode rather than the fallback.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { resendFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const RESEND_BASE_URLS = {\n  \"live\": \"https://api.resend.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const RESEND_REQUIRES = [\n  \"apiKey\"\n] as const;\n\n/**\n * Apply Resend's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function resendAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers[\"User-Agent\"] = \"fancy-flow-connector\";\n\n  request.headers.Authorization = `Bearer ${credentials.apiKey ?? \"\"}`;\n}\n\n/** The Resend service, for the TypeScript runtime. */\nexport const RESEND: ServiceDescriptor = {\n  service: \"resend\",\n  title: \"Resend\",\n  sandbox: \"none\",\n  baseUrls: { ...RESEND_BASE_URLS },\n  requires: [...RESEND_REQUIRES],\n  authorize: resendAuthorize,\n  // Resend honours this for 24 hours. It is what makes a retried durable run\n  // resend nothing instead of mailing the recipient twice -- the difference\n  // between `idempotent` and `unsafe-to-replay` is that this one is merely\n  // embarrassing, not financial, but the header costs nothing and removes it\n  // entirely.\n  idempotencyHeader: \"Idempotency-Key\",\n  faker: resendFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/email-send.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/email-send.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Send an email through Resend.\n *\n * POST /emails — https://resend.com/docs/api-reference/emails/send-email\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Resend or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { RESEND } from \"../service.js\";\n\nexport const EMAIL_SEND_OPERATION = \"email_send\";\n\nexport type EmailSendOptions = {\n  /** The node's resolved config. Keys: from, to, subject, html, text, replyTo, headers. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  /** Derived from the run and the step, never fresh. See the note above. */\n  idempotencyKey?: string;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function resendEmailSend(options: EmailSendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.from === undefined || config.from === null || config.from === \"\") {\n    throw new Error(`email_send: \"from\" is required (From).`);\n  }\n\n  if (config.to === undefined || config.to === null || config.to === \"\") {\n    throw new Error(`email_send: \"to\" is required (To).`);\n  }\n\n  if (!((config.html !== undefined && config.html !== null && config.html !== \"\") || (config.text !== undefined && config.text !== null && config.text !== \"\"))) {\n    throw new Error(`email_send: needs an \"html\" or \"text\" body — an empty email is never intended.`);\n  }\n\n  return callConnector(RESEND, {\n    operation: EMAIL_SEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),\n    request: {\n      method: \"POST\",\n      path: \"/emails\",\n      json: {\n        \"from\": String(config.from),\n        \"to\": toList(config.to),\n        \"subject\": config.subject !== undefined && config.subject !== null && config.subject !== \"\" ? String(config.subject) : \"\",\n        ...(config.html !== undefined && config.html !== null && config.html !== \"\" ? { \"html\": String(config.html) } : {}),\n        ...(config.text !== undefined && config.text !== null && config.text !== \"\" ? { \"text\": String(config.text) } : {}),\n        ...(config.replyTo !== undefined && config.replyTo !== null && config.replyTo !== \"\" ? { \"reply_to\": String(config.replyTo) } : {}),\n        \"headers\": headersMap(config.headers),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction toList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** `{ k: \"v\" }` → `{ \"headers\": { \"k\": \"v\" } }` — a JSON body wants the real object. */\nfunction headersMap(value: unknown): Record<string, string> {\n  if (!value || typeof value !== \"object\") return {};\n\n  const out: Record<string, string> = {};\n  for (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n    if (item !== undefined && item !== null && item !== \"\") out[key] = String(item);\n  }\n\n  return out;\n}\n"]}

package/dist/flow.cjs

@@ -0,0 +1,135 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+var resendUi = require('@particle-academy/resend-ui');
+
+// src/flow.ts
+
+// src/faker.ts
+function fakeEmailSend({ config, fake }) {
+  return {
+    "id": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`
+  };
+}
+var resendFaker = (operation, request) => {
+  switch (operation) {
+    case "email_send":
+      return fakeEmailSend(request);
+    default:
+      throw new Error(
+        `resend: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var RESEND_BASE_URLS = {
+  "live": "https://api.resend.com"
+};
+var RESEND_REQUIRES = [
+  "apiKey"
+];
+function resendAuthorize(credentials, request, _mode) {
+  request.headers["User-Agent"] = "fancy-flow-connector";
+  request.headers.Authorization = `Bearer ${credentials.apiKey ?? ""}`;
+}
+var RESEND = {
+  service: "resend",
+  title: "Resend",
+  sandbox: "none",
+  baseUrls: { ...RESEND_BASE_URLS },
+  requires: [...RESEND_REQUIRES],
+  authorize: resendAuthorize,
+  // Resend honours this for 24 hours. It is what makes a retried durable run
+  // resend nothing instead of mailing the recipient twice -- the difference
+  // between `idempotent` and `unsafe-to-replay` is that this one is merely
+  // embarrassing, not financial, but the header costs nothing and removes it
+  // entirely.
+  idempotencyHeader: "Idempotency-Key",
+  faker: resendFaker
+};
+var EMAIL_SEND_OPERATION = "email_send";
+async function resendEmailSend(options) {
+  const config = options.config ?? {};
+  if (config.from === void 0 || config.from === null || config.from === "") {
+    throw new Error(`email_send: "from" is required (From).`);
+  }
+  if (config.to === void 0 || config.to === null || config.to === "") {
+    throw new Error(`email_send: "to" is required (To).`);
+  }
+  if (!(config.html !== void 0 && config.html !== null && config.html !== "" || config.text !== void 0 && config.text !== null && config.text !== "")) {
+    throw new Error(`email_send: needs an "html" or "text" body \u2014 an empty email is never intended.`);
+  }
+  return fancyConnectorCore.callConnector(RESEND, {
+    operation: EMAIL_SEND_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    ...options.idempotencyKey === void 0 ? {} : { idempotencyKey: options.idempotencyKey },
+    request: {
+      method: "POST",
+      path: "/emails",
+      json: {
+        "from": String(config.from),
+        "to": toList(config.to),
+        "subject": config.subject !== void 0 && config.subject !== null && config.subject !== "" ? String(config.subject) : "",
+        ...config.html !== void 0 && config.html !== null && config.html !== "" ? { "html": String(config.html) } : {},
+        ...config.text !== void 0 && config.text !== null && config.text !== "" ? { "text": String(config.text) } : {},
+        ...config.replyTo !== void 0 && config.replyTo !== null && config.replyTo !== "" ? { "reply_to": String(config.replyTo) } : {},
+        "headers": headersMap(config.headers)
+      }
+    }
+  });
+}
+function toList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function headersMap(value) {
+  if (!value || typeof value !== "object") return {};
+  const out = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (item !== void 0 && item !== null && item !== "") out[key] = String(item);
+  }
+  return out;
+}
+
+// src/flow.ts
+var resendEmailSendExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const idempotencyKey = fancyConnectorCore.idempotencyKeyFor(ctx, ctx.node.id, {
+    context: { service: "resend", operation: "email_send" }
+  });
+  if (idempotencyKey === null) {
+    ctx.emit({
+      type: "log",
+      level: "warn",
+      nodeId: ctx.node.id,
+      message: `email_send: ${fancyConnectorCore.NO_IDEMPOTENCY_KEY_WARNING}`
+    });
+  }
+  const result = await resendEmailSend({
+    config,
+    input: ctx.inputs?.in,
+    ...idempotencyKey === null ? {} : { idempotencyKey }
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `resend email_send ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var RESEND_RUNNABLE_KINDS = [
+  { ...resendUi.resendEmailSendKind, executor: resendEmailSendExecutor }
+];
+
+exports.RESEND_RUNNABLE_KINDS = RESEND_RUNNABLE_KINDS;
+exports.resendEmailSendExecutor = resendEmailSendExecutor;
+//# sourceMappingURL=flow.cjs.map
+//# sourceMappingURL=flow.cjs.map

package/dist/flow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/email-send.ts","../src/flow.ts"],"names":["callConnector","idempotencyKeyFor","NO_IDEMPOTENCY_KEY_WARNING","resendEmailSendKind"],"mappings":";;;;;;;;AAyBA,SAAS,aAAA,CAAc,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAyB;AAC7D,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,CAAA,EAAG,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,GAAA,CAAI,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA,CAAA,EAAI,IAAA,CAAK,GAAA,CAAI,EAAE,CAAC,CAAA;AAAA,GACnF;AACF;AAEO,IAAM,WAAA,GAA8B,CAAC,SAAA,EAAW,OAAA,KAAY;AACjE,EAAA,QAAQ,SAAA;AAAW,IACjB,KAAK,YAAA;AACH,MAAA,OAAO,cAAc,OAAO,CAAA;AAAA,IAE9B;AAIE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,4CAA4C,SAAS,CAAA,iJAAA;AAAA,OAGvD;AAAA;AAEN,CAAA;;;ACLO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,MAAA,EAAQ;AACV,CAAA;AAGO,IAAM,eAAA,GAAkB;AAAA,EAC7B;AACF,CAAA;AAWO,SAAS,eAAA,CACd,WAAA,EACA,OAAA,EACA,KAAA,EACM;AACN,EAAA,OAAA,CAAQ,OAAA,CAAQ,YAAY,CAAA,GAAI,sBAAA;AAEhC,EAAA,OAAA,CAAQ,OAAA,CAAQ,aAAA,GAAgB,CAAA,OAAA,EAAU,WAAA,CAAY,UAAU,EAAE,CAAA,CAAA;AACpE;AAGO,IAAM,MAAA,GAA4B;AAAA,EACvC,OAAA,EAAS,QAAA;AAAA,EACT,KAAA,EAAO,QAAA;AAAA,EACP,OAAA,EAAS,MAAA;AAAA,EACT,QAAA,EAAU,EAAE,GAAG,gBAAA,EAAiB;AAAA,EAChC,QAAA,EAAU,CAAC,GAAG,eAAe,CAAA;AAAA,EAC7B,SAAA,EAAW,eAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMX,iBAAA,EAAmB,iBAAA;AAAA,EACnB,KAAA,EAAO;AACT,CAAA;ACvDO,IAAM,oBAAA,GAAuB,YAAA;AAgBpC,eAAsB,gBAAgB,OAAA,EAAqD;AACzF,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,EAAC;AAElC,EAAA,IAAI,MAAA,CAAO,SAAS,MAAA,IAAa,MAAA,CAAO,SAAS,IAAA,IAAQ,MAAA,CAAO,SAAS,EAAA,EAAI;AAC3E,IAAA,MAAM,IAAI,MAAM,CAAA,sCAAA,CAAwC,CAAA;AAAA,EAC1D;AAEA,EAAA,IAAI,MAAA,CAAO,OAAO,MAAA,IAAa,MAAA,CAAO,OAAO,IAAA,IAAQ,MAAA,CAAO,OAAO,EAAA,EAAI;AACrE,IAAA,MAAM,IAAI,MAAM,CAAA,kCAAA,CAAoC,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,EAAG,MAAA,CAAO,IAAA,KAAS,UAAa,MAAA,CAAO,IAAA,KAAS,QAAQ,MAAA,CAAO,IAAA,KAAS,EAAA,IAAQ,MAAA,CAAO,SAAS,MAAA,IAAa,MAAA,CAAO,SAAS,IAAA,IAAQ,MAAA,CAAO,SAAS,EAAA,CAAA,EAAM;AAC7J,IAAA,MAAM,IAAI,MAAM,CAAA,mFAAA,CAAgF,CAAA;AAAA,EAClG;AAEA,EAAA,OAAOA,iCAAc,MAAA,EAAQ;AAAA,IAC3B,SAAA,EAAW,oBAAA;AAAA,IACX,MAAA;AAAA,IACA,OAAO,OAAA,CAAQ,KAAA;AAAA,IACf,GAAI,QAAQ,WAAA,KAAgB,MAAA,GAAY,EAAC,GAAI,EAAE,WAAA,EAAa,OAAA,CAAQ,WAAA,EAAY;AAAA,IAChF,GAAI,QAAQ,IAAA,KAAS,MAAA,GAAY,EAAC,GAAI,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAK;AAAA,IAC3D,GAAI,QAAQ,YAAA,KAAiB,MAAA,GAAY,EAAC,GAAI,EAAE,YAAA,EAAc,OAAA,CAAQ,YAAA,EAAa;AAAA,IACnF,GAAI,QAAQ,QAAA,KAAa,MAAA,GAAY,EAAC,GAAI,EAAE,QAAA,EAAU,OAAA,CAAQ,QAAA,EAAS;AAAA,IACvE,GAAI,QAAQ,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAW,OAAA,CAAQ,SAAA,EAAU;AAAA,IAC1E,GAAI,QAAQ,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,cAAA,EAAgB,OAAA,CAAQ,cAAA,EAAe;AAAA,IACzF,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,MAAA;AAAA,MACR,IAAA,EAAM,SAAA;AAAA,MACN,IAAA,EAAM;AAAA,QACJ,MAAA,EAAQ,MAAA,CAAO,MAAA,CAAO,IAAI,CAAA;AAAA,QAC1B,IAAA,EAAM,MAAA,CAAO,MAAA,CAAO,EAAE,CAAA;AAAA,QACtB,SAAA,EAAW,MAAA,CAAO,OAAA,KAAY,MAAA,IAAa,MAAA,CAAO,OAAA,KAAY,IAAA,IAAQ,MAAA,CAAO,OAAA,KAAY,EAAA,GAAK,MAAA,CAAO,MAAA,CAAO,OAAO,CAAA,GAAI,EAAA;AAAA,QACvH,GAAI,MAAA,CAAO,IAAA,KAAS,MAAA,IAAa,MAAA,CAAO,SAAS,IAAA,IAAQ,MAAA,CAAO,IAAA,KAAS,EAAA,GAAK,EAAE,MAAA,EAAQ,MAAA,CAAO,OAAO,IAAI,CAAA,KAAM,EAAC;AAAA,QACjH,GAAI,MAAA,CAAO,IAAA,KAAS,MAAA,IAAa,MAAA,CAAO,SAAS,IAAA,IAAQ,MAAA,CAAO,IAAA,KAAS,EAAA,GAAK,EAAE,MAAA,EAAQ,MAAA,CAAO,OAAO,IAAI,CAAA,KAAM,EAAC;AAAA,QACjH,GAAI,MAAA,CAAO,OAAA,KAAY,MAAA,IAAa,MAAA,CAAO,YAAY,IAAA,IAAQ,MAAA,CAAO,OAAA,KAAY,EAAA,GAAK,EAAE,UAAA,EAAY,MAAA,CAAO,OAAO,OAAO,CAAA,KAAM,EAAC;AAAA,QACjI,SAAA,EAAW,UAAA,CAAW,MAAA,CAAO,OAAO;AAAA;AACtC;AACF,GACD,CAAA;AACH;AAGA,SAAS,OAAO,KAAA,EAA0B;AACxC,EAAA,MAAM,QAAQ,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAC7B,MAAM,GAAA,CAAI,MAAM,CAAA,GAChB,OAAO,UAAU,QAAA,GACf,KAAA,CAAM,KAAA,CAAM,GAAG,IACf,EAAC;AAEP,EAAA,OAAO,KAAA,CAAM,IAAI,CAAC,IAAA,KAAS,KAAK,IAAA,EAAM,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA;AACxD;AAGA,SAAS,WAAW,KAAA,EAAwC;AAC1D,EAAA,IAAI,CAAC,KAAA,IAAS,OAAO,KAAA,KAAU,QAAA,SAAiB,EAAC;AAEjD,EAAA,MAAM,MAA8B,EAAC;AACrC,EAAA,KAAA,MAAW,CAAC,GAAA,EAAK,IAAI,KAAK,MAAA,CAAO,OAAA,CAAQ,KAAgC,CAAA,EAAG;AAC1E,IAAA,IAAI,IAAA,KAAS,MAAA,IAAa,IAAA,KAAS,IAAA,IAAQ,IAAA,KAAS,IAAI,GAAA,CAAI,GAAG,CAAA,GAAI,MAAA,CAAO,IAAI,CAAA;AAAA,EAChF;AAEA,EAAA,OAAO,GAAA;AACT;;;ACvEO,IAAM,uBAAA,GAAwC,OAAO,GAAA,KAAQ;AAClE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAKpF,EAAA,MAAM,cAAA,GAAiBC,oCAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,KAAK,EAAA,EAAI;AAAA,IACzD,OAAA,EAAS,EAAE,OAAA,EAAS,QAAA,EAAU,WAAW,YAAA;AAAa,GACvD,CAAA;AACD,EAAA,IAAI,mBAAmB,IAAA,EAAM;AAC3B,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,IAAA,EAAM,KAAA;AAAA,MACN,KAAA,EAAO,MAAA;AAAA,MACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,MACjB,OAAA,EAAS,eAAeC,6CAA0B,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB;AAAA,IACnC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ,EAAA;AAAA,IACnB,GAAI,cAAA,KAAmB,IAAA,GAAO,EAAC,GAAI,EAAE,cAAA;AAAe,GACrD,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,kBAAA,EAAsB,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACnF,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,qBAAA,GAA8C;AAAA,EACzD,EAAE,GAAGC,4BAAA,EAAqB,QAAA,EAAU,uBAAA;AACtC","file":"flow.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * The Resend faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Resend actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeEmailSend({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n  };\n}\n\nexport const resendFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"email_send\":\n      return fakeEmailSend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `resend: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Resend, as one service descriptor shared by every Resend operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Resend: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Resend has NO test estate, and somebody checked. Its simulator RECIPIENTS --\n * delivered@resend.dev, bounced@resend.dev, complained@resend.dev,\n * suppressed@resend.dev -- are not one: the send is real, it is billed, and it\n * counts against the quota. Modelling them as a sandbox would put a live send\n * behind a control labelled \"test\", so `mode` does not offer sandbox at all\n * and `fake` is the primary development mode rather than the fallback.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { resendFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const RESEND_BASE_URLS = {\n  \"live\": \"https://api.resend.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const RESEND_REQUIRES = [\n  \"apiKey\"\n] as const;\n\n/**\n * Apply Resend's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function resendAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers[\"User-Agent\"] = \"fancy-flow-connector\";\n\n  request.headers.Authorization = `Bearer ${credentials.apiKey ?? \"\"}`;\n}\n\n/** The Resend service, for the TypeScript runtime. */\nexport const RESEND: ServiceDescriptor = {\n  service: \"resend\",\n  title: \"Resend\",\n  sandbox: \"none\",\n  baseUrls: { ...RESEND_BASE_URLS },\n  requires: [...RESEND_REQUIRES],\n  authorize: resendAuthorize,\n  // Resend honours this for 24 hours. It is what makes a retried durable run\n  // resend nothing instead of mailing the recipient twice -- the difference\n  // between `idempotent` and `unsafe-to-replay` is that this one is merely\n  // embarrassing, not financial, but the header costs nothing and removes it\n  // entirely.\n  idempotencyHeader: \"Idempotency-Key\",\n  faker: resendFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/email-send.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/email-send.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Send an email through Resend.\n *\n * POST /emails — https://resend.com/docs/api-reference/emails/send-email\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Resend or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { RESEND } from \"../service.js\";\n\nexport const EMAIL_SEND_OPERATION = \"email_send\";\n\nexport type EmailSendOptions = {\n  /** The node's resolved config. Keys: from, to, subject, html, text, replyTo, headers. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  /** Derived from the run and the step, never fresh. See the note above. */\n  idempotencyKey?: string;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function resendEmailSend(options: EmailSendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.from === undefined || config.from === null || config.from === \"\") {\n    throw new Error(`email_send: \"from\" is required (From).`);\n  }\n\n  if (config.to === undefined || config.to === null || config.to === \"\") {\n    throw new Error(`email_send: \"to\" is required (To).`);\n  }\n\n  if (!((config.html !== undefined && config.html !== null && config.html !== \"\") || (config.text !== undefined && config.text !== null && config.text !== \"\"))) {\n    throw new Error(`email_send: needs an \"html\" or \"text\" body — an empty email is never intended.`);\n  }\n\n  return callConnector(RESEND, {\n    operation: EMAIL_SEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),\n    request: {\n      method: \"POST\",\n      path: \"/emails\",\n      json: {\n        \"from\": String(config.from),\n        \"to\": toList(config.to),\n        \"subject\": config.subject !== undefined && config.subject !== null && config.subject !== \"\" ? String(config.subject) : \"\",\n        ...(config.html !== undefined && config.html !== null && config.html !== \"\" ? { \"html\": String(config.html) } : {}),\n        ...(config.text !== undefined && config.text !== null && config.text !== \"\" ? { \"text\": String(config.text) } : {}),\n        ...(config.replyTo !== undefined && config.replyTo !== null && config.replyTo !== \"\" ? { \"reply_to\": String(config.replyTo) } : {}),\n        \"headers\": headersMap(config.headers),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction toList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** `{ k: \"v\" }` → `{ \"headers\": { \"k\": \"v\" } }` — a JSON body wants the real object. */\nfunction headersMap(value: unknown): Record<string, string> {\n  if (!value || typeof value !== \"object\") return {};\n\n  const out: Record<string, string> = {};\n  for (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n    if (item !== undefined && item !== null && item !== \"\") out[key] = String(item);\n  }\n\n  return out;\n}\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Resend's node kinds with their TypeScript executors attached — for hosts\n * that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/resend-ui carries no executor:\n * the editor is React on every host, so a PHP or Python project installs the\n * ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { RESEND } from \"./service.js\";\n\nimport {\n  resendEmailSendKind,\n} from \"@particle-academy/resend-ui\";\n\nimport { resendEmailSend } from \"./actions/email-send.js\";\n\nexport const resendEmailSendExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  // Derived from the RUN and the NODE, never fresh. A retried durable run\n  // must send the same key or Resend creates a second one — the exact\n  // failure \"idempotent\" exists to prevent.\n  const idempotencyKey = idempotencyKeyFor(ctx, ctx.node.id, {\n    context: { service: \"resend\", operation: \"email_send\" },\n  });\n  if (idempotencyKey === null) {\n    ctx.emit({\n      type: \"log\",\n      level: \"warn\",\n      nodeId: ctx.node.id,\n      message: `email_send: ${NO_IDEMPOTENCY_KEY_WARNING}`,\n    });\n  }\n\n  const result = await resendEmailSend({\n    config,\n    input: ctx.inputs?.in,\n    ...(idempotencyKey === null ? {} : { idempotencyKey }),\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `resend email_send ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const RESEND_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...resendEmailSendKind, executor: resendEmailSendExecutor },\n];\n"]}

package/dist/flow.d.cts

@@ -0,0 +1,26 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Resend's node kinds with their TypeScript executors attached — for hosts
+ * that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/resend-ui carries no executor:
+ * the editor is React on every host, so a PHP or Python project installs the
+ * ui package and never this one.
+ */
+
+declare const resendEmailSendExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const RESEND_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { RESEND_RUNNABLE_KINDS, resendEmailSendExecutor };

package/dist/flow.d.ts

@@ -0,0 +1,26 @@
+import { NodeKindDefinition, NodeExecutor } from '@particle-academy/fancy-flow/engine';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/ + triggers/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/ + triggers/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Resend's node kinds with their TypeScript executors attached — for hosts
+ * that EXECUTE on TS.
+ *
+ * The authoring surface in @particle-academy/resend-ui carries no executor:
+ * the editor is React on every host, so a PHP or Python project installs the
+ * ui package and never this one.
+ */
+
+declare const resendEmailSendExecutor: NodeExecutor;
+/** The kinds a TypeScript host registers. */
+declare const RESEND_RUNNABLE_KINDS: NodeKindDefinition[];
+
+export { RESEND_RUNNABLE_KINDS, resendEmailSendExecutor };

package/dist/flow.js

@@ -0,0 +1,37 @@
+import { resendEmailSend } from './chunk-QIYVVKWU.js';
+import { idempotencyKeyFor, NO_IDEMPOTENCY_KEY_WARNING } from '@particle-academy/fancy-connector-core';
+import { resendEmailSendKind } from '@particle-academy/resend-ui';
+
+var resendEmailSendExecutor = async (ctx) => {
+  const config = ctx.node.data?.config ?? {};
+  const idempotencyKey = idempotencyKeyFor(ctx, ctx.node.id, {
+    context: { service: "resend", operation: "email_send" }
+  });
+  if (idempotencyKey === null) {
+    ctx.emit({
+      type: "log",
+      level: "warn",
+      nodeId: ctx.node.id,
+      message: `email_send: ${NO_IDEMPOTENCY_KEY_WARNING}`
+    });
+  }
+  const result = await resendEmailSend({
+    config,
+    input: ctx.inputs?.in,
+    ...idempotencyKey === null ? {} : { idempotencyKey }
+  });
+  ctx.emit({
+    type: "log",
+    level: "info",
+    nodeId: ctx.node.id,
+    message: `resend email_send ${result.data?.id} (${result.mode})`
+  });
+  return { __port: "out", value: result };
+};
+var RESEND_RUNNABLE_KINDS = [
+  { ...resendEmailSendKind, executor: resendEmailSendExecutor }
+];
+
+export { RESEND_RUNNABLE_KINDS, resendEmailSendExecutor };
+//# sourceMappingURL=flow.js.map
+//# sourceMappingURL=flow.js.map

package/dist/flow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flow.ts"],"names":[],"mappings":";;;;AAoCO,IAAM,uBAAA,GAAwC,OAAO,GAAA,KAAQ;AAClE,EAAA,MAAM,MAAA,GAAW,GAAA,CAAI,IAAA,CAAK,IAAA,EAA+C,UAAU,EAAC;AAKpF,EAAA,MAAM,cAAA,GAAiB,iBAAA,CAAkB,GAAA,EAAK,GAAA,CAAI,KAAK,EAAA,EAAI;AAAA,IACzD,OAAA,EAAS,EAAE,OAAA,EAAS,QAAA,EAAU,WAAW,YAAA;AAAa,GACvD,CAAA;AACD,EAAA,IAAI,mBAAmB,IAAA,EAAM;AAC3B,IAAA,GAAA,CAAI,IAAA,CAAK;AAAA,MACP,IAAA,EAAM,KAAA;AAAA,MACN,KAAA,EAAO,MAAA;AAAA,MACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,MACjB,OAAA,EAAS,eAAe,0BAA0B,CAAA;AAAA,KACnD,CAAA;AAAA,EACH;AAEA,EAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB;AAAA,IACnC,MAAA;AAAA,IACA,KAAA,EAAO,IAAI,MAAA,EAAQ,EAAA;AAAA,IACnB,GAAI,cAAA,KAAmB,IAAA,GAAO,EAAC,GAAI,EAAE,cAAA;AAAe,GACrD,CAAA;AAED,EAAA,GAAA,CAAI,IAAA,CAAK;AAAA,IACP,IAAA,EAAM,KAAA;AAAA,IACN,KAAA,EAAO,MAAA;AAAA,IACP,MAAA,EAAQ,IAAI,IAAA,CAAK,EAAA;AAAA,IACjB,SAAS,CAAA,kBAAA,EAAsB,MAAA,CAAO,MAA0B,EAAE,CAAA,EAAA,EAAK,OAAO,IAAI,CAAA,CAAA;AAAA,GACnF,CAAA;AAED,EAAA,OAAO,EAAE,MAAA,EAAQ,KAAA,EAAO,KAAA,EAAO,MAAA,EAAO;AACxC;AAGO,IAAM,qBAAA,GAA8C;AAAA,EACzD,EAAE,GAAG,mBAAA,EAAqB,QAAA,EAAU,uBAAA;AACtC","file":"flow.js","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/ + triggers/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/ + triggers/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Resend's node kinds with their TypeScript executors attached — for hosts\n * that EXECUTE on TS.\n *\n * The authoring surface in @particle-academy/resend-ui carries no executor:\n * the editor is React on every host, so a PHP or Python project installs the\n * ui package and never this one.\n */\n\nimport type { NodeExecutor, NodeKindDefinition } from \"@particle-academy/fancy-flow/engine\";\nimport {\n  idempotencyKeyFor,\n  NO_IDEMPOTENCY_KEY_WARNING,\n  resolveConnection,\n  triggerEvent,\n  type RequestedMode,\n} from \"@particle-academy/fancy-connector-core\";\nimport { RESEND } from \"./service.js\";\n\nimport {\n  resendEmailSendKind,\n} from \"@particle-academy/resend-ui\";\n\nimport { resendEmailSend } from \"./actions/email-send.js\";\n\nexport const resendEmailSendExecutor: NodeExecutor = async (ctx) => {\n  const config = ((ctx.node.data as { config?: Record<string, unknown> })?.config ?? {});\n\n  // Derived from the RUN and the NODE, never fresh. A retried durable run\n  // must send the same key or Resend creates a second one — the exact\n  // failure \"idempotent\" exists to prevent.\n  const idempotencyKey = idempotencyKeyFor(ctx, ctx.node.id, {\n    context: { service: \"resend\", operation: \"email_send\" },\n  });\n  if (idempotencyKey === null) {\n    ctx.emit({\n      type: \"log\",\n      level: \"warn\",\n      nodeId: ctx.node.id,\n      message: `email_send: ${NO_IDEMPOTENCY_KEY_WARNING}`,\n    });\n  }\n\n  const result = await resendEmailSend({\n    config,\n    input: ctx.inputs?.in,\n    ...(idempotencyKey === null ? {} : { idempotencyKey }),\n  });\n\n  ctx.emit({\n    type: \"log\",\n    level: \"info\",\n    nodeId: ctx.node.id,\n    message: `resend email_send ${(result.data as { id?: string })?.id} (${result.mode})`,\n  });\n\n  return { __port: \"out\", value: result };\n};\n\n/** The kinds a TypeScript host registers. */\nexport const RESEND_RUNNABLE_KINDS: NodeKindDefinition[] = [\n  { ...resendEmailSendKind, executor: resendEmailSendExecutor },\n];\n"]}

package/dist/index.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+var fancyConnectorCore = require('@particle-academy/fancy-connector-core');
+
+// src/faker.ts
+function fakeEmailSend({ config, fake }) {
+  return {
+    "id": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`
+  };
+}
+var resendFaker = (operation, request) => {
+  switch (operation) {
+    case "email_send":
+      return fakeEmailSend(request);
+    default:
+      throw new Error(
+        `resend: no fake response is defined for "${operation}". Add a fixture under provider/fixtures/ and regenerate \u2014 a connector without a faker cannot be developed against, tested, or demonstrated.`
+      );
+  }
+};
+
+// src/service.ts
+var CONNECTOR_API_VERSION = 1;
+var RESEND_BASE_URLS = {
+  "live": "https://api.resend.com"
+};
+var RESEND_REQUIRES = [
+  "apiKey"
+];
+function resendAuthorize(credentials, request, _mode) {
+  request.headers["User-Agent"] = "fancy-flow-connector";
+  request.headers.Authorization = `Bearer ${credentials.apiKey ?? ""}`;
+}
+var RESEND = {
+  service: "resend",
+  title: "Resend",
+  sandbox: "none",
+  baseUrls: { ...RESEND_BASE_URLS },
+  requires: [...RESEND_REQUIRES],
+  authorize: resendAuthorize,
+  // Resend honours this for 24 hours. It is what makes a retried durable run
+  // resend nothing instead of mailing the recipient twice -- the difference
+  // between `idempotent` and `unsafe-to-replay` is that this one is merely
+  // embarrassing, not financial, but the header costs nothing and removes it
+  // entirely.
+  idempotencyHeader: "Idempotency-Key",
+  faker: resendFaker
+};
+var EMAIL_SEND_OPERATION = "email_send";
+async function resendEmailSend(options) {
+  const config = options.config ?? {};
+  if (config.from === void 0 || config.from === null || config.from === "") {
+    throw new Error(`email_send: "from" is required (From).`);
+  }
+  if (config.to === void 0 || config.to === null || config.to === "") {
+    throw new Error(`email_send: "to" is required (To).`);
+  }
+  if (!(config.html !== void 0 && config.html !== null && config.html !== "" || config.text !== void 0 && config.text !== null && config.text !== "")) {
+    throw new Error(`email_send: needs an "html" or "text" body \u2014 an empty email is never intended.`);
+  }
+  return fancyConnectorCore.callConnector(RESEND, {
+    operation: EMAIL_SEND_OPERATION,
+    config,
+    input: options.input,
+    ...options.credentials === void 0 ? {} : { credentials: options.credentials },
+    ...options.mode === void 0 ? {} : { mode: options.mode },
+    ...options.connectionId === void 0 ? {} : { connectionId: options.connectionId },
+    ...options.attempts === void 0 ? {} : { attempts: options.attempts },
+    ...options.transport === void 0 ? {} : { transport: options.transport },
+    ...options.idempotencyKey === void 0 ? {} : { idempotencyKey: options.idempotencyKey },
+    request: {
+      method: "POST",
+      path: "/emails",
+      json: {
+        "from": String(config.from),
+        "to": toList(config.to),
+        "subject": config.subject !== void 0 && config.subject !== null && config.subject !== "" ? String(config.subject) : "",
+        ...config.html !== void 0 && config.html !== null && config.html !== "" ? { "html": String(config.html) } : {},
+        ...config.text !== void 0 && config.text !== null && config.text !== "" ? { "text": String(config.text) } : {},
+        ...config.replyTo !== void 0 && config.replyTo !== null && config.replyTo !== "" ? { "reply_to": String(config.replyTo) } : {},
+        "headers": headersMap(config.headers)
+      }
+    }
+  });
+}
+function toList(value) {
+  const items = Array.isArray(value) ? value.map(String) : typeof value === "string" ? value.split(",") : [];
+  return items.map((item) => item.trim()).filter(Boolean);
+}
+function headersMap(value) {
+  if (!value || typeof value !== "object") return {};
+  const out = {};
+  for (const [key, item] of Object.entries(value)) {
+    if (item !== void 0 && item !== null && item !== "") out[key] = String(item);
+  }
+  return out;
+}
+
+exports.CONNECTOR_API_VERSION = CONNECTOR_API_VERSION;
+exports.EMAIL_SEND_OPERATION = EMAIL_SEND_OPERATION;
+exports.RESEND = RESEND;
+exports.RESEND_BASE_URLS = RESEND_BASE_URLS;
+exports.RESEND_REQUIRES = RESEND_REQUIRES;
+exports.resendAuthorize = resendAuthorize;
+exports.resendEmailSend = resendEmailSend;
+exports.resendFaker = resendFaker;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/email-send.ts"],"names":["callConnector"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/fixtures/ by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/fixtures/ (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * The Resend faker.\n *\n * Shapes, not behaviour: the goal is that a downstream node sees the field\n * NAMES Resend actually publishes, so an author can wire {{ $json.data.id }}\n * against a fake and have it keep working against the real thing.\n *\n * Deterministic — same inputs, same output. A faker returning a fresh uuid\n * every call cannot be asserted on, so its fixtures degrade to \"it did not\n * throw\", which is the assertion that catches nothing.\n */\n\nimport type { ConnectorFaker, FakeRequest } from \"@particle-academy/fancy-connector-core\";\n\nfunction fakeEmailSend({ config, fake }: FakeRequest): unknown {\n  return {\n    \"id\": `${fake.hex(8)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(4)}-${fake.hex(12)}`,\n  };\n}\n\nexport const resendFaker: ConnectorFaker = (operation, request) => {\n  switch (operation) {\n    case \"email_send\":\n      return fakeEmailSend(request);\n\n    default:\n      // A faker asked for an operation it has no shape for must SAY so. Making\n      // something up would produce a green run whose output silently has none\n      // of the fields the author is about to reference.\n      throw new Error(\n        `resend: no fake response is defined for \"${operation}\". ` +\n          \"Add a fixture under provider/fixtures/ and regenerate — a connector without a faker \" +\n          \"cannot be developed against, tested, or demonstrated.\",\n      );\n  }\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/manifest.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/manifest.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Resend, as one service descriptor shared by every Resend operation.\n *\n * @particle-academy/fancy-connector-core carries what is true of ALL\n * connectors. This carries what is true of Resend: its base URL, its auth\n * scheme, its idempotency header, and its faker.\n *\n * ## The sandbox trap, written down where it is used\n *\n * Resend has NO test estate, and somebody checked. Its simulator RECIPIENTS --\n * delivered@resend.dev, bounced@resend.dev, complained@resend.dev,\n * suppressed@resend.dev -- are not one: the send is real, it is billed, and it\n * counts against the quota. Modelling them as a sandbox would put a live send\n * behind a control labelled \"test\", so `mode` does not offer sandbox at all\n * and `fake` is the primary development mode rather than the fallback.\n */\n\nimport type { ConnectorMode, PreparedRequest, ServiceDescriptor } from \"@particle-academy/fancy-connector-core\";\n\nimport { resendFaker } from \"./faker.js\";\n\n/**\n * The connector API version this package was GENERATED against.\n *\n * A literal, never imported. An imported constant lets an upgrade rewrite the\n * very claim it exists to detect, after which the copy agrees with itself\n * forever.\n */\nexport const CONNECTOR_API_VERSION = 1;\n\nexport const RESEND_BASE_URLS = {\n  \"live\": \"https://api.resend.com\"\n} as const;\n\n/** Credential keys a remote call cannot proceed without. */\nexport const RESEND_REQUIRES = [\n  \"apiKey\"\n] as const;\n\n/**\n * Apply Resend's auth scheme to an outgoing request.\n *\n *\n *\n * The mode is passed in because for some providers auth and estate are the\n * same decision expressed in the URL; here it is unused, and saying so is\n * cheaper than wondering later whether it was forgotten.\n */\nexport function resendAuthorize(\n  credentials: Record<string, string | undefined>,\n  request: PreparedRequest,\n  _mode: ConnectorMode,\n): void {\n  request.headers[\"User-Agent\"] = \"fancy-flow-connector\";\n\n  request.headers.Authorization = `Bearer ${credentials.apiKey ?? \"\"}`;\n}\n\n/** The Resend service, for the TypeScript runtime. */\nexport const RESEND: ServiceDescriptor = {\n  service: \"resend\",\n  title: \"Resend\",\n  sandbox: \"none\",\n  baseUrls: { ...RESEND_BASE_URLS },\n  requires: [...RESEND_REQUIRES],\n  authorize: resendAuthorize,\n  // Resend honours this for 24 hours. It is what makes a retried durable run\n  // resend nothing instead of mailing the recipient twice -- the difference\n  // between `idempotent` and `unsafe-to-replay` is that this one is merely\n  // embarrassing, not financial, but the header costs nothing and removes it\n  // entirely.\n  idempotencyHeader: \"Idempotency-Key\",\n  faker: resendFaker,\n};\n","/**\n * GENERATED FILE — do not edit.\n *\n * Emitted from provider/actions/email-send.json by weaver's generator.\n * A hand-edit here is destroyed by the next protocol sync, which is worse than\n * being rejected, because it works until it silently does not. Fix\n * provider/actions/email-send.json (or weaver's template/) and regenerate:\n *\n *     npm run provider -- resend\n */\n\n/**\n * Send an email through Resend.\n *\n * POST /emails — https://resend.com/docs/api-reference/emails/send-email\n *\n * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,\n * no fake/real branch. This describes the request; callConnector resolves the\n * connection, picks the estate, and either calls Resend or calls the faker.\n */\n\nimport {\n  callConnector,\n  type ConnectorResult,\n  type RequestedMode,\n  type Transport,\n} from \"@particle-academy/fancy-connector-core\";\nimport { RESEND } from \"../service.js\";\n\nexport const EMAIL_SEND_OPERATION = \"email_send\";\n\nexport type EmailSendOptions = {\n  /** The node's resolved config. Keys: from, to, subject, html, text, replyTo, headers. */\n  config: Record<string, unknown>;\n  credentials?: Record<string, string | undefined>;\n  mode?: RequestedMode;\n  connectionId?: string | null;\n  input?: unknown;\n  /** Derived from the run and the step, never fresh. See the note above. */\n  idempotencyKey?: string;\n  attempts?: number;\n  /** Override the transport. The only way to exercise this without a network. */\n  transport?: Transport;\n};\n\nexport async function resendEmailSend(options: EmailSendOptions): Promise<ConnectorResult> {\n  const config = options.config ?? {};\n\n  if (config.from === undefined || config.from === null || config.from === \"\") {\n    throw new Error(`email_send: \"from\" is required (From).`);\n  }\n\n  if (config.to === undefined || config.to === null || config.to === \"\") {\n    throw new Error(`email_send: \"to\" is required (To).`);\n  }\n\n  if (!((config.html !== undefined && config.html !== null && config.html !== \"\") || (config.text !== undefined && config.text !== null && config.text !== \"\"))) {\n    throw new Error(`email_send: needs an \"html\" or \"text\" body — an empty email is never intended.`);\n  }\n\n  return callConnector(RESEND, {\n    operation: EMAIL_SEND_OPERATION,\n    config,\n    input: options.input,\n    ...(options.credentials === undefined ? {} : { credentials: options.credentials }),\n    ...(options.mode === undefined ? {} : { mode: options.mode }),\n    ...(options.connectionId === undefined ? {} : { connectionId: options.connectionId }),\n    ...(options.attempts === undefined ? {} : { attempts: options.attempts }),\n    ...(options.transport === undefined ? {} : { transport: options.transport }),\n    ...(options.idempotencyKey === undefined ? {} : { idempotencyKey: options.idempotencyKey }),\n    request: {\n      method: \"POST\",\n      path: \"/emails\",\n      json: {\n        \"from\": String(config.from),\n        \"to\": toList(config.to),\n        \"subject\": config.subject !== undefined && config.subject !== null && config.subject !== \"\" ? String(config.subject) : \"\",\n        ...(config.html !== undefined && config.html !== null && config.html !== \"\" ? { \"html\": String(config.html) } : {}),\n        ...(config.text !== undefined && config.text !== null && config.text !== \"\" ? { \"text\": String(config.text) } : {}),\n        ...(config.replyTo !== undefined && config.replyTo !== null && config.replyTo !== \"\" ? { \"reply_to\": String(config.replyTo) } : {}),\n        \"headers\": headersMap(config.headers),\n      },\n    },\n  });\n}\n\n/** One value, a \",\"-separated string, or an array — all end up a list. */\nfunction toList(value: unknown): string[] {\n  const items = Array.isArray(value)\n    ? value.map(String)\n    : typeof value === \"string\"\n      ? value.split(\",\")\n      : [];\n\n  return items.map((item) => item.trim()).filter(Boolean);\n}\n\n/** `{ k: \"v\" }` → `{ \"headers\": { \"k\": \"v\" } }` — a JSON body wants the real object. */\nfunction headersMap(value: unknown): Record<string, string> {\n  if (!value || typeof value !== \"object\") return {};\n\n  const out: Record<string, string> = {};\n  for (const [key, item] of Object.entries(value as Record<string, unknown>)) {\n    if (item !== undefined && item !== null && item !== \"\") out[key] = String(item);\n  }\n\n  return out;\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,116 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Resend, as one service descriptor shared by every Resend operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Resend: its base URL, its auth
+ * scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Resend has NO test estate, and somebody checked. Its simulator RECIPIENTS --
+ * delivered@resend.dev, bounced@resend.dev, complained@resend.dev,
+ * suppressed@resend.dev -- are not one: the send is real, it is billed, and it
+ * counts against the quota. Modelling them as a sandbox would put a live send
+ * behind a control labelled "test", so `mode` does not offer sandbox at all
+ * and `fake` is the primary development mode rather than the fallback.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const RESEND_BASE_URLS: {
+    readonly live: "https://api.resend.com";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const RESEND_REQUIRES: readonly ["apiKey"];
+/**
+ * Apply Resend's auth scheme to an outgoing request.
+ *
+ *
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function resendAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Resend service, for the TypeScript runtime. */
+declare const RESEND: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * The Resend faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Resend actually publishes, so an author can wire {{ $json.data.id }}
+ * against a fake and have it keep working against the real thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const resendFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/email-send.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/email-send.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Send an email through Resend.
+ *
+ * POST /emails — https://resend.com/docs/api-reference/emails/send-email
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Resend or calls the faker.
+ */
+
+declare const EMAIL_SEND_OPERATION = "email_send";
+type EmailSendOptions = {
+    /** The node's resolved config. Keys: from, to, subject, html, text, replyTo, headers. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    /** Derived from the run and the step, never fresh. See the note above. */
+    idempotencyKey?: string;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function resendEmailSend(options: EmailSendOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, EMAIL_SEND_OPERATION, type EmailSendOptions, RESEND, RESEND_BASE_URLS, RESEND_REQUIRES, resendAuthorize, resendEmailSend, resendFaker };

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/manifest.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/manifest.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Resend, as one service descriptor shared by every Resend operation.
+ *
+ * @particle-academy/fancy-connector-core carries what is true of ALL
+ * connectors. This carries what is true of Resend: its base URL, its auth
+ * scheme, its idempotency header, and its faker.
+ *
+ * ## The sandbox trap, written down where it is used
+ *
+ * Resend has NO test estate, and somebody checked. Its simulator RECIPIENTS --
+ * delivered@resend.dev, bounced@resend.dev, complained@resend.dev,
+ * suppressed@resend.dev -- are not one: the send is real, it is billed, and it
+ * counts against the quota. Modelling them as a sandbox would put a live send
+ * behind a control labelled "test", so `mode` does not offer sandbox at all
+ * and `fake` is the primary development mode rather than the fallback.
+ */
+
+/**
+ * The connector API version this package was GENERATED against.
+ *
+ * A literal, never imported. An imported constant lets an upgrade rewrite the
+ * very claim it exists to detect, after which the copy agrees with itself
+ * forever.
+ */
+declare const CONNECTOR_API_VERSION = 1;
+declare const RESEND_BASE_URLS: {
+    readonly live: "https://api.resend.com";
+};
+/** Credential keys a remote call cannot proceed without. */
+declare const RESEND_REQUIRES: readonly ["apiKey"];
+/**
+ * Apply Resend's auth scheme to an outgoing request.
+ *
+ *
+ *
+ * The mode is passed in because for some providers auth and estate are the
+ * same decision expressed in the URL; here it is unused, and saying so is
+ * cheaper than wondering later whether it was forgotten.
+ */
+declare function resendAuthorize(credentials: Record<string, string | undefined>, request: PreparedRequest, _mode: ConnectorMode): void;
+/** The Resend service, for the TypeScript runtime. */
+declare const RESEND: ServiceDescriptor;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/fixtures/ by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/fixtures/ (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * The Resend faker.
+ *
+ * Shapes, not behaviour: the goal is that a downstream node sees the field
+ * NAMES Resend actually publishes, so an author can wire {{ $json.data.id }}
+ * against a fake and have it keep working against the real thing.
+ *
+ * Deterministic — same inputs, same output. A faker returning a fresh uuid
+ * every call cannot be asserted on, so its fixtures degrade to "it did not
+ * throw", which is the assertion that catches nothing.
+ */
+
+declare const resendFaker: ConnectorFaker;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/email-send.json by weaver's generator.
+ * A hand-edit here is destroyed by the next protocol sync, which is worse than
+ * being rejected, because it works until it silently does not. Fix
+ * provider/actions/email-send.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Send an email through Resend.
+ *
+ * POST /emails — https://resend.com/docs/api-reference/emails/send-email
+ *
+ * Notice what is NOT here: no key, no base URL, no mode check, no retry loop,
+ * no fake/real branch. This describes the request; callConnector resolves the
+ * connection, picks the estate, and either calls Resend or calls the faker.
+ */
+
+declare const EMAIL_SEND_OPERATION = "email_send";
+type EmailSendOptions = {
+    /** The node's resolved config. Keys: from, to, subject, html, text, replyTo, headers. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    /** Derived from the run and the step, never fresh. See the note above. */
+    idempotencyKey?: string;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function resendEmailSend(options: EmailSendOptions): Promise<ConnectorResult>;
+
+export { CONNECTOR_API_VERSION, EMAIL_SEND_OPERATION, type EmailSendOptions, RESEND, RESEND_BASE_URLS, RESEND_REQUIRES, resendAuthorize, resendEmailSend, resendFaker };

package/dist/index.js

@@ -0,0 +1,3 @@
+export { CONNECTOR_API_VERSION, EMAIL_SEND_OPERATION, RESEND, RESEND_BASE_URLS, RESEND_REQUIRES, resendAuthorize, resendEmailSend, resendFaker } from './chunk-QIYVVKWU.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@particle-academy/resend-js",
+  "version": "0.1.0",
+  "description": "Resend for Node — the service descriptor, its faker, its webhook verification, and one function per operation. Plain HTTP on @particle-academy/fancy-connector-core; no vendor SDK.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Fancy-Friends/resend.git"
+  },
+  "homepage": "https://github.com/Fancy-Friends/resend#readme",
+  "bugs": "https://github.com/Fancy-Friends/resend/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./flow": {
+      "import": {
+        "types": "./dist/flow.d.ts",
+        "default": "./dist/flow.js"
+      },
+      "require": {
+        "types": "./dist/flow.d.cts",
+        "default": "./dist/flow.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "lint": "tsc --noEmit",
+    "test": "node --import tsx --test tests/*.test.ts",
+    "prepublishOnly": "tsup"
+  },
+  "dependencies": {
+    "@particle-academy/fancy-connector-core": ">=0.3.1 <2.0",
+    "@particle-academy/resend-ui": "0.1.0"
+  },
+  "peerDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0"
+  },
+  "peerDependenciesMeta": {
+    "@particle-academy/fancy-flow": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
+    "@types/node": "^26.2.0",
+    "tsup": "^8.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "resend",
+    "email",
+    "connector",
+    "api",
+    "fancy-ui",
+    "particle-academy"
+  ],
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  }
+}