@usehercules/sdk 1.11.0 → 1.12.1

package/resources/{beta/commerce → commerce/customers}/customers.mjs

@@ -1,14 +1,24 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../../core/resource.mjs";
+import * as BalanceTransactionsAPI from "./balance-transactions.mjs";
+import { BalanceTransactions } from "./balance-transactions.mjs";
 import { CursorIDPage } from "../../../core/pagination.mjs";
-import { buildHeaders } from "../../../internal/headers.mjs";
 import { path } from "../../../internal/utils/path.mjs";
 export class Customers extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.balanceTransactions = new BalanceTransactionsAPI.BalanceTransactions(this._client);
+    }
     /**
      * Creates a new billable customer. A customer represents the entity in your app
      * that will be charged—typically a user, organization, or project. Hercules
      * recommends creating a customer immediately after creating the corresponding
      * entity in your app.
+     *
+     * @example
+     * ```ts
+     * const customer = await client.commerce.customers.create();
+     * ```
      */
     create(body = {}, options) {
         return this._client.post('/v1/commerce/customers', { body, ...options });
@@ -16,6 +26,13 @@ export class Customers extends APIResource {
     /**
      * Updates an existing customer. Use this to modify contact information or billing
      * address. Only provided fields are updated; omitted fields remain unchanged.
+     *
+     * @example
+     * ```ts
+     * const customer = await client.commerce.customers.update(
+     *   'cus_1234567890',
+     * );
+     * ```
      */
     update(customerID, body = {}, options) {
         return this._client.patch(path `/v1/commerce/customers/${customerID}`, { body, ...options });
@@ -23,24 +40,30 @@ export class Customers extends APIResource {
     /**
      * Retrieves a paginated list of all customers. Customers are the billable entities
      * in your app—typically users, organizations, or projects.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const customer of client.commerce.customers.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/v1/commerce/customers', (CursorIDPage), { query, ...options });
     }
-    /**
-     * Permanently deletes a customer. This also cancels any active subscriptions. This
-     * action cannot be undone.
-     */
-    delete(customerID, options) {
-        return this._client.delete(path `/v1/commerce/customers/${customerID}`, {
-            ...options,
-            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
     /**
      * Generates a URL to a hosted billing portal where the customer can view invoices,
      * update payment methods, and manage billing details. Redirect the customer to the
      * returned URL.
+     *
+     * @example
+     * ```ts
+     * const response =
+     *   await client.commerce.customers.billingPortal(
+     *     'cus_1234567890',
+     *   );
+     * ```
      */
     billingPortal(customerID, body = {}, options) {
         return this._client.post(path `/v1/commerce/customers/${customerID}/billing_portal`, { body, ...options });
@@ -49,9 +72,17 @@ export class Customers extends APIResource {
      * Retrieves a customer by ID. Returns the customer object including contact
      * information, billing address, active subscriptions, recent invoices, and saved
      * payment methods.
+     *
+     * @example
+     * ```ts
+     * const customer = await client.commerce.customers.get(
+     *   'cus_1234567890',
+     * );
+     * ```
      */
     get(customerID, options) {
         return this._client.get(path `/v1/commerce/customers/${customerID}`, options);
     }
 }
+Customers.BalanceTransactions = BalanceTransactions;
 //# sourceMappingURL=customers.mjs.map

package/resources/commerce/customers/customers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.mjs","sourceRoot":"","sources":["../../../src/resources/commerce/customers/customers.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,sBAAsB;OAC3B,EAAE,mBAAmB,EAAE;OAEvB,EAAE,YAAY,EAAwC;OAEtD,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,SAAU,SAAQ,WAAW;IAA1C;;QACE,wBAAmB,GACjB,IAAI,sBAAsB,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IA2FjE,CAAC;IAzFC;;;;;;;;;;OAUG;IACH,MAAM,CAAC,OAAgD,EAAE,EAAE,OAAwB;QACjF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CACJ,UAAkB,EAClB,OAAgD,EAAE,EAClD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,0BAA0B,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAA,YAAsB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1G,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,aAAa,CACX,UAAkB,EAClB,OAAuD,EAAE,EACzD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,0BAA0B,UAAU,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,UAAkB,EAAE,OAAwB;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,0BAA0B,UAAU,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;CACF;AAgfD,SAAS,CAAC,mBAAmB,GAAG,mBAAmB,CAAC"}

package/resources/commerce/customers/index.d.mts

@@ -0,0 +1,3 @@
+export { BalanceTransactions } from "./balance-transactions.mjs";
+export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers.mjs";
+//# sourceMappingURL=index.d.mts.map

package/resources/commerce/customers/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/commerce/customers/index.ts"],"names":[],"mappings":"OAEO,EAAE,mBAAmB,EAAE;OACvB,EACL,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B"}

package/resources/commerce/customers/index.d.ts

@@ -0,0 +1,3 @@
+export { BalanceTransactions } from "./balance-transactions.js";
+export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers.js";
+//# sourceMappingURL=index.d.ts.map

package/resources/commerce/customers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/commerce/customers/index.ts"],"names":[],"mappings":"OAEO,EAAE,mBAAmB,EAAE;OACvB,EACL,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B"}

package/resources/commerce/customers/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Customers = exports.BalanceTransactions = void 0;
+var balance_transactions_1 = require("./balance-transactions.js");
+Object.defineProperty(exports, "BalanceTransactions", { enumerable: true, get: function () { return balance_transactions_1.BalanceTransactions; } });
+var customers_1 = require("./customers.js");
+Object.defineProperty(exports, "Customers", { enumerable: true, get: function () { return customers_1.Customers; } });
+//# sourceMappingURL=index.js.map

package/resources/commerce/customers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/commerce/customers/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kEAA6D;AAApD,2HAAA,mBAAmB,OAAA;AAC5B,4CAWqB;AAVnB,sGAAA,SAAS,OAAA"}

package/resources/commerce/customers/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { BalanceTransactions } from "./balance-transactions.mjs";
+export { Customers, } from "./customers.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/commerce/customers/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/commerce/customers/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,mBAAmB,EAAE;OACvB,EACL,SAAS,GAUV"}

package/resources/commerce/customers.d.mts

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

package/resources/commerce/customers.d.mts.map

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

package/resources/commerce/customers.d.ts

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

package/resources/commerce/customers.d.ts.map

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

package/resources/{beta.js → commerce/customers.js}

@@ -1,6 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("../internal/tslib.js");
-tslib_1.__exportStar(require("./beta/index.js"), exports);
-//# sourceMappingURL=beta.js.map
+const tslib_1 = require("../../internal/tslib.js");
+tslib_1.__exportStar(require("./customers/index.js"), exports);
+//# sourceMappingURL=customers.js.map

package/resources/commerce/customers.js.map

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

package/resources/{beta.mjs → commerce/customers.mjs}

@@ -1,3 +1,3 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-export * from "./beta/index.mjs";
-//# sourceMappingURL=beta.mjs.map
+export * from "./customers/index.mjs";
+//# sourceMappingURL=customers.mjs.map

package/resources/commerce/customers.mjs.map

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

package/resources/{beta/commerce → commerce}/features.d.mts

@@ -1,30 +1,54 @@
-import { APIResource } from "../../../core/resource.mjs";
-import { APIPromise } from "../../../core/api-promise.mjs";
-import { CursorIDPage, type CursorIDPageParams, PagePromise } from "../../../core/pagination.mjs";
-import { RequestOptions } from "../../../internal/request-options.mjs";
+import { APIResource } from "../../core/resource.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 Features extends APIResource {
     /**
      * Creates a new feature with a lookup key. Features can be attached to multiple
      * products to grant customers access to the same entitlement across different
      * subscription tiers.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.create({
+     *   name: 'x',
+     * });
+     * ```
      */
     create(body: FeatureCreateParams, options?: RequestOptions): APIPromise<Feature>;
     /**
      * Updates an existing feature. Use this to modify metadata or active status.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.update(
+     *   'feature_id',
+     * );
+     * ```
      */
     update(featureID: string, body?: FeatureUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Feature>;
     /**
      * Retrieves a paginated list of features. Features are reusable entitlements that
      * can be attached to multiple products.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const feature of client.commerce.features.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query?: FeatureListParams | null | undefined, options?: RequestOptions): PagePromise<FeaturesCursorIDPage, Feature>;
-    /**
-     * Deletes a feature. This will also remove all product attachments for this
-     * feature.
-     */
-    delete(featureID: string, options?: RequestOptions): APIPromise<void>;
     /**
      * Retrieves a feature by ID.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.get(
+     *   'feature_id',
+     * );
+     * ```
      */
     get(featureID: string, options?: RequestOptions): APIPromise<Feature>;
 }
@@ -35,7 +59,7 @@ export type FeaturesCursorIDPage = CursorIDPage<Feature>;
  */
 export interface Feature {
     /**
-     * Unique identifier for the topic subscription
+     * Unique identifier for the feature
      */
     id: string;
     /**
@@ -50,10 +74,6 @@ export interface Feature {
      * Description of what this feature provides
      */
     description: string | null;
-    /**
-     * The lookup key used to check access (e.g., 'feature.pro_features')
-     */
-    lookup_key: string;
     /**
      * Human-readable name for the feature
      */
@@ -70,11 +90,6 @@ export interface Feature {
     };
 }
 export interface FeatureCreateParams {
-    /**
-     * The lookup key used to check access. Will be prefixed with 'feature.'
-     * automatically.
-     */
-    lookup_key: string;
     /**
      * Human-readable name for the feature
      */
@@ -119,7 +134,7 @@ export interface FeatureListParams extends CursorIDPageParams {
     /**
      * Filter by active status
      */
-    active?: 'true' | 'false';
+    active?: boolean;
 }
 export declare namespace Features {
     export { type Feature as Feature, type FeaturesCursorIDPage as FeaturesCursorIDPage, type FeatureCreateParams as FeatureCreateParams, type FeatureUpdateParams as FeatureUpdateParams, type FeatureListParams as FeatureListParams, };

package/resources/commerce/features.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.mts","sourceRoot":"","sources":["../../src/resources/commerce/features.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;;;;;;OASG;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;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAI7C;;;;;;;;;OASG;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;;;GAGG;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,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAEtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,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;CACH"}

package/resources/{beta/commerce → commerce}/features.d.ts

@@ -1,30 +1,54 @@
-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";
+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 Features extends APIResource {
     /**
      * Creates a new feature with a lookup key. Features can be attached to multiple
      * products to grant customers access to the same entitlement across different
      * subscription tiers.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.create({
+     *   name: 'x',
+     * });
+     * ```
      */
     create(body: FeatureCreateParams, options?: RequestOptions): APIPromise<Feature>;
     /**
      * Updates an existing feature. Use this to modify metadata or active status.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.update(
+     *   'feature_id',
+     * );
+     * ```
      */
     update(featureID: string, body?: FeatureUpdateParams | null | undefined, options?: RequestOptions): APIPromise<Feature>;
     /**
      * Retrieves a paginated list of features. Features are reusable entitlements that
      * can be attached to multiple products.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const feature of client.commerce.features.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query?: FeatureListParams | null | undefined, options?: RequestOptions): PagePromise<FeaturesCursorIDPage, Feature>;
-    /**
-     * Deletes a feature. This will also remove all product attachments for this
-     * feature.
-     */
-    delete(featureID: string, options?: RequestOptions): APIPromise<void>;
     /**
      * Retrieves a feature by ID.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.get(
+     *   'feature_id',
+     * );
+     * ```
      */
     get(featureID: string, options?: RequestOptions): APIPromise<Feature>;
 }
@@ -35,7 +59,7 @@ export type FeaturesCursorIDPage = CursorIDPage<Feature>;
  */
 export interface Feature {
     /**
-     * Unique identifier for the topic subscription
+     * Unique identifier for the feature
      */
     id: string;
     /**
@@ -50,10 +74,6 @@ export interface Feature {
      * Description of what this feature provides
      */
     description: string | null;
-    /**
-     * The lookup key used to check access (e.g., 'feature.pro_features')
-     */
-    lookup_key: string;
     /**
      * Human-readable name for the feature
      */
@@ -70,11 +90,6 @@ export interface Feature {
     };
 }
 export interface FeatureCreateParams {
-    /**
-     * The lookup key used to check access. Will be prefixed with 'feature.'
-     * automatically.
-     */
-    lookup_key: string;
     /**
      * Human-readable name for the feature
      */
@@ -119,7 +134,7 @@ export interface FeatureListParams extends CursorIDPageParams {
     /**
      * Filter by active status
      */
-    active?: 'true' | 'false';
+    active?: boolean;
 }
 export declare namespace Features {
     export { type Feature as Feature, type FeaturesCursorIDPage as FeaturesCursorIDPage, type FeatureCreateParams as FeatureCreateParams, type FeatureUpdateParams as FeatureUpdateParams, type FeatureListParams as FeatureListParams, };

package/resources/commerce/features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/resources/commerce/features.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,WAAW,EAAE;OACtD,EAAE,cAAc,EAAE;AAGzB,qBAAa,QAAS,SAAQ,WAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAIhF;;;;;;;;;OASG;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;;;;;;;;;;;OAWG;IACH,IAAI,CACF,KAAK,GAAE,iBAAiB,GAAG,IAAI,GAAG,SAAc,EAChD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAI7C;;;;;;;;;OASG;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;;;GAGG;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,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAEtC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC3D;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,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;CACH"}

package/resources/{beta/commerce → commerce}/features.js

@@ -2,21 +2,34 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Features = 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");
+const resource_1 = require("../../core/resource.js");
+const pagination_1 = require("../../core/pagination.js");
+const path_1 = require("../../internal/utils/path.js");
 class Features extends resource_1.APIResource {
     /**
      * Creates a new feature with a lookup key. Features can be attached to multiple
      * products to grant customers access to the same entitlement across different
      * subscription tiers.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.create({
+     *   name: 'x',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v1/commerce/features', { body, ...options });
     }
     /**
      * Updates an existing feature. Use this to modify metadata or active status.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.update(
+     *   'feature_id',
+     * );
+     * ```
      */
     update(featureID, body = {}, options) {
         return this._client.patch((0, path_1.path) `/v1/commerce/features/${featureID}`, { body, ...options });
@@ -24,22 +37,27 @@ class Features extends resource_1.APIResource {
     /**
      * Retrieves a paginated list of features. Features are reusable entitlements that
      * can be attached to multiple products.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const feature of client.commerce.features.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/v1/commerce/features', (pagination_1.CursorIDPage), { query, ...options });
     }
-    /**
-     * Deletes a feature. This will also remove all product attachments for this
-     * feature.
-     */
-    delete(featureID, options) {
-        return this._client.delete((0, path_1.path) `/v1/commerce/features/${featureID}`, {
-            ...options,
-            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
     /**
      * Retrieves a feature by ID.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.get(
+     *   'feature_id',
+     * );
+     * ```
      */
     get(featureID, options) {
         return this._client.get((0, path_1.path) `/v1/commerce/features/${featureID}`, options);

package/resources/commerce/features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.js","sourceRoot":"","sources":["../../src/resources/commerce/features.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,yDAA2F;AAE3F,uDAAiD;AAEjD,MAAa,QAAS,SAAQ,sBAAW;IACvC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAA,yBAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,yBAAyB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF;AAnED,4BAmEC"}

package/resources/{beta/commerce → commerce}/features.mjs

@@ -1,19 +1,32 @@
 // 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";
+import { APIResource } from "../../core/resource.mjs";
+import { CursorIDPage } from "../../core/pagination.mjs";
+import { path } from "../../internal/utils/path.mjs";
 export class Features extends APIResource {
     /**
      * Creates a new feature with a lookup key. Features can be attached to multiple
      * products to grant customers access to the same entitlement across different
      * subscription tiers.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.create({
+     *   name: 'x',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v1/commerce/features', { body, ...options });
     }
     /**
      * Updates an existing feature. Use this to modify metadata or active status.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.update(
+     *   'feature_id',
+     * );
+     * ```
      */
     update(featureID, body = {}, options) {
         return this._client.patch(path `/v1/commerce/features/${featureID}`, { body, ...options });
@@ -21,22 +34,27 @@ export class Features extends APIResource {
     /**
      * Retrieves a paginated list of features. Features are reusable entitlements that
      * can be attached to multiple products.
+     *
+     * @example
+     * ```ts
+     * // Automatically fetches more pages as needed.
+     * for await (const feature of client.commerce.features.list()) {
+     *   // ...
+     * }
+     * ```
      */
     list(query = {}, options) {
         return this._client.getAPIList('/v1/commerce/features', (CursorIDPage), { query, ...options });
     }
-    /**
-     * Deletes a feature. This will also remove all product attachments for this
-     * feature.
-     */
-    delete(featureID, options) {
-        return this._client.delete(path `/v1/commerce/features/${featureID}`, {
-            ...options,
-            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
-        });
-    }
     /**
      * Retrieves a feature by ID.
+     *
+     * @example
+     * ```ts
+     * const feature = await client.commerce.features.get(
+     *   'feature_id',
+     * );
+     * ```
      */
     get(featureID, options) {
         return this._client.get(path `/v1/commerce/features/${featureID}`, options);

package/resources/commerce/features.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"features.mjs","sourceRoot":"","sources":["../../src/resources/commerce/features.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;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,uBAAuB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,yBAAyB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,uBAAuB,EAAE,CAAA,YAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxG,CAAC;IAED;;;;;;;;;OASG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,yBAAyB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7E,CAAC;CACF"}

package/resources/{beta/commerce → commerce}/index.d.mts

@@ -1,6 +1,7 @@
 export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce.mjs";
 export { Coupons, type Coupon, type CouponCreateParams, type CouponUpdateParams, type CouponListParams, type CouponsCursorIDPage, } from "./coupons.mjs";
-export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers.mjs";
+export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers/index.mjs";
 export { Features, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type FeatureListParams, type FeaturesCursorIDPage, } from "./features.mjs";
 export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products/index.mjs";
+export { SubscriptionGroups } from "./subscription-groups.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/commerce/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/commerce/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EACL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB;OACM,EACL,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B;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,GAC1B;OACM,EAAE,kBAAkB,EAAE"}

package/resources/{beta/commerce → commerce}/index.d.ts

@@ -1,6 +1,7 @@
 export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce.js";
 export { Coupons, type Coupon, type CouponCreateParams, type CouponUpdateParams, type CouponListParams, type CouponsCursorIDPage, } from "./coupons.js";
-export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers.js";
+export { Customers, type Customer, type CustomerAddress, type CustomerBillingPortalResponse, type CustomerGetResponse, type CustomerCreateParams, type CustomerUpdateParams, type CustomerListParams, type CustomerBillingPortalParams, type CustomersCursorIDPage, } from "./customers/index.js";
 export { Features, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type FeatureListParams, type FeaturesCursorIDPage, } from "./features.js";
 export { Products, type Product, type ProductCreateParams, type ProductUpdateParams, type ProductListParams, type ProductsCursorIDPage, } from "./products/index.js";
+export { SubscriptionGroups } from "./subscription-groups.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/commerce/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/commerce/index.ts"],"names":[],"mappings":"OAEO,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EACL,OAAO,EACP,KAAK,MAAM,EACX,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,GACzB;OACM,EACL,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,6BAA6B,EAClC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,GAC3B;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,GAC1B;OACM,EAAE,kBAAkB,EAAE"}

package/resources/{beta/commerce → commerce}/index.js

@@ -1,15 +1,17 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Products = exports.Features = exports.Customers = exports.Coupons = exports.Commerce = void 0;
+exports.SubscriptionGroups = exports.Products = exports.Features = exports.Customers = exports.Coupons = exports.Commerce = void 0;
 var commerce_1 = require("./commerce.js");
 Object.defineProperty(exports, "Commerce", { enumerable: true, get: function () { return commerce_1.Commerce; } });
 var coupons_1 = require("./coupons.js");
 Object.defineProperty(exports, "Coupons", { enumerable: true, get: function () { return coupons_1.Coupons; } });
-var customers_1 = require("./customers.js");
-Object.defineProperty(exports, "Customers", { enumerable: true, get: function () { return customers_1.Customers; } });
+var index_1 = require("./customers/index.js");
+Object.defineProperty(exports, "Customers", { enumerable: true, get: function () { return index_1.Customers; } });
 var features_1 = require("./features.js");
 Object.defineProperty(exports, "Features", { enumerable: true, get: function () { return features_1.Features; } });
-var index_1 = require("./products/index.js");
-Object.defineProperty(exports, "Products", { enumerable: true, get: function () { return index_1.Products; } });
+var index_2 = require("./products/index.js");
+Object.defineProperty(exports, "Products", { enumerable: true, get: function () { return index_2.Products; } });
+var subscription_groups_1 = require("./subscription-groups.js");
+Object.defineProperty(exports, "SubscriptionGroups", { enumerable: true, get: function () { return subscription_groups_1.SubscriptionGroups; } });
 //# sourceMappingURL=index.js.map

package/resources/commerce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/commerce/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,0CAQoB;AAPlB,oGAAA,QAAQ,OAAA;AAQV,wCAOmB;AANjB,kGAAA,OAAO,OAAA;AAOT,8CAW2B;AAVzB,kGAAA,SAAS,OAAA;AAWX,0CAOoB;AANlB,oGAAA,QAAQ,OAAA;AAOV,6CAO0B;AANxB,iGAAA,QAAQ,OAAA;AAOV,gEAA2D;AAAlD,yHAAA,kBAAkB,OAAA"}

package/resources/{beta/commerce → commerce}/index.mjs

@@ -1,7 +1,8 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { Commerce, } from "./commerce.mjs";
 export { Coupons, } from "./coupons.mjs";
-export { Customers, } from "./customers.mjs";
+export { Customers, } from "./customers/index.mjs";
 export { Features, } from "./features.mjs";
 export { Products, } from "./products/index.mjs";
+export { SubscriptionGroups } from "./subscription-groups.mjs";
 //# sourceMappingURL=index.mjs.map