@usehercules/sdk 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 1.8.0 (2026-01-08)
+
+Full Changelog: [v1.7.0...v1.8.0](https://github.com/withzeusai/hercules-sdk-typescript/compare/v1.7.0...v1.8.0)
+
+### Features
+
+* **api:** update api ([fbd0fea](https://github.com/withzeusai/hercules-sdk-typescript/commit/fbd0fea496a3b231c1d64b62c798178c12b8c8f5))
+* **api:** update api ([9e6bd68](https://github.com/withzeusai/hercules-sdk-typescript/commit/9e6bd689985d61e22725adb62848775c53defaf1))
+
+
+### Bug Fixes
+
+* **internal:** don't try to push symbols to nuget as separate package ([3d0a989](https://github.com/withzeusai/hercules-sdk-typescript/commit/3d0a98978117f84d90b92b7d9c4ef7fb44583d47))
+
+
+### Chores
+
+* **internal:** codegen related update ([e7f55d0](https://github.com/withzeusai/hercules-sdk-typescript/commit/e7f55d043d75661be0cefafc3445f767b20622b6))
+* **internal:** codegen related update ([d6711e1](https://github.com/withzeusai/hercules-sdk-typescript/commit/d6711e1a9979e42e0d9ee9f9e99eb0ee56a1f7ce))
+* **internal:** codegen related update ([528f959](https://github.com/withzeusai/hercules-sdk-typescript/commit/528f959507a9dbf74fd1c23255d9bfd0442fe530))
+
 ## 1.7.0 (2026-01-08)
 
 Full Changelog: [v1.6.0...v1.7.0](https://github.com/withzeusai/hercules-sdk-typescript/compare/v1.6.0...v1.7.0)

package/README.md

@@ -42,7 +42,7 @@ const client = new Hercules({
   apiKey: process.env['HERCULES_API_KEY'], // This is the default and can be omitted
 });
 
-const customer = await client.beta.pay.customers.create({
+const customer = await client.beta.commerce.customers.create({
   email: 'john.doe@example.com',
   name: 'John Doe',
 });
@@ -63,7 +63,8 @@ const client = new Hercules({
   apiKey: process.env['HERCULES_API_KEY'], // This is the default and can be omitted
 });
 
-const customer: Hercules.Beta.Pay.Customer = await client.beta.pay.customers.get('REPLACE_ME');
+const customer: Hercules.Beta.Commerce.CustomerGetResponse =
+  await client.beta.commerce.customers.get('REPLACE_ME');
 ```
 
 Documentation for each method, request param, and response field are available in docstrings and will appear on hover in most modern editors.
@@ -76,7 +77,7 @@ a subclass of `APIError` will be thrown:
 
 <!-- prettier-ignore -->
 ```ts
-const customer = await client.beta.pay.customers.get('REPLACE_ME').catch(async (err) => {
+const customer = await client.beta.commerce.customers.get('REPLACE_ME').catch(async (err) => {
   if (err instanceof Hercules.APIError) {
     console.log(err.status); // 400
     console.log(err.name); // BadRequestError
@@ -117,7 +118,7 @@ const client = new Hercules({
 });
 
 // Or, configure per-request:
-await client.beta.pay.customers.get('REPLACE_ME', {
+await client.beta.commerce.customers.get('REPLACE_ME', {
   maxRetries: 5,
 });
 ```
@@ -135,7 +136,7 @@ const client = new Hercules({
 });
 
 // Override per-request:
-await client.beta.pay.customers.get('REPLACE_ME', {
+await client.beta.commerce.customers.get('REPLACE_ME', {
   timeout: 5 * 1000,
 });
 ```
@@ -150,25 +151,25 @@ List methods in the Hercules API are paginated.
 You can use the `for await … of` syntax to iterate through items across all pages:
 
 ```ts
-async function fetchAllCustomers(params) {
-  const allCustomers = [];
+async function fetchAllCustomerListResponses(params) {
+  const allCustomerListResponses = [];
   // Automatically fetches more pages as needed.
-  for await (const customer of client.beta.pay.customers.list({
+  for await (const customerListResponse of client.beta.commerce.customers.list({
     limit: 100,
     starting_after: 'id_123',
   })) {
-    allCustomers.push(customer);
+    allCustomerListResponses.push(customerListResponse);
   }
-  return allCustomers;
+  return allCustomerListResponses;
 }
 ```
 
 Alternatively, you can request a single page at a time:
 
 ```ts
-let page = await client.beta.pay.customers.list({ limit: 100, starting_after: 'id_123' });
-for (const customer of page.data) {
-  console.log(customer);
+let page = await client.beta.commerce.customers.list({ limit: 100, starting_after: 'id_123' });
+for (const customerListResponse of page.data) {
+  console.log(customerListResponse);
 }
 
 // Convenience methods are provided for manually paginating:
@@ -192,11 +193,11 @@ Unlike `.asResponse()` this method consumes the body, returning once it is parse
 ```ts
 const client = new Hercules();
 
-const response = await client.beta.pay.customers.get('REPLACE_ME').asResponse();
+const response = await client.beta.commerce.customers.get('REPLACE_ME').asResponse();
 console.log(response.headers.get('X-My-Header'));
 console.log(response.statusText); // access the underlying Response object
 
-const { data: customer, response: raw } = await client.beta.pay.customers
+const { data: customer, response: raw } = await client.beta.commerce.customers
   .get('REPLACE_ME')
   .withResponse();
 console.log(raw.headers.get('X-My-Header'));
@@ -280,7 +281,7 @@ parameter. This library doesn't validate at runtime that the request matches the
 send will be sent as-is.
 
 ```ts
-client.beta.pay.customers.create({
+client.beta.commerce.customers.create({
   // ...
   // @ts-expect-error baz is not yet public
   baz: 'undocumented option',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usehercules/sdk",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "The official TypeScript library for the Hercules API",
   "author": "Hercules <>",
   "types": "./index.d.ts",

package/resources/beta/beta.d.mts

@@ -1,10 +1,10 @@
 import { APIResource } from "../../core/resource.mjs";
-import * as PayAPI from "./pay/pay.mjs";
-import { Pay, PayCancelParams, PayCancelResponse, PayCheckParams, PayCheckResponse, PayCheckoutParams, PayCheckoutResponse } from "./pay/pay.mjs";
+import * as CommerceAPI from "./commerce/commerce.mjs";
+import { Commerce, CommerceCancelParams, CommerceCancelResponse, CommerceCheckParams, CommerceCheckResponse, CommerceCheckoutParams, CommerceCheckoutResponse } from "./commerce/commerce.mjs";
 export declare class Beta extends APIResource {
-    pay: PayAPI.Pay;
+    commerce: CommerceAPI.Commerce;
 }
 export declare namespace Beta {
-    export { Pay as Pay, type PayCancelResponse as PayCancelResponse, type PayCheckResponse as PayCheckResponse, type PayCheckoutResponse as PayCheckoutResponse, type PayCancelParams as PayCancelParams, type PayCheckParams as PayCheckParams, type PayCheckoutParams as PayCheckoutParams, };
+    export { Commerce as Commerce, type CommerceCancelResponse as CommerceCancelResponse, type CommerceCheckResponse as CommerceCheckResponse, type CommerceCheckoutResponse as CommerceCheckoutResponse, type CommerceCancelParams as CommerceCancelParams, type CommerceCheckParams as CommerceCheckParams, type CommerceCheckoutParams as CommerceCheckoutParams, };
 }
 //# sourceMappingURL=beta.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"beta.d.mts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EACL,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACpB;AAED,qBAAa,IAAK,SAAQ,WAAW;IACnC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAgC;CAChD;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,GAAG,IAAI,GAAG,EACV,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"beta.d.mts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EACL,QAAQ,EACR,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACzB;AAED,qBAAa,IAAK,SAAQ,WAAW;IACnC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;CACzE;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/beta/beta.d.ts

@@ -1,10 +1,10 @@
 import { APIResource } from "../../core/resource.js";
-import * as PayAPI from "./pay/pay.js";
-import { Pay, PayCancelParams, PayCancelResponse, PayCheckParams, PayCheckResponse, PayCheckoutParams, PayCheckoutResponse } from "./pay/pay.js";
+import * as CommerceAPI from "./commerce/commerce.js";
+import { Commerce, CommerceCancelParams, CommerceCancelResponse, CommerceCheckParams, CommerceCheckResponse, CommerceCheckoutParams, CommerceCheckoutResponse } from "./commerce/commerce.js";
 export declare class Beta extends APIResource {
-    pay: PayAPI.Pay;
+    commerce: CommerceAPI.Commerce;
 }
 export declare namespace Beta {
-    export { Pay as Pay, type PayCancelResponse as PayCancelResponse, type PayCheckResponse as PayCheckResponse, type PayCheckoutResponse as PayCheckoutResponse, type PayCancelParams as PayCancelParams, type PayCheckParams as PayCheckParams, type PayCheckoutParams as PayCheckoutParams, };
+    export { Commerce as Commerce, type CommerceCancelResponse as CommerceCancelResponse, type CommerceCheckResponse as CommerceCheckResponse, type CommerceCheckoutResponse as CommerceCheckoutResponse, type CommerceCancelParams as CommerceCancelParams, type CommerceCheckParams as CommerceCheckParams, type CommerceCheckoutParams as CommerceCheckoutParams, };
 }
 //# sourceMappingURL=beta.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EACL,GAAG,EACH,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACpB;AAED,qBAAa,IAAK,SAAQ,WAAW;IACnC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAgC;CAChD;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,GAAG,IAAI,GAAG,EACV,KAAK,iBAAiB,IAAI,iBAAiB,EAC3C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,iBAAiB,IAAI,iBAAiB,GAC5C,CAAC;CACH"}
+{"version":3,"file":"beta.d.ts","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EACL,QAAQ,EACR,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACzB;AAED,qBAAa,IAAK,SAAQ,WAAW;IACnC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAA0C;CACzE;AAID,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,sBAAsB,IAAI,sBAAsB,EACrD,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,oBAAoB,IAAI,oBAAoB,EACjD,KAAK,mBAAmB,IAAI,mBAAmB,EAC/C,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/beta/beta.js

@@ -4,14 +4,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Beta = void 0;
 const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
-const PayAPI = tslib_1.__importStar(require("./pay/pay.js"));
-const pay_1 = require("./pay/pay.js");
+const CommerceAPI = tslib_1.__importStar(require("./commerce/commerce.js"));
+const commerce_1 = require("./commerce/commerce.js");
 class Beta extends resource_1.APIResource {
     constructor() {
         super(...arguments);
-        this.pay = new PayAPI.Pay(this._client);
+        this.commerce = new CommerceAPI.Commerce(this._client);
     }
 }
 exports.Beta = Beta;
-Beta.Pay = pay_1.Pay;
+Beta.Commerce = commerce_1.Commerce;
 //# sourceMappingURL=beta.js.map

package/resources/beta/beta.js.map

@@ -1 +1 @@
-{"version":3,"file":"beta.js","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6DAAoC;AACpC,sCAQmB;AAEnB,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,QAAG,GAAe,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;CAAA;AAFD,oBAEC;AAED,IAAI,CAAC,GAAG,GAAG,SAAG,CAAC"}
+{"version":3,"file":"beta.js","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,4EAAmD;AACnD,qDAQ6B;AAE7B,MAAa,IAAK,SAAQ,sBAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;CAAA;AAFD,oBAEC;AAED,IAAI,CAAC,QAAQ,GAAG,mBAAQ,CAAC"}

package/resources/beta/beta.mjs

@@ -1,12 +1,12 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../core/resource.mjs";
-import * as PayAPI from "./pay/pay.mjs";
-import { Pay, } from "./pay/pay.mjs";
+import * as CommerceAPI from "./commerce/commerce.mjs";
+import { Commerce, } from "./commerce/commerce.mjs";
 export class Beta extends APIResource {
     constructor() {
         super(...arguments);
-        this.pay = new PayAPI.Pay(this._client);
+        this.commerce = new CommerceAPI.Commerce(this._client);
     }
 }
-Beta.Pay = Pay;
+Beta.Commerce = Commerce;
 //# sourceMappingURL=beta.mjs.map

package/resources/beta/beta.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"beta.mjs","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,MAAM;OACX,EACL,GAAG,GAOJ;AAED,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,QAAG,GAAe,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC;CAAA;AAED,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC"}
+{"version":3,"file":"beta.mjs","sourceRoot":"","sources":["../../src/resources/beta/beta.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,WAAW;OAChB,EACL,QAAQ,GAOT;AAED,MAAM,OAAO,IAAK,SAAQ,WAAW;IAArC;;QACE,aAAQ,GAAyB,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;CAAA;AAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC"}

package/resources/beta/commerce/commerce.d.mts

@@ -0,0 +1,201 @@
+import { APIResource } from "../../../core/resource.mjs";
+import * as CouponsAPI from "./coupons.mjs";
+import { CouponCreateParams, CouponCreateResponse, CouponGetResponse, CouponListParams, CouponListResponse, CouponListResponsesCursorIDPage, CouponUpdateParams, CouponUpdateResponse, Coupons } from "./coupons.mjs";
+import * as CustomersAPI from "./customers.mjs";
+import { CustomerBillingPortalParams, CustomerBillingPortalResponse, CustomerCreateParams, CustomerCreateResponse, CustomerGetResponse, CustomerListParams, CustomerListResponse, CustomerListResponsesCursorIDPage, CustomerUpdateParams, CustomerUpdateResponse, Customers } from "./customers.mjs";
+import * as ProductsAPI from "./products/products.mjs";
+import { ProductArchiveResponse, ProductCreateParams, ProductCreateResponse, ProductGetResponse, ProductListParams, ProductListResponse, ProductListResponsesCursorIDPage, ProductUpdateParams, ProductUpdateResponse, Products } from "./products/products.mjs";
+import { APIPromise } from "../../../core/api-promise.mjs";
+import { RequestOptions } from "../../../internal/request-options.mjs";
+export declare class Commerce extends APIResource {
+    customers: CustomersAPI.Customers;
+    products: ProductsAPI.Products;
+    coupons: CouponsAPI.Coupons;
+    /**
+     * 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: CommerceCancelParams, options?: RequestOptions): APIPromise<CommerceCancelResponse>;
+    /**
+     * 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: CommerceCheckParams, options?: RequestOptions): APIPromise<CommerceCheckResponse>;
+    /**
+     * 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: CommerceCheckoutParams, options?: RequestOptions): APIPromise<CommerceCheckoutResponse>;
+}
+/**
+ * Cancel subscription response
+ */
+export interface CommerceCancelResponse {
+    /**
+     * The subscription ID
+     */
+    id: string;
+    /**
+     * When the cancellation takes effect
+     */
+    cancellation_timing: 'immediate' | 'at_billing_period_end';
+    /**
+     * The subscription status
+     */
+    status: string;
+    /**
+     * When the subscription was canceled
+     */
+    canceled_at?: string | null;
+}
+/**
+ * Check resource access response. Indicates whether access is granted and through
+ * what means.
+ */
+export interface CommerceCheckResponse {
+    /**
+     * How the customer has access: through a subscription, one-time purchase, manual
+     * grant, or no access
+     */
+    access_type: 'subscription' | 'one_time_purchase' | 'manual_grant' | 'none';
+    /**
+     * Whether the customer has access to the resource
+     */
+    has_access: boolean;
+    /**
+     * The resource ID that was checked
+     */
+    resource_id: string;
+}
+/**
+ * Checkout response. For new customers, returns a checkout URL. For existing
+ * subscribers, returns the updated subscription.
+ */
+export interface CommerceCheckoutResponse {
+    /**
+     * The checkout session ID (for checkout action) or subscription ID (for update
+     * action)
+     */
+    id: string;
+    /**
+     * The action taken: 'checkout' for new subscriptions (redirect to URL), 'update'
+     * for subscription changes (already applied)
+     */
+    action: 'checkout' | 'update';
+    /**
+     * The checkout mode: subscription for recurring prices, payment for one-time
+     * prices. Only present for 'checkout' action.
+     */
+    mode?: 'subscription' | 'payment' | null;
+    /**
+     * The updated subscription details. Only present for 'update' action.
+     */
+    subscription?: CommerceCheckoutResponse.Subscription | null;
+    /**
+     * The checkout URL to redirect the customer to. Only present for 'checkout'
+     * action.
+     */
+    url?: string | null;
+}
+export declare namespace CommerceCheckoutResponse {
+    /**
+     * The updated subscription details. Only present for 'update' action.
+     */
+    interface Subscription {
+        /**
+         * The subscription ID
+         */
+        id: string;
+        /**
+         * The product ID
+         */
+        product_id: string;
+        /**
+         * The subscription status
+         */
+        status: string;
+        /**
+         * The variant ID if applicable
+         */
+        variant_id?: string | null;
+    }
+}
+export interface CommerceCancelParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The subscription ID to cancel
+     */
+    subscription_id: string;
+    /**
+     * When to cancel the subscription. Defaults to 'at_billing_period_end' to allow
+     * customers to use remaining time.
+     */
+    cancellation_timing?: 'immediate' | 'at_billing_period_end';
+}
+export interface CommerceCheckParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The resource ID to check for access
+     */
+    resource_id: string;
+}
+export interface CommerceCheckoutParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The variant ID to purchase. Determines pricing and whether this is a
+     * subscription or one-time payment.
+     */
+    variant_id: string;
+    /**
+     * Optional custom ID for the subscription or payment. If not provided, one will be
+     * generated.
+     */
+    id?: string;
+    /**
+     * Override billing cycle anchor behavior for subscription updates. If not
+     * provided, uses the product group's configured default.
+     */
+    billing_cycle_anchor?: 'now' | 'unchanged' | 'reset';
+    /**
+     * URL to redirect on cancel
+     */
+    cancel_url?: string;
+    /**
+     * Promotion code to apply
+     */
+    promotion_code?: string;
+    /**
+     * Override proration behavior for subscription updates. If not provided, uses the
+     * product group's configured default.
+     */
+    proration_behavior?: 'create_prorations' | 'none' | 'always_invoice';
+    /**
+     * Override proration date calculation for subscription updates. If not provided,
+     * uses the product group's configured default.
+     */
+    proration_date?: 'now' | 'start_of_period';
+    /**
+     * URL to redirect on success
+     */
+    success_url?: string;
+}
+export declare namespace Commerce {
+    export { type CommerceCancelResponse as CommerceCancelResponse, type CommerceCheckResponse as CommerceCheckResponse, type CommerceCheckoutResponse as CommerceCheckoutResponse, type CommerceCancelParams as CommerceCancelParams, type CommerceCheckParams as CommerceCheckParams, type CommerceCheckoutParams as CommerceCheckoutParams, };
+    export { Customers as Customers, type CustomerCreateResponse as CustomerCreateResponse, type CustomerUpdateResponse as CustomerUpdateResponse, type CustomerListResponse as CustomerListResponse, type CustomerBillingPortalResponse as CustomerBillingPortalResponse, type CustomerGetResponse as CustomerGetResponse, type CustomerListResponsesCursorIDPage as CustomerListResponsesCursorIDPage, type CustomerCreateParams as CustomerCreateParams, type CustomerUpdateParams as CustomerUpdateParams, type CustomerListParams as CustomerListParams, type CustomerBillingPortalParams as CustomerBillingPortalParams, };
+    export { Products as Products, type ProductCreateResponse as ProductCreateResponse, type ProductUpdateResponse as ProductUpdateResponse, type ProductListResponse as ProductListResponse, type ProductArchiveResponse as ProductArchiveResponse, type ProductGetResponse as ProductGetResponse, type ProductListResponsesCursorIDPage as ProductListResponsesCursorIDPage, type ProductCreateParams as ProductCreateParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, };
+    export { Coupons as Coupons, type CouponCreateResponse as CouponCreateResponse, type CouponUpdateResponse as CouponUpdateResponse, type CouponListResponse as CouponListResponse, type CouponGetResponse as CouponGetResponse, type CouponListResponsesCursorIDPage as CouponListResponsesCursorIDPage, type CouponCreateParams as CouponCreateParams, type CouponUpdateParams as CouponUpdateParams, type CouponListParams as CouponListParams, };
+}
+//# sourceMappingURL=commerce.d.mts.map

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

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

package/resources/beta/commerce/commerce.d.ts

@@ -0,0 +1,201 @@
+import { APIResource } from "../../../core/resource.js";
+import * as CouponsAPI from "./coupons.js";
+import { CouponCreateParams, CouponCreateResponse, CouponGetResponse, CouponListParams, CouponListResponse, CouponListResponsesCursorIDPage, CouponUpdateParams, CouponUpdateResponse, Coupons } from "./coupons.js";
+import * as CustomersAPI from "./customers.js";
+import { CustomerBillingPortalParams, CustomerBillingPortalResponse, CustomerCreateParams, CustomerCreateResponse, CustomerGetResponse, CustomerListParams, CustomerListResponse, CustomerListResponsesCursorIDPage, CustomerUpdateParams, CustomerUpdateResponse, Customers } from "./customers.js";
+import * as ProductsAPI from "./products/products.js";
+import { ProductArchiveResponse, ProductCreateParams, ProductCreateResponse, ProductGetResponse, ProductListParams, ProductListResponse, ProductListResponsesCursorIDPage, ProductUpdateParams, ProductUpdateResponse, Products } from "./products/products.js";
+import { APIPromise } from "../../../core/api-promise.js";
+import { RequestOptions } from "../../../internal/request-options.js";
+export declare class Commerce extends APIResource {
+    customers: CustomersAPI.Customers;
+    products: ProductsAPI.Products;
+    coupons: CouponsAPI.Coupons;
+    /**
+     * 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: CommerceCancelParams, options?: RequestOptions): APIPromise<CommerceCancelResponse>;
+    /**
+     * 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: CommerceCheckParams, options?: RequestOptions): APIPromise<CommerceCheckResponse>;
+    /**
+     * 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: CommerceCheckoutParams, options?: RequestOptions): APIPromise<CommerceCheckoutResponse>;
+}
+/**
+ * Cancel subscription response
+ */
+export interface CommerceCancelResponse {
+    /**
+     * The subscription ID
+     */
+    id: string;
+    /**
+     * When the cancellation takes effect
+     */
+    cancellation_timing: 'immediate' | 'at_billing_period_end';
+    /**
+     * The subscription status
+     */
+    status: string;
+    /**
+     * When the subscription was canceled
+     */
+    canceled_at?: string | null;
+}
+/**
+ * Check resource access response. Indicates whether access is granted and through
+ * what means.
+ */
+export interface CommerceCheckResponse {
+    /**
+     * How the customer has access: through a subscription, one-time purchase, manual
+     * grant, or no access
+     */
+    access_type: 'subscription' | 'one_time_purchase' | 'manual_grant' | 'none';
+    /**
+     * Whether the customer has access to the resource
+     */
+    has_access: boolean;
+    /**
+     * The resource ID that was checked
+     */
+    resource_id: string;
+}
+/**
+ * Checkout response. For new customers, returns a checkout URL. For existing
+ * subscribers, returns the updated subscription.
+ */
+export interface CommerceCheckoutResponse {
+    /**
+     * The checkout session ID (for checkout action) or subscription ID (for update
+     * action)
+     */
+    id: string;
+    /**
+     * The action taken: 'checkout' for new subscriptions (redirect to URL), 'update'
+     * for subscription changes (already applied)
+     */
+    action: 'checkout' | 'update';
+    /**
+     * The checkout mode: subscription for recurring prices, payment for one-time
+     * prices. Only present for 'checkout' action.
+     */
+    mode?: 'subscription' | 'payment' | null;
+    /**
+     * The updated subscription details. Only present for 'update' action.
+     */
+    subscription?: CommerceCheckoutResponse.Subscription | null;
+    /**
+     * The checkout URL to redirect the customer to. Only present for 'checkout'
+     * action.
+     */
+    url?: string | null;
+}
+export declare namespace CommerceCheckoutResponse {
+    /**
+     * The updated subscription details. Only present for 'update' action.
+     */
+    interface Subscription {
+        /**
+         * The subscription ID
+         */
+        id: string;
+        /**
+         * The product ID
+         */
+        product_id: string;
+        /**
+         * The subscription status
+         */
+        status: string;
+        /**
+         * The variant ID if applicable
+         */
+        variant_id?: string | null;
+    }
+}
+export interface CommerceCancelParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The subscription ID to cancel
+     */
+    subscription_id: string;
+    /**
+     * When to cancel the subscription. Defaults to 'at_billing_period_end' to allow
+     * customers to use remaining time.
+     */
+    cancellation_timing?: 'immediate' | 'at_billing_period_end';
+}
+export interface CommerceCheckParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The resource ID to check for access
+     */
+    resource_id: string;
+}
+export interface CommerceCheckoutParams {
+    /**
+     * The customer ID
+     */
+    customer_id: string;
+    /**
+     * The variant ID to purchase. Determines pricing and whether this is a
+     * subscription or one-time payment.
+     */
+    variant_id: string;
+    /**
+     * Optional custom ID for the subscription or payment. If not provided, one will be
+     * generated.
+     */
+    id?: string;
+    /**
+     * Override billing cycle anchor behavior for subscription updates. If not
+     * provided, uses the product group's configured default.
+     */
+    billing_cycle_anchor?: 'now' | 'unchanged' | 'reset';
+    /**
+     * URL to redirect on cancel
+     */
+    cancel_url?: string;
+    /**
+     * Promotion code to apply
+     */
+    promotion_code?: string;
+    /**
+     * Override proration behavior for subscription updates. If not provided, uses the
+     * product group's configured default.
+     */
+    proration_behavior?: 'create_prorations' | 'none' | 'always_invoice';
+    /**
+     * Override proration date calculation for subscription updates. If not provided,
+     * uses the product group's configured default.
+     */
+    proration_date?: 'now' | 'start_of_period';
+    /**
+     * URL to redirect on success
+     */
+    success_url?: string;
+}
+export declare namespace Commerce {
+    export { type CommerceCancelResponse as CommerceCancelResponse, type CommerceCheckResponse as CommerceCheckResponse, type CommerceCheckoutResponse as CommerceCheckoutResponse, type CommerceCancelParams as CommerceCancelParams, type CommerceCheckParams as CommerceCheckParams, type CommerceCheckoutParams as CommerceCheckoutParams, };
+    export { Customers as Customers, type CustomerCreateResponse as CustomerCreateResponse, type CustomerUpdateResponse as CustomerUpdateResponse, type CustomerListResponse as CustomerListResponse, type CustomerBillingPortalResponse as CustomerBillingPortalResponse, type CustomerGetResponse as CustomerGetResponse, type CustomerListResponsesCursorIDPage as CustomerListResponsesCursorIDPage, type CustomerCreateParams as CustomerCreateParams, type CustomerUpdateParams as CustomerUpdateParams, type CustomerListParams as CustomerListParams, type CustomerBillingPortalParams as CustomerBillingPortalParams, };
+    export { Products as Products, type ProductCreateResponse as ProductCreateResponse, type ProductUpdateResponse as ProductUpdateResponse, type ProductListResponse as ProductListResponse, type ProductArchiveResponse as ProductArchiveResponse, type ProductGetResponse as ProductGetResponse, type ProductListResponsesCursorIDPage as ProductListResponsesCursorIDPage, type ProductCreateParams as ProductCreateParams, type ProductUpdateParams as ProductUpdateParams, type ProductListParams as ProductListParams, };
+    export { Coupons as Coupons, type CouponCreateResponse as CouponCreateResponse, type CouponUpdateResponse as CouponUpdateResponse, type CouponListResponse as CouponListResponse, type CouponGetResponse as CouponGetResponse, type CouponListResponsesCursorIDPage as CouponListResponsesCursorIDPage, type CouponCreateParams as CouponCreateParams, type CouponUpdateParams as CouponUpdateParams, type CouponListParams as CouponListParams, };
+}
+//# sourceMappingURL=commerce.d.ts.map