lark-billing 0.0.7 → 0.0.8

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

@@ -1,12 +1,14 @@
+export * as rateCards from "./rateCards/index.mjs";
+export * from "./rateCards/types/index.mjs";
 export * as pricingMetrics from "./pricingMetrics/index.mjs";
 export * from "./pricingMetrics/types/index.mjs";
 export * as checkout from "./checkout/index.mjs";
 export * as customerPortal from "./customerPortal/index.mjs";
-export * as rateCards from "./rateCards/index.mjs";
 export * as usageEvents from "./usageEvents/index.mjs";
 export * as subscriptions from "./subscriptions/index.mjs";
 export * as subjects from "./subjects/index.mjs";
 export * as customerAccess from "./customerAccess/index.mjs";
+export * as invoices from "./invoices/index.mjs";
 export * from "./checkout/client/requests/index.mjs";
 export * from "./customerPortal/client/requests/index.mjs";
 export * from "./rateCards/client/requests/index.mjs";
@@ -14,3 +16,4 @@ export * from "./usageEvents/client/requests/index.mjs";
 export * from "./subscriptions/client/requests/index.mjs";
 export * from "./subjects/client/requests/index.mjs";
 export * from "./pricingMetrics/client/requests/index.mjs";
+export * from "./invoices/client/requests/index.mjs";

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

@@ -1,12 +1,14 @@
+export * as rateCards from "./rateCards/index.mjs";
+export * from "./rateCards/types/index.mjs";
 export * as pricingMetrics from "./pricingMetrics/index.mjs";
 export * from "./pricingMetrics/types/index.mjs";
 export * as checkout from "./checkout/index.mjs";
 export * as customerPortal from "./customerPortal/index.mjs";
-export * as rateCards from "./rateCards/index.mjs";
 export * as usageEvents from "./usageEvents/index.mjs";
 export * as subscriptions from "./subscriptions/index.mjs";
 export * as subjects from "./subjects/index.mjs";
 export * as customerAccess from "./customerAccess/index.mjs";
+export * as invoices from "./invoices/index.mjs";
 export * from "./checkout/client/requests/index.mjs";
 export * from "./customerPortal/client/requests/index.mjs";
 export * from "./rateCards/client/requests/index.mjs";
@@ -14,3 +16,4 @@ export * from "./usageEvents/client/requests/index.mjs";
 export * from "./subscriptions/client/requests/index.mjs";
 export * from "./subjects/client/requests/index.mjs";
 export * from "./pricingMetrics/client/requests/index.mjs";
+export * from "./invoices/client/requests/index.mjs";

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

@@ -0,0 +1,50 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Lark from "../../../index.mjs";
+export declare namespace Invoices {
+    interface Options {
+        environment?: core.Supplier<environments.LarkEnvironment | string>;
+        /** Specify a custom URL to connect the client to. */
+        baseUrl?: core.Supplier<string>;
+        apiKey: core.Supplier<string>;
+        /** Additional headers to include in requests. */
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    }
+    interface RequestOptions {
+        /** The maximum time to wait for a response in seconds. */
+        timeoutInSeconds?: number;
+        /** The number of times to retry the request. Defaults to 2. */
+        maxRetries?: number;
+        /** A hook to abort the request. */
+        abortSignal?: AbortSignal;
+        /** Additional query string parameters to include in the request. */
+        queryParams?: Record<string, unknown>;
+        /** Additional headers to include in the request. */
+        headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
+    }
+}
+export declare class Invoices {
+    protected readonly _options: Invoices.Options;
+    constructor(_options: Invoices.Options);
+    /**
+     * @param {Lark.ListInvoicesInvoicesGetRequest} request
+     * @param {Invoices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.invoices.listInvoices({
+     *         subject_id: "subject_id",
+     *         limit: 1,
+     *         offset: 1
+     *     })
+     */
+    listInvoices(request: Lark.ListInvoicesInvoicesGetRequest, requestOptions?: Invoices.RequestOptions): core.HttpResponsePromise<Lark.ListInvoicesResponse>;
+    private __listInvoices;
+    protected _getCustomAuthorizationHeaders(): Promise<{
+        "X-API-Key": string;
+    }>;
+}

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

