@automate.ax/integration-contracts 0.83.3 → 0.85.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.83.3",
+  "version": "0.85.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -31,10 +31,12 @@
       "./outlook": "./src/outlook/index.ts",
       "./resend": "./src/resend/index.ts",
       "./slack": "./src/slack/index.ts",
+      "./stripe": "./src/stripe/index.ts",
       "./teams": "./src/teams/index.ts",
       "./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,
@@ -43,7 +45,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.83.3",
+    "@automate.ax/codec": "0.85.0",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",
     "@googleapis/gmail": "^12.0.0",
@@ -54,11 +56,13 @@
     "html-to-text": "^10.0.0",
     "nodemailer": "^9.0.3",
     "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",
@@ -153,6 +157,11 @@
       "types": "./dist/slack/index.d.ts",
       "default": "./dist/slack/index.js"
     },
+    "./stripe": {
+      "bun": "./src/stripe/index.ts",
+      "types": "./dist/stripe/index.d.ts",
+      "default": "./dist/stripe/index.js"
+    },
     "./teams": {
       "bun": "./src/teams/index.ts",
       "types": "./dist/teams/index.d.ts",
@@ -173,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/stripe/index.ts

@@ -0,0 +1,165 @@
+import * as z from "zod"
+import type { StripeEvent, StripeSemanticEvent } from "./schemas"
+import { STRIPE_EVENT_SCHEMA, stripeSemanticEventSchema } from "./schemas"
+
+export * from "./schemas"
+
+export const STRIPE_TRIGGER_CONFIG_SCHEMA = z.object({})
+
+type StripeTriggerContract<TEvent> = {
+  readonly configSchema: typeof STRIPE_TRIGGER_CONFIG_SCHEMA
+  readonly eventSchema: z.ZodType<TEvent>
+}
+
+type StripeSemanticTriggerEventTypes = {
+  readonly "stripe.charge.dispute.closed": "charge.dispute.closed"
+  readonly "stripe.charge.dispute.created": "charge.dispute.created"
+  readonly "stripe.checkout.session.asyncPaymentFailed": "checkout.session.async_payment_failed"
+  readonly "stripe.checkout.session.asyncPaymentSucceeded": "checkout.session.async_payment_succeeded"
+  readonly "stripe.checkout.session.completed": "checkout.session.completed"
+  readonly "stripe.checkout.session.expired": "checkout.session.expired"
+  readonly "stripe.customer.created": "customer.created"
+  readonly "stripe.customer.deleted": "customer.deleted"
+  readonly "stripe.customer.subscription.created": "customer.subscription.created"
+  readonly "stripe.customer.subscription.deleted": "customer.subscription.deleted"
+  readonly "stripe.customer.subscription.trialWillEnd": "customer.subscription.trial_will_end"
+  readonly "stripe.customer.subscription.updated": "customer.subscription.updated"
+  readonly "stripe.customer.updated": "customer.updated"
+  readonly "stripe.invoice.finalized": "invoice.finalized"
+  readonly "stripe.invoice.overdue": "invoice.overdue"
+  readonly "stripe.invoice.paid": "invoice.paid"
+  readonly "stripe.invoice.paymentFailed": "invoice.payment_failed"
+  readonly "stripe.invoice.voided": "invoice.voided"
+  readonly "stripe.paymentIntent.canceled": "payment_intent.canceled"
+  readonly "stripe.paymentIntent.paymentFailed": "payment_intent.payment_failed"
+  readonly "stripe.paymentIntent.succeeded": "payment_intent.succeeded"
+  readonly "stripe.payout.failed": "payout.failed"
+  readonly "stripe.payout.paid": "payout.paid"
+  readonly "stripe.refund.created": "refund.created"
+  readonly "stripe.refund.failed": "refund.failed"
+}
+
+/**
+ * Named registry shape keeps declaration emit independent of Stripe's private
+ * resource modules.
+ */
+type StripeTriggerContracts = {
+  readonly [TTrigger in keyof StripeSemanticTriggerEventTypes]: StripeTriggerContract<
+    StripeSemanticEvent<StripeSemanticTriggerEventTypes[TTrigger]>
+  >
+} & {
+  readonly "stripe.event": StripeTriggerContract<StripeEvent>
+}
+
+export const stripeTriggerContracts: StripeTriggerContracts = {
+  "stripe.charge.dispute.closed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("charge.dispute.closed"),
+  },
+  "stripe.charge.dispute.created": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("charge.dispute.created"),
+  },
+  "stripe.checkout.session.completed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("checkout.session.completed"),
+  },
+  "stripe.checkout.session.asyncPaymentFailed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema(
+      "checkout.session.async_payment_failed",
+    ),
+  },
+  "stripe.checkout.session.asyncPaymentSucceeded": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema(
+      "checkout.session.async_payment_succeeded",
+    ),
+  },
+  "stripe.checkout.session.expired": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("checkout.session.expired"),
+  },
+  "stripe.customer.created": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.created"),
+  },
+  "stripe.customer.deleted": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.deleted"),
+  },
+  "stripe.customer.subscription.created": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.subscription.created"),
+  },
+  "stripe.customer.subscription.deleted": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.subscription.deleted"),
+  },
+  "stripe.customer.subscription.trialWillEnd": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema(
+      "customer.subscription.trial_will_end",
+    ),
+  },
+  "stripe.customer.subscription.updated": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.subscription.updated"),
+  },
+  "stripe.customer.updated": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("customer.updated"),
+  },
+  "stripe.event": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: STRIPE_EVENT_SCHEMA,
+  },
+  "stripe.invoice.finalized": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("invoice.finalized"),
+  },
+  "stripe.invoice.overdue": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("invoice.overdue"),
+  },
+  "stripe.invoice.paid": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("invoice.paid"),
+  },
+  "stripe.invoice.paymentFailed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("invoice.payment_failed"),
+  },
+  "stripe.invoice.voided": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("invoice.voided"),
+  },
+  "stripe.paymentIntent.canceled": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("payment_intent.canceled"),
+  },
+  "stripe.paymentIntent.paymentFailed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("payment_intent.payment_failed"),
+  },
+  "stripe.paymentIntent.succeeded": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("payment_intent.succeeded"),
+  },
+  "stripe.payout.failed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("payout.failed"),
+  },
+  "stripe.payout.paid": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("payout.paid"),
+  },
+  "stripe.refund.created": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("refund.created"),
+  },
+  "stripe.refund.failed": {
+    configSchema: STRIPE_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: stripeSemanticEventSchema("refund.failed"),
+  },
+}

