@stigg/typescript 0.1.0-alpha.4 → 0.1.0-alpha.7

package/src/resources/v1/products.ts

@@ -0,0 +1,162 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { MyCursorIDPage, type MyCursorIDPageParams, PagePromise } from '../../core/pagination';
+import { RequestOptions } from '../../internal/request-options';
+
+export class Products extends APIResource {
+  /**
+   * Retrieves a paginated list of products in the environment.
+   */
+  listProducts(
+    query: ProductListProductsParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ProductListProductsResponsesMyCursorIDPage, ProductListProductsResponse> {
+    return this._client.getAPIList('/api/v1/products', MyCursorIDPage<ProductListProductsResponse>, {
+      query,
+      ...options,
+    });
+  }
+}
+
+export type ProductListProductsResponsesMyCursorIDPage = MyCursorIDPage<ProductListProductsResponse>;
+
+/**
+ * Product configuration object
+ */
+export interface ProductListProductsResponse {
+  /**
+   * The unique identifier for the entity
+   */
+  id: string;
+
+  /**
+   * Timestamp of when the record was created
+   */
+  createdAt: string;
+
+  /**
+   * Description of the product
+   */
+  description: string | null;
+
+  /**
+   * Display name of the product
+   */
+  displayName: string;
+
+  /**
+   * Metadata associated with the entity
+   */
+  metadata: { [key: string]: string };
+
+  /**
+   * Indicates if multiple subscriptions to this product are allowed
+   */
+  multipleSubscriptions: boolean;
+
+  /**
+   * The status of the product
+   */
+  status: 'PUBLISHED' | 'ARCHIVED';
+
+  /**
+   * Timestamp of when the record was last updated
+   */
+  updatedAt: string;
+
+  /**
+   * Product behavior settings for subscription lifecycle management.
+   */
+  productSettings?: ProductListProductsResponse.ProductSettings;
+}
+
+export namespace ProductListProductsResponse {
+  /**
+   * Product behavior settings for subscription lifecycle management.
+   */
+  export interface ProductSettings {
+    /**
+     * Time when the subscription will be cancelled
+     */
+    subscriptionCancellationTime: 'END_OF_BILLING_PERIOD' | 'IMMEDIATE' | 'SPECIFIC_DATE';
+
+    /**
+     * Setup for the end of the subscription
+     */
+    subscriptionEndSetup: 'DOWNGRADE_TO_FREE' | 'CANCEL_SUBSCRIPTION';
+
+    /**
+     * Setup for the start of the subscription
+     */
+    subscriptionStartSetup: 'PLAN_SELECTION' | 'TRIAL_PERIOD' | 'FREE_PLAN';
+
+    /**
+     * ID of the plan to downgrade to at the end of the billing period
+     */
+    downgradePlanId?: string | null;
+
+    /**
+     * Indicates if the subscription should be prorated at the end of the billing
+     * period
+     */
+    prorateAtEndOfBillingPeriod?: boolean | null;
+
+    /**
+     * ID of the plan to start the subscription with
+     */
+    subscriptionStartPlanId?: string | null;
+  }
+}
+
+export interface ProductListProductsParams extends MyCursorIDPageParams {
+  /**
+   * Filter by entity ID
+   */
+  id?: string;
+
+  /**
+   * Filter by creation date using range operators: gt, gte, lt, lte
+   */
+  createdAt?: ProductListProductsParams.CreatedAt;
+
+  /**
+   * Filter by product status. Supports comma-separated values for multiple statuses
+   */
+  status?: string;
+}
+
+export namespace ProductListProductsParams {
+  /**
+   * Filter by creation date using range operators: gt, gte, lt, lte
+   */
+  export interface CreatedAt {
+    /**
+     * Greater than the specified createdAt value
+     */
+    gt?: string;
+
+    /**
+     * Greater than or equal to the specified createdAt value
+     */
+    gte?: string;
+
+    /**
+     * Less than the specified createdAt value
+     */
+    lt?: string;
+
+    /**
+     * Less than or equal to the specified createdAt value
+     */
+    lte?: string;
+  }
+}
+
+export declare namespace Products {
+  export {
+    type ProductListProductsResponse as ProductListProductsResponse,
+    type ProductListProductsResponsesMyCursorIDPage as ProductListProductsResponsesMyCursorIDPage,
+    type ProductListProductsParams as ProductListProductsParams,
+  };
+}

package/src/resources/v1/subscriptions/future-update.ts

@@ -7,14 +7,15 @@ import { path } from '../../../internal/utils/path';
 
 export class FutureUpdate extends APIResource {
   /**
-   * Cancel pending payment update
+   * Cancels a subscription update that is pending payment completion.
    */
   cancelPendingPayment(id: string, options?: RequestOptions): APIPromise<CancelSubscription> {
     return this._client.delete(path`/api/v1/subscriptions/${id}/future-update/pending-payment`, options);
   }
 
   /**
-   * Cancel scheduled update
+   * Cancels a scheduled subscription update, such as a future downgrade or plan
+   * change.
    */
   cancelSchedule(id: string, options?: RequestOptions): APIPromise<CancelSubscription> {
     return this._client.delete(path`/api/v1/subscriptions/${id}/future-update/schedule`, options);

package/src/resources/v1/subscriptions/subscriptions.ts

@@ -12,21 +12,24 @@ export class Subscriptions extends APIResource {
   futureUpdate: FutureUpdateAPI.FutureUpdate = new FutureUpdateAPI.FutureUpdate(this._client);
 
   /**
-   * Get a single subscription by ID
+   * Retrieves a subscription by its unique identifier, including plan details,
+   * billing period, status, and add-ons.
    */
   retrieve(id: string, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.get(path`/api/v1/subscriptions/${id}`, options);
   }
 
   /**
-   * Update a subscription
+   * Updates an active subscription's properties including billing period, add-ons,
+   * unit quantities, and discounts.
    */
   update(id: string, body: SubscriptionUpdateParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.patch(path`/api/v1/subscriptions/${id}`, { body, ...options });
   }
 
   /**
-   * Get a list of subscriptions
+   * Retrieves a paginated list of subscriptions, with optional filters for customer,
+   * status, and plan.
    */
   list(
     query: SubscriptionListParams | null | undefined = {},
@@ -39,35 +42,40 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Cancel subscription
+   * Cancels an active subscription, either immediately or at a specified time such
+   * as end of billing period.
    */
   cancel(id: string, body: SubscriptionCancelParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/cancel`, { body, ...options });
   }
 
   /**
-   * Delegate subscription payment to customer
+   * Delegates the payment responsibility of a subscription to a different customer.
+   * The delegated customer will be billed for this subscription.
    */
   delegate(id: string, body: SubscriptionDelegateParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/delegate`, { body, ...options });
   }
 
   /**
-   * Bulk import subscriptions
+   * Imports multiple subscriptions in bulk. Used for migrating subscription data
+   * from external systems.
    */
   import(body: SubscriptionImportParams, options?: RequestOptions): APIPromise<SubscriptionImportResponse> {
     return this._client.post('/api/v1/subscriptions/import', { body, ...options });
   }
 
   /**
-   * Migrate subscription to latest plan version
+   * Migrates a subscription to the latest published version of its plan or add-ons.
+   * Handles prorated charges or credits automatically.
    */
   migrate(id: string, body: SubscriptionMigrateParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/migrate`, { body, ...options });
   }
 
   /**
-   * Preview subscription
+   * Previews the pricing impact of creating or updating a subscription without
+   * making changes. Returns estimated costs, taxes, and proration details.
    */
   preview(
     body: SubscriptionPreviewParams,
@@ -77,7 +85,8 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Provision subscription
+   * Creates a new subscription for an existing customer. When payment is required
+   * and no payment method exists, returns a checkout URL.
    */
   provision(
     body: SubscriptionProvisionParams,
@@ -87,7 +96,8 @@ export class Subscriptions extends APIResource {
   }
 
   /**
-   * Transfer subscription to resource
+   * Transfers a subscription to a different resource ID. Used for multi-resource
+   * products where subscriptions apply to specific entities like websites or apps.
    */
   transfer(id: string, body: SubscriptionTransferParams, options?: RequestOptions): APIPromise<Subscription> {
     return this._client.post(path`/api/v1/subscriptions/${id}/transfer`, { body, ...options });
@@ -777,80 +787,184 @@ export namespace SubscriptionProvisionResponse {
      */
     id: string;
 
-    entitlements: Array<Data.Entitlement>;
+    entitlements: Array<Data.UnionMember0 | Data.UnionMember1> | null;
 
     /**
      * Provision status: SUCCESS or PAYMENT_REQUIRED
      */
     status: 'SUCCESS' | 'PAYMENT_REQUIRED';
 
+    /**
+     * Created subscription (when status is SUCCESS)
+     */
+    subscription: Data.Subscription | null;
+
     /**
      * Checkout billing ID when payment is required
      */
-    checkoutBillingId?: string | null;
+    checkoutBillingId?: string;
 
     /**
      * URL to complete payment when PAYMENT_REQUIRED
      */
-    checkoutUrl?: string | null;
+    checkoutUrl?: string;
 
     /**
      * Whether the subscription is scheduled for future activation
      */
     isScheduled?: boolean;
-
-    /**
-     * Created subscription (when status is SUCCESS)
-     */
-    subscription?: Data.Subscription;
   }
 
   export namespace Data {
-    export interface Entitlement {
-      accessDeniedReason?: string | null;
+    export interface UnionMember0 {
+      accessDeniedReason:
+        | 'FeatureNotFound'
+        | 'CustomerNotFound'
+        | 'CustomerIsArchived'
+        | 'CustomerResourceNotFound'
+        | 'NoActiveSubscription'
+        | 'NoFeatureEntitlementInSubscription'
+        | 'RequestedUsageExceedingLimit'
+        | 'RequestedValuesMismatch'
+        | 'BudgetExceeded'
+        | 'Unknown'
+        | 'FeatureTypeMismatch'
+        | 'Revoked'
+        | 'InsufficientCredits'
+        | 'EntitlementNotFound'
+        | null;
+
+      isGranted: boolean;
+
+      type: 'FEATURE';
 
       currentUsage?: number;
 
       /**
-       * entitlement updated at
+       * Timestamp of the last update to the entitlement grant or configuration.
        */
-      entitlementUpdatedAt?: string | null;
-
-      feature?: Entitlement.Feature | null;
+      entitlementUpdatedAt?: string;
 
-      hasUnlimitedUsage?: boolean | null;
+      feature?: UnionMember0.Feature;
 
-      isGranted?: boolean;
+      hasUnlimitedUsage?: boolean;
 
       resetPeriod?: 'YEAR' | 'MONTH' | 'WEEK' | 'DAY' | 'HOUR' | null;
 
       usageLimit?: number | null;
 
       /**
-       * usage period anchor
+       * The anchor for calculating the usage period for metered entitlements with a
+       * reset period configured
        */
-      usagePeriodAnchor?: string | null;
+      usagePeriodAnchor?: string;
 
       /**
-       * usage period end
+       * The end date of the usage period for metered entitlements with a reset period
+       * configured
        */
-      usagePeriodEnd?: string | null;
+      usagePeriodEnd?: string;
 
       /**
-       * usage period start
+       * The start date of the usage period for metered entitlements with a reset period
+       * configured
        */
-      usagePeriodStart?: string | null;
+      usagePeriodStart?: string;
+
+      /**
+       * The next time the entitlement should be recalculated
+       */
+      validUntil?: string;
     }
 
-    export namespace Entitlement {
+    export namespace UnionMember0 {
       export interface Feature {
         /**
-         * Feature ID
+         * The human-readable name of the entitlement, shown in UI elements.
+         */
+        displayName: string;
+
+        /**
+         * The current status of the feature.
+         */
+        featureStatus: 'NEW' | 'SUSPENDED' | 'ACTIVE';
+
+        /**
+         * The type of feature associated with the entitlement.
+         */
+        featureType: 'BOOLEAN' | 'NUMBER' | 'ENUM';
+
+        /**
+         * The unique reference ID of the entitlement.
          */
         refId: string;
       }
     }
 
+    export interface UnionMember1 {
+      accessDeniedReason:
+        | 'FeatureNotFound'
+        | 'CustomerNotFound'
+        | 'CustomerIsArchived'
+        | 'CustomerResourceNotFound'
+        | 'NoActiveSubscription'
+        | 'NoFeatureEntitlementInSubscription'
+        | 'RequestedUsageExceedingLimit'
+        | 'RequestedValuesMismatch'
+        | 'BudgetExceeded'
+        | 'Unknown'
+        | 'FeatureTypeMismatch'
+        | 'Revoked'
+        | 'InsufficientCredits'
+        | 'EntitlementNotFound'
+        | null;
+
+      /**
+       * The currency associated with a credit entitlement.
+       */
+      currency: UnionMember1.Currency;
+
+      currentUsage: number;
+
+      isGranted: boolean;
+
+      type: 'CREDIT';
+
+      usageLimit: number;
+
+      /**
+       * Timestamp of the last update to the credit usage.
+       */
+      usageUpdatedAt: string;
+
+      /**
+       * Timestamp of the last update to the entitlement grant or configuration.
+       */
+      entitlementUpdatedAt?: string;
+
+      /**
+       * The end date of the current billing period for recurring credit grants.
+       */
+      usagePeriodEnd?: string;
+
+      /**
+       * The next time the entitlement should be recalculated
+       */
+      validUntil?: string;
+    }
+
+    export namespace UnionMember1 {
+      /**
+       * The currency associated with a credit entitlement.
+       */
+      export interface Currency {
+        /**
+         * The unique identifier of the custom currency.
+         */
+        currencyId: string;
+      }
+    }
+
     /**
      * Created subscription (when status is SUCCESS)
      */
@@ -1859,10 +1973,25 @@ export namespace SubscriptionUpdateParams {
   }
 
   export interface PriceOverride {
+    /**
+     * Addon ID
+     */
+    addonId?: string;
+
+    /**
+     * Whether this is a base charge override
+     */
+    baseCharge?: boolean;
+
+    /**
+     * The corresponding custom currency id of the recurring credits price
+     */
+    currencyId?: string;
+
     /**
      * Feature ID
      */
-    featureId: string;
+    featureId?: string;
 
     price?: PriceOverride.Price;
   }
@@ -2035,17 +2164,65 @@ export namespace SubscriptionUpdateParams {
 }
 
 export interface SubscriptionListParams extends MyCursorIDPageParams {
+  /**
+   * Filter by creation date using range operators: gt, gte, lt, lte
+   */
+  createdAt?: SubscriptionListParams.CreatedAt;
+
   /**
    * Filter by customer ID
    */
   customerId?: string;
 
   /**
-   * Filter by status (comma-separated)
+   * Filter by plan ID
+   */
+  planId?: string;
+
+  /**
+   * Filter by pricing type. Supports comma-separated values for multiple types
+   */
+  pricingType?: string;
+
+  /**
+   * Filter by resource ID
+   */
+  resourceId?: string;
+
+  /**
+   * Filter by subscription status. Supports comma-separated values for multiple
+   * statuses
    */
   status?: string;
 }
 
+export namespace SubscriptionListParams {
+  /**
+   * Filter by creation date using range operators: gt, gte, lt, lte
+   */
+  export interface CreatedAt {
+    /**
+     * Greater than the specified createdAt value
+     */
+    gt?: string;
+
+    /**
+     * Greater than or equal to the specified createdAt value
+     */
+    gte?: string;
+
+    /**
+     * Less than the specified createdAt value
+     */
+    lt?: string;
+
+    /**
+     * Less than or equal to the specified createdAt value
+     */
+    lte?: string;
+  }
+}
+
 export interface SubscriptionCancelParams {
   /**
    * Action on cancellation (downgrade or revoke)
@@ -2082,6 +2259,11 @@ export interface SubscriptionImportParams {
    * List of subscription objects to import
    */
   subscriptions: Array<SubscriptionImportParams.Subscription>;
+
+  /**
+   * Integration ID to use for importing subscriptions
+   */
+  integrationId?: string | null;
 }
 
 export namespace SubscriptionImportParams {

package/src/resources/v1/usage.ts

@@ -7,7 +7,7 @@ import { path } from '../../internal/utils/path';
 
 export class Usage extends APIResource {
   /**
-   * Get usage history
+   * Retrieves historical usage data for a customer's metered feature over time.
    */
   history(
     featureID: string,
@@ -19,7 +19,8 @@ export class Usage extends APIResource {
   }
 
   /**
-   * Report usage measurements
+   * Reports usage measurements for metered features. The reported usage is used to
+   * track, limit, and bill customer consumption.
    */
   report(body: UsageReportParams, options?: RequestOptions): APIPromise<UsageReportResponse> {
     return this._client.post('/api/v1/usage', { body, ...options });

package/src/resources/v1/v1.ts

@@ -12,6 +12,13 @@ import {
 } from './coupons';
 import * as EventsAPI from './events';
 import { EventReportParams, EventReportResponse, Events } from './events';
+import * as ProductsAPI from './products';
+import {
+  ProductListProductsParams,
+  ProductListProductsResponse,
+  ProductListProductsResponsesMyCursorIDPage,
+  Products,
+} from './products';
 import * as UsageAPI from './usage';
 import {
   Usage,
@@ -25,6 +32,9 @@ import {
   CustomerImportParams,
   CustomerImportResponse,
   CustomerListParams,
+  CustomerListResourcesParams,
+  CustomerListResourcesResponse,
+  CustomerListResourcesResponsesMyCursorIDPage,
   CustomerListResponse,
   CustomerListResponsesMyCursorIDPage,
   CustomerProvisionParams,
@@ -58,6 +68,7 @@ export class V1 extends APIResource {
   coupons: CouponsAPI.Coupons = new CouponsAPI.Coupons(this._client);
   events: EventsAPI.Events = new EventsAPI.Events(this._client);
   usage: UsageAPI.Usage = new UsageAPI.Usage(this._client);
+  products: ProductsAPI.Products = new ProductsAPI.Products(this._client);
 }
 
 V1.Customers = Customers;
@@ -65,6 +76,7 @@ V1.Subscriptions = Subscriptions;
 V1.Coupons = Coupons;
 V1.Events = Events;
 V1.Usage = Usage;
+V1.Products = Products;
 
 export declare namespace V1 {
   export {
@@ -72,10 +84,13 @@ export declare namespace V1 {
     type CustomerResponse as CustomerResponse,
     type CustomerListResponse as CustomerListResponse,
     type CustomerImportResponse as CustomerImportResponse,
+    type CustomerListResourcesResponse as CustomerListResourcesResponse,
     type CustomerListResponsesMyCursorIDPage as CustomerListResponsesMyCursorIDPage,
+    type CustomerListResourcesResponsesMyCursorIDPage as CustomerListResourcesResponsesMyCursorIDPage,
     type CustomerUpdateParams as CustomerUpdateParams,
     type CustomerListParams as CustomerListParams,
     type CustomerImportParams as CustomerImportParams,
+    type CustomerListResourcesParams as CustomerListResourcesParams,
     type CustomerProvisionParams as CustomerProvisionParams,
   };
 
@@ -120,4 +135,11 @@ export declare namespace V1 {
     type UsageHistoryParams as UsageHistoryParams,
     type UsageReportParams as UsageReportParams,
   };
+
+  export {
+    Products as Products,
+    type ProductListProductsResponse as ProductListProductsResponse,
+    type ProductListProductsResponsesMyCursorIDPage as ProductListProductsResponsesMyCursorIDPage,
+    type ProductListProductsParams as ProductListProductsParams,
+  };
 }

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.1.0-alpha.4'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.7'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.4";
+export declare const VERSION = "0.1.0-alpha.7";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.0-alpha.4";
+export declare const VERSION = "0.1.0-alpha.7";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.1.0-alpha.4'; // x-release-please-version
+exports.VERSION = '0.1.0-alpha.7'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.1.0-alpha.4'; // x-release-please-version
+export const VERSION = '0.1.0-alpha.7'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map