@vizzly-testing/cli 0.39.0 → 0.39.2

package/README.md

@@ -168,9 +168,9 @@ Install the Vizzly skill and a short `AGENTS.md` note:
 pnpm exec vizzly init --agent-guidance
 ```
 
-This adds `.agents/skills/vizzly` and a note in `AGENTS.md`, keeping other
-guidance. Use `--agent-skill` to install only the skill during setup.
-These flags don't open the wizard or update an existing Vizzly setup.
+This adds `.agents/skills/vizzly` and a note in `AGENTS.md`, keeping your
+other instructions. Use `--agent-skill` for just the skill. Run either command
+again to refresh it without changing your config.
 `--skip-agent-skill` skips agent setup unless you also request `--agent-guidance`.
 
 Use `context` to read local results. For cloud results, check the API schema
@@ -298,9 +298,18 @@ with `pnpm exec` when Vizzly is installed locally.
 Installed plugins add commands such as `storybook`, `static-site`, and `previews`.
 See their setup guides above for details.
 
+## Contributing
+
+Start in `src/domains/<domain>/` for CLI behavior or
+`src/reporter/src/domains/<domain>/` for reporter UI. The
+[architecture guide](docs/architecture.md) explains ownership, file roles, and
+the shared runtime boundaries. Run `pnpm run check:architecture` when changing
+source organization or imports.
+
 ## More
 
 [Full docs](https://docs.vizzly.dev) ·
+[Updating Vizzly](docs/updates.md) ·
 [Report a bug or suggest a change](https://github.com/vizzly-testing/cli/issues)
 
 PRs welcome. MIT licensed.

package/bin/vizzly.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
 
-import '../dist/cli.js';
+import '../dist/adapters/cli/cli.js';

package/dist/{cli.js → adapters/cli/cli.js}

@@ -2,39 +2,45 @@
 import 'dotenv/config';
 import { existsSync, statSync } from 'node:fs';
 import { Option, program } from 'commander';
-import { apiCommand, apiSchemaCommand, validateApiOptions } from './commands/api.js';
-import { baselinesCommand } from './commands/baselines.js';
-import { buildsCommand, validateBuildsOptions } from './commands/builds.js';
-import { comparisonsCommand, validateComparisonsOptions } from './commands/comparisons.js';
-import { configCommand } from './commands/config-cmd.js';
-import { contextBuildCommand, contextComparisonCommand, contextReviewQueueCommand, contextScreenshotCommand, contextSimilarCommand, validateContextBuildOptions, validateContextComparisonOptions, validateContextReviewQueueOptions, validateContextScreenshotOptions, validateContextSimilarOptions } from './commands/context.js';
-import { doctorCommand } from './commands/doctor.js';
-import { finalizeCommand, validateFinalizeOptions } from './commands/finalize.js';
-import { init } from './commands/init.js';
-import { loginCommand } from './commands/login.js';
-import { logoutCommand } from './commands/logout.js';
-import { orgsCommand } from './commands/orgs.js';
-import { previewCommand, validatePreviewOptions } from './commands/preview.js';
-import { projectLinkCommand, validateProjectLinkOptions } 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';
-import { statusCommand, validateStatusOptions } from './commands/status.js';
-import { tddCommand, validateTddOptions } from './commands/tdd.js';
-import { runDaemonChild, tddListCommand, tddStartCommand, tddStatusCommand, tddStopCommand, validateTddStartOptions } from './commands/tdd-daemon.js';
-import { acceptTddScreenshot, latestTddScreenshot, listTddScreenshots, showTddScreenshot } from './commands/tdd-screenshots.js';
-import { uploadCommand, validateUploadOptions } from './commands/upload.js';
-import { whoamiCommand } from './commands/whoami.js';
-import { createPluginServices } from './plugin-api.js';
-import { loadPlugins } from './plugin-loader.js';
-import { createServices } from './services/index.js';
-import { withTimeout } from './utils/async-utils.js';
-import { colors } from './utils/colors.js';
-import { loadConfig } from './utils/config-loader.js';
-import { getContext } from './utils/context.js';
-import { saveUserPath } from './utils/global-config.js';
-import * as output from './utils/output.js';
-import { getPackageVersion } from './utils/package-info.js';
+import { apiCommand, apiSchemaCommand, validateApiOptions } from '../../domains/api/api.commands.js';
+import { loginCommand } from '../../domains/auth/login.commands.js';
+import { logoutCommand } from '../../domains/auth/logout.commands.js';
+import { whoamiCommand } from '../../domains/auth/whoami.commands.js';
+import { baselinesCommand } from '../../domains/baselines/baselines.commands.js';
+import { validateBuildsOptions, validateFinalizeOptions, validateStatusOptions } from '../../domains/builds/build.validations.js';
+import { buildsCommand } from '../../domains/builds/builds.commands.js';
+import { finalizeCommand } from '../../domains/builds/finalize.commands.js';
+import { statusCommand } from '../../domains/builds/status.commands.js';
+import { comparisonsCommand, validateComparisonsOptions } from '../../domains/comparisons/comparisons.commands.js';
+import { configCommand } from '../../domains/config/config.commands.js';
+import { loadConfig } from '../../domains/config/config-loader.js';
+import { contextBuildCommand, contextComparisonCommand, contextReviewQueueCommand, contextScreenshotCommand, contextSimilarCommand } from '../../domains/context/context.commands.js';
+import { validateContextBuildOptions, validateContextComparisonOptions, validateContextReviewQueueOptions, validateContextScreenshotOptions, validateContextSimilarOptions } from '../../domains/context/context.validations.js';
+import { doctorCommand } from '../../domains/diagnostics/doctor.commands.js';
+import { getContext } from '../../domains/diagnostics/environment-context.js';
+import { previewCommand, validatePreviewOptions } from '../../domains/previews/preview.commands.js';
+import { orgsCommand } from '../../domains/projects/orgs.commands.js';
+import { projectLinkCommand } from '../../domains/projects/project.commands.js';
+import { validateProjectLinkOptions } from '../../domains/projects/project.validations.js';
+import { projectsCommand, validateProjectsOptions } from '../../domains/projects/projects.commands.js';
+import { approveCommand, commentCommand, rejectCommand, validateApproveOptions, validateCommentOptions, validateRejectOptions } from '../../domains/review/review.commands.js';
+import { runCommand, validateRunOptions } from '../../domains/runs/run.commands.js';
+import { init } from '../../domains/setup/init.commands.js';
+import { tddCommand, validateTddOptions } from '../../domains/tdd/tdd.commands.js';
+import { runDaemonChild, tddListCommand, tddStartCommand, tddStatusCommand, tddStopCommand, validateTddStartOptions } from '../../domains/tdd/tdd-daemon.commands.js';
+import { acceptTddScreenshot, latestTddScreenshot, listTddScreenshots, showTddScreenshot } from '../../domains/tdd/tdd-screenshots.commands.js';
+import { runUpdatedCli } from '../../domains/updates/cli-update.js';
+import { notifyUpdates } from '../../domains/updates/update-notifications.js';
+import { uploadCommand, validateUploadOptions } from '../../domains/uploads/upload.commands.js';
+import { withTimeout } from '../../shared/async-utils.js';
+import { colors } from '../../shared/colors.js';
+import { saveUserPath } from '../../shared/global-config.js';
+import * as output from '../../shared/output.js';
+import { getPackageVersion } from '../../shared/package-info.js';
+import { createPluginServices } from '../plugins/plugin-api.js';
+import { loadPlugins } from '../plugins/plugin-loader.js';
+import { createServices } from '../plugins/services.js';
+import { connectProject } from './setup.js';
 
 // Custom help formatting with BearDen design system
 const formatHelp = (cmd, helper) => {
@@ -393,7 +399,7 @@ function writeCommanderError(text) {
     }
   }
 }
-program.name('vizzly').description('Vizzly CLI for visual regression testing').version(getPackageVersion()).option('-c, --config <path>', 'Config file path').option('--token <token>', 'Vizzly API token').option('-v, --verbose', 'Verbose output (shorthand for --log-level debug)').option('--log-level <level>', 'Log level: debug, info, warn, error (default: info, or VIZZLY_LOG_LEVEL env var)').option('--json [fields]', 'JSON output, optionally specify fields (e.g., --json id,status,branch)').option('--color', 'Force colored output (even in non-TTY)').option('--no-color', 'Disable colored output').option('--strict', 'Fail on any error (default: be resilient, warn on non-critical issues)').configureHelp({
+program.name('vizzly').description('Vizzly CLI for visual regression testing').version(getPackageVersion()).option('-c, --config <path>', 'Config file path').option('--token <token>', 'Vizzly API token').option('-v, --verbose', 'Verbose output (shorthand for --log-level debug)').option('--log-level <level>', 'Log level: debug, info, warn, error (default: info, or VIZZLY_LOG_LEVEL env var)').option('--json [fields]', 'JSON output, optionally specify fields (e.g., --json id,status,branch)').option('--color', 'Force colored output (even in non-TTY)').option('--no-color', 'Disable colored output').option('--no-update-notifier', 'Skip update checks and notices').option('--strict', 'Fail on any error (default: be resilient, warn on non-critical issues)').configureHelp({
   formatHelp
 });
 program.configureOutput({
@@ -402,6 +408,13 @@ program.configureOutput({
 program.showHelpAfterError('(Run vizzly --help for available commands)');
 program.showSuggestionAfterError();
 program.exitOverride();
+program.hook('preAction', async (_command, actionCommand) => {
+  if (actionCommand.name() === 'init') return;
+  let updatedCli = await notifyUpdates(actionCommand.optsWithGlobals());
+  if (!updatedCli) return;
+  let code = await runUpdatedCli(updatedCli, process.argv.slice(2), process.cwd());
+  process.exit(code);
+});
 
 // Load plugins before defining commands
 // We need to manually parse to get the config option early
@@ -456,12 +469,14 @@ if (needsRuntimeBootstrap) {
     output.debug(`Plugin loading failed: ${error.message}`);
   }
 }
-program.command('init').description('Initialize Vizzly in your project').option('--quick', 'Create an editable config without the setup wizard').option('--force', 'Overwrite existing configuration').option('--agent-skill', 'Install the Vizzly agent skill during setup').option('--agent-guidance', 'Install the Vizzly skill and AGENTS.md guidance during setup').option('--skip-agent-skill', 'Skip the Vizzly agent skill prompt').action(async options => {
+program.command('init').description('Initialize Vizzly in your project').option('--quick', 'Create an editable config without the setup wizard').option('--force', 'Overwrite existing configuration').option('--agent-skill', 'Install or refresh the Vizzly agent skill').option('--agent-guidance', 'Install or refresh the Vizzly skill and AGENTS.md guidance').option('--skip-agent-skill', 'Skip the Vizzly agent skill prompt').action(async options => {
   let globalOptions = getGlobalOptions();
   try {
     let result = await init({
       ...globalOptions,
       ...options
+    }, {
+      connectProject
     });
     process.exitCode = result.exitCode || 0;
   } catch (error) {

package/dist/adapters/cli/setup.js

@@ -0,0 +1,34 @@
+import { spawn } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { projectLinkCommand } from '../../domains/projects/project.commands.js';
+function runProcess(command, args) {
+  return new Promise((resolve, reject) => {
+    let child = spawn(command, args, {
+      stdio: 'inherit'
+    });
+    child.once('error', reject);
+    child.once('close', (code, signal) => {
+      if (code === 0) resolve();else reject(new Error(`${command} did not finish successfully (${signal || code}).`));
+    });
+  });
+}
+export async function connectProject(project, options) {
+  let exitCode = 0;
+  let link = () => projectLinkCommand(project, {}, options, {
+    exit: code => {
+      exitCode = code;
+    }
+  });
+  let result = await link();
+  if (result?.reason === 'auth_required') {
+    let cli = fileURLToPath(new URL('./cli.js', import.meta.url));
+    await runProcess(process.execPath, [cli, 'login']);
+    result = await link();
+  }
+  let status = result?.linked ? 'linked' : 'failed';
+  if (!result?.linked && exitCode === 1) status = 'auth_required';
+  return {
+    status,
+    project
+  };
+}

package/dist/{client → adapters/client}/index.js

@@ -7,8 +7,9 @@ import { existsSync, readFileSync } from 'node:fs';
 import { request as httpRequest } from 'node:http';
 import { request as httpsRequest } from 'node:https';
 import { dirname, join, parse } from 'node:path';
-import { getBuildId, getServerUrl, isTddMode, setVizzlyEnabled } from '../utils/environment-config.js';
-import { getScreenshotOptionsPayload, normalizeScreenshotOptions } from '../utils/screenshot-options.js';
+import { getBuildId, getServerUrl, isTddMode, setVizzlyEnabled } from '../../domains/config/environment.js';
+import { serializeScreenshotRequest } from '../../domains/screenshots/screenshot.serializers.js';
+import { normalizeScreenshotOptions } from '../../domains/screenshots/screenshot-options.js';
 
 // Internal client state
 let currentClient = null;
@@ -209,14 +210,12 @@ function createSimpleClient(serverUrl, clientOptions = {}) {
         let isFilePath = typeof imageBuffer === 'string';
         let image = isFilePath ? imageBuffer : imageBuffer.toString('base64');
         let type = isFilePath ? 'file-path' : 'base64';
-        let screenshotData = {
+        let screenshotData = serializeScreenshotRequest({
           buildId: normalizedOptions.buildId ?? getBuildId(),
           name,
           image,
-          type,
-          properties: normalizedOptions.properties
-        };
-        Object.assign(screenshotData, getScreenshotOptionsPayload(normalizedOptions));
+          type
+        }, normalizedOptions);
         let httpStart = Date.now();
         let {
           status,

package/dist/adapters/http/cloud-proxy.js

@@ -0,0 +1,29 @@
+import { createCloudBaselinesRouter } from '../../domains/baselines/cloud-baselines.routes.js';
+import { createCloudBuildsRouter } from '../../domains/builds/cloud-builds.routes.js';
+import { createCloudProjectsRouter } from '../../domains/projects/cloud-projects.routes.js';
+import { sendError, sendServiceUnavailable } from './middleware/response.js';
+export function createCloudProxyRouter({
+  authService
+}) {
+  let projects = createCloudProjectsRouter({
+    authService
+  });
+  let builds = createCloudBuildsRouter({
+    authService
+  });
+  let baselines = createCloudBaselinesRouter({
+    authService
+  });
+  return async function handleCloudProxyRoute(req, res, pathname, parsedUrl) {
+    if (!pathname.startsWith('/api/cloud')) return false;
+    if (!authService) {
+      sendServiceUnavailable(res, 'Auth service');
+      return true;
+    }
+    if (await projects(req, res, pathname)) return true;
+    if (await builds(req, res, pathname, parsedUrl)) return true;
+    if (await baselines(req, res, pathname)) return true;
+    sendError(res, 404, 'Cloud API endpoint not found');
+    return true;
+  };
+}

package/dist/{server → adapters/http}/http-server.js

@@ -4,22 +4,21 @@
  */
 
 import { createServer } from 'node:http';
-import * as output from '../utils/output.js';
-
+import { createAuthRouter } from '../../domains/auth/auth.routes.js';
+import { createBaselineRouter } from '../../domains/baselines/baseline.routes.js';
+import { createConfigRouter } from '../../domains/config/config.routes.js';
+// Routers
+import { createHealthRouter } from '../../domains/diagnostics/health.routes.js';
+import { createProjectsRouter } from '../../domains/projects/projects.routes.js';
+import { createDashboardRouter } from '../../domains/reports/dashboard.routes.js';
+import { createEventsRouter } from '../../domains/reports/events.routes.js';
+import { createAssetsRouter } from '../../domains/reports/report-assets.routes.js';
+import { createScreenshotRouter } from '../../domains/screenshots/screenshot.routes.js';
+import * as output from '../../shared/output.js';
+import { createCloudProxyRouter } from './cloud-proxy.js';
 // Middleware
 import { corsMiddleware } from './middleware/cors.js';
 import { sendError } from './middleware/response.js';
-import { createAssetsRouter } from './routers/assets.js';
-import { createAuthRouter } from './routers/auth.js';
-import { createBaselineRouter } from './routers/baseline.js';
-import { createCloudProxyRouter } from './routers/cloud-proxy.js';
-import { createConfigRouter } from './routers/config.js';
-import { createDashboardRouter } from './routers/dashboard.js';
-import { createEventsRouter } from './routers/events.js';
-// Routers
-import { createHealthRouter } from './routers/health.js';
-import { createProjectsRouter } from './routers/projects.js';
-import { createScreenshotRouter } from './routers/screenshot.js';
 export const createHttpServer = (port, screenshotHandler, services = {}) => {
   let server = null;
   const defaultBuildId = services.buildId || null;

package/dist/{server-manager/operations.js → adapters/http/server-lifecycle.js}

@@ -11,7 +11,7 @@
  * This makes them trivially testable without mocking modules.
  */
 
-import { buildServerInfo, buildServerJsonPaths, buildServicesWithExtras, determineHandlerMode, getPort } from './core.js';
+import { buildServerInfo, buildServerJsonPaths, buildServicesWithExtras, determineHandlerMode, getPort } from './server-options.js';
 
 // ============================================================================
 // Server Lifecycle Operations
@@ -114,22 +114,19 @@ export async function stopServer({
   let {
     fs
   } = deps;
-  if (httpServer) {
-    await httpServer.stop();
-  }
-  if (handler?.cleanup) {
+  try {
+    await httpServer?.stop();
+  } finally {
     try {
-      handler.cleanup();
+      await handler?.cleanup?.();
     } catch {
-      // Don't throw - cleanup errors shouldn't fail the stop process
+      // Preserve the HTTP shutdown error when handler cleanup also fails.
     }
+    removeServerJson({
+      projectRoot,
+      fs
+    });
   }
-
-  // Clean up server.json
-  removeServerJson({
-    projectRoot,
-    fs
-  });
 }
 
 // ============================================================================

package/dist/{server-manager/index.js → adapters/http/server-manager.js}

@@ -1,24 +1,12 @@
-/**
- * Server Manager Module - Public exports
- *
- * Provides functional server management primitives:
- * - core.js: Pure functions for building server info, configs, interfaces
- * - operations.js: Server operations with dependency injection
- */
+/** Screenshot server composition and lifecycle interface. */
 
 import { existsSync, mkdirSync, unlinkSync, writeFileSync } from 'node:fs';
-import { createApiClient } from '../api/index.js';
-import { createApiHandler } from '../server/handlers/api-handler.js';
-import { createTddHandler } from '../server/handlers/tdd-handler.js';
-import { createHttpServer } from '../server/http-server.js';
-
-// Core pure functions
-import { buildServerInterface } from './core.js';
-export { buildClientOptions, buildServerInfo, buildServerInterface, buildServerJsonPaths, buildServicesWithExtras, DEFAULT_PORT, determineHandlerMode, getPort, hasApiKey } from './core.js';
-
-// Server operations (take dependencies as parameters)
-import { getTddResults, startServer, stopServer } from './operations.js';
-export { getTddResults, removeServerJson, startServer, stopServer, writeServerJson } from './operations.js';
+import { createApiClient } from '../../domains/auth/cloud-client.js';
+import { createApiHandler } from '../../domains/screenshots/cloud-handler.js';
+import { createTddHandler } from '../../domains/tdd/screenshot-handler.js';
+import { createHttpServer } from './http-server.js';
+import { getTddResults, startServer, stopServer } from './server-lifecycle.js';
+import { buildServerInterface } from './server-options.js';
 
 /**
  * Create a server manager object that provides the interface commands expect.
@@ -26,9 +14,12 @@ export { getTddResults, removeServerJson, startServer, stopServer, writeServerJs
  *
  * @param {Object} config - Configuration object
  * @param {Object} [services={}] - Optional services object
+ * @param {Object} [options={}] - Runtime paths
+ * @param {string} [options.projectRoot] - Workspace for capture and discovery files
  * @returns {Object} Server manager with start/stop/getTddResults methods
  */
-export function createServerManager(config, services = {}) {
+export function createServerManager(config, services = {}, options = {}) {
+  let projectRoot = options.projectRoot || process.cwd();
   let httpServer = null;
   let handler = null;
   let deps = {
@@ -50,7 +41,7 @@ export function createServerManager(config, services = {}) {
         buildId,
         tddMode,
         setBaseline,
-        projectRoot: process.cwd(),
+        projectRoot,
         services,
         deps
       });
@@ -58,12 +49,17 @@ export function createServerManager(config, services = {}) {
       handler = result.handler;
     },
     async stop() {
-      await stopServer({
-        httpServer,
-        handler,
-        projectRoot: process.cwd(),
-        deps
-      });
+      try {
+        await stopServer({
+          httpServer,
+          handler,
+          projectRoot,
+          deps
+        });
+      } finally {
+        httpServer = null;
+        handler = null;
+      }
     },
     async getTddResults() {
       return getTddResults({

package/dist/{plugin-api.js → adapters/plugins/plugin-api.js}

@@ -9,7 +9,7 @@
  * exposed to plugins to prevent coupling to implementation details.
  */
 
-import { detectBranch, detectCommit, detectCommitMessage, detectPullRequestNumber, generateBuildNameWithGit } from './utils/git.js';
+import { detectBranch, detectCommit, detectCommitMessage, detectPullRequestNumber, generateBuildNameWithGit } from '../../shared/git.js';
 
 /**
  * Creates a stable plugin services object from the internal services

package/dist/{plugin-loader.js → adapters/plugins/plugin-loader.js}

@@ -3,7 +3,7 @@ import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { glob } from 'glob';
 import { z } from 'zod';
-import * as output from './utils/output.js';
+import * as output from '../../shared/output.js';
 
 /**
  * Load and register plugins from node_modules and config

package/dist/{services/index.js → adapters/plugins/services.js}

@@ -1,16 +1,11 @@
 /**
  * Service Factory
- * Creates services for plugin API compatibility.
- *
- * Internal commands now use functional modules directly:
- * - API: import { createApiClient, getBuild } from '../api/index.js'
- * - Auth: import { createAuthClient, whoami } from '../auth/index.js'
- *
- * This factory is only used by cli.js to provide services to plugins.
+ * Assembles the execution and screenshot-server interfaces consumed by plugins.
+ * Commands import their domain operations directly.
  */
 
-import { createServerManager } from '../server-manager/index.js';
-import { TestRunner } from './test-runner.js';
+import { TestRunner } from '../../domains/runs/run-events.js';
+import { createServerManager } from '../http/server-manager.js';
 
 /**
  * Create services for plugin API compatibility.

package/dist/adapters/sdk/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Vizzly SDK Type Definitions
+ * Full SDK for custom integrations
+ * @module @vizzly-testing/cli/sdk
+ */
+
+// Re-export common types
+/**
+ * VizzlySDK class - Full SDK for custom integrations
+ *
+ * @example
+ * import { createVizzly } from '@vizzly-testing/cli/sdk';
+ *
+ * const vizzly = await createVizzly({
+ *   apiKey: process.env.VIZZLY_TOKEN,
+ *   server: { port: 3003 }
+ * });
+ *
+ * await vizzly.start();
+ * await vizzly.screenshot('test', buffer);
+ * await vizzly.upload();
+ * await vizzly.stop();
+ */
+export {
+  BaselineData,
+  ComparisonResult,
+  OutputUtils,
+  ScreenshotOptions,
+  TddResults,
+  TddService,
+  Uploader,
+  UploadOptions,
+  UploadResult,
+  VizzlyConfig,
+  VizzlySDK,
+} from '../../index';
+
+/**
+ * Create a new Vizzly SDK instance
+ *
+ * @param config - Configuration options
+ * @param options - Additional options
+ * @returns Configured Vizzly SDK instance
+ *
+ * @example
+ * const vizzly = await createVizzly({
+ *   apiKey: process.env.VIZZLY_TOKEN,
+ *   apiUrl: 'https://app.vizzly.dev',
+ *   server: { port: 3003 }
+ * });
+ */
+export function createVizzly(
+  config?: import('../../index').VizzlyConfig,
+  options?: { verbose?: boolean }
+): Promise<import('../../index').VizzlySDK>;
+
+/** Load configuration from file and environment */
+export function loadConfig(options?: {
+  cwd?: string;
+}): Promise<import('../../index').VizzlyConfig>;
+
+/** Output utilities */
+export const output: import('../../index').OutputUtils;
+
+/** Create an uploader instance */
+export function createUploader(
+  config?: {
+    apiKey?: string;
+    apiUrl?: string;
+    userAgent?: string;
+    command?: string;
+    upload?: import('../../index').UploadConfig;
+  },
+  options?: {
+    signal?: AbortSignal;
+    batchSize?: number;
+    timeout?: number;
+  }
+): import('../../index').Uploader;
+
+/** Create a TDD service instance */
+export function createTDDService(
+  config: import('../../index').VizzlyConfig,
+  options?: {
+    workingDir?: string;
+    setBaseline?: boolean;
+    authService?: unknown;
+  }
+): import('../../index').TddService;

package/dist/{sdk → adapters/sdk}/index.js

@@ -12,14 +12,15 @@
 
 import { EventEmitter } from 'node:events';
 import { createServer } from 'node:http';
-import { VizzlyError } from '../errors/vizzly-error.js';
-import { handleRequest as handleScreenshotRequest, startServer as startScreenshotServer, stopServer as stopScreenshotServer } from '../screenshot-server/index.js';
-import { createTDDService } from '../tdd/tdd-service.js';
-import { createUploader } from '../uploader/index.js';
-import { loadConfig } from '../utils/config-loader.js';
-import { resolveImageBuffer } from '../utils/file-helpers.js';
-import * as output from '../utils/output.js';
-import { getScreenshotOptionsPayload, normalizeScreenshotOptions } from '../utils/screenshot-options.js';
+import { loadConfig } from '../../domains/config/config-loader.js';
+import { resolveImageBuffer } from '../../domains/screenshots/image-files.js';
+import { serializeScreenshotRequest } from '../../domains/screenshots/screenshot.serializers.js';
+import { normalizeScreenshotOptions } from '../../domains/screenshots/screenshot-options.js';
+import { handleRequest as handleScreenshotRequest, startServer as startScreenshotServer, stopServer as stopScreenshotServer } from '../../domains/screenshots/screenshot-server.js';
+import { createTDDService } from '../../domains/tdd/tdd.service.js';
+import { createUploader } from '../../domains/uploads/upload.service.js';
+import * as output from '../../shared/output.js';
+import { VizzlyError } from '../../shared/vizzly-error.js';
 
 /**
  * Create a new Vizzly instance with custom configuration
@@ -248,7 +249,10 @@ export class VizzlySDK extends EventEmitter {
   }
   async startTDD(options = {}) {
     let tddService = this.createTDDService(options);
-    return tddService.start(options);
+    tddService.clearRunData();
+    await tddService.loadBaseline();
+    this.services.tddService = tddService;
+    return tddService;
   }
 
   /**
@@ -301,14 +305,12 @@ export class VizzlySDK extends EventEmitter {
 
     // Convert Buffer to base64 for JSON transport
     let imageBase64 = buffer.toString('base64');
-    let screenshotData = {
+    let screenshotData = serializeScreenshotRequest({
       buildId,
       name,
       image: imageBase64,
-      type: 'base64',
-      properties: normalizedOptions.properties
-    };
-    Object.assign(screenshotData, getScreenshotOptionsPayload(normalizedOptions));
+      type: 'base64'
+    }, normalizedOptions);
     // POST to the local screenshot server
     let serverUrl = `http://localhost:${this.config.server?.port || 3000}`;
     let fetchFn = this.services.fetch || fetch;
