@asseteragmbh/wallet-connector 0.2.0 → 0.2.2

package/dist/index.cjs

@@ -4,6 +4,11 @@
 var PROTOCOL_VERSION = 1;
 var CONNECT_PATH = "/connect";
 var ONBOARD_PATH = "/onboard";
+var MANAGE_PATH = "/manage";
+var SIGN_IN_HINTS = ["assetera-marketplace"];
+function isSignInHint(value) {
+  return SIGN_IN_HINTS.includes(value);
+}
 var MESSAGE_PREFIX = "assetera-wallet:";
 var SUPPORTED_METHODS = [
   "eth_requestAccounts",
@@ -48,6 +53,42 @@ function isResponseMessage(value) {
 function isEventMessage(value) {
   return hasType(value, "event") && (value.event === "accountsChanged" || value.event === "chainChanged" || value.event === "disconnect");
 }
+var WALLET_PROTECTIONS = [
+  "unknown",
+  "add-factor",
+  "save-codes",
+  "create-codes",
+  "protected"
+];
+function isCount(value) {
+  return typeof value === "number" && Number.isInteger(value) && value >= 0;
+}
+function isSecurityMessage(value) {
+  if (!hasType(value, "security")) return false;
+  const data = value.data;
+  return isRecord(data) && typeof data.protection === "string" && WALLET_PROTECTIONS.includes(data.protection) && isCount(data.passkeys) && isCount(data.authenticatorApps);
+}
+var MAX_ACCOUNT_NAMES = 50;
+function hasControlCharacter(value) {
+  for (const character of value) {
+    const code = character.codePointAt(0) ?? 0;
+    if (code <= 31 || code >= 127 && code <= 159) return true;
+  }
+  return false;
+}
+function isAccountName(value) {
+  if (typeof value !== "string") return false;
+  if (hasControlCharacter(value)) return false;
+  const trimmed = value.trim();
+  return trimmed.length >= 1 && trimmed.length <= 64;
+}
+function isAccountsMessage(value) {
+  if (!hasType(value, "accounts")) return false;
+  const data = value.data;
+  return Array.isArray(data) && data.length <= MAX_ACCOUNT_NAMES && data.every(
+    (entry) => isRecord(entry) && typeof entry.address === "string" && EVM_ADDRESS_RE.test(entry.address) && isAccountName(entry.name)
+  );
+}
 function isRequestMessage(value) {
   return hasType(value, "request") && typeof value.id === "string" && typeof value.method === "string";
 }
@@ -65,10 +106,11 @@ function isOnboardCancelledMessage(value) {
 function isCaip2EvmChain(value) {
   return /^eip155:\d{1,32}$/.test(value);
 }
-function connectUrl(walletUrl, partnerOrigin) {
+function connectUrl(walletUrl, partnerOrigin, signIn) {
   const url = new URL(CONNECT_PATH, walletUrl);
   url.searchParams.set("origin", partnerOrigin);
   url.searchParams.set("v", String(PROTOCOL_VERSION));
+  if (signIn !== void 0) url.searchParams.set("signIn", signIn);
   return url.toString();
 }
 function onboardUrl(walletUrl, partnerOrigin, options) {
@@ -78,6 +120,15 @@ function onboardUrl(walletUrl, partnerOrigin, options) {
   url.searchParams.set("chain", options.chain);
   if (options.locale !== void 0) url.searchParams.set("lang", options.locale);
   if (options.add) url.searchParams.set("add", "1");
+  if (options.signIn !== void 0) url.searchParams.set("signIn", options.signIn);
+  return url.toString();
+}
+function manageUrl(walletUrl, partnerOrigin, options = {}) {
+  const url = new URL(MANAGE_PATH, walletUrl);
+  url.searchParams.set("origin", partnerOrigin);
+  url.searchParams.set("v", String(PROTOCOL_VERSION));
+  if (options.locale !== void 0) url.searchParams.set("lang", options.locale);
+  if (options.signIn !== void 0) url.searchParams.set("signIn", options.signIn);
   return url.toString();
 }
 
@@ -123,6 +174,8 @@ function createAsseteraWalletProvider(options) {
   let accounts = [];
   let chainIdHex = null;
   let walletDisconnected = false;
+  let lastSecurity;
+  let lastAccountNameList;
   const pending = /* @__PURE__ */ new Map();
   const listeners = /* @__PURE__ */ new Map();
   let closeTimer = null;
@@ -197,7 +250,7 @@ function createAsseteraWalletProvider(options) {
     }
     if (typeof window === "undefined") return null;
     const opened = window.open(
-      connectUrl(options.walletUrl, window.location.origin),
+      connectUrl(options.walletUrl, window.location.origin, options.signIn),
       POPUP_NAME,
       popupFeatures
     );
@@ -248,6 +301,21 @@ function createAsseteraWalletProvider(options) {
     walletDisconnected = true;
     emit("disconnect", new ProviderRpcError(message.data.code, message.data.message, message.data.data));
   }
+  function handleSecurityMessage(message) {
+    lastSecurity = {
+      protection: message.data.protection,
+      passkeys: message.data.passkeys,
+      authenticatorApps: message.data.authenticatorApps
+    };
+    emit("assetera_security", lastSecurity);
+  }
+  function copyAccountNames2(accounts2) {
+    return accounts2.map((account) => ({ address: account.address, name: account.name }));
+  }
+  function handleAccountsMessage(message) {
+    lastAccountNameList = copyAccountNames2(message.data);
+    emit("assetera_accounts", copyAccountNames2(lastAccountNameList));
+  }
   function onWindowMessage(event) {
     if (event.origin !== walletOrigin) return;
     if (popup === null || event.source !== popup) return;
@@ -260,6 +328,14 @@ function createAsseteraWalletProvider(options) {
       handleResponse(data);
       return;
     }
+    if (isSecurityMessage(data)) {
+      handleSecurityMessage(data);
+      return;
+    }
+    if (isAccountsMessage(data)) {
+      handleAccountsMessage(data);
+      return;
+    }
     if (isEventMessage(data)) handleEventMessage(data);
   }
   if (typeof window !== "undefined") window.addEventListener("message", onWindowMessage);
@@ -332,7 +408,26 @@ function createAsseteraWalletProvider(options) {
   function removeListener(event, listener) {
     removeEventListener(event, listener);
   }
-  return { request, on, removeListener, disconnect };
+  function lastSecurityStatus() {
+    return lastSecurity;
+  }
+  function lastAccountNames() {
+    return lastAccountNameList === void 0 ? void 0 : copyAccountNames2(lastAccountNameList);
+  }
+  return { request, on, removeListener, disconnect, lastSecurityStatus, lastAccountNames };
+}
+
+// src/popup.ts
+var POPUP_WIDTH = 440;
+var POPUP_HEIGHT = 760;
+function defaultPopupFeatures(win) {
+  const screenX = Number.isFinite(win.screenX) ? win.screenX : 0;
+  const screenY = Number.isFinite(win.screenY) ? win.screenY : 0;
+  const outerWidth = Number.isFinite(win.outerWidth) ? win.outerWidth : POPUP_WIDTH;
+  const outerHeight = Number.isFinite(win.outerHeight) ? win.outerHeight : POPUP_HEIGHT;
+  const left = Math.max(0, Math.round(screenX + (outerWidth - POPUP_WIDTH) / 2));
+  const top = Math.max(0, Math.round(screenY + (outerHeight - POPUP_HEIGHT) / 2));
+  return `popup,width=${POPUP_WIDTH},height=${POPUP_HEIGHT},left=${left},top=${top}`;
 }
 
 // src/onboarding.ts
@@ -345,8 +440,6 @@ var OnboardingError = class extends Error {
   }
 };
 var POPUP_NAME2 = "assetera-wallet-onboarding";
-var POPUP_WIDTH = 440;
-var POPUP_HEIGHT = 760;
 var CLOSE_POLL_MS2 = 500;
 var OVERLAY_Z_INDEX = 2147483e3;
 var DEFAULT_LABELS = {
@@ -356,15 +449,6 @@ var DEFAULT_LABELS = {
   cancel: "Cancel",
   blocked: "Your browser blocked the Assetera Wallet window. Allow pop-ups for this site and try again."
 };
-function defaultPopupFeatures(win) {
-  const screenX = Number.isFinite(win.screenX) ? win.screenX : 0;
-  const screenY = Number.isFinite(win.screenY) ? win.screenY : 0;
-  const outerWidth = Number.isFinite(win.outerWidth) ? win.outerWidth : POPUP_WIDTH;
-  const outerHeight = Number.isFinite(win.outerHeight) ? win.outerHeight : POPUP_HEIGHT;
-  const left = Math.max(0, Math.round(screenX + (outerWidth - POPUP_WIDTH) / 2));
-  const top = Math.max(0, Math.round(screenY + (outerHeight - POPUP_HEIGHT) / 2));
-  return `popup,width=${POPUP_WIDTH},height=${POPUP_HEIGHT},left=${left},top=${top}`;
-}
 function resolveLabels(options) {
   const overrides = typeof options.overlay === "object" && options.overlay !== null ? options.overlay : {};
   const partnerName = options.partnerName;
@@ -387,6 +471,9 @@ function cancelMessage(reason) {
   if (reason === "refused") return "The Assetera Wallet refused the onboarding.";
   return "The Assetera Wallet onboarding failed.";
 }
+function copyAccountNames(accounts) {
+  return accounts.map((account) => ({ address: account.address, name: account.name }));
+}
 function showOverlay(win, labels, handlers) {
   const doc = win.document;
   const root = doc.createElement("div");
@@ -487,7 +574,8 @@ function openAsseteraOnboarding(options) {
     onboardUrl(options.walletUrl, targetWindow.location.origin, {
       chain: options.chain,
       ...options.locale === void 0 ? {} : { locale: options.locale },
-      ...options.addWallet ? { add: true } : {}
+      ...options.addWallet ? { add: true } : {},
+      ...options.signIn === void 0 ? {} : { signIn: options.signIn }
     }),
     POPUP_NAME2,
     options.popupFeatures ?? defaultPopupFeatures(targetWindow)
@@ -554,6 +642,7 @@ function openAsseteraOnboarding(options) {
       });
     }
     let address;
+    let lastAccountNameList;
     function onMessage(event) {
       if (event.origin !== walletOrigin) return;
       if (event.source !== activePopup) return;
@@ -567,7 +656,8 @@ function openAsseteraOnboarding(options) {
             chain: data.chain,
             created: data.created ?? true,
             signMessage,
-            close
+            close,
+            lastAccounts: () => lastAccountNameList === void 0 ? void 0 : copyAccountNames(lastAccountNameList)
           });
           return;
         }
@@ -576,6 +666,11 @@ function openAsseteraOnboarding(options) {
         }
         return;
       }
+      if (isAccountsMessage(data)) {
+        lastAccountNameList = copyAccountNames(data.data);
+        options.onAccounts?.(copyAccountNames(lastAccountNameList));
+        return;
+      }
       if (isResponseMessage(data)) {
         const entry = pending.get(data.id);
         if (!entry) return;
@@ -614,16 +709,114 @@ function openAsseteraOnboarding(options) {
   });
 }
 
+// src/manage.ts
+var ManagerError = class extends Error {
+  code;
+  constructor(code, message) {
+    super(message);
+    this.name = "ManagerError";
+    this.code = code;
+  }
+};
+var POPUP_NAME3 = "assetera-wallet-manage";
+var CLOSE_POLL_MS3 = 500;
+function openAsseteraWalletManager(options) {
+  const requestedWindow = options.window ?? (typeof window === "undefined" ? void 0 : window);
+  if (!requestedWindow) {
+    throw new ManagerError("invalid_options", "The Assetera Wallet manager can only run in a browser.");
+  }
+  const targetWindow = requestedWindow;
+  let walletOrigin;
+  try {
+    walletOrigin = new URL(options.walletUrl).origin;
+  } catch {
+    throw new ManagerError("invalid_options", `"${options.walletUrl}" is not a valid wallet URL.`);
+  }
+  const popup = targetWindow.open(
+    manageUrl(options.walletUrl, targetWindow.location.origin, {
+      ...options.locale === void 0 ? {} : { locale: options.locale },
+      ...options.signIn === void 0 ? {} : { signIn: options.signIn }
+    }),
+    POPUP_NAME3,
+    options.popupFeatures ?? defaultPopupFeatures(targetWindow)
+  );
+  if (!popup) {
+    throw new ManagerError(
+      "popup_blocked",
+      "Your browser blocked the Assetera Wallet window. Allow pop-ups for this site and try again."
+    );
+  }
+  const activePopup = popup;
+  let finished = false;
+  let lastSecurity;
+  let lastAccounts;
+  let closeTimer = null;
+  let resolveClosed;
+  const closed = new Promise((resolve) => {
+    resolveClosed = resolve;
+  });
+  function cleanup() {
+    if (finished) return;
+    finished = true;
+    targetWindow.removeEventListener("message", onMessage);
+    if (closeTimer !== null) {
+      clearInterval(closeTimer);
+      closeTimer = null;
+    }
+    resolveClosed();
+  }
+  function close() {
+    cleanup();
+    if (!activePopup.closed) activePopup.close();
+  }
+  function copyAccountNames2(accounts) {
+    return accounts.map((account) => ({ address: account.address, name: account.name }));
+  }
+  function onMessage(event) {
+    if (event.origin !== walletOrigin) return;
+    if (event.source !== activePopup) return;
+    const data = event.data;
+    if (isSecurityMessage(data)) {
+      const status = {
+        protection: data.data.protection,
+        passkeys: data.data.passkeys,
+        authenticatorApps: data.data.authenticatorApps
+      };
+      lastSecurity = status;
+      options.onSecurity?.(status);
+      return;
+    }
+    if (isAccountsMessage(data)) {
+      lastAccounts = copyAccountNames2(data.data);
+      options.onAccounts?.(copyAccountNames2(lastAccounts));
+    }
+  }
+  targetWindow.addEventListener("message", onMessage);
+  closeTimer = setInterval(() => {
+    if (activePopup.closed) cleanup();
+  }, CLOSE_POLL_MS3);
+  return {
+    close,
+    closed,
+    lastSecurity: () => lastSecurity,
+    lastAccounts: () => lastAccounts === void 0 ? void 0 : copyAccountNames2(lastAccounts)
+  };
+}
+
 exports.CONNECT_PATH = CONNECT_PATH;
+exports.MANAGE_PATH = MANAGE_PATH;
 exports.MESSAGE_PREFIX = MESSAGE_PREFIX;
+exports.ManagerError = ManagerError;
 exports.ONBOARD_PATH = ONBOARD_PATH;
 exports.OnboardingError = OnboardingError;
 exports.PROTOCOL_VERSION = PROTOCOL_VERSION;
 exports.ProviderRpcError = ProviderRpcError;
 exports.RpcErrorCode = RpcErrorCode;
+exports.SIGN_IN_HINTS = SIGN_IN_HINTS;
 exports.SUPPORTED_METHODS = SUPPORTED_METHODS;
 exports.connectUrl = connectUrl;
 exports.createAsseteraWalletProvider = createAsseteraWalletProvider;
+exports.isAccountsMessage = isAccountsMessage;
 exports.isCaip2EvmChain = isCaip2EvmChain;
 exports.isDisconnectMessage = isDisconnectMessage;
 exports.isEventMessage = isEventMessage;
@@ -632,8 +825,12 @@ exports.isOnboardedMessage = isOnboardedMessage;
 exports.isReadyMessage = isReadyMessage;
 exports.isRequestMessage = isRequestMessage;
 exports.isResponseMessage = isResponseMessage;
+exports.isSecurityMessage = isSecurityMessage;
+exports.isSignInHint = isSignInHint;
 exports.isSupportedMethod = isSupportedMethod;
+exports.manageUrl = manageUrl;
 exports.onboardUrl = onboardUrl;
 exports.openAsseteraOnboarding = openAsseteraOnboarding;
+exports.openAsseteraWalletManager = openAsseteraWalletManager;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map