@zavudev/sdk 0.45.0 → 0.47.0

package/src/resources/invitations.ts

@@ -8,9 +8,18 @@ import { path } from '../internal/utils/path';
 
 export class Invitations extends APIResource {
   /**
-   * Create a partner invitation link for a client to connect their WhatsApp Business
-   * account. The client will complete Meta's embedded signup flow and the resulting
-   * sender will be created in your project.
+   * Create a partner invitation link for a client to connect WhatsApp. The client
+   * opens the returned `url` and connects. Set `connectionType` to choose how they
+   * connect:
+   *
+   * - `whatsapp_waba` (default): the client completes Meta's embedded signup,
+   *   linking an official WhatsApp Business Account.
+   * - `whatsapp_alt`: the client links their number by scanning a QR code. Requires
+   *   the WhatsApp Alternative feature to be enabled for your team (otherwise
+   *   returns 400).
+   *
+   * Either way, the resulting sender is created in your project when the client
+   * completes the flow, and the invitation transitions to `completed`.
    *
    * @example
    * ```ts
@@ -108,6 +117,12 @@ export interface Invitation {
 
   completedAt?: string | null;
 
+  /**
+   * How the client connects WhatsApp: `whatsapp_waba` (official Cloud API via
+   * embedded signup) or `whatsapp_alt` (QR-linked).
+   */
+  connectionType?: 'whatsapp_waba' | 'whatsapp_alt';
+
   /**
    * ID of a pre-assigned Zavu phone number for WhatsApp registration.
    */
@@ -156,6 +171,14 @@ export interface InvitationCreateParams {
    */
   clientPhone?: string;
 
+  /**
+   * How the client connects WhatsApp. `whatsapp_waba` (default) runs Meta's embedded
+   * signup to link an official WhatsApp Business Account. `whatsapp_alt` links the
+   * number by scanning a QR code — available only to teams with the WhatsApp
+   * Alternative feature enabled.
+   */
+  connectionType?: 'whatsapp_waba' | 'whatsapp_alt';
+
   /**
    * Number of days until the invitation expires.
    */

package/src/resources/messages.ts

@@ -150,6 +150,7 @@ export type Channel =
   | 'telegram'
   | 'email'
   | 'instagram'
+  | 'messenger'
   | 'voice';
 
 export interface Message {
@@ -486,8 +487,11 @@ export interface MessageReactParams {
 
 export interface MessageSendParams {
   /**
-   * Body param: Recipient phone number in E.164 format, email address, or numeric
-   * chat ID (for Telegram/Instagram).
+   * Body param: Recipient phone number in E.164 format, email address, WhatsApp
+   * business-scoped user ID (BSUID, e.g. `US.13491208655302741918`), or numeric chat
+   * ID (for Telegram/Instagram/Messenger). A BSUID is routed to WhatsApp and sent
+   * via the `recipient` field; use it to message a contact who adopted a username
+   * and whose phone number is hidden.
    */
   to: string;
 

package/src/resources/senders/senders.ts

@@ -312,7 +312,12 @@ export interface SenderWebhook {
  *   delivered as `message.inbound` with `messageType='reaction'`. When the contact
  *   replied to (quoted) an earlier message, `data.content` carries the reply
  *   context: `replyToMessageId`, `replyToProviderMessageId`, `replyToFrom`,
- *   `replyToText`, and `replyToMessageType`.
+ *   `replyToText`, and `replyToMessageType`. `data.providerTimestamp` is the
+ *   provider's original receive time in Unix milliseconds (the moment the channel
+ *   received the message from the contact — WhatsApp, Telegram, Instagram,
+ *   Messenger; `null` for SMS and email). Compare it against the top-level
+ *   `timestamp` (when Zavu dispatched the webhook) to detect and ignore delayed
+ *   deliveries.
  * - `message.unsupported`: Received a message type that is not supported
  *
  * **Broadcast events:**

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.45.0'; // x-release-please-version
+export const VERSION = '0.47.0'; // x-release-please-version

package/version.d.mts

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

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.45.0";
+export declare const VERSION = "0.47.0";
 //# 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 = '0.45.0'; // x-release-please-version
+exports.VERSION = '0.47.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

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