@pasosdejesus/m 0.15.0

package/dist/e2e/env.d.ts

@@ -0,0 +1,18 @@
+export interface E2EEnv {
+    port: string;
+    host: string;
+    domainPort: string;
+    base: string;
+    timeout: number;
+    headless: boolean;
+    account: {
+        address: string;
+        signMessage: (opts: {
+            message: string;
+        }) => Promise<string>;
+    };
+    chainId: number;
+}
+export declare function initTestEnv(): Promise<E2EEnv>;
+export declare function short(addr: string): string;
+//# sourceMappingURL=env.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/e2e/env.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;KAAE,CAAA;IACzF,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CA0BnD;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C"}

package/dist/e2e/env.js

@@ -0,0 +1,57 @@
+// Environment helper for E2E tests — parses env vars, resolves account
+import * as fs from 'fs';
+import * as path from 'path';
+// Try to load PRIVATE_KEY and NEXT_PUBLIC_ADDRESS from apps/.env
+function loadEnvFile() {
+    try {
+        const envPath = path.join(process.cwd(), '..', '..', '.env');
+        if (fs.existsSync(envPath)) {
+            const content = fs.readFileSync(envPath, 'utf8');
+            const pk = content.match(/PRIVATE_KEY="([^"]+)"/)?.[1];
+            const addr = content.match(/NEXT_PUBLIC_ADDRESS="([^"]+)"/)?.[1];
+            if (pk && addr)
+                return { pk, addr, source: 'apps/.env' };
+        }
+    }
+    catch { /* fallback */ }
+    // Also try .env from working directory
+    try {
+        const envPath = path.join(process.cwd(), '.env');
+        if (fs.existsSync(envPath)) {
+            const content = fs.readFileSync(envPath, 'utf8');
+            const pk = content.match(/PRIVATE_KEY="([^"]+)"/)?.[1];
+            const addr = content.match(/NEXT_PUBLIC_ADDRESS="([^"]+)"/)?.[1];
+            if (pk && addr)
+                return { pk, addr, source: '.env' };
+        }
+    }
+    catch { /* fallback */ }
+    return null;
+}
+const _envFile = loadEnvFile();
+export async function initTestEnv() {
+    const port = process.env.PUERTOPRU || '443';
+    const host = process.env.IPDES || 'learn.tg';
+    const domainPort = port === '443' || port === '80' ? '' : `:${port}`;
+    const base = `https://${host}${domainPort}`;
+    const timeout = 60000;
+    const headless = process.env.CONCABEZA ? false : true;
+    // Priority: TEST_PRIVATE_KEY > apps/.env > Hardhat test key
+    const pk = process.env.TEST_PRIVATE_KEY ||
+        _envFile?.pk ||
+        '0xac0974bec39a17e36ba4a6b4d238ff944bacb478cbed5efcae784d7bf4f2ff80';
+    // Lazy import viem to avoid requiring it for smoke tests
+    const { privateKeyToAccount } = await import('viem/accounts');
+    const account = privateKeyToAccount(pk);
+    if (_envFile) {
+        console.log(`  🔑 Using ${_envFile.source} wallet: ${account.address}`);
+    }
+    else {
+        console.log(`  🔑 Using Hardhat test key: ${account.address}`);
+    }
+    const chainId = parseInt(process.env.CHAIN_ID || '42220', 10);
+    return { port, host, domainPort, base, timeout, headless, account, chainId };
+}
+export function short(addr) {
+    return addr.slice(0, 10) + '...';
+}

package/dist/e2e/index.d.ts

@@ -0,0 +1,11 @@
+export { ok, fail, resetFailures, summary } from './assertions.js';
+export { initTestEnv, short } from './env.js';
+export type { E2EEnv } from './env.js';
+export { findChrome, launchBrowser, newPage, newIncognitoContext, newIncognitoPage, clearBrowserCache } from './browser.js';
+export type { E2EPage, E2EBrowser, E2EBrowserContext } from './browser.js';
+export { safeNavigate, waitForText } from './navigation.js';
+export { simulateSIWE, checkSessionFull, checkPartialLogin } from './siwe.js';
+export { setupSIWEMock } from './siwe-mock.js';
+export { ethereumMockCode, eip6963MockCode, injectEIP6963 } from './wallet-mock.js';
+export type { EthereumMockOpts } from './wallet-mock.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/e2e/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC3H,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACnF,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/e2e/index.js

