@zavudev/sdk 0.57.0 → 0.58.0

package/src/resources/invitations.ts

@@ -1,35 +1,45 @@
-// 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, type CursorParams, PagePromise } from '../core/pagination';
+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 WebhookAPI from './invitations/webhook';
+import {
+  Webhook,
+  type WebhookRetrieveResponse,
+  type ProjectWebhook,
+  type WebhookConfigureParams,
+  type WebhookConfigureResponse,
+  type ProjectWebhookEvent,
+  type WebhookUpdateParams,
+  type WebhookUpdateResponse,
+} from './invitations/webhook';
 
 export class Invitations extends APIResource {
+  webhook: WebhookAPI.Webhook = new WebhookAPI.Webhook(this._client);
+
   /**
+   * Create invitation
+   *
    * Create a partner invitation link for a client to connect a Meta channel. The
    * client opens the returned `url` and authorizes with Meta; the resulting sender
    * is created in your project when they finish, and the invitation transitions to
    * `completed`.
    *
    * `connectionType` picks the channel:
-   *
    * - `whatsapp_waba` (default): Meta's embedded signup links an official WhatsApp
    *   Business Account.
    * - `messenger`: the client picks a Facebook Page they administer; its Messenger
    *   inbox (including Marketplace chats) is routed to Zavu.
    *
-   * One invitation connects one channel — create one per channel to onboard a client
-   * on several. `phoneNumberId` and `allowedPhoneCountries` apply to `whatsapp_waba`
-   * only.
+   * One invitation connects one channel — create one per channel to onboard a
+   * client on several. `phoneNumberId` and `allowedPhoneCountries` apply to
+   * `whatsapp_waba` only.
    *
-   * @example
-   * ```ts
-   * const invitation = await client.invitations.create({
-   *   clientName: 'Acme Corp',
-   * });
-   * ```
+   * `POST /v1/invitations`
    */
   create(
     body: InvitationCreateParams | null | undefined = {},
@@ -41,27 +51,18 @@ export class Invitations extends APIResource {
   /**
    * Get invitation
    *
-   * @example
-   * ```ts
-   * const invitation = await client.invitations.retrieve(
-   *   'invitationId',
-   * );
-   * ```
+   * `GET /v1/invitations/{invitationId}`
    */
   retrieve(invitationID: string, options?: RequestOptions): APIPromise<InvitationRetrieveResponse> {
     return this._client.get(path`/v1/invitations/${invitationID}`, options);
   }
 
   /**
+   * List invitations
+   *
    * List partner invitations for this project.
    *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const invitation of client.invitations.list()) {
-   *   // ...
-   * }
-   * ```
+   * `GET /v1/invitations`
    */
   list(
     query: InvitationListParams | null | undefined = {},
@@ -71,199 +72,34 @@ export class Invitations extends APIResource {
   }
 
   /**
+   * Cancel invitation
+   *
    * Cancel an active invitation. The client will no longer be able to use the
    * invitation link.
    *
-   * @example
-   * ```ts
-   * const response = await client.invitations.cancel(
-   *   'invitationId',
-   * );
-   * ```
+   * `POST /v1/invitations/{invitationId}/cancel`
    */
   cancel(invitationID: string, options?: RequestOptions): APIPromise<InvitationCancelResponse> {
     return this._client.post(path`/v1/invitations/${invitationID}/cancel`, options);
   }
 }
 
-export type InvitationsCursor = Cursor<Invitation>;
-
-export interface Invitation {
-  id: string;
-
-  /**
-   * Unique invitation token.
-   */
-  token: string;
-
-  createdAt: string;
-
-  expiresAt: string;
-
-  /**
-   * Current status of the partner invitation.
-   *
-   * `failed` means the client started the connection and it did not finish (they
-   * cancelled Meta's dialog, denied a permission, or abandoned the tab). A failed
-   * invitation is still usable: the same link can be retried, and it moves back to
-   * `in_progress` when the client tries again.
-   */
-  status: 'pending' | 'in_progress' | 'completed' | 'expired' | 'cancelled' | 'failed';
-
-  updatedAt: string;
-
-  /**
-   * Full URL to share with the client.
-   */
-  url: string;
-
-  clientEmail?: string | null;
-
-  clientName?: string | null;
-
-  clientPhone?: string | null;
-
-  completedAt?: string | null;
-
-  /**
-   * The account the client linked, populated once the invitation is `completed`.
-   * Null before that. Use it to show the partner what was connected without fetching
-   * the sender.
-   */
-  connectedAccount?: Invitation.ConnectedAccount | null;
-
-  /**
-   * Which Meta channel the client connects: `whatsapp_waba` (official WhatsApp Cloud
-   * API via embedded signup) or `messenger` (a Facebook Page's Messenger inbox,
-   * including Marketplace chats).
-   */
-  connectionType?: 'whatsapp_waba' | 'messenger';
-
-  failedAt?: string | null;
-
-  /**
-   * Stable code for why the last attempt failed, present when `status` is `failed`.
-   * Values include `fb_cancelled` (client closed Meta's dialog), `fb_not_authorized`
-   * (permission denied), `signup_abandoned` (started but never finished),
-   * `meta_no_pages` (the client administers no Facebook Page), and `internal_error`.
-   * Treat unknown codes as a generic failure.
-   */
-  failureReason?: string | null;
-
-  /**
-   * ID of a pre-assigned Zavu phone number for WhatsApp registration. Always null
-   * for `messenger` invitations.
-   */
-  phoneNumberId?: string | null;
-
-  /**
-   * ID of the sender created when invitation is completed.
-   */
-  senderId?: string | null;
-
-  startedAt?: string | null;
-
-  viewedAt?: string | null;
-}
+export type InvitationsCursor = Cursor<T.Invitation>;
 
+export type Invitation = T.Invitation;
 export namespace Invitation {
-  /**
-   * The account the client linked, populated once the invitation is `completed`.
-   * Null before that. Use it to show the partner what was connected without fetching
-   * the sender.
-   */
-  export interface ConnectedAccount {
-    /**
-     * Provider-side identifier: the WhatsApp phone number ID, or the Facebook Page ID.
-     */
-    id: string;
-
-    channel: 'whatsapp' | 'messenger';
-
-    /**
-     * Display name of the connected account: the WhatsApp verified name, or the
-     * Facebook Page name.
-     */
-    name?: string | null;
-  }
-}
-
-export interface InvitationCreateResponse {
-  invitation: Invitation;
+  export type ConnectedAccount = T.InvitationConnectedAccount;
 }
 
-export interface InvitationRetrieveResponse {
-  invitation: Invitation;
-}
-
-export interface InvitationCancelResponse {
-  invitation: Invitation;
-}
+export type InvitationCreateResponse = T.InvitationResponse;
 
-export interface InvitationCreateParams {
-  /**
-   * ISO country codes for allowed phone numbers. Only valid when `connectionType` is
-   * `whatsapp_waba` — sending it with `messenger` returns 400.
-   */
-  allowedPhoneCountries?: Array<string>;
+export type InvitationRetrieveResponse = T.InvitationResponse;
 
-  /**
-   * Email of the client being invited.
-   */
-  clientEmail?: string;
+export type InvitationCancelResponse = T.InvitationResponse;
 
-  /**
-   * Name of the client being invited.
-   */
-  clientName?: string;
+export type InvitationCreateParams = T.InvitationsCreateParams;
 
-  /**
-   * Phone number of the client in E.164 format.
-   */
-  clientPhone?: string;
-
-  /**
-   * Which Meta channel the client connects, and how.
-   *
-   * - `whatsapp_waba` (default): Meta's embedded signup links an official WhatsApp
-   *   Business Account. Accepts `phoneNumberId` and `allowedPhoneCountries`.
-   * - `messenger`: the client authorizes with Facebook and picks a Facebook Page
-   *   they administer. The Page's Messenger inbox — including Marketplace chats — is
-   *   routed to Zavu. They must be an admin of at least one Page. A Page can only be
-   *   connected to one Zavu project at a time: if the client picks a Page that
-   *   another project already connected, the newer connection wins and the older one
-   *   is disconnected.
-   *
-   * One invitation connects one channel. To onboard a client on several channels,
-   * create one invitation per channel; each completes into its own sender.
-   */
-  connectionType?: 'whatsapp_waba' | 'messenger';
-
-  /**
-   * Number of days until the invitation expires.
-   */
-  expiresInDays?: number;
-
-  /**
-   * ID of a Zavu phone number to pre-assign for WhatsApp registration. If provided,
-   * the client will use this number instead of their own. Only valid when
-   * `connectionType` is `whatsapp_waba` — sending it with `messenger` returns 400,
-   * since a Facebook Page has no phone number.
-   */
-  phoneNumberId?: string;
-}
-
-export interface InvitationListParams extends CursorParams {
-  /**
-   * Current status of the partner invitation.
-   *
-   * `failed` means the client started the connection and it did not finish (they
-   * cancelled Meta's dialog, denied a permission, or abandoned the tab). A failed
-   * invitation is still usable: the same link can be retried, and it moves back to
-   * `in_progress` when the client tries again.
-   */
-  status?: 'pending' | 'in_progress' | 'completed' | 'expired' | 'cancelled' | 'failed';
-}
+export type InvitationListParams = T.InvitationsListParams;
 
 export declare namespace Invitations {
   export {
@@ -274,5 +110,13 @@ export declare namespace Invitations {
     type InvitationsCursor as InvitationsCursor,
     type InvitationCreateParams as InvitationCreateParams,
     type InvitationListParams as InvitationListParams,
+    Webhook as Webhook,
+    type WebhookRetrieveResponse as WebhookRetrieveResponse,
+    type ProjectWebhook as ProjectWebhook,
+    type WebhookConfigureParams as WebhookConfigureParams,
+    type WebhookConfigureResponse as WebhookConfigureResponse,
+    type ProjectWebhookEvent as ProjectWebhookEvent,
+    type WebhookUpdateParams as WebhookUpdateParams,
+    type WebhookUpdateResponse as WebhookUpdateResponse,
   };
 }

package/src/resources/me.ts

@@ -1,47 +1,29 @@
-// 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 type * as T from '../types';
 
 export class Me extends APIResource {
   /**
+   * Get current API key context
+   *
    * Returns the project, team, and API key metadata bound to the current Bearer
    * token. Used by CLIs and SDKs to confirm which project they will operate on.
+   *
+   * `GET /v1/me`
    */
   retrieve(options?: RequestOptions): APIPromise<MeRetrieveResponse> {
     return this._client.get('/v1/me', options);
   }
 }
 
-export interface MeRetrieveResponse {
-  apiKey: MeRetrieveResponse.APIKey;
-
-  isTestMode: boolean;
-
-  project: MeRetrieveResponse.Project;
-
-  team: MeRetrieveResponse.Team;
-}
-
+export type MeRetrieveResponse = T.GetMeResponse;
 export namespace MeRetrieveResponse {
-  export interface APIKey {
-    id: string;
-  }
-
-  export interface Project {
-    id: string;
-
-    isSubAccount: boolean;
-
-    name: string | null;
-  }
-
-  export interface Team {
-    id: string;
-
-    name: string | null;
-  }
+  export type APIKey = T.GetMeResponseApiKey;
+  export type Project = T.GetMeResponseProject;
+  export type Team = T.GetMeResponseTeam;
 }
 
 export declare namespace Me {

package/src/resources/memory/collections/collections.ts

@@ -0,0 +1,149 @@
+// 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 ItemsAPI from './items';
+import {
+  Items,
+  type ItemListParams,
+  type MemoryItem,
+  type MemoryItemsCursor,
+  type ItemBatchParams,
+  type ItemBatchResponse,
+  type MemoryItemBatchResponse,
+  type ItemPutParams,
+  type ItemPutResponse,
+  type ItemRetrieveParams,
+  type ItemRetrieveResponse,
+  type ItemDeleteParams,
+  type ItemQueryParams,
+  type ItemQueryResponse,
+} from './items';
+
+export class Collections extends APIResource {
+  items: ItemsAPI.Items = new ItemsAPI.Items(this._client);
+
+  /**
+   * Create a collection
+   *
+   * Declare a collection of JSON documents addressed by key. This is the counterpart
+   * to facts: `POST /v1/memory` recalls by meaning, a collection recalls by key.
+   *
+   * **Create it explicitly when you need `query`.** Writing to an unknown collection
+   * creates it implicitly, but with no indexes — and indexes cannot be added
+   * afterwards. If you will ever look items up by a field rather than by key,
+   * declare that field here, before the first write.
+   *
+   * A collection is defined once for the project. Its ITEMS are per-scope, so the
+   * same collection holds a separate set of documents for the project, for each
+   * contact, and for each conversation.
+   *
+   * `POST /v1/memory/collections`
+   */
+  create(body: CollectionCreateParams, options?: RequestOptions): APIPromise<CollectionCreateResponse> {
+    return this._client.post('/v1/memory/collections', { body, ...options });
+  }
+
+  /**
+   * List collections
+   *
+   * `GET /v1/memory/collections`
+   */
+  list(
+    query: CollectionListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<MemoryCollectionsCursor, MemoryCollection> {
+    return this._client.getAPIList('/v1/memory/collections', Cursor<MemoryCollection>, { query, ...options });
+  }
+
+  /**
+   * Get a collection
+   *
+   * The collection's definition: its indexes, default TTL and status. Collections
+   * are project-level, so this takes no scope.
+   *
+   * `GET /v1/memory/collections/{collection}`
+   */
+  retrieve(collection: string, options?: RequestOptions): APIPromise<CollectionRetrieveResponse> {
+    return this._client.get(path`/v1/memory/collections/${collection}`, options);
+  }
+
+  /**
+   * Update a collection
+   *
+   * Only `defaultTtlSeconds` can change. Indexes are fixed at creation: changing
+   * them would require rewriting every item in the collection.
+   *
+   * `PATCH /v1/memory/collections/{collection}`
+   */
+  update(
+    collection: string,
+    body: CollectionUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<CollectionUpdateResponse> {
+    return this._client.patch(path`/v1/memory/collections/${collection}`, { body, ...options });
+  }
+
+  /**
+   * Delete a collection
+   *
+   * Delete the collection and every item it holds, **in every scope** — the
+   * per-contact and per-conversation copies included. Returns immediately; the purge
+   * drains in batches and writes are refused while `status` is `deleting`.
+   *
+   * `DELETE /v1/memory/collections/{collection}`
+   */
+  delete(collection: string, options?: RequestOptions): APIPromise<CollectionDeleteResponse> {
+    return this._client.delete(path`/v1/memory/collections/${collection}`, options);
+  }
+}
+
+export type CollectionCreateParams = T.MemoryCollectionsCreateParams;
+
+export type CollectionCreateResponse = T.CreateMemoryCollectionResponse;
+
+export type MemoryCollection = T.MemoryCollection;
+
+export type CollectionListParams = T.MemoryCollectionsListParams;
+
+export type MemoryCollectionsCursor = Cursor<T.MemoryCollection>;
+
+export type CollectionRetrieveResponse = T.GetMemoryCollectionResponse;
+
+export type CollectionUpdateParams = T.MemoryCollectionsUpdateParams;
+
+export type CollectionUpdateResponse = T.UpdateMemoryCollectionResponse;
+
+export type CollectionDeleteResponse = T.DeleteMemoryCollectionResponse;
+
+export declare namespace Collections {
+  export {
+    type CollectionCreateParams as CollectionCreateParams,
+    type CollectionCreateResponse as CollectionCreateResponse,
+    type CollectionDeleteResponse as CollectionDeleteResponse,
+    type CollectionListParams as CollectionListParams,
+    type CollectionRetrieveResponse as CollectionRetrieveResponse,
+    type CollectionUpdateParams as CollectionUpdateParams,
+    type CollectionUpdateResponse as CollectionUpdateResponse,
+    type MemoryCollection as MemoryCollection,
+    type MemoryCollectionsCursor as MemoryCollectionsCursor,
+    Items as Items,
+    type ItemListParams as ItemListParams,
+    type MemoryItem as MemoryItem,
+    type MemoryItemsCursor as MemoryItemsCursor,
+    type ItemBatchParams as ItemBatchParams,
+    type ItemBatchResponse as ItemBatchResponse,
+    type MemoryItemBatchResponse as MemoryItemBatchResponse,
+    type ItemPutParams as ItemPutParams,
+    type ItemPutResponse as ItemPutResponse,
+    type ItemRetrieveParams as ItemRetrieveParams,
+    type ItemRetrieveResponse as ItemRetrieveResponse,
+    type ItemDeleteParams as ItemDeleteParams,
+    type ItemQueryParams as ItemQueryParams,
+    type ItemQueryResponse as ItemQueryResponse,
+  };
+}

package/src/resources/memory/collections/index.ts

@@ -0,0 +1,30 @@
+// Generated by zavu-codegen from apps/docs/openapi.json. Do not edit: run `bun run codegen`.
+
+export {
+  Collections,
+  type CollectionCreateParams,
+  type CollectionCreateResponse,
+  type MemoryCollection,
+  type CollectionListParams,
+  type MemoryCollectionsCursor,
+  type CollectionRetrieveResponse,
+  type CollectionUpdateParams,
+  type CollectionUpdateResponse,
+  type CollectionDeleteResponse,
+} from './collections';
+export {
+  Items,
+  type ItemListParams,
+  type MemoryItem,
+  type MemoryItemsCursor,
+  type ItemBatchParams,
+  type ItemBatchResponse,
+  type MemoryItemBatchResponse,
+  type ItemPutParams,
+  type ItemPutResponse,
+  type ItemRetrieveParams,
+  type ItemRetrieveResponse,
+  type ItemDeleteParams,
+  type ItemQueryParams,
+  type ItemQueryResponse,
+} from './items';