@messagebird/sdk 0.7.5 → 0.8.0

package/dist/index.d.mts

@@ -1406,6 +1406,283 @@ type EmailAddress = {
    */
   name?: string;
 };
+/**
+ * Partial update. `settings` changes apply immediately. Changes to `return_path`, `tracking`, or `dkim` on a verified capability are staged: the current configuration keeps serving until the new one's DNS records verify, then the change is promoted automatically and the old records are marked `deprecated`. The staged value is visible under `capabilities.*.pending` and can be replaced by submitting another change.
+ *
+ */
+type DomainUpdate = {
+  settings?: DomainSettings;
+  return_path?: DomainReturnPathConfig & unknown;
+  /**
+   * Set or change the tracking name part, or remove tracking by passing null. Removal requires `click_tracking` and `open_tracking` to be disabled first, and returns `409` otherwise. After removal, links in previously sent email keep resolving while the tracking records are reported as `deprecated`.
+   *
+   */
+  tracking?: DomainTrackingConfig | null;
+  dkim?: DomainDkimConfig & unknown;
+  inbound?: DomainInboundConfig & unknown;
+};
+/**
+ * Inbound (receiving) configuration. Enable inbound to receive email addressed to this domain: Bird returns MX records to publish, and once they verify, mail to any local-part at this domain is delivered as an inbound message and the `email.received` webhook fires. The capability is enabled on the domain's own registration, so use a dedicated subdomain (e.g. `inbound.acme.com`), never your apex — apex MX would capture your corporate mail.
+ *
+ */
+type DomainInboundConfig = {
+  /**
+   * Set `true` to enable receiving on this domain, `false` to disable it. Disabling tears receiving down and removes the MX records from `dns_records`; this is immediate in the normal case, and if a step needs retrying the capability clears as soon as teardown finishes.
+   *
+   */
+  enabled: boolean;
+};
+/**
+ * DKIM signing configuration.
+ */
+type DomainDkimConfig = {
+  /**
+   * How the DKIM public key is published in your DNS.
+   * - `txt` — you publish the DKIM public key as a TXT record. Key
+   * rotation requires updating the record.
+   * - `delegated` — preview, currently unavailable; supplying it returns
+   * `422`. When available, you publish a single CNAME and Bird hosts
+   * and rotates the key with no further DNS changes on your side.
+   *
+   */
+  mode?: "txt" | "delegated";
+};
+/**
+ * Tracking domain configuration for branded open and click tracking URLs. Provide only the name part; Bird adds the sending domain automatically. Defaults to `links` when omitted at creation. Tracked links are served over HTTPS once the tracking record verifies.
+ *
+ */
+type DomainTrackingConfig = {
+  /**
+   * Name part to use for branded open and click tracking URLs. For example, `links` on `mail.acme.com` becomes `links.mail.acme.com`.
+   *
+   */
+  name: string;
+};
+/**
+ * Return-path (bounce) domain configuration. The return-path domain receives bounce and complaint notifications for mail sent from this domain and is what mailbox providers check for SPF. Provide only the name part; Bird adds the sending domain automatically.
+ *
+ */
+type DomainReturnPathConfig = {
+  /**
+   * Name part to use for the return-path domain. For example, `send` on `mail.acme.com` becomes `send.mail.acme.com`. Defaults to `send` when omitted at creation.
+   *
+   */
+  name: string;
+};
+/**
+ * Per-domain behavior toggles. Changes apply immediately to new sends.
+ *
+ */
+type DomainSettings = {
+  /**
+   * Rewrite links in HTML email through your tracking domain to record clicks. You can enable this before your tracking domain has verified — it begins working once verification completes. A tracking domain must be configured; enabling it without one returns `409`.
+   *
+   */
+  click_tracking?: boolean;
+  /**
+   * Insert a tracking pixel in HTML email to record opens. You can enable this before your tracking domain has verified — it begins working once verification completes. A tracking domain must be configured; enabling it without one returns `409`.
+   *
+   */
+  open_tracking?: boolean;
+};
+type DomainCreate = {
+  /**
+   * The domain you will send from — the domain of your `from` addresses. Use a dedicated subdomain (e.g. `mail.acme.com`) rather than your registered domain so sending reputation stays separate from other services on the domain.
+   *
+   */
+  domain: string;
+  return_path?: DomainReturnPathConfig;
+  tracking?: DomainTrackingConfig;
+  dkim?: DomainDkimConfig;
+  settings?: DomainSettings;
+};
+type DnsRecord = {
+  type: "TXT" | "CNAME" | "MX";
+  /**
+   * The record name — the part you enter in your DNS provider's "Name" or "Host" field, relative to the DNS zone the record belongs in (your registered domain). For a sending domain `mail.acme.com` the DKIM record name is `bird1._domainkey.mail`, entered in the `acme.com` zone. `@` for records at the zone apex.
+   *
+   */
+  name: string;
+  /**
+   * The fully qualified hostname for this record (e.g. `bird1._domainkey.mail.acme.com`).
+   *
+   */
+  host: string;
+  value: string;
+  /**
+   * What this record is for.
+   * - `dkim` — signs outbound mail and proves domain ownership. - `return_path` — return-path (bounce) CNAME for sending. - `tracking` — branded open/click tracking CNAME (optional). - `dmarc` — advisory DMARC policy record. - `inbound_mx` — MX record routing mail to Bird for receiving. Always
+   * present wherever inbound is available, as a regional reference,
+   * regardless of whether receiving is enabled; publishing it does not
+   * enable receiving on its own — see `DomainUpdate.inbound`.
+   *
+   */
+  purpose: "dkim" | "return_path" | "tracking" | "inbound_mx" | "dmarc";
+  /**
+   * Lifecycle state of this record.
+   * - `active` — the record backs the domain's current configuration. - `pending` — the record belongs to a staged configuration change;
+   * publish it to complete the change.
+   * - `deprecated` — the record belonged to a previous configuration.
+   * Keep it in DNS until `safe_to_remove` is `true`; in-flight mail and
+   * previously sent tracked links may still resolve through it.
+   *
+   */
+  readonly state: "active" | "pending" | "deprecated";
+  /**
+   * Whether this record can be skipped. Optional records enable extra functionality (e.g. tracking) but are not required for sending.
+   *
+   */
+  readonly optional: boolean;
+  /**
+   * Verification status of this record's most recent DNS check.
+   * - `pending` — the record has not verified yet; publish it (or correct it)
+   * and it will verify on the next check.
+   * - `verified` — the most recent check matched the expected value. - `warning` — the record verified before and a recent check no longer
+   * matched, but it is still within the grace period. Sending is not yet
+   * affected; fix the record before the grace period ends to avoid it
+   * being blocked.
+   * - `failed` — the record verified before but later checks kept failing
+   * past the grace period; the configuration has regressed and needs
+   * attention.
+   *
+   */
+  readonly status: "pending" | "verified" | "warning" | "failed";
+  /**
+   * Human-readable detail for a failed check on this record — what was found in DNS and why it did not match. Null when the record is verified or not yet checked.
+   *
+   */
+  readonly error?: string | null;
+  /**
+   * Only set on `deprecated` records: `true` once the record is no longer referenced by in-flight mail or live tracked links and can be deleted from your DNS. Null on `active` and `pending` records.
+   *
+   */
+  readonly safe_to_remove?: boolean | null;
+};
+/**
+ * A staged configuration change awaiting DNS verification. The currently active configuration keeps serving until the staged one verifies, at which point it is promoted automatically. Submitting another change for the same capability replaces the staged value.
+ *
+ */
+type DomainCapabilityPending = {
+  /**
+   * Hostname the capability will use once the staged change verifies.
+   */
+  readonly domain: string;
+  /**
+   * Verification status of the staged change. `pending` — waiting for the DNS records to be detected. `failed` — the records resolved with wrong values; correct them or submit a different change. `temporary_failure` — DNS lookup failed transiently and will be retried.
+   *
+   */
+  readonly status: "pending" | "failed" | "temporary_failure";
+};
+type DomainCapability = {
+  /**
+   * Capability verification status.
+   * - `pending` — verification has not run, or is currently running. - `verified` — all DNS records for this capability resolved with the
+   * expected values.
+   * - `warning` — a record for this capability verified before and a recent
+   * check no longer matches, but it is still within the grace period.
+   * Sending is not yet affected; fix it before the grace period ends.
+   * - `failed` — DNS records resolved but at least one value is wrong.
+   * Update your DNS to recover.
+   * - `temporary_failure` — DNS lookup failed transiently. Verification is
+   * queued for retry; don't change DNS records yet.
+   * - `not_configured` — the capability is not set up on this domain
+   * (e.g. no tracking domain configured).
+   *
+   */
+  readonly status: "pending" | "verified" | "warning" | "failed" | "temporary_failure" | "not_configured";
+  /**
+   * Hostname this capability is configured with — the return-path domain, the tracking domain, or the domain where the DMARC policy was found. Null when not applicable or not configured.
+   *
+   */
+  readonly domain?: string | null;
+  pending?: DomainCapabilityPending;
+  /**
+   * Machine-readable reason code for a failed capability status. Only set when `status` is `failed`. Use this to display a specific message to users rather than a generic failure message.
+   * - `tracking_domain_in_use` — the link tracking subdomain is already claimed
+   * by another organization.
+   *
+   */
+  readonly reason?: string | null;
+};
+type DomainCapabilities = {
+  sending: DomainCapability & unknown;
+  return_path: DomainCapability & unknown;
+  dmarc: DomainCapability & unknown;
+  tracking: DomainCapability & unknown;
+  inbound?: DomainCapability & unknown;
+};
+/**
+ * Active DKIM signing configuration for the domain.
+ */
+type DomainDkim = {
+  /**
+   * How the DKIM public key is published in your DNS. `txt` — you publish the key as a TXT record. `delegated` — you publish a single CNAME and Bird hosts and rotates the key.
+   *
+   */
+  readonly mode: "txt" | "delegated";
+  /**
+   * DKIM selector used to sign mail from this domain.
+   */
+  readonly selector: string;
+  /**
+   * RSA key size in bits.
+   */
+  readonly key_size: number;
+};
+type Domain = {
+  readonly id: DomainId;
+  readonly workspace_id: WorkspaceId;
+  /**
+   * The sending domain name. Set at creation and immutable.
+   */
+  readonly domain: string;
+  /**
+   * The DNS provider hosting this domain's nameservers, so you know which provider's dashboard to manage the required DNS records in. Returns "other" when the provider has not been detected or is not recognized.
+   *
+   */
+  readonly vendor: "other" | "cloudflare" | "route53" | "godaddy" | "namecheap" | "google" | "azure" | "digitalocean" | "squarespace";
+  /**
+   * Domain ownership verification, proven by the DKIM record. Readiness to send or track is reported separately per capability under `capabilities.*.status`.
+   * - `pending` — the DKIM record has not been published yet. - `verified` — the DKIM record is in place; ownership is confirmed. - `failed` — a DKIM record exists but does not match the expected
+   * value (for example a stale record from an earlier setup), or a
+   * previously verified record was removed. Correct the record to
+   * recover.
+   * - `temporary_failure` — DNS resolution failed transiently (timeout,
+   * unreachable nameserver). Verification is queued for retry on a 72h
+   * cadence; customer should not edit DNS records before the retry runs.
+   * - `rejected` — the domain was refused for policy reasons and cannot be
+   * used for sending. Contact support if you believe this is an error.
+   *
+   */
+  readonly status: "pending" | "verified" | "failed" | "temporary_failure" | "rejected";
+  settings: DomainSettings;
+  readonly dkim: DomainDkim;
+  capabilities: DomainCapabilities;
+  /**
+   * The domain's DNS records and their individual verification state, returned in full on both the list and single-domain responses. This is the complete set to publish across DKIM, return-path, DMARC, tracking, and inbound; records for a staged change carry `state: pending`. Inbound MX records are always included as a regional reference, even while receiving is off (`capabilities.inbound.status` is `not_configured`) — their presence alone does not mean receiving is enabled (see `DomainUpdate.inbound`).
+   *
+   */
+  readonly dns_records: Array<DnsRecord>;
+  /**
+   * When Bird last checked this domain's DNS records, whether or not the outcome changed. Updated on every verification — your manual refresh and the periodic automatic re-checks alike. Null if the domain has never been checked.
+   *
+   */
+  readonly last_checked_at?: string | null;
+  /**
+   * When the domain's ownership was confirmed — the moment `status` became `verified` via the DKIM record. Unchanged by later re-checks while it stays verified. Null if the domain has never been verified.
+   *
+   */
+  readonly verified_at?: string | null;
+  /**
+   * When the domain was added.
+   */
+  readonly created_at: string;
+  /**
+   * When the domain's configuration was last changed (such as a settings or return-path change). Verification re-checks do not change this; see `last_checked_at` and `verified_at` for verification timing.
+   *
+   */
+  readonly updated_at: string;
+};
 type WhatsAppTemplateList = {
   /**
    * The templates available to your workspace.
@@ -3087,6 +3364,42 @@ type ListWhatsAppMessageEventsData = {
   };
   url: "/v1/whatsapp/messages/{message_id}/events";
 };
+type ListDomainsData = {
+  body?: never;
+  path?: never;
+  query?: {
+    /**
+     * Substring match against the domain name (case-insensitive).
+     */
+    name?: string;
+    /**
+     * Field to sort by.
+     */
+    sort?: "created_at" | "name";
+    /**
+     * Sort direction. Defaults to `desc` (newest/largest first).
+     *
+     */
+    order?: "asc" | "desc";
+    /**
+     * Maximum number of items to return per page.
+     */
+    limit?: number;
+    /**
+     * Cursor from the `next_cursor` field of a previous list response. Returns items immediately after the cursor position in the current sort order.
+     */
+    starting_after?: string;
+    /**
+     * Cursor from the `prev_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order.
+     */
+    ending_before?: string;
+    /**
+     * When true, the response includes a `total` field with the total number of items matching the request's filters across all pages.
+     */
+    include_total?: boolean;
+  };
+  url: "/v1/email/domains";
+};
 //#endregion
 //#region src/generated/core/auth.gen.d.ts
 type AuthToken = string | undefined;
