@pasosdejesus/m 0.15.0

package/dist/blockchain/deployments.d.ts

@@ -0,0 +1,40 @@
+export interface Deployment {
+    contract: string;
+    address: string;
+    chainId: number;
+    network: string;
+    transactionHash: string;
+    deployedAt: string;
+}
+export interface DeploymentOptions {
+    /** Contract name, e.g. "PasosDeJesusCredentials". Enables hierarchical path. */
+    contract?: string;
+    /** Contract version, e.g. "v3". Required if contract is provided. */
+    version?: string;
+}
+/**
+ * Read a single deployment by network name.
+ *
+ * Paths tried (in order):
+ *   1. {deploymentsDir}/{contract}/{version}/{network}.json  (if contract + version)
+ *   2. {deploymentsDir}/{network}.json                        (flat fallback)
+ *
+ * @param network e.g. "celoSepolia", "baseSepolia", "celo", "base"
+ * @param deploymentsDir Absolute or relative path to the deployments directory.
+ *   Typically: path.join(projectRoot, 'apps', 'hardhat', 'deployments')
+ */
+export declare function readDeployment(network: string, deploymentsDir: string, opts?: DeploymentOptions): Deployment | null;
+/**
+ * Get contract address for a specific network.
+ * Falls back to environment variable if deployment file not found.
+ */
+export declare function getContractAddress(network: string, envVar: string, deploymentsDir: string, opts?: DeploymentOptions): `0x${string}` | null;
+/**
+ * Get Celo contract address.
+ */
+export declare function getCeloCredentialsAddress(deploymentsDir: string, opts?: DeploymentOptions): `0x${string}` | null;
+/**
+ * Get Base contract address.
+ */
+export declare function getBaseCredentialsAddress(deploymentsDir: string, opts?: DeploymentOptions): `0x${string}` | null;
+//# sourceMappingURL=deployments.d.ts.map

package/dist/blockchain/deployments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments.d.ts","sourceRoot":"","sources":["../../src/blockchain/deployments.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,iBAAiB,GACvB,UAAU,GAAG,IAAI,CAenB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,iBAAiB,GACvB,KAAK,MAAM,EAAE,GAAG,IAAI,CAQtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,iBAAiB,GACvB,KAAK,MAAM,EAAE,GAAG,IAAI,CAGtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,iBAAiB,GACvB,KAAK,MAAM,EAAE,GAAG,IAAI,CAGtB"}

package/dist/blockchain/deployments.js

@@ -0,0 +1,64 @@
+// src/blockchain/deployments.ts
+// Read contract addresses from deployment JSON files.
+//
+// Deployment files support two layouts:
+//   Flat:    apps/hardhat/deployments/{network}.json
+//   Hierarchical: apps/hardhat/deployments/{Contract}/{Version}/{network}.json
+//
+// When contract + version are provided, the hierarchical path is tried first,
+// falling back to the flat path.
+import fs from 'fs';
+import path from 'path';
+/**
+ * Read a single deployment by network name.
+ *
+ * Paths tried (in order):
+ *   1. {deploymentsDir}/{contract}/{version}/{network}.json  (if contract + version)
+ *   2. {deploymentsDir}/{network}.json                        (flat fallback)
+ *
+ * @param network e.g. "celoSepolia", "baseSepolia", "celo", "base"
+ * @param deploymentsDir Absolute or relative path to the deployments directory.
+ *   Typically: path.join(projectRoot, 'apps', 'hardhat', 'deployments')
+ */
+export function readDeployment(network, deploymentsDir, opts) {
+    const { contract, version } = opts || {};
+    // 1. Hierarchical path
+    if (contract && version) {
+        const hierFile = path.join(deploymentsDir, contract, version, `${network}.json`);
+        if (fs.existsSync(hierFile)) {
+            return JSON.parse(fs.readFileSync(hierFile, 'utf-8'));
+        }
+    }
+    // 2. Flat fallback
+    const flatFile = path.join(deploymentsDir, `${network}.json`);
+    if (!fs.existsSync(flatFile))
+        return null;
+    return JSON.parse(fs.readFileSync(flatFile, 'utf-8'));
+}
+/**
+ * Get contract address for a specific network.
+ * Falls back to environment variable if deployment file not found.
+ */
+export function getContractAddress(network, envVar, deploymentsDir, opts) {
+    const deployment = readDeployment(network, deploymentsDir, opts);
+    if (deployment)
+        return deployment.address;
+    const addr = process.env[envVar];
+    if (addr)
+        return addr;
+    return null;
+}
+/**
+ * Get Celo contract address.
+ */
+export function getCeloCredentialsAddress(deploymentsDir, opts) {
+    const network = process.env.NEXT_PUBLIC_NETWORK === 'celo' ? 'celo' : 'celoSepolia';
+    return getContractAddress(network, 'NEXT_PUBLIC_PDJCREDENTIALS_CELO_ADDRESS', deploymentsDir, opts);
+}
+/**
+ * Get Base contract address.
+ */
+export function getBaseCredentialsAddress(deploymentsDir, opts) {
+    const network = process.env.NEXT_PUBLIC_BASE_NETWORK === 'base' ? 'base' : 'baseSepolia';
+    return getContractAddress(network, 'NEXT_PUBLIC_PDJCREDENTIALS_BASE_ADDRESS', deploymentsDir, opts);
+}

