@broccolo1d/wallet-browser 0.1.0

package/dist/fixture-harness.js

@@ -0,0 +1,69 @@
+import { createHash } from 'node:crypto';
+import { mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { FIXTURE_CONNECTION_PROOF_MANIFEST, verifyFixtureConnectionProofManifest } from './fixture-proof.js';
+import { DEFAULT_SEPOLIA_CHAIN_ID } from './network.js';
+import { maskEthereumAddress } from './profile-bootstrap.js';
+import { connectWallet } from './wallet-control.js';
+export async function runFixtureConnectionProof(options) {
+    const artifactDir = options.artifactDir;
+    mkdirSync(artifactDir, { recursive: true, mode: 0o700 });
+    const connection = await connectWallet({
+        dapp: options.dapp,
+        prompt: options.prompt,
+        network: options.network,
+        expectedAccount: options.expectedAccount,
+        expectedChainId: options.expectedChainId ?? DEFAULT_SEPOLIA_CHAIN_ID,
+        origin: options.origin,
+        guardrails: createFixtureGuardrails(options),
+        logger: options.logger
+    });
+    const evidence = {
+        connectionState: 'connected',
+        maskedAccount: maskEthereumAddress(connection.activeAccount),
+        chainId: connection.chainId,
+        origin: sanitizeProofOrigin(options.origin)
+    };
+    const screenshotFile = 'fixture-connected.png';
+    const screenshotPath = join(artifactDir, screenshotFile);
+    await options.captureScreenshot({ path: screenshotPath, evidence });
+    const screenshot = createScreenshotManifestEntry(artifactDir, screenshotFile);
+    const manifest = {
+        artifactType: 'fixture-dapp-wallet-connection-proof',
+        target: 'fixture-dapp',
+        status: 'connected',
+        evidence,
+        screenshots: [screenshot],
+        notes: [
+            'Generated by local fixture connection proof harness after wallet-control verified account and chain.',
+            'Artifact is local-only under .wallet-artifacts and must be inspected before sharing.',
+            ...(options.notes ?? [])
+        ]
+    };
+    writeFileSync(join(artifactDir, FIXTURE_CONNECTION_PROOF_MANIFEST), `${JSON.stringify(manifest, null, 2)}\n`, { mode: 0o600 });
+    return verifyFixtureConnectionProofManifest(artifactDir);
+}
+function createFixtureGuardrails(options) {
+    return {
+        allowedOrigins: options.allowedOrigins ?? [sanitizeProofOrigin(options.origin)],
+        maxTransactionValueWei: 0n
+    };
+}
+function createScreenshotManifestEntry(artifactDir, file) {
+    const screenshotPath = join(artifactDir, file);
+    const bytes = readFileSync(screenshotPath);
+    return {
+        label: 'fixture-connected',
+        file,
+        sizeBytes: statSync(screenshotPath).size,
+        sha256: createHash('sha256').update(bytes).digest('hex')
+    };
+}
+function sanitizeProofOrigin(origin) {
+    const parsed = new URL(origin);
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new Error('Fixture proof origin must be an http(s) URL.');
+    }
+    return `${parsed.origin}${parsed.pathname === '/' ? '' : parsed.pathname}`;
+}
+//# sourceMappingURL=fixture-harness.js.map

package/dist/fixture-harness.js.map

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

package/dist/fixture-proof.d.ts

@@ -0,0 +1,23 @@
+export declare const FIXTURE_CONNECTION_PROOF_MANIFEST = "FIXTURE-PROOF-MANIFEST.json";
+export interface FixtureConnectionProofEvidence {
+    connectionState: 'connected';
+    maskedAccount: string;
+    chainId: number;
+    origin: string;
+}
+export interface FixtureConnectionProofScreenshot {
+    label: 'fixture-connected';
+    file: string;
+    sizeBytes: number;
+    sha256: string;
+}
+export interface FixtureConnectionProofVerificationResult {
+    status: 'verified';
+    artifactDir: string;
+    manifestPath: string;
+    evidence: FixtureConnectionProofEvidence;
+    screenshots: FixtureConnectionProofScreenshot[];
+    notes: string[];
+}
+export declare function verifyFixtureConnectionProofManifest(artifactDir: string): FixtureConnectionProofVerificationResult;
+//# sourceMappingURL=fixture-proof.d.ts.map

