generated

type Attention struct {
	// Actions Prescribed next steps. First item is the primary CTA; the
	// rest are secondary.
	Actions []AttentionActionItem `json:"actions,omitempty"`

	// Code Open, dotted, provider-specific code (e.g.
	// `tax.customer_data_invalid`, `payment.declined`).
	// New codes ship without a contract
	// bump. Stripe parity.
	Code string `json:"code,omitempty"`

	// Detail Raw provider payload (Stripe Tax JSON envelope, last
	// payment error message). Disclosed in a collapsible
	// section for diagnostic depth.
	Detail string `json:"detail,omitempty"`

	// DocUrl Deep link to operator-facing documentation for this
	// reason. Stripe parity.
	DocUrl string `json:"doc_url,omitempty"`

	// Message Human-readable headline copy, safe to render verbatim.
	Message string `json:"message"`

	// Param Dotted-path pointer at the entity field the operator must
	// edit to resolve the issue (e.g.
	// `customer.address.postal_code`). Stripe parity. Empty
	// when the resolution isn't field-scoped.
	Param string `json:"param,omitempty"`

	// Reason Closed, typed code naming why an invoice needs operator
	// attention. Stable public-API contract — codes are never
	// repurposed; deprecations keep the code reserved and add a
	// successor. See `Attention.code` for the open, provider-specific
	// sub-code. `payment_anomaly` (ADR-068) reports money that does
	// not reconcile — double charge, captured-vs-booked amount
	// mismatch, or a payment on a voided invoice — and is surfaced
	// even on paid/voided invoices. `dunning_exhausted` reports a
	// no-payment-method invoice whose automatic recovery has ended
	// without collecting (2026-07-22). `collection_paused` reports an
	// invoice that is queued for auto-charge but whose subscription
	// has `pause_collection` set, so the charge sweeps deliberately
	// skip it — it will not be charged automatically until
	// collection resumes (2026-07-28). `commit_exposure` reports an
	// unpaid invoice that funded a prepaid commit whose credit is
	// already spendable (ADR-078 funds commits at issue, not at
	// payment) — note this reason is only returned when no other
	// reason applies; when one does, the exposure is folded into that
	// reason's `message` and its `actions` instead, so clients must
	// not treat the reason code as the presence test for exposure
	// (2026-08-04).
	Reason AttentionReason `json:"reason"`

	// Severity Urgency of an Attention surface. Operators sort/filter on this
	// and the dashboard renders one colour per level. Priority
	// descending: Critical > Warning > Info.
	Severity AttentionSeverity `json:"severity"`

	// Since When the attention condition started — operators triage
	// by age. tax_deferred_at for tax reasons; due_at for
	// overdue; updated_at as a proxy for payment failures.
	Since time.Time `json:"since,omitempty"`
}

type AttentionAction string

type AttentionActionItem struct {
	// Code Operator's recommended next step. Closed enum because every
	// code maps to a concrete server endpoint or frontend route,
	// and audit logs key off the code. `void_invoice` is offered only
	// on prepaid-commit exposure, and only while some of the granted
	// credit is still unspent: voiding retires the unspent balance
	// (ADR-078) and is the sole recovery for an unpaid invoice whose
	// credit is already live. Credit the customer has already spent
	// is never clawed back (2026-08-04).
	Code AttentionAction `json:"code"`

	// Label Default rendering label. UIs are free to substitute
	// localized copy.
	Label string `json:"label,omitempty"`
}

type AttentionReason string

type AttentionSeverity string

type ChiServerOptions struct {
	BaseURL          string
	BaseRouter       chi.Router
	Middlewares      []MiddlewareFunc
	ErrorHandlerFunc func(w http.ResponseWriter, r *http.Request, err error)
}

type CreditBalance struct {
	BalanceCents int64  `json:"balance_cents,omitempty"`
	CustomerId   string `json:"customer_id,omitempty"`
	TotalGranted int64  `json:"total_granted,omitempty"`
	TotalUsed    int64  `json:"total_used,omitempty"`
}

type Customer struct {
	// AdditionalEmails CC'd on billing documents and billing-state emails (invoice,
	// receipt, dunning, payment failed, credit note) — never on
	// credential-bearing emails (setup links, resets, invites).
	// Normalized to lowercase bare addresses, deduped, capped at 10,
	// never equal to the primary email. Stored encrypted at rest.
	AdditionalEmails []string       `json:"additional_emails,omitempty"`
	CreatedAt        time.Time      `json:"created_at,omitempty"`
	DisplayName      string         `json:"display_name,omitempty"`
	Email            string         `json:"email,omitempty"`
	ExternalId       string         `json:"external_id,omitempty"`
	Id               string         `json:"id,omitempty"`
	Status           CustomerStatus `json:"status,omitempty"`

	// TestClockId Test clock this customer is pinned to (test mode only). When set,
	// the customer — and any invoices/subscriptions created for it —
	// run on the clock's simulated time. Empty for live customers. The
	// dashboard reads it to show the "test clock" badge + simulated-time
	// banner on the customer and its invoices.
	TestClockId string `json:"test_clock_id,omitempty"`
}

type CustomerStatus string

type Error struct {
	Error struct {
		Code      string         `json:"code,omitempty"`
		Message   string         `json:"message,omitempty"`
		RequestId string         `json:"request_id,omitempty"`
		Type      ErrorErrorType `json:"type,omitempty"`
	} `json:"error,omitempty"`
}

type ErrorErrorType string

type GetV1CreditsGrantsCustomerIdParams struct {
	IncludeExhausted bool `form:"include_exhausted,omitempty" json:"include_exhausted,omitempty"`
}

type GetV1CustomersIdMarginParams struct {
	From time.Time `form:"from,omitempty" json:"from,omitempty"`
	To   time.Time `form:"to,omitempty" json:"to,omitempty"`
}

