@automate.ax/integration-contracts 0.139.2 → 0.141.0

package/dist/closebot/api.d.ts

@@ -0,0 +1,39 @@
+import { type Encodable } from "@automate.ax/codec";
+import * as z from "zod";
+export declare const CLOSEBOT_VALUE_SCHEMA: z.ZodCustom<Encodable, Encodable>;
+export declare const CLOSEBOT_RESPONSE_SCHEMA: z.ZodUnion<readonly [z.ZodCustom<Encodable, Encodable>, z.ZodPipe<z.ZodUndefined, z.ZodTransform<null, undefined>>]>;
+interface CloseBotRequestOptions<TSchema extends z.ZodType> {
+    body?: Encodable | FormData;
+    method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT";
+    query?: Record<string, boolean | Date | number | string | (boolean | Date | number | string)[] | null | undefined>;
+    responseSchema: TSchema;
+}
+/** Error returned by a rejected CloseBot API request. */
+export declare class CloseBotApiError extends Error {
+    readonly details: Encodable;
+    readonly retryAfter?: string;
+    readonly status: number;
+    /**
+     * Creates an error from a rejected CloseBot response.
+     *
+     * @param status - HTTP response status.
+     * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
+     */
+    constructor(status: number, details: Encodable, retryAfter?: string);
+}
+/**
+ * Creates an authenticated CloseBot REST API client.
+ *
+ * @param secret - Stored CloseBot API key.
+ */
+export declare function getCloseBotApi(secret: unknown): {
+    /**
+     * Sends one JSON request to a CloseBot API path.
+     *
+     * @param path - Relative path below the CloseBot API origin.
+     * @param options - Request method, query, body, and response schema.
+     */
+    request<TSchema extends z.ZodType>(path: string, options: CloseBotRequestOptions<TSchema>): Promise<z.output<TSchema>>;
+};
+export {};

package/dist/closebot/api.js

@@ -0,0 +1,117 @@
+import { isEncodable } from "@automate.ax/codec";
+import * as z from "zod";
+const CLOSEBOT_API_ORIGIN = "https://api.closebot.com/";
+const CLOSEBOT_SECRET_SCHEMA = z.object({
+    apiKey: z.string().trim().min(1),
+});
+export const CLOSEBOT_VALUE_SCHEMA = z.custom(isEncodable, {
+    message: "Expected a codec-safe CloseBot value.",
+});
+export const CLOSEBOT_RESPONSE_SCHEMA = z.union([
+    CLOSEBOT_VALUE_SCHEMA,
+    z.undefined().transform(() => null),
+]);
+/** Error returned by a rejected CloseBot API request. */
+export class CloseBotApiError extends Error {
+    details;
+    retryAfter;
+    status;
+    /**
+     * Creates an error from a rejected CloseBot response.
+     *
+     * @param status - HTTP response status.
+     * @param details - Codec-safe response details.
+     * @param retryAfter - Raw provider retry timing, when present.
+     */
+    constructor(status, details, retryAfter) {
+        super(`CloseBot API request failed (${status}).`);
+        this.name = "CloseBotApiError";
+        this.details = details;
+        this.retryAfter = retryAfter;
+        this.status = status;
+    }
+}
+/**
+ * Creates an authenticated CloseBot REST API client.
+ *
+ * @param secret - Stored CloseBot API key.
+ */
+export function getCloseBotApi(secret) {
+    const { apiKey } = CLOSEBOT_SECRET_SCHEMA.parse(secret);
+    const root = new URL(CLOSEBOT_API_ORIGIN);
+    return {
+        /**
+         * Sends one JSON request to a CloseBot API path.
+         *
+         * @param path - Relative path below the CloseBot API origin.
+         * @param options - Request method, query, body, and response schema.
+         */
+        async request(path, options) {
+            const normalizedPath = path.replace(/^\/+/, "");
+            if (!normalizedPath ||
+                normalizedPath.includes("://") ||
+                normalizedPath.includes("\\")) {
+                throw new TypeError("CloseBot API paths must be relative.");
+            }
+            const url = new URL(normalizedPath, root);
+            if (url.origin !== root.origin) {
+                throw new TypeError("CloseBot API paths must remain on api.closebot.com.");
+            }
+            for (const [key, value] of Object.entries(options.query ?? {})) {
+                if (value == null)
+                    continue;
+                if (Array.isArray(value)) {
+                    for (const item of value)
+                        url.searchParams.append(key, queryValue(item));
+                }
+                else {
+                    url.searchParams.set(key, queryValue(value));
+                }
+            }
+            const headers = new Headers({
+                Accept: "application/json",
+                "X-CB-KEY": apiKey,
+            });
+            if (options.body !== undefined && !(options.body instanceof FormData)) {
+                headers.set("Content-Type", "application/json");
+            }
+            const response = await fetch(url, {
+                body: options.body === undefined
+                    ? undefined
+                    : options.body instanceof FormData
+                        ? options.body
+                        : JSON.stringify(options.body),
+                headers,
+                method: options.method ?? "GET",
+                redirect: "error",
+            });
+            const text = await response.text();
+            const parsed = CLOSEBOT_RESPONSE_SCHEMA.safeParse(text ? parseJson(text) : null);
+            if (!response.ok || !parsed.success) {
+                throw new CloseBotApiError(response.status, parsed.success ? parsed.data : { response: text }, response.headers.get("Retry-After") ?? undefined);
+            }
+            return options.responseSchema.parse(parsed.data);
+        },
+    };
+}
+/**
+ * Parses a response while retaining non-JSON provider diagnostics.
+ *
+ * @param value - Raw response body.
+ */
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+/**
+ * Serializes one supported query value.
+ *
+ * @param value - Public query value.
+ */
+function queryValue(value) {
+    return value instanceof Date ? value.toISOString() : String(value);
+}

package/dist/closebot/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./api.js";
+export * from "./schemas.js";

package/dist/closebot/index.js

@@ -0,0 +1,2 @@
+export * from "./api.js";
+export * from "./schemas.js";