@usehercules/sdk 1.9.0 → 1.10.0

package/resources/beta/content/releases/releases.js

@@ -0,0 +1,69 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Releases = void 0;
+const tslib_1 = require("../../../../internal/tslib.js");
+const resource_1 = require("../../../../core/resource.js");
+const ItemsAPI = tslib_1.__importStar(require("./items.js"));
+const items_1 = require("./items.js");
+const pagination_1 = require("../../../../core/pagination.js");
+const headers_1 = require("../../../../internal/headers.js");
+const path_1 = require("../../../../internal/utils/path.js");
+class Releases extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.items = new ItemsAPI.Items(this._client);
+    }
+    /**
+     * Creates a new release. Add items using the add items endpoint, then publish or
+     * schedule the release.
+     */
+    create(body, options) {
+        return this._client.post('/v1/content/releases', { body, ...options });
+    }
+    /**
+     * Updates a release name and description. Only draft releases can be updated.
+     */
+    update(releaseID, body = {}, options) {
+        return this._client.patch((0, path_1.path) `/v1/content/releases/${releaseID}`, { body, ...options });
+    }
+    /**
+     * Retrieves a paginated list of releases. Releases group entries and assets for
+     * atomic publishing.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/content/releases', (pagination_1.CursorIDPage), { query, ...options });
+    }
+    /**
+     * Deletes a draft release. Published releases cannot be deleted.
+     */
+    delete(releaseID, options) {
+        return this._client.delete((0, path_1.path) `/v1/content/releases/${releaseID}`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieves a release by ID with all its items.
+     */
+    get(releaseID, options) {
+        return this._client.get((0, path_1.path) `/v1/content/releases/${releaseID}`, options);
+    }
+    /**
+     * Publishes all items in the release immediately. Each item's action (publish or
+     * unpublish) is executed atomically.
+     */
+    publish(releaseID, options) {
+        return this._client.post((0, path_1.path) `/v1/content/releases/${releaseID}/publish`, options);
+    }
+    /**
+     * Schedules a release for future publication. The release will be automatically
+     * published at the specified time.
+     */
+    schedule(releaseID, body, options) {
+        return this._client.post((0, path_1.path) `/v1/content/releases/${releaseID}/schedule`, { body, ...options });
+    }
+}
+exports.Releases = Releases;
+Releases.Items = items_1.Items;
+//# sourceMappingURL=releases.js.map

package/resources/beta/content/releases/releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.js","sourceRoot":"","sources":["../../../../src/resources/beta/content/releases/releases.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,2DAAwD;AACxD,6DAAoC;AACpC,sCAAiE;AAEjE,+DAAiG;AACjG,6DAA4D;AAE5D,6DAAuD;AAEvD,MAAa,QAAS,SAAQ,sBAAW;IAAzC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgE3D,CAAC;IA9DC;;;OAGG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,wBAAwB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA,yBAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,wBAAwB,SAAS,EAAE,EAAE;YAClE,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,wBAAwB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAiB,EAAE,IAA2B,EAAE,OAAwB;QAC/E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,wBAAwB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF;AAjED,4BAiEC;AAiID,QAAQ,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/beta/content/releases/releases.mjs

@@ -0,0 +1,64 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../../../core/resource.mjs";
+import * as ItemsAPI from "./items.mjs";
+import { Items } from "./items.mjs";
+import { CursorIDPage } from "../../../../core/pagination.mjs";
+import { buildHeaders } from "../../../../internal/headers.mjs";
+import { path } from "../../../../internal/utils/path.mjs";
+export class Releases extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.items = new ItemsAPI.Items(this._client);
+    }
+    /**
+     * Creates a new release. Add items using the add items endpoint, then publish or
+     * schedule the release.
+     */
+    create(body, options) {
+        return this._client.post('/v1/content/releases', { body, ...options });
+    }
+    /**
+     * Updates a release name and description. Only draft releases can be updated.
+     */
+    update(releaseID, body = {}, options) {
+        return this._client.patch(path `/v1/content/releases/${releaseID}`, { body, ...options });
+    }
+    /**
+     * Retrieves a paginated list of releases. Releases group entries and assets for
+     * atomic publishing.
+     */
+    list(query = {}, options) {
+        return this._client.getAPIList('/v1/content/releases', (CursorIDPage), { query, ...options });
+    }
+    /**
+     * Deletes a draft release. Published releases cannot be deleted.
+     */
+    delete(releaseID, options) {
+        return this._client.delete(path `/v1/content/releases/${releaseID}`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Retrieves a release by ID with all its items.
+     */
+    get(releaseID, options) {
+        return this._client.get(path `/v1/content/releases/${releaseID}`, options);
+    }
+    /**
+     * Publishes all items in the release immediately. Each item's action (publish or
+     * unpublish) is executed atomically.
+     */
+    publish(releaseID, options) {
+        return this._client.post(path `/v1/content/releases/${releaseID}/publish`, options);
+    }
+    /**
+     * Schedules a release for future publication. The release will be automatically
+     * published at the specified time.
+     */
+    schedule(releaseID, body, options) {
+        return this._client.post(path `/v1/content/releases/${releaseID}/schedule`, { body, ...options });
+    }
+}
+Releases.Items = Items;
+//# sourceMappingURL=releases.mjs.map

package/resources/beta/content/releases/releases.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.mjs","sourceRoot":"","sources":["../../../../src/resources/beta/content/releases/releases.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EAAmC,KAAK,EAAE;OAE1C,EAAE,YAAY,EAAwC;OACtD,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,QAAS,SAAQ,WAAW;IAAzC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgE3D,CAAC;IA9DC;;;OAGG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,SAAiB,EACjB,OAA+C,EAAE,EACjD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,wBAAwB,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,QAA8C,EAAE,EAChD,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,EAAE,CAAA,YAAqB,CAAA,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACvG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,SAAiB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,wBAAwB,SAAS,EAAE,EAAE;YAClE,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,SAAiB,EAAE,OAAwB;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,wBAAwB,SAAS,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,SAAiB,EAAE,OAAwB;QACjD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,wBAAwB,SAAS,UAAU,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,SAAiB,EAAE,IAA2B,EAAE,OAAwB;QAC/E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,wBAAwB,SAAS,WAAW,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;CACF;AAiID,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC"}

package/resources/beta/content/releases.d.mts

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

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

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

package/resources/beta/content/releases.d.ts

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

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

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

package/resources/beta/content/releases.js

@@ -0,0 +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("./releases/index.js"), exports);
+//# sourceMappingURL=releases.js.map