type GetV1CustomersParams struct {
	Status string `form:"status,omitempty" json:"status,omitempty"`

	// ExternalId Exact-match filter on the caller-assigned external ID.
	ExternalId string `form:"external_id,omitempty" json:"external_id,omitempty"`

	// Ids Comma-separated customer IDs to fetch exactly.
	Ids string `form:"ids,omitempty" json:"ids,omitempty"`

	// Search Case-insensitive substring match on display name, email,
	// external ID, or ID. Matching runs post-decryption (PII
	// columns are encrypted at rest), bounded to the first 5000
	// rows of the tenant's filtered set.
	Search string `form:"search,omitempty" json:"search,omitempty"`

	// Sort One of display_name, email, external_id, status, created_at (default).
	Sort   string                  `form:"sort,omitempty" json:"sort,omitempty"`
	Dir    GetV1CustomersParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
	Limit  int                     `form:"limit,omitempty" json:"limit,omitempty"`
	Offset int                     `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetV1CustomersParamsDir string

type GetV1InvoicesParams struct {
	CustomerId     string `form:"customer_id,omitempty" json:"customer_id,omitempty"`
	SubscriptionId string `form:"subscription_id,omitempty" json:"subscription_id,omitempty"`
	Status         string `form:"status,omitempty" json:"status,omitempty"`
	PaymentStatus  string `form:"payment_status,omitempty" json:"payment_status,omitempty"`

	// Search Case-insensitive substring match on invoice number.
	Search string `form:"search,omitempty" json:"search,omitempty"`

	// From Lower bound on created_at, inclusive. RFC3339 instant or
	// bare YYYY-MM-DD (anchored at 00:00:00Z).
	From string `form:"from,omitempty" json:"from,omitempty"`

	// To Upper bound on created_at, inclusive. RFC3339 instant or
	// bare YYYY-MM-DD (anchored at 23:59:59Z).
	To string `form:"to,omitempty" json:"to,omitempty"`

	// Overdue When true, restrict to open invoices past their due date
	// that haven't settled (finalized + due_at < now +
	// payment_status not succeeded/processing). Backs the
	// dashboard's "Past due" segment.
	Overdue bool `form:"overdue,omitempty" json:"overdue,omitempty"`

	// Ids Comma-separated invoice IDs to fetch exactly.
	Ids string `form:"ids,omitempty" json:"ids,omitempty"`

	// Sort One of invoice_number, amount_due_cents, billing_period_start, due_at, issued_at, status, payment_status, created_at (default).
	Sort   string                 `form:"sort,omitempty" json:"sort,omitempty"`
	Dir    GetV1InvoicesParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
	Limit  int                    `form:"limit,omitempty" json:"limit,omitempty"`
	Offset int                    `form:"offset,omitempty" json:"offset,omitempty"`

	// After Opaque cursor (default created_at sort only); takes precedence over offset.
	After string `form:"after,omitempty" json:"after,omitempty"`
}

type GetV1InvoicesParamsDir string

type GetV1PublicCostDashboardToken200JSONResponseBodyBillingPeriodSource string

type GetV1SubscriptionsParams struct {
	CustomerId string `form:"customer_id,omitempty" json:"customer_id,omitempty"`

	// PlanId Filter to subscriptions with a live item on this plan.
	PlanId string `form:"plan_id,omitempty" json:"plan_id,omitempty"`
	Status string `form:"status,omitempty" json:"status,omitempty"`

	// Search Case-insensitive substring match on display name or code.
	Search string `form:"search,omitempty" json:"search,omitempty"`

	// Sort One of display_name, status, next_billing_at, trial_end_at, created_at (default).
	Sort   string                      `form:"sort,omitempty" json:"sort,omitempty"`
	Dir    GetV1SubscriptionsParamsDir `form:"dir,omitempty" json:"dir,omitempty"`
	Limit  int                         `form:"limit,omitempty" json:"limit,omitempty"`
	Offset int                         `form:"offset,omitempty" json:"offset,omitempty"`
}

type GetV1SubscriptionsParamsDir string

type GetV1UsageEventsParams struct {
	CustomerId string `form:"customer_id,omitempty" json:"customer_id,omitempty"`
	MeterId    string `form:"meter_id,omitempty" json:"meter_id,omitempty"`

	// Dimensions Comma-separated key=value pairs matched against the event's
	// dimensions via JSONB containment (multiple pairs AND).
	// Values that parse as JSON booleans/numbers are matched
	// typed ("cached=true", "attempt=2"); everything else as a
	// string. Malformed pairs → 422. Example:
	// `model=gpt-4o,token_type=input`.
	Dimensions string `form:"dimensions,omitempty" json:"dimensions,omitempty"`
}

type GetV1Whoami200JSONResponseBodyKeyType string

type InstantiateRecipeJSONBody struct {
	Overrides map[string]interface{} `json:"overrides,omitempty"`
}

type InstantiateRecipeJSONRequestBody InstantiateRecipeJSONBody

type InvalidParamFormatError struct {
	ParamName string
	Err       error
}

type Invoice struct {
	AmountDueCents  int64 `json:"amount_due_cents"`
	AmountPaidCents int64 `json:"amount_paid_cents"`

	// Attention Unified "this invoice needs operator attention" surface.
	// Computed server-side from durable invoice fields
	// (`tax_status`, `tax_error_code`, `payment_status`,
	// `last_payment_error`). Never persisted —
	// always derived. Omitted entirely when the invoice is healthy
	// (matches Stripe's `last_finalization_error: null` ergonomic).
	// See ADR-009.
	Attention         Attention `json:"attention,omitempty"`
	AutoChargePending bool      `json:"auto_charge_pending,omitempty"`

	// BillingPeriodDisplay Human period string with the inclusive last covered day ("Jun 1, 2028 – Jun 30, 2028"), date-only in the invoice's billing timezone (ADR-058 / ADR-077). Computed on read; the raw billing_period_start/end stay half-open. Empty/omitted for one-off invoices with no period.
	BillingPeriodDisplay string    `json:"billing_period_display,omitempty"`
	BillingPeriodEnd     time.Time `json:"billing_period_end"`
	BillingPeriodStart   time.Time `json:"billing_period_start"`

	// BillingReason Mirrors Stripe's `invoice.billing_reason`. Classifies the trigger
	// that produced the invoice. Stamped at create time and never mutated.
	BillingReason InvoiceBillingReason `json:"billing_reason,omitempty"`

	// BillingTimezone IANA timezone the period boundaries are anchored in — the org billing timezone resolved and denormalized onto the invoice at issue (ADR-077). billing_period_display is rendered in this zone, so an issued invoice's dates stay fixed even if the org later changes its timezone. Empty for ad-hoc/legacy invoices.
	BillingTimezone     string    `json:"billing_timezone,omitempty"`
	CreatedAt           time.Time `json:"created_at"`
	CreditsAppliedCents int64     `json:"credits_applied_cents"`
	Currency            string    `json:"currency"`
	CustomerId          string    `json:"customer_id"`
	DiscountCents       int64     `json:"discount_cents"`
	DueAt               time.Time `json:"due_at,omitempty"`
	Footer              string    `json:"footer,omitempty"`
	Id                  string    `json:"id"`

	// InvoiceNumber Empty until the invoice is finalized.
	InvoiceNumber string `json:"invoice_number"`

	// IsSimulated Whether this invoice's domain timestamps (created/issued/due/paid)
	// were stamped on a test clock's simulated time rather than
	// wall-clock. Captured at write time (engine: the subscription is
	// clock-pinned; manual composer: the customer is clock-pinned). The
	// dashboard renders a "simulated" badge from this authoritative flag
	// instead of inferring it. Always false in live mode.
	IsSimulated bool `json:"is_simulated,omitempty"`

	// IssuedAt Set when the invoice transitions out of draft.
	IssuedAt           time.Time              `json:"issued_at,omitempty"`
	LastPaymentError   string                 `json:"last_payment_error,omitempty"`
	Memo               string                 `json:"memo,omitempty"`
	Metadata           map[string]interface{} `json:"metadata,omitempty"`
	NetPaymentTermDays int                    `json:"net_payment_term_days"`
	PaidAt             time.Time              `json:"paid_at,omitempty"`

	// PaymentStatus Payment-attempt status. `unknown` marks a Stripe charge attempt that
	// returned an ambiguous error (5xx, timeout, connection reset) where
	// we cannot tell whether Stripe processed the charge — a reconciler
	// resolves these by querying Stripe after a cool-off window.
	PaymentStatus InvoicePaymentStatus `json:"payment_status"`

	// PublicToken Hosted-invoice-URL credential (Stripe-parity
	// `hosted_invoice_url`). Generated at finalize; drafts have an
	// empty token. Rotatable via `POST
	// /v1/invoices/{id}/rotate-public-token`.
	PublicToken string `json:"public_token,omitempty"`

	// RecoveryWarning What an operator must know BEFORE recording an OFFLINE payment on a
	// written-off invoice — a consequence that will go unreconciled, NOT
	// a refusal. Absent when there is nothing to say.
	RecoveryWarning RecoveryWarning `json:"recovery_warning,omitempty"`

	// SourceChangeType Classifies per-item proration artifacts so the dedup index can
	// distinguish a plan-change and a quantity-change that happen to
	// share the same `(subscription, item, timestamp)`.
	SourceChangeType         ItemChangeType `json:"source_change_type,omitempty"`
	SourcePlanChangedAt      time.Time      `json:"source_plan_changed_at,omitempty"`
	SourceSubscriptionItemId string         `json:"source_subscription_item_id,omitempty"`

	// Status Lifecycle state of the invoice. `uncollectible` marks an invoice
	// a dunning policy has given up collecting (no further retries) while
	// keeping it on the books — distinct from `voided` (cancelled, owes
	// nothing).
	Status InvoiceStatus `json:"status"`

	// StripeInvoiceId Source Stripe invoice id (`in_xxx`) for an invoice imported from
	// a Stripe account. Currently always empty: the Stripe importer was
	// removed (deferred until a design-partner cutover) and nothing
	// writes this field today. The column and its unique index remain
	// for a future importer. Empty for Velox-native invoices.
	StripeInvoiceId       string `json:"stripe_invoice_id,omitempty"`
	StripePaymentIntentId string `json:"stripe_payment_intent_id,omitempty"`

	// SubscriptionId Empty for one-off invoices not tied to a subscription.
	SubscriptionId string `json:"subscription_id"`
	SubtotalCents  int64  `json:"subtotal_cents"`
	TaxAmountCents int64  `json:"tax_amount_cents"`

	// TaxCalculationId Provider-side calculation reference captured at build time.
	// For Stripe Tax this expires after 24 h; persisted so finalized
	// invoices remain reconstructable past expiry.
	TaxCalculationId string    `json:"tax_calculation_id,omitempty"`
	TaxCountry       string    `json:"tax_country,omitempty"`
	TaxDeferredAt    time.Time `json:"tax_deferred_at,omitempty"`

	// TaxErrorCode Typed taxonomy of `tax_pending_reason`. One of
	// `customer_data_invalid`, `jurisdiction_unsupported`,
	// `provider_outage`, `provider_auth`, `unknown`. Empty for
	// invoices deferred before this column existed (migration
	// 0067).
	TaxErrorCode     string `json:"tax_error_code,omitempty"`
	TaxExemptReason  string `json:"tax_exempt_reason,omitempty"`
	TaxId            string `json:"tax_id,omitempty"`
	TaxName          string `json:"tax_name,omitempty"`
	TaxPendingReason string `json:"tax_pending_reason,omitempty"`

	// TaxProvider Durable audit snapshot of the upstream tax engine that ran the
	// calculation (e.g. `stripe`, `none`, `manual`).
	TaxProvider string `json:"tax_provider,omitempty"`

	// TaxRate Tax rate as a percent (18.50 = 18.50%), up to 4-decimal precision. ADR-042/043.
	TaxRate          float64 `json:"tax_rate"`
	TaxRetryCount    int     `json:"tax_retry_count,omitempty"`
	TaxReverseCharge bool    `json:"tax_reverse_charge,omitempty"`

	// TaxStatus Whether tax has been successfully calculated. Happy path is `ok`.
	// `pending` means a transient calculation failure is awaiting retry;
	// `failed` means retries are exhausted (operator resolves manually).
	// Pending/failed invoices are blocked from finalize so we never send
	// a wrong tax amount.
	TaxStatus InvoiceTaxStatus `json:"tax_status,omitempty"`

	// TaxTransactionId Provider-side committed transaction reference, captured at
	// finalize. For Stripe Tax this is `tx_xxx` and is the handle
	// the provider needs for a later reversal when a credit note is
	// issued.
	TaxTransactionId string `json:"tax_transaction_id,omitempty"`

	// TenantId Owning tenant. Returned for diagnostic clarity but redundant
	// with the API key (which already determines the tenant).
	// Omitted when empty.
	TenantId         string    `json:"tenant_id,omitempty"`
	TotalAmountCents int64     `json:"total_amount_cents"`
	UpdatedAt        time.Time `json:"updated_at"`
	VoidedAt         time.Time `json:"voided_at,omitempty"`
}

