@automate.ax/integration-contracts 0.84.0 → 0.86.1

package/dist/triggers.d.ts

@@ -15,9 +15,10 @@ import type { stripeTriggerContracts } from "./stripe/index.js";
 import type { teamsTriggerContracts } from "./teams/index.js";
 import type { trelloTriggerContracts } from "./trello/index.js";
 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 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 whatsappTriggerContracts;
+export type TriggerContractMap = typeof airtableTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & 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 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/dist/webflow/index.d.ts

@@ -0,0 +1,49 @@
+import * as z from "zod";
+import type { WebflowEvent, WebflowSemanticEvent } from "./schemas.js";
+export * from "./schemas.js";
+/** Site selected for one Webflow webhook subscription. */
+export declare const WEBFLOW_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{
+    siteId: z.ZodString;
+}, z.core.$strip>;
+type WebflowTriggerContract<TEvent> = {
+    readonly configSchema: typeof WEBFLOW_TRIGGER_CONFIG_SCHEMA;
+    readonly eventSchema: z.ZodType<TEvent>;
+};
+type WebflowSemanticTriggerTypes = {
+    readonly "webflow.collectionItem.changed": "collection_item_changed";
+    readonly "webflow.collectionItem.created": "collection_item_created";
+    readonly "webflow.collectionItem.deleted": "collection_item_deleted";
+    readonly "webflow.collectionItem.published": "collection_item_published";
+    readonly "webflow.collectionItem.unpublished": "collection_item_unpublished";
+    readonly "webflow.comment.created": "comment_created";
+    readonly "webflow.form.submitted": "form_submission";
+    readonly "webflow.inventory.changed": "ecomm_inventory_changed";
+    readonly "webflow.order.changed": "ecomm_order_changed";
+    readonly "webflow.order.created": "ecomm_new_order";
+    readonly "webflow.page.created": "page_created";
+    readonly "webflow.page.deleted": "page_deleted";
+    readonly "webflow.page.metadataUpdated": "page_metadata_updated";
+    readonly "webflow.site.published": "site_publish";
+};
+type WebflowTriggerContracts = {
+    readonly [TTrigger in keyof WebflowSemanticTriggerTypes]: WebflowTriggerContract<WebflowSemanticEvent<WebflowSemanticTriggerTypes[TTrigger]>>;
+} & {
+    readonly "webflow.event": WebflowTriggerContract<WebflowEvent>;
+};
+export declare const webflowTriggerContracts: WebflowTriggerContracts;
+export declare const webflowEventTypeMap: {
+    readonly collection_item_changed: "webflow.collectionItem.changed";
+    readonly collection_item_created: "webflow.collectionItem.created";
+    readonly collection_item_deleted: "webflow.collectionItem.deleted";
+    readonly collection_item_published: "webflow.collectionItem.published";
+    readonly collection_item_unpublished: "webflow.collectionItem.unpublished";
+    readonly comment_created: "webflow.comment.created";
+    readonly ecomm_inventory_changed: "webflow.inventory.changed";
+    readonly ecomm_new_order: "webflow.order.created";
+    readonly ecomm_order_changed: "webflow.order.changed";
+    readonly form_submission: "webflow.form.submitted";
+    readonly page_created: "webflow.page.created";
+    readonly page_deleted: "webflow.page.deleted";
+    readonly page_metadata_updated: "webflow.page.metadataUpdated";
+    readonly site_publish: "webflow.site.published";
+};

package/dist/webflow/index.js

