@whop/sdk 0.0.38 → 0.0.40

package/src/resources/memberships.ts

@@ -12,7 +12,8 @@ import { path } from '../internal/utils/path';
  */
 export class Memberships extends APIResource {
   /**
-   * Retrieves the details of an existing membership.
+   * Returns a paginated list of memberships, with optional filtering by product,
+   * plan, status, and user.
    *
    * Required permissions:
    *
@@ -21,42 +22,21 @@ export class Memberships extends APIResource {
    *
    * @example
    * ```ts
-   * const membership = await client.memberships.retrieve(
-   *   'mem_xxxxxxxxxxxxxx',
-   * );
-   * ```
-   */
-  retrieve(id: string, options?: RequestOptions): APIPromise<Shared.Membership> {
-    return this._client.get(path`/memberships/${id}`, options);
-  }
-
-  /**
-   * Update a membership's metadata or other mutable properties.
-   *
-   * Required permissions:
-   *
-   * - `member:manage`
-   * - `member:email:read`
-   * - `member:basic:read`
-   *
-   * @example
-   * ```ts
-   * const membership = await client.memberships.update(
-   *   'mem_xxxxxxxxxxxxxx',
-   * );
+   * // Automatically fetches more pages as needed.
+   * for await (const membershipListResponse of client.memberships.list()) {
+   *   // ...
+   * }
    * ```
    */
-  update(
-    id: string,
-    body: MembershipUpdateParams | null | undefined = {},
+  list(
+    query: MembershipListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<Shared.Membership> {
-    return this._client.patch(path`/memberships/${id}`, { body, ...options });
+  ): PagePromise<MembershipListResponsesCursorPage, MembershipListResponse> {
+    return this._client.getAPIList('/memberships', CursorPage<MembershipListResponse>, { query, ...options });
   }
 
   /**
-   * Returns a paginated list of memberships, with optional filtering by product,
-   * plan, status, and user.
+   * Retrieves the details of an existing membership.
    *
    * Required permissions:
    *
@@ -65,22 +45,17 @@ export class Memberships extends APIResource {
    *
    * @example
    * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const membershipListResponse of client.memberships.list()) {
-   *   // ...
-   * }
+   * const membership = await client.memberships.retrieve(
+   *   'mem_xxxxxxxxxxxxxx',
+   * );
    * ```
    */
-  list(
-    query: MembershipListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<MembershipListResponsesCursorPage, MembershipListResponse> {
-    return this._client.getAPIList('/memberships', CursorPage<MembershipListResponse>, { query, ...options });
+  retrieve(id: string, options?: RequestOptions): APIPromise<Shared.Membership> {
+    return this._client.get(path`/memberships/${id}`, options);
   }
 
   /**
-   * Add free days to extend a membership's current billing period, expiration date,
-   * or Stripe trial.
+   * Update a membership's metadata or other mutable properties.
    *
    * Required permissions:
    *
@@ -90,18 +65,17 @@ export class Memberships extends APIResource {
    *
    * @example
    * ```ts
-   * const membership = await client.memberships.addFreeDays(
+   * const membership = await client.memberships.update(
    *   'mem_xxxxxxxxxxxxxx',
-   *   { free_days: 42 },
    * );
    * ```
    */
-  addFreeDays(
+  update(
     id: string,
-    body: MembershipAddFreeDaysParams,
+    body: MembershipUpdateParams | null | undefined = {},
     options?: RequestOptions,
   ): APIPromise<Shared.Membership> {
-    return this._client.post(path`/memberships/${id}/add_free_days`, { body, ...options });
+    return this._client.patch(path`/memberships/${id}`, { body, ...options });
   }
 
   /**
@@ -195,6 +169,32 @@ export class Memberships extends APIResource {
   uncancel(id: string, options?: RequestOptions): APIPromise<Shared.Membership> {
     return this._client.post(path`/memberships/${id}/uncancel`, options);
   }
+
+  /**
+   * Add free days to extend a membership's current billing period, expiration date,
+   * or Stripe trial.
+   *
+   * Required permissions:
+   *
+   * - `member:manage`
+   * - `member:email:read`
+   * - `member:basic:read`
+   *
+   * @example
+   * ```ts
+   * const membership = await client.memberships.addFreeDays(
+   *   'mem_xxxxxxxxxxxxxx',
+   *   { free_days: 42 },
+   * );
+   * ```
+   */
+  addFreeDays(
+    id: string,
+    body: MembershipAddFreeDaysParams,
+    options?: RequestOptions,
+  ): APIPromise<Shared.Membership> {
+    return this._client.post(path`/memberships/${id}/add_free_days`, { body, ...options });
+  }
 }
 
 export type MembershipListResponsesCursorPage = CursorPage<MembershipListResponse>;
@@ -246,6 +246,13 @@ export interface MembershipListResponse {
    */
   cancellation_reason: string | null;
 
+  /**
+   * The ID of the checkout session/configuration that produced this membership, if
+   * any. Use this to map memberships back to the checkout configuration that created
+   * them.
+   */
+  checkout_configuration_id: string | null;
+
   /**
    * The company this membership belongs to.
    */
@@ -377,6 +384,12 @@ export namespace MembershipListResponse {
      * The unique identifier for the plan.
      */
     id: string;
+
+    /**
+     * Custom key-value pairs stored on the plan. Included in webhook payloads for
+     * payment and membership events.
+     */
+    metadata: { [key: string]: unknown } | null;
   }
 
   /**
@@ -388,6 +401,12 @@ export namespace MembershipListResponse {
      */
     id: string;
 
+    /**
+     * Custom key-value pairs stored on the product. Included in webhook payloads for
+     * payment and membership events.
+     */
+    metadata: { [key: string]: unknown } | null;
+
     /**
      * The display name of the product shown to customers on the product page and in
      * search results.
@@ -433,14 +452,6 @@ export namespace MembershipListResponse {
   }
 }
 
-export interface MembershipUpdateParams {
-  /**
-   * A JSON object of key-value pairs to store on the membership. Replaces any
-   * existing metadata.
-   */
-  metadata?: { [key: string]: unknown } | null;
-}
-
 export interface MembershipListParams extends CursorPageParams {
   /**
    * Returns the elements in the list that come before the specified cursor.
@@ -514,12 +525,12 @@ export interface MembershipListParams extends CursorPageParams {
   user_ids?: Array<string> | null;
 }
 
-export interface MembershipAddFreeDaysParams {
+export interface MembershipUpdateParams {
   /**
-   * The number of free days to add (1-1095). Extends the billing period, expiration
-   * date, or Stripe trial depending on plan type.
+   * A JSON object of key-value pairs to store on the membership. Replaces any
+   * existing metadata.
    */
-  free_days: number;
+  metadata?: { [key: string]: unknown } | null;
 }
 
 export interface MembershipCancelParams {
@@ -537,15 +548,23 @@ export interface MembershipPauseParams {
   void_payments?: boolean | null;
 }
 
+export interface MembershipAddFreeDaysParams {
+  /**
+   * The number of free days to add (1-1095). Extends the billing period, expiration
+   * date, or Stripe trial depending on plan type.
+   */
+  free_days: number;
+}
+
 export declare namespace Memberships {
   export {
     type CancelOptions as CancelOptions,
     type MembershipListResponse as MembershipListResponse,
     type MembershipListResponsesCursorPage as MembershipListResponsesCursorPage,
-    type MembershipUpdateParams as MembershipUpdateParams,
     type MembershipListParams as MembershipListParams,
-    type MembershipAddFreeDaysParams as MembershipAddFreeDaysParams,
+    type MembershipUpdateParams as MembershipUpdateParams,
     type MembershipCancelParams as MembershipCancelParams,
     type MembershipPauseParams as MembershipPauseParams,
+    type MembershipAddFreeDaysParams as MembershipAddFreeDaysParams,
   };
 }

package/src/resources/messages.ts

@@ -12,15 +12,18 @@ import { path } from '../internal/utils/path';
  */
 export class Messages extends APIResource {
   /**
-   * Send a new message in an experience chat, DM, or group chat channel. Supports
-   * text content, attachments, polls, and replies.
+   * Returns a paginated list of messages within a specific experience chat, DM, or
+   * group chat channel, sorted by creation time.
    *
    * Required permissions:
    *
-   * - `chat:message:create`
+   * - `chat:read`
    */
-  create(body: MessageCreateParams, options?: RequestOptions): APIPromise<Shared.Message> {
-    return this._client.post('/messages', { body, ...options });
+  list(
+    query: MessageListParams,
+    options?: RequestOptions,
+  ): PagePromise<MessageListResponsesCursorPage, MessageListResponse> {
+    return this._client.getAPIList('/messages', CursorPage<MessageListResponse>, { query, ...options });
   }
 
   /**
@@ -34,6 +37,18 @@ export class Messages extends APIResource {
     return this._client.get(path`/messages/${id}`, options);
   }
 
+  /**
+   * Send a new message in an experience chat, DM, or group chat channel. Supports
+   * text content, attachments, polls, and replies.
+   *
+   * Required permissions:
+   *
+   * - `chat:message:create`
+   */
+  create(body: MessageCreateParams, options?: RequestOptions): APIPromise<Shared.Message> {
+    return this._client.post('/messages', { body, ...options });
+  }
+
   /**
    * Edit the content, attachments, or pinned status of an existing message in an
    * experience chat, DM, or group chat channel.
@@ -46,21 +61,6 @@ export class Messages extends APIResource {
     return this._client.patch(path`/messages/${id}`, { body, ...options });
   }
 
-  /**
-   * Returns a paginated list of messages within a specific experience chat, DM, or
-   * group chat channel, sorted by creation time.
-   *
-   * Required permissions:
-   *
-   * - `chat:read`
-   */
-  list(
-    query: MessageListParams,
-    options?: RequestOptions,
-  ): PagePromise<MessageListResponsesCursorPage, MessageListResponse> {
-    return this._client.getAPIList('/messages', CursorPage<MessageListResponse>, { query, ...options });
-  }
-
   /**
    * Permanently delete a message from an experience chat, DM, or group chat channel.
    * Only the message author or a channel admin can delete a message.
@@ -250,6 +250,33 @@ export namespace MessageListResponse {
  */
 export type MessageDeleteResponse = boolean;
 
+export interface MessageListParams extends CursorPageParams {
+  /**
+   * The unique identifier of the channel or experience to list messages for.
+   */
+  channel_id: string;
+
+  /**
+   * Returns the elements in the list that come before the specified cursor.
+   */
+  before?: string | null;
+
+  /**
+   * The direction of the sort.
+   */
+  direction?: Shared.Direction | null;
+
+  /**
+   * Returns the first _n_ elements from the list.
+   */
+  first?: number | null;
+
+  /**
+   * Returns the last _n_ elements from the list.
+   */
+  last?: number | null;
+}
+
 export interface MessageCreateParams {
   /**
    * The unique identifier of the channel or experience to send the message in. For
@@ -355,40 +382,13 @@ export namespace MessageUpdateParams {
   }
 }
 
-export interface MessageListParams extends CursorPageParams {
-  /**
-   * The unique identifier of the channel or experience to list messages for.
-   */
-  channel_id: string;
-
-  /**
-   * Returns the elements in the list that come before the specified cursor.
-   */
-  before?: string | null;
-
-  /**
-   * The direction of the sort.
-   */
-  direction?: Shared.Direction | null;
-
-  /**
-   * Returns the first _n_ elements from the list.
-   */
-  first?: number | null;
-
-  /**
-   * Returns the last _n_ elements from the list.
-   */
-  last?: number | null;
-}
-
 export declare namespace Messages {
   export {
     type MessageListResponse as MessageListResponse,
     type MessageDeleteResponse as MessageDeleteResponse,
     type MessageListResponsesCursorPage as MessageListResponsesCursorPage,
+    type MessageListParams as MessageListParams,
     type MessageCreateParams as MessageCreateParams,
     type MessageUpdateParams as MessageUpdateParams,
-    type MessageListParams as MessageListParams,
   };
 }

package/src/resources/payment-methods.ts

@@ -12,21 +12,6 @@ import { path } from '../internal/utils/path';
  * Payment methods
  */
 export class PaymentMethods extends APIResource {
-  /**
-   * Retrieves the details of an existing payment method.
-   *
-   * Required permissions:
-   *
-   * - `member:payment_methods:read`
-   */
-  retrieve(
-    id: string,
-    query: PaymentMethodRetrieveParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<PaymentMethodRetrieveResponse> {
-    return this._client.get(path`/payment_methods/${id}`, { query, ...options });
-  }
-
   /**
    * Returns a paginated list of payment methods for a member or company, with
    * optional filtering by creation date. A payment method is a stored representation
@@ -46,6 +31,21 @@ export class PaymentMethods extends APIResource {
       ...options,
     });
   }
+
+  /**
+   * Retrieves the details of an existing payment method.
+   *
+   * Required permissions:
+   *
+   * - `member:payment_methods:read`
+   */
+  retrieve(
+    id: string,
+    query: PaymentMethodRetrieveParams | null | undefined = {},
+    options?: RequestOptions,
+  ): APIPromise<PaymentMethodRetrieveResponse> {
+    return this._client.get(path`/payment_methods/${id}`, { query, ...options });
+  }
 }
 
 export type PaymentMethodListResponsesCursorPage = CursorPage<PaymentMethodListResponse>;
@@ -746,20 +746,6 @@ export namespace PaymentMethodListResponse {
   }
 }
 
-export interface PaymentMethodRetrieveParams {
-  /**
-   * The unique identifier of the company. Provide either this or member_id, not
-   * both.
-   */
-  company_id?: string | null;
-
-  /**
-   * The unique identifier of the member. Provide either this or company_id, not
-   * both.
-   */
-  member_id?: string | null;
-}
-
 export interface PaymentMethodListParams extends CursorPageParams {
   /**
    * Returns the elements in the list that come before the specified cursor.
@@ -803,12 +789,26 @@ export interface PaymentMethodListParams extends CursorPageParams {
   member_id?: string | null;
 }
 
+export interface PaymentMethodRetrieveParams {
+  /**
+   * The unique identifier of the company. Provide either this or member_id, not
+   * both.
+   */
+  company_id?: string | null;
+
+  /**
+   * The unique identifier of the member. Provide either this or company_id, not
+   * both.
+   */
+  member_id?: string | null;
+}
+
 export declare namespace PaymentMethods {
   export {
     type PaymentMethodRetrieveResponse as PaymentMethodRetrieveResponse,
     type PaymentMethodListResponse as PaymentMethodListResponse,
     type PaymentMethodListResponsesCursorPage as PaymentMethodListResponsesCursorPage,
-    type PaymentMethodRetrieveParams as PaymentMethodRetrieveParams,
     type PaymentMethodListParams as PaymentMethodListParams,
+    type PaymentMethodRetrieveParams as PaymentMethodRetrieveParams,
   };
 }