@frak-labs/core-sdk 0.2.0 → 0.2.1-beta.06c52c98

package/dist/{siweAuthenticate-BH7Dn7nZ.d.cts → siweAuthenticate-yITE-iKh.d.cts}

@@ -1,13 +1,14 @@
-import { A as SiweAuthenticateReturnType, D as SendTransactionReturnType, E as SendTransactionModalStepType, F as PrepareSsoParamsType, I as PrepareSsoReturnType, M as LoginModalStepType, R as FinalActionType, S as ModalRpcMetadata, T as ModalStepTypes, a as FrakClient, d as GetMerchantInformationReturnType, g as DisplayEmbeddedWalletResultType, h as DisplayEmbeddedWalletParamsType, i as FrakContext, j as SiweAuthenticationParams, l as WalletStatusReturnType, m as SendInteractionParamsType, w as ModalRpcStepsResultType, x as DisplayModalParamsType, z as FinalModalStepType } from "./openSso-BCJGchIb.cjs";
+import { A as SendTransactionModalStepType, B as PrepareSsoReturnType, E as ModalRpcMetadata, F as SiweAuthenticationParams, H as FinalActionType, I as LoginModalStepType, O as ModalRpcStepsResultType, P as SiweAuthenticateReturnType, T as DisplayModalParamsType, U as FinalModalStepType, b as DisplayEmbeddedWalletResultType, h as GetMerchantInformationReturnType, i as FrakContext, j as SendTransactionReturnType, k as ModalStepTypes, l as FrakClient, p as WalletStatusReturnType, v as SendInteractionParamsType, y as DisplayEmbeddedWalletParamsType, z as PrepareSsoParamsType } from "./openSso-n_B4LSuW.cjs";
 
 //#region src/actions/displayEmbeddedWallet.d.ts
 /**
  * Function used to display the Frak embedded wallet popup
  * @param client - The current Frak Client
  * @param params - The parameter used to customise the embedded wallet
+ * @param placement - Optional placement ID to associate with this display request
  * @returns The embedded wallet display result
  */
-declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbeddedWalletParamsType): Promise<DisplayEmbeddedWalletResultType>;
+declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbeddedWalletParamsType, placement?: string): Promise<DisplayEmbeddedWalletResultType>;
 //#endregion
 //#region src/actions/displayModal.d.ts
 /**
@@ -16,6 +17,7 @@ declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbedd
  * @param args
  * @param args.steps - The different steps of the modal
  * @param args.metadata - The metadata for the modal (customization, etc)
+ * @param placement - Optional placement ID to associate with this modal display
  * @returns The result of each modal steps
  *
  * @description This function will display a modal to the user with the provided steps and metadata.
@@ -115,7 +117,7 @@ declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbedd
 declare function displayModal<T extends ModalStepTypes[] = ModalStepTypes[]>(client: FrakClient, {
   steps,
   metadata
-}: DisplayModalParamsType<T>): Promise<ModalRpcStepsResultType<T>>;
+}: DisplayModalParamsType<T>, placement?: string): Promise<ModalRpcStepsResultType<T>>;
 //#endregion
 //#region src/actions/ensureIdentity.d.ts
 /**
@@ -188,61 +190,60 @@ declare function prepareSso(client: FrakClient, args: PrepareSsoParamsType): Pro
 //#endregion
 //#region src/actions/referral/processReferral.d.ts
 /**
- * The different states of the referral process
- * @inline
- */
-type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "error" | "no-referrer" | "self-referral";
-/**
- * Options for the referral auto-interaction process
+ * Options for the referral auto-interaction process.
  */
 type ProcessReferralOptions = {
   /**
-   * If we want to always append the url with the frak context or not
+   * If true, always replace the URL with the current user's referral context
+   * so the next visitor gets referred by this user.
    * @defaultValue false
    */
   alwaysAppendUrl?: boolean;
+  /**
+   * Merchant ID for building the current user's referral context.
+   * Required when `alwaysAppendUrl` is true and the incoming context is V1.
+   * For V2 contexts, the merchantId is already embedded in the context.
+   */
+  merchantId?: string;
 };
 /**
- * This function handle all the heavy lifting of the referral interaction process
- *  1. Check if the user has been referred or not (if not, early exit)
- *  2. Then check if the user is logged in or not
- *  2.1 If not logged in, try a soft login, if it fail, display a modal for the user to login
- *  3. Check if that's not a self-referral (if yes, early exit)
- *  4. Track the referral event
- *  5. Update the current url with the right data
- *  6. Return the resulting referral state
+ * The different states of the referral process.
+ * @inline
+ */
+type ReferralState = "idle" | "processing" | "success" | "no-referrer" | "self-referral";
+/**
+ * Handle the full referral interaction flow:
  *
- *  If any error occurs during the process, the function will catch it and return an error state
+ *  1. Check if the user has been referred (if not, early exit)
+ *  2. Preflight self-referral check (if yes, early exit)
+ *  3. Track the arrival event
+ *  4. Replace the current URL with the user's own referral context
+ *  5. Return the resulting referral state
  *
  * @param client - The current Frak Client
  * @param args
  * @param args.walletStatus - The current user wallet status
- * @param args.frakContext - The current frak context
- * @param args.modalConfig - The modal configuration to display if the user is not logged in
- * @param args.options - Some options for the referral interaction
- * @returns  A promise with the resulting referral state
+ * @param args.frakContext - The referral context parsed from the URL
+ * @param args.options - Options for URL replacement and merchant context
+ * @returns The referral state
  *
- * @see {@link displayModal} for more details about the displayed modal
- * @see {@link @frak-labs/core-sdk!ModalStepTypes} for more details on each modal steps types
+ * @see {@link @frak-labs/core-sdk!ModalStepTypes} for modal step types
  */
 declare function processReferral(client: FrakClient, {
   walletStatus,
   frakContext,
-  modalConfig,
   options
 }: {
   walletStatus?: WalletStatusReturnType;
-  frakContext?: Partial<FrakContext> | null;
-  modalConfig?: DisplayEmbeddedWalletParamsType;
+  frakContext?: FrakContext | null;
   options?: ProcessReferralOptions;
-}): Promise<ReferralState>;
+}): ReferralState;
 //#endregion
 //#region src/actions/referral/referralInteraction.d.ts
 /**
  * Function used to handle referral interactions
  * @param client - The current Frak Client
  * @param args
- * @param args.modalConfig - The modal configuration to display if the user is not logged in
  * @param args.options - Some options for the referral interaction
  *
  * @returns  A promise with the resulting referral state, or undefined in case of an error
@@ -250,15 +251,12 @@ declare function processReferral(client: FrakClient, {
  * @description This function will automatically handle the referral interaction process
  *
  * @see {@link processReferral} for more details on the automatic referral handling process
- * @see {@link @frak-labs/core-sdk!ModalStepTypes} for more details on each modal steps types
  */
 declare function referralInteraction(client: FrakClient, {
-  modalConfig,
   options
 }?: {
-  modalConfig?: DisplayEmbeddedWalletParamsType;
   options?: ProcessReferralOptions;
-}): Promise<("no-referrer" | "self-referral" | "success" | "idle" | "processing" | "no-wallet" | "error") | undefined>;
+}): Promise<("idle" | "processing" | "success" | "no-referrer" | "self-referral") | undefined>;
 //#endregion
 //#region src/actions/sendInteraction.d.ts
 /**
@@ -326,7 +324,7 @@ declare function sendInteraction(client: FrakClient, params: SendInteractionPara
  * }
  *
  * @remarks
- * - Merchant id is resolved in this order: explicit `args.merchantId`, `frak-merchant-id` from session storage, then `fetchMerchantId()`.
+ * - Merchant id is resolved in this order: explicit `args.merchantId`, then `sdkConfigStore.resolveMerchantId()` (config store → sessionStorage → backend fetch).
  * - This function supports anonymous users and will use the `x-frak-client-id` header when available.
  * - At least one identity source must exist (`frak-wallet-interaction-token` or `x-frak-client-id`), otherwise the tracking request is skipped.
  * - This function will print a warning if used in a non-browser environment or if no identity / merchant id can be resolved.
@@ -384,8 +382,9 @@ type ModalStepBuilder<Steps extends ModalStepTypes[] = ModalStepTypes[]> = {
   /**
    * Display the modal
    * @param metadataOverride - Function returning optional metadata to override the current modal metadata
+   * @param placement - Optional placement ID to associate with this modal display
    */