package/dist/fixture-proof.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-proof.d.ts","sourceRoot":"","sources":["../src/fixture-proof.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iCAAiC,gCAAgC,CAAC;AAE/E,MAAM,WAAW,8BAA8B;IAC7C,eAAe,EAAE,WAAW,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,MAAM,WAAW,wCAAwC;IACvD,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,8BAA8B,CAAC;IACzC,WAAW,EAAE,gCAAgC,EAAE,CAAC;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,oCAAoC,CAAC,WAAW,EAAE,MAAM,GAAG,wCAAwC,CA8ClH"}

package/dist/fixture-proof.js

@@ -0,0 +1,90 @@
+import { createHash } from 'node:crypto';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import { DEFAULT_SEPOLIA_CHAIN_ID } from './network.js';
+export const FIXTURE_CONNECTION_PROOF_MANIFEST = 'FIXTURE-PROOF-MANIFEST.json';
+export function verifyFixtureConnectionProofManifest(artifactDir) {
+    const manifestPath = join(artifactDir, FIXTURE_CONNECTION_PROOF_MANIFEST);
+    const manifestText = readFileSync(manifestPath, 'utf8');
+    if (manifestText.includes(artifactDir)) {
+        throw new Error('Fixture connection proof manifest must not contain the full artifact directory path.');
+    }
+    const manifest = JSON.parse(manifestText);
+    if (manifest.artifactType !== 'fixture-dapp-wallet-connection-proof') {
+        throw new Error('Fixture connection proof manifest has an unexpected artifact type.');
+    }
+    if (manifest.target !== 'fixture-dapp') {
+        throw new Error('Fixture connection proof manifest has an unexpected target.');
+    }
+    if (manifest.status !== 'connected' || manifest.evidence?.connectionState !== 'connected') {
+        throw new Error('Fixture connection proof must show connected fixture state before it can be accepted.');
+    }
+    if (manifest.evidence.chainId !== DEFAULT_SEPOLIA_CHAIN_ID) {
+        throw new Error(`Fixture connection proof must be captured on Sepolia chain ${DEFAULT_SEPOLIA_CHAIN_ID}.`);
+    }
+    if (!isMaskedAccount(manifest.evidence.maskedAccount)) {
+        throw new Error('Fixture connection proof masked account must be shortened and must not contain a full wallet address.');
+    }
+    if (containsFullAddress(manifestText)) {
+        throw new Error('Fixture connection proof manifest must not contain full wallet addresses.');
+    }
+    if (!isSafeOrigin(manifest.evidence.origin)) {
+        throw new Error('Fixture connection proof origin must be a safe http(s) origin or local fixture URL without query strings.');
+    }
+    if (!Array.isArray(manifest.screenshots) || manifest.screenshots.length === 0) {
+        throw new Error('Fixture connection proof manifest must list at least one screenshot.');
+    }
+    const screenshots = manifest.screenshots.map((screenshot) => verifyFixtureProofScreenshot(artifactDir, screenshot));
+    if (!screenshots.some((screenshot) => screenshot.label === 'fixture-connected')) {
+        throw new Error('Fixture connection proof manifest must include a fixture-connected screenshot.');
+    }
+    return {
+        status: 'verified',
+        artifactDir,
+        manifestPath,
+        evidence: manifest.evidence,
+        screenshots,
+        notes: Array.isArray(manifest.notes) ? manifest.notes : []
+    };
+}
+function verifyFixtureProofScreenshot(artifactDir, screenshot) {
+    if (screenshot.label !== 'fixture-connected') {
+        throw new Error(`Fixture connection proof manifest contains an unexpected screenshot label: ${String(screenshot.label)}`);
+    }
+    if (!isSafeArtifactFileName(screenshot.file)) {
+        throw new Error(`Fixture connection proof screenshot file must be a safe basename: ${String(screenshot.file)}`);
+    }
+    const screenshotPath = join(artifactDir, screenshot.file);
+    if (!existsSync(screenshotPath)) {
+        throw new Error(`Fixture connection proof screenshot is missing: ${screenshot.file}`);
+    }
+    const bytes = readFileSync(screenshotPath);
+    const sizeBytes = statSync(screenshotPath).size;
+    const sha256 = createHash('sha256').update(bytes).digest('hex');
+    if (screenshot.sizeBytes !== sizeBytes) {
+        throw new Error(`Fixture connection proof screenshot size mismatch for ${screenshot.file}.`);
+    }
+    if (screenshot.sha256 !== sha256) {
+        throw new Error(`Fixture connection proof screenshot hash mismatch for ${screenshot.file}.`);
+    }
+    return { ...screenshot, sizeBytes, sha256 };
+}
+function isMaskedAccount(value) {
+    return typeof value === 'string' && /^0x[0-9a-fA-F]{4}(?:…|\.\.\.)[0-9a-fA-F]{4,5}$/.test(value) && !containsFullAddress(value);
+}
+function containsFullAddress(value) {
+    return /0x[0-9a-fA-F]{40}/.test(value);
+}
+function isSafeOrigin(value) {
+    try {
+        const parsed = new URL(value);
+        return (parsed.protocol === 'http:' || parsed.protocol === 'https:') && parsed.search === '' && parsed.hash === '';
+    }
+    catch {
+        return false;
+    }
+}
+function isSafeArtifactFileName(fileName) {
+    return typeof fileName === 'string' && fileName.length > 0 && fileName === basename(fileName) && !fileName.includes('..');
+}
+//# sourceMappingURL=fixture-proof.js.map

