@vizzly-testing/cli/dist/services/build-manager.js

Visual review platform for UI developers and designers

/**
 * Build Manager - Pure functions for build lifecycle management
 */

import crypto from 'node:crypto';

/**
 * Generate unique build ID for local build management only.
 * Note: The API generates its own UUIDs for actual builds - this local ID
 * is only used for CLI internal tracking and is not sent to the API.
 * @returns {string} Build ID
 */
export function generateBuildId() {
  return `build-${crypto.randomUUID()}`;
}

/**
 * Create build object
 * @param {Object} buildOptions - Build configuration
 * @returns {Object} Build object
 */
export function createBuildObject(buildOptions) {
  const {
    name,
    branch,
    commit,
    environment = 'test',
    metadata = {}
  } = buildOptions;
  return {
    id: generateBuildId(),
    name: name || `build-${Date.now()}`,
    branch,
    commit,
    environment,
    metadata,
    status: 'pending',
    createdAt: new Date().toISOString(),
    screenshots: []
  };
}

/**
 * Update build with new status and data
 * @param {Object} build - Current build
 * @param {string} status - New status
 * @param {Object} updates - Additional updates
 * @returns {Object} Updated build
 */
export function updateBuild(build, status, updates = {}) {
  return {
    ...build,
    status,
    updatedAt: new Date().toISOString(),
    ...updates
  };
}

/**
 * Add screenshot to build
 * @param {Object} build - Current build
 * @param {Object} screenshot - Screenshot data
 * @returns {Object} Updated build
 */
export function addScreenshotToBuild(build, screenshot) {
  return {
    ...build,
    screenshots: [...build.screenshots, {
      ...screenshot,
      addedAt: new Date().toISOString()
    }]
  };
}

/**
 * Finalize build with result
 * @param {Object} build - Current build
 * @param {Object} result - Build result
 * @returns {Object} Finalized build
 */
export function finalizeBuildObject(build, result = {}) {
  const finalStatus = result.success ? 'completed' : 'failed';
  return {
    ...build,
    status: finalStatus,
    completedAt: new Date().toISOString(),
    result
  };
}

/**
 * Create queued build item
 * @param {Object} buildOptions - Build options
 * @returns {Object} Queued build item
 */
export function createQueuedBuild(buildOptions) {
  return {
    ...buildOptions,
    queuedAt: new Date().toISOString()
  };
}

/**
 * Validate build options
 * @param {Object} buildOptions - Build options to validate
 * @returns {Object} Validation result
 */
export function validateBuildOptions(buildOptions) {
  let errors = [];
  if (!buildOptions.name && !buildOptions.branch) {
    errors.push('Either name or branch is required');
  }
  if (buildOptions.environment && !['test', 'staging', 'production'].includes(buildOptions.environment)) {
    errors.push('Environment must be one of: test, staging, production');
  }
  return {
    valid: errors.length === 0,
    errors
  };
}