@zavudev/sdk 0.17.0 → 0.18.0

package/resources/senders/senders.d.mts

@@ -0,0 +1,342 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as AgentAPI from "./agent/agent.mjs";
+import { Agent, AgentCreateParams, AgentExecution, AgentExecutionStatus, AgentProvider, AgentResource, AgentResponse, AgentStats, AgentUpdateParams } from "./agent/agent.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Senders extends APIResource {
+    agent: AgentAPI.AgentResource;
+    /**
+     * Create sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.create({
+     *   name: 'name',
+     *   phoneNumber: 'phoneNumber',
+     * });
+     * ```
+     */
+    create(body: SenderCreateParams, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * Get sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.retrieve('senderId');
+     * ```
+     */
+    retrieve(senderID: string, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * Update sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.update('senderId');
+     * ```
+     */
+    update(senderID: string, body: SenderUpdateParams, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * List senders
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const sender of client.senders.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: SenderListParams | null | undefined, options?: RequestOptions): PagePromise<SendersCursor, Sender>;
+    /**
+     * Delete sender
+     *
+     * @example
+     * ```ts
+     * await client.senders.delete('senderId');
+     * ```
+     */
+    delete(senderID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get the WhatsApp Business profile for a sender. The sender must have a WhatsApp
+     * Business Account connected.
+     *
+     * @example
+     * ```ts
+     * const whatsappBusinessProfileResponse =
+     *   await client.senders.getProfile('senderId');
+     * ```
+     */
+    getProfile(senderID: string, options?: RequestOptions): APIPromise<WhatsappBusinessProfileResponse>;
+    /**
+     * Regenerate the webhook secret for a sender. The old secret will be invalidated
+     * immediately.
+     *
+     * @example
+     * ```ts
+     * const webhookSecretResponse =
+     *   await client.senders.regenerateWebhookSecret('senderId');
+     * ```
+     */
+    regenerateWebhookSecret(senderID: string, options?: RequestOptions): APIPromise<WebhookSecretResponse>;
+    /**
+     * Update the WhatsApp Business profile for a sender. The sender must have a
+     * WhatsApp Business Account connected.
+     *
+     * @example
+     * ```ts
+     * const response = await client.senders.updateProfile(
+     *   'senderId',
+     *   {
+     *     about: 'Succulent specialists!',
+     *     description:
+     *       'We specialize in providing high-quality succulents.',
+     *     email: 'contact@example.com',
+     *     vertical: 'RETAIL',
+     *     websites: ['https://www.example.com'],
+     *   },
+     * );
+     * ```
+     */
+    updateProfile(senderID: string, body: SenderUpdateProfileParams, options?: RequestOptions): APIPromise<SenderUpdateProfileResponse>;
+    /**
+     * Upload a new profile picture for the WhatsApp Business profile. The image will
+     * be uploaded to Meta and set as the profile picture.
+     *
+     * @example
+     * ```ts
+     * const response = await client.senders.uploadProfilePicture(
+     *   'senderId',
+     *   {
+     *     imageUrl: 'https://example.com/profile.jpg',
+     *     mimeType: 'image/jpeg',
+     *   },
+     * );
+     * ```
+     */
+    uploadProfilePicture(senderID: string, body: SenderUploadProfilePictureParams, options?: RequestOptions): APIPromise<SenderUploadProfilePictureResponse>;
+}
+export type SendersCursor = Cursor<Sender>;
+export interface Sender {
+    id: string;
+    name: string;
+    /**
+     * Phone number in E.164 format.
+     */
+    phoneNumber: string;
+    createdAt?: string;
+    /**
+     * Whether this sender is the project's default.
+     */
+    isDefault?: boolean;
+    updatedAt?: string;
+    /**
+     * Webhook configuration for the sender.
+     */
+    webhook?: SenderWebhook;
+    /**
+     * WhatsApp Business Account information. Only present if a WABA is connected.
+     */
+    whatsapp?: Sender.Whatsapp;
+}
+export declare namespace Sender {
+    /**
+     * WhatsApp Business Account information. Only present if a WABA is connected.
+     */
+    interface Whatsapp {
+        /**
+         * Display phone number.
+         */
+        displayPhoneNumber?: string;
+        /**
+         * Payment configuration status from Meta.
+         */
+        paymentStatus?: Whatsapp.PaymentStatus;
+        /**
+         * WhatsApp phone number ID from Meta.
+         */
+        phoneNumberId?: string;
+    }
+    namespace Whatsapp {
+        /**
+         * Payment configuration status from Meta.
+         */
+        interface PaymentStatus {
+            /**
+             * Whether template messages can be sent. Requires setupStatus=COMPLETE and
+             * methodStatus=VALID.
+             */
+            canSendTemplates?: boolean;
+            /**
+             * Payment method status (VALID, NONE, etc.).
+             */
+            methodStatus?: string;
+            /**
+             * Payment setup status (COMPLETE, NOT_STARTED, etc.).
+             */
+            setupStatus?: string;
+        }
+    }
+}
+/**
+ * Webhook configuration for the sender.
+ */
+export interface SenderWebhook {
+    /**
+     * Whether the webhook is active.
+     */
+    active: boolean;
+    /**
+     * List of events the webhook is subscribed to.
+     */
+    events: Array<WebhookEvent>;
+    /**
+     * HTTPS URL that will receive webhook events.
+     */
+    url: string;
+    /**
+     * Webhook secret for signature verification. Only returned on create or
+     * regenerate.
+     */
+    secret?: string;
+}
+/**
+ * Type of event that triggers the webhook. Note: Reactions are delivered as
+ * message.inbound with messageType='reaction'.
+ */
+export type WebhookEvent = 'message.queued' | 'message.sent' | 'message.delivered' | 'message.failed' | 'message.inbound' | 'message.unsupported' | 'conversation.new' | 'template.status_changed';
+export interface WebhookSecretResponse {
+    /**
+     * The new webhook secret.
+     */
+    secret: string;
+}
+/**
+ * WhatsApp Business profile information.
+ */
+export interface WhatsappBusinessProfile {
+    /**
+     * Short description of the business (max 139 characters).
+     */
+    about?: string;
+    /**
+     * Physical address of the business (max 256 characters).
+     */
+    address?: string;
+    /**
+     * Extended description of the business (max 512 characters).
+     */
+    description?: string;
+    /**
+     * Business email address.
+     */
+    email?: string;
+    /**
+     * URL of the business profile picture.
+     */
+    profilePictureUrl?: string;
+    /**
+     * Business category for WhatsApp Business profile.
+     */
+    vertical?: WhatsappBusinessProfileVertical;
+    /**
+     * Business website URLs (maximum 2).
+     */
+    websites?: Array<string>;
+}
+export interface WhatsappBusinessProfileResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+}
+/**
+ * Business category for WhatsApp Business profile.
+ */
+export type WhatsappBusinessProfileVertical = 'UNDEFINED' | 'OTHER' | 'AUTO' | 'BEAUTY' | 'APPAREL' | 'EDU' | 'ENTERTAIN' | 'EVENT_PLAN' | 'FINANCE' | 'GROCERY' | 'GOVT' | 'HOTEL' | 'HEALTH' | 'NONPROFIT' | 'PROF_SERVICES' | 'RETAIL' | 'TRAVEL' | 'RESTAURANT' | 'NOT_A_BIZ';
+export interface SenderUpdateProfileResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+    success: boolean;
+}
+export interface SenderUploadProfilePictureResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+    success: boolean;
+}
+export interface SenderCreateParams {
+    name: string;
+    phoneNumber: string;
+    setAsDefault?: boolean;
+    /**
+     * Events to subscribe to.
+     */
+    webhookEvents?: Array<WebhookEvent>;
+    /**
+     * HTTPS URL for webhook events.
+     */
+    webhookUrl?: string;
+}
+export interface SenderUpdateParams {
+    name?: string;
+    setAsDefault?: boolean;
+    /**
+     * Whether the webhook is active.
+     */
+    webhookActive?: boolean;
+    /**
+     * Events to subscribe to.
+     */
+    webhookEvents?: Array<WebhookEvent>;
+    /**
+     * HTTPS URL for webhook events. Set to null to remove webhook.
+     */
+    webhookUrl?: string | null;
+}
+export interface SenderListParams extends CursorParams {
+}
+export interface SenderUpdateProfileParams {
+    /**
+     * Short description of the business (max 139 characters).
+     */
+    about?: string;
+    /**
+     * Physical address of the business (max 256 characters).
+     */
+    address?: string;
+    /**
+     * Extended description of the business (max 512 characters).
+     */
+    description?: string;
+    /**
+     * Business email address.
+     */
+    email?: string;
+    /**
+     * Business category for WhatsApp Business profile.
+     */
+    vertical?: WhatsappBusinessProfileVertical;
+    /**
+     * Business website URLs (maximum 2).
+     */
+    websites?: Array<string>;
+}
+export interface SenderUploadProfilePictureParams {
+    /**
+     * URL of the image to upload.
+     */
+    imageUrl: string;
+    /**
+     * MIME type of the image.
+     */
+    mimeType: 'image/jpeg' | 'image/png';
+}
+export declare namespace Senders {
+    export { type Sender as Sender, type SenderWebhook as SenderWebhook, type WebhookEvent as WebhookEvent, type WebhookSecretResponse as WebhookSecretResponse, type WhatsappBusinessProfile as WhatsappBusinessProfile, type WhatsappBusinessProfileResponse as WhatsappBusinessProfileResponse, type WhatsappBusinessProfileVertical as WhatsappBusinessProfileVertical, type SenderUpdateProfileResponse as SenderUpdateProfileResponse, type SenderUploadProfilePictureResponse as SenderUploadProfilePictureResponse, type SendersCursor as SendersCursor, type SenderCreateParams as SenderCreateParams, type SenderUpdateParams as SenderUpdateParams, type SenderListParams as SenderListParams, type SenderUpdateProfileParams as SenderUpdateProfileParams, type SenderUploadProfilePictureParams as SenderUploadProfilePictureParams, };
+    export { AgentResource as AgentResource, type Agent as Agent, type AgentExecution as AgentExecution, type AgentExecutionStatus as AgentExecutionStatus, type AgentProvider as AgentProvider, type AgentResponse as AgentResponse, type AgentStats as AgentStats, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, };
+}
+//# sourceMappingURL=senders.d.mts.map