@@ -0,0 +1,98 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as environments from "../../../../environments.mjs";
+import * as core from "../../../../core/index.mjs";
+import * as Lark from "../../../index.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
+import * as errors from "../../../../errors/index.mjs";
+export class Invoices {
+    constructor(_options) {
+        this._options = _options;
+    }
+    /**
+     * @param {Lark.ListInvoicesInvoicesGetRequest} request
+     * @param {Invoices.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.invoices.listInvoices({
+     *         subject_id: "subject_id",
+     *         limit: 1,
+     *         offset: 1
+     *     })
+     */
+    listInvoices(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listInvoices(request, requestOptions));
+    }
+    __listInvoices(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const { subject_id: subjectId, limit, offset } = request;
+            const _queryParams = {};
+            _queryParams["subject_id"] = subjectId;
+            if (limit != null) {
+                _queryParams["limit"] = limit.toString();
+            }
+            if (offset != null) {
+                _queryParams["offset"] = offset.toString();
+            }
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LarkEnvironment.Default, "invoices"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Lark.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.LarkError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.LarkError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.LarkTimeoutError("Timeout exceeded when calling GET /invoices.");
+                case "unknown":
+                    throw new errors.LarkError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    _getCustomAuthorizationHeaders() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apiKeyValue = yield core.Supplier.get(this._options.apiKey);
+            return { "X-API-Key": apiKeyValue };
+        });
+    }
+}

package/dist/esm/api/resources/invoices/client/index.d.mts

@@ -0,0 +1,2 @@
+export {};
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/invoices/client/index.mjs

@@ -0,0 +1 @@
+export * from "./requests/index.mjs";

package/dist/esm/api/resources/invoices/client/requests/ListInvoicesInvoicesGetRequest.d.mts

@@ -0,0 +1,17 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         subject_id: "subject_id",
+ *         limit: 1,
+ *         offset: 1
+ *     }
+ */
+export interface ListInvoicesInvoicesGetRequest {
+    /** The ID of the subject to list invoices for. */
+    subject_id: string;
+    limit?: number;
+    offset?: number;
+}

package/dist/esm/api/resources/invoices/client/requests/index.d.mts

@@ -0,0 +1 @@
+export { type ListInvoicesInvoicesGetRequest } from "./ListInvoicesInvoicesGetRequest.mjs";

package/dist/esm/api/resources/invoices/client/requests/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/esm/api/resources/invoices/index.d.mts

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

package/dist/esm/api/resources/invoices/index.mjs

@@ -0,0 +1 @@
+export * from "./client/index.mjs";

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

@@ -29,6 +29,19 @@ export declare namespace PricingMetrics {
 export declare class PricingMetrics {
     protected readonly _options: PricingMetrics.Options;
     constructor(_options: PricingMetrics.Options);
+    /**
+     * @param {Lark.ListPricingMetricsPricingMetricsGetRequest} request
+     * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.pricingMetrics.listPricingMetrics({
+     *         limit: 1
+     *     })
+     */
+    listPricingMetrics(request?: Lark.ListPricingMetricsPricingMetricsGetRequest, requestOptions?: PricingMetrics.RequestOptions): core.HttpResponsePromise<Lark.ListPricingMetricsResponse>;
+    private __listPricingMetrics;
     /**
      * @param {Lark.CreatePricingMetricRequest} request
      * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.

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

@@ -19,6 +19,70 @@ export class PricingMetrics {
     constructor(_options) {
         this._options = _options;
     }
+    /**
+     * @param {Lark.ListPricingMetricsPricingMetricsGetRequest} request
+     * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.pricingMetrics.listPricingMetrics({
+     *         limit: 1
+     *     })
+     */
+    listPricingMetrics(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listPricingMetrics(request, requestOptions));
+    }
+    __listPricingMetrics() {
+        return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
+            var _a, _b, _c;
+            const { limit } = request;
+            const _queryParams = {};
+            if (limit != null) {
+                _queryParams["limit"] = limit.toString();
+            }
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LarkEnvironment.Default, "pricing-metrics"),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Lark.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.LarkError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.LarkError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.LarkTimeoutError("Timeout exceeded when calling GET /pricing-metrics.");
+                case "unknown":
+                    throw new errors.LarkError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * @param {Lark.CreatePricingMetricRequest} request
      * @param {PricingMetrics.RequestOptions} requestOptions - Request-specific configuration.

package/dist/esm/api/resources/pricingMetrics/client/requests/ListPricingMetricsPricingMetricsGetRequest.d.mts

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         limit: 1
+ *     }
+ */
+export interface ListPricingMetricsPricingMetricsGetRequest {
+    limit?: number;
+}

