zh-web-sdk 2.16.1 → 3.0.0

package/dist/new-sdk/env.d.ts

@@ -0,0 +1,35 @@
+import type { Environment, InternalEnvironment } from '../types';
+/**
+ * Resolved env used internally to pick the CDN origin and forward to
+ * `@zerohash-sdk/*-react` components. Combines the public {@link Environment}
+ * surface (`'cert' | 'prod'`) with internal-only QA targets
+ * ({@link InternalEnvironment} — `'local' | 'dev'`).
+ */
+export type NewSdkEnv = Environment | InternalEnvironment;
+/**
+ * CDN origin that hosts the new `@zerohash-sdk/*` web components for a
+ * given environment. The `messageRouter` uses this to decide which
+ * origin is trusted to post lifecycle events back to the parent window.
+ */
+export declare const NEW_SDK_ORIGIN_BY_ENV: Record<NewSdkEnv, string>;
+/**
+ * Derive the environment from the host app's `zeroHashAppsURL`. Returns
+ * `'prod'` for any hostname not in the known lists, which is the safest
+ * default for a production-hardcoded CDN. When the fallback path is taken
+ * we log a one-time `console.warn` so integrators on a host outside the
+ * allowlist can spot the misconfiguration instead of silently being
+ * pointed at the production CDN.
+ */
+export declare function getNewSdkEnv(url: string): NewSdkEnv;
+/**
+ * Test-only: clear the warn-once cache so suites can assert the warning
+ * fires per URL without leaking state across tests.
+ */
+export declare function _resetWarnedFallbackUrls(): void;
+/**
+ * Auth-component env literal. `@connect-xyz/auth-react` only accepts
+ * `'sandbox' | 'production'` (no `dev` or `local`), so non-prod SDK envs
+ * collapse to `sandbox` — Auth's sandbox API serves cert/dev/local data.
+ */
+export type AuthEnv = 'sandbox' | 'production';
+export declare function toAuthEnv(env: NewSdkEnv): AuthEnv;

package/dist/redux/__tests__/set-theme.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/redux/__tests__/set-use-new-sdk.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/redux/actions/index.d.ts

@@ -1,7 +1,19 @@
-import { AppIdentifier } from "../../types";
+import { AppIdentifier, Theme } from "../../types";
 export declare const openModal: (appIdentifier: AppIdentifier) => void;
 export declare const closeModal: (appIdentifier: AppIdentifier) => void;
 export declare const appLoaded: (appIdentifier: AppIdentifier) => void;
 export declare const appPendingApproval: (appIdentifier: AppIdentifier) => void;
 export declare const appCompleted: (appIdentifier: AppIdentifier) => void;
 export declare const appFailed: (appIdentifier: AppIdentifier) => void;
+/**
+ * setUseNewSdk dispatches into the `new-sdk-flags` slice directly (not
+ * through `dispatchActionBasedOnAppIdentifier`), because that slice is keyed
+ * by appIdentifier internally rather than having one reducer per app.
+ */
+export declare const setUseNewSdk: (appIdentifier: AppIdentifier, useNewSdk: boolean) => void;
+/**
+ * setTheme dispatches into the global `theme` slice. Forwarded to new
+ * @zerohash-sdk/*-react components via AppContainer; legacy iframe and
+ * Connect Auth paths ignore it.
+ */
+export declare const setTheme: (theme: Theme) => void;

package/dist/redux/reducers/constants.d.ts

@@ -7,3 +7,5 @@ export declare const ACTION_FAILED = "FAILED";
 export declare const ACTION_SET_FILTERS = "ACTION_SET_FILTERS";
 export declare const ACTION_SET_NAVIGATE = "SET_NAVIGATE";
 export declare const ACTION_SET_USE_AUTH = "SET_USE_AUTH";
+export declare const ACTION_SET_USE_NEW_SDK = "SET_USE_NEW_SDK";
+export declare const ACTION_SET_THEME = "SET_THEME";

package/dist/redux/reducers/index.d.ts

@@ -15,5 +15,7 @@ declare const rootReducer: import("redux").Reducer<import("redux").CombinedState
     payouts: import("./payouts").IPayoutsState;
     pay: import("./pay").IPayState;
     "fiat-account-link": import("./fiat-account-link").IFiatAccountLinkState;
