@openmeter/sdk 1.0.0-beta.229 → 1.0.0-beta.230

package/dist/src/zod/index.js

@@ -1,9 +1,9 @@
 /**
- * Generated by orval v8.7.0 🍺
+ * Generated by orval v8.15.0 🍺
  * Do not edit manually.
  * OpenMeter Cloud API
  * OpenMeter is a cloud native usage metering service.
-The OpenMeter API allows you to ingest events, query meter usage, and manage resources.
+ * The OpenMeter API allows you to ingest events, query meter usage, and manage resources.
  * OpenAPI spec version: 1.0.0
  */
 import * as zod from 'zod';
@@ -1309,8 +1309,8 @@ export const GetAddonQueryParams = zod.object({
 });
 /**
  * Soft delete add-on by id.
-
-Once a add-on is deleted it cannot be undeleted.
+ *
+ * Once a add-on is deleted it cannot be undeleted.
  * @summary Delete add-on
  */
 export const deleteAddonPathAddonIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -1587,8 +1587,8 @@ export const UninstallAppParams = zod.object({
 });
 /**
  * Update the Stripe API key.
-
-⚠️ __Deprecated__: Use [`PUT /api/v1/apps/{id}`](#tag/apps/put/api/v1/apps/{id}) instead.
+ *
+ * ⚠️ __Deprecated__: Use [`PUT /api/v1/apps/{id}`](#tag/apps/put/api/v1/apps/{id}) instead.
  * @deprecated
  * @summary Update Stripe API key
  */
@@ -1624,12 +1624,12 @@ export const AppStripeWebhookBody = zod
     .describe('Stripe webhook event.');
 /**
  * List customer overrides using the specified filters.
-
-The response will include the customer override values and the merged billing profile values.
-
-If the includeAllCustomers is set to true, the list contains all customers. This mode is
-useful for getting the current effective billing workflow settings for all users regardless
-if they have customer orverrides or not.
+ *
+ * The response will include the customer override values and the merged billing profile values.
+ *
+ * If the includeAllCustomers is set to true, the list contains all customers. This mode is
+ * useful for getting the current effective billing workflow settings for all users regardless
+ * if they have customer orverrides or not.
  * @summary List customer overrides
  */
 export const listBillingProfileCustomerOverridesQueryBillingProfileItemRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -1709,10 +1709,10 @@ export const ListBillingProfileCustomerOverridesQueryParams = zod.object({
 });
 /**
  * The customer override can be used to pin a given customer to a billing profile
-different from the default one.
-
-This can be used to test the effect of different billing profiles before making them
-the default ones or have different workflow settings for example for enterprise customers.
+ * different from the default one.
+ *
+ * This can be used to test the effect of different billing profiles before making them
+ * the default ones or have different workflow settings for example for enterprise customers.
  * @summary Create a new or update a customer override
  */
 export const upsertBillingProfileCustomerOverridePathCustomerIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -1733,11 +1733,11 @@ export const UpsertBillingProfileCustomerOverrideBody = zod
     .describe('Payload for creating a new or updating an existing customer override.');
 /**
  * Get a customer override by customer id.
-
-The response will include the customer override values and the merged billing profile values.
-
-If the customer override is not found, the default billing profile's values are returned. This behavior
-allows for getting a merged profile regardless of the customer override existence.
+ *
+ * The response will include the customer override values and the merged billing profile values.
+ *
+ * If the customer override is not found, the default billing profile's values are returned. This behavior
+ * allows for getting a merged profile regardless of the customer override existence.
  * @summary Get a customer override
  */
 export const getBillingProfileCustomerOverridePathCustomerIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -1755,9 +1755,9 @@ export const GetBillingProfileCustomerOverrideQueryParams = zod.object({
 });
 /**
  * Delete a customer override by customer id.
-
-This will remove the customer override and the customer will be subject to the default
-billing profile's settings again.
+ *
+ * This will remove the customer override and the customer will be subject to the default
+ * billing profile's settings again.
  * @summary Delete a customer override
  */
 export const deleteBillingProfileCustomerOverridePathCustomerIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -1768,13 +1768,13 @@ export const DeleteBillingProfileCustomerOverrideParams = zod.object({
 });
 /**
  * Create a new pending line item (charge).
-
-This call is used to create a new pending line item for the customer if required a new
-gathering invoice will be created.
-
-A new invoice will be created if:
-- there is no invoice in gathering state
-- the currency of the line item doesn't match the currency of any invoices in gathering state
+ *
+ * This call is used to create a new pending line item for the customer if required a new
+ * gathering invoice will be created.
+ *
+ * A new invoice will be created if:
+ * - there is no invoice in gathering state
+ * - the currency of the line item doesn't match the currency of any invoices in gathering state
  * @summary Create pending line items
  */
 export const createPendingInvoiceLinePathCustomerIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -2333,10 +2333,10 @@ export const CreatePendingInvoiceLineBody = zod
     .describe('InvoicePendingLineCreate represents the create model for a pending invoice line.');
 /**
  * Simulate an invoice for a customer.
-
-This call will simulate an invoice for a customer based on the pending line items.
-
-The call will return the total amount of the invoice and the line items that will be included in the invoice.
+ *
+ * This call will simulate an invoice for a customer based on the pending line items.
+ *
+ * The call will return the total amount of the invoice and the line items that will be included in the invoice.
  * @summary Simulate an invoice for a customer
  */
 export const simulateInvoicePathCustomerIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -2919,11 +2919,11 @@ export const SimulateInvoiceBody = zod
     .describe('InvoiceSimulationInput is the input for simulating an invoice.');
 /**
  * List invoices based on the specified filters.
-
-The expand option can be used to include additional information (besides the invoice header and totals)
-in the response. For example by adding the expand=lines option the invoice lines will be included in the response.
-
-Gathering invoices will always show the current usage calculated on the fly.
+ *
+ * The expand option can be used to include additional information (besides the invoice header and totals)
+ * in the response. For example by adding the expand=lines option the invoice lines will be included in the response.
+ *
+ * Gathering invoices will always show the current usage calculated on the fly.
  * @summary List invoices
  */
 export const listInvoicesQueryCustomersItemRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3023,14 +3023,14 @@ export const ListInvoicesQueryParams = zod.object({
 });
 /**
  * Create a new invoice from the pending line items.
-
-This should be only called if for some reason we need to invoice a customer outside of the normal billing cycle.
-
-When creating an invoice, the pending line items will be marked as invoiced and the invoice will be created with the total amount of the pending items.
-
-New pending line items will be created for the period between now() and the next billing cycle's begining date for any metered item.
-
-The call can return multiple invoices if the pending line items are in different currencies.
+ *
+ * This should be only called if for some reason we need to invoice a customer outside of the normal billing cycle.
+ *
+ * When creating an invoice, the pending line items will be marked as invoiced and the invoice will be created with the total amount of the pending items.
+ *
+ * New pending line items will be created for the period between now() and the next billing cycle's begining date for any metered item.
+ *
+ * The call can return multiple invoices if the pending line items are in different currencies.
  * @summary Invoice a customer based on the pending line items
  */
 export const invoicePendingLinesActionBodyFiltersOneLineIdsItemRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3066,8 +3066,8 @@ export const InvoicePendingLinesActionBody = zod
     .describe('BillingInvoiceActionInput is the input for creating an invoice.\n\nInvoice creation is always based on already pending line items created by the billingCreateLineByCustomer\noperation. Empty invoices are not allowed.');
 /**
  * Get an invoice by ID.
-
-Gathering invoices will always show the current usage calculated on the fly.
+ *
+ * Gathering invoices will always show the current usage calculated on the fly.
  * @summary Get an invoice
  */
 export const getInvoicePathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3087,10 +3087,10 @@ export const GetInvoiceQueryParams = zod.object({
 });
 /**
  * Delete an invoice
-
-Only invoices that are in the draft (or earlier) status can be deleted.
-
-Invoices that are post finalization can only be voided.
+ *
+ * Only invoices that are in the draft (or earlier) status can be deleted.
+ *
+ * Invoices that are post finalization can only be voided.
  * @summary Delete an invoice
  */
 export const deleteInvoicePathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3099,8 +3099,8 @@ export const DeleteInvoiceParams = zod.object({
 });
 /**
  * Update an invoice
-
-Only invoices in draft or earlier status can be updated.
+ *
+ * Only invoices in draft or earlier status can be updated.
  * @summary Update an invoice
  */
 export const updateInvoicePathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3173,6 +3173,7 @@ export const updateInvoiceBodyLinesItemIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkm
 export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneAutoAdvanceDefault = true;
 export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDraftPeriodDefault = 'P0D';
 export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDueAfterDefault = 'P30D';
