chore: import upstream snapshot with attribution

apps/sim/triggers/sendblue/utils.ts

@@ -0,0 +1,76 @@
+import type { TriggerOutput } from '@/triggers/types'
+
+export const sendblueTriggerOptions = [
+  { label: 'Message Received', id: 'sendblue_message_received' },
+  { label: 'Message Status Updated', id: 'sendblue_message_status_updated' },
+]
+
+export function sendblueSetupInstructions(eventType: string): string {
+  const instructions = [
+    'Copy the <strong>Webhook URL</strong> above.',
+    'Open your <a href="https://dashboard.sendblue.com" target="_blank" rel="noopener noreferrer">Sendblue dashboard</a> and go to <strong>Settings &gt; Webhooks</strong>.',
+    eventType === 'Message Received'
+      ? 'Paste the Webhook URL into the <strong>Receive Webhook</strong> field to receive inbound messages.'
+      : 'Paste the Webhook URL into the <strong>Send / Status Webhook</strong> field to receive outbound message status updates. You can also pass it per-message as the <code>status_callback</code> parameter.',
+    'Save your webhook settings in Sendblue.',
+  ]
+
+  return instructions
+    .map(
+      (instruction, index) =>
+        `<div class="mb-3"><strong>${index + 1}.</strong> ${instruction}</div>`
+    )
+    .join('')
+}
+
+/**
+ * Outputs shared by both Sendblue message webhooks. Inbound and outbound
+ * status callbacks use the same payload schema.
+ */
+export function buildSendblueOutputs(): Record<string, TriggerOutput> {
+  return {
+    account_email: { type: 'string', description: 'Email of the Sendblue account' },
+    content: { type: 'string', description: 'Message text content' },
+    media_url: { type: 'string', description: 'CDN link to attached media, if any' },
+    is_outbound: { type: 'boolean', description: 'True for outbound messages, false for inbound' },
+    status: {
+      type: 'string',
+      description: 'Message status (e.g., RECEIVED, QUEUED, SENT, DELIVERED, ERROR)',
+    },
+    error_code: { type: 'number', description: 'Error identifier, null if none' },
+    error_message: { type: 'string', description: 'Descriptive error text, null if none' },
+    error_reason: { type: 'string', description: 'Additional error context, null if none' },
+    error_detail: { type: 'string', description: 'Detailed error information, null if none' },
+    message_handle: {
+      type: 'string',
+      description: 'Sendblue message identifier (use to deduplicate)',
+    },
+    date_sent: { type: 'string', description: 'ISO 8601 creation timestamp' },
+    date_updated: { type: 'string', description: 'ISO 8601 last-update timestamp' },
+    from_number: { type: 'string', description: 'E.164 sender phone number' },
+    number: { type: 'string', description: 'E.164 recipient/counterparty phone number' },
+    to_number: { type: 'string', description: 'E.164 destination phone number' },
+    was_downgraded: {
+      type: 'boolean',
+      description: 'True if the recipient lacks iMessage support',
+    },
+    plan: { type: 'string', description: 'Account plan type' },
+    message_type: { type: 'string', description: 'Message category (e.g., message, group)' },
+    group_id: { type: 'string', description: 'Group identifier, null for non-group messages' },
+    participants: { type: 'array', description: 'Participant phone numbers for group messages' },
+    send_style: { type: 'string', description: 'Expressive style if applied' },
+    opted_out: { type: 'boolean', description: 'True if the recipient has opted out' },
+    sendblue_number: { type: 'string', description: 'Sendblue phone number used' },
+    service: { type: 'string', description: 'Messaging service (iMessage or SMS)' },
+    group_display_name: {
+      type: 'string',
+      description: 'Group chat name, null for non-group messages',
+    },
+    sender_email: { type: 'string', description: 'Email of the user who sent the message' },
+    seat_id: { type: 'string', description: 'Seat UUID, null if absent' },
+    raw: {
+      type: 'string',
+      description: 'Complete raw webhook payload from Sendblue as a JSON string',
+    },
+  }
+}