agentmail 0.5.19 → 0.5.21

package/dist/cjs/api/resources/apiKeys/types/BrowserCredentialCreator.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentAccepted.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Pending enrollment receipt. The browser completes key creation and proof
+ * on the existing AgentID page. This response contains no URL, token, or
+ * navigation instruction.
+ */
+export interface BrowserEnrollmentAccepted {
+    status: "pending";
+    enrollmentId: string;
+    /** Unix timestamp after which the pending enrollment cannot be activated. */
+    expiresAt: number;
+}

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentAccepted.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentLifecycleEvent.d.ts

@@ -0,0 +1,12 @@
+import type * as AgentMail from "../../../index.js";
+export interface BrowserEnrollmentLifecycleEvent {
+    type: AgentMail.BrowserEnrollmentLifecycleEventType;
+    traceId: string;
+    eventId: string;
+    occurredAt: Date;
+    organizationId: string;
+    podId: string;
+    actor: AgentMail.BrowserLifecycleActor;
+    enrollmentId: string;
+    credentialId: string;
+}

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentLifecycleEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentLifecycleEventType.d.ts

@@ -0,0 +1,7 @@
+export declare const BrowserEnrollmentLifecycleEventType: {
+    readonly BrowserEnrollmentIntentCreated: "browser_enrollment_intent_created";
+    readonly BrowserCredentialActivated: "browser_credential_activated";
+    readonly BrowserEnrollmentCancelled: "browser_enrollment_cancelled";
+    readonly BrowserCredentialDeleted: "browser_credential_deleted";
+};
+export type BrowserEnrollmentLifecycleEventType = (typeof BrowserEnrollmentLifecycleEventType)[keyof typeof BrowserEnrollmentLifecycleEventType];

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentLifecycleEventType.js

@@ -0,0 +1,10 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserEnrollmentLifecycleEventType = void 0;
+exports.BrowserEnrollmentLifecycleEventType = {
+    BrowserEnrollmentIntentCreated: "browser_enrollment_intent_created",
+    BrowserCredentialActivated: "browser_credential_activated",
+    BrowserEnrollmentCancelled: "browser_enrollment_cancelled",
+    BrowserCredentialDeleted: "browser_credential_deleted",
+};

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentTransactionJti.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Transaction identifier read from an enrollment action on exactly `https://auth.agentid.com`.
+ */
+export type BrowserEnrollmentTransactionJti = string;

package/dist/cjs/api/resources/apiKeys/types/BrowserEnrollmentTransactionJti.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleActor.d.ts

@@ -0,0 +1,10 @@
+import type * as AgentMail from "../../../index.js";
+export type BrowserLifecycleActor = AgentMail.BrowserLifecycleActor.ApiKey | AgentMail.BrowserLifecycleActor.BrowserCredential;
+export declare namespace BrowserLifecycleActor {
+    interface ApiKey extends AgentMail.BrowserLifecycleApiKeyActor {
+        type: "api_key";
+    }
+    interface BrowserCredential extends AgentMail.BrowserLifecycleCredentialActor {
+        type: "browser_credential";
+    }
+}

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleActor.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleApiKeyActor.d.ts

@@ -0,0 +1,3 @@
+export interface BrowserLifecycleApiKeyActor {
+    apiKeyId: string;
+}

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleApiKeyActor.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleCredentialActor.d.ts

@@ -0,0 +1,4 @@
+export interface BrowserLifecycleCredentialActor {
+    credentialId: string;
+    authorizingApiKeyId: string;
+}

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleCredentialActor.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleEvent.d.ts

@@ -0,0 +1,2 @@
+import type * as AgentMail from "../../../index.js";
+export type BrowserLifecycleEvent = AgentMail.BrowserEnrollmentLifecycleEvent | AgentMail.BrowserConsentLifecycleEvent;

package/dist/cjs/api/resources/apiKeys/types/BrowserLifecycleEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/CreateBrowserEnrollmentRequest.d.ts

