agentmail 0.0.44 → 0.0.45

package/dist/esm/core/websocket/ws.mjs

@@ -0,0 +1,423 @@
+import { WebSocket as NodeWebSocket } from "ws";
+import { RUNTIME } from "../runtime/index.mjs";
+import { toQueryString } from "../url/qs.mjs";
+import * as Events from "./events.mjs";
+const getGlobalWebSocket = () => {
+    if (typeof WebSocket !== "undefined") {
+        // @ts-ignore
+        return WebSocket;
+    }
+    else if (RUNTIME.type === "node") {
+        return NodeWebSocket;
+    }
+    return undefined;
+};
+/**
+ * Returns true if given argument looks like a WebSocket class
+ */
+const isWebSocket = (w) => typeof w !== "undefined" && !!w && w.CLOSING === 2;
+const DEFAULT_OPTIONS = {
+    maxReconnectionDelay: 10000,
+    minReconnectionDelay: 1000 + Math.random() * 4000,
+    minUptime: 5000,
+    reconnectionDelayGrowFactor: 1.3,
+    connectionTimeout: 4000,
+    maxRetries: Infinity,
+    maxEnqueuedMessages: Infinity,
+    startClosed: false,
+    debug: false,
+};
+export class ReconnectingWebSocket {
+    constructor({ url, protocols, options, headers, queryParameters }) {
+        this._listeners = {
+            error: [],
+            message: [],
+            open: [],
+            close: [],
+        };
+        this._retryCount = -1;
+        this._shouldReconnect = true;
+        this._connectLock = false;
+        this._binaryType = "blob";
+        this._closeCalled = false;
+        this._messageQueue = [];
+        /**
+         * An event listener to be called when the WebSocket connection's readyState changes to CLOSED
+         */
+        this.onclose = null;
+        /**
+         * An event listener to be called when an error occurs
+         */
+        this.onerror = null;
+        /**
+         * An event listener to be called when a message is received from the server
+         */
+        this.onmessage = null;
+        /**
+         * An event listener to be called when the WebSocket connection's readyState changes to OPEN;
+         * this indicates that the connection is ready to send and receive data
+         */
+        this.onopen = null;
+        this._handleOpen = (event) => {
+            this._debug("open event");
+            const { minUptime = DEFAULT_OPTIONS.minUptime } = this._options;
+            clearTimeout(this._connectTimeout);
+            this._uptimeTimeout = setTimeout(() => this._acceptOpen(), minUptime);
+            this._ws.binaryType = this._binaryType;
+            // send enqueued messages (messages sent before websocket open event)
+            this._messageQueue.forEach((message) => { var _a; return (_a = this._ws) === null || _a === void 0 ? void 0 : _a.send(message); });
+            this._messageQueue = [];
+            if (this.onopen) {
+                this.onopen(event);
+            }
+            this._listeners.open.forEach((listener) => this._callEventListener(event, listener));
+        };
+        this._handleMessage = (event) => {
+            this._debug("message event");
+            if (this.onmessage) {
+                this.onmessage(event);
+            }
+            this._listeners.message.forEach((listener) => this._callEventListener(event, listener));
+        };
+        this._handleError = (event) => {
+            this._debug("error event", event.message);
+            this._disconnect(undefined, event.message === "TIMEOUT" ? "timeout" : undefined);
+            if (this.onerror) {
+                this.onerror(event);
+            }
+            this._debug("exec error listeners");
+            this._listeners.error.forEach((listener) => this._callEventListener(event, listener));
+            this._connect();
+        };
+        this._handleClose = (event) => {
+            this._debug("close event");
+            this._clearTimeouts();
+            if (event.code === 1000) {
+                this._shouldReconnect = false;
+            }
+            if (this._shouldReconnect) {
+                this._connect();
+            }
+            if (this.onclose) {
+                this.onclose(event);
+            }
+            this._listeners.close.forEach((listener) => this._callEventListener(event, listener));
+        };
+        this._url = url;
+        this._protocols = protocols;
+        this._options = options !== null && options !== void 0 ? options : DEFAULT_OPTIONS;
+        this._headers = headers;
+        this._queryParameters = queryParameters;
+        if (this._options.startClosed) {
+            this._shouldReconnect = false;
+        }
+        this._connect();
+    }
+    static get CONNECTING() {
+        return 0;
+    }
+    static get OPEN() {
+        return 1;
+    }
+    static get CLOSING() {
+        return 2;
+    }
+    static get CLOSED() {
+        return 3;
+    }
+    get CONNECTING() {
+        return ReconnectingWebSocket.CONNECTING;
+    }
+    get OPEN() {
+        return ReconnectingWebSocket.OPEN;
+    }
+    get CLOSING() {
+        return ReconnectingWebSocket.CLOSING;
+    }
+    get CLOSED() {
+        return ReconnectingWebSocket.CLOSED;
+    }
+    get binaryType() {
+        return this._ws ? this._ws.binaryType : this._binaryType;
+    }
+    set binaryType(value) {
+        this._binaryType = value;
+        if (this._ws) {
+            this._ws.binaryType = value;
+        }
+    }
+    /**
+     * Returns the number or connection retries
+     */
+    get retryCount() {
+        return Math.max(this._retryCount, 0);
+    }
+    /**
+     * The number of bytes of data that have been queued using calls to send() but not yet
+     * transmitted to the network. This value resets to zero once all queued data has been sent.
+     * This value does not reset to zero when the connection is closed; if you keep calling send(),
+     * this will continue to climb. Read only
+     */
+    get bufferedAmount() {
+        const bytes = this._messageQueue.reduce((acc, message) => {
+            if (typeof message === "string") {
+                acc += message.length; // not byte size
+            }
+            else if (message instanceof Blob) {
+                acc += message.size;
+            }
+            else {
+                acc += message.byteLength;
+            }
+            return acc;
+        }, 0);
+        return bytes + (this._ws ? this._ws.bufferedAmount : 0);
+    }
+    /**
+     * The extensions selected by the server. This is currently only the empty string or a list of
+     * extensions as negotiated by the connection
+     */
+    get extensions() {
+        return this._ws ? this._ws.extensions : "";
+    }
+    /**
+     * A string indicating the name of the sub-protocol the server selected;
+     * this will be one of the strings specified in the protocols parameter when creating the
+     * WebSocket object
+     */
+    get protocol() {
+        return this._ws ? this._ws.protocol : "";
+    }
+    /**
+     * The current state of the connection; this is one of the Ready state constants
+     */
+    get readyState() {
+        if (this._ws) {
+            return this._ws.readyState;
+        }
+        return this._options.startClosed ? ReconnectingWebSocket.CLOSED : ReconnectingWebSocket.CONNECTING;
+    }
+    /**
+     * The URL as resolved by the constructor
+     */
+    get url() {
+        return this._ws ? this._ws.url : "";
+    }
+    /**
+     * Closes the WebSocket connection or connection attempt, if any. If the connection is already
+     * CLOSED, this method does nothing
+     */
+    close(code = 1000, reason) {
+        this._closeCalled = true;
+        this._shouldReconnect = false;
+        this._clearTimeouts();
+        if (!this._ws) {
+            this._debug("close enqueued: no ws instance");
+            return;
+        }
+        if (this._ws.readyState === this.CLOSED) {
+            this._debug("close: already closed");
+            return;
+        }
+        this._ws.close(code, reason);
+    }
+    /**
+     * Closes the WebSocket connection or connection attempt and connects again.
+     * Resets retry counter;
+     */
+    reconnect(code, reason) {
+        this._shouldReconnect = true;
+        this._closeCalled = false;
+        this._retryCount = -1;
+        if (!this._ws || this._ws.readyState === this.CLOSED) {
+            this._connect();
+        }
+        else {
+            this._disconnect(code, reason);
+            this._connect();
+        }
+    }
+    /**
+     * Enqueue specified data to be transmitted to the server over the WebSocket connection
+     */
+    send(data) {
+        if (this._ws && this._ws.readyState === this.OPEN) {
+            this._debug("send", data);
+            this._ws.send(data);
+        }
+        else {
+            const { maxEnqueuedMessages = DEFAULT_OPTIONS.maxEnqueuedMessages } = this._options;
+            if (this._messageQueue.length < maxEnqueuedMessages) {
+                this._debug("enqueue", data);
+                this._messageQueue.push(data);
+            }
+        }
+    }
+    /**
+     * Register an event handler of a specific event type
+     */
+    addEventListener(type, listener) {
+        if (this._listeners[type]) {
+            // @ts-ignore
+            this._listeners[type].push(listener);
+        }
+    }
+    dispatchEvent(event) {
+        const listeners = this._listeners[event.type];
+        if (listeners) {
+            for (const listener of listeners) {
+                this._callEventListener(event, listener);
+            }
+        }
+        return true;
+    }
+    /**
+     * Removes an event listener
+     */
+    removeEventListener(type, listener) {
+        if (this._listeners[type]) {
+            // @ts-ignore
+            this._listeners[type] = this._listeners[type].filter(
+            // @ts-ignore
+            (l) => l !== listener);
+        }
+    }
+    _debug(...args) {
+        if (this._options.debug) {
+            // not using spread because compiled version uses Symbols
+            // tslint:disable-next-line
+            // biome-ignore lint/suspicious/noConsole: allow console
+            console.log.apply(console, ["RWS>", ...args]);
+        }
+    }
+    _getNextDelay() {
+        const { reconnectionDelayGrowFactor = DEFAULT_OPTIONS.reconnectionDelayGrowFactor, minReconnectionDelay = DEFAULT_OPTIONS.minReconnectionDelay, maxReconnectionDelay = DEFAULT_OPTIONS.maxReconnectionDelay, } = this._options;
+        let delay = 0;
+        if (this._retryCount > 0) {
+            delay = minReconnectionDelay * Math.pow(reconnectionDelayGrowFactor, this._retryCount - 1);
+            if (delay > maxReconnectionDelay) {
+                delay = maxReconnectionDelay;
+            }
+        }
+        this._debug("next delay", delay);
+        return delay;
+    }
+    _wait() {
+        return new Promise((resolve) => {
+            setTimeout(resolve, this._getNextDelay());
+        });
+    }
+    _getNextUrl(urlProvider) {
+        if (typeof urlProvider === "string") {
+            return Promise.resolve(urlProvider);
+        }
+        if (typeof urlProvider === "function") {
+            const url = urlProvider();
+            if (typeof url === "string") {
+                return Promise.resolve(url);
+            }
+            // @ts-ignore redundant check
+            if (url.then) {
+                return url;
+            }
+        }
+        throw Error("Invalid URL");
+    }
+    _connect() {
+        if (this._connectLock || !this._shouldReconnect) {
+            return;
+        }
+        this._connectLock = true;
+        const { maxRetries = DEFAULT_OPTIONS.maxRetries, connectionTimeout = DEFAULT_OPTIONS.connectionTimeout, WebSocket = getGlobalWebSocket(), } = this._options;
+        if (this._retryCount >= maxRetries) {
+            this._debug("max retries reached", this._retryCount, ">=", maxRetries);
+            return;
+        }
+        this._retryCount++;
+        this._debug("connect", this._retryCount);
+        this._removeListeners();
+        if (!isWebSocket(WebSocket)) {
+            throw Error("No valid WebSocket class provided");
+        }
+        this._wait()
+            .then(() => this._getNextUrl(this._url))
+            .then((url) => {
+            if (this._closeCalled) {
+                return;
+            }
+            const options = {};
+            if (this._headers) {
+                options.headers = this._headers;
+            }
+            if (this._queryParameters && Object.keys(this._queryParameters).length > 0) {
+                const queryString = toQueryString(this._queryParameters, { arrayFormat: "repeat" });
+                if (queryString) {
+                    url = `${url}?${queryString}`;
+                }
+            }
+            this._ws = new WebSocket(url, this._protocols, options);
+            this._ws.binaryType = this._binaryType;
+            this._connectLock = false;
+            this._addListeners();
+            this._connectTimeout = setTimeout(() => this._handleTimeout(), connectionTimeout);
+        });
+    }
+    _handleTimeout() {
+        this._debug("timeout event");
+        this._handleError(new Events.ErrorEvent(Error("TIMEOUT"), this));
+    }
+    _disconnect(code = 1000, reason) {
+        this._clearTimeouts();
+        if (!this._ws) {
+            return;
+        }
+        this._removeListeners();
+        try {
+            this._ws.close(code, reason);
+            this._handleClose(new Events.CloseEvent(code, reason, this));
+        }
+        catch (error) {
+            // ignore
+        }
+    }
+    _acceptOpen() {
+        this._debug("accept open");
+        this._retryCount = 0;
+    }
+    _callEventListener(event, listener) {
+        if ("handleEvent" in listener) {
+            // @ts-ignore
+            listener.handleEvent(event);
+        }
+        else {
+            // @ts-ignore
+            listener(event);
+        }
+    }
+    _removeListeners() {
+        if (!this._ws) {
+            return;
+        }
+        this._debug("removeListeners");
+        this._ws.removeEventListener("open", this._handleOpen);
+        this._ws.removeEventListener("close", this._handleClose);
+        this._ws.removeEventListener("message", this._handleMessage);
+        // @ts-ignore
+        this._ws.removeEventListener("error", this._handleError);
+    }
+    _addListeners() {
+        if (!this._ws) {
+            return;
+        }
+        this._debug("addListeners");
+        this._ws.addEventListener("open", this._handleOpen);
+        this._ws.addEventListener("close", this._handleClose);
+        this._ws.addEventListener("message", this._handleMessage);
+        // @ts-ignore
+        this._ws.addEventListener("error", this._handleError);
+    }
+    _clearTimeouts() {
+        clearTimeout(this._connectTimeout);
+        clearTimeout(this._uptimeTimeout);
+    }
+}

