@uploadista/react 0.0.20 → 0.1.0-beta.5

package/dist/use-uploadista-events-KhJ4knam.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-uploadista-events-KhJ4knam.mjs","names":["initialMetrics: UploadMetrics","estimatedTimeRemaining: number | null","newMetrics: UploadMetrics","fileMetric: FileUploadMetrics"],"sources":["../src/hooks/event-utils.ts","../src/hooks/use-flow-events.ts","../src/hooks/use-upload-events.ts","../src/hooks/use-upload-metrics.ts","../src/hooks/use-uploadista-events.ts"],"sourcesContent":["import type { UploadistaEvent } from \"@uploadista/client-browser\";\nimport { EventType, type FlowEvent } from \"@uploadista/core/flow\";\nimport { UploadEventType, type UploadEvent } from \"@uploadista/core/types\";\n\n/**\n * Type guard to check if an event is a flow event\n */\nexport function isFlowEvent(event: UploadistaEvent): event is FlowEvent {\n  if (!(\"eventType\" in event)) return false;\n  const e = event as { eventType: unknown };\n  return (\n    e.eventType === EventType.JobStart ||\n    e.eventType === EventType.JobEnd ||\n    e.eventType === EventType.FlowStart ||\n    e.eventType === EventType.FlowEnd ||\n    e.eventType === EventType.FlowError ||\n    e.eventType === EventType.FlowPause ||\n    e.eventType === EventType.FlowCancel ||\n    e.eventType === EventType.NodeStart ||\n    e.eventType === EventType.NodeEnd ||\n    e.eventType === EventType.NodePause ||\n    e.eventType === EventType.NodeResume ||\n    e.eventType === EventType.NodeError ||\n    e.eventType === EventType.NodeStream ||\n    e.eventType === EventType.NodeResponse\n  );\n}\n\n/**\n * Type guard to check if an event is an upload event\n */\nexport function isUploadEvent(event: UploadistaEvent): event is UploadEvent {\n  if (!(\"type\" in event)) return false;\n  const e = event as { type: unknown };\n  return (\n    e.type === UploadEventType.UPLOAD_STARTED ||\n    e.type === UploadEventType.UPLOAD_PROGRESS ||\n    e.type === UploadEventType.UPLOAD_COMPLETE ||\n    e.type === UploadEventType.UPLOAD_FAILED ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_SUCCESS ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_FAILED ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_WARNING\n  );\n}\n","import type {\n  FlowEventFlowCancel,\n  FlowEventFlowEnd,\n  FlowEventFlowError,\n  FlowEventFlowPause,\n  FlowEventFlowStart,\n  FlowEventJobEnd,\n  FlowEventJobStart,\n  FlowEventNodeEnd,\n  FlowEventNodeError,\n  FlowEventNodePause,\n  FlowEventNodeResume,\n  FlowEventNodeStart,\n} from \"@uploadista/core/flow\";\nimport { EventType } from \"@uploadista/core/flow\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\nimport { isFlowEvent } from \"./event-utils\";\n\n/**\n * Options for handling flow execution events.\n *\n * All callbacks are optional - only provide handlers for events you care about.\n */\nexport interface UseFlowEventsOptions {\n  /** Called when a job starts execution */\n  onJobStart?: (event: FlowEventJobStart) => void;\n  /** Called when a job completes (success or failure) */\n  onJobEnd?: (event: FlowEventJobEnd) => void;\n  /** Called when a flow begins execution */\n  onFlowStart?: (event: FlowEventFlowStart) => void;\n  /** Called when a flow completes successfully */\n  onFlowEnd?: (event: FlowEventFlowEnd) => void;\n  /** Called when a flow encounters an error */\n  onFlowError?: (event: FlowEventFlowError) => void;\n  /** Called when a flow is paused by user request */\n  onFlowPause?: (event: FlowEventFlowPause) => void;\n  /** Called when a flow is cancelled by user request */\n  onFlowCancel?: (event: FlowEventFlowCancel) => void;\n  /** Called when a node starts processing */\n  onNodeStart?: (event: FlowEventNodeStart) => void;\n  /** Called when a node completes successfully */\n  onNodeEnd?: (event: FlowEventNodeEnd) => void;\n  /** Called when a node pauses (waiting for additional data) */\n  onNodePause?: (event: FlowEventNodePause) => void;\n  /** Called when a paused node resumes execution */\n  onNodeResume?: (event: FlowEventNodeResume) => void;\n  /** Called when a node encounters an error */\n  onNodeError?: (event: FlowEventNodeError) => void;\n}\n\n/**\n * Structured hook for handling flow execution events with type-safe callbacks.\n *\n * This hook provides a clean API for listening to specific flow events without\n * needing to manually filter events or use type guards.\n *\n * Must be used within UploadistaProvider.\n *\n * @param options - Object with optional callbacks for each flow event type\n *\n * @example\n * ```tsx\n * import { useFlowEvents } from '@uploadista/react';\n *\n * function FlowMonitor() {\n *   useFlowEvents({\n *     onFlowStart: (event) => {\n *       console.log('Flow started:', event.flowId);\n *     },\n *     onNodeStart: (event) => {\n *       console.log('Node started:', event.nodeName);\n *     },\n *     onNodeEnd: (event) => {\n *       console.log('Node completed:', event.nodeName, event.result);\n *     },\n *     onFlowEnd: (event) => {\n *       console.log('Flow completed with outputs:', event.outputs);\n *     },\n *     onFlowError: (event) => {\n *       console.error('Flow failed:', event.error);\n *     },\n *   });\n *\n *   return <div>Monitoring flow execution...</div>;\n * }\n * ```\n */\nexport function useFlowEvents(options: UseFlowEventsOptions): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents((event) => {\n      // Only handle flow events\n      if (!isFlowEvent(event)) return;\n\n      // Route to appropriate callback based on event type\n      switch (event.eventType) {\n        case EventType.JobStart:\n          options.onJobStart?.(event);\n          break;\n        case EventType.JobEnd:\n          options.onJobEnd?.(event);\n          break;\n        case EventType.FlowStart:\n          options.onFlowStart?.(event);\n          break;\n        case EventType.FlowEnd:\n          options.onFlowEnd?.(event);\n          break;\n        case EventType.FlowError:\n          options.onFlowError?.(event);\n          break;\n        case EventType.FlowPause:\n          options.onFlowPause?.(event);\n          break;\n        case EventType.FlowCancel:\n          options.onFlowCancel?.(event);\n          break;\n        case EventType.NodeStart:\n          options.onNodeStart?.(event);\n          break;\n        case EventType.NodeEnd:\n          options.onNodeEnd?.(event);\n          break;\n        case EventType.NodePause:\n          options.onNodePause?.(event);\n          break;\n        case EventType.NodeResume:\n          options.onNodeResume?.(event);\n          break;\n        case EventType.NodeError:\n          options.onNodeError?.(event);\n          break;\n      }\n    });\n\n    return unsubscribe;\n  }, [subscribeToEvents, options]);\n}\n","import { UploadEventType, type UploadEvent } from \"@uploadista/core/types\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\nimport { isUploadEvent } from \"./event-utils\";\n\n/**\n * Upload progress event data\n */\nexport interface UploadProgressEventData {\n  id: string;\n  progress: number;\n  total: number;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload started/complete event data (contains full UploadFile)\n */\nexport interface UploadFileEventData {\n  // This will contain the full UploadFile schema\n  [key: string]: unknown;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload failed event data\n */\nexport interface UploadFailedEventData {\n  id: string;\n  error: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation success event data\n */\nexport interface UploadValidationSuccessEventData {\n  id: string;\n  validationType: \"checksum\" | \"mimetype\";\n  algorithm?: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation failed event data\n */\nexport interface UploadValidationFailedEventData {\n  id: string;\n  reason: string;\n  expected: string;\n  actual: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation warning event data\n */\nexport interface UploadValidationWarningEventData {\n  id: string;\n  message: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Options for handling upload events.\n *\n * All callbacks are optional - only provide handlers for events you care about.\n */\nexport interface UseUploadEventsOptions {\n  /** Called when an upload starts */\n  onUploadStarted?: (data: UploadFileEventData) => void;\n  /** Called with upload progress updates */\n  onUploadProgress?: (data: UploadProgressEventData) => void;\n  /** Called when an upload completes successfully */\n  onUploadComplete?: (data: UploadFileEventData) => void;\n  /** Called when an upload fails */\n  onUploadFailed?: (data: UploadFailedEventData) => void;\n  /** Called when upload validation succeeds */\n  onUploadValidationSuccess?: (data: UploadValidationSuccessEventData) => void;\n  /** Called when upload validation fails */\n  onUploadValidationFailed?: (data: UploadValidationFailedEventData) => void;\n  /** Called when upload validation produces a warning */\n  onUploadValidationWarning?: (data: UploadValidationWarningEventData) => void;\n}\n\n/**\n * Structured hook for handling upload events with type-safe callbacks.\n *\n * This hook provides a clean API for listening to specific upload events without\n * needing to manually filter events or use type guards.\n *\n * Must be used within UploadistaProvider.\n *\n * @param options - Object with optional callbacks for each upload event type\n *\n * @example\n * ```tsx\n * import { useUploadEvents } from '@uploadista/react';\n *\n * function UploadMonitor() {\n *   useUploadEvents({\n *     onUploadStarted: (data) => {\n *       console.log('Upload started:', data.id);\n *     },\n *     onUploadProgress: (data) => {\n *       const percent = (data.progress / data.total) * 100;\n *       console.log(`Upload progress: ${percent}%`);\n *     },\n *     onUploadComplete: (data) => {\n *       console.log('Upload completed:', data);\n *     },\n *     onUploadFailed: (data) => {\n *       console.error('Upload failed:', data.error);\n *     },\n *   });\n *\n *   return <div>Monitoring uploads...</div>;\n * }\n * ```\n */\nexport function useUploadEvents(options: UseUploadEventsOptions): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents((event) => {\n      // Only handle upload events\n      if (!isUploadEvent(event)) return;\n\n      // Route to appropriate callback based on event type\n      // Note: flow context is at the top level of the event, not inside data\n      const flowContext = \"flow\" in event ? event.flow : undefined;\n\n      switch (event.type) {\n        case UploadEventType.UPLOAD_STARTED:\n          options.onUploadStarted?.({\n            ...(event.data as unknown as Omit<UploadFileEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_PROGRESS:\n          options.onUploadProgress?.({\n            ...(event.data as unknown as Omit<\n              UploadProgressEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_COMPLETE:\n          options.onUploadComplete?.({\n            ...(event.data as unknown as Omit<UploadFileEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_FAILED:\n          options.onUploadFailed?.({\n            ...(event.data as unknown as Omit<UploadFailedEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_SUCCESS:\n          options.onUploadValidationSuccess?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationSuccessEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_FAILED:\n          options.onUploadValidationFailed?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationFailedEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_WARNING:\n          options.onUploadValidationWarning?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationWarningEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n      }\n    });\n\n    return unsubscribe;\n  }, [subscribeToEvents, options]);\n}\n","import type {\n  ChunkMetrics,\n  PerformanceInsights,\n  UploadSessionMetrics,\n} from \"@uploadista/client-core\";\nimport React, { useCallback, useRef, useState } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\n\nexport type Timeout = ReturnType<typeof setInterval>;\n\nexport interface UploadMetrics {\n  /**\n   * Total bytes uploaded across all files\n   */\n  totalBytesUploaded: number;\n\n  /**\n   * Total bytes to upload across all files\n   */\n  totalBytes: number;\n\n  /**\n   * Overall upload speed in bytes per second\n   */\n  averageSpeed: number;\n\n  /**\n   * Current upload speed in bytes per second\n   */\n  currentSpeed: number;\n\n  /**\n   * Estimated time remaining in milliseconds\n   */\n  estimatedTimeRemaining: number | null;\n\n  /**\n   * Total number of files being tracked\n   */\n  totalFiles: number;\n\n  /**\n   * Number of files completed\n   */\n  completedFiles: number;\n\n  /**\n   * Number of files currently uploading\n   */\n  activeUploads: number;\n\n  /**\n   * Overall progress as percentage (0-100)\n   */\n  progress: number;\n\n  /**\n   * Peak upload speed achieved\n   */\n  peakSpeed: number;\n\n  /**\n   * Start time of the first upload\n   */\n  startTime: number | null;\n\n  /**\n   * End time of the last completed upload\n   */\n  endTime: number | null;\n\n  /**\n   * Total duration of all uploads\n   */\n  totalDuration: number | null;\n\n  /**\n   * Detailed performance insights from the upload client\n   */\n  insights: PerformanceInsights;\n\n  /**\n   * Session metrics for completed uploads\n   */\n  sessionMetrics: Partial<UploadSessionMetrics>[];\n\n  /**\n   * Detailed chunk metrics from recent uploads\n   */\n  chunkMetrics: ChunkMetrics[];\n}\n\nexport interface FileUploadMetrics {\n  id: string;\n  filename: string;\n  size: number;\n  bytesUploaded: number;\n  progress: number;\n  speed: number;\n  startTime: number;\n  endTime: number | null;\n  duration: number | null;\n  isComplete: boolean;\n}\n\nexport interface UseUploadMetricsOptions {\n  /**\n   * Interval for calculating current speed (in milliseconds)\n   */\n  speedCalculationInterval?: number;\n\n  /**\n   * Number of speed samples to keep for average calculation\n   */\n  speedSampleSize?: number;\n\n  /**\n   * Called when metrics are updated\n   */\n  onMetricsUpdate?: (metrics: UploadMetrics) => void;\n\n  /**\n   * Called when a file upload starts\n   */\n  onFileStart?: (fileMetrics: FileUploadMetrics) => void;\n\n  /**\n   * Called when a file upload progresses\n   */\n  onFileProgress?: (fileMetrics: FileUploadMetrics) => void;\n\n  /**\n   * Called when a file upload completes\n   */\n  onFileComplete?: (fileMetrics: FileUploadMetrics) => void;\n}\n\nexport interface UseUploadMetricsReturn {\n  /**\n   * Current overall metrics\n   */\n  metrics: UploadMetrics;\n\n  /**\n   * Individual file metrics\n   */\n  fileMetrics: FileUploadMetrics[];\n\n  /**\n   * Start tracking a new file upload\n   */\n  startFileUpload: (id: string, filename: string, size: number) => void;\n\n  /**\n   * Update progress for a file upload\n   */\n  updateFileProgress: (id: string, bytesUploaded: number) => void;\n\n  /**\n   * Mark a file upload as complete\n   */\n  completeFileUpload: (id: string) => void;\n\n  /**\n   * Remove a file from tracking\n   */\n  removeFile: (id: string) => void;\n\n  /**\n   * Reset all metrics\n   */\n  reset: () => void;\n\n  /**\n   * Get metrics for a specific file\n   */\n  getFileMetrics: (id: string) => FileUploadMetrics | undefined;\n\n  /**\n   * Export metrics as JSON\n   */\n  exportMetrics: () => {\n    overall: UploadMetrics;\n    files: FileUploadMetrics[];\n    exportTime: number;\n  };\n}\n\nconst initialMetrics: UploadMetrics = {\n  totalBytesUploaded: 0,\n  totalBytes: 0,\n  averageSpeed: 0,\n  currentSpeed: 0,\n  estimatedTimeRemaining: null,\n  totalFiles: 0,\n  completedFiles: 0,\n  activeUploads: 0,\n  progress: 0,\n  peakSpeed: 0,\n  startTime: null,\n  endTime: null,\n  totalDuration: null,\n  insights: {\n    overallEfficiency: 0,\n    chunkingEffectiveness: 0,\n    networkStability: 0,\n    recommendations: [],\n    optimalChunkSizeRange: { min: 256 * 1024, max: 2 * 1024 * 1024 },\n  },\n  sessionMetrics: [],\n  chunkMetrics: [],\n};\n\n/**\n * React hook for tracking detailed upload metrics and performance statistics.\n * Provides comprehensive monitoring of upload progress, speed, and timing data.\n *\n * @param options - Configuration and event handlers\n * @returns Upload metrics state and control methods\n *\n * @example\n * ```tsx\n * const uploadMetrics = useUploadMetrics({\n *   speedCalculationInterval: 1000, // Update speed every second\n *   speedSampleSize: 10, // Keep last 10 speed samples for average\n *   onMetricsUpdate: (metrics) => {\n *     console.log(`Overall progress: ${metrics.progress}%`);\n *     console.log(`Speed: ${(metrics.currentSpeed / 1024).toFixed(1)} KB/s`);\n *     console.log(`ETA: ${metrics.estimatedTimeRemaining}ms`);\n *   },\n *   onFileComplete: (fileMetrics) => {\n *     console.log(`${fileMetrics.filename} completed in ${fileMetrics.duration}ms`);\n *   },\n * });\n *\n * // Start tracking a file\n * const handleFileStart = (file: File) => {\n *   uploadMetrics.startFileUpload(file.name, file.name, file.size);\n * };\n *\n * // Update progress during upload\n * const handleProgress = (fileId: string, bytesUploaded: number) => {\n *   uploadMetrics.updateFileProgress(fileId, bytesUploaded);\n * };\n *\n * // Display metrics\n * return (\n *   <div>\n *     <div>Overall Progress: {uploadMetrics.metrics.progress}%</div>\n *     <div>Speed: {(uploadMetrics.metrics.currentSpeed / 1024).toFixed(1)} KB/s</div>\n *     <div>Files: {uploadMetrics.metrics.completedFiles}/{uploadMetrics.metrics.totalFiles}</div>\n *\n *     {uploadMetrics.metrics.estimatedTimeRemaining && (\n *       <div>ETA: {Math.round(uploadMetrics.metrics.estimatedTimeRemaining / 1000)}s</div>\n *     )}\n *\n *     {uploadMetrics.fileMetrics.map((file) => (\n *       <div key={file.id}>\n *         {file.filename}: {file.progress}% ({(file.speed / 1024).toFixed(1)} KB/s)\n *       </div>\n *     ))}\n *   </div>\n * );\n * ```\n */\nexport function useUploadMetrics(\n  options: UseUploadMetricsOptions = {},\n): UseUploadMetricsReturn {\n  const {\n    speedCalculationInterval = 1000,\n    speedSampleSize = 10,\n    onMetricsUpdate,\n    onFileStart,\n    onFileProgress,\n    onFileComplete,\n  } = options;\n\n  const uploadClient = useUploadistaContext();\n\n  const [metrics, setMetrics] = useState<UploadMetrics>(initialMetrics);\n  const [fileMetrics, setFileMetrics] = useState<FileUploadMetrics[]>([]);\n\n  const speedSamplesRef = useRef<Array<{ time: number; bytes: number }>>([]);\n  const lastUpdateRef = useRef<number>(0);\n  const intervalRef = useRef<Timeout | null>(null);\n\n  const calculateSpeed = useCallback(\n    (currentTime: number, totalBytesUploaded: number) => {\n      const sample = { time: currentTime, bytes: totalBytesUploaded };\n      speedSamplesRef.current.push(sample);\n\n      // Keep only recent samples\n      if (speedSamplesRef.current.length > speedSampleSize) {\n        speedSamplesRef.current = speedSamplesRef.current.slice(\n          -speedSampleSize,\n        );\n      }\n\n      // Calculate current speed (bytes per second)\n      let currentSpeed = 0;\n      if (speedSamplesRef.current.length >= 2) {\n        const recent =\n          speedSamplesRef.current[speedSamplesRef.current.length - 1];\n        const previous =\n          speedSamplesRef.current[speedSamplesRef.current.length - 2];\n        if (recent && previous) {\n          const timeDiff = (recent.time - previous.time) / 1000; // Convert to seconds\n          const bytesDiff = recent.bytes - previous.bytes;\n          currentSpeed = timeDiff > 0 ? bytesDiff / timeDiff : 0;\n        }\n      }\n\n      // Calculate average speed\n      let averageSpeed = 0;\n      if (speedSamplesRef.current.length >= 2) {\n        const first = speedSamplesRef.current[0];\n        const last =\n          speedSamplesRef.current[speedSamplesRef.current.length - 1];\n        if (first && last) {\n          const totalTime = (last.time - first.time) / 1000; // Convert to seconds\n          const totalBytes = last.bytes - first.bytes;\n          averageSpeed = totalTime > 0 ? totalBytes / totalTime : 0;\n        }\n      }\n\n      return { currentSpeed, averageSpeed };\n    },\n    [speedSampleSize],\n  );\n\n  const updateMetrics = useCallback(() => {\n    const now = Date.now();\n\n    // Calculate totals from file metrics\n    const totalBytes = fileMetrics.reduce((sum, file) => sum + file.size, 0);\n    const totalBytesUploaded = fileMetrics.reduce(\n      (sum, file) => sum + file.bytesUploaded,\n      0,\n    );\n    const completedFiles = fileMetrics.filter((file) => file.isComplete).length;\n    const activeUploads = fileMetrics.filter(\n      (file) => !file.isComplete && file.bytesUploaded > 0,\n    ).length;\n\n    // Calculate speeds\n    const { currentSpeed, averageSpeed } = calculateSpeed(\n      now,\n      totalBytesUploaded,\n    );\n\n    // Calculate progress\n    const progress =\n      totalBytes > 0 ? Math.round((totalBytesUploaded / totalBytes) * 100) : 0;\n\n    // Calculate estimated time remaining\n    let estimatedTimeRemaining: number | null = null;\n    if (currentSpeed > 0) {\n      const remainingBytes = totalBytes - totalBytesUploaded;\n      estimatedTimeRemaining = (remainingBytes / currentSpeed) * 1000; // Convert to milliseconds\n    }\n\n    // Find start and end times\n    const activeTimes = fileMetrics.filter((file) => file.startTime > 0);\n    const startTime =\n      activeTimes.length > 0\n        ? Math.min(...activeTimes.map((file) => file.startTime))\n        : null;\n\n    const completedTimes = fileMetrics.filter((file) => file.endTime !== null);\n    const endTime =\n      completedTimes.length > 0 && completedFiles === fileMetrics.length\n        ? Math.max(\n            ...completedTimes\n              .map((file) => file.endTime)\n              .filter((time) => time !== null),\n          )\n        : null;\n\n    const totalDuration = startTime && endTime ? endTime - startTime : null;\n\n    const newMetrics: UploadMetrics = {\n      totalBytesUploaded,\n      totalBytes,\n      averageSpeed,\n      currentSpeed,\n      estimatedTimeRemaining,\n      totalFiles: fileMetrics.length,\n      completedFiles,\n      activeUploads,\n      progress,\n      peakSpeed: Math.max(metrics.peakSpeed, currentSpeed),\n      startTime,\n      endTime,\n      totalDuration,\n      insights: uploadClient.client.getChunkingInsights(),\n      sessionMetrics: [uploadClient.client.exportMetrics().session],\n      chunkMetrics: uploadClient.client.exportMetrics().chunks,\n    };\n\n    setMetrics(newMetrics);\n    onMetricsUpdate?.(newMetrics);\n  }, [\n    fileMetrics,\n    metrics.peakSpeed,\n    calculateSpeed,\n    onMetricsUpdate,\n    uploadClient.client,\n  ]);\n\n  // Set up periodic speed calculations\n  const setupSpeedCalculation = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n    }\n\n    intervalRef.current = setInterval(() => {\n      if (\n        fileMetrics.some((file) => !file.isComplete && file.bytesUploaded > 0)\n      ) {\n        updateMetrics();\n      }\n    }, speedCalculationInterval);\n\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = null;\n      }\n    };\n  }, [speedCalculationInterval, updateMetrics, fileMetrics]);\n\n  const startFileUpload = useCallback(\n    (id: string, filename: string, size: number) => {\n      const now = Date.now();\n\n      const fileMetric: FileUploadMetrics = {\n        id,\n        filename,\n        size,\n        bytesUploaded: 0,\n        progress: 0,\n        speed: 0,\n        startTime: now,\n        endTime: null,\n        duration: null,\n        isComplete: false,\n      };\n\n      setFileMetrics((prev) => {\n        const existing = prev.find((file) => file.id === id);\n        if (existing) {\n          return prev.map((file) => (file.id === id ? fileMetric : file));\n        }\n        return [...prev, fileMetric];\n      });\n\n      onFileStart?.(fileMetric);\n\n      // Start speed calculation if this is the first active upload\n      if (fileMetrics.filter((file) => !file.isComplete).length === 0) {\n        setupSpeedCalculation();\n      }\n    },\n    [fileMetrics, onFileStart, setupSpeedCalculation],\n  );\n\n  const updateFileProgress = useCallback(\n    (id: string, bytesUploaded: number) => {\n      const now = Date.now();\n\n      setFileMetrics((prev) =>\n        prev.map((file) => {\n          if (file.id !== id) return file;\n\n          const timeDiff = (now - file.startTime) / 1000; // seconds\n          const speed = timeDiff > 0 ? bytesUploaded / timeDiff : 0;\n          const progress =\n            file.size > 0 ? Math.round((bytesUploaded / file.size) * 100) : 0;\n\n          const updatedFile = {\n            ...file,\n            bytesUploaded,\n            progress,\n            speed,\n          };\n\n          onFileProgress?.(updatedFile);\n          return updatedFile;\n        }),\n      );\n\n      // Trigger metrics update\n      setTimeout(updateMetrics, 0);\n    },\n    [onFileProgress, updateMetrics],\n  );\n\n  const completeFileUpload = useCallback(\n    (id: string) => {\n      const now = Date.now();\n\n      setFileMetrics((prev) =>\n        prev.map((file) => {\n          if (file.id !== id) return file;\n\n          const duration = now - file.startTime;\n          const speed = duration > 0 ? (file.size / duration) * 1000 : 0; // bytes per second\n\n          const completedFile = {\n            ...file,\n            bytesUploaded: file.size,\n            progress: 100,\n            speed,\n            endTime: now,\n            duration,\n            isComplete: true,\n          };\n\n          onFileComplete?.(completedFile);\n          return completedFile;\n        }),\n      );\n\n      // Trigger metrics update\n      setTimeout(updateMetrics, 0);\n    },\n    [onFileComplete, updateMetrics],\n  );\n\n  const removeFile = useCallback(\n    (id: string) => {\n      setFileMetrics((prev) => prev.filter((file) => file.id !== id));\n      setTimeout(updateMetrics, 0);\n    },\n    [updateMetrics],\n  );\n\n  const reset = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n      intervalRef.current = null;\n    }\n\n    setMetrics(initialMetrics);\n    setFileMetrics([]);\n    speedSamplesRef.current = [];\n    lastUpdateRef.current = 0;\n  }, []);\n\n  const getFileMetrics = useCallback(\n    (id: string) => {\n      return fileMetrics.find((file) => file.id === id);\n    },\n    [fileMetrics],\n  );\n\n  const exportMetrics = useCallback(() => {\n    return {\n      overall: metrics,\n      files: fileMetrics,\n      exportTime: Date.now(),\n    };\n  }, [metrics, fileMetrics]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n      }\n    };\n  }, []);\n\n  return {\n    metrics,\n    fileMetrics,\n    startFileUpload,\n    updateFileProgress,\n    completeFileUpload,\n    removeFile,\n    reset,\n    getFileMetrics,\n    exportMetrics,\n  };\n}\n","import type { UploadistaEvent } from \"@uploadista/client-core\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\n\n/**\n * Simple hook that subscribes to all Uploadista events (both flow and upload events).\n *\n * This is a low-level hook that provides access to all events. For more structured\n * event handling, consider using `useFlowEvents` or `useUploadEvents` instead.\n *\n * Must be used within UploadistaProvider.\n *\n * @param callback - Function called for every event emitted by the Uploadista client\n *\n * @example\n * ```tsx\n * import { useUploadistaEvents, isFlowEvent, isUploadEvent } from '@uploadista/react';\n *\n * function MyComponent() {\n *   useUploadistaEvents((event) => {\n *     if (isFlowEvent(event)) {\n *       console.log('Flow event:', event.eventType);\n *     } else if (isUploadEvent(event)) {\n *       console.log('Upload event:', event.type);\n *     }\n *   });\n *\n *   return <div>Listening to all events...</div>;\n * }\n * ```\n */\nexport function useUploadistaEvents(\n  callback: (event: UploadistaEvent) => void,\n): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents(callback);\n    return unsubscribe;\n  }, [subscribeToEvents, callback]);\n}\n"],"mappings":"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"}
+{"version":3,"file":"use-uploadista-events-KhJ4knam.mjs","names":[],"sources":["../src/hooks/event-utils.ts","../src/hooks/use-flow-events.ts","../src/hooks/use-upload-events.ts","../src/hooks/use-upload-metrics.ts","../src/hooks/use-uploadista-events.ts"],"sourcesContent":["import type { UploadistaEvent } from \"@uploadista/client-browser\";\nimport { EventType, type FlowEvent } from \"@uploadista/core/flow\";\nimport { type UploadEvent, UploadEventType } from \"@uploadista/core/types\";\n\n/**\n * Type guard to check if an event is a flow event\n */\nexport function isFlowEvent(event: UploadistaEvent): event is FlowEvent {\n  if (!(\"eventType\" in event)) return false;\n  const e = event as { eventType: unknown };\n  return (\n    e.eventType === EventType.JobStart ||\n    e.eventType === EventType.JobEnd ||\n    e.eventType === EventType.FlowStart ||\n    e.eventType === EventType.FlowEnd ||\n    e.eventType === EventType.FlowError ||\n    e.eventType === EventType.FlowPause ||\n    e.eventType === EventType.FlowCancel ||\n    e.eventType === EventType.NodeStart ||\n    e.eventType === EventType.NodeEnd ||\n    e.eventType === EventType.NodePause ||\n    e.eventType === EventType.NodeResume ||\n    e.eventType === EventType.NodeError ||\n    e.eventType === EventType.NodeStream ||\n    e.eventType === EventType.NodeResponse\n  );\n}\n\n/**\n * Type guard to check if an event is an upload event\n */\nexport function isUploadEvent(event: UploadistaEvent): event is UploadEvent {\n  if (!(\"type\" in event)) return false;\n  const e = event as { type: unknown };\n  return (\n    e.type === UploadEventType.UPLOAD_STARTED ||\n    e.type === UploadEventType.UPLOAD_PROGRESS ||\n    e.type === UploadEventType.UPLOAD_COMPLETE ||\n    e.type === UploadEventType.UPLOAD_FAILED ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_SUCCESS ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_FAILED ||\n    e.type === UploadEventType.UPLOAD_VALIDATION_WARNING\n  );\n}\n","import type {\n  FlowEventFlowCancel,\n  FlowEventFlowEnd,\n  FlowEventFlowError,\n  FlowEventFlowPause,\n  FlowEventFlowStart,\n  FlowEventJobEnd,\n  FlowEventJobStart,\n  FlowEventNodeEnd,\n  FlowEventNodeError,\n  FlowEventNodePause,\n  FlowEventNodeResume,\n  FlowEventNodeStart,\n} from \"@uploadista/core/flow\";\nimport { EventType } from \"@uploadista/core/flow\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\nimport { isFlowEvent } from \"./event-utils\";\n\n/**\n * Options for handling flow execution events.\n *\n * All callbacks are optional - only provide handlers for events you care about.\n */\nexport interface UseFlowEventsOptions {\n  /** Called when a job starts execution */\n  onJobStart?: (event: FlowEventJobStart) => void;\n  /** Called when a job completes (success or failure) */\n  onJobEnd?: (event: FlowEventJobEnd) => void;\n  /** Called when a flow begins execution */\n  onFlowStart?: (event: FlowEventFlowStart) => void;\n  /** Called when a flow completes successfully */\n  onFlowEnd?: (event: FlowEventFlowEnd) => void;\n  /** Called when a flow encounters an error */\n  onFlowError?: (event: FlowEventFlowError) => void;\n  /** Called when a flow is paused by user request */\n  onFlowPause?: (event: FlowEventFlowPause) => void;\n  /** Called when a flow is cancelled by user request */\n  onFlowCancel?: (event: FlowEventFlowCancel) => void;\n  /** Called when a node starts processing */\n  onNodeStart?: (event: FlowEventNodeStart) => void;\n  /** Called when a node completes successfully */\n  onNodeEnd?: (event: FlowEventNodeEnd) => void;\n  /** Called when a node pauses (waiting for additional data) */\n  onNodePause?: (event: FlowEventNodePause) => void;\n  /** Called when a paused node resumes execution */\n  onNodeResume?: (event: FlowEventNodeResume) => void;\n  /** Called when a node encounters an error */\n  onNodeError?: (event: FlowEventNodeError) => void;\n}\n\n/**\n * Structured hook for handling flow execution events with type-safe callbacks.\n *\n * This hook provides a clean API for listening to specific flow events without\n * needing to manually filter events or use type guards.\n *\n * Must be used within UploadistaProvider.\n *\n * @param options - Object with optional callbacks for each flow event type\n *\n * @example\n * ```tsx\n * import { useFlowEvents } from '@uploadista/react';\n *\n * function FlowMonitor() {\n *   useFlowEvents({\n *     onFlowStart: (event) => {\n *       console.log('Flow started:', event.flowId);\n *     },\n *     onNodeStart: (event) => {\n *       console.log('Node started:', event.nodeName);\n *     },\n *     onNodeEnd: (event) => {\n *       console.log('Node completed:', event.nodeName, event.result);\n *     },\n *     onFlowEnd: (event) => {\n *       console.log('Flow completed with outputs:', event.outputs);\n *     },\n *     onFlowError: (event) => {\n *       console.error('Flow failed:', event.error);\n *     },\n *   });\n *\n *   return <div>Monitoring flow execution...</div>;\n * }\n * ```\n */\nexport function useFlowEvents(options: UseFlowEventsOptions): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents((event) => {\n      // Only handle flow events\n      if (!isFlowEvent(event)) return;\n\n      // Route to appropriate callback based on event type\n      switch (event.eventType) {\n        case EventType.JobStart:\n          options.onJobStart?.(event);\n          break;\n        case EventType.JobEnd:\n          options.onJobEnd?.(event);\n          break;\n        case EventType.FlowStart:\n          options.onFlowStart?.(event);\n          break;\n        case EventType.FlowEnd:\n          options.onFlowEnd?.(event);\n          break;\n        case EventType.FlowError:\n          options.onFlowError?.(event);\n          break;\n        case EventType.FlowPause:\n          options.onFlowPause?.(event);\n          break;\n        case EventType.FlowCancel:\n          options.onFlowCancel?.(event);\n          break;\n        case EventType.NodeStart:\n          options.onNodeStart?.(event);\n          break;\n        case EventType.NodeEnd:\n          options.onNodeEnd?.(event);\n          break;\n        case EventType.NodePause:\n          options.onNodePause?.(event);\n          break;\n        case EventType.NodeResume:\n          options.onNodeResume?.(event);\n          break;\n        case EventType.NodeError:\n          options.onNodeError?.(event);\n          break;\n      }\n    });\n\n    return unsubscribe;\n  }, [subscribeToEvents, options]);\n}\n","import { UploadEventType } from \"@uploadista/core/types\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\nimport { isUploadEvent } from \"./event-utils\";\n\n/**\n * Upload progress event data\n */\nexport interface UploadProgressEventData {\n  id: string;\n  progress: number;\n  total: number;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload started/complete event data (contains full UploadFile)\n */\nexport interface UploadFileEventData {\n  // This will contain the full UploadFile schema\n  [key: string]: unknown;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload failed event data\n */\nexport interface UploadFailedEventData {\n  id: string;\n  error: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation success event data\n */\nexport interface UploadValidationSuccessEventData {\n  id: string;\n  validationType: \"checksum\" | \"mimetype\";\n  algorithm?: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation failed event data\n */\nexport interface UploadValidationFailedEventData {\n  id: string;\n  reason: string;\n  expected: string;\n  actual: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Upload validation warning event data\n */\nexport interface UploadValidationWarningEventData {\n  id: string;\n  message: string;\n  flow?: {\n    flowId: string;\n    nodeId: string;\n    jobId: string;\n  };\n}\n\n/**\n * Options for handling upload events.\n *\n * All callbacks are optional - only provide handlers for events you care about.\n */\nexport interface UseUploadEventsOptions {\n  /** Called when an upload starts */\n  onUploadStarted?: (data: UploadFileEventData) => void;\n  /** Called with upload progress updates */\n  onUploadProgress?: (data: UploadProgressEventData) => void;\n  /** Called when an upload completes successfully */\n  onUploadComplete?: (data: UploadFileEventData) => void;\n  /** Called when an upload fails */\n  onUploadFailed?: (data: UploadFailedEventData) => void;\n  /** Called when upload validation succeeds */\n  onUploadValidationSuccess?: (data: UploadValidationSuccessEventData) => void;\n  /** Called when upload validation fails */\n  onUploadValidationFailed?: (data: UploadValidationFailedEventData) => void;\n  /** Called when upload validation produces a warning */\n  onUploadValidationWarning?: (data: UploadValidationWarningEventData) => void;\n}\n\n/**\n * Structured hook for handling upload events with type-safe callbacks.\n *\n * This hook provides a clean API for listening to specific upload events without\n * needing to manually filter events or use type guards.\n *\n * Must be used within UploadistaProvider.\n *\n * @param options - Object with optional callbacks for each upload event type\n *\n * @example\n * ```tsx\n * import { useUploadEvents } from '@uploadista/react';\n *\n * function UploadMonitor() {\n *   useUploadEvents({\n *     onUploadStarted: (data) => {\n *       console.log('Upload started:', data.id);\n *     },\n *     onUploadProgress: (data) => {\n *       const percent = (data.progress / data.total) * 100;\n *       console.log(`Upload progress: ${percent}%`);\n *     },\n *     onUploadComplete: (data) => {\n *       console.log('Upload completed:', data);\n *     },\n *     onUploadFailed: (data) => {\n *       console.error('Upload failed:', data.error);\n *     },\n *   });\n *\n *   return <div>Monitoring uploads...</div>;\n * }\n * ```\n */\nexport function useUploadEvents(options: UseUploadEventsOptions): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents((event) => {\n      // Only handle upload events\n      if (!isUploadEvent(event)) return;\n\n      // Route to appropriate callback based on event type\n      // Note: flow context is at the top level of the event, not inside data\n      const flowContext = \"flow\" in event ? event.flow : undefined;\n\n      switch (event.type) {\n        case UploadEventType.UPLOAD_STARTED:\n          options.onUploadStarted?.({\n            ...(event.data as unknown as Omit<UploadFileEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_PROGRESS:\n          options.onUploadProgress?.({\n            ...(event.data as unknown as Omit<UploadProgressEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_COMPLETE:\n          options.onUploadComplete?.({\n            ...(event.data as unknown as Omit<UploadFileEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_FAILED:\n          options.onUploadFailed?.({\n            ...(event.data as unknown as Omit<UploadFailedEventData, \"flow\">),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_SUCCESS:\n          options.onUploadValidationSuccess?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationSuccessEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_FAILED:\n          options.onUploadValidationFailed?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationFailedEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n        case UploadEventType.UPLOAD_VALIDATION_WARNING:\n          options.onUploadValidationWarning?.({\n            ...(event.data as unknown as Omit<\n              UploadValidationWarningEventData,\n              \"flow\"\n            >),\n            flow: flowContext,\n          });\n          break;\n      }\n    });\n\n    return unsubscribe;\n  }, [subscribeToEvents, options]);\n}\n","import type {\n  ChunkMetrics,\n  PerformanceInsights,\n  UploadSessionMetrics,\n} from \"@uploadista/client-core\";\nimport React, { useCallback, useRef, useState } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\n\nexport type Timeout = ReturnType<typeof setInterval>;\n\nexport interface UploadMetrics {\n  /**\n   * Total bytes uploaded across all files\n   */\n  totalBytesUploaded: number;\n\n  /**\n   * Total bytes to upload across all files\n   */\n  totalBytes: number;\n\n  /**\n   * Overall upload speed in bytes per second\n   */\n  averageSpeed: number;\n\n  /**\n   * Current upload speed in bytes per second\n   */\n  currentSpeed: number;\n\n  /**\n   * Estimated time remaining in milliseconds\n   */\n  estimatedTimeRemaining: number | null;\n\n  /**\n   * Total number of files being tracked\n   */\n  totalFiles: number;\n\n  /**\n   * Number of files completed\n   */\n  completedFiles: number;\n\n  /**\n   * Number of files currently uploading\n   */\n  activeUploads: number;\n\n  /**\n   * Overall progress as percentage (0-100)\n   */\n  progress: number;\n\n  /**\n   * Peak upload speed achieved\n   */\n  peakSpeed: number;\n\n  /**\n   * Start time of the first upload\n   */\n  startTime: number | null;\n\n  /**\n   * End time of the last completed upload\n   */\n  endTime: number | null;\n\n  /**\n   * Total duration of all uploads\n   */\n  totalDuration: number | null;\n\n  /**\n   * Detailed performance insights from the upload client\n   */\n  insights: PerformanceInsights;\n\n  /**\n   * Session metrics for completed uploads\n   */\n  sessionMetrics: Partial<UploadSessionMetrics>[];\n\n  /**\n   * Detailed chunk metrics from recent uploads\n   */\n  chunkMetrics: ChunkMetrics[];\n}\n\nexport interface FileUploadMetrics {\n  id: string;\n  filename: string;\n  size: number;\n  bytesUploaded: number;\n  progress: number;\n  speed: number;\n  startTime: number;\n  endTime: number | null;\n  duration: number | null;\n  isComplete: boolean;\n}\n\nexport interface UseUploadMetricsOptions {\n  /**\n   * Interval for calculating current speed (in milliseconds)\n   */\n  speedCalculationInterval?: number;\n\n  /**\n   * Number of speed samples to keep for average calculation\n   */\n  speedSampleSize?: number;\n\n  /**\n   * Called when metrics are updated\n   */\n  onMetricsUpdate?: (metrics: UploadMetrics) => void;\n\n  /**\n   * Called when a file upload starts\n   */\n  onFileStart?: (fileMetrics: FileUploadMetrics) => void;\n\n  /**\n   * Called when a file upload progresses\n   */\n  onFileProgress?: (fileMetrics: FileUploadMetrics) => void;\n\n  /**\n   * Called when a file upload completes\n   */\n  onFileComplete?: (fileMetrics: FileUploadMetrics) => void;\n}\n\nexport interface UseUploadMetricsReturn {\n  /**\n   * Current overall metrics\n   */\n  metrics: UploadMetrics;\n\n  /**\n   * Individual file metrics\n   */\n  fileMetrics: FileUploadMetrics[];\n\n  /**\n   * Start tracking a new file upload\n   */\n  startFileUpload: (id: string, filename: string, size: number) => void;\n\n  /**\n   * Update progress for a file upload\n   */\n  updateFileProgress: (id: string, bytesUploaded: number) => void;\n\n  /**\n   * Mark a file upload as complete\n   */\n  completeFileUpload: (id: string) => void;\n\n  /**\n   * Remove a file from tracking\n   */\n  removeFile: (id: string) => void;\n\n  /**\n   * Reset all metrics\n   */\n  reset: () => void;\n\n  /**\n   * Get metrics for a specific file\n   */\n  getFileMetrics: (id: string) => FileUploadMetrics | undefined;\n\n  /**\n   * Export metrics as JSON\n   */\n  exportMetrics: () => {\n    overall: UploadMetrics;\n    files: FileUploadMetrics[];\n    exportTime: number;\n  };\n}\n\nconst initialMetrics: UploadMetrics = {\n  totalBytesUploaded: 0,\n  totalBytes: 0,\n  averageSpeed: 0,\n  currentSpeed: 0,\n  estimatedTimeRemaining: null,\n  totalFiles: 0,\n  completedFiles: 0,\n  activeUploads: 0,\n  progress: 0,\n  peakSpeed: 0,\n  startTime: null,\n  endTime: null,\n  totalDuration: null,\n  insights: {\n    overallEfficiency: 0,\n    chunkingEffectiveness: 0,\n    networkStability: 0,\n    recommendations: [],\n    optimalChunkSizeRange: { min: 256 * 1024, max: 2 * 1024 * 1024 },\n  },\n  sessionMetrics: [],\n  chunkMetrics: [],\n};\n\n/**\n * React hook for tracking detailed upload metrics and performance statistics.\n * Provides comprehensive monitoring of upload progress, speed, and timing data.\n *\n * @param options - Configuration and event handlers\n * @returns Upload metrics state and control methods\n *\n * @example\n * ```tsx\n * const uploadMetrics = useUploadMetrics({\n *   speedCalculationInterval: 1000, // Update speed every second\n *   speedSampleSize: 10, // Keep last 10 speed samples for average\n *   onMetricsUpdate: (metrics) => {\n *     console.log(`Overall progress: ${metrics.progress}%`);\n *     console.log(`Speed: ${(metrics.currentSpeed / 1024).toFixed(1)} KB/s`);\n *     console.log(`ETA: ${metrics.estimatedTimeRemaining}ms`);\n *   },\n *   onFileComplete: (fileMetrics) => {\n *     console.log(`${fileMetrics.filename} completed in ${fileMetrics.duration}ms`);\n *   },\n * });\n *\n * // Start tracking a file\n * const handleFileStart = (file: File) => {\n *   uploadMetrics.startFileUpload(file.name, file.name, file.size);\n * };\n *\n * // Update progress during upload\n * const handleProgress = (fileId: string, bytesUploaded: number) => {\n *   uploadMetrics.updateFileProgress(fileId, bytesUploaded);\n * };\n *\n * // Display metrics\n * return (\n *   <div>\n *     <div>Overall Progress: {uploadMetrics.metrics.progress}%</div>\n *     <div>Speed: {(uploadMetrics.metrics.currentSpeed / 1024).toFixed(1)} KB/s</div>\n *     <div>Files: {uploadMetrics.metrics.completedFiles}/{uploadMetrics.metrics.totalFiles}</div>\n *\n *     {uploadMetrics.metrics.estimatedTimeRemaining && (\n *       <div>ETA: {Math.round(uploadMetrics.metrics.estimatedTimeRemaining / 1000)}s</div>\n *     )}\n *\n *     {uploadMetrics.fileMetrics.map((file) => (\n *       <div key={file.id}>\n *         {file.filename}: {file.progress}% ({(file.speed / 1024).toFixed(1)} KB/s)\n *       </div>\n *     ))}\n *   </div>\n * );\n * ```\n */\nexport function useUploadMetrics(\n  options: UseUploadMetricsOptions = {},\n): UseUploadMetricsReturn {\n  const {\n    speedCalculationInterval = 1000,\n    speedSampleSize = 10,\n    onMetricsUpdate,\n    onFileStart,\n    onFileProgress,\n    onFileComplete,\n  } = options;\n\n  const uploadClient = useUploadistaContext();\n\n  const [metrics, setMetrics] = useState<UploadMetrics>(initialMetrics);\n  const [fileMetrics, setFileMetrics] = useState<FileUploadMetrics[]>([]);\n\n  const speedSamplesRef = useRef<Array<{ time: number; bytes: number }>>([]);\n  const lastUpdateRef = useRef<number>(0);\n  const intervalRef = useRef<Timeout | null>(null);\n\n  const calculateSpeed = useCallback(\n    (currentTime: number, totalBytesUploaded: number) => {\n      const sample = { time: currentTime, bytes: totalBytesUploaded };\n      speedSamplesRef.current.push(sample);\n\n      // Keep only recent samples\n      if (speedSamplesRef.current.length > speedSampleSize) {\n        speedSamplesRef.current = speedSamplesRef.current.slice(\n          -speedSampleSize,\n        );\n      }\n\n      // Calculate current speed (bytes per second)\n      let currentSpeed = 0;\n      if (speedSamplesRef.current.length >= 2) {\n        const recent =\n          speedSamplesRef.current[speedSamplesRef.current.length - 1];\n        const previous =\n          speedSamplesRef.current[speedSamplesRef.current.length - 2];\n        if (recent && previous) {\n          const timeDiff = (recent.time - previous.time) / 1000; // Convert to seconds\n          const bytesDiff = recent.bytes - previous.bytes;\n          currentSpeed = timeDiff > 0 ? bytesDiff / timeDiff : 0;\n        }\n      }\n\n      // Calculate average speed\n      let averageSpeed = 0;\n      if (speedSamplesRef.current.length >= 2) {\n        const first = speedSamplesRef.current[0];\n        const last =\n          speedSamplesRef.current[speedSamplesRef.current.length - 1];\n        if (first && last) {\n          const totalTime = (last.time - first.time) / 1000; // Convert to seconds\n          const totalBytes = last.bytes - first.bytes;\n          averageSpeed = totalTime > 0 ? totalBytes / totalTime : 0;\n        }\n      }\n\n      return { currentSpeed, averageSpeed };\n    },\n    [speedSampleSize],\n  );\n\n  const updateMetrics = useCallback(() => {\n    const now = Date.now();\n\n    // Calculate totals from file metrics\n    const totalBytes = fileMetrics.reduce((sum, file) => sum + file.size, 0);\n    const totalBytesUploaded = fileMetrics.reduce(\n      (sum, file) => sum + file.bytesUploaded,\n      0,\n    );\n    const completedFiles = fileMetrics.filter((file) => file.isComplete).length;\n    const activeUploads = fileMetrics.filter(\n      (file) => !file.isComplete && file.bytesUploaded > 0,\n    ).length;\n\n    // Calculate speeds\n    const { currentSpeed, averageSpeed } = calculateSpeed(\n      now,\n      totalBytesUploaded,\n    );\n\n    // Calculate progress\n    const progress =\n      totalBytes > 0 ? Math.round((totalBytesUploaded / totalBytes) * 100) : 0;\n\n    // Calculate estimated time remaining\n    let estimatedTimeRemaining: number | null = null;\n    if (currentSpeed > 0) {\n      const remainingBytes = totalBytes - totalBytesUploaded;\n      estimatedTimeRemaining = (remainingBytes / currentSpeed) * 1000; // Convert to milliseconds\n    }\n\n    // Find start and end times\n    const activeTimes = fileMetrics.filter((file) => file.startTime > 0);\n    const startTime =\n      activeTimes.length > 0\n        ? Math.min(...activeTimes.map((file) => file.startTime))\n        : null;\n\n    const completedTimes = fileMetrics.filter((file) => file.endTime !== null);\n    const endTime =\n      completedTimes.length > 0 && completedFiles === fileMetrics.length\n        ? Math.max(\n            ...completedTimes\n              .map((file) => file.endTime)\n              .filter((time) => time !== null),\n          )\n        : null;\n\n    const totalDuration = startTime && endTime ? endTime - startTime : null;\n\n    const newMetrics: UploadMetrics = {\n      totalBytesUploaded,\n      totalBytes,\n      averageSpeed,\n      currentSpeed,\n      estimatedTimeRemaining,\n      totalFiles: fileMetrics.length,\n      completedFiles,\n      activeUploads,\n      progress,\n      peakSpeed: Math.max(metrics.peakSpeed, currentSpeed),\n      startTime,\n      endTime,\n      totalDuration,\n      insights: uploadClient.client.getChunkingInsights(),\n      sessionMetrics: [uploadClient.client.exportMetrics().session],\n      chunkMetrics: uploadClient.client.exportMetrics().chunks,\n    };\n\n    setMetrics(newMetrics);\n    onMetricsUpdate?.(newMetrics);\n  }, [\n    fileMetrics,\n    metrics.peakSpeed,\n    calculateSpeed,\n    onMetricsUpdate,\n    uploadClient.client,\n  ]);\n\n  // Set up periodic speed calculations\n  const setupSpeedCalculation = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n    }\n\n    intervalRef.current = setInterval(() => {\n      if (\n        fileMetrics.some((file) => !file.isComplete && file.bytesUploaded > 0)\n      ) {\n        updateMetrics();\n      }\n    }, speedCalculationInterval);\n\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n        intervalRef.current = null;\n      }\n    };\n  }, [speedCalculationInterval, updateMetrics, fileMetrics]);\n\n  const startFileUpload = useCallback(\n    (id: string, filename: string, size: number) => {\n      const now = Date.now();\n\n      const fileMetric: FileUploadMetrics = {\n        id,\n        filename,\n        size,\n        bytesUploaded: 0,\n        progress: 0,\n        speed: 0,\n        startTime: now,\n        endTime: null,\n        duration: null,\n        isComplete: false,\n      };\n\n      setFileMetrics((prev) => {\n        const existing = prev.find((file) => file.id === id);\n        if (existing) {\n          return prev.map((file) => (file.id === id ? fileMetric : file));\n        }\n        return [...prev, fileMetric];\n      });\n\n      onFileStart?.(fileMetric);\n\n      // Start speed calculation if this is the first active upload\n      if (fileMetrics.filter((file) => !file.isComplete).length === 0) {\n        setupSpeedCalculation();\n      }\n    },\n    [fileMetrics, onFileStart, setupSpeedCalculation],\n  );\n\n  const updateFileProgress = useCallback(\n    (id: string, bytesUploaded: number) => {\n      const now = Date.now();\n\n      setFileMetrics((prev) =>\n        prev.map((file) => {\n          if (file.id !== id) return file;\n\n          const timeDiff = (now - file.startTime) / 1000; // seconds\n          const speed = timeDiff > 0 ? bytesUploaded / timeDiff : 0;\n          const progress =\n            file.size > 0 ? Math.round((bytesUploaded / file.size) * 100) : 0;\n\n          const updatedFile = {\n            ...file,\n            bytesUploaded,\n            progress,\n            speed,\n          };\n\n          onFileProgress?.(updatedFile);\n          return updatedFile;\n        }),\n      );\n\n      // Trigger metrics update\n      setTimeout(updateMetrics, 0);\n    },\n    [onFileProgress, updateMetrics],\n  );\n\n  const completeFileUpload = useCallback(\n    (id: string) => {\n      const now = Date.now();\n\n      setFileMetrics((prev) =>\n        prev.map((file) => {\n          if (file.id !== id) return file;\n\n          const duration = now - file.startTime;\n          const speed = duration > 0 ? (file.size / duration) * 1000 : 0; // bytes per second\n\n          const completedFile = {\n            ...file,\n            bytesUploaded: file.size,\n            progress: 100,\n            speed,\n            endTime: now,\n            duration,\n            isComplete: true,\n          };\n\n          onFileComplete?.(completedFile);\n          return completedFile;\n        }),\n      );\n\n      // Trigger metrics update\n      setTimeout(updateMetrics, 0);\n    },\n    [onFileComplete, updateMetrics],\n  );\n\n  const removeFile = useCallback(\n    (id: string) => {\n      setFileMetrics((prev) => prev.filter((file) => file.id !== id));\n      setTimeout(updateMetrics, 0);\n    },\n    [updateMetrics],\n  );\n\n  const reset = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n      intervalRef.current = null;\n    }\n\n    setMetrics(initialMetrics);\n    setFileMetrics([]);\n    speedSamplesRef.current = [];\n    lastUpdateRef.current = 0;\n  }, []);\n\n  const getFileMetrics = useCallback(\n    (id: string) => {\n      return fileMetrics.find((file) => file.id === id);\n    },\n    [fileMetrics],\n  );\n\n  const exportMetrics = useCallback(() => {\n    return {\n      overall: metrics,\n      files: fileMetrics,\n      exportTime: Date.now(),\n    };\n  }, [metrics, fileMetrics]);\n\n  // Cleanup on unmount\n  React.useEffect(() => {\n    return () => {\n      if (intervalRef.current) {\n        clearInterval(intervalRef.current);\n      }\n    };\n  }, []);\n\n  return {\n    metrics,\n    fileMetrics,\n    startFileUpload,\n    updateFileProgress,\n    completeFileUpload,\n    removeFile,\n    reset,\n    getFileMetrics,\n    exportMetrics,\n  };\n}\n","import type { UploadistaEvent } from \"@uploadista/client-core\";\nimport { useEffect } from \"react\";\nimport { useUploadistaContext } from \"../components/uploadista-provider\";\n\n/**\n * Simple hook that subscribes to all Uploadista events (both flow and upload events).\n *\n * This is a low-level hook that provides access to all events. For more structured\n * event handling, consider using `useFlowEvents` or `useUploadEvents` instead.\n *\n * Must be used within UploadistaProvider.\n *\n * @param callback - Function called for every event emitted by the Uploadista client\n *\n * @example\n * ```tsx\n * import { useUploadistaEvents, isFlowEvent, isUploadEvent } from '@uploadista/react';\n *\n * function MyComponent() {\n *   useUploadistaEvents((event) => {\n *     if (isFlowEvent(event)) {\n *       console.log('Flow event:', event.eventType);\n *     } else if (isUploadEvent(event)) {\n *       console.log('Upload event:', event.type);\n *     }\n *   });\n *\n *   return <div>Listening to all events...</div>;\n * }\n * ```\n */\nexport function useUploadistaEvents(\n  callback: (event: UploadistaEvent) => void,\n): void {\n  const { subscribeToEvents } = useUploadistaContext();\n\n  useEffect(() => {\n    const unsubscribe = subscribeToEvents(callback);\n    return unsubscribe;\n  }, [subscribeToEvents, callback]);\n}\n"],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@uploadista/react",
   "type": "module",
-  "version": "0.0.20",
+  "version": "0.1.0-beta.5",
   "description": "React client for Uploadista",
   "license": "MIT",
   "author": "Uploadista",
@@ -22,23 +22,26 @@
   "dependencies": {
     "react": "19.2.3",
     "react-dom": "19.2.3",
-    "@uploadista/core": "0.0.20",
-    "@uploadista/client-core": "0.0.20",
-    "@uploadista/client-browser": "0.0.20"
+    "@uploadista/client-browser": "0.1.0-beta.5",
+    "@uploadista/client-core": "0.1.0-beta.5",
+    "@uploadista/core": "0.1.0-beta.5"
   },
   "devDependencies": {
-    "@types/react": "19.2.7",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "19.2.8",
     "@types/react-dom": "19.2.3",
-    "tsdown": "0.18.0",
-    "vitest": "4.0.15",
-    "@uploadista/typescript-config": "0.0.20"
+    "jsdom": "^27.0.0",
+    "tsdown": "0.19.0",
+    "vitest": "4.0.17",
+    "@uploadista/typescript-config": "0.1.0-beta.5"
   },
   "scripts": {
     "build": "tsc --noEmit && tsdown",
     "format": "biome format --write ./src",
     "lint": "biome lint --write ./src",
     "check": "biome check --write ./src",
-    "test": "vitest",
+    "test": "vitest run",
     "test:run": "vitest run",
     "test:watch": "vitest --watch"
   }

package/src/__tests__/event-utils.test.ts

@@ -0,0 +1,179 @@
+import { describe, expect, it } from "vitest";
+import { isFlowEvent, isUploadEvent } from "../hooks/event-utils";
+
+describe("event-utils", () => {
+  describe("isFlowEvent", () => {
+    it("should return true for job-start event", () => {
+      const event = { eventType: "job-start" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for job-end event", () => {
+      const event = { eventType: "job-end" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for flow-start event", () => {
+      const event = { eventType: "flow-start" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for flow-end event", () => {
+      const event = { eventType: "flow-end" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for flow-error event", () => {
+      const event = { eventType: "flow-error" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for flow-pause event", () => {
+      const event = { eventType: "flow-pause" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for flow-cancel event", () => {
+      const event = { eventType: "flow-cancel" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-start event", () => {
+      const event = { eventType: "node-start" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-end event", () => {
+      const event = { eventType: "node-end" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-pause event", () => {
+      const event = { eventType: "node-pause" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-resume event", () => {
+      const event = { eventType: "node-resume" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-error event", () => {
+      const event = { eventType: "node-error" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-stream event", () => {
+      const event = { eventType: "node-stream" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for node-response event", () => {
+      const event = { eventType: "node-response" };
+      expect(isFlowEvent(event as any)).toBe(true);
+    });
+
+    it("should return false for upload events", () => {
+      const event = { type: "upload-started" };
+      expect(isFlowEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for events without eventType", () => {
+      const event = { someOtherProperty: "value" };
+      expect(isFlowEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for events with unknown eventType", () => {
+      const event = { eventType: "unknown-event" };
+      expect(isFlowEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for empty object", () => {
+      expect(isFlowEvent({} as any)).toBe(false);
+    });
+  });
+
+  describe("isUploadEvent", () => {
+    it("should return true for upload-started event", () => {
+      const event = { type: "upload-started" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-progress event", () => {
+      const event = { type: "upload-progress" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-complete event", () => {
+      const event = { type: "upload-complete" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-failed event", () => {
+      const event = { type: "upload-failed" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-validation-success event", () => {
+      const event = { type: "upload-validation-success" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-validation-failed event", () => {
+      const event = { type: "upload-validation-failed" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return true for upload-validation-warning event", () => {
+      const event = { type: "upload-validation-warning" };
+      expect(isUploadEvent(event as any)).toBe(true);
+    });
+
+    it("should return false for flow events", () => {
+      const event = { eventType: "flow-start" };
+      expect(isUploadEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for events without type property", () => {
+      const event = { eventType: "upload-started" };
+      expect(isUploadEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for events with unknown type", () => {
+      const event = { type: "unknown-event" };
+      expect(isUploadEvent(event as any)).toBe(false);
+    });
+
+    it("should return false for empty object", () => {
+      expect(isUploadEvent({} as any)).toBe(false);
+    });
+  });
+
+  describe("mutually exclusive events", () => {
+    it("should only match isFlowEvent for flow events", () => {
+      const flowEvents = [
+        { eventType: "job-start" },
+        { eventType: "flow-start" },
+        { eventType: "node-start" },
+      ];
+
+      for (const event of flowEvents) {
+        expect(isFlowEvent(event as any)).toBe(true);
+        expect(isUploadEvent(event as any)).toBe(false);
+      }
+    });
+
+    it("should only match isUploadEvent for upload events", () => {
+      const uploadEvents = [
+        { type: "upload-started" },
+        { type: "upload-progress" },
+        { type: "upload-complete" },
+      ];
+
+      for (const event of uploadEvents) {
+        expect(isUploadEvent(event as any)).toBe(true);
+        expect(isFlowEvent(event as any)).toBe(false);
+      }
+    });
+  });
+});

package/src/__tests__/setup.ts

@@ -0,0 +1,40 @@
+import "@testing-library/jest-dom/vitest";
+import { vi } from "vitest";
+
+// Mock the uploadista client-browser module
+vi.mock("@uploadista/client-browser", () => ({
+  createUploadistaClient: vi.fn(() => ({
+    upload: vi.fn(),
+    executeFlow: vi.fn(),
+    discoverFlowInputs: vi.fn(),
+    getChunkingInsights: vi.fn(() => ({
+      currentChunkSize: 1024 * 1024,
+      recommendedChunkSize: 1024 * 1024,
+      networkCondition: "good",
+    })),
+    exportMetrics: vi.fn(() => ({})),
+    getNetworkMetrics: vi.fn(() => ({
+      averageSpeed: 1024 * 1024,
+      currentSpeed: 1024 * 1024,
+      estimatedTimeRemaining: 0,
+    })),
+    getNetworkCondition: vi.fn(() => "good"),
+    resetMetrics: vi.fn(),
+  })),
+}));
+
+// Mock UploadManager from client-core
+vi.mock("@uploadista/client-core", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("@uploadista/client-core")>();
+  return {
+    ...actual,
+    UploadManager: vi.fn().mockImplementation(() => ({
+      upload: vi.fn(),
+      abort: vi.fn(),
+      reset: vi.fn(),
+      retry: vi.fn(),
+      cleanup: vi.fn(),
+      canRetry: vi.fn(() => false),
+    })),
+  };
+});