package/dist/fixture-proof.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { PINNED_METAMASK_VERSION, resolveWalletBrowserConfig, type MetaMaskExtensionIdentity, type ResolveWalletBrowserConfigOptions, type WalletBrowserConfig, type WalletBrowserEnv } from './config.js';
+export { buildChromiumExtensionArgs, launchWalletBrowser, prepareChromiumLaunchOptions, type PreparedChromiumLaunchOptions, type WalletBrowserLaunchResult } from './launcher.js';
+export { discoverMetaMaskExtensionPage, getMetaMaskExtensionPagePath, waitForMetaMaskExtensionPage, type DiscoverMetaMaskExtensionPageOptions, type ExtensionBrowserContextLike, type ExtensionPageLike, type MetaMaskExtensionPagePath, type WaitForMetaMaskExtensionPageOptions } from './extension-pages.js';
+export { captureFixtureExtensionSmokeScreenshots, captureMetaMaskSmokeScreenshots, resolveDefaultFixtureDappSmokeUrl, writeSmokeArtifactManifest, verifySmokeArtifactManifest, writeSmokeInspectionGuide, type MetaMaskSmokeOptions, type MetaMaskSmokeResult, type MetaMaskSmokeScreenshot, type RunMetaMaskSmoke } from './metamask-smoke.js';
+export { DEFAULT_METAMASK_PROMPT_SELECTORS, approveMetaMaskConnectionPrompt, assertMetaMaskConnectionPromptText, createMetaMaskPromptDriver, type MetaMaskPromptDriverOptions, type MetaMaskPromptLocatorLike, type MetaMaskPromptPageLike, type MetaMaskPromptSelectors } from './metamask-prompts.js';
+export { FIXTURE_CONNECTION_PROOF_MANIFEST, verifyFixtureConnectionProofManifest, type FixtureConnectionProofEvidence, type FixtureConnectionProofScreenshot, type FixtureConnectionProofVerificationResult } from './fixture-proof.js';
+export { runFixtureConnectionProof, type FixtureConnectionScreenshotCaptureInput, type RunFixtureConnectionProofOptions } from './fixture-harness.js';
+export { runWalletBrowserCli, type WalletBrowserCliOptions } from './cli.js';
+export { DEFAULT_METAMASK_ONBOARDING_TIMEOUT_MS, METAMASK_ONBOARDING_SELECTORS, createMetaMaskOnboardingPlan, createMetaMaskPageDriver, findMetaMaskExtensionPage, importPrivateKeyIntoMetaMaskPage, isMetaMaskExtensionPageUrl, maskSecret, resolveMetaMaskOnboardingConfig, runMetaMaskOnboarding, unlockMetaMaskPage, validateEthereumAddress, validateMetaMaskPassword, validatePrivateKey, verifyMetaMaskActiveAddress, type MetaMaskImportPrivateKeyInput, type MetaMaskExtensionPageDiscoveryOptions, type MetaMaskOnboardingConfig, type MetaMaskOnboardingDriver, type MetaMaskOnboardingEnv, type MetaMaskOnboardingResult, type MetaMaskOnboardingState, type MetaMaskOnboardingStatus, type MetaMaskPageDriverOptions, type MetaMaskUnlockInput, type RedactedMetaMaskOnboardingPlan, type ResolveMetaMaskOnboardingConfigOptions } from './onboarding.js';
+export { DEFAULT_ALLOWED_WALLET_CHAIN_IDS, DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS, DEFAULT_SEPOLIA_CHAIN_ID, assertExpectedChainAndAccount, chainIdToHex, createMetaMaskNetworkPageDriver, createSepoliaAddChainInput, createSepoliaNetworkPlan, isAllowedWalletChainId, normalizeChainId, normalizeExpectedAccount, provisionSepoliaNetwork, redactRpcUrl, resolveSepoliaNetworkConfig, validateOptionalRpcUrl, type AddEthereumChainInput, type MetaMaskNetworkDriver, type MetaMaskNetworkPageDriverOptions, type RedactedSepoliaNetworkPlan, type ResolveSepoliaNetworkConfigOptions, type SepoliaNetworkAssertionResult, type SepoliaNetworkConfig, type SepoliaNetworkEnv } from './network.js';
+export { createProfileBootstrapImportDryRun, createProfileBootstrapImportManifest, maskEthereumAddress, type ProfileBootstrapImportDryRunResult, type ProfileBootstrapImportEnv, type ProfileBootstrapImportManifest, type ResolveProfileBootstrapImportOptions } from './profile-bootstrap.js';
+export { approveSignature, approveTransaction, assertWalletState, connectWallet, createWalletDappPageDriver, resetProfile, switchNetwork, type ApproveSignatureOptions, type ApproveTransactionOptions, type ConnectWalletOptions, type ConnectWalletResult, type ResetProfileOptions, type ResetProfileResult, type WalletConnectionPromptInput, type WalletControlAction, type WalletControlLogEvent, type WalletControlLogStatus, type WalletControlLogger, type WalletDappDriver, type WalletDappPageDriverOptions, type WalletGuardrailConfig, type WalletDappPageDriverSelectors, type WalletDappPageLike, type WalletDappPageLocator, type WalletPromptDriver, type WalletSignaturePromptInput, type WalletSignatureRequestInput, type WalletStateOptions, type WalletTransactionPromptInput, type WalletTransactionRequestInput } from './wallet-control.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,13 @@
+export { PINNED_METAMASK_VERSION, resolveWalletBrowserConfig } from './config.js';
+export { buildChromiumExtensionArgs, launchWalletBrowser, prepareChromiumLaunchOptions } from './launcher.js';
+export { discoverMetaMaskExtensionPage, getMetaMaskExtensionPagePath, waitForMetaMaskExtensionPage } from './extension-pages.js';
+export { captureFixtureExtensionSmokeScreenshots, captureMetaMaskSmokeScreenshots, resolveDefaultFixtureDappSmokeUrl, writeSmokeArtifactManifest, verifySmokeArtifactManifest, writeSmokeInspectionGuide } from './metamask-smoke.js';
+export { DEFAULT_METAMASK_PROMPT_SELECTORS, approveMetaMaskConnectionPrompt, assertMetaMaskConnectionPromptText, createMetaMaskPromptDriver } from './metamask-prompts.js';
+export { FIXTURE_CONNECTION_PROOF_MANIFEST, verifyFixtureConnectionProofManifest } from './fixture-proof.js';
+export { runFixtureConnectionProof } from './fixture-harness.js';
+export { runWalletBrowserCli } from './cli.js';
+export { DEFAULT_METAMASK_ONBOARDING_TIMEOUT_MS, METAMASK_ONBOARDING_SELECTORS, createMetaMaskOnboardingPlan, createMetaMaskPageDriver, findMetaMaskExtensionPage, importPrivateKeyIntoMetaMaskPage, isMetaMaskExtensionPageUrl, maskSecret, resolveMetaMaskOnboardingConfig, runMetaMaskOnboarding, unlockMetaMaskPage, validateEthereumAddress, validateMetaMaskPassword, validatePrivateKey, verifyMetaMaskActiveAddress } from './onboarding.js';
+export { DEFAULT_ALLOWED_WALLET_CHAIN_IDS, DEFAULT_NETWORK_ASSERTION_TIMEOUT_MS, DEFAULT_SEPOLIA_CHAIN_ID, assertExpectedChainAndAccount, chainIdToHex, createMetaMaskNetworkPageDriver, createSepoliaAddChainInput, createSepoliaNetworkPlan, isAllowedWalletChainId, normalizeChainId, normalizeExpectedAccount, provisionSepoliaNetwork, redactRpcUrl, resolveSepoliaNetworkConfig, validateOptionalRpcUrl } from './network.js';
+export { createProfileBootstrapImportDryRun, createProfileBootstrapImportManifest, maskEthereumAddress } from './profile-bootstrap.js';
+export { approveSignature, approveTransaction, assertWalletState, connectWallet, createWalletDappPageDriver, resetProfile, switchNetwork } from './wallet-control.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAK3B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,4BAA4B,EAG7B,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,6BAA6B,EAC7B,4BAA4B,EAC5B,4BAA4B,EAM7B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,uCAAuC,EACvC,+BAA+B,EAC/B,iCAAiC,EACjC,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EAK1B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,iCAAiC,EACjC,+BAA+B,EAC/B,kCAAkC,EAClC,0BAA0B,EAK3B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,iCAAiC,EACjC,oCAAoC,EAIrC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EAG1B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,mBAAmB,EAAgC,MAAM,UAAU,CAAC;AAE7E,OAAO,EACL,sCAAsC,EACtC,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,yBAAyB,EACzB,gCAAgC,EAChC,0BAA0B,EAC1B,UAAU,EACV,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,kBAAkB,EAClB,2BAA2B,EAa5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,gCAAgC,EAChC,oCAAoC,EACpC,wBAAwB,EACxB,6BAA6B,EAC7B,YAAY,EACZ,+BAA+B,EAC/B,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,uBAAuB,EACvB,YAAY,EACZ,2BAA2B,EAC3B,sBAAsB,EASvB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,kCAAkC,EAClC,oCAAoC,EACpC,mBAAmB,EAKpB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EAwBd,MAAM,qBAAqB,CAAC"}

