ccqa 0.1.6 → 0.3.3

package/dist/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "ccqa",
+  "version": "0.3.3",
+  "type": "module",
+  "description": "Browser test recorder powered by Claude Code and agent-browser",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shibukazu/ccqa.git"
+  },
+  "homepage": "https://github.com/shibukazu/ccqa#readme",
+  "bugs": {
+    "url": "https://github.com/shibukazu/ccqa/issues"
+  },
+  "bin": {
+    "ccqa": "./dist/bin/ccqa.mjs"
+  },
+  "exports": {
+    "./test-helpers": {
+      "types": "./dist/runtime/test-helpers.d.mts",
+      "import": "./dist/runtime/test-helpers.mjs"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.87",
+    "@anthropic-ai/claude-code": "^2.1.87",
+    "commander": "^14.0.3",
+    "gray-matter": "^4.0.3",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "agent-browser": "*",
+    "vitest": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "agent-browser": {
+      "optional": false
+    },
+    "vitest": {
+      "optional": false
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}

package/dist/runtime/test-helpers.d.mts

@@ -0,0 +1,22 @@
+//#region src/runtime/test-helpers.d.ts
+declare function ab(...args: string[]): void;
+/** Wait for element/text with an explicit timeout so long-running async ops don't hang. */
+declare function abWait(selector: string, timeoutMs?: number): void;
+/** Assert stable text is visible on page (via wait --text). */
+declare function abAssertTextVisible(text: string, timeoutMs?: number): void;
+/** Assert element is visible (via wait). */
+declare function abAssertVisible(selector: string, timeoutMs?: number): void;
+/** Assert element is NOT visible (via wait --state hidden or --fn for text). */
+declare function abAssertNotVisible(selector: string, timeoutMs?: number): void;
+/** Assert URL contains a pattern (via get url). */
+declare function abAssertUrl(pattern: string): void;
+/** Assert element is enabled (via is enabled). */
+declare function abAssertEnabled(selector: string): void;
+/** Assert element is disabled (via is enabled). */
+declare function abAssertDisabled(selector: string): void;
+/** Assert checkbox is checked (via is checked). */
+declare function abAssertChecked(selector: string): void;
+/** Assert checkbox is unchecked (via is checked). */
+declare function abAssertUnchecked(selector: string): void;
+//#endregion
+export { ab, abAssertChecked, abAssertDisabled, abAssertEnabled, abAssertNotVisible, abAssertTextVisible, abAssertUnchecked, abAssertUrl, abAssertVisible, abWait };

package/dist/runtime/test-helpers.mjs

@@ -0,0 +1,144 @@
+import { createRequire } from "node:module";
+import { spawnSync } from "node:child_process";
+//#region src/runtime/test-helpers.ts
+const AB = createRequire(import.meta.url).resolve("agent-browser/bin/agent-browser.js");
+function spawnAB(args) {
+	const result = spawnSync(AB, args, { stdio: "pipe" });
+	return {
+		status: result.status,
+		stdout: result.stdout?.toString() ?? "",
+		stderr: result.stderr?.toString() ?? ""
+	};
+}
+function logStep(action, args) {
+	const pretty = args.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join("  ");
+	process.stdout.write(`  ▶ ${action.padEnd(14)} ${pretty}\n`);
+}
+function fail(summary, result) {
+	process.stdout.write(`  ✗ ${summary}\n`);
+	const details = [result.stdout, result.stderr].map((s) => s.trim()).filter(Boolean).join("\n");
+	if (details) for (const line of details.split("\n")) process.stdout.write(`      ${line}\n`);
+	throw new Error(summary);
+}
+function ab(...args) {
+	const [command = "", ...rest] = args;
+	logStep(command, rest);
+	const result = spawnAB(args);
+	if (result.status !== 0) fail(`agent-browser ${command} failed (exit ${result.status})`, result);
+}
+/** Wait for element/text with an explicit timeout so long-running async ops don't hang. */
+function abWait(selector, timeoutMs = 18e4) {
+	logStep("wait", [selector]);
+	const result = spawnAB(selector.startsWith("text=") ? [
+		"wait",
+		"--text",
+		selector.slice(5),
+		"--timeout",
+		String(timeoutMs)
+	] : [
+		"wait",
+		selector,
+		"--timeout",
+		String(timeoutMs)
+	]);
+	if (result.status !== 0) fail(`wait failed: ${selector}`, result);
+}
+/** Assert stable text is visible on page (via wait --text). */
+function abAssertTextVisible(text, timeoutMs = 3e4) {
+	logStep("assert.text", [text]);
+	const result = spawnAB([
+		"wait",
+		"--text",
+		text,
+		"--timeout",
+		String(timeoutMs)
+	]);
+	if (result.status !== 0) fail(`Assertion failed: text ${JSON.stringify(text)} not found within ${timeoutMs}ms`, result);
+}
+/** Assert element is visible (via wait). */
+function abAssertVisible(selector, timeoutMs = 3e4) {
+	logStep("assert.visible", [selector]);
+	const result = spawnAB([
+		"wait",
+		selector,
+		"--timeout",
+		String(timeoutMs)
+	]);
+	if (result.status !== 0) fail(`Assertion failed: ${JSON.stringify(selector)} not visible within ${timeoutMs}ms`, result);
+}
+/** Assert element is NOT visible (via wait --state hidden or --fn for text). */
+function abAssertNotVisible(selector, timeoutMs = 3e4) {
+	logStep("assert.hidden", [selector]);
+	const result = spawnAB(selector.startsWith("text=") ? [
+		"wait",
+		"--fn",
+		`!document.body.innerText.includes(${JSON.stringify(selector.slice(5))})`,
+		"--timeout",
+		String(timeoutMs)
+	] : [
+		"wait",
+		selector,
+		"--state",
+		"hidden",
+		"--timeout",
+		String(timeoutMs)
+	]);
+	if (result.status !== 0) fail(`Assertion failed: ${JSON.stringify(selector)} still visible after ${timeoutMs}ms`, result);
+}
+/** Assert URL contains a pattern (via get url). */
+function abAssertUrl(pattern) {
+	logStep("assert.url", [pattern]);
+	const result = spawnAB(["get", "url"]);
+	const url = result.stdout.trim();
+	if (!url.includes(pattern)) fail(`Assertion failed: URL ${JSON.stringify(url)} does not contain ${JSON.stringify(pattern)}`, result);
+}
+/** Assert element is enabled (via is enabled). */
+function abAssertEnabled(selector) {
+	logStep("assert.enabled", [selector]);
+	const result = spawnAB([
+		"is",
+		"enabled",
+		selector
+	]);
+	if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
+	const value = result.stdout.trim();
+	if (value !== "true") fail(`Assertion failed: ${JSON.stringify(selector)} is not enabled (got: ${value})`, result);
+}
+/** Assert element is disabled (via is enabled). */
+function abAssertDisabled(selector) {
+	logStep("assert.disabled", [selector]);
+	const result = spawnAB([
+		"is",
+		"enabled",
+		selector
+	]);
+	if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
+	const value = result.stdout.trim();
+	if (value !== "false") fail(`Assertion failed: ${JSON.stringify(selector)} is not disabled (got: ${value})`, result);
+}
+/** Assert checkbox is checked (via is checked). */
+function abAssertChecked(selector) {
+	logStep("assert.checked", [selector]);
+	const result = spawnAB([
+		"is",
+		"checked",
+		selector
+	]);
+	if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
+	const value = result.stdout.trim();
+	if (value !== "true") fail(`Assertion failed: ${JSON.stringify(selector)} is not checked (got: ${value})`, result);
+}
+/** Assert checkbox is unchecked (via is checked). */
+function abAssertUnchecked(selector) {
+	logStep("assert.unchecked", [selector]);
+	const result = spawnAB([
+		"is",
+		"checked",
+		selector
+	]);
+	if (result.status !== 0) fail(`Assertion failed: element ${JSON.stringify(selector)} not found`, result);
+	const value = result.stdout.trim();
+	if (value !== "false") fail(`Assertion failed: ${JSON.stringify(selector)} is not unchecked (got: ${value})`, result);
+}
+//#endregion
+export { ab, abAssertChecked, abAssertDisabled, abAssertEnabled, abAssertNotVisible, abAssertTextVisible, abAssertUnchecked, abAssertUrl, abAssertVisible, abWait };