@automate.ax/integration-contracts 0.103.2 → 0.105.0

package/dist/slack/schemas.d.ts

@@ -110,8 +110,8 @@ export declare const SLACK_REACTION_ITEM_SCHEMA: z.ZodDiscriminatedUnion<[z.ZodO
     conversationId: z.ZodString;
     conversationType: z.ZodOptional<z.ZodEnum<{
         group: "group";
-        channel: "channel";
         im: "im";
+        channel: "channel";
         mpim: "mpim";
     }>>;
     messageTimestamp: z.ZodString;

package/dist/teams/schemas.d.ts

@@ -134,10 +134,10 @@ export declare const GRAPH_MEMBER_SCHEMA: z.ZodPipe<z.ZodObject<{
 }>>;
 export declare const TEAMS_CHAT_SCHEMA: z.ZodObject<{
     chatType: z.ZodEnum<{
+        meeting: "meeting";
         group: "group";
         unknownFutureValue: "unknownFutureValue";
         oneOnOne: "oneOnOne";
-        meeting: "meeting";
     }>;
     createdAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
     chatId: z.ZodString;
@@ -148,10 +148,10 @@ export declare const TEAMS_CHAT_SCHEMA: z.ZodObject<{
 }, z.core.$strip>;
 export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     chatType: z.ZodEnum<{
+        meeting: "meeting";
         group: "group";
         unknownFutureValue: "unknownFutureValue";
         oneOnOne: "oneOnOne";
-        meeting: "meeting";
     }>;
     createdDateTime: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     id: z.ZodString;
@@ -160,7 +160,7 @@ export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     webUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>, z.ZodTransform<{
-    chatType: "group" | "unknownFutureValue" | "oneOnOne" | "meeting";
+    chatType: "meeting" | "group" | "unknownFutureValue" | "oneOnOne";
     createdAt: Date | undefined;
     chatId: string;
     updatedAt: Date | undefined;
@@ -169,7 +169,7 @@ export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     webUrl: string | undefined;
 }, {
     [x: string]: unknown;
-    chatType: "group" | "unknownFutureValue" | "oneOnOne" | "meeting";
+    chatType: "meeting" | "group" | "unknownFutureValue" | "oneOnOne";
     id: string;
     createdDateTime?: string | null | undefined;
     lastUpdatedDateTime?: string | null | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.103.2",
+  "version": "0.105.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -49,7 +49,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.103.2",
+    "@automate.ax/codec": "0.105.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",

package/src/close/events.ts

@@ -10,6 +10,7 @@ import {
   CLOSE_MEETING_SCHEMA,
   CLOSE_OPPORTUNITY_SCHEMA,
   CLOSE_SEQUENCE_SUBSCRIPTION_SCHEMA,
+  CLOSE_SMART_VIEW_SCHEMA,
   CLOSE_SMS_SCHEMA,
   CLOSE_TASK_SCHEMA,
 } from "./schemas"
@@ -228,6 +229,13 @@ export const CLOSE_WEBHOOK_PAYLOAD_SCHEMA = z.object({
 })
 
 export const CLOSE_TRIGGER_CONFIG_SCHEMA = z.object({})
+export const CLOSE_SMART_VIEW_MEMBERSHIP_TRIGGER_CONFIG_SCHEMA = z.object({
+  smartViewId: z.string().startsWith("save_"),
+})
+export const CLOSE_SMART_VIEW_MEMBERSHIP_EVENT_SCHEMA = z.object({
+  leadId: z.string().startsWith("lead_"),
+  smartViewId: z.string().startsWith("save_"),
+})
 
 // Event snapshots can omit fields that are required by the current REST
 // resource. Close's documented opportunity-won webhook is one such payload.
@@ -244,6 +252,7 @@ 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_SMART_VIEW_EVENT_DATA_SCHEMA = CLOSE_SMART_VIEW_SCHEMA.partial()
 const CLOSE_SMS_EVENT_DATA_SCHEMA = CLOSE_SMS_SCHEMA.partial()
 const CLOSE_DELETED_EVENT_DATA_SCHEMA = z.union([
   z.null(),
@@ -388,6 +397,16 @@ const SEMANTIC_EVENTS = {
     "updated",
     CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
   ],
+  "close.smartView.created": [
+    "saved_search",
+    "created",
+    CLOSE_SMART_VIEW_EVENT_DATA_SCHEMA,
+  ],
+  "close.smartView.updated": [
+    "saved_search",
+    "updated",
+    CLOSE_SMART_VIEW_EVENT_DATA_SCHEMA,
+  ],
   "close.sms.received": [
     "activity.sms",
     "created",
@@ -432,6 +451,8 @@ export const CLOSE_SEMANTIC_EVENT_TYPES = [
   "close.sequenceSubscription.paused",
   "close.sequenceSubscription.resumed",
   "close.sequenceSubscription.updated",
+  "close.smartView.created",
+  "close.smartView.updated",
   "close.sms.received",
   "close.sms.sent",
   "close.task.completed",
@@ -440,6 +461,11 @@ export const CLOSE_SEMANTIC_EVENT_TYPES = [
   "close.task.updated",
 ] as const satisfies readonly (keyof typeof SEMANTIC_EVENTS)[]
 
+export const CLOSE_SMART_VIEW_MEMBERSHIP_EVENT_TYPES = [
+  "close.smartView.leadEntered",
+  "close.smartView.leadExited",
+] as const
+
 export const closeTriggerContracts = {
   "close.event": {
     configSchema: CLOSE_TRIGGER_CONFIG_SCHEMA,
@@ -600,6 +626,24 @@ export const closeTriggerContracts = {
     "updated",
     CLOSE_SEQUENCE_SUBSCRIPTION_EVENT_DATA_SCHEMA,
   ),
+  "close.smartView.created": semanticContract(
+    "saved_search",
+    "created",
+    CLOSE_SMART_VIEW_EVENT_DATA_SCHEMA,
+  ),
+  "close.smartView.updated": semanticContract(
+    "saved_search",
+    "updated",
+    CLOSE_SMART_VIEW_EVENT_DATA_SCHEMA,
+  ),
+  "close.smartView.leadEntered": {
+    configSchema: CLOSE_SMART_VIEW_MEMBERSHIP_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLOSE_SMART_VIEW_MEMBERSHIP_EVENT_SCHEMA,
+  },
+  "close.smartView.leadExited": {
+    configSchema: CLOSE_SMART_VIEW_MEMBERSHIP_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLOSE_SMART_VIEW_MEMBERSHIP_EVENT_SCHEMA,
+  },
   "close.sms.received": semanticContract(
     "activity.sms",
     "created",
@@ -622,10 +666,7 @@ export const closeTriggerContracts = {
   "close.task.updated": taskContract("updated", CLOSE_TASK_EVENT_DATA_SCHEMA),
 } as const satisfies Record<
   string,
-  {
-    configSchema: typeof CLOSE_TRIGGER_CONFIG_SCHEMA
-    eventSchema: z.ZodType
-  }
+  { configSchema: z.ZodType; eventSchema: z.ZodType }
 >
 
 /**

package/src/close/schemas.ts

@@ -80,6 +80,50 @@ export const CLOSE_CONTACT_SCHEMA = z.object({
   urls: CLOSE_CONTACT_URL_SCHEMA.array().prefault([]),
 })
 
+export const CLOSE_SMART_VIEW_TYPE_SCHEMA = z.enum([
+  "lead",
+  "contact",
+  "opportunity",
+  "call",
+  "email",
+  "sms",
+  "meeting",
+  "note",
+  "whatsapp_message",
+  "custom_activity",
+  "form_submission",
+])
+
+export const CLOSE_SMART_VIEW_SHARING_SETTINGS_SCHEMA = z.object({
+  createdAt: DATE_SCHEMA.nullable(),
+  createdById: z.string().nullable(),
+  groupIds: z.string().array(),
+  updatedAt: DATE_SCHEMA.nullable(),
+  updatedById: z.string().nullable(),
+  userIds: z.string().array(),
+  wholeOrg: z.boolean(),
+})
+
+export const CLOSE_SMART_VIEW_SCHEMA = z.object({
+  createdAt: DATE_SCHEMA,
+  description: z.string().nullable(),
+  id: z.string(),
+  isShared: z.boolean(),
+  isUserDependent: z.boolean().nullable(),
+  name: z.string(),
+  organizationId: z.string(),
+  query: z.string().nullable(),
+  selectedFields: CLOSE_OBJECT_SCHEMA.array().nullable().optional(),
+  sharedWith: z.string().array().nullable().optional(),
+  sharingSettings:
+    CLOSE_SMART_VIEW_SHARING_SETTINGS_SCHEMA.nullable().optional(),
+  sQuery: CLOSE_OBJECT_SCHEMA.nullable(),
+  type: CLOSE_SMART_VIEW_TYPE_SCHEMA,
+  updatedAt: DATE_SCHEMA,
+  userId: z.string().nullable(),
+  usedRecently: z.boolean().optional(),
+})
+
 export const CLOSE_OPPORTUNITY_STATUS_TYPE_SCHEMA = z.enum([
   "active",
   "lost",

package/src/notion/index.ts

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import {
-  NOTION_EVENT_SCHEMA,
+  NOTION_PUBLIC_EVENT_SCHEMA,
   notionSemanticEventSchema,
   type NotionSemanticWebhookEvent,
   type NotionWebhookEvent,
@@ -144,7 +144,7 @@ export const notionTriggerContracts: NotionTriggerContracts = {
   "notion.dataSource.undeleted": semanticContract("data_source.undeleted"),
   "notion.event": {
     configSchema: NOTION_TRIGGER_CONFIG_SCHEMA,
-    eventSchema: NOTION_EVENT_SCHEMA,
+    eventSchema: NOTION_PUBLIC_EVENT_SCHEMA,
   },
   "notion.fileUpload.completed": semanticContract("file_upload.completed"),
   "notion.fileUpload.created": semanticContract("file_upload.created"),

package/src/notion/schemas.ts

@@ -29,6 +29,7 @@ import type {
   ViewDeletedWebhookPayload,
   ViewUpdatedWebhookPayload,
 } from "@notionhq/client"
+import type { CamelCasedPropertiesDeep } from "type-fest"
 import * as z from "zod"
 
 type OfficialNotionWebhookEvent =
@@ -294,15 +295,29 @@ const RAW_NOTION_EVENT_SCHEMA = z.discriminatedUnion("type", [
 ]) satisfies z.ZodType<ExpectedNotionWebhookEvent>
 
 /** Current portable Notion webhook payload validated at ingress. */
-export type NotionWebhookEvent = z.infer<typeof RAW_NOTION_EVENT_SCHEMA>
+type ProviderNotionWebhookEvent = z.infer<typeof RAW_NOTION_EVENT_SCHEMA>
 
-export type NotionWebhookEventType = NotionWebhookEvent["type"]
+/** Public camelCase representation of a Notion webhook payload. */
+export type NotionWebhookEvent =
+  CamelCasedPropertiesDeep<ExpectedNotionWebhookEvent>
+
+export type NotionWebhookEventType = ProviderNotionWebhookEvent["type"]
 
 export type NotionSemanticWebhookEvent<TType extends NotionWebhookEventType> =
   Extract<NotionWebhookEvent, { type: TType }>
 
 /** Exact current Notion webhook schema shared by ingress and triggers. */
-export const NOTION_EVENT_SCHEMA = RAW_NOTION_EVENT_SCHEMA
+export const NOTION_EVENT_SCHEMA =
+  RAW_NOTION_EVENT_SCHEMA.transform(camelCaseNotionEvent)
+
+/** Validates an already-normalized Notion webhook event for trigger delivery. */
+export const NOTION_PUBLIC_EVENT_SCHEMA = z.custom<NotionWebhookEvent>(
+  (value) =>
+    typeof value === "object" &&
+    value !== null &&
+    "type" in value &&
+    typeof value.type === "string",
+)
 
 /**
  * Runtime schema for one semantic Notion webhook event.
@@ -314,7 +329,7 @@ export function notionSemanticEventSchema<TType extends NotionWebhookEventType>(
 ) {
   return z.custom<NotionSemanticWebhookEvent<TType>>(
     (value) =>
-      RAW_NOTION_EVENT_SCHEMA.safeParse(value).success &&
+      NOTION_PUBLIC_EVENT_SCHEMA.safeParse(value).success &&
       typeof value === "object" &&
       value !== null &&
       "type" in value &&
@@ -323,6 +338,45 @@ export function notionSemanticEventSchema<TType extends NotionWebhookEventType>(
   )
 }
 
+/**
+ * Converts provider-native webhook fields before public trigger delivery.
+ *
+ * @param event - Validated provider webhook payload.
+ */
+function camelCaseNotionEvent(
+  event: ProviderNotionWebhookEvent,
+): NotionWebhookEvent {
+  // REVIEW: the recursive transform preserves the raw schema's JSON structure
+  // while changing only property names.
+  // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- Raw schema validation guarantees this result's shape.
+  return camelCaseNotionValue(event) as NotionWebhookEvent
+}
+
+/**
+ * Recursively camel-cases object property names in a JSON-compatible value.
+ *
+ * @param value - Provider-native JSON value.
+ */
+function camelCaseNotionValue(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(camelCaseNotionValue)
+  if (!isPlainRecord(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, nestedValue]) => [
+      key.replace(/_([a-z])/g, (_, letter: string) => letter.toUpperCase()),
+      camelCaseNotionValue(nestedValue),
+    ]),
+  )
+}
+
+/**
+ * Checks whether a value can have provider field names.
+ *
+ * @param value - Value to inspect.
+ */
+function isPlainRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null
+}
+
 /**
  * Builds one provider webhook schema over the shared delivery envelope.
  *