@messagebird/sdk 0.16.0 → 0.21.2

package/dist/index.mjs

@@ -1031,6 +1031,23 @@ var BirdHTTPClient = class {
 		this.defaults = defaults;
 	}
 	/**
+	* Resolve the credential headers an operation's security schemes require.
+	* Throws before the request when one is unconfigured, so a caller gets a named
+	* error instead of a 401.
+	*/
+	credentialHeaders(schemes, override) {
+		if (!schemes?.length) return {};
+		const out = {};
+		for (const scheme of schemes) {
+			const cred = this.defaults.credentials?.[scheme];
+			if (!cred) throw new Error(`Unknown credential scheme "${scheme}"`);
+			const value = override?.[scheme] ?? cred.value;
+			if (!value) throw new Error(`${cred.header} is required for this operation. ${cred.how}`);
+			out[cred.header] = value;
+		}
+		return out;
+	}
+	/**
 	* Run a generated hey-api SDK call through the request lifecycle.
 	*
 	* @param call  Invokes the SDK function; receives the per-attempt signal and
@@ -1188,14 +1205,25 @@ const client = createClient(createConfig());
 * Publishes an event to one or more channels of a Realtime app. Listing several channels broadcasts the event to all of them in one call. Connected clients subscribed to those channels receive it in real time.
 */
 const publishRealtimeAppEvent = (options) => (options.client ?? client).post({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/events",
 	...options,
 	headers: {
@@ -1209,14 +1237,25 @@ const publishRealtimeAppEvent = (options) => (options.client ?? client).post({
 * Publishes up to 10 events (each to one channel) in a single request.
 */
 const publishRealtimeAppBatch = (options) => (options.client ?? client).post({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/batch-events",
 	...options,
 	headers: {
@@ -1230,14 +1269,25 @@ const publishRealtimeAppBatch = (options) => (options.client ?? client).post({
 * Lists the app's currently occupied channels, optionally filtered by name prefix.
 */
 const listRealtimeAppChannels = (options) => (options.client ?? client).get({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/channels",
 	...options
 });
@@ -1247,14 +1297,25 @@ const listRealtimeAppChannels = (options) => (options.client ?? client).get({
 * Returns a single channel's occupancy and (on request) counts. Channels exist implicitly — a channel appears when the first connection subscribes and vanishes when the last one leaves — so this endpoint reports state, not existence: an unknown or never-used name returns 200 with `occupied: false`, never 404.
 */
 const getRealtimeAppChannel = (options) => (options.client ?? client).get({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/channels/{channel_name}",
 	...options
 });
@@ -1264,14 +1325,25 @@ const getRealtimeAppChannel = (options) => (options.client ?? client).get({
 * Lists the member ids currently subscribed to a presence channel. Ids only: `member_info` (the profile data attached by your authorization endpoint) is delivered to subscribed clients over the realtime connection and is not available over REST.
 */
 const listRealtimeAppChannelMembers = (options) => (options.client ?? client).get({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/channels/{channel_name}/members",
 	...options
 });
@@ -1281,18 +1353,62 @@ const listRealtimeAppChannelMembers = (options) => (options.client ?? client).ge
 * Disconnects all of a member's active connections (e.g. on sign-out or ban).
 */
 const disconnectRealtimeAppMember = (options) => (options.client ?? client).post({
-	security: [{
-		scheme: "bearer",
-		type: "http"
-	}, {
-		in: "cookie",
-		name: "bird_session",
-		type: "apiKey"
-	}],
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
 	url: "/v1/realtime/apps/{realtime_app_id}/members/{member_id}/disconnect",
 	...options
 });
 /**
+* Send an event to a member
+*
+* Delivers an event to one member of a Realtime app, addressing the person rather than a channel. Every connection that member currently holds receives it, across tabs and devices, so there is no need to track their connections or give them a channel of their own.
+* The member must have signed in on the connection for it to be addressable. Delivery is best-effort and not queued: a member holding no connections at the moment of the call simply does not receive the event.
+*/
+const sendRealtimeAppMemberEvent = (options) => (options.client ?? client).post({
+	security: [
+		{
+			scheme: "bearer",
+			type: "http"
+		},
+		{
+			name: "X-Realtime-Key",
+			type: "apiKey"
+		},
+		{
+			name: "X-Realtime-Secret",
+			type: "apiKey"
+		},
+		{
+			in: "cookie",
+			name: "bird_session",
+			type: "apiKey"
+		}
+	],
+	url: "/v1/realtime/apps/{realtime_app_id}/members/{member_id}/events",
+	...options,
+	headers: {
+		"Content-Type": "application/json",
+		...options.headers
+	}
+});
+/**
 * List messages
 *
 * Returns the workspace's sent and scheduled messages, newest first, as a cursor page. Each item carries the aggregate delivery `status` and per-state recipient counts, not the message body. Combine filters to narrow the page: `status`, `category`, `tag`, exact `to`/`from` address, and a `created_after`/`created_before` time window.
@@ -1311,7 +1427,7 @@ const listEmailMessages = (options) => (options?.client ?? client).get({
 	...options
 });
 /**
-* Send a message
+* Send an email message
 *
 * Sends an email to the recipients you list explicitly in `to`/`cc`/`bcc`. Use it for
 * transactional sends (receipts, password resets, alerts) and for marketing sends where
@@ -1408,7 +1524,7 @@ const cancelEmailMessage = (options) => (options.client ?? client).post({
 /**
 * List contacts
 *
-* Returns a paginated list of contacts in the workspace, newest first. Look up a single contact by its exact `email` or `external_id`, or search by email substring with `q`.
+* Returns a paginated list of contacts in the workspace, newest first. Look up a single contact by its exact `email`, `phone`, or `external_id`, or search by email, first name, last name, or phone substring with `q`. Pass `include_total=true` to add the total number of matching contacts to the response.
 *
 */
 const listContacts = (options) => (options?.client ?? client).get({
@@ -1426,7 +1542,7 @@ const listContacts = (options) => (options?.client ?? client).get({
 /**
 * Create a contact
 *
-* Creates a contact in the workspace. The email address is the contact's identity: it is stored trimmed and lowercased, and creating a second contact with the same email, or reusing another contact's `external_id`, returns a conflict error.
+* Creates a contact in the workspace, identified by an email address, a phone number, or both; at least one is required. Email is stored trimmed and lowercased, and phone in its canonical international form. Creating a second contact with the same email or phone number, or reusing another contact's `external_id`, returns a conflict error.
 *
 * To create or update many contacts in one request, or to write a contact without knowing whether the address already exists, use [Create or update contacts in bulk](/docs/api/reference/create-contact-batch) instead.
 *
@@ -1450,7 +1566,7 @@ const createContact = (options) => (options.client ?? client).post({
 /**
 * Create or update contacts in bulk
 *
-* Creates or updates up to 1,000 contacts in one request, matched by email address (trimmed and lowercased before matching). A new address creates a contact; an existing one is updated with the fields that entry supplies, and omitted fields keep their stored values. Optionally adds every contact in the request to up to 10 audiences.
+* Creates or updates up to 1,000 contacts in one request. Each entry is matched automatically against every identifier it supplies: its email address (trimmed and lowercased before matching), its phone number (normalized to international form), and your own `external_id`. An entry that matches no existing contact creates one; an entry whose identifiers all point at one contact updates it with the fields it supplies, and omitted fields keep their stored values, so a contact's email address can change under a stable `external_id` without creating a second record. An entry whose identifiers belong to more than one contact fails with an error naming each matched contact, since Bird never merges contacts or picks between them. Supplying `match_on` overrides the automatic matching: every entry is matched by that one field only, and must carry it. Optionally adds every contact in the request to up to 10 audiences.
 *
 * Each entry succeeds or fails on its own: the response lists one result per contact in submission order (`created`, `updated`, or `failed` with the reason), and a failed entry does not abort the rest. If the request itself is invalid, for example when an entry in `audience_ids` does not exist, the whole request fails with a validation error and no contacts are written.
 *
@@ -1512,7 +1628,7 @@ const getContact = (options) => (options.client ?? client).get({
 *
 * Updates a contact. Supplied fields are changed and omitted fields are left unchanged; set `first_name`, `last_name`, or `external_id` to null to clear them. Custom values in `data` are merged: keys you supply are set, keys set to null are removed, and keys you omit are unchanged.
 *
-* Changing the email address or `external_id` to a value already used by another contact returns a conflict error.
+* Changing the email address, phone number, or `external_id` to a value already used by another contact returns a conflict error, and a contact always keeps at least one identifier: clearing both email and phone in the same contact is rejected.
 *
 */
 const updateContact = (options) => (options.client ?? client).patch({
@@ -2024,7 +2140,7 @@ const createVerificationCheck = (options) => (options.client ?? client).post({
 /**
 * List WhatsApp messages
 *
-* Returns the workspace's WhatsApp messages as a cursor-paginated list, newest first. Filter by status, contact phone number, business-scoped user ID, tag, or creation time; pass the response's `next_cursor` back as `starting_after` to fetch the next page. To follow a single message's delivery, use [Get a WhatsApp message](/docs/api/reference/get-whats-app-message) instead.
+* Returns the workspace's WhatsApp messages as a cursor-paginated list, newest first. Filter by direction, status, contact phone number, business-scoped user ID, tag, or creation time; pass the response's `next_cursor` back as `starting_after` to fetch the next page. To follow a single message's delivery, use [Get a WhatsApp message](/docs/api/reference/get-whats-app-message) instead.
 *
 */
 const listWhatsAppMessages = (options) => (options?.client ?? client).get({
@@ -2044,10 +2160,10 @@ const listWhatsAppMessages = (options) => (options?.client ?? client).get({
 *
 * Sends a WhatsApp message built from a message template to one recipient.
 * Name the template, optionally pick its language variant, and fill its
-* placeholders in `components`; Bird selects the sender number from the
-* template's category, so the request carries no sender field. Templates are
-* the only supported content type: a request without `template` is rejected
-* with a `422`. Browse your workspace's templates in the Bird dashboard.
+* placeholders in `components`; a Bird-managed template selects its sender
+* number from its category, so the request carries no sender field. A request
+* that carries no content is rejected with a `422`. Browse your workspace's
+* templates in the Bird dashboard.
 *
 * The `202` response is the accepted message, echoing the resolved template
 * and language; it is not a delivery confirmation. Follow delivery with
@@ -2058,10 +2174,11 @@ const listWhatsAppMessages = (options) => (options?.client ?? client).get({
 *
 * A template slug or language the catalogue does not stock, parameter values
 * that do not match the template's declared placeholders, and a recipient
-* that is not a valid phone number each return a `422`.
+* that is not a valid phone number each return a `422`, as does a request
+* that carries no content at all.
 *
 */
-const sendWhatsAppMessage = (options) => (options.client ?? client).post({
+const createWhatsAppMessage = (options) => (options.client ?? client).post({
 	security: [{
 		scheme: "bearer",
 		type: "http"
@@ -2790,7 +2907,7 @@ const listMailboxReceiveRules = (options) => (options.client ?? client).get({
 /**
 * Add a receive rule
 *
-* Adds an allow or block rule to the mailbox. Rules match the message's envelope sender; domain entries also match subdomains. Block rules always win — over allow rules and over the reply admission on allowlist mailboxes. An entry can be allow or block, never both: to flip it, delete the rule and re-create it. A mailbox holds up to 200 rules.
+* Adds an allow or block rule to the mailbox. Rules match the message's envelope sender; domain entries also match subdomains. Block rules always win — over allow rules and over the reply admission on allowlist mailboxes. An entry is either allow or block. Rules have no update operation, so a rule that needs the other action is a new rule and the old one is removed. A mailbox holds up to 200 rules.
 *
 */
 const createMailboxReceiveRule = (options) => (options.client ?? client).post({
@@ -2812,7 +2929,7 @@ const createMailboxReceiveRule = (options) => (options.client ?? client).post({
 /**
 * Delete a receive rule
 *
-* Removes a receive rule from the mailbox. To change an entry from allow to block (or back), delete the rule and create a new one.
+* Removes a receive rule from the mailbox. There is no update operation for rules, so a rule's allow or block action cannot be changed after it is created.
 *
 */
 const deleteMailboxReceiveRule = (options) => (options.client ?? client).delete({
@@ -3047,18 +3164,23 @@ var Resource = class {
 		this.client = client;
 	}
 	/** Run a single typed call through the lifecycle. */
-	call(method, options, invoke) {
-		return apiPromise(this.core.request((ctx) => invoke(callContext(ctx, options)), lifecycle(method, options)));
+	call(method, options, invoke, schemes) {
+		const credentials = this.core.credentialHeaders(schemes, options?.credentials);
+		return apiPromise(this.core.request((ctx) => invoke(callContext(ctx, options, credentials)), lifecycle(method, options)));
 	}
 	/** Run a cursor-paginated list through the lifecycle (each page retried independently). */
-	paginated(method, options, invoke) {
-		return paginate((cursor) => this.core.request((ctx) => invoke(callContext(ctx, options), cursor), lifecycle(method, options)));
+	paginated(method, options, invoke, schemes) {
+		const credentials = this.core.credentialHeaders(schemes, options?.credentials);
+		return paginate((cursor) => this.core.request((ctx) => invoke(callContext(ctx, options, credentials), cursor), lifecycle(method, options)));
 	}
 };
-function callContext(ctx, options) {
+function callContext(ctx, options, credentials = {}) {
 	return {
 		signal: ctx.signal,
-		headers: mergeHeaders(ctx.idempotencyKey, options?.headers)
+		headers: {
+			...mergeHeaders(ctx.idempotencyKey, options?.headers),
+			...credentials
+		}
 	};
 }
 function lifecycle(method, options) {
@@ -3080,7 +3202,7 @@ function mergeHeaders(idempotencyKey, extra) {
 //#region src/resources/email.gen.ts
 var EmailResourceBase = class extends Resource {
 	/**
-	* Fetch one email message by id — aggregate delivery status and per-state recipient counts. The message body (html, text) is not returned. Per-recipient delivery statuses and the event log are separate sub-resources: GET /v1/email/messages/{message_id}/recipients and GET /v1/email/messages/{message_id}/events.
+	* Fetch one email message by id, with aggregate delivery status and per-state recipient counts. The message body (html, text) is not returned. Per-recipient delivery statuses and the event log are separate sub-resources: GET /v1/email/messages/{message_id}/recipients and GET /v1/email/messages/{message_id}/events.
 	*
 	* @example 
 	* const msg = await bird.email.get("em_abc123");
@@ -3097,7 +3219,7 @@ var EmailResourceBase = class extends Resource {
 		}));
 	}
 	/**
-	* List sent email messages, newest first, as a cursor page ({data, next_cursor, …}). Pass next_cursor back as starting_after to fetch the next page. Filter by creation time with the half-open range created_after (inclusive) / created_before (exclusive) — e.g. for a single UTC day set created_after to that day at 00:00:00Z and created_before to the next day at 00:00:00Z.
+	* List sent email messages, newest first, as a cursor page ({data, next_cursor, …}). Pass next_cursor back as starting_after to fetch the next page. Filter by creation time with the half-open range created_after (inclusive) / created_before (exclusive). For a single UTC day, created_after is that day at 00:00:00Z and created_before is the next day at 00:00:00Z.
 	*
 	* @example 
 	* for await (const message of bird.email.list({ status: "bounced" })) {
@@ -3116,7 +3238,7 @@ var EmailResourceBase = class extends Resource {
 		}));
 	}
 	/**
-	* Cancel a scheduled email before it sends. Only works while the message is still scheduled (status `scheduled`); once it starts sending — or was already canceled — the call returns a conflict error. Canceling does not return consumed scheduled-send quota.
+	* Cancel a scheduled email before it sends. Only works while the message is still scheduled (status `scheduled`); once it starts sending, or was already canceled, the call returns a conflict error. Canceling does not return consumed scheduled-send quota.
 	*
 	* @example 
 	* await bird.email.cancel("em_abc123");
@@ -3312,7 +3434,7 @@ var EmailStatsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Email delivery and engagement stats grouped by the template used at send time, keyed by template id (`emt_…`); only templated sends appear. To track a single template over time, pass `template` to email_stats_daily instead.
+	* Email delivery and engagement stats grouped by the template used at send time, keyed by template id (`emt_…`); only templated sends appear. A single template's trend over time comes from email_stats_daily with its `template` filter.
 	*
 	* @example 
 	* const { data } = await bird.email.stats.byTemplate({
@@ -3370,7 +3492,7 @@ var EmailStatsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Bounce counts grouped by the SMTP error code the receiving server returned, with the hard/soft/admin/block/undetermined split; failure side only. Use it to find what is driving bounces; for bounces by destination use email_stats_by_recipient_domain or email_stats_by_mailbox_provider.
+	* Bounce counts grouped by the SMTP error code the receiving server returned, with the hard/soft/admin/block/undetermined split; failure side only. It shows what is driving bounces, while bounces by destination come from email_stats_by_recipient_domain or email_stats_by_mailbox_provider.
 	*
 	* @example 
 	* const { data } = await bird.email.stats.byBounceCode({
@@ -3405,7 +3527,7 @@ var EmailStatsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Email delivery and engagement stats grouped by broadcast; only broadcast sends appear. Reflects roughly the last 30 days of activity; `include_trend` is not available here and returns 422.
+	* Email delivery and engagement stats grouped by broadcast; only broadcast sends appear. Reflects roughly the last 30 days of activity.
 	*
 	* @example 
 	* const { data } = await bird.email.stats.byBroadcast({
@@ -3427,7 +3549,7 @@ var EmailStatsResource = class extends Resource {
 };
 //#endregion
 //#region src/resources/emailMailboxes.gen.ts
-var EmailMailboxesResource$1 = class extends Resource {
+var EmailMailboxesResourceBase = class extends Resource {
 	/**
 	* List the workspace's mailboxes as a cursor page, newest first. Search addresses and display names with q, or filter by exact address, state, or domain.
 	*
@@ -3448,7 +3570,7 @@ var EmailMailboxesResource$1 = class extends Resource {
 		}));
 	}
 	/**
-	* Create a mailbox — a durable agent identity that owns an email address, groups mail into threads, and remembers conversations for its retention tier.
+	* Create a mailbox: a durable agent identity that owns an email address, groups mail into threads, and remembers conversations for its retention tier.
 	*
 	* @example Create a mailbox
 	* const mailbox = await bird.email.mailboxes.create({ display_name: "Support" });
@@ -3463,6 +3585,8 @@ var EmailMailboxesResource$1 = class extends Resource {
 		}));
 	}
 	/**
+	* Read one mailbox by id. A mailbox deleted within its 30-day restore window is still returned, carrying a non-null `deleted_at`; once that window closes it is gone and this returns 404.
+	*
 	* @example Get a mailbox
 	* const mailbox = await bird.email.mailboxes.get("mbx_01abc");
 	* console.log(mailbox.state); // "active"
@@ -3476,7 +3600,7 @@ var EmailMailboxesResource$1 = class extends Resource {
 		}));
 	}
 	/**
-	* Update a mailbox's display name, reply-to, receive policy, retention tier, contact, or metadata. Lowering the retention tier onto remembered messages older than the new horizon requires confirm=true.
+	* Update a mailbox's display name, reply-to, receive policy, retention tier, IP pool, or metadata. Lowering the retention tier onto remembered messages older than the new horizon requires confirm=true.
 	*
 	* @example Change a mailbox's receive policy
 	* const mailbox = await bird.email.mailboxes.update("mbx_01abc", {
@@ -3539,6 +3663,8 @@ var EmailMailboxesResource$1 = class extends Resource {
 		}));
 	}
 	/**
+	* Read a mailbox's sent and received email statistics over a window: a period summary plus a bucketed series. Rows are bucketed by event time rather than send time, so engagement that arrived during the period for messages sent earlier is counted here. Both window bounds must use the same form, calendar days or RFC 3339 instants, matching the granularity.
+	*
 	* @example Get mailbox stats
 	* const stats = await bird.email.mailboxes.stats("mbx_01abc");
 	* console.log(stats.summary?.sends_accepted);
@@ -3634,7 +3760,7 @@ var EmailMailboxesReceiveRulesResource = class extends Resource {
 		}));
 	}
 	/**
-	* Remove a receive rule from a mailbox. Delete-and-recreate is how an entry's action is flipped.
+	* Remove a receive rule from a mailbox. Rules have no update operation, so a rule's allow or block action cannot be changed after it is created.
 	*
 	* @example Delete a rule
 	* await bird.email.mailboxes.receiveRules.delete("mbx_01abc", "erl_01xyz");
@@ -3653,7 +3779,7 @@ var EmailMailboxesReceiveRulesResource = class extends Resource {
 };
 //#endregion
 //#region src/resources/emailMailboxes.ts
-var EmailMailboxesResource = class extends EmailMailboxesResource$1 {
+var EmailMailboxesResource = class extends EmailMailboxesResourceBase {
 	/** Messages sent from the mailbox's own address — `bird.email.mailboxes.messages.create(...)`. */
 	messages;
 	/** Per-sender allow/block rules — `bird.email.mailboxes.receiveRules.create(...)`, `.list(...)`, `.delete(...)`. */
@@ -3666,9 +3792,9 @@ var EmailMailboxesResource = class extends EmailMailboxesResource$1 {
 };
 //#endregion
 //#region src/resources/emailThreads.gen.ts
-var EmailThreadsResource$1 = class extends Resource {
+var EmailThreadsResourceBase = class extends Resource {
 	/**
-	* List mailbox conversations as a cursor page, most recently active first. `label` selects the view — inbox (default), archive, spam, blocked, or a custom label. Filter by mailbox, contact, participant address, or subject substring.
+	* List mailbox conversations as a cursor page, most recently active first. `label` selects the view: inbox (default), archive, spam, blocked, or a custom label. Filter by mailbox, contact, participant address, or subject substring.
 	*
 	* @example List conversation threads
 	* for await (const thread of bird.email.threads.list({ mailbox_id: "mbx_01abc" })) {
@@ -3702,7 +3828,7 @@ var EmailThreadsResource$1 = class extends Resource {
 		}));
 	}
 	/**
-	* Add or remove labels on a conversation — adding `spam` files it as spam, adding `archive` clears it out of the inbox, adding `inbox` brings it back — or link/unlink a contact.
+	* Add or remove labels on a conversation, or link and unlink a contact. Adding `spam` files it as spam, `archive` clears it out of the inbox, and `inbox` brings it back.
 	*
 	* @example Apply label changes to a thread
 	* const thread = await bird.email.threads.update("thr_01abc", {
@@ -3759,7 +3885,7 @@ var EmailThreadsMessagesResource = class extends Resource {
 		}));
 	}
 	/**
-	* Get one conversation message with its extracted plain text — readable for the mailbox's full retention period, no MIME parsing needed.
+	* Get one conversation message with its extracted plain text, readable for the mailbox's full retention period without MIME parsing.
 	*
 	* @example Get a message
 	* const msg = await bird.email.threads.messages.get("thr_01abc", "rem_01xyz");
@@ -3836,7 +3962,7 @@ var EmailThreadsMessagesResource = class extends Resource {
 };
 //#endregion
 //#region src/resources/emailThreads.ts
-var EmailThreadsResource = class extends EmailThreadsResource$1 {
+var EmailThreadsResource = class extends EmailThreadsResourceBase {
 	/** Messages in a conversation — `bird.email.threads.messages.list(...)`, `.reply(...)`, … */
 	messages;
 	constructor(...args) {
@@ -4165,7 +4291,7 @@ var DomainsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Register a new sending domain and get the DNS records to publish. Flow: call this, publish the returned DNS records at your DNS provider, then call email_domains_verify (repeat until status is verified — DNS propagation can take minutes to hours).
+	* Register a new sending domain and get the DNS records to publish. Verification is a second step: the records go live at the DNS provider, then email_domains_verify confirms them. Propagation takes minutes to hours, so the first verify often still reports unverified and a later one succeeds.
 	*
 	* @example Register a sending domain
 	* const domain = await bird.domains.create({ domain: "mail.acme.com" });
@@ -4195,7 +4321,7 @@ var DomainsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Update a sending domain's tracking and inbound configuration. Tracking: toggle click_tracking and open_tracking (applied immediately to new sends), and set, change, or remove the tracking domain (the name part only — Bird appends the sending domain). Enabling either toggle with no tracking domain configured returns 409; removing the tracking domain while either toggle is still on also returns 409. Tracking-domain changes on a verified domain are staged behind DNS verification, so the current config keeps serving until the new records verify. Inbound receiving: set inbound.enabled to start or stop receiving mail for the domain. Enabling requires the domain's DKIM to be verified first (a fresh enable on an unverified domain returns 422), and a domain already receiving inbound for another organization returns 422. The MX records to publish are always listed in dns_records regardless, so enabling — not merely publishing them — is what turns receiving on.
+	* Update a sending domain's tracking and inbound configuration. Tracking: click_tracking and open_tracking apply immediately to new sends, and the tracking domain can be set, changed, or removed (the name part only; Bird appends the sending domain). Enabling either toggle with no tracking domain configured returns 409, and removing the tracking domain while either toggle is still on also returns 409. Tracking-domain changes on a verified domain are staged behind DNS verification, so the current config keeps serving until the new records verify. Inbound receiving: inbound.enabled starts or stops receiving mail for the domain. Enabling requires the domain's DKIM to be verified first (a fresh enable on an unverified domain returns 422), and a domain already receiving inbound for another organization returns 422. The MX records to publish are always listed in dns_records regardless, so receiving starts only once inbound.enabled is set, even when those records are already published.
 	*
 	* @example Enable tracking on a domain
 	* await bird.domains.update("dom_01krdgeqcxet5s7t44vh8rt9mg", {
@@ -4281,7 +4407,7 @@ var ContactPropertiesResource = class extends Resource {
 		}));
 	}
 	/**
-	* Update a contact property's fallback value. The key and type are immutable; create a new property instead.
+	* Update a contact property's fallback value. Only the fallback value can change; the key and type are fixed at creation, so a different key or type needs a new property.
 	*
 	* @example Change a property's fallback value
 	* await bird.contactProperties.update("cp_01krdgeqcxet5s7t44vh8rt9mg", { fallback_value: "free" });
@@ -4329,7 +4455,7 @@ var ContactPropertiesResource = class extends Resource {
 //#region src/resources/contacts.gen.ts
 var ContactsResource = class extends Resource {
 	/**
-	* List the workspace's contacts as a cursor page, newest first. Look one up by exact email or external_id, or search by email substring.
+	* List the workspace's contacts as a cursor page, newest first. Look one up by exact email, phone, or external_id, or search by email, name, or phone substring. Pass include_total for a total count.
 	*
 	* @example Iterate every contact, or take one page
 	* for await (const contact of bird.contacts.list({ q: "acme.com" })) {
@@ -4349,7 +4475,7 @@ var ContactsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Get a single contact by ID (`con_`-prefixed). Look up an ID by exact email or external_id with `contacts.list`.
+	* Get a single contact by ID (`con_`-prefixed). Look up an ID by exact email, phone, or external_id with `contacts.list`.
 	*
 	* @example Fetch a contact by id
 	* const contact = await bird.contacts.get("con_01krdgeqcxet5s7t44vh8rt9mg");
@@ -4364,7 +4490,7 @@ var ContactsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Create a contact by email address in the workspace. Fails with a conflict if the email or external_id is already used by another contact. For bulk import or create-or-update semantics use `contacts.batch`.
+	* Create a contact identified by an email address, an E.164 phone number, or both. Fails with a conflict if the email, phone, or external_id is already used by another contact. For bulk import or create-or-update semantics use `contacts.batch`.
 	*
 	* @example Create a contact
 	* const contact = await bird.contacts.create({
@@ -4373,7 +4499,7 @@ var ContactsResource = class extends Resource {
 	* });
 	* console.log(contact.id); // "con_…"
 	*/
-	create(params, options) {
+	create(params = {}, options) {
 		return this.call("POST", options, ({ signal, headers }) => createContact({
 			client: this.client,
 			body: params,
@@ -4382,7 +4508,7 @@ var ContactsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Update a contact's name, external_id, email, or custom data. Only supplied fields change; custom data keys are merged, with null removing a key.
+	* Update a contact's name, external_id, email, phone, or custom data. Only supplied fields change; custom data keys are merged, with null removing a key. A contact keeps at least one identifier: clearing both email and phone is rejected.
 	*
 	* @example Change a contact's fields
 	* const contact = await bird.contacts.update("con_01krdgeqcxet5s7t44vh8rt9mg", {
@@ -4414,14 +4540,14 @@ var ContactsResource = class extends Resource {
 		}));
 	}
 	/**
-	* Create or update up to 1,000 contacts in one request, matched by email address, and optionally add them all to one or more audiences. Per-contact results are returned in submission order.
+	* Create or update up to 1,000 contacts in one request, each entry matched automatically against every identifier it supplies (email, phone, external_id) or, with match_on, by that one field only, and optionally add them all to one or more audiences. Per-contact results are returned in submission order.
 	*
-	* @example Create or update many contacts at once, matched by email
+	* @example Create or update many contacts at once, matched by the identifiers each entry carries
 	* const result = await bird.contacts.batch({
 	*   contacts: [{ email: "jane@acme.com", first_name: "Jane" }],
 	* });
 	* for (const item of result.data) {
-	*   console.log(item.email, item.status);
+	*   console.log(item.entry.email, item.status);
 	* }
 	*/
 	batch(params, options) {
@@ -4575,7 +4701,7 @@ var WhatsappResourceBase = class extends Resource {
 		}));
 	}
 	/**
-	* List WhatsApp messages, newest first, as a cursor page ({data, next_cursor, …}). Pass next_cursor back as starting_after to fetch the next page. Filter by status, contact phone number, bsuid, or tag. Use whatsapp_get for one message's current state.
+	* List WhatsApp messages, newest first, as a cursor page ({data, next_cursor, …}). Pass next_cursor back as starting_after to fetch the next page. Filter by direction, status, contact phone number, bsuid, or tag. Use whatsapp_get for one message's current state.
 	*
 	* @example Iterate delivered messages
 	* for await (const msg of bird.whatsapp.list({ status: ["delivered"] })) {
@@ -4632,7 +4758,7 @@ var WhatsappResource = class extends WhatsappResourceBase {
 	* console.log(msg.id, msg.status);
 	*/
 	send(params, options) {
-		return this.call("POST", options, ({ signal, headers }) => sendWhatsAppMessage({
+		return this.call("POST", options, ({ signal, headers }) => createWhatsAppMessage({
 			client: this.client,
 			body: params,
 			headers,
@@ -4750,39 +4876,49 @@ function toHeaderRecord(headers) {
 	return headers instanceof Headers ? Object.fromEntries(headers) : headers;
 }
 //#endregion
-//#region src/resources/realtime.ts
-var RealtimeBase = class extends Resource {
-	#config;
-	constructor(core, client, config) {
-		super(core, client);
-		this.#config = config;
+//#region src/resources/realtime.gen.ts
+var RealtimeResourceBase = class extends Resource {
+	/**
+	* @example Broadcast an event to a channel
+	* const result = await bird.realtime.publish("rap_01krdgeqcxet5s7t44vh8rt9mg", {
+	*   event: "order.updated",
+	*   channels: ["orders", "presence-lobby"],
+	*   data: { order_id: "ord_123", status: "shipped" },
+	* });
+	* console.log(result.data?.length); // one entry per channel
+	*/
+	publish(realtimeAppId, params, options) {
+		return this.call("POST", options, ({ signal, headers }) => publishRealtimeAppEvent({
+			client: this.client,
+			path: { realtime_app_id: realtimeAppId },
+			body: params,
+			headers,
+			signal
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 	/**
-	* Resolve the app credentials for one call. Called eagerly at the top of each
-	* method so a missing credential throws before the lifecycle starts — never
-	* as a rejected promise after a request is already in flight.
+	* @example Publish two events in one call
+	* await bird.realtime.publishBatch("rap_01krdgeqcxet5s7t44vh8rt9mg", {
+	*   events: [
+	*     { event: "order.created", channel: "orders", data: { id: 1 } },
+	*     { event: "order.updated", channel: "orders", data: { id: 2 } },
+	*   ],
+	* });
 	*/
-	auth(options) {
-		const key = options?.key ?? this.#config?.key;
-		const secret = options?.secret ?? this.#config?.secret;
-		if (!key || !secret) throw new Error("No Realtime app credentials. Set `realtime: { key, secret }` on the client, or pass `{ key, secret }` in the call options.");
-		return {
-			"X-Realtime-Key": key,
-			"X-Realtime-Secret": secret
-		};
+	publishBatch(realtimeAppId, params, options) {
+		return this.call("POST", options, ({ signal, headers }) => publishRealtimeAppBatch({
+			client: this.client,
+			path: { realtime_app_id: realtimeAppId },
+			body: params,
+			headers,
+			signal
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 };
-/**
-* `bird.realtime.channels` — reads the app's live channel state. Channels exist
-* implicitly: one appears when the first connection subscribes and vanishes when
-* the last one leaves, so these report occupancy, never existence.
-*/
-var RealtimeChannelsResource = class extends RealtimeBase {
+//#endregion
+//#region src/resources/realtimeChannels.gen.ts
+var RealtimeChannelsResource = class extends Resource {
 	/**
-	* List the app's currently occupied channels, optionally filtered by name
-	* prefix. The Realtime service returns them all in one response — this is a
-	* point read, not a cursor list, so there is nothing to iterate.
-	*
 	* @example List the occupied presence channels with their member counts
 	* const { data } = await bird.realtime.channels.list("rap_01krdgeqcxet5s7t44vh8rt9mg", {
 	*   prefix: "presence-",
@@ -4790,171 +4926,104 @@ var RealtimeChannelsResource = class extends RealtimeBase {
 	* });
 	* for (const channel of data) console.log(channel.name, channel.member_count);
 	*/
-	list(appId, query, options) {
-		const auth = this.auth(options);
+	list(realtimeAppId, query, options) {
 		return this.call("GET", options, ({ signal, headers }) => listRealtimeAppChannels({
 			client: this.client,
-			path: { realtime_app_id: appId },
+			path: { realtime_app_id: realtimeAppId },
 			query,
-			headers: {
-				...headers,
-				...auth
-			},
+			headers,
 			signal
-		}));
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 	/**
-	* Read one channel's state. An unknown or never-used name is not an error —
-	* it resolves with `occupied: false`.
-	*
 	* @example Check whether anyone is in a channel
-	* const channel = await bird.realtime.channels.get(
-	*   "rap_01krdgeqcxet5s7t44vh8rt9mg",
-	*   "presence-lobby",
-	*   { include: ["member_count"] },
-	* );
+	* const channel = await bird.realtime.channels.get("rap_01krdgeqcxet5s7t44vh8rt9mg", "presence-lobby", {
+	*   include: ["member_count"],
+	* });
 	* console.log(channel.occupied, channel.member_count);
 	*/
-	get(appId, channelName, query, options) {
-		const auth = this.auth(options);
+	get(realtimeAppId, channelName, query, options) {
 		return this.call("GET", options, ({ signal, headers }) => getRealtimeAppChannel({
 			client: this.client,
 			path: {
-				realtime_app_id: appId,
+				realtime_app_id: realtimeAppId,
 				channel_name: channelName
 			},
 			query,
-			headers: {
-				...headers,
-				...auth
-			},
+			headers,
 			signal
-		}));
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 	/**
-	* List the member ids subscribed to a presence channel. Ids only — the
-	* `member_info` your authorization endpoint attaches is delivered to subscribed
-	* clients over the realtime connection and is not available over REST.
-	*
 	* @example Who is in the lobby
-	* const { members } = await bird.realtime.channels.members(
-	*   "rap_01krdgeqcxet5s7t44vh8rt9mg",
-	*   "presence-lobby",
-	* );
+	* const { members } = await bird.realtime.channels.members("rap_01krdgeqcxet5s7t44vh8rt9mg", "presence-lobby");
 	* for (const member of members) console.log(member.member_id);
 	*/
-	members(appId, channelName, options) {
-		const auth = this.auth(options);
+	members(realtimeAppId, channelName, options) {
 		return this.call("GET", options, ({ signal, headers }) => listRealtimeAppChannelMembers({
 			client: this.client,
 			path: {
-				realtime_app_id: appId,
+				realtime_app_id: realtimeAppId,
 				channel_name: channelName
 			},
-			headers: {
-				...headers,
-				...auth
-			},
+			headers,
 			signal
-		}));
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 };
-/** `bird.realtime.members` — acts on a member across all of its connections. */
-var RealtimeMembersResource = class extends RealtimeBase {
+//#endregion
+//#region src/resources/realtimeMembers.gen.ts
+var RealtimeMembersResource = class extends Resource {
+	/**
+	* @example Notify one person wherever they are signed in
+	* await bird.realtime.members.send("rap_01krdgeqcxet5s7t44vh8rt9mg", "user_42", {
+	*   event: "order-shipped",
+	*   data: { order_id: "ord_123" },
+	* });
+	*/
+	send(realtimeAppId, memberId, params, options) {
+		return this.call("POST", options, ({ signal, headers }) => sendRealtimeAppMemberEvent({
+			client: this.client,
+			path: {
+				realtime_app_id: realtimeAppId,
+				member_id: memberId
+			},
+			body: params,
+			headers,
+			signal
+		}), ["RealtimeKey", "RealtimeSecret"]);
+	}
 	/**
-	* Disconnect every active connection a member holds — sign-out, ban, or a
-	* revoked session. Resolves once the disconnect is applied; the member may
-	* reconnect immediately unless your authorization endpoint refuses them.
-	*
 	* @example Kick a member off every connection
 	* await bird.realtime.members.disconnect("rap_01krdgeqcxet5s7t44vh8rt9mg", "user_42");
 	*/
-	disconnect(appId, memberId, options) {
-		const auth = this.auth(options);
+	disconnect(realtimeAppId, memberId, options) {
 		return this.call("POST", options, ({ signal, headers }) => disconnectRealtimeAppMember({
 			client: this.client,
 			path: {
-				realtime_app_id: appId,
+				realtime_app_id: realtimeAppId,
 				member_id: memberId
 			},
-			headers: {
-				...headers,
-				...auth
-			},
+			headers,
 			signal
-		}));
+		}), ["RealtimeKey", "RealtimeSecret"]);
 	}
 };
+//#endregion
+//#region src/resources/realtime.ts
 /**
 * `bird.realtime` — publish events to a Realtime app's channels and inspect its
-* live state. Every method needs the app's key/secret pair: set it once as
-* `realtime: { key, secret }` on the client, or pass `{ key, secret }` in a
-* call's options to reach a different app. Reached as `bird.realtime.*`.
+* live state. Reached as `bird.realtime.*`.
 */
-var RealtimeResource = class extends RealtimeBase {
+var RealtimeResource = class extends RealtimeResourceBase {
 	/** Channel state — `bird.realtime.channels.list(...)`, `.get(...)`, `.members(...)`. */
 	channels;
-	/** Members — `bird.realtime.members.disconnect(...)`. */
+	/** Members — `bird.realtime.members.send(...)`, `.disconnect(...)`. */
 	members;
-	constructor(core, client, config) {
-		super(core, client, config);
-		this.channels = new RealtimeChannelsResource(core, client, config);
-		this.members = new RealtimeMembersResource(core, client, config);
-	}
-	/**
-	* Publish one event to one or more of the app's channels. Listing several
-	* channels broadcasts the same event to all of them in a single call. Resolves
-	* once the event is accepted — delivery to connected clients is asynchronous.
-	*
-	* Pass `exclude_connection_id` to skip the connection that triggered the
-	* change, so the originating client doesn't echo its own update.
-	*
-	* @example Broadcast an event to a channel
-	* const result = await bird.realtime.publish("rap_01krdgeqcxet5s7t44vh8rt9mg", {
-	*   event: "order.updated",
-	*   channels: ["orders", "presence-lobby"],
-	*   data: { order_id: "ord_123", status: "shipped" },
-	* });
-	* console.log(result.data?.length); // one entry per channel
-	*/
-	publish(appId, params, options) {
-		const auth = this.auth(options);
-		return this.call("POST", options, ({ signal, headers }) => publishRealtimeAppEvent({
-			client: this.client,
-			path: { realtime_app_id: appId },
-			body: params,
-			headers: {
-				...headers,
-				...auth
-			},
-			signal
-		}));
-	}
-	/**
-	* Publish up to 10 events in one request, each to a single channel. Use it to
-	* fan different events out at once; to send the *same* event to many channels,
-	* use `publish` with several `channels` instead.
-	*
-	* @example Publish two events in one call
-	* await bird.realtime.publishBatch("rap_01krdgeqcxet5s7t44vh8rt9mg", {
-	*   events: [
-	*     { event: "order.created", channel: "orders", data: { id: 1 } },
-	*     { event: "order.updated", channel: "orders", data: { id: 2 } },
-	*   ],
-	* });
-	*/
-	publishBatch(appId, params, options) {
-		const auth = this.auth(options);
-		return this.call("POST", options, ({ signal, headers }) => publishRealtimeAppBatch({
-			client: this.client,
-			path: { realtime_app_id: appId },
-			body: params,
-			headers: {
-				...headers,
-				...auth
-			},
-			signal
-		}));
+	constructor(core, client) {
+		super(core, client);
+		this.channels = new RealtimeChannelsResource(core, client);
+		this.members = new RealtimeMembersResource(core, client);
 	}
 };
 //#endregion
@@ -5040,9 +5109,9 @@ var BirdClient = class {
 		this.#headers = {
 			...opts.defaultHeaders,
 			Authorization: `Bearer ${opts.apiKey}`,
-			"User-Agent": `bird-sdk-js/0.16.0`,
+			"User-Agent": `bird-sdk-js/0.21.2`,
 			"Bird-Surface": "sdk-js",
-			"Bird-Version": "0.16.0"
+			"Bird-Version": "0.21.2"
 		};
 		const caller = detectCaller();
 		if (caller) this.#headers["Bird-Caller"] = caller;
@@ -5053,7 +5122,19 @@ var BirdClient = class {
 		}));
 		this.core = new BirdHTTPClient({
 			timeout: opts.timeout ?? DEFAULT_TIMEOUT_MS,
-			maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES
+			maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES,
+			credentials: {
+				RealtimeKey: {
+					header: "X-Realtime-Key",
+					value: opts.realtime?.key,
+					how: "Set `realtime: { key, secret }` on the client."
+				},
+				RealtimeSecret: {
+					header: "X-Realtime-Secret",
+					value: opts.realtime?.secret,
+					how: "Set `realtime: { key, secret }` on the client."
+				}
+			}
 		});
 		this.email = new EmailResource(this.core, this.#client, opts.email);
 		this.sms = new SmsResource(this.core, this.#client);
@@ -5065,7 +5146,7 @@ var BirdClient = class {
 		this.contactProperties = new ContactPropertiesResource(this.core, this.#client);
 		this.domains = new DomainsResource(this.core, this.#client);
 		this.webhooks = new WebhooksResource(opts.webhooks);
-		this.realtime = new RealtimeResource(this.core, this.#client, opts.realtime);
+		this.realtime = new RealtimeResource(this.core, this.#client);
 	}
 	/**
 	* Escape hatch for endpoints the typed resources don't cover. Runs the full
@@ -5155,10 +5236,6 @@ const WebhookEventType = {
 	SmsFailed: "sms.failed",
 	SmsRejected: "sms.rejected",
 	SmsSent: "sms.sent",
-	SmsTfnVerificationApproved: "sms.tfn_verification.approved",
-	SmsTfnVerificationInfoRequested: "sms.tfn_verification.info_requested",
-	SmsTfnVerificationRejected: "sms.tfn_verification.rejected",
-	SmsTfnVerificationSubmitted: "sms.tfn_verification.submitted",
 	SmsUndelivered: "sms.undelivered",
 	VerifyAttemptDelivered: "verify.attempt.delivered",
 	VerifyAttemptSent: "verify.attempt.sent",
@@ -5176,6 +5253,91 @@ const WebhookEventType = {
 	WhatsappSent: "whatsapp.sent"
 };
 //#endregion
-export { BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, BirdWebhookVerificationError, WebhookEventType, baseUrlForRegion, regionFromApiKey };
+//#region src/open-enums.gen.ts
+/**
+* Values of EmailEventType known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const EmailEventType = {
+	EmailAccepted: "email.accepted",
+	EmailBounced: "email.bounced",
+	EmailCanceled: "email.canceled",
+	EmailClicked: "email.clicked",
+	EmailComplained: "email.complained",
+	EmailDeferred: "email.deferred",
+	EmailDelivered: "email.delivered",
+	EmailListUnsubscribed: "email.list_unsubscribed",
+	EmailOpened: "email.opened",
+	EmailOutOfBandBounce: "email.out_of_band_bounce",
+	EmailProcessed: "email.processed",
+	EmailRejected: "email.rejected",
+	EmailScheduled: "email.scheduled",
+	EmailUnsubscribed: "email.unsubscribed"
+};
+/**
+* Values of VerificationAttemptFailureReason known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const VerificationAttemptFailureReason = {
+	CarrierRejected: "carrier_rejected",
+	ChannelDisabled: "channel_disabled",
+	ChannelUnavailable: "channel_unavailable",
+	HardBounce: "hard_bounce",
+	SoftBounce: "soft_bounce",
+	Undelivered: "undelivered"
+};
+/**
+* Values of VerificationChannel known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const VerificationChannel = {
+	Email: "email",
+	Sms: "sms",
+	Whatsapp: "whatsapp"
+};
+/**
+* Values of VerificationTerminalReason known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const VerificationTerminalReason = {
+	AttemptsExhausted: "attempts_exhausted",
+	TtlElapsed: "ttl_elapsed"
+};
+/**
+* Values of WhatsAppErrorCode known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const WhatsAppErrorCode = {
+	InsufficientBalance: "insufficient_balance",
+	InternalError: "internal_error",
+	PriceNotFound: "price_not_found",
+	RateLimited: "rate_limited",
+	RecipientSuppressed: "recipient_suppressed",
+	ServiceWindowExpired: "service_window_expired",
+	Undeliverable: "undeliverable"
+};
+/**
+* Values of WhatsAppTemplateCategory known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const WhatsAppTemplateCategory = {
+	Authentication: "authentication",
+	Marketing: "marketing",
+	Utility: "utility"
+};
+/**
+* Values of WhatsAppTemplateParameterType known at this SDK version. The wire value is an open
+* string: a value added by a newer server deserializes unchanged, so switch on
+* these with a `default` branch rather than treating the set as closed.
+*/
+const WhatsAppTemplateParameterType = { Text: "text" };
+//#endregion
+export { BirdAPIError, BirdAuthError, BirdBadRequestError, BirdBillingError, BirdClient, BirdConflictError, BirdConnectionError, BirdError, BirdInternalError, BirdMisdirectedError, BirdNotFoundError, BirdNotImplementedError, BirdPayloadTooLargeError, BirdPermissionError, BirdPreconditionError, BirdRateLimitError, BirdServiceUnavailableError, BirdTimeoutError, BirdValidationError, BirdWebhookVerificationError, EmailEventType, VerificationAttemptFailureReason, VerificationChannel, VerificationTerminalReason, WebhookEventType, WhatsAppErrorCode, WhatsAppTemplateCategory, WhatsAppTemplateParameterType, baseUrlForRegion, regionFromApiKey };
 
 //# sourceMappingURL=index.mjs.map