@ramp-kit/react 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Armando Cruz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# @ramp-kit/react
+
+Drop-in React UI for LATAM fiat on/off-ramps on Stellar. Embeds a complete
+onramp flow — live quote with countdown, PIX/SPEI deposit instructions, order
+tracking to settlement — on top of any
+[@ramp-kit/core](https://www.npmjs.com/package/@ramp-kit/core) provider
+(Etherfuse, Manteca, or the built-in mock).
+
+## Install
+
+```bash
+npm install @ramp-kit/core @ramp-kit/react
+```
+
+React ≥ 18 is a peer dependency.
+
+## `<RampWidget />`
+
+```tsx
+import { EtherfuseProvider } from "@ramp-kit/core";
+import { RampWidget } from "@ramp-kit/react";
+
+const provider = new EtherfuseProvider({ apiKey, environment: "sandbox" });
+
+<RampWidget
+  provider={provider}
+  customerId={orgId}
+  fiatCurrency="BRL"
+  network="stellar"
+  walletAddress={userWallet}
+  assets={await provider.listAssets("stellar", { currency: "brl" })}
+  onOrderCreated={(id) => console.log("order", id)}
+  onSettled={(id) => console.log("funds delivered", id)}
+/>;
+```
+
+The widget walks the user through a 3-step flow:
+
+1. **Amount** — amount + asset selection, live quote with expiry countdown
+   that re-quotes automatically when the provider's price expires.
+2. **Deposit** — rail-aware instructions (PIX charge vs. SPEI CLABE) with a
+   live status indicator polled until terminal state.
+3. **Done** — conversion summary and on-chain transaction hash.
+
+### Props
+
+| Prop | Type | Description |
+| --- | --- | --- |
+| `provider` | `RampProvider` | Any @ramp-kit/core provider instance |
+| `customerId` | `string` | Provider-side customer id (org UUID for Etherfuse, userAnyId for Manteca) |
+| `fiatCurrency` | `"BRL" \| "MXN" \| …` | Fiat leg of the ramp |
+| `network` | `Network` | Settlement network (default `"stellar"`) |
+| `walletAddress` | `string?` | Destination wallet for onramps |
+| `assets` | `RampAsset[]` | Assets to offer (from `provider.listAssets()`) |
+| `onOrderCreated` | `(orderId) => void` | Fired when the order is accepted |
+| `onSettled` | `(orderId) => void` | Fired when funds are delivered |
+
+Styling: neutral inline styles plus `rk-` class names (`rk-widget`,
+`rk-quote`, `rk-deposit`, `rk-done`) so you can theme it from your own CSS.
+
+## Hooks (build your own UI)
+
+```tsx
+import { useQuote, useOrder } from "@ramp-kit/react";
+
+// Live quote that refreshes itself when it expires
+const { quote, loading, error, secondsLeft, refresh } = useQuote(provider, {
+  direction: "onramp",
+  fiatCurrency: "BRL",
+  assetIdentifier: usdc.identifier,
+  network: "stellar",
+  sourceAmount: "100",
+  customerId,
+});
+
+// Order polling that stops at settled/failed/cancelled
+const { order, polling } = useOrder(provider, orderId);
+```
+
+## Instant development with the mock provider
+
+```tsx
+import { MockProvider } from "@ramp-kit/core";
+
+// Realistic lifecycle without credentials; auto-funds orders after 4s
+const provider = new MockProvider({ autoFundMs: 4000 });
+```
+
+Two demo apps (a full sandbox demo on Stellar Testnet and a second minimal
+integration) live in the
+[latam-ramp-kit repository](https://github.com/armandocodecr/latam-ramp-kit).
+
+## AI tooling
+
+Building this integration with an AI coding agent? Install the kit's agent
+skill (`npx skills add https://github.com/armandocodecr/latam-ramp-kit/tree/main/skills/ramp-kit`)
+and the [@ramp-kit/mcp](https://www.npmjs.com/package/@ramp-kit/mcp) MCP
+server — the agent gets integration knowledge, verified troubleshooting,
+and live tools to quote and test orders against the sandbox.
+
+MIT © [Armando Cruz](https://github.com/armandocodecr)

package/dist/RampWidget.d.ts

@@ -0,0 +1,23 @@
+import type { FiatCurrency, Network, RampAsset, RampProvider } from "@ramp-kit/core";
+export interface RampWidgetProps {
+    provider: RampProvider;
+    /** Provider-side customer id (org UUID for Etherfuse, userAnyId for Manteca). */
+    customerId: string;
+    fiatCurrency: FiatCurrency;
+    network?: Network;
+    /** Destination wallet address for onramps. */
+    walletAddress?: string;
+    /** Assets to offer. Fetch with provider.listAssets() and pass down. */
+    assets: RampAsset[];
+    onOrderCreated?: (orderId: string) => void;
+    onSettled?: (orderId: string) => void;
+}
+/**
+ * Embeddable onramp flow: amount + asset → live quote → order →
+ * deposit instructions → status tracking until settled.
+ *
+ * Neutral inline styles + `rk-` class names so it drops into any app
+ * and can be themed via CSS.
+ */
+export declare function RampWidget({ provider, customerId, fiatCurrency, network, walletAddress, assets, onOrderCreated, onSettled, }: RampWidgetProps): import("react").JSX.Element;
+//# sourceMappingURL=RampWidget.d.ts.map

package/dist/RampWidget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RampWidget.d.ts","sourceRoot":"","sources":["../src/RampWidget.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EAEP,SAAS,EACT,YAAY,EACb,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,CAAC;IACvB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uEAAuE;IACvE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAoBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,OAAmB,EACnB,aAAa,EACb,MAAM,EACN,cAAc,EACd,SAAS,GACV,EAAE,eAAe,+BAkOjB"}

package/dist/RampWidget.js

@@ -0,0 +1,241 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { useQuote, useOrder } from "./hooks.js";
+const STEPS = [
+    { key: "amount", label: "Amount" },
+    { key: "deposit", label: "Deposit" },
+    { key: "done", label: "Done" },
+];
+const STATUS_LABEL = {
+    created: "Order created",
+    awaiting_deposit: "Waiting for your deposit",
+    awaiting_signature: "Waiting for your signature",
+    processing: "Exchanging & settling on-chain",
+    settled: "Funds delivered",
+    failed: "Order failed",
+    cancelled: "Order cancelled",
+};
+/**
+ * Embeddable onramp flow: amount + asset → live quote → order →
+ * deposit instructions → status tracking until settled.
+ *
+ * Neutral inline styles + `rk-` class names so it drops into any app
+ * and can be themed via CSS.
+ */
+export function RampWidget({ provider, customerId, fiatCurrency, network = "stellar", walletAddress, assets, onOrderCreated, onSettled, }) {
+    const [amount, setAmount] = useState("");
+    const [assetId, setAssetId] = useState(assets[0]?.identifier ?? "");
+    const [orderId, setOrderId] = useState(null);
+    const [step, setStep] = useState("amount");
+    const [submitting, setSubmitting] = useState(false);
+    const [submitError, setSubmitError] = useState(null);
+    // Keep selection valid when the asset list changes (e.g. provider swap).
+    useEffect(() => {
+        if (!assets.some((a) => a.identifier === assetId)) {
+            setAssetId(assets[0]?.identifier ?? "");
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [assets]);
+    const request = useMemo(() => {
+        if (!amount || Number(amount) <= 0 || !assetId)
+            return null;
+        return {
+            direction: "onramp",
+            fiatCurrency,
+            assetIdentifier: assetId,
+            network,
+            sourceAmount: amount,
+            customerId,
+            walletAddress,
+        };
+    }, [amount, assetId, fiatCurrency, network, customerId, walletAddress]);
+    const { quote, loading, error, secondsLeft } = useQuote(step === "amount" ? provider : null, request);
+    const { order } = useOrder(provider, orderId);
+    useEffect(() => {
+        if (order?.status === "settled") {
+            setStep("done");
+            onSettled?.(order.id);
+        }
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [order?.status, order?.id]);
+    const confirm = async () => {
+        if (!quote)
+            return;
+        setSubmitting(true);
+        setSubmitError(null);
+        try {
+            const created = await provider.createOrder(quote);
+            setOrderId(created.id);
+            onOrderCreated?.(created.id);
+            setStep("deposit");
+        }
+        catch (err) {
+            const message = err.message;
+            // Sandbox accounts can be compliant yet lack rail provisioning.
+            setSubmitError(/proxy account/i.test(message)
+                ? `${message} — this bank account isn't provisioned for this rail; try another account`
+                : message);
+        }
+        finally {
+            setSubmitting(false);
+        }
+    };
+    const selectedAsset = assets.find((a) => a.identifier === assetId);
+    const stepIndex = STEPS.findIndex((s) => s.key === step);
+    const deposit = order?.depositInstructions;
+    const isTerminalFailure = order?.status === "failed" || order?.status === "cancelled";
+    return (_jsxs("div", { className: "rk-widget", style: styles.widget, children: [_jsx("div", { className: "rk-steps", style: styles.steps, children: STEPS.map((s, i) => (_jsxs("div", { style: styles.stepItem, children: [_jsx("div", { style: {
+                                ...styles.stepDot,
+                                ...(i < stepIndex ? styles.stepDotPast : {}),
+                                ...(i === stepIndex ? styles.stepDotActive : {}),
+                            }, children: i < stepIndex ? "✓" : i + 1 }), _jsx("span", { style: {
+                                ...styles.stepLabel,
+                                ...(i === stepIndex ? styles.stepLabelActive : {}),
+                            }, children: s.label }), i < STEPS.length - 1 && _jsx("div", { style: styles.stepLine })] }, s.key))) }), step === "amount" && (_jsxs(_Fragment, { children: [_jsxs("label", { style: styles.label, children: ["You pay (", fiatCurrency, ")", _jsx("input", { style: styles.input, type: "number", min: "0", value: amount, placeholder: "100", onChange: (e) => setAmount(e.target.value) })] }), _jsxs("label", { style: styles.label, children: ["You receive", _jsx("select", { style: styles.input, value: assetId, onChange: (e) => setAssetId(e.target.value), children: assets.map((a) => (_jsxs("option", { value: a.identifier, children: [a.symbol, " \u00B7 ", a.network] }, a.identifier))) })] }), loading && _jsx("p", { style: styles.muted, children: "Fetching live quote\u2026" }), error && _jsx("p", { style: styles.error, children: error.message }), quote && !loading && (_jsxs("div", { className: "rk-quote", style: styles.quoteBox, children: [_jsxs("div", { style: styles.quoteRow, children: [_jsxs("span", { style: styles.big, children: ["\u2248 ", trim(quote.targetAmount), " ", selectedAsset?.symbol] }), _jsxs("span", { style: styles.pill, children: [secondsLeft, "s"] })] }), _jsx("div", { style: styles.countdownTrack, children: _jsx("div", { style: {
+                                        ...styles.countdownBar,
+                                        width: `${Math.min(100, (secondsLeft / 120) * 100)}%`,
+                                    } }) }), _jsxs("p", { style: styles.muted, children: ["Rate ", trim(quote.rate), quote.fees ? ` · fee ${quote.fees} ${fiatCurrency}` : ""] }), _jsx("button", { style: styles.button, disabled: submitting, onClick: confirm, children: submitting ? "Creating order…" : "Continue" }), submitError && _jsx("p", { style: styles.error, children: submitError })] }))] })), step === "deposit" && (_jsxs("div", { className: "rk-deposit", style: styles.depositBox, children: [deposit ? (_jsxs(_Fragment, { children: [_jsxs("div", { style: styles.quoteRow, children: [_jsx("span", { style: styles.railBadge, children: deposit.rail }), _jsxs("span", { style: styles.big, children: [deposit.amount, " ", deposit.currency] })] }), _jsx("p", { style: styles.muted, children: deposit.rail === "PIX"
+                                    ? "Pay this PIX charge to fund your order:"
+                                    : "Send the exact amount to this account:" }), _jsxs("p", { style: styles.mono, children: [deposit.address, deposit.alias ? ` · ${deposit.alias}` : ""] })] })) : (_jsx("p", { style: styles.muted, children: "Loading deposit instructions\u2026" })), _jsxs("div", { style: styles.statusRow, children: [_jsx("span", { style: {
+                                    ...styles.statusDot,
+                                    background: isTerminalFailure
+                                        ? "#c0392b"
+                                        : order?.status === "processing"
+                                            ? "#e67e22"
+                                            : "#3498db",
+                                } }), _jsx("span", { style: styles.statusText, children: STATUS_LABEL[order?.status ?? "created"] })] }), isTerminalFailure && (_jsx("p", { style: styles.error, children: order?.failureReason ?? "Order failed" }))] })), step === "done" && (_jsxs("div", { className: "rk-done", style: styles.doneBox, children: [_jsx("div", { style: styles.doneIcon, children: "\u2713" }), _jsx("p", { style: styles.big, children: "Funds delivered" }), order?.quote && (_jsxs("p", { style: styles.muted, children: [order.quote.request.sourceAmount, " ", order.quote.request.fiatCurrency, " \u2192", " ", trim(order.quote.targetAmount), " ", selectedAsset?.symbol, " on", " ", network] })), order?.txHash && (_jsxs("p", { style: styles.mono, children: ["tx ", order.txHash.slice(0, 10), "\u2026", order.txHash.slice(-8)] }))] }))] }));
+}
+function trim(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n.toLocaleString("en-US", { maximumFractionDigits: 4 }) : value;
+}
+const styles = {
+    widget: {
+        maxWidth: 400,
+        padding: 20,
+        borderRadius: 14,
+        border: "1px solid #e4e4e7",
+        background: "#fff",
+        fontFamily: "system-ui, sans-serif",
+        display: "flex",
+        flexDirection: "column",
+        gap: 14,
+    },
+    steps: { display: "flex", alignItems: "center", gap: 6 },
+    stepItem: { display: "flex", alignItems: "center", gap: 6, flex: "1 1 0" },
+    stepDot: {
+        width: 22,
+        height: 22,
+        borderRadius: "50%",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        fontSize: 11,
+        fontWeight: 600,
+        background: "#f4f4f5",
+        color: "#71717a",
+        flexShrink: 0,
+    },
+    stepDotActive: { background: "#18181b", color: "#fff" },
+    stepDotPast: { background: "#dcfce7", color: "#16a34a" },
+    stepLabel: { fontSize: 12, color: "#a1a1aa" },
+    stepLabelActive: { color: "#18181b", fontWeight: 600 },
+    stepLine: { flex: 1, height: 1, background: "#e4e4e7" },
+    label: { display: "flex", flexDirection: "column", gap: 4, fontSize: 13, color: "#3f3f46" },
+    input: {
+        padding: 10,
+        borderRadius: 10,
+        border: "1px solid #d4d4d8",
+        fontSize: 16,
+        background: "#fff",
+    },
+    quoteBox: {
+        padding: 14,
+        borderRadius: 10,
+        background: "#fafafa",
+        border: "1px solid #f0f0f1",
+        display: "flex",
+        flexDirection: "column",
+        gap: 8,
+    },
+    quoteRow: {
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "space-between",
+        gap: 8,
+    },
+    countdownTrack: {
+        height: 3,
+        borderRadius: 2,
+        background: "#e4e4e7",
+        overflow: "hidden",
+    },
+    countdownBar: {
+        height: "100%",
+        background: "#18181b",
+        transition: "width 1s linear",
+    },
+    pill: {
+        fontSize: 12,
+        padding: "2px 8px",
+        borderRadius: 999,
+        background: "#f4f4f5",
+        color: "#52525b",
+        fontVariantNumeric: "tabular-nums",
+    },
+    railBadge: {
+        fontSize: 12,
+        fontWeight: 700,
+        letterSpacing: 0.5,
+        padding: "3px 10px",
+        borderRadius: 999,
+        background: "#ecfdf5",
+        color: "#047857",
+        border: "1px solid #a7f3d0",
+    },
+    button: {
+        padding: "11px 16px",
+        borderRadius: 10,
+        border: "none",
+        background: "#18181b",
+        color: "#fff",
+        fontSize: 15,
+        fontWeight: 600,
+        cursor: "pointer",
+    },
+    depositBox: { display: "flex", flexDirection: "column", gap: 10 },
+    statusRow: { display: "flex", alignItems: "center", gap: 8, marginTop: 4 },
+    statusDot: { width: 8, height: 8, borderRadius: "50%", flexShrink: 0 },
+    statusText: { fontSize: 13, color: "#3f3f46" },
+    doneBox: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        gap: 6,
+        padding: "10px 0",
+        textAlign: "center",
+    },
+    doneIcon: {
+        width: 44,
+        height: 44,
+        borderRadius: "50%",
+        background: "#dcfce7",
+        color: "#16a34a",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        fontSize: 22,
+        fontWeight: 700,
+    },
+    big: { fontSize: 19, fontWeight: 600, margin: 0, color: "#18181b" },
+    muted: { fontSize: 13, color: "#71717a", margin: 0 },
+    mono: {
+        fontFamily: "ui-monospace, monospace",
+        wordBreak: "break-all",
+        fontSize: 13,
+        color: "#3f3f46",
+        margin: 0,
+    },
+    error: { color: "#c0392b", fontSize: 13, margin: 0 },
+};
+//# sourceMappingURL=RampWidget.js.map

package/dist/RampWidget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RampWidget.js","sourceRoot":"","sources":["../src/RampWidget.tsx"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -0,0 +1,28 @@
+import type { QuoteRequest, RampOrder, RampProvider, RampQuote } from "@ramp-kit/core";
+export interface UseQuoteResult {
+    quote: RampQuote | null;
+    loading: boolean;
+    error: Error | null;
+    /** Seconds until the current quote expires (0 when expired/none). */
+    secondsLeft: number;
+    refresh: () => void;
+}
+/**
+ * Fetch a quote and keep it fresh: re-quotes automatically when the
+ * provider-reported expiry passes (Etherfuse: 2 min, Manteca price locks:
+ * asset-dependent).
+ */
+export declare function useQuote(provider: RampProvider | null, request: QuoteRequest | null, options?: {
+    autoRefresh?: boolean;
+}): UseQuoteResult;
+export interface UseOrderResult {
+    order: RampOrder | null;
+    error: Error | null;
+    /** True while the order is in a non-terminal state and being polled. */
+    polling: boolean;
+}
+/** Poll an order until it reaches a terminal state. */
+export declare function useOrder(provider: RampProvider | null, orderId: string | null, options?: {
+    intervalMs?: number;
+}): UseOrderResult;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,OAAO,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,cAAc,CAoDhB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,wEAAwE;IACxE,OAAO,EAAE,OAAO,CAAC;CAClB;AAID,uDAAuD;AACvD,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,cAAc,CAsChB"}

package/dist/hooks.js

@@ -0,0 +1,99 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+/**
+ * Fetch a quote and keep it fresh: re-quotes automatically when the
+ * provider-reported expiry passes (Etherfuse: 2 min, Manteca price locks:
+ * asset-dependent).
+ */
+export function useQuote(provider, request, options = {}) {
+    const autoRefresh = options.autoRefresh ?? true;
+    const [quote, setQuote] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [secondsLeft, setSecondsLeft] = useState(0);
+    const [nonce, setNonce] = useState(0);
+    const refresh = useCallback(() => setNonce((n) => n + 1), []);
+    // Serialize to avoid re-fetch loops on caller-side object literals.
+    const requestKey = request ? JSON.stringify(request) : null;
+    useEffect(() => {
+        if (!provider || !requestKey)
+            return;
+        const parsed = JSON.parse(requestKey);
+        let cancelled = false;
+        setLoading(true);
+        setError(null);
+        provider
+            .getQuote(parsed)
+            .then((q) => {
+            if (!cancelled)
+                setQuote(q);
+        })
+            .catch((err) => {
+            if (!cancelled)
+                setError(err);
+        })
+            .finally(() => {
+            if (!cancelled)
+                setLoading(false);
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [provider, requestKey, nonce]);
+    // Countdown + auto-refresh on expiry.
+    useEffect(() => {
+        if (!quote)
+            return;
+        const tick = () => {
+            const left = Math.max(0, Math.floor((quote.expiresAt.getTime() - Date.now()) / 1000));
+            setSecondsLeft(left);
+            if (left === 0 && autoRefresh)
+                refresh();
+        };
+        tick();
+        const timer = setInterval(tick, 1000);
+        return () => clearInterval(timer);
+    }, [quote, autoRefresh, refresh]);
+    return { quote, loading, error, secondsLeft, refresh };
+}
+const TERMINAL_STATES = new Set(["settled", "failed", "cancelled"]);
+/** Poll an order until it reaches a terminal state. */
+export function useOrder(provider, orderId, options = {}) {
+    const intervalMs = options.intervalMs ?? 4000;
+    const [order, setOrder] = useState(null);
+    const [error, setError] = useState(null);
+    const [polling, setPolling] = useState(false);
+    const stopped = useRef(false);
+    useEffect(() => {
+        if (!provider || !orderId)
+            return;
+        stopped.current = false;
+        setPolling(true);
+        const poll = async () => {
+            try {
+                const o = await provider.getOrder(orderId);
+                if (stopped.current)
+                    return;
+                setOrder(o);
+                if (TERMINAL_STATES.has(o.status)) {
+                    setPolling(false);
+                    return;
+                }
+            }
+            catch (err) {
+                if (!stopped.current)
+                    setError(err);
+            }
+            if (!stopped.current) {
+                timer = setTimeout(poll, intervalMs);
+            }
+        };
+        let timer = setTimeout(poll, 0);
+        return () => {
+            stopped.current = true;
+            clearTimeout(timer);
+            setPolling(false);
+        };
+    }, [provider, orderId, intervalMs]);
+    return { order, error, polling };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { useQuote, useOrder } from "./hooks.js";
+export type { UseQuoteResult, UseOrderResult } from "./hooks.js";
+export { RampWidget } from "./RampWidget.js";
+export type { RampWidgetProps } from "./RampWidget.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { useQuote, useOrder } from "./hooks.js";
+export { RampWidget } from "./RampWidget.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ramp-kit/react",
+  "version": "0.1.2",
+  "description": "React onramp widget and hooks for LATAM ramps on Stellar: 3-step embeddable flow with live quote countdown, PIX/SPEI deposit instructions and order tracking to settlement, over any @ramp-kit/core provider",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "dependencies": {
+    "@ramp-kit/core": "0.1.2"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "typescript": "^5.6.0"
+  },
+  "license": "MIT",
+  "author": "Armando Cruz (https://github.com/armandocodecr)",
+  "homepage": "https://github.com/armandocodecr/latam-ramp-kit#readme",
+  "bugs": {
+    "url": "https://github.com/armandocodecr/latam-ramp-kit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "keywords": [
+    "stellar",
+    "onramp",
+    "react",
+    "widget",
+    "latam",
+    "pix",
+    "ramp",
+    "usdc"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/armandocodecr/latam-ramp-kit.git",
+    "directory": "packages/react"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}