@usehercules/sdk 1.10.1 → 1.11.0

package/src/resources/beta/commerce/products/variants.ts

@@ -12,11 +12,7 @@ export class Variants extends APIResource {
    * pricing tiers or configurations (e.g., Basic at $10/month, Pro at $25/month). A
    * Stripe Price is automatically created.
    */
-  create(
-    productID: string,
-    body: VariantCreateParams,
-    options?: RequestOptions,
-  ): APIPromise<VariantCreateResponse> {
+  create(productID: string, body: VariantCreateParams, options?: RequestOptions): APIPromise<Variant> {
     return this._client.post(path`/v1/commerce/products/${productID}/variants`, { body, ...options });
   }
 
@@ -24,11 +20,7 @@ export class Variants extends APIResource {
    * Updates an existing variant. Use this to modify the name, description, or active
    * status. Pricing cannot be changed after creation—create a new variant instead.
    */
-  update(
-    variantID: string,
-    params: VariantUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<VariantUpdateResponse> {
+  update(variantID: string, params: VariantUpdateParams, options?: RequestOptions): APIPromise<Variant> {
     const { product_id, ...body } = params;
     return this._client.patch(path`/v1/commerce/products/${product_id}/variants/${variantID}`, {
       body,
@@ -44,23 +36,18 @@ export class Variants extends APIResource {
     productID: string,
     query: VariantListParams | null | undefined = {},
     options?: RequestOptions,
-  ): PagePromise<VariantListResponsesCursorIDPage, VariantListResponse> {
-    return this._client.getAPIList(
-      path`/v1/commerce/products/${productID}/variants`,
-      CursorIDPage<VariantListResponse>,
-      { query, ...options },
-    );
+  ): PagePromise<VariantsCursorIDPage, Variant> {
+    return this._client.getAPIList(path`/v1/commerce/products/${productID}/variants`, CursorIDPage<Variant>, {
+      query,
+      ...options,
+    });
   }
 
   /**
    * Archives a variant, preventing new subscriptions. The associated Stripe Price is
    * also archived. Existing subscriptions remain active.
    */
-  archive(
-    variantID: string,
-    params: VariantArchiveParams,
-    options?: RequestOptions,
-  ): APIPromise<VariantArchiveResponse> {
+  archive(variantID: string, params: VariantArchiveParams, options?: RequestOptions): APIPromise<Variant> {
     const { product_id } = params;
     return this._client.delete(path`/v1/commerce/products/${product_id}/variants/${variantID}`, options);
   }
@@ -69,644 +56,20 @@ export class Variants extends APIResource {
    * Retrieves a variant by ID. Returns the variant object including pricing details
    * and status.
    */
-  get(variantID: string, params: VariantGetParams, options?: RequestOptions): APIPromise<VariantGetResponse> {
+  get(variantID: string, params: VariantGetParams, options?: RequestOptions): APIPromise<Variant> {
     const { product_id } = params;
     return this._client.get(path`/v1/commerce/products/${product_id}/variants/${variantID}`, options);
   }
 }
 
-export type VariantListResponsesCursorIDPage = CursorIDPage<VariantListResponse>;
-
-/**
- * A product variant representing a specific tier or configuration. Each variant
- * has its own pricing. Variants allow a single product to have multiple pricing
- * options (e.g., Basic, Pro, Enterprise tiers).
- */
-export interface VariantCreateResponse {
-  /**
-   * Unique identifier for the topic subscription
-   */
-  id: string;
-
-  /**
-   * Whether the variant is available for new purchases
-   */
-  active: boolean;
-
-  /**
-   * Timestamp when the variant was created
-   */
-  created: string;
-
-  /**
-   * Display name for the variant (e.g., Basic, Standard, Premium)
-   */
-  name: string;
-
-  /**
-   * Three-letter ISO currency code
-   */
-  currency?: string;
-
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  default_price?: VariantCreateResponse.DefaultPrice | null;
-
-  /**
-   * Detailed description of what this variant includes
-   */
-  description?: string | null;
-
-  /**
-   * Media attachments (images, videos) for the variant
-   */
-  media?: Array<VariantCreateResponse.Media>;
-
-  /**
-   * Custom metadata for the variant
-   */
-  metadata?: { [key: string]: unknown };
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  recurring?: VariantCreateResponse.Recurring | null;
-
-  /**
-   * Price amount in the smallest currency unit (e.g., cents). 0 for free variants.
-   */
-  unit_amount?: number;
-}
-
-export namespace VariantCreateResponse {
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  export interface DefaultPrice {
-    /**
-     * Unique identifier for the topic subscription
-     */
-    id: string;
-
-    /**
-     * Three-letter ISO currency code (e.g., usd, eur)
-     */
-    currency: string;
-
-    /**
-     * Billing frequency for recurring prices: day, week, month, or year. Null for
-     * one-time prices.
-     */
-    interval: 'day' | 'week' | 'month' | 'year' | null;
-
-    /**
-     * Number of intervals between billings for recurring prices. Null for one-time
-     * prices.
-     */
-    interval_count: number | null;
-
-    /**
-     * Price type: one_time for single purchases, recurring for subscriptions
-     */
-    type: 'one_time' | 'recurring';
-
-    /**
-     * Price amount in the smallest currency unit (e.g., cents)
-     */
-    unit_amount: number | null;
-  }
-
-  /**
-   * Media attachment for products or variants
-   */
-  export interface Media {
-    /**
-     * CDN file ID
-     */
-    id: string;
-
-    /**
-     * Display order in gallery (0-indexed)
-     */
-    display_order: number;
-
-    /**
-     * Type of media: image or video
-     */
-    type: 'image' | 'video';
-
-    /**
-     * CDN URL of the media resource
-     */
-    url: string;
-
-    /**
-     * File size in bytes
-     */
-    file_size?: number;
-
-    /**
-     * Original filename
-     */
-    filename?: string;
-
-    /**
-     * Optimized thumbnail URL for images
-     */
-    thumbnail_url?: string;
-  }
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  export interface Recurring {
-    /**
-     * Billing frequency: day, week, month, or year
-     */
-    interval: 'day' | 'week' | 'month' | 'year';
-
-    /**
-     * Number of intervals between billings
-     */
-    interval_count?: number;
-  }
-}
-
-/**
- * A product variant representing a specific tier or configuration. Each variant
- * has its own pricing. Variants allow a single product to have multiple pricing
- * options (e.g., Basic, Pro, Enterprise tiers).
- */
-export interface VariantUpdateResponse {
-  /**
-   * Unique identifier for the topic subscription
-   */
-  id: string;
-
-  /**
-   * Whether the variant is available for new purchases
-   */
-  active: boolean;
-
-  /**
-   * Timestamp when the variant was created
-   */
-  created: string;
-
-  /**
-   * Display name for the variant (e.g., Basic, Standard, Premium)
-   */
-  name: string;
-
-  /**
-   * Three-letter ISO currency code
-   */
-  currency?: string;
-
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  default_price?: VariantUpdateResponse.DefaultPrice | null;
-
-  /**
-   * Detailed description of what this variant includes
-   */
-  description?: string | null;
-
-  /**
-   * Media attachments (images, videos) for the variant
-   */
-  media?: Array<VariantUpdateResponse.Media>;
-
-  /**
-   * Custom metadata for the variant
-   */
-  metadata?: { [key: string]: unknown };
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  recurring?: VariantUpdateResponse.Recurring | null;
-
-  /**
-   * Price amount in the smallest currency unit (e.g., cents). 0 for free variants.
-   */
-  unit_amount?: number;
-}
-
-export namespace VariantUpdateResponse {
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  export interface DefaultPrice {
-    /**
-     * Unique identifier for the topic subscription
-     */
-    id: string;
-
-    /**
-     * Three-letter ISO currency code (e.g., usd, eur)
-     */
-    currency: string;
-
-    /**
-     * Billing frequency for recurring prices: day, week, month, or year. Null for
-     * one-time prices.
-     */
-    interval: 'day' | 'week' | 'month' | 'year' | null;
-
-    /**
-     * Number of intervals between billings for recurring prices. Null for one-time
-     * prices.
-     */
-    interval_count: number | null;
-
-    /**
-     * Price type: one_time for single purchases, recurring for subscriptions
-     */
-    type: 'one_time' | 'recurring';
-
-    /**
-     * Price amount in the smallest currency unit (e.g., cents)
-     */
-    unit_amount: number | null;
-  }
-
-  /**
-   * Media attachment for products or variants
-   */
-  export interface Media {
-    /**
-     * CDN file ID
-     */
-    id: string;
-
-    /**
-     * Display order in gallery (0-indexed)
-     */
-    display_order: number;
-
-    /**
-     * Type of media: image or video
-     */
-    type: 'image' | 'video';
-
-    /**
-     * CDN URL of the media resource
-     */
-    url: string;
-
-    /**
-     * File size in bytes
-     */
-    file_size?: number;
-
-    /**
-     * Original filename
-     */
-    filename?: string;
-
-    /**
-     * Optimized thumbnail URL for images
-     */
-    thumbnail_url?: string;
-  }
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  export interface Recurring {
-    /**
-     * Billing frequency: day, week, month, or year
-     */
-    interval: 'day' | 'week' | 'month' | 'year';
-
-    /**
-     * Number of intervals between billings
-     */
-    interval_count?: number;
-  }
-}
-
-/**
- * A product variant representing a specific tier or configuration. Each variant
- * has its own pricing. Variants allow a single product to have multiple pricing
- * options (e.g., Basic, Pro, Enterprise tiers).
- */
-export interface VariantListResponse {
-  /**
-   * Unique identifier for the topic subscription
-   */
-  id: string;
-
-  /**
-   * Whether the variant is available for new purchases
-   */
-  active: boolean;
-
-  /**
-   * Timestamp when the variant was created
-   */
-  created: string;
-
-  /**
-   * Display name for the variant (e.g., Basic, Standard, Premium)
-   */
-  name: string;
-
-  /**
-   * Three-letter ISO currency code
-   */
-  currency?: string;
-
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  default_price?: VariantListResponse.DefaultPrice | null;
-
-  /**
-   * Detailed description of what this variant includes
-   */
-  description?: string | null;
-
-  /**
-   * Media attachments (images, videos) for the variant
-   */
-  media?: Array<VariantListResponse.Media>;
-
-  /**
-   * Custom metadata for the variant
-   */
-  metadata?: { [key: string]: unknown };
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  recurring?: VariantListResponse.Recurring | null;
-
-  /**
-   * Price amount in the smallest currency unit (e.g., cents). 0 for free variants.
-   */
-  unit_amount?: number;
-}
-
-export namespace VariantListResponse {
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  export interface DefaultPrice {
-    /**
-     * Unique identifier for the topic subscription
-     */
-    id: string;
-
-    /**
-     * Three-letter ISO currency code (e.g., usd, eur)
-     */
-    currency: string;
-
-    /**
-     * Billing frequency for recurring prices: day, week, month, or year. Null for
-     * one-time prices.
-     */
-    interval: 'day' | 'week' | 'month' | 'year' | null;
-
-    /**
-     * Number of intervals between billings for recurring prices. Null for one-time
-     * prices.
-     */
-    interval_count: number | null;
-
-    /**
-     * Price type: one_time for single purchases, recurring for subscriptions
-     */
-    type: 'one_time' | 'recurring';
-
-    /**
-     * Price amount in the smallest currency unit (e.g., cents)
-     */
-    unit_amount: number | null;
-  }
-
-  /**
-   * Media attachment for products or variants
-   */
-  export interface Media {
-    /**
-     * CDN file ID
-     */
-    id: string;
-
-    /**
-     * Display order in gallery (0-indexed)
-     */
-    display_order: number;
-
-    /**
-     * Type of media: image or video
-     */
-    type: 'image' | 'video';
-
-    /**
-     * CDN URL of the media resource
-     */
-    url: string;
-
-    /**
-     * File size in bytes
-     */
-    file_size?: number;
-
-    /**
-     * Original filename
-     */
-    filename?: string;
-
-    /**
-     * Optimized thumbnail URL for images
-     */
-    thumbnail_url?: string;
-  }
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  export interface Recurring {
-    /**
-     * Billing frequency: day, week, month, or year
-     */
-    interval: 'day' | 'week' | 'month' | 'year';
-
-    /**
-     * Number of intervals between billings
-     */
-    interval_count?: number;
-  }
-}
-
-/**
- * A product variant representing a specific tier or configuration. Each variant
- * has its own pricing. Variants allow a single product to have multiple pricing
- * options (e.g., Basic, Pro, Enterprise tiers).
- */
-export interface VariantArchiveResponse {
-  /**
-   * Unique identifier for the topic subscription
-   */
-  id: string;
-
-  /**
-   * Whether the variant is available for new purchases
-   */
-  active: boolean;
-
-  /**
-   * Timestamp when the variant was created
-   */
-  created: string;
-
-  /**
-   * Display name for the variant (e.g., Basic, Standard, Premium)
-   */
-  name: string;
-
-  /**
-   * Three-letter ISO currency code
-   */
-  currency?: string;
-
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  default_price?: VariantArchiveResponse.DefaultPrice | null;
-
-  /**
-   * Detailed description of what this variant includes
-   */
-  description?: string | null;
-
-  /**
-   * Media attachments (images, videos) for the variant
-   */
-  media?: Array<VariantArchiveResponse.Media>;
-
-  /**
-   * Custom metadata for the variant
-   */
-  metadata?: { [key: string]: unknown };
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  recurring?: VariantArchiveResponse.Recurring | null;
-
-  /**
-   * Price amount in the smallest currency unit (e.g., cents). 0 for free variants.
-   */
-  unit_amount?: number;
-}
-
-export namespace VariantArchiveResponse {
-  /**
-   * Price configuration for a product. Can be one-time or recurring (subscription).
-   */
-  export interface DefaultPrice {
-    /**
-     * Unique identifier for the topic subscription
-     */
-    id: string;
-
-    /**
-     * Three-letter ISO currency code (e.g., usd, eur)
-     */
-    currency: string;
-
-    /**
-     * Billing frequency for recurring prices: day, week, month, or year. Null for
-     * one-time prices.
-     */
-    interval: 'day' | 'week' | 'month' | 'year' | null;
-
-    /**
-     * Number of intervals between billings for recurring prices. Null for one-time
-     * prices.
-     */
-    interval_count: number | null;
-
-    /**
-     * Price type: one_time for single purchases, recurring for subscriptions
-     */
-    type: 'one_time' | 'recurring';
-
-    /**
-     * Price amount in the smallest currency unit (e.g., cents)
-     */
-    unit_amount: number | null;
-  }
-
-  /**
-   * Media attachment for products or variants
-   */
-  export interface Media {
-    /**
-     * CDN file ID
-     */
-    id: string;
-
-    /**
-     * Display order in gallery (0-indexed)
-     */
-    display_order: number;
-
-    /**
-     * Type of media: image or video
-     */
-    type: 'image' | 'video';
-
-    /**
-     * CDN URL of the media resource
-     */
-    url: string;
-
-    /**
-     * File size in bytes
-     */
-    file_size?: number;
-
-    /**
-     * Original filename
-     */
-    filename?: string;
-
-    /**
-     * Optimized thumbnail URL for images
-     */
-    thumbnail_url?: string;
-  }
-
-  /**
-   * Recurring billing configuration for subscription variants
-   */
-  export interface Recurring {
-    /**
-     * Billing frequency: day, week, month, or year
-     */
-    interval: 'day' | 'week' | 'month' | 'year';
-
-    /**
-     * Number of intervals between billings
-     */
-    interval_count?: number;
-  }
-}
+export type VariantsCursorIDPage = CursorIDPage<Variant>;
 
 /**
  * A product variant representing a specific tier or configuration. Each variant
  * has its own pricing. Variants allow a single product to have multiple pricing
  * options (e.g., Basic, Pro, Enterprise tiers).
  */
-export interface VariantGetResponse {
+export interface Variant {
   /**
    * Unique identifier for the topic subscription
    */
@@ -735,7 +98,7 @@ export interface VariantGetResponse {
   /**
    * Price configuration for a product. Can be one-time or recurring (subscription).
    */
-  default_price?: VariantGetResponse.DefaultPrice | null;
+  default_price?: Variant.DefaultPrice | null;
 
   /**
    * Detailed description of what this variant includes
@@ -745,7 +108,7 @@ export interface VariantGetResponse {
   /**
    * Media attachments (images, videos) for the variant
    */
-  media?: Array<VariantGetResponse.Media>;
+  media?: Array<Variant.Media>;
 
   /**
    * Custom metadata for the variant
@@ -755,7 +118,7 @@ export interface VariantGetResponse {
   /**
    * Recurring billing configuration for subscription variants
    */
-  recurring?: VariantGetResponse.Recurring | null;
+  recurring?: Variant.Recurring | null;
 
   /**
    * Price amount in the smallest currency unit (e.g., cents). 0 for free variants.
@@ -763,7 +126,7 @@ export interface VariantGetResponse {
   unit_amount?: number;
 }
 
-export namespace VariantGetResponse {
+export namespace Variant {
   /**
    * Price configuration for a product. Can be one-time or recurring (subscription).
    */
@@ -1015,12 +378,8 @@ export interface VariantGetParams {
 
 export declare namespace Variants {
   export {
-    type VariantCreateResponse as VariantCreateResponse,
-    type VariantUpdateResponse as VariantUpdateResponse,
-    type VariantListResponse as VariantListResponse,
-    type VariantArchiveResponse as VariantArchiveResponse,
-    type VariantGetResponse as VariantGetResponse,
-    type VariantListResponsesCursorIDPage as VariantListResponsesCursorIDPage,
+    type Variant as Variant,
+    type VariantsCursorIDPage as VariantsCursorIDPage,
     type VariantCreateParams as VariantCreateParams,
     type VariantUpdateParams as VariantUpdateParams,
     type VariantListParams as VariantListParams,