@automate.ax/integration-contracts 0.87.7 → 0.88.0

package/dist/close/events.js

@@ -0,0 +1,575 @@
+import * as z from "zod";
+import { CLOSE_OBJECT_SCHEMA } from "./api.js";
+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.js";
+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"],
+];
+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],
+};
+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",
+];
+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),
+};
+/**
+ * Classifies one normalized Close event into semantic trigger types.
+ *
+ * @param event - Normalized Close webhook event.
+ */
+export function getCloseSemanticEventTypes(event) {
+    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) {
+    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(objectType, action, dataSchema) {
+    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(action, dataSchema) {
+    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) {
+    return CLOSE_SEMANTIC_EVENT_TYPES.some((candidate) => candidate === type);
+}

package/dist/close/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./api.js";
+export * from "./events.js";
+export * from "./schemas.js";

package/dist/close/index.js

@@ -0,0 +1,3 @@
+export * from "./api.js";
+export * from "./events.js";
+export * from "./schemas.js";