@automate.ax/integration-contracts 0.141.0 → 0.143.0

package/dist/teams/index.d.ts

@@ -33,11 +33,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
             channelId: z.ZodString;
             isArchived: z.ZodPrefault<z.ZodBoolean>;
             membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                standard: "standard";
                 private: "private";
+                standard: "standard";
                 shared: "shared";
                 unknownFutureValue: "unknownFutureValue";
-            }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+            }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
             webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         }, z.core.$strip>;
         resourceId: z.ZodString;
@@ -53,11 +53,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
             channelId: z.ZodString;
             isArchived: z.ZodPrefault<z.ZodBoolean>;
             membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                standard: "standard";
                 private: "private";
+                standard: "standard";
                 shared: "shared";
                 unknownFutureValue: "unknownFutureValue";
-            }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+            }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
             webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         }, z.core.$strip>;
         resourceId: z.ZodString;
@@ -79,11 +79,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
             channelId: z.ZodString;
             isArchived: z.ZodPrefault<z.ZodBoolean>;
             membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                standard: "standard";
                 private: "private";
+                standard: "standard";
                 shared: "shared";
                 unknownFutureValue: "unknownFutureValue";
-            }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+            }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
             webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         }, z.core.$strip>;
         resourceId: z.ZodString;
@@ -100,11 +100,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMAS: {
             channelId: z.ZodString;
             isArchived: z.ZodPrefault<z.ZodBoolean>;
             membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                standard: "standard";
                 private: "private";
+                standard: "standard";
                 shared: "shared";
                 unknownFutureValue: "unknownFutureValue";
-            }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+            }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
             webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         }, z.core.$strip>;
         resourceId: z.ZodString;
@@ -883,11 +883,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodDiscri
         channelId: z.ZodString;
         isArchived: z.ZodPrefault<z.ZodBoolean>;
         membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            standard: "standard";
             private: "private";
+            standard: "standard";
             shared: "shared";
             unknownFutureValue: "unknownFutureValue";
-        }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+        }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
         webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
     }, z.core.$strip>;
     resourceId: z.ZodString;
@@ -903,11 +903,11 @@ export declare const TEAMS_CHANGE_EVENT_SCHEMA: z.ZodUnion<readonly [z.ZodDiscri
         channelId: z.ZodString;
         isArchived: z.ZodPrefault<z.ZodBoolean>;
         membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            standard: "standard";
             private: "private";
+            standard: "standard";
             shared: "shared";
             unknownFutureValue: "unknownFutureValue";
-        }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+        }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
         webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
     }, z.core.$strip>;
     resourceId: z.ZodString;
@@ -1527,11 +1527,11 @@ export declare const teamsTriggerContracts: {
                 channelId: z.ZodString;
                 isArchived: z.ZodPrefault<z.ZodBoolean>;
                 membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    standard: "standard";
                     private: "private";
+                    standard: "standard";
                     shared: "shared";
                     unknownFutureValue: "unknownFutureValue";
-                }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+                }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
                 webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
             }, z.core.$strip>;
             resourceId: z.ZodString;
@@ -1547,11 +1547,11 @@ export declare const teamsTriggerContracts: {
                 channelId: z.ZodString;
                 isArchived: z.ZodPrefault<z.ZodBoolean>;
                 membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    standard: "standard";
                     private: "private";
+                    standard: "standard";
                     shared: "shared";
                     unknownFutureValue: "unknownFutureValue";
-                }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+                }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
                 webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
             }, z.core.$strip>;
             resourceId: z.ZodString;
@@ -1578,11 +1578,11 @@ export declare const teamsTriggerContracts: {
                 channelId: z.ZodString;
                 isArchived: z.ZodPrefault<z.ZodBoolean>;
                 membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    standard: "standard";
                     private: "private";
+                    standard: "standard";
                     shared: "shared";
                     unknownFutureValue: "unknownFutureValue";
-                }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+                }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
                 webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
             }, z.core.$strip>;
             resourceId: z.ZodString;
