@openrails/billing-ui 0.0.0-stage → 0.230.0

package/dist/hooks-DLFF-zx5.js

@@ -0,0 +1,285 @@
+import { o as e } from "./errors-T-PRm3vV.js";
+import { createContext as t, useCallback as n, useContext as r, useEffect as i, useRef as a, useState as o } from "react";
+//#region src/react/context.ts
+var s = t(null);
+function c() {
+	let e = r(s);
+	if (!e) throw Error("billing-ui: wrap the tree in <BillingProvider>");
+	return e;
+}
+var l = () => c().client, u = () => c().refresh, d = () => r(s);
+//#endregion
+//#region src/react/remote.ts
+function f(t, r) {
+	let [s, c] = o(0), l = `${t}|${s}`, [u, d] = o({
+		request: null,
+		data: null,
+		error: null
+	}), f = a(r);
+	i(() => {
+		f.current = r;
+	}), i(() => {
+		let t = new AbortController();
+		return f.current(t.signal).then((e) => d({
+			request: l,
+			data: e,
+			error: null
+		}), (n) => {
+			t.signal.aborted || d((t) => ({
+				request: l,
+				data: t.data,
+				error: e(n)
+			}));
+		}), () => t.abort();
+	}, [l]);
+	let p = n(() => c((e) => e + 1), []), m = n((e) => d((t) => t.data === null ? t : {
+		...t,
+		data: e(t.data)
+	}), []);
+	return {
+		data: u.data,
+		loading: u.request !== l,
+		error: u.request === l ? u.error : null,
+		refetch: p,
+		replace: m
+	};
+}
+var p = (e) => new Promise((t) => setTimeout(t, e)), m = (e) => !!e.cancel_scheduled || e.status === "cancelled" || !!e.resumable, h = (e) => !e.cancel_scheduled && e.status !== "cancelled";
+function g() {
+	let [e, t] = o({});
+	return [e, n((e, n) => {
+		t((t) => {
+			let r = { ...t };
+			return n ? r[e] = n : delete r[e], r;
+		});
+	}, [])];
+}
+function _(t = {}) {
+	let { client: r, version: i, notify: a, settle: o } = c(), s = t.status ?? "all", l = t.limit ?? 100, u = f(`${s}|${l}|${i}`, (e) => r.listSubscriptions({
+		status: s,
+		limit: l,
+		signal: e
+	})), [d, _] = g(), { replace: v } = u, y = n(async (e, t) => {
+		for (let n = 0; n < o.attempts; n++) {
+			let n = await r.getSubscription(e).catch(() => null);
+			if (n && t(n)) return v((t) => ({
+				...t,
+				data: t.data.map((t) => t.id === e ? n : t)
+			})), !0;
+			await p(o.intervalMs);
+		}
+		return !1;
+	}, [
+		r,
+		v,
+		o.attempts,
+		o.intervalMs
+	]), b = n(async (t, n, r, i) => {
+		_(t, n);
+		try {
+			let e = await r();
+			return i?.(e !== !1), null;
+		} catch (t) {
+			return e(t);
+		} finally {
+			_(t, null);
+		}
+	}, [_]), x = n((e, t) => b(e, "cancel", async () => (await r.cancelSubscription(e, { feedback: t }), y(e, m)), (t) => a({
+		type: "subscription.cancelled",
+		subscriptionId: e,
+		settled: t
+	})), [
+		b,
+		r,
+		a,
+		y
+	]), S = n((e, t) => b(e, "preparing", async () => (await r.cancelSubscriptionOnChain(e, t, (t) => _(e, t)), y(e, m)), (t) => a({
+		type: "subscription.cancelled",
+		subscriptionId: e,
+		settled: t
+	})), [
+		b,
+		r,
+		_,
+		a,
+		y
+	]), C = n((e) => b(e, "resume", async () => (await r.resumeSubscription(e), y(e, h)), (t) => a({
+		type: "subscription.resumed",
+		subscriptionId: e,
+		settled: t
+	})), [
+		b,
+		r,
+		a,
+		y
+	]), w = n((e, t) => b(e, "payment_method", async () => {
+		await r.setSubscriptionPaymentMethod(e, t), v((n) => ({
+			...n,
+			data: n.data.map((n) => n.id === e ? {
+				...n,
+				payment_method_id: t
+			} : n)
+		}));
+	}, () => a({
+		type: "subscription.payment_method_changed",
+		subscriptionId: e,
+		paymentMethodId: t
+	})), [
+		b,
+		r,
+		a,
+		v
+	]), T = n(async (t, n) => {
+		_(t, "change_tier");
+		try {
+			let e = await r.changeTier(t, n);
+			return a({
+				type: "subscription.tier_changed",
+				subscriptionId: t,
+				change: e
+			}), e;
+		} catch (t) {
+			return e(t);
+		} finally {
+			_(t, null);
+		}
+	}, [
+		r,
+		_,
+		a
+	]);
+	return {
+		subscriptions: u.data?.data ?? null,
+		total: u.data?.total ?? null,
+		loading: u.loading,
+		error: u.error,
+		refetch: u.refetch,
+		pending: d,
+		cancel: x,
+		cancelOnChain: S,
+		resume: C,
+		setPaymentMethod: w,
+		changeTier: T
+	};
+}
+function v(e = {}) {
+	let { client: t } = c(), n = e.limit ?? 100, r = f(`${n}`, (e) => t.listProducts({
+		limit: n,
+		signal: e
+	}));
+	return {
+		products: r.data?.data ?? null,
+		total: r.data?.total ?? null,
+		loading: r.loading,
+		error: r.error,
+		refetch: r.refetch
+	};
+}
+function y() {
+	let { client: t, version: r, notify: i } = c(), a = f(`${r}`, (e) => t.listPaymentMethods({ signal: e })), [s, l] = g(), [u, d] = o(!1), { replace: p } = a, m = n(async (n) => {
+		d(!0);
+		try {
+			let e = await t.addPaymentMethod(n);
+			return p((t) => ({
+				...t,
+				data: [...t.data, e]
+			})), i({
+				type: "payment_method.added",
+				paymentMethodId: e.id
+			}), null;
+		} catch (t) {
+			return e(t);
+		} finally {
+			d(!1);
+		}
+	}, [
+		t,
+		i,
+		p
+	]), h = n(async (n) => {
+		l(n, "remove");
+		try {
+			return await t.removePaymentMethod(n), p((e) => ({
+				...e,
+				data: e.data.filter((e) => e.id !== n)
+			})), i({
+				type: "payment_method.removed",
+				paymentMethodId: n
+			}), null;
+		} catch (t) {
+			return e(t);
+		} finally {
+			l(n, null);
+		}
+	}, [
+		t,
+		l,
+		i,
+		p
+	]), _ = n(async (n, r) => {
+		l(n, "default");
+		try {
+			await t.setDefaultPaymentMethod({
+				currency: r,
+				paymentMethodId: n
+			});
+			let e = r.toUpperCase();
+			return p((t) => ({
+				...t,
+				data: t.data.map((t) => {
+					let r = (t.collection_default_currencies ?? []).filter((t) => t !== e);
+					return {
+						...t,
+						collection_default_currencies: t.id === n ? [...r, e] : r
+					};
+				})
+			})), i({
+				type: "payment_method.default_changed",
+				paymentMethodId: n
+			}), null;
+		} catch (t) {
+			return e(t);
+		} finally {
+			l(n, null);
+		}
+	}, [
+		t,
+		l,
+		i,
+		p
+	]);
+	return {
+		methods: a.data?.data ?? null,
+		loading: a.loading,
+		error: a.error,
+		refetch: a.refetch,
+		pending: s,
+		adding: u,
+		add: m,
+		remove: h,
+		setDefault: _
+	};
+}
+function b(e = {}) {
+	let { client: t, version: r } = c(), i = e.pageSize ?? 20, [a, s] = o(0), l = f(`${i}|${e.rail ?? ""}|${a}|${r}`, (n) => t.listPayments({
+		limit: i,
+		offset: a * i,
+		rail: e.rail,
+		signal: n
+	})), u = l.data, d = u?.total ?? null, p = u?.has_more ?? (d === null ? u?.data.length === i : (a + 1) * i < d);
+	return {
+		payments: u?.data ?? null,
+		page: a,
+		hasMore: !!p,
+		total: d,
+		loading: l.loading,
+		error: l.error,
+		next: n(() => s((e) => e + 1), []),
+		previous: n(() => s((e) => Math.max(0, e - 1)), []),
+		refetch: l.refetch
+	};
+}
+//#endregion
+export { s as a, u as c, _ as i, d as l, b as n, l as o, v as r, c as s, y as t };
+
+//# sourceMappingURL=hooks-DLFF-zx5.js.map

