sendblue 3.12.0 → 3.14.0

package/resources/verify/verifications.d.ts

@@ -5,9 +5,54 @@ import { RequestOptions } from "../../internal/request-options.js";
  * Sendblue Verify issuance and recovery state
  */
 export declare class Verifications extends APIResource {
+    /**
+     * Creates an inverted-OTP verification for the supplied E.164 phone number. The
+     * user must send the returned code from that exact phone number to the returned
+     * Sendblue destination number.
+     *
+     * Include `hosted` to create an origin-bound Hosted Verify widget session.
+     * Sendblue API credentials must remain on the customer's backend; only the
+     * returned `hosted` values may be sent to the browser. Twilio-compatible clients
+     * may alternatively send the API Key ID and API Secret Key with HTTP Basic
+     * authentication. Temporary bearer authentication is supported for account-scoped
+     * tokens; line-scoped temporary tokens cannot create account-wide Verifications.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.create(
+     *     'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { to: '+14155551212' },
+     *   );
+     * ```
+     */
+    create(serviceSid: string, body: VerificationCreateParams, options?: RequestOptions): APIPromise<VerificationCreateResponse>;
+    /**
+     * Returns the authoritative status for one Verification owned by the authenticated
+     * account. Twilio-compatible clients may send the API Key ID and API Secret Key
+     * with HTTP Basic authentication. Temporary bearer authentication is supported for
+     * account-scoped tokens; line-scoped temporary tokens cannot retrieve account-wide
+     * Verification state.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.retrieve(
+     *     'VRE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { service_sid: 'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD' },
+     *   );
+     * ```
+     */
+    retrieve(verificationSid: string, params: VerificationRetrieveParams, options?: RequestOptions): APIPromise<VerificationRetrieveResponse>;
     /**
      * Account-scoped verification state used to recover terminal Verify events after
      * an SSE gap.
+     *
+     * @example
+     * ```ts
+     * const verifications =
+     *   await client.verify.verifications.list();
+     * ```
      */
     list(query?: VerificationListParams | null | undefined, options?: RequestOptions): APIPromise<VerificationListResponse>;
 }
@@ -21,6 +66,87 @@ export interface VerificationState {
     date_completed?: string | null;
     to?: string | null;
 }
+export interface DeliveryTarget {
+    /**
+     * Code the expected sender must text to `pool_number`.
+     */
+    code: string;
+    /**
+     * Sendblue phone number that should receive the verification code.
+     */
+    pool_number: string;
+    /**
+     * Messages/SMS deep link with the destination and code prefilled.
+     */
+    sms_deep_link: string;
+}
+export interface HostedVerification {
+    /**
+     * Web-component script URL. Load this value exactly as returned.
+     */
+    component_script: string;
+    /**
+     * ISO timestamp when the Verification expires.
+     */
+    expires_at: string;
+    /**
+     * Hosted widget session identifier.
+     */
+    session_id: string;
+    /**
+     * Origin-bound widget URL containing a one-session bearer token in its fragment.
+     * Do not log, persist, or move the token into a query parameter.
+     */
+    url: string;
+}
+export interface VerificationCreateResponse {
+    account_sid: string;
+    channel: 'imessage';
+    date_created: string;
+    date_updated: string;
+    /**
+     * ISO timestamp when the Verification expires.
+     */
+    expires_at: string;
+    service_sid: string;
+    sid: string;
+    status: 'pending' | 'approved' | 'expired' | 'canceled';
+    /**
+     * Expected sender in E.164 format; older durable terminal records may return null.
+     */
+    to: string | null;
+    url: string;
+    /**
+     * Present while the Verification is pending.
+     */
+    delivery_target?: DeliveryTarget;
+    /**
+     * Present only when hosted options were supplied during creation.
+     */
+    hosted?: HostedVerification;
+}
+export interface VerificationRetrieveResponse {
+    account_sid: string;
+    channel: 'imessage';
+    date_created: string;
+    date_updated: string;
+    /**
+     * ISO timestamp when the Verification expires.
+     */
+    expires_at: string;
+    service_sid: string;
+    sid: string;
+    status: 'pending' | 'approved' | 'expired' | 'canceled';
+    /**
+     * Expected sender in E.164 format; older durable terminal records may return null.
+     */
+    to: string | null;
+    url: string;
+    /**
+     * Present while the Verification is pending.
+     */
+    delivery_target?: DeliveryTarget;
+}
 export interface VerificationListResponse {
     data: Array<VerificationState>;
     pagination: VerificationListResponse.Pagination;
@@ -34,12 +160,57 @@ export declare namespace VerificationListResponse {
         offset?: number;
     }
 }
