✨ Improve preview command with smart exclusions and dry-run

- Fix form-data upload issue by using native FormData/Blob for fetch compatibility
- Add smart default exclusions for non-static files (node_modules, tests, configs, etc.)
- Add --dry-run flag to show what would be uploaded without uploading
- Add --exclude/-x flag to add custom exclusion patterns
- Add --include/-i flag to override default exclusions
- Show helpful error message when path argument is missing
- Skip API token validation for dry-run mode

Author: Robdel12

src/api/endpoints.js

@@ -333,18 +333,15 @@ export async function finalizeParallelBuild(client, parallelId) {
  * @returns {Promise<Object>} Upload result with preview URL
  */
 export async function uploadPreviewZip(client, buildId, zipBuffer) {
-  // Create form data with the ZIP file
-  let FormData = (await import('form-data')).default;
+  // Use native FormData (Node 18+) with Blob for proper fetch compatibility
   let formData = new FormData();
-  formData.append('file', zipBuffer, {
-    filename: 'preview.zip',
-    contentType: 'application/zip',
-  });
+  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,
-    headers: formData.getHeaders(),
+    // Let fetch set the Content-Type with boundary automatically
   });
 }
 

src/cli.js

@@ -572,14 +572,38 @@ program
 program
   .command('preview')
   .description('Upload static files as a preview for a build')
-  .argument('<path>', 'Path to static files (dist/, build/, out/)')
+  .argument('[path]', 'Path to static files (dist/, build/, out/)')
   .option('-b, --build <id>', 'Build ID to attach preview to')
   .option('-p, --parallel-id <id>', 'Look up build by parallel ID')
   .option('--base <path>', 'Override auto-detected base path')
   .option('--open', 'Open preview URL in browser after upload')
+  .option('--dry-run', 'Show what would be uploaded without uploading')
+  .option(
+    '-x, --exclude <pattern>',
+    'Exclude files/dirs (can be repeated, use trailing / for dirs)',
+    (val, prev) => (prev ? [...prev, val] : [val])
+  )
+  .option(
+    '-i, --include <pattern>',
+    'Include files/dirs excluded by default (can be repeated)',
+    (val, prev) => (prev ? [...prev, val] : [val])
+  )
   .action(async (path, options) => {
     const globalOptions = program.opts();
 
+    // Show helpful error if path is missing
+    if (!path) {
+      output.error('Path to static files is required');
+      output.blank();
+      output.print('  Upload your build output directory:');
+      output.blank();
+      output.print('    vizzly preview ./dist');
+      output.print('    vizzly preview ./build');
+      output.print('    vizzly preview ./out');
+      output.blank();
+      process.exit(1);
+    }
+
     // Validate options
     const validationErrors = validatePreviewOptions(path, options);
     if (validationErrors.length > 0) {