npm - @testivai/witness-playwright - Versions diffs - 0.1.0 - Mend

@testivai/witness-playwright 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (43) hide show

package/README.md +65 -0
package/__tests__/.gitkeep +0 -0
package/__tests__/config-integration.spec.ts +102 -0
package/__tests__/snapshot.spec.d.ts +1 -0
package/__tests__/snapshot.spec.js +81 -0
package/__tests__/snapshot.spec.ts +58 -0
package/__tests__/unit/ci.spec.d.ts +1 -0
package/__tests__/unit/ci.spec.js +35 -0
package/__tests__/unit/ci.spec.ts +40 -0
package/__tests__/unit/reporter.spec.d.ts +1 -0
package/__tests__/unit/reporter.spec.js +37 -0
package/__tests__/unit/reporter.spec.ts +43 -0
package/dist/ci.d.ts +10 -0
package/dist/ci.js +35 -0
package/dist/cli/init.d.ts +3 -0
package/dist/cli/init.js +146 -0
package/dist/config/loader.d.ts +29 -0
package/dist/config/loader.js +232 -0
package/dist/index.d.ts +7 -0
package/dist/index.js +24 -0
package/dist/reporter-types.d.ts +2 -0
package/dist/reporter-types.js +2 -0
package/dist/reporter.d.ts +16 -0
package/dist/reporter.js +155 -0
package/dist/snapshot.d.ts +12 -0
package/dist/snapshot.js +122 -0
package/dist/types.d.ts +181 -0
package/dist/types.js +10 -0
package/jest.config.js +11 -0
package/package.json +47 -0
package/playwright.config.ts +11 -0
package/progress.md +620 -0
package/src/ci.ts +34 -0
package/src/cli/init.ts +119 -0
package/src/config/loader.ts +219 -0
package/src/index.ts +9 -0
package/src/reporter-types.ts +5 -0
package/src/reporter.ts +148 -0
package/src/snapshot.ts +103 -0
package/src/types.ts +193 -0
package/test-results/.last-run.json +4 -0
package/tsconfig.jest.json +7 -0
package/tsconfig.json +19 -0

package/README.md ADDED Viewed

@@ -0,0 +1,65 @@
+# @testivai/witness-playwright
+**Status**: ✅ Production Ready | **Last Updated**: December 21, 2025
+**Project:** @testivai/witness-playwright (MVP - 1 Month Plan)
+**Role:** The "Sensor" or The "Witness"
+**Goal:** To provide a lightweight Playwright integration that (1) captures snapshots, DOM, and layout/bounding-box data, and (2) a custom reporter that uploads this data, along with viewport/browser context, in a batch-oriented way. The goal is to observe the application under test and collect evidence (snapshots, DOM, layout data) without burdening the developer with complex configuration.
+## Architecture
+This package provides two main exports:
+## Configuration
+To use the reporter, you need to configure it in your `playwright.config.ts` file. You must also provide your API URL and Key via environment variables (`TESTIVAI_API_URL` and `TESTIVAI_API_KEY`).
+```typescript
+// playwright.config.ts
+import { defineConfig } from '@playwright/test';
+export default defineConfig({
+  // ... other config
+  reporter: [
+    ['list'], // You can use other reporters alongside it
+    ['@testivai/witness-playwright/reporter']
+  ],
+});
+```
+The reporter will automatically detect if it is running in a CI environment (such as GitHub Actions, GitLab, Jenkins, etc.) and will tag the evidence batch with a unique run ID. This ensures that snapshots from parallel jobs are correctly grouped together into a single test run.
+## Usage
+Here is a basic example of how to use the `snapshot` function within a Playwright test file:
+```typescript
+import { test } from '@playwright/test';
+import { testivai } from '@testivai/witness-playwright';
+test('my example test', async ({ page }, testInfo) => {
+  await page.goto('https://example.com');
+  // Capture a snapshot with a custom name
+  await testivai.witness(page, testInfo, 'example-home');
+  // Or capture a snapshot without a name (one will be generated from the URL)
+  await testivai.witness(page, testInfo);
+});
+```
+1.  **`testivai.witness()`**: A utility function to be called by the user within their Playwright tests to capture evidence.
+2.  **`TestivAIPlaywrightReporter`**: A custom Playwright reporter, configured in `playwright.config.ts`, that runs after all tests are complete. It is responsible for collecting all the evidence captured during the test run, batching it together with context (like Git and browser information), and uploading it to the Testivai service.
+## 📦 Installation
+```bash
+npm install @testivai/witness-playwright
+```
+## 📊 Progress
+See [PROGRESS.md](./PROGRESS.md) for detailed development progress.

