@automate.ax/integration-contracts 0.114.4 → 0.115.2

package/src/brevo/schemas.ts

@@ -1,449 +1,320 @@
 import * as z from "zod"
 
-export const BREVO_TRANSACTIONAL_EVENT_TYPES = [
+export const BREVO_EVENT_FAMILIES = [
+  "transactionalEmail",
+  "transactionalSms",
+  "marketingEmail",
+  "marketingSms",
+  "contact",
+] as const
+
+export const BREVO_TRANSACTIONAL_EMAIL_EVENT_TYPES = [
+  "sent",
+  "delivered",
+  "hardBounced",
+  "softBounced",
   "blocked",
-  "click",
+  "markedAsSpam",
+  "invalid",
   "deferred",
-  "delivered",
-  "error",
-  "hard_bounce",
-  "invalid_email",
+  "clicked",
   "opened",
-  "request",
-  "soft_bounce",
-  "spam",
-  "unique_opened",
+  "firstOpened",
   "unsubscribed",
 ] as const
 
-const BREVO_PROVIDER_EVENT_BASE_SCHEMA = z
-  .looseObject({
-    /** Custom header supplied with the original email. */
-    "X-Mailin-custom": z.string().optional(),
-
-    /** Provider-local formatted date for the event. */
-    date: z.string().optional(),
-
-    /** Recipient email address. */
-    email: z.string().optional(),
-
-    /** Brevo webhook ID that delivered the event. */
-    id: z.number().int().nonnegative(),
-
-    /** Provider message identity. */
-    "message-id": z.string().optional(),
-
-    /** Email subject. */
-    subject: z.string().optional(),
-
-    /** Tags supplied with the original email. */
-    tags: z.string().array().optional(),
-
-    /** Internal template ID used to send the email. */
-    template_id: z.number().int().nonnegative().optional(),
-
-    /** Unix timestamp in seconds for the underlying email event. */
-    ts: z.number().int().nonnegative().optional(),
-
-    /** Unix timestamp in seconds when Brevo emitted the webhook event. */
-    ts_event: z.number().int().nonnegative(),
-  })
-  .catchall(z.json())
-
-const BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA = z.object({
-  /** Sending IP used for the message. */
-  sending_ip: z.string().optional(),
-
-  /** Provider timestamp in milliseconds. */
-  ts_epoch: z.number().int().nonnegative().optional(),
-})
-
-const BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA = z.object({
-  /** Brevo contact ID, or zero when the recipient is not a contact. */
-  contact_id: z.number().int().nonnegative().optional(),
-
-  /** Device category reported for the interaction. */
-  device_used: z.string().optional(),
-
-  /** Brevo log preview URL. */
-  mirror_link: z.string().optional(),
-
-  /** Browser or email-client user agent. */
-  user_agent: z.string().optional(),
-})
-
-const BREVO_PROVIDER_SENT_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA.pick({
-      contact_id: true,
-      mirror_link: true,
-    }).shape,
-    event: z.literal("request"),
-  })
-
-const BREVO_PROVIDER_DELIVERED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    event: z.literal("delivered"),
-  })
-
-const BREVO_PROVIDER_HARD_BOUNCED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    event: z.literal("hard_bounce"),
-    reason: z.string().optional(),
-  })
-
-const BREVO_PROVIDER_SOFT_BOUNCED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    event: z.literal("soft_bounce"),
-    reason: z.string().optional(),
-  })
-
-const BREVO_PROVIDER_BLOCKED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    event: z.literal("blocked"),
-    ts_epoch: z.number().int().nonnegative().optional(),
-  })
-
-const BREVO_PROVIDER_DEFERRED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    event: z.literal("deferred"),
-    reason: z.string().optional(),
-  })
-
-const BREVO_PROVIDER_OPENED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA.shape,
-    event: z.literal("opened"),
-  })
-
-const BREVO_PROVIDER_UNIQUE_OPENED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA.shape,
-    event: z.literal("unique_opened"),
-  })
-
-const BREVO_PROVIDER_CLICKED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA.shape,
-    event: z.literal("click"),
-    link: z.string().optional(),
-  })
-
-const BREVO_PROVIDER_SPAM_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({ event: z.literal("spam") })
-
-const BREVO_PROVIDER_UNSUBSCRIBED_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_PROVIDER_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_PROVIDER_ENGAGEMENT_METADATA_SCHEMA.shape,
-    event: z.literal("unsubscribed"),
-    tag: z.string().optional(),
-  })
+export const BREVO_TRANSACTIONAL_SMS_EVENT_TYPES = [
+  "sent",
+  "delivered",
+  "hardBounced",
+  "softBounced",
+  "replied",
+  "unsubscribed",
+] as const
 
