lark-billing 0.1.1 → 0.1.3

package/README.md

@@ -26,7 +26,10 @@ const client = new LarkClient({ apiKey: "YOUR_API_KEY" });
 await client.checkout.createSubscriptionCheckoutSession({
     subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
     rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-    success_callback_url: "https://example.com/callback",
+    checkout_callback_urls: {
+        cancelled_url: "https://example.com/callback",
+        success_url: "https://example.com/callback",
+    },
 });
 ```
 

package/dist/cjs/Client.js

@@ -53,8 +53,8 @@ class LarkClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "lark-billing",
-                "X-Fern-SDK-Version": "0.1.1",
-                "User-Agent": "lark-billing/0.1.1",
+                "X-Fern-SDK-Version": "0.1.3",
+                "User-Agent": "lark-billing/0.1.3",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/checkout/client/Client.d.ts

@@ -39,7 +39,10 @@ export declare class Checkout {
      *     await client.checkout.createSubscriptionCheckoutSession({
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
      *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-     *         success_callback_url: "https://example.com/callback"
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     createSubscriptionCheckoutSession(request: Lark.CreateSubscriptionCheckoutSessionRequest, requestOptions?: Checkout.RequestOptions): core.HttpResponsePromise<Lark.CreateSubscriptionCheckoutSessionResponse>;

package/dist/cjs/api/resources/checkout/client/Client.js

@@ -65,7 +65,10 @@ class Checkout {
      *     await client.checkout.createSubscriptionCheckoutSession({
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
      *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-     *         success_callback_url: "https://example.com/callback"
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     createSubscriptionCheckoutSession(request, requestOptions) {

package/dist/cjs/api/resources/checkout/client/requests/CreateSubscriptionCheckoutSessionRequest.d.ts

@@ -1,12 +1,16 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Lark from "../../../../index.js";
 /**
  * @example
  *     {
  *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
  *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
- *         success_callback_url: "https://example.com/callback"
+ *         checkout_callback_urls: {
+ *             cancelled_url: "https://example.com/callback",
+ *             success_url: "https://example.com/callback"
+ *         }
  *     }
  */
 export interface CreateSubscriptionCheckoutSessionRequest {
@@ -14,8 +18,6 @@ export interface CreateSubscriptionCheckoutSessionRequest {
     subject_id: string;
     /** The ID of the rate card to subscribe to. */
     rate_card_id: string;
-    /** The URL to redirect to after the checkout is successful. */
-    success_callback_url: string;
-    /** The URL to redirect to after the checkout is cancelled. */
-    cancel_url?: string;
+    /** The URLs to redirect to after the checkout is completed or cancelled. */
+    checkout_callback_urls: Lark.CheckoutCallback;
 }

package/dist/cjs/api/resources/subscriptions/client/Client.d.ts

@@ -90,10 +90,14 @@ export declare class Subscriptions {
      *
      * @example
      *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
-     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
-    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
+    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.ChangeSubscriptionRateCardResponse>;
     private __changeSubscriptionRateCard;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "X-API-Key": string;

package/dist/cjs/api/resources/subscriptions/client/Client.js

@@ -317,7 +317,11 @@ class Subscriptions {
      *
      * @example
      *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
-     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
@@ -340,7 +344,10 @@ class Subscriptions {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

package/dist/cjs/api/resources/subscriptions/client/requests/ChangeSubscriptionRateCardRequest.d.ts

@@ -1,13 +1,32 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Lark from "../../../../index.js";
 /**
  * @example
  *     {
- *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+ *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+ *         checkout_callback_urls: {
+ *             cancelled_url: "https://example.com/callback",
+ *             success_url: "https://example.com/callback"
+ *         }
  *     }
  */
 export interface ChangeSubscriptionRateCardRequest {
     /** The ID of the rate card to change the subscription to. */
     rate_card_id: string;
+    /** The behavior to use when upgrading the subscription. If 'prorate', the customer will be charged for the prorated difference. If 'rate_difference', the customer will be charged for the difference in the rate cards without respect to time. */
+    upgrade_behavior?: ChangeSubscriptionRateCardRequest.UpgradeBehavior;
+    /** The URLs to redirect to after the checkout is completed or cancelled, if a checkout is required. */
+    checkout_callback_urls: Lark.CheckoutCallback;
+}
+export declare namespace ChangeSubscriptionRateCardRequest {
+    /**
+     * The behavior to use when upgrading the subscription. If 'prorate', the customer will be charged for the prorated difference. If 'rate_difference', the customer will be charged for the difference in the rate cards without respect to time.
+     */
+    type UpgradeBehavior = "prorate" | "rate_difference";
+    const UpgradeBehavior: {
+        readonly Prorate: "prorate";
+        readonly RateDifference: "rate_difference";
+    };
 }

package/dist/cjs/api/resources/subscriptions/client/requests/ChangeSubscriptionRateCardRequest.js

@@ -3,3 +3,11 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChangeSubscriptionRateCardRequest = void 0;
+var ChangeSubscriptionRateCardRequest;
+(function (ChangeSubscriptionRateCardRequest) {
+    ChangeSubscriptionRateCardRequest.UpgradeBehavior = {
+        Prorate: "prorate",
+        RateDifference: "rate_difference",
+    };
+})(ChangeSubscriptionRateCardRequest || (exports.ChangeSubscriptionRateCardRequest = ChangeSubscriptionRateCardRequest = {}));

package/dist/cjs/api/resources/usageEvents/client/Client.d.ts

@@ -37,10 +37,10 @@ export declare class UsageEvents {
      *
      * @example
      *     await client.usageEvents.createUsageEvent({
-     *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+     *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
      *         event_name: "compute_hours",
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
-     *         timestamp: "2025-11-03T18:37:02Z",
+     *         timestamp: "2025-11-06T20:22:47Z",
      *         data: {
      *             "compute_hours": 100,
      *             "instance_type": "t2.micro",

package/dist/cjs/api/resources/usageEvents/client/Client.js

@@ -63,10 +63,10 @@ class UsageEvents {
      *
      * @example
      *     await client.usageEvents.createUsageEvent({
-     *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+     *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
      *         event_name: "compute_hours",
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
-     *         timestamp: "2025-11-03T18:37:02Z",
+     *         timestamp: "2025-11-06T20:22:47Z",
      *         data: {
      *             "compute_hours": 100,
      *             "instance_type": "t2.micro",

package/dist/cjs/api/resources/usageEvents/client/requests/CreateUsageEventRequest.d.ts

@@ -4,10 +4,10 @@
 /**
  * @example
  *     {
- *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+ *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
  *         event_name: "compute_hours",
  *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
- *         timestamp: "2025-11-03T18:37:02Z",
+ *         timestamp: "2025-11-06T20:22:47Z",
  *         data: {
  *             "compute_hours": 100,
  *             "instance_type": "t2.micro",

package/dist/cjs/api/types/ChangeSubscriptionRateCardResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.js";
+export interface ChangeSubscriptionRateCardResponse {
+    result: Lark.Result;
+}

package/dist/cjs/api/types/ChangeSubscriptionRateCardResponse.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/CheckoutAction.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface CheckoutAction {
+    type: "checkout";
+    checkout_url: string;
+}

package/dist/cjs/api/types/CheckoutAction.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/CheckoutCallback.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface CheckoutCallback {
+    /** The URL to redirect to after the checkout is cancelled. */
+    cancelled_url: string;
+    /** The URL to redirect to after the checkout is successful. */
+    success_url: string;
+}

package/dist/cjs/api/types/CheckoutCallback.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/RequiresActionResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.js";
+export interface RequiresActionResponse {
+    action: Lark.CheckoutAction;
+}

package/dist/cjs/api/types/RequiresActionResponse.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/Result.d.ts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.js";
+export type Result = Lark.Result.RequiresAction | Lark.Result.Success;
+export declare namespace Result {
+    interface RequiresAction extends Lark.RequiresActionResponse {
+        type: "requires_action";
+    }
+    interface Success extends Lark.SuccessResponse {
+        type: "success";
+    }
+}

package/dist/cjs/api/types/Result.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/SuccessResponse.d.ts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.js";
+export interface SuccessResponse {
+    subscription: Lark.SubscriptionResource;
+}

package/dist/cjs/api/types/SuccessResponse.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -1,6 +1,9 @@
 export * from "./ActiveSubscription.js";
 export * from "./Amount.js";
 export * from "./BillingStateResponse.js";
+export * from "./Result.js";
+export * from "./ChangeSubscriptionRateCardResponse.js";
+export * from "./CheckoutAction.js";
 export * from "./CountAggregationPricingMetricInterface.js";
 export * from "./CountAggregationPricingMetricResource.js";
 export * from "./CreateCustomerPortalSessionResponse.js";
@@ -32,10 +35,13 @@ export * from "./PricingMetricResource.js";
 export * from "./PricingMetricSummaryResource.js";
 export * from "./RateCardResourceUsageBasedRatesItem.js";
 export * from "./RateCardResource.js";
+export * from "./RequiresActionResponse.js";
 export * from "./SimpleUsageBasedRateInterface.js";
 export * from "./SubjectResource.js";
 export * from "./SubscriptionResource.js";
+export * from "./SuccessResponse.js";
 export * from "./SumAggregationPricingMetricInterface.js";
 export * from "./SumAggregationPricingMetricResource.js";
 export * from "./UsageDataForRate.js";
 export * from "./ValidationError.js";
+export * from "./CheckoutCallback.js";

package/dist/cjs/api/types/index.js

@@ -17,6 +17,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ActiveSubscription.js"), exports);
 __exportStar(require("./Amount.js"), exports);
 __exportStar(require("./BillingStateResponse.js"), exports);
+__exportStar(require("./Result.js"), exports);
+__exportStar(require("./ChangeSubscriptionRateCardResponse.js"), exports);
+__exportStar(require("./CheckoutAction.js"), exports);
 __exportStar(require("./CountAggregationPricingMetricInterface.js"), exports);
 __exportStar(require("./CountAggregationPricingMetricResource.js"), exports);
 __exportStar(require("./CreateCustomerPortalSessionResponse.js"), exports);
@@ -48,10 +51,13 @@ __exportStar(require("./PricingMetricResource.js"), exports);
 __exportStar(require("./PricingMetricSummaryResource.js"), exports);
 __exportStar(require("./RateCardResourceUsageBasedRatesItem.js"), exports);
 __exportStar(require("./RateCardResource.js"), exports);
+__exportStar(require("./RequiresActionResponse.js"), exports);
 __exportStar(require("./SimpleUsageBasedRateInterface.js"), exports);
 __exportStar(require("./SubjectResource.js"), exports);
 __exportStar(require("./SubscriptionResource.js"), exports);
+__exportStar(require("./SuccessResponse.js"), exports);
 __exportStar(require("./SumAggregationPricingMetricInterface.js"), exports);
 __exportStar(require("./SumAggregationPricingMetricResource.js"), exports);
 __exportStar(require("./UsageDataForRate.js"), exports);
 __exportStar(require("./ValidationError.js"), exports);
+__exportStar(require("./CheckoutCallback.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.1";
+export declare const SDK_VERSION = "0.1.3";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.1";
+exports.SDK_VERSION = "0.1.3";

package/dist/esm/Client.mjs

@@ -17,8 +17,8 @@ export class LarkClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "lark-billing",
-                "X-Fern-SDK-Version": "0.1.1",
-                "User-Agent": "lark-billing/0.1.1",
+                "X-Fern-SDK-Version": "0.1.3",
+                "User-Agent": "lark-billing/0.1.3",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/checkout/client/Client.d.mts

@@ -39,7 +39,10 @@ export declare class Checkout {
      *     await client.checkout.createSubscriptionCheckoutSession({
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
      *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-     *         success_callback_url: "https://example.com/callback"
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     createSubscriptionCheckoutSession(request: Lark.CreateSubscriptionCheckoutSessionRequest, requestOptions?: Checkout.RequestOptions): core.HttpResponsePromise<Lark.CreateSubscriptionCheckoutSessionResponse>;

package/dist/esm/api/resources/checkout/client/Client.mjs

@@ -29,7 +29,10 @@ export class Checkout {
      *     await client.checkout.createSubscriptionCheckoutSession({
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
      *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-     *         success_callback_url: "https://example.com/callback"
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     createSubscriptionCheckoutSession(request, requestOptions) {

package/dist/esm/api/resources/checkout/client/requests/CreateSubscriptionCheckoutSessionRequest.d.mts

@@ -1,12 +1,16 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Lark from "../../../../index.mjs";
 /**
  * @example
  *     {
  *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
  *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
- *         success_callback_url: "https://example.com/callback"
+ *         checkout_callback_urls: {
+ *             cancelled_url: "https://example.com/callback",
+ *             success_url: "https://example.com/callback"
+ *         }
  *     }
  */
 export interface CreateSubscriptionCheckoutSessionRequest {
@@ -14,8 +18,6 @@ export interface CreateSubscriptionCheckoutSessionRequest {
     subject_id: string;
     /** The ID of the rate card to subscribe to. */
     rate_card_id: string;
-    /** The URL to redirect to after the checkout is successful. */
-    success_callback_url: string;
-    /** The URL to redirect to after the checkout is cancelled. */
-    cancel_url?: string;
+    /** The URLs to redirect to after the checkout is completed or cancelled. */
+    checkout_callback_urls: Lark.CheckoutCallback;
 }

package/dist/esm/api/resources/subscriptions/client/Client.d.mts

@@ -90,10 +90,14 @@ export declare class Subscriptions {
      *
      * @example
      *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
-     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
-    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
+    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.ChangeSubscriptionRateCardResponse>;
     private __changeSubscriptionRateCard;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "X-API-Key": string;

package/dist/esm/api/resources/subscriptions/client/Client.mjs

@@ -281,7 +281,11 @@ export class Subscriptions {
      *
      * @example
      *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
-     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+     *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+     *         checkout_callback_urls: {
+     *             cancelled_url: "https://example.com/callback",
+     *             success_url: "https://example.com/callback"
+     *         }
      *     })
      */
     changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
@@ -304,7 +308,10 @@ export class Subscriptions {
                 abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
             });
             if (_response.ok) {
-                return { data: _response.body, rawResponse: _response.rawResponse };
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
             }
             if (_response.error.reason === "status-code") {
                 switch (_response.error.statusCode) {

package/dist/esm/api/resources/subscriptions/client/requests/ChangeSubscriptionRateCardRequest.d.mts

@@ -1,13 +1,32 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as Lark from "../../../../index.mjs";
 /**
  * @example
  *     {
- *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+ *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+ *         checkout_callback_urls: {
+ *             cancelled_url: "https://example.com/callback",
+ *             success_url: "https://example.com/callback"
+ *         }
  *     }
  */
 export interface ChangeSubscriptionRateCardRequest {
     /** The ID of the rate card to change the subscription to. */
     rate_card_id: string;
+    /** The behavior to use when upgrading the subscription. If 'prorate', the customer will be charged for the prorated difference. If 'rate_difference', the customer will be charged for the difference in the rate cards without respect to time. */
+    upgrade_behavior?: ChangeSubscriptionRateCardRequest.UpgradeBehavior;
+    /** The URLs to redirect to after the checkout is completed or cancelled, if a checkout is required. */
+    checkout_callback_urls: Lark.CheckoutCallback;
+}
+export declare namespace ChangeSubscriptionRateCardRequest {
+    /**
+     * The behavior to use when upgrading the subscription. If 'prorate', the customer will be charged for the prorated difference. If 'rate_difference', the customer will be charged for the difference in the rate cards without respect to time.
+     */
+    type UpgradeBehavior = "prorate" | "rate_difference";
+    const UpgradeBehavior: {
+        readonly Prorate: "prorate";
+        readonly RateDifference: "rate_difference";
+    };
 }

package/dist/esm/api/resources/subscriptions/client/requests/ChangeSubscriptionRateCardRequest.mjs

@@ -1,4 +1,10 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
-export {};
+export var ChangeSubscriptionRateCardRequest;
+(function (ChangeSubscriptionRateCardRequest) {
+    ChangeSubscriptionRateCardRequest.UpgradeBehavior = {
+        Prorate: "prorate",
+        RateDifference: "rate_difference",
+    };
+})(ChangeSubscriptionRateCardRequest || (ChangeSubscriptionRateCardRequest = {}));

package/dist/esm/api/resources/usageEvents/client/Client.d.mts

@@ -37,10 +37,10 @@ export declare class UsageEvents {
      *
      * @example
      *     await client.usageEvents.createUsageEvent({
-     *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+     *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
      *         event_name: "compute_hours",
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
-     *         timestamp: "2025-11-03T18:37:02Z",
+     *         timestamp: "2025-11-06T20:22:47Z",
      *         data: {
      *             "compute_hours": 100,
      *             "instance_type": "t2.micro",

package/dist/esm/api/resources/usageEvents/client/Client.mjs

@@ -27,10 +27,10 @@ export class UsageEvents {
      *
      * @example
      *     await client.usageEvents.createUsageEvent({
-     *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+     *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
      *         event_name: "compute_hours",
      *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
-     *         timestamp: "2025-11-03T18:37:02Z",
+     *         timestamp: "2025-11-06T20:22:47Z",
      *         data: {
      *             "compute_hours": 100,
      *             "instance_type": "t2.micro",

package/dist/esm/api/resources/usageEvents/client/requests/CreateUsageEventRequest.d.mts

@@ -4,10 +4,10 @@
 /**
  * @example
  *     {
- *         idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+ *         idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
  *         event_name: "compute_hours",
  *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
- *         timestamp: "2025-11-03T18:37:02Z",
+ *         timestamp: "2025-11-06T20:22:47Z",
  *         data: {
  *             "compute_hours": 100,
  *             "instance_type": "t2.micro",

package/dist/esm/api/types/ChangeSubscriptionRateCardResponse.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface ChangeSubscriptionRateCardResponse {
+    result: Lark.Result;
+}

package/dist/esm/api/types/ChangeSubscriptionRateCardResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/CheckoutAction.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface CheckoutAction {
+    type: "checkout";
+    checkout_url: string;
+}

package/dist/esm/api/types/CheckoutAction.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/CheckoutCallback.d.mts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface CheckoutCallback {
+    /** The URL to redirect to after the checkout is cancelled. */
+    cancelled_url: string;
+    /** The URL to redirect to after the checkout is successful. */
+    success_url: string;
+}

package/dist/esm/api/types/CheckoutCallback.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/RequiresActionResponse.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface RequiresActionResponse {
+    action: Lark.CheckoutAction;
+}

package/dist/esm/api/types/RequiresActionResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/Result.d.mts

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export type Result = Lark.Result.RequiresAction | Lark.Result.Success;
+export declare namespace Result {
+    interface RequiresAction extends Lark.RequiresActionResponse {
+        type: "requires_action";
+    }
+    interface Success extends Lark.SuccessResponse {
+        type: "success";
+    }
+}

package/dist/esm/api/types/Result.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/SuccessResponse.d.mts

@@ -0,0 +1,7 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface SuccessResponse {
+    subscription: Lark.SubscriptionResource;
+}

package/dist/esm/api/types/SuccessResponse.mjs

@@ -0,0 +1,4 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export {};

package/dist/esm/api/types/index.d.mts

@@ -1,6 +1,9 @@
 export * from "./ActiveSubscription.mjs";
 export * from "./Amount.mjs";
 export * from "./BillingStateResponse.mjs";
+export * from "./Result.mjs";
+export * from "./ChangeSubscriptionRateCardResponse.mjs";
+export * from "./CheckoutAction.mjs";
 export * from "./CountAggregationPricingMetricInterface.mjs";
 export * from "./CountAggregationPricingMetricResource.mjs";
 export * from "./CreateCustomerPortalSessionResponse.mjs";
@@ -32,10 +35,13 @@ export * from "./PricingMetricResource.mjs";
 export * from "./PricingMetricSummaryResource.mjs";
 export * from "./RateCardResourceUsageBasedRatesItem.mjs";
 export * from "./RateCardResource.mjs";
+export * from "./RequiresActionResponse.mjs";
 export * from "./SimpleUsageBasedRateInterface.mjs";
 export * from "./SubjectResource.mjs";
 export * from "./SubscriptionResource.mjs";
+export * from "./SuccessResponse.mjs";
 export * from "./SumAggregationPricingMetricInterface.mjs";
 export * from "./SumAggregationPricingMetricResource.mjs";
 export * from "./UsageDataForRate.mjs";
 export * from "./ValidationError.mjs";
+export * from "./CheckoutCallback.mjs";

package/dist/esm/api/types/index.mjs

@@ -1,6 +1,9 @@
 export * from "./ActiveSubscription.mjs";
 export * from "./Amount.mjs";
 export * from "./BillingStateResponse.mjs";
+export * from "./Result.mjs";
+export * from "./ChangeSubscriptionRateCardResponse.mjs";
+export * from "./CheckoutAction.mjs";
 export * from "./CountAggregationPricingMetricInterface.mjs";
 export * from "./CountAggregationPricingMetricResource.mjs";
 export * from "./CreateCustomerPortalSessionResponse.mjs";
@@ -32,10 +35,13 @@ export * from "./PricingMetricResource.mjs";
 export * from "./PricingMetricSummaryResource.mjs";
 export * from "./RateCardResourceUsageBasedRatesItem.mjs";
 export * from "./RateCardResource.mjs";
+export * from "./RequiresActionResponse.mjs";
 export * from "./SimpleUsageBasedRateInterface.mjs";
 export * from "./SubjectResource.mjs";
 export * from "./SubscriptionResource.mjs";
+export * from "./SuccessResponse.mjs";
 export * from "./SumAggregationPricingMetricInterface.mjs";
 export * from "./SumAggregationPricingMetricResource.mjs";
 export * from "./UsageDataForRate.mjs";
 export * from "./ValidationError.mjs";
+export * from "./CheckoutCallback.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.1";
+export declare const SDK_VERSION = "0.1.3";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.1";
+export const SDK_VERSION = "0.1.3";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lark-billing",
-    "version": "0.1.1",
+    "version": "0.1.3",
     "private": false,
     "repository": "github:fern-demo/lark-ts-sdk",
     "type": "commonjs",

package/reference.md

@@ -18,7 +18,10 @@
 await client.checkout.createSubscriptionCheckoutSession({
     subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
     rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
-    success_callback_url: "https://example.com/callback",
+    checkout_callback_urls: {
+        cancelled_url: "https://example.com/callback",
+        success_url: "https://example.com/callback",
+    },
 });
 ```
 
