@dev-blinq/bvt-playwright-js 1.0.0-dev.4.latest.158.1 → 1.0.0-dev.4.latest.177.1

package/index.d.mts

@@ -277,6 +277,7 @@ declare const elementAssertionSchema: z.ZodDiscriminatedUnion<[
 		type: z.ZodLiteral<"toHaveProperty">;
 		name: z.ZodString;
 		operator: z.ZodOptional<z.ZodEnum<{
+			regex: "regex";
 			equals: "equals";
 			notEquals: "notEquals";
 			contains: "contains";
@@ -2021,6 +2022,7 @@ declare const CommandSchema: z.ZodDiscriminatedUnion<[
 				type: z.ZodLiteral<"toHaveProperty">;
 				name: z.ZodString;
 				operator: z.ZodOptional<z.ZodEnum<{
+					regex: "regex";
 					equals: "equals";
 					notEquals: "notEquals";
 					contains: "contains";
@@ -5031,6 +5033,7 @@ declare const StepDefinitionSchema: z.ZodObject<{
 					type: z.ZodLiteral<"toHaveProperty">;
 					name: z.ZodString;
 					operator: z.ZodOptional<z.ZodEnum<{
+						regex: "regex";
 						equals: "equals";
 						notEquals: "notEquals";
 						contains: "contains";
@@ -9305,6 +9308,19 @@ type TesterSession = {
 	 */
 	screenshots?: {
 		enabled: boolean;
+		/**
+		 * "upload" (default): Tester requests presigned URLs and uploads the
+		 * captured JPEGs to S3 itself at the end of the testcase.
+		 * "local": Tester captures JPEGs to `outputDir` and leaves them on disk
+		 * for an out-of-band uploader (mirrors the local-trace mode used by the
+		 * execution worker, which has no presigned-URL API client).
+		 */
+		mode?: "upload" | "local";
+		/**
+		 * Local-mode capture directory. When omitted a per-testcase /tmp dir is
+		 * used. Ignored in "upload" mode.
+		 */
+		outputDir?: string;
 	};
 	deterministicRecoveryMode?: "new-tour-maintenance";
 };
@@ -9323,6 +9339,7 @@ type ExecuteStepsOptions = {
 	onFinish?: () => Promise<void>;
 	onError?: (error: Error) => Promise<void>;
 	abortController?: AbortController;
+	recoveryAbortController?: AbortController;
 };
 type GetAPIClient = (sessionToken: string) => TesterApiClient;
 declare class Tester {

package/index.mjs

@@ -5170,7 +5170,8 @@ const ASSERTION_OPERATORS = [
 	"contains",
 	"lessThan",
 	"greaterThan",
-	"exists"
+	"exists",
+	"regex"
 ];
 
 //#endregion
@@ -10936,6 +10937,7 @@ const AiChatDataExecutionStatusPartSchema = object({
 * from the call sites in `apps/ai-server/src/mastra/agents/`:
 *   - `observe-act-loop` (observe-act-completion happy path)
 *   - `observe-act-loop-cap-reached` (loop hit iteration cap mid-run)
+*   - `form-fill-batch` (on-mode form-fill fast-path success)
 *   - `segment-followup` (apps/ai-server/src/trpc/router.ts segment-followup path)
 * Plus the AiStepDraftMode values used by client-side fixtures that did not
 * originate from the observe-act loop (legacy: `new-ai-step`, `edit-ai-step`).
@@ -10946,6 +10948,7 @@ const AiChatDataExecutionStatusPartSchema = object({
 const AiChatDataCompleteModeSchema = _enum([
 	"observe-act-loop",
 	"observe-act-loop-cap-reached",
+	"form-fill-batch",
 	"segment-followup",
 	"new-ai-step",
 	"edit-ai-step"
@@ -26320,6 +26323,9 @@ const NEW_TOUR_MAINTENANCE_RECOVERY_ARTIFACT = {
 	aiLog: "BlinqIO matched the original gender-selection intent to the new radio button UI and rewrote the stale command.",
 	description: "The repaired step selects the gender radio option, then continues the registration flow successfully."
 };
+function isAbortError(error) {
+	return error instanceof Error && error.name === "AbortError";
+}
 const unconfiguredGetAPIClient = () => {
 	throw new Error("Tester was created without an API client.");
 };
@@ -26454,7 +26460,7 @@ var Tester = class {
 		return `${this.dataContext?.projectId ?? ""}/${session.reportId}/testcases/${session.testCaseId}/resources/screenshots/${stepId}-${commandId}-${phase}.jpg`;
 	}
 	getScreenshotTempDir(session) {
-		if (!this.tempPathForAssets) this.tempPathForAssets = join("/tmp", `blinq-screenshots-${session.reportId}-${session.testCaseId}`);
+		if (!this.tempPathForAssets) this.tempPathForAssets = session.screenshots?.outputDir ?? join("/tmp", `blinq-screenshots-${session.reportId}-${session.testCaseId}`);
 		return this.tempPathForAssets;
 	}
 	/**
@@ -27044,6 +27050,16 @@ var Tester = class {
 			});
 			return false;
 		}
+		if (session.screenshots?.mode === "local") {
+			this.obs.logger.log("Screenshots captured in local mode; leaving files for out-of-band upload", {
+				reportId: session.reportId,
+				testCaseId: session.testCaseId,
+				capturedCount,
+				dir: this.tempPathForAssets
+			});
+			this.capturedScreenshots = [];
+			return capturedCount > 0;
+		}
 		if (!session.token) {
 			this.obs.metrics.count("bvt_agent.screenshots.upload.skipped.total", 1, { reason: "no-session-token" });
 			this.obs.logger.warn(`Screenshot upload skipped because no session token was provided for reportId: ${session.reportId}, testCaseId: ${session.testCaseId}.`);
@@ -27275,7 +27291,21 @@ var Tester = class {
 						timestamp: (/* @__PURE__ */ new Date()).toISOString()
 					};
 					const failureContext = this.buildFailureContext(command, recorderStep, stepDefinitionId, commandIndex, commandContext, executionError);
-					const recoveryResult = await this.recoveryController.analyzeAndPropose(failureContext);
+					const recoveryContext = {
+						...failureContext,
+						abortSignal: options.recoveryAbortController?.signal ?? failureContext.abortSignal
+					};
+					let recoveryResult;
+					try {
+						recoveryResult = await this.recoveryController.analyzeAndPropose(recoveryContext);
+					} catch (recoveryError) {
+						if (isAbortError(recoveryError)) {
+							this.obs.logger.log("AI recovery cancelled; preserving original command failure", { commandId: command._id });
+							yield await this.onCommandFail(command, stepDefinitionId, executionError, session);
+							throw executionError;
+						}
+						throw recoveryError;
+					}
 					const { decision } = recoveryResult;
 					let artifact = recoveryResult.artifact;
 					if (this.shouldAttemptAiRecovery(session)) {
@@ -27344,7 +27374,7 @@ var Tester = class {
 								if (!persistResult.success) throw new Error(persistResult.error);
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: true,
 									stoppedReason: "accept-repair",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "succeeded")
@@ -27403,7 +27433,7 @@ var Tester = class {
 								});
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: false,
 									stoppedReason: "retry_failed",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "failed")
@@ -27424,7 +27454,7 @@ var Tester = class {
 								terminalExecutionError = /* @__PURE__ */ new Error(`${decision.userFacingMessages.failed}. Repair application failure: ${appliedRepair.error}. Original failure: ${executionError.message}`);
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: false,
 									stoppedReason: "repair_application_failed",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "failed")
@@ -27485,7 +27515,7 @@ var Tester = class {
 								if (!persistResult.success) throw new Error(persistResult.error);
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: true,
 									stoppedReason: "accept-repair",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "succeeded")
@@ -27545,7 +27575,7 @@ var Tester = class {
 								});
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: false,
 									stoppedReason: "retry_failed",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "failed")
@@ -27565,7 +27595,7 @@ var Tester = class {
 							else {
 								artifact = await this.generateRecoveryArtifactForOutcome({
 									decision,
-									failureContext,
+									failureContext: recoveryContext,
 									recoverySucceeded: false,
 									stoppedReason: "repair_application_failed",
 									attemptLog: this.buildStepRepairAttemptLog(decision, "failed")
@@ -27978,6 +28008,33 @@ var Tester = class {
 							if (!(actual > threshold)) throw new Error(`Property "${assertion.name}" expected to be greater than ${threshold}, but got ${actual}`);
 						}
 						break;
+					case "regex":
+						if (assertion.value !== void 0) {
+							const raw = getValueFromPrimitiveOrRegex(assertion.value);
+							const pattern = raw instanceof RegExp ? raw : new RegExp(String(raw));
+							this.obs.logger.info(`Expected property "${assertion.name}" to match pattern: ${pattern}`);
+							const propName = assertion.name;
+							const isTextProp = propName === "textContent" || propName === "innerText";
+							const isHtmlAttr = [
+								"href",
+								"src",
+								"class",
+								"id",
+								"placeholder",
+								"title",
+								"alt",
+								"name",
+								"type",
+								"action",
+								"target",
+								"rel",
+								"value"
+							].includes(propName) || propName.startsWith("data-") || propName.startsWith("aria-");
+							if (isTextProp) await expect(locator).toHaveText(pattern, assertion.options);
+							else if (isHtmlAttr) await expect(locator).toHaveAttribute(propName, pattern, assertion.options);
+							else await expect.poll(async () => locator.evaluate((el, name) => String(el[name] ?? ""), propName), { timeout: assertion.options?.timeout }).toMatch(pattern);
+						}
+						break;
 					case "exists": {
 						const exists = await locator.evaluate((el, name) => el[name] !== void 0, assertion.name);
 						this.obs.logger.info(`Expected property "${assertion.name}" to exist: ${exists}`);
@@ -28033,7 +28090,9 @@ var Tester = class {
 					const frame = await this.getFrameObjectFromFrameScope(frameScope);
 					this.obs.logger.info(`Checking for absence of element with text ${value} using "${locator.first()?._selector}" `);
 					this.obs.logger.info(`Waiting for page to load and stabilize before checking for absence of text to reduce flakiness...`);
-					await frame.waitForLoadState("networkidle", { timeout: 3e4 });
+					await frame.waitForLoadState("networkidle", { timeout: 3e4 }).catch((error) => {
+						this.obs.logger.error(`Frame load timeout, the page may not be in the desired state yet`, error);
+					});
 					this.obs.logger.info(`frame load detected. Waiting an additional 500ms for stabilization...`);
 					await frame.waitForTimeout(500);
 					this.obs.logger.info(`Checking for element with text "${value}" after page load and stabilization delay...`);