@automate.ax/integration-contracts 0.114.4 → 0.115.2

package/dist/brevo/schemas.js

@@ -1,332 +1,268 @@
 import * as z from "zod";
-export const BREVO_TRANSACTIONAL_EVENT_TYPES = [
+export const BREVO_EVENT_FAMILIES = [
+    "transactionalEmail",
+    "transactionalSms",
+    "marketingEmail",
+    "marketingSms",
+    "contact",
+];
+export const BREVO_TRANSACTIONAL_EMAIL_EVENT_TYPES = [
+    "sent",
+    "delivered",
+    "hardBounced",
+    "softBounced",
     "blocked",
-    "click",
+    "markedAsSpam",
+    "invalid",
     "deferred",
+    "clicked",
+    "opened",
+    "firstOpened",
+    "unsubscribed",
+];
+export const BREVO_TRANSACTIONAL_SMS_EVENT_TYPES = [
+    "sent",
     "delivered",
-    "error",
-    "hard_bounce",
-    "invalid_email",
+    "hardBounced",
+    "softBounced",
+    "replied",
+    "unsubscribed",
+];
+export const BREVO_MARKETING_EMAIL_EVENT_TYPES = [
+    "delivered",
+    "hardBounced",
+    "softBounced",
+    "markedAsSpam",
     "opened",
-    "request",
-    "soft_bounce",
-    "spam",
-    "unique_opened",
+    "clicked",
     "unsubscribed",
 ];
-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(),
-});
-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(),
-});
-const BREVO_PROVIDER_ERROR_EVENT_SCHEMA = BREVO_PROVIDER_EVENT_BASE_SCHEMA.extend({
-    event: z.literal("error"),
-    ts_epoch: z.number().int().nonnegative().optional(),
-});
-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,
-]);
-const BREVO_EVENT_BASE_SCHEMA = z.object({
-    /** Custom header supplied with the original email. */
+export const BREVO_CONTACT_EVENT_TYPES = [
+    "addedToList",
+    "updated",
+    "deleted",
+];
+export const BREVO_MARKETING_SMS_EVENT_TYPES = [
+    "sent",
+    "delivered",
+    "hardBounced",
+    "softBounced",
+    "replied",
+    "unsubscribed",
+];
+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(),
+    webhookId: z.number().int().nonnegative(),
+};
+const createBrevoFamilyEventSchema = (family, types) => z.object({
+    ...BREVO_NORMALIZED_EVENT_FIELDS,
+    family: z.literal(family),
+    type: z.enum(types),
 });
-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(),
-    /** Brevo transactional event category. */
-    type: z.literal("soft_bounce"),
-});
-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"),
-});
-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_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);
+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 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 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"),
+export const createBrevoSemanticEventSchema = (family, type) => z.object({
+    ...BREVO_NORMALIZED_EVENT_FIELDS,
+    family: z.literal(family),
+    type: z.literal(type),
 });
