@deeeed/metamask-harness 0.5.0 → 0.6.0

package/src/adapters/surface.ts

@@ -1,117 +0,0 @@
-// The per-platform surface: one interface every command resolves platform
-// behavior through, so no command hand-rolls `if (adapter === …)` for behavior a
-// platform owns. A command NEVER branches on adapter for behavior this interface
-// owns; a new platform behavior extends the surface (a new member here + its
-// three implementations), not the command. This is the enforcement mechanism for
-// UX-PRINCIPLES.md principle 1 (context-aware by default). See
-// docs/ADAPTER-SURFACE.md.
-
-import type { MetaMaskRecipeAdapter } from '../types.ts';
-import { coreSurface } from './core/surface.ts';
-import { extensionSurface } from './extension/surface.ts';
-import { mobileSurface } from './mobile/surface.ts';
-
-// Read-only runtime readiness, normalized across platforms so `doctor` renders
-// one line the same way regardless of adapter. Device platforms fill deps +
-// devServer; core (headless) reports deps presence only (no devServer).
-export interface AdapterRuntimeStatus {
-  decision: string;
-  reasonCode?: string;
-  reasons: string[];
-  deps?: string;
-  // The platform's dev server (Metro for mobile, webpack watcher for extension),
-  // labelled so the render names the right thing. Absent for headless core.
-  devServer?: { label: string; status: string };
-}
-
-// One log file a platform writes, most-relevant first. `logs` tails the first
-// candidate that exists.
-export interface AdapterLogSource {
-  label: string;
-  path: string;
-}
-
-// Result of stopping the platform's dev server. `headless` is the core case —
-// there is nothing to stop, so `stop` teaches instead. `stopped` carries the
-// exit status plus, when the platform counts them, how many processes were
-// signalled and the raw leaf output for the --json envelope.
-export type AdapterDevServerStop =
-  | { kind: 'headless'; message: string; userAction: string }
-  | { kind: 'stopped'; status: number; summary: string; signalled?: number; output?: string };
-
-export interface AdapterDevServer {
-  // One noun for the dev server this platform runs ("Metro", "webpack watcher").
-  describe(): string;
-  // Stop the dev server this checkout owns, port/pid-scoped. Idempotent:
-  // nothing-to-stop is success, never an error.
-  stop(target: string): AdapterDevServerStop;
-}
-
-// Platform-phrased Next: hints so no command prints another platform's vocabulary.
-// `launch` (re)starts the app + dev server; `relaunch` rebuilds first (the
-// fixtures-set retry). core has no app, so its hints teach the headless path.
-export interface AdapterHints {
-  launch: string;
-  relaunch: string;
-}
-
-export interface AdapterRunwayProvisionOptions {
-  json?: boolean;
-  platform?: string;
-  branch?: string;
-  defaultBranch?: string;
-  run?: string;
-  cacheRoot?: string;
-  simulator?: string;
-  runtime?: string;
-  deviceType?: string;
-  slot?: string;
-  watcherPort?: string;
-  runtimeDir?: string;
-  force?: boolean;
-  resolveOnly?: boolean;
-  rerunCommand: string;
-}
-
-export interface AdapterRunwayProvisionResult {
-  schemaVersion: 1;
-  command: 'provision';
-  adapter: MetaMaskRecipeAdapter;
-  target: string;
-  platform?: string;
-  status: 'pass' | 'fail';
-  exitCode: number;
-  error?: { code: string; message: string; userAction: string };
-  [key: string]: unknown;
-}
-
-export interface AdapterRunwayProvision {
-  run(target: string, options: AdapterRunwayProvisionOptions): Promise<AdapterRunwayProvisionResult>;
-}
-
-export interface AdapterSurface {
-  readonly adapter: MetaMaskRecipeAdapter;
-  // core runs no app/dev server; device adapters (mobile/extension) do. Commands
-  // ask this instead of testing `adapter === 'core'`.
-  readonly headless: boolean;
-  // Resolve slot ports/device into the environment (checkout context > pool >
-  // formula). No-op for core.
-  resolveSlotPorts(target: string): void;
-  // Read-only readiness for `doctor`. Never launches or mutates.
-  runtimeStatus(target: string): Promise<AdapterRuntimeStatus>;
-  devServer: AdapterDevServer;
-  runwayProvision: AdapterRunwayProvision;
-  // Ordered candidate log files for `logs`. Empty for core.
-  logSources(target: string): AdapterLogSource[];
-  hints: AdapterHints;
-}
-
-const SURFACES: Record<MetaMaskRecipeAdapter, AdapterSurface> = {
-  mobile: mobileSurface,
-  extension: extensionSurface,
-  core: coreSurface,
-};
-
-export function getAdapterSurface(adapter: MetaMaskRecipeAdapter): AdapterSurface {
-  return SURFACES[adapter];
-}