package/src/stripe/schemas.ts

@@ -0,0 +1,120 @@
+import type { Encodable } from "@automate.ax/codec"
+import type Stripe from "stripe"
+import type { CamelCasedPropertiesDeep } from "type-fest"
+import * as z from "zod"
+
+export const STRIPE_SEMANTIC_EVENT_TYPES = [
+  "charge.dispute.closed",
+  "charge.dispute.created",
+  "checkout.session.async_payment_failed",
+  "checkout.session.async_payment_succeeded",
+  "checkout.session.completed",
+  "checkout.session.expired",
+  "customer.created",
+  "customer.deleted",
+  "customer.subscription.created",
+  "customer.subscription.deleted",
+  "customer.subscription.trial_will_end",
+  "customer.subscription.updated",
+  "customer.updated",
+  "invoice.finalized",
+  "invoice.overdue",
+  "invoice.paid",
+  "invoice.payment_failed",
+  "invoice.voided",
+  "payment_intent.canceled",
+  "payment_intent.payment_failed",
+  "payment_intent.succeeded",
+  "payout.failed",
+  "payout.paid",
+  "refund.created",
+  "refund.failed",
+] as const satisfies readonly Stripe.Event.Type[]
+
+const STRIPE_EVENT_BASE_SCHEMA = z.looseObject({
+  apiVersion: z.string().nullable(),
+  created: z.number().int().nonnegative(),
+  data: z.looseObject({ object: z.looseObject({ object: z.string() }) }),
+  id: z.string().startsWith("evt_"),
+  livemode: z.boolean(),
+  object: z.literal("event"),
+  pendingWebhooks: z.number().int().nonnegative(),
+  request: z
+    .looseObject({
+      id: z.string().nullable(),
+      idempotencyKey: z.string().nullable(),
+    })
+    .nullable(),
+  type: z.string().min(1),
+})
+
+/** Public camelCase representation of an official Stripe event type. */
+export type StripeEvent<TEvent extends Stripe.Event = Stripe.Event> =
+  CamelCasedPropertiesDeep<TEvent> & Encodable
+
+/** Public event type for one exact Stripe event name. */
+export type StripeSemanticEvent<TType extends Stripe.Event.Type> = StripeEvent<
+  Extract<Stripe.Event, { type: TType }>
+>
+
+export const STRIPE_EVENT_SCHEMA: z.ZodType<StripeEvent> =
+  z.custom<StripeEvent>(
+    (value) => STRIPE_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+
+/**
+ * Converts a verified provider event to its public camelCase representation.
+ *
+ * @param event - Verified provider event.
+ * @returns Validated public Stripe event.
+ */
+export function normalizeStripeEvent(event: unknown): StripeEvent {
+  return STRIPE_EVENT_SCHEMA.parse(camelizeStripeValue(event))
+}
+
+/**
+ * Builds a schema that narrows a verified broad event to one Stripe type.
+ *
+ * @param type - Exact Stripe event name.
+ * @returns Runtime schema for the semantic event.
+ */
+export function stripeSemanticEventSchema<
+  TType extends (typeof STRIPE_SEMANTIC_EVENT_TYPES)[number],
+>(type: TType): z.ZodType<StripeSemanticEvent<TType>> {
+  return z.custom<StripeSemanticEvent<TType>>((value) => {
+    const event = STRIPE_EVENT_SCHEMA.safeParse(value)
+    return event.success && event.data.type === type
+  })
+}
+
+/**
+ * Converts provider object keys recursively while preserving metadata keys.
+ *
+ * @param value - Provider value to normalize.
+ * @returns Public value with camel-cased object keys.
+ */
+function camelizeStripeValue(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(camelizeStripeValue)
+  if (!isPlainRecord(value)) return value
+
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      key.replace(/_([a-z0-9])/g, (_match, character: string) =>
+        character.toUpperCase(),
+      ),
+      key === "metadata" ? item : camelizeStripeValue(item),
+    ]),
+  )
+}
+
+/**
+ * Checks whether a value is a plain record safe for key conversion.
+ *
+ * @param value - Value to inspect.
+ * @returns Whether the value is a plain record.
+ */
+function isPlainRecord(value: unknown): value is Record<string, unknown> {
+  if (value === null || typeof value !== "object") return false
+  const prototype = Object.getPrototypeOf(value)
+  return prototype === null || prototype === Object.prototype
+}

package/src/triggers.ts

@@ -11,9 +11,11 @@ import type { linearTriggerContracts } from "./linear"
 import type { outlookTriggerContracts } from "./outlook"
 import type { resendTriggerContracts } from "./resend"
 import type { slackTriggerContracts } from "./slack"
+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"
 
@@ -30,9 +32,11 @@ export type TriggerContractMap = typeof airtableTriggerContracts &
   typeof outlookTriggerContracts &
   typeof resendTriggerContracts &
   typeof slackTriggerContracts &
+  typeof stripeTriggerContracts &
   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),
+  }
+}