tus-js-client-stall-detection/lib.cjs/StallDetector.js

A pure JavaScript client for the tus resumable upload protocol

"use strict";
Object.defineProperty(exports, "__esModule", { value: true });
exports.StallDetector = void 0;
const logger_js_1 = require("./logger.js");
class StallDetector {
    constructor(options, onStallDetected) {
        this.intervalId = null;
        this.lastProgressTime = 0;
        this.isActive = false;
        this.options = options;
        this.onStallDetected = onStallDetected;
    }
    /**
     * Start monitoring for stalls
     */
    start() {
        if (this.intervalId) {
            return; // Already started
        }
        this.lastProgressTime = Date.now();
        this.isActive = true;
        (0, logger_js_1.log)(`tus: starting stall detection with checkInterval: ${this.options.checkInterval}ms, stallTimeout: ${this.options.stallTimeout}ms`);
        // Setup periodic check
        this.intervalId = setInterval(() => {
            if (!this.isActive) {
                return;
            }
            const now = Date.now();
            if (this._isProgressStalled(now)) {
                this._handleStall('no progress');
            }
        }, this.options.checkInterval);
    }
    /**
     * Stop monitoring for stalls
     */
    stop() {
        this.isActive = false;
        if (this.intervalId) {
            clearInterval(this.intervalId);
            this.intervalId = null;
        }
    }
    /**
     * Update progress information
     * @param _progressValue The current progress value (bytes uploaded) - currently unused but kept for future use
     */
    updateProgress(_progressValue) {
        // Only track that a progress event occurred, not the actual value
        // This avoids false positives with NodeHttpStack's buffer behavior
        this.lastProgressTime = Date.now();
    }
    /**
     * Check if upload has stalled based on progress events
     */
    _isProgressStalled(now) {
        const timeSinceProgress = now - this.lastProgressTime;
        const stallTimeout = this.options.stallTimeout;
        const isStalled = timeSinceProgress > stallTimeout;
        if (isStalled) {
            (0, logger_js_1.log)(`tus: no progress for ${timeSinceProgress}ms (limit: ${stallTimeout}ms)`);
        }
        return isStalled;
    }
    /**
     * Handle a detected stall
     */
    _handleStall(reason) {
        (0, logger_js_1.log)(`tus: upload stalled: ${reason}`);
        this.stop();
        this.onStallDetected(reason);
    }
}
exports.StallDetector = StallDetector;
//# sourceMappingURL=StallDetector.js.map