@@ -3653,6 +3966,76 @@ declare class AudiencesResource extends Resource {
   removeContact(audienceId: string, contactId: string, options?: RequestOptions): APIPromise<void>;
 }
 //#endregion
+//#region src/resources/domains.d.ts
+/** Body for `bird.domains.create`. */
+type DomainCreateParams = DomainCreate;
+/**
+ * Body for `bird.domains.update` — a partial patch. Omit a field to leave it
+ * unchanged; send `tracking: null` to remove the tracking domain (both tracking
+ * toggles must be off first, else the API returns 409).
+ */
+type DomainUpdateParams = DomainUpdate;
+/** Filters and cursor params for `bird.domains.list`. */
+type DomainListQuery = NonNullable<ListDomainsData["query"]>;
+declare class DomainsResource extends Resource {
+  /**
+   * Register a sending domain. Returns it in `pending` with the `dns_records`
+   * to publish at your DNS provider; call `verify` once they are in place.
+   *
+   * @example Register a sending domain
+   * const domain = await bird.domains.create({ domain: "mail.acme.com" });
+   * console.log(domain.id, domain.status); // "dom_…", "pending"
+   */
+  create(params: DomainCreateParams, options?: RequestOptions): APIPromise<Domain>;
+  /**
+   * List the workspace's sending domains, newest first. `await` resolves the
+   * first page; `for await` walks every domain across pages.
+   *
+   * @example
+   * for await (const domain of bird.domains.list()) {
+   *   console.log(domain.id, domain.status);
+   * }
+   */
+  list(query?: DomainListQuery, options?: RequestOptions): PaginatedPromise<Domain>;
+  /**
+   * Fetch a single sending domain by id, with its DNS records and their
+   * per-record verification state.
+   *
+   * @example
+   * const domain = await bird.domains.get("dom_01krdgeqcxet5s7t44vh8rt9mg");
+   */
+  get(domainId: string, options?: RequestOptions): APIPromise<Domain>;
+  /**
+   * Update a sending domain. Only the fields you send change; `settings` apply
+   * immediately, while `return_path`/`tracking`/`dkim` changes are staged until
+   * their new DNS records verify.
+   *
+   * @example
+   * await bird.domains.update("dom_01krdgeqcxet5s7t44vh8rt9mg", {
+   *   settings: { click_tracking: true, open_tracking: true },
+   *   tracking: { name: "links" },
+   * });
+   */
+  update(domainId: string, params: DomainUpdateParams, options?: RequestOptions): APIPromise<Domain>;
+  /**
+   * Delete a sending domain. Mail already accepted still sends; you can no
+   * longer send new mail from it.
+   *
+   * @example
+   * await bird.domains.delete("dom_01krdgeqcxet5s7t44vh8rt9mg");
+   */
+  delete(domainId: string, options?: RequestOptions): APIPromise<void>;
+  /**
+   * Trigger a fresh DNS check and return the refreshed domain with per-record
+   * results. Safe to repeat while waiting for DNS to propagate.
+   *
+   * @example
+   * const domain = await bird.domains.verify("dom_01krdgeqcxet5s7t44vh8rt9mg");
+   * console.log(domain.status); // "verified" once DNS is in place
+   */
+  verify(domainId: string, options?: RequestOptions): APIPromise<Domain>;
+}
+//#endregion
 //#region src/resources/contactProperties.d.ts
 /** Body for `bird.contactProperties.create`. */
 type ContactPropertyCreateParams = ContactPropertyCreateRequest;
