lark-billing 0.0.6 → 0.0.8

package/dist/{esm/api/resources/rateCards/client/requests/RateCardsListRateCardsRequest.d.mts → cjs/api/resources/rateCards/client/requests/ListRateCardsRateCardsGetRequest.d.ts}

@@ -4,11 +4,9 @@
 /**
  * @example
  *     {
- *         limit: 1,
- *         offset: 1
+ *         limit: 1
  *     }
  */
-export interface RateCardsListRateCardsRequest {
+export interface ListRateCardsRateCardsGetRequest {
     limit?: number;
-    offset?: number;
 }

package/dist/cjs/api/resources/rateCards/client/requests/index.d.ts

@@ -1,3 +1,2 @@
-export { type RateCardsListRateCardsRequest } from "./RateCardsListRateCardsRequest.js";
+export { type ListRateCardsRateCardsGetRequest } from "./ListRateCardsRateCardsGetRequest.js";
 export { type CreateRateCardRequest } from "./CreateRateCardRequest.js";
-export { type CreateRateCardVersionRequest } from "./CreateRateCardVersionRequest.js";

package/dist/cjs/api/resources/rateCards/types/CreateRateCardRequestUsageBasedRatesItem.d.ts

@@ -2,12 +2,9 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Lark from "../../../index.js";
-export type CreateRateCardRequestUsageBasedRatesItem = Lark.CreateRateCardRequestUsageBasedRatesItem.Dimensional | Lark.CreateRateCardRequestUsageBasedRatesItem.Simple;
+export type CreateRateCardRequestUsageBasedRatesItem = Lark.CreateRateCardRequestUsageBasedRatesItem.Simple;
 export declare namespace CreateRateCardRequestUsageBasedRatesItem {
-    interface Dimensional extends Lark.CreateDimensionalUsageBasedRateInterface {
-        usage_based_rate_type: "dimensional";
-    }
-    interface Simple extends Lark.CreateSimpleUsageBasedRateInterface {
+    interface Simple extends Lark.CreateSimpleUsageBasedRateRequest {
         usage_based_rate_type: "simple";
     }
 }

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

@@ -1,2 +1 @@
 export * from "./CreateRateCardRequestUsageBasedRatesItem.js";
-export * from "./CreateRateCardVersionRequestUsageBasedRatesItem.js";

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

@@ -15,4 +15,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./CreateRateCardRequestUsageBasedRatesItem.js"), exports);
-__exportStar(require("./CreateRateCardVersionRequestUsageBasedRatesItem.js"), exports);

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

@@ -1,14 +1,15 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as environments from "../../../../environments.js";
 import * as core from "../../../../core/index.js";
 import * as Lark from "../../../index.js";
 export declare namespace Subjects {
     interface Options {
-        environment: core.Supplier<string>;
+        environment?: core.Supplier<environments.LarkEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        apiKey?: core.Supplier<string | undefined>;
+        apiKey: core.Supplier<string>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
@@ -29,7 +30,7 @@ export declare class Subjects {
     protected readonly _options: Subjects.Options;
     constructor(_options: Subjects.Options);
     /**
-     * @param {Lark.SubjectsListSubjectsRequest} request
+     * @param {Lark.ListSubjectsSubjectsGetRequest} request
      * @param {Subjects.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -40,7 +41,7 @@ export declare class Subjects {
      *         offset: 1
      *     })
      */
-    listSubjects(request?: Lark.SubjectsListSubjectsRequest, requestOptions?: Subjects.RequestOptions): core.HttpResponsePromise<Lark.ListSubjectsResponse>;
+    listSubjects(request?: Lark.ListSubjectsSubjectsGetRequest, requestOptions?: Subjects.RequestOptions): core.HttpResponsePromise<Lark.ListSubjectsResponse>;
     private __listSubjects;
     /**
      * @param {Lark.CreateSubjectRequest} request
@@ -88,6 +89,6 @@ export declare class Subjects {
     deleteSubject(subjectId: string, requestOptions?: Subjects.RequestOptions): core.HttpResponsePromise<unknown>;
     private __deleteSubject;
     protected _getCustomAuthorizationHeaders(): Promise<{
-        "X-API-Key": string | undefined;
+        "X-API-Key": string;
     }>;
 }

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

@@ -46,6 +46,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Subjects = void 0;
+const environments = __importStar(require("../../../../environments.js"));
 const core = __importStar(require("../../../../core/index.js"));
 const Lark = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
@@ -55,7 +56,7 @@ class Subjects {
         this._options = _options;
     }
     /**
-     * @param {Lark.SubjectsListSubjectsRequest} request
+     * @param {Lark.ListSubjectsSubjectsGetRequest} request
      * @param {Subjects.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -71,7 +72,7 @@ class Subjects {
     }
     __listSubjects() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b;
+            var _a, _b, _c;
             const { limit, offset } = request;
             const _queryParams = {};
             if (limit != null) {
@@ -82,7 +83,7 @@ class Subjects {
             }
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), "subjects"),
+                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, "subjects"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -136,10 +137,10 @@ class Subjects {
     }
     __createSubject() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), "subjects"),
+                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, "subjects"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -196,10 +197,10 @@ class Subjects {
     }
     __getSubject(subjectId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subjects/${encodeURIComponent(subjectId)}`),
+                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, `subjects/${encodeURIComponent(subjectId)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -254,10 +255,10 @@ class Subjects {
     }
     __updateSubject(subjectId_1) {
         return __awaiter(this, arguments, void 0, function* (subjectId, request = {}, requestOptions) {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subjects/${encodeURIComponent(subjectId)}`),
+                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, `subjects/${encodeURIComponent(subjectId)}`),
                 method: "PUT",
                 headers: _headers,
                 contentType: "application/json",
@@ -314,10 +315,10 @@ class Subjects {
     }
     __deleteSubject(subjectId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subjects/${encodeURIComponent(subjectId)}`),
+                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, `subjects/${encodeURIComponent(subjectId)}`),
                 method: "DELETE",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,

package/dist/cjs/api/resources/subjects/client/requests/CreateSubjectRequest.d.ts

@@ -6,9 +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;
-    parent_subject_id?: string;
+    /** Additional metadata about the subject. You may use this to store any custom data about the subject. */
     metadata?: Record<string, string>;
 }

package/dist/cjs/api/resources/subjects/client/requests/{SubjectsListSubjectsRequest.d.ts → ListSubjectsSubjectsGetRequest.d.ts}

@@ -8,7 +8,7 @@
  *         offset: 1
  *     }
  */
-export interface SubjectsListSubjectsRequest {
+export interface ListSubjectsSubjectsGetRequest {
     limit?: number;
     offset?: number;
 }

package/dist/cjs/api/resources/subjects/client/requests/UpdateSubjectRequest.d.ts

@@ -6,9 +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;
-    parent_subject_id?: 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/cjs/api/resources/subjects/client/requests/index.d.ts

@@ -1,3 +1,3 @@
-export { type SubjectsListSubjectsRequest } from "./SubjectsListSubjectsRequest.js";
+export { type ListSubjectsSubjectsGetRequest } from "./ListSubjectsSubjectsGetRequest.js";
 export { type CreateSubjectRequest } from "./CreateSubjectRequest.js";
 export { type UpdateSubjectRequest } from "./UpdateSubjectRequest.js";

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

@@ -1,14 +1,15 @@
 /**
  * This file was auto-generated by Fern from our API Definition.
  */
+import * as environments from "../../../../environments.js";
 import * as core from "../../../../core/index.js";
 import * as Lark from "../../../index.js";
 export declare namespace Subscriptions {
     interface Options {
-        environment: core.Supplier<string>;
+        environment?: core.Supplier<environments.LarkEnvironment | string>;
         /** Specify a custom URL to connect the client to. */
         baseUrl?: core.Supplier<string>;
-        apiKey?: core.Supplier<string | undefined>;
+        apiKey: core.Supplier<string>;
         /** Additional headers to include in requests. */
         headers?: Record<string, string | core.Supplier<string | null | undefined> | null | undefined>;
     }
@@ -29,7 +30,7 @@ export declare class Subscriptions {
     protected readonly _options: Subscriptions.Options;
     constructor(_options: Subscriptions.Options);
     /**
-     * @param {Lark.SubscriptionsListSubscriptionsRequest} request
+     * @param {Lark.ListSubscriptionsSubscriptionsGetRequest} request
      * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -37,10 +38,11 @@ export declare class Subscriptions {
      * @example
      *     await client.subscriptions.listSubscriptions({
      *         limit: 1,
-     *         offset: 1
+     *         subject_id: "subject_id",
+     *         rate_card_id: "rate_card_id"
      *     })
      */
-    listSubscriptions(request?: Lark.SubscriptionsListSubscriptionsRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.ListSubscriptionsResponse>;
+    listSubscriptions(request?: Lark.ListSubscriptionsSubscriptionsGetRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.ListSubscriptionsResponse>;
     private __listSubscriptions;
     /**
      * @param {Lark.CreateSubscriptionRequest} request
@@ -50,9 +52,8 @@ export declare class Subscriptions {
      *
      * @example
      *     await client.subscriptions.createSubscription({
-     *         rate_card_id: "rate_card_id",
-     *         subject_id: "subject_id",
-     *         effective_at: "2024-01-15T09:30:00Z"
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
+     *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE"
      *     })
      */
     createSubscription(request: Lark.CreateSubscriptionRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
@@ -70,23 +71,31 @@ export declare class Subscriptions {
     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, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<void>;
+    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.updateSubscription("subscription_id")
+     *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB"
+     *     })
      */
-    updateSubscription(subscriptionId: string, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<void>;
-    private __updateSubscription;
+    changeSubscriptionRateCard(subscriptionId: string, request: Lark.ChangeSubscriptionRateCardRequest, requestOptions?: Subscriptions.RequestOptions): core.HttpResponsePromise<Lark.SubscriptionResource>;
+    private __changeSubscriptionRateCard;
     protected _getCustomAuthorizationHeaders(): Promise<{
-        "X-API-Key": string | undefined;
+        "X-API-Key": string;
     }>;
 }

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

@@ -46,6 +46,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Subscriptions = void 0;
+const environments = __importStar(require("../../../../environments.js"));
 const core = __importStar(require("../../../../core/index.js"));
 const Lark = __importStar(require("../../../index.js"));
 const headers_js_1 = require("../../../../core/headers.js");
@@ -55,7 +56,7 @@ class Subscriptions {
         this._options = _options;
     }
     /**
-     * @param {Lark.SubscriptionsListSubscriptionsRequest} request
+     * @param {Lark.ListSubscriptionsSubscriptionsGetRequest} request
      * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -63,7 +64,8 @@ class Subscriptions {
      * @example
      *     await client.subscriptions.listSubscriptions({
      *         limit: 1,
-     *         offset: 1
+     *         subject_id: "subject_id",
+     *         rate_card_id: "rate_card_id"
      *     })
      */
     listSubscriptions(request = {}, requestOptions) {
@@ -71,18 +73,21 @@ class Subscriptions {
     }
     __listSubscriptions() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b;
-            const { limit, offset } = request;
+            var _a, _b, _c;
+            const { limit, subject_id: subjectId, rate_card_id: rateCardId } = request;
             const _queryParams = {};
             if (limit != null) {
                 _queryParams["limit"] = limit.toString();
             }
-            if (offset != null) {
-                _queryParams["offset"] = offset.toString();
+            if (subjectId != null) {
+                _queryParams["subject_id"] = subjectId;
+            }
+            if (rateCardId != null) {
+                _queryParams["rate_card_id"] = rateCardId;
             }
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), "subscriptions"),
+                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"),
                 method: "GET",
                 headers: _headers,
                 queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
@@ -130,9 +135,8 @@ class Subscriptions {
      *
      * @example
      *     await client.subscriptions.createSubscription({
-     *         rate_card_id: "rate_card_id",
-     *         subject_id: "subject_id",
-     *         effective_at: "2024-01-15T09:30:00Z"
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB",
+     *         subject_id: "subj_VyX6Q96h5avMho8O7QWlKeXE"
      *     })
      */
     createSubscription(request, requestOptions) {
@@ -140,10 +144,10 @@ class Subscriptions {
     }
     __createSubscription(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), "subscriptions"),
+                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"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -200,10 +204,10 @@ class Subscriptions {
     }
     __getSubscription(subscriptionId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subscriptions/${encodeURIComponent(subscriptionId)}`),
+                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)}`),
                 method: "GET",
                 headers: _headers,
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
@@ -245,36 +249,47 @@ 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, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__cancelSubscription(subscriptionId, requestOptions));
+    cancelSubscription(subscriptionId, request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__cancelSubscription(subscriptionId, request, requestOptions));
     }
-    __cancelSubscription(subscriptionId, requestOptions) {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+    __cancelSubscription(subscriptionId_1) {
+        return __awaiter(this, arguments, void 0, function* (subscriptionId, request = {}, requestOptions) {
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subscriptions/${encodeURIComponent(subscriptionId)}`),
-                method: "DELETE",
+                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: undefined, rawResponse: _response.rawResponse };
+                return { data: _response.body, rawResponse: _response.rawResponse };
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.LarkError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                    rawResponse: _response.rawResponse,
-                });
+                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":
@@ -284,7 +299,7 @@ class Subscriptions {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.LarkTimeoutError("Timeout exceeded when calling DELETE /subscriptions/{subscription_id}.");
+                    throw new errors.LarkTimeoutError("Timeout exceeded when calling POST /subscriptions/{subscription_id}/cancel.");
                 case "unknown":
                     throw new errors.LarkError({
                         message: _response.error.errorMessage,
@@ -295,36 +310,49 @@ class Subscriptions {
     }
     /**
      * @param {string} subscriptionId
+     * @param {Lark.ChangeSubscriptionRateCardRequest} request
      * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
      *
+     * @throws {@link Lark.UnprocessableEntityError}
+     *
      * @example
-     *     await client.subscriptions.updateSubscription("subscription_id")
+     *     await client.subscriptions.changeSubscriptionRateCard("subscription_id", {
+     *         rate_card_id: "rc_AJWMxR81jxoRlli6p13uf3JB"
+     *     })
      */
-    updateSubscription(subscriptionId, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__updateSubscription(subscriptionId, requestOptions));
+    changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__changeSubscriptionRateCard(subscriptionId, request, requestOptions));
     }
-    __updateSubscription(subscriptionId, requestOptions) {
+    __changeSubscriptionRateCard(subscriptionId, request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c;
             let _headers = (0, headers_js_1.mergeHeaders)((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.mergeOnlyDefinedHeaders)(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield core.fetcher({
-                url: core.url.join((_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment)), `subscriptions/${encodeURIComponent(subscriptionId)}`),
-                method: "PATCH",
+                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: undefined, rawResponse: _response.rawResponse };
+                return { data: _response.body, rawResponse: _response.rawResponse };
             }
             if (_response.error.reason === "status-code") {
-                throw new errors.LarkError({
-                    statusCode: _response.error.statusCode,
-                    body: _response.error.body,
-                    rawResponse: _response.rawResponse,
-                });
+                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":
@@ -334,7 +362,7 @@ class Subscriptions {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.LarkTimeoutError("Timeout exceeded when calling PATCH /subscriptions/{subscription_id}.");
+                    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,

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

@@ -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/cjs/api/resources/subscriptions/client/requests/ChangeSubscriptionRateCardRequest.d.ts

@@ -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/cjs/api/resources/subscriptions/client/requests/CreateSubscriptionRequest.d.ts

@@ -4,15 +4,15 @@
 /**
  * @example
  *     {
- *         rate_card_id: "rate_card_id",
- *         subject_id: "subject_id",
- *         effective_at: "2024-01-15T09:30:00Z"
+ *         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;
-    effective_at: string;
-    variables?: Record<string, string | undefined>;
-    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/cjs/api/resources/subscriptions/client/requests/ListSubscriptionsSubscriptionsGetRequest.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         limit: 1,
+ *         subject_id: "subject_id",
+ *         rate_card_id: "rate_card_id"
+ *     }
+ */
+export interface ListSubscriptionsSubscriptionsGetRequest {
+    limit?: number;
+    /** The ID of the subject to list subscriptions for. Cannot be used with rate_card_id. */
+    subject_id?: string;
+    /** The ID of the rate card to list subscriptions for. Cannot be used with subject_id. */
+    rate_card_id?: string;
+}

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

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