@@ -0,0 +1,8 @@
+// Barrel export for @pasosdejesus/m/e2e
+export { ok, fail, resetFailures, summary } from './assertions.js';
+export { initTestEnv, short } from './env.js';
+export { findChrome, launchBrowser, newPage, newIncognitoContext, newIncognitoPage, clearBrowserCache } from './browser.js';
+export { safeNavigate, waitForText } from './navigation.js';
+export { simulateSIWE, checkSessionFull, checkPartialLogin } from './siwe.js';
+export { setupSIWEMock } from './siwe-mock.js';
+export { ethereumMockCode, eip6963MockCode, injectEIP6963 } from './wallet-mock.js';

package/dist/e2e/navigation.d.ts

@@ -0,0 +1,4 @@
+import type { E2EPage } from './browser.js';
+export declare function safeNavigate(page: E2EPage, link: any, hrefFallback: string | null): Promise<void>;
+export declare function waitForText(page: E2EPage, text: string, maxSeconds?: number): Promise<boolean>;
+//# sourceMappingURL=navigation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/e2e/navigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,wBAAsB,YAAY,CAChC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,GAAG,EACT,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,OAAO,CAAC,IAAI,CAAC,CAWf;AAID,wBAAsB,WAAW,CAC/B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/e2e/navigation.js

@@ -0,0 +1,32 @@
+export async function safeNavigate(page, link, hrefFallback) {
+    try {
+        await Promise.all([
+            page.waitForNavigation({ waitUntil: 'domcontentloaded', timeout: 30000 }),
+            link.click(),
+        ]);
+    }
+    catch {
+        if (hrefFallback) {
+            await page.goto(hrefFallback, { waitUntil: 'domcontentloaded', timeout: 30000 });
+        }
+    }
+}
+// Wait up to maxSeconds for text to appear in the DOM (TreeWalker).
+// Returns true if found, false if timed out.
+export async function waitForText(page, text, maxSeconds = 12) {
+    for (let i = 0; i < maxSeconds; i++) {
+        await new Promise(r => setTimeout(r, 1000));
+        const found = await page.evaluate((t) => {
+            const w = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+            let n;
+            while ((n = w.nextNode())) {
+                if (n.textContent?.includes(t))
+                    return true;
+            }
+            return false;
+        }, text);
+        if (found)
+            return true;
+    }
+    return false;
+}

package/dist/e2e/siwe-mock.d.ts

@@ -0,0 +1,11 @@
+import type { E2EPage } from './browser.js';
+export interface SIWEMockOptions {
+    /** Balance to return for eth_call (balanceOf). Default: 1000 * 10^18 */
+    fakeBalance?: string;
+    /** Native balance for eth_getBalance (CELO). Default: 1 CELO */
+    fakeCelo?: string;
+    /** Tx hash for eth_sendTransaction. Default: 0xcd...cd (repeated 32 times) */
+    fakeTxHash?: string;
+}
+export declare function setupSIWEMock(page: E2EPage, address: string, privateKey: string, chainId?: number, opts?: SIWEMockOptions): Promise<void>;
+//# sourceMappingURL=siwe-mock.d.ts.map

package/dist/e2e/siwe-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"siwe-mock.d.ts","sourceRoot":"","sources":["../../src/e2e/siwe-mock.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAe3C,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,MAAc,EACvB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CA0Ef"}

package/dist/e2e/siwe-mock.js

