@vizzly-testing/cli 0.27.0 → 0.28.0

package/dist/api/endpoints.js

@@ -223,6 +223,7 @@ export async function searchComparisons(client, name, filters = {}) {
   }
   let {
     branch,
+    project,
     limit = 50,
     offset = 0
   } = filters;
@@ -232,6 +233,7 @@ export async function searchComparisons(client, name, filters = {}) {
     offset: String(offset)
   };
   if (branch) params.branch = branch;
+  if (project) params.project = project;
   let endpoint = buildEndpointWithParams('/api/sdk/comparisons/search', params);
   return client.request(endpoint);
 }

package/dist/cli.js

@@ -13,7 +13,6 @@ import { loginCommand, validateLoginOptions } from './commands/login.js';
 import { logoutCommand, validateLogoutOptions } from './commands/logout.js';
 import { orgsCommand, validateOrgsOptions } from './commands/orgs.js';
 import { previewCommand, validatePreviewOptions } from './commands/preview.js';
-import { projectListCommand, projectRemoveCommand, projectSelectCommand, projectTokenCommand, validateProjectOptions } from './commands/project.js';
 import { projectsCommand, validateProjectsOptions } from './commands/projects.js';
 import { approveCommand, commentCommand, rejectCommand, validateApproveOptions, validateCommentOptions, validateRejectOptions } from './commands/review.js';
 import { runCommand, validateRunOptions } from './commands/run.js';
@@ -93,11 +92,6 @@ const formatHelp = (cmd, helper) => {
         icon: '▸',
         title: 'Account',
         names: ['login', 'logout', 'whoami', 'orgs', 'projects']
-      }, {
-        key: 'project',
-        icon: '▸',
-        title: 'Projects',
-        names: ['project:select', 'project:list', 'project:token', 'project:remove']
       }];
       let grouped = {
         core: [],
@@ -105,7 +99,6 @@ const formatHelp = (cmd, helper) => {
         setup: [],
         advanced: [],
         auth: [],
-        project: [],
         other: []
       };
       for (let command of commands) {
@@ -439,10 +432,11 @@ program.command('status').description('Check the status of a build').argument('<
   }
   await statusCommand(buildId, options, globalOptions);
 });
-program.command('builds').description('List and query builds').option('-b, --build <id>', 'Get a specific build by ID').option('--branch <branch>', 'Filter by branch').option('--status <status>', 'Filter by status (created, pending, processing, completed, failed)').option('--environment <env>', 'Filter by environment').option('--limit <n>', 'Maximum results to return (1-250)', val => parseInt(val, 10), 20).option('--offset <n>', 'Skip first N results', val => parseInt(val, 10), 0).option('--comparisons', 'Include comparisons when fetching a specific build').addHelpText('after', `
+program.command('builds').description('List and query builds').option('-b, --build <id>', 'Get a specific build by ID').option('--branch <branch>', 'Filter by branch').option('--status <status>', 'Filter by status (created, pending, processing, completed, failed)').option('--environment <env>', 'Filter by environment').option('-p, --project <slug>', 'Filter by project slug').option('--limit <n>', 'Maximum results to return (1-250)', val => parseInt(val, 10), 20).option('--offset <n>', 'Skip first N results', val => parseInt(val, 10), 0).option('--comparisons', 'Include comparisons when fetching a specific build').addHelpText('after', `
 Examples:
   $ vizzly builds                          # List recent builds
   $ vizzly builds --branch main            # Filter by branch
+  $ vizzly builds --project abc123         # Filter by project
   $ vizzly builds --status completed       # Filter by status
   $ vizzly builds -b abc123-def456         # Get specific build by ID
   $ vizzly builds -b abc123 --comparisons  # Include comparisons
@@ -461,7 +455,7 @@ Examples:
   }
   await buildsCommand(options, globalOptions);
 });
