@automate.ax/integration-contracts 0.93.1 → 0.95.0

package/src/trello/index.ts

@@ -1,11 +1,37 @@
 import * as z from "zod"
 import {
+  TRELLO_ATTACHMENT_ADDED_EVENT_SCHEMA,
+  TRELLO_ATTACHMENT_DELETED_EVENT_SCHEMA,
   TRELLO_BOARD_EVENT_SCHEMA,
   TRELLO_CARD_ARCHIVED_EVENT_SCHEMA,
   TRELLO_CARD_COMMENTED_EVENT_SCHEMA,
   TRELLO_CARD_CREATED_EVENT_SCHEMA,
+  TRELLO_CARD_DELETED_EVENT_SCHEMA,
+  TRELLO_CARD_LABEL_ADDED_EVENT_SCHEMA,
+  TRELLO_CARD_LABEL_REMOVED_EVENT_SCHEMA,
+  TRELLO_CARD_MEMBER_ADDED_EVENT_SCHEMA,
+  TRELLO_CARD_MEMBER_REMOVED_EVENT_SCHEMA,
   TRELLO_CARD_MOVED_EVENT_SCHEMA,
+  TRELLO_CARD_RESTORED_EVENT_SCHEMA,
   TRELLO_CARD_UPDATED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_CREATED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_DELETED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_ITEM_COMPLETED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_ITEM_CREATED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_ITEM_DELETED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_ITEM_UPDATED_EVENT_SCHEMA,
+  TRELLO_CHECKLIST_UPDATED_EVENT_SCHEMA,
+  TRELLO_COMMENT_DELETED_EVENT_SCHEMA,
+  TRELLO_COMMENT_UPDATED_EVENT_SCHEMA,
+  TRELLO_CUSTOM_FIELD_CREATED_EVENT_SCHEMA,
+  TRELLO_CUSTOM_FIELD_DELETED_EVENT_SCHEMA,
+  TRELLO_CUSTOM_FIELD_UPDATED_EVENT_SCHEMA,
+  TRELLO_CUSTOM_FIELD_VALUE_UPDATED_EVENT_SCHEMA,
+  TRELLO_LIST_ARCHIVED_EVENT_SCHEMA,
+  TRELLO_LIST_CREATED_EVENT_SCHEMA,
+  TRELLO_LIST_MOVED_EVENT_SCHEMA,
+  TRELLO_LIST_RESTORED_EVENT_SCHEMA,
+  TRELLO_LIST_UPDATED_EVENT_SCHEMA,
 } from "./event-schemas"
 
 export * from "./api"
@@ -14,7 +40,7 @@ export * from "./schemas"
 
 /** Canonical Trello board selected by one webhook subscription. */
 export const TRELLO_TRIGGER_CONFIG_SCHEMA = z.object({
-  boardId: z.string(),
+  boardId: z.string().trim().min(1),
 })
 
 export const trelloTriggerContracts = {
@@ -26,6 +52,26 @@ export const trelloTriggerContracts = {
     configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
     eventSchema: TRELLO_CARD_ARCHIVED_EVENT_SCHEMA,
   },
+  "trello.card.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_DELETED_EVENT_SCHEMA,
+  },
+  "trello.card.label.added": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_LABEL_ADDED_EVENT_SCHEMA,
+  },
+  "trello.card.label.removed": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_LABEL_REMOVED_EVENT_SCHEMA,
+  },
+  "trello.card.member.added": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_MEMBER_ADDED_EVENT_SCHEMA,
+  },
+  "trello.card.member.removed": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_MEMBER_REMOVED_EVENT_SCHEMA,
+  },
   "trello.card.commented": {
     configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
     eventSchema: TRELLO_CARD_COMMENTED_EVENT_SCHEMA,
@@ -38,8 +84,92 @@ export const trelloTriggerContracts = {
     configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
     eventSchema: TRELLO_CARD_MOVED_EVENT_SCHEMA,
   },
+  "trello.card.restored": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CARD_RESTORED_EVENT_SCHEMA,
+  },
   "trello.card.updated": {
     configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
     eventSchema: TRELLO_CARD_UPDATED_EVENT_SCHEMA,
   },
