@automate.ax/integration-contracts 0.143.8 → 0.144.0

package/dist/slack/schemas.d.ts

@@ -109,8 +109,8 @@ export declare const SLACK_MESSAGE_SCHEMA: z.ZodObject<{
 export declare const SLACK_REACTION_ITEM_SCHEMA: z.ZodDiscriminatedUnion<[z.ZodObject<{
     conversationId: z.ZodString;
     conversationType: z.ZodOptional<z.ZodEnum<{
-        channel: "channel";
         group: "group";
+        channel: "channel";
         im: "im";
         mpim: "mpim";
     }>>;

package/dist/teams/index.d.ts

@@ -560,8 +560,8 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
         changeType: z.ZodLiteral<"updated">;
         data: z.ZodObject<{
             chatType: z.ZodEnum<{
-                meeting: "meeting";
                 group: "group";
+                meeting: "meeting";
                 unknownFutureValue: "unknownFutureValue";
                 oneOnOne: "oneOnOne";
             }>;
@@ -580,8 +580,8 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
         changeType: z.ZodLiteral<"updated">;
         data: z.ZodObject<{
             chatType: z.ZodEnum<{
-                meeting: "meeting";
                 group: "group";
+                meeting: "meeting";
                 unknownFutureValue: "unknownFutureValue";
                 oneOnOne: "oneOnOne";
             }>;
@@ -1172,8 +1172,8 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodDiscri
     changeType: z.ZodLiteral<"updated">;
     data: z.ZodObject<{
         chatType: z.ZodEnum<{
-            meeting: "meeting";
             group: "group";
+            meeting: "meeting";
             unknownFutureValue: "unknownFutureValue";
             oneOnOne: "oneOnOne";
         }>;
@@ -2151,8 +2151,8 @@ export declare const teamsTriggerContracts: {
             changeType: z.ZodLiteral<"updated">;
             data: z.ZodObject<{
                 chatType: z.ZodEnum<{
-                    meeting: "meeting";
                     group: "group";
+                    meeting: "meeting";
                     unknownFutureValue: "unknownFutureValue";
                     oneOnOne: "oneOnOne";
                 }>;
@@ -2176,8 +2176,8 @@ export declare const teamsTriggerContracts: {
             changeType: z.ZodLiteral<"updated">;
             data: z.ZodObject<{
                 chatType: z.ZodEnum<{
-                    meeting: "meeting";
                     group: "group";
+                    meeting: "meeting";
                     unknownFutureValue: "unknownFutureValue";
                     oneOnOne: "oneOnOne";
                 }>;

package/dist/teams/schemas.d.ts

@@ -134,8 +134,8 @@ export declare const GRAPH_MEMBER_SCHEMA: z.ZodPipe<z.ZodObject<{
 }>>;
 export declare const TEAMS_CHAT_SCHEMA: z.ZodObject<{
     chatType: z.ZodEnum<{
-        meeting: "meeting";
         group: "group";
+        meeting: "meeting";
         unknownFutureValue: "unknownFutureValue";
         oneOnOne: "oneOnOne";
     }>;
@@ -148,8 +148,8 @@ export declare const TEAMS_CHAT_SCHEMA: z.ZodObject<{
 }, z.core.$strip>;
 export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     chatType: z.ZodEnum<{
-        meeting: "meeting";
         group: "group";
+        meeting: "meeting";
         unknownFutureValue: "unknownFutureValue";
         oneOnOne: "oneOnOne";
     }>;
@@ -160,7 +160,7 @@ export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     webUrl: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$loose>, z.ZodTransform<{
-    chatType: "meeting" | "group" | "unknownFutureValue" | "oneOnOne";
+    chatType: "group" | "meeting" | "unknownFutureValue" | "oneOnOne";
     createdAt: Date | undefined;
     chatId: string;
     updatedAt: Date | undefined;
@@ -169,7 +169,7 @@ export declare const GRAPH_CHAT_SCHEMA: z.ZodPipe<z.ZodObject<{
     webUrl: string | undefined;
 }, {
     [x: string]: unknown;
-    chatType: "meeting" | "group" | "unknownFutureValue" | "oneOnOne";
+    chatType: "group" | "meeting" | "unknownFutureValue" | "oneOnOne";
     id: string;
     createdDateTime?: string | null | undefined;
     lastUpdatedDateTime?: string | null | undefined;

package/dist/trello/schemas.d.ts

@@ -32,8 +32,8 @@ export declare const TRELLO_BOARD_MEMBERSHIP_SCHEMA: z.ZodObject<{
     id: z.ZodString;
     memberId: z.ZodString;
     memberType: z.ZodEnum<{
-        normal: "normal";
         admin: "admin";
+        normal: "normal";
         observer: "observer";
     }>;
     unconfirmed: z.ZodBoolean;
@@ -230,8 +230,8 @@ export declare const TRELLO_PROVIDER_BOARD_MEMBERSHIP_SCHEMA: z.ZodObject<{
     id: z.ZodString;
     idMember: z.ZodString;
     memberType: z.ZodEnum<{
-        normal: "normal";
         admin: "admin";
+        normal: "normal";
         observer: "observer";
     }>;
     unconfirmed: z.ZodBoolean;

package/dist/triggers.d.ts

@@ -10,6 +10,7 @@ import type { discordTriggerContracts } from "./discord/index.js";
 import type { closeTriggerContracts } from "./close/index.js";
 import type { cloudflareTriggerContracts } from "./cloudflare/index.js";
 import type { clickUpTriggerContracts } from "./clickup/index.js";
+import type { calendlyTriggerContracts } from "./calendly/index.js";
 import type { githubTriggerContracts } from "./github/index.js";
 import type { gmailTriggerContracts } from "./gmail/index.js";
 import type { googleCalendarTriggerContracts } from "./google-calendar/index.js";
@@ -34,7 +35,7 @@ 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 anthropicTriggerContracts & typeof apifyTriggerContracts & typeof axiomTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof discordTriggerContracts & typeof closeTriggerContracts & typeof clickUpTriggerContracts & typeof cloudflareTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleDriveTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof googleAdsTriggerContracts & typeof googleSheetsTriggerContracts & typeof hubspotTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof metaAdsTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof trelloTriggerContracts & typeof vercelTriggerContracts & typeof webflowTriggerContracts & typeof whatsappTriggerContracts;
+export type TriggerContractMap = typeof airtableTriggerContracts & typeof anthropicTriggerContracts & typeof apifyTriggerContracts & typeof axiomTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & typeof discordTriggerContracts & typeof closeTriggerContracts & typeof clickUpTriggerContracts & typeof calendlyTriggerContracts & typeof cloudflareTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleDriveTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & typeof googleAdsTriggerContracts & typeof googleSheetsTriggerContracts & typeof hubspotTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof metaAdsTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.143.8",
+  "version": "0.144.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -25,6 +25,7 @@
       "./axiom": "./src/axiom/index.ts",
       "./asana": "./src/asana/index.ts",
       "./clickup": "./src/clickup/index.ts",
+      "./calendly": "./src/calendly/index.ts",
       "./brevo": "./src/brevo/index.ts",
       "./cloudflare": "./src/cloudflare/index.ts",
       "./meta-ads": "./src/meta-ads/index.ts",
@@ -65,7 +66,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.143.8",
+    "@automate.ax/codec": "0.144.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -153,6 +154,11 @@
       "types": "./dist/clickup/index.d.ts",
       "default": "./dist/clickup/index.js"
     },
+    "./calendly": {
+      "bun": "./src/calendly/index.ts",
+      "types": "./dist/calendly/index.d.ts",
+      "default": "./dist/calendly/index.js"
+    },
     "./brevo": {
       "bun": "./src/brevo/index.ts",
       "types": "./dist/brevo/index.d.ts",

package/src/calendly/api.ts

@@ -0,0 +1,216 @@
+import type { Encodable } from "@automate.ax/codec"
+import { encodableSchema } from "@automate.ax/codec"
+import * as z from "zod"
+
+const CALENDLY_API_BASE_URL = "https://api.calendly.com/"
+const CALENDLY_API_ORIGIN = new URL(CALENDLY_API_BASE_URL).origin
+const CALENDLY_OAUTH_SECRET_SCHEMA = z.object({
+  accessToken: z.string().min(1),
+})
+
+/** Resolved Calendly OAuth account accepted by the shared API client. */
+export interface CalendlyResolvedAccount {
+  connectionMethodId: string
+  secret: Record<string, unknown>
+  serviceId: "calendly"
+}
+
+/** Options for one authenticated Calendly REST request. */
+export interface CalendlyRequestOptions<TSchema extends z.ZodType> {
+  body?: Encodable
+  method?: "DELETE" | "GET" | "PATCH" | "POST"
+  query?: Record<string, boolean | number | string | undefined>
+  responseSchema: TSchema
+}
+
+/** Structured Calendly REST error. */
+export class CalendlyApiError extends Error {
+  readonly body?: Encodable
+  readonly rateLimitReset?: number
+  readonly status: number
+
+  /**
+   * Creates a structured Calendly API error.
+   *
+   * @param options - Provider response details.
+   * @param options.body - Parsed provider error body.
+   * @param options.rateLimitReset - Provider retry delay, in seconds.
+   * @param options.status - HTTP response status.
+   */
+  constructor(options: {
+    body?: Encodable
+    rateLimitReset?: number
+    status: number
+  }) {
+    super(
+      getErrorMessage(options.body) ??
+        `Calendly API request failed with status ${options.status}.`,
+    )
+    this.name = "CalendlyApiError"
+    this.body = options.body
+    this.rateLimitReset = options.rateLimitReset
+    this.status = options.status
+  }
+}
+
+/**
+ * Creates an authenticated Calendly REST client.
+ *
+ * @param account - Resolved Calendly OAuth account.
+ * @throws When the account method or secret is invalid.
+ */
+export function getCalendlyApi(account: CalendlyResolvedAccount) {
+  if (account.connectionMethodId !== "oauth") {
+    throw new Error(
+      `Unsupported Calendly connection method: ${account.connectionMethodId}`,
+    )
+  }
+  const { accessToken } = CALENDLY_OAUTH_SECRET_SCHEMA.parse(account.secret)
+
+  /**
+   * Calls one Calendly endpoint and validates the response.
+   *
+   * @param path - Calendly API path.
+   * @param options - Request options and response schema.
+   */
+  async function request<TSchema extends z.ZodType>(
+    path: string,
+    options: CalendlyRequestOptions<TSchema>,
+  ): Promise<z.output<TSchema>> {
+    const url = new URL(path.replace(/^\//, ""), CALENDLY_API_BASE_URL)
+    if (url.origin !== CALENDLY_API_ORIGIN) {
+      throw new Error("Calendly API paths must use the Calendly API origin.")
+    }
+    for (const [name, value] of Object.entries(options.query ?? {})) {
+      if (value !== undefined)
+        url.searchParams.set(toSnakeCase(name), String(value))
+    }
+    const response = await fetch(url, {
+      body:
+        options.body === undefined
+          ? undefined
+          : JSON.stringify(toCalendly(options.body)),
+      headers: {
+        Accept: "application/json",
+        Authorization: `Bearer ${accessToken}`,
+        ...(options.body === undefined
+          ? {}
+          : { "Content-Type": "application/json" }),
+      },
+      method: options.method ?? "GET",
+    })
+    const text = await response.text()
+    const normalized = text ? fromCalendly(parseJson(text)) : undefined
+    if (!response.ok) {
+      const body = encodableSchema.safeParse(normalized)
+      throw new CalendlyApiError({
+        ...(body.success && { body: body.data }),
+        rateLimitReset: parseFiniteNumber(
+          response.headers.get("X-RateLimit-Reset"),
+        ),
+        status: response.status,
+      })
+    }
+    return options.responseSchema.parse(normalized)
+  }
+
+  return { request }
+}
+
+/**
+ * Converts public camelCase JSON to Calendly wire keys.
+ *
+ * @param value - Public action input.
+ */
+export function toCalendly(value: Encodable): Encodable {
+  if (value instanceof Date) return value.toISOString()
+  if (Array.isArray(value)) return value.map(toCalendly)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      toSnakeCase(key),
+      toCalendly(item),
+    ]),
+  )
+}
+
+/**
+ * Converts Calendly wire JSON to public camelCase keys.
+ *
+ * @param value - Parsed Calendly response value.
+ */
+export function fromCalendly(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(fromCalendly)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      toCamelCase(key),
+      fromCalendly(item),
+    ]),
+  )
+}
+
+/**
+ * Whether a value can be traversed as a plain JSON object.
+ *
+ * @param value - Candidate JSON value.
+ */
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+/**
+ * Parses a provider body without masking its HTTP failure.
+ *
+ * @param value - Provider response body.
+ */
+function parseJson(value: string): unknown {
+  try {
+    return JSON.parse(value)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * Parses a finite numeric response header.
+ *
+ * @param value - Response header value.
+ */
+function parseFiniteNumber(value: string | null) {
+  if (value === null) return undefined
+  const number = Number(value)
+  return Number.isFinite(number) ? number : undefined
+}
+
+/**
+ * Extracts Calendly's human-readable error message.
+ *
+ * @param body - Parsed provider error body.
+ */
+function getErrorMessage(body: Encodable | undefined) {
+  if (!isPlainObject(body)) return undefined
+  if (typeof body.message === "string") return body.message
+  if (typeof body.title === "string") return body.title
+  return undefined
+}
+
+/**
+ * Converts one public field name to Calendly's wire convention.
+ *
+ * @param value - Public field name.
+ */
+function toSnakeCase(value: string) {
+  return value.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+}
+
+/**
+ * Converts one Calendly wire field name to the public convention.
+ *
+ * @param value - Calendly wire field name.
+ */
+function toCamelCase(value: string) {
+  return value.replace(/_([a-z0-9])/g, (_, letter: string) =>
+    letter.toUpperCase(),
+  )
+}

package/src/calendly/index.ts

@@ -0,0 +1,69 @@
+export * from "./api"
+export * from "./schemas"
+
+import * as z from "zod"
+import {
+  CALENDLY_ORGANIZATION_TRIGGER_CONFIG_SCHEMA,
+  CALENDLY_PROVIDER_EVENT_NAMES,
+  CALENDLY_TRIGGER_CONFIG_SCHEMA,
+  CALENDLY_WEBHOOK_EVENT_SCHEMA,
+} from "./schemas"
+
+export const CALENDLY_EVENT_TYPE_BY_PROVIDER_EVENT = {
+  "event_type.created": "calendly.event-type.created",
+  "event_type.deleted": "calendly.event-type.deleted",
+  "event_type.updated": "calendly.event-type.updated",
+  "invitee.canceled": "calendly.invitee.canceled",
+  "invitee.created": "calendly.invitee.created",
+  "invitee_no_show.created": "calendly.invitee-no-show.created",
+  "invitee_no_show.deleted": "calendly.invitee-no-show.deleted",
+  "routing_form_submission.created": "calendly.routing-form-submission.created",
+} as const satisfies Record<
+  (typeof CALENDLY_PROVIDER_EVENT_NAMES)[number],
+  string
+>
+
+/**
+ * Builds a semantic contract for one Calendly provider event.
+ *
+ * @param event - Calendly provider event name.
+ */
+function semanticContract<
+  const TEvent extends keyof typeof CALENDLY_EVENT_TYPE_BY_PROVIDER_EVENT,
+>(event: TEvent) {
+  return {
+    configSchema: CALENDLY_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CALENDLY_WEBHOOK_EVENT_SCHEMA.and(
+      z.object({ event: z.literal(event) }),
+    ),
+  }
+}
+
+export const calendlyTriggerContracts = {
+  "calendly.scheduling.event": {
+    configSchema: CALENDLY_ORGANIZATION_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CALENDLY_WEBHOOK_EVENT_SCHEMA,
+  },
+  "calendly.event-type.created": semanticContract("event_type.created"),
+  "calendly.event-type.deleted": semanticContract("event_type.deleted"),
+  "calendly.event-type.updated": semanticContract("event_type.updated"),
+  "calendly.invitee.canceled": semanticContract("invitee.canceled"),
+  "calendly.invitee.created": semanticContract("invitee.created"),
+  "calendly.invitee-no-show.created": semanticContract(
+    "invitee_no_show.created",
+  ),
+  "calendly.invitee-no-show.deleted": semanticContract(
+    "invitee_no_show.deleted",
+  ),
+  "calendly.routing-form-submission.created": {
+    configSchema: CALENDLY_ORGANIZATION_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CALENDLY_WEBHOOK_EVENT_SCHEMA.and(
+      z.object({ event: z.literal("routing_form_submission.created") }),
+    ),
+  },
+} as const
+
+export const CALENDLY_EVENT_TYPES = [
+  "calendly.scheduling.event",
+  ...Object.values(CALENDLY_EVENT_TYPE_BY_PROVIDER_EVENT),
+] as const