@vidtreo/recorder 0.8.0 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +69 -13
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -641,19 +641,75 @@ These defaults are used when backend configuration is unavailable or during init
641
641
 
642
642
  ## Browser Compatibility
643
643
 
644
- This package requires modern browser APIs:
645
-
646
- - MediaDevices API for camera and microphone access
647
- - MediaRecorder API for recording
648
- - Screen Capture API for screen recording
649
- - OffscreenCanvas API for video processing
650
- - Web Audio API for audio processing
651
-
652
- Supported browsers:
653
- - Chrome 94+
654
- - Firefox 92+
655
- - Safari 15.4+
656
- - Edge 94+
644
+ This package requires modern browser APIs for full functionality. The most critical requirement is support for the **WebCodecs API**, which enables real-time MP4 transcoding.
645
+
646
+ ### Full Support (All Features)
647
+
648
+ The following browsers support all features including real-time MP4 transcoding:
649
+
650
+ - **Chrome 94+** - Full support for all features
651
+ - **Edge (Chromium) 94+** - Full support, same as Chrome
652
+ - **Opera 80+** - Full support, Chromium-based
653
+ - **Brave 1.30+** - Full support, Chromium-based
654
+ - **Vivaldi 5.0+** - Full support, Chromium-based
655
+ - **Firefox 130+** - Full WebCodecs support
656
+ - **Safari (macOS/iOS) 26.0+** - Full WebCodecs support
657
+
658
+ ### Partial Support (Core Features Only)
659
+
660
+ The following browsers support core recording features but may have limitations:
661
+
662
+ - **Firefox 76-129** - AudioWorklet supported, but WebCodecs not available. Real-time MP4 transcoding unavailable; falls back to MediaRecorder (WebM format)
663
+ - **Safari (macOS/iOS) 16.4-25.x** - Partial WebCodecs support; some codecs may not be available
664
+
665
+ ### Required Browser APIs
666
+
667
+ - **WebCodecs API** - Required for real-time MP4 transcoding (via mediabunny)
668
+ - **OffscreenCanvas** - Required for video frame processing
669
+ - **AudioWorklet** - Required for audio processing and level analysis
670
+ - **MediaRecorder API** - Used as fallback recording method
671
+ - **Screen Capture API** (`getDisplayMedia`) - Required for screen recording
672
+ - **MediaDevices API** (`getUserMedia`) - Required for camera/microphone access
673
+ - **IndexedDB** - Required for persistent upload queue
674
+ - **Storage API** - Required for storage quota management
675
+
676
+ ### Feature Support by Browser
677
+
678
+ | Feature | Chrome 94+ | Edge 94+ | Firefox 130+ | Safari 26.0+ | Firefox 76-129 | Safari 16.4-25.x |
679
+ |---------|------------|---------|--------------|--------------|---------------|------------------|
680
+ | Camera Recording | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
681
+ | Screen Recording | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
682
+ | Real-time MP4 Transcoding | ✅ | ✅ | ✅ | ✅ | ❌ (WebM) | ⚠️ (Partial) |
683
+ | Audio Level Analysis | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
684
+ | Source Switching | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
685
+ | Device Switching | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
686
+ | Persistent Upload Queue | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
687
+
688
+ ### Unsupported Browsers
689
+
690
+ - Internet Explorer (all versions)
691
+ - Firefox < 76 (missing AudioWorklet)
692
+ - Safari < 14.1 (missing AudioWorklet)
693
+ - Safari < 16.4 (missing OffscreenCanvas and WebCodecs)
694
+ - Edge Legacy (pre-Chromium)
695
+ - Chrome < 94 (missing WebCodecs)
696
+
697
+ ### Mobile Browser Support
698
+
699
+ - **Chrome Android 94+** - Full support
700
+ - **Samsung Internet 18.0+** - Full support
701
+ - **Firefox Android 130+** - Full support
702
+ - **Safari iOS 16.4+** - Partial support (WebCodecs partial)
703
+ - **Safari iOS 26.0+** - Full support
704
+
705
+ ### Important Notes
706
+
707
+ 1. **HTTPS Required**: Media capture APIs require HTTPS (or localhost) in most browsers
708
+ 2. **User Permissions**: Camera, microphone, and screen capture require explicit user permission
709
+ 3. **Automatic Fallback**: The package automatically falls back to MediaRecorder when WebCodecs is unavailable (produces WebM instead of MP4)
710
+ 4. **Feature Detection**: The package includes feature detection and gracefully degrades functionality when APIs are unavailable
711
+
712
+ For detailed browser compatibility information, API requirements, and known limitations, see [BROWSER_COMPATIBILITY.md](./BROWSER_COMPATIBILITY.md).
657
713
 
658
714
  ## License
659
715
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vidtreo/recorder",
3
- "version": "0.8.0",
3
+ "version": "0.8.1",
4
4
  "type": "module",
5
5
  "description": "Vidtreo SDK for browser-based video recording and transcoding. Features include camera/screen recording, real-time MP4 transcoding, audio level analysis, mute/pause controls, source switching, device selection, and automatic backend uploads. Similar to Ziggeo and Addpipe, Vidtreo provides enterprise-grade video processing capabilities for web applications.",
6
6
  "main": "./dist/index.js",