@@ -0,0 +1,112 @@
+// SIWE-capable wallet mock for Puppeteer E2E tests.
+//
+// Injects via evaluateOnNewDocument so it survives page reloads.
+// Uses page.exposeFunction to bridge browser → Node.js for real ECDSA signing.
+//
+// Unlike simulateSIWE() (which calls the NextAuth backend directly via fetch),
+// this mock lets the frontend complete the full SIWE flow:
+//   user clicks "Connect Wallet" → window.ethereum injected → personal_sign →
+//   POST /api/auth/callback/credentials → session cookie set → page reloads
+//
+// Handles the full window.ethereum API:
+//   - eth_chainId, eth_accounts, eth_requestAccounts → identity
+//   - personal_sign → real ECDSA via exposeFunction bridge
+//   - eth_call → fake balances (1000 tokens, 6 or 18 decimals)
+//   - eth_getBalance → 1 CELO for gas
+//   - eth_sendTransaction → fake tx hash
+//   - eth_blockNumber, eth_gasPrice, eth_estimateGas → realistic defaults
+//
+// Usage:
+//   import { setupSIWEMock } from '@pasosdejesus/m/e2e'
+//   const page = await browser.newPage()
+//   await setupSIWEMock(page, address, privateKey, chainId)
+//   await page.goto(url)  // mock is ready before any page script runs
+// Fake balance: 1000 * 10^18 wei (for native CELO / 18-decimal tokens)
+const FAKE_BALANCE_18 = '0x00000000000000000000000000000000000000000000003635C9ADC5DEA00000';
+// Fake balance: 1000 * 10^6 (for USDT / 6-decimal tokens)
+const FAKE_BALANCE_6 = '0x000000000000000000000000000000000000000000000000000000003B9ACA00';
+// Fake CELO balance: 1 CELO = 1e18 wei
+const FAKE_CELO = '0x0DE0B6B3A7640000';
+// Fake gas price: 5 gwei
+const FAKE_GAS_PRICE = '0x12A05F200';
+// Fake block number
+const FAKE_BLOCK = '0x1312D00';
+// Fake gas estimate: 500000
+const FAKE_GAS_ESTIMATE = '0x7A120';
+export async function setupSIWEMock(page, address, privateKey, chainId = 42220, opts = {}) {
+    const hexChainId = '0x' + chainId.toString(16);
+    const fakeBalance = opts.fakeBalance || FAKE_BALANCE_18;
+    const fakeCelo = opts.fakeCelo || FAKE_CELO;
+    const fakeTxHash = opts.fakeTxHash || ('0x' + 'cd'.repeat(32));
+    // Set up signing bridge BEFORE page loads
+    await page.exposeFunction('__signSiwe', async (message) => {
+        const { privateKeyToAccount } = await import('viem/accounts');
+        const account = privateKeyToAccount(privateKey);
+        const sig = await account.signMessage({ message });
+        return typeof sig === 'string' ? sig : sig.signature || sig;
+    });
+    // Inject full wallet mock BEFORE any page script runs
+    // This survives page reloads (evaluateOnNewDocument)
+    await page.evaluateOnNewDocument((addr, cid, bal, celo, txHash) => {
+        ;
+        window.ethereum = {
+            isMetaMask: true,
+            chainId: cid,
+            selectedAddress: addr,
+            request: async ({ method, params }) => {
+                if (method === 'eth_chainId')
+                    return cid;
+                if (method === 'eth_accounts')
+                    return [addr];
+                if (method === 'eth_requestAccounts')
+                    return [addr];
+                if (method === 'personal_sign')
+                    return window.__signSiwe(params[0]);
+                if (method === 'wallet_switchEthereumChain')
+                    return null;
+                if (method === 'eth_getBalance')
+                    return celo;
+                if (method === 'eth_blockNumber')
+                    return '0x1312D00';
+                if (method === 'eth_gasPrice')
+                    return '0x12A05F200';
+                if (method === 'eth_estimateGas')
+                    return '0x7A120';
+                if (method === 'eth_call') {
+                    // Return fake balance for balanceOf/allowance calls
+                    // Check if the call data looks like balanceOf (0x70a08231...)
+                    const data = params[0]?.data || '';
+                    if (typeof data === 'string' && data.startsWith('0x70a08231')) {
+                        return bal;
+                    }
+                    // Return 0 for other calls (allowance, etc.)
+                    return '0x0000000000000000000000000000000000000000000000000000000000000000';
+                }
+                if (method === 'eth_sendTransaction')
+                    return txHash;
+                if (method === 'eth_getTransactionReceipt') {
+                    // Return a successful receipt for our fake tx hash
+                    return {
+                        blockHash: '0x' + 'ab'.repeat(32),
+                        blockNumber: '0x1312D01',
+                        contractAddress: null,
+                        cumulativeGasUsed: '0x7A120',
+                        effectiveGasPrice: '0x12A05F200',
+                        from: addr,
+                        gasUsed: '0x7A120',
+                        logs: [],
+                        logsBloom: '0x' + '00'.repeat(256),
+                        status: '0x1',
+                        to: params[0] || addr,
+                        transactionHash: txHash,
+                        transactionIndex: '0x0',
+                        type: '0x2',
+                    };
+                }
+                return null;
+            },
+            on: (_event, _listener) => { },
+            removeListener: (_event, _listener) => { },
+        };
+    }, address, hexChainId, fakeBalance, fakeCelo, fakeTxHash);
+}

