@openmeter/client 1.0.0-beta-1e01089e8f75 → 1.0.0-beta-19a1f6bdbcd5

package/dist/models/schemas.js

@@ -466,23 +466,23 @@ export const chargeFlatFeeDiscounts = z
 export const rateCardProrationMode = z
     .enum(['no_proration', 'prorate_prices'])
     .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
-export const priceFree = z
-    .object({
-    type: z.literal('free').describe('The type of the price.'),
-})
-    .describe('Free price.');
-export const subscriptionCostBasisMode = z
-    .enum(['dynamic', 'pinned'])
-    .describe('Controls how custom-currency cost bases are selected for the subscription.');
-export const subscriptionStatus = z
-    .enum(['active', 'inactive', 'canceled', 'scheduled'])
-    .describe('Subscription status.');
 export const unitConfigOperation = z
     .enum(['divide', 'multiply'])
     .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
 export const unitConfigRoundingMode = z
     .enum(['ceiling', 'floor', 'half_up', 'none'])
     .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
+export const subscriptionCostBasisMode = z
+    .enum(['dynamic', 'pinned'])
+    .describe('Controls how custom-currency cost bases are selected for the subscription.');
+export const subscriptionStatus = z
+    .enum(['active', 'inactive', 'canceled', 'scheduled'])
+    .describe('Subscription status.');
+export const priceFree = z
+    .object({
+    type: z.literal('free').describe('The type of the price.'),
+})
+    .describe('Free price.');
 export const rateCardStaticEntitlement = z
     .object({
     type: z.literal('static').describe('The type of the entitlement template.'),
@@ -1110,12 +1110,6 @@ export const priceFlat = z
     amount: numeric,
 })
     .describe('Flat price.');
-export const priceUnit = z
-    .object({
-    type: z.literal('unit').describe('The type of the price.'),
-    amount: numeric,
-})
-    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const rateCardDiscounts = z
     .object({
     percentage: z
@@ -1139,12 +1133,18 @@ export const totals = z
     total: numeric,
 })
     .describe('Totals contains the summaries of all calculations for a billing resource.');
+export const priceUnit = z
+    .object({
+    type: z.literal('unit').describe('The type of the price.'),
+    amount: numeric,
+})
+    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const spendCommitments = z
     .object({
     minimumAmount: numeric.optional(),
     maximumAmount: numeric.optional(),
 })
-    .describe('Spend commitments for a rate card. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
+    .describe('Spend commitments for a usage-based price. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
 export const invoiceLineCreditsApplied = z
     .object({
     amount: numeric,
@@ -1175,7 +1175,7 @@ export const updatePriceUnit = z
     type: z.literal('unit').describe('The type of the price.'),
     amount: numeric,
 })
-    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes).');
+    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const updateDiscounts = z
     .object({
     percentage: z
@@ -2072,6 +2072,23 @@ export const subscriptionProRatingConfig = z
     mode: rateCardProrationMode,
 })
     .describe('The pro-rating configuration of a subscription.');
+export const unitConfig = z
+    .object({
+    operation: unitConfigOperation,
+    conversionFactor: numeric,
+    rounding: unitConfigRoundingMode.optional().default('none'),
+    precision: z
+        .number()
+        .int()
+        .optional()
+        .default(0)
+        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
+    displayUnit: z
+        .string()
+        .optional()
+        .describe('A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.'),
+})
+    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
 export const subscriptionCreate = z
     .object({
     labels: labels.optional(),
@@ -2097,23 +2114,6 @@ export const subscriptionCreate = z
     costBasisMode: subscriptionCostBasisMode.optional().default('dynamic'),
 })
     .describe('Subscription create request.');
-export const unitConfig = z
-    .object({
-    operation: unitConfigOperation,
-    conversionFactor: numeric,
-    rounding: unitConfigRoundingMode.optional().default('none'),
-    precision: z
-        .number()
-        .int()
-        .optional()
-        .default(0)
-        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
-    displayUnit: z
-        .string()
-        .optional()
-        .describe('A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.'),
-})
-    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Applied at the rate card level so the same feature can be billed in different units across plans. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
 export const subscriptionEditTiming = z
     .union([subscriptionEditTimingEnum, dateTime])
     .describe('Subscription edit timing defined when the changes should take effect. If the provided configuration is not supported by the subscription, an error will be returned.');
@@ -2426,26 +2426,26 @@ export const creditTransaction = z
         .describe('The available balance before and after the transaction.'),
 })
     .describe("A credit transaction represents a single credit movement on the customer's balance. Credit transactions are immutable.");
