autumn-js 1.2.31 → 1.2.32

package/dist/sdk/index.d.mts

@@ -1991,6 +1991,10 @@ type RequestBody = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -2022,6 +2026,7 @@ type RequestBody$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
     lock?: BatchTrackLock$Outbound | undefined;
 };
@@ -5295,6 +5300,12 @@ type Plan = {
      * Miscellaneous plan-level configuration flags.
      */
     config: PlanConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: CustomerEligibility | undefined;
 };
 /** @internal */
@@ -6660,6 +6671,12 @@ type CreatePlanParams = {
      * Miscellaneous plan-level configuration flags.
      */
     config?: CreatePlanConfigRequest | undefined;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan.
+     */
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     createInStripe?: boolean | undefined;
 };
 /**
@@ -7116,6 +7133,12 @@ type CreatePlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: CreatePlanConfigResponse;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: CreatePlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -7243,6 +7266,9 @@ type CreatePlanParams$Outbound = {
     items?: Array<CreatePlanPlanItem$Outbound> | undefined;
     free_trial?: FreeTrialRequest$Outbound | undefined;
     config?: CreatePlanConfigRequest$Outbound | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     create_in_stripe: boolean;
 };
 /** @internal */
@@ -12031,6 +12057,12 @@ type GetPlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: GetPlanConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: GetPlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -14409,6 +14441,12 @@ type ListPlansList = {
      * Miscellaneous plan-level configuration flags.
      */
     config: ListPlansConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: ListPlansCustomerEligibility | undefined;
 };
 /**
@@ -21033,6 +21071,10 @@ type TrackParams = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -21233,6 +21275,7 @@ type TrackParams$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
     lock?: TrackLock$Outbound | undefined;
 };
@@ -21325,6 +21368,10 @@ type TrackTokensParams = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -21521,6 +21568,7 @@ type TrackTokensParams$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
 };
 /** @internal */