package/dist/launcher.d.ts

@@ -0,0 +1,15 @@
+import { chromium, type BrowserContext } from 'playwright';
+import { type ResolveWalletBrowserConfigOptions, type WalletBrowserConfig } from './config.js';
+export interface PreparedChromiumLaunchOptions {
+    browserName: 'chromium';
+    userDataDir: string;
+    options: NonNullable<Parameters<typeof chromium.launchPersistentContext>[1]>;
+}
+export interface WalletBrowserLaunchResult {
+    context: BrowserContext;
+    config: WalletBrowserConfig;
+}
+export declare function buildChromiumExtensionArgs(metamaskExtensionPath: string): string[];
+export declare function prepareChromiumLaunchOptions(config: WalletBrowserConfig): PreparedChromiumLaunchOptions;
+export declare function launchWalletBrowser(options?: ResolveWalletBrowserConfigOptions): Promise<WalletBrowserLaunchResult>;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE3D,OAAO,EAA8B,KAAK,iCAAiC,EAAE,KAAK,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3H,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,QAAQ,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED,wBAAgB,0BAA0B,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,mBAAmB,GAAG,6BAA6B,CAUvG;AAED,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,iCAAsC,GAC9C,OAAO,CAAC,yBAAyB,CAAC,CAMpC"}

