agentmail 0.0.58 → 0.0.66

package/dist/cjs/api/resources/threads/types/index.d.ts

@@ -1,12 +1,18 @@
 export * from "./ThreadId.js";
 export * from "./ThreadLabels.js";
 export * from "./ThreadTimestamp.js";
+export * from "./ThreadReceivedTimestamp.js";
+export * from "./ThreadSentTimestamp.js";
 export * from "./ThreadSenders.js";
 export * from "./ThreadRecipients.js";
 export * from "./ThreadSubject.js";
 export * from "./ThreadPreview.js";
 export * from "./ThreadAttachments.js";
+export * from "./ThreadLastMessageId.js";
 export * from "./ThreadMessageCount.js";
+export * from "./ThreadSize.js";
+export * from "./ThreadUpdatedAt.js";
+export * from "./ThreadCreatedAt.js";
 export * from "./ThreadItem.js";
 export * from "./Thread.js";
 export * from "./ListThreadsResponse.js";

package/dist/cjs/api/resources/threads/types/index.js

@@ -17,12 +17,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ThreadId.js"), exports);
 __exportStar(require("./ThreadLabels.js"), exports);
 __exportStar(require("./ThreadTimestamp.js"), exports);
+__exportStar(require("./ThreadReceivedTimestamp.js"), exports);
+__exportStar(require("./ThreadSentTimestamp.js"), exports);
 __exportStar(require("./ThreadSenders.js"), exports);
 __exportStar(require("./ThreadRecipients.js"), exports);
 __exportStar(require("./ThreadSubject.js"), exports);
 __exportStar(require("./ThreadPreview.js"), exports);
 __exportStar(require("./ThreadAttachments.js"), exports);
+__exportStar(require("./ThreadLastMessageId.js"), exports);
 __exportStar(require("./ThreadMessageCount.js"), exports);
+__exportStar(require("./ThreadSize.js"), exports);
+__exportStar(require("./ThreadUpdatedAt.js"), exports);
+__exportStar(require("./ThreadCreatedAt.js"), exports);
 __exportStar(require("./ThreadItem.js"), exports);
 __exportStar(require("./Thread.js"), exports);
 __exportStar(require("./ListThreadsResponse.js"), exports);

package/dist/cjs/api/resources/webhooks/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare namespace Webhooks {
         baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
     interface RequestOptions {
         /** The maximum time to wait for a response in seconds. */
@@ -23,7 +23,7 @@ export declare namespace Webhooks {
         /** Additional query string parameters to include in the request. */
         queryParams?: Record<string, unknown>;
         /** Additional headers to include in the request. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
 }
 export declare class Webhooks {
@@ -36,8 +36,7 @@ export declare class Webhooks {
      * @example
      *     await client.webhooks.list()
      */
-    list(request?: AgentMail.webhooks.ListWebhooksRequest, requestOptions?: Webhooks.RequestOptions): core.HttpResponsePromise<AgentMail.webhooks.ListWebhooksResponse>;
-    private __list;
+    list(request?: AgentMail.webhooks.ListWebhooksRequest, requestOptions?: Webhooks.RequestOptions): Promise<core.Page<AgentMail.webhooks.Webhook>>;
     /**
      * @param {AgentMail.webhooks.WebhookId} webhookId
      * @param {Webhooks.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/api/resources/webhooks/client/Client.js

@@ -63,64 +63,74 @@ class Webhooks {
      * @example
      *     await client.webhooks.list()
      */
-    list(request = {}, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__list(request, requestOptions));
-    }
-    __list() {
+    list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b, _c;
-            const { limit, pageToken } = request;
-            const _queryParams = {};
-            if (limit != null) {
-                _queryParams["limit"] = limit.toString();
-            }
-            if (pageToken != null) {
-                _queryParams["page_token"] = pageToken;
-            }
-            var _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
-            const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Production).http, "/v0/webhooks"),
-                method: "GET",
-                headers: _headers,
-                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
-                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
-                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
-                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
-            });
-            if (_response.ok) {
-                return {
-                    data: serializers.webhooks.ListWebhooksResponse.parseOrThrow(_response.body, {
-                        unrecognizedObjectKeys: "passthrough",
-                        allowUnrecognizedUnionMembers: true,
-                        allowUnrecognizedEnumValues: true,
-                        skipValidation: true,
-                        breadcrumbsPrefix: ["response"],
-                    }),
-                    rawResponse: _response.rawResponse,
-                };
-            }
-            if (_response.error.reason === "status-code") {
-                throw new errors.AgentMailError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                    rawResponse: _response.rawResponse,
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c;
+                const { limit, pageToken } = request;
+                const _queryParams = {};
+                if (limit != null) {
+                    _queryParams["limit"] = limit.toString();
+                }
+                if (pageToken != null) {
+                    _queryParams["page_token"] = pageToken;
+                }
+                let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _response = yield core.fetcher({
+                    url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Production).http, "/v0/webhooks"),
+                    method: "GET",
+                    headers: _headers,
+                    queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                    timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                    maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
                 });