+  "trello.attachment.added": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_ATTACHMENT_ADDED_EVENT_SCHEMA,
+  },
+  "trello.attachment.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_ATTACHMENT_DELETED_EVENT_SCHEMA,
+  },
+  "trello.checklist.created": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_CREATED_EVENT_SCHEMA,
+  },
+  "trello.checklist.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_DELETED_EVENT_SCHEMA,
+  },
+  "trello.checklist.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_UPDATED_EVENT_SCHEMA,
+  },
+  "trello.checklist-item.completed": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_ITEM_COMPLETED_EVENT_SCHEMA,
+  },
+  "trello.checklist-item.created": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_ITEM_CREATED_EVENT_SCHEMA,
+  },
+  "trello.checklist-item.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_ITEM_DELETED_EVENT_SCHEMA,
+  },
+  "trello.checklist-item.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CHECKLIST_ITEM_UPDATED_EVENT_SCHEMA,
+  },
+  "trello.comment.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_COMMENT_DELETED_EVENT_SCHEMA,
+  },
+  "trello.comment.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_COMMENT_UPDATED_EVENT_SCHEMA,
+  },
+  "trello.custom-field.created": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CUSTOM_FIELD_CREATED_EVENT_SCHEMA,
+  },
+  "trello.custom-field.deleted": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CUSTOM_FIELD_DELETED_EVENT_SCHEMA,
+  },
+  "trello.custom-field.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CUSTOM_FIELD_UPDATED_EVENT_SCHEMA,
+  },
+  "trello.custom-field.value.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_CUSTOM_FIELD_VALUE_UPDATED_EVENT_SCHEMA,
+  },
+  "trello.list.archived": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_LIST_ARCHIVED_EVENT_SCHEMA,
+  },
+  "trello.list.created": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_LIST_CREATED_EVENT_SCHEMA,
+  },
+  "trello.list.moved": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_LIST_MOVED_EVENT_SCHEMA,
+  },
+  "trello.list.restored": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_LIST_RESTORED_EVENT_SCHEMA,
+  },
+  "trello.list.updated": {
+    configSchema: TRELLO_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: TRELLO_LIST_UPDATED_EVENT_SCHEMA,
+  },
 } as const

package/src/trello/schemas.ts

@@ -26,6 +26,26 @@ export const TRELLO_MEMBER_SCHEMA = z.object({
   username: z.string(),
 })
 