package/__tests__/.gitkeep ADDED Viewed

File without changes

package/__tests__/config-integration.spec.ts ADDED Viewed

@@ -0,0 +1,102 @@
+import { test, expect } from '@playwright/test';
+import { snapshot } from '../src/snapshot';
+import * as fs from 'fs-extra';
+import * as path from 'path';
+test.describe('Configuration Integration', () => {
+  test('loads default configuration when no config file exists', async ({ page }) => {
+    // Remove any existing config file
+    const configPath = path.join(process.cwd(), 'testivai.config.ts');
+    if (await fs.pathExists(configPath)) {
+      await fs.remove(configPath);
+    }
+    await page.goto('data:text/html,<html><body><h1>Test Page</h1></body></html>');
+    // Mock TestInfo object
+    const mockTestInfo = {
+      title: 'Configuration Test'
+    } as any;
+    // This should use default configuration
+    await snapshot(page, mockTestInfo, 'test-no-config');
+    // Check that metadata was created with default config
+    const tempDir = path.join(process.cwd(), '.testivai', 'temp');
+    const files = await fs.readdir(tempDir);
+    const metadataFile = files.find(f => f.endsWith('.json'));
+    expect(metadataFile).toBeDefined();
+    const metadata = await fs.readJson(path.join(tempDir, metadataFile!));
+    expect(metadata.testivaiConfig).toBeDefined();
+    expect(metadata.testivaiConfig.layout.sensitivity).toBe(2);
+    expect(metadata.testivaiConfig.layout.tolerance).toBe(1.0);
+    expect(metadata.testivaiConfig.ai.sensitivity).toBe(2);
+    expect(metadata.testivaiConfig.ai.confidence).toBe(0.7);
+  });
+  test('uses custom configuration when provided', async ({ page }) => {
+    await page.goto('data:text/html,<html><body><h1>Test Page</h1></body></html>');
+    // Mock TestInfo object
+    const mockTestInfo = {
+      title: 'Custom Config Test'
+    } as any;
+    // Test with custom configuration
+    const customConfig = {
+      layout: {
+        sensitivity: 0,  // Strict
+        tolerance: 0.5
+      },
+      ai: {
+        sensitivity: 4,  // Aggressive
+        confidence: 0.9
+      },
+      selectors: ['h1']
+    };
+    await snapshot(page, mockTestInfo, 'test-custom-config', customConfig);
+    // Check that metadata was created with custom config
+    const tempDir = path.join(process.cwd(), '.testivai', 'temp');
+    const files = await fs.readdir(tempDir);
+    const metadataFile = files.find(f => f.includes('test_custom_config') && f.endsWith('.json'));
+    expect(metadataFile).toBeDefined();
+    const metadata = await fs.readJson(path.join(tempDir, metadataFile!));
+    expect(metadata.testivaiConfig).toBeDefined();
+    expect(metadata.testivaiConfig.layout.sensitivity).toBe(0);
+    expect(metadata.testivaiConfig.layout.tolerance).toBe(0.5);
+    expect(metadata.testivaiConfig.ai.sensitivity).toBe(4);
+    expect(metadata.testivaiConfig.ai.confidence).toBe(0.9);
+    expect(metadata.testivaiConfig.selectors).toEqual(['h1']);
+  });
+  test('CLI generates valid configuration file', async () => {
+    // Remove existing config
+    const configPath = path.join(process.cwd(), 'testivai.config.ts');
+    if (await fs.pathExists(configPath)) {
+      await fs.remove(configPath);
+    }
+    // Run CLI init using direct file system operations
+    const { createConfigFile } = require('../dist/cli/init');
+    await createConfigFile();
+    // Verify config file was created
+    expect(await fs.pathExists(configPath)).toBe(true);
+    // Verify config file content
+    const configContent = await fs.readFile(configPath, 'utf8');
+    expect(configContent).toContain('export default');
+    expect(configContent).toContain('sensitivity: 2');
+    expect(configContent).toContain('tolerance: 1.0');
+    expect(configContent).toContain('confidence: 0.7');
+    expect(configContent).toContain('Custom Configuration Examples');
+  });
+});

