@frak-labs/nexus-sdk 0.0.14 → 0.0.16

package/dist/chunk-D77BTQYS.js

@@ -0,0 +1,210 @@
+import {
+  Deferred,
+  FrakContextManager,
+  FrakRpcError,
+  RpcErrorCodes
+} from "./chunk-FYMOOHMT.js";
+import {
+  ReferralInteractionEncoder
+} from "./chunk-TIKEZMSD.js";
+
+// src/core/actions/watchWalletStatus.ts
+function watchWalletStatus(client, callback) {
+  return client.listenerRequest(
+    {
+      method: "frak_listenToWalletStatus"
+    },
+    callback
+  );
+}
+
+// src/core/utils/computeProductId.ts
+import { keccak256, toHex } from "viem";
+function computeProductId({ domain }) {
+  return keccak256(toHex(domain));
+}
+
+// src/core/actions/sendInteraction.ts
+async function sendInteraction(client, { productId, interaction, validation }) {
+  const pId = productId ?? computeProductId(client.config);
+  return await client.request({
+    method: "frak_sendInteraction",
+    params: [pId, interaction, validation]
+  });
+}
+
+// src/core/actions/displayModal.ts
+async function displayModal(client, { steps, metadata }) {
+  return await client.request({
+    method: "frak_displayModal",
+    params: [steps, client.config.metadata.name, metadata]
+  });
+}
+
+// src/core/actions/openSso.ts
+async function openSso(client, args) {
+  const { metadata } = client.config;
+  await client.request({
+    method: "frak_sso",
+    params: [args, metadata.name, metadata.css]
+  });
+}
+
+// src/core/actions/wrapper/siweAuthenticate.ts
+import { generateSiweNonce } from "viem/siwe";
+async function siweAuthenticate(client, { siwe, metadata }) {
+  const realStatement = siwe?.statement ?? `I confirm that I want to use my Frak wallet on: ${client.config.metadata.name}`;
+  const builtSiwe = {
+    ...siwe,
+    statement: realStatement,
+    nonce: siwe?.nonce ?? generateSiweNonce(),
+    uri: siwe?.uri ?? `https://${client.config.domain}`,
+    version: siwe?.version ?? "1",
+    domain: client.config.domain
+  };
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      siweAuthenticate: {
+        siwe: builtSiwe
+      }
+    }
+  });
+  return result.siweAuthenticate;
+}
+
+// src/core/actions/wrapper/sendTransaction.ts
+async function sendTransaction(client, { tx, metadata }) {
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      sendTransaction: { tx }
+    }
+  });
+  return result.sendTransaction;
+}
+
+// src/core/actions/wrapper/walletStatus.ts
+async function walletStatus(client, callback) {
+  const firstResult = new Deferred();
+  let hasResolved = false;
+  await watchWalletStatus(client, (status) => {
+    callback?.(status);
+    if (!hasResolved) {
+      firstResult.resolve(status);
+      hasResolved = true;
+    }
+  });
+  return firstResult.promise;
+}
+
+// src/core/actions/referral/processReferral.ts
+import { isAddressEqual } from "viem";
+async function processReferral(client, {
+  walletStatus: walletStatus2,
+  frakContext,
+  modalConfig,
+  productId
+}) {
+  try {
+    let currentWallet = walletStatus2?.wallet;
+    if (!frakContext?.r) {
+      if (currentWallet) {
+        await FrakContextManager.replaceUrl({
+          url: window.location?.href,
+          context: { r: currentWallet }
+        });
+      }
+      return "no-referrer";
+    }
+    if (!currentWallet) {
+      currentWallet = await ensureWalletConnected(client, {
+        modalConfig,
+        walletStatus: walletStatus2
+      });
+    }
+    if (currentWallet && isAddressEqual(frakContext.r, currentWallet)) {
+      return "self-referral";
+    }
+    if (!walletStatus2?.interactionSession) {
+      currentWallet = await ensureWalletConnected(client, {
+        modalConfig,
+        walletStatus: walletStatus2
+      });
+    }
+    if (currentWallet) {
+      await FrakContextManager.replaceUrl({
+        url: window.location?.href,
+        context: { r: currentWallet }
+      });
+    }
+    const interaction = ReferralInteractionEncoder.referred({
+      referrer: frakContext.r
+    });
+    await sendInteraction(client, { productId, interaction });
+    return "success";
+  } catch (error) {
+    return mapErrorToState(error);
+  }
+}
+async function ensureWalletConnected(client, {
+  modalConfig,
+  walletStatus: walletStatus2
+}) {
+  if (!walletStatus2?.interactionSession) {
+    if (!modalConfig) {
+      return void 0;
+    }
+    const result = await displayModal(client, modalConfig);
+    return result?.login?.wallet ?? void 0;
+  }
+  return walletStatus2.wallet ?? void 0;
+}
+function mapErrorToState(error) {
+  if (error instanceof FrakRpcError) {
+    switch (error.code) {
+      case RpcErrorCodes.walletNotConnected:
+        return "no-wallet";
+      case RpcErrorCodes.serverErrorForInteractionDelegation:
+        return "no-session";
+      default:
+        return "error";
+    }
+  }
+  return "error";
+}
+
+// src/core/actions/referral/referralInteraction.ts
+async function referralInteraction(client, {
+  productId,
+  modalConfig
+} = {}) {
+  const frakContext = await FrakContextManager.parse({
+    url: window.location.href
+  });
+  const currentWalletStatus = await walletStatus(client);
+  try {
+    return await processReferral(client, {
+      walletStatus: currentWalletStatus,
+      frakContext,
+      modalConfig,
+      productId
+    });
+  } catch (error) {
+    return error;
+  }
+}
+
+export {
+  watchWalletStatus,
+  sendInteraction,
+  displayModal,
+  openSso,
+  siweAuthenticate,
+  sendTransaction,
+  walletStatus,
+  processReferral,
+  referralInteraction
+};

