@getpara/react-sdk-lite 2.8.0 → 2.10.0

package/dist/modal/components/VerificationCodeStep/VerificationCodeStep.js

@@ -113,13 +113,14 @@ const VerificationCode = ({ authInfo, onResend, onSubmit, status, error }) => {
               errorText: codeError || "",
               onKeyDown: (e) => __async(void 0, null, function* () {
                 return e.key === "Enter" && (yield handleSubmitCode());
-              })
+              }),
+              "data-testid": "para-otp-input"
             }
           )
         }
       ),
       /* @__PURE__ */ jsxs(InlineText, { variant: "bodyS", color: "secondary", children: [
-        "Didn\u2019t receive a code?",
+        "Didn't receive a code?",
         " ",
         /* @__PURE__ */ jsx(
           ClickableText,
@@ -127,6 +128,7 @@ const VerificationCode = ({ authInfo, onResend, onSubmit, status, error }) => {
             variant: "bodyS",
             style: { cursor: resendDisabled ? "default" : "pointer" },
             onClick: handleResendClick,
+            "data-testid": "para-otp-resend",
             children: resendDisabled ? "Resent!" : "Resend."
           }
         )

package/dist/modal/components/WalletCreationDoneStep/WalletCreationDoneStep.js

@@ -68,10 +68,10 @@ const WalletCreationDoneStep = ({ twoFactorAuthEnabled, onClose }) => {
     /* @__PURE__ */ jsx(CardContainer, { children: hideWallets ? /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsx(HeroIcon, { icon: "checkCircleFilled" }),
       /* @__PURE__ */ jsx(CpslText, { variant: "bodyM", color: "secondary", weight: "medium", style: { marginTop: "16px" }, children: "Your account has been created." })
-    ] }) : /* @__PURE__ */ jsx(WalletCards, { children: para.currentWalletIdsArray.map(([id, type]) => {
+    ] }) : /* @__PURE__ */ jsx(WalletCards, { "data-testid": "para-wallet-card", children: para.currentWalletIdsArray.map(([id, type]) => {
       return /* @__PURE__ */ jsx(WalletCard, { id, type, showAddFunds: isOnRampConfigured }, id);
     }) }) }),
-    /* @__PURE__ */ jsx(InnerStepContainer, { children: /* @__PURE__ */ jsx(CpslButton, { fullWidth: true, onClick: handleNext, disabled: isWaiting, children: twoFactorAuthEnabled ? "Continue" : "Done" }) })
+    /* @__PURE__ */ jsx(InnerStepContainer, { children: /* @__PURE__ */ jsx(CpslButton, { fullWidth: true, onClick: handleNext, disabled: isWaiting, "data-testid": "para-done-button", children: twoFactorAuthEnabled ? "Continue" : "Done" }) })
   ] });
 };
 const CardContainer = safeStyled(InnerStepContainer)`

package/dist/modal/components/common.d.ts

@@ -10,7 +10,7 @@ export declare const FullWidthFilledDisabledInput: typeof CpslInput;
 export declare const CenteredText: typeof CpslText;
 export declare const InnerStepContainer: import("styled-components/dist/types.js").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
 export declare const StepContainer: import("styled-components/dist/types.js").IStyledComponentBase<"web", import("styled-components/dist/types.js").Substitute<Omit<import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>, "ref"> & {
-    ref?: import("react").RefObject<HTMLDivElement> | ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | null | undefined;
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
 }, {
     $wide?: boolean;
 }>> & string;

package/dist/modal/stores/modal/actions.js

@@ -139,7 +139,8 @@ const getActions = (set, get) => ({
   setIsPasskeySupported: (isPasskeySupported) => set({ isPasskeySupported }),
   setAccountLinkOptions: (accountLinkOptions) => set({ accountLinkOptions }),
   setProfileWallet: (profileWallet) => set({ profileWallet }),
-  setSendTx: (sendTx) => set({ sendTx })
+  setSendTx: (sendTx) => set({ sendTx }),
+  setIsTestModeAlertDismissed: (isTestModeAlertDismissed) => set({ isTestModeAlertDismissed })
 });
 export {
   getActions

package/dist/modal/stores/modal/useModalStore.d.ts

@@ -62,6 +62,7 @@ interface ModalState {
     accountLinkOptions: SupportedAccountLinks;
     profileWallet?: AvailableWallet;
     sendTx: BroadcastTransactionResult | null;
+    isTestModeAlertDismissed: boolean;
 }
 export interface ModalActions {
     resetState: () => void;
@@ -102,6 +103,7 @@ export interface ModalActions {
     setAccountLinkOptions: (_: SupportedAccountLinks) => void;
     setProfileWallet: (_?: AvailableWallet) => void;
     setSendTx: (_: BroadcastTransactionResult | null) => void;
+    setIsTestModeAlertDismissed: (_: boolean) => void;
 }
 export type ModalStore = ModalState & ModalActions;
 export declare const DEFAULT_MODAL_STATE: Omit<ModalState, 'step' | 'onRampConfig'>;

package/dist/modal/stores/modal/useModalStore.js

@@ -50,7 +50,8 @@ const DEFAULT_MODAL_STATE = {
   isPasskeySupported: true,
   accountLinkOptions: [...LINKED_ACCOUNT_TYPES],
   profileWallet: void 0,
-  sendTx: null
+  sendTx: null,
+  isTestModeAlertDismissed: false
 };
 const useModalStore = create()(
   persist(

package/dist/modal/types/modalProps.d.ts

@@ -74,7 +74,9 @@ export interface ParaModalProps {
      */
     logo?: string;
     /**
-     * Whether or not to run configured on-ramp providers in test mode.
+     * Whether to run configured on-ramp providers in test mode in the PROD environment.
+     *
+     * On-ramp and off-ramp widgets will always run in test mode outside of PROD.
      */
     onRampTestMode?: boolean;
     /**

package/dist/modal/utils/validatePortalOrigin.js

@@ -5,6 +5,12 @@ const validatePortalOrigin = (event, paraCtx) => {
   const portalBase = getPortalBaseURL(paraCtx);
   const portalLocalBase = getPortalBaseURL(paraCtx, true);
   const normalizedOrigin = event.origin.replace("usecapsule", "getpara");
+  if (paraCtx.portalUrlOverride) {
+    const allowedPatterns = [/^https:\/\/\d+-portal\.preview\.sandbox\.getpara\.com$/, /^https?:\/\/localhost:\d+$/];
+    const overrideOrigin = new URL(paraCtx.portalUrlOverride).origin;
+    const isAllowed = allowedPatterns.some((pattern) => pattern.test(overrideOrigin));
+    if (isAllowed && normalizedOrigin === overrideOrigin) return true;
+  }
   if (normalizedOrigin !== portalBase && normalizedOrigin !== portalLocalBase) {
     return false;
   }

package/dist/provider/ParaProviderMin.js

@@ -101,6 +101,9 @@ const ParaProviderMin = forwardRef(({ children, paraClientConfig, callbacks, con
     }
     const newClient = isParaWeb(paraClientConfig) ? paraClientConfig : paraClientConfig.env ? new ParaWeb(paraClientConfig.env, paraClientConfig.apiKey, paraClientConfig.opts) : new ParaWeb(paraClientConfig.apiKey, paraClientConfig.opts);
     newClient.setModalError = setModalError;
+    if (typeof globalThis !== "undefined" && globalThis.__PARA_PORTAL_URL_OVERRIDE__) {
+      newClient.ctx.portalUrlOverride = globalThis.__PARA_PORTAL_URL_OVERRIDE__;
+    }
     newClient.portalTheme = paraModalConfig == null ? void 0 : paraModalConfig.theme;
     if (newClient.isReady) {
       setIsClientReady(true);

package/dist/provider/hooks/queries/useProfileBalance.js

@@ -1,13 +1,15 @@
 "use client";
 import {
-  __async
+  __async,
+  __spreadProps,
+  __spreadValues
 } from "../../../chunk-MMUBH76A.js";
 import { useQuery } from "@tanstack/react-query";
-import { useRef, useEffect } from "react";
+import { useRef, useEffect, useMemo } from "react";
 import { useStore } from "../../stores/useStore.js";
 import { useInternalClient } from "../utils/useInternalClient.js";
 import { useIsFullyLoggedIn } from "./useIsFullyLoggedIn.js";
-import { filterProfileBalance } from "@getpara/shared";
+import { filterProfileBalance, formatCurrency } from "@getpara/shared";
 const useProfileBalance = (options) => {
   var _a, _b, _c;
   const client = useInternalClient();
@@ -17,6 +19,7 @@ const useProfileBalance = (options) => {
     return (_a2 = state.modalConfig) == null ? void 0 : _a2.balances;
   });
   const refs = useStore((state) => state.refs);
+  const balanceOverrides = useStore((state) => state.balanceOverrides);
   const isComprehensive = (_a = options == null ? void 0 : options.isComprehensive) != null ? _a : false;
   const previousTriggerRef = useRef(options == null ? void 0 : options.refetchTrigger);
   const shouldRefetchRef = useRef(false);
@@ -28,8 +31,10 @@ const useProfileBalance = (options) => {
       previousTriggerRef.current = options == null ? void 0 : options.refetchTrigger;
     }
   }, [options == null ? void 0 : options.refetchTrigger]);
-  return useQuery({
-    enabled: isSuccess && !!client,
+  const requiresOverrides = (config == null ? void 0 : config.useBalanceOverrides) && (config == null ? void 0 : config.displayType) === "AGGREGATED";
+  const shouldUseOverrides = requiresOverrides && !!balanceOverrides;
+  const query = useQuery({
+    enabled: isSuccess && !!client && (!requiresOverrides || !!balanceOverrides),
     queryKey: [
       "useProfileBalance",
       isFullyLoggedIn != null ? isFullyLoggedIn : null,
@@ -56,9 +61,31 @@ const useProfileBalance = (options) => {
       isInitialLoadRef.current = false;
       return isComprehensive ? profileBalance : filterProfileBalance(profileBalance, config || { displayType: "AGGREGATED" });
     }),
-    // We handle refetch manually
     refetchOnWindowFocus: false
   });
+  const data = useMemo(() => {
+    var _a2;
+    const raw = query.data;
+    if (!raw || !shouldUseOverrides) return raw;
+    const overrides = balanceOverrides.value;
+    const result = structuredClone(raw);
+    for (const [walletAddress, override] of Object.entries(overrides)) {
+      const wallet = result.wallets.find((w) => w.address === walletAddress);
+      if (((_a2 = wallet == null ? void 0 : wallet.value) == null ? void 0 : _a2.value) === void 0) continue;
+      if (typeof override !== "number" || !Number.isFinite(override)) continue;
+      wallet.value.value = override;
+      wallet.formattedValue = formatCurrency(wallet.value);
+    }
+    if (result.value) {
+      result.value.value = result.wallets.reduce((sum, wallet) => {
+        var _a3, _b2;
+        return sum + ((_b2 = (_a3 = wallet.value) == null ? void 0 : _a3.value) != null ? _b2 : 0);
+      }, 0);
+      result.formattedValue = formatCurrency(result.value);
+    }
+    return result;
+  }, [query.data, shouldUseOverrides, balanceOverrides == null ? void 0 : balanceOverrides.version]);
+  return __spreadProps(__spreadValues({}, query), { data: data != null ? data : void 0 });
 };
 export {
   useProfileBalance

package/dist/provider/hooks/utils/index.d.ts

@@ -1,3 +1,4 @@
 export { useClient } from './useClient.js';
 export { useModal } from './useModal.js';
 export { useWalletState } from './useWalletState.js';
+export { useSetBalanceOverrides } from './useSetBalanceOverrides.js';

package/dist/provider/hooks/utils/index.js

@@ -3,8 +3,10 @@ import "../../../chunk-MMUBH76A.js";
 import { useClient } from "./useClient.js";
 import { useModal } from "./useModal.js";
 import { useWalletState } from "./useWalletState.js";
+import { useSetBalanceOverrides } from "./useSetBalanceOverrides.js";
 export {
   useClient,
   useModal,
+  useSetBalanceOverrides,
   useWalletState
 };

package/dist/provider/hooks/utils/useSetBalanceOverrides.d.ts

@@ -0,0 +1,34 @@
+import { BalanceOverrides } from '@getpara/shared';
+/**
+ * Returns a function to set the balance overrides, similar to React `setState`. Use this once your balance overrides are available to modify or replace the displayed wallet balances in the Para Modal. Both the individual wallet and the cumulative total balance will be modified.
+ *
+ * If you have set `useBalanceOverrides` to `true` in your configuration, you must call this function at least once with a non-null value for balances to be displayed.
+ *
+ * **Behavior notes:**
+ * - Both numeric `value.value` and `formattedValue` strings are recalculated after overrides.
+ * - Wallets not present in the override map retain their original values.
+ * - Overrides are re-applied whenever the underlying balance data refetches; they do not need to be re-set.
+ * - Non-finite values (`NaN`, `Infinity`) are silently skipped.
+ *
+ * @example
+ * ```tsx
+ * import { useAccount, useSetBalanceOverrides } from '@getpara/react-sdk';
+ *
+ * const ComponentWithinParaProvider = () => {
+ *   const setBalanceOverrides = useSetBalanceOverrides();
+ *   const { embedded: embeddedWallets } = useAccount();
+ *
+ *   useEffect(() => {
+ *     const interval = setInterval(async () => {
+ *       const balances = await getBalancesFromYourApi({ addresses: embeddedWallets.map(w => w.address!) });
+ *
+ *       // Pass a Record<string, number> mapping wallet addresses to their new balance values:
+ *       setBalanceOverrides(balances);
+ *     }, 10000);
+ *     return () => clearInterval(interval);
+ *   }, [embeddedWallets, setBalanceOverrides]);
+ *
+ *   // ...
+ * ```
+ */
+export declare const useSetBalanceOverrides: () => (balanceOverrides: BalanceOverrides) => void;

package/dist/provider/hooks/utils/useSetBalanceOverrides.js

@@ -0,0 +1,12 @@
+"use client";
+import "../../../chunk-MMUBH76A.js";
+import { useStore } from "../../stores/useStore.js";
+const useSetBalanceOverrides = () => {
+  const setBalanceOverrides = useStore((state) => state.setBalanceOverrides);
+  return (balanceOverrides) => {
+    setBalanceOverrides(balanceOverrides);
+  };
+};
+export {
+  useSetBalanceOverrides
+};

package/dist/provider/stores/slices/modal.js

@@ -18,7 +18,17 @@ const createModalSlice = (set) => ({
   refs: {
     openedToStep: createRef(),
     balancesInvalidationTime: createRef()
-  }
+  },
+  balanceOverrides: null,
+  setBalanceOverrides: (balanceOverrides) => set((state) => {
+    var _a, _b;
+    return {
+      balanceOverrides: balanceOverrides ? {
+        version: ((_b = (_a = state.balanceOverrides) == null ? void 0 : _a.version) != null ? _b : 0) + 1,
+        value: balanceOverrides
+      } : null
+    };
+  })
 });
 export {
   createModalSlice

package/dist/provider/stores/types.d.ts

@@ -7,6 +7,12 @@ import { ParaSolanaProvider, SolanaExternalWalletContextType, WalletList as Sola
 import { ModalStep, ParaModalProps } from '../../modal/index.js';
 import { OAuthLogoVariantType } from '../../modal/types/modalProps.js';
 import { type TExternalWallet } from '@getpara/react-common';
+import { BalanceOverrides } from '@getpara/shared';
+/** Balance overrides with a version field for React Query cache invalidation (version must be serializable). */
+export type BalanceOverridesWithVersion = {
+    version: number;
+    value: BalanceOverrides;
+};
 export type FarcasterMiniAppConfig = {
     /**
      * Whether to disable automatic sign-in via the Farcaster user's existing miniapp wallet(s).
@@ -40,6 +46,8 @@ export interface ModalSlice {
         openedToStep: MutableRefObject<ModalStep | null>;
         balancesInvalidationTime: MutableRefObject<number | null>;
     };
+    balanceOverrides: BalanceOverridesWithVersion | null;
+    setBalanceOverrides: (_: BalanceOverrides | null) => void;
 }
 export interface WalletSlice {
     rpcUrl?: string;

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@getpara/react-sdk-lite",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "bin": {
     "setup-para": "dist/cli/cli.mjs"
   },
   "dependencies": {
-    "@getpara/react-common": "2.8.0",
-    "@getpara/react-components": "2.8.0",
-    "@getpara/web-sdk": "2.8.0",
+    "@getpara/react-common": "2.10.0",
+    "@getpara/react-components": "2.10.0",
+    "@getpara/web-sdk": "2.10.0",
     "date-fns": "^3.6.0",
     "framer-motion": "^11.3.31",
     "libphonenumber-js": "^1.11.7",
@@ -16,9 +16,9 @@
     "zustand-sync-tabs": "^0.2.2"
   },
   "devDependencies": {
-    "@getpara/cosmos-wallet-connectors": "2.8.0",
-    "@getpara/evm-wallet-connectors": "2.8.0",
-    "@getpara/solana-wallet-connectors": "2.8.0",
+    "@getpara/cosmos-wallet-connectors": "2.10.0",
+    "@getpara/evm-wallet-connectors": "2.10.0",
+    "@getpara/solana-wallet-connectors": "2.10.0",
     "@tanstack/react-query": "^5.74.0",
     "@testing-library/dom": "^10.4.0",
     "@testing-library/react": "^16.3.0",
@@ -38,7 +38,7 @@
     "package.json",
     "styles.css"
   ],
-  "gitHead": "44d3bdc9a075861613210bd0817a03ab67deed4e",
+  "gitHead": "8da2c51cc91f021acbc2ec7373b9ca0638fc840a",
   "main": "dist/index.js",
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",

package/dist/modal/components/AddFunds/common.d.ts

@@ -1,5 +0,0 @@
-export declare const NoProviders: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<Omit<Omit<any, "ref"> & import("react").RefAttributes<any>, "ref"> & {
-    ref?: ((instance: any) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<any> | null | undefined;
-}, {
-    isHidden?: boolean;
-}>> & string & Omit<import("react").ForwardRefExoticComponent<Omit<any, "ref"> & import("react").RefAttributes<any>>, keyof import("react").Component<any, {}, any>>;

package/dist/modal/components/AddFunds/common.js

@@ -1,17 +0,0 @@
-"use client";
-import "../../../chunk-MMUBH76A.js";
-import { CpslText } from "@getpara/react-components";
-import { safeStyled } from "@getpara/react-common";
-const NoProviders = safeStyled(CpslText)`
-  width: 100%;
-  text-align: center;
-  visibility: ${({ isHidden }) => isHidden ? "hidden" : "visible"};
-  position: absolute;
-  top: 0;
-  left: 0;
-  right: 0;
-  transition: visibility 0.2s;
-`;
-export {
-  NoProviders
-};