@vidtreo/recorder 1.7.5 → 1.7.7

package/dist/index.js

@@ -3075,7 +3075,6 @@ var DEFAULT_RETENTION_HOURS = 24;
 var MAX_RETRIES = 10;
 var MILLISECONDS_PER_HOUR = 60 * 60 * 1000;
 var ID_PREFIX = "upload-";
-var ID_RANDOM_LENGTH = 9;
 var VERSION_ERROR_NAME = "VersionError";
 var ERROR_SCHEMA_MISSING_STORE = "Database schema is missing required object store: pending-uploads";
 var ERROR_SCHEMA_MISSING_STATUS_INDEX = "Database schema is missing required index: status";
@@ -3371,7 +3370,7 @@ class VideoStorageService {
     });
   }
   generateUploadId() {
-    return `${ID_PREFIX}${Date.now()}-${Math.random().toString(36).substring(2, 2 + ID_RANDOM_LENGTH)}`;
+    return `${ID_PREFIX}${crypto.randomUUID()}`;
   }
   executeTransaction(mode, operation) {
     if (!this.db) {
@@ -6075,8 +6074,6 @@ var RECORDING_CODEC_UNSUPPORTED_CODES = new Set([
 ]);
 var RECORDING_SERVER_TRANSCODE_FALLBACK_CODES = new Set([
   "recording.post-recording-transcode-fallback",
-  "recording.mediarecorder-empty",
-  "recording.mediarecorder-error",
   "transcode.post-recording-fallback",
   "route.post-recording-transcode-fallback"
 ]);
@@ -6129,6 +6126,12 @@ function classifyRecordingPipelineCode(errorCode) {
   if (RECORDING_CODEC_UNSUPPORTED_CODES.has(errorCode)) {
     return "recording.codec-unsupported";
   }
+  if (errorCode === "recording.mediarecorder-empty") {
+    return "recording.mediarecorder-empty";
+  }
+  if (errorCode === "recording.mediarecorder-error") {
+    return "recording.mediarecorder-error";
+  }
   if (RECORDING_SERVER_TRANSCODE_FALLBACK_CODES.has(errorCode)) {
     return "recording.post-recording-transcode-fallback";
   }
@@ -6312,7 +6315,7 @@ function resolveDeviceError(input) {
 // package.json
 var package_default = {
   name: "@vidtreo/recorder",
-  version: "1.7.5",
+  version: "1.7.7",
   type: "module",
   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.",
   main: "./dist/index.js",
@@ -7204,6 +7207,7 @@ class UploadQueueManager {
         apiKey: upload.apiKey,
         backendUrl: upload.backendUrl,
         filename: upload.filename,
+        idempotencyKey: upload.id,
         mimeType: upload.mimeType,
         metadata: upload.metadata,
         userMetadata: upload.userMetadata,
@@ -7286,6 +7290,7 @@ class UploadQueueManager {
 // src/core/upload/upload-service.ts
 var API_UPLOAD_PATH = "/api/v1/videos/upload";
 var MIME_TYPE_PARAMETER_SEPARATOR = ";";
+var MAX_TRANSFER_PROGRESS = 0.99;
 var UPLOAD_INACTIVITY_TIMEOUT_MS = 45000;
 var UPLOAD_INACTIVITY_ERROR = "Upload stalled after 45 seconds without progress";
 
@@ -7297,15 +7302,17 @@ class VideoUploadService {
     if (!blob.type || blob.type.trim() === "") {
       throw new Error("Blob type is required");
     }
-    return this.uploadVideoFile(blob, options);
+    const idempotencyKey = this.resolveIdempotencyKey(options.idempotencyKey);
+    return this.uploadVideoFile(blob, options, idempotencyKey);
   }
-  uploadVideoFile(blob, options) {
+  uploadVideoFile(blob, options, idempotencyKey) {
     return new Promise((resolve, reject) => {
       const xhr = new XMLHttpRequest;
       const uploadBlob = this.createUploadBlob(blob, options.mimeType);
       let inactivityTimeoutId = null;
       let isSettled = false;
       let loadedBytes = 0;
+      let totalBytes = 0;
       const clearInactivityTimeout = () => {
         if (inactivityTimeoutId === null) {
           return;
@@ -7330,6 +7337,7 @@ class VideoUploadService {
         }
         isSettled = true;
         clearInactivityTimeout();
+        this.reportCompletion(options, loadedBytes, totalBytes);
         resolve(result);
       };
       const restartInactivityTimeout = () => {
@@ -7344,6 +7352,7 @@ class VideoUploadService {
           return;
         }
         loadedBytes = event.loaded;
+        totalBytes = event.total;
         restartInactivityTimeout();
       });
       xhr.addEventListener("load", () => {
@@ -7362,6 +7371,7 @@ class VideoUploadService {
       const url = `${options.backendUrl}${API_UPLOAD_PATH}`;
       xhr.open("POST", url);
       xhr.setRequestHeader("Authorization", `Bearer ${options.apiKey}`);
+      xhr.setRequestHeader("Idempotency-Key", idempotencyKey);
       const formData = new FormData;
       formData.append("file", uploadBlob, options.filename);
       const metadata = {
@@ -7376,11 +7386,17 @@ class VideoUploadService {
       restartInactivityTimeout();
     });
   }
+  resolveIdempotencyKey(idempotencyKey) {
+    if (idempotencyKey) {
+      return idempotencyKey;
+    }
+    return crypto.randomUUID();
+  }
   reportProgress(event, options) {
     if (!event.lengthComputable) {
       return;
     }
-    const progress = event.loaded / event.total;
+    const progress = Math.min(event.loaded / event.total, MAX_TRANSFER_PROGRESS);
     options.onProgress?.(progress);
     options.onProgressDetails?.({
       progress,
@@ -7388,6 +7404,14 @@ class VideoUploadService {
       totalBytes: event.total
     });
   }
+  reportCompletion(options, loadedBytes, totalBytes) {
+    options.onProgress?.(1);
+    options.onProgressDetails?.({
+      progress: 1,
+      loadedBytes,
+      totalBytes
+    });
+  }
   createUploadBlob(blob, mimeType) {
     const normalizedMimeType = this.resolveUploadMimeType(blob, mimeType);
     if (normalizedMimeType === blob.type) {
@@ -22773,6 +22797,7 @@ class RecordingManager {
   startupAborted = false;
   activeRecordingConfig = null;
   activeRouteDecision = DEFAULT_ROUTE_DECISION2;
+  isFinalizingRecording = false;
   constructor(streamManager, callbacks, dependencies) {
     this.streamManager = streamManager;
     this.callbacks = callbacks;
@@ -22823,6 +22848,9 @@ class RecordingManager {
     }
   }
   async startRecording() {
+    if (this.recordingState !== RECORDING_STATE_IDLE || this.isFinalizingRecording) {
+      throw new Error("Recording is not ready to start");
+    }
     try {
       this.callbacks.onClearUploadStatus();
       if (this.countdownDuration > 0) {
@@ -22947,16 +22975,26 @@ class RecordingManager {
   }
   async stopRecording() {
     logger.debug("[RecordingManager] stopRecording called");
-    try {
-      if (this.recordingState !== RECORDING_STATE_RECORDING) {
-        const stopRequestedState = this.recordingState;
-        this.cancelCountdown();
-        throw createRecordingLifecycleError(ERROR_RECORDING_STOP_NOT_READY, "Recording is not ready to stop", {
-          recordingState: stopRequestedState,
-          hasStreamProcessor: !!this.streamProcessor
-        });
-      }
+    if (this.isFinalizingRecording) {
+      throw createRecordingLifecycleError(ERROR_RECORDING_STOP_NOT_READY, "Recording is not ready to stop", {
+        recordingState: this.recordingState,
+        hasStreamProcessor: !!this.streamProcessor
+      });
+    }
+    if (this.recordingState !== RECORDING_STATE_RECORDING) {
+      const stopRequestedState = this.recordingState;
       this.cancelCountdown();
+      const error = createRecordingLifecycleError(ERROR_RECORDING_STOP_NOT_READY, "Recording is not ready to stop", {
+        recordingState: stopRequestedState,
+        hasStreamProcessor: !!this.streamProcessor
+      });
+      this.handleError(error);
+      throw error;
+    }
+    this.isFinalizingRecording = true;
+    try {
+      this.callbacks.onFinalizationStart?.();
+      this.clearCountdownTimers();
       this.clearTimer(this.recordingIntervalId, clearInterval);
       this.recordingIntervalId = null;
       this.clearTimer(this.maxTimeTimer, clearTimeout);
@@ -23002,6 +23040,7 @@ class RecordingManager {
       }
       throw normalizedError;
     } finally {
+      this.isFinalizingRecording = false;
       this.activeRecordingConfig = null;
       this.activeRouteDecision = DEFAULT_ROUTE_DECISION2;
     }
@@ -23035,14 +23074,17 @@ class RecordingManager {
     }
   }
   cancelCountdown() {
+    this.clearCountdownTimers();
+    this.recordingState = RECORDING_STATE_IDLE;
+    this.callbacks.onCountdownUpdate(this.recordingState, this.countdownRemaining);
+  }
+  clearCountdownTimers() {
     this.clearTimer(this.countdownTimeoutId, clearTimeout);
     this.countdownTimeoutId = null;
     this.clearTimer(this.countdownIntervalId, clearInterval);
     this.countdownIntervalId = null;
-    this.recordingState = RECORDING_STATE_IDLE;
     this.countdownRemaining = 0;
     this.countdownStartTime = null;
-    this.callbacks.onCountdownUpdate(this.recordingState, this.countdownRemaining);
   }
   cleanup() {
     this.cancelCountdown();
@@ -23142,6 +23184,9 @@ class RecordingManager {
     this.callbacks.onError(errorMessage);
   }
   handleFatalProcessorError(error) {
+    if (this.isFinalizingRecording) {
+      return;
+    }
     if (this.recordingState === RECORDING_STATE_RECORDING) {
       this.clearTimer(this.recordingIntervalId, clearInterval);
       this.recordingIntervalId = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vidtreo/recorder",
-  "version": "1.7.5",
+  "version": "1.7.7",
   "type": "module",
   "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.",
   "main": "./dist/index.js",