@@ -0,0 +1,9 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * Attach a browser enrollment intent to one pending AgentID authorization
+ * transaction. The inbox is selected by the trusted path parameter, not an
+ * AgentID `login_hint`.
+ */
+export interface CreateBrowserEnrollmentRequest {
+    transactionJti: AgentMail.BrowserEnrollmentTransactionJti;
+}

package/dist/cjs/api/resources/apiKeys/types/CreateBrowserEnrollmentRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/ListBrowserConsentsResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+export interface ListBrowserConsentsResponse {
+    count: AgentMail.Count;
+    limit: AgentMail.BrowserAuthorizationListLimit;
+    nextPageToken?: AgentMail.PageToken;
+    consents: AgentMail.BrowserConsent[];
+}

package/dist/cjs/api/resources/apiKeys/types/ListBrowserConsentsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/ListBrowserCredentialsResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+export interface ListBrowserCredentialsResponse {
+    count: AgentMail.Count;
+    limit: AgentMail.BrowserAuthorizationListLimit;
+    nextPageToken?: AgentMail.PageToken;
+    credentials: AgentMail.BrowserCredential[];
+}

package/dist/cjs/api/resources/apiKeys/types/ListBrowserCredentialsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/apiKeys/types/ListBrowserLifecycleEventsResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+export interface ListBrowserLifecycleEventsResponse {
+    count: AgentMail.Count;
+    limit: AgentMail.BrowserAuthorizationListLimit;
+    nextPageToken?: AgentMail.PageToken;
+    events: AgentMail.BrowserLifecycleEvent[];
+}

package/dist/cjs/api/resources/apiKeys/types/ListBrowserLifecycleEventsResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,12 +1,30 @@
 export * from "./ApiKey.js";
 export * from "./ApiKeyId.js";
 export * from "./ApiKeyPermissions.js";
+export * from "./BrowserAuthorizationListLimit.js";
+export * from "./BrowserConsent.js";
+export * from "./BrowserConsentLifecycleEvent.js";
+export * from "./BrowserConsentLifecycleEventType.js";
+export * from "./BrowserCredential.js";
+export * from "./BrowserCredentialCreator.js";
+export * from "./BrowserEnrollmentAccepted.js";
+export * from "./BrowserEnrollmentLifecycleEvent.js";
+export * from "./BrowserEnrollmentLifecycleEventType.js";
+export * from "./BrowserEnrollmentTransactionJti.js";
+export * from "./BrowserLifecycleActor.js";
+export * from "./BrowserLifecycleApiKeyActor.js";
+export * from "./BrowserLifecycleCredentialActor.js";
+export * from "./BrowserLifecycleEvent.js";
 export * from "./CreateApiKeyRequest.js";
 export * from "./CreateApiKeyResponse.js";
+export * from "./CreateBrowserEnrollmentRequest.js";
 export * from "./CreatedAt.js";
 export * from "./CreatePublicKeyRequest.js";
 export * from "./InboxPublicKeyScope.js";
 export * from "./ListApiKeysResponse.js";
+export * from "./ListBrowserConsentsResponse.js";
+export * from "./ListBrowserCredentialsResponse.js";
+export * from "./ListBrowserLifecycleEventsResponse.js";
 export * from "./ListPublicKeysResponse.js";
 export * from "./Name.js";
 export * from "./OrganizationPublicKeyScope.js";

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

@@ -17,12 +17,30 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ApiKey.js"), exports);
 __exportStar(require("./ApiKeyId.js"), exports);
 __exportStar(require("./ApiKeyPermissions.js"), exports);