-  display: (metadataOverride?: (current?: ModalRpcMetadata) => ModalRpcMetadata | undefined) => Promise<ModalRpcStepsResultType<Steps>>;
+  display: (metadataOverride?: (current?: ModalRpcMetadata) => ModalRpcMetadata | undefined, placement?: string) => Promise<ModalRpcStepsResultType<Steps>>;
 };
 /**
  * Represent the output type of the modal builder

package/dist/trackEvent-5j5kkOCj.js

@@ -0,0 +1 @@
+import{bytesToHex as e,hexToBytes as t,isAddress as n,keccak256 as r,toHex as i}from"viem";import{jsonDecode as a,jsonEncode as o}from"@frak-labs/frame-connector";const s=`frak-client-id`;function c(){return typeof crypto<`u`&&crypto.randomUUID?crypto.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e===`x`?t:t&3|8).toString(16)})}function l(){if(typeof window>`u`||!window.localStorage)return console.warn(`[Frak SDK] No Window / localStorage available to save the clientId`),c();let e=localStorage.getItem(s);return e||(e=c(),localStorage.setItem(s,e)),e}function u({domain:e}={}){return r(i((e??window.location.host).replace(`www.`,``)))}function d(e){return btoa(Array.from(e,e=>String.fromCharCode(e)).join(``)).replace(/\+/g,`-`).replace(/\//g,`_`).replace(/=+$/,``)}function f(e){let t=e.length%4;return Uint8Array.from(atob(e.replace(/-/g,`+`).replace(/_/g,`/`).padEnd(e.length+(t===0?0:4-t),`=`)),e=>e.charCodeAt(0))}function p(e){return d(o(e))}function m(e,t,n,r,i,a){let o=p(ee({redirectUrl:t.redirectUrl,directExit:t.directExit,lang:t.lang,merchantId:n,metadata:{name:r,css:a,logoUrl:t.metadata?.logoUrl,homepageLink:t.metadata?.homepageLink},clientId:i})),s=new URL(e);return s.pathname=`/sso`,s.searchParams.set(`p`,o),s.toString()}function ee(e){return{r:e.redirectUrl,cId:e.clientId,d:e.directExit,l:e.lang,m:e.merchantId,md:{n:e.metadata?.name,css:e.metadata?.css,l:e.metadata?.logoUrl,h:e.metadata?.homepageLink}}}const h=`menubar=no,status=no,scrollbars=no,fullscreen=no,width=500, height=800`,g=`frak-sso`;async function _(e,t){let{metadata:n,customizations:r,walletUrl:i}=e.config;if(t.openInSameWindow??!!t.redirectUrl)return await e.request({method:`frak_openSso`,params:[t,n.name,r?.css]});let a=t.ssoPopupUrl??m(i??`https://wallet.frak.id`,t,u(),n.name,l(),r?.css),o=window.open(a,g,h);if(!o)throw Error(`Popup was blocked. Please allow popups for this site.`);return o.focus(),await e.request({method:`frak_openSso`,params:[t,n.name,r?.css]})??{}}const v=`https://backend.frak.id`;function y(e){return e.includes(`localhost:3000`)||e.includes(`localhost:3010`)}function b(e){return y(e)?`https://localhost:3030`:e.includes(`wallet-dev.frak.id`)||e.includes(`wallet.gcp-dev.frak.id`)?`https://backend.gcp-dev.frak.id`:v}function x(e){if(e)return b(e);if(typeof window<`u`){let e=window.FrakSetup?.client?.config?.walletUrl;if(e)return b(e)}return v}function S(e){return a(f(e))}function C(e){return`r`in e&&!(`v`in e)}function w(e){return`v`in e&&e.v===2}const T=`fCtx`;function E(e){if(e)try{return w(e)?!e.c||!e.m||!e.t?void 0:p({v:2,c:e.c,m:e.m,t:e.t}):d(t(e.r))}catch(t){console.error(`Error compressing Frak context`,{e:t,context:e})}}function D(t){if(!(!t||t.length===0))try{let r=S(t);if(r&&typeof r==`object`&&r.v===2)return r.c&&r.m&&r.t?{v:2,c:r.c,m:r.m,t:r.t}:void 0;let i=e(f(t),{size:20});if(n(i))return{r:i}}catch(e){console.error(`Error decompressing Frak context`,{e,context:t})}}function O({url:e}){if(!e)return null;let t=new URL(e).searchParams.get(T);return t?D(t):null}function k({url:e,context:t}){if(!e)return null;let n=E(t);if(!n)return null;let r=new URL(e);return r.searchParams.set(T,n),r.toString()}function A(e){let t=new URL(e);return t.searchParams.delete(T),t.toString()}function j({url:e,context:t}){if(!window.location?.href||typeof window>`u`){console.error(`No window found, can't update context`);return}let n=e??window.location.href,r;r=t===null?A(n):k({url:n,context:t}),r&&window.history.replaceState(null,``,r.toString())}const M={compress:E,decompress:D,parse:O,update:k,remove:A,replaceUrl:j},N=`__frakSdkConfig`,P=`frak-config-cache`,F=`frak-merchant-id`,I={key:P},L=typeof window<`u`;function R(){return{isResolved:!1,merchantId:``}}let z=null;function B(){if(!L)return null;try{let e=localStorage.getItem(I.key);if(!e)return null;let t=JSON.parse(e);return t.config?.isResolved?(z=t,t):null}catch{return null}}function V(){return(z??B())?.config}function H(){let e=z??B();return e?Date.now()-e.timestamp<3e4:!1}function U(e){if(!(!L||!e.isResolved))try{let t={config:e,timestamp:Date.now()};localStorage.setItem(I.key,JSON.stringify(t)),z=t}catch{}}function W(){if(L){z=null;try{localStorage.removeItem(I.key)}catch{}}}function G(){L&&(window[N]||(window[N]=V()??R()))}G();function K(){return L?window[N]??R():R()}function q(e){L&&window.dispatchEvent(new CustomEvent(`frak:config`,{detail:e}))}function J(e){return e??(L?window.location.hostname:``)}const Y=new Map,X=new Map;function Z(e,t){return`${e}:${t??``}`}async function Q(e,t,n){try{let r=x(t),i=n?`&lang=${encodeURIComponent(n)}`:``,a=await fetch(`${r}/user/merchant/resolve?domain=${encodeURIComponent(e)}${i}`);if(!a.ok){console.warn(`[Frak SDK] Merchant lookup failed for domain ${e}: ${a.status}`);return}let o=await a.json(),s=Z(e,n);if(Y.set(s,o),L)try{sessionStorage.setItem(F,o.merchantId)}catch{}return o}catch(e){console.warn(`[Frak SDK] Failed to fetch merchant config:`,e);return}}const $={getConfig:K,get isResolved(){return K().isResolved},get isCacheFresh(){return H()},setCacheScope(e,t){I.key=`${P}:${`${e}:${t??``}`}`,z=null},setConfig(e){if(L&&(window[N]=e),U(e),q(e),L&&e.merchantId)try{sessionStorage.setItem(F,e.merchantId)}catch{}},reset(){let e=V()??R();L&&(window[N]=e),q(e)},clearCache(){if(W(),Y.clear(),X.clear(),L)try{sessionStorage.removeItem(F)}catch{}},resolve(e,t,n){let r=J(e);if(!r)return Promise.resolve(void 0);let i=Z(r,n);if(Y.has(i))return Promise.resolve(Y.get(i));let a=X.get(i);if(a)return a;let o=Q(r,t,n).then(e=>(X.delete(i),e));return X.set(i,o),o},getMerchantId(){let e=K();if(e.isResolved&&e.merchantId)return e.merchantId;if(L)try{return sessionStorage.getItem(F)??void 0}catch{}},async resolveMerchantId(e,t){return $.getMerchantId()||(await $.resolve(e,t))?.merchantId}};function te(e,t,n={}){if(!e){console.debug(`[Frak] No client provided, skipping event tracking`);return}try{e.openPanel?.track(t,n)}catch(e){console.debug(`[Frak] Failed to track event:`,t,e)}}export{w as a,_ as c,m as d,p as f,l as g,u as h,C as i,h as l,d as m,$ as n,S as o,f as p,M as r,x as s,te as t,g as u};

package/dist/trackEvent-B2uom25e.cjs

@@ -0,0 +1 @@
+let e=require(`viem`),t=require(`@frak-labs/frame-connector`);const n=`frak-client-id`;function r(){return typeof crypto<`u`&&crypto.randomUUID?crypto.randomUUID():`xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx`.replace(/[xy]/g,e=>{let t=Math.random()*16|0;return(e===`x`?t:t&3|8).toString(16)})}function i(){if(typeof window>`u`||!window.localStorage)return console.warn(`[Frak SDK] No Window / localStorage available to save the clientId`),r();let e=localStorage.getItem(n);return e||(e=r(),localStorage.setItem(n,e)),e}function a({domain:t}={}){return(0,e.keccak256)((0,e.toHex)((t??window.location.host).replace(`www.`,``)))}function o(e){return btoa(Array.from(e,e=>String.fromCharCode(e)).join(``)).replace(/\+/g,`-`).replace(/\//g,`_`).replace(/=+$/,``)}function s(e){let t=e.length%4;return Uint8Array.from(atob(e.replace(/-/g,`+`).replace(/_/g,`/`).padEnd(e.length+(t===0?0:4-t),`=`)),e=>e.charCodeAt(0))}function c(e){return o((0,t.jsonEncode)(e))}function l(e,t,n,r,i,a){let o=c(u({redirectUrl:t.redirectUrl,directExit:t.directExit,lang:t.lang,merchantId:n,metadata:{name:r,css:a,logoUrl:t.metadata?.logoUrl,homepageLink:t.metadata?.homepageLink},clientId:i})),s=new URL(e);return s.pathname=`/sso`,s.searchParams.set(`p`,o),s.toString()}function u(e){return{r:e.redirectUrl,cId:e.clientId,d:e.directExit,l:e.lang,m:e.merchantId,md:{n:e.metadata?.name,css:e.metadata?.css,l:e.metadata?.logoUrl,h:e.metadata?.homepageLink}}}const d=`menubar=no,status=no,scrollbars=no,fullscreen=no,width=500, height=800`,f=`frak-sso`;async function p(e,t){let{metadata:n,customizations:r,walletUrl:o}=e.config;if(t.openInSameWindow??!!t.redirectUrl)return await e.request({method:`frak_openSso`,params:[t,n.name,r?.css]});let s=t.ssoPopupUrl??l(o??`https://wallet.frak.id`,t,a(),n.name,i(),r?.css),c=window.open(s,f,d);if(!c)throw Error(`Popup was blocked. Please allow popups for this site.`);return c.focus(),await e.request({method:`frak_openSso`,params:[t,n.name,r?.css]})??{}}const m=`https://backend.frak.id`;function h(e){return e.includes(`localhost:3000`)||e.includes(`localhost:3010`)}function g(e){return h(e)?`https://localhost:3030`:e.includes(`wallet-dev.frak.id`)||e.includes(`wallet.gcp-dev.frak.id`)?`https://backend.gcp-dev.frak.id`:m}function _(e){if(e)return g(e);if(typeof window<`u`){let e=window.FrakSetup?.client?.config?.walletUrl;if(e)return g(e)}return m}function v(e){return(0,t.jsonDecode)(s(e))}function y(e){return`r`in e&&!(`v`in e)}function b(e){return`v`in e&&e.v===2}const x=`fCtx`;function S(t){if(t)try{return b(t)?!t.c||!t.m||!t.t?void 0:c({v:2,c:t.c,m:t.m,t:t.t}):o((0,e.hexToBytes)(t.r))}catch(e){console.error(`Error compressing Frak context`,{e,context:t})}}function C(t){if(!(!t||t.length===0))try{let n=v(t);if(n&&typeof n==`object`&&n.v===2)return n.c&&n.m&&n.t?{v:2,c:n.c,m:n.m,t:n.t}:void 0;let r=(0,e.bytesToHex)(s(t),{size:20});if((0,e.isAddress)(r))return{r}}catch(e){console.error(`Error decompressing Frak context`,{e,context:t})}}function w({url:e}){if(!e)return null;let t=new URL(e).searchParams.get(x);return t?C(t):null}function T({url:e,context:t}){if(!e)return null;let n=S(t);if(!n)return null;let r=new URL(e);return r.searchParams.set(x,n),r.toString()}function E(e){let t=new URL(e);return t.searchParams.delete(x),t.toString()}function D({url:e,context:t}){if(!window.location?.href||typeof window>`u`){console.error(`No window found, can't update context`);return}let n=e??window.location.href,r;r=t===null?E(n):T({url:n,context:t}),r&&window.history.replaceState(null,``,r.toString())}const O={compress:S,decompress:C,parse:w,update:T,remove:E,replaceUrl:D},k=`__frakSdkConfig`,A=`frak-config-cache`,j=`frak-merchant-id`,M={key:A},N=typeof window<`u`;function P(){return{isResolved:!1,merchantId:``}}let F=null;function I(){if(!N)return null;try{let e=localStorage.getItem(M.key);if(!e)return null;let t=JSON.parse(e);return t.config?.isResolved?(F=t,t):null}catch{return null}}function L(){return(F??I())?.config}function R(){let e=F??I();return e?Date.now()-e.timestamp<3e4:!1}function z(e){if(!(!N||!e.isResolved))try{let t={config:e,timestamp:Date.now()};localStorage.setItem(M.key,JSON.stringify(t)),F=t}catch{}}function B(){if(N){F=null;try{localStorage.removeItem(M.key)}catch{}}}function V(){N&&(window[k]||(window[k]=L()??P()))}V();function H(){return N?window[k]??P():P()}function U(e){N&&window.dispatchEvent(new CustomEvent(`frak:config`,{detail:e}))}function W(e){return e??(N?window.location.hostname:``)}const G=new Map,K=new Map;function q(e,t){return`${e}:${t??``}`}async function J(e,t,n){try{let r=_(t),i=n?`&lang=${encodeURIComponent(n)}`:``,a=await fetch(`${r}/user/merchant/resolve?domain=${encodeURIComponent(e)}${i}`);if(!a.ok){console.warn(`[Frak SDK] Merchant lookup failed for domain ${e}: ${a.status}`);return}let o=await a.json(),s=q(e,n);if(G.set(s,o),N)try{sessionStorage.setItem(j,o.merchantId)}catch{}return o}catch(e){console.warn(`[Frak SDK] Failed to fetch merchant config:`,e);return}}const Y={getConfig:H,get isResolved(){return H().isResolved},get isCacheFresh(){return R()},setCacheScope(e,t){M.key=`${A}:${`${e}:${t??``}`}`,F=null},setConfig(e){if(N&&(window[k]=e),z(e),U(e),N&&e.merchantId)try{sessionStorage.setItem(j,e.merchantId)}catch{}},reset(){let e=L()??P();N&&(window[k]=e),U(e)},clearCache(){if(B(),G.clear(),K.clear(),N)try{sessionStorage.removeItem(j)}catch{}},resolve(e,t,n){let r=W(e);if(!r)return Promise.resolve(void 0);let i=q(r,n);if(G.has(i))return Promise.resolve(G.get(i));let a=K.get(i);if(a)return a;let o=J(r,t,n).then(e=>(K.delete(i),e));return K.set(i,o),o},getMerchantId(){let e=H();if(e.isResolved&&e.merchantId)return e.merchantId;if(N)try{return sessionStorage.getItem(j)??void 0}catch{}},async resolveMerchantId(e,t){return Y.getMerchantId()||(await Y.resolve(e,t))?.merchantId}};function X(e,t,n={}){if(!e){console.debug(`[Frak] No client provided, skipping event tracking`);return}try{e.openPanel?.track(t,n)}catch(e){console.debug(`[Frak] Failed to track event:`,t,e)}}Object.defineProperty(exports,`a`,{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,`c`,{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,`d`,{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,`f`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`g`,{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,`h`,{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,`i`,{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,`l`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`m`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return Y}}),Object.defineProperty(exports,`o`,{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,`p`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`r`,{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,`s`,{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return X}}),Object.defineProperty(exports,`u`,{enumerable:!0,get:function(){return f}});

package/package.json

@@ -11,7 +11,7 @@
       "url": "https://twitter.com/QNivelais"
     }
   ],
-  "version": "0.2.0",
+  "version": "0.2.1-beta.06c52c98",
   "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,22 +91,22 @@
     "viem": "^2.x"
   },
   "dependencies": {
-    "@frak-labs/frame-connector": "0.2.0",
-    "@openpanel/web": "^1.0.7"
+    "@frak-labs/frame-connector": "0.2.0-beta.06c52c98",
+    "@openpanel/web": "^1.2.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.2",
     "@frak-labs/dev-tooling": "0.0.0",
     "@frak-labs/test-foundation": "0.1.0",
     "@rolldown/plugin-node-polyfills": "^1.0.3",
-    "@types/jsdom": "^27.0.0",
+    "@types/jsdom": "^28.0.0",
     "@types/node": "^24.10.13",
-    "@vitest/coverage-v8": "^4.0.18",
-    "@vitest/ui": "^4.0.18",
-    "jsdom": "^28.0.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/ui": "^4.1.0",
+    "jsdom": "^29.0.0",
     "tsdown": "^0.20.3",
     "typescript": "^5.9.3",
     "viem": "^2.39.0",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   }
 }

package/src/actions/displayEmbeddedWallet.ts

@@ -8,14 +8,18 @@ import type {
  * Function used to display the Frak embedded wallet popup
  * @param client - The current Frak Client
  * @param params - The parameter used to customise the embedded wallet
+ * @param placement - Optional placement ID to associate with this display request
  * @returns The embedded wallet display result
  */
 export async function displayEmbeddedWallet(
     client: FrakClient,
-    params: DisplayEmbeddedWalletParamsType
+    params: DisplayEmbeddedWalletParamsType,
+    placement?: string
 ): Promise<DisplayEmbeddedWalletResultType> {
     return await client.request({
         method: "frak_displayEmbeddedWallet",
-        params: [params, client.config.metadata],
+        params: placement
+            ? [params, client.config.metadata, placement]
+            : [params, client.config.metadata],
     });
 }

