@vizzly-testing/cli 0.15.1 → 0.16.1

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,95 +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 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';

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

@@ -1,59 +0,0 @@
-/**
- * Environment Configuration Utility
- * Centralized access to environment variables with proper defaults
- */
-/**
- * Get API token from environment
- * @returns {string|undefined} API token
- */
-export function getApiToken(): string | undefined;
-/**
- * Get API URL from environment
- * @returns {string} API URL with default
- */
-export function getApiUrl(): string;
-/**
- * Get log level from environment
- * @returns {string} Log level with default
- */
-export function getLogLevel(): string;
-/**
- * Get user agent from environment
- * @returns {string|undefined} User agent string
- */
-export function getUserAgent(): string | undefined;
-/**
- * Check if Vizzly is enabled in client
- * @returns {boolean} Whether Vizzly is enabled
- */
-export function isVizzlyEnabled(): boolean;
-/**
- * Get server URL from environment
- * @returns {string|undefined} Server URL
- */
-export function getServerUrl(): string | undefined;
-/**
- * Get build ID from environment
- * @returns {string|undefined} Build ID
- */
-export function getBuildId(): string | undefined;
-/**
- * Get parallel ID from environment
- * @returns {string|undefined} Parallel ID
- */
-export function getParallelId(): string | undefined;
-/**
- * Check if TDD mode is enabled
- * @returns {boolean} Whether TDD mode is enabled
- */
-export function isTddMode(): boolean;
-/**
- * Set Vizzly enabled state (for client)
- * @param {boolean} enabled - Whether to enable Vizzly
- */
-export function setVizzlyEnabled(enabled: boolean): void;
-/**
- * Get all Vizzly environment variables
- * @returns {Object} All environment configuration
- */
-export function getAllEnvironmentConfig(): any;

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

@@ -1,36 +0,0 @@
-/**
- * Environment detection utilities for handling CI/interactive environments
- */
-/**
- * Check if running in a CI environment
- * Based on common CI environment variables
- * @returns {boolean} True if running in CI
- */
-export function isCI(): boolean;
-/**
- * Check if stdout supports interactive features
- * @returns {boolean} True if interactive features are supported
- */
-export function isInteractiveTerminal(): boolean;
-/**
- * Determine if interactive mode should be enabled
- * Takes into account CI detection, TTY support, and explicit flags
- * @param {Object} options
- * @param {boolean} [options.noInteractive] - Explicit flag to disable interactive mode
- * @param {boolean} [options.interactive] - Explicit flag to force interactive mode
- * @returns {boolean} True if interactive mode should be enabled
- */
-export function shouldUseInteractiveMode(options?: {
-    noInteractive?: boolean;
-    interactive?: boolean;
-}): boolean;
-/**
- * Get environment type for logging/debugging
- * @returns {string} Environment type description
- */
-export function getEnvironmentType(): string;
-/**
- * Get detailed environment info for debugging
- * @returns {Object} Environment details
- */
-export function getEnvironmentDetails(): any;

package/dist/types/utils/fetch-utils.d.ts

@@ -1 +0,0 @@
-export function fetchWithTimeout(url: any, opts?: {}, ms?: number): Promise<Response>;

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

@@ -1,18 +0,0 @@
-/**
- * Resolve image buffer from file path or return buffer as-is
- * Handles both Buffer inputs and file path strings, with proper validation and error handling
- *
- * @param {Buffer|string} imageBufferOrPath - Image data as Buffer or file path
- * @param {string} contextName - Context for error messages (e.g., 'screenshot', 'compare')
- * @returns {Buffer} The image buffer
- * @throws {VizzlyError} When file not found, unreadable, or invalid input type
- *
- * @example
- * // With Buffer
- * const buffer = resolveImageBuffer(myBuffer, 'screenshot');
- *
- * @example
- * // With file path
- * const buffer = resolveImageBuffer('./my-image.png', 'screenshot');
- */
-export function resolveImageBuffer(imageBufferOrPath: Buffer | string, contextName: string): Buffer;

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

