@vizzly-testing/cli 0.16.0 → 0.16.2

package/dist/types/services/server-manager.d.ts

@@ -1,269 +0,0 @@
-export class ServerManager {
-    constructor(config: any, options?: {});
-    config: any;
-    httpServer: {
-        start: () => Promise<any>;
-        stop: () => Promise<any>;
-        finishBuild: (_buildId: any) => Promise<any>;
-        getServer: () => any;
-    };
-    handler: {
-        initialize: () => Promise<void>;
-        handleScreenshot: (buildId: any, name: any, image: any, properties?: {}) => Promise<{
-            statusCode: number;
-            body: {
-                error: string;
-                details: any;
-                tddMode: boolean;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                comparison?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                originalPath: any;
-                tddMode: boolean;
-                details?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                comparison?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                filePath: any;
-                tddMode: boolean;
-                details?: undefined;
-                originalPath?: undefined;
-                receivedType?: undefined;
-                comparison?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                tddMode: boolean;
-                details?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                comparison?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                receivedType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
-                tddMode: boolean;
-                details?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                comparison?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                details: string;
-                comparison: {
-                    name: any;
-                    status: string;
-                    baseline: any;
-                    current: any;
-                    diff: any;
-                    diffPercentage: any;
-                    threshold: any;
-                };
-                tddMode: boolean;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                status?: undefined;
-                message?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                status: string;
-                message: string;
-                comparison: {
-                    name: any;
-                    status: string;
-                    baseline: any;
-                    current: any;
-                    diff?: undefined;
-                    diffPercentage?: undefined;
-                    threshold?: undefined;
-                };
-                tddMode: boolean;
-                error?: undefined;
-                details?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                success?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                success: boolean;
-                comparison: {
-                    name: any;
-                    status: string;
-                    baseline?: undefined;
-                    current?: undefined;
-                    diff?: undefined;
-                    diffPercentage?: undefined;
-                    threshold?: undefined;
-                };
-                tddMode: boolean;
-                error?: undefined;
-                details?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                status?: undefined;
-                message?: undefined;
-            };
-        }>;
-        getResults: () => Promise<{
-            total: number;
-            passed: number;
-            failed: number;
-            new: number;
-            errors: number;
-            comparisons: any[];
-            baseline: any;
-        }>;
-        acceptBaseline: (comparisonId: any) => Promise<any>;
-        acceptAllBaselines: () => Promise<{
-            count: number;
-        }>;
-        resetBaselines: () => Promise<{
-            success: boolean;
-            deletedBaselines: number;
-            deletedCurrents: number;
-            deletedDiffs: number;
-        }>;
-        cleanup: () => void;
-        tddService: import("./tdd-service.js").TddService;
-    } | {
-        handleScreenshot: (buildId: any, name: any, image: any, properties?: {}) => Promise<{
-            statusCode: number;
-            body: {
-                success: boolean;
-                disabled: boolean;
-                count: number;
-                message: string;
-                error?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                name?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                success?: undefined;
-                disabled?: undefined;
-                count?: undefined;
-                message?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                name?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                originalPath: any;
-                success?: undefined;
-                disabled?: undefined;
-                count?: undefined;
-                message?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-                name?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                filePath: any;
-                success?: undefined;
-                disabled?: undefined;
-                count?: undefined;
-                message?: undefined;
-                originalPath?: undefined;
-                receivedType?: undefined;
-                name?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                error: string;
-                receivedType: "string" | "number" | "bigint" | "boolean" | "symbol" | "undefined" | "object" | "function";
-                success?: undefined;
-                disabled?: undefined;
-                count?: undefined;
-                message?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                name?: undefined;
-            };
-        } | {
-            statusCode: number;
-            body: {
-                success: boolean;
-                name: any;
-                count: number;
-                disabled?: undefined;
-                message?: undefined;
-                error?: undefined;
-                originalPath?: undefined;
-                filePath?: undefined;
-                receivedType?: undefined;
-            };
-        }>;
-        getScreenshotCount: () => number;
-        flush: () => Promise<{
-            uploaded: number;
-            failed: number;
-            total: number;
-        }>;
-        cleanup: () => void;
-    };
-    services: any;
-    start(buildId?: any, tddMode?: boolean, setBaseline?: boolean): Promise<void>;
-    buildId: any;
-    tddMode: boolean;
-    setBaseline: boolean;
-    createApiService(): Promise<import("./api-service.js").ApiService>;
-    stop(): Promise<void>;
-    get server(): {
-        getScreenshotCount: (buildId: any) => any;
-        finishBuild: (buildId: any) => Promise<any>;
-    };
-}

package/dist/types/services/static-report-generator.d.ts