-const BREVO_PROVIDER_INVALID_EMAIL_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    event: z.literal("invalid_email"),
-    ts_epoch: z.number().int().nonnegative().optional(),
-  })
+export const BREVO_MARKETING_EMAIL_EVENT_TYPES = [
+  "delivered",
+  "hardBounced",
+  "softBounced",
+  "markedAsSpam",
+  "opened",
+  "clicked",
+  "unsubscribed",
+] as const
 
-const BREVO_PROVIDER_ERROR_EVENT_SCHEMA =
-  BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    event: z.literal("error"),
-    ts_epoch: z.number().int().nonnegative().optional(),
-  })
+export const BREVO_CONTACT_EVENT_TYPES = [
+  "addedToList",
+  "updated",
+  "deleted",
+] as const
 
-const BREVO_PROVIDER_TRANSACTIONAL_EVENT_SCHEMA = z.discriminatedUnion(
-  "event",
-  [
-    BREVO_PROVIDER_BLOCKED_EVENT_SCHEMA,
-    BREVO_PROVIDER_CLICKED_EVENT_SCHEMA,
-    BREVO_PROVIDER_DEFERRED_EVENT_SCHEMA,
-    BREVO_PROVIDER_DELIVERED_EVENT_SCHEMA,
-    BREVO_PROVIDER_ERROR_EVENT_SCHEMA,
-    BREVO_PROVIDER_HARD_BOUNCED_EVENT_SCHEMA,
-    BREVO_PROVIDER_INVALID_EMAIL_EVENT_SCHEMA,
-    BREVO_PROVIDER_OPENED_EVENT_SCHEMA,
-    BREVO_PROVIDER_SENT_EVENT_SCHEMA,
-    BREVO_PROVIDER_SOFT_BOUNCED_EVENT_SCHEMA,
-    BREVO_PROVIDER_SPAM_EVENT_SCHEMA,
-    BREVO_PROVIDER_UNIQUE_OPENED_EVENT_SCHEMA,
-    BREVO_PROVIDER_UNSUBSCRIBED_EVENT_SCHEMA,
-  ],
-)
+export const BREVO_MARKETING_SMS_EVENT_TYPES = [
+  "sent",
+  "delivered",
+  "hardBounced",
+  "softBounced",
+  "replied",
+  "unsubscribed",
+] as const
 
