@messagebird/sdk 0.36.0 → 0.37.0

package/dist/index.d.mts

@@ -639,9 +639,11 @@ type LanguageTag = string;
 type EmailTemplateId = string;
 type EmailTemplateVersionId = string;
 /**
- * Structured key/value label attached to a message. Surfaces in list filters, the event log, and webhook payloads. Use tags for low-cardinality filtering dimensions (category, experiment ID, template ID). For arbitrary per-send context that does not need to be filterable, use `metadata`.
+ * Structured key/value label attached to a message or a call. Use tags for low-cardinality filtering dimensions (category, experiment ID, template ID); they surface in the list filter of whatever carries them.
  *
- * The send request defines the tag-count limit. Tag names are unique within a send; supplying the same name twice is rejected.
+ * On a message they also surface in the event log and in webhook payloads, and a message can carry `metadata` beside them for arbitrary per-send context that does not need to be filterable. A call has none of those three: its tags are set on the wire when the call is placed, and the call record is the one place you read them back.
+ *
+ * Whatever carries the tags defines how many it may have. Tag names are unique: a send that repeats one is rejected, and on a call the first instance of a name wins.
  *
  */
 type Tag = {
@@ -7985,7 +7987,7 @@ type EventWhatsAppSent = {
  */
 type NumberType$1 = "mobile" | "local" | "national" | "short_code" | "short_code_fteu" | "toll_free" | (string & {});
 /**
- * Channel capability supported by a phone number. New capabilities may be added over time, so treat unrecognized values as supported capabilities rather than errors.
+ * A capability supported by a phone number. New capabilities may be added over time, so treat unrecognized values as supported capabilities rather than errors.
  */
 type NumberCapability$1 = "sms" | "mms" | "voice" | (string & {});
 /**
@@ -8028,7 +8030,7 @@ type Number = {
    */
   readonly number_type: NumberType$1;
   /**
-   * Channel capabilities supported by this number.
+   * Capabilities supported by this number.
    */
   readonly capabilities: Array<NumberCapability$1>;
   /**
@@ -8071,7 +8073,7 @@ type AvailableNumber = {
    */
   number_type: NumberType$1;
   /**
-   * Channel capabilities supported by this number.
+   * Capabilities supported by this number.
    */
   capabilities: Array<NumberCapability$1>;
 };
@@ -8249,6 +8251,10 @@ type VoiceCall = {
    * Why we refused the call before dialing a carrier. Absent when the call connected or failed at the carrier; see `sip_response_code` for the carrier response.
    */
   readonly rejection_reason?: VoiceCallRejectionReason;
+  /**
+   * Your own `{name, value}` labels for this call, taken from the `X-Bird-Call-Tag` headers on the INVITE that placed it. Set them to organise calls by a dimension of your own (campaign, queue, agent, cost centre), then filter this list by them with `tag`. Read-only here: a call is labelled when it is placed, and never afterwards. What is here may be less than what was sent, and the call still goes through either way: a tag whose name or value breaks the rules below is dropped, anything past the first five is ignored, and a name sent more than once keeps its first value. Absent when the call carried none, and on calls recorded before this field existed.
+   */
+  readonly tags?: Array<Tag>;
   /**
    * When the call was initiated.
    */
@@ -8445,7 +8451,7 @@ type ListEmailMessagesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
     /**
@@ -8461,7 +8467,7 @@ type ListEmailMessagesData = {
      */
     status?: EmailMessageStatus;
     /**
-     * Filter by tag. Accepts `name` to match any message carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A message must match every tag listed to be returned.
+     * Filter by tag. Accepts `name` to match any record carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A record must match every tag listed to be returned.
      *
      */
     tag?: Array<string>;
@@ -8515,7 +8521,7 @@ type ListContactsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
     /**
@@ -8609,7 +8615,7 @@ type ListContactPropertiesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -8681,7 +8687,7 @@ type ListAudiencesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -8758,7 +8764,7 @@ type ListAudienceContactsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -8831,7 +8837,7 @@ type ListSmsMessagesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
     /**
@@ -8869,7 +8875,7 @@ type ListSmsMessagesData = {
      */
     from?: string;
     /**
-     * Filter by tag. Accepts `name` to match any message carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A message must match every tag listed to be returned.
+     * Filter by tag. Accepts `name` to match any record carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A record must match every tag listed to be returned.
      *
      */
     tag?: Array<string>;
@@ -8944,7 +8950,7 @@ type ListSmsSuppressionsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -9723,7 +9729,7 @@ type ListWhatsAppMessagesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
     /**
@@ -9770,7 +9776,7 @@ type ListWhatsAppMessagesData = {
      */
     category?: WhatsAppTemplateCategory$1;
     /**
-     * Filter by tag. Accepts `name` to match any message carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A message must match every tag listed to be returned.
+     * Filter by tag. Accepts `name` to match any record carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A record must match every tag listed to be returned.
      *
      */
     tag?: Array<string>;
@@ -10476,7 +10482,7 @@ type ListDomainsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
     /**
@@ -10568,7 +10574,7 @@ type ListMailboxesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -10682,7 +10688,7 @@ type ListMailboxReceiveRulesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -10762,7 +10768,7 @@ type ListEmailThreadsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -10858,7 +10864,7 @@ type ListEmailThreadMessagesData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -10922,7 +10928,7 @@ type ListWorkspaceNumbersData = {
      */
     prefix?: string;
     /**
-     * Filter by channel capability. Repeat the parameter to require several at once: `capabilities=sms&capabilities=voice` returns only numbers that support both.
+     * Filter by capability. Repeat the parameter to require several at once: `capabilities=sms&capabilities=voice` returns only numbers that support both.
      */
     capabilities?: Array<string>;
     /**
@@ -10934,7 +10940,7 @@ type ListWorkspaceNumbersData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -10963,7 +10969,7 @@ type ListAvailableNumbersData = {
      */
     prefix?: string;
     /**
-     * Filter by channel capability. Repeat the parameter to require several at once: `capabilities=sms&capabilities=voice` returns only numbers that support both.
+     * Filter by capability. Repeat the parameter to require several at once: `capabilities=sms&capabilities=voice` returns only numbers that support both.
      */
     capabilities?: Array<string>;
     /**
@@ -10975,7 +10981,7 @@ type ListAvailableNumbersData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -11004,7 +11010,7 @@ type ListNumbersOrdersData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };
@@ -11072,6 +11078,11 @@ type ListVoiceCallsData = {
      * Return only calls where the calling or called number contains this value. Matches a partial number, so a country or area-code prefix returns every call to or from it. Combines with `from`/`to`, which match one side exactly.
      */
     number?: string;
+    /**
+     * Filter by tag. Accepts `name` to match any record carrying that tag name, or `name:value` to match a specific tag pair (for example `category:welcome`). Repeat the parameter to add more tags. A record must match every tag listed to be returned.
+     *
+     */
+    tag?: Array<string>;
     /**
      * Return only calls that started at or after this instant, inclusive. RFC 3339 timestamp.
      */
@@ -11089,7 +11100,7 @@ type ListVoiceCallsData = {
      */
     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.
+     * Cursor from the `prev_cursor` or `refresh_cursor` field of a previous list response. Returns items immediately before the cursor position in the current sort order. `prev_cursor` returns the preceding page. `refresh_cursor` anchors at the first row of that response, which on a newest-first sort is how to fetch the items that have appeared since.
      */
     ending_before?: string;
   };

package/dist/index.mjs

@@ -7132,9 +7132,9 @@ var BirdClient = class {
 		this.#headers = {
 			...opts.defaultHeaders,
 			Authorization: `Bearer ${opts.apiKey}`,
-			"User-Agent": `bird-sdk-js/0.36.0`,
+			"User-Agent": `bird-sdk-js/0.37.0`,
 			"Bird-Surface": "sdk-js",
-			"Bird-Version": "0.36.0"
+			"Bird-Version": "0.37.0"
 		};
 		const caller = detectCaller();
 		if (caller) this.#headers["Bird-Caller"] = caller;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@messagebird/sdk",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "The official TypeScript SDK for the Bird API: email, SMS, WhatsApp, verification, and Realtime on one typed client.",
   "license": "MIT",
   "author": "Bird",