package/__tests__/snapshot.spec.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/__tests__/snapshot.spec.js ADDED Viewed

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_1 = require("@playwright/test");
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+const src_1 = require("../src");
+const tempDir = path.join(process.cwd(), '.testivai', 'temp');
+test_1.test.describe('testivai.witness()', () => {
+    // Ensure the temp directory is clean before each test
+    test_1.test.beforeEach(async () => {
+        await fs.emptyDir(tempDir);
+    });
+    test_1.test.afterAll(async () => {
+        await fs.emptyDir(tempDir);
+    });
+    (0, test_1.test)('should create all evidence files for a named snapshot', async ({ page }, testInfo) => {
+        await page.setContent('<body><h1>Hello Snapshot!</h1></body>');
+        await src_1.testivai.witness(page, testInfo, 'test-snapshot');
+        const files = await fs.readdir(tempDir);
+        (0, test_1.expect)(files).toHaveLength(3);
+        const jsonFile = files.find(f => f.endsWith('.json'));
+        const htmlFile = files.find(f => f.endsWith('.html'));
+        const pngFile = files.find(f => f.endsWith('.png'));
+        (0, test_1.expect)(jsonFile, 'JSON file should exist').toBeDefined();
+        (0, test_1.expect)(htmlFile, 'HTML file should exist').toBeDefined();
+        (0, test_1.expect)(pngFile, 'PNG file should exist').toBeDefined();
+        // Verify JSON metadata content
+        const metadata = await fs.readJson(path.join(tempDir, jsonFile));
+        (0, test_1.expect)(metadata.snapshotName).toBe('test-snapshot');
+        (0, test_1.expect)(metadata.testName).toBe('should create all evidence files for a named snapshot');
+        (0, test_1.expect)(metadata.layout.body).toBeDefined();
+        (0, test_1.expect)(typeof metadata.layout.body.x).toBe('number');
+        // Verify HTML content
+        const htmlContent = await fs.readFile(path.join(tempDir, htmlFile), 'utf-8');
+        (0, test_1.expect)(htmlContent).toContain('<h1>Hello Snapshot!</h1>');
+    });
+    (0, test_1.test)('should generate a snapshot name from the URL if not provided', async ({ page }, testInfo) => {
+        // Using a data URL is a reliable way to set a page URL in a test environment
+        await page.goto('data:text/html,<h2>Page Title</h2>');
+        await src_1.testivai.witness(page, testInfo);
+        const files = await fs.readdir(tempDir);
+        const jsonFile = files.find(f => f.endsWith('.json'));
+        (0, test_1.expect)(jsonFile, 'JSON file should exist').toBeDefined();
+        const metadata = await fs.readJson(path.join(tempDir, jsonFile));
+        // The default name for a data URL or empty path is 'snapshot'
+        (0, test_1.expect)(metadata.snapshotName).toBe('snapshot');
+    });
+});

