@automate.ax/integration-contracts 0.55.0

package/dist/asana/schemas.js

@@ -0,0 +1,512 @@
+import { z } from "zod";
+export const ASANA_RESOURCE_SCHEMA = z.object({
+    /** Stable Asana globally unique identifier. */
+    id: z.string(),
+    /** Human-readable resource name, when available. */
+    name: z.string().optional(),
+    /** Provider resource type. */
+    type: z.string().optional(),
+});
+export const ASANA_PAGE_INFO_SCHEMA = z.object({
+    /** Opaque token for the next page, when more results are available. */
+    nextOffset: z.string().optional(),
+});
+export const ASANA_WORKSPACE_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** Domains associated with this workspace. */
+    emailDomains: z.string().array(),
+    /** Whether the workspace is an Asana organization. */
+    isOrganization: z.boolean(),
+});
+export const ASANA_USER_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** User email when the caller can access it. */
+    email: z.string().optional(),
+    /** URL of the user's profile photo. */
+    photoUrl: z.string().optional(),
+    /** Workspaces visible for the user. */
+    workspaces: ASANA_RESOURCE_SCHEMA.array(),
+});
+export const ASANA_PROJECT_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** Whether the project is archived. */
+    archived: z.boolean(),
+    /** Asana project color. */
+    color: z.string().optional(),
+    /** RFC 3339 creation timestamp. */
+    createdAt: z.string().optional(),
+    /** Default project layout. */
+    defaultView: z.string().optional(),
+    /** Project due date. */
+    dueOn: z.string().optional(),
+    /** Project description as HTML. */
+    htmlNotes: z.string().optional(),
+    /** RFC 3339 last-modified timestamp. */
+    modifiedAt: z.string().optional(),
+    /** Plain-text project description. */
+    notes: z.string().optional(),
+    /** Web URL for the project. */
+    permalinkUrl: z.string().optional(),
+    /** Whether the project is public to its organization or team. */
+    public: z.boolean(),
+    /** Project start date. */
+    startOn: z.string().optional(),
+    /** Team containing the project. */
+    team: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Workspace containing the project. */
+    workspace: ASANA_RESOURCE_SCHEMA.optional(),
+});
+export const ASANA_SECTION_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** RFC 3339 creation timestamp. */
+    createdAt: z.string().optional(),
+    /** Project containing the section. */
+    project: ASANA_RESOURCE_SCHEMA.optional(),
+});
+export const ASANA_TASK_MEMBERSHIP_SCHEMA = z.object({
+    /** Project containing this task membership. */
+    project: ASANA_RESOURCE_SCHEMA,
+    /** Section containing the task in this project. */
+    section: ASANA_RESOURCE_SCHEMA.optional(),
+});
+export const ASANA_TASK_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** Current assignee. */
+    assignee: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Task status within the assignee's My Tasks list. */
+    assigneeStatus: z.string().optional(),
+    /** Whether the task is complete. */
+    completed: z.boolean(),
+    /** RFC 3339 completion timestamp. */
+    completedAt: z.string().optional(),
+    /** User who completed the task. */
+    completedBy: ASANA_RESOURCE_SCHEMA.optional(),
+    /** RFC 3339 creation timestamp. */
+    createdAt: z.string().optional(),
+    /** User who created the task. */
+    createdBy: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Provider-native custom field values. */
+    customFields: z.json().array(),
+    /** Task due timestamp, for tasks with a due time. */
+    dueAt: z.string().optional(),
+    /** Task due date. */
+    dueOn: z.string().optional(),
+    /** Followers subscribed to task changes. */
+    followers: ASANA_RESOURCE_SCHEMA.array(),
+    /** Task description as HTML. */
+    htmlNotes: z.string().optional(),
+    /** Project and section placements for the task. */
+    memberships: ASANA_TASK_MEMBERSHIP_SCHEMA.array(),
+    /** RFC 3339 last-modified timestamp. */
+    modifiedAt: z.string().optional(),
+    /** Plain-text task description. */
+    notes: z.string().optional(),
+    /** Parent task for a subtask. */
+    parent: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Web URL for the task. */
+    permalinkUrl: z.string().optional(),
+    /** Task projects. */
+    projects: ASANA_RESOURCE_SCHEMA.array(),
+    /** Asana task subtype. */
+    subtype: z.string().optional(),
+    /** Task start timestamp, for tasks with a start time. */
+    startAt: z.string().optional(),
+    /** Task start date. */
+    startOn: z.string().optional(),
+    /** Tags attached to the task. */
+    tags: ASANA_RESOURCE_SCHEMA.array(),
+    /** Workspace containing the task. */
+    workspace: ASANA_RESOURCE_SCHEMA.optional(),
+});
+export const ASANA_STORY_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** RFC 3339 creation timestamp. */
+    createdAt: z.string().optional(),
+    /** User who created the story. */
+    createdBy: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Rich-text comment content. */
+    htmlText: z.string().optional(),
+    /** Whether the comment was edited. */
+    isEdited: z.boolean(),
+    /** Whether the story is pinned. */
+    isPinned: z.boolean(),
+    /** Story subtype, such as `comment_added`. */
+    subtype: z.string().optional(),
+    /** Plain-text story or comment content. */
+    text: z.string(),
+});
+export const ASANA_EVENT_ACTION_SCHEMA = z.enum([
+    "added",
+    "changed",
+    "deleted",
+    "removed",
+    "undeleted",
+]);
+export const ASANA_EVENT_CHANGE_SCHEMA = z.object({
+    /** Provider change category for the affected field. */
+    action: z.enum(["added", "changed", "removed"]),
+    /** Added field value, when the provider includes one. */
+    addedValue: z.json().optional(),
+    /** Name of the changed resource field. */
+    field: z.string(),
+    /** New field value, when the provider includes one. */
+    newValue: z.json().optional(),
+    /** Removed field value, when the provider includes one. */
+    removedValue: z.json().optional(),
+});
+export const ASANA_EVENT_SCHEMA = z.object({
+    /** Provider change category. */
+    action: ASANA_EVENT_ACTION_SCHEMA,
+    /** Field-level change details, when available. */
+    change: ASANA_EVENT_CHANGE_SCHEMA.optional(),
+    /** RFC 3339 timestamp when Asana recorded the event. */
+    createdAt: z.string(),
+    /** Parent resource through which the event propagated. */
+    parent: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Resource that directly caused the event. */
+    resource: ASANA_RESOURCE_SCHEMA,
+    /** Provider subtype of the changed resource, when available. */
+    resourceSubtype: z.string().optional(),
+    /** Provider resource category that caused the event. */
+    resourceType: z.string(),
+    /** User responsible for the change, when available. */
+    user: ASANA_RESOURCE_SCHEMA.optional(),
+    /** Resource selected when the webhook subscription was created. */
+    watchedResourceId: z.string(),
+});
+const ASANA_TASK_ADDED_WEBHOOK_EVENT_SCHEMA = ASANA_EVENT_SCHEMA.extend({
+    action: z.literal("added"),
+    resourceType: z.literal("task"),
+});
+const ASANA_TASK_CHANGED_WEBHOOK_EVENT_SCHEMA = ASANA_EVENT_SCHEMA.extend({
+    action: z.literal("changed"),
+    resourceType: z.literal("task"),
+});
+const ASANA_TASK_REMOVED_WEBHOOK_EVENT_SCHEMA = ASANA_EVENT_SCHEMA.extend({
+    action: z.literal("removed"),
+    resourceType: z.literal("task"),
+});
+const ASANA_TASK_DELETED_WEBHOOK_EVENT_SCHEMA = ASANA_EVENT_SCHEMA.extend({
+    action: z.literal("deleted"),
+    resourceType: z.literal("task"),
+});
+const ASANA_TASK_COMPLETED_WEBHOOK_EVENT_SCHEMA = ASANA_TASK_CHANGED_WEBHOOK_EVENT_SCHEMA.extend({
+    change: ASANA_EVENT_CHANGE_SCHEMA.extend({
+        action: z.literal("changed"),
+        field: z.literal("completed"),
+        newValue: z.literal(true).optional(),
+    }),
+});
+const ASANA_COMMENT_ADDED_WEBHOOK_EVENT_SCHEMA = ASANA_EVENT_SCHEMA.extend({
+    action: z.literal("added"),
+    resourceType: z.literal("story"),
+});
+const ASANA_TASK_EVENT_RESOURCE_SCHEMA = ASANA_RESOURCE_SCHEMA.extend({
+    /** Provider resource type narrowed by the semantic trigger. */
+    type: z.literal("task"),
+});
+export const ASANA_TASK_ADDED_EVENT_SCHEMA = ASANA_TASK_EVENT_RESOURCE_SCHEMA.extend({
+    /** Complete normalized compact webhook event. */
+    event: ASANA_TASK_ADDED_WEBHOOK_EVENT_SCHEMA,
+});
+export const ASANA_TASK_CHANGED_EVENT_SCHEMA = ASANA_TASK_EVENT_RESOURCE_SCHEMA.extend({
+    /** Complete normalized compact webhook event. */
+    event: ASANA_TASK_CHANGED_WEBHOOK_EVENT_SCHEMA,
+});
+export const ASANA_TASK_REMOVED_EVENT_SCHEMA = ASANA_TASK_EVENT_RESOURCE_SCHEMA.extend({
+    /** Complete normalized compact webhook event. */
+    event: ASANA_TASK_REMOVED_WEBHOOK_EVENT_SCHEMA,
+});
+export const ASANA_TASK_DELETED_EVENT_SCHEMA = ASANA_TASK_EVENT_RESOURCE_SCHEMA.extend({
+    /** Complete normalized compact webhook event. */
+    event: ASANA_TASK_DELETED_WEBHOOK_EVENT_SCHEMA,
+});
+export const ASANA_TASK_COMPLETED_EVENT_SCHEMA = ASANA_TASK_SCHEMA.extend({
+    /** Completion is revalidated against the current task. */
+    completed: z.literal(true),
+    /** Complete normalized compact webhook event. */
+    event: ASANA_TASK_COMPLETED_WEBHOOK_EVENT_SCHEMA,
+    /** Provider resource type narrowed by the semantic trigger. */
+    type: z.literal("task"),
+});
+export const ASANA_COMMENT_ADDED_EVENT_SCHEMA = ASANA_STORY_SCHEMA.extend({
+    /** Complete normalized compact webhook event. */
+    event: ASANA_COMMENT_ADDED_WEBHOOK_EVENT_SCHEMA,
+    /** Comment subtype narrowed by the semantic trigger. */
+    subtype: z.literal("comment_added"),
+    /** Provider resource type narrowed by the semantic trigger. */
+    type: z.literal("story"),
+});
+export const ASANA_PROVIDER_RESOURCE_SCHEMA = z.looseObject({
+    gid: z.string(),
+    name: z.string().optional(),
+    resource_subtype: z.string().optional(),
+    resource_type: z.string().optional(),
+});
+export const ASANA_PROVIDER_PAGE_SCHEMA = z.looseObject({
+    next_page: z
+        .looseObject({
+        offset: z.string(),
+    })
+        .nullable()
+        .optional(),
+});
+const ASANA_PROVIDER_MEMBERSHIP_SCHEMA = z.looseObject({
+    project: ASANA_PROVIDER_RESOURCE_SCHEMA,
+    section: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+});
+export const ASANA_PROVIDER_WORKSPACE_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    email_domains: z.string().array().prefault([]),
+    is_organization: z.boolean().prefault(false),
+});
+export const ASANA_PROVIDER_USER_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    email: z.string().optional(),
+    photo: z
+        .looseObject({
+        image_128x128: z.string().optional(),
+    })
+        .nullish(),
+    workspaces: ASANA_PROVIDER_RESOURCE_SCHEMA.array().prefault([]),
+});
+export const ASANA_PROVIDER_PROJECT_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    archived: z.boolean().prefault(false),
+    color: z.string().nullish(),
+    created_at: z.string().optional(),
+    default_view: z.string().optional(),
+    due_on: z.string().nullish(),
+    html_notes: z.string().optional(),
+    modified_at: z.string().optional(),
+    notes: z.string().optional(),
+    permalink_url: z.string().optional(),
+    public: z.boolean().prefault(false),
+    start_on: z.string().nullish(),
+    team: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    workspace: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+});
+export const ASANA_PROVIDER_SECTION_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    created_at: z.string().optional(),
+    project: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+});
+export const ASANA_PROVIDER_TASK_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    assignee: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    assignee_status: z.string().optional(),
+    completed: z.boolean().prefault(false),
+    completed_at: z.string().nullish(),
+    completed_by: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    created_at: z.string().optional(),
+    created_by: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    custom_fields: z.json().array().prefault([]),
+    due_at: z.string().nullish(),
+    due_on: z.string().nullish(),
+    followers: ASANA_PROVIDER_RESOURCE_SCHEMA.array().prefault([]),
+    html_notes: z.string().optional(),
+    memberships: ASANA_PROVIDER_MEMBERSHIP_SCHEMA.array().prefault([]),
+    modified_at: z.string().optional(),
+    notes: z.string().optional(),
+    parent: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    permalink_url: z.string().optional(),
+    projects: ASANA_PROVIDER_RESOURCE_SCHEMA.array().prefault([]),
+    resource_subtype: z.string().optional(),
+    start_at: z.string().nullish(),
+    start_on: z.string().nullish(),
+    tags: ASANA_PROVIDER_RESOURCE_SCHEMA.array().prefault([]),
+    workspace: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+});
+export const ASANA_PROVIDER_STORY_SCHEMA = ASANA_PROVIDER_RESOURCE_SCHEMA.extend({
+    created_at: z.string().optional(),
+    created_by: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    html_text: z.string().optional(),
+    is_edited: z.boolean().prefault(false),
+    is_pinned: z.boolean().prefault(false),
+    resource_subtype: z.string().optional(),
+    text: z.string().prefault(""),
+});
+const ASANA_PROVIDER_EVENT_CHANGE_SCHEMA = z.looseObject({
+    action: z.enum(["added", "changed", "removed"]),
+    added_value: z.json().optional(),
+    field: z.string(),
+    new_value: z.json().optional(),
+    removed_value: z.json().optional(),
+});
+export const ASANA_PROVIDER_EVENT_SCHEMA = z.looseObject({
+    action: ASANA_EVENT_ACTION_SCHEMA,
+    change: ASANA_PROVIDER_EVENT_CHANGE_SCHEMA.nullish(),
+    created_at: z.string(),
+    parent: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+    resource: ASANA_PROVIDER_RESOURCE_SCHEMA,
+    type: z.string(),
+    user: ASANA_PROVIDER_RESOURCE_SCHEMA.nullish(),
+});
+/**
+ * Converts an Asana compact resource to the public camel-cased shape.
+ *
+ * @param value - Provider-native compact resource.
+ */
+export function toAsanaResource(value) {
+    return {
+        id: value.gid,
+        name: value.name,
+        type: value.resource_type,
+    };
+}
+/**
+ * Converts Asana offset pagination metadata.
+ *
+ * @param value - Provider-native response page.
+ */
+export function toAsanaPageInfo(value) {
+    return { nextOffset: value.next_page?.offset };
+}
+/**
+ * Converts an Asana workspace to the public camel-cased shape.
+ *
+ * @param value - Provider-native workspace.
+ */
+export function toAsanaWorkspace(value) {
+    return {
+        ...toAsanaResource(value),
+        emailDomains: value.email_domains,
+        isOrganization: value.is_organization,
+    };
+}
+/**
+ * Converts an Asana user to the public camel-cased shape.
+ *
+ * @param value - Provider-native user.
+ */
+export function toAsanaUser(value) {
+    return {
+        ...toAsanaResource(value),
+        email: value.email,
+        photoUrl: value.photo?.image_128x128,
+        workspaces: value.workspaces.map(toAsanaResource),
+    };
+}
+/**
+ * Converts an Asana project to the public camel-cased shape.
+ *
+ * @param value - Provider-native project.
+ */
+export function toAsanaProject(value) {
+    return {
+        ...toAsanaResource(value),
+        archived: value.archived,
+        color: value.color ?? undefined,
+        createdAt: value.created_at,
+        defaultView: value.default_view,
+        dueOn: value.due_on ?? undefined,
+        htmlNotes: value.html_notes,
+        modifiedAt: value.modified_at,
+        notes: value.notes,
+        permalinkUrl: value.permalink_url,
+        public: value.public,
+        startOn: value.start_on ?? undefined,
+        team: value.team ? toAsanaResource(value.team) : undefined,
+        workspace: value.workspace ? toAsanaResource(value.workspace) : undefined,
+    };
+}
+/**
+ * Converts an Asana section to the public camel-cased shape.
+ *
+ * @param value - Provider-native section.
+ */
+export function toAsanaSection(value) {
+    return {
+        ...toAsanaResource(value),
+        createdAt: value.created_at,
+        project: value.project ? toAsanaResource(value.project) : undefined,
+    };
+}
+/**
+ * Converts an Asana task to the public camel-cased shape.
+ *
+ * @param value - Provider-native task.
+ */
+export function toAsanaTask(value) {
+    return {
+        ...toAsanaResource(value),
+        assignee: value.assignee ? toAsanaResource(value.assignee) : undefined,
+        assigneeStatus: value.assignee_status,
+        completed: value.completed,
+        completedAt: value.completed_at ?? undefined,
+        completedBy: value.completed_by
+            ? toAsanaResource(value.completed_by)
+            : undefined,
+        createdAt: value.created_at,
+        createdBy: value.created_by ? toAsanaResource(value.created_by) : undefined,
+        customFields: value.custom_fields,
+        dueAt: value.due_at ?? undefined,
+        dueOn: value.due_on ?? undefined,
+        followers: value.followers.map(toAsanaResource),
+        htmlNotes: value.html_notes,
+        memberships: value.memberships.map(({ project, section }) => ({
+            project: toAsanaResource(project),
+            section: section ? toAsanaResource(section) : undefined,
+        })),
+        modifiedAt: value.modified_at,
+        notes: value.notes,
+        parent: value.parent ? toAsanaResource(value.parent) : undefined,
+        permalinkUrl: value.permalink_url,
+        projects: value.projects.map(toAsanaResource),
+        startAt: value.start_at ?? undefined,
+        startOn: value.start_on ?? undefined,
+        subtype: value.resource_subtype,
+        tags: value.tags.map(toAsanaResource),
+        workspace: value.workspace ? toAsanaResource(value.workspace) : undefined,
+    };
+}
+/**
+ * Converts an Asana story to the public camel-cased shape.
+ *
+ * @param value - Provider-native story.
+ */
+export function toAsanaStory(value) {
+    return {
+        ...toAsanaResource(value),
+        createdAt: value.created_at,
+        createdBy: value.created_by ? toAsanaResource(value.created_by) : undefined,
+        htmlText: value.html_text,
+        isEdited: value.is_edited,
+        isPinned: value.is_pinned,
+        subtype: value.resource_subtype,
+        text: value.text,
+    };
+}
+/**
+ * Converts one compact webhook event to the public Asana event shape.
+ *
+ * @param value - Provider-native webhook event.
+ * @param watchedResourceId - Resource selected for the webhook subscription.
+ */
+export function normalizeAsanaEvent(value, watchedResourceId) {
+    const event = ASANA_PROVIDER_EVENT_SCHEMA.parse(value);
+    return ASANA_EVENT_SCHEMA.parse({
+        action: event.action,
+        change: event.change
+            ? {
+                action: event.change.action,
+                addedValue: event.change.added_value,
+                field: event.change.field,
+                newValue: event.change.new_value,
+                removedValue: event.change.removed_value,
+            }
+            : undefined,
+        createdAt: event.created_at,
+        parent: event.parent ? toAsanaResource(event.parent) : undefined,
+        resource: toAsanaResource(event.resource),
+        resourceSubtype: event.resource.resource_subtype,
+        resourceType: event.resource.resource_type ?? event.type,
+        user: event.user ? toAsanaResource(event.user) : undefined,
+        watchedResourceId,
+    });
+}
+/**
+ * Converts one provider-native story to the public Asana story shape.
+ *
+ * @param value - Untrusted provider story payload.
+ */
+export function normalizeAsanaStory(value) {
+    return ASANA_STORY_SCHEMA.parse(toAsanaStory(ASANA_PROVIDER_STORY_SCHEMA.parse(value)));
+}
+/**
+ * Converts one provider-native task to the public Asana task shape.
+ *
+ * @param value - Untrusted provider task payload.
+ */
+export function normalizeAsanaTask(value) {
+    return ASANA_TASK_SCHEMA.parse(toAsanaTask(ASANA_PROVIDER_TASK_SCHEMA.parse(value)));
+}

