@automate.ax/integration-contracts 0.161.0 → 0.163.0

package/dist/meta-ads/schemas.d.ts

@@ -170,15 +170,99 @@ export declare const META_ADS_WEBHOOK_CHANGE_SCHEMA: z.ZodObject<{
     field: z.ZodString;
     value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
 }, z.core.$strip>;
+/**
+ * Meta's shared Webhooks envelope. Field-change objects use `changes`, while
+ * Messenger and Instagram messaging use `messaging`; validate each messaging
+ * event only after classification so unrelated event kinds never reject the
+ * whole delivery.
+ */
 export declare const META_ADS_WEBHOOK_ENVELOPE_SCHEMA: z.ZodObject<{
     entry: z.ZodArray<z.ZodObject<{
-        changes: z.ZodArray<z.ZodObject<{
+        changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
             field: z.ZodString;
             value: z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>;
-        }, z.core.$strip>>;
+        }, z.core.$strip>>>;
         id: z.ZodString;
+        messaging: z.ZodOptional<z.ZodArray<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
         time: z.ZodNumber;
     }, z.core.$strip>>;
     object: z.ZodString;
 }, z.core.$strip>;
 export type MetaAdsWebhookEnvelope = z.output<typeof META_ADS_WEBHOOK_ENVELOPE_SCHEMA>;
