@zavudev/sdk 0.38.0 → 0.44.0

package/src/client.ts

@@ -55,6 +55,7 @@ import {
   Invitations,
   InvitationsCursor,
 } from './resources/invitations';
+import { Me, MeRetrieveResponse } from './resources/me';
 import {
   Channel,
   Message,
@@ -63,6 +64,8 @@ import {
   MessageReactParams,
   MessageResponse,
   MessageSendParams,
+  MessageShowTypingParams,
+  MessageShowTypingResponse,
   MessageStatus,
   MessageType,
   Messages,
@@ -158,6 +161,20 @@ import {
   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,
@@ -340,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;
@@ -931,6 +960,8 @@ export class Zavudev {
   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;
@@ -950,6 +981,8 @@ 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;
@@ -965,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 {
@@ -1144,4 +1179,21 @@ export declare namespace Zavudev {
   };
 
   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/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/broadcasts/broadcasts.ts

@@ -356,6 +356,10 @@ export interface BroadcastContact {
 
   processedAt?: string;
 
+  templateButtonVariables?: { [key: string]: string };
+
+  templateHeaderVariables?: { [key: string]: string };
+
   templateVariables?: { [key: string]: string };
 }
 
@@ -388,13 +392,29 @@ 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 };
+
+  /**
+   * Default value for a text-header variable, keyed by `1` (can be overridden per
+   * contact). If omitted, Zavu resolves the header from `templateVariables` by the
+   * header placeholder's name.
+   */
+  templateHeaderVariables?: { [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). 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. Do not mix positional and named keys.
    */
   templateVariables?: { [key: string]: string };
 }

package/src/resources/broadcasts/contacts.ts

@@ -138,7 +138,22 @@ 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 value for a text-header variable, keyed by `1`. If omitted, Zavu
+     * resolves the header from `templateVariables` by the header placeholder's name.
+     */
+    templateHeaderVariables?: { [key: string]: string };
+
+    /**
+     * Per-contact body variables. 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. Do not mix positional and named keys.
      */
     templateVariables?: { [key: string]: string };
   }

package/src/resources/contacts/contacts.ts

@@ -84,6 +84,26 @@ export class Contacts extends APIResource {
     return this._client.getAPIList('/v1/contacts', Cursor<Contact>, { query, ...options });
   }
 
+  /**
+   * Permanently delete a contact and its communication channels. Implements
+   * right-to-erasure obligations under GDPR Art. 17, Ley 19.628 (Chile) Art. 12,
+   * CCPA § 1798.105, and LGPD Art. 18.VI. The contact, its channels, and any
+   * associated agent flow sessions and conversation threads are removed. Past
+   * message records and broadcast delivery logs are retained for billing/audit but
+   * no longer reference the deleted contact.
+   *
+   * @example
+   * ```ts
+   * await client.contacts.delete('contactId');
+   * ```
+   */
+  delete(contactID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/contacts/${contactID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
   /**
    * Dismiss the merge suggestion for a contact.
    *