package/dist/esm/environments.mjs

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export const AgentMailEnvironment = {
+    Production: {
+        http: "https://api.agentmail.to",
+        websockets: "wss://ws.agentmail.to",
+    },
+    Development: {
+        http: "https://api.agentmail.dev",
+        websockets: "wss://ws.agentmail.dev",
+    },
+};

package/dist/esm/errors/AgentMailError.d.mts

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as core from "../core/index.mjs";
+export declare class AgentMailError extends Error {
+    readonly statusCode?: number;
+    readonly body?: unknown;
+    readonly rawResponse?: core.RawResponse;
+    constructor({ message, statusCode, body, rawResponse, }: {
+        message?: string;
+        statusCode?: number;
+        body?: unknown;
+        rawResponse?: core.RawResponse;
+    });
+}

package/dist/esm/errors/AgentMailError.mjs

@@ -0,0 +1,26 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import { toJson } from "../core/json.mjs";
+export class AgentMailError extends Error {
+    constructor({ message, statusCode, body, rawResponse, }) {
+        super(buildMessage({ message, statusCode, body }));
+        Object.setPrototypeOf(this, AgentMailError.prototype);
+        this.statusCode = statusCode;
+        this.body = body;
+        this.rawResponse = rawResponse;
+    }
+}
+function buildMessage({ message, statusCode, body, }) {
+    let lines = [];
+    if (message != null) {
+        lines.push(message);
+    }
+    if (statusCode != null) {
+        lines.push(`Status code: ${statusCode.toString()}`);
+    }
+    if (body != null) {
+        lines.push(`Body: ${toJson(body, undefined, 2)}`);
+    }
+    return lines.join("\n");
+}