package/dist/launcher.js

@@ -0,0 +1,26 @@
+import { chromium } from 'playwright';
+import { resolveWalletBrowserConfig } from './config.js';
+export function buildChromiumExtensionArgs(metamaskExtensionPath) {
+    return [
+        `--disable-extensions-except=${metamaskExtensionPath}`,
+        `--load-extension=${metamaskExtensionPath}`
+    ];
+}
+export function prepareChromiumLaunchOptions(config) {
+    return {
+        browserName: 'chromium',
+        userDataDir: config.profileDir,
+        options: {
+            headless: false,
+            args: buildChromiumExtensionArgs(config.metamaskExtensionPath),
+            viewport: { width: 1280, height: 900 }
+        }
+    };
+}
+export async function launchWalletBrowser(options = {}) {
+    const config = resolveWalletBrowserConfig(options);
+    const launchOptions = prepareChromiumLaunchOptions(config);
+    const context = await chromium.launchPersistentContext(launchOptions.userDataDir, launchOptions.options);
+    return { context, config };
+}
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../src/launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAuB,MAAM,YAAY,CAAC;AAE3D,OAAO,EAAE,0BAA0B,EAAoE,MAAM,aAAa,CAAC;AAa3H,MAAM,UAAU,0BAA0B,CAAC,qBAA6B;IACtE,OAAO;QACL,+BAA+B,qBAAqB,EAAE;QACtD,oBAAoB,qBAAqB,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAA2B;IACtE,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,MAAM,CAAC,UAAU;QAC9B,OAAO,EAAE;YACP,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,0BAA0B,CAAC,MAAM,CAAC,qBAAqB,CAAC;YAC9D,QAAQ,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;SACvC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,UAA6C,EAAE;IAE/C,MAAM,MAAM,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,uBAAuB,CAAC,aAAa,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAEzG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/metamask-prompts.d.ts

