@shipstatic/drop 0.1.2 → 0.1.4

package/dist/index.d.cts

@@ -1,4 +1,5 @@
-import { ConfigResponse, StaticFile } from '@shipstatic/types';
+import { StaticFile } from '@shipstatic/types';
+import { Ship, formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
 
 /**
  * Core types for @shipstatic/dropzone
@@ -20,10 +21,12 @@ declare const FILE_STATUSES: {
 type FileStatus = (typeof FILE_STATUSES)[keyof typeof FILE_STATUSES];
 /**
  * Client-side error structure
+ * Matches ValidationError from @shipstatic/ship for consistency
  */
 interface ClientError {
     error: string;
     details: string;
+    errors?: string[];
     isClientError: true;
 }
 /**
@@ -49,43 +52,30 @@ interface ProcessedFile extends StaticFile {
     /** Upload progress (0-100) - only set during upload */
     progress?: number;
 }
-/**
- * Validation configuration - direct alias to SDK's ConfigResponse
- * This allows passing the config directly from ship.getConfig() to the dropzone
- *
- * Single source of truth: @shipstatic/types
- */
-type ValidationConfig = ConfigResponse;
-/**
- * Default validation limits
- */
-declare const DEFAULT_VALIDATION: ConfigResponse;
 
 interface DropOptions {
-    /** Validation configuration (from ship.getConfig()) */
-    config?: Partial<ValidationConfig>;
+    /** Ship SDK instance (required for validation) */
+    ship: Ship;
+    /** Callback when files are processed and ready */
+    onFilesReady?: (files: ProcessedFile[]) => void;
     /** Callback when validation fails */
     onValidationError?: (error: ClientError) => void;
-    /** Callback when files are ready for upload */
-    onFilesReady?: (files: ProcessedFile[]) => void;
     /** Whether to strip common directory prefix from paths (default: true) */
     stripPrefix?: boolean;
 }
 interface DropReturn {
     /** All processed files with their status */
     files: ProcessedFile[];
+    /** Name of the source (file/folder/ZIP) that was dropped/selected */
+    sourceName: string;
     /** Current status text */
     statusText: string;
     /** Whether currently processing files (ZIP extraction, etc.) */
     isProcessing: boolean;
     /** Last validation error if any */
     validationError: ClientError | null;
-    /** Whether all valid files have MD5 checksums calculated */
-    hasChecksums: boolean;
     /** Process files from drop (resets and replaces existing files) */
     processFiles: (files: File[]) => Promise<void>;
-    /** Remove a specific file */
-    removeFile: (fileId: string) => void;
     /** Clear all files and reset state */
     clearAll: () => void;
     /** Get only valid files ready for upload */
@@ -102,20 +92,25 @@ interface DropReturn {
  * Handles file processing, ZIP extraction, and validation
  * Does NOT handle uploading - that's the consumer's responsibility
  */
-declare function useDrop(options?: DropOptions): DropReturn;
+declare function useDrop(options: DropOptions): DropReturn;
 
 /**
- * Calculate MD5 hash from ArrayBuffer
+ * Unified file processing utilities
+ * Converts Files directly to ProcessedFiles
  */
-declare function calculateMD5(buffer: ArrayBuffer): Promise<string>;
+
 /**
  * Format file size to human-readable string
+ * Re-exported from Ship SDK for convenience
  */
-declare function formatFileSize(bytes: number, decimals?: number): string;
+declare const formatFileSize: typeof formatFileSize$1;
 /**
  * Create a ProcessedFile from a File object
  * This is the single conversion point from File to ProcessedFile
  *
+ * Note: MD5 calculation is handled by Ship SDK during deployment.
+ * Drop focuses on file processing, path normalization, and UI state management.
+ *
  * Path resolution priority:
  * 1. options.path (if provided)
  * 2. file.webkitRelativePath (if non-empty, preserves folder structure)
@@ -124,30 +119,12 @@ declare function formatFileSize(bytes: number, decimals?: number): string;
 declare function createProcessedFile(file: File, options?: {
     /** Custom path (defaults to webkitRelativePath or file.name) */
     path?: string;
-    /** Whether to calculate MD5 hash (defaults to true) */
-    calculateMD5?: boolean;
 }): Promise<ProcessedFile>;
