@deeeed/metamask-harness 0.17.4 → 0.17.5

package/adapters/extension/launch-webpack.cjs

@@ -1,83 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { spawn } = require('node:child_process');
-const fs = require('node:fs');
-const path = require('node:path');
-
-const args = {};
-for (let index = 2; index < process.argv.length; index += 1) {
-  const key = process.argv[index];
-  if (key === '--help' || key === '-h') {
-    process.stdout.write('Usage: launch-webpack.cjs --target <path> --log <path> --pid-file <path> --sync-script <path> --sync-pid-file <path> --sync-log <path> --dist <path> --runtime-dist <path> [--port <port>] [--path-prefix <path>]\n');
-    process.exit(0);
-  }
-  if (!key.startsWith('--') || index + 1 >= process.argv.length) throw new Error(`invalid argument: ${key}`);
-  args[key.slice(2)] = process.argv[++index];
-}
-
-async function main() {
-  for (const required of ['target', 'log', 'pid-file', 'sync-script', 'sync-pid-file', 'sync-log', 'dist', 'runtime-dist']) {
-    if (!args[required]) throw new Error(`--${required} is required`);
-  }
-
-  const target = path.resolve(args.target);
-  const log = path.resolve(args.log);
-  const pidFile = path.resolve(args['pid-file']);
-  const syncScript = path.resolve(args['sync-script']);
-  const syncPidFile = path.resolve(args['sync-pid-file']);
-  const syncLog = path.resolve(args['sync-log']);
-  fs.mkdirSync(path.dirname(log), { recursive: true });
-  fs.mkdirSync(path.dirname(pidFile), { recursive: true });
-  fs.mkdirSync(path.dirname(syncLog), { recursive: true });
-  if (!fs.existsSync(syncScript)) throw new Error(`sync script not found: ${syncScript}`);
-  const logFd = fs.openSync(log, 'a');
-  const syncLogFd = fs.openSync(syncLog, 'a');
-  const env = { ...process.env };
-  if (args.port) env.PORT = String(args.port);
-  if (args['path-prefix']) env.PATH = `${args['path-prefix']}${env.PATH || ''}`;
-
-  try {
-    const child = spawn('yarn', ['start'], {
-      cwd: target,
-      detached: true,
-      env,
-      stdio: ['ignore', logFd, logFd],
-    });
-    await new Promise((resolve, reject) => {
-      child.once('spawn', resolve);
-      child.once('error', reject);
-    });
-    fs.writeFileSync(pidFile, `${child.pid}\n`);
-    const syncChild = spawn(process.execPath, [
-      syncScript,
-      '--watcher-pid', String(child.pid),
-      '--watch-log', log,
-      '--target', target,
-      '--dist', path.resolve(args.dist),
-      '--runtime-dist', path.resolve(args['runtime-dist']),
-      '--pid-file', syncPidFile,
-    ], {
-      cwd: target,
-      detached: true,
-      env,
-      stdio: ['ignore', syncLogFd, syncLogFd],
-    });
-    await new Promise((resolve, reject) => {
-      syncChild.once('spawn', resolve);
-      syncChild.once('error', reject);
-    });
-    fs.writeFileSync(syncPidFile, `${syncChild.pid}\n`);
-    process.stdout.write(`${child.pid}\n`);
-    syncChild.unref();
-    child.unref();
-  } finally {
-    fs.closeSync(logFd);
-    fs.closeSync(syncLogFd);
-  }
-}
-
-main().catch((error) => {
-  process.stderr.write(`launch-webpack: ${error.message}\n`);
-  process.exit(1);
-});

