@automate.ax/integration-contracts 0.144.1 → 0.145.0

package/src/calcom/schemas.ts

@@ -0,0 +1,75 @@
+/* oxlint-disable typescript/no-unsafe-type-assertion -- Generated schema names index a frozen external contract. */
+import { Validator } from "@cfworker/json-schema"
+import type { Encodable } from "@automate.ax/codec"
+import * as z from "zod"
+import schemaData from "./openapi-schemas.generated.json" with { type: "json" }
+import type { components } from "./openapi-types.generated"
+
+type OpenApiSchemas = components["schemas"]
+
+export type CalcomSchemaName = keyof OpenApiSchemas
+
+type CalcomEncodable<TValue> = unknown extends TValue
+  ? Encodable
+  : TValue extends null | undefined | boolean | number | string
+    ? TValue
+    : TValue extends readonly (infer TItem)[]
+      ? CalcomEncodable<TItem>[]
+      : TValue extends object
+        ? keyof TValue extends never
+          ? Record<string, Encodable>
+          : { [TKey in keyof TValue]: CalcomEncodable<TValue[TKey]> }
+        : never
+
+/** Public JSON-safe value for one generated Cal.com component schema. */
+export type CalcomSchemaValue<TName extends CalcomSchemaName> = CalcomEncodable<
+  OpenApiSchemas[TName]
+>
+
+/** Data carried by one successful Cal.com response envelope. */
+export type CalcomResponseData<TName extends CalcomSchemaName> =
+  CalcomSchemaValue<TName> extends { data: infer TData } ? TData : never
+
+const VALIDATOR = new Validator(
+  {
+    $defs: schemaData.definitions,
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    additionalProperties: false,
+    maxProperties: 1,
+    minProperties: 1,
+    properties: Object.fromEntries(
+      Object.keys(schemaData.definitions).map((name) => [
+        name,
+        { $ref: `#/$defs/${name}` },
+      ]),
+    ),
+    type: "object",
+  },
+  "2020-12",
+)
+
+/**
+ * Validates one value against a frozen Cal.com OpenAPI component schema.
+ *
+ * @param name OpenAPI component schema name.
+ */
+export function calcomSchema<TName extends CalcomSchemaName>(
+  name: TName,
+): z.ZodType<CalcomSchemaValue<TName>> {
+  return z.custom<CalcomSchemaValue<TName>>(
+    (value) => VALIDATOR.validate({ [name]: value }).valid,
+  )
+}
+
+/**
+ * Validates data after it has been removed from a Cal.com success envelope.
+ *
+ * @param name OpenAPI success-envelope component schema name.
+ */
+export function calcomResponseDataSchema<TName extends CalcomSchemaName>(
+  name: TName,
+): z.ZodType<CalcomResponseData<TName>> {
+  return z.custom<CalcomResponseData<TName>>(
+    (data) => VALIDATOR.validate({ [name]: { data, status: "success" } }).valid,
+  )
+}

package/src/google-ads/events.ts

@@ -44,10 +44,7 @@ export type GoogleAdsEventType = keyof typeof googleAdsTriggerContracts
 export function getGoogleAdsChangeEventTypes(
   event: z.output<typeof GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA>,
 ): GoogleAdsEventType[] {
-  const semanticType = getSemanticEventType(
-    event.event.changeResourceType,
-    event.event.resourceChangeOperation,
-  )
+  const semanticType = getSemanticEventType(event.event)
   return semanticType
     ? ["googleAds.change", semanticType]
     : ["googleAds.change"]
@@ -56,19 +53,20 @@ export function getGoogleAdsChangeEventTypes(
 /**
  * Maps provider resource and operation enums to public event types.
  *
- * @param resource - Provider change resource enum.
- * @param operation - Provider mutation operation.
+ * Google reports status-based removal of campaigns, ad groups, and ads as an
+ * update. Treat the terminal status as removal so the public event matches the
+ * user-visible mutation.
+ *
+ * @param event - Normalized provider change event.
  */
 function getSemanticEventType(
-  resource: z.output<
-    typeof GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA
-  >["event"]["changeResourceType"],
-  operation: z.output<
-    typeof GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA
-  >["event"]["resourceChangeOperation"],
+  event: z.output<typeof GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA>["event"],
 ): GoogleAdsEventType | undefined {
+  const operation = isStatusRemoval(event)
+    ? "REMOVE"
+    : event.resourceChangeOperation
   if (operation === "UNSPECIFIED" || operation === "UNKNOWN") return undefined
-  switch (resource) {
+  switch (event.changeResourceType) {
     case "AD_GROUP":
       return (
         {
@@ -129,3 +127,35 @@ function getSemanticEventType(
       return undefined
   }
 }
+
+/**
+ * Returns whether Google encoded a status-based resource removal as update.
+ *
+ * @param event - Normalized provider change event.
+ */
+function isStatusRemoval(
+  event: z.output<typeof GOOGLE_ADS_CHANGE_EVENT_PAYLOAD_SCHEMA>["event"],
+) {
+  if (event.resourceChangeOperation !== "UPDATE") return false
+  let resourceKey: "adGroup" | "adGroupAd" | "campaign"
+  switch (event.changeResourceType) {
+    case "AD_GROUP":
+      resourceKey = "adGroup"
+      break
+    case "AD_GROUP_AD":
+      resourceKey = "adGroupAd"
+      break
+    case "CAMPAIGN":
+      resourceKey = "campaign"
+      break
+    default:
+      return false
+  }
+  const resource = event.newResource?.[resourceKey]
+  return (
+    typeof resource === "object" &&
+    resource !== null &&
+    !Array.isArray(resource) &&
+    resource.status === "REMOVED"
+  )
+}

package/src/triggers.ts

@@ -5,6 +5,7 @@ import type { axiomTriggerContracts } from "./axiom"
 import type { automateTriggerContracts } from "./automate"
 import type { asanaTriggerContracts } from "./asana"
 import type { brevoTriggerContracts } from "./brevo"
+import type { calcomTriggerContracts } from "./calcom"
 import type { convexTriggerContracts } from "./convex"
 import type { discordTriggerContracts } from "./discord"
 import type { closeTriggerContracts } from "./close"
@@ -43,6 +44,7 @@ export type TriggerContractMap = typeof airtableTriggerContracts &
   typeof automateTriggerContracts &
   typeof asanaTriggerContracts &
   typeof brevoTriggerContracts &
+  typeof calcomTriggerContracts &
   typeof convexTriggerContracts &
   typeof discordTriggerContracts &
   typeof closeTriggerContracts &