type InvoiceBillingReason string

type InvoiceLineItem struct {
	AmountCents        int64     `json:"amount_cents"`
	BillingPeriodEnd   time.Time `json:"billing_period_end,omitempty"`
	BillingPeriodStart time.Time `json:"billing_period_start,omitempty"`

	// CommitExpiresAt Expiry of the granted commit block. Absent/null = the credits
	// never expire (the default).
	CommitExpiresAt time.Time `json:"commit_expires_at,omitempty"`

	// CommitGrantedCents Marks the line as a prepaid-commit purchase (ADR-078): when the
	// invoice finalizes, a credit block of this many cents is granted
	// to the customer. May differ from the line price — discounted
	// commits sell $10k of credits for $9k. add_on lines on manual
	// invoices only, at most one per invoice. Absent on normal lines.
	CommitGrantedCents int64                  `json:"commit_granted_cents,omitempty"`
	CreatedAt          time.Time              `json:"created_at"`
	Currency           string                 `json:"currency"`
	Description        string                 `json:"description"`
	Id                 string                 `json:"id"`
	InvoiceId          string                 `json:"invoice_id"`
	LineType           InvoiceLineType        `json:"line_type"`
	Metadata           map[string]interface{} `json:"metadata,omitempty"`
	MeterId            string                 `json:"meter_id,omitempty"`

	// MeterUnit The meter's unit ("tokens", "seconds", …), stamped on usage lines at write time so invoice surfaces can apply the display-scale convention (token rates read "$3.00 / 1M tokens"). Empty on non-usage lines and on lines written before the 0173 backfill.
	MeterUnit   string `json:"meter_unit,omitempty"`
	PricingMode string `json:"pricing_mode,omitempty"`
	Quantity    int64  `json:"quantity"`

	// QuantityDecimal Exact (possibly fractional) usage quantity as a decimal string (e.g. "1.5"). The integer `quantity` is this truncated, kept for back-compat (Stripe quantity_decimal parity). "0" means none — use `quantity`. Line amounts stay whole cents.
	QuantityDecimal     string `json:"quantity_decimal,omitempty"`
	RatingRuleVersionId string `json:"rating_rule_version_id,omitempty"`
	TaxAmountCents      int64  `json:"tax_amount_cents"`
	TaxCode             string `json:"tax_code,omitempty"`
	TaxJurisdiction     string `json:"tax_jurisdiction,omitempty"`

	// TaxRate Tax rate as a percent (18.50 = 18.50%), up to 4-decimal precision. ADR-042/043.
	TaxRate float64 `json:"tax_rate"`

	// TaxReason Stripe-canonical structured `taxability_reason`
	// (`standard_rated`, `reverse_charge`, `not_collecting`,
	// `customer_exempt`, `product_exempt`, `zero_rated`, etc.).
	// Empty for non-Stripe providers.
	TaxReason string `json:"tax_reason,omitempty"`

	// TenantId Owning tenant. Omitted when empty.
	TenantId         string `json:"tenant_id,omitempty"`
	TotalAmountCents int64  `json:"total_amount_cents"`
	UnitAmountCents  int64  `json:"unit_amount_cents"`

	// UnitAmountDecimal Full-precision per-unit price in DECIMAL CENTS (e.g. "0.3" = $0.003 per unit), the Stripe unit_amount_decimal model. Derived on read as amount_cents ÷ quantity, so it reconciles with the rounded line amount and, unlike the whole-cent `unit_amount_cents`, never collapses a sub-cent rate to 0. Render with the decimal-aware rate formatter; line amounts/totals stay whole cents.
	UnitAmountDecimal string `json:"unit_amount_decimal,omitempty"`
}

type InvoiceLineType string

type InvoicePaymentStatus string

type InvoiceStatus string

type InvoiceTaxStatus string

type InvoiceWithLineItems struct {
	// Invoice A Velox invoice. Returned from create, finalize, void, list, get,
	// rotate-public-token, and collect-payment endpoints.
	Invoice   Invoice           `json:"invoice"`
	LineItems []InvoiceLineItem `json:"line_items"`
}

type ItemChangeType string

type MarginReport struct {
	ByModel []struct {
		// Attributed True only when a pricing rule pins this model — margin is never heuristically allocated.
		Attributed   bool   `json:"attributed"`
		CostMicros   int64  `json:"cost_micros"`
		Model        string `json:"model"`
		RevenueCents int64  `json:"revenue_cents,omitempty"`
	} `json:"by_model"`
	CacheWriteExcluded bool `json:"cache_write_excluded,omitempty"`

	// CostMicros Total stamped provider cost, micro-dollars.
	CostMicros int64     `json:"cost_micros"`
	CustomerId string    `json:"customer_id"`
	From       time.Time `json:"from"`

	// MarginBps (revenue − cost) / revenue in basis points. Omitted when revenue is 0.
	MarginBps int64 `json:"margin_bps,omitempty"`

	// RevenueCents Total rated usage revenue in the window.
	RevenueCents             int64     `json:"revenue_cents"`
	To                       time.Time `json:"to"`
	UnattributedRevenueCents int64     `json:"unattributed_revenue_cents"`

	// UnresolvedEvents Token events with costable dims but no matching rate — add a rate to cost new events.
	UnresolvedEvents int64 `json:"unresolved_events"`
}

