sendblue 3.9.0 → 3.9.1

package/src/resources/groups.ts

@@ -94,6 +94,14 @@ export interface GroupSendMessageParams {
    * Array of recipient phone numbers in E.164 format
    */
   numbers?: Array<string>;
+
+  /**
+   * Optional. Identifies the seat (user) sending the group message so it is
+   * attributed to a specific rep. Accepts either the seat UUID or the Firebase Auth
+   * subject. When provided, `sender_email` is auto-populated on the message record
+   * and webhook payloads. Returns 400 if the seat is not found.
+   */
+  seat_id?: string;
 }
 
 export declare namespace Groups {

package/src/resources/messages.ts

@@ -133,6 +133,12 @@ export interface MessageContent {
    */
   message_handle?: string;
 
+  /**
+   * UUID of the seat that sent the message. Present when `seat_id` was provided on
+   * send, or for dashboard-originated group messages.
+   */
+  seat_id?: string | null;
+
   send_style?:
     | 'celebration'
     | 'shooting_star'
@@ -148,6 +154,12 @@ export interface MessageContent {
     | 'loud'
     | 'slam';
 
+  /**
+   * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+   * is provided on send. `null` for messages sent without a `seat_id`.
+   */
+  sender_email?: string | null;
+
   status?: 'QUEUED' | 'SENT' | 'DELIVERED' | 'ERROR' | 'RECEIVED';
 
   /**
@@ -212,6 +224,12 @@ export interface MessageResponse {
    */
   number?: string;
 
+  /**
+   * UUID of the seat that sent the message. Present when `seat_id` was provided on
+   * send, or for dashboard-originated group messages.
+   */
+  seat_id?: string | null;
+
   /**
    * The iMessage expressive message style
    */
@@ -230,6 +248,12 @@ export interface MessageResponse {
     | 'loud'
     | 'slam';
 
+  /**
+   * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+   * is provided on send. `null` for messages sent without a `seat_id`.
+   */
+  sender_email?: string | null;
+
   status?: 'QUEUED' | 'SENT' | 'DELIVERED' | 'ERROR';
 }
 
@@ -333,6 +357,12 @@ export namespace MessageRetrieveResponse {
      */
     plan?: string;
 
+    /**
+     * UUID of the seat that sent the message. Present when `seat_id` was provided on
+     * send, or for dashboard-originated group messages.
+     */
+    seat_id?: string | null;
+
     /**
      * The iMessage expressive message style
      */
@@ -356,6 +386,12 @@ export namespace MessageRetrieveResponse {
      */
     sendblue_number?: string | null;
 
+    /**
+     * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+     * is provided on send. `null` for messages sent without a `seat_id`.
+     */
+    sender_email?: string | null;
+
     /**
      * The messaging service used
      */
@@ -487,6 +523,12 @@ export namespace MessageListResponse {
      */
     plan?: string;
 
+    /**
+     * UUID of the seat that sent the message. Present when `seat_id` was provided on
+     * send, or for dashboard-originated group messages.
+     */
+    seat_id?: string | null;
+
     /**
      * The iMessage expressive message style
      */
@@ -510,6 +552,12 @@ export namespace MessageListResponse {
      */
     sendblue_number?: string | null;
 
+    /**
+     * Email of the seat (user) that sent the message. Auto-populated when a `seat_id`
+     * is provided on send. `null` for messages sent without a `seat_id`.
+     */
+    sender_email?: string | null;
+
     /**
      * The messaging service used
      */
@@ -718,6 +766,14 @@ export interface MessageSendParams {
    */
   media_url?: string;
 
+  /**
+   * Optional. Identifies the seat (user) sending the message so the message is
+   * attributed to a specific rep. Accepts either the seat UUID or the Firebase Auth
+   * subject. When provided, `sender_email` is auto-populated on the message record
+   * and webhook payloads. Returns 400 if the seat is not found.
+   */
+  seat_id?: string;
+
   /**
    * The iMessage expressive message style
    */

package/src/resources/send-carousel.ts

@@ -85,6 +85,14 @@ export interface SendCarouselSendParams {
    */
   metadata?: unknown;
 
+  /**
+   * Optional. Identifies the seat (user) sending the carousel so it is attributed to
+   * a specific rep. Accepts either the seat UUID or the Firebase Auth subject. When
+   * provided, `sender_email` is auto-populated on the message record and webhook
+   * payloads. Returns 400 if the seat is not found.
+   */
+  seat_id?: string;
+
   /**
    * The iMessage expressive message style
    */

package/src/resources/v2/index.ts

@@ -1,4 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Seats,
+  type SeatRetrieveResponse,
+  type SeatListResponse,
+  type SeatCountResponse,
+  type SeatListParams,
+  type SeatCountParams,
+} from './seats';
 export { Totp, type TotpGetCodeResponse } from './totp/index';
 export { V2 } from './v2';

package/src/resources/v2/seats.ts

@@ -0,0 +1,182 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+/**
+ * Operations for retrieving seats (users) on the account, used for attribution via `seat_id`
+ */
+export class Seats extends APIResource {
+  /**
+   * Retrieve a single seat by either its UUID or its Firebase Auth subject. Both
+   * identifiers resolve to the same seat.
+   *
+   * @example
+   * ```ts
+   * const seat = await client.v2.seats.retrieve('seat_id');
+   * ```
+   */
+  retrieve(seatID: string, options?: RequestOptions): APIPromise<SeatRetrieveResponse> {
+    return this._client.get(path`/api/v2/seats/${seatID}`, options);
+  }
+
+  /**
+   * Retrieve a list of seats (users) for the authenticated company. Use the returned
+   * `seat_id` values when sending messages with the `seat_id` parameter to attribute
+   * activity to a specific rep.
+   *
+   * @example
+   * ```ts
+   * const seats = await client.v2.seats.list();
+   * ```
+   */
+  list(
+    query: SeatListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SeatListResponse> {
+    return this._client.get('/api/v2/seats', { query, ...options });
+  }
+
+  /**
+   * Returns the number of seats for the authenticated company.
+   *
+   * @example
+   * ```ts
+   * const response = await client.v2.seats.count();
+   * ```
+   */
+  count(
+    query: SeatCountParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<SeatCountResponse> {
+    return this._client.get('/api/v2/seats/count', { query, ...options });
+  }
+}
+
+export interface SeatRetrieveResponse {
+  seat?: SeatRetrieveResponse.Seat;
+
+  status?: string;
+}
+
+export namespace SeatRetrieveResponse {
+  export interface Seat {
+    /**
+     * Account name the seat belongs to
+     */
+    account?: string;
+
+    /**
+     * When the seat was created
+     */
+    created_at?: string;
+
+    /**
+     * Email address of the seat user
+     */
+    email?: string;
+
+    /**
+     * First name
+     */
+    first_name?: string | null;
+
+    /**
+     * Optional phone number used to forward calls
+     */
+    forwarding_number?: string | null;
+
+    /**
+     * Last name
+     */
+    last_name?: string | null;
+
+    /**
+     * Primary identifier for the seat. Pass this on the send endpoints' `seat_id`
+     * parameter.
+     */
+    seat_id?: string;
+  }
+}
+
+export type SeatListResponse = Array<SeatListResponse.SeatListResponseItem>;
+
+export namespace SeatListResponse {
+  export interface SeatListResponseItem {
+    /**
+     * Account name the seat belongs to
+     */
+    account?: string;
+
+    /**
+     * When the seat was created
+     */
+    created_at?: string;
+
+    /**
+     * Email address of the seat user
+     */
+    email?: string;
+
+    /**
+     * First name
+     */
+    first_name?: string | null;
+
+    /**
+     * Optional phone number used to forward calls
+     */
+    forwarding_number?: string | null;
+
+    /**
+     * Last name
+     */
+    last_name?: string | null;
+
+    /**
+     * Primary identifier for the seat. Pass this on the send endpoints' `seat_id`
+     * parameter.
+     */
+    seat_id?: string;
+  }
+}
+
+export interface SeatCountResponse {
+  count?: number;
+}
+
+export interface SeatListParams {
+  /**
+   * Optional exact-match filter on seat email
+   */
+  email?: string;
+
+  /**
+   * Maximum number of seats to return
+   */
+  limit?: number;
+
+  /**
+   * Number of seats to skip
+   */
+  offset?: number;
+}
+
+export interface SeatCountParams {
+  /**
+   * Optional exact-match filter on seat email
+   */
+  email?: string;
+}
+
+export declare namespace Seats {
+  export {
+    type SeatRetrieveResponse as SeatRetrieveResponse,
+    type SeatListResponse as SeatListResponse,
+    type SeatCountResponse as SeatCountResponse,
+    type SeatListParams as SeatListParams,
+    type SeatCountParams as SeatCountParams,
+  };
+}

package/src/resources/v2/v2.ts

@@ -1,15 +1,35 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../core/resource';
+import * as SeatsAPI from './seats';
+import {
+  SeatCountParams,
+  SeatCountResponse,
+  SeatListParams,
+  SeatListResponse,
+  SeatRetrieveResponse,
+  Seats,
+} from './seats';
 import * as TotpAPI from './totp/totp';
 import { Totp, TotpGetCodeResponse } from './totp/totp';
 
 export class V2 extends APIResource {
   totp: TotpAPI.Totp = new TotpAPI.Totp(this._client);
+  seats: SeatsAPI.Seats = new SeatsAPI.Seats(this._client);
 }
 
 V2.Totp = Totp;
+V2.Seats = Seats;
 
 export declare namespace V2 {
   export { Totp as Totp, type TotpGetCodeResponse as TotpGetCodeResponse };
+
+  export {
+    Seats as Seats,
+    type SeatRetrieveResponse as SeatRetrieveResponse,
+    type SeatListResponse as SeatListResponse,
+    type SeatCountResponse as SeatCountResponse,
+    type SeatListParams as SeatListParams,
+    type SeatCountParams as SeatCountParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '3.9.0'; // x-release-please-version
+export const VERSION = '3.9.1'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "3.9.0";
+export declare const VERSION = "3.9.1";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "3.9.0";
+export declare const VERSION = "3.9.1";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '3.9.0'; // x-release-please-version
+exports.VERSION = '3.9.1'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '3.9.0'; // x-release-please-version
+export const VERSION = '3.9.1'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map