@automate.ax/integration-contracts 0.151.0 → 0.152.0

package/dist/triggers.d.ts

@@ -8,6 +8,7 @@ import type { brevoTriggerContracts } from "./brevo/index.js";
 import type { calcomTriggerContracts } from "./calcom/index.js";
 import type { convexTriggerContracts } from "./convex/index.js";
 import type { discordTriggerContracts } from "./discord/index.js";
+import type { elevenLabsTriggerContracts } from "./elevenlabs/index.js";
 import type { closeTriggerContracts } from "./close/index.js";
 import type { cloudflareTriggerContracts } from "./cloudflare/index.js";
 import type { clickUpTriggerContracts } from "./clickup/index.js";
@@ -39,7 +40,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 calcomTriggerContracts & 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 highLevelTriggerContracts & typeof kitTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof metaAdsTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof tallyTriggerContracts & 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 calcomTriggerContracts & typeof convexTriggerContracts & typeof discordTriggerContracts & typeof elevenLabsTriggerContracts & 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 highLevelTriggerContracts & typeof kitTriggerContracts & typeof linearTriggerContracts & typeof millionVerifierTriggerContracts & typeof metaAdsTriggerContracts & typeof notionTriggerContracts & typeof outlookTriggerContracts & typeof redditTriggerContracts & typeof resendTriggerContracts & typeof slackTriggerContracts & typeof stripeTriggerContracts & typeof teamsTriggerContracts & typeof tallyTriggerContracts & 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.151.0",
+  "version": "0.152.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -33,6 +33,7 @@
       "./meta-ads": "./src/meta-ads/index.ts",
       "./convex": "./src/convex/index.ts",
       "./discord": "./src/discord/index.ts",
+      "./elevenlabs": "./src/elevenlabs/index.ts",
       "./close": "./src/close/index.ts",
       "./closebot": "./src/closebot/index.ts",
       "./gmail": "./src/gmail/index.ts",
@@ -71,7 +72,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.151.0",
+    "@automate.ax/codec": "0.152.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -203,6 +204,11 @@
       "types": "./dist/discord/index.d.ts",
       "default": "./dist/discord/index.js"
     },