@@ -1,25 +0,0 @@
-export class StaticReportGenerator {
-    constructor(workingDir: any, config: any);
-    workingDir: any;
-    config: any;
-    reportDir: any;
-    reportPath: any;
-    /**
-     * Generate static HTML report with React reporter bundle
-     * @param {Object} reportData - Complete report data (same format as live dashboard)
-     * @returns {Promise<string>} Path to generated report
-     */
-    generateReport(reportData: any): Promise<string>;
-    /**
-     * Generate HTML template with embedded React app
-     * @param {Object} reportData - Report data to embed
-     * @returns {string} HTML content
-     */
-    generateHtmlTemplate(reportData: any): string;
-    /**
-     * Generate a minimal HTML report when bundles are missing (fallback)
-     * @param {Object} reportData - Report data
-     * @returns {string} Minimal HTML content
-     */
-    generateFallbackHtml(reportData: any): string;
-}

package/dist/types/services/tdd-service.d.ts

@@ -1,122 +0,0 @@
-/**
- * Create a new TDD service instance
- */
-export function createTDDService(config: any, options?: {}): TddService;
-export class TddService {
-    constructor(config: any, workingDir?: any, setBaseline?: boolean, authService?: any);
-    config: any;
-    setBaseline: boolean;
-    authService: any;
-    api: ApiService;
-    workingDir: string;
-    baselinePath: string;
-    currentPath: string;
-    diffPath: string;
-    baselineData: any;
-    comparisons: any[];
-    threshold: any;
-    downloadBaselines(environment?: string, branch?: any, buildId?: any, comparisonId?: any): Promise<any>;
-    /**
-     * Download hotspot data for screenshots from the cloud
-     * Hotspots identify regions that frequently change (timestamps, IDs, etc.)
-     * Used to filter out known dynamic content during comparisons
-     * @param {Array} screenshots - Array of screenshot objects with name property
-     */
-    downloadHotspots(screenshots: any[]): Promise<void>;
-    hotspotData: any;
-    /**
-     * Load hotspot data from disk
-     * @returns {Object|null} Hotspot data keyed by screenshot name, or null if not available
-     */
-    loadHotspots(): any | null;
-    /**
-     * Get hotspot analysis for a specific screenshot
-     * @param {string} screenshotName - Name of the screenshot
-     * @returns {Object|null} Hotspot analysis or null if not available
-     */
-    getHotspotForScreenshot(screenshotName: string): any | null;
-    /**
-     * Calculate what percentage of diff falls within hotspot regions
-     * Uses 1D Y-coordinate matching (same algorithm as cloud)
-     * @param {Array} diffClusters - Array of diff clusters from honeydiff
-     * @param {Object} hotspotAnalysis - Hotspot data with regions array
-     * @returns {Object} Coverage info { coverage, linesInHotspots, totalLines }
-     */
-    calculateHotspotCoverage(diffClusters: any[], hotspotAnalysis: any): any;
-    /**
-     * Download baselines using OAuth authentication
-     * Used when user is logged in via device flow but no API token is configured
-     * @param {string} buildId - Build ID to download from
-     * @param {string} organizationSlug - Organization slug
-     * @param {string} projectSlug - Project slug
-     * @param {Object} authService - Auth service for OAuth requests
-     * @returns {Promise<Object>} Download result
-     */
-    downloadBaselinesWithAuth(buildId: string, organizationSlug: string, projectSlug: string, authService: any): Promise<any>;
-    /**
-     * Handle local baseline logic (either load existing or prepare for new baselines)
-     * @returns {Promise<Object|null>} Baseline data or null if no local baselines exist
-     */
-    handleLocalBaselines(): Promise<any | null>;
-    loadBaseline(): Promise<any>;
-    compareScreenshot(name: any, imageBuffer: any, properties?: {}): Promise<{
-        id: any;
-        name: any;
-        status: string;
-        baseline: any;
-        current: any;
-        diff: any;
-        properties: any;
-        signature: string;
-    }>;
-    getResults(): {
-        total: number;
-        passed: number;
-        failed: number;
-        new: number;
-        errors: number;
-        comparisons: any[];
-        baseline: any;
-    };
-    printResults(): Promise<{
-        total: number;
-        passed: number;
-        failed: number;
-        new: number;
-        errors: number;
-        comparisons: any[];
-        baseline: any;
-    }>;
-    /**
-     * Generate HTML report for TDD results
-     * @param {Object} results - TDD comparison results
-     */
-    generateHtmlReport(results: any): Promise<string>;
-    /**
-     * Open HTML report in default browser
-     * @param {string} reportPath - Path to HTML report
-     */
-    openReport(reportPath: string): Promise<void>;
-    /**
-     * Update baselines with current screenshots (accept changes)
-     * @returns {number} Number of baselines updated
-     */
-    updateBaselines(): number;
-    /**
-     * Create a new baseline (used during --set-baseline mode)
-     * @private
-     */
-    private createNewBaseline;
-    /**
-     * Update a single baseline with current screenshot
-     * @private
-     */
-    private updateSingleBaseline;
-    /**
-     * Accept a current screenshot as the new baseline
-     * @param {string|Object} idOrComparison - Comparison ID or comparison object
-     * @returns {Object} Result object
-     */
-    acceptBaseline(idOrComparison: string | any): any;
-}
-import { ApiService } from '../services/api-service.js';