@@ -0,0 +1,54 @@
+import * as z from "zod";
+import { WEBFLOW_EVENT_SCHEMA, webflowSemanticEventSchema } from "./schemas.js";
+export * from "./schemas.js";
+/** Site selected for one Webflow webhook subscription. */
+export const WEBFLOW_TRIGGER_CONFIG_SCHEMA = z.object({
+    siteId: z.string().trim().min(1),
+});
+export const webflowTriggerContracts = {
+    "webflow.collectionItem.changed": semanticContract("collection_item_changed"),
+    "webflow.collectionItem.created": semanticContract("collection_item_created"),
+    "webflow.collectionItem.deleted": semanticContract("collection_item_deleted"),
+    "webflow.collectionItem.published": semanticContract("collection_item_published"),
+    "webflow.collectionItem.unpublished": semanticContract("collection_item_unpublished"),
+    "webflow.comment.created": semanticContract("comment_created"),
+    "webflow.event": {
+        configSchema: WEBFLOW_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: WEBFLOW_EVENT_SCHEMA,
+    },
+    "webflow.form.submitted": semanticContract("form_submission"),
+    "webflow.inventory.changed": semanticContract("ecomm_inventory_changed"),
+    "webflow.order.changed": semanticContract("ecomm_order_changed"),
+    "webflow.order.created": semanticContract("ecomm_new_order"),
+    "webflow.page.created": semanticContract("page_created"),
+    "webflow.page.deleted": semanticContract("page_deleted"),
+    "webflow.page.metadataUpdated": semanticContract("page_metadata_updated"),
+    "webflow.site.published": semanticContract("site_publish"),
+};
+export const webflowEventTypeMap = {
+    collection_item_changed: "webflow.collectionItem.changed",
+    collection_item_created: "webflow.collectionItem.created",
+    collection_item_deleted: "webflow.collectionItem.deleted",
+    collection_item_published: "webflow.collectionItem.published",
+    collection_item_unpublished: "webflow.collectionItem.unpublished",
+    comment_created: "webflow.comment.created",
+    ecomm_inventory_changed: "webflow.inventory.changed",
+    ecomm_new_order: "webflow.order.created",
+    ecomm_order_changed: "webflow.order.changed",
+    form_submission: "webflow.form.submitted",
+    page_created: "webflow.page.created",
+    page_deleted: "webflow.page.deleted",
+    page_metadata_updated: "webflow.page.metadataUpdated",
+    site_publish: "webflow.site.published",
+};
+/**
+ * Builds a contract for one semantic Webflow webhook event.
+ *
+ * @param type - Webflow webhook event type exposed by the contract.
+ */
+function semanticContract(type) {
+    return {
+        configSchema: WEBFLOW_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: webflowSemanticEventSchema(type),
+    };
+}

package/dist/webflow/schemas.d.ts

@@ -0,0 +1,119 @@
+import { type Encodable } from "@automate.ax/codec";
+import type { Webflow } from "webflow-api";
+import * as z from "zod";
+export declare const WEBFLOW_EVENT_TYPES: readonly ["form_submission", "site_publish", "page_created", "page_metadata_updated", "page_deleted", "ecomm_new_order", "ecomm_order_changed", "ecomm_inventory_changed", "collection_item_created", "collection_item_changed", "collection_item_deleted", "collection_item_published", "collection_item_unpublished", "comment_created"];
+export type WebflowEventType = (typeof WEBFLOW_EVENT_TYPES)[number];
+/** JSON representation of a Webflow ecommerce order webhook payload. */
+export type WebflowOrderEvent = Omit<Webflow.Order, "acceptedOn" | "disputeUpdatedOn" | "disputedOn" | "fulfilledOn" | "refundedOn"> & {
+    acceptedOn?: string;
+    disputeUpdatedOn?: string | null;
+    disputedOn?: string | null;
+    fulfilledOn?: string | null;
+    refundedOn?: string | null;
+};
+/** JSON representation of a Webflow collection-item webhook payload. */
+export interface WebflowCollectionItemEvent {
+    cmsLocaleId?: string;
+    collectionId: string;
+    createdOn?: string;
+    fieldData: Record<string, Encodable>;
+    id: string;
+    isArchived?: boolean;
+    isDraft?: boolean;
+    lastPublished?: string | null;
+    lastUpdated?: string;
+    siteId: string;
+    workspaceId: string;
+}
+/** Webflow form-submission webhook payload. */
+export interface WebflowFormSubmissionEvent {
+    data: Record<string, Encodable>;
+    formElementId?: string;
+    formId: string;
+    id: string;
+    name: string;
+    schema: Array<{
+        fieldElementId: string;
+        fieldName: string;
+        fieldType: string;
+    }>;
+    siteId: string;
+    submittedAt: string;
+}
+/** Webflow page lifecycle webhook payload. */
+export interface WebflowPageEvent {
+    archived: boolean;
+    createdOn?: string;
+    deletedOn?: string;
+    draft: boolean;
+    isBranch: boolean;
+    lastUpdated?: string;
+    pageId: string;
+    pageName: string | null;
+    pageTitle: string;
+    publishedPath: string;
+    siteId: string;
+}
+/** Webflow comment or reply webhook payload. */
+export interface WebflowCommentEvent {
+    author: WebflowCommentUser;
+    breakpoint: string;
+    commentId: string;
+    content: string;
+    createdOn: string;
+    isResolved: boolean;
+    lastUpdated: string;
+    localeId: string | null;
+    mentionedUsers: WebflowCommentUser[];
+    pageId: string;
+    siteId: string;
+    threadId: string;
+    type: "new_comment" | "reply";
+    url: string;
+}
+/** User identity included in a Webflow comment webhook. */
+export interface WebflowCommentUser {
+    email: string;
+    name: string;
+    userId: string;
+}
+/** One authenticated Webflow webhook envelope. */
+export type WebflowEvent = (WebflowTypedEvent<"collection_item_changed", WebflowCollectionItemEvent> | WebflowTypedEvent<"collection_item_created", WebflowCollectionItemEvent> | WebflowTypedEvent<"collection_item_deleted", WebflowDeletedItemEvent> | WebflowTypedEvent<"collection_item_published", WebflowCollectionItemEvent> | WebflowTypedEvent<"collection_item_unpublished", WebflowDeletedItemEvent> | WebflowTypedEvent<"comment_created", WebflowCommentEvent> | WebflowTypedEvent<"ecomm_inventory_changed", WebflowInventoryEvent> | WebflowTypedEvent<"ecomm_new_order", WebflowOrderEvent> | WebflowTypedEvent<"ecomm_order_changed", WebflowOrderEvent> | WebflowTypedEvent<"form_submission", WebflowFormSubmissionEvent> | WebflowTypedEvent<"page_created", WebflowPageEvent> | WebflowTypedEvent<"page_deleted", WebflowPageEvent> | WebflowTypedEvent<"page_metadata_updated", WebflowPageEvent> | WebflowTypedEvent<"site_publish", WebflowSitePublishEvent>) & Encodable;
+export type WebflowSemanticEvent<TType extends WebflowEventType> = Extract<WebflowEvent, {
+    triggerType: TType;
+}>;
+interface WebflowTypedEvent<TType extends WebflowEventType, TPayload> {
+    payload: TPayload;
+    triggerType: TType;
+}
+interface WebflowDeletedItemEvent {
+    cmsLocaleId?: string;
+    collectionId: string;
+    id: string;
+    siteId: string;
+    workspaceId: string;
+}
+interface WebflowInventoryEvent {
+    id: string;
+    inventoryType: "finite" | "infinite";
+    quantity?: number;
+}
+interface WebflowSitePublishEvent {
+    domains: string[];
+    publishScope?: "page" | "site";
+    publishTime?: string;
+    publishedBy: {
+        displayName: string;
+    };
+    publishedOn?: string;
+    site?: string;
+    siteId?: string;
+}
+export declare const WEBFLOW_EVENT_SCHEMA: z.ZodCustom<WebflowEvent, WebflowEvent>;
+/**
+ * Narrows the Webflow event schema to one webhook event type.
+ *
+ * @param type - Webflow webhook event type to require.
+ */
+export declare function webflowSemanticEventSchema<TType extends WebflowEventType>(type: TType): z.ZodType<WebflowSemanticEvent<TType>>;
+export {};