@@ -419,9 +421,10 @@ export class VizzlySDK extends EventEmitter {
     }
   }
 }
-export { createTDDService } from '../tdd/tdd-service.js';
-// Export service creators for advanced usage
-export { createUploader } from '../uploader/index.js';
+
 // Re-export key utilities and errors
-export { loadConfig } from '../utils/config-loader.js';
-export * as output from '../utils/output.js';
+export { loadConfig } from '../../domains/config/config-loader.js';
+export { createTDDService } from '../../domains/tdd/tdd.service.js';
+// Export service creators for advanced usage
+export { createUploader } from '../../domains/uploads/upload.service.js';
+export * as output from '../../shared/output.js';

package/dist/{commands/api.js → domains/api/api.commands.js}

@@ -6,9 +6,9 @@ import { open, readFile, unlink } from 'node:fs/promises';
 import { resolve } from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
-import { createApiClient as defaultCreateApiClient } from '../api/index.js';
-import { loadConfig as defaultLoadConfig } from '../utils/config-loader.js';
-import * as defaultOutput from '../utils/output.js';
+import * as defaultOutput from '../../shared/output.js';
+import { createApiClient as defaultCreateApiClient } from '../auth/cloud-client.js';
+import { loadConfig as defaultLoadConfig } from '../config/config-loader.js';
 let API_METHODS = ['GET', 'HEAD', 'POST', 'PUT', 'PATCH', 'DELETE'];
 function createApiCommandDeps(deps = {}) {
   return {