-const BREVO_EVENT_BASE_SCHEMA = z.object({
-  /** Custom header supplied with the original email. */
+const BREVO_NORMALIZED_EVENT_FIELDS = {
+  bounceType: z.string().optional(),
+  campaignId: z.number().int().nonnegative().optional(),
+  campaignName: z.string().optional(),
+  contactId: z.number().int().nonnegative().optional(),
+  content: z.json().optional(),
+  creditsUsed: z.number().nonnegative().optional(),
   customHeader: z.string().optional(),
-
-  /** Provider-local formatted date for the event. */
   date: z.string().optional(),
-
-  /** Recipient email address. */
+  dateEvent: z.string().optional(),
+  dateSent: z.string().optional(),
+  description: z.string().optional(),
+  deviceUsed: z.string().optional(),
   email: z.string().optional(),
-
-  /** Provider message identity. */
-  messageId: z.string().optional(),
-
-  /** Unix timestamp in seconds when Brevo emitted the webhook event. */
-  occurredAt: z.number().int().nonnegative(),
-
-  /** Email subject. */
+  errorCode: z.number().int().optional(),
+  event: z.record(z.string(), z.json()),
+  key: z.string().optional(),
+  link: z.string().optional(),
+  listIds: z.number().int().nonnegative().array().optional(),
+  messageId: z.union([z.string(), z.number().int()]).optional(),
+  mirrorLink: z.string().optional(),
+  occurredAt: z.number().int().nonnegative().optional(),
+  phone: z.string().optional(),
+  reason: z.string().optional(),
+  reference: z.union([z.string(), z.record(z.string(), z.string())]).optional(),
+  remainingCredit: z.number().nonnegative().optional(),
+  reply: z.string().optional(),
+  segmentIds: z.number().int().nonnegative().array().optional(),
+  senderEmail: z.string().optional(),
+  sendingIp: z.string().optional(),
+  smsCount: z.number().int().nonnegative().optional(),
+  status: z.string().optional(),
   subject: z.string().optional(),
-
-  /** Tags supplied with the original email. */
+  tag: z.union([z.string(), z.string().array()]).optional(),
   tags: z.string().array().optional(),
-
-  /** Internal template ID used to send the email. */
   templateId: z.number().int().nonnegative().optional(),
-
-  /** Unix timestamp in seconds for the underlying email event. */
   timestamp: z.number().int().nonnegative().optional(),
-
-  /** Brevo webhook ID that delivered the event. */
-  webhookId: z.number().int().nonnegative(),
-})
-
-const BREVO_DELIVERY_METADATA_SCHEMA = z.object({
-  /** Sending IP used for the message. */
-  sendingIp: z.string().optional(),
-
-  /** Provider timestamp in milliseconds. */
   timestampMilliseconds: z.number().int().nonnegative().optional(),
-})
-
-const BREVO_ENGAGEMENT_METADATA_SCHEMA = z.object({
-  /** Brevo contact ID, or zero when the recipient is not a contact. */
-  contactId: z.number().int().nonnegative().optional(),
-
-  /** Device category reported for the interaction. */
-  deviceUsed: z.string().optional(),
-
-  /** Brevo log preview URL. */
-  mirrorLink: z.string().optional(),
-
-  /** Browser or email-client user agent. */
+  timestampSent: z.number().int().nonnegative().optional(),
   userAgent: z.string().optional(),
-})
-
-export const BREVO_EMAIL_SENT_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-  ...BREVO_ENGAGEMENT_METADATA_SCHEMA.pick({
-    contactId: true,
-    mirrorLink: true,
-  }).shape,
-
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_SENT_EVENT_SCHEMA,
-
-  /** Brevo transactional event category. */
-  type: z.literal("request"),
-})
-
-export const BREVO_EMAIL_DELIVERED_EVENT_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_DELIVERED_EVENT_SCHEMA,
-
-    /** Brevo transactional event category. */
-    type: z.literal("delivered"),
-  })
-
-export const BREVO_EMAIL_HARD_BOUNCED_EVENT_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_HARD_BOUNCED_EVENT_SCHEMA,
-
-    /** Provider explanation for the permanent delivery failure. */
-    reason: z.string().optional(),
-
-    /** Brevo transactional event category. */
-    type: z.literal("hard_bounce"),
-  })
-
-export const BREVO_EMAIL_SOFT_BOUNCED_EVENT_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_SOFT_BOUNCED_EVENT_SCHEMA,
-
-    /** Provider explanation for the temporary delivery failure. */
-    reason: z.string().optional(),
+  webhookId: z.number().int().nonnegative(),
+}
 
-    /** Brevo transactional event category. */
-    type: z.literal("soft_bounce"),
+const createBrevoFamilyEventSchema = <
+  const TFamily extends (typeof BREVO_EVENT_FAMILIES)[number],
+  const TTypes extends readonly [string, ...string[]],
+>(
+  family: TFamily,
+  types: TTypes,
+) =>
+  z.object({
+    ...BREVO_NORMALIZED_EVENT_FIELDS,
+    family: z.literal(family),
+    type: z.enum(types),
   })
 
