@automate.ax/integration-contracts 0.152.5 → 0.153.1

package/dist/outlook/index.d.ts

@@ -57,9 +57,9 @@ export declare const OUTLOOK_MESSAGE_CREATED_EVENT_SCHEMA: z.ZodObject<{
             normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            focused: "focused";
             other: "other";
-        }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+            focused: "focused";
+        }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
         isDraft: z.ZodPrefault<z.ZodBoolean>;
         isRead: z.ZodPrefault<z.ZodBoolean>;
         modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -168,9 +168,9 @@ export declare const OUTLOOK_MESSAGE_UPDATED_EVENT_SCHEMA: z.ZodObject<{
             normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            focused: "focused";
             other: "other";
-        }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+            focused: "focused";
+        }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
         isDraft: z.ZodPrefault<z.ZodBoolean>;
         isRead: z.ZodPrefault<z.ZodBoolean>;
         modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -284,9 +284,9 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
             normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            focused: "focused";
             other: "other";
-        }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+            focused: "focused";
+        }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
         isDraft: z.ZodPrefault<z.ZodBoolean>;
         isRead: z.ZodPrefault<z.ZodBoolean>;
         modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -394,9 +394,9 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
             normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-            focused: "focused";
             other: "other";
-        }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+            focused: "focused";
+        }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
         isDraft: z.ZodPrefault<z.ZodBoolean>;
         isRead: z.ZodPrefault<z.ZodBoolean>;
         modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -510,9 +510,9 @@ export declare const outlookTriggerContracts: {
                 normal: "normal";
             }>>;
             inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                focused: "focused";
                 other: "other";
-            }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+                focused: "focused";
+            }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
             isDraft: z.ZodPrefault<z.ZodBoolean>;
             isRead: z.ZodPrefault<z.ZodBoolean>;
             modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -623,9 +623,9 @@ export declare const outlookTriggerContracts: {
                     normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    focused: "focused";
                     other: "other";
-                }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+                    focused: "focused";
+                }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
                 isDraft: z.ZodPrefault<z.ZodBoolean>;
                 isRead: z.ZodPrefault<z.ZodBoolean>;
                 modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -733,9 +733,9 @@ export declare const outlookTriggerContracts: {
                     normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    focused: "focused";
                     other: "other";
-                }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+                    focused: "focused";
+                }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
                 isDraft: z.ZodPrefault<z.ZodBoolean>;
                 isRead: z.ZodPrefault<z.ZodBoolean>;
                 modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -853,9 +853,9 @@ export declare const outlookTriggerContracts: {
                     normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    focused: "focused";
                     other: "other";
-                }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+                    focused: "focused";
+                }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
                 isDraft: z.ZodPrefault<z.ZodBoolean>;
                 isRead: z.ZodPrefault<z.ZodBoolean>;
                 modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -969,9 +969,9 @@ export declare const outlookTriggerContracts: {
                     normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-                    focused: "focused";
                     other: "other";
-                }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+                    focused: "focused";
+                }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
                 isDraft: z.ZodPrefault<z.ZodBoolean>;
                 isRead: z.ZodPrefault<z.ZodBoolean>;
                 modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;

package/dist/outlook/schemas.d.ts

@@ -88,9 +88,9 @@ export declare const OUTLOOK_MESSAGE_SCHEMA: z.ZodObject<{
         normal: "normal";
     }>>;
     inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        focused: "focused";
         other: "other";
-    }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | null | undefined>>;
+        focused: "focused";
+    }>>>, z.ZodTransform<"other" | "focused" | undefined, "other" | "focused" | null | undefined>>;
     isDraft: z.ZodPrefault<z.ZodBoolean>;
     isRead: z.ZodPrefault<z.ZodBoolean>;
     modifiedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodPipe<z.ZodISODateTime, z.ZodTransform<Date, string>>]>>>, z.ZodTransform<Date | undefined, Date | null | undefined>>;
@@ -201,8 +201,8 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
         normal: "normal";
     }>>;
     inferenceClassification: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
