@shware/workflow 2.0.1 → 3.0.0

package/dist/cloudflare/senders.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"senders.cjs","names":["isUnsubscribeLink"],"sources":["../../src/cloudflare/senders.ts"],"sourcesContent":["import { type ResolvedEmail, isUnsubscribeLink } from '../email';\nimport type { MessageSender, MessageTracking, OutboundMessage } from '../engine';\nimport type { ScalarIR } from '../ir';\nimport type { EmailBindingLike } from './bindings';\n\nexport type { EmailAddress } from '../email';\nexport type { EmailBindingLike } from './bindings';\n\n/** A rendered email: the template's resolved metadata (`resolveEmail`), its subject and its HTML. */\nexport interface RenderedEmail extends ResolvedEmail {\n  subject: string;\n  html: string;\n}\n\n/**\n * Template renderer, injected by the app — this package's core stays free of\n * any react-email dependency (`@shware/workflow/react-email` ships one over a\n * registry). The subject comes back final: it is sent exactly as written, from\n * the template's own sender, and the unsubscribe link is the one the HTML was\n * rendered with.\n */\nexport type EmailRenderer = (\n  template: string,\n  props: Record<string, ScalarIR | undefined>\n) => Promise<RenderedEmail>;\n\nexport interface CfEmailOptions {\n  /** The Worker's `send_email` binding. */\n  binding: EmailBindingLike;\n  render: EmailRenderer;\n}\n\n/**\n * Send straight through Cloudflare Email Service — a binding call, no outbound\n * HTTP. Throwing hands retries to the CF step, and the message's\n * idempotencyKey travels with the call so the binding can drop the duplicate a\n * retry or replay produces.\n */\nexport class CfEmailSender implements MessageSender {\n  constructor(private readonly options: CfEmailOptions) {}\n\n  async send(message: OutboundMessage): Promise<void> {\n    if (message.channel !== 'email') {\n      throw new Error(`CfEmailSender: unsupported channel '${message.channel}'`);\n    }\n    if (message.recipient === undefined) {\n      throw new Error(`CfEmailSender: no recipient for user '${message.userId}'`);\n    }\n    const { subject, html, from, replyTo, unsubscribeUrl } = await this.options.render(\n      message.template,\n      message.props\n    );\n    const tracked =\n      message.tracking === undefined ? html : trackEmail(html, message.tracking, unsubscribeUrl);\n    // The tracked links resolve before the email exists anywhere a scanner could follow them\n    await message.tracking?.commit?.();\n    await this.options.binding.send({\n      from,\n      to: message.recipient,\n      ...(replyTo === undefined ? {} : { replyTo }),\n      subject,\n      html: tracked,\n      idempotencyKey: message.idempotencyKey,\n    });\n  }\n}\n\nconst LINK = /(<a\\b[^>]*?\\shref\\s*=\\s*)([\"'])(https?:\\/\\/[^\"']+)\\2/gi;\n\n/**\n * An email's tracking applied to its rendered HTML: every `http(s)` anchor routed through\n * `link` (the original URL decoded from its attribute escaping, the tracking URL escaped back) —\n * as the unsubscribe link when it is the one the email was rendered with, so what a click on it\n * means is fixed when the email is sent — and the open pixel appended before `</body>`, or at the\n * end when there is none.\n */\nexport function trackEmail(\n  html: string,\n  tracking: MessageTracking,\n  unsubscribeUrl?: string\n): string {\n  const { link, pixel } = tracking;\n  let out = html;\n  if (link !== undefined) {\n    out = out.replace(LINK, (_, start: string, quote: string, attribute: string) => {\n      const url = unescapeAttribute(attribute);\n      const purpose = isUnsubscribeLink(url, unsubscribeUrl) ? 'unsubscribe' : 'link';\n      return `${start}${quote}${escapeAttribute(link(url, purpose))}${quote}`;\n    });\n  }\n  if (pixel !== undefined) {\n    const image = `<img src=\"${escapeAttribute(pixel)}\" width=\"1\" height=\"1\" alt=\"\" style=\"display:block;border:0;width:1px;height:1px\" />`;\n    out = /<\\/body>/i.test(out) ? out.replace(/<\\/body>/i, `${image}</body>`) : `${out}${image}`;\n  }\n  return out;\n}\n\nfunction unescapeAttribute(value: string): string {\n  return value.replaceAll('&amp;', '&').replaceAll('&quot;', '\"').replaceAll('&#x27;', \"'\");\n}\n\nfunction escapeAttribute(value: string): string {\n  return value.replaceAll('&', '&amp;').replaceAll('\"', '&quot;');\n}\n\n/** Development sender: structured logs, for eyeballing the pipeline. */\nexport class LogMessageSender implements MessageSender {\n  async send(message: OutboundMessage): Promise<void> {\n    const { tracking: _tracking, ...logged } = message;\n    console.log(`[send] ${JSON.stringify(logged)}`);\n  }\n}\n\n/**\n * Webhook sender: POST to an external delivery service (a Resend/SES gateway,\n * say). The idempotency key travels with it, so the receiver de-duplicates\n * retries and replays on idempotencyKey.\n */\nexport class WebhookMessageSender implements MessageSender {\n  constructor(private readonly url: string) {}\n\n  async send(message: OutboundMessage): Promise<void> {\n    const response = await fetch(this.url, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        'idempotency-key': message.idempotencyKey,\n      },\n      body: JSON.stringify(message),\n    });\n    if (!response.ok) {\n      throw new Error(`message webhook failed: ${response.status}`);\n    }\n  }\n}\n\n/**\n * One sender per channel: the runner has a single outlet, this fans it out.\n * A channel without a sender fails the send (a misconfiguration, not a retry).\n */\nexport function routeByChannel(\n  senders: Partial<Record<OutboundMessage['channel'], MessageSender>>\n): MessageSender {\n  return {\n    async send(message) {\n      const sender = senders[message.channel];\n      if (sender === undefined) {\n        throw new Error(`no sender configured for channel '${message.channel}'`);\n      }\n      return sender.send(message);\n    },\n  };\n}\n\n/**\n * One push outlet per platform, chosen by the device each copy goes to (the\n * engine sends one message per device, and the host's directory says which\n * platform a token belongs to): `ios` straight to APNs, `android` through FCM,\n * say. A platform with no sender fails the step rather than guessing.\n */\nexport function routeByPlatform(senders: Record<string, MessageSender>): MessageSender {\n  return {\n    async send(message) {\n      const platform = message.device?.platform;\n      if (platform === undefined) {\n        throw new Error(`push for user '${message.userId}' carries no device`);\n      }\n      if (!Object.hasOwn(senders, platform)) {\n        throw new Error(`no push sender configured for platform '${platform}'`);\n      }\n      return senders[platform].send(message);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/cloudflare/senders.d.cts

@@ -1,72 +0,0 @@
-import { ScalarIR } from "../ir.cjs";
-import { MessageSender, MessageTracking, OutboundMessage } from "../engine/ports.cjs";
-import "../engine/index.cjs";
-import { EmailAddress, ResolvedEmail } from "../email.cjs";
-import { EmailBindingLike } from "./bindings.cjs";
-//#region src/cloudflare/senders.d.ts
-/** A rendered email: the template's resolved metadata (`resolveEmail`), its subject and its HTML. */
-export interface RenderedEmail extends ResolvedEmail {
-  subject: string;
-  html: string;
-}
-/**
- * Template renderer, injected by the app — this package's core stays free of
- * any react-email dependency (`@shware/workflow/react-email` ships one over a
- * registry). The subject comes back final: it is sent exactly as written, from
- * the template's own sender, and the unsubscribe link is the one the HTML was
- * rendered with.
- */
-export type EmailRenderer = (template: string, props: Record<string, ScalarIR | undefined>) => Promise<RenderedEmail>;
-export interface CfEmailOptions {
-  /** The Worker's `send_email` binding. */
-  binding: EmailBindingLike;
-  render: EmailRenderer;
-}
-/**
- * Send straight through Cloudflare Email Service — a binding call, no outbound
- * HTTP. Throwing hands retries to the CF step, and the message's
- * idempotencyKey travels with the call so the binding can drop the duplicate a
- * retry or replay produces.
- */
-export declare class CfEmailSender implements MessageSender {
-  private readonly options;
-  constructor(options: CfEmailOptions);
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * An email's tracking applied to its rendered HTML: every `http(s)` anchor routed through
- * `link` (the original URL decoded from its attribute escaping, the tracking URL escaped back) —
- * as the unsubscribe link when it is the one the email was rendered with, so what a click on it
- * means is fixed when the email is sent — and the open pixel appended before `</body>`, or at the
- * end when there is none.
- */
-export declare function trackEmail(html: string, tracking: MessageTracking, unsubscribeUrl?: string): string;
-/** Development sender: structured logs, for eyeballing the pipeline. */
-export declare class LogMessageSender implements MessageSender {
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * Webhook sender: POST to an external delivery service (a Resend/SES gateway,
- * say). The idempotency key travels with it, so the receiver de-duplicates
- * retries and replays on idempotencyKey.
- */
-export declare class WebhookMessageSender implements MessageSender {
-  private readonly url;
-  constructor(url: string);
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * One sender per channel: the runner has a single outlet, this fans it out.
- * A channel without a sender fails the send (a misconfiguration, not a retry).
- */
-export declare function routeByChannel(senders: Partial<Record<OutboundMessage['channel'], MessageSender>>): MessageSender;
-/**
- * One push outlet per platform, chosen by the device each copy goes to (the
- * engine sends one message per device, and the host's directory says which
- * platform a token belongs to): `ios` straight to APNs, `android` through FCM,
- * say. A platform with no sender fails the step rather than guessing.
- */
-export declare function routeByPlatform(senders: Record<string, MessageSender>): MessageSender;
-//#endregion
-export type { EmailAddress, EmailBindingLike };
-//# sourceMappingURL=senders.d.cts.map

package/dist/cloudflare/senders.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"senders.d.cts","names":[],"sources":["../../src/cloudflare/senders.ts"],"mappings":";;;;;;;iBASiB,sBAAsB;EACrC;EACA;;;;;;;;;YAUU,iBACV,kBACA,OAAO,eAAe,0BACnB,QAAQ;iBAEI;;EAEf,SAAS;EACT,QAAQ;;;;;;;;qBASG,yBAAyB;mBACP;EAA7B,YAA6B,SAAS;EAEhC,KAAK,SAAS,kBAAkB;;;;;;;;;wBAmCxB,WACd,cACA,UAAU,iBACV;;qBA2BW,4BAA4B;EACjC,KAAK,SAAS,kBAAkB;;;;;;;qBAW3B,gCAAgC;mBACd;EAA7B,YAA6B;EAEvB,KAAK,SAAS,kBAAkB;;;;;;wBAmBxB,eACd,SAAS,QAAQ,OAAO,4BAA4B,kBACnD;;;;;;;wBAkBa,gBAAgB,SAAS,eAAe,iBAAiB"}

package/dist/cloudflare/senders.d.mts

@@ -1,72 +0,0 @@
-import { ScalarIR } from "../ir.mjs";
-import { MessageSender, MessageTracking, OutboundMessage } from "../engine/ports.mjs";
-import "../engine/index.mjs";
-import { EmailAddress, ResolvedEmail } from "../email.mjs";
-import { EmailBindingLike } from "./bindings.mjs";
-//#region src/cloudflare/senders.d.ts
-/** A rendered email: the template's resolved metadata (`resolveEmail`), its subject and its HTML. */
-export interface RenderedEmail extends ResolvedEmail {
-  subject: string;
-  html: string;
-}
-/**
- * Template renderer, injected by the app — this package's core stays free of
- * any react-email dependency (`@shware/workflow/react-email` ships one over a
- * registry). The subject comes back final: it is sent exactly as written, from
- * the template's own sender, and the unsubscribe link is the one the HTML was
- * rendered with.
- */
-export type EmailRenderer = (template: string, props: Record<string, ScalarIR | undefined>) => Promise<RenderedEmail>;
-export interface CfEmailOptions {
-  /** The Worker's `send_email` binding. */
-  binding: EmailBindingLike;
-  render: EmailRenderer;
-}
-/**
- * Send straight through Cloudflare Email Service — a binding call, no outbound
- * HTTP. Throwing hands retries to the CF step, and the message's
- * idempotencyKey travels with the call so the binding can drop the duplicate a
- * retry or replay produces.
- */
-export declare class CfEmailSender implements MessageSender {
-  private readonly options;
-  constructor(options: CfEmailOptions);
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * An email's tracking applied to its rendered HTML: every `http(s)` anchor routed through
- * `link` (the original URL decoded from its attribute escaping, the tracking URL escaped back) —
- * as the unsubscribe link when it is the one the email was rendered with, so what a click on it
- * means is fixed when the email is sent — and the open pixel appended before `</body>`, or at the
- * end when there is none.
- */
-export declare function trackEmail(html: string, tracking: MessageTracking, unsubscribeUrl?: string): string;
-/** Development sender: structured logs, for eyeballing the pipeline. */
-export declare class LogMessageSender implements MessageSender {
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * Webhook sender: POST to an external delivery service (a Resend/SES gateway,
- * say). The idempotency key travels with it, so the receiver de-duplicates
- * retries and replays on idempotencyKey.
- */
-export declare class WebhookMessageSender implements MessageSender {
-  private readonly url;
-  constructor(url: string);
-  send(message: OutboundMessage): Promise<void>;
-}
-/**
- * One sender per channel: the runner has a single outlet, this fans it out.
- * A channel without a sender fails the send (a misconfiguration, not a retry).
- */
-export declare function routeByChannel(senders: Partial<Record<OutboundMessage['channel'], MessageSender>>): MessageSender;
-/**
- * One push outlet per platform, chosen by the device each copy goes to (the
- * engine sends one message per device, and the host's directory says which
- * platform a token belongs to): `ios` straight to APNs, `android` through FCM,
- * say. A platform with no sender fails the step rather than guessing.
- */
-export declare function routeByPlatform(senders: Record<string, MessageSender>): MessageSender;
-//#endregion
-export type { EmailAddress, EmailBindingLike };
-//# sourceMappingURL=senders.d.mts.map

package/dist/cloudflare/senders.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"senders.d.mts","names":[],"sources":["../../src/cloudflare/senders.ts"],"mappings":";;;;;;;iBASiB,sBAAsB;EACrC;EACA;;;;;;;;;YAUU,iBACV,kBACA,OAAO,eAAe,0BACnB,QAAQ;iBAEI;;EAEf,SAAS;EACT,QAAQ;;;;;;;;qBASG,yBAAyB;mBACP;EAA7B,YAA6B,SAAS;EAEhC,KAAK,SAAS,kBAAkB;;;;;;;;;wBAmCxB,WACd,cACA,UAAU,iBACV;;qBA2BW,4BAA4B;EACjC,KAAK,SAAS,kBAAkB;;;;;;;qBAW3B,gCAAgC;mBACd;EAA7B,YAA6B;EAEvB,KAAK,SAAS,kBAAkB;;;;;;wBAmBxB,eACd,SAAS,QAAQ,OAAO,4BAA4B,kBACnD;;;;;;;wBAkBa,gBAAgB,SAAS,eAAe,iBAAiB"}

package/dist/cloudflare/senders.mjs

@@ -1,115 +0,0 @@
-import { isUnsubscribeLink } from "../email.mjs";
-//#region src/cloudflare/senders.ts
-/**
-* Send straight through Cloudflare Email Service — a binding call, no outbound
-* HTTP. Throwing hands retries to the CF step, and the message's
-* idempotencyKey travels with the call so the binding can drop the duplicate a
-* retry or replay produces.
-*/
-var CfEmailSender = class {
-	options;
-	constructor(options) {
-		this.options = options;
-	}
-	async send(message) {
-		if (message.channel !== "email") throw new Error(`CfEmailSender: unsupported channel '${message.channel}'`);
-		if (message.recipient === void 0) throw new Error(`CfEmailSender: no recipient for user '${message.userId}'`);
-		const { subject, html, from, replyTo, unsubscribeUrl } = await this.options.render(message.template, message.props);
-		const tracked = message.tracking === void 0 ? html : trackEmail(html, message.tracking, unsubscribeUrl);
-		await message.tracking?.commit?.();
-		await this.options.binding.send({
-			from,
-			to: message.recipient,
-			...replyTo === void 0 ? {} : { replyTo },
-			subject,
-			html: tracked,
-			idempotencyKey: message.idempotencyKey
-		});
-	}
-};
-const LINK = /(<a\b[^>]*?\shref\s*=\s*)(["'])(https?:\/\/[^"']+)\2/gi;
-/**
-* An email's tracking applied to its rendered HTML: every `http(s)` anchor routed through
-* `link` (the original URL decoded from its attribute escaping, the tracking URL escaped back) —
-* as the unsubscribe link when it is the one the email was rendered with, so what a click on it
-* means is fixed when the email is sent — and the open pixel appended before `</body>`, or at the
-* end when there is none.
-*/
-function trackEmail(html, tracking, unsubscribeUrl) {
-	const { link, pixel } = tracking;
-	let out = html;
-	if (link !== void 0) out = out.replace(LINK, (_, start, quote, attribute) => {
-		const url = unescapeAttribute(attribute);
-		const purpose = isUnsubscribeLink(url, unsubscribeUrl) ? "unsubscribe" : "link";
-		return `${start}${quote}${escapeAttribute(link(url, purpose))}${quote}`;
-	});
-	if (pixel !== void 0) {
-		const image = `<img src="${escapeAttribute(pixel)}" width="1" height="1" alt="" style="display:block;border:0;width:1px;height:1px" />`;
-		out = /<\/body>/i.test(out) ? out.replace(/<\/body>/i, `${image}</body>`) : `${out}${image}`;
-	}
-	return out;
-}
-function unescapeAttribute(value) {
-	return value.replaceAll("&amp;", "&").replaceAll("&quot;", "\"").replaceAll("&#x27;", "'");
-}
-function escapeAttribute(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;");
-}
-/** Development sender: structured logs, for eyeballing the pipeline. */
-var LogMessageSender = class {
-	async send(message) {
-		const { tracking: _tracking, ...logged } = message;
-		console.log(`[send] ${JSON.stringify(logged)}`);
-	}
-};
-/**
-* Webhook sender: POST to an external delivery service (a Resend/SES gateway,
-* say). The idempotency key travels with it, so the receiver de-duplicates
-* retries and replays on idempotencyKey.
-*/
-var WebhookMessageSender = class {
-	url;
-	constructor(url) {
-		this.url = url;
-	}
-	async send(message) {
-		const response = await fetch(this.url, {
-			method: "POST",
-			headers: {
-				"content-type": "application/json",
-				"idempotency-key": message.idempotencyKey
-			},
-			body: JSON.stringify(message)
-		});
-		if (!response.ok) throw new Error(`message webhook failed: ${response.status}`);
-	}
-};
-/**
-* One sender per channel: the runner has a single outlet, this fans it out.
-* A channel without a sender fails the send (a misconfiguration, not a retry).
-*/
-function routeByChannel(senders) {
-	return { async send(message) {
-		const sender = senders[message.channel];
-		if (sender === void 0) throw new Error(`no sender configured for channel '${message.channel}'`);
-		return sender.send(message);
-	} };
-}
-/**
-* One push outlet per platform, chosen by the device each copy goes to (the
-* engine sends one message per device, and the host's directory says which
-* platform a token belongs to): `ios` straight to APNs, `android` through FCM,
-* say. A platform with no sender fails the step rather than guessing.
-*/
-function routeByPlatform(senders) {
-	return { async send(message) {
-		const platform = message.device?.platform;
-		if (platform === void 0) throw new Error(`push for user '${message.userId}' carries no device`);
-		if (!Object.hasOwn(senders, platform)) throw new Error(`no push sender configured for platform '${platform}'`);
-		return senders[platform].send(message);
-	} };
-}
-//#endregion
-export { CfEmailSender, LogMessageSender, WebhookMessageSender, routeByChannel, routeByPlatform, trackEmail };
-
-//# sourceMappingURL=senders.mjs.map

package/dist/cloudflare/senders.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"senders.mjs","names":[],"sources":["../../src/cloudflare/senders.ts"],"sourcesContent":["import { type ResolvedEmail, isUnsubscribeLink } from '../email';\nimport type { MessageSender, MessageTracking, OutboundMessage } from '../engine';\nimport type { ScalarIR } from '../ir';\nimport type { EmailBindingLike } from './bindings';\n\nexport type { EmailAddress } from '../email';\nexport type { EmailBindingLike } from './bindings';\n\n/** A rendered email: the template's resolved metadata (`resolveEmail`), its subject and its HTML. */\nexport interface RenderedEmail extends ResolvedEmail {\n  subject: string;\n  html: string;\n}\n\n/**\n * Template renderer, injected by the app — this package's core stays free of\n * any react-email dependency (`@shware/workflow/react-email` ships one over a\n * registry). The subject comes back final: it is sent exactly as written, from\n * the template's own sender, and the unsubscribe link is the one the HTML was\n * rendered with.\n */\nexport type EmailRenderer = (\n  template: string,\n  props: Record<string, ScalarIR | undefined>\n) => Promise<RenderedEmail>;\n\nexport interface CfEmailOptions {\n  /** The Worker's `send_email` binding. */\n  binding: EmailBindingLike;\n  render: EmailRenderer;\n}\n\n/**\n * Send straight through Cloudflare Email Service — a binding call, no outbound\n * HTTP. Throwing hands retries to the CF step, and the message's\n * idempotencyKey travels with the call so the binding can drop the duplicate a\n * retry or replay produces.\n */\nexport class CfEmailSender implements MessageSender {\n  constructor(private readonly options: CfEmailOptions) {}\n\n  async send(message: OutboundMessage): Promise<void> {\n    if (message.channel !== 'email') {\n      throw new Error(`CfEmailSender: unsupported channel '${message.channel}'`);\n    }\n    if (message.recipient === undefined) {\n      throw new Error(`CfEmailSender: no recipient for user '${message.userId}'`);\n    }\n    const { subject, html, from, replyTo, unsubscribeUrl } = await this.options.render(\n      message.template,\n      message.props\n    );\n    const tracked =\n      message.tracking === undefined ? html : trackEmail(html, message.tracking, unsubscribeUrl);\n    // The tracked links resolve before the email exists anywhere a scanner could follow them\n    await message.tracking?.commit?.();\n    await this.options.binding.send({\n      from,\n      to: message.recipient,\n      ...(replyTo === undefined ? {} : { replyTo }),\n      subject,\n      html: tracked,\n      idempotencyKey: message.idempotencyKey,\n    });\n  }\n}\n\nconst LINK = /(<a\\b[^>]*?\\shref\\s*=\\s*)([\"'])(https?:\\/\\/[^\"']+)\\2/gi;\n\n/**\n * An email's tracking applied to its rendered HTML: every `http(s)` anchor routed through\n * `link` (the original URL decoded from its attribute escaping, the tracking URL escaped back) —\n * as the unsubscribe link when it is the one the email was rendered with, so what a click on it\n * means is fixed when the email is sent — and the open pixel appended before `</body>`, or at the\n * end when there is none.\n */\nexport function trackEmail(\n  html: string,\n  tracking: MessageTracking,\n  unsubscribeUrl?: string\n): string {\n  const { link, pixel } = tracking;\n  let out = html;\n  if (link !== undefined) {\n    out = out.replace(LINK, (_, start: string, quote: string, attribute: string) => {\n      const url = unescapeAttribute(attribute);\n      const purpose = isUnsubscribeLink(url, unsubscribeUrl) ? 'unsubscribe' : 'link';\n      return `${start}${quote}${escapeAttribute(link(url, purpose))}${quote}`;\n    });\n  }\n  if (pixel !== undefined) {\n    const image = `<img src=\"${escapeAttribute(pixel)}\" width=\"1\" height=\"1\" alt=\"\" style=\"display:block;border:0;width:1px;height:1px\" />`;\n    out = /<\\/body>/i.test(out) ? out.replace(/<\\/body>/i, `${image}</body>`) : `${out}${image}`;\n  }\n  return out;\n}\n\nfunction unescapeAttribute(value: string): string {\n  return value.replaceAll('&amp;', '&').replaceAll('&quot;', '\"').replaceAll('&#x27;', \"'\");\n}\n\nfunction escapeAttribute(value: string): string {\n  return value.replaceAll('&', '&amp;').replaceAll('\"', '&quot;');\n}\n\n/** Development sender: structured logs, for eyeballing the pipeline. */\nexport class LogMessageSender implements MessageSender {\n  async send(message: OutboundMessage): Promise<void> {\n    const { tracking: _tracking, ...logged } = message;\n    console.log(`[send] ${JSON.stringify(logged)}`);\n  }\n}\n\n/**\n * Webhook sender: POST to an external delivery service (a Resend/SES gateway,\n * say). The idempotency key travels with it, so the receiver de-duplicates\n * retries and replays on idempotencyKey.\n */\nexport class WebhookMessageSender implements MessageSender {\n  constructor(private readonly url: string) {}\n\n  async send(message: OutboundMessage): Promise<void> {\n    const response = await fetch(this.url, {\n      method: 'POST',\n      headers: {\n        'content-type': 'application/json',\n        'idempotency-key': message.idempotencyKey,\n      },\n      body: JSON.stringify(message),\n    });\n    if (!response.ok) {\n      throw new Error(`message webhook failed: ${response.status}`);\n    }\n  }\n}\n\n/**\n * One sender per channel: the runner has a single outlet, this fans it out.\n * A channel without a sender fails the send (a misconfiguration, not a retry).\n */\nexport function routeByChannel(\n  senders: Partial<Record<OutboundMessage['channel'], MessageSender>>\n): MessageSender {\n  return {\n    async send(message) {\n      const sender = senders[message.channel];\n      if (sender === undefined) {\n        throw new Error(`no sender configured for channel '${message.channel}'`);\n      }\n      return sender.send(message);\n    },\n  };\n}\n\n/**\n * One push outlet per platform, chosen by the device each copy goes to (the\n * engine sends one message per device, and the host's directory says which\n * platform a token belongs to): `ios` straight to APNs, `android` through FCM,\n * say. A platform with no sender fails the step rather than guessing.\n */\nexport function routeByPlatform(senders: Record<string, MessageSender>): MessageSender {\n  return {\n    async send(message) {\n      const platform = message.device?.platform;\n      if (platform === undefined) {\n        throw new Error(`push for user '${message.userId}' carries no device`);\n      }\n      if (!Object.hasOwn(senders, platform)) {\n        throw new Error(`no push sender configured for platform '${platform}'`);\n      }\n      return senders[platform].send(message);\n    },\n  };\n}\n"],"mappings":"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"}