agentmail 0.0.71 → 0.0.73

package/dist/esm/api/resources/webhooks/types/ListWebhooksResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/webhooks/types/Url.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * URL of webhook endpoint.
+ */
+export type Url = string;

package/dist/esm/api/resources/webhooks/types/Url.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/webhooks/types/Webhook.d.mts

@@ -0,0 +1,19 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../../../index.mjs";
+export interface Webhook {
+    webhookId: AgentMail.webhooks.WebhookId;
+    url: AgentMail.webhooks.Url;
+    eventTypes?: AgentMail.webhooks.EventTypes;
+    inboxIds?: AgentMail.webhooks.InboxIds;
+    /** Secret for webhook signature verification. */
+    secret: string;
+    /** Whether the webhook is enabled. */
+    enabled: boolean;
+    /** Time at which webhook was last updated. */
+    updatedAt: Date;
+    /** Time at which webhook was created. */
+    createdAt: Date;
+    clientId?: AgentMail.webhooks.ClientId;
+}

package/dist/esm/api/resources/webhooks/types/Webhook.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/webhooks/types/WebhookId.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * ID of webhook.
+ */
+export type WebhookId = string;

package/dist/esm/api/resources/webhooks/types/WebhookId.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/webhooks/types/index.d.mts

@@ -0,0 +1,9 @@
+export * from "./WebhookId.mjs";
+export * from "./ClientId.mjs";
+export * from "./Url.mjs";
+export * from "./EventType.mjs";
+export * from "./EventTypes.mjs";
+export * from "./InboxIds.mjs";
+export * from "./Webhook.mjs";
+export * from "./ListWebhooksResponse.mjs";
+export * from "./CreateWebhookRequest.mjs";

package/dist/esm/api/resources/webhooks/types/index.mjs

@@ -0,0 +1,9 @@
+export * from "./WebhookId.mjs";
+export * from "./ClientId.mjs";
+export * from "./Url.mjs";
+export * from "./EventType.mjs";
+export * from "./EventTypes.mjs";
+export * from "./InboxIds.mjs";
+export * from "./Webhook.mjs";
+export * from "./ListWebhooksResponse.mjs";
+export * from "./CreateWebhookRequest.mjs";

package/dist/esm/api/resources/websockets/client/Client.d.mts

@@ -0,0 +1,31 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import { WebsocketsSocket } from "./Socket.mjs";
+export declare namespace Websockets {
+    interface Options {
+        environment?: core.Supplier<environments.AgentMailEnvironment | environments.AgentMailEnvironmentUrls>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey?: core.Supplier<core.BearerToken | undefined>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    }
+    interface ConnectArgs {
+        authToken?: string | undefined;
+        /** Arbitrary headers to send with the websocket connect request. */
+        headers?: Record<string, string>;
+        /** Enable debug mode on the websocket. Defaults to false. */
+        debug?: boolean;
+        /** Number of reconnect attempts. Defaults to 30. */
+        reconnectAttempts?: number;
+    }
+}
+export declare class Websockets {
+    protected readonly _options: Websockets.Options;
+    constructor(_options?: Websockets.Options);
+    connect(args?: Websockets.ConnectArgs): Promise<WebsocketsSocket>;
+    protected _getAuthorizationHeader(): Promise<string>;
+}

package/dist/esm/api/resources/websockets/client/Client.mjs

