cbrowser 19.6.0 → 20.0.0

package/dist/webhooks.js

@@ -0,0 +1,128 @@
+/**
+ * CBrowser - Cognitive Browser Automation
+ * Copyright 2026 Alexandria Eden alexandria.shai.eden@gmail.com
+ * Learn more at https://cbrowser.ai - MIT License
+ */
+/**
+ * Webhooks configured with `cbrowser webhook add`, and the sender.
+ *
+ * `webhook add` wrote webhooks.json and nothing ever read it except `webhook
+ * list` and `webhook test`: no command sent test.fail or journey.complete, so a
+ * configured webhook never fired (audit O17, 2026-10-21). test-suite now sends
+ * test.pass or test.fail once per run, and cognitive-journey sends
+ * journey.complete once per journey. Events nothing sends are refused at
+ * `webhook add` rather than stored to wait forever.
+ *
+ * Sending never fails the run it reports on: one POST per webhook, JSON, a
+ * 10 s timeout, no retries, and a failure is a stderr warning that names the
+ * webhook, never its URL (a Slack or Discord URL is itself the credential).
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+/** Events a command sends: test.pass/test.fail per test-suite run, journey.complete per cognitive journey. */
+export const SENT_WEBHOOK_EVENTS = ["test.pass", "test.fail", "journey.complete"];
+export const WEBHOOK_FORMATS = ["generic", "slack", "discord"];
+export const WEBHOOK_TIMEOUT_MS = 10_000;
+export function webhooksPath(dataDir) {
+    return join(dataDir, "webhooks.json");
+}
+/** The configured webhooks; none when the file is missing or unreadable. */
+export function loadWebhooks(dataDir) {
+    const path = webhooksPath(dataDir);
+    if (!existsSync(path))
+        return [];
+    try {
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Why a URL cannot be a webhook, or null when it can. Only http and https, and
+ * no user name or password in the URL: those would be sent on every event and
+ * printed by `webhook list`.
+ */
+export function webhookUrlProblem(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        return `"${url}" is not a URL`;
+    }
+    if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+        return `webhook URLs must be http or https, not ${parsed.protocol.replace(/:$/, "")}`;
+    }
+    if (parsed.username || parsed.password) {
+        return "a webhook URL must not carry a user name or password";
+    }
+    return null;
+}
+function isJourney(p) {
+    return "goalAchieved" in p;
+}
+/** The request body for one webhook format. */
+export function webhookBody(format, event, run, timestamp) {
+    if (isJourney(run)) {
+        const text = `CBrowser journey "${run.goal}" as ${run.persona}: `
+            + (run.goalAchieved ? "goal achieved" : `abandoned${run.abandonmentReason ? ` (${run.abandonmentReason})` : ""}`)
+            + ` in ${run.stepCount} steps`;
+        if (format === "slack")
+            return { text };
+        if (format === "discord")
+            return { content: text };
+        return { event, ...run, timestamp };
+    }
+    const { suite, summary, failedTests } = run;
+    const text = `CBrowser test-suite "${suite}": ${summary.passed}/${summary.total} passed`
+        + (failedTests.length > 0 ? `. Failed: ${failedTests.map((t) => t.name).join(", ")}` : "");
+    if (format === "slack")
+        return { text };
+    if (format === "discord")
+        return { content: text };
+    return { event, suite, summary, failedTests, timestamp };
+}
+/**
+ * POST the event to every webhook subscribed to it. Never throws: each failure
+ * is collected and, unless `quiet`, printed to stderr as a warning.
+ */
+export async function sendWebhookEvent(dataDir, event, run, options = {}) {
+    const result = { sent: [], failed: [] };
+    const timestamp = new Date().toISOString();
+    for (const hook of loadWebhooks(dataDir)) {
+        if (!Array.isArray(hook.events) || !hook.events.includes(event))
+            continue;
+        const problem = typeof hook.url === "string" ? webhookUrlProblem(hook.url) : "it has no URL";
+        let reason = problem;
+        if (!problem) {
+            try {
+                const response = await fetch(hook.url, {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify(webhookBody(hook.format, event, run, timestamp)),
+                    redirect: "error",
+                    signal: AbortSignal.timeout(options.timeoutMs ?? WEBHOOK_TIMEOUT_MS),
+                });
+                reason = response.ok ? null : `HTTP ${response.status}`;
+            }
+            catch (e) {
+                const err = e;
+                reason = err.name === "TimeoutError"
+                    ? `no answer in ${(options.timeoutMs ?? WEBHOOK_TIMEOUT_MS) / 1000}s`
+                    : err.message.split(hook.url).join("<url>");
+            }
+        }
+        if (reason === null) {
+            result.sent.push(hook.name);
+        }
+        else {
+            result.failed.push({ name: hook.name, reason });
+            if (!options.quiet)
+                console.error(`Warning: webhook "${hook.name}" (${event}) was not delivered: ${reason}`);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cbrowser",
-  "version": "19.6.0",
+  "version": "20.0.0",
   "type": "module",
   "description": "Cognitive browser automation that thinks like your users—and helps AI agents navigate too. Simulate real user cognition with abandonment detection, constitutional safety, chaos engineering, and UX friction discovery. Sites that pass CBrowser's cognitive tests are easier for both humans and AI agents to navigate.",
   "main": "dist/index.js",
@@ -126,35 +126,37 @@
   },
   "homepage": "https://github.com/alexandriashai/cbrowser#readme",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.9.0"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.32.1",
+    "@anthropic-ai/sdk": "^1.0.0",
     "@mcp-ui/server": "^6.1.0",
-    "@modelcontextprotocol/ext-apps": "^1.7.5",
-    "@modelcontextprotocol/sdk": "^1.25.3",
+    "@modelcontextprotocol/ext-apps": "^2.0.3",
+    "@modelcontextprotocol/sdk": "^1.32.1",
     "@types/express": "^5.0.6",
-    "express": "^5.2.1",
-    "jose": "^6.1.3",
-    "mcp-guardian": "^2.2.1",
-    "playwright": "^1.58.2",
-    "sharp": "^0.34.5",
-    "zod": "^4.3.6"
+    "express": "^5.3.0",
+    "jose": "^6.2.13",
+    "mcp-guardian": "^2.4.0",
+    "playwright": "^1.64.1",
+    "sharp": "^0.35.5",
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.1",
-    "@commitlint/config-conventional": "^19.0.0",
-    "@release-it/conventional-changelog": "^10.0.5",
+    "@commitlint/cli": "^21.2.4",
+    "@commitlint/config-conventional": "^21.2.4",
+    "@eslint/js": "^10.0.1",
+    "@release-it/conventional-changelog": "^12.0.2",
     "@types/node": "^20.10.0",
-    "@typescript-eslint/eslint-plugin": "^6.13.0",
-    "@typescript-eslint/parser": "^6.13.0",
-    "eslint": "^8.55.0",
+    "@typescript-eslint/eslint-plugin": "^8.72.0",
+    "@typescript-eslint/parser": "^8.72.0",
+    "conventional-changelog-conventionalcommits": "^10.4.1",
+    "eslint": "^10.13.0",
     "fast-check": "^4.9.0",
     "husky": "^9.0.0",
-    "lint-staged": "^16.2.7",
-    "release-it": "^19.2.4",
+    "lint-staged": "^17.6.0",
+    "release-it": "^21.1.1",
     "typedoc": "^0.28.16",
-    "typescript": "^5.3.0",
+    "typescript": "^6.0.3",
     "yaml": "^2.9.0"
   },
   "lint-staged": {
@@ -169,8 +171,5 @@
     "README.md",
     "LICENSE",
     "THIRD_PARTY_LICENSES.md"
-  ],
-  "overrides": {
-    "conventional-changelog-conventionalcommits": "8.0.0"
-  }
+  ]
 }