package/dist/e2e/siwe.d.ts

@@ -0,0 +1,15 @@
+import type { E2EPage } from './browser.js';
+import type { E2EEnv } from './env.js';
+interface SiweParams {
+    account: E2EEnv['account'];
+    host: string;
+    domainPort: string;
+    base: string;
+    chainId: number;
+    statement?: string;
+}
+export declare function checkSessionFull(page: E2EPage): Promise<boolean>;
+export declare function simulateSIWE(page: E2EPage, params: SiweParams): Promise<boolean>;
+export declare function checkPartialLogin(page: E2EPage): Promise<boolean>;
+export {};
+//# sourceMappingURL=siwe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"siwe.d.ts","sourceRoot":"","sources":["../../src/e2e/siwe.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC,SAAS,CAAC,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,UAAU,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAcD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAItE;AAMD,wBAAsB,YAAY,CAChC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,OAAO,CAAC,CA6DlB;AAGD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CASvE"}

package/dist/e2e/siwe.js

@@ -0,0 +1,85 @@
+// SIWE simulation for E2E tests — authenticate without a real wallet
+// Uses siwe + viem (already devDependencies of m).
+import { SiweMessage } from 'siwe';
+// Check if NextAuth session cookie is present
+function checkSessionCookie(cookies) {
+    return cookies.some(c => c.name.includes('next-auth.session-token'));
+}
+// Check if session token exists in localStorage (fallback for httpOnly cookies)
+async function checkSessionLocal(page) {
+    const token = await page.evaluate(() => localStorage.getItem('nextauth.message'));
+    return token !== null;
+}
+export async function checkSessionFull(page) {
+    const cookies = await page.cookies();
+    if (checkSessionCookie(cookies))
+        return true;
+    return await checkSessionLocal(page);
+}
+// Simulate full SIWE authentication flow:
+// 1. Fetch CSRF token (nonce)
+// 2. Build and sign SIWE message
+// 3. POST to NextAuth callback
+export async function simulateSIWE(page, params) {
+    const { account, host, domainPort, base, chainId, statement } = params;
+    // Step 1: Get CSRF token
+    const nonce = await page.evaluate(async () => {
+        const r = await fetch('/api/auth/csrf');
+        return (await r.json()).csrfToken;
+    });
+    if (!nonce)
+        throw new Error('Could not get CSRF token (nonce)');
+    // Step 2: Build and sign SIWE message
+    const domain = `${host}${domainPort}`;
+    const msg = new SiweMessage({
+        domain,
+        address: account.address,
+        statement: statement || 'Sign in to Learn through games.',
+        uri: base,
+        version: '1',
+        chainId,
+        nonce,
+    });
+    const msgStr = msg.prepareMessage();
+    const sig = await account.signMessage({ message: msgStr });
+    // Step 3: POST to NextAuth callback
+    const cb = await page.evaluate(async ({ msg, sig, n }) => {
+        const body = new URLSearchParams({
+            csrfToken: n,
+            message: msg,
+            signature: sig,
+            redirect: 'false',
+            json: 'true',
+        });
+        const r = await fetch('/api/auth/callback/credentials', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
+            body: body.toString(),
+        });
+        const text = await r.text();
+        return { ok: r.ok, status: r.status, body: text.slice(0, 200) };
+    }, { msg: msgStr, sig, n: nonce });
+    console.log(`  SIWE: ${cb.status} — ${cb.body.slice(0, 80)}`);
+    // Store auth token + session address in localStorage.
+    // ConnectWalletButton does this after SIWE; simulateSIWE must match
+    // so that profile/crossword/UBI API calls can authenticate.
+    if (cb.ok) {
+        await page.evaluate(({ token, addr }) => {
+            localStorage.setItem('learn.tg.authToken', token);
+            localStorage.setItem('learn.tg.sessionAddress', addr);
+        }, { token: nonce, addr: account.address.toLowerCase() });
+    }
+    return cb.ok;
+}
+// Detect "Partial login" text anywhere in the page DOM
+export async function checkPartialLogin(page) {
+    return page.evaluate(() => {
+        const w = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+        let n;
+        while ((n = w.nextNode())) {
+            if (n.textContent?.includes('Partial login'))
+                return true;
+        }
+        return false;
+    });
+}

