@productcraft/mail 0.2.4 → 1.0.0

package/dist/index.cjs

@@ -1,16 +1,3844 @@
 'use strict';
 
+Object.defineProperty(exports, '__esModule', { value: true });
+
 var core = require('@productcraft/core');
 
-// src/index.ts
-var Mail = class {
-  /** The underlying typed client. v0 surface — every endpoint reachable. */
-  client;
-  constructor(config = {}) {
-    this.client = core.makeClient(core.PC_BASE_URL.mail, config);
+// src/_generated/client.ts
+
+// src/_generated/resources.ts
+var APIResource = class {
+  _client;
+  /** Path parameters (and `actor_id`) bound by the enclosing scope. */
+  _b;
+  constructor(client, bound = {}) {
+    this._client = client;
+    this._b = bound;
+  }
+};
+var BrandResource = class extends APIResource {
+  /**
+   * Remove all brand customizations and revert to platform defaults.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/brand
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-brand
+   * @example
+   * ```ts
+   * await mail.brand.reset();
+   * ```
+   */
+  reset(options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/brand" }, options);
+  }
+  /**
+   * Get the resolved brand tokens for the workspace. Always returns a complete object, with platform defaults filling in any unset fields.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/brand
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-brand
+   * @example
+   * ```ts
+   * const brand = await mail.brand.retrieve();
+   * ```
+   */
+  retrieve(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/brand" }, options);
+  }
+  /**
+   * Replace the workspace brand. Any field omitted from the body is reset to the platform default for that field. To partially-update, send back what GET returned with the desired diff applied.
+   *
+   * @param params - `Mail.BrandUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure on the brand payload.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/brand
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-brand
+   * @example
+   * ```ts
+   * const brand = await mail.brand.update({ background_color: "string" });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/brand", body: params, idempotent: true }, options);
+  }
+};
+var BroadcastsClickedLinksResource = class extends APIResource {
+  /**
+   * Links clicked in a broadcast
+   *
+   * Most clicked first. Empty until click tracking is enabled.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/clicked-links
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcasts-broadcast-id-clicked-links
+   * @example
+   * ```ts
+   * const clickedLinks = await mail.broadcasts.clickedLinks.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  list(broadcastId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/clicked-links", pathParams: { broadcast_id: broadcastId } }, options);
+  }
+};
+var BroadcastsRecipientsResource = class extends APIResource {
+  /**
+   * List a broadcast's recipients
+   *
+   * In send order, with each message status.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param params - `Mail.BroadcastRecipientListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/recipients
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcasts-broadcast-id-recipients
+   * @example
+   * ```ts
+   * for await (const recipient of mail.broadcasts.recipients.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b")) {
+   *   console.log(recipient);
+   * }
+   * const page = await mail.broadcasts.recipients.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {}, { timeout: 5_000 });
+   * ```
+   */
+  list(broadcastId, params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/recipients", pathParams: { broadcast_id: broadcastId }, query: params }, options);
+  }
+};
+var BroadcastsSettingsResource = class extends APIResource {
+  /**
+   * Get the broadcast settings
+   *
+   * The messages-per-minute pace broadcasts go out at.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcast-settings
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcast-settings
+   * @example
+   * ```ts
+   * const broadcastSettings = await mail.broadcasts.settings.retrieve();
+   * ```
+   */
+  retrieve(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcast-settings" }, options);
+  }
+  /**
+   * Update the broadcast settings
+   *
+   * Set the workspace campaign pace (1 to 300 messages per minute; null for the default, 120). It never affects transactional sends, which have their own limit.
+   *
+   * @param params - `Mail.BroadcastSettingsUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/broadcast-settings
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-broadcast-settings
+   * @example
+   * ```ts
+   * const broadcastSettings = await mail.broadcasts.settings.update({ rate_per_minute: 1 });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/broadcast-settings", body: params, idempotent: true }, options);
+  }
+};
+var BroadcastsResource = class extends APIResource {
+  #clickedLinks;
+  #recipients;
+  #settings;
+  get clickedLinks() {
+    return this.#clickedLinks ??= new BroadcastsClickedLinksResource(this._client, this._b);
+  }
+  get recipients() {
+    return this.#recipients ??= new BroadcastsRecipientsResource(this._client, this._b);
+  }
+  get settings() {
+    return this.#settings ??= new BroadcastsSettingsResource(this._client, this._b);
+  }
+  /**
+   * Count a broadcast audience
+   *
+   * How many contacts a broadcast to this segment and/or topic would reach if it were sent now: members of the segment, subscribed to the topic, minus anyone unsubscribed or on the suppression list.
+   *
+   * @param params - `Mail.BroadcastAudienceParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, AUDIENCE_REQUIRED, SEGMENT_NOT_FOUND, TOPIC_NOT_FOUND: Neither given (`AUDIENCE_REQUIRED`), or one does not exist in this workspace (`SEGMENT_NOT_FOUND` / `TOPIC_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcasts/audience
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcasts-audience
+   * @example
+   * ```ts
+   * const broadcastAudience = await mail.broadcasts.audience();
+   * ```
+   */
+  audience(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcasts/audience", query: params }, options);
+  }
+  /**
+   * Cancel a scheduled or sending broadcast
+   *
+   * Recipients not sent yet are marked `canceled`; messages already handed off are not recalled.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, BROADCAST_NOT_CANCELABLE, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Draft, sent or already canceled (`BROADCAST_NOT_CANCELABLE`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/cancel
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-broadcasts-broadcast-id-cancel
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.cancel("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  cancel(broadcastId, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/cancel", pathParams: { broadcast_id: broadcastId }, idempotent: true }, options);
+  }
+  /**
+   * Create a broadcast (draft)
+   *
+   * Content is a saved template (`template_name`) or inline Handlebars (`html`, `subject`, optional `text`). The audience is a segment, a topic, or both. Nothing is sent until `POST .../send`.
+   *
+   * @param params - `Mail.BroadcastCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, SEGMENT_NOT_FOUND, TOPIC_NOT_FOUND, BROADCAST_CONTENT_CONFLICT: `segment_id` or `topic_id` does not name one of this workspace's (`SEGMENT_NOT_FOUND` / `TOPIC_NOT_FOUND`), or both `template_name` and `html` were given (`BROADCAST_CONTENT_CONFLICT`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/broadcasts
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-broadcasts
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.create({ name: "October product update" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/broadcasts", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a broadcast
+   *
+   * Drafts, sent and canceled broadcasts, with their recipient list. The messages themselves stay in the message log.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, BROADCAST_NOT_DELETABLE: Scheduled or sending: cancel it first (`BROADCAST_NOT_DELETABLE`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-broadcasts-broadcast-id
+   * @example
+   * ```ts
+   * await mail.broadcasts.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(broadcastId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}", pathParams: { broadcast_id: broadcastId } }, options);
+  }
+  /**
+   * Duplicate a broadcast
+   *
+   * A new draft with the same content and audience.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/duplicate
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-broadcasts-broadcast-id-duplicate
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.duplicate("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  duplicate(broadcastId, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/duplicate", pathParams: { broadcast_id: broadcastId }, idempotent: true }, options);
+  }
+  /**
+   * List broadcasts, newest first
+   *
+   * @param params - `Mail.BroadcastListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcasts
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcasts
+   * @example
+   * ```ts
+   * for await (const broadcast of mail.broadcasts.list()) {
+   *   console.log(broadcast);
+   * }
+   * const page = await mail.broadcasts.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcasts", query: params }, options);
+  }
+  /**
+   * Get a broadcast
+   *
+   * Includes `counts` once sending has started: recipients, sent, delivered, bounced, complained, opened, clicked, unsubscribed.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-broadcasts-broadcast-id
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(broadcastId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}", pathParams: { broadcast_id: broadcastId } }, options);
+  }
+  /**
+   * Send or schedule a broadcast
+   *
+   * Now, or at `scheduled_at`. When sending starts the audience is frozen (segment ∩ topic subscribers − unsubscribed − suppression list) and the messages go out at the broadcast rate (default 120 per minute; separate from the transactional limit), on the marketing stream, each with a one-click unsubscribe link and `List-Unsubscribe` headers. The send survives restarts: it continues from the recipients not yet sent.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param params - `Mail.BroadcastSendParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, BROADCAST_NOT_DRAFT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Not a draft (`BROADCAST_NOT_DRAFT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, UNSUBSCRIBE_LINK_REQUIRED, BROADCAST_NOT_READY, BROADCAST_AUDIENCE_EMPTY, INVALID_FROM_ADDRESS, from_domain_not_verified: Not ready: `UNSUBSCRIBE_LINK_REQUIRED` (the body does not contain `{{{unsubscribe_url}}}`) or `BROADCAST_NOT_READY` (`details.problems`: no audience, no content, no subject, missing template, no From); `BROADCAST_AUDIENCE_EMPTY` (nobody to send to); `INVALID_FROM_ADDRESS`; or `from_domain_not_verified` (`details: { fqdn, reason }`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/send
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-broadcasts-broadcast-id-send
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.send("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { scheduled_at: "2026-11-02T09:00:00Z" });
+   * ```
+   */
+  send(broadcastId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}/send", pathParams: { broadcast_id: broadcastId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Update a draft broadcast
+   *
+   * Only drafts can change; null clears an optional field.
+   *
+   * @param broadcastId - Id of the broadcast.
+   * @param params - `Mail.BroadcastUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, BROADCAST_NOT_FOUND: No such broadcast (`BROADCAST_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, BROADCAST_NOT_DRAFT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Not a draft any more (`BROADCAST_NOT_DRAFT`, `details.status`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, SEGMENT_NOT_FOUND, TOPIC_NOT_FOUND, BROADCAST_CONTENT_CONFLICT: `segment_id` or `topic_id` does not name one of this workspace's (`SEGMENT_NOT_FOUND` / `TOPIC_NOT_FOUND`), or both `template_name` and `html` were given (`BROADCAST_CONTENT_CONFLICT`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-broadcasts-broadcast-id
+   * @example
+   * ```ts
+   * const broadcast = await mail.broadcasts.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { from: "string" });
+   * ```
+   */
+  update(broadcastId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/broadcasts/{broadcast_id}", pathParams: { broadcast_id: broadcastId }, body: params, idempotent: true }, options);
+  }
+};
+var ContactsImportsResource = class extends APIResource {
+  /**
+   * Import contacts from a CSV file
+   *
+   * Queues the file and returns the import (`status: queued`); poll `GET .../contacts/imports/{id}` for progress. At most 10 MB and 100,000 rows, two imports running per workspace. Rows that assert consent (`consent` true or a `consented_at` date) are recorded with it and opted in to `topic_ids`; every other row starts without consent. An import emits no per-contact webhook events.
+   *
+   * @param params - `Mail.ContactImportCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TOPIC_NOT_FOUND: A `topic_ids` entry is not a topic of this workspace (`TOPIC_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IMPORT_IN_PROGRESS, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Two imports are already running (`IMPORT_IN_PROGRESS`), or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {APIError} 413 PAYLOAD_TOO_LARGE, IMPORT_TOO_LARGE: The CSV is larger than 10 MB (`IMPORT_TOO_LARGE`).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, INVALID_CSV: Empty file, or no header line with an `email` column (`INVALID_CSV`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/contacts/imports
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-contacts-imports
+   * @example
+   * ```ts
+   * const contactImport = await mail.contacts.imports.create({
+   *   csv: "email,first_name,consent,consented_at\nada@example.com,Ada,true,2026-10-01T09:00:00Z\n",
+   *   on_conflict: "upsert",
+   * });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/contacts/imports", body: params, idempotent: true }, options);
+  }
+  /**
+   * List contact imports, newest first
+   *
+   * @param params - `Mail.ContactImportListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts/imports
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts-imports
+   * @example
+   * ```ts
+   * for await (const importItem of mail.contacts.imports.list()) {
+   *   console.log(importItem);
+   * }
+   * const page = await mail.contacts.imports.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts/imports", query: params }, options);
+  }
+  /**
+   * Get a contact import and its progress
+   *
+   * @param importId - Id of the import.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, IMPORT_NOT_FOUND: No such import in this workspace (`IMPORT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts/imports/{import_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts-imports-import-id
+   * @example
+   * ```ts
+   * const contactImport = await mail.contacts.imports.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(importId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts/imports/{import_id}", pathParams: { import_id: importId } }, options);
+  }
+};
+var ContactsPropertiesResource = class extends APIResource {
+  /**
+   * Define a contact property
+   *
+   * At most 50 per workspace.
+   *
+   * @param params - `Mail.ContactPropertyCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, CONTACT_PROPERTY_EXISTS, CONTACT_PROPERTY_LIMIT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: The key exists (`CONTACT_PROPERTY_EXISTS`), the workspace has 50 properties (`CONTACT_PROPERTY_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, RESERVED_PROPERTY_KEY, INVALID_CONTACT_PROPERTY_VALUE: The key is a contact field (`RESERVED_PROPERTY_KEY`) or the fallback does not match the type (`INVALID_CONTACT_PROPERTY_VALUE`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/contact-properties
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-contact-properties
+   * @example
+   * ```ts
+   * const contactProperty = await mail.contacts.properties.create({ key: "company", type: "string" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/contact-properties", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a contact property
+   *
+   * Values already stored on contacts stay, but are no longer validated; define the key again to use it.
+   *
+   * @param propertyId - Id of the property.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_PROPERTY_NOT_FOUND: No such property (`CONTACT_PROPERTY_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/contact-properties/{property_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-contact-properties-property-id
+   * @example
+   * ```ts
+   * await mail.contacts.properties.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(propertyId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/contact-properties/{property_id}", pathParams: { property_id: propertyId } }, options);
+  }
+  /**
+   * List contact properties, newest first
+   *
+   * @param params - `Mail.ContactPropertyListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contact-properties
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contact-properties
+   * @example
+   * ```ts
+   * for await (const property of mail.contacts.properties.list()) {
+   *   console.log(property);
+   * }
+   * const page = await mail.contacts.properties.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/contact-properties", query: params }, options);
+  }
+  /**
+   * Get a contact property
+   *
+   * @param propertyId - Id of the property.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_PROPERTY_NOT_FOUND: No such property (`CONTACT_PROPERTY_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contact-properties/{property_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contact-properties-property-id
+   * @example
+   * ```ts
+   * const contactProperty = await mail.contacts.properties.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(propertyId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/contact-properties/{property_id}", pathParams: { property_id: propertyId } }, options);
+  }
+  /**
+   * Change a contact property's fallback value
+   *
+   * The key and type are fixed once created.
+   *
+   * @param propertyId - Id of the property.
+   * @param params - `Mail.ContactPropertyUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_PROPERTY_NOT_FOUND: No such property (`CONTACT_PROPERTY_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, INVALID_CONTACT_PROPERTY_VALUE: The fallback does not match the type (`INVALID_CONTACT_PROPERTY_VALUE`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/contact-properties/{property_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-contact-properties-property-id
+   * @example
+   * ```ts
+   * const contactProperty = await mail.contacts.properties.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { fallback_value: "string" });
+   * ```
+   */
+  update(propertyId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/contact-properties/{property_id}", pathParams: { property_id: propertyId }, body: params, idempotent: true }, options);
+  }
+};
+var ContactsSegmentsResource = class extends APIResource {
+  /**
+   * Add a contact to a static segment
+   *
+   * Adds the contact. Adding a contact that is already a member changes nothing and answers the same way, with `added_at` from the first time.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param segmentId - Id of the segment.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND, SEGMENT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`) or segment (`SEGMENT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, SEGMENT_RULE_BASED: The segment is rule-based: its members follow the rule (`SEGMENT_RULE_BASED`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-contacts-contact-segments-segment-id
+   * @example
+   * ```ts
+   * const segmentMembership = await mail.contacts.segments.add("ada@example.com", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  add(contact, segmentId, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}", pathParams: { contact, segment_id: segmentId }, idempotent: true }, options);
+  }
+  /**
+   * Remove a contact from a static segment
+   *
+   * 204 whether or not it was a member.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param segmentId - Id of the segment.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND, SEGMENT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`) or segment (`SEGMENT_NOT_FOUND`).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, SEGMENT_RULE_BASED: The segment is rule-based (`SEGMENT_RULE_BASED`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-contacts-contact-segments-segment-id
+   * @example
+   * ```ts
+   * await mail.contacts.segments.delete("ada@example.com", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  delete(contact, segmentId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/contacts/{contact}/segments/{segment_id}", pathParams: { contact, segment_id: segmentId } }, options);
+  }
+  /**
+   * List a contact's segments
+   *
+   * Static segments it was added to and rule segments it matches now.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts/{contact}/segments
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts-contact-segments
+   * @example
+   * ```ts
+   * const contactSegments = await mail.contacts.segments.list("ada@example.com");
+   * ```
+   */
+  list(contact, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts/{contact}/segments", pathParams: { contact } }, options);
+  }
+};
+var ContactsTopicsResource = class extends APIResource {
+  /**
+   * List a contact's topic subscriptions
+   *
+   * Every topic of the workspace, with the contact's own choice and whether a topic send would reach it now (and why).
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts/{contact}/topics
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts-contact-topics
+   * @example
+   * ```ts
+   * const contactTopics = await mail.contacts.topics.list("ada@example.com");
+   * ```
+   */
+  list(contact, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts/{contact}/topics", pathParams: { contact } }, options);
+  }
+  /**
+   * Opt a contact in to or out of topics
+   *
+   * Records the contact's choice per topic (an explicit `opt_in` is consent for that topic). A global unsubscribe still wins: clear it with `PATCH .../contacts/{contact}` `unsubscribed: false`. Emits `contact.updated`.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param params - `Mail.ContactTopicUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND, TOPIC_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`) or topic (`TOPIC_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/contacts/{contact}/topics
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-contacts-contact-topics
+   * @example
+   * ```ts
+   * const contactTopics = await mail.contacts.topics.update("ada@example.com", { topics: [{ id: "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b", subscription: "opt_in" }] });
+   * ```
+   */
+  update(contact, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/contacts/{contact}/topics", pathParams: { contact }, body: params, idempotent: true }, options);
+  }
+};
+var ContactsResource = class extends APIResource {
+  #imports;
+  #properties;
+  #segments;
+  #topics;
+  get imports() {
+    return this.#imports ??= new ContactsImportsResource(this._client, this._b);
+  }
+  get properties() {
+    return this.#properties ??= new ContactsPropertiesResource(this._client, this._b);
+  }
+  get segments() {
+    return this.#segments ??= new ContactsSegmentsResource(this._client, this._b);
+  }
+  get topics() {
+    return this.#topics ??= new ContactsTopicsResource(this._client, this._b);
+  }
+  /**
+   * Create a contact
+   *
+   * Emits `contact.created`. Without `consent`, the contact receives only topics it is explicitly opted in to.
+   *
+   * @param params - `Mail.ContactCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TOPIC_NOT_FOUND: A `topics[].id` is not a topic of this workspace (`TOPIC_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, CONTACT_EXISTS, CONTACT_LIMIT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: A contact with this email exists (`CONTACT_EXISTS`), the workspace has 100,000 contacts (`CONTACT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, UNKNOWN_CONTACT_PROPERTY, INVALID_CONTACT_PROPERTY_VALUE: A `properties` key is not a defined property (`UNKNOWN_CONTACT_PROPERTY`) or its value has the wrong type (`INVALID_CONTACT_PROPERTY_VALUE`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/contacts
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-contacts
+   * @example
+   * ```ts
+   * const contact = await mail.contacts.create({ email: "ada@example.com" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/contacts", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a contact
+   *
+   * Removes the contact, its properties and its topic choices. Emits `contact.deleted`. To stop mailing someone, unsubscribe them instead: a deleted contact that later receives a topic send is refused (`no_consent`), but its opt-out is forgotten.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/contacts/{contact}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-contacts-contact
+   * @example
+   * ```ts
+   * await mail.contacts.delete("ada@example.com");
+   * ```
+   */
+  delete(contact, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/contacts/{contact}", pathParams: { contact } }, options);
+  }
+  /**
+   * List contacts, newest first
+   *
+   * @param params - `Mail.ContactListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts
+   * @example
+   * ```ts
+   * for await (const contact of mail.contacts.list()) {
+   *   console.log(contact);
+   * }
+   * const page = await mail.contacts.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts", query: params }, options);
+  }
+  /**
+   * Get a contact by id or email
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/contacts/{contact}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-contacts-contact
+   * @example
+   * ```ts
+   * const contact = await mail.contacts.retrieve("ada@example.com");
+   * ```
+   */
+  retrieve(contact, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/contacts/{contact}", pathParams: { contact } }, options);
+  }
+  /**
+   * Update a contact
+   *
+   * The email cannot change (delete and re-create). Emits `contact.updated` when something changed.
+   *
+   * @param contact - The contact id, or its email address (URL-encoded).
+   * @param params - `Mail.ContactUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, CONTACT_NOT_FOUND: No such contact (`CONTACT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, UNKNOWN_CONTACT_PROPERTY, INVALID_CONTACT_PROPERTY_VALUE: `UNKNOWN_CONTACT_PROPERTY` or `INVALID_CONTACT_PROPERTY_VALUE`.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/contacts/{contact}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-contacts-contact
+   * @example
+   * ```ts
+   * const contact = await mail.contacts.update("ada@example.com", { consent: { consented_at: "2026-10-24T09:00:00Z", source: "signup-form-2026" } });
+   * ```
+   */
+  update(contact, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/contacts/{contact}", pathParams: { contact }, body: params, idempotent: true }, options);
+  }
+};
+var DeliverabilityResource = class extends APIResource {
+  /**
+   * Deliverability verdict for the workspace over a lookback window. `unconfirmed` means mail was handed off and nothing came back either way — it is not a synonym for healthy.
+   *
+   * @param params - `Mail.DeliverabilityRetrieveParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: window_days out of range.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Not authenticated.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Missing mail.message.read, or the mail service is not enabled.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/deliverability
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-deliverability
+   * @example
+   * ```ts
+   * const deliverability = await mail.deliverability.retrieve();
+   * ```
+   */
+  retrieve(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/deliverability", query: params }, options);
+  }
+};
+var DomainsDnsRecordsResource = class extends APIResource {
+  /**
+   * Set up the domain's DNS records in one step with a short-lived Cloudflare or DigitalOcean API token.
+   *
+   * Reads the zone through the provider's API and plans every record the domain needs: `create`, `update` (only ever an SPF merge into an existing SPF record, shown with `before`/`after`) or `skip` (already there). `dry_run: true` returns the plan and changes nothing; `dry_run: false` applies exactly that plan, runs a DNS check straight away and records `setup_method = provider_api`. Only names at or under the domain are written, nothing is ever deleted, and Cloudflare records are DNS-only (not proxied). The recommended DMARC record (`p=none`) is included when `include_dmarc` is true (the default) and no DMARC policy applies to the domain yet; an existing policy is never touched. Any blocking conflict refuses the whole apply with 409. The token is used for this request only: it is never stored, logged, queued or returned; revoke it afterwards (`warnings` says so when it could see more than this zone). Applies are limited to one per domain every 10 seconds; dry runs are not limited.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainDnsRecordApplyParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, IDEMPOTENCY_KEY_REQUIRED, INVALID_ZONE, PROVIDER_TOKEN_REJECTED, PROVIDER_PERMISSION_DENIED, PROVIDER_ZONE_NOT_FOUND: Validation failure; `Idempotency-Key` missing (`IDEMPOTENCY_KEY_REQUIRED`); `zone` not the domain or a parent (`INVALID_ZONE`); the provider rejected the token (`PROVIDER_TOKEN_REJECTED`), the token lacks DNS permissions (`PROVIDER_PERMISSION_DENIED`), or it cannot see a zone for the domain (`PROVIDER_ZONE_NOT_FOUND`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Missing `mail.update`, or the mail service is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, DNS_CONFLICTS, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `DNS_CONFLICTS`: a blocking conflict (a second SPF record, a CNAME at the name, another DKIM key at our selector, other MX records at the MAIL FROM host or the domain, a merge over 10 SPF lookups). Nothing was written; the body carries the full `plan` and `conflicts`. Or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: Applied less than 10 seconds ago (`RATE_LIMITED`). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @throws {InternalServerError} 502 BAD_GATEWAY, PROVIDER_UNAVAILABLE, PROVIDER_ERROR: The provider failed or did not answer (`PROVIDER_UNAVAILABLE`, `PROVIDER_ERROR`). Nothing was written unless the plan items say so.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/apply
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-dns-records-apply
+   * @example
+   * ```ts
+   * const dnsApplyResult = await mail.domains.dnsRecords.apply("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { dry_run: true, provider: "cloudflare", token: "dop_v1_EXAMPLE_TOKEN_DO_NOT_USE" });
+   * ```
+   */
+  apply(domainId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/apply", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Check the domain's DNS records now.
+   *
+   * Queries the zone's authoritative nameservers and a public resolver for every record, stores the result, flips a pending domain whose required records pass to `active`, and returns the same body as `GET .../dns-records`. Never fails because records are missing: their states say so. Limited to one call per domain every 10 seconds. Safe to retry: it changes nothing but the stored check result, so it takes no Idempotency-Key.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainDnsRecordCheckParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, INVALID_ZONE: `zone` is not the domain or one of its parents (`INVALID_ZONE`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: Checked less than 10 seconds ago (`RATE_LIMITED`). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/check
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-dns-records-check
+   * @example
+   * ```ts
+   * const domainDnsRecords = await mail.domains.dnsRecords.check("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  check(domainId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/check", pathParams: { domain_id: domainId }, query: params }, options);
+  }
+  /**
+   * Download the domain's DNS records as a BIND zone fragment or a CSV.
+   *
+   * `format=bind`: a zone-file fragment (`$ORIGIN <zone>.`, `$TTL 3600`, names relative to the zone, MX with priority, TXT split into ≤255-byte quoted strings, a comment per record with its purpose, required/recommended and any conflict) that Cloudflare and Route 53 import directly. `format=csv`: `type,name,value,priority,ttl,purpose,required` (the common DNS-import columns plus two), RFC 4180 quoting, fully qualified names. By default only records not yet verified; `all=true` for every record. Served as an attachment.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainDnsRecordExportParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `format` missing or not `bind`/`csv`, or `zone` is not the domain or one of its parents.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/export
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id-dns-records-export
+   * @example
+   * ```ts
+   * const response = await mail.domains.dnsRecords.export("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { format: "bind" });
+   * const text = await response.text();
+   * ```
+   */
+  export(domainId, params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records/export", pathParams: { domain_id: domainId }, query: params, raw: true }, options);
+  }
+  /**
+   * Per-record DNS status for a domain.
+   *
+   * Every record the domain needs for its intent, with its state (`missing`, `mismatch`, `conflict`, `propagating`, `verified`), what was found, a propagation hint and timestamps, as of the last check (the verifier re-checks pending domains every 5 minutes and active ones hourly). Does not run a DNS lookup; use `POST .../dns-records/check` for that.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainDnsRecordListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, INVALID_ZONE: `zone` is not the domain or one of its parents (`INVALID_ZONE`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id-dns-records
+   * @example
+   * ```ts
+   * const domainDnsRecords = await mail.domains.dnsRecords.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  list(domainId, params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/dns-records", pathParams: { domain_id: domainId }, query: params }, options);
+  }
+};
+var DomainsDomainConnectResource = class extends APIResource {
+  /**
+   * Start one-click DNS setup at the domain's DNS provider (Domain Connect).
+   *
+   * Returns a signed Domain Connect URL for the provider that hosts the domain's zone (Cloudflare, GoDaddy, IONOS, Vercel and the others that have onboarded ProductCraft's template). Open it in the browser: the user signs in at their provider and confirms, the provider writes the DKIM key at `productcraft._domainkey.<domain>` and the MAIL FROM records at `bounce.<domain>` (MX to the regional feedback host, SPF merged into any existing SPF there), and then redirects to `GET /v1/domain-connect/callback`, which records `setup_method = domain_connect`, checks the records and returns the user to the domain in the console. With `include_dmarc` and no DMARC policy in place yet, a second confirmation adds `v=DMARC1; p=none;` at `_dmarc.<domain>`. The URL is valid for 10 minutes and works once. ProductCraft never receives a DNS credential. For sending domains whose MAIL FROM label is `bounce` (the default). Not available while ProductCraft has Domain Connect switched off (`domain_connect.available` in `GET .../domains/lookup` says whether it is).
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainDomainConnectStartParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure, or an id is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Missing `mail.update`, or the mail service is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, DOMAIN_CONNECT_DISABLED, DOMAIN_CONNECT_UNAVAILABLE, DOMAIN_CONNECT_NOT_SENDING, DOMAIN_CONNECT_MAIL_FROM_LABEL, DKIM_KEY_MISSING, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: One-click setup is not possible for this domain; nothing was started. `DOMAIN_CONNECT_DISABLED`: ProductCraft has not switched Domain Connect on. `DOMAIN_CONNECT_UNAVAILABLE`: the DNS provider does not run Domain Connect or has not onboarded our template (`details.reason`: `no_record`, `settings_unreachable`, `template_not_onboarded` or `lookup_failed`; `details.provider_name`). `DOMAIN_CONNECT_NOT_SENDING`: a receive-only domain. `DOMAIN_CONNECT_MAIL_FROM_LABEL`: the MAIL FROM label is not `bounce` or MAIL FROM is off. `DKIM_KEY_MISSING`: no DKIM key to publish. Or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/domain-connect/start
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-domain-connect-start
+   * @example
+   * ```ts
+   * const domainConnectStart = await mail.domains.domainConnect.start("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { include_dmarc: true });
+   * ```
+   */
+  start(domainId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/domain-connect/start", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+};
+var DomainsEventsResource = class extends APIResource {
+  /**
+   * List a domain's events (its timeline), newest first, cursor-paginated.
+   *
+   * Added, records found, verified, degraded, failing, recovered, MAIL FROM verified, DMARC detected, check failed. An event is written only when something changed, so a domain checked every few minutes does not grow a row per check.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainEventListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor, or `domain_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}/events
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id-events
+   * @example
+   * ```ts
+   * for await (const event of mail.domains.events.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b")) {
+   *   console.log(event);
+   * }
+   * const page = await mail.domains.events.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {}, { timeout: 5_000 });
+   * ```
+   */
+  list(domainId, params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/events", pathParams: { domain_id: domainId }, query: params }, options);
+  }
+};
+var DomainsShareLinksResource = class extends APIResource {
+  /**
+   * Create a share link: a read-only DNS setup page for whoever manages the domain's DNS.
+   *
+   * Returns a link (valid 1–7 days, default 7) to a public page that shows the domain name, its DNS records with copy-ready values, their live status and zone-file / CSV downloads, without an account. The page shows nothing else about the workspace. The link is shown only in this response (only its hash is stored); revoke it with `DELETE .../share-links/{link_id}`. Optionally emails it from ProductCraft to up to 5 recipients per domain per day (20 per workspace). Requires `mail.update` on the domain.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainShareLinkCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure: `expires_in_days` outside 1–7, more than 5 `email_to` entries, or an invalid address.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the key was used with a different body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: The daily email cap for the domain (5 recipients) or the workspace (20) would be exceeded (`RATE_LIMITED`). No link is created. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @throws {InternalServerError} 503 SERVICE_UNAVAILABLE, EMAIL_UNAVAILABLE: `EMAIL_UNAVAILABLE`: `email_to` was given but the email cap cannot be checked right now. No link is created; retry, or create it without `email_to`.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/share-links
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-share-links
+   * @example
+   * ```ts
+   * const createdShareLink = await mail.domains.shareLinks.create("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { email_to: ["it@example.com"] });
+   * ```
+   */
+  create(domainId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/share-links", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Revoke a share link.
+   *
+   * The public page and its downloads answer 404 from now on. Revoking an already revoked or expired link succeeds and changes nothing.
+   *
+   * @param domainId - Id of the domain.
+   * @param linkId - Id of the link.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: An id is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain or share link not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/domains/{domain_id}/share-links/{link_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-domains-domain-id-share-links-link-id
+   * @example
+   * ```ts
+   * await mail.domains.shareLinks.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  delete(domainId, linkId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/share-links/{link_id}", pathParams: { domain_id: domainId, link_id: linkId } }, options);
+  }
+  /**
+   * List the domain's share links (newest first, including expired and revoked), cursor-paginated.
+   *
+   * The links themselves are not returned: they are shown once, at creation.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainShareLinkListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor, or an id is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}/share-links
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id-share-links
+   * @example
+   * ```ts
+   * for await (const shareLink of mail.domains.shareLinks.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b")) {
+   *   console.log(shareLink);
+   * }
+   * const page = await mail.domains.shareLinks.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {}, { timeout: 5_000 });
+   * ```
+   */
+  list(domainId, params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/share-links", pathParams: { domain_id: domainId }, query: params }, options);
+  }
+};
+var DomainsSmtpConfigResource = class extends APIResource {
+  /**
+   * Drop the per-domain override; sends from this domain fall back to the workspace default (or ProductCraft Mail's own sending).
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: No per-domain override to delete
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-domains-domain-id-smtp-config
+   * @example
+   * ```ts
+   * await mail.domains.smtpConfig.reset("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  reset(domainId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config", pathParams: { domain_id: domainId } }, options);
+  }
+  /**
+   * Get the per-domain SMTP override (returns null if unset; the workspace default applies in that case).
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id-smtp-config
+   * @example
+   * ```ts
+   * const getSmtpConfig = await mail.domains.smtpConfig.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(domainId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config", pathParams: { domain_id: domainId } }, options);
+  }
+  /**
+   * Create or update the per-domain SMTP override (resets verification)
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainSmtpConfigUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure or username/password mismatch.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-domains-domain-id-smtp-config
+   * @example
+   * ```ts
+   * const smtpConfig = await mail.domains.smtpConfig.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {
+   *   from_email: "noreply@acme.com",
+   *   from_name: "Acme Notifications",
+   *   host: "smtp.sendgrid.net",
+   *   port: 587,
+   *   secure: false,
+   * });
+   * ```
+   */
+  update(domainId, params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Test the per-domain SMTP override; updates status
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: No per-domain override saved
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config/verify-saved
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-smtp-config-verify-saved
+   * @example
+   * ```ts
+   * const smtpVerifyResult = await mail.domains.smtpConfig.verifySaved("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  verifySaved(domainId, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/smtp-config/verify-saved", pathParams: { domain_id: domainId } }, options);
+  }
+};
+var DomainsResource = class extends APIResource {
+  #dnsRecords;
+  #domainConnect;
+  #events;
+  #shareLinks;
+  #smtpConfig;
+  get dnsRecords() {
+    return this.#dnsRecords ??= new DomainsDnsRecordsResource(this._client, this._b);
+  }
+  get domainConnect() {
+    return this.#domainConnect ??= new DomainsDomainConnectResource(this._client, this._b);
+  }
+  get events() {
+    return this.#events ??= new DomainsEventsResource(this._client, this._b);
+  }
+  get shareLinks() {
+    return this.#shareLinks ??= new DomainsShareLinksResource(this._client, this._b);
+  }
+  get smtpConfig() {
+    return this.#smtpConfig ??= new DomainsSmtpConfigResource(this._client, this._b);
+  }
+  /**
+   * Register a domain for a workspace
+   *
+   * Accepts Resend's create-domain body as well as ours: `name` for `fqdn`, `capabilities` for `intent`, `custom_return_path` for the MAIL FROM label, and `region`, `tls`, `open_tracking`, `click_tracking`, `tracking_subdomain`. Defaults to sending only (`intent: send`), as Resend does. Options we do not offer yet are refused with 422 rather than ignored.
+   *
+   * @param params - `Mail.DomainCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, INVALID_CAPABILITIES, MAIL_FROM_NOT_SENDING: Validation failure on the request body: no `fqdn`/`name`, `fqdn` and `name` disagree, `intent` and `capabilities` disagree or enable nothing (`INVALID_CAPABILITIES`), or `custom_return_path` on a receive-only domain (`MAIL_FROM_NOT_SENDING`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, MAIL_FROM_HOST_IN_USE, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Domain already registered (globally unique); `MAIL_FROM_HOST_IN_USE`: the `custom_return_path` host already has records that are not ours (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, REGION_NOT_AVAILABLE, TLS_ENFORCED_NOT_AVAILABLE, TRACKING_NOT_AVAILABLE: `REGION_NOT_AVAILABLE`: `region` is not the region this deployment sends from (`details.available`); `TLS_ENFORCED_NOT_AVAILABLE`: `tls: enforced`; `TRACKING_NOT_AVAILABLE`: open/click tracking or a tracking subdomain.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains
+   * @example
+   * ```ts
+   * const domain = await mail.domains.create({ capabilities: { receiving: "enabled", sending: "enabled" } });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a domain (must have no active mailboxes left).
+   *
+   * Permanently deletes the domain, its DNS record set and its Amazon SES sending identity. Mailboxes you already deleted on it are erased with it, together with the mail they still held and its stored files; this cannot be undone. Refused with 409 `DOMAIN_HAS_MAILBOXES` while any mailbox on it is active.
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, DOMAIN_HAS_MAILBOXES: `DOMAIN_HAS_MAILBOXES`: the domain still has active mailboxes. `details.count` is how many; `details.mailboxes` lists them (`id`, `address`, first 100). Delete them, then try again.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @throws {InternalServerError} 503 SERVICE_UNAVAILABLE, SES_IDENTITY_DELETE_FAILED: `SES_IDENTITY_DELETE_FAILED`: the domain's Amazon SES identity could not be removed. Nothing was deleted; retry.
+   * @see DELETE /v1/workspaces/{workspace_id}/domains/{domain_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-domains-domain-id
+   * @example
+   * ```ts
+   * await mail.domains.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(domainId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}", pathParams: { domain_id: domainId } }, options);
+  }
+  /**
+   * List domains registered to this workspace (newest first), cursor-paginated.
+   *
+   * @param params - `Mail.DomainListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor, search term, or status filter.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains
+   * @example
+   * ```ts
+   * for await (const domain of mail.domains.list()) {
+   *   console.log(domain);
+   * }
+   * const page = await mail.domains.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains", query: params }, options);
+  }
+  /**
+   * Look up a domain before adding it: zone, DNS provider, Domain Connect support, a better subdomain, existing records.
+   *
+   * Creates nothing. Resolves only names at or under `fqdn` and its zone apex, plus the Domain Connect endpoints the zone advertises (fetched through the SSRF guard; cached per zone for an hour). Limited to 30 lookups per workspace per minute.
+   *
+   * @param params - `Mail.DomainLookupParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `fqdn` missing or not a domain name.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 30 lookups this minute (`RATE_LIMITED`). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/lookup
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-lookup
+   * @example
+   * ```ts
+   * const domainLookup = await mail.domains.lookup({ fqdn: "acme.com" });
+   * ```
+   */
+  lookup(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/lookup", query: params }, options);
+  }
+  /**
+   * Get a single domain (with DNS instructions and its latest events).
+   *
+   * The domain with `verification_status`, `region`, the effective `dns_provider`, `recommended_pending`, its DNS instructions, and `events`: the latest 20 domain events, newest first.
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `domain_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/domains/{domain_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-domains-domain-id
+   * @example
+   * ```ts
+   * const domainDetail = await mail.domains.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(domainId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}", pathParams: { domain_id: domainId } }, options);
+  }
+  /**
+   * Retrieve until `status` is `active`, `disabled`.
+   *
+   * @param options - `intervalMs` (default 2 000), `timeoutMs` (default 300 000, then `APITimeoutError`), `signal`, and request options.
+   * @example
+   * ```ts
+   * const done = await mail.domains.poll("…");
+   * ```
+   */
+  poll(domainId, options) {
+    return this._client.poll({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}", pathParams: { domain_id: domainId } }, { field: "status", terminal: ["active", "disabled"] }, options);
+  }
+  /**
+   * Create, then poll until `status` is terminal. The Idempotency-Key goes on the create only.
+   *
+   * @param options - Poll options (`intervalMs`, `timeoutMs`, `signal`) and request options for the create.
+   */
+  createAndPoll(params, options) {
+    return this._client.createAndPoll(
+      { method: "POST", path: "/v1/workspaces/{workspace_id}/domains", body: params, idempotent: true },
+      (created) => ({ method: "GET", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}", pathParams: { domain_id: created.id } }),
+      { field: "status", terminal: ["active", "disabled"] },
+      options
+    );
+  }
+  /**
+   * Send a built-in test email from this domain, no template needed.
+   *
+   * Sends a fixed message (subject `[TEST] Sending from <domain> works`, a short body naming the domain and the From address) so a freshly verified domain can be tried before any template exists. The From address defaults to `test@<domain>` and must be at this exact domain. Like a template test send it skips the suppression list and the ordinary send limits, counts against the workspace test-send limit (30 per hour), and is recorded with `source: test_send`.
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainTestSendParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `domain_id` is not a UUID, or the body is malformed (bad `to` or `from`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, DOMAIN_NOT_FOUND: `DOMAIN_NOT_FOUND`: no such domain in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, FROM_DOMAIN_MISMATCH, from_domain_not_verified, domain_not_verified_by_provider: `FROM_DOMAIN_MISMATCH`: the From address is not at this domain; or `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain is receive-only (`reason: not_registered`) or not verified yet (`reason: not_verified`); or `domain_not_verified_by_provider`: its DNS records have been broken for over 72 h (`health: failing`). Refused before anything is recorded or queued.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 30 test sends this hour in this workspace: `RATE_LIMITED` with `details: { window, limit, retry_after }`. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/test-send
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-test-send
+   * @example
+   * ```ts
+   * const sendAccepted = await mail.domains.testSend("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { to: "you@acme.com" });
+   * ```
+   */
+  testSend(domainId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/test-send", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Update domain settings: capabilities, DNS provider hint, custom MAIL FROM subdomain, DMARC recommendation.
+   *
+   * `intent` (or Resend's `capabilities`) changes what the domain is used for. A pending domain just changes; a verified domain gaining sending or receiving has the new records checked live and is refused with 409 `CAPABILITY_NOT_VERIFIED` (the records to publish in `details.records`) until they pass. Turning receiving off is refused while active mailboxes exist (409 `DOMAIN_HAS_MAILBOXES`, the mailboxes in `details.mailboxes`; deleted mailboxes do not count); turning sending off also turns the custom MAIL FROM off. `tls`, `open_tracking`, `click_tracking` and `tracking_subdomain` are accepted for Resend compatibility; only the values in effect today pass (422 otherwise). `dns_provider` is the provider the setup wizard renders host names for. `mail_from_subdomain` sets the custom MAIL FROM label (`bounce` → `bounce.<fqdn>`; `null` turns it off): the domain's record set gains the MAIL FROM MX + SPF records, and once the domain is verified its MAIL FROM is pointed there (the default return address stays in use until the MX record is found, so mail never stops). Refused with 409 when that host already carries records that are not ours. `dmarc_managed: false` hides the `_dmarc` recommendation for domains whose DMARC is managed elsewhere (the policy is still detected and graded).
+   *
+   * @param domainId - Id of the domain.
+   * @param params - `Mail.DomainUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, INVALID_CAPABILITIES, MAIL_FROM_NOT_SENDING: Validation failure on the request body; `intent` and `capabilities` disagree or enable nothing (`INVALID_CAPABILITIES`); or `mail_from_subdomain` on a receive-only domain (`MAIL_FROM_NOT_SENDING`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, CAPABILITY_NOT_VERIFIED, DOMAIN_HAS_MAILBOXES, MAIL_FROM_HOST_IN_USE, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `CAPABILITY_NOT_VERIFIED`: a verified domain cannot gain sending or receiving until the new records verify (`details.failing`, `details.records`); `DOMAIN_HAS_MAILBOXES`: receiving cannot be turned off while active mailboxes exist (`details.count`, `details.mailboxes[].id|address`); `MAIL_FROM_HOST_IN_USE`: the MAIL FROM host already has a CNAME, a foreign MX or a foreign SPF record (listed in `details.found`); or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, TLS_ENFORCED_NOT_AVAILABLE, TRACKING_NOT_AVAILABLE: `TLS_ENFORCED_NOT_AVAILABLE`: `tls: enforced`; `TRACKING_NOT_AVAILABLE`: open/click tracking or a tracking subdomain.
+   * @throws {RateLimitError} 429 RATE_LIMITED: `mail_from_subdomain` or `intent` changed less than 10 seconds ago (`RATE_LIMITED`). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/domains/{domain_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-domains-domain-id
+   * @example
+   * ```ts
+   * const domain = await mail.domains.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { capabilities: { receiving: "enabled", sending: "enabled" } });
+   * ```
+   */
+  update(domainId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}", pathParams: { domain_id: domainId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Run a synchronous DNS check against this domain; flips status to active when the required record set passes.
+   *
+   * Legacy shape, kept as an alias of `POST .../dns-records/check`: returns the domain on success and a 400 with `dns_check_results` when a required record fails. New integrations should use `POST .../dns-records/check`, which returns per-record states.
+   *
+   * @param domainId - Id of the domain.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Verification failed — one or more required records are still missing or wrong.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: Verified less than 10 seconds ago (`RATE_LIMITED`). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/domains/{domain_id}/verify
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-domains-domain-id-verify
+   * @example
+   * ```ts
+   * const domain = await mail.domains.verify("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  verify(domainId, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/domains/{domain_id}/verify", pathParams: { domain_id: domainId } }, options);
+  }
+};
+var EmailsResource = class extends APIResource {
+  /**
+   * Send up to 100 emails in one request
+   *
+   * Each row is a `POST /emails` body plus an optional `idempotency_key`, processed independently: the response reports `accepted` (with the email `id`) or `rejected` (with `error.code`) per row. An `Idempotency-Key` header covers the whole request; a row `idempotency_key` covers one row, in the same dedupe namespace (so the header must differ from every row key).
+   *
+   * @param params - `Mail.EmailBatchParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW: Validation failure (malformed row, more than 100 rows), or `IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW`: the `Idempotency-Key` header equals a row `idempotency_key`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, from_domain_not_verified, domain_not_verified_by_provider, INVALID_FROM_ADDRESS: For any row: `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain of the From address is not itself an active sending domain of this workspace (`reason: not_registered` or `not_verified`); refused before anything is recorded or queued. Or `domain_not_verified_by_provider`: the from-domain's DNS records have been broken for over 72 h, so the email provider no longer sends for it. Or `INVALID_FROM_ADDRESS`. The whole batch is refused; no row is sent.
+   * @throws {RateLimitError} 429 RATE_LIMITED: The workspace send limits never 429 a batch: a row over one is rejected in the 200 body with `RATE_LIMITED`, and the other rows are unaffected. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/emails/batch
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-emails-batch
+   * @example
+   * ```ts
+   * const sendBatchOpenApi = await mail.emails.batch({
+   *   emails: [{ from: "Acme <hello@mail.acme.com>", to: ["success@simulator.amazonses.com"] }],
+   * });
+   * ```
+   */
+  batch(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/emails/batch", body: params, idempotent: true }, options);
+  }
+  /**
+   * List emails
+   *
+   * One entry per email (send call), newest first, with its recipients and `last_event`, the worst status across its messages. Filter by tags with `tag[name]=value` (repeat for several; all must match). Emails sent before 2026-11-06 appear as one-recipient emails.
+   *
+   * @param params - `Mail.EmailListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor or tag filter.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/emails
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-emails
+   * @example
+   * ```ts
+   * for await (const email of mail.emails.list()) {
+   *   console.log(email);
+   * }
+   * const page = await mail.emails.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/emails", query: params }, options);
+  }
+  /**
+   * Email metrics for a workspace
+   *
+   * Outbound email counts and rates over a range of up to 30 days, in hourly or daily buckets in your time zone, optionally per sending domain, filtered by domain, API key or source. Read-only.
+   *
+   * - **Emails** (`sent`): messages that left the queue.
+   * - **Deliverability rate**: delivered / emails sent with delivery tracking. Emails sent before delivery tracking started, or through a custom SMTP relay, are confirmed at hand-off only, so for them `delivered` is not measured and the rate is `null` (`measured.delivery = false`), never 0.
+   * - **Bounce rate**: bounced / emails. Suppressed recipients never count.
+   * - **Complaint rate**: complained / delivered, from mailbox providers' feedback loops.
+   *
+   * Rates are numbers from 0 to 1, or `null` when unmeasured or when the denominator is zero. Template test sends are excluded. Cached for up to 60 seconds.
+   *
+   * @param params - `Mail.EmailMetricsParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A parameter is invalid: `domain_id` or `api_key_id` is not a UUID; more than 100 `domain_id`; an unknown `timezone`, `granularity`, `source` or dimension; a date that does not parse; `end_date` not after `start_date`; a range longer than 30 days or starting before the 30-day retention; or `granularity=hourly` over more than 7 days. The reason is in `message`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: No valid credential.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN, SERVICE_NOT_ENABLED: Caller lacks `mail.message.read` on the workspace (including non-members), or Mail is not enabled on it (`SERVICE_NOT_ENABLED`).
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/emails/metrics
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-emails-metrics
+   * @example
+   * ```ts
+   * const emailMetrics = await mail.emails.metrics();
+   * ```
+   */
+  metrics(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/emails/metrics", query: params }, options);
+  }
+  /**
+   * Retrieve an email
+   *
+   * The email as sent (from, to, cc, bcc, reply_to, subject, tags, custom headers) with one entry per recipient message and `last_event`, the worst status across them. Bodies are on `GET /messages/{id}/body`.
+   *
+   * @param id - Id of the email.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, EMAIL_NOT_FOUND: `EMAIL_NOT_FOUND`: no email with this id in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/emails/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-emails-id
+   * @example
+   * ```ts
+   * const emailDetail = await mail.emails.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/emails/{id}", pathParams: { id } }, options);
+  }
+  /**
+   * Send an email
+   *
+   * Send your own `html` and/or `text`, or a saved `template`, to up to 50 recipients across `to`, `cc` and `bcc`, with `reply_to`, custom `headers` and `tags`. Every recipient gets its own copy (its own message in `GET /messages`, suppression check and delivery status) showing the same `To` and `Cc` headers; `bcc` recipients appear in no header. A recipient on the suppression list (or unsubscribed, for a template with an unsubscribe link) is left out with a `suppressed` message, and the email is still accepted. Counts one send per recipient against the workspace limits. Pass an `Idempotency-Key` header to make retries safe.
+   *
+   * @param params - `Mail.EmailSendParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, EMAIL_CONTENT_CONFLICT, RECIPIENT_LIMIT, MAIL_HEADER_NOT_ALLOWED: Validation failure; `EMAIL_CONTENT_CONFLICT` (both or neither of `html`/`text` and `template`); `RECIPIENT_LIMIT` (more than 50 recipients); `MAIL_HEADER_NOT_ALLOWED` (`details.headers` names the refused headers).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TEMPLATE_NOT_FOUND: `TEMPLATE_NOT_FOUND`: the `template.name` is not a template of this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, from_domain_not_verified, domain_not_verified_by_provider, INVALID_FROM_ADDRESS, TEMPLATE_RENDER_FAILED, TEMPLATE_DATA_INVALID: `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain of the From address is not itself an active sending domain of this workspace (`reason: not_registered` or `not_verified`); refused before anything is recorded or queued. Or `domain_not_verified_by_provider`: the from-domain's DNS records have been broken for over 72 h, so the email provider no longer sends for it. Or `INVALID_FROM_ADDRESS`. Or `TEMPLATE_RENDER_FAILED` / `TEMPLATE_DATA_INVALID` for a template send.
+   * @throws {RateLimitError} 429 RATE_LIMITED: Over a workspace send limit (60 per minute, 600 per hour, 10,000 per day; each recipient counts): `RATE_LIMITED` with `details: { window, limit, retry_after }`. Nothing is recorded or queued. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/emails
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-emails
+   * @example
+   * ```ts
+   * const sendEmail = await mail.emails.send({ from: "Acme <hello@mail.acme.com>", to: ["success@simulator.amazonses.com"] });
+   * ```
+   */
+  send(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/emails", body: params, idempotent: true }, options);
+  }
+};
+var IntegrationsGithubReposBranchesResource = class extends APIResource {
+  /**
+   * List branches for the given repo.
+   *
+   * @param owner - Owner (user or organisation) of the GitHub repository.
+   * @param repo - Name of the GitHub repository.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/integrations/github/repos/{owner}/{repo}/branches
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-integrations-github-repos-owner-repo-branches
+   * @example
+   * ```ts
+   * const result = await mail.integrations.github.repos.branches.list("owner", "repo");
+   * ```
+   */
+  list(owner, repo, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/integrations/github/repos/{owner}/{repo}/branches", pathParams: { owner, repo } }, options);
+  }
+};
+var IntegrationsGithubReposResource = class extends APIResource {
+  #branches;
+  get branches() {
+    return this.#branches ??= new IntegrationsGithubReposBranchesResource(this._client, this._b);
+  }
+  /**
+   * List repos visible to the connected GitHub account.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/integrations/github/repos
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-integrations-github-repos
+   * @example
+   * ```ts
+   * const result = await mail.integrations.github.repos.list();
+   * ```
+   */
+  list(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/integrations/github/repos" }, options);
+  }
+};
+var IntegrationsGithubSettingsResource = class extends APIResource {
+  /**
+   * Set the repo + branch + templates path to sync from.
+   *
+   * @param params - `Mail.IntegrationGithubSettingsUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/integrations/github/settings
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-integrations-github-settings
+   * @example
+   * ```ts
+   * await mail.integrations.github.settings.update({ branch: "main", repo_full_name: "octocat/templates", templates_path: "/" });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/integrations/github/settings", body: params, idempotent: true }, options);
+  }
+};
+var IntegrationsGithubSyncResource = class extends APIResource {
+  /**
+   * Trigger an immediate sync from GitHub. Returns a sync id to poll.
+   *
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/integrations/github/sync
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-integrations-github-sync
+   * @example
+   * ```ts
+   * const startSync = await mail.integrations.github.sync.create();
+   * ```
+   */
+  create(options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/integrations/github/sync", idempotent: true }, options);
+  }
+  /**
+   * Poll a sync run's status.
+   *
+   * @param syncId - Id of the sync.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Run not found or expired.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/integrations/github/sync/{sync_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-integrations-github-sync-sync-id
+   * @example
+   * ```ts
+   * const syncStatus = await mail.integrations.github.sync.retrieve("sync");
+   * ```
+   */
+  retrieve(syncId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/integrations/github/sync/{sync_id}", pathParams: { sync_id: syncId } }, options);
+  }
+};
+var IntegrationsGithubResource = class extends APIResource {
+  #repos;
+  #settings;
+  #sync;
+  get repos() {
+    return this.#repos ??= new IntegrationsGithubReposResource(this._client, this._b);
+  }
+  get settings() {
+    return this.#settings ??= new IntegrationsGithubSettingsResource(this._client, this._b);
+  }
+  get sync() {
+    return this.#sync ??= new IntegrationsGithubSyncResource(this._client, this._b);
+  }
+  /**
+   * Mint a GitHub OAuth state token and return the authorize URL.
+   *
+   * The frontend redirects the user to `authorize_url`; GitHub bounces back to the `/callback` endpoint with a `code` + `state` pair. state is single-use, 5-minute TTL.
+   *
+   * @param params - `Mail.IntegrationGithubConnectParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/integrations/github/connect
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-integrations-github-connect
+   * @example
+   * ```ts
+   * const connectGitHub = await mail.integrations.github.connect({ return_to: "https://console.productcraft.co/mail/workspaces/acme/integrations" });
+   * ```
+   */
+  connect(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/integrations/github/connect", body: params, idempotent: true }, options);
+  }
+};
+var IntegrationsResource = class extends APIResource {
+  #github;
+  get github() {
+    return this.#github ??= new IntegrationsGithubResource(this._client, this._b);
+  }
+  /**
+   * Disconnect an integration. Deletes the credential row.
+   *
+   * Hard delete — the encrypted blob is removed. The customer must reconnect via the provider-specific OAuth flow to restore access.
+   *
+   * @param provider - The integration provider (`github`).
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/integrations/{provider}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-integrations-provider
+   * @example
+   * ```ts
+   * await mail.integrations.delete("provider");
+   * ```
+   */
+  delete(provider, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/integrations/{provider}", pathParams: { provider }, idempotent: true }, options);
+  }
+  /**
+   * List connected workspace integrations.
+   *
+   * Returns one entry per connected provider (GitHub, …). No secrets in the response — only public identifiers + status + sync stamps.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/integrations
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-integrations
+   * @example
+   * ```ts
+   * const listIntegrations = await mail.integrations.list();
+   * ```
+   */
+  list(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/integrations" }, options);
+  }
+  /**
+   * Get a single integration detail with redacted credentials.
+   *
+   * Includes the provider's `credentials_redacted` view. Secret fields (access tokens, signing keys) are never included.
+   *
+   * @param provider - The integration provider (`github`).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: No integration of the requested provider for this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/integrations/{provider}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-integrations-provider
+   * @example
+   * ```ts
+   * const integrationDetail = await mail.integrations.retrieve("provider");
+   * ```
+   */
+  retrieve(provider, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/integrations/{provider}", pathParams: { provider } }, options);
+  }
+};
+var MailboxesMessagesAttachmentsResource = class extends APIResource {
+  /**
+   * Stream a single attachment by its position. Gated by `mail.message.body.read`: an attachment is message content, and /:mid already names it without handing over the bytes.
+   *
+   * @param id - Id of the mailboxe.
+   * @param mid - Id of the message in the mailbox.
+   * @param position - Position of the attachment in the message, starting at 0.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Policy denies `mail.message.body.read`.
+   * @throws {NotFoundError} 404 NOT_FOUND: Attachment not found
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/attachments/{position}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes-id-messages-mid-attachments-position
+   * @example
+   * ```ts
+   * const response = await mail.mailboxes.messages.attachments.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6", "position");
+   * const text = await response.text();
+   * ```
+   */
+  retrieve(id, mid, position, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/attachments/{position}", pathParams: { id, mid, position }, raw: true }, options);
+  }
+};
+var MailboxesMessagesResource = class extends APIResource {
+  #attachments;
+  get attachments() {
+    return this.#attachments ??= new MailboxesMessagesAttachmentsResource(this._client, this._b);
+  }
+  /**
+   * Soft-delete a message
+   *
+   * @param id - Id of the mailboxe.
+   * @param mid - Id of the message in the mailbox.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Message not found
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-mailboxes-id-messages-mid
+   * @example
+   * ```ts
+   * await mail.mailboxes.messages.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  delete(id, mid, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}", pathParams: { id, mid } }, options);
+  }
+  /**
+   * List messages in a mailbox
+   *
+   * @param id - Id of the mailboxe.
+   * @param params - `Mail.MailboxMessageListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter or cursor.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Mailbox not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes/{id}/messages
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes-id-messages
+   * @example
+   * ```ts
+   * for await (const message of mail.mailboxes.messages.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b")) {
+   *   console.log(message);
+   * }
+   * const page = await mail.mailboxes.messages.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {}, { timeout: 5_000 });
+   * ```
+   */
+  list(id, params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages", pathParams: { id }, query: params }, options);
+  }
+  /**
+   * Stream the raw RFC5322 .eml for a message. Gated by `mail.message.body.read` (admin+ by default; not granted to plain members) — the outbound lane's /messages/:id/body action.
+   *
+   * @param id - Id of the mailboxe.
+   * @param mid - Id of the message in the mailbox.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Policy denies `mail.message.body.read`.
+   * @throws {NotFoundError} 404 NOT_FOUND: Message not found
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/raw
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes-id-messages-mid-raw
+   * @example
+   * ```ts
+   * const response = await mail.mailboxes.messages.raw("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * const text = await response.text();
+   * ```
+   */
+  raw(id, mid, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/raw", pathParams: { id, mid }, raw: true }, options);
+  }
+  /**
+   * Mark a message as read
+   *
+   * @param id - Id of the mailboxe.
+   * @param mid - Id of the message in the mailbox.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Message not found
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/read
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-mailboxes-id-messages-mid-read
+   * @example
+   * ```ts
+   * await mail.mailboxes.messages.read("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  read(id, mid, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}/read", pathParams: { id, mid } }, options);
+  }
+  /**
+   * Get a single message (metadata + attachment manifest; `body_preview` is null without `mail.message.body.read`). Use /:mid/raw for content.
+   *
+   * @param id - Id of the mailboxe.
+   * @param mid - Id of the message in the mailbox.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Message not found
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes-id-messages-mid
+   * @example
+   * ```ts
+   * const messageDetail = await mail.mailboxes.messages.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "5d1e2f3a-4b5c-4d6e-8f70-8192a3b4c5d6");
+   * ```
+   */
+  retrieve(id, mid, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}/messages/{mid}", pathParams: { id, mid } }, options);
+  }
+};
+var MailboxesResource = class extends APIResource {
+  #messages;
+  get messages() {
+    return this.#messages ??= new MailboxesMessagesResource(this._client, this._b);
+  }
+  /**
+   * Create a mailbox under a verified domain. Local-part + domain combination must be globally unique.
+   *
+   * @param params - `Mail.MailboxCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure (invalid local part, retention out of range).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Caller lacks `mail.create` permission, or workspace has not enabled the `mail` service.
+   * @throws {NotFoundError} 404 NOT_FOUND: Domain not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Mailbox local-part already exists on this domain, or the domain is not yet verified, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Local part or retention rejected by service-layer validation.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/mailboxes
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-mailboxes
+   * @example
+   * ```ts
+   * const mailbox = await mail.mailboxes.create({ domain_id: "9b2f6c1e-0d6a-4a63-9a43-2f1c3e4d5a6b", local_part: "claude-qa-alpha" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/mailboxes", body: params, idempotent: true }, options);
+  }
+  /**
+   * Soft-delete a mailbox: its status becomes `disabled` and it stops accepting new mail; existing messages are kept until retention purges them, and `PATCH` with `status: active` restores it. A deleted mailbox no longer blocks deleting its domain, and deleting the domain erases it and its remaining mail.
+   *
+   * @param id - Id of the mailboxe.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Mailbox not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/mailboxes/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-mailboxes-id
+   * @example
+   * ```ts
+   * await mail.mailboxes.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(id, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}", pathParams: { id } }, options);
+  }
+  /**
+   * List mailboxes in this workspace. 20 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true.
+   *
+   * @param params - `Mail.MailboxListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: Caller lacks `mail.read` permission, or workspace has not enabled the `mail` service.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes
+   * @example
+   * ```ts
+   * for await (const mailbox of mail.mailboxes.list()) {
+   *   console.log(mailbox);
+   * }
+   * const page = await mail.mailboxes.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes", query: params }, options);
+  }
+  /**
+   * Get one mailbox by id.
+   *
+   * @param id - Id of the mailboxe.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Mailbox not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/mailboxes/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-mailboxes-id
+   * @example
+   * ```ts
+   * const mailbox = await mail.mailboxes.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}", pathParams: { id } }, options);
+  }
+  /**
+   * Update mailbox display name, retention, or status. Status transitions are restricted (active ↔ suspended; archived is terminal).
+   *
+   * @param id - Id of the mailboxe.
+   * @param params - `Mail.MailboxUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure or invalid status transition.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Mailbox not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Retention or status rejected by service-layer validation.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/mailboxes/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-mailboxes-id
+   * @example
+   * ```ts
+   * const mailbox = await mail.mailboxes.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { display_name: "string" });
+   * ```
+   */
+  update(id, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/mailboxes/{id}", pathParams: { id }, body: params, idempotent: true }, options);
+  }
+};
+var MessagesSettingsResource = class extends APIResource {
+  /**
+   * Read this workspace's outbound-message settings. Absent → defaults (redact_bodies: false).
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages/settings
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages-settings
+   * @example
+   * ```ts
+   * const outboundMessageSettings = await mail.messages.settings.retrieve();
+   * ```
+   */
+  retrieve(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages/settings" }, options);
+  }
+  /**
+   * Update this workspace's outbound-message settings. Gated on `mail.message.delete` — same privilege bar as RTBF, since both touch the PII boundary.
+   *
+   * @param params - `Mail.MessageSettingsUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid payload.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/messages/settings
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-messages-settings
+   * @example
+   * ```ts
+   * const outboundMessageSettings = await mail.messages.settings.update({ redact_bodies: true });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/messages/settings", body: params, idempotent: true }, options);
+  }
+};
+var MessagesResource = class extends APIResource {
+  #settings;
+  get settings() {
+    return this.#settings ??= new MessagesSettingsResource(this._client, this._b);
+  }
+  /**
+   * Get the cleartext body of an outbound message. Gated by `mail.message.body.read` (admin+ by default; not granted to plain members).
+   *
+   * @param id - Id of the message.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Not found.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages/{id}/body
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages-id-body
+   * @example
+   * ```ts
+   * const outboundMessageWithBody = await mail.messages.body("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  body(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages/{id}/body", pathParams: { id } }, options);
+  }
+  /**
+   * RTBF: delete every message log row for `recipient` (case-insensitive). Returns the deleted-row count.
+   *
+   * The bulk GDPR erase (`messages.erase` in the SDKs): removes every delivery-log row sent to one recipient address in this workspace (with its stored body and events), and strips the address from the cc, bcc and reply-to lists of other rows, in one transaction. Repeating it is harmless (the second call deletes 0 rows).
+   *
+   * @param params - `Mail.MessageEraseParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Missing or invalid recipient.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/messages
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-messages
+   * @example
+   * ```ts
+   * const deleteByRecipient = await mail.messages.erase({ recipient: "ada@example.com" });
+   * ```
+   */
+  erase(params, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/messages", query: params }, options);
+  }
+  /**
+   * Stream the filtered message log as CSV. Same filters as GET /messages. Body columns are intentionally omitted; bodies remain gated by `mail.message.body.read`. Rate-limited 1 concurrent + 5/hour per workspace.
+   *
+   * Columns: id, created_at, sent_at, delivered_at, deferred_at, deferral_count, from_address, to_address, subject, template_name, status, spf_result, dkim_result, dmarc_result, bounce_code, bounce_detail, api_key_id, source, domain. The filters are resolved by the same code as `GET /messages`, so the same query string exports exactly the rows the list pages through. A rejected filter (400) does not count against the hourly cap.
+   *
+   * @param params - `Mail.MessageExportParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter: an unknown status or source, a malformed uuid or date-time, `q` over 200 characters, `created_after` not earlier than `created_before`, or a window wider than 30 days. The reason is in `message`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: Another export is already running, or this workspace has hit the hourly export cap. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages/export
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages-export
+   * @example
+   * ```ts
+   * const response = await mail.messages.export();
+   * const text = await response.text();
+   * ```
+   */
+  export(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages/export", query: params, raw: true }, options);
+  }
+  /**
+   * List outbound messages with cursor pagination
+   *
+   * One row per recipient delivery, newest first. Filters combine with AND: `q` (free text over recipient, from, subject, message id and Message-ID), `status` (any of, repeatable), `domain_id`, `api_key_id`, `source`, `template`, `created_after` / `created_before` (at most 30 days apart), plus the legacy `recipient` and `subject_contains`. `GET /messages/export` takes exactly the same filters and returns the same rows.
+   *
+   * @param params - `Mail.MessageListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter or cursor: an unknown status or source, a malformed uuid or date-time, `q` over 200 characters, `created_after` not earlier than `created_before`, or a window wider than 30 days. The reason is in `message`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages
+   * @example
+   * ```ts
+   * for await (const message of mail.messages.list()) {
+   *   console.log(message);
+   * }
+   * const page = await mail.messages.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages", query: params }, options);
+  }
+  /**
+   * Get a single outbound message (metadata + delivery verdicts; body not included) with its event timeline: `events[]` oldest first, `last_event`, `transport`, `bounce_type`, `bounce_subtype`. Use /:id/body for cleartext content.
+   *
+   * @param id - Id of the message.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Not found.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages-id
+   * @example
+   * ```ts
+   * const outboundMessageDetail = await mail.messages.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages/{id}", pathParams: { id } }, options);
+  }
+  /**
+   * Day-bucketed inbound message volume for a workspace
+   *
+   * Counts INBOUND mail only: messages received by the workspace's mailboxes, in dense day buckets in [since, until). `metric=sent` (default, a historical name) counts received messages, not outbound sends; `metric=bounced` counts MX-time rejections matched to this workspace by envelope-to. For outbound counts and rates use `GET /emails/metrics`.
+   *
+   * @param params - `Mail.MessageTimelineParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/messages/timeline
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-messages-timeline
+   * @example
+   * ```ts
+   * const messageTimeline = await mail.messages.timeline({ granularity: "day", since: "2026-04-01T00:00:00Z", until: "2026-05-01T00:00:00Z" });
+   * ```
+   */
+  timeline(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/messages/timeline", query: params }, options);
+  }
+};
+var ReceivedAttachmentsResource = class extends APIResource {
+  /**
+   * Download one attachment of a received email
+   *
+   * By its `position` from the detail's attachment manifest. Unscanned, untrusted bytes from a third party. Gated by `mail.message.body.read`.
+   *
+   * @param id - Received email id.
+   * @param position - Attachment position (0-based).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `id` is not a uuid or `position` is not an integer.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.message.body.read`.
+   * @throws {NotFoundError} 404 NOT_FOUND: No such email in this workspace, or no attachment at that position.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/received/{id}/attachments/{position}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-received-id-attachments-position
+   * @example
+   * ```ts
+   * const response = await mail.received.attachments.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", "position");
+   * const text = await response.text();
+   * ```
+   */
+  retrieve(id, position, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/received/{id}/attachments/{position}", pathParams: { id, position }, raw: true }, options);
+  }
+};
+var ReceivedResource = class extends APIResource {
+  #attachments;
+  get attachments() {
+    return this.#attachments ??= new ReceivedAttachmentsResource(this._client, this._b);
+  }
+  /**
+   * Delete a received email
+   *
+   * Soft delete: it disappears from every list at once; retention purges the stored message later.
+   *
+   * @param id - Received email id.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `id` is not a uuid.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.delete` on every mailbox.
+   * @throws {NotFoundError} 404 NOT_FOUND: No such email in this workspace (or it was already deleted).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/received/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-received-id
+   * @example
+   * ```ts
+   * await mail.received.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(id, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/received/{id}", pathParams: { id } }, options);
+  }
+  /**
+   * Stream the filtered received email as CSV. Same filters as GET /received. Rate-limited 1 concurrent + 5/hour per workspace.
+   *
+   * Columns: id, received_at, mailbox, from, to (`; `-separated), subject, spam_verdict, spf, dkim, dmarc, size_bytes, attachments (count). No body content. A cell starting with `=`, `+`, `-` or `@` is prefixed with `'` so a spreadsheet does not run it as a formula. A rejected filter (400) does not count against the hourly cap, which is separate from the sent-email export's.
+   *
+   * @param params - `Mail.ReceivedExportParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter or cursor: a malformed uuid, boolean or date-time, `q` over 200 characters, `received_after` not earlier than `received_before`, or a window wider than 30 days. The reason is in `message`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.list` on every mailbox, or Mail is not enabled for this workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: Another received-email export is already running, or this workspace has hit the hourly cap (5). Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/received/export
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-received-export
+   * @example
+   * ```ts
+   * const response = await mail.received.export();
+   * const text = await response.text();
+   * ```
+   */
+  export(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/received/export", query: params, raw: true }, options);
+  }
+  /**
+   * List received email across every mailbox in the workspace
+   *
+   * Newest first, cursor-paged, deleted email excluded. Filters combine with AND: `q` (sender, subject, envelope recipient or To address as a substring; or an exact id or Message-ID), `mailbox_id`, `domain_id`, `received_after` / `received_before` (at most 30 days apart), `spam`, `unread`. `GET /received/export` takes exactly the same filters and returns the same rows. No body content.
+   *
+   * @param params - `Mail.ReceivedListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter or cursor: a malformed uuid, boolean or date-time, `q` over 200 characters, `received_after` not earlier than `received_before`, or a window wider than 30 days. The reason is in `message`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.list` on every mailbox, or Mail is not enabled for this workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/received
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-received
+   * @example
+   * ```ts
+   * for await (const received of mail.received.list()) {
+   *   console.log(received);
+   * }
+   * const page = await mail.received.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/received", query: params }, options);
+  }
+  /**
+   * Download the raw RFC 5322 message (.eml)
+   *
+   * Every header, the full body and every attachment inline. Gated by `mail.message.body.read` (admin and up by default), like `/mailboxes/{id}/messages/{mid}/raw`.
+   *
+   * @param id - Received email id.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `id` is not a uuid.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.message.body.read`.
+   * @throws {NotFoundError} 404 NOT_FOUND: No such email in this workspace (or it was deleted).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/received/{id}/raw
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-received-id-raw
+   * @example
+   * ```ts
+   * const response = await mail.received.raw("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * const text = await response.text();
+   * ```
+   */
+  raw(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/received/{id}/raw", pathParams: { id }, raw: true }, options);
+  }
+  /**
+   * Mark a received email as read
+   *
+   * @param id - Received email id.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `id` is not a uuid.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.read` on every mailbox.
+   * @throws {NotFoundError} 404 NOT_FOUND: No such email in this workspace (or it was deleted).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/received/{id}/read
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-received-id-read
+   * @example
+   * ```ts
+   * await mail.received.read("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  read(id, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/received/{id}/read", pathParams: { id } }, options);
+  }
+  /**
+   * Get one received email
+   *
+   * Metadata, the authentication results, the envelope recipient and the attachment manifest. `body_preview` is null without `mail.message.body.read`; the full message is at `/received/{id}/raw`.
+   *
+   * @param id - Received email id.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `id` is not a uuid.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The policy does not grant `mail.read` on every mailbox.
+   * @throws {NotFoundError} 404 NOT_FOUND: No such email in this workspace (or it was deleted).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/received/{id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-received-id
+   * @example
+   * ```ts
+   * const receivedEmailDetail = await mail.received.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(id, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/received/{id}", pathParams: { id } }, options);
+  }
+};
+var SegmentsContactsResource = class extends APIResource {
+  /**
+   * List a segment's contacts
+   *
+   * Newest contact first. For a rule segment, the contacts matching its rule right now.
+   *
+   * @param segmentId - Id of the segment.
+   * @param params - `Mail.SegmentContactListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: No such segment (`SEGMENT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/segments/{segment_id}/contacts
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-segments-segment-id-contacts
+   * @example
+   * ```ts
+   * for await (const contact of mail.segments.contacts.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b")) {
+   *   console.log(contact);
+   * }
+   * const page = await mail.segments.contacts.list("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", {}, { timeout: 5_000 });
+   * ```
+   */
+  list(segmentId, params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/segments/{segment_id}/contacts", pathParams: { segment_id: segmentId }, query: params }, options);
+  }
+};
+var SegmentsResource = class extends APIResource {
+  #contacts;
+  get contacts() {
+    return this.#contacts ??= new SegmentsContactsResource(this._client, this._b);
+  }
+  /**
+   * Create a segment
+   *
+   * Without `rule`, a static segment: add and remove contacts one at a time. With `rule`, a rule segment: its members are the contacts whose fields and properties match, evaluated every time it is read. At most 100 segments per workspace.
+   *
+   * @param params - `Mail.SegmentCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, SEGMENT_EXISTS, SEGMENT_LIMIT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: A segment with this name exists (`SEGMENT_EXISTS`), the workspace has 100 segments (`SEGMENT_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, INVALID_SEGMENT_RULE: The rule is invalid (`INVALID_SEGMENT_RULE`; `details.problems` lists each one with its condition index): an unknown field, `contains` on a number property, a missing or mistyped `value`, a `value` on `exists`.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/segments
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-segments
+   * @example
+   * ```ts
+   * const segment = await mail.segments.create({ name: "Pro customers" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/segments", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a segment
+   *
+   * Contacts are not touched; a static segment's member list goes with it.
+   *
+   * @param segmentId - Id of the segment.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: No such segment (`SEGMENT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/segments/{segment_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-segments-segment-id
+   * @example
+   * ```ts
+   * await mail.segments.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(segmentId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/segments/{segment_id}", pathParams: { segment_id: segmentId } }, options);
+  }
+  /**
+   * List segments, newest first
+   *
+   * @param params - `Mail.SegmentListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/segments
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-segments
+   * @example
+   * ```ts
+   * for await (const segment of mail.segments.list()) {
+   *   console.log(segment);
+   * }
+   * const page = await mail.segments.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/segments", query: params }, options);
+  }
+  /**
+   * A segment's size and unsubscribed share
+   *
+   * Counted on request.
+   *
+   * @param segmentId - Id of the segment.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: No such segment (`SEGMENT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/segments/{segment_id}/metrics
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-segments-segment-id-metrics
+   * @example
+   * ```ts
+   * const segmentMetrics = await mail.segments.metrics("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  metrics(segmentId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/segments/{segment_id}/metrics", pathParams: { segment_id: segmentId } }, options);
+  }
+  /**
+   * Preview a segment rule
+   *
+   * Counts the contacts a rule selects and returns the newest few, without saving anything.
+   *
+   * @param params - `Mail.SegmentPreviewParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, INVALID_SEGMENT_RULE: The rule is invalid (`INVALID_SEGMENT_RULE`; `details.problems` lists each one with its condition index): an unknown field, `contains` on a number property, a missing or mistyped `value`, a `value` on `exists`.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/segments/preview
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-segments-preview
+   * @example
+   * ```ts
+   * const segmentPreview = await mail.segments.preview({ rule: { conditions: [{ field: "plan", operator: "equals" }], match: "all" } });
+   * ```
+   */
+  preview(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/segments/preview", body: params }, options);
+  }
+  /**
+   * Get a segment
+   *
+   * @param segmentId - Id of the segment.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: No such segment (`SEGMENT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/segments/{segment_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-segments-segment-id
+   * @example
+   * ```ts
+   * const segment = await mail.segments.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(segmentId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/segments/{segment_id}", pathParams: { segment_id: segmentId } }, options);
+  }
+  /**
+   * Update a segment
+   *
+   * Rename it, or change a rule segment's rule. A segment's type (static or rule) is fixed.
+   *
+   * @param segmentId - Id of the segment.
+   * @param params - `Mail.SegmentUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, SEGMENT_NOT_FOUND: No such segment (`SEGMENT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, SEGMENT_EXISTS, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Another segment has this name (`SEGMENT_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, INVALID_SEGMENT_RULE, SEGMENT_TYPE_FIXED: The rule is invalid (`INVALID_SEGMENT_RULE`; `details.problems` lists each one with its condition index): an unknown field, `contains` on a number property, a missing or mistyped `value`, a `value` on `exists`. Or a rule on a static segment (`SEGMENT_TYPE_FIXED`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/segments/{segment_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-segments-segment-id
+   * @example
+   * ```ts
+   * const segment = await mail.segments.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { description: "string" });
+   * ```
+   */
+  update(segmentId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/segments/{segment_id}", pathParams: { segment_id: segmentId }, body: params, idempotent: true }, options);
+  }
+};
+var SendingDefaultsResource = class extends APIResource {
+  /**
+   * Get the workspace default sender
+   *
+   * The From used by template sends that name none, with the live verification status of its domain. `default_sender` is null when none is set.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/sending-defaults
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-sending-defaults
+   * @example
+   * ```ts
+   * const sendingDefaults = await mail.sendingDefaults.retrieve();
+   * ```
+   */
+  retrieve(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/sending-defaults" }, options);
+  }
+  /**
+   * Set or clear the workspace default sender
+   *
+   * Replaces the default sender (`address: null` clears it). The change applies to the next send of every product at once, and emits a `sending_defaults.updated` webhook event. Repeating the same request changes nothing, so it takes no `Idempotency-Key`.
+   *
+   * @param params - `Mail.SendingDefaultUpdateParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, sender_domain_not_in_workspace, INVALID_FROM_ADDRESS: `sender_domain_not_in_workspace` (`details: { fqdn }`): the address is not on a sending domain of this workspace (unknown, another workspace's, or receive-only). `INVALID_FROM_ADDRESS`: the address could not be parsed.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/sending-defaults
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-sending-defaults
+   * @example
+   * ```ts
+   * const sendingDefaults = await mail.sendingDefaults.update({ address: "Acme <hello@acme.com>" });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/sending-defaults", body: params }, options);
+  }
+};
+var SmtpConfigResource = class extends APIResource {
+  /**
+   * List every SMTP config in the workspace (default + per-domain overrides)
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/smtp-configs
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-smtp-configs
+   * @example
+   * ```ts
+   * const listSmtpConfigs = await mail.smtpConfig.list();
+   * ```
+   */
+  list(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/smtp-configs" }, options);
+  }
+  /**
+   * Revert the workspace to ProductCraft Mail's own sending
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: No SMTP config to delete
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-smtp-config
+   * @example
+   * ```ts
+   * await mail.smtpConfig.reset();
+   * ```
+   */
+  reset(options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/smtp-config" }, options);
+  }
+  /**
+   * Get the workspace-default SMTP config (returns null if unset). Per-domain overrides live under /workspaces/:id/domains/:domainId/smtp-config.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-smtp-config
+   * @example
+   * ```ts
+   * const getSmtpConfig = await mail.smtpConfig.retrieve();
+   * ```
+   */
+  retrieve(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/smtp-config" }, options);
+  }
+  /**
+   * Create or update the workspace-default SMTP config (resets verification)
+   *
+   * @param params - `Mail.SmtpConfigUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure or username/password mismatch.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PUT /v1/workspaces/{workspace_id}/smtp-config
+   * @see https://productcraft.co/docs/mail/api-reference#put-v1-workspaces-workspace-id-smtp-config
+   * @example
+   * ```ts
+   * const smtpConfig = await mail.smtpConfig.update({
+   *   from_email: "noreply@acme.com",
+   *   from_name: "Acme Notifications",
+   *   host: "smtp.sendgrid.net",
+   *   port: 587,
+   *   secure: false,
+   * });
+   * ```
+   */
+  update(params, options) {
+    return this._client.request({ method: "PUT", path: "/v1/workspaces/{workspace_id}/smtp-config", body: params, idempotent: true }, options);
+  }
+  /**
+   * Test arbitrary SMTP creds without persisting
+   *
+   * @param params - `Mail.SmtpConfigVerifyParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure on the request body.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/smtp-config/verify
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-smtp-config-verify
+   * @example
+   * ```ts
+   * const smtpVerifyResult = await mail.smtpConfig.verify({
+   *   from_email: "noreply@acme.com",
+   *   from_name: "Acme Notifications",
+   *   host: "smtp.sendgrid.net",
+   *   port: 587,
+   *   secure: false,
+   * });
+   * ```
+   */
+  verify(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/smtp-config/verify", body: params }, options);
+  }
+  /**
+   * Test the persisted workspace-default SMTP config; updates status
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: No SMTP config saved
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/smtp-config/verify-saved
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-smtp-config-verify-saved
+   * @example
+   * ```ts
+   * const smtpVerifyResult = await mail.smtpConfig.verifySaved();
+   * ```
+   */
+  verifySaved(options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/smtp-config/verify-saved" }, options);
+  }
+};
+var StatsResource = class extends APIResource {
+  /**
+   * Mail stats for a workspace
+   *
+   * Outbound sent, delivered, bounced, complained, deferred, suppressed and unconfirmed counts in the window, the deliverability, bounce and complaint rates, domain totals, the last send time and a daily sent series. For ranges, buckets, filters and a per-domain breakdown use `GET /emails/metrics`; the rates here use its definitions.
+   *
+   * `delivered` means the recipient's mail server confirmed the message; `unconfirmed` means the message was handed off and nothing came back either way, which is not the same as delivered. Days are UTC. Rates are 0 to 1, or null when not measured: delivery and complaints are only reported for mail with delivery tracking. Outbound messages are kept for 30 days, so 30d is the longest window. Cached for up to 60 seconds (`generated_at`).
+   *
+   * @param params - `Mail.StatsRetrieveParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `window` is not one of 1d, 7d, 30d.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN, SERVICE_NOT_ENABLED: Caller lacks `mail.message.read` on the workspace (including non-members), or Mail is not enabled on it (`SERVICE_NOT_ENABLED`).
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/stats
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-stats
+   * @example
+   * ```ts
+   * const mailWorkspaceStats = await mail.stats.retrieve();
+   * ```
+   */
+  retrieve(params, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/stats", query: params }, options);
+  }
+};
+var SuppressionResource = class extends APIResource {
+  /**
+   * Add an email to the workspace suppression list
+   *
+   * @param params - `Mail.SuppressionCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid payload (missing or malformed email).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Email address rejected as invalid by the service layer.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/suppression
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-suppression
+   * @example
+   * ```ts
+   * const suppressionEntry = await mail.suppression.create({ email: "bounced@example.com" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/suppression", body: params, idempotent: true }, options);
+  }
+  /**
+   * Remove an address from the workspace suppression list.
+   *
+   * @param email - The suppressed address (URL-encoded).
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Email is not on this workspace suppression list.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/suppression/{email}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-suppression-email
+   * @example
+   * ```ts
+   * await mail.suppression.delete("email");
+   * ```
+   */
+  delete(email, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/suppression/{email}", pathParams: { email } }, options);
+  }
+  /**
+   * List suppressed recipients in the workspace (most-recent first), cursor-paginated.
+   *
+   * @param params - `Mail.SuppressionListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor, search term, or source filter.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/suppression
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-suppression
+   * @example
+   * ```ts
+   * for await (const suppression of mail.suppression.list()) {
+   *   console.log(suppression);
+   * }
+   * const page = await mail.suppression.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/suppression", query: params }, options);
+  }
+};
+var TemplatesTagsResource = class extends APIResource {
+  /**
+   * Distinct tag list across all templates in this workspace (for autocomplete)
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/templates/tags
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-templates-tags
+   * @example
+   * ```ts
+   * const listTemplateTags = await mail.templates.tags.list();
+   * ```
+   */
+  list(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/templates/tags" }, options);
+  }
+};
+var TemplatesVariablesResource = class extends APIResource {
+  /**
+   * Variables auto-detected from the saved template body + subject (Handlebars expressions, dotted paths preserved, dedup'd in first-occurrence order).
+   *
+   * @param name - Name of the template.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/templates/{name}/variables
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-templates-name-variables
+   * @example
+   * ```ts
+   * const templateVariables = await mail.templates.variables.list("name");
+   * ```
+   */
+  list(name, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/templates/{name}/variables", pathParams: { name } }, options);
+  }
+};
+var TemplatesResource = class extends APIResource {
+  #tags;
+  #variables;
+  get tags() {
+    return this.#tags ??= new TemplatesTagsResource(this._client, this._b);
+  }
+  get variables() {
+    return this.#variables ??= new TemplatesVariablesResource(this._client, this._b);
+  }
+  /**
+   * Create or update a template, layout, or partial. Idempotent on (workspace_id, name); `kind` cannot change after the first upsert.
+   *
+   * @param params - `Mail.TemplateCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure (bad name / payload).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates
+   * @example
+   * ```ts
+   * const template = await mail.templates.create({ body_html: "string", name: "order-confirmation", subject: "string" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a template, layout, or partial by name.
+   *
+   * @param name - Name of the template.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/templates/{name}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-templates-name
+   * @example
+   * ```ts
+   * await mail.templates.delete("name");
+   * ```
+   */
+  delete(name, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/templates/{name}", pathParams: { name } }, options);
+  }
+  /**
+   * Lint a draft for deliverability red flags. Same render pipeline as /preview; returns a 0-100 score (higher is better) and a sorted list of findings (errors first). Self-developed heuristic linter, no external classifier — runs in-process.
+   *
+   * @param params - `Mail.TemplateLintParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Underlying render failed.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/lint
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-lint
+   * @example
+   * ```ts
+   * const lintResult = await mail.templates.lint({ body_html: "string" });
+   * ```
+   */
+  lint(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/lint", body: params }, options);
+  }
+  /**
+   * List templates / layouts / partials in a workspace, name-ascending and cursor-paginated. Filter via ?kind=template|layout|partial (default: all), ?tags=foo,bar (comma-separated), ?search=<substring of the name>.
+   *
+   * @param params - `Mail.TemplateListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid cursor or search term.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/templates
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-templates
+   * @example
+   * ```ts
+   * for await (const template of mail.templates.list()) {
+   *   console.log(template);
+   * }
+   * const page = await mail.templates.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/templates", query: params }, options);
+  }
+  /**
+   * Preview an unsaved draft. Renders subject + bodyHtml against the workspace brand tokens + supplied data, with all workspace layouts/partials registered. Used by the editor for live preview.
+   *
+   * @param params - `Mail.TemplatePreviewParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Render failed (compile or runtime error).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/preview
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-preview
+   * @example
+   * ```ts
+   * const renderedMessage = await mail.templates.preview({ body_html: "string" });
+   * ```
+   */
+  preview(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/preview", body: params }, options);
+  }
+  /**
+   * Render a saved template against a data payload. Returns subject + html + text without sending.
+   *
+   * @param name - Name of the template.
+   * @param params - `Mail.TemplateRenderParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT: Cannot render a layout/partial — only sendable templates.
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: Render or schema validation failed.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/{name}/render
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-name-render
+   * @example
+   * ```ts
+   * const renderedMessage = await mail.templates.render("name", { data: { name: "Alice", order_id: "ord_123" } });
+   * ```
+   */
+  render(name, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/{name}/render", pathParams: { name }, body: params }, options);
+  }
+  /**
+   * Get a template, layout, or partial by name.
+   *
+   * @param name - Name of the template.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/templates/{name}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-templates-name
+   * @example
+   * ```ts
+   * const template = await mail.templates.retrieve("name");
+   * ```
+   */
+  retrieve(name, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/templates/{name}", pathParams: { name } }, options);
+  }
+  /**
+   * Send a template-rendered message. Pass an `Idempotency-Key` header (1..256 chars, [A-Za-z0-9_\-:]) to make retries safe — replays return the original response with `Idempotent-Replay: true` for 24h. Same key + different request body returns 409 IDEMPOTENCY_KEY_REUSE.
+   *
+   * @param name - Name of the template.
+   * @param params - `Mail.TemplateSendParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure (malformed body or recipient).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: IDEMPOTENCY_KEY_REUSE — same key, different body. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, RECIPIENT_SUPPRESSED, TOPIC_NOT_FOUND, from_domain_not_verified, domain_not_verified_by_provider, no_default_sender: Recipient suppressed (`RECIPIENT_SUPPRESSED`; with a `topic_id`, or a template rendering `{{{unsubscribe_url}}}`, also when the recipient unsubscribed or never opted in: `details.reason` is `unsubscribe` or `no_consent`), `TOPIC_NOT_FOUND`, render failure, or invalid from address; or `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain of the From address is not itself an active sending domain of this workspace — `reason: not_registered` (unknown, registered to another workspace, or only a subdomain such as `mail.example.com` is verified; a verified subdomain does not cover its parent) or `reason: not_verified` (registered, DNS not verified yet). Refused before anything is recorded or queued; or `domain_not_verified_by_provider` (body `code`): the from-domain's DNS records have been broken for over 72 h (`health: failing`), so the email provider no longer sends for it; or `no_default_sender` (body `code`): the body has no `from` and the workspace has no default sender set (nothing is queued; an `email.skipped` webhook event is logged).
+   * @throws {RateLimitError} 429 RATE_LIMITED: Over a workspace send limit (60 per minute, 600 per hour, 10,000 per day): `RATE_LIMITED` with `details: { window, limit, retry_after }`. Nothing is recorded or queued. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/{name}/send
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-name-send
+   * @example
+   * ```ts
+   * const sendAccepted = await mail.templates.send("name", { data: { name: "Alice", order_id: "ord_123" }, to: "user@example.com" });
+   * ```
+   */
+  send(name, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/{name}/send", pathParams: { name }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Send up to 100 messages with the same template in one request. Per-row partial-success: each row carries its own status (`accepted` | `rejected`).
+   *
+   * Two ways to make retries safe. An `Idempotency-Key` header covers the whole request: a retry with the same key and body within 24 h returns the first response (with `Idempotent-Replay: true`) and sends nothing. A per-row `idempotency_key` covers one message: a later batch, or a `/send`, that repeats a row key replays that row instead of sending it again. Both share one dedupe namespace, so the header key must differ from every row key (400 otherwise).
+   *
+   * @param name - Name of the template.
+   * @param params - `Mail.TemplateSendBatchParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW: Validation failure (malformed body, batch too large), or the `Idempotency-Key` header equals a row `idempotency_key` (`IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different request body or on a different route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, from_domain_not_verified, domain_not_verified_by_provider: For any row: `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain of the From address is not itself an active sending domain of this workspace — `reason: not_registered` (unknown, registered to another workspace, or only a subdomain such as `mail.example.com` is verified; a verified subdomain does not cover its parent) or `reason: not_verified` (registered, DNS not verified yet). Refused before anything is recorded or queued (the whole batch is refused); or `domain_not_verified_by_provider` (body `code`): the from-domain's DNS records have been broken for over 72 h (`health: failing`), so the email provider no longer sends for it. The whole batch is refused; no row is sent.
+   * @throws {RateLimitError} 429 RATE_LIMITED: The workspace send limits (60 per minute, 600 per hour, 10,000 per day) never 429 a batch: a row over one is rejected in the 200 body with `RATE_LIMITED`, and the other rows are unaffected. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/{name}/send-batch
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-name-send-batch
+   * @example
+   * ```ts
+   * const sendBatchOpenApi = await mail.templates.sendBatch("name", {
+   *   messages: [
+   *     {
+   *       data: { code: "A1B2C3", name: "Alice" },
+   *       from: "Acme <noreply@acme.com>",
+   *       to: "alice@example.com",
+   *     },
+   *   ],
+   * });
+   * ```
+   */
+  sendBatch(name, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/{name}/send-batch", pathParams: { name }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Send a test rendering of the template to an arbitrary recipient. Bypasses the suppression list and the ordinary send limits (test sends have their own: 30 per hour per workspace); subject is auto-prefixed with [TEST]; missing variables render as [varname] placeholders.
+   *
+   * @param name - Name of the template.
+   * @param params - `Mail.TemplateTestSendParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: From-address domain is not registered to this workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Template not found in this workspace.
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Cannot test-send a layout/partial, or `IDEMPOTENCY_KEY_REUSE`: the `Idempotency-Key` was already used with a different body or route. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY, from_domain_not_verified, domain_not_verified_by_provider: Invalid from address or render failure; or `from_domain_not_verified` (body `code`, `details: { fqdn, reason }`): the domain of the From address is not itself an active sending domain of this workspace — `reason: not_registered` (unknown, registered to another workspace, or only a subdomain such as `mail.example.com` is verified; a verified subdomain does not cover its parent) or `reason: not_verified` (registered, DNS not verified yet). Refused before anything is recorded or queued; or `domain_not_verified_by_provider` (body `code`): the from-domain's DNS records have been broken for over 72 h (`health: failing`), so the email provider no longer sends for it.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 30 test sends this hour in this workspace: `RATE_LIMITED` with `details: { window, limit, retry_after }`. Per-IP limit: more than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/templates/{name}/test-send
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-templates-name-test-send
+   * @example
+   * ```ts
+   * const sendAccepted = await mail.templates.testSend("name", { from: "Acme <hello@acme.com>", to: "ada@example.com" });
+   * ```
+   */
+  testSend(name, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/templates/{name}/test-send", pathParams: { name }, body: params, idempotent: true }, options);
+  }
+};
+var TopicsResource = class extends APIResource {
+  /**
+   * Create a topic
+   *
+   * Send on a topic with `topic_id` on a template send. Recipients manage their topics on the hosted unsubscribe page. At most 50 topics per workspace.
+   *
+   * @param params - `Mail.TopicCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, TOPIC_EXISTS, TOPIC_LIMIT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: A topic with this name exists (`TOPIC_EXISTS`), the workspace has 50 topics (`TOPIC_LIMIT`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/topics
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-topics
+   * @example
+   * ```ts
+   * const topic = await mail.topics.create({ default_subscription: "opt_in", name: "Product updates" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/topics", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a topic
+   *
+   * Also deletes every contact's choice for it. Sends naming it are refused afterwards (`TOPIC_NOT_FOUND`).
+   *
+   * @param topicId - Id of the topic.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TOPIC_NOT_FOUND: No such topic (`TOPIC_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/topics/{topic_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-topics-topic-id
+   * @example
+   * ```ts
+   * await mail.topics.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(topicId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/topics/{topic_id}", pathParams: { topic_id: topicId } }, options);
+  }
+  /**
+   * List topics, newest first
+   *
+   * @param params - `Mail.TopicListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/topics
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-topics
+   * @example
+   * ```ts
+   * for await (const topic of mail.topics.list()) {
+   *   console.log(topic);
+   * }
+   * const page = await mail.topics.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/topics", query: params }, options);
+  }
+  /**
+   * Get a topic
+   *
+   * @param topicId - Id of the topic.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TOPIC_NOT_FOUND: No such topic (`TOPIC_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/topics/{topic_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-topics-topic-id
+   * @example
+   * ```ts
+   * const topic = await mail.topics.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(topicId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/topics/{topic_id}", pathParams: { topic_id: topicId } }, options);
+  }
+  /**
+   * Update a topic
+   *
+   * `default_subscription` cannot change: flipping it would silently subscribe or unsubscribe everyone who never chose.
+   *
+   * @param topicId - Id of the topic.
+   * @param params - `Mail.TopicUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, TOPIC_NOT_FOUND: No such topic (`TOPIC_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, TOPIC_EXISTS, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Another topic has this name (`TOPIC_EXISTS`), or `IDEMPOTENCY_KEY_REUSE`. Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/topics/{topic_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-topics-topic-id
+   * @example
+   * ```ts
+   * const topic = await mail.topics.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { description: "string" });
+   * ```
+   */
+  update(topicId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/topics/{topic_id}", pathParams: { topic_id: topicId }, body: params, idempotent: true }, options);
+  }
+};
+var WebhooksAttemptsResource = class extends APIResource {
+  /**
+   * Delivery attempts across all of this workspace's webhook endpoints, newest first, cursor-paginated, optionally for one event or one endpoint. Includes status code, latency, response body (truncated to 1KB), and error if any.
+   *
+   * @param params - `Mail.WebhookAttemptListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid `limit`, `cursor`, `event_id` or `endpoint_id`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/attempts
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-attempts
+   * @example
+   * ```ts
+   * for await (const attempt of mail.webhooks.attempts.list()) {
+   *   console.log(attempt);
+   * }
+   * const page = await mail.webhooks.attempts.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/attempts", query: params }, options);
+  }
+};
+var WebhooksEndpointsResource = class extends APIResource {
+  /**
+   * Add a webhook endpoint. Returns its signing secret once.
+   *
+   * Deliveries are signed with the Standard Webhooks headers `webhook-id`, `webhook-timestamp` and `webhook-signature` (`v1,<base64 HMAC-SHA256 of "<id>.<timestamp>.<body>">`); the returned `whsec_…` secret works unchanged with any Standard Webhooks library. Failed deliveries are retried after 1 min, 5 min, 30 min, 2 h, 6 h and 24 h.
+   *
+   * @param params - `Mail.WebhookEndpointCreateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR, WEBHOOK_EVENT_TYPE_UNKNOWN: Validation failure: URL not https with a public host, or an unknown event type (`WEBHOOK_EVENT_TYPE_UNKNOWN`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {ConflictError} 409 CONFLICT, WEBHOOK_ENDPOINT_LIMIT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Already 10 endpoints (`WEBHOOK_ENDPOINT_LIMIT`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: The URL points at a private, loopback or internal address.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/webhooks/endpoints
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-webhooks-endpoints
+   * @example
+   * ```ts
+   * const webhookEndpointWithSecret = await mail.webhooks.endpoints.create({ url: "https://api.acme.com/webhooks" });
+   * ```
+   */
+  create(params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints", body: params, idempotent: true }, options);
+  }
+  /**
+   * Delete a webhook endpoint.
+   *
+   * Queued retries are dropped. Its past attempts stay in the event log until the events expire.
+   *
+   * @param endpointId - Id of the endpoint.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see DELETE /v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}
+   * @see https://productcraft.co/docs/mail/api-reference#delete-v1-workspaces-workspace-id-webhooks-endpoints-endpoint-id
+   * @example
+   * ```ts
+   * await mail.webhooks.endpoints.delete("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  delete(endpointId, options) {
+    return this._client.request({ method: "DELETE", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}", pathParams: { endpoint_id: endpointId } }, options);
+  }
+  /**
+   * List webhook endpoints, oldest first.
+   *
+   * At most 10, so this is always one page. Signing secrets are never returned here, only their last 4 characters.
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: The scope id in the path is malformed.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/endpoints
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-endpoints
+   * @example
+   * ```ts
+   * for await (const endpoint of mail.webhooks.endpoints.list()) {
+   *   console.log(endpoint);
+   * }
+   * ```
+   */
+  list(options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints" }, options);
+  }
+  /**
+   * Get one webhook endpoint (without its secret).
+   *
+   * The endpoint's URL, subscription, on/off state, failure streak and the last 4 characters of its signing secret. The full secret is only returned when the endpoint is created or its secret is rotated.
+   *
+   * @param endpointId - Id of the endpoint.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-endpoints-endpoint-id
+   * @example
+   * ```ts
+   * const webhookEndpoint = await mail.webhooks.endpoints.retrieve("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b");
+   * ```
+   */
+  retrieve(endpointId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}", pathParams: { endpoint_id: endpointId } }, options);
+  }
+  /**
+   * Rotate the signing secret. The new one is returned once.
+   *
+   * For `grace_hours` (default 24) the previous secret keeps signing too: `webhook-signature` then lists one `v1,` signature per secret, so receivers can switch over without dropping a delivery.
+   *
+   * @param endpointId - Id of the endpoint.
+   * @param params - `Mail.WebhookEndpointRotateSecretParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `grace_hours` out of range, or `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/rotate-secret
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-webhooks-endpoints-endpoint-id-rotate-secret
+   * @example
+   * ```ts
+   * const webhookEndpointWithSecret = await mail.webhooks.endpoints.rotateSecret("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { grace_hours: 24 });
+   * ```
+   */
+  rotateSecret(endpointId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/rotate-secret", pathParams: { endpoint_id: endpointId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Send a test event to this endpoint now and return the result.
+   *
+   * Delivers the catalogue example of `event_type`, signed like any delivery, with `"test": true` in the body. Works while the endpoint is switched off or not subscribed to that type, is logged in the event log, and is never retried or counted toward an automatic disable. Waits up to 15 s for your receiver.
+   *
+   * @param endpointId - Id of the endpoint.
+   * @param params - `Mail.WebhookEndpointTestParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Unknown `event_type`, or `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/test
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-webhooks-endpoints-endpoint-id-test
+   * @example
+   * ```ts
+   * const webhookDeliveryAttempt = await mail.webhooks.endpoints.test("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { event_type: "email.sent" });
+   * ```
+   */
+  test(endpointId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}/test", pathParams: { endpoint_id: endpointId }, body: params, idempotent: true }, options);
+  }
+  /**
+   * Change a webhook endpoint: URL, description, events, on/off.
+   *
+   * Only the fields sent change. `enabled: true` (or a new URL) also clears an automatic disable. Switching off cancels queued retries. The secret is unchanged; rotate it with `POST …/rotate-secret`.
+   *
+   * @param endpointId - Id of the endpoint.
+   * @param params - `Mail.WebhookEndpointUpdateParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Validation failure, or `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {UnprocessableEntityError} 422 UNPROCESSABLE_ENTITY: The new URL points at a private, loopback or internal address.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see PATCH /v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}
+   * @see https://productcraft.co/docs/mail/api-reference#patch-v1-workspaces-workspace-id-webhooks-endpoints-endpoint-id
+   * @example
+   * ```ts
+   * const webhookEndpoint = await mail.webhooks.endpoints.update("3f0c1a2b-4c5d-4e6f-8a9b-0c1d2e3f4a5b", { description: "Production receiver" });
+   * ```
+   */
+  update(endpointId, params, options) {
+    return this._client.request({ method: "PATCH", path: "/v1/workspaces/{workspace_id}/webhooks/endpoints/{endpoint_id}", pathParams: { endpoint_id: endpointId }, body: params, idempotent: true }, options);
+  }
+};
+var WebhooksEventTypesResource = class extends APIResource {
+  /**
+   * List the events an endpoint can subscribe to.
+   *
+   * Each type with a plain description, its group and an example `data` object (what "Send test" delivers).
+   *
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: A resource id in the path is not a UUID, or the request failed validation (`BAD_REQUEST` / `VALIDATION_ERROR`).
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/event-types
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-event-types
+   * @example
+   * ```ts
+   * const listWebhookEventTypes = await mail.webhooks.eventTypes.list();
+   * ```
+   */
+  list(options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/event-types" }, options);
+  }
+};
+var WebhooksEventsResource = class extends APIResource {
+  /**
+   * List webhook events, newest first (kept for 30 days).
+   *
+   * Every event logged while at least one endpoint existed, with the latest state per endpoint and when the next retry is due.
+   *
+   * @param params - `Mail.WebhookEventListParams`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: Invalid filter value or cursor.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND: Workspace not found: no workspace has this `workspaceId`, or it is not a UUID (`NOT_FOUND`). A workspace the caller is not a member of answers 403. Routes that read a resource also answer 404 when the resource is missing.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/events
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-events
+   * @example
+   * ```ts
+   * for await (const event of mail.webhooks.events.list()) {
+   *   console.log(event);
+   * }
+   * const page = await mail.webhooks.events.list({}, { timeout: 5_000 });
+   * ```
+   */
+  list(params, options) {
+    return this._client.list({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/events", query: params }, options);
+  }
+  /**
+   * Send a logged event again, to its endpoints or to one endpoint.
+   *
+   * Same body and `webhook-id`, freshly signed, to every switched-on endpoint that receives this event type now, or only to `endpoint_id`. Waits for the receivers (up to 15 s each) and returns the attempts. A success cancels a retry still queued for that endpoint.
+   *
+   * @param eventId - The event id, `evt_<uuid>`.
+   * @param params - `Mail.WebhookEventReplayParams`.
+   * @param options - Per-request options (an Idempotency-Key is sent automatically; override with `idempotencyKey`).
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `event_id` is not `evt_<uuid>`, or `endpoint_id` is not a UUID.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_EVENT_NOT_FOUND, WEBHOOK_ENDPOINT_NOT_FOUND: No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days. Or No such endpoint here (`WEBHOOK_ENDPOINT_NOT_FOUND`).
+   * @throws {ConflictError} 409 CONFLICT, WEBHOOK_ENDPOINT_NOT_SUBSCRIBED, IDEMPOTENCY_KEY_REUSE, IDEMPOTENCY_IN_PROGRESS: `endpoint_id` is switched off or does not receive this event type (`WEBHOOK_ENDPOINT_NOT_SUBSCRIBED`), or Idempotency-Key reused with a different body (`IDEMPOTENCY_KEY_REUSE`). Idempotency: `IDEMPOTENCY_KEY_REUSE` when this `Idempotency-Key` was already used with a different body or route; `IDEMPOTENCY_IN_PROGRESS` while another request with the same key is still running (retry after `Retry-After` seconds, with the same key).
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see POST /v1/workspaces/{workspace_id}/webhooks/events/{event_id}/replay
+   * @see https://productcraft.co/docs/mail/api-reference#post-v1-workspaces-workspace-id-webhooks-events-event-id-replay
+   * @example
+   * ```ts
+   * const replayWebhookEvent = await mail.webhooks.events.replay("event");
+   * ```
+   */
+  replay(eventId, params, options) {
+    return this._client.request({ method: "POST", path: "/v1/workspaces/{workspace_id}/webhooks/events/{event_id}/replay", pathParams: { event_id: eventId }, query: params, idempotent: true }, options);
+  }
+  /**
+   * Get one webhook event with every delivery attempt.
+   *
+   * The event as it was sent (`type`, `data`) and every delivery attempt to every endpoint, with its trigger, HTTP status, error and the start of the response body. Use it to debug a receiver, then `replay` to send it again.
+   *
+   * @param eventId - The event id, `evt_<uuid>`.
+   * @param options - Per-request options.
+   * @throws {BadRequestError} 400 BAD_REQUEST, VALIDATION_ERROR: `event_id` is not `evt_<uuid>`.
+   * @throws {AuthenticationError} 401 UNAUTHORIZED: Missing, expired or invalid bearer token.
+   * @throws {PermissionDeniedError} 403 FORBIDDEN: The caller lacks the action this route requires on the resource, or Mail is not enabled for the workspace.
+   * @throws {NotFoundError} 404 NOT_FOUND, WEBHOOK_EVENT_NOT_FOUND: No such event here (`WEBHOOK_EVENT_NOT_FOUND`); events are kept for 30 days.
+   * @throws {RateLimitError} 429 RATE_LIMITED: More than 20 requests per second or 600 per minute from this client IP (`RATE_LIMITED`); wait `Retry-After` seconds.
+   * @see GET /v1/workspaces/{workspace_id}/webhooks/events/{event_id}
+   * @see https://productcraft.co/docs/mail/api-reference#get-v1-workspaces-workspace-id-webhooks-events-event-id
+   * @example
+   * ```ts
+   * const webhookEventDetail = await mail.webhooks.events.retrieve("event");
+   * ```
+   */
+  retrieve(eventId, options) {
+    return this._client.request({ method: "GET", path: "/v1/workspaces/{workspace_id}/webhooks/events/{event_id}", pathParams: { event_id: eventId } }, options);
+  }
+};
+var WebhooksResource = class extends APIResource {
+  #attempts;
+  #endpoints;
+  #eventTypes;
+  #events;
+  get attempts() {
+    return this.#attempts ??= new WebhooksAttemptsResource(this._client, this._b);
+  }
+  get endpoints() {
+    return this.#endpoints ??= new WebhooksEndpointsResource(this._client, this._b);
+  }
+  get eventTypes() {
+    return this.#eventTypes ??= new WebhooksEventTypesResource(this._client, this._b);
+  }
+  get events() {
+    return this.#events ??= new WebhooksEventsResource(this._client, this._b);
+  }
+  /**
+   * Verify a webhook's signature and parse it (Standard Webhooks, and the legacy `t=…,v1=…` scheme).
+   *
+   * @param params - The raw body, the request headers and optionally the secret.
+   * @throws {WebhookVerificationError} The signature, timestamp or payload is invalid.
+   * @throws {ConfigurationError} No secret was passed or configured.
+   */
+  unwrap(params) {
+    return this._client.unwrapWebhook(params, "PRODUCTCRAFT_MAIL_WEBHOOK_SECRET");
+  }
+};
+var MailResources = class extends APIResource {
+  #brand;
+  #broadcasts;
+  #contacts;
+  #deliverability;
+  #domains;
+  #emails;
+  #integrations;
+  #mailboxes;
+  #messages;
+  #received;
+  #segments;
+  #sendingDefaults;
+  #smtpConfig;
+  #stats;
+  #suppression;
+  #templates;
+  #topics;
+  #webhooks;
+  get brand() {
+    return this.#brand ??= new BrandResource(this._client, this._b);
+  }
+  get broadcasts() {
+    return this.#broadcasts ??= new BroadcastsResource(this._client, this._b);
+  }
+  get contacts() {
+    return this.#contacts ??= new ContactsResource(this._client, this._b);
+  }
+  get deliverability() {
+    return this.#deliverability ??= new DeliverabilityResource(this._client, this._b);
+  }
+  get domains() {
+    return this.#domains ??= new DomainsResource(this._client, this._b);
+  }
+  get emails() {
+    return this.#emails ??= new EmailsResource(this._client, this._b);
+  }
+  get integrations() {
+    return this.#integrations ??= new IntegrationsResource(this._client, this._b);
+  }
+  get mailboxes() {
+    return this.#mailboxes ??= new MailboxesResource(this._client, this._b);
+  }
+  get messages() {
+    return this.#messages ??= new MessagesResource(this._client, this._b);
+  }
+  get received() {
+    return this.#received ??= new ReceivedResource(this._client, this._b);
+  }
+  get segments() {
+    return this.#segments ??= new SegmentsResource(this._client, this._b);
+  }
+  get sendingDefaults() {
+    return this.#sendingDefaults ??= new SendingDefaultsResource(this._client, this._b);
+  }
+  get smtpConfig() {
+    return this.#smtpConfig ??= new SmtpConfigResource(this._client, this._b);
+  }
+  get stats() {
+    return this.#stats ??= new StatsResource(this._client, this._b);
+  }
+  get suppression() {
+    return this.#suppression ??= new SuppressionResource(this._client, this._b);
+  }
+  get templates() {
+    return this.#templates ??= new TemplatesResource(this._client, this._b);
+  }
+  get topics() {
+    return this.#topics ??= new TopicsResource(this._client, this._b);
+  }
+  get webhooks() {
+    return this.#webhooks ??= new WebhooksResource(this._client, this._b);
+  }
+};
+
+// src/_generated/types.ts
+var BounceSource = { values: ["relay", "ses", "mixed", "none"] };
+var BounceType = { values: ["Permanent", "Transient", "Undetermined"] };
+var BroadcastRecipientStatus = { values: ["pending", "sending", "sent", "skipped", "failed", "canceled"] };
+var BroadcastStatus = { values: ["draft", "scheduled", "sending", "sent", "canceled"] };
+var ContactCreatedVia = { values: ["api", "dashboard", "import", "unsubscribe"] };
+var ContactImportConflictMode = { values: ["upsert", "skip"] };
+var ContactImportStatus = { values: ["queued", "processing", "completed", "failed"] };
+var ContactPropertyType = { values: ["string", "number"] };
+var DeliverabilityVerdict = { values: ["no_data", "healthy", "unconfirmed", "degraded", "blocked"] };
+var DmarcAlignmentMode = { values: ["r", "s"] };
+var DmarcPolicy = { values: ["none", "quarantine", "reject"] };
+var DmarcRecordLocation = { values: ["subdomain", "organizational", "none"] };
+var DnsApplyAction = { values: ["create", "update", "skip"] };
+var DnsApplyProvider = { values: ["cloudflare", "digitalocean"] };
+var DnsApplyRecordResult = { values: ["created", "updated", "unchanged", "failed"] };
+var DnsApplyWarning = { values: ["token_scope_broader_than_zone", "dmarc_lookup_failed", "partially_applied"] };
+var DnsConflictCode = { values: ["spf_multiple", "spf_merge", "spf_lookup_limit", "cname_at_host", "mail_from_mx_multiple", "dmarc_duplicate", "dkim_selector_taken", "mx_foreign"] };
+var DnsConflictSeverity = { values: ["blocking", "warning"] };
+var DnsProviderId = { values: ["cloudflare", "digitalocean", "namecheap", "godaddy", "squarespace", "route53", "porkbun", "vercel", "netlify", "gandi", "hover", "other"] };
+var DnsProviderLookupSource = { values: ["ns", "domain_connect"] };
+var DnsProviderSource = { values: ["user", "detected"] };
+var DnsRecordPurpose = { values: ["dkim", "mx", "verification", "spf", "mail_from_mx", "mail_from_spf", "dmarc"] };
+var DnsRecordState = { values: ["missing", "mismatch", "conflict", "propagating", "verified"] };
+var DnsRecordType = { values: ["TXT", "MX"] };
+var DomainCapabilityState = { values: ["enabled", "disabled"] };
+var DomainConnectUnavailableReason = { values: ["no_record", "settings_unreachable", "template_not_onboarded", "lookup_failed", "disabled"] };
+var DomainEventType = { values: ["added", "records_found", "verified", "degraded", "failing", "recovered", "mail_from_verified", "dmarc_detected", "check_failed", "deleted"] };
+var DomainHealth = { values: ["ok", "degraded", "failing"] };
+var DomainIntent = { values: ["receive", "send", "both"] };
+var DomainRecordKind = { values: ["DKIM", "SPF", "MX", "DMARC", "Verification"] };
+var DomainRecordStatus = { values: ["not_started", "pending", "verified", "failed", "temporary_failure"] };
+var DomainSetupMethod = { values: ["manual", "domain_connect", "provider_api"] };
+var DomainStatus = { values: ["pending", "active", "disabled"] };
+var DomainTlsMode = { values: ["opportunistic"] };
+var DomainVerificationStatus = { values: ["not_started", "pending", "partially_verified", "verified", "temporary_failure", "failed", "disabled"] };
+var EmailMetricsGranularity = { values: ["hourly", "daily"] };
+var EmailMetricsObject = { values: ["metrics"] };
+var IntegrationStatus = { values: ["active", "error", "revoked"] };
+var IntegrationSyncState = { values: ["running", "completed", "failed"] };
+var LintSeverity = { values: ["error", "warn", "info"] };
+var MailboxStatus = { values: ["active", "disabled"] };
+var MessageEventType = { values: ["queued", "sent", "delivered", "deferred", "bounced", "complained", "failed", "suppressed"] };
+var MessageSource = { values: ["api_key", "dashboard", "platform", "test_send"] };
+var MessageStatus = { values: ["queued", "sent", "delivered", "bounced", "complained", "failed", "suppressed", "deferred"] };
+var MessageTransport = { values: ["smtp", "ses"] };
+var SegmentMatch = { values: ["all", "any"] };
+var SegmentOperator = { values: ["equals", "contains", "exists"] };
+var SegmentType = { values: ["static", "rule"] };
+var SendBatchRowState = { values: ["accepted", "rejected"] };
+var SenderDomainStatus = { values: ["not_started", "pending", "partially_verified", "verified", "temporary_failure", "failed", "disabled", "deleted", "not_found"] };
+var SesDkimStatus = { values: ["PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE", "NOT_STARTED", "not_enabled"] };
+var SesMailFromStatus = { values: ["PENDING", "SUCCESS", "FAILED", "TEMPORARY_FAILURE"] };
+var ShareLinkStatus = { values: ["active", "expired", "revoked"] };
+var SmtpConfigStatus = { values: ["pending", "active", "failed"] };
+var SpamVerdict = { values: ["ham", "junk", "reject"] };
+var StatsGranularity = { values: ["day"] };
+var StatsSeriesMetric = { values: ["sent"] };
+var StatsWindow = { values: ["1d", "7d", "30d"] };
+var Subscription = { values: ["opt_in", "opt_out"] };
+var SubscriptionReason = { values: ["opted_in", "default_with_consent", "unsubscribed", "opted_out", "no_consent", "not_opted_in"] };
+var SuppressionSource = { values: ["manual", "bounce", "complaint"] };
+var TemplateKind = { values: ["template", "layout", "partial"] };
+var TemplateSource = { values: ["manual", "github"] };
+var TimelineMetric = { values: ["sent", "bounced"] };
+var TopicVisibility = { values: ["public", "private"] };
+var WebhookAttemptTrigger = { values: ["automatic", "replay", "test"] };
+var WebhookEndpointDisabledReason = { values: ["manual", "failing"] };
+var WebhookEndpointLegacySlot = { values: ["default", "domain"] };
+var WebhookEndpointStatus = { values: ["enabled", "disabled", "auto_disabled"] };
+var WebhookEventStatus = { values: ["pending", "delivered", "failed", "not_sent"] };
+var WebhookEventType = { values: ["email.sent", "email.delivered", "email.delivery_delayed", "email.bounced", "email.complained", "email.failed", "email.suppressed", "email.skipped", "email.scheduled", "email.canceled", "email.opened", "email.clicked", "email.received", "domain.created", "domain.updated", "domain.verified", "domain.deleted", "suppression.added", "suppression.removed", "sending_defaults.updated", "contact.created", "contact.updated", "contact.deleted"] };
+
+// src/_generated/client.ts
+var VERSION = "1.0.0" ;
+exports.default = class Mail extends MailResources {
+  #openapi;
+  constructor(options = {}) {
+    super(new core.APIClient(options, core.PC_BASE_URL.mail, { name: "mail", version: VERSION }));
+  }
+  /** The typed `openapi-fetch` escape hatch over the same credential and base URL. It does not retry. */
+  get client() {
+    return this.#openapi ??= core.createOpenAPIClient(this._client);
   }
 };
+((Mail2) => {
+  Mail2.BounceSource = BounceSource;
+  Mail2.BounceType = BounceType;
+  Mail2.BroadcastRecipientStatus = BroadcastRecipientStatus;
+  Mail2.BroadcastStatus = BroadcastStatus;
+  Mail2.ContactCreatedVia = ContactCreatedVia;
+  Mail2.ContactImportConflictMode = ContactImportConflictMode;
+  Mail2.ContactImportStatus = ContactImportStatus;
+  Mail2.ContactPropertyType = ContactPropertyType;
+  Mail2.DeliverabilityVerdict = DeliverabilityVerdict;
+  Mail2.DmarcAlignmentMode = DmarcAlignmentMode;
+  Mail2.DmarcPolicy = DmarcPolicy;
+  Mail2.DmarcRecordLocation = DmarcRecordLocation;
+  Mail2.DnsApplyAction = DnsApplyAction;
+  Mail2.DnsApplyProvider = DnsApplyProvider;
+  Mail2.DnsApplyRecordResult = DnsApplyRecordResult;
+  Mail2.DnsApplyWarning = DnsApplyWarning;
+  Mail2.DnsConflictCode = DnsConflictCode;
+  Mail2.DnsConflictSeverity = DnsConflictSeverity;
+  Mail2.DnsProviderId = DnsProviderId;
+  Mail2.DnsProviderLookupSource = DnsProviderLookupSource;
+  Mail2.DnsProviderSource = DnsProviderSource;
+  Mail2.DnsRecordPurpose = DnsRecordPurpose;
+  Mail2.DnsRecordState = DnsRecordState;
+  Mail2.DnsRecordType = DnsRecordType;
+  Mail2.DomainCapabilityState = DomainCapabilityState;
+  Mail2.DomainConnectUnavailableReason = DomainConnectUnavailableReason;
+  Mail2.DomainEventType = DomainEventType;
+  Mail2.DomainHealth = DomainHealth;
+  Mail2.DomainIntent = DomainIntent;
+  Mail2.DomainRecordKind = DomainRecordKind;
+  Mail2.DomainRecordStatus = DomainRecordStatus;
+  Mail2.DomainSetupMethod = DomainSetupMethod;
+  Mail2.DomainStatus = DomainStatus;
+  Mail2.DomainTlsMode = DomainTlsMode;
+  Mail2.DomainVerificationStatus = DomainVerificationStatus;
+  Mail2.EmailMetricsGranularity = EmailMetricsGranularity;
+  Mail2.EmailMetricsObject = EmailMetricsObject;
+  Mail2.IntegrationStatus = IntegrationStatus;
+  Mail2.IntegrationSyncState = IntegrationSyncState;
+  Mail2.LintSeverity = LintSeverity;
+  Mail2.MailboxStatus = MailboxStatus;
+  Mail2.MessageEventType = MessageEventType;
+  Mail2.MessageSource = MessageSource;
+  Mail2.MessageStatus = MessageStatus;
+  Mail2.MessageTransport = MessageTransport;
+  Mail2.SegmentMatch = SegmentMatch;
+  Mail2.SegmentOperator = SegmentOperator;
+  Mail2.SegmentType = SegmentType;
+  Mail2.SendBatchRowState = SendBatchRowState;
+  Mail2.SenderDomainStatus = SenderDomainStatus;
+  Mail2.SesDkimStatus = SesDkimStatus;
+  Mail2.SesMailFromStatus = SesMailFromStatus;
+  Mail2.ShareLinkStatus = ShareLinkStatus;
+  Mail2.SmtpConfigStatus = SmtpConfigStatus;
+  Mail2.SpamVerdict = SpamVerdict;
+  Mail2.StatsGranularity = StatsGranularity;
+  Mail2.StatsSeriesMetric = StatsSeriesMetric;
+  Mail2.StatsWindow = StatsWindow;
+  Mail2.Subscription = Subscription;
+  Mail2.SubscriptionReason = SubscriptionReason;
+  Mail2.SuppressionSource = SuppressionSource;
+  Mail2.TemplateKind = TemplateKind;
+  Mail2.TemplateSource = TemplateSource;
+  Mail2.TimelineMetric = TimelineMetric;
+  Mail2.TopicVisibility = TopicVisibility;
+  Mail2.WebhookAttemptTrigger = WebhookAttemptTrigger;
+  Mail2.WebhookEndpointDisabledReason = WebhookEndpointDisabledReason;
+  Mail2.WebhookEndpointLegacySlot = WebhookEndpointLegacySlot;
+  Mail2.WebhookEndpointStatus = WebhookEndpointStatus;
+  Mail2.WebhookEventStatus = WebhookEventStatus;
+  Mail2.WebhookEventType = WebhookEventType;
+})(exports.default || (exports.default = {}));
+var MailErrorCode = { values: ["BAD_REQUEST", "VALIDATION_ERROR", "UNAUTHORIZED", "PAYMENT_REQUIRED", "FORBIDDEN", "NOT_FOUND", "METHOD_NOT_ALLOWED", "NOT_ACCEPTABLE", "REQUEST_TIMEOUT", "CONFLICT", "GONE", "PRECONDITION_FAILED", "PAYLOAD_TOO_LARGE", "UNSUPPORTED_MEDIA_TYPE", "UNPROCESSABLE_ENTITY", "PRECONDITION_REQUIRED", "RATE_LIMITED", "INTERNAL_SERVER_ERROR", "NOT_IMPLEMENTED", "BAD_GATEWAY", "SERVICE_UNAVAILABLE", "GATEWAY_TIMEOUT", "SERVICE_NOT_ENABLED", "INVALID_CREDENTIALS", "SESSION_REVOKED", "MCP_NOT_PERMITTED", "MCP_WORKSPACE_MISMATCH", "PAK_NOT_PERMITTED", "ACTIONS_NOT_GRANTABLE", "IDEMPOTENCY_KEY_REUSE", "IDEMPOTENCY_KEY_REQUIRED", "IDEMPOTENCY_IN_PROGRESS", "WEBHOOK_ENDPOINT_LIMIT", "WEBHOOK_ENDPOINT_NOT_FOUND", "WEBHOOK_ENDPOINT_NOT_SUBSCRIBED", "WEBHOOK_EVENT_NOT_FOUND", "WEBHOOK_EVENT_TYPE_UNKNOWN", "AUDIENCE_REQUIRED", "BROADCAST_AUDIENCE_EMPTY", "BROADCAST_CONTENT_CONFLICT", "BROADCAST_NOT_CANCELABLE", "BROADCAST_NOT_DELETABLE", "BROADCAST_NOT_DRAFT", "BROADCAST_NOT_FOUND", "BROADCAST_NOT_READY", "CAPABILITY_NOT_VERIFIED", "CONTACT_EXISTS", "CONTACT_LIMIT", "CONTACT_NOT_FOUND", "CONTACT_PROPERTY_EXISTS", "CONTACT_PROPERTY_LIMIT", "CONTACT_PROPERTY_NOT_FOUND", "DATE_RANGE_BEYOND_RETENTION", "DATE_RANGE_TOO_WIDE", "DATE_WINDOW_TOO_WIDE", "DKIM_KEY_MISSING", "DNS_CONFLICTS", "DOMAIN_CONNECT_DISABLED", "DOMAIN_CONNECT_MAIL_FROM_LABEL", "DOMAIN_CONNECT_NOT_SENDING", "DOMAIN_CONNECT_UNAVAILABLE", "DOMAIN_HAS_MAILBOXES", "DOMAIN_NOT_FOUND", "EMAIL_CONTENT_CONFLICT", "EMAIL_NOT_FOUND", "EMAIL_UNAVAILABLE", "FROM_DOMAIN_MISMATCH", "IDEMPOTENCY_KEY_CONFLICTS_WITH_ROW", "IMPORT_IN_PROGRESS", "IMPORT_NOT_FOUND", "IMPORT_TOO_LARGE", "INVALID_CAPABILITIES", "INVALID_CONTACT_PROPERTY_VALUE", "INVALID_CSV", "INVALID_DATE", "INVALID_DATE_RANGE", "INVALID_DATE_WINDOW", "INVALID_FORMAT", "INVALID_FROM_ADDRESS", "INVALID_SEGMENT_RULE", "INVALID_TIMEZONE", "INVALID_ZONE", "MAIL_FROM_HOST_IN_USE", "MAIL_FROM_NOT_SENDING", "MAIL_HEADER_NOT_ALLOWED", "PROVIDER_ERROR", "PROVIDER_PERMISSION_DENIED", "PROVIDER_TOKEN_REJECTED", "PROVIDER_UNAVAILABLE", "PROVIDER_ZONE_NOT_FOUND", "RECIPIENT_LIMIT", "RECIPIENT_SUPPRESSED", "REGION_NOT_AVAILABLE", "RESERVED_PROPERTY_KEY", "SEGMENT_EXISTS", "SEGMENT_LIMIT", "SEGMENT_NOT_FOUND", "SEGMENT_RULE_BASED", "SEGMENT_TYPE_FIXED", "SES_IDENTITY_DELETE_FAILED", "SHARE_LINK_NOT_FOUND", "SMTP_AUTH_PARTIAL", "SMTP_CONFIG_NOT_FOUND", "SMTP_PASSWORD_REQUIRED", "TEMPLATE_DATA_INVALID", "TEMPLATE_KIND_NOT_SENDABLE", "TEMPLATE_NOT_FOUND", "TEMPLATE_RENDER_FAILED", "TLS_ENFORCED_NOT_AVAILABLE", "TOPIC_EXISTS", "TOPIC_LIMIT", "TOPIC_NOT_FOUND", "TRACKING_NOT_AVAILABLE", "UNKNOWN_CONTACT_PROPERTY", "UNSUBSCRIBE_LINK_REQUIRED", "domain_not_verified_by_provider", "from_domain_not_verified", "no_default_sender", "sender_domain_not_in_workspace"] };
 
-exports.Mail = Mail;
+Object.defineProperty(exports, "APIConnectionError", {
+  enumerable: true,
+  get: function () { return core.APIConnectionError; }
+});
+Object.defineProperty(exports, "APIError", {
+  enumerable: true,
+  get: function () { return core.APIError; }
+});
+Object.defineProperty(exports, "APITimeoutError", {
+  enumerable: true,
+  get: function () { return core.APITimeoutError; }
+});
+Object.defineProperty(exports, "APIUserAbortError", {
+  enumerable: true,
+  get: function () { return core.APIUserAbortError; }
+});
+Object.defineProperty(exports, "AuthenticationError", {
+  enumerable: true,
+  get: function () { return core.AuthenticationError; }
+});
+Object.defineProperty(exports, "BadRequestError", {
+  enumerable: true,
+  get: function () { return core.BadRequestError; }
+});
+Object.defineProperty(exports, "ConfigurationError", {
+  enumerable: true,
+  get: function () { return core.ConfigurationError; }
+});
+Object.defineProperty(exports, "ConflictError", {
+  enumerable: true,
+  get: function () { return core.ConflictError; }
+});
+Object.defineProperty(exports, "IdempotencyKeyReuseError", {
+  enumerable: true,
+  get: function () { return core.IdempotencyKeyReuseError; }
+});
+Object.defineProperty(exports, "InternalServerError", {
+  enumerable: true,
+  get: function () { return core.InternalServerError; }
+});
+Object.defineProperty(exports, "NotFoundError", {
+  enumerable: true,
+  get: function () { return core.NotFoundError; }
+});
+Object.defineProperty(exports, "PermissionDeniedError", {
+  enumerable: true,
+  get: function () { return core.PermissionDeniedError; }
+});
+Object.defineProperty(exports, "ProductCraftError", {
+  enumerable: true,
+  get: function () { return core.ProductCraftError; }
+});
+Object.defineProperty(exports, "RateLimitError", {
+  enumerable: true,
+  get: function () { return core.RateLimitError; }
+});
+Object.defineProperty(exports, "UnprocessableEntityError", {
+  enumerable: true,
+  get: function () { return core.UnprocessableEntityError; }
+});
+Object.defineProperty(exports, "WebhookVerificationError", {
+  enumerable: true,
+  get: function () { return core.WebhookVerificationError; }
+});
+exports.Mail = exports.default;
+exports.MailErrorCode = MailErrorCode;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map