@shipstatic/drop 1.0.3 → 2.0.0-beta.0

package/dist/index.d.cts

@@ -1,74 +1,35 @@
-import { P as ProcessedFile } from './useDrop-BAYclQ_x.cjs';
-export { C as ClientError, D as DropOptions, a as DropReturn, b as DropState, c as DropStateValue, d as DropStatus, e as DropzonePropsOptions, F as FILE_STATUSES, f as FileStatus, u as useDrop } from './useDrop-BAYclQ_x.cjs';
-export { formatFileSize } from '@shipstatic/ship';
+import { PlatformLimits } from '@shipstatic/types';
+import { P as ProcessedFile, D as DropStatus } from './useDrop-Bmjfjp_o.cjs';
+export { a as DropOptions, b as DropPhase, c as DropReturn, d as DropzonePropsOptions, u as useDrop } from './useDrop-Bmjfjp_o.cjs';
+import '@shipstatic/ship';
 
+interface ProcessFilesOptions {
+    /** Platform limits, from `ship.getLimits()` */
+    limits: PlatformLimits;
+    /** Progress reporter for long steps */
+    onStatus?: (status: DropStatus) => void;
+}
 /**
- * Patch a File's `webkitRelativePath` so downstream consumers (the Ship SDK)
- * read our resolved deploy path. Browser-set `webkitRelativePath` is read-only,
- * so we redefine the property — `configurable: true` allows re-patching later.
- */
-declare function setRelativePath(file: File, path: string): void;
-/**
- * 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)
- * 3. file.name (fallback)
- */
-declare function createProcessedFile(file: File, options?: {
-    /** Custom path (defaults to webkitRelativePath or file.name) */
-    path?: string;
-}): ProcessedFile;
-/**
- * Strip common directory prefix from file paths.
+ * The verdict. Mirrors the hook's state minus `isDragging`, which is a pointer
+ * concern the pipeline knows nothing about.
  *
- * Delegates the path algorithm to Ship SDK's `optimizeDeployPaths` (the single
- * source of truth for deploy-path normalization) and mutates each underlying
- * File's `webkitRelativePath` so downstream consumers (Ship SDK) read the
- * stripped path when given the raw File objects.
- */
-declare function stripCommonPrefix(files: ProcessedFile[]): ProcessedFile[];
-/**
- * Recursively traverse FileSystemEntry from drag & drop to collect all files
- * Properly sets webkitRelativePath to preserve folder structure
- */
-declare function traverseFileTree(entry: FileSystemEntry, files: File[], currentPath?: string): Promise<void>;
-
-interface ZipExtractionResult {
-    /** Extracted files as regular File objects */
-    files: File[];
-    /** Any errors encountered during extraction */
-    errors: string[];
+ * Ready files are `files.filter(f => f.status === FileValidationStatus.READY)` — kept as
+ * one derivation rather than a second field that could disagree with the first.
+ */
+interface DropOutcome {
+    phase: 'ready' | 'error';
+    files: ProcessedFile[];
+    sourceName: string;
+    status: DropStatus;
+    needsBuild: boolean;
 }
 /**
- * Extracts all files from a ZIP archive
- * Returns regular File objects that can be processed like any other file
- */
-declare function extractZipToFiles(zipFile: File): Promise<ZipExtractionResult>;
-/**
- * Sanitize and normalize a file path to prevent directory traversal attacks
- * Removes: .., ., leading/trailing slashes, absolute paths, and empty segments
+ * Run the pipeline.
  *
- * @example
- * normalizePath('../../etc/passwd') → 'etc/passwd'
- * normalizePath('foo/./bar/../baz.txt') → 'foo/baz.txt'
- * normalizePath('/absolute/path.txt') → 'absolute/path.txt'
- */
-declare function normalizePath(path: string): string;
-/**
- * Check if a file is a ZIP file based on MIME type or extension
- */
-declare function isZipFile(file: File): boolean;
-
-/**
- * Get MIME type from file path (browser-compatible, no Node.js dependencies)
- * Returns empty string if extension not found, allowing fallback to browser detection
+ * Never throws: an unbuilt project rejected by `filterJunk`, a missing entry
+ * point, a file over the limit, and an unexpected host-object failure all come
+ * back as an `error` outcome. Callers need no try/catch.
  */
-declare function getMimeType(path: string): string;
+declare function processFiles(input: File[], { limits, onStatus }: ProcessFilesOptions): Promise<DropOutcome>;
 
-export { ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, getMimeType, isZipFile, normalizePath, setRelativePath, stripCommonPrefix, traverseFileTree };
+export { type DropOutcome, DropStatus, type ProcessFilesOptions, ProcessedFile, processFiles };

package/dist/index.d.ts

@@ -1,74 +1,35 @@
-import { P as ProcessedFile } from './useDrop-BAYclQ_x.js';
-export { C as ClientError, D as DropOptions, a as DropReturn, b as DropState, c as DropStateValue, d as DropStatus, e as DropzonePropsOptions, F as FILE_STATUSES, f as FileStatus, u as useDrop } from './useDrop-BAYclQ_x.js';
-export { formatFileSize } from '@shipstatic/ship';
+import { PlatformLimits } from '@shipstatic/types';
+import { P as ProcessedFile, D as DropStatus } from './useDrop-Bmjfjp_o.js';
+export { a as DropOptions, b as DropPhase, c as DropReturn, d as DropzonePropsOptions, u as useDrop } from './useDrop-Bmjfjp_o.js';
+import '@shipstatic/ship';
 
+interface ProcessFilesOptions {
+    /** Platform limits, from `ship.getLimits()` */
+    limits: PlatformLimits;
+    /** Progress reporter for long steps */
+    onStatus?: (status: DropStatus) => void;
+}
 /**
- * Patch a File's `webkitRelativePath` so downstream consumers (the Ship SDK)
- * read our resolved deploy path. Browser-set `webkitRelativePath` is read-only,
- * so we redefine the property — `configurable: true` allows re-patching later.
- */
-declare function setRelativePath(file: File, path: string): void;
-/**
- * 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)
- * 3. file.name (fallback)
- */
-declare function createProcessedFile(file: File, options?: {
-    /** Custom path (defaults to webkitRelativePath or file.name) */
-    path?: string;
-}): ProcessedFile;
-/**
- * Strip common directory prefix from file paths.
+ * The verdict. Mirrors the hook's state minus `isDragging`, which is a pointer
+ * concern the pipeline knows nothing about.
  *
- * Delegates the path algorithm to Ship SDK's `optimizeDeployPaths` (the single
- * source of truth for deploy-path normalization) and mutates each underlying
- * File's `webkitRelativePath` so downstream consumers (Ship SDK) read the
- * stripped path when given the raw File objects.
- */
-declare function stripCommonPrefix(files: ProcessedFile[]): ProcessedFile[];
-/**
- * Recursively traverse FileSystemEntry from drag & drop to collect all files
- * Properly sets webkitRelativePath to preserve folder structure
- */
-declare function traverseFileTree(entry: FileSystemEntry, files: File[], currentPath?: string): Promise<void>;
-
-interface ZipExtractionResult {
-    /** Extracted files as regular File objects */
-    files: File[];
-    /** Any errors encountered during extraction */
-    errors: string[];
+ * Ready files are `files.filter(f => f.status === FileValidationStatus.READY)` — kept as
+ * one derivation rather than a second field that could disagree with the first.
+ */
+interface DropOutcome {
+    phase: 'ready' | 'error';
+    files: ProcessedFile[];
+    sourceName: string;
+    status: DropStatus;
+    needsBuild: boolean;
 }
 /**
- * Extracts all files from a ZIP archive
- * Returns regular File objects that can be processed like any other file
- */
-declare function extractZipToFiles(zipFile: File): Promise<ZipExtractionResult>;
-/**
- * Sanitize and normalize a file path to prevent directory traversal attacks
- * Removes: .., ., leading/trailing slashes, absolute paths, and empty segments
+ * Run the pipeline.
  *
- * @example
- * normalizePath('../../etc/passwd') → 'etc/passwd'
- * normalizePath('foo/./bar/../baz.txt') → 'foo/baz.txt'
- * normalizePath('/absolute/path.txt') → 'absolute/path.txt'
- */
-declare function normalizePath(path: string): string;
-/**
- * Check if a file is a ZIP file based on MIME type or extension
- */
-declare function isZipFile(file: File): boolean;
-
-/**
- * Get MIME type from file path (browser-compatible, no Node.js dependencies)
- * Returns empty string if extension not found, allowing fallback to browser detection
+ * Never throws: an unbuilt project rejected by `filterJunk`, a missing entry
+ * point, a file over the limit, and an unexpected host-object failure all come
+ * back as an `error` outcome. Callers need no try/catch.
  */
-declare function getMimeType(path: string): string;
+declare function processFiles(input: File[], { limits, onStatus }: ProcessFilesOptions): Promise<DropOutcome>;
 
-export { ProcessedFile, type ZipExtractionResult, createProcessedFile, extractZipToFiles, getMimeType, isZipFile, normalizePath, setRelativePath, stripCommonPrefix, traverseFileTree };
+export { type DropOutcome, DropStatus, type ProcessFilesOptions, ProcessedFile, processFiles };