@@ -4128,6 +4511,8 @@ declare class BirdClient<const O extends BirdClientOptions = BirdClientOptions>
   readonly audiences: AudiencesResource;
   /** Contact properties — `bird.contactProperties.create(...)`, `.list(...)`, `.archive(...)`, … */
   readonly contactProperties: ContactPropertiesResource;
+  /** Sending domains — `bird.domains.create(...)`, `.list(...)`, `.verify(...)`, … */
+  readonly domains: DomainsResource;
   /** Webhooks — `bird.webhooks.unwrap(payload, headers)` verifies an inbound delivery. */
   readonly webhooks: WebhooksResource;
   constructor(options: O);
@@ -4199,5 +4584,5 @@ declare const WebhookEventType: {
 /** A known webhook event type value. */
 type WebhookEventTypeValue = (typeof WebhookEventType)[keyof typeof WebhookEventType];
 //#endregion
-export { type APIPromise, type Audience, type AudienceAddContactsParams, type AudienceContactsQuery, type AudienceCreateParams, type AudienceListQuery, type AudienceMember, type AudienceRemoveContactsParams, type AudienceUpdateParams, BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, type BirdClientOptions, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, type BirdRequest, type BirdResponse, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, type BirdWebhookEvent, BirdWebhookVerificationError, type Contact, type ContactBatchParams, type ContactCreateParams, type ContactListQuery, type ContactProperty, type ContactPropertyCreateParams, type ContactPropertyListQuery, type ContactPropertyUpdateParams, type ContactUpdateParams, type ContactUpsertResult, type CursorPage, type EmailChannelDefaults, type EmailListQuery, type EmailMessage, type EmailSendBatchParams, type EmailSendBatchResult, type EmailSendParams, type ErrorDetail, type ErrorNextAction, type PaginatedPromise, type RequestOptions, type SafeResult, type SmsListQuery, type SmsMessage, type SmsSendBatchParams, type SmsSendBatchResult, type SmsSendParams, type SmsTemplate, type SmsTemplateList, type SmsTemplateListQuery, type UnmetGate, type Verification, type VerificationCheckParams, type VerificationCheckResult, type VerificationCreateParams, WebhookEventType, type WebhookEventTypeValue, type WebhookHeaders, type WebhookOptions, type WhatsAppEventList, type WhatsAppMessage, type WhatsAppTemplate, type WhatsAppTemplateList, type WhatsappListEventsQuery, type WhatsappListQuery, type WhatsappSendParams, baseUrlForRegion, regionFromApiKey };
+export { type APIPromise, type Audience, type AudienceAddContactsParams, type AudienceContactsQuery, type AudienceCreateParams, type AudienceListQuery, type AudienceMember, type AudienceRemoveContactsParams, type AudienceUpdateParams, BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, type BirdClientOptions, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, type BirdRequest, type BirdResponse, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, type BirdWebhookEvent, BirdWebhookVerificationError, type Contact, type ContactBatchParams, type ContactCreateParams, type ContactListQuery, type ContactProperty, type ContactPropertyCreateParams, type ContactPropertyListQuery, type ContactPropertyUpdateParams, type ContactUpdateParams, type ContactUpsertResult, type CursorPage, type DnsRecord, type Domain, type DomainCapabilities, type DomainCreateParams, type DomainDkim, type DomainListQuery, type DomainUpdateParams, type EmailChannelDefaults, type EmailListQuery, type EmailMessage, type EmailSendBatchParams, type EmailSendBatchResult, type EmailSendParams, type ErrorDetail, type ErrorNextAction, type PaginatedPromise, type RequestOptions, type SafeResult, type SmsListQuery, type SmsMessage, type SmsSendBatchParams, type SmsSendBatchResult, type SmsSendParams, type SmsTemplate, type SmsTemplateList, type SmsTemplateListQuery, type UnmetGate, type Verification, type VerificationCheckParams, type VerificationCheckResult, type VerificationCreateParams, WebhookEventType, type WebhookEventTypeValue, type WebhookHeaders, type WebhookOptions, type WhatsAppEventList, type WhatsAppMessage, type WhatsAppTemplate, type WhatsAppTemplateList, type WhatsappListEventsQuery, type WhatsappListQuery, type WhatsappSendParams, baseUrlForRegion, regionFromApiKey };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1936,6 +1936,120 @@ const listWhatsAppTemplates = (options) => (options?.client ?? client).get({
 	url: "/v1/whatsapp/templates",
 	...options
 });
+/**
+* List sending domains
+*
+* Returns all sending domains for the current workspace, ordered by creation date descending.
+*/
+const listDomains = (options) => (options?.client ?? client).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains",
+	...options
+});
+/**
+* Add a sending domain
+*
+* Registers a new sending domain and returns the DNS records required for verification: a DKIM TXT record, a return-path CNAME (which also covers SPF — no separate SPF record is needed), a DMARC policy, and, when a tracking domain is configured, a tracking CNAME. The domain starts in `pending` status; records are checked automatically once published, or on demand via the verify endpoint.
+*
+*/
+const createDomain = (options) => (options.client ?? client).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
+* Delete a sending domain
+*
+* Removes the domain and revokes its sender authorization. New sends from a deleted domain are rejected. Historical statistics and events for past sends from this domain are preserved.
+*
+*/
+const deleteDomain = (options) => (options.client ?? client).delete({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains/{domain_id}",
+	...options
+});
+/**
+* Get a sending domain
+*
+* Returns the domain with current DNS verification status per record.
+*/
+const getDomain = (options) => (options.client ?? client).get({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains/{domain_id}",
+	...options
+});
+/**
+* Update a sending domain
+*
+* Updates settings and configuration on a sending domain. `settings` changes apply immediately. Changes to `return_path`, `tracking`, or `dkim` on a verified capability are staged: the current configuration keeps serving until the new one's DNS records verify, then the change is promoted automatically. Staged values are visible under `capabilities.*.pending`; the records to publish appear in `dns_records` with `state: pending`.
+*
+*/
+const updateDomain = (options) => (options.client ?? client).patch({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains/{domain_id}",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
+* Trigger domain verification
+*
+* Triggers an immediate DNS check and returns the updated verification result. Rate-limited to prevent DNS abuse (max 5 calls per domain per hour).
+*
+*/
+const verifyDomain = (options) => (options.client ?? client).post({
+	security: [{
+		scheme: "bearer",
+		type: "http"
+	}, {
+		in: "cookie",
+		name: "bird_session",
+		type: "apiKey"
+	}],
+	url: "/v1/email/domains/{domain_id}/verify",
+	...options
+});
 //#endregion
 //#region src/resources/base.ts
 var Resource = class {
@@ -2303,6 +2417,112 @@ var AudiencesResource = class extends Resource {
 	}
 };
 //#endregion
+//#region src/resources/domains.ts
+var DomainsResource = class extends Resource {
+	/**
+	* Register a sending domain. Returns it in `pending` with the `dns_records`
+	* to publish at your DNS provider; call `verify` once they are in place.
+	*
+	* @example Register a sending domain
+	* const domain = await bird.domains.create({ domain: "mail.acme.com" });
+	* console.log(domain.id, domain.status); // "dom_…", "pending"
+	*/
+	create(params, options) {
+		return this.call("POST", options, ({ signal, headers }) => createDomain({
+			client: this.client,
+			body: params,
+			headers,
+			signal
+		}));
+	}
+	/**
+	* List the workspace's sending domains, newest first. `await` resolves the
+	* first page; `for await` walks every domain across pages.
+	*
+	* @example
+	* for await (const domain of bird.domains.list()) {
+	*   console.log(domain.id, domain.status);
+	* }
+	*/
+	list(query, options) {
+		return this.paginated("GET", options, ({ signal, headers }, cursor) => listDomains({
+			client: this.client,
+			query: {
+				...query,
+				starting_after: cursor ?? query?.starting_after
+			},
+			headers,
+			signal
+		}));
+	}
+	/**
+	* Fetch a single sending domain by id, with its DNS records and their
+	* per-record verification state.
+	*
+	* @example
+	* const domain = await bird.domains.get("dom_01krdgeqcxet5s7t44vh8rt9mg");
+	*/
+	get(domainId, options) {
+		return this.call("GET", options, ({ signal, headers }) => getDomain({
+			client: this.client,
+			path: { domain_id: domainId },
+			headers,
+			signal
+		}));
+	}
+	/**
+	* Update a sending domain. Only the fields you send change; `settings` apply
+	* immediately, while `return_path`/`tracking`/`dkim` changes are staged until
+	* their new DNS records verify.
+	*
+	* @example
+	* await bird.domains.update("dom_01krdgeqcxet5s7t44vh8rt9mg", {
+	*   settings: { click_tracking: true, open_tracking: true },
+	*   tracking: { name: "links" },
+	* });
+	*/
+	update(domainId, params, options) {
+		return this.call("PATCH", options, ({ signal, headers }) => updateDomain({
+			client: this.client,
+			path: { domain_id: domainId },
+			body: params,
+			headers,
+			signal
+		}));
+	}
+	/**
+	* Delete a sending domain. Mail already accepted still sends; you can no
+	* longer send new mail from it.
+	*
+	* @example
+	* await bird.domains.delete("dom_01krdgeqcxet5s7t44vh8rt9mg");
+	*/
+	delete(domainId, options) {
+		return this.call("DELETE", options, ({ signal, headers }) => deleteDomain({
+			client: this.client,
+			path: { domain_id: domainId },
+			headers,
+			signal
+		}));
+	}
+	/**
+	* Trigger a fresh DNS check and return the refreshed domain with per-record
+	* results. Safe to repeat while waiting for DNS to propagate.
+	*
+	* @example
+	* const domain = await bird.domains.verify("dom_01krdgeqcxet5s7t44vh8rt9mg");
+	* console.log(domain.status); // "verified" once DNS is in place
+	*/
+	verify(domainId, options) {
+		return this.call("POST", options, ({ signal, headers }) => verifyDomain({
+			client: this.client,
+			path: { domain_id: domainId },
+			headers,
+			signal
+		}));
+	}
+};
+//#endregion
 //#region src/resources/contactProperties.ts
 var ContactPropertiesResource = class extends Resource {
 	/**
@@ -2922,6 +3142,8 @@ var BirdClient = class {
 	audiences;
 	/** Contact properties — `bird.contactProperties.create(...)`, `.list(...)`, `.archive(...)`, … */
 	contactProperties;
+	/** Sending domains — `bird.domains.create(...)`, `.list(...)`, `.verify(...)`, … */
+	domains;
 	/** Webhooks — `bird.webhooks.unwrap(payload, headers)` verifies an inbound delivery. */
 	webhooks;
 	constructor(options) {
@@ -2931,9 +3153,9 @@ var BirdClient = class {
 		this.#headers = {
 			...opts.defaultHeaders,
 			Authorization: `Bearer ${opts.apiKey}`,
-			"User-Agent": `bird-sdk-js/0.7.5`,
+			"User-Agent": `bird-sdk-js/0.8.0`,
 			"Bird-Surface": "sdk-js",
-			"Bird-Version": "0.7.5"
+			"Bird-Version": "0.8.0"
 		};
 		const caller = detectCaller();
 		if (caller) this.#headers["Bird-Caller"] = caller;
@@ -2955,6 +3177,7 @@ var BirdClient = class {
 		this.contacts = new ContactsResource(this.core, this.#client);
 		this.audiences = new AudiencesResource(this.core, this.#client);
 		this.contactProperties = new ContactPropertiesResource(this.core, this.#client);
+		this.domains = new DomainsResource(this.core, this.#client);
 		this.webhooks = new WebhooksResource(opts.webhooks);
 	}
 	/**