@openrails/billing-ui 0.235.0 → 0.237.0

package/dist/order-checkout.d.ts

@@ -0,0 +1,30 @@
+import { CheckoutAppearance } from './appearance';
+import { BillingClient } from './client/client';
+import { Order } from './client/types';
+import * as React from "react";
+export interface OrderCheckoutProps {
+    orderId: string;
+    /** The client to pay through; default: the provider's. */
+    client?: BillingClient;
+    /** Where a redirect PSP will return to; card PSPs need none. */
+    returnUrl?: string;
+    /** Offer the customer's saved cards (GET /me/payment-methods). Default true. */
+    savedPaymentMethods?: boolean;
+    /**
+     * Offer a PSP whose card entry is server. Default true; orders take
+     * tokens only, so such a PSP is offered for saved cards alone.
+     */
+    serverCardEntry?: boolean;
+    /**
+     * Offer Apple Pay and Google Pay through a Stripe PSP's Express Checkout
+     * Element. The page's host must be a payment-method domain registered on
+     * that Stripe account. Default false.
+     */
+    wallets?: boolean;
+    /** Once the order is complete, or processing on an asynchronous rail. */
+    onSettled?: (order: Order) => void;
+    appearance?: CheckoutAppearance;
+    className?: string;
+}
+/** Pays one order. Requires `BillingProvider`. */
+export declare function OrderCheckout({ orderId, client: given, returnUrl, savedPaymentMethods, serverCardEntry, wallets, onSettled, appearance, className, }: OrderCheckoutProps): React.JSX.Element;

package/dist/psp.d.ts

@@ -1,6 +1,4 @@
 import { z } from 'zod';
