@automate.ax/integration-contracts 0.93.1 → 0.95.0

package/src/trello/event-schemas.ts

@@ -16,49 +16,49 @@ const TRELLO_CARD_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
   idShort: z.number().int().optional(),
   shortLink: z.string().optional(),
 })
-const TRELLO_LIST_SCHEMA = TRELLO_RESOURCE_SCHEMA
+const TRELLO_LIST_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
+  closed: z.boolean().optional(),
+})
 const TRELLO_MEMBER_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
   fullName: z.string().optional(),
   username: z.string().optional(),
 })
-const TRELLO_ACTION_DATA_SCHEMA = z
+const TRELLO_ATTACHMENT_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
+  url: z.string().optional(),
+})
+const TRELLO_CHECK_ITEM_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
+  state: z.enum(["complete", "incomplete"]).optional(),
+})
+const TRELLO_COMMENT_SCHEMA = TRELLO_RESOURCE_SCHEMA.extend({
+  text: z.string().optional(),
+})
+const TRELLO_CUSTOM_FIELD_ITEM_SCHEMA = z
   .looseObject({
-    /** Attachment affected by the action, when applicable. */
-    attachment: TRELLO_RESOURCE_SCHEMA.extend({
-      url: z.string().optional(),
-    }).optional(),
+    id: z.string().optional(),
+    idCustomField: z.string().optional(),
+    idModel: z.string().optional(),
+    idValue: z.string().optional(),
+    value: TRELLO_JSON_OBJECT_SCHEMA.optional(),
+  })
+  .catchall(z.json())
 
-    /** Board affected by the action. */
+const TRELLO_ACTION_DATA_SCHEMA = z
+  .looseObject({
+    action: TRELLO_COMMENT_SCHEMA.optional(),
+    attachment: TRELLO_ATTACHMENT_SCHEMA.optional(),
     board: TRELLO_BOARD_SCHEMA.optional(),
-
-    /** Card affected by the action, when applicable. */
     card: TRELLO_CARD_SCHEMA.optional(),
-
-    /** Checklist affected by the action, when applicable. */
     checklist: TRELLO_RESOURCE_SCHEMA.optional(),
-
-    /** Checklist item affected by the action, when applicable. */
-    checkItem: TRELLO_RESOURCE_SCHEMA.optional(),
-
-    /** List associated with the action. */
+    checkItem: TRELLO_CHECK_ITEM_SCHEMA.optional(),
+    customField: TRELLO_RESOURCE_SCHEMA.optional(),
+    customFieldItem: TRELLO_CUSTOM_FIELD_ITEM_SCHEMA.optional(),
+    label: TRELLO_RESOURCE_SCHEMA.optional(),
     list: TRELLO_LIST_SCHEMA.optional(),
-
-    /** Destination list for a move action. */
     listAfter: TRELLO_LIST_SCHEMA.optional(),
-
-    /** Source list for a move action. */
     listBefore: TRELLO_LIST_SCHEMA.optional(),
-
-    /** Member affected by the action, when applicable. */
     member: TRELLO_MEMBER_SCHEMA.optional(),
-
-    /** Previous field values supplied for an update action. */
     old: TRELLO_JSON_OBJECT_SCHEMA.optional(),
-
-    /** Organization affected by the action, when applicable. */
     organization: TRELLO_RESOURCE_SCHEMA.optional(),
-
-    /** Comment or other action text. */
     text: z.string().optional(),
   })
   .catchall(z.json())
@@ -68,6 +68,12 @@ const TRELLO_CARD_ACTION_DATA_SCHEMA = TRELLO_ACTION_DATA_SCHEMA.extend({
     .catchall(z.json())
     .optional(),
 })
+const TRELLO_LIST_ACTION_DATA_SCHEMA = TRELLO_ACTION_DATA_SCHEMA.extend({
+  old: z
+    .looseObject({ closed: z.boolean().optional() })
+    .catchall(z.json())
+    .optional(),
+})
 
 const TRELLO_WEBHOOK_EVENT_SCHEMA = z.object({
   action: z
@@ -75,19 +81,35 @@ const TRELLO_WEBHOOK_EVENT_SCHEMA = z.object({
       data: TRELLO_ACTION_DATA_SCHEMA,
       date: z.iso.datetime({ offset: true }),
       id: z.string(),
+      idMemberCreator: z.string().optional(),
       memberCreator: TRELLO_MEMBER_SCHEMA.optional(),
       type: z.string(),
     })
     .catchall(z.json()),
   model: TRELLO_BOARD_SCHEMA,
-  webhook: z.looseObject({ id: z.string() }).catchall(z.json()),
+  webhook: z
+    .looseObject({
+      active: z.boolean().optional(),
+      callbackURL: z.string().optional(),
+      consecutiveFailures: z.number().int().nonnegative().optional(),
+      firstConsecutiveFailDate: z.string().nullable().optional(),
+      id: z.string(),
+      idModel: z.string().optional(),
+    })
+    .catchall(z.json()),
 })