package/dist/types/services/test-runner.d.ts

@@ -1,31 +0,0 @@
-export class TestRunner {
-    constructor(config: any, buildManager: any, serverManager: any, tddService: any);
-    config: any;
-    buildManager: any;
-    serverManager: any;
-    tddService: any;
-    testProcess: any;
-    /**
-     * Initialize server for daemon mode (no test execution)
-     * @param {Object} options - Options for server initialization
-     */
-    initialize(options: any): Promise<void>;
-    run(options: any): Promise<{
-        testsPassed: number;
-        testsFailed: number;
-        screenshotsCaptured: number;
-        buildId?: undefined;
-        url?: undefined;
-    } | {
-        buildId: any;
-        url: any;
-        testsPassed: number;
-        testsFailed: number;
-        screenshotsCaptured: number;
-    }>;
-    createBuild(options: any, tdd: any): Promise<any>;
-    createApiService(): Promise<import("./api-service.js").ApiService>;
-    finalizeBuild(buildId: any, isTddMode: any, success: any, executionTime: any): Promise<void>;
-    executeTestCommand(testCommand: any, env: any): Promise<any>;
-    cancel(): Promise<void>;
-}

package/dist/types/services/uploader.d.ts

@@ -1,36 +0,0 @@
-/**
- * Create a new uploader instance
- */
-export function createUploader({ apiKey, apiUrl, userAgent, command, upload: uploadConfig }: {
-    apiKey: any;
-    apiUrl: any;
-    userAgent: any;
-    command: any;
-    upload?: {};
-}, options?: {}): {
-    upload: ({ screenshotsDir, buildName, branch, commit, message, environment, threshold, pullRequestNumber, parallelId, onProgress, }: {
-        screenshotsDir: any;
-        buildName: any;
-        branch: any;
-        commit: any;
-        message: any;
-        environment?: string;
-        threshold: any;
-        pullRequestNumber: any;
-        parallelId: any;
-        onProgress?: () => void;
-    }) => Promise<{
-        success: boolean;
-        buildId: any;
-        url: any;
-        stats: {
-            total: number;
-            uploaded: any;
-            skipped: any;
-        };
-    }>;
-    waitForBuild: (buildId: any, timeout?: number) => Promise<{
-        status: string;
-        build: any;
-    }>;
-};

package/dist/types/utils/browser.d.ts

@@ -1,6 +0,0 @@
-/**
- * Open a URL in the default browser
- * @param {string} url - URL to open
- * @returns {Promise<boolean>} True if successful
- */
-export function openBrowser(url: string): Promise<boolean>;

package/dist/types/utils/build-history.d.ts

@@ -1,16 +0,0 @@
-/**
- * Archive a build to history directory
- * @param {string} workingDir - Working directory
- * @param {string} buildId - Build ID to archive
- * @param {Array} builds - Build data
- * @param {Array} comparisons - Comparison data
- * @param {Object} summary - Summary stats
- * @param {number} maxHistory - Maximum number of builds to keep (default: 3)
- */
-export function archiveBuild(workingDir: string, buildId: string, builds: any[], comparisons: any[], summary: any, maxHistory?: number): void;
-/**
- * Get list of archived builds
- * @param {string} workingDir - Working directory
- * @returns {Array} Array of build metadata
- */
-export function getArchivedBuilds(workingDir: string): any[];

package/dist/types/utils/ci-env.d.ts

