@vizzly-testing/cli 0.39.1 → 0.39.2

package/dist/config/operations.js

@@ -1,327 +0,0 @@
-/**
- * Config Operations - Configuration operations with dependency injection
- *
- * Each operation takes its dependencies as parameters:
- * - explorer: cosmiconfig explorer for project config
- * - globalConfigStore: for reading/writing global config
- * - fileWriter: for writing project config files
- *
- * This makes them trivially testable without mocking modules.
- */
-
-import { join } from 'node:path';
-import { VizzlyError } from '../errors/vizzly-error.js';
-import { buildGlobalConfigResult, buildMergedConfigResult, buildProjectConfigResult, deepMerge, extractCosmiconfigResult, extractEnvOverrides, getConfigFormat, serializeConfig, validateReadScope, validateWriteScope } from './core.js';
-
-// ============================================================================
-// Read Operations
-// ============================================================================
-
-/**
- * Get project-level config from vizzly.config.js or similar
- * @param {Object} explorer - Cosmiconfig explorer with search method
- * @param {string} projectRoot - Project root directory
- * @returns {Promise<{ config: Object, filepath: string|null, isEmpty: boolean }>}
- */
-export async function getProjectConfig(explorer, projectRoot) {
-  let result = explorer.search(projectRoot);
-  let {
-    config,
-    filepath
-  } = extractCosmiconfigResult(result);
-  return buildProjectConfigResult(config, filepath);
-}
-
-/**
- * Get global config from ~/.vizzly/config.json
- * @param {Object} globalConfigStore - Store with load and getPath methods
- * @returns {Promise<{ config: Object, filepath: string, isEmpty: boolean }>}
- */
-export async function getGlobalConfig(globalConfigStore) {
-  let config = await globalConfigStore.load();
-  let filepath = globalConfigStore.getPath();
-  return buildGlobalConfigResult(config, filepath);
-}
-
-/**
- * Get merged config from all sources with source tracking
- * @param {Object} options - Options
- * @param {Object} options.explorer - Cosmiconfig explorer
- * @param {Object} options.globalConfigStore - Global config store
- * @param {string} options.projectRoot - Project root directory
- * @param {Object} [options.env] - Environment variables (defaults to process.env)
- * @returns {Promise<{ config: Object, sources: Object, projectFilepath: string|null, globalFilepath: string }>}
- */
-export async function getMergedConfig({
-  explorer,
-  globalConfigStore,
-  projectRoot,
-  env = process.env
-}) {
-  let projectConfigData = await getProjectConfig(explorer, projectRoot);
-  let globalConfigData = await getGlobalConfig(globalConfigStore);
-  let envOverrides = extractEnvOverrides(env);
-  return buildMergedConfigResult({
-    projectConfig: projectConfigData.config,
-    globalConfig: globalConfigData.config,
-    envOverrides,
-    projectFilepath: projectConfigData.filepath,
-    globalFilepath: globalConfigData.filepath
-  });
-}
-
-/**
- * Get configuration based on scope
- * @param {Object} options - Options
- * @param {string} options.scope - 'project', 'global', or 'merged'
- * @param {Object} options.explorer - Cosmiconfig explorer
- * @param {Object} options.globalConfigStore - Global config store
- * @param {string} options.projectRoot - Project root directory
- * @param {Object} [options.env] - Environment variables
- * @returns {Promise<Object>} Config result based on scope
- */
-export async function getConfig({
-  scope = 'merged',
-  explorer,
-  globalConfigStore,
-  projectRoot,
-  env
-}) {
-  let validation = validateReadScope(scope);
-  if (!validation.valid) {
-    throw validation.error;
-  }
-  if (scope === 'project') {
-    return getProjectConfig(explorer, projectRoot);
-  }
-  if (scope === 'global') {
-    return getGlobalConfig(globalConfigStore);
-  }
-  return getMergedConfig({
-    explorer,
-    globalConfigStore,
-    projectRoot,
-    env
-  });
-}
-
-// ============================================================================
-// Write Operations
-// ============================================================================
-
-/**
- * Update project-level config
- * @param {Object} options - Options
- * @param {Object} options.updates - Config updates to apply
- * @param {Object} options.explorer - Cosmiconfig explorer
- * @param {string} options.projectRoot - Project root directory
- * @param {Function} options.writeFile - Async file writer (path, content) => Promise
- * @param {Function} options.readFile - Async file reader (path) => Promise<string>
- * @param {Function} options.validate - Config validator
- * @returns {Promise<{ config: Object, filepath: string }>}
- */
-export async function updateProjectConfig({
-  updates,
-  explorer,
-  projectRoot,
-  writeFile,
-  readFile,
-  validate
-}) {
-  let result = explorer.search(projectRoot);
-  let {
-    config: currentConfig,
-    filepath: configPath
-  } = extractCosmiconfigResult(result);
-
-  // Determine config file path - create new if none exists
-  if (!configPath) {
-    configPath = join(projectRoot, 'vizzly.config.js');
-    currentConfig = {};
-  }
-
-  // Merge updates with current config
-  let newConfig = deepMerge(currentConfig, updates);
-
-  // Validate before writing
-  try {
-    validate(newConfig);
-  } catch (error) {
-    throw new VizzlyError(`Invalid configuration: ${error.message}`, 'CONFIG_VALIDATION_ERROR', {
-      errors: error.errors
-    });
-  }
-
-  // Write config file based on format
-  await writeProjectConfigFile({
-    filepath: configPath,
-    config: newConfig,
-    writeFile,
-    readFile
-  });
-
-  // Clear cosmiconfig cache
-  explorer.clearCaches();
-  return {
-    config: newConfig,
-    filepath: configPath
-  };
-}
-
-/**
- * Write project config to file
- * @param {Object} options - Options
- * @param {string} options.filepath - Path to write to
- * @param {Object} options.config - Config object
- * @param {Function} options.writeFile - Async file writer
- * @param {Function} options.readFile - Async file reader (for package.json)
- * @returns {Promise<void>}
- */
-export async function writeProjectConfigFile({
-  filepath,
-  config,
-  writeFile,
-  readFile
-}) {
-  let format = getConfigFormat(filepath);
-  if (format === 'package') {
-    // For package.json, merge into existing
-    let pkgContent = await readFile(filepath);
-    let pkg;
-    try {
-      pkg = JSON.parse(pkgContent);
-    } catch (error) {
-      throw new VizzlyError(`Failed to parse package.json: ${error.message}`, 'INVALID_PACKAGE_JSON');
-    }
-    pkg.vizzly = config;
-    await writeFile(filepath, JSON.stringify(pkg, null, 2));
-    return;
-  }
-  let serialized = serializeConfig(config, filepath);
-  if (serialized.error) {
-    throw serialized.error;
-  }
-  await writeFile(filepath, serialized.content);
-}
-
-/**
- * Update global config
- * @param {Object} options - Options
- * @param {Object} options.updates - Config updates to apply
- * @param {Object} options.globalConfigStore - Global config store with load and save methods
- * @returns {Promise<{ config: Object, filepath: string }>}
- */
-export async function updateGlobalConfig({
-  updates,
-  globalConfigStore
-}) {
-  let currentConfig = await globalConfigStore.load();
-  let newConfig = deepMerge(currentConfig, updates);
-  await globalConfigStore.save(newConfig);
-  return {
-    config: newConfig,
-    filepath: globalConfigStore.getPath()
-  };
-}
-
-/**
- * Update configuration based on scope
- * @param {Object} options - Options
- * @param {string} options.scope - 'project' or 'global'
- * @param {Object} options.updates - Config updates to apply
- * @param {Object} options.explorer - Cosmiconfig explorer
- * @param {Object} options.globalConfigStore - Global config store
- * @param {string} options.projectRoot - Project root directory
- * @param {Function} options.writeFile - Async file writer
- * @param {Function} options.readFile - Async file reader
- * @param {Function} options.validate - Config validator
- * @returns {Promise<{ config: Object, filepath: string }>}
- */
-export async function updateConfig({
-  scope,
-  updates,
-  explorer,
-  globalConfigStore,
-  projectRoot,
-  writeFile,
-  readFile,
-  validate
-}) {
-  let validation = validateWriteScope(scope);
-  if (!validation.valid) {
-    throw validation.error;
-  }
-  if (scope === 'project') {
-    return updateProjectConfig({
-      updates,
-      explorer,
-      projectRoot,
-      writeFile,
-      readFile,
-      validate
-    });
-  }
-  return updateGlobalConfig({
-    updates,
-    globalConfigStore
-  });
-}
-
-// ============================================================================
-// Validation Operations
-// ============================================================================
-
-/**
- * Validate configuration object
- * @param {Object} config - Config to validate
- * @param {Function} validateFn - Validation function
- * @returns {{ valid: boolean, config: Object|null, errors: Array }}
- */
-export function validateConfig(config, validateFn) {
-  try {
-    let validated = validateFn(config);
-    return {
-      valid: true,
-      config: validated,
-      errors: []
-    };
-  } catch (error) {
-    return {
-      valid: false,
-      config: null,
-      errors: error.errors || [{
-        message: error.message
-      }]
-    };
-  }
-}
-
-// ============================================================================
-// Source Lookup
-// ============================================================================
-
-/**
- * Get the source of a specific config key
- * @param {Object} options - Options
- * @param {string} options.key - Config key to look up
- * @param {Object} options.explorer - Cosmiconfig explorer
- * @param {Object} options.globalConfigStore - Global config store
- * @param {string} options.projectRoot - Project root directory
- * @param {Object} [options.env] - Environment variables
- * @returns {Promise<string>} Source ('default', 'global', 'project', 'env', 'unknown')
- */
-export async function getConfigSource({
-  key,
-  explorer,
-  globalConfigStore,
-  projectRoot,
-  env
-}) {
-  let merged = await getMergedConfig({
-    explorer,
-    globalConfigStore,
-    projectRoot,
-    env
-  });
-  return merged.sources[key] || 'unknown';
-}

