@openrails/billing-ui 0.0.0-stage → 0.233.2

package/dist/account/cancel-dialog.d.ts

@@ -0,0 +1,18 @@
+import { CheckoutAppearance } from '../appearance';
+import { BillingError } from '../client/errors';
+import { SubscriptionAction } from '../react/hooks';
+import * as React from "react";
+export interface CancelSubscriptionDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Subscription display name. */
+    name: string;
+    /** On-chain (Solana) cancel: the wallet signs after the reason. */
+    onChain?: boolean;
+    /** In-flight stage, when cancelling. */
+    pending?: SubscriptionAction;
+    /** Resolves null on success; the dialog then closes. */
+    onConfirm: (reason: string) => Promise<BillingError | null>;
+    appearance?: CheckoutAppearance;
+}
+export declare function CancelSubscriptionDialog({ open, onOpenChange, name, onChain, pending, onConfirm, appearance, }: CancelSubscriptionDialogProps): React.JSX.Element;

package/dist/account/change-card-dialog.d.ts

@@ -0,0 +1,14 @@
+import { CheckoutAppearance } from '../appearance';
+import { BillingError } from '../client/errors';
+import { Subscription } from '../client/types';
+import * as React from "react";
+export interface ChangeCardDialogProps {
+    subscription: Subscription | null;
+    name: string;
+    onOpenChange: (open: boolean) => void;
+    pending: boolean;
+    /** Resolves null on success; the dialog then closes. */
+    onConfirm: (paymentMethodId: string) => Promise<BillingError | null>;
+    appearance?: CheckoutAppearance;
+}
+export declare function ChangeCardDialog({ subscription, name, onOpenChange, pending, onConfirm, appearance, }: ChangeCardDialogProps): React.JSX.Element;

package/dist/account/format.d.ts

@@ -0,0 +1,25 @@
+import { CardSummary, CurrencyScales, Payment, Price, Subscription } from '../client/types';
+import { Translator } from '../i18n/messages';
+export declare function formatDate(value: string | null | undefined, locale?: string): string | null;
+/** Exact money, or null while the currency's scale is unknown. */
+export declare function formatMoney(amount: string | null | undefined, currency: string, scales: CurrencyScales, locale?: string): string | null;
+/** "every 30 days", "30 days of access" or "one-time". */
+export declare function intervalLabel(price: Pick<Price, "access_duration_hours" | "billing_interval_hours"> | null | undefined, m: Translator): string | null;
+export declare function subscriptionName(s: Subscription, { t }: Translator): string;
+/** What a payment bought: the product's name, else its kind, plus its cadence. */
+export declare function paymentItem(p: Payment, m: Translator): {
+    name: string;
+    detail: string | null;
+};
+export declare function brandName(brand: string | null | undefined, fallback: string): string;
+/** "Visa •••• 4242 · 12/30"; the brand alone when no digits are known. */
+export declare function cardText(card: CardSummary | null | undefined, m: Translator): string;
+export declare function expiry(card: CardSummary | null | undefined): string | null;
+export declare const LIVE_STATUSES: Set<string>;
+/** A current subscription, or a canceled subscription retaining paid access. */
+export declare const isLive: (s: Subscription) => boolean;
+/** Future billing has stopped or cancellation is scheduled. */
+export declare const isEnding: (s: Subscription) => boolean;
+export type StatusTone = "success" | "warning" | "destructive" | "neutral";
+export declare const statusTone: (status: string) => StatusTone;
+export declare const RESET = "[&_h2]:m-0 [&_p]:m-0 [&_ul]:m-0 [&_ul]:list-none [&_ul]:p-0 [&_table]:border-spacing-0";

package/dist/account/notice.d.ts

@@ -0,0 +1,3 @@
+import * as React from "react";
+/** Polite confirmation line that clears itself. */
+export declare function useNotice(): [React.ReactNode, (text: string) => void];

package/dist/account/payment-history.d.ts

@@ -0,0 +1,8 @@
+import { CheckoutAppearance } from '../appearance';
+import { PaymentsOptions } from '../react/hooks';
+import * as React from "react";
+export interface PaymentHistoryProps extends PaymentsOptions {
+    appearance?: CheckoutAppearance;
+    className?: string;
+}
+export declare function PaymentHistory({ appearance, className, ...options }: PaymentHistoryProps): React.JSX.Element;