package/dist/esm/api/resources/pricingMetrics/client/requests/index.d.mts

@@ -1 +1,2 @@
+export { type ListPricingMetricsPricingMetricsGetRequest } from "./ListPricingMetricsPricingMetricsGetRequest.mjs";
 export { type CreatePricingMetricRequest } from "./CreatePricingMetricRequest.mjs";

package/dist/esm/api/resources/rateCards/client/requests/CreateRateCardRequest.d.mts

@@ -12,8 +12,8 @@ import * as Lark from "../../../../index.mjs";
 export interface CreateRateCardRequest {
     name: string;
     description?: string;
-    usage_based_rates?: Lark.CreateSimpleUsageBasedRateInterface[];
-    fixed_rates?: Lark.CreateFixedRateInterface[];
+    usage_based_rates?: Lark.CreateRateCardRequestUsageBasedRatesItem[];
+    fixed_rates?: Lark.CreateFixedRateRequest[];
     billing_interval: CreateRateCardRequest.BillingInterval;
     metadata?: Record<string, string>;
 }

package/dist/esm/api/resources/rateCards/index.d.mts

@@ -1 +1,2 @@
+export * from "./types/index.mjs";
 export * from "./client/index.mjs";

package/dist/esm/api/resources/rateCards/index.mjs

@@ -1 +1,2 @@
+export * from "./types/index.mjs";
 export * from "./client/index.mjs";

package/dist/esm/api/resources/rateCards/types/CreateRateCardRequestUsageBasedRatesItem.d.mts

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../../../index.mjs";
+export type CreateRateCardRequestUsageBasedRatesItem = Lark.CreateRateCardRequestUsageBasedRatesItem.Simple;
+export declare namespace CreateRateCardRequestUsageBasedRatesItem {
+    interface Simple extends Lark.CreateSimpleUsageBasedRateRequest {
+        usage_based_rate_type: "simple";
+    }
+}

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

@@ -0,0 +1 @@
+export * from "./CreateRateCardRequestUsageBasedRatesItem.mjs";

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

@@ -0,0 +1 @@
+export * from "./CreateRateCardRequestUsageBasedRatesItem.mjs";

package/dist/esm/api/resources/subjects/client/requests/CreateSubjectRequest.d.mts

@@ -6,8 +6,12 @@
  *     {}
  */
 export interface CreateSubjectRequest {
+    /** The ID of the subject in your system. If provided, you may use pass it to the API in place of the subject ID. Must be unique. */
     external_id?: string;
+    /** The name of the subject. Used for display in the dashboard. */
     name?: string;
+    /** The email of the subject. Must be a valid email address. */
     email?: string;
+    /** Additional metadata about the subject. You may use this to store any custom data about the subject. */
     metadata?: Record<string, string>;
 }

package/dist/esm/api/resources/subjects/client/requests/UpdateSubjectRequest.d.mts

@@ -6,8 +6,10 @@
  *     {}
  */
 export interface UpdateSubjectRequest {
-    external_id?: string;
+    /** The name of the subject. Used for display in the dashboard. */
     name?: string;
+    /** The email of the subject. Must be a valid email address. */
     email?: string;
+    /** Additional metadata about the subject. You may use this to store any custom data about the subject. */
     metadata?: Record<string, string | undefined>;
 }

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