-export const BREVO_EMAIL_BLOCKED_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_BLOCKED_EVENT_SCHEMA,
-
-  /** Provider timestamp in milliseconds. */
-  timestampMilliseconds: z.number().int().nonnegative().optional(),
-
-  /** Brevo transactional event category. */
-  type: z.literal("blocked"),
-})
-
-export const BREVO_EMAIL_DEFERRED_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend(
-  {
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_DEFERRED_EVENT_SCHEMA,
-
-    /** Provider explanation for the delayed delivery attempt. */
-    reason: z.string().optional(),
-
-    /** Brevo transactional event category. */
-    type: z.literal("deferred"),
-  },
+export const BREVO_TRANSACTIONAL_EMAIL_EVENT_SCHEMA =
+  createBrevoFamilyEventSchema(
+    "transactionalEmail",
+    BREVO_TRANSACTIONAL_EMAIL_EVENT_TYPES,
+  )
+export const BREVO_TRANSACTIONAL_SMS_EVENT_SCHEMA =
+  createBrevoFamilyEventSchema(
+    "transactionalSms",
+    BREVO_TRANSACTIONAL_SMS_EVENT_TYPES,
+  )
+export const BREVO_MARKETING_EMAIL_EVENT_SCHEMA = createBrevoFamilyEventSchema(
+  "marketingEmail",
+  BREVO_MARKETING_EMAIL_EVENT_TYPES,
+)
+export const BREVO_MARKETING_SMS_EVENT_SCHEMA = createBrevoFamilyEventSchema(
+  "marketingSms",
+  BREVO_MARKETING_SMS_EVENT_TYPES,
+)
+export const BREVO_CONTACT_EVENT_SCHEMA = createBrevoFamilyEventSchema(
+  "contact",
+  BREVO_CONTACT_EVENT_TYPES,
 )
 
-const BREVO_EMAIL_OPENED_EVENT_MEMBER_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-  ...BREVO_ENGAGEMENT_METADATA_SCHEMA.shape,
-
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_OPENED_EVENT_SCHEMA,
-
-  /** Brevo transactional event category. */
-  type: z.literal("opened"),
-})
-
-const BREVO_EMAIL_UNIQUE_OPENED_EVENT_MEMBER_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_ENGAGEMENT_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_UNIQUE_OPENED_EVENT_SCHEMA,
-
-    /** Brevo transactional event category. */
-    type: z.literal("unique_opened"),
-  })
-
-export const BREVO_EMAIL_OPENED_EVENT_SCHEMA = z.discriminatedUnion("type", [
-  BREVO_EMAIL_OPENED_EVENT_MEMBER_SCHEMA,
-  BREVO_EMAIL_UNIQUE_OPENED_EVENT_MEMBER_SCHEMA,
+export const BREVO_EVENT_SCHEMA = z.discriminatedUnion("family", [
+  BREVO_TRANSACTIONAL_EMAIL_EVENT_SCHEMA,
+  BREVO_TRANSACTIONAL_SMS_EVENT_SCHEMA,
+  BREVO_MARKETING_EMAIL_EVENT_SCHEMA,
+  BREVO_MARKETING_SMS_EVENT_SCHEMA,
+  BREVO_CONTACT_EVENT_SCHEMA,
 ])
 
-export const BREVO_EMAIL_CLICKED_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-  ...BREVO_ENGAGEMENT_METADATA_SCHEMA.shape,
-
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_CLICKED_EVENT_SCHEMA,
-
-  /** URL followed by the recipient. */
-  link: z.string().optional(),
-
-  /** Brevo transactional event category. */
-  type: z.literal("click"),
-})
-
-export const BREVO_EMAIL_MARKED_AS_SPAM_EVENT_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_SPAM_EVENT_SCHEMA,
-
-    /** Brevo transactional event category. */
-    type: z.literal("spam"),
+export const createBrevoSemanticEventSchema = <
+  const TFamily extends (typeof BREVO_EVENT_FAMILIES)[number],
+  const TType extends string,
+>(
+  family: TFamily,
+  type: TType,
+) =>
+  z.object({
+    ...BREVO_NORMALIZED_EVENT_FIELDS,
+    family: z.literal(family),
+    type: z.literal(type),
   })
 
