@openmeter/client 1.0.0-beta.230 → 1.0.0-beta.231

package/dist/models/types.d.ts

@@ -650,99 +650,22 @@ export interface CursorPaginationQuery {
 /** Filter options for listing meters. */
 export interface ListMetersParamsFilter {
     /** Filter meters by key. */
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    key?: StringFieldFilter;
     /** Filter meters by name. */
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    name?: StringFieldFilter;
 }
 /** Filter options for listing LLM cost prices. */
 export interface ListLlmCostPricesParamsFilter {
     /** Filter by provider. e.g. ?filter[provider][eq]=openai */
-    provider?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    provider?: StringFieldFilter;
     /** Filter by model ID. e.g. ?filter[model_id][eq]=gpt-4 */
-    modelId?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    modelId?: StringFieldFilter;
     /** Filter by model name. e.g. ?filter[model_name][contains]=gpt */
-    modelName?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    modelName?: StringFieldFilter;
     /** Filter by currency code. e.g. ?filter[currency][eq]=USD */
-    currency?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    currency?: StringFieldFilter;
     /** Filter by source. e.g. ?filter[source][eq]=system */
-    source?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    source?: StringFieldFilter;
 }
 /**
  * Filters on the resource's `labels` field.
@@ -752,18 +675,7 @@ export interface ListLlmCostPricesParamsFilter {
  * `filter[labels][key]=value` (nested) and `filter[labels.key]=value`
  * (dot-notation).
  */
-export type LabelsFieldFilter = Record<string, string | {
-    eq?: string;
-    neq?: string;
-    contains?: string;
-    ocontains?: string[];
-    oeq?: string[];
-    gt?: string;
-    gte?: string;
-    lt?: string;
-    lte?: string;
-    exists?: boolean;
-}>;
+export type LabelsFieldFilter = Record<string, StringFieldFilter>;
 /** Customer reference. */
 export interface CustomerReference {
     id: string;
@@ -1293,7 +1205,7 @@ export interface CreateMeterRequest {
     labels?: Labels;
     key: string;
     /** The aggregation type to use for the meter. */
-    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    aggregation: MeterAggregation;
     /** The event type to include in the aggregation. */
     eventType: string;
     /**
@@ -1343,7 +1255,7 @@ export interface Meter {
     deletedAt?: Date;
     key: string;
     /** The aggregation type to use for the meter. */
-    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    aggregation: MeterAggregation;
     /** The event type to include in the aggregation. */
     eventType: string;
     /**
@@ -1685,43 +1597,17 @@ export interface ListCreditGrantsParamsFilter {
     /** Filter credit grants by currency. */
     currency?: string;
     /** Filter credit grants by key. */
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    key?: StringFieldFilter;
 }
 /** Filter options for getting a credit balance. */
 export interface GetCreditBalanceParamsFilter {
     /** Filter credit balance by currency. */
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    currency?: StringFieldFilterExact;
     /**
      * Filter credit balance by feature key. Omit to return the total portfolio value.
      * Use `exists=false` to return only unrestricted balance.
      */
-    featureKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    featureKey?: StringFieldFilter;
 }
 /** Filter options for listing charges. */
 export interface ListChargesParamsFilter {
@@ -1737,48 +1623,25 @@ export interface ListChargesParamsFilter {
      *
      * If omitted, all statuses are returned except for `deleted`.
      */
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    status?: StringFieldFilterExact;
 }
 /** Filter options for listing plans. */
 export interface ListPlansParamsFilter {
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    status?: StringFieldFilterExact;
+    currency?: StringFieldFilterExact;
+}
+/** Request body for voiding a credit grant. */
+export interface VoidCreditGrantRequest {
+    /**
+     * How voiding adjusts payment state related to the grant.
+     *
+     * Currently only `none` is supported: voiding does not adjust invoices, payment
+     * authorization, settlement, payment intents, or external collection state. If
+     * payment later completes, the original invoiced amount may still be collected.
+     */
+    paymentAdjustment: 'none';
 }
 /** Subscription create request. */
 export interface SubscriptionCreate {
@@ -2047,18 +1910,7 @@ export interface InvoiceLineBaseDiscount {
 /** Filter options for listing currencies. */
 export interface ListCurrenciesParamsFilter {
     type?: 'fiat' | 'custom';
-    code?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    code?: StringFieldFilter;
 }
 /** Describes custom currency. */
 export interface CurrencyCustom {
@@ -2164,7 +2016,7 @@ export interface CreditAdjustment {
 }
 /** The credit balance by currency. */
 export interface CreditBalance {
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Credits available after applying currently live charge impacts. */
     live: string;
     /** Credits that have been booked on the ledger as of the balance timestamp. */
@@ -2191,33 +2043,22 @@ export interface CreateCreditAdjustmentRequest {
     description?: string;
     labels?: Labels;
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
 }
 /** Filter options for listing credit transactions. */
 export interface ListCreditTransactionsParamsFilter {
     /** Filter credit transactions by type. */
-    type?: 'funded' | 'consumed' | 'expired';
+    type?: 'funded' | 'consumed' | 'expired' | 'voided';
     /** Filter credit transactions by currency. */
-    currency?: string;
+    currency?: BillingCurrencyCode;
     /**
      * Filter credit transactions by feature key. Omit to return all credit
      * transactions. Use `exists=false` to return only unrestricted credit
      * transactions.
      */
-    featureKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    featureKey?: StringFieldFilter;
 }
 /**
  * A credit transaction represents a single credit movement on the customer's
@@ -2245,9 +2086,9 @@ export interface CreditTransaction {
     /** The date and time the transaction was booked. */
     bookedAt: Date;
     /** The type of credit transaction. */
-    type: 'funded' | 'consumed' | 'expired';
+    type: 'funded' | 'consumed' | 'expired' | 'voided';
     /** Currency of the balance affected by the transaction. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * Signed amount of the credit movement. Positive values add balance, negative
      * values reduce balance.
@@ -2405,173 +2246,34 @@ export interface LlmCostOverrideCreate {
 }
 /** Filter options for listing customers. */
 export interface ListCustomersParamsFilter {
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    primaryEmail?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    usageAttributionSubjectKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    planKey?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    billingProfileId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    primaryEmail?: StringFieldFilter;
+    usageAttributionSubjectKey?: StringFieldFilter;
+    planKey?: StringFieldFilter;
+    billingProfileId?: UlidFieldFilter;
 }
 /** Filter options for listing subscriptions. */
 export interface ListSubscriptionsParamsFilter {
-    id?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    planId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    planKey?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    id?: UlidFieldFilter;
+    customerId?: UlidFieldFilter;
+    status?: StringFieldFilterExact;
+    planId?: UlidFieldFilter;
+    planKey?: StringFieldFilterExact;
 }
 /** Filter options for listing features. */
 export interface ListFeatureParamsFilter {
-    meterId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    meterId?: UlidFieldFilter;
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
 }
 /** Filter options for listing add-ons. */
 export interface ListAddonsParamsFilter {
-    id?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    key?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    currency?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    id?: UlidFieldFilter;
+    key?: StringFieldFilter;
+    name?: StringFieldFilter;
+    status?: StringFieldFilterExact;
+    currency?: StringFieldFilterExact;
 }
 /**
  * Tax configuration for a credit grant.
@@ -2742,164 +2444,43 @@ export interface UpdateRateCardTaxConfig {
 /** Filter options for listing ingested events. */
 export interface ListEventsParamsFilter {
     /** Filter events by ID. */
-    id?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    id?: StringFieldFilter;
     /** Filter events by source. */
-    source?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    source?: StringFieldFilter;
     /** Filter events by subject. */
-    subject?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    subject?: StringFieldFilter;
     /** Filter events by type. */
-    type?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    type?: StringFieldFilter;
     /** Filter events by the associated customer ID. */
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    customerId?: UlidFieldFilter;
     /** Filter events by event time. */
-    time?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    time?: DateTimeFieldFilter;
     /** Filter events by the time the event was ingested. */
-    ingestedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    ingestedAt?: DateTimeFieldFilter;
     /** Filter events by the time the event was stored. */
-    storedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    storedAt?: DateTimeFieldFilter;
 }
 /** Filter options for listing invoices. */
 export interface ListInvoicesParamsFilter {
     /** Filter by invoice status. */
-    status?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    status?: StringFieldFilterExact;
     /** Filter by customer ID. */
-    customerId?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
+    customerId?: UlidFieldFilter;
     /** Filter by the time the invoice was issued. */
-    issuedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    issuedAt?: DateTimeFieldFilter;
     /** Filter by service period start. */
-    servicePeriodStart?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    servicePeriodStart?: DateTimeFieldFilter;
     /** Filter by invoice creation time. */
-    createdAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    createdAt?: DateTimeFieldFilter;
 }
 /** Resource filters. */
 export interface ResourceFilters {
-    name?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
+    name?: StringFieldFilter;
     labels?: LabelsFieldFilter;
     publicLabels?: LabelsFieldFilter;
-    createdAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
-    updatedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
-    deletedAt?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    createdAt?: DateTimeFieldFilter;
+    updatedAt?: DateTimeFieldFilter;
+    deletedAt?: DateTimeFieldFilter;
 }
 /** Field filters with all supported types. */
 export interface FieldFilters {
@@ -2915,35 +2496,10 @@ export interface FieldFilters {
         gt?: number;
         gte?: number;
     };
-    string?: string | {
-        eq?: string;
-        neq?: string;
-        contains?: string;
-        ocontains?: string[];
-        oeq?: string[];
-        gt?: string;
-        gte?: string;
-        lt?: string;
-        lte?: string;
-        exists?: boolean;
-    };
-    stringExact?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    ulid?: string | {
-        eq?: string;
-        oeq?: string[];
-        neq?: string;
-    };
-    datetime?: Date | {
-        eq?: Date;
-        lt?: Date;
-        lte?: Date;
-        gt?: Date;
-        gte?: Date;
-    };
+    string?: StringFieldFilter;
+    stringExact?: StringFieldFilterExact;
+    ulid?: UlidFieldFilter;
+    datetime?: DateTimeFieldFilter;
     labels?: LabelsFieldFilter;
 }
 /** An ingested metering event with ingestion metadata. */
@@ -3200,7 +2756,7 @@ export interface ChargeFlatFeeSystemIntent {
     /** The billing period the charge belongs to. */
     billingPeriod: ClosedPeriod;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The proration configuration of the charge. */
@@ -3228,7 +2784,7 @@ export interface SubscriptionChangeResponse {
 /** Request for canceling a subscription. */
 export interface SubscriptionCancel {
     /** If not provided the subscription is canceled immediately. */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /** Request for changing a subscription. */
 export interface SubscriptionChange {
@@ -3272,7 +2828,7 @@ export interface SubscriptionChange {
      * changing a subscription, the accepted values depend on the subscription
      * configuration.
      */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /** SubscriptionAddon create request. */
 export interface CreateSubscriptionAddonRequest {
@@ -3285,7 +2841,7 @@ export interface CreateSubscriptionAddonRequest {
      * The timing of the operation. After the create or update, a new entry will be
      * created in the timeline.
      */
-    timing: 'immediate' | 'next_billing_cycle' | Date;
+    timing: SubscriptionEditTiming;
 }
 /**
  * Usage quantity details on an invoice line item when UnitConfig is in effect.
@@ -3519,7 +3075,7 @@ export interface InvoiceWorkflow {
     /** Invoicing settings for this invoice. */
     invoicing?: InvoiceWorkflowInvoicingSettings;
     /** Payment settings for this invoice. */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+    payment?: WorkflowPaymentSettings;
 }
 /** Detailed status information for a standard invoice. */
 export interface InvoiceStatusDetails {
@@ -3553,7 +3109,7 @@ export interface UpdateBillingInvoiceWorkflow {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettings;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
+    payment?: UpdateBillingWorkflowPaymentSettings;
 }
 /** Access status for a single feature. */
 export interface GovernanceFeatureAccess {
@@ -3689,7 +3245,7 @@ export interface CreateCreditGrantRequest {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: CreateCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -3756,7 +3312,7 @@ export interface CreditGrant {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -3829,7 +3385,7 @@ export interface CreateChargeFlatFeeRequest {
     /** Tax configuration of the charge. */
     taxConfig?: TaxConfig;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The feature associated with the charge, when applicable. */
@@ -3878,7 +3434,7 @@ export interface IngestedEventPaginatedResponse {
     meta: CursorMeta;
 }
 /** The list of parameters that failed validation. */
-export type InvalidParameters = (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+export type InvalidParameters = InvalidParameter[];
 /** A meter query request. */
 export interface MeterQueryRequest {
     /** The start of the period the usage is queried from. */
@@ -3889,7 +3445,7 @@ export interface MeterQueryRequest {
      * The size of the time buckets to group the usage into. If not specified, the
      * usage is aggregated over the entire period.
      */
-    granularity?: 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+    granularity?: MeterQueryGranularity;
     /**
      * The value is the name of the time zone as defined in the IANA Time Zone Database
      * (http://www.iana.org/time-zones). The time zone is used to determine the start
@@ -4134,7 +3690,7 @@ export interface UpdateInvoiceWorkflowSettings {
 }
 /** Page paginated response. */
 export interface CurrencyPagePaginatedResponse {
-    data: (CurrencyFiat | CurrencyCustom)[];
+    data: Currency[];
     meta: PaginatedMeta;
 }
 /** Access evaluation result for a single resolved customer. */
@@ -4196,7 +3752,7 @@ export interface Feature {
      * "llm" to look up cost from the LLM cost database based on meter group-by
      * properties.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+    unitCost?: FeatureUnitCost;
 }
 /** Feature create request. */
 export interface CreateFeatureRequest {
@@ -4224,7 +3780,7 @@ export interface CreateFeatureRequest {
      * "llm" to look up cost from the LLM cost database based on meter group-by
      * properties.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+    unitCost?: FeatureUnitCost;
 }
 /**
  * Request body for updating a feature. Currently only the unit_cost field can be
@@ -4237,7 +3793,7 @@ export interface UpdateFeatureRequest {
      * properties. Set to `null` to clear the existing unit cost; omit to leave it
      * unchanged.
      */
-    unitCost?: FeatureManualUnitCost | FeatureLlmUnitCost | null;
+    unitCost?: FeatureUnitCost | null;
 }
 /** Page paginated response. */
 export interface CreditGrantPagePaginatedResponse {
@@ -4247,7 +3803,7 @@ export interface CreditGrantPagePaginatedResponse {
 /** Bad Request. */
 export interface BadRequest extends BaseError {
     /** The list of parameters that failed validation. */
-    invalidParameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+    invalidParameters: InvalidParameter[];
 }
 /**
  * Base fields shared by all invoice types.
@@ -4322,7 +3878,7 @@ export interface CustomerStripeCreateCheckoutSessionRequest {
  */
 export interface WorkflowCollectionSettings {
     /** The alignment for collecting the pending line items into an invoice. */
-    alignment: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    alignment: WorkflowCollectionAlignment;
     /**
      * This grace period can be used to delay the collection of the pending line items
      * specified in alignment.
@@ -4334,17 +3890,17 @@ export interface WorkflowCollectionSettings {
 }
 /** Page paginated response. */
 export interface AppPagePaginatedResponse {
-    data: (AppStripe | AppSandbox | AppExternalInvoicing)[];
+    data: App[];
     meta: PaginatedMeta;
 }
 /** Applications used by a billing profile. */
 export interface ProfileApps {
     /** The tax app used for this workflow. */
-    tax: AppStripe | AppSandbox | AppExternalInvoicing;
+    tax: App;
     /** The invoicing app used for this workflow. */
-    invoicing: AppStripe | AppSandbox | AppExternalInvoicing;
+    invoicing: App;
     /** The payment app used for this workflow. */
-    payment: AppStripe | AppSandbox | AppExternalInvoicing;
+    payment: App;
 }
 /** Response of the governance query. */
 export interface GovernanceQueryResponse {
@@ -4418,7 +3974,7 @@ export interface ChargeFlatFee {
     /** Tax configuration of the charge. */
     taxConfig?: TaxConfig;
     /** Payment term of the flat fee charge. */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /** The discounts applied to the charge. */
     discounts?: ChargeFlatFeeDiscounts;
     /** The feature associated with the charge, when applicable. */
@@ -4428,7 +3984,7 @@ export interface ChargeFlatFee {
     /** The amount after proration of the charge. */
     amountAfterProration: CurrencyAmount;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Current intent from the system lifecycle controller for a charge that has an
      * active manual override. The top-level charge fields remain the effective
@@ -4465,7 +4021,7 @@ export interface ChargeUsageBasedSystemIntent {
     /** Discounts applied to the usage-based charge. */
     discounts?: RateCardDiscounts;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * The timestamp when the system lifecycle controller intent was deleted. The
      * effective charge can remain visible while a manual override is active.
@@ -4506,7 +4062,7 @@ export interface CreateChargeUsageBasedRequest {
     /** The feature associated with the charge. */
     featureKey: string;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /** The full, unprorated service period of the charge. */
     fullServicePeriod?: ClosedPeriod;
     /** The billing period the charge belongs to. */
@@ -4536,7 +4092,7 @@ export interface RateCard {
      */
     billingCadence?: string;
     /** The price of the rate card. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Unit conversion configuration for the rate card.
      *
@@ -4552,7 +4108,7 @@ export interface RateCard {
      * The payment term of the rate card. In advance payment term can only be used for
      * flat prices.
      */
-    paymentTerm: 'in_advance' | 'in_arrears';
+    paymentTerm: PricePaymentTerm;
     /**
      * Spend commitments for this rate card. Only applicable to usage-based prices
      * (unit, graduated, volume).
@@ -4566,12 +4122,12 @@ export interface RateCard {
      * The entitlement template granted to subscribers of a plan or addon containing
      * this rate card. Requires `feature` to be set.
      */
-    entitlement?: RateCardMeteredEntitlement | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+    entitlement?: RateCardEntitlement;
 }
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface InvoiceLineRateCard {
     /** The price definition used to calculate charges for this line. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /** Tax configuration snapshot for this line. */
     taxConfig?: RateCardTaxConfig;
     /** The feature key associated with this line's rate card. */
@@ -4582,7 +4138,7 @@ export interface InvoiceLineRateCard {
 /** Rate card configuration snapshot for a usage-based invoice line. */
 export interface UpdateInvoiceLineRateCard {
     /** The price definition used to calculate charges for this line. */
-    price: UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
+    price: UpdatePrice;
     /** Tax configuration snapshot for this line. */
     taxConfig?: UpdateRateCardTaxConfig;
     /** The feature key associated with this line's rate card. */
@@ -4602,7 +4158,7 @@ export interface Workflow {
     /** The invoicing settings for this workflow */
     invoicing?: WorkflowInvoicingSettings;
     /** The payment settings for this workflow */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+    payment?: WorkflowPaymentSettings;
     /** The tax settings for this workflow */
     tax?: WorkflowTaxSettings;
 }
@@ -4672,7 +4228,7 @@ export interface ChargeUsageBased {
     /** Aggregated booked and realtime totals for the charge. */
     totals: ChargeTotals;
     /** The price of the charge. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Current intent from the system lifecycle controller for a charge that has an
      * active manual override. The top-level charge fields remain the effective
@@ -4750,7 +4306,7 @@ export interface Addon {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * The date and time when the add-on becomes effective. When not specified, the
      * add-on is a draft.
@@ -4799,7 +4355,7 @@ export interface CreateAddonRequest {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The rate cards of the add-on. */
     rateCards: RateCard[];
 }
@@ -5213,7 +4769,7 @@ export interface ProfilePagePaginatedResponse {
 }
 /** Page paginated response. */
 export interface ChargePagePaginatedResponse {
-    data: (ChargeFlatFee | ChargeUsageBased)[];
+    data: Charge[];
     meta: PaginatedMeta;
 }
 /** Page paginated response. */
@@ -5305,7 +4861,7 @@ export interface InvoiceStandard {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLine[];
+    lines?: InvoiceLine[];
 }
 /** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequest {
@@ -5336,19 +4892,152 @@ export interface UpdateInvoiceStandardRequest {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
 /** Page paginated response. */
 export interface InvoicePagePaginatedResponse {
-    data: InvoiceStandard[];
+    data: Invoice[];
     meta: PaginatedMeta;
 }
+/**
+ * Filters on the given string field value by either exact or fuzzy match. All
+ * properties are optional; provide exactly one to specify the comparison.
+ */
+export type StringFieldFilter = string | {
+    eq?: string;
+    neq?: string;
+    contains?: string;
+    ocontains?: string[];
+    oeq?: string[];
+    gt?: string;
+    gte?: string;
+    lt?: string;
+    lte?: string;
+    exists?: boolean;
+};
+/** The aggregation type to use for the meter. */
+export type MeterAggregation = 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+/**
+ * The granularity of the time grouping. Time durations are specified in ISO 8601
+ * format.
+ */
+export type MeterQueryGranularity = 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+/**
+ * Filters on the given string field value by exact match. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type StringFieldFilterExact = string | {
+    eq?: string;
+    oeq?: string[];
+    neq?: string;
+};
+/** The payment term of a flat price. */
+export type PricePaymentTerm = 'in_advance' | 'in_arrears';
+/** Fiat or custom currency code. */
+export type BillingCurrencyCode = string;
+/** Fiat or custom currency code. */
+export type CreateCurrencyCode = string;
+/**
+ * Filters on the given ULID field value by exact match. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type UlidFieldFilter = string | {
+    eq?: string;
+    oeq?: string[];
+    neq?: string;
+};
+/**
+ * Filters on the given datetime (RFC-3339) field value. All properties are
+ * optional; provide exactly one to specify the comparison.
+ */
+export type DateTimeFieldFilter = Date | {
+    eq?: Date;
+    lt?: Date;
+    lte?: Date;
+    gt?: Date;
+    gte?: Date;
+};
+/**
+ * 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.
+ */
+export type SubscriptionEditTiming = 'immediate' | 'next_billing_cycle' | Date;
+/** Payment settings for a billing workflow. */
+export type WorkflowPaymentSettings = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettings = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettings;
+/** A parameter that failed validation. */
+export type InvalidParameter = InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem;
+/**
+ * Entitlement template configured on a rate card. The feature is taken from the
+ * rate card itself, so it is omitted here.
+ */
+export type RateCardEntitlement = RateCardMeteredEntitlement | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/** Fiat or custom currency. */
+export type Currency = CurrencyFiat | CurrencyCustom;
+/**
+ * Per-unit cost configuration for a feature. Either a fixed manual amount or a
+ * dynamic LLM cost lookup.
+ */
+export type FeatureUnitCost = FeatureManualUnitCost | FeatureLlmUnitCost;
+/**
+ * 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 type WorkflowCollectionAlignment = WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+/** Installed application. */
+export type App = AppStripe | AppSandbox | AppExternalInvoicing;
+/** Price. */
+export type Price = PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+/** Price. */
+export type UpdatePrice = UpdatePriceFree | UpdatePriceFlat | UpdatePriceUnit | UpdatePriceGraduated | UpdatePriceVolume;
+/** Customer charge. */
+export type CreateChargeRequest = CreateChargeFlatFeeRequest | CreateChargeUsageBasedRequest;
+/** Customer charge. */
+export type Charge = ChargeFlatFee | ChargeUsageBased;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLine = InvoiceStandardLine;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type UpdateInvoiceLine = UpdateInvoiceStandardLine;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type Invoice = InvoiceStandard;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequest = UpdateInvoiceStandardRequest;
+/**
+ * Sort query.
+ *
+ * The `asc` suffix is optional as the default sort order is ascending. The `desc`
+ * suffix is used to specify a descending order.
+ */
 export interface SortQueryInput {
     /** The attribute to sort by. */
     by: string;
     /** The sort order. `asc` for ascending, `desc` for descending. */
     order?: 'asc' | 'desc';
 }
+/** Standard error response. */
 export interface BaseErrorInput {
     /** Type contains a URI that identifies the problem type. */
     type?: string;
@@ -5365,6 +5054,10 @@ export interface BaseErrorInput {
     instance: string;
     [key: string]: unknown;
 }
+/**
+ * Payment settings for a billing workflow when the collection method is send
+ * invoice.
+ */
 export interface WorkflowPaymentSendInvoiceSettingsInput {
     /** The collection method for the invoice. */
     collectionMethod: 'send_invoice';
@@ -5374,6 +5067,13 @@ export interface WorkflowPaymentSendInvoiceSettingsInput {
      */
     dueAfter?: string;
 }
+/**
+ * Invoice-level invoicing settings.
+ *
+ * A subset of BillingWorkflowInvoicingSettings limited to fields that are
+ * meaningful per-invoice. progressive_billing is omitted as it is a gather-time /
+ * profile-level decision.
+ */
 export interface InvoiceWorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draft_period has passed. */
     autoAdvance?: boolean;
@@ -5382,12 +5082,23 @@ export interface InvoiceWorkflowInvoicingSettingsInput {
     /** The period after which the invoice is considered overdue if not paid. */
     dueAfter?: string;
 }
+/**
+ * Invoice-level invoicing settings.
+ *
+ * A subset of BillingWorkflowInvoicingSettings limited to fields that are
+ * meaningful per-invoice. progressive_billing is omitted as it is a gather-time /
+ * profile-level decision.
+ */
 export interface UpdateBillingInvoiceWorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draft_period has passed. */
     autoAdvance?: boolean;
     /** The period for the invoice to be kept in draft status for manual reviews. */
     draftPeriod?: string;
 }
+/**
+ * Payment settings for a billing workflow when the collection method is send
+ * invoice.
+ */
 export interface UpdateBillingWorkflowPaymentSendInvoiceSettingsInput {
     /** The collection method for the invoice. */
     collectionMethod: 'send_invoice';
@@ -5397,6 +5108,7 @@ export interface UpdateBillingWorkflowPaymentSendInvoiceSettingsInput {
      */
     dueAfter?: string;
 }
+/** Metering event following the CloudEvents specification. */
 export interface EventInput {
     /** Identifies the event. */
     id: string;
@@ -5426,30 +5138,43 @@ export interface EventInput {
     /** The event payload. Optional, if present it must be a JSON object. */
     data?: Record<string, unknown> | null;
 }
+/** Unauthorized. */
 export interface UnauthorizedInput extends BaseErrorInput {
 }
+/** Forbidden. */
 export interface ForbiddenInput extends BaseErrorInput {
 }
+/** Not Found. */
 export interface NotFoundInput extends BaseErrorInput {
 }
+/** Gone. */
 export interface GoneInput extends BaseErrorInput {
 }
+/** Conflict. */
 export interface ConflictInput extends BaseErrorInput {
 }
+/** Payload Too Large. */
 export interface PayloadTooLargeInput extends BaseErrorInput {
 }
+/** Unsupported Media Type. */
 export interface UnsupportedMediaTypeInput extends BaseErrorInput {
 }
+/** Unprocessable Content. */
 export interface UnprocessableContentInput extends BaseErrorInput {
 }
+/** Too Many Requests. */
 export interface TooManyRequestsInput extends BaseErrorInput {
 }
+/** Internal Server Error. */
 export interface InternalInput extends BaseErrorInput {
 }
+/** Not Implemented. */
 export interface NotImplementedInput extends BaseErrorInput {
 }
+/** Not Available. */
 export interface NotAvailableInput extends BaseErrorInput {
 }
+/** Controls which customer fields can be updated by the checkout session. */
 export interface AppStripeCreateCheckoutSessionCustomerUpdateInput {
     /**
      * Whether to save the billing address to customer.address.
@@ -5470,6 +5195,7 @@ export interface AppStripeCreateCheckoutSessionCustomerUpdateInput {
      */
     shipping?: 'auto' | 'never';
 }
+/** Tax ID collection configuration for checkout sessions. */
 export interface AppStripeCreateCheckoutSessionTaxIdCollectionInput {
     /**
      * Enable tax ID collection during checkout.
@@ -5484,6 +5210,7 @@ export interface AppStripeCreateCheckoutSessionTaxIdCollectionInput {
      */
     required?: 'if_supported' | 'never';
 }
+/** Purchase and payment terms of the grant. */
 export interface CreateCreditGrantPurchaseInput {
     /** Currency of the purchase amount. */
     currency: string;
@@ -5504,6 +5231,7 @@ export interface CreateCreditGrantPurchaseInput {
      */
     availabilityPolicy?: 'on_creation';
 }
+/** The entitlement template of a metered entitlement. */
 export interface RateCardMeteredEntitlementInput {
     /** The type of the entitlement template. */
     type: 'metered';
@@ -5525,6 +5253,7 @@ export interface RateCardMeteredEntitlementInput {
      */
     usagePeriod?: string;
 }
+/** Purchase and payment terms of the grant. */
 export interface CreditGrantPurchaseInput {
     /** Currency of the purchase amount. */
     currency: string;
@@ -5549,6 +5278,41 @@ export interface CreditGrantPurchaseInput {
     /** Current payment settlement status. */
     settlementStatus?: 'pending' | 'authorized' | 'settled';
 }
+/** Request body for voiding a credit grant. */
+export interface VoidCreditGrantRequestInput {
+    /**
+     * How voiding adjusts payment state related to the grant.
+     *
+     * Currently only `none` is supported: voiding does not adjust invoices, payment
+     * authorization, settlement, payment intents, or external collection state. If
+     * payment later completes, the original invoiced amount may still be collected.
+     */
+    paymentAdjustment?: 'none';
+}
+/**
+ * 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 interface UnitConfigInput {
     /** The arithmetic operation to apply to the raw metered quantity. */
     operation: 'divide' | 'multiply';
@@ -5583,6 +5347,7 @@ export interface UnitConfigInput {
      */
     displayUnit?: string;
 }
+/** Invoice settings for a billing workflow. */
 export interface WorkflowInvoicingSettingsInput {
     /** Whether to automatically issue the invoice after the draftPeriod has passed. */
     autoAdvance?: boolean;
@@ -5593,6 +5358,7 @@ export interface WorkflowInvoicingSettingsInput {
     /** Controls how subscription-ending shortened service periods are billed. */
     subscriptionEndProrationMode?: 'bill_full_period' | 'bill_actual_period';
 }
+/** Query to evaluate feature access for a list of customers. */
 export interface GovernanceQueryRequestInput {
     /**
      * Whether to include credit balance availability for each resolved customer. When
@@ -5604,6 +5370,7 @@ export interface GovernanceQueryRequestInput {
     customer: GovernanceQueryRequestCustomers;
     feature?: GovernanceQueryRequestFeatures;
 }
+/** An ingested metering event with ingestion metadata. */
 export interface IngestedEventInput {
     /** The original event ingested. */
     event: EventInput;
@@ -5616,10 +5383,16 @@ export interface IngestedEventInput {
     /** The validation errors of the ingested event. */
     validationErrors?: IngestedEventValidationError[];
 }
+/** Request for canceling a subscription. */
 export interface SubscriptionCancelInput {
     /** If not provided the subscription is canceled immediately. */
-    timing?: 'immediate' | 'next_billing_cycle' | Date;
+    timing?: SubscriptionEditTiming;
 }
+/**
+ * Usage quantity details on an invoice line item when UnitConfig is in effect.
+ *
+ * Provides the full audit trail from raw meter output to the invoiced amount.
+ */
 export interface InvoiceUsageQuantityDetailInput {
     /** The raw quantity as reported by the meter (native units). */
     rawQuantity: string;
@@ -5638,18 +5411,33 @@ export interface InvoiceUsageQuantityDetailInput {
      */
     appliedUnitConfig: UnitConfigInput;
 }
+/**
+ * Invoice-level snapshot of the workflow configuration.
+ *
+ * Contains only the settings that are meaningful for an already-created invoice:
+ * invoicing behaviour and payment settings. Collection alignment and tax policy
+ * are gather-time / profile-wide concerns and are not included.
+ */
 export interface InvoiceWorkflowInput {
     /** Invoicing settings for this invoice. */
     invoicing?: InvoiceWorkflowInvoicingSettingsInput;
     /** Payment settings for this invoice. */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+    payment?: WorkflowPaymentSettingsInput;
 }
+/**
+ * Invoice-level snapshot of the workflow configuration.
+ *
+ * Contains only the settings that are meaningful for an already-created invoice:
+ * invoicing behaviour and payment settings. Collection alignment and tax policy
+ * are gather-time / profile-wide concerns and are not included.
+ */
 export interface UpdateBillingInvoiceWorkflowInput {
     /** Invoicing settings for this invoice. */
     invoicing?: UpdateBillingInvoiceWorkflowInvoicingSettingsInput;
     /** Payment settings for this invoice. */
-    payment?: UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
+    payment?: UpdateBillingWorkflowPaymentSettingsInput;
 }
+/** CreditGrant create request. */
 export interface CreateCreditGrantRequestInput {
     /**
      * Display name of the resource.
@@ -5667,7 +5455,7 @@ export interface CreateCreditGrantRequestInput {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: CreateCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -5704,6 +5492,12 @@ export interface CreateCreditGrantRequestInput {
      */
     key?: string;
 }
+/**
+ * A credit grant allocates credits to a customer.
+ *
+ * Credits are drawn down against charges according to the settlement mode
+ * configured on the rate card.
+ */
 export interface CreditGrantInput {
     id: string;
     /**
@@ -5728,7 +5522,7 @@ export interface CreditGrantInput {
     /** Funding method of the grant. */
     fundingMethod: 'none' | 'invoice' | 'external';
     /** The currency of the granted credits. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** Granted credit amount. */
     amount: string;
     /** Present when a funding workflow applies (funding_method is not `none`). */
@@ -5771,6 +5565,7 @@ export interface CreditGrantInput {
     /** Current lifecycle status of the grant. */
     status: 'pending' | 'active' | 'expired' | 'voided';
 }
+/** Tax settings for a billing workflow. */
 export interface WorkflowTaxSettingsInput {
     /**
      * Enable automatic tax calculation when tax is supported by the app. For example,
@@ -5794,10 +5589,12 @@ export interface WorkflowTaxSettingsInput {
      */
     defaultTaxConfig?: TaxConfig;
 }
+/** Cursor paginated response. */
 export interface IngestedEventPaginatedResponseInput {
     data: IngestedEventInput[];
     meta: CursorMeta;
 }
+/** A meter query request. */
 export interface MeterQueryRequestInput {
     /** The start of the period the usage is queried from. */
     from?: Date;
@@ -5807,7 +5604,7 @@ export interface MeterQueryRequestInput {
      * The size of the time buckets to group the usage into. If not specified, the
      * usage is aggregated over the entire period.
      */
-    granularity?: 'PT1M' | 'PT1H' | 'P1D' | 'P1M';
+    granularity?: MeterQueryGranularity;
     /**
      * The value is the name of the time zone as defined in the IANA Time Zone Database
      * (http://www.iana.org/time-zones). The time zone is used to determine the start
@@ -5819,6 +5616,12 @@ export interface MeterQueryRequestInput {
     /** Filters to apply to the query. */
     filters?: MeterQueryFilters;
 }
+/**
+ * Configuration options for creating a Stripe Checkout Session.
+ *
+ * Based on Stripe's
+ * [Checkout Session API parameters](https://docs.stripe.com/api/checkout/sessions/create).
+ */
 export interface AppStripeCreateCheckoutSessionRequestOptionsInput {
     /**
      * Whether to collect the customer's billing address.
@@ -5906,6 +5709,7 @@ export interface AppStripeCreateCheckoutSessionRequestOptionsInput {
     /** Configuration for collecting tax IDs during checkout. */
     taxIdCollection?: AppStripeCreateCheckoutSessionTaxIdCollectionInput;
 }
+/** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface InvoiceWorkflowSettingsInput {
     /** The apps that will be used to orchestrate the invoice's workflow. */
     apps?: InvoiceWorkflowAppsReferences;
@@ -5921,6 +5725,12 @@ export interface InvoiceWorkflowSettingsInput {
      */
     workflow: InvoiceWorkflowInput;
 }
+/**
+ * A detailed (child) sub-line belonging to a parent invoice line.
+ *
+ * Detailed lines represent the individual flat-fee components that make up a
+ * usage-based parent line after quantity snapshotting.
+ */
 export interface InvoiceDetailedLineInput {
     id: string;
     /**
@@ -5959,6 +5769,7 @@ export interface InvoiceDetailedLineInput {
     /** The unit price of the detailed line. */
     unitPrice: string;
 }
+/** Snapshot of the billing workflow configuration captured at invoice creation. */
 export interface UpdateInvoiceWorkflowSettingsInput {
     /**
      * The workflow configuration that was active when the invoice was created.
@@ -5970,14 +5781,23 @@ export interface UpdateInvoiceWorkflowSettingsInput {
      */
     workflow: UpdateBillingInvoiceWorkflowInput;
 }
+/** Page paginated response. */
 export interface CreditGrantPagePaginatedResponseInput {
     data: CreditGrantInput[];
     meta: PaginatedMeta;
 }
+/** Bad Request. */
 export interface BadRequestInput extends BaseErrorInput {
     /** The list of parameters that failed validation. */
-    invalidParameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+    invalidParameters: InvalidParameter[];
 }
+/**
+ * Request to create a Stripe Checkout Session for the customer.
+ *
+ * Checkout Sessions are used to collect payment method information from customers
+ * in a secure, Stripe-hosted interface. This integration uses setup mode to
+ * collect payment methods that can be charged later for subscription billing.
+ */
 export interface CustomerStripeCreateCheckoutSessionRequestInput {
     /**
      * Options for configuring the Stripe Checkout Session.
@@ -5987,9 +5807,13 @@ export interface CustomerStripeCreateCheckoutSessionRequestInput {
      */
     stripeOptions: AppStripeCreateCheckoutSessionRequestOptionsInput;
 }
+/**
+ * Workflow collection specifies how to collect the pending line items for an
+ * invoice.
+ */
 export interface WorkflowCollectionSettingsInput {
     /** The alignment for collecting the pending line items into an invoice. */
-    alignment?: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    alignment?: WorkflowCollectionAlignment;
     /**
      * This grace period can be used to delay the collection of the pending line items
      * specified in alignment.
@@ -5999,6 +5823,7 @@ export interface WorkflowCollectionSettingsInput {
      */
     interval?: string;
 }
+/** A rate card defines the pricing and entitlement of a feature or service. */
 export interface RateCardInput {
     /**
      * Display name of the resource.
@@ -6022,7 +5847,7 @@ export interface RateCardInput {
      */
     billingCadence?: string;
     /** The price of the rate card. */
-    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    price: Price;
     /**
      * Unit conversion configuration for the rate card.
      *
@@ -6038,7 +5863,7 @@ export interface RateCardInput {
      * The payment term of the rate card. In advance payment term can only be used for
      * flat prices.
      */
-    paymentTerm?: 'in_advance' | 'in_arrears';
+    paymentTerm?: PricePaymentTerm;
     /**
      * Spend commitments for this rate card. Only applicable to usage-based prices
      * (unit, graduated, volume).
@@ -6052,24 +5877,30 @@ export interface RateCardInput {
      * The entitlement template granted to subscribers of a plan or addon containing
      * this rate card. Requires `feature` to be set.
      */
-    entitlement?: RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+    entitlement?: RateCardEntitlementInput;
 }
+/** Billing workflow settings. */
 export interface WorkflowInput {
     /** The collection settings for this workflow */
     collection?: WorkflowCollectionSettingsInput;
     /** The invoicing settings for this workflow */
     invoicing?: WorkflowInvoicingSettingsInput;
     /** The payment settings for this workflow */
-    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+    payment?: WorkflowPaymentSettingsInput;
     /** The tax settings for this workflow */
     tax?: WorkflowTaxSettingsInput;
 }
+/** A rate card for a subscription add-on. */
 export interface SubscriptionAddonRateCardInput {
     /** The rate card. */
     rateCard: RateCardInput;
     /** The IDs of the subscription items that this rate card belongs to. */
     affectedSubscriptionItemIds: string[];
 }
+/**
+ * The plan phase or pricing ramp allows changing a plan's rate cards over time as
+ * a subscription progresses.
+ */
 export interface PlanPhaseInput {
     /**
      * Display name of the resource.
@@ -6093,6 +5924,10 @@ export interface PlanPhaseInput {
     /** The rate cards of the plan. */
     rateCards: RateCardInput[];
 }
+/**
+ * Add-on allows extending subscriptions with compatible plans with additional
+ * ratecards.
+ */
 export interface AddonInput {
     id: string;
     /**
@@ -6125,7 +5960,7 @@ export interface AddonInput {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /**
      * The date and time when the add-on becomes effective. When not specified, the
      * add-on is a draft.
@@ -6150,6 +5985,7 @@ export interface AddonInput {
     /** List of validation errors. */
     validationErrors?: ProductCatalogValidationError[];
 }
+/** Addon create request. */
 export interface CreateAddonRequestInput {
     /**
      * Display name of the resource.
@@ -6173,10 +6009,11 @@ export interface CreateAddonRequestInput {
     /** The InstanceType of the add-ons. Can be "single" or "multiple". */
     instanceType: 'single' | 'multiple';
     /** The currency code of the add-on. */
-    currency: string;
+    currency: BillingCurrencyCode;
     /** The rate cards of the add-on. */
     rateCards: RateCardInput[];
 }
+/** Addon upsert request. */
 export interface UpsertAddonRequestInput {
     /**
      * Display name of the resource.
@@ -6196,6 +6033,13 @@ export interface UpsertAddonRequestInput {
     /** The rate cards of the add-on. */
     rateCards: RateCardInput[];
 }
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
 export interface InvoiceStandardLineInput {
     /**
      * Display name of the resource.
@@ -6260,6 +6104,10 @@ export interface InvoiceStandardLineInput {
     /** Reference to the charge associated with this line item. */
     charge?: ChargeReference;
 }
+/**
+ * Billing profiles contain the settings for billing and controls invoice
+ * generation.
+ */
 export interface ProfileInput {
     id: string;
     /**
@@ -6293,6 +6141,7 @@ export interface ProfileInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** BillingProfile create request. */
 export interface CreateBillingProfileRequestInput {
     /**
      * Display name of the resource.
@@ -6319,6 +6168,7 @@ export interface CreateBillingProfileRequestInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** BillingProfile upsert request. */
 export interface UpsertBillingProfileRequestInput {
     /**
      * Display name of the resource.
@@ -6343,6 +6193,7 @@ export interface UpsertBillingProfileRequestInput {
     /** Whether this is the default profile. */
     default: boolean;
 }
+/** Addon purchased with a subscription. */
 export interface SubscriptionAddonInput {
     id: string;
     labels?: Labels;
@@ -6382,6 +6233,7 @@ export interface SubscriptionAddonInput {
     /** The rate cards of the add-on. */
     rateCards: SubscriptionAddonRateCardInput[];
 }
+/** Plans provide a template for subscriptions. */
 export interface PlanInput {
     id: string;
     /**
@@ -6461,6 +6313,7 @@ export interface PlanInput {
      */
     validationErrors?: ProductCatalogValidationError[];
 }
+/** Plan create request. */
 export interface CreatePlanRequestInput {
     /**
      * Display name of the resource.
@@ -6493,6 +6346,7 @@ export interface CreatePlanRequestInput {
      */
     phases: PlanPhaseInput[];
 }
+/** Plan upsert request. */
 export interface UpsertPlanRequestInput {
     /**
      * Display name of the resource.
@@ -6515,22 +6369,27 @@ export interface UpsertPlanRequestInput {
      */
     phases: PlanPhaseInput[];
 }
+/** Page paginated response. */
 export interface AddonPagePaginatedResponseInput {
     data: AddonInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface ProfilePagePaginatedResponseInput {
     data: ProfileInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface SubscriptionAddonPagePaginatedResponseInput {
     data: SubscriptionAddonInput[];
     meta: PaginatedMeta;
 }
+/** Page paginated response. */
 export interface PlanPagePaginatedResponseInput {
     data: PlanInput[];
     meta: PaginatedMeta;
 }
+/** A standard invoice for charges owed by the customer. */
 export interface InvoiceStandardInput {
     id: string;
     /**
@@ -6609,8 +6468,9 @@ export interface InvoiceStandardInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: InvoiceStandardLineInput[];
+    lines?: InvoiceLineInput[];
 }
+/** InvoiceStandard update request. */
 export interface UpdateInvoiceStandardRequestInput {
     /**
      * Optional description of the resource.
@@ -6639,10 +6499,37 @@ export interface UpdateInvoiceStandardRequestInput {
      * from the update request are deleted. Detailed (child) lines are always computed
      * and cannot be edited directly.
      */
-    lines?: UpdateInvoiceStandardLine[];
+    lines?: UpdateInvoiceLine[];
 }
+/** Page paginated response. */
 export interface InvoicePagePaginatedResponseInput {
-    data: InvoiceStandardInput[];
+    data: InvoiceInput[];
     meta: PaginatedMeta;
 }
-//# sourceMappingURL=types.d.ts.map
+/** Payment settings for a billing workflow. */
+export type WorkflowPaymentSettingsInput = WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettingsInput;
+/** Payment settings for a billing workflow. */
+export type UpdateBillingWorkflowPaymentSettingsInput = UpdateBillingWorkflowPaymentChargeAutomaticallySettings | UpdateBillingWorkflowPaymentSendInvoiceSettingsInput;
+/**
+ * Entitlement template configured on a rate card. The feature is taken from the
+ * rate card itself, so it is omitted here.
+ */
+export type RateCardEntitlementInput = RateCardMeteredEntitlementInput | RateCardStaticEntitlement | RateCardBooleanEntitlement;
+/**
+ * A top-level line item on an invoice.
+ *
+ * Each line represents a single charge, typically associated with a rate card from
+ * a subscription. Detailed (child) lines are nested under `detailed_lines` when
+ * present.
+ */
+export type InvoiceLineInput = InvoiceStandardLineInput;
+/**
+ * An invoice issued to a customer.
+ *
+ * The `type` field determines the concrete variant:
+ *
+ * - `standard`: a standard invoice for charges owed.
+ */
+export type InvoiceInput = InvoiceStandardInput;
+/** UpdateInvoiceRequest update request. */
+export type UpdateInvoiceRequestInput = UpdateInvoiceStandardRequestInput;