-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,
-]);
+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",
+};
+const SMS_PROVIDER_TYPES = {
+    delivered: "delivered",
+    hard_bounce: "hardBounced",
+    replied: "replied",
+    sent: "sent",
+    soft_bounce: "softBounced",
+    unsubscribed: "unsubscribed",
+};
+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",
+};
+const CONTACT_PROVIDER_TYPES = {
+    contact_deleted: "deleted",
+    contact_updated: "updated",
+    list_addition: "addedToList",
+};
+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(),
+})
+    .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) {
-    const event = BREVO_PROVIDER_TRANSACTIONAL_EVENT_SCHEMA.parse(value);
-    return BREVO_TRANSACTIONAL_EVENT_SCHEMA.parse({
+export function normalizeBrevoEvent(value, webhookId) {
+    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) {
+    if (event.msg_status) {
+        return event.type?.toLowerCase() === "marketing"
+            ? "marketingSms"
+            : "transactionalSms";
+    }
+    if (event.event && Object.hasOwn(CONTACT_PROVIDER_TYPES, event.event)) {
+        return "contact";
+    }
+    return event.camp_id !== undefined
+        ? "marketingEmail"
+        : "transactionalEmail";
+}
+/**
+ * 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, providerType) {
+    // 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[providerType];
+    if (!type) {
+        throw new Error(`Unsupported Brevo ${family} event: ${providerType}`);
+    }
+    return type;
 }

package/dist/close/events.d.ts

@@ -2021,8 +2021,8 @@ export declare const closeTriggerContracts: {
                 sQuery: z.ZodOptional<z.ZodNullable<z.ZodCustom<Record<string, import("@automate.ax/codec").Encodable>, Record<string, import("@automate.ax/codec").Encodable>>>>;
                 type: z.ZodOptional<z.ZodEnum<{
                     email: "email";
-                    lead: "lead";
                     contact: "contact";
+                    lead: "lead";
                     opportunity: "opportunity";
                     call: "call";
                     sms: "sms";
@@ -2078,8 +2078,8 @@ export declare const closeTriggerContracts: {
                 sQuery: z.ZodOptional<z.ZodNullable<z.ZodCustom<Record<string, import("@automate.ax/codec").Encodable>, Record<string, import("@automate.ax/codec").Encodable>>>>;
                 type: z.ZodOptional<z.ZodEnum<{
                     email: "email";
-                    lead: "lead";
                     contact: "contact";
+                    lead: "lead";
                     opportunity: "opportunity";
                     call: "call";
                     sms: "sms";

package/dist/close/schemas.d.ts

@@ -87,8 +87,8 @@ export declare const CLOSE_CONTACT_SCHEMA: z.ZodObject<{
 }, z.core.$strip>;
 export declare const CLOSE_SMART_VIEW_TYPE_SCHEMA: z.ZodEnum<{
     email: "email";
-    lead: "lead";
     contact: "contact";
+    lead: "lead";
     opportunity: "opportunity";
     call: "call";
     sms: "sms";
@@ -130,8 +130,8 @@ export declare const CLOSE_SMART_VIEW_SCHEMA: z.ZodObject<{
     sQuery: z.ZodNullable<z.ZodCustom<Record<string, import("@automate.ax/codec").Encodable>, Record<string, import("@automate.ax/codec").Encodable>>>;
     type: z.ZodEnum<{
         email: "email";
-        lead: "lead";
         contact: "contact";
+        lead: "lead";
         opportunity: "opportunity";
         call: "call";
         sms: "sms";

package/dist/convex/index.d.ts

@@ -19,8 +19,8 @@ export declare const convexTriggerContracts: {
         readonly eventSchema: z.ZodObject<{
             action: z.ZodEnum<{
                 deleted: "deleted";
-                created: "created";
                 updated: "updated";
+                created: "created";
             }>;
             component: z.ZodString;
             document: z.ZodNullable<z.ZodObject<{
@@ -41,8 +41,8 @@ export declare const convexTriggerContracts: {
         readonly eventSchema: z.ZodObject<{
             action: z.ZodEnum<{
                 deleted: "deleted";
-                created: "created";
                 updated: "updated";
+                created: "created";
             }>;
             component: z.ZodString;
             document: z.ZodNullable<z.ZodObject<{
@@ -63,8 +63,8 @@ export declare const convexTriggerContracts: {
         readonly eventSchema: z.ZodObject<{
             action: z.ZodEnum<{
                 deleted: "deleted";
-                created: "created";
                 updated: "updated";
+                created: "created";
             }>;
             component: z.ZodString;
             document: z.ZodNullable<z.ZodObject<{
@@ -85,8 +85,8 @@ export declare const convexTriggerContracts: {
         readonly eventSchema: z.ZodObject<{
             action: z.ZodEnum<{
                 deleted: "deleted";
-                created: "created";
                 updated: "updated";
+                created: "created";
             }>;
             component: z.ZodString;
             document: z.ZodNullable<z.ZodObject<{

package/dist/convex/schemas.d.ts

@@ -11,14 +11,14 @@ export declare const CONVEX_DOCUMENT_SCHEMA: z.ZodObject<{
 export declare const CONVEX_DOCUMENT_EVENT_TYPES: readonly ["convex.document.event", "convex.document.created", "convex.document.updated", "convex.document.deleted"];
 export declare const CONVEX_DOCUMENT_ACTION_SCHEMA: z.ZodEnum<{
     deleted: "deleted";
-    created: "created";
     updated: "updated";
+    created: "created";
 }>;
 export declare const CONVEX_DOCUMENT_EVENT_SCHEMA: z.ZodObject<{
     action: z.ZodEnum<{
         deleted: "deleted";
-        created: "created";
         updated: "updated";
+        created: "created";
     }>;
     component: z.ZodString;
     document: z.ZodNullable<z.ZodObject<{

package/dist/linear/schemas.d.ts

@@ -4500,9 +4500,9 @@ export declare const LINEAR_PROVIDER_ISSUE_SCHEMA: z.ZodObject<{
         id: z.ZodString;
         name: z.ZodString;
     }, z.core.$strip>>;
+    title: z.ZodString;
     priority: z.ZodNumber;
     url: z.ZodString;
-    title: z.ZodString;
     updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>;
     state: z.ZodObject<{
         color: z.ZodString;