Updates to core, ui, lightspark-sdk (#477)

* [penny test] Add pending state for name match (#19940)

## Reason

In order to enforce name matching in the MX onboarding flow, we need to add a pending page and different landing pages depending on the name matching result. This PR adds the pending page when the GK is enabled.

Design:
https://www.figma.com/design/hb8mqsg0n3QKJHpJA0ahkI/MXN-Grid-Switch?node-id=17-15925&m=dev

Screenshots below:

![Screenshot 2025-08-21 at 2.24.16 PM.png](https://app.graphite.dev/user-attachments/assets/555e2954-9675-4222-a33c-d91bd164cf3e.png)

![Screenshot 2025-08-21 at 2.24.32 PM.png](https://app.graphite.dev/user-attachments/assets/070c7fbb-4f54-4c13-a3da-dbb51d0077d2.png)

GitOrigin-RevId: 16f902a477add267300b15f73f2420bbadccbd53

* Update from public js-sdk main branch (#19974)

Update public `js` sources with the latest code from the [public
repository](https://github.com/lightsparkdev/js-sdk) main branch.

This typically happens when new versions of the SDK are released and
version updates need to be synced. The PR should be merged as soon as
possible to avoid updates to webdev overwriting the changes in the
js-sdk develop branch.

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Lightspark Eng <[email protected]>
Co-authored-by: Peng Ying <[email protected]>
GitOrigin-RevId: e30a45111187be96d3583658bd02bb271521e53f

* [penny test] Add other landing pages to name verification (#19968)

![Screenshot 2025-08-21 at 5.07.39 PM.png](https://app.graphite.dev/user-attachments/assets/00da5f22-8717-4364-b756-df21aad7488d.png)

![Screenshot 2025-08-21 at 5.07.58 PM.png](https://app.graphite.dev/user-attachments/assets/f7825e52-4fa7-450e-bfbc-5a3bac1c31da.png)

GitOrigin-RevId: fd51392ec1ad6c61ea11a55e4810cf5ff0bce6df

* Add new uma card status for pending name verification (#19996)

![Screenshot 2025-08-22 at 12.52.46 PM.png](https://app.graphite.dev/user-attachments/assets/fa2e9b48-d1e9-4ed1-9999-2ec91e297b02.png)

![Screenshot 2025-08-22 at 12.52.49 PM.png](https://app.graphite.dev/user-attachments/assets/f71dbeee-9947-4014-b63c-7d45e516d6b8.png)

GitOrigin-RevId: 8a5e2a6ef5f2d08ce7ea2ce14fe9fc59a4cfb714

* switch to use fun facts wrapper and transitioning text (#20036)

## Reason

Add "fun facts" while users wait for their kyc to complete

## Overview

This re-uses the same fun facts component from LinkBankMX

## Test Plan

KYC a user - while their kyc is in pending state, we should see the following screen, complete with fun facts

![Screenshot 2025-08-24 at 6.21.54 PM.png](https://app.graphite.dev/user-attachments/assets/cf729f5e-7ec8-4fb8-ae33-de2e10c63231.png)

GitOrigin-RevId: fe6335c827bd3110d2915b288da66b6de04d3e11

* [Nage] Move CommandCenter to SideNav (#19881)

![Screenshot 2025-08-18 at 5.25.07 PM.png](https://app.graphite.dev/user-attachments/assets/0fb72900-d9b6-4010-9274-9cfafa4245c0.png)

GitOrigin-RevId: 6388684ba3bcce5fad01df8fbbb3621f23691c04

* [core] Add circular-deps check and resolve issues (#20020)

## Reason

Typically we have this circular-deps check for JS packages but it was
never added to this one. I realized it's causing a downstream issue so
this adds the check and resolves circular deps.

GitOrigin-RevId: 1ea0bf0d6f3c7f48a38527f971cb9c32c90b6a7a

* [lightspark-sdk] Add circular-deps check and resolve issues (#20022)

## Reason

Typically we have this circular-deps check for JS packages but it was
never added to this one. I realized it's causing a downstream issue so
this adds the check and resolves circular deps.

GitOrigin-RevId: cc9081a0419495600c89ebec1d9e4c8ff6b5c9b3

* CI update lock file for PR

* [core] RN entrypoint to remove ws import in spark-sdk (#20021)

## Reason

It's not exactly clear when this became an issue for spark-sdk on React
Native because originally it was working fine with a dynamic import.
Somewhere along the way, possibly due to an updated dependency in
spark/js lock file, it started causing the following error:

<img width="479" height="377" alt="Screenshot 2025-08-21 at 11 27 57 PM"
src="https://github.com/user-attachments/assets/206d254b-b721-4c84-b93c-559f3039a042"
/>

We need to avoid referencing ws in React Native entrypoints which
resolves the issue.

GitOrigin-RevId: 8e9297ac7c1d096d90fd0f46096187cc92256c2b

* Create shy-bugs-march.md

* Create tame-sites-mate.md

* Create short-parts-march.md

---------

Co-authored-by: Jason Wang <[email protected]>
Co-authored-by: lightspark-ci-js-sdk[bot] <134011073+lightspark-ci-js-sdk[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Lightspark Eng <[email protected]>
Co-authored-by: Peng Ying <[email protected]>
Co-authored-by: Matt Davis <[email protected]>
Co-authored-by: Corey Martin <[email protected]>

Author: 7 people

.changeset/short-parts-march.md

@@ -0,0 +1,5 @@
+---
+"@lightsparkdev/lightspark-sdk": patch
+---
+
+- Resolve circular dependencies

.changeset/shy-bugs-march.md

@@ -0,0 +1,5 @@
+---
+"@lightsparkdev/ui": patch
+---
+
+- Icon, component updates

.changeset/tame-sites-mate.md

@@ -0,0 +1,6 @@
+---
+"@lightsparkdev/core": patch
+---
+
+- Resolve circular dependencies
+- React Native compatible entrypoint

packages/core/package.json

@@ -24,6 +24,7 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "react-native": "./dist/react-native/index.js",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
@@ -39,6 +40,7 @@
     "src/*",
     "dist/*",
     "dist/utils/*",
+    "dist/react-native/*",
     "CHANGELOG.md"
   ],
   "scripts": {
@@ -51,6 +53,7 @@
     "lint:fix": "eslint --fix .",
     "lint:watch": "esw ./src -w --ext .ts,.tsx,.js --color",
     "lint": "eslint .",
+    "circular-deps": "madge --circular --extensions ts,tsx src",
     "package:checks": "yarn publint && yarn attw --pack .",
     "postversion": "yarn build",
     "test-cmd": "node --experimental-vm-modules $(yarn bin jest) --no-cache --runInBand --bail",
@@ -81,6 +84,7 @@
     "eslint-watch": "^8.0.0",
     "jest": "^29.6.2",
     "lodash-es": "^4.17.21",
+    "madge": "^6.1.0",
     "prettier": "3.0.3",
     "prettier-plugin-organize-imports": "^3.2.4",
     "publint": "^0.3.9",
@@ -89,6 +93,16 @@
     "tsup": "^8.2.4",
     "typescript": "^5.6.2"
   },
+  "madge": {
+    "detectiveOptions": {
+      "ts": {
+        "skipTypeImports": true
+      },
+      "tsx": {
+        "skipTypeImports": true
+      }
+    }
+  },
   "engines": {
     "node": ">=18"
   }

packages/core/src/Logger.ts

@@ -1,5 +1,6 @@
-import { ConfigKeys, getLocalStorageConfigItem } from "./index.js";
+import { ConfigKeys } from "./constants/index.js";
 import { isBrowser, isTest } from "./utils/environment.js";
+import { getLocalStorageConfigItem } from "./utils/localStorage.js";
 
 type GetLoggingEnabled = (() => Promise<boolean> | boolean) | undefined;
 

packages/core/src/crypto/SigningKey.ts

@@ -1,6 +1,8 @@
 import secp256k1 from "secp256k1";
-import { SigningKeyType, type CryptoInterface } from "../index.js";
-import { createSha256Hash, hexToBytes } from "../utils/index.js";
+import { createSha256Hash } from "../utils/createHash.js";
+import { hexToBytes } from "../utils/hex.js";
+import type { CryptoInterface } from "./crypto.js";
+import { SigningKeyType } from "./types.js";
 
 interface Alias {
   alias: string;

packages/core/src/index.ts

@@ -1,13 +1,5 @@
 // Copyright ©, 2023-present, Lightspark Group, Inc. - All Rights Reserved
 
-export * from "./auth/index.js";
-export * from "./constants/index.js";
-export * from "./crypto/index.js";
-export { default as LightsparkException } from "./LightsparkException.js";
-export { Logger, LoggingLevel, logger } from "./Logger.js";
-export * from "./requester/index.js";
-export {
-  default as ServerEnvironment,
-  apiDomainForEnvironment,
-} from "./ServerEnvironment.js";
-export * from "./utils/index.js";
+export { DefaultRequester as Requester } from "./requester/DefaultRequester.js";
+export { default as Query } from "./requester/Query.js";
+export * from "./shared.js";

packages/core/src/react-native/index.ts

@@ -0,0 +1,2 @@
+export * from "../requester/index.js";
+export * from "../shared.js";

packages/core/src/requester/DefaultRequester.ts

@@ -0,0 +1,46 @@
+import type AuthProvider from "../auth/AuthProvider.js";
+import { isBare, isNode } from "../utils/environment.js";
+import Requester from "./Requester.js";
+
+export class DefaultRequester extends Requester {
+  protected async initWsClient(baseUrl: string, authProvider: AuthProvider) {
+    if (!this.resolveWsClient) {
+      /* If resolveWsClient is null assume already initialized: */
+      return this.wsClient;
+    }
+
+    if (isBare) {
+      /* graphql-ws library is currently not supported in Bare environment, see LIG-7942 */
+      return null;
+    }
+
+    let websocketImpl;
+    if (isNode && typeof WebSocket === "undefined") {
+      const wsModule = await import("ws");
+      websocketImpl = wsModule.default;
+    }
+    let websocketProtocol = "wss";
+    if (baseUrl.startsWith("http://")) {
+      websocketProtocol = "ws";
+    }
+
+    const graphqlWsModule = await import("graphql-ws");
+    const { createClient } = graphqlWsModule;
+
+    const wsClient = createClient({
+      url: `${websocketProtocol}://${this.stripProtocol(this.baseUrl)}/${
+        this.schemaEndpoint
+      }`,
+      connectionParams: () => authProvider.addWsConnectionParams({}),
+      webSocketImpl: websocketImpl,
+    });
+
+    if (this.resolveWsClient) {
+      this.resolveWsClient(wsClient);
+      this.resolveWsClient = null;
+    }
+
+    return wsClient;
+  }
+}
+export default DefaultRequester;

packages/core/src/requester/Requester.ts

@@ -17,7 +17,7 @@ import type { SigningKey } from "../crypto/SigningKey.js";
 import LightsparkException from "../LightsparkException.js";
 import { logger } from "../Logger.js";
 import { b64encode } from "../utils/base64.js";
-import { isBare, isNode } from "../utils/environment.js";
+import { isNode } from "../utils/environment.js";
 
 const DEFAULT_BASE_URL = "api.lightspark.com";
 dayjs.extend(utc);
@@ -31,14 +31,14 @@ type BodyData = {
 };
 
 class Requester {
-  private wsClient: Promise<WsClient | null>;
-  private resolveWsClient: ((value: WsClient | null) => void) | null = null;
+  protected wsClient: Promise<WsClient | null>;
+  protected resolveWsClient: ((value: WsClient | null) => void) | null = null;
   constructor(
     private readonly nodeKeyCache: NodeKeyCache,
-    private readonly schemaEndpoint: string,
+    protected readonly schemaEndpoint: string,
     private readonly sdkUserAgent: string,
     private readonly authProvider: AuthProvider = new StubAuthProvider(),
-    private readonly baseUrl: string = DEFAULT_BASE_URL,
+    protected readonly baseUrl: string = DEFAULT_BASE_URL,
     private readonly cryptoImpl: CryptoInterface = DefaultCrypto,
     private readonly signingKey?: SigningKey,
     private readonly fetchImpl: typeof fetch = fetch,
@@ -50,44 +50,11 @@ class Requester {
     autoBind(this);
   }
 
-  private async initWsClient(baseUrl: string, authProvider: AuthProvider) {
-    if (!this.resolveWsClient) {
-      /* If resolveWsClient is null assume already initialized: */
-      return this.wsClient;
-    }
-
-    if (isBare) {
-      /* graphql-ws library is currently not supported in Bare environment, see LIG-7942 */
-      return null;
-    }
-
-    let websocketImpl;
-    if (isNode && typeof WebSocket === "undefined") {
-      const wsModule = await import("ws");
-      websocketImpl = wsModule.default;
-    }
-    let websocketProtocol = "wss";
-    if (baseUrl.startsWith("http://")) {
-      websocketProtocol = "ws";
-    }
-
-    const graphqlWsModule = await import("graphql-ws");
-    const { createClient } = graphqlWsModule;
-
-    const wsClient = createClient({
-      url: `${websocketProtocol}://${this.stripProtocol(this.baseUrl)}/${
-        this.schemaEndpoint
-      }`,
-      connectionParams: () => authProvider.addWsConnectionParams({}),
-      webSocketImpl: websocketImpl,
-    });
-
-    if (this.resolveWsClient) {
-      this.resolveWsClient(wsClient);
-      this.resolveWsClient = null;
-    }
-
-    return wsClient;
+  protected initWsClient(
+    baseUrl: string,
+    authProvider: AuthProvider,
+  ): Promise<WsClient | null> {
+    return Promise.resolve(null);
   }
 
   public async executeQuery<T>(query: Query<T>): Promise<T | null> {
@@ -293,7 +260,7 @@ class Requester {
     return `${this.sdkUserAgent} ${platform}/${platformVersion}`;
   }
 
-  private stripProtocol(url: string): string {
+  protected stripProtocol(url: string): string {
     return url.replace(/.*?:\/\//g, "");
   }