@whop/sdk 0.0.27 → 0.0.29

package/src/resources/ai-chats.ts

@@ -8,7 +8,7 @@ import { path } from '../internal/utils/path';
 
 export class AIChats extends APIResource {
   /**
-   * Creates a new AI chat
+   * Create a new AI chat thread and send the first message to the AI agent.
    *
    * Required permissions:
    *
@@ -19,14 +19,14 @@ export class AIChats extends APIResource {
   }
 
   /**
-   * Fetches a single AI chat by ID
+   * Retrieves the details of an existing AI chat.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<AIChat> {
     return this._client.get(path`/ai_chats/${id}`, options);
   }
 
   /**
-   * Updates an AI chat
+   * Update an AI chat's title or associated company context.
    *
    * Required permissions:
    *
@@ -41,7 +41,7 @@ export class AIChats extends APIResource {
   }
 
   /**
-   * Fetches all AI chats for the current user
+   * Returns a paginated list of AI chat threads for the current authenticated user.
    */
   list(
     query: AIChatListParams | null | undefined = {},
@@ -51,7 +51,7 @@ export class AIChats extends APIResource {
   }
 
   /**
-   * Deletes an AI chat
+   * Delete an AI chat thread so it no longer appears in the user's chat list.
    *
    * Required permissions:
    *
@@ -65,7 +65,8 @@ export class AIChats extends APIResource {
 export type AIChatListResponsesCursorPage = CursorPage<AIChatListResponse>;
 
 /**
- * An AI chat conversation belonging to a user
+ * An AI-powered chat conversation belonging to a user, with optional scheduled
+ * automation.
  */
 export interface AIChat {
   /**
@@ -74,7 +75,7 @@ export interface AIChat {
   id: string;
 
   /**
-   * The total number of tokens used in the chat
+   * The total number of tokens consumed across all messages in this conversation.
    */
   blended_token_usage: string;
 
@@ -84,17 +85,19 @@ export interface AIChat {
   created_at: string;
 
   /**
-   * When the last message was sent
+   * The timestamp of the most recent message in this conversation. Null if no
+   * messages have been sent yet.
    */
   last_message_at: string | null;
 
   /**
-   * The number of messages in the chat
+   * The total number of messages exchanged in this conversation.
    */
   message_count: number;
 
   /**
-   * The title of the AI chat
+   * A short descriptive title for this AI chat conversation. Null if no title has
+   * been set.
    */
   title: string | null;
 
@@ -104,14 +107,14 @@ export interface AIChat {
   updated_at: string;
 
   /**
-   * The user who owns the AI chat
+   * The user who owns this AI chat conversation.
    */
   user: AIChat.User;
 }
 
 export namespace AIChat {
   /**
-   * The user who owns the AI chat
+   * The user who owns this AI chat conversation.
    */
   export interface User {
     /**
@@ -122,7 +125,8 @@ export namespace AIChat {
 }
 
 /**
- * An AI chat conversation belonging to a user
+ * An AI-powered chat conversation belonging to a user, with optional scheduled
+ * automation.
  */
 export interface AIChatListResponse {
   /**
@@ -131,7 +135,7 @@ export interface AIChatListResponse {
   id: string;
 
   /**
-   * The total number of tokens used in the chat
+   * The total number of tokens consumed across all messages in this conversation.
    */
   blended_token_usage: string;
 
@@ -141,17 +145,19 @@ export interface AIChatListResponse {
   created_at: string;
 
   /**
-   * When the last message was sent
+   * The timestamp of the most recent message in this conversation. Null if no
+   * messages have been sent yet.
    */
   last_message_at: string | null;
 
   /**
-   * The number of messages in the chat
+   * The total number of messages exchanged in this conversation.
    */
   message_count: number;
 
   /**
-   * The title of the AI chat
+   * A short descriptive title for this AI chat conversation. Null if no title has
+   * been set.
    */
   title: string | null;
 
@@ -161,14 +167,14 @@ export interface AIChatListResponse {
   updated_at: string;
 
   /**
-   * The user who owns the AI chat
+   * The user who owns this AI chat conversation.
    */
   user: AIChatListResponse.User;
 }
 
 export namespace AIChatListResponse {
   /**
-   * The user who owns the AI chat
+   * The user who owns this AI chat conversation.
    */
   export interface User {
     /**
@@ -185,23 +191,29 @@ export type AIChatDeleteResponse = boolean;
 
 export interface AIChatCreateParams {
   /**
-   * The text content of the first message sent in the chat
+   * The text content of the first message to send to the AI agent.
    */
   message_text: string;
 
   /**
-   * The ID of the company to set as the current company in context for the AI chat
+   * The unique identifier of the company to set as context for the AI chat (e.g.,
+   * "biz_XXXXX").
    */
   current_company_id?: string | null;
 
   /**
-   * The IDs of existing uploaded attachments to include in the first message to the
-   * agent
+   * A list of previously uploaded file attachments to include with the first
+   * message.
    */
   message_attachments?: Array<AIChatCreateParams.MessageAttachment> | null;
 
   /**
-   * The title of the AI chat
+   * The source of an AI chat message
+   */
+  message_source?: 'manual' | 'suggestion' | 'link' | null;
+
+  /**
+   * An optional display title for the AI chat thread (e.g., "Help with billing").
    */
   title?: string | null;
 }
@@ -220,12 +232,13 @@ export namespace AIChatCreateParams {
 
 export interface AIChatUpdateParams {
   /**
-   * The ID of the company to set as the current company in context for the AI chat
+   * The unique identifier of the company to set as context for the AI chat (e.g.,
+   * "biz_XXXXX").
    */
   current_company_id?: string | null;
 
   /**
-   * The new title for the AI chat
+   * The new display title for the AI chat thread (e.g., "Help with billing").
    */
   title?: string | null;
 }

package/src/resources/app-builds.ts

@@ -9,7 +9,8 @@ import { path } from '../internal/utils/path';
 
 export class AppBuilds extends APIResource {
   /**
-   * Creates a new app build
+   * Upload a new build artifact for an app. The build must include a compiled code
+   * bundle for the specified platform.
    *
    * Required permissions:
    *
@@ -29,7 +30,7 @@ export class AppBuilds extends APIResource {
   }
 
   /**
-   * Retrieves an app build by ID
+   * Retrieves the details of an existing app build.
    *
    * Required permissions:
    *
@@ -47,7 +48,8 @@ export class AppBuilds extends APIResource {
   }
 
   /**
-   * Lists app builds for an app
+   * Returns a paginated list of build artifacts for a given app, with optional
+   * filtering by platform, status, and creation date.
    *
    * Required permissions:
    *
@@ -71,7 +73,8 @@ export class AppBuilds extends APIResource {
   }
 
   /**
-   * Promotes an app build to production
+   * Promote an approved or draft app build to production so it becomes the active
+   * version served to users.
    *
    * Required permissions:
    *
@@ -92,7 +95,8 @@ export class AppBuilds extends APIResource {
 export type AppBuildListResponsesCursorPage = CursorPage<AppBuildListResponse>;
 
 /**
- * An App Build object representing a build of an application
+ * A versioned build artifact for a Whop React Native App, submitted for review and
+ * deployment to a specific platform.
  */
 export interface AppBuildListResponse {
   /**
@@ -101,8 +105,8 @@ export interface AppBuildListResponse {
   id: string;
 
   /**
-   * This is generated by the client and used to verify the integrity of the file
-   * that is submitted. It is a SHA256 hash of the app build file.
+   * A SHA-256 hash of the uploaded build file, generated by the client and used to
+   * verify file integrity.
    */
   checksum: string;
 
@@ -112,81 +116,79 @@ export interface AppBuildListResponse {
   created_at: string;
 
   /**
-   * The URL to download the app build .zip file.
+   * A URL to download the app build as a .zip archive.
    */
   file_url: string;
 
   /**
-   * Whether this app build is currently being used in production.
+   * Whether this build is the currently active production build for its platform.
    */
   is_production: boolean;
 
   /**
-   * The platform of the app build (ios, android, web)
+   * The target platform for this build.
    */
   platform: Shared.AppBuildPlatforms;
 
   /**
-   * The review message for the app build, if any. This is populated when the build
-   * is rejected and there is a reason specified by the reviewer.
+   * Feedback from the reviewer explaining why the build was rejected. Null if the
+   * build has not been reviewed or was approved.
    */
   review_message: string | null;
 
   /**
-   * The status of the app build (draft, approved, rejected, pending, etc)
+   * The current review status of this build.
    */
   status: Shared.AppBuildStatuses;
 
   /**
-   * The supported app view types for the app build. These are the views that the
-   * developer has specified that this build supports.
+   * The list of view types this build supports, as declared by the developer.
    */
   supported_app_view_types: Array<Shared.AppViewType>;
 }
 
 export interface AppBuildCreateParams {
   /**
-   * Attachment input for the app build file. This should be an upload in .zip
-   * format. The zip should contain at least one main_js_bundle.hbc file and
-   * optionally an assets folder next to it.
+   * The build file to upload. For iOS and Android, this should be a .zip archive
+   * containing a main_js_bundle.hbc file and an optional assets folder. For web,
+   * this should be a JavaScript file.
    */
   attachment: AppBuildCreateParams.Attachment;
 
   /**
-   * Checksum of the app build file. This is generated by the client and used to
-   * verify the integrity of the file that is submitted when un-packaged later on a
-   * device.
+   * A client-generated checksum of the build file, used to verify file integrity
+   * when unpacked on a device.
    */
   checksum: string;
 
   /**
-   * The platform of the app build (ios, android, web)
+   * The target platform for the build. Accepted values: ios, android, web.
    */
   platform: Shared.AppBuildPlatforms;
 
   /**
-   * The id of the ai prompt that created this build
+   * The identifier of the AI prompt that generated this build, if applicable.
    */
   ai_prompt_id?: string | null;
 
   /**
-   * The ID of the app to create a build for. By default the current app from the api
-   * key is used.
+   * The unique identifier of the app to create the build for. Defaults to the app
+   * associated with the current API key.
    */
   app_id?: string | null;
 
   /**
-   * Supported app view types for the app build. A build can specify multiple view
-   * types, but should only specify ones that its code supports.
+   * The view types this build supports. A build can support multiple view types but
+   * should only list the ones its code implements.
    */
   supported_app_view_types?: Array<Shared.AppViewType> | null;
 }
 
 export namespace AppBuildCreateParams {
   /**
-   * Attachment input for the app build file. This should be an upload in .zip
-   * format. The zip should contain at least one main_js_bundle.hbc file and
-   * optionally an assets folder next to it.
+   * The build file to upload. For iOS and Android, this should be a .zip archive
+   * containing a main_js_bundle.hbc file and an optional assets folder. For web,
+   * this should be a JavaScript file.
    */
   export interface Attachment {
     /**
@@ -198,7 +200,7 @@ export namespace AppBuildCreateParams {
 
 export interface AppBuildListParams extends CursorPageParams {
   /**
-   * The ID of the app to filter app builds by
+   * The unique identifier of the app to list builds for.
    */
   app_id: string;
 
@@ -208,12 +210,12 @@ export interface AppBuildListParams extends CursorPageParams {
   before?: string | null;
 
   /**
-   * The minimum creation date to filter by
+   * Only return builds created after this timestamp.
    */
   created_after?: string | null;
 
   /**
-   * The maximum creation date to filter by
+   * Only return builds created before this timestamp.
    */
   created_before?: string | null;