@vizzly-testing/cli 0.39.1 → 0.39.2

package/dist/api/endpoints.js

@@ -1,421 +0,0 @@
-/**
- * API Endpoints - Functions for each API operation
- *
- * Each function takes a client as the first parameter and returns the API result.
- * This keeps the functions pure (no hidden state) and easily testable.
- */
-
-import { VizzlyError } from '../errors/vizzly-error.js';
-import * as output from '../utils/output.js';
-import { buildBuildPayload, buildEndpointWithParams, buildQueryParams, buildScreenshotPayload, buildScreenshotResolvePayload, buildShaCheckPayload, computeSha256 } from './core.js';
-
-// ============================================================================
-// Build Endpoints
-// ============================================================================
-
-/**
- * Get build information
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {string|null} include - Optional include parameter (e.g., 'screenshots')
- * @returns {Promise<Object>} Build data
- */
-export async function getBuild(client, buildId, include = null) {
-  let endpoint = `/api/sdk/builds/${buildId}`;
-  if (include) {
-    endpoint = buildEndpointWithParams(endpoint, {
-      include
-    });
-  }
-  return client.request(endpoint);
-}
-
-/**
- * Get the server-owned build processing and review status.
- *
- * This endpoint keeps processing, comparison, and review counts separate so
- * callers do not have to reconstruct lifecycle state from legacy build fields.
- *
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @returns {Promise<Object>} Build status response
- */
-export async function getBuildStatus(client, buildId) {
-  return client.request(`/api/sdk/builds/${buildId}/status`);
-}
-
-/**
- * Get builds for a project
- * @param {Object} client - API client
- * @param {Object} filters - Filter options
- * @returns {Promise<Array>} List of builds
- */
-export async function getBuilds(client, filters = {}) {
-  let query = buildQueryParams(filters);
-  let endpoint = `/api/sdk/builds${query ? `?${query}` : ''}`;
-  return client.request(endpoint);
-}
-
-/**
- * Create a new build
- * @param {Object} client - API client
- * @param {Object} metadata - Build metadata
- * @returns {Promise<Object>} Created build data
- */
-export async function createBuild(client, metadata) {
-  let payload = buildBuildPayload(metadata);
-  return client.request('/api/sdk/builds', {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify({
-      build: payload
-    })
-  });
-}
-
-/**
- * Update build status
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {string} status - Build status (pending|running|completed|failed)
- * @param {number|null} [executionTimeMs=null] - Execution time in milliseconds
- * @param {string} [failureReason] - Explanation sent only for a failed build
- * @returns {Promise<Object>} Updated build data
- */
-export async function updateBuildStatus(client, buildId, status, executionTimeMs = null, failureReason) {
-  let body = {
-    status
-  };
-  if (status === 'failed' && failureReason) body.failureReason = failureReason;
-  if (executionTimeMs != null) {
-    body.executionTimeMs = executionTimeMs;
-  }
-  return client.request(`/api/sdk/builds/${buildId}/status`, {
-    method: 'PUT',
-    headers: {
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify(body)
-  });
-}
-
-/**
- * Mark a build completed or failed, with an optional failure explanation.
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {boolean} [success=true] - Whether tests and uploads succeeded
- * @param {number|null} [executionTimeMs=null] - Execution time in milliseconds
- * @param {string} [failureReason] - Explanation sent only for a failed build
- * @returns {Promise<Object>} Finalized build data
- */
-export async function finalizeBuild(client, buildId, success = true, executionTimeMs = null, failureReason) {
-  let status = success ? 'completed' : 'failed';
-  return updateBuildStatus(client, buildId, status, executionTimeMs, failureReason);
-}
-
-/**
- * Get TDD baselines for a build
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @returns {Promise<Object>} { build, screenshots, signatureProperties }
- */
-export async function getTddBaselines(client, buildId) {
-  return client.request(`/api/sdk/builds/${buildId}/tdd-baselines`);
-}
-
-// ============================================================================
-// Screenshot Endpoints
-// ============================================================================
-
-/**
- * Check if SHAs already exist on the server
- * @param {Object} client - API client
- * @param {Array} screenshots - Screenshots to check (objects with sha256, or string SHAs)
- * @param {string} buildId - Build ID for screenshot record creation
- * @returns {Promise<Object>} { existing, missing, screenshots }
- */
-export async function checkShas(client, screenshots, buildId) {
-  try {
-    let payload = buildShaCheckPayload(screenshots, buildId);
-    return await client.request('/api/sdk/check-shas', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(payload)
-    });
-  } catch (error) {
-    // Continue without deduplication on error
-    output.debug('sha-check', 'failed, continuing without deduplication', {
-      error: error.message
-    });
-
-    // Extract SHAs for fallback response
-    let shaList = Array.isArray(screenshots) && screenshots.length > 0 && typeof screenshots[0] === 'object' ? screenshots.map(s => s.sha256) : screenshots;
-    return {
-      existing: [],
-      missing: shaList,
-      screenshots: []
-    };
-  }
-}
-function canUploadBytesAfterShaResolveError(error) {
-  let status = error?.context?.status;
-
-  // Network failures, older servers, and server errors should degrade to the
-  // slower byte upload path. Auth and ownership errors must still surface.
-  if (!status) return true;
-  if (status >= 500) return true;
-  if (status === 400 && error.message?.includes('image_data')) return true;
-  return false;
-}
-
-/**
- * Upload a screenshot with SHA deduplication
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {string} name - Screenshot name
- * @param {Buffer} buffer - Screenshot data
- * @param {Object} metadata - Additional metadata
- * @param {boolean} skipDedup - Skip SHA deduplication (uploadAll mode)
- * @returns {Promise<Object>} Upload result
- */
-export async function uploadScreenshot(client, buildId, name, buffer, metadata = {}, skipDedup = false, screenshotOptions = {}) {
-  // Skip SHA deduplication if requested
-  if (skipDedup) {
-    let payload = buildScreenshotPayload(name, buffer, metadata, null, screenshotOptions);
-    return client.request(`/api/sdk/builds/${buildId}/screenshots`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(payload)
-    });
-  }
-
-  // Normal flow with server-side SHA resolution.
-  let sha256 = computeSha256(buffer);
-  let resolvePayload = buildScreenshotResolvePayload(name, metadata, sha256, screenshotOptions);
-  try {
-    let resolveResult = await client.request(`/api/sdk/builds/${buildId}/screenshots`, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json'
-      },
-      body: JSON.stringify(resolvePayload)
-    });
-    if (resolveResult?.upload_required === false) {
-      return {
-        message: 'Screenshot already exists, skipped upload',
-        sha256,
-        skipped: true,
-        screenshot: resolveResult,
-        fromExisting: true
-      };
-    }
-  } catch (error) {
-    if (!canUploadBytesAfterShaResolveError(error)) {
-      throw error;
-    }
-    output.debug('sha-resolve', 'failed, uploading screenshot bytes', {
-      error: error.message
-    });
-  }
-
-  // File doesn't exist, or resolve failed; proceed with upload.
-  let payload = buildScreenshotPayload(name, buffer, metadata, sha256, screenshotOptions);
-  return client.request(`/api/sdk/builds/${buildId}/screenshots`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    },
-    body: JSON.stringify(payload)
-  });
-}
-
-// ============================================================================
-// Comparison Endpoints
-// ============================================================================
-
-/**
- * Get comparison information
- * @param {Object} client - API client
- * @param {string} comparisonId - Comparison ID
- * @returns {Promise<Object>} Comparison data
- */
-export async function getComparison(client, comparisonId) {
-  let response = await client.request(`/api/sdk/comparisons/${comparisonId}`);
-  return response.comparison;
-}
-
-/**
- * Get a build context bundle at the detail level the caller can consume.
- *
- * Passing detail selection to the API keeps compact callers from downloading
- * raw Honeydiff geometry by default while preserving the unfiltered endpoint
- * for raw and full context consumers.
- *
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {Object} options - Optional query params
- * @returns {Promise<Object>} Build context bundle
- */
-export async function getBuildContext(client, buildId, options = {}) {
-  let endpoint = buildEndpointWithParams(`/api/sdk/context/builds/${buildId}`, options);
-  return client.request(endpoint);
-}
-
-/**
- * Get comparison context bundle with similarity and history
- * @param {Object} client - API client
- * @param {string} comparisonId - Comparison ID
- * @param {Object} options - Optional query params
- * @returns {Promise<Object>} Comparison context bundle
- */
-export async function getComparisonContext(client, comparisonId, options = {}) {
-  let endpoint = buildEndpointWithParams(`/api/sdk/context/comparisons/${comparisonId}`, options);
-  return client.request(endpoint);
-}
-
-/**
- * Get screenshot context bundle for a screenshot name
- * @param {Object} client - API client
- * @param {string} screenshotName - Screenshot name
- * @param {Object} options - Optional query params
- * @returns {Promise<Object>} Screenshot context bundle
- */
-export async function getScreenshotContext(client, screenshotName, options = {}) {
-  let encodedName = encodeURIComponent(screenshotName);
-  let endpoint = buildEndpointWithParams(`/api/sdk/context/screenshots/${encodedName}`, options);
-  return client.request(endpoint);
-}
-
-/**
- * Get project-scoped similar comparisons for a fingerprint hash
- * @param {Object} client - API client
- * @param {string} fingerprintHash - Honeydiff fingerprint hash
- * @param {Object} options - Optional query params
- * @returns {Promise<Object>} Fingerprint context bundle
- */
-export async function getSimilarFingerprintContext(client, fingerprintHash, options = {}) {
-  let encodedFingerprint = encodeURIComponent(fingerprintHash);
-  let endpoint = buildEndpointWithParams(`/api/sdk/context/fingerprints/${encodedFingerprint}/similar`, options);
-  return client.request(endpoint);
-}
-
-/**
- * Get pending review queue context for a project
- * @param {Object} client - API client
- * @param {Object} options - Optional query params
- * @returns {Promise<Object>} Review queue context bundle
- */
-export async function getReviewQueueContext(client, options = {}) {
-  let endpoint = buildEndpointWithParams('/api/sdk/context/review-queue', options);
-  return client.request(endpoint);
-}
-
-/**
- * Search for comparisons by name
- * @param {Object} client - API client
- * @param {string} name - Screenshot name to search for
- * @param {Object} filters - Optional filters (branch, project, organization, limit, offset)
- * @returns {Promise<Object>} Search results with comparisons and pagination
- */
-export async function searchComparisons(client, name, filters = {}) {
-  if (!name || typeof name !== 'string') {
-    throw new VizzlyError('name is required and must be a non-empty string');
-  }
-  let {
-    branch,
-    project,
-    organization,
-    limit = 50,
-    offset = 0
-  } = filters;
-  let params = {
-    name,
-    limit: String(limit),
-    offset: String(offset)
-  };
-  if (branch) params.branch = branch;
-  if (project) params.project = project;
-  if (organization) params.organization = organization;
-  let endpoint = buildEndpointWithParams('/api/sdk/comparisons/search', params);
-  return client.request(endpoint);
-}
-
-// ============================================================================
-// Auth/Token Endpoints
-// ============================================================================
-
-/**
- * Get token context (organization and project info)
- * @param {Object} client - API client
- * @returns {Promise<Object>} Token context data
- */
-export async function getTokenContext(client) {
-  return client.request('/api/sdk/token/context');
-}
-
-// ============================================================================
-// Parallel Build Endpoints
-// ============================================================================
-
-/**
- * Finalize a parallel build
- * @param {Object} client - API client
- * @param {string} parallelId - Parallel ID to finalize
- * @returns {Promise<Object>} Finalization result
- */
-export async function finalizeParallelBuild(client, parallelId) {
-  return client.request(`/api/sdk/parallel/${parallelId}/finalize`, {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json'
-    }
-  });
-}
-
-// ============================================================================
-// Preview Endpoints
-// ============================================================================
-
-/**
- * Upload preview ZIP file for a build
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @param {Buffer} zipBuffer - ZIP file contents
- * @returns {Promise<Object>} Upload result with preview URL
- */
-export async function uploadPreviewZip(client, buildId, zipBuffer) {
-  // Use native FormData (Node 18+) with Blob for proper fetch compatibility
-  let formData = new FormData();
-  let blob = new Blob([zipBuffer], {
-    type: 'application/zip'
-  });
-  formData.append('file', blob, 'preview.zip');
-  return client.request(`/api/sdk/builds/${buildId}/preview/upload-zip`, {
-    method: 'POST',
-    body: formData
-    // Let fetch set the Content-Type with boundary automatically
-  });
-}
-
-/**
- * Get preview info for a build
- * @param {Object} client - API client
- * @param {string} buildId - Build ID
- * @returns {Promise<Object>} Preview info or null if not found
- */
-export async function getPreviewInfo(client, buildId) {
-  try {
-    return await client.request(`/api/sdk/builds/${buildId}/preview`);
-  } catch (error) {
-    if (error.status === 404) {
-      return null;
-    }
-    throw error;
-  }
-}

