@frak-labs/core-sdk 1.0.2-beta.9985efe7 → 1.0.2-beta.9d4f564a

package/README.md

@@ -42,7 +42,6 @@ The Core SDK exports 111 functions, types, and utilities organized into four cat
 | Export | Purpose |
 |--------|---------|
 | `sdkConfigStore` | Reactive config singleton — resolve, cache, and subscribe to merchant config |
-| `computeLegacyProductId` | Convert product ID to legacy format |
 | `triggerDeepLinkWithFallback` | Open deep link with mobile fallback |
 | `base64urlEncode` / `base64urlDecode` | URL-safe base64 encoding/decoding |
 | `compressJsonToB64` / `decompressJsonFromB64` | JSON compression utilities |

package/package.json

@@ -11,7 +11,7 @@
       "url": "https://twitter.com/QNivelais"
     }
   ],
-  "version": "1.0.2-beta.9985efe7",
+  "version": "1.0.2-beta.9d4f564a",
   "description": "Core SDK of the Frak wallet, low level library to interact directly with the frak ecosystem.",
   "repository": {
     "url": "https://github.com/frak-id/wallet",
@@ -91,8 +91,8 @@
     "viem": "^2.x"
   },
   "dependencies": {
-    "@frak-labs/frame-connector": "0.2.0-beta.9985efe7",
-    "@openpanel/web": "^1.2.0"
+    "@frak-labs/frame-connector": "0.2.0-beta.9d4f564a",
+    "@openpanel/web": "^1.4.1"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
@@ -103,7 +103,7 @@
     "@vitest/coverage-v8": "^4.1.4",
     "@vitest/ui": "^4.1.4",
     "jsdom": "^29.0.0",
-    "tsdown": "^0.21.8",
+    "tsdown": "^0.22.0",
     "typescript": "^6.0.2",
     "viem": "^2.47.16",
     "vitest": "^4.1.4"

package/src/actions/ensureIdentity.ts

@@ -1,6 +1,6 @@
-import { getBackendUrl } from "../utils/backendUrl";
-import { getClientId } from "../utils/clientId";
-import { sdkConfigStore } from "../utils/sdkConfigStore";
+import { getBackendUrl } from "../config/backendUrl";
+import { getClientId } from "../config/clientId";
+import { sdkConfigStore } from "../config/sdkConfigStore";
 
 const ENSURE_STORAGE_PREFIX = "frak-identity-ensured-";
 

package/src/actions/openSso.ts

@@ -1,11 +1,11 @@
+import { getClientId } from "../config/clientId";
+import { sdkConfigStore } from "../config/sdkConfigStore";
 import type {
     FrakClient,
     OpenSsoParamsType,
     OpenSsoReturnType,
 } from "../types";
-import { getClientId } from "../utils/clientId";
-import { computeLegacyProductId } from "../utils/computeLegacyProductId";
-import { generateSsoUrl } from "../utils/sso";
+import { generateSsoUrl } from "../utils/sso/sso";
 
 // SSO popup configuration
 export const ssoPopupFeatures =
@@ -92,7 +92,7 @@ export async function openSso(
         generateSsoUrl(
             walletUrl ?? "https://wallet.frak.id",
             args,
-            computeLegacyProductId(),
+            (await sdkConfigStore.resolveMerchantId()) ?? "",
             metadata.name,
             getClientId(),
             customizations?.css

package/src/actions/referral/processReferral.test.ts

@@ -19,15 +19,20 @@ vi.mock("../sendInteraction", () => ({
     sendInteraction: vi.fn().mockResolvedValue(undefined),
 }));
 
-vi.mock("../../utils", () => ({
+vi.mock("../../context", () => ({
     FrakContextManager: {
         replaceUrl: vi.fn(),
     },
-    trackEvent: vi.fn(),
-    resolveMerchantId: vi.fn().mockResolvedValue(undefined),
+}));
+
+vi.mock("../../config/clientId", () => ({
     getClientId: vi.fn().mockReturnValue("test-client-id"),
 }));
 
+vi.mock("../../utils", () => ({
+    trackEvent: vi.fn(),
+}));
+
 describe("processReferral", () => {
     let mockClient: FrakClient;
     let mockAddress: Address;
@@ -116,8 +121,10 @@ describe("processReferral", () => {
         });
 
         it("should return 'self-referral' when v2 context has same clientId as current user", async () => {
-            const utils = await import("../../utils");
-            vi.mocked(utils.getClientId).mockReturnValue("referrer-client-id");
+            const clientIdMod = await import("../../config/clientId");
+            vi.mocked(clientIdMod.getClientId).mockReturnValue(
+                "referrer-client-id"
+            );
 
             const v2SelfReferralContext: FrakContextV2 = {
                 v: 2,
@@ -132,7 +139,9 @@ describe("processReferral", () => {
             });
 
             expect(result).toBe("self-referral");
-            vi.mocked(utils.getClientId).mockReturnValue("test-client-id");
+            vi.mocked(clientIdMod.getClientId).mockReturnValue(
+                "test-client-id"
+            );
         });
 
         it("should successfully process v2 referral with wallet only (no clientId)", async () => {
@@ -180,9 +189,11 @@ describe("processReferral", () => {
         });
 
         it("should prefer wallet over clientId for self-referral when both are present", async () => {
-            const utils = await import("../../utils");
+            const clientIdMod = await import("../../config/clientId");
             // clientId does NOT match current user, but wallet does → still self-referral
-            vi.mocked(utils.getClientId).mockReturnValue("some-other-client");
+            vi.mocked(clientIdMod.getClientId).mockReturnValue(
+                "some-other-client"
+            );
 
             const v2Hybrid: FrakContextV2 = {
                 v: 2,
@@ -198,7 +209,9 @@ describe("processReferral", () => {
             });
 
             expect(result).toBe("self-referral");
-            vi.mocked(utils.getClientId).mockReturnValue("test-client-id");
+            vi.mocked(clientIdMod.getClientId).mockReturnValue(
+                "test-client-id"
+            );
         });
     });
 
@@ -240,7 +253,8 @@ describe("processReferral", () => {
     });
 
     it("should update URL context when alwaysAppendUrl is true", async () => {
-        const utils = await import("../../utils");
+        const clientIdMod = await import("../../config/clientId");
+        const contextMod = await import("../../context");
 
         const v2Context: FrakContextV2 = {
             v: 2,
@@ -257,9 +271,9 @@ describe("processReferral", () => {
             },
         });
 
-        expect(utils.getClientId()).toBe("test-client-id");
+        expect(clientIdMod.getClientId()).toBe("test-client-id");
 
-        expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
+        expect(contextMod.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
             url: window.location.href,
             context: expect.objectContaining({
                 v: 2,
@@ -271,7 +285,7 @@ describe("processReferral", () => {
     });
 
     it("should remove URL context when alwaysAppendUrl is false", async () => {
-        const utils = await import("../../utils");
+        const contextMod = await import("../../context");
 
         const v2Context: FrakContextV2 = {
             v: 2,
@@ -288,15 +302,16 @@ describe("processReferral", () => {
             },
         });
 
-        expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
+        expect(contextMod.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
             url: window.location.href,
             context: null,
         });
     });
 
     it("should emit wallet in replacement context when alwaysAppendUrl is true and user is connected", async () => {
-        const utils = await import("../../utils");
-        vi.mocked(utils.getClientId).mockReturnValue(null as never);
+        const clientIdMod = await import("../../config/clientId");
+        const contextMod = await import("../../context");
+        vi.mocked(clientIdMod.getClientId).mockReturnValue(null as never);
 
         const v2Context: FrakContextV2 = {
             v: 2,
@@ -312,7 +327,7 @@ describe("processReferral", () => {
         });
 
         // clientId is null, but wallet is available — should still emit {w, m}
-        expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
+        expect(contextMod.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
             url: window.location.href,
             context: expect.objectContaining({
                 v: 2,
@@ -321,12 +336,13 @@ describe("processReferral", () => {
             }),
         });
 
-        vi.mocked(utils.getClientId).mockReturnValue("test-client-id");
+        vi.mocked(clientIdMod.getClientId).mockReturnValue("test-client-id");
     });
 
     it("should return null replacement context when both clientId and wallet are missing", async () => {
-        const utils = await import("../../utils");
-        vi.mocked(utils.getClientId).mockReturnValue(null as never);
+        const clientIdMod = await import("../../config/clientId");
+        const contextMod = await import("../../context");
+        vi.mocked(clientIdMod.getClientId).mockReturnValue(null as never);
 
         const v2Context: FrakContextV2 = {
             v: 2,
@@ -341,11 +357,11 @@ describe("processReferral", () => {
             options: { alwaysAppendUrl: true },
         });
 
-        expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
+        expect(contextMod.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
             url: window.location.href,
             context: null,
         });
 
-        vi.mocked(utils.getClientId).mockReturnValue("test-client-id");
+        vi.mocked(clientIdMod.getClientId).mockReturnValue("test-client-id");
     });
 });

package/src/actions/referral/processReferral.ts

@@ -1,4 +1,6 @@
-import { isAddressEqual } from "viem";
+import { getClientId } from "../../config/clientId";
+import { FrakContextManager } from "../../context";
+import { areAddressesEqual } from "../../context/address";
 import type {
     FrakClient,
     FrakContext,
@@ -6,7 +8,7 @@ import type {
     WalletStatusReturnType,
 } from "../../types";
 import { isV1Context, isV2Context } from "../../types";
-import { FrakContextManager, getClientId, trackEvent } from "../../utils";
+import { trackEvent } from "../../utils";
 import { sendInteraction } from "../sendInteraction";
 
 /**
@@ -113,7 +115,7 @@ function isSelfReferral(
     if (isV2Context(frakContext)) {
         // Wallet match takes precedence — it's the strongest signal we have.
         if (frakContext.w && walletStatus?.wallet) {
-            return isAddressEqual(frakContext.w, walletStatus.wallet);
+            return areAddressesEqual(frakContext.w, walletStatus.wallet);
         }
         if (frakContext.c) {
             return getClientId() === frakContext.c;
@@ -121,7 +123,7 @@ function isSelfReferral(
         return false;
     }
     if (isV1Context(frakContext) && walletStatus?.wallet) {
-        return isAddressEqual(frakContext.r, walletStatus.wallet);
+        return areAddressesEqual(frakContext.r, walletStatus.wallet);
     }
     return false;
 }

package/src/actions/referral/referralInteraction.test.ts

@@ -2,7 +2,7 @@ import type { Hex } from "viem";
 import { beforeEach, describe, expect, test, vi } from "vitest";
 import { referralInteraction } from "./referralInteraction";
 
-vi.mock("../../utils", () => ({
+vi.mock("../../context", () => ({
     FrakContextManager: {
         parse: vi.fn(),
     },
@@ -30,7 +30,7 @@ describe("referralInteraction", () => {
     });
 
     test("should parse context from window location", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 
@@ -46,7 +46,7 @@ describe("referralInteraction", () => {
     });
 
     test("should get current wallet status", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 
@@ -63,7 +63,7 @@ describe("referralInteraction", () => {
     });
 
     test("should call processReferral with all parameters", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 
@@ -87,7 +87,7 @@ describe("referralInteraction", () => {
     });
 
     test("should return result from processReferral", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 
@@ -101,7 +101,7 @@ describe("referralInteraction", () => {
     });
 
     test("should return undefined on error", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 
@@ -124,7 +124,7 @@ describe("referralInteraction", () => {
     });
 
     test("should work with empty options", async () => {
-        const { FrakContextManager } = await import("../../utils");
+        const { FrakContextManager } = await import("../../context");
         const { watchWalletStatus } = await import("../index");
         const { processReferral } = await import("./processReferral");
 

package/src/actions/referral/referralInteraction.ts

@@ -1,5 +1,5 @@
+import { FrakContextManager } from "../../context";
 import type { FrakClient } from "../../types";
-import { FrakContextManager } from "../../utils";
 import { watchWalletStatus } from "../index";
 import {
     type ProcessReferralOptions,

package/src/actions/sendInteraction.ts

@@ -1,6 +1,6 @@
+import { getClientId } from "../config/clientId";
 import type { FrakClient } from "../types";
 import type { SendInteractionParamsType } from "../types/rpc/interaction";
-import { getClientId } from "../utils/clientId";
 
 /**
  * Send an interaction to the backend via the listener RPC.

package/src/actions/trackPurchaseStatus.test.ts

@@ -7,18 +7,18 @@ import {
     test,
 } from "../../tests/vitest-fixtures";
 
-vi.mock("../utils/clientId", () => ({
+vi.mock("../config/clientId", () => ({
     getClientId: vi.fn().mockReturnValue("test-client-id"),
 }));
 
-vi.mock("../utils/sdkConfigStore", () => ({
+vi.mock("../config/sdkConfigStore", () => ({
     sdkConfigStore: {
         resolveMerchantId: vi.fn().mockResolvedValue(undefined),
     },
 }));
 
-import { getClientId } from "../utils/clientId";
-import { sdkConfigStore } from "../utils/sdkConfigStore";
+import { getClientId } from "../config/clientId";
+import { sdkConfigStore } from "../config/sdkConfigStore";
 import { trackPurchaseStatus } from "./trackPurchaseStatus";
 
 describe.sequential("trackPurchaseStatus", () => {

package/src/actions/trackPurchaseStatus.ts

@@ -1,6 +1,6 @@
-import { getBackendUrl } from "../utils/backendUrl";
-import { getClientId } from "../utils/clientId";
-import { sdkConfigStore } from "../utils/sdkConfigStore";
+import { getBackendUrl } from "../config/backendUrl";
+import { getClientId } from "../config/clientId";
+import { sdkConfigStore } from "../config/sdkConfigStore";
 
 /**
  * Function used to track the status of a purchase

package/src/actions/wrapper/siweAuthenticate.test.ts

@@ -4,10 +4,6 @@ vi.mock("../displayModal", () => ({
     displayModal: vi.fn(),
 }));
 
-vi.mock("viem/siwe", () => ({
-    generateSiweNonce: vi.fn(() => "mock-nonce-123456"),
-}));
-
 import type { Address, Hex } from "viem";
 import { describe, expect, it } from "../../../tests/vitest-fixtures";
 import type { FrakClient } from "../../types";
@@ -65,7 +61,7 @@ describe("siweAuthenticate", () => {
                     siweAuthenticate: {
                         siwe: expect.objectContaining({
                             domain: "example.com",
-                            nonce: "mock-nonce-123456",
+                            nonce: expect.stringMatching(/^[0-9a-f]{96}$/),
                             uri: "https://example.com",
                             version: "1",
                         }),

package/src/actions/wrapper/siweAuthenticate.ts

@@ -1,4 +1,3 @@
-import { generateSiweNonce } from "viem/siwe";
 import type {
     FrakClient,
     ModalRpcMetadata,
@@ -7,6 +6,31 @@ import type {
 } from "../../types";
 import { displayModal } from "../displayModal";
 
+/**
+ * Generate a random EIP-4361-compatible nonce.
+ *
+ * Matches viem/siwe's `generateSiweNonce` shape (96 alphanumeric chars) but
+ * inlined here to avoid pulling viem's runtime utilities into the bundle.
+ * Uses `crypto.getRandomValues` when available (browsers, modern Node) and
+ * falls back to `Math.random` for the rare environment without WebCrypto.
+ */
+function generateSiweNonce(length = 96): string {
+    const byteCount = Math.ceil(length / 2);
+    let hex = "";
+    if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+        const bytes = new Uint8Array(byteCount);
+        crypto.getRandomValues(bytes);
+        for (let i = 0; i < bytes.length; i++) {
+            hex += bytes[i].toString(16).padStart(2, "0");
+        }
+    } else {
+        for (let i = 0; i < byteCount; i++) {
+            hex += ((Math.random() * 256) | 0).toString(16).padStart(2, "0");
+        }
+    }
+    return hex.substring(0, length);
+}
+
 /**
  * Parameter used to directly show a modal used to authenticate with SIWE
  * @inline

package/src/clients/createIFrameFrakClient.ts

@@ -6,17 +6,16 @@ import {
     RpcErrorCodes,
 } from "@frak-labs/frame-connector";
 import { OpenPanel } from "@openpanel/web";
+import { getClientId } from "../config/clientId";
+import { sdkConfigStore } from "../config/sdkConfigStore";
+import { BACKUP_KEY } from "../constants";
 import type { FrakLifecycleEvent } from "../types";
 import type { FrakClient } from "../types/client";
 import type { FrakWalletSdkConfig } from "../types/config";
 import type { SdkResolvedConfig } from "../types/resolvedConfig";
 import type { IFrameRpcSchema } from "../types/rpc";
-import { getClientId } from "../utils";
 import { clearAllCache } from "../utils/cache";
-import { BACKUP_KEY } from "../utils/constants";
-import { sdkConfigStore } from "../utils/sdkConfigStore";
-import { setupSsoUrlListener } from "../utils/ssoUrlListener";
-import { DebugInfoGatherer } from "./DebugInfo";
+import { setupSsoUrlListener } from "./ssoUrlListener";
 import {
     createIFrameLifecycleManager,
     type IframeLifecycleManager,
@@ -84,9 +83,6 @@ export function createIFrameFrakClient({
     // lifecycle manager resolves the `isConnected` promise.
     const handshakeStartedAt = Date.now();
 
-    // Create our debug info gatherer
-    const debugInfo = new DebugInfoGatherer(config, iframe);
-
     // Validate iframe
     if (!iframe.contentWindow) {
         throw new FrakRpcError(
@@ -115,17 +111,6 @@ export function createIFrameFrakClient({
                     return ctx;
                 },
             },
-            // Save debug info
-            {
-                onRequest(message, ctx) {
-                    debugInfo.setLastRequest(message);
-                    return ctx;
-                },
-                onResponse(message, response) {
-                    debugInfo.setLastResponse(message, response);
-                    return response;
-                },
-            },
         ],
         // Add lifecycle handlers to process iframe lifecycle events
         lifecycleHandlers: {
@@ -227,7 +212,7 @@ export function createIFrameFrakClient({
         contextSent,
         openPanel,
     })
-        .then(() => debugInfo.updateSetupStatus(true))
+        .then(() => {})
         .catch((err) => {
             contextSent.reject(err);
             throw err;
@@ -235,7 +220,6 @@ export function createIFrameFrakClient({
 
     return {
         config,
-        debugInfo,
         waitForConnection: lifecycleManager.isConnected,
         waitForSetup,
         request: rpcClient.request,

package/src/clients/index.ts

@@ -1,3 +1,2 @@
 export { createIFrameFrakClient } from "./createIFrameFrakClient";
-export { DebugInfoGatherer } from "./DebugInfo";
 export { setupClient } from "./setupClient";

package/src/clients/transports/iframeLifecycleManager.test.ts

@@ -16,19 +16,19 @@ vi.mock("@frak-labs/frame-connector", () => ({
     },
 }));
 
-vi.mock("../../utils/constants", () => ({
+vi.mock("../../constants", () => ({
     BACKUP_KEY: "frak-backup-key",
 }));
 
-vi.mock("../../utils/iframeHelper", () => ({
+vi.mock("../../utils/iframe/iframeHelper", () => ({
     changeIframeVisibility: vi.fn(),
 }));
 
-vi.mock("../../utils/clientId", () => ({
+vi.mock("../../config/clientId", () => ({
     getClientId: vi.fn(() => "mock-client-id"),
 }));
 
-vi.mock("../../utils/deepLinkWithFallback", () => ({
+vi.mock("../../utils/browser/deepLinkWithFallback", () => ({
     isFrakDeepLink: vi.fn((url: string) => url.startsWith("frakwallet://")),
     triggerDeepLinkWithFallback: vi.fn(),
 }));
@@ -185,7 +185,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { changeIframeVisibility } = await import(
-                "../../utils/iframeHelper"
+                "../../utils/iframe/iframeHelper"
             );
 
             const mockIframe = document.createElement("iframe");
@@ -211,7 +211,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { changeIframeVisibility } = await import(
-                "../../utils/iframeHelper"
+                "../../utils/iframe/iframeHelper"
             );
 
             const mockIframe = document.createElement("iframe");
@@ -301,7 +301,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { triggerDeepLinkWithFallback } = await import(
-                "../../utils/deepLinkWithFallback"
+                "../../utils/browser/deepLinkWithFallback"
             );
 
             Object.defineProperty(window, "location", {
@@ -340,7 +340,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { triggerDeepLinkWithFallback } = await import(
-                "../../utils/deepLinkWithFallback"
+                "../../utils/browser/deepLinkWithFallback"
             );
 
             Object.defineProperty(window, "location", {
@@ -396,7 +396,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { triggerDeepLinkWithFallback } = await import(
-                "../../utils/deepLinkWithFallback"
+                "../../utils/browser/deepLinkWithFallback"
             );
 
             Object.defineProperty(window, "location", {
@@ -453,7 +453,7 @@ describe("createIFrameLifecycleManager", () => {
                 "./iframeLifecycleManager"
             );
             const { changeIframeVisibility } = await import(
-                "../../utils/iframeHelper"
+                "../../utils/iframe/iframeHelper"
             );
 
             const mockIframe = document.createElement("iframe");

package/src/clients/transports/iframeLifecycleManager.ts

@@ -1,11 +1,11 @@
 import { Deferred } from "@frak-labs/frame-connector";
+import { BACKUP_KEY } from "../../constants";
 import type { FrakLifecycleEvent } from "../../types";
-import { BACKUP_KEY } from "../../utils/constants";
 import {
     isFrakDeepLink,
     triggerDeepLinkWithFallback,
-} from "../../utils/deepLinkWithFallback";
-import { changeIframeVisibility } from "../../utils/iframeHelper";
+} from "../../utils/browser/deepLinkWithFallback";
+import { changeIframeVisibility } from "../../utils/iframe/iframeHelper";
 
 /**
  * Detect iOS in-app browsers (Instagram, Facebook) where server-side

package/src/config/index.ts

@@ -0,0 +1,3 @@
+export { getBackendUrl } from "./backendUrl";
+export { getClientId } from "./clientId";
+export { sdkConfigStore } from "./sdkConfigStore";

package/src/{utils → config}/sdkConfigStore.ts

@@ -14,8 +14,8 @@ import type {
     MerchantConfigResponse,
     SdkResolvedConfig,
 } from "../types/resolvedConfig";
+import { clearAllCache, withCache } from "../utils/cache";
 import { getBackendUrl } from "./backendUrl";
-import { clearAllCache, withCache } from "./cache";
 
 const GLOBAL_KEY = "__frakSdkConfig";
 const CACHE_TTL = 30_000; // 30 seconds

package/src/{utils/constants.test.ts → constants.test.ts}

@@ -1,9 +1,4 @@
-/**
- * Tests for constants
- * Tests backup key constant value
- */
-
-import { describe, expect, it } from "../../tests/vitest-fixtures";
+import { describe, expect, it } from "../tests/vitest-fixtures";
 import { BACKUP_KEY } from "./constants";
 
 describe("constants", () => {

package/src/constants.ts

@@ -0,0 +1,15 @@
+/**
+ * The backup key for client side backup if needed
+ */
+export const BACKUP_KEY = "nexus-wallet-backup";
+
+/**
+ * Deep link scheme for Frak Wallet mobile app.
+ *
+ * Replaced at build time via tsdown/Vite `define`. Defaults to the prod scheme;
+ * in-monorepo dev builds (listener at wallet-dev.frak.id) override this with
+ * `frakwallet-dev://` so deep links open the dev wallet variant (id.frak.wallet.dev).
+ * External integrators consuming the published NPM/CDN bundle always see the prod scheme.
+ */
+export const DEEP_LINK_SCHEME: string =
+    process.env.DEEP_LINK_SCHEME ?? "frakwallet://";