package/resources/senders/senders.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senders.d.mts","sourceRoot":"","sources":["../../src/resources/senders/senders.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EACL,KAAK,EACL,iBAAiB,EACjB,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,aAAa,EACb,UAAU,EACV,iBAAiB,EAClB;OACM,EAAE,UAAU,EAAE;OACd,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,WAAW,EAAE;OAE1C,EAAE,cAAc,EAAE;AAGzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAA4C;IAEzE;;;;;;;;;;OAUG;IACH,MAAM,CAAC,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAI9E;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAIxE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC;IAIhG;;;;;;;;;;OAUG;IACH,IAAI,CACF,KAAK,GAAE,gBAAgB,GAAG,IAAI,GAAG,SAAc,EAC/C,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC;IAIrC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;IAOpE;;;;;;;;;OASG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,+BAA+B,CAAC;IAInG;;;;;;;;;OASG;IACH,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;IAItG;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,yBAAyB,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,2BAA2B,CAAC;IAI1C;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,gCAAgC,EACtC,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kCAAkC,CAAC;CAGlD;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IAEX,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CAC5B;AAED,yBAAiB,MAAM,CAAC;IACtB;;OAEG;IACH,UAAiB,QAAQ;QACvB;;WAEG;QACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAE5B;;WAEG;QACH,aAAa,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC;QAEvC;;WAEG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;IAED,UAAiB,QAAQ,CAAC;QACxB;;WAEG;QACH,UAAiB,aAAa;YAC5B;;;eAGG;YACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;YAE3B;;eAEG;YACH,YAAY,CAAC,EAAE,MAAM,CAAC;YAEtB;;eAEG;YACH,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB;KACF;CACF;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAE5B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,gBAAgB,GAChB,iBAAiB,GACjB,qBAAqB,GACrB,kBAAkB,GAClB,yBAAyB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,OAAO,EAAE,uBAAuB,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,+BAA+B,GACvC,WAAW,GACX,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,KAAK,GACL,WAAW,GACX,YAAY,GACZ,SAAS,GACT,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,WAAW,GACX,eAAe,GACf,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,OAAO,EAAE,uBAAuB,CAAC;IAEjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kCAAkC;IACjD;;OAEG;IACH,OAAO,EAAE,uBAAuB,CAAC;IAEjC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAEpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAEpC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAiB,SAAQ,YAAY;CAAG;AAEzD,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,+BAA+B,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,YAAY,GAAG,WAAW,CAAC;CACtC;AAID,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,YAAY,IAAI,YAAY,EACjC,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,2BAA2B,IAAI,2BAA2B,EAC/D,KAAK,kCAAkC,IAAI,kCAAkC,EAC7E,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,yBAAyB,IAAI,yBAAyB,EAC3D,KAAK,gCAAgC,IAAI,gCAAgC,GAC1E,CAAC;IAEF,OAAO,EACL,aAAa,IAAI,aAAa,EAC9B,KAAK,KAAK,IAAI,KAAK,EACnB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,aAAa,IAAI,aAAa,EACnC,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}