@@ -0,0 +1,53 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import { mergeOnlyDefinedHeaders, mergeHeaders } from "../../../../core/headers.mjs";
+import { WebsocketsSocket } from "./Socket.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export class Websockets {
+    constructor(_options = {}) {
+        this._options = _options;
+    }
+    connect() {
+        return __awaiter(this, arguments, void 0, function* (args = {}) {
+            var _a, _b;
+            const { authToken, headers, debug, reconnectAttempts } = args;
+            const _queryParams = {};
+            if (authToken != null) {
+                _queryParams["auth_token"] = authToken;
+            }
+            let _headers = mergeHeaders(mergeOnlyDefinedHeaders({ Authorization: yield this._getAuthorizationHeader() }), headers);
+            const socket = new core.ReconnectingWebSocket({
+                url: core.url.join((_a = (yield core.Supplier.get(this._options["baseUrl"]))) !== null && _a !== void 0 ? _a : ((_b = (yield core.Supplier.get(this._options["environment"]))) !== null && _b !== void 0 ? _b : environments.AgentMailEnvironment.Production).websockets, "/v0"),
+                protocols: [],
+                queryParameters: _queryParams,
+                headers: _headers,
+                options: { debug: debug !== null && debug !== void 0 ? debug : false, maxRetries: reconnectAttempts !== null && reconnectAttempts !== void 0 ? reconnectAttempts : 30 },
+            });
+            return new WebsocketsSocket({ socket });
+        });
+    }
+    _getAuthorizationHeader() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const bearer = (_a = (yield core.Supplier.get(this._options.apiKey))) !== null && _a !== void 0 ? _a : process === null || process === void 0 ? void 0 : process.env["AGENTMAIL_API_KEY"];
+            if (bearer == null) {
+                throw new errors.AgentMailError({
+                    message: "Please specify a bearer by either passing it in to the constructor or initializing a AGENTMAIL_API_KEY environment variable",
+                });
+            }
+            return `Bearer ${bearer}`;
+        });
+    }
+}

package/dist/esm/api/resources/websockets/client/Socket.d.mts

@@ -0,0 +1,50 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../../../../core/index.mjs";
+import * as AgentMail from "../../../index.mjs";
+export declare namespace WebsocketsSocket {
+    interface Args {
+        socket: core.ReconnectingWebSocket;
+    }
+    type Response = AgentMail.Subscribed | AgentMail.MessageReceivedEvent | AgentMail.MessageSentEvent | AgentMail.MessageDeliveredEvent | AgentMail.MessageBouncedEvent | AgentMail.MessageComplainedEvent | AgentMail.MessageRejectedEvent;
+    type EventHandlers = {
+        open?: () => void;
+        message?: (message: Response) => void;
+        close?: (event: core.CloseEvent) => void;
+        error?: (error: Error) => void;
+    };
+}
+export declare class WebsocketsSocket {
+    readonly socket: core.ReconnectingWebSocket;
+    protected readonly eventHandlers: WebsocketsSocket.EventHandlers;
+    private handleOpen;
+    private handleMessage;
+    private handleClose;
+    private handleError;
+    constructor(args: WebsocketsSocket.Args);
+    /** The current state of the connection; this is one of the readyState constants. */
+    get readyState(): number;
+    /**
+     * @param event - The event to attach to.
+     * @param callback - The callback to run when the event is triggered.
+     * Usage:
+     * ```typescript
+     * this.on('open', () => {
+     *     console.log('The websocket is open');
+     * });
+     * ```
+     */
+    on<T extends keyof WebsocketsSocket.EventHandlers>(event: T, callback: WebsocketsSocket.EventHandlers[T]): void;
+    sendSubscribe(message: AgentMail.Subscribe): void;
+    /** Connect to the websocket and register event handlers. */
+    connect(): WebsocketsSocket;
+    /** Close the websocket and unregister event handlers. */
+    close(): void;
+    /** Returns a promise that resolves when the websocket is open. */
+    waitForOpen(): Promise<core.ReconnectingWebSocket>;
+    /** Asserts that the websocket is open. */
+    private assertSocketIsOpen;
+    /** Send a binary payload to the websocket. */
+    protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
+}

package/dist/esm/api/resources/websockets/client/Socket.mjs