package/dist/account/payment-methods-panel.d.ts

@@ -0,0 +1,17 @@
+import { CheckoutAppearance } from '../appearance';
+import * as React from "react";
+export interface PaymentMethodsPanelProps {
+    /** Return target after off-page card verification; see `SavePaymentMethod`. */
+    cardSetupReturnURL?: (setupId: string) => string;
+    /** Offers to make a card the one that collects this currency's invoices. */
+    collectionCurrency?: string;
+    /** Billing country to preselect when adding a card. */
+    defaultCountry?: string;
+    appearance?: CheckoutAppearance;
+    className?: string;
+}
+/**
+ * The customer's saved cards. "Add card" offers each PSP of the merchant's
+ * payment setup (`GET /config`) that saves a card in the page.
+ */
+export declare function PaymentMethodsPanel({ cardSetupReturnURL, collectionCurrency, defaultCountry, appearance, className, }: PaymentMethodsPanelProps): React.JSX.Element;

package/dist/account/section.d.ts

@@ -0,0 +1,27 @@
+import { CheckoutAppearance } from '../appearance';
+import { BillingError } from '../client/errors';
+import * as React from "react";
+export interface SectionProps {
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+    appearance?: CheckoutAppearance;
+    className?: string;
+    children?: React.ReactNode;
+    "data-testid"?: string;
+}
+export declare function Section({ title, description, action, appearance, className, children, ...rest }: SectionProps): React.JSX.Element;
+export declare function ListSkeleton({ rows }: {
+    rows?: number;
+}): React.JSX.Element;
+export declare function EmptyState({ title, description, action, }: {
+    title: string;
+    description?: string;
+    action?: React.ReactNode;
+}): React.JSX.Element;
+export declare function ErrorState({ error, message, onRetry, }: {
+    error: BillingError;
+    /** Replaces the error's own message. */
+    message?: string;
+    onRetry: () => void;
+}): React.JSX.Element;

package/dist/account/status-badge.d.ts

@@ -0,0 +1,8 @@
+export interface BillingStatusBadgeProps {
+    /** Subscription, payment or card-health status. */
+    status: string;
+    /** Overrides the translated label. */
+    label?: string;
+    className?: string;
+}
+export declare function BillingStatusBadge({ status, label, className, }: BillingStatusBadgeProps): import("react").JSX.Element;

package/dist/account/subscriptions-panel.d.ts

@@ -0,0 +1,19 @@
+import { CheckoutAppearance } from '../appearance';
+import { SendSolanaTransaction } from '../client/client';
+import { Subscription } from '../client/types';
+import { SubscriptionsOptions } from '../react/hooks';
+import * as React from "react";
+export interface SubscriptionsPanelProps extends SubscriptionsOptions {
+    /**
+     * Wallet for Solana-rail subscriptions. Without it their cancel action is
+     * hidden.
+     */
+    sendSolanaTransaction?: SendSolanaTransaction;
+    /** Empty-state link to the host's plans page (uses `navigate` if set). */
+    plansHref?: string;
+    /** Host content under a row, e.g. a plan-change control. */
+    renderSubscriptionFooter?: (subscription: Subscription) => React.ReactNode;
+    appearance?: CheckoutAppearance;
+    className?: string;
+}
+export declare function SubscriptionsPanel({ sendSolanaTransaction, plansHref, renderSubscriptionFooter, appearance, className, ...options }: SubscriptionsPanelProps): React.JSX.Element;

package/dist/appearance.d.ts

@@ -0,0 +1,23 @@
+import { CSSProperties } from 'react';
+export type CheckoutTheme = "light" | "dark" | "auto" | "inherit";
+export interface CheckoutVariables {
+    background?: string;
+    foreground?: string;
+    card?: string;
+    mutedForeground?: string;
+    faintForeground?: string;
+    border?: string;
+    input?: string;
+    primary?: string;
+    primaryForeground?: string;
+    destructive?: string;
+    ring?: string;
+    radius?: string;
+    fontFamily?: string;
+}
+export interface CheckoutAppearance {
+    theme?: CheckoutTheme;
+    variables?: CheckoutVariables;
+}
+export declare function appearanceStyle(appearance: CheckoutAppearance | undefined): CSSProperties | undefined;
+export declare function appearanceTheme(appearance: CheckoutAppearance | undefined): CheckoutTheme;