+export const chargeTotals = z
+    .object({
+    booked: totals,
+    realtime: totals.optional(),
+})
+    .describe('The totals of a charge. RealTime is only expanded when the `real_time_usage` expand is used.');
 export const priceTier = z
     .object({
     upToAmount: numeric.optional(),
     flatPrice: priceFlat.optional(),
     unitPrice: priceUnit.optional(),
 })
-    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the rate card, up_to_amount is expressed in converted billing units.');
-export const chargeTotals = z
-    .object({
-    booked: totals,
-    realtime: totals.optional(),
-})
-    .describe('The totals of a change. RealTime is only expanded when the `real_time_usage` expand is used.');
+    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the containing resource, up_to_amount is expressed in converted billing units.');
 export const updatePriceTier = z
     .object({
     upToAmount: numeric.optional(),
     flatPrice: updatePriceFlat.optional(),
     unitPrice: updatePriceUnit.optional(),
 })
-    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the rate card, up_to_amount is expressed in converted billing units.');
+    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the containing resource, up_to_amount is expressed in converted billing units.');
 export const featureLlmUnitCost = z
     .object({
     type: z
@@ -3162,7 +3162,7 @@ export const priceGraduated = z
         .min(1)
         .describe('The tiers of the graduated price. At least one tier is required.'),
 })