@@ -1604,11 +1604,11 @@ export declare const teamsTriggerContracts: {
                 channelId: z.ZodString;
                 isArchived: z.ZodPrefault<z.ZodBoolean>;
                 membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    standard: "standard";
                     private: "private";
+                    standard: "standard";
                     shared: "shared";
                     unknownFutureValue: "unknownFutureValue";
-                }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+                }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
                 webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
             }, z.core.$strip>;
             resourceId: z.ZodString;

package/dist/teams/schemas.d.ts

@@ -56,11 +56,11 @@ export declare const TEAMS_CHANNEL_SCHEMA: z.ZodObject<{
     channelId: z.ZodString;
     isArchived: z.ZodPrefault<z.ZodBoolean>;
     membershipType: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        standard: "standard";
         private: "private";
+        standard: "standard";
         shared: "shared";
         unknownFutureValue: "unknownFutureValue";
-    }>>>, z.ZodTransform<"standard" | "private" | "shared" | "unknownFutureValue" | undefined, "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined>>;
+    }>>>, z.ZodTransform<"private" | "standard" | "shared" | "unknownFutureValue" | undefined, "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined>>;
     webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
 }, z.core.$strip>;
 export declare const GRAPH_CHANNEL_SCHEMA: z.ZodPipe<z.ZodObject<{
@@ -71,8 +71,8 @@ export declare const GRAPH_CHANNEL_SCHEMA: z.ZodPipe<z.ZodObject<{
     id: z.ZodString;
     isArchived: z.ZodOptional<z.ZodBoolean>;
     membershipType: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        standard: "standard";
         private: "private";
+        standard: "standard";
         shared: "shared";
         unknownFutureValue: "unknownFutureValue";
     }>>>;
@@ -84,7 +84,7 @@ export declare const GRAPH_CHANNEL_SCHEMA: z.ZodPipe<z.ZodObject<{
     email: string | undefined;
     channelId: string;
     isArchived: boolean;
-    membershipType: "standard" | "private" | "shared" | "unknownFutureValue" | undefined;
+    membershipType: "private" | "standard" | "shared" | "unknownFutureValue" | undefined;
     webUrl: string | undefined;
 }, {
     [x: string]: unknown;
@@ -94,7 +94,7 @@ export declare const GRAPH_CHANNEL_SCHEMA: z.ZodPipe<z.ZodObject<{
     description?: string | null | undefined;
     email?: string | null | undefined;
     isArchived?: boolean | undefined;
-    membershipType?: "standard" | "private" | "shared" | "unknownFutureValue" | null | undefined;
+    membershipType?: "private" | "standard" | "shared" | "unknownFutureValue" | null | undefined;
     webUrl?: string | null | undefined;
 }>>;
 export declare const TEAMS_MEMBER_SCHEMA: z.ZodObject<{

package/dist/triggers.d.ts

@@ -9,12 +9,14 @@ import type { convexTriggerContracts } from "./convex/index.js";
 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 { githubTriggerContracts } from "./github/index.js";
 import type { gmailTriggerContracts } from "./gmail/index.js";
 import type { googleCalendarTriggerContracts } from "./google-calendar/index.js";
 import type { googleDriveTriggerContracts } from "./google-drive/index.js";
 import type { googleFormsTriggerContracts } from "./google-forms/index.js";
 import type { googleMeetTriggerContracts } from "./google-meet/index.js";
+import type { googleAdsTriggerContracts } from "./google-ads/index.js";
 import type { googleSheetsTriggerContracts } from "./google-sheets/index.js";
 import type { hubspotTriggerContracts } from "./hubspot/index.js";
 import type { linearTriggerContracts } from "./linear/index.js";
@@ -32,7 +34,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 cloudflareTriggerContracts & typeof githubTriggerContracts & typeof gmailTriggerContracts & typeof googleCalendarTriggerContracts & typeof googleDriveTriggerContracts & typeof googleFormsTriggerContracts & typeof googleMeetTriggerContracts & 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 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.141.0",
+  "version": "0.143.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -24,6 +24,7 @@
       "./automate": "./src/automate/index.ts",
       "./axiom": "./src/axiom/index.ts",
       "./asana": "./src/asana/index.ts",
+      "./clickup": "./src/clickup/index.ts",
       "./brevo": "./src/brevo/index.ts",
       "./cloudflare": "./src/cloudflare/index.ts",
       "./meta-ads": "./src/meta-ads/index.ts",
@@ -36,6 +37,7 @@
       "./google-drive": "./src/google-drive/index.ts",
       "./google-forms": "./src/google-forms/index.ts",
       "./google-meet": "./src/google-meet/index.ts",
+      "./google-ads": "./src/google-ads/index.ts",
       "./google-sheets": "./src/google-sheets/index.ts",
       "./github": "./src/github/index.ts",
       "./hubspot": "./src/hubspot/index.ts",
@@ -63,7 +65,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.141.0",
+    "@automate.ax/codec": "0.143.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -84,7 +86,7 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@internal/config": "0.2.0",
+    "@internal/config": "0.3.0",
     "@types/bun": "latest",
     "@types/html-to-text": "^9.0.4",
     "@types/nodemailer": "^8.0.1",
@@ -146,6 +148,11 @@
       "types": "./dist/asana/index.d.ts",
       "default": "./dist/asana/index.js"
     },
+    "./clickup": {
+      "bun": "./src/clickup/index.ts",
+      "types": "./dist/clickup/index.d.ts",
+      "default": "./dist/clickup/index.js"
+    },
     "./brevo": {
       "bun": "./src/brevo/index.ts",
       "types": "./dist/brevo/index.d.ts",
@@ -206,6 +213,11 @@
       "types": "./dist/google-meet/index.d.ts",
       "default": "./dist/google-meet/index.js"
     },
+    "./google-ads": {
+      "bun": "./src/google-ads/index.ts",
+      "types": "./dist/google-ads/index.d.ts",
+      "default": "./dist/google-ads/index.js"
+    },
     "./google-sheets": {
       "bun": "./src/google-sheets/index.ts",
       "types": "./dist/google-sheets/index.d.ts",

package/src/clickup/api.ts

@@ -0,0 +1,270 @@
+import { encodableSchema, type Encodable } from "@automate.ax/codec"
+import * as z from "zod"
+
+const CLICKUP_API_BASE_URL = "https://api.clickup.com/api/v2/"
+const CLICKUP_API_ORIGIN = new URL(CLICKUP_API_BASE_URL).origin
+const CLICKUP_OAUTH_SECRET_SCHEMA = z.object({ accessToken: z.string().min(1) })
+const CLICKUP_TOKEN_SECRET_SCHEMA = z.object({ apiKey: z.string().min(1) })
+
+/** Resolved ClickUp account accepted by the shared API client. */
+export interface ClickUpResolvedAccount {
+  connectionMethodId: string
+  secret: Record<string, unknown>
+  serviceId: "clickup"
+}
+
+/** Scalar value serialized into one ClickUp query parameter. */
+export type ClickUpQueryValue =
+  | boolean
+  | number
+  | readonly (number | string)[]
+  | string
+  | undefined
+
+/** Options for one authenticated ClickUp REST request. */
+export interface ClickUpRequestOptions<TSchema extends z.ZodType> {
+  /** Public camelCase JSON body. */
+  body?: Encodable
+
+  /** HTTP verb. Defaults to `GET`. */
+  method?: "DELETE" | "GET" | "POST" | "PUT"
+
+  /** Public camelCase query parameters. */
+  query?: Record<string, ClickUpQueryValue>
+
+  /** Schema for the normalized provider response. */
+  responseSchema: TSchema
+}
+
+/** Authenticated ClickUp REST API helper for packaged actions. */
+export interface ClickUpApi {
+  /**
+   * Calls a ClickUp API v2 endpoint and validates its normalized response.
+   *
+   * @param path - API path relative to `/api/v2/`.
+   * @param options - Request data and response schema.
+   */
+  request<TSchema extends z.ZodType>(
+    path: string,
+    options: ClickUpRequestOptions<TSchema>,
+  ): Promise<z.output<TSchema>>
+}
+
+/** Structured ClickUp REST error. */
+export class ClickUpApiError extends Error {
+  /** Normalized provider error payload, when it was valid JSON. */
+  readonly body?: Encodable
+
+  /** API path that failed. */
+  readonly path: string
+
+  /** Unix timestamp in seconds when the current rate-limit window resets. */
+  readonly rateLimitReset?: number
+
+  /** HTTP status returned by ClickUp. */
+  readonly status: number
+
+  /**
+   * Creates a structured ClickUp API error.
+   *
+   * @param options - Provider and transport error details.
+   * @param options.body - Normalized provider error payload.
+   * @param options.path - API path that failed.
+   * @param options.rateLimitReset - Unix reset timestamp in seconds.
+   * @param options.status - HTTP response status.
+   */
+  constructor(options: {
+    body?: Encodable
+    path: string
+    rateLimitReset?: number
+    status: number
+  }) {
+    super(
+      getErrorMessage(options.body) ??
+        `ClickUp API request failed with status ${options.status}.`,
+    )
+    this.name = "ClickUpApiError"
+    this.body = options.body
+    this.path = options.path
+    this.rateLimitReset = options.rateLimitReset
+    this.status = options.status
+  }
+}
+
+/**
+ * Creates an authenticated ClickUp API v2 client.
+ *
+ * @param account - Resolved ClickUp integration account.
+ * @throws When the account uses an unsupported connection method.
+ */
+export function getClickUpApi(account: ClickUpResolvedAccount): ClickUpApi {
+  const accessToken: string =
+    account.connectionMethodId === "oauth"
+      ? CLICKUP_OAUTH_SECRET_SCHEMA.parse(account.secret).accessToken
+      : account.connectionMethodId === "personal-token"
+        ? CLICKUP_TOKEN_SECRET_SCHEMA.parse(account.secret).apiKey
+        : ""
+  if (!accessToken) {
+    throw new Error(
+      `Unsupported ClickUp connection method: ${account.connectionMethodId}`,
+    )
+  }
+
+  return {
+    request: async <TSchema extends z.ZodType>(
+      path: string,
+      options: ClickUpRequestOptions<TSchema>,
+    ): Promise<z.output<TSchema>> => {
+      const normalizedPath = path.replace(/^\/+/, "")
+      const url = new URL(normalizedPath, CLICKUP_API_BASE_URL)
+      const expectedPathname = `/api/v2/${normalizedPath}`
+      if (
+        url.origin !== CLICKUP_API_ORIGIN ||
+        url.pathname !== expectedPathname
+      ) {
+        throw new Error("ClickUp API paths must remain under /api/v2.")
+      }
+      for (const [name, value] of Object.entries(options.query ?? {})) {
+        if (value === undefined) continue
+        const wireName = toSnakeCase(name)
+        if (Array.isArray(value)) {
+          for (const item of value)
+            url.searchParams.append(`${wireName}[]`, String(item))
+        } else {
+          url.searchParams.set(wireName, String(value))
+        }
+      }
+
+      const response = await fetch(url, {
+        body:
+          options.body === undefined
+            ? undefined
+            : JSON.stringify(toClickUp(options.body)),
+        headers: {
+          Accept: "application/json",
+          Authorization:
+            account.connectionMethodId === "oauth"
+              ? `Bearer ${accessToken}`
+              : accessToken,
+          ...(options.body === undefined
+            ? {}
+            : { "Content-Type": "application/json" }),
+        },
+        method: options.method ?? "GET",
+      })
+      const responseText = await response.text()
+      const normalized =
+        responseText === "" ? undefined : fromClickUp(parseJson(responseText))
+      if (!response.ok) {
+        const body = encodableSchema.safeParse(normalized)
+        throw new ClickUpApiError({
+          ...(body.success && { body: body.data }),
+          path: `/${normalizedPath}`,
+          rateLimitReset: parseFiniteNumber(
+            response.headers.get("X-RateLimit-Reset"),
+          ),
+          status: response.status,
+        })
+      }
+      return options.responseSchema.parse(normalized)
+    },
+  }
+}
+
+/**
+ * Converts public camelCase JSON to ClickUp wire keys.
+ *
+ * @param value - Public JSON value.
+ */
+export function toClickUp(value: Encodable): Encodable {
+  if (value instanceof Date) return value.toISOString()
+  if (Array.isArray(value)) return value.map(toClickUp)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      toSnakeCase(key),
+      toClickUp(item),
+    ]),
+  )
+}
+
+/**
+ * Converts ClickUp response keys to public camelCase recursively.
+ *
+ * @param value - Provider response value.
+ */
+export function fromClickUp(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(fromClickUp)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      toCamelCase(key),
+      fromClickUp(item),
+    ]),
+  )
+}
+
+/**
+ * Returns whether a value is a non-array object.
+ *
+ * @param value - Candidate value.
+ */
+function isPlainObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value)
+}
+
+/**
+ * Parses JSON without masking the provider's response status.
+ *
+ * @param value - Raw response text.
+ */
+function parseJson(value: string): unknown {
+  try {
+    return JSON.parse(value)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * Parses a finite number from an optional response header.
+ *
+ * @param value - Raw response header.
+ */
+function parseFiniteNumber(value: string | null) {
+  if (value === null) return undefined
+  const number = Number(value)
+  return Number.isFinite(number) ? number : undefined
+}
+
+/**
+ * Reads ClickUp's human-readable error message from a response body.
+ *
+ * @param body - Normalized provider response body.
+ */
+function getErrorMessage(body: Encodable | undefined) {
+  if (!isPlainObject(body)) return undefined
+  if (typeof body.err === "string") return body.err
+  if (typeof body.message === "string") return body.message
+  return undefined
+}
+
+/**
+ * Converts one camelCase key to ClickUp's snake_case wire format.
+ *
+ * @param value - Public key.
+ */
+function toSnakeCase(value: string) {
+  return value.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+}
+
+/**
+ * Converts one ClickUp snake_case key to camelCase.
+ *
+ * @param value - Provider wire key.
+ */
+function toCamelCase(value: string) {
+  return value.replace(/_([a-z0-9])/g, (_match, letter: string) =>
+    letter.toUpperCase(),
+  )
+}

package/src/clickup/index.ts

@@ -0,0 +1,108 @@
+export * from "./api"
+export * from "./schemas"
+
+import * as z from "zod"
+import {
+  CLICKUP_TRIGGER_CONFIG_SCHEMA,
+  CLICKUP_WEBHOOK_EVENT_SCHEMA,
+} from "./schemas"
+
+export const CLICKUP_EVENT_TYPE_BY_PROVIDER_EVENT = {
+  folderCreated: "clickup.folder.created",
+  folderDeleted: "clickup.folder.deleted",
+  folderUpdated: "clickup.folder.updated",
+  goalCreated: "clickup.goal.created",
+  goalDeleted: "clickup.goal.deleted",
+  goalUpdated: "clickup.goal.updated",
+  keyResultCreated: "clickup.target.created",
+  keyResultDeleted: "clickup.target.deleted",
+  keyResultUpdated: "clickup.target.updated",
+  listCreated: "clickup.list.created",
+  listDeleted: "clickup.list.deleted",
+  listUpdated: "clickup.list.updated",
+  spaceCreated: "clickup.space.created",
+  spaceDeleted: "clickup.space.deleted",
+  spaceUpdated: "clickup.space.updated",
+  taskAssigneeUpdated: "clickup.task.assignee.updated",
+  taskCommentPosted: "clickup.task.comment.posted",
+  taskCommentUpdated: "clickup.task.comment.updated",
+  taskCreated: "clickup.task.created",
+  taskDeleted: "clickup.task.deleted",
+  taskDueDateUpdated: "clickup.task.due-date.updated",
+  taskMoved: "clickup.task.moved",
+  taskPriorityUpdated: "clickup.task.priority.updated",
+  taskStatusUpdated: "clickup.task.status.updated",
+  taskTagUpdated: "clickup.task.tag.updated",
+  taskTimeEstimateUpdated: "clickup.task.time-estimate.updated",
+  taskTimeTrackedUpdated: "clickup.task.time-tracked.updated",
+  taskUpdated: "clickup.task.updated",
+} as const
+
+/**
+ * Narrows the shared webhook payload to one provider event name.
+ *
+ * @param event - ClickUp provider event name.
+ */
+function semanticEventSchema<
+  const TEvent extends keyof typeof CLICKUP_EVENT_TYPE_BY_PROVIDER_EVENT,
+>(event: TEvent) {
+  return CLICKUP_WEBHOOK_EVENT_SCHEMA.extend({ event: z.literal(event) })
+}
+
+/**
+ * Creates one semantic ClickUp trigger contract.
+ *
+ * @param event - ClickUp provider event name.
+ */
+function semanticContract<
+  const TEvent extends keyof typeof CLICKUP_EVENT_TYPE_BY_PROVIDER_EVENT,
+>(event: TEvent) {
+  return {
+    configSchema: CLICKUP_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: semanticEventSchema(event),
+  }
+}
+
+export const clickUpTriggerContracts = {
+  "clickup.workspace.event": {
+    configSchema: CLICKUP_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: CLICKUP_WEBHOOK_EVENT_SCHEMA,
+  },
+  "clickup.folder.created": semanticContract("folderCreated"),
+  "clickup.folder.deleted": semanticContract("folderDeleted"),
+  "clickup.folder.updated": semanticContract("folderUpdated"),
+  "clickup.goal.created": semanticContract("goalCreated"),
+  "clickup.goal.deleted": semanticContract("goalDeleted"),
+  "clickup.goal.updated": semanticContract("goalUpdated"),
+  "clickup.list.created": semanticContract("listCreated"),
+  "clickup.list.deleted": semanticContract("listDeleted"),
+  "clickup.list.updated": semanticContract("listUpdated"),
+  "clickup.space.created": semanticContract("spaceCreated"),
+  "clickup.space.deleted": semanticContract("spaceDeleted"),
+  "clickup.space.updated": semanticContract("spaceUpdated"),
+  "clickup.target.created": semanticContract("keyResultCreated"),
+  "clickup.target.deleted": semanticContract("keyResultDeleted"),
+  "clickup.target.updated": semanticContract("keyResultUpdated"),
+  "clickup.task.assignee.updated": semanticContract("taskAssigneeUpdated"),
+  "clickup.task.comment.posted": semanticContract("taskCommentPosted"),
+  "clickup.task.comment.updated": semanticContract("taskCommentUpdated"),
+  "clickup.task.created": semanticContract("taskCreated"),
+  "clickup.task.deleted": semanticContract("taskDeleted"),
+  "clickup.task.due-date.updated": semanticContract("taskDueDateUpdated"),
+  "clickup.task.moved": semanticContract("taskMoved"),
+  "clickup.task.priority.updated": semanticContract("taskPriorityUpdated"),
+  "clickup.task.status.updated": semanticContract("taskStatusUpdated"),
+  "clickup.task.tag.updated": semanticContract("taskTagUpdated"),
+  "clickup.task.time-estimate.updated": semanticContract(
+    "taskTimeEstimateUpdated",
+  ),
+  "clickup.task.time-tracked.updated": semanticContract(
+    "taskTimeTrackedUpdated",
+  ),
+  "clickup.task.updated": semanticContract("taskUpdated"),
+} as const
+
+export const CLICKUP_EVENT_TYPES = [
+  "clickup.workspace.event",
+  ...Object.values(CLICKUP_EVENT_TYPE_BY_PROVIDER_EVENT),
+] as const