@dev-blinq/bvt-playwright-js 1.0.0-dev.3 → 1.0.0-dev.4.latest.103.1

package/index.d.mts

@@ -1,7 +1,6 @@
 import { z } from "zod";
-import { Browser, BrowserContext, ConnectOptions, Frame, FrameLocator, LaunchOptions, Locator, Page } from "@playwright/test";
+import { Browser, BrowserContext, ConnectOptions, Frame, FrameLocator, LaunchOptions, Locator, Page, TestType } from "@playwright/test";
 import * as playwright from 'playwright';
-import * as playwright_core0 from 'playwright-core';
 
 declare const apiResponseSnapshotSchema: z.ZodObject<{
 	status: z.ZodNumber;
@@ -13,6 +12,85 @@ declare const apiResponseSnapshotSchema: z.ZodObject<{
 	bodyJson: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strict>;
 type ApiResponseSnapshot = z.infer<typeof apiResponseSnapshotSchema>;
+declare const apiRequestSchema: z.ZodObject<{
+	method: z.ZodEnum<{
+		GET: "GET";
+		POST: "POST";
+		PUT: "PUT";
+		PATCH: "PATCH";
+		DELETE: "DELETE";
+	}>;
+	url: z.ZodString;
+	headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+	body: z.ZodOptional<z.ZodString>;
+	saveAs: z.ZodOptional<z.ZodString>;
+	capturedResponse: z.ZodOptional<z.ZodObject<{
+		status: z.ZodNumber;
+		statusText: z.ZodString;
+		timeMs: z.ZodNumber;
+		sizeBytes: z.ZodNumber;
+		headers: z.ZodRecord<z.ZodString, z.ZodString>;
+		bodyText: z.ZodString;
+		bodyJson: z.ZodOptional<z.ZodUnknown>;
+	}, z.core.$strict>>;
+	options: z.ZodOptional<z.ZodObject<{
+		timeout: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+	}, z.core.$strict>>;
+}, z.core.$strict>;
+type ApiRequest = z.infer<typeof apiRequestSchema>;
+declare const apiResponseAssertionCommandData: z.ZodDiscriminatedUnion<[
+	z.ZodObject<{
+		operator: z.ZodEnum<{
+			equals: "equals";
+			notEquals: "notEquals";
+			contains: "contains";
+			lessThan: "lessThan";
+			greaterThan: "greaterThan";
+			exists: "exists";
+		}>;
+		target: z.ZodLiteral<"status">;
+		expected: z.ZodString;
+	}, z.core.$strict>,
+	z.ZodObject<{
+		operator: z.ZodEnum<{
+			equals: "equals";
+			notEquals: "notEquals";
+			contains: "contains";
+			lessThan: "lessThan";
+			greaterThan: "greaterThan";
+			exists: "exists";
+		}>;
+		target: z.ZodLiteral<"responseTime">;
+		expected: z.ZodString;
+	}, z.core.$strict>,
+	z.ZodObject<{
+		operator: z.ZodEnum<{
+			equals: "equals";
+			notEquals: "notEquals";
+			contains: "contains";
+			lessThan: "lessThan";
+			greaterThan: "greaterThan";
+			exists: "exists";
+		}>;
+		expected: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+		target: z.ZodLiteral<"header">;
+		path: z.ZodString;
+	}, z.core.$strict>,
+	z.ZodObject<{
+		operator: z.ZodEnum<{
+			equals: "equals";
+			notEquals: "notEquals";
+			contains: "contains";
+			lessThan: "lessThan";
+			greaterThan: "greaterThan";
+			exists: "exists";
+		}>;
+		expected: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+		target: z.ZodLiteral<"bodyField">;
+		path: z.ZodString;
+	}, z.core.$strict>
+], "target">;
+type ApiResponseAssertionCommandData = z.infer<typeof apiResponseAssertionCommandData>;
 declare const elementActionSchema: z.ZodDiscriminatedUnion<[
 	z.ZodObject<{
 		type: z.ZodLiteral<"click">;
@@ -7159,8 +7237,8 @@ declare const RecoveryMetadataSchema: z.ZodObject<{
 	healedSelector: z.ZodOptional<z.ZodString>;
 	commandPatchSummary: z.ZodOptional<z.ZodString>;
 	retryOutcome: z.ZodEnum<{
-		failed: "failed";
 		passed: "passed";
+		failed: "failed";
 	}>;
 	recoveredAt: z.ZodOptional<z.ZodString>;
 	healedLocatorPersistedAt: z.ZodOptional<z.ZodString>;
@@ -7189,11 +7267,11 @@ declare const RecoveryStatusEventSchema: z.ZodObject<{
 	stepId: z.ZodString;
 	commandId: z.ZodString;
 	phase: z.ZodEnum<{
+		failed: "failed";
 		analyzing: "analyzing";
 		trying_fix: "trying_fix";
 		checking_fix: "checking_fix";
 		fixed: "fixed";
-		failed: "failed";
 	}>;
 	message: z.ZodString;
 	timestamp: z.ZodString;
@@ -7331,6 +7409,7 @@ type ExecutionStatusUpdateEventData = {
 	stepDefinitionId: string;
 	completedAt?: ExecutionEventTimestamp;
 	result: ExecResult;
+	resolvedChosenSelectorIndex?: number;
 	recovery?: RecoveryMetadata;
 } | RecoveryStatusEvent;
 type ExecutionCompletedEventData = {
@@ -7819,6 +7898,7 @@ declare const ExecutionResultSchema: z.ZodObject<{
 		data: z.ZodOptional<z.ZodUnknown>;
 	}, z.core.$strict>>>>;
 	duration: z.ZodNumber;
+	screenshotBefore: z.ZodOptional<z.ZodString>;
 	screenshotAfter: z.ZodOptional<z.ZodString>;
 	mutationSignals: z.ZodOptional<z.ZodObject<{
 		httpMutations: z.ZodArray<z.ZodObject<{
@@ -7942,7 +8022,7 @@ declare class DownloadStore {
 	cancelAll(): void;
 }
 type CustomCodeAllowedHost = {
-	readonly protocol: "http:" | "https:";
+	readonly protocol: "http:" | "https:" | "pg:";
 	readonly hostname: string;
 };
 type CustomCodePolicy = {
@@ -7957,6 +8037,7 @@ type CustomCodePolicy = {
 	readonly network: {
 		readonly allowedHosts: readonly CustomCodeAllowedHost[];
 		readonly blockPrivateIpRanges: boolean;
+		readonly requirePgTls: boolean;
 	};
 	readonly filesystem: {
 		readonly root: string;
@@ -8133,11 +8214,13 @@ type CustomCodeRuntimeOptions = {
 	readonly driver?: CustomCodeDriver;
 	readonly policy?: CustomCodePolicy;
 	readonly logger?: AgentLoggerInput;
+	readonly pgHostBridge?: boolean;
 };
 declare class CustomCodeRuntime {
 	private readonly driver;
 	private readonly policy;
 	private readonly logger?;
+	private readonly pgHostBridge;
 	constructor(options?: CustomCodeRuntimeOptions);
 	execute(input: ExecuteCustomCodeInput): Promise<CustomCodeExecutionResult>;
 }
@@ -8830,6 +8913,7 @@ declare class BrowserObserver {
 	private rrwebBufferedBytes;
 	private rrwebCommandAnchors;
 	static instance: BrowserObserver | null;
+	private writeConsole;
 	private getRrwebChunkEventCountThreshold;
 	private getRrwebChunkByteThreshold;
 	private getRrwebMaskProfile;
@@ -8976,9 +9060,9 @@ type GlobalThis = {
 	__bvt_emit: (event: any) => void;
 };
 declare const browserTypesMap: {
-	chromium: playwright_core0.BrowserType<{}>;
-	firefox: playwright_core0.BrowserType<{}>;
-	webkit: playwright_core0.BrowserType<{}>;
+	chromium: playwright.BrowserType<{}>;
+	firefox: playwright.BrowserType<{}>;
+	webkit: playwright.BrowserType<{}>;
 };
 type BrowserConnectInput = {
 	browser: {
@@ -9182,12 +9266,12 @@ declare class Tester {
 	launchBrowser(input: BrowserLaunchInput): Promise<{
 		browser: Browser;
 		browserContext: BrowserContext;
-		browserType: playwright_core0.BrowserType<{}>;
+		browserType: playwright.BrowserType<{}>;
 	}>;
 	connectBrowser(input: BrowserConnectInput): Promise<{
 		browser: Browser;
 		browserContext: BrowserContext;
-		browserType: playwright_core0.BrowserType<{}>;
+		browserType: playwright.BrowserType<{}>;
 	}>;
 	openTab(browserContext: BrowserContext, config?: {
 		url?: string;
@@ -9235,6 +9319,7 @@ declare class Tester {
 		result?: unknown;
 		error?: string | undefined;
 		userMessage?: string | undefined;
+		screenshotBefore?: string | undefined;
 		screenshotAfter?: string | undefined;
 		mutationSignals?: {
 			httpMutations: {
@@ -9279,6 +9364,8 @@ declare class Tester {
 		headers: Record<string, string>;
 		bodyText: string;
 		bodyJson?: unknown;
+	} | {
+		resolvedChosenSelectorIndex: number;
 	} | undefined>;
 	/**
 	 * Runtime test-data accessor bound to the tester's current data provider and
@@ -9361,6 +9448,67 @@ export declare function toMatcherValue(value: MatcherValueInput): string | numbe
 export declare function toMatcherValue(value: undefined): undefined;
 export declare function toMatcherValue(value: MatcherValueInput | undefined): string | number | boolean | RegExp | undefined;
 type GeneratedCommand = Command;
+/**
+ * Stateful API helper for generated `api.action` / `api.assertion` steps.
+ * Mirrors the Tester's runtime: a request stores its response as `lastResponse`
+ * (and writes `saveAs` to runtime test data), and an assertion runs against
+ * that stored response. The shared state lives here because the request and
+ * assertion are emitted as separate `test.step` blocks with no shared scope.
+ */
+export type BlinqApi = {
+	/** Run the request, store it as `lastResponse`, and persist `saveAs` if set. */
+	request(request: ApiRequest): Promise<ApiResponseSnapshot>;
+	/** Assert against `lastResponse`; throws if no request has run yet. */
+	assert(assertion: ApiResponseAssertionCommandData): Promise<void>;
+	readonly lastResponse: ApiResponseSnapshot | undefined;
+};
+/**
+ * The `context` object AI-chat (`custom`) command code receives. Mirrors the
+ * recorder sandbox's `context`: the resolution-scope fields plus a `testData`
+ * accessor (which is the runner's `TestDataApi`, exposing
+ * `set`/`get`/`setRuntime`/`getRuntime`).
+ */
+export type AiChatContext = {
+	readonly testData: TestDataApi;
+	readonly projectId?: string;
+	readonly environmentId?: string;
+	readonly featureId?: string;
+	readonly scenarioId?: string;
+	readonly executionId?: string;
+};
+/**
+ * The globals AI-chat custom code expects beyond `page` / `expect` / `console`.
+ * Generated specs declare `context`, `checkpoint`, `onCommandStart`, and
+ * `onCommandPass` above the inlined code, sourced from the bvt fixture.
+ *
+ * Recovery helpers (`helpers.getPreferredInteractiveTarget`, etc.) are
+ * intentionally NOT provided — they depend on bvt-agent's runtime recovery and
+ * have no standalone equivalent.
+ */
+export type AiChatGlobals = {
+	readonly context: AiChatContext;
+	checkpoint(label: string, data?: unknown): void;
+	onCommandStart(label: string): Promise<void>;
+	onCommandPass(opts?: {
+		delayMs?: number;
+	}): Promise<void>;
+};
+/**
+ * Build the AI-chat command globals. Mirrors the recorder sandbox:
+ * `onCommandStart` waits the watch-delay then records the command boundary,
+ * `onCommandPass` waits the (overridable) watch-delay, and `checkpoint`
+ * records a labelled marker. In a standalone Playwright run the sandbox's
+ * live-timeline bridge is replaced by Playwright test annotations (via the
+ * injected `annotate` callback).
+ */
+export declare function createAiChatGlobals(input: {
+	testDataApi: TestDataApi;
+	parameters: PlaywrightRunnerParameters;
+	annotate: (annotation: {
+		type: string;
+		description: string;
+	}) => void;
+}): AiChatGlobals;
 export declare class TempFileTestDataProvider implements ITestDataProvider {
 	readonly filePath: string;
 	readonly seedFilePath?: string | undefined;
@@ -9392,6 +9540,7 @@ export declare class PlaywrightRunner {
 	private readonly scopeManager?;
 	private readonly preprocessors;
 	private resolutionContext;
+	private apiRuntime?;
 	constructor(options?: PlaywrightRunnerOptions, dependencies?: PlaywrightRunnerDependencies);
 	private applyResolutionContext;
 	/**
@@ -9400,6 +9549,13 @@ export declare class PlaywrightRunner {
 	 */
 	attach(page: Page): void;
 	detach(): void;
+	/**
+	 * Stateful API helper for `api.action` / `api.assertion` steps. Lazily built
+	 * and held for the runner's lifetime so a request and its following assertion
+	 * share `lastResponse`. Throws if no test-data provider/context is available
+	 * (the `saveAs` path needs it).
+	 */
+	get api(): BlinqApi;
 	executeCommand(command: GeneratedCommand, parameters?: Record<string, string>): Promise<unknown>;
 	/**
 	 * Run the preprocessor pipeline (step parameters, data-resolver tokens,
@@ -9472,6 +9628,25 @@ export type BlinqTestRuntime = {
 	 * `{{key}}` in later steps.
 	 */
 	readonly testDataApi: TestDataApi;
+	/**
+	 * Stateful API helper. `api.action` steps call `bvt.api.request(...)` and
+	 * `api.assertion` steps call `bvt.api.assert(...)`; the request's response is
+	 * shared with the following assertion via `bvt.api.lastResponse`.
+	 */
+	readonly api: BlinqApi;
+	/**
+	 * The `context` object AI-chat (`custom`) command code receives; generated
+	 * specs declare `const context = bvt.aiChatContext` above the inlined code.
+	 */
+	readonly aiChatContext: AiChatContext;
+	/** AI-chat `checkpoint(label, data?)` global — records a Playwright annotation. */
+	checkpoint(label: string, data?: unknown): void;
+	/** AI-chat `onCommandStart(label)` global — watch-delay then a boundary annotation. */
+	onCommandStart(label: string): Promise<void>;
+	/** AI-chat `onCommandPass(opts?)` global — watch-delay (overridable via `delayMs`). */
+	onCommandPass(opts?: {
+		delayMs?: number;
+	}): Promise<void>;
 	executeCommand(command: GeneratedCommand, parameters?: Record<string, string>): Promise<unknown>;
 	resolveCommand(command: unknown, parameters?: Record<string, string>): Promise<Command>;
 	find(command: Command): Promise<Locator | Page | FrameLocator | null>;
@@ -9495,7 +9670,7 @@ export type BlinqTestFixtures = {
  * Generated spec files import `test` from this function and call
  * `bvt.executeCommand(...)` inside `test.step` blocks.
  */
-export declare function createBlinqTest(options?: CreateBlinqTestOptions): import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & BlinqTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export declare function createBlinqTest(options?: CreateBlinqTestOptions): TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & BlinqTestFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
 
 export {
 	createBlinqTest as default,