package/__tests__/snapshot.spec.ts ADDED Viewed

@@ -0,0 +1,58 @@
+import { test, expect } from '@playwright/test';
+import * as fs from 'fs-extra';
+import * as path from 'path';
+import { testivai } from '../src';
+const tempDir = path.join(process.cwd(), '.testivai', 'temp');
+test.describe('testivai.witness()', () => {
+  // Ensure the temp directory is clean before each test
+  test.beforeEach(async () => {
+    await fs.emptyDir(tempDir);
+  });
+  test.afterAll(async () => {
+    await fs.emptyDir(tempDir);
+  });
+  test('should create all evidence files for a named snapshot', async ({ page }, testInfo) => {
+    await page.setContent('<body><h1>Hello Snapshot!</h1></body>');
+    await testivai.witness(page, testInfo, 'test-snapshot');
+    const files = await fs.readdir(tempDir);
+    expect(files).toHaveLength(3);
+    const jsonFile = files.find(f => f.endsWith('.json'));
+    const htmlFile = files.find(f => f.endsWith('.html'));
+    const pngFile = files.find(f => f.endsWith('.png'));
+    expect(jsonFile, 'JSON file should exist').toBeDefined();
+    expect(htmlFile, 'HTML file should exist').toBeDefined();
+    expect(pngFile, 'PNG file should exist').toBeDefined();
+    // Verify JSON metadata content
+    const metadata = await fs.readJson(path.join(tempDir, jsonFile!));
+    expect(metadata.snapshotName).toBe('test-snapshot');
+    expect(metadata.testName).toBe('should create all evidence files for a named snapshot');
+    expect(metadata.layout.body).toBeDefined();
+    expect(typeof metadata.layout.body.x).toBe('number');
+    // Verify HTML content
+    const htmlContent = await fs.readFile(path.join(tempDir, htmlFile!), 'utf-8');
+    expect(htmlContent).toContain('<h1>Hello Snapshot!</h1>');
+  });
+  test('should generate a snapshot name from the URL if not provided', async ({ page }, testInfo) => {
+    // Using a data URL is a reliable way to set a page URL in a test environment
+    await page.goto('data:text/html,<h2>Page Title</h2>');
+    await testivai.witness(page, testInfo);
+    const files = await fs.readdir(tempDir);
+    const jsonFile = files.find(f => f.endsWith('.json'));
+    expect(jsonFile, 'JSON file should exist').toBeDefined();
+    const metadata = await fs.readJson(path.join(tempDir, jsonFile!));
+    // The default name for a data URL or empty path is 'snapshot'
+    expect(metadata.snapshotName).toBe('snapshot');
+  });
+});

package/__tests__/unit/ci.spec.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/__tests__/unit/ci.spec.js ADDED Viewed

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ci_1 = require("../../src/ci");
+describe('getCiRunId', () => {
+    const OLD_ENV = process.env;
+    beforeEach(() => {
+        jest.resetModules(); // Clears the module cache
+        // Start with a clean environment, preserving only essential vars like PATH
+        process.env = { PATH: OLD_ENV.PATH };
+    });
+    afterEach(() => {
+        process.env = OLD_ENV; // Restore original environment
+    });
+    test('should return GitHub run ID when in GitHub Actions', () => {
+        process.env.GITHUB_RUN_ID = 'github123';
+        expect((0, ci_1.getCiRunId)()).toBe('github-github123');
+    });
+    test('should return GitLab pipeline ID when in GitLab CI', () => {
+        process.env.GITLAB_CI = 'true';
+        process.env.CI_PIPELINE_ID = 'gitlab456';
+        expect((0, ci_1.getCiRunId)()).toBe('gitlab-gitlab456');
+    });
+    test('should return Jenkins build ID when in Jenkins', () => {
+        process.env.JENKINS_URL = 'http://jenkins.example.com';
+        process.env.BUILD_ID = 'jenkins789';
+        expect((0, ci_1.getCiRunId)()).toBe('jenkins-jenkins789');
+    });
+    test('should return null when not in a known CI environment', () => {
+        // Ensure no CI variables are set
+        delete process.env.GITHUB_RUN_ID;
+        delete process.env.GITLAB_CI;
+        delete process.env.JENKINS_URL;
+        expect((0, ci_1.getCiRunId)()).toBeNull();
+    });
+});

