@usehercules/sdk 1.7.0 → 1.8.0

package/resources/beta/pay/products/variants.d.ts

@@ -1,206 +0,0 @@
-import { APIResource } from "../../../../core/resource.js";
-import { APIPromise } from "../../../../core/api-promise.js";
-import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.js";
-import { RequestOptions } from "../../../../internal/request-options.js";
-export declare class Variants extends APIResource {
-    /**
-     * Creates a new variant with pricing for a product. Use variants to offer multiple
-     * 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<Variant>;
-    /**
-     * 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<Variant>;
-    /**
-     * Retrieves all variants for a product. Variants represent different pricing tiers
-     * or configurations (e.g., Basic, Pro, Enterprise) within a single product.
-     */
-    list(productID: string, query?: VariantListParams | null | undefined, options?: RequestOptions): PagePromise<VariantsCursorIDPage, Variant>;
-    /**
-     * 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<Variant>;
-    /**
-     * Retrieves a variant by ID. Returns the variant object including pricing details
-     * and status.
-     */
-    get(variantID: string, params: VariantGetParams, options?: RequestOptions): APIPromise<Variant>;
-}
-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 Variant {
-    /**
-     * 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;
-    /**
-     * Price configuration for a product. Can be one-time or recurring (subscription).
-     */
-    default_price?: Variant.DefaultPrice | null;
-    /**
-     * Detailed description of what this variant includes
-     */
-    description?: string | null;
-}
-export declare namespace Variant {
-    /**
-     * Price configuration for a product. Can be one-time or recurring (subscription).
-     */
-    interface DefaultPrice {
-        /**
-         * Unique identifier for the topic subscription
-         */
-        id: string;
-        /**
-         * How to handle the billing cycle when switching plans. 'now' resets to current
-         * time, 'unchanged' keeps the original anchor. Null for one-time prices.
-         */
-        billing_cycle_anchor: 'now' | 'unchanged' | null;
-        /**
-         * 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;
-        /**
-         * How to handle prorations when switching plans. 'default' creates prorations,
-         * 'none' disables them. Null for one-time prices.
-         */
-        proration_behavior: 'default' | 'none' | null;
-        /**
-         * When to calculate proration. 'now' uses current time, 'start_of_period' uses the
-         * billing period start. Null for one-time prices or to use Stripe's default.
-         */
-        proration_date: 'now' | 'start_of_period' | 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;
-    }
-}
-export interface VariantCreateParams {
-    /**
-     * Display name for the variant (e.g., Basic, Standard, Premium)
-     */
-    name: string;
-    /**
-     * Price amount in the smallest currency unit (e.g., cents). Use 0 for free
-     * variants.
-     */
-    unit_amount: number;
-    /**
-     * Optional custom ID for the variant. If not provided, one will be generated.
-     */
-    id?: string;
-    /**
-     * Default billing cycle anchor behavior when switching to this price. 'now' resets
-     * to current time, 'unchanged' keeps original anchor. Only applies to recurring
-     * prices.
-     */
-    billing_cycle_anchor?: 'now' | 'unchanged';
-    /**
-     * Three-letter ISO currency code
-     */
-    currency?: string;
-    /**
-     * Detailed description of what this variant includes
-     */
-    description?: string;
-    /**
-     * Billing frequency for recurring prices: day, week, month, or year. Required for
-     * recurring type, ignored for one_time.
-     */
-    interval?: 'day' | 'week' | 'month' | 'year';
-    /**
-     * Number of intervals between billings for recurring prices. Required for
-     * recurring type, ignored for one_time.
-     */
-    interval_count?: number;
-    /**
-     * Default proration behavior when switching to this price. 'default' creates
-     * prorations, 'none' disables them. Only applies to recurring prices.
-     */
-    proration_behavior?: 'default' | 'none';
-    /**
-     * Default proration date calculation when switching to this price. 'now' uses
-     * current time, 'start_of_period' uses billing period start. Only applies to
-     * recurring prices.
-     */
-    proration_date?: 'now' | 'start_of_period';
-    /**
-     * Price type: one_time for single purchases, recurring for subscriptions
-     */
-    type?: 'one_time' | 'recurring';
-}
-export interface VariantUpdateParams {
-    /**
-     * Path param: The unique identifier of the product
-     */
-    product_id: string;
-    /**
-     * Body param: Whether the variant is available for new purchases
-     */
-    active?: boolean;
-    /**
-     * Body param: Detailed description of what this variant includes
-     */
-    description?: string;
-    /**
-     * Body param: Display name for the variant
-     */
-    name?: string;
-}
-export interface VariantListParams extends CursorIDPageParams {
-    /**
-     * Filter by active status
-     */
-    active?: 'true' | 'false';
-}
-export interface VariantArchiveParams {
-    /**
-     * The unique identifier of the product
-     */
-    product_id: string;
-}
-export interface VariantGetParams {
-    /**
-     * The unique identifier of the product
-     */
-    product_id: string;
-}
-export declare namespace Variants {
-    export { type Variant as Variant, type VariantsCursorIDPage as VariantsCursorIDPage, type VariantCreateParams as VariantCreateParams, type VariantUpdateParams as VariantUpdateParams, type VariantListParams as VariantListParams, type VariantArchiveParams as VariantArchiveParams, type VariantGetParams as VariantGetParams, };
-}
-//# sourceMappingURL=variants.d.ts.map

