@zavudev/sdk 0.30.0 → 0.38.0

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
@@ -470,10 +500,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 +624,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/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,

package/src/resources/contacts/channels.ts

@@ -0,0 +1,177 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ContactsAPI from './contacts';
+import { APIPromise } from '../../core/api-promise';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Channels extends APIResource {
+  /**
+   * Update a contact's channel properties.
+   *
+   * @example
+   * ```ts
+   * const channel = await client.contacts.channels.update(
+   *   'channelId',
+   *   { contactId: 'contactId' },
+   * );
+   * ```
+   */
+  update(
+    channelID: string,
+    params: ChannelUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<ChannelUpdateResponse> {
+    const { contactId, ...body } = params;
+    return this._client.patch(path`/v1/contacts/${contactId}/channels/${channelID}`, { body, ...options });
+  }
+
+  /**
+   * Add a new communication channel to an existing contact.
+   *
+   * @example
+   * ```ts
+   * const response = await client.contacts.channels.add(
+   *   'contactId',
+   *   {
+   *     channel: 'email',
+   *     identifier: 'john.work@company.com',
+   *     label: 'work',
+   *   },
+   * );
+   * ```
+   */
+  add(contactID: string, body: ChannelAddParams, options?: RequestOptions): APIPromise<ChannelAddResponse> {
+    return this._client.post(path`/v1/contacts/${contactID}/channels`, { body, ...options });
+  }
+
+  /**
+   * Remove a communication channel from a contact. Cannot remove the last channel.
+   *
+   * @example
+   * ```ts
+   * await client.contacts.channels.remove('channelId', {
+   *   contactId: 'contactId',
+   * });
+   * ```
+   */
+  remove(channelID: string, params: ChannelRemoveParams, options?: RequestOptions): APIPromise<void> {
+    const { contactId } = params;
+    return this._client.delete(path`/v1/contacts/${contactId}/channels/${channelID}`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Set a channel as the primary channel for its type.
+   *
+   * @example
+   * ```ts
+   * const response = await client.contacts.channels.setPrimary(
+   *   'channelId',
+   *   { contactId: 'contactId' },
+   * );
+   * ```
+   */
+  setPrimary(
+    channelID: string,
+    params: ChannelSetPrimaryParams,
+    options?: RequestOptions,
+  ): APIPromise<ChannelSetPrimaryResponse> {
+    const { contactId } = params;
+    return this._client.post(path`/v1/contacts/${contactId}/channels/${channelID}/primary`, options);
+  }
+}
+
+export interface ChannelUpdateResponse {
+  /**
+   * A communication channel for a contact.
+   */
+  channel: ContactsAPI.ContactChannel;
+}
+
+export interface ChannelAddResponse {
+  /**
+   * A communication channel for a contact.
+   */
+  channel: ContactsAPI.ContactChannel;
+}
+
+export interface ChannelSetPrimaryResponse {
+  /**
+   * A communication channel for a contact.
+   */
+  channel: ContactsAPI.ContactChannel;
+}
+
+export interface ChannelUpdateParams {
+  /**
+   * Path param
+   */
+  contactId: string;
+
+  /**
+   * Body param: Optional label for the channel. Set to null to clear.
+   */
+  label?: string | null;
+
+  /**
+   * Body param
+   */
+  metadata?: { [key: string]: string };
+
+  /**
+   * Body param: Whether the channel is verified.
+   */
+  verified?: boolean;
+}
+
+export interface ChannelAddParams {
+  /**
+   * Channel type.
+   */
+  channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+
+  /**
+   * Channel identifier (phone number in E.164 format or email address).
+   */
+  identifier: string;
+
+  /**
+   * ISO country code for phone numbers.
+   */
+  countryCode?: string;
+
+  /**
+   * Whether this should be the primary channel for its type.
+   */
+  isPrimary?: boolean;
+
+  /**
+   * Optional label for the channel.
+   */
+  label?: string;
+}
+
+export interface ChannelRemoveParams {
+  contactId: string;
+}
+
+export interface ChannelSetPrimaryParams {
+  contactId: string;
+}
+
+export declare namespace Channels {
+  export {
+    type ChannelUpdateResponse as ChannelUpdateResponse,
+    type ChannelAddResponse as ChannelAddResponse,
+    type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse,
+    type ChannelUpdateParams as ChannelUpdateParams,
+    type ChannelAddParams as ChannelAddParams,
+    type ChannelRemoveParams as ChannelRemoveParams,
+    type ChannelSetPrimaryParams as ChannelSetPrimaryParams,
+  };
+}

package/src/resources/contacts/contacts.ts

@@ -0,0 +1,360 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import * as ChannelsAPI from './channels';
+import {
+  ChannelAddParams,
+  ChannelAddResponse,
+  ChannelRemoveParams,
+  ChannelSetPrimaryParams,
+  ChannelSetPrimaryResponse,
+  ChannelUpdateParams,
+  ChannelUpdateResponse,
+  Channels,
+} from './channels';
+import { APIPromise } from '../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../core/pagination';
+import { buildHeaders } from '../../internal/headers';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Contacts extends APIResource {
+  channels: ChannelsAPI.Channels = new ChannelsAPI.Channels(this._client);
+
+  /**
+   * Create a new contact with one or more communication channels.
+   *
+   * @example
+   * ```ts
+   * const contact = await client.contacts.create({
+   *   channels: [
+   *     {
+   *       channel: 'sms',
+   *       identifier: '+14155551234',
+   *       isPrimary: true,
+   *     },
+   *   ],
+   *   displayName: 'John Doe',
+   * });
+   * ```
+   */
+  create(body: ContactCreateParams, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.post('/v1/contacts', { body, ...options });
+  }
+
+  /**
+   * Get contact
+   *
+   * @example
+   * ```ts
+   * const contact = await client.contacts.retrieve('contactId');
+   * ```
+   */
+  retrieve(contactID: string, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.get(path`/v1/contacts/${contactID}`, options);
+  }
+
+  /**
+   * Update contact
+   *
+   * @example
+   * ```ts
+   * const contact = await client.contacts.update('contactId');
+   * ```
+   */
+  update(contactID: string, body: ContactUpdateParams, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.patch(path`/v1/contacts/${contactID}`, { body, ...options });
+  }
+
+  /**
+   * List contacts with their communication channels.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const contact of client.contacts.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ContactListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ContactsCursor, Contact> {
+    return this._client.getAPIList('/v1/contacts', Cursor<Contact>, { query, ...options });
+  }
+
+  /**
+   * Dismiss the merge suggestion for a contact.
+   *
+   * @example
+   * ```ts
+   * await client.contacts.dismissMergeSuggestion('contactId');
+   * ```
+   */
+  dismissMergeSuggestion(contactID: string, options?: RequestOptions): APIPromise<void> {
+    return this._client.delete(path`/v1/contacts/${contactID}/merge-suggestion`, {
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Merge a source contact into this contact. All channels from the source contact
+   * will be moved to the target contact, and the source contact will be marked as
+   * merged.
+   *
+   * @example
+   * ```ts
+   * const contact = await client.contacts.merge('contactId', {
+   *   sourceContactId: 'jx7xyz789',
+   * });
+   * ```
+   */
+  merge(contactID: string, body: ContactMergeParams, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.post(path`/v1/contacts/${contactID}/merge`, { body, ...options });
+  }
+
+  /**
+   * Get contact by phone number
+   *
+   * @example
+   * ```ts
+   * const contact = await client.contacts.retrieveByPhone(
+   *   'phoneNumber',
+   * );
+   * ```
+   */
+  retrieveByPhone(phoneNumber: string, options?: RequestOptions): APIPromise<Contact> {
+    return this._client.get(path`/v1/contacts/phone/${phoneNumber}`, options);
+  }
+}
+
+export type ContactsCursor = Cursor<Contact>;
+
+export interface Contact {
+  id: string;
+
+  /**
+   * List of available messaging channels for this contact.
+   */
+  availableChannels: Array<string>;
+
+  createdAt: string;
+
+  metadata: { [key: string]: string };
+
+  /**
+   * Whether this contact has been verified.
+   */
+  verified: boolean;
+
+  /**
+   * All communication channels for this contact.
+   */
+  channels?: Array<ContactChannel>;
+
+  countryCode?: string;
+
+  /**
+   * Preferred channel for this contact.
+   */
+  defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice';
+
+  /**
+   * Display name for the contact.
+   */
+  displayName?: string;
+
+  /**
+   * DEPRECATED: Use primaryPhone instead. Primary phone number in E.164 format.
+   */
+  phoneNumber?: string;
+
+  /**
+   * Primary email address.
+   */
+  primaryEmail?: string;
+
+  /**
+   * Primary phone number in E.164 format.
+   */
+  primaryPhone?: string;
+
+  /**
+   * Contact's WhatsApp profile name. Only available for WhatsApp contacts.
+   */
+  profileName?: string | null;
+
+  /**
+   * ID of a contact suggested for merging.
+   */
+  suggestedMergeWith?: string;
+
+  updatedAt?: string;
+}
+
+/**
+ * A communication channel for a contact.
+ */
+export interface ContactChannel {
+  id: string;
+
+  /**
+   * Channel type.
+   */
+  channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+
+  createdAt: string;
+
+  /**
+   * Channel identifier (phone number or email address).
+   */
+  identifier: string;
+
+  /**
+   * Whether this is the primary channel for its type.
+   */
+  isPrimary: boolean;
+
+  /**
+   * Whether this channel has been verified.
+   */
+  verified: boolean;
+
+  /**
+   * ISO country code for phone numbers.
+   */
+  countryCode?: string;
+
+  /**
+   * Optional label for the channel.
+   */
+  label?: string;
+
+  /**
+   * Last time a message was received on this channel.
+   */
+  lastInboundAt?: string;
+
+  metadata?: { [key: string]: string };
+
+  /**
+   * Delivery metrics for this channel.
+   */
+  metrics?: ContactChannel.Metrics;
+
+  updatedAt?: string;
+}
+
+export namespace ContactChannel {
+  /**
+   * Delivery metrics for this channel.
+   */
+  export interface Metrics {
+    avgDeliveryTimeMs?: number;
+
+    failureCount?: number;
+
+    lastSuccessAt?: string;
+
+    successCount?: number;
+
+    totalAttempts?: number;
+  }
+}
+
+export interface ContactCreateParams {
+  /**
+   * Communication channels for the contact.
+   */
+  channels: Array<ContactCreateParams.Channel>;
+
+  /**
+   * Display name for the contact.
+   */
+  displayName?: string;
+
+  /**
+   * Arbitrary metadata to associate with the contact.
+   */
+  metadata?: { [key: string]: string };
+}
+
+export namespace ContactCreateParams {
+  /**
+   * Input for creating a contact channel.
+   */
+  export interface Channel {
+    /**
+     * Channel type.
+     */
+    channel: 'sms' | 'whatsapp' | 'email' | 'telegram' | 'voice';
+
+    /**
+     * Channel identifier (phone number in E.164 format or email address).
+     */
+    identifier: string;
+
+    /**
+     * ISO country code for phone numbers.
+     */
+    countryCode?: string;
+
+    /**
+     * Whether this should be the primary channel for its type.
+     */
+    isPrimary?: boolean;
+
+    /**
+     * Optional label for the channel.
+     */
+    label?: string;
+  }
+}
+
+export interface ContactUpdateParams {
+  /**
+   * Preferred channel for this contact. Set to null to clear.
+   */
+  defaultChannel?: 'sms' | 'whatsapp' | 'telegram' | 'email' | 'instagram' | 'voice' | null;
+
+  metadata?: { [key: string]: string };
+}
+
+export interface ContactListParams extends CursorParams {
+  phoneNumber?: string;
+}
+
+export interface ContactMergeParams {
+  /**
+   * ID of the contact to merge into the target contact. The source contact will be
+   * marked as merged.
+   */
+  sourceContactId: string;
+}
+
+Contacts.Channels = Channels;
+
+export declare namespace Contacts {
+  export {
+    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 {
+    Channels as Channels,
+    type ChannelUpdateResponse as ChannelUpdateResponse,
+    type ChannelAddResponse as ChannelAddResponse,
+    type ChannelSetPrimaryResponse as ChannelSetPrimaryResponse,
+    type ChannelUpdateParams as ChannelUpdateParams,
+    type ChannelAddParams as ChannelAddParams,
+    type ChannelRemoveParams as ChannelRemoveParams,
+    type ChannelSetPrimaryParams as ChannelSetPrimaryParams,
+  };
+}

package/src/resources/contacts/index.ts

@@ -0,0 +1,22 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Channels,
+  type ChannelUpdateResponse,
+  type ChannelAddResponse,
+  type ChannelSetPrimaryResponse,
+  type ChannelUpdateParams,
+  type ChannelAddParams,
+  type ChannelRemoveParams,
+  type ChannelSetPrimaryParams,
+} from './channels';
+export {
+  Contacts,
+  type Contact,
+  type ContactChannel,
+  type ContactCreateParams,
+  type ContactUpdateParams,
+  type ContactListParams,
+  type ContactMergeParams,
+  type ContactsCursor,
+} from './contacts';