+    "./elevenlabs": {
+      "bun": "./src/elevenlabs/index.ts",
+      "types": "./dist/elevenlabs/index.d.ts",
+      "default": "./dist/elevenlabs/index.js"
+    },
     "./close": {
       "bun": "./src/close/index.ts",
       "types": "./dist/close/index.d.ts",

package/src/elevenlabs/api.ts

@@ -0,0 +1,341 @@
+import type { Encodable } from "@automate.ax/codec"
+import { encodableSchema } from "@automate.ax/codec"
+import * as z from "zod"
+
+const ELEVENLABS_API_BASE_URL = "https://api.elevenlabs.io/"
+const ELEVENLABS_API_ORIGIN = new URL(ELEVENLABS_API_BASE_URL).origin
+const ELEVENLABS_SECRET_SCHEMA = z.object({ apiKey: z.string().min(1) })
+
+export interface ElevenLabsRequestOptions<TSchema extends z.ZodType> {
+  body?: Encodable
+  method?: "DELETE" | "GET" | "PATCH" | "POST"
+  query?: Record<
+    string,
+    boolean | number | readonly string[] | string | undefined
+  >
+  responseSchema: TSchema
+}
+
+/** Structured ElevenLabs REST failure. */
+export class ElevenLabsApiError extends Error {
+  readonly body?: Encodable
+  readonly retryAfter?: number
+  readonly status: number
+
+  /**
+   * Creates a structured ElevenLabs API failure.
+   *
+   * @param options Failure details.
+   * @param options.body Parsed provider response body.
+   * @param options.retryAfter Retry delay in seconds.
+   * @param options.status HTTP status.
+   */
+  constructor(options: {
+    body?: Encodable
+    retryAfter?: number
+    status: number
+  }) {
+    super(
+      getErrorMessage(options.body) ??
+        `ElevenLabs API request failed with status ${options.status}.`,
+    )
+    this.name = "ElevenLabsApiError"
+    this.body = options.body
+    this.retryAfter = options.retryAfter
+    this.status = options.status
+  }
+}
+
+/**
+ * Creates an authenticated ElevenLabs REST client.
+ *
+ * @param secret Account secret containing an ElevenLabs API key.
+ */
+export function getElevenLabsApi(secret: Record<string, unknown>) {
+  const { apiKey } = ELEVENLABS_SECRET_SCHEMA.parse(secret)
+
+  /**
+   * Sends one authenticated provider request and validates HTTP status.
+   *
+   * @param path Versioned or v1-relative API path.
+   * @param options Request options.
+   * @param options.body Encoded request body.
+   * @param options.headers Additional request headers.
+   * @param options.method HTTP method.
+   * @param options.query Query parameters.
+   */
+  async function fetchResponse(
+    path: string,
+    options: {
+      body?: RequestInit["body"]
+      headers?: RequestInit["headers"]
+      method?: "DELETE" | "GET" | "PATCH" | "POST"
+      query?: Record<
+        string,
+        boolean | number | readonly string[] | string | undefined
+      >
+    },
+  ) {
+    const headers = new Headers(options.headers)
+    headers.set("xi-api-key", apiKey)
+    const response = await fetch(createElevenLabsUrl(path, options.query), {
+      body: options.body,
+      headers,
+      method: options.method ?? "GET",
+    })
+    if (!response.ok) {
+      const body = encodableSchema.safeParse(
+        fromElevenLabs(parseJson(await response.text())),
+      )
+      throw new ElevenLabsApiError({
+        ...(body.success && { body: body.data }),
+        retryAfter: parseRetryAfter(response.headers.get("retry-after")),
+        status: response.status,
+      })
+    }
+    return response
+  }
+
+  return {
+    async request<TSchema extends z.ZodType>(
+      path: string,
+      options: ElevenLabsRequestOptions<TSchema>,
+    ): Promise<z.output<TSchema>> {
+      return options.responseSchema.parse(
+        fromElevenLabs(
+          parseJson(
+            await (
+              await fetchResponse(path, {
+                body:
+                  options.body === undefined
+                    ? undefined
+                    : JSON.stringify(toElevenLabs(options.body)),
+                headers:
+                  options.body === undefined
+                    ? { Accept: "application/json" }
+                    : {
+                        Accept: "application/json",
+                        "Content-Type": "application/json",
+                      },
+                method: options.method,
+                query: options.query,
+              })
+            ).text(),
+          ),
+        ),
+      )
+    },
+
+    async requestFile(
+      path: string,
+      options: Omit<ElevenLabsRequestOptions<z.ZodType>, "responseSchema"> & {
+        filename: string
+      },
+    ) {
+      const response = await fetchResponse(path, {
+        body:
+          options.body === undefined
+            ? undefined
+            : JSON.stringify(toElevenLabs(options.body)),
+        headers:
+          options.body === undefined
+            ? undefined
+            : { "Content-Type": "application/json" },
+        method: options.method,
+        query: options.query,
+      })
+      const contentType =
+        response.headers.get("content-type") ?? "application/octet-stream"
+      return new File(
+        [await response.blob()],
+        contentType.startsWith("video/mp4")
+          ? options.filename.replace(/\.[^.]+$/, ".mp4")
+          : options.filename,
+        {
+          type: contentType,
+        },
+      )
+    },
+
+    async requestForm<TSchema extends z.ZodType>(
+      path: string,
+      form: FormData,
+      options: {
+        query?: ElevenLabsRequestOptions<TSchema>["query"]
+        responseSchema: TSchema
+      },
+    ): Promise<z.output<TSchema>> {
+      return options.responseSchema.parse(
+        fromElevenLabs(
+          parseJson(
+            await (
+              await fetchResponse(path, {
+                body: form,
+                method: "POST",
+                query: options.query,
+              })
+            ).text(),
+          ),
+        ),
+      )
+    },
+
+    async requestFormFile(
+      path: string,
+      form: FormData,
+      options: {
+        filename: string
+        query?: ElevenLabsRequestOptions<z.ZodType>["query"]
+      },
+    ) {
+      const response = await fetchResponse(path, {
+        body: form,
+        method: "POST",
+        query: options.query,
+      })
+      const contentType =
+        response.headers.get("content-type") ?? "application/octet-stream"
+      return new File(
+        [await response.blob()],
+        contentType.startsWith("video/mp4")
+          ? options.filename.replace(/\.[^.]+$/, ".mp4")
+          : options.filename,
+        { type: contentType },
+      )
+    },
+  }
+}
+
+/**
+ * Converts camelCase values into ElevenLabs wire names.
+ *
+ * @param value Public value.
+ */
+export function toElevenLabs(value: Encodable): Encodable {
+  return encodeElevenLabsValue(value, false)
+}
+
+/**
+ * Converts one value while optionally preserving opaque object keys.
+ *
+ * @param value Public value.
+ * @param preserveKeys Whether object keys are user-defined identifiers.
+ */
+function encodeElevenLabsValue(
+  value: Encodable,
+  preserveKeys: boolean,
+): Encodable {
+  if (value instanceof Date) return value.toISOString()
+  if (Array.isArray(value)) {
+    return value.map((item) => encodeElevenLabsValue(item, preserveKeys))
+  }
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => {
+      const encodedKey = preserveKeys
+        ? key
+        : key.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+      return [
+        encodedKey,
+        encodeElevenLabsValue(
+          item,
+          preserveKeys || encodedKey === "dynamic_variables",
+        ),
+      ]
+    }),
+  )
+}
+
+/**
+ * Converts ElevenLabs wire names into camelCase values.
+ *
+ * @param value Provider value.
+ */
+export function fromElevenLabs(value: unknown): unknown {
+  if (Array.isArray(value)) return value.map(fromElevenLabs)
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      key.replace(/_([a-z0-9])/g, (_, letter: string) => letter.toUpperCase()),
+      fromElevenLabs(item),
+    ]),
+  )
+}
+
+/**
+ * Creates a same-origin ElevenLabs URL with encoded query parameters.
+ *
+ * @param path Versioned or v1-relative API path.
+ * @param query Query parameters.
+ * @throws When a path resolves outside the ElevenLabs API origin.
+ */
+function createElevenLabsUrl(
+  path: string,
+  query?: ElevenLabsRequestOptions<z.ZodType>["query"],
+) {
+  const requestedPath = path.replace(/^\//, "")
+  const url = new URL(
+    /^v\d+\//.test(requestedPath) ? requestedPath : `v1/${requestedPath}`,
+    ELEVENLABS_API_BASE_URL,
+  )
+  if (url.origin !== ELEVENLABS_API_ORIGIN) {
+    throw new Error("ElevenLabs API paths must use the ElevenLabs API origin.")
+  }
+  for (const [name, value] of Object.entries(query ?? {})) {
+    if (value === undefined) continue
+    const key = name.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`)
+    if (Array.isArray(value)) {
+      for (const item of value) url.searchParams.append(key, item)
+    } else {
+      url.searchParams.set(key, String(value))
+    }
+  }
+  return url
+}
+
+/**
+ * Parses a JSON response without masking the original HTTP status.
+ *
+ * @param value Response text.
+ */
+function parseJson(value: string): unknown {
+  try {
+    return JSON.parse(value)
+  } catch {
+    return undefined
+  }
+}
+
+/**
+ * Parses a numeric Retry-After header in seconds.
+ *
+ * @param value Header value.
+ */
+function parseRetryAfter(value: string | null) {
+  if (value === null) return undefined
+  const seconds = Number(value)
+  return Number.isFinite(seconds) ? seconds : undefined
+}
+
+/**
+ * Extracts the provider's most useful structured error message.
+ *
+ * @param body Parsed response body.
+ */
+function getErrorMessage(body: Encodable | undefined) {
+  if (!isPlainObject(body)) return undefined
+  if (typeof body.message === "string") return body.message
+  if (isPlainObject(body.detail) && typeof body.detail.message === "string") {
+    return body.detail.message
+  }
+  return undefined
+}
+
+/**
+ * Checks 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)
+}

package/src/elevenlabs/events.ts

@@ -0,0 +1,58 @@
+import * as z from "zod"
+import {
+  ELEVENLABS_FLOW_GENERATION_EVENT_SCHEMA,
+  ELEVENLABS_TRANSCRIPTION_EVENT_SCHEMA,
+  ELEVENLABS_VOICE_REMOVAL_EVENT_SCHEMA,
+  ELEVENLABS_WEBHOOK_EVENT_SCHEMA,
+} from "./schemas"
+
+export const ELEVENLABS_TRIGGER_CONFIG_SCHEMA = z.object({})
+
+export const elevenLabsTriggerContracts = {
+  "elevenlabs.event": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_WEBHOOK_EVENT_SCHEMA,
+  },
+  "elevenlabs.flowGenerationCompleted": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_FLOW_GENERATION_EVENT_SCHEMA.refine(
+      ({ data }) => data.status === "completed",
+    ),
+  },
+  "elevenlabs.flowGenerationEvent": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_FLOW_GENERATION_EVENT_SCHEMA,
+  },
+  "elevenlabs.flowGenerationFailed": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_FLOW_GENERATION_EVENT_SCHEMA.refine(
+      ({ data }) => data.status === "failed",
+    ),
+  },
+  "elevenlabs.transcriptionCompleted": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_TRANSCRIPTION_EVENT_SCHEMA,
+  },
+  "elevenlabs.voiceRemovalEvent": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_VOICE_REMOVAL_EVENT_SCHEMA,
+  },
+  "elevenlabs.voiceRemovalScheduled": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_VOICE_REMOVAL_EVENT_SCHEMA.extend({
+      type: z.literal("voice_removal_notice"),
+    }),
+  },
+  "elevenlabs.voiceRemovalWithdrawn": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_VOICE_REMOVAL_EVENT_SCHEMA.extend({
+      type: z.literal("voice_removal_notice_withdrawn"),
+    }),
+  },
+  "elevenlabs.voiceRemoved": {
+    configSchema: ELEVENLABS_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: ELEVENLABS_VOICE_REMOVAL_EVENT_SCHEMA.extend({
+      type: z.literal("voice_removed"),
+    }),
+  },
+} as const

package/src/elevenlabs/index.ts

@@ -0,0 +1,3 @@
+export * from "./api"
+export * from "./events"
+export * from "./schemas"