-/**
- * Validate and update status of ProcessedFiles
- * Returns files with updated status and validation error if any
- */
-interface ValidationResult {
-    /** All files with updated status */
-    files: ProcessedFile[];
-    /** Files that passed validation (status: READY) */
-    validFiles: ProcessedFile[];
-    /** Validation error if any files failed */
-    error: ClientError | null;
-}
-declare function validateFiles(files: ProcessedFile[], config: ValidationConfig): ValidationResult;
 /**
  * Get only the valid files (status: READY) from a list
+ * Re-exported from Ship SDK for convenience
  */
-declare function getValidFiles(files: ProcessedFile[]): ProcessedFile[];
-/**
- * Check if all valid files have MD5 checksums calculated
- */
-declare function allValidFilesHaveChecksums(files: ProcessedFile[]): boolean;
+declare const getValidFiles: (files: ProcessedFile[]) => ProcessedFile[];
 /**
  * Strip common directory prefix from file paths
  * Only strips if ALL files share the same prefix
@@ -197,4 +174,4 @@ declare function isJunkFile(path: string): boolean;
  */
 declare function isZipFile(file: File): boolean;
 
-export { type ClientError, DEFAULT_VALIDATION, type DropOptions, type DropReturn, FILE_STATUSES, type FileStatus, type ProcessedFile, type ValidationConfig, type ValidationResult, type ZipExtractionResult, allValidFilesHaveChecksums, calculateMD5, createProcessedFile, extractZipToFiles, formatFileSize, getValidFiles, isJunkFile, isZipFile, normalizePath, stripCommonPrefix, useDrop, validateFiles };
+export { type ClientError, type DropOptions, type DropReturn, FILE_STATUSES, type FileStatus, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getValidFiles, isJunkFile, isZipFile, normalizePath, stripCommonPrefix, useDrop };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
-import { ConfigResponse, StaticFile } from '@shipstatic/types';
+import { StaticFile } from '@shipstatic/types';
+import { Ship, formatFileSize as formatFileSize$1 } from '@shipstatic/ship';
 
 /**
  * Core types for @shipstatic/dropzone
@@ -20,10 +21,12 @@ declare const FILE_STATUSES: {
 type FileStatus = (typeof FILE_STATUSES)[keyof typeof FILE_STATUSES];
 /**
  * Client-side error structure
+ * Matches ValidationError from @shipstatic/ship for consistency
  */
 interface ClientError {
     error: string;
     details: string;
+    errors?: string[];
     isClientError: true;
 }
 /**
@@ -49,43 +52,30 @@ interface ProcessedFile extends StaticFile {
     /** Upload progress (0-100) - only set during upload */
     progress?: number;
 }