-program.command('comparisons').description('Query and search comparisons').option('-b, --build <id>', 'Get comparisons for a specific build').option('--id <id>', 'Get a specific comparison by ID').option('--name <pattern>', 'Search comparisons by name (supports wildcards)').option('--status <status>', 'Filter by status (identical, new, changed)').option('--branch <branch>', 'Filter by branch (for name search)').option('--limit <n>', 'Maximum results to return (1-250)', val => parseInt(val, 10), 50).option('--offset <n>', 'Skip first N results', val => parseInt(val, 10), 0).addHelpText('after', `
+program.command('comparisons').description('Query and search comparisons').option('-b, --build <id>', 'Get comparisons for a specific build').option('--id <id>', 'Get a specific comparison by ID').option('--name <pattern>', 'Search comparisons by name (supports wildcards)').option('--status <status>', 'Filter by status (identical, new, changed)').option('--branch <branch>', 'Filter by branch (for name search)').option('--limit <n>', 'Maximum results to return (1-250)', val => parseInt(val, 10), 50).option('--offset <n>', 'Skip first N results', val => parseInt(val, 10), 0).option('-p, --project <slug>', 'Filter by project slug').addHelpText('after', `
 Examples:
   $ vizzly comparisons -b abc123           # List comparisons for a build
   $ vizzly comparisons --id def456         # Get specific comparison by ID
@@ -747,32 +741,6 @@ program.command('whoami').description('Show current authentication status and us
   }
   await whoamiCommand(options, globalOptions);
 });
-program.command('project:select').description('Configure project for current directory').option('--api-url <url>', 'API URL override').action(async options => {
-  const globalOptions = program.opts();
-
-  // Validate options
-  const validationErrors = validateProjectOptions(options);
-  if (validationErrors.length > 0) {
-    output.error('Validation errors:');
-    for (let error of validationErrors) {
-      output.printErr(`  - ${error}`);
-    }
-    process.exit(1);
-  }
-  await projectSelectCommand(options, globalOptions);
-});
-program.command('project:list').description('Show all configured projects').action(async options => {
-  const globalOptions = program.opts();
-  await projectListCommand(options, globalOptions);
-});
-program.command('project:token').description('Show project token for current directory').action(async options => {
-  const globalOptions = program.opts();
-  await projectTokenCommand(options, globalOptions);
-});
-program.command('project:remove').description('Remove project configuration for current directory').action(async options => {
-  const globalOptions = program.opts();
-  await projectRemoveCommand(options, globalOptions);
-});
 
 // Save user's PATH for menubar app (non-blocking, runs in background)
 // This auto-configures the menubar app so it can find npx/node

package/dist/commands/builds.js

@@ -74,6 +74,7 @@ export async function buildsCommand(options = {}, globalOptions = {}, deps = {})
     if (options.branch) filters.branch = options.branch;
     if (options.status) filters.status = options.status;
     if (options.environment) filters.environment = options.environment;
+    if (options.project) filters.project = options.project;
     let response = await getBuilds(client, filters);
     output.stopSpinner();
     let builds = response.builds || [];

package/dist/commands/comparisons.js