+export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault = 'bill_actual_period';
 export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDefaultTaxConfigOneStripeOneCodeRegExp = /^txcd_\d{8}$/;
 export const updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDefaultTaxConfigOneTaxCodeIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
 export const updateInvoiceBodyWorkflowOneWorkflowOnePaymentOneCollectionMethodDefault = 'charge_automatically';
@@ -3851,7 +3852,7 @@ export const UpdateInvoiceBody = zod
                 })
                     .describe('Set of provider specific tax configs.')
                     .optional()
-                    .describe('Default tax configuration to apply to the invoices.'),
+                    .describe("Default tax configuration to apply to the invoices.\n\nSetting a tax code (`stripe.code` / `taxCodeId`) on a profile's default tax config is\ndeprecated and can no longer be added or changed: the organization default tax code is\nused instead. Existing tax-code values may still be removed, and `behavior` remains\nfully supported."),
                 draftPeriod: zod.coerce
                     .string()
                     .default(updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDraftPeriodDefault)
@@ -3860,6 +3861,11 @@ export const UpdateInvoiceBody = zod
                     .string()
                     .default(updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneDueAfterDefault)
                     .describe("The period after which the invoice is due.\nWith some payment solutions it's only applicable for manual collection method."),
+                subscriptionEndProrationMode: zod
+                    .enum(['bill_full_period', 'bill_actual_period'])
+                    .describe('Billing workflow subscription end proration mode.')
+                    .default(updateInvoiceBodyWorkflowOneWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault)
+                    .describe('Controls how subscription-ending shortened service periods are billed.'),
             })
                 .describe('InvoiceWorkflowInvoicingSettingsReplaceUpdate represents the update model for the invoicing settings of an invoice workflow.')
                 .describe('The invoicing settings for this workflow'),
@@ -3883,10 +3889,10 @@ export const UpdateInvoiceBody = zod
     .describe('InvoiceReplaceUpdate represents the update model for an invoice.');
 /**
  * Advance the invoice's state to the next status.
-
-The call doesn't "approve the invoice", it only advances the invoice to the next status if the transition would be automatic.
-
-The action can be called when the invoice's statusDetails' actions field contain the "advance" action.
+ *
+ * The call doesn't "approve the invoice", it only advances the invoice to the next status if the transition would be automatic.
+ *
+ * The action can be called when the invoice's statusDetails' actions field contain the "advance" action.
  * @summary Advance the invoice's state to the next status
  */
 export const advanceInvoiceActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3895,12 +3901,12 @@ export const AdvanceInvoiceActionParams = zod.object({
 });
 /**
  * Approve an invoice and start executing the payment workflow.
-
-This call instantly sends the invoice to the customer using the configured billing profile app.
-
-This call is valid in two invoice statuses:
-- `draft`: the invoice will be sent to the customer, the invluce state becomes issued
-- `manual_approval_needed`: the invoice will be sent to the customer, the invoice state becomes issued
+ *
+ * This call instantly sends the invoice to the customer using the configured billing profile app.
+ *
+ * This call is valid in two invoice statuses:
+ * - `draft`: the invoice will be sent to the customer, the invluce state becomes issued
+ * - `manual_approval_needed`: the invoice will be sent to the customer, the invoice state becomes issued
  * @summary Send the invoice to the customer
  */
 export const approveInvoiceActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3909,8 +3915,8 @@ export const ApproveInvoiceActionParams = zod.object({
 });
 /**
  * Retry advancing the invoice after a failed attempt.
-
-The action can be called when the invoice's statusDetails' actions field contain the "retry" action.
+ *
+ * The action can be called when the invoice's statusDetails' actions field contain the "retry" action.
  * @summary Retry advancing the invoice after a failed attempt.
  */
 export const retryInvoiceActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3919,11 +3925,11 @@ export const RetryInvoiceActionParams = zod.object({
 });
 /**
  * Snapshot quantities for usage based line items.
-
-This call will snapshot the quantities for all usage based line items in the invoice.
-
-This call is only valid in `draft.waiting_for_collection` status, where the collection period
-can be skipped using this action.
+ *
+ * This call will snapshot the quantities for all usage based line items in the invoice.
+ *
+ * This call is only valid in `draft.waiting_for_collection` status, where the collection period
+ * can be skipped using this action.
  * @summary Snapshot quantities for usage based line items
  */
 export const snapshotQuantitiesInvoiceActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3934,8 +3940,8 @@ export const SnapshotQuantitiesInvoiceActionParams = zod.object({
 });
 /**
  * Recalculate an invoice's tax amounts (using the app set in the customer's billing profile)
-
-Note: charges might apply, depending on the tax provider.
+ *
+ * Note: charges might apply, depending on the tax provider.
  * @summary Recalculate an invoice's tax amounts
  */
 export const recalculateInvoiceTaxActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -3946,10 +3952,10 @@ export const RecalculateInvoiceTaxActionParams = zod.object({
 });
 /**
  * Void an invoice
-
-Only invoices that have been alread issued can be voided.
-
-Voiding an invoice will mark it as voided, the user can specify how to handle the voided line items.
+ *
+ * Only invoices that have been alread issued can be voided.
+ *
+ * Voiding an invoice will mark it as voided, the user can specify how to handle the voided line items.
  * @summary Void an invoice
  */
 export const voidInvoiceActionPathInvoiceIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -4039,10 +4045,10 @@ export const VoidInvoiceActionBody = zod
     .describe('Request to void an invoice');
 /**
  * List all billing profiles matching the specified filters.
-
-The expand option can be used to include additional information (besides the billing profile)
-in the response. For example by adding the expand=apps option the apps used by the billing profile
-will be included in the response.
+ *
+ * The expand option can be used to include additional information (besides the billing profile)
+ * in the response. For example by adding the expand=apps option the apps used by the billing profile
+ * will be included in the response.
  * @summary List billing profiles
  */
 export const listBillingProfilesQueryIncludeArchivedDefault = false;