@@ -0,0 +1,27 @@
+import { type ExtensionBrowserContextLike, type ExtensionPageLike } from './extension-pages.js';
+import { type WalletConnectionPromptInput, type WalletPromptDriver } from './wallet-control.js';
+export interface MetaMaskPromptLocatorLike {
+    textContent?(): Promise<string | null>;
+    isVisible?(): Promise<boolean>;
+    click?(): Promise<void>;
+}
+export interface MetaMaskPromptPageLike extends ExtensionPageLike {
+    locator(selector: string): MetaMaskPromptLocatorLike;
+}
+export interface MetaMaskPromptSelectors {
+    pageText: string;
+    nextButtonCandidates: readonly string[];
+    connectButtonCandidates: readonly string[];
+}
+export interface MetaMaskPromptDriverOptions {
+    context: ExtensionBrowserContextLike;
+    extensionId?: string;
+    timeoutMs?: number;
+    ensureKeeperPage?: boolean;
+    selectors?: Partial<MetaMaskPromptSelectors>;
+}
+export declare const DEFAULT_METAMASK_PROMPT_SELECTORS: MetaMaskPromptSelectors;
+export declare function createMetaMaskPromptDriver(options: MetaMaskPromptDriverOptions): WalletPromptDriver;
+export declare function approveMetaMaskConnectionPrompt(page: MetaMaskPromptPageLike, input: WalletConnectionPromptInput, selectors?: MetaMaskPromptSelectors): Promise<void>;
+export declare function assertMetaMaskConnectionPromptText(promptText: string, expectedOrigin?: string): void;
+//# sourceMappingURL=metamask-prompts.d.ts.map

package/dist/metamask-prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamask-prompts.d.ts","sourceRoot":"","sources":["../src/metamask-prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,KAAK,2BAA2B,EAAE,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9H,OAAO,EAAE,KAAK,2BAA2B,EAAE,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,sBAAuB,SAAQ,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,CAAC;CACtD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,2BAA2B,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC9C;AAED,eAAO,MAAM,iCAAiC,EAAE,uBAW/C,CAAC;AAqBF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,kBAAkB,CAYnG;AAED,wBAAsB,+BAA+B,CACnD,IAAI,EAAE,sBAAsB,EAC5B,KAAK,EAAE,2BAA2B,EAClC,SAAS,GAAE,uBAA2D,GACrE,OAAO,CAAC,IAAI,CAAC,CAcf;AAED,wBAAgB,kCAAkC,CAAC,UAAU,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAepG"}

package/dist/metamask-prompts.js