@@ -0,0 +1,131 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as core from "../../../../core/index.mjs";
+import { Subscribe } from "../../../../serialization/resources/websockets/types/Subscribe.mjs";
+import { fromJson } from "../../../../core/json.mjs";
+import * as serializers from "../../../../serialization/index.mjs";
+export class WebsocketsSocket {
+    constructor(args) {
+        this.eventHandlers = {};
+        this.handleOpen = () => {
+            var _a, _b;
+            (_b = (_a = this.eventHandlers).open) === null || _b === void 0 ? void 0 : _b.call(_a);
+        };
+        this.handleMessage = (event) => {
+            var _a, _b, _c, _d;
+            const data = fromJson(event.data);
+            const parsedResponse = serializers.WebsocketsSocketResponse.parse(data, {
+                unrecognizedObjectKeys: "passthrough",
+                allowUnrecognizedUnionMembers: true,
+                allowUnrecognizedEnumValues: true,
+                skipValidation: true,
+                omitUndefined: true,
+            });
+            if (parsedResponse.ok) {
+                (_b = (_a = this.eventHandlers).message) === null || _b === void 0 ? void 0 : _b.call(_a, parsedResponse.value);
+            }
+            else {
+                (_d = (_c = this.eventHandlers).error) === null || _d === void 0 ? void 0 : _d.call(_c, new Error("Received unknown message type"));
+            }
+        };
+        this.handleClose = (event) => {
+            var _a, _b;
+            (_b = (_a = this.eventHandlers).close) === null || _b === void 0 ? void 0 : _b.call(_a, event);
+        };
+        this.handleError = (event) => {
+            var _a, _b;
+            const message = event.message;
+            (_b = (_a = this.eventHandlers).error) === null || _b === void 0 ? void 0 : _b.call(_a, new Error(message));
+        };
+        this.socket = args.socket;
+        this.socket.addEventListener("open", this.handleOpen);
+        this.socket.addEventListener("message", this.handleMessage);
+        this.socket.addEventListener("close", this.handleClose);
+        this.socket.addEventListener("error", this.handleError);
+    }
+    /** The current state of the connection; this is one of the readyState constants. */
+    get readyState() {
+        return this.socket.readyState;
+    }
+    /**
+     * @param event - The event to attach to.
+     * @param callback - The callback to run when the event is triggered.
+     * Usage:
+     * ```typescript
+     * this.on('open', () => {
+     *     console.log('The websocket is open');
+     * });
+     * ```
+     */
+    on(event, callback) {
+        this.eventHandlers[event] = callback;
+    }
+    sendSubscribe(message) {
+        this.assertSocketIsOpen();
+        const jsonPayload = Subscribe.jsonOrThrow(message, {
+            unrecognizedObjectKeys: "passthrough",
+            allowUnrecognizedUnionMembers: true,
+            allowUnrecognizedEnumValues: true,
+            skipValidation: true,
+            omitUndefined: true,
+        });
+        this.socket.send(JSON.stringify(jsonPayload));
+    }
+    /** Connect to the websocket and register event handlers. */
+    connect() {
+        this.socket.reconnect();
+        this.socket.addEventListener("open", this.handleOpen);
+        this.socket.addEventListener("message", this.handleMessage);
+        this.socket.addEventListener("close", this.handleClose);
+        this.socket.addEventListener("error", this.handleError);
+        return this;
+    }
+    /** Close the websocket and unregister event handlers. */
+    close() {
+        this.socket.close();
+        this.handleClose({ code: 1000 });
+        this.socket.removeEventListener("open", this.handleOpen);
+        this.socket.removeEventListener("message", this.handleMessage);
+        this.socket.removeEventListener("close", this.handleClose);
+        this.socket.removeEventListener("error", this.handleError);
+    }
+    /** Returns a promise that resolves when the websocket is open. */
+    waitForOpen() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.socket.readyState === core.ReconnectingWebSocket.OPEN) {
+                return this.socket;
+            }
+            return new Promise((resolve, reject) => {
+                this.socket.addEventListener("open", () => {
+                    resolve(this.socket);
+                });
+                this.socket.addEventListener("error", (event) => {
+                    reject(event);
+                });
+            });
+        });
+    }
+    /** Asserts that the websocket is open. */
+    assertSocketIsOpen() {
+        if (!this.socket) {
+            throw new Error("Socket is not connected.");
+        }
+        if (this.socket.readyState !== core.ReconnectingWebSocket.OPEN) {
+            throw new Error("Socket is not open.");
+        }
+    }
+    /** Send a binary payload to the websocket. */
+    sendBinary(payload) {
+        this.socket.send(payload);
+    }
+}

package/dist/esm/api/resources/websockets/client/index.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/websockets/client/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/websockets/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/websockets/index.mjs

@@ -0,0 +1,2 @@
+export * from "./types/index.mjs";
+export * from "./client/index.mjs";

package/dist/esm/api/resources/websockets/types/Subscribe.d.mts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface Subscribe {
+    type: "subscribe";
+    /** IDs of the inboxes to subscribe to. */
+    inboxIds: string[];
+}