package/src/actions/displayModal.ts

@@ -11,6 +11,7 @@ import type {
  * @param args
  * @param args.steps - The different steps of the modal
  * @param args.metadata - The metadata for the modal (customization, etc)
+ * @param placement - Optional placement ID to associate with this modal display
  * @returns The result of each modal steps
  *
  * @description This function will display a modal to the user with the provided steps and metadata.
@@ -111,10 +112,13 @@ export async function displayModal<
     T extends ModalStepTypes[] = ModalStepTypes[],
 >(
     client: FrakClient,
-    { steps, metadata }: DisplayModalParamsType<T>
+    { steps, metadata }: DisplayModalParamsType<T>,
+    placement?: string
 ): Promise<ModalRpcStepsResultType<T>> {
     return (await client.request({
         method: "frak_displayModal",
-        params: [steps, metadata, client.config.metadata],
+        params: placement
+            ? [steps, metadata, client.config.metadata, placement]
+            : [steps, metadata, client.config.metadata],
     })) as ModalRpcStepsResultType<T>;
 }

package/src/actions/ensureIdentity.ts

@@ -1,6 +1,6 @@
 import { getBackendUrl } from "../utils/backendUrl";
 import { getClientId } from "../utils/clientId";
-import { fetchMerchantId } from "../utils/merchantId";
+import { sdkConfigStore } from "../utils/sdkConfigStore";
 
 const ENSURE_STORAGE_PREFIX = "frak-identity-ensured-";
 
@@ -36,7 +36,7 @@ export async function ensureIdentity(interactionToken: string): Promise<void> {
         return;
     }
 
-    const merchantId = await fetchMerchantId();
+    const merchantId = await sdkConfigStore.resolveMerchantId();
     if (!merchantId) {
         return;
     }

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

@@ -1,6 +1,5 @@
-import { FrakRpcError, RpcErrorCodes } from "@frak-labs/frame-connector";
 import type { Address } from "viem";
-import { vi } from "vitest"; // Keep vi from vitest for vi.mock() hoisting
+import { vi } from "vitest";
 import {
     afterEach,
     beforeEach,
@@ -11,15 +10,11 @@ import {
 import type {
     FrakClient,
     FrakContext,
+    FrakContextV2,
     WalletStatusReturnType,
 } from "../../types";
 import { processReferral } from "./processReferral";
 
-// Mock dependencies
-vi.mock("../displayEmbeddedWallet", () => ({
-    displayEmbeddedWallet: vi.fn(),
-}));
-
 vi.mock("../sendInteraction", () => ({
     sendInteraction: vi.fn().mockResolvedValue(undefined),
 }));
@@ -30,21 +25,18 @@ vi.mock("../../utils", () => ({
     },
     trackEvent: vi.fn(),
     resolveMerchantId: vi.fn().mockResolvedValue(undefined),
+    getClientId: vi.fn().mockReturnValue("test-client-id"),
 }));
 
 describe("processReferral", () => {
     let mockClient: FrakClient;
     let mockAddress: Address;
-    let mockReferrerAddress: Address;
     let mockWalletStatus: WalletStatusReturnType;
-    let mockFrakContext: Partial<FrakContext>;
 
     beforeEach(async () => {
         vi.clearAllMocks();
 
         mockAddress = "0x1234567890123456789012345678901234567890" as Address;
-        mockReferrerAddress =
-            "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd" as Address;
 
         mockClient = {
             openPanel: {
@@ -64,11 +56,6 @@ describe("processReferral", () => {
             wallet: mockAddress,
         };
 
-        mockFrakContext = {
-            r: mockReferrerAddress,
-        };
-
-        // Mock window.location
         Object.defineProperty(window, "location", {
             value: {
                 href: "https://example.com/test",
@@ -81,15 +68,6 @@ describe("processReferral", () => {
         vi.clearAllMocks();
     });
 
-    it("should return 'no-referrer' when frakContext has no referrer", async () => {
-        const result = await processReferral(mockClient, {
-            walletStatus: mockWalletStatus,
-            frakContext: {},
-        });
-
-        expect(result).toBe("no-referrer");
-    });
-
     it("should return 'no-referrer' when frakContext is null", async () => {
         const result = await processReferral(mockClient, {
             walletStatus: mockWalletStatus,
@@ -99,128 +77,148 @@ describe("processReferral", () => {
         expect(result).toBe("no-referrer");
     });
 
-    it("should return 'self-referral' when referrer equals current wallet", async () => {
-        const result = await processReferral(mockClient, {
-            walletStatus: mockWalletStatus,
-            frakContext: {
-                r: mockAddress, // Same as wallet
-            },
-        });
-
-        expect(result).toBe("self-referral");
-    });
-
-    it("should successfully process referral when all conditions are met", async () => {
-        const utils = await import("../../utils");
+    describe("V2 context", () => {
+        const v2Context: FrakContextV2 = {
+            v: 2,
+            c: "referrer-client-id",
+            m: "merchant-uuid",
+            t: 1709654400,
+        };
 
-        const result = await processReferral(mockClient, {
-            walletStatus: mockWalletStatus,
-            frakContext: mockFrakContext,
+        it("should successfully process v2 referral", async () => {
+            const utils = await import("../../utils");
+            const { sendInteraction } = await import("../sendInteraction");
+
+            const result = await processReferral(mockClient, {
+                walletStatus: mockWalletStatus,
+                frakContext: v2Context,
+            });
+
+            expect(result).toBe("success");
+
+            expect(utils.trackEvent).toHaveBeenCalledWith(
+                mockClient,
+                "user_referred_started",
+                {
+                    properties: {
+                        referrerClientId: "referrer-client-id",
+                        walletStatus: "connected",
+                    },
+                }
+            );
+
+            expect(sendInteraction).toHaveBeenCalledWith(mockClient, {
+                type: "arrival",
+                referrerClientId: "referrer-client-id",
+                referrerMerchantId: "merchant-uuid",
+                referralTimestamp: 1709654400,
+                landingUrl: "https://example.com/test",
+            });
         });
 
-        expect(result).toBe("success");
+        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");
 
-        expect(utils.trackEvent).toHaveBeenCalledWith(
-            mockClient,
-            "user_referred_started",
-            {
-                properties: {
-                    referrer: mockReferrerAddress,
-                    walletStatus: "connected",
-                },
-            }
-        );
-
-        expect(utils.trackEvent).toHaveBeenCalledWith(
-            mockClient,
-            "user_referred_completed",
-            {
-                properties: {
-                    status: "success",
-                    referrer: mockReferrerAddress,
-                    wallet: mockAddress,
-                },
-            }
-        );
-    });
+            const v2SelfReferralContext: FrakContextV2 = {
+                v: 2,
+                c: "referrer-client-id",
+                m: "merchant-uuid",
+                t: 1709654400,
+            };
 
-    it("should handle wallet not connected scenario", async () => {
-        const { displayEmbeddedWallet } = await import(
-            "../displayEmbeddedWallet"
-        );
+            const result = await processReferral(mockClient, {
+                walletStatus: mockWalletStatus,
+                frakContext: v2SelfReferralContext,
+            });
 
-        // Mock displayEmbeddedWallet to return a wallet
-        vi.mocked(displayEmbeddedWallet).mockResolvedValue({
-            wallet: mockAddress,
-        } as any);
-
-        const result = await processReferral(mockClient, {
-            walletStatus: undefined,
-            frakContext: mockFrakContext,
+            expect(result).toBe("self-referral");
+            vi.mocked(utils.getClientId).mockReturnValue("test-client-id");
         });
-
-        expect(result).toBe("success");
-        expect(displayEmbeddedWallet).toHaveBeenCalled();
     });
 
-    it("should return 'no-wallet' when wallet connection fails", async () => {
-        const { displayEmbeddedWallet } = await import(
-            "../displayEmbeddedWallet"
-        );
-
-        const error = new FrakRpcError(
-            RpcErrorCodes.walletNotConnected,
-            "Wallet not connected"
-        );
-        vi.mocked(displayEmbeddedWallet).mockRejectedValue(error);
+    describe("V1 context (backward compat)", () => {
+        const v1Context: FrakContext = {
+            r: "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd" as Address,
+        };
 
-        const result = await processReferral(mockClient, {
-            walletStatus: undefined,
-            frakContext: mockFrakContext,
+        it("should successfully process v1 referral", async () => {
+            const utils = await import("../../utils");
+
+            const result = await processReferral(mockClient, {
+                walletStatus: mockWalletStatus,
+                frakContext: v1Context,
+            });
+
+            expect(result).toBe("success");
+
+            expect(utils.trackEvent).toHaveBeenCalledWith(
+                mockClient,
+                "user_referred_started",
+                {
+                    properties: {
+                        referrer: "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
+                        walletStatus: "connected",
+                    },
+                }
+            );
         });
 
-        expect(result).toBe("no-wallet");
-    });
-
-    it("should return 'error' for unknown errors", async () => {
-        const { displayEmbeddedWallet } = await import(
-            "../displayEmbeddedWallet"
-        );
-
-        const error = new Error("Unknown error");
-        vi.mocked(displayEmbeddedWallet).mockRejectedValue(error);
+        it("should return 'self-referral' when v1 referrer matches current wallet", async () => {
+            const result = await processReferral(mockClient, {
+                walletStatus: mockWalletStatus,
+                frakContext: {
+                    r: mockAddress,
+                },
+            });
 
-        const result = await processReferral(mockClient, {
-            walletStatus: undefined,
-            frakContext: mockFrakContext,
+            expect(result).toBe("self-referral");
         });
-
-        expect(result).toBe("error");
     });
 
     it("should update URL context when alwaysAppendUrl is true", async () => {
         const utils = await import("../../utils");
 
+        const v2Context: FrakContextV2 = {
+            v: 2,
+            c: "referrer-client-id",
+            m: "merchant-uuid",
+            t: 1709654400,
+        };
+
         await processReferral(mockClient, {
             walletStatus: mockWalletStatus,
-            frakContext: mockFrakContext,
+            frakContext: v2Context,
             options: {
                 alwaysAppendUrl: true,
             },
         });
 
+        expect(utils.getClientId()).toBe("test-client-id");
+
         expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
             url: window.location.href,
-            context: { r: mockAddress },
+            context: expect.objectContaining({
+                v: 2,
+                c: "test-client-id",
+                m: "merchant-uuid",
+            }),
         });
     });
 
     it("should remove URL context when alwaysAppendUrl is false", async () => {
         const utils = await import("../../utils");
 
+        const v2Context: FrakContextV2 = {
+            v: 2,
+            c: "referrer-client-id",
+            m: "merchant-uuid",
+            t: 1709654400,
+        };
+
         await processReferral(mockClient, {
             walletStatus: mockWalletStatus,
-            frakContext: mockFrakContext,
+            frakContext: v2Context,
             options: {
                 alwaysAppendUrl: false,
             },
@@ -231,18 +229,4 @@ describe("processReferral", () => {
             context: null,
         });
     });
-
-    it("should remove URL context by default", async () => {
-        const utils = await import("../../utils");
-
-        await processReferral(mockClient, {
-            walletStatus: mockWalletStatus,
-            frakContext: mockFrakContext,
-        });
-
-        expect(utils.FrakContextManager.replaceUrl).toHaveBeenCalledWith({
-            url: window.location.href,
-            context: null,
-        });
-    });
 });