+export interface VerificationCreateParams {
+    /**
+     * E.164 phone number that must send the verification message.
+     */
+    to: string;
+    /**
+     * Options for an origin-bound Hosted Verify widget session. Nested keys are strict
+     * snake_case. `parent_origin` must be an exact HTTPS origin with a DNS hostname.
+     * `127.0.0.1` is also accepted, and HTTP is allowed only for `localhost` or
+     * `127.0.0.1` development origins. Wildcards and other IP literals are rejected
+     * because browsers cannot enforce them as exact CSP `frame-ancestors` sources.
+     */
+    hosted?: VerificationCreateParams.Hosted;
+}
+export declare namespace VerificationCreateParams {
+    /**
+     * Options for an origin-bound Hosted Verify widget session. Nested keys are strict
+     * snake_case. `parent_origin` must be an exact HTTPS origin with a DNS hostname.
+     * `127.0.0.1` is also accepted, and HTTP is allowed only for `localhost` or
+     * `127.0.0.1` development origins. Wildcards and other IP literals are rejected
+     * because browsers cannot enforce them as exact CSP `frame-ancestors` sources.
+     */
+    interface Hosted {
+        /**
+         * Exact website origin allowed to embed the widget, with no path, query, or
+         * fragment.
+         */
+        parent_origin: string;
+        /**
+         * Six-digit hexadecimal accent color.
+         */
+        accent_color?: string;
+        /**
+         * Brand name displayed by the widget. Defaults to Sendblue.
+         */
+        brand_name?: string;
+        theme?: 'light' | 'dark' | 'auto';
+    }
+}
+export interface VerificationRetrieveParams {
+    /**
+     * Verify Service SID.
+     */
+    service_sid: string;
+}
 export interface VerificationListParams {
     limit?: number;
     offset?: number;
     updated_at_gte?: string;
 }
 export declare namespace Verifications {
-    export { type VerificationState as VerificationState, type VerificationListResponse as VerificationListResponse, type VerificationListParams as VerificationListParams, };
+    export { type VerificationState as VerificationState, type DeliveryTarget as DeliveryTarget, type HostedVerification as HostedVerification, type VerificationCreateResponse as VerificationCreateResponse, type VerificationRetrieveResponse as VerificationRetrieveResponse, type VerificationListResponse as VerificationListResponse, type VerificationCreateParams as VerificationCreateParams, type VerificationRetrieveParams as VerificationRetrieveParams, type VerificationListParams as VerificationListParams, };
 }
 //# sourceMappingURL=verifications.d.ts.map

package/resources/verify/verifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verifications.d.ts","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,EAAE,UAAU,EAAE,kCAA+B;AACpD,OAAO,EAAE,cAAc,EAAE,0CAAuC;AAEhE;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C;;;OAGG;IACH,IAAI,CACF,KAAK,GAAE,sBAAsB,GAAG,IAAI,GAAG,SAAc,EACrD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,wBAAwB,CAAC;CAGxC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAEhB,YAAY,EAAE,MAAM,CAAC;IAErB,YAAY,EAAE,MAAM,CAAC;IAErB,WAAW,EAAE,MAAM,CAAC;IAEpB,GAAG,EAAE,MAAM,CAAC;IAEZ,MAAM,EAAE,MAAM,CAAC;IAEf,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAE/B,UAAU,EAAE,wBAAwB,CAAC,UAAU,CAAC;IAEhD,MAAM,EAAE,IAAI,CAAC;CACd;AAED,yBAAiB,wBAAwB,CAAC;IACxC,UAAiB,UAAU;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,QAAQ,CAAC,EAAE,OAAO,CAAC;QAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;QAEf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,CAAC,OAAO,WAAW,aAAa,CAAC;IACrC,OAAO,EACL,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"verifications.d.ts","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":"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"}