type MemberInvitation struct {
	AcceptedAt     time.Time `json:"accepted_at,omitempty"`
	CreatedAt      time.Time `json:"created_at"`
	Email          string    `json:"email"`
	ExpiresAt      time.Time `json:"expires_at"`
	Id             string    `json:"id"`
	InvitedByEmail string    `json:"invited_by_email,omitempty"`
	RevokedAt      time.Time `json:"revoked_at,omitempty"`

	// Role Recorded for the future role split; not enforced (every member holds the full permission set).
	Role string `json:"role"`

	// Status Server-derived; treat as authoritative.
	Status MemberInvitationStatus `json:"status"`
}

type MemberInvitationStatus string

type Meter struct {
	Aggregation         MeterAggregation `json:"aggregation,omitempty"`
	Id                  string           `json:"id,omitempty"`
	Key                 string           `json:"key,omitempty"`
	Name                string           `json:"name,omitempty"`
	RatingRuleVersionId string           `json:"rating_rule_version_id,omitempty"`
	Unit                string           `json:"unit,omitempty"`
}

type MeterAggregation string

type MiddlewareFunc func(http.Handler) http.Handler

type PatchV1MetersIdJSONBody struct {
	Aggregation PatchV1MetersIdJSONBodyAggregation `json:"aggregation,omitempty"`
	Name        string                             `json:"name,omitempty"`

	// RatingRuleVersionId Default rating rule; empty string clears.
	RatingRuleVersionId string `json:"rating_rule_version_id,omitempty"`
	Unit                string `json:"unit,omitempty"`
}

type PatchV1MetersIdJSONBodyAggregation string

type PatchV1MetersIdJSONRequestBody PatchV1MetersIdJSONBody

type PatchV1WebhookEndpointsEndpointsIdJSONBody struct {
	Active      bool     `json:"active,omitempty"`
	Description string   `json:"description,omitempty"`
	Events      []string `json:"events,omitempty"`
	Url         string   `json:"url,omitempty"`
}

type PatchV1WebhookEndpointsEndpointsIdJSONRequestBody PatchV1WebhookEndpointsEndpointsIdJSONBody

type Plan struct {
	BaseAmountCents int64 `json:"base_amount_cents,omitempty"`

	// BaseBillTiming When the recurring base fee is invoiced relative to the period it covers.
	// in_arrears (default): base + usage billed at period end.
	// in_advance: base billed at period start (day 1 on create; cycle-close invoice
	// carries upcoming period's base + elapsed period's usage). Usage lines are
	// always arrears regardless of this flag. See ADR-031.
	BaseBillTiming  PlanBaseBillTiming  `json:"base_bill_timing,omitempty"`
	BillingInterval PlanBillingInterval `json:"billing_interval,omitempty"`
	Code            string              `json:"code,omitempty"`
	Currency        string              `json:"currency,omitempty"`
	Id              string              `json:"id,omitempty"`
	MeterIds        []string            `json:"meter_ids,omitempty"`
	Name            string              `json:"name,omitempty"`
	Status          PlanStatus          `json:"status,omitempty"`
}

type PlanBaseBillTiming string

type PlanBillingInterval string

type PlanStatus string

type PostV1AuthAcceptInviteJSONBody struct {
	// Password Required (and validated) only when no account exists for the invited email; ignored otherwise.
	Password string `json:"password,omitempty"`
	Token    string `json:"token"`
}

type PostV1AuthAcceptInviteJSONRequestBody PostV1AuthAcceptInviteJSONBody

type PostV1AuthLoginJSONBody struct {
	Email    openapi_types.Email `json:"email"`
	Password string              `json:"password"`
}

type PostV1AuthLoginJSONRequestBody PostV1AuthLoginJSONBody

type PostV1AuthModeJSONBody struct {
	Livemode bool `json:"livemode"`
}

type PostV1AuthModeJSONRequestBody PostV1AuthModeJSONBody

type PostV1AuthPasswordResetConfirmJSONBody struct {
	Password string `json:"password"`
	Token    string `json:"token"`
}

type PostV1AuthPasswordResetConfirmJSONRequestBody PostV1AuthPasswordResetConfirmJSONBody

type PostV1AuthPasswordResetRequest200JSONResponseBodyEmailDelivery string

type PostV1AuthPasswordResetRequestJSONBody struct {
	Email openapi_types.Email `json:"email"`
}

type PostV1AuthPasswordResetRequestJSONRequestBody PostV1AuthPasswordResetRequestJSONBody

type PostV1CreditNotesIdSendJSONBody struct {
	AdditionalEmails []string            `json:"additional_emails,omitempty"`
	Email            openapi_types.Email `json:"email"`
}

type PostV1CreditNotesIdSendJSONRequestBody PostV1CreditNotesIdSendJSONBody

type PostV1CreditNotesJSONBody struct {
	AutoIssue bool `json:"auto_issue,omitempty"`

	// CommitRelief Mutually exclusive with lines/credit_amount_cents.
	CommitRelief struct {
		OutOfBandAmountCents int `json:"out_of_band_amount_cents,omitempty"`

		// RefundAmountCents Optional allocation; must sum with out_of_band to the derived cash.
		RefundAmountCents int `json:"refund_amount_cents,omitempty"`

		// RetireAll Retire the LIVE remaining (absorbs racing drawdowns).
		RetireAll bool `json:"retire_all,omitempty"`

		// RetireCents Commit credits to retire (1..remaining).
		RetireCents int `json:"retire_cents,omitempty"`
	} `json:"commit_relief,omitempty"`
	CreditAmountCents int    `json:"credit_amount_cents,omitempty"`
	InvoiceId         string `json:"invoice_id"`
	Lines             []struct {
		Description     string `json:"description,omitempty"`
		Quantity        int    `json:"quantity,omitempty"`
		UnitAmountCents int    `json:"unit_amount_cents,omitempty"`
	} `json:"lines,omitempty"`
	OutOfBandAmountCents int    `json:"out_of_band_amount_cents,omitempty"`
	Reason               string `json:"reason,omitempty"`
	RefundAmountCents    int    `json:"refund_amount_cents,omitempty"`
}

type PostV1CreditNotesJSONRequestBody PostV1CreditNotesJSONBody

type PostV1CreditsGrantJSONBody struct {
	AmountCents int64  `json:"amount_cents"`
	CustomerId  string `json:"customer_id"`
	Description string `json:"description,omitempty"`

	// ExpiresAt Optional expiry; must be in the future. Omitted = never expires.
	ExpiresAt time.Time `json:"expires_at,omitempty"`

	// GrantKind Optional cost-basis class (ADR-078). `promotional` marks
	// free/marketing credits, drained BEFORE all paid-class
	// blocks. Omitted = unclassified (drains in the paid
	// class). `commit` is reserved for the invoice-finalize
	// funding path and rejected here.
	GrantKind PostV1CreditsGrantJSONBodyGrantKind `json:"grant_kind,omitempty"`
}

type PostV1CreditsGrantJSONBodyGrantKind string

type PostV1CreditsGrantJSONRequestBody PostV1CreditsGrantJSONBody

type PostV1CustomersJSONBody struct {
	AdditionalEmails []string `json:"additional_emails,omitempty"`
	DisplayName      string   `json:"display_name"`
	Email            string   `json:"email,omitempty"`
	ExternalId       string   `json:"external_id"`
}

type PostV1CustomersJSONRequestBody PostV1CustomersJSONBody

type PostV1InvoicesCreatePreviewJSONBody struct {
	// CustomerId Customer to preview the invoice for.
	CustomerId string `json:"customer_id"`

	// Period Optional explicit window. Both bounds must be
	// supplied together; partial windows are rejected.
	// Defaults to the resolved subscription's current
	// cycle.
	Period struct {
		From time.Time `json:"from"`
		To   time.Time `json:"to"`
	} `json:"period,omitempty"`

	// SubscriptionId Optional. Defaults to the customer's primary active
	// subscription if not supplied.
	SubscriptionId string `json:"subscription_id,omitempty"`
}