-    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.");
+    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.");
 export const priceVolume = z
     .object({
     type: z.literal('volume').describe('The type of the price.'),
@@ -3171,7 +3171,7 @@ export const priceVolume = z
         .min(1)
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
-    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.');
+    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
 export const updatePriceGraduated = z
     .object({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -3180,7 +3180,7 @@ export const updatePriceGraduated = z
         .min(1)
         .describe('The tiers of the graduated price. At least one tier is required.'),
 })
-    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.");
+    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.");
 export const updatePriceVolume = z
     .object({
     type: z.literal('volume').describe('The type of the price.'),
@@ -3189,7 +3189,7 @@ export const updatePriceVolume = z
         .min(1)
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
-    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.');
+    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
 export const featureUnitCost = z
     .discriminatedUnion('type', [featureManualUnitCost, featureLlmUnitCost])
     .describe('Per-unit cost configuration for a feature. Either a fixed manual amount or a dynamic LLM cost lookup.');
@@ -3451,6 +3451,56 @@ export const workflowCollectionAlignment = z
     workflowCollectionAlignmentAnchored,
 ])
     .describe('The alignment for collecting the pending line items into an invoice. Defaults to subscription, which means that we are to create a new invoice every time the a subscription period starts (for in advance items) or ends (for in arrears items).');
+export const chargeFlatFee = z
+    .object({
+    id: ulid,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labels.optional(),
+    createdAt: dateTime,
+    updatedAt: dateTime,
+    deletedAt: dateTime.optional(),
+    type: z.literal('flat_fee').describe('The type of the charge.'),
+    customer: billingCustomerReference,
+    lifecycleController: lifecycleController,
+    subscription: subscriptionReference.optional(),
+    currency: currencyCode,
+    status: chargeStatus,
+    invoiceAt: dateTime,
+    servicePeriod: closedPeriod,
+    fullServicePeriod: closedPeriod,
+    billingPeriod: closedPeriod,
+    advanceAfter: dateTime.optional(),
+    uniqueReferenceId: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlementMode: settlementMode,
+    taxConfig: taxConfig.optional(),
+    paymentTerm: pricePaymentTerm,
+    discounts: chargeFlatFeeDiscounts.optional(),
+    featureKey: z
+        .string()
+        .optional()
+        .describe('The feature associated with the charge, when applicable.'),
+    featureId: z
+        .string()
+        .optional()
+        .describe('The feature ID associated with the charge.'),
+    prorationConfiguration: rateCardProrationConfiguration,
+    amountAfterProration: currencyAmount,
+    price: priceFlat,
+    systemIntent: chargeFlatFeeSystemIntent.optional(),
+})
+    .describe('A flat fee charge for a customer.');
 export const taxCodePagePaginatedResponse = z
     .object({
     data: z.array(taxCode),
@@ -3688,6 +3738,9 @@ export const entitlementAccessQueryResult = z
     updatedAt: dateTime,
 })
     .describe('Access evaluation result for a single resolved customer.');
+export const priceUsageBased = z
+    .discriminatedUnion('type', [priceUnit, priceGraduated, priceVolume])
+    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const price = z
     .discriminatedUnion('type', [
     priceFree,
@@ -3697,9 +3750,6 @@ export const price = z
     priceVolume,
 ])
     .describe('Price.');
-export const priceUsageBased = z
-    .discriminatedUnion('type', [priceUnit, priceGraduated, priceVolume])
-    .describe('Usage-based price types that can appear on a usage-based rate card. When UnitConfig is present on the rate card, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
 export const updatePrice = z
     .discriminatedUnion('type', [
     updatePriceFree,
@@ -3837,56 +3887,6 @@ export const entitlementAccessQueryResponse = z
     meta: cursorMeta,
 })
     .describe('Response of the entitlement access query.');
-export const chargeFlatFee = z
-    .object({
-    id: ulid,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labels.optional(),
-    createdAt: dateTime,
-    updatedAt: dateTime,
-    deletedAt: dateTime.optional(),
-    type: z.literal('flat_fee').describe('The type of the charge.'),
-    customer: billingCustomerReference,
-    lifecycleController: lifecycleController,
-    subscription: subscriptionReference.optional(),
-    currency: currencyCode,
-    status: chargeStatus,
-    invoiceAt: dateTime,
-    servicePeriod: closedPeriod,
-    fullServicePeriod: closedPeriod,
-    billingPeriod: closedPeriod,
-    advanceAfter: dateTime.optional(),
-    uniqueReferenceId: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlementMode: settlementMode,
-    taxConfig: taxConfig.optional(),
-    paymentTerm: pricePaymentTerm,
-    discounts: chargeFlatFeeDiscounts.optional(),
-    featureKey: z
-        .string()
-        .optional()
-        .describe('The feature associated with the charge, when applicable.'),
-    featureId: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
-    prorationConfiguration: rateCardProrationConfiguration,
-    amountAfterProration: currencyAmount,
-    price: price,
-    systemIntent: chargeFlatFeeSystemIntent.optional(),
-})
-    .describe('A flat fee charge for a customer.');
 export const chargeUsageBasedSystemIntent = z
     .object({
     name: z
@@ -3905,7 +3905,9 @@ export const chargeUsageBasedSystemIntent = z
     fullServicePeriod: closedPeriod,
     billingPeriod: closedPeriod,
     discounts: rateCardDiscounts.optional(),
-    price: price,
+    price: priceUsageBased,
+    commitments: spendCommitments.optional(),
+    unitConfig: unitConfig.optional(),
     deletedAt: dateTime.optional(),
 })
     .describe('Usage-based intent fields from the system lifecycle controller shadowed by a manual override.');
@@ -3936,7 +3938,9 @@ export const createChargeUsageBasedRequest = z
     featureId: z
         .string()
         .describe('The feature ID associated with the charge.'),
-    price: price,
+    price: priceUsageBased,
+    commitments: spendCommitments.optional(),
+    unitConfig: unitConfig.optional(),
     fullServicePeriod: closedPeriod.optional(),
     billingPeriod: closedPeriod.optional(),
 })
@@ -4051,7 +4055,9 @@ export const chargeUsageBased = z
         .string()
         .describe('The feature ID associated with the charge.'),
     totals: chargeTotals,
-    price: price,
+    price: priceUsageBased,
+    commitments: spendCommitments.optional(),
+    unitConfig: unitConfig.optional(),
     systemIntent: chargeUsageBasedSystemIntent.optional(),
 })
     .describe('A usage-based charge for a customer.');
