@usehercules/sdk 1.3.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/LICENSE +1 -1
- package/package.json +1 -1
- package/resources/beta/pay/coupons.d.mts +1 -1
- package/resources/beta/pay/coupons.d.ts +1 -1
- package/resources/beta/pay/customers.d.mts +1 -1
- package/resources/beta/pay/customers.d.ts +1 -1
- package/resources/beta/pay/entitlements.d.mts +4 -22
- package/resources/beta/pay/entitlements.d.mts.map +1 -1
- package/resources/beta/pay/entitlements.d.ts +4 -22
- package/resources/beta/pay/entitlements.d.ts.map +1 -1
- package/resources/beta/pay/entitlements.js +3 -4
- package/resources/beta/pay/entitlements.js.map +1 -1
- package/resources/beta/pay/entitlements.mjs +3 -4
- package/resources/beta/pay/entitlements.mjs.map +1 -1
- package/resources/beta/pay/pay.d.mts +76 -16
- package/resources/beta/pay/pay.d.mts.map +1 -1
- package/resources/beta/pay/pay.d.ts +76 -16
- package/resources/beta/pay/pay.d.ts.map +1 -1
- package/resources/beta/pay/pay.js.map +1 -1
- package/resources/beta/pay/pay.mjs.map +1 -1
- package/resources/beta/pay/products/entitlements.d.mts +1 -1
- package/resources/beta/pay/products/entitlements.d.ts +1 -1
- package/resources/beta/pay/products/index.d.mts +1 -0
- package/resources/beta/pay/products/index.d.mts.map +1 -1
- package/resources/beta/pay/products/index.d.ts +1 -0
- package/resources/beta/pay/products/index.d.ts.map +1 -1
- package/resources/beta/pay/products/index.js +3 -1
- package/resources/beta/pay/products/index.js.map +1 -1
- package/resources/beta/pay/products/index.mjs +1 -0
- package/resources/beta/pay/products/index.mjs.map +1 -1
- package/resources/beta/pay/products/products.d.mts +45 -14
- package/resources/beta/pay/products/products.d.mts.map +1 -1
- package/resources/beta/pay/products/products.d.ts +45 -14
- package/resources/beta/pay/products/products.d.ts.map +1 -1
- package/resources/beta/pay/products/products.js +4 -0
- package/resources/beta/pay/products/products.js.map +1 -1
- package/resources/beta/pay/products/products.mjs +4 -0
- package/resources/beta/pay/products/products.mjs.map +1 -1
- package/resources/beta/pay/products/variants.d.mts +206 -0
- package/resources/beta/pay/products/variants.d.mts.map +1 -0
- package/resources/beta/pay/products/variants.d.ts +206 -0
- package/resources/beta/pay/products/variants.d.ts.map +1 -0
- package/resources/beta/pay/products/variants.js +56 -0
- package/resources/beta/pay/products/variants.js.map +1 -0
- package/resources/beta/pay/products/variants.mjs +52 -0
- package/resources/beta/pay/products/variants.mjs.map +1 -0
- package/src/resources/beta/pay/coupons.ts +1 -1
- package/src/resources/beta/pay/customers.ts +1 -1
- package/src/resources/beta/pay/entitlements.ts +4 -26
- package/src/resources/beta/pay/pay.ts +87 -17
- package/src/resources/beta/pay/products/entitlements.ts +1 -1
- package/src/resources/beta/pay/products/index.ts +10 -0
- package/src/resources/beta/pay/products/products.ts +70 -14
- package/src/resources/beta/pay/products/variants.ts +279 -0
- package/src/version.ts +1 -1
- package/version.d.mts +1 -1
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.mjs +1 -1
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export { Entitlements, type ProductEntitlement, type EntitlementListParams, type EntitlementAttachParams, type EntitlementRemoveParams, type ProductEntitlementsCursorIDPage, } from "./entitlements.mjs";
|
|
2
2
|
export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products.mjs";
|
|
3
|
+
export { Variants, type Variant, type VariantCreateParams, type VariantUpdateParams, type VariantListParams, type VariantArchiveParams, type VariantGetParams, type VariantsCursorIDPage, } from "./variants.mjs";
|
|
3
4
|
//# sourceMappingURL=index.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
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"}
|
|
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"}
|
|
@@ -1,3 +1,4 @@
|
|
|
1
1
|
export { Entitlements, type ProductEntitlement, type EntitlementListParams, type EntitlementAttachParams, type EntitlementRemoveParams, type ProductEntitlementsCursorIDPage, } from "./entitlements.js";
|
|
2
2
|
export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products.js";
|
|
3
|
+
export { Variants, type Variant, type VariantCreateParams, type VariantUpdateParams, type VariantListParams, type VariantArchiveParams, type VariantGetParams, type VariantsCursorIDPage, } from "./variants.js";
|
|
3
4
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
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"}
|
|
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"}
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
|
|
3
3
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
4
|
-
exports.Products = exports.Entitlements = void 0;
|
|
4
|
+
exports.Variants = exports.Products = exports.Entitlements = void 0;
|
|
5
5
|
var entitlements_1 = require("./entitlements.js");
|
|
6
6
|
Object.defineProperty(exports, "Entitlements", { enumerable: true, get: function () { return entitlements_1.Entitlements; } });
|
|
7
7
|
var products_1 = require("./products.js");
|
|
8
8
|
Object.defineProperty(exports, "Products", { enumerable: true, get: function () { return products_1.Products; } });
|
|
9
|
+
var variants_1 = require("./variants.js");
|
|
10
|
+
Object.defineProperty(exports, "Variants", { enumerable: true, get: function () { return variants_1.Variants; } });
|
|
9
11
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
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"}
|
|
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"}
|
|
@@ -1 +1 @@
|
|
|
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"}
|
|
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"}
|
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
import { APIResource } from "../../../../core/resource.mjs";
|
|
2
2
|
import * as EntitlementsAPI from "./entitlements.mjs";
|
|
3
3
|
import { EntitlementAttachParams, EntitlementListParams, EntitlementRemoveParams, Entitlements, ProductEntitlement, ProductEntitlementsCursorIDPage } from "./entitlements.mjs";
|
|
4
|
+
import * as VariantsAPI from "./variants.mjs";
|
|
5
|
+
import { Variant, VariantArchiveParams, VariantCreateParams, VariantGetParams, VariantListParams, VariantUpdateParams, Variants, VariantsCursorIDPage } from "./variants.mjs";
|
|
4
6
|
import { APIPromise } from "../../../../core/api-promise.mjs";
|
|
5
7
|
import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.mjs";
|
|
6
8
|
import { RequestOptions } from "../../../../internal/request-options.mjs";
|
|
7
9
|
export declare class Products extends APIResource {
|
|
8
10
|
entitlements: EntitlementsAPI.Entitlements;
|
|
11
|
+
variants: VariantsAPI.Variants;
|
|
9
12
|
/**
|
|
10
13
|
* Creates a new subscription product with a recurring price. Common examples
|
|
11
14
|
* include Free, Pro, Business, or Teams tiers. After creating a product, attach
|
|
@@ -37,17 +40,17 @@ export declare class Products extends APIResource {
|
|
|
37
40
|
}
|
|
38
41
|
export type ProductsCursorIDPage = CursorIDPage<Product>;
|
|
39
42
|
/**
|
|
40
|
-
* A
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
+
* A product that customers can purchase. Products can be one-time purchases or
|
|
44
|
+
* recurring subscriptions. Attach entitlements to a product to grant features to
|
|
45
|
+
* customers.
|
|
43
46
|
*/
|
|
44
47
|
export interface Product {
|
|
45
48
|
/**
|
|
46
|
-
* Unique identifier for the
|
|
49
|
+
* Unique identifier for the price
|
|
47
50
|
*/
|
|
48
51
|
id: string;
|
|
49
52
|
/**
|
|
50
|
-
* Whether the product is available for new
|
|
53
|
+
* Whether the product is available for new purchases
|
|
51
54
|
*/
|
|
52
55
|
active: boolean;
|
|
53
56
|
/**
|
|
@@ -59,7 +62,7 @@ export interface Product {
|
|
|
59
62
|
*/
|
|
60
63
|
name: string;
|
|
61
64
|
/**
|
|
62
|
-
*
|
|
65
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
63
66
|
*/
|
|
64
67
|
default_price?: Product.DefaultPrice | null;
|
|
65
68
|
/**
|
|
@@ -69,25 +72,46 @@ export interface Product {
|
|
|
69
72
|
}
|
|
70
73
|
export declare namespace Product {
|
|
71
74
|
/**
|
|
72
|
-
*
|
|
75
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
73
76
|
*/
|
|
74
77
|
interface DefaultPrice {
|
|
75
78
|
/**
|
|
76
|
-
* Unique identifier for the
|
|
79
|
+
* Unique identifier for the price
|
|
77
80
|
*/
|
|
78
81
|
id: string;
|
|
82
|
+
/**
|
|
83
|
+
* How to handle the billing cycle when switching plans. 'now' resets to current
|
|
84
|
+
* time, 'unchanged' keeps the original anchor. Null for one-time prices.
|
|
85
|
+
*/
|
|
86
|
+
billing_cycle_anchor: 'now' | 'unchanged' | null;
|
|
79
87
|
/**
|
|
80
88
|
* Three-letter ISO currency code (e.g., usd, eur)
|
|
81
89
|
*/
|
|
82
90
|
currency: string;
|
|
83
91
|
/**
|
|
84
|
-
* Billing frequency: day, week, month, or year
|
|
92
|
+
* Billing frequency for recurring prices: day, week, month, or year. Null for
|
|
93
|
+
* one-time prices.
|
|
85
94
|
*/
|
|
86
|
-
interval: 'day' | 'week' | 'month' | 'year';
|
|
95
|
+
interval: 'day' | 'week' | 'month' | 'year' | null;
|
|
87
96
|
/**
|
|
88
|
-
* Number of intervals between billings
|
|
97
|
+
* Number of intervals between billings for recurring prices. Null for one-time
|
|
98
|
+
* prices.
|
|
89
99
|
*/
|
|
90
|
-
interval_count: number;
|
|
100
|
+
interval_count: number | null;
|
|
101
|
+
/**
|
|
102
|
+
* How to handle prorations when switching plans. 'default' creates prorations,
|
|
103
|
+
* 'none' disables them. Null for one-time prices.
|
|
104
|
+
*/
|
|
105
|
+
proration_behavior: 'default' | 'none' | null;
|
|
106
|
+
/**
|
|
107
|
+
* When to calculate proration. 'now' uses current time, 'start_of_period' uses the
|
|
108
|
+
* billing period start. Null for one-time prices or to use Stripe's default.
|
|
109
|
+
*/
|
|
110
|
+
proration_date: 'now' | 'start_of_period' | null;
|
|
111
|
+
/**
|
|
112
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
113
|
+
*/
|
|
114
|
+
type: 'one_time' | 'recurring';
|
|
91
115
|
/**
|
|
92
116
|
* Price amount in the smallest currency unit (e.g., cents)
|
|
93
117
|
*/
|
|
@@ -117,13 +141,19 @@ export interface ProductCreateParams {
|
|
|
117
141
|
*/
|
|
118
142
|
description?: string;
|
|
119
143
|
/**
|
|
120
|
-
* Billing frequency: day, week, month, or year
|
|
144
|
+
* Billing frequency for recurring prices: day, week, month, or year. Required for
|
|
145
|
+
* recurring type, ignored for one_time.
|
|
121
146
|
*/
|
|
122
147
|
interval?: 'day' | 'week' | 'month' | 'year';
|
|
123
148
|
/**
|
|
124
|
-
* Number of intervals between billings
|
|
149
|
+
* Number of intervals between billings for recurring prices. Required for
|
|
150
|
+
* recurring type, ignored for one_time.
|
|
125
151
|
*/
|
|
126
152
|
interval_count?: number;
|
|
153
|
+
/**
|
|
154
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
155
|
+
*/
|
|
156
|
+
type?: 'one_time' | 'recurring';
|
|
127
157
|
}
|
|
128
158
|
export interface ProductUpdateParams {
|
|
129
159
|
/**
|
|
@@ -148,5 +178,6 @@ export interface ProductListParams extends CursorIDPageParams {
|
|
|
148
178
|
export declare namespace Products {
|
|
149
179
|
export { type Product as Product, type ProductsCursorIDPage as ProductsCursorIDPage, type ProductCreateParams as ProductCreateParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, };
|
|
150
180
|
export { Entitlements as Entitlements, type ProductEntitlement as ProductEntitlement, type ProductEntitlementsCursorIDPage as ProductEntitlementsCursorIDPage, type EntitlementListParams as EntitlementListParams, type EntitlementAttachParams as EntitlementAttachParams, type EntitlementRemoveParams as EntitlementRemoveParams, };
|
|
181
|
+
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, };
|
|
151
182
|
}
|
|
152
183
|
//# sourceMappingURL=products.d.mts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,+BAA+B,EAChC;OACM,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAkD;
|
|
1
|
+
{"version":3,"file":"products.d.mts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,+BAA+B,EAChC;OACM,KAAK,WAAW;OAChB,EACL,OAAO,EACP,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,QAAQ,EACR,oBAAoB,EACrB;OACM,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAkD;IAC5F,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;IAExE;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;OAIG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,mBAAmB,GAAG,IAAI,GAAG,SAAc,EACjD,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,OAAO,CAAC;IAItB;;;;OAIG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAI7C;;;OAGG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIzE;;;OAGG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAGtE;AAED,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAE5C;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAiB,OAAO,CAAC;IACvB;;OAEG;IACH,UAAiB,YAAY;QAC3B;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;;WAGG;QACH,oBAAoB,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,CAAC;QAEjD;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QAEjB;;;WAGG;QACH,QAAQ,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;QAEnD;;;WAGG;QACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAE9B;;;WAGG;QACH,kBAAkB,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;QAE9C;;;WAGG;QACH,cAAc,EAAE,KAAK,GAAG,iBAAiB,GAAG,IAAI,CAAC;QAEjD;;WAEG;QACH,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;QAE/B;;WAEG;QACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAE7C;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAKD,MAAM,CAAC,OAAO,WAAW,QAAQ,CAAC;IAChC,OAAO,EACL,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;IAEF,OAAO,EACL,YAAY,IAAI,YAAY,EAC5B,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;IAEF,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,gBAAgB,IAAI,gBAAgB,GAC1C,CAAC;CACH"}
|
|
@@ -1,11 +1,14 @@
|
|
|
1
1
|
import { APIResource } from "../../../../core/resource.js";
|
|
2
2
|
import * as EntitlementsAPI from "./entitlements.js";
|
|
3
3
|
import { EntitlementAttachParams, EntitlementListParams, EntitlementRemoveParams, Entitlements, ProductEntitlement, ProductEntitlementsCursorIDPage } from "./entitlements.js";
|
|
4
|
+
import * as VariantsAPI from "./variants.js";
|
|
5
|
+
import { Variant, VariantArchiveParams, VariantCreateParams, VariantGetParams, VariantListParams, VariantUpdateParams, Variants, VariantsCursorIDPage } from "./variants.js";
|
|
4
6
|
import { APIPromise } from "../../../../core/api-promise.js";
|
|
5
7
|
import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.js";
|
|
6
8
|
import { RequestOptions } from "../../../../internal/request-options.js";
|
|
7
9
|
export declare class Products extends APIResource {
|
|
8
10
|
entitlements: EntitlementsAPI.Entitlements;
|
|
11
|
+
variants: VariantsAPI.Variants;
|
|
9
12
|
/**
|
|
10
13
|
* Creates a new subscription product with a recurring price. Common examples
|
|
11
14
|
* include Free, Pro, Business, or Teams tiers. After creating a product, attach
|
|
@@ -37,17 +40,17 @@ export declare class Products extends APIResource {
|
|
|
37
40
|
}
|
|
38
41
|
export type ProductsCursorIDPage = CursorIDPage<Product>;
|
|
39
42
|
/**
|
|
40
|
-
* A
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
+
* A product that customers can purchase. Products can be one-time purchases or
|
|
44
|
+
* recurring subscriptions. Attach entitlements to a product to grant features to
|
|
45
|
+
* customers.
|
|
43
46
|
*/
|
|
44
47
|
export interface Product {
|
|
45
48
|
/**
|
|
46
|
-
* Unique identifier for the
|
|
49
|
+
* Unique identifier for the price
|
|
47
50
|
*/
|
|
48
51
|
id: string;
|
|
49
52
|
/**
|
|
50
|
-
* Whether the product is available for new
|
|
53
|
+
* Whether the product is available for new purchases
|
|
51
54
|
*/
|
|
52
55
|
active: boolean;
|
|
53
56
|
/**
|
|
@@ -59,7 +62,7 @@ export interface Product {
|
|
|
59
62
|
*/
|
|
60
63
|
name: string;
|
|
61
64
|
/**
|
|
62
|
-
*
|
|
65
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
63
66
|
*/
|
|
64
67
|
default_price?: Product.DefaultPrice | null;
|
|
65
68
|
/**
|
|
@@ -69,25 +72,46 @@ export interface Product {
|
|
|
69
72
|
}
|
|
70
73
|
export declare namespace Product {
|
|
71
74
|
/**
|
|
72
|
-
*
|
|
75
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
73
76
|
*/
|
|
74
77
|
interface DefaultPrice {
|
|
75
78
|
/**
|
|
76
|
-
* Unique identifier for the
|
|
79
|
+
* Unique identifier for the price
|
|
77
80
|
*/
|
|
78
81
|
id: string;
|
|
82
|
+
/**
|
|
83
|
+
* How to handle the billing cycle when switching plans. 'now' resets to current
|
|
84
|
+
* time, 'unchanged' keeps the original anchor. Null for one-time prices.
|
|
85
|
+
*/
|
|
86
|
+
billing_cycle_anchor: 'now' | 'unchanged' | null;
|
|
79
87
|
/**
|
|
80
88
|
* Three-letter ISO currency code (e.g., usd, eur)
|
|
81
89
|
*/
|
|
82
90
|
currency: string;
|
|
83
91
|
/**
|
|
84
|
-
* Billing frequency: day, week, month, or year
|
|
92
|
+
* Billing frequency for recurring prices: day, week, month, or year. Null for
|
|
93
|
+
* one-time prices.
|
|
85
94
|
*/
|
|
86
|
-
interval: 'day' | 'week' | 'month' | 'year';
|
|
95
|
+
interval: 'day' | 'week' | 'month' | 'year' | null;
|
|
87
96
|
/**
|
|
88
|
-
* Number of intervals between billings
|
|
97
|
+
* Number of intervals between billings for recurring prices. Null for one-time
|
|
98
|
+
* prices.
|
|
89
99
|
*/
|
|
90
|
-
interval_count: number;
|
|
100
|
+
interval_count: number | null;
|
|
101
|
+
/**
|
|
102
|
+
* How to handle prorations when switching plans. 'default' creates prorations,
|
|
103
|
+
* 'none' disables them. Null for one-time prices.
|
|
104
|
+
*/
|
|
105
|
+
proration_behavior: 'default' | 'none' | null;
|
|
106
|
+
/**
|
|
107
|
+
* When to calculate proration. 'now' uses current time, 'start_of_period' uses the
|
|
108
|
+
* billing period start. Null for one-time prices or to use Stripe's default.
|
|
109
|
+
*/
|
|
110
|
+
proration_date: 'now' | 'start_of_period' | null;
|
|
111
|
+
/**
|
|
112
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
113
|
+
*/
|
|
114
|
+
type: 'one_time' | 'recurring';
|
|
91
115
|
/**
|
|
92
116
|
* Price amount in the smallest currency unit (e.g., cents)
|
|
93
117
|
*/
|
|
@@ -117,13 +141,19 @@ export interface ProductCreateParams {
|
|
|
117
141
|
*/
|
|
118
142
|
description?: string;
|
|
119
143
|
/**
|
|
120
|
-
* Billing frequency: day, week, month, or year
|
|
144
|
+
* Billing frequency for recurring prices: day, week, month, or year. Required for
|
|
145
|
+
* recurring type, ignored for one_time.
|
|
121
146
|
*/
|
|
122
147
|
interval?: 'day' | 'week' | 'month' | 'year';
|
|
123
148
|
/**
|
|
124
|
-
* Number of intervals between billings
|
|
149
|
+
* Number of intervals between billings for recurring prices. Required for
|
|
150
|
+
* recurring type, ignored for one_time.
|
|
125
151
|
*/
|
|
126
152
|
interval_count?: number;
|
|
153
|
+
/**
|
|
154
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
155
|
+
*/
|
|
156
|
+
type?: 'one_time' | 'recurring';
|
|
127
157
|
}
|
|
128
158
|
export interface ProductUpdateParams {
|
|
129
159
|
/**
|
|
@@ -148,5 +178,6 @@ export interface ProductListParams extends CursorIDPageParams {
|
|
|
148
178
|
export declare namespace Products {
|
|
149
179
|
export { type Product as Product, type ProductsCursorIDPage as ProductsCursorIDPage, type ProductCreateParams as ProductCreateParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, };
|
|
150
180
|
export { Entitlements as Entitlements, type ProductEntitlement as ProductEntitlement, type ProductEntitlementsCursorIDPage as ProductEntitlementsCursorIDPage, type EntitlementListParams as EntitlementListParams, type EntitlementAttachParams as EntitlementAttachParams, type EntitlementRemoveParams as EntitlementRemoveParams, };
|
|
181
|
+
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, };
|
|
151
182
|
}
|
|
152
183
|
//# sourceMappingURL=products.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EACL,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,+BAA+B,EAChC;OACM,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC,YAAY,EAAE,eAAe,CAAC,YAAY,CAAkD;
|
|
1
|
+
{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"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"}
|
|
@@ -6,12 +6,15 @@ const tslib_1 = require("../../../../internal/tslib.js");
|
|
|
6
6
|
const resource_1 = require("../../../../core/resource.js");
|
|
7
7
|
const EntitlementsAPI = tslib_1.__importStar(require("./entitlements.js"));
|
|
8
8
|
const entitlements_1 = require("./entitlements.js");
|
|
9
|
+
const VariantsAPI = tslib_1.__importStar(require("./variants.js"));
|
|
10
|
+
const variants_1 = require("./variants.js");
|
|
9
11
|
const pagination_1 = require("../../../../core/pagination.js");
|
|
10
12
|
const path_1 = require("../../../../internal/utils/path.js");
|
|
11
13
|
class Products extends resource_1.APIResource {
|
|
12
14
|
constructor() {
|
|
13
15
|
super(...arguments);
|
|
14
16
|
this.entitlements = new EntitlementsAPI.Entitlements(this._client);
|
|
17
|
+
this.variants = new VariantsAPI.Variants(this._client);
|
|
15
18
|
}
|
|
16
19
|
/**
|
|
17
20
|
* Creates a new subscription product with a recurring price. Common examples
|
|
@@ -54,4 +57,5 @@ class Products extends resource_1.APIResource {
|
|
|
54
57
|
}
|
|
55
58
|
exports.Products = Products;
|
|
56
59
|
Products.Entitlements = entitlements_1.Entitlements;
|
|
60
|
+
Products.Variants = variants_1.Variants;
|
|
57
61
|
//# sourceMappingURL=products.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,2DAAwD;AACxD,2EAAkD;AAClD,oDAOwB;
|
|
1
|
+
{"version":3,"file":"products.js","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,2DAAwD;AACxD,2EAAkD;AAClD,oDAOwB;AACxB,mEAA0C;AAC1C,4CASoB;AAEpB,+DAAiG;AAEjG,6DAAuD;AAEvD,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAmD1E,CAAC;IAjDC;;;;OAIG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,yBAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,oBAAoB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;CACF;AArDD,4BAqDC;AAuKD,QAAQ,CAAC,YAAY,GAAG,2BAAY,CAAC;AACrC,QAAQ,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}
|
|
@@ -2,12 +2,15 @@
|
|
|
2
2
|
import { APIResource } from "../../../../core/resource.mjs";
|
|
3
3
|
import * as EntitlementsAPI from "./entitlements.mjs";
|
|
4
4
|
import { Entitlements, } from "./entitlements.mjs";
|
|
5
|
+
import * as VariantsAPI from "./variants.mjs";
|
|
6
|
+
import { Variants, } from "./variants.mjs";
|
|
5
7
|
import { CursorIDPage } from "../../../../core/pagination.mjs";
|
|
6
8
|
import { path } from "../../../../internal/utils/path.mjs";
|
|
7
9
|
export class Products extends APIResource {
|
|
8
10
|
constructor() {
|
|
9
11
|
super(...arguments);
|
|
10
12
|
this.entitlements = new EntitlementsAPI.Entitlements(this._client);
|
|
13
|
+
this.variants = new VariantsAPI.Variants(this._client);
|
|
11
14
|
}
|
|
12
15
|
/**
|
|
13
16
|
* Creates a new subscription product with a recurring price. Common examples
|
|
@@ -49,4 +52,5 @@ export class Products extends APIResource {
|
|
|
49
52
|
}
|
|
50
53
|
}
|
|
51
54
|
Products.Entitlements = Entitlements;
|
|
55
|
+
Products.Variants = Variants;
|
|
52
56
|
//# sourceMappingURL=products.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAIL,YAAY,GAGb;OAEM,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"products.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/pay/products/products.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,eAAe;OACpB,EAIL,YAAY,GAGb;OACM,KAAK,WAAW;OAChB,EAOL,QAAQ,GAET;OAEM,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,iBAAY,GAAiC,IAAI,eAAe,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5F,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAmD1E,CAAC;IAjDC;;;;OAIG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;OAIG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,oBAAoB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED;;;;OAIG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,kBAAkB,EAAE,CAAA,YAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,oBAAoB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,oBAAoB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;CACF;AAuKD,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;AACrC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC"}
|
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
import { APIResource } from "../../../../core/resource.mjs";
|
|
2
|
+
import { APIPromise } from "../../../../core/api-promise.mjs";
|
|
3
|
+
import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../../core/pagination.mjs";
|
|
4
|
+
import { RequestOptions } from "../../../../internal/request-options.mjs";
|
|
5
|
+
export declare class Variants extends APIResource {
|
|
6
|
+
/**
|
|
7
|
+
* Creates a new variant with pricing for a product. Use variants to offer multiple
|
|
8
|
+
* pricing tiers or configurations (e.g., Basic at $10/month, Pro at $25/month). A
|
|
9
|
+
* Stripe Price is automatically created.
|
|
10
|
+
*/
|
|
11
|
+
create(productID: string, body: VariantCreateParams, options?: RequestOptions): APIPromise<Variant>;
|
|
12
|
+
/**
|
|
13
|
+
* Updates an existing variant. Use this to modify the name, description, or active
|
|
14
|
+
* status. Pricing cannot be changed after creation—create a new variant instead.
|
|
15
|
+
*/
|
|
16
|
+
update(variantID: string, params: VariantUpdateParams, options?: RequestOptions): APIPromise<Variant>;
|
|
17
|
+
/**
|
|
18
|
+
* Retrieves all variants for a product. Variants represent different pricing tiers
|
|
19
|
+
* or configurations (e.g., Basic, Pro, Enterprise) within a single product.
|
|
20
|
+
*/
|
|
21
|
+
list(productID: string, query?: VariantListParams | null | undefined, options?: RequestOptions): PagePromise<VariantsCursorIDPage, Variant>;
|
|
22
|
+
/**
|
|
23
|
+
* Archives a variant, preventing new subscriptions. The associated Stripe Price is
|
|
24
|
+
* also archived. Existing subscriptions remain active.
|
|
25
|
+
*/
|
|
26
|
+
archive(variantID: string, params: VariantArchiveParams, options?: RequestOptions): APIPromise<Variant>;
|
|
27
|
+
/**
|
|
28
|
+
* Retrieves a variant by ID. Returns the variant object including pricing details
|
|
29
|
+
* and status.
|
|
30
|
+
*/
|
|
31
|
+
get(variantID: string, params: VariantGetParams, options?: RequestOptions): APIPromise<Variant>;
|
|
32
|
+
}
|
|
33
|
+
export type VariantsCursorIDPage = CursorIDPage<Variant>;
|
|
34
|
+
/**
|
|
35
|
+
* A product variant representing a specific tier or configuration. Each variant
|
|
36
|
+
* has its own pricing. Variants allow a single product to have multiple pricing
|
|
37
|
+
* options (e.g., Basic, Pro, Enterprise tiers).
|
|
38
|
+
*/
|
|
39
|
+
export interface Variant {
|
|
40
|
+
/**
|
|
41
|
+
* Unique identifier for the price
|
|
42
|
+
*/
|
|
43
|
+
id: string;
|
|
44
|
+
/**
|
|
45
|
+
* Whether the variant is available for new purchases
|
|
46
|
+
*/
|
|
47
|
+
active: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* Timestamp when the variant was created
|
|
50
|
+
*/
|
|
51
|
+
created: string;
|
|
52
|
+
/**
|
|
53
|
+
* Display name for the variant (e.g., Basic, Standard, Premium)
|
|
54
|
+
*/
|
|
55
|
+
name: string;
|
|
56
|
+
/**
|
|
57
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
58
|
+
*/
|
|
59
|
+
default_price?: Variant.DefaultPrice | null;
|
|
60
|
+
/**
|
|
61
|
+
* Detailed description of what this variant includes
|
|
62
|
+
*/
|
|
63
|
+
description?: string | null;
|
|
64
|
+
}
|
|
65
|
+
export declare namespace Variant {
|
|
66
|
+
/**
|
|
67
|
+
* Price configuration for a product. Can be one-time or recurring (subscription).
|
|
68
|
+
*/
|
|
69
|
+
interface DefaultPrice {
|
|
70
|
+
/**
|
|
71
|
+
* Unique identifier for the price
|
|
72
|
+
*/
|
|
73
|
+
id: string;
|
|
74
|
+
/**
|
|
75
|
+
* How to handle the billing cycle when switching plans. 'now' resets to current
|
|
76
|
+
* time, 'unchanged' keeps the original anchor. Null for one-time prices.
|
|
77
|
+
*/
|
|
78
|
+
billing_cycle_anchor: 'now' | 'unchanged' | null;
|
|
79
|
+
/**
|
|
80
|
+
* Three-letter ISO currency code (e.g., usd, eur)
|
|
81
|
+
*/
|
|
82
|
+
currency: string;
|
|
83
|
+
/**
|
|
84
|
+
* Billing frequency for recurring prices: day, week, month, or year. Null for
|
|
85
|
+
* one-time prices.
|
|
86
|
+
*/
|
|
87
|
+
interval: 'day' | 'week' | 'month' | 'year' | null;
|
|
88
|
+
/**
|
|
89
|
+
* Number of intervals between billings for recurring prices. Null for one-time
|
|
90
|
+
* prices.
|
|
91
|
+
*/
|
|
92
|
+
interval_count: number | null;
|
|
93
|
+
/**
|
|
94
|
+
* How to handle prorations when switching plans. 'default' creates prorations,
|
|
95
|
+
* 'none' disables them. Null for one-time prices.
|
|
96
|
+
*/
|
|
97
|
+
proration_behavior: 'default' | 'none' | null;
|
|
98
|
+
/**
|
|
99
|
+
* When to calculate proration. 'now' uses current time, 'start_of_period' uses the
|
|
100
|
+
* billing period start. Null for one-time prices or to use Stripe's default.
|
|
101
|
+
*/
|
|
102
|
+
proration_date: 'now' | 'start_of_period' | null;
|
|
103
|
+
/**
|
|
104
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
105
|
+
*/
|
|
106
|
+
type: 'one_time' | 'recurring';
|
|
107
|
+
/**
|
|
108
|
+
* Price amount in the smallest currency unit (e.g., cents)
|
|
109
|
+
*/
|
|
110
|
+
unit_amount: number | null;
|
|
111
|
+
}
|
|
112
|
+
}
|
|
113
|
+
export interface VariantCreateParams {
|
|
114
|
+
/**
|
|
115
|
+
* Display name for the variant (e.g., Basic, Standard, Premium)
|
|
116
|
+
*/
|
|
117
|
+
name: string;
|
|
118
|
+
/**
|
|
119
|
+
* Price amount in the smallest currency unit (e.g., cents). Use 0 for free
|
|
120
|
+
* variants.
|
|
121
|
+
*/
|
|
122
|
+
unit_amount: number;
|
|
123
|
+
/**
|
|
124
|
+
* Optional custom ID for the variant. If not provided, one will be generated.
|
|
125
|
+
*/
|
|
126
|
+
id?: string;
|
|
127
|
+
/**
|
|
128
|
+
* Default billing cycle anchor behavior when switching to this price. 'now' resets
|
|
129
|
+
* to current time, 'unchanged' keeps original anchor. Only applies to recurring
|
|
130
|
+
* prices.
|
|
131
|
+
*/
|
|
132
|
+
billing_cycle_anchor?: 'now' | 'unchanged';
|
|
133
|
+
/**
|
|
134
|
+
* Three-letter ISO currency code
|
|
135
|
+
*/
|
|
136
|
+
currency?: string;
|
|
137
|
+
/**
|
|
138
|
+
* Detailed description of what this variant includes
|
|
139
|
+
*/
|
|
140
|
+
description?: string;
|
|
141
|
+
/**
|
|
142
|
+
* Billing frequency for recurring prices: day, week, month, or year. Required for
|
|
143
|
+
* recurring type, ignored for one_time.
|
|
144
|
+
*/
|
|
145
|
+
interval?: 'day' | 'week' | 'month' | 'year';
|
|
146
|
+
/**
|
|
147
|
+
* Number of intervals between billings for recurring prices. Required for
|
|
148
|
+
* recurring type, ignored for one_time.
|
|
149
|
+
*/
|
|
150
|
+
interval_count?: number;
|
|
151
|
+
/**
|
|
152
|
+
* Default proration behavior when switching to this price. 'default' creates
|
|
153
|
+
* prorations, 'none' disables them. Only applies to recurring prices.
|
|
154
|
+
*/
|
|
155
|
+
proration_behavior?: 'default' | 'none';
|
|
156
|
+
/**
|
|
157
|
+
* Default proration date calculation when switching to this price. 'now' uses
|
|
158
|
+
* current time, 'start_of_period' uses billing period start. Only applies to
|
|
159
|
+
* recurring prices.
|
|
160
|
+
*/
|
|
161
|
+
proration_date?: 'now' | 'start_of_period';
|
|
162
|
+
/**
|
|
163
|
+
* Price type: one_time for single purchases, recurring for subscriptions
|
|
164
|
+
*/
|
|
165
|
+
type?: 'one_time' | 'recurring';
|
|
166
|
+
}
|
|
167
|
+
export interface VariantUpdateParams {
|
|
168
|
+
/**
|
|
169
|
+
* Path param: The unique identifier of the product
|
|
170
|
+
*/
|
|
171
|
+
product_id: string;
|
|
172
|
+
/**
|
|
173
|
+
* Body param: Whether the variant is available for new purchases
|
|
174
|
+
*/
|
|
175
|
+
active?: boolean;
|
|
176
|
+
/**
|
|
177
|
+
* Body param: Detailed description of what this variant includes
|
|
178
|
+
*/
|
|
179
|
+
description?: string;
|
|
180
|
+
/**
|
|
181
|
+
* Body param: Display name for the variant
|
|
182
|
+
*/
|
|
183
|
+
name?: string;
|
|
184
|
+
}
|
|
185
|
+
export interface VariantListParams extends CursorIDPageParams {
|
|
186
|
+
/**
|
|
187
|
+
* Filter by active status
|
|
188
|
+
*/
|
|
189
|
+
active?: 'true' | 'false';
|
|
190
|
+
}
|
|
191
|
+
export interface VariantArchiveParams {
|
|
192
|
+
/**
|
|
193
|
+
* The unique identifier of the product
|
|
194
|
+
*/
|
|
195
|
+
product_id: string;
|
|
196
|
+
}
|
|
197
|
+
export interface VariantGetParams {
|
|
198
|
+
/**
|
|
199
|
+
* The unique identifier of the product
|
|
200
|
+
*/
|
|
201
|
+
product_id: string;
|
|
202
|
+
}
|
|
203
|
+
export declare namespace Variants {
|
|
204
|
+
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, };
|
|
205
|
+
}
|
|
206
|
+
//# sourceMappingURL=variants.d.mts.map
|