@openmeter/client 1.0.0-beta-4bc7392a70e6

package/dist/models/types.d.ts

@@ -0,0 +1,3385 @@
+/** Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\_". */
+export type Labels = Record<string, string>;
+/** Determines which page of the collection to retrieve. */
+export interface CursorPaginationQueryPage {
+    /** The number of items to include per page. */
+    size?: number;
+    /** Request the next page of data, starting with the item after this parameter. */
+    after?: string;
+    /** Request the previous page of data, starting with the item before this parameter. */
+    before?: string;
+}
+/** 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 SortQuery {
+    /** The attribute to sort by. */
+    by: string;
+    /** The sort order. `asc` for ascending, `desc` for descending. */
+    order: 'asc' | 'desc';
+}
+/** Event validation errors. */
+export interface IngestedEventValidationError {
+    /** The machine readable code of the error. */
+    code: string;
+    /** The human readable description of the error. */
+    message: string;
+    /** Additional attributes. */
+    attributes?: Record<string, unknown>;
+}
+/** Cursor pagination metadata. */
+export interface CursorMetaPage {
+    /** URI to the first page. */
+    first?: string;
+    /** URI to the last page. */
+    last?: string;
+    /** URI to the next page. */
+    next?: string;
+    /** URI to the previous page. */
+    previous?: string;
+    /** Requested page size. */
+    size?: number;
+}
+/** Standard error response. */
+export interface BaseError {
+    /** Type contains a URI that identifies the problem type. */
+    type: string;
+    /** The HTTP status code generated by the origin server for this occurrence of the problem. */
+    status: number;
+    /** A a short, human-readable summary of the problem type. */
+    title: string;
+    /** A human-readable explanation specific to this occurrence of the problem. */
+    detail: string;
+    /** A URI reference that identifies the specific occurrence of the problem. */
+    instance: string;
+    [key: string]: unknown;
+}
+/** Pagination information. */
+export interface PageMeta {
+    /** Page number. */
+    number: number;
+    /** Page size. */
+    size: number;
+    /** Total number of items in the collection. */
+    total: number;
+}
+/** A query filter for a string attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterString {
+    /** The attribute equals the provided value. */
+    eq?: string;
+    /** The attribute does not equal the provided value. */
+    neq?: string;
+    /** The attribute is one of the provided values. */
+    in?: string[];
+    /** The attribute is not one of the provided values. */
+    nin?: string[];
+    /** The attribute contains the provided value. */
+    contains?: string;
+    /** The attribute does not contain the provided value. */
+    ncontains?: string;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterString[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterString[];
+}
+/** Custom text displayed at various stages of the checkout flow. */
+export interface AppStripeCheckoutSessionCustomTextParams {
+    /** Text displayed after the payment confirmation button. */
+    after_submit?: {
+        message?: string;
+    };
+    /** Text displayed alongside shipping address collection. */
+    shipping_address?: {
+        message?: string;
+    };
+    /** Text displayed alongside the payment confirmation button. */
+    submit?: {
+        message?: string;
+    };
+    /** Text replacing the default terms of service agreement text. */
+    terms_of_service_acceptance?: {
+        message?: string;
+    };
+}
+/** Request to create a Stripe Customer Portal Session. */
+export interface AppStripeCreateCustomerPortalSessionOptions {
+    /** The ID of an existing [Stripe configuration](https://docs.stripe.com/api/customer_portal/configurations) to use for this session, describing its functionality and features. If not specified, the session uses the default configuration. */
+    configuration_id?: string;
+    /** The IETF [language tag](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-locale) of the locale customer portal is displayed in. If blank or `auto`, the customer's preferred_locales or browser's locale is used. */
+    locale?: string;
+    /** The [URL to redirect](https://docs.stripe.com/api/customer_portal/sessions/create#create_portal_session-return_url) the customer to after they have completed their requested actions. */
+    return_url?: string;
+}
+/** Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "\_". */
+export type CreateLabels = Record<string, string>;
+/** Free price. */
+export interface PriceFree {
+    /** The type of the price. */
+    type: 'free';
+}
+/** The tax config for Stripe. */
+export interface TaxConfigStripe {
+    /** Product [tax code](https://docs.stripe.com/tax/tax-codes). */
+    code: string;
+}
+/** External invoicing tax config. */
+export interface TaxConfigExternalInvoicing {
+    /** The tax code should be interpreted by the external invoicing provider. */
+    code: string;
+}
+/** Discounts applicable to flat fee charges. This is the same as `ProductCatalog.Discounts` but without the `usage` field, which is not applicable to flat fee charges. */
+export interface FlatFeeDiscounts {
+    /** Percentage discount applied to the price (0–100). */
+    percentage?: number;
+}
+/** BillingWorkflowCollectionAlignmentSubscription specifies the alignment for collecting the pending line items into an invoice. */
+export interface WorkflowCollectionAlignmentSubscription {
+    /** The type of alignment. */
+    type: 'subscription';
+}
+/** Invoice settings for a billing workflow. */
+export interface WorkflowInvoicingSettings {
+    /** Whether to automatically issue the invoice after the draftPeriod has passed. */
+    auto_advance: boolean;
+    /** The period for the invoice to be kept in draft status for manual reviews. */
+    draft_period: string;
+    /** Should progressive billing be allowed for this workflow? */
+    progressive_billing: boolean;
+}
+/** Payment settings for a billing workflow when the collection method is charge automatically. */
+export interface WorkflowPaymentChargeAutomaticallySettings {
+    /** The collection method for the invoice. */
+    collection_method: 'charge_automatically';
+}
+/** Payment settings for a billing workflow when the collection method is send invoice. */
+export interface WorkflowPaymentSendInvoiceSettings {
+    /** The collection method for the invoice. */
+    collection_method: 'send_invoice';
+    /** The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method. */
+    due_after: string;
+}
+/** LLM Provider */
+export interface LlmCostProvider {
+    /** Identifier of the provider, e.g., "openai", "anthropic". */
+    id: string;
+    /** Name of the provider, e.g., "OpenAI", "Anthropic". */
+    name: string;
+}
+/** LLM Model */
+export interface LlmCostModel {
+    /** Identifier of the model, e.g., "gpt-4", "claude-3-5-sonnet". */
+    id: string;
+    /** Name of the model, e.g., "GPT-4", "Claude 3.5 Sonnet". */
+    name: string;
+}
+/** Validation errors providing detailed description of the issue. */
+export interface ProductCatalogValidationError {
+    /** Machine-readable error code. */
+    code: string;
+    /** Human-readable description of the error. */
+    message: string;
+    /** Additional structured context. */
+    attributes?: Record<string, unknown>;
+    /** The path to the field. */
+    field: string;
+}
+/** List of customer identifiers to evaluate access for. */
+export interface GovernanceQueryRequestCustomers {
+    /** Each entry can be a customer `key` or a usage-attribution subject `key`. Identifiers that cannot be resolved to a customer are reported in the response `errors` array. */
+    keys: string[];
+}
+/** Optional list of feature keys to evaluate access for. If omitted, all features available in the organization are returned. Providing this list is recommended to reduce the response size and the load on the backend services. */
+export interface GovernanceQueryRequestFeatures {
+    /** List of feature keys to evaluate access for. */
+    keys: string[];
+}
+/** A query filter for an integer attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterInteger {
+    /** The attribute equals the provided value. */
+    eq?: number;
+    /** The attribute does not equal the provided value. */
+    neq?: number;
+    /** The attribute is one of the provided values. */
+    in?: number[];
+    /** The attribute is not one of the provided values. */
+    nin?: number[];
+    /** The attribute is greater than the provided value. */
+    gt?: number;
+    /** The attribute is greater than or equal to the provided value. */
+    gte?: number;
+    /** The attribute is less than the provided value. */
+    lt?: number;
+    /** The attribute is less than or equal to the provided value. */
+    lte?: number;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterInteger[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterInteger[];
+}
+/** A query filter for a float attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterFloat {
+    /** The attribute is greater than the provided value. */
+    gt?: number;
+    /** The attribute is greater than or equal to the provided value. */
+    gte?: number;
+    /** The attribute is less than the provided value. */
+    lt?: number;
+    /** The attribute is less than or equal to the provided value. */
+    lte?: number;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterFloat[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterFloat[];
+}
+/** A query filter for a boolean attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterBoolean {
+    /** The attribute equals the provided value. */
+    eq?: boolean;
+}
+/** Page pagination query. */
+export interface PagePaginationQuery {
+    /** Determines which page of the collection to retrieve. */
+    page?: {
+        size?: number;
+        number?: number;
+    };
+}
+/** Public labels store information about an entity that can be used for filtering a list of objects. */
+export type PublicLabels = Record<string, string>;
+/** The system account access token is meant for automations and integrations that are not directly associated with a human identity. */
+export interface SystemAccountAccessToken {
+    /** Http authentication */
+    type: 'http';
+    /** bearer auth scheme */
+    scheme: 'Bearer';
+}
+/** The personal access token is meant to be used as an alternative to basic-auth when accessing Konnect via APIs. */
+export interface PersonalAccessToken {
+    /** Http authentication */
+    type: 'http';
+    /** bearer auth scheme */
+    scheme: 'Bearer';
+}
+/** The Konnect access token is meant to be used by the Konnect dashboard and the decK CLI authenticate with. */
+export interface KonnectAccessToken {
+    /** Http authentication */
+    type: 'http';
+    /** bearer auth scheme */
+    scheme: 'Bearer';
+}
+/** Meter update request. */
+export interface UpdateMeterRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name?: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** Named JSONPath expressions to extract the group by values from the event data. Keys must be unique and consist only alphanumeric and underscore characters. */
+    dimensions?: Record<string, string>;
+}
+/** Stripe customer data. */
+export interface AppCustomerDataStripe {
+    /** The Stripe customer ID used. */
+    customer_id?: string;
+    /** The Stripe default payment method ID. */
+    default_payment_method_id?: string;
+    /** Labels for this Stripe integration on the customer. */
+    labels?: Labels;
+}
+/** External invoicing customer data. */
+export interface AppCustomerDataExternalInvoicing {
+    /** Labels for this external invoicing integration on the customer. */
+    labels?: Labels;
+}
+/** Filter options for listing cost bases. */
+export interface ListCostBasesParamsFilter {
+    /** Filter cost bases by fiat currency code. */
+    fiat_code?: string;
+}
+/** Flat price. */
+export interface PriceFlat {
+    /** The type of the price. */
+    type: 'flat';
+    /** The amount of the flat price. */
+    amount: string;
+}
+/** Unit price. Charges a fixed rate per billing unit. When UnitConfig is present on the rate card, billing units are the converted quantities (e.g. GB instead of bytes). */
+export interface PriceUnit {
+    /** The type of the price. */
+    type: 'unit';
+    /** The amount of the unit price. */
+    amount: string;
+}
+/** Monetary amount in a specific currency. */
+export interface CurrencyAmount {
+    amount: string;
+    currency: string;
+}
+/** Discount configuration for a rate card. */
+export interface RateCardDiscounts {
+    /** Percentage discount applied to the price (0–100). */
+    percentage?: number;
+    /** Number of usage units granted free before billing starts. Only applies to usage-based lines (not flat fees). Usage is treated as zero until this amount is exhausted. */
+    usage?: string;
+}
+/** Totals contains the summaries of all calculations for a billing resource. */
+export interface Totals {
+    /** The total value of the resource before taxes, discounts and commitments. */
+    amount: string;
+    /** The total tax amount applied to the resource. */
+    taxes_total: string;
+    /** The total tax amount already included in the resource amount. */
+    taxes_inclusive_total: string;
+    /** The total tax amount added on top of the resource amount. */
+    taxes_exclusive_total: string;
+    /** The total amount contributed by additional charges. */
+    charges_total: string;
+    /** The total amount deducted through discounts. */
+    discounts_total: string;
+    /** The total amount deducted through credits before taxes are applied. */
+    credits_total: string;
+    /** The final total value of the resource after taxes, discounts and commitments. */
+    total: string;
+}
+/** A fixed per-unit cost amount. */
+export interface FeatureManualUnitCost {
+    /** The type discriminator for manual unit cost. */
+    type: 'manual';
+    /** Fixed per-unit cost amount in USD. */
+    amount: string;
+}
+/** Resolved per-token pricing from the LLM cost database. */
+export interface FeatureLlmUnitCostPricing {
+    /** Cost per input token in USD. */
+    input_per_token: string;
+    /** Cost per output token in USD. */
+    output_per_token: string;
+    /** Cost per cache read token in USD. */
+    cache_read_per_token?: string;
+    /** Cost per reasoning token in USD. */
+    reasoning_per_token?: string;
+    /** Cost per cache write token in USD. */
+    cache_write_per_token?: string;
+}
+/** Token pricing for an LLM model, denominated per token. */
+export interface LlmCostModelPricing {
+    /** Input price per token (USD). */
+    input_per_token: string;
+    /** Output price per token (USD). */
+    output_per_token: string;
+    /** Cache read price per token (USD). */
+    cache_read_per_token?: string;
+    /** Cache write price per token (USD). */
+    cache_write_per_token?: string;
+    /** Reasoning output price per token (USD). */
+    reasoning_per_token?: string;
+}
+/** Spend commitments for a rate card. The customer is committed to spend at least the minimum amount and at most the maximum amount. */
+export interface SpendCommitments {
+    /** The customer is committed to spend at least the amount. */
+    minimum_amount?: string;
+    /** The customer is limited to spend at most the amount. */
+    maximum_amount?: string;
+}
+/** A query filter for a numeric attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterNumeric {
+    /** The attribute is greater than the provided value. */
+    gt?: string;
+    /** The attribute is greater than or equal to the provided value. */
+    gte?: string;
+    /** The attribute is less than the provided value. */
+    lt?: string;
+    /** The attribute is less than or equal to the provided value. */
+    lte?: string;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterNumeric[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterNumeric[];
+}
+/** Cursor page query. */
+export interface CursorPaginationQuery {
+    page?: CursorPaginationQueryPage;
+}
+/** 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;
+    };
+    /** 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;
+    };
+}
+/** 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;
+    };
+    /** Filter by model ID. e.g. ?filter[model_id][eq]=gpt-4 */
+    model_id?: string | {
+        eq?: string;
+        neq?: string;
+        contains?: string;
+        ocontains?: string[];
+        oeq?: string[];
+        gt?: string;
+        gte?: string;
+        lt?: string;
+        lte?: string;
+        exists?: boolean;
+    };
+    /** Filter by model name. e.g. ?filter[model_name][contains]=gpt */
+    model_name?: string | {
+        eq?: string;
+        neq?: string;
+        contains?: string;
+        ocontains?: string[];
+        oeq?: string[];
+        gt?: string;
+        gte?: string;
+        lt?: string;
+        lte?: string;
+        exists?: boolean;
+    };
+    /** 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;
+    };
+    /** 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;
+    };
+}
+/** Filters on the resource's `labels` field. The schema is a map keyed by the label name; each value is a `StringFieldFilter`. Both deepObject forms are accepted: `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;
+}>;
+/** Customer reference. */
+export interface CustomerReference {
+    id: string;
+}
+/** Billing profile reference. */
+export interface ProfileReference {
+    /** The ID of the billing profile. */
+    id: string;
+}
+/** TaxCode reference. */
+export interface CreateResourceReference {
+    id: string;
+}
+/** TaxCode reference. */
+export interface TaxCodeReference {
+    id: string;
+}
+/** Invoice references for the grant. */
+export interface CreditGrantInvoiceReference {
+    /** Identifier of the invoice associated with the grant. */
+    id?: string;
+    /** Identifier of the invoice line associated with the grant. */
+    line?: {
+        id: string;
+    };
+}
+/** Customer reference. */
+export interface BillingCustomerReference {
+    /** The ID of the customer. */
+    id: string;
+}
+/** Subscription reference represents a reference to the specific subscription item this entity represents. */
+export interface SubscriptionReference {
+    /** The ID of the subscription. */
+    id: string;
+    /** The phase of the subscription. */
+    phase: {
+        id: string;
+        item: {
+            id: string;
+        };
+    };
+}
+/** Addon reference. */
+export interface AddonReference {
+    id: string;
+}
+/** App reference. */
+export interface AppReference {
+    /** The ID of the app. */
+    id: string;
+}
+/** Currency describes a currency supported by the billing system. */
+export interface CurrencyFiat {
+    id: string;
+    /** The type of the currency. */
+    type: 'fiat';
+    /** The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro". */
+    name: string;
+    /** Description of the currency. */
+    description?: string;
+    /** The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro. */
+    symbol?: string;
+    code: string;
+}
+/** Feature reference. */
+export interface FeatureReference {
+    id: string;
+}
+/** Metering event following the CloudEvents specification. */
+export interface Event {
+    /** Identifies the event. */
+    id: string;
+    /** Identifies the context in which an event happened. */
+    source: string;
+    /** The version of the CloudEvents specification which the event uses. */
+    specversion: string;
+    /** Contains a value describing the type of event related to the originating occurrence. */
+    type: string;
+    /** Content type of the CloudEvents data value. Only the value "application/json" is allowed over HTTP. */
+    datacontenttype?: 'application/json' | null;
+    /** Identifies the schema that data adheres to. */
+    dataschema?: string | null;
+    /** Describes the subject of the event in the context of the event producer (identified by source). */
+    subject: string;
+    /** Timestamp of when the occurrence happened. Must adhere to RFC 3339. */
+    time?: string | null;
+    /** The event payload. Optional, if present it must be a JSON object. */
+    data?: Record<string, unknown> | null;
+}
+/** A row in the result of a meter query. */
+export interface MeterQueryRow {
+    /** The aggregated value. */
+    value: string;
+    /** The start of the time bucket the value is aggregated over. */
+    from: string;
+    /** The end of the time bucket the value is aggregated over. */
+    to: string;
+    /** The dimensions the value is aggregated over. `subject` and `customer_id` are reserved dimensions. */
+    dimensions: Record<string, string>;
+}
+/** Result of creating a [Stripe Customer Portal Session](https://docs.stripe.com/api/customer_portal/sessions/object). Contains all the information needed to redirect the customer to the Stripe Customer Portal. */
+export interface AppStripeCreateCustomerPortalSessionResult {
+    /** The ID of the customer portal session. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-id */
+    id: string;
+    /** The ID of the stripe customer. */
+    stripe_customer_id: string;
+    /** Configuration used to customize the customer portal. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-configuration */
+    configuration_id: string;
+    /** Livemode. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-livemode */
+    livemode: boolean;
+    /** Created at. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-created */
+    created_at: string;
+    /** Return URL. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-return_url */
+    return_url: string;
+    /** The IETF language tag of the locale customer portal is displayed in. See: https://docs.stripe.com/api/customer_portal/sessions/object#portal_session_object-locale */
+    locale: string;
+    /** The URL to redirect the customer to after they have completed their requested actions. */
+    url: string;
+}
+/** A period with defined start and end dates. The period is always inclusive at the start and exclusive at the end. */
+export interface ClosedPeriod {
+    /** The start of the period. The period is inclusive at the start. */
+    from: string;
+    /** The end of the period. The period is exclusive at the end. */
+    to: string;
+}
+/** Describes currency basis supported by billing system. */
+export interface CostBasis {
+    id: string;
+    /** The fiat currency code for the cost basis. */
+    fiat_code: string;
+    /** The cost rate for the currency. */
+    rate: string;
+    /** An ISO-8601 timestamp representation of the date from which the cost basis is effective. If not provided, it will be effective immediately and will be set to `now` by the system. */
+    effective_from?: string;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+}
+/** CostBasis create request. */
+export interface CreateCostBasisRequest {
+    /** The fiat currency code for the cost basis. */
+    fiat_code: string;
+    /** The cost rate for the currency. */
+    rate: string;
+    /** An ISO-8601 timestamp representation of the date from which the cost basis is effective. If not provided, it will be effective immediately and will be set to `now` by the system. */
+    effective_from?: string;
+}
+/** A row in the result of a feature cost query. */
+export interface FeatureCostQueryRow {
+    /** The metered usage value for the period. */
+    usage: string;
+    /** The computed cost amount (usage × unit cost). Null when pricing is not available for the given combination of dimensions. */
+    cost: string | null;
+    /** The currency code of the cost amount. */
+    currency: string;
+    /** Detail message when cost amount is null, explaining why the cost could not be resolved. */
+    detail?: string;
+    /** The start of the time bucket the value is aggregated over. */
+    from: string;
+    /** The end of the time bucket the value is aggregated over. */
+    to: string;
+    /** The dimensions the value is aggregated over. `subject` and `customer_id` are reserved dimensions. */
+    dimensions: Record<string, string>;
+}
+/** Represents common fields of resources. */
+export interface Resource {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+}
+/** Represents common fields of immutable resources. */
+export interface ResourceImmutable {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+}
+/** A query filter for a time attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterDateTime {
+    /** The attribute is greater than the provided value. */
+    gt?: string;
+    /** The attribute is greater than or equal to the provided value. */
+    gte?: string;
+    /** The attribute is less than the provided value. */
+    lt?: string;
+    /** The attribute is less than or equal to the provided value. */
+    lte?: string;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterDateTime[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterDateTime[];
+}
+/** Cursor pagination metadata. */
+export interface CursorMeta {
+    /** Page metadata. */
+    page: CursorMetaPage;
+}
+/** A parameter that failed a standard validation rule. */
+export interface InvalidParameterStandard {
+    /** The name of the field that failed validation. */
+    field: string;
+    /** The validation rule that was violated. */
+    rule?: 'required' | 'is_array' | 'is_base64' | 'is_boolean' | 'is_date_time' | 'is_integer' | 'is_null' | 'is_number' | 'is_object' | 'is_string' | 'is_uuid' | 'is_fqdn' | 'is_arn' | 'unknown_property' | 'missing_reference' | 'is_label' | 'matches_regex' | 'invalid' | 'is_supported_network_availability_zone_list' | 'is_supported_network_cidr_block' | 'is_supported_provider_region' | 'type';
+    /** The part of the request the field came from (e.g. `body`, `query`). */
+    source?: string;
+    /** A human readable explanation of why the field failed validation. */
+    reason: string;
+}
+/** A parameter that failed a minimum-length (or minimum-value) validation rule. */
+export interface InvalidParameterMinimumLength {
+    /** The name of the field that failed validation. */
+    field: string;
+    /** The minimum validation rule that was violated. */
+    rule: 'min_length' | 'min_digits' | 'min_lowercase' | 'min_uppercase' | 'min_symbols' | 'min_items' | 'min';
+    /** The minimum allowed value or length. */
+    minimum: number;
+    /** The part of the request the field came from (e.g. `body`, `query`). */
+    source?: string;
+    /** A human readable explanation of why the field failed validation. */
+    reason: string;
+}
+/** A parameter that failed a maximum-length (or maximum-value) validation rule. */
+export interface InvalidParameterMaximumLength {
+    /** The name of the field that failed validation. */
+    field: string;
+    /** The maximum validation rule that was violated. */
+    rule: 'max_length' | 'max_items' | 'max';
+    /** The maximum allowed value or length. */
+    maximum: number;
+    /** The part of the request the field came from (e.g. `body`, `query`). */
+    source?: string;
+    /** A human readable explanation of why the field failed validation. */
+    reason: string;
+}
+/** A parameter whose value was not one of the allowed choices. */
+export interface InvalidParameterChoiceItem {
+    /** The name of the field that failed validation. */
+    field: string;
+    /** The enum validation rule that was violated. */
+    rule: 'enum';
+    /** A human readable explanation of why the field failed validation. */
+    reason: string;
+    /** The allowed choices for the field. */
+    choices: unknown[];
+    /** The part of the request the field came from (e.g. `body`, `query`). */
+    source?: string;
+}
+/** A parameter that failed a dependent-fields validation rule. */
+export interface InvalidParameterDependentItem {
+    /** The name of the field that failed validation. */
+    field: string;
+    /** The dependent-fields validation rule that was violated. */
+    rule: 'dependent_fields';
+    /** A human readable explanation of why the field failed validation. */
+    reason: string;
+    /** The fields that this field depends on. */
+    dependents: unknown[];
+    /** The part of the request the field came from (e.g. `body`, `query`). */
+    source?: string;
+}
+/** Unauthorized. */
+export interface Unauthorized extends BaseError {
+}
+/** Forbidden. */
+export interface Forbidden extends BaseError {
+}
+/** Not Found. */
+export interface NotFound extends BaseError {
+}
+/** Gone. */
+export interface Gone extends BaseError {
+}
+/** Conflict. */
+export interface Conflict extends BaseError {
+}
+/** Payload Too Large. */
+export interface PayloadTooLarge extends BaseError {
+}
+/** Unsupported Media Type. */
+export interface UnsupportedMediaType extends BaseError {
+}
+/** Unprocessable Content. */
+export interface UnprocessableContent extends BaseError {
+}
+/** Too Many Requests. */
+export interface TooManyRequests extends BaseError {
+}
+/** Internal Server Error. */
+export interface Internal extends BaseError {
+}
+/** Not Implemented. */
+export interface NotImplemented extends BaseError {
+}
+/** Not Available. */
+export interface NotAvailable extends BaseError {
+}
+/** Filters for the credit grant. */
+export interface CreateCreditGrantFilters {
+    /** Limit the credit grant to specific features. If no features are specified, the credit grant can be used for any feature. */
+    features?: string[];
+}
+/** Filters for the credit grant. */
+export interface CreditGrantFilters {
+    /** Limit the credit grant to specific features. If no features are specified, the credit grant can be used for any feature. */
+    features?: string[];
+}
+/** PlanAddon upsert request. */
+export interface UpsertPlanAddonRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The key of the plan phase from which the add-on becomes available for purchase. */
+    from_plan_phase: string;
+    /** The maximum number of times the add-on can be purchased for the plan. For single-instance add-ons this field must be omitted. For multi-instance add-ons when omitted, unlimited quantity can be purchased. */
+    max_quantity?: number;
+}
+/** Represents common fields of resources with a key. */
+export interface ResourceWithKey {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    key: string;
+}
+/** Meter create request. */
+export interface CreateMeterRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The aggregation type to use for the meter. */
+    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    /** The event type to include in the aggregation. */
+    event_type: string;
+    /** The date since the meter should include events. Useful to skip old events. If not specified, all historical events are included. */
+    events_from?: string;
+    /** JSONPath expression to extract the value from the ingested event's data property. The ingested value for sum, avg, min, and max aggregations is a number or a string that can be parsed to a number. For unique_count aggregation, the ingested value must be a string. For count aggregation the value_property is ignored. */
+    value_property?: string;
+    /** Named JSONPath expressions to extract the group by values from the event data. Keys must be unique and consist only alphanumeric and underscore characters. */
+    dimensions?: Record<string, string>;
+}
+/** A meter is a configuration that defines how to match and aggregate events. */
+export interface Meter {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    key: string;
+    /** The aggregation type to use for the meter. */
+    aggregation: 'sum' | 'count' | 'unique_count' | 'avg' | 'min' | 'max' | 'latest';
+    /** The event type to include in the aggregation. */
+    event_type: string;
+    /** The date since the meter should include events. Useful to skip old events. If not specified, all historical events are included. */
+    events_from?: string;
+    /** JSONPath expression to extract the value from the ingested event's data property. The ingested value for sum, avg, min, and max aggregations is a number or a string that can be parsed to a number. For unique_count aggregation, the ingested value must be a string. For count aggregation the value_property is ignored. */
+    value_property?: string;
+    /** Named JSONPath expressions to extract the group by values from the event data. Keys must be unique and consist only alphanumeric and underscore characters. */
+    dimensions?: Record<string, string>;
+}
+/** Pagination metadata. */
+export interface PaginatedMeta {
+    /** Page metadata. */
+    page: PageMeta;
+}
+/** A query filter for an item in a string map attribute. Operators are mutually exclusive, only one operator is allowed at a time. */
+export interface QueryFilterStringMapItem {
+    /** The attribute exists. */
+    exists?: boolean;
+    /** The attribute equals the provided value. */
+    eq?: string;
+    /** The attribute does not equal the provided value. */
+    neq?: string;
+    /** The attribute is one of the provided values. */
+    in?: string[];
+    /** The attribute is not one of the provided values. */
+    nin?: string[];
+    /** The attribute contains the provided value. */
+    contains?: string;
+    /** The attribute does not contain the provided value. */
+    ncontains?: string;
+    /** Combines the provided filters with a logical AND. */
+    and?: QueryFilterString[];
+    /** Combines the provided filters with a logical OR. */
+    or?: QueryFilterString[];
+}
+/** Subscription create request. */
+export interface SubscriptionCreate {
+    labels?: Labels;
+    /** The customer to create the subscription for. */
+    customer: {
+        id?: string;
+        key?: string;
+    };
+    /** The plan reference of the subscription. */
+    plan: {
+        id?: string;
+        key?: string;
+        version?: number;
+    };
+    /** A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle. It affects when charges occur and how prorations are calculated. Common anchors: - Calendar month (1st of each month): `2025-01-01T00:00:00Z` - Subscription anniversary (day customer signed up) - Custom date (customer-specified day) If not provided, the subscription will be created with the subscription's creation time as the billing anchor. */
+    billing_anchor?: string;
+}
+/** Customer reference by external key. */
+export interface CustomerKeyReference {
+    /** The external key of the customer. */
+    key: string;
+}
+/** Mapping to attribute metered usage to the customer. One customer can have zero or more subjects, but one subject can only belong to one customer. */
+export interface CustomerUsageAttribution {
+    /** The subjects that are attributed to the customer. Can be empty when no usage event subjects are associated with the customer. */
+    subject_keys: string[];
+}
+/** Address */
+export interface BillingAddress {
+    /** Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 format. */
+    country?: string;
+    /** Postal code. */
+    postal_code?: string;
+    /** State or province. */
+    state?: string;
+    /** City. */
+    city?: string;
+    /** First line of the address. */
+    line1?: string;
+    /** Second line of the address. */
+    line2?: string;
+    /** Phone number. */
+    phone_number?: string;
+}
+/** Address */
+export interface Address {
+    /** Country code in [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html) alpha-2 format. */
+    country?: string;
+    /** Postal code. */
+    postal_code?: string;
+    /** State or province. */
+    state?: string;
+    /** City. */
+    city?: string;
+    /** First line of the address. */
+    line1?: string;
+    /** Second line of the address. */
+    line2?: string;
+    /** Phone number. */
+    phone_number?: string;
+}
+/** Controls which customer fields can be updated by the checkout session. */
+export interface AppStripeCreateCheckoutSessionCustomerUpdate {
+    /** Whether to save the billing address to customer.address. Defaults to "never". */
+    address: 'auto' | 'never';
+    /** Whether to save the customer name to customer.name. Defaults to "never". */
+    name: 'auto' | 'never';
+    /** Whether to save shipping information to customer.shipping. Defaults to "never". */
+    shipping: 'auto' | 'never';
+}
+/** Payment method reuse agreement configuration. */
+export interface AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement {
+    /** Position and visibility of the payment method reuse agreement. */
+    position?: 'auto' | 'hidden';
+}
+/** Tax ID collection configuration for checkout sessions. */
+export interface AppStripeCreateCheckoutSessionTaxIdCollection {
+    /** Enable tax ID collection during checkout. Defaults to false. */
+    enabled: boolean;
+    /** Whether tax ID collection is required. Defaults to "never". */
+    required: 'if_supported' | 'never';
+}
+/** Result of creating a Stripe Checkout Session. Contains all the information needed to redirect customers to the checkout or initialize an embedded checkout flow. */
+export interface AppStripeCreateCheckoutSessionResult {
+    /** The customer ID in the billing system. */
+    customer_id: string;
+    /** The Stripe customer ID. */
+    stripe_customer_id: string;
+    /** The Stripe checkout session ID. */
+    session_id: string;
+    /** The setup intent ID created for collecting the payment method. */
+    setup_intent_id: string;
+    /** Client secret for initializing Stripe.js on the client side. Required for embedded checkout sessions. See: https://docs.stripe.com/payments/checkout/custom-success-page */
+    client_secret?: string;
+    /** The client reference ID provided in the request. Useful for reconciling the session with your internal systems. */
+    client_reference_id?: string;
+    /** Customer's email address if provided to Stripe. */
+    customer_email?: string;
+    /** Currency code for the checkout session. */
+    currency?: string;
+    /** Timestamp when the checkout session was created. */
+    created_at: string;
+    /** Timestamp when the checkout session will expire. */
+    expires_at?: string;
+    /** Metadata attached to the checkout session. */
+    metadata?: Record<string, string>;
+    /** The status of the checkout session. See: https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-status */
+    status?: string;
+    /** URL to redirect customers to the checkout page (for hosted mode). */
+    url?: string;
+    /** Mode of the checkout session. Currently only "setup" mode is supported for collecting payment methods. */
+    mode: 'setup';
+    /** The cancel URL where customers are redirected if they cancel. */
+    cancel_url?: string;
+    /** The success URL where customers are redirected after completion. */
+    success_url?: string;
+    /** The return URL for embedded sessions after authentication. */
+    return_url?: string;
+}
+/** Request to create a Stripe Customer Portal Session for the 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. */
+export interface CustomerStripeCreateCustomerPortalSessionRequest {
+    /** Options for configuring the Stripe Customer Portal Session. */
+    stripe_options: AppStripeCreateCustomerPortalSessionOptions;
+}
+/** Entitlement access result. */
+export interface EntitlementAccessResult {
+    /** The type of the entitlement. */
+    type: 'metered' | 'static' | 'boolean';
+    /** The feature key of the entitlement. */
+    feature_key: string;
+    /** Whether the customer has access to the feature. Always true for `boolean` and `static` entitlements. Depends on balance for `metered` entitlements. */
+    has_access: boolean;
+    /** Only available for static entitlements. Config is the JSON parsable configuration of the entitlement. Useful to describe per customer configuration. */
+    config?: string;
+}
+/** Purchase and payment terms of the grant. */
+export interface CreateCreditGrantPurchase {
+    /** Currency of the purchase amount. */
+    currency: string;
+    /** Cost basis per credit unit used to calculate the purchase amount. If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge is $50.00. The value must be greater than 0. If the cost basis is 0, use `funding_method=none` instead. Defaults to 1.0. */
+    per_unit_cost_basis: string;
+    /** Controls when credits become available for consumption. Defaults to `on_creation`. */
+    availability_policy: 'on_creation';
+}
+/** Recurring period with an anchor and an interval. */
+export interface RecurringPeriod {
+    /** A date-time anchor to base the recurring period on. */
+    anchor: string;
+    /** The interval duration in ISO 8601 format. */
+    interval: string;
+}
+/** Purchase and payment terms of the grant. */
+export interface CreditGrantPurchase {
+    /** Currency of the purchase amount. */
+    currency: string;
+    /** Cost basis per credit unit used to calculate the purchase amount. If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge is $50.00. The value must be greater than 0. If the cost basis is 0, use `funding_method=none` instead. Defaults to 1.0. */
+    per_unit_cost_basis: string;
+    /** The purchase amount. Calculated from `per_unit_cost_basis` and credit `amount`. */
+    amount: string;
+    /** Controls when credits become available for consumption. Defaults to `on_creation`. */
+    availability_policy: 'on_creation';
+    /** Current payment settlement status. */
+    settlement_status?: 'pending' | 'authorized' | 'settled';
+}
+/** Request body for updating the external payment settlement status of a credit grant. */
+export interface UpdateCreditGrantExternalSettlementRequest {
+    /** The new payment settlement status. */
+    status: 'pending' | 'authorized' | 'settled';
+}
+/** Filter options for listing credit grants. */
+export interface ListCreditGrantsParamsFilter {
+    /** Filter credit grants by status. */
+    status?: 'pending' | 'active' | 'expired' | 'voided';
+    /** Filter credit grants by currency. */
+    currency?: string;
+}
+/** Filter options for getting a credit balance. */
+export interface GetCreditBalanceParamsFilter {
+    /** Filter credit balance by currency. */
+    currency?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+}
+/** Filter options for listing charges. */
+export interface ListChargesParamsFilter {
+    /** Filter charges by status. Supported statuses are: - `created` - `active` - `final` - `deleted` If omitted, all statuses are returned except for `deleted`. */
+    status?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+}
+/** 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;
+    };
+}
+/** The proration configuration of the rate card. */
+export interface RateCardProrationConfiguration {
+    /** The proration mode of the rate card. */
+    mode: 'no_proration' | 'prorate_prices';
+}
+/** Subscription. */
+export interface Subscription {
+    id: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The customer ID of the subscription. */
+    customer_id: string;
+    /** The plan ID of the subscription. Set if subscription is created from a plan. */
+    plan_id?: string;
+    /** A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle. It affects when charges occur and how prorations are calculated. Common anchors: - Calendar month (1st of each month): `2025-01-01T00:00:00Z` - Subscription anniversary (day customer signed up) - Custom date (customer-specified day) */
+    billing_anchor: string;
+    /** The status of the subscription. */
+    status: 'active' | 'inactive' | 'canceled' | 'scheduled';
+}
+/** Available apps for billing integrations to connect with third-party services. Apps can have various capabilities like syncing data from or to external systems, integrating with third-party services for tax calculation, delivery of invoices, collection of payments, etc. */
+export interface AppCatalogItem {
+    /** Type of the app. */
+    type: 'sandbox' | 'stripe' | 'external_invoicing';
+    /** Name of the app. */
+    name: string;
+    /** Description of the app. */
+    description: string;
+}
+/** Mapping of app types to tax codes. */
+export interface TaxCodeAppMapping {
+    /** The app type that the tax code is associated with. */
+    app_type: 'sandbox' | 'stripe' | 'external_invoicing';
+    /** Tax code. */
+    tax_code: string;
+}
+/** Identity stores the details required to identify an entity for tax purposes in a specific country. */
+export interface PartyTaxIdentity {
+    /** Normalized tax identification code shown on the original identity document. */
+    code?: string;
+}
+/** 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;
+    };
+}
+/** Describes custom currency. */
+export interface CurrencyCustom {
+    id: string;
+    /** The type of the currency. */
+    type: 'custom';
+    /** The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro". */
+    name: string;
+    /** Description of the currency. */
+    description?: string;
+    /** The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro. */
+    symbol?: string;
+    code: string;
+    /** An ISO-8601 timestamp representation of the custom currency creation date. */
+    created_at: string;
+}
+/** CurrencyCustom create request. */
+export interface CreateCurrencyCustomRequest {
+    /** The name of the currency. It should be a human-readable string that represents the name of the currency, such as "US Dollar" or "Euro". */
+    name: string;
+    /** Description of the currency. */
+    description?: string;
+    /** The symbol of the currency. It should be a string that represents the symbol of the currency, such as "$" for US Dollar or "€" for Euro. */
+    symbol?: string;
+    code: string;
+}
+/** Query to evaluate feature access for a list of customers. */
+export interface GovernanceQueryRequest {
+    /** Whether to include credit balance availability for each resolved customer. When true, each feature evaluation includes credit balance checks. Defaults to `false`. */
+    include_credits: boolean;
+    customer: GovernanceQueryRequestCustomers;
+    feature?: GovernanceQueryRequestFeatures;
+}
+/** Reason a feature is not accessible to a customer. */
+export interface GovernanceFeatureAccessReason {
+    /** Machine-readable error code. */
+    code: 'unknown' | 'usage_limit_reached' | 'feature_unavailable' | 'feature_not_found' | 'no_credit_available';
+    /** Human-readable description of the error. */
+    message: string;
+    /** Additional structured context. */
+    attributes?: Record<string, unknown>;
+}
+/** Query error within a partially successful governance query response. */
+export interface GovernanceQueryError {
+    /** Machine-readable error code. */
+    code: 'unknown' | 'customer_not_found';
+    /** Human-readable description of the error. */
+    message: string;
+    /** Additional structured context. */
+    attributes?: Record<string, unknown>;
+    /** The customer identifier from the request that produced this error. */
+    customer?: string;
+}
+/** 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 UnitConfig {
+    /** The arithmetic operation to apply to the raw metered quantity. */
+    operation: 'divide' | 'multiply';
+    /** The factor used in the conversion operation. - For `divide`: `converted = raw / conversionFactor`. - For `multiply`: `converted = raw × conversionFactor`. Must be a positive non-zero value. */
+    conversion_factor: string;
+    /** The rounding mode applied to the converted quantity for invoicing. Defaults to none (no rounding). Entitlement checks always use the precise (unrounded) value. */
+    rounding: 'ceiling' | 'floor' | 'half_up' | 'none';
+    /** The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers). */
+    precision: number;
+    /** A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered. */
+    display_unit?: string;
+}
+/** App customer data. */
+export interface AppCustomerData {
+    /** Used if the customer has a linked Stripe app. */
+    stripe?: AppCustomerDataStripe;
+    /** Used if the customer has a linked external invoicing app. */
+    external_invoicing?: AppCustomerDataExternalInvoicing;
+}
+/** AppCustomerData upsert request. */
+export interface UpsertAppCustomerDataRequest {
+    /** Used if the customer has a linked Stripe app. */
+    stripe?: AppCustomerDataStripe;
+    /** Used if the customer has a linked external invoicing app. */
+    external_invoicing?: AppCustomerDataExternalInvoicing;
+}
+/** A credit adjustment can be used to make manual adjustments to a customer's credit balance. Supported use-cases: - Usage correction */
+export interface CreditAdjustment {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+}
+/** The credit balance by currency. */
+export interface CreditBalance {
+    currency: string;
+    /** Credits that have been granted but cannot yet be consumed. Includes grants awaiting payment clearance or with a future effective date. */
+    pending: string;
+    /** Credits that can be consumed right now. Derived from cleared grants after applying eligibility and restriction rules. */
+    available: string;
+}
+/** CreditAdjustment create request. */
+export interface CreateCreditAdjustmentRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+}
+/** Filter options for listing credit transactions. */
+export interface ListCreditTransactionsParamsFilter {
+    /** Filter credit transactions by type. */
+    type?: 'funded' | 'consumed' | 'expired';
+    /** Filter credit transactions by currency. */
+    currency?: string;
+}
+/** A credit transaction represents a single credit movement on the customer's balance. Credit transactions are immutable. */
+export interface CreditTransaction {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** The date and time the transaction was booked. */
+    booked_at: string;
+    /** The type of credit transaction. */
+    type: 'funded' | 'consumed' | 'expired';
+    /** Currency of the balance affected by the transaction. */
+    currency: string;
+    /** Signed amount of the credit movement. Positive values add balance, negative values reduce balance. */
+    amount: string;
+    /** The available balance before and after the transaction. */
+    available_balance: {
+        before: string;
+        after: string;
+    };
+}
+/** A price tier used in graduated and volume pricing. At least one price component (flat_price or unit_price) must be set. When UnitConfig is present on the rate card, up_to_amount is expressed in converted billing units. */
+export interface PriceTier {
+    /** Up to and including this quantity will be contained in the tier. If undefined, the tier is open-ended (the last tier). */
+    up_to_amount?: string;
+    /** The flat price component of the tier. Charged once when the tier is entered. */
+    flat_price?: PriceFlat;
+    /** The unit price component of the tier. Charged per billing unit within the tier. */
+    unit_price?: PriceUnit;
+}
+/** The totals of a change. RealTime is only expanded when the `real_time_usage` expand is used. */
+export interface ChargeTotals {
+    /** The amount of the charge already booked to the internal accounting system. */
+    booked: Totals;
+    /** The realtime amount of the charge. Requires the `realtime_usage` expand. */
+    realtime?: Totals;
+}
+/** LLM cost lookup configuration. Each dimension (provider, model, token type) can be specified as either a static value or a meter group-by property name (mutually exclusive). */
+export interface FeatureLlmUnitCost {
+    /** The type discriminator for LLM unit cost. */
+    type: 'llm';
+    /** Meter group-by property that holds the LLM provider. Use this when the meter has a group-by dimension for provider. Mutually exclusive with `provider`. */
+    provider_property?: string;
+    /** Static LLM provider value (e.g., "openai", "anthropic"). Use this when the feature tracks a single provider. Mutually exclusive with `provider_property`. */
+    provider?: string;
+    /** Meter group-by property that holds the model ID. Use this when the meter has a group-by dimension for model. Mutually exclusive with `model`. */
+    model_property?: string;
+    /** Static model ID value (e.g., "gpt-4", "claude-3-5-sonnet"). Use this when the feature tracks a single model. Mutually exclusive with `model_property`. */
+    model?: string;
+    /** Meter group-by property that holds the token type. Use this when the meter has a group-by dimension for token type. Mutually exclusive with `token_type`. */
+    token_type_property?: string;
+    /** Static token type value. Use this when the feature tracks a single token type (e.g., only input tokens). `request` is an alias for `input`, `response` is an alias for `output`. Mutually exclusive with `token_type_property`. */
+    token_type?: 'input' | 'output' | 'cache_read' | 'cache_write' | 'reasoning' | 'request' | 'response';
+    /** Resolved per-token pricing from the LLM cost database. Populated in responses when the provider and model can be determined, either from static values or from meter group-by filters with exact matches. */
+    pricing?: FeatureLlmUnitCostPricing;
+}
+/** An LLM cost price record, representing the cost per token for a specific model from a specific provider. */
+export interface LlmCostPrice {
+    /** Unique identifier. */
+    id: string;
+    /** Provider of the model. */
+    provider: LlmCostProvider;
+    /** The model. */
+    model: LlmCostModel;
+    /** Token pricing data. */
+    pricing: LlmCostModelPricing;
+    /** Currency code (currently always "USD"). */
+    currency: string;
+    /** Where this price came from. */
+    source: 'manual' | 'system';
+    /** When this price becomes effective. */
+    effective_from: string;
+    /** When this price expires. Omitted when the price is currently effective. */
+    effective_to?: string;
+    /** Creation timestamp. */
+    created_at: string;
+    /** Last update timestamp. */
+    updated_at: string;
+}
+/** Input for creating a per-namespace price override. Unique per provider, model and currency. If an override already exists for the given provider, model and currency, it will be updated. If an override does not exist, it will be created. */
+export interface LlmCostOverrideCreate {
+    /** Provider/vendor of the model. */
+    provider: string;
+    /** Canonical model identifier. */
+    model_id: string;
+    /** Human-readable model name. */
+    model_name?: string;
+    /** Token pricing data. */
+    pricing: LlmCostModelPricing;
+    /** Currency code. */
+    currency: string;
+    /** When this override becomes effective. */
+    effective_from: string;
+    /** When this override expires. */
+    effective_to?: string;
+}
+/** 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;
+    };
+    primary_email?: string | {
+        eq?: string;
+        neq?: string;
+        contains?: string;
+        ocontains?: string[];
+        oeq?: string[];
+        gt?: string;
+        gte?: string;
+        lt?: string;
+        lte?: string;
+        exists?: boolean;
+    };
+    usage_attribution_subject_key?: string | {
+        eq?: string;
+        neq?: string;
+        contains?: string;
+        ocontains?: string[];
+        oeq?: string[];
+        gt?: string;
+        gte?: string;
+        lt?: string;
+        lte?: string;
+        exists?: boolean;
+    };
+    plan_key?: string | {
+        eq?: string;
+        neq?: string;
+        contains?: string;
+        ocontains?: string[];
+        oeq?: string[];
+        gt?: string;
+        gte?: string;
+        lt?: string;
+        lte?: string;
+        exists?: boolean;
+    };
+    billing_profile_id?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+}
+/** Filter options for listing subscriptions. */
+export interface ListSubscriptionsParamsFilter {
+    id?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    customer_id?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    status?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    plan_id?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    plan_key?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+}
+/** Filter options for listing features. */
+export interface ListFeatureParamsFilter {
+    meter_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;
+    };
+}
+/** 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;
+    };
+}
+/** Tax configuration for a credit grant. Tax configuration should be provided to ensure correct revenue recognition, including for externally funded grants. */
+export interface CreateCreditGrantTaxConfig {
+    /** Tax behavior applied to the invoice line item. */
+    behavior?: 'inclusive' | 'exclusive';
+    /** Tax code applied to the invoice line item. */
+    tax_code?: CreateResourceReference;
+}
+/** Tax configuration for a credit grant. Tax configuration should be provided to ensure correct revenue recognition, including for externally funded grants. */
+export interface CreditGrantTaxConfig {
+    /** Tax behavior applied to the invoice line item. */
+    behavior?: 'inclusive' | 'exclusive';
+    /** Tax code applied to the invoice line item. */
+    tax_code?: TaxCodeReference;
+}
+/** Set of provider specific tax configs. */
+export interface TaxConfig {
+    /** Tax behavior. If not specified the billing profile is used to determine the tax behavior. If not specified in the billing profile, the provider's default behavior is used. */
+    behavior?: 'inclusive' | 'exclusive';
+    /** Stripe tax config. */
+    stripe?: TaxConfigStripe;
+    /** External invoicing tax config. */
+    external_invoicing?: TaxConfigExternalInvoicing;
+    /** Tax code ID. */
+    tax_code_id?: string;
+    /** Tax code reference. When both `tax_code` and `tax_code_id` are provided, `tax_code` takes precedence. When `stripe.code` is also provided, `tax_code` still wins and `stripe.code` is ignored. */
+    tax_code?: TaxCodeReference;
+}
+/** The tax config of the rate card. */
+export interface RateCardTaxConfig {
+    behavior?: 'inclusive' | 'exclusive';
+    code: TaxCodeReference;
+}
+/** Organization-level default tax code references. Stores the default tax codes applied to specific billing contexts for this organization. Provisioned automatically when the organization is created. */
+export interface OrganizationDefaultTaxCodes {
+    /** Default tax code for invoicing. */
+    invoicing_tax_code: TaxCodeReference;
+    /** Default tax code for credit grants. */
+    credit_grant_tax_code: TaxCodeReference;
+    /** Timestamp of creation. */
+    created_at: string;
+    /** Timestamp of last update. */
+    updated_at: string;
+}
+/** OrganizationDefaultTaxCodes update request. */
+export interface UpdateOrganizationDefaultTaxCodesRequest {
+    /** Default tax code for invoicing. */
+    invoicing_tax_code?: TaxCodeReference;
+    /** Default tax code for credit grants. */
+    credit_grant_tax_code?: TaxCodeReference;
+}
+/** Addon purchased with a subscription. */
+export interface SubscriptionAddon {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The add-on associated with the subscription. */
+    addon: AddonReference;
+    /** The quantity of the add-on. Always 1 for single instance add-ons. */
+    quantity: number;
+    /** An ISO-8601 timestamp representation of which point in time the quantity was resolved to. */
+    quantity_at: string;
+    /** An ISO-8601 timestamp representation of the cadence start of the resource. */
+    active_from: string;
+    /** An ISO-8601 timestamp representation of the cadence end of the resource. */
+    active_to?: string;
+}
+/** PlanAddon represents an association between a plan and an add-on, controlling which add-ons are available for purchase within a plan. */
+export interface PlanAddon {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The add-on associated with the plan. */
+    addon: AddonReference;
+    /** The key of the plan phase from which the add-on becomes available for purchase. */
+    from_plan_phase: string;
+    /** The maximum number of times the add-on can be purchased for the plan. For single-instance add-ons this field must be omitted. For multi-instance add-ons when omitted, unlimited quantity can be purchased. */
+    max_quantity?: number;
+    /** List of validation errors. */
+    validation_errors?: ProductCatalogValidationError[];
+}
+/** PlanAddon create request. */
+export interface CreatePlanAddonRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The add-on associated with the plan. */
+    addon: AddonReference;
+    /** The key of the plan phase from which the add-on becomes available for purchase. */
+    from_plan_phase: string;
+    /** The maximum number of times the add-on can be purchased for the plan. For single-instance add-ons this field must be omitted. For multi-instance add-ons when omitted, unlimited quantity can be purchased. */
+    max_quantity?: number;
+}
+/** References to the applications used by a billing profile. */
+export interface ProfileAppReferences {
+    /** The tax app used for this workflow. */
+    tax: AppReference;
+    /** The invoicing app used for this workflow. */
+    invoicing: AppReference;
+    /** The payment app used for this workflow. */
+    payment: AppReference;
+}
+/** 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;
+    };
+    /** 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;
+    };
+    /** 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;
+    };
+    /** 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;
+    };
+    /** Filter events by the associated customer ID. */
+    customer_id?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    /** Filter events by event time. */
+    time?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+    /** Filter events by the time the event was ingested. */
+    ingested_at?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+    /** Filter events by the time the event was stored. */
+    stored_at?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+}
+/** 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;
+    };
+    labels?: LabelsFieldFilter;
+    public_labels?: LabelsFieldFilter;
+    created_at?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+    updated_at?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+    deleted_at?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+}
+/** Field filters with all supported types. */
+export interface FieldFilters {
+    boolean?: boolean | {
+        eq: boolean;
+    };
+    numeric?: number | {
+        eq?: number;
+        neq?: number;
+        oeq?: number[];
+        lt?: number;
+        lte?: number;
+        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;
+    };
+    string_exact?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    ulid?: string | {
+        eq?: string;
+        oeq?: string[];
+        neq?: string;
+    };
+    datetime?: string | {
+        eq?: string;
+        lt?: string;
+        lte?: string;
+        gt?: string;
+        gte?: string;
+    };
+    labels?: LabelsFieldFilter;
+}
+/** An ingested metering event with ingestion metadata. */
+export interface IngestedEvent {
+    /** The original event ingested. */
+    event: Event;
+    /** The customer if the event is associated with a customer. */
+    customer?: CustomerReference;
+    /** The date and time the event was ingested and its processing started. */
+    ingested_at: string;
+    /** The date and time the event was stored in the database. */
+    stored_at: string;
+    /** The validation errors of the ingested event. */
+    validation_errors?: IngestedEventValidationError[];
+}
+/** Meter query result. */
+export interface MeterQueryResult {
+    /** The start of the period the usage is queried from. */
+    from?: string;
+    /** The end of the period the usage is queried to. */
+    to?: string;
+    /** The usage data. If no data is available, an empty array is returned. */
+    data: MeterQueryRow[];
+}
+/** Result of a feature cost query. */
+export interface FeatureCostQueryResult {
+    /** Start of the queried period. */
+    from?: string;
+    /** End of the queried period. */
+    to?: string;
+    /** The cost data rows. */
+    data: FeatureCostQueryRow[];
+}
+/** Page paginated response. */
+export interface MeterPagePaginatedResponse {
+    data: Meter[];
+    meta: PaginatedMeta;
+}
+/** Page paginated response. */
+export interface CostBasisPagePaginatedResponse {
+    data: CostBasis[];
+    meta: PaginatedMeta;
+}
+/** Filters to apply to a meter query. */
+export interface MeterQueryFilters {
+    /** Filters to apply to the dimensions of the query. For `subject` and `customer_id` only equals ("eq", "in") comparisons are supported. */
+    dimensions?: Record<string, QueryFilterStringMapItem>;
+}
+/** Reference to a meter associated with a feature. */
+export interface FeatureMeterReference {
+    /** The ID of the meter to associate with this feature. */
+    id: string;
+    /** Filters to apply to the dimensions of the meter. */
+    filters?: Record<string, QueryFilterStringMapItem>;
+}
+/** Customer create request. */
+export interface CreateCustomerRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** Mapping to attribute metered usage to the customer by the event subject. */
+    usage_attribution?: CustomerUsageAttribution;
+    /** The primary email address of the customer. */
+    primary_email?: string;
+    /** Currency of the customer. Used for billing, tax and invoicing. */
+    currency?: string;
+    /** The billing address of the customer. Used for tax and invoicing. */
+    billing_address?: BillingAddress;
+}
+/** Customers can be individuals or organizations that can subscribe to plans and have access to features. */
+export interface Customer {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    key: string;
+    /** Mapping to attribute metered usage to the customer by the event subject. */
+    usage_attribution?: CustomerUsageAttribution;
+    /** The primary email address of the customer. */
+    primary_email?: string;
+    /** Currency of the customer. Used for billing, tax and invoicing. */
+    currency?: string;
+    /** The billing address of the customer. Used for tax and invoicing. */
+    billing_address?: BillingAddress;
+}
+/** Customer upsert request. */
+export interface UpsertCustomerRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** Mapping to attribute metered usage to the customer by the event subject. */
+    usage_attribution?: CustomerUsageAttribution;
+    /** The primary email address of the customer. */
+    primary_email?: string;
+    /** Currency of the customer. Used for billing, tax and invoicing. */
+    currency?: string;
+    /** The billing address of the customer. Used for tax and invoicing. */
+    billing_address?: BillingAddress;
+}
+/** A collection of addresses for the party. */
+export interface PartyAddresses {
+    /** Billing address. */
+    billing_address: Address;
+}
+/** Checkout Session consent collection configuration. */
+export interface AppStripeCreateCheckoutSessionConsentCollection {
+    /** Controls the visibility of payment method reuse agreement. */
+    payment_method_reuse_agreement?: AppStripeCreateCheckoutSessionConsentCollectionPaymentMethodReuseAgreement;
+    /** Enables collection of promotional communication consent. Only available to US merchants. When set to "auto", Checkout determines whether to show the option based on the customer's locale. */
+    promotions?: 'auto' | 'none';
+    /** Requires customers to accept terms of service before payment. Requires a valid terms of service URL in your Stripe Dashboard settings. */
+    terms_of_service?: 'none' | 'required';
+}
+/** List customer entitlement access response data. */
+export interface ListCustomerEntitlementAccessResponseData {
+    /** The list of entitlement access results. */
+    data: EntitlementAccessResult[];
+}
+/** BillingWorkflowCollectionAlignmentAnchored specifies the alignment for collecting the pending line items into an invoice. */
+export interface WorkflowCollectionAlignmentAnchored {
+    /** The type of alignment. */
+    type: 'anchored';
+    /** The recurring period for the alignment. */
+    recurring_period: RecurringPeriod;
+}
+/** Page paginated response. */
+export interface SubscriptionPagePaginatedResponse {
+    data: Subscription[];
+    meta: PaginatedMeta;
+}
+/** Response for changing a subscription. */
+export interface SubscriptionChangeResponse {
+    /** The current subscription before the change. */
+    current: Subscription;
+    /** The new state of the subscription after the change. */
+    next: Subscription;
+}
+/** Request for canceling a subscription. */
+export interface SubscriptionCancel {
+    /** If not provided the subscription is canceled immediately. */
+    timing: 'immediate' | 'next_billing_cycle' | string;
+}
+/** Request for changing a subscription. */
+export interface SubscriptionChange {
+    labels?: Labels;
+    /** The customer to create the subscription for. */
+    customer: {
+        id?: string;
+        key?: string;
+    };
+    /** The plan reference of the subscription. */
+    plan: {
+        id?: string;
+        key?: string;
+        version?: number;
+    };
+    /** A billing anchor is the fixed point in time that determines the subscription's recurring billing cycle. It affects when charges occur and how prorations are calculated. Common anchors: - Calendar month (1st of each month): `2025-01-01T00:00:00Z` - Subscription anniversary (day customer signed up) - Custom date (customer-specified day) If not provided, the subscription will be created with the subscription's creation time as the billing anchor. */
+    billing_anchor?: string;
+    /** Timing configuration for the change, when the change should take effect. For changing a subscription, the accepted values depend on the subscription configuration. */
+    timing: 'immediate' | 'next_billing_cycle' | string;
+}
+/** Stripe app. */
+export interface AppStripe {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The app type. */
+    type: 'stripe';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+    /** The Stripe account ID associated with the connected Stripe account. */
+    account_id: string;
+    /** Indicates whether the app is connected to a live Stripe account. */
+    livemode: boolean;
+    /** The masked Stripe API key that only exposes the first and last few characters. */
+    masked_api_key: string;
+    /** The Stripe secret API key used to authenticate API requests. */
+    secret_api_key?: string;
+}
+/** Sandbox app can be used for testing billing features. */
+export interface AppSandbox {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The app type. */
+    type: 'sandbox';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+}
+/** External Invoicing app enables integration with third-party invoicing or payment system. The app supports a bi-directional synchronization pattern where OpenMeter Billing manages the invoice lifecycle while the external system handles invoice presentation and payment collection. Integration workflow: 1. The billing system creates invoices and transitions them through lifecycle states (draft → issuing → issued) 2. The integration receives webhook notifications about invoice state changes 3. The integration calls back to provide external system IDs and metadata 4. The integration reports payment events back via the payment status API State synchronization is controlled by hooks that pause invoice progression until the external system confirms synchronization via API callbacks. */
+export interface AppExternalInvoicing {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The app type. */
+    type: 'external_invoicing';
+    /** The app catalog definition that this installed app is based on. */
+    definition: AppCatalogItem;
+    /** Status of the app connection. */
+    status: 'ready' | 'unauthorized';
+    /** Enable draft synchronization hook. When enabled, invoices will pause at the draft state and wait for the integration to call the draft synchronized endpoint before progressing to the issuing state. This allows the external system to validate and prepare the invoice data. When disabled, invoices automatically progress through the draft state based on the configured workflow timing. */
+    enable_draft_sync_hook: boolean;
+    /** Enable issuing synchronization hook. When enabled, invoices will pause at the issuing state and wait for the integration to call the issuing synchronized endpoint before progressing to the issued state. This ensures the external invoicing system has successfully created and finalized the invoice before it is marked as issued. When disabled, invoices automatically progress through the issuing state and are immediately marked as issued. */
+    enable_issuing_sync_hook: boolean;
+}
+/** TaxCode create request. */
+export interface CreateTaxCodeRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** Mapping of app types to tax codes. */
+    app_mappings: TaxCodeAppMapping[];
+}
+/** Tax codes by provider. */
+export interface TaxCode {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    key: string;
+    /** Mapping of app types to tax codes. */
+    app_mappings: TaxCodeAppMapping[];
+}
+/** TaxCode upsert request. */
+export interface UpsertTaxCodeRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** Mapping of app types to tax codes. */
+    app_mappings: TaxCodeAppMapping[];
+}
+/** Access status for a single feature. */
+export interface GovernanceFeatureAccess {
+    /** Whether the customer currently has access to the feature. `true` for boolean and static entitlements that are available, and for metered entitlements with remaining balance. `false` when the feature is unavailable, the usage limit has been reached, or (when applicable) credits have been exhausted. */
+    has_access: boolean;
+    /** Optional reason when the customer does not have access to the feature. Populated when `has_access` is `false`. */
+    reason?: GovernanceFeatureAccessReason;
+}
+/** 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 InvoiceUsageQuantityDetail {
+    /** The raw quantity as reported by the meter (native units). */
+    raw_quantity: string;
+    /** The precise decimal value after applying the conversion operation and factor, before rounding. */
+    converted_quantity: string;
+    /** The quantity after rounding, used for pricing. */
+    invoiced_quantity: string;
+    /** The display unit label (e.g., "GB", "hours", "M tokens"). */
+    display_unit?: string;
+    /** Snapshot of the UnitConfig that was in effect at billing time. Ensures historical invoices reflect the config that was actually applied. */
+    applied_unit_config: UnitConfig;
+}
+/** Billing customer data. */
+export interface CustomerData {
+    /** The billing profile for the customer. If not provided, the default billing profile will be used. */
+    billing_profile?: ProfileReference;
+    /** App customer data. */
+    app_data?: AppCustomerData;
+}
+/** CustomerBillingData upsert request. */
+export interface UpsertCustomerBillingDataRequest {
+    /** The billing profile for the customer. If not provided, the default billing profile will be used. */
+    billing_profile?: ProfileReference;
+    /** App customer data. */
+    app_data?: AppCustomerData;
+}
+/** The balances of the credits of a customer. */
+export interface CreditBalances {
+    /** The timestamp of the balance retrieval. */
+    retrieved_at: string;
+    /** The balances by currencies. */
+    balances: CreditBalance[];
+}
+/** Cursor paginated response. */
+export interface CreditTransactionPaginatedResponse {
+    data: CreditTransaction[];
+    meta: CursorMeta;
+}
+/** Graduated tiered price. Each tier's rate applies only to the usage within that tier. Pricing can change as cumulative usage crosses tier boundaries. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units. */
+export interface PriceGraduated {
+    /** The type of the price. */
+    type: 'graduated';
+    /** The tiers of the graduated price. At least one tier is required. */
+    tiers: PriceTier[];
+}
+/** Volume tiered price. The maximum quantity within a period determines the per-unit price for all units in that period. When UnitConfig is present on the rate card, tier boundaries (up_to_amount) are expressed in converted billing units. */
+export interface PriceVolume {
+    /** The type of the price. */
+    type: 'volume';
+    /** The tiers of the volume price. At least one tier is required. */
+    tiers: PriceTier[];
+}
+/** Page paginated response. */
+export interface PricePagePaginatedResponse {
+    data: LlmCostPrice[];
+    meta: PaginatedMeta;
+}
+/** CreditGrant create request. */
+export interface CreateCreditGrantRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: CreateLabels;
+    /** Funding method of the grant. */
+    funding_method: 'none' | 'invoice' | 'external';
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+    /** Present when a funding workflow applies (funding_method is not `none`). */
+    purchase?: CreateCreditGrantPurchase;
+    /** Tax configuration for the grant. For `invoice` and `external` funding methods, tax configuration should be provided to ensure correct revenue recognition. When not provided, the default credit grant tax code is applied, if that's not set the global default taxcode is used. */
+    tax_config?: CreateCreditGrantTaxConfig;
+    filters?: CreateCreditGrantFilters;
+    /** Draw-down priority of the grant. Lower values have higher priority. */
+    priority: number;
+    /** The duration after which the credit grant expires. Defaults to never expiring. */
+    expires_after?: 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 CreditGrant {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** Funding method of the grant. */
+    funding_method: 'none' | 'invoice' | 'external';
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+    /** Present when a funding workflow applies (funding_method is not `none`). */
+    purchase?: CreditGrantPurchase;
+    /** Tax configuration for the grant. For `invoice` and `external` funding methods, tax configuration should be provided to ensure correct revenue recognition. When not provided, the default credit grant tax code is applied, if that's not set the global default taxcode is used. */
+    tax_config?: CreditGrantTaxConfig;
+    /** Available when `funding_method` is `invoice`. */
+    invoice?: CreditGrantInvoiceReference;
+    filters?: CreditGrantFilters;
+    /** Draw-down priority of the grant. Lower values have higher priority. */
+    priority: number;
+    /** The duration after which the credit grant expires. Defaults to never expiring. */
+    expires_after?: string;
+    /** The timestamp when the credit grant expires. Calculated from the grant effective time and `expires_after` if provided. */
+    expires_at?: string;
+    /** Timestamp when the grant was voided. */
+    voided_at?: string;
+    /** Current lifecycle status of the grant. */
+    status: 'pending' | 'active' | 'expired' | 'voided';
+}
+/** Tax settings for a billing workflow. */
+export interface WorkflowTaxSettings {
+    /** Enable automatic tax calculation when tax is supported by the app. For example, with Stripe Invoicing when enabled, tax is calculated via Stripe Tax. */
+    enabled: boolean;
+    /** Enforce tax calculation when tax is supported by the app. When enabled, the billing system will not allow to create an invoice without tax calculation. Enforcement is different per apps, for example, Stripe app requires customer to have a tax location when starting a paid subscription. */
+    enforced: boolean;
+    /** Default tax configuration to apply to the invoices for line items. */
+    default_tax_config?: TaxConfig;
+}
+/** Page paginated response. */
+export interface SubscriptionAddonPagePaginatedResponse {
+    data: SubscriptionAddon[];
+    meta: PaginatedMeta;
+}
+/** Page paginated response. */
+export interface PlanAddonPagePaginatedResponse {
+    data: PlanAddon[];
+    meta: PaginatedMeta;
+}
+/** Cursor paginated response. */
+export interface IngestedEventPaginatedResponse {
+    data: IngestedEvent[];
+    meta: CursorMeta;
+}
+/** The list of parameters that failed validation. */
+export type InvalidParameters = (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+/** A meter query request. */
+export interface MeterQueryRequest {
+    /** The start of the period the usage is queried from. */
+    from?: string;
+    /** The end of the period the usage is queried to. */
+    to?: string;
+    /** 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';
+    /** 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 and end of the time buckets. If not specified, the UTC timezone will be used. */
+    time_zone: string;
+    /** The dimensions to group the results by. */
+    group_by_dimensions?: string[];
+    /** Filters to apply to the query. */
+    filters?: MeterQueryFilters;
+}
+/** Page paginated response. */
+export interface CustomerPagePaginatedResponse {
+    data: Customer[];
+    meta: PaginatedMeta;
+}
+/** Party represents a person or business entity. */
+export interface Party {
+    /** Unique identifier for the party. */
+    id?: string;
+    /** An optional unique key of the party. */
+    key?: string;
+    /** Legal name or representation of the party. */
+    name?: string;
+    /** The entity's legal identification used for tax purposes. They may have other numbers, but we're only interested in those valid for tax purposes. */
+    tax_id?: PartyTaxIdentity;
+    /** Address for where information should be sent if needed. */
+    addresses?: PartyAddresses;
+}
+/** 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 AppStripeCreateCheckoutSessionRequestOptions {
+    /** Whether to collect the customer's billing address. Defaults to auto, which only collects the address when necessary for tax calculation. */
+    billing_address_collection: 'auto' | 'required';
+    /** URL to redirect customers who cancel the checkout session. Not allowed when ui_mode is "embedded". */
+    cancel_url?: string;
+    /** Unique reference string for reconciling sessions with internal systems. Can be a customer ID, cart ID, or any other identifier. */
+    client_reference_id?: string;
+    /** Controls which customer fields can be updated by the checkout session. */
+    customer_update?: AppStripeCreateCheckoutSessionCustomerUpdate;
+    /** Configuration for collecting customer consent during checkout. */
+    consent_collection?: AppStripeCreateCheckoutSessionConsentCollection;
+    /** Three-letter ISO 4217 currency code in uppercase. Required for payment mode sessions. Optional for setup mode sessions. */
+    currency?: string;
+    /** Custom text to display during checkout at various stages. */
+    custom_text?: AppStripeCheckoutSessionCustomTextParams;
+    /** Unix timestamp when the checkout session expires. Can be 30 minutes to 24 hours from creation. Defaults to 24 hours. */
+    expires_at?: bigint;
+    /** IETF language tag for the checkout UI locale. If blank or "auto", uses the browser's locale. Example: "en", "fr", "de". */
+    locale?: string;
+    /** Set of key-value pairs to attach to the checkout session. Useful for storing additional structured information. */
+    metadata?: Record<string, string>;
+    /** Return URL for embedded checkout sessions after payment authentication. Required if ui_mode is "embedded" and redirect-based payment methods are enabled. */
+    return_url?: string;
+    /** Success URL to redirect customers after completing payment or setup. Not allowed when ui_mode is "embedded". See: https://docs.stripe.com/payments/checkout/custom-success-page */
+    success_url?: string;
+    /** The UI mode for the checkout session. "hosted" displays a Stripe-hosted page. "embedded" integrates directly into your app. Defaults to "hosted". */
+    ui_mode: 'embedded' | 'hosted';
+    /** List of payment method types to enable (e.g., "card", "us_bank_account"). If not specified, Stripe enables all relevant payment methods. */
+    payment_method_types?: string[];
+    /** Redirect behavior for embedded checkout sessions. Controls when to redirect users after completion. See: https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form */
+    redirect_on_completion?: 'always' | 'if_required' | 'never';
+    /** Configuration for collecting tax IDs during checkout. */
+    tax_id_collection?: AppStripeCreateCheckoutSessionTaxIdCollection;
+}
+/** Page paginated response. */
+export interface TaxCodePagePaginatedResponse {
+    data: TaxCode[];
+    meta: PaginatedMeta;
+}
+/** Page paginated response. */
+export interface CurrencyPagePaginatedResponse {
+    data: (CurrencyFiat | CurrencyCustom)[];
+    meta: PaginatedMeta;
+}
+/** Access evaluation result for a single resolved customer. */
+export interface GovernanceQueryResult {
+    /** The list of identifiers from the request that resolved to this customer. Each entry is either the customer `key` or one of its usage-attribution subject `key`s. Duplicate or aliased identifiers that resolve to the same customer collapse to a single result entry, with every requested identifier listed here. */
+    matched: string[];
+    /** The customer the matched identifiers resolved to. */
+    customer: Customer;
+    /** Map of features with their access status. Map keys are the feature keys requested in `feature.keys`, or every feature `key` available in the organization when the feature filter was omitted. */
+    features: Record<string, GovernanceFeatureAccess>;
+    /** Timestamp of the most recent change to the customer's access state reflected in this result. */
+    updated_at: string;
+}
+/** A capability or billable dimension offered by a provider. */
+export interface Feature {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    key: string;
+    /** The meter that the feature is associated with and based on which usage is calculated. If not specified, the feature is static. */
+    meter?: FeatureMeterReference;
+    /** Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties. */
+    unit_cost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+}
+/** Feature create request. */
+export interface CreateFeatureRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The meter that the feature is associated with and based on which usage is calculated. If not specified, the feature is static. */
+    meter?: FeatureMeterReference;
+    /** Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties. */
+    unit_cost?: FeatureManualUnitCost | FeatureLlmUnitCost;
+}
+/** Request body for updating a feature. Currently only the unit_cost field can be updated. */
+export interface UpdateFeatureRequest {
+    /** Optional per-unit cost configuration. Use "manual" for a fixed per-unit cost, or "llm" to look up cost from the LLM cost database based on meter group-by properties. Set to `null` to clear the existing unit cost; omit to leave it unchanged. */
+    unit_cost?: FeatureManualUnitCost | FeatureLlmUnitCost | null;
+}
+/** Page paginated response. */
+export interface CreditGrantPagePaginatedResponse {
+    data: CreditGrant[];
+    meta: PaginatedMeta;
+}
+/** Bad Request. */
+export interface BadRequest extends BaseError {
+    /** The list of parameters that failed validation. */
+    invalid_parameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+}
+/** 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 CustomerStripeCreateCheckoutSessionRequest {
+    /** Options for configuring the Stripe Checkout Session. These options are passed directly to Stripe's [checkout session creation API](https://docs.stripe.com/api/checkout/sessions/create). */
+    stripe_options: AppStripeCreateCheckoutSessionRequestOptions;
+}
+/** Workflow collection specifies how to collect the pending line items for an invoice. */
+export interface WorkflowCollectionSettings {
+    /** The alignment for collecting the pending line items into an invoice. */
+    alignment: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    /** This grace period can be used to delay the collection of the pending line items specified in alignment. This is useful, in case of multiple subscriptions having slightly different billing periods. */
+    interval: string;
+}
+/** Page paginated response. */
+export interface AppPagePaginatedResponse {
+    data: (AppStripe | AppSandbox | AppExternalInvoicing)[];
+    meta: PaginatedMeta;
+}
+/** Applications used by a billing profile. */
+export interface ProfileApps {
+    /** The tax app used for this workflow. */
+    tax: AppStripe | AppSandbox | AppExternalInvoicing;
+    /** The invoicing app used for this workflow. */
+    invoicing: AppStripe | AppSandbox | AppExternalInvoicing;
+    /** The payment app used for this workflow. */
+    payment: AppStripe | AppSandbox | AppExternalInvoicing;
+}
+/** Response of the governance query. */
+export interface GovernanceQueryResponse {
+    /** Access evaluation results, one entry per resolved customer. */
+    data: GovernanceQueryResult[];
+    /** Partial errors encountered while processing the request. */
+    errors: GovernanceQueryError[];
+    /** Pagination metadata. The endpoint may return a partial response if the full response would exceed server-side limits. */
+    meta: CursorMeta;
+}
+/** A flat fee charge for a customer. */
+export interface FlatFeeCharge {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The type of the charge. */
+    type: 'flat_fee';
+    /** The customer owning the charge. */
+    customer: BillingCustomerReference;
+    /** The charge is managed by the following entity. */
+    managed_by: 'manual' | 'system' | 'subscription';
+    /** The subscription that originated the charge, when the charge was created from a subscription item. */
+    subscription?: SubscriptionReference;
+    /** The currency of the charge. */
+    currency: string;
+    /** The lifecycle status of the charge. */
+    status: 'created' | 'active' | 'final' | 'deleted';
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoice_at: string;
+    /** The effective service period covered by the charge. */
+    service_period: ClosedPeriod;
+    /** The full, unprorated service period of the charge. */
+    full_service_period: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billing_period: ClosedPeriod;
+    /** The earliest time when the charge should be advanced again by background processing. */
+    advance_after?: string;
+    /** The price of the charge. */
+    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    /** Unique reference ID of the charge. */
+    unique_reference_id?: string;
+    /** Settlement mode of the charge. */
+    settlement_mode: 'credit_then_invoice' | 'credit_only';
+    /** Tax configuration of the charge. */
+    tax_config?: TaxConfig;
+    /** Payment term of the flat fee charge. */
+    payment_term: 'in_advance' | 'in_arrears';
+    /** The discounts applied to the charge. */
+    discounts?: FlatFeeDiscounts;
+    /** The feature associated with the charge, when applicable. */
+    feature_key?: string;
+    /** The proration configuration of the charge. */
+    proration_configuration: RateCardProrationConfiguration;
+    /** The amount after proration of the charge. */
+    amount_after_proration: CurrencyAmount;
+}
+/** A usage-based charge for a customer. */
+export interface UsageBasedCharge {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The type of the charge. */
+    type: 'usage_based';
+    /** The customer owning the charge. */
+    customer: BillingCustomerReference;
+    /** The charge is managed by the following entity. */
+    managed_by: 'manual' | 'system' | 'subscription';
+    /** The subscription that originated the charge, when the charge was created from a subscription item. */
+    subscription?: SubscriptionReference;
+    /** The currency of the charge. */
+    currency: string;
+    /** The lifecycle status of the charge. */
+    status: 'created' | 'active' | 'final' | 'deleted';
+    /** The timestamp when the charge is intended to be invoiced. */
+    invoice_at: string;
+    /** The effective service period covered by the charge. */
+    service_period: ClosedPeriod;
+    /** The full, unprorated service period of the charge. */
+    full_service_period: ClosedPeriod;
+    /** The billing period the charge belongs to. */
+    billing_period: ClosedPeriod;
+    /** The earliest time when the charge should be advanced again by background processing. */
+    advance_after?: string;
+    /** The price of the charge. */
+    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    /** Unique reference ID of the charge. */
+    unique_reference_id?: string;
+    /** Settlement mode of the charge. */
+    settlement_mode: 'credit_then_invoice' | 'credit_only';
+    /** Tax configuration of the charge. */
+    tax_config?: TaxConfig;
+    /** Discounts applied to the usage-based charge. */
+    discounts?: RateCardDiscounts;
+    /** The feature associated with the charge. */
+    feature_key: string;
+    /** Aggregated booked and realtime totals for the charge. */
+    totals: ChargeTotals;
+}
+/** A rate card defines the pricing and entitlement of a feature or service. */
+export interface RateCard {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The feature associated with the rate card. */
+    feature?: FeatureReference;
+    /** The billing cadence of the rate card. When null, the charge is one-time (non-recurring). Only valid for flat prices. */
+    billing_cadence?: string;
+    /** The price of the rate card. */
+    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    /** The payment term of the rate card. In advance payment term can only be used for flat prices. */
+    payment_term: 'in_advance' | 'in_arrears';
+    /** Spend commitments for this rate card. Only applicable to usage-based prices (unit, graduated, volume). */
+    commitments?: SpendCommitments;
+    /** The discounts of the rate card. */
+    discounts?: RateCardDiscounts;
+    /** The tax config of the rate card. */
+    tax_config?: RateCardTaxConfig;
+}
+/** Page paginated response. */
+export interface FeaturePagePaginatedResponse {
+    data: Feature[];
+    meta: PaginatedMeta;
+}
+/** Billing workflow settings. */
+export interface Workflow {
+    /** The collection settings for this workflow */
+    collection?: WorkflowCollectionSettings;
+    /** The invoicing settings for this workflow */
+    invoicing?: WorkflowInvoicingSettings;
+    /** The payment settings for this workflow */
+    payment?: WorkflowPaymentChargeAutomaticallySettings | WorkflowPaymentSendInvoiceSettings;
+    /** The tax settings for this workflow */
+    tax?: WorkflowTaxSettings;
+}
+/** The plan phase or pricing ramp allows changing a plan's rate cards over time as a subscription progresses. */
+export interface PlanPhase {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The duration of the phase. When not specified, the phase runs indefinitely. Only the last phase may omit the duration. */
+    duration?: string;
+    /** The rate cards of the plan. */
+    rate_cards: RateCard[];
+}
+/** Add-on allows extending subscriptions with compatible plans with additional ratecards. */
+export interface Addon {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** A key is a semi-unique string that is used to identify the add-on. It is used to reference the latest `active` version of the add-on and is unique with the version number. */
+    key: string;
+    /** Version of the add-on. Incremented when the add-on is updated. */
+    version: number;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The currency code of the add-on. */
+    currency: string;
+    /** The date and time when the add-on becomes effective. When not specified, the add-on is a draft. */
+    effective_from?: string;
+    /** The date and time when the add-on is no longer effective. When not specified, the add-on is effective indefinitely. */
+    effective_to?: string;
+    /** The status of the add-on. Computed based on the effective start and end dates: - `draft`: `effective_from` is not set. - `active`: `effective_from <= now` and (`effective_to` is not set or `now < effective_to`). - `archived`: `effective_to <= now`. */
+    status: 'draft' | 'active' | 'archived';
+    /** The rate cards of the add-on. */
+    rate_cards: RateCard[];
+    /** List of validation errors. */
+    validation_errors?: ProductCatalogValidationError[];
+}
+/** Addon create request. */
+export interface CreateAddonRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** A key is a semi-unique string that is used to identify the add-on. It is used to reference the latest `active` version of the add-on and is unique with the version number. */
+    key: string;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The currency code of the add-on. */
+    currency: string;
+    /** The rate cards of the add-on. */
+    rate_cards: RateCard[];
+}
+/** Addon upsert request. */
+export interface UpsertAddonRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The rate cards of the add-on. */
+    rate_cards: RateCard[];
+}
+/** Billing profiles contain the settings for billing and controls invoice generation. */
+export interface Profile {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: Workflow;
+    /** The applications used by this billing profile. */
+    apps: ProfileAppReferences;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+/** BillingProfile create request. */
+export interface CreateBillingProfileRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: Workflow;
+    /** The applications used by this billing profile. */
+    apps: ProfileAppReferences;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+/** BillingProfile upsert request. */
+export interface UpsertBillingProfileRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: Workflow;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+/** Page paginated response. */
+export interface ChargePagePaginatedResponse {
+    data: (FlatFeeCharge | UsageBasedCharge)[];
+    meta: PaginatedMeta;
+}
+/** Plans provide a template for subscriptions. */
+export interface Plan {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** A key is a semi-unique string that is used to identify the plan. It is used to reference the latest `active` version of the plan and is unique with the version number. */
+    key: string;
+    /** Plans are versioned to allow you to make changes without affecting running subscriptions. */
+    version: number;
+    /** The currency code of the plan. */
+    currency: string;
+    /** The billing cadence for subscriptions using this plan. */
+    billing_cadence: string;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled: boolean;
+    /** The date and time when the plan becomes `active`. When not specified, the plan is in `draft` status. */
+    effective_from?: string;
+    /** A scheduled date and time when the plan becomes `archived`. When not specified, the plan is in `active` status indefinitely. */
+    effective_to?: string;
+    /** The status of the plan. Computed based on the effective start and end dates: - `draft`: `effective_from` is not set. - `scheduled`: `now < effective_from`. - `active`: `effective_from <= now` and (`effective_to` is not set or `now < effective_to`). - `archived`: `effective_to <= now`. */
+    status: 'draft' | 'active' | 'archived' | 'scheduled';
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhase[];
+    /** List of validation errors in `draft` state that prevent the plan from being published. */
+    validation_errors?: ProductCatalogValidationError[];
+}
+/** Plan create request. */
+export interface CreatePlanRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** A key is a semi-unique string that is used to identify the plan. It is used to reference the latest `active` version of the plan and is unique with the version number. */
+    key: string;
+    /** The currency code of the plan. */
+    currency: string;
+    /** The billing cadence for subscriptions using this plan. */
+    billing_cadence: string;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled: boolean;
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhase[];
+}
+/** Plan upsert request. */
+export interface UpsertPlanRequest {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled: boolean;
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhase[];
+}
+/** Page paginated response. */
+export interface AddonPagePaginatedResponse {
+    data: Addon[];
+    meta: PaginatedMeta;
+}
+/** Page paginated response. */
+export interface ProfilePagePaginatedResponse {
+    data: Profile[];
+    meta: PaginatedMeta;
+}
+/** Page paginated response. */
+export interface PlanPagePaginatedResponse {
+    data: Plan[];
+    meta: PaginatedMeta;
+}
+export interface SortQueryInput {
+    /** The attribute to sort by. */
+    by: string;
+    /** The sort order. `asc` for ascending, `desc` for descending. */
+    order?: 'asc' | 'desc';
+}
+export interface BaseErrorInput {
+    /** Type contains a URI that identifies the problem type. */
+    type?: string;
+    /** The HTTP status code generated by the origin server for this occurrence of the problem. */
+    status: number;
+    /** A a short, human-readable summary of the problem type. */
+    title: string;
+    /** A human-readable explanation specific to this occurrence of the problem. */
+    detail: string;
+    /** A URI reference that identifies the specific occurrence of the problem. */
+    instance: string;
+    [key: string]: unknown;
+}
+export interface WorkflowInvoicingSettingsInput {
+    /** Whether to automatically issue the invoice after the draftPeriod has passed. */
+    auto_advance?: boolean;
+    /** The period for the invoice to be kept in draft status for manual reviews. */
+    draft_period?: string;
+    /** Should progressive billing be allowed for this workflow? */
+    progressive_billing?: boolean;
+}
+export interface WorkflowPaymentSendInvoiceSettingsInput {
+    /** The collection method for the invoice. */
+    collection_method: 'send_invoice';
+    /** The period after which the invoice is due. With some payment solutions it's only applicable for manual collection method. */
+    due_after?: string;
+}
+export interface EventInput {
+    /** Identifies the event. */
+    id: string;
+    /** Identifies the context in which an event happened. */
+    source: string;
+    /** The version of the CloudEvents specification which the event uses. */
+    specversion?: string;
+    /** Contains a value describing the type of event related to the originating occurrence. */
+    type: string;
+    /** Content type of the CloudEvents data value. Only the value "application/json" is allowed over HTTP. */
+    datacontenttype?: 'application/json' | null;
+    /** Identifies the schema that data adheres to. */
+    dataschema?: string | null;
+    /** Describes the subject of the event in the context of the event producer (identified by source). */
+    subject: string;
+    /** Timestamp of when the occurrence happened. Must adhere to RFC 3339. */
+    time?: string | null;
+    /** The event payload. Optional, if present it must be a JSON object. */
+    data?: Record<string, unknown> | null;
+}
+export interface UnauthorizedInput extends BaseErrorInput {
+}
+export interface ForbiddenInput extends BaseErrorInput {
+}
+export interface NotFoundInput extends BaseErrorInput {
+}
+export interface GoneInput extends BaseErrorInput {
+}
+export interface ConflictInput extends BaseErrorInput {
+}
+export interface PayloadTooLargeInput extends BaseErrorInput {
+}
+export interface UnsupportedMediaTypeInput extends BaseErrorInput {
+}
+export interface UnprocessableContentInput extends BaseErrorInput {
+}
+export interface TooManyRequestsInput extends BaseErrorInput {
+}
+export interface InternalInput extends BaseErrorInput {
+}
+export interface NotImplementedInput extends BaseErrorInput {
+}
+export interface NotAvailableInput extends BaseErrorInput {
+}
+export interface AppStripeCreateCheckoutSessionCustomerUpdateInput {
+    /** Whether to save the billing address to customer.address. Defaults to "never". */
+    address?: 'auto' | 'never';
+    /** Whether to save the customer name to customer.name. Defaults to "never". */
+    name?: 'auto' | 'never';
+    /** Whether to save shipping information to customer.shipping. Defaults to "never". */
+    shipping?: 'auto' | 'never';
+}
+export interface AppStripeCreateCheckoutSessionTaxIdCollectionInput {
+    /** Enable tax ID collection during checkout. Defaults to false. */
+    enabled?: boolean;
+    /** Whether tax ID collection is required. Defaults to "never". */
+    required?: 'if_supported' | 'never';
+}
+export interface CreateCreditGrantPurchaseInput {
+    /** Currency of the purchase amount. */
+    currency: string;
+    /** Cost basis per credit unit used to calculate the purchase amount. If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge is $50.00. The value must be greater than 0. If the cost basis is 0, use `funding_method=none` instead. Defaults to 1.0. */
+    per_unit_cost_basis?: string;
+    /** Controls when credits become available for consumption. Defaults to `on_creation`. */
+    availability_policy?: 'on_creation';
+}
+export interface CreditGrantPurchaseInput {
+    /** Currency of the purchase amount. */
+    currency: string;
+    /** Cost basis per credit unit used to calculate the purchase amount. If `per_unit_cost_basis` is 0.50 and credit amount is $100.00, the total charge is $50.00. The value must be greater than 0. If the cost basis is 0, use `funding_method=none` instead. Defaults to 1.0. */
+    per_unit_cost_basis?: string;
+    /** The purchase amount. Calculated from `per_unit_cost_basis` and credit `amount`. */
+    amount: string;
+    /** Controls when credits become available for consumption. Defaults to `on_creation`. */
+    availability_policy?: 'on_creation';
+    /** Current payment settlement status. */
+    settlement_status?: 'pending' | 'authorized' | 'settled';
+}
+export interface GovernanceQueryRequestInput {
+    /** Whether to include credit balance availability for each resolved customer. When true, each feature evaluation includes credit balance checks. Defaults to `false`. */
+    include_credits?: boolean;
+    customer: GovernanceQueryRequestCustomers;
+    feature?: GovernanceQueryRequestFeatures;
+}
+export interface UnitConfigInput {
+    /** The arithmetic operation to apply to the raw metered quantity. */
+    operation: 'divide' | 'multiply';
+    /** The factor used in the conversion operation. - For `divide`: `converted = raw / conversionFactor`. - For `multiply`: `converted = raw × conversionFactor`. Must be a positive non-zero value. */
+    conversion_factor: string;
+    /** The rounding mode applied to the converted quantity for invoicing. Defaults to none (no rounding). Entitlement checks always use the precise (unrounded) value. */
+    rounding?: 'ceiling' | 'floor' | 'half_up' | 'none';
+    /** The number of decimal places to retain after rounding. Only meaningful when rounding is not "none". Defaults to 0 (round to whole numbers). */
+    precision?: number;
+    /** A human-readable label for the converted unit shown on invoices and in the customer portal (e.g., "GB", "hours", "M tokens"). Optional. When omitted, no unit label is rendered. */
+    display_unit?: string;
+}
+export interface IngestedEventInput {
+    /** The original event ingested. */
+    event: EventInput;
+    /** The customer if the event is associated with a customer. */
+    customer?: CustomerReference;
+    /** The date and time the event was ingested and its processing started. */
+    ingested_at: string;
+    /** The date and time the event was stored in the database. */
+    stored_at: string;
+    /** The validation errors of the ingested event. */
+    validation_errors?: IngestedEventValidationError[];
+}
+export interface SubscriptionCancelInput {
+    /** If not provided the subscription is canceled immediately. */
+    timing?: 'immediate' | 'next_billing_cycle' | string;
+}
+export interface InvoiceUsageQuantityDetailInput {
+    /** The raw quantity as reported by the meter (native units). */
+    raw_quantity: string;
+    /** The precise decimal value after applying the conversion operation and factor, before rounding. */
+    converted_quantity: string;
+    /** The quantity after rounding, used for pricing. */
+    invoiced_quantity: string;
+    /** The display unit label (e.g., "GB", "hours", "M tokens"). */
+    display_unit?: string;
+    /** Snapshot of the UnitConfig that was in effect at billing time. Ensures historical invoices reflect the config that was actually applied. */
+    applied_unit_config: UnitConfigInput;
+}
+export interface CreateCreditGrantRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: CreateLabels;
+    /** Funding method of the grant. */
+    funding_method: 'none' | 'invoice' | 'external';
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+    /** Present when a funding workflow applies (funding_method is not `none`). */
+    purchase?: CreateCreditGrantPurchaseInput;
+    /** Tax configuration for the grant. For `invoice` and `external` funding methods, tax configuration should be provided to ensure correct revenue recognition. When not provided, the default credit grant tax code is applied, if that's not set the global default taxcode is used. */
+    tax_config?: CreateCreditGrantTaxConfig;
+    filters?: CreateCreditGrantFilters;
+    /** Draw-down priority of the grant. Lower values have higher priority. */
+    priority?: number;
+    /** The duration after which the credit grant expires. Defaults to never expiring. */
+    expires_after?: string;
+}
+export interface CreditGrantInput {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** Funding method of the grant. */
+    funding_method: 'none' | 'invoice' | 'external';
+    /** The currency of the granted credits. */
+    currency: string;
+    /** Granted credit amount. */
+    amount: string;
+    /** Present when a funding workflow applies (funding_method is not `none`). */
+    purchase?: CreditGrantPurchaseInput;
+    /** Tax configuration for the grant. For `invoice` and `external` funding methods, tax configuration should be provided to ensure correct revenue recognition. When not provided, the default credit grant tax code is applied, if that's not set the global default taxcode is used. */
+    tax_config?: CreditGrantTaxConfig;
+    /** Available when `funding_method` is `invoice`. */
+    invoice?: CreditGrantInvoiceReference;
+    filters?: CreditGrantFilters;
+    /** Draw-down priority of the grant. Lower values have higher priority. */
+    priority?: number;
+    /** The duration after which the credit grant expires. Defaults to never expiring. */
+    expires_after?: string;
+    /** The timestamp when the credit grant expires. Calculated from the grant effective time and `expires_after` if provided. */
+    expires_at?: string;
+    /** Timestamp when the grant was voided. */
+    voided_at?: string;
+    /** Current lifecycle status of the grant. */
+    status: 'pending' | 'active' | 'expired' | 'voided';
+}
+export interface WorkflowTaxSettingsInput {
+    /** Enable automatic tax calculation when tax is supported by the app. For example, with Stripe Invoicing when enabled, tax is calculated via Stripe Tax. */
+    enabled?: boolean;
+    /** Enforce tax calculation when tax is supported by the app. When enabled, the billing system will not allow to create an invoice without tax calculation. Enforcement is different per apps, for example, Stripe app requires customer to have a tax location when starting a paid subscription. */
+    enforced?: boolean;
+    /** Default tax configuration to apply to the invoices for line items. */
+    default_tax_config?: TaxConfig;
+}
+export interface IngestedEventPaginatedResponseInput {
+    data: IngestedEventInput[];
+    meta: CursorMeta;
+}
+export interface MeterQueryRequestInput {
+    /** The start of the period the usage is queried from. */
+    from?: string;
+    /** The end of the period the usage is queried to. */
+    to?: string;
+    /** 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';
+    /** 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 and end of the time buckets. If not specified, the UTC timezone will be used. */
+    time_zone?: string;
+    /** The dimensions to group the results by. */
+    group_by_dimensions?: string[];
+    /** Filters to apply to the query. */
+    filters?: MeterQueryFilters;
+}
+export interface AppStripeCreateCheckoutSessionRequestOptionsInput {
+    /** Whether to collect the customer's billing address. Defaults to auto, which only collects the address when necessary for tax calculation. */
+    billing_address_collection?: 'auto' | 'required';
+    /** URL to redirect customers who cancel the checkout session. Not allowed when ui_mode is "embedded". */
+    cancel_url?: string;
+    /** Unique reference string for reconciling sessions with internal systems. Can be a customer ID, cart ID, or any other identifier. */
+    client_reference_id?: string;
+    /** Controls which customer fields can be updated by the checkout session. */
+    customer_update?: AppStripeCreateCheckoutSessionCustomerUpdateInput;
+    /** Configuration for collecting customer consent during checkout. */
+    consent_collection?: AppStripeCreateCheckoutSessionConsentCollection;
+    /** Three-letter ISO 4217 currency code in uppercase. Required for payment mode sessions. Optional for setup mode sessions. */
+    currency?: string;
+    /** Custom text to display during checkout at various stages. */
+    custom_text?: AppStripeCheckoutSessionCustomTextParams;
+    /** Unix timestamp when the checkout session expires. Can be 30 minutes to 24 hours from creation. Defaults to 24 hours. */
+    expires_at?: bigint;
+    /** IETF language tag for the checkout UI locale. If blank or "auto", uses the browser's locale. Example: "en", "fr", "de". */
+    locale?: string;
+    /** Set of key-value pairs to attach to the checkout session. Useful for storing additional structured information. */
+    metadata?: Record<string, string>;
+    /** Return URL for embedded checkout sessions after payment authentication. Required if ui_mode is "embedded" and redirect-based payment methods are enabled. */
+    return_url?: string;
+    /** Success URL to redirect customers after completing payment or setup. Not allowed when ui_mode is "embedded". See: https://docs.stripe.com/payments/checkout/custom-success-page */
+    success_url?: string;
+    /** The UI mode for the checkout session. "hosted" displays a Stripe-hosted page. "embedded" integrates directly into your app. Defaults to "hosted". */
+    ui_mode?: 'embedded' | 'hosted';
+    /** List of payment method types to enable (e.g., "card", "us_bank_account"). If not specified, Stripe enables all relevant payment methods. */
+    payment_method_types?: string[];
+    /** Redirect behavior for embedded checkout sessions. Controls when to redirect users after completion. See: https://docs.stripe.com/payments/checkout/custom-success-page?payment-ui=embedded-form */
+    redirect_on_completion?: 'always' | 'if_required' | 'never';
+    /** Configuration for collecting tax IDs during checkout. */
+    tax_id_collection?: AppStripeCreateCheckoutSessionTaxIdCollectionInput;
+}
+export interface CreditGrantPagePaginatedResponseInput {
+    data: CreditGrantInput[];
+    meta: PaginatedMeta;
+}
+export interface BadRequestInput extends BaseErrorInput {
+    /** The list of parameters that failed validation. */
+    invalid_parameters: (InvalidParameterStandard | InvalidParameterMinimumLength | InvalidParameterMaximumLength | InvalidParameterChoiceItem | InvalidParameterDependentItem)[];
+}
+export interface CustomerStripeCreateCheckoutSessionRequestInput {
+    /** Options for configuring the Stripe Checkout Session. These options are passed directly to Stripe's [checkout session creation API](https://docs.stripe.com/api/checkout/sessions/create). */
+    stripe_options: AppStripeCreateCheckoutSessionRequestOptionsInput;
+}
+export interface WorkflowCollectionSettingsInput {
+    /** The alignment for collecting the pending line items into an invoice. */
+    alignment?: WorkflowCollectionAlignmentSubscription | WorkflowCollectionAlignmentAnchored;
+    /** This grace period can be used to delay the collection of the pending line items specified in alignment. This is useful, in case of multiple subscriptions having slightly different billing periods. */
+    interval?: string;
+}
+export interface RateCardInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The feature associated with the rate card. */
+    feature?: FeatureReference;
+    /** The billing cadence of the rate card. When null, the charge is one-time (non-recurring). Only valid for flat prices. */
+    billing_cadence?: string;
+    /** The price of the rate card. */
+    price: PriceFree | PriceFlat | PriceUnit | PriceGraduated | PriceVolume;
+    /** The payment term of the rate card. In advance payment term can only be used for flat prices. */
+    payment_term?: 'in_advance' | 'in_arrears';
+    /** Spend commitments for this rate card. Only applicable to usage-based prices (unit, graduated, volume). */
+    commitments?: SpendCommitments;
+    /** The discounts of the rate card. */
+    discounts?: RateCardDiscounts;
+    /** The tax config of the rate card. */
+    tax_config?: RateCardTaxConfig;
+}
+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;
+    /** The tax settings for this workflow */
+    tax?: WorkflowTaxSettingsInput;
+}
+export interface PlanPhaseInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    key: string;
+    /** The duration of the phase. When not specified, the phase runs indefinitely. Only the last phase may omit the duration. */
+    duration?: string;
+    /** The rate cards of the plan. */
+    rate_cards: RateCardInput[];
+}
+export interface AddonInput {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** A key is a semi-unique string that is used to identify the add-on. It is used to reference the latest `active` version of the add-on and is unique with the version number. */
+    key: string;
+    /** Version of the add-on. Incremented when the add-on is updated. */
+    version?: number;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The currency code of the add-on. */
+    currency: string;
+    /** The date and time when the add-on becomes effective. When not specified, the add-on is a draft. */
+    effective_from?: string;
+    /** The date and time when the add-on is no longer effective. When not specified, the add-on is effective indefinitely. */
+    effective_to?: string;
+    /** The status of the add-on. Computed based on the effective start and end dates: - `draft`: `effective_from` is not set. - `active`: `effective_from <= now` and (`effective_to` is not set or `now < effective_to`). - `archived`: `effective_to <= now`. */
+    status: 'draft' | 'active' | 'archived';
+    /** The rate cards of the add-on. */
+    rate_cards: RateCardInput[];
+    /** List of validation errors. */
+    validation_errors?: ProductCatalogValidationError[];
+}
+export interface CreateAddonRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** A key is a semi-unique string that is used to identify the add-on. It is used to reference the latest `active` version of the add-on and is unique with the version number. */
+    key: string;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The currency code of the add-on. */
+    currency: string;
+    /** The rate cards of the add-on. */
+    rate_cards: RateCardInput[];
+}
+export interface UpsertAddonRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The InstanceType of the add-ons. Can be "single" or "multiple". */
+    instance_type: 'single' | 'multiple';
+    /** The rate cards of the add-on. */
+    rate_cards: RateCardInput[];
+}
+export interface ProfileInput {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: WorkflowInput;
+    /** The applications used by this billing profile. */
+    apps: ProfileAppReferences;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+export interface CreateBillingProfileRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: WorkflowInput;
+    /** The applications used by this billing profile. */
+    apps: ProfileAppReferences;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+export interface UpsertBillingProfileRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** The name and contact information for the supplier this billing profile represents */
+    supplier: Party;
+    /** The billing workflow settings for this profile */
+    workflow: WorkflowInput;
+    /** Whether this is the default profile. */
+    default: boolean;
+}
+export interface PlanInput {
+    id: string;
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** An ISO-8601 timestamp representation of entity creation date. */
+    created_at: string;
+    /** An ISO-8601 timestamp representation of entity last update date. */
+    updated_at: string;
+    /** An ISO-8601 timestamp representation of entity deletion date. */
+    deleted_at?: string;
+    /** A key is a semi-unique string that is used to identify the plan. It is used to reference the latest `active` version of the plan and is unique with the version number. */
+    key: string;
+    /** Plans are versioned to allow you to make changes without affecting running subscriptions. */
+    version?: number;
+    /** The currency code of the plan. */
+    currency: string;
+    /** The billing cadence for subscriptions using this plan. */
+    billing_cadence: string;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled?: boolean;
+    /** The date and time when the plan becomes `active`. When not specified, the plan is in `draft` status. */
+    effective_from?: string;
+    /** A scheduled date and time when the plan becomes `archived`. When not specified, the plan is in `active` status indefinitely. */
+    effective_to?: string;
+    /** The status of the plan. Computed based on the effective start and end dates: - `draft`: `effective_from` is not set. - `scheduled`: `now < effective_from`. - `active`: `effective_from <= now` and (`effective_to` is not set or `now < effective_to`). - `archived`: `effective_to <= now`. */
+    status: 'draft' | 'active' | 'archived' | 'scheduled';
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhaseInput[];
+    /** List of validation errors in `draft` state that prevent the plan from being published. */
+    validation_errors?: ProductCatalogValidationError[];
+}
+export interface CreatePlanRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** A key is a semi-unique string that is used to identify the plan. It is used to reference the latest `active` version of the plan and is unique with the version number. */
+    key: string;
+    /** The currency code of the plan. */
+    currency: string;
+    /** The billing cadence for subscriptions using this plan. */
+    billing_cadence: string;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled?: boolean;
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhaseInput[];
+}
+export interface UpsertPlanRequestInput {
+    /** Display name of the resource. Between 1 and 256 characters. */
+    name: string;
+    /** Optional description of the resource. Maximum 1024 characters. */
+    description?: string;
+    labels?: Labels;
+    /** Whether pro-rating is enabled for this plan. */
+    pro_rating_enabled?: boolean;
+    /** The plan phases define the pricing ramp for a subscription. A phase switch occurs only at the end of a billing period. At least one phase is required. */
+    phases: PlanPhaseInput[];
+}
+export interface AddonPagePaginatedResponseInput {
+    data: AddonInput[];
+    meta: PaginatedMeta;
+}
+export interface ProfilePagePaginatedResponseInput {
+    data: ProfileInput[];
+    meta: PaginatedMeta;
+}
+export interface PlanPagePaginatedResponseInput {
+    data: PlanInput[];
+    meta: PaginatedMeta;
+}
+//# sourceMappingURL=types.d.ts.map