@@ -5786,23 +5792,23 @@ export const chargeFlatFeeDiscountsWire = z
 export const rateCardProrationModeWire = z
     .enum(['no_proration', 'prorate_prices'])
     .describe('The proration mode of the rate card. Values: - `no_proration`: No proration. - `prorate_prices`: Prorate the price based on the time remaining in the billing period.');
-export const priceFreeWire = z
-    .strictObject({
-    type: z.literal('free').describe('The type of the price.'),
-})
-    .describe('Free price.');
-export const subscriptionCostBasisModeWire = z
-    .enum(['dynamic', 'pinned'])
-    .describe('Controls how custom-currency cost bases are selected for the subscription.');
-export const subscriptionStatusWire = z
-    .enum(['active', 'inactive', 'canceled', 'scheduled'])
-    .describe('Subscription status.');
 export const unitConfigOperationWire = z
     .enum(['divide', 'multiply'])
     .describe('The arithmetic operation used to convert raw metered units into billing units. - `divide`: Divide the metered quantity by the conversion factor (e.g., bytes ÷ 1e9 = GB). - `multiply`: Multiply the metered quantity by the conversion factor (e.g., cost × 1.2 = cost + 20% margin).');
 export const unitConfigRoundingModeWire = z
     .enum(['ceiling', 'floor', 'half_up', 'none'])
     .describe('The rounding mode applied to the converted quantity for invoicing. Rounding is applied only to the invoiced quantity. Entitlement balance checks use the precise decimal value after conversion. - `ceiling`: Round up to the next integer (typical for package-style billing). - `floor`: Round down to the previous integer. - `half_up`: Round to the nearest integer, with 0.5 rounding up. - `none`: No rounding; the converted value is used as-is.');
+export const subscriptionCostBasisModeWire = z
+    .enum(['dynamic', 'pinned'])
+    .describe('Controls how custom-currency cost bases are selected for the subscription.');
+export const subscriptionStatusWire = z
+    .enum(['active', 'inactive', 'canceled', 'scheduled'])
+    .describe('Subscription status.');
+export const priceFreeWire = z
+    .strictObject({
+    type: z.literal('free').describe('The type of the price.'),
+})
+    .describe('Free price.');
 export const rateCardStaticEntitlementWire = z
     .strictObject({
     type: z.literal('static').describe('The type of the entitlement template.'),
@@ -6424,12 +6430,6 @@ export const priceFlatWire = z
     amount: numericWire,
 })
     .describe('Flat price.');
-export const priceUnitWire = z
-    .strictObject({
-    type: z.literal('unit').describe('The type of the price.'),
-    amount: numericWire,
-})
-    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const rateCardDiscountsWire = z
     .strictObject({
     percentage: z
@@ -6453,12 +6453,18 @@ export const totalsWire = z
     total: numericWire,
 })
     .describe('Totals contains the summaries of all calculations for a billing resource.');
+export const priceUnitWire = z
+    .strictObject({
+    type: z.literal('unit').describe('The type of the price.'),
+    amount: numericWire,
+})
+    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const spendCommitmentsWire = z
     .strictObject({
     minimum_amount: numericWire.optional(),
     maximum_amount: numericWire.optional(),
 })
-    .describe('Spend commitments for a rate card. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
+    .describe('Spend commitments for a usage-based price. The customer is committed to spend at least the minimum amount and at most the maximum amount.');
 export const invoiceLineCreditsAppliedWire = z
     .strictObject({
     amount: numericWire,
@@ -6489,7 +6495,7 @@ export const updatePriceUnitWire = z
     type: z.literal('unit').describe('The type of the price.'),
     amount: numericWire,
 })
-    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes).');
+    .describe('Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the object, billing units are the converted quantities (e.g. GB instead of bytes).');
 export const updateDiscountsWire = z
     .strictObject({
     percentage: z
@@ -7369,6 +7375,22 @@ export const subscriptionProRatingConfigWire = z
     mode: rateCardProrationModeWire,
 })
     .describe('The pro-rating configuration of a subscription.');
