@messagebird/sdk 0.43.0 → 0.45.0

package/dist/index.d.mts

@@ -5853,7 +5853,7 @@ type MailboxOwner = {
   readonly id: WorkspaceId;
 };
 /**
- * A durable mailbox identity for an agent. A mailbox owns an email address, groups mail into threads, applies receive policy, and remembers message metadata and extracted text for its retention tier. The original rendered source of each message remains available for 30 days.
+ * A durable mailbox identity for an agent. A mailbox owns an email address, groups mail into threads, applies receive policy, and remembers message metadata, extracted text, and attachments for its retention tier. The body and raw MIME of each message remain available for 30 days.
  *
  */
 type Mailbox = {
@@ -5900,7 +5900,7 @@ type Mailbox = {
    */
   readonly inbound_address_id: InboundAddressId;
   /**
-   * How long the mailbox remembers message metadata and extracted text. Original rendered source (HTML, raw message, attachments) is always available for 30 days regardless of tier.
+   * How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier.
    */
   retention_tier: "30d" | "90d" | "1y";
   /**
@@ -5911,6 +5911,10 @@ type Mailbox = {
    * Number of retained threads.
    */
   readonly thread_count: number;
+  /**
+   * Stored bytes across the mailbox's retained messages: the metadata and extracted text kept for the retention tier plus attachment bytes. Message bodies and raw MIME expire after 30 days and do not count. Maintained with each message written or deleted, so the value is current; messages stored before the counter existed are not counted.
+   */
+  readonly size_bytes: number;
   /**
    * Number of threads with unread messages in this mailbox, excluding trash. `null` on create/update responses.
    *
@@ -5972,9 +5976,9 @@ type MailboxCreate = {
    */
   receive_policy?: "open" | "replies_only" | "allowlist" | "drop";
   /**
-   * How long the mailbox remembers message metadata and extracted text. Original rendered source is always available for 30 days regardless of tier.
+   * How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them.
    */
-  retention_tier?: "30d";
+  retention_tier?: "30d" | "90d" | "1y";
   /**
    * Your own key/value data to attach to the mailbox. Up to 2 KB. Keys starting with `__bird` are reserved.
    */
@@ -6007,9 +6011,9 @@ type MailboxUpdate = {
    */
   receive_policy?: "open" | "replies_only" | "allowlist" | "drop";
   /**
-   * How long the mailbox remembers message metadata and extracted text. Lowering the tier deletes remembered messages older than the new horizon, and requires `confirm=true` when that would happen.
+   * How long the mailbox remembers message metadata, extracted text, and attachments. Message bodies and raw MIME stay available for 30 days regardless of tier. Tiers longer than 30 days require a plan that includes them. Lowering the tier deletes remembered messages older than the new horizon, and requires `confirm=true` when that would happen.
    */
-  retention_tier?: "30d";
+  retention_tier?: "30d" | "90d" | "1y";
   /**
    * Replaces the mailbox's key/value data. Up to 2 KB. Keys starting with `__bird` are reserved.
    */
@@ -6245,7 +6249,7 @@ type EmailThreadMessageRecipient = {
   readonly status: "delivered" | "failed";
 };
 /**
- * Attachment metadata on a conversation message. The metadata stays readable for the mailbox's retention tier. The attachment bytes are downloadable for 30 days after the message occurred.
+ * Attachment metadata on a conversation message. Both the metadata and the attachment bytes stay available for the mailbox's retention tier.
  *
  */
 type EmailThreadMessageAttachment = {
@@ -6276,12 +6280,12 @@ type EmailThreadMessageSource = {
    */
   readonly resource: string;
   /**
-   * When the log entry (and the message's original rendered source) expires.
+   * When the log entry (and the message's body and raw MIME) expires.
    */
   readonly available_until: string;
 };
 /**
- * A message in a mailbox conversation, either direction. Message metadata and extracted text stay readable for the mailbox's retention tier. The original rendered source (HTML body, raw MIME, attachment bytes) is available through the body, raw, and attachment endpoints for 30 days after the message occurred.
+ * A message in a mailbox conversation, either direction. Message metadata, extracted text, and attachment bytes stay readable for the mailbox's retention tier. The body and raw MIME are available through the body and raw endpoints for 30 days after the message occurred.
  *
  */
 type EmailThreadMessage = {
@@ -6400,7 +6404,7 @@ type EmailThreadMessage = {
    */
   readonly attachment_count: number;
   /**
-   * Attachment metadata (filename, content type, size). Stays readable for the mailbox's retention tier even after the attachment bytes themselves have expired.
+   * Attachment metadata (filename, content type, size). Both the metadata and the attachment bytes stay available for the mailbox's retention tier.
    *
    */
   readonly attachment_manifest: Array<EmailThreadMessageAttachment>;
@@ -12702,7 +12706,7 @@ declare class EmailThreadsMessagesResource extends Resource {
    */
   reply(threadId: string, messageId: string, params?: EmailThreadsMessagesReplyParams, options?: RequestOptions): APIPromise<EmailThreadMessage>;
   /**
-   * List the attachments on a conversation message. Bytes are downloadable for 30 days, and the metadata stays readable afterward on the message's attachment_manifest.
+   * List the attachments on a conversation message. Bytes are downloadable for the mailbox's retention tier, and the metadata stays readable afterward on the message's attachment_manifest.
    *
    * @example List a message's attachments
    * const atts = await bird.email.threads.messages.attachments("thr_01abc", "rem_01xyz");

package/dist/index.mjs

@@ -3923,7 +3923,7 @@ const getEmailThreadMessageBody = (options) => (options.client ?? client).get({
 /**
 * List a thread message's attachments
 *
-* Returns the attachments on a message in a conversation. Attachment bytes are downloadable for 30 days after the message occurred. Later requests return `410 Gone`, while the attachment metadata stays readable on the message's `attachment_manifest`.
+* Returns the attachments on a message in a conversation. Attachment bytes are downloadable for the mailbox's retention tier after the message occurred. Later requests return `410 Gone`, while the attachment metadata stays readable on the message's `attachment_manifest`.
 *
 */
 const listEmailThreadMessageAttachments = (options) => (options.client ?? client).get({
@@ -5216,7 +5216,7 @@ var EmailThreadsMessagesResource = class extends Resource {
 		}));
 	}
 	/**
-	* List the attachments on a conversation message. Bytes are downloadable for 30 days, and the metadata stays readable afterward on the message's attachment_manifest.
+	* List the attachments on a conversation message. Bytes are downloadable for the mailbox's retention tier, and the metadata stays readable afterward on the message's attachment_manifest.
 	*
 	* @example List a message's attachments
 	* const atts = await bird.email.threads.messages.attachments("thr_01abc", "rem_01xyz");
@@ -7765,9 +7765,9 @@ var BirdClient = class {
 		this.#headers = {
 			...opts.defaultHeaders,
 			...opts.apiKey ? { Authorization: `Bearer ${opts.apiKey}` } : {},
-			"User-Agent": `bird-sdk-js/0.43.0`,
+			"User-Agent": `bird-sdk-js/0.45.0`,
 			"Bird-Surface": "sdk-js",
-			"Bird-Version": "0.43.0"
+			"Bird-Version": "0.45.0"
 		};
 		const caller = detectCaller();
 		if (caller) this.#headers["Bird-Caller"] = caller;