@dev-blinq/bvt-playwright-js 1.0.0-dev.4.staging.146.1 → 1.0.0-dev.4.staging.155.1

package/index.d.mts

@@ -7441,10 +7441,26 @@ type ExecutionStatusUpdateEventData = {
 	result: ExecResult;
 	resolvedChosenSelectorIndex?: number;
 	recovery?: RecoveryMetadata;
+	/**
+	 * Deterministic S3 keys for the before/after screenshots captured around
+	 * this command. Present only when screenshot capture is enabled for the
+	 * run; keys reflect the intended upload location (upload happens at the
+	 * end of the testcase).
+	 */
+	screenshots?: {
+		before?: string;
+		after?: string;
+	};
 } | RecoveryStatusEvent;
 type ExecutionCompletedEventData = {
 	type: "execution_completed";
 	result: ExecResult;
+	/**
+	 * True when before/after command screenshots were captured and at least one
+	 * was successfully uploaded to S3 for this run. Forwarded by the client into
+	 * `reports.onFinishTestCase` so it persists onto the testcase document.
+	 */
+	screenshotsAvailable?: boolean;
 };
 type ExecutionStartedEventData = {
 	type: "execution_started";
@@ -9083,6 +9099,25 @@ type TraceUploadRequestInput = {
 	testCaseId: string;
 	projectId: string;
 };
+type ScreenshotUploadPhase = "before" | "after";
+type ScreenshotUploadFileDescriptor = {
+	stepId: string;
+	commandId: string;
+	phase: ScreenshotUploadPhase;
+};
+type ScreenshotUploadRequestInput = {
+	reportId: string;
+	testCaseId: string;
+	projectId: string;
+	files: ScreenshotUploadFileDescriptor[];
+};
+type ScreenshotUploadTarget = {
+	stepId: string;
+	commandId: string;
+	phase: ScreenshotUploadPhase; /** S3 object key the file will live at (deterministic convention). */
+	key: string; /** Presigned PUT URL for uploading the screenshot. */
+	url: string;
+};
 type ReplayOrchestratorResult = {
 	classification: {
 		label: string;
@@ -9098,6 +9133,9 @@ type TesterApiClient = {
 		getPresignedUrlForTraceUpload: {
 			query(input: TraceUploadRequestInput): Promise<string>;
 		};
+		getPresignedUrlsForScreenshotUpload: {
+			query(input: ScreenshotUploadRequestInput): Promise<ScreenshotUploadTarget[]>;
+		};
 	};
 	project: {
 		getProjectSettings: {
@@ -9260,6 +9298,15 @@ type TesterSession = {
 	token?: string;
 	trace?: TesterTraceConfig;
 	runWithAiRecovery?: boolean;
+	/**
+	 * When enabled, a viewport JPEG is captured before and after every
+	 * command and the set is uploaded to S3 at the end of the testcase.
+	 * Off by default — capture adds latency to every command.
+	 */
+	screenshots?: {
+		enabled: boolean;
+	};
+	deterministicRecoveryMode?: "new-tour-maintenance";
 };
 type ExecuteStepsInput = {
 	recorderSteps: {
@@ -9299,6 +9346,19 @@ declare class Tester {
 	private sessionToken;
 	private activeBrowserContext;
 	private reportId;
+	private tempPathForAssets;
+	/**
+	 * Per-testcase log of before/after command screenshots captured on disk,
+	 * pending batch upload to S3 at the end of the run. Reset in onTestCaseStart.
+	 */
+	private capturedScreenshots;
+	/**
+	 * Per-testcase screenshot counters (reset in onTestCaseStart) used purely for
+	 * observability — how many commands were eligible for capture and how many
+	 * capture attempts failed. Upload counters are derived at upload time.
+	 */
+	private screenshotCommandsConsidered;
+	private screenshotCaptureFailures;
 	constructor(getAPIClient?: GetAPIClient, observabilityOrOptions?: AgentObservabilityInput | TesterOptions, optionsArg?: TesterOptions);
 	setContext(context: ResolutionContext): void;
 	setStepTraceChunkCallbacks(callbacks: StepTraceChunkCallbacks | undefined): void;
@@ -9309,6 +9369,22 @@ declare class Tester {
 	private summarizeErrorForExecutionLog;
 	private summarizeSessionForExecutionLog;
 	private getCommandText;
+	private screenshotsEnabled;
+	/**
+	 * Deterministic S3 key for a command screenshot. Must match the convention
+	 * used by the server's `getPresignedUrlsForScreenshotUpload` route so the
+	 * keys recorded on the command report point at the uploaded objects.
+	 */
+	private buildScreenshotKey;
+	private getScreenshotTempDir;
+	/**
+	 * Captures a viewport JPEG of the active page for the given command/phase,
+	 * writes it to the per-testcase temp dir, and records it for later upload.
+	 * Best-effort: any failure (no page, screenshot error) is logged and yields
+	 * `undefined` so command execution is never affected.
+	 */
+	private captureCommandScreenshot;
+	private toScreenshotRefs;
 	private onCommandStart;
 	private onCommandPass;
 	private onCommandFail;
@@ -9320,6 +9396,12 @@ declare class Tester {
 	private isRunSession;
 	private isRecordingReplaySession;
 	private shouldAttemptAiRecovery;
+	private isNewTourMaintenanceRecoverySession;
+	private shouldUseNewTourMaintenanceRecovery;
+	private inferNewTourGenderOption;
+	private buildNewTourGenderRadioCommand;
+	private buildNewTourGenderRepairPlan;
+	private recoverNewTourMaintenanceGenderCommand;
 	private isSupportedRepairContext;
 	private shouldUploadTrace;
 	private resolveTraceOutputPath;
@@ -9330,6 +9412,16 @@ declare class Tester {
 	private wait;
 	private uploadFile;
 	private uploadTraceFile;
+	private putFileWithRetries;
+	private cleanupScreenshotTempDir;
+	/**
+	 * Batch-uploads all command screenshots captured during the run to S3.
+	 * Fetches a presigned PUT URL per file in a single round-trip, then uploads
+	 * each with retries. Best-effort: returns true when at least one screenshot
+	 * was uploaded, false otherwise (or when there is nothing/no token). Always
+	 * cleans up the on-disk temp files. Never throws.
+	 */
+	private uploadScreenshots;
 	private onTestCaseFail;
 	private isBrowserDerivedCommand;
 	private buildFailureContext;