+export const unitConfigWire = z
+    .strictObject({
+    operation: unitConfigOperationWire,
+    conversion_factor: numericWire,
+    rounding: unitConfigRoundingModeWire.optional(),
+    precision: z
+        .number()
+        .int()
+        .optional()
+        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
+    display_unit: z
+        .string()
+        .optional()
+        .describe('A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.'),
+})
+    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Stored with a resource\'s rating configuration so the same metered feature can be billed in different units across plans and charges. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
 export const subscriptionCreateWire = z
     .strictObject({
     labels: labelsWire.optional(),
@@ -7394,22 +7416,6 @@ export const subscriptionCreateWire = z
     cost_basis_mode: subscriptionCostBasisModeWire.optional(),
 })
     .describe('Subscription create request.');
-export const unitConfigWire = z
-    .strictObject({
-    operation: unitConfigOperationWire,
-    conversion_factor: numericWire,
-    rounding: unitConfigRoundingModeWire.optional(),
-    precision: z
-        .number()
-        .int()
-        .optional()
-        .describe('The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers).'),
-    display_unit: z
-        .string()
-        .optional()
-        .describe('A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered.'),
-})
-    .describe('Unit conversion configuration. Transforms raw metered quantities into billing-ready units before pricing and entitlement evaluation. Applied at the rate card level so the same feature can be billed in different units across plans. Examples: - Meter bytes, bill GB: operation=divide, conversionFactor=1e9, rounding=ceiling, displayUnit="GB" - Meter seconds, bill hours: operation=divide, conversionFactor=3600, rounding=ceiling, displayUnit="hours" - Cost + 20% margin: operation=multiply, conversionFactor=1.2 - Bill per million tokens: operation=divide, conversionFactor=1e6, rounding=ceiling, displayUnit="M" v1 equivalents: - DynamicPrice(multiplier): operation=multiply, conversionFactor=multiplier + UnitPrice(amount=1) - PackagePrice(amount, quantityPerPkg): operation=divide, conversionFactor=quantityPerPkg, rounding=ceiling + UnitPrice(amount)');
 export const subscriptionEditTimingWire = z
     .union([subscriptionEditTimingEnumWire, dateTimeWire])
     .describe('Subscription edit timing defined when the changes should take effect. If the provided configuration is not supported by the subscription, an error will be returned.');
@@ -7716,26 +7722,26 @@ export const creditTransactionWire = z
         .describe('The available balance before and after the transaction.'),
 })
     .describe("A credit transaction represents a single credit movement on the customer's balance. Credit transactions are immutable.");
+export const chargeTotalsWire = z
+    .strictObject({
+    booked: totalsWire,
+    realtime: totalsWire.optional(),
+})
+    .describe('The totals of a charge. RealTime is only expanded when the `real_time_usage` expand is used.');
 export const priceTierWire = z
     .strictObject({
     up_to_amount: numericWire.optional(),
     flat_price: priceFlatWire.optional(),
     unit_price: priceUnitWire.optional(),
 })
-    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the rate card, up_to_amount is expressed in converted billing units.');
-export const chargeTotalsWire = z
-    .strictObject({
-    booked: totalsWire,
-    realtime: totalsWire.optional(),
-})
-    .describe('The totals of a change. RealTime is only expanded when the `real_time_usage` expand is used.');
+    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the containing resource, up_to_amount is expressed in converted billing units.');
 export const updatePriceTierWire = z
     .strictObject({
     up_to_amount: numericWire.optional(),
     flat_price: updatePriceFlatWire.optional(),
     unit_price: updatePriceUnitWire.optional(),
 })
-    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the rate card, up_to_amount is expressed in converted billing units.');
+    .describe('A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the containing resource, up_to_amount is expressed in converted billing units.');
 export const featureLlmUnitCostWire = z
     .strictObject({
     type: z
@@ -8456,7 +8462,7 @@ export const priceGraduatedWire = z
         .min(1)
         .describe('The tiers of the graduated price. At least one tier is required.'),
 })
