@whop/sdk 0.0.26 → 0.0.28

package/src/resources/leads.ts

@@ -8,7 +8,8 @@ import { path } from '../internal/utils/path';
 
 export class Leads extends APIResource {
   /**
-   * Creates a new lead
+   * Record a new lead for a company, capturing a potential customer's interest in a
+   * specific product.
    *
    * Required permissions:
    *
@@ -29,7 +30,7 @@ export class Leads extends APIResource {
   }
 
   /**
-   * Retrieves a lead by ID
+   * Retrieves the details of an existing lead.
    *
    * Required permissions:
    *
@@ -50,7 +51,7 @@ export class Leads extends APIResource {
   }
 
   /**
-   * Updates a lead
+   * Update the metadata or referrer information on an existing lead record.
    *
    * Required permissions:
    *
@@ -75,7 +76,8 @@ export class Leads extends APIResource {
   }
 
   /**
-   * Lists leads for a company
+   * Returns a paginated list of leads for a company, with optional filtering by
+   * product and creation date.
    *
    * Required permissions:
    *
@@ -105,194 +107,210 @@ export class Leads extends APIResource {
 export type LeadListResponsesCursorPage = CursorPage<LeadListResponse>;
 
 /**
- * An object representing a lead (someone who is interested in a whop).
+ * A prospective customer who has expressed interest in a company or product but
+ * has not yet purchased.
  */
 export interface Lead {
   /**
-   * The ID of the lead.
+   * The unique identifier for the lead.
    */
   id: string;
 
   /**
-   * The timestamp of when the lead was created.
+   * The datetime the lead was created.
    */
   created_at: string;
 
   /**
-   * The converted member, if any.
+   * The company member record if this lead has converted into a paying customer.
+   * Null if the lead has not converted.
    */
   member: Lead.Member | null;
 
   /**
-   * Custom metadata for the lead.
+   * Custom key-value pairs attached to this lead. Null if no metadata was provided.
    */
   metadata: { [key: string]: unknown } | null;
 
   /**
-   * The access pass the lead is interested in, if available.
+   * The product the lead expressed interest in. Null if the lead is not associated
+   * with a specific product.
    */
   product: Lead.Product | null;
 
   /**
-   * The referrer URL that brought this lead.
+   * The URL of the page that referred this lead to the company. Null if no referrer
+   * was captured.
    */
   referrer: string | null;
 
   /**
-   * The timestamp of when the lead was last updated.
+   * The datetime the lead was last updated.
    */
   updated_at: string;
 
   /**
-   * The user who is the lead.
+   * The user account associated with this lead.
    */
   user: Lead.User;
 }
 
 export namespace Lead {
   /**
-   * The converted member, if any.
+   * The company member record if this lead has converted into a paying customer.
+   * Null if the lead has not converted.
    */
   export interface Member {
     /**
-     * The ID of the member
+     * The unique identifier for the company member.
      */
     id: string;
   }
 
   /**
-   * The access pass the lead is interested in, if available.
+   * The product the lead expressed interest in. Null if the lead is not associated
+   * with a specific product.
    */
   export interface Product {
     /**
-     * The internal ID of the public product.
+     * The unique identifier for the product.
      */
     id: string;
 
     /**
-     * The title of the product. Use for Whop 4.0.
+     * The display name of the product shown to customers on the product page and in
+     * search results.
      */
     title: string;
   }
 
   /**
-   * The user who is the lead.
+   * The user account associated with this lead.
    */
   export interface User {
     /**
-     * The internal ID of the user.
+     * The unique identifier for the user.
      */
     id: string;
 
     /**
-     * The email of the user
+     * The user's email address. Requires the member:email:read permission to access.
+     * Null if not authorized.
      */
     email: string | null;
 
     /**
-     * The name of the user from their Whop account.
+     * The user's display name shown on their public profile.
      */
     name: string | null;
 
     /**
-     * The username of the user from their Whop account.
+     * The user's unique username shown on their public profile.
      */
     username: string;
   }
 }
 
 /**
- * An object representing a lead (someone who is interested in a whop).
+ * A prospective customer who has expressed interest in a company or product but
+ * has not yet purchased.
  */
 export interface LeadListResponse {
   /**
-   * The ID of the lead.
+   * The unique identifier for the lead.
    */
   id: string;
 
   /**
-   * The timestamp of when the lead was created.
+   * The datetime the lead was created.
    */
   created_at: string;
 
   /**
-   * The converted member, if any.
+   * The company member record if this lead has converted into a paying customer.
+   * Null if the lead has not converted.
    */
   member: LeadListResponse.Member | null;
 
   /**
-   * Custom metadata for the lead.
+   * Custom key-value pairs attached to this lead. Null if no metadata was provided.
    */
   metadata: { [key: string]: unknown } | null;
 
   /**
-   * The access pass the lead is interested in, if available.
+   * The product the lead expressed interest in. Null if the lead is not associated
+   * with a specific product.
    */
   product: LeadListResponse.Product | null;
 
   /**
-   * The referrer URL that brought this lead.
+   * The URL of the page that referred this lead to the company. Null if no referrer
+   * was captured.
    */
   referrer: string | null;
 
   /**
-   * The timestamp of when the lead was last updated.
+   * The datetime the lead was last updated.
    */
   updated_at: string;
 
   /**
-   * The user who is the lead.
+   * The user account associated with this lead.
    */
   user: LeadListResponse.User;
 }
 
 export namespace LeadListResponse {
   /**
-   * The converted member, if any.
+   * The company member record if this lead has converted into a paying customer.
+   * Null if the lead has not converted.
    */
   export interface Member {
     /**
-     * The ID of the member
+     * The unique identifier for the company member.
      */
     id: string;
   }
 
   /**
-   * The access pass the lead is interested in, if available.
+   * The product the lead expressed interest in. Null if the lead is not associated
+   * with a specific product.
    */
   export interface Product {
     /**
-     * The internal ID of the public product.
+     * The unique identifier for the product.
      */
     id: string;
 
     /**
-     * The title of the product. Use for Whop 4.0.
+     * The display name of the product shown to customers on the product page and in
+     * search results.
      */
     title: string;
   }
 
   /**
-   * The user who is the lead.
+   * The user account associated with this lead.
    */
   export interface User {
     /**
-     * The internal ID of the user.
+     * The unique identifier for the user.
      */
     id: string;
 
     /**
-     * The email of the user
+     * The user's email address. Requires the member:email:read permission to access.
+     * Null if not authorized.
      */
     email: string | null;
 
     /**
-     * The name of the user from their Whop account.
+     * The user's display name shown on their public profile.
      */
     name: string | null;
 
     /**
-     * The username of the user from their Whop account.
+     * The user's unique username shown on their public profile.
      */
     username: string;
   }
@@ -300,47 +318,51 @@ export namespace LeadListResponse {
 
 export interface LeadCreateParams {
   /**
-   * The ID of the company to create a lead for.
+   * The unique identifier of the company to create the lead for, starting with
+   * 'biz\_'.
    */
   company_id: string;
 
   /**
-   * Custom metadata for the lead.
+   * A JSON object of custom metadata to attach to the lead for tracking purposes.
    */
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * The ID of the product the lead is interested in.
+   * The unique identifier of the product the lead is interested in, starting with
+   * 'prod\_'.
    */
   product_id?: string | null;
 
   /**
-   * The url referrer of the lead, if any.
+   * The referral URL that brought the lead to the company, such as
+   * 'https://example.com/landing'.
    */
   referrer?: string | null;
 
   /**
-   * The ID of the user to create a lead for. If the request is made by a user, that
-   * user will be used.
+   * The unique identifier of the user to record as the lead. If authenticated as a
+   * user, that user is used automatically.
    */
   user_id?: string | null;
 }
 
 export interface LeadUpdateParams {
   /**
-   * Custom metadata for the lead.
+   * A JSON object of custom metadata to set on the lead, replacing any existing
+   * metadata.
    */
   metadata?: { [key: string]: unknown } | null;
 
   /**
-   * The url referrer of the lead.
+   * The updated referral URL for the lead, such as 'https://example.com/landing'.
    */
   referrer?: string | null;
 }
 
 export interface LeadListParams extends CursorPageParams {
   /**
-   * The ID of the company to list leads for
+   * The unique identifier of the company to list leads for.
    */
   company_id: string;
 
@@ -350,12 +372,12 @@ export interface LeadListParams extends CursorPageParams {
   before?: string | null;
 
   /**
-   * The minimum creation date to filter by
+   * Only return leads created after this timestamp.
    */
   created_after?: string | null;
 
   /**
-   * The maximum creation date to filter by
+   * Only return leads created before this timestamp.
    */
   created_before?: string | null;
 
@@ -370,7 +392,7 @@ export interface LeadListParams extends CursorPageParams {
   last?: number | null;
 
   /**
-   * The product IDs to filter the leads by
+   * Filter leads to only those associated with these specific product identifiers.
    */
   product_ids?: Array<string> | null;
 }

package/src/resources/ledger-accounts.ts

@@ -9,7 +9,7 @@ import { path } from '../internal/utils/path';
 
 export class LedgerAccounts extends APIResource {
   /**
-   * Retrieves a ledger account by its ID, company ID or user ID
+   * Retrieves the details of an existing ledger account.
    *
    * Required permissions:
    *
@@ -22,11 +22,12 @@ export class LedgerAccounts extends APIResource {
 }
 
 /**
- * Represents a LedgerAccount.
+ * A ledger account represents a financial account on Whop that can hold many
+ * balances.
  */
 export interface LedgerAccountRetrieveResponse {
   /**
-   * The ID of the LedgerAccount.
+   * The unique identifier for the ledger account.
    */
   id: string;
 
@@ -88,16 +89,17 @@ export namespace LedgerAccountRetrieveResponse {
   }
 
   /**
-   * An object representing a (sanitized) user of the site.
+   * A user account on Whop. Contains profile information, identity details, and
+   * social connections.
    */
   export interface User {
     /**
-     * The internal ID of the user.
+     * The unique identifier for the user.
      */
     id: string;
 
     /**
-     * The name of the user from their Whop account.
+     * The user's display name shown on their public profile.
      */
     name: string | null;
 
@@ -107,27 +109,28 @@ export namespace LedgerAccountRetrieveResponse {
     typename: 'User';
 
     /**
-     * The username of the user from their Whop account.
+     * The user's unique username shown on their public profile.
      */
     username: string;
   }
 
   /**
-   * An object representing a (sanitized) company.
+   * A company is a seller on Whop. Companies own products, manage members, and
+   * receive payouts.
    */
   export interface Company {
     /**
-     * The ID (tag) of the company.
+     * The unique identifier for the company.
      */
     id: string;
 
     /**
-     * The slug/route of the company on the Whop site.
+     * The URL slug for the company's store page (e.g., 'pickaxe' in whop.com/pickaxe).
      */
     route: string;
 
     /**
-     * The title of the company.
+     * The display name of the company shown to customers.
      */
     title: string;
 
@@ -142,7 +145,7 @@ export namespace LedgerAccountRetrieveResponse {
    */
   export interface PayoutAccountDetails {
     /**
-     * Unique identifier for the object
+     * The unique identifier for the payout account.
      */
     id: string;
 
@@ -244,7 +247,7 @@ export namespace LedgerAccountRetrieveResponse {
      */
     export interface LatestVerification {
       /**
-       * A unique identifier for the verification.
+       * The unique identifier for the verification.
        */
       id: string;
 
@@ -254,12 +257,13 @@ export namespace LedgerAccountRetrieveResponse {
       last_error_code: VerificationsAPI.VerificationErrorCode | null;
 
       /**
-       * The last error reason that occurred during the verification.
+       * A human-readable explanation of the most recent verification error. Null if no
+       * error has occurred.
        */
       last_error_reason: string | null;
 
       /**
-       * The status of the verification.
+       * The current status of this verification session.
        */
       status: VerificationsAPI.VerificationStatus;
     }

package/src/resources/members.ts

@@ -9,7 +9,7 @@ import { path } from '../internal/utils/path';
 
 export class Members extends APIResource {
   /**
-   * Retrieves a member of a company by ID
+   * Retrieves the details of an existing member.
    *
    * Required permissions:
    *
@@ -22,7 +22,8 @@ export class Members extends APIResource {
   }
 
   /**
-   * List the members of a company
+   * Returns a paginated list of members for a company, with extensive filtering by
+   * product, plan, status, access level, and more.
    *
    * Required permissions:
    *
@@ -41,13 +42,12 @@ export class Members extends APIResource {
 export type MemberListResponsesCursorPage = CursorPage<MemberListResponse>;
 
 /**
- * An object representing a connection between a creator and a user/company_buyer.
- * This type should only be made visible to the user/company_buyer who is a part of
- * the connection.
+ * A member represents a user's relationship with a company on Whop, including
+ * their access level, status, and spending history.
  */
 export interface MemberRetrieveResponse {
   /**
-   * The ID of the member
+   * The unique identifier for the company member.
    */
   id: string;
 
@@ -70,7 +70,7 @@ export interface MemberRetrieveResponse {
   company_token_balance: number;
 
   /**
-   * When the member was created
+   * The datetime the company member was created.
    */
   created_at: string;
 
@@ -100,7 +100,7 @@ export interface MemberRetrieveResponse {
   status: Shared.MemberStatuses;
 
   /**
-   * The timestamp of when this member was last updated
+   * The datetime the company member was last updated.
    */
   updated_at: string;
 
@@ -121,7 +121,7 @@ export namespace MemberRetrieveResponse {
    */
   export interface Company {
     /**
-     * The ID of the company
+     * The unique identifier for the company.
      */
     id: string;
 
@@ -141,7 +141,7 @@ export namespace MemberRetrieveResponse {
    */
   export interface User {
     /**
-     * The internal ID of the user account.
+     * The unique identifier for the company member user.
      */
     id: string;
 
@@ -163,13 +163,12 @@ export namespace MemberRetrieveResponse {
 }
 
 /**
- * An object representing a connection between a creator and a user/company_buyer.
- * This type should only be made visible to the user/company_buyer who is a part of
- * the connection.
+ * A member represents a user's relationship with a company on Whop, including
+ * their access level, status, and spending history.
  */
 export interface MemberListResponse {
   /**
-   * The ID of the member
+   * The unique identifier for the company member.
    */
   id: string;
 
@@ -187,7 +186,7 @@ export interface MemberListResponse {
   company_token_balance: number;
 
   /**
-   * When the member was created
+   * The datetime the company member was created.
    */
   created_at: string;
 
@@ -217,7 +216,7 @@ export interface MemberListResponse {
   status: Shared.MemberStatuses;
 
   /**
-   * The timestamp of when this member was last updated
+   * The datetime the company member was last updated.
    */
   updated_at: string;
 
@@ -238,7 +237,7 @@ export namespace MemberListResponse {
    */
   export interface User {
     /**
-     * The internal ID of the user account.
+     * The unique identifier for the company member user.
      */
     id: string;
 
@@ -271,17 +270,17 @@ export interface MemberListParams extends CursorPageParams {
   before?: string | null;
 
   /**
-   * The ID of the company to list members for
+   * The unique identifier of the company to list members for.
    */
   company_id?: string | null;
 
   /**
-   * The minimum creation date to filter by
+   * Only return members created after this timestamp.
    */
   created_after?: string | null;
 
   /**
-   * The maximum creation date to filter by
+   * Only return members created before this timestamp.
    */
   created_before?: string | null;
 
@@ -301,7 +300,7 @@ export interface MemberListParams extends CursorPageParams {
   last?: number | null;
 
   /**
-   * The most recent actions to filter the members by
+   * Filter members by their most recent activity type.
    */
   most_recent_actions?: Array<Shared.MemberMostRecentActions> | null;
 
@@ -311,33 +310,33 @@ export interface MemberListParams extends CursorPageParams {
   order?: 'id' | 'usd_total_spent' | 'created_at' | 'joined_at' | 'most_recent_action' | null;
 
   /**
-   * The plan IDs to filter the members by
+   * Filter members to only those subscribed to these specific plans.
    */
   plan_ids?: Array<string> | null;
 
   /**
-   * The product IDs to filter the members by
+   * Filter members to only those belonging to these specific products.
    */
   product_ids?: Array<string> | null;
 
   /**
-   * The promo code IDs to filter the members by
+   * Filter members to only those who used these specific promo codes.
    */
   promo_code_ids?: Array<string> | null;
 
   /**
-   * The name, username, or email to filter the members by. The email filter will
-   * only apply if the current actor has the `member:email:read` permission.
+   * Search members by name, username, or email. Email filtering requires the
+   * member:email:read permission.
    */
   query?: string | null;
 
   /**
-   * The statuses to filter the members by
+   * Filter members by their current subscription status.
    */
   statuses?: Array<Shared.MemberStatuses> | null;
 
   /**
-   * The user IDs to filter the members by
+   * Filter members to only those matching these specific user identifiers.
    */
   user_ids?: Array<string> | null;
 }