@automate.ax/integration-contracts 0.126.0 → 0.127.0

package/dist/outlook/index.d.ts

@@ -53,8 +53,8 @@ export declare const OUTLOOK_MESSAGE_CREATED_EVENT_SCHEMA: z.ZodObject<{
         internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         importance: z.ZodPrefault<z.ZodEnum<{
             high: "high";
-            normal: "normal";
             low: "low";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -164,8 +164,8 @@ export declare const OUTLOOK_MESSAGE_UPDATED_EVENT_SCHEMA: z.ZodObject<{
         internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         importance: z.ZodPrefault<z.ZodEnum<{
             high: "high";
-            normal: "normal";
             low: "low";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -280,8 +280,8 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
         internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         importance: z.ZodPrefault<z.ZodEnum<{
             high: "high";
-            normal: "normal";
             low: "low";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -390,8 +390,8 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
         internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
         importance: z.ZodPrefault<z.ZodEnum<{
             high: "high";
-            normal: "normal";
             low: "low";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -506,8 +506,8 @@ export declare const outlookTriggerContracts: {
             internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
             importance: z.ZodPrefault<z.ZodEnum<{
                 high: "high";
-                normal: "normal";
                 low: "low";
+                normal: "normal";
             }>>;
             inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 focused: "focused";
@@ -619,8 +619,8 @@ export declare const outlookTriggerContracts: {
                 internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
                 importance: z.ZodPrefault<z.ZodEnum<{
                     high: "high";
-                    normal: "normal";
                     low: "low";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -729,8 +729,8 @@ export declare const outlookTriggerContracts: {
                 internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
                 importance: z.ZodPrefault<z.ZodEnum<{
                     high: "high";
-                    normal: "normal";
                     low: "low";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -849,8 +849,8 @@ export declare const outlookTriggerContracts: {
                 internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
                 importance: z.ZodPrefault<z.ZodEnum<{
                     high: "high";
-                    normal: "normal";
                     low: "low";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -965,8 +965,8 @@ export declare const outlookTriggerContracts: {
                 internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
                 importance: z.ZodPrefault<z.ZodEnum<{
                     high: "high";
-                    normal: "normal";
                     low: "low";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";

package/dist/outlook/schemas.d.ts

@@ -5,8 +5,8 @@ export declare const OUTLOOK_BODY_TYPE_SCHEMA: z.ZodEnum<{
 }>;
 export declare const OUTLOOK_IMPORTANCE_SCHEMA: z.ZodEnum<{
     high: "high";
-    normal: "normal";
     low: "low";
+    normal: "normal";
 }>;
 export declare const OUTLOOK_FLAG_STATUS_SCHEMA: z.ZodEnum<{
     complete: "complete";
@@ -84,8 +84,8 @@ export declare const OUTLOOK_MESSAGE_SCHEMA: z.ZodObject<{
     internetMessageId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
     importance: z.ZodPrefault<z.ZodEnum<{
         high: "high";
-        normal: "normal";
         low: "low";
+        normal: "normal";
     }>>;
     inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         focused: "focused";
@@ -197,8 +197,8 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     id: z.ZodString;
     importance: z.ZodOptional<z.ZodEnum<{
         high: "high";
-        normal: "normal";
         low: "low";
+        normal: "normal";
     }>>;
     inferenceClassification: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         focused: "focused";
@@ -242,7 +242,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     hasAttachments: boolean;
     messageId: string;
     internetMessageId: string | undefined;
-    importance: "high" | "normal" | "low";
+    importance: "high" | "low" | "normal";
     inferenceClassification: "focused" | "other" | undefined;
     isDraft: boolean;
     isRead: boolean;
@@ -331,7 +331,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
         };
     } | null | undefined;
     hasAttachments?: boolean | undefined;
-    importance?: "high" | "normal" | "low" | undefined;
+    importance?: "high" | "low" | "normal" | undefined;
     inferenceClassification?: "focused" | "other" | null | undefined;
     internetMessageId?: string | null | undefined;
     isDraft?: boolean | undefined;
@@ -377,7 +377,7 @@ export declare function normalizeOutlookMessage(payload: unknown): {
     hasAttachments: boolean;
     messageId: string;
     internetMessageId: string | undefined;
-    importance: "high" | "normal" | "low";
+    importance: "high" | "low" | "normal";
     inferenceClassification: "focused" | "other" | undefined;
     isDraft: boolean;
     isRead: boolean;

package/dist/trello/schemas.d.ts

@@ -155,9 +155,9 @@ export declare const TRELLO_CUSTOM_FIELD_SCHEMA: z.ZodObject<{
     type: z.ZodEnum<{
         number: "number";
         date: "date";
+        list: "list";
         text: "text";
         checkbox: "checkbox";
-        list: "list";
     }>;
 }, z.core.$strip>;
 export declare const TRELLO_CUSTOM_FIELD_VALUE_SCHEMA: z.ZodDiscriminatedUnion<[z.ZodObject<{
@@ -362,9 +362,9 @@ export declare const TRELLO_PROVIDER_CUSTOM_FIELD_SCHEMA: z.ZodObject<{
     type: z.ZodEnum<{
         number: "number";
         date: "date";
+        list: "list";
         text: "text";
         checkbox: "checkbox";
-        list: "list";
     }>;
 }, z.core.$loose>;
 export declare const TRELLO_PROVIDER_CUSTOM_FIELD_ITEM_SCHEMA: z.ZodObject<{

package/dist/triggers.d.ts

@@ -1,5 +1,6 @@
 import type { airtableTriggerContracts } from "./airtable/index.js";
 import type { apifyTriggerContracts } from "./apify/index.js";
+import type { axiomTriggerContracts } from "./axiom/index.js";
 import type { automateTriggerContracts } from "./automate/index.js";
 import type { asanaTriggerContracts } from "./asana/index.js";
 import type { brevoTriggerContracts } from "./brevo/index.js";
@@ -28,7 +29,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 apifyTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & 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 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 apifyTriggerContracts & typeof axiomTriggerContracts & typeof automateTriggerContracts & typeof asanaTriggerContracts & typeof brevoTriggerContracts & typeof convexTriggerContracts & 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 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/dist/whatsapp/index.d.ts

@@ -323,15 +323,15 @@ export declare const whatsappTriggerContracts: {
                 timestamp: z.ZodString;
                 type: z.ZodEnum<{
                     unknown: "unknown";
-                    text: "text";
                     audio: "audio";
                     document: "document";
                     image: "image";
                     video: "video";
+                    order: "order";
+                    text: "text";
                     location: "location";
                     system: "system";
                     contacts: "contacts";
-                    order: "order";
                     reaction: "reaction";
                     button: "button";
                     interactive: "interactive";
@@ -418,15 +418,15 @@ export declare const whatsappTriggerContracts: {
                 timestamp: z.ZodString;
                 type: z.ZodEnum<{
                     unknown: "unknown";
-                    text: "text";
                     audio: "audio";
                     document: "document";
                     image: "image";
                     video: "video";
+                    order: "order";
+                    text: "text";
                     location: "location";
                     system: "system";
                     contacts: "contacts";
-                    order: "order";
                     reaction: "reaction";
                     button: "button";
                     interactive: "interactive";

package/dist/whatsapp/schemas.d.ts

@@ -89,15 +89,15 @@ export declare const WHATSAPP_WEBHOOK_SCHEMA: z.ZodObject<{
                     timestamp: z.ZodString;
                     type: z.ZodEnum<{
                         unknown: "unknown";
-                        text: "text";
                         audio: "audio";
                         document: "document";
                         image: "image";
                         video: "video";
+                        order: "order";
+                        text: "text";
                         location: "location";
                         system: "system";
                         contacts: "contacts";
-                        order: "order";
                         reaction: "reaction";
                         button: "button";
                         interactive: "interactive";
@@ -182,15 +182,15 @@ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SCHEMA: z.ZodObject<{
         timestamp: z.ZodString;
         type: z.ZodEnum<{
             unknown: "unknown";
-            text: "text";
             audio: "audio";
             document: "document";
             image: "image";
             video: "video";
+            order: "order";
+            text: "text";
             location: "location";
             system: "system";
             contacts: "contacts";
-            order: "order";
             reaction: "reaction";
             button: "button";
             interactive: "interactive";
@@ -277,15 +277,15 @@ export declare const WHATSAPP_MESSAGE_RECEIVED_EVENT_SCHEMA: z.ZodObject<{
         timestamp: z.ZodString;
         type: z.ZodEnum<{
             unknown: "unknown";
-            text: "text";
             audio: "audio";
             document: "document";
             image: "image";
             video: "video";
+            order: "order";
+            text: "text";
             location: "location";
             system: "system";
             contacts: "contacts";
-            order: "order";
             reaction: "reaction";
             button: "button";
             interactive: "interactive";
@@ -768,7 +768,7 @@ export declare function normalizeWhatsAppWebhook(input: unknown): {
         message: {
             id: string;
             timestamp: string;
-            type: "unknown" | "text" | "audio" | "document" | "image" | "video" | "location" | "system" | "contacts" | "order" | "reaction" | "button" | "interactive" | "sticker" | "unsupported";
+            type: "unknown" | "audio" | "document" | "image" | "video" | "order" | "text" | "location" | "system" | "contacts" | "reaction" | "button" | "interactive" | "sticker" | "unsupported";
             content?: z.core.util.JSONType | undefined;
             context?: {
                 messageId: string;
@@ -781,7 +781,7 @@ export declare function normalizeWhatsAppWebhook(input: unknown): {
             from: string;
             id: string;
             timestamp: string;
-            type: "unknown" | "text" | "audio" | "document" | "image" | "video" | "location" | "system" | "contacts" | "order" | "reaction" | "button" | "interactive" | "sticker" | "unsupported";
+            type: "unknown" | "audio" | "document" | "image" | "video" | "order" | "text" | "location" | "system" | "contacts" | "reaction" | "button" | "interactive" | "sticker" | "unsupported";
             audio?: {
                 id: string;
                 mime_type?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.126.0",
+  "version": "0.127.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -21,6 +21,7 @@
       "./apify": "./src/apify/index.ts",
       "./airtable": "./src/airtable/index.ts",
       "./automate": "./src/automate/index.ts",
+      "./axiom": "./src/axiom/index.ts",
       "./asana": "./src/asana/index.ts",
       "./brevo": "./src/brevo/index.ts",
       "./cloudflare": "./src/cloudflare/index.ts",
@@ -57,7 +58,7 @@
     }
   },
   "dependencies": {
-    "@automate.ax/codec": "0.126.0",
+    "@automate.ax/codec": "0.127.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^15.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -123,6 +124,11 @@
       "types": "./dist/automate/index.d.ts",
       "default": "./dist/automate/index.js"
     },
+    "./axiom": {
+      "bun": "./src/axiom/index.ts",
+      "types": "./dist/axiom/index.d.ts",
+      "default": "./dist/axiom/index.js"
+    },
     "./asana": {
       "bun": "./src/asana/index.ts",
       "types": "./dist/asana/index.d.ts",

package/src/axiom/api.ts

@@ -0,0 +1,252 @@
+import { encodableSchema, type Encodable } from "@automate.ax/codec"
+import * as z from "zod"
+
+const AXIOM_API_ORIGIN = "https://api.axiom.co"
+const AXIOM_SECRET_SCHEMA = z.object({ apiKey: z.string().trim().min(1) })
+
+export interface AxiomResolvedAccount {
+  connectionMethodId: string
+  secret: Record<string, unknown>
+  serviceId: "axiom"
+}
+
+export interface AxiomRequestOptions<TSchema extends z.ZodType> {
+  body?: Encodable
+  headers?: Record<string, string>
+  method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT"
+  query?: Record<string, boolean | number | string | undefined>
+  responseSchema: TSchema
+  version?: "v1" | "v2"
+}
+
+/** Structured Axiom REST error. */
+export class AxiomApiError extends Error {
+  readonly details: Encodable
+  readonly ingestLimitReset?: number
+  readonly queryLimitReset?: number
+  readonly rateLimitReset?: number
+  readonly retryAfter?: number
+  readonly status: number
+
+  /**
+   * Creates a structured provider error.
+   *
+   * @param options - Error response details and rate-limit metadata.
+   * @param options.details - Parsed provider response body.
+   * @param options.ingestLimitReset - Ingest-limit reset timestamp.
+   * @param options.queryLimitReset - Query-limit reset timestamp.
+   * @param options.rateLimitReset - Request-rate-limit reset timestamp.
+   * @param options.retryAfter - Suggested retry delay in seconds.
+   * @param options.status - HTTP response status.
+   */
+  constructor(options: {
+    details: Encodable
+    ingestLimitReset?: number
+    queryLimitReset?: number
+    rateLimitReset?: number
+    retryAfter?: number
+    status: number
+  }) {
+    const message =
+      isPlainObject(options.details) &&
+      typeof options.details.message === "string"
+        ? options.details.message
+        : undefined
+    super(
+      message
+        ? `Axiom API error (${options.status}): ${message}`
+        : `Axiom API request failed (${options.status}).`,
+    )
+    this.name = "AxiomApiError"
+    this.details = options.details
+    this.ingestLimitReset = options.ingestLimitReset
+    this.queryLimitReset = options.queryLimitReset
+    this.rateLimitReset = options.rateLimitReset
+    this.retryAfter = options.retryAfter
+    this.status = options.status
+  }
+}
+
+/**
+ * Creates an authenticated, origin-confined Axiom API client.
+ *
+ * @param account - Resolved Axiom integration account.
+ * @param edgeUrl - Optional Axiom edge origin used by version-one endpoints.
+ * @throws When the account method, secret, or edge origin is invalid.
+ */
+export function getAxiomApi(
+  account: AxiomResolvedAccount,
+  edgeUrl = AXIOM_API_ORIGIN,
+) {
+  if (account.connectionMethodId !== "api-token") {
+    throw new Error(
+      `Unsupported Axiom connection method: ${account.connectionMethodId}`,
+    )
+  }
+  const { apiKey } = AXIOM_SECRET_SCHEMA.parse(account.secret)
+  const edgeOrigin = validateAxiomOrigin(edgeUrl)
+
+  /**
+   * Sends one authenticated request and validates its response.
+   *
+   * @param path - Relative Axiom API path.
+   * @param options - Request and response-validation options.
+   * @throws {AxiomApiError} When Axiom returns an unsuccessful response.
+   */
+  async function request<TSchema extends z.ZodType>(
+    path: string,
+    options: AxiomRequestOptions<TSchema>,
+  ): Promise<z.output<TSchema>> {
+    const version = options.version ?? "v2"
+    const url = confinedUrl(
+      version === "v1" ? edgeOrigin : AXIOM_API_ORIGIN,
+      version,
+      path,
+    )
+    for (const [name, value] of Object.entries(options.query ?? {})) {
+      if (value !== undefined) url.searchParams.set(name, String(value))
+    }
+
+    const response = await fetch(url, {
+      body:
+        options.body === undefined
+          ? undefined
+          : JSON.stringify(encodableSchema.parse(options.body)),
+      headers: {
+        Accept: "application/json",
+        Authorization: `Bearer ${apiKey}`,
+        ...(options.body === undefined
+          ? {}
+          : { "Content-Type": "application/json" }),
+        ...options.headers,
+      },
+      method: options.method ?? "GET",
+      redirect: "manual",
+    })
+    const parsed = parseResponse(await response.text())
+    if (!response.ok || response.status >= 300) {
+      throw new AxiomApiError({
+        details: parsed,
+        ingestLimitReset: parseFiniteNumber(
+          response.headers.get("X-IngestLimit-Reset"),
+        ),
+        queryLimitReset: parseFiniteNumber(
+          response.headers.get("X-QueryLimit-Reset"),
+        ),
+        rateLimitReset: parseFiniteNumber(
+          response.headers.get("X-RateLimit-Reset"),
+        ),
+        retryAfter: parseRetryAfter(response.headers.get("Retry-After")),
+        status: response.status,
+      })
+    }
+    return options.responseSchema.parse(parsed)
+  }
+
+  return { request }
+}
+
+/**
+ * Restricts edge traffic to Axiom-owned HTTPS origins on the standard port.
+ *
+ * @param value - Candidate edge URL.
+ * @throws {TypeError} When the URL is not a confined Axiom HTTPS origin.
+ */
+export function validateAxiomOrigin(value: string) {
+  const url = new URL(value)
+  const isAxiomHost =
+    url.hostname === "api.axiom.co" || url.hostname.endsWith(".edge.axiom.co")
+  if (
+    url.protocol !== "https:" ||
+    url.port !== "" ||
+    !isAxiomHost ||
+    url.username ||
+    url.password ||
+    url.search ||
+    url.hash
+  ) {
+    throw new TypeError(
+      "Axiom edge URLs must use api.axiom.co or an HTTPS *.edge.axiom.co host.",
+    )
+  }
+  return url.origin
+}
+
+/**
+ * Resolves a relative path below one confined API-version root.
+ *
+ * @param origin - Validated Axiom origin.
+ * @param version - API version path segment.
+ * @param path - Relative request path.
+ * @throws {TypeError} When the path escapes its API-version root.
+ */
+function confinedUrl(origin: string, version: "v1" | "v2", path: string) {
+  const normalizedPath = path.replace(/^\/+/, "")
+  if (
+    !normalizedPath ||
+    normalizedPath.includes("://") ||
+    normalizedPath.includes("\\")
+  ) {
+    throw new TypeError("Axiom API paths must be relative.")
+  }
+  const root = new URL(`/${version}/`, origin)
+  const url = new URL(normalizedPath, root)
+  if (url.origin !== root.origin || !url.pathname.startsWith(root.pathname)) {
+    throw new TypeError("Axiom API paths must remain below their API version.")
+  }
+  return url
+}
+
+/**
+ * Parses an Axiom response into an encodable value.
+ *
+ * @param text - Raw response body.
+ */
+function parseResponse(text: string): Encodable {
+  if (!text) return null
+  try {
+    return encodableSchema.parse(JSON.parse(text))
+  } catch {
+    return { response: text }
+  }
+}
+
+/**
+ * Parses a finite numeric response header.
+ *
+ * @param value - Raw header value.
+ */
+function parseFiniteNumber(value: string | null) {
+  if (value === null) return undefined
+  const number = Number(value)
+  return Number.isFinite(number) ? number : undefined
+}
+
+/**
+ * Parses a Retry-After header into seconds.
+ *
+ * @param value - Raw header value.
+ */
+function parseRetryAfter(value: string | null) {
+  if (value === null) return undefined
+  const seconds = Number(value)
+  if (Number.isFinite(seconds)) return seconds
+  const timestamp = Date.parse(value)
+  return Number.isFinite(timestamp)
+    ? Math.max(0, Math.ceil((timestamp - Date.now()) / 1_000))
+    : undefined
+}
+
+/**
+ * Checks whether an encodable value is a plain object.
+ *
+ * @param value - Value to inspect.
+ */
+function isPlainObject(value: Encodable): value is Record<string, Encodable> {
+  return (
+    typeof value === "object" &&
+    value !== null &&
+    !Array.isArray(value) &&
+    Object.getPrototypeOf(value) === Object.prototype
+  )
+}

package/src/axiom/events.ts

@@ -0,0 +1,31 @@
+import * as z from "zod"
+import { AXIOM_ID_SCHEMA, AXIOM_MONITOR_NOTIFICATION_SCHEMA } from "./schemas"
+
+export const AXIOM_TRIGGER_CONFIG_SCHEMA = z.object({
+  monitorId: AXIOM_ID_SCHEMA,
+})
+
+export const AXIOM_MONITOR_OPENED_SCHEMA =
+  AXIOM_MONITOR_NOTIFICATION_SCHEMA.extend({
+    action: z.literal("Open"),
+  })
+
+export const AXIOM_MONITOR_CLOSED_SCHEMA =
+  AXIOM_MONITOR_NOTIFICATION_SCHEMA.extend({
+    action: z.literal("Closed"),
+  })
+
+export const axiomTriggerContracts = {
+  "axiom.monitorNotification": {
+    configSchema: AXIOM_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AXIOM_MONITOR_NOTIFICATION_SCHEMA,
+  },
+  "axiom.monitorOpened": {
+    configSchema: AXIOM_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AXIOM_MONITOR_OPENED_SCHEMA,
+  },
+  "axiom.monitorClosed": {
+    configSchema: AXIOM_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: AXIOM_MONITOR_CLOSED_SCHEMA,
+  },
+} as const

package/src/axiom/index.ts

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