-import { PaymentMethod } from './client/types';
-import { PaymentOption, SavedPaymentMethod } from './types';
 export declare const pspConfigSchema: z.ZodObject<{
     psp_id: z.ZodString;
     key: z.ZodString;
@@ -14,8 +12,6 @@ export declare const pspConfigSchema: z.ZodObject<{
     retry_after: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;
 export type PspConfig = z.infer<typeof pspConfigSchema>;
-/** Whether a rail takes a card in the page (saved or new). */
-export declare const isCardRail: (rail: PaymentOption) => boolean;
 /** PSPs that take new purchases and new cards. */
 export declare const checkoutPsps: (psps: readonly PspConfig[]) => PspConfig[];
 /**
@@ -23,13 +19,9 @@ export declare const checkoutPsps: (psps: readonly PspConfig[]) => PspConfig[];
  * for again; null when none is.
  */
 export declare function cardRetryAfter(psps: readonly PspConfig[]): number | null;
-/** Saved cards the checkout can charge in place, for the given rails, newest first. */
-export declare function savedMethodsFor(methods: readonly PaymentMethod[], rails: readonly PaymentOption[]): SavedPaymentMethod[];
 export type CardSetupDriver = "collect_js" | "card" | "stripe_elements";
 /** How a card is saved with this PSP in the page, or null when it cannot be. */
 export declare function cardSetupDriver(psp: PspConfig): CardSetupDriver | null;
 export declare const canSavePaymentMethod: (psp: PspConfig) => boolean;
 /** Whether a pending payment on this PSP can be authenticated in the page. */
 export declare const canAuthenticatePayment: (psp: PspConfig) => boolean;
-/** The PSP config behind a checkout rail, for card setup and authentication. */
-export declare function railPsp(rail: PaymentOption): PspConfig;

package/dist/react/hooks.d.ts

@@ -1,4 +1,4 @@
-import { SendSolanaTransaction, SubscriptionChangeInput } from '../client/client';
+import { ProductListOptions, SendSolanaTransaction, SubscriptionChangeInput } from '../client/client';
 import { BillingError } from '../client/errors';
 import { NewCard, Payment, PaymentMethod, Product, Subscription, SubscriptionChange } from '../client/types';
 export type ActionResult = Promise<BillingError | null>;
@@ -39,16 +39,17 @@ export interface SubscriptionsState {
 export declare function useSubscriptions(options?: SubscriptionsOptions): SubscriptionsState;
 export interface ProductsState {
     products: Product[] | null;
-    /** The cursor of the next page; null on the last. */
-    nextCursor: string | null;
     loading: boolean;
     error: BillingError | null;
     refetch: () => void;
 }
-/** The catalog: active products with their active prices. */
-export declare function useProducts(options?: {
-    limit?: number;
-}): ProductsState;
+/** The product keys to look up: `ProductListOptions`. */
+export type ProductsOptions = Pick<ProductListOptions, "keys">;
+/**
+ * The products on sale named by `keys`, each with its active prices: a
+ * public catalog lookup.
+ */
+export declare function useProducts({ keys }: ProductsOptions): ProductsState;
 export type PaymentMethodAction = "remove" | "default";
 export interface PaymentMethodsState {
     methods: PaymentMethod[] | null;

package/dist/react/index.d.ts

@@ -1,4 +1,4 @@
 export { BillingProvider, type BillingProviderProps } from './provider';
 export { useBillingClient, useBillingRefresh, useOptionalBillingContext, type BillingChange, type BillingContextValue, } from './context';
 export { useConfig, useCurrencyScales, type ConfigState, type ConfigStore, } from './config';
-export { usePaymentMethods, usePayments, useProducts, useSubscriptions, type ActionResult, type PaymentMethodAction, type PaymentMethodsState, type PaymentsOptions, type PaymentsState, type ProductsState, type SubscriptionAction, type SubscriptionsOptions, type SubscriptionsState, } from './hooks';
+export { usePaymentMethods, usePayments, useProducts, useSubscriptions, type ActionResult, type PaymentMethodAction, type PaymentMethodsState, type PaymentsOptions, type PaymentsState, type ProductsOptions, type ProductsState, type SubscriptionAction, type SubscriptionsOptions, type SubscriptionsState, } from './hooks';

package/dist/react/provider.d.ts

@@ -1,10 +1,32 @@
 import { ReactNode } from 'react';
+import { CheckoutAppearance } from '../appearance';
 import { BillingClient } from '../client/client';
+import { BillingUiMessageBundle, BillingUiTranslate } from '../i18n/messages';
+import { Navigate } from '../scope-context';
 import { BillingChange } from './context';
 export interface BillingProviderProps {
-    client: BillingClient;
+    /**
+     * The customer's client: hooks and the account panels read it, and a
+     * checkout saves a new card to the customer first. Leave it out where no
+     * customer is signed in, such as the shared payment page.
+     */
+    client?: BillingClient;
     /** Fires after each successful mutation: the host's cache-invalidation hook. */
     onChange?: (change: BillingChange) => void;
+    appearance?: CheckoutAppearance;
+    /** Locale bundle(s) layered over English; later entries win. */
+    messages?: BillingUiMessageBundle | readonly BillingUiMessageBundle[];
+    /** Host translation hook, consulted before the bundles. */
+    t?: BillingUiTranslate;
+    /** BCP 47 tag for dates, money and plurals; defaults to the browser's. */
+    locale?: string;
+    /** Host router for in-app links (e.g. the plans page). */
+    navigate?: Navigate;
     children?: ReactNode;
 }
-export declare function BillingProvider({ client, onChange, children, }: BillingProviderProps): import("react").JSX.Element;
+/**
+ * The one billing-ui provider: the client, and the appearance and words of
+ * the styled components. Renders no DOM; surfaces create their own styling
+ * roots, and no stylesheet loads until a styled component is imported.
+ */
+export declare function BillingProvider({ client, onChange, appearance, messages, t, locale, navigate, children, }: BillingProviderProps): import("react").JSX.Element;

package/dist/react.js

@@ -1,33 +1,2 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, r as c, s as l, t as u } from "./config-qLcHvK0Q.js";
-import { useCallback as d, useEffect as f, useMemo as p, useRef as m, useState as h } from "react";
-import { jsx as g } from "react/jsx-runtime";
-//#region src/react/provider.tsx
-function _({ client: e, onChange: n, children: r }) {
-	let [i, a] = h(0), o = m(n);
-	f(() => {
-		o.current = n;
-	});
-	let s = d((e) => {
-		a((e) => e + 1), o.current?.(e);
-	}, []), c = d(() => a((e) => e + 1), []), l = p(() => u(e), [e]), _ = p(() => ({
-		client: e,
-		version: i,
-		notify: s,
-		refresh: c,
-		config: l
-	}), [
-		e,
-		i,
-		s,
-		c,
-		l
-	]);
-	return /* @__PURE__ */ g(t.Provider, {
-		value: _,
-		children: r
-	});
-}
-//#endregion
-export { _ as BillingProvider, a as useBillingClient, n as useBillingRefresh, o as useConfig, c as useCurrencyScales, r as useOptionalBillingContext, i as usePaymentMethods, e as usePayments, s as useProducts, l as useSubscriptions };
-
-//# sourceMappingURL=react.js.map
+import { a as e, c as t, d as n, i as r, n as i, o as a, r as o, s, t as c, u as l } from "./hooks-DYepYVMX.js";
+export { e as BillingProvider, t as useBillingClient, l as useBillingRefresh, a as useConfig, s as useCurrencyScales, n as useOptionalBillingContext, c as usePaymentMethods, i as usePayments, o as useProducts, r as useSubscriptions };

package/dist/save-payment-method.d.ts

@@ -5,12 +5,6 @@ export interface SavePaymentMethodProps {
     /** The PSP to save the card with, from OpenRails's payment config. */
     psp: PspConfig;
     onSaved: (paymentMethodId: string) => void;
-    /**
-     * Where the provider returns after an off-page verification (3-D Secure),
-     * given the setup id to confirm with `client.confirmCardSetup`. Default:
-     * the current page with `?setup_id=`.
-     */
-    returnURL?: (setupId: string) => string;
     /** Billing country to preselect; default: the browser locale's region. */
     defaultCountry?: string;
     submitLabel?: string;