package/adapters/extension/stamp-runtime-title.cjs

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-const { readSlotId } = require('./lib/slot-title.cjs');
-
-function stampRuntimeTitles({ target, runtimeDist, runtimeDir = process.env.RECIPE_RUNTIME_DIR || 'temp/recipe/runtime' }) {
-  const slotId = readSlotId(target, runtimeDir);
-  if (!slotId) return { slotId: '', stamped: [] };
-  const stamped = [];
-  for (const name of ['home.html', 'sidepanel.html']) {
-    const file = path.join(runtimeDist, name);
-    let fd;
-    try {
-      fd = fs.openSync(file, 'r+');
-      const source = fs.readFileSync(fd, 'utf8');
-      const next = source.replace(/<title>([^<]*)<\/title>/iu, (_match, title) => {
-        const base = String(title || 'MetaMask').replace(/^.+?\s+[—–-]\s+/u, '') || 'MetaMask';
-        return `<title>${slotId} — ${base}</title>`;
-      });
-      if (next === source) continue;
-      const bytes = Buffer.from(next, 'utf8');
-      fs.writeSync(fd, bytes, 0, bytes.length, 0);
-      fs.ftruncateSync(fd, bytes.length);
-      stamped.push(name);
-    } catch (error) {
-      if (error?.code !== 'ENOENT') throw error;
-    } finally {
-      if (fd !== undefined) fs.closeSync(fd);
-    }
-  }
-  return { slotId, stamped };
-}
-
-if (require.main === module) {
-  const args = {};
-  for (let index = 2; index < process.argv.length; index += 1) {
-    const key = process.argv[index];
-    if (key === '--help' || key === '-h') {
-      process.stdout.write('Usage: stamp-runtime-title.cjs --target <path> --runtime-dist <path> [--runtime-dir <path>]\n');
-      process.exit(0);
-    }
-    if (!key.startsWith('--') || index + 1 >= process.argv.length) throw new Error(`invalid argument: ${key}`);
-    args[key.slice(2)] = process.argv[++index];
-  }
-  if (!args.target) throw new Error('--target is required');
-  if (!args['runtime-dist']) throw new Error('--runtime-dist is required');
-  const result = stampRuntimeTitles({
-    target: path.resolve(args.target),
-    runtimeDist: path.resolve(args['runtime-dist']),
-    runtimeDir: args['runtime-dir'],
-  });
-  if (result.stamped.length > 0) process.stdout.write(`slot title ${result.slotId}: ${result.stamped.join(', ')}\n`);
-}
-
-module.exports = { stampRuntimeTitles };

package/adapters/extension/sync-webpack-dist.cjs

