lark-billing 0.0.7 → 0.0.9

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

@@ -5,19 +5,25 @@ import * as Lark from "../../../../index.mjs";
 /**
  * @example
  *     {
- *         name: "name",
+ *         name: "Pro Plan",
  *         billing_interval: "monthly"
  *     }
  */
 export interface CreateRateCardRequest {
+    /** The name of the rate card displayed to the customer. */
     name: string;
+    /** The description of the rate card displayed to the customer. */
     description?: string;
-    usage_based_rates?: Lark.CreateSimpleUsageBasedRateInterface[];
-    fixed_rates?: Lark.CreateFixedRateInterface[];
+    /** How often the customer will be billed for this rate card. */
     billing_interval: CreateRateCardRequest.BillingInterval;
+    fixed_rates?: Lark.CreateFixedRateRequest[];
+    usage_based_rates?: Lark.CreateRateCardRequestUsageBasedRatesItem[];
     metadata?: Record<string, string>;
 }
 export declare namespace CreateRateCardRequest {
+    /**
+     * How often the customer will be billed for this rate card.
+     */
     type BillingInterval = "monthly" | "yearly";
     const BillingInterval: {
         readonly Monthly: "monthly";

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_jQK2n0wutCj6bBcAIrL6o07g"
+     *     })
+     */
+    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_jQK2n0wutCj6bBcAIrL6o07g"
+     *     })
+     */
+    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,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+/**
+ * @example
+ *     {
+ *         rate_card_id: "rc_jQK2n0wutCj6bBcAIrL6o07g"
+ *     }
+ */
+export interface ChangeSubscriptionRateCardRequest {
+    /** The ID of the rate card to change the subscription to. */
+    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";

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

@@ -13,9 +13,19 @@
  *     }
  */
 export interface CreateUsageEventRequest {
+    /** The idempotency key for the usage event. This ensures that the same event is not processed multiple times. */
     idempotency_key: string;
+    /** The name of the event. This is used by pricing metrics to aggregate usage events. */
     event_name: string;
+    /** The ID of the subject that the usage event is for. */
     subject_id: string;
+    /** The timestamp of the usage event. It is highly recommended to provide a timestamp. If not provided, the current timestamp will be used. */
     timestamp?: string;
-    data: Record<string, unknown>;
+    /** The data of the usage event. This should contain any data that is needed to aggregate the usage event. */
+    data: Record<string, CreateUsageEventRequest.Data.Value>;
+}
+export declare namespace CreateUsageEventRequest {
+    namespace Data {
+        type Value = string | number | number | boolean;
+    }
 }

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

