Manager API

Configuration

const manager = new FirebaseUploadManager({
  maxConcurrentUploads: 5,       // 1-50, default: 5
  chunkSize: 5 * 1024 * 1024,    // 64KB-100MB, default: 5MB
  retryAttempts: 3,               // 0-10, default: 3
  retryDelay: 1000,               // 100-60000ms, default: 1000ms
  autoStart: true,                // default: false
  enableSmartScheduling: true,    // default: false
  maxBandwidthMbps: 10,           // 0.1-1000, default: 10
  adaptiveBandwidth: true,        // default: false
  maxMemoryItems: 1000,           // 10-100000, default: 1000
  enablePersistence: false,       // IndexedDB persistence, default: false
});

manager.setStorage(storage);

Reactive State

All state properties are reactive using Svelte 5 $state. Use them directly in your components.

Property	Type	Description
queue	UploadItem[]	Files queued for upload
active	Map<string, UploadItem>	Currently uploading files
completed	Map<string, UploadItem>	Successfully uploaded files
failed	Map<string, UploadItem>	Failed uploads
paused	Set<string>	Paused file IDs
isProcessing	boolean	Currently processing uploads
isPaused	boolean	Global pause state
totalProgress	number	Overall progress 0-100
currentSpeed	number	Upload speed in bytes/sec
estimatedTimeRemaining	number | null	ETA in seconds (null when not computing)
successCount	number	Successful upload count
failureCount	number	Failed upload count
isActive	boolean	Has active uploads
isIdle	boolean	No processing, active, or queued files

File Management

Adding Files

// Basic — returns number of files added
await manager.addFiles(fileList, { path: 'photos/' });

// With validation — returns detailed results
const result = await manager.addFilesWithValidation(files, {
  validate: true,
  validationRules: {
    maxSize: 10 * 1024 * 1024,
    allowedTypes: ['image/*', '.pdf']
  },
  skipDuplicates: true,
  checkResume: true
});
// result: { added, validated, duplicates, resumed, errors }

Querying Files

manager.getFile(fileId);                    // Single file by ID
manager.getAllFiles();                       // All files
manager.getAllFiles('uploading');            // Filter by status

Removing Files

await manager.removeFile(fileId);
await manager.clearCompleted();
manager.clearFailed();

Upload Control

await manager.start();      // Start processing queue
await manager.pause();      // Pause all uploads
await manager.resume();     // Resume paused uploads
await manager.stop();       // Stop and clear everything
manager.retryFailed();      // Retry all failed uploads
await manager.destroy();    // Clean up all resources

Validation

// Single file
const result = await manager.validateFile(file, {
  maxSize: 10 * 1024 * 1024,
  allowedTypes: ['image/*', '.pdf']
});
// result: { valid: boolean, errors: string[], warnings: string[] }

// Multiple files
const results = await manager.validateFiles(files, rules);
// returns Map<File, ValidationResult>

// Duplicate detection
const dupes = await manager.detectDuplicates(files);
// returns Map<string, File[]> grouped by hash

// File metadata
const meta = await manager.getFileMetadata(file);
// { size, type, lastModified, hash, dimensions?, duration? }

Runtime Configuration

const result = manager.updateConfig('maxConcurrentUploads', 10);
// { success: boolean, error?: string, warning?: string }

const config = manager.getConfig(); // Readonly snapshot

Network & Bandwidth

manager.getBandwidthStats();
// { current, average, peak, limit, utilization }

manager.getNetworkQuality();
// 'excellent' | 'good' | 'poor' | 'unknown'

manager.getRecommendedSettings();
// { maxConcurrent, chunkSize, timeout }

Health Checks

const health = await manager.performHealthCheck();
// { status, timestamp, duration, checks, details }
// checks: { connection, storage, permissions, network, memory, bandwidth }

const { canStart, healthResult } = await manager.startWithHealthCheck();

manager.getHealthStatus();     // Current status
manager.getLastHealthCheck();  // Last result
await manager.forceHealthCheck(); // Force re-check

Queue Statistics

manager.getQueueStats();
// { totalFiles, totalSize, sizeDistribution, estimatedCompletionTime, quickWinsAvailable }