@@ -303,10 +306,10 @@ await client.rateCards.getRateCard("rate_card_id");
 
 ```typescript
 await client.usageEvents.createUsageEvent({
-    idempotency_key: "f283b3d1-41b2-43b1-9d00-dd7935cb6263",
+    idempotency_key: "cdd158d3-c865-4dc3-a652-053d81906a30",
     event_name: "compute_hours",
     subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE",
-    timestamp: "2025-11-03T18:37:02Z",
+    timestamp: "2025-11-06T20:22:47Z",
     data: {
         compute_hours: 100,
         instance_type: "t2.micro",
@@ -556,7 +559,7 @@ await client.subscriptions.cancelSubscription("subscription_id");
 </dl>
 </details>
 
-<details><summary><code>client.subscriptions.<a href="/src/api/resources/subscriptions/client/Client.ts">changeSubscriptionRateCard</a>(subscriptionId, { ...params }) -> Lark.SubscriptionResource</code></summary>
+<details><summary><code>client.subscriptions.<a href="/src/api/resources/subscriptions/client/Client.ts">changeSubscriptionRateCard</a>(subscriptionId, { ...params }) -> Lark.ChangeSubscriptionRateCardResponse</code></summary>
 <dl>
 <dd>
 
@@ -571,6 +574,10 @@ await client.subscriptions.cancelSubscription("subscription_id");
 ```typescript
 await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
     rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g",
+    checkout_callback_urls: {
+        cancelled_url: "https://example.com/callback",
+        success_url: "https://example.com/callback",
+    },
 });
 ```