@@ -4082,9 +4088,9 @@ export const ListBillingProfilesQueryParams = zod.object({
 });
 /**
  * Create a new billing profile
-
-Billing profiles are representations of a customer's billing information. Customer overrides
-can be applied to a billing profile to customize the billing behavior for a specific customer.
+ *
+ * Billing profiles are representations of a customer's billing information. Customer overrides
+ * can be applied to a billing profile to customize the billing behavior for a specific customer.
  * @summary Create a new billing profile
  */
 export const createBillingProfileBodyNameMax = 256;
@@ -4102,6 +4108,7 @@ export const createBillingProfileBodyWorkflowOneInvoicingOneAutoAdvanceDefault =
 export const createBillingProfileBodyWorkflowOneInvoicingOneDraftPeriodDefault = 'P0D';
 export const createBillingProfileBodyWorkflowOneInvoicingOneDueAfterDefault = 'P30D';
 export const createBillingProfileBodyWorkflowOneInvoicingOneProgressiveBillingDefault = true;
+export const createBillingProfileBodyWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault = 'bill_actual_period';
 export const createBillingProfileBodyWorkflowOneInvoicingOneDefaultTaxConfigOneStripeOneCodeRegExp = /^txcd_\d{8}$/;
 export const createBillingProfileBodyWorkflowOneInvoicingOneDefaultTaxConfigOneTaxCodeIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
 export const createBillingProfileBodyWorkflowOnePaymentOneCollectionMethodDefault = 'charge_automatically';
@@ -4305,7 +4312,7 @@ export const CreateBillingProfileBody = zod
             })
                 .describe('Set of provider specific tax configs.')
                 .optional()
-                .describe('Default tax configuration to apply to the invoices.'),
+                .describe("Default tax configuration to apply to the invoices.\n\nSetting a tax code (`stripe.code` / `taxCodeId`) on a profile's default tax config is\ndeprecated and can no longer be added or changed: the organization default tax code is\nused instead. Existing tax-code values may still be removed, and `behavior` remains\nfully supported."),
             draftPeriod: zod.coerce
                 .string()
                 .default(createBillingProfileBodyWorkflowOneInvoicingOneDraftPeriodDefault)
@@ -4318,6 +4325,11 @@ export const CreateBillingProfileBody = zod
                 .boolean()
                 .default(createBillingProfileBodyWorkflowOneInvoicingOneProgressiveBillingDefault)
                 .describe('Should progressive billing be allowed for this workflow?'),
+            subscriptionEndProrationMode: zod
+                .enum(['bill_full_period', 'bill_actual_period'])
+                .describe('Billing workflow subscription end proration mode.')
+                .default(createBillingProfileBodyWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault)
+                .describe('Controls how subscription-ending shortened service periods are billed.'),
         })
             .describe('BillingWorkflowInvoicingSettings represents the invoice settings for a billing workflow')
             .optional()
@@ -4354,11 +4366,11 @@ export const CreateBillingProfileBody = zod
     .describe('BillingProfileCreate represents the input for creating a billing profile');
 /**
  * Delete a billing profile by id.
-
-Only such billing profiles can be deleted that are:
-- not the default one
-- not pinned to any customer using customer overrides
-- only have finalized invoices
+ *
+ * Only such billing profiles can be deleted that are:
+ * - not the default one
+ * - not pinned to any customer using customer overrides
+ * - only have finalized invoices
  * @summary Delete a billing profile
  */
 export const deleteBillingProfilePathIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -4367,10 +4379,10 @@ export const DeleteBillingProfileParams = zod.object({
 });
 /**
  * Get a billing profile by id.
-
-The expand option can be used to include additional information (besides the billing profile)
-in the response. For example by adding the expand=apps option the apps used by the billing profile
-will be included in the response.
+ *
+ * The expand option can be used to include additional information (besides the billing profile)
+ * in the response. For example by adding the expand=apps option the apps used by the billing profile
+ * will be included in the response.
  * @summary Get a billing profile
  */
 export const getBillingProfilePathIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -4386,9 +4398,9 @@ export const GetBillingProfileQueryParams = zod.object({
 });
 /**
  * Update a billing profile by id.
-
-The apps field cannot be updated directly, if an app change is desired a new
-profile should be created.
+ *
+ * The apps field cannot be updated directly, if an app change is desired a new
+ * profile should be created.
  * @summary Update a billing profile
  */
 export const updateBillingProfilePathIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -4410,6 +4422,7 @@ export const updateBillingProfileBodyWorkflowOneInvoicingOneAutoAdvanceDefault =
 export const updateBillingProfileBodyWorkflowOneInvoicingOneDraftPeriodDefault = 'P0D';
 export const updateBillingProfileBodyWorkflowOneInvoicingOneDueAfterDefault = 'P30D';
 export const updateBillingProfileBodyWorkflowOneInvoicingOneProgressiveBillingDefault = true;
+export const updateBillingProfileBodyWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault = 'bill_actual_period';
 export const updateBillingProfileBodyWorkflowOneInvoicingOneDefaultTaxConfigOneStripeOneCodeRegExp = /^txcd_\d{8}$/;
 export const updateBillingProfileBodyWorkflowOneInvoicingOneDefaultTaxConfigOneTaxCodeIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
 export const updateBillingProfileBodyWorkflowOnePaymentOneCollectionMethodDefault = 'charge_automatically';
@@ -4593,7 +4606,7 @@ export const UpdateBillingProfileBody = zod
             })
                 .describe('Set of provider specific tax configs.')
                 .optional()
-                .describe('Default tax configuration to apply to the invoices.'),
+                .describe("Default tax configuration to apply to the invoices.\n\nSetting a tax code (`stripe.code` / `taxCodeId`) on a profile's default tax config is\ndeprecated and can no longer be added or changed: the organization default tax code is\nused instead. Existing tax-code values may still be removed, and `behavior` remains\nfully supported."),
             draftPeriod: zod.coerce
                 .string()
                 .default(updateBillingProfileBodyWorkflowOneInvoicingOneDraftPeriodDefault)
@@ -4606,6 +4619,11 @@ export const UpdateBillingProfileBody = zod
                 .boolean()
                 .default(updateBillingProfileBodyWorkflowOneInvoicingOneProgressiveBillingDefault)
                 .describe('Should progressive billing be allowed for this workflow?'),
+            subscriptionEndProrationMode: zod
+                .enum(['bill_full_period', 'bill_actual_period'])
+                .describe('Billing workflow subscription end proration mode.')
+                .default(updateBillingProfileBodyWorkflowOneInvoicingOneSubscriptionEndProrationModeDefault)
+                .describe('Controls how subscription-ending shortened service periods are billed.'),
         })
             .describe('BillingWorkflowInvoicingSettings represents the invoice settings for a billing workflow')
             .optional()