@@ -23920,6 +23968,12 @@ type UpdatePlanParams = {
      * Miscellaneous plan-level configuration flags.
      */
     config?: UpdatePlanConfigRequest | undefined;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan.
+     */
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     createInStripe?: boolean | undefined;
     version?: number | undefined;
     archived?: boolean | undefined;
@@ -24383,6 +24437,12 @@ type UpdatePlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: UpdatePlanConfigResponse;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: UpdatePlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -24510,6 +24570,9 @@ type UpdatePlanParams$Outbound = {
     items?: Array<UpdatePlanPlanItem$Outbound> | undefined;
     free_trial?: UpdatePlanFreeTrialParams$Outbound | null | undefined;
     config?: UpdatePlanConfigRequest$Outbound | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     create_in_stripe: boolean;
     version?: number | undefined;
     archived: boolean;
@@ -24844,7 +24907,7 @@ declare class Billing extends ClientSDK {
      * @example
      * ```typescript
      * // Schedule a transition from a trial plan to a paid plan
-     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782152693121,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783362293121,"plans":[{"planId":"pro_plan"}]}] });
+     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782402442343,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783612042343,"plans":[{"planId":"pro_plan"}]}] });
      * ```
      *
      * @param customerId - The ID of the customer to create the schedule for.
@@ -25446,6 +25509,7 @@ declare class Plans extends ClientSDK {
      * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
      * @param freeTrial - Free trial configuration. Customers can try this plan before being charged. (optional)
      * @param config - Miscellaneous plan-level configuration flags. (optional)
+     * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
      *
      * @returns The created plan object.
      */
@@ -25534,6 +25598,7 @@ declare class Plans extends ClientSDK {
      * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
      * @param freeTrial - The free trial of the plan. Set to null to remove the free trial. (optional)
      * @param config - Miscellaneous plan-level configuration flags. (optional)
+     * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
      * @param newPlanId - The new ID to use for the plan. Can only be updated if the plan has not been used by any customers. (optional)
      *
      * @returns The updated plan object.
@@ -25681,6 +25746,7 @@ declare class Autumn extends ClientSDK {
      * @param eventName - Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event. (optional)
      * @param value - The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat). (optional)
      * @param properties - Additional properties to attach to this usage event. (optional)
+     * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
      *
      * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
@@ -25716,6 +25782,7 @@ declare class Autumn extends ClientSDK {
      * @param audioOutputTokens - Number of audio output tokens generated. (optional)
      * @param reasoningTokens - Number of reasoning tokens generated. (optional)
      * @param properties - Additional properties to attach to this usage event. (optional)
+     * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
      *
      * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.

package/dist/sdk/index.d.ts

@@ -1991,6 +1991,10 @@ type RequestBody = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -2022,6 +2026,7 @@ type RequestBody$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
     lock?: BatchTrackLock$Outbound | undefined;
 };
@@ -5295,6 +5300,12 @@ type Plan = {
      * Miscellaneous plan-level configuration flags.
      */
     config: PlanConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: CustomerEligibility | undefined;
 };
 /** @internal */
@@ -6660,6 +6671,12 @@ type CreatePlanParams = {
      * Miscellaneous plan-level configuration flags.
      */
     config?: CreatePlanConfigRequest | undefined;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan.
+     */
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     createInStripe?: boolean | undefined;
 };
 /**
@@ -7116,6 +7133,12 @@ type CreatePlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: CreatePlanConfigResponse;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: CreatePlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -7243,6 +7266,9 @@ type CreatePlanParams$Outbound = {
     items?: Array<CreatePlanPlanItem$Outbound> | undefined;
     free_trial?: FreeTrialRequest$Outbound | undefined;
     config?: CreatePlanConfigRequest$Outbound | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     create_in_stripe: boolean;
 };
 /** @internal */
@@ -12031,6 +12057,12 @@ type GetPlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: GetPlanConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: GetPlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -14409,6 +14441,12 @@ type ListPlansList = {
      * Miscellaneous plan-level configuration flags.
      */
     config: ListPlansConfig;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: ListPlansCustomerEligibility | undefined;
 };
 /**
@@ -21033,6 +21071,10 @@ type TrackParams = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -21233,6 +21275,7 @@ type TrackParams$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
     lock?: TrackLock$Outbound | undefined;
 };
@@ -21325,6 +21368,10 @@ type TrackTokensParams = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    /**
+     * Unix timestamp in milliseconds to use for the usage event. Defaults to the current time.
+     */
+    timestamp?: number | undefined;
     /**
      * If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information.
      */
@@ -21521,6 +21568,7 @@ type TrackTokensParams$Outbound = {
     properties?: {
         [k: string]: any;
     } | undefined;
+    timestamp?: number | undefined;
     async?: boolean | undefined;
 };
 /** @internal */
@@ -23920,6 +23968,12 @@ type UpdatePlanParams = {
      * Miscellaneous plan-level configuration flags.
      */
     config?: UpdatePlanConfigRequest | undefined;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan.
+     */
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     createInStripe?: boolean | undefined;
     version?: number | undefined;
     archived?: boolean | undefined;
@@ -24383,6 +24437,12 @@ type UpdatePlanResponse = {
      * Miscellaneous plan-level configuration flags.
      */
     config: UpdatePlanConfigResponse;
+    /**
+     * Arbitrary key-value metadata defined by you for your own use. Shared across all versions of the plan.
+     */
+    metadata: {
+        [k: string]: any;
+    };
     customerEligibility?: UpdatePlanCustomerEligibility | undefined;
 };
 /** @internal */
@@ -24510,6 +24570,9 @@ type UpdatePlanParams$Outbound = {
     items?: Array<UpdatePlanPlanItem$Outbound> | undefined;
     free_trial?: UpdatePlanFreeTrialParams$Outbound | null | undefined;
     config?: UpdatePlanConfigRequest$Outbound | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
     create_in_stripe: boolean;
     version?: number | undefined;
     archived: boolean;
@@ -24844,7 +24907,7 @@ declare class Billing extends ClientSDK {
      * @example
      * ```typescript
      * // Schedule a transition from a trial plan to a paid plan
-     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782152693121,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783362293121,"plans":[{"planId":"pro_plan"}]}] });
+     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782402442343,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783612042343,"plans":[{"planId":"pro_plan"}]}] });
      * ```
      *
      * @param customerId - The ID of the customer to create the schedule for.
@@ -25446,6 +25509,7 @@ declare class Plans extends ClientSDK {
      * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
      * @param freeTrial - Free trial configuration. Customers can try this plan before being charged. (optional)
      * @param config - Miscellaneous plan-level configuration flags. (optional)
+     * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
      *
      * @returns The created plan object.
      */
@@ -25534,6 +25598,7 @@ declare class Plans extends ClientSDK {
      * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
      * @param freeTrial - The free trial of the plan. Set to null to remove the free trial. (optional)
      * @param config - Miscellaneous plan-level configuration flags. (optional)
+     * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
      * @param newPlanId - The new ID to use for the plan. Can only be updated if the plan has not been used by any customers. (optional)
      *
      * @returns The updated plan object.
@@ -25681,6 +25746,7 @@ declare class Autumn extends ClientSDK {
      * @param eventName - Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event. (optional)
      * @param value - The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat). (optional)
      * @param properties - Additional properties to attach to this usage event. (optional)
+     * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
      *
      * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
@@ -25716,6 +25782,7 @@ declare class Autumn extends ClientSDK {
      * @param audioOutputTokens - Number of audio output tokens generated. (optional)
      * @param reasoningTokens - Number of reasoning tokens generated. (optional)
      * @param properties - Additional properties to attach to this usage event. (optional)
+     * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
      * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
      *
      * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.

package/dist/sdk/index.js

@@ -2485,6 +2485,7 @@ var RequestBody$outboundSchema = z46__namespace.pipe(
     eventName: z46__namespace.optional(z46__namespace.string()),
     value: z46__namespace.optional(z46__namespace.number()),
     properties: z46__namespace.optional(z46__namespace.record(z46__namespace.string(), z46__namespace.any())),
+    timestamp: z46__namespace.optional(z46__namespace.int()),
     async: z46__namespace.optional(z46__namespace.boolean()),
     lock: z46__namespace.optional(z46__namespace.lazy(() => BatchTrackLock$outboundSchema))
   }),
@@ -4947,6 +4948,7 @@ var Plan$inboundSchema = z46__namespace.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46__namespace.lazy(() => PlanConfig$inboundSchema),
+    metadata: z46__namespace.record(z46__namespace.string(), z46__namespace.any()),
     customer_eligibility: optional3(z46__namespace.lazy(
       () => CustomerEligibility$inboundSchema
     ))
@@ -6101,6 +6103,7 @@ var CreatePlanParams$outboundSchema = z46__namespace.pipe(
     items: z46__namespace.optional(z46__namespace.array(z46__namespace.lazy(() => CreatePlanPlanItem$outboundSchema))),
     freeTrial: z46__namespace.optional(z46__namespace.lazy(() => FreeTrialRequest$outboundSchema)),
     config: z46__namespace.optional(z46__namespace.lazy(() => CreatePlanConfigRequest$outboundSchema)),
+    metadata: z46__namespace.optional(z46__namespace.record(z46__namespace.string(), z46__namespace.any())),
     createInStripe: z46__namespace._default(z46__namespace.boolean(), true)
   }),
   z46__namespace.transform((v) => {
@@ -6450,6 +6453,7 @@ var CreatePlanResponse$inboundSchema = z46__namespace.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46__namespace.lazy(() => CreatePlanConfigResponse$inboundSchema),
+    metadata: z46__namespace.record(z46__namespace.string(), z46__namespace.any()),
     customer_eligibility: optional3(
       z46__namespace.lazy(() => CreatePlanCustomerEligibility$inboundSchema)
     )
@@ -10155,6 +10159,7 @@ var GetPlanResponse$inboundSchema = z46__namespace.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46__namespace.lazy(() => GetPlanConfig$inboundSchema),
+    metadata: z46__namespace.record(z46__namespace.string(), z46__namespace.any()),
     customer_eligibility: optional3(
       z46__namespace.lazy(() => GetPlanCustomerEligibility$inboundSchema)
     )
@@ -12119,6 +12124,7 @@ var ListPlansList$inboundSchema = z46__namespace.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46__namespace.lazy(() => ListPlansConfig$inboundSchema),
+    metadata: z46__namespace.record(z46__namespace.string(), z46__namespace.any()),
     customer_eligibility: optional3(
       z46__namespace.lazy(() => ListPlansCustomerEligibility$inboundSchema)
     )
@@ -16843,6 +16849,7 @@ var TrackParams$outboundSchema = z46__namespace.pipe(
     eventName: z46__namespace.optional(z46__namespace.string()),
     value: z46__namespace.optional(z46__namespace.number()),
     properties: z46__namespace.optional(z46__namespace.record(z46__namespace.string(), z46__namespace.any())),
+    timestamp: z46__namespace.optional(z46__namespace.int()),
     async: z46__namespace.optional(z46__namespace.boolean()),
     lock: z46__namespace.optional(z46__namespace.lazy(() => TrackLock$outboundSchema))
   }),
@@ -17067,6 +17074,7 @@ var TrackTokensParams$outboundSchema = z46__namespace.pipe(
     audioOutputTokens: z46__namespace.optional(z46__namespace.int()),
     reasoningTokens: z46__namespace.optional(z46__namespace.int()),
     properties: z46__namespace.optional(z46__namespace.record(z46__namespace.string(), z46__namespace.any())),
+    timestamp: z46__namespace.optional(z46__namespace.int()),
     async: z46__namespace.optional(z46__namespace.boolean())
   }),
   z46__namespace.transform((v) => {
@@ -19239,6 +19247,7 @@ var UpdatePlanParams$outboundSchema = z46__namespace.pipe(
       z46__namespace.nullable(z46__namespace.lazy(() => UpdatePlanFreeTrialParams$outboundSchema))
     ),
     config: z46__namespace.optional(z46__namespace.lazy(() => UpdatePlanConfigRequest$outboundSchema)),
+    metadata: z46__namespace.optional(z46__namespace.record(z46__namespace.string(), z46__namespace.any())),
     createInStripe: z46__namespace._default(z46__namespace.boolean(), true),
     version: z46__namespace.optional(z46__namespace.number()),
     archived: z46__namespace._default(z46__namespace.boolean(), false),
@@ -19592,6 +19601,7 @@ var UpdatePlanResponse$inboundSchema = z46__namespace.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46__namespace.lazy(() => UpdatePlanConfigResponse$inboundSchema),
+    metadata: z46__namespace.record(z46__namespace.string(), z46__namespace.any()),
     customer_eligibility: optional3(
       z46__namespace.lazy(() => UpdatePlanCustomerEligibility$inboundSchema)
     )
@@ -21651,7 +21661,7 @@ var Billing = class extends ClientSDK {
    * @example
    * ```typescript
    * // Schedule a transition from a trial plan to a paid plan
-   * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782152693121,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783362293121,"plans":[{"planId":"pro_plan"}]}] });
+   * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782402442343,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783612042343,"plans":[{"planId":"pro_plan"}]}] });
    * ```
    *
    * @param customerId - The ID of the customer to create the schedule for.
@@ -24283,6 +24293,7 @@ var Plans = class extends ClientSDK {
    * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
    * @param freeTrial - Free trial configuration. Customers can try this plan before being charged. (optional)
    * @param config - Miscellaneous plan-level configuration flags. (optional)
+   * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
    *
    * @returns The created plan object.
    */
@@ -24389,6 +24400,7 @@ var Plans = class extends ClientSDK {
    * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
    * @param freeTrial - The free trial of the plan. Set to null to remove the free trial. (optional)
    * @param config - Miscellaneous plan-level configuration flags. (optional)
+   * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
    * @param newPlanId - The new ID to use for the plan. Can only be updated if the plan has not been used by any customers. (optional)
    *
    * @returns The updated plan object.
@@ -25069,6 +25081,7 @@ var Autumn = class extends ClientSDK {
    * @param eventName - Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event. (optional)
    * @param value - The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat). (optional)
    * @param properties - Additional properties to attach to this usage event. (optional)
+   * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
    *
    * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
@@ -25110,6 +25123,7 @@ var Autumn = class extends ClientSDK {
    * @param audioOutputTokens - Number of audio output tokens generated. (optional)
    * @param reasoningTokens - Number of reasoning tokens generated. (optional)
    * @param properties - Additional properties to attach to this usage event. (optional)
+   * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
    *
    * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.

package/dist/sdk/index.mjs

@@ -2462,6 +2462,7 @@ var RequestBody$outboundSchema = z46.pipe(
     eventName: z46.optional(z46.string()),
     value: z46.optional(z46.number()),
     properties: z46.optional(z46.record(z46.string(), z46.any())),
+    timestamp: z46.optional(z46.int()),
     async: z46.optional(z46.boolean()),
     lock: z46.optional(z46.lazy(() => BatchTrackLock$outboundSchema))
   }),
@@ -4924,6 +4925,7 @@ var Plan$inboundSchema = z46.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46.lazy(() => PlanConfig$inboundSchema),
+    metadata: z46.record(z46.string(), z46.any()),
     customer_eligibility: optional3(z46.lazy(
       () => CustomerEligibility$inboundSchema
     ))
@@ -6078,6 +6080,7 @@ var CreatePlanParams$outboundSchema = z46.pipe(
     items: z46.optional(z46.array(z46.lazy(() => CreatePlanPlanItem$outboundSchema))),
     freeTrial: z46.optional(z46.lazy(() => FreeTrialRequest$outboundSchema)),
     config: z46.optional(z46.lazy(() => CreatePlanConfigRequest$outboundSchema)),
+    metadata: z46.optional(z46.record(z46.string(), z46.any())),
     createInStripe: z46._default(z46.boolean(), true)
   }),
   z46.transform((v) => {
@@ -6427,6 +6430,7 @@ var CreatePlanResponse$inboundSchema = z46.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46.lazy(() => CreatePlanConfigResponse$inboundSchema),
+    metadata: z46.record(z46.string(), z46.any()),
     customer_eligibility: optional3(
       z46.lazy(() => CreatePlanCustomerEligibility$inboundSchema)
     )
@@ -10132,6 +10136,7 @@ var GetPlanResponse$inboundSchema = z46.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46.lazy(() => GetPlanConfig$inboundSchema),
+    metadata: z46.record(z46.string(), z46.any()),
     customer_eligibility: optional3(
       z46.lazy(() => GetPlanCustomerEligibility$inboundSchema)
     )
@@ -12096,6 +12101,7 @@ var ListPlansList$inboundSchema = z46.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46.lazy(() => ListPlansConfig$inboundSchema),
+    metadata: z46.record(z46.string(), z46.any()),
     customer_eligibility: optional3(
       z46.lazy(() => ListPlansCustomerEligibility$inboundSchema)
     )
@@ -16820,6 +16826,7 @@ var TrackParams$outboundSchema = z46.pipe(
     eventName: z46.optional(z46.string()),
     value: z46.optional(z46.number()),
     properties: z46.optional(z46.record(z46.string(), z46.any())),
+    timestamp: z46.optional(z46.int()),
     async: z46.optional(z46.boolean()),
     lock: z46.optional(z46.lazy(() => TrackLock$outboundSchema))
   }),
@@ -17044,6 +17051,7 @@ var TrackTokensParams$outboundSchema = z46.pipe(
     audioOutputTokens: z46.optional(z46.int()),
     reasoningTokens: z46.optional(z46.int()),
     properties: z46.optional(z46.record(z46.string(), z46.any())),
+    timestamp: z46.optional(z46.int()),
     async: z46.optional(z46.boolean())
   }),
   z46.transform((v) => {
@@ -19216,6 +19224,7 @@ var UpdatePlanParams$outboundSchema = z46.pipe(
       z46.nullable(z46.lazy(() => UpdatePlanFreeTrialParams$outboundSchema))
     ),
     config: z46.optional(z46.lazy(() => UpdatePlanConfigRequest$outboundSchema)),
+    metadata: z46.optional(z46.record(z46.string(), z46.any())),
     createInStripe: z46._default(z46.boolean(), true),
     version: z46.optional(z46.number()),
     archived: z46._default(z46.boolean(), false),
@@ -19569,6 +19578,7 @@ var UpdatePlanResponse$inboundSchema = z46.pipe(
     archived: boolean2(),
     base_variant_id: nullable(string4()),
     config: z46.lazy(() => UpdatePlanConfigResponse$inboundSchema),
+    metadata: z46.record(z46.string(), z46.any()),
     customer_eligibility: optional3(
       z46.lazy(() => UpdatePlanCustomerEligibility$inboundSchema)
     )
@@ -21628,7 +21638,7 @@ var Billing = class extends ClientSDK {
    * @example
    * ```typescript
    * // Schedule a transition from a trial plan to a paid plan
-   * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782152693121,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783362293121,"plans":[{"planId":"pro_plan"}]}] });
+   * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1782402442343,"plans":[{"planId":"trial_plan"}]},{"startsAt":1783612042343,"plans":[{"planId":"pro_plan"}]}] });
    * ```
    *
    * @param customerId - The ID of the customer to create the schedule for.
@@ -24260,6 +24270,7 @@ var Plans = class extends ClientSDK {
    * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
    * @param freeTrial - Free trial configuration. Customers can try this plan before being charged. (optional)
    * @param config - Miscellaneous plan-level configuration flags. (optional)
+   * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
    *
    * @returns The created plan object.
    */
@@ -24366,6 +24377,7 @@ var Plans = class extends ClientSDK {
    * @param items - Feature configurations for this plan. Each item defines included units, pricing, and reset behavior. (optional)
    * @param freeTrial - The free trial of the plan. Set to null to remove the free trial. (optional)
    * @param config - Miscellaneous plan-level configuration flags. (optional)
+   * @param metadata - Arbitrary key-value metadata defined by you for your own use (e.g. UI copy, feature highlights). Values can be any JSON-serializable value. Shared across all versions of the plan. (optional)
    * @param newPlanId - The new ID to use for the plan. Can only be updated if the plan has not been used by any customers. (optional)
    *
    * @returns The updated plan object.
@@ -25046,6 +25058,7 @@ var Autumn = class extends ClientSDK {
    * @param eventName - Event name to track usage for. Use instead of feature_id when multiple features should be tracked from a single event. (optional)
    * @param value - The amount of usage to record. Defaults to 1. Use negative values to credit balance (e.g., when removing a seat). (optional)
    * @param properties - Additional properties to attach to this usage event. (optional)
+   * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
    *
    * @returns The usage value recorded, with either a single updated balance or a map of updated balances. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the event for replay so it can be tracked as soon as the service is restored.
@@ -25087,6 +25100,7 @@ var Autumn = class extends ClientSDK {
    * @param audioOutputTokens - Number of audio output tokens generated. (optional)
    * @param reasoningTokens - Number of reasoning tokens generated. (optional)
    * @param properties - Additional properties to attach to this usage event. (optional)
+   * @param timestamp - Unix timestamp in milliseconds to use for the usage event. Defaults to the current time. (optional)
    * @param async - If true, enqueue the event for asynchronous processing and return 204 immediately. The response will not include balance information. (optional)
    *
    * @returns The dollar value recorded and the updated AI credit system balance. If Autumn is experiencing degraded service from a downstream provider, the API may return 202 after accepting the token usage event for replay so it can be tracked as soon as the service is restored.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "autumn-js",
   "description": "Autumn JS Library",
-  "version": "1.2.31",
+  "version": "1.2.32",
   "repository": "github:useautumn/autumn",
   "homepage": "https://docs.useautumn.com",
   "main": "./dist/sdk/index.js",