@automate.ax/integration-contracts 0.95.4 → 0.97.0

package/src/slack/index.ts

@@ -1,10 +1,30 @@
 import * as z from "zod"
 import {
-  SLACK_APP_MENTION_EVENT_SCHEMA,
-  SLACK_MESSAGE_POSTED_EVENT_SCHEMA,
-  SLACK_REACTION_EVENT_SCHEMA,
-} from "./schemas"
+  SLACK_APP_MENTION_CALLBACK_EVENT_SCHEMA,
+  SLACK_CHANNEL_CREATED_EVENT_SCHEMA,
+  SLACK_CHANNEL_MEMBER_JOINED_EVENT_SCHEMA,
+  SLACK_CHANNEL_MEMBER_LEFT_EVENT_SCHEMA,
+  SLACK_CHANNEL_RENAMED_EVENT_SCHEMA,
+  SLACK_CHANNEL_SHARED_EVENT_SCHEMA,
+  SLACK_CHANNEL_UNSHARED_EVENT_SCHEMA,
+  SLACK_EVENT_SCHEMA,
+  SLACK_FILE_CREATED_EVENT_SCHEMA,
+  SLACK_FILE_DELETED_EVENT_SCHEMA,
+  SLACK_FILE_SHARED_EVENT_SCHEMA,
+  SLACK_MESSAGE_CHANGED_EVENT_SCHEMA,
+  SLACK_MESSAGE_DELETED_EVENT_SCHEMA,
+  SLACK_MESSAGE_POSTED_CALLBACK_EVENT_SCHEMA,
+  SLACK_PIN_ADDED_EVENT_SCHEMA,
+  SLACK_PIN_REMOVED_EVENT_SCHEMA,
+  SLACK_REACTION_ADDED_CALLBACK_EVENT_SCHEMA,
+  SLACK_REACTION_CALLBACK_EVENT_SCHEMA,
+  SLACK_REACTION_REMOVED_CALLBACK_EVENT_SCHEMA,
+  SLACK_THREAD_REPLY_POSTED_EVENT_SCHEMA,
+  SLACK_WORKSPACE_MEMBER_CHANGED_EVENT_SCHEMA,
+  SLACK_WORKSPACE_MEMBER_JOINED_EVENT_SCHEMA,
+} from "./event-schemas"
 
+export * from "./event-schemas"
 export * from "./schemas"
 
 export const SLACK_TRIGGER_CONFIG_SCHEMA = z.object({})
@@ -12,18 +32,90 @@ export const SLACK_TRIGGER_CONFIG_SCHEMA = z.object({})
 export const slackTriggerContracts = {
   "slack.app.mentioned": {
     configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
-    eventSchema: SLACK_APP_MENTION_EVENT_SCHEMA,
+    eventSchema: SLACK_APP_MENTION_CALLBACK_EVENT_SCHEMA,
+  },
+  "slack.channel.created": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_CREATED_EVENT_SCHEMA,
+  },
+  "slack.channel.member.joined": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_MEMBER_JOINED_EVENT_SCHEMA,
+  },
+  "slack.channel.member.left": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_MEMBER_LEFT_EVENT_SCHEMA,
+  },
+  "slack.channel.renamed": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_RENAMED_EVENT_SCHEMA,
+  },
+  "slack.channel.shared": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_SHARED_EVENT_SCHEMA,
+  },
+  "slack.channel.unshared": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_CHANNEL_UNSHARED_EVENT_SCHEMA,
+  },
+  "slack.event.received": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_EVENT_SCHEMA,
+  },
+  "slack.file.created": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_FILE_CREATED_EVENT_SCHEMA,
+  },
+  "slack.file.deleted": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_FILE_DELETED_EVENT_SCHEMA,
+  },
+  "slack.file.shared": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_FILE_SHARED_EVENT_SCHEMA,
+  },
+  "slack.message.changed": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_MESSAGE_CHANGED_EVENT_SCHEMA,
+  },
+  "slack.message.deleted": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_MESSAGE_DELETED_EVENT_SCHEMA,
   },
   "slack.message.posted": {
     configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
-    eventSchema: SLACK_MESSAGE_POSTED_EVENT_SCHEMA,
+    eventSchema: SLACK_MESSAGE_POSTED_CALLBACK_EVENT_SCHEMA,
+  },
+  "slack.pin.added": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_PIN_ADDED_EVENT_SCHEMA,
+  },
+  "slack.pin.removed": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_PIN_REMOVED_EVENT_SCHEMA,
   },
   "slack.reaction.added": {
     configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
-    eventSchema: SLACK_REACTION_EVENT_SCHEMA,
+    eventSchema: SLACK_REACTION_ADDED_CALLBACK_EVENT_SCHEMA,
+  },
+  "slack.reaction.event": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_REACTION_CALLBACK_EVENT_SCHEMA,
   },
   "slack.reaction.removed": {
     configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
-    eventSchema: SLACK_REACTION_EVENT_SCHEMA,
+    eventSchema: SLACK_REACTION_REMOVED_CALLBACK_EVENT_SCHEMA,
+  },
+  "slack.thread.reply.posted": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_THREAD_REPLY_POSTED_EVENT_SCHEMA,
+  },
+  "slack.workspace.member.changed": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_WORKSPACE_MEMBER_CHANGED_EVENT_SCHEMA,
+  },
+  "slack.workspace.member.joined": {
+    configSchema: SLACK_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: SLACK_WORKSPACE_MEMBER_JOINED_EVENT_SCHEMA,
   },
 } as const