package/dist/project/core.js

@@ -1,211 +0,0 @@
-/**
- * Project Core - Pure functions for project logic
- *
- * No I/O, no side effects - just data transformations.
- */
-
-import { VizzlyError } from '../errors/vizzly-error.js';
-
-// ============================================================================
-// API Request Helpers
-// ============================================================================
-
-/**
- * Build query params for builds API request
- * @param {Object} options - Query options
- * @param {number} [options.limit] - Number of builds to fetch
- * @param {string} [options.branch] - Filter by branch
- * @returns {string} Query string (empty string if no params)
- */
-export function buildBuildsQueryParams(options = {}) {
-  let params = new globalThis.URLSearchParams();
-  if (options.limit) {
-    params.append('limit', String(options.limit));
-  }
-  if (options.branch) {
-    params.append('branch', options.branch);
-  }
-  let query = params.toString();
-  return query ? `?${query}` : '';
-}
-
-/**
- * Build organization header object
- * @param {string} organizationSlug - Organization slug
- * @returns {Object} Headers object with X-Organization header
- */
-export function buildOrgHeader(organizationSlug) {
-  return {
-    'X-Organization': organizationSlug
-  };
-}
-
-/**
- * Build API URL for project endpoint
- * @param {string} projectSlug - Project slug
- * @returns {string} API URL path
- */
-export function buildProjectUrl(projectSlug) {
-  return `/api/project/${projectSlug}`;
-}
-
-/**
- * Build API URL for builds endpoint
- * @param {string} projectSlug - Project slug
- * @param {Object} options - Query options
- * @returns {string} Full API URL path with query params
- */
-export function buildBuildsUrl(projectSlug, options = {}) {
-  let queryString = buildBuildsQueryParams(options);
-  return `/api/build/${projectSlug}${queryString}`;
-}
-
-/**
- * Build API URL for project tokens endpoint
- * @param {string} organizationSlug - Organization slug
- * @param {string} projectSlug - Project slug
- * @param {string} [tokenId] - Optional token ID for specific token operations
- * @returns {string} API URL path
- */
-export function buildTokensUrl(_organizationSlug, projectSlug, tokenId) {
-  let base = `/api/project/${projectSlug}/tokens`;
-  return tokenId ? `${base}/${tokenId}` : base;
-}
-
-// ============================================================================
-// Response Extraction
-// ============================================================================
-
-/**
- * Extract projects from API response
- * @param {Object} response - API response
- * @returns {Array} Array of projects
- */
-export function extractProjects(response) {
-  return response?.projects || [];
-}
-
-/**
- * Extract project from API response
- * @param {Object} response - API response
- * @returns {Object} Project object
- */
-export function extractProject(response) {
-  return response?.project || response;
-}
-
-/**
- * Extract builds from API response
- * @param {Object} response - API response
- * @returns {Array} Array of builds
- */
-export function extractBuilds(response) {
-  return response?.builds || [];
-}
-
-/**
- * Extract token from API response
- * @param {Object} response - API response
- * @returns {Object} Token object
- */
-export function extractToken(response) {
-  return response?.token;
-}
-
-/**
- * Extract tokens from API response
- * @param {Object} response - API response
- * @returns {Array} Array of tokens
- */
-export function extractTokens(response) {
-  return response?.tokens || [];
-}
-
-/**
- * Enrich projects with organization info
- * @param {Array} projects - Array of projects
- * @param {Object} org - Organization object
- * @param {string} org.slug - Organization slug
- * @param {string} org.name - Organization name
- * @returns {Array} Projects with organization info added
- */
-export function enrichProjectsWithOrg(projects, org) {
-  return projects.map(project => ({
-    ...project,
-    organizationSlug: org.slug,
-    organizationName: org.name
-  }));
-}
-
-/**
- * Extract organizations from whoami response
- * @param {Object} whoamiResponse - Whoami API response
- * @returns {Array} Array of organizations
- */
-export function extractOrganizations(whoamiResponse) {
-  return whoamiResponse?.organizations || [];
-}
-
-// ============================================================================
-// Error Building
-// ============================================================================
-
-/**
- * Build error for project fetch failure
- * @param {Error} originalError - Original error
- * @returns {VizzlyError} Wrapped error
- */
-export function buildProjectFetchError(originalError) {
-  return new VizzlyError(`Failed to fetch project: ${originalError.message}`, 'PROJECT_FETCH_FAILED', {
-    originalError
-  });
-}
-
-/**
- * Build error for no authentication available
- * @returns {VizzlyError} No auth error
- */
-export function buildNoAuthError() {
-  return new VizzlyError('No authentication available', 'NO_AUTH_SERVICE');
-}
-
-/**
- * Build error for no API service available
- * @returns {VizzlyError} No API service error
- */
-export function buildNoApiServiceError() {
-  return new VizzlyError('API service not available', 'NO_API_SERVICE');
-}
-
-/**
- * Build error for token creation failure
- * @param {Error} originalError - Original error
- * @returns {VizzlyError} Wrapped error
- */
-export function buildTokenCreateError(originalError) {
-  return new VizzlyError(`Failed to create project token: ${originalError.message}`, 'TOKEN_CREATE_FAILED', {
-    originalError
-  });
-}
-
-/**
- * Build error for token fetch failure
- * @param {Error} originalError - Original error
- * @returns {VizzlyError} Wrapped error
- */
-export function buildTokensFetchError(originalError) {
-  return new VizzlyError(`Failed to fetch project tokens: ${originalError.message}`, 'TOKENS_FETCH_FAILED', {
-    originalError
-  });
-}
-
-/**
- * Build error for token revoke failure
- * @param {Error} originalError - Original error
- * @returns {VizzlyError} Wrapped error
- */
-export function buildTokenRevokeError(originalError) {
-  return new VizzlyError(`Failed to revoke project token: ${originalError.message}`, 'TOKEN_REVOKE_FAILED', {
-    originalError
-  });
-}