-export const BREVO_EMAIL_UNSUBSCRIBED_EVENT_SCHEMA =
-  BREVO_EVENT_BASE_SCHEMA.extend({
-    ...BREVO_DELIVERY_METADATA_SCHEMA.shape,
-    ...BREVO_ENGAGEMENT_METADATA_SCHEMA.shape,
-
-    /** Original provider webhook payload. */
-    event: BREVO_PROVIDER_UNSUBSCRIBED_EVENT_SCHEMA,
-
-    /** Provider-native serialized tag value for the unsubscribe. */
-    tag: z.string().optional(),
-
-    /** Brevo transactional event category. */
-    type: z.literal("unsubscribed"),
+const TRANSACTIONAL_EMAIL_PROVIDER_TYPES = {
+  blocked: "blocked",
+  click: "clicked",
+  deferred: "deferred",
+  delivered: "delivered",
+  hard_bounce: "hardBounced",
+  invalid_email: "invalid",
+  opened: "opened",
+  proxy_open: "opened",
+  request: "sent",
+  soft_bounce: "softBounced",
+  spam: "markedAsSpam",
+  unique_opened: "firstOpened",
+  unique_proxy_open: "firstOpened",
+  unsubscribed: "unsubscribed",
+} as const
+const SMS_PROVIDER_TYPES = {
+  delivered: "delivered",
+  hard_bounce: "hardBounced",
+  replied: "replied",
+  sent: "sent",
+  soft_bounce: "softBounced",
+  unsubscribed: "unsubscribed",
+} as const
+const MARKETING_EMAIL_PROVIDER_TYPES = {
+  click: "clicked",
+  delivered: "delivered",
+  hard_bounce: "hardBounced",
+  opened: "opened",
+  proxy_open: "opened",
+  soft_bounce: "softBounced",
+  spam: "markedAsSpam",
+  unsubscribe: "unsubscribed",
+  unsubscribed: "unsubscribed",
+} as const
+const CONTACT_PROVIDER_TYPES = {
+  contact_deleted: "deleted",
+  contact_updated: "updated",
+  list_addition: "addedToList",
+} as const
+
+const BREVO_PROVIDER_EVENT_SCHEMA = z
+  .looseObject({
+    camp_id: z.number().int().nonnegative().optional(),
+    campaign_id: z.number().int().nonnegative().optional(),
+    event: z.string().optional(),
+    id: z.number().int().nonnegative(),
+    msg_status: z.string().optional(),
+    type: z.string().optional(),
   })
-
-const BREVO_INVALID_EMAIL_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_INVALID_EMAIL_EVENT_SCHEMA,
-
-  /** Provider timestamp in milliseconds. */
-  timestampMilliseconds: z.number().int().nonnegative().optional(),
-
-  /** Brevo transactional event category. */
-  type: z.literal("invalid_email"),
-})
-
-const BREVO_ERROR_EVENT_SCHEMA = BREVO_EVENT_BASE_SCHEMA.extend({
-  /** Original provider webhook payload. */
-  event: BREVO_PROVIDER_ERROR_EVENT_SCHEMA,
-
-  /** Provider timestamp in milliseconds. */
-  timestampMilliseconds: z.number().int().nonnegative().optional(),
-
-  /** Brevo transactional event category. */
-  type: z.literal("error"),
-})
-
-export const BREVO_TRANSACTIONAL_EVENT_SCHEMA = z.discriminatedUnion("type", [
-  BREVO_EMAIL_BLOCKED_EVENT_SCHEMA,
-  BREVO_EMAIL_CLICKED_EVENT_SCHEMA,
-  BREVO_EMAIL_DEFERRED_EVENT_SCHEMA,
-  BREVO_EMAIL_DELIVERED_EVENT_SCHEMA,
-  BREVO_ERROR_EVENT_SCHEMA,
-  BREVO_EMAIL_HARD_BOUNCED_EVENT_SCHEMA,
-  BREVO_INVALID_EMAIL_EVENT_SCHEMA,
-  BREVO_EMAIL_OPENED_EVENT_MEMBER_SCHEMA,
-  BREVO_EMAIL_SENT_EVENT_SCHEMA,
-  BREVO_EMAIL_SOFT_BOUNCED_EVENT_SCHEMA,
-  BREVO_EMAIL_MARKED_AS_SPAM_EVENT_SCHEMA,
-  BREVO_EMAIL_UNIQUE_OPENED_EVENT_MEMBER_SCHEMA,
-  BREVO_EMAIL_UNSUBSCRIBED_EVENT_SCHEMA,
-])
+  .catchall(z.json())
 
 /**
- * Normalizes one provider-native Brevo transactional webhook.
+ * Normalizes every supported Brevo managed-webhook delivery.
  *
- * @param value - Untrusted provider webhook payload.
+ * @param value - Untrusted provider callback payload.
+ * @param webhookId - Authenticated provider webhook registration identity.
+ * @throws When the payload or event discriminator is unsupported.
  */