package/dist/e2e/wallet-mock.d.ts

@@ -0,0 +1,13 @@
+import type { E2EPage } from './browser.js';
+export interface EthereumMockOpts {
+    address: string;
+    chainId?: number;
+}
+export declare function ethereumMockCode(opts: EthereumMockOpts): string;
+export declare function eip6963MockCode(opts: EthereumMockOpts & {
+    walletName?: string;
+}): string;
+export declare function injectEIP6963(page: E2EPage, opts: EthereumMockOpts & {
+    walletName?: string;
+}): Promise<void>;
+//# sourceMappingURL=wallet-mock.d.ts.map

package/dist/e2e/wallet-mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-mock.d.ts","sourceRoot":"","sources":["../../src/e2e/wallet-mock.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAsB/D;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG;IACvD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG,MAAM,CAuCT;AAED,wBAAsB,aAAa,CACjC,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,gBAAgB,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/e2e/wallet-mock.js

@@ -0,0 +1,91 @@
+// Wallet mock for E2E tests — injects a minimal window.ethereum shim
+// into the browser page. Not detected by wagmi (EIP-6963), but prevents
+// console errors and enables basic dApp interaction.
+//
+// For wagmi/RainbowKit compatibility, use eip6963MockCode() or injectEIP6963().
+export function ethereumMockCode(opts) {
+    const addr = opts.address;
+    const cid = opts.chainId || 42220;
+    const hexChainId = '0x' + cid.toString(16);
+    return `
+    window.ethereum = {
+      isMetaMask: true,
+      chainId: '${hexChainId}',
+      selectedAddress: '${addr}',
+      request: async ({ method, params }) => {
+        if (method === 'eth_chainId') return '${hexChainId}'
+        if (method === 'eth_accounts') return ['${addr}']
+        if (method === 'eth_requestAccounts') return ['${addr}']
+        if (method === 'personal_sign') return '0x' + 'ab'.repeat(65)
+        if (method === 'wallet_switchEthereumChain') return null
+        if (method === 'eth_sendTransaction') return '0x' + 'cd'.repeat(32)
+        return null
+      },
+      on: () => {},
+      removeListener: () => {},
+    }
+  `;
+}
+// Full EIP-6963 mock — detected by wagmi/RainbowKit as a connected wallet.
+// Use this when tests need useAccount(), useWalletClient(), or usePublicClient().
+export function eip6963MockCode(opts) {
+    const addr = opts.address;
+    const cid = opts.chainId || 42220;
+    const hexChainId = '0x' + cid.toString(16);
+    const walletName = opts.walletName || 'MockWallet';
+    return `
+    const __provider = {
+      isMetaMask: true,
+      chainId: '${hexChainId}',
+      selectedAddress: '${addr}',
+      request: async ({ method, params }) => {
+        if (method === 'eth_chainId') return '${hexChainId}'
+        if (method === 'eth_accounts') return ['${addr}']
+        if (method === 'eth_requestAccounts') return ['${addr}']
+        if (method === 'personal_sign') return '0x' + 'ab'.repeat(65)
+        if (method === 'wallet_switchEthereumChain') return null
+        if (method === 'eth_sendTransaction') return '0x' + 'cd'.repeat(32)
+        return null
+      },
+      on: (event, listener) => {
+        if (event === 'accountsChanged') {
+          window.__eip6963Listeners = window.__eip6963Listeners || {}
+          window.__eip6963Listeners[event] = listener
+        }
+      },
+      removeListener: () => {},
+    }
+    window.ethereum = __provider
+
+    const __info = {
+      uuid: crypto.randomUUID ? crypto.randomUUID() : 'mock-uuid-0001',
+      name: '${walletName}',
+      icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>',
+      rdns: 'com.mock.wallet',
+    }
+    window.dispatchEvent(new CustomEvent('eip6963:announceProvider', {
+      detail: { info: __info, provider: __provider }
+    }))
+  `;
+}
+export async function injectEIP6963(page, opts) {
+    // Inject provider via evaluateOnNewDocument (runs before page scripts)
+    await page.evaluateOnNewDocument(eip6963MockCode(opts));
+    // Re-dispatch EIP-6963 event after page loads so wagmi catches it
+    page.on('load', async () => {
+        await page.evaluate(() => {
+            const provider = window.ethereum;
+            if (!provider)
+                return;
+            const info = {
+                uuid: crypto.randomUUID ? crypto.randomUUID() : 'mock-uuid-0002',
+                name: 'MockWallet',
+                icon: 'data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg"/>',
+                rdns: 'com.mock.wallet',
+            };
+            window.dispatchEvent(new CustomEvent('eip6963:announceProvider', {
+                detail: { info, provider }
+            }));
+        });
+    });
+}