@@ -52,8 +52,8 @@ export declare class Subscriptions {
      *
      * @example
      *     await client.subscriptions.createSubscription({
-     *         rate_card_id: "rate_card_id",
-     *         subject_id: "subject_id"
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
+     *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE"
      *     })
      */
     createSubscription(request: Lark.CreateSubscriptionRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
@@ -69,6 +69,32 @@ export declare class Subscriptions {
      */
     getSubscription(subscriptionId: string, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
     private __getSubscription;
+    /**
+     * @param {string} subscriptionId
+     * @param {Lark.CancelSubscriptionRequest} request
+     * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.subscriptions.cancelSubscription("subscription_id")
+     */
+    cancelSubscription(subscriptionId: string, request?: Lark.CancelSubscriptionRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
+    private __cancelSubscription;
+    /**
+     * @param {string} subscriptionId
+     * @param {Lark.ChangeSubscriptionRateCardRequest} request
+     * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB"
+     *     })
+     */
+    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
+    private __changeSubscriptionRateCard;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "X-API-Key": string;
     }>;

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

@@ -99,8 +99,8 @@ export class Subscriptions {
      *
      * @example
      *     await client.subscriptions.createSubscription({
-     *         rate_card_id: "rate_card_id",
-     *         subject_id: "subject_id"
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
+     *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE"
      *     })
      */
     createSubscription(request, requestOptions) {
@@ -211,6 +211,130 @@ export class Subscriptions {
             }
         });
     }
+    /**
+     * @param {string} subscriptionId
+     * @param {Lark.CancelSubscriptionRequest} request
+     * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.subscriptions.cancelSubscription("subscription_id")
+     */
+    cancelSubscription(subscriptionId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancelSubscription(subscriptionId, request, requestOptions));
+    }
+    __cancelSubscription(subscriptionId_1) {
+        return __awaiter(this, arguments, void 0, function* (subscriptionId, request = {}, requestOptions) {
+            var _a, _b, _c;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LarkEnvironment.Default, `subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Lark.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.LarkError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.LarkError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.LarkTimeoutError("Timeout exceeded when calling POST /subscriptions/{subscription_id}/cancel.");
+                case "unknown":
+                    throw new errors.LarkError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * @param {string} subscriptionId
+     * @param {Lark.ChangeSubscriptionRateCardRequest} request
+     * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB"
+     *     })
+     */
+    changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__changeSubscriptionRateCard(subscriptionId, request, requestOptions));
+    }
+    __changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.LarkEnvironment.Default, `subscriptions/${encodeURIComponent(subscriptionId)}/change-rate-card`),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 422:
+                        throw new Lark.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.LarkError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.LarkError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.LarkTimeoutError("Timeout exceeded when calling POST /subscriptions/{subscription_id}/change-rate-card.");
+                case "unknown":
+                    throw new errors.LarkError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const apiKeyValue = yield core.Supplier.get(this._options.apiKey);

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {}
+ */
+export interface CancelSubscriptionRequest {
+    /** The reason for cancelling the subscription. */
+    reason?: string;
+    /** Whether to cancel the subscription at end of cycle. */
+    cancel_at_end_of_cycle?: boolean;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB"
+ *     }
+ */
+export interface ChangeSubscriptionRateCardRequest {
+    rate_card_id: string;
+}

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

@@ -4,12 +4,15 @@
 /**
  * @example
  *     {
- *         rate_card_id: "rate_card_id",
- *         subject_id: "subject_id"
+ *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
+ *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE"
  *     }
  */
 export interface CreateSubscriptionRequest {
+    /** The ID of the rate card to use for the subscription. */
     rate_card_id: string;
+    /** The ID of the subject to create the subscription for. */
     subject_id: string;
-    metadata?: Record<string, string | undefined>;
+    /** Additional metadata about the subscription. You may use this to store any custom data about the subscription. */
+    metadata?: Record<string, string>;
 }

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

@@ -1,2 +1,4 @@
 export { type ListSubscriptionsSubscriptionsGetRequest } from "./ListSubscriptionsSubscriptionsGetRequest.mjs";
 export { type CreateSubscriptionRequest } from "./CreateSubscriptionRequest.mjs";
+export { type CancelSubscriptionRequest } from "./CancelSubscriptionRequest.mjs";
+export { type ChangeSubscriptionRateCardRequest } from "./ChangeSubscriptionRateCardRequest.mjs";