type PostV1InvoicesCreatePreviewJSONRequestBody PostV1InvoicesCreatePreviewJSONBody

type PostV1InvoicesIdSendJSONBody struct {
	AdditionalEmails []string            `json:"additional_emails,omitempty"`
	Email            openapi_types.Email `json:"email"`
}

type PostV1InvoicesIdSendJSONRequestBody PostV1InvoicesIdSendJSONBody

type PostV1MembersInviteJSONBody struct {
	Email openapi_types.Email `json:"email"`
}

type PostV1MembersInviteJSONRequestBody PostV1MembersInviteJSONBody

type PostV1MetersJSONBody struct {
	Aggregation         PostV1MetersJSONBodyAggregation `json:"aggregation,omitempty"`
	Key                 string                          `json:"key"`
	Name                string                          `json:"name"`
	RatingRuleVersionId string                          `json:"rating_rule_version_id,omitempty"`
	Unit                string                          `json:"unit,omitempty"`
}

type PostV1MetersJSONBodyAggregation string

type PostV1MetersJSONRequestBody PostV1MetersJSONBody

type PostV1PlansJSONBody struct {
	BaseAmountCents int `json:"base_amount_cents,omitempty"`

	// BaseBillTiming Optional. Defaults to in_arrears. See Plan.base_bill_timing
	// for semantics (ADR-031).
	BaseBillTiming  PostV1PlansJSONBodyBaseBillTiming  `json:"base_bill_timing,omitempty"`
	BillingInterval PostV1PlansJSONBodyBillingInterval `json:"billing_interval"`
	Code            string                             `json:"code"`
	Currency        string                             `json:"currency"`
	MeterIds        []string                           `json:"meter_ids,omitempty"`
	Name            string                             `json:"name"`
}

type PostV1PlansJSONBodyBaseBillTiming string

type PostV1PlansJSONBodyBillingInterval string

type PostV1PlansJSONRequestBody PostV1PlansJSONBody

type PostV1RatingRulesJSONBody struct {
	Currency string `json:"currency"`

	// FlatAmountCents Per-unit rate in cents, as a decimal string (e.g. "0.0003" = $3.00 per 1,000,000 units).
	FlatAmountCents string `json:"flat_amount_cents,omitempty"`
	GraduatedTiers  []struct {
		// UnitAmountCents Per-unit rate in cents, as a decimal string.
		UnitAmountCents string `json:"unit_amount_cents,omitempty"`
		UpTo            int    `json:"up_to,omitempty"`
	} `json:"graduated_tiers,omitempty"`
	Mode PostV1RatingRulesJSONBodyMode `json:"mode"`
	Name string                        `json:"name"`

	// OverageUnitAmountCents Package-mode per-unit overage rate in cents, as a decimal string. Fixed fees (package_amount_cents) stay integer cents.
	OverageUnitAmountCents string `json:"overage_unit_amount_cents,omitempty"`
	PackageAmountCents     int    `json:"package_amount_cents,omitempty"`
	PackageSize            int    `json:"package_size,omitempty"`
	RuleKey                string `json:"rule_key"`
}

type PostV1RatingRulesJSONBodyMode string

type PostV1RatingRulesJSONRequestBody PostV1RatingRulesJSONBody

type PostV1SubscriptionsJSONBody struct {
	BillingTime PostV1SubscriptionsJSONBodyBillingTime `json:"billing_time,omitempty"`
	Code        string                                 `json:"code"`
	CustomerId  string                                 `json:"customer_id"`
	DisplayName string                                 `json:"display_name"`

	// Items Plan items — a subscription bills one or more plans.
	Items []struct {
		PlanId   string `json:"plan_id"`
		Quantity int    `json:"quantity,omitempty"`
	} `json:"items"`
	StartNow  bool `json:"start_now,omitempty"`
	TrialDays int  `json:"trial_days,omitempty"`
}

type PostV1SubscriptionsJSONBodyBillingTime string

type PostV1SubscriptionsJSONRequestBody PostV1SubscriptionsJSONBody

type PostV1TestClocksIdAdvanceJSONBody struct {
	FrozenTime time.Time `json:"frozen_time"`
}

type PostV1TestClocksIdAdvanceJSONRequestBody PostV1TestClocksIdAdvanceJSONBody

type PostV1TestClocksJSONBody struct {
	FrozenTime time.Time `json:"frozen_time"`
	Name       string    `json:"name,omitempty"`
}

type PostV1TestClocksJSONRequestBody PostV1TestClocksJSONBody

type PostV1UsageEventsBatchJSONBody = []struct {
	Dimensions map[string]interface{} `json:"dimensions,omitempty"`

	// EventName The meter key (e.g. "tokens").
	EventName string `json:"event_name"`

	// ExternalCustomerId The customer's external_id (your identifier), not the internal vlx_cus_ id.
	ExternalCustomerId string `json:"external_customer_id"`
	IdempotencyKey     string `json:"idempotency_key,omitempty"`

	// Quantity Decimal quantity — accepts a JSON number (5) or string ("5.5") for exact fractional values.
	Quantity  PostV1UsageEventsBatchJSONBody_Quantity `json:"quantity"`
	Timestamp time.Time                               `json:"timestamp,omitempty"`
}

type PostV1UsageEventsBatchJSONBodyQuantity0 = float32

type PostV1UsageEventsBatchJSONBodyQuantity1 = string

type PostV1UsageEventsBatchJSONBody_Quantity struct {
	// contains filtered or unexported fields
}

type PostV1UsageEventsBatchJSONRequestBody = PostV1UsageEventsBatchJSONBody

type PostV1UsageEventsJSONBody struct {
	// Dimensions Scalar dimension values used for pricing-rule dispatch (e.g. {"model", "token_type"}).
	Dimensions map[string]interface{} `json:"dimensions,omitempty"`

	// EventName The meter key (e.g. "tokens").
	EventName string `json:"event_name"`

	// ExternalCustomerId The customer's external_id (your identifier), not the internal vlx_cus_ id.
	ExternalCustomerId string                 `json:"external_customer_id"`
	IdempotencyKey     string                 `json:"idempotency_key,omitempty"`
	Properties         map[string]interface{} `json:"properties,omitempty"`

	// Quantity Decimal quantity — accepts a JSON number (5) or string ("5.5") for exact fractional values.
	Quantity  PostV1UsageEventsJSONBody_Quantity `json:"quantity"`
	Timestamp time.Time                          `json:"timestamp,omitempty"`
}

type PostV1UsageEventsJSONBodyQuantity0 = float32

type PostV1UsageEventsJSONBodyQuantity1 = string

type PostV1UsageEventsJSONBody_Quantity struct {
	// contains filtered or unexported fields
}

type PostV1UsageEventsJSONRequestBody PostV1UsageEventsJSONBody

type PostV1WebhookEndpointsEndpointsJSONBody struct {
	Description string   `json:"description,omitempty"`
	Events      []string `json:"events,omitempty"`
	Url         string   `json:"url"`
}

type PostV1WebhookEndpointsEndpointsJSONRequestBody PostV1WebhookEndpointsEndpointsJSONBody

type PreviewRecipeJSONBody struct {
	Overrides map[string]interface{} `json:"overrides,omitempty"`
}

type PreviewRecipeJSONRequestBody PreviewRecipeJSONBody

type ProviderCostRate struct {
	// CostPerToken Decimal dollars per token.
	CostPerToken string    `json:"cost_per_token"`
	CreatedAt    time.Time `json:"created_at,omitempty"`
	Currency     string    `json:"currency"`
	Id           string    `json:"id"`
	Model        string    `json:"model"`
	Provider     string    `json:"provider"`
	TokenType    string    `json:"token_type"`
	UpdatedAt    time.Time `json:"updated_at,omitempty"`
}

