agentmail 0.5.49 → 0.5.51

package/dist/esm/Client.d.mts

@@ -5,6 +5,7 @@ import { AppsClient } from "./api/resources/apps/client/Client.mjs";
 import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { DomainsClient } from "./api/resources/domains/client/Client.mjs";
 import { DraftsClient } from "./api/resources/drafts/client/Client.mjs";
+import { ForwardingClient } from "./api/resources/forwarding/client/Client.mjs";
 import { InboxesClient } from "./api/resources/inboxes/client/Client.mjs";
 import { ListsClient } from "./api/resources/lists/client/Client.mjs";
 import { MetricsClient } from "./api/resources/metrics/client/Client.mjs";
@@ -33,6 +34,7 @@ export declare class AgentMailClient {
     protected _auth: AuthClient | undefined;
     protected _domains: DomainsClient | undefined;
     protected _drafts: DraftsClient | undefined;
+    protected _forwarding: ForwardingClient | undefined;
     protected _lists: ListsClient | undefined;
     protected _metrics: MetricsClient | undefined;
     protected _organizations: OrganizationsClient | undefined;
@@ -49,6 +51,7 @@ export declare class AgentMailClient {
     get auth(): AuthClient;
     get domains(): DomainsClient;
     get drafts(): DraftsClient;
+    get forwarding(): ForwardingClient;
     get lists(): ListsClient;
     get metrics(): MetricsClient;
     get organizations(): OrganizationsClient;

package/dist/esm/Client.mjs

@@ -15,6 +15,7 @@ import { AppsClient } from "./api/resources/apps/client/Client.mjs";
 import { AuthClient } from "./api/resources/auth/client/Client.mjs";
 import { DomainsClient } from "./api/resources/domains/client/Client.mjs";
 import { DraftsClient } from "./api/resources/drafts/client/Client.mjs";
+import { ForwardingClient } from "./api/resources/forwarding/client/Client.mjs";
 import { InboxesClient } from "./api/resources/inboxes/client/Client.mjs";
 import { ListsClient } from "./api/resources/lists/client/Client.mjs";
 import { MetricsClient } from "./api/resources/metrics/client/Client.mjs";
@@ -70,6 +71,10 @@ export class AgentMailClient {
         var _a;
         return ((_a = this._drafts) !== null && _a !== void 0 ? _a : (this._drafts = new DraftsClient(this._options)));
     }
+    get forwarding() {
+        var _a;
+        return ((_a = this._forwarding) !== null && _a !== void 0 ? _a : (this._forwarding = new ForwardingClient(this._options)));
+    }
     get lists() {
         var _a;
         return ((_a = this._lists) !== null && _a !== void 0 ? _a : (this._lists = new ListsClient(this._options)));

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

@@ -0,0 +1,127 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.mjs";
+import { type NormalizedClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as AgentMail from "../../../index.mjs";
+export declare namespace ForwardingClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class ForwardingClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ForwardingClient.Options>;
+    constructor(options?: ForwardingClient.Options);
+    /**
+     * Get the forwarding the organization sets. Pods and inboxes that set no forwarding of their own
+     * use this list. Needs an organization-scoped API key.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding get
+     * ```
+     *
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.get()
+     */
+    get(requestOptions?: ForwardingClient.RequestOptions): core.HttpResponsePromise<AgentMail.Forwarding>;
+    private __get;
+    /**
+     * Set the addresses the organization forwards to. The list replaces the current one. An address
+     * that is not verified is saved but receives nothing until it is verified. Needs an
+     * organization-scoped API key in an organization that has completed agent verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding update --destinations ops@example.com --destinations archive@example.com
+     * ```
+     *
+     * @param {AgentMail.UpdateForwardingRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.update({
+     *         destinations: ["destinations", "destinations"]
+     *     })
+     */
+    update(request: AgentMail.UpdateForwardingRequest, requestOptions?: ForwardingClient.RequestOptions): core.HttpResponsePromise<AgentMail.UpdateForwardingResponse>;
+    private __update;
+    /**
+     * Remove the organization's forwarding, so its inboxes stop forwarding unless their pod or the
+     * inbox sets its own. Verified addresses stay verified, so adding one again needs no new code.
+     * Returns `not_found` when the organization sets no forwarding.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding delete
+     * ```
+     *
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.delete()
+     */
+    delete(requestOptions?: ForwardingClient.RequestOptions): core.HttpResponsePromise<AgentMail.Forwarding>;
+    private __delete;
+    /**
+     * Email a confirmation code to an address, so it can receive forwarded mail once confirmed.
+     * Verification belongs to the organization: once verified, the address can be used at the
+     * organization, any pod and any inbox. Starting again replaces any code already sent to the
+     * address. Needs an organization- or pod-scoped API key in an organization that has completed
+     * agent verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding start-verification --destination ops@example.com
+     * ```
+     *
+     * @param {AgentMail.StartForwardingVerificationRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     * @throws {@link AgentMail.UnprocessableError}
+     * @throws {@link AgentMail.ForwardingRateLimitError}
+     *
+     * @example
+     *     await client.forwarding.startVerification({
+     *         destination: "destination"
+     *     })
+     */
+    startVerification(request: AgentMail.StartForwardingVerificationRequest, requestOptions?: ForwardingClient.RequestOptions): core.HttpResponsePromise<AgentMail.ForwardingVerificationStarted>;
+    private __startVerification;
+    /**
+     * Submit the code emailed by Start Verification to verify the address. A code allows 10 wrong
+     * attempts, then stops working even with the right code, and Start Verification sends a new one.
+     * Needs an organization- or pod-scoped API key in an organization that has completed agent
+     * verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding confirm-verification --destination ops@example.com --code 7KQ2M-XW9PD
+     * ```
+     *
+     * @param {AgentMail.ConfirmForwardingVerificationRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.forwarding.confirmVerification({
+     *         destination: "destination",
+     *         code: "code"
+     *     })
+     */
+    confirmVerification(request: AgentMail.ConfirmForwardingVerificationRequest, requestOptions?: ForwardingClient.RequestOptions): core.HttpResponsePromise<AgentMail.ForwardingVerificationConfirmed>;
+    private __confirmVerification;
+}

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

@@ -0,0 +1,466 @@
+// 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 { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
+import { mergeHeaders } from "../../../../core/headers.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as environments from "../../../../environments.mjs";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import * as serializers from "../../../../serialization/index.mjs";
+import * as AgentMail from "../../../index.mjs";
+export class ForwardingClient {
+    constructor(options = {}) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+    /**
+     * Get the forwarding the organization sets. Pods and inboxes that set no forwarding of their own
+     * use this list. Needs an organization-scoped API key.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding get
+     * ```
+     *
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.get()
+     */
+    get(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__get(requestOptions));
+    }
+    __get(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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.Prod)
+                    .http, "/v0/forwarding"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.Forwarding.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 403:
+                        throw new AgentMail.ForwardingForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v0/forwarding");
+        });
+    }
+    /**
+     * Set the addresses the organization forwards to. The list replaces the current one. An address
+     * that is not verified is saved but receives nothing until it is verified. Needs an
+     * organization-scoped API key in an organization that has completed agent verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding update --destinations ops@example.com --destinations archive@example.com
+     * ```
+     *
+     * @param {AgentMail.UpdateForwardingRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.update({
+     *         destinations: ["destinations", "destinations"]
+     *     })
+     */
+    update(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__update(request, requestOptions));
+    }
+    __update(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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.Prod)
+                    .http, "/v0/forwarding"),
+                method: "PUT",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.UpdateForwardingRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.UpdateForwardingResponse.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new AgentMail.ForwardingForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "PUT", "/v0/forwarding");
+        });
+    }
+    /**
+     * Remove the organization's forwarding, so its inboxes stop forwarding unless their pod or the
+     * inbox sets its own. Verified addresses stay verified, so adding one again needs no new code.
+     * Returns `not_found` when the organization sets no forwarding.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding delete
+     * ```
+     *
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     *
+     * @example
+     *     await client.forwarding.delete()
+     */
+    delete(requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__delete(requestOptions));
+    }
+    __delete(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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.Prod)
+                    .http, "/v0/forwarding"),
+                method: "DELETE",
+                headers: _headers,
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.Forwarding.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 404:
+                        throw new AgentMail.NotFoundError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new AgentMail.ForwardingForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "DELETE", "/v0/forwarding");
+        });
+    }
+    /**
+     * Email a confirmation code to an address, so it can receive forwarded mail once confirmed.
+     * Verification belongs to the organization: once verified, the address can be used at the
+     * organization, any pod and any inbox. Starting again replaces any code already sent to the
+     * address. Needs an organization- or pod-scoped API key in an organization that has completed
+     * agent verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding start-verification --destination ops@example.com
+     * ```
+     *
+     * @param {AgentMail.StartForwardingVerificationRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     * @throws {@link AgentMail.UnprocessableError}
+     * @throws {@link AgentMail.ForwardingRateLimitError}
+     *
+     * @example
+     *     await client.forwarding.startVerification({
+     *         destination: "destination"
+     *     })
+     */
+    startVerification(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__startVerification(request, requestOptions));
+    }
+    __startVerification(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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.Prod)
+                    .http, "/v0/forwarding/verifications"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.StartForwardingVerificationRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ForwardingVerificationStarted.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new AgentMail.ForwardingForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 429:
+                        throw new AgentMail.ForwardingRateLimitError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/forwarding/verifications");
+        });
+    }
+    /**
+     * Submit the code emailed by Start Verification to verify the address. A code allows 10 wrong
+     * attempts, then stops working even with the right code, and Start Verification sends a new one.
+     * Needs an organization- or pod-scoped API key in an organization that has completed agent
+     * verification.
+     *
+     * **CLI:**
+     * ```bash
+     * agentmail forwarding confirm-verification --destination ops@example.com --code 7KQ2M-XW9PD
+     * ```
+     *
+     * @param {AgentMail.ConfirmForwardingVerificationRequest} request
+     * @param {ForwardingClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.ValidationError}
+     * @throws {@link AgentMail.ForwardingForbiddenError}
+     * @throws {@link AgentMail.ConflictError}
+     *
+     * @example
+     *     await client.forwarding.confirmVerification({
+     *         destination: "destination",
+     *         code: "code"
+     *     })
+     */
+    confirmVerification(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__confirmVerification(request, requestOptions));
+    }
+    __confirmVerification(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, 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.Prod)
+                    .http, "/v0/forwarding/verifications/confirm"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: serializers.ConfirmForwardingVerificationRequest.jsonOrThrow(request, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                }),
+                timeoutMs: ((_f = (_d = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _d !== void 0 ? _d : (_e = this._options) === null || _e === void 0 ? void 0 : _e.timeoutInSeconds) !== null && _f !== void 0 ? _f : 60) * 1000,
+                maxRetries: (_g = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _g !== void 0 ? _g : (_h = this._options) === null || _h === void 0 ? void 0 : _h.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_j = this._options) === null || _j === void 0 ? void 0 : _j.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: serializers.ForwardingVerificationConfirmed.parseOrThrow(_response.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }),
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AgentMail.ValidationError(serializers.ValidationErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 403:
+                        throw new AgentMail.ForwardingForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    case 409:
+                        throw new AgentMail.ConflictError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/v0/forwarding/verifications/confirm");
+        });
+    }
+}

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

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

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

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

package/dist/esm/api/resources/forwarding/errors/ForwardingForbiddenError.d.mts

@@ -0,0 +1,6 @@
+import type * as core from "../../../../core/index.mjs";
+import * as errors from "../../../../errors/index.mjs";
+import type * as AgentMail from "../../../index.mjs";
+export declare class ForwardingForbiddenError extends errors.AgentMailError {
+    constructor(body: AgentMail.ErrorResponse, rawResponse?: core.RawResponse);
+}