package/dist/debug/DebugConsole.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Floating debug console for MiniPay and embedded browsers.
+ *
+ * Renders as a small `>_` button in the bottom-right corner when enabled.
+ * Clicking opens a log viewer with copy, clear, and minimize controls.
+ *
+ * Enabled via:
+ * - URL parameter `?debug=1` (recommended for testing)
+ * - Environment variable `NEXT_PUBLIC_M_DEBUGGER_CONSOLE=1` (build-time)
+ *
+ * To use, render once in your root client layout:
+ *
+ * ```tsx
+ * import { DebugConsole } from '@pasosdejesus/m/debug'
+ *
+ * export default function ClientLayout({ children }) {
+ *   return <>{children}<DebugConsole /></>
+ * }
+ * ```
+ */
+export declare function DebugConsole(): import("react").JSX.Element | null;
+//# sourceMappingURL=DebugConsole.d.ts.map

package/dist/debug/DebugConsole.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DebugConsole.d.ts","sourceRoot":"","sources":["../../src/debug/DebugConsole.tsx"],"names":[],"mappings":"AAkCA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,uCAyG3B"}

package/dist/debug/DebugConsole.js

@@ -0,0 +1,79 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { useLogger } from './useLogger.js';
+function getLevelColor(level) {
+    switch (level) {
+        case 'error':
+            return 'border-red-500 text-red-400';
+        case 'success':
+            return 'border-green-500 text-green-400';
+        case 'warning':
+            return 'border-yellow-500 text-yellow-400';
+        default:
+            return 'border-blue-500 text-blue-300';
+    }
+}
+function getLevelIcon(level) {
+    switch (level) {
+        case 'error':
+            return '❌';
+        case 'success':
+            return '✅';
+        case 'warning':
+            return '⚠️';
+        case 'debug':
+            return '🔍';
+        default:
+            return '📢';
+    }
+}
+/**
+ * Floating debug console for MiniPay and embedded browsers.
+ *
+ * Renders as a small `>_` button in the bottom-right corner when enabled.
+ * Clicking opens a log viewer with copy, clear, and minimize controls.
+ *
+ * Enabled via:
+ * - URL parameter `?debug=1` (recommended for testing)
+ * - Environment variable `NEXT_PUBLIC_M_DEBUGGER_CONSOLE=1` (build-time)
+ *
+ * To use, render once in your root client layout:
+ *
+ * ```tsx
+ * import { DebugConsole } from '@pasosdejesus/m/debug'
+ *
+ * export default function ClientLayout({ children }) {
+ *   return <>{children}<DebugConsole /></>
+ * }
+ * ```
+ */
+export function DebugConsole() {
+    const { logs, logger, isEnabled } = useLogger();
+    const [isVisible, setIsVisible] = useState(false);
+    const [isMinimized, setIsMinimized] = useState(false);
+    const [, setForceUpdate] = useState(0);
+    // Force refresh to capture new logs
+    useEffect(() => {
+        if (!isEnabled)
+            return;
+        const interval = setInterval(() => {
+            setForceUpdate((prev) => prev + 1);
+        }, 500);
+        return () => clearInterval(interval);
+    }, [isEnabled]);
+    const currentLogs = isEnabled ? logger.getLogs() : logs;
+    if (!isEnabled)
+        return null;
+    if (!isVisible) {
+        return (_jsx("button", { onClick: () => setIsVisible(true), className: "fixed bottom-4 right-4 z-50 bg-black/80 text-white p-2 rounded-full shadow-lg hover:bg-black transition-colors", title: "Open debug console", children: _jsx("span", { className: "text-lg font-mono font-bold", children: ">_" }) }));
+    }
+    const copyLogs = () => {
+        const text = currentLogs
+            .map((log) => `[${log.timestamp}]${log.source ? `[${log.source}]` : ''}${getLevelIcon(log.level)}${log.message}`)
+            .join('\n');
+        navigator.clipboard.writeText(text);
+        logger.success('Logs copied to clipboard', 'DebugConsole');
+    };
+    return (_jsxs("div", { className: `fixed bottom-4 right-4 z-50 bg-black/95 text-white rounded-lg shadow-xl overflow-hidden transition-all ${isMinimized ? 'w-80' : 'w-96'}`, children: [_jsxs("div", { className: "flex justify-between items-center p-3 bg-gray-800 border-b border-gray-700", children: [_jsxs("span", { className: "text-sm font-mono font-bold flex items-center gap-2", children: [_jsx("span", { children: ">_" }), "Debug Console", _jsx("span", { className: "text-[10px] bg-green-700 px-1 rounded", children: "ACTIVE" })] }), _jsxs("div", { className: "flex gap-2", children: [_jsx("button", { onClick: copyLogs, className: "text-gray-400 hover:text-blue-400", title: "Copy logs", children: "\uD83D\uDCCB" }), _jsx("button", { onClick: () => logger.clear(), className: "text-gray-400 hover:text-yellow-400", title: "Clear logs", children: "\uD83D\uDDD1" }), _jsx("button", { onClick: () => setIsMinimized(!isMinimized), className: "text-gray-400 hover:text-white", children: isMinimized ? '▲' : '▼' }), _jsx("button", { onClick: () => setIsVisible(false), className: "text-gray-400 hover:text-white text-xl leading-none", children: "\u2715" })] })] }), !isMinimized && (_jsxs("div", { className: "h-80 overflow-y-auto p-3 space-y-1 font-mono text-xs bg-black/95", children: [currentLogs.length === 0 && (_jsx("div", { className: "text-gray-500 text-center py-4", children: "No logs yet. Actions will generate messages here." })), currentLogs.map((log, i) => (_jsxs("div", { className: `border-l-2 pl-2 ${getLevelColor(log.level)}`, children: [_jsxs("span", { className: "text-gray-500", children: ["[", log.timestamp, "]"] }), log.source && (_jsxs("span", { className: "text-gray-600 ml-1", children: ["[", log.source, "]"] })), _jsx("span", { className: "ml-1", children: getLevelIcon(log.level) }), _jsx("span", { className: "ml-1", children: log.message })] }, i)))] }))] }));
+}