type PutV1ProviderCostsJSONBody struct {
	// CostPerToken Decimal dollars per token (e.g. "0.000003").
	CostPerToken string `json:"cost_per_token"`
	Currency     string `json:"currency,omitempty"`

	// Model Model family token or raw snapshot id — raw ids match first at ingest.
	Model    string `json:"model"`
	Provider string `json:"provider"`

	// TokenType ADR-044 role — input / output / cache_read.
	TokenType string `json:"token_type"`
}

type PutV1ProviderCostsJSONRequestBody PutV1ProviderCostsJSONBody

type RatingRule struct {
	Currency string `json:"currency,omitempty"`

	// FlatAmountCents Per-unit rate in cents, as a decimal string (e.g. "0.0003" = $3.00 per 1,000,000 units). Arbitrary precision; invoice line amounts and totals still round to whole cents.
	FlatAmountCents string `json:"flat_amount_cents,omitempty"`
	GraduatedTiers  []struct {
		// UnitAmountCents Per-unit rate in cents, as a decimal string (see flat_amount_cents).
		UnitAmountCents string `json:"unit_amount_cents,omitempty"`
		UpTo            int    `json:"up_to,omitempty"`
	} `json:"graduated_tiers,omitempty"`
	Id      string         `json:"id,omitempty"`
	Mode    RatingRuleMode `json:"mode,omitempty"`
	Name    string         `json:"name,omitempty"`
	RuleKey string         `json:"rule_key,omitempty"`
	Version int            `json:"version,omitempty"`
}

type RatingRuleMode string

type Recipe struct {
	Description   string              `json:"description,omitempty"`
	DunningPolicy RecipeDunningPolicy `json:"dunning_policy,omitempty"`
	Key           string              `json:"key"`
	Meters        []RecipeMeter       `json:"meters"`
	Name          string              `json:"name"`
	Overridable   []RecipeOverride    `json:"overridable"`
	Plans         []RecipePlan        `json:"plans"`
	PricingRules  []RecipePricingRule `json:"pricing_rules"`
	RatingRules   []RecipeRatingRule  `json:"rating_rules"`
	Summary       string              `json:"summary"`
	Version       string              `json:"version"`
	Webhook       RecipeWebhook       `json:"webhook,omitempty"`
}

type RecipeCreatedObjects struct {
	DunningPolicyId   string   `json:"dunning_policy_id,omitempty"`
	MeterIds          []string `json:"meter_ids,omitempty"`
	PlanIds           []string `json:"plan_ids,omitempty"`
	PricingRuleIds    []string `json:"pricing_rule_ids,omitempty"`
	RatingRuleIds     []string `json:"rating_rule_ids,omitempty"`
	WebhookEndpointId string   `json:"webhook_endpoint_id,omitempty"`
}

type RecipeCreates struct {
	DunningPolicies  int `json:"dunning_policies"`
	Meters           int `json:"meters"`
	Plans            int `json:"plans"`
	PricingRules     int `json:"pricing_rules"`
	RatingRules      int `json:"rating_rules"`
	WebhookEndpoints int `json:"webhook_endpoints"`
}

type RecipeDetail struct {
	// Creates Per-role count of objects a recipe will produce when instantiated. Recipes create no product entity — there is no `products` count.
	Creates       RecipeCreates       `json:"creates"`
	Description   string              `json:"description,omitempty"`
	DunningPolicy RecipeDunningPolicy `json:"dunning_policy,omitempty"`
	Key           string              `json:"key"`
	Meters        []RecipeMeter       `json:"meters"`
	Name          string              `json:"name"`
	Overridable   []RecipeOverride    `json:"overridable"`
	Plans         []RecipePlan        `json:"plans"`
	PricingRules  []RecipePricingRule `json:"pricing_rules"`
	RatingRules   []RecipeRatingRule  `json:"rating_rules"`
	Summary       string              `json:"summary"`
	Version       string              `json:"version"`
	Webhook       RecipeWebhook       `json:"webhook,omitempty"`
}

type RecipeDunningPolicy struct {
	// FinalInvoiceAction What exhausting all retries does to the unpaid invoice. `mark_uncollectible` writes it off as bad debt — the receivable closes, the invoice stays on the books for audit, and it remains settleable out of band. `none` leaves it finalized and due, which means it stays open until a human closes or collects it.
	// Independent of `final_subscription_action` (ADR-112): the two were one enum until 2026-08-05, which made "cancel and write off" inexpressible.
	FinalInvoiceAction RecipeDunningPolicyFinalInvoiceAction `json:"final_invoice_action"`

	// FinalSubscriptionAction What exhausting all retries does to the subscription behind the unpaid invoice. `pause` pauses collection only (the cycle keeps drafting invoices); `cancel` cancels the subscription. No-op on a one-off invoice, which has no subscription.
	FinalSubscriptionAction RecipeDunningPolicyFinalSubscriptionAction `json:"final_subscription_action"`
	IntervalsHours          []int                                      `json:"intervals_hours"`
	MaxRetries              int                                        `json:"max_retries"`
	Name                    string                                     `json:"name"`
}

type RecipeDunningPolicyFinalInvoiceAction string

type RecipeDunningPolicyFinalSubscriptionAction string

type RecipeInstance struct {
	CreatedAt time.Time `json:"created_at"`

	// CreatedBy Operator email or API key ID. Omitted when empty.
	CreatedBy string `json:"created_by,omitempty"`

	// CreatedObjects Per-role map of entity IDs a recipe apply produced (including ADOPTED catalog objects — apply reconnects to an existing meter/rule graph rather than duplicating it, ADR-085). Every field is omitted when empty; clients must guard reads.
	CreatedObjects RecipeCreatedObjects   `json:"created_objects"`
	Id             string                 `json:"id"`
	Overrides      map[string]interface{} `json:"overrides"`
	RecipeKey      string                 `json:"recipe_key"`
	RecipeVersion  string                 `json:"recipe_version"`

	// TenantId Omitted when empty.
	TenantId string `json:"tenant_id,omitempty"`
}

type RecipeListItem struct {
	// Creates Per-role count of objects a recipe will produce when instantiated. Recipes create no product entity — there is no `products` count.
	Creates       RecipeCreates       `json:"creates"`
	Description   string              `json:"description,omitempty"`
	DunningPolicy RecipeDunningPolicy `json:"dunning_policy,omitempty"`

	// Instantiated The install badge: the record of a recipe being applied for a tenant (scoped per livemode since m0157). Field names are `recipe_key` / `recipe_version` — NOT `key`/`version`, which the recipe template itself uses.
	Instantiated RecipeInstance      `json:"instantiated,omitempty"`
	Key          string              `json:"key"`
	Meters       []RecipeMeter       `json:"meters"`
	Name         string              `json:"name"`
	Overridable  []RecipeOverride    `json:"overridable"`
	Plans        []RecipePlan        `json:"plans"`
	PricingRules []RecipePricingRule `json:"pricing_rules"`
	RatingRules  []RecipeRatingRule  `json:"rating_rules"`
	Summary      string              `json:"summary"`
	Version      string              `json:"version"`
	Webhook      RecipeWebhook       `json:"webhook,omitempty"`
}

type RecipeMeter struct {
	Aggregation string `json:"aggregation"`
	Key         string `json:"key"`
	Name        string `json:"name"`
	Unit        string `json:"unit"`
}

type RecipeOverride struct {
	// Default Default value applied when the override is not supplied.
	Default   interface{}        `json:"default"`
	Enum      []string           `json:"enum,omitempty"`
	Key       string             `json:"key"`
	MaxLength int                `json:"max_length,omitempty"`
	Pattern   string             `json:"pattern,omitempty"`
	Type      RecipeOverrideType `json:"type"`
}

type RecipeOverrideType string

type RecipePlan struct {
	BaseAmountCents int64 `json:"base_amount_cents"`

	// BaseBillTiming Optional; empty defaults to in_arrears at plan creation (ADR-031).
	BaseBillTiming  RecipePlanBaseBillTiming  `json:"base_bill_timing,omitempty"`
	BillingInterval RecipePlanBillingInterval `json:"billing_interval"`
	Code            string                    `json:"code"`
	Currency        string                    `json:"currency"`
	MeterKeys       []string                  `json:"meter_keys"`
	Name            string                    `json:"name"`
}

