@frak-labs/core-sdk 0.1.1 → 0.2.0

package/dist/{index-d8xS4ryI.d.ts → siweAuthenticate-BH7Dn7nZ.d.cts}

@@ -1,13 +1,11 @@
-import { A as SiweAuthenticateReturnType, B as FinalActionType, D as SendTransactionReturnType, E as SendTransactionModalStepType, L as PrepareSsoParamsType, M as OpenInteractionSessionModalStepType, P as LoginModalStepType, R as PrepareSsoReturnType, S as ModalRpcMetadata, T as ModalStepTypes, V as FinalModalStepType, a as FrakClient, g as DisplayEmbeddedWalletResultType, h as DisplayEmbeddedWalletParamsType, i as FrakContext, j as SiweAuthenticationParams, l as WalletStatusReturnType, u as GetProductInformationReturnType, w as ModalRpcStepsResultType, x as DisplayModalParamsType } from "./openSso-DsKJ4y0j.js";
-import { n as SendInteractionParamsType, r as SendInteractionReturnType } from "./interaction-KX1h9a7V.js";
-import { Hex } from "viem";
+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";
 
 //#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
+ * @returns The embedded wallet display result
  */
 declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbeddedWalletParamsType): Promise<DisplayEmbeddedWalletResultType>;
 //#endregion
@@ -24,26 +22,22 @@ declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbedd
  *
  * @remarks
  * - The UI of the displayed modal can be configured with the `customCss` property in the `customizations.css` field of the top-level config.
- * - The `login` and `openSession` steps will be automatically skipped if the user is already logged in or has an active session. It's safe to include these steps in all cases to ensure proper user state.
+ * - The `login` step will be automatically skipped if the user is already logged in. It's safe to include this step in all cases to ensure proper user state.
  * - Steps are automatically reordered in the following sequence:
  *     1. `login` (if needed)
- *     2. `openSession` (if needed)
- *     3. All other steps in the order specified
- *     4. `success` (if included, always last)
+ *     2. All other steps in the order specified
+ *     3. `success` (if included, always last)
  *
  * @example
  * Simple sharing modal with steps:
  *  1. Login (Skipped if already logged in)
- *  2. Open a session (Skipped if already opened)
- *  3. Display a success message with sharing link option
+ *  2. Display a success message with sharing link option
  *
  * ```ts
  * const results = await displayModal(frakConfig, {
  *     steps: {
  *         // Simple login with no SSO, nor customization
  *         login: { allowSso: false },
- *         // Simple session opening, with no customization
- *         openSession: {},
  *         // Success message
  *         final: {
  *             action: { key: "reward" },
@@ -54,19 +48,14 @@ declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbedd
  * });
  *
  * console.log("Login step - wallet", results.login.wallet);
- * console.log("Open session step - start + end", {
- *     start: results.openSession.startTimestamp,
- *     end: results.openSession.endTimestamp,
- * });
  * ```
  *
  * @example
  * A full modal example, with a few customization options, with the steps:
  *  1. Login (Skipped if already logged in)