@@ -2,20 +2,11 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Lark from "../index.mjs";
-export type Aggregation = Lark.Aggregation.Count | Lark.Aggregation.Custom | Lark.Aggregation.Last | Lark.Aggregation.Max | Lark.Aggregation.Sum;
+export type Aggregation = Lark.Aggregation.Count | Lark.Aggregation.Sum;
 export declare namespace Aggregation {
     interface Count extends Lark.CountAggregationPricingMetricResource {
         aggregation_type: "count";
     }
-    interface Custom extends Lark.CustomPricingMetricResource {
-        aggregation_type: "custom";
-    }
-    interface Last extends Lark.LastAggregationPricingMetricResource {
-        aggregation_type: "last";
-    }
-    interface Max extends Lark.MaxAggregationPricingMetricResource {
-        aggregation_type: "max";
-    }
     interface Sum extends Lark.SumAggregationPricingMetricResource {
         aggregation_type: "sum";
     }

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

@@ -4,5 +4,6 @@
 export interface Amount {
     /** The value of the amount in the smallest unit of the currency. */
     value: string;
+    /** The currency code of the amount. */
     currency_code: string;
 }

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

@@ -2,6 +2,8 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface CreateCustomerPortalSessionResponse {
+    /** The ID of the subject for the customer portal session. */
     subject_id: string;
+    /** The URL to redirect to the customer portal session. */
     url: string;
 }

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

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface CreateFixedRateRequest {
+    /** The name of the rate displayed to the customer. */
+    name: string;
+    /** The description of the rate displayed to the customer. */
+    description?: string;
+    price: Lark.Price;
+}

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

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

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

@@ -0,0 +1,15 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface CreateSimpleUsageBasedRateRequest {
+    /** The name of the rate displayed to the customer. */
+    name: string;
+    /** The description of the rate displayed to the customer. */
+    description?: string;
+    price: Lark.Price;
+    /** The number of units included in the rate before the price is applied. */
+    included_units?: number;
+    /** The ID of the pricing metric to use for this rate. */
+    pricing_metric_id: string;
+}

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

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

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

@@ -2,10 +2,16 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 export interface CreateSubjectResponse {
+    /** The ID of the subject. */
     id: string;
+    /** The ID of the subject in your system. You may pass it to the API in place of the subject ID. */
     external_id?: string;
+    /** The name of the subject. Used for display in the dashboard. */
     name?: string;
+    /** The email of the subject. */
     email?: string;
+    /** Additional metadata about the subject. You may use this to store any custom data about the subject. */
     metadata: Record<string, string>;
+    /** The date and time the subject was created. */
     created_at: string;
 }

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

@@ -3,7 +3,10 @@
  */
 import * as Lark from "../index.mjs";
 export interface CreateSubscriptionCheckoutSessionResponse {
+    /** The ID of the checkout session. */
     id: string;
+    /** The amount of the checkout session. */
     amount: Lark.Amount;
+    /** The URL to redirect to the checkout session. */
     url: string;
 }

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

@@ -5,6 +5,6 @@ import * as Lark from "../index.mjs";
 export interface FixedRateInterface {
     id: string;
     name: string;
-    description: string;
+    description?: string;
     price: Lark.Price;
 }

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

@@ -0,0 +1,10 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface InvoiceLineItemResource {
+    amount: Lark.Amount;
+    description: string;
+    quantity: number;
+    price_in_unit_amount: Lark.Amount;
+}

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

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

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

@@ -0,0 +1,33 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface InvoiceResource {
+    /** The ID of the invoice. */
+    id: string;
+    /** The total amount of the invoice. */
+    total_amount: Lark.Amount;
+    /** The ID of the subject for the invoice. */
+    subject_id: string;
+    /** The date and time the invoice was created. */
+    created_at: string;
+    /** The status of the invoice. */
+    status: InvoiceResource.Status;
+    /** The URL of the hosted invoice. */
+    hosted_url?: string;
+    /** The line items of the invoice. */
+    line_items: Lark.InvoiceLineItemResource[];
+}
+export declare namespace InvoiceResource {
+    /**
+     * The status of the invoice.
+     */
+    type Status = "draft" | "open" | "paid" | "uncollectible" | "void";
+    const Status: {
+        readonly Draft: "draft";
+        readonly Open: "open";
+        readonly Paid: "paid";
+        readonly Uncollectible: "uncollectible";
+        readonly Void: "void";
+    };
+}

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

@@ -0,0 +1,13 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export var InvoiceResource;
+(function (InvoiceResource) {
+    InvoiceResource.Status = {
+        Draft: "draft",
+        Open: "open",
+        Paid: "paid",
+        Uncollectible: "uncollectible",
+        Void: "void",
+    };
+})(InvoiceResource || (InvoiceResource = {}));

package/dist/esm/api/types/{CreateFixedRateInterface.d.mts → ListInvoicesResponse.d.mts}

@@ -2,8 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Lark from "../index.mjs";
-export interface CreateFixedRateInterface {
-    name?: string;
-    description?: string;
-    price: Lark.Price;
+export interface ListInvoicesResponse {
+    invoices: Lark.InvoiceResource[];
+    has_more: boolean;
 }

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface ListPricingMetricsResponse {
+    pricing_metrics: Lark.PricingMetricResource[];
+    has_more: boolean;
+}

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface PeriodResource {
+    inclusive_start?: boolean;
+    inclusive_end?: boolean;
+    start: string;
+    end: string;
+}

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+import * as Lark from "../index.mjs";
+export interface PricingMetricResource {
+    id: string;
+    name: string;
+    event_name: string;
+    aggregation: Lark.Aggregation;
+    unit: string;
+}

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

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

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

@@ -3,13 +3,20 @@
  */
 import * as Lark from "../index.mjs";
 export interface RateCardResource {
+    /** The ID of the rate card. */
     id: string;
+    /** The name of the rate card. */
     name: string;
-    description: string;
+    /** The description of the rate card. */
+    description?: string;
+    /** The usage based rates of the rate card. */
     usage_based_rates: Lark.RateCardResourceUsageBasedRatesItem[];
+    /** The fixed rates of the rate card. */
     fixed_rates: Lark.FixedRateInterface[];
     billing_interval: RateCardResource.BillingInterval;
+    /** The date and time the rate card was created. */
     created_at: string;
+    /** The date and time the rate card was last updated. */
     updated_at: string;
     metadata: Record<string, string>;
 }

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

@@ -4,10 +4,8 @@
 import * as Lark from "../index.mjs";
 export interface SimpleUsageBasedRateInterface {
     id: string;
-    /** Code of this rate to be used for overrides and external reference. */
-    code: string;
     name: string;
-    description: string;
+    description?: string;
     price: Lark.Price;
     included_units: number;
     pricing_metric_id: string;