package/resources/beta/pay/products/variants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"variants.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":"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"}

package/resources/beta/pay/products/variants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"variants.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAwD;AAExD,+DAAiG;AAEjG,6DAAuD;AAEvD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;OAIG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,WAAW,EAAE,CAAA,yBAAqB,CAAA,EAAE;YAClG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;CACF;AAtDD,4BAsDC"}

package/resources/beta/pay/products/variants.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"variants.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/variants.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAEf,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IACvC;;;;OAIG;IACH,MAAM,CAAC,SAAiB,EAAE,IAAyB,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA2B,EAAE,OAAwB;QAC7E,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE;YACpF,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAA,oBAAoB,SAAS,WAAW,EAAE,CAAA,YAAqB,CAAA,EAAE;YAClG,KAAK;YACL,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,MAA4B,EAAE,OAAwB;QAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAClG,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,MAAwB,EAAE,OAAwB;QACvE,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,UAAU,aAAa,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/F,CAAC;CACF"}

package/resources/beta/pay/products.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"products.d.mts","sourceRoot":"","sources":["../../../src/resources/beta/pay/products.ts"],"names":[],"mappings":""}

package/resources/beta/pay/products.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../src/resources/beta/pay/products.ts"],"names":[],"mappings":""}

package/resources/beta/pay/products.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"products.js","sourceRoot":"","sources":["../../../src/resources/beta/pay/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/beta/pay/products.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../../src/resources/beta/pay/products.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/resources/beta/pay.d.mts

@@ -1,2 +0,0 @@
-export * from "./pay/index.mjs";
-//# sourceMappingURL=pay.d.mts.map

package/resources/beta/pay.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pay.d.mts","sourceRoot":"","sources":["../../src/resources/beta/pay.ts"],"names":[],"mappings":""}

package/resources/beta/pay.d.ts

@@ -1,2 +0,0 @@
-export * from "./pay/index.js";
-//# sourceMappingURL=pay.d.ts.map

package/resources/beta/pay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pay.d.ts","sourceRoot":"","sources":["../../src/resources/beta/pay.ts"],"names":[],"mappings":""}

package/resources/beta/pay.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"pay.js","sourceRoot":"","sources":["../../src/resources/beta/pay.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,yDAA4B"}

package/resources/beta/pay.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"pay.mjs","sourceRoot":"","sources":["../../src/resources/beta/pay.ts"],"names":[],"mappings":"AAAA,sFAAsF"}

package/src/resources/beta/pay/coupons.ts