-/**
- * Validation configuration - direct alias to SDK's ConfigResponse
- * This allows passing the config directly from ship.getConfig() to the dropzone
- *
- * Single source of truth: @shipstatic/types
- */
-type ValidationConfig = ConfigResponse;
-/**
- * Default validation limits
- */
-declare const DEFAULT_VALIDATION: ConfigResponse;
 
 interface DropOptions {
-    /** Validation configuration (from ship.getConfig()) */
-    config?: Partial<ValidationConfig>;
+    /** Ship SDK instance (required for validation) */
+    ship: Ship;
+    /** Callback when files are processed and ready */
+    onFilesReady?: (files: ProcessedFile[]) => void;
     /** Callback when validation fails */
     onValidationError?: (error: ClientError) => void;
-    /** Callback when files are ready for upload */
-    onFilesReady?: (files: ProcessedFile[]) => void;
     /** Whether to strip common directory prefix from paths (default: true) */
     stripPrefix?: boolean;
 }
 interface DropReturn {
     /** All processed files with their status */
     files: ProcessedFile[];
+    /** Name of the source (file/folder/ZIP) that was dropped/selected */
+    sourceName: string;
     /** Current status text */
     statusText: string;
     /** Whether currently processing files (ZIP extraction, etc.) */
     isProcessing: boolean;
     /** Last validation error if any */
     validationError: ClientError | null;
-    /** Whether all valid files have MD5 checksums calculated */
-    hasChecksums: boolean;
     /** Process files from drop (resets and replaces existing files) */
     processFiles: (files: File[]) => Promise<void>;
-    /** Remove a specific file */
-    removeFile: (fileId: string) => void;
     /** Clear all files and reset state */
     clearAll: () => void;
     /** Get only valid files ready for upload */
@@ -102,20 +92,25 @@ interface DropReturn {
  * Handles file processing, ZIP extraction, and validation
  * Does NOT handle uploading - that's the consumer's responsibility
  */
-declare function useDrop(options?: DropOptions): DropReturn;
+declare function useDrop(options: DropOptions): DropReturn;
 
 /**
- * Calculate MD5 hash from ArrayBuffer
+ * Unified file processing utilities
+ * Converts Files directly to ProcessedFiles
  */
-declare function calculateMD5(buffer: ArrayBuffer): Promise<string>;
+
 /**
  * Format file size to human-readable string
+ * Re-exported from Ship SDK for convenience
  */
-declare function formatFileSize(bytes: number, decimals?: number): string;
+declare const formatFileSize: typeof formatFileSize$1;
 /**
  * Create a ProcessedFile from a File object
  * This is the single conversion point from File to ProcessedFile
  *
+ * Note: MD5 calculation is handled by Ship SDK during deployment.
+ * Drop focuses on file processing, path normalization, and UI state management.
+ *
  * Path resolution priority:
  * 1. options.path (if provided)
  * 2. file.webkitRelativePath (if non-empty, preserves folder structure)
@@ -124,30 +119,12 @@ declare function formatFileSize(bytes: number, decimals?: number): string;
 declare function createProcessedFile(file: File, options?: {
     /** Custom path (defaults to webkitRelativePath or file.name) */
     path?: string;
-    /** Whether to calculate MD5 hash (defaults to true) */
-    calculateMD5?: boolean;
 }): Promise<ProcessedFile>;
-/**
- * Validate and update status of ProcessedFiles
- * Returns files with updated status and validation error if any
- */
-interface ValidationResult {
-    /** All files with updated status */
-    files: ProcessedFile[];
-    /** Files that passed validation (status: READY) */
-    validFiles: ProcessedFile[];
-    /** Validation error if any files failed */
-    error: ClientError | null;
-}
-declare function validateFiles(files: ProcessedFile[], config: ValidationConfig): ValidationResult;
 /**
  * Get only the valid files (status: READY) from a list
+ * Re-exported from Ship SDK for convenience
  */
-declare function getValidFiles(files: ProcessedFile[]): ProcessedFile[];
-/**
- * Check if all valid files have MD5 checksums calculated
- */
-declare function allValidFilesHaveChecksums(files: ProcessedFile[]): boolean;
+declare const getValidFiles: (files: ProcessedFile[]) => ProcessedFile[];
 /**
  * Strip common directory prefix from file paths
  * Only strips if ALL files share the same prefix
@@ -197,4 +174,4 @@ declare function isJunkFile(path: string): boolean;
  */
 declare function isZipFile(file: File): boolean;
 
-export { type ClientError, DEFAULT_VALIDATION, type DropOptions, type DropReturn, FILE_STATUSES, type FileStatus, type ProcessedFile, type ValidationConfig, type ValidationResult, type ZipExtractionResult, allValidFilesHaveChecksums, calculateMD5, createProcessedFile, extractZipToFiles, formatFileSize, getValidFiles, isJunkFile, isZipFile, normalizePath, stripCommonPrefix, useDrop, validateFiles };
+export { type ClientError, type DropOptions, type DropReturn, FILE_STATUSES, type FileStatus, type ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, formatFileSize, getValidFiles, isJunkFile, isZipFile, normalizePath, stripCommonPrefix, useDrop };