@automate.ax/integration-contracts 0.88.9 → 0.89.0

package/dist/notion/schemas.js

@@ -0,0 +1,185 @@
+import * as z from "zod";
+const UUID_SCHEMA = z.uuid();
+const ACCESS_ACTOR_SCHEMA = z.discriminatedUnion("type", [
+    z.object({ id: UUID_SCHEMA, type: z.literal("person") }),
+    z.object({ id: UUID_SCHEMA, type: z.literal("bot") }),
+]);
+const AUTHOR_SCHEMA = z.discriminatedUnion("type", [
+    ...ACCESS_ACTOR_SCHEMA.options,
+    z.object({ id: UUID_SCHEMA, type: z.literal("agent") }),
+]);
+const BASE_SHAPE = {
+    accessible_by: ACCESS_ACTOR_SCHEMA.array().optional(),
+    api_version: z.enum(["2022-06-28", "2025-09-03", "2026-03-11"]),
+    attempt_number: z.number().int().min(1).max(8),
+    authors: AUTHOR_SCHEMA.array(),
+    id: UUID_SCHEMA,
+    integration_id: UUID_SCHEMA,
+    subscription_id: UUID_SCHEMA,
+    timestamp: z.iso.datetime({ offset: true }),
+    workspace_id: UUID_SCHEMA,
+    workspace_name: z.string(),
+};
+const PARENT_SCHEMA = z.object({
+    data_source_id: UUID_SCHEMA.optional(),
+    id: UUID_SCHEMA,
+    type: z.enum(["space", "block", "page", "database", "team", "agent"]),
+});
+const EXTERNAL_BLOCK_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.enum(["page", "database", "block"]),
+});
+const UPDATED_BLOCK_SCHEMA = EXTERNAL_BLOCK_SCHEMA;
+const PAGE_ENTITY_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.literal("page"),
+});
+const DATABASE_ENTITY_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.enum(["block", "database", "data_source"]),
+});
+const COMMENT_ENTITY_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.literal("comment"),
+});
+const FILE_UPLOAD_ENTITY_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.literal("file_upload"),
+});
+const VIEW_ENTITY_SCHEMA = z.object({
+    id: UUID_SCHEMA,
+    type: z.literal("view"),
+});
+const PARENT_DATA_SCHEMA = z.object({ parent: PARENT_SCHEMA });
+const COMMENT_DATA_SCHEMA = z.object({
+    page_id: UUID_SCHEMA,
+    parent: EXTERNAL_BLOCK_SCHEMA,
+});
+const RAW_NOTION_EVENT_SCHEMA = z.discriminatedUnion("type", [
+    eventWithDataSchema("comment.created", COMMENT_ENTITY_SCHEMA, COMMENT_DATA_SCHEMA),
+    eventWithDataSchema("comment.deleted", COMMENT_ENTITY_SCHEMA, COMMENT_DATA_SCHEMA),
+    eventWithDataSchema("comment.updated", COMMENT_ENTITY_SCHEMA, COMMENT_DATA_SCHEMA),
+    eventWithDataSchema("data_source.content_updated", DATABASE_ENTITY_SCHEMA, z.object({
+        parent: PARENT_SCHEMA,
+        updated_blocks: UPDATED_BLOCK_SCHEMA.array(),
+    })),
+    eventWithDataSchema("data_source.created", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("data_source.deleted", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("data_source.moved", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("data_source.schema_updated", DATABASE_ENTITY_SCHEMA, z.object({
+        parent: PARENT_SCHEMA,
+        updated_properties: z
+            .object({
+            action: z.enum(["created", "updated", "deleted"]),
+            id: z.string(),
+            name: z.string().nullable(),
+        })
+            .array()
+            .optional(),
+    })),
+    eventWithDataSchema("data_source.undeleted", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("database.created", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("database.deleted", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("database.moved", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("database.undeleted", DATABASE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventSchema("file_upload.completed", FILE_UPLOAD_ENTITY_SCHEMA),
+    eventSchema("file_upload.created", FILE_UPLOAD_ENTITY_SCHEMA),
+    eventSchema("file_upload.expired", FILE_UPLOAD_ENTITY_SCHEMA),
+    eventWithDataSchema("file_upload.upload_failed", FILE_UPLOAD_ENTITY_SCHEMA, z.object({
+        file_import_result: z.discriminatedUnion("type", [
+            z.object({
+                imported_time: z.iso.datetime({ offset: true }),
+                success: z.object({}),
+                type: z.literal("success"),
+            }),
+            z.object({
+                error: z.object({
+                    code: z.string(),
+                    message: z.string(),
+                    parameter: z.string().nullable(),
+                    status_code: z.number().nullable(),
+                    type: z.enum([
+                        "validation_error",
+                        "internal_system_error",
+                        "download_error",
+                        "upload_error",
+                    ]),
+                }),
+                imported_time: z.iso.datetime({ offset: true }),
+                type: z.literal("error"),
+            }),
+        ]),
+    })),
+    eventWithDataSchema("page.content_updated", PAGE_ENTITY_SCHEMA, z.object({
+        parent: PARENT_SCHEMA,
+        updated_blocks: UPDATED_BLOCK_SCHEMA.array(),
+    })),
+    eventWithDataSchema("page.created", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("page.deleted", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("page.locked", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("page.moved", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("page.properties_updated", PAGE_ENTITY_SCHEMA, z.object({
+        parent: PARENT_SCHEMA,
+        updated_properties: z.string().array(),
+    })),
+    eventWithDataSchema("page.transcription_block.transcript_deleted", PAGE_ENTITY_SCHEMA, z.object({
+        target: EXTERNAL_BLOCK_SCHEMA,
+        transcript_id: z.string().nullable(),
+    })),
+    eventWithDataSchema("page.undeleted", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("page.unlocked", PAGE_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("view.created", VIEW_ENTITY_SCHEMA, z.object({ parent: PARENT_SCHEMA, view_type: z.string() })),
+    eventWithDataSchema("view.deleted", VIEW_ENTITY_SCHEMA, PARENT_DATA_SCHEMA),
+    eventWithDataSchema("view.updated", VIEW_ENTITY_SCHEMA, z.object({
+        parent: PARENT_SCHEMA,
+        updated_fields: z
+            .enum(["name", "filter", "sorts", "configuration"])
+            .array(),
+    })),
+]);
+/** Exact current Notion webhook schema shared by ingress and triggers. */
+export const NOTION_EVENT_SCHEMA = RAW_NOTION_EVENT_SCHEMA;
+/**
+ * Runtime schema for one semantic Notion webhook event.
+ *
+ * @param type - Official event discriminant to require.
+ */
+export function notionSemanticEventSchema(type) {
+    return z.custom((value) => RAW_NOTION_EVENT_SCHEMA.safeParse(value).success &&
+        typeof value === "object" &&
+        value !== null &&
+        "type" in value &&
+        value.type === type, { message: `Expected a Notion ${type} webhook event.` });
+}
+/**
+ * Builds one provider webhook schema over the shared delivery envelope.
+ *
+ * @param type - Official event discriminant.
+ * @param entity - Entity reference schema for the event family.
+ */
+function eventSchema(type, entity) {
+    return z
+        .object({
+        ...BASE_SHAPE,
+        entity,
+        type: z.literal(type),
+    })
+        .catchall(z.json());
+}
+/**
+ * Builds one provider webhook schema with event-specific data.
+ *
+ * @param type - Official event discriminant.
+ * @param entity - Entity reference schema for the event family.
+ * @param data - Event-specific data schema.
+ */
+function eventWithDataSchema(type, entity, data) {
+    return z
+        .object({
+        ...BASE_SHAPE,
+        data,
+        entity,
+        type: z.literal(type),
+    })
+        .catchall(z.json());
+}

package/dist/triggers.d.ts

@@ -9,6 +9,7 @@ import type { googleCalendarTriggerContracts } from "./google-calendar/index.js"
 import type { googleFormsTriggerContracts } from "./google-forms/index.js";
 import type { googleMeetTriggerContracts } from "./google-meet/index.js";
 import type { linearTriggerContracts } from "./linear/index.js";
+import type { notionTriggerContracts } from "./notion/index.js";
 import type { outlookTriggerContracts } from "./outlook/index.js";
 import type { resendTriggerContracts } from "./resend/index.js";
 import type { slackTriggerContracts } from "./slack/index.js";
@@ -19,7 +20,7 @@ import type { vercelTriggerContracts } from "./vercel/index.js";
 import type { webflowTriggerContracts } from "./webflow/index.js";
 import type { whatsappTriggerContracts } from "./whatsapp/index.js";
 import type { z } from "zod";
-export type TriggerContractMap = typeof airtableTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof closeTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof linearTriggerContracts & typeof outlookTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof trelloTriggerContracts & typeof vercelTriggerContracts & typeof webflowTriggerContracts & typeof whatsappTriggerContracts;
+export type TriggerContractMap = typeof airtableTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof closeTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof linearTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof trelloTriggerContracts & typeof vercelTriggerContracts & typeof webflowTriggerContracts & typeof whatsappTriggerContracts;
 export type IntegrationTriggerType = keyof TriggerContractMap;
 /** Canonical authoring configuration for one integration trigger type. */
 export type TriggerConfig<TType extends IntegrationTriggerType> = z.input<TriggerContractMap[TType]["configSchema"]> extends Record<string, never> ? object : z.input<TriggerContractMap[TType]["configSchema"]>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.88.9",
+  "version": "0.89.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -29,6 +29,7 @@
       "./google-meet": "./src/google-meet/index.ts",
       "./github": "./src/github/index.ts",
       "./linear": "./src/linear/index.ts",
+      "./notion": "./src/notion/index.ts",
       "./outlook": "./src/outlook/index.ts",
       "./resend": "./src/resend/index.ts",
       "./slack": "./src/slack/index.ts",
@@ -46,12 +47,13 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.88.9",
+    "@automate.ax/codec": "0.89.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",
     "@googleapis/gmail": "^12.0.0",
     "@googleapis/meet": "^5.0.0",
+    "@notionhq/client": "5.26.0",
     "@octokit/openapi-webhooks-types": "^12.1.0",
     "@octokit/rest": "^22.0.1",
     "convex": "^1.45.0",
@@ -151,6 +153,11 @@
       "types": "./dist/linear/index.d.ts",
       "default": "./dist/linear/index.js"
     },
+    "./notion": {
+      "bun": "./src/notion/index.ts",
+      "types": "./dist/notion/index.d.ts",
+      "default": "./dist/notion/index.js"
+    },
     "./outlook": {
       "bun": "./src/outlook/index.ts",
       "types": "./dist/outlook/index.d.ts",

package/src/notion/index.ts

@@ -0,0 +1,179 @@
+import * as z from "zod"
+import {
+  NOTION_EVENT_SCHEMA,
+  notionSemanticEventSchema,
+  type NotionSemanticWebhookEvent,
+  type NotionWebhookEvent,
+  type NotionWebhookEventType,
+} from "./schemas"
+
+export * from "./schemas"
+
+export const NOTION_TRIGGER_CONFIG_SCHEMA = z.object({})
+
+export const NOTION_WEBHOOK_EVENT_TYPES = [
+  "comment.created",
+  "comment.deleted",
+  "comment.updated",
+  "data_source.content_updated",
+  "data_source.created",
+  "data_source.deleted",
+  "data_source.moved",
+  "data_source.schema_updated",
+  "data_source.undeleted",
+  "database.created",
+  "database.deleted",
+  "database.moved",
+  "database.undeleted",
+  "file_upload.completed",
+  "file_upload.created",
+  "file_upload.expired",
+  "file_upload.upload_failed",
+  "page.content_updated",
+  "page.created",
+  "page.deleted",
+  "page.locked",
+  "page.moved",
+  "page.properties_updated",
+  "page.transcription_block.transcript_deleted",
+  "page.undeleted",
+  "page.unlocked",
+  "view.created",
+  "view.deleted",
+  "view.updated",
+] as const satisfies readonly NotionWebhookEventType[]
+
+type NotionTriggerContract<TEvent> = {
+  readonly configSchema: typeof NOTION_TRIGGER_CONFIG_SCHEMA
+  readonly eventSchema: z.ZodType<TEvent>
+}
+
+type NotionSemanticTriggerTypes = {
+  readonly "notion.comment.created": "comment.created"
+  readonly "notion.comment.deleted": "comment.deleted"
+  readonly "notion.comment.updated": "comment.updated"
+  readonly "notion.database.created": "database.created"
+  readonly "notion.database.deleted": "database.deleted"
+  readonly "notion.database.moved": "database.moved"
+  readonly "notion.database.undeleted": "database.undeleted"
+  readonly "notion.dataSource.contentUpdated": "data_source.content_updated"
+  readonly "notion.dataSource.created": "data_source.created"
+  readonly "notion.dataSource.deleted": "data_source.deleted"
+  readonly "notion.dataSource.moved": "data_source.moved"
+  readonly "notion.dataSource.schemaUpdated": "data_source.schema_updated"
+  readonly "notion.dataSource.undeleted": "data_source.undeleted"
+  readonly "notion.fileUpload.completed": "file_upload.completed"
+  readonly "notion.fileUpload.created": "file_upload.created"
+  readonly "notion.fileUpload.expired": "file_upload.expired"
+  readonly "notion.fileUpload.failed": "file_upload.upload_failed"
+  readonly "notion.page.contentUpdated": "page.content_updated"
+  readonly "notion.page.created": "page.created"
+  readonly "notion.page.deleted": "page.deleted"
+  readonly "notion.page.locked": "page.locked"
+  readonly "notion.page.moved": "page.moved"
+  readonly "notion.page.propertiesUpdated": "page.properties_updated"
+  readonly "notion.page.transcriptDeleted": "page.transcription_block.transcript_deleted"
+  readonly "notion.page.undeleted": "page.undeleted"
+  readonly "notion.page.unlocked": "page.unlocked"
+  readonly "notion.view.created": "view.created"
+  readonly "notion.view.deleted": "view.deleted"
+  readonly "notion.view.updated": "view.updated"
+}
+
+type NotionTriggerContracts = {
+  readonly [TTrigger in keyof NotionSemanticTriggerTypes]: NotionTriggerContract<
+    NotionSemanticWebhookEvent<NotionSemanticTriggerTypes[TTrigger]>
+  >
+} & {
+  readonly "notion.event": NotionTriggerContract<NotionWebhookEvent>
+}
+
+export const notionEventTypeMap = {
+  "comment.created": "notion.comment.created",
+  "comment.deleted": "notion.comment.deleted",
+  "comment.updated": "notion.comment.updated",
+  "data_source.content_updated": "notion.dataSource.contentUpdated",
+  "data_source.created": "notion.dataSource.created",
+  "data_source.deleted": "notion.dataSource.deleted",
+  "data_source.moved": "notion.dataSource.moved",
+  "data_source.schema_updated": "notion.dataSource.schemaUpdated",
+  "data_source.undeleted": "notion.dataSource.undeleted",
+  "database.created": "notion.database.created",
+  "database.deleted": "notion.database.deleted",
+  "database.moved": "notion.database.moved",
+  "database.undeleted": "notion.database.undeleted",
+  "file_upload.completed": "notion.fileUpload.completed",
+  "file_upload.created": "notion.fileUpload.created",
+  "file_upload.expired": "notion.fileUpload.expired",
+  "file_upload.upload_failed": "notion.fileUpload.failed",
+  "page.content_updated": "notion.page.contentUpdated",
+  "page.created": "notion.page.created",
+  "page.deleted": "notion.page.deleted",
+  "page.locked": "notion.page.locked",
+  "page.moved": "notion.page.moved",
+  "page.properties_updated": "notion.page.propertiesUpdated",
+  "page.transcription_block.transcript_deleted":
+    "notion.page.transcriptDeleted",
+  "page.undeleted": "notion.page.undeleted",
+  "page.unlocked": "notion.page.unlocked",
+  "view.created": "notion.view.created",
+  "view.deleted": "notion.view.deleted",
+  "view.updated": "notion.view.updated",
+} as const satisfies Record<
+  NotionWebhookEventType,
+  keyof NotionTriggerContracts
+>
+
+export const notionTriggerContracts: NotionTriggerContracts = {
+  "notion.comment.created": semanticContract("comment.created"),
+  "notion.comment.deleted": semanticContract("comment.deleted"),
+  "notion.comment.updated": semanticContract("comment.updated"),
+  "notion.database.created": semanticContract("database.created"),
+  "notion.database.deleted": semanticContract("database.deleted"),
+  "notion.database.moved": semanticContract("database.moved"),
+  "notion.database.undeleted": semanticContract("database.undeleted"),
+  "notion.dataSource.contentUpdated": semanticContract(
+    "data_source.content_updated",
+  ),
+  "notion.dataSource.created": semanticContract("data_source.created"),
+  "notion.dataSource.deleted": semanticContract("data_source.deleted"),
+  "notion.dataSource.moved": semanticContract("data_source.moved"),
+  "notion.dataSource.schemaUpdated": semanticContract(
+    "data_source.schema_updated",
+  ),
+  "notion.dataSource.undeleted": semanticContract("data_source.undeleted"),
+  "notion.event": {
+    configSchema: NOTION_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: NOTION_EVENT_SCHEMA,
+  },
+  "notion.fileUpload.completed": semanticContract("file_upload.completed"),
+  "notion.fileUpload.created": semanticContract("file_upload.created"),
+  "notion.fileUpload.expired": semanticContract("file_upload.expired"),
+  "notion.fileUpload.failed": semanticContract("file_upload.upload_failed"),
+  "notion.page.contentUpdated": semanticContract("page.content_updated"),
+  "notion.page.created": semanticContract("page.created"),
+  "notion.page.deleted": semanticContract("page.deleted"),
+  "notion.page.locked": semanticContract("page.locked"),
+  "notion.page.moved": semanticContract("page.moved"),
+  "notion.page.propertiesUpdated": semanticContract("page.properties_updated"),
+  "notion.page.transcriptDeleted": semanticContract(
+    "page.transcription_block.transcript_deleted",
+  ),
+  "notion.page.undeleted": semanticContract("page.undeleted"),
+  "notion.page.unlocked": semanticContract("page.unlocked"),
+  "notion.view.created": semanticContract("view.created"),
+  "notion.view.deleted": semanticContract("view.deleted"),
+  "notion.view.updated": semanticContract("view.updated"),
+}
+
+/**
+ * Creates one semantic trigger contract from an official webhook type.
+ *
+ * @param type - Official Notion webhook event type.
+ */
+function semanticContract<TType extends NotionWebhookEventType>(type: TType) {
+  return {
+    configSchema: NOTION_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: notionSemanticEventSchema(type),
+  }
+}