package/dist/chunk-DAGCBEBQ.cjs

@@ -0,0 +1,243 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkJ655X6YRcjs = require('./chunk-J655X6YR.cjs');
+
+// src/core/utils/constants.ts
+var BACKUP_KEY = "nexus-wallet-backup";
+
+// src/core/clients/transports/iframeChannelManager.ts
+function createIFrameChannelManager() {
+  const channels = /* @__PURE__ */ new Map();
+  return {
+    // TODO: Better id system?? uid stuff?
+    createChannel: (resolver) => {
+      const id = Math.random().toString(36).substring(7);
+      channels.set(id, resolver);
+      return id;
+    },
+    getRpcResolver: (id) => channels.get(id),
+    removeChannel: (id) => channels.delete(id),
+    destroy: () => channels.clear()
+  };
+}
+
+// src/core/clients/transports/iframeLifecycleManager.ts
+function createIFrameLifecycleManager({
+  iframe
+}) {
+  const isConnectedDeferred = new (0, _chunkJ655X6YRcjs.Deferred)();
+  const handler = async (messageEvent) => {
+    switch (messageEvent.iframeLifecycle) {
+      // Resolve the isConnected promise
+      case "connected":
+        isConnectedDeferred.resolve(true);
+        break;
+      // Perform a nexus backup
+      case "do-backup":
+        if (messageEvent.data.backup) {
+          localStorage.setItem(BACKUP_KEY, messageEvent.data.backup);
+        } else {
+          localStorage.removeItem(BACKUP_KEY);
+        }
+        break;
+      // Remove nexus backup
+      case "remove-backup":
+        localStorage.removeItem(BACKUP_KEY);
+        break;
+      // Change iframe visibility
+      case "show":
+      case "hide":
+        _chunkJ655X6YRcjs.changeIframeVisibility.call(void 0, {
+          iframe,
+          isVisible: messageEvent.iframeLifecycle === "show"
+        });
+        break;
+    }
+  };
+  return {
+    handleEvent: handler,
+    isConnected: isConnectedDeferred.promise
+  };
+}
+
+// src/core/clients/transports/iframeMessageHandler.ts
+function createIFrameMessageHandler({
+  nexusWalletUrl,
+  iframe,
+  channelManager,
+  iframeLifecycleManager
+}) {
+  if (typeof window === "undefined") {
+    throw new (0, _chunkJ655X6YRcjs.FrakRpcError)(
+      _chunkJ655X6YRcjs.RpcErrorCodes.configError,
+      "iframe client should be used in the browser"
+    );
+  }
+  if (!iframe.contentWindow) {
+    throw new (0, _chunkJ655X6YRcjs.FrakRpcError)(
+      _chunkJ655X6YRcjs.RpcErrorCodes.configError,
+      "The iframe does not have a product window"
+    );
+  }
+  const contentWindow = iframe.contentWindow;
+  const msgHandler = async (event) => {
+    if (!event.origin) {
+      return;
+    }
+    if (new URL(event.origin).origin.toLowerCase() !== new URL(nexusWalletUrl).origin.toLowerCase()) {
+      return;
+    }
+    if ("iframeLifecycle" in event.data) {
+      await iframeLifecycleManager.handleEvent(event.data);
+      return;
+    }
+    if ("clientLifecycle" in event.data) {
+      console.error(
+        "Client lifecycle event received on the client side, dismissing it"
+      );
+      return;
+    }
+    const channel = event.data.id;
+    const resolver = channelManager.getRpcResolver(channel);
+    if (!resolver) {
+      return;
+    }
+    await resolver(event.data);
+  };
+  window.addEventListener("message", msgHandler);
+  const sendEvent = (message) => {
+    contentWindow.postMessage(message, {
+      targetOrigin: nexusWalletUrl
+    });
+  };
+  const cleanup = () => {
+    window.removeEventListener("message", msgHandler);
+  };
+  return {
+    sendEvent,
+    cleanup
+  };
+}
+
+// src/core/clients/createIFrameNexusClient.ts
+function createIFrameNexusClient({
+  config,
+  iframe
+}) {
+  const channelManager = createIFrameChannelManager();
+  const lifecycleManager = createIFrameLifecycleManager({ iframe });
+  const messageHandler = createIFrameMessageHandler({
+    nexusWalletUrl: config.walletUrl,
+    iframe,
+    channelManager,
+    iframeLifecycleManager: lifecycleManager
+  });
+  const request = async (args) => {
+    const isConnected = await lifecycleManager.isConnected;
+    if (!isConnected) {
+      throw new (0, _chunkJ655X6YRcjs.FrakRpcError)(
+        _chunkJ655X6YRcjs.RpcErrorCodes.clientNotConnected,
+        "The iframe provider isn't connected yet"
+      );
+    }
+    const result = new (0, _chunkJ655X6YRcjs.Deferred)();
+    const channelId = channelManager.createChannel(async (message) => {
+      const decompressed = await _chunkJ655X6YRcjs.decompressDataAndCheckHash.call(void 0, message.data);
+      if (decompressed.error) {
+        result.reject(
+          new (0, _chunkJ655X6YRcjs.FrakRpcError)(
+            decompressed.error.code,
+            decompressed.error.message,
+            _optionalChain([decompressed, 'access', _ => _.error, 'optionalAccess', _2 => _2.data])
+          )
+        );
+      } else {
+        result.resolve(decompressed.result);
+      }
+      channelManager.removeChannel(channelId);
+    });
+    const compressedMessage = await _chunkJ655X6YRcjs.hashAndCompressData.call(void 0, args);
+    messageHandler.sendEvent({
+      id: channelId,
+      topic: args.method,
+      data: compressedMessage
+    });
+    return result.promise;
+  };
+  const listenerRequest = async (args, callback) => {
+    const isConnected = await lifecycleManager.isConnected;
+    if (!isConnected) {
+      throw new (0, _chunkJ655X6YRcjs.FrakRpcError)(
+        _chunkJ655X6YRcjs.RpcErrorCodes.clientNotConnected,
+        "The iframe provider isn't connected yet"
+      );
+    }
+    const channelId = channelManager.createChannel(async (message) => {
+      const decompressed = await _chunkJ655X6YRcjs.decompressDataAndCheckHash.call(void 0, message.data);
+      if (decompressed.result) {
+        callback(decompressed.result);
+      } else {
+        throw new (0, _chunkJ655X6YRcjs.InternalError)("No valid result in the response");
+      }
+    });
+    const compressedMessage = await _chunkJ655X6YRcjs.hashAndCompressData.call(void 0, args);
+    messageHandler.sendEvent({
+      id: channelId,
+      topic: args.method,
+      data: compressedMessage
+    });
+  };
+  const destroy = async () => {
+    channelManager.destroy();
+    messageHandler.cleanup();
+    iframe.remove();
+  };
+  const waitForSetup = postConnectionSetup({
+    config,
+    messageHandler,
+    lifecycleManager
+  });
+  return {
+    config,
+    waitForConnection: lifecycleManager.isConnected,
+    waitForSetup,
+    request,
+    listenerRequest,
+    destroy
+  };
+}
+async function postConnectionSetup({
+  config,
+  messageHandler,
+  lifecycleManager
+}) {
+  await lifecycleManager.isConnected;
+  const pushCss = async () => {
+    const cssLink = config.metadata.css;
+    if (!cssLink) return;
+    messageHandler.sendEvent({
+      clientLifecycle: "modal-css",
+      data: { cssLink }
+    });
+  };
+  const pushBackup = async () => {
+    if (typeof window === "undefined") return;
+    const backup = window.localStorage.getItem(BACKUP_KEY);
+    if (!backup) return;
+    messageHandler.sendEvent({
+      clientLifecycle: "restore-backup",
+      data: { backup }
+    });
+  };
+  await Promise.all([pushCss(), pushBackup()]);
+}
+
+
+
+exports.createIFrameNexusClient = createIFrameNexusClient;

