@usehercules/sdk 1.2.0 → 1.4.0

package/resources/beta/pay/pay.mjs

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../core/resource.mjs";
+import * as CouponsAPI from "./coupons.mjs";
+import { Coupons, } from "./coupons.mjs";
+import * as CustomersAPI from "./customers.mjs";
+import { Customers, } from "./customers.mjs";
+import * as EntitlementsAPI from "./entitlements.mjs";
+import { Entitlements, } from "./entitlements.mjs";
+import * as ProductsAPI from "./products/products.mjs";
+import { Products, } from "./products/products.mjs";
+export class Pay extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.customers = new CustomersAPI.Customers(this._client);
+        this.products = new ProductsAPI.Products(this._client);
+        this.entitlements = new EntitlementsAPI.Entitlements(this._client);
+        this.coupons = new CouponsAPI.Coupons(this._client);
+    }
+    /**
+     * Cancels a customer's subscription. By default, the subscription remains active
+     * until the end of the current billing period. Set cancellation_timing to
+     * 'immediate' to cancel immediately.
+     */
+    cancel(body, options) {
+        return this._client.post('/v1/pay/cancel', { body, ...options });
+    }
+    /**
+     * Verifies if a customer has access to a specific feature. Use this to gate
+     * features in your app based on the customer's active subscription and the
+     * entitlements attached to their product. Hercules recommends calling this before
+     * allowing access to premium features.
+     */
+    check(body, options) {
+        return this._client.post('/v1/pay/check', { body, ...options });
+    }
+    /**
+     * Creates a checkout session for a customer to subscribe to a product. Returns a
+     * URL to redirect the customer to for payment. After successful payment, the
+     * customer is subscribed to the product and gains access to its entitlements.
+     */
+    checkout(body, options) {
+        return this._client.post('/v1/pay/checkout', { body, ...options });
+    }
+}
+Pay.Customers = Customers;
+Pay.Products = Products;
+Pay.Entitlements = Entitlements;
+Pay.Coupons = Coupons;
+//# sourceMappingURL=pay.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pay.mjs","sourceRoot":"","sources":["../../../src/resources/beta/pay/pay.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,UAAU;OACf,EAKL,OAAO,GAER;OACM,KAAK,YAAY;OACjB,EAQL,SAAS,GAEV;OACM,KAAK,eAAe;OACpB,EAKL,YAAY,GAEb;OACM,KAAK,WAAW;OAChB,EAKL,QAAQ,GAET;AAID,MAAM,OAAO,GAAI,SAAQ,WAAW;IAApC;;QACE,cAAS,GAA2B,IAAI,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7E,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,YAAO,GAAuB,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA6BrE,CAAC;IA3BC;;;;OAIG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAoB,EAAE,OAAwB;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAuB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;CACF;AAkMD,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;AAC1B,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;AACxB,GAAG,CAAC,YAAY,GAAG,YAAY,CAAC;AAChC,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC"}

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

