@flexprice/mcp-server 2.1.11 → 2.1.18

package/src/models/invoicefilter.ts

@@ -8,6 +8,10 @@ import {
   FilterCondition,
   FilterCondition$zodSchema,
 } from "./filtercondition.js";
+import {
+  InvoiceBillingReason,
+  InvoiceBillingReason$zodSchema,
+} from "./invoicebillingreason.js";
 import { InvoiceStatus, InvoiceStatus$zodSchema } from "./invoicestatus.js";
 import { InvoiceType, InvoiceType$zodSchema } from "./invoicetype.js";
 import { PaymentStatus, PaymentStatus$zodSchema } from "./paymentstatus.js";
@@ -28,6 +32,8 @@ export const InvoiceFilterOrder$zodSchema = z.enum([
 export type InvoiceFilter = {
   amount_due_gt?: number | undefined;
   amount_remaining_gt?: number | undefined;
+  billing_reason?: InvoiceBillingReason | undefined;
+  currency?: string | undefined;
   customer_id?: string | undefined;
   end_time?: string | undefined;
   expand?: string | undefined;
@@ -59,6 +65,10 @@ export const InvoiceFilter$zodSchema: z.ZodType<InvoiceFilter> = z.object({
   amount_remaining_gt: z.number().optional().describe(
     "amount_remaining_gt filters invoices with an outstanding balance greater than the specified value\nUseful for finding invoices that still have significant unpaid amounts",
   ),
+  billing_reason: InvoiceBillingReason$zodSchema.optional(),
+  currency: z.string().optional().describe(
+    "currency filters invoices by their currency (ISO 4217 code, e.g. \"usd\", \"eur\").\nMatches on the invoices.currency column exactly.",
+  ),
   customer_id: z.string().optional().describe(
     "customer_id filters invoices for a specific customer using FlexPrice's internal customer ID\nThis is the ID returned by FlexPrice when creating or retrieving customers",
   ),

package/src/models/invoicelineitemresponse.ts

@@ -15,6 +15,7 @@ import {
 } from "./usagebreakdownitem.js";
 
 export type InvoiceLineItemResponse = {
+  adjusted_entitlement_quantity?: string | undefined;
   amount?: string | undefined;
   commitment_info?: CommitmentInfo | undefined;
   created_at?: string | undefined;
@@ -44,6 +45,7 @@ export type InvoiceLineItemResponse = {
   quantity?: string | undefined;
   status?: Status | undefined;
   subscription_id?: string | undefined;
+  subscription_line_item_id?: string | undefined;
   tenant_id?: string | undefined;
   updated_at?: string | undefined;
   updated_by?: string | undefined;
@@ -54,6 +56,9 @@ export type InvoiceLineItemResponse = {
 export const InvoiceLineItemResponse$zodSchema: z.ZodType<
   InvoiceLineItemResponse
 > = z.object({
+  adjusted_entitlement_quantity: z.string().optional().describe(
+    "adjusted_entitlement_quantity is the entitlement-covered portion deducted from raw usage.\nNil when no entitlement was applied. Raw usage = Quantity + AdjustedEntitlementQuantity.",
+  ),
   amount: z.string().optional(),
   commitment_info: CommitmentInfo$zodSchema.optional(),
   created_at: z.iso.datetime({ offset: true }).optional(),
@@ -89,6 +94,9 @@ export const InvoiceLineItemResponse$zodSchema: z.ZodType<
   quantity: z.string().optional(),
   status: Status$zodSchema.optional(),
   subscription_id: z.string().optional(),
+  subscription_line_item_id: z.string().optional().describe(
+    "sub_line_item_id links this invoice line item to the subscription_line_item that generated it.",
+  ),
   tenant_id: z.string().optional(),
   updated_at: z.iso.datetime({ offset: true }).optional(),
   updated_by: z.string().optional(),

package/src/models/lineitemcommitmentconfig.ts

@@ -4,12 +4,17 @@
 
 import * as z from "zod";
 import { BillingPeriod, BillingPeriod$zodSchema } from "./billingperiod.js";
+import {
+  CommitmentBucketRequest,
+  CommitmentBucketRequest$zodSchema,
+} from "./commitmentbucketrequest.js";
 import { CommitmentType, CommitmentType$zodSchema } from "./commitmenttype.js";
 
 export type LineItemCommitmentConfig = {
   commitment_amount?: number | undefined;
   commitment_duration?: BillingPeriod | undefined;
   commitment_quantity?: number | undefined;
+  commitment_time_buckets?: Array<CommitmentBucketRequest> | undefined;
   commitment_type?: CommitmentType | undefined;
   enable_true_up?: boolean | undefined;
   is_window_commitment?: boolean | undefined;
@@ -26,6 +31,10 @@ export const LineItemCommitmentConfig$zodSchema: z.ZodType<
   commitment_quantity: z.number().optional().describe(
     "CommitmentQuantity is the minimum quantity committed for this line item",
   ),
+  commitment_time_buckets: z.array(CommitmentBucketRequest$zodSchema).optional()
+    .describe(
+      "CommitmentTimeBuckets defines per-bucket commitment + inline price for\nwindows whose start UTC hour falls within each configured bucket. Each\nbucket carries its own price (materialized by the service). Requires\nIsWindowCommitment=true.",
+    ),
   commitment_type: CommitmentType$zodSchema.optional(),
   enable_true_up: z.boolean().optional().describe(
     "EnableTrueUp determines if true-up fee should be applied when usage is below commitment",

package/src/models/meterusageattribution.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type MeterUsageAttribution = {
+  external_customer_id?: string | undefined;
+  meter_id?: string | undefined;
+  qty_total?: string | undefined;
+};
+
+export const MeterUsageAttribution$zodSchema: z.ZodType<MeterUsageAttribution> =
+  z.object({
+    external_customer_id: z.string().optional(),
+    meter_id: z.string().optional(),
+    qty_total: z.string().optional(),
+  });

package/src/models/pricefilter.ts

@@ -4,6 +4,7 @@
 
 import * as z from "zod";
 import { ClosedEnum } from "../types/enums.js";
+import { BillingPeriod, BillingPeriod$zodSchema } from "./billingperiod.js";
 import {
   FilterCondition,
   FilterCondition$zodSchema,
@@ -27,6 +28,7 @@ export const PriceFilterOrder$zodSchema = z.enum([
 
 export type PriceFilter = {
   allow_expired_prices?: boolean | undefined;
+  billing_periods?: Array<BillingPeriod> | undefined;
   end_time?: string | undefined;
   entity_ids?: Array<string> | undefined;
   entity_type?: PriceEntityType | undefined;
@@ -48,6 +50,7 @@ export type PriceFilter = {
 
 export const PriceFilter$zodSchema: z.ZodType<PriceFilter> = z.object({
   allow_expired_prices: z.boolean().default(false),
+  billing_periods: z.array(BillingPeriod$zodSchema).optional(),
   end_time: z.iso.datetime({ offset: true }).optional(),
   entity_ids: z.array(z.string()).optional(),
   entity_type: PriceEntityType$zodSchema.optional(),

package/src/models/priceprice.ts

@@ -52,6 +52,7 @@ export type PricePrice = {
   price_unit_id?: string | undefined;
   price_unit_tiers?: Array<PricePriceTier> | undefined;
   price_unit_type?: PriceUnitType | undefined;
+  sequence?: number | undefined;
   start_date?: string | undefined;
   status?: Status | undefined;
   tenant_id?: string | undefined;
@@ -133,6 +134,9 @@ export const PricePrice$zodSchema: z.ZodType<PricePrice> = z.object({
     "PriceUnitTiers are the tiers for the price unit when BillingModel is TIERED",
   ),
   price_unit_type: PriceUnitType$zodSchema.optional(),
+  sequence: z.int().optional().describe(
+    "Sequence is the monotonic stamp bumped on every state change that\nsubscription line items need to react to. Read by the plan-price sync;\nset by the database (DEFAULT nextval) on create and by the price\nrepository on termination / compatibility-affecting edits.",
+  ),
   start_date: z.iso.datetime({ offset: true }).optional().describe(
     "StartDate is the start date of the price",
   ),

package/src/models/priceresponse.ts

@@ -65,6 +65,7 @@ export type PriceResponse = {
   price_unit_tiers?: Array<PricePriceTier> | undefined;
   price_unit_type?: PriceUnitType | undefined;
   pricing_unit?: PriceUnitResponse | undefined;
+  sequence?: number | undefined;
   start_date?: string | undefined;
   status?: Status | undefined;
   tenant_id?: string | undefined;
@@ -151,6 +152,9 @@ export const PriceResponse$zodSchema: z.ZodType<PriceResponse> = z.object({
   ),
   price_unit_type: PriceUnitType$zodSchema.optional(),
   pricing_unit: PriceUnitResponse$zodSchema.optional(),
+  sequence: z.int().optional().describe(
+    "Sequence is the monotonic stamp bumped on every state change that\nsubscription line items need to react to. Read by the plan-price sync;\nset by the database (DEFAULT nextval) on create and by the price\nrepository on termination / compatibility-affecting edits.",
+  ),
   start_date: z.iso.datetime({ offset: true }).optional().describe(
     "StartDate is the start date of the price",
   ),

package/src/models/submodifycouponaction.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const SubModifyCouponAction = {
+  Add: "add",
+  Remove: "remove",
+} as const;
+export type SubModifyCouponAction = ClosedEnum<typeof SubModifyCouponAction>;
+
+export const SubModifyCouponAction$zodSchema = z.enum([
+  "add",
+  "remove",
+]);

package/src/models/submodifycouponparams.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  SubModifyCouponAction,
+  SubModifyCouponAction$zodSchema,
+} from "./submodifycouponaction.js";
+
+export type SubModifyCouponParams = {
+  action: SubModifyCouponAction;
+  association_id?: string | undefined;
+  coupon_code?: string | undefined;
+  effective_date?: string | undefined;
+  end_date?: string | undefined;
+  start_date?: string | undefined;
+  subscription_id?: string | undefined;
+  subscription_line_item_id?: string | undefined;
+};
+
+export const SubModifyCouponParams$zodSchema: z.ZodType<SubModifyCouponParams> =
+  z.object({
+    action: SubModifyCouponAction$zodSchema,
+    association_id: z.string().optional().describe(
+      "Required when action=\"remove\". ID of the CouponAssociation to soft-delete.",
+    ),
+    coupon_code: z.string().optional().describe(
+      "Required for action=\"add\". Coupon code of the coupon to attach.",
+    ),
+    effective_date: z.iso.datetime({ offset: true }).optional().describe(
+      "Optional. When to apply the change; defaults to now if omitted.",
+    ),
+    end_date: z.iso.datetime({ offset: true }).optional().describe(
+      "Optional. When the coupon association ends.",
+    ),
+    start_date: z.iso.datetime({ offset: true }).optional().describe(
+      "Optional. When the coupon association starts; defaults to EffectiveDate.",
+    ),
+    subscription_id: z.string().optional().describe(
+      "Optional. Apply at subscription level. Mutually exclusive with SubscriptionLineItemID.",
+    ),
+    subscription_line_item_id: z.string().optional().describe(
+      "Optional. Apply at a specific line item. Mutually exclusive with SubscriptionID.",
+    ),
+  });

package/src/models/submodifyinheritancerequest.ts

@@ -3,13 +3,26 @@
  */
 
 import * as z from "zod";
+import {
+  InheritanceAction,
+  InheritanceAction$zodSchema,
+} from "./inheritanceaction.js";
 
 export type SubModifyInheritanceRequest = {
+  action?: InheritanceAction | undefined;
   external_customer_ids_to_inherit_subscription?: Array<string> | undefined;
+  external_customer_ids_to_remove?: Array<string> | undefined;
 };
 
 export const SubModifyInheritanceRequest$zodSchema: z.ZodType<
   SubModifyInheritanceRequest
 > = z.object({
-  external_customer_ids_to_inherit_subscription: z.array(z.string()).optional(),
+  action: InheritanceAction$zodSchema.optional(),
+  external_customer_ids_to_inherit_subscription: z.array(z.string()).optional()
+    .describe(
+      "ExternalCustomerIDsToInheritSubscription is used for action=\"add\".",
+    ),
+  external_customer_ids_to_remove: z.array(z.string()).optional().describe(
+    "ExternalCustomerIDsToRemove is used for action=\"remove\".",
+  ),
 });

package/src/models/submodifytaxaction.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const SubModifyTaxAction = {
+  Add: "add",
+  Remove: "remove",
+} as const;
+export type SubModifyTaxAction = ClosedEnum<typeof SubModifyTaxAction>;
+
+export const SubModifyTaxAction$zodSchema = z.enum([
+  "add",
+  "remove",
+]);

package/src/models/submodifytaxparams.ts

@@ -0,0 +1,30 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  SubModifyTaxAction,
+  SubModifyTaxAction$zodSchema,
+} from "./submodifytaxaction.js";
+
+export type SubModifyTaxParams = {
+  action: SubModifyTaxAction;
+  association_id?: string | undefined;
+  effective_date?: string | undefined;
+  tax_rate_id?: string | undefined;
+};
+
+export const SubModifyTaxParams$zodSchema: z.ZodType<SubModifyTaxParams> = z
+  .object({
+    action: SubModifyTaxAction$zodSchema,
+    association_id: z.string().optional().describe(
+      "Required when action=\"remove\". ID of the TaxAssociation to soft-delete.",
+    ),
+    effective_date: z.iso.datetime({ offset: true }).optional().describe(
+      "Optional. When to apply the change; defaults to now if omitted.",
+    ),
+    tax_rate_id: z.string().optional().describe(
+      "Required when action=\"add\". ID of the active tax rate to attach.",
+    ),
+  });

package/src/models/submodifytrialendrequest.ts

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { TrialEndAction, TrialEndAction$zodSchema } from "./trialendaction.js";
+
+export type SubModifyTrialEndRequest = {
+  action: TrialEndAction;
+  new_trial_end?: string | undefined;
+};
+
+export const SubModifyTrialEndRequest$zodSchema: z.ZodType<
+  SubModifyTrialEndRequest
+> = z.object({
+  action: TrialEndAction$zodSchema,
+  new_trial_end: z.iso.datetime({ offset: true }).optional().describe(
+    "NewTrialEnd is the new trial end date. Required when action is \"scheduled_date\".",
+  ),
+});

package/src/models/subscriptioncouponinput.ts

@@ -0,0 +1,29 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type SubscriptionCouponInput = {
+  coupon_code: string;
+  end_date?: string | undefined;
+  price_id?: string | undefined;
+  start_date?: string | undefined;
+};
+
+export const SubscriptionCouponInput$zodSchema: z.ZodType<
+  SubscriptionCouponInput
+> = z.object({
+  coupon_code: z.string().describe(
+    "CouponCode is the coupon's human-readable code (case-insensitive). Required.",
+  ),
+  end_date: z.iso.datetime({ offset: true }).optional().describe(
+    "EndDate is when the coupon ends; overrides duration_in_periods calculation.",
+  ),
+  price_id: z.string().optional().describe(
+    "PriceID is the price ID of the line item to target; omit for subscription-level.",
+  ),
+  start_date: z.iso.datetime({ offset: true }).optional().describe(
+    "StartDate is when the coupon starts; defaults to subscription/phase StartDate.",
+  ),
+});

package/src/models/subscriptionlineitemresponse.ts

@@ -13,6 +13,10 @@ import {
   SubscriptionLineItemEntityType,
   SubscriptionLineItemEntityType$zodSchema,
 } from "./subscriptionlineitementitytype.js";
+import {
+  TimeOfDayBucket,
+  TimeOfDayBucket$zodSchema,
+} from "./timeofdaybucket.js";
 
 export type SubscriptionLineItemResponse = {
   addon_association_id?: string | undefined;
@@ -22,6 +26,7 @@ export type SubscriptionLineItemResponse = {
   commitment_duration?: BillingPeriod | undefined;
   commitment_overage_factor?: string | undefined;
   commitment_quantity?: string | undefined;
+  commitment_time_buckets?: Array<TimeOfDayBucket> | undefined;
   commitment_true_up_enabled?: boolean | undefined;
   commitment_type?: CommitmentType | undefined;
   commitment_windowed?: boolean | undefined;
@@ -67,6 +72,7 @@ export const SubscriptionLineItemResponse$zodSchema: z.ZodType<
   commitment_duration: BillingPeriod$zodSchema.optional(),
   commitment_overage_factor: z.string().optional(),
   commitment_quantity: z.string().optional(),
+  commitment_time_buckets: z.array(TimeOfDayBucket$zodSchema).optional(),
   commitment_true_up_enabled: z.boolean().optional(),
   commitment_type: CommitmentType$zodSchema.optional(),
   commitment_windowed: z.boolean().optional(),

package/src/models/subscriptionmodifytype.ts

@@ -9,6 +9,9 @@ export const SubscriptionModifyType = {
   Inheritance: "inheritance",
   QuantityChange: "quantity_change",
   GroupedInvoicing: "grouped_invoicing",
+  TrialEnd: "trial_end",
+  Coupon: "coupon",
+  Tax: "tax",
 } as const;
 export type SubscriptionModifyType = ClosedEnum<typeof SubscriptionModifyType>;
 
@@ -16,4 +19,7 @@ export const SubscriptionModifyType$zodSchema = z.enum([
   "inheritance",
   "quantity_change",
   "grouped_invoicing",
+  "trial_end",
+  "coupon",
+  "tax",
 ]);

package/src/models/subscriptionphasecreaterequest.ts

@@ -11,6 +11,10 @@ import {
   OverrideLineItemRequest,
   OverrideLineItemRequest$zodSchema,
 } from "./overridelineitemrequest.js";
+import {
+  SubscriptionCouponInput,
+  SubscriptionCouponInput$zodSchema,
+} from "./subscriptioncouponinput.js";
 
 export type SubscriptionPhaseCreateRequest = {
   coupons?: Array<string> | undefined;
@@ -20,19 +24,18 @@ export type SubscriptionPhaseCreateRequest = {
   metadata?: { [k: string]: string } | undefined;
   override_line_items?: Array<OverrideLineItemRequest> | undefined;
   start_date: string;
+  subscription_coupons?: Array<SubscriptionCouponInput> | undefined;
 };
 
 export const SubscriptionPhaseCreateRequest$zodSchema: z.ZodType<
   SubscriptionPhaseCreateRequest
 > = z.object({
   coupons: z.array(z.string()).optional().describe(
-    "Coupons represents subscription-level coupons to be applied to this phase",
+    "Deprecated: use SubscriptionCoupons instead.",
   ),
   end_date: z.iso.datetime({ offset: true }).optional(),
   line_item_coupons: z.record(z.string(), z.array(z.string())).optional()
-    .describe(
-      "LineItemCoupons represents line item-level coupons (map of line_item_id to coupon IDs)",
-    ),
+    .describe("Deprecated: use SubscriptionCoupons instead."),
   line_items: z.array(CreateSubscriptionLineItemRequest$zodSchema).optional()
     .describe(
       "LineItems are extra line items to add during this phase, primarily one-time charges.\nEach item's start_date defaults to the phase's start_date when not provided.",
@@ -43,4 +46,8 @@ export const SubscriptionPhaseCreateRequest$zodSchema: z.ZodType<
       "OverrideLineItems allows customizing specific prices for this phase\nIf not provided, phase will use the same line items as the subscription (plan prices)",
     ),
   start_date: z.iso.datetime({ offset: true }),
+  subscription_coupons: z.array(SubscriptionCouponInput$zodSchema).optional()
+    .describe(
+      "SubscriptionCoupons is the preferred way to attach coupons to this phase.",
+    ),
 });

package/src/models/subscriptionresponse.ts

@@ -99,6 +99,7 @@ export type SubscriptionResponse = {
   status?: Status | undefined;
   subscription_status?: SubscriptionStatus | undefined;
   subscription_type?: SubscriptionType | undefined;
+  synced_price_sequence?: number | undefined;
   tenant_id?: string | undefined;
   trial_end?: string | undefined;
   trial_start?: string | undefined;
@@ -213,6 +214,9 @@ export const SubscriptionResponse$zodSchema: z.ZodType<SubscriptionResponse> = z
     status: Status$zodSchema.optional(),
     subscription_status: SubscriptionStatus$zodSchema.optional(),
     subscription_type: SubscriptionType$zodSchema.optional(),
+    synced_price_sequence: z.int().optional().describe(
+      "SyncedPriceSequence is the plan-price sequence up to which this\nsubscription's line items have been reconciled. Bumped by the\nplan-price sync after a successful pass.",
+    ),
     tenant_id: z.string().optional(),
     trial_end: z.iso.datetime({ offset: true }).optional().describe(
       "TrialEnd is the end date of the trial period",

package/src/models/subscriptionresponsev2.ts

@@ -89,11 +89,13 @@ export type SubscriptionResponseV2 = {
   phases?: Array<SubscriptionPhaseResponse> | undefined;
   plan?: PlanResponse | undefined;
   plan_id?: string | undefined;
+  plan_prices_out_of_sync?: boolean | undefined;
   proration_behavior?: ProrationBehavior | undefined;
   start_date?: string | undefined;
   status?: Status | undefined;
   subscription_status?: SubscriptionStatus | undefined;
   subscription_type?: SubscriptionType | undefined;
+  synced_price_sequence?: number | undefined;
   tenant_id?: string | undefined;
   trial_end?: string | undefined;
   trial_start?: string | undefined;
@@ -206,6 +208,9 @@ export const SubscriptionResponseV2$zodSchema: z.ZodType<
   plan_id: z.string().optional().describe(
     "PlanID is the identifier for the plan in our system",
   ),
+  plan_prices_out_of_sync: z.boolean().optional().describe(
+    "PlanPricesOutOfSync is true when the subscription's synced_price_sequence\nis behind the plan's current max prices.sequence — i.e. plan-price\nchanges have not yet been reconciled into this subscription's line items.",
+  ),
   proration_behavior: ProrationBehavior$zodSchema.optional(),
   start_date: z.iso.datetime({ offset: true }).optional().describe(
     "StartDate is the start date of the subscription",
@@ -213,6 +218,9 @@ export const SubscriptionResponseV2$zodSchema: z.ZodType<
   status: Status$zodSchema.optional(),
   subscription_status: SubscriptionStatus$zodSchema.optional(),
   subscription_type: SubscriptionType$zodSchema.optional(),
+  synced_price_sequence: z.int().optional().describe(
+    "SyncedPriceSequence is the plan-price sequence up to which this\nsubscription's line items have been reconciled. Bumped by the\nplan-price sync after a successful pass.",
+  ),
   tenant_id: z.string().optional(),
   trial_end: z.iso.datetime({ offset: true }).optional().describe(
     "TrialEnd is the end date of the trial period",

package/src/models/subscriptionsubscriptionlineitem.ts

@@ -13,6 +13,10 @@ import {
   SubscriptionLineItemEntityType,
   SubscriptionLineItemEntityType$zodSchema,
 } from "./subscriptionlineitementitytype.js";
+import {
+  TimeOfDayBucket,
+  TimeOfDayBucket$zodSchema,
+} from "./timeofdaybucket.js";
 
 export type SubscriptionSubscriptionLineItem = {
   addon_association_id?: string | undefined;
@@ -22,6 +26,7 @@ export type SubscriptionSubscriptionLineItem = {
   commitment_duration?: BillingPeriod | undefined;
   commitment_overage_factor?: string | undefined;
   commitment_quantity?: string | undefined;
+  commitment_time_buckets?: Array<TimeOfDayBucket> | undefined;
   commitment_true_up_enabled?: boolean | undefined;
   commitment_type?: CommitmentType | undefined;
   commitment_windowed?: boolean | undefined;
@@ -67,6 +72,7 @@ export const SubscriptionSubscriptionLineItem$zodSchema: z.ZodType<
   commitment_duration: BillingPeriod$zodSchema.optional(),
   commitment_overage_factor: z.string().optional(),
   commitment_quantity: z.string().optional(),
+  commitment_time_buckets: z.array(TimeOfDayBucket$zodSchema).optional(),
   commitment_true_up_enabled: z.boolean().optional(),
   commitment_type: CommitmentType$zodSchema.optional(),
   commitment_windowed: z.boolean().optional(),

package/src/models/timeofdaybucket.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { Bucket, Bucket$zodSchema } from "./bucket.js";
+import { CommitmentType, CommitmentType$zodSchema } from "./commitmenttype.js";
+
+export type TimeOfDayBucket = {
+  commitment_type?: CommitmentType | undefined;
+  commitment_value?: string | undefined;
+  end?: Bucket | undefined;
+  id?: string | undefined;
+  overage_factor?: number | undefined;
+  price_id?: string | undefined;
+  start?: Bucket | undefined;
+  true_up_enabled?: boolean | undefined;
+};
+
+export const TimeOfDayBucket$zodSchema: z.ZodType<TimeOfDayBucket> = z.object({
+  commitment_type: CommitmentType$zodSchema.optional(),
+  commitment_value: z.string().optional(),
+  end: Bucket$zodSchema.optional(),
+  id: z.string().optional().describe(
+    "ID is server-assigned. Stable for the lifetime of the line item;\ninvoice breakdown and analytics responses reference this ID.",
+  ),
+  overage_factor: z.number().optional(),
+  price_id: z.string().optional().describe(
+    "PriceID is the SUBSCRIPTION-scoped price created at bucket-creation time.\nImmutable post-create; changing pricing requires a successor line item.",
+  ),
+  start: Bucket$zodSchema.optional(),
+  true_up_enabled: z.boolean().optional(),
+});

package/src/models/trialendaction.ts

@@ -0,0 +1,17 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const TrialEndAction = {
+  Immediate: "immediate",
+  ScheduledDate: "scheduled_date",
+} as const;
+export type TrialEndAction = ClosedEnum<typeof TrialEndAction>;
+
+export const TrialEndAction$zodSchema = z.enum([
+  "immediate",
+  "scheduled_date",
+]);

package/src/models/updatesubscriptionlineitemrequest.ts

@@ -6,6 +6,10 @@ import * as z from "zod";
 import { BillingModel, BillingModel$zodSchema } from "./billingmodel.js";
 import { BillingPeriod, BillingPeriod$zodSchema } from "./billingperiod.js";
 import { BillingTier, BillingTier$zodSchema } from "./billingtier.js";
+import {
+  CommitmentBucketRequest,
+  CommitmentBucketRequest$zodSchema,
+} from "./commitmentbucketrequest.js";
 import { CommitmentType, CommitmentType$zodSchema } from "./commitmenttype.js";
 import {
   CreatePriceTier,
@@ -23,6 +27,7 @@ export type UpdateSubscriptionLineItemRequest = {
   commitment_duration?: BillingPeriod | undefined;
   commitment_overage_factor?: number | undefined;
   commitment_quantity?: number | undefined;
+  commitment_time_buckets?: Array<CommitmentBucketRequest> | undefined;
   commitment_true_up_enabled?: boolean | undefined;
   commitment_type?: CommitmentType | undefined;
   commitment_windowed?: boolean | undefined;
@@ -44,6 +49,10 @@ export const UpdateSubscriptionLineItemRequest$zodSchema: z.ZodType<
   commitment_duration: BillingPeriod$zodSchema.optional(),
   commitment_overage_factor: z.number().optional(),
   commitment_quantity: z.number().optional(),
+  commitment_time_buckets: z.array(CommitmentBucketRequest$zodSchema).optional()
+    .describe(
+      "Pointer so an explicit empty array can clear existing buckets (omission keeps them).",
+    ),
   commitment_true_up_enabled: z.boolean().optional(),
   commitment_type: CommitmentType$zodSchema.optional(),
   commitment_windowed: z.boolean().optional(),

package/src/models/usageanalyticitem.ts

@@ -8,6 +8,7 @@ import {
   AggregationType,
   AggregationType$zodSchema,
 } from "./aggregationtype.js";
+import { BucketSummary, BucketSummary$zodSchema } from "./bucketsummary.js";
 import { CommitmentInfo, CommitmentInfo$zodSchema } from "./commitmentinfo.js";
 import { Feature, Feature$zodSchema } from "./feature.js";
 import { GroupGroup, GroupGroup$zodSchema } from "./groupgroup.js";
@@ -29,6 +30,7 @@ export type UsageAnalyticItem = {
   add_on_id?: string | undefined;
   addon?: Addon | undefined;
   aggregation_type?: AggregationType | undefined;
+  bucket_summaries?: Array<BucketSummary> | undefined;
   commitment_info?: CommitmentInfo | undefined;
   currency?: string | undefined;
   event_count?: number | undefined;
@@ -64,6 +66,9 @@ export const UsageAnalyticItem$zodSchema: z.ZodType<UsageAnalyticItem> = z
     add_on_id: z.string().optional(),
     addon: Addon$zodSchema.optional(),
     aggregation_type: AggregationType$zodSchema.optional(),
+    bucket_summaries: z.array(BucketSummary$zodSchema).optional().describe(
+      "BucketSummaries is populated only when BreakdownBucket=true. Contains one\nentry per defined CommitmentTimeBucket plus one for out-of-bucket usage.",
+    ),
     commitment_info: CommitmentInfo$zodSchema.optional(),
     currency: z.string().optional(),
     event_count: z.int().optional().describe(