package/dist/api/index.js

@@ -1,19 +0,0 @@
-/**
- * Vizzly API Module
- *
- * Functional API for interacting with the Vizzly platform.
- *
- * Usage:
- *   import { createApiClient, getBuild, createBuild } from '../api/index.js';
- *
- *   let client = createApiClient({ token: 'xxx', command: 'run' });
- *   let build = await getBuild(client, buildId);
- */
-
-// Client factory
-export { createApiClient, DEFAULT_API_URL } from './client.js';
-// Core pure functions
-export { buildApiUrl, buildAuthHeader, buildBuildPayload, buildEndpointWithParams, buildQueryParams, buildRequestHeaders, buildScreenshotCheckObject, buildScreenshotPayload, buildScreenshotResolvePayload, buildShaCheckPayload, buildUserAgent, computeSha256, extractErrorBody, findScreenshotBySha, isAuthError, isRateLimited, parseApiError, partitionByShaExistence, shaExists, shouldRetryWithRefresh } from './core.js';
-
-// Endpoint functions
-export { checkShas, createBuild, finalizeBuild, finalizeParallelBuild, getBuild, getBuildContext, getBuildStatus, getBuilds, getComparison, getComparisonContext, getPreviewInfo, getReviewQueueContext, getScreenshotContext, getSimilarFingerprintContext, getTddBaselines, getTokenContext, searchComparisons, updateBuildStatus, uploadPreviewZip, uploadScreenshot } from './endpoints.js';