package/dist/debug/Logger.d.ts

@@ -0,0 +1,38 @@
+export type LogLevel = 'info' | 'success' | 'error' | 'warning' | 'debug';
+export interface LogEntry {
+    timestamp: string;
+    message: string;
+    level: LogLevel;
+    source?: string;
+}
+type Listener = (logs: LogEntry[]) => void;
+/**
+ * Universal logging system.
+ *
+ * Always writes to console.log/console.error (browser DevTools).
+ * Optionally activates a floating in-app console via URL param (?debug=1)
+ * or environment variable `NEXT_PUBLIC_M_DEBUGGER_CONSOLE=1`.
+ *
+ * Buffers up to 500 log entries and notifies subscribers in real-time
+ * when the floating console is enabled.
+ */
+export declare class Logger {
+    private logs;
+    private listeners;
+    private floatingConsoleEnabled;
+    constructor();
+    private addLog;
+    info(message: string, source?: string): void;
+    success(message: string, source?: string): void;
+    error(message: string, source?: string): void;
+    warning(message: string, source?: string): void;
+    debug(message: string, source?: string): void;
+    getLogs(): LogEntry[];
+    clear(): void;
+    subscribe(listener: Listener): () => void;
+    isFloatingConsoleEnabled(): boolean;
+}
+/** Singleton logger instance */
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/dist/debug/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/debug/Logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;AAEzE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,QAAQ,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,IAAI,CAAA;AAE1C;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,sBAAsB,CAAiB;;IAe/C,OAAO,CAAC,MAAM;IAiCd,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAIrC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAIxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAItC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAIxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IAMtC,OAAO,IAAI,QAAQ,EAAE;IAIrB,KAAK;IAOL,SAAS,CAAC,QAAQ,EAAE,QAAQ;IAO5B,wBAAwB,IAAI,OAAO;CAGpC;AAED,gCAAgC;AAChC,eAAO,MAAM,MAAM,QAAe,CAAA"}