package/resources/beta/content/releases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.js","sourceRoot":"","sources":["../../../src/resources/beta/content/releases.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,8DAAiC"}

package/resources/beta/content/releases.mjs

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

package/resources/beta/content/releases.mjs.map

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

package/resources/beta/content.d.mts

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

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

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

package/resources/beta/content.d.ts

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

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

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

package/resources/beta/content.js

@@ -0,0 +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("./content/index.js"), exports);
+//# sourceMappingURL=content.js.map

package/resources/beta/content.js.map

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

package/resources/beta/content.mjs

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

package/resources/beta/content.mjs.map

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

package/resources/beta/index.d.mts

@@ -1,3 +1,4 @@
 export { Beta } from "./beta.mjs";
 export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/index.mjs";
+export { Content } from "./content/index.mjs";
 //# sourceMappingURL=index.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE"}

package/resources/beta/index.d.ts

@@ -1,3 +1,4 @@
 export { Beta } from "./beta.js";
 export { Commerce, type CommerceCancelResponse, type CommerceCheckResponse, type CommerceCheckoutResponse, type CommerceCancelParams, type CommerceCheckParams, type CommerceCheckoutParams, } from "./commerce/index.js";
+export { Content } from "./content/index.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"OAEO,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,EACR,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B;OACM,EAAE,OAAO,EAAE"}