-}>, import("./crypto-withdrawals").ICryptoWithdrawalsAction | import("./onboarding").IOnboardingAction | import("./crypto-buy").ICryptoBuyAction | import("./fund").IFundAction>;
+    "new-sdk-flags": import("./new-sdk-flags").INewSdkFlagsState;
+    theme: import("./theme").IThemeState;
+}>, import("./crypto-withdrawals").ICryptoWithdrawalsAction | import("./onboarding").IOnboardingAction | import("./crypto-buy").ICryptoBuyAction | import("./fund").IFundAction | import("./new-sdk-flags").INewSdkFlagsAction | import("./theme").IThemeAction>;
 export default rootReducer;

package/dist/redux/reducers/new-sdk-flags.d.ts

@@ -0,0 +1,11 @@
+import { AppIdentifier } from "../../types";
+export interface INewSdkFlagsState {
+    flags: Partial<Record<AppIdentifier, boolean>>;
+}
+export interface INewSdkFlagsAction {
+    type: string;
+    appIdentifier?: AppIdentifier;
+    useNewSdk?: boolean;
+}
+declare const newSdkFlagsReducer: (state: INewSdkFlagsState | undefined, action: INewSdkFlagsAction) => INewSdkFlagsState;
+export default newSdkFlagsReducer;

package/dist/redux/reducers/theme.d.ts

@@ -0,0 +1,10 @@
+import { Theme } from "../../types";
+export interface IThemeState {
+    value: Theme;
+}
+export interface IThemeAction {
+    type: string;
+    theme?: Theme;
+}
+declare const themeReducer: (state: IThemeState | undefined, action: IThemeAction) => IThemeState;
+export default themeReducer;

package/dist/redux/store/index.d.ts

@@ -17,7 +17,9 @@ declare const store: import("redux").Store<import("redux").EmptyObject & {
     payouts: import("../reducers/payouts").IPayoutsState;
     pay: import("../reducers/pay").IPayState;
     "fiat-account-link": import("../reducers/fiat-account-link").IFiatAccountLinkState;
-}, import("../reducers/crypto-withdrawals").ICryptoWithdrawalsAction | import("../reducers/onboarding").IOnboardingAction | import("../reducers/crypto-buy").ICryptoBuyAction | import("../reducers/fund").IFundAction>;
+    "new-sdk-flags": import("../reducers/new-sdk-flags").INewSdkFlagsState;
+    theme: import("../reducers/theme").IThemeState;
+}, import("../reducers/crypto-withdrawals").ICryptoWithdrawalsAction | import("../reducers/onboarding").IOnboardingAction | import("../reducers/crypto-buy").ICryptoBuyAction | import("../reducers/fund").IFundAction | import("../reducers/new-sdk-flags").INewSdkFlagsAction | import("../reducers/theme").IThemeAction>;
 export default store;
 export type RootState = ReturnType<typeof rootReducer>;
 export type AppStore = ReturnType<typeof createStore>;

package/dist/styles.d.ts

@@ -1,4 +1,5 @@
 import { CSSProperties } from "react";
+import { Theme } from "./types";
 /**
  * Returns the modal border radius based on device type
  * Mobile devices: 0
@@ -19,6 +20,12 @@ export declare const containerMediaStyles: {
     [id: string]: CSSProperties;
 };
 export declare const appWrapperStyle: CSSProperties;
+export declare const getModalStyle: (theme?: Theme) => CSSProperties;
+/**
+ * Default light-mode modal style retained as a named export so existing
+ * imports keep compiling. Prefer `getModalStyle(theme)` in render paths
+ * that have the resolved theme available.
+ */
 export declare const modalStyle: CSSProperties;
 export declare const iframeWrapperStyle: CSSProperties;
 export declare const iframeStyle: CSSProperties;

package/dist/types.d.ts

@@ -11,6 +11,28 @@ declare global {
         MiniKit: typeof MiniKit;
     }
 }
+/**
+ * Theme controls the appearance of new @zerohash-sdk/*-react components
+ * rendered by this SDK. Does not affect the legacy iframe path or the
+ * Connect Auth (Fund) component.
+ */
+export type Theme = 'light' | 'dark' | 'auto';
+/**
+ * Environment selects which deployment of the new @zerohash-sdk/*-react
+ * components and their backing services should be used. When set, this
+ * takes precedence over hostname-based inference from `zeroHashAppsURL`
+ * and is the recommended way to target a specific environment going
+ * forward.
+ */
+export type Environment = 'cert' | 'prod';
+/**
+ * @internal
+ * InternalEnvironment exposes Zero Hash dev/local CDN targets used by our
+ * own QA tooling (sdk-mobile against simulators, kyc-mock-platform-server).
+ * Not part of the public API; values may change without notice. Integrators
+ * must use {@link Environment} (`'cert' | 'prod'`).
+ */
+export type InternalEnvironment = 'local' | 'dev';
 /**
  * IInitializeParameters describes the parameters
  * required for initializing the platform SDK
@@ -122,6 +144,22 @@ export interface IInitializeParameters {
      * be a replacement for zeroHashOnboardingURL.
      */
     zeroHashAppsURL: string;