package/dist/debug/Logger.js

@@ -0,0 +1,94 @@
+/**
+ * Universal logging system.
+ *
+ * Always writes to console.log/console.error (browser DevTools).
+ * Optionally activates a floating in-app console via URL param (?debug=1)
+ * or environment variable `NEXT_PUBLIC_M_DEBUGGER_CONSOLE=1`.
+ *
+ * Buffers up to 500 log entries and notifies subscribers in real-time
+ * when the floating console is enabled.
+ */
+export class Logger {
+    logs = [];
+    listeners = [];
+    floatingConsoleEnabled = false;
+    constructor() {
+        if (typeof window !== 'undefined') {
+            const urlParams = new URLSearchParams(window.location.search);
+            const debugParam = urlParams.get('debug');
+            if (debugParam === '1') {
+                this.floatingConsoleEnabled = true;
+            }
+            else {
+                this.floatingConsoleEnabled =
+                    process.env.NEXT_PUBLIC_M_DEBUGGER_CONSOLE === '1';
+            }
+        }
+    }
+    addLog(message, level, source) {
+        const entry = {
+            timestamp: new Date().toLocaleTimeString(),
+            message,
+            level,
+            source,
+        };
+        this.logs.push(entry);
+        if (this.logs.length > 500) {
+            this.logs = this.logs.slice(-500);
+        }
+        const prefix = `[${entry.timestamp}]${source ? ` [${source}]` : ''}`;
+        switch (level) {
+            case 'error':
+                console.error(prefix, message);
+                break;
+            case 'warning':
+                console.warn(prefix, message);
+                break;
+            case 'success':
+                console.log(`✅ ${prefix}`, message);
+                break;
+            default:
+                console.log(`📢 ${prefix}`, message);
+        }
+        if (this.floatingConsoleEnabled) {
+            this.listeners.forEach((listener) => listener([...this.logs]));
+        }
+    }
+    info(message, source) {
+        this.addLog(message, 'info', source);
+    }
+    success(message, source) {
+        this.addLog(message, 'success', source);
+    }
+    error(message, source) {
+        this.addLog(message, 'error', source);
+    }
+    warning(message, source) {
+        this.addLog(message, 'warning', source);
+    }
+    debug(message, source) {
+        if (process.env.NODE_ENV === 'development') {
+            this.addLog(message, 'debug', source);
+        }
+    }
+    getLogs() {
+        return [...this.logs];
+    }
+    clear() {
+        this.logs = [];
+        if (this.floatingConsoleEnabled) {
+            this.listeners.forEach((listener) => listener([]));
+        }
+    }
+    subscribe(listener) {
+        this.listeners.push(listener);
+        return () => {
+            this.listeners = this.listeners.filter((l) => l !== listener);
+        };
+    }
+    isFloatingConsoleEnabled() {
+        return this.floatingConsoleEnabled;
+    }
+}
+/** Singleton logger instance */
+export const logger = new Logger();

