@shipstatic/types 0.4.22 → 0.4.24

package/dist/index.d.ts

@@ -417,7 +417,7 @@ export interface ConfigResponse {
  * - Explicit allowlist (only approved formats, reject unknown)
  * ============================================================================
  */
-export declare const ALLOWED_MIME_TYPES: readonly ["text/html", "text/css", "text/plain", "text/markdown", "text/xml", "text/csv", "text/yaml", "text/vtt", "text/calendar", "text/javascript", "text/typescript", "text/tsx", "text/jsx", "text/x-scss", "text/x-sass", "text/x-less", "text/stylus", "text/x-vue", "text/x-svelte", "image/", "audio/", "video/", "font/", "application/javascript", "application/ecmascript", "application/x-javascript", "application/wasm", "application/json", "application/ld+json", "application/manifest+json", "application/source-map", "application/xml", "application/xhtml+xml", "application/rss+xml", "application/atom+xml", "application/yaml", "application/toml", "application/pdf", "model/gltf+json", "model/gltf-binary", "application/mp4", "application/font-woff", "application/font-woff2", "application/x-font-woff", "application/x-woff", "application/vnd.ms-fontobject", "application/x-font-ttf", "application/x-font-truetype", "application/x-font-otf", "application/x-font-opentype"];
+export declare const ALLOWED_MIME_TYPES: readonly ["text/html", "text/css", "text/plain", "text/markdown", "text/xml", "text/csv", "text/yaml", "text/vtt", "text/calendar", "text/javascript", "text/typescript", "text/tsx", "text/jsx", "text/x-scss", "text/x-sass", "text/less", "text/x-less", "text/stylus", "text/x-vue", "text/x-svelte", "image/", "audio/", "video/", "font/", "application/javascript", "application/ecmascript", "application/x-javascript", "application/wasm", "application/json", "application/ld+json", "application/manifest+json", "application/source-map", "application/xml", "application/xhtml+xml", "application/rss+xml", "application/atom+xml", "application/yaml", "application/toml", "application/pdf", "model/gltf+json", "model/gltf-binary", "application/mp4", "application/font-woff", "application/font-woff2", "application/x-font-woff", "application/x-woff", "application/vnd.ms-fontobject", "application/x-font-ttf", "application/x-font-truetype", "application/x-font-otf", "application/x-font-opentype"];
 /**
  * Check if a MIME type is allowed for upload.
  *
@@ -759,15 +759,43 @@ export interface ActivityListResponse {
  * File status constants for validation state tracking
  */
 export declare const FileValidationStatus: {
+    /** File is pending validation */
     readonly PENDING: "pending";
+    /** File failed during processing (before validation) */
     readonly PROCESSING_ERROR: "processing_error";
-    readonly EMPTY_FILE: "empty_file";
+    /** File was excluded by validation warning (not an error) */
+    readonly EXCLUDED: "excluded";
+    /** File failed validation (blocks deployment) */
     readonly VALIDATION_FAILED: "validation_failed";
+    /** File passed validation and is ready for deployment */
     readonly READY: "ready";
 };
 export type FileValidationStatusType = typeof FileValidationStatus[keyof typeof FileValidationStatus];
 /**
- * Client-side validation error structure
+ * Types of validation issues that can occur during file validation
+ */
+export type ValidationIssueType = 'empty_file' | 'file_too_large' | 'total_size_exceeded' | 'invalid_mime_type' | 'invalid_filename' | 'mime_extension_mismatch' | 'file_count_exceeded' | 'processing_error';
+/**
+ * A validation issue with severity level
+ *
+ * Issues are categorized by severity:
+ * - **error**: Blocks deployment, user must fix
+ * - **warning**: Excludes file but allows deployment to proceed
+ */
+export interface ValidationIssue {
+    /** File path that triggered this issue */
+    file: string;
+    /** Severity level determines deployment behavior */
+    severity: 'error' | 'warning';
+    /** Issue type for programmatic handling */
+    type: ValidationIssueType;
+    /** Human-readable message explaining the issue */
+    message: string;
+}
+/**
+ * Legacy validation error structure
+ *
+ * @deprecated Use ValidationIssue[] from FileValidationResult instead
  */
 export interface ValidationError {
     error: string;
@@ -786,18 +814,40 @@ export interface ValidatableFile {
     statusMessage?: string;
 }
 /**
- * File validation result
+ * File validation result with severity-based issue reporting
+ *
+ * Validation checks files against constraints and categorizes issues by severity:
+ * - **Errors**: Block deployment (file too large, invalid type, etc.)
+ * - **Warnings**: Exclude files but allow deployment (empty files, etc.)
  *
- * NOTE: Validation is ATOMIC - if any file fails validation, ALL files are rejected.
- * This ensures deployments are all-or-nothing for data integrity.
+ * @example
+ * ```typescript
+ * const result = validateFiles(files, config);
+ *
+ * if (!result.canDeploy) {
+ *   // Has errors - must fix before deploying
+ *   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);
+ *   deploy(result.validFiles);
+ * } else {
+ *   // All files valid
+ *   deploy(result.validFiles);
+ * }
+ * ```
  */
 export interface FileValidationResult<T extends ValidatableFile> {
     /** All files with updated status */
     files: T[];
-    /** Files that passed validation (empty if ANY file failed - atomic validation) */
+    /** Files ready for deployment (status: 'ready') */
     validFiles: T[];
-    /** Validation error if any files failed */
-    error: ValidationError | null;
+    /** Blocking errors that prevent deployment */
+    errors: ValidationIssue[];
+    /** Non-blocking warnings (files excluded but deployment allowed) */
+    warnings: ValidationIssue[];
+    /** Whether deployment can proceed (true if errors.length === 0) */
+    canDeploy: boolean;
 }
 /**
  * Represents a file that has been uploaded and stored

package/dist/index.js

@@ -289,7 +289,8 @@ export const ALLOWED_MIME_TYPES = [
     'text/jsx', // React JSX (.jsx)
     'text/x-scss', // SCSS preprocessor
     'text/x-sass', // Sass preprocessor
-    'text/x-less', // Less preprocessor
+    'text/less', // Less preprocessor
+    'text/x-less', // Less preprocessor (alternative)
     'text/stylus', // Stylus preprocessor
     'text/x-vue', // Vue single-file components (.vue)
     'text/x-svelte', // Svelte components (.svelte)
@@ -459,10 +460,15 @@ export const DEFAULT_API = 'https://api.shipstatic.com';
  * File status constants for validation state tracking
  */
 export const FileValidationStatus = {
+    /** File is pending validation */
     PENDING: 'pending',
+    /** File failed during processing (before validation) */
     PROCESSING_ERROR: 'processing_error',
-    EMPTY_FILE: 'empty_file',
+    /** File was excluded by validation warning (not an error) */
+    EXCLUDED: 'excluded',
+    /** File failed validation (blocks deployment) */
     VALIDATION_FAILED: 'validation_failed',
+    /** File passed validation and is ready for deployment */
     READY: 'ready',
 };
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shipstatic/types",
-  "version": "0.4.22",
+  "version": "0.4.24",
   "description": "Shared types for Shipstatic platform",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -600,7 +600,8 @@ export const ALLOWED_MIME_TYPES = [
   'text/jsx',                      // React JSX (.jsx)
   'text/x-scss',                   // SCSS preprocessor
   'text/x-sass',                   // Sass preprocessor
-  'text/x-less',                   // Less preprocessor
+  'text/less',                     // Less preprocessor
+  'text/x-less',                   // Less preprocessor (alternative)
   'text/stylus',                   // Stylus preprocessor
   'text/x-vue',                    // Vue single-file components (.vue)
   'text/x-svelte',                 // Svelte components (.svelte)
@@ -1211,17 +1212,61 @@ export interface ActivityListResponse {
  * File status constants for validation state tracking
  */
 export const FileValidationStatus = {
+  /** File is pending validation */
   PENDING: 'pending',
+  /** File failed during processing (before validation) */
   PROCESSING_ERROR: 'processing_error',
-  EMPTY_FILE: 'empty_file',
+  /** File was excluded by validation warning (not an error) */
+  EXCLUDED: 'excluded',
+  /** File failed validation (blocks deployment) */
   VALIDATION_FAILED: 'validation_failed',
+  /** File passed validation and is ready for deployment */
   READY: 'ready',
 } as const;
 
 export type FileValidationStatusType = typeof FileValidationStatus[keyof typeof FileValidationStatus];
 
 /**
- * Client-side validation error structure
+ * Types of validation issues that can occur during file validation
+ */
+export type ValidationIssueType =
+  // Warnings (exclude file but don't block deployment)
+  | 'empty_file'
+
+  // Errors (block deployment)
+  | 'file_too_large'
+  | 'total_size_exceeded'
+  | 'invalid_mime_type'
+  | 'invalid_filename'
+  | 'mime_extension_mismatch'
+  | 'file_count_exceeded'
+  | 'processing_error';
+
+/**
+ * A validation issue with severity level
+ *
+ * Issues are categorized by severity:
+ * - **error**: Blocks deployment, user must fix
+ * - **warning**: Excludes file but allows deployment to proceed
+ */
+export interface ValidationIssue {
+  /** File path that triggered this issue */
+  file: string;
+
+  /** Severity level determines deployment behavior */
+  severity: 'error' | 'warning';
+
+  /** Issue type for programmatic handling */
+  type: ValidationIssueType;
+
+  /** Human-readable message explaining the issue */
+  message: string;
+}
+
+/**
+ * Legacy validation error structure
+ *
+ * @deprecated Use ValidationIssue[] from FileValidationResult instead
  */
 export interface ValidationError {
   error: string;
@@ -1242,18 +1287,44 @@ export interface ValidatableFile {
 }
 
 /**
- * File validation result
+ * File validation result with severity-based issue reporting
+ *
+ * Validation checks files against constraints and categorizes issues by severity:
+ * - **Errors**: Block deployment (file too large, invalid type, etc.)
+ * - **Warnings**: Exclude files but allow deployment (empty files, etc.)
+ *
+ * @example
+ * ```typescript
+ * const result = validateFiles(files, config);
  *
- * NOTE: Validation is ATOMIC - if any file fails validation, ALL files are rejected.
- * This ensures deployments are all-or-nothing for data integrity.
+ * if (!result.canDeploy) {
+ *   // Has errors - must fix before deploying
+ *   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);
+ *   deploy(result.validFiles);
+ * } else {
+ *   // All files valid
+ *   deploy(result.validFiles);
+ * }
+ * ```
  */
 export interface FileValidationResult<T extends ValidatableFile> {
   /** All files with updated status */
   files: T[];
-  /** Files that passed validation (empty if ANY file failed - atomic validation) */
+
+  /** Files ready for deployment (status: 'ready') */
   validFiles: T[];
-  /** Validation error if any files failed */
-  error: ValidationError | null;
+
+  /** Blocking errors that prevent deployment */
+  errors: ValidationIssue[];
+
+  /** Non-blocking warnings (files excluded but deployment allowed) */
+  warnings: ValidationIssue[];
+
+  /** Whether deployment can proceed (true if errors.length === 0) */
+  canDeploy: boolean;
 }
 
 /**