@zavudev/sdk 0.56.0 → 0.58.0

package/src/resources/senders/telegram.ts

@@ -1,24 +1,21 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
 
 export class Telegram extends APIResource {
   /**
+   * Connect Telegram
+   *
    * Connect a Telegram bot to a sender. Provide the bot token from @BotFather; Zavu
    * validates it, registers the webhook, and routes the sender's Telegram messages
    * through it.
    *
-   * @example
-   * ```ts
-   * const response = await client.senders.telegram.connect(
-   *   'senderId',
-   *   { botToken: 'botToken' },
-   * );
-   * ```
+   * `POST /v1/senders/{senderId}/telegram`
    */
   connect(
     senderID: string,
@@ -29,12 +26,11 @@ export class Telegram extends APIResource {
   }
 
   /**
+   * Disconnect Telegram
+   *
    * Disconnect Telegram from a sender and remove the webhook.
    *
-   * @example
-   * ```ts
-   * await client.senders.telegram.disconnect('senderId');
-   * ```
+   * `DELETE /v1/senders/{senderId}/telegram`
    */
   disconnect(senderID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/v1/senders/${senderID}/telegram`, {
@@ -44,26 +40,12 @@ export class Telegram extends APIResource {
   }
 }
 
-export interface TelegramConnectResponse {
-  telegram: TelegramConnectResponse.Telegram;
-}
-
+export type TelegramConnectResponse = T.ConnectSenderTelegramResponse;
 export namespace TelegramConnectResponse {
-  export interface Telegram {
-    connected: boolean;
-
-    botId?: string;
-
-    botUsername?: string;
-  }
+  export type Telegram = T.ConnectSenderTelegramResponseTelegram;
 }
 
-export interface TelegramConnectParams {
-  /**
-   * Bot token from @BotFather.
-   */
-  botToken: string;
-}
+export type TelegramConnectParams = T.SendersTelegramConnectParams;
 
 export declare namespace Telegram {
   export {

package/src/resources/senders/whatsapp-sync.ts

@@ -1,38 +1,33 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
 
 export class WhatsappSync extends APIResource {
   /**
+   * Get WhatsApp sync status
+   *
    * Get the current sync status for a sender's WhatsApp coexistence account. Only
    * available for senders connected in coexistence mode (WhatsApp Business App +
    * Cloud API).
    *
-   * @example
-   * ```ts
-   * const whatsappSync =
-   *   await client.senders.whatsappSync.retrieve('senderId');
-   * ```
+   * `GET /v1/senders/{senderId}/whatsapp-sync`
    */
   retrieve(senderID: string, options?: RequestOptions): APIPromise<WhatsappSyncRetrieveResponse> {
     return this._client.get(path`/v1/senders/${senderID}/whatsapp-sync`, options);
   }
 
   /**
+   * Start contacts sync
+   *
    * Initiate contact names sync from the WhatsApp Business App. This imports contact
    * names stored in the app to Zavu. Only available for coexistence accounts with
    * active status.
    *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.senders.whatsappSync.startContactsSync(
-   *     'senderId',
-   *   );
-   * ```
+   * `POST /v1/senders/{senderId}/whatsapp-sync/contacts`
    */
   startContactsSync(
     senderID: string,
@@ -42,17 +37,13 @@ export class WhatsappSync extends APIResource {
   }
 
   /**
+   * Start history sync
+   *
    * Initiate message history sync from the WhatsApp Business App. This sends a
    * request to the account owner to approve sharing their conversation history. Only
    * available for coexistence accounts with active status.
    *
-   * @example
-   * ```ts
-   * const response =
-   *   await client.senders.whatsappSync.startHistorySync(
-   *     'senderId',
-   *   );
-   * ```
+   * `POST /v1/senders/{senderId}/whatsapp-sync/history`
    */
   startHistorySync(
     senderID: string,
@@ -62,106 +53,17 @@ export class WhatsappSync extends APIResource {
   }
 }
 
-/**
- * Contacts sync status details.
- */
-export interface WhatsAppSyncContacts {
-  /**
-   * Whether contacts sync can be initiated.
-   */
-  canSync: boolean;
-
-  /**
-   * Status of WhatsApp contacts sync.
-   */
-  status: 'not_requested' | 'pending' | 'syncing' | 'completed';
-
-  /**
-   * When the sync was last requested.
-   */
-  requestedAt?: string | null;
-}
-
-/**
- * History sync status details.
- */
-export interface WhatsAppSyncHistory {
-  /**
-   * Whether history sync can be initiated.
-   */
-  canSync: boolean;
+export type WhatsAppSyncContacts = T.WhatsAppSyncContacts;
 
-  /**
-   * Status of WhatsApp message history sync.
-   */
-  status: 'not_requested' | 'pending' | 'syncing' | 'completed' | 'rejected';
+export type WhatsAppSyncHistory = T.WhatsAppSyncHistory;
 
-  /**
-   * When the sync was completed.
-   */
-  completedAt?: string | null;
+export type WhatsAppSyncStatus = T.WhatsAppSyncStatus;
 
-  /**
-   * When the sync was last requested.
-   */
-  requestedAt?: string | null;
-}
+export type WhatsappSyncRetrieveResponse = T.WhatsAppSyncStatusResponse;
 
-/**
- * WhatsApp coexistence sync status.
- */
-export interface WhatsAppSyncStatus {
-  /**
-   * Contacts sync status details.
-   */
-  contacts: WhatsAppSyncContacts;
+export type WhatsappSyncStartContactsSyncResponse = T.WhatsAppSyncStartResponse;
 
-  /**
-   * History sync status details.
-   */
-  history: WhatsAppSyncHistory;
-
-  /**
-   * Whether the account is in coexistence mode.
-   */
-  isCoexistence: boolean;
-
-  /**
-   * WhatsApp account status.
-   */
-  status: 'pending_verification' | 'pending_registration' | 'active' | 'disconnected' | 'error';
-}
-
-export interface WhatsappSyncRetrieveResponse {
-  /**
-   * WhatsApp coexistence sync status.
-   */
-  sync: WhatsAppSyncStatus;
-}
-
-export interface WhatsappSyncStartContactsSyncResponse {
-  /**
-   * Success message.
-   */
-  message: string;
-
-  /**
-   * WhatsApp coexistence sync status.
-   */
-  sync: WhatsAppSyncStatus;
-}
-
-export interface WhatsappSyncStartHistorySyncResponse {
-  /**
-   * Success message.
-   */
-  message: string;
-
-  /**
-   * WhatsApp coexistence sync status.
-   */
-  sync: WhatsAppSyncStatus;
-}
+export type WhatsappSyncStartHistorySyncResponse = T.WhatsAppSyncStartResponse;
 
 export declare namespace WhatsappSync {
   export {

package/src/resources/senders.ts

@@ -1,3 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export * from './senders/index';

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

@@ -1,51 +1,44 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../core/resource';
 import { APIPromise } from '../../core/api-promise';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
 
 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
-   * const apiKey = await client.subAccounts.apiKeys.create(
-   *   'id',
-   *   { name: 'Production Key', environment: 'live' },
-   * );
-   * ```
+   * `POST /v1/sub-accounts/{id}/api-keys`
    */
   create(id: string, body: APIKeyCreateParams, options?: RequestOptions): APIPromise<APIKeyCreateResponse> {
     return this._client.post(path`/v1/sub-accounts/${id}/api-keys`, { body, ...options });
   }
 
   /**
+   * 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
-   * const apiKeys = await client.subAccounts.apiKeys.list('id');
-   * ```
+   * `GET /v1/sub-accounts/{id}/api-keys`
    */
   list(id: string, options?: RequestOptions): APIPromise<APIKeyListResponse> {
     return this._client.get(path`/v1/sub-accounts/${id}/api-keys`, options);
   }
 
   /**
+   * 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
-   * await client.subAccounts.apiKeys.revoke('keyId', {
-   *   id: 'id',
-   * });
-   * ```
+   * `DELETE /v1/sub-accounts/{id}/api-keys/{keyId}`
    */
   revoke(keyID: string, params: APIKeyRevokeParams, options?: RequestOptions): APIPromise<void> {
     const { id } = params;
@@ -56,68 +49,19 @@ export class APIKeys extends APIResource {
   }
 }
 
-export interface APIKeyCreateResponse {
-  apiKey: APIKeyCreateResponse.APIKey;
-}
-
+export type APIKeyCreateResponse = T.CreateSubAccountApiKeyResponse;
 export namespace APIKeyCreateResponse {
-  export interface APIKey {
-    id: string;
-
-    environment: 'live' | 'test';
-
-    key: string;
-
-    name: string;
-  }
-}
-
-export interface APIKeyListResponse {
-  items: Array<APIKeyListResponse.Item>;
+  export type APIKey = T.CreateSubAccountApiKeyResponseApiKey;
 }
 
+export type APIKeyListResponse = T.ListSubAccountApiKeysResponse;
 export namespace APIKeyListResponse {
-  export interface Item {
-    id: string;
-
-    createdAt: number;
-
-    environment: 'live' | 'test';
-
-    /**
-     * First characters of the key for identification.
-     */
-    keyPrefix: string;
-
-    name: string;
-
-    /**
-     * Full API key. Only returned on creation.
-     */
-    key?: string;
-
-    lastUsedAt?: number | null;
-
-    permissions?: Array<string>;
-
-    revokedAt?: number | null;
-  }
+  export type Item = T.SubAccountApiKey;
 }
 
-export interface APIKeyCreateParams {
-  name: string;
+export type APIKeyCreateParams = T.SubAccountsApiKeysCreateParams;
 
-  environment?: 'live' | 'test';
-
-  permissions?: Array<string>;
-}
-
-export interface APIKeyRevokeParams {
-  /**
-   * Sub-account ID.
-   */
-  id: string;
-}
+export type APIKeyRevokeParams = T.SubAccountsApiKeysRevokeParams;
 
 export declare namespace APIKeys {
   export {

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

@@ -1,4 +1,4 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export {
   APIKeys,

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

@@ -1,60 +1,56 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { Cursor, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+import type * as T from '../../types';
 import * as APIKeysAPI from './api-keys';
 import {
-  APIKeyCreateParams,
-  APIKeyCreateResponse,
-  APIKeyListResponse,
-  APIKeyRevokeParams,
   APIKeys,
+  type APIKeyCreateResponse,
+  type APIKeyListResponse,
+  type APIKeyCreateParams,
+  type APIKeyRevokeParams,
 } from './api-keys';
-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 SubAccounts extends APIResource {
   apiKeys: APIKeysAPI.APIKeys = new APIKeysAPI.APIKeys(this._client);
 
   /**
+   * Create sub-account
+   *
    * 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. Requires a
    * parent project API key; sub-account API keys receive HTTP 403.
    *
-   * @example
-   * ```ts
-   * const subAccount = await client.subAccounts.create({
-   *   name: 'Client ABC',
-   * });
-   * ```
+   * `POST /v1/sub-accounts`
    */
   create(body: SubAccountCreateParams, options?: RequestOptions): APIPromise<SubAccountCreateResponse> {
     return this._client.post('/v1/sub-accounts', { body, ...options });
   }
 
   /**
+   * Get sub-account
+   *
    * Get sub-account. Requires a parent project API key; sub-account API keys receive
    * HTTP 403.
    *
-   * @example
-   * ```ts
-   * const subAccount = await client.subAccounts.retrieve('id');
-   * ```
+   * `GET /v1/sub-accounts/{id}`
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<SubAccountRetrieveResponse> {
     return this._client.get(path`/v1/sub-accounts/${id}`, options);
   }
 
   /**
+   * Update sub-account
+   *
    * Update sub-account. Requires a parent project API key; sub-account API keys
    * receive HTTP 403.
    *
-   * @example
-   * ```ts
-   * const subAccount = await client.subAccounts.update('id');
-   * ```
+   * `PATCH /v1/sub-accounts/{id}`
    */
   update(
     id: string,
@@ -65,16 +61,12 @@ export class SubAccounts extends APIResource {
   }
 
   /**
+   * List sub-accounts
+   *
    * List sub-accounts for this team. Requires a parent project API key; sub-account
    * API keys receive HTTP 403.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const subAccount of client.subAccounts.list()) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/sub-accounts`
    */
   list(
     query: SubAccountListParams | null | undefined = {},
@@ -84,149 +76,51 @@ export class SubAccounts extends APIResource {
   }
 
   /**
+   * Deactivate sub-account
+   *
    * Deactivate a sub-account. Remaining balance is returned to the parent team and
    * all API keys are revoked. Requires a parent project API key; sub-account API
    * keys receive HTTP 403.
    *
-   * @example
-   * ```ts
-   * const response = await client.subAccounts.deactivate('id');
-   * ```
+   * `DELETE /v1/sub-accounts/{id}`
    */
   deactivate(id: string, options?: RequestOptions): APIPromise<SubAccountDeactivateResponse> {
     return this._client.delete(path`/v1/sub-accounts/${id}`, options);
   }
 
   /**
+   * Get sub-account spending
+   *
    * 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). Requires
    * a parent project API key; sub-account API keys receive HTTP 403.
    *
-   * @example
-   * ```ts
-   * const response = await client.subAccounts.getBalance('id');
-   * ```
+   * `GET /v1/sub-accounts/{id}/balance`
    */
   getBalance(id: string, options?: RequestOptions): APIPromise<SubAccountGetBalanceResponse> {
     return this._client.get(path`/v1/sub-accounts/${id}/balance`, options);
   }
 }
 
-export type SubAccountsCursor = Cursor<SubAccount>;
-
-export interface SubAccount {
-  id: string;
-
-  createdAt: string;
-
-  name: string;
-
-  status: 'active' | 'inactive';
-
-  /**
-   * Total amount spent by this sub-account in cents.
-   */
-  totalSpent: number;
-
-  /**
-   * API key for the sub-account. Only returned on creation.
-   */
-  apiKey?: string;
-
-  /**
-   * Spending cap in cents. When reached, messages from this sub-account will be
-   * blocked.
-   */
-  creditLimit?: number | null;
-
-  /**
-   * External reference ID set by the parent account.
-   */
-  externalId?: string | null;
-
-  metadata?: { [key: string]: unknown } | null;
-}
-
-export interface SubAccountCreateResponse {
-  subAccount: SubAccount;
-}
-
-export interface SubAccountRetrieveResponse {
-  subAccount: SubAccount;
-}
-
-export interface SubAccountUpdateResponse {
-  subAccount: SubAccount;
-}
-
-export interface SubAccountDeactivateResponse {
-  /**
-   * Number of API keys revoked.
-   */
-  keysRevoked: number;
-
-  message: string;
-}
-
-export interface SubAccountGetBalanceResponse {
-  /**
-   * 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 interface SubAccountCreateParams {
-  /**
-   * Name of the sub-account.
-   */
-  name: string;
+export type SubAccountsCursor = Cursor<T.SubAccount>;
 
-  /**
-   * Spending cap in cents. When reached, messages from this sub-account will be
-   * blocked. Omit or set to 0 for no limit.
-   */
-  creditLimit?: number;
+export type SubAccount = T.SubAccount;
 
-  /**
-   * External reference ID for your own tracking.
-   */
-  externalId?: string;
-
-  metadata?: { [key: string]: unknown };
-}
+export type SubAccountCreateResponse = T.SubAccountResponse;
 
-export interface SubAccountUpdateParams {
-  creditLimit?: number | null;
+export type SubAccountRetrieveResponse = T.SubAccountResponse;
 
-  externalId?: string;
+export type SubAccountUpdateResponse = T.SubAccountResponse;
 
-  metadata?: { [key: string]: unknown };
+export type SubAccountDeactivateResponse = T.DeactivateSubAccountResponse;
 
-  name?: string;
+export type SubAccountGetBalanceResponse = T.BalanceResponse;
 
-  status?: 'active' | 'inactive';
-}
+export type SubAccountCreateParams = T.SubAccountsCreateParams;
 
-export interface SubAccountListParams extends CursorParams {}
+export type SubAccountUpdateParams = T.SubAccountsUpdateParams;
 
-SubAccounts.APIKeys = APIKeys;
+export type SubAccountListParams = T.SubAccountsListParams;
 
 export declare namespace SubAccounts {
   export {
@@ -240,9 +134,6 @@ export declare namespace SubAccounts {
     type SubAccountCreateParams as SubAccountCreateParams,
     type SubAccountUpdateParams as SubAccountUpdateParams,
     type SubAccountListParams as SubAccountListParams,
-  };
-
-  export {
     APIKeys as APIKeys,
     type APIKeyCreateResponse as APIKeyCreateResponse,
     type APIKeyListResponse as APIKeyListResponse,

package/src/resources/sub-accounts.ts

@@ -1,3 +1,3 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
 
 export * from './sub-accounts/index';