package/dist/chunk-FO2GFD5C.cjs

@@ -0,0 +1,210 @@
+"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 _chunkJ655X6YRcjs = require('./chunk-J655X6YR.cjs');
+
+
+var _chunkA3XYA7S7cjs = require('./chunk-A3XYA7S7.cjs');
+
+// src/core/actions/watchWalletStatus.ts
+function watchWalletStatus(client, callback) {
+  return client.listenerRequest(
+    {
+      method: "frak_listenToWalletStatus"
+    },
+    callback
+  );
+}
+
+// src/core/utils/computeProductId.ts
+var _viem = require('viem');
+function computeProductId({ domain }) {
+  return _viem.keccak256.call(void 0, _viem.toHex.call(void 0, domain));
+}
+
+// src/core/actions/sendInteraction.ts
+async function sendInteraction(client, { productId, interaction, validation }) {
+  const pId = _nullishCoalesce(productId, () => ( computeProductId(client.config)));
+  return await client.request({
+    method: "frak_sendInteraction",
+    params: [pId, interaction, validation]
+  });
+}
+
+// src/core/actions/displayModal.ts
+async function displayModal(client, { steps, metadata }) {
+  return await client.request({
+    method: "frak_displayModal",
+    params: [steps, client.config.metadata.name, metadata]
+  });
+}
+
+// src/core/actions/openSso.ts
+async function openSso(client, args) {
+  const { metadata } = client.config;
+  await client.request({
+    method: "frak_sso",
+    params: [args, metadata.name, metadata.css]
+  });
+}
+
+// src/core/actions/wrapper/siweAuthenticate.ts
+var _siwe = require('viem/siwe');
+async function siweAuthenticate(client, { siwe, metadata }) {
+  const realStatement = _nullishCoalesce(_optionalChain([siwe, 'optionalAccess', _ => _.statement]), () => ( `I confirm that I want to use my Frak wallet on: ${client.config.metadata.name}`));
+  const builtSiwe = {
+    ...siwe,
+    statement: realStatement,
+    nonce: _nullishCoalesce(_optionalChain([siwe, 'optionalAccess', _2 => _2.nonce]), () => ( _siwe.generateSiweNonce.call(void 0, ))),
+    uri: _nullishCoalesce(_optionalChain([siwe, 'optionalAccess', _3 => _3.uri]), () => ( `https://${client.config.domain}`)),
+    version: _nullishCoalesce(_optionalChain([siwe, 'optionalAccess', _4 => _4.version]), () => ( "1")),
+    domain: client.config.domain
+  };
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      siweAuthenticate: {
+        siwe: builtSiwe
+      }
+    }
+  });
+  return result.siweAuthenticate;
+}
+
+// src/core/actions/wrapper/sendTransaction.ts
+async function sendTransaction(client, { tx, metadata }) {
+  const result = await displayModal(client, {
+    metadata,
+    steps: {
+      login: {},
+      sendTransaction: { tx }
+    }
+  });
+  return result.sendTransaction;
+}
+
+// src/core/actions/wrapper/walletStatus.ts
+async function walletStatus(client, callback) {
+  const firstResult = new (0, _chunkJ655X6YRcjs.Deferred)();
+  let hasResolved = false;
+  await watchWalletStatus(client, (status) => {
+    _optionalChain([callback, 'optionalCall', _5 => _5(status)]);
+    if (!hasResolved) {
+      firstResult.resolve(status);
+      hasResolved = true;
+    }
+  });
+  return firstResult.promise;
+}
+
+// src/core/actions/referral/processReferral.ts
+
+async function processReferral(client, {
+  walletStatus: walletStatus2,
+  frakContext,
+  modalConfig,
+  productId
+}) {
+  try {
+    let currentWallet = _optionalChain([walletStatus2, 'optionalAccess', _6 => _6.wallet]);
+    if (!_optionalChain([frakContext, 'optionalAccess', _7 => _7.r])) {
+      if (currentWallet) {
+        await _chunkJ655X6YRcjs.FrakContextManager.replaceUrl({
+          url: _optionalChain([window, 'access', _8 => _8.location, 'optionalAccess', _9 => _9.href]),
+          context: { r: currentWallet }
+        });
+      }
+      return "no-referrer";
+    }
+    if (!currentWallet) {
+      currentWallet = await ensureWalletConnected(client, {
+        modalConfig,
+        walletStatus: walletStatus2
+      });
+    }
+    if (currentWallet && _viem.isAddressEqual.call(void 0, frakContext.r, currentWallet)) {
+      return "self-referral";
+    }
+    if (!_optionalChain([walletStatus2, 'optionalAccess', _10 => _10.interactionSession])) {
+      currentWallet = await ensureWalletConnected(client, {
+        modalConfig,
+        walletStatus: walletStatus2
+      });
+    }
+    if (currentWallet) {
+      await _chunkJ655X6YRcjs.FrakContextManager.replaceUrl({
+        url: _optionalChain([window, 'access', _11 => _11.location, 'optionalAccess', _12 => _12.href]),
+        context: { r: currentWallet }
+      });
+    }
+    const interaction = _chunkA3XYA7S7cjs.ReferralInteractionEncoder.referred({
+      referrer: frakContext.r
+    });
+    await sendInteraction(client, { productId, interaction });
+    return "success";
+  } catch (error) {
+    return mapErrorToState(error);
+  }
+}
+async function ensureWalletConnected(client, {
+  modalConfig,
+  walletStatus: walletStatus2
+}) {
+  if (!_optionalChain([walletStatus2, 'optionalAccess', _13 => _13.interactionSession])) {
+    if (!modalConfig) {
+      return void 0;
+    }
+    const result = await displayModal(client, modalConfig);
+    return _nullishCoalesce(_optionalChain([result, 'optionalAccess', _14 => _14.login, 'optionalAccess', _15 => _15.wallet]), () => ( void 0));
+  }
+  return _nullishCoalesce(walletStatus2.wallet, () => ( void 0));
+}
+function mapErrorToState(error) {
+  if (error instanceof _chunkJ655X6YRcjs.FrakRpcError) {
+    switch (error.code) {
+      case _chunkJ655X6YRcjs.RpcErrorCodes.walletNotConnected:
+        return "no-wallet";
+      case _chunkJ655X6YRcjs.RpcErrorCodes.serverErrorForInteractionDelegation:
+        return "no-session";
+      default:
+        return "error";
+    }
+  }
+  return "error";
+}
+
+// src/core/actions/referral/referralInteraction.ts
+async function referralInteraction(client, {
+  productId,
+  modalConfig
+} = {}) {
+  const frakContext = await _chunkJ655X6YRcjs.FrakContextManager.parse({
+    url: window.location.href
+  });
+  const currentWalletStatus = await walletStatus(client);
+  try {
+    return await processReferral(client, {
+      walletStatus: currentWalletStatus,
+      frakContext,
+      modalConfig,
+      productId
+    });
+  } catch (error) {
+    return error;
+  }
+}
+
+
+
+
+
+
+
+
+
+
+
+exports.watchWalletStatus = watchWalletStatus; exports.sendInteraction = sendInteraction; exports.displayModal = displayModal; exports.openSso = openSso; exports.siweAuthenticate = siweAuthenticate; exports.sendTransaction = sendTransaction; exports.walletStatus = walletStatus; exports.processReferral = processReferral; exports.referralInteraction = referralInteraction;