type RecipePlanBaseBillTiming string

type RecipePlanBillingInterval string

type RecipePreviewObjects struct {
	DunningPolicies  []RecipeDunningPolicy `json:"dunning_policies"`
	Meters           []RecipeMeter         `json:"meters"`
	Plans            []RecipePlan          `json:"plans"`
	PricingRules     []RecipePricingRule   `json:"pricing_rules"`
	RatingRules      []RecipeRatingRule    `json:"rating_rules"`
	WebhookEndpoints []RecipeWebhook       `json:"webhook_endpoints"`
}

type RecipePreviewResult struct {
	Key string `json:"key"`

	// Objects Would-be-created object graph, grouped by role. All arrays are always present (possibly empty); optional singletons (dunning, webhook) are emitted as 0-or-1-length arrays so clients iterate without null guards.
	Objects  RecipePreviewObjects `json:"objects"`
	Version  string               `json:"version"`
	Warnings []string             `json:"warnings"`
}

type RecipePricingRule struct {
	AggregationMode RecipePricingRuleAggregationMode `json:"aggregation_mode"`
	DimensionMatch  map[string]interface{}           `json:"dimension_match"`
	MeterKey        string                           `json:"meter_key"`
	Priority        int                              `json:"priority"`
	RatingRuleKey   string                           `json:"rating_rule_key"`
}

type RecipePricingRuleAggregationMode string

type RecipeRatingRule struct {
	Currency string `json:"currency"`

	// FlatAmountCents Per-unit rate in cents, as a decimal string (see RatingRule.flat_amount_cents).
	FlatAmountCents string `json:"flat_amount_cents"`
	GraduatedTiers  []struct {
		// UnitAmountCents Per-unit rate in cents, as a decimal string.
		UnitAmountCents string `json:"unit_amount_cents,omitempty"`
		UpTo            int    `json:"up_to,omitempty"`
	} `json:"graduated_tiers,omitempty"`
	Key  string               `json:"key"`
	Mode RecipeRatingRuleMode `json:"mode"`
	Name string               `json:"name,omitempty"`

	// OverageUnitAmountCents Per-unit overage rate in cents, as a decimal string.
	OverageUnitAmountCents string `json:"overage_unit_amount_cents"`
	PackageAmountCents     int64  `json:"package_amount_cents,omitempty"`
	PackageSize            int64  `json:"package_size,omitempty"`
}

type RecipeRatingRuleMode string

type RecipeWebhook struct {
	Events         []string `json:"events"`
	UrlPlaceholder string   `json:"url_placeholder"`
}

type RecoveryWarning struct {
	// Blocked Always false — this shape only ever warns.
	Blocked bool                `json:"blocked"`
	Code    RecoveryWarningCode `json:"code,omitempty"`

	// Message Operator-facing sentence naming the consequence that will go unreconciled if the payment is recorded.
	Message string `json:"message,omitempty"`
}

type RecoveryWarningCode string

type RequiredHeaderError struct {
	ParamName string
	Err       error
}

type RequiredParamError struct {
	ParamName string
}