package/dist/esm/errors/AgentMailTimeoutError.mjs

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export class AgentMailTimeoutError extends Error {
+    constructor(message) {
+        super(message);
+        Object.setPrototypeOf(this, AgentMailTimeoutError.prototype);
+    }
+}

package/dist/esm/errors/index.d.mts

@@ -0,0 +1,2 @@
+export { AgentMailError } from "./AgentMailError.mjs";
+export { AgentMailTimeoutError } from "./AgentMailTimeoutError.mjs";

package/dist/esm/errors/index.mjs

@@ -0,0 +1,2 @@
+export { AgentMailError } from "./AgentMailError.mjs";
+export { AgentMailTimeoutError } from "./AgentMailTimeoutError.mjs";

package/dist/esm/index.d.mts

@@ -0,0 +1,4 @@
+export * as AgentMail from "./api/index.mjs";
+export { AgentMailError, AgentMailTimeoutError } from "./errors/index.mjs";
+export { AgentMailClient } from "./Client.mjs";
+export { AgentMailEnvironment, AgentMailEnvironmentUrls } from "./environments.mjs";

package/dist/esm/index.mjs

@@ -0,0 +1,4 @@
+export * as AgentMail from "./api/index.mjs";
+export { AgentMailError, AgentMailTimeoutError } from "./errors/index.mjs";
+export { AgentMailClient } from "./Client.mjs";
+export { AgentMailEnvironment } from "./environments.mjs";

