@xoocity/wallet-sdk 1.0.0

package/dist/XooWallet.d.ts

@@ -0,0 +1,54 @@
+/**
+ * XooWallet 核心类
+ * 管理 FAB 按钮、iframe、postMessage 通信和事件
+ */
+import type { XooWalletConfig, XooWalletEvents, UserInfo, PayOptions } from './types';
+type EventKey = keyof XooWalletEvents;
+export declare class XooWallet {
+    private config;
+    private iframe;
+    private fab;
+    private eventListeners;
+    private _isOpen;
+    private _isLoggedIn;
+    private _user;
+    private _ready;
+    private constructor();
+    /**
+     * 初始化 SDK（静态工厂方法）
+     */
+    static init(config: XooWalletConfig): XooWallet;
+    /** 打开钱包界面 */
+    open(): void;
+    /** 关闭/收起钱包 */
+    close(): void;
+    /** 切换开关 */
+    toggle(): void;
+    /** 打开登录界面 */
+    login(): void;
+    /** 登出 */
+    logout(): void;
+    /** 发起支付 */
+    pay(options: PayOptions): void;
+    /** 钱包是否已打开 */
+    isOpen(): boolean;
+    /** 用户是否已登录 */
+    isLoggedIn(): boolean;
+    /** 获取当前用户信息 */
+    getUser(): UserInfo | null;
+    /** iframe 是否已就绪 */
+    isReady(): boolean;
+    /** 显示悬浮按钮 */
+    show(): void;
+    /** 隐藏悬浮按钮 */
+    hide(): void;
+    /** 注册事件监听 */
+    on<K extends EventKey>(event: K, handler: XooWalletEvents[K]): void;
+    /** 移除事件监听 */
+    off<K extends EventKey>(event: K, handler: XooWalletEvents[K]): void;
+    /** 销毁 SDK 实例，移除所有 DOM 元素 */
+    destroy(): void;
+    private emit;
+    private handleIframeMessage;
+}
+export {};

package/dist/fab-button.d.ts

@@ -0,0 +1,23 @@
+/**
+ * FAB 悬浮按钮
+ * 纯 DOM 操作，不依赖 React
+ */
+export type FabPosition = 'bottom-right' | 'bottom-left';
+export declare class FabButton {
+    private button;
+    private isOpen;
+    private position;
+    private onClick;
+    constructor(position: FabPosition, onClick: () => void);
+    /** 创建并插入 FAB 按钮 */
+    create(): void;
+    /** 更新按钮图标 */
+    setOpen(open: boolean): void;
+    /** 显示按钮 */
+    show(): void;
+    /** 隐藏按钮 */
+    hide(): void;
+    /** 销毁按钮 */
+    destroy(): void;
+    private handleClick;
+}

package/dist/iframe-manager.d.ts

@@ -0,0 +1,40 @@
+/**
+ * iframe 管理器
+ * 创建容器（iframe + 关闭按钮）、遮罩层，处理显示/隐藏和 postMessage 通信
+ */
+import type { SdkCommand, IframeMessage } from './types';
+export type IframePosition = 'bottom-right' | 'bottom-left';
+export type PopupPosition = 'center' | 'bottom-right' | 'bottom-left';
+export declare class IframeManager {
+    private container;
+    private iframe;
+    private closeBtn;
+    private overlay;
+    private visible;
+    private popupPosition;
+    private walletOrigin;
+    private onMessage;
+    private onCloseClick;
+    /** 创建 iframe 元素 */
+    create(walletUrl: string, partnerKey: string, position: IframePosition, params?: {
+        lang?: string;
+        theme?: string;
+        popupPosition?: PopupPosition;
+    }): void;
+    /** 设置消息处理回调 */
+    setMessageHandler(handler: (msg: IframeMessage) => void): void;
+    /** 设置关闭按钮点击回调 */
+    setCloseClickHandler(handler: () => void): void;
+    /** 显示 iframe */
+    show(): void;
+    /** 隐藏 iframe */
+    hide(): void;
+    /** 是否可见 */
+    isVisible(): boolean;
+    /** 向 iframe 发送命令 */
+    postCommand(command: SdkCommand): void;
+    /** 销毁 */
+    destroy(): void;
+    private handleMessage;
+    private handleCloseClick;
+}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * XOO Wallet SDK
+ *
+ * npm 使用:
+ *   import { XooWallet } from '@xoo/wallet-sdk';
+ *   const wallet = XooWallet.init({ apiKey: 'pk_xxx' });
+ *
+ * script 标签使用:
+ *   <script src="https://wallet.xoo.com/sdk/xoowallet-sdk.umd.js"></script>
+ *   <script>
+ *     var wallet = XooWallet.init({ apiKey: 'pk_xxx' });
+ *   </script>
+ */
+export { XooWallet } from './XooWallet';
+export type { XooWalletConfig, XooWalletEvents, UserInfo, PayOptions, } from './types';

