@whop/sdk 0.0.2 → 0.0.3

package/src/resources/plans.ts

@@ -200,11 +200,26 @@ export interface PlanListResponse {
    */
   renewal_price: number;
 
+  /**
+   * The number of units available for purchase. Only displayed to authorized actors
+   */
+  stock: number | null;
+
+  /**
+   * The title of the plan. This will be visible on the product page to customers.
+   */
+  title: string | null;
+
   /**
    * The number of free trial days added before a renewal plan.
    */
   trial_period_days: number | null;
 
+  /**
+   * Limits/doesn't limit the number of units available for purchase.
+   */
+  unlimited_stock: boolean;
+
   /**
    * When the plan was last updated.
    */
@@ -275,7 +290,7 @@ export interface PlanCreateParams {
   product_id: string;
 
   /**
-   * The interval at which the plan charges (renewal plans).
+   * The interval in days at which the plan charges (renewal plans).
    */
   billing_period?: number | null;
 
@@ -338,6 +353,23 @@ export interface PlanCreateParams {
    */
   renewal_price?: number | null;
 
+  /**
+   * The number of units available for purchase.
+   */
+  stock?: number | null;
+
+  /**
+   * The price to display with a strikethrough for the initial price. Provided as a
+   * number in dollars. Eg: 19.99 for $19.99
+   */
+  strike_through_initial_price?: number | null;
+
+  /**
+   * The price to display with a strikethrough for the renewal price. Provided as a
+   * number in dollars. Eg: 19.99 for $19.99
+   */
+  strike_through_renewal_price?: number | null;
+
   /**
    * The title of the plan. This will be visible on the product page to customers.
    */
@@ -348,6 +380,11 @@ export interface PlanCreateParams {
    */
   trial_period_days?: number | null;
 
+  /**
+   * Limits/doesn't limit the number of units available for purchase.
+   */
+  unlimited_stock?: boolean | null;
+
   /**
    * Visibility of a resource
    */
@@ -464,6 +501,23 @@ export interface PlanUpdateParams {
    */
   renewal_price?: number | null;
 
+  /**
+   * The number of units available for purchase.
+   */
+  stock?: number | null;
+
+  /**
+   * The price to display with a strikethrough for the initial price. Provided as a
+   * number in dollars. Eg: 19.99 for $19.99
+   */
+  strike_through_initial_price?: number | null;
+
+  /**
+   * The price to display with a strikethrough for the renewal price. Provided as a
+   * number in dollars. Eg: 19.99 for $19.99
+   */
+  strike_through_renewal_price?: number | null;
+
   /**
    * The title of the plan. This will be visible on the product page to customers.
    */
@@ -474,6 +528,11 @@ export interface PlanUpdateParams {
    */
   trial_period_days?: number | null;
 
+  /**
+   * Limits/doesn't limit the number of units available for purchase.
+   */
+  unlimited_stock?: boolean | null;
+
   /**
    * Visibility of a resource
    */

package/src/resources/products.ts

@@ -129,16 +129,6 @@ export interface ProductCreateParams {
    */
   title: string;
 
-  /**
-   * The different types an access pass can be.
-   */
-  access_pass_type?: Shared.AccessPassType | null;
-
-  /**
-   * A banner image for the product in png, jpeg format
-   */
-  banner_image?: ProductCreateParams.BannerImage | null;
-
   /**
    * The different business types a company can be.
    */
@@ -238,25 +228,6 @@ export interface ProductCreateParams {
 }
 
 export namespace ProductCreateParams {
-  /**
-   * A banner image for the product in png, jpeg format
-   */
-  export interface BannerImage {
-    /**
-     * The ID of an existing attachment object. Use this when updating a resource and
-     * keeping a subset of the attachments. Don't use this unless you know what you're
-     * doing.
-     */
-    id?: string | null;
-
-    /**
-     * This ID should be used the first time you upload an attachment. It is the ID of
-     * the direct upload that was created when uploading the file to S3 via the
-     * mediaDirectUpload mutation.
-     */
-    direct_upload_id?: string | null;
-  }
-
   /**
    * The details to assign an autogenerated plan.
    */
@@ -441,6 +412,11 @@ export interface ProductUpdateParams {
    */
   route?: string | null;
 
+  /**
+   * Configuration for a product on the company's store page.
+   */
+  store_page_config?: ProductUpdateParams.StorePageConfig | null;
+
   /**
    * The title of the product.
    */
@@ -471,6 +447,21 @@ export namespace ProductUpdateParams {
      */
     direct_upload_id?: string | null;
   }
+
+  /**
+   * Configuration for a product on the company's store page.
+   */
+  export interface StorePageConfig {
+    /**
+     * Custom call-to-action text for the product's store page.
+     */
+    custom_cta?: string | null;
+
+    /**
+     * Whether or not to show the price on the product's store page.
+     */
+    show_price?: boolean | null;
+  }
 }
 
 export interface ProductListParams extends CursorPageParams {

package/src/resources/promo-codes.ts

@@ -0,0 +1,490 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../core/resource';
+import * as Shared from './shared';
+import { APIPromise } from '../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../core/pagination';
+import { RequestOptions } from '../internal/request-options';
+import { path } from '../internal/utils/path';
+
+export class PromoCodes extends APIResource {
+  /**
+   * Create a new promo code for a product or plan
+   *
+   * Required permissions:
+   *
+   * - `promo_code:create`
+   * - `access_pass:basic:read`
+   *
+   * @example
+   * ```ts
+   * const promoCode = await client.promoCodes.create({
+   *   amount_off: 6.9,
+   *   base_currency: 'usd',
+   *   code: 'code',
+   *   company_id: 'biz_xxxxxxxxxxxxxx',
+   *   new_users_only: true,
+   *   promo_duration_months: 42,
+   *   promo_type: 'percentage',
+   * });
+   * ```
+   */
+  create(body: PromoCodeCreateParams, options?: RequestOptions): APIPromise<PromoCode> {
+    return this._client.post('/promo_codes', { body, ...options });
+  }
+
+  /**
+   * Retrieves a promo code by ID
+   *
+   * Required permissions:
+   *
+   * - `promo_code:basic:read`
+   * - `access_pass:basic:read`
+   *
+   * @example
+   * ```ts
+   * const promoCode = await client.promoCodes.retrieve(
+   *   'promo_xxxxxxxxxxxx',
+   * );
+   * ```
+   */
+  retrieve(id: string, options?: RequestOptions): APIPromise<PromoCode> {
+    return this._client.get(path`/promo_codes/${id}`, options);
+  }
+
+  /**
+   * Lists promo codes for a company
+   *
+   * Required permissions:
+   *
+   * - `promo_code:basic:read`
+   * - `access_pass:basic:read`
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const promoCodeListResponse of client.promoCodes.list(
+   *   { company_id: 'biz_xxxxxxxxxxxxxx' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    query: PromoCodeListParams,
+    options?: RequestOptions,
+  ): PagePromise<PromoCodeListResponsesCursorPage, PromoCodeListResponse> {
+    return this._client.getAPIList('/promo_codes', CursorPage<PromoCodeListResponse>, { query, ...options });
+  }
+
+  /**
+   * Archive a promo code, preventing further use
+   *
+   * Required permissions:
+   *
+   * - `promo_code:delete`
+   *
+   * @example
+   * ```ts
+   * const promoCode = await client.promoCodes.delete(
+   *   'promo_xxxxxxxxxxxx',
+   * );
+   * ```
+   */
+  delete(id: string, options?: RequestOptions): APIPromise<PromoCodeDeleteResponse> {
+    return this._client.delete(path`/promo_codes/${id}`, options);
+  }
+}
+
+export type PromoCodeListResponsesCursorPage = CursorPage<PromoCodeListResponse>;
+
+/**
+ * An object representing a promo code for a plan.
+ */
+export interface PromoCode {
+  /**
+   * The ID of the promo.
+   */
+  id: string;
+
+  /**
+   * The amount off (% or flat amount) for the promo.
+   */
+  amount_off: number;
+
+  /**
+   * Restricts promo use to only users who have churned from the company before.
+   */
+  churned_users_only: boolean;
+
+  /**
+   * The specific code used to apply the promo at checkout.
+   */
+  code: string | null;
+
+  /**
+   * The company for the promo code.
+   */
+  company: PromoCode.Company;
+
+  /**
+   * The timestamp of when the promo was created.
+   */
+  created_at: string;
+
+  /**
+   * The monetary currency of the promo code.
+   */
+  currency: Shared.Currency;
+
+  /**
+   * The duration setting for the promo code
+   */
+  duration: PromoDuration | null;
+
+  /**
+   * Restricts promo use to only be applied to already purchased memberships.
+   */
+  existing_memberships_only: boolean;
+
+  /**
+   * The date/time of when the promo expires.
+   */
+  expires_at: string | null;
+
+  /**
+   * Restricts promo use to only users who have never purchased from the company
+   * before.
+   */
+  new_users_only: boolean;
+
+  /**
+   * Restricts promo use to only be applied once per customer.
+   */
+  one_per_customer: boolean;
+
+  /**
+   * The access pass associated with the promo code.
+   */
+  product: PromoCode.Product | null;
+
+  /**
+   * The number of months the promo is applied for.
+   */
+  promo_duration_months: number | null;
+
+  /**
+   * The type (% or flat amount) of the promo.
+   */
+  promo_type: Shared.PromoType;
+
+  /**
+   * Indicates if the promo code is live or disabled.
+   */
+  status: PromoCodeStatus;
+
+  /**
+   * The quantity limit on the number of uses.
+   */
+  stock: number;
+
+  /**
+   * Whether or not the promo code has unlimited stock.
+   */
+  unlimited_stock: boolean;
+
+  /**
+   * The amount of times the promo codes has been used.
+   */
+  uses: number;
+}
+
+export namespace PromoCode {
+  /**
+   * The company for the promo code.
+   */
+  export interface Company {
+    /**
+     * The ID of the company
+     */
+    id: string;
+
+    /**
+     * The written name of the company.
+     */
+    title: string;
+  }
+
+  /**
+   * The access pass associated with the promo code.
+   */
+  export interface Product {
+    /**
+     * The internal ID of the public product.
+     */
+    id: string;
+
+    /**
+     * The title of the product. Use for Whop 4.0.
+     */
+    title: string;
+  }
+}
+
+/**
+ * Statuses for promo codes
+ */
+export type PromoCodeStatus = 'active' | 'inactive' | 'archived';
+
+/**
+ * The duration setting for the promo code
+ */
+export type PromoDuration = 'forever' | 'once' | 'repeating';
+
+/**
+ * An object representing a promo code for a plan.
+ */
+export interface PromoCodeListResponse {
+  /**
+   * The ID of the promo.
+   */
+  id: string;
+
+  /**
+   * The amount off (% or flat amount) for the promo.
+   */
+  amount_off: number;
+
+  /**
+   * Restricts promo use to only users who have churned from the company before.
+   */
+  churned_users_only: boolean;
+
+  /**
+   * The specific code used to apply the promo at checkout.
+   */
+  code: string | null;
+
+  /**
+   * The timestamp of when the promo was created.
+   */
+  created_at: string;
+
+  /**
+   * The monetary currency of the promo code.
+   */
+  currency: Shared.Currency;
+
+  /**
+   * The duration setting for the promo code
+   */
+  duration: PromoDuration | null;
+
+  /**
+   * Restricts promo use to only be applied to already purchased memberships.
+   */
+  existing_memberships_only: boolean;
+
+  /**
+   * The date/time of when the promo expires.
+   */
+  expires_at: string | null;
+
+  /**
+   * Restricts promo use to only users who have never purchased from the company
+   * before.
+   */
+  new_users_only: boolean;
+
+  /**
+   * Restricts promo use to only be applied once per customer.
+   */
+  one_per_customer: boolean;
+
+  /**
+   * The access pass associated with the promo code.
+   */
+  product: PromoCodeListResponse.Product | null;
+
+  /**
+   * The number of months the promo is applied for.
+   */
+  promo_duration_months: number | null;
+
+  /**
+   * The type (% or flat amount) of the promo.
+   */
+  promo_type: Shared.PromoType;
+
+  /**
+   * Indicates if the promo code is live or disabled.
+   */
+  status: PromoCodeStatus;
+
+  /**
+   * The quantity limit on the number of uses.
+   */
+  stock: number;
+
+  /**
+   * Whether or not the promo code has unlimited stock.
+   */
+  unlimited_stock: boolean;
+
+  /**
+   * The amount of times the promo codes has been used.
+   */
+  uses: number;
+}
+
+export namespace PromoCodeListResponse {
+  /**
+   * The access pass associated with the promo code.
+   */
+  export interface Product {
+    /**
+     * The internal ID of the public product.
+     */
+    id: string;
+
+    /**
+     * The title of the product. Use for Whop 4.0.
+     */
+    title: string;
+  }
+}
+
+/**
+ * Represents `true` or `false` values.
+ */
+export type PromoCodeDeleteResponse = boolean;
+
+export interface PromoCodeCreateParams {
+  /**
+   * The amount off (% or flat amount) for the promo.
+   */
+  amount_off: number;
+
+  /**
+   * The monetary currency of the promo code.
+   */
+  base_currency: Shared.Currency;
+
+  /**
+   * The specific code used to apply the promo at checkout.
+   */
+  code: string;
+
+  /**
+   * The id of the company to create the promo code for.
+   */
+  company_id: string;
+
+  /**
+   * Restricts promo use to only users who have never purchased from the company
+   * before.
+   */
+  new_users_only: boolean;
+
+  /**
+   * The number of months this promo code is applied and valid for.
+   */
+  promo_duration_months: number;
+
+  /**
+   * The type (% or flat amount) of the promo.
+   */
+  promo_type: Shared.PromoType;
+
+  /**
+   * Restricts promo use to only users who have churned from the company before.
+   */
+  churned_users_only?: boolean | null;
+
+  /**
+   * Whether this promo code is for existing memberships only (cancelations)
+   */
+  existing_memberships_only?: boolean | null;
+
+  /**
+   * The date/time of when the promo expires.
+   */
+  expires_at?: string | null;
+
+  /**
+   * Restricts promo use to only be applied once per customer.
+   */
+  one_per_customer?: boolean | null;
+
+  /**
+   * The IDs of the plans that the promo code applies to. If product_id is provided,
+   * it will only apply to plans attached to that product
+   */
+  plan_ids?: Array<string> | null;
+
+  /**
+   * The product to lock the promo code to, if any. If provided will filter out any
+   * plan ids not attached to this product
+   */
+  product_id?: string | null;
+
+  /**
+   * The quantity limit on the number of uses.
+   */
+  stock?: number | null;
+
+  /**
+   * Whether or not the promo code should have unlimited stock.
+   */
+  unlimited_stock?: boolean | null;
+}
+
+export interface PromoCodeListParams extends CursorPageParams {
+  /**
+   * The ID of the company to list promo codes for
+   */
+  company_id: string;
+
+  /**
+   * Returns the elements in the list that come before the specified cursor.
+   */
+  before?: string | null;
+
+  /**
+   * Returns the first _n_ elements from the list.
+   */
+  first?: number | null;
+
+  /**
+   * Returns the last _n_ elements from the list.
+   */
+  last?: number | null;
+
+  /**
+   * Filter promo codes by plan ID(s)
+   */
+  plan_ids?: Array<string> | null;
+
+  /**
+   * Filter promo codes by product ID(s)
+   */
+  product_ids?: Array<string> | null;
+
+  /**
+   * Statuses for promo codes
+   */
+  status?: PromoCodeStatus | null;
+}
+
+export declare namespace PromoCodes {
+  export {
+    type PromoCode as PromoCode,
+    type PromoCodeStatus as PromoCodeStatus,
+    type PromoDuration as PromoDuration,
+    type PromoCodeListResponse as PromoCodeListResponse,
+    type PromoCodeDeleteResponse as PromoCodeDeleteResponse,
+    type PromoCodeListResponsesCursorPage as PromoCodeListResponsesCursorPage,
+    type PromoCodeCreateParams as PromoCodeCreateParams,
+    type PromoCodeListParams as PromoCodeListParams,
+  };
+}