package/dist/brevo/api.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/** Options accepted by the authenticated Brevo request helper. */
+export interface BrevoRequestOptions extends RequestInit {
+    /** Query parameters appended to the request URL. */
+    query?: Record<string, boolean | number | readonly (number | string)[] | string | undefined>;
+}
+/**
+ * Creates a small authenticated Brevo REST client.
+ *
+ * The returned helper is an escape hatch for provider endpoints that do not yet
+ * have a dedicated action. It returns the native `Response` after checking for
+ * provider errors.
+ *
+ * @param secret - Resolved Brevo integration secret.
+ */
+export declare function getBrevoApi(secret: Record<string, unknown>): {
+    /**
+     * Sends an authenticated request to the Brevo v3 API.
+     *
+     * @param path - Relative API path.
+     * @param options - Native fetch options and optional query parameters.
+     */
+    request(path: string, options?: BrevoRequestOptions): Promise<Response>;
+};
+/**
+ * Parses one successful Brevo JSON response.
+ *
+ * @param response - Checked provider response.
+ * @param schema - Schema describing the provider response.
+ */
+export declare function parseBrevoResponse<T extends z.ZodType>(response: Response, schema: T): Promise<z.output<T>>;

package/dist/brevo/api.js

@@ -0,0 +1,64 @@
+import { z } from "zod";
+const BREVO_API_BASE_URL = "https://api.brevo.com/v3/";
+const BREVO_API_ORIGIN = new URL(BREVO_API_BASE_URL).origin;
+const BREVO_SECRET_SCHEMA = z.object({
+    apiKey: z.string().min(1),
+});
+const BREVO_ERROR_SCHEMA = z.looseObject({
+    code: z.string().optional(),
+    message: z.string().optional(),
+});
+/**
+ * Creates a small authenticated Brevo REST client.
+ *
+ * The returned helper is an escape hatch for provider endpoints that do not yet
+ * have a dedicated action. It returns the native `Response` after checking for
+ * provider errors.
+ *
+ * @param secret - Resolved Brevo integration secret.
+ */
+export function getBrevoApi(secret) {
+    const { apiKey } = BREVO_SECRET_SCHEMA.parse(secret);
+    return {
+        /**
+         * Sends an authenticated request to the Brevo v3 API.
+         *
+         * @param path - Relative API path.
+         * @param options - Native fetch options and optional query parameters.
+         */
+        async request(path, options = {}) {
+            const { query, ...requestInit } = options;
+            const url = new URL(path.replace(/^\//, ""), BREVO_API_BASE_URL);
+            if (url.origin !== BREVO_API_ORIGIN) {
+                throw new Error("Brevo API paths must use the Brevo API origin.");
+            }
+            for (const [name, value] of Object.entries(query ?? {})) {
+                if (value !== undefined) {
+                    url.searchParams.set(name, Array.isArray(value) ? value.join(",") : String(value));
+                }
+            }
+            const headers = new Headers(requestInit.headers);
+            headers.set("api-key", apiKey);
+            headers.set("Accept", "application/json");
+            if (requestInit.body !== undefined && !headers.has("Content-Type")) {
+                headers.set("Content-Type", "application/json");
+            }
+            const response = await fetch(url, { ...requestInit, headers });
+            if (response.ok)
+                return response;
+            const error = BREVO_ERROR_SCHEMA.safeParse(await response.json().catch(() => ({})));
+            throw new Error(error.success && error.data.message
+                ? `Brevo API error (${response.status}): ${error.data.message}`
+                : `Brevo API request failed with status ${response.status}.`);
+        },
+    };
+}
+/**
+ * Parses one successful Brevo JSON response.
+ *
+ * @param response - Checked provider response.
+ * @param schema - Schema describing the provider response.
+ */
+export async function parseBrevoResponse(response, schema) {
+    return schema.parse(await response.json());
+}