@@ -0,0 +1,116 @@
+import { waitForMetaMaskExtensionPage } from './extension-pages.js';
+export const DEFAULT_METAMASK_PROMPT_SELECTORS = {
+    pageText: 'body',
+    nextButtonCandidates: [
+        '[data-testid="page-container-footer-next"]',
+        'button:has-text("Next")'
+    ],
+    connectButtonCandidates: [
+        '[data-testid="page-container-footer-connect"]',
+        '[data-testid="page-container-footer-confirm"]',
+        'button:has-text("Connect")'
+    ]
+};
+const CONNECTION_PROMPT_MARKERS = [
+    'connect with metamask',
+    'connect to',
+    'wants to connect',
+    'permissions request'
+];
+const NON_CONNECTION_PROMPT_MARKERS = [
+    'confirm transaction',
+    'send transaction',
+    'transaction request',
+    'signature request',
+    'sign message',
+    'personal_sign',
+    'spending cap',
+    'approve token',
+    'edit permission'
+];
+export function createMetaMaskPromptDriver(options) {
+    return {
+        async approveConnection(input) {
+            const page = await waitForMetaMaskExtensionPage(options.context, {
+                extensionId: options.extensionId,
+                preferredPath: '/notification.html',
+                timeoutMs: options.timeoutMs,
+                ensureKeeperPage: options.ensureKeeperPage ?? true
+            });
+            await approveMetaMaskConnectionPrompt(page, input, mergePromptSelectors(options.selectors));
+        }
+    };
+}
+export async function approveMetaMaskConnectionPrompt(page, input, selectors = DEFAULT_METAMASK_PROMPT_SELECTORS) {
+    const promptText = await readPromptText(page, selectors.pageText);
+    assertMetaMaskConnectionPromptText(promptText, input.origin);
+    const nextButton = await findVisibleClickable(page, selectors.nextButtonCandidates);
+    if (nextButton) {
+        await nextButton.click?.();
+    }
+    const connectButton = await findVisibleClickable(page, selectors.connectButtonCandidates);
+    if (!connectButton) {
+        throw new Error('MetaMask connect approval button was not visible; refusing to approve unknown prompt state.');
+    }
+    await connectButton.click?.();
+}
+export function assertMetaMaskConnectionPromptText(promptText, expectedOrigin) {
+    const normalizedText = promptText.toLowerCase();
+    const unexpectedMarker = NON_CONNECTION_PROMPT_MARKERS.find((marker) => normalizedText.includes(marker));
+    if (unexpectedMarker) {
+        throw new Error(`Unexpected MetaMask prompt marker "${unexpectedMarker}" while expecting a connection prompt; refusing to click.`);
+    }
+    if (!CONNECTION_PROMPT_MARKERS.some((marker) => normalizedText.includes(marker))) {
+        throw new Error('MetaMask notification page did not look like a connection prompt; refusing to click.');
+    }
+    const expectedOriginMarker = normalizeExpectedOriginMarker(expectedOrigin);
+    if (expectedOriginMarker && !normalizedText.includes(expectedOriginMarker.toLowerCase())) {
+        throw new Error(`Expected dapp origin ${expectedOriginMarker} was not found in MetaMask connection prompt; refusing to click.`);
+    }
+}
+async function readPromptText(page, selector) {
+    const text = await page.locator(selector).textContent?.();
+    if (!text?.trim()) {
+        throw new Error('MetaMask prompt text was empty; refusing to click unknown prompt state.');
+    }
+    return text;
+}
+async function findVisibleClickable(page, selectors) {
+    for (const selector of selectors) {
+        try {
+            const locator = page.locator(selector);
+            if (!locator.click) {
+                continue;
+            }
+            const visible = locator.isVisible ? await locator.isVisible() : true;
+            if (visible) {
+                return locator;
+            }
+        }
+        catch {
+            // Try the next selector candidate; fail closed only if none match.
+        }
+    }
+    return undefined;
+}
+function mergePromptSelectors(selectors) {
+    return {
+        pageText: selectors?.pageText ?? DEFAULT_METAMASK_PROMPT_SELECTORS.pageText,
+        nextButtonCandidates: selectors?.nextButtonCandidates ?? DEFAULT_METAMASK_PROMPT_SELECTORS.nextButtonCandidates,
+        connectButtonCandidates: selectors?.connectButtonCandidates ?? DEFAULT_METAMASK_PROMPT_SELECTORS.connectButtonCandidates
+    };
+}
+function normalizeExpectedOriginMarker(origin) {
+    const trimmed = origin?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    try {
+        const parsed = new URL(trimmed);
+        return parsed.origin;
+    }
+    catch {
+        return trimmed.split(/[?#]/, 1)[0];
+    }
+}
+//# sourceMappingURL=metamask-prompts.js.map

package/dist/metamask-prompts.js.map

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

package/dist/metamask-smoke.d.ts

@@ -0,0 +1,54 @@
+import type { WalletBrowserEnv } from './config.js';
+export interface MetaMaskSmokeOptions {
+    cwd?: string;
+    env?: WalletBrowserEnv;
+    artifactDir?: string;
+    extensionScreenshotLabel?: 'metamask-extension' | 'fixture-extension';
+    notes?: string[];
+}
+export interface MetaMaskSmokeScreenshot {
+    label: 'browser-page' | 'metamask-extension' | 'fixture-extension';
+    path: string;
+}
+export interface MetaMaskSmokeResult {
+    status: 'captured';
+    artifactDir: string;
+    screenshots: MetaMaskSmokeScreenshot[];
+    inspectionGuidePath: string;
+    manifestPath: string;
+    notes: string[];
+}
+interface SmokeInspectionGuideOptions {
+    artifactDir: string;
+    screenshots: readonly MetaMaskSmokeScreenshot[];
+    notes: readonly string[];
+}
+interface SmokeArtifactManifestOptions {
+    artifactDir: string;
+    screenshots: readonly MetaMaskSmokeScreenshot[];
+    inspectionGuidePath: string;
+    notes: readonly string[];
+}
+export interface SmokeArtifactManifestScreenshot {
+    label: MetaMaskSmokeScreenshot['label'];
+    file: string;
+    sizeBytes: number;
+    sha256: string;
+}
+export interface SmokeArtifactVerificationResult {
+    status: 'verified';
+    artifactDir: string;
+    manifestPath: string;
+    inspectionGuidePath: string;
+    screenshots: SmokeArtifactManifestScreenshot[];
+    notes: string[];
+}
+export type RunMetaMaskSmoke = (options: MetaMaskSmokeOptions) => Promise<MetaMaskSmokeResult>;
+export declare function captureMetaMaskSmokeScreenshots(options?: MetaMaskSmokeOptions): Promise<MetaMaskSmokeResult>;
+export declare function captureFixtureExtensionSmokeScreenshots(options?: MetaMaskSmokeOptions): Promise<MetaMaskSmokeResult>;
+export declare function resolveDefaultFixtureDappSmokeUrl(cwd: string): string | undefined;
+export declare function writeSmokeInspectionGuide(options: SmokeInspectionGuideOptions): string;
+export declare function writeSmokeArtifactManifest(options: SmokeArtifactManifestOptions): string;
+export declare function verifySmokeArtifactManifest(artifactDir: string): SmokeArtifactVerificationResult;
+export {};
+//# sourceMappingURL=metamask-smoke.d.ts.map

package/dist/metamask-smoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metamask-smoke.d.ts","sourceRoot":"","sources":["../src/metamask-smoke.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,MAAM,WAAW,oBAAoB;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,gBAAgB,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wBAAwB,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACtE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,cAAc,GAAG,oBAAoB,GAAG,mBAAmB,CAAC;IACnE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,2BAA2B;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAChD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,UAAU,4BAA4B;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,SAAS,uBAAuB,EAAE,CAAC;IAChD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,+BAA+B;IAC9C,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AASD,MAAM,WAAW,+BAA+B;IAC9C,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,+BAA+B,EAAE,CAAC;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAE/F,wBAAsB,+BAA+B,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAyCtH;AAED,wBAAsB,uCAAuC,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAsB9H;AAwCD,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGjF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CA0BtF;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,4BAA4B,GAAG,MAAM,CA0BxF;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,+BAA+B,CA+BhG"}