@@ -1,107 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const { spawnSync } = require('node:child_process');
-const fs = require('node:fs');
-const path = require('node:path');
-const { stampRuntimeTitles } = require('./stamp-runtime-title.cjs');
-
-const args = {};
-for (let index = 2; index < process.argv.length; index += 1) {
-  const key = process.argv[index];
-  if (key === '--help' || key === '-h') {
-    process.stdout.write('Usage: sync-webpack-dist.cjs --watcher-pid <pid> --watch-log <path> --target <path> --dist <path> --runtime-dist <path> --pid-file <path>\n');
-    process.exit(0);
-  }
-  if (!key.startsWith('--') || index + 1 >= process.argv.length) throw new Error(`invalid argument: ${key}`);
-  args[key.slice(2)] = process.argv[++index];
-}
-for (const required of ['watcher-pid', 'watch-log', 'target', 'dist', 'runtime-dist', 'pid-file']) {
-  if (!args[required]) throw new Error(`--${required} is required`);
-}
-
-const watcherPid = Number(args['watcher-pid']);
-if (!Number.isInteger(watcherPid) || watcherPid <= 0) throw new Error('--watcher-pid must be a positive integer');
-
-const watchLog = path.resolve(args['watch-log']);
-const dist = path.resolve(args.dist);
-const runtimeDist = path.resolve(args['runtime-dist']);
-const pidFile = path.resolve(args['pid-file']);
-const compilePattern = /compiled successfully|compiled with \d+ warning|MetaMask .* compiled|Bundle end: service worker|Bundle end:.*app-init/u;
-let offset = 0;
-let carry = '';
-let timer;
-
-function processAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-function removeOwnPidFile() {
-  try {
-    if (fs.readFileSync(pidFile, 'utf8').trim() === String(process.pid)) fs.rmSync(pidFile, { force: true });
-  } catch {
-    // The launcher may have already removed or replaced it.
-  }
-}
-
-function syncRuntimeDist() {
-  if (!fs.existsSync(path.join(dist, 'manifest.json')) || !fs.existsSync(runtimeDist)) return;
-  const result = spawnSync('rsync', ['-a', '--delete', '--delay-updates', '--exclude', '_metadata', `${dist}${path.sep}`, `${runtimeDist}${path.sep}`], {
-    encoding: 'utf8',
-  });
-  if (result.status !== 0) {
-    process.stderr.write(`runtime-dist sync failed: ${(result.stderr || result.stdout || `rsync exited ${result.status}`).trim()}\n`);
-    return;
-  }
-  stampRuntimeTitles({ target: path.resolve(args.target), runtimeDist });
-  process.stdout.write(`runtime-dist updated after webpack compile (${new Date().toISOString()})\n`);
-}
-
-function poll() {
-  if (!processAlive(watcherPid)) {
-    removeOwnPidFile();
-    process.exit(0);
-  }
-  let fd;
-  try {
-    fd = fs.openSync(watchLog, 'r');
-    const size = fs.fstatSync(fd).size;
-    if (size < offset) {
-      offset = 0;
-      carry = '';
-    }
-    if (size > offset) {
-      const length = size - offset;
-      const chunk = Buffer.alloc(length);
-      const bytesRead = fs.readSync(fd, chunk, 0, length, offset);
-      offset += bytesRead;
-      const text = carry + chunk.subarray(0, bytesRead).toString('utf8');
-      const lines = text.split(/\r?\n/u);
-      carry = lines.pop() || '';
-      if (lines.some((line) => compilePattern.test(line))) syncRuntimeDist();
-    }
-  } catch (error) {
-    if (error?.code !== 'ENOENT') process.stderr.write(`runtime-dist sync monitor: ${error.message}\n`);
-  } finally {
-    if (fd !== undefined) fs.closeSync(fd);
-  }
-  timer = setTimeout(poll, 250);
-}
-
-fs.mkdirSync(path.dirname(pidFile), { recursive: true });
-process.on('SIGTERM', () => {
-  clearTimeout(timer);
-  removeOwnPidFile();
-  process.exit(0);
-});
-process.on('SIGINT', () => {
-  clearTimeout(timer);
-  removeOwnPidFile();
-  process.exit(0);
-});
-poll();

package/adapters/mobile/launch-console-forwarder.cjs

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawn } = require('node:child_process');
-
-const args = { port: '', out: '', err: '' };
-for (let i = 2; i < process.argv.length; i += 1) {
-  const key = process.argv[i];
-  if (key === '--port') args.port = process.argv[++i] || '';
-  else if (key === '--out') args.out = process.argv[++i] || '';
-  else if (key === '--err') args.err = process.argv[++i] || '';
-  else if (key === '--help' || key === '-h') {
-    process.stdout.write('Usage: launch-console-forwarder.cjs --port <port> --out <app-log> --err <error-log>\n');
-    process.exit(0);
-  } else {
-    process.stderr.write(`launch-console-forwarder: unknown arg: ${key}\n`);
-    process.exit(2);
-  }
-}
-
-if (!args.port || !args.out || !args.err) {
-  process.stderr.write('launch-console-forwarder: --port, --out, and --err are required\n');
-  process.exit(2);
-}
-
-const forwarder = path.join(__dirname, 'bridge-runtime', 'console-forwarder.cjs');
-const errFd = fs.openSync(args.err, 'a');
-try {
-  const child = spawn(process.execPath, [forwarder, '--port', args.port, '--out', args.out], {
-    detached: true,
-    stdio: ['ignore', errFd, errFd],
-  });
-  child.unref();
-  process.stdout.write(`${child.pid}\n`);
-} finally {
-  fs.closeSync(errFd);
-}

package/adapters/mobile/start-console-forwarder.sh