package/dist/authenticate.d.ts

@@ -0,0 +1,8 @@
+import { BillingClient } from './client/client';
+import { PspConfig } from './psp';
+/**
+ * Completes the provider challenge (3-D Secure) a pending payment operation
+ * waits on. "not_required" when the provider has none outstanding; the
+ * operation's own status remains the result.
+ */
+export declare function authenticatePayment(client: BillingClient, operationId: string, psp: PspConfig): Promise<"authenticated" | "not_required">;

package/dist/checkout-frame.d.ts

@@ -0,0 +1,17 @@
+import { CheckoutFrameTheme } from './frame';
+import { CheckoutSessionStatus } from './types';
+import * as React from "react";
+export interface CheckoutFrameProps {
+    /** The minted session's `url` (createCheckoutSession). */
+    url: string;
+    onComplete?: (status: CheckoutSessionStatus) => void;
+    /** Default "auto": the buyer's system preference. */
+    theme?: CheckoutFrameTheme;
+    /** Accessible name of the frame. */
+    title?: string;
+    /** Height before the page reports its own, in pixels. Default 480. */
+    minHeight?: number;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare function CheckoutFrame({ url, onComplete, theme, title, minHeight, className, style, }: CheckoutFrameProps): React.JSX.Element | null;

package/dist/checkout-page.d.ts

@@ -0,0 +1,21 @@
+import { CheckoutAppearance } from './appearance';
+import { CheckoutLayout } from './checkout';
+import { BillingClient } from './client/client';
+import * as React from "react";
+export interface CheckoutPageProps {
+    /** OpenRails mount on this host. Default "/billing/v1". */
+    baseUrl?: string;
+    /** Replaces the client built from `baseUrl`. */
+    client?: BillingClient;
+    /**
+     * Pay as the signed-in customer on this customer surface (its `/me`
+     * prefix) instead of with the session id alone; see `checkoutSource`.
+     */
+    customerBase?: string;
+    /** This host's branding; the framing app chooses the theme. */
+    appearance?: CheckoutAppearance;
+    layout?: CheckoutLayout;
+    defaultCountry?: string;
+    className?: string;
+}
+export declare function CheckoutPage({ baseUrl, client, customerBase, appearance, layout, defaultCountry, className, }: CheckoutPageProps): React.JSX.Element;

package/dist/checkout.d.ts

@@ -0,0 +1,24 @@
+import { CheckoutAppearance } from './appearance';
+import { CheckoutSource } from './source';
+import { CheckoutPhase, PayResult } from './types';
+import * as React from "react";
+export type CheckoutLayout = "auto" | "wide" | "compact";
+export interface CheckoutProps {
+    source: CheckoutSource;
+    appearance?: CheckoutAppearance;
+    layout?: CheckoutLayout;
+    /** Billing country to preselect; default: the browser locale's region. */
+    defaultCountry?: string;
+    /** Return target after an off-page card verification (Stripe setup). */
+    cardSetupReturnURL?: (setupId: string) => string;
+    onComplete?: (result: PayResult) => void;
+    /**
+     * Leaves for a redirect rail's page. Default: navigate the top window,
+     * which a nested frame may not do; <CheckoutPage> asks its app instead.
+     */
+    onRedirect?: (url: string) => void;
+    onPhaseChange?: (phase: CheckoutPhase) => void;
+    completionMode?: "embedded" | "redirect";
+    className?: string;
+}
+export declare function Checkout({ source, appearance, layout, defaultCountry, cardSetupReturnURL, onComplete, onRedirect, onPhaseChange, completionMode, className, }: CheckoutProps): React.JSX.Element;

package/dist/client/client.d.ts

@@ -0,0 +1,181 @@
+import { CheckoutSource } from '../source';
+import { CardSetup, CheckoutSessionLink, PublicConfig, PaymentAuthentication, CurrencyScales, Invoice, ListPage, NewCard, NextAction, Page, Payment, PaymentMethod, Product, SolanaToken, Subscription, TierChange, TierChangePreview } from './types';
+export interface BillingClientOptions {
+    /** OpenRails embedded mount. Default "/billing/v1". */
+    baseUrl?: string;
+    /**
+     * Transport. Pass an authenticating fetch (auth-ui's `client.authFetch`)
+     * or combine the default with `getToken`.
+     */
+    fetch?: (input: string, init: RequestInit) => Promise<Response>;
+    /** Bearer for each request; omit when `fetch` authenticates. */
+    getToken?: () => string | null | undefined | Promise<string | null | undefined>;
+    /** Sent as Accept-Language. */
+    language?: () => string | null | undefined;
+    /**
+     * Extra or overriding currency scales (code -> native-unit decimals). The
+     * pinned OpenRails registry is built in; `/me` amounts carry no scale.
+     */
+    currencies?: CurrencyScales;
+}
+export interface CheckoutSourceOptions {
+    /**
+     * A customer surface's base: its `/me` prefix, such as `/billing/v1/me` or
+     * a host's own `/api/v1/merchants/acme/billing/me`. The session is read and
+     * paid there with this client's credential, which proves the session's
+     * customer, so its saved cards pay. Default: the session id alone, at
+     * `{baseUrl}/checkout-sessions`.
+     */
+    customerBase?: string;
+}
+export interface ListOptions {
+    limit?: number;
+    offset?: number;
+    /** A cursor list's next page: the previous page's `next_cursor`. */
+    cursor?: string;
+    signal?: AbortSignal;
+}
+/** A cursor list read: pass the previous page's `next_cursor` for the next. */
+export interface CursorOptions {
+    limit?: number;
+    cursor?: string | null;
+    signal?: AbortSignal;
+}
+/**
+ * Signs and submits a base64 transaction with the customer's wallet and
+ * returns its signature. Throw `WalletRejectedError` when the user declines.
+ */
+export type SendSolanaTransaction = (transactionBase64: string) => Promise<string>;
+export declare class WalletRejectedError extends Error {
+    constructor(message?: string);
+}
+export declare const CANCEL_REASON_MIN = 4;
+export declare const CANCEL_REASON_MAX = 500;
+/** A next action the customer's wallet completes. */
+export declare const isWalletAction: (next: NextAction | null | undefined) => boolean;
+/**
+ * Signs and sends a `solana_sign_transactions` next action's transactions in
+ * order and returns the last signature, the value the action is repeated
+ * with. A declined prompt is a local `wallet_rejected` error.
+ */
+export declare function signWalletAction(next: NextAction, sendTransaction: SendSolanaTransaction): Promise<string>;
+/** Total wait a GET may spend on its one retry. */
+export declare const RETRY_BUDGET_MS = 2000;
+export declare function createBillingClient(options?: BillingClientOptions): {
+    baseUrl: string;
+    /** One page of the customer's subscriptions, newest first. */
+    listSubscriptions(opts?: CursorOptions & {
+        status?: string;
+    }): Promise<ListPage<Subscription>>;
+    /** Includes `recovery` (list rows do not). */
+    getSubscription(subscriptionId: string, signal?: AbortSignal): Promise<Subscription>;
+    /**
+     * Cancels at period end and answers the subscription. When the rail needs
+     * the customer's step (`next_action`, a Solana wallet signature), the
+     * subscription is unchanged: complete it with `signWalletAction` and
+     * repeat with `signature`.
+     */
+    cancelSubscription(subscriptionId: string, input: {
+        reason: string;
+        signature?: string;
+    }): Promise<Subscription>;
+    /** Undoes a scheduled cancel before the period ends. */
+    resumeSubscription(subscriptionId: string): Promise<Subscription>;
+    setSubscriptionPaymentMethod(subscriptionId: string, paymentMethodId: string): Promise<Subscription>;
+    /** What `changeTier` would charge now and at the next renewal. */
+    previewTierChange(subscriptionId: string, priceId: string, signal?: AbortSignal): Promise<TierChangePreview>;
+    /**
+     * Moves the subscription to another price of its tier group: an upgrade
+     * charges the saved card now, a downgrade applies at period end.
+     * `idempotencyKey` identifies this attempt; reuse it until the change
+     * resolves (`processing`, a `tier_change_in_flight` refusal or a lost
+     * response) so the stored result replays instead of charging twice. A
+     * wallet next action (Solana) is completed with `signWalletAction` and
+     * the change repeated with `signature`.
+     */
+    changeTier(subscriptionId: string, input: {
+        priceId: string;
+        idempotencyKey: string;
+        signature?: string;
+    }): Promise<TierChange>;
+    listPaymentMethods(opts?: CursorOptions): Promise<ListPage<PaymentMethod>>;
+    /**
+     * Stores a card entered in the page with the PSP `psp_id`: a Collect.js
+     * token (`cardSetupDriver` "collect_js") or the card itself ("card").
+     */
+    addPaymentMethod(card: NewCard): Promise<PaymentMethod>;
+    /**
+     * Starts an in-page card setup with a PSP whose browser SDK collects the
+     * card (see `cardSetupDriver`). `idempotencyKey` identifies this attempt.
+     */
+    createCardSetup(input: {
+        pspId: string;
+        idempotencyKey: string;
+    }): Promise<CardSetup>;
+    getCardSetup(setupId: string, signal?: AbortSignal): Promise<CardSetup>;
+    /** Verifies the setup with the provider; `payment_method_id` once saved. */
+    confirmCardSetup(setupId: string): Promise<CardSetup>;
+    /** The provider challenge a pending payment operation is waiting on. */
+    getPaymentAuthentication(operationId: string): Promise<PaymentAuthentication>;
+    confirmPaymentAuthentication(operationId: string): Promise<void>;
+    /** `pending` when the provider is still converging (202). */
+    removePaymentMethod(paymentMethodId: string): Promise<"removed" | "pending">;
+    /** Makes the card the one that collects one currency's invoices. */
+    setCollectionPaymentMethod(input: {
+        currency: string;
+        paymentMethodId: string;
+    }): Promise<void>;
+    /** Charges and refunds, newest first. `rail` filters by rail. */
+    listPayments(opts?: CursorOptions & {
+        rail?: string;
+    }): Promise<ListPage<Payment>>;
+    listInvoices(opts?: CursorOptions): Promise<ListPage<Invoice>>;
+    getInvoice(invoiceId: string, signal?: AbortSignal): Promise<Invoice>;
+    /** Products on sale, each with its current prices. */
+    listProducts(opts?: ListOptions): Promise<Page<Product>>;
+    /**
+     * Mints a hosted checkout session for the signed-in customer and one
+     * price. Render it with `<CheckoutFrame url>` when the session has a
+     * `url`, else with `<Checkout source={client.checkoutSource(id)}>`.
+     * Select a price by `priceId`, or by both `productKey` and `priceKey`.
+     * `successUrl` brings the buyer back from a redirect rail; it must be on
+     * one of this app's return origins.
+     */
+    createCheckoutSession(input: {
+        priceKey?: string;
+        productKey?: string;
+        priceId?: string;
+        /** Customer-selected deposit in the price currency’s native units. */
+        amount?: string;
+        /** Defaults to true for recurring prices; false buys the initial term only. */
+        autoRenew?: boolean;
+        successUrl?: string;
+    }): Promise<CheckoutSessionLink>;
+    /**
+     * Reads and pays one hosted checkout session. By default the id is the
+     * only credential: no bearer is sent. With `customerBase` the session's
+     * customer reads and pays it on that customer surface, signed in. A
+     * refusal the buyer can answer (an invalid card form, too many attempts)
+     * resolves as `failed`; an expired or unknown session as `expired`.
+     */
+    checkoutSource(sessionId: string, opts?: CheckoutSourceOptions): CheckoutSource;
+    /**
+     * The deployment's public configuration: what the mount serves, the
+     * currency registry and the merchant's payment setup. React components
+     * share one copy through `useConfig()`.
+     */
+    getConfig(signal?: AbortSignal): Promise<PublicConfig>;
+    /**
+     * Accepted tokens with live prices. `priceId` adds each token's `quote`;
+     * `wallet` adds its `balance`.
+     */
+    listSolanaTokens(opts?: {
+        priceId?: string;
+        wallet?: string;
+        signal?: AbortSignal;
+    }): Promise<SolanaToken[]>;
+    /** Currency code (upper case) to native-unit decimals. */
+    currencies: Readonly<Record<string, number>>;
+};
+export type BillingClient = ReturnType<typeof createBillingClient>;
+export declare const isWalletRejection: (error: unknown) => boolean;

package/dist/client/errors.d.ts

@@ -0,0 +1,26 @@
+export interface BillingErrorBody {
+    type: string;
+    code: string;
+    message: string;
+    request_id?: string;
+    param?: string;
+    metadata?: Record<string, unknown>;
+}
+export declare class BillingError extends Error {
+    readonly status: number;
+    readonly type: string;
+    readonly code: string;
+    readonly param?: string;
+    readonly requestId?: string;
+    readonly metadata: Record<string, unknown>;
+    constructor(status: number, body: BillingErrorBody);
+}
+export declare const isBillingError: (value: unknown) => value is BillingError;
+/**
+ * A server failure (HTTP 5xx) from any client or host source that carries a
+ * numeric `status`. It is surfaced at once, never retried behind the caller.
+ */
+export declare const isServerError: (value: unknown) => boolean;
+export declare function localError(code: string, message: string): BillingError;
+export declare function readBillingError(res: Response): Promise<BillingError>;
+export declare function toBillingError(error: unknown): BillingError;

package/dist/client/generated/currencies.d.ts

@@ -0,0 +1 @@
+export declare const OPENRAILS_CURRENCY_SCALES: Readonly<Record<string, number>>;

package/dist/client/generated/error-codes.d.ts

@@ -0,0 +1,7 @@
+export type OpenRailsErrorCode = "access_token_invalid" | "access_token_issuer_unknown" | "access_token_merchant_not_bound" | "admission_captured" | "admission_not_found" | "allowance_meter_not_found" | "allowance_source_in_use" | "allowance_source_invalid" | "api_host_claim_missing" | "api_host_reserved" | "api_host_taken" | "api_host_unproven" | "as_of_required" | "authentication_required" | "authentication_unavailable" | "authorization_unavailable" | "billing_archive_integrity" | "billing_archive_invalid_artifact" | "billing_archive_merchant_mismatch" | "billing_archive_not_empty" | "billing_archive_unavailable" | "billing_archive_unsupported_state" | "billing_policy_not_found" | "cancel_unsupported_on_rail" | "captcha_invalid" | "captcha_required" | "card_attempts_blocked" | "card_declined" | "card_not_saved" | "card_requires_https" | "catalog_benefit_overlap" | "catalog_revision_conflict" | "catalog_updates_disabled" | "checkout_attempt_closed" | "checkout_attempt_expired" | "checkout_offer_unavailable" | "checkout_payment_in_progress" | "checkout_request_invalid" | "checkout_session_expired" | "checkout_session_not_found" | "checkout_session_unavailable" | "collection_payment_method_invalid" | "collection_payment_method_required" | "creation_refused" | "credential_custody_transition_required" | "credential_expired" | "credential_identity_mismatch" | "credential_operation_conflict" | "credential_revoked" | "credential_source_read_only" | "credential_store_read_only" | "credentials_manage_required" | "credit_grant_held" | "credit_grant_not_found" | "credit_grant_unavailable" | "csrf_origin_denied" | "currency_unsupported" | "custodian_capture_unavailable" | "customer_action_required" | "customer_blocked" | "customer_email_required" | "customer_not_found" | "customer_payment_unsupported" | "customer_proof_required" | "customer_session_required" | "dashboard_invalid" | "database_busy" | "default_rate_card_not_found" | "default_rate_card_required" | "delegated_principal_invalid" | "email_unverified" | "finding_action_failed" | "finding_not_actionable" | "hold_not_found" | "host_event_not_found" | "host_merchant_mismatch" | "host_principal_invalid" | "idempotency_key_required" | "idempotency_key_reused" | "insufficient_credits" | "insufficient_funds" | "insufficient_scope" | "internal_error" | "invalid_api_host" | "invalid_cursor" | "invalid_customer_id" | "invalid_email" | "invalid_host_event_request" | "invalid_name" | "invalid_param" | "invalid_payment_method" | "invalid_psp_reference" | "invalid_query" | "invalid_request_body" | "invalid_settlement_status_request" | "invalid_user" | "invites_disabled" | "invoice_action_not_allowed" | "invoice_not_retryable" | "invoice_payment_exceeds_due" | "invoice_payment_invalid" | "invoice_payment_reference_used" | "invoice_retry_idempotency_conflict" | "invoice_retry_in_progress" | "invoice_retry_outcome_unknown" | "invoker_scoped_principal" | "last_owner" | "members_manage_required" | "merchant_binding_mismatch" | "merchant_configuration_application_conflict" | "merchant_configuration_revision_conflict" | "merchant_context_mismatch" | "merchant_creation_payment_method_required" | "merchant_directory_unavailable" | "merchant_not_found" | "merchant_selector_invalid" | "merchant_unresolved" | "meter_in_use" | "meter_rate_card_conflict" | "method_not_allowed" | "metrics_query_invalid" | "model_unavailable" | "name_reserved" | "name_taken" | "operation_authorization_conflict" | "operation_authorization_has_billing_evidence" | "operation_authorization_not_found" | "operation_authorization_not_open" | "payment_duplicate_refused" | "payment_failed" | "payment_idempotency_conflict" | "payment_in_progress" | "payment_method_delete_failed" | "payment_method_delete_unsupported" | "payment_method_not_psp_vaulted" | "payment_method_not_usable" | "payment_method_psp_mismatch" | "payment_method_required" | "payment_method_same_vault" | "payment_method_stale" | "payment_method_update_failed" | "payment_method_update_retry_required" | "payment_method_update_unsupported" | "payment_not_found" | "payment_not_refundable" | "payment_not_retryable" | "payment_provider_rejected" | "permission_required" | "price_key_cadence_conflict" | "price_key_not_found" | "price_not_found" | "price_not_sellable" | "product_not_found" | "product_tier_group_conflict" | "product_tier_group_in_use" | "provider_billing_observation_conflict" | "provider_billing_qualification_not_found" | "provider_billing_qualification_not_refused" | "provider_billing_qualification_refused" | "provider_billing_refusal_conflict" | "provider_billing_resolution_conflict" | "provider_cancel_held" | "provider_outcome_unknown" | "psp_claim_requires_proof" | "psp_credentials_rejected" | "psp_exists" | "psp_key_taken" | "psp_last_active" | "psp_not_found" | "purchase_review_resolved" | "rate_card_currency_mismatch" | "rate_card_has_overrides" | "rate_card_product_not_found" | "rate_limit_exceeded" | "rebill_terms_committed" | "refund_failed" | "refund_rail_unavailable" | "refund_unsupported" | "rename_too_soon" | "renames_disabled" | "reprice_already_scheduled" | "reprice_cross_currency" | "reprice_cross_product" | "reprice_inactive_price" | "reprice_not_found" | "reprice_not_scheduled" | "reprice_notice_window_violation" | "reprice_price_key_not_found" | "reprice_target_price_not_found" | "request_body_too_large" | "resource_access_denied" | "resource_conflict" | "resource_not_found" | "role_escalation" | "route_not_found" | "sender_proof_required" | "service_credential_customer_scope_denied" | "service_credential_invalid" | "service_credential_merchant_unresolved" | "service_credential_resource_scope_denied" | "service_unavailable" | "solana_rpc_unavailable" | "solana_transaction_refused" | "spend_delegation_not_found" | "step_up_required" | "step_up_unavailable" | "subscription_not_active" | "subscription_not_found" | "subscription_paid_through" | "subscription_resumable" | "tier_change_already_scheduled" | "tier_change_cadence_unsupported" | "tier_change_credit_exceeds_price" | "tier_change_cycle_unknown" | "tier_change_idempotency_conflict" | "tier_change_idempotency_key_required" | "tier_change_in_flight" | "tier_change_period_unknown" | "tier_change_provider_conflict" | "tier_change_refused" | "tier_change_renewal_due" | "tier_change_requires_linked_plan" | "tier_change_target_inactive" | "tier_change_unsupported_on_rail" | "trial_unsupported_on_rail" | "unknown_field" | "unknown_role" | "unsupported_media_type" | "usage_meter_invalid" | "usage_meter_not_found" | "usage_rate_card_invalid" | "use_dpop_nonce" | "webhook_account_mismatch" | "webhook_invalid" | "widget_generation_invalid";
+export type OpenRailsErrorType = "api_error" | "authentication_error" | "authorization_error" | "card_error" | "invalid_request_error" | "rate_limit_error";
+export declare const OPENRAILS_ERROR_CODES: Readonly<Record<OpenRailsErrorCode, {
+    status: number;
+    type: OpenRailsErrorType;
+    meaning: string;
+}>>;