-            }
-            switch (_response.error.reason) {
-                case "non-json":
-                    throw new errors.AgentMailError({
-                        statusCode: _response.error.statusCode,
-                        body: _response.error.rawBody,
+                if (_response.ok) {
+                    return {
+                        data: serializers.webhooks.ListWebhooksResponse.parseOrThrow(_response.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }),
                         rawResponse: _response.rawResponse,
-                    });
-                case "timeout":
-                    throw new errors.AgentMailTimeoutError("Timeout exceeded when calling GET /v0/webhooks.");
-                case "unknown":
+                    };
+                }
+                if (_response.error.reason === "status-code") {
                     throw new errors.AgentMailError({
-                        message: _response.error.errorMessage,
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
                         rawResponse: _response.rawResponse,
                     });
-            }
+                }
+                switch (_response.error.reason) {
+                    case "non-json":
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.rawBody,
+                            rawResponse: _response.rawResponse,
+                        });
+                    case "timeout":
+                        throw new errors.AgentMailTimeoutError("Timeout exceeded when calling GET /v0/webhooks.");
+                    case "unknown":
+                        throw new errors.AgentMailError({
+                            message: _response.error.errorMessage,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }));
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Pageable({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => (response === null || response === void 0 ? void 0 : response.nextPageToken) != null &&
+                    !(typeof (response === null || response === void 0 ? void 0 : response.nextPageToken) === "string" && (response === null || response === void 0 ? void 0 : response.nextPageToken) === ""),
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.webhooks) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (response) => {
+                    return list(core.setObjectProperty(request, "pageToken", response === null || response === void 0 ? void 0 : response.nextPageToken));
+                },
+            });
         });
     }
     /**
@@ -138,7 +148,7 @@ class Webhooks {
     __get(webhookId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
                 url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Production).http, `/v0/webhooks/${encodeURIComponent(serializers.webhooks.WebhookId.jsonOrThrow(webhookId, { omitUndefined: true }))}`),
                 method: "GET",
@@ -215,7 +225,7 @@ class Webhooks {
     __create(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
                 url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Production).http, "/v0/webhooks"),
                 method: "POST",
@@ -293,7 +303,7 @@ class Webhooks {
     __delete(webhookId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c;
-            var _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)({ Authorization: yield this._getAuthorizationHeader() }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
                 url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : ((_c = (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.AgentMailEnvironment.Production).http, `/v0/webhooks/${encodeURIComponent(serializers.webhooks.WebhookId.jsonOrThrow(webhookId, { omitUndefined: true }))}`),
                 method: "DELETE",

package/dist/cjs/api/resources/websockets/client/Client.d.ts

@@ -11,7 +11,7 @@ export declare namespace Websockets {
         baseUrl?: core.Supplier<string>;
         apiKey?: core.Supplier<core.BearerToken | undefined>;
         /** Additional headers to include in requests. */