-        focused: "focused";
         other: "other";
+        focused: "focused";
     }>>>;
     internetMessageId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     isDraft: z.ZodOptional<z.ZodBoolean>;
@@ -243,7 +243,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     messageId: string;
     internetMessageId: string | undefined;
     importance: "high" | "low" | "normal";
-    inferenceClassification: "focused" | "other" | undefined;
+    inferenceClassification: "other" | "focused" | undefined;
     isDraft: boolean;
     isRead: boolean;
     modifiedAt: Date | undefined;
@@ -332,7 +332,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     } | null | undefined;
     hasAttachments?: boolean | undefined;
     importance?: "high" | "low" | "normal" | undefined;
-    inferenceClassification?: "focused" | "other" | null | undefined;
+    inferenceClassification?: "other" | "focused" | null | undefined;
     internetMessageId?: string | null | undefined;
     isDraft?: boolean | undefined;
     isRead?: boolean | undefined;
@@ -378,7 +378,7 @@ export declare function normalizeOutlookMessage(payload: unknown): {
     messageId: string;
     internetMessageId: string | undefined;
     importance: "high" | "low" | "normal";
-    inferenceClassification: "focused" | "other" | undefined;
+    inferenceClassification: "other" | "focused" | undefined;
     isDraft: boolean;
     isRead: boolean;
     modifiedAt: Date | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.152.5",
+  "version": "0.153.1",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
   "repository": {
@@ -72,7 +72,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.152.5",
+    "@automate.ax/codec": "0.153.1",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",

package/src/cloudflare/api.ts

@@ -53,16 +53,40 @@ export interface CloudflareRequestOptions<TSchema extends z.ZodType> {
   /** Public camelCase JSON body. */
   body?: Encodable
 
+  /** Provider request-key convention. Defaults to Cloudflare snake_case. */
+  keyFormat?: "browser-rendering"
+
   /** HTTP verb. Defaults to `GET`. */
   method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT"
 
   /** Public camelCase query parameters. */
   query?: Record<string, CloudflareQueryValue>
 
+  /** Provider result-key convention. Defaults to recursive camelCase. */
+  responseKeyFormat?: "preserve"
+
   /** Schema for the normalized provider result. */
   responseSchema: TSchema
 }
 
+/** Options for one authenticated Cloudflare binary REST request. */
+export interface CloudflareBlobRequestOptions {
+  /** Expected response media type. */
+  accept: string
+
+  /** Public camelCase JSON body. */
+  body?: Encodable
+
+  /** Provider request-key convention. Defaults to Cloudflare snake_case. */
+  keyFormat?: "browser-rendering"
+
+  /** HTTP verb. Defaults to `GET`. */
+  method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT"
+
+  /** Public camelCase query parameters. */
+  query?: Record<string, CloudflareQueryValue>
+}
+
 /** One normalized Cloudflare result page. */
 export interface CloudflarePage<T> {
   result: T
@@ -166,6 +190,64 @@ export function getCloudflareApi(account: CloudflareResolvedAccount) {
     path: string,
     options: CloudflareRequestOptions<TSchema>,
   ): Promise<CloudflarePage<z.output<TSchema>>> {
+    const response = await runRequest(path, options, "application/json")
+    const parsed = CLOUDFLARE_ENVELOPE_SCHEMA.safeParse(
+      parseJson(await response.text()),
+    )
+    if (!response.ok || !parsed.success || !parsed.data.success) {
+      throw createApiError(response, parsed.success ? parsed.data.errors : [])
+    }
+    return {
+      result: options.responseSchema.parse(
+        options.responseKeyFormat === "preserve"
+          ? convertFromCloudflare(parsed.data.result, true)
+          : fromCloudflare(parsed.data.result),
+      ),
+      ...(parsed.data.result_info && {
+        resultInfo: CLOUDFLARE_RESULT_INFO_SCHEMA.parse(
+          fromCloudflare(parsed.data.result_info),
+        ),
+      }),
+    }
+  }
+
+  /**
+   * Runs one request and returns a binary response body.
+   *
+   * @param path - Cloudflare API path relative to the v4 root.
+   * @param options - Method, parameters, and expected media type.
+   */
+  async function requestBlob(
+    path: string,
+    options: CloudflareBlobRequestOptions,
+  ): Promise<Blob> {
+    const response = await runRequest(path, options, options.accept)
+    if (
+      !response.ok ||
+      response.headers.get("Content-Type")?.includes("application/json")
+    ) {
+      const parsed = CLOUDFLARE_ENVELOPE_SCHEMA.safeParse(
+        parseJson(await response.text()),
+      )
+      if (!response.ok || !parsed.success || !parsed.data.success)
+        throw createApiError(response, parsed.success ? parsed.data.errors : [])
+      throw new Error("Cloudflare returned JSON instead of binary content.")
+    }
+    return response.blob()
+  }
+
+  /**
+   * Runs one authenticated Cloudflare request.
+   *
+   * @param path - Cloudflare API path relative to the v4 root.
+   * @param options - Method, body, and query parameters.
+   * @param accept - Expected response media type.
+   */
+  async function runRequest(
+    path: string,
+    options: Omit<CloudflareBlobRequestOptions, "accept">,
+    accept: string,
+  ) {
     const url = new URL(path.replace(/^\//, ""), CLOUDFLARE_API_BASE_URL)
     if (url.origin !== CLOUDFLARE_API_ORIGIN) {
       throw new Error(
@@ -174,15 +256,24 @@ export function getCloudflareApi(account: CloudflareResolvedAccount) {
     }
     for (const [name, value] of Object.entries(options.query ?? {})) {
       if (value !== undefined)
-        url.searchParams.set(toSnakeCase(name), String(value))
+        url.searchParams.set(
+          options.keyFormat === "browser-rendering"
+            ? toBrowserRenderingQueryKey(name)
+            : toSnakeCase(name),
+          String(value),
+        )
     }
-    const response = await fetch(url, {
+    return fetch(url, {
       body:
         options.body === undefined
           ? undefined
-          : JSON.stringify(toCloudflare(options.body)),
+          : JSON.stringify(
+              options.keyFormat === "browser-rendering"
+                ? toCloudflareBrowserRendering(options.body)
+                : toCloudflare(options.body),
+            ),
       headers: {
-        Accept: "application/json",
+        Accept: accept,
         Authorization: `Bearer ${accessToken}`,
         ...(options.body === undefined
           ? {}
@@ -190,29 +281,28 @@ export function getCloudflareApi(account: CloudflareResolvedAccount) {
       },
       method: options.method ?? "GET",
     })
-    const parsed = CLOUDFLARE_ENVELOPE_SCHEMA.safeParse(
-      parseJson(await response.text()),
-    )
-    if (!response.ok || !parsed.success || !parsed.data.success) {
-      throw new CloudflareApiError({
-        errors: parsed.success ? parsed.data.errors : undefined,
-        rateLimit: response.headers.get("Ratelimit") ?? undefined,
-        rateLimitPolicy: response.headers.get("Ratelimit-Policy") ?? undefined,
-        retryAfter: parseFiniteNumber(response.headers.get("Retry-After")),
-        status: response.status,
-      })
-    }
-    return {
-      result: options.responseSchema.parse(fromCloudflare(parsed.data.result)),
-      ...(parsed.data.result_info && {
-        resultInfo: CLOUDFLARE_RESULT_INFO_SCHEMA.parse(
-          fromCloudflare(parsed.data.result_info),
-        ),
-      }),
-    }
   }
 
-  return { request, requestPage }
+  return { request, requestBlob, requestPage }
+}
+
+/**
+ * Creates a structured error from one Cloudflare response.
+ *
+ * @param response - Failed Cloudflare response.
+ * @param errors - Parsed provider errors.
+ */
+function createApiError(
+  response: Response,
+  errors: z.output<typeof CLOUDFLARE_RESPONSE_INFO_SCHEMA>[],
+) {
+  return new CloudflareApiError({
+    errors,
+    rateLimit: response.headers.get("Ratelimit") ?? undefined,
+    rateLimitPolicy: response.headers.get("Ratelimit-Policy") ?? undefined,
+    retryAfter: parseFiniteNumber(response.headers.get("Retry-After")),
+    status: response.status,
+  })
 }
 
 /**
@@ -224,6 +314,42 @@ export function toCloudflare(value: Encodable): Encodable {
   return convertToCloudflare(value, false)
 }
 
+/**
+ * Converts public JSON to Cloudflare Browser Run's mixed wire keys.
+ *
+ * @param value - Codec-safe public value.
+ */
+export function toCloudflareBrowserRendering(value: Encodable): Encodable {
+  return convertToCloudflareBrowserRendering(value, false)
+}
+
+/**
+ * Converts one Browser Run value while optionally preserving arbitrary keys.
+ *
+ * @param value - Public value to convert.
+ * @param preserveKeys - Whether this object is a user-defined map.
+ */
+function convertToCloudflareBrowserRendering(
+  value: Encodable,
+  preserveKeys: boolean,
+): Encodable {
+  if (value instanceof Date) return value.toISOString()
+  if (Array.isArray(value))
+    return value.map((item) =>
+      convertToCloudflareBrowserRendering(item, preserveKeys),
+    )
+  if (!isPlainObject(value)) return value
+  return Object.fromEntries(
+    Object.entries(value).map(([key, item]) => [
+      preserveKeys ? key : toBrowserRenderingKey(key),
+      convertToCloudflareBrowserRendering(
+        item,
+        preserveKeys || key === "jsonSchema" || key === "setExtraHttpHeaders",
+      ),
+    ]),
+  )
+}
+
 /**
  * Converts one value while optionally preserving object keys.
  *
@@ -241,7 +367,7 @@ function convertToCloudflare(
   return Object.fromEntries(
     Object.entries(value).map(([key, item]) => [
       preserveKeys ? key : toSnakeCase(key),
-      convertToCloudflare(item, key === "header" || key === "headers"),
+      convertToCloudflare(item, preserveKeys || preservesNestedKeys(key)),
     ]),
   )
 }
@@ -271,11 +397,28 @@ function convertFromCloudflare(
   return Object.fromEntries(
     Object.entries(value).map(([key, item]) => [
       preserveKeys ? key : toCamelCase(key),
-      convertFromCloudflare(item, key === "header" || key === "headers"),
+      convertFromCloudflare(item, preserveKeys || preservesNestedKeys(key)),
     ]),
   )
 }
 
+/**
+ * Returns whether a provider-defined object map must retain its keys.
+ *
+ * @param key - Public or provider parent key.
+ */
+function preservesNestedKeys(key: string) {
+  return [
+    "header",
+    "headers",
+    "json",
+    "jsonSchema",
+    "json_schema",
+    "setExtraHttpHeaders",
+    "set_extra_http_headers",
+  ].includes(key)
+}
+
 const CLOUDFLARE_VALUE_SCHEMA = z.union([
   z.boolean(),
   z.number(),
@@ -338,3 +481,25 @@ function toSnakeCase(value: string) {
     .replace(/([a-zA-Z])([0-9])/g, "$1_$2")
     .replace(/[A-Z]/g, (character) => `_${character.toLowerCase()}`)
 }
+
+/**
+ * Converts a public query key to Cloudflare's endpoint spelling.
+ *
+ * @param value - Public query key.
+ */
+function toBrowserRenderingQueryKey(value: string) {
+  return value === "cacheTtl" ? "cacheTTL" : toSnakeCase(value)
+}
+
+/**
+ * Converts one public Browser Run body key to its exact provider spelling.
+ *
+ * @param value - Public key.
+ */
+function toBrowserRenderingKey(value: string) {
+  if (value === "customAi") return "custom_ai"
+  if (value === "jsonSchema") return "json_schema"
+  if (value === "responseFormat") return "response_format"
+  if (value === "setExtraHttpHeaders") return "setExtraHTTPHeaders"
+  return value
+}