@@ -1,56 +0,0 @@
-export function getCommonAncestor(commit1: any, commit2: any, cwd?: any): Promise<any>;
-export function getCurrentCommitSha(cwd?: any): Promise<any>;
-export function getCurrentBranch(cwd?: any): Promise<any>;
-export function getDefaultBranch(cwd?: any): Promise<any>;
-export function generateBuildName(): string;
-/**
- * Get the current commit message
- * @param {string} cwd - Working directory
- * @returns {Promise<string|null>} Commit message or null if not available
- */
-export function getCommitMessage(cwd?: string): Promise<string | null>;
-/**
- * Detect commit message with override and environment variable support
- * @param {string} override - Commit message override from CLI
- * @param {string} cwd - Working directory
- * @returns {Promise<string|null>} Commit message or null if not available
- */
-export function detectCommitMessage(override?: string, cwd?: string): Promise<string | null>;
-/**
- * Check if the working directory is a git repository
- * @param {string} cwd - Working directory
- * @returns {Promise<boolean>}
- */
-export function isGitRepository(cwd?: string): Promise<boolean>;
-/**
- * Get git status information
- * @param {string} cwd - Working directory
- * @returns {Promise<Object|null>} Git status info or null
- */
-export function getGitStatus(cwd?: string): Promise<any | null>;
-/**
- * Detect branch with override support
- * @param {string} override - Branch override from CLI
- * @param {string} cwd - Working directory
- * @returns {Promise<string>}
- */
-export function detectBranch(override?: string, cwd?: string): Promise<string>;
-/**
- * Detect commit SHA with override support
- * @param {string} override - Commit override from CLI
- * @param {string} cwd - Working directory
- * @returns {Promise<string|null>}
- */
-export function detectCommit(override?: string, cwd?: string): Promise<string | null>;
-/**
- * Generate build name with git information
- * @param {string} override - Build name override from CLI
- * @param {string} cwd - Working directory
- * @returns {Promise<string>}
- */
-export function generateBuildNameWithGit(override?: string, cwd?: string): Promise<string>;
-/**
- * Detect pull request number from CI environment
- * @returns {number|null} Pull request number or null if not in PR context
- */
-export function detectPullRequestNumber(): number | null;

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

@@ -1,84 +0,0 @@
-/**
- * Get the path to the global Vizzly directory
- * @returns {string} Path to ~/.vizzly
- */
-export function getGlobalConfigDir(): string;
-/**
- * Get the path to the global config file
- * @returns {string} Path to ~/.vizzly/config.json
- */
-export function getGlobalConfigPath(): string;
-/**
- * Load the global configuration
- * @returns {Promise<Object>} Global config object
- */
-export function loadGlobalConfig(): Promise<any>;
-/**
- * Save the global configuration
- * @param {Object} config - Configuration object to save
- * @returns {Promise<void>}
- */
-export function saveGlobalConfig(config: any): Promise<void>;
-/**
- * Clear all global configuration
- * @returns {Promise<void>}
- */
-export function clearGlobalConfig(): Promise<void>;
-/**
- * Get authentication tokens from global config
- * @returns {Promise<Object|null>} Token object with accessToken, refreshToken, expiresAt, user, or null if not found
- */
-export function getAuthTokens(): Promise<any | null>;
-/**
- * Save authentication tokens to global config
- * @param {Object} auth - Auth object with accessToken, refreshToken, expiresAt, user
- * @returns {Promise<void>}
- */
-export function saveAuthTokens(auth: any): Promise<void>;
-/**
- * Clear authentication tokens from global config
- * @returns {Promise<void>}
- */
-export function clearAuthTokens(): Promise<void>;
-/**
- * Check if authentication tokens exist and are not expired
- * @returns {Promise<boolean>} True if valid tokens exist
- */
-export function hasValidTokens(): Promise<boolean>;
-/**
- * Get the access token from global config if available
- * @returns {Promise<string|null>} Access token or null
- */
-export function getAccessToken(): Promise<string | null>;
-/**
- * Get project mapping for a directory
- * Walks up the directory tree to find the closest mapping
- * @param {string} directoryPath - Absolute path to project directory
- * @returns {Promise<Object|null>} Project data or null
- */
-export function getProjectMapping(directoryPath: string): Promise<any | null>;
-/**
- * Save project mapping for a directory
- * @param {string} directoryPath - Absolute path to project directory
- * @param {Object} projectData - Project configuration
- * @param {string} projectData.token - Project API token (vzt_...)
- * @param {string} projectData.projectSlug - Project slug
- * @param {string} projectData.organizationSlug - Organization slug
- * @param {string} projectData.projectName - Project name
- */
-export function saveProjectMapping(directoryPath: string, projectData: {
-    token: string;
-    projectSlug: string;
-    organizationSlug: string;
-    projectName: string;
-}): Promise<void>;
-/**
- * Get all project mappings
- * @returns {Promise<Object>} Map of directory paths to project data
- */
-export function getProjectMappings(): Promise<any>;
-/**
- * Delete project mapping for a directory
- * @param {string} directoryPath - Absolute path to project directory
- */
-export function deleteProjectMapping(directoryPath: string): Promise<void>;