- *  2. Open a session (Skipped if already opened)
- *  3. Authenticate via SIWE
- *  4. Send a transaction
- *  5. Display a success message with sharing link options
+ *  2. Authenticate via SIWE
+ *  3. Send a transaction
+ *  4. Display a success message with sharing link options
  *
  * ```ts
  * const results = await displayModal(frakConfig, {
@@ -79,8 +68,6 @@ declare function displayEmbeddedWallet(client: FrakClient, params: DisplayEmbedd
  *                 homepageLink: "https://my-app.com",
  *             },
  *         },
- *         // Simple session opening, with no customisation
- *         openSession: {},
  *         // Siwe authentication
  *         siweAuthenticate: {
  *             siwe: {
@@ -130,13 +117,40 @@ declare function displayModal<T extends ModalStepTypes[] = ModalStepTypes[]>(cli
   metadata
 }: DisplayModalParamsType<T>): Promise<ModalRpcStepsResultType<T>>;
 //#endregion
-//#region src/actions/getProductInformation.d.ts
+//#region src/actions/ensureIdentity.d.ts
+/**
+ * Ensure the current wallet ↔ clientId link exists on the backend.
+ *
+ * Called automatically by {@link watchWalletStatus} when a connected wallet
+ * status is received. Acts as a failsafe: if the primary merge (SSO, pairing,
+ * login/register) missed or silently failed, this ensures the link is
+ * eventually established.
+ *
+ * The call is:
+ * - **Idempotent** — if already linked, backend returns immediately
+ * - **Deduplicated** — only fires once per browser session per merchant
+ * - **Fire-and-forget** — errors are logged but never thrown
+ *
+ * @param interactionToken - The SDK JWT from wallet status (x-wallet-sdk-auth)
+ *
+ * @example
+ * ```ts
+ * // Usually called automatically via watchWalletStatus side effect.
+ * // Can also be called manually if needed:
+ * await ensureIdentity("eyJhbGciOi...");
+ * ```
+ */
+declare function ensureIdentity(interactionToken: string): Promise<void>;
+//#endregion
+//#region src/actions/getMerchantInformation.d.ts
 /**
- * Function used to get the current product information
+ * Fetch the current merchant information (name, rewards, tiers) from the wallet iframe
  * @param client - The current Frak Client
- * @returns The product information in a promise
+ * @returns The merchant information including available reward tiers
+ *
+ * @see {@link @frak-labs/core-sdk!index.GetMerchantInformationReturnType | `GetMerchantInformationReturnType`} for the return type shape
  */
-declare function getProductInformation(client: FrakClient): Promise<GetProductInformationReturnType>;
+declare function getMerchantInformation(client: FrakClient): Promise<GetMerchantInformationReturnType>;
 //#endregion
 //#region src/actions/prepareSso.d.ts
 /**
@@ -177,7 +191,7 @@ declare function prepareSso(client: FrakClient, args: PrepareSsoParamsType): Pro
  * The different states of the referral process
  * @inline
  */
-type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "no-session" | "error" | "no-referrer" | "self-referral";
+type ReferralState = "idle" | "processing" | "success" | "no-wallet" | "error" | "no-referrer" | "self-referral";
 /**
  * Options for the referral auto-interaction process
  */
@@ -194,11 +208,9 @@ type ProcessReferralOptions = {
  *  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. Check if the user has an interaction session or not
- *  4.1 If not, display a modal for the user to open a session
- *  5. Push the referred interaction
- *  6. Update the current url with the right data
- *  7. Return the resulting referral state
+ *  4. Track the referral event
+ *  5. Update the current url with the right data
+ *  6. Return the resulting referral state
  *
  *  If any error occurs during the process, the function will catch it and return an error state
  *
@@ -207,35 +219,29 @@ type ProcessReferralOptions = {
  * @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.productId - The product id to interact with (if not specified will be recomputed from the current domain)
  * @param args.options - Some options for the referral interaction
  * @returns  A promise with the resulting referral state
  *
  * @see {@link displayModal} for more details about the displayed modal
- * @see {@link sendInteraction} for more details on the interaction submission part
- * @see {@link ReferralInteractionEncoder} for more details about the referred interaction
  * @see {@link @frak-labs/core-sdk!ModalStepTypes} for more details on each modal steps types
  */
 declare function processReferral(client: FrakClient, {
   walletStatus,
   frakContext,
   modalConfig,
-  productId,
   options
 }: {
   walletStatus?: WalletStatusReturnType;
   frakContext?: Partial<FrakContext> | null;
   modalConfig?: DisplayEmbeddedWalletParamsType;
-  productId?: Hex;
   options?: ProcessReferralOptions;
 }): Promise<ReferralState>;
 //#endregion
 //#region src/actions/referral/referralInteraction.d.ts
 /**
- * Function used to display a modal
+ * Function used to handle referral interactions
  * @param client - The current Frak Client
  * @param args
- * @param args.productId - The product id to interact with (if not specified will be recomputed from the current domain)
  * @param args.modalConfig - The modal configuration to display if the user is not logged in
  * @param args.options - Some options for the referral interaction
  *
@@ -247,35 +253,53 @@ declare function processReferral(client: FrakClient, {
  * @see {@link @frak-labs/core-sdk!ModalStepTypes} for more details on each modal steps types
  */
 declare function referralInteraction(client: FrakClient, {
-  productId,
   modalConfig,
   options
 }?: {
-  productId?: Hex;
   modalConfig?: DisplayEmbeddedWalletParamsType;
   options?: ProcessReferralOptions;
-}): Promise<("no-referrer" | "self-referral" | "success" | "idle" | "processing" | "no-wallet" | "no-session" | "error") | undefined>;
+}): Promise<("no-referrer" | "self-referral" | "success" | "idle" | "processing" | "no-wallet" | "error") | undefined>;
 //#endregion
 //#region src/actions/sendInteraction.d.ts
 /**
- * Function used to send an interaction
- * @param client - The current Frak Client
- * @param args
+ * Send an interaction to the backend via the listener RPC.
+ * Fire-and-forget: errors are caught and logged, not thrown.
+ *
+ * @param client - The Frak client instance
+ * @param params - The interaction parameters
+ *
+ * @description Sends a user interaction event through the wallet iframe RPC. Supports three interaction types: arrival tracking, sharing events, and custom interactions.
  *
  * @example
- * const interaction = PressInteractionEncoder.openArticle({
- *     articleId: keccak256(toHex("article-slug")),
+ * Track a user arrival with referral attribution:
+ * ```ts
+ * await sendInteraction(client, {
+ *     type: "arrival",
+ *     referrerWallet: "0x1234...abcd",
+ *     landingUrl: window.location.href,
+ *     utmSource: "twitter",
+ *     utmMedium: "social",
+ *     utmCampaign: "launch-2026",
  * });