@@ -108,6 +108,7 @@ export async function comparisonsCommand(options = {}, globalOptions = {}, deps
       output.startSpinner('Searching comparisons...');
       let filters = {
         branch: options.branch,
+        project: options.project,
         limit: options.limit || 50,
         offset: options.offset || 0
       };

package/dist/commands/config-cmd.js

@@ -2,9 +2,7 @@
  * Config command - query and display configuration
  */
 
-import { resolve } from 'node:path';
 import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
-import { getProjectMapping as defaultGetProjectMapping } from '../utils/global-config.js';
 import * as defaultOutput from '../utils/output.js';
 
 /**
@@ -17,7 +15,6 @@ import * as defaultOutput from '../utils/output.js';
 export async function configCommand(key = null, options = {}, globalOptions = {}, deps = {}) {
   let {
     loadConfig = defaultLoadConfig,
-    getProjectMapping = defaultGetProjectMapping,
     output = defaultOutput,
     exit = code => process.exit(code)
   } = deps;
@@ -34,10 +31,6 @@ export async function configCommand(key = null, options = {}, globalOptions = {}
     });
     let configFile = config._configPath || null;
 
-    // Get project mapping if available
-    let currentDir = resolve(process.cwd());
-    let projectMapping = await getProjectMapping(currentDir);
-
     // Build the config object to display
     let displayConfig = {
       server: config.server || {
@@ -90,12 +83,7 @@ export async function configCommand(key = null, options = {}, globalOptions = {}
     if (globalOptions.json) {
       output.data({
         configFile,
-        config: displayConfig,
-        project: projectMapping ? {
-          name: projectMapping.projectName,
-          slug: projectMapping.projectSlug,
-          organization: projectMapping.organizationSlug
-        } : null
+        config: displayConfig
       });
       output.cleanup();
       return;
@@ -112,13 +100,6 @@ export async function configCommand(key = null, options = {}, globalOptions = {}
     }
     output.blank();
 
-    // Project context if available
-    if (projectMapping) {
-      output.labelValue('Project', `${projectMapping.projectName} (${projectMapping.projectSlug})`);
-      output.labelValue('Organization', projectMapping.organizationSlug);
-      output.blank();
-    }
-
     // Display configuration sections
     displaySection(output, 'Server', displayConfig.server);
     displaySection(output, 'Comparison', displayConfig.comparison);

package/dist/commands/orgs.js

@@ -2,17 +2,27 @@
  * Organizations command - List organizations the user has access to
  */
 
-import { createApiClient } from '../api/client.js';
-import { loadConfig } from '../utils/config-loader.js';
-import { getApiUrl } from '../utils/environment-config.js';
-import * as output from '../utils/output.js';
+import { createApiClient as defaultCreateApiClient } from '../api/client.js';
+import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
+import { getApiUrl as defaultGetApiUrl } from '../utils/environment-config.js';
+import { getAccessToken as defaultGetAccessToken } from '../utils/global-config.js';
+import * as defaultOutput from '../utils/output.js';
 
 /**
  * Organizations command implementation
  * @param {Object} options - Command options
  * @param {Object} globalOptions - Global CLI options
+ * @param {Object} deps - Dependencies for testing
  */
-export async function orgsCommand(_options = {}, globalOptions = {}) {
+export async function orgsCommand(_options = {}, globalOptions = {}, deps = {}) {
+  let {
+    loadConfig = defaultLoadConfig,
+    createApiClient = defaultCreateApiClient,
+    getApiUrl = defaultGetApiUrl,
+    getAccessToken = defaultGetAccessToken,
+    output = defaultOutput,
+    exit = code => process.exit(code)
+  } = deps;
   output.configure({
     json: globalOptions.json,
     verbose: globalOptions.verbose,
@@ -20,14 +30,19 @@ export async function orgsCommand(_options = {}, globalOptions = {}) {
   });
   try {
     let config = await loadConfig(globalOptions.config, globalOptions);
-    if (!config.apiKey) {
+
+    // Prefer user auth token for listing orgs (project tokens are org-scoped).
+    // Falls back to config.apiKey which may be: VIZZLY_TOKEN, --token flag, or project token.
+    let token = (await getAccessToken()) || config.apiKey;
+    if (!token) {
       output.error('API token required. Use --token, set VIZZLY_TOKEN, or run "vizzly login"');
       output.cleanup();
-      process.exit(1);
+      exit(1);
+      return;
     }
     let client = createApiClient({
       baseUrl: config.apiUrl || getApiUrl(),
-      token: config.apiKey
+      token
     });
     output.startSpinner('Fetching organizations...');
     let response = await client.request('/api/sdk/organizations');
@@ -65,7 +80,7 @@ export async function orgsCommand(_options = {}, globalOptions = {}) {
     output.stopSpinner();
     output.error('Failed to fetch organizations', error);
     output.cleanup();
-    process.exit(1);
+    exit(1);
   }
 }
 

package/dist/commands/projects.js

@@ -2,17 +2,27 @@
  * Projects command - List projects the user has access to
  */
 
-import { createApiClient } from '../api/client.js';
-import { loadConfig } from '../utils/config-loader.js';
-import { getApiUrl } from '../utils/environment-config.js';
-import * as output from '../utils/output.js';
+import { createApiClient as defaultCreateApiClient } from '../api/client.js';
+import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
+import { getApiUrl as defaultGetApiUrl } from '../utils/environment-config.js';
+import { getAccessToken as defaultGetAccessToken } from '../utils/global-config.js';
+import * as defaultOutput from '../utils/output.js';
 
 /**
  * Projects command implementation
  * @param {Object} options - Command options
  * @param {Object} globalOptions - Global CLI options
+ * @param {Object} deps - Dependencies for testing
  */
-export async function projectsCommand(options = {}, globalOptions = {}) {
+export async function projectsCommand(options = {}, globalOptions = {}, deps = {}) {
+  let {
+    loadConfig = defaultLoadConfig,
+    createApiClient = defaultCreateApiClient,
+    getApiUrl = defaultGetApiUrl,
+    getAccessToken = defaultGetAccessToken,
+    output = defaultOutput,
+    exit = code => process.exit(code)
+  } = deps;
   output.configure({
     json: globalOptions.json,
     verbose: globalOptions.verbose,
@@ -20,14 +30,19 @@ export async function projectsCommand(options = {}, globalOptions = {}) {
   });
   try {
     let config = await loadConfig(globalOptions.config, globalOptions);
-    if (!config.apiKey) {
+
+    // Prefer user auth token for listing projects (project tokens are org-scoped).
+    // Falls back to config.apiKey which may be: VIZZLY_TOKEN, --token flag, or project token.
+    let token = (await getAccessToken()) || config.apiKey;
+    if (!token) {
       output.error('API token required. Use --token, set VIZZLY_TOKEN, or run "vizzly login"');
       output.cleanup();
-      process.exit(1);
+      exit(1);
+      return;
     }
     let client = createApiClient({
       baseUrl: config.apiUrl || getApiUrl(),
-      token: config.apiKey
+      token
     });
 
     // Build query params
@@ -82,7 +97,7 @@ export async function projectsCommand(options = {}, globalOptions = {}) {
     output.stopSpinner();
     output.error('Failed to fetch projects', error);
     output.cleanup();
-    process.exit(1);
+    exit(1);
   }
 }
 

package/dist/project/core.js

@@ -6,90 +6,6 @@
 
 import { VizzlyError } from '../errors/vizzly-error.js';
 
-// ============================================================================
-// Validation
-// ============================================================================
-
-/**
- * Validate that a directory path is provided
- * @param {string} directory - Directory path to validate
- * @returns {{ valid: boolean, error: Error|null }}
- */
-export function validateDirectory(directory) {
-  if (!directory) {
-    return {
-      valid: false,
-      error: new VizzlyError('Directory path is required', 'INVALID_DIRECTORY')
-    };
-  }
-  return {
-    valid: true,
-    error: null
-  };
-}
-
-/**
- * Validate project data for mapping creation
- * @param {Object} projectData - Project data to validate
- * @param {string} [projectData.projectSlug] - Project slug
- * @param {string} [projectData.organizationSlug] - Organization slug
- * @param {string} [projectData.token] - Project token
- * @returns {{ valid: boolean, error: Error|null }}
- */
-export function validateProjectData(projectData) {
-  if (!projectData.projectSlug) {
-    return {
-      valid: false,
-      error: new VizzlyError('Project slug is required', 'INVALID_PROJECT_DATA')
-    };
-  }
-  if (!projectData.organizationSlug) {
-    return {
-      valid: false,
-      error: new VizzlyError('Organization slug is required', 'INVALID_PROJECT_DATA')
-    };
-  }
-  if (!projectData.token) {
-    return {
-      valid: false,
-      error: new VizzlyError('Project token is required', 'INVALID_PROJECT_DATA')
-    };
-  }
-  return {
-    valid: true,
-    error: null
-  };
-}
-
-// ============================================================================
-// Mapping Transformations
-// ============================================================================
-
-/**
- * Convert mappings object to array with directory paths included
- * @param {Object} mappings - Object with directory paths as keys
- * @returns {Array<Object>} Array of mappings with directory property
- */
-export function mappingsToArray(mappings) {
-  return Object.entries(mappings).map(([directory, data]) => ({
-    directory,
-    ...data
-  }));
-}
-
-/**
- * Build a mapping result object
- * @param {string} directory - Directory path
- * @param {Object} projectData - Project data
- * @returns {Object} Mapping result with directory included
- */
-export function buildMappingResult(directory, projectData) {
-  return {
-    directory,
-    ...projectData
-  };
-}
-
 // ============================================================================
 // API Request Helpers
 // ============================================================================

package/dist/project/operations.js

@@ -2,88 +2,12 @@
  * Project Operations - Project operations with dependency injection
  *
  * Each operation takes its dependencies as parameters:
- * - mappingStore: for reading/writing project mappings
  * - httpClient: for making API requests (OAuth or API token based)
  *
  * This makes them trivially testable without mocking modules.
  */
 
-import { buildBuildsUrl, buildMappingResult, buildNoApiServiceError, buildNoAuthError, buildOrgHeader, buildProjectFetchError, buildProjectUrl, buildTokenCreateError, buildTokenRevokeError, buildTokensFetchError, buildTokensUrl, enrichProjectsWithOrg, extractBuilds, extractOrganizations, extractProject, extractProjects, extractToken, extractTokens, mappingsToArray, validateDirectory, validateProjectData } from './core.js';
-
-// ============================================================================
-// Mapping Operations
-// ============================================================================
-
-/**
- * List all project mappings
- * @param {Object} mappingStore - Store with getMappings method
- * @returns {Promise<Array>} Array of project mappings with directory included
- */
-export async function listMappings(mappingStore) {
-  let mappings = await mappingStore.getMappings();
-  return mappingsToArray(mappings);
-}
-
-/**
- * Get project mapping for a specific directory
- * @param {Object} mappingStore - Store with getMapping method
- * @param {string} directory - Directory path
- * @returns {Promise<Object|null>} Project mapping or null
- */
-export async function getMapping(mappingStore, directory) {
-  return mappingStore.getMapping(directory);
-}
-
-/**
- * Create or update project mapping
- * @param {Object} mappingStore - Store with saveMapping method
- * @param {string} directory - Directory path
- * @param {Object} projectData - Project data
- * @returns {Promise<Object>} Created mapping with directory included
- */
-export async function createMapping(mappingStore, directory, projectData) {
-  let dirValidation = validateDirectory(directory);
-  if (!dirValidation.valid) {
-    throw dirValidation.error;
-  }
-  let dataValidation = validateProjectData(projectData);
-  if (!dataValidation.valid) {
-    throw dataValidation.error;
-  }
-  await mappingStore.saveMapping(directory, projectData);
-  return buildMappingResult(directory, projectData);
-}
-
-/**
- * Remove project mapping
- * @param {Object} mappingStore - Store with deleteMapping method
- * @param {string} directory - Directory path
- * @returns {Promise<void>}
- */
-export async function removeMapping(mappingStore, directory) {
-  let validation = validateDirectory(directory);
-  if (!validation.valid) {
-    throw validation.error;
-  }
-  await mappingStore.deleteMapping(directory);
-}
-
-/**
- * Switch project for a directory (convenience wrapper for createMapping)
- * @param {Object} mappingStore - Store with saveMapping method
- * @param {string} directory - Directory path
- * @param {string} projectSlug - Project slug
- * @param {string} organizationSlug - Organization slug
- * @param {string} token - Project token
- * @returns {Promise<Object>} Updated mapping
- */
-export async function switchProject(mappingStore, directory, projectSlug, organizationSlug, token) {
-  return createMapping(mappingStore, directory, {
-    projectSlug,
-    organizationSlug,
-    token
-  });
-}
+import { buildBuildsUrl, buildNoApiServiceError, buildNoAuthError, buildOrgHeader, buildProjectFetchError, buildProjectUrl, buildTokenCreateError, buildTokenRevokeError, buildTokensFetchError, buildTokensUrl, enrichProjectsWithOrg, extractBuilds, extractOrganizations, extractProject, extractProjects, extractToken, extractTokens } from './core.js';
 
 // ============================================================================
 // API Operations - List Projects