package/dist/esm/api/resources/websockets/types/Subscribe.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/websockets/types/Subscribed.d.mts

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface Subscribed {
+    type: "subscribed";
+    /** IDs of the inboxes that have been subscribed to. */
+    inboxIds: string[];
+}

package/dist/esm/api/resources/websockets/types/Subscribed.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/resources/websockets/types/index.d.mts

@@ -0,0 +1,2 @@
+export * from "./Subscribe.mjs";
+export * from "./Subscribed.mjs";

package/dist/esm/api/resources/websockets/types/index.mjs

@@ -0,0 +1,2 @@
+export * from "./Subscribe.mjs";
+export * from "./Subscribed.mjs";

package/dist/esm/api/types/After.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Timestamp after which to filter by.
+ */
+export type After = Date;

package/dist/esm/api/types/After.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Ascending.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Whether to sort in ascending temporal order.
+ */
+export type Ascending = boolean;

package/dist/esm/api/types/Ascending.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Before.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Timestamp before which to filter by.
+ */
+export type Before = Date;

package/dist/esm/api/types/Before.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Count.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Number of items returned.
+ */
+export type Count = number;

package/dist/esm/api/types/Count.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/ErrorName.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Name of error.
+ */
+export type ErrorName = string;

package/dist/esm/api/types/ErrorName.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/ErrorResponse.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../index.mjs";
+export interface ErrorResponse {
+    name: AgentMail.ErrorName;
+    /** Error message. */
+    message: string;
+}

package/dist/esm/api/types/ErrorResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Labels.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Labels to filter by.
+ */
+export type Labels = string[];

package/dist/esm/api/types/Labels.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Limit.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Limit of number of items returned.
+ */
+export type Limit = number;

package/dist/esm/api/types/Limit.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/OrganizationId.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * ID of organization.
+ */
+export type OrganizationId = string;

package/dist/esm/api/types/OrganizationId.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/PageToken.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * Page token for pagination.
+ */
+export type PageToken = string;

package/dist/esm/api/types/PageToken.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/ValidationErrorResponse.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as AgentMail from "../index.mjs";
+export interface ValidationErrorResponse {
+    name: AgentMail.ErrorName;
+    /** Validation errors. */
+    errors?: unknown;
+}

package/dist/esm/api/types/ValidationErrorResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/index.d.mts

@@ -0,0 +1,11 @@
+export * from "./Limit.mjs";
+export * from "./Count.mjs";
+export * from "./PageToken.mjs";
+export * from "./Labels.mjs";
+export * from "./Before.mjs";
+export * from "./After.mjs";
+export * from "./Ascending.mjs";
+export * from "./OrganizationId.mjs";
+export * from "./ErrorName.mjs";
+export * from "./ErrorResponse.mjs";
+export * from "./ValidationErrorResponse.mjs";

package/dist/esm/api/types/index.mjs

@@ -0,0 +1,11 @@
+export * from "./Limit.mjs";
+export * from "./Count.mjs";
+export * from "./PageToken.mjs";
+export * from "./Labels.mjs";
+export * from "./Before.mjs";
+export * from "./After.mjs";
+export * from "./Ascending.mjs";
+export * from "./OrganizationId.mjs";
+export * from "./ErrorName.mjs";
+export * from "./ErrorResponse.mjs";
+export * from "./ValidationErrorResponse.mjs";

package/dist/esm/core/auth/AuthProvider.d.mts

@@ -0,0 +1,4 @@
+import { AuthRequest } from "./AuthRequest.mjs";
+export interface AuthProvider {
+    getAuthRequest(): Promise<AuthRequest>;
+}

package/dist/esm/core/auth/AuthProvider.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/auth/AuthRequest.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Request parameters for authentication requests.
+ */
+export interface AuthRequest {
+    /**
+     * The headers to be included in the request.
+     */
+    headers: Record<string, string>;
+}

package/dist/esm/core/auth/AuthRequest.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/auth/BasicAuth.d.mts

@@ -0,0 +1,8 @@
+export interface BasicAuth {
+    username: string;
+    password: string;
+}
+export declare const BasicAuth: {
+    toAuthorizationHeader: (basicAuth: BasicAuth | undefined) => string | undefined;
+    fromAuthorizationHeader: (header: string) => BasicAuth;
+};