package/dist/hooks-DLFF-zx5.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-DLFF-zx5.js","names":[],"sources":["../src/react/context.ts","../src/react/remote.ts","../src/react/hooks.ts"],"sourcesContent":["import { createContext, useContext } from \"react\"\n\nimport type { BillingClient } from \"../client/client\"\nimport type { TierChange } from \"../client/types\"\n\nexport type BillingChange =\n  | {\n      type: \"subscription.cancelled\" | \"subscription.resumed\"\n      subscriptionId: string\n      /** False when the server had not applied the queued change yet. */\n      settled: boolean\n    }\n  | {\n      type: \"subscription.payment_method_changed\"\n      subscriptionId: string\n      paymentMethodId: string\n    }\n  | {\n      type: \"subscription.tier_changed\"\n      subscriptionId: string\n      /** `status` may still be `processing` or `requires_action`. */\n      change: TierChange\n    }\n  | {\n      type:\n        | \"payment_method.added\"\n        | \"payment_method.removed\"\n        | \"payment_method.default_changed\"\n      paymentMethodId: string\n    }\n\nexport interface BillingContextValue {\n  client: BillingClient\n  /** Bumped after every mutation; hooks refetch on change. */\n  version: number\n  notify(change: BillingChange): void\n  /** Refetch every hook after a host-side change such as a plan switch. */\n  refresh(): void\n  settle: { intervalMs: number; attempts: number }\n}\n\nexport const BillingContext = createContext<BillingContextValue | null>(null)\n\nexport function useBillingContext(): BillingContextValue {\n  const ctx = useContext(BillingContext)\n  if (!ctx) throw new Error(\"billing-ui: wrap the tree in <BillingProvider>\")\n  return ctx\n}\n\nexport const useBillingClient = (): BillingClient => useBillingContext().client\n\nexport const useBillingRefresh = (): (() => void) => useBillingContext().refresh\n\n/** The billing context when a BillingProvider is present, else null. */\nexport const useOptionalBillingContext = (): BillingContextValue | null =>\n  useContext(BillingContext)\n","import { useCallback, useEffect, useRef, useState } from \"react\"\n\nimport { toBillingError, type BillingError } from \"../client/errors\"\n\nexport interface RemoteState<T> {\n  data: T | null\n  loading: boolean\n  error: BillingError | null\n  refetch: () => void\n}\n\n// Keyed fetch that keeps the previous data while a newer key loads, so a\n// refetch after a mutation never flashes an empty list.\nexport function useRemote<T>(\n  key: string,\n  load: (signal: AbortSignal) => Promise<T>\n): RemoteState<T> & { replace: (update: (data: T) => T) => void } {\n  const [nonce, setNonce] = useState(0)\n  const request = `${key}|${nonce}`\n  const [state, setState] = useState<{\n    request: string | null\n    data: T | null\n    error: BillingError | null\n  }>({ request: null, data: null, error: null })\n  const loadRef = useRef(load)\n  useEffect(() => {\n    loadRef.current = load\n  })\n\n  useEffect(() => {\n    const ctl = new AbortController()\n    loadRef.current(ctl.signal).then(\n      (data) => setState({ request, data, error: null }),\n      (err: unknown) => {\n        if (!ctl.signal.aborted)\n          setState((s) => ({\n            request,\n            data: s.data,\n            error: toBillingError(err),\n          }))\n      }\n    )\n    return () => ctl.abort()\n  }, [request])\n\n  const refetch = useCallback(() => setNonce((n) => n + 1), [])\n  const replace = useCallback(\n    (update: (data: T) => T) =>\n      setState((s) => (s.data === null ? s : { ...s, data: update(s.data) })),\n    []\n  )\n  return {\n    data: state.data,\n    loading: state.request !== request,\n    error: state.request === request ? state.error : null,\n    refetch,\n    replace,\n  }\n}\n\nexport const sleep = (ms: number) =>\n  new Promise<void>((resolve) => setTimeout(resolve, ms))\n","import { useCallback, useState } from \"react\"\n\nimport type { SendSolanaTransaction, SolanaCancelStage } from \"../client/client\"\nimport { toBillingError, type BillingError } from \"../client/errors\"\nimport type {\n  NewCard,\n  Payment,\n  PaymentMethod,\n  Product,\n  Subscription,\n  TierChange,\n} from \"../client/types\"\nimport { useBillingContext } from \"./context\"\nimport { sleep, useRemote } from \"./remote\"\n\n// Actions never throw: they resolve to null on success or the error.\nexport type ActionResult = Promise<BillingError | null>\n\nexport type SubscriptionAction =\n  \"cancel\" | \"resume\" | \"payment_method\" | \"change_tier\" | SolanaCancelStage\n\nexport interface SubscriptionsOptions {\n  /** Server filter; default `all`. */\n  status?: string\n  limit?: number\n}\n\nexport interface SubscriptionsState {\n  subscriptions: Subscription[] | null\n  total: number | null\n  loading: boolean\n  error: BillingError | null\n  refetch: () => void\n  /** In-flight action per subscription id. */\n  pending: Readonly<Record<string, SubscriptionAction>>\n  cancel: (subscriptionId: string, feedback: string) => ActionResult\n  /** Solana rail: the wallet signs the server-prepared cancel transaction. */\n  cancelOnChain: (\n    subscriptionId: string,\n    sendTransaction: SendSolanaTransaction\n  ) => ActionResult\n  resume: (subscriptionId: string) => ActionResult\n  setPaymentMethod: (\n    subscriptionId: string,\n    paymentMethodId: string\n  ) => ActionResult\n  /**\n   * Card rails: `client.changeTier`. Resolves to the change, whose `status`\n   * may still be `processing` or `requires_action`, or to the error.\n   */\n  changeTier: (\n    subscriptionId: string,\n    input: { priceId: string; idempotencyKey: string }\n  ) => Promise<TierChange | BillingError>\n}\n\nconst cancelApplied = (s: Subscription) =>\n  !!s.cancel_scheduled || s.status === \"cancelled\" || !!s.resumable\nconst resumeApplied = (s: Subscription) =>\n  !s.cancel_scheduled && s.status !== \"cancelled\"\n\nfunction usePending<A extends string>() {\n  const [pending, setPending] = useState<Readonly<Record<string, A>>>({})\n  const mark = useCallback((id: string, action: A | null) => {\n    setPending((p) => {\n      const next = { ...p }\n      if (action) next[id] = action\n      else delete next[id]\n      return next\n    })\n  }, [])\n  return [pending, mark] as const\n}\n\nexport function useSubscriptions(\n  options: SubscriptionsOptions = {}\n): SubscriptionsState {\n  const { client, version, notify, settle } = useBillingContext()\n  const status = options.status ?? \"all\"\n  const limit = options.limit ?? 100\n  const remote = useRemote(`${status}|${limit}|${version}`, (signal) =>\n    client.listSubscriptions({ status, limit, signal })\n  )\n  const [pending, mark] = usePending<SubscriptionAction>()\n  const { replace } = remote\n\n  // Re-reads a queued change until it shows, then patches the row.\n  const settleRow = useCallback(\n    async (id: string, applied: (s: Subscription) => boolean) => {\n      for (let i = 0; i < settle.attempts; i++) {\n        const next = await client.getSubscription(id).catch(() => null)\n        if (next && applied(next)) {\n          replace((page) => ({\n            ...page,\n            data: page.data.map((s) => (s.id === id ? next : s)),\n          }))\n          return true\n        }\n        await sleep(settle.intervalMs)\n      }\n      return false\n    },\n    [client, replace, settle.attempts, settle.intervalMs]\n  )\n\n  const act = useCallback(\n    async (\n      id: string,\n      action: SubscriptionAction,\n      run: () => Promise<boolean | void>,\n      done?: (settled: boolean) => void\n    ): ActionResult => {\n      mark(id, action)\n      try {\n        const settled = await run()\n        done?.(settled !== false)\n        return null\n      } catch (err) {\n        return toBillingError(err)\n      } finally {\n        mark(id, null)\n      }\n    },\n    [mark]\n  )\n\n  const cancel = useCallback(\n    (id: string, feedback: string) =>\n      act(\n        id,\n        \"cancel\",\n        async () => {\n          await client.cancelSubscription(id, { feedback })\n          return settleRow(id, cancelApplied)\n        },\n        (settled) =>\n          notify({\n            type: \"subscription.cancelled\",\n            subscriptionId: id,\n            settled,\n          })\n      ),\n    [act, client, notify, settleRow]\n  )\n\n  // A declined wallet prompt resolves to a `wallet_rejected` error.\n  const cancelOnChain = useCallback(\n    (id: string, sendTransaction: SendSolanaTransaction) =>\n      act(\n        id,\n        \"preparing\",\n        async () => {\n          await client.cancelSubscriptionOnChain(id, sendTransaction, (stage) =>\n            mark(id, stage)\n          )\n          return settleRow(id, cancelApplied)\n        },\n        (settled) =>\n          notify({\n            type: \"subscription.cancelled\",\n            subscriptionId: id,\n            settled,\n          })\n      ),\n    [act, client, mark, notify, settleRow]\n  )\n\n  const resume = useCallback(\n    (id: string) =>\n      act(\n        id,\n        \"resume\",\n        async () => {\n          await client.resumeSubscription(id)\n          return settleRow(id, resumeApplied)\n        },\n        (settled) =>\n          notify({ type: \"subscription.resumed\", subscriptionId: id, settled })\n      ),\n    [act, client, notify, settleRow]\n  )\n\n  const setPaymentMethod = useCallback(\n    (id: string, paymentMethodId: string) =>\n      act(\n        id,\n        \"payment_method\",\n        async () => {\n          await client.setSubscriptionPaymentMethod(id, paymentMethodId)\n          replace((page) => ({\n            ...page,\n            data: page.data.map((s) =>\n              s.id === id ? { ...s, payment_method_id: paymentMethodId } : s\n            ),\n          }))\n        },\n        () =>\n          notify({\n            type: \"subscription.payment_method_changed\",\n            subscriptionId: id,\n            paymentMethodId,\n          })\n      ),\n    [act, client, notify, replace]\n  )\n\n  // An upgrade may open a successor subscription: notify refetches the list.\n  const changeTier = useCallback(\n    async (id: string, input: { priceId: string; idempotencyKey: string }) => {\n      mark(id, \"change_tier\")\n      try {\n        const change = await client.changeTier(id, input)\n        notify({\n          type: \"subscription.tier_changed\",\n          subscriptionId: id,\n          change,\n        })\n        return change\n      } catch (err) {\n        return toBillingError(err)\n      } finally {\n        mark(id, null)\n      }\n    },\n    [client, mark, notify]\n  )\n\n  return {\n    subscriptions: remote.data?.data ?? null,\n    total: remote.data?.total ?? null,\n    loading: remote.loading,\n    error: remote.error,\n    refetch: remote.refetch,\n    pending,\n    cancel,\n    cancelOnChain,\n    resume,\n    setPaymentMethod,\n    changeTier,\n  }\n}\n\nexport interface ProductsState {\n  products: Product[] | null\n  total: number | null\n  loading: boolean\n  error: BillingError | null\n  refetch: () => void\n}\n\n/** The catalog: active products with their active prices. */\nexport function useProducts(options: { limit?: number } = {}): ProductsState {\n  const { client } = useBillingContext()\n  const limit = options.limit ?? 100\n  const remote = useRemote(`${limit}`, (signal) =>\n    client.listProducts({ limit, signal })\n  )\n  return {\n    products: remote.data?.data ?? null,\n    total: remote.data?.total ?? null,\n    loading: remote.loading,\n    error: remote.error,\n    refetch: remote.refetch,\n  }\n}\n\nexport type PaymentMethodAction = \"remove\" | \"default\"\n\nexport interface PaymentMethodsState {\n  methods: PaymentMethod[] | null\n  loading: boolean\n  error: BillingError | null\n  refetch: () => void\n  pending: Readonly<Record<string, PaymentMethodAction>>\n  adding: boolean\n  add: (card: NewCard) => ActionResult\n  remove: (paymentMethodId: string) => ActionResult\n  /** Default collector for one currency's invoices. */\n  setDefault: (paymentMethodId: string, currency: string) => ActionResult\n}\n\nexport function usePaymentMethods(): PaymentMethodsState {\n  const { client, version, notify } = useBillingContext()\n  const remote = useRemote(`${version}`, (signal) =>\n    client.listPaymentMethods({ signal })\n  )\n  const [pending, mark] = usePending<PaymentMethodAction>()\n  const [adding, setAdding] = useState(false)\n  const { replace } = remote\n\n  const add = useCallback(\n    async (card: NewCard): ActionResult => {\n      setAdding(true)\n      try {\n        const method = await client.addPaymentMethod(card)\n        replace((page) => ({ ...page, data: [...page.data, method] }))\n        notify({ type: \"payment_method.added\", paymentMethodId: method.id })\n        return null\n      } catch (err) {\n        return toBillingError(err)\n      } finally {\n        setAdding(false)\n      }\n    },\n    [client, notify, replace]\n  )\n\n  const remove = useCallback(\n    async (id: string): ActionResult => {\n      mark(id, \"remove\")\n      try {\n        await client.removePaymentMethod(id)\n        replace((page) => ({\n          ...page,\n          data: page.data.filter((m) => m.id !== id),\n        }))\n        notify({ type: \"payment_method.removed\", paymentMethodId: id })\n        return null\n      } catch (err) {\n        return toBillingError(err)\n      } finally {\n        mark(id, null)\n      }\n    },\n    [client, mark, notify, replace]\n  )\n\n  const setDefault = useCallback(\n    async (id: string, currency: string): ActionResult => {\n      mark(id, \"default\")\n      try {\n        await client.setDefaultPaymentMethod({ currency, paymentMethodId: id })\n        const code = currency.toUpperCase()\n        replace((page) => ({\n          ...page,\n          data: page.data.map((m) => {\n            const others = (m.collection_default_currencies ?? []).filter(\n              (c) => c !== code\n            )\n            return {\n              ...m,\n              collection_default_currencies:\n                m.id === id ? [...others, code] : others,\n            }\n          }),\n        }))\n        notify({ type: \"payment_method.default_changed\", paymentMethodId: id })\n        return null\n      } catch (err) {\n        return toBillingError(err)\n      } finally {\n        mark(id, null)\n      }\n    },\n    [client, mark, notify, replace]\n  )\n\n  return {\n    methods: remote.data?.data ?? null,\n    loading: remote.loading,\n    error: remote.error,\n    refetch: remote.refetch,\n    pending,\n    adding,\n    add,\n    remove,\n    setDefault,\n  }\n}\n\nexport interface PaymentsOptions {\n  pageSize?: number\n  /** Filter by rail. */\n  rail?: string\n}\n\nexport interface PaymentsState {\n  payments: Payment[] | null\n  /** Zero-based. */\n  page: number\n  hasMore: boolean\n  total: number | null\n  loading: boolean\n  error: BillingError | null\n  next: () => void\n  previous: () => void\n  refetch: () => void\n}\n\nexport function usePayments(options: PaymentsOptions = {}): PaymentsState {\n  const { client, version } = useBillingContext()\n  const pageSize = options.pageSize ?? 20\n  const [page, setPage] = useState(0)\n  const remote = useRemote(\n    `${pageSize}|${options.rail ?? \"\"}|${page}|${version}`,\n    (signal) =>\n      client.listPayments({\n        limit: pageSize,\n        offset: page * pageSize,\n        rail: options.rail,\n        signal,\n      })\n  )\n  const data = remote.data\n  const total = data?.total ?? null\n  const hasMore =\n    data?.has_more ??\n    (total !== null\n      ? (page + 1) * pageSize < total\n      : data?.data.length === pageSize)\n  return {\n    payments: data?.data ?? null,\n    page,\n    hasMore: !!hasMore,\n    total,\n    loading: remote.loading,\n    error: remote.error,\n    next: useCallback(() => setPage((p) => p + 1), []),\n    previous: useCallback(() => setPage((p) => Math.max(0, p - 1)), []),\n    refetch: remote.refetch,\n  }\n}\n"],"mappings":"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"}