package/dist/debug/index.d.ts

@@ -0,0 +1,6 @@
+export type { LogLevel, LogEntry } from './Logger.js';
+export { Logger, logger } from './Logger.js';
+export { useLogger } from './useLogger.js';
+export { DebugConsole } from './DebugConsole.js';
+export { safeStringify, debugLog } from './utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/debug/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/debug/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/debug/index.js

@@ -0,0 +1,4 @@
+export { Logger, logger } from './Logger.js';
+export { useLogger } from './useLogger.js';
+export { DebugConsole } from './DebugConsole.js';
+export { safeStringify, debugLog } from './utils.js';

package/dist/debug/useLogger.d.ts

@@ -0,0 +1,14 @@
+import type { LogEntry } from './Logger.js';
+/**
+ * React hook for subscribing to Logger updates from client components.
+ *
+ * Must be imported only from 'use client' components.
+ * Returns { logs, logger, isEnabled } where `logs` updates in real-time
+ * when the floating debug console is enabled.
+ */
+export declare function useLogger(): {
+    logs: LogEntry[];
+    logger: import("./Logger.js").Logger;
+    isEnabled: boolean;
+};
+//# sourceMappingURL=useLogger.d.ts.map

package/dist/debug/useLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLogger.d.ts","sourceRoot":"","sources":["../../src/debug/useLogger.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C;;;;;;GAMG;AACH,wBAAgB,SAAS;;;;EAgBxB"}

package/dist/debug/useLogger.js

@@ -0,0 +1,23 @@
+'use client';
+import { useState, useEffect } from 'react';
+import { logger } from './Logger.js';
+/**
+ * React hook for subscribing to Logger updates from client components.
+ *
+ * Must be imported only from 'use client' components.
+ * Returns { logs, logger, isEnabled } where `logs` updates in real-time
+ * when the floating debug console is enabled.
+ */
+export function useLogger() {
+    const [logs, setLogs] = useState([]);
+    const [isEnabled, setIsEnabled] = useState(false);
+    useEffect(() => {
+        setLogs(logger.getLogs());
+        setIsEnabled(logger.isFloatingConsoleEnabled());
+        const unsubscribe = logger.subscribe((newLogs) => {
+            setLogs(newLogs);
+        });
+        return unsubscribe;
+    }, []);
+    return { logs, logger, isEnabled };
+}

package/dist/debug/utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Serializes an object safely for logging.
+ * Handles circular references and non-serializable values.
+ */
+export declare function safeStringify(obj: unknown, maxLength?: number): string;
+/**
+ * Prints a labeled debug object to the console.
+ */
+export declare function debugLog(label: string, data: unknown): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/debug/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/debug/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,SAAM,GAAG,MAAM,CAsCnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAE3D"}

package/dist/debug/utils.js

@@ -0,0 +1,53 @@
+/**
+ * Serializes an object safely for logging.
+ * Handles circular references and non-serializable values.
+ */
+export function safeStringify(obj, maxLength = 500) {
+    if (obj === null)
+        return 'null';
+    if (obj === undefined)
+        return 'undefined';
+    if (typeof obj === 'string')
+        return obj;
+    if (typeof obj === 'number')
+        return obj.toString();
+    if (typeof obj === 'boolean')
+        return obj.toString();
+    if (typeof obj === 'function')
+        return '[Function]';
+    if (obj instanceof Error) {
+        return `${obj.name}: ${obj.message}${obj.stack ? `\n${obj.stack}` : ''}`;
+    }
+    if (typeof obj === 'object' && obj !== null && 'toJSON' in obj && typeof obj.toJSON === 'function') {
+        try {
+            return safeStringify(obj.toJSON(), maxLength);
+        }
+        catch {
+            return '[Circular or Invalid toJSON]';
+        }
+    }
+    try {
+        const seen = new WeakSet();
+        const serialized = JSON.stringify(obj, (_key, value) => {
+            if (typeof value === 'object' && value !== null) {
+                if (seen.has(value))
+                    return '[Circular]';
+                seen.add(value);
+            }
+            return value;
+        }, 2);
+        if (serialized.length > maxLength) {
+            return serialized.substring(0, maxLength) + '... [truncated]';
+        }
+        return serialized;
+    }
+    catch (err) {
+        return `[Unable to serialize: ${err}]`;
+    }
+}
+/**
+ * Prints a labeled debug object to the console.
+ */
+export function debugLog(label, data) {
+    console.log(`[DEBUG] ${label}:`, safeStringify(data));
+}

