@vizzly-testing/cli 0.16.0 → 0.16.2

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>;

package/dist/types/utils/image-input-detector.d.ts

@@ -1,71 +0,0 @@
-/**
- * @module image-input-detector
- * @description Utilities for detecting whether a string is a base64 image or a file path
- */
-/**
- * Check if a string is valid base64 encoded data
- *
- * Base64 strings consist only of:
- * - A-Z, a-z, 0-9, +, /
- * - Optional padding with = at the end
- * - Must be in groups of 4 characters (with optional 2-3 char group at end with padding)
- *
- * @param {string} str - String to check
- * @returns {boolean} True if the string appears to be valid base64
- *
- * @example
- * isBase64('ZmFrZS1wbmctZGF0YQ==') // true
- * isBase64('./screenshot.png') // false
- * isBase64('/absolute/path.png') // false
- */
-export function isBase64(str: string): boolean;
-/**
- * Check if a string looks like a file path
- *
- * Detects common file path patterns across platforms:
- * - Relative paths: ./file.png, ../file.png, subdirectory/file.png
- * - Absolute Unix paths: /absolute/path/file.png
- * - Absolute Windows paths: C:\path\file.png, C:/path/file.png
- * - File URIs: file:///path/to/file.png
- * - Paths with common image extensions
- *
- * Note: This is heuristic-based and doesn't check file existence
- *
- * @param {string} str - String to check
- * @returns {boolean} True if the string looks like a file path
- *
- * @example
- * looksLikeFilePath('./screenshot.png') // true
- * looksLikeFilePath('/abs/path/file.png') // true
- * looksLikeFilePath('C:\\Windows\\file.png') // true
- * looksLikeFilePath('ZmFrZS1wbmctZGF0YQ==') // false
- */
-export function looksLikeFilePath(str: string): boolean;
-/**
- * Detect the type of image input
- *
- * Determines whether a string input is:
- * - 'base64': Base64 encoded image data
- * - 'file-path': A file path (relative or absolute)
- * - 'unknown': Cannot determine (ambiguous or invalid)
- *
- * Strategy:
- * 1. First check if it's valid base64 (can contain / which might look like paths)
- * 2. Then check if it looks like a file path (more specific patterns)
- * 3. Otherwise return 'unknown'
- *
- * This order prevents base64 strings (which can contain /) from being
- * misidentified as file paths. Base64 validation is stricter and should
- * be checked first.
- *
- * @param {string} str - String to detect
- * @returns {'base64' | 'file-path' | 'unknown'} Detected input type
- *
- * @example
- * detectImageInputType('./screenshot.png') // 'file-path'
- * detectImageInputType('ZmFrZS1wbmctZGF0YQ==') // 'base64'
- * detectImageInputType('data:image/png;base64,iVBOR...') // 'base64'
- * detectImageInputType('C:\\path\\image.png') // 'file-path'
- * detectImageInputType('invalid!!!') // 'unknown'
- */
-export function detectImageInputType(str: string): "base64" | "file-path" | "unknown";

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

@@ -1,84 +0,0 @@
-/**
- * Configure output settings
- * Call this once at CLI startup with global options
- */
-export function configure(options?: {}): void;
-/**
- * Show command header (e.g., "vizzly · tdd · local")
- * Only shows once per command execution
- */
-export function header(command: any, mode?: any): void;
-/**
- * Get current colors instance (for custom formatting)
- */
-export function getColors(): {
-    success: any;
-    error: any;
-    warning: any;
-    info: any;
-};
-/**
- * Show a success message
- */
-export function success(message: any, data?: {}): void;
-/**
- * Show final result summary (e.g., "✓ 5 screenshots · 234ms")
- */
-export function result(message: any): void;
-/**
- * Show an info message
- */
-export function info(message: any, data?: {}): void;
-/**
- * Show a warning message (goes to stderr)
- */
-export function warn(message: any, data?: {}): void;
-/**
- * Show an error message (goes to stderr)
- * Does NOT exit - caller decides whether to exit
- */
-export function error(message: any, err?: any, data?: {}): void;
-/**
- * Print a blank line for spacing
- */
-export function blank(): void;
-/**
- * Print raw text without any formatting
- */
-export function print(text: any): void;
-/**
- * Print raw text to stderr
- */
-export function printErr(text: any): void;
-/**
- * Output structured data
- */
-export function data(obj: any): void;
-/**
- * Start a spinner with message
- */
-export function startSpinner(message: any): void;
-/**
- * Update spinner message
- */
-export function updateSpinner(message: any, current?: number, total?: number): void;
-/**
- * Stop the spinner
- */
-export function stopSpinner(): void;
-/**
- * Show progress update
- */
-export function progress(message: any, current?: number, total?: number): void;
-/**
- * Log debug message with component prefix (only shown in verbose mode)
- *
- * @param {string} component - Component name (e.g., 'server', 'config', 'build')
- * @param {string} message - Debug message
- * @param {Object} data - Optional data object to display inline
- */
-export function debug(component: string, message: string, data?: any): void;
-/**
- * Clean up (stop spinner, flush logs)
- */
-export function cleanup(): void;

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

@@ -1,15 +0,0 @@
-/**
- * Get package.json information
- * @returns {Object} Package.json data
- */
-export function getPackageInfo(): any;
-/**
- * Get package version
- * @returns {string} Package version
- */
-export function getPackageVersion(): string;
-/**
- * Get package name
- * @returns {string} Package name
- */
-export function getPackageName(): string;

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

@@ -1,30 +0,0 @@
-/**
- * Sanitizes a screenshot name to prevent path traversal and ensure safe file naming
- * @param {string} name - Original screenshot name
- * @param {number} maxLength - Maximum allowed length (default: 255)
- * @param {boolean} allowSlashes - Whether to allow forward slashes (for browser version strings)
- * @returns {string} Sanitized screenshot name
- */
-export function sanitizeScreenshotName(name: string, maxLength?: number, allowSlashes?: boolean): string;
-/**
- * Validates that a path stays within the allowed working directory bounds
- * @param {string} targetPath - Path to validate
- * @param {string} workingDir - Working directory that serves as the security boundary
- * @returns {string} Resolved and normalized path if valid
- * @throws {Error} If path is invalid or outside bounds
- */
-export function validatePathSecurity(targetPath: string, workingDir: string): string;
-/**
- * Safely constructs a path within the working directory
- * @param {string} workingDir - Base working directory
- * @param {...string} pathSegments - Path segments to join
- * @returns {string} Safely constructed path
- * @throws {Error} If resulting path would be outside working directory
- */
-export function safePath(workingDir: string, ...pathSegments: string[]): string;
-/**
- * Validates screenshot properties object for safe values
- * @param {Object} properties - Properties to validate
- * @returns {Object} Validated properties object
- */
-export function validateScreenshotProperties(properties?: any): any;