package/dist/styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 内联样式 - 避免外部 CSS 依赖和样式冲突
+ * 所有 class 使用 xoo-widget- 前缀
+ */
+export declare function injectStyles(zIndex: number): void;
+export declare function removeStyles(): void;

package/dist/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * XOO Wallet SDK 类型定义
+ */
+/** SDK 初始化配置 */
+export interface XooWalletConfig {
+    /** 合作方 API Key（必填） */
+    apiKey: string;
+    /** 钱包页面地址，默认 https://wallet.xoo.com */
+    walletUrl?: string;
+    /** FAB 按钮位置 */
+    position?: 'bottom-right' | 'bottom-left';
+    /** 弹窗位置，默认 center（居中），也可跟随 FAB 按钮 */
+    popupPosition?: 'center' | 'bottom-right' | 'bottom-left';
+    /** 自动显示 FAB 按钮，默认 true */
+    autoShow?: boolean;
+    /** 主题 */
+    theme?: 'dark' | 'light';
+    /** 语言 */
+    lang?: 'en' | 'zh' | 'ms';
+    /** z-index，默认 99999 */
+    zIndex?: number;
+}
+/** 用户信息 */
+export interface UserInfo {
+    userId: string;
+    address: string;
+    email?: string;
+    loginType?: string;
+}
+/** 支付参数 */
+export interface PayOptions {
+    /** 收款地址 */
+    to: string;
+    /** 金额 */
+    amount: string;
+    /** 代币符号（可选，默认原生代币） */
+    token?: string;
+}
+/** 事件映射 */
+export interface XooWalletEvents {
+    ready: () => void;
+    'auth:success': (user: UserInfo) => void;
+    'auth:logout': () => void;
+    'tx:success': (data: {
+        txHash: string;
+    }) => void;
+    'tx:failed': (data: {
+        error: string;
+    }) => void;
+}
+/** iframe → SDK 消息 */
+export type IframeMessage = {
+    type: 'xoo-ready';
+} | {
+    type: 'xoo-auth-success';
+    user: UserInfo;
+} | {
+    type: 'xoo-auth-logout';
+} | {
+    type: 'xoo-tx-success';
+    txHash: string;
+} | {
+    type: 'xoo-tx-failed';
+    error: string;
+} | {
+    type: 'xoo-resize';
+    height: number;
+} | {
+    type: 'xoo-close';
+};
+/** SDK → iframe 命令 */
+export type SdkCommand = {
+    type: 'xoo-cmd-open';
+} | {
+    type: 'xoo-cmd-close';
+} | {
+    type: 'xoo-cmd-login';
+} | {
+    type: 'xoo-cmd-logout';
+} | {
+    type: 'xoo-cmd-pay';
+    to: string;
+    amount: string;
+    token?: string;
+};

package/dist/xoowallet-sdk.es.js

