@automate.ax/integration-contracts 0.161.0 → 0.163.1

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.1",
   "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.1",
     "@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",

package/src/github/additional-events.ts

@@ -379,6 +379,7 @@ export type GitHubDeploymentStatusEvent =
         | "pending"
         | "queued"
         | "success"
+        | "waiting"
     }
   }
 export type GitHubDeploymentQueuedEvent = GitHubDeploymentStatusEvent & {
@@ -1017,6 +1018,7 @@ export const GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA: GitHubWebhookSchema<GitHubDe
         "pending",
         "queued",
         "success",
+        "waiting",
       ].includes(event.deployment_status.state),
   )
 export const GITHUB_DEPLOYMENT_QUEUED_EVENT_SCHEMA: GitHubWebhookSchema<GitHubDeploymentQueuedEvent> =

package/src/github/openapi-types.generated.ts

@@ -4561,7 +4561,6 @@ export type components = {
             /** @description Information about the Git author */
             author: {
                 /**
-                 * Format: email
                  * @description Git email address of the commit's author
                  * @example monalisa.octocat@example.com
                  */
@@ -4575,7 +4574,6 @@ export type components = {
             /** @description Information about the Git committer */
             committer: {
                 /**
-                 * Format: email
                  * @description Git email address of the commit's committer
                  * @example monalisa.octocat@example.com
                  */
@@ -5092,7 +5090,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -5105,7 +5102,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -5348,7 +5344,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -5361,7 +5356,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -5604,7 +5598,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -5617,7 +5610,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -46446,7 +46438,6 @@ export type components = {
                 author: {
                     /** Format: date-time */
                     date?: string;
-                    /** Format: email */
                     email: string | null;
                     /** @description The git author's name. */
                     name: string;
@@ -46459,7 +46450,6 @@ export type components = {
                 committer: {
                     /** Format: date-time */
                     date?: string;
-                    /** Format: email */
                     email: string | null;
                     /** @description The git author's name. */
                     name: string;
@@ -46506,7 +46496,6 @@ export type components = {
                 author: {
                     /** Format: date-time */
                     date?: string;
-                    /** Format: email */
                     email: string | null;
                     /** @description The git author's name. */
                     name: string;
@@ -46519,7 +46508,6 @@ export type components = {
                 committer: {
                     /** Format: date-time */
                     date?: string;
-                    /** Format: email */
                     email: string | null;
                     /** @description The git author's name. */
                     name: string;
@@ -46555,7 +46543,6 @@ export type components = {
             pusher: {
                 /** Format: date-time */
                 date?: string;
-                /** Format: email */
                 email?: string | null;
                 /** @description The git author's name. */
                 name: string;
@@ -47329,7 +47316,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -47343,7 +47329,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -47895,7 +47880,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -47908,7 +47892,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -48346,7 +48329,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -48359,7 +48341,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -48796,7 +48777,6 @@ export type components = {
                     author: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;
@@ -48809,7 +48789,6 @@ export type components = {
                     committer: {
                         /** Format: date-time */
                         date?: string;
-                        /** Format: email */
                         email: string | null;
                         /** @description The git author's name. */
                         name: string;