package/dist/i18n/context.d.ts

@@ -0,0 +1,4 @@
+import { Translator } from './messages.ts';
+export declare const MessagesContext: import('react').Context<Translator>;
+/** English defaults when rendered outside an `BillingUiProvider`. */
+export declare function useMessages(): Translator;

package/dist/i18n/index.d.ts

@@ -0,0 +1,2 @@
+export { useMessages } from './context.ts';
+export { createTranslator, defaultMessages, defineMessages, interpolate, resolveMessages, type BillingUiMessageBundle, type BillingUiMessages, type BillingUiTranslate, type MessageKey, type MessageVars, type PluralKey, type PluralMessage, type Translator, } from './messages.ts';

package/dist/i18n/messages.d.ts

@@ -0,0 +1,58 @@
+import { en } from '../locales/en.ts';
+/**
+ * A count-dependent message: CLDR plural categories for the locale, with
+ * `other` required. An exact-count key (`"1"`) wins over the category, like
+ * ICU's `=1`, for locales whose single form differs from `{count}` (毎日).
+ */
+export type PluralMessage = {
+    [K in Intl.LDMLPluralRule | "1"]?: string;
+} & {
+    other: string;
+};
+type Widen<T> = {
+    [K in keyof T]: T[K] extends string ? string : T[K] extends PluralMessage ? PluralMessage : Widen<T[K]>;
+};
+/** The complete message tree; English is the reference shape. */
+export type BillingUiMessages = Widen<typeof en>;
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends string ? string : T[K] extends PluralMessage ? Partial<PluralMessage> : DeepPartial<T[K]>;
+};
+/** A locale bundle or host override: any subset of the tree. */
+export type BillingUiMessageBundle = DeepPartial<BillingUiMessages>;
+type Paths<T, P extends string = ""> = {
+    [K in keyof T & string]: T[K] extends string ? `${P}${K}` : T[K] extends PluralMessage ? never : Paths<T[K], `${P}${K}.`>;
+}[keyof T & string];
+type PluralPaths<T, P extends string = ""> = {
+    [K in keyof T & string]: T[K] extends string ? never : T[K] extends PluralMessage ? `${P}${K}` : PluralPaths<T[K], `${P}${K}.`>;
+}[keyof T & string];
+/** Dotted key of any message, e.g. `subscriptions.title`. */
+export type MessageKey = Paths<BillingUiMessages>;
+/** Dotted key of a count-dependent message, e.g. `interval.every.day`. */
+export type PluralKey = PluralPaths<BillingUiMessages>;
+export type MessageVars = Record<string, string | number>;
+/**
+ * Host translation hook. Receives the bare key (`subscriptions.title`,
+ * `errors.not_found`); return nothing or the key itself to use ours.
+ */
+export type BillingUiTranslate = (key: string, vars?: MessageVars) => string | null | undefined;
+/** Types a locale bundle or override against the message tree. */
+export declare function defineMessages(bundle: BillingUiMessageBundle): BillingUiMessageBundle;
+export declare const defaultMessages: BillingUiMessages;
+/** Layers bundles over English; later bundles win, missing keys fall back. */
+export declare function resolveMessages(bundles?: BillingUiMessageBundle | readonly BillingUiMessageBundle[]): BillingUiMessages;
+export declare function interpolate(template: string, vars?: MessageVars): string;
+export interface Translator {
+    messages: BillingUiMessages;
+    /** BCP 47 tag used for plural rules and numbers; the runtime's when unset. */
+    locale?: string;
+    t(key: MessageKey, vars?: MessageVars): string;
+    /**
+     * Count-dependent message: tries `<key>.<count>`, then the locale's plural
+     * category, then `<key>.other`. `{count}` is locale-formatted.
+     */
+    plural(key: PluralKey, count: number, vars?: MessageVars): string;
+    /** Message for an billing error, error code, or thrown value. */
+    error(error: unknown, vars?: MessageVars): string;
+}
+export declare function createTranslator(messages: BillingUiMessages, hostT?: BillingUiTranslate, locale?: string): Translator;
+export {};

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+export { BillingUiProvider, type BillingUiProviderProps } from './provider';
+export { BillingUiRoot } from './scope';
+export type { Navigate } from './scope-context';
+export { AccountBilling, type AccountBillingProps, } from './account/account-billing';
+export { SubscriptionsPanel, type SubscriptionsPanelProps, } from './account/subscriptions-panel';
+export { CancelSubscriptionDialog, type CancelSubscriptionDialogProps, } from './account/cancel-dialog';
+export { PaymentMethodsPanel, type PaymentMethodsPanelProps, } from './account/payment-methods-panel';
+export { SavePaymentMethod, type SavePaymentMethodProps, } from './save-payment-method';
+export { authenticatePayment } from './authenticate';
+export { canAuthenticatePayment, canSavePaymentMethod, cardSetupDriver, checkoutPsps, checkoutRails, isCardRail, pspConfigSchema, savedMethodsFor, type CardSetupDriver, type CheckoutRailOffer, type PspConfig, } from './psp';
+export { PaymentHistory, type PaymentHistoryProps, } from './account/payment-history';
+export { BillingStatusBadge, type BillingStatusBadgeProps, } from './account/status-badge';
+export { statusTone, type StatusTone } from './account/format';
+export { createTranslator, defaultMessages, defineMessages, interpolate, resolveMessages, useMessages, type BillingUiMessageBundle, type BillingUiMessages, type BillingUiTranslate, type MessageKey, type PluralKey, type PluralMessage, type MessageVars, type Translator, } from './i18n';
+export { Checkout, type CheckoutLayout, type CheckoutProps } from './checkout';
+export { CheckoutModal, type CheckoutModalProps } from './modal';
+export { CheckoutPage, type CheckoutPageProps } from './checkout-page';
+export { CheckoutFrame, type CheckoutFrameProps } from './checkout-frame';
+export type { CheckoutFrameTheme } from './frame';
+export { CardBrandPlate } from './components/card-brands';
+export { resolveCardBrand, type CardBrand } from './lib/card-brands';
+export { createHttpSource, CheckoutSourceError, type CheckoutSource, } from './source';
+export { createFixtureSource, fixtureSession } from './fixtures';
+export { browserCountry, initialCountry } from './lib/billing';
+export { addAmounts, amountToDecimal, formatAmount, isAmount, type Amount, } from './lib/money';
+export { type CheckoutAppearance, type CheckoutAppearance as BillingAppearance, type CheckoutTheme, type CheckoutVariables, } from './appearance';
+export type { CheckoutLineItem, CheckoutPhase, CheckoutPlan, CheckoutSession, CheckoutSessionStatus, PaymentFailure, PaymentRailOption, PayRequest, PayResult, SavedPaymentMethod, } from './types';
+export { amountSchema, checkoutLineItemSchema, checkoutPlanSchema, checkoutSessionSchema, checkoutSessionStatusSchema, paymentFailureSchema, payRequestSchema, payResultSchema, paymentRailOptionSchema, savedPaymentMethodSchema, unitDecimalsSchema, } from './types';
+export { TokenizedCardForm, type TokenizedCardFormProps, type TokenizedCardData, } from './tokenized-card-form';