@zavudev/sdk 0.38.0 → 0.44.0

package/src/resources/index.ts

@@ -56,6 +56,20 @@ export {
   type ExportListParams,
   type DataExportsCursor,
 } from './exports';
+export {
+  Functions,
+  type FunctionCreateResponse,
+  type FunctionRetrieveResponse,
+  type FunctionUpdateResponse,
+  type FunctionDeleteResponse,
+  type FunctionDeployResponse,
+  type FunctionGetDeploymentResponse,
+  type FunctionTailLogsResponse,
+  type FunctionCreateParams,
+  type FunctionUpdateParams,
+  type FunctionDeployParams,
+  type FunctionTailLogsParams,
+} from './functions/functions';
 export {
   Introspect,
   type LineType,
@@ -72,6 +86,7 @@ export {
   type InvitationListParams,
   type InvitationsCursor,
 } from './invitations';
+export { Me, type MeRetrieveResponse } from './me';
 export {
   Messages,
   type Channel,
@@ -80,9 +95,11 @@ export {
   type MessageResponse,
   type MessageStatus,
   type MessageType,
+  type MessageShowTypingResponse,
   type MessageListParams,
   type MessageReactParams,
   type MessageSendParams,
+  type MessageShowTypingParams,
   type MessagesCursor,
 } from './messages';
 export { Number10dlc } from './number-10dlc/number-10dlc';

package/src/resources/me.ts

@@ -0,0 +1,49 @@
+// 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';
+
+export class Me extends APIResource {
+  /**
+   * Returns the project, team, and API key metadata bound to the current Bearer
+   * token. Used by CLIs and SDKs to confirm which project they will operate on.
+   */
+  retrieve(options?: RequestOptions): APIPromise<MeRetrieveResponse> {
+    return this._client.get('/v1/me', options);
+  }
+}
+
+export interface MeRetrieveResponse {
+  apiKey: MeRetrieveResponse.APIKey;
+
+  isTestMode: boolean;
+
+  project: MeRetrieveResponse.Project;
+
+  team: MeRetrieveResponse.Team;
+}
+
+export namespace MeRetrieveResponse {
+  export interface APIKey {
+    id: string;
+  }
+
+  export interface Project {
+    id: string;
+
+    isSubAccount: boolean;
+
+    name: string | null;
+  }
+
+  export interface Team {
+    id: string;
+
+    name: string | null;
+  }
+}
+
+export declare namespace Me {
+  export { type MeRetrieveResponse as MeRetrieveResponse };
+}

package/src/resources/messages.ts

@@ -106,6 +106,35 @@ export class Messages extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Mark an inbound WhatsApp message as read and display a typing indicator to the
+   * user while you prepare a response. The indicator is automatically dismissed when
+   * you send a reply, or after 25 seconds — whichever comes first. Only valid for
+   * inbound WhatsApp messages. Use this when a reply will take more than a couple of
+   * seconds (LLM agent, tool call, lookup) to improve the recipient's experience.
+   *
+   * @example
+   * ```ts
+   * const response = await client.messages.showTyping(
+   *   'messageId',
+   * );
+   * ```
+   */
+  showTyping(
+    messageID: string,
+    params: MessageShowTypingParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<MessageShowTypingResponse> {
+    const { 'Zavu-Sender': zavuSender } = params ?? {};
+    return this._client.post(path`/v1/messages/${messageID}/typing`, {
+      ...options,
+      headers: buildHeaders([
+        { ...(zavuSender != null ? { 'Zavu-Sender': zavuSender } : undefined) },
+        options?.headers,
+      ]),
+    });
+  }
 }
 
 export type MessagesCursor = Cursor<Message>;
@@ -200,6 +229,34 @@ export interface MessageContent {
    */
   contacts?: Array<MessageContent.Contact>;
 
+  /**
+   * Button label for cta_url messages.
+   */
+  ctaDisplayText?: string;
+
+  /**
+   * Public HTTPS URL of the header media when ctaHeaderType is 'image', 'video', or
+   * 'document'. WhatsApp fetches this URL — it must be publicly reachable and return
+   * the declared content type.
+   */
+  ctaHeaderMediaUrl?: string;
+
+  /**
+   * Header text when ctaHeaderType is 'text'.
+   */
+  ctaHeaderText?: string;
+
+  /**
+   * Optional header type for cta_url messages.
+   */
+  ctaHeaderType?: 'text' | 'image' | 'video' | 'document';
+
+  /**
+   * Destination URL opened in the device's default browser when the button is
+   * tapped. Used with messageType=cta_url. WhatsApp requires HTTPS in production.
+   */
+  ctaUrl?: string;
+
   /**
    * Emoji for reaction messages.
    */
@@ -210,6 +267,11 @@ export interface MessageContent {
    */
   filename?: string;
 
+  /**
+   * Optional footer text for cta_url messages.
+   */
+  footerText?: string;
+
   /**
    * Latitude for location messages.
    */
@@ -260,13 +322,43 @@ export interface MessageContent {
    */
   sections?: Array<MessageContent.Section>;
 
+  /**
+   * Variables for dynamic button placeholders (URL buttons and OTP buttons). Keys
+   * are the button index (0, 1, 2) in the template's `buttons` array — not the
+   * placeholder name. Values substitute the `{{1}}` placeholder inside that button's
+   * URL.
+   *
+   * **WhatsApp constraints:**
+   *
+   * - URL buttons only accept `{{1}}` — positional, numeric, no whitespace, no name.
+   *   Named placeholders like `{{token}}` are stored as literal URL text by Meta and
+   *   cannot be substituted.
+   * - At most one placeholder per URL button.
+   * - A template may have at most three buttons.
+   * - Static URL buttons (no placeholder) and `quick_reply` buttons are not included
+   *   here.
+   */
+  templateButtonVariables?: { [key: string]: string };
+
+  /**
+   * Value for a text-header variable, keyed by `1` (WhatsApp text headers allow at
+   * most one variable). Optional override. If omitted, Zavu resolves the header from
+   * `templateVariables` using the header placeholder's name (e.g. `novios`). Static
+   * text headers need no value.
+   */
+  templateHeaderVariables?: { [key: string]: string };
+
   /**
    * Template ID for template messages.
    */
   templateId?: string;
 
   /**
-   * Variables for template rendering. Keys are variable positions (1, 2, 3...).
+   * Variables for body placeholders. Key them to match the template body: by
+   * position (`1`, `2`, ...) for positional templates, or by name (e.g.
+   * `customer_name`) for named templates. Zavu detects the template's format and
+   * sends the correct payload to Meta. Named keys also resolve a named text-header
+   * variable. Do not mix positional and named keys in the same request.
    */
   templateVariables?: { [key: string]: string };
 }
@@ -330,9 +422,14 @@ export type MessageType =
   | 'contact'
   | 'buttons'
   | 'list'
+  | 'cta_url'
   | 'reaction'
   | 'template';
 
+export interface MessageShowTypingResponse {
+  success: boolean;
+}
+
 export interface MessageListParams extends CursorParams {
   /**
    * Delivery channel. Use 'auto' for intelligent routing.
@@ -471,6 +568,14 @@ export namespace MessageSendParams {
   }
 }
 
+export interface MessageShowTypingParams {
+  /**
+   * Optional sender profile ID. If omitted, the project's default sender will be
+   * used.
+   */
+  'Zavu-Sender'?: string;
+}
+
 export declare namespace Messages {
   export {
     type Channel as Channel,
@@ -479,9 +584,11 @@ export declare namespace Messages {
     type MessageResponse as MessageResponse,
     type MessageStatus as MessageStatus,
     type MessageType as MessageType,
+    type MessageShowTypingResponse as MessageShowTypingResponse,
     type MessagesCursor as MessagesCursor,
     type MessageListParams as MessageListParams,
     type MessageReactParams as MessageReactParams,
     type MessageSendParams as MessageSendParams,
+    type MessageShowTypingParams as MessageShowTypingParams,
   };
 }

package/src/resources/senders/agent/agent.ts

@@ -2,7 +2,12 @@
 
 import { APIResource } from '../../../core/resource';
 import * as ExecutionsAPI from './executions';
-import { ExecutionListParams, Executions } from './executions';
+import {
+  ExecutionListParams,
+  ExecutionRetrieveParams,
+  ExecutionRetrieveResponse,
+  Executions,
+} from './executions';
 import * as FlowsAPI from './flows';
 import {
   AgentFlow,
@@ -369,7 +374,12 @@ export declare namespace AgentResource {
     type AgentUpdateParams as AgentUpdateParams,
   };
 
-  export { Executions as Executions, type ExecutionListParams as ExecutionListParams };
+  export {
+    Executions as Executions,
+    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
+    type ExecutionRetrieveParams as ExecutionRetrieveParams,
+    type ExecutionListParams as ExecutionListParams,
+  };
 
   export {
     Flows as Flows,

package/src/resources/senders/agent/executions.ts

@@ -3,11 +3,34 @@
 import { APIResource } from '../../../core/resource';
 import * as AgentAPI from './agent';
 import { AgentExecutionsCursor } from './agent';
+import { APIPromise } from '../../../core/api-promise';
 import { Cursor, type CursorParams, PagePromise } from '../../../core/pagination';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
 
 export class Executions extends APIResource {
+  /**
+   * Fetch full details for one execution — including `errorMessage`, `errorCode`,
+   * and `responseText`. Use this to debug failures surfaced by the list endpoint.
+   *
+   * @example
+   * ```ts
+   * const execution =
+   *   await client.senders.agent.executions.retrieve(
+   *     'executionId',
+   *     { senderId: 'senderId' },
+   *   );
+   * ```
+   */
+  retrieve(
+    executionID: string,
+    params: ExecutionRetrieveParams,
+    options?: RequestOptions,
+  ): APIPromise<ExecutionRetrieveResponse> {
+    const { senderId } = params;
+    return this._client.get(path`/v1/senders/${senderId}/agent/executions/${executionID}`, options);
+  }
+
   /**
    * List recent agent executions with pagination.
    *
@@ -34,6 +57,14 @@ export class Executions extends APIResource {
   }
 }
 
+export interface ExecutionRetrieveResponse {
+  execution: AgentAPI.AgentExecution;
+}
+
+export interface ExecutionRetrieveParams {
+  senderId: string;
+}
+
 export interface ExecutionListParams extends CursorParams {
   /**
    * Status of an agent execution.
@@ -42,7 +73,11 @@ export interface ExecutionListParams extends CursorParams {
 }
 
 export declare namespace Executions {
-  export { type ExecutionListParams as ExecutionListParams };
+  export {
+    type ExecutionRetrieveResponse as ExecutionRetrieveResponse,
+    type ExecutionRetrieveParams as ExecutionRetrieveParams,
+    type ExecutionListParams as ExecutionListParams,
+  };
 }
 
 export { type AgentExecutionsCursor };

package/src/resources/senders/agent/index.ts

@@ -12,7 +12,12 @@ export {
   type AgentUpdateParams,
   type AgentExecutionsCursor,
 } from './agent';
-export { Executions, type ExecutionListParams } from './executions';
+export {
+  Executions,
+  type ExecutionRetrieveResponse,
+  type ExecutionRetrieveParams,
+  type ExecutionListParams,
+} from './executions';
 export {
   Flows,
   type AgentFlow,

package/src/resources/senders/senders.ts

@@ -326,6 +326,13 @@ export interface SenderWebhook {
  *
  * - `invitation.status_changed`: A partner invitation status changed (pending,
  *   in_progress, completed, cancelled)
+ *
+ * **Custom domain events:**
+ *
+ * - `domain.verified`: A custom email domain passed verification (DKIM, and
+ *   SPF/DMARC/MAIL FROM if enhanced records are enabled)
+ * - `domain.failed`: A custom email domain failed verification or is partially
+ *   verified
  */
 export type WebhookEvent =
   | 'message.queued'
@@ -338,7 +345,9 @@ export type WebhookEvent =
   | 'broadcast.status_changed'
   | 'conversation.new'
   | 'template.status_changed'
-  | 'invitation.status_changed';
+  | 'invitation.status_changed'
+  | 'domain.verified'
+  | 'domain.failed';
 
 export interface WebhookSecretResponse {
   /**

package/src/resources/sub-accounts/api-keys.ts

@@ -8,7 +8,8 @@ import { path } from '../../internal/utils/path';
 
 export class APIKeys extends APIResource {
   /**
-   * Create sub-account API key
+   * Create sub-account API key. Requires a parent project API key; sub-account API
+   * keys receive HTTP 403.
    *
    * @example
    * ```ts
@@ -23,7 +24,8 @@ export class APIKeys extends APIResource {
   }
 
   /**
-   * List sub-account API keys
+   * List sub-account API keys. Requires a parent project API key; sub-account API
+   * keys receive HTTP 403.
    *
    * @example
    * ```ts
@@ -35,7 +37,8 @@ export class APIKeys extends APIResource {
   }
 
   /**
-   * Revoke sub-account API key
+   * Revoke sub-account API key. Requires a parent project API key; sub-account API
+   * keys receive HTTP 403.
    *
    * @example
    * ```ts

package/src/resources/sub-accounts/sub-accounts.ts

@@ -20,7 +20,8 @@ export class SubAccounts extends APIResource {
   /**
    * Create a new sub-account (project) with its own API key. All charges are billed
    * to the parent team's balance. Use creditLimit to set a spending cap. The
-   * sub-account's API key is returned only in the creation response.
+   * sub-account's API key is returned only in the creation response. Requires a
+   * parent project API key; sub-account API keys receive HTTP 403.
    *
    * @example
    * ```ts
@@ -34,7 +35,8 @@ export class SubAccounts extends APIResource {
   }
 
   /**
-   * Get sub-account
+   * Get sub-account. Requires a parent project API key; sub-account API keys receive
+   * HTTP 403.
    *
    * @example
    * ```ts
@@ -46,7 +48,8 @@ export class SubAccounts extends APIResource {
   }
 
   /**
-   * Update sub-account
+   * Update sub-account. Requires a parent project API key; sub-account API keys
+   * receive HTTP 403.
    *
    * @example
    * ```ts
@@ -62,7 +65,8 @@ export class SubAccounts extends APIResource {
   }
 
   /**
-   * List sub-accounts for this team.
+   * List sub-accounts for this team. Requires a parent project API key; sub-account
+   * API keys receive HTTP 403.
    *
    * @example
    * ```ts
@@ -81,7 +85,8 @@ export class SubAccounts extends APIResource {
 
   /**
    * Deactivate a sub-account. Remaining balance is returned to the parent team and
-   * all API keys are revoked.
+   * all API keys are revoked. Requires a parent project API key; sub-account API
+   * keys receive HTTP 403.
    *
    * @example
    * ```ts
@@ -94,7 +99,8 @@ export class SubAccounts extends APIResource {
 
   /**
    * Get spending information for a sub-account. Returns the parent team's balance,
-   * the sub-account's total spending, and its credit limit (spending cap).
+   * the sub-account's total spending, and its credit limit (spending cap). Requires
+   * a parent project API key; sub-account API keys receive HTTP 403.
    *
    * @example
    * ```ts

package/src/resources/templates.ts

@@ -98,8 +98,11 @@ export interface Template {
   id: string;
 
   /**
-   * Default template body with variables: {{1}}, {{2}}, or named variables like
-   * {{contact.first_name}}. Used when no channel-specific body is set.
+   * Default template body with variables: positional ({{1}}, {{2}}) or named
+   * ({{customer_name}}, {{contact.first_name}}). Templates created in Zavu are
+   * submitted to Meta as positional; templates imported from a WhatsApp Business
+   * Account keep their original format (named or positional). Used when no
+   * channel-specific body is set.
    */
   body: string;
 
@@ -182,6 +185,12 @@ export interface Template {
 
 export namespace Template {
   export interface Button {
+    /**
+     * Sample value used to substitute `{{1}}` in the URL when submitting the template
+     * to Meta for review. Only present for dynamic URL buttons.
+     */
+    example?: string;
+
     /**
      * OTP button type. Required when type is 'otp'.
      */
@@ -301,6 +310,13 @@ export namespace TemplateCreateParams {
 
     type: 'quick_reply' | 'url' | 'phone' | 'otp';
 
+    /**
+     * Sample value Meta uses to review templates with a dynamic URL button.
+     * Substituted into `{{1}}` of the URL when the template is submitted to Meta. Only
+     * meaningful when `url` contains `{{1}}`; ignored for static URLs.
+     */
+    example?: string;
+
     /**
      * Required when type is 'otp'. COPY_CODE shows copy button, ONE_TAP enables
      * Android autofill.
@@ -319,6 +335,11 @@ export namespace TemplateCreateParams {
      */
     signatureHash?: string;
 
+    /**
+     * Button destination. Use `{{1}}` exactly once for a dynamic URL (e.g.
+     * `https://example.com/orders/{{1}}`); WhatsApp only accepts the strict `{{1}}`
+     * form. Static URLs must not contain any `{{...}}` placeholder.
+     */
     url?: string;
   }
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.38.0'; // x-release-please-version
+export const VERSION = '0.44.0'; // x-release-please-version

package/uploads.d.mts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.d.mts.map

package/uploads.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.mts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/uploads.d.ts

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.js";
 //# sourceMappingURL=uploads.d.ts.map

package/uploads.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.d.ts","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,kCAA+B"}

package/uploads.mjs

@@ -1,2 +1,3 @@
+/** @deprecated Import from ./core/uploads instead */
 export * from "./core/uploads.mjs";
 //# sourceMappingURL=uploads.mjs.map

package/uploads.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":""}
+{"version":3,"file":"uploads.mjs","sourceRoot":"","sources":["src/uploads.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,mCAA+B"}

package/version.d.mts

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

package/version.d.ts

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

package/version.mjs

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