package/dist/e2e/assertions.d.ts

@@ -0,0 +1,5 @@
+export declare function resetFailures(): void;
+export declare function ok(msg: string): void;
+export declare function fail(msg: string): void;
+export declare function summary(t0: number): number;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/e2e/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/e2e/assertions.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,wBAAgB,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpC;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAGtC;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAI1C"}

package/dist/e2e/assertions.js

@@ -0,0 +1,18 @@
+// Assertion helpers for E2E tests — zero dependencies, pure Node.js
+// Used by both Puppeteer specs and smoke (HTTP) tests.
+let _failures = 0;
+export function resetFailures() {
+    _failures = 0;
+}
+export function ok(msg) {
+    console.log(`  ✅ ${msg}`);
+}
+export function fail(msg) {
+    console.error(`  ❌ ${msg}`);
+    _failures++;
+}
+export function summary(t0) {
+    const elapsed = performance.now() - t0;
+    console.log(`\n${_failures === 0 ? '✅' : '❌'} ${_failures} failures | ${elapsed.toFixed(0)}ms`);
+    return _failures;
+}

package/dist/e2e/browser.d.ts

@@ -0,0 +1,37 @@
+export interface E2EPage {
+    goto(url: string, opts?: {
+        waitUntil?: string;
+        timeout?: number;
+    }): Promise<any>;
+    close(): Promise<void>;
+    cookies(): Promise<Array<{
+        name: string;
+        value: string;
+    }>>;
+    evaluate(fn: any, ...args: any[]): Promise<any>;
+    evaluateOnNewDocument(fn: any, ...args: any[]): Promise<void>;
+    setDefaultTimeout(ms: number): void;
+    on(event: string, handler: (...args: any[]) => void): void;
+    $: (selector: string) => Promise<any>;
+    $$: (selector: string) => Promise<any[]>;
+    waitForFunction(fn: any, opts?: any): Promise<any>;
+    waitForNavigation(opts?: any): Promise<any>;
+    createCDPSession(): Promise<any>;
+    evaluateHandle(fn: any): Promise<any>;
+}
+export interface E2EBrowser {
+    newPage(): Promise<E2EPage>;
+    close(): Promise<void>;
+    createBrowserContext(): Promise<E2EBrowserContext>;
+}
+export interface E2EBrowserContext {
+    newPage(): Promise<E2EPage>;
+    close(): Promise<void>;
+}
+export declare function findChrome(): string;
+export declare function launchBrowser(headless?: boolean): Promise<E2EBrowser>;
+export declare function newPage(browser: E2EBrowser, address: string, timeout?: number, useEIP6963?: boolean): Promise<E2EPage>;
+export declare function newIncognitoContext(browser: any): Promise<E2EBrowserContext>;
+export declare function newIncognitoPage(ctx: E2EBrowserContext, address: string, timeout?: number, useEIP6963?: boolean): Promise<E2EPage>;
+export declare function clearBrowserCache(page: E2EPage): Promise<void>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/e2e/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/e2e/browser.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAChF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAC1D,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/C,qBAAqB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1D,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;IACrC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACxC,eAAe,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAClD,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC3C,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACnD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,wBAAgB,UAAU,IAAI,MAAM,CASnC;AAcD,wBAAsB,aAAa,CAAC,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAejF;AAED,wBAAsB,OAAO,CAC3B,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAc,EACvB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,OAAO,CAAC,CAsBlB;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAElF;AAID,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAc,EACvB,UAAU,GAAE,OAAe,GAC1B,OAAO,CAAC,OAAO,CAAC,CAqBlB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE"}