package/__tests__/unit/ci.spec.ts ADDED Viewed

@@ -0,0 +1,40 @@
+import { getCiRunId } from '../../src/ci';
+describe('getCiRunId', () => {
+  const OLD_ENV = process.env;
+  beforeEach(() => {
+    jest.resetModules(); // Clears the module cache
+    // Start with a clean environment, preserving only essential vars like PATH
+    process.env = { PATH: OLD_ENV.PATH };
+  });
+  afterEach(() => {
+    process.env = OLD_ENV; // Restore original environment
+  });
+  test('should return GitHub run ID when in GitHub Actions', () => {
+    process.env.GITHUB_RUN_ID = 'github123';
+    expect(getCiRunId()).toBe('github-github123');
+  });
+  test('should return GitLab pipeline ID when in GitLab CI', () => {
+    process.env.GITLAB_CI = 'true';
+    process.env.CI_PIPELINE_ID = 'gitlab456';
+    expect(getCiRunId()).toBe('gitlab-gitlab456');
+  });
+  test('should return Jenkins build ID when in Jenkins', () => {
+    process.env.JENKINS_URL = 'http://jenkins.example.com';
+    process.env.BUILD_ID = 'jenkins789';
+    expect(getCiRunId()).toBe('jenkins-jenkins789');
+  });
+  test('should return null when not in a known CI environment', () => {
+    // Ensure no CI variables are set
+    delete process.env.GITHUB_RUN_ID;
+    delete process.env.GITLAB_CI;
+    delete process.env.JENKINS_URL;
+    expect(getCiRunId()).toBeNull();
+  });
+});

package/__tests__/unit/reporter.spec.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export {};

package/__tests__/unit/reporter.spec.js ADDED Viewed

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const reporter_1 = require("../../src/reporter");
+// Mock the module that imports Playwright-specific types.
+// This prevents a type-checking conflict within the Jest environment.
+jest.mock('../../src/reporter-types', () => ({}));
+describe('TestivAIPlaywrightReporter', () => {
+    const OLD_ENV = process.env;
+    beforeEach(() => {
+        jest.resetModules();
+        process.env = { ...OLD_ENV };
+    });
+    afterAll(() => {
+        process.env = OLD_ENV;
+    });
+    test('should initialize with API URL and key from environment variables', () => {
+        process.env.TESTIVAI_API_URL = 'http://env.api';
+        process.env.TESTIVAI_API_KEY = 'env-key';
+        const reporter = new reporter_1.TestivAIPlaywrightReporter();
+        // Accessing private options for testing purposes
+        expect(reporter.options.apiUrl).toBe('http://env.api');
+        expect(reporter.options.apiKey).toBe('env-key');
+    });
+    test('should be disabled if API URL is not provided', async () => {
+        const reporter = new reporter_1.TestivAIPlaywrightReporter();
+        // onBegin should set the apiUrl to undefined, disabling the reporter.
+        await reporter.onBegin({}, {});
+        expect(reporter.options.apiUrl).toBeUndefined();
+    });
+    test('should be disabled if API Key is not provided', async () => {
+        process.env.TESTIVAI_API_URL = 'http://env.api';
+        const reporter = new reporter_1.TestivAIPlaywrightReporter();
+        // onBegin should set the apiUrl to undefined, disabling the reporter.
+        await reporter.onBegin({}, {});
+        expect(reporter.options.apiUrl).toBeUndefined();
+    });
+});

package/__tests__/unit/reporter.spec.ts ADDED Viewed

