@automate.ax/integration-contracts 0.124.0 → 0.126.0

package/dist/notion/schemas.d.ts

@@ -1419,8 +1419,8 @@ declare const RAW_NOTION_EVENT_SCHEMA: z.ZodDiscriminatedUnion<[z.ZodObject<{
             }>;
         }, z.core.$strip>;
         updated_fields: z.ZodArray<z.ZodEnum<{
-            name: "name";
             filter: "filter";
+            name: "name";
             sorts: "sorts";
             configuration: "configuration";
         }>>;
@@ -2877,8 +2877,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
             }>;
         }, z.core.$strip>;
         updated_fields: z.ZodArray<z.ZodEnum<{
-            name: "name";
             filter: "filter";
+            name: "name";
             sorts: "sorts";
             configuration: "configuration";
         }>>;
@@ -2919,8 +2919,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     workspace_name: z.ZodString;
 }, z.core.$catchall<z.ZodJSONSchema>>], "type">, z.ZodTransform<{
     type: "comment.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -2951,8 +2951,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "comment.deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -2983,8 +2983,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "comment.updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3015,8 +3015,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.content_updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3051,8 +3051,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3083,8 +3083,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3115,8 +3115,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.moved";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3147,8 +3147,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.schema_updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3184,8 +3184,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "data_source.undeleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3216,8 +3216,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "database.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3248,8 +3248,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "database.deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3280,8 +3280,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "database.moved";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3312,8 +3312,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "database.undeleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3344,8 +3344,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "file_upload.completed";
-    timestamp: string;
     id: string;
+    timestamp: string;
     workspaceId: string;
     workspaceName: string;
     subscriptionId: string;
@@ -3369,8 +3369,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "file_upload.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     workspaceId: string;
     workspaceName: string;
     subscriptionId: string;
@@ -3394,8 +3394,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "file_upload.expired";
-    timestamp: string;
     id: string;
+    timestamp: string;
     workspaceId: string;
     workspaceName: string;
     subscriptionId: string;
@@ -3419,8 +3419,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "file_upload.upload_failed";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         fileImportResult: {
             type: "success";
@@ -3463,8 +3463,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.content_updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3499,8 +3499,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3531,8 +3531,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3563,8 +3563,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.locked";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3595,8 +3595,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.moved";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3627,8 +3627,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.properties_updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3660,8 +3660,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.transcription_block.transcript_deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         target: {
             id: string;
@@ -3692,8 +3692,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.undeleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3724,8 +3724,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "page.unlocked";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3756,8 +3756,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "view.created";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3789,8 +3789,8 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "view.deleted";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
@@ -3821,15 +3821,15 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
     }[];
 } | {
     type: "view.updated";
-    timestamp: string;
     id: string;
+    timestamp: string;
     data: {
         parent: {
             id: string;
             type: "team" | "page" | "space" | "agent" | "block" | "database";
             dataSourceId?: string | undefined;
         };
-        updatedFields: ("name" | "filter" | "sorts" | "configuration")[];
+        updatedFields: ("filter" | "name" | "sorts" | "configuration")[];
     };
     workspaceId: string;
     workspaceName: string;
@@ -4956,7 +4956,7 @@ export declare const NOTION_EVENT_SCHEMA: z.ZodPipe<z.ZodDiscriminatedUnion<[z.Z
             type: "team" | "page" | "space" | "agent" | "block" | "database";
             data_source_id?: string | undefined;
         };
-        updated_fields: ("name" | "filter" | "sorts" | "configuration")[];
+        updated_fields: ("filter" | "name" | "sorts" | "configuration")[];
     };
     entity: {
         id: string;

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;
+    }
+}