package/src/slack/schemas.ts

@@ -196,8 +196,8 @@ export const SLACK_MESSAGE_SCHEMA = z.object({
   /** Message subtype supplied by Slack. */
   subtype: z.string().optional(),
 
-  /** Plain-text message content or accessibility fallback. */
-  text: z.string(),
+  /** Plain-text message content or accessibility fallback, when supplied. */
+  text: z.string().optional(),
 
   /** Parent message timestamp when this message belongs to a thread. */
   threadTimestamp: z.string().optional(),
@@ -217,8 +217,8 @@ export const SLACK_REACTION_ITEM_SCHEMA = z.discriminatedUnion("type", [
     /** Slack conversation containing the reacted-to message. */
     conversationId: z.string(),
 
-    /** Provider conversation category such as `channel`, `group`, or `im`. */
-    conversationType: z.string().optional(),
+    /** Provider conversation category. */
+    conversationType: z.enum(["channel", "group", "im", "mpim"]).optional(),
 
     /** Timestamp identifying the reacted-to message. */
     messageTimestamp: z.string(),
@@ -242,26 +242,6 @@ export const SLACK_REACTION_ITEM_SCHEMA = z.discriminatedUnion("type", [
   }),
 ])
 
-export const SLACK_REACTION_EVENT_SCHEMA = z.object({
-  /** Slack timestamp identifying when the event occurred. */
-  eventTimestamp: z.string(),
-
-  /** Reacted-to Slack item. */
-  item: SLACK_REACTION_ITEM_SCHEMA,
-
-  /** Author of the reacted-to item, when Slack can identify one. */
-  itemUserId: z.string().optional(),
-
-  /** Emoji name without surrounding colons. */
-  reaction: z.string(),
-
-  /** Slack user who added or removed the reaction. */
-  userId: z.string(),
-
-  /** Slack workspace in which the event occurred. */
-  workspaceId: z.string(),
-})
-
 export const SLACK_FILE_SCHEMA = z.object({
   /** Channels in which the file is shared. */
   channelIds: z.string().array().optional(),
@@ -279,7 +259,7 @@ export const SLACK_FILE_SCHEMA = z.object({
   mimeType: z.string().optional(),
 
   /** Original filename. */
-  name: z.string().optional(),
+  name: z.string().nullable().optional(),
 
   /** Slack permalink for the file. */
   permalink: z.string().optional(),
@@ -382,39 +362,45 @@ export const SLACK_PROVIDER_CONVERSATION_SCHEMA = z.looseObject({
   user: z.string().optional(),
 })
 
-export const SLACK_PROVIDER_MEMBER_PROFILE_SCHEMA = z.looseObject({
-  display_name: z.string().optional(),
-  email: z.string().optional(),
-  first_name: z.string().optional(),
-  image_192: z.string().optional(),
-  image_512: z.string().optional(),
-  image_72: z.string().optional(),
-  last_name: z.string().optional(),
-  pronouns: z.string().optional(),
-  real_name: z.string().optional(),
-  status_emoji: z.string().optional(),
-  status_expiration: z.number().int().nonnegative().optional(),
-  status_text: z.string().optional(),
-  title: z.string().optional(),
-})
+export const SLACK_PROVIDER_MEMBER_PROFILE_SCHEMA = z
+  .object({
+    display_name: z.string().nullable().optional(),
+    email: z.string().nullable().optional(),
+    first_name: z.string().nullable().optional(),
+    image_192: z.string().nullable().optional(),
+    image_512: z.string().nullable().optional(),
+    image_72: z.string().nullable().optional(),
+    last_name: z.string().nullable().optional(),
+    pronouns: z.string().nullable().optional(),
+    real_name: z.string().nullable().optional(),
+    status_emoji: z.string().nullable().optional(),
+    status_expiration: z.number().int().nonnegative().nullable().optional(),
+    status_text: z.string().nullable().optional(),
+    title: z.string().nullable().optional(),
+  })
+  .catchall(z.json())
 
-export const SLACK_PROVIDER_MEMBER_SCHEMA = z.looseObject({
-  deleted: z.boolean().optional(),
-  id: z.string(),
-  is_admin: z.boolean().optional(),
-  is_app_user: z.boolean().optional(),
-  is_bot: z.boolean().optional(),
-  is_owner: z.boolean().optional(),
-  is_restricted: z.boolean().optional(),
-  is_ultra_restricted: z.boolean().optional(),
-  name: z.string().optional(),
-  profile: SLACK_PROVIDER_MEMBER_PROFILE_SCHEMA.prefault({}),
-  team_id: z.string().optional(),
-  tz: z.string().optional(),
-  tz_label: z.string().optional(),
-  tz_offset: z.number().int().optional(),
-  updated: z.number().int().nonnegative().optional(),
-})
+export const SLACK_PROVIDER_MEMBER_SCHEMA = z
+  .object({
+    deleted: z.boolean().nullable().optional(),
+    id: z.string(),
+    is_admin: z.boolean().nullable().optional(),
+    is_app_user: z.boolean().nullable().optional(),
+    is_bot: z.boolean().nullable().optional(),
+    is_owner: z.boolean().nullable().optional(),
+    is_restricted: z.boolean().nullable().optional(),
+    is_ultra_restricted: z.boolean().nullable().optional(),
+    name: z.string().nullable().optional(),
+    profile: SLACK_PROVIDER_MEMBER_PROFILE_SCHEMA.nullish().transform(
+      (profile) => profile ?? {},
+    ),
+    team_id: z.string().nullable().optional(),
+    tz: z.string().nullable().optional(),
+    tz_label: z.string().nullable().optional(),
+    tz_offset: z.number().int().nullable().optional(),
+    updated: z.number().int().nonnegative().nullable().optional(),
+  })
+  .catchall(z.json())
 
 export const SLACK_PROVIDER_REACTION_SCHEMA = z.object({
   count: z.number().int().nonnegative(),
@@ -433,7 +419,7 @@ export const SLACK_PROVIDER_MESSAGE_SCHEMA = z
     reactions: SLACK_PROVIDER_REACTION_SCHEMA.array().optional(),
     reply_count: z.number().int().nonnegative().optional(),
     subtype: z.string().optional(),
-    text: z.string().prefault(""),
+    text: z.string().optional(),
     thread_ts: z.string().optional(),
     ts: z.string(),
     type: z.string().prefault("message"),
@@ -441,80 +427,13 @@ export const SLACK_PROVIDER_MESSAGE_SCHEMA = z
   })
   .catchall(z.json())
 
-const SLACK_PROVIDER_MESSAGE_EVENT_SCHEMA =
-  SLACK_PROVIDER_MESSAGE_SCHEMA.extend({
-    channel: z.string(),
-    channel_type: z.string().optional(),
-    event_ts: z.string(),
-  })
-
-export const SLACK_MESSAGE_EVENT_SCHEMA = SLACK_MESSAGE_SCHEMA.extend({
-  /** Slack conversation containing the message. */
-  conversationId: z.string(),
-
-  /** Provider conversation category such as `channel`, `group`, or `im`. */
-  conversationType: z.string().optional(),
-
-  /** Original provider event. */
-  event: SLACK_PROVIDER_MESSAGE_EVENT_SCHEMA,
-
-  /** Slack timestamp identifying when the event occurred. */
-  eventTimestamp: z.string(),
-
-  /** Slack workspace in which the event occurred. */
-  workspaceId: z.string(),
-})
-
-export const SLACK_APP_MENTION_EVENT_SCHEMA = SLACK_MESSAGE_EVENT_SCHEMA.extend(
-  {
-    event: SLACK_PROVIDER_MESSAGE_EVENT_SCHEMA.extend({
-      type: z.literal("app_mention"),
-    }),
-    type: z.literal("app_mention"),
-  },
-)
-
-export const SLACK_MESSAGE_POSTED_EVENT_SCHEMA =
-  SLACK_MESSAGE_EVENT_SCHEMA.extend({
-    event: SLACK_PROVIDER_MESSAGE_EVENT_SCHEMA.extend({
-      type: z.literal("message"),
-    }),
-    type: z.literal("message"),
-  })
-
-const SLACK_PROVIDER_REACTION_ITEM_SCHEMA = z.discriminatedUnion("type", [
-  z.looseObject({
-    channel: z.string(),
-    channel_type: z.string().optional(),
-    ts: z.string(),
-    type: z.literal("message"),
-  }),
-  z.looseObject({
-    file: z.string(),
-    type: z.literal("file"),
-  }),
-  z.looseObject({
-    file: z.string(),
-    file_comment: z.string(),
-    type: z.literal("file_comment"),
-  }),
-])
-
-const SLACK_PROVIDER_REACTION_EVENT_SCHEMA = z.looseObject({
-  event_ts: z.string(),
-  item: SLACK_PROVIDER_REACTION_ITEM_SCHEMA,
-  item_user: z.string().optional(),
-  reaction: z.string(),
-  user: z.string(),
-})
-
 export const SLACK_PROVIDER_FILE_SCHEMA = z.looseObject({
   channels: z.string().array().optional(),
   created: z.number().int().nonnegative().optional(),
   filetype: z.string().optional(),
   id: z.string(),
   mimetype: z.string().optional(),
-  name: z.string().optional(),
+  name: z.string().nullable().optional(),
   permalink: z.string().optional(),
   size: z.number().int().nonnegative().optional(),
   title: z.string().optional(),
@@ -589,35 +508,35 @@ export function toSlackMember(
   member: z.output<typeof SLACK_PROVIDER_MEMBER_SCHEMA>,
 ) {
   return {
-    deleted: member.deleted,
+    deleted: member.deleted ?? undefined,
     id: member.id,
-    isAdmin: member.is_admin,
-    isAppUser: member.is_app_user,
-    isBot: member.is_bot,
-    isOwner: member.is_owner,
-    isRestricted: member.is_restricted,
-    isUltraRestricted: member.is_ultra_restricted,
-    name: member.name,
+    isAdmin: member.is_admin ?? undefined,
+    isAppUser: member.is_app_user ?? undefined,
+    isBot: member.is_bot ?? undefined,
+    isOwner: member.is_owner ?? undefined,
+    isRestricted: member.is_restricted ?? undefined,
+    isUltraRestricted: member.is_ultra_restricted ?? undefined,
+    name: member.name ?? undefined,
     profile: {
-      displayName: member.profile.display_name,
-      email: member.profile.email,
-      firstName: member.profile.first_name,
-      image192: member.profile.image_192,
-      image512: member.profile.image_512,
-      image72: member.profile.image_72,
-      lastName: member.profile.last_name,
-      pronouns: member.profile.pronouns,
-      realName: member.profile.real_name,
-      statusEmoji: member.profile.status_emoji,
-      statusExpiration: member.profile.status_expiration,
-      statusText: member.profile.status_text,
-      title: member.profile.title,
+      displayName: member.profile.display_name ?? undefined,
+      email: member.profile.email ?? undefined,
+      firstName: member.profile.first_name ?? undefined,
+      image192: member.profile.image_192 ?? undefined,
+      image512: member.profile.image_512 ?? undefined,
+      image72: member.profile.image_72 ?? undefined,
+      lastName: member.profile.last_name ?? undefined,
+      pronouns: member.profile.pronouns ?? undefined,
+      realName: member.profile.real_name ?? undefined,
+      statusEmoji: member.profile.status_emoji ?? undefined,
+      statusExpiration: member.profile.status_expiration ?? undefined,
+      statusText: member.profile.status_text ?? undefined,
+      title: member.profile.title ?? undefined,
     },
-    timeZone: member.tz,
-    timeZoneLabel: member.tz_label,
-    timeZoneOffset: member.tz_offset,
-    updatedAt: member.updated,
-    workspaceId: member.team_id,
+    timeZone: member.tz ?? undefined,
+    timeZoneLabel: member.tz_label ?? undefined,
+    timeZoneOffset: member.tz_offset ?? undefined,
+    updatedAt: member.updated ?? undefined,
+    workspaceId: member.team_id ?? undefined,
   }
 }
 
@@ -651,70 +570,6 @@ export function toSlackMessage(
   }
 }
 
-/**
- * Normalizes a message-shaped Slack Events API payload.
- *
- * @param event - Provider-native inner event.
- * @param workspaceId - Slack workspace from the outer event envelope.
- */
-export function normalizeSlackMessageEvent(
-  event: unknown,
-  workspaceId: string,
-) {
-  const parsedEvent = SLACK_PROVIDER_MESSAGE_EVENT_SCHEMA.parse(event)
-
-  return SLACK_MESSAGE_EVENT_SCHEMA.parse({
-    ...toSlackMessage(parsedEvent),
-    conversationId: parsedEvent.channel,
-    conversationType: parsedEvent.channel_type,
-    event: parsedEvent,
-    eventTimestamp: parsedEvent.event_ts,
-    workspaceId,
-  })
-}
-
-/**
- * Normalizes a reaction-shaped Slack Events API payload.
- *
- * @param event - Provider-native inner event.
- * @param workspaceId - Slack workspace from the outer event envelope.
- */
-export function normalizeSlackReactionEvent(
-  event: unknown,
-  workspaceId: string,
-) {
-  const parsedEvent = SLACK_PROVIDER_REACTION_EVENT_SCHEMA.parse(event)
-  // Keep the discriminated provider-to-public item mapping readable as a unit.
-  const item = (() => {
-    switch (parsedEvent.item.type) {
-      case "message":
-        return {
-          conversationId: parsedEvent.item.channel,
-          conversationType: parsedEvent.item.channel_type,
-          messageTimestamp: parsedEvent.item.ts,
-          type: "message" as const,
-        }
-      case "file":
-        return { fileId: parsedEvent.item.file, type: "file" as const }
-      case "file_comment":
-        return {
-          fileCommentId: parsedEvent.item.file_comment,
-          fileId: parsedEvent.item.file,
-          type: "fileComment" as const,
-        }
-    }
-  })()
-
-  return SLACK_REACTION_EVENT_SCHEMA.parse({
-    eventTimestamp: parsedEvent.event_ts,
-    item,
-    itemUserId: parsedEvent.item_user,
-    reaction: parsedEvent.reaction,
-    userId: parsedEvent.user,
-    workspaceId,
-  })
-}
-
 /**
  * Normalizes a Slack file.
  *