+__exportStar(require("./BrowserAuthorizationListLimit.js"), exports);
+__exportStar(require("./BrowserConsent.js"), exports);
+__exportStar(require("./BrowserConsentLifecycleEvent.js"), exports);
+__exportStar(require("./BrowserConsentLifecycleEventType.js"), exports);
+__exportStar(require("./BrowserCredential.js"), exports);
+__exportStar(require("./BrowserCredentialCreator.js"), exports);
+__exportStar(require("./BrowserEnrollmentAccepted.js"), exports);
+__exportStar(require("./BrowserEnrollmentLifecycleEvent.js"), exports);
+__exportStar(require("./BrowserEnrollmentLifecycleEventType.js"), exports);
+__exportStar(require("./BrowserEnrollmentTransactionJti.js"), exports);
+__exportStar(require("./BrowserLifecycleActor.js"), exports);
+__exportStar(require("./BrowserLifecycleApiKeyActor.js"), exports);
+__exportStar(require("./BrowserLifecycleCredentialActor.js"), exports);
+__exportStar(require("./BrowserLifecycleEvent.js"), exports);
 __exportStar(require("./CreateApiKeyRequest.js"), exports);
 __exportStar(require("./CreateApiKeyResponse.js"), exports);
+__exportStar(require("./CreateBrowserEnrollmentRequest.js"), exports);
 __exportStar(require("./CreatedAt.js"), exports);
 __exportStar(require("./CreatePublicKeyRequest.js"), exports);
 __exportStar(require("./InboxPublicKeyScope.js"), exports);
 __exportStar(require("./ListApiKeysResponse.js"), exports);
+__exportStar(require("./ListBrowserConsentsResponse.js"), exports);
+__exportStar(require("./ListBrowserCredentialsResponse.js"), exports);
+__exportStar(require("./ListBrowserLifecycleEventsResponse.js"), exports);
 __exportStar(require("./ListPublicKeysResponse.js"), exports);
 __exportStar(require("./Name.js"), exports);
 __exportStar(require("./OrganizationPublicKeyScope.js"), exports);

package/dist/cjs/api/resources/attachments/types/SendAttachment.d.ts

@@ -1,11 +1,18 @@
 import type * as AgentMail from "../../../index.js";
+/**
+ * Provide either `content` or `url` for each attachment.
+ */
 export interface SendAttachment {
     filename?: AgentMail.AttachmentFilename;
     contentType?: AgentMail.AttachmentContentType;
     contentDisposition?: AgentMail.AttachmentContentDisposition;
     contentId?: AgentMail.AttachmentContentId;
-    /** Base64 encoded content of attachment. */
+    /** Base64 encoded content of the attachment. The entire request, including the message body and all attachments, is limited to 6 MB. */
     content?: string;
-    /** URL to the attachment. */
+    /**
+     * URL that AgentMail can download without custom authentication headers or cookies.
+     * Redirects and pre-signed URLs are supported, and the final response must be a
+     * successful 2xx response. Keep URL-backed attachments around 30 MB total per message.
+     */
     url?: string;
 }

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

@@ -111,10 +111,27 @@ export declare class DomainsClient {
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.domains.verify("domain_id")
      */
     verify(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<void>;
     private __verify;
+    /**
+     * Build a one-click DNS setup link for the domain via the Domain Connect standard. When the domain's DNS provider supports Domain Connect and carries the AgentMail template, the response contains a signed URL: opening it lets the domain owner approve the required DNS records at their provider, which writes them automatically — no copy-paste. When the provider does not support it, `supported` is `false` and the domain's `records` should be added manually instead.
+     *
+     * @param {AgentMail.DomainId} domain_id
+     * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     * @throws {@link AgentMail.UnprocessableError}
+     *
+     * @example
+     *     await client.domains.getSetupLink("domain_id")
+     */
+    getSetupLink(domain_id: AgentMail.DomainId, requestOptions?: DomainsClient.RequestOptions): core.HttpResponsePromise<AgentMail.GetSetupLinkResponse>;
+    private __getSetupLink;
 }

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

@@ -453,6 +453,8 @@ class DomainsClient {
      * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     * @throws {@link AgentMail.UnprocessableError}
      *
      * @example
      *     await client.domains.verify("domain_id")
@@ -490,6 +492,22 @@ class DomainsClient {
                             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);
+                    case 422:
+                        throw new AgentMail.UnprocessableError(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,
@@ -501,5 +519,87 @@ class DomainsClient {
             return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "POST", "/v0/domains/{domain_id}/verify");
         });
     }
