@automate.ax/integration-contracts 0.125.0 → 0.127.0

package/dist/outlook/index.d.ts

@@ -53,8 +53,8 @@ export declare const OUTLOOK_MESSAGE_CREATED_EVENT_SCHEMA: z.ZodObject<{
         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";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -164,8 +164,8 @@ export declare const OUTLOOK_MESSAGE_UPDATED_EVENT_SCHEMA: z.ZodObject<{
         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";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -280,8 +280,8 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
         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";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -390,8 +390,8 @@ export declare const OUTLOOK_MESSAGE_CHANGE_EVENT_SCHEMA: z.ZodDiscriminatedUnio
         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";
+            normal: "normal";
         }>>;
         inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
             focused: "focused";
@@ -506,8 +506,8 @@ export declare const outlookTriggerContracts: {
             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";
+                normal: "normal";
             }>>;
             inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                 focused: "focused";
@@ -619,8 +619,8 @@ export declare const outlookTriggerContracts: {
                 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";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -729,8 +729,8 @@ export declare const outlookTriggerContracts: {
                 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";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -849,8 +849,8 @@ export declare const outlookTriggerContracts: {
                 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";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";
@@ -965,8 +965,8 @@ export declare const outlookTriggerContracts: {
                 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";
+                    normal: "normal";
                 }>>;
                 inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
                     focused: "focused";

package/dist/outlook/schemas.d.ts

@@ -5,8 +5,8 @@ export declare const OUTLOOK_BODY_TYPE_SCHEMA: z.ZodEnum<{
 }>;
 export declare const OUTLOOK_IMPORTANCE_SCHEMA: z.ZodEnum<{
     high: "high";
-    normal: "normal";
     low: "low";
+    normal: "normal";
 }>;
 export declare const OUTLOOK_FLAG_STATUS_SCHEMA: z.ZodEnum<{
     complete: "complete";
@@ -84,8 +84,8 @@ export declare const OUTLOOK_MESSAGE_SCHEMA: z.ZodObject<{
     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";
+        normal: "normal";
     }>>;
     inferenceClassification: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         focused: "focused";
@@ -197,8 +197,8 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     id: z.ZodString;
     importance: z.ZodOptional<z.ZodEnum<{
         high: "high";
-        normal: "normal";
         low: "low";
+        normal: "normal";
     }>>;
     inferenceClassification: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         focused: "focused";
@@ -242,7 +242,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
     hasAttachments: boolean;
     messageId: string;
     internetMessageId: string | undefined;
-    importance: "high" | "normal" | "low";
+    importance: "high" | "low" | "normal";
     inferenceClassification: "focused" | "other" | undefined;
     isDraft: boolean;
     isRead: boolean;
@@ -331,7 +331,7 @@ export declare const GRAPH_MESSAGE_SCHEMA: z.ZodPipe<z.ZodObject<{
         };
     } | null | undefined;
     hasAttachments?: boolean | undefined;
-    importance?: "high" | "normal" | "low" | undefined;
+    importance?: "high" | "low" | "normal" | undefined;
     inferenceClassification?: "focused" | "other" | null | undefined;
     internetMessageId?: string | null | undefined;
     isDraft?: boolean | undefined;
@@ -377,7 +377,7 @@ export declare function normalizeOutlookMessage(payload: unknown): {
     hasAttachments: boolean;
     messageId: string;
     internetMessageId: string | undefined;
-    importance: "high" | "normal" | "low";
+    importance: "high" | "low" | "normal";
     inferenceClassification: "focused" | "other" | undefined;
     isDraft: boolean;
     isRead: boolean;

package/dist/reddit/api.d.ts

@@ -0,0 +1,56 @@
+import * as z from "zod";
+export declare const REDDIT_OAUTH_SECRET_SCHEMA: z.ZodObject<{
+    accessToken: z.ZodString;
+    expiresAt: z.ZodNumber;
+    refreshToken: z.ZodString;
+    tokenType: z.ZodString;
+    userAgent: z.ZodString;
+}, z.core.$strip>;
+export declare const REDDIT_ERROR_TUPLE_SCHEMA: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodNullable<z.ZodString>], null>;
+export declare const REDDIT_JSON_STATUS_SCHEMA: z.ZodObject<{
+    json: z.ZodObject<{
+        errors: z.ZodArray<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodNullable<z.ZodString>], null>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export interface RedditRequestOptions<TSchema extends z.ZodType> {
+    body?: Record<string, boolean | number | string | undefined>;
+    method?: "DELETE" | "GET" | "POST" | "PUT";
+    query?: Record<string, boolean | number | string | readonly string[] | null | undefined>;
+    responseSchema: TSchema;
+}
+/** Error returned by a rejected Reddit Data API request. */
+export declare class RedditApiError extends Error {
+    readonly details: {
+        error?: number;
+        message?: string;
+        reason?: string;
+    } | {
+        errors: [string, string, null | string][];
+    } | {
+        response: string;
+    };
+    readonly retryAfter?: string;
+    readonly status: number;
+    /**
+     * Creates an error from a rejected Reddit response.
+     *
+     * @param status - HTTP response status.
+     * @param details - Parsed Reddit failure details.
+     * @param retryAfter - Provider retry delay in seconds, when present.
+     */
+    constructor(status: number, details: RedditApiError["details"], retryAfter?: string);
+}
+/**
+ * Creates an authenticated Reddit Data API client.
+ *
+ * @param secret - Stored Reddit OAuth credentials and registered User-Agent.
+ */
+export declare function getRedditApi(secret: unknown): {
+    /**
+     * Sends one request below Reddit's OAuth API origin.
+     *
+     * @param path - Relative Reddit API path.
+     * @param options - Request method, parameters, and response contract.
+     */
+    request<TSchema extends z.ZodType>(path: string, options: RedditRequestOptions<TSchema>): Promise<z.output<TSchema>>;
+};

package/dist/reddit/api.js

@@ -0,0 +1,135 @@
+import * as z from "zod";
+const REDDIT_API_ORIGIN = "https://oauth.reddit.com/";
+const REDDIT_API_URL = new URL(REDDIT_API_ORIGIN);
+export const REDDIT_OAUTH_SECRET_SCHEMA = z.object({
+    accessToken: z.string().min(1),
+    expiresAt: z.number().int().positive(),
+    refreshToken: z.string().min(1),
+    tokenType: z.string().min(1),
+    userAgent: z.string().min(1),
+});
+const REDDIT_API_ERROR_SCHEMA = z.looseObject({
+    error: z.number().int().optional(),
+    message: z.string().optional(),
+    reason: z.string().optional(),
+});
+export const REDDIT_ERROR_TUPLE_SCHEMA = z.tuple([
+    z.string(),
+    z.string(),
+    z.string().nullable(),
+]);
+const REDDIT_JSON_ERRORS_SCHEMA = z.looseObject({
+    json: z.object({
+        errors: REDDIT_ERROR_TUPLE_SCHEMA.array(),
+    }),
+});
+export const REDDIT_JSON_STATUS_SCHEMA = z.object({
+    json: z.object({ errors: REDDIT_ERROR_TUPLE_SCHEMA.array() }),
+});
+/** Error returned by a rejected Reddit Data API request. */
+export class RedditApiError extends Error {
+    details;
+    retryAfter;
+    status;
+    /**
+     * Creates an error from a rejected Reddit response.
+     *
+     * @param status - HTTP response status.
+     * @param details - Parsed Reddit failure details.
+     * @param retryAfter - Provider retry delay in seconds, when present.
+     */
+    constructor(status, details, retryAfter) {
+        const jsonError = "errors" in details ? details.errors[0]?.[1] : undefined;
+        super(("message" in details
+            ? (details.message ?? details.reason)
+            : undefined) ??
+            jsonError ??
+            `Reddit API request failed (${status}).`);
+        this.name = "RedditApiError";
+        this.details = details;
+        this.retryAfter = retryAfter;
+        this.status = status;
+    }
+}
+/**
+ * Creates an authenticated Reddit Data API client.
+ *
+ * @param secret - Stored Reddit OAuth credentials and registered User-Agent.
+ */
+export function getRedditApi(secret) {
+    const credentials = REDDIT_OAUTH_SECRET_SCHEMA.parse(secret);
+    return {
+        /**
+         * Sends one request below Reddit's OAuth API origin.
+         *
+         * @param path - Relative Reddit API path.
+         * @param options - Request method, parameters, and response contract.
+         */
+        async request(path, options) {
+            const normalizedPath = path.replace(/^\/+/, "");
+            if (!normalizedPath ||
+                normalizedPath.includes("://") ||
+                normalizedPath.includes("\\")) {
+                throw new TypeError("Reddit API paths must be relative.");
+            }
+            const url = new URL(normalizedPath, REDDIT_API_ORIGIN);
+            if (url.origin !== REDDIT_API_URL.origin) {
+                throw new TypeError("Reddit API paths must remain on oauth.reddit.com.");
+            }
+            url.searchParams.set("raw_json", "1");
+            for (const [key, value] of Object.entries(options.query ?? {})) {
+                if (value == null)
+                    continue;
+                url.searchParams.set(key, Array.isArray(value) ? value.join(",") : String(value));
+            }
+            const headers = new Headers({
+                Accept: "application/json",
+                Authorization: `${credentials.tokenType} ${credentials.accessToken}`,
+                "User-Agent": credentials.userAgent,
+            });
+            const body = options.body
+                ? new URLSearchParams(Object.entries(options.body).flatMap(([key, value]) => value === undefined
+                    ? []
+                    : [[key, String(value)]]))
+                : undefined;
+            if (body) {
+                headers.set("Content-Type", "application/x-www-form-urlencoded");
+            }
+            const response = await fetch(url, {
+                body,
+                headers,
+                method: options.method ?? "GET",
+            });
+            const text = await response.text();
+            const parsed = parseJson(text);
+            const jsonErrors = REDDIT_JSON_ERRORS_SCHEMA.safeParse(parsed);
+            const retryAfter = response.headers.get("Retry-After") ??
+                response.headers.get("X-Ratelimit-Reset") ??
+                undefined;
+            if (jsonErrors.success && jsonErrors.data.json.errors.length > 0) {
+                throw new RedditApiError(response.ok ? 400 : response.status, { errors: jsonErrors.data.json.errors }, retryAfter);
+            }
+            if (!response.ok) {
+                const error = REDDIT_API_ERROR_SCHEMA.safeParse(parsed);
+                throw new RedditApiError(response.status, error.success ? error.data : { response: text }, retryAfter);
+            }
+            const result = options.responseSchema.safeParse(parsed);
+            if (!result.success) {
+                throw new RedditApiError(response.status, { response: text });
+            }
+            return result.data;
+        },
+    };
+}
+/** Parses a provider body while preserving non-JSON failure text. */
+/** @param value - Raw provider response body. */
+function parseJson(value) {
+    if (!value)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}