@zavudev/sdk 0.31.0 → 0.43.0

package/src/resources/contacts.ts

@@ -1,198 +1,3 @@
 // 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 { Cursor, type CursorParams, PagePromise } from '../core/pagination';
-import { RequestOptions } from '../internal/request-options';
-import { path } from '../internal/utils/path';
-
-export class Contacts extends APIResource {
-  /**
-   * Get contact
-   */
-  retrieve(contactID: string, options?: RequestOptions): APIPromise<Contact> {
-    return this._client.get(path`/v1/contacts/${contactID}`, options);
-  }
-
-  /**
-   * Update contact
-   */
-  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.
-   */
-  list(
-    query: ContactListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ContactsCursor, Contact> {
-    return this._client.getAPIList('/v1/contacts', Cursor<Contact>, { query, ...options });
-  }
-
-  /**
-   * Get contact by phone number
-   */
-  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<Contact.Channel>;
-
-  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;
-}
-
-export namespace Contact {
-  /**
-   * A communication channel for a contact.
-   */
-  export interface Channel {
-    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?: Channel.Metrics;
-
-    updatedAt?: string;
-  }
-
-  export namespace Channel {
-    /**
-     * Delivery metrics for this channel.
-     */
-    export interface Metrics {
-      avgDeliveryTimeMs?: number;
-
-      failureCount?: number;
-
-      lastSuccessAt?: string;
-
-      successCount?: number;
-
-      totalAttempts?: number;
-    }
-  }
-}
-
-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 declare namespace Contacts {
-  export {
-    type Contact as Contact,
-    type ContactsCursor as ContactsCursor,
-    type ContactUpdateParams as ContactUpdateParams,
-    type ContactListParams as ContactListParams,
-  };
-}
+export * from './contacts/index';

package/src/resources/exports.ts

@@ -0,0 +1,141 @@
+// 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 { Cursor, type CursorParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class Exports extends APIResource {
+  /**
+   * Create a new data export job. The export will be processed asynchronously and
+   * the download URL will be available when status is 'completed'. Export links
+   * expire after 24 hours.
+   *
+   * @example
+   * ```ts
+   * const _export = await client.exports.create({
+   *   dataTypes: ['messages', 'conversations'],
+   *   dateFrom: '2024-01-01T00:00:00Z',
+   *   dateTo: '2024-12-31T23:59:59Z',
+   * });
+   * ```
+   */
+  create(body: ExportCreateParams, options?: RequestOptions): APIPromise<ExportCreateResponse> {
+    return this._client.post('/v1/exports', { body, ...options });
+  }
+
+  /**
+   * Get details of a specific data export, including download URL when completed.
+   *
+   * @example
+   * ```ts
+   * const _export = await client.exports.retrieve('exportId');
+   * ```
+   */
+  retrieve(exportID: string, options?: RequestOptions): APIPromise<ExportRetrieveResponse> {
+    return this._client.get(path`/v1/exports/${exportID}`, options);
+  }
+
+  /**
+   * List data exports for this project.
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const dataExport of client.exports.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: ExportListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<DataExportsCursor, DataExport> {
+    return this._client.getAPIList('/v1/exports', Cursor<DataExport>, { query, ...options });
+  }
+}
+
+export type DataExportsCursor = Cursor<DataExport>;
+
+export interface DataExport {
+  id: string;
+
+  createdAt: string;
+
+  dataTypes: Array<'messages' | 'conversations' | 'webhookDeliveries' | 'agentExecutions' | 'activities'>;
+
+  /**
+   * When the export download link expires (24 hours after creation).
+   */
+  expiresAt: string;
+
+  /**
+   * Status of a data export job.
+   */
+  status: 'pending' | 'processing' | 'completed' | 'failed';
+
+  completedAt?: string | null;
+
+  dateFrom?: string | null;
+
+  dateTo?: string | null;
+
+  /**
+   * URL to download the export file. Only available when status is 'completed'.
+   */
+  downloadUrl?: string | null;
+
+  /**
+   * Error message if the export failed.
+   */
+  errorMessage?: string | null;
+
+  /**
+   * Size of the export file in bytes.
+   */
+  fileSize?: number | null;
+}
+
+export interface ExportCreateResponse {
+  export: DataExport;
+}
+
+export interface ExportRetrieveResponse {
+  export: DataExport;
+}
+
+export interface ExportCreateParams {
+  /**
+   * List of data types to include in the export.
+   */
+  dataTypes: Array<'messages' | 'conversations' | 'webhookDeliveries' | 'agentExecutions' | 'activities'>;
+
+  /**
+   * Start date for data to export (inclusive).
+   */
+  dateFrom?: string;
+
+  /**
+   * End date for data to export (inclusive).
+   */
+  dateTo?: string;
+}
+
+export interface ExportListParams extends CursorParams {
+  /**
+   * Status of a data export job.
+   */
+  status?: 'pending' | 'processing' | 'completed' | 'failed';
+}
+
+export declare namespace Exports {
+  export {
+    type DataExport as DataExport,
+    type ExportCreateResponse as ExportCreateResponse,
+    type ExportRetrieveResponse as ExportRetrieveResponse,
+    type DataExportsCursor as DataExportsCursor,
+    type ExportCreateParams as ExportCreateParams,
+    type ExportListParams as ExportListParams,
+  };
+}