mirror of
https://github.com/morluto/rea.git
synced 2026-11-19 05:02:40 +00:00
Exercise exact replay ownership, malformed declarations and frame scope, transient recovery, and canonical schema evidence through shared CDP captures. Remove unused fake modes.
135 lines
5.9 KiB
TypeScript
135 lines
5.9 KiB
TypeScript
import type { JsonValue } from "../../src/domain/jsonValue.js";
|
|
import type { CdpEvent } from "../../src/browser/CdpConnection.js";
|
|
import type { ServerResponse } from "node:http";
|
|
import type { PhaseGate } from "../support/lifecycleHarness.js";
|
|
export interface FakeCdpCommand {
|
|
readonly id: number;
|
|
readonly method: string;
|
|
readonly params: Readonly<Record<string, unknown>>;
|
|
readonly sessionId?: string;
|
|
}
|
|
|
|
export interface FakeCdpBrowser {
|
|
readonly endpoint: string;
|
|
readonly browserWebSocketUrl: string;
|
|
readonly allowedOrigin: string;
|
|
readonly commands: readonly FakeCdpCommand[];
|
|
/** Actual WebSocket connections still held by the wire fixture. */
|
|
activeConnectionCount(): number;
|
|
/** WebSocket upgrades accepted over the fixture's lifetime. */
|
|
openedConnectionCount(): number;
|
|
/** Deliver actual malformed wire data without bypassing the production transport parser. */
|
|
emitRawMessage(message: string | Buffer): void;
|
|
emitEvent(event: CdpEvent): void;
|
|
/** Drop currently open WebSockets from the server side to exercise reconnect paths. */
|
|
closeActiveConnections(): void;
|
|
readonly httpRequests: readonly {
|
|
readonly url: string;
|
|
readonly authorization: string | undefined;
|
|
readonly cookie: string | undefined;
|
|
readonly referer: string | undefined;
|
|
}[];
|
|
close(): Promise<void>;
|
|
}
|
|
|
|
export interface FakeOptions {
|
|
/** Send these commands' producer events before acknowledging completion, as a wire barrier. */
|
|
readonly eventsBeforeReply?: readonly string[];
|
|
/** Return a native-shaped command rejection through the actual wire parser. */
|
|
readonly commandError?: (
|
|
command: FakeCdpCommand,
|
|
) => { readonly code: number; readonly message: string } | undefined;
|
|
/** Producer reply seam preserves the real HTTP/WebSocket transport and command parser. */
|
|
readonly commandResult?: (
|
|
command: FakeCdpCommand,
|
|
origin: string,
|
|
frameReads: number,
|
|
) => Readonly<Record<string, unknown>> | undefined;
|
|
/** Return undefined to use the stock producer events; an empty array suppresses them. */
|
|
readonly commandEvents?: (
|
|
command: FakeCdpCommand,
|
|
origin: string,
|
|
) => readonly CdpEvent[] | undefined;
|
|
/** Delay each HTTP discovery document so a short command deadline can be observed separately. */
|
|
readonly discoveryDelayMs?: number;
|
|
/** Delay WebSocket upgrade acceptance so handshake and attach deadlines stay distinct. */
|
|
readonly handshakeDelayMs?: number;
|
|
/**
|
|
* Hold each WebSocket upgrade (by request URL) until the test releases the
|
|
* gate. A held socket the client abandons is destroyed, not accepted.
|
|
*/
|
|
readonly handshakeGate?: PhaseGate<string>;
|
|
/** Delay selected wire replies so one caller's discovery deadline can expire alongside an active peer. */
|
|
readonly commandDelayMs?: (command: FakeCdpCommand) => number | undefined;
|
|
readonly malformedDiscovery?: boolean;
|
|
readonly oversizedDiscovery?: boolean;
|
|
readonly invalidBrowserWebSocket?: boolean;
|
|
readonly pageScopedVersionWebSocket?: boolean;
|
|
readonly omitTargetWebSocket?: boolean;
|
|
readonly additionalPageWithWebSocket?: boolean;
|
|
readonly additionalPageWithoutWebSocket?: boolean;
|
|
readonly additionalPageCount?: number;
|
|
readonly additionalElectronPageCount?: number;
|
|
readonly invalidAttachedSession?: boolean;
|
|
readonly malformedMessageOnMethod?: string;
|
|
readonly malformedEventOnMethod?: string;
|
|
readonly malformedEventShapeOnMethod?: string;
|
|
readonly closeOnMethod?: string;
|
|
readonly hangOnMethod?: string;
|
|
readonly unsupportedMethods?: readonly string[];
|
|
readonly transitionalFrameReads?: number;
|
|
readonly attachedFrameUrl?: string;
|
|
readonly frameUrlAfterFirstRead?: string;
|
|
readonly navigateDuringObservationUrl?: string;
|
|
readonly navigateDuringCaptureUrl?: string;
|
|
readonly navigateDuringScreenshotUrl?: string;
|
|
readonly extraCollections?: boolean;
|
|
readonly indexedDbDateKeys?: boolean;
|
|
readonly foreignSessionEvents?: boolean;
|
|
readonly redirectToDisallowedOrigin?: boolean;
|
|
readonly redirectFromDisallowedOrigin?: boolean;
|
|
readonly redirectWithinOrigin?: boolean;
|
|
readonly malformedRedirectResponse?: boolean;
|
|
readonly omitRedirectResponse?: boolean;
|
|
readonly redirectResponseUrl?: string;
|
|
readonly redirectResponseEnvelope?: unknown;
|
|
readonly responseAfterMalformedUrl?: string;
|
|
readonly unrelatedWorker?: boolean;
|
|
readonly binaryWebSocketEvent?: boolean;
|
|
/** Emit an allowed WebSocket creation without any frames in the capture window. */
|
|
readonly webSocketWithoutFrames?: boolean;
|
|
readonly invalidBinaryWebSocketEvent?: boolean;
|
|
readonly sourceMapBody?: string;
|
|
/** Test-owned HTTP response for selected map URLs; true means handled. */
|
|
readonly sourceMapReply?: (url: string, response: ServerResponse) => boolean;
|
|
/** Accept a source-map request and leave the response open. */
|
|
readonly hangSourceMap?: boolean;
|
|
readonly sourceMapRedirect?: string;
|
|
readonly sessionTimeline?:
|
|
| "same_origin"
|
|
| "outside_policy"
|
|
| "target_detached"
|
|
| "target_crashed";
|
|
readonly closeAfterMethod?: string;
|
|
readonly sensitiveShapes?: boolean;
|
|
/** Deliver a console argument the protocol spells as `{ type: "object", subtype: "null" }`. */
|
|
readonly nullConsoleArgument?: boolean;
|
|
readonly cachedResponseBody?: string;
|
|
readonly invalidResponseBodyBase64?: boolean;
|
|
readonly webMcpTools?: boolean;
|
|
/** Replaces the primary tool's registration stack; returning `undefined` omits it. */
|
|
readonly webMcpStackTrace?: (origin: string) => JsonValue | undefined;
|
|
readonly webMcpFrameCount?: number;
|
|
readonly webMcpChildLeavesScope?: boolean;
|
|
readonly electronFileUrl?: string;
|
|
/** Omit attached from the Electron page's HTTP discovery target. */
|
|
readonly omitElectronTargetAttachmentState?: boolean;
|
|
readonly duplicateElectronInventory?: boolean;
|
|
readonly electronInventoryCount?: number;
|
|
readonly urlShapedAllowedTitle?:
|
|
| boolean
|
|
| "host-path"
|
|
| "root-relative"
|
|
| "prefixed";
|
|
}
|