+export const TRELLO_WORKSPACE_SCHEMA = z.object({
+  /** Last activity time across the Workspace. */
+  lastActivityAt: z.date().nullable(),
+
+  /** Human-readable Workspace name. */
+  displayName: z.string(),
+
+  /** Stable Trello Workspace ID. */
+  id: z.string(),
+
+  /** URL-safe Workspace name. */
+  name: z.string(),
+
+  /** Public Trello Workspace URL. */
+  url: z.string().nullable(),
+
+  /** Public Workspace website, when configured. */
+  website: z.string().nullable(),
+})
+
 export const TRELLO_BOARD_SCHEMA = z.object({
   /** Whether the board is archived. */
   closed: z.boolean(),
@@ -58,6 +78,23 @@ export const TRELLO_BOARD_SCHEMA = z.object({
   url: z.string(),
 })
 
+export const TRELLO_BOARD_MEMBERSHIP_SCHEMA = z.object({
+  /** Whether the member is deactivated on this board. */
+  deactivated: z.boolean(),
+
+  /** Stable Trello board membership ID. */
+  id: z.string(),
+
+  /** Stable Trello member ID represented by this membership. */
+  memberId: z.string(),
+
+  /** Member's role on this board. */
+  memberType: z.enum(["admin", "normal", "observer"]),
+
+  /** Whether this membership is an unconfirmed invitation. */
+  unconfirmed: z.boolean(),
+})
+
 export const TRELLO_LIST_SCHEMA = z.object({
   /** Stable ID of the containing board. */
   boardId: z.string(),
@@ -231,6 +268,71 @@ export const TRELLO_CHECKLIST_SCHEMA = z.object({
   position: z.number(),
 })
 
+export const TRELLO_CUSTOM_FIELD_OPTION_SCHEMA = z.object({
+  /** Trello label color, or `none`. */
+  color: z.string(),
+
+  /** Stable Trello Custom Field ID. */
+  customFieldId: z.string(),
+
+  /** Stable Trello Custom Field option ID. */
+  id: z.string(),
+
+  /** Trello ordering position. */
+  position: z.number(),
+
+  /** Human-readable dropdown value. */
+  text: z.string(),
+})
+
+export const TRELLO_CUSTOM_FIELD_SCHEMA = z.object({
+  /** Whether the field is displayed on card fronts. */
+  displayOnCardFront: z.boolean(),
+
+  /** Stable Trello field-group hash. */
+  fieldGroup: z.string().optional(),
+
+  /** Stable Trello Custom Field ID. */
+  id: z.string(),
+
+  /** Board containing the Custom Field. */
+  modelId: z.string(),
+
+  /** Custom Field name. */
+  name: z.string(),
+
+  /** Dropdown options, for list fields. */
+  options: TRELLO_CUSTOM_FIELD_OPTION_SCHEMA.array(),
+
+  /** Trello ordering position. */
+  position: z.number(),
+
+  /** Custom Field value type. */
+  type: z.enum(["checkbox", "date", "list", "number", "text"]),
+})
+
+export const TRELLO_CUSTOM_FIELD_VALUE_SCHEMA = z.discriminatedUnion("type", [
+  z.object({ checked: z.boolean(), type: z.literal("checkbox") }),
+  z.object({ date: z.date(), type: z.literal("date") }),
+  z.object({ optionId: z.string(), type: z.literal("list") }),
+  z.object({ number: z.string(), type: z.literal("number") }),
+  z.object({ text: z.string(), type: z.literal("text") }),
+])
+
+export const TRELLO_CUSTOM_FIELD_ITEM_SCHEMA = z.object({
+  /** Card containing the value. */
+  cardId: z.string(),
+
+  /** Custom Field definition represented by the value. */
+  customFieldId: z.string(),
+
+  /** Stable Trello Custom Field item ID. */
+  id: z.string(),
+
+  /** Typed value stored on the card. */
+  value: TRELLO_CUSTOM_FIELD_VALUE_SCHEMA,
+})
+
 export const TRELLO_PROVIDER_MEMBER_SCHEMA = z.looseObject({
   avatarUrl: z.string().nullable().optional(),
   fullName: z.string(),
@@ -240,6 +342,15 @@ export const TRELLO_PROVIDER_MEMBER_SCHEMA = z.looseObject({
   username: z.string(),
 })
 
+export const TRELLO_PROVIDER_WORKSPACE_SCHEMA = z.looseObject({
+  dateLastActivity: z.string().nullable().optional(),
+  displayName: z.string(),
+  id: z.string(),
+  name: z.string(),
+  url: z.string().nullable().optional(),
+  website: z.string().nullable().optional(),
+})
+
 export const TRELLO_PROVIDER_BOARD_SCHEMA = z.looseObject({
   closed: z.boolean().prefault(false),
   dateLastActivity: z.string().nullable().optional(),
@@ -253,6 +364,14 @@ export const TRELLO_PROVIDER_BOARD_SCHEMA = z.looseObject({
   url: z.string().prefault(""),
 })
 
+export const TRELLO_PROVIDER_BOARD_MEMBERSHIP_SCHEMA = z.looseObject({
+  deactivated: z.boolean(),
+  id: z.string(),
+  idMember: z.string(),
+  memberType: z.enum(["admin", "normal", "observer"]),
+  unconfirmed: z.boolean(),
+})
+
 export const TRELLO_PROVIDER_LIST_SCHEMA = z.looseObject({
   closed: z.boolean().prefault(false),
   id: z.string(),
@@ -327,6 +446,44 @@ export const TRELLO_PROVIDER_CHECKLIST_SCHEMA = z.looseObject({
   pos: z.number(),
 })
 
+export const TRELLO_PROVIDER_CUSTOM_FIELD_OPTION_SCHEMA = z.looseObject({
+  color: z.string().prefault("none"),
+  id: z.string(),
+  idCustomField: z.string(),
+  pos: z.number(),
+  value: z.looseObject({ text: z.string() }),
+})
+
+export const TRELLO_PROVIDER_CUSTOM_FIELD_SCHEMA = z.looseObject({
+  display: z
+    .looseObject({ cardFront: z.boolean().prefault(true) })
+    .prefault({ cardFront: true }),
+  fieldGroup: z.string().optional(),
+  id: z.string(),
+  idModel: z.string(),
+  modelType: z.literal("board"),
+  name: z.string(),
+  options: TRELLO_PROVIDER_CUSTOM_FIELD_OPTION_SCHEMA.array().prefault([]),
+  pos: z.number(),
+  type: z.enum(["checkbox", "date", "list", "number", "text"]),
+})
+
+const TRELLO_PROVIDER_CUSTOM_FIELD_VALUE_SCHEMA = z.looseObject({
+  checked: z.union([z.boolean(), z.enum(["true", "false"])]).optional(),
+  date: z.string().optional(),
+  number: z.string().optional(),
+  text: z.string().optional(),
+})
+
+export const TRELLO_PROVIDER_CUSTOM_FIELD_ITEM_SCHEMA = z.looseObject({
+  id: z.string(),
+  idCustomField: z.string(),
+  idModel: z.string(),
+  idValue: z.string().optional(),
+  modelType: z.literal("card"),
+  value: TRELLO_PROVIDER_CUSTOM_FIELD_VALUE_SCHEMA.optional(),
+})
+
 /**
  * Normalizes one Trello member response.
  *
@@ -345,6 +502,24 @@ export function toTrelloMember(
   }
 }
 
+/**
+ * Normalizes one Trello Workspace response.
+ *
+ * @param workspace - Provider Workspace resource.
+ */
+export function toTrelloWorkspace(
+  workspace: z.output<typeof TRELLO_PROVIDER_WORKSPACE_SCHEMA>,
+): z.output<typeof TRELLO_WORKSPACE_SCHEMA> {
+  return {
+    displayName: workspace.displayName,
+    id: workspace.id,
+    lastActivityAt: OPTIONAL_DATE_SCHEMA.parse(workspace.dateLastActivity),
+    name: workspace.name,
+    url: workspace.url ?? null,
+    website: workspace.website ?? null,
+  }
+}
+
 /**
  * Normalizes one Trello board response.
  *
@@ -367,6 +542,23 @@ export function toTrelloBoard(
   }
 }
 
+/**
+ * Normalizes one Trello board membership response.
+ *
+ * @param membership - Provider board membership resource.
+ */
+export function toTrelloBoardMembership(
+  membership: z.output<typeof TRELLO_PROVIDER_BOARD_MEMBERSHIP_SCHEMA>,
+): z.output<typeof TRELLO_BOARD_MEMBERSHIP_SCHEMA> {
+  return {
+    deactivated: membership.deactivated,
+    id: membership.id,
+    memberId: membership.idMember,
+    memberType: membership.memberType,
+    unconfirmed: membership.unconfirmed,
+  }
+}
+
 /**
  * Normalizes one Trello list response.
  *
@@ -505,3 +697,84 @@ export function toTrelloChecklist(
     position: checklist.pos,
   }
 }
+
+/**
+ * Normalizes one Trello Custom Field option.
+ *
+ * @param option - Provider Custom Field option.
+ */
+export function toTrelloCustomFieldOption(
+  option: z.output<typeof TRELLO_PROVIDER_CUSTOM_FIELD_OPTION_SCHEMA>,
+): z.output<typeof TRELLO_CUSTOM_FIELD_OPTION_SCHEMA> {
+  return {
+    color: option.color,
+    customFieldId: option.idCustomField,
+    id: option.id,
+    position: option.pos,
+    text: option.value.text,
+  }
+}
+
+/**
+ * Normalizes one Trello Custom Field definition.
+ *
+ * @param field - Provider Custom Field definition.
+ */
+export function toTrelloCustomField(
+  field: z.output<typeof TRELLO_PROVIDER_CUSTOM_FIELD_SCHEMA>,
+): z.output<typeof TRELLO_CUSTOM_FIELD_SCHEMA> {
+  return {
+    displayOnCardFront: field.display.cardFront,
+    fieldGroup: field.fieldGroup,
+    id: field.id,
+    modelId: field.idModel,
+    name: field.name,
+    options: field.options.map(toTrelloCustomFieldOption),
+    position: field.pos,
+    type: field.type,
+  }
+}
+
+/**
+ * Normalizes one typed Trello card Custom Field value.
+ *
+ * @param item - Provider Custom Field item.
+ */
+export function toTrelloCustomFieldItem(
+  item: z.output<typeof TRELLO_PROVIDER_CUSTOM_FIELD_ITEM_SCHEMA>,
+): z.output<typeof TRELLO_CUSTOM_FIELD_ITEM_SCHEMA> {
+  return {
+    cardId: item.idModel,
+    customFieldId: item.idCustomField,
+    id: item.id,
+    value: toTrelloCustomFieldValue(item),
+  }
+}
+
+/**
+ * Converts the provider's key-selected value into a public discriminated union.
+ *
+ * @param item - Provider Custom Field item.
+ * @throws When the provider item contains no supported typed value.
+ */
+function toTrelloCustomFieldValue(
+  item: z.output<typeof TRELLO_PROVIDER_CUSTOM_FIELD_ITEM_SCHEMA>,
+): z.output<typeof TRELLO_CUSTOM_FIELD_VALUE_SCHEMA> {
+  if (item.idValue) return { optionId: item.idValue, type: "list" }
+  if (item.value?.checked !== undefined) {
+    return {
+      checked:
+        typeof item.value.checked === "boolean"
+          ? item.value.checked
+          : item.value.checked === "true",
+      type: "checkbox",
+    }
+  }
+  if (item.value?.date !== undefined)
+    return { date: new Date(item.value.date), type: "date" }
+  if (item.value?.number !== undefined)
+    return { number: item.value.number, type: "number" }
+  if (item.value?.text !== undefined)
+    return { text: item.value.text, type: "text" }
+  throw new Error(`Trello Custom Field item ${item.id} has no typed value.`)
+}