package/dist/i18n/common-cli.d.ts

@@ -0,0 +1,11 @@
+import type { TranslationSet } from './types.js';
+/**
+ * Common CLI translations shared across commands.
+ *
+ * Fallback: createTranslator uses translations['en'] when the requested
+ * locale has no match, so common strings only need 'en' entries.
+ * Spanish translations provided when the Spanish string differs.
+ */
+declare const commonCli: TranslationSet;
+export default commonCli;
+//# sourceMappingURL=common-cli.d.ts.map

package/dist/i18n/common-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-cli.d.ts","sourceRoot":"","sources":["../../src/i18n/common-cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;GAMG;AACH,QAAA,MAAM,SAAS,EAAE,cAahB,CAAA;AAED,eAAe,SAAS,CAAA"}

package/dist/i18n/common-cli.js

@@ -0,0 +1,22 @@
+/**
+ * Common CLI translations shared across commands.
+ *
+ * Fallback: createTranslator uses translations['en'] when the requested
+ * locale has no match, so common strings only need 'en' entries.
+ * Spanish translations provided when the Spanish string differs.
+ */
+const commonCli = {
+    en: {
+        'error.generic': 'Error: {{0}}',
+        'success.generic': 'Success: {{0}}',
+        'file.written': 'File written: {{0}}',
+        'clipboard.copied': '📋 Copied to clipboard ({{0}}KB)',
+    },
+    es: {
+        'error.generic': 'Error: {{0}}',
+        'success.generic': 'Éxito: {{0}}',
+        'file.written': 'Archivo escrito: {{0}}',
+        'clipboard.copied': '📋 Copiado al portapapeles ({{0}}KB)',
+    },
+};
+export default commonCli;

package/dist/i18n/createTranslator.d.ts

