@testivai/witness-webdriverio 0.4.5 → 0.4.6

package/dist/types.d.ts

@@ -18,6 +18,12 @@ export interface WitnessBrowser {
      * Type kept loose to accept WDIO 8/9 signature variants.
      */
     execute<T = unknown>(script: string | ((...args: any[]) => T), ...args: any[]): Promise<T>;
+    /**
+     * The session's W3C capabilities (WebdriverIO's `browser.capabilities`).
+     * Optional: when present, the browser, its version and the driver are
+     * recorded as capture provenance in the capture's metadata.json.
+     */
+    capabilities?: Record<string, unknown>;
 }
 /**
  * Options for a single witness() call. All optional.

package/dist/witness.js

@@ -57,6 +57,8 @@ exports.witness = witness;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const witness_1 = require("@testivai/witness");
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const ADAPTER_VERSION = require('../package.json').version;
 const element_map_1 = require("./element-map");
 /** id of the style element injected for the duration of a capture */
 const STYLE_ID = '__testivai_capture_css__';
@@ -138,10 +140,28 @@ async function witness(browser, name, options = {}) {
     if (options.variant) {
         name = `${name}__${options.variant.replace(/[^a-z0-9_-]+/gi, '_').toLowerCase()}`;
     }
+    const localConfig = (0, witness_1.loadLocalConfig)(process.cwd());
+    // Capture provenance: what the page is rendered with, measured before
+    // anything is injected, plus the session's capabilities. Best-effort.
+    let renderProbe = null;
+    if (typeof browser.execute === 'function') {
+        try {
+            renderProbe = await browser.execute(`return ${witness_1.RENDER_PROBE_EXPRESSION}`);
+        }
+        catch {
+            // no probe: no render settings recorded
+        }
+    }
+    const environment = (0, witness_1.webDriverEnvironment)({
+        capabilities: browser.capabilities,
+        probe: renderProbe,
+        adapter: { name: '@testivai/witness-webdriverio', version: ADAPTER_VERSION, captureMethod: witness_1.CAPTURE_METHODS.WEBDRIVER_VIEWPORT },
+        framework: { name: 'webdriverio', version: (0, witness_1.installedPackageVersion)('webdriverio') },
+    });
+    name = (0, witness_1.applyEnvironmentPolicyToName)(name, { browser: { name: environment?.browser.name ?? 'unknown' }, os: { platform: process.platform } }, localConfig.environmentPolicy);
     // 0. Prepare the page: stabilization CSS (animations/caret/fonts — the
     //    flake killers) + ignoreSelectors from config.json and this call,
     //    injected as one style tag and removed after the capture.
-    const localConfig = (0, witness_1.loadLocalConfig)(process.cwd());
     const stabilize = options.stabilize ?? localConfig.stabilize;
     const ignoreSelectors = [
         ...new Set([...(localConfig.ignoreSelectors ?? []), ...(options.ignoreSelectors ?? [])]),
@@ -215,6 +235,14 @@ async function witness(browser, name, options = {}) {
     // 4. Write to .testivai/temp/<name>/
     const store = new witness_1.BaselineStore(process.cwd());
     store.writeTemp(name, screenshot, dom);
+    if (environment) {
+        try {
+            store.writeTempMetadata(name, { name, environment });
+        }
+        catch {
+            // without it the compare cannot tell rendering drift from noise for this capture
+        }
+    }
     if (elementMap) {
         try {
             const tempDir = path.join(process.cwd(), '.testivai', 'temp', name);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@testivai/witness-webdriverio",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "WebdriverIO adapter for TestivAI Witness — local-first visual regression with pixel + DOM comparison",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -54,7 +54,7 @@
     }
   },
   "dependencies": {
-    "@testivai/witness": "2.4.0"
+    "@testivai/witness": "2.5.0"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",