@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-# Ensure one runner-owned CDP console forwarder is alive for this Mobile slot.
-set -uo pipefail
-
-TARGET="$PWD"
-PORT="${WATCHER_PORT:-${METRO_PORT:-8081}}"
-QUIET=false
-
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --target) [ "$#" -ge 2 ] || { echo "Missing value for --target" >&2; exit 2; }; TARGET="$2"; shift 2 ;;
-    --port)   [ "$#" -ge 2 ] || { echo "Missing value for --port" >&2; exit 2; }; PORT="$2"; shift 2 ;;
-    --quiet)  QUIET=true; shift ;;
-    -h|--help)
-      printf 'Usage: start-console-forwarder.sh [--target <dir>] [--port <port>] [--quiet]\n'
-      exit 0
-      ;;
-    *) printf 'start-console-forwarder: unknown arg: %s\n' "$1" >&2; exit 2 ;;
-  esac
-done
-
-[ "${METAMASK_RECIPE_CONSOLE_FORWARD:-1}" != "0" ] || exit 0
-TARGET="$(cd "$TARGET" && pwd -P)"
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-# shellcheck disable=SC1091
-. "$SCRIPT_DIR/../shared/harness-path.sh"
-LOG_DIR="$TARGET/$(recipe_runtime_dir)" || exit 1
-FORWARDER="$SCRIPT_DIR/bridge-runtime/console-forwarder.cjs"
-PID_FILE="$LOG_DIR/console-forwarder.pid"
-APP_LOG_FILE="$LOG_DIR/app-console.log"
-
-{ [ -f "$FORWARDER" ] && command -v node >/dev/null 2>&1; } || exit 0
-mkdir -p "$LOG_DIR"
-
-# One debugger owns a React Native page. Reap any collector for this Metro port,
-# including one left by an older globally installed harness.
-while read -r pid cmd; do
-  case "$cmd" in
-    *console-forwarder.cjs*" --port $PORT "*|*console-forwarder.cjs*" --port=$PORT "*)
-      kill "$pid" 2>/dev/null || true
-      ;;
-  esac
-done < <(ps -axo pid=,command= 2>/dev/null || true)
-
-if [ -f "$PID_FILE" ]; then
-  old_pid="$(cat "$PID_FILE" 2>/dev/null || true)"
-  if [ -n "$old_pid" ]; then
-    case "$(ps -p "$old_pid" -o command= 2>/dev/null)" in
-      *console-forwarder.cjs*) kill "$old_pid" 2>/dev/null || true ;;
-    esac
-  fi
-  rm -f "$PID_FILE"
-fi
-
-: > "$APP_LOG_FILE"
-pid="$(node "$SCRIPT_DIR/launch-console-forwarder.cjs" \
-  --port "$PORT" \
-  --out "$APP_LOG_FILE" \
-  --err "$LOG_DIR/console-forwarder.err")" || exit 1
-printf '%s\n' "$pid" > "$PID_FILE"
-
-# A successful launch must never claim capture when the collector died at boot.
-sleep 0.1
-if ! kill -0 "$pid" 2>/dev/null; then
-  rm -f "$PID_FILE"
-  printf 'start-console-forwarder: collector exited during startup; inspect %s\n' \
-    "$LOG_DIR/console-forwarder.err" >&2
-  exit 1
-fi
-[ "$QUIET" = true ] || printf 'Device console → app-console.log (CDP forwarder pid %s)\n' "$pid" >&2

package/adapters/shared/update-check-worker.mjs