package/dist/esm/version.d.mts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.0.45";

package/dist/esm/version.mjs

@@ -0,0 +1 @@
+export const SDK_VERSION = "0.0.45";

package/package.json

@@ -1,36 +1,56 @@
 {
     "name": "agentmail",
-    "version": "0.0.44",
+    "version": "0.0.45",
     "private": false,
-    "repository": "https://github.com/agentmail-to/agentmail-node",
-    "main": "./index.js",
-    "types": "./index.d.ts",
+    "repository": "github:agentmail-to/agentmail-node",
+    "type": "commonjs",
+    "main": "./dist/cjs/index.js",
+    "module": "./dist/esm/index.mjs",
+    "types": "./dist/cjs/index.d.ts",
+    "exports": {
+        ".": {
+            "types": "./dist/cjs/index.d.ts",
+            "import": {
+                "types": "./dist/esm/index.d.mts",
+                "default": "./dist/esm/index.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/index.d.ts",
+                "default": "./dist/cjs/index.js"
+            },
+            "default": "./dist/cjs/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist",
+        "reference.md",
+        "README.md",
+        "LICENSE"
+    ],
     "scripts": {
         "format": "prettier . --write --ignore-unknown",
-        "build": "tsc",
-        "prepack": "cp -rv dist/. .",
-        "test": "jest"
+        "build": "yarn build:cjs && yarn build:esm",
+        "build:cjs": "tsc --project ./tsconfig.cjs.json",
+        "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
+        "test": "jest --config jest.config.mjs",
+        "test:unit": "jest --selectProjects unit",
+        "test:browser": "jest --selectProjects browser",
+        "test:wire": "jest --selectProjects wire"
     },
     "dependencies": {
-        "url-join": "4.0.1",
-        "form-data": "^4.0.0",
-        "formdata-node": "^6.0.3",
-        "node-fetch": "^2.7.0",
-        "qs": "^6.13.1",
-        "readable-stream": "^4.5.2",
-        "js-base64": "3.7.7"
+        "ws": "^8.16.0"
     },
     "devDependencies": {
-        "@types/url-join": "4.0.1",
-        "@types/qs": "^6.9.17",
-        "@types/node-fetch": "^2.6.12",
-        "@types/readable-stream": "^4.0.18",
         "webpack": "^5.97.1",
         "ts-loader": "^9.5.1",
+        "@types/ws": "^8.5.10",
         "jest": "^29.7.0",
+        "@jest/globals": "^29.7.0",
         "@types/jest": "^29.5.14",
-        "ts-jest": "^29.1.1",
+        "ts-jest": "^29.3.4",
         "jest-environment-jsdom": "^29.7.0",
+        "msw": "^2.8.4",
         "@types/node": "^18.19.70",
         "prettier": "^3.4.2",
         "typescript": "~5.7.2"
@@ -38,6 +58,12 @@
     "browser": {
         "fs": false,
         "os": false,
-        "path": false
-    }
+        "path": false,
+        "stream": false
+    },
+    "packageManager": "yarn@1.22.22",
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "sideEffects": false
 }

package/reference.md

@@ -114,8 +114,8 @@ await client.inboxes.get("inbox_id");
 await client.inboxes.create({
     username: undefined,
     domain: undefined,
-    displayName: undefined,
-    clientId: undefined,
+    display_name: undefined,
+    client_id: undefined,
 });
 ```
 
@@ -264,9 +264,9 @@ await client.webhooks.get("webhook_id");
 ```typescript
 await client.webhooks.create({
     url: "url",
-    eventTypes: ["message.received", "message.received"],
-    inboxIds: undefined,
-    clientId: undefined,
+    event_types: ["message.received", "message.received"],
+    inbox_ids: undefined,
+    client_id: undefined,
 });
 ```
 
@@ -773,7 +773,7 @@ await client.inboxes.drafts.get("inbox_id", "draft_id");
 ```typescript
 await client.inboxes.drafts.create("inbox_id", {
     labels: undefined,
-    replyTo: undefined,
+    reply_to: undefined,
     to: undefined,
     cc: undefined,
     bcc: undefined,
@@ -837,8 +837,8 @@ await client.inboxes.drafts.create("inbox_id", {
 
 ```typescript
 await client.inboxes.drafts.send("inbox_id", "draft_id", {
-    addLabels: undefined,
-    removeLabels: undefined,
+    add_labels: undefined,
+    remove_labels: undefined,
 });
 ```
 
@@ -1019,7 +1019,7 @@ await client.inboxes.messages.get("inbox_id", "message_id");
 ```typescript
 await client.inboxes.messages.send("inbox_id", {
     labels: undefined,
-    replyTo: undefined,
+    reply_to: undefined,
     to: undefined,
     cc: undefined,
     bcc: undefined,
@@ -1085,7 +1085,7 @@ await client.inboxes.messages.send("inbox_id", {
 ```typescript
 await client.inboxes.messages.reply("inbox_id", "message_id", {
     labels: undefined,
-    replyTo: undefined,
+    reply_to: undefined,
     to: undefined,
     cc: undefined,
     bcc: undefined,
@@ -1157,8 +1157,8 @@ await client.inboxes.messages.reply("inbox_id", "message_id", {
 
 ```typescript
 await client.inboxes.messages.update("inbox_id", "message_id", {
-    addLabels: undefined,
-    removeLabels: undefined,
+    add_labels: undefined,
+    remove_labels: undefined,
 });
 ```