@@ -5319,7 +5337,7 @@ export const GetCustomerEntitlementValueQueryParams = zod.object({
 });
 /**
  * Get stripe app data for a customer.
-Only returns data if the customer billing profile is linked to a stripe app.
+ * Only returns data if the customer billing profile is linked to a stripe app.
  * @summary Get customer stripe app data
  */
 export const getCustomerStripeAppDataPathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -5339,7 +5357,7 @@ export const GetCustomerStripeAppDataParams = zod.object({
 });
 /**
  * Upsert stripe app data for a customer.
-Only updates data if the customer billing profile is linked to a stripe app.
+ * Only updates data if the customer billing profile is linked to a stripe app.
  * @summary Upsert customer stripe app data
  */
 export const upsertCustomerStripeAppDataPathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -5368,10 +5386,10 @@ export const UpsertCustomerStripeAppDataBody = zod
     .describe('Stripe Customer App Data Base.');
 /**
  * Create Stripe customer portal session.
-Only returns URL if the customer billing profile is linked to a stripe app and customer.
-
-Useful to redirect the customer to the Stripe customer portal to manage their payment methods,
-change their billing address and access their invoice history.
+ * Only returns URL if the customer billing profile is linked to a stripe app and customer.
+ *
+ * Useful to redirect the customer to the Stripe customer portal to manage their payment methods,
+ * change their billing address and access their invoice history.
  * @summary Create Stripe customer portal session
  */
 export const createCustomerStripePortalSessionPathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -5457,10 +5475,10 @@ export const ListCustomerSubscriptionsQueryParams = zod.object({
 });
 /**
  * List all entitlements for all the subjects and features. This endpoint is intended for administrative purposes only.
-To fetch the entitlements of a specific subject please use the /api/v1/subjects/{subjectKeyOrID}/entitlements endpoint.
-If page is provided that takes precedence and the paginated response is returned.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/entitlements`](#tag/entitlements/get/api/v2/entitlements) instead.
+ * To fetch the entitlements of a specific subject please use the /api/v1/subjects/{subjectKeyOrID}/entitlements endpoint.
+ * If page is provided that takes precedence and the paginated response is returned.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/entitlements`](#tag/entitlements/get/api/v2/entitlements) instead.
  * @deprecated
  * @summary List all entitlements
  */
@@ -5526,8 +5544,8 @@ export const ListEntitlementsQueryParams = zod.object({
 });
 /**
  * Get entitlement by ID.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/entitlements/{entitlementId}`](#tag/entitlements/get/api/v2/entitlements/{entitlementId}) instead.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/entitlements/{entitlementId}`](#tag/entitlements/get/api/v2/entitlements/{entitlementId}) instead.
  * @deprecated
  * @summary Get entitlement by ID
  */
@@ -5539,8 +5557,8 @@ export const GetEntitlementByIdParams = zod.object({
 });
 /**
  * List ingested events within a time range.
-
-If the from query param is not provided it defaults to last 72 hours.
+ *
+ * If the from query param is not provided it defaults to last 72 hours.
  * @summary List ingested events
  */
 export const listEventsQueryClientIdMax = 36;
