@shipstatic/ship 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 shipstatic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,495 @@
+# Ship CLI & SDK
+
+A modern, lightweight SDK and CLI for deploying static files, designed for both **Node.js** and **Browser** environments with a clean resource-based API.
+
+## Features
+
+- **🚀 Modern Resource API**: Clean `ship.deployments.create()` interface - no legacy wrappers
+- **🌍 Universal**: Automatic environment detection (Node.js/Browser) with optimized implementations  
+- **🔧 Dynamic Configuration**: Automatically fetches platform limits from API
+- **📁 Flexible Input**: File paths (Node.js) or File objects (Browser/drag-drop)
+- **🔐 Secure**: MD5 checksums and data integrity validation
+- **📊 Progress Tracking**: Real-time deployment progress and statistics
+- **⚡ Cancellable**: AbortSignal support for deployment cancellation
+- **🛠️ CLI Ready**: Command-line interface for automation and CI/CD
+- **📦 Bundle Optimized**: Lightweight builds (16KB Node, 275KB Browser)
+- **🎯 Unified Error System**: Consistent `ShipError` handling across all components
+
+## Installation
+
+### CLI Usage
+
+```bash
+npm install -g @shipstatic/ship
+```
+
+### SDK Usage
+
+```bash
+npm install @shipstatic/ship
+```
+
+## Quick Start
+
+### SDK Usage
+
+```typescript
+import { Ship } from '@shipstatic/ship';
+
+const ship = new Ship({
+  apiUrl: 'https://api.shipstatic.com',
+  apiKey: 'ship-your-64-char-hex-string'  // API key: ship- prefix + 64-char hex (69 chars total)
+});
+
+// Deploy files - SDK automatically fetches platform configuration
+const result = await ship.deployments.create(['./dist'], {
+  onProgress: (progress) => console.log(`${progress}%`)
+});
+
+console.log(`Deployed: ${result.deployment}`);
+```
+
+### CLI Usage
+
+```bash
+# Deploy shortcut - deploy a directory
+ship ./dist
+
+# Or deploy current directory
+ship
+
+# Explicit commands
+ship deploy ./build          # Deploy files from path
+ship list                    # List deployments
+ship get abc123              # Get deployment details
+ship remove abc123           # Remove deployment
+
+# Manage aliases
+ship aliases                 # List aliases
+ship alias staging abc123    # Set alias to deployment
+
+# Account
+ship account                 # Get account details
+
+# Connectivity
+ship ping                    # Check API connectivity
+```
+
+## Dynamic Platform Configuration
+
+Ship SDK automatically fetches platform configuration from the API on initialization:
+
+```typescript
+// SDK automatically calls GET /config and applies limits
+const ship = new Ship({ apiKey: 'ship-your-key' });
+
+// Platform limits are now available for validation:
+// - maxFileSize: Dynamic file size limit
+// - maxFilesCount: Dynamic file count limit  
+// - maxTotalSize: Dynamic total size limit
+```
+
+**Benefits:**
+- **Single source of truth** - Limits only need to be changed on the API side
+- **Automatic updates** - SDK always uses current platform limits
+- **Fail fast** - SDK fails if unable to fetch valid configuration
+
+## API Reference
+
+### Ship Class
+
+```typescript
+const ship = new Ship(options?: ShipOptions)
+```
+
+#### Options
+
+```typescript
+interface ShipOptions {
+  apiUrl?: string;        // API endpoint (default: https://api.shipstatic.com)
+  apiKey?: string;        // API key: ship- prefix + 64-char hex (69 chars total)
+  timeout?: number;       // Request timeout (ms)
+}
+```
+
+#### Methods
+
+- `ship.ping()` - Check API connectivity
+- `ship.deployments` - Access deployment resource
+- `ship.aliases` - Access alias resource  
+- `ship.account` - Access account resource
+
+### Deployments Resource
+
+```typescript
+// Deploy files
+await ship.deployments.create(input, options?)
+
+// List deployments
+await ship.deployments.list()
+
+// Remove deployment
+await ship.deployments.remove(id)
+
+// Get deployment details
+await ship.deployments.get(id)
+```
+
+#### Deploy Input Types
+
+**Node.js Environment:**
+```typescript
+type NodeDeployInput = string[];  // File paths
+```
+
+**Browser Environment:**
+```typescript
+type BrowserDeployInput = FileList | File[] | HTMLInputElement;
+```
+
+#### Deploy Options
+
+```typescript
+interface DeployOptions {
+  apiUrl?: string;
+  apiKey?: string;                  // API key: ship- prefix + 64-char hex (69 chars total)
+  signal?: AbortSignal;           // Cancellation
+  subdomain?: string;             // Custom subdomain
+  onCancel?: () => void;
+  onProgress?: (progress: number) => void;
+  progress?: (stats: ProgressStats) => void;
+  maxConcurrency?: number;
+  timeout?: number;
+  stripCommonPrefix?: boolean;    // Remove common path prefix
+}
+```
+
+### Environment-Specific Examples
+
+#### Node.js File Deployment
+
+```typescript
+import { Ship } from '@shipstatic/ship';
+
+const ship = new Ship({
+  apiUrl: 'https://api.shipstatic.com',
+  apiKey: process.env.SHIP_API_KEY  // ship-abc123...
+});
+
+// Deploy files and directories
+const result = await ship.deployments.create([
+  './dist/index.html',
+  './dist/assets',
+  './public'
+], {
+  stripCommonPrefix: true,
+  onProgress: (progress) => {
+    console.log(`Deployment: ${progress}% complete`);
+  }
+});
+
+console.log(`✅ Deployed: ${result.deployment}`);
+```
+
+#### Browser File Upload
+
+```typescript
+import { Ship } from '@shipstatic/ship';
+
+const ship = new Ship({
+  apiUrl: 'https://api.shipstatic.com',
+  apiKey: 'ship-your-64-char-hex-string'  // 69 chars total
+});
+
+// From file input
+const fileInput = document.getElementById('fileInput') as HTMLInputElement;
+const result = await ship.deployments.create(fileInput, {
+  onProgress: (progress) => {
+    document.getElementById('progress').textContent = `${progress}%`;
+  }
+});
+
+// From File objects
+const files: File[] = Array.from(fileInput.files || []);
+const result2 = await ship.deployments.create(files);
+```
+
+## Unified Error Handling
+
+The Ship SDK uses a unified error system with a single `ShipError` class:
+
+```typescript
+import { ShipError } from '@shipstatic/ship';
+
+try {
+  await ship.deployments.create(['./dist']);
+} catch (error) {
+  if (error instanceof ShipError) {
+    console.error(`Ship Error: ${error.message}`);
+    
+    // Type-safe error checking
+    if (error.isClientError()) {
+      console.error(`Client Error: ${error.message}`);
+    } else if (error.isNetworkError()) {
+      console.error(`Network Error: ${error.message}`);
+    } else if (error.isAuthError()) {
+      console.error(`Auth Error: ${error.message}`);
+    } else if (error.isValidationError()) {
+      console.error(`Validation Error: ${error.message}`);
+    }
+  }
+}
+```
+
+### Error Types
+
+```typescript
+// Factory methods for creating errors
+ShipError.validation(message, details)    // Validation failed (400)
+ShipError.notFound(resource, id)          // Resource not found (404)
+ShipError.rateLimit(message)              // Rate limit exceeded (429)
+ShipError.authentication(message)         // Authentication required (401)
+ShipError.business(message, status)       // Business logic error (400)
+ShipError.network(message, cause)         // Network/connection error
+ShipError.cancelled(message)              // Operation was cancelled
+ShipError.file(message, filePath)         // File operation error
+ShipError.config(message)                 // Configuration error
+
+// Type checking methods
+error.isClientError()       // Client-side errors
+error.isNetworkError()      // Network/connection issues
+error.isAuthError()         // Authentication problems
+error.isValidationError()   // Input validation failures
+error.isFileError()         // File operation errors
+error.isConfigError()       // Configuration problems
+```
+
+## Authentication
+
+The Ship SDK uses **Bearer token authentication** with API keys that have a `ship-` prefix:
+
+```typescript
+const ship = new Ship({
+  apiKey: 'ship-1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
+});
+```
+
+### API Requests
+
+The SDK automatically sends API keys using standard Bearer token format:
+
+```
+Authorization: Bearer ship-your-64-char-hex-string  // 69 chars total
+```
+
+## Configuration
+
+Configuration is loaded hierarchically (highest precedence first):
+
+1. **Constructor options** - Direct parameters to `new Ship()`
+2. **Environment variables** - `SHIP_API_URL`, `SHIP_API_KEY` (Node.js only)  
+3. **Config files** - `.shiprc` or `package.json` (ship key) in project directory (Node.js only)
+
+### Config File Format
+
+**.shiprc:**
+```json
+{
+  "apiUrl": "https://api.shipstatic.com",
+  "apiKey": "ship-your-api-key"
+}
+```
+
+**package.json:**
+```json
+{
+  "ship": {
+    "apiUrl": "https://api.shipstatic.com",
+    "apiKey": "ship-your-api-key"
+  }
+}
+```
+
+### Environment Variables
+
+```bash
+export SHIP_API_URL="https://api.shipstatic.com"
+export SHIP_API_KEY="ship-your-api-key"
+```
+
+## CLI Commands
+
+### Deployment Commands
+
+```bash
+ship                    # List deployments (no args)
+ship ./dist             # Deploy specific directory  
+ship deploy ./build     # Explicit deploy command
+ship list               # List deployments
+ship get abc123         # Get deployment details
+ship remove abc123      # Remove deployment
+```
+
+### Alias Commands
+
+```bash
+ship aliases            # List aliases
+ship alias staging abc123  # Set alias to deployment
+```
+
+### Account Commands
+
+```bash
+ship account            # Get account details
+```
+
+### Global Options
+
+```bash
+-u, --apiUrl <URL>     # API endpoint
+-k, --apiKey <KEY>    # API key  
+--json              # JSON output
+```
+
+## Bundle Sizes
+
+**Optimized for production:**
+- **Node.js**: 16KB (ESM), 17KB (CJS)
+- **Browser**: 275KB (ESM with dependencies)
+- **CLI**: 25KB (CJS)
+
+**Recent Optimizations:**
+- ✅ **Unified error system** - Single `ShipError` class for all components
+- ✅ **Dynamic platform configuration** - Fetches limits from API
+- ✅ **Replaced axios with native fetch** - Bundle size reduction
+- ✅ **Simplified configuration loading** - Removed async complexity
+- ✅ **Streamlined multipart uploads** - `files[]` + JSON checksums format
+- ✅ **Direct validation throwing** - Eliminated verbose ValidationResult pattern
+
+## TypeScript Support
+
+Full TypeScript support with exported types from shared `@shipstatic/types`:
+
+```typescript
+import type { 
+  ShipOptions,
+  NodeDeployInput,
+  BrowserDeployInput, 
+  DeployOptions,
+  DeploySuccessResponse,
+  ProgressStats,
+  StaticFile,
+  ShipError,
+  ErrorType
+} from '@shipstatic/ship';
+```
+
+## Architecture
+
+### Modern SDK Design
+- **Class-based API**: `new Ship()` with resource properties
+- **Environment detection**: Automatic Node.js/Browser optimizations
+- **Native dependencies**: Uses built-in `fetch`, `crypto`, and `fs` APIs
+- **Type safety**: Strict TypeScript with comprehensive error types
+- **Dynamic configuration**: Platform limits fetched from API
+- **Unified DTOs**: Shared type definitions from `@shipstatic/types`
+
+### Codebase Organization
+```
+src/
+├── core/                    # Cross-cutting concerns
+│   ├── config.ts           # Configuration loading and merging
+│   └── constants.ts        # Platform constants and defaults
+├── lib/                    # Utility libraries (renamed from utils/)
+│   ├── env.js              # Environment detection
+│   ├── node-files.ts       # Node.js file system operations
+│   ├── prepare-input.ts    # Input preparation (renamed from input-conversion.ts)
+│   └── path.ts             # Path utilities (renamed from path-helpers.ts)
+├── cli.ts                  # CLI implementation (moved from cli/index.ts)
+├── index.ts                # Main SDK exports
+└── types.ts                # All SDK types (consolidated from types/)
+
+### File Processing Pipeline
+**Node.js:**
+```
+File Paths → Discovery → Junk Filtering → Base Directory → Content Processing → StaticFile[]
+```
+
+**Browser:**
+```
+File Objects → Path Extraction → Junk Filtering → Content Processing → StaticFile[]
+```
+
+### Configuration System
+- **Synchronous loading**: No async complexity for file config
+- **Dynamic platform config**: Fetched from API on first use
+- **Minimal search**: Only `.shiprc` and `package.json`
+- **Simple validation**: Native type checking
+- **Environment variables**: `SHIP_*` prefix for clarity
+
+### Error System Architecture
+- **Single source of truth**: All errors use `ShipError` from `@shipstatic/types`
+- **Type-safe factories**: Specific factory methods for each error type
+- **Wire format support**: Automatic serialization/deserialization
+- **Helper methods**: Easy type checking with `is*Error()` methods
+
+## Development Status
+
+This is an **unlaunched project** optimized for modern development:
+
+- ✅ **Deployment Resource**: Full implementation (create, list, get, remove)
+- ✅ **Alias Resource**: Full implementation (set, get, list, remove)  
+- ✅ **Account Resource**: Full implementation (get account details)
+- ✅ **Unified Error System**: Single `ShipError` class with factory methods
+- ✅ **Dynamic Platform Config**: Automatic limit fetching from API
+- ✅ **Ultra-Simple CLI**: Deploy shortcut + explicit commands
+- ✅ **Streamlined Multipart**: `files[]` array + JSON checksums format
+- ✅ **Direct Validation**: Functions throw errors instead of returning results
+- ✅ **Shared DTOs**: All types from `@shipstatic/types` package
+- ✅ **Impossible Simplicity**: Maximum functionality with minimal complexity
+- 🎯 No legacy compatibility constraints
+- 🔧 Native fetch API for optimal performance
+- ⚡ Modern ESM modules with TypeScript
+
+## Testing
+
+Comprehensive test coverage with modern tooling:
+
+```bash
+# Run all tests
+pnpm test --run
+
+# Run specific test suites
+pnpm test tests/utils/node-files.test.ts --run
+pnpm test tests/api/http.test.ts --run
+
+# Build and test
+pnpm build && pnpm test --run
+```
+
+**Test Organization:**
+- **Unit tests**: Pure function testing
+- **Integration tests**: Component interaction testing  
+- **Edge case tests**: Boundary condition testing
+- **Browser tests**: FileList and File object handling
+- **Node.js tests**: Filesystem and path manipulation
+- **Error tests**: Unified error handling patterns
+
+**Current Status:** 264 tests passing ✅
+
+## Contributing
+
+The codebase prioritizes simplicity and maintainability:
+
+- **"Do More with Less"** - Built-in over dependencies
+- **No backward compatibility** constraints
+- **Modern ES modules** and TypeScript
+- **Comprehensive test coverage**
+- **Clean resource-based** architecture
+- **Unified error handling** across all components
+- **Shared type system** via `@shipstatic/types`
+- **Declarative code patterns** over imperative complexity
+
+---
+
+**Ship** - Deploy static files with modern tooling ⚡

package/dist/browser-files-57AJ3XWD.js

@@ -0,0 +1,2 @@
+import{e as a,f as b}from"./chunk-6KASX3WY.js";import"./chunk-OJ6FY5CZ.js";export{b as findBrowserCommonParentDirectory,a as processFilesForBrowser};
+//# sourceMappingURL=browser-files-57AJ3XWD.js.map

package/dist/browser-files-57AJ3XWD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/browser-files-DMOO6YMM.browser.js

@@ -0,0 +1,2 @@
+import{e as a,f as b}from"./chunk-WJA55FEC.browser.js";import"./chunk-Z566D7DF.browser.js";import"./chunk-KBFFWP3K.browser.js";export{b as findBrowserCommonParentDirectory,a as processFilesForBrowser};
+//# sourceMappingURL=browser-files-DMOO6YMM.browser.js.map

package/dist/browser-files-DMOO6YMM.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-6KASX3WY.js

@@ -0,0 +1,2 @@
+import{e as v,h as w}from"./chunk-OJ6FY5CZ.js";var g=null;function S(e){g=e}function b(){return typeof process<"u"&&process.versions&&process.versions.node?"node":typeof window<"u"||typeof self<"u"?"browser":"unknown"}function p(){return g||b()}import{ShipError as u}from"@shipstatic/types";async function E(e){let n=(await import("spark-md5")).default;return new Promise((o,s)=>{let f=Math.ceil(e.size/2097152),r=0,l=new n.ArrayBuffer,m=new FileReader,d=()=>{let c=r*2097152,t=Math.min(c+2097152,e.size);m.readAsArrayBuffer(e.slice(c,t))};m.onload=c=>{let t=c.target?.result;if(!t){s(u.business("Failed to read file chunk"));return}l.append(t),r++,r<f?d():o({md5:l.end()})},m.onerror=()=>{s(u.business("Failed to calculate MD5: FileReader error"))},d()})}async function P(e){let n=await import("crypto");if(Buffer.isBuffer(e)){let s=n.createHash("md5");return s.update(e),{md5:s.digest("hex")}}let o=await import("fs");return new Promise((s,a)=>{let f=n.createHash("md5"),r=o.createReadStream(e);r.on("error",l=>a(u.business(`Failed to read file for MD5: ${l.message}`))),r.on("data",l=>f.update(l)),r.on("end",()=>s({md5:f.digest("hex")}))})}async function y(e){let n=p();if(n==="browser"){if(!(e instanceof Blob))throw u.business("Invalid input for browser MD5 calculation: Expected Blob or File.");return E(e)}if(n==="node"){if(!(Buffer.isBuffer(e)||typeof e=="string"))throw u.business("Invalid input for Node.js MD5 calculation: Expected Buffer or file path string.");return P(e)}throw u.business("Unknown or unsupported execution environment for MD5 calculation.")}import{ShipError as B}from"@shipstatic/types";import{isJunk as D}from"junk";var k=["__MACOSX",".Trashes",".fseventsd",".Spotlight-V100"];function x(e){return!e||e.length===0?[]:e.filter(n=>{if(!n)return!1;let o=n.replace(/\\/g,"/").split("/").filter(Boolean);if(o.length===0)return!0;let s=o[o.length-1];if(D(s))return!1;let a=o.slice(0,-1);for(let f of a)if(k.some(r=>f.toLowerCase()===r.toLowerCase()))return!1;return!0})}async function H(e,n={}){if(p()!=="browser")throw B.business("processFilesForBrowser can only be called in a browser environment.");let{explicitBaseDirInput:o,stripCommonPrefix:s}=n,a=[],f=Array.isArray(e)?e:Array.from(e),r="";s?r=F(e):o&&(r=o);for(let t of f){let i=t.webkitRelativePath||t.name;if(r){i=w(i);let h=r.endsWith("/")?r:`${r}/`;(i===r||i===h||i.startsWith(h))&&(i=i.substring(h.length))}i=w(i),a.push({file:t,relativePath:i})}let l=a.map(t=>t.relativePath),m=x(l),d=new Set(m),c=[];for(let t of a){if(!d.has(t.relativePath)||t.file.size===0)continue;let{md5:i}=await y(t.file);c.push({content:t.file,path:t.relativePath,size:t.file.size,md5:i})}return c}function F(e){if(p()!=="browser")throw B.business("findBrowserCommonParentDirectory can only be called in a browser environment.");if(!e||e.length===0)return"";let n=Array.from(e).map(o=>o.webkitRelativePath);return n.some(o=>!o)?"":v(n,"/")}export{S as a,p as b,y as c,x as d,H as e,F as f};
+//# sourceMappingURL=chunk-6KASX3WY.js.map

package/dist/chunk-6KASX3WY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/env.ts","../src/lib/md5.ts","../src/lib/browser-files.ts","../src/lib/junk.ts"],"sourcesContent":["/**\n * @file Environment detection utilities for the Ship SDK.\n * Helps in determining whether the SDK is running in a Node.js, browser, or unknown environment.\n */\n\n/**\n * Represents the detected or simulated JavaScript execution environment.\n */\nexport type ExecutionEnvironment = 'browser' | 'node' | 'unknown';\n\n/** @internal Environment override for testing. */\nlet _testEnvironment: ExecutionEnvironment | null = null;\n\n/**\n * **FOR TESTING PURPOSES ONLY.**\n *\n * Allows tests to override the detected environment, forcing the SDK to behave\n * as if it's running in the specified environment.\n *\n * @param env - The environment to simulate ('node', 'browser', 'unknown'),\n *              or `null` to clear the override and revert to actual environment detection.\n * @internal\n */\nexport function __setTestEnvironment(env: ExecutionEnvironment | null): void {\n  _testEnvironment = env;\n}\n\n/**\n * Detects the actual JavaScript execution environment (Node.js, browser, or unknown)\n * by checking for characteristic global objects.\n * @returns The detected environment as {@link ExecutionEnvironment}.\n * @internal\n */\nfunction detectEnvironment(): ExecutionEnvironment {\n  // Check for Node.js environment\n  if (typeof process !== 'undefined' && process.versions && process.versions.node) {\n    return 'node';\n  }\n\n  // Check for Browser environment (including Web Workers)\n  if (typeof window !== 'undefined' || typeof self !== 'undefined') {\n    return 'browser';\n  }\n\n  return 'unknown';\n}\n\n/**\n * Gets the current effective execution environment.\n *\n * This function first checks if a test environment override is active via {@link __setTestEnvironment}.\n * If not, it detects the actual environment (Node.js, browser, or unknown).\n *\n * @returns The current execution environment: 'browser', 'node', or 'unknown'.\n * @public\n */\nexport function getENV(): ExecutionEnvironment {\n  // Return test override if set\n  if (_testEnvironment) {\n    return _testEnvironment;\n  }\n  \n  // Detect actual environment\n  return detectEnvironment();\n}\n","/**\n * @file Simplified MD5 calculation utility with separate environment handlers.\n */\nimport { getENV } from './env';\nimport { ShipError } from '@shipstatic/types';\n\nexport interface MD5Result {\n  md5: string;\n}\n\n/**\n * Browser-specific MD5 calculation for Blob/File objects\n */\nasync function calculateMD5Browser(blob: Blob): Promise<MD5Result> {\n  const SparkMD5 = (await import('spark-md5')).default;\n  \n  return new Promise((resolve, reject) => {\n    const chunkSize = 2097152; // 2MB chunks\n    const chunks = Math.ceil(blob.size / chunkSize);\n    let currentChunk = 0;\n    const spark = new SparkMD5.ArrayBuffer();\n    const fileReader = new FileReader();\n\n    const loadNext = () => {\n      const start = currentChunk * chunkSize;\n      const end = Math.min(start + chunkSize, blob.size);\n      fileReader.readAsArrayBuffer(blob.slice(start, end));\n    };\n\n    fileReader.onload = (e) => {\n      const result = e.target?.result as ArrayBuffer;\n      if (!result) {\n        reject(ShipError.business('Failed to read file chunk'));\n        return;\n      }\n      \n      spark.append(result);\n      currentChunk++;\n      \n      if (currentChunk < chunks) {\n        loadNext();\n      } else {\n        resolve({ md5: spark.end() });\n      }\n    };\n\n    fileReader.onerror = () => {\n      reject(ShipError.business('Failed to calculate MD5: FileReader error'));\n    };\n\n    loadNext();\n  });\n}\n\n/**\n * Node.js-specific MD5 calculation for Buffer or file path\n */\nasync function calculateMD5Node(input: Buffer | string): Promise<MD5Result> {\n  const crypto = await import('crypto');\n  \n  if (Buffer.isBuffer(input)) {\n    const hash = crypto.createHash('md5');\n    hash.update(input);\n    return { md5: hash.digest('hex') };\n  }\n  \n  // Handle file path\n  const fs = await import('fs');\n  return new Promise((resolve, reject) => {\n    const hash = crypto.createHash('md5');\n    const stream = fs.createReadStream(input);\n    \n    stream.on('error', err => \n      reject(ShipError.business(`Failed to read file for MD5: ${err.message}`))\n    );\n    stream.on('data', chunk => hash.update(chunk));\n    stream.on('end', () => resolve({ md5: hash.digest('hex') }));\n  });\n}\n\n/**\n * Unified MD5 calculation that delegates to environment-specific handlers\n */\nexport async function calculateMD5(input: Blob | Buffer | string): Promise<MD5Result> {\n  const env = getENV();\n  \n  if (env === 'browser') {\n    if (!(input instanceof Blob)) {\n      throw ShipError.business('Invalid input for browser MD5 calculation: Expected Blob or File.');\n    }\n    return calculateMD5Browser(input);\n  }\n  \n  if (env === 'node') {\n    if (!(Buffer.isBuffer(input) || typeof input === 'string')) {\n      throw ShipError.business('Invalid input for Node.js MD5 calculation: Expected Buffer or file path string.');\n    }\n    return calculateMD5Node(input);\n  }\n  \n  throw ShipError.business('Unknown or unsupported execution environment for MD5 calculation.');\n}\n","/**\n * @file Browser-specific file utilities for the Ship SDK.\n * Provides helpers for processing browser files into deploy-ready objects and extracting common directory info.\n */\nimport { getENV } from './env.js';\nimport { StaticFile } from '../types.js';\nimport { calculateMD5 } from './md5.js';\nimport { ShipError } from '@shipstatic/types';\nimport { findCommonParentDirectory, normalizeWebPath } from './path.js';\nimport { filterJunk } from './junk.js';\n\n\n/**\n * Internal structure representing a browser file to be processed for deploy.\n * @internal\n */\ninterface BrowserFileProcessItem {\n  file: File;\n  relativePath: string;\n}\n\n/**\n * Processes browser files (FileList or File[]) into an array of StaticFile objects ready for deploy.\n * Calculates MD5, filters junk files, and determines relative paths (stripping basePath if provided).\n *\n * @param browserFiles - FileList or File[] to process for deploy.\n * @param options - Optional processing options (basePath for path stripping, stripCommonPrefix).\n * @returns Promise resolving to an array of StaticFile objects.\n * @throws {ShipClientError} If called outside a browser or with invalid input.\n */\nexport async function processFilesForBrowser(\n  browserFiles: FileList | File[],\n  options: { explicitBaseDirInput?: string; stripCommonPrefix?: boolean } = {}\n): Promise<StaticFile[]> {\n  if (getENV() !== 'browser') {\n    throw ShipError.business('processFilesForBrowser can only be called in a browser environment.');\n  }\n\n  const { explicitBaseDirInput, stripCommonPrefix } = options;\n  const initialFileInfos: BrowserFileProcessItem[] = [];\n  const filesArray = Array.isArray(browserFiles) ? browserFiles : Array.from(browserFiles);\n  \n  // If stripCommonPrefix is true and no explicit basePath is provided,\n  // Determine the parent directory for path stripping if applicable\n  let parentDir = '';\n  if (stripCommonPrefix) {\n    parentDir = findBrowserCommonParentDirectory(browserFiles);\n  } else if (explicitBaseDirInput) {\n    parentDir = explicitBaseDirInput;\n  }\n\n  // Prepare the initial file information with appropriate relative paths\n  for (const file of filesArray) {\n    let relativePath = (file as any).webkitRelativePath || file.name;\n    if (parentDir) {\n      // Normalize all paths to use forward slashes\n      relativePath = normalizeWebPath(relativePath);\n      const basePathWithSlash = parentDir.endsWith('/') ? parentDir : `${parentDir}/`;\n      // Robustly strip deeply nested basePath prefix\n      if (relativePath === parentDir || relativePath === basePathWithSlash || relativePath.startsWith(basePathWithSlash)) {\n        relativePath = relativePath.substring(basePathWithSlash.length);\n      }\n    }\n    // Always normalize output path to forward slashes\n    relativePath = normalizeWebPath(relativePath);\n    initialFileInfos.push({ file, relativePath });\n  }\n\n  // Filter out junk files\n  const allRelativePaths = initialFileInfos.map(info => info.relativePath);\n  const nonJunkRelativePathsArray = filterJunk(allRelativePaths);\n  const nonJunkRelativePathsSet = new Set(nonJunkRelativePathsArray);\n\n  // Create StaticFile objects for each valid file\n  const result: StaticFile[] = [];\n  for (const fileInfo of initialFileInfos) {\n    // Skip junk files and empty files\n    if (!nonJunkRelativePathsSet.has(fileInfo.relativePath) || fileInfo.file.size === 0) {\n      continue;\n    }\n    \n    // Calculate MD5 hash\n    const { md5 } = await calculateMD5(fileInfo.file);\n    \n    // Create and add the StaticFile\n    result.push({\n      content: fileInfo.file,\n      path: fileInfo.relativePath,\n      size: fileInfo.file.size,\n      md5,\n    });\n  }\n  \n  return result;\n}\n\n/**\n * Finds the common parent directory from a FileList or File[] using webkitRelativePath.\n * Useful for stripping a common prefix if files are selected from a single folder.\n *\n * @param files - FileList or File[] to analyze.\n * @returns Common parent directory string, or empty string if not consistent.\n * @throws {ShipClientError} If called outside a browser.\n */\nexport function findBrowserCommonParentDirectory(files: FileList | File[]): string {\n  if (getENV() !== 'browser') {\n    throw ShipError.business('findBrowserCommonParentDirectory can only be called in a browser environment.');\n  }\n  if (!files || files.length === 0) return '';\n  \n  const paths: (string | null | undefined)[] = Array.from(files)\n    .map(file => (file as any).webkitRelativePath);\n\n  // If any file is missing webkitRelativePath, we can't determine a common parent.\n  if (paths.some(p => !p)) {\n    return '';\n  }\n\n  return findCommonParentDirectory(paths as string[], '/');\n}\n","/**\n * @file Utility for filtering out junk files and directories from file paths\n * \n * This module provides functionality to filter out common system junk files and directories\n * from a list of file paths. It uses the 'junk' package to identify junk filenames and\n * a custom list to filter out common junk directories.\n */\nimport { isJunk } from 'junk';\n\n/**\n * List of directory names considered as junk\n * \n * Files within these directories (at any level in the path hierarchy) will be excluded.\n * The comparison is case-insensitive for cross-platform compatibility.\n * \n * @internal\n */\nexport const JUNK_DIRECTORIES = [\n  '__MACOSX',\n  '.Trashes',\n  '.fseventsd',\n  '.Spotlight-V100',\n] as const;\n\n/**\n * Filters an array of file paths, removing those considered junk\n * \n * A path is filtered out if either:\n * 1. The basename is identified as junk by the 'junk' package (e.g., .DS_Store, Thumbs.db)\n * 2. Any directory segment in the path matches an entry in JUNK_DIRECTORIES (case-insensitive)\n *\n * All path separators are normalized to forward slashes for consistent cross-platform behavior.\n * \n * @param filePaths - An array of file path strings to filter\n * @returns A new array containing only non-junk file paths\n */\nexport function filterJunk(filePaths: string[]): string[] {\n  if (!filePaths || filePaths.length === 0) {\n    return [];\n  }\n\n  return filePaths.filter(filePath => {\n    if (!filePath) {\n      return false; // Exclude null or undefined paths\n    }\n\n    // Normalize path separators to forward slashes and split into segments\n    const parts = filePath.replace(/\\\\/g, '/').split('/').filter(Boolean);\n    if (parts.length === 0) return true;\n    \n    // Check if the basename is a junk file (using junk package)\n    const basename = parts[parts.length - 1];\n    if (isJunk(basename)) {\n      return false;\n    }\n\n    // Check if any directory segment is in our junk directories list\n    const directorySegments = parts.slice(0, -1);\n    for (const segment of directorySegments) {\n      if (JUNK_DIRECTORIES.some(junkDir => \n          segment.toLowerCase() === junkDir.toLowerCase())) {\n        return false;\n      }\n    }\n\n    return true;\n  });\n}\n"],"mappings":"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","names":["_testEnvironment","__setTestEnvironment","env","detectEnvironment","getENV","ShipError","calculateMD5Browser","blob","SparkMD5","resolve","reject","chunks","currentChunk","spark","fileReader","loadNext","start","end","e","result","calculateMD5Node","input","crypto","hash","fs","stream","err","chunk","calculateMD5","env","getENV","ShipError","isJunk","JUNK_DIRECTORIES","filterJunk","filePaths","filePath","parts","basename","directorySegments","segment","junkDir","processFilesForBrowser","browserFiles","options","getENV","ShipError","explicitBaseDirInput","stripCommonPrefix","initialFileInfos","filesArray","parentDir","findBrowserCommonParentDirectory","file","relativePath","normalizeWebPath","basePathWithSlash","allRelativePaths","info","nonJunkRelativePathsArray","filterJunk","nonJunkRelativePathsSet","result","fileInfo","md5","calculateMD5","files","paths","p","findCommonParentDirectory"]}

package/dist/chunk-KBFFWP3K.browser.js

@@ -0,0 +1,2 @@
+var i=Object.create;var g=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var l=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty;var h=a=>{throw TypeError(a)};var o=(a=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(a,{get:(b,c)=>(typeof require<"u"?require:b)[c]}):a)(function(a){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+a+'" is not supported')});var p=(a,b)=>()=>(b||a((b={exports:{}}).exports,b),b.exports);var e=(a,b,c,f)=>{if(b&&typeof b=="object"||typeof b=="function")for(let d of k(b))!m.call(a,d)&&d!==c&&g(a,d,{get:()=>b[d],enumerable:!(f=j(b,d))||f.enumerable});return a},q=(a,b,c)=>(e(a,b,"default"),c&&e(c,b,"default")),r=(a,b,c)=>(c=a!=null?i(l(a)):{},e(b||!a||!a.__esModule?g(c,"default",{value:a,enumerable:!0}):c,a));var n=(a,b,c)=>b.has(a)||h("Cannot "+c);var s=(a,b,c)=>b.has(a)?h("Cannot add the same private member more than once"):b instanceof WeakSet?b.add(a):b.set(a,c);var t=(a,b,c)=>(n(a,b,"access private method"),c);export{o as a,p as b,q as c,r as d,s as e,t as f};
+//# sourceMappingURL=chunk-KBFFWP3K.browser.js.map

package/dist/chunk-KBFFWP3K.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-OJ6FY5CZ.js

@@ -0,0 +1,2 @@
+var x=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var h=n=>{throw TypeError(n)};var g=(n=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(n,{get:(t,r)=>(typeof require<"u"?require:t)[r]}):n)(function(n){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+n+'" is not supported')});var a=(n,t,r,i)=>{if(t&&typeof t=="object"||typeof t=="function")for(let e of P(t))!p.call(n,e)&&e!==r&&x(n,e,{get:()=>t[e],enumerable:!(i=m(t,e))||i.enumerable});return n},b=(n,t,r)=>(a(n,t,"default"),r&&a(r,t,"default"));var y=(n,t,r)=>t.has(n)||h("Cannot "+r);var S=(n,t,r)=>t.has(n)?h("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(n):t.set(n,r);var q=(n,t,r)=>(y(n,t,"access private method"),r);function d(n,t){if(!n||!Array.isArray(n)||n.length===0)return"";let r=n.filter(o=>o&&typeof o=="string"&&o.includes(t));if(r.length===0)return"";if(r.length===1){let o=r[0],c=o.lastIndexOf(t);return c>-1?o.substring(0,c):""}let i=[...r].sort(),e=i[0],l=i[i.length-1],s=0;for(;s<e.length&&s<l.length&&e[s]===l[s];)s++;let u=e.substring(0,s);if(u.endsWith(t))return u.slice(0,-1);let f=u.lastIndexOf(t);return f>-1?u.substring(0,f):""}function z(n){if(typeof g>"u")return d(n,"/");let t=g("path");return d(n,t.sep)}function A(n){return n.replace(/\\/g,"/")}function I(n){return n.replace(/\\/g,"/").replace(/^\/+/,"")}function C(n){return I(n)}export{g as a,b,S as c,q as d,d as e,z as f,A as g,I as h,C as i};
+//# sourceMappingURL=chunk-OJ6FY5CZ.js.map

package/dist/chunk-OJ6FY5CZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/path.ts"],"sourcesContent":["/**\n * @file Path helper utilities that work in both browser and Node.js environments.\n * Provides environment-agnostic path manipulation functions.\n */\n\n/**\n * Finds the common parent directory from an array of paths.\n * This function is the single shared implementation to be used by both browser and Node.js environments.\n * \n * @param paths - Array of paths to analyze for common parent directory.\n * @param separator - Path separator character (e.g., '/' for browser, path.sep for Node.js).\n * @returns The common parent directory path, or an empty string if none is found.\n */\nexport function findCommonParentDirectory(paths: string[], separator: string): string {\n  // Validate input\n  if (!paths || !Array.isArray(paths) || paths.length === 0) {\n    return '';\n  }\n  \n  // Filter out empty paths and paths without separators\n  const validPaths = paths.filter(p => p && typeof p === 'string' && p.includes(separator));\n  \n  if (validPaths.length === 0) {\n    return '';\n  }\n\n  // Special case for single path: return the directory containing this path\n  if (validPaths.length === 1) {\n    const path = validPaths[0];\n    const lastSepIndex = path.lastIndexOf(separator);\n    if (lastSepIndex > -1) {\n      // Return the directory part without the file name\n      return path.substring(0, lastSepIndex);\n    }\n    return ''; // No directory part found\n  }\n\n  // Sort paths alphabetically to easily find the common prefix\n  const sortedPaths = [...validPaths].sort();\n  const firstPath = sortedPaths[0];\n  const lastPath = sortedPaths[sortedPaths.length - 1];\n  \n  // Find the length of the common prefix\n  let i = 0;\n  while (i < firstPath.length && i < lastPath.length && firstPath[i] === lastPath[i]) {\n    i++;\n  }\n\n  const commonPrefix = firstPath.substring(0, i);\n\n  // The prefix must be a directory. If it doesn't end with a separator,\n  // find the last separator to get the parent directory.\n  if (commonPrefix.endsWith(separator)) {\n    // It's a full directory path that matches, so return it without the trailing slash\n    return commonPrefix.slice(0, -1);\n  }\n\n  const lastSepIndex = commonPrefix.lastIndexOf(separator);\n  if (lastSepIndex > -1) {\n    return commonPrefix.substring(0, lastSepIndex);\n  }\n\n  return ''; // No common directory\n}\n\n/**\n * Simple helper to find common parent of absolute paths using the system path separator.\n * More declarative wrapper around findCommonParentDirectory for Node.js usage.\n * @param absolutePaths - Array of absolute file paths\n * @returns Common parent directory path or empty string if none found\n */\nexport function findCommonParent(absolutePaths: string[]): string {\n  if (typeof require === 'undefined') {\n    // Browser environment - use forward slash\n    return findCommonParentDirectory(absolutePaths, '/');\n  }\n  \n  // Node.js environment - use system separator\n  const path = require('path');\n  return findCommonParentDirectory(absolutePaths, path.sep);\n}\n\n\n/**\n * Converts backslashes to forward slashes for cross-platform compatibility.\n * Does not remove leading slashes (preserves absolute paths).\n * @param path - The path to normalize\n * @returns Path with forward slashes\n */\nexport function normalizeSlashes(path: string): string {\n  return path.replace(/\\\\/g, '/');\n}\n\n/**\n * Normalizes a path for web usage by converting backslashes to forward slashes\n * and removing leading slashes.\n * @param path - The path to normalize\n * @returns Normalized path suitable for web deployment\n */\nexport function normalizeWebPath(path: string): string {\n  return path.replace(/\\\\/g, '/').replace(/^\\/+/, '');\n}\n\n/**\n * Ensures a path is relative by normalizing it and removing any leading slashes.\n * @param path - The path to make relative\n * @returns Relative path suitable for web deployment\n */\nexport function ensureRelativePath(path: string): string {\n  return normalizeWebPath(path);\n}\n"],"mappings":"i1BAaO,SAASA,EAA0BC,EAAiBC,EAA2B,CAEpF,GAAI,CAACD,GAAS,CAAC,MAAM,QAAQA,CAAK,GAAKA,EAAM,SAAW,EACtD,MAAO,GAIT,IAAME,EAAaF,EAAM,OAAOG,GAAKA,GAAK,OAAOA,GAAM,UAAYA,EAAE,SAASF,CAAS,CAAC,EAExF,GAAIC,EAAW,SAAW,EACxB,MAAO,GAIT,GAAIA,EAAW,SAAW,EAAG,CAC3B,IAAME,EAAOF,EAAW,CAAC,EACnBG,EAAeD,EAAK,YAAYH,CAAS,EAC/C,OAAII,EAAe,GAEVD,EAAK,UAAU,EAAGC,CAAY,EAEhC,EACT,CAGA,IAAMC,EAAc,CAAC,GAAGJ,CAAU,EAAE,KAAK,EACnCK,EAAYD,EAAY,CAAC,EACzBE,EAAWF,EAAYA,EAAY,OAAS,CAAC,EAG/CG,EAAI,EACR,KAAOA,EAAIF,EAAU,QAAUE,EAAID,EAAS,QAAUD,EAAUE,CAAC,IAAMD,EAASC,CAAC,GAC/EA,IAGF,IAAMC,EAAeH,EAAU,UAAU,EAAGE,CAAC,EAI7C,GAAIC,EAAa,SAAST,CAAS,EAEjC,OAAOS,EAAa,MAAM,EAAG,EAAE,EAGjC,IAAML,EAAeK,EAAa,YAAYT,CAAS,EACvD,OAAII,EAAe,GACVK,EAAa,UAAU,EAAGL,CAAY,EAGxC,EACT,CAQO,SAASM,EAAiBC,EAAiC,CAChE,GAAI,OAAOC,EAAY,IAErB,OAAOd,EAA0Ba,EAAe,GAAG,EAIrD,IAAMR,EAAO,EAAQ,MAAM,EAC3B,OAAOL,EAA0Ba,EAAeR,EAAK,GAAG,CAC1D,CASO,SAASU,EAAiBV,EAAsB,CACrD,OAAOA,EAAK,QAAQ,MAAO,GAAG,CAChC,CAQO,SAASW,EAAiBX,EAAsB,CACrD,OAAOA,EAAK,QAAQ,MAAO,GAAG,EAAE,QAAQ,OAAQ,EAAE,CACpD,CAOO,SAASY,EAAmBZ,EAAsB,CACvD,OAAOW,EAAiBX,CAAI,CAC9B","names":["findCommonParentDirectory","paths","separator","validPaths","p","path","lastSepIndex","sortedPaths","firstPath","lastPath","i","commonPrefix","findCommonParent","absolutePaths","__require","normalizeSlashes","normalizeWebPath","ensureRelativePath"]}

package/dist/chunk-WJA55FEC.browser.js

@@ -0,0 +1,2 @@
+import{a as x,d as w}from"./chunk-Z566D7DF.browser.js";var g=null;function R(e){g=e}function B(){return typeof process<"u"&&process.versions&&process.versions.node?"node":typeof window<"u"||typeof self<"u"?"browser":"unknown"}function p(){return g||B()}import{ShipError as u}from"@shipstatic/types";async function k(e){let n=(await import("./spark-md5-DLLZAUJQ.browser.js")).default;return new Promise((o,s)=>{let c=Math.ceil(e.size/2097152),t=0,l=new n.ArrayBuffer,m=new FileReader,d=()=>{let f=t*2097152,r=Math.min(f+2097152,e.size);m.readAsArrayBuffer(e.slice(f,r))};m.onload=f=>{let r=f.target?.result;if(!r){s(u.business("Failed to read file chunk"));return}l.append(r),t++,t<c?d():o({md5:l.end()})},m.onerror=()=>{s(u.business("Failed to calculate MD5: FileReader error"))},d()})}async function E(e){let n=await import("crypto");if(Buffer.isBuffer(e)){let s=n.createHash("md5");return s.update(e),{md5:s.digest("hex")}}let o=await import("fs");return new Promise((s,a)=>{let c=n.createHash("md5"),t=o.createReadStream(e);t.on("error",l=>a(u.business(`Failed to read file for MD5: ${l.message}`))),t.on("data",l=>c.update(l)),t.on("end",()=>s({md5:c.digest("hex")}))})}async function v(e){let n=p();if(n==="browser"){if(!(e instanceof Blob))throw u.business("Invalid input for browser MD5 calculation: Expected Blob or File.");return k(e)}if(n==="node"){if(!(Buffer.isBuffer(e)||typeof e=="string"))throw u.business("Invalid input for Node.js MD5 calculation: Expected Buffer or file path string.");return E(e)}throw u.business("Unknown or unsupported execution environment for MD5 calculation.")}import{ShipError as D}from"@shipstatic/types";var S=["^npm-debug\\.log$","^\\..*\\.swp$","^\\.DS_Store$","^\\.AppleDouble$","^\\.LSOverride$","^Icon\\r$","^\\._.*","^\\.Spotlight-V100(?:$|\\/)","\\.Trashes","^__MACOSX$","~$","^Thumbs\\.db$","^ehthumbs\\.db$","^[Dd]esktop\\.ini$","@eaDir$"],P=new RegExp(S.join("|"));function b(e){return P.test(e)}var F=["__MACOSX",".Trashes",".fseventsd",".Spotlight-V100"];function y(e){return!e||e.length===0?[]:e.filter(n=>{if(!n)return!1;let o=n.replace(/\\/g,"/").split("/").filter(Boolean);if(o.length===0)return!0;let s=o[o.length-1];if(b(s))return!1;let a=o.slice(0,-1);for(let c of a)if(F.some(t=>c.toLowerCase()===t.toLowerCase()))return!1;return!0})}async function H(e,n={}){if(p()!=="browser")throw D.business("processFilesForBrowser can only be called in a browser environment.");let{explicitBaseDirInput:o,stripCommonPrefix:s}=n,a=[],c=Array.isArray(e)?e:Array.from(e),t="";s?t=M(e):o&&(t=o);for(let r of c){let i=r.webkitRelativePath||r.name;if(t){i=w(i);let h=t.endsWith("/")?t:`${t}/`;(i===t||i===h||i.startsWith(h))&&(i=i.substring(h.length))}i=w(i),a.push({file:r,relativePath:i})}let l=a.map(r=>r.relativePath),m=y(l),d=new Set(m),f=[];for(let r of a){if(!d.has(r.relativePath)||r.file.size===0)continue;let{md5:i}=await v(r.file);f.push({content:r.file,path:r.relativePath,size:r.file.size,md5:i})}return f}function M(e){if(p()!=="browser")throw D.business("findBrowserCommonParentDirectory can only be called in a browser environment.");if(!e||e.length===0)return"";let n=Array.from(e).map(o=>o.webkitRelativePath);return n.some(o=>!o)?"":x(n,"/")}export{R as a,p as b,v as c,y as d,H as e,M as f};
+//# sourceMappingURL=chunk-WJA55FEC.browser.js.map