@frak-labs/nexus-sdk 0.0.20 → 0.0.22

package/dist/core/actions/index.cjs

@@ -8,10 +8,10 @@
 
 
 
-var _chunkQRECYKIRcjs = require('../../chunk-QRECYKIR.cjs');
-require('../../chunk-YDZBXUC4.cjs');
-require('../../chunk-A3XYA7S7.cjs');
-require('../../chunk-UFJ7W6CQ.cjs');
+var _chunk4CWA7EWXcjs = require('../../chunk-4CWA7EWX.cjs');
+require('../../chunk-F3F4BCGV.cjs');
+require('../../chunk-4OJ2NPAS.cjs');
+require('../../chunk-QSXZKZJA.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 = _chunk4CWA7EWXcjs.displayModal; exports.openSso = _chunk4CWA7EWXcjs.openSso; exports.processReferral = _chunk4CWA7EWXcjs.processReferral; exports.referralInteraction = _chunk4CWA7EWXcjs.referralInteraction; exports.sendInteraction = _chunk4CWA7EWXcjs.sendInteraction; exports.sendTransaction = _chunk4CWA7EWXcjs.sendTransaction; exports.siweAuthenticate = _chunk4CWA7EWXcjs.siweAuthenticate; exports.walletStatus = _chunk4CWA7EWXcjs.walletStatus; exports.watchWalletStatus = _chunk4CWA7EWXcjs.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-DBdWC7ls.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-BWSIamn2.cjs';
+export { S as SendTransactionParams, a as SiweAuthenticateModalParams, p as processReferral, b as sendTransaction, s as siweAuthenticate } from '../../processReferral-BWSIamn2.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-CDVlUN75.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-CFyGAENf.js';
+export { S as SendTransactionParams, a as SiweAuthenticateModalParams, p as processReferral, b as sendTransaction, s as siweAuthenticate } from '../../processReferral-CFyGAENf.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,10 +8,10 @@ import {
   siweAuthenticate,
   walletStatus,
   watchWalletStatus
-} from "../../chunk-6LI5YIZB.js";
-import "../../chunk-7K4L7VQC.js";
-import "../../chunk-TIKEZMSD.js";
-import "../../chunk-HY6YATLS.js";
+} from "../../chunk-Q3SIIAX2.js";
+import "../../chunk-ZQSA2VQ4.js";
+import "../../chunk-P4QEVLVV.js";
+import "../../chunk-H3T2GAEC.js";
 export {
   displayModal,
   openSso,

package/dist/core/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
+var _chunkQYOOKB34cjs = require('../chunk-QYOOKB34.cjs');
 
 
 
@@ -11,12 +11,12 @@ var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
 
 
 
-var _chunkYDZBXUC4cjs = require('../chunk-YDZBXUC4.cjs');
+var _chunkF3F4BCGVcjs = require('../chunk-F3F4BCGV.cjs');
 
 
 
 
-var _chunkUFJ7W6CQcjs = require('../chunk-UFJ7W6CQ.cjs');
+var _chunkQSXZKZJAcjs = require('../chunk-QSXZKZJA.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 = _chunkF3F4BCGVcjs.Deferred; exports.FrakContextManager = _chunkF3F4BCGVcjs.FrakContextManager; exports.FrakRpcError = _chunkF3F4BCGVcjs.FrakRpcError; exports.RpcErrorCodes = _chunkF3F4BCGVcjs.RpcErrorCodes; exports.compressJson = _chunkF3F4BCGVcjs.compressJson; exports.createIFrameNexusClient = _chunkQYOOKB34cjs.createIFrameNexusClient; exports.createIframe = _chunkF3F4BCGVcjs.createIframe; exports.decompressDataAndCheckHash = _chunkF3F4BCGVcjs.decompressDataAndCheckHash; exports.decompressJson = _chunkF3F4BCGVcjs.decompressJson; exports.hashAndCompressData = _chunkF3F4BCGVcjs.hashAndCompressData; exports.interactionTypes = _chunkQSXZKZJAcjs.interactionTypes; exports.productTypes = _chunkQSXZKZJAcjs.productTypes; exports.productTypesMask = _chunkQSXZKZJAcjs.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-DBdWC7ls.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-DBdWC7ls.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';
@@ -37,9 +36,11 @@ declare function createIFrameNexusClient({ config, iframe, }: {
 /**
  * Create the given iframe
  * @param walletBaseUrl
+ * @param config
  */
-declare function createIframe({ walletBaseUrl, }: {
+declare function createIframe({ walletBaseUrl, config, }: {
     walletBaseUrl: string;
+    config?: NexusWalletSdkConfig;
 }): Promise<HTMLIFrameElement | undefined>;
 
 /**
@@ -89,7 +90,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 +100,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-CDVlUN75.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-CDVlUN75.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';
@@ -37,9 +36,11 @@ declare function createIFrameNexusClient({ config, iframe, }: {
 /**
  * Create the given iframe
  * @param walletBaseUrl
+ * @param config
  */
-declare function createIframe({ walletBaseUrl, }: {
+declare function createIframe({ walletBaseUrl, config, }: {
     walletBaseUrl: string;
+    config?: NexusWalletSdkConfig;
 }): Promise<HTMLIFrameElement | undefined>;
 
 /**
@@ -89,7 +90,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 +100,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-VVF4NKYR.js";
 import {
   Deferred,
   FrakContextManager,
@@ -11,12 +11,12 @@ import {
   decompressDataAndCheckHash,
   decompressJson,
   hashAndCompressData
-} from "../chunk-7K4L7VQC.js";
+} from "../chunk-ZQSA2VQ4.js";
 import {
   interactionTypes,
   productTypes,
   productTypesMask
-} from "../chunk-HY6YATLS.js";
+} from "../chunk-H3T2GAEC.js";
 export {
   Deferred,
   FrakContextManager,

package/dist/core/interactions/index.cjs

@@ -3,11 +3,11 @@
 
 
 
-var _chunkA3XYA7S7cjs = require('../../chunk-A3XYA7S7.cjs');
-require('../../chunk-UFJ7W6CQ.cjs');
+var _chunk4OJ2NPAScjs = require('../../chunk-4OJ2NPAS.cjs');
+require('../../chunk-QSXZKZJA.cjs');
 
 
 
 
 
-exports.PressInteractionEncoder = _chunkA3XYA7S7cjs.PressInteractionEncoder; exports.PurchaseInteractionEncoder = _chunkA3XYA7S7cjs.PurchaseInteractionEncoder; exports.ReferralInteractionEncoder = _chunkA3XYA7S7cjs.ReferralInteractionEncoder; exports.WebShopInteractionEncoder = _chunkA3XYA7S7cjs.WebShopInteractionEncoder;
+exports.PressInteractionEncoder = _chunk4OJ2NPAScjs.PressInteractionEncoder; exports.PurchaseInteractionEncoder = _chunk4OJ2NPAScjs.PurchaseInteractionEncoder; exports.ReferralInteractionEncoder = _chunk4OJ2NPAScjs.ReferralInteractionEncoder; exports.WebShopInteractionEncoder = _chunk4OJ2NPAScjs.WebShopInteractionEncoder;

package/dist/core/interactions/index.js

@@ -3,8 +3,8 @@ import {
   PurchaseInteractionEncoder,
   ReferralInteractionEncoder,
   WebShopInteractionEncoder
-} from "../../chunk-TIKEZMSD.js";
-import "../../chunk-HY6YATLS.js";
+} from "../../chunk-P4QEVLVV.js";
+import "../../chunk-H3T2GAEC.js";
 export {
   PressInteractionEncoder,
   PurchaseInteractionEncoder,

package/dist/processReferral-BWSIamn2.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-DBdWC7ls.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-CFyGAENf.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-CDVlUN75.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 };

package/dist/react/index.cjs

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
+var _chunkQYOOKB34cjs = require('../chunk-QYOOKB34.cjs');
 
 
 
@@ -9,16 +9,16 @@ var _chunk2SDBW6QCcjs = require('../chunk-2SDBW6QC.cjs');
 
 
 
-var _chunkQRECYKIRcjs = require('../chunk-QRECYKIR.cjs');
+var _chunk4CWA7EWXcjs = require('../chunk-4CWA7EWX.cjs');
 
 
 
 
 
 
-var _chunkYDZBXUC4cjs = require('../chunk-YDZBXUC4.cjs');
-require('../chunk-A3XYA7S7.cjs');
-require('../chunk-UFJ7W6CQ.cjs');
+var _chunkF3F4BCGVcjs = require('../chunk-F3F4BCGV.cjs');
+require('../chunk-4OJ2NPAS.cjs');
+require('../chunk-QSXZKZJA.cjs');
 
 // src/react/provider/NexusConfigProvider.ts
 var _react = require('react');
@@ -50,8 +50,8 @@ function NexusConfigProvider(parameters) {
 function useNexusConfig() {
   const config = _react.useContext.call(void 0, NexusConfigContext);
   if (!config) {
-    throw new (0, _chunkYDZBXUC4cjs.FrakRpcError)(
-      _chunkYDZBXUC4cjs.RpcErrorCodes.configError,
+    throw new (0, _chunkF3F4BCGVcjs.FrakRpcError)(
+      _chunkF3F4BCGVcjs.RpcErrorCodes.configError,
       "Nexus config not found"
     );
   }
@@ -81,12 +81,13 @@ function useWalletStatus() {
   );
   return _reactquery.useQuery.call(void 0, {
     gcTime: 0,
+    staleTime: 0,
     queryKey: ["nexus-sdk", "wallet-status-listener"],
     queryFn: async () => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.walletStatus.call(void 0, client, newStatusUpdated);
+      return _chunk4CWA7EWXcjs.walletStatus.call(void 0, client, newStatusUpdated);
     },
     enabled: !!client
   });
@@ -103,9 +104,9 @@ function useSendTransactionAction({
     mutationKey: ["nexus-sdk", "send-transaction"],
     mutationFn: async (params) => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.sendTransaction.call(void 0, client, params);
+      return _chunk4CWA7EWXcjs.sendTransaction.call(void 0, client, params);
     }
   });
 }
@@ -125,9 +126,9 @@ function useSiweAuthenticate({
     ],
     mutationFn: async (params) => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.siweAuthenticate.call(void 0, client, params);
+      return _chunk4CWA7EWXcjs.siweAuthenticate.call(void 0, client, params);
     }
   });
 }
@@ -180,12 +181,12 @@ function useFrakContext() {
   const { location } = useWindowLocation();
   const frakContext = _react.useMemo.call(void 0, () => {
     if (!_optionalChain([location, 'optionalAccess', _7 => _7.href])) return null;
-    return _chunkYDZBXUC4cjs.FrakContextManager.parse({ url: location.href });
+    return _chunkF3F4BCGVcjs.FrakContextManager.parse({ url: location.href });
   }, [_optionalChain([location, 'optionalAccess', _8 => _8.href])]);
   const updateContext = _react.useCallback.call(void 0, 
     (newContext) => {
       console.log("Updating context", { newContext });
-      _chunkYDZBXUC4cjs.FrakContextManager.replaceUrl({
+      _chunkF3F4BCGVcjs.FrakContextManager.replaceUrl({
         url: _optionalChain([location, 'optionalAccess', _9 => _9.href]),
         context: newContext
       });
@@ -201,7 +202,8 @@ function useFrakContext() {
 // src/react/hook/helper/useReferralInteraction.ts
 function useReferralInteraction({
   productId,
-  modalConfig
+  modalConfig,
+  options
 } = {}) {
   const client = useNexusClient();
   const { frakContext } = useFrakContext();
@@ -222,13 +224,14 @@ function useReferralInteraction({
     ],
     queryFn: () => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.processReferral.call(void 0, client, {
+      return _chunk4CWA7EWXcjs.processReferral.call(void 0, client, {
         walletStatus: walletStatus2,
         frakContext,
         modalConfig,
-        productId
+        productId,
+        options
       });
     },
     enabled: !!walletStatus2
@@ -251,9 +254,9 @@ function useSendInteraction({
     mutationKey: ["nexus-sdk", "send-interaction"],
     mutationFn: async (params) => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.sendInteraction.call(void 0, client, params);
+      return _chunk4CWA7EWXcjs.sendInteraction.call(void 0, client, params);
     }
   });
 }
@@ -269,9 +272,9 @@ function useDisplayModal({
     mutationKey: ["nexus-sdk", "display-modal"],
     mutationFn: async (args) => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.displayModal.call(void 0, client, args);
+      return _chunk4CWA7EWXcjs.displayModal.call(void 0, client, args);
     }
   });
 }
@@ -285,9 +288,9 @@ function useOpenSso({ mutations } = {}) {
     mutationKey: ["nexus-sdk", "open-sso"],
     mutationFn: async (params) => {
       if (!client) {
-        throw new (0, _chunkYDZBXUC4cjs.ClientNotFound)();
+        throw new (0, _chunkF3F4BCGVcjs.ClientNotFound)();
       }
-      return _chunkQRECYKIRcjs.openSso.call(void 0, client, params);
+      return _chunk4CWA7EWXcjs.openSso.call(void 0, client, params);
     }
   });
 }
@@ -303,15 +306,15 @@ function NexusIFrameClientProvider({
   const config = useNexusConfig();
   const [client, setClient] = _react.useState.call(void 0, void 0);
   const iFrame = _react.createElement.call(void 0, "iframe", {
-    ..._chunkYDZBXUC4cjs.baseIframeProps,
+    ..._chunkF3F4BCGVcjs.baseIframeProps,
     src: `${config.walletUrl}/listener`,
-    style: _nullishCoalesce(style, () => ( _chunkYDZBXUC4cjs.baseIframeProps.style)),
+    style: _nullishCoalesce(style, () => ( _chunkF3F4BCGVcjs.baseIframeProps.style)),
     ref: (iframe) => {
       if (!iframe || client) {
         return;
       }
       setClient(
-        _chunk2SDBW6QCcjs.createIFrameNexusClient.call(void 0, {
+        _chunkQYOOKB34cjs.createIFrameNexusClient.call(void 0, {
           iframe,
           config
         })

package/dist/react/index.d.cts

@@ -1,12 +1,12 @@
 import * as react from 'react';
 import { PropsWithChildren, CSSProperties, ReactNode } from 'react';
-import { N as NexusWalletSdkConfig, a as NexusClient, W as WalletStatusReturnType, k as SendTransactionReturnType, h as SiweAuthenticateReturnType, D as DisplayModalParamsType, M as ModalStepTypes, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../client-DaEox5q4.cjs';
+import { N as NexusWalletSdkConfig, a as NexusClient, W as WalletStatusReturnType, k as SendTransactionReturnType, h as SiweAuthenticateReturnType, D as DisplayModalParamsType, M as ModalStepTypes, d as ModalRpcStepsResultType, O as OpenSsoParamsType } from '../FrakContext-DBdWC7ls.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationOptions } from '@tanstack/react-query';
 import * as viem from 'viem';
 import { Hex } from 'viem';
 import { F as FrakRpcError } from '../error-Dflr3G5x.cjs';
-import { S as SendTransactionParams, a as SiweAuthenticateModalParams } from '../sendTransaction-MhdJPTWd.cjs';
+import { S as SendTransactionParams, a as SiweAuthenticateModalParams, P as ProcessReferralOptions } from '../processReferral-BWSIamn2.cjs';
 import { S as SendInteractionParamsType, a as SendInteractionReturnType } from '../interaction-BngPoHA0.cjs';
 import 'viem/chains';
 import 'viem/siwe';
@@ -19,6 +19,7 @@ declare const NexusConfigContext: react.Context<Readonly<{
     metadata: {
         name: string;
         css?: string;
+        buttonShare?: string;
     };
     domain: string;
 }> | undefined>;
@@ -40,6 +41,7 @@ declare function NexusConfigProvider(parameters: PropsWithChildren<NexusConfigPr
     metadata: {
         name: string;
         css?: string;
+        buttonShare?: string;
     };
     domain: string;
 }> | undefined>>;
@@ -75,6 +77,7 @@ declare function useNexusConfig(): Readonly<{
     metadata: {
         name: string;
         css?: string;
+        buttonShare?: string;
     };
     domain: string;
 }>;
@@ -117,10 +120,12 @@ declare function useSiweAuthenticate({ mutations, }?: UseSiweAuthenticateParams)
  *   -> And automatically set the referral context in the url
  * @param productId
  * @param modalConfig
+ * @param options
  */
-declare function useReferralInteraction({ productId, modalConfig, }?: {
+declare function useReferralInteraction({ productId, modalConfig, options, }?: {
     productId?: Hex;
     modalConfig?: DisplayModalParamsType<ModalStepTypes[]>;
+    options?: ProcessReferralOptions;
 }): Error | ("error" | "idle" | "processing" | "success" | "no-wallet" | "no-session" | "no-referrer" | "self-referral");
 
 type MutationOptions$2 = Omit<UseMutationOptions<SendInteractionReturnType, FrakRpcError, SendInteractionParamsType>, "mutationFn" | "mutationKey">;