package/resources/beta/index.js

@@ -1,9 +1,11 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Commerce = exports.Beta = void 0;
+exports.Content = exports.Commerce = exports.Beta = void 0;
 var beta_1 = require("./beta.js");
 Object.defineProperty(exports, "Beta", { enumerable: true, get: function () { return beta_1.Beta; } });
 var index_1 = require("./commerce/index.js");
 Object.defineProperty(exports, "Commerce", { enumerable: true, get: function () { return index_1.Commerce; } });
+var index_2 = require("./content/index.js");
+Object.defineProperty(exports, "Content", { enumerable: true, get: function () { return index_2.Content; } });
 //# sourceMappingURL=index.js.map

package/resources/beta/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kCAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,6CAQ0B;AAPxB,iGAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kCAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,6CAQ0B;AAPxB,iGAAA,QAAQ,OAAA;AAQV,4CAA0C;AAAjC,gGAAA,OAAO,OAAA"}

package/resources/beta/index.mjs

@@ -1,4 +1,5 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 export { Beta } from "./beta.mjs";
 export { Commerce, } from "./commerce/index.mjs";
+export { Content } from "./content/index.mjs";
 //# sourceMappingURL=index.mjs.map

package/resources/beta/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,GAOT"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/beta/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,IAAI,EAAE;OACR,EACL,QAAQ,GAOT;OACM,EAAE,OAAO,EAAE"}

package/src/resources/beta/beta.ts

@@ -11,12 +11,16 @@ import {
   CommerceCheckoutParams,
   CommerceCheckoutResponse,
 } from './commerce/commerce';
+import * as ContentAPI from './content/content';
+import { Content } from './content/content';
 
 export class Beta extends APIResource {
   commerce: CommerceAPI.Commerce = new CommerceAPI.Commerce(this._client);
+  content: ContentAPI.Content = new ContentAPI.Content(this._client);
 }
 
 Beta.Commerce = Commerce;
+Beta.Content = Content;
 
 export declare namespace Beta {
   export {
@@ -28,4 +32,6 @@ export declare namespace Beta {
     type CommerceCheckParams as CommerceCheckParams,
     type CommerceCheckoutParams as CommerceCheckoutParams,
   };
+
+  export { Content as Content };
 }

package/src/resources/beta/commerce/commerce.ts

@@ -235,15 +235,27 @@ export interface CommerceCheckoutParams {
   id?: string;
 
   /**
-   * Override billing cycle anchor behavior for subscription updates. If not
-   * provided, uses the subscription group's configured default.
+   * URL to redirect on cancel
    */
-  billing_cycle_anchor?: 'now' | 'unchanged' | 'reset';
+  cancel_url?: string;
 
   /**
-   * URL to redirect on cancel
+   * Override charge timing for subscription updates. If not provided, uses the
+   * subscription group's configured default.
    */
-  cancel_url?: string;
+  charge_timing?: 'immediate' | 'end_of_period';
+
+  /**
+   * Override interval downgrade behavior for subscription updates. If not provided,
+   * uses the subscription group's configured default.
+   */
+  interval_downgrade_behavior?: 'immediate' | 'end_of_period';
+
+  /**
+   * Override plan downgrade behavior for subscription updates. If not provided, uses
+   * the subscription group's configured default.
+   */
+  plan_downgrade_behavior?: 'immediate' | 'end_of_period';
 
   /**
    * Promotion code to apply
@@ -254,13 +266,7 @@ export interface CommerceCheckoutParams {
    * Override proration behavior for subscription updates. If not provided, uses the
    * subscription group's configured default.
    */
-  proration_behavior?: 'create_prorations' | 'none' | 'always_invoice';
-
-  /**
-   * Override proration date calculation for subscription updates. If not provided,
-   * uses the subscription group's configured default.
-   */
-  proration_date?: 'now' | 'start_of_period';
+  proration_behavior?: 'none' | 'prorate' | 'full_difference';
 
   /**
    * URL to redirect on success