+    /**
+     * Build a one-click DNS setup link for the domain via the Domain Connect standard. When the domain's DNS provider supports Domain Connect and carries the AgentMail template, the response contains a signed URL: opening it lets the domain owner approve the required DNS records at their provider, which writes them automatically — no copy-paste. When the provider does not support it, `supported` is `false` and the domain's `records` should be added manually instead.
+     *
+     * @param {AgentMail.DomainId} domain_id
+     * @param {DomainsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AgentMail.NotFoundError}
+     * @throws {@link AgentMail.ConflictError}
+     * @throws {@link AgentMail.UnprocessableError}
+     *
+     * @example
+     *     await client.domains.getSetupLink("domain_id")
+     */
+    getSetupLink(domain_id, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getSetupLink(domain_id, requestOptions));
+    }
+    __getSetupLink(domain_id, 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 = (0, headers_js_1.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/domains/${core.url.encodePathParam(serializers.DomainId.jsonOrThrow(domain_id, { omitUndefined: true }))}/setup-link`),
+                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.GetSetupLinkResponse.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 409:
+                        throw new AgentMail.ConflictError(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);
+                    default:
+                        throw new errors.AgentMailError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/v0/domains/{domain_id}/setup-link");
+        });
+    }
 }
 exports.DomainsClient = DomainsClient;

package/dist/cjs/api/resources/domains/types/CreateDomainRequest.d.ts

@@ -3,4 +3,5 @@ export interface CreateDomainRequest {
     domain: AgentMail.DomainName;
     feedbackEnabled?: AgentMail.FeedbackEnabled;
     subdomainsEnabled?: AgentMail.SubdomainsEnabled;
+    trackingEnabled?: AgentMail.TrackingEnabled;
 }

package/dist/cjs/api/resources/domains/types/Domain.d.ts

@@ -4,8 +4,11 @@ export interface Domain {
     domainId: AgentMail.DomainId;
     domain: AgentMail.DomainName;
     status: AgentMail.Status;
+    /** Why the domain is not (yet) VERIFIED, when known. `dns_records_missing` / `dns_records_invalid` point at the DNS records. The `ses_*` values mean the records look right and sending-infrastructure validation has not converged: `ses_dkim_pending` / `ses_mail_from_pending` (still checking), `ses_dkim_temporary_failure` / `ses_mail_from_temporary_failure` (a transient error the infrastructure keeps retrying on its own — usually resolves without changes), `ses_dkim_failed` / `ses_mail_from_failed` (a terminal verdict; re-verify after fixing), `ses_dkim_not_started` / `ses_mail_from_not_started` (the attribute was never configured on the identity — re-verify to push it), and `ses_not_verified_for_sending`. Absent when VERIFIED. */
+    reason?: string;
     feedbackEnabled: AgentMail.FeedbackEnabled;
     subdomainsEnabled: AgentMail.SubdomainsEnabled;
+    trackingEnabled: AgentMail.TrackingEnabled;
     /**
      * A list of DNS records required to verify the domain. Includes a
      * wildcard MX record (`*.<domain>`) when `subdomains_enabled` is true.

package/dist/cjs/api/resources/domains/types/DomainItem.d.ts

@@ -5,6 +5,7 @@ export interface DomainItem {
     domain: AgentMail.DomainName;
     feedbackEnabled: AgentMail.FeedbackEnabled;
     subdomainsEnabled: AgentMail.SubdomainsEnabled;
+    trackingEnabled: AgentMail.TrackingEnabled;
     clientId?: AgentMail.ClientId;
     /** Time at which the domain was last updated. */
     updatedAt: Date;

package/dist/cjs/api/resources/domains/types/GetSetupLinkResponse.d.ts

@@ -0,0 +1,16 @@
+export interface GetSetupLinkResponse {
+    /** Whether one-click setup is available for this domain. `false` means the domain's DNS provider does not support Domain Connect (or does not carry the AgentMail template yet) — add the domain's `records` manually instead. */
+    supported: boolean;
+    /** Display name of the domain's DNS provider, for the setup button label. */
+    providerName?: string;
+    /** The signed Domain Connect apply URL. Open it in a browser: the domain owner signs in at their DNS provider, reviews the records, and approves — the provider writes them. */
+    url?: string;
+    /** Suggested popup width from the provider, in pixels. */
+    width?: number;
+    /** Suggested popup height from the provider, in pixels. */
+    height?: number;
+    /** Opaque value echoed back on the provider's redirect. Store it before opening the URL and compare on return to tie the redirect to this request. */
+    state?: string;
+    /** Set when the domain currently has another email provider's MX records (for example Google Workspace). Applying the template would replace them — warn before proceeding. */
+    conflictingProvider?: string;
+}

package/dist/cjs/api/resources/domains/types/GetSetupLinkResponse.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/domains/types/TrackingEnabled.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serve open tracking pixels from this domain. Adds a required `link.<domain>`
+ * CNAME record to `records`, which must be published and verified before
+ * `track_opens` can be used on a send.
+ */
+export type TrackingEnabled = boolean;

package/dist/cjs/api/resources/domains/types/TrackingEnabled.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/domains/types/UpdateDomainRequest.d.ts

@@ -1,6 +1,7 @@
 import type * as AgentMail from "../../../index.js";
 /**
- * Provide at least one of `feedback_enabled` or `subdomains_enabled`. Omitted
+ * Provide at least one of `feedback_enabled`, `subdomains_enabled`, or
+ * `tracking_enabled`. Omitted
  * fields are left unchanged; an empty body is rejected. Enabling
  * `subdomains_enabled` on a verified domain returns it to `PENDING` until the
  * newly-required wildcard MX record (`*.<domain>`) is published and verified.
@@ -8,4 +9,5 @@ import type * as AgentMail from "../../../index.js";
 export interface UpdateDomainRequest {
     feedbackEnabled?: AgentMail.FeedbackEnabled;
     subdomainsEnabled?: AgentMail.SubdomainsEnabled;
+    trackingEnabled?: AgentMail.TrackingEnabled;
 }

package/dist/cjs/api/resources/domains/types/VerificationRecord.d.ts

@@ -10,4 +10,6 @@ export interface VerificationRecord {
     status: AgentMail.RecordStatus;
     /** The priority of the MX record. */
     priority?: number;
+    /** Why the record is INVALID, when known. `duplicate_records` means the expected value is present but extra records coexist at the same name; `value_mismatch` means a record exists but does not match the expected value. */
+    reason?: string;
 }

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

@@ -5,11 +5,13 @@ export * from "./DomainId.js";
 export * from "./DomainItem.js";
 export * from "./DomainName.js";
 export * from "./FeedbackEnabled.js";
+export * from "./GetSetupLinkResponse.js";
 export * from "./ListDomainsResponse.js";
 export * from "./RecordStatus.js";
 export * from "./RecordType.js";
 export * from "./Status.js";
 export * from "./SubdomainsEnabled.js";
+export * from "./TrackingEnabled.js";
 export * from "./UpdateDomainRequest.js";
 export * from "./VerificationRecord.js";
 export * from "./VerificationStatus.js";

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

@@ -21,11 +21,13 @@ __exportStar(require("./DomainId.js"), exports);
 __exportStar(require("./DomainItem.js"), exports);
 __exportStar(require("./DomainName.js"), exports);
 __exportStar(require("./FeedbackEnabled.js"), exports);
+__exportStar(require("./GetSetupLinkResponse.js"), exports);
 __exportStar(require("./ListDomainsResponse.js"), exports);
 __exportStar(require("./RecordStatus.js"), exports);
 __exportStar(require("./RecordType.js"), exports);
 __exportStar(require("./Status.js"), exports);
 __exportStar(require("./SubdomainsEnabled.js"), exports);
+__exportStar(require("./TrackingEnabled.js"), exports);
 __exportStar(require("./UpdateDomainRequest.js"), exports);
 __exportStar(require("./VerificationRecord.js"), exports);
 __exportStar(require("./VerificationStatus.js"), exports);

package/dist/cjs/api/resources/events/types/EventType.d.ts

@@ -8,6 +8,7 @@ export declare const EventType: {
     readonly MessageBounced: "message.bounced";
     readonly MessageComplained: "message.complained";
     readonly MessageRejected: "message.rejected";
+    readonly MessageOpened: "message.opened";
     readonly DomainVerified: "domain.verified";
 };
 export type EventType = (typeof EventType)[keyof typeof EventType];

package/dist/cjs/api/resources/events/types/EventType.js

@@ -12,5 +12,6 @@ exports.EventType = {
     MessageBounced: "message.bounced",
     MessageComplained: "message.complained",
     MessageRejected: "message.rejected",
+    MessageOpened: "message.opened",
     DomainVerified: "domain.verified",
 };

package/dist/cjs/api/resources/events/types/MessageOpenedEvent.d.ts

@@ -0,0 +1,11 @@
+import type * as AgentMail from "../../../index.js";
+/**
+ * A tracked message was opened for the first time. Sent once per message: repeat opens do not
+ * resend it.
+ */
+export interface MessageOpenedEvent {
+    type: "event";
+    eventType: "message.opened";
+    eventId: AgentMail.EventId;
+    open: AgentMail.Open;
+}

package/dist/cjs/api/resources/events/types/MessageOpenedEvent.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/events/types/Open.d.ts

@@ -0,0 +1,7 @@
+import type * as AgentMail from "../../../index.js";
+export interface Open {
+    inboxId: AgentMail.inboxes.InboxId;
+    threadId: AgentMail.ThreadId;
+    messageId: AgentMail.MessageId;
+    timestamp: AgentMail.Timestamp;
+}

package/dist/cjs/api/resources/events/types/Open.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -9,10 +9,12 @@ export * from "./InboxIds.js";
 export * from "./MessageBouncedEvent.js";
 export * from "./MessageComplainedEvent.js";
 export * from "./MessageDeliveredEvent.js";
+export * from "./MessageOpenedEvent.js";
 export * from "./MessageReceivedEvent.js";
 export * from "./MessageReceivedEventType.js";
 export * from "./MessageRejectedEvent.js";
 export * from "./MessageSentEvent.js";
+export * from "./Open.js";
 export * from "./PodIds.js";
 export * from "./Recipient.js";
 export * from "./Reject.js";

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

@@ -25,10 +25,12 @@ __exportStar(require("./InboxIds.js"), exports);
 __exportStar(require("./MessageBouncedEvent.js"), exports);
 __exportStar(require("./MessageComplainedEvent.js"), exports);
 __exportStar(require("./MessageDeliveredEvent.js"), exports);
+__exportStar(require("./MessageOpenedEvent.js"), exports);
 __exportStar(require("./MessageReceivedEvent.js"), exports);
 __exportStar(require("./MessageReceivedEventType.js"), exports);
 __exportStar(require("./MessageRejectedEvent.js"), exports);
 __exportStar(require("./MessageSentEvent.js"), exports);
+__exportStar(require("./Open.js"), exports);
 __exportStar(require("./PodIds.js"), exports);
 __exportStar(require("./Recipient.js"), exports);
 __exportStar(require("./Reject.js"), exports);