-        headers?: Record<string, string | core.Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
     interface ConnectArgs {
         authToken?: string | undefined;

package/dist/cjs/api/resources/websockets/client/Client.js

@@ -48,6 +48,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Websockets = void 0;
 const environments = __importStar(require("../../../../environments.js"));
 const core = __importStar(require("../../../../core/index.js"));
+const headers_js_1 = require("../../../../core/headers.js");
 const Socket_js_1 = require("./Socket.js");
 const errors = __importStar(require("../../../../errors/index.js"));
 class Websockets {
@@ -62,7 +63,7 @@ class Websockets {
             if (authToken != null) {
                 _queryParams["auth_token"] = authToken;
             }
-            let _headers = Object.assign({}, headers);
+            let _headers = (0, headers_js_1.mergeHeaders)((0, headers_js_1.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: [],

package/dist/cjs/core/fetcher/Fetcher.d.ts

@@ -6,7 +6,7 @@ export declare namespace Fetcher {
         url: string;
         method: string;
         contentType?: string;
-        headers?: Record<string, string | Supplier<string | undefined> | undefined>;
+        headers?: Record<string, string | Supplier<string | null | undefined> | null | undefined>;
         queryParameters?: Record<string, unknown>;
         body?: unknown;
         timeoutMs?: number;

package/dist/cjs/core/fetcher/requestWithRetries.js

@@ -14,21 +14,57 @@ const INITIAL_RETRY_DELAY = 1000; // in milliseconds
 const MAX_RETRY_DELAY = 60000; // in milliseconds
 const DEFAULT_MAX_RETRIES = 2;
 const JITTER_FACTOR = 0.2; // 20% random jitter
-function addJitter(delay) {
-    // Generate a random value between -JITTER_FACTOR and +JITTER_FACTOR
-    const jitterMultiplier = 1 + (Math.random() * 2 - 1) * JITTER_FACTOR;
+function addPositiveJitter(delay) {
+    // Generate a random value between 0 and +JITTER_FACTOR
+    const jitterMultiplier = 1 + Math.random() * JITTER_FACTOR;
     return delay * jitterMultiplier;
 }
+function addSymmetricJitter(delay) {
+    // Generate a random value in a JITTER_FACTOR-sized percentage range around delay
+    const jitterMultiplier = 1 + (Math.random() - 0.5) * JITTER_FACTOR;
+    return delay * jitterMultiplier;
+}
+function getRetryDelayFromHeaders(response, retryAttempt) {
+    // Check for Retry-After header first (RFC 7231), with no jitter
+    const retryAfter = response.headers.get("Retry-After");
+    if (retryAfter) {
+        // Parse as number of seconds...
+        const retryAfterSeconds = parseInt(retryAfter, 10);
+        if (!isNaN(retryAfterSeconds) && retryAfterSeconds > 0) {
+            return Math.min(retryAfterSeconds * 1000, MAX_RETRY_DELAY);
+        }
+        // ...or as an HTTP date; both are valid
+        const retryAfterDate = new Date(retryAfter);
+        if (!isNaN(retryAfterDate.getTime())) {
+            const delay = retryAfterDate.getTime() - Date.now();
+            if (delay > 0) {
+                return Math.min(Math.max(delay, 0), MAX_RETRY_DELAY);
+            }
+        }
+    }
+    // Then check for industry-standard X-RateLimit-Reset header, with positive jitter
+    const rateLimitReset = response.headers.get("X-RateLimit-Reset");
+    if (rateLimitReset) {
+        const resetTime = parseInt(rateLimitReset, 10);
+        if (!isNaN(resetTime)) {
+            // Assume Unix timestamp in epoch seconds
+            const delay = resetTime * 1000 - Date.now();
+            if (delay > 0) {
+                return addPositiveJitter(Math.min(delay, MAX_RETRY_DELAY));
+            }
+        }
+    }
+    // Fall back to exponential backoff, with symmetric jitter
+    return addSymmetricJitter(Math.min(INITIAL_RETRY_DELAY * Math.pow(2, retryAttempt), MAX_RETRY_DELAY));
+}
 function requestWithRetries(requestFn_1) {
     return __awaiter(this, arguments, void 0, function* (requestFn, maxRetries = DEFAULT_MAX_RETRIES) {
         let response = yield requestFn();
         for (let i = 0; i < maxRetries; ++i) {
             if ([408, 429].includes(response.status) || response.status >= 500) {
-                // Calculate base delay using exponential backoff (in milliseconds)
-                const baseDelay = Math.min(INITIAL_RETRY_DELAY * Math.pow(2, i), MAX_RETRY_DELAY);
-                // Add jitter to the delay
-                const delayWithJitter = addJitter(baseDelay);
-                yield new Promise((resolve) => setTimeout(resolve, delayWithJitter));
+                // Get delay with appropriate jitter applied
+                const delay = getRetryDelayFromHeaders(response, i);
+                yield new Promise((resolve) => setTimeout(resolve, delay));
                 response = yield requestFn();
             }
             else {

package/dist/cjs/core/headers.d.ts

@@ -1,3 +1,3 @@
 import * as core from "./index.js";
-export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
-export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | undefined> | undefined> | undefined)[]): Record<string, string | core.Supplier<string | undefined>>;
+export declare function mergeHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;
+export declare function mergeOnlyDefinedHeaders(...headersArray: (Record<string, string | core.Supplier<string | null | undefined> | null | undefined> | null | undefined)[]): Record<string, string | core.Supplier<string | null | undefined>>;

package/dist/cjs/core/index.d.ts

@@ -5,3 +5,5 @@ export * as serialization from "./schemas/index.js";
 export * from "./websocket/index.js";
 export * from "./auth/index.js";
 export * from "./base64.js";
+export * from "./utils/index.js";
+export * from "./pagination/index.js";

package/dist/cjs/core/index.js

@@ -44,3 +44,5 @@ exports.serialization = __importStar(require("./schemas/index.js"));
 __exportStar(require("./websocket/index.js"), exports);
 __exportStar(require("./auth/index.js"), exports);
 __exportStar(require("./base64.js"), exports);
+__exportStar(require("./utils/index.js"), exports);
+__exportStar(require("./pagination/index.js"), exports);

package/dist/cjs/core/pagination/Page.d.ts

@@ -0,0 +1,32 @@
+import { HttpResponsePromise, RawResponse } from "../fetcher/index.js";
+/**
+ * A page of results from a paginated API.
+ *
+ * @template T The type of the items in the page.
+ */
+export declare class Page<T> implements AsyncIterable<T> {
+    data: T[];
+    rawResponse: RawResponse;
+    private response;
+    private _hasNextPage;
+    private getItems;
+    private loadNextPage;
+    constructor({ response, rawResponse, hasNextPage, getItems, loadPage, }: {
+        response: unknown;
+        rawResponse: RawResponse;
+        hasNextPage: (response: unknown) => boolean;
+        getItems: (response: unknown) => T[];
+        loadPage: (response: unknown) => HttpResponsePromise<any>;
+    });
+    /**
+     * Retrieves the next page
+     * @returns this
+     */
+    getNextPage(): Promise<this>;
+    /**
+     * @returns whether there is a next page to load
+     */
+    hasNextPage(): boolean;
+    private iterMessages;
+    [Symbol.asyncIterator](): AsyncIterator<T, void, any>;
+}

package/dist/cjs/core/pagination/Page.js

@@ -0,0 +1,100 @@
+"use strict";
+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());
+    });
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Page = void 0;
+/**
+ * A page of results from a paginated API.
+ *
+ * @template T The type of the items in the page.
+ */
+class Page {
+    constructor({ response, rawResponse, hasNextPage, getItems, loadPage, }) {
+        this.response = response;
+        this.rawResponse = rawResponse;
+        this.data = getItems(response);
+        this._hasNextPage = hasNextPage;
+        this.getItems = getItems;
+        this.loadNextPage = loadPage;
+    }
+    /**
+     * Retrieves the next page
+     * @returns this
+     */
+    getNextPage() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { data, rawResponse } = yield this.loadNextPage(this.response).withRawResponse();
+            this.response = data;
+            this.rawResponse = rawResponse;
+            this.data = this.getItems(this.response);
+            return this;
+        });
+    }
+    /**
+     * @returns whether there is a next page to load
+     */
+    hasNextPage() {
+        return this._hasNextPage(this.response);
+    }
+    iterMessages() {
+        return __asyncGenerator(this, arguments, function* iterMessages_1() {
+            for (const item of this.data) {
+                yield yield __await(item);
+            }
+            while (this.hasNextPage()) {
+                yield __await(this.getNextPage());
+                for (const item of this.data) {
+                    yield yield __await(item);
+                }
+            }
+        });
+    }
+    [Symbol.asyncIterator]() {
+        return __asyncGenerator(this, arguments, function* _a() {
+            var _b, e_1, _c, _d;
+            try {
+                for (var _e = true, _f = __asyncValues(this.iterMessages()), _g; _g = yield __await(_f.next()), _b = _g.done, !_b; _e = true) {
+                    _d = _g.value;
+                    _e = false;
+                    const message = _d;
+                    yield yield __await(message);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_e && !_b && (_c = _f.return)) yield __await(_c.call(_f));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+}
+exports.Page = Page;

package/dist/cjs/core/pagination/Pageable.d.ts

@@ -0,0 +1,14 @@
+import { RawResponse } from "../fetcher/index.js";
+import { Page } from "./Page.js";
+export declare namespace Pageable {
+    interface Args<Response, Item> {
+        response: Response;
+        rawResponse: RawResponse;
+        hasNextPage: (response: Response) => boolean;
+        getItems: (response: Response) => Item[];
+        loadPage: (response: Response) => Promise<Response>;
+    }
+}
+export declare class Pageable<R, T> extends Page<T> {
+    constructor(args: Pageable.Args<R, T>);
+}

package/dist/cjs/core/pagination/Pageable.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pageable = void 0;
+const Page_js_1 = require("./Page.js");
+class Pageable extends Page_js_1.Page {
+    constructor(args) {
+        super(args);
+    }
+}
+exports.Pageable = Pageable;

package/dist/cjs/core/pagination/index.d.ts

@@ -0,0 +1,2 @@
+export { Page } from "./Page.js";
+export { Pageable } from "./Pageable.js";

package/dist/cjs/core/pagination/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pageable = exports.Page = void 0;
+var Page_js_1 = require("./Page.js");
+Object.defineProperty(exports, "Page", { enumerable: true, get: function () { return Page_js_1.Page; } });
+var Pageable_js_1 = require("./Pageable.js");
+Object.defineProperty(exports, "Pageable", { enumerable: true, get: function () { return Pageable_js_1.Pageable; } });

package/dist/cjs/core/utils/index.d.ts

@@ -0,0 +1 @@
+export { setObjectProperty } from "./setObjectProperty.js";

package/dist/cjs/core/utils/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setObjectProperty = void 0;
+var setObjectProperty_js_1 = require("./setObjectProperty.js");
+Object.defineProperty(exports, "setObjectProperty", { enumerable: true, get: function () { return setObjectProperty_js_1.setObjectProperty; } });

package/dist/cjs/core/utils/setObjectProperty.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sets the value at path of object. If a portion of path doesn’t exist it’s created. This is
+ * inspired by Lodash's set function, but is simplified to accommodate our use case.
+ * For more details, see https://lodash.com/docs/4.17.15#set.
+ *
+ * @param object The object to modify.
+ * @param path The path of the property to set.
+ * @param value The value to set.
+ * @return Returns object.
+ */
+export declare function setObjectProperty<T extends object>(object: T, path: string, value: any): T;

package/dist/cjs/core/utils/setObjectProperty.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setObjectProperty = setObjectProperty;
+/**
+ * Sets the value at path of object. If a portion of path doesn’t exist it’s created. This is
+ * inspired by Lodash's set function, but is simplified to accommodate our use case.
+ * For more details, see https://lodash.com/docs/4.17.15#set.
+ *
+ * @param object The object to modify.
+ * @param path The path of the property to set.
+ * @param value The value to set.
+ * @return Returns object.
+ */
+function setObjectProperty(object, path, value) {
+    if (object == null) {
+        return object;
+    }
+    const keys = path.split(".");
+    if (keys.length === 0) {
+        // Invalid path; do nothing.
+        return object;
+    }
+    let current = object;
+    for (let i = 0; i < keys.length - 1; i++) {
+        const key = keys[i];
+        if (key == null) {
+            // Unreachable.
+            continue;
+        }
+        if (!current[key] || typeof current[key] !== "object") {
+            current[key] = {};
+        }
+        current = current[key];
+    }
+    const lastKey = keys[keys.length - 1];
+    if (lastKey == null) {
+        // Unreachable.
+        return object;
+    }
+    current[lastKey] = value;
+    return object;
+}

package/dist/cjs/core/websocket/ws.d.ts

@@ -7,7 +7,7 @@ export declare namespace ReconnectingWebSocket {
         url: string;
         protocols?: string | string[];
         options?: ReconnectingWebSocket.Options;
-        headers?: Record<string, string>;
+        headers?: Record<string, unknown>;
         queryParameters?: Record<string, string | string[] | object | object[] | null | undefined>;
     }
     type Options = {

package/dist/cjs/serialization/resources/messages/types/Message.d.ts

@@ -18,6 +18,11 @@ import { MessagePreview } from "./MessagePreview.js";
 import { MessageText } from "./MessageText.js";
 import { MessageHtml } from "./MessageHtml.js";
 import { MessageAttachments } from "./MessageAttachments.js";
+import { MessageInReplyTo } from "./MessageInReplyTo.js";
+import { MessageReferences } from "./MessageReferences.js";
+import { MessageSize } from "./MessageSize.js";
+import { MessageUpdatedAt } from "./MessageUpdatedAt.js";
+import { MessageCreatedAt } from "./MessageCreatedAt.js";
 export declare const Message: core.serialization.ObjectSchema<serializers.Message.Raw, AgentMail.Message>;
 export declare namespace Message {
     interface Raw {
@@ -36,9 +41,10 @@ export declare namespace Message {
         text?: MessageText.Raw | null;
         html?: MessageHtml.Raw | null;
         attachments?: MessageAttachments.Raw | null;
-        in_reply_to?: string | null;
-        references?: string[] | null;
-        updated_at: string;
-        created_at: string;
+        in_reply_to?: MessageInReplyTo.Raw | null;
+        references?: MessageReferences.Raw | null;
+        size: MessageSize.Raw;
+        updated_at: MessageUpdatedAt.Raw;
+        created_at: MessageCreatedAt.Raw;
     }
 }