package/dist/auth/core.js

@@ -1,237 +0,0 @@
-/**
- * Auth Core - Pure functions for authentication logic
- *
- * No I/O, no side effects - just data transformations.
- */
-
-import { AuthError, VizzlyError } from '../errors/vizzly-error.js';
-
-// ============================================================================
-// Header Building
-// ============================================================================
-
-/**
- * Build Authorization header from access token
- * @param {string|null} accessToken - Access token
- * @returns {Object} Headers object with Authorization if token exists
- */
-export function buildAuthHeader(accessToken) {
-  if (!accessToken) return {};
-  return {
-    Authorization: `Bearer ${accessToken}`
-  };
-}
-
-/**
- * Build User-Agent header for auth requests
- * @param {string} version - CLI version
- * @returns {string} User-Agent string
- */
-export function buildAuthUserAgent(version) {
-  return `vizzly-cli/${version} (auth)`;
-}
-
-/**
- * Build complete headers for a request
- * @param {Object} options - Header options
- * @returns {Object} Complete headers object
- */
-export function buildRequestHeaders({
-  userAgent,
-  accessToken,
-  contentType,
-  extra = {}
-}) {
-  return {
-    'User-Agent': userAgent,
-    ...(accessToken ? buildAuthHeader(accessToken) : {}),
-    ...(contentType ? {
-      'Content-Type': contentType
-    } : {}),
-    ...extra
-  };
-}
-
-// ============================================================================
-// Error Parsing
-// ============================================================================
-
-/**
- * Parse error from API response
- * @param {number} status - HTTP status code
- * @param {Object|string} body - Response body (parsed JSON or text)
- * @param {string} endpoint - API endpoint for context
- * @returns {Error} Appropriate error type
- */
-export function parseAuthError(status, body, _endpoint) {
-  let errorText = '';
-  if (typeof body === 'object' && body !== null) {
-    errorText = body.error || body.message || '';
-  } else if (typeof body === 'string') {
-    errorText = body;
-  }
-  let retryAfter = Number(body?.retryAfter);
-  let context = {
-    status,
-    serverCode: body?.code,
-    retryAfter: retryAfter > 0 ? retryAfter : undefined
-  };
-  if (status === 401) {
-    return new AuthError(errorText || 'Invalid credentials. Please check your email/username and password.', context);
-  }
-  if (status === 429) {
-    return new VizzlyError('Too many login attempts. Please try again later.', 'RATE_LIMIT_ERROR', context);
-  }
-  return new VizzlyError(`Authentication request failed: ${status}${errorText ? ` - ${errorText}` : ''}`, 'AUTH_REQUEST_ERROR', context);
-}
-
-/**
- * Parse error for authenticated requests (different error messages)
- * @param {number} status - HTTP status code
- * @param {Object|string} body - Response body
- * @param {string} endpoint - API endpoint
- * @returns {Error} Appropriate error type
- */
-export function parseAuthenticatedError(status, body, endpoint) {
-  let errorText = '';
-  if (typeof body === 'object' && body !== null) {
-    errorText = body.error || body.message || '';
-  } else if (typeof body === 'string') {
-    errorText = body;
-  }
-  if (status === 401) {
-    return new AuthError('Authentication token is invalid or expired. Please run "vizzly login" again.');
-  }
-  return new VizzlyError(`API request failed: ${status}${errorText ? ` - ${errorText}` : ''} (${endpoint})`, 'API_REQUEST_ERROR');
-}
-
-// ============================================================================
-// Payload Building
-// ============================================================================
-
-/**
- * Build device poll request payload
- * @param {string} deviceCode - Device code from initiate
- * @returns {Object} Request payload
- */
-export function buildDevicePollPayload(deviceCode) {
-  return {
-    device_code: deviceCode
-  };
-}
-
-/**
- * Build refresh token request payload
- * @param {string} refreshToken - Refresh token
- * @returns {Object} Request payload
- */
-export function buildRefreshPayload(refreshToken) {
-  return {
-    refreshToken
-  };
-}
-
-/**
- * Build logout request payload
- * @param {string} refreshToken - Refresh token to revoke
- * @returns {Object} Request payload
- */
-export function buildLogoutPayload(refreshToken) {
-  return {
-    refreshToken
-  };
-}
-
-// ============================================================================
-// Token Handling
-// ============================================================================
-
-/**
- * Build token data for storage from API response
- * @param {Object} response - API response with tokens
- * @param {Object|null} existingUser - Existing user data to preserve
- * @returns {Object} Token data for storage
- */
-export function buildTokenData(response, existingUser = null) {
-  return {
-    accessToken: response.accessToken,
-    refreshToken: response.refreshToken,
-    expiresAt: response.expiresAt,
-    user: response.user || existingUser
-  };
-}
-
-/**
- * Validate that tokens exist and have required fields
- * @param {Object|null} auth - Auth tokens object
- * @param {string} requiredField - Field that must exist ('accessToken' or 'refreshToken')
- * @returns {{ valid: boolean, error: Error|null }}
- */
-export function validateTokens(auth, requiredField = 'accessToken') {
-  if (!auth?.[requiredField]) {
-    let message = requiredField === 'refreshToken' ? 'No refresh token found. Please run "vizzly login" first.' : 'No authentication token found. Please run "vizzly login" first.';
-    return {
-      valid: false,
-      error: new AuthError(message)
-    };
-  }
-  return {
-    valid: true,
-    error: null
-  };
-}
-export function normalizeDeviceFlowResponse(deviceFlow) {
-  let verificationUri = deviceFlow.verification_uri || deviceFlow.verificationUri;
-  let userCode = deviceFlow.user_code || deviceFlow.userCode;
-  let deviceCode = deviceFlow.device_code || deviceFlow.deviceCode;
-  if (!verificationUri || !userCode || !deviceCode) {
-    throw new Error('Invalid device flow response from server');
-  }
-  return {
-    verificationUri,
-    userCode,
-    deviceCode,
-    urlWithCode: deviceFlow.verification_uri_complete || deviceFlow.verificationUriComplete || `${verificationUri}?code=${encodeURIComponent(userCode)}`
-  };
-}
-export function resolveAuthorizedTokenData(pollResponse) {
-  let accessToken = pollResponse.tokens?.accessToken || pollResponse.tokens?.access_token;
-  if (accessToken) {
-    return pollResponse;
-  }
-  if (pollResponse.status === 'pending') {
-    throw new Error('Authorization not complete yet. Please complete the authorization in your browser and try running "vizzly login" again.');
-  }
-  if (pollResponse.status === 'expired') {
-    throw new Error('Device code expired. Please try logging in again.');
-  }
-  if (pollResponse.status === 'invalid') {
-    throw new Error('Device code is invalid or expired. Please try logging in again.');
-  }
-  if (pollResponse.status === 'denied') {
-    throw new Error('Authorization denied. Please try logging in again.');
-  }
-  throw new Error('Unexpected response from authorization server. Please try logging in again.');
-}
-export function buildTokens(tokenData, now = Date.now()) {
-  let tokensData = tokenData.tokens || tokenData;
-  let tokenExpiresIn = tokensData.expiresIn || tokensData.expires_in;
-  let tokenExpiresAt = tokenExpiresIn ? new Date(now + tokenExpiresIn * 1000).toISOString() : tokenData.expires_at || tokenData.expiresAt;
-  return {
-    accessToken: tokensData.accessToken || tokensData.access_token,
-    refreshToken: tokensData.refreshToken || tokensData.refresh_token,
-    expiresAt: tokenExpiresAt,
-    user: tokenData.user,
-    organizations: tokenData.organizations
-  };
-}
-
-/** Map protocol codes without depending on the server's human-readable text. */
-export function deviceAuthorizationStatus(error) {
-  return {
-    AUTHORIZATION_PENDING: 'pending',
-    ACCESS_DENIED: 'denied',
-    EXPIRED_TOKEN: 'expired',
-    INVALID_DEVICE_CODE: 'invalid'
-  }[error.context?.serverCode];
-}