package/dist/webflow/schemas.js

@@ -0,0 +1,140 @@
+import { isEncodable } from "@automate.ax/codec";
+import * as serializers from "webflow-api/serialization";
+import * as z from "zod";
+export const WEBFLOW_EVENT_TYPES = [
+    "form_submission",
+    "site_publish",
+    "page_created",
+    "page_metadata_updated",
+    "page_deleted",
+    "ecomm_new_order",
+    "ecomm_order_changed",
+    "ecomm_inventory_changed",
+    "collection_item_created",
+    "collection_item_changed",
+    "collection_item_deleted",
+    "collection_item_published",
+    "collection_item_unpublished",
+    "comment_created",
+];
+const ENCODABLE_RECORD_SCHEMA = z.record(z.string(), z.custom(isEncodable));
+const COLLECTION_ITEM_SCHEMA = z.looseObject({
+    cmsLocaleId: z.string().optional(),
+    collectionId: z.string(),
+    createdOn: z.string().optional(),
+    fieldData: ENCODABLE_RECORD_SCHEMA,
+    id: z.string(),
+    isArchived: z.boolean().optional(),
+    isDraft: z.boolean().optional(),
+    lastPublished: z.string().nullable().optional(),
+    lastUpdated: z.string().optional(),
+    siteId: z.string(),
+    workspaceId: z.string(),
+});
+const DELETED_ITEM_SCHEMA = z.looseObject({
+    cmsLocaleId: z.string().optional(),
+    collectionId: z.string(),
+    id: z.string(),
+    siteId: z.string(),
+    workspaceId: z.string(),
+});
+const FORM_SUBMISSION_SCHEMA = z.looseObject({
+    data: ENCODABLE_RECORD_SCHEMA,
+    formElementId: z.string().optional(),
+    formId: z.string(),
+    id: z.string(),
+    name: z.string(),
+    schema: z.array(z.looseObject({
+        fieldElementId: z.string(),
+        fieldName: z.string(),
+        fieldType: z.string(),
+    })),
+    siteId: z.string(),
+    submittedAt: z.string(),
+});
+const PAGE_SCHEMA = z.looseObject({
+    archived: z.boolean(),
+    createdOn: z.string().optional(),
+    deletedOn: z.string().optional(),
+    draft: z.boolean(),
+    isBranch: z.boolean(),
+    lastUpdated: z.string().optional(),
+    pageId: z.string(),
+    pageName: z.string().nullable(),
+    pageTitle: z.string(),
+    publishedPath: z.string(),
+    siteId: z.string(),
+});
+const COMMENT_USER_SCHEMA = z.looseObject({
+    email: z.string(),
+    name: z.string(),
+    userId: z.string(),
+});
+const COMMENT_SCHEMA = z.looseObject({
+    author: COMMENT_USER_SCHEMA,
+    breakpoint: z.string(),
+    commentId: z.string(),
+    content: z.string(),
+    createdOn: z.string(),
+    isResolved: z.boolean(),
+    lastUpdated: z.string(),
+    localeId: z.string().nullable(),
+    mentionedUsers: z.array(COMMENT_USER_SCHEMA),
+    pageId: z.string(),
+    siteId: z.string(),
+    threadId: z.string(),
+    type: z.enum(["new_comment", "reply"]),
+    url: z.string(),
+});
+const INVENTORY_SCHEMA = z.looseObject({
+    id: z.string(),
+    inventoryType: z.enum(["finite", "infinite"]),
+    quantity: z.number().optional(),
+});
+const ORDER_SCHEMA = z.custom((value) => serializers.Order.parse(value, { unrecognizedObjectKeys: "fail" }).ok, { message: "Expected a Webflow ecommerce order." });
+const SITE_PUBLISH_SCHEMA = z.looseObject({
+    domains: z.array(z.string()),
+    publishScope: z.enum(["page", "site"]).optional(),
+    publishTime: z.string().optional(),
+    publishedBy: z.looseObject({ displayName: z.string() }),
+    publishedOn: z.string().optional(),
+    site: z.string().optional(),
+    siteId: z.string().optional(),
+});
+const WEBFLOW_BASE_EVENT_SCHEMA = z.discriminatedUnion("triggerType", [
+    typedEventSchema("collection_item_changed", COLLECTION_ITEM_SCHEMA),
+    typedEventSchema("collection_item_created", COLLECTION_ITEM_SCHEMA),
+    typedEventSchema("collection_item_deleted", DELETED_ITEM_SCHEMA),
+    typedEventSchema("collection_item_published", COLLECTION_ITEM_SCHEMA),
+    typedEventSchema("collection_item_unpublished", DELETED_ITEM_SCHEMA),
+    typedEventSchema("comment_created", COMMENT_SCHEMA),
+    typedEventSchema("ecomm_inventory_changed", INVENTORY_SCHEMA),
+    typedEventSchema("ecomm_new_order", ORDER_SCHEMA),
+    typedEventSchema("ecomm_order_changed", ORDER_SCHEMA),
+    typedEventSchema("form_submission", FORM_SUBMISSION_SCHEMA),
+    typedEventSchema("page_created", PAGE_SCHEMA),
+    typedEventSchema("page_deleted", PAGE_SCHEMA),
+    typedEventSchema("page_metadata_updated", PAGE_SCHEMA),
+    typedEventSchema("site_publish", SITE_PUBLISH_SCHEMA),
+]);
+export const WEBFLOW_EVENT_SCHEMA = z.custom((value) => WEBFLOW_BASE_EVENT_SCHEMA.safeParse(value).success, { message: "Expected a Webflow webhook event." });
+/**
+ * Narrows the Webflow event schema to one webhook event type.
+ *
+ * @param type - Webflow webhook event type to require.
+ */
+export function webflowSemanticEventSchema(type) {
+    return z.custom((value) => {
+        const event = WEBFLOW_EVENT_SCHEMA.safeParse(value);
+        return event.success && event.data.triggerType === type;
+    });
+}
+/**
+ * Builds one concrete Webflow event-envelope schema.
+ *
+ * @param type - Provider event discriminator.
+ * @param payloadSchema - Schema for that event's payload.
+ */
+function typedEventSchema(type, payloadSchema) {
+    return z.looseObject({ payload: payloadSchema, triggerType: z.literal(type) });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.84.0",
+  "version": "0.86.1",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -36,6 +36,7 @@
       "./trello": "./src/trello/index.ts",
       "./triggers": "./src/triggers.ts",
       "./vercel": "./src/vercel/index.ts",
+      "./webflow": "./src/webflow/index.ts",
       "./whatsapp": "./src/whatsapp/index.ts"
     },
     "cjs": false,
