@frak-labs/nexus-sdk 0.0.20 → 0.0.21

package/dist/{chunk-6LI5YIZB.js → chunk-MDGMJ6EQ.js}

@@ -3,7 +3,7 @@ import {
   FrakContextManager,
   FrakRpcError,
   RpcErrorCodes
-} from "./chunk-7K4L7VQC.js";
+} from "./chunk-ZRPCX25Q.js";
 import {
   ReferralInteractionEncoder
 } from "./chunk-TIKEZMSD.js";
@@ -106,51 +106,69 @@ async function processReferral(client, {
   walletStatus: walletStatus2,
   frakContext,
   modalConfig,
-  productId
+  productId,
+  options
 }) {
-  try {
-    let currentWallet = walletStatus2?.wallet;
-    if (!frakContext?.r) {
-      if (currentWallet) {
-        FrakContextManager.replaceUrl({
-          url: window.location?.href,
-          context: { r: currentWallet }
-        });
-      }
-      return "no-referrer";
-    }
-    let walletRequested = false;
-    if (!currentWallet) {
-      currentWallet = await ensureWalletConnected(client, {
-        modalConfig,
-        walletStatus: walletStatus2
-      });
-      walletRequested = true;
-    }
-    if (currentWallet && isAddressEqual(frakContext.r, currentWallet)) {
-      return "self-referral";
-    }
-    if (!(walletStatus2?.interactionSession || walletRequested)) {
-      currentWallet = await ensureWalletConnected(client, {
-        modalConfig,
-        walletStatus: walletStatus2
-      });
-    }
-    if (currentWallet) {
-      FrakContextManager.replaceUrl({
-        url: window.location?.href,
-        context: { r: currentWallet }
-      });
+  let walletRequest = false;
+  async function getFreshWalletStatus() {
+    if (walletRequest) {
+      return;
     }
+    walletRequest = true;
+    return ensureWalletConnected(client, {
+      modalConfig,
+      walletStatus: walletStatus2
+    });
+  }
+  async function pushReferralInteraction(referrer) {
     const interaction = ReferralInteractionEncoder.referred({
-      referrer: frakContext.r
+      referrer
     });
     await sendInteraction(client, { productId, interaction });
-    return "success";
+  }
+  try {
+    const { status, currentWallet } = await processReferralLogic({
+      initialWalletStatus: walletStatus2,
+      getFreshWalletStatus,
+      pushReferralInteraction,
+      frakContext
+    });
+    FrakContextManager.replaceUrl({
+      url: window.location?.href,
+      context: options?.alwaysAppendUrl ? { r: currentWallet } : null
+    });
+    return status;
   } catch (error) {
+    console.log("Error processing referral", { error });
+    FrakContextManager.replaceUrl({
+      url: window.location?.href,
+      context: options?.alwaysAppendUrl ? { r: walletStatus2?.wallet } : null
+    });
     return mapErrorToState(error);
   }
 }
+async function processReferralLogic({
+  initialWalletStatus,
+  getFreshWalletStatus,
+  pushReferralInteraction,
+  frakContext
+}) {
+  let currentWallet = initialWalletStatus?.wallet;
+  if (!frakContext?.r) {
+    return { status: "no-referrer", currentWallet };
+  }
+  if (!currentWallet) {
+    currentWallet = await getFreshWalletStatus();
+  }
+  if (currentWallet && isAddressEqual(frakContext.r, currentWallet)) {
+    return { status: "self-referral", currentWallet };
+  }
+  if (!initialWalletStatus?.interactionSession) {
+    currentWallet = await getFreshWalletStatus();
+  }
+  await pushReferralInteraction(frakContext.r);
+  return { status: "success", currentWallet };
+}
 async function ensureWalletConnected(client, {
   modalConfig,
   walletStatus: walletStatus2
@@ -181,7 +199,8 @@ function mapErrorToState(error) {
 // src/core/actions/referral/referralInteraction.ts
 async function referralInteraction(client, {
   productId,
-  modalConfig
+  modalConfig,
+  options
 } = {}) {
   const frakContext = FrakContextManager.parse({
     url: window.location.href
@@ -192,7 +211,8 @@ async function referralInteraction(client, {
       walletStatus: currentWalletStatus,
       frakContext,
       modalConfig,
-      productId
+      productId,
+      options
     });
   } catch (error) {
     return error;

package/dist/{chunk-2SDBW6QC.cjs → chunk-WXNW7ZMU.cjs}

@@ -6,7 +6,7 @@
 
 
 
-var _chunkYDZBXUC4cjs = require('./chunk-YDZBXUC4.cjs');
+var _chunkE527CMMJcjs = require('./chunk-E527CMMJ.cjs');
 
 // src/core/utils/constants.ts
 var BACKUP_KEY = "nexus-wallet-backup";
@@ -31,7 +31,7 @@ function createIFrameChannelManager() {
 function createIFrameLifecycleManager({
   iframe
 }) {
-  const isConnectedDeferred = new (0, _chunkYDZBXUC4cjs.Deferred)();
+  const isConnectedDeferred = new (0, _chunkE527CMMJcjs.Deferred)();
   const handler = async (messageEvent) => {
     switch (messageEvent.iframeLifecycle) {
       // Resolve the isConnected promise
@@ -53,7 +53,7 @@ function createIFrameLifecycleManager({
       // Change iframe visibility
       case "show":
       case "hide":
-        _chunkYDZBXUC4cjs.changeIframeVisibility.call(void 0, {
+        _chunkE527CMMJcjs.changeIframeVisibility.call(void 0, {
           iframe,
           isVisible: messageEvent.iframeLifecycle === "show"
         });
@@ -74,14 +74,14 @@ function createIFrameMessageHandler({
   iframeLifecycleManager
 }) {
   if (typeof window === "undefined") {
-    throw new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
-      _chunkYDZBXUC4cjs.RpcErrorCodes.configError,
+    throw new (0, _chunkE527CMMJcjs.FrakRpcError)(
+      _chunkE527CMMJcjs.RpcErrorCodes.configError,
       "iframe client should be used in the browser"
     );
   }
   if (!iframe.contentWindow) {
-    throw new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
-      _chunkYDZBXUC4cjs.RpcErrorCodes.configError,
+    throw new (0, _chunkE527CMMJcjs.FrakRpcError)(
+      _chunkE527CMMJcjs.RpcErrorCodes.configError,
       "The iframe does not have a product window"
     );
   }
@@ -141,17 +141,17 @@ function createIFrameNexusClient({
   const request = async (args) => {
     const isConnected = await lifecycleManager.isConnected;
     if (!isConnected) {
-      throw new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
-        _chunkYDZBXUC4cjs.RpcErrorCodes.clientNotConnected,
+      throw new (0, _chunkE527CMMJcjs.FrakRpcError)(
+        _chunkE527CMMJcjs.RpcErrorCodes.clientNotConnected,
         "The iframe provider isn't connected yet"
       );
     }
-    const result = new (0, _chunkYDZBXUC4cjs.Deferred)();
+    const result = new (0, _chunkE527CMMJcjs.Deferred)();
     const channelId = channelManager.createChannel(async (message) => {
-      const decompressed = await _chunkYDZBXUC4cjs.decompressDataAndCheckHash.call(void 0, message.data);
+      const decompressed = await _chunkE527CMMJcjs.decompressDataAndCheckHash.call(void 0, message.data);
       if (decompressed.error) {
         result.reject(
-          new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
+          new (0, _chunkE527CMMJcjs.FrakRpcError)(
             decompressed.error.code,
             decompressed.error.message,
             _optionalChain([decompressed, 'access', _ => _.error, 'optionalAccess', _2 => _2.data])
@@ -162,7 +162,7 @@ function createIFrameNexusClient({
       }
       channelManager.removeChannel(channelId);
     });
-    const compressedMessage = await _chunkYDZBXUC4cjs.hashAndCompressData.call(void 0, args);
+    const compressedMessage = await _chunkE527CMMJcjs.hashAndCompressData.call(void 0, args);
     messageHandler.sendEvent({
       id: channelId,
       topic: args.method,
@@ -173,20 +173,20 @@ function createIFrameNexusClient({
   const listenerRequest = async (args, callback) => {
     const isConnected = await lifecycleManager.isConnected;
     if (!isConnected) {
-      throw new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
-        _chunkYDZBXUC4cjs.RpcErrorCodes.clientNotConnected,
+      throw new (0, _chunkE527CMMJcjs.FrakRpcError)(
+        _chunkE527CMMJcjs.RpcErrorCodes.clientNotConnected,
         "The iframe provider isn't connected yet"
       );
     }
     const channelId = channelManager.createChannel(async (message) => {
-      const decompressed = await _chunkYDZBXUC4cjs.decompressDataAndCheckHash.call(void 0, message.data);
+      const decompressed = await _chunkE527CMMJcjs.decompressDataAndCheckHash.call(void 0, message.data);
       if (decompressed.result) {
         callback(decompressed.result);
       } else {
-        throw new (0, _chunkYDZBXUC4cjs.InternalError)("No valid result in the response");
+        throw new (0, _chunkE527CMMJcjs.InternalError)("No valid result in the response");
       }
     });
-    const compressedMessage = await _chunkYDZBXUC4cjs.hashAndCompressData.call(void 0, args);
+    const compressedMessage = await _chunkE527CMMJcjs.hashAndCompressData.call(void 0, args);
     messageHandler.sendEvent({
       id: channelId,
       topic: args.method,

package/dist/{chunk-7K4L7VQC.js → chunk-ZRPCX25Q.js}

@@ -235,9 +235,9 @@ function update({
   if (!url) return null;
   const currentContext = parse({ url });
   const mergedContext = currentContext ? { ...currentContext, ...context } : context;
-  if (!mergedContext.r) return;
+  if (!mergedContext.r) return null;
   const compressedContext = compress(mergedContext);
-  if (!compressedContext) return;
+  if (!compressedContext) return null;
   const urlObj = new URL(url);
   urlObj.searchParams.set(contextKey, compressedContext);
   return urlObj.toString();
@@ -248,17 +248,23 @@ function remove(url) {
   return urlObj.toString();
 }
 function replaceUrl({
-  url,
+  url: baseUrl,
   context
 }) {
   if (!window.location?.href || typeof window === "undefined") {
     console.error("No window found, can't update context");
     return;
   }
-  const newUrl = update({
-    url,
-    context
-  });
+  const url = baseUrl ?? window.location.href;
+  let newUrl;
+  if (context !== null) {
+    newUrl = update({
+      url,
+      context
+    });
+  } else {
+    newUrl = remove(url);
+  }
   if (!newUrl) return;
   window.history.replaceState(null, "", newUrl.toString());
 }

package/dist/{chunk-54MUKMZK.js → chunk-ZZ7LUFNV.js}

@@ -6,7 +6,7 @@ import {
   changeIframeVisibility,
   decompressDataAndCheckHash,
   hashAndCompressData
-} from "./chunk-7K4L7VQC.js";
+} from "./chunk-ZRPCX25Q.js";
 
 // src/core/utils/constants.ts
 var BACKUP_KEY = "nexus-wallet-backup";

package/dist/core/actions/index.cjs

@@ -8,8 +8,8 @@
 
 
 
-var _chunkQRECYKIRcjs = require('../../chunk-QRECYKIR.cjs');
-require('../../chunk-YDZBXUC4.cjs');
+var _chunkBSCR57ZIcjs = require('../../chunk-BSCR57ZI.cjs');
+require('../../chunk-E527CMMJ.cjs');
 require('../../chunk-A3XYA7S7.cjs');
 require('../../chunk-UFJ7W6CQ.cjs');
 
@@ -22,4 +22,4 @@ require('../../chunk-UFJ7W6CQ.cjs');
 
 
 
-exports.displayModal = _chunkQRECYKIRcjs.displayModal; exports.openSso = _chunkQRECYKIRcjs.openSso; exports.processReferral = _chunkQRECYKIRcjs.processReferral; exports.referralInteraction = _chunkQRECYKIRcjs.referralInteraction; exports.sendInteraction = _chunkQRECYKIRcjs.sendInteraction; exports.sendTransaction = _chunkQRECYKIRcjs.sendTransaction; exports.siweAuthenticate = _chunkQRECYKIRcjs.siweAuthenticate; exports.walletStatus = _chunkQRECYKIRcjs.walletStatus; exports.watchWalletStatus = _chunkQRECYKIRcjs.watchWalletStatus;
+exports.displayModal = _chunkBSCR57ZIcjs.displayModal; exports.openSso = _chunkBSCR57ZIcjs.openSso; exports.processReferral = _chunkBSCR57ZIcjs.processReferral; exports.referralInteraction = _chunkBSCR57ZIcjs.referralInteraction; exports.sendInteraction = _chunkBSCR57ZIcjs.sendInteraction; exports.sendTransaction = _chunkBSCR57ZIcjs.sendTransaction; exports.siweAuthenticate = _chunkBSCR57ZIcjs.siweAuthenticate; exports.walletStatus = _chunkBSCR57ZIcjs.walletStatus; exports.watchWalletStatus = _chunkBSCR57ZIcjs.watchWalletStatus;

package/dist/core/actions/index.d.cts

@@ -1,8 +1,8 @@
-import { a as NexusClient, W as WalletStatusReturnType, M as ModalStepTypes, D as DisplayModalParamsType, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../../client-DaEox5q4.cjs';
+import { a as NexusClient, W as WalletStatusReturnType, M as ModalStepTypes, D as DisplayModalParamsType, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../../FrakContext-BsezWx2F.cjs';
 import { S as SendInteractionParamsType, a as SendInteractionReturnType } from '../../interaction-BngPoHA0.cjs';
-export { S as SendTransactionParams, a as SiweAuthenticateModalParams, b as sendTransaction, s as siweAuthenticate } from '../../sendTransaction-MhdJPTWd.cjs';
+import { P as ProcessReferralOptions } from '../../processReferral-YbCg90hu.cjs';
+export { S as SendTransactionParams, a as SiweAuthenticateModalParams, p as processReferral, b as sendTransaction, s as siweAuthenticate } from '../../processReferral-YbCg90hu.cjs';
 import { Hex } from 'viem';
-import { F as FrakContext } from '../../FrakContext-LbQht1ep.cjs';
 import 'viem/chains';
 import 'viem/siwe';
 
@@ -38,25 +38,10 @@ declare function openSso(client: NexusClient, args: OpenSsoParamsType): Promise<
 
 declare function walletStatus(client: NexusClient, callback?: (status: WalletStatusReturnType) => void): Promise<WalletStatusReturnType>;
 
-declare function referralInteraction(client: NexusClient, { productId, modalConfig, }?: {
+declare function referralInteraction(client: NexusClient, { productId, modalConfig, options, }?: {
     productId?: Hex;
     modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
+    options?: ProcessReferralOptions;
 }): Promise<unknown>;
 
-type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "no-session" | "error" | "no-referrer" | "self-referral";
-/**
- * Automatically submit a referral interaction when detected
- *   -> And automatically set the referral context in the url
- * @param walletStatus
- * @param frakContext
- * @param modalConfig
- * @param productId
- */
-declare function processReferral(client: NexusClient, { walletStatus, frakContext, modalConfig, productId, }: {
-    walletStatus?: WalletStatusReturnType;
-    frakContext?: Partial<FrakContext> | null;
-    modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
-    productId?: Hex;
-}): Promise<ReferralState>;
-
-export { displayModal, openSso, processReferral, referralInteraction, sendInteraction, walletStatus, watchWalletStatus };
+export { displayModal, openSso, referralInteraction, sendInteraction, walletStatus, watchWalletStatus };

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

@@ -1,8 +1,8 @@
-import { a as NexusClient, W as WalletStatusReturnType, M as ModalStepTypes, D as DisplayModalParamsType, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../../client-ALy_TEwJ.js';
+import { a as NexusClient, W as WalletStatusReturnType, M as ModalStepTypes, D as DisplayModalParamsType, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../../FrakContext-p0Jtv9gl.js';
 import { S as SendInteractionParamsType, a as SendInteractionReturnType } from '../../interaction-BngPoHA0.js';
-export { S as SendTransactionParams, a as SiweAuthenticateModalParams, b as sendTransaction, s as siweAuthenticate } from '../../sendTransaction-BOd-pvXr.js';
+import { P as ProcessReferralOptions } from '../../processReferral-t3gUNwJu.js';
+export { S as SendTransactionParams, a as SiweAuthenticateModalParams, p as processReferral, b as sendTransaction, s as siweAuthenticate } from '../../processReferral-t3gUNwJu.js';
 import { Hex } from 'viem';
-import { F as FrakContext } from '../../FrakContext-LbQht1ep.js';
 import 'viem/chains';
 import 'viem/siwe';
 
@@ -38,25 +38,10 @@ declare function openSso(client: NexusClient, args: OpenSsoParamsType): Promise<
 
 declare function walletStatus(client: NexusClient, callback?: (status: WalletStatusReturnType) => void): Promise<WalletStatusReturnType>;
 
-declare function referralInteraction(client: NexusClient, { productId, modalConfig, }?: {
+declare function referralInteraction(client: NexusClient, { productId, modalConfig, options, }?: {
     productId?: Hex;
     modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
+    options?: ProcessReferralOptions;
 }): Promise<unknown>;
 
-type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "no-session" | "error" | "no-referrer" | "self-referral";
-/**
- * Automatically submit a referral interaction when detected
- *   -> And automatically set the referral context in the url
- * @param walletStatus
- * @param frakContext
- * @param modalConfig
- * @param productId
- */
-declare function processReferral(client: NexusClient, { walletStatus, frakContext, modalConfig, productId, }: {
-    walletStatus?: WalletStatusReturnType;
-    frakContext?: Partial<FrakContext> | null;
-    modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
-    productId?: Hex;
-}): Promise<ReferralState>;
-
-export { displayModal, openSso, processReferral, referralInteraction, sendInteraction, walletStatus, watchWalletStatus };
+export { displayModal, openSso, referralInteraction, sendInteraction, walletStatus, watchWalletStatus };

package/dist/core/actions/index.js

@@ -8,8 +8,8 @@ import {
   siweAuthenticate,
   walletStatus,
   watchWalletStatus
-} from "../../chunk-6LI5YIZB.js";
-import "../../chunk-7K4L7VQC.js";
+} from "../../chunk-MDGMJ6EQ.js";
+import "../../chunk-ZRPCX25Q.js";
 import "../../chunk-TIKEZMSD.js";
 import "../../chunk-HY6YATLS.js";
 export {

package/dist/core/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
+var _chunkWXNW7ZMUcjs = require('../chunk-WXNW7ZMU.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
 
 
 
-var _chunkYDZBXUC4cjs = require('../chunk-YDZBXUC4.cjs');
+var _chunkE527CMMJcjs = require('../chunk-E527CMMJ.cjs');
 
 
 
@@ -31,4 +31,4 @@ var _chunkUFJ7W6CQcjs = require('../chunk-UFJ7W6CQ.cjs');
 
 
 
-exports.Deferred = _chunkYDZBXUC4cjs.Deferred; exports.FrakContextManager = _chunkYDZBXUC4cjs.FrakContextManager; exports.FrakRpcError = _chunkYDZBXUC4cjs.FrakRpcError; exports.RpcErrorCodes = _chunkYDZBXUC4cjs.RpcErrorCodes; exports.compressJson = _chunkYDZBXUC4cjs.compressJson; exports.createIFrameNexusClient = _chunk2SDBW6QCcjs.createIFrameNexusClient; exports.createIframe = _chunkYDZBXUC4cjs.createIframe; exports.decompressDataAndCheckHash = _chunkYDZBXUC4cjs.decompressDataAndCheckHash; exports.decompressJson = _chunkYDZBXUC4cjs.decompressJson; exports.hashAndCompressData = _chunkYDZBXUC4cjs.hashAndCompressData; exports.interactionTypes = _chunkUFJ7W6CQcjs.interactionTypes; exports.productTypes = _chunkUFJ7W6CQcjs.productTypes; exports.productTypesMask = _chunkUFJ7W6CQcjs.productTypesMask;
+exports.Deferred = _chunkE527CMMJcjs.Deferred; exports.FrakContextManager = _chunkE527CMMJcjs.FrakContextManager; exports.FrakRpcError = _chunkE527CMMJcjs.FrakRpcError; exports.RpcErrorCodes = _chunkE527CMMJcjs.RpcErrorCodes; exports.compressJson = _chunkE527CMMJcjs.compressJson; exports.createIFrameNexusClient = _chunkWXNW7ZMUcjs.createIFrameNexusClient; exports.createIframe = _chunkE527CMMJcjs.createIframe; exports.decompressDataAndCheckHash = _chunkE527CMMJcjs.decompressDataAndCheckHash; exports.decompressJson = _chunkE527CMMJcjs.decompressJson; exports.hashAndCompressData = _chunkE527CMMJcjs.hashAndCompressData; exports.interactionTypes = _chunkUFJ7W6CQcjs.interactionTypes; exports.productTypes = _chunkUFJ7W6CQcjs.productTypes; exports.productTypesMask = _chunkUFJ7W6CQcjs.productTypesMask;

package/dist/core/index.d.cts

@@ -1,7 +1,6 @@
-import { N as NexusWalletSdkConfig, a as NexusClient } from '../client-DaEox5q4.cjs';
-export { C as ClientLifecycleEvent, D as DisplayModalParamsType, E as ExtractedParametersFromRpc, s as ExtractedReturnTypeFromRpc, n as FinalActionType, F as FinalModalStepType, q as IFrameEvent, r as IFrameLifecycleEvent, p as IFrameRpcEvent, I as IFrameRpcSchema, o as IFrameTransport, L as LoginModalStepType, b as ModalRpcMetadata, c as ModalRpcStepsInput, d as ModalRpcStepsResultType, e as ModalStepMetadata, M as ModalStepTypes, m as OpenInteractionSessionModalStepType, l as OpenInteractionSessionReturnType, O as OpenSsoParamsType, R as RpcResponse, j as SendTransactionModalStepType, k as SendTransactionReturnType, i as SendTransactionTxType, f as SiweAuthenticateModalStepType, h as SiweAuthenticateReturnType, g as SiweAuthenticationParams, S as SsoMetadata, W as WalletStatusReturnType } from '../client-DaEox5q4.cjs';
+import { N as NexusWalletSdkConfig, a as NexusClient, F as FrakContext } from '../FrakContext-BsezWx2F.cjs';
+export { C as ClientLifecycleEvent, D as DisplayModalParamsType, E as ExtractedParametersFromRpc, t as ExtractedReturnTypeFromRpc, o as FinalActionType, n as FinalModalStepType, r as IFrameEvent, s as IFrameLifecycleEvent, q as IFrameRpcEvent, I as IFrameRpcSchema, p as IFrameTransport, L as LoginModalStepType, b as ModalRpcMetadata, c as ModalRpcStepsInput, d as ModalRpcStepsResultType, e as ModalStepMetadata, M as ModalStepTypes, m as OpenInteractionSessionModalStepType, l as OpenInteractionSessionReturnType, O as OpenSsoParamsType, R as RpcResponse, j as SendTransactionModalStepType, k as SendTransactionReturnType, i as SendTransactionTxType, f as SiweAuthenticateModalStepType, h as SiweAuthenticateReturnType, g as SiweAuthenticationParams, S as SsoMetadata, W as WalletStatusReturnType } from '../FrakContext-BsezWx2F.cjs';
 import { Address } from 'viem';
-import { F as FrakContext } from '../FrakContext-LbQht1ep.cjs';
 export { P as PreparedInteraction, S as SendInteractionParamsType, a as SendInteractionReturnType } from '../interaction-BngPoHA0.cjs';
 export { F as FrakRpcError, R as RpcErrorCodes } from '../error-Dflr3G5x.cjs';
 import 'viem/chains';
@@ -89,7 +88,7 @@ declare function parse({ url }: {
 declare function update({ url, context, }: {
     url?: string;
     context: Partial<FrakContext>;
-}): string | null | undefined;
+}): string | null;
 /**
  * Remove Nexus context from current url
  */
@@ -99,9 +98,9 @@ declare function remove(url: string): string;
  * @param url
  * @param context
  */
-declare function replaceUrl({ url, context, }: {
+declare function replaceUrl({ url: baseUrl, context, }: {
     url?: string;
-    context: Partial<FrakContext>;
+    context: Partial<FrakContext> | null;
 }): void;
 /**
  * Export our frak context "class"

package/dist/core/index.d.ts

@@ -1,7 +1,6 @@
-import { N as NexusWalletSdkConfig, a as NexusClient } from '../client-ALy_TEwJ.js';
-export { C as ClientLifecycleEvent, D as DisplayModalParamsType, E as ExtractedParametersFromRpc, s as ExtractedReturnTypeFromRpc, n as FinalActionType, F as FinalModalStepType, q as IFrameEvent, r as IFrameLifecycleEvent, p as IFrameRpcEvent, I as IFrameRpcSchema, o as IFrameTransport, L as LoginModalStepType, b as ModalRpcMetadata, c as ModalRpcStepsInput, d as ModalRpcStepsResultType, e as ModalStepMetadata, M as ModalStepTypes, m as OpenInteractionSessionModalStepType, l as OpenInteractionSessionReturnType, O as OpenSsoParamsType, R as RpcResponse, j as SendTransactionModalStepType, k as SendTransactionReturnType, i as SendTransactionTxType, f as SiweAuthenticateModalStepType, h as SiweAuthenticateReturnType, g as SiweAuthenticationParams, S as SsoMetadata, W as WalletStatusReturnType } from '../client-ALy_TEwJ.js';
+import { N as NexusWalletSdkConfig, a as NexusClient, F as FrakContext } from '../FrakContext-p0Jtv9gl.js';
+export { C as ClientLifecycleEvent, D as DisplayModalParamsType, E as ExtractedParametersFromRpc, t as ExtractedReturnTypeFromRpc, o as FinalActionType, n as FinalModalStepType, r as IFrameEvent, s as IFrameLifecycleEvent, q as IFrameRpcEvent, I as IFrameRpcSchema, p as IFrameTransport, L as LoginModalStepType, b as ModalRpcMetadata, c as ModalRpcStepsInput, d as ModalRpcStepsResultType, e as ModalStepMetadata, M as ModalStepTypes, m as OpenInteractionSessionModalStepType, l as OpenInteractionSessionReturnType, O as OpenSsoParamsType, R as RpcResponse, j as SendTransactionModalStepType, k as SendTransactionReturnType, i as SendTransactionTxType, f as SiweAuthenticateModalStepType, h as SiweAuthenticateReturnType, g as SiweAuthenticationParams, S as SsoMetadata, W as WalletStatusReturnType } from '../FrakContext-p0Jtv9gl.js';
 import { Address } from 'viem';
-import { F as FrakContext } from '../FrakContext-LbQht1ep.js';
 export { P as PreparedInteraction, S as SendInteractionParamsType, a as SendInteractionReturnType } from '../interaction-BngPoHA0.js';
 export { F as FrakRpcError, R as RpcErrorCodes } from '../error-Dflr3G5x.js';
 import 'viem/chains';
@@ -89,7 +88,7 @@ declare function parse({ url }: {
 declare function update({ url, context, }: {
     url?: string;
     context: Partial<FrakContext>;
-}): string | null | undefined;
+}): string | null;
 /**
  * Remove Nexus context from current url
  */
@@ -99,9 +98,9 @@ declare function remove(url: string): string;
  * @param url
  * @param context
  */
-declare function replaceUrl({ url, context, }: {
+declare function replaceUrl({ url: baseUrl, context, }: {
     url?: string;
-    context: Partial<FrakContext>;
+    context: Partial<FrakContext> | null;
 }): void;
 /**
  * Export our frak context "class"

package/dist/core/index.js

@@ -1,6 +1,6 @@
 import {
   createIFrameNexusClient
-} from "../chunk-54MUKMZK.js";
+} from "../chunk-ZZ7LUFNV.js";
 import {
   Deferred,
   FrakContextManager,
@@ -11,7 +11,7 @@ import {
   decompressDataAndCheckHash,
   decompressJson,
   hashAndCompressData
-} from "../chunk-7K4L7VQC.js";
+} from "../chunk-ZRPCX25Q.js";
 import {
   interactionTypes,
   productTypes,

package/dist/processReferral-YbCg90hu.d.cts

@@ -0,0 +1,53 @@
+import { g as SiweAuthenticationParams, b as ModalRpcMetadata, a as NexusClient, h as SiweAuthenticateReturnType, j as SendTransactionModalStepType, k as SendTransactionReturnType, W as WalletStatusReturnType, F as FrakContext, D as DisplayModalParamsType, M as ModalStepTypes } from './FrakContext-BsezWx2F.cjs';
+import { Hex } from 'viem';
+
+/**
+ * Partial SIWE params, since we can rebuild them from the SDK if they are empty
+ */
+type SiweAuthenticateModalParams = {
+    siwe?: Partial<SiweAuthenticationParams>;
+    metadata?: ModalRpcMetadata;
+};
+/**
+ * Function used to launch a siwe authentication
+ * @param client
+ * @param siwe
+ * @param context
+ */
+declare function siweAuthenticate(client: NexusClient, { siwe, metadata }: SiweAuthenticateModalParams): Promise<SiweAuthenticateReturnType>;
+
+type SendTransactionParams = {
+    tx: SendTransactionModalStepType["params"]["tx"];
+    metadata?: ModalRpcMetadata;
+};
+/**
+ * Function used to send a user transaction
+ * @param client
+ * @param tx
+ * @param context
+ */
+declare function sendTransaction(client: NexusClient, { tx, metadata }: SendTransactionParams): Promise<SendTransactionReturnType>;
+
+type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "no-session" | "error" | "no-referrer" | "self-referral";
+type ProcessReferralOptions = {
+    alwaysAppendUrl?: boolean;
+};
+/**
+ * Automatically submit a referral interaction when detected
+ *   -> And automatically set the referral context in the url
+ * @param client
+ * @param walletStatus
+ * @param frakContext
+ * @param modalConfig
+ * @param productId
+ * @param options
+ */
+declare function processReferral(client: NexusClient, { walletStatus, frakContext, modalConfig, productId, options, }: {
+    walletStatus?: WalletStatusReturnType;
+    frakContext?: Partial<FrakContext> | null;
+    modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
+    productId?: Hex;
+    options?: ProcessReferralOptions;
+}): Promise<ReferralState>;
+
+export { type ProcessReferralOptions as P, type SendTransactionParams as S, type SiweAuthenticateModalParams as a, sendTransaction as b, processReferral as p, siweAuthenticate as s };

package/dist/processReferral-t3gUNwJu.d.ts

@@ -0,0 +1,53 @@
+import { g as SiweAuthenticationParams, b as ModalRpcMetadata, a as NexusClient, h as SiweAuthenticateReturnType, j as SendTransactionModalStepType, k as SendTransactionReturnType, W as WalletStatusReturnType, F as FrakContext, D as DisplayModalParamsType, M as ModalStepTypes } from './FrakContext-p0Jtv9gl.js';
+import { Hex } from 'viem';
+
+/**
+ * Partial SIWE params, since we can rebuild them from the SDK if they are empty
+ */
+type SiweAuthenticateModalParams = {
+    siwe?: Partial<SiweAuthenticationParams>;
+    metadata?: ModalRpcMetadata;
+};
+/**
+ * Function used to launch a siwe authentication
+ * @param client
+ * @param siwe
+ * @param context
+ */
+declare function siweAuthenticate(client: NexusClient, { siwe, metadata }: SiweAuthenticateModalParams): Promise<SiweAuthenticateReturnType>;
+
+type SendTransactionParams = {
+    tx: SendTransactionModalStepType["params"]["tx"];
+    metadata?: ModalRpcMetadata;
+};
+/**
+ * Function used to send a user transaction
+ * @param client
+ * @param tx
+ * @param context
+ */
+declare function sendTransaction(client: NexusClient, { tx, metadata }: SendTransactionParams): Promise<SendTransactionReturnType>;
+
+type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "no-session" | "error" | "no-referrer" | "self-referral";
+type ProcessReferralOptions = {
+    alwaysAppendUrl?: boolean;
+};
+/**
+ * Automatically submit a referral interaction when detected
+ *   -> And automatically set the referral context in the url
+ * @param client
+ * @param walletStatus
+ * @param frakContext
+ * @param modalConfig
+ * @param productId
+ * @param options
+ */
+declare function processReferral(client: NexusClient, { walletStatus, frakContext, modalConfig, productId, options, }: {
+    walletStatus?: WalletStatusReturnType;
+    frakContext?: Partial<FrakContext> | null;
+    modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
+    productId?: Hex;
+    options?: ProcessReferralOptions;
+}): Promise<ReferralState>;
+
+export { type ProcessReferralOptions as P, type SendTransactionParams as S, type SiweAuthenticateModalParams as a, sendTransaction as b, processReferral as p, siweAuthenticate as s };