@shipstatic/ship 0.4.22 → 0.4.24

package/dist/browser.d.ts

@@ -535,27 +535,30 @@ declare function getENV(): ExecutionEnvironment;
  */
 declare function formatFileSize(bytes: number, decimals?: number): string;
 /**
- * Validate files against configuration limits
+ * Validate files against configuration limits with severity-based reporting
  *
- * ATOMIC VALIDATION: If ANY file fails validation, ALL files are rejected.
- * This ensures deployments are all-or-nothing for data integrity.
+ * Validation categorizes issues by severity:
+ * - **Errors**: Block deployment (file too large, invalid type, etc.)
+ * - **Warnings**: Exclude files but allow deployment (empty files, etc.)
  *
  * @param files - Array of files to validate
  * @param config - Validation configuration from ship.getConfig()
- * @returns Validation result with updated file status
+ * @returns Validation result with errors and warnings
  *
  * @example
  * ```typescript
  * const config = await ship.getConfig();
  * const result = validateFiles(files, config);
  *
- * if (result.error) {
- *   // Validation failed - result.validFiles will be empty
- *   console.error(result.error.details);
- *   // Show individual file errors:
- *   result.files.forEach(f => console.log(`${f.name}: ${f.statusMessage}`));
+ * if (!result.canDeploy) {
+ *   // Has errors - deployment blocked
+ *   console.error('Deployment blocked:', result.errors);
+ * } else if (result.warnings.length > 0) {
+ *   // Has warnings - deployment proceeds, some files excluded
+ *   console.warn('Files excluded:', result.warnings);
+ *   await ship.deploy(result.validFiles);
  * } else {
- *   // All files valid - safe to upload
+ *   // All files valid
  *   await ship.deploy(result.validFiles);
  * }
  * ```