@@ -5596,90 +5614,46 @@ export const ListEventsQueryParams = zod.object({
  * Ingests an event or batch of events following the CloudEvents specification.
  * @summary Ingest events
  */
-export const ingestEventsBodyOneSpecversionDefault = '1.0';
-export const ingestEventsBodyTwoItemSpecversionDefault = '1.0';
+export const ingestEventsBodySpecversionDefault = '1.0';
 export const IngestEventsBody = zod
-    .union([
-    zod
-        .object({
-        data: zod
-            .record(zod.string(), zod.unknown())
-            .nullish()
-            .describe('The event payload.\nOptional, if present it must be a JSON object.'),
-        datacontenttype: zod
-            .enum(['application/json'])
-            .nullish()
-            .describe('Content type of the CloudEvents data value. Only the value "application/json" is allowed over HTTP.'),
-        dataschema: zod
-            .url()
-            .min(1)
-            .nullish()
-            .describe('Identifies the schema that data adheres to.'),
-        id: zod.coerce.string().min(1).describe('Identifies the event.'),
-        source: zod.coerce
-            .string()
-            .min(1)
-            .describe('Identifies the context in which an event happened.'),
-        specversion: zod.coerce
-            .string()
-            .min(1)
-            .default(ingestEventsBodyOneSpecversionDefault)
-            .describe('The version of the CloudEvents specification which the event uses.'),
-        subject: zod.coerce
-            .string()
-            .min(1)
-            .describe('Describes the subject of the event in the context of the event producer (identified by source).'),
-        time: zod.coerce
-            .date()
-            .nullish()
-            .describe('Timestamp of when the occurrence happened. Must adhere to RFC 3339.'),
-        type: zod.coerce
-            .string()
-            .min(1)
-            .describe('Contains a value describing the type of event related to the originating occurrence.'),
-    })
-        .describe('CloudEvents Specification JSON Schema\n\nOptional properties are nullable according to the CloudEvents specification:\nOPTIONAL not omitted attributes MAY be represented as a null JSON value.'),
-    zod.array(zod
-        .object({
-        data: zod
-            .record(zod.string(), zod.unknown())
-            .nullish()
-            .describe('The event payload.\nOptional, if present it must be a JSON object.'),
-        datacontenttype: zod
-            .enum(['application/json'])
-            .nullish()
-            .describe('Content type of the CloudEvents data value. Only the value "application/json" is allowed over HTTP.'),
-        dataschema: zod
-            .url()
-            .min(1)
-            .nullish()
-            .describe('Identifies the schema that data adheres to.'),
-        id: zod.coerce.string().min(1).describe('Identifies the event.'),
-        source: zod.coerce
-            .string()
-            .min(1)
-            .describe('Identifies the context in which an event happened.'),
-        specversion: zod.coerce
-            .string()
-            .min(1)
-            .default(ingestEventsBodyTwoItemSpecversionDefault)
-            .describe('The version of the CloudEvents specification which the event uses.'),
-        subject: zod.coerce
-            .string()
-            .min(1)
-            .describe('Describes the subject of the event in the context of the event producer (identified by source).'),
-        time: zod.coerce
-            .date()
-            .nullish()
-            .describe('Timestamp of when the occurrence happened. Must adhere to RFC 3339.'),
-        type: zod.coerce
-            .string()
-            .min(1)
-            .describe('Contains a value describing the type of event related to the originating occurrence.'),
-    })
-        .describe('CloudEvents Specification JSON Schema\n\nOptional properties are nullable according to the CloudEvents specification:\nOPTIONAL not omitted attributes MAY be represented as a null JSON value.')),
-])
-    .describe('The body of the events request.\nEither a single event or a batch of events.');
+    .object({
+    data: zod
+        .record(zod.string(), zod.unknown())
+        .nullish()
+        .describe('The event payload.\nOptional, if present it must be a JSON object.'),
+    datacontenttype: zod
+        .enum(['application/json'])
+        .nullish()
+        .describe('Content type of the CloudEvents data value. Only the value "application/json" is allowed over HTTP.'),
+    dataschema: zod
+        .url()
+        .min(1)
+        .nullish()
+        .describe('Identifies the schema that data adheres to.'),
+    id: zod.coerce.string().min(1).describe('Identifies the event.'),
+    source: zod.coerce
+        .string()
+        .min(1)
+        .describe('Identifies the context in which an event happened.'),
+    specversion: zod.coerce
+        .string()
+        .min(1)
+        .default(ingestEventsBodySpecversionDefault)
+        .describe('The version of the CloudEvents specification which the event uses.'),
+    subject: zod.coerce
+        .string()
+        .min(1)
+        .describe('Describes the subject of the event in the context of the event producer (identified by source).'),
+    time: zod.coerce
+        .date()
+        .nullish()
+        .describe('Timestamp of when the occurrence happened. Must adhere to RFC 3339.'),
+    type: zod.coerce
+        .string()
+        .min(1)
+        .describe('Contains a value describing the type of event related to the originating occurrence.'),
+})
+    .describe('CloudEvents Specification JSON Schema\n\nOptional properties are nullable according to the CloudEvents specification:\nOPTIONAL not omitted attributes MAY be represented as a null JSON value.');
 /**
  * List features.
  * @summary List features
@@ -5736,8 +5710,8 @@ export const ListFeaturesQueryParams = zod.object({
 });
 /**
  * Features are either metered or static. A feature is metered if meterSlug is provided at creation.
-For metered features you can pass additional filters that will be applied when calculating feature usage, based on the meter's groupBy fields.
-Meters with SUM, COUNT, UNIQUE_COUNT and LATEST aggregations are supported for features.
+ * For metered features you can pass additional filters that will be applied when calculating feature usage, based on the meter's groupBy fields.
+ * Meters with SUM, COUNT, UNIQUE_COUNT and LATEST aggregations are supported for features.
  * @summary Create feature
  */
 export const createFeatureBodyKeyMax = 64;
@@ -5927,9 +5901,9 @@ export const GetFeatureParams = zod.object({
 });
 /**
  * Archive a feature by ID.
-
-Once a feature is archived it cannot be unarchived. If a feature is archived, new entitlements cannot be created for it, but archiving the feature does not affect existing entitlements.
-This means, if you want to create a new feature with the same key, and then create entitlements for it, the previous entitlements have to be deleted first on a per subject basis.
+ *
+ * Once a feature is archived it cannot be unarchived. If a feature is archived, new entitlements cannot be created for it, but archiving the feature does not affect existing entitlements.
+ * This means, if you want to create a new feature with the same key, and then create entitlements for it, the previous entitlements have to be deleted first on a per subject basis.
  * @summary Delete feature
  */
 export const DeleteFeatureParams = zod.object({
@@ -5937,10 +5911,10 @@ export const DeleteFeatureParams = zod.object({
 });
 /**
  * List all grants for all the subjects and entitlements. This endpoint is intended for administrative purposes only.
-To fetch the grants of a specific entitlement please use the /api/v1/subjects/{subjectKeyOrID}/entitlements/{entitlementOrFeatureID}/grants endpoint.
-If page is provided that takes precedence and the paginated response is returned.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/grants`](#tag/entitlements/get/api/v2/grants) instead.
+ * To fetch the grants of a specific entitlement please use the /api/v1/subjects/{subjectKeyOrID}/entitlements/{entitlementOrFeatureID}/grants endpoint.
+ * If page is provided that takes precedence and the paginated response is returned.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/grants`](#tag/entitlements/get/api/v2/grants) instead.
  * @deprecated
  * @summary List grants
  */
@@ -6000,7 +5974,7 @@ export const ListGrantsQueryParams = zod.object({
 });
 /**
  * Voiding a grant means it is no longer valid, it doesn't take part in further balance calculations. Voiding a grant does not retroactively take effect, meaning any usage that has already been attributed to the grant will remain, but future usage cannot be burnt down from the grant.
-For example, if you have a single grant for your metered entitlement with an initial amount of 100, and so far 60 usage has been metered, the grant (and the entitlement itself) would have a balance of 40. If you then void that grant, balance becomes 0, but the 60 previous usage will not be affected.
+ * For example, if you have a single grant for your metered entitlement with an initial amount of 100, and so far 60 usage has been metered, the grant (and the entitlement itself) would have a balance of 40. If you then void that grant, balance becomes 0, but the 60 previous usage will not be affected.
  * @summary Void grant
  */
 export const VoidGrantParams = zod.object({
@@ -6093,7 +6067,7 @@ export const MarketplaceAppAPIKeyInstallBody = zod.object({
 });
 /**
  * Install an app via OAuth.
-Returns a URL to start the OAuth 2.0 flow.
+ * Returns a URL to start the OAuth 2.0 flow.
  * @summary Get OAuth2 install URL
  */
 export const MarketplaceOAuth2InstallGetURLParams = zod.object({
@@ -6101,7 +6075,7 @@ export const MarketplaceOAuth2InstallGetURLParams = zod.object({
 });
 /**
  * Authorize OAuth2 code.
-Verifies the OAuth code and exchanges it for a token and refresh token
+ * Verifies the OAuth code and exchanges it for a token and refresh token
  * @summary Install app via OAuth2
  */
 export const MarketplaceOAuth2InstallAuthorizeParams = zod.object({
@@ -6660,8 +6634,8 @@ export const GetNotificationChannelParams = zod.object({
 });
 /**
  * Soft delete notification channel by id.
-
-Once a notification channel is deleted it cannot be undeleted.
+ *
+ * Once a notification channel is deleted it cannot be undeleted.
  * @summary Delete a notification channel
  */
 export const deleteNotificationChannelPathChannelIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -7171,8 +7145,8 @@ export const GetNotificationRuleParams = zod.object({
 });
 /**
  * Soft delete notification rule by id.
-
-Once a notification rule is deleted it cannot be undeleted.
+ *
+ * Once a notification rule is deleted it cannot be undeleted.
  * @summary Delete a notification rule
  */
 export const deleteNotificationRulePathRuleIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -7949,7 +7923,7 @@ export const CreatePlanBody = zod
     .describe('Resource create operation model.');
 /**
  * Create a new draft version from plan.
-It returns error if there is already a plan in draft or planId does not reference the latest published version.
+ * It returns error if there is already a plan in draft or planId does not reference the latest published version.
  * @deprecated
  * @summary New draft plan
  */
@@ -8652,8 +8626,8 @@ export const GetPlanQueryParams = zod.object({
 });
 /**
  * Soft delete plan by plan.id.
-
-Once a plan is deleted it cannot be undeleted.
+ *
+ * Once a plan is deleted it cannot be undeleted.
  * @summary Delete plan
  */
 export const deletePlanPathPlanIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -8804,8 +8778,8 @@ export const GetPlanAddonParams = zod.object({
 });
 /**
  * Delete add-on assignment for plan.
-
-Once a plan is deleted it cannot be undeleted.
+ *
+ * Once a plan is deleted it cannot be undeleted.
  * @summary Delete add-on assignment for plan
  */
 export const deletePlanAddonPathPlanIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -9223,11 +9197,11 @@ export const CreateStripeCheckoutSessionBody = zod
     .describe('Create Stripe checkout session request.');
 /**
  * Upserts a subject. Creates or updates subject.
-
-If the subject doesn't exist, it will be created.
-If the subject exists, it will be partially updated with the provided fields.
-
-⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
+ *
+ * If the subject doesn't exist, it will be created.
+ * If the subject exists, it will be partially updated with the provided fields.
+ *
+ * ⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
  * @deprecated
  * @summary Upsert subject
  */
@@ -9261,8 +9235,8 @@ export const UpsertSubjectBodyItem = zod
 export const UpsertSubjectBody = zod.array(UpsertSubjectBodyItem);
 /**
  * Get subject by ID or key.
-
-⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
+ *
+ * ⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
  * @deprecated
  * @summary Get subject
  */
@@ -9271,8 +9245,8 @@ export const GetSubjectParams = zod.object({
 });
 /**
  * Delete subject by ID or key.
-
-⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
+ *
+ * ⚠️ __Deprecated__: Subjects as managable entities are being depracated, use customers with subject key usage attribution instead.
  * @deprecated
  * @summary Delete subject
  */
@@ -9281,16 +9255,16 @@ export const DeleteSubjectParams = zod.object({
 });
 /**
  * OpenMeter has three types of entitlements: metered, boolean, and static. The type property determines the type of entitlement. The underlying feature has to be compatible with the entitlement type specified in the request (e.g., a metered entitlement needs a feature associated with a meter).
-
-- Boolean entitlements define static feature access, e.g. "Can use SSO authentication".
-- Static entitlements let you pass along a configuration while granting access, e.g. "Using this feature with X Y settings" (passed in the config).
-- Metered entitlements have many use cases, from setting up usage-based access to implementing complex credit systems.  Example: The customer can use 10000 AI tokens during the usage period of the entitlement.
-
-A given subject can only have one active (non-deleted) entitlement per featureKey. If you try to create a new entitlement for a featureKey that already has an active entitlement, the request will fail with a 409 error.
-
-Once an entitlement is created you cannot modify it, only delete it.
-
-⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements) instead.
+ *
+ * - Boolean entitlements define static feature access, e.g. "Can use SSO authentication".
+ * - Static entitlements let you pass along a configuration while granting access, e.g. "Using this feature with X Y settings" (passed in the config).
+ * - Metered entitlements have many use cases, from setting up usage-based access to implementing complex credit systems.  Example: The customer can use 10000 AI tokens during the usage period of the entitlement.
+ *
+ * A given subject can only have one active (non-deleted) entitlement per featureKey. If you try to create a new entitlement for a featureKey that already has an active entitlement, the request will fail with a 409 error.
+ *
+ * Once an entitlement is created you cannot modify it, only delete it.
+ *
+ * ⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements) instead.
  * @deprecated
  * @summary Create a subject entitlement
  */
@@ -9487,8 +9461,8 @@ export const CreateEntitlementBody = zod
     .describe('Create inputs for entitlement');
 /**
  * List all entitlements for a subject. For checking entitlement access, use the /value endpoint instead.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements) instead.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements) instead.
  * @deprecated
  * @summary List subject entitlements
  */
@@ -9503,8 +9477,8 @@ export const ListSubjectEntitlementsQueryParams = zod.object({
 });
 /**
  * List all grants issued for an entitlement. The entitlement can be defined either by its id or featureKey.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants) instead.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants) instead.
  * @deprecated
  * @summary List subject entitlement grants
  */
@@ -9525,18 +9499,18 @@ export const ListEntitlementGrantsQueryParams = zod.object({
 });
 /**
  * Grants define a behavior of granting usage for a metered entitlement. They can have complicated recurrence and rollover rules, thanks to which you can define a wide range of access patterns with a single grant, in most cases you don't have to periodically create new grants. You can only issue grants for active metered entitlements.
-
-A grant defines a given amount of usage that can be consumed for the entitlement. The grant is in effect between its effective date and its expiration date. Specifying both is mandatory for new grants.
-
-Grants have a priority setting that determines their order of use. Lower numbers have higher priority, with 0 being the highest priority.
-
-Grants can have a recurrence setting intended to automate the manual reissuing of grants. For example, a daily recurrence is equal to reissuing that same grant every day (ignoring rollover settings).
-
-Rollover settings define what happens to the remaining balance of a grant at a reset. Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset, MinRolloverAmount))
-
-Grants cannot be changed once created, only deleted. This is to ensure that balance is deterministic regardless of when it is queried.
-
-⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants) instead.
+ *
+ * A grant defines a given amount of usage that can be consumed for the entitlement. The grant is in effect between its effective date and its expiration date. Specifying both is mandatory for new grants.
+ *
+ * Grants have a priority setting that determines their order of use. Lower numbers have higher priority, with 0 being the highest priority.
+ *
+ * Grants can have a recurrence setting intended to automate the manual reissuing of grants. For example, a daily recurrence is equal to reissuing that same grant every day (ignoring rollover settings).
+ *
+ * Rollover settings define what happens to the remaining balance of a grant at a reset. Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset, MinRolloverAmount))
+ *
+ * Grants cannot be changed once created, only deleted. This is to ensure that balance is deterministic regardless of when it is queried.
+ *
+ * ⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants) instead.
  * @deprecated
  * @summary Create subject entitlement grant
  */
@@ -9617,10 +9591,10 @@ export const CreateGrantBody = zod
     .describe('The grant creation input.');
 /**
  * Overriding an entitlement creates a new entitlement from the provided inputs and soft deletes the previous entitlement for the provided subject-feature pair. If the previous entitlement is already deleted or otherwise doesnt exist, the override will fail.
-
-This endpoint is useful for upgrades, downgrades, or other changes to entitlements that require a new entitlement to be created with zero downtime.
-
-⚠️ __Deprecated__: Use [`PUT /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/override`](#tag/entitlements/put/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/override) instead.
+ *
+ * This endpoint is useful for upgrades, downgrades, or other changes to entitlements that require a new entitlement to be created with zero downtime.
+ *
+ * ⚠️ __Deprecated__: Use [`PUT /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/override`](#tag/entitlements/put/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/override) instead.
  * @deprecated
  * @summary Override subject entitlement
  */
@@ -9818,10 +9792,10 @@ export const OverrideEntitlementBody = zod
     .describe('Create inputs for entitlement');
 /**
  * This endpoint should be used for access checks and enforcement. All entitlement types share the hasAccess property in their value response, but multiple other properties are returned based on the entitlement type.
-
-For convenience reasons, /value works with both entitlementId and featureKey.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value) instead.
+ *
+ * For convenience reasons, /value works with both entitlementId and featureKey.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/value) instead.
  * @deprecated
  * @summary Get subject entitlement value
  */
@@ -9834,8 +9808,8 @@ export const GetEntitlementValueQueryParams = zod.object({
 });
 /**
  * Get entitlement by id. For checking entitlement access, use the /value endpoint instead.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}) instead.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}) instead.
  * @deprecated
  * @summary Get subject entitlement
  */
@@ -9845,9 +9819,9 @@ export const GetEntitlementParams = zod.object({
 });
 /**
  * Deleting an entitlement revokes access to the associated feature. As a single subject can only have one entitlement per featureKey, when "migrating" features you have to delete the old entitlements as well.
-As access and status checks can be historical queries, deleting an entitlement populates the deletedAt timestamp. When queried for a time before that, the entitlement is still considered active, you cannot have retroactive changes to access, which is important for, among other things, auditing.
-
-⚠️ __Deprecated__: Use [`DELETE /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}`](#tag/entitlements/delete/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}) instead.
+ * As access and status checks can be historical queries, deleting an entitlement populates the deletedAt timestamp. When queried for a time before that, the entitlement is still considered active, you cannot have retroactive changes to access, which is important for, among other things, auditing.
+ *
+ * ⚠️ __Deprecated__: Use [`DELETE /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}`](#tag/entitlements/delete/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}) instead.
  * @deprecated
  * @summary Delete subject entitlement
  */
@@ -9857,12 +9831,12 @@ export const DeleteEntitlementParams = zod.object({
 });
 /**
  * Returns historical balance and usage data for the entitlement. The queried history can span accross multiple reset events.
-
-BurndownHistory returns a continous history of segments, where the segments are seperated by events that changed either the grant burndown priority or the usage period.
-
-WindowedHistory returns windowed usage data for the period enriched with balance information and the list of grants that were being burnt down in that window.
-
-⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/history`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/history) instead.
+ *
+ * BurndownHistory returns a continous history of segments, where the segments are seperated by events that changed either the grant burndown priority or the usage period.
+ *
+ * WindowedHistory returns windowed usage data for the period enriched with balance information and the list of grants that were being burnt down in that window.
+ *
+ * ⚠️ __Deprecated__: Use [`GET /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/history`](#tag/entitlements/get/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/history) instead.
  * @deprecated
  * @summary Get subject entitlement history
  */
@@ -9890,10 +9864,10 @@ export const GetEntitlementHistoryQueryParams = zod.object({
 });
 /**
  * Reset marks the start of a new usage period for the entitlement and initiates grant rollover. At the start of a period usage is zerod out and grants are rolled over based on their rollover settings. It would typically be synced with the subjects billing period to enforce usage based on their subscription.
-
-Usage is automatically reset for metered entitlements based on their usage period, but this endpoint allows to manually reset it at any time. When doing so the period anchor of the entitlement can be changed if needed.
-
-⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/reset`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/reset) instead.
+ *
+ * Usage is automatically reset for metered entitlements based on their usage period, but this endpoint allows to manually reset it at any time. When doing so the period anchor of the entitlement can be changed if needed.
+ *
+ * ⚠️ __Deprecated__: Use [`POST /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/reset`](#tag/entitlements/post/api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/reset) instead.
  * @deprecated
  * @summary Reset subject entitlement
  */
@@ -10733,7 +10707,7 @@ export const GetSubscriptionQueryParams = zod.object({
 });
 /**
  * Batch processing commands for manipulating running subscriptions.
-The key format is `/phases/{phaseKey}` or `/phases/{phaseKey}/items/{itemKey}`.
+ * The key format is `/phases/{phaseKey}` or `/phases/{phaseKey}/items/{itemKey}`.
  * @summary Edit subscription
  */
 export const editSubscriptionPathSubscriptionIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -11567,7 +11541,7 @@ export const UpdateSubscriptionAddonBody = zod
     .describe('Resource create or update operation model.');
 /**
  * Cancels the subscription.
-Will result in a scheduling conflict if there are other subscriptions scheduled to start after the cancellation time.
+ * Will result in a scheduling conflict if there are other subscriptions scheduled to start after the cancellation time.
  * @summary Cancel subscription
  */
 export const cancelSubscriptionPathSubscriptionIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -11592,7 +11566,7 @@ export const CancelSubscriptionBody = zod.object({
 });
 /**
  * Closes a running subscription and starts a new one according to the specification.
-Can be used for upgrades, downgrades, and plan changes.
+ * Can be used for upgrades, downgrades, and plan changes.
  * @summary Change subscription
  */
 export const changeSubscriptionPathSubscriptionIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -11714,6 +11688,11 @@ export const ChangeSubscriptionBody = zod
         })
             .describe('References an exact plan defaulting to the current active version.')
             .describe('The plan reference to change to.'),
+        settlementMode: zod
+            .enum(['credit_then_invoice', 'credit_only'])
+            .describe('The settlement mode of a plan.\nIt determines how the billing system generates invoices and credits for the subscriptions using this plan.\n- credit_then_invoice: credits from the previous billing period are applied first, then the remaining balance is invoiced. This is the default and most common settlement mode.\n- credit_only: only credits from the previous billing period are generated and applied. No invoices are generated for the subscription.')
+            .optional()
+            .describe('The settlement mode of the subscription.'),
         startingPhase: zod.coerce
             .string()
             .min(1)
@@ -12364,8 +12343,8 @@ export const ChangeSubscriptionBody = zod
     .describe('Change a subscription.');
 /**
  * Migrates the subscripiton to the provided version of the current plan.
-If possible, the migration will be done immediately.
-If not, the migration will be scheduled to the end of the current billing period.
+ * If possible, the migration will be done immediately.
+ * If not, the migration will be scheduled to the end of the current billing period.
  * @summary Migrate subscription
  */
 export const migrateSubscriptionPathSubscriptionIdRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -12405,7 +12384,7 @@ export const MigrateSubscriptionBody = zod.object({
 });
 /**
  * Restores a canceled subscription.
-Any subscription scheduled to start later will be deleted and this subscription will be continued indefinitely.
+ * Any subscription scheduled to start later will be deleted and this subscription will be continued indefinitely.
  * @deprecated
  * @summary Restore subscription
  */
@@ -12427,14 +12406,14 @@ export const UnscheduleCancelationParams = zod.object({
 });
 /**
  * OpenMeter has three types of entitlements: metered, boolean, and static. The type property determines the type of entitlement. The underlying feature has to be compatible with the entitlement type specified in the request (e.g., a metered entitlement needs a feature associated with a meter).
-
-- Boolean entitlements define static feature access, e.g. "Can use SSO authentication".
-- Static entitlements let you pass along a configuration while granting access, e.g. "Using this feature with X Y settings" (passed in the config).
-- Metered entitlements have many use cases, from setting up usage-based access to implementing complex credit systems.  Example: The customer can use 10000 AI tokens during the usage period of the entitlement.
-
-A given customer can only have one active (non-deleted) entitlement per featureKey. If you try to create a new entitlement for a featureKey that already has an active entitlement, the request will fail with a 409 error.
-
-Once an entitlement is created you cannot modify it, only delete it.
+ *
+ * - Boolean entitlements define static feature access, e.g. "Can use SSO authentication".
+ * - Static entitlements let you pass along a configuration while granting access, e.g. "Using this feature with X Y settings" (passed in the config).
+ * - Metered entitlements have many use cases, from setting up usage-based access to implementing complex credit systems.  Example: The customer can use 10000 AI tokens during the usage period of the entitlement.
+ *
+ * A given customer can only have one active (non-deleted) entitlement per featureKey. If you try to create a new entitlement for a featureKey that already has an active entitlement, the request will fail with a 409 error.
+ *
+ * Once an entitlement is created you cannot modify it, only delete it.
  * @summary Create a customer entitlement
  */
 export const createCustomerEntitlementV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -12784,7 +12763,7 @@ export const ListCustomerEntitlementsV2QueryParams = zod.object({
 });
 /**
  * Get entitlement by feature key. For checking entitlement access, use the /value endpoint instead.
-If featureKey is used, the entitlement is resolved for the current timestamp.
+ * If featureKey is used, the entitlement is resolved for the current timestamp.
  * @summary Get customer entitlement
  */
 export const getCustomerEntitlementV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -12811,7 +12790,7 @@ export const GetCustomerEntitlementV2Params = zod.object({
 });
 /**
  * Deleting an entitlement revokes access to the associated feature. As a single customer can only have one entitlement per featureKey, when "migrating" features you have to delete the old entitlements as well.
-As access and status checks can be historical queries, deleting an entitlement populates the deletedAt timestamp. When queried for a time before that, the entitlement is still considered active, you cannot have retroactive changes to access, which is important for, among other things, auditing.
+ * As access and status checks can be historical queries, deleting an entitlement populates the deletedAt timestamp. When queried for a time before that, the entitlement is still considered active, you cannot have retroactive changes to access, which is important for, among other things, auditing.
  * @summary Delete customer entitlement
  */
 export const deleteCustomerEntitlementV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -12909,16 +12888,16 @@ export const ListCustomerEntitlementGrantsV2QueryParams = zod.object({
 });
 /**
  * Grants define a behavior of granting usage for a metered entitlement. They can have complicated recurrence and rollover rules, thanks to which you can define a wide range of access patterns with a single grant, in most cases you don't have to periodically create new grants. You can only issue grants for active metered entitlements.
-
-A grant defines a given amount of usage that can be consumed for the entitlement. The grant is in effect between its effective date and its expiration date. Specifying both is mandatory for new grants.
-
-Grants have a priority setting that determines their order of use. Lower numbers have higher priority, with 0 being the highest priority.
-
-Grants can have a recurrence setting intended to automate the manual reissuing of grants. For example, a daily recurrence is equal to reissuing that same grant every day (ignoring rollover settings).
-
-Rollover settings define what happens to the remaining balance of a grant at a reset. Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset, MinRolloverAmount))
-
-Grants cannot be changed once created, only deleted. This is to ensure that balance is deterministic regardless of when it is queried.
+ *
+ * A grant defines a given amount of usage that can be consumed for the entitlement. The grant is in effect between its effective date and its expiration date. Specifying both is mandatory for new grants.
+ *
+ * Grants have a priority setting that determines their order of use. Lower numbers have higher priority, with 0 being the highest priority.
+ *
+ * Grants can have a recurrence setting intended to automate the manual reissuing of grants. For example, a daily recurrence is equal to reissuing that same grant every day (ignoring rollover settings).
+ *
+ * Rollover settings define what happens to the remaining balance of a grant at a reset. Balance_After_Reset = MIN(MaxRolloverAmount, MAX(Balance_Before_Reset, MinRolloverAmount))
+ *
+ * Grants cannot be changed once created, only deleted. This is to ensure that balance is deterministic regardless of when it is queried.
  * @summary Create customer entitlement grant
  */
 export const createCustomerEntitlementGrantV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -13021,10 +13000,10 @@ export const CreateCustomerEntitlementGrantV2Body = zod
     .describe('The grant creation input.');
 /**
  * Returns historical balance and usage data for the entitlement. The queried history can span accross multiple reset events.
-
-BurndownHistory returns a continous history of segments, where the segments are seperated by events that changed either the grant burndown priority or the usage period.
-
-WindowedHistory returns windowed usage data for the period enriched with balance information and the list of grants that were being burnt down in that window.
+ *
+ * BurndownHistory returns a continous history of segments, where the segments are seperated by events that changed either the grant burndown priority or the usage period.
+ *
+ * WindowedHistory returns windowed usage data for the period enriched with balance information and the list of grants that were being burnt down in that window.
  * @summary Get customer entitlement history
  */
 export const getCustomerEntitlementHistoryV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -13069,8 +13048,8 @@ export const GetCustomerEntitlementHistoryV2QueryParams = zod.object({
 });
 /**
  * Overriding an entitlement creates a new entitlement from the provided inputs and soft deletes the previous entitlement for the provided customer-feature pair. If the previous entitlement is already deleted or otherwise doesnt exist, the override will fail.
-
-This endpoint is useful for upgrades, downgrades, or other changes to entitlements that require a new entitlement to be created with zero downtime.
+ *
+ * This endpoint is useful for upgrades, downgrades, or other changes to entitlements that require a new entitlement to be created with zero downtime.
  * @summary Override customer entitlement
  */
 export const overrideCustomerEntitlementV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -13384,8 +13363,8 @@ export const OverrideCustomerEntitlementV2Body = zod
     .describe('Create inputs for entitlement');
 /**
  * Reset marks the start of a new usage period for the entitlement and initiates grant rollover. At the start of a period usage is zerod out and grants are rolled over based on their rollover settings. It would typically be synced with the customers billing period to enforce usage based on their subscription.
-
-Usage is automatically reset for metered entitlements based on their usage period, but this endpoint allows to manually reset it at any time. When doing so the period anchor of the entitlement can be changed if needed.
+ *
+ * Usage is automatically reset for metered entitlements based on their usage period, but this endpoint allows to manually reset it at any time. When doing so the period anchor of the entitlement can be changed if needed.
  * @summary Reset customer entitlement
  */
 export const resetCustomerEntitlementUsageV2PathCustomerIdOrKeyOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;
@@ -13457,7 +13436,7 @@ export const GetCustomerEntitlementValueV2QueryParams = zod.object({
 });
 /**
  * List all entitlements for all the customers and features. This endpoint is intended for administrative purposes only.
-To fetch the entitlements of a specific subject please use the /api/v2/customers/{customerIdOrKey}/entitlements endpoint.
+ * To fetch the entitlements of a specific subject please use the /api/v2/customers/{customerIdOrKey}/entitlements endpoint.
  * @summary List all entitlements
  */
 export const listEntitlementsV2QueryExcludeInactiveDefault = false;
@@ -13561,8 +13540,8 @@ export const ListEventsV2QueryParams = zod.object({
 });
 /**
  * List all grants for all the customers and entitlements. This endpoint is intended for administrative purposes only.
-To fetch the grants of a specific entitlement please use the /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants endpoint.
-If page is provided that takes precedence and the paginated response is returned.
+ * To fetch the grants of a specific entitlement please use the /api/v2/customers/{customerIdOrKey}/entitlements/{entitlementIdOrFeatureKey}/grants endpoint.
+ * If page is provided that takes precedence and the paginated response is returned.
  * @summary List grants
  */
 export const listGrantsV2QueryCustomerItemOneRegExp = /^[0-7][0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{25}$/;