@@ -44,7 +45,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.84.0",
+    "@automate.ax/codec": "0.86.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",
     "@googleapis/gmail": "^12.0.0",
@@ -57,10 +58,11 @@
     "postal-mime": "^2.7.5",
     "stripe": "^22.1.0",
     "type-fest": "^5.6.0",
+    "webflow-api": "^3.3.4",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@internal/config": "0.1.0",
+    "@internal/config": "0.2.0",
     "@types/bun": "latest",
     "@types/html-to-text": "^9.0.4",
     "@types/nodemailer": "^8.0.1",
@@ -180,6 +182,11 @@
       "types": "./dist/vercel/index.d.ts",
       "default": "./dist/vercel/index.js"
     },
+    "./webflow": {
+      "bun": "./src/webflow/index.ts",
+      "types": "./dist/webflow/index.d.ts",
+      "default": "./dist/webflow/index.js"
+    },
     "./whatsapp": {
       "bun": "./src/whatsapp/index.ts",
       "types": "./dist/whatsapp/index.d.ts",

package/src/triggers.ts

@@ -15,6 +15,7 @@ import type { stripeTriggerContracts } from "./stripe"
 import type { teamsTriggerContracts } from "./teams"
 import type { trelloTriggerContracts } from "./trello"
 import type { vercelTriggerContracts } from "./vercel"
+import type { webflowTriggerContracts } from "./webflow"
 import type { whatsappTriggerContracts } from "./whatsapp"
 import type { z } from "zod"
 
@@ -35,6 +36,7 @@ export type TriggerContractMap = typeof airtableTriggerContracts &
   typeof teamsTriggerContracts &
   typeof trelloTriggerContracts &
   typeof vercelTriggerContracts &
+  typeof webflowTriggerContracts &
   typeof whatsappTriggerContracts
 export type IntegrationTriggerType = keyof TriggerContractMap
 

package/src/webflow/index.ts

@@ -0,0 +1,98 @@
+import * as z from "zod"
+import type {
+  WebflowEvent,
+  WebflowEventType,
+  WebflowSemanticEvent,
+} from "./schemas"
+import { WEBFLOW_EVENT_SCHEMA, webflowSemanticEventSchema } from "./schemas"
+
+export * from "./schemas"
+
+/** Site selected for one Webflow webhook subscription. */
+export const WEBFLOW_TRIGGER_CONFIG_SCHEMA = z.object({
+  siteId: z.string().trim().min(1),
+})
+
+type WebflowTriggerContract<TEvent> = {
+  readonly configSchema: typeof WEBFLOW_TRIGGER_CONFIG_SCHEMA
+  readonly eventSchema: z.ZodType<TEvent>
+}
+
+type WebflowSemanticTriggerTypes = {
+  readonly "webflow.collectionItem.changed": "collection_item_changed"
+  readonly "webflow.collectionItem.created": "collection_item_created"
+  readonly "webflow.collectionItem.deleted": "collection_item_deleted"
+  readonly "webflow.collectionItem.published": "collection_item_published"
+  readonly "webflow.collectionItem.unpublished": "collection_item_unpublished"
+  readonly "webflow.comment.created": "comment_created"
+  readonly "webflow.form.submitted": "form_submission"
+  readonly "webflow.inventory.changed": "ecomm_inventory_changed"
+  readonly "webflow.order.changed": "ecomm_order_changed"
+  readonly "webflow.order.created": "ecomm_new_order"
+  readonly "webflow.page.created": "page_created"
+  readonly "webflow.page.deleted": "page_deleted"
+  readonly "webflow.page.metadataUpdated": "page_metadata_updated"
+  readonly "webflow.site.published": "site_publish"
+}
+
+type WebflowTriggerContracts = {
+  readonly [TTrigger in keyof WebflowSemanticTriggerTypes]: WebflowTriggerContract<
+    WebflowSemanticEvent<WebflowSemanticTriggerTypes[TTrigger]>
+  >
+} & {
+  readonly "webflow.event": WebflowTriggerContract<WebflowEvent>
+}
+
+export const webflowTriggerContracts: WebflowTriggerContracts = {
+  "webflow.collectionItem.changed": semanticContract("collection_item_changed"),
+  "webflow.collectionItem.created": semanticContract("collection_item_created"),
+  "webflow.collectionItem.deleted": semanticContract("collection_item_deleted"),
+  "webflow.collectionItem.published": semanticContract(
+    "collection_item_published",
+  ),
+  "webflow.collectionItem.unpublished": semanticContract(
+    "collection_item_unpublished",
+  ),
+  "webflow.comment.created": semanticContract("comment_created"),
+  "webflow.event": {
+    configSchema: WEBFLOW_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: WEBFLOW_EVENT_SCHEMA,
+  },
+  "webflow.form.submitted": semanticContract("form_submission"),
+  "webflow.inventory.changed": semanticContract("ecomm_inventory_changed"),
+  "webflow.order.changed": semanticContract("ecomm_order_changed"),
+  "webflow.order.created": semanticContract("ecomm_new_order"),
+  "webflow.page.created": semanticContract("page_created"),
+  "webflow.page.deleted": semanticContract("page_deleted"),
+  "webflow.page.metadataUpdated": semanticContract("page_metadata_updated"),
+  "webflow.site.published": semanticContract("site_publish"),
+}
+
+export const webflowEventTypeMap = {
+  collection_item_changed: "webflow.collectionItem.changed",
+  collection_item_created: "webflow.collectionItem.created",
+  collection_item_deleted: "webflow.collectionItem.deleted",
+  collection_item_published: "webflow.collectionItem.published",
+  collection_item_unpublished: "webflow.collectionItem.unpublished",
+  comment_created: "webflow.comment.created",
+  ecomm_inventory_changed: "webflow.inventory.changed",
+  ecomm_new_order: "webflow.order.created",
+  ecomm_order_changed: "webflow.order.changed",
+  form_submission: "webflow.form.submitted",
+  page_created: "webflow.page.created",
+  page_deleted: "webflow.page.deleted",
+  page_metadata_updated: "webflow.page.metadataUpdated",
+  site_publish: "webflow.site.published",
+} as const satisfies Record<WebflowEventType, keyof WebflowTriggerContracts>
+
+/**
+ * Builds a contract for one semantic Webflow webhook event.
+ *
+ * @param type - Webflow webhook event type exposed by the contract.
+ */
+function semanticContract<TType extends WebflowEventType>(type: TType) {
+  return {
+    configSchema: WEBFLOW_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: webflowSemanticEventSchema(type),
+  }
+}

package/src/webflow/schemas.ts

@@ -0,0 +1,306 @@
+import { isEncodable, type Encodable } from "@automate.ax/codec"
+import type { Webflow } from "webflow-api"
+import * as serializers from "webflow-api/serialization"
+import * as z from "zod"
+
+export const WEBFLOW_EVENT_TYPES = [
+  "form_submission",
+  "site_publish",
+  "page_created",
+  "page_metadata_updated",
+  "page_deleted",
+  "ecomm_new_order",
+  "ecomm_order_changed",
+  "ecomm_inventory_changed",
+  "collection_item_created",
+  "collection_item_changed",
+  "collection_item_deleted",
+  "collection_item_published",
+  "collection_item_unpublished",
+  "comment_created",
+] as const satisfies readonly Webflow.TriggerType[]
+
+export type WebflowEventType = (typeof WEBFLOW_EVENT_TYPES)[number]
+
+/** JSON representation of a Webflow ecommerce order webhook payload. */
+export type WebflowOrderEvent = Omit<
+  Webflow.Order,
+  | "acceptedOn"
+  | "disputeUpdatedOn"
+  | "disputedOn"
+  | "fulfilledOn"
+  | "refundedOn"
+> & {
+  acceptedOn?: string
+  disputeUpdatedOn?: string | null
+  disputedOn?: string | null
+  fulfilledOn?: string | null
+  refundedOn?: string | null
+}
+
+/** JSON representation of a Webflow collection-item webhook payload. */
+export interface WebflowCollectionItemEvent {
+  cmsLocaleId?: string
+  collectionId: string
+  createdOn?: string
+  fieldData: Record<string, Encodable>
+  id: string
+  isArchived?: boolean
+  isDraft?: boolean
+  lastPublished?: string | null
+  lastUpdated?: string
+  siteId: string
+  workspaceId: string
+}
+
+/** Webflow form-submission webhook payload. */
+export interface WebflowFormSubmissionEvent {
+  data: Record<string, Encodable>
+  formElementId?: string
+  formId: string
+  id: string
+  name: string
+  schema: Array<{
+    fieldElementId: string
+    fieldName: string
+    fieldType: string
+  }>
+  siteId: string
+  submittedAt: string
+}
+
+/** Webflow page lifecycle webhook payload. */
+export interface WebflowPageEvent {
+  archived: boolean
+  createdOn?: string
+  deletedOn?: string
+  draft: boolean
+  isBranch: boolean
+  lastUpdated?: string
+  pageId: string
+  pageName: string | null
+  pageTitle: string
+  publishedPath: string
+  siteId: string
+}
+
+/** Webflow comment or reply webhook payload. */
+export interface WebflowCommentEvent {
+  author: WebflowCommentUser
+  breakpoint: string
+  commentId: string
+  content: string
+  createdOn: string
+  isResolved: boolean
+  lastUpdated: string
+  localeId: string | null
+  mentionedUsers: WebflowCommentUser[]
+  pageId: string
+  siteId: string
+  threadId: string
+  type: "new_comment" | "reply"
+  url: string
+}
+
+/** User identity included in a Webflow comment webhook. */
+export interface WebflowCommentUser {
+  email: string
+  name: string
+  userId: string
+}
+
+/** One authenticated Webflow webhook envelope. */
+export type WebflowEvent = (
+  | WebflowTypedEvent<"collection_item_changed", WebflowCollectionItemEvent>
+  | WebflowTypedEvent<"collection_item_created", WebflowCollectionItemEvent>
+  | WebflowTypedEvent<"collection_item_deleted", WebflowDeletedItemEvent>
+  | WebflowTypedEvent<"collection_item_published", WebflowCollectionItemEvent>
+  | WebflowTypedEvent<"collection_item_unpublished", WebflowDeletedItemEvent>
+  | WebflowTypedEvent<"comment_created", WebflowCommentEvent>
+  | WebflowTypedEvent<"ecomm_inventory_changed", WebflowInventoryEvent>
+  | WebflowTypedEvent<"ecomm_new_order", WebflowOrderEvent>
+  | WebflowTypedEvent<"ecomm_order_changed", WebflowOrderEvent>
+  | WebflowTypedEvent<"form_submission", WebflowFormSubmissionEvent>
+  | WebflowTypedEvent<"page_created", WebflowPageEvent>
+  | WebflowTypedEvent<"page_deleted", WebflowPageEvent>
+  | WebflowTypedEvent<"page_metadata_updated", WebflowPageEvent>
+  | WebflowTypedEvent<"site_publish", WebflowSitePublishEvent>
+) &
+  Encodable
+
+export type WebflowSemanticEvent<TType extends WebflowEventType> = Extract<
+  WebflowEvent,
+  { triggerType: TType }
+>
+
+interface WebflowTypedEvent<TType extends WebflowEventType, TPayload> {
+  payload: TPayload
+  triggerType: TType
+}
+
+interface WebflowDeletedItemEvent {
+  cmsLocaleId?: string
+  collectionId: string
+  id: string
+  siteId: string
+  workspaceId: string
+}
+
+interface WebflowInventoryEvent {
+  id: string
+  inventoryType: "finite" | "infinite"
+  quantity?: number
+}
+
+interface WebflowSitePublishEvent {
+  domains: string[]
+  publishScope?: "page" | "site"
+  publishTime?: string
+  publishedBy: { displayName: string }
+  publishedOn?: string
+  site?: string
+  siteId?: string
+}
+
+const ENCODABLE_RECORD_SCHEMA = z.record(
+  z.string(),
+  z.custom<Encodable>(isEncodable),
+)
+const COLLECTION_ITEM_SCHEMA = z.looseObject({
+  cmsLocaleId: z.string().optional(),
+  collectionId: z.string(),
+  createdOn: z.string().optional(),
+  fieldData: ENCODABLE_RECORD_SCHEMA,
+  id: z.string(),
+  isArchived: z.boolean().optional(),
+  isDraft: z.boolean().optional(),
+  lastPublished: z.string().nullable().optional(),
+  lastUpdated: z.string().optional(),
+  siteId: z.string(),
+  workspaceId: z.string(),
+})
+const DELETED_ITEM_SCHEMA = z.looseObject({
+  cmsLocaleId: z.string().optional(),
+  collectionId: z.string(),
+  id: z.string(),
+  siteId: z.string(),
+  workspaceId: z.string(),
+})
+const FORM_SUBMISSION_SCHEMA = z.looseObject({
+  data: ENCODABLE_RECORD_SCHEMA,
+  formElementId: z.string().optional(),
+  formId: z.string(),
+  id: z.string(),
+  name: z.string(),
+  schema: z.array(
+    z.looseObject({
+      fieldElementId: z.string(),
+      fieldName: z.string(),
+      fieldType: z.string(),
+    }),
+  ),
+  siteId: z.string(),
+  submittedAt: z.string(),
+})
+const PAGE_SCHEMA = z.looseObject({
+  archived: z.boolean(),
+  createdOn: z.string().optional(),
+  deletedOn: z.string().optional(),
+  draft: z.boolean(),
+  isBranch: z.boolean(),
+  lastUpdated: z.string().optional(),
+  pageId: z.string(),
+  pageName: z.string().nullable(),
+  pageTitle: z.string(),
+  publishedPath: z.string(),
+  siteId: z.string(),
+})
+const COMMENT_USER_SCHEMA = z.looseObject({
+  email: z.string(),
+  name: z.string(),
+  userId: z.string(),
+})
+const COMMENT_SCHEMA = z.looseObject({
+  author: COMMENT_USER_SCHEMA,
+  breakpoint: z.string(),
+  commentId: z.string(),
+  content: z.string(),
+  createdOn: z.string(),
+  isResolved: z.boolean(),
+  lastUpdated: z.string(),
+  localeId: z.string().nullable(),
+  mentionedUsers: z.array(COMMENT_USER_SCHEMA),
+  pageId: z.string(),
+  siteId: z.string(),
+  threadId: z.string(),
+  type: z.enum(["new_comment", "reply"]),
+  url: z.string(),
+})
+const INVENTORY_SCHEMA = z.looseObject({
+  id: z.string(),
+  inventoryType: z.enum(["finite", "infinite"]),
+  quantity: z.number().optional(),
+})
+const ORDER_SCHEMA = z.custom<WebflowOrderEvent>(
+  (value) =>
+    serializers.Order.parse(value, { unrecognizedObjectKeys: "fail" }).ok,
+  { message: "Expected a Webflow ecommerce order." },
+)
+const SITE_PUBLISH_SCHEMA = z.looseObject({
+  domains: z.array(z.string()),
+  publishScope: z.enum(["page", "site"]).optional(),
+  publishTime: z.string().optional(),
+  publishedBy: z.looseObject({ displayName: z.string() }),
+  publishedOn: z.string().optional(),
+  site: z.string().optional(),
+  siteId: z.string().optional(),
+})
+
+const WEBFLOW_BASE_EVENT_SCHEMA = z.discriminatedUnion("triggerType", [
+  typedEventSchema("collection_item_changed", COLLECTION_ITEM_SCHEMA),
+  typedEventSchema("collection_item_created", COLLECTION_ITEM_SCHEMA),
+  typedEventSchema("collection_item_deleted", DELETED_ITEM_SCHEMA),
+  typedEventSchema("collection_item_published", COLLECTION_ITEM_SCHEMA),
+  typedEventSchema("collection_item_unpublished", DELETED_ITEM_SCHEMA),
+  typedEventSchema("comment_created", COMMENT_SCHEMA),
+  typedEventSchema("ecomm_inventory_changed", INVENTORY_SCHEMA),
+  typedEventSchema("ecomm_new_order", ORDER_SCHEMA),
+  typedEventSchema("ecomm_order_changed", ORDER_SCHEMA),
+  typedEventSchema("form_submission", FORM_SUBMISSION_SCHEMA),
+  typedEventSchema("page_created", PAGE_SCHEMA),
+  typedEventSchema("page_deleted", PAGE_SCHEMA),
+  typedEventSchema("page_metadata_updated", PAGE_SCHEMA),
+  typedEventSchema("site_publish", SITE_PUBLISH_SCHEMA),
+])
+
+export const WEBFLOW_EVENT_SCHEMA = z.custom<WebflowEvent>(
+  (value) => WEBFLOW_BASE_EVENT_SCHEMA.safeParse(value).success,
+  { message: "Expected a Webflow webhook event." },
+)
+
+/**
+ * Narrows the Webflow event schema to one webhook event type.
+ *
+ * @param type - Webflow webhook event type to require.
+ */
+export function webflowSemanticEventSchema<TType extends WebflowEventType>(
+  type: TType,
+): z.ZodType<WebflowSemanticEvent<TType>> {
+  return z.custom<WebflowSemanticEvent<TType>>((value) => {
+    const event = WEBFLOW_EVENT_SCHEMA.safeParse(value)
+    return event.success && event.data.triggerType === type
+  })
+}
+
+/**
+ * Builds one concrete Webflow event-envelope schema.
+ *
+ * @param type - Provider event discriminator.
+ * @param payloadSchema - Schema for that event's payload.
+ */
+function typedEventSchema<TType extends WebflowEventType>(
+  type: TType,
+  payloadSchema: z.ZodType,
+) {
+  return z.looseObject({ payload: payloadSchema, triggerType: z.literal(type) })
+}