@enbox/browser 0.1.2 → 0.1.4

package/dist/esm/browser-connect-handler.js

@@ -0,0 +1,66 @@
+/**
+ * Browser connect handler for `@enbox/auth`.
+ *
+ * Implements the {@link ConnectHandler} interface using browser-native
+ * DWeb Connect (popup + postMessage) with a wallet selector modal.
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { DWebConnect } from './dweb-connect-client.js';
+import { showWalletSelector } from './ui/wallet-selector.js';
+/** Default wallets shown in the selector when no overrides are provided. */
+export const DEFAULT_WALLETS = [
+    { name: 'Enbox Wallet', url: 'https://wallet.enbox.org' },
+];
+/**
+ * Create a browser-native connect handler using DWeb Connect
+ * (popup + postMessage).
+ *
+ * This handler:
+ * 1. Shows a wallet selector modal (or uses a provided walletUrl).
+ * 2. Opens the selected wallet as a popup window.
+ * 3. Runs the DWeb Connect postMessage protocol.
+ * 4. Returns the delegate credentials on success.
+ *
+ * @example
+ * ```ts
+ * import { AuthManager } from '@enbox/auth';
+ * import { BrowserConnectHandler } from '@enbox/browser';
+ *
+ * const auth = await AuthManager.create({
+ *   connectHandler: BrowserConnectHandler(),
+ * });
+ *
+ * const session = await auth.connect({ protocols: [NotesProtocol] });
+ * ```
+ */
+export function BrowserConnectHandler(options = {}) {
+    const { wallets = DEFAULT_WALLETS, walletUrl: fixedWalletUrl, timeout, } = options;
+    return {
+        requestAccess(params) {
+            return __awaiter(this, void 0, void 0, function* () {
+                // 1. Determine wallet URL.
+                let walletUrl = fixedWalletUrl;
+                if (!walletUrl) {
+                    walletUrl = yield showWalletSelector(wallets);
+                }
+                // 2. Run the DWeb Connect popup flow.
+                return DWebConnect.initClient({
+                    walletUrl,
+                    permissionRequests: params.permissionRequests,
+                    timeout,
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=browser-connect-handler.js.map

package/dist/esm/browser-connect-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-connect-handler.js","sourceRoot":"","sources":["../../src/browser-connect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;;;;;;;;AAKH,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAc7D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,0BAA0B,EAAE;CAC1D,CAAC;AAuBF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAwC,EAAE;IAE1C,MAAM,EACJ,OAAO,GAAG,eAAe,EACzB,SAAS,EAAE,cAAc,EACzB,OAAO,GACR,GAAG,OAAO,CAAC;IAEZ,OAAO;QACC,aAAa,CAAC,MAEnB;;gBACC,2BAA2B;gBAC3B,IAAI,SAAS,GAAG,cAAc,CAAC;gBAC/B,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;gBAChD,CAAC;gBAED,sCAAsC;gBACtC,OAAO,WAAW,CAAC,UAAU,CAAC;oBAC5B,SAAS;oBACT,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;oBAC7C,OAAO;iBACR,CAAC,CAAC;YACL,CAAC;SAAA;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/dweb-connect-client.js

@@ -0,0 +1,171 @@
+/**
+ * DWeb Connect client — initiates the popup/postMessage connect flow.
+ *
+ * This is the dapp-side counterpart to the wallet's `/dweb-connect` page.
+ * The wallet is opened as a popup window, and communication happens via
+ * `window.postMessage`. No relay server, QR codes, or PINs are needed.
+ *
+ * @module
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Open a wallet popup and run the DWeb Connect postMessage flow.
+ *
+ * Protocol:
+ * 1. Dapp opens `${walletUrl}/dweb-connect` as a popup.
+ * 2. Wallet sends `{ type: 'dweb-connect-loaded' }` when ready.
+ * 3. Dapp sends `{ type: 'dweb-connect-authorization-request', did, permissions }`.
+ * 4. Wallet shows consent UI, then sends back
+ *    `{ type: 'dweb-connect-authorization-response', delegateDid, grants }`.
+ * 5. Popup closes.
+ *
+ * @returns The delegate credentials, or `undefined` if the user denied.
+ * @throws If the popup is blocked, times out, or the wallet returns an error.
+ */
+function initClient(options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { walletUrl, did, permissionRequests, timeout = 300000, } = options;
+        if (typeof window === 'undefined') {
+            throw new Error('[@enbox/auth] DWeb Connect is only available in browser environments.');
+        }
+        // Open the wallet's DWeb Connect page as a popup.
+        const popupUrl = new URL('/dweb-connect', walletUrl).toString();
+        const popup = window.open(popupUrl, 'enbox-dweb-connect', 'width=500,height=700,menubar=no,toolbar=no,location=no,status=no');
+        if (!popup) {
+            throw new Error('[@enbox/auth] Popup blocked. Allow popups for this site to connect to a wallet.');
+        }
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                settled = true;
+                clearTimeout(timeoutId);
+                window.removeEventListener('message', onMessage);
+            };
+            // Set up timeout.
+            const timeoutId = setTimeout(() => {
+                if (!settled) {
+                    cleanup();
+                    try {
+                        popup.close();
+                    }
+                    catch ( /* best effort */_a) { /* best effort */ }
+                    reject(new Error('[@enbox/auth] DWeb Connect timed out waiting for wallet response.'));
+                }
+            }, timeout);
+            // Monitor popup closed without response (user closed the window).
+            const pollClosed = setInterval(() => {
+                if (popup.closed && !settled) {
+                    clearInterval(pollClosed);
+                    cleanup();
+                    resolve(undefined);
+                }
+            }, 500);
+            const onMessage = (event) => {
+                var _a;
+                // Validate origin matches the wallet URL.
+                const walletOrigin = new URL(walletUrl).origin;
+                if (event.origin !== walletOrigin) {
+                    return;
+                }
+                const { type } = (_a = event.data) !== null && _a !== void 0 ? _a : {};
+                if (type === 'dweb-connect-loaded') {
+                    // Wallet is ready — send the authorization request.
+                    popup.postMessage({
+                        type: 'dweb-connect-authorization-request',
+                        did,
+                        permissions: permissionRequests,
+                    }, walletOrigin);
+                    return;
+                }
+                if (type === 'dweb-connect-authorization-response') {
+                    clearInterval(pollClosed);
+                    cleanup();
+                    const { delegateDid, grants } = event.data;
+                    if (!delegateDid || !grants) {
+                        // User denied the request.
+                        resolve(undefined);
+                        return;
+                    }
+                    resolve({
+                        delegatePortableDid: delegateDid,
+                        delegateGrants: grants,
+                        connectedDid: did !== null && did !== void 0 ? did : delegateDid.uri,
+                    });
+                }
+            };
+            window.addEventListener('message', onMessage);
+        });
+    });
+}
+/**
+ * Probe whether a wallet supports a specific DID via a hidden iframe.
+ *
+ * Sends a `dweb-connect-support-request` message to the wallet and
+ * waits for a `dweb-connect-support-response`. Useful for checking
+ * multiple wallet URLs to find the one that manages a given DID.
+ *
+ * @param walletUrl - Base URL of the wallet to probe.
+ * @param did - The DID to check.
+ * @param timeout - Probe timeout in ms. Default: 5_000 (5 seconds).
+ * @returns `true` if the wallet manages the DID, `false` otherwise.
+ */
+function probeWalletSupport(walletUrl_1, did_1) {
+    return __awaiter(this, arguments, void 0, function* (walletUrl, did, timeout = 5000) {
+        if (typeof window === 'undefined') {
+            return false;
+        }
+        return new Promise((resolve) => {
+            const iframe = document.createElement('iframe');
+            iframe.style.display = 'none';
+            iframe.src = walletUrl;
+            let settled = false;
+            const cleanup = () => {
+                settled = true;
+                window.removeEventListener('message', onMessage);
+                try {
+                    document.body.removeChild(iframe);
+                }
+                catch ( /* best effort */_a) { /* best effort */ }
+            };
+            const timeoutId = setTimeout(() => {
+                if (!settled) {
+                    cleanup();
+                    resolve(false);
+                }
+            }, timeout);
+            const onMessage = (event) => {
+                var _a;
+                const walletOrigin = new URL(walletUrl).origin;
+                if (event.origin !== walletOrigin) {
+                    return;
+                }
+                const { type, supported } = (_a = event.data) !== null && _a !== void 0 ? _a : {};
+                if (type === 'dweb-connect-support-response') {
+                    clearTimeout(timeoutId);
+                    cleanup();
+                    resolve(!!supported);
+                }
+            };
+            window.addEventListener('message', onMessage);
+            iframe.addEventListener('load', () => {
+                var _a;
+                const walletOrigin = new URL(walletUrl).origin;
+                (_a = iframe.contentWindow) === null || _a === void 0 ? void 0 : _a.postMessage({
+                    type: 'dweb-connect-support-request',
+                    did,
+                }, walletOrigin);
+            });
+            document.body.appendChild(iframe);
+        });
+    });
+}
+export const DWebConnect = { initClient, probeWalletSupport };
+//# sourceMappingURL=dweb-connect-client.js.map

package/dist/esm/dweb-connect-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dweb-connect-client.js","sourceRoot":"","sources":["../../src/dweb-connect-client.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -1,2 +1,4 @@
 export * from './web-features.js';
+export { BrowserConnectHandler, DEFAULT_WALLETS } from './browser-connect-handler.js';
+export { DWebConnect } from './dweb-connect-client.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEtF,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/ui/wallet-selector.js

@@ -0,0 +1,313 @@
+/**
+ * Wallet selector modal — a self-contained, framework-agnostic UI component.
+ *
+ * Injected into the DOM as a Shadow DOM element to prevent style conflicts.
+ * Inspired by WalletConnect's Web3Modal pattern.
+ *
+ * @module
+ */
+/** Shows the wallet selector modal and resolves with the chosen wallet URL. */
+export function showWalletSelector(wallets) {
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        throw new Error('[@enbox/auth] Wallet selector is only available in browser environments.');
+    }
+    return new Promise((resolve, reject) => {
+        var _a, _b;
+        // Create the host element with Shadow DOM isolation.
+        const host = document.createElement('div');
+        host.id = 'enbox-wallet-selector';
+        const shadow = host.attachShadow({ mode: 'open' });
+        const cleanup = () => {
+            try {
+                document.body.removeChild(host);
+            }
+            catch ( /* best effort */_a) { /* best effort */ }
+        };
+        // Detect dark mode.
+        const isDark = (_a = window.matchMedia) === null || _a === void 0 ? void 0 : _a.call(window, '(prefers-color-scheme: dark)').matches;
+        // Build styles.
+        const style = document.createElement('style');
+        style.textContent = buildStyles(isDark);
+        shadow.appendChild(style);
+        // Build modal DOM.
+        const overlay = document.createElement('div');
+        overlay.className = 'overlay';
+        const modal = document.createElement('div');
+        modal.className = 'modal';
+        // Header
+        const header = document.createElement('div');
+        header.className = 'header';
+        const title = document.createElement('h2');
+        title.textContent = 'Connect Wallet';
+        const closeBtn = document.createElement('button');
+        closeBtn.className = 'close-btn';
+        closeBtn.innerHTML = '×';
+        closeBtn.addEventListener('click', () => {
+            cleanup();
+            reject(new Error('[@enbox/auth] Wallet selection cancelled.'));
+        });
+        header.appendChild(title);
+        header.appendChild(closeBtn);
+        modal.appendChild(header);
+        // Wallet list
+        const list = document.createElement('div');
+        list.className = 'wallet-list';
+        for (const wallet of wallets) {
+            const item = document.createElement('button');
+            item.className = 'wallet-item';
+            const icon = document.createElement('img');
+            icon.src = (_b = wallet.icon) !== null && _b !== void 0 ? _b : faviconUrl(wallet.url);
+            icon.alt = wallet.name;
+            icon.width = 32;
+            icon.height = 32;
+            icon.onerror = () => { icon.style.display = 'none'; };
+            const name = document.createElement('span');
+            name.className = 'wallet-name';
+            name.textContent = wallet.name;
+            const arrow = document.createElement('span');
+            arrow.className = 'arrow';
+            arrow.textContent = '\u203A'; // ›
+            item.appendChild(icon);
+            item.appendChild(name);
+            item.appendChild(arrow);
+            item.addEventListener('click', () => {
+                cleanup();
+                resolve(wallet.url);
+            });
+            list.appendChild(item);
+        }
+        modal.appendChild(list);
+        // Separator
+        const sep = document.createElement('div');
+        sep.className = 'separator';
+        const sepLine1 = document.createElement('div');
+        sepLine1.className = 'sep-line';
+        const sepText = document.createElement('span');
+        sepText.textContent = 'or';
+        const sepLine2 = document.createElement('div');
+        sepLine2.className = 'sep-line';
+        sep.appendChild(sepLine1);
+        sep.appendChild(sepText);
+        sep.appendChild(sepLine2);
+        modal.appendChild(sep);
+        // Custom URL input
+        const inputGroup = document.createElement('div');
+        inputGroup.className = 'input-group';
+        const input = document.createElement('input');
+        input.type = 'url';
+        input.placeholder = 'Enter wallet URL...';
+        input.className = 'url-input';
+        const goBtn = document.createElement('button');
+        goBtn.className = 'go-btn';
+        goBtn.textContent = 'Connect';
+        goBtn.disabled = true;
+        input.addEventListener('input', () => {
+            goBtn.disabled = !isValidUrl(input.value);
+        });
+        input.addEventListener('keydown', (e) => {
+            if (e.key === 'Enter' && isValidUrl(input.value)) {
+                cleanup();
+                resolve(normalizeUrl(input.value));
+            }
+        });
+        goBtn.addEventListener('click', () => {
+            if (isValidUrl(input.value)) {
+                cleanup();
+                resolve(normalizeUrl(input.value));
+            }
+        });
+        inputGroup.appendChild(input);
+        inputGroup.appendChild(goBtn);
+        modal.appendChild(inputGroup);
+        // Close on overlay click.
+        overlay.addEventListener('click', (e) => {
+            if (e.target === overlay) {
+                cleanup();
+                reject(new Error('[@enbox/auth] Wallet selection cancelled.'));
+            }
+        });
+        // Close on Escape.
+        const onKeydown = (e) => {
+            if (e.key === 'Escape') {
+                document.removeEventListener('keydown', onKeydown);
+                cleanup();
+                reject(new Error('[@enbox/auth] Wallet selection cancelled.'));
+            }
+        };
+        document.addEventListener('keydown', onKeydown);
+        overlay.appendChild(modal);
+        shadow.appendChild(overlay);
+        document.body.appendChild(host);
+        // Focus the input for keyboard-first users.
+        input.focus();
+    });
+}
+// ─── Helpers ─────────────────────────────────────────────────────
+function faviconUrl(walletUrl) {
+    return `https://t3.gstatic.com/faviconV2?client=SOCIAL&type=FAVICON&fallback_opts=TYPE,SIZE,URL&url=${walletUrl}&size=128`;
+}
+function isValidUrl(value) {
+    try {
+        const url = new URL(value.includes('://') ? value : `https://${value}`);
+        return url.protocol === 'https:' || url.protocol === 'http:';
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function normalizeUrl(value) {
+    if (!value.includes('://')) {
+        value = `https://${value}`;
+    }
+    const url = new URL(value);
+    // Return origin only (strip path/trailing slash).
+    return url.origin;
+}
+function buildStyles(isDark) {
+    const bg = isDark ? '#1a1a2e' : '#ffffff';
+    const text = isDark ? '#e0e0e0' : '#1a1a2e';
+    const muted = isDark ? '#888' : '#666';
+    const border = isDark ? '#333' : '#e0e0e0';
+    const itemBg = isDark ? '#16213e' : '#f8f9fa';
+    const itemHover = isDark ? '#0f3460' : '#e9ecef';
+    const accent = isDark ? '#4a9eff' : '#0066cc';
+    const overlayBg = 'rgba(0, 0, 0, 0.5)';
+    return `
+    * { box-sizing: border-box; margin: 0; padding: 0; }
+
+    .overlay {
+      position: fixed;
+      inset: 0;
+      z-index: 2147483647;
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      background: ${overlayBg};
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      animation: fadeIn 0.15s ease-out;
+    }
+
+    @keyframes fadeIn {
+      from { opacity: 0; }
+      to { opacity: 1; }
+    }
+
+    @keyframes slideUp {
+      from { transform: translateY(20px); opacity: 0; }
+      to { transform: translateY(0); opacity: 1; }
+    }
+
+    .modal {
+      background: ${bg};
+      color: ${text};
+      border-radius: 16px;
+      width: 380px;
+      max-width: 90vw;
+      max-height: 80vh;
+      overflow-y: auto;
+      padding: 24px;
+      box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+      animation: slideUp 0.2s ease-out;
+    }
+
+    .header {
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      margin-bottom: 20px;
+    }
+
+    h2 {
+      font-size: 18px;
+      font-weight: 600;
+    }
+
+    .close-btn {
+      background: none;
+      border: none;
+      font-size: 24px;
+      cursor: pointer;
+      color: ${muted};
+      padding: 4px 8px;
+      border-radius: 8px;
+      line-height: 1;
+    }
+    .close-btn:hover { color: ${text}; background: ${itemBg}; }
+
+    .wallet-list {
+      display: flex;
+      flex-direction: column;
+      gap: 8px;
+    }
+
+    .wallet-item {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      padding: 12px 16px;
+      background: ${itemBg};
+      border: 1px solid ${border};
+      border-radius: 12px;
+      cursor: pointer;
+      font-size: 15px;
+      color: ${text};
+      transition: background 0.15s;
+      width: 100%;
+      text-align: left;
+    }
+    .wallet-item:hover { background: ${itemHover}; }
+
+    .wallet-name { flex: 1; font-weight: 500; }
+
+    .arrow {
+      font-size: 20px;
+      color: ${muted};
+    }
+
+    .separator {
+      display: flex;
+      align-items: center;
+      gap: 12px;
+      margin: 20px 0;
+      color: ${muted};
+      font-size: 13px;
+    }
+    .sep-line { flex: 1; height: 1px; background: ${border}; }
+
+    .input-group {
+      display: flex;
+      gap: 8px;
+    }
+
+    .url-input {
+      flex: 1;
+      padding: 10px 14px;
+      border: 1px solid ${border};
+      border-radius: 10px;
+      font-size: 14px;
+      background: ${itemBg};
+      color: ${text};
+      outline: none;
+    }
+    .url-input:focus { border-color: ${accent}; }
+    .url-input::placeholder { color: ${muted}; }
+
+    .go-btn {
+      padding: 10px 18px;
+      border: none;
+      border-radius: 10px;
+      background: ${accent};
+      color: #fff;
+      font-size: 14px;
+      font-weight: 500;
+      cursor: pointer;
+      white-space: nowrap;
+    }
+    .go-btn:disabled {
+      opacity: 0.4;
+      cursor: not-allowed;
+    }
+    .go-btn:not(:disabled):hover { filter: brightness(1.1); }
+  `;
+}
+//# sourceMappingURL=wallet-selector.js.map

package/dist/esm/ui/wallet-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-selector.js","sourceRoot":"","sources":["../../../src/ui/wallet-selector.ts"],"names":[],"mappings":"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"}

package/dist/types/browser-connect-handler.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Browser connect handler for `@enbox/auth`.
+ *
+ * Implements the {@link ConnectHandler} interface using browser-native
+ * DWeb Connect (popup + postMessage) with a wallet selector modal.
+ *
+ * @module
+ */
+import type { ConnectHandler } from '@enbox/auth';
+/** A wallet entry shown in the wallet selector modal. */
+export interface WalletOption {
+    /** Display name (e.g. "Enbox Wallet"). */
+    name: string;
+    /** Base URL of the wallet app (e.g. "https://wallet.enbox.org"). */
+    url: string;
+    /** Optional icon URL. If omitted, the wallet's favicon is used. */
+    icon?: string;
+}
+/** Default wallets shown in the selector when no overrides are provided. */
+export declare const DEFAULT_WALLETS: WalletOption[];
+/** Options for creating a BrowserConnectHandler. */
+export interface BrowserConnectHandlerOptions {
+    /**
+     * Known wallets shown in the wallet selector modal.
+     * If omitted, {@link DEFAULT_WALLETS} is used.
+     */
+    wallets?: WalletOption[];
+    /**
+     * Explicit wallet URL. If provided, the wallet selector is skipped
+     * and this URL is used directly.
+     */
+    walletUrl?: string;
+    /**
+     * Timeout in milliseconds for the wallet popup flow.
+     * @default 300_000 (5 minutes)
+     */
+    timeout?: number;
+}
+/**
+ * Create a browser-native connect handler using DWeb Connect
+ * (popup + postMessage).
+ *
+ * This handler:
+ * 1. Shows a wallet selector modal (or uses a provided walletUrl).
+ * 2. Opens the selected wallet as a popup window.
+ * 3. Runs the DWeb Connect postMessage protocol.
+ * 4. Returns the delegate credentials on success.
+ *
+ * @example
+ * ```ts
+ * import { AuthManager } from '@enbox/auth';
+ * import { BrowserConnectHandler } from '@enbox/browser';
+ *
+ * const auth = await AuthManager.create({
+ *   connectHandler: BrowserConnectHandler(),
+ * });
+ *
+ * const session = await auth.connect({ protocols: [NotesProtocol] });
+ * ```
+ */
+export declare function BrowserConnectHandler(options?: BrowserConnectHandlerOptions): ConnectHandler;
+//# sourceMappingURL=browser-connect-handler.d.ts.map

package/dist/types/browser-connect-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-connect-handler.d.ts","sourceRoot":"","sources":["../../src/browser-connect-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAKjE,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IAEb,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;IAEZ,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,EAAE,YAAY,EAEzC,CAAC;AAEF,oDAAoD;AACpD,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,cAAc,CAyBhB"}