@automate.ax/integration-contracts 0.88.10 → 0.89.2

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.10",
+  "version": "0.89.2",
   "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.10",
+    "@automate.ax/codec": "0.89.2",
     "@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/github/additional-events.ts

@@ -350,12 +350,15 @@ export type GitHubWorkflowDispatchEvent =
 export type GitHubDeploymentEvent = GitHubWebhookPayload<"deployment-created">
 
 /** GitHub deployment-status webhook payload. */
+type GitHubDeploymentStatusProviderEvent =
+  GitHubWebhookPayload<"deployment-status-created">
 export type GitHubDeploymentStatusEvent =
-  GitHubWebhookPayload<"deployment-status-created"> & {
-    deployment_status: GitHubWebhookPayload<"deployment-status-created">["deployment_status"] & {
+  GitHubDeploymentStatusProviderEvent & {
+    deployment_status: GitHubDeploymentStatusProviderEvent["deployment_status"] & {
       state:
         | "error"
         | "failure"
+        | "inactive"
         | "in_progress"
         | "pending"
         | "queued"
@@ -972,7 +975,24 @@ export const GITHUB_WORKFLOW_DISPATCH_EVENT_SCHEMA: GitHubWebhookSchema<GitHubWo
 export const GITHUB_DEPLOYMENT_EVENT_SCHEMA: GitHubWebhookSchema<GitHubDeploymentEvent> =
   githubWebhookEventSchema<GitHubDeploymentEvent>("deployment")
 export const GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA: GitHubWebhookSchema<GitHubDeploymentStatusEvent> =
-  githubWebhookEventSchema<GitHubDeploymentStatusEvent>("deployment_status")
+  githubSemanticEventSchema<
+    GitHubDeploymentStatusProviderEvent,
+    GitHubDeploymentStatusEvent
+  >(
+    githubWebhookEventSchema<GitHubDeploymentStatusProviderEvent>(
+      "deployment_status",
+    ),
+    (event) =>
+      [
+        "error",
+        "failure",
+        "inactive",
+        "in_progress",
+        "pending",
+        "queued",
+        "success",
+      ].includes(event.deployment_status.state),
+  )
 export const GITHUB_DEPLOYMENT_QUEUED_EVENT_SCHEMA: GitHubWebhookSchema<GitHubDeploymentQueuedEvent> =
   githubSemanticEventSchema<
     GitHubDeploymentStatusEvent,