package/resources/senders/senders.d.ts

@@ -0,0 +1,342 @@
+import { APIResource } from "../../core/resource.js";
+import * as AgentAPI from "./agent/agent.js";
+import { Agent, AgentCreateParams, AgentExecution, AgentExecutionStatus, AgentProvider, AgentResource, AgentResponse, AgentStats, AgentUpdateParams } from "./agent/agent.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { Cursor, type CursorParams, PagePromise } from "../../core/pagination.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Senders extends APIResource {
+    agent: AgentAPI.AgentResource;
+    /**
+     * Create sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.create({
+     *   name: 'name',
+     *   phoneNumber: 'phoneNumber',
+     * });
+     * ```
+     */
+    create(body: SenderCreateParams, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * Get sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.retrieve('senderId');
+     * ```
+     */
+    retrieve(senderID: string, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * Update sender
+     *
+     * @example
+     * ```ts
+     * const sender = await client.senders.update('senderId');
+     * ```
+     */
+    update(senderID: string, body: SenderUpdateParams, options?: RequestOptions): APIPromise<Sender>;
+    /**
+     * List senders
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const sender of client.senders.list()) {
+     *   // ...
+     * }
+     * ```
+     */
+    list(query?: SenderListParams | null | undefined, options?: RequestOptions): PagePromise<SendersCursor, Sender>;
+    /**
+     * Delete sender
+     *
+     * @example
+     * ```ts
+     * await client.senders.delete('senderId');
+     * ```
+     */
+    delete(senderID: string, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Get the WhatsApp Business profile for a sender. The sender must have a WhatsApp
+     * Business Account connected.
+     *
+     * @example
+     * ```ts
+     * const whatsappBusinessProfileResponse =
+     *   await client.senders.getProfile('senderId');
+     * ```
+     */
+    getProfile(senderID: string, options?: RequestOptions): APIPromise<WhatsappBusinessProfileResponse>;
+    /**
+     * Regenerate the webhook secret for a sender. The old secret will be invalidated
+     * immediately.
+     *
+     * @example
+     * ```ts
+     * const webhookSecretResponse =
+     *   await client.senders.regenerateWebhookSecret('senderId');
+     * ```
+     */
+    regenerateWebhookSecret(senderID: string, options?: RequestOptions): APIPromise<WebhookSecretResponse>;
+    /**
+     * Update the WhatsApp Business profile for a sender. The sender must have a
+     * WhatsApp Business Account connected.
+     *
+     * @example
+     * ```ts
+     * const response = await client.senders.updateProfile(
+     *   'senderId',
+     *   {
+     *     about: 'Succulent specialists!',
+     *     description:
+     *       'We specialize in providing high-quality succulents.',
+     *     email: 'contact@example.com',
+     *     vertical: 'RETAIL',
+     *     websites: ['https://www.example.com'],
+     *   },
+     * );
+     * ```
+     */
+    updateProfile(senderID: string, body: SenderUpdateProfileParams, options?: RequestOptions): APIPromise<SenderUpdateProfileResponse>;
+    /**
+     * Upload a new profile picture for the WhatsApp Business profile. The image will
+     * be uploaded to Meta and set as the profile picture.
+     *
+     * @example
+     * ```ts
+     * const response = await client.senders.uploadProfilePicture(
+     *   'senderId',
+     *   {
+     *     imageUrl: 'https://example.com/profile.jpg',
+     *     mimeType: 'image/jpeg',
+     *   },
+     * );
+     * ```
+     */
+    uploadProfilePicture(senderID: string, body: SenderUploadProfilePictureParams, options?: RequestOptions): APIPromise<SenderUploadProfilePictureResponse>;
+}
+export type SendersCursor = Cursor<Sender>;
+export interface Sender {
+    id: string;
+    name: string;
+    /**
+     * Phone number in E.164 format.
+     */
+    phoneNumber: string;
+    createdAt?: string;
+    /**
+     * Whether this sender is the project's default.
+     */
+    isDefault?: boolean;
+    updatedAt?: string;
+    /**
+     * Webhook configuration for the sender.
+     */
+    webhook?: SenderWebhook;
+    /**
+     * WhatsApp Business Account information. Only present if a WABA is connected.
+     */
+    whatsapp?: Sender.Whatsapp;
+}
+export declare namespace Sender {
+    /**
+     * WhatsApp Business Account information. Only present if a WABA is connected.
+     */
+    interface Whatsapp {
+        /**
+         * Display phone number.
+         */
+        displayPhoneNumber?: string;
+        /**
+         * Payment configuration status from Meta.
+         */
+        paymentStatus?: Whatsapp.PaymentStatus;
+        /**
+         * WhatsApp phone number ID from Meta.
+         */
+        phoneNumberId?: string;
+    }
+    namespace Whatsapp {
+        /**
+         * Payment configuration status from Meta.
+         */
+        interface PaymentStatus {
+            /**
+             * Whether template messages can be sent. Requires setupStatus=COMPLETE and
+             * methodStatus=VALID.
+             */
+            canSendTemplates?: boolean;
+            /**
+             * Payment method status (VALID, NONE, etc.).
+             */
+            methodStatus?: string;
+            /**
+             * Payment setup status (COMPLETE, NOT_STARTED, etc.).
+             */
+            setupStatus?: string;
+        }
+    }
+}
+/**
+ * Webhook configuration for the sender.
+ */
+export interface SenderWebhook {
+    /**
+     * Whether the webhook is active.
+     */
+    active: boolean;
+    /**
+     * List of events the webhook is subscribed to.
+     */
+    events: Array<WebhookEvent>;
+    /**
+     * HTTPS URL that will receive webhook events.
+     */
+    url: string;
+    /**
+     * Webhook secret for signature verification. Only returned on create or
+     * regenerate.
+     */
+    secret?: string;
+}
+/**
+ * Type of event that triggers the webhook. Note: Reactions are delivered as
+ * message.inbound with messageType='reaction'.
+ */
+export type WebhookEvent = 'message.queued' | 'message.sent' | 'message.delivered' | 'message.failed' | 'message.inbound' | 'message.unsupported' | 'conversation.new' | 'template.status_changed';
+export interface WebhookSecretResponse {
+    /**
+     * The new webhook secret.
+     */
+    secret: string;
+}
+/**
+ * WhatsApp Business profile information.
+ */
+export interface WhatsappBusinessProfile {
+    /**
+     * Short description of the business (max 139 characters).
+     */
+    about?: string;
+    /**
+     * Physical address of the business (max 256 characters).
+     */
+    address?: string;
+    /**
+     * Extended description of the business (max 512 characters).
+     */
+    description?: string;
+    /**
+     * Business email address.
+     */
+    email?: string;
+    /**
+     * URL of the business profile picture.
+     */
+    profilePictureUrl?: string;
+    /**
+     * Business category for WhatsApp Business profile.
+     */
+    vertical?: WhatsappBusinessProfileVertical;
+    /**
+     * Business website URLs (maximum 2).
+     */
+    websites?: Array<string>;
+}
+export interface WhatsappBusinessProfileResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+}
+/**
+ * Business category for WhatsApp Business profile.
+ */
+export type WhatsappBusinessProfileVertical = 'UNDEFINED' | 'OTHER' | 'AUTO' | 'BEAUTY' | 'APPAREL' | 'EDU' | 'ENTERTAIN' | 'EVENT_PLAN' | 'FINANCE' | 'GROCERY' | 'GOVT' | 'HOTEL' | 'HEALTH' | 'NONPROFIT' | 'PROF_SERVICES' | 'RETAIL' | 'TRAVEL' | 'RESTAURANT' | 'NOT_A_BIZ';
+export interface SenderUpdateProfileResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+    success: boolean;
+}
+export interface SenderUploadProfilePictureResponse {
+    /**
+     * WhatsApp Business profile information.
+     */
+    profile: WhatsappBusinessProfile;
+    success: boolean;
+}
+export interface SenderCreateParams {
+    name: string;
+    phoneNumber: string;
+    setAsDefault?: boolean;
+    /**
+     * Events to subscribe to.
+     */
+    webhookEvents?: Array<WebhookEvent>;
+    /**
+     * HTTPS URL for webhook events.
+     */
+    webhookUrl?: string;
+}
+export interface SenderUpdateParams {
+    name?: string;
+    setAsDefault?: boolean;
+    /**
+     * Whether the webhook is active.
+     */
+    webhookActive?: boolean;
+    /**
+     * Events to subscribe to.
+     */
+    webhookEvents?: Array<WebhookEvent>;
+    /**
+     * HTTPS URL for webhook events. Set to null to remove webhook.
+     */
+    webhookUrl?: string | null;
+}
+export interface SenderListParams extends CursorParams {
+}
+export interface SenderUpdateProfileParams {
+    /**
+     * Short description of the business (max 139 characters).
+     */
+    about?: string;
+    /**
+     * Physical address of the business (max 256 characters).
+     */
+    address?: string;
+    /**
+     * Extended description of the business (max 512 characters).
+     */
+    description?: string;
+    /**
+     * Business email address.
+     */
+    email?: string;
+    /**
+     * Business category for WhatsApp Business profile.
+     */
+    vertical?: WhatsappBusinessProfileVertical;
+    /**
+     * Business website URLs (maximum 2).
+     */
+    websites?: Array<string>;
+}
+export interface SenderUploadProfilePictureParams {
+    /**
+     * URL of the image to upload.
+     */
+    imageUrl: string;
+    /**
+     * MIME type of the image.
+     */
+    mimeType: 'image/jpeg' | 'image/png';
+}
+export declare namespace Senders {
+    export { type Sender as Sender, type SenderWebhook as SenderWebhook, type WebhookEvent as WebhookEvent, type WebhookSecretResponse as WebhookSecretResponse, type WhatsappBusinessProfile as WhatsappBusinessProfile, type WhatsappBusinessProfileResponse as WhatsappBusinessProfileResponse, type WhatsappBusinessProfileVertical as WhatsappBusinessProfileVertical, type SenderUpdateProfileResponse as SenderUpdateProfileResponse, type SenderUploadProfilePictureResponse as SenderUploadProfilePictureResponse, type SendersCursor as SendersCursor, type SenderCreateParams as SenderCreateParams, type SenderUpdateParams as SenderUpdateParams, type SenderListParams as SenderListParams, type SenderUpdateProfileParams as SenderUpdateProfileParams, type SenderUploadProfilePictureParams as SenderUploadProfilePictureParams, };
+    export { AgentResource as AgentResource, type Agent as Agent, type AgentExecution as AgentExecution, type AgentExecutionStatus as AgentExecutionStatus, type AgentProvider as AgentProvider, type AgentResponse as AgentResponse, type AgentStats as AgentStats, type AgentCreateParams as AgentCreateParams, type AgentUpdateParams as AgentUpdateParams, };
+}
+//# sourceMappingURL=senders.d.ts.map