@seaverse/auth-sdk 0.2.6 → 0.3.0

package/dist/index.js

@@ -1192,12 +1192,17 @@ class SeaVerseBackendAPIClient {
             'X-App-ID': this.appId,
             ...options.headers,
         };
+        // 设置重试配置，默认禁用重试（maxRetries: 0）
+        const defaultRetryOptions = {
+            maxRetries: 0,
+        };
         const httpOptions = {
             baseURL: finalBaseURL,
             timeout: options.timeout,
             headers,
             auth: options.auth || this.getDefaultAuth(),
             hooks: options.hooks || this.getDefaultHooks(),
+            retryOptions: options.retryOptions || defaultRetryOptions,
         };
         this.httpClient = new HttpClient(httpOptions);
     }
@@ -1306,10 +1311,12 @@ class SeaVerseBackendAPIClient {
      * Login with email and password
      */
     async login(data, options) {
+        // 如果没有传 frontend_url，使用当前页面地址
+        const frontend_url = data.frontend_url || (typeof window !== 'undefined' ? window.location.origin : '');
         const config = {
             method: 'POST',
             url: `/sdk/v1/auth/login`,
-            data,
+            data: { ...data, frontend_url },
             headers: {
                 'X-Operation-Id': 'login',
                 ...options?.headers,
@@ -1405,6 +1412,34 @@ class SeaVerseBackendAPIClient {
         const response = await this.httpClient.request(config);
         return response.data;
     }
+    /**
+     * Verify email with token
+     * Verify user email and return JWT tokens for auto-login
+     *
+     * @param verifyToken - Email verification token from email link
+     * @param options - Additional axios request options
+     * @returns Email verification response with user data and JWT tokens
+     *
+     * @example
+     * const { data } = await client.verifyEmail('abc123def456...');
+     * localStorage.setItem('token', data.token);
+     * localStorage.setItem('refreshToken', data.refreshToken);
+     * console.log('User:', data.user);
+     */
+    async verifyEmail(verifyToken, options) {
+        const config = {
+            method: 'GET',
+            url: `/sdk/v1/auth/email/verify`,
+            params: { verify_token: verifyToken },
+            headers: {
+                'X-Operation-Id': 'verifyEmail',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
     /**
      * Get api-service token
      * Generate token for accessing api-service from sandbox
@@ -1423,6 +1458,155 @@ class SeaVerseBackendAPIClient {
         return response.data;
     }
     // ============================================================================
+    // Invite Code Management APIs
+    // ============================================================================
+    /**
+     * List my invite codes
+     * Get all invite codes created by the current user
+     *
+     * @param params - Optional pagination and filtering parameters
+     * @param options - Additional axios request options
+     * @returns List of invite codes with pagination info
+     *
+     * @example
+     * // List all active invite codes
+     * const result = await client.listInvites({
+     *   status: 'active',
+     *   page: 1,
+     *   page_size: 20
+     * });
+     * console.log('Invites:', result.data.invites);
+     */
+    async listInvites(params, options) {
+        const config = {
+            method: 'GET',
+            url: `/sdk/v1/auth/invites`,
+            params,
+            headers: {
+                'X-Operation-Id': 'listInvites',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
+    /**
+     * Get invite code statistics
+     * Get statistics for invite codes created by the current user
+     *
+     * @param options - Additional axios request options
+     * @returns Invite code statistics
+     *
+     * @example
+     * const result = await client.getInviteStats();
+     * console.log('Total codes:', result.data.total_codes);
+     * console.log('Total uses:', result.data.total_uses);
+     */
+    async getInviteStats(options) {
+        const config = {
+            method: 'GET',
+            url: `/sdk/v1/auth/invites/stats`,
+            headers: {
+                'X-Operation-Id': 'getInviteStats',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
+    /**
+     * Get invite code details
+     * Get detailed information for a specific invite code
+     *
+     * @param inviteId - Invite code ID
+     * @param options - Additional axios request options
+     * @returns Invite code details
+     *
+     * @example
+     * const result = await client.getInvite('inv_abc123');
+     * console.log('Code:', result.data.code);
+     * console.log('Used:', result.data.used_count);
+     */
+    async getInvite(inviteId, options) {
+        const config = {
+            method: 'GET',
+            url: `/sdk/v1/auth/invites/${inviteId}`,
+            headers: {
+                'X-Operation-Id': 'getInvite',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
+    /**
+     * Get invite code usage records
+     * Get all usage records for a specific invite code
+     *
+     * @param inviteId - Invite code ID
+     * @param params - Optional pagination parameters
+     * @param options - Additional axios request options
+     * @returns List of usage records with pagination info
+     *
+     * @example
+     * const result = await client.getInviteUsages('inv_abc123', {
+     *   page: 1,
+     *   page_size: 20
+     * });
+     * console.log('Usages:', result.data.usages);
+     */
+    async getInviteUsages(inviteId, params, options) {
+        const config = {
+            method: 'GET',
+            url: `/sdk/v1/auth/invites/${inviteId}/usages`,
+            params,
+            headers: {
+                'X-Operation-Id': 'getInviteUsages',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
+    /**
+     * Bind invitation code to temporary account
+     * Activate a temporary account by binding an invitation code
+     *
+     * @param data - Bind invite code request
+     * @param options - Additional axios request options
+     * @returns Activation response with JWT tokens and user info
+     *
+     * @example
+     * // Bind invitation code to activate temporary account
+     * const result = await client.bindInviteCode({
+     *   user_id: 'user_temp_xyz789',
+     *   invite_code: 'ABCD1234'
+     * });
+     *
+     * // Auto-login with returned tokens
+     * localStorage.setItem('token', result.data.token);
+     * localStorage.setItem('refreshToken', result.data.refreshToken);
+     * console.log('Account activated:', result.data.user);
+     */
+    async bindInviteCode(data, options) {
+        const config = {
+            method: 'POST',
+            url: `/sdk/v1/auth/bind-invite-code`,
+            data,
+            headers: {
+                'X-Operation-Id': 'bindInviteCode',
+                ...options?.headers,
+            },
+            ...options,
+        };
+        const response = await this.httpClient.request(config);
+        return response.data;
+    }
+    // ============================================================================
     // OAuth APIs
     // ============================================================================
     /**
@@ -1810,15 +1994,559 @@ class SeaVerseBackendAPIClient {
     }
 }
 
+/**
+ * Toast Notification System
+ * A modern, glass-morphism inspired notification component
+ */
+class Toast {
+    /**
+     * Show a toast notification
+     */
+    static show(options) {
+        const { type, title, message, duration = 3000, onClose, } = options;
+        // Ensure CSS is injected
+        if (!this.cssInjected) {
+            this.injectCSS();
+        }
+        // Ensure container exists
+        if (!this.container) {
+            this.createContainer();
+        }
+        // Create toast element
+        const toast = this.createToast(type, title, message, onClose);
+        // Add to container
+        this.container.appendChild(toast);
+        this.toasts.push(toast);
+        // Trigger slide-in animation
+        requestAnimationFrame(() => {
+            toast.classList.add('toast-show');
+        });
+        // Auto-dismiss
+        if (duration > 0) {
+            setTimeout(() => {
+                this.dismiss(toast, onClose);
+            }, duration);
+        }
+    }
+    /**
+     * Convenience methods for different types
+     */
+    static success(title, message, duration) {
+        this.show({ type: 'success', title, message, duration });
+    }
+    static error(title, message, duration) {
+        this.show({ type: 'error', title, message, duration });
+    }
+    static warning(title, message, duration) {
+        this.show({ type: 'warning', title, message, duration });
+    }
+    static info(title, message, duration) {
+        this.show({ type: 'info', title, message, duration });
+    }
+    /**
+     * Create the toast container
+     */
+    static createContainer() {
+        this.container = document.createElement('div');
+        this.container.className = 'toast-container';
+        document.body.appendChild(this.container);
+    }
+    /**
+     * Create a toast element using safe DOM methods
+     */
+    static createToast(type, title, message, onClose) {
+        const id = `toast-${this.nextId++}`;
+        const toast = document.createElement('div');
+        toast.className = `toast toast-${type}`;
+        toast.id = id;
+        // Icon container
+        const iconContainer = document.createElement('div');
+        iconContainer.className = 'toast-icon';
+        const iconSvg = this.createIconSVG(type);
+        iconContainer.appendChild(iconSvg);
+        toast.appendChild(iconContainer);
+        // Content container
+        const contentContainer = document.createElement('div');
+        contentContainer.className = 'toast-content';
+        const titleElement = document.createElement('div');
+        titleElement.className = 'toast-title';
+        titleElement.textContent = title;
+        contentContainer.appendChild(titleElement);
+        const messageElement = document.createElement('div');
+        messageElement.className = 'toast-message';
+        messageElement.textContent = message;
+        contentContainer.appendChild(messageElement);
+        toast.appendChild(contentContainer);
+        // Close button
+        const closeBtn = document.createElement('button');
+        closeBtn.className = 'toast-close';
+        closeBtn.setAttribute('aria-label', 'Close notification');
+        closeBtn.addEventListener('click', () => {
+            this.dismiss(toast, onClose);
+        });
+        // Close icon SVG
+        const closeSvg = this.createCloseSVG();
+        closeBtn.appendChild(closeSvg);
+        toast.appendChild(closeBtn);
+        return toast;
+    }
+    /**
+     * Create icon SVG element for each type
+     */
+    static createIconSVG(type) {
+        const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        svg.setAttribute('width', '24');
+        svg.setAttribute('height', '24');
+        svg.setAttribute('viewBox', '0 0 24 24');
+        svg.setAttribute('fill', 'none');
+        if (type === 'success') {
+            // Background circle
+            const bgCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            bgCircle.setAttribute('cx', '12');
+            bgCircle.setAttribute('cy', '12');
+            bgCircle.setAttribute('r', '10');
+            bgCircle.setAttribute('stroke', 'currentColor');
+            bgCircle.setAttribute('stroke-width', '2');
+            bgCircle.setAttribute('opacity', '0.2');
+            svg.appendChild(bgCircle);
+            // Animated circle
+            const animCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            animCircle.setAttribute('class', 'toast-icon-circle');
+            animCircle.setAttribute('cx', '12');
+            animCircle.setAttribute('cy', '12');
+            animCircle.setAttribute('r', '10');
+            animCircle.setAttribute('stroke', 'currentColor');
+            animCircle.setAttribute('stroke-width', '2');
+            animCircle.setAttribute('stroke-dasharray', '63');
+            animCircle.setAttribute('stroke-dashoffset', '63');
+            svg.appendChild(animCircle);
+            // Check mark
+            const check = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            check.setAttribute('class', 'toast-icon-check');
+            check.setAttribute('d', 'M8 12.5L10.5 15L16 9.5');
+            check.setAttribute('stroke', 'currentColor');
+            check.setAttribute('stroke-width', '2');
+            check.setAttribute('stroke-linecap', 'round');
+            check.setAttribute('stroke-linejoin', 'round');
+            check.setAttribute('opacity', '0');
+            svg.appendChild(check);
+        }
+        else if (type === 'error') {
+            // Background circle
+            const bgCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            bgCircle.setAttribute('cx', '12');
+            bgCircle.setAttribute('cy', '12');
+            bgCircle.setAttribute('r', '10');
+            bgCircle.setAttribute('stroke', 'currentColor');
+            bgCircle.setAttribute('stroke-width', '2');
+            bgCircle.setAttribute('opacity', '0.2');
+            svg.appendChild(bgCircle);
+            // Animated circle
+            const animCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            animCircle.setAttribute('class', 'toast-icon-circle');
+            animCircle.setAttribute('cx', '12');
+            animCircle.setAttribute('cy', '12');
+            animCircle.setAttribute('r', '10');
+            animCircle.setAttribute('stroke', 'currentColor');
+            animCircle.setAttribute('stroke-width', '2');
+            animCircle.setAttribute('stroke-dasharray', '63');
+            animCircle.setAttribute('stroke-dashoffset', '63');
+            svg.appendChild(animCircle);
+            // X mark
+            const xMark = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            xMark.setAttribute('class', 'toast-icon-x');
+            xMark.setAttribute('d', 'M9 9L15 15M15 9L9 15');
+            xMark.setAttribute('stroke', 'currentColor');
+            xMark.setAttribute('stroke-width', '2');
+            xMark.setAttribute('stroke-linecap', 'round');
+            xMark.setAttribute('opacity', '0');
+            svg.appendChild(xMark);
+        }
+        else if (type === 'warning') {
+            // Background triangle
+            const bgTriangle = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            bgTriangle.setAttribute('d', 'M12 2L2 20H22L12 2Z');
+            bgTriangle.setAttribute('stroke', 'currentColor');
+            bgTriangle.setAttribute('stroke-width', '2');
+            bgTriangle.setAttribute('opacity', '0.2');
+            svg.appendChild(bgTriangle);
+            // Animated triangle
+            const animTriangle = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            animTriangle.setAttribute('class', 'toast-icon-triangle');
+            animTriangle.setAttribute('d', 'M12 2L2 20H22L12 2Z');
+            animTriangle.setAttribute('stroke', 'currentColor');
+            animTriangle.setAttribute('stroke-width', '2');
+            animTriangle.setAttribute('stroke-dasharray', '80');
+            animTriangle.setAttribute('stroke-dashoffset', '80');
+            svg.appendChild(animTriangle);
+            // Exclamation mark
+            const exclaim = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            exclaim.setAttribute('class', 'toast-icon-exclaim');
+            exclaim.setAttribute('d', 'M12 9V13M12 16V16.5');
+            exclaim.setAttribute('stroke', 'currentColor');
+            exclaim.setAttribute('stroke-width', '2');
+            exclaim.setAttribute('stroke-linecap', 'round');
+            exclaim.setAttribute('opacity', '0');
+            svg.appendChild(exclaim);
+        }
+        else { // info
+            // Background circle
+            const bgCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            bgCircle.setAttribute('cx', '12');
+            bgCircle.setAttribute('cy', '12');
+            bgCircle.setAttribute('r', '10');
+            bgCircle.setAttribute('stroke', 'currentColor');
+            bgCircle.setAttribute('stroke-width', '2');
+            bgCircle.setAttribute('opacity', '0.2');
+            svg.appendChild(bgCircle);
+            // Animated circle
+            const animCircle = document.createElementNS('http://www.w3.org/2000/svg', 'circle');
+            animCircle.setAttribute('class', 'toast-icon-circle');
+            animCircle.setAttribute('cx', '12');
+            animCircle.setAttribute('cy', '12');
+            animCircle.setAttribute('r', '10');
+            animCircle.setAttribute('stroke', 'currentColor');
+            animCircle.setAttribute('stroke-width', '2');
+            animCircle.setAttribute('stroke-dasharray', '63');
+            animCircle.setAttribute('stroke-dashoffset', '63');
+            svg.appendChild(animCircle);
+            // Info i
+            const iMark = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+            iMark.setAttribute('class', 'toast-icon-i');
+            iMark.setAttribute('d', 'M12 8V8.5M12 12V16');
+            iMark.setAttribute('stroke', 'currentColor');
+            iMark.setAttribute('stroke-width', '2');
+            iMark.setAttribute('stroke-linecap', 'round');
+            iMark.setAttribute('opacity', '0');
+            svg.appendChild(iMark);
+        }
+        return svg;
+    }
+    /**
+     * Create close button SVG
+     */
+    static createCloseSVG() {
+        const svg = document.createElementNS('http://www.w3.org/2000/svg', 'svg');
+        svg.setAttribute('width', '16');
+        svg.setAttribute('height', '16');
+        svg.setAttribute('viewBox', '0 0 16 16');
+        svg.setAttribute('fill', 'none');
+        const path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+        path.setAttribute('d', 'M12 4L4 12M4 4L12 12');
+        path.setAttribute('stroke', 'currentColor');
+        path.setAttribute('stroke-width', '1.5');
+        path.setAttribute('stroke-linecap', 'round');
+        svg.appendChild(path);
+        return svg;
+    }
+    /**
+     * Dismiss a toast
+     */
+    static dismiss(toast, onClose) {
+        // Trigger slide-out animation
+        toast.classList.add('toast-hide');
+        // Remove from DOM after animation
+        setTimeout(() => {
+            if (toast.parentNode) {
+                toast.parentNode.removeChild(toast);
+            }
+            // Remove from array
+            const index = this.toasts.indexOf(toast);
+            if (index > -1) {
+                this.toasts.splice(index, 1);
+            }
+            // Call onClose callback
+            if (onClose) {
+                onClose();
+            }
+            // Remove container if no toasts left
+            if (this.toasts.length === 0 && this.container) {
+                this.container.remove();
+                this.container = null;
+            }
+        }, 300);
+    }
+    /**
+     * Dismiss all toasts
+     */
+    static dismissAll() {
+        this.toasts.forEach(toast => {
+            this.dismiss(toast);
+        });
+    }
+    /**
+     * Inject Toast CSS into the page
+     */
+    static injectCSS() {
+        if (this.cssInjected)
+            return;
+        const cssContent = `
+/* Toast Container */
+.toast-container {
+  position: fixed;
+  top: 24px;
+  right: 24px;
+  z-index: 10000;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  pointer-events: none;
+  max-width: 420px;
+  width: calc(100vw - 48px);
+}
+
+@media (max-width: 640px) {
+  .toast-container {
+    top: 16px;
+    right: 16px;
+    left: 16px;
+    width: auto;
+    max-width: none;
+  }
+}
+
+/* Toast Base */
+.toast {
+  position: relative;
+  display: flex;
+  align-items: flex-start;
+  gap: 14px;
+  padding: 18px 20px;
+  border-radius: 16px;
+  background: rgba(20, 20, 24, 0.92);
+  backdrop-filter: blur(20px) saturate(180%);
+  -webkit-backdrop-filter: blur(20px) saturate(180%);
+  border: 1px solid rgba(255, 255, 255, 0.08);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05);
+  pointer-events: auto;
+  transform: translateY(-120%) translateZ(0);
+  opacity: 0;
+  transition: all 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
+  will-change: transform, opacity;
+}
+
+.toast-show {
+  transform: translateY(0) translateZ(0);
+  opacity: 1;
+}
+
+.toast-hide {
+  transform: translateY(-120%) translateZ(0);
+  opacity: 0;
+  transition: all 0.25s cubic-bezier(0.4, 0, 1, 1);
+}
+
+.toast-icon {
+  flex-shrink: 0;
+  width: 24px;
+  height: 24px;
+  margin-top: 2px;
+  position: relative;
+}
+
+@keyframes drawCircle {
+  to { stroke-dashoffset: 0; }
+}
+
+@keyframes drawTriangle {
+  to { stroke-dashoffset: 0; }
+}
+
+@keyframes fadeInIcon {
+  to { opacity: 1; }
+}
+
+.toast-show .toast-icon-circle {
+  animation: drawCircle 0.5s cubic-bezier(0.4, 0, 0.2, 1) 0.1s forwards;
+}
+
+.toast-show .toast-icon-triangle {
+  animation: drawTriangle 0.5s cubic-bezier(0.4, 0, 0.2, 1) 0.1s forwards;
+}
+
+.toast-show .toast-icon-check,
+.toast-show .toast-icon-x,
+.toast-show .toast-icon-exclaim,
+.toast-show .toast-icon-i {
+  animation: fadeInIcon 0.3s ease-out 0.4s forwards;
+}
+
+.toast-content {
+  flex: 1;
+  min-width: 0;
+  padding-top: 1px;
+}
+
+.toast-title {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  font-size: 15px;
+  font-weight: 700;
+  line-height: 1.4;
+  letter-spacing: -0.01em;
+  color: rgba(255, 255, 255, 0.95);
+  margin-bottom: 4px;
+}
+
+.toast-message {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+  font-size: 13.5px;
+  font-weight: 400;
+  line-height: 1.5;
+  letter-spacing: -0.005em;
+  color: rgba(255, 255, 255, 0.65);
+}
+
+.toast-close {
+  flex-shrink: 0;
+  width: 28px;
+  height: 28px;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: none;
+  background: transparent;
+  color: rgba(255, 255, 255, 0.4);
+  cursor: pointer;
+  border-radius: 8px;
+  transition: all 0.2s ease;
+  margin: -4px -6px 0 0;
+}
+
+.toast-close:hover {
+  background: rgba(255, 255, 255, 0.08);
+  color: rgba(255, 255, 255, 0.7);
+}
+
+.toast-close:active {
+  transform: scale(0.92);
+}
+
+.toast-success {
+  border-color: rgba(52, 211, 153, 0.2);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(52, 211, 153, 0.15), 0 0 24px rgba(52, 211, 153, 0.12);
+}
+
+.toast-success .toast-icon {
+  color: #34d399;
+  filter: drop-shadow(0 0 8px rgba(52, 211, 153, 0.4));
+}
+
+@keyframes successGlow {
+  0%, 100% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(52, 211, 153, 0.15), 0 0 24px rgba(52, 211, 153, 0.12); }
+  50% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(52, 211, 153, 0.25), 0 0 32px rgba(52, 211, 153, 0.2); }
+}
+
+.toast-success.toast-show {
+  animation: successGlow 2s ease-in-out infinite;
+}
+
+.toast-error {
+  border-color: rgba(248, 113, 113, 0.2);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(248, 113, 113, 0.15), 0 0 24px rgba(248, 113, 113, 0.12);
+}
+
+.toast-error .toast-icon {
+  color: #f87171;
+  filter: drop-shadow(0 0 8px rgba(248, 113, 113, 0.4));
+}
+
+@keyframes errorGlow {
+  0%, 100% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(248, 113, 113, 0.15), 0 0 24px rgba(248, 113, 113, 0.12); }
+  50% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(248, 113, 113, 0.25), 0 0 32px rgba(248, 113, 113, 0.2); }
+}
+
+.toast-error.toast-show {
+  animation: errorGlow 2s ease-in-out infinite;
+}
+
+.toast-warning {
+  border-color: rgba(251, 191, 36, 0.2);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(251, 191, 36, 0.15), 0 0 24px rgba(251, 191, 36, 0.12);
+}
+
+.toast-warning .toast-icon {
+  color: #fbbf24;
+  filter: drop-shadow(0 0 8px rgba(251, 191, 36, 0.4));
+}
+
+@keyframes warningGlow {
+  0%, 100% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(251, 191, 36, 0.15), 0 0 24px rgba(251, 191, 36, 0.12); }
+  50% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(251, 191, 36, 0.25), 0 0 32px rgba(251, 191, 36, 0.2); }
+}
+
+.toast-warning.toast-show {
+  animation: warningGlow 2s ease-in-out infinite;
+}
+
+.toast-info {
+  border-color: rgba(96, 165, 250, 0.2);
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(96, 165, 250, 0.15), 0 0 24px rgba(96, 165, 250, 0.12);
+}
+
+.toast-info .toast-icon {
+  color: #60a5fa;
+  filter: drop-shadow(0 0 8px rgba(96, 165, 250, 0.4));
+}
+
+@keyframes infoGlow {
+  0%, 100% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(96, 165, 250, 0.15), 0 0 24px rgba(96, 165, 250, 0.12); }
+  50% { box-shadow: 0 4px 16px rgba(0, 0, 0, 0.4), 0 8px 32px rgba(0, 0, 0, 0.2), inset 0 1px 0 rgba(255, 255, 255, 0.05), 0 0 0 1px rgba(96, 165, 250, 0.25), 0 0 32px rgba(96, 165, 250, 0.2); }
+}
+
+.toast-info.toast-show {
+  animation: infoGlow 2s ease-in-out infinite;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .toast {
+    transition: opacity 0.2s ease;
+    animation: none !important;
+  }
+  .toast-show {
+    transform: none;
+  }
+  .toast-hide {
+    transform: none;
+  }
+  .toast-icon-circle,
+  .toast-icon-triangle,
+  .toast-icon-check,
+  .toast-icon-x,
+  .toast-icon-exclaim,
+  .toast-icon-i {
+    animation: none !important;
+    opacity: 1 !important;
+    stroke-dashoffset: 0 !important;
+  }
+}
+`;
+        const style = document.createElement('style');
+        style.id = 'toast-styles';
+        style.textContent = cssContent;
+        document.head.appendChild(style);
+        this.cssInjected = true;
+    }
+}
+Toast.container = null;
+Toast.toasts = [];
+Toast.nextId = 0;
+Toast.cssInjected = false;
+
 class AuthModal {
     constructor(options) {
         this.modal = null;
         this.currentView = 'login';
         this.resetToken = null;
+        this.tempUserId = null; // 临时用户ID（需要激活）
+        this.tempUserEmail = null; // 临时用户邮箱
         this.client = options.client;
         this.options = options;
+        // Auto-detect email verification token in URL
+        this.checkForEmailVerification();
         // Auto-detect reset token in URL
         this.checkForResetToken();
+        // Auto-detect invite code required error
+        this.checkForInviteCodeRequired();
     }
     /**
      * Show the authentication modal
@@ -1929,6 +2657,9 @@ class AuthModal {
         // Reset password form
         const resetForm = this.createResetPasswordForm();
         rightPanel.appendChild(resetForm);
+        // Invite code form
+        const inviteCodeForm = this.createInviteCodeForm();
+        rightPanel.appendChild(inviteCodeForm);
         // Success message
         const successMessage = this.createSuccessMessage();
         rightPanel.appendChild(successMessage);
@@ -2262,6 +2993,60 @@ class AuthModal {
         container.appendChild(footer);
         return container;
     }
+    createInviteCodeForm() {
+        const container = document.createElement('div');
+        container.id = 'inviteCodeForm';
+        container.className = 'auth-form-view hidden';
+        // Icon
+        const icon = document.createElement('div');
+        icon.className = 'forgot-password-icon';
+        icon.innerHTML = '<div class="icon-glow"></div><svg class="icon-lock" width="56" height="56" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><rect x="5" y="11" width="14" height="10" rx="2" /><path d="M12 11V7a3 3 0 0 1 3-3h0a3 3 0 0 1 3 3v4" /><circle cx="12" cy="15" r="1" /></svg>';
+        container.appendChild(icon);
+        // Header
+        const header = document.createElement('div');
+        header.className = 'auth-form-header';
+        const title = document.createElement('h2');
+        title.className = 'auth-form-title';
+        title.textContent = 'Activation Required';
+        const subtitle = document.createElement('p');
+        subtitle.className = 'auth-form-subtitle';
+        subtitle.id = 'inviteCodeSubtitle';
+        subtitle.textContent = 'Enter your invitation code to activate your account';
+        header.appendChild(title);
+        header.appendChild(subtitle);
+        container.appendChild(header);
+        // Form
+        const form = document.createElement('form');
+        form.id = 'inviteCodeFormElement';
+        form.className = 'auth-form';
+        const codeGroup = this.createFormGroup('inviteCodeInput', 'Invitation Code', 'text', 'Enter invitation code');
+        form.appendChild(codeGroup);
+        const submitBtn = document.createElement('button');
+        submitBtn.type = 'submit';
+        submitBtn.id = 'bindInviteCodeButton';
+        submitBtn.className = 'btn-auth-primary';
+        const btnText = document.createElement('span');
+        btnText.className = 'btn-text';
+        btnText.textContent = 'Activate Account';
+        const btnLoader = document.createElement('span');
+        btnLoader.className = 'btn-loader hidden';
+        btnLoader.innerHTML = '<svg class="spinner" viewBox="0 0 24 24"><circle class="spinner-track" cx="12" cy="12" r="10"></circle><circle class="spinner-circle" cx="12" cy="12" r="10"></circle></svg>';
+        submitBtn.appendChild(btnText);
+        submitBtn.appendChild(btnLoader);
+        form.appendChild(submitBtn);
+        container.appendChild(form);
+        // Footer
+        const footer = document.createElement('div');
+        footer.className = 'auth-footer forgot-footer';
+        const backLink = document.createElement('a');
+        backLink.href = '#';
+        backLink.id = 'backToLoginFromInvite';
+        backLink.className = 'back-to-login';
+        backLink.innerHTML = '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M19 12H5M12 19l-7-7 7-7"/></svg><span>Back to Sign In</span>';
+        footer.appendChild(backLink);
+        container.appendChild(footer);
+        return container;
+    }
     createSuccessMessage() {
         const container = document.createElement('div');
         container.id = 'authMessage';
@@ -2351,12 +3136,59 @@ class AuthModal {
         button.appendChild(span);
         return button;
     }
+    /**
+     * Check if URL contains email verification token and auto-verify
+     */
+    async checkForEmailVerification() {
+        const urlParams = new URLSearchParams(window.location.search);
+        const verifyToken = urlParams.get('verify_token');
+        if (!verifyToken) {
+            return;
+        }
+        console.log('[AuthModal] Detected verify_token, starting email verification...');
+        try {
+            // Call email verification API
+            const result = await this.client.verifyEmail(verifyToken);
+            if (result.success && result.data.token) {
+                console.log('[AuthModal] Email verification successful:', result.data.user);
+                // Auto-login: set token in client
+                this.client.setToken(result.data.token);
+                // Clean up URL parameters
+                urlParams.delete('verify_token');
+                const newUrl = window.location.pathname + (urlParams.toString() ? '?' + urlParams.toString() : '');
+                window.history.replaceState({}, '', newUrl);
+                // Trigger onLoginSuccess callback
+                if (this.options.onLoginSuccess) {
+                    this.options.onLoginSuccess(result.data.token, result.data.user);
+                }
+                // Show success message
+                this.showSuccess('Email Verified!', 'Your email has been verified successfully. You are now logged in.');
+            }
+            else {
+                throw new Error(result.data?.message || 'Email verification failed');
+            }
+        }
+        catch (error) {
+            console.error('[AuthModal] Email verification failed:', error);
+            // Clean up URL on error too
+            urlParams.delete('verify_token');
+            const newUrl = window.location.pathname + (urlParams.toString() ? '?' + urlParams.toString() : '');
+            window.history.replaceState({}, '', newUrl);
+            // Show error message
+            const errorMessage = error.response?.data?.error || error.message || 'Email verification failed';
+            this.showError('Verification Failed', errorMessage + '. Please try registering again or contact support.');
+            // Trigger error callback
+            if (this.options.onError) {
+                this.options.onError(error);
+            }
+        }
+    }
     /**
      * Check if URL contains reset token and auto-show reset password form
      */
     checkForResetToken() {
         const urlParams = new URLSearchParams(window.location.search);
-        const verifyToken = urlParams.get('verify_token');
+        const verifyToken = urlParams.get('reset_token');
         if (verifyToken) {
             this.resetToken = verifyToken;
             // Auto-show modal with reset password form
@@ -2365,6 +3197,58 @@ class AuthModal {
             }, 100);
         }
     }
+    /**
+     * Check if URL contains invite code required error and auto-show invite code form
+     */
+    checkForInviteCodeRequired() {
+        const urlParams = new URLSearchParams(window.location.search);
+        const errorCode = urlParams.get('error_code');
+        const userId = urlParams.get('user_id');
+        const tempUserId = urlParams.get('temp_user_id'); // Support alternative parameter name
+        const email = urlParams.get('email');
+        // Log for debugging
+        if (errorCode === 'INVITE_CODE_REQUIRED') {
+            console.log('[AuthModal] Detected INVITE_CODE_REQUIRED:', {
+                errorCode,
+                userId,
+                tempUserId,
+                email,
+                fullURL: window.location.href
+            });
+        }
+        if (errorCode === 'INVITE_CODE_REQUIRED') {
+            // Use user_id or temp_user_id
+            const finalUserId = userId || tempUserId;
+            if (!finalUserId) {
+                // Missing user_id - show error
+                console.error('[AuthModal] Missing user_id in URL parameters. Backend should include user_id when redirecting with INVITE_CODE_REQUIRED.');
+                alert('错误：后端重定向缺少 user_id 参数。请联系技术支持。\n\n完整URL: ' + window.location.href);
+                // Clean up URL anyway
+                const url = new URL(window.location.href);
+                url.searchParams.delete('error_code');
+                window.history.replaceState({}, document.title, url.toString());
+                return;
+            }
+            this.tempUserId = finalUserId;
+            this.tempUserEmail = email || '';
+            // Clean up URL
+            const url = new URL(window.location.href);
+            url.searchParams.delete('error_code');
+            url.searchParams.delete('user_id');
+            url.searchParams.delete('temp_user_id');
+            url.searchParams.delete('email');
+            window.history.replaceState({}, document.title, url.toString());
+            // Trigger callback if provided
+            if (this.options.onInviteCodeRequired) {
+                this.options.onInviteCodeRequired(finalUserId, email || '');
+            }
+            // Auto-show modal with invite code form
+            console.log('[AuthModal] Auto-showing invite code form');
+            setTimeout(() => {
+                this.show('invite-code');
+            }, 100);
+        }
+    }
     bindEventListeners() {
         if (!this.modal)
             return;
@@ -2400,6 +3284,11 @@ class AuthModal {
             e.preventDefault();
             this.switchView('login');
         });
+        const backToLoginFromInvite = this.modal.querySelector('#backToLoginFromInvite');
+        backToLoginFromInvite?.addEventListener('click', (e) => {
+            e.preventDefault();
+            this.switchView('login');
+        });
         // Password toggle
         const passwordToggles = this.modal.querySelectorAll('.toggle-password');
         passwordToggles.forEach((toggle) => {
@@ -2432,6 +3321,8 @@ class AuthModal {
         forgotForm?.addEventListener('submit', (e) => this.handleForgotPassword(e));
         const resetPasswordForm = this.modal.querySelector('#resetPasswordFormElement');
         resetPasswordForm?.addEventListener('submit', (e) => this.handleResetPassword(e));
+        const inviteCodeForm = this.modal.querySelector('#inviteCodeFormElement');
+        inviteCodeForm?.addEventListener('submit', (e) => this.handleBindInviteCode(e));
         // OAuth social login buttons
         this.bindSocialLoginButtons();
     }
@@ -2478,7 +3369,7 @@ class AuthModal {
     switchView(view) {
         if (!this.modal)
             return;
-        const views = ['loginForm', 'signupForm', 'forgotPasswordForm', 'resetPasswordForm', 'authMessage'];
+        const views = ['loginForm', 'signupForm', 'forgotPasswordForm', 'resetPasswordForm', 'inviteCodeForm', 'authMessage'];
         views.forEach((viewId) => {
             const element = this.modal.querySelector(`#${viewId}`);
             element?.classList.add('hidden');
@@ -2488,6 +3379,7 @@ class AuthModal {
             signup: 'signupForm',
             forgot: 'forgotPasswordForm',
             'reset-password': 'resetPasswordForm',
+            'invite-code': 'inviteCodeForm',
             message: 'authMessage',
         };
         const targetView = this.modal.querySelector(`#${viewMap[view]}`);
@@ -2520,7 +3412,7 @@ class AuthModal {
                 if (this.options.onLoginSuccess) {
                     this.options.onLoginSuccess(response.token, response.user);
                 }
-                this.showMessage('Login Successful', 'Welcome back!');
+                this.showSuccess('Login Successful', 'Welcome back!');
             }
             else {
                 throw new Error('Invalid response from server');
@@ -2529,7 +3421,7 @@ class AuthModal {
         catch (error) {
             // Handle error
             const errorMessage = error instanceof Error ? error.message : 'Login failed';
-            this.showError(errorMessage);
+            this.showError('Login Failed', errorMessage);
             if (this.options.onError) {
                 this.options.onError(error);
             }
@@ -2556,7 +3448,7 @@ class AuthModal {
         const passwordConfirm = passwordConfirmInput.value;
         // Validate passwords match
         if (password !== passwordConfirm) {
-            this.showError('Passwords do not match');
+            this.showError('Password Mismatch', 'Passwords do not match');
             return;
         }
         try {
@@ -2571,18 +3463,31 @@ class AuthModal {
             });
             // Handle success - Note: register returns different response format
             if (response.success) {
-                // After successful registration, perform login to get token
+                // Check if email verification is required
+                if (response.requiresEmailVerification) {
+                    this.showInfo('Email Verification Required', 'Please check your email and click the verification link to activate your account.');
+                    return; // Don't auto-login, user needs to verify email first
+                }
+                // Check if invitation code is required
+                if (response.requiresInvitationCode && response.tempUserId) {
+                    this.tempUserId = response.tempUserId;
+                    this.tempUserEmail = email;
+                    this.showInfo('Activation Required', 'Please enter your invitation code to activate your account.');
+                    this.show('invite-code'); // Show invite code activation form
+                    return; // Don't auto-login, user needs to activate with invite code first
+                }
+                // Only auto-login if no verification or activation is needed
                 const loginResponse = await this.client.login({ email, password });
                 if (loginResponse.token) {
                     if (this.options.onSignupSuccess) {
                         this.options.onSignupSuccess(loginResponse.token, loginResponse.user);
                     }
-                    this.showMessage('Account Created', response.message || 'Your account has been created successfully!');
+                    this.showSuccess('Account Created', response.message || 'Your account has been created successfully!');
                 }
             }
             else if (response.code === ErrorCode.ACCOUNT_EXISTS) {
                 // Handle account already exists error
-                this.showMessage('Account Already Exists', 'This email is already registered. Please login instead.');
+                this.showWarning('Account Already Exists', 'This email is already registered. Please login instead.');
             }
             else {
                 throw new Error(response.error || 'Registration failed');
@@ -2591,12 +3496,12 @@ class AuthModal {
         catch (error) {
             // Handle HTTP errors
             if (error.response?.data?.code === ErrorCode.ACCOUNT_EXISTS) {
-                this.showMessage('Account Already Exists', 'This email is already registered. Please login instead.');
+                this.showWarning('Account Already Exists', 'This email is already registered. Please login instead.');
                 return;
             }
             // Handle other errors
             const errorMessage = error.response?.data?.error || error.message || 'Signup failed';
-            this.showError(errorMessage);
+            this.showError('Registration Failed', errorMessage);
             if (this.options.onError) {
                 this.options.onError(error);
             }
@@ -2621,12 +3526,12 @@ class AuthModal {
             // Call forgot password API
             await this.client.forgotPassword({ email });
             // Show success message
-            this.showMessage('Reset Link Sent', `We've sent a password reset link to ${email}`);
+            this.showSuccess('Reset Link Sent', `We've sent a password reset link to ${email}`);
         }
         catch (error) {
             // Handle error
             const errorMessage = error instanceof Error ? error.message : 'Failed to send reset link';
-            this.showError(errorMessage);
+            this.showError('Failed to Send Link', errorMessage);
             if (this.options.onError) {
                 this.options.onError(error);
             }
@@ -2649,12 +3554,12 @@ class AuthModal {
         const confirmPassword = passwordConfirmInput.value;
         // Validate passwords match
         if (newPassword !== confirmPassword) {
-            this.showError('Passwords do not match');
+            this.showError('Password Mismatch', 'Passwords do not match');
             return;
         }
         // Validate token exists
         if (!this.resetToken) {
-            this.showError('Reset token is missing. Please use the link from your email.');
+            this.showError('Invalid Token', 'Reset token is missing. Please use the link from your email.');
             return;
         }
         try {
@@ -2667,19 +3572,19 @@ class AuthModal {
                 token: this.resetToken,
                 new_password: newPassword,
             });
-            // Clean up URL (remove verify_token from query string)
+            // Clean up URL (remove reset_token from query string)
             const url = new URL(window.location.href);
-            url.searchParams.delete('verify_token');
+            url.searchParams.delete('reset_token');
             window.history.replaceState({}, document.title, url.toString());
             // Clear reset token
             this.resetToken = null;
             // Show success message
-            this.showMessage('Password Reset Successful', 'Your password has been updated successfully. You can now log in with your new password.');
+            this.showSuccess('Password Reset Successful', 'Your password has been updated successfully. You can now log in with your new password.');
         }
         catch (error) {
             // Handle error
             const errorMessage = error instanceof Error ? error.message : 'Failed to reset password';
-            this.showError(errorMessage);
+            this.showError('Reset Failed', errorMessage);
             if (this.options.onError) {
                 this.options.onError(error);
             }
@@ -2691,24 +3596,89 @@ class AuthModal {
             btnLoader?.classList.add('hidden');
         }
     }
-    showMessage(title, message) {
-        if (!this.modal)
+    async handleBindInviteCode(e) {
+        e.preventDefault();
+        const codeInput = this.modal?.querySelector('#inviteCodeInput');
+        const submitBtn = this.modal?.querySelector('#bindInviteCodeButton');
+        const btnText = submitBtn?.querySelector('.btn-text');
+        const btnLoader = submitBtn?.querySelector('.btn-loader');
+        if (!codeInput || !submitBtn)
+            return;
+        const inviteCode = codeInput.value.trim();
+        // Validate invite code
+        if (!inviteCode) {
+            this.showError('Invalid Input', 'Please enter an invitation code');
+            return;
+        }
+        // Validate temp user ID exists
+        if (!this.tempUserId) {
+            this.showError('Session Error', 'User ID is missing. Please try logging in again.');
             return;
-        const messageTitle = this.modal.querySelector('#messageTitle');
-        const messageText = this.modal.querySelector('#messageText');
-        const messageButton = this.modal.querySelector('#messageButton');
-        if (messageTitle)
-            messageTitle.textContent = title;
-        if (messageText)
-            messageText.textContent = message;
-        messageButton?.addEventListener('click', () => {
-            this.hide();
-        }, { once: true });
-        this.switchView('message');
-    }
-    showError(message) {
-        // Simple error display - you can enhance this
-        alert(message);
+        }
+        try {
+            // Show loading state
+            submitBtn.disabled = true;
+            btnText?.classList.add('hidden');
+            btnLoader?.classList.remove('hidden');
+            // Call bind invite code API
+            const response = await this.client.bindInviteCode({
+                user_id: this.tempUserId,
+                invite_code: inviteCode,
+            });
+            // Handle success - auto login with returned token
+            if (response.success && response.data.token) {
+                const { token, refreshToken, user } = response.data;
+                // Store tokens
+                if (this.options.onLoginSuccess) {
+                    this.options.onLoginSuccess(token, user);
+                }
+                // Auto-set token in client
+                this.client.setToken(token);
+                // Show success message
+                this.showSuccess('Account Activated!', 'Your account has been successfully activated. Welcome!');
+                // Clear temp user data
+                this.tempUserId = null;
+                this.tempUserEmail = null;
+            }
+            else {
+                throw new Error('Invalid response from server');
+            }
+        }
+        catch (error) {
+            // Handle errors
+            const errorMessage = error.response?.data?.error || error.message || 'Failed to activate account';
+            this.showError('Activation Failed', errorMessage);
+            if (this.options.onError) {
+                this.options.onError(error);
+            }
+        }
+        finally {
+            // Reset loading state
+            submitBtn.disabled = false;
+            btnText?.classList.remove('hidden');
+            btnLoader?.classList.add('hidden');
+        }
+    }
+    showSuccess(title, message) {
+        Toast.success(title, message);
+        // Also hide modal after short delay for better UX
+        setTimeout(() => this.hide(), 1500);
+    }
+    showError(title, message) {
+        Toast.error(title, message);
+    }
+    showWarning(title, message) {
+        Toast.warning(title, message);
+    }
+    showInfo(title, message) {
+        Toast.info(title, message);
+    }
+    /**
+     * @deprecated Use showSuccess, showError, showWarning, or showInfo instead
+     */
+    showMessage(title, message) {
+        // Fallback for backward compatibility
+        Toast.info(title, message);
     }
     // ============================================================================
     // OAuth Methods
@@ -2750,7 +3720,7 @@ class AuthModal {
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(`${provider} OAuth failed`);
-            this.showError(err.message);
+            this.showError('OAuth Failed', err.message);
             if (this.options.onError) {
                 this.options.onError(err);
             }
@@ -2783,6 +3753,62 @@ class AuthModal {
             token,
         };
     }
+    /**
+     * Handle invite code required scenario (static method for custom UI)
+     *
+     * When backend redirects to return_url?error_code=INVITE_CODE_REQUIRED&user_id=xxx&email=xxx,
+     * call this method to show the invite code form or handle it custom way.
+     *
+     * @param options - Auth modal options
+     * @param customHandler - Optional custom handler for invite code requirement
+     * @returns Object with userId and email if invite code is required, null otherwise
+     *
+     * @example
+     * // Auto-show AuthModal invite code form
+     * const modal = new AuthModal(options);
+     * AuthModal.handleInviteCodeRequired(options);
+     *
+     * @example
+     * // Custom UI handling
+     * const result = AuthModal.handleInviteCodeRequired(options, (userId, email) => {
+     *   // Show your custom invite code input UI
+     *   const code = prompt('Enter invitation code:');
+     *   if (code) {
+     *     options.client.bindInviteCode({ user_id: userId, invite_code: code })
+     *       .then(res => {
+     *         localStorage.setItem('token', res.data.token);
+     *         window.location.reload();
+     *       });
+     *   }
+     * });
+     */
+    static handleInviteCodeRequired(options, customHandler) {
+        const urlParams = new URLSearchParams(window.location.search);
+        const errorCode = urlParams.get('error_code');
+        const userId = urlParams.get('user_id');
+        const email = urlParams.get('email');
+        if (errorCode !== 'INVITE_CODE_REQUIRED' || !userId) {
+            return null; // Not an invite code required scenario
+        }
+        // Clean up URL
+        const url = new URL(window.location.href);
+        url.searchParams.delete('error_code');
+        url.searchParams.delete('user_id');
+        url.searchParams.delete('email');
+        window.history.replaceState({}, document.title, url.toString());
+        // Call custom handler if provided
+        if (customHandler) {
+            customHandler(userId, email || '');
+        }
+        else if (options.onInviteCodeRequired) {
+            // Call the callback option
+            options.onInviteCodeRequired(userId, email || '');
+        }
+        return {
+            userId,
+            email: email || '',
+        };
+    }
 }
 /**
  * Create and show auth modal
@@ -2791,5 +3817,5 @@ function createAuthModal(options) {
     return new AuthModal(options);
 }
 
-export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, SeaVerseBackendAPIClient, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
+export { AuthFactory, AuthModal, AuthProvider, BuiltInHooks, ENVIRONMENT_CONFIGS, ErrorCode, SeaVerseBackendAPIClient, Toast, createAuthModal, detectEnvironment, getEnvironmentConfig, models };
 //# sourceMappingURL=index.js.map