-export function normalizeBrevoTransactionalEvent(value: unknown) {
-  const event = BREVO_PROVIDER_TRANSACTIONAL_EVENT_SCHEMA.parse(value)
-  return BREVO_TRANSACTIONAL_EVENT_SCHEMA.parse({
+export function normalizeBrevoEvent(value: unknown, webhookId?: number) {
+  const event = BREVO_PROVIDER_EVENT_SCHEMA.parse(value)
+  const family = classifyBrevoEventFamily(event)
+  const providerType = event.msg_status ?? event.event
+  if (!providerType) throw new Error("Brevo webhook event type is missing.")
+  // Resolve the semantic discriminator before assembling the normalized payload.
+  const type = normalizeBrevoProviderType(family, providerType)
+  // Keep provider-to-public field mapping readable and validate it as one unit.
+  const payload = {
+    bounceType: event.bounce_type,
+    campaignId: event.camp_id ?? event.campaign_id,
+    campaignName: event["campaign name"] ?? event.campaign_name,
     contactId: event.contact_id,
+    content: event.content,
+    creditsUsed: event.credits_used,
     customHeader: event["X-Mailin-custom"],
     date: event.date,
+    dateEvent: event.date_event,
+    dateSent: event.date_sent,
+    description: event.description,
     deviceUsed: event.device_used,
     email: event.email,
+    errorCode: event.error_code,
     event,
+    family,
+    key: event.key,
     link: event.link,
-    messageId: event["message-id"],
+    listIds: event.list_id,
+    messageId: event["message-id"] ?? event.messageId,
     mirrorLink: event.mirror_link,
     occurredAt: event.ts_event,
+    phone: event.to,
     reason: event.reason,
+    reference: event.reference,
+    remainingCredit: event.remaining_credit,
+    reply: event.reply,
+    segmentIds: event.segment_ids,
+    senderEmail: event.sender_email,
     sendingIp: event.sending_ip,
+    smsCount: event.sms_count,
+    status: event.status,
     subject: event.subject,
     tag: event.tag,
     tags: event.tags,
     templateId: event.template_id,
     timestamp: event.ts,
     timestampMilliseconds: event.ts_epoch,
-    type: event.event,
+    timestampSent: event.ts_sent,
     userAgent: event.user_agent,
-    webhookId: event.id,
-  })
+    type,
+    webhookId: webhookId ?? event.id,
+  }
+  return BREVO_EVENT_SCHEMA.parse(payload)
+}
+
+/**
+ * Classifies a provider callback into its managed webhook family.
+ *
+ * @param event - Parsed provider callback.
+ */
+function classifyBrevoEventFamily(
+  event: z.infer<typeof BREVO_PROVIDER_EVENT_SCHEMA>,
+) {
+  if (event.msg_status) {
+    return event.type?.toLowerCase() === "marketing"
+      ? ("marketingSms" as const)
+      : ("transactionalSms" as const)
+  }
+  if (event.event && Object.hasOwn(CONTACT_PROVIDER_TYPES, event.event)) {
+    return "contact" as const
+  }
+  return event.camp_id !== undefined
+    ? ("marketingEmail" as const)
+    : ("transactionalEmail" as const)
+}
+
+/**
+ * Maps a provider event discriminator to the public semantic type.
+ *
+ * @param family - Managed webhook family.
+ * @param providerType - Provider event discriminator.
+ * @throws When the provider event is unsupported for the family.
+ */
+function normalizeBrevoProviderType(
+  family: (typeof BREVO_EVENT_FAMILIES)[number],
+  providerType: string,
+) {
+  // Select one family mapping before performing the shared lookup and failure path.
+  const mapping =
+    family === "transactionalEmail"
+      ? TRANSACTIONAL_EMAIL_PROVIDER_TYPES
+      : family === "marketingEmail"
+        ? MARKETING_EMAIL_PROVIDER_TYPES
+        : family === "contact"
+          ? CONTACT_PROVIDER_TYPES
+          : SMS_PROVIDER_TYPES
+  const type = (mapping as Record<string, string>)[providerType]
+  if (!type) {
+    throw new Error(`Unsupported Brevo ${family} event: ${providerType}`)
+  }
+  return type
 }