package/dist/e2e/browser.js

@@ -0,0 +1,97 @@
+// Browser launcher for E2E tests — Puppeteer on OpenBSD/adJ
+// puppeteer-core must be installed by the consumer project (devDependency).
+// We use fully dynamic import so m itself doesn't require puppeteer-core.
+import * as fs from 'fs';
+export function findChrome() {
+    if (process.env.CHROME_PATH && fs.existsSync(process.env.CHROME_PATH))
+        return process.env.CHROME_PATH;
+    // OpenBSD/adJ paths
+    const paths = ['/usr/local/bin/chrome', '/usr/local/bin/chromium', '/usr/local/bin/chromium-browser'];
+    for (const p of paths) {
+        if (fs.existsSync(p))
+            return p;
+    }
+    throw new Error('Chrome not found. Set CHROME_PATH or install chromium.');
+}
+async function loadPuppeteer() {
+    try {
+        return await Function('return import("puppeteer-core")')();
+    }
+    catch {
+        throw new Error('puppeteer-core is not installed. Install it in your project:\n' +
+            '  pnpm add -D puppeteer-core\n' +
+            'Or use --smoke for HTTP-only tests.');
+    }
+}
+export async function launchBrowser(headless = true) {
+    const puppeteer = await loadPuppeteer();
+    return puppeteer.launch({
+        executablePath: findChrome(),
+        defaultViewport: { width: 1240, height: 800 },
+        headless,
+        args: [
+            '--no-sandbox',
+            '--disable-setuid-sandbox',
+            '--disable-dev-shm-usage',
+            '--disable-gpu',
+            '--ozone-platform=headless',
+        ],
+    });
+}
+export async function newPage(browser, address, timeout = 60000, useEIP6963 = false) {
+    const page = await browser.newPage();
+    const { ethereumMockCode, eip6963MockCode } = await import('./wallet-mock.js');
+    const mockFn = useEIP6963 ? eip6963MockCode : ethereumMockCode;
+    await page.evaluateOnNewDocument(mockFn({ address }));
+    // Re-dispatch EIP-6963 event after page load so wagmi catches it
+    if (useEIP6963) {
+        page.on('load', async () => {
+            await page.evaluate(() => {
+                const p = window.ethereum;
+                if (!p)
+                    return;
+                window.dispatchEvent(new CustomEvent('eip6963:announceProvider', {
+                    detail: {
+                        info: { uuid: crypto.randomUUID(), name: 'MockWallet', icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>', rdns: 'com.mock.wallet' },
+                        provider: p
+                    }
+                }));
+            });
+        });
+    }
+    page.setDefaultTimeout(timeout);
+    return page;
+}
+export async function newIncognitoContext(browser) {
+    return browser.createBrowserContext();
+}
+// Create a page from an incognito context with ethereum mock injected.
+// Use this instead of ctx.newPage() directly.
+export async function newIncognitoPage(ctx, address, timeout = 60000, useEIP6963 = false) {
+    const page = await ctx.newPage();
+    const { ethereumMockCode, eip6963MockCode } = await import('./wallet-mock.js');
+    const mockFn = useEIP6963 ? eip6963MockCode : ethereumMockCode;
+    await page.evaluateOnNewDocument(mockFn({ address }));
+    if (useEIP6963) {
+        page.on('load', async () => {
+            await page.evaluate(() => {
+                const p = window.ethereum;
+                if (!p)
+                    return;
+                window.dispatchEvent(new CustomEvent('eip6963:announceProvider', {
+                    detail: {
+                        info: { uuid: crypto.randomUUID(), name: 'MockWallet', icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>', rdns: 'com.mock.wallet' },
+                        provider: p
+                    }
+                }));
+            });
+        });
+    }
+    page.setDefaultTimeout(timeout);
+    return page;
+}
+export async function clearBrowserCache(page) {
+    const cdp = await page.createCDPSession();
+    await cdp.send('Network.clearBrowserCache');
+    await cdp.send('Network.clearBrowserCookies');
+}