+    /**
+     * env selects which deployment the SDK should target ('cert' | 'prod').
+     * When set, it is the source of truth for environment resolution and
+     * overrides hostname-based inference from `zeroHashAppsURL` /
+     * `zeroHashOnboardingURL`.
+     */
+    env?: Environment | InternalEnvironment;
+    /**
+     * theme controls the appearance of new @zerohash-sdk/*-react components
+     * rendered by this SDK (e.g. CryptoBuy, CryptoSell, Onboarding).
+     *
+     * Defaults to 'light'. Does not affect the legacy iframe path or the
+     * Connect Auth (Fund) component — the Auth component is themed via
+     * authSettings.theme.
+     */
+    theme?: Theme;
 }
 /**
  * ISetUserOnboardingJWTParameters describes the
@@ -464,6 +502,7 @@ export interface IZeroHashSDK {
     isOnboardingModalOpen(): boolean;
     openOnboardingModal(params: IOpenOnboardingModalParameters): void;
     closeOnboardingModal(): void;
+    setTheme(params: ISetThemeParameters): void;
 }
 /**
  * App identifier used to identify to which App we want to perform
@@ -495,6 +534,9 @@ export interface ISetJWTParameters {
     jwt: string;
     appIdentifier: AppIdentifier;
 }
+export interface ISetThemeParameters {
+    theme: Theme;
+}
 export interface Filters {
     getAssets?: {
         deposit_address_creation?: string;

package/dist/utils/test-utils.d.ts

@@ -12,54 +12,54 @@ export declare function renderWithProviders(ui: React.ReactElement, extendedRend
     rerender: (ui: React.ReactNode) => void;
     unmount: () => void;
     asFragment: () => DocumentFragment;
-    getByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
-    getAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
-    queryByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
-    queryAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
-    findByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByLabelText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
-    getAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    queryByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
-    queryAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    findByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByPlaceholderText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement;
-    getAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
-    queryByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement | null;
-    queryAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined) => HTMLElement[];
-    findByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
-    getAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    queryByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
-    queryAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    findByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByAltText: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
-    getAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    queryByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
-    queryAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    findByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByTitle: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
-    getAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    queryByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
-    queryAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    findByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByDisplayValue: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement;
-    getAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
-    queryByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement | null;
-    queryAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined) => HTMLElement[];
-    findByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByRole: (role: import("@testing-library/react").ByRoleMatcher, options?: import("@testing-library/react").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
-    getByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement;
-    getAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    queryByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement | null;
-    queryAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined) => HTMLElement[];
-    findByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement>;
-    findAllByTestId: (id: import("@testing-library/react").Matcher, options?: import("@testing-library/react").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/react").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByLabelText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement;
+    getAllByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    queryByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    findByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByPlaceholderText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement;
+    getAllByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement[];
+    queryByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement | null;
+    queryAllByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined) => HTMLElement[];
+    findByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").SelectorMatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement;
+    getAllByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    queryByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    findByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByAltText: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement;
+    getAllByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    queryByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    findByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTitle: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement;
+    getAllByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    queryByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    findByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByDisplayValue: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined) => HTMLElement;
+    getAllByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined) => HTMLElement[];
+    queryByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined) => HTMLElement | null;
+    queryAllByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined) => HTMLElement[];
+    findByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByRole: (role: import("@testing-library/dom").ByRoleMatcher, options?: import("@testing-library/dom").ByRoleOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
+    getByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement;
+    getAllByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    queryByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement | null;
+    queryAllByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined) => HTMLElement[];
+    findByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement>;
+    findAllByTestId: (id: import("@testing-library/dom").Matcher, options?: import("@testing-library/dom").MatcherOptions | undefined, waitForElementOptions?: import("@testing-library/dom").waitForOptions | undefined) => Promise<HTMLElement[]>;
     store: import("redux").Store<unknown, import("redux").Action<any>>;
 };
 export {};

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const SDK_VERSION: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zh-web-sdk",
-  "version": "2.16.1",
+  "version": "3.0.0",
   "private": false,
   "description": "ZeroHash Web SDK",
   "homepage": "https://github.com/seedcx/zh-web-sdk",
@@ -8,6 +8,11 @@
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
   "keywords": [],
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "author": "support@zerohash.com",
   "license": "MIT",
   "scripts": {
@@ -21,13 +26,15 @@
     "test": "jest --silent"
   },
   "devDependencies": {
-    "@testing-library/dom": "^10.4.0",
-    "@testing-library/react": "^16.0.1",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
     "@types/jest": "^29.5.14",
-    "@types/react": "^18.3.12",
-    "@types/react-dom": "^18.3.1",
+    "@types/react": "^18.3.29",
+    "@types/react-dom": "^18.3.7",
     "@typescript-eslint/eslint-plugin": "^6.4.0",
     "archiver": "^5.3.1",
+    "braces": "3.0.3",
+    "cross-spawn": "^7.0.5",
     "esbuild": "0.25.0",
     "eslint": "^8.47.0",
     "eslint-config-prettier": "6.15.0",
@@ -38,22 +45,34 @@
     "eslint-plugin-promise": "^6.1.1",
     "eslint-plugin-react-hooks": "^4.6.0",
     "eslint-plugin-react-refresh": "^0.3.4",
+    "form-data": "4.0.4",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
-    "cross-spawn": "^7.0.5",
-    "form-data": "4.0.4",
     "rimraf": "^5.0.1",
     "ts-jest": "^29.2.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.7.2",
-    "braces": "3.0.3"
+    "typescript": "^5.7.2"
   },
   "dependencies": {
-    "@connect-xyz/auth-react": "^0.46.0",
+    "@connect-xyz/auth-react": "^0.72.3",
     "@worldcoin/minikit-js": "^1.9.6",
-    "react": "^18.2.0",
-    "react-dom": "^18.2.0",
-    "react-redux": "^8.1.1",
+    "@zerohash-sdk/crypto-account-link-react": "^1.2.3",
+    "@zerohash-sdk/crypto-buy-react": "^1.3.3",
+    "@zerohash-sdk/crypto-sell-react": "^1.3.3",
+    "@zerohash-sdk/crypto-withdrawals-react": "^1.3.3",
+    "@zerohash-sdk/csp-crypto-sell-react": "^1.3.3",
+    "@zerohash-sdk/csp-crypto-withdrawals-react": "^1.3.3",
+    "@zerohash-sdk/csp-fiat-withdrawals-react": "^0.1.2",
+    "@zerohash-sdk/fiat-account-link-react": "^1.3.2",
+    "@zerohash-sdk/fiat-deposits-react": "^1.3.3",
+    "@zerohash-sdk/fiat-withdrawals-react": "^1.3.3",
+    "@zerohash-sdk/fund-react": "^1.3.3",
+    "@zerohash-sdk/fund-withdrawals-react": "^0.2.2",
+    "@zerohash-sdk/onboarding-react": "^1.3.3",
+    "@zerohash-sdk/profile-react": "^0.2.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-redux": "^8.1.3",
     "redux": "^4.2.1"
   },
   "repository": {

package/.eslintrc.js

@@ -1,12 +0,0 @@
-module.exports = {
-  env: { browser: true, es2020: true },
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/recommended',
-    'plugin:react-hooks/recommended',
-  ],
-  parser: '@typescript-eslint/parser',
-  parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },
-  plugins: ['react-refresh'],
-  rules: {},
-}

package/.github/CHANGELOG_TEMPLATE.md

@@ -1,73 +0,0 @@
-# Changelog Entry Template
-
-Use this template when adding a new version to CHANGELOG.md
-
----
-
-## [X.Y.Z] - YYYY-MM-DD
-
-### Added
-- New feature that allows users to [describe user benefit] [#PR_NUMBER]
-- Another feature description focusing on customer value
-
-### Changed
-- Updated [feature/behavior] to [improvement description]
-- [Behavior change] now [new behavior] instead of [old behavior]
-
-### Deprecated
-- [Feature name] is deprecated and will be removed in version [X.Y.Z]
-- Migration path: Use [alternative approach] instead
-- See [documentation link] for details
-
-### Removed
-- Removed [feature name] (deprecated since version [X.Y.Z])
-- See [migration guide link] for alternatives
-
-### Fixed
-- Fixed issue where [problem description] [#PR_NUMBER]
-- Resolved [bug description] affecting [user impact]
-
-### Security
-- Updated [dependency name] to address [vulnerability type]
-- Fixed [security issue description]
-
----
-
-## Guidelines
-
-### Writing Tips
-
-1. **Focus on User Impact**
-   - ✅ Good: "Fixed SDK positioning to prevent scrolling issues"
-   - ❌ Avoid: "Refactored internal positioning logic"
-
-2. **Be Specific and Clear**
-   - ✅ Good: "Added bank account linking feature for direct deposits"
-   - ❌ Avoid: "Added new feature"
-
-
-### Breaking Changes
-
-For MAJOR version releases, clearly mark breaking changes:
-
-```markdown
-## [3.0.0] - 2026-XX-XX
-
-### Changed
-- ⚠️ **BREAKING**: Renamed `cryptoBuyJWT` parameter to `jwt` in SDK configuration
-
-**Migration Guide:**
-\`\`\`typescript
-// Before (v2.x)
-const sdk = new ZeroHashSDK({
-  cryptoBuyJWT: token
-})
-
-// After (v3.x)
-const sdk = new ZeroHashSDK({
-  jwt: token
-})
-\`\`\`
-
-See [Migration Guide v2 to v3](link) for full details.
-```

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,10 +0,0 @@
-## Description
-
-## Solution
-
-## Result
-
-## Checklist
-
-- [ ] CHANGELOG.md has been updated
-- [ ] Official docs have been updated

package/.github/backup/publish-tag.yaml

@@ -1,14 +0,0 @@
-name: "Reusable NPM Publish tag"
-
-on:
-  push:
-    tags:
-      - "v*"
-  workflow_dispatch:
-
-jobs:
-  from_reusable:
-    uses: seedcx/composite-actions/.github/workflows/rw-npm-publish-public-oidc.yml@main
-    secrets: inherit
-    with:
-      NODE_VERSION: "22.21.1"

package/.github/workflows/build.yaml

@@ -1,13 +0,0 @@
-name: "Reusable NPM Build"
-
-on:
-  pull_request:
-    branches: [ main, master ]
-
-jobs:
-  from_reusable:
-    uses: seedcx/composite-actions/.github/workflows/rw-npm-build.yml@main
-    secrets: inherit
-    with:
-      NODE_VERSION: "22.22.0"
-      NPM_VERSION: "9"

package/.github/workflows/pr.yaml

@@ -1,14 +0,0 @@
-name: "Pull Request"
-
-on:
-  pull_request:
-    branches: [main]
-
-jobs:
-  from_reusable:
-    uses: seedcx/composite-actions/.github/workflows/rw-node-pull-request.yml@main
-    secrets: inherit
-    with:
-      NODE_VERSION: "22.22.0"
-      TEST_PLATFORM: 'npm'
-      TEST_REPORTER: 'jest-junit'

package/.github/workflows/publish.yaml

@@ -1,13 +0,0 @@
-name: "Reusable NPM Publish"
-
-on:
-  push:
-    tags:
-      - "*"
-
-jobs:
-  from_reusable:
-    uses: seedcx/composite-actions/.github/workflows/rw-npm-publish-public.yml@main
-    secrets: inherit
-    with:
-      NODE_VERSION: "22.22.0"

package/.github/workflows/security.yml

@@ -1,15 +0,0 @@
-name: 'Security Workflow'
-
-on:
-  workflow_dispatch:
-  pull_request:
-    branches: [main]
-  schedule:
-    - cron: '0 16 * * 2'
-
-jobs:
-  security:
-    uses: seedcx/composite-actions/.github/workflows/rw-security.yml@main
-    with:
-      NODE_VERSION: 22.12.0
-    secrets: inherit

package/.github/workflows/tag.yaml

@@ -1,14 +0,0 @@
-name: 'Tag New Version'
-
-on:
-  push:
-    branches:
-      - main
-  workflow_dispatch:
-
-jobs:
-  from_reusable:
-    uses: seedcx/composite-actions/.github/workflows/rw-npm-tag.yml@main
-    secrets: inherit
-    with:
-      NODE_VERSION: "22.22.0"