@@ -0,0 +1,53 @@
+import { APIResource } from "../../../../core/resource.mjs";
+import * as EntitlementsAPI from "../entitlements.mjs";
+import { APIPromise } from "../../../../core/api-promise.mjs";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.mjs";
+import { RequestOptions } from "../../../../internal/request-options.mjs";
+export declare class Entitlements extends APIResource {
+    /**
+     * Retrieves all entitlements attached to a product. These entitlements define the
+     * features that customers subscribed to this product can access.
+     */
+    list(productID: string, query?: EntitlementListParams | null | undefined, options?: RequestOptions): PagePromise<ProductEntitlementsCursorIDPage, ProductEntitlement>;
+    /**
+     * Attaches an entitlement to a product. All customers subscribed to this product
+     * will gain access to the attached feature. Hercules recommends attaching
+     * entitlements when creating or updating products to keep feature access in sync.
+     */
+    attach(productID: string, body: EntitlementAttachParams, options?: RequestOptions): APIPromise<ProductEntitlement>;
+    /**
+     * Removes an entitlement from a product. Customers subscribed to this product will
+     * lose access to the feature. Existing subscriptions are affected immediately.
+     */
+    remove(featureID: string, params: EntitlementRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+export type ProductEntitlementsCursorIDPage = CursorIDPage<ProductEntitlement>;
+/**
+ * An entitlement attached to a product. All customers subscribed to the product
+ * gain access to this entitlement.
+ */
+export interface ProductEntitlement {
+    /**
+     * Unique identifier for the price
+     */
+    id: string;
+    /**
+     * The entitlement attached to the product
+     */
+    entitlement: EntitlementsAPI.Entitlement;
+}
+export interface EntitlementListParams extends CursorIDPageParams {
+}
+export interface EntitlementAttachParams {
+    /**
+     * The ID of the entitlement to attach to the product
+     */
+    entitlement: string;
+}
+export interface EntitlementRemoveParams {
+    product_id: string;
+}
+export declare namespace Entitlements {
+    export { type ProductEntitlement as ProductEntitlement, type ProductEntitlementsCursorIDPage as ProductEntitlementsCursorIDPage, type EntitlementListParams as EntitlementListParams, type EntitlementAttachParams as EntitlementAttachParams, type EntitlementRemoveParams as EntitlementRemoveParams, };
+}
+//# sourceMappingURL=entitlements.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/entitlements.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OAEtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;OAGG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;IAQnE;;;;OAIG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kBAAkB,CAAC;IAIjC;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOvG;AAED,MAAM,MAAM,+BAA+B,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;CAAG;AAEpE,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

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

@@ -0,0 +1,53 @@
+import { APIResource } from "../../../../core/resource.js";
+import * as EntitlementsAPI from "../entitlements.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 Entitlements extends APIResource {
+    /**
+     * Retrieves all entitlements attached to a product. These entitlements define the
+     * features that customers subscribed to this product can access.
+     */
+    list(productID: string, query?: EntitlementListParams | null | undefined, options?: RequestOptions): PagePromise<ProductEntitlementsCursorIDPage, ProductEntitlement>;
+    /**
+     * Attaches an entitlement to a product. All customers subscribed to this product
+     * will gain access to the attached feature. Hercules recommends attaching
+     * entitlements when creating or updating products to keep feature access in sync.
+     */
+    attach(productID: string, body: EntitlementAttachParams, options?: RequestOptions): APIPromise<ProductEntitlement>;
+    /**
+     * Removes an entitlement from a product. Customers subscribed to this product will
+     * lose access to the feature. Existing subscriptions are affected immediately.
+     */
+    remove(featureID: string, params: EntitlementRemoveParams, options?: RequestOptions): APIPromise<void>;
+}
+export type ProductEntitlementsCursorIDPage = CursorIDPage<ProductEntitlement>;
+/**
+ * An entitlement attached to a product. All customers subscribed to the product
+ * gain access to this entitlement.
+ */
+export interface ProductEntitlement {
+    /**
+     * Unique identifier for the price
+     */
+    id: string;
+    /**
+     * The entitlement attached to the product
+     */
+    entitlement: EntitlementsAPI.Entitlement;
+}
+export interface EntitlementListParams extends CursorIDPageParams {
+}
+export interface EntitlementAttachParams {
+    /**
+     * The ID of the entitlement to attach to the product
+     */
+    entitlement: string;
+}
+export interface EntitlementRemoveParams {
+    product_id: string;
+}
+export declare namespace Entitlements {
+    export { type ProductEntitlement as ProductEntitlement, type ProductEntitlementsCursorIDPage as ProductEntitlementsCursorIDPage, type EntitlementListParams as EntitlementListParams, type EntitlementAttachParams as EntitlementAttachParams, type EntitlementRemoveParams as EntitlementRemoveParams, };
+}
+//# sourceMappingURL=entitlements.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/entitlements.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OAEtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,YAAa,SAAQ,WAAW;IAC3C;;;OAGG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,qBAAqB,GAAG,IAAI,GAAG,SAAc,EACpD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,+BAA+B,EAAE,kBAAkB,CAAC;IAQnE;;;;OAIG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,uBAAuB,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,kBAAkB,CAAC;IAIjC;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC;CAOvG;AAED,MAAM,MAAM,+BAA+B,GAAG,YAAY,CAAC,kBAAkB,CAAC,CAAC;AAE/E;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC;CAC1C;AAED,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;CAAG;AAEpE,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,CAAC,OAAO,WAAW,YAAY,CAAC;IACpC,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,+BAA+B,IAAI,+BAA+B,EACvE,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,uBAAuB,IAAI,uBAAuB,EACvD,KAAK,uBAAuB,IAAI,uBAAuB,GACxD,CAAC;CACH"}

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

@@ -0,0 +1,38 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entitlements = void 0;
+const resource_1 = require("../../../../core/resource.js");
+const pagination_1 = require("../../../../core/pagination.js");
+const headers_1 = require("../../../../internal/headers.js");
+const path_1 = require("../../../../internal/utils/path.js");
+class Entitlements extends resource_1.APIResource {
+    /**
+     * Retrieves all entitlements attached to a product. These entitlements define the
+     * features that customers subscribed to this product can access.
+     */
+    list(productID, query = {}, options) {
+        return this._client.getAPIList((0, path_1.path) `/v1/pay/products/${productID}/entitlements`, (pagination_1.CursorIDPage), { query, ...options });
+    }
+    /**
+     * Attaches an entitlement to a product. All customers subscribed to this product
+     * will gain access to the attached feature. Hercules recommends attaching
+     * entitlements when creating or updating products to keep feature access in sync.
+     */
+    attach(productID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/pay/products/${productID}/entitlements`, { body, ...options });
+    }
+    /**
+     * Removes an entitlement from a product. Customers subscribed to this product will
+     * lose access to the feature. Existing subscriptions are affected immediately.
+     */
+    remove(featureID, params, options) {
+        const { product_id } = params;
+        return this._client.delete((0, path_1.path) `/v1/pay/products/${product_id}/entitlements/${featureID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+exports.Entitlements = Entitlements;
+//# sourceMappingURL=entitlements.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/entitlements.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,2DAAwD;AAGxD,+DAAiG;AACjG,6DAA4D;AAE5D,6DAAuD;AAEvD,MAAa,YAAa,SAAQ,sBAAW;IAC3C;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAA,WAAI,EAAA,oBAAoB,SAAS,eAAe,EAChD,CAAA,yBAAgC,CAAA,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,SAAiB,EACjB,IAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA+B,EAAE,OAAwB;QACjF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,UAAU,iBAAiB,SAAS,EAAE,EAAE;YACzF,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF;AAzCD,oCAyCC"}

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

@@ -0,0 +1,34 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../core/resource.mjs";
+import { CursorIDPage } from "../../../../core/pagination.mjs";
+import { buildHeaders } from "../../../../internal/headers.mjs";
+import { path } from "../../../../internal/utils/path.mjs";
+export class Entitlements extends APIResource {
+    /**
+     * Retrieves all entitlements attached to a product. These entitlements define the
+     * features that customers subscribed to this product can access.
+     */
+    list(productID, query = {}, options) {
+        return this._client.getAPIList(path `/v1/pay/products/${productID}/entitlements`, (CursorIDPage), { query, ...options });
+    }
+    /**
+     * Attaches an entitlement to a product. All customers subscribed to this product
+     * will gain access to the attached feature. Hercules recommends attaching
+     * entitlements when creating or updating products to keep feature access in sync.
+     */
+    attach(productID, body, options) {
+        return this._client.post(path `/v1/pay/products/${productID}/entitlements`, { body, ...options });
+    }
+    /**
+     * Removes an entitlement from a product. Customers subscribed to this product will
+     * lose access to the feature. Existing subscriptions are affected immediately.
+     */
+    remove(featureID, params, options) {
+        const { product_id } = params;
+        return this._client.delete(path `/v1/pay/products/${product_id}/entitlements/${featureID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+}
+//# sourceMappingURL=entitlements.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entitlements.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/entitlements.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAwC;OACtD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,YAAa,SAAQ,WAAW;IAC3C;;;OAGG;IACH,IAAI,CACF,SAAiB,EACjB,QAAkD,EAAE,EACpD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAC5B,IAAI,CAAA,oBAAoB,SAAS,eAAe,EAChD,CAAA,YAAgC,CAAA,EAChC,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CACtB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,SAAiB,EACjB,IAA6B,EAC7B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,oBAAoB,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAiB,EAAE,MAA+B,EAAE,OAAwB;QACjF,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,UAAU,iBAAiB,SAAS,EAAE,EAAE;YACzF,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+export { Entitlements, type ProductEntitlement, type EntitlementListParams, type EntitlementAttachParams, type EntitlementRemoveParams, type ProductEntitlementsCursorIDPage, } from "./entitlements.mjs";
+export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products.mjs";
+export { Variants, type Variant, type VariantCreateParams, type VariantUpdateParams, type VariantListParams, type VariantArchiveParams, type VariantGetParams, type VariantsCursorIDPage, } from "./variants.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/index.ts"],"names":[],"mappings":"OAEO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,GACrC;OACM,EACL,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B;OACM,EACL,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B"}

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

@@ -0,0 +1,4 @@
+export { Entitlements, type ProductEntitlement, type EntitlementListParams, type EntitlementAttachParams, type EntitlementRemoveParams, type ProductEntitlementsCursorIDPage, } from "./entitlements.js";
+export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products.js";
+export { Variants, type Variant, type VariantCreateParams, type VariantUpdateParams, type VariantListParams, type VariantArchiveParams, type VariantGetParams, type VariantsCursorIDPage, } from "./variants.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/index.ts"],"names":[],"mappings":"OAEO,EACL,YAAY,EACZ,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,+BAA+B,GACrC;OACM,EACL,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B;OACM,EACL,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,GAC1B"}

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

@@ -0,0 +1,11 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Variants = exports.Products = exports.Entitlements = void 0;
+var entitlements_1 = require("./entitlements.js");
+Object.defineProperty(exports, "Entitlements", { enumerable: true, get: function () { return entitlements_1.Entitlements; } });
+var products_1 = require("./products.js");
+Object.defineProperty(exports, "Products", { enumerable: true, get: function () { return products_1.Products; } });
+var variants_1 = require("./variants.js");
+Object.defineProperty(exports, "Variants", { enumerable: true, get: function () { return variants_1.Variants; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAOwB;AANtB,4GAAA,YAAY,OAAA;AAOd,0CAOoB;AANlB,oGAAA,QAAQ,OAAA;AAOV,0CASoB;AARlB,oGAAA,QAAQ,OAAA"}

package/resources/beta/{subscriptions/plans → pay/products}/index.mjs

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { Entitlements, } from "./entitlements.mjs";
-export { Plans, } from "./plans.mjs";
+export { Products, } from "./products.mjs";
+export { Variants, } from "./variants.mjs";
 //# sourceMappingURL=index.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,YAAY,GAMb;OACM,EACL,QAAQ,GAMT;OACM,EACL,QAAQ,GAQT"}

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

@@ -0,0 +1,183 @@
+import { APIResource } from "../../../../core/resource.mjs";
+import * as EntitlementsAPI from "./entitlements.mjs";
+import { EntitlementAttachParams, EntitlementListParams, EntitlementRemoveParams, Entitlements, ProductEntitlement, ProductEntitlementsCursorIDPage } from "./entitlements.mjs";
+import * as VariantsAPI from "./variants.mjs";
+import { Variant, VariantArchiveParams, VariantCreateParams, VariantGetParams, VariantListParams, VariantUpdateParams, Variants, VariantsCursorIDPage } from "./variants.mjs";
+import { APIPromise } from "../../../../core/api-promise.mjs";
+import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.mjs";
+import { RequestOptions } from "../../../../internal/request-options.mjs";
+export declare class Products extends APIResource {
+    entitlements: EntitlementsAPI.Entitlements;
+    variants: VariantsAPI.Variants;
+    /**
+     * Creates a new subscription product with a recurring price. Common examples
+     * include Free, Pro, Business, or Teams tiers. After creating a product, attach
+     * entitlements to define which features customers on this product can access.
+     */
+    create(body: ProductCreateParams, options?: RequestOptions): APIPromise<Product>;
+    /**
+     * Updates an existing product. Use this to modify the product name, description,
+     * or active status. Pricing cannot be changed after creation—create a new product
+     * instead.
+     */
+    update(productID: string, body?: ProductUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Product>;
+    /**
+     * Retrieves a paginated list of subscription products. Products define the pricing
+     * and billing intervals for subscriptions. Each product can have entitlements
+     * attached that grant features to subscribed customers.
+     */
+    list(query?: ProductListParams | null | undefined, options?: RequestOptions): PagePromise<ProductsCursorIDPage, Product>;
+    /**
+     * Archives a product, preventing new subscriptions. Existing subscriptions remain
+     * active. Use this instead of deletion to preserve subscription history.
+     */
+    archive(productID: string, options?: RequestOptions): APIPromise<Product>;
+    /**
+     * Retrieves a product by ID. Returns the product object including pricing details
+     * and status.
+     */
+    get(productID: string, options?: RequestOptions): APIPromise<Product>;
+}
+export type ProductsCursorIDPage = CursorIDPage<Product>;
+/**
+ * A product that customers can purchase. Products can be one-time purchases or
+ * recurring subscriptions. Attach entitlements to a product to grant features to
+ * customers.
+ */
+export interface Product {
+    /**
+     * Unique identifier for the price
+     */
+    id: string;
+    /**
+     * Whether the product is available for new purchases
+     */
+    active: boolean;
+    /**
+     * Timestamp when the product was created
+     */
+    created: string;
+    /**
+     * Display name for the product (e.g., Pro, Business, Teams)
+     */
+    name: string;
+    /**
+     * Price configuration for a product. Can be one-time or recurring (subscription).
+     */
+    default_price?: Product.DefaultPrice | null;
+    /**
+     * Detailed description of what the product includes
+     */
+    description?: string | null;
+}
+export declare namespace Product {
+    /**
+     * Price configuration for a product. Can be one-time or recurring (subscription).
+     */
+    interface DefaultPrice {
+        /**
+         * Unique identifier for the price
+         */
+        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 ProductCreateParams {
+    /**
+     * Display name for the product (e.g., Pro, Business, Teams)
+     */
+    name: string;
+    /**
+     * Price amount in the smallest currency unit (e.g., cents). Use 0 for free
+     * products.
+     */
+    unit_amount: number;
+    /**
+     * Optional custom ID for the product. If not provided, one will be generated.
+     */
+    id?: string;
+    /**
+     * Three-letter ISO currency code
+     */
+    currency?: string;
+    /**
+     * Detailed description of what the product 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;
+    /**
+     * Price type: one_time for single purchases, recurring for subscriptions
+     */
+    type?: 'one_time' | 'recurring';
+}
+export interface ProductUpdateParams {
+    /**
+     * Whether the product is available for new subscriptions
+     */
+    active?: boolean;
+    /**
+     * Detailed description of what the product includes
+     */
+    description?: string;
+    /**
+     * Display name for the product
+     */
+    name?: string;
+}
+export interface ProductListParams extends CursorIDPageParams {
+    /**
+     * Filter by active status
+     */
+    active?: 'true' | 'false';
+}
+export declare namespace Products {
+    export { type Product as Product, type ProductsCursorIDPage as ProductsCursorIDPage, type ProductCreateParams as ProductCreateParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, };
+    export { Entitlements as Entitlements, type ProductEntitlement as ProductEntitlement, type ProductEntitlementsCursorIDPage as ProductEntitlementsCursorIDPage, type EntitlementListParams as EntitlementListParams, type EntitlementAttachParams as EntitlementAttachParams, type EntitlementRemoveParams as EntitlementRemoveParams, };
+    export { Variants as Variants, 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=products.d.mts.map

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

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