@@ -0,0 +1,28 @@
+import type { TranslationSet } from './types.js';
+/**
+ * Creates a pure translator function (no hooks, no framework dependencies).
+ *
+ * Falls back in this order:
+ *   1. translations[lang]
+ *   2. translations['en']
+ *   3. common?.[lang]         (if common is provided)
+ *   4. common?.['en']         (if common is provided)
+ *   5. The raw key as last resort
+ *
+ * Supports {{0}}, {{1}}, etc. placeholder replacement for interpolation.
+ *
+ * @param locale       Requested locale ('es', 'en', etc. — non-es falls to 'en')
+ * @param translations Local translations object ({ en: {...}, es: {...} })
+ * @param common       Optional global/shared translations (same shape)
+ * @returns A function t(key, ...args) that returns the translated string
+ *
+ * @example
+ *   const t = createTranslator('es', { en: { hello: 'Hello' }, es: { hello: 'Hola' } })
+ *   t('hello') // → 'Hola'
+ *
+ * @example
+ *   const t = createTranslator('es', localT, commonT)
+ *   t('greeting', 'Mundo') // → 'Hola Mundo' (with {{0}} interpolation)
+ */
+export declare function createTranslator(locale: string, translations: TranslationSet, common?: TranslationSet): (key: string, ...args: string[]) => string;
+//# sourceMappingURL=createTranslator.d.ts.map

package/dist/i18n/createTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTranslator.d.ts","sourceRoot":"","sources":["../../src/i18n/createTranslator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAA;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,MAAM,CAAC,EAAE,cAAc,GACtB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CA0B5C"}

package/dist/i18n/createTranslator.js

@@ -0,0 +1,48 @@
+/**
+ * Creates a pure translator function (no hooks, no framework dependencies).
+ *
+ * Falls back in this order:
+ *   1. translations[lang]
+ *   2. translations['en']
+ *   3. common?.[lang]         (if common is provided)
+ *   4. common?.['en']         (if common is provided)
+ *   5. The raw key as last resort
+ *
+ * Supports {{0}}, {{1}}, etc. placeholder replacement for interpolation.
+ *
+ * @param locale       Requested locale ('es', 'en', etc. — non-es falls to 'en')
+ * @param translations Local translations object ({ en: {...}, es: {...} })
+ * @param common       Optional global/shared translations (same shape)
+ * @returns A function t(key, ...args) that returns the translated string
+ *
+ * @example
+ *   const t = createTranslator('es', { en: { hello: 'Hello' }, es: { hello: 'Hola' } })
+ *   t('hello') // → 'Hola'
+ *
+ * @example
+ *   const t = createTranslator('es', localT, commonT)
+ *   t('greeting', 'Mundo') // → 'Hola Mundo' (with {{0}} interpolation)
+ */
+export function createTranslator(locale, translations, common) {
+    const lang = locale === 'es' ? 'es' : 'en';
+    const resolve = (key) => {
+        const dicts = [
+            translations[lang],
+            translations['en'],
+            common?.[lang],
+            common?.['en'],
+        ];
+        for (const d of dicts) {
+            const v = d?.[key];
+            if (v !== undefined)
+                return v;
+        }
+        return undefined;
+    };
+    return (key, ...args) => {
+        let template = resolve(key);
+        if (template === undefined)
+            return key;
+        return args.reduce((acc, arg, i) => acc.replace(new RegExp(`\\{\\{${i}\\}\\}`, 'g'), arg), template);
+    };
+}

package/dist/i18n/index.d.ts

@@ -0,0 +1,4 @@
+export type { TranslationSet, LocaleStrings } from './types.js';
+export { createTranslator } from './createTranslator.js';
+export { default as commonCli } from './common-cli.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/i18n/index.js

@@ -0,0 +1,2 @@
+export { createTranslator } from './createTranslator.js';
+export { default as commonCli } from './common-cli.js';

package/dist/i18n/locales/cli.d.ts

@@ -0,0 +1,3 @@
+import type { TranslationSet } from '../types.js';
+export declare const cliTranslations: TranslationSet;
+//# sourceMappingURL=cli.d.ts.map

package/dist/i18n/locales/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../../src/i18n/locales/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,eAAe,EAAE,cAmL7B,CAAC"}