- * const { delegationId } = await sendInteraction(frakConfig, {
- *     interaction,
+ * ```
+ *
+ * @example
+ * Track a sharing event:
+ * ```ts
+ * await sendInteraction(client, { type: "sharing" });
+ * ```
+ *
+ * @example
+ * Send a custom interaction:
+ * ```ts
+ * await sendInteraction(client, {
+ *     type: "custom",
+ *     customType: "newsletter_signup",
+ *     data: { email: "user@example.com" },
  * });
- * console.log("Delegated interaction id", delegationId);
+ * ```
  */
-declare function sendInteraction(client: FrakClient, {
-  productId,
-  interaction,
-  validation
-}: SendInteractionParamsType): Promise<SendInteractionReturnType>;
+declare function sendInteraction(client: FrakClient, params: SendInteractionParamsType): Promise<void>;
 //#endregion
 //#region src/actions/trackPurchaseStatus.d.ts
 /**
@@ -285,6 +309,7 @@ declare function sendInteraction(client: FrakClient, {
  * @param args.customerId - The customer id that made the purchase (on your side)
  * @param args.orderId - The order id of the purchase (on your side)
  * @param args.token - The token of the purchase
+ * @param args.merchantId - Optional explicit merchant id to use for the tracking request
  *
  * @description This function will send a request to the backend to listen for the purchase status.
  *
@@ -294,19 +319,23 @@ declare function sendInteraction(client: FrakClient, {
  *     customerId: checkout.order.customer.id,
  *     orderId: checkout.order.id,
  *     token: checkout.token,
+ *     merchantId: "your-merchant-id",
  *   };
  *
  *   await trackPurchaseStatus(payload);
  * }
  *
  * @remarks
- * - The `trackPurchaseStatus` function requires the `frak-wallet-interaction-token` stored in the session storage to authenticate the request.
- * - This function will print a warning if used in a non-browser environment or if the wallet interaction token is not available.
+ * - Merchant id is resolved in this order: explicit `args.merchantId`, `frak-merchant-id` from session storage, then `fetchMerchantId()`.
+ * - 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.
  */
 declare function trackPurchaseStatus(args: {
   customerId: string | number;
   orderId: string | number;
   token: string;
+  merchantId?: string;
 }): Promise<void>;
 //#endregion
 //#region src/actions/watchWalletStatus.d.ts
@@ -322,7 +351,6 @@ declare function trackPurchaseStatus(args: {
  * await watchWalletStatus(frakConfig, (status: WalletStatusReturnType) => {
  *     if (status.key === "connected") {
  *         console.log("Wallet connected:", status.wallet);
- *         console.log("Current interaction session:", status.interactionSession);
  *     } else {
  *         console.log("Wallet not connected");
  *     }
@@ -362,16 +390,15 @@ type ModalStepBuilder<Steps extends ModalStepTypes[] = ModalStepTypes[]> = {
 /**
  * Represent the output type of the modal builder
  */
-type ModalBuilder = ModalStepBuilder<[LoginModalStepType, OpenInteractionSessionModalStepType]>;
+type ModalBuilder = ModalStepBuilder<[LoginModalStepType]>;
 /**
  * Helper to craft Frak modal, and share a base initial config
  * @param client - The current Frak Client
  * @param args
  * @param args.metadata - Common modal metadata (customisation, language etc)
  * @param args.login - Login step parameters
- * @param args.openSession - Open session step parameters
  *
- * @description This function will create a modal builder with the provided metadata, login and open session parameters.
+ * @description This function will create a modal builder with the provided metadata and login parameters.
  *
  * @example
  * Here is an example of how to use the `modalBuilder` to create and display a sharing modal:
@@ -400,12 +427,10 @@ type ModalBuilder = ModalStepBuilder<[LoginModalStepType, OpenInteractionSession
  */
 declare function modalBuilder(client: FrakClient, {
   metadata,
-  login,
-  openSession
+  login
 }: {
   metadata?: ModalRpcMetadata;
   login?: LoginModalStepType["params"];
-  openSession?: OpenInteractionSessionModalStepType["params"];
 }): ModalBuilder;
 //#endregion
 //#region src/actions/wrapper/sendTransaction.d.ts
@@ -508,4 +533,4 @@ declare function siweAuthenticate(client: FrakClient, {
   metadata
 }: SiweAuthenticateModalParams): Promise<SiweAuthenticateReturnType>;
 //#endregion
-export { displayEmbeddedWallet as _, ModalBuilder as a, watchWalletStatus as c, referralInteraction as d, ProcessReferralOptions as f, displayModal as g, getProductInformation as h, sendTransaction as i, trackPurchaseStatus as l, prepareSso as m, siweAuthenticate as n, ModalStepBuilder as o, processReferral as p, SendTransactionParams as r, modalBuilder as s, SiweAuthenticateModalParams as t, sendInteraction as u };
+export { displayModal as _, ModalBuilder as a, watchWalletStatus as c, referralInteraction as d, ProcessReferralOptions as f, ensureIdentity as g, getMerchantInformation as h, sendTransaction as i, trackPurchaseStatus as l, prepareSso as m, siweAuthenticate as n, ModalStepBuilder as o, processReferral as p, SendTransactionParams as r, modalBuilder as s, SiweAuthenticateModalParams as t, sendInteraction as u, displayEmbeddedWallet as v };

package/dist/siweAuthenticate-BJHbtty4.js

@@ -0,0 +1 @@
+import{a as e,h as t,o as n,r,t as i}from"./trackEvent-M2RLTQ2p.js";import{isAddressEqual as a}from"viem";import{Deferred as o,FrakRpcError as s,RpcErrorCodes as c}from"@frak-labs/frame-connector";import{generateSiweNonce as l}from"viem/siwe";async function u(e,t){return await e.request({method:`frak_displayEmbeddedWallet`,params:[t,e.config.metadata]})}async function d(e,{steps:t,metadata:n}){return await e.request({method:`frak_displayModal`,params:[t,n,e.config.metadata]})}async function f(e){if(typeof window>`u`)return;let i=t();if(!i)return;let a=await r();if(!a)return;let o=`frak-identity-ensured-${a}`;if(!window.sessionStorage.getItem(o))try{let t=n();(await fetch(`${t}/user/identity/ensure`,{method:`POST`,headers:{Accept:`application/json`,"Content-Type":`application/json`,"x-wallet-sdk-auth":e,"x-frak-client-id":i},body:JSON.stringify({merchantId:a})})).ok&&window.sessionStorage.setItem(o,`1`)}catch{}}async function p(e){return await e.request({method:`frak_getMerchantInformation`})}async function m(e,t){let{metadata:n,customizations:r}=e.config;return await e.request({method:`frak_prepareSso`,params:[t,n.name,r?.css]})}async function h(e,n){try{await e.request({method:`frak_sendInteraction`,params:[n,{clientId:t()}]})}catch{console.warn(`[Frak SDK] Failed to send interaction:`,n.type)}}async function g(t,{walletStatus:n,frakContext:r,modalConfig:a,options:o}){if(!r?.r)return`no-referrer`;i(t,`user_referred_started`,{properties:{referrer:r?.r,walletStatus:n?.key}}),h(t,{type:`arrival`,referrerWallet:r.r,landingUrl:typeof window<`u`?window.location.href:void 0});let c=!1;async function l(){if(!c)return c=!0,v(t,{modalConfig:{...a,loggedIn:{action:{key:`referred`}}},walletStatus:n})}try{let{status:a,currentWallet:s}=await _({initialWalletStatus:n,getFreshWalletStatus:l,frakContext:r});return e.replaceUrl({url:window.location?.href,context:o?.alwaysAppendUrl?{r:s}:null}),i(t,`user_referred_completed`,{properties:{status:a,referrer:r?.r,wallet:s}}),a}catch(a){return console.log(`Error processing referral`,{error:a}),i(t,`user_referred_error`,{properties:{referrer:r?.r,error:a instanceof s?`[${a.code}] ${a.name} - ${a.message}`:a instanceof Error?a.message:`undefined`}}),e.replaceUrl({url:window.location?.href,context:o?.alwaysAppendUrl?{r:n?.wallet}:null}),y(a)}}async function _({initialWalletStatus:e,getFreshWalletStatus:t,frakContext:n}){let r=e?.wallet;return r||=await t(),r&&a(n.r,r)?{status:`self-referral`,currentWallet:r}:{status:`success`,currentWallet:r}}async function v(e,{modalConfig:t,walletStatus:n}){return n?.key===`connected`?n.wallet??void 0:(await u(e,t??{}))?.wallet??void 0}function y(e){if(e instanceof s)switch(e.code){case c.walletNotConnected:return`no-wallet`;default:return`error`}return`error`}async function b(t,{modalConfig:n,options:r}={}){let i=e.parse({url:window.location.href}),a=await S(t);try{return await g(t,{walletStatus:a,frakContext:i,modalConfig:n,options:r})}catch(e){console.warn(`Error processing referral`,{error:e})}}async function x(e){if(typeof window>`u`){console.warn(`[Frak] No window found, can't track purchase`);return}let i=window.sessionStorage.getItem(`frak-wallet-interaction-token`),a=t();if(!i&&!a){console.warn(`[Frak] No identity found, skipping purchase check`);return}let o=window.sessionStorage.getItem(`frak-merchant-id`),s=e.merchantId??o??await r();if(!s){console.warn(`[Frak] No merchant id found, skipping purchase check`);return}let c={Accept:`application/json`,"Content-Type":`application/json`};i&&(c[`x-wallet-sdk-auth`]=i),a&&(c[`x-frak-client-id`]=a);let l=n();await fetch(`${l}/user/track/purchase`,{method:`POST`,headers:c,body:JSON.stringify({customerId:e.customerId,orderId:e.orderId,token:e.token,merchantId:s})})}function S(e,t){if(!t)return e.request({method:`frak_listenToWalletStatus`}).then(t=>(C(e,t),t));let n=new o,r=!1;return e.listenerRequest({method:`frak_listenToWalletStatus`},i=>{C(e,i),t(i),r||=(n.resolve(i),!0)}),n.promise}function C(e,t){typeof window>`u`||(e.openPanel?.setGlobalProperties({wallet:t.wallet??null}),t.interactionToken?(window.sessionStorage.setItem(`frak-wallet-interaction-token`,t.interactionToken),f(t.interactionToken)):window.sessionStorage.removeItem(`frak-wallet-interaction-token`))}function w(e,{metadata:t,login:n}){return T(e,{steps:{login:n??{}},metadata:t})}function T(e,t){function n(n){return T(e,{...t,steps:{...t.steps,sendTransaction:n}})}function r(n){return T(e,{...t,steps:{...t.steps,final:{...n,action:{key:`reward`}}}})}function i(n,r){return T(e,{...t,steps:{...t.steps,final:{...r,action:{key:`sharing`,options:n}}}})}async function a(n){return n&&(t.metadata=n(t.metadata??{})),await d(e,t)}return{params:t,sendTx:n,reward:r,sharing:i,display:a}}async function E(e,{tx:t,metadata:n}){return(await d(e,{metadata:n,steps:{login:{},sendTransaction:{tx:t}}})).sendTransaction}async function D(e,{siwe:t,metadata:n}){let r=e.config?.domain??window.location.host,i=t?.statement??`I confirm that I want to use my Frak wallet on: ${e.config.metadata.name}`;return(await d(e,{metadata:n,steps:{login:{},siweAuthenticate:{siwe:{...t,statement:i,nonce:t?.nonce??l(),uri:t?.uri??`https://${r}`,version:t?.version??`1`,domain:r}}}})).siweAuthenticate}export{x as a,h as c,f as d,d as f,S as i,m as l,E as n,b as o,u as p,w as r,g as s,D as t,p as u};