chore: import upstream snapshot with attribution

apps/sim/triggers/resend/utils.ts

@@ -0,0 +1,259 @@
+import type { TriggerOutput } from '@/triggers/types'
+
+/**
+ * Maps Sim Resend trigger IDs to a single Resend webhook event type.
+ * Kept in sync with subscription registration in `resend` webhook provider.
+ */
+export const RESEND_TRIGGER_TO_EVENT_TYPE: Record<string, string> = {
+  resend_email_sent: 'email.sent',
+  resend_email_delivered: 'email.delivered',
+  resend_email_bounced: 'email.bounced',
+  resend_email_complained: 'email.complained',
+  resend_email_opened: 'email.opened',
+  resend_email_clicked: 'email.clicked',
+  resend_email_failed: 'email.failed',
+}
+
+/**
+ * Event types registered for the catch-all `resend_webhook` trigger (API + matchEvent).
+ */
+export const RESEND_ALL_WEBHOOK_EVENT_TYPES: string[] = [
+  'email.sent',
+  'email.delivered',
+  'email.delivery_delayed',
+  'email.bounced',
+  'email.complained',
+  'email.opened',
+  'email.clicked',
+  'email.failed',
+  'email.received',
+  'email.scheduled',
+  'email.suppressed',
+  'contact.created',
+  'contact.updated',
+  'contact.deleted',
+  'domain.created',
+  'domain.updated',
+  'domain.deleted',
+]
+
+/**
+ * Shared trigger dropdown options for all Resend triggers
+ */
+export const resendTriggerOptions = [
+  { label: 'Email Sent', id: 'resend_email_sent' },
+  { label: 'Email Delivered', id: 'resend_email_delivered' },
+  { label: 'Email Bounced', id: 'resend_email_bounced' },
+  { label: 'Email Complained', id: 'resend_email_complained' },
+  { label: 'Email Opened', id: 'resend_email_opened' },
+  { label: 'Email Clicked', id: 'resend_email_clicked' },
+  { label: 'Email Failed', id: 'resend_email_failed' },
+  { label: 'Generic Webhook (All Events)', id: 'resend_webhook' },
+]
+
+/**
+ * Generates setup instructions for Resend webhooks.
+ * The webhook is automatically created in Resend when you save.
+ */
+export function resendSetupInstructions(eventType: string): string {
+  const instructions = [
+    'Enter your Resend API Key above.',
+    'You can find your API key in Resend at <strong>Settings > API Keys</strong>. See the <a href="https://resend.com/docs/dashboard/api-keys/introduction" target="_blank" rel="noopener noreferrer">Resend API documentation</a> for details.',
+    `Click <strong>"Save Configuration"</strong> to automatically create the webhook in Resend for <strong>${eventType}</strong> events.`,
+    'The webhook will be automatically deleted when you remove this trigger.',
+  ]
+
+  return instructions
+    .map(
+      (instruction, index) =>
+        `<div class="mb-3"><strong>${index + 1}.</strong> ${instruction}</div>`
+    )
+    .join('')
+}
+
+/**
+ * Helper to build Resend-specific extra fields.
+ * Includes API key (required).
+ * Use with the generic buildTriggerSubBlocks from @/triggers.
+ */
+export function buildResendExtraFields(triggerId: string) {
+  return [
+    {
+      id: 'apiKey',
+      title: 'API Key',
+      type: 'short-input' as const,
+      placeholder: 'Enter your Resend API key (re_...)',
+      description: 'Required to create the webhook in Resend.',
+      password: true,
+      paramVisibility: 'user-only' as const,
+      required: true,
+      mode: 'trigger' as const,
+      condition: { field: 'selectedTriggerId', value: triggerId },
+    },
+  ]
+}
+
+/**
+ * Common fields present in all Resend email webhook payloads
+ * (see https://resend.com/docs/dashboard/webhooks/introduction — example `data` object).
+ */
+const commonEmailOutputs = {
+  type: {
+    type: 'string',
+    description: 'Event type (e.g., email.sent, email.delivered)',
+  },
+  created_at: {
+    type: 'string',
+    description: 'Webhook event creation timestamp (ISO 8601), top-level `created_at`',
+  },
+  data_created_at: {
+    type: 'string',
+    description:
+      'Email record timestamp from payload `data.created_at` (ISO 8601), when present — distinct from top-level `created_at`',
+  },
+  email_id: {
+    type: 'string',
+    description: 'Unique email identifier',
+  },
+  broadcast_id: {
+    type: 'string',
+    description: 'Broadcast ID associated with the email, when sent as part of a broadcast',
+  },
+  template_id: {
+    type: 'string',
+    description: 'Template ID used to send the email, when applicable',
+  },
+  tags: {
+    type: 'json',
+    description: 'Tag key/value metadata attached to the email (payload `data.tags`)',
+  },
+  from: {
+    type: 'string',
+    description: 'Sender email address',
+  },
+  subject: {
+    type: 'string',
+    description: 'Email subject line',
+  },
+} as const
+
+/**
+ * Recipient fields present in email webhook payloads
+ */
+const recipientOutputs = {
+  to: {
+    type: 'json',
+    description: 'Array of recipient email addresses',
+  },
+} as const
+
+const resendEventDataOutput: Record<string, TriggerOutput> = {
+  data: {
+    type: 'json',
+    description:
+      'Raw event `data` from Resend (shape varies by event type: email, contact, domain, etc.)',
+  },
+}
+
+/**
+ * Build outputs for email sent events
+ */
+export function buildEmailSentOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email delivered events
+ */
+export function buildEmailDeliveredOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email bounced events
+ */
+export function buildEmailBouncedOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+    bounceType: { type: 'string', description: 'Bounce type (e.g., Permanent)' },
+    bounceSubType: { type: 'string', description: 'Bounce sub-type (e.g., Suppressed)' },
+    bounceMessage: { type: 'string', description: 'Bounce error message' },
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email complained events
+ */
+export function buildEmailComplainedOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email opened events
+ */
+export function buildEmailOpenedOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email clicked events
+ */
+export function buildEmailClickedOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+    clickIpAddress: { type: 'string', description: 'IP address of the click' },
+    clickLink: { type: 'string', description: 'URL that was clicked' },
+    clickTimestamp: { type: 'string', description: 'Click timestamp (ISO 8601)' },
+    clickUserAgent: { type: 'string', description: 'Browser user agent string' },
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for email failed events
+ */
+export function buildEmailFailedOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+  } as Record<string, TriggerOutput>
+}
+
+/**
+ * Build outputs for generic webhook (all events).
+ * Includes all possible fields across event types.
+ */
+export function buildResendOutputs(): Record<string, TriggerOutput> {
+  return {
+    ...commonEmailOutputs,
+    ...recipientOutputs,
+    ...resendEventDataOutput,
+    bounceType: { type: 'string', description: 'Bounce type (e.g., Permanent)' },
+    bounceSubType: { type: 'string', description: 'Bounce sub-type (e.g., Suppressed)' },
+    bounceMessage: { type: 'string', description: 'Bounce error message' },
+    clickIpAddress: { type: 'string', description: 'IP address of the click' },
+    clickLink: { type: 'string', description: 'URL that was clicked' },
+    clickTimestamp: { type: 'string', description: 'Click timestamp (ISO 8601)' },
+    clickUserAgent: { type: 'string', description: 'Browser user agent string' },
+  } as Record<string, TriggerOutput>
+}