@automate.ax/integration-contracts 0.105.0 → 0.109.0

package/dist/whatsapp/index.d.ts

@@ -324,8 +324,8 @@ export declare const whatsappTriggerContracts: {
                 type: z.ZodEnum<{
                     unknown: "unknown";
                     text: "text";
-                    document: "document";
                     audio: "audio";
+                    document: "document";
                     image: "image";
                     video: "video";
                     location: "location";
@@ -419,8 +419,8 @@ export declare const whatsappTriggerContracts: {
                 type: z.ZodEnum<{
                     unknown: "unknown";
                     text: "text";
-                    document: "document";
                     audio: "audio";
+                    document: "document";
                     image: "image";
                     video: "video";
                     location: "location";

package/dist/whatsapp/schemas.d.ts

@@ -90,8 +90,8 @@ export declare const WHATSAPP_WEBHOOK_SCHEMA: z.ZodObject<{
                     type: z.ZodEnum<{
                         unknown: "unknown";
                         text: "text";
-                        document: "document";
                         audio: "audio";
+                        document: "document";
                         image: "image";
                         video: "video";
                         location: "location";
@@ -183,8 +183,8 @@ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SCHEMA: z.ZodObject<{
         type: z.ZodEnum<{
             unknown: "unknown";
             text: "text";
-            document: "document";
             audio: "audio";
+            document: "document";
             image: "image";
             video: "video";
             location: "location";
@@ -278,8 +278,8 @@ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SCHEMA: z.ZodObject<{
         type: z.ZodEnum<{
             unknown: "unknown";
             text: "text";
-            document: "document";
             audio: "audio";
+            document: "document";
             image: "image";
             video: "video";
             location: "location";
@@ -768,7 +768,7 @@ export declare function normalizeWhatsAppWebhook(input: unknown): {
         message: {
             id: string;
             timestamp: string;
-            type: "unknown" | "text" | "document" | "audio" | "image" | "video" | "location" | "system" | "order" | "reaction" | "button" | "contacts" | "interactive" | "sticker" | "unsupported";
+            type: "unknown" | "text" | "audio" | "document" | "image" | "video" | "location" | "system" | "order" | "reaction" | "button" | "contacts" | "interactive" | "sticker" | "unsupported";
             content?: z.core.util.JSONType | undefined;
             context?: {
                 messageId: string;
@@ -781,7 +781,7 @@ export declare function normalizeWhatsAppWebhook(input: unknown): {
             from: string;
             id: string;
             timestamp: string;
-            type: "unknown" | "text" | "document" | "audio" | "image" | "video" | "location" | "system" | "order" | "reaction" | "button" | "contacts" | "interactive" | "sticker" | "unsupported";
+            type: "unknown" | "text" | "audio" | "document" | "image" | "video" | "location" | "system" | "order" | "reaction" | "button" | "contacts" | "interactive" | "sticker" | "unsupported";
             audio?: {
                 id: string;
                 mime_type?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.105.0",
+  "version": "0.109.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -22,6 +22,7 @@
       "./automate": "./src/automate/index.ts",
       "./asana": "./src/asana/index.ts",
       "./brevo": "./src/brevo/index.ts",
+      "./cloudflare": "./src/cloudflare/index.ts",
       "./convex": "./src/convex/index.ts",
       "./close": "./src/close/index.ts",
       "./gmail": "./src/gmail/index.ts",
@@ -49,7 +50,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.105.0",
+    "@automate.ax/codec": "0.109.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -120,6 +121,11 @@
       "types": "./dist/brevo/index.d.ts",
       "default": "./dist/brevo/index.js"
     },
+    "./cloudflare": {
+      "bun": "./src/cloudflare/index.ts",
+      "types": "./dist/cloudflare/index.d.ts",
+      "default": "./dist/cloudflare/index.js"
+    },
     "./convex": {
       "bun": "./src/convex/index.ts",
       "types": "./dist/convex/index.d.ts",

package/src/airtable/api.ts

@@ -2,9 +2,10 @@ import * as z from "zod"
 
 export const AIRTABLE_API_ORIGIN = "https://api.airtable.com/v0/"
 
-const AIRTABLE_SECRET_SCHEMA = z.object({
-  accessToken: z.string().min(1),
-})
+const AIRTABLE_SECRET_SCHEMA = z.union([
+  z.object({ accessToken: z.string().min(1) }),
+  z.object({ apiKey: z.string().min(1) }),
+])
 const AIRTABLE_ERROR_SCHEMA = z.object({
   error: z.union([
     z.string(),
@@ -34,7 +35,9 @@ export interface AirtableApi {
  * @param secret - Refreshed Airtable integration secret.
  */
 export function getAirtableApi(secret: Record<string, unknown>): AirtableApi {
-  const { accessToken } = AIRTABLE_SECRET_SCHEMA.parse(secret)
+  const credential = AIRTABLE_SECRET_SCHEMA.parse(secret)
+  const accessToken =
+    "accessToken" in credential ? credential.accessToken : credential.apiKey
 
   return {
     request: async (path, init) => {

package/src/airtable/index.ts

@@ -1,10 +1,17 @@
 import * as z from "zod"
 import {
+  AIRTABLE_BASE_EVENT_SCHEMA,
+  AIRTABLE_FIELD_CREATED_EVENT_SCHEMA,
+  AIRTABLE_FIELD_DELETED_EVENT_SCHEMA,
+  AIRTABLE_FIELD_UPDATED_EVENT_SCHEMA,
   AIRTABLE_RECORD_CREATED_EVENT_SCHEMA,
   AIRTABLE_RECORD_DELETED_EVENT_SCHEMA,
   AIRTABLE_RECORD_MOVED_INTO_VIEW_EVENT_SCHEMA,
   AIRTABLE_RECORD_MOVED_OUT_OF_VIEW_EVENT_SCHEMA,
   AIRTABLE_RECORD_UPDATED_EVENT_SCHEMA,
+  AIRTABLE_TABLE_CREATED_EVENT_SCHEMA,
+  AIRTABLE_TABLE_DELETED_EVENT_SCHEMA,
+  AIRTABLE_TABLE_UPDATED_EVENT_SCHEMA,
 } from "./schemas"
 
 export * from "./api"
@@ -14,10 +21,26 @@ export * from "./schemas"
 export const AIRTABLE_TRIGGER_CONFIG_SCHEMA = z.object({
   baseId: z.string(),
   scopeId: z.string(),
-  scopeType: z.enum(["table", "view"]),
+  scopeType: z.enum(["base", "table", "view"]),
 })
 
 export const airtableTriggerContracts = {
+  "airtable.base.event": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_BASE_EVENT_SCHEMA,
+  },
+  "airtable.field.created": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_FIELD_CREATED_EVENT_SCHEMA,
+  },
+  "airtable.field.deleted": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_FIELD_DELETED_EVENT_SCHEMA,
+  },
+  "airtable.field.updated": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_FIELD_UPDATED_EVENT_SCHEMA,
+  },
   "airtable.record.created": {
     configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
     eventSchema: AIRTABLE_RECORD_CREATED_EVENT_SCHEMA,
@@ -38,4 +61,16 @@ export const airtableTriggerContracts = {
     configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
     eventSchema: AIRTABLE_RECORD_UPDATED_EVENT_SCHEMA,
   },
+  "airtable.table.created": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_TABLE_CREATED_EVENT_SCHEMA,
+  },
+  "airtable.table.deleted": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_TABLE_DELETED_EVENT_SCHEMA,
+  },
+  "airtable.table.updated": {
+    configSchema: AIRTABLE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AIRTABLE_TABLE_UPDATED_EVENT_SCHEMA,
+  },
 } as const

package/src/airtable/schemas.ts

@@ -34,7 +34,28 @@ const AIRTABLE_VIEW_CHANGE_SCHEMA = z.looseObject({
     .optional(),
   destroyedRecordIds: z.string().array().optional(),
 })
+const AIRTABLE_FIELD_DEFINITION_SCHEMA = z.object({
+  name: z.string(),
+  type: z.string(),
+})
+const AIRTABLE_FIELD_CHANGE_SCHEMA = z.looseObject({
+  current: AIRTABLE_FIELD_DEFINITION_SCHEMA.partial(),
+  previous: AIRTABLE_FIELD_DEFINITION_SCHEMA.partial().optional(),
+})
+const AIRTABLE_TABLE_METADATA_SCHEMA = z.object({
+  description: z.string().nullable(),
+  name: z.string(),
+})
 const AIRTABLE_TABLE_CHANGE_SCHEMA = z.looseObject({
+  changedFieldsById: z
+    .record(z.string(), AIRTABLE_FIELD_CHANGE_SCHEMA)
+    .optional(),
+  changedMetadata: z
+    .looseObject({
+      current: AIRTABLE_TABLE_METADATA_SCHEMA.partial(),
+      previous: AIRTABLE_TABLE_METADATA_SCHEMA.partial(),
+    })
+    .optional(),
   changedRecordsById: z
     .record(z.string(), AIRTABLE_CHANGED_RECORD_SCHEMA)
     .optional(),
@@ -44,8 +65,17 @@ const AIRTABLE_TABLE_CHANGE_SCHEMA = z.looseObject({
   createdRecordsById: z
     .record(z.string(), AIRTABLE_CREATED_RECORD_SCHEMA)
     .optional(),
+  createdFieldsById: z
+    .record(z.string(), AIRTABLE_FIELD_DEFINITION_SCHEMA)
+    .optional(),
+  destroyedFieldIds: z.string().array().optional(),
   destroyedRecordIds: z.string().array().optional(),
 })
+const AIRTABLE_CREATED_TABLE_SCHEMA = z.looseObject({
+  fieldsById: z.record(z.string(), AIRTABLE_FIELD_DEFINITION_SCHEMA).optional(),
+  metadata: AIRTABLE_TABLE_METADATA_SCHEMA.optional(),
+  recordsById: z.record(z.string(), AIRTABLE_CREATED_RECORD_SCHEMA).optional(),
+})
 
 /** One provider-native Airtable webhook transaction payload. */
 export const AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA = z
@@ -55,13 +85,84 @@ export const AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA = z
     changedTablesById: z
       .record(z.string(), AIRTABLE_TABLE_CHANGE_SCHEMA)
       .optional(),
+    createdTablesById: z
+      .record(z.string(), AIRTABLE_CREATED_TABLE_SCHEMA)
+      .optional(),
     code: z.string().optional(),
     error: z.literal(true).optional(),
+    destroyedTableIds: z.string().array().optional(),
     payloadFormat: z.string(),
     timestamp: z.iso.datetime({ offset: true }),
   })
   .catchall(z.json())
 
+export const AIRTABLE_BASE_EVENT_SCHEMA = z.object({
+  /** Airtable base that emitted the transaction. */
+  baseId: z.string(),
+
+  /** Complete provider webhook transaction. */
+  event: AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA,
+
+  /** Time at which Airtable committed the transaction. */
+  occurredAt: z.iso.datetime({ offset: true }),
+
+  /** Airtable system that caused the transaction. */
+  source: z.string(),
+
+  /** Provider-specific actor or source details. */
+  sourceMetadata: z.record(z.string(), z.json()).optional(),
+
+  /** Base-scoped transaction number assigned by Airtable. */
+  transactionNumber: z.number().int().nonnegative(),
+})
+
+const AIRTABLE_TABLE_EVENT_SCHEMA = AIRTABLE_BASE_EVENT_SCHEMA.extend({
+  /** Stable Airtable table ID. */
+  tableId: z.string(),
+})
+
+export const AIRTABLE_TABLE_CREATED_EVENT_SCHEMA =
+  AIRTABLE_TABLE_EVENT_SCHEMA.extend({
+    /** Field definitions keyed by stable field ID. */
+    fields: z.record(z.string(), AIRTABLE_FIELD_DEFINITION_SCHEMA),
+
+    /** Created table metadata when included by Airtable. */
+    metadata: AIRTABLE_TABLE_METADATA_SCHEMA.optional(),
+  })
+
+export const AIRTABLE_TABLE_UPDATED_EVENT_SCHEMA =
+  AIRTABLE_TABLE_EVENT_SCHEMA.extend({
+    /** Current table metadata fields changed by the transaction. */
+    current: AIRTABLE_TABLE_METADATA_SCHEMA.partial(),
+
+    /** Previous table metadata fields changed by the transaction. */
+    previous: AIRTABLE_TABLE_METADATA_SCHEMA.partial(),
+  })
+
+export const AIRTABLE_TABLE_DELETED_EVENT_SCHEMA = AIRTABLE_TABLE_EVENT_SCHEMA
+
+const AIRTABLE_FIELD_EVENT_SCHEMA = AIRTABLE_TABLE_EVENT_SCHEMA.extend({
+  /** Stable Airtable field ID. */
+  fieldId: z.string(),
+})
+
+export const AIRTABLE_FIELD_CREATED_EVENT_SCHEMA =
+  AIRTABLE_FIELD_EVENT_SCHEMA.extend({
+    /** Created field definition. */
+    field: AIRTABLE_FIELD_DEFINITION_SCHEMA,
+  })
+
+export const AIRTABLE_FIELD_UPDATED_EVENT_SCHEMA =
+  AIRTABLE_FIELD_EVENT_SCHEMA.extend({
+    /** Current field definition values changed by the transaction. */
+    current: AIRTABLE_FIELD_DEFINITION_SCHEMA.partial(),
+
+    /** Previous field definition values changed by the transaction. */
+    previous: AIRTABLE_FIELD_DEFINITION_SCHEMA.partial().optional(),
+  })
+
+export const AIRTABLE_FIELD_DELETED_EVENT_SCHEMA = AIRTABLE_FIELD_EVENT_SCHEMA
+
 const AIRTABLE_RECORD_EVENT_SCHEMA = z.object({
   /** Airtable base containing the affected record. */
   baseId: z.string(),
@@ -123,7 +224,14 @@ export const AIRTABLE_RECORD_MOVED_OUT_OF_VIEW_EVENT_SCHEMA =
     viewId: z.string(),
   })
 
-export const AIRTABLE_RECORD_EVENT_TYPES = [
+export const AIRTABLE_EVENT_TYPES = [
+  "airtable.base.event",
+  "airtable.table.created",
+  "airtable.table.updated",
+  "airtable.table.deleted",
+  "airtable.field.created",
+  "airtable.field.updated",
+  "airtable.field.deleted",
   "airtable.record.created",
   "airtable.record.updated",
   "airtable.record.deleted",
@@ -131,77 +239,206 @@ export const AIRTABLE_RECORD_EVENT_TYPES = [
   "airtable.record.movedOutOfView",
 ] as const
 
-export type AirtableRecordEventType =
-  (typeof AIRTABLE_RECORD_EVENT_TYPES)[number]
+export type AirtableEventType = (typeof AIRTABLE_EVENT_TYPES)[number]
 
 /**
- * Expands one Airtable webhook transaction into semantic record events.
+ * Expands one Airtable webhook transaction into broad and semantic events.
  *
  * @param value - Untrusted provider payload returned by Airtable.
  * @param baseId - Stable ID of the base that owns the webhook.
  */
-export function normalizeAirtableRecordEvents(value: unknown, baseId: string) {
+export function normalizeAirtableEvents(value: unknown, baseId: string) {
   const event = AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA.parse(value)
 
-  return Object.entries(event.changedTablesById ?? {}).flatMap(
-    ([tableId, table]) => [
-      ...Object.entries(table.createdRecordsById ?? {}).map(
-        ([recordId, record]) => ({
-          eventType: "airtable.record.created" as const,
-          payload: AIRTABLE_RECORD_CREATED_EVENT_SCHEMA.parse({
-            ...recordEventBase(event, baseId, tableId, recordId),
-            createdAt: record.createdTime,
-            fields: record.cellValuesByFieldId,
+  return [
+    {
+      eventType: "airtable.base.event" as const,
+      payload: AIRTABLE_BASE_EVENT_SCHEMA.parse(baseEventBase(event, baseId)),
+    },
+    ...Object.entries(event.createdTablesById ?? {}).flatMap(
+      ([tableId, table]) => [
+        {
+          eventType: "airtable.table.created" as const,
+          payload: AIRTABLE_TABLE_CREATED_EVENT_SCHEMA.parse({
+            ...tableEventBase(event, baseId, tableId),
+            fields: table.fieldsById ?? {},
+            metadata: table.metadata,
           }),
-        }),
-      ),
-      ...Object.entries(table.changedRecordsById ?? {}).map(
-        ([recordId, record]) => ({
-          eventType: "airtable.record.updated" as const,
-          payload: AIRTABLE_RECORD_UPDATED_EVENT_SCHEMA.parse({
-            ...recordEventBase(event, baseId, tableId, recordId),
-            changedFieldIds: Object.keys(record.current.cellValuesByFieldId),
-            fields: {
-              ...record.unchanged?.cellValuesByFieldId,
-              ...record.current.cellValuesByFieldId,
-            },
-            previousFields: {
-              ...record.unchanged?.cellValuesByFieldId,
-              ...record.previous?.cellValuesByFieldId,
-            },
+        },
+        ...Object.entries(table.fieldsById ?? {}).map(([fieldId, field]) => ({
+          eventType: "airtable.field.created" as const,
+          payload: AIRTABLE_FIELD_CREATED_EVENT_SCHEMA.parse({
+            ...fieldEventBase(event, baseId, tableId, fieldId),
+            field,
           }),
-        }),
+        })),
+        ...Object.entries(table.recordsById ?? {}).map(
+          ([recordId, record]) => ({
+            eventType: "airtable.record.created" as const,
+            payload: AIRTABLE_RECORD_CREATED_EVENT_SCHEMA.parse({
+              ...recordEventBase(event, baseId, tableId, recordId),
+              createdAt: record.createdTime,
+              fields: record.cellValuesByFieldId,
+            }),
+          }),
+        ),
+      ],
+    ),
+    ...(event.destroyedTableIds ?? []).map((tableId) => ({
+      eventType: "airtable.table.deleted" as const,
+      payload: AIRTABLE_TABLE_DELETED_EVENT_SCHEMA.parse(
+        tableEventBase(event, baseId, tableId),
       ),
-      ...(table.destroyedRecordIds ?? []).map((recordId) => ({
-        eventType: "airtable.record.deleted" as const,
-        payload: AIRTABLE_RECORD_DELETED_EVENT_SCHEMA.parse(
-          recordEventBase(event, baseId, tableId, recordId),
+    })),
+    ...Object.entries(event.changedTablesById ?? {}).flatMap(
+      ([tableId, table]) => [
+        ...(table.changedMetadata
+          ? [
+              {
+                eventType: "airtable.table.updated" as const,
+                payload: AIRTABLE_TABLE_UPDATED_EVENT_SCHEMA.parse({
+                  ...tableEventBase(event, baseId, tableId),
+                  current: table.changedMetadata.current,
+                  previous: table.changedMetadata.previous,
+                }),
+              },
+            ]
+          : []),
+        ...Object.entries(table.createdFieldsById ?? {}).map(
+          ([fieldId, field]) => ({
+            eventType: "airtable.field.created" as const,
+            payload: AIRTABLE_FIELD_CREATED_EVENT_SCHEMA.parse({
+              ...fieldEventBase(event, baseId, tableId, fieldId),
+              field,
+            }),
+          }),
         ),
-      })),
-      ...Object.entries(table.changedViewsById ?? {}).flatMap(
-        ([viewId, view]) => [
-          ...Object.entries(view.createdRecordsById ?? {}).map(
-            ([recordId, record]) => ({
-              eventType: "airtable.record.movedIntoView" as const,
-              payload: AIRTABLE_RECORD_MOVED_INTO_VIEW_EVENT_SCHEMA.parse({
-                ...recordEventBase(event, baseId, tableId, recordId),
-                createdAt: record.createdTime,
-                fields: record.cellValuesByFieldId,
-                viewId,
-              }),
+        ...Object.entries(table.changedFieldsById ?? {}).map(
+          ([fieldId, field]) => ({
+            eventType: "airtable.field.updated" as const,
+            payload: AIRTABLE_FIELD_UPDATED_EVENT_SCHEMA.parse({
+              ...fieldEventBase(event, baseId, tableId, fieldId),
+              current: field.current,
+              previous: field.previous,
             }),
+          }),
+        ),
+        ...(table.destroyedFieldIds ?? []).map((fieldId) => ({
+          eventType: "airtable.field.deleted" as const,
+          payload: AIRTABLE_FIELD_DELETED_EVENT_SCHEMA.parse(
+            fieldEventBase(event, baseId, tableId, fieldId),
           ),
-          ...(view.destroyedRecordIds ?? []).map((recordId) => ({
-            eventType: "airtable.record.movedOutOfView" as const,
-            payload: AIRTABLE_RECORD_MOVED_OUT_OF_VIEW_EVENT_SCHEMA.parse({
+        })),
+        ...Object.entries(table.createdRecordsById ?? {}).map(
+          ([recordId, record]) => ({
+            eventType: "airtable.record.created" as const,
+            payload: AIRTABLE_RECORD_CREATED_EVENT_SCHEMA.parse({
               ...recordEventBase(event, baseId, tableId, recordId),
-              viewId,
+              createdAt: record.createdTime,
+              fields: record.cellValuesByFieldId,
             }),
-          })),
-        ],
-      ),
-    ],
-  )
+          }),
+        ),
+        ...Object.entries(table.changedRecordsById ?? {}).map(
+          ([recordId, record]) => ({
+            eventType: "airtable.record.updated" as const,
+            payload: AIRTABLE_RECORD_UPDATED_EVENT_SCHEMA.parse({
+              ...recordEventBase(event, baseId, tableId, recordId),
+              changedFieldIds: Object.keys(record.current.cellValuesByFieldId),
+              fields: {
+                ...record.unchanged?.cellValuesByFieldId,
+                ...record.current.cellValuesByFieldId,
+              },
+              previousFields: {
+                ...record.unchanged?.cellValuesByFieldId,
+                ...record.previous?.cellValuesByFieldId,
+              },
+            }),
+          }),
+        ),
+        ...(table.destroyedRecordIds ?? []).map((recordId) => ({
+          eventType: "airtable.record.deleted" as const,
+          payload: AIRTABLE_RECORD_DELETED_EVENT_SCHEMA.parse(
+            recordEventBase(event, baseId, tableId, recordId),
+          ),
+        })),
+        ...Object.entries(table.changedViewsById ?? {}).flatMap(
+          ([viewId, view]) => [
+            ...Object.entries(view.createdRecordsById ?? {}).map(
+              ([recordId, record]) => ({
+                eventType: "airtable.record.movedIntoView" as const,
+                payload: AIRTABLE_RECORD_MOVED_INTO_VIEW_EVENT_SCHEMA.parse({
+                  ...recordEventBase(event, baseId, tableId, recordId),
+                  createdAt: record.createdTime,
+                  fields: record.cellValuesByFieldId,
+                  viewId,
+                }),
+              }),
+            ),
+            ...(view.destroyedRecordIds ?? []).map((recordId) => ({
+              eventType: "airtable.record.movedOutOfView" as const,
+              payload: AIRTABLE_RECORD_MOVED_OUT_OF_VIEW_EVENT_SCHEMA.parse({
+                ...recordEventBase(event, baseId, tableId, recordId),
+                viewId,
+              }),
+            })),
+          ],
+        ),
+      ],
+    ),
+  ]
+}
+
+/**
+ * Builds fields shared by every event in one Airtable transaction.
+ *
+ * @param event - Parsed provider transaction.
+ * @param baseId - Stable Airtable base ID.
+ */
+function baseEventBase(
+  event: z.output<typeof AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA>,
+  baseId: string,
+) {
+  return {
+    baseId,
+    event,
+    occurredAt: event.timestamp,
+    source: event.actionMetadata.source,
+    sourceMetadata: event.actionMetadata.sourceMetadata,
+    transactionNumber: event.baseTransactionNumber,
+  }
+}
+
+/**
+ * Adds a stable table ID to the shared Airtable event fields.
+ *
+ * @param event - Parsed provider transaction.
+ * @param baseId - Stable Airtable base ID.
+ * @param tableId - Stable Airtable table ID.
+ */
+function tableEventBase(
+  event: z.output<typeof AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA>,
+  baseId: string,
+  tableId: string,
+) {
+  return { ...baseEventBase(event, baseId), tableId }
+}
+
+/**
+ * Adds stable table and field IDs to the shared Airtable event fields.
+ *
+ * @param event - Parsed provider transaction.
+ * @param baseId - Stable Airtable base ID.
+ * @param tableId - Stable Airtable table ID.
+ * @param fieldId - Stable Airtable field ID.
+ */
+function fieldEventBase(
+  event: z.output<typeof AIRTABLE_WEBHOOK_PAYLOAD_SCHEMA>,
+  baseId: string,
+  tableId: string,
+  fieldId: string,
+) {
+  return { ...tableEventBase(event, baseId, tableId), fieldId }
 }
 
 /**
@@ -219,13 +456,7 @@ function recordEventBase(
   recordId: string,
 ) {
   return {
-    baseId,
-    event,
-    occurredAt: event.timestamp,
+    ...tableEventBase(event, baseId, tableId),
     recordId,
-    source: event.actionMetadata.source,
-    sourceMetadata: event.actionMetadata.sourceMetadata,
-    tableId,
-    transactionNumber: event.baseTransactionNumber,
   }
 }