@@ -0,0 +1,43 @@
+import { TestivAIPlaywrightReporter } from '../../src/reporter';
+// Mock the module that imports Playwright-specific types.
+// This prevents a type-checking conflict within the Jest environment.
+jest.mock('../../src/reporter-types', () => ({}));
+describe('TestivAIPlaywrightReporter', () => {
+  const OLD_ENV = process.env;
+  beforeEach(() => {
+    jest.resetModules();
+    process.env = { ...OLD_ENV };
+  });
+  afterAll(() => {
+    process.env = OLD_ENV;
+  });
+  test('should initialize with API URL and key from environment variables', () => {
+    process.env.TESTIVAI_API_URL = 'http://env.api';
+    process.env.TESTIVAI_API_KEY = 'env-key';
+    const reporter = new TestivAIPlaywrightReporter();
+    // Accessing private options for testing purposes
+    expect((reporter as any).options.apiUrl).toBe('http://env.api');
+    expect((reporter as any).options.apiKey).toBe('env-key');
+  });
+  test('should be disabled if API URL is not provided', async () => {
+    const reporter = new TestivAIPlaywrightReporter();
+    // onBegin should set the apiUrl to undefined, disabling the reporter.
+    await reporter.onBegin({} as any, {} as any);
+    expect((reporter as any).options.apiUrl).toBeUndefined();
+  });
+  test('should be disabled if API Key is not provided', async () => {
+    process.env.TESTIVAI_API_URL = 'http://env.api';
+    const reporter = new TestivAIPlaywrightReporter();
+    // onBegin should set the apiUrl to undefined, disabling the reporter.
+    await reporter.onBegin({} as any, {} as any);
+    expect((reporter as any).options.apiUrl).toBeUndefined();
+  });
+});

package/dist/ci.d.ts ADDED Viewed

@@ -0,0 +1,10 @@
+/**
+ * Utilities for detecting CI/CD environments and extracting a unique run identifier.
+ */
+/**
+ * Gets a unique identifier for the current CI run.
+ * This ID is used to group snapshots from parallel shards into a single batch.
+ *
+ * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
+ */
+export declare function getCiRunId(): string | null;

package/dist/ci.js ADDED Viewed

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Utilities for detecting CI/CD environments and extracting a unique run identifier.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCiRunId = getCiRunId;
+/**
+ * Gets a unique identifier for the current CI run.
+ * This ID is used to group snapshots from parallel shards into a single batch.
+ *
+ * @returns A unique string identifier for the CI run, or null if not in a known CI environment.
+ */
+function getCiRunId() {
+    // GitHub Actions
+    if (process.env.GITHUB_RUN_ID) {
+        return `github-${process.env.GITHUB_RUN_ID}`;
+    }
+    // GitLab CI
+    if (process.env.GITLAB_CI) {
+        return `gitlab-${process.env.CI_PIPELINE_ID}`;
+    }
+    // Jenkins
+    if (process.env.JENKINS_URL) {
+        return `jenkins-${process.env.BUILD_ID}`;
+    }
+    // CircleCI
+    if (process.env.CIRCLECI) {
+        return `circleci-${process.env.CIRCLE_WORKFLOW_ID}`;
+    }
+    // Travis CI
+    if (process.env.TRAVIS) {
+        return `travis-${process.env.TRAVIS_BUILD_ID}`;
+    }
+    return null;
+}

package/dist/cli/init.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+declare function createConfigFile(): Promise<void>;
+export { createConfigFile };

