@automate.ax/integration-contracts 0.55.0

package/dist/teams/graph.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+const GRAPH_BASE_URL = "https://graph.microsoft.com/v1.0/";
+const MICROSOFT_SECRET_SCHEMA = z.object({
+    accessToken: z.string().min(1),
+});
+const GRAPH_ERROR_SCHEMA = z.looseObject({
+    error: z
+        .looseObject({
+        code: z.string().optional(),
+        message: z.string().optional(),
+    })
+        .optional(),
+});
+/**
+ * Creates a small authenticated Microsoft Graph client for Teams APIs.
+ *
+ * The raw `fetch` method is an escape hatch for Graph operations not yet
+ * represented by a built-in action.
+ *
+ * @param secret - Refreshed Microsoft OAuth integration secret.
+ */
+export function getTeamsGraphApi(secret) {
+    const { accessToken } = MICROSOFT_SECRET_SCHEMA.parse(secret);
+    /**
+     * Performs one authenticated Graph request.
+     *
+     * @param path - Relative or absolute Microsoft Graph URL.
+     * @param init - Standard fetch request options.
+     */
+    async function graphFetch(path, init) {
+        const headers = new Headers(init?.headers);
+        headers.set("Accept", "application/json");
+        headers.set("Authorization", `Bearer ${accessToken}`);
+        return fetch(new URL(path.replace(/^\//, ""), GRAPH_BASE_URL), {
+            ...init,
+            headers,
+        });
+    }
+    /**
+     * Performs one authenticated Graph JSON request.
+     *
+     * @param path - Relative or absolute Microsoft Graph URL.
+     * @param options - HTTP method, body, and headers.
+     */
+    async function request(path, options = {}) {
+        const headers = new Headers(options.headers);
+        if (options.body !== undefined) {
+            headers.set("Content-Type", "application/json");
+        }
+        const response = await graphFetch(path, {
+            body: options.body === undefined ? undefined : JSON.stringify(options.body),
+            headers,
+            method: options.method,
+        });
+        if (!response.ok) {
+            const payload = GRAPH_ERROR_SCHEMA.safeParse(await response.json().catch(() => undefined));
+            const graphError = payload.success ? payload.data.error : undefined;
+            const detail = [graphError?.code, graphError?.message]
+                .filter(Boolean)
+                .join(": ");
+            throw new Error(`Microsoft Graph request failed with ${response.status} ${response.statusText}${detail ? `: ${detail}` : ""}.`);
+        }
+        if (response.status === 202 || response.status === 204)
+            return undefined;
+        return response.json();
+    }
+    return {
+        /** Performs an authenticated request and returns the raw Response. */
+        fetch: graphFetch,
+        /** Performs an authenticated request and returns its untrusted JSON value. */
+        request,
+    };
+}
+/**
+ * Reads Graph collection pages until the requested limit is reached.
+ *
+ * @param request - Authenticated Graph JSON request function.
+ * @param path - Initial relative Graph path.
+ * @param itemSchema - Schema for one collection item.
+ * @param limit - Maximum total items.
+ */
+export async function listTeamsGraphCollection(request, path, itemSchema, limit) {
+    const pageSchema = z.object({
+        "@odata.nextLink": z.string().optional(),
+        value: itemSchema.array(),
+    });
+    const items = [];
+    let nextPath = path;
+    while (nextPath && items.length < limit) {
+        const page = pageSchema.parse(await request(nextPath));
+        items.push(...page.value);
+        nextPath = page["@odata.nextLink"];
+    }
+    return items.slice(0, limit);
+}

package/dist/teams/index.d.ts

@@ -0,0 +1,164 @@
+import { z } from "zod";
+export * from "./graph.js";
+export * from "./schemas.js";
+export declare const TEAMS_CHANNEL_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{
+    channel: z.ZodString;
+    team: z.ZodString;
+}, z.core.$strip>;
+export declare const TEAMS_CHAT_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{
+    chatId: z.ZodString;
+}, z.core.$strip>;
+export declare const teamsTriggerContracts: {
+    readonly "teams.channel.message.posted": {
+        readonly configSchema: z.ZodObject<{
+            channel: z.ZodString;
+            team: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            attachments: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                attachmentId: z.ZodString;
+                content: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                contentType: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                contentUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            body: z.ZodObject<{
+                content: z.ZodString;
+                contentType: z.ZodEnum<{
+                    text: "text";
+                    html: "html";
+                }>;
+            }, z.core.$strip>;
+            createdAt: 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>>;
+            deletedAt: 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>>;
+            etag: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            from: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>, z.ZodTransform<{
+                applicationId: string | undefined;
+                deviceId: string | undefined;
+                displayName: string | undefined;
+                userId: string | undefined;
+            } | undefined, {
+                applicationId: string | undefined;
+                deviceId: string | undefined;
+                displayName: string | undefined;
+                userId: string | undefined;
+            } | null | undefined>>;
+            importance: z.ZodPrefault<z.ZodEnum<{
+                high: "high";
+                normal: "normal";
+                unknownFutureValue: "unknownFutureValue";
+                urgent: "urgent";
+            }>>;
+            locale: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            messageId: z.ZodString;
+            messageType: z.ZodString;
+            mentions: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                mentionId: z.ZodNumber;
+                mentionText: z.ZodString;
+                mentioned: z.ZodObject<{
+                    applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>>;
+            reactions: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                reactionType: z.ZodString;
+                createdAt: 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>>;
+                user: z.ZodObject<{
+                    applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>>;
+            replyToId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            subject: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            summary: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            updatedAt: 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>>;
+            webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            channelId: z.ZodString;
+            teamId: z.ZodString;
+        }, z.core.$strip>;
+    };
+    readonly "teams.chat.message.posted": {
+        readonly configSchema: z.ZodObject<{
+            chatId: z.ZodString;
+        }, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            attachments: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                attachmentId: z.ZodString;
+                content: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                contentType: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                contentUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            body: z.ZodObject<{
+                content: z.ZodString;
+                contentType: z.ZodEnum<{
+                    text: "text";
+                    html: "html";
+                }>;
+            }, z.core.$strip>;
+            createdAt: 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>>;
+            deletedAt: 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>>;
+            etag: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            from: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>, z.ZodTransform<{
+                applicationId: string | undefined;
+                deviceId: string | undefined;
+                displayName: string | undefined;
+                userId: string | undefined;
+            } | undefined, {
+                applicationId: string | undefined;
+                deviceId: string | undefined;
+                displayName: string | undefined;
+                userId: string | undefined;
+            } | null | undefined>>;
+            importance: z.ZodPrefault<z.ZodEnum<{
+                high: "high";
+                normal: "normal";
+                unknownFutureValue: "unknownFutureValue";
+                urgent: "urgent";
+            }>>;
+            locale: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            messageId: z.ZodString;
+            messageType: z.ZodString;
+            mentions: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                mentionId: z.ZodNumber;
+                mentionText: z.ZodString;
+                mentioned: z.ZodObject<{
+                    applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>>;
+            reactions: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                reactionType: z.ZodString;
+                createdAt: 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>>;
+                user: z.ZodObject<{
+                    applicationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    deviceId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    displayName: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                    userId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+                }, z.core.$strip>;
+            }, z.core.$strip>>>;
+            replyToId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            subject: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            summary: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            updatedAt: 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>>;
+            webUrl: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            chatId: z.ZodString;
+        }, z.core.$strip>;
+    };
+};

package/dist/teams/index.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { TEAMS_CHANNEL_MESSAGE_POSTED_EVENT_SCHEMA, TEAMS_CHAT_MESSAGE_POSTED_EVENT_SCHEMA, } from "./schemas.js";
+export * from "./graph.js";
+export * from "./schemas.js";
+export const TEAMS_CHANNEL_TRIGGER_CONFIG_SCHEMA = z.object({
+    channel: z.string().trim().min(1),
+    team: z.string().trim().min(1),
+});
+export const TEAMS_CHAT_TRIGGER_CONFIG_SCHEMA = z.object({
+    chatId: z.string().min(1),
+});
+export const teamsTriggerContracts = {
+    "teams.channel.message.posted": {
+        configSchema: TEAMS_CHANNEL_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: TEAMS_CHANNEL_MESSAGE_POSTED_EVENT_SCHEMA,
+    },
+    "teams.chat.message.posted": {
+        configSchema: TEAMS_CHAT_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: TEAMS_CHAT_MESSAGE_POSTED_EVENT_SCHEMA,
+    },
+};