-    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.");
+    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.");
 export const priceVolumeWire = z
     .strictObject({
     type: z.literal('volume').describe('The type of the price.'),
@@ -8465,7 +8471,7 @@ export const priceVolumeWire = z
         .min(1)
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
-    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.');
+    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
 export const updatePriceGraduatedWire = z
     .strictObject({
     type: z.literal('graduated').describe('The type of the price.'),
@@ -8474,7 +8480,7 @@ export const updatePriceGraduatedWire = z
         .min(1)
         .describe('The tiers of the graduated price. At least one tier is required.'),
 })
-    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.");
+    .describe("Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.");
 export const updatePriceVolumeWire = z
     .strictObject({
     type: z.literal('volume').describe('The type of the price.'),
@@ -8483,7 +8489,7 @@ export const updatePriceVolumeWire = z
         .min(1)
         .describe('The tiers of the volume price. At least one tier is required.'),
 })
-    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units.');
+    .describe('Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the containing resource, tier boundaries (up_to_amount) are expressed in converted billing units.');
 export const featureUnitCostWire = z
     .discriminatedUnion('type', [
     featureManualUnitCostWire,
@@ -8741,6 +8747,56 @@ export const workflowCollectionAlignmentWire = z
     workflowCollectionAlignmentAnchoredWire,
 ])
     .describe('The alignment for collecting the pending line items into an invoice. Defaults to subscription, which means that we are to create a new invoice every time the a subscription period starts (for in advance items) or ends (for in arrears items).');
+export const chargeFlatFeeWire = z
+    .strictObject({
+    id: ulidWire,
+    name: z
+        .string()
+        .min(1)
+        .max(256)
+        .describe('Display name of the resource. Between 1 and 256 characters.'),
+    description: z
+        .string()
+        .max(1024)
+        .optional()
+        .describe('Optional description of the resource. Maximum 1024 characters.'),
+    labels: labelsWire.optional(),
+    created_at: dateTimeWire,
+    updated_at: dateTimeWire,
+    deleted_at: dateTimeWire.optional(),
+    type: z.literal('flat_fee').describe('The type of the charge.'),
+    customer: billingCustomerReferenceWire,
+    lifecycle_controller: lifecycleControllerWire,
+    subscription: subscriptionReferenceWire.optional(),
+    currency: currencyCodeWire,
+    status: chargeStatusWire,
+    invoice_at: dateTimeWire,
+    service_period: closedPeriodWire,
+    full_service_period: closedPeriodWire,
+    billing_period: closedPeriodWire,
+    advance_after: dateTimeWire.optional(),
+    unique_reference_id: z
+        .string()
+        .optional()
+        .describe('Unique reference ID of the charge.'),
+    settlement_mode: settlementModeWire,
+    tax_config: taxConfigWire.optional(),
+    payment_term: pricePaymentTermWire,
+    discounts: chargeFlatFeeDiscountsWire.optional(),
+    feature_key: z
+        .string()
+        .optional()
+        .describe('The feature associated with the charge, when applicable.'),
+    feature_id: z
+        .string()
+        .optional()
+        .describe('The feature ID associated with the charge.'),
+    proration_configuration: rateCardProrationConfigurationWire,
+    amount_after_proration: currencyAmountWire,
+    price: priceFlatWire,
+    system_intent: chargeFlatFeeSystemIntentWire.optional(),
+})
+    .describe('A flat fee charge for a customer.');
 export const taxCodePagePaginatedResponseWire = z
     .strictObject({
     data: z.array(taxCodeWire),
@@ -8978,22 +9034,22 @@ export const entitlementAccessQueryResultWire = z
     updated_at: dateTimeWire,
 })
     .describe('Access evaluation result for a single resolved customer.');
-export const priceWire = z
+export const priceUsageBasedWire = z
     .discriminatedUnion('type', [
-    priceFreeWire,
-    priceFlatWire,
     priceUnitWire,
     priceGraduatedWire,
     priceVolumeWire,
 ])
-    .describe('Price.');
-export const priceUsageBasedWire = z
+    .describe('Usage-based price types for a rate card or charge. When UnitConfig is present on the object, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
+export const priceWire = z
     .discriminatedUnion('type', [
+    priceFreeWire,
+    priceFlatWire,
     priceUnitWire,
     priceGraduatedWire,
     priceVolumeWire,
 ])
-    .describe('Usage-based price types that can appear on a usage-based rate card. When UnitConfig is present on the rate card, these price types operate on billing units (i.e. post-conversion quantities), not raw metered units.');
+    .describe('Price.');
 export const updatePriceWire = z
     .discriminatedUnion('type', [
     updatePriceFreeWire,
@@ -9132,56 +9188,6 @@ export const entitlementAccessQueryResponseWire = z
     meta: cursorMetaWire,
 })
     .describe('Response of the entitlement access query.');
-export const chargeFlatFeeWire = z
-    .strictObject({
-    id: ulidWire,
-    name: z
-        .string()
-        .min(1)
-        .max(256)
-        .describe('Display name of the resource. Between 1 and 256 characters.'),
-    description: z
-        .string()
-        .max(1024)
-        .optional()
-        .describe('Optional description of the resource. Maximum 1024 characters.'),
-    labels: labelsWire.optional(),
-    created_at: dateTimeWire,
-    updated_at: dateTimeWire,
-    deleted_at: dateTimeWire.optional(),
-    type: z.literal('flat_fee').describe('The type of the charge.'),
-    customer: billingCustomerReferenceWire,
-    lifecycle_controller: lifecycleControllerWire,
-    subscription: subscriptionReferenceWire.optional(),
-    currency: currencyCodeWire,
-    status: chargeStatusWire,
-    invoice_at: dateTimeWire,
-    service_period: closedPeriodWire,
-    full_service_period: closedPeriodWire,
-    billing_period: closedPeriodWire,
-    advance_after: dateTimeWire.optional(),
-    unique_reference_id: z
-        .string()
-        .optional()
-        .describe('Unique reference ID of the charge.'),
-    settlement_mode: settlementModeWire,
-    tax_config: taxConfigWire.optional(),
-    payment_term: pricePaymentTermWire,
-    discounts: chargeFlatFeeDiscountsWire.optional(),
-    feature_key: z
-        .string()
-        .optional()
-        .describe('The feature associated with the charge, when applicable.'),
-    feature_id: z
-        .string()
-        .optional()
-        .describe('The feature ID associated with the charge.'),
-    proration_configuration: rateCardProrationConfigurationWire,
-    amount_after_proration: currencyAmountWire,
-    price: priceWire,
-    system_intent: chargeFlatFeeSystemIntentWire.optional(),
-})
-    .describe('A flat fee charge for a customer.');
 export const chargeUsageBasedSystemIntentWire = z
     .strictObject({
     name: z
@@ -9200,7 +9206,9 @@ export const chargeUsageBasedSystemIntentWire = z
     full_service_period: closedPeriodWire,
     billing_period: closedPeriodWire,
     discounts: rateCardDiscountsWire.optional(),
-    price: priceWire,
+    price: priceUsageBasedWire,
+    commitments: spendCommitmentsWire.optional(),
+    unit_config: unitConfigWire.optional(),
     deleted_at: dateTimeWire.optional(),
 })
     .describe('Usage-based intent fields from the system lifecycle controller shadowed by a manual override.');
@@ -9231,7 +9239,9 @@ export const createChargeUsageBasedRequestWire = z
     feature_id: z
         .string()
         .describe('The feature ID associated with the charge.'),
-    price: priceWire,
+    price: priceUsageBasedWire,
+    commitments: spendCommitmentsWire.optional(),
+    unit_config: unitConfigWire.optional(),
     full_service_period: closedPeriodWire.optional(),
     billing_period: closedPeriodWire.optional(),
 })
@@ -9346,7 +9356,9 @@ export const chargeUsageBasedWire = z
         .string()
         .describe('The feature ID associated with the charge.'),
     totals: chargeTotalsWire,
-    price: priceWire,
+    price: priceUsageBasedWire,
+    commitments: spendCommitmentsWire.optional(),
+    unit_config: unitConfigWire.optional(),
     system_intent: chargeUsageBasedSystemIntentWire.optional(),
 })
     .describe('A usage-based charge for a customer.');