@@ -0,0 +1,528 @@
+const CLOSE_SVG = `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>`;
+class IframeManager {
+  constructor() {
+    this.container = null;
+    this.iframe = null;
+    this.closeBtn = null;
+    this.overlay = null;
+    this.visible = false;
+    this.popupPosition = "center";
+    this.walletOrigin = "";
+    this.onMessage = null;
+    this.onCloseClick = null;
+    this.handleMessage = (event) => {
+      var _a;
+      if (event.origin !== this.walletOrigin) return;
+      const data = event.data;
+      if (!data || typeof data.type !== "string" || !data.type.startsWith("xoo-")) return;
+      if (data.type.startsWith("xoo-cmd-")) return;
+      (_a = this.onMessage) == null ? void 0 : _a.call(this, data);
+    };
+    this.handleCloseClick = () => {
+      var _a;
+      (_a = this.onCloseClick) == null ? void 0 : _a.call(this);
+    };
+  }
+  /** 创建 iframe 元素 */
+  create(walletUrl, partnerKey, position, params) {
+    if (this.container) return;
+    this.popupPosition = (params == null ? void 0 : params.popupPosition) || "center";
+    const url = new URL(walletUrl);
+    this.walletOrigin = url.origin;
+    url.searchParams.set("embed", "true");
+    url.searchParams.set("partnerKey", partnerKey);
+    if (params == null ? void 0 : params.lang) url.searchParams.set("lang", params.lang);
+    if (params == null ? void 0 : params.theme) url.searchParams.set("theme", params.theme);
+    if (this.popupPosition === "center") {
+      this.overlay = document.createElement("div");
+      this.overlay.className = "xoo-widget-overlay xoo-widget-overlay--hidden";
+      document.body.appendChild(this.overlay);
+    }
+    const posClass = this.popupPosition === "center" ? "center" : position;
+    this.container = document.createElement("div");
+    this.container.className = `xoo-widget-container xoo-widget-container--${posClass} xoo-widget-container--hidden`;
+    this.iframe = document.createElement("iframe");
+    this.iframe.src = url.toString();
+    this.iframe.className = "xoo-widget-iframe";
+    this.iframe.setAttribute(
+      "sandbox",
+      "allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox"
+    );
+    this.iframe.setAttribute("allow", "clipboard-write");
+    this.iframe.setAttribute("title", "XOO Wallet");
+    this.container.appendChild(this.iframe);
+    this.closeBtn = document.createElement("button");
+    this.closeBtn.className = "xoo-widget-close";
+    this.closeBtn.innerHTML = CLOSE_SVG;
+    this.closeBtn.setAttribute("aria-label", "Close");
+    this.closeBtn.addEventListener("click", this.handleCloseClick);
+    this.container.appendChild(this.closeBtn);
+    document.body.appendChild(this.container);
+    window.addEventListener("message", this.handleMessage);
+  }
+  /** 设置消息处理回调 */
+  setMessageHandler(handler) {
+    this.onMessage = handler;
+  }
+  /** 设置关闭按钮点击回调 */
+  setCloseClickHandler(handler) {
+    this.onCloseClick = handler;
+  }
+  /** 显示 iframe */
+  show() {
+    if (!this.container) return;
+    this.visible = true;
+    this.container.classList.remove("xoo-widget-container--hidden");
+    this.container.classList.add("xoo-widget-container--visible");
+    if (this.overlay) {
+      this.overlay.classList.remove("xoo-widget-overlay--hidden");
+      this.overlay.classList.add("xoo-widget-overlay--visible");
+    }
+  }
+  /** 隐藏 iframe */
+  hide() {
+    if (!this.container) return;
+    this.visible = false;
+    this.container.classList.remove("xoo-widget-container--visible");
+    this.container.classList.add("xoo-widget-container--hidden");
+    if (this.overlay) {
+      this.overlay.classList.remove("xoo-widget-overlay--visible");
+      this.overlay.classList.add("xoo-widget-overlay--hidden");
+    }
+  }
+  /** 是否可见 */
+  isVisible() {
+    return this.visible;
+  }
+  /** 向 iframe 发送命令 */
+  postCommand(command) {
+    var _a;
+    if (!((_a = this.iframe) == null ? void 0 : _a.contentWindow)) return;
+    this.iframe.contentWindow.postMessage(command, this.walletOrigin);
+  }
+  /** 销毁 */
+  destroy() {
+    window.removeEventListener("message", this.handleMessage);
+    if (this.closeBtn) {
+      this.closeBtn.removeEventListener("click", this.handleCloseClick);
+    }
+    if (this.overlay) {
+      this.overlay.remove();
+      this.overlay = null;
+    }
+    if (this.container) {
+      this.container.remove();
+      this.container = null;
+    }
+    this.iframe = null;
+    this.closeBtn = null;
+    this.onMessage = null;
+    this.onCloseClick = null;
+    this.visible = false;
+  }
+}
+const WALLET_ICON = `<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M21 7H3a1 1 0 0 0-1 1v11a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V8a1 1 0 0 0-1-1zm-1 12H4V9h16v10zm-2-5a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0zM20 3H4a2 2 0 0 0-2 2v1h20V5a2 2 0 0 0-2-2z"/></svg>`;
+const CLOSE_ICON = `<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M18.3 5.71a1 1 0 0 0-1.42 0L12 10.59 7.12 5.71a1 1 0 0 0-1.42 1.42L10.59 12l-4.88 4.88a1 1 0 1 0 1.42 1.42L12 13.41l4.88 4.88a1 1 0 0 0 1.42-1.42L13.41 12l4.88-4.88a1 1 0 0 0 0-1.41z"/></svg>`;
+class FabButton {
+  constructor(position, onClick) {
+    this.button = null;
+    this.isOpen = false;
+    this.handleClick = () => {
+      this.onClick();
+    };
+    this.position = position;
+    this.onClick = onClick;
+  }
+  /** 创建并插入 FAB 按钮 */
+  create() {
+    if (this.button) return;
+    this.button = document.createElement("button");
+    this.button.className = `xoo-widget-fab xoo-widget-fab--${this.position}`;
+    this.button.innerHTML = WALLET_ICON;
+    this.button.setAttribute("aria-label", "Open XOO Wallet");
+    this.button.addEventListener("click", this.handleClick);
+    document.body.appendChild(this.button);
+  }
+  /** 更新按钮图标 */
+  setOpen(open) {
+    this.isOpen = open;
+    if (!this.button) return;
+    if (open) {
+      this.button.innerHTML = CLOSE_ICON;
+      this.button.classList.add("xoo-widget-fab--open");
+      this.button.setAttribute("aria-label", "Close XOO Wallet");
+    } else {
+      this.button.innerHTML = WALLET_ICON;
+      this.button.classList.remove("xoo-widget-fab--open");
+      this.button.setAttribute("aria-label", "Open XOO Wallet");
+    }
+  }
+  /** 显示按钮 */
+  show() {
+    if (this.button) this.button.style.display = "flex";
+  }
+  /** 隐藏按钮 */
+  hide() {
+    if (this.button) this.button.style.display = "none";
+  }
+  /** 销毁按钮 */
+  destroy() {
+    if (this.button) {
+      this.button.removeEventListener("click", this.handleClick);
+      this.button.remove();
+      this.button = null;
+    }
+  }
+}
+function injectStyles(zIndex) {
+  if (document.getElementById("xoo-widget-styles")) return;
+  const style = document.createElement("style");
+  style.id = "xoo-widget-styles";
+  style.textContent = `
+    .xoo-widget-fab {
+      position: fixed;
+      width: 56px;
+      height: 56px;
+      border-radius: 50%;
+      border: none;
+      cursor: pointer;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3);
+      transition: transform 0.2s ease, box-shadow 0.2s ease;
+      z-index: ${zIndex + 1};
+      background: linear-gradient(135deg, #3b82f6, #1d4ed8);
+      padding: 0;
+      outline: none;
+    }
+    .xoo-widget-fab:hover {
+      transform: scale(1.05);
+      box-shadow: 0 6px 20px rgba(0, 0, 0, 0.4);
+    }
+    .xoo-widget-fab:active {
+      transform: scale(0.95);
+    }
+    .xoo-widget-fab svg {
+      width: 28px;
+      height: 28px;
+      fill: white;
+      transition: transform 0.3s ease;
+    }
+    .xoo-widget-fab.xoo-widget-fab--open svg {
+      transform: rotate(180deg);
+    }
+    .xoo-widget-fab--bottom-right {
+      bottom: 20px;
+      right: 20px;
+    }
+    .xoo-widget-fab--bottom-left {
+      bottom: 20px;
+      left: 20px;
+    }
+
+    /* ---- 弹窗容器（包裹 iframe + 关闭按钮） ---- */
+    .xoo-widget-container {
+      position: fixed;
+      width: 375px;
+      height: 640px;
+      max-height: 80vh;
+      border-radius: 16px;
+      box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);
+      z-index: ${zIndex};
+      overflow: hidden;
+      transition: opacity 0.2s ease, transform 0.2s ease;
+    }
+    .xoo-widget-container--center {
+      top: 0;
+      left: 0;
+      right: 0;
+      bottom: 0;
+      margin: auto;
+    }
+    .xoo-widget-container--bottom-right {
+      bottom: 88px;
+      right: 20px;
+    }
+    .xoo-widget-container--bottom-left {
+      bottom: 88px;
+      left: 20px;
+    }
+    .xoo-widget-container--hidden {
+      opacity: 0;
+      transform: translateY(10px) scale(0.95);
+      pointer-events: none;
+    }
+    .xoo-widget-container--visible {
+      opacity: 1;
+      transform: translateY(0) scale(1);
+    }
+
+    /* ---- iframe 填充容器 ---- */
+    .xoo-widget-iframe {
+      width: 100%;
+      height: 100%;
+      border: none;
+      background: #ffffff;
+    }
+
+    /* ---- 关闭按钮（容器内，iframe 上层） ---- */
+    .xoo-widget-close {
+      position: absolute;
+      top: 3px;
+      right: 3px;
+      width: 28px;
+      height: 28px;
+      border-radius: 50%;
+      border: none;
+      background: rgba(0, 0, 0, 0.06);
+      cursor: pointer;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 2;
+      color: #999;
+      padding: 0;
+      outline: none;
+      transition: background 0.15s ease, color 0.15s ease;
+    }
+    .xoo-widget-close:hover {
+      background: rgba(0, 0, 0, 0.12);
+      color: #333;
+    }
+    .xoo-widget-close svg {
+      width: 14px;
+      height: 14px;
+    }
+
+    /* ---- 遮罩层（仅视觉，不拦截点击） ---- */
+    .xoo-widget-overlay {
+      position: fixed;
+      top: 0;
+      left: 0;
+      width: 100%;
+      height: 100%;
+      background: rgba(0, 0, 0, 0.4);
+      z-index: ${zIndex - 1};
+      transition: opacity 0.2s ease;
+    }
+    .xoo-widget-overlay--hidden {
+      opacity: 0;
+      pointer-events: none;
+    }
+    .xoo-widget-overlay--visible {
+      opacity: 1;
+      pointer-events: none;
+    }
+
+    @media (max-width: 420px) {
+      .xoo-widget-container {
+        width: calc(100vw - 16px);
+        height: calc(100vh - 100px);
+        max-height: none;
+        left: 8px !important;
+        right: 8px !important;
+        border-radius: 12px;
+      }
+      .xoo-widget-container--center {
+        top: 0;
+        bottom: 0;
+        margin: auto;
+      }
+    }
+  `;
+  document.head.appendChild(style);
+}
+function removeStyles() {
+  const style = document.getElementById("xoo-widget-styles");
+  if (style) style.remove();
+}
+const DEFAULT_WALLET_URL = "https://web.xoowallet.com";
+const DEFAULT_Z_INDEX = 99999;
+class XooWallet {
+  constructor(config) {
+    this.eventListeners = /* @__PURE__ */ new Map();
+    this._isOpen = false;
+    this._isLoggedIn = false;
+    this._user = null;
+    this._ready = false;
+    this.config = {
+      apiKey: config.apiKey,
+      walletUrl: config.walletUrl || DEFAULT_WALLET_URL,
+      position: config.position || "bottom-right",
+      popupPosition: config.popupPosition || "center",
+      autoShow: config.autoShow !== false,
+      zIndex: config.zIndex || DEFAULT_Z_INDEX,
+      theme: config.theme,
+      lang: config.lang
+    };
+    injectStyles(this.config.zIndex);
+    this.fab = new FabButton(this.config.position, () => this.toggle());
+    this.fab.create();
+    if (!this.config.autoShow) {
+      this.fab.hide();
+    }
+    this.iframe = new IframeManager();
+    this.iframe.setMessageHandler((msg) => this.handleIframeMessage(msg));
+    this.iframe.setCloseClickHandler(() => this.close());
+    this.iframe.create(this.config.walletUrl, this.config.apiKey, this.config.position, {
+      lang: this.config.lang,
+      theme: this.config.theme,
+      popupPosition: this.config.popupPosition
+    });
+  }
+  /**
+   * 初始化 SDK（静态工厂方法）
+   */
+  static init(config) {
+    if (!config.apiKey) {
+      throw new Error("[XooWallet] apiKey is required");
+    }
+    return new XooWallet(config);
+  }
+  // ==================== 控制方法 ====================
+  /** 打开钱包界面 */
+  open() {
+    if (this._isOpen) return;
+    this._isOpen = true;
+    this.iframe.show();
+    this.fab.setOpen(true);
+    this.iframe.postCommand({ type: "xoo-cmd-open" });
+  }
+  /** 关闭/收起钱包 */
+  close() {
+    if (!this._isOpen) return;
+    this._isOpen = false;
+    this.iframe.hide();
+    this.fab.setOpen(false);
+    this.iframe.postCommand({ type: "xoo-cmd-close" });
+  }
+  /** 切换开关 */
+  toggle() {
+    if (this._isOpen) {
+      this.close();
+    } else {
+      this.open();
+    }
+  }
+  /** 打开登录界面 */
+  login() {
+    this.open();
+    this.iframe.postCommand({ type: "xoo-cmd-login" });
+  }
+  /** 登出 */
+  logout() {
+    this.iframe.postCommand({ type: "xoo-cmd-logout" });
+  }
+  /** 发起支付 */
+  pay(options) {
+    this.open();
+    this.iframe.postCommand({
+      type: "xoo-cmd-pay",
+      to: options.to,
+      amount: options.amount,
+      token: options.token
+    });
+  }
+  // ==================== 状态查询 ====================
+  /** 钱包是否已打开 */
+  isOpen() {
+    return this._isOpen;
+  }
+  /** 用户是否已登录 */
+  isLoggedIn() {
+    return this._isLoggedIn;
+  }
+  /** 获取当前用户信息 */
+  getUser() {
+    return this._user;
+  }
+  /** iframe 是否已就绪 */
+  isReady() {
+    return this._ready;
+  }
+  // ==================== FAB 按钮控制 ====================
+  /** 显示悬浮按钮 */
+  show() {
+    this.fab.show();
+  }
+  /** 隐藏悬浮按钮 */
+  hide() {
+    this.fab.hide();
+    if (this._isOpen) this.close();
+  }
+  // ==================== 事件系统 ====================
+  /** 注册事件监听 */
+  on(event, handler) {
+    if (!this.eventListeners.has(event)) {
+      this.eventListeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.eventListeners.get(event).add(handler);
+  }
+  /** 移除事件监听 */
+  off(event, handler) {
+    var _a;
+    (_a = this.eventListeners.get(event)) == null ? void 0 : _a.delete(handler);
+  }
+  // ==================== 销毁 ====================
+  /** 销毁 SDK 实例，移除所有 DOM 元素 */
+  destroy() {
+    this.iframe.destroy();
+    this.fab.destroy();
+    removeStyles();
+    this.eventListeners.clear();
+    this._isOpen = false;
+    this._isLoggedIn = false;
+    this._user = null;
+    this._ready = false;
+  }
+  // ==================== 内部方法 ====================
+  emit(event, ...args) {
+    const handlers = this.eventListeners.get(event);
+    if (!handlers) return;
+    for (const handler of handlers) {
+      try {
+        handler(...args);
+      } catch (err) {
+        console.error(`[XooWallet] Event handler error (${event}):`, err);
+      }
+    }
+  }
+  handleIframeMessage(msg) {
+    switch (msg.type) {
+      case "xoo-ready":
+        this._ready = true;
+        this.emit("ready");
+        break;
+      case "xoo-auth-success":
+        this._isLoggedIn = true;
+        this._user = msg.user;
+        this.emit("auth:success", msg.user);
+        break;
+      case "xoo-auth-logout":
+        this._isLoggedIn = false;
+        this._user = null;
+        this.emit("auth:logout");
+        break;
+      case "xoo-tx-success":
+        this.emit("tx:success", { txHash: msg.txHash });
+        break;
+      case "xoo-tx-failed":
+        this.emit("tx:failed", { error: msg.error });
+        break;
+      case "xoo-close":
+        this._isOpen = false;
+        this.iframe.hide();
+        this.fab.setOpen(false);
+        break;
+    }
+  }
+}
+(function() {
+  if (typeof globalThis !== "undefined" && globalThis.XooWallet && globalThis.XooWallet.XooWallet) {
+    globalThis.XooWallet = globalThis.XooWallet.XooWallet;
+  }
+})();
+export {
+  XooWallet
+};

package/dist/xoowallet-sdk.umd.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).XooWallet={})}(this,function(t){"use strict";class e{constructor(){this.container=null,this.iframe=null,this.closeBtn=null,this.overlay=null,this.visible=!1,this.popupPosition="center",this.walletOrigin="",this.onMessage=null,this.onCloseClick=null,this.handleMessage=t=>{var e;if(t.origin!==this.walletOrigin)return;const i=t.data;i&&"string"==typeof i.type&&i.type.startsWith("xoo-")&&(i.type.startsWith("xoo-cmd-")||null==(e=this.onMessage)||e.call(this,i))},this.handleCloseClick=()=>{var t;null==(t=this.onCloseClick)||t.call(this)}}create(t,e,i,n){if(this.container)return;this.popupPosition=(null==n?void 0:n.popupPosition)||"center";const o=new URL(t);this.walletOrigin=o.origin,o.searchParams.set("embed","true"),o.searchParams.set("partnerKey",e),(null==n?void 0:n.lang)&&o.searchParams.set("lang",n.lang),(null==n?void 0:n.theme)&&o.searchParams.set("theme",n.theme),"center"===this.popupPosition&&(this.overlay=document.createElement("div"),this.overlay.className="xoo-widget-overlay xoo-widget-overlay--hidden",document.body.appendChild(this.overlay));const s="center"===this.popupPosition?"center":i;this.container=document.createElement("div"),this.container.className=`xoo-widget-container xoo-widget-container--${s} xoo-widget-container--hidden`,this.iframe=document.createElement("iframe"),this.iframe.src=o.toString(),this.iframe.className="xoo-widget-iframe",this.iframe.setAttribute("sandbox","allow-scripts allow-same-origin allow-forms allow-popups allow-popups-to-escape-sandbox"),this.iframe.setAttribute("allow","clipboard-write"),this.iframe.setAttribute("title","XOO Wallet"),this.container.appendChild(this.iframe),this.closeBtn=document.createElement("button"),this.closeBtn.className="xoo-widget-close",this.closeBtn.innerHTML='<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><line x1="18" y1="6" x2="6" y2="18"/><line x1="6" y1="6" x2="18" y2="18"/></svg>',this.closeBtn.setAttribute("aria-label","Close"),this.closeBtn.addEventListener("click",this.handleCloseClick),this.container.appendChild(this.closeBtn),document.body.appendChild(this.container),window.addEventListener("message",this.handleMessage)}setMessageHandler(t){this.onMessage=t}setCloseClickHandler(t){this.onCloseClick=t}show(){this.container&&(this.visible=!0,this.container.classList.remove("xoo-widget-container--hidden"),this.container.classList.add("xoo-widget-container--visible"),this.overlay&&(this.overlay.classList.remove("xoo-widget-overlay--hidden"),this.overlay.classList.add("xoo-widget-overlay--visible")))}hide(){this.container&&(this.visible=!1,this.container.classList.remove("xoo-widget-container--visible"),this.container.classList.add("xoo-widget-container--hidden"),this.overlay&&(this.overlay.classList.remove("xoo-widget-overlay--visible"),this.overlay.classList.add("xoo-widget-overlay--hidden")))}isVisible(){return this.visible}postCommand(t){var e;(null==(e=this.iframe)?void 0:e.contentWindow)&&this.iframe.contentWindow.postMessage(t,this.walletOrigin)}destroy(){window.removeEventListener("message",this.handleMessage),this.closeBtn&&this.closeBtn.removeEventListener("click",this.handleCloseClick),this.overlay&&(this.overlay.remove(),this.overlay=null),this.container&&(this.container.remove(),this.container=null),this.iframe=null,this.closeBtn=null,this.onMessage=null,this.onCloseClick=null,this.visible=!1}}const i='<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M21 7H3a1 1 0 0 0-1 1v11a2 2 0 0 0 2 2h16a2 2 0 0 0 2-2V8a1 1 0 0 0-1-1zm-1 12H4V9h16v10zm-2-5a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0zM20 3H4a2 2 0 0 0-2 2v1h20V5a2 2 0 0 0-2-2z"/></svg>';class n{constructor(t,e){this.button=null,this.isOpen=!1,this.handleClick=()=>{this.onClick()},this.position=t,this.onClick=e}create(){this.button||(this.button=document.createElement("button"),this.button.className=`xoo-widget-fab xoo-widget-fab--${this.position}`,this.button.innerHTML=i,this.button.setAttribute("aria-label","Open XOO Wallet"),this.button.addEventListener("click",this.handleClick),document.body.appendChild(this.button))}setOpen(t){this.isOpen=t,this.button&&(t?(this.button.innerHTML='<svg viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M18.3 5.71a1 1 0 0 0-1.42 0L12 10.59 7.12 5.71a1 1 0 0 0-1.42 1.42L10.59 12l-4.88 4.88a1 1 0 1 0 1.42 1.42L12 13.41l4.88 4.88a1 1 0 0 0 1.42-1.42L13.41 12l4.88-4.88a1 1 0 0 0 0-1.41z"/></svg>',this.button.classList.add("xoo-widget-fab--open"),this.button.setAttribute("aria-label","Close XOO Wallet")):(this.button.innerHTML=i,this.button.classList.remove("xoo-widget-fab--open"),this.button.setAttribute("aria-label","Open XOO Wallet")))}show(){this.button&&(this.button.style.display="flex")}hide(){this.button&&(this.button.style.display="none")}destroy(){this.button&&(this.button.removeEventListener("click",this.handleClick),this.button.remove(),this.button=null)}}class o{constructor(t){this.eventListeners=new Map,this._isOpen=!1,this._isLoggedIn=!1,this._user=null,this._ready=!1,this.config={apiKey:t.apiKey,walletUrl:t.walletUrl||"https://web.xoowallet.com",position:t.position||"bottom-right",popupPosition:t.popupPosition||"center",autoShow:!1!==t.autoShow,zIndex:t.zIndex||99999,theme:t.theme,lang:t.lang},function(t){if(document.getElementById("xoo-widget-styles"))return;const e=document.createElement("style");e.id="xoo-widget-styles",e.textContent=`\n    .xoo-widget-fab {\n      position: fixed;\n      width: 56px;\n      height: 56px;\n      border-radius: 50%;\n      border: none;\n      cursor: pointer;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3);\n      transition: transform 0.2s ease, box-shadow 0.2s ease;\n      z-index: ${t+1};\n      background: linear-gradient(135deg, #3b82f6, #1d4ed8);\n      padding: 0;\n      outline: none;\n    }\n    .xoo-widget-fab:hover {\n      transform: scale(1.05);\n      box-shadow: 0 6px 20px rgba(0, 0, 0, 0.4);\n    }\n    .xoo-widget-fab:active {\n      transform: scale(0.95);\n    }\n    .xoo-widget-fab svg {\n      width: 28px;\n      height: 28px;\n      fill: white;\n      transition: transform 0.3s ease;\n    }\n    .xoo-widget-fab.xoo-widget-fab--open svg {\n      transform: rotate(180deg);\n    }\n    .xoo-widget-fab--bottom-right {\n      bottom: 20px;\n      right: 20px;\n    }\n    .xoo-widget-fab--bottom-left {\n      bottom: 20px;\n      left: 20px;\n    }\n\n    /* ---- 弹窗容器（包裹 iframe + 关闭按钮） ---- */\n    .xoo-widget-container {\n      position: fixed;\n      width: 375px;\n      height: 640px;\n      max-height: 80vh;\n      border-radius: 16px;\n      box-shadow: 0 8px 32px rgba(0, 0, 0, 0.3);\n      z-index: ${t};\n      overflow: hidden;\n      transition: opacity 0.2s ease, transform 0.2s ease;\n    }\n    .xoo-widget-container--center {\n      top: 0;\n      left: 0;\n      right: 0;\n      bottom: 0;\n      margin: auto;\n    }\n    .xoo-widget-container--bottom-right {\n      bottom: 88px;\n      right: 20px;\n    }\n    .xoo-widget-container--bottom-left {\n      bottom: 88px;\n      left: 20px;\n    }\n    .xoo-widget-container--hidden {\n      opacity: 0;\n      transform: translateY(10px) scale(0.95);\n      pointer-events: none;\n    }\n    .xoo-widget-container--visible {\n      opacity: 1;\n      transform: translateY(0) scale(1);\n    }\n\n    /* ---- iframe 填充容器 ---- */\n    .xoo-widget-iframe {\n      width: 100%;\n      height: 100%;\n      border: none;\n      background: #ffffff;\n    }\n\n    /* ---- 关闭按钮（容器内，iframe 上层） ---- */\n    .xoo-widget-close {\n      position: absolute;\n      top: 3px;\n      right: 3px;\n      width: 28px;\n      height: 28px;\n      border-radius: 50%;\n      border: none;\n      background: rgba(0, 0, 0, 0.06);\n      cursor: pointer;\n      display: flex;\n      align-items: center;\n      justify-content: center;\n      z-index: 2;\n      color: #999;\n      padding: 0;\n      outline: none;\n      transition: background 0.15s ease, color 0.15s ease;\n    }\n    .xoo-widget-close:hover {\n      background: rgba(0, 0, 0, 0.12);\n      color: #333;\n    }\n    .xoo-widget-close svg {\n      width: 14px;\n      height: 14px;\n    }\n\n    /* ---- 遮罩层（仅视觉，不拦截点击） ---- */\n    .xoo-widget-overlay {\n      position: fixed;\n      top: 0;\n      left: 0;\n      width: 100%;\n      height: 100%;\n      background: rgba(0, 0, 0, 0.4);\n      z-index: ${t-1};\n      transition: opacity 0.2s ease;\n    }\n    .xoo-widget-overlay--hidden {\n      opacity: 0;\n      pointer-events: none;\n    }\n    .xoo-widget-overlay--visible {\n      opacity: 1;\n      pointer-events: none;\n    }\n\n    @media (max-width: 420px) {\n      .xoo-widget-container {\n        width: calc(100vw - 16px);\n        height: calc(100vh - 100px);\n        max-height: none;\n        left: 8px !important;\n        right: 8px !important;\n        border-radius: 12px;\n      }\n      .xoo-widget-container--center {\n        top: 0;\n        bottom: 0;\n        margin: auto;\n      }\n    }\n  `,document.head.appendChild(e)}(this.config.zIndex),this.fab=new n(this.config.position,()=>this.toggle()),this.fab.create(),this.config.autoShow||this.fab.hide(),this.iframe=new e,this.iframe.setMessageHandler(t=>this.handleIframeMessage(t)),this.iframe.setCloseClickHandler(()=>this.close()),this.iframe.create(this.config.walletUrl,this.config.apiKey,this.config.position,{lang:this.config.lang,theme:this.config.theme,popupPosition:this.config.popupPosition})}static init(t){if(!t.apiKey)throw new Error("[XooWallet] apiKey is required");return new o(t)}open(){this._isOpen||(this._isOpen=!0,this.iframe.show(),this.fab.setOpen(!0),this.iframe.postCommand({type:"xoo-cmd-open"}))}close(){this._isOpen&&(this._isOpen=!1,this.iframe.hide(),this.fab.setOpen(!1),this.iframe.postCommand({type:"xoo-cmd-close"}))}toggle(){this._isOpen?this.close():this.open()}login(){this.open(),this.iframe.postCommand({type:"xoo-cmd-login"})}logout(){this.iframe.postCommand({type:"xoo-cmd-logout"})}pay(t){this.open(),this.iframe.postCommand({type:"xoo-cmd-pay",to:t.to,amount:t.amount,token:t.token})}isOpen(){return this._isOpen}isLoggedIn(){return this._isLoggedIn}getUser(){return this._user}isReady(){return this._ready}show(){this.fab.show()}hide(){this.fab.hide(),this._isOpen&&this.close()}on(t,e){this.eventListeners.has(t)||this.eventListeners.set(t,new Set),this.eventListeners.get(t).add(e)}off(t,e){var i;null==(i=this.eventListeners.get(t))||i.delete(e)}destroy(){this.iframe.destroy(),this.fab.destroy(),function(){const t=document.getElementById("xoo-widget-styles");t&&t.remove()}(),this.eventListeners.clear(),this._isOpen=!1,this._isLoggedIn=!1,this._user=null,this._ready=!1}emit(t,...e){const i=this.eventListeners.get(t);if(i)for(const o of i)try{o(...e)}catch(n){console.error(`[XooWallet] Event handler error (${t}):`,n)}}handleIframeMessage(t){switch(t.type){case"xoo-ready":this._ready=!0,this.emit("ready");break;case"xoo-auth-success":this._isLoggedIn=!0,this._user=t.user,this.emit("auth:success",t.user);break;case"xoo-auth-logout":this._isLoggedIn=!1,this._user=null,this.emit("auth:logout");break;case"xoo-tx-success":this.emit("tx:success",{txHash:t.txHash});break;case"xoo-tx-failed":this.emit("tx:failed",{error:t.error});break;case"xoo-close":this._isOpen=!1,this.iframe.hide(),this.fab.setOpen(!1)}}}t.XooWallet=o,Object.defineProperty(t,Symbol.toStringTag,{value:"Module"})}),"undefined"!=typeof globalThis&&globalThis.XooWallet&&globalThis.XooWallet.XooWallet&&(globalThis.XooWallet=globalThis.XooWallet.XooWallet);

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@xoocity/wallet-sdk",
+  "version": "1.0.0",
+  "description": "XOO Wallet embeddable SDK - add crypto wallet functionality to any website",
+  "type": "module",
+  "main": "./dist/xoowallet-sdk.umd.js",
+  "module": "./dist/xoowallet-sdk.es.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/xoowallet-sdk.es.js",
+      "require": "./dist/xoowallet-sdk.umd.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vite": "^6.0.0"
+  },
+  "keywords": [
+    "xoo",
+    "wallet",
+    "crypto",
+    "embed",
+    "widget",
+    "sdk"
+  ],
+  "license": "MIT"
+}