type ServerInterface interface {
	// Health check
	// (GET /health)
	GetHealth(w http.ResponseWriter, r *http.Request)
	// Accept a team invitation
	// (POST /v1/auth/accept-invite)
	PostV1AuthAcceptInvite(w http.ResponseWriter, r *http.Request)
	// Preview a team invitation (accept-page context)
	// (GET /v1/auth/invite/{token})
	GetV1AuthInviteToken(w http.ResponseWriter, r *http.Request, token string)
	// Sign in with email and password; mint an httpOnly session cookie
	// (POST /v1/auth/login)
	PostV1AuthLogin(w http.ResponseWriter, r *http.Request)
	// Revoke the current session and clear the cookie
	// (POST /v1/auth/logout)
	PostV1AuthLogout(w http.ResponseWriter, r *http.Request)
	// Switch the dashboard session between test and live mode
	// (POST /v1/auth/mode)
	PostV1AuthMode(w http.ResponseWriter, r *http.Request)
	// Set a new password using a reset token
	// (POST /v1/auth/password-reset/confirm)
	PostV1AuthPasswordResetConfirm(w http.ResponseWriter, r *http.Request)
	// Request a password reset link
	// (POST /v1/auth/password-reset/request)
	PostV1AuthPasswordResetRequest(w http.ResponseWriter, r *http.Request)
	// Invoice preview (dry run)
	// (GET /v1/billing/preview/{subscription_id})
	GetV1BillingPreviewSubscriptionId(w http.ResponseWriter, r *http.Request, subscriptionId string)
	// Trigger billing cycle
	// (POST /v1/billing/run)
	PostV1BillingRun(w http.ResponseWriter, r *http.Request)
	// Create a credit note (line-based, or commit relief)
	// (POST /v1/credit-notes)
	PostV1CreditNotes(w http.ResponseWriter, r *http.Request)
	// Email the credit-note document (PDF attached)
	// (POST /v1/credit-notes/{id}/send)
	PostV1CreditNotesIdSend(w http.ResponseWriter, r *http.Request, id string)
	// Get customer credit balance
	// (GET /v1/credits/balance/{customer_id})
	GetV1CreditsBalanceCustomerId(w http.ResponseWriter, r *http.Request, customerId string)
	// Grant credits to customer
	// (POST /v1/credits/grant)
	PostV1CreditsGrant(w http.ResponseWriter, r *http.Request)
	// Per-grant burndown + kind subtotals
	// (GET /v1/credits/grants/{customer_id})
	GetV1CreditsGrantsCustomerId(w http.ResponseWriter, r *http.Request, customerId string, params GetV1CreditsGrantsCustomerIdParams)
	// List customers
	// (GET /v1/customers)
	GetV1Customers(w http.ResponseWriter, r *http.Request, params GetV1CustomersParams)
	// Create customer
	// (POST /v1/customers)
	PostV1Customers(w http.ResponseWriter, r *http.Request)
	// Per-customer margin report (operator only)
	// (GET /v1/customers/{id}/margin)
	GetV1CustomersIdMargin(w http.ResponseWriter, r *http.Request, id string, params GetV1CustomersIdMarginParams)
	// Rotate the public cost-dashboard token (ADR-032)
	// (POST /v1/customers/{id}/rotate-cost-dashboard-token)
	PostV1CustomersIdRotateCostDashboardToken(w http.ResponseWriter, r *http.Request, id string)
	// List invoices
	// (GET /v1/invoices)
	GetV1Invoices(w http.ResponseWriter, r *http.Request, params GetV1InvoicesParams)
	// Preview the next invoice for a customer (Stripe-equivalent)
	// (POST /v1/invoices/create_preview)
	PostV1InvoicesCreatePreview(w http.ResponseWriter, r *http.Request)
	// Get invoice with line items
	// (GET /v1/invoices/{id})
	GetInvoice(w http.ResponseWriter, r *http.Request, id string)
	// Finalize draft invoice
	// (POST /v1/invoices/{id}/finalize)
	PostV1InvoicesIdFinalize(w http.ResponseWriter, r *http.Request, id string)
	// Download invoice PDF
	// (GET /v1/invoices/{id}/pdf)
	GetV1InvoicesIdPdf(w http.ResponseWriter, r *http.Request, id string)
	// Retry tax calculation on a deferred invoice
	// (POST /v1/invoices/{id}/retry-tax)
	PostV1InvoicesIdRetryTax(w http.ResponseWriter, r *http.Request, id string)
	// Email the invoice (PDF attached) to a recipient
	// (POST /v1/invoices/{id}/send)
	PostV1InvoicesIdSend(w http.ResponseWriter, r *http.Request, id string)
	// List workspace members and invitations
	// (GET /v1/members/)
	GetV1Members(w http.ResponseWriter, r *http.Request)
	// Revoke a pending invitation
	// (DELETE /v1/members/invitations/{id})
	DeleteV1MembersInvitationsId(w http.ResponseWriter, r *http.Request, id string)
	// Invite a teammate by email
	// (POST /v1/members/invite)
	PostV1MembersInvite(w http.ResponseWriter, r *http.Request)
	// Remove a member from the workspace
	// (DELETE /v1/members/{user_id})
	DeleteV1MembersUserId(w http.ResponseWriter, r *http.Request, userId string)
	// List meters
	// (GET /v1/meters)
	GetV1Meters(w http.ResponseWriter, r *http.Request)
	// Create meter
	// (POST /v1/meters)
	PostV1Meters(w http.ResponseWriter, r *http.Request)
	// Update meter (incl. the default rating-rule binding)
	// (PATCH /v1/meters/{id})
	PatchV1MetersId(w http.ResponseWriter, r *http.Request, id string)
	// List plans
	// (GET /v1/plans)
	GetV1Plans(w http.ResponseWriter, r *http.Request)
	// Create plan
	// (POST /v1/plans)
	PostV1Plans(w http.ResponseWriter, r *http.Request)
	// List provider cost rates
	// (GET /v1/provider-costs)
	GetV1ProviderCosts(w http.ResponseWriter, r *http.Request)
	// Create or update a provider cost rate
	// (PUT /v1/provider-costs)
	PutV1ProviderCosts(w http.ResponseWriter, r *http.Request)
	// Delete a provider cost rate
	// (DELETE /v1/provider-costs/{id})
	DeleteV1ProviderCostsId(w http.ResponseWriter, r *http.Request, id string)
	// Public cost-dashboard projection (ADR-032)
	// (GET /v1/public/cost-dashboard/{token})
	GetV1PublicCostDashboardToken(w http.ResponseWriter, r *http.Request, token string)
	// List rating rules
	// (GET /v1/rating-rules)
	GetV1RatingRules(w http.ResponseWriter, r *http.Request)
	// Create rating rule
	// (POST /v1/rating-rules)
	PostV1RatingRules(w http.ResponseWriter, r *http.Request)
	// List recipes
	// (GET /v1/recipes)
	ListRecipes(w http.ResponseWriter, r *http.Request)
	// List installed recipe instances
	// (GET /v1/recipes/instances)
	ListRecipeInstances(w http.ResponseWriter, r *http.Request)
	// Get recipe
	// (GET /v1/recipes/{key})
	GetRecipe(w http.ResponseWriter, r *http.Request, key string)
	// Instantiate recipe (idempotent apply)
	// (POST /v1/recipes/{key}/instantiate)
	InstantiateRecipe(w http.ResponseWriter, r *http.Request, key string)
	// Preview recipe
	// (POST /v1/recipes/{key}/preview)
	PreviewRecipe(w http.ResponseWriter, r *http.Request, key string)
	// List subscriptions
	// (GET /v1/subscriptions)
	GetV1Subscriptions(w http.ResponseWriter, r *http.Request, params GetV1SubscriptionsParams)
	// Create subscription
	// (POST /v1/subscriptions)
	PostV1Subscriptions(w http.ResponseWriter, r *http.Request)
	// Activate draft subscription
	// (POST /v1/subscriptions/{id}/activate)
	PostV1SubscriptionsIdActivate(w http.ResponseWriter, r *http.Request, id string)
	// List test clocks for the active tenant
	// (GET /v1/test-clocks)
	GetV1TestClocks(w http.ResponseWriter, r *http.Request)
	// Create a test clock
	// (POST /v1/test-clocks)
	PostV1TestClocks(w http.ResponseWriter, r *http.Request)
	// Delete a test clock (cascades to pinned subscriptions)
	// (DELETE /v1/test-clocks/{id})
	DeleteV1TestClocksId(w http.ResponseWriter, r *http.Request, id string)
	// Get a test clock by id
	// (GET /v1/test-clocks/{id})
	GetV1TestClocksId(w http.ResponseWriter, r *http.Request, id string)
	// Advance the clock to a new frozen_time
	// (POST /v1/test-clocks/{id}/advance)
	PostV1TestClocksIdAdvance(w http.ResponseWriter, r *http.Request, id string)
	// Retry catchup on a clock parked in internal_failure
	// (POST /v1/test-clocks/{id}/retry-advance)
	PostV1TestClocksIdRetryAdvance(w http.ResponseWriter, r *http.Request, id string)
	// List subscriptions pinned to this clock
	// (GET /v1/test-clocks/{id}/subscriptions)
	GetV1TestClocksIdSubscriptions(w http.ResponseWriter, r *http.Request, id string)
	// List usage events
	// (GET /v1/usage-events)
	GetV1UsageEvents(w http.ResponseWriter, r *http.Request, params GetV1UsageEventsParams)
	// Ingest usage event
	// (POST /v1/usage-events)
	PostV1UsageEvents(w http.ResponseWriter, r *http.Request)
	// Batch ingest usage events (max 1000, all-or-nothing)
	// (POST /v1/usage-events/batch)
	PostV1UsageEventsBatch(w http.ResponseWriter, r *http.Request)
	// List webhook endpoints
	// (GET /v1/webhook-endpoints/endpoints)
	GetV1WebhookEndpointsEndpoints(w http.ResponseWriter, r *http.Request)
	// Create webhook endpoint
	// (POST /v1/webhook-endpoints/endpoints)
	PostV1WebhookEndpointsEndpoints(w http.ResponseWriter, r *http.Request)
	// Delete (disable) webhook endpoint
	// (DELETE /v1/webhook-endpoints/endpoints/{id})
	DeleteV1WebhookEndpointsEndpointsId(w http.ResponseWriter, r *http.Request, id string)
	// Update webhook endpoint (no secret rotation)
	// (PATCH /v1/webhook-endpoints/endpoints/{id})
	PatchV1WebhookEndpointsEndpointsId(w http.ResponseWriter, r *http.Request, id string)
	// Rotate signing secret (72h dual-signing grace)
	// (POST /v1/webhook-endpoints/endpoints/{id}/rotate-secret)
	PostV1WebhookEndpointsEndpointsIdRotateSecret(w http.ResponseWriter, r *http.Request, id string)
	// List recent outbound events (newest 50)
	// (GET /v1/webhook-endpoints/events)
	GetV1WebhookEndpointsEvents(w http.ResponseWriter, r *http.Request)
	// Resolve the current credential to its tenant context
	// (GET /v1/whoami)
	GetV1Whoami(w http.ResponseWriter, r *http.Request)
}

type ServerInterfaceWrapper struct {
	Handler            ServerInterface
	HandlerMiddlewares []MiddlewareFunc
	ErrorHandlerFunc   func(w http.ResponseWriter, r *http.Request, err error)
}

type Subscription struct {
	BillingTime  SubscriptionBillingTime `json:"billing_time,omitempty"`
	Code         string                  `json:"code,omitempty"`
	CustomerId   string                  `json:"customer_id,omitempty"`
	DisplayName  string                  `json:"display_name,omitempty"`
	Id           string                  `json:"id,omitempty"`
	PlanId       string                  `json:"plan_id,omitempty"`
	Status       SubscriptionStatus      `json:"status,omitempty"`
	TrialEndAt   time.Time               `json:"trial_end_at,omitempty"`
	TrialStartAt time.Time               `json:"trial_start_at,omitempty"`
}

type SubscriptionBillingTime string

type SubscriptionStatus string

type TooManyValuesForParamError struct {
	ParamName string
	Count     int
}

type UnescapedCookieParamError struct {
	ParamName string
	Err       error
}

type Unimplemented struct{}

type UnmarshalingParamError struct {
	ParamName string
	Err       error
}

type UsageEvent struct {
	CustomerId     string                 `json:"customer_id,omitempty"`
	Id             string                 `json:"id,omitempty"`
	IdempotencyKey string                 `json:"idempotency_key,omitempty"`
	MeterId        string                 `json:"meter_id,omitempty"`
	Properties     map[string]interface{} `json:"properties,omitempty"`
	Quantity       int64                  `json:"quantity,omitempty"`
	Timestamp      time.Time              `json:"timestamp,omitempty"`
}