lark-billing 0.3.0 → 0.5.0

package/resources/usage-events.d.ts

@@ -9,13 +9,14 @@ export declare class UsageEvents extends APIResource {
      * ```ts
      * const usageEvent = await client.usageEvents.create({
      *   data: {
-     *     compute_hours: 100,
+     *     compute_hours: '100.5',
      *     instance_type: 't2.micro',
      *     region: 'us-east-1',
      *   },
-     *   event_name: 'compute_hours',
-     *   idempotency_key: 'dd187757-47af-4a69-8a89-6285b9fe1cb6',
+     *   event_name: 'job_completed',
+     *   idempotency_key: 'dec98bc7-e75c-4414-9f34-02e98ae9e047',
      *   subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
+     *   timestamp: '2025-12-14T19:55:29.967956+00:00',
      * });
      * ```
      */

package/resources/usage-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage-events.d.ts","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAGpF;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEzC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}
+{"version":3,"file":"usage-events.d.ts","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAAI,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;CAGpF;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;AAE/C,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,IAAI,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAEzC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,CAAC,OAAO,WAAW,WAAW,CAAC;IACnC,OAAO,EACL,KAAK,wBAAwB,IAAI,wBAAwB,EACzD,KAAK,sBAAsB,IAAI,sBAAsB,GACtD,CAAC;CACH"}

package/resources/usage-events.js

