lark-billing 0.0.6 → 0.0.8

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

@@ -1,14 +1,15 @@
 /**
  * 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 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/esm/api/resources/subjects/client/Client.mjs

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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";
@@ -19,7 +20,7 @@ export class Subjects {
         this._options = _options;
     }
     /**
-     * @param {Lark.SubjectsListSubjectsRequest} request
+     * @param {Lark.ListSubjectsSubjectsGetRequest} request
      * @param {Subjects.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -35,7 +36,7 @@ export 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) {
@@ -46,7 +47,7 @@ export class Subjects {
             }
             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((_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),
@@ -100,10 +101,10 @@ export class Subjects {
     }
     __createSubject() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
-            var _a, _b;
+            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((_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",
@@ -160,10 +161,10 @@ export class Subjects {
     }
     __getSubject(subjectId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            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((_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,
@@ -218,10 +219,10 @@ export class Subjects {
     }
     __updateSubject(subjectId_1) {
         return __awaiter(this, arguments, void 0, function* (subjectId, request = {}, requestOptions) {
-            var _a, _b;
+            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((_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",
@@ -278,10 +279,10 @@ export class Subjects {
     }
     __deleteSubject(subjectId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            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((_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/esm/api/resources/subjects/client/requests/CreateSubjectRequest.d.mts

@@ -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/rateCards/client/requests/RateCardsListRateCardsRequest.d.ts → esm/api/resources/subjects/client/requests/ListSubjectsSubjectsGetRequest.d.mts}

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

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

@@ -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/esm/api/resources/subjects/client/requests/index.d.mts

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

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

@@ -1,14 +1,15 @@
 /**
  * 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 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/esm/api/resources/subscriptions/client/Client.mjs

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         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";
@@ -19,7 +20,7 @@ export class Subscriptions {
         this._options = _options;
     }
     /**
-     * @param {Lark.SubscriptionsListSubscriptionsRequest} request
+     * @param {Lark.ListSubscriptionsSubscriptionsGetRequest} request
      * @param {Subscriptions.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Lark.UnprocessableEntityError}
@@ -27,7 +28,8 @@ export class Subscriptions {
      * @example
      *     await client.subscriptions.listSubscriptions({
      *         limit: 1,
-     *         offset: 1
+     *         subject_id: "subject_id",
+     *         rate_card_id: "rate_card_id"
      *     })
      */
     listSubscriptions(request = {}, requestOptions) {
@@ -35,18 +37,21 @@ export 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 = 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((_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),
@@ -94,9 +99,8 @@ export 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) {
@@ -104,10 +108,10 @@ export class Subscriptions {
     }
     __createSubscription(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            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((_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",
@@ -164,10 +168,10 @@ export class Subscriptions {
     }
     __getSubscription(subscriptionId, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            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((_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,
@@ -209,36 +213,47 @@ 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, 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 = 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((_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":
@@ -248,7 +263,7 @@ export 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,
@@ -259,36 +274,49 @@ export 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 = 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((_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":
@@ -298,7 +326,7 @@ export 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/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,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/esm/api/resources/subscriptions/client/requests/ListSubscriptionsSubscriptionsGetRequest.d.mts

@@ -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/esm/api/resources/subscriptions/client/requests/index.d.mts

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

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

@@ -1,14 +1,15 @@
 /**
  * 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 UsageEvents {
     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>;
     }
@@ -39,7 +40,6 @@ export declare class UsageEvents {
      *         idempotency_key: "idempotency_key",
      *         event_name: "event_name",
      *         subject_id: "subject_id",
-     *         timestamp: "2024-01-15T09:30:00Z",
      *         data: {
      *             "key": "value"
      *         }
@@ -67,6 +67,6 @@ export declare class UsageEvents {
     createUsageEventSummary(request: Lark.CreateUsageEventSummaryRequest, requestOptions?: UsageEvents.RequestOptions): core.HttpResponsePromise<Lark.CreateUsageEventSummaryResponse>;
     private __createUsageEventSummary;
     protected _getCustomAuthorizationHeaders(): Promise<{
-        "X-API-Key": string | undefined;
+        "X-API-Key": string;
     }>;
 }