@@ -1,55 +0,0 @@
-/**
- * CI Environment Detection
- *
- * Generic functions to extract git and PR information from any CI provider
- */
-/**
- * Get the branch name from CI environment variables
- * @returns {string|null} Branch name or null if not available
- */
-export function getBranch(): string | null;
-/**
- * Get the commit SHA from CI environment variables
- * @returns {string|null} Commit SHA or null if not available
- */
-export function getCommit(): string | null;
-/**
- * Get the commit message from CI environment variables
- * @returns {string|null} Commit message or null if not available
- */
-export function getCommitMessage(): string | null;
-/**
- * Get the pull request number from CI environment variables
- * @returns {number|null} PR number or null if not available/not a PR
- */
-export function getPullRequestNumber(): number | null;
-/**
- * Get the PR head SHA from CI environment variables
- * @returns {string|null} PR head SHA or null if not available
- */
-export function getPullRequestHeadSha(): string | null;
-/**
- * Get the PR base SHA from CI environment variables
- * @returns {string|null} PR base SHA or null if not available
- */
-export function getPullRequestBaseSha(): string | null;
-/**
- * Get the PR head ref (branch) from CI environment variables
- * @returns {string|null} PR head ref or null if not available
- */
-export function getPullRequestHeadRef(): string | null;
-/**
- * Get the PR base ref (target branch) from CI environment variables
- * @returns {string|null} PR base ref or null if not available
- */
-export function getPullRequestBaseRef(): string | null;
-/**
- * Check if we're currently in a pull request context
- * @returns {boolean} True if in a PR context
- */
-export function isPullRequest(): boolean;
-/**
- * Get the CI provider name
- * @returns {string} CI provider name or 'unknown'
- */
-export function getCIProvider(): string;

package/dist/types/utils/colors.d.ts

@@ -1,12 +0,0 @@
-export function createColors(options?: {}): {
-    success: any;
-    error: any;
-    warning: any;
-    info: any;
-};
-export namespace colors {
-    let success: any;
-    let error: any;
-    let warning: any;
-    let info: any;
-}

package/dist/types/utils/config-helpers.d.ts

@@ -1,6 +0,0 @@
-/**
- * Define Vizzly configuration with type hints
- * @param {import('../types/index.js').VizzlyConfig} config
- * @returns {import('../types/index.js').VizzlyConfig}
- */
-export function defineConfig(config: any): any;

package/dist/types/utils/config-loader.d.ts

@@ -1,25 +0,0 @@
-export function loadConfig(configPath?: any, cliOverrides?: {}): Promise<{
-    server: {
-        port: number;
-        timeout: number;
-    };
-    build: {
-        name: string;
-        environment: string;
-    };
-    upload: {
-        screenshotsDir: string;
-        batchSize: number;
-        timeout: number;
-    };
-    comparison: {
-        threshold: number;
-    };
-    tdd: {
-        openReport: boolean;
-    };
-    plugins: any[];
-    apiKey: any;
-    apiUrl: string;
-}>;
-export function getScreenshotPaths(config: any): any[];

package/dist/types/utils/config-schema.d.ts

@@ -1,51 +0,0 @@
-/**
- * Validate Vizzly configuration
- * @param {unknown} config - Configuration to validate
- * @returns {Object} Validated configuration
- * @throws {ZodError} If validation fails
- */
-export function validateVizzlyConfig(config: unknown): any;
-/**
- * Safely validate with defaults if config is missing
- * @param {unknown} config - Configuration to validate (can be undefined)
- * @returns {Object} Validated configuration with defaults
- */
-export function validateVizzlyConfigWithDefaults(config: unknown): any;
-/**
- * Core Vizzly configuration schema
- * Allows plugin-specific keys with passthrough for extensibility
- */
-export let vizzlyConfigSchema: z.ZodDefault<z.ZodObject<{
-    apiKey: z.ZodOptional<z.ZodString>;
-    apiUrl: z.ZodOptional<z.ZodString>;
-    server: z.ZodDefault<z.ZodObject<{
-        port: z.ZodDefault<z.ZodNumber>;
-        timeout: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    build: z.ZodDefault<z.ZodObject<{
-        name: z.ZodDefault<z.ZodString>;
-        environment: z.ZodDefault<z.ZodString>;
-        branch: z.ZodOptional<z.ZodString>;
-        commit: z.ZodOptional<z.ZodString>;
-        message: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>>;
-    upload: z.ZodDefault<z.ZodObject<{
-        screenshotsDir: z.ZodDefault<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
-        batchSize: z.ZodDefault<z.ZodNumber>;
-        timeout: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    comparison: z.ZodDefault<z.ZodObject<{
-        threshold: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>;
-    tdd: z.ZodDefault<z.ZodObject<{
-        openReport: z.ZodDefault<z.ZodBoolean>;
-    }, z.core.$strip>>;
-    plugins: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    parallelId: z.ZodOptional<z.ZodString>;
-    baselineBuildId: z.ZodOptional<z.ZodString>;
-    baselineComparisonId: z.ZodOptional<z.ZodString>;
-    eager: z.ZodOptional<z.ZodBoolean>;
-    wait: z.ZodOptional<z.ZodBoolean>;
-    allowNoToken: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$loose>>;
-import { z } from 'zod';