@@ -11,13 +11,14 @@ class UsageEvents extends resource_1.APIResource {
      * ```ts
      * const usageEvent = await client.usageEvents.create({
      *   data: {
-     *     compute_hours: 100,
+     *     compute_hours: '100.5',
      *     instance_type: 't2.micro',
      *     region: 'us-east-1',
      *   },
-     *   event_name: 'compute_hours',
-     *   idempotency_key: 'dd187757-47af-4a69-8a89-6285b9fe1cb6',
+     *   event_name: 'job_completed',
+     *   idempotency_key: 'dec98bc7-e75c-4414-9f34-02e98ae9e047',
      *   subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
+     *   timestamp: '2025-12-14T19:55:29.967956+00:00',
      * });
      * ```
      */

package/resources/usage-events.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage-events.js","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AArBD,kCAqBC"}
+{"version":3,"file":"usage-events.js","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,kDAA+C;AAI/C,MAAa,WAAY,SAAQ,sBAAW;IAC1C;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;CACF;AAtBD,kCAsBC"}

package/resources/usage-events.mjs

@@ -8,13 +8,14 @@ export class UsageEvents extends APIResource {
      * ```ts
      * const usageEvent = await client.usageEvents.create({
      *   data: {
-     *     compute_hours: 100,
+     *     compute_hours: '100.5',
      *     instance_type: 't2.micro',
      *     region: 'us-east-1',
      *   },
-     *   event_name: 'compute_hours',
-     *   idempotency_key: 'dd187757-47af-4a69-8a89-6285b9fe1cb6',
+     *   event_name: 'job_completed',
+     *   idempotency_key: 'dec98bc7-e75c-4414-9f34-02e98ae9e047',
      *   subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
+     *   timestamp: '2025-12-14T19:55:29.967956+00:00',
      * });
      * ```
      */

package/resources/usage-events.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"usage-events.mjs","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}
+{"version":3,"file":"usage-events.mjs","sourceRoot":"","sources":["../src/resources/usage-events.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,WAAY,SAAQ,WAAW;IAC1C;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,IAA4B,EAAE,OAAwB;QAC3D,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;CACF"}

package/src/client.ts

@@ -165,7 +165,7 @@ export class Lark {
   baseURL: string;
   maxRetries: number;
   timeout: number;
-  logger: Logger | undefined;
+  logger: Logger;
   logLevel: LogLevel | undefined;
   fetchOptions: MergedRequestInit | undefined;
 

package/src/resources/customer-access.ts

@@ -8,6 +8,14 @@ import { path } from '../internal/utils/path';
 export class CustomerAccess extends APIResource {
   /**
    * Get Billing State
+   *
+   * @example
+   * ```ts
+   * const response =
+   *   await client.customerAccess.retrieveBillingState(
+   *     'user_1234567890',
+   *   );
+   * ```
    */
   retrieveBillingState(
     subjectID: string,

package/src/resources/invoices.ts

@@ -8,6 +8,13 @@ import { RequestOptions } from '../internal/request-options';
 export class Invoices extends APIResource {
   /**
    * List Invoices
+   *
+   * @example
+   * ```ts
+   * const invoices = await client.invoices.list({
+   *   subject_id: 'user_1234567890',
+   * });
+   * ```
    */
   list(query: InvoiceListParams, options?: RequestOptions): APIPromise<InvoiceListResponse> {
     return this._client.get('/invoices', { query, ...options });

package/src/resources/pricing-metrics.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../core/resource';
+import * as PricingMetricsAPI from './pricing-metrics';
 import { APIPromise } from '../core/api-promise';
 import { RequestOptions } from '../internal/request-options';
 import { path } from '../internal/utils/path';
@@ -61,11 +62,11 @@ export class PricingMetrics extends APIResource {
    * @example
    * ```ts
    * const response = await client.pricingMetrics.createSummary(
-   *   'pricing_metric_id',
+   *   'pmtr_GlX5Tcm2HOn00CoRTFxw2Amw',
    *   {
    *     period: {
-   *       end: '2025-11-01T00:00:00Z',
    *       start: '2025-10-01T00:00:00Z',
+   *       end: '2025-11-01T00:00:00Z',
    *     },
    *     subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
    *   },
@@ -120,6 +121,11 @@ export interface PricingMetricResource {
    * The unit of the value computed by the pricing metric.
    */
   unit: string;
+
+  /**
+   * The dimensions by which the events are grouped to compute the pricing metric.
+   */
+  dimensions?: Array<string> | null;
 }
 
 export namespace PricingMetricResource {
@@ -161,32 +167,42 @@ export interface PricingMetricListResponse {
   pricing_metrics: Array<PricingMetricResource>;
 }
 
-export interface PricingMetricCreateSummaryResponse {
-  /**
-   * The ID of the pricing metric summary.
-   */
-  id: string;
+export type PricingMetricCreateSummaryResponse =
+  Array<PricingMetricCreateSummaryResponse.PricingMetricCreateSummaryResponseItem>;
 
-  /**
-   * The period that the summary is computed over.
-   */
-  period: Period;
+export namespace PricingMetricCreateSummaryResponse {
+  export interface PricingMetricCreateSummaryResponseItem {
+    /**
+     * The ID of the pricing metric summary.
+     */
+    id: string;
 
-  /**
-   * The ID of the pricing metric that the summary is for.
-   */
-  pricing_metric_id: string;
+    /**
+     * The dimension coordinates that the summary is for.
+     */
+    dimension_coordinates: { [key: string]: string } | null;
 
-  /**
-   * The ID of the subject that the summary is for.
-   */
-  subject_id: string;
+    /**
+     * The period that the summary is computed over.
+     */
+    period: PricingMetricsAPI.Period;
 
-  /**
-   * The computed value of the pricing metric for the period. If the pricing metric
-   * does not have any usage events for the period, this will be `null`.
-   */
-  value: string | null;
+    /**
+     * The ID of the pricing metric that the summary is for.
+     */
+    pricing_metric_id: string;
+
+    /**
+     * The ID of the subject that the summary is for.
+     */
+    subject_id: string;
+
+    /**
+     * The computed value of the pricing metric for the period. If the pricing metric
+     * does not have any usage events for the period, this will be `null`.
+     */
+    value: string | null;
+  }
 }
 
 export interface PricingMetricCreateParams {
@@ -214,6 +230,11 @@ export interface PricingMetricCreateParams {
    * Unit of measurement for the pricing metric.
    */
   unit: string;
+
+  /**
+   * The dimensions by which the events are grouped to compute the pricing metric.
+   */
+  dimensions?: Array<string> | null;
 }
 
 export namespace PricingMetricCreateParams {
@@ -292,6 +313,16 @@ export interface PricingMetricCreateSummaryParams {
    * The ID or external ID of the subject that the summary should be computed for.
    */
   subject_id: string;
+
+  /**
+   * The dimensions by which the events are grouped to compute the pricing metric.
+   */
+  dimensions?: Array<string> | null;
+
+  /**
+   * The granularity of the period that the summary should be computed over.
+   */
+  period_granularity?: 'hour' | 'day' | 'week' | null;
 }
 
 export declare namespace PricingMetrics {

package/src/resources/rate-cards.ts

@@ -10,6 +10,38 @@ import { path } from '../internal/utils/path';
 export class RateCards extends APIResource {
   /**
    * Create Rate Card
+   *
+   * @example
+   * ```ts
+   * const rateCardResource = await client.rateCards.create({
+   *   billing_interval: 'monthly',
+   *   name: 'Pro Plan',
+   *   description:
+   *     'For production applicatidddons with moderate usage.',
+   *   fixed_rates: [
+   *     {
+   *       name: 'Base Rate',
+   *       price: {
+   *         price_type: 'flat',
+   *         amount: { value: 2500, currency_code: 'usd' },
+   *       },
+   *     },
+   *   ],
+   *   metadata: {},
+   *   usage_based_rates: [
+   *     {
+   *       usage_based_rate_type: 'simple',
+   *       name: 'Compute Hours',
+   *       price: {
+   *         price_type: 'flat',
+   *         amount: { value: 100, currency_code: 'usd' },
+   *       },
+   *       included_units: 30,
+   *       pricing_metric_id: 'pmtr_GlX5Tcm2HOn00CoRTFxw2Amw',
+   *     },
+   *   ],
+   * });
+   * ```
    */
   create(body: RateCardCreateParams, options?: RequestOptions): APIPromise<RateCardResource> {
     return this._client.post('/rate-cards', { body, ...options });
@@ -17,6 +49,13 @@ export class RateCards extends APIResource {
 
   /**
    * Get Rate Card
+   *
+   * @example
+   * ```ts
+   * const rateCardResource = await client.rateCards.retrieve(
+   *   'rate_card_id',
+   * );
+   * ```
    */
   retrieve(rateCardID: string, options?: RequestOptions): APIPromise<RateCardResource> {
     return this._client.get(path`/rate-cards/${rateCardID}`, options);
@@ -24,6 +63,11 @@ export class RateCards extends APIResource {
 
   /**
    * List Rate Cards
+   *
+   * @example
+   * ```ts
+   * const rateCards = await client.rateCards.list();
+   * ```
    */
   list(
     query: RateCardListParams | null | undefined = {},
@@ -99,6 +143,9 @@ export interface RateCardResource {
    */
   id: string;
 
+  /**
+   * How often the customer will be billed for this rate card.
+   */
   billing_interval: 'monthly' | 'yearly';
 
   /**
@@ -111,6 +158,10 @@ export interface RateCardResource {
    */
   fixed_rates: Array<RateCardResource.FixedRate>;
 
+  /**
+   * Additional metadata about the rate card. You may use this to store any custom
+   * data about the rate card.
+   */
   metadata: { [key: string]: string };
 
   /**
@@ -126,7 +177,9 @@ export interface RateCardResource {
   /**
    * The usage based rates of the rate card.
    */
-  usage_based_rates: Array<RateCardResource.UsageBasedRate>;
+  usage_based_rates: Array<
+    RateCardResource.SimpleUsageBasedRateInterface | RateCardResource.DimensionalUsageBasedRateInterface
+  >;
 
   /**
    * The description of the rate card.
@@ -148,7 +201,7 @@ export namespace RateCardResource {
     price: RateCardsAPI.FlatPriceOutput | RateCardsAPI.PackagePriceOutput;
   }
 
-  export interface UsageBasedRate {
+  export interface SimpleUsageBasedRateInterface {
     id: string;
 
     description: string | null;
@@ -166,6 +219,49 @@ export namespace RateCardResource {
 
     usage_based_rate_type?: 'simple';
   }
+
+  export interface DimensionalUsageBasedRateInterface {
+    id: string;
+
+    description: string | null;
+
+    dimensions: Array<DimensionalUsageBasedRateInterface.Dimension>;
+
+    included_units: number;
+
+    name: string;
+
+    pricing_matrix: DimensionalUsageBasedRateInterface.PricingMatrix;
+
+    pricing_metric_id: string;
+
+    usage_based_rate_type?: 'dimensional';
+  }
+
+  export namespace DimensionalUsageBasedRateInterface {
+    export interface Dimension {
+      description: string | null;
+
+      key: string;
+
+      values: Array<string>;
+    }
+
+    export interface PricingMatrix {
+      cells: Array<PricingMatrix.Cell>;
+    }
+
+    export namespace PricingMatrix {
+      export interface Cell {
+        dimension_coordinates: { [key: string]: string };
+
+        /**
+         * Flat price is a price that linearly scales with the quantity.
+         */
+        price: RateCardsAPI.FlatPriceOutput | RateCardsAPI.PackagePriceOutput;
+      }
+    }
+  }
 }
 
 export interface RateCardListResponse {
@@ -202,7 +298,10 @@ export interface RateCardCreateParams {
    * The usage based rates of the rate card. These are billed at the end of each
    * billing cycle.
    */
-  usage_based_rates?: Array<RateCardCreateParams.UsageBasedRate>;
+  usage_based_rates?: Array<
+    | RateCardCreateParams.CreateSimpleUsageBasedRateRequest
+    | RateCardCreateParams.CreateDimensionalUsageBasedRateRequest
+  >;
 }
 
 export namespace RateCardCreateParams {
@@ -223,7 +322,7 @@ export namespace RateCardCreateParams {
     description?: string | null;
   }
 
-  export interface UsageBasedRate {
+  export interface CreateSimpleUsageBasedRateRequest {
     /**
      * The name of the rate displayed to the customer.
      */
@@ -251,6 +350,82 @@ export namespace RateCardCreateParams {
      */
     included_units?: number;
   }
+
+  export interface CreateDimensionalUsageBasedRateRequest {
+    /**
+     * The dimensions of the rate.
+     */
+    dimensions: Array<CreateDimensionalUsageBasedRateRequest.Dimension>;
+
+    /**
+     * The name of the rate displayed to the customer.
+     */
+    name: string;
+
+    /**
+     * The pricing matrix of the rate.
+     */
+    pricing_matrix: CreateDimensionalUsageBasedRateRequest.PricingMatrix;
+
+    /**
+     * The ID of the pricing metric to use for this rate.
+     */
+    pricing_metric_id: string;
+
+    usage_based_rate_type: 'dimensional';
+
+    /**
+     * The description of the rate displayed to the customer.
+     */
+    description?: string | null;
+
+    /**
+     * The number of units included in the rate before the price is applied.
+     */
+    included_units?: number;
+  }
+
+  export namespace CreateDimensionalUsageBasedRateRequest {
+    export interface Dimension {
+      /**
+       * The name of the dimension. This is used to identify the dimension in the pricing
+       * matrix.
+       */
+      key: string;
+
+      /**
+       * A list of possible values for the dimension.
+       */
+      values: Array<string>;
+
+      /**
+       * The description of the dimension.
+       */
+      description?: string | null;
+    }
+
+    /**
+     * The pricing matrix of the rate.
+     */
+    export interface PricingMatrix {
+      cells: Array<PricingMatrix.Cell>;
+    }
+
+    export namespace PricingMatrix {
+      export interface Cell {
+        /**
+         * A key-value mapping of dimension keys and values to identify the price for a
+         * given set of dimension values.
+         */
+        dimension_coordinates: { [key: string]: string };
+
+        /**
+         * The price for the cell.
+         */
+        price: RateCardsAPI.FlatPriceInput | RateCardsAPI.PackagePriceInput;
+      }
+    }
+  }
 }
 
 export interface RateCardListParams {

package/src/resources/subjects.ts

@@ -11,7 +11,12 @@ export class Subjects extends APIResource {
    *
    * @example
    * ```ts
-   * const subject = await client.subjects.create();
+   * const subject = await client.subjects.create({
+   *   email: 'john.doe@example.com',
+   *   external_id: 'user_1234567890',
+   *   metadata: {},
+   *   name: 'John Doe',
+   * });
    * ```
    */
   create(body: SubjectCreateParams, options?: RequestOptions): APIPromise<SubjectCreateResponse> {
@@ -41,7 +46,7 @@ export class Subjects extends APIResource {
    *   'subject_id',
    *   {
    *     email: 'john.doe@example.com',
-   *     metadata: { foo: 'string' },
+   *     metadata: {},
    *     name: 'John Doe',
    *   },
    * );

package/src/resources/subscriptions.ts

@@ -13,12 +13,13 @@ export class Subscriptions extends APIResource {
    * @example
    * ```ts
    * const subscription = await client.subscriptions.create({
-   *   checkout_callback_urls: {
-   *     cancelled_url: 'https://example.com/callback',
-   *     success_url: 'https://example.com/callback',
-   *   },
    *   rate_card_id: 'rc_AJWMxR81jxoRlli6p13uf3JB',
    *   subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
+   *   checkout_callback_urls: {
+   *     cancelled_url: 'https://example.com/try-again',
+   *     success_url: 'https://example.com/welcome',
+   *   },
+   *   metadata: {},
    * });
    * ```
    */
@@ -60,7 +61,9 @@ export class Subscriptions extends APIResource {
    * @example
    * ```ts
    * const subscriptionResource =
-   *   await client.subscriptions.cancel('subscription_id');
+   *   await client.subscriptions.cancel('subscription_id', {
+   *     cancel_at_end_of_cycle: true,
+   *   });
    * ```
    */
   cancel(
@@ -79,11 +82,12 @@ export class Subscriptions extends APIResource {
    * const response = await client.subscriptions.changeRateCard(
    *   'subscription_id',
    *   {
+   *     rate_card_id: 'rc_jQK2n0wutCj6bBcAIrL6o07g',
    *     checkout_callback_urls: {
-   *       cancelled_url: 'https://example.com/callback',
-   *       success_url: 'https://example.com/callback',
+   *       cancelled_url: 'https://example.com/try-again',
+   *       success_url: 'https://example.com/completed',
    *     },
-   *     rate_card_id: 'rc_jQK2n0wutCj6bBcAIrL6o07g',
+   *     upgrade_behavior: 'prorate',
    *   },
    * );
    * ```
@@ -265,12 +269,6 @@ export namespace SubscriptionChangeRateCardResponse {
 }
 
 export interface SubscriptionCreateParams {
-  /**
-   * The URLs to redirect to after the checkout is completed or cancelled, if a
-   * checkout is required.
-   */
-  checkout_callback_urls: CheckoutCallback;
-
   /**
    * The ID of the rate card to use for the subscription.
    */
@@ -281,6 +279,12 @@ export interface SubscriptionCreateParams {
    */
   subject_id: string;
 
+  /**
+   * The URLs to redirect to after the checkout is completed or cancelled, if a
+   * checkout is required.
+   */
+  checkout_callback_urls?: CheckoutCallback | null;
+
   /**
    * Determines whether a checkout session is always required even if the subject has
    * a payment method on file. By default, if the subject has a payment method on
@@ -328,15 +332,15 @@ export interface SubscriptionCancelParams {
 
 export interface SubscriptionChangeRateCardParams {
   /**
-   * The URLs to redirect to after the checkout is completed or cancelled, if a
-   * checkout is required.
+   * The ID of the rate card to change the subscription to.
    */
-  checkout_callback_urls: CheckoutCallback;
+  rate_card_id: string;
 
   /**
-   * The ID of the rate card to change the subscription to.
+   * The URLs to redirect to after the checkout is completed or cancelled, if a
+   * checkout is required.
    */
-  rate_card_id: string;
+  checkout_callback_urls?: CheckoutCallback | null;
 
   /**
    * The behavior to use when upgrading the subscription. If 'prorate', the customer

package/src/resources/usage-events.ts

@@ -12,13 +12,14 @@ export class UsageEvents extends APIResource {
    * ```ts
    * const usageEvent = await client.usageEvents.create({
    *   data: {
-   *     compute_hours: 100,
+   *     compute_hours: '100.5',
    *     instance_type: 't2.micro',
    *     region: 'us-east-1',
    *   },
-   *   event_name: 'compute_hours',
-   *   idempotency_key: 'dd187757-47af-4a69-8a89-6285b9fe1cb6',
+   *   event_name: 'job_completed',
+   *   idempotency_key: 'dec98bc7-e75c-4414-9f34-02e98ae9e047',
    *   subject_id: 'subj_VyX6Q96h5avMho8O7QWlKeXE',
+   *   timestamp: '2025-12-14T19:55:29.967956+00:00',
    * });
    * ```
    */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '0.3.0'; // x-release-please-version
+export const VERSION = '0.5.0'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.5.0";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.5.0";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '0.3.0'; // x-release-please-version
+exports.VERSION = '0.5.0'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '0.3.0'; // x-release-please-version
+export const VERSION = '0.5.0'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map