@automate.ax/integration-contracts 0.87.7 → 0.88.0

package/src/close/events.ts

@@ -0,0 +1,755 @@
+import * as z from "zod"
+import { CLOSE_OBJECT_SCHEMA } from "./api"
+import {
+  CLOSE_CALL_SCHEMA,
+  CLOSE_COMMENT_SCHEMA,
+  CLOSE_DATE_SCHEMA,
+  CLOSE_CONTACT_SCHEMA,
+  CLOSE_EMAIL_SCHEMA,
+  CLOSE_LEAD_SCHEMA,
+  CLOSE_MEETING_SCHEMA,
+  CLOSE_OPPORTUNITY_SCHEMA,
+  CLOSE_SEQUENCE_SUBSCRIPTION_SCHEMA,
+  CLOSE_SMS_SCHEMA,
+  CLOSE_TASK_SCHEMA,
+} from "./schemas"
+
+export const CLOSE_WEBHOOK_EVENT_SELECTIONS = [
+  ["lead", "created"],
+  ["lead", "updated"],
+  ["lead", "deleted"],
+  ["lead", "merged"],
+  ["contact", "created"],
+  ["contact", "updated"],
+  ["contact", "deleted"],
+  ["opportunity", "created"],
+  ["opportunity", "updated"],
+  ["opportunity", "deleted"],
+  ["task.lead", "created"],
+  ["task.lead", "updated"],
+  ["task.lead", "deleted"],
+  ["task.lead", "completed"],
+  ["task.incoming_email", "created"],
+  ["task.incoming_email", "updated"],
+  ["task.incoming_email", "deleted"],
+  ["task.incoming_email", "completed"],
+  ["task.email_followup", "created"],
+  ["task.email_followup", "updated"],
+  ["task.email_followup", "deleted"],
+  ["task.email_followup", "completed"],
+  ["task.missed_call", "created"],
+  ["task.missed_call", "updated"],
+  ["task.missed_call", "deleted"],
+  ["task.missed_call", "completed"],
+  ["task.answered_detached_call", "created"],
+  ["task.answered_detached_call", "updated"],
+  ["task.answered_detached_call", "deleted"],
+  ["task.answered_detached_call", "completed"],
+  ["task.voicemail", "created"],
+  ["task.voicemail", "updated"],
+  ["task.voicemail", "deleted"],
+  ["task.voicemail", "completed"],
+  ["task.opportunity_due", "created"],
+  ["task.opportunity_due", "updated"],
+  ["task.opportunity_due", "deleted"],
+  ["task.opportunity_due", "completed"],
+  ["task.incoming_sms", "created"],
+  ["task.incoming_sms", "updated"],
+  ["task.incoming_sms", "deleted"],
+  ["task.incoming_sms", "completed"],
+  ["task.outbound_call", "created"],
+  ["task.outbound_call", "updated"],
+  ["task.outbound_call", "deleted"],
+  ["task.outbound_call", "completed"],
+  ["activity.email", "created"],
+  ["activity.email", "updated"],
+  ["activity.email", "deleted"],
+  ["activity.email", "sent"],
+  ["activity.email_thread", "created"],
+  ["activity.email_thread", "updated"],
+  ["activity.email_thread", "deleted"],
+  ["unsubscribed_email", "created"],
+  ["unsubscribed_email", "deleted"],
+  ["activity.call", "created"],
+  ["activity.call", "updated"],
+  ["activity.call", "deleted"],
+  ["activity.call", "answered"],
+  ["activity.call", "completed"],
+  ["activity.sms", "created"],
+  ["activity.sms", "updated"],
+  ["activity.sms", "deleted"],
+  ["activity.sms", "sent"],
+  ["activity.whatsapp_message", "created"],
+  ["activity.whatsapp_message", "updated"],
+  ["activity.whatsapp_message", "deleted"],
+  ["activity.note", "created"],
+  ["activity.note", "updated"],
+  ["activity.note", "deleted"],
+  ["activity.meeting", "created"],
+  ["activity.meeting", "updated"],
+  ["activity.meeting", "deleted"],
+  ["activity.meeting", "scheduled"],
+  ["activity.meeting", "started"],
+  ["activity.meeting", "completed"],
+  ["activity.meeting", "canceled"],
+  ["activity.form_submission", "created"],
+  ["activity.form_submission", "updated"],
+  ["activity.form_submission", "deleted"],
+  ["activity.lead_status_change", "created"],
+  ["activity.lead_status_change", "updated"],
+  ["activity.lead_status_change", "deleted"],
+  ["activity.opportunity_status_change", "created"],
+  ["activity.opportunity_status_change", "updated"],
+  ["activity.opportunity_status_change", "deleted"],
+  ["activity.task_completed", "created"],
+  ["activity.task_completed", "deleted"],
+  ["activity.lead_merge", "created"],
+  ["activity.lead_merge", "updated"],
+  ["activity.lead_merge", "deleted"],
+  ["import", "created"],
+  ["import", "updated"],
+  ["import", "completed"],
+  ["import", "reverting"],
+  ["import", "reverted"],
+  ["export.lead", "created"],
+  ["export.lead", "updated"],
+  ["export.lead", "completed"],
+  ["export.opportunity", "created"],
+  ["export.opportunity", "updated"],
+  ["export.opportunity", "completed"],
+  ["bulk_action.delete", "created"],
+  ["bulk_action.delete", "updated"],
+  ["bulk_action.delete", "completed"],
+  ["bulk_action.delete", "paused"],
+  ["bulk_action.edit", "created"],
+  ["bulk_action.edit", "updated"],
+  ["bulk_action.edit", "completed"],
+  ["bulk_action.edit", "paused"],
+  ["bulk_action.email", "created"],
+  ["bulk_action.email", "updated"],
+  ["bulk_action.email", "completed"],
+  ["bulk_action.email", "paused"],
+  ["bulk_action.sequence_subscription", "created"],
+  ["bulk_action.sequence_subscription", "updated"],
+  ["bulk_action.sequence_subscription", "completed"],
+  ["bulk_action.sequence_subscription", "paused"],
+  ["custom_fields.lead", "created"],
+  ["custom_fields.lead", "updated"],
+  ["custom_fields.lead", "deleted"],
+  ["custom_fields.contact", "created"],
+  ["custom_fields.contact", "updated"],
+  ["custom_fields.contact", "deleted"],
+  ["custom_fields.opportunity", "created"],
+  ["custom_fields.opportunity", "updated"],
+  ["custom_fields.opportunity", "deleted"],
+  ["custom_fields.activity", "created"],
+  ["custom_fields.activity", "updated"],
+  ["custom_fields.activity", "deleted"],
+  ["custom_fields.custom_object", "created"],
+  ["custom_fields.custom_object", "updated"],
+  ["custom_fields.custom_object", "deleted"],
+  ["custom_fields.shared", "created"],
+  ["custom_fields.shared", "updated"],
+  ["custom_fields.shared", "deleted"],
+  ["custom_activity_type", "created"],
+  ["custom_activity_type", "updated"],
+  ["custom_activity_type", "deleted"],
+  ["activity.custom_activity", "created"],
+  ["activity.custom_activity", "updated"],
+  ["activity.custom_activity", "deleted"],
+  ["custom_object_type", "created"],
+  ["custom_object_type", "updated"],
+  ["custom_object_type", "deleted"],
+  ["custom_object", "created"],
+  ["custom_object", "updated"],
+  ["custom_object", "deleted"],
+  ["status.lead", "created"],
+  ["status.lead", "updated"],
+  ["status.lead", "deleted"],
+  ["status.opportunity", "created"],
+  ["status.opportunity", "updated"],
+  ["status.opportunity", "deleted"],
+  ["membership", "activated"],
+  ["membership", "deactivated"],
+  ["group", "created"],
+  ["group", "updated"],
+  ["group", "deleted"],
+  ["saved_search", "created"],
+  ["saved_search", "updated"],
+  ["phone_number", "created"],
+  ["phone_number", "updated"],
+  ["phone_number", "deleted"],
+  ["email_template", "created"],
+  ["email_template", "updated"],
+  ["email_template", "deleted"],
+  ["sms_template", "created"],
+  ["sms_template", "updated"],
+  ["sms_template", "deleted"],
+  ["sequence", "created"],
+  ["sequence", "updated"],
+  ["sequence", "deleted"],
+  ["sequence_subscription", "created"],
+  ["sequence_subscription", "updated"],
+  ["sequence_subscription", "deleted"],
+  ["comment", "created"],
+  ["comment", "updated"],
+  ["comment", "deleted"],
+  ["comment_thread", "created"],
+  ["comment_thread", "updated"],
+  ["comment_thread", "deleted"],
+] as const
+
+export type CloseWebhookEventSelection =
+  (typeof CLOSE_WEBHOOK_EVENT_SELECTIONS)[number]
+
+export const CLOSE_EVENT_SCHEMA = z.object({
+  action: z.string(),
+  apiKeyId: z.string().nullable().optional(),
+  changedFields: z.string().array().prefault([]),
+  createdAt: CLOSE_DATE_SCHEMA,
+  data: CLOSE_OBJECT_SCHEMA.nullable(),
+  id: z.string(),
+  leadId: z.string().nullable(),
+  meta: CLOSE_OBJECT_SCHEMA.prefault({}),
+  objectId: z.string(),
+  objectType: z.string(),
+  organizationId: z.string(),
+  previousData: CLOSE_OBJECT_SCHEMA.nullable(),
+  requestId: z.string().nullable().optional(),
+  updatedAt: CLOSE_DATE_SCHEMA,
+  userId: z.string().nullable(),
+})
+
+export const CLOSE_WEBHOOK_PAYLOAD_SCHEMA = z.object({
+  event: CLOSE_EVENT_SCHEMA,
+  subscriptionId: z.string(),
+})
+
+export const CLOSE_TRIGGER_CONFIG_SCHEMA = z.object({})
+
+// Event snapshots can omit fields that are required by the current REST
+// resource. Close's documented opportunity-won webhook is one such payload.
+const CLOSE_CALL_EVENT_DATA_SCHEMA = CLOSE_CALL_SCHEMA.partial()
+const CLOSE_COMMENT_EVENT_DATA_SCHEMA = CLOSE_COMMENT_SCHEMA.partial()
+const CLOSE_CONTACT_EVENT_DATA_SCHEMA = CLOSE_CONTACT_SCHEMA.partial()
+const CLOSE_EMAIL_EVENT_DATA_SCHEMA = CLOSE_EMAIL_SCHEMA.partial()
+const CLOSE_LEAD_EVENT_DATA_SCHEMA = CLOSE_LEAD_SCHEMA.partial()
+const CLOSE_MEETING_EVENT_DATA_SCHEMA = CLOSE_MEETING_SCHEMA.partial()
+const CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA = CLOSE_OPPORTUNITY_SCHEMA.partial()
+const CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA =
+  CLOSE_SEQUENCE_SUBSCRIPTION_SCHEMA.partial()
+const CLOSE_SMS_EVENT_DATA_SCHEMA = CLOSE_SMS_SCHEMA.partial()
+const CLOSE_TASK_EVENT_DATA_SCHEMA = z.union([
+  CLOSE_TASK_SCHEMA.options[0].partial(),
+  CLOSE_TASK_SCHEMA.options[1].partial(),
+  CLOSE_TASK_SCHEMA.options[2].partial(),
+  CLOSE_TASK_SCHEMA.options[3].partial(),
+  CLOSE_TASK_SCHEMA.options[4].partial(),
+  CLOSE_TASK_SCHEMA.options[5].partial(),
+  CLOSE_TASK_SCHEMA.options[6].partial(),
+  CLOSE_TASK_SCHEMA.options[7].partial(),
+  CLOSE_TASK_SCHEMA.options[8].partial(),
+])
+
+const SEMANTIC_EVENTS = {
+  "close.call.answered": [
+    "activity.call",
+    "answered",
+    CLOSE_CALL_EVENT_DATA_SCHEMA,
+  ],
+  "close.call.completed": [
+    "activity.call",
+    "completed",
+    CLOSE_CALL_EVENT_DATA_SCHEMA,
+  ],
+  "close.comment.created": [
+    "comment",
+    "created",
+    CLOSE_COMMENT_EVENT_DATA_SCHEMA,
+  ],
+  "close.comment.deleted": ["comment", "deleted", null],
+  "close.comment.updated": [
+    "comment",
+    "updated",
+    CLOSE_COMMENT_EVENT_DATA_SCHEMA,
+  ],
+  "close.contact.created": [
+    "contact",
+    "created",
+    CLOSE_CONTACT_EVENT_DATA_SCHEMA,
+  ],
+  "close.contact.deleted": ["contact", "deleted", null],
+  "close.contact.updated": [
+    "contact",
+    "updated",
+    CLOSE_CONTACT_EVENT_DATA_SCHEMA,
+  ],
+  "close.email.received": [
+    "activity.email",
+    "created",
+    CLOSE_EMAIL_EVENT_DATA_SCHEMA,
+  ],
+  "close.email.sent": ["activity.email", "sent", CLOSE_EMAIL_EVENT_DATA_SCHEMA],
+  "close.lead.created": ["lead", "created", CLOSE_LEAD_EVENT_DATA_SCHEMA],
+  "close.lead.deleted": ["lead", "deleted", null],
+  "close.lead.merged": ["lead", "merged", CLOSE_LEAD_EVENT_DATA_SCHEMA],
+  "close.lead.updated": ["lead", "updated", CLOSE_LEAD_EVENT_DATA_SCHEMA],
+  "close.meeting.canceled": [
+    "activity.meeting",
+    "canceled",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ],
+  "close.meeting.completed": [
+    "activity.meeting",
+    "completed",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ],
+  "close.meeting.scheduled": [
+    "activity.meeting",
+    "scheduled",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ],
+  "close.meeting.started": [
+    "activity.meeting",
+    "started",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ],
+  "close.opportunity.created": [
+    "opportunity",
+    "created",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ],
+  "close.opportunity.deleted": ["opportunity", "deleted", null],
+  "close.opportunity.lost": [
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ],
+  "close.opportunity.updated": [
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ],
+  "close.opportunity.won": [
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.created": [
+    "sequence_subscription",
+    "created",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.deleted": [
+    "sequence_subscription",
+    "deleted",
+    null,
+  ],
+  "close.sequenceSubscription.errored": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.finished": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.goalReached": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.paused": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.resumed": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sequenceSubscription.updated": [
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ],
+  "close.sms.received": [
+    "activity.sms",
+    "created",
+    CLOSE_SMS_EVENT_DATA_SCHEMA,
+  ],
+  "close.sms.sent": ["activity.sms", "sent", CLOSE_SMS_EVENT_DATA_SCHEMA],
+  "close.task.completed": ["task.*", "completed", CLOSE_TASK_EVENT_DATA_SCHEMA],
+  "close.task.created": ["task.*", "created", CLOSE_TASK_EVENT_DATA_SCHEMA],
+  "close.task.deleted": ["task.*", "deleted", null],
+  "close.task.updated": ["task.*", "updated", CLOSE_TASK_EVENT_DATA_SCHEMA],
+} as const
+
+export const CLOSE_SEMANTIC_EVENT_TYPES = [
+  "close.call.answered",
+  "close.call.completed",
+  "close.comment.created",
+  "close.comment.deleted",
+  "close.comment.updated",
+  "close.contact.created",
+  "close.contact.deleted",
+  "close.contact.updated",
+  "close.email.received",
+  "close.email.sent",
+  "close.lead.created",
+  "close.lead.deleted",
+  "close.lead.merged",
+  "close.lead.updated",
+  "close.meeting.canceled",
+  "close.meeting.completed",
+  "close.meeting.scheduled",
+  "close.meeting.started",
+  "close.opportunity.created",
+  "close.opportunity.deleted",
+  "close.opportunity.lost",
+  "close.opportunity.updated",
+  "close.opportunity.won",
+  "close.sequenceSubscription.created",
+  "close.sequenceSubscription.deleted",
+  "close.sequenceSubscription.errored",
+  "close.sequenceSubscription.finished",
+  "close.sequenceSubscription.goalReached",
+  "close.sequenceSubscription.paused",
+  "close.sequenceSubscription.resumed",
+  "close.sequenceSubscription.updated",
+  "close.sms.received",
+  "close.sms.sent",
+  "close.task.completed",
+  "close.task.created",
+  "close.task.deleted",
+  "close.task.updated",
+] as const satisfies readonly (keyof typeof SEMANTIC_EVENTS)[]
+
+export const closeTriggerContracts = {
+  "close.event": {
+    configSchema: CLOSE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLOSE_EVENT_SCHEMA,
+  },
+  "close.call.answered": semanticContract(
+    "activity.call",
+    "answered",
+    CLOSE_CALL_EVENT_DATA_SCHEMA,
+  ),
+  "close.call.completed": semanticContract(
+    "activity.call",
+    "completed",
+    CLOSE_CALL_EVENT_DATA_SCHEMA,
+  ),
+  "close.comment.created": semanticContract(
+    "comment",
+    "created",
+    CLOSE_COMMENT_EVENT_DATA_SCHEMA,
+  ),
+  "close.comment.deleted": semanticContract("comment", "deleted", z.null()),
+  "close.comment.updated": semanticContract(
+    "comment",
+    "updated",
+    CLOSE_COMMENT_EVENT_DATA_SCHEMA,
+  ),
+  "close.contact.created": semanticContract(
+    "contact",
+    "created",
+    CLOSE_CONTACT_EVENT_DATA_SCHEMA,
+  ),
+  "close.contact.deleted": semanticContract("contact", "deleted", z.null()),
+  "close.contact.updated": semanticContract(
+    "contact",
+    "updated",
+    CLOSE_CONTACT_EVENT_DATA_SCHEMA,
+  ),
+  "close.email.received": semanticContract(
+    "activity.email",
+    "created",
+    CLOSE_EMAIL_EVENT_DATA_SCHEMA,
+  ),
+  "close.email.sent": semanticContract(
+    "activity.email",
+    "sent",
+    CLOSE_EMAIL_EVENT_DATA_SCHEMA,
+  ),
+  "close.lead.created": semanticContract(
+    "lead",
+    "created",
+    CLOSE_LEAD_EVENT_DATA_SCHEMA,
+  ),
+  "close.lead.deleted": semanticContract("lead", "deleted", z.null()),
+  "close.lead.merged": semanticContract(
+    "lead",
+    "merged",
+    CLOSE_LEAD_EVENT_DATA_SCHEMA,
+  ),
+  "close.lead.updated": semanticContract(
+    "lead",
+    "updated",
+    CLOSE_LEAD_EVENT_DATA_SCHEMA,
+  ),
+  "close.meeting.canceled": semanticContract(
+    "activity.meeting",
+    "canceled",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ),
+  "close.meeting.completed": semanticContract(
+    "activity.meeting",
+    "completed",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ),
+  "close.meeting.scheduled": semanticContract(
+    "activity.meeting",
+    "scheduled",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ),
+  "close.meeting.started": semanticContract(
+    "activity.meeting",
+    "started",
+    CLOSE_MEETING_EVENT_DATA_SCHEMA,
+  ),
+  "close.opportunity.created": semanticContract(
+    "opportunity",
+    "created",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ),
+  "close.opportunity.deleted": semanticContract(
+    "opportunity",
+    "deleted",
+    z.null(),
+  ),
+  "close.opportunity.lost": semanticContract(
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ),
+  "close.opportunity.updated": semanticContract(
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ),
+  "close.opportunity.won": semanticContract(
+    "opportunity",
+    "updated",
+    CLOSE_OPPORTUNITY_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.created": semanticContract(
+    "sequence_subscription",
+    "created",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.deleted": semanticContract(
+    "sequence_subscription",
+    "deleted",
+    z.null(),
+  ),
+  "close.sequenceSubscription.errored": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.finished": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.goalReached": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.paused": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.resumed": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sequenceSubscription.updated": semanticContract(
+    "sequence_subscription",
+    "updated",
+    CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
+  ),
+  "close.sms.received": semanticContract(
+    "activity.sms",
+    "created",
+    CLOSE_SMS_EVENT_DATA_SCHEMA,
+  ),
+  "close.sms.sent": semanticContract(
+    "activity.sms",
+    "sent",
+    CLOSE_SMS_EVENT_DATA_SCHEMA,
+  ),
+  "close.task.completed": taskContract(
+    "completed",
+    CLOSE_TASK_EVENT_DATA_SCHEMA,
+  ),
+  "close.task.created": taskContract("created", CLOSE_TASK_EVENT_DATA_SCHEMA),
+  "close.task.deleted": taskContract("deleted", z.null()),
+  "close.task.updated": taskContract("updated", CLOSE_TASK_EVENT_DATA_SCHEMA),
+} as const satisfies Record<
+  string,
+  {
+    configSchema: typeof CLOSE_TRIGGER_CONFIG_SCHEMA
+    eventSchema: z.ZodType
+  }
+>
+
+/**
+ * Classifies one normalized Close event into semantic trigger types.
+ *
+ * @param event - Normalized Close webhook event.
+ */
+export function getCloseSemanticEventTypes(
+  event: z.output<typeof CLOSE_EVENT_SCHEMA>,
+) {
+  const exact = CLOSE_SEMANTIC_EVENT_TYPES.filter((type) => {
+    const [objectType, action] = SEMANTIC_EVENTS[type]
+    return (
+      type !== "close.opportunity.won" &&
+      type !== "close.opportunity.lost" &&
+      type !== "close.email.received" &&
+      type !== "close.sms.received" &&
+      type !== "close.sequenceSubscription.errored" &&
+      type !== "close.sequenceSubscription.finished" &&
+      type !== "close.sequenceSubscription.goalReached" &&
+      type !== "close.sequenceSubscription.paused" &&
+      type !== "close.sequenceSubscription.resumed" &&
+      action === event.action &&
+      (objectType === "task.*"
+        ? event.objectType.startsWith("task.")
+        : objectType === event.objectType)
+    )
+  })
+
+  if (
+    event.objectType === "opportunity" &&
+    event.action === "updated" &&
+    event.data &&
+    event.previousData &&
+    event.changedFields.includes("status_type")
+  ) {
+    const statusType = event.data.statusType
+    if (statusType !== event.previousData.statusType) {
+      if (statusType === "won") exact.push("close.opportunity.won")
+      if (statusType === "lost") exact.push("close.opportunity.lost")
+    }
+  }
+  if (
+    event.action === "created" &&
+    event.data &&
+    ((event.objectType === "activity.email" &&
+      event.data.direction === "incoming") ||
+      (event.objectType === "activity.sms" &&
+        event.data.direction === "inbound"))
+  ) {
+    exact.push(
+      event.objectType === "activity.email"
+        ? "close.email.received"
+        : "close.sms.received",
+    )
+  }
+  if (
+    event.objectType === "sequence_subscription" &&
+    event.action === "updated" &&
+    event.data &&
+    event.previousData &&
+    event.changedFields.includes("status") &&
+    event.data.status !== event.previousData.status
+  ) {
+    const status = event.data.status
+    if (status === "active") {
+      exact.push("close.sequenceSubscription.resumed")
+    } else if (status === "error") {
+      exact.push("close.sequenceSubscription.errored")
+    } else if (status === "finished") {
+      exact.push("close.sequenceSubscription.finished")
+    } else if (status === "goal") {
+      exact.push("close.sequenceSubscription.goalReached")
+    } else if (status === "paused") {
+      exact.push("close.sequenceSubscription.paused")
+    }
+  }
+  return [...new Set(exact)]
+}
+
+/**
+ * Resolves the provider event selections needed by a Close trigger type.
+ *
+ * @param type - Registered Close trigger type.
+ */
+export function getCloseProviderEventSelection(
+  type: string,
+): readonly CloseWebhookEventSelection[] {
+  if (type === "close.event") return CLOSE_WEBHOOK_EVENT_SELECTIONS
+  if (!isCloseSemanticEventType(type)) return []
+  const selection = SEMANTIC_EVENTS[type]
+  if (selection[0] === "task.*") {
+    return CLOSE_WEBHOOK_EVENT_SELECTIONS.filter(
+      ([objectType, action]) =>
+        objectType.startsWith("task.") && action === selection[1],
+    )
+  }
+  return CLOSE_WEBHOOK_EVENT_SELECTIONS.filter(
+    ([objectType, action]) =>
+      objectType === selection[0] && action === selection[1],
+  )
+}
+
+/**
+ * Creates a semantic Close trigger contract.
+ *
+ * @param objectType - Exact provider object type.
+ * @param action - Exact provider action.
+ * @param dataSchema - Schema for the event object snapshot.
+ */
+function semanticContract<
+  const TObjectType extends string,
+  const TAction extends string,
+  TDataSchema extends z.ZodType,
+>(objectType: TObjectType, action: TAction, dataSchema: TDataSchema) {
+  return {
+    configSchema: CLOSE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLOSE_EVENT_SCHEMA.extend({
+      action: z.literal(action),
+      data: dataSchema,
+      objectType: z.literal(objectType),
+    }),
+  }
+}
+
+/**
+ * Creates a task-family Close trigger contract.
+ *
+ * @param action - Exact provider action.
+ * @param dataSchema - Schema for the task snapshot.
+ */
+function taskContract<
+  const TAction extends string,
+  TDataSchema extends z.ZodType,
+>(action: TAction, dataSchema: TDataSchema) {
+  return {
+    configSchema: CLOSE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLOSE_EVENT_SCHEMA.extend({
+      action: z.literal(action),
+      data: dataSchema,
+      objectType: z.string().startsWith("task."),
+    }),
+  }
+}
+
+/**
+ * Checks whether a trigger type has a semantic Close definition.
+ *
+ * @param type - Candidate trigger type.
+ */
+function isCloseSemanticEventType(
+  type: string,
+): type is (typeof CLOSE_SEMANTIC_EVENT_TYPES)[number] {
+  return CLOSE_SEMANTIC_EVENT_TYPES.some((candidate) => candidate === type)
+}