package/resources/verify/verifications.js

@@ -3,13 +3,64 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Verifications = void 0;
 const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
 /**
  * Sendblue Verify issuance and recovery state
  */
 class Verifications extends resource_1.APIResource {
+    /**
+     * Creates an inverted-OTP verification for the supplied E.164 phone number. The
+     * user must send the returned code from that exact phone number to the returned
+     * Sendblue destination number.
+     *
+     * Include `hosted` to create an origin-bound Hosted Verify widget session.
+     * Sendblue API credentials must remain on the customer's backend; only the
+     * returned `hosted` values may be sent to the browser. Twilio-compatible clients
+     * may alternatively send the API Key ID and API Secret Key with HTTP Basic
+     * authentication. Temporary bearer authentication is supported for account-scoped
+     * tokens; line-scoped temporary tokens cannot create account-wide Verifications.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.create(
+     *     'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { to: '+14155551212' },
+     *   );
+     * ```
+     */
+    create(serviceSid, body, options) {
+        return this._client.post((0, path_1.path) `/api/v2/verify/services/${serviceSid}/verifications`, { body, ...options });
+    }
+    /**
+     * Returns the authoritative status for one Verification owned by the authenticated
+     * account. Twilio-compatible clients may send the API Key ID and API Secret Key
+     * with HTTP Basic authentication. Temporary bearer authentication is supported for
+     * account-scoped tokens; line-scoped temporary tokens cannot retrieve account-wide
+     * Verification state.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.retrieve(
+     *     'VRE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { service_sid: 'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD' },
+     *   );
+     * ```
+     */
+    retrieve(verificationSid, params, options) {
+        const { service_sid } = params;
+        return this._client.get((0, path_1.path) `/api/v2/verify/services/${service_sid}/verifications/${verificationSid}`, options);
+    }
     /**
      * Account-scoped verification state used to recover terminal Verify events after
      * an SSE gap.
+     *
+     * @example
+     * ```ts
+     * const verifications =
+     *   await client.verify.verifications.list();
+     * ```
      */
     list(query = {}, options) {
         return this._client.get('/api/v2/verify/verifications', { query, ...options });

package/resources/verify/verifications.js.map

@@ -1 +1 @@
-{"version":3,"file":"verifications.js","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD;;GAEG;AACH,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;OAGG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF;AAXD,sCAWC"}
+{"version":3,"file":"verifications.js","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAGlD,uDAAiD;AAEjD;;GAEG;AACH,MAAa,aAAc,SAAQ,sBAAW;IAC5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACJ,UAAkB,EAClB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,2BAA2B,UAAU,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CACN,eAAuB,EACvB,MAAkC,EAClC,OAAwB;QAExB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,IAAA,WAAI,EAAA,2BAA2B,WAAW,kBAAkB,eAAe,EAAE,EAC7E,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF;AA1ED,sCA0EC"}

package/resources/verify/verifications.mjs

@@ -1,12 +1,63 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
+import { path } from "../../internal/utils/path.mjs";
 /**
  * Sendblue Verify issuance and recovery state
  */
 export class Verifications extends APIResource {
+    /**
+     * Creates an inverted-OTP verification for the supplied E.164 phone number. The
+     * user must send the returned code from that exact phone number to the returned
+     * Sendblue destination number.
+     *
+     * Include `hosted` to create an origin-bound Hosted Verify widget session.
+     * Sendblue API credentials must remain on the customer's backend; only the
+     * returned `hosted` values may be sent to the browser. Twilio-compatible clients
+     * may alternatively send the API Key ID and API Secret Key with HTTP Basic
+     * authentication. Temporary bearer authentication is supported for account-scoped
+     * tokens; line-scoped temporary tokens cannot create account-wide Verifications.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.create(
+     *     'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { to: '+14155551212' },
+     *   );
+     * ```
+     */
+    create(serviceSid, body, options) {
+        return this._client.post(path `/api/v2/verify/services/${serviceSid}/verifications`, { body, ...options });
+    }
+    /**
+     * Returns the authoritative status for one Verification owned by the authenticated
+     * account. Twilio-compatible clients may send the API Key ID and API Secret Key
+     * with HTTP Basic authentication. Temporary bearer authentication is supported for
+     * account-scoped tokens; line-scoped temporary tokens cannot retrieve account-wide
+     * Verification state.
+     *
+     * @example
+     * ```ts
+     * const verification =
+     *   await client.verify.verifications.retrieve(
+     *     'VRE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD',
+     *     { service_sid: 'SVE1CB97d8EBbDbaAae6d9B1ca0D1cFaAD' },
+     *   );
+     * ```
+     */
+    retrieve(verificationSid, params, options) {
+        const { service_sid } = params;
+        return this._client.get(path `/api/v2/verify/services/${service_sid}/verifications/${verificationSid}`, options);
+    }
     /**
      * Account-scoped verification state used to recover terminal Verify events after
      * an SSE gap.
+     *
+     * @example
+     * ```ts
+     * const verifications =
+     *   await client.verify.verifications.list();
+     * ```
      */
     list(query = {}, options) {
         return this._client.get('/api/v2/verify/verifications', { query, ...options });

package/resources/verify/verifications.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"verifications.mjs","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAIlD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;OAGG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}
+{"version":3,"file":"verifications.mjs","sourceRoot":"","sources":["../../src/resources/verify/verifications.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAGlD,OAAO,EAAE,IAAI,EAAE,sCAAkC;AAEjD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,MAAM,CACJ,UAAkB,EAClB,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,2BAA2B,UAAU,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CACN,eAAuB,EACvB,MAAkC,EAClC,OAAwB;QAExB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CACrB,IAAI,CAAA,2BAA2B,WAAW,kBAAkB,eAAe,EAAE,EAC7E,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;;;;;;;;OASG;IACH,IAAI,CACF,QAAmD,EAAE,EACrD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjF,CAAC;CACF"}

package/resources/verify/verify.d.mts

@@ -1,10 +1,10 @@
 import { APIResource } from "../../core/resource.mjs";
 import * as VerificationsAPI from "./verifications.mjs";
-import { VerificationListParams, VerificationListResponse, VerificationState, Verifications } from "./verifications.mjs";
+import { DeliveryTarget, HostedVerification, VerificationCreateParams, VerificationCreateResponse, VerificationListParams, VerificationListResponse, VerificationRetrieveParams, VerificationRetrieveResponse, VerificationState, Verifications } from "./verifications.mjs";
 export declare class Verify extends APIResource {
     verifications: VerificationsAPI.Verifications;
 }
 export declare namespace Verify {
-    export { Verifications as Verifications, type VerificationState as VerificationState, type VerificationListResponse as VerificationListResponse, type VerificationListParams as VerificationListParams, };
+    export { Verifications as Verifications, type VerificationState as VerificationState, type DeliveryTarget as DeliveryTarget, type HostedVerification as HostedVerification, type VerificationCreateResponse as VerificationCreateResponse, type VerificationRetrieveResponse as VerificationRetrieveResponse, type VerificationListResponse as VerificationListResponse, type VerificationCreateParams as VerificationCreateParams, type VerificationRetrieveParams as VerificationRetrieveParams, type VerificationListParams as VerificationListParams, };
 }
 //# sourceMappingURL=verify.d.mts.map

package/resources/verify/verify.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.mts","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAwB;AACpD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACd,4BAAwB;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"verify.d.mts","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAwB;AACpD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACd,4BAAwB;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/verify/verify.d.ts

@@ -1,10 +1,10 @@
 import { APIResource } from "../../core/resource.js";
 import * as VerificationsAPI from "./verifications.js";
-import { VerificationListParams, VerificationListResponse, VerificationState, Verifications } from "./verifications.js";
+import { DeliveryTarget, HostedVerification, VerificationCreateParams, VerificationCreateResponse, VerificationListParams, VerificationListResponse, VerificationRetrieveParams, VerificationRetrieveResponse, VerificationState, Verifications } from "./verifications.js";
 export declare class Verify extends APIResource {
     verifications: VerificationsAPI.Verifications;
 }
 export declare namespace Verify {
-    export { Verifications as Verifications, type VerificationState as VerificationState, type VerificationListResponse as VerificationListResponse, type VerificationListParams as VerificationListParams, };
+    export { Verifications as Verifications, type VerificationState as VerificationState, type DeliveryTarget as DeliveryTarget, type HostedVerification as HostedVerification, type VerificationCreateResponse as VerificationCreateResponse, type VerificationRetrieveResponse as VerificationRetrieveResponse, type VerificationListResponse as VerificationListResponse, type VerificationCreateParams as VerificationCreateParams, type VerificationRetrieveParams as VerificationRetrieveParams, type VerificationListParams as VerificationListParams, };
 }
 //# sourceMappingURL=verify.d.ts.map

package/resources/verify/verify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,gBAAgB,2BAAwB;AACpD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EACjB,aAAa,EACd,2BAAwB;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,+BAA4B;AAClD,OAAO,KAAK,gBAAgB,2BAAwB;AACpD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,EACjB,aAAa,EACd,2BAAwB;AAEzB,qBAAa,MAAO,SAAQ,WAAW;IACrC,aAAa,EAAE,gBAAgB,CAAC,aAAa,CAAoD;CAClG;AAID,MAAM,CAAC,OAAO,WAAW,MAAM,CAAC;IAC9B,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,4BAA4B,IAAI,4BAA4B,EACjE,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,0BAA0B,IAAI,0BAA0B,EAC7D,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/verify/verify.js.map

@@ -1 +1 @@
-{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6EAAoD;AACpD,sDAKyB;AAEzB,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAFD,wBAEC;AAED,MAAM,CAAC,aAAa,GAAG,6BAAa,CAAC"}
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6EAAoD;AACpD,sDAWyB;AAEzB,MAAa,MAAO,SAAQ,sBAAW;IAAvC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAFD,wBAEC;AAED,MAAM,CAAC,aAAa,GAAG,6BAAa,CAAC"}

package/resources/verify/verify.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"verify.mjs","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAwB;AACpD,OAAO,EAIL,aAAa,GACd,4BAAwB;AAEzB,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAED,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC"}
+{"version":3,"file":"verify.mjs","sourceRoot":"","sources":["../../src/resources/verify/verify.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,WAAW,EAAE,gCAA4B;AAClD,OAAO,KAAK,gBAAgB,4BAAwB;AACpD,OAAO,EAUL,aAAa,GACd,4BAAwB;AAEzB,MAAM,OAAO,MAAO,SAAQ,WAAW;IAAvC;;QACE,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAED,MAAM,CAAC,aAAa,GAAG,aAAa,CAAC"}

package/src/resources/groups.ts

@@ -10,7 +10,12 @@ import { RequestOptions } from '../internal/request-options';
  */
 export class Groups extends APIResource {
   /**
-   * Add or manage participants in a group chat (beta feature)
+   * Add an external participant to, or remove one from, an existing iMessage group
+   * chat (beta feature). Success is reported only after the change is verified on
+   * the device: the group's persisted membership changed and Sendblue's participant
+   * state matches it. Removal requires the group to have at least four total members
+   * before the operation and does not require the group's creator. Only iMessage
+   * groups are supported.
    *
    * @example
    * ```ts
@@ -45,7 +50,15 @@ export class Groups extends APIResource {
 }
 
 export interface GroupModifyResponse {
-  message?: string;
+  error?: string | null;
+
+  error_message?: string | null;
+
+  group_id?: string;
+
+  modify_type?: string;
+
+  number?: string;
 
   status?: string;
 }
@@ -59,12 +72,23 @@ export interface GroupModifyParams {
   /**
    * Type of modification to perform
    */
-  modify_type: 'add_recipient';
+  modify_type: 'add_recipient' | 'remove_recipient';
 
   /**
-   * Phone number to add/modify in E.164 format
+   * External participant to add or remove, in E.164 format (or an iMessage email
+   * address). Company-owned lines cannot be added or removed.
    */
   number: string;
+
+  /**
+   * The Sendblue line to act from. It must belong to the account and already be a
+   * participant of the group. Free API accounts must provide it. Other accounts may
+   * omit it only when exactly one account line participates in the group. With no
+   * participating account line the request fails with `line_not_registered`; with
+   * multiple lines it fails with `ambiguous_sending_line`. No change is attempted in
+   * either case.
+   */
+  from_number?: string;
 }
 
 export interface GroupSendMessageParams {

package/src/resources/v2/groups/groups.ts

@@ -0,0 +1,114 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as VerifyAPI from './verify/verify';
+import { Verify } from './verify/verify';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+/**
+ * Operations for group messaging (beta)
+ */
+export class Groups extends APIResource {
+  verify: VerifyAPI.Verify = new VerifyAPI.Verify(this._client);
+
+  /**
+   * Retrieve the current complete membership for a group owned by the authenticated
+   * account.
+   *
+   * @example
+   * ```ts
+   * const group = await client.v2.groups.retrieve(
+   *   'sb_group_608acc54-d0d7-4b41-8092-9ff6e1e70455',
+   * );
+   * ```
+   */
+  retrieve(groupID: string, options?: RequestOptions): APIPromise<GroupRetrieveResponse> {
+    return this._client.get(path`/api/v2/groups/${groupID}`, options);
+  }
+}
+
+export interface GroupRetrieveResponse {
+  data?: GroupRetrieveResponse.Data;
+
+  status?: string;
+}
+
+export namespace GroupRetrieveResponse {
+  export interface Data {
+    created_at?: string;
+
+    group_id?: string;
+
+    group_name?: string;
+
+    latest_comm_at?: string | null;
+
+    latest_message_id?: string | null;
+
+    /**
+     * Convenience list of resolved participant phone numbers. Participants with
+     * email-only handles remain in participants but are omitted here.
+     */
+    participant_numbers?: Array<string>;
+
+    participants?: Array<Data.Participant>;
+
+    updated_at?: string;
+
+    /**
+     * Worker-local iMessage group identifier when known
+     */
+    worker_group_id?: string | null;
+  }
+
+  export namespace Data {
+    export interface Participant {
+      /**
+       * Contact ID when this participant is linked to a contact
+       */
+      contact_id?: string | null;
+
+      /**
+       * Raw participant handle, usually an E.164 phone number but sometimes an iMessage
+       * email handle
+       */
+      handle?: string | null;
+
+      /**
+       * Contact or seat display name when available
+       */
+      name?: string | null;
+
+      /**
+       * Unique participant row identifier
+       */
+      participant_id?: string;
+
+      /**
+       * Resolved participant phone number, preferring the stored group phone handle and
+       * falling back to contact phone. Email handles remain available in handle.
+       */
+      phone?: string | null;
+
+      /**
+       * Seat ID when this participant is a team member
+       */
+      seat_id?: string | null;
+
+      /**
+       * Participant kind
+       */
+      type?: 'contact' | 'seat';
+    }
+  }
+}
+
+Groups.Verify = Verify;
+
+export declare namespace Groups {
+  export { type GroupRetrieveResponse as GroupRetrieveResponse };
+
+  export { Verify as Verify };
+}

package/src/resources/v2/groups/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Groups, type GroupRetrieveResponse } from './groups';
+export { Verify } from './verify/index';

package/src/resources/v2/groups/verify/index.ts

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Services } from './services/index';
+export { Verify } from './verify';

package/src/resources/v2/groups/verify/services/index.ts

@@ -0,0 +1,10 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Services } from './services';
+export {
+  Verifications,
+  type VerificationCreateResponse,
+  type VerificationRetrieveResponse,
+  type VerificationCreateParams,
+  type VerificationRetrieveParams,
+} from './verifications';

package/src/resources/v2/groups/verify/services/services.ts

@@ -0,0 +1,27 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as VerificationsAPI from './verifications';
+import {
+  VerificationCreateParams,
+  VerificationCreateResponse,
+  VerificationRetrieveParams,
+  VerificationRetrieveResponse,
+  Verifications,
+} from './verifications';
+
+export class Services extends APIResource {
+  verifications: VerificationsAPI.Verifications = new VerificationsAPI.Verifications(this._client);
+}
+
+Services.Verifications = Verifications;
+
+export declare namespace Services {
+  export {
+    Verifications as Verifications,
+    type VerificationCreateResponse as VerificationCreateResponse,
+    type VerificationRetrieveResponse as VerificationRetrieveResponse,
+    type VerificationCreateParams as VerificationCreateParams,
+    type VerificationRetrieveParams as VerificationRetrieveParams,
+  };
+}