@automate.ax/integration-contracts 0.55.0

package/dist/outlook/graph.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod";
+/** Options accepted by the authenticated Outlook Graph request helper. */
+export interface OutlookGraphRequestOptions {
+    /** JSON-serializable request body. */
+    body?: unknown;
+    /** Additional HTTP headers. */
+    headers?: RequestInit["headers"];
+    /** HTTP method. */
+    method?: string;
+}
+/**
+ * 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.
+ *
+ * @param secret - Refreshed Microsoft OAuth integration secret.
+ */
+export declare function getOutlookGraphApi(secret: Record<string, unknown>): {
+    /** Performs an authenticated request and returns the raw Response. */
+    fetch: (path: string, init?: RequestInit) => Promise<Response>;
+    /** Performs an authenticated request and returns its untrusted JSON value. */
+    request: (path: string, options?: OutlookGraphRequestOptions) => Promise<unknown>;
+};
+/**
+ * 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 declare function listOutlookGraphCollection<T>(request: (path: string) => Promise<unknown>, path: string, itemSchema: z.ZodType<T>, limit: number): Promise<T[]>;

package/dist/outlook/graph.js

@@ -0,0 +1,98 @@
+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 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.
+ *
+ * @param secret - Refreshed Microsoft OAuth integration secret.
+ */
+export function getOutlookGraphApi(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}`);
+        if (!headers.has("Prefer"))
+            headers.set("Prefer", 'IdType="ImmutableId"');
+        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 listOutlookGraphCollection(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/outlook/index.d.ts

@@ -0,0 +1,115 @@
+import { z } from "zod";
+export * from "./graph.js";
+export * from "./schemas.js";
+export declare const OUTLOOK_TRIGGER_CONFIG_SCHEMA: z.ZodObject<{}, z.core.$strip>;
+export declare const outlookTriggerContracts: {
+    readonly "outlook.email.received": {
+        readonly configSchema: z.ZodObject<{}, z.core.$strip>;
+        readonly eventSchema: z.ZodObject<{
+            categories: z.ZodPrefault<z.ZodArray<z.ZodString>>;
+            conversationId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            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>>;
+            flag: z.ZodOptional<z.ZodObject<{
+                completedAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    dateTime: z.ZodString;
+                    timeZone: z.ZodString;
+                }, z.core.$strip>>>, z.ZodTransform<{
+                    dateTime: string;
+                    timeZone: string;
+                } | undefined, {
+                    dateTime: string;
+                    timeZone: string;
+                } | null | undefined>>;
+                dueAt: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                    dateTime: z.ZodString;
+                    timeZone: z.ZodString;
+                }, z.core.$strip>>>, z.ZodTransform<{
+                    dateTime: string;
+                    timeZone: string;
+                } | undefined, {
+                    dateTime: string;
+                    timeZone: string;
+                } | null | undefined>>;
+                status: z.ZodEnum<{
+                    notFlagged: "notFlagged";
+                    complete: "complete";
+                    flagged: "flagged";
+                }>;
+            }, z.core.$strip>>;
+            from: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>, z.ZodTransform<{
+                address: string;
+                name: string | undefined;
+            } | undefined, {
+                address: string;
+                name: string | undefined;
+            } | null | undefined>>;
+            hasAttachments: z.ZodPrefault<z.ZodBoolean>;
+            messageId: z.ZodString;
+            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";
+            }>>;
+            inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                focused: "focused";
+                other: "other";
+            }>>>, z.ZodTransform<"focused" | "other" | undefined, "focused" | "other" | 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>>;
+            parentFolderId: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            preview: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            receivedAt: 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>>;
+            replyTo: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            sender: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>, z.ZodTransform<{
+                address: string;
+                name: string | undefined;
+            } | undefined, {
+                address: string;
+                name: string | undefined;
+            } | null | undefined>>;
+            sentAt: 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>>;
+            subject: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string, string | null | undefined>>;
+            to: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            cc: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            bcc: z.ZodPrefault<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                name: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            }, z.core.$strip>>>;
+            webLink: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodString>>, z.ZodTransform<string | undefined, string | null | undefined>>;
+            body: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                content: z.ZodString;
+                contentType: z.ZodPipe<z.ZodUnion<[z.ZodEnum<{
+                    text: "text";
+                    html: "html";
+                }>, z.ZodEnum<{
+                    Text: "Text";
+                    HTML: "HTML";
+                }>]>, z.ZodTransform<"text" | "html", "text" | "html" | "Text" | "HTML">>;
+            }, z.core.$strip>>>, z.ZodTransform<{
+                content: string;
+                contentType: "text" | "html";
+            } | undefined, {
+                content: string;
+                contentType: "text" | "html";
+            } | null | undefined>>;
+            etag: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+};

package/dist/outlook/index.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+import { OUTLOOK_MESSAGE_SCHEMA } from "./schemas.js";
+export * from "./graph.js";
+export * from "./schemas.js";
+export const OUTLOOK_TRIGGER_CONFIG_SCHEMA = z.object({});
+export const outlookTriggerContracts = {
+    "outlook.email.received": {
+        configSchema: OUTLOOK_TRIGGER_CONFIG_SCHEMA,
+        eventSchema: OUTLOOK_MESSAGE_SCHEMA,
+    },
+};