@particle-academy/resend-js 0.3.4 → 0.4.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult } from '@particle-academy/fancy-connector-core';
+import { ServiceDescriptor, PreparedRequest, ConnectorMode, ConnectorFaker, RequestedMode, Transport, ConnectorResult, TriggerDescriptor, HmacScheme, InboundDelivery, WebhookVerification } from '@particle-academy/fancy-connector-core';
 
 /**
  * GENERATED FILE — do not edit.
@@ -77,6 +77,112 @@ declare const RESEND: ServiceDescriptor;
 
 declare const resendFaker: ConnectorFaker;
 
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/attachment-get.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/attachment-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Turn one attachment of a received email into a signed download URL.
+ *
+ * GET /emails/receiving/{emailId}/attachments/{attachmentId} —
+ * https://resend.com/docs/api-reference/emails/retrieve-received-email-attachment
+ *
+ * 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 ATTACHMENT_GET_OPERATION = "attachment_get";
+type AttachmentGetOptions = {
+    /** The node's resolved config. Keys: emailId, attachmentId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function resendAttachmentGet(options: AttachmentGetOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/attachment-list.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/attachment-list.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * List a received email's attachments, each with a signed download URL.
+ *
+ * GET /emails/receiving/{emailId}/attachments —
+ * https://resend.com/docs/api-reference/emails/list-received-email-attachments
+ *
+ * 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 ATTACHMENT_LIST_OPERATION = "attachment_list";
+type AttachmentListOptions = {
+    /** The node's resolved config. Keys: emailId, limit, after, before. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function resendAttachmentList(options: AttachmentListOptions): Promise<ConnectorResult>;
+
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/actions/email-get.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-get.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Read a received email in full: its bodies, its headers and the list of its
+ * attachments.
+ *
+ * GET /emails/receiving/{emailId} —
+ * https://resend.com/docs/api-reference/emails/retrieve-received-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_GET_OPERATION = "email_get";
+type EmailGetOptions = {
+    /** The node's resolved config. Keys: emailId. */
+    config: Record<string, unknown>;
+    credentials?: Record<string, string | undefined>;
+    mode?: RequestedMode;
+    connectionId?: string | null;
+    input?: unknown;
+    attempts?: number;
+    /** Override the transport. The only way to exercise this without a network. */
+    transport?: Transport;
+};
+declare function resendEmailGet(options: EmailGetOptions): Promise<ConnectorResult>;
+
 /**
  * GENERATED FILE — do not edit.
  *
@@ -113,4 +219,54 @@ type EmailSendOptions = {
 };
 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 };
+/**
+ * GENERATED FILE — do not edit.
+ *
+ * Emitted from provider/triggers/email-received.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/triggers/email-received.json (or weaver's template/) and regenerate:
+ *
+ *     npm run provider -- resend
+ */
+/**
+ * Resend's webhook trigger — the delivery contract.
+ *
+ * Kept beside the service descriptor rather than inside a node, because a
+ * signature scheme is a fact about RESEND. Two Resend triggers must not be
+ * able to disagree about how a delivery is verified.
+ */
+
+declare const RESEND_EMAIL_RECEIVED_SIGNATURE_HEADER = "svix-signature";
+/** The provider's documented replay window, in seconds. */
+declare const RESEND_EMAIL_RECEIVED_TOLERANCE = 300;
+declare const RESEND_EMAIL_RECEIVED_SCHEME: HmacScheme;
+/**
+ * Split `v1,…` into its parts.
+ *
+ * EVERY signature the header carries is collected, and the delivery passes
+ * when ANY matches: a provider rolling a secret signs once per active secret,
+ * and a first-only rule refused the whole roll as a wrong secret.
+ *
+ * `v1,<base64> v1,<base64>` -- several during a secret rotation, and Svix says
+ * yours must match ONE of them. Every `v1` is offered to the verifier; the
+ * first-only rule that Stripe's header once carried refused a whole roll.
+ */
+declare function parseResendSignature(raw: string): {
+    signatures: string[];
+    timestamp?: string;
+};
+declare const RESEND_EMAIL_RECEIVED: TriggerDescriptor;
+/**
+ * Verify one inbound Resend delivery.
+ *
+ * The host calls this BEFORE starting a run, with the body exactly as
+ * received. Re-serialised JSON changes key order and whitespace, and produces
+ * a mismatch that looks precisely like a wrong secret — hours of debugging the
+ * wrong thing.
+ *
+ * The secret is the connection's `webhookSecret`.
+ */
+declare function verifyResendDelivery(delivery: InboundDelivery, webhookSecret: string | undefined, now?: number): Promise<WebhookVerification>;
+
+export { ATTACHMENT_GET_OPERATION, ATTACHMENT_LIST_OPERATION, type AttachmentGetOptions, type AttachmentListOptions, CONNECTOR_API_VERSION, EMAIL_GET_OPERATION, EMAIL_SEND_OPERATION, type EmailGetOptions, type EmailSendOptions, RESEND, RESEND_BASE_URLS, RESEND_EMAIL_RECEIVED, RESEND_EMAIL_RECEIVED_SCHEME, RESEND_EMAIL_RECEIVED_SIGNATURE_HEADER, RESEND_EMAIL_RECEIVED_TOLERANCE, RESEND_REQUIRES, parseResendSignature, resendAttachmentGet, resendAttachmentList, resendAuthorize, resendEmailGet, resendEmailSend, resendFaker, verifyResendDelivery };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { CONNECTOR_API_VERSION, EMAIL_SEND_OPERATION, RESEND, RESEND_BASE_URLS, RESEND_REQUIRES, resendAuthorize, resendEmailSend, resendFaker } from './chunk-QIYVVKWU.js';
+export { ATTACHMENT_GET_OPERATION, ATTACHMENT_LIST_OPERATION, CONNECTOR_API_VERSION, EMAIL_GET_OPERATION, EMAIL_SEND_OPERATION, RESEND, RESEND_BASE_URLS, RESEND_EMAIL_RECEIVED, RESEND_EMAIL_RECEIVED_SCHEME, RESEND_EMAIL_RECEIVED_SIGNATURE_HEADER, RESEND_EMAIL_RECEIVED_TOLERANCE, RESEND_REQUIRES, parseResendSignature, resendAttachmentGet, resendAttachmentList, resendAuthorize, resendEmailGet, resendEmailSend, resendFaker, verifyResendDelivery } from './chunk-JEKUTTK2.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/resend-js",
-  "version": "0.3.4",
+  "version": "0.4.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",
@@ -38,6 +38,7 @@
   },
   "files": [
     "dist",
+    "art",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -49,11 +50,11 @@
     "prepublishOnly": "tsup"
   },
   "dependencies": {
-    "@particle-academy/fancy-connector-core": ">=0.4.0 <2.0"
+    "@particle-academy/fancy-connector-core": ">=0.9.0 <2.0"
   },
   "peerDependencies": {
     "@particle-academy/fancy-flow": ">=0.47.1 <2.0",
-    "@particle-academy/resend-ui": ">=0.3.0 <0.4.0"
+    "@particle-academy/resend-ui": ">=0.4.0 <0.5.0"
   },
   "peerDependenciesMeta": {
     "@particle-academy/fancy-flow": {

package/dist/chunk-QIYVVKWU.js

@@ -1,99 +0,0 @@
-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

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/faker.ts","../src/service.ts","../src/actions/email-send.ts"],"names":[],"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;;;ACPO,IAAM,qBAAA,GAAwB;AAE9B,IAAM,gBAAA,GAAmB;AAAA,EAC9B,MAAA,EAAQ;AACV;AAGO,IAAM,eAAA,GAAkB;AAAA,EAC7B;AACF;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;ACvDO,IAAM,oBAAA,GAAuB;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,OAAO,cAAc,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","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"]}