@@ -1,218 +0,0 @@
-// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-
-import { APIResource } from '../../../core/resource';
-import { APIPromise } from '../../../core/api-promise';
-import { CursorIDPage, type CursorIDPageParams, PagePromise } from '../../../core/pagination';
-import { buildHeaders } from '../../../internal/headers';
-import { RequestOptions } from '../../../internal/request-options';
-import { path } from '../../../internal/utils/path';
-
-export class Coupons extends APIResource {
-  /**
-   * Creates a discount coupon with a promo code. Coupons can offer percentage or
-   * fixed-amount discounts and can be limited by redemption count or expiration
-   * date. Customers can apply coupons during checkout.
-   */
-  create(body: CouponCreateParams, options?: RequestOptions): APIPromise<Coupon> {
-    return this._client.post('/v1/pay/coupons', { body, ...options });
-  }
-
-  /**
-   * Updates an existing coupon. Use this to modify the display name or deactivate
-   * the coupon. Discount amounts and codes cannot be changed after creation.
-   */
-  update(
-    couponID: string,
-    body: CouponUpdateParams | null | undefined = {},
-    options?: RequestOptions,
-  ): APIPromise<Coupon> {
-    return this._client.patch(path`/v1/pay/coupons/${couponID}`, { body, ...options });
-  }
-
-  /**
-   * Retrieves a paginated list of all coupons. Coupons provide discounts that
-   * customers can apply during checkout using a promo code.
-   */
-  list(
-    query: CouponListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<CouponsCursorIDPage, Coupon> {
-    return this._client.getAPIList('/v1/pay/coupons', CursorIDPage<Coupon>, { query, ...options });
-  }
-
-  /**
-   * Permanently deletes a coupon. The promo code can no longer be used. Existing
-   * discounts applied to active subscriptions are not affected.
-   */
-  delete(couponID: string, options?: RequestOptions): APIPromise<void> {
-    return this._client.delete(path`/v1/pay/coupons/${couponID}`, {
-      ...options,
-      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-    });
-  }
-
-  /**
-   * Retrieves a coupon by ID. Returns the coupon object including discount details
-   * and redemption statistics.
-   */
-  get(couponID: string, options?: RequestOptions): APIPromise<Coupon> {
-    return this._client.get(path`/v1/pay/coupons/${couponID}`, options);
-  }
-}
-
-export type CouponsCursorIDPage = CursorIDPage<Coupon>;
-
-/**
- * A discount coupon that customers can apply during checkout using a promo code
- */
-export interface Coupon {
-  /**
-   * Unique identifier for the topic subscription
-   */
-  id: string;
-
-  /**
-   * Whether the coupon is currently active and can be redeemed
-   */
-  active: boolean;
-
-  /**
-   * The promo code customers enter to apply the discount
-   */
-  code: string;
-
-  /**
-   * Timestamp when the coupon was created
-   */
-  created: string;
-
-  /**
-   * How long the discount applies: once (first payment only), repeating (for
-   * duration_in_months), or forever
-   */
-  duration: 'once' | 'repeating' | 'forever';
-
-  /**
-   * Number of times this coupon has been successfully redeemed
-   */
-  times_redeemed: number;
-
-  /**
-   * Fixed discount amount in the smallest currency unit (e.g., cents). Mutually
-   * exclusive with percent_off.
-   */
-  amount_off?: number | null;
-
-  /**
-   * Three-letter ISO currency code for amount_off discounts
-   */
-  currency?: string | null;
-
-  /**
-   * Number of months the discount applies when duration is 'repeating'
-   */
-  duration_in_months?: number | null;
-
-  /**
-   * Maximum number of times this coupon can be redeemed across all customers
-   */
-  max_redemptions?: number | null;
-
-  /**
-   * Display name for the coupon (shown to customers)
-   */
-  name?: string | null;
-
-  /**
-   * Percentage discount (1-100). Mutually exclusive with amount_off.
-   */
-  percent_off?: number | null;
-
-  /**
-   * Expiration date after which the coupon can no longer be redeemed
-   */
-  redeem_by?: string | null;
-}
-
-export interface CouponCreateParams {
-  /**
-   * The promo code customers will enter to apply the discount
-   */
-  code: string;
-
-  /**
-   * Optional custom ID for the coupon. If not provided, one will be generated.
-   */
-  id?: string;
-
-  /**
-   * Fixed discount in the smallest currency unit (e.g., cents). Mutually exclusive
-   * with percent_off.
-   */
-  amount_off?: number;
-
-  /**
-   * Three-letter ISO currency code for amount_off discounts
-   */
-  currency?: string;
-
-  /**
-   * How long the discount applies: once (first payment only), repeating (for
-   * duration_in_months), or forever
-   */
-  duration?: 'once' | 'repeating' | 'forever';
-
-  /**
-   * Number of months the discount applies when duration is 'repeating'
-   */
-  duration_in_months?: number;
-
-  /**
-   * Maximum number of times this coupon can be redeemed
-   */
-  max_redemptions?: number;
-
-  /**
-   * Display name for the coupon (shown to customers)
-   */
-  name?: string;
-
-  /**
-   * Percentage discount (1-100). Mutually exclusive with amount_off.
-   */
-  percent_off?: number;
-
-  /**
-   * Expiration date after which the coupon can no longer be redeemed
-   */
-  redeem_by?: string;
-}
-
-export interface CouponUpdateParams {
-  /**
-   * Whether the coupon is active and can be redeemed
-   */
-  active?: boolean;
-
-  /**
-   * Display name for the coupon
-   */
-  name?: string;
-}
-
-export interface CouponListParams extends CursorIDPageParams {
-  /**
-   * Filter by active status
-   */
-  active?: boolean;
-}
-
-export declare namespace Coupons {
-  export {
-    type Coupon as Coupon,
-    type CouponsCursorIDPage as CouponsCursorIDPage,
-    type CouponCreateParams as CouponCreateParams,
-    type CouponUpdateParams as CouponUpdateParams,
-    type CouponListParams as CouponListParams,
-  };
-}