@@ -1,43 +0,0 @@
-#!/usr/bin/env node
-import fs from 'node:fs';
-import path from 'node:path';
-
-const [cacheFile, timeoutText, endpoint] = process.argv.slice(2);
-const timeoutMs = Number.parseInt(timeoutText ?? '', 10);
-
-function stableVersion(value) {
-  const match = /^(\d{1,6})\.(\d{1,6})\.(\d{1,6})$/u.exec(value);
-  if (!match) return null;
-  return `${Number(match[1])}.${Number(match[2])}.${Number(match[3])}`;
-}
-
-async function main() {
-  if (!cacheFile || !endpoint || !Number.isInteger(timeoutMs) || timeoutMs < 1) return;
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs);
-  try {
-    const response = await fetch(endpoint, { signal: controller.signal });
-    if (!response.ok) return;
-    const data = await response.json();
-    if (!data || typeof data.latest !== 'string' || data.latest.length === 0) return;
-    const latest = stableVersion(data.latest);
-    if (!latest) return;
-    let lastCheck = Date.now();
-    try {
-      const cached = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));
-      if (typeof cached.lastCheck === 'number') lastCheck = cached.lastCheck;
-    } catch {
-      // The parent may have exited before creating the cache; recreate it below.
-    }
-    fs.mkdirSync(path.dirname(cacheFile), { recursive: true });
-    const temporary = `${cacheFile}.${process.pid}.tmp`;
-    fs.writeFileSync(temporary, JSON.stringify({ lastCheck, latest }));
-    fs.renameSync(temporary, cacheFile);
-  } catch {
-    // Passive checks are intentionally silent; the explicit update command teaches failures.
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-await main();

package/dist/adapters/extension/console-capture.js

@@ -1,93 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import { recipeRuntimePath, runnerDir } from "../../paths.js";
-async function ensureExtensionConsoleCapture(target) {
-  const cdpPort = process.env.CDP_PORT ?? process.env.RECIPE_CDP_PORT;
-  if (!cdpPort) throw new Error("Extension console capture requires a resolved CDP port.");
-  const response = await fetch(`http://127.0.0.1:${cdpPort}/json/version`);
-  if (!response.ok) throw new Error(`Extension CDP ${cdpPort} is not ready for console capture.`);
-  const extensionLog = recipeRuntimePath(target, "extension-console.log");
-  const dappLog = recipeRuntimePath(target, "dapp-console.log");
-  const collectorLog = recipeRuntimePath(target, "console-tail.log");
-  const pidFile = recipeRuntimePath(target, "console-tail.pid");
-  fs.mkdirSync(path.dirname(extensionLog), { recursive: true });
-  const existingPid = readPid(pidFile);
-  if (existingPid && collectorOwnsLog(existingPid, extensionLog)) return;
-  if (existingPid) {
-    try {
-      process.kill(existingPid, "SIGTERM");
-    } catch {
-    }
-  }
-  fs.rmSync(pidFile, { force: true });
-  fs.writeFileSync(extensionLog, "");
-  fs.writeFileSync(dappLog, "");
-  const script = path.join(runnerDir, "adapters", "extension", "console-tail.mjs");
-  const output = fs.openSync(collectorLog, "a");
-  let child;
-  try {
-    child = spawn(process.execPath, [
-      script,
-      "--cdp-port",
-      cdpPort,
-      "--extension-log",
-      extensionLog,
-      "--dapp-log",
-      dappLog
-    ], {
-      cwd: target,
-      detached: true,
-      stdio: ["ignore", output, output]
-    });
-  } finally {
-    fs.closeSync(output);
-  }
-  if (!child.pid) throw new Error("Extension console collector did not start.");
-  child.unref();
-  fs.writeFileSync(pidFile, `${child.pid}
-`);
-  for (let attempt = 0; attempt < 100; attempt += 1) {
-    if (!processAlive(child.pid)) break;
-    if (collectorOwnsLog(child.pid, extensionLog) && containsAttachment(extensionLog, dappLog)) return;
-    await new Promise((resolve) => setTimeout(resolve, 100));
-  }
-  throw new Error(`Extension console collector ${child.pid} did not attach to CDP ${cdpPort}.`);
-}
-function processAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function readPid(pidFile) {
-  try {
-    const pid = Number.parseInt(fs.readFileSync(pidFile, "utf8").trim(), 10);
-    return Number.isInteger(pid) && pid > 0 ? pid : null;
-  } catch {
-    return null;
-  }
-}
-function collectorOwnsLog(pid, extensionLog) {
-  try {
-    process.kill(pid, 0);
-  } catch {
-    return false;
-  }
-  const result = spawnSync("ps", ["-p", String(pid), "-o", "command="], { encoding: "utf8" });
-  return result.status === 0 && result.stdout.includes("console-tail.mjs") && result.stdout.includes(extensionLog);
-}
-function containsAttachment(...logs) {
-  return logs.some((log) => {
-    try {
-      return fs.readFileSync(log, "utf8").includes("[attached]");
-    } catch {
-      return false;
-    }
-  });
-}
-export {
-  ensureExtensionConsoleCapture
-};