package/dist/cli/init.js ADDED Viewed

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createConfigFile = createConfigFile;
+const fs = __importStar(require("fs-extra"));
+const path = __importStar(require("path"));
+/**
+ * Basic CLI init script for TestivAI Playwright SDK
+ * Creates a testivai.config.ts file with sensible defaults
+ */
+const DEFAULT_CONFIG = `/**
+ * TestivAI Configuration File
+ *
+ * This file configures how TestivAI analyzes visual differences in your tests.
+ *
+ * Layout Settings:
+ * - sensitivity: 0-4 scale (0=strict/precise, 4=very lenient)
+ * - tolerance: Base pixel tolerance for layout differences
+ *
+ * AI Settings:
+ * - sensitivity: 0-4 scale (0=conservative, 4=aggressive)
+ * - confidence: 0.0-1.0 scale (minimum confidence required for AI_BUG verdict)
+ *
+ * Custom Configuration Examples:
+ *
+ * // For strict testing (critical components):
+ * export default {
+ *   layout: { sensitivity: 0, tolerance: 0.5 },
+ *   ai: { sensitivity: 0, confidence: 0.9 }
+ * };
+ *
+ * // For lenient testing (dynamic content):
+ * export default {
+ *   layout: { sensitivity: 4, tolerance: 3.0 },
+ *   ai: { sensitivity: 3, confidence: 0.6 }
+ * };
+ *
+ * // Per-selector tolerances (advanced):
+ * export default {
+ *   layout: {
+ *     sensitivity: 2,
+ *     tolerance: 1.0,
+ *     selectorTolerances: {
+ *       '.carousel': 4.0,      // Carousel components shift
+ *       '.dropdown': 2.0,      // Dropdowns can vary
+ *       '.tooltip': 5.0,       // Tooltips are highly variable
+ *       '.submit-button': 0.5  // Critical buttons need precision
+ *     }
+ *   },
+ *   ai: { sensitivity: 2, confidence: 0.7 }
+ * };
+ *
+ * // Environment-specific overrides:
+ * export default {
+ *   layout: { sensitivity: 2, tolerance: 1.0 },
+ *   ai: { sensitivity: 2, confidence: 0.7 },
+ *   environments: {
+ *     ci: {
+ *       layout: { sensitivity: 1, tolerance: 0.5 },  // Stricter in CI
+ *       ai: { sensitivity: 1, confidence: 0.8 }
+ *     },
+ *     development: {
+ *       layout: { sensitivity: 3, tolerance: 2.0 },  // More lenient locally
+ *       ai: { sensitivity: 3, confidence: 0.6 }
+ *     }
+ *   }
+ * };
+ */
+export default {
+  layout: {
+    sensitivity: 2,        // Balanced sensitivity (0-4 scale)
+    tolerance: 1.0,        // 1 pixel base tolerance
+  },
+  ai: {
+    sensitivity: 2,        // Balanced AI analysis (0-4 scale)
+    confidence: 0.7,       // 70% confidence required for AI_BUG
+  }
+};
+`;
+async function createConfigFile() {
+    const configPath = path.join(process.cwd(), 'testivai.config.ts');
+    // Check if config already exists
+    if (await fs.pathExists(configPath)) {
+        console.log('❌ TestivAI config already exists at:', configPath);
+        console.log('   Delete it first if you want to regenerate it.');
+        process.exit(1);
+    }
+    try {
+        // Create the config file
+        await fs.writeFile(configPath, DEFAULT_CONFIG, 'utf8');
+        console.log('✅ TestivAI configuration created successfully!');
+        console.log('📁 Config file:', configPath);
+        console.log('');
+        console.log('📖 Next steps:');
+        console.log('   1. Review and customize the configuration in testivai.config.ts');
+        console.log('   2. Update your playwright.config.ts to use TestivAI reporter');
+        console.log('   3. Run your tests with: npx playwright test');
+        console.log('');
+        console.log('💡 Need help? Check the comments in testivai.config.ts for examples');
+    }
+    catch (error) {
+        console.error('❌ Failed to create configuration file:', error);
+        process.exit(1);
+    }
+}
+// Main execution
+if (require.main === module) {
+    createConfigFile().catch(error => {
+        console.error('❌ CLI init failed:', error);
+        process.exit(1);
+    });
+}