+export declare const META_ADS_PAGE_SCHEMA: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    name: z.ZodString;
+    tasks: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_INSTAGRAM_ACCOUNT_PAGE_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    instagramBusinessAccount: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    name: z.ZodString;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_PAGE_COMMENT_SCHEMA: z.ZodObject<{
+    canComment: z.ZodOptional<z.ZodBoolean>;
+    canReplyPrivately: z.ZodOptional<z.ZodBoolean>;
+    commentCount: z.ZodOptional<z.ZodNumber>;
+    createdTime: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    id: z.ZodString;
+    likeCount: z.ZodOptional<z.ZodNumber>;
+    message: z.ZodOptional<z.ZodString>;
+    parent: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_INSTAGRAM_COMMENT_SCHEMA: z.ZodObject<{
+    from: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        username: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    id: z.ZodString;
+    likeCount: z.ZodOptional<z.ZodNumber>;
+    media: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        mediaProductType: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    parentId: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CREATED_OBJECT_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_SENT_MESSAGE_SCHEMA: z.ZodObject<{
+    messageId: z.ZodString;
+    recipientId: z.ZodString;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CONVERSATION_SCHEMA: z.ZodObject<{
+    id: z.ZodString;
+    updatedTime: z.ZodOptional<z.ZodString>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;
+export declare const META_ADS_CONVERSATION_MESSAGE_SCHEMA: z.ZodObject<{
+    createdTime: z.ZodOptional<z.ZodString>;
+    from: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    id: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    to: z.ZodOptional<z.ZodObject<{
+        data: z.ZodArray<z.ZodObject<{
+            email: z.ZodOptional<z.ZodString>;
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            username: z.ZodOptional<z.ZodString>;
+        }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+    }, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>>;
+}, z.core.$catchall<z.ZodOptional<z.ZodCustom<import("@automate.ax/codec").Encodable, import("@automate.ax/codec").Encodable>>>>;

package/dist/meta-ads/schemas.js

@@ -169,13 +169,86 @@ export const META_ADS_WEBHOOK_CHANGE_SCHEMA = z.object({
     field: z.string(),
     value: encodableSchema,
 });
+/**
+ * Meta's shared Webhooks envelope. Field-change objects use `changes`, while
+ * Messenger and Instagram messaging use `messaging`; validate each messaging
+ * event only after classification so unrelated event kinds never reject the
+ * whole delivery.
+ */
 export const META_ADS_WEBHOOK_ENVELOPE_SCHEMA = z.object({
     entry: z
         .object({
-        changes: META_ADS_WEBHOOK_CHANGE_SCHEMA.array(),
+        changes: META_ADS_WEBHOOK_CHANGE_SCHEMA.array().optional(),
         id: z.string(),
+        messaging: encodableSchema.array().optional(),
         time: z.number(),
     })
         .array(),
     object: z.string(),
 });
+export const META_ADS_PAGE_SCHEMA = metaObject({
+    category: z.string().optional(),
+    id: META_ADS_ID_SCHEMA,
+    name: z.string(),
+    tasks: z.string().array().optional(),
+});
+export const META_ADS_INSTAGRAM_ACCOUNT_PAGE_SCHEMA = metaObject({
+    id: META_ADS_ID_SCHEMA,
+    instagramBusinessAccount: metaObject({
+        id: META_ADS_ID_SCHEMA,
+        username: z.string().optional(),
+    }).optional(),
+    name: z.string(),
+});
+export const META_ADS_PAGE_COMMENT_SCHEMA = metaObject({
+    canComment: z.boolean().optional(),
+    canReplyPrivately: z.boolean().optional(),
+    commentCount: z.number().int().nonnegative().optional(),
+    createdTime: z.string().optional(),
+    from: metaObject({ id: z.string(), name: z.string().optional() }).optional(),
+    id: META_ADS_ID_SCHEMA,
+    likeCount: z.number().int().nonnegative().optional(),
+    message: z.string().optional(),
+    parent: metaObject({ id: z.string() }).optional(),
+});
+export const META_ADS_INSTAGRAM_COMMENT_SCHEMA = metaObject({
+    from: metaObject({
+        id: z.string(),
+        username: z.string().optional(),
+    }).optional(),
+    hidden: z.boolean().optional(),
+    id: META_ADS_ID_SCHEMA,
+    likeCount: z.number().int().nonnegative().optional(),
+    media: metaObject({
+        id: z.string(),
+        mediaProductType: z.string().optional(),
+    }).optional(),
+    parentId: z.string().optional(),
+    text: z.string().optional(),
+    timestamp: z.string().optional(),
+    username: z.string().optional(),
+});
+export const META_ADS_CREATED_OBJECT_SCHEMA = metaObject({
+    id: META_ADS_ID_SCHEMA,
+});
+export const META_ADS_SENT_MESSAGE_SCHEMA = metaObject({
+    messageId: META_ADS_ID_SCHEMA,
+    recipientId: z.string(),
+});
+export const META_ADS_CONVERSATION_SCHEMA = metaObject({
+    id: META_ADS_ID_SCHEMA,
+    updatedTime: z.string().optional(),
+});
+const META_ADS_MESSAGE_PARTY_SCHEMA = metaObject({
+    email: z.string().optional(),
+    id: z.string(),
+    name: z.string().optional(),
+    username: z.string().optional(),
+});
+export const META_ADS_CONVERSATION_MESSAGE_SCHEMA = metaObject({
+    createdTime: z.string().optional(),
+    from: META_ADS_MESSAGE_PARTY_SCHEMA.optional(),
+    id: META_ADS_ID_SCHEMA,
+    message: z.string().optional(),
+    to: metaObject({ data: META_ADS_MESSAGE_PARTY_SCHEMA.array() }).optional(),
+});

package/dist/outlook/graph.d.ts

@@ -1,4 +1,21 @@
 import * as z from "zod";
+/** Structured error returned by a rejected Microsoft Graph request. */
+export declare class OutlookGraphApiError extends Error {
+    readonly retryAfter?: string;
+    readonly status: number;
+    /**
+     * Creates an error from one rejected Graph response.
+     *
+     * @param message - Diagnostic message with Graph's code and message.
+     * @param options - Rejected response details.
+     * @param options.retryAfter - Raw provider retry timing, when present.
+     * @param options.status - HTTP status.
+     */
+    constructor(message: string, options: {
+        retryAfter?: string;
+        status: number;
+    });
+}
 /** Options accepted by the authenticated Outlook Graph request helper. */
 export interface OutlookGraphRequestOptions {
     /** JSON-serializable request body. */
@@ -12,8 +29,9 @@ export interface OutlookGraphRequestOptions {
  * Creates a small authenticated Microsoft Graph client for Outlook APIs.
  *
  * The raw `fetch` method is an escape hatch for provider features not yet
- * represented by a built-in action. `request` parses JSON and reports Graph
- * errors with their provider code and message.
+ * represented by a built-in action. `request` parses JSON and throws
+ * {@link OutlookGraphApiError} with Graph's code, message, status, and
+ * `Retry-After` hint.
  *
  * @param secret - Refreshed Microsoft OAuth integration secret.
  */

package/dist/outlook/graph.js

@@ -11,12 +11,32 @@ const GRAPH_ERROR_SCHEMA = z.looseObject({
     })
         .optional(),
 });
+/** Structured error returned by a rejected Microsoft Graph request. */
+export class OutlookGraphApiError extends Error {
+    retryAfter;
+    status;
+    /**
+     * Creates an error from one rejected Graph response.
+     *
+     * @param message - Diagnostic message with Graph's code and message.
+     * @param options - Rejected response details.
+     * @param options.retryAfter - Raw provider retry timing, when present.
+     * @param options.status - HTTP status.
+     */
+    constructor(message, options) {
+        super(message);
+        this.name = "OutlookGraphApiError";
+        this.retryAfter = options.retryAfter;
+        this.status = options.status;
+    }
+}
 /**
  * Creates a small authenticated Microsoft Graph client for Outlook APIs.
  *
  * The raw `fetch` method is an escape hatch for provider features not yet
- * represented by a built-in action. `request` parses JSON and reports Graph
- * errors with their provider code and message.
+ * represented by a built-in action. `request` parses JSON and throws
+ * {@link OutlookGraphApiError} with Graph's code, message, status, and
+ * `Retry-After` hint.
  *
  * @param secret - Refreshed Microsoft OAuth integration secret.
  */
@@ -61,7 +81,10 @@ export function getOutlookGraphApi(secret) {
             const detail = [graphError?.code, graphError?.message]
                 .filter(Boolean)
                 .join(": ");
-            throw new Error(`Microsoft Graph request failed with ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}.`);
+            throw new OutlookGraphApiError(`Microsoft Graph request failed with ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}.`, {
+                retryAfter: response.headers.get("Retry-After") ?? undefined,
+                status: response.status,
+            });
         }
         if (response.status === 202 || response.status === 204)
             return undefined;

package/package.json

@@ -1,17 +1,9 @@
 {
   "name": "@automate.ax/integration-contracts",
-  "version": "0.161.0",
+  "version": "0.163.0",
   "description": "Shared integration payload contracts and provider primitives for Automate.ax.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/zachsents/automate.ax.git",
-    "directory": "packages/integration-contracts"
-  },
-  "homepage": "https://automate.ax",
-  "bugs": {
-    "url": "https://github.com/zachsents/automate.ax/issues"
-  },
+  "homepage": "https://docs.automate.ax",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -73,7 +65,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "0.123.0",
-    "@automate.ax/codec": "0.161.0",
+    "@automate.ax/codec": "0.163.0",
     "@cfworker/json-schema": "^4.1.1",
     "@googleapis/calendar": "^16.0.0",
     "@googleapis/forms": "^6.0.1",
@@ -122,7 +114,8 @@
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "LICENSE"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",