@zavudev/sdk 0.31.0 → 0.43.0

package/src/client.ts

@@ -29,19 +29,33 @@ import {
   Addresses,
   AddressesCursor,
 } from './resources/addresses';
+import { Balance, BalanceRetrieveResponse } from './resources/balance';
 import {
-  Contact,
-  ContactListParams,
-  ContactUpdateParams,
-  Contacts,
-  ContactsCursor,
-} from './resources/contacts';
+  DataExport,
+  DataExportsCursor,
+  ExportCreateParams,
+  ExportCreateResponse,
+  ExportListParams,
+  ExportRetrieveResponse,
+  Exports,
+} from './resources/exports';
 import {
   Introspect,
   IntrospectValidatePhoneParams,
   IntrospectValidatePhoneResponse,
   LineType,
 } from './resources/introspect';
+import {
+  Invitation,
+  InvitationCancelResponse,
+  InvitationCreateParams,
+  InvitationCreateResponse,
+  InvitationListParams,
+  InvitationRetrieveResponse,
+  Invitations,
+  InvitationsCursor,
+} from './resources/invitations';
+import { Me, MeRetrieveResponse } from './resources/me';
 import {
   Channel,
   Message,
@@ -50,6 +64,8 @@ import {
   MessageReactParams,
   MessageResponse,
   MessageSendParams,
+  MessageShowTypingParams,
+  MessageShowTypingResponse,
   MessageStatus,
   MessageType,
   Messages,
@@ -80,6 +96,7 @@ import {
   RequirementFieldType,
   RequirementType,
 } from './resources/phone-numbers';
+import { Plan, PlanRetrieveResponse } from './resources/plan';
 import {
   RegulatoryDocument,
   RegulatoryDocumentCreateParams,
@@ -99,6 +116,16 @@ import {
   TemplatesCursor,
   WhatsappCategory,
 } from './resources/templates';
+import {
+  URLListVerifiedParams,
+  URLRetrieveDetailsResponse,
+  URLSubmitForVerificationParams,
+  URLSubmitForVerificationResponse,
+  URLs,
+  VerifiedURL,
+  VerifiedURLsCursor,
+} from './resources/urls';
+import { Usage, UsageRetrieveResponse } from './resources/usage';
 import {
   Broadcast,
   BroadcastCancelResponse,
@@ -108,12 +135,14 @@ import {
   BroadcastContent,
   BroadcastCreateParams,
   BroadcastCreateResponse,
+  BroadcastEscalateReviewResponse,
   BroadcastListParams,
   BroadcastMessageType,
   BroadcastProgress,
   BroadcastRescheduleParams,
   BroadcastRescheduleResponse,
   BroadcastRetrieveResponse,
+  BroadcastRetryReviewResponse,
   BroadcastSendParams,
   BroadcastSendResponse,
   BroadcastStatus,
@@ -122,6 +151,31 @@ import {
   Broadcasts,
   BroadcastsCursor,
 } from './resources/broadcasts/broadcasts';
+import {
+  Contact,
+  ContactChannel,
+  ContactCreateParams,
+  ContactListParams,
+  ContactMergeParams,
+  ContactUpdateParams,
+  Contacts,
+  ContactsCursor,
+} from './resources/contacts/contacts';
+import {
+  FunctionCreateParams,
+  FunctionCreateResponse,
+  FunctionDeleteResponse,
+  FunctionDeployParams,
+  FunctionDeployResponse,
+  FunctionGetDeploymentResponse,
+  FunctionRetrieveResponse,
+  FunctionTailLogsParams,
+  FunctionTailLogsResponse,
+  FunctionUpdateParams,
+  FunctionUpdateResponse,
+  Functions,
+} from './resources/functions/functions';
+import { Number10dlc } from './resources/number-10dlc/number-10dlc';
 import {
   Sender,
   SenderCreateParams,
@@ -140,6 +194,19 @@ import {
   WhatsappBusinessProfileResponse,
   WhatsappBusinessProfileVertical,
 } from './resources/senders/senders';
+import {
+  SubAccount,
+  SubAccountCreateParams,
+  SubAccountCreateResponse,
+  SubAccountDeactivateResponse,
+  SubAccountGetBalanceResponse,
+  SubAccountListParams,
+  SubAccountRetrieveResponse,
+  SubAccountUpdateParams,
+  SubAccountUpdateResponse,
+  SubAccounts,
+  SubAccountsCursor,
+} from './resources/sub-accounts/sub-accounts';
 import { type Fetch } from './internal/builtin-types';
 import { HeadersLike, NullableHeaders, buildHeaders } from './internal/headers';
 import { FinalRequestOptions, RequestOptions } from './internal/request-options';
@@ -290,6 +357,18 @@ export class Zavudev {
     this.fetch = options.fetch ?? Shims.getDefaultFetch();
     this.#encoder = Opts.FallbackEncoder;
 
+    const customHeadersEnv = readEnv('ZAVUDEV_CUSTOM_HEADERS');
+    if (customHeadersEnv) {
+      const parsed: Record<string, string> = {};
+      for (const line of customHeadersEnv.split('\n')) {
+        const colon = line.indexOf(':');
+        if (colon >= 0) {
+          parsed[line.substring(0, colon).trim()] = line.substring(colon + 1).trim();
+        }
+      }
+      options.defaultHeaders = { ...parsed, ...options.defaultHeaders };
+    }
+
     this._options = options;
 
     this.apiKey = apiKey;
@@ -873,6 +952,16 @@ export class Zavudev {
   phoneNumbers: API.PhoneNumbers = new API.PhoneNumbers(this);
   addresses: API.Addresses = new API.Addresses(this);
   regulatoryDocuments: API.RegulatoryDocuments = new API.RegulatoryDocuments(this);
+  invitations: API.Invitations = new API.Invitations(this);
+  exports: API.Exports = new API.Exports(this);
+  urls: API.URLs = new API.URLs(this);
+  balance: API.Balance = new API.Balance(this);
+  plan: API.Plan = new API.Plan(this);
+  usage: API.Usage = new API.Usage(this);
+  subAccounts: API.SubAccounts = new API.SubAccounts(this);
+  number10dlc: API.Number10dlc = new API.Number10dlc(this);
+  me: API.Me = new API.Me(this);
+  functions: API.Functions = new API.Functions(this);
 }
 
 Zavudev.Messages = Messages;
@@ -884,6 +973,16 @@ Zavudev.Introspect = Introspect;
 Zavudev.PhoneNumbers = PhoneNumbers;
 Zavudev.Addresses = Addresses;
 Zavudev.RegulatoryDocuments = RegulatoryDocuments;
+Zavudev.Invitations = Invitations;
+Zavudev.Exports = Exports;
+Zavudev.URLs = URLs;
+Zavudev.Balance = Balance;
+Zavudev.Plan = Plan;
+Zavudev.Usage = Usage;
+Zavudev.SubAccounts = SubAccounts;
+Zavudev.Number10dlc = Number10dlc;
+Zavudev.Me = Me;
+Zavudev.Functions = Functions;
 
 export declare namespace Zavudev {
   export type RequestOptions = Opts.RequestOptions;
@@ -899,10 +998,12 @@ export declare namespace Zavudev {
     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,
   };
 
   export {
@@ -937,9 +1038,12 @@ export declare namespace Zavudev {
   export {
     Contacts as Contacts,
     type Contact as Contact,
+    type ContactChannel as ContactChannel,
     type ContactsCursor as ContactsCursor,
+    type ContactCreateParams as ContactCreateParams,
     type ContactUpdateParams as ContactUpdateParams,
     type ContactListParams as ContactListParams,
+    type ContactMergeParams as ContactMergeParams,
   };
 
   export {
@@ -956,7 +1060,9 @@ export declare namespace Zavudev {
     type BroadcastRetrieveResponse as BroadcastRetrieveResponse,
     type BroadcastUpdateResponse as BroadcastUpdateResponse,
     type BroadcastCancelResponse as BroadcastCancelResponse,
+    type BroadcastEscalateReviewResponse as BroadcastEscalateReviewResponse,
     type BroadcastRescheduleResponse as BroadcastRescheduleResponse,
+    type BroadcastRetryReviewResponse as BroadcastRetryReviewResponse,
     type BroadcastSendResponse as BroadcastSendResponse,
     type BroadcastsCursor as BroadcastsCursor,
     type BroadcastCreateParams as BroadcastCreateParams,
@@ -1020,4 +1126,74 @@ export declare namespace Zavudev {
     type RegulatoryDocumentCreateParams as RegulatoryDocumentCreateParams,
     type RegulatoryDocumentListParams as RegulatoryDocumentListParams,
   };
+
+  export {
+    Invitations as Invitations,
+    type Invitation as Invitation,
+    type InvitationCreateResponse as InvitationCreateResponse,
+    type InvitationRetrieveResponse as InvitationRetrieveResponse,
+    type InvitationCancelResponse as InvitationCancelResponse,
+    type InvitationsCursor as InvitationsCursor,
+    type InvitationCreateParams as InvitationCreateParams,
+    type InvitationListParams as InvitationListParams,
+  };
+
+  export {
+    Exports as Exports,
+    type DataExport as DataExport,
+    type ExportCreateResponse as ExportCreateResponse,
+    type ExportRetrieveResponse as ExportRetrieveResponse,
+    type DataExportsCursor as DataExportsCursor,
+    type ExportCreateParams as ExportCreateParams,
+    type ExportListParams as ExportListParams,
+  };
+
+  export {
+    URLs as URLs,
+    type VerifiedURL as VerifiedURL,
+    type URLRetrieveDetailsResponse as URLRetrieveDetailsResponse,
+    type URLSubmitForVerificationResponse as URLSubmitForVerificationResponse,
+    type VerifiedURLsCursor as VerifiedURLsCursor,
+    type URLListVerifiedParams as URLListVerifiedParams,
+    type URLSubmitForVerificationParams as URLSubmitForVerificationParams,
+  };
+
+  export { Balance as Balance, type BalanceRetrieveResponse as BalanceRetrieveResponse };
+
+  export { Plan as Plan, type PlanRetrieveResponse as PlanRetrieveResponse };
+
+  export { Usage as Usage, type UsageRetrieveResponse as UsageRetrieveResponse };
+
+  export {
+    SubAccounts as SubAccounts,
+    type SubAccount as SubAccount,
+    type SubAccountCreateResponse as SubAccountCreateResponse,
+    type SubAccountRetrieveResponse as SubAccountRetrieveResponse,
+    type SubAccountUpdateResponse as SubAccountUpdateResponse,
+    type SubAccountDeactivateResponse as SubAccountDeactivateResponse,
+    type SubAccountGetBalanceResponse as SubAccountGetBalanceResponse,
+    type SubAccountsCursor as SubAccountsCursor,
+    type SubAccountCreateParams as SubAccountCreateParams,
+    type SubAccountUpdateParams as SubAccountUpdateParams,
+    type SubAccountListParams as SubAccountListParams,
+  };
+
+  export { Number10dlc as Number10dlc };
+
+  export { Me as Me, type MeRetrieveResponse as MeRetrieveResponse };
+
+  export {
+    Functions as Functions,
+    type FunctionCreateResponse as FunctionCreateResponse,
+    type FunctionRetrieveResponse as FunctionRetrieveResponse,
+    type FunctionUpdateResponse as FunctionUpdateResponse,
+    type FunctionDeleteResponse as FunctionDeleteResponse,
+    type FunctionDeployResponse as FunctionDeployResponse,
+    type FunctionGetDeploymentResponse as FunctionGetDeploymentResponse,
+    type FunctionTailLogsResponse as FunctionTailLogsResponse,
+    type FunctionCreateParams as FunctionCreateParams,
+    type FunctionUpdateParams as FunctionUpdateParams,
+    type FunctionDeployParams as FunctionDeployParams,
+    type FunctionTailLogsParams as FunctionTailLogsParams,
+  };
 }

package/src/internal/types.ts

@@ -40,7 +40,6 @@ type OverloadedParameters<T> =
   : T extends (...args: infer A) => unknown ? A
   : never;
 
-/* eslint-disable */
 /**
  * These imports attempt to get types from a parent package's dependencies.
  * Unresolved bare specifiers can trigger [automatic type acquisition][1] in some projects, which
@@ -63,19 +62,18 @@ type OverloadedParameters<T> =
  *
  * [1]: https://www.typescriptlang.org/tsconfig/#typeAcquisition
  */
-/** @ts-ignore For users with \@types/node */
+/** @ts-ignore For users with \@types/node */ /* prettier-ignore */
 type UndiciTypesRequestInit = NotAny<import('../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici-types/index.d.ts').RequestInit>;
-/** @ts-ignore For users with undici */
+/** @ts-ignore For users with undici */ /* prettier-ignore */
 type UndiciRequestInit = NotAny<import('../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/undici/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/undici/index.d.ts').RequestInit>;
-/** @ts-ignore For users with \@types/bun */
+/** @ts-ignore For users with \@types/bun */ /* prettier-ignore */
 type BunRequestInit = globalThis.FetchRequestInit;
-/** @ts-ignore For users with node-fetch@2 */
+/** @ts-ignore For users with node-fetch@2 */ /* prettier-ignore */
 type NodeFetch2RequestInit = NotAny<import('../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/@types/node-fetch/index.d.ts').RequestInit>;
-/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */
+/** @ts-ignore For users with node-fetch@3, doesn't need file extension because types are at ./@types/index.d.ts */ /* prettier-ignore */
 type NodeFetch3RequestInit =  NotAny<import('../node_modules/node-fetch').RequestInit> | NotAny<import('../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../node_modules/node-fetch').RequestInit> | NotAny<import('../../../../../../../../../../node_modules/node-fetch').RequestInit>;
-/** @ts-ignore For users who use Deno */
+/** @ts-ignore For users who use Deno */ /* prettier-ignore */
 type FetchRequestInit = NonNullable<OverloadedParameters<typeof fetch>[1]>;
-/* eslint-enable */
 
 type RequestInits =
   | NotAny<UndiciTypesRequestInit>

package/src/internal/utils/env.ts

@@ -9,10 +9,10 @@
  */
 export const readEnv = (env: string): string | undefined => {
   if (typeof (globalThis as any).process !== 'undefined') {
-    return (globalThis as any).process.env?.[env]?.trim() ?? undefined;
+    return (globalThis as any).process.env?.[env]?.trim() || undefined;
   }
   if (typeof (globalThis as any).Deno !== 'undefined') {
-    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+    return (globalThis as any).Deno.env?.get?.(env)?.trim() || undefined;
   }
   return undefined;
 };

package/src/internal/utils/log.ts

@@ -107,6 +107,8 @@ export const formatRequestDetails = (details: {
           name,
           (
             name.toLowerCase() === 'authorization' ||
+            name.toLowerCase() === 'api-key' ||
+            name.toLowerCase() === 'x-api-key' ||
             name.toLowerCase() === 'cookie' ||
             name.toLowerCase() === 'set-cookie'
           ) ?

package/src/resources/balance.ts

@@ -0,0 +1,43 @@
+// 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 Balance extends APIResource {
+  /**
+   * Get balance for the API key's team. If the API key belongs to a sub-account,
+   * also includes the sub-account's total spending and credit limit.
+   */
+  retrieve(options?: RequestOptions): APIPromise<BalanceRetrieveResponse> {
+    return this._client.get('/v1/balance', options);
+  }
+}
+
+export interface BalanceRetrieveResponse {
+  /**
+   * Team balance in cents. All charges are billed to the parent team.
+   */
+  balance: number;
+
+  currency: string;
+
+  /**
+   * Spending cap in cents (only for sub-accounts).
+   */
+  creditLimit?: number | null;
+
+  /**
+   * Whether this API key belongs to a sub-account.
+   */
+  isSubAccount?: boolean;
+
+  /**
+   * Total amount spent by this sub-account in cents (only for sub-accounts).
+   */
+  totalSpent?: number | null;
+}
+
+export declare namespace Balance {
+  export { type BalanceRetrieveResponse as BalanceRetrieveResponse };
+}

package/src/resources/broadcasts/broadcasts.ts

@@ -114,6 +114,21 @@ export class Broadcasts extends APIResource {
     return this._client.post(path`/v1/broadcasts/${broadcastID}/cancel`, options);
   }
 
+  /**
+   * Request manual review by the Zavu team for a rejected broadcast. Use this after
+   * automated review rejection if you believe the content is legitimate.
+   *
+   * @example
+   * ```ts
+   * const response = await client.broadcasts.escalateReview(
+   *   'broadcastId',
+   * );
+   * ```
+   */
+  escalateReview(broadcastID: string, options?: RequestOptions): APIPromise<BroadcastEscalateReviewResponse> {
+    return this._client.post(path`/v1/broadcasts/${broadcastID}/escalate`, options);
+  }
+
   /**
    * Get real-time progress of a broadcast including delivery counts and estimated
    * completion time.
@@ -149,6 +164,21 @@ export class Broadcasts extends APIResource {
     return this._client.patch(path`/v1/broadcasts/${broadcastID}/schedule`, { body, ...options });
   }
 
+  /**
+   * Resubmit a rejected broadcast for AI review after editing content. Maximum 3
+   * review attempts allowed per broadcast.
+   *
+   * @example
+   * ```ts
+   * const response = await client.broadcasts.retryReview(
+   *   'broadcastId',
+   * );
+   * ```
+   */
+  retryReview(broadcastID: string, options?: RequestOptions): APIPromise<BroadcastRetryReviewResponse> {
+    return this._client.post(path`/v1/broadcasts/${broadcastID}/retry-review`, options);
+  }
+
   /**
    * Start sending the broadcast immediately or schedule for later. Broadcasts go
    * through automated AI content review before sending. If the review passes, the
@@ -326,6 +356,8 @@ export interface BroadcastContact {
 
   processedAt?: string;
 
+  templateButtonVariables?: { [key: string]: string };
+
   templateVariables?: { [key: string]: string };
 }
 
@@ -358,13 +390,20 @@ export interface BroadcastContent {
    */
   mimeType?: string;
 
+  /**
+   * Default button variables for dynamic URL/OTP buttons. Keys are the button index
+   * (0, 1, 2). Per-contact values override these.
+   */
+  templateButtonVariables?: { [key: string]: string };
+
   /**
    * Template ID for template messages.
    */
   templateId?: string;
 
   /**
-   * Default template variables (can be overridden per contact).
+   * Default body variables (can be overridden per contact). Keys are positions (1,
+   * 2, ...).
    */
   templateVariables?: { [key: string]: string };
 }
@@ -470,10 +509,18 @@ export interface BroadcastCancelResponse {
   broadcast: Broadcast;
 }
 
+export interface BroadcastEscalateReviewResponse {
+  broadcast: Broadcast;
+}
+
 export interface BroadcastRescheduleResponse {
   broadcast: Broadcast;
 }
 
+export interface BroadcastRetryReviewResponse {
+  broadcast: Broadcast;
+}
+
 export interface BroadcastSendResponse {
   broadcast: Broadcast;
 }
@@ -586,7 +633,9 @@ export declare namespace Broadcasts {
     type BroadcastRetrieveResponse as BroadcastRetrieveResponse,
     type BroadcastUpdateResponse as BroadcastUpdateResponse,
     type BroadcastCancelResponse as BroadcastCancelResponse,
+    type BroadcastEscalateReviewResponse as BroadcastEscalateReviewResponse,
     type BroadcastRescheduleResponse as BroadcastRescheduleResponse,
+    type BroadcastRetryReviewResponse as BroadcastRetryReviewResponse,
     type BroadcastSendResponse as BroadcastSendResponse,
     type BroadcastsCursor as BroadcastsCursor,
     type BroadcastCreateParams as BroadcastCreateParams,

package/src/resources/broadcasts/contacts.ts

@@ -138,7 +138,14 @@ export namespace ContactAddParams {
     recipient: string;
 
     /**
-     * Per-contact template variables to personalize the message.
+     * Per-contact button variables for dynamic URL/OTP buttons. Keys are the button
+     * index (0, 1, 2).
+     */
+    templateButtonVariables?: { [key: string]: string };
+
+    /**
+     * Per-contact body variables. Keys are positions (1, 2, ...) matching the order
+     * placeholders appear in the template body.
      */
     templateVariables?: { [key: string]: string };
   }

package/src/resources/broadcasts/index.ts

@@ -14,7 +14,9 @@ export {
   type BroadcastRetrieveResponse,
   type BroadcastUpdateResponse,
   type BroadcastCancelResponse,
+  type BroadcastEscalateReviewResponse,
   type BroadcastRescheduleResponse,
+  type BroadcastRetryReviewResponse,
   type BroadcastSendResponse,
   type BroadcastCreateParams,
   type BroadcastUpdateParams,