package/dist/screenshot-server/core.js

@@ -1,161 +0,0 @@
-/**
- * Screenshot Server Core - Pure functions for screenshot server logic
- *
- * No I/O, no side effects - just data transformations.
- */
-
-import { getScreenshotOptionsPayload } from '../utils/screenshot-options.js';
-
-// ============================================================================
-// Request Validation
-// ============================================================================
-
-/**
- * Validate screenshot request body
- * @param {Object} body - Request body
- * @returns {{ valid: boolean, error: string|null }}
- */
-export function validateScreenshotRequest(body) {
-  if (!body?.name || !body?.image) {
-    return {
-      valid: false,
-      error: 'name and image are required'
-    };
-  }
-  return {
-    valid: true,
-    error: null
-  };
-}
-
-/**
- * Check if request is for the screenshot endpoint
- * @param {string} method - HTTP method
- * @param {string} url - Request URL
- * @returns {boolean}
- */
-export function isScreenshotEndpoint(method, url) {
-  return method === 'POST' && url === '/screenshot';
-}
-
-// ============================================================================
-// Build ID Handling
-// ============================================================================
-
-/**
- * Get effective build ID (falls back to 'default')
- * @param {string|null|undefined} buildId - Build ID from request
- * @returns {string}
- */
-export function getEffectiveBuildId(buildId) {
-  return buildId || 'default';
-}
-
-// ============================================================================
-// Response Building
-// ============================================================================
-
-/**
- * Build success response object
- * @returns {{ status: number, body: Object }}
- */
-export function buildSuccessResponse() {
-  return {
-    status: 200,
-    body: {
-      success: true
-    }
-  };
-}
-
-/**
- * Build error response object
- * @param {number} status - HTTP status code
- * @param {string} message - Error message
- * @returns {{ status: number, body: Object }}
- */
-export function buildErrorResponse(status, message) {
-  return {
-    status,
-    body: {
-      error: message
-    }
-  };
-}
-
-/**
- * Build not found response
- * @returns {{ status: number, body: Object }}
- */
-export function buildNotFoundResponse() {
-  return buildErrorResponse(404, 'Not found');
-}
-
-/**
- * Build bad request response
- * @param {string} message - Error message
- * @returns {{ status: number, body: Object }}
- */
-export function buildBadRequestResponse(message) {
-  return buildErrorResponse(400, message);
-}
-
-/**
- * Build internal error response
- * @returns {{ status: number, body: Object }}
- */
-export function buildInternalErrorResponse() {
-  return buildErrorResponse(500, 'Internal server error');
-}
-
-// ============================================================================
-// Server Configuration
-// ============================================================================
-
-/**
- * Build server listen options
- * @param {Object} config - Server configuration
- * @returns {{ port: number, host: string }}
- */
-export function buildServerListenOptions(config) {
-  return {
-    port: config?.server?.port || 3000,
-    host: '127.0.0.1'
-  };
-}
-
-/**
- * Build server started message
- * @param {number} port - Server port
- * @returns {string}
- */
-export function buildServerStartedMessage(port) {
-  return `Screenshot server listening on http://127.0.0.1:${port}`;
-}
-
-/**
- * Build server stopped message
- * @returns {string}
- */
-export function buildServerStoppedMessage() {
-  return 'Screenshot server stopped';
-}
-
-// ============================================================================
-// Screenshot Data Extraction
-// ============================================================================
-
-/**
- * Extract screenshot data from request body
- * @param {Object} body - Request body
- * @returns {{ name: string, image: string, properties?: Object }}
- */
-export function extractScreenshotData(body) {
-  let screenshotData = {
-    name: body.name,
-    image: body.image,
-    properties: body.properties
-  };
-  Object.assign(screenshotData, getScreenshotOptionsPayload(body));
-  return screenshotData;
-}

package/dist/screenshot-server/index.js

@@ -1,11 +0,0 @@
-/**
- * Screenshot Server Module
- *
- * Exports pure functions (core) and I/O operations for screenshot server functionality.
- */
-
-// Core - pure functions
-export { buildBadRequestResponse, buildErrorResponse, buildInternalErrorResponse, buildNotFoundResponse, buildServerListenOptions, buildServerStartedMessage, buildServerStoppedMessage, buildSuccessResponse, extractScreenshotData, getEffectiveBuildId, isScreenshotEndpoint, validateScreenshotRequest } from './core.js';
-
-// Operations - I/O with dependency injection
-export { handleRequest, parseRequestBody, startServer, stopServer } from './operations.js';