+
 const TRELLO_CARD_CREATED_ACTION_SCHEMA = z.enum([
   "copyCard",
   "convertToCardFromCheckItem",
   "createCard",
   "emailCard",
 ])
+const TRELLO_CARD_MOVED_ACTION_SCHEMA = z.enum([
+  "moveCardFromBoard",
+  "moveCardToBoard",
+  "updateCard",
+])
 const TRELLO_CARD_UPDATED_ACTION_SCHEMA = z.literal("updateCard")
 const TRELLO_CARD_COMMENTED_ACTION_SCHEMA = z.literal("commentCard")
 
@@ -96,66 +118,94 @@ export const TRELLO_CARD_EVENT_KINDS = [
   "moved",
   "updated",
   "archived",
+  "restored",
+  "deleted",
   "commented",
 ] as const
 
 export type TrelloCardEventKind = (typeof TRELLO_CARD_EVENT_KINDS)[number]
 
+export const TRELLO_EVENT_KINDS = [
+  "card.created",
+  "card.moved",
+  "card.updated",
+  "card.archived",
+  "card.restored",
+  "card.deleted",
+  "card.commented",
+  "comment.updated",
+  "comment.deleted",
+  "attachment.added",
+  "attachment.deleted",
+  "card.member.added",
+  "card.member.removed",
+  "card.label.added",
+  "card.label.removed",
+  "checklist.created",
+  "checklist.updated",
+  "checklist.deleted",
+  "checklist-item.created",
+  "checklist-item.updated",
+  "checklist-item.completed",
+  "checklist-item.deleted",
+  "custom-field.created",
+  "custom-field.updated",
+  "custom-field.deleted",
+  "custom-field.value.updated",
+  "list.created",
+  "list.updated",
+  "list.archived",
+  "list.restored",
+  "list.moved",
+] as const
+
+export type TrelloEventKind = (typeof TRELLO_EVENT_KINDS)[number]
+
 export const TRELLO_BOARD_EVENT_SCHEMA = TRELLO_ACTION_DATA_SCHEMA.extend({
-  /** Stable ID of the Trello action that caused this event. */
   actionId: z.string(),
-
-  /** Trello action category, such as `createCard` or `updateCard`. */
   actionType: z.string(),
-
-  /** Board affected by the action, falling back to the watched board. */
   board: TRELLO_BOARD_SCHEMA,
-
-  /** Complete provider webhook envelope. */
   event: TRELLO_WEBHOOK_EVENT_SCHEMA,
-
-  /** Member responsible for the action, when Trello includes one. */
   memberCreator: TRELLO_MEMBER_SCHEMA.optional(),
-
-  /** When the underlying Trello action occurred. */
   occurredAt: z.iso.datetime({ offset: true }),
-
-  /** Provider webhook that delivered the event. */
   webhookId: z.string(),
 })
 
 export const TRELLO_CARD_EVENT_SCHEMA = z.object({
-  /** Stable ID of the Trello action that caused this event. */
   actionId: z.string(),
-
-  /** Provider-native Trello action category. */
   actionType: z.string(),
-
-  /** Board containing the affected card. */
   board: TRELLO_BOARD_EVENT_SCHEMA.shape.board,
-
-  /** Card affected by the action. */
   card: TRELLO_CARD_SCHEMA,
-
-  /** Comment text for card-comment events. */
   commentText: z.string().optional(),
-
-  /** Complete provider webhook envelope. */
   event: TRELLO_WEBHOOK_EVENT_SCHEMA,
-
-  /** List containing the card after the action. */
   list: TRELLO_LIST_SCHEMA.optional(),
-
-  /** Member responsible for the action, when supplied by Trello. */
   memberCreator: TRELLO_BOARD_EVENT_SCHEMA.shape.memberCreator,
-
-  /** When the underlying Trello action occurred. */
   occurredAt: z.iso.datetime({ offset: true }),
-
-  /** List containing the card before a move. */
   previousList: TRELLO_LIST_SCHEMA.optional(),
 })
 
+const TRELLO_RESOURCE_EVENT_SCHEMA = z.object({
+  actionId: z.string(),
+  actionType: z.string(),
+  attachment: TRELLO_ATTACHMENT_SCHEMA.optional(),
+  board: TRELLO_BOARD_SCHEMA,
+  card: TRELLO_CARD_SCHEMA.optional(),
+  checklist: TRELLO_RESOURCE_SCHEMA.optional(),
+  checkItem: TRELLO_CHECK_ITEM_SCHEMA.optional(),
+  comment: TRELLO_COMMENT_SCHEMA.optional(),
+  customField: TRELLO_RESOURCE_SCHEMA.optional(),
+  customFieldItem: TRELLO_CUSTOM_FIELD_ITEM_SCHEMA.optional(),
+  event: TRELLO_WEBHOOK_EVENT_SCHEMA,
+  label: TRELLO_RESOURCE_SCHEMA.optional(),
+  list: TRELLO_LIST_SCHEMA.optional(),
+  listAfter: TRELLO_LIST_SCHEMA.optional(),
+  listBefore: TRELLO_LIST_SCHEMA.optional(),
+  member: TRELLO_MEMBER_SCHEMA.optional(),
+  memberCreator: TRELLO_MEMBER_SCHEMA.optional(),
+  occurredAt: z.iso.datetime({ offset: true }),
+  old: TRELLO_JSON_OBJECT_SCHEMA.optional(),
+})
+
 export const TRELLO_CARD_CREATED_EVENT_SCHEMA = TRELLO_CARD_EVENT_SCHEMA.extend(
   {
     actionType: TRELLO_CARD_CREATED_ACTION_SCHEMA,
@@ -164,10 +214,8 @@ export const TRELLO_CARD_CREATED_EVENT_SCHEMA = TRELLO_CARD_EVENT_SCHEMA.extend(
 )
 
 export const TRELLO_CARD_MOVED_EVENT_SCHEMA = TRELLO_CARD_EVENT_SCHEMA.extend({
-  actionType: TRELLO_CARD_UPDATED_ACTION_SCHEMA,
-  event: trelloWebhookEventSchema(TRELLO_CARD_UPDATED_ACTION_SCHEMA),
-  list: TRELLO_LIST_SCHEMA,
-  previousList: TRELLO_LIST_SCHEMA,
+  actionType: TRELLO_CARD_MOVED_ACTION_SCHEMA,
+  event: trelloWebhookEventSchema(TRELLO_CARD_MOVED_ACTION_SCHEMA),
 })
 
 export const TRELLO_CARD_UPDATED_EVENT_SCHEMA = TRELLO_CARD_EVENT_SCHEMA.extend(
@@ -182,6 +230,18 @@ export const TRELLO_CARD_ARCHIVED_EVENT_SCHEMA =
     card: TRELLO_CARD_SCHEMA.extend({ closed: z.literal(true) }),
   })
 
+export const TRELLO_CARD_RESTORED_EVENT_SCHEMA =
+  TRELLO_CARD_UPDATED_EVENT_SCHEMA.extend({
+    card: TRELLO_CARD_SCHEMA.extend({ closed: z.literal(false) }),
+  })
+
+export const TRELLO_CARD_DELETED_EVENT_SCHEMA = TRELLO_CARD_EVENT_SCHEMA.extend(
+  {
+    actionType: z.literal("deleteCard"),
+    event: trelloWebhookEventSchema(z.literal("deleteCard")),
+  },
+)
+
 export const TRELLO_CARD_COMMENTED_EVENT_SCHEMA =
   TRELLO_CARD_EVENT_SCHEMA.extend({
     actionType: TRELLO_CARD_COMMENTED_ACTION_SCHEMA,
@@ -189,10 +249,99 @@ export const TRELLO_CARD_COMMENTED_EVENT_SCHEMA =
     event: trelloWebhookEventSchema(TRELLO_CARD_COMMENTED_ACTION_SCHEMA),
   })
 
+export const TRELLO_COMMENT_UPDATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("updateComment"),
+)
+export const TRELLO_COMMENT_DELETED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("deleteComment"),
+)
+export const TRELLO_ATTACHMENT_ADDED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("addAttachmentToCard"),
+).extend({ attachment: TRELLO_ATTACHMENT_SCHEMA, card: TRELLO_CARD_SCHEMA })
+export const TRELLO_ATTACHMENT_DELETED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("deleteAttachmentFromCard"),
+).extend({ attachment: TRELLO_ATTACHMENT_SCHEMA, card: TRELLO_CARD_SCHEMA })
+export const TRELLO_CARD_MEMBER_ADDED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("addMemberToCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, member: TRELLO_MEMBER_SCHEMA })
+export const TRELLO_CARD_MEMBER_REMOVED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("removeMemberFromCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, member: TRELLO_MEMBER_SCHEMA })
+export const TRELLO_CARD_LABEL_ADDED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("addLabelToCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, label: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CARD_LABEL_REMOVED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("removeLabelFromCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, label: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CHECKLIST_CREATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("addChecklistToCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, checklist: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CHECKLIST_UPDATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("updateChecklist"),
+).extend({ checklist: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CHECKLIST_DELETED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("removeChecklistFromCard"),
+).extend({ card: TRELLO_CARD_SCHEMA, checklist: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CHECKLIST_ITEM_CREATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("createCheckItem"),
+).extend({
+  checkItem: TRELLO_CHECK_ITEM_SCHEMA,
+  checklist: TRELLO_RESOURCE_SCHEMA,
+})
+export const TRELLO_CHECKLIST_ITEM_UPDATED_EVENT_SCHEMA = resourceEventSchema(
+  z.enum(["updateCheckItem", "updateCheckItemStateOnCard"]),
+).extend({ checkItem: TRELLO_CHECK_ITEM_SCHEMA })
+export const TRELLO_CHECKLIST_ITEM_COMPLETED_EVENT_SCHEMA =
+  TRELLO_CHECKLIST_ITEM_UPDATED_EVENT_SCHEMA.extend({
+    actionType: z.literal("updateCheckItemStateOnCard"),
+    checkItem: TRELLO_CHECK_ITEM_SCHEMA.extend({
+      state: z.literal("complete"),
+    }),
+    event: trelloWebhookEventSchema(z.literal("updateCheckItemStateOnCard")),
+  })
+export const TRELLO_CHECKLIST_ITEM_DELETED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("deleteCheckItem"),
+).extend({
+  checkItem: TRELLO_CHECK_ITEM_SCHEMA,
+  checklist: TRELLO_RESOURCE_SCHEMA,
+})
+export const TRELLO_CUSTOM_FIELD_CREATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("addCustomField"),
+).extend({ customField: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CUSTOM_FIELD_UPDATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("updateCustomField"),
+).extend({ customField: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CUSTOM_FIELD_DELETED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("deleteCustomField"),
+).extend({ customField: TRELLO_RESOURCE_SCHEMA })
+export const TRELLO_CUSTOM_FIELD_VALUE_UPDATED_EVENT_SCHEMA =
+  resourceEventSchema(z.literal("updateCustomFieldItem")).extend({
+    card: TRELLO_CARD_SCHEMA,
+    customField: TRELLO_RESOURCE_SCHEMA,
+    customFieldItem: TRELLO_CUSTOM_FIELD_ITEM_SCHEMA,
+  })
+export const TRELLO_LIST_CREATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("createList"),
+).extend({ list: TRELLO_LIST_SCHEMA })
+export const TRELLO_LIST_UPDATED_EVENT_SCHEMA = resourceEventSchema(
+  z.literal("updateList"),
+).extend({ list: TRELLO_LIST_SCHEMA })
+export const TRELLO_LIST_ARCHIVED_EVENT_SCHEMA =
+  TRELLO_LIST_UPDATED_EVENT_SCHEMA.extend({
+    list: TRELLO_LIST_SCHEMA.extend({ closed: z.literal(true) }),
+  })
+export const TRELLO_LIST_RESTORED_EVENT_SCHEMA =
+  TRELLO_LIST_UPDATED_EVENT_SCHEMA.extend({
+    list: TRELLO_LIST_SCHEMA.extend({ closed: z.literal(false) }),
+  })
+export const TRELLO_LIST_MOVED_EVENT_SCHEMA = resourceEventSchema(
+  z.enum(["moveListFromBoard", "moveListToBoard"]),
+).extend({ list: TRELLO_LIST_SCHEMA })
+
 /**
  * Normalizes one provider-native Trello board webhook payload.
  *
- * @param value - Untrusted Trello webhook body.
+ * @param value - Untrusted provider webhook payload.
  */
 export function normalizeTrelloBoardEvent(value: unknown) {
   const event = TRELLO_WEBHOOK_EVENT_SCHEMA.parse(value)
@@ -210,17 +359,17 @@ export function normalizeTrelloBoardEvent(value: unknown) {
 }
 
 /**
- * Classifies one normalized board action into semantic card event categories.
+ * Classifies one board action into every supported semantic event.
  *
- * A single Trello action can intentionally belong to more than one category;
- * for example, moving a card is also a card update.
- *
- * @param event - Normalized board event received from Trello.
+ * @param event - Normalized board event.
  */
-export function getTrelloCardEventKinds(
+export function getTrelloEventKinds(
   event: z.output<typeof TRELLO_BOARD_EVENT_SCHEMA>,
-): TrelloCardEventKind[] {
-  const data = TRELLO_CARD_ACTION_DATA_SCHEMA.parse(event.event.action.data)
+): TrelloEventKind[] {
+  const data = TRELLO_ACTION_DATA_SCHEMA.parse(event.event.action.data)
+  const cardData = TRELLO_CARD_ACTION_DATA_SCHEMA.parse(data)
+  const listData = TRELLO_LIST_ACTION_DATA_SCHEMA.parse(data)
+  const actionType = event.actionType
 
   return [
     ...([
@@ -228,29 +377,133 @@ export function getTrelloCardEventKinds(
       "copyCard",
       "convertToCardFromCheckItem",
       "emailCard",
-    ].includes(event.actionType)
-      ? (["created"] as const)
+    ].includes(actionType)
+      ? (["card.created"] as const)
+      : []),
+    ...(actionType === "moveCardFromBoard" ||
+    actionType === "moveCardToBoard" ||
+    (actionType === "updateCard" && data.listBefore && data.listAfter)
+      ? (["card.moved"] as const)
+      : []),
+    ...(actionType === "updateCard" ? (["card.updated"] as const) : []),
+    ...(actionType === "updateCard" &&
+    cardData.old?.closed === false &&
+    cardData.card?.closed === true
+      ? (["card.archived"] as const)
+      : []),
+    ...(actionType === "updateCard" &&
+    cardData.old?.closed === true &&
+    cardData.card?.closed === false
+      ? (["card.restored"] as const)
+      : []),
+    ...(actionType === "deleteCard" ? (["card.deleted"] as const) : []),
+    ...(actionType === "commentCard" ? (["card.commented"] as const) : []),
+    ...(actionType === "updateComment" ? (["comment.updated"] as const) : []),
+    ...(actionType === "deleteComment" ? (["comment.deleted"] as const) : []),
+    ...(actionType === "addAttachmentToCard"
+      ? (["attachment.added"] as const)
       : []),
-    ...(event.actionType === "updateCard" &&
-    data.listBefore !== undefined &&
-    data.listAfter !== undefined
-      ? (["moved"] as const)
+    ...(actionType === "deleteAttachmentFromCard"
+      ? (["attachment.deleted"] as const)
       : []),
-    ...(event.actionType === "updateCard" ? (["updated"] as const) : []),
-    ...(event.actionType === "updateCard" &&
-    data.old?.closed === false &&
-    data.card?.closed === true
-      ? (["archived"] as const)
+    ...(actionType === "addMemberToCard"
+      ? (["card.member.added"] as const)
+      : []),
+    ...(actionType === "removeMemberFromCard"
+      ? (["card.member.removed"] as const)
+      : []),
+    ...(actionType === "addLabelToCard" ? (["card.label.added"] as const) : []),
+    ...(actionType === "removeLabelFromCard"
+      ? (["card.label.removed"] as const)
+      : []),
+    ...(actionType === "addChecklistToCard"
+      ? (["checklist.created"] as const)
+      : []),
+    ...(actionType === "updateChecklist"
+      ? (["checklist.updated"] as const)
+      : []),
+    ...(actionType === "removeChecklistFromCard"
+      ? (["checklist.deleted"] as const)
+      : []),
+    ...(actionType === "createCheckItem"
+      ? (["checklist-item.created"] as const)
+      : []),
+    ...(actionType === "updateCheckItem" ||
+    actionType === "updateCheckItemStateOnCard"
+      ? (["checklist-item.updated"] as const)
+      : []),
+    ...(actionType === "updateCheckItemStateOnCard" &&
+    data.checkItem?.state === "complete"
+      ? (["checklist-item.completed"] as const)
+      : []),
+    ...(actionType === "deleteCheckItem"
+      ? (["checklist-item.deleted"] as const)
+      : []),
+    ...(actionType === "addCustomField"
+      ? (["custom-field.created"] as const)
+      : []),
+    ...(actionType === "updateCustomField"
+      ? (["custom-field.updated"] as const)
+      : []),
+    ...(actionType === "deleteCustomField"
+      ? (["custom-field.deleted"] as const)
+      : []),
+    ...(actionType === "updateCustomFieldItem"
+      ? (["custom-field.value.updated"] as const)
+      : []),
+    ...(actionType === "createList" ? (["list.created"] as const) : []),
+    ...(actionType === "updateList" ? (["list.updated"] as const) : []),
+    ...(actionType === "updateList" &&
+    listData.old?.closed === false &&
+    listData.list?.closed === true
+      ? (["list.archived"] as const)
+      : []),
+    ...(actionType === "updateList" &&
+    listData.old?.closed === true &&
+    listData.list?.closed === false
+      ? (["list.restored"] as const)
+      : []),
+    ...(actionType === "moveListFromBoard" || actionType === "moveListToBoard"
+      ? (["list.moved"] as const)
       : []),
-    ...(event.actionType === "commentCard" ? (["commented"] as const) : []),
   ]
 }
 
 /**
- * Promotes provider-native card action data into the stable semantic payload.
+ * Classifies one board action into the card-oriented event categories.
  *
- * @param event - Normalized board event classified as a card event.
- * @throws When the classified Trello action does not identify a card.
+ * @param event - Normalized board event.
+ */
+export function getTrelloCardEventKinds(
+  event: z.output<typeof TRELLO_BOARD_EVENT_SCHEMA>,
+): TrelloCardEventKind[] {
+  return getTrelloEventKinds(event).flatMap((kind) => {
+    switch (kind) {
+      case "card.created":
+        return ["created"]
+      case "card.moved":
+        return ["moved"]
+      case "card.updated":
+        return ["updated"]
+      case "card.archived":
+        return ["archived"]
+      case "card.restored":
+        return ["restored"]
+      case "card.deleted":
+        return ["deleted"]
+      case "card.commented":
+        return ["commented"]
+      default:
+        return []
+    }
+  })
+}
+
+/**
+ * Promotes provider-native card action data into the stable card payload.
+ *
+ * @param event - Normalized board event.
+ * @throws When the provider action contains no card data.
  */
 export function normalizeTrelloCardEvent(
   event: z.output<typeof TRELLO_BOARD_EVENT_SCHEMA>,
@@ -275,9 +528,56 @@ export function normalizeTrelloCardEvent(
 }
 
 /**
- * Narrows the provider action type retained under a semantic event.
+ * Promotes provider action data into a shared resource-event payload.
+ *
+ * @param event - Normalized board event.
+ */
+export function normalizeTrelloResourceEvent(
+  event: z.output<typeof TRELLO_BOARD_EVENT_SCHEMA>,
+) {
+  const data = TRELLO_ACTION_DATA_SCHEMA.parse(event.event.action.data)
+
+  return TRELLO_RESOURCE_EVENT_SCHEMA.parse({
+    actionId: event.actionId,
+    actionType: event.actionType,
+    attachment: data.attachment,
+    board: event.board,
+    card: data.card,
+    checklist: data.checklist,
+    checkItem: data.checkItem,
+    comment: data.action,
+    customField: data.customField,
+    customFieldItem: data.customFieldItem,
+    event: event.event,
+    label: data.label,
+    list: data.listAfter ?? data.list,
+    listAfter: data.listAfter,
+    listBefore: data.listBefore,
+    member: data.member,
+    memberCreator: event.memberCreator,
+    occurredAt: event.occurredAt,
+    old: data.old,
+  })
+}
+
+/**
+ * Narrows the shared resource schema to one provider action type.
+ *
+ * @param actionType - Supported provider action schema.
+ */
+function resourceEventSchema<TAction extends z.ZodType<string>>(
+  actionType: TAction,
+) {
+  return TRELLO_RESOURCE_EVENT_SCHEMA.extend({
+    actionType,
+    event: trelloWebhookEventSchema(actionType),
+  })
+}
+
+/**
+ * Narrows the raw webhook schema to one provider action type.
  *
- * @param actionType - Provider action-type schema for the semantic event.
+ * @param actionType - Supported provider action schema.
  */
 function trelloWebhookEventSchema<TAction extends z.ZodType<string>>(
   actionType: TAction,