@automate.ax/integration-contracts 0.104.0 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.104.0",
+  "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.104.0",
+    "@automate.ax/codec": "0.105.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",

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.
  *