homebridge-unifi-protect 7.14.0 → 7.16.0

package/dist/ffmpeg/protect-ffmpeg-record.js

@@ -1,246 +0,0 @@
-/* Copyright(C) 2017-2025, HJD (https://github.com/hjdhjd). All rights reserved.
- *
- * protect-ffmpeg-record.ts: Provide FFmpeg process control to support HomeKit Secure Video.
- *
- */
-import { PROTECT_HKSV_IDR_INTERVAL, PROTECT_HKSV_TIMEOUT } from "../settings.js";
-import { FfmpegProcess } from "./protect-ffmpeg.js";
-import { once } from "node:events";
-import { runWithTimeout } from "homebridge-plugin-utils";
-// FFmpeg HomeKit Streaming Video recording process management.
-export class FfmpegRecordingProcess extends FfmpegProcess {
-    isLoggingErrors;
-    isTimedOut;
-    recordingBuffer;
-    recordingConfig;
-    // Create a new FFmpeg process instance.
-    constructor(protectCamera, recordingConfig, rtspEntry, isAudioActive) {
-        // Initialize our parent.
-        super(protectCamera);
-        // We want to log errors when they occur.
-        this.isLoggingErrors = true;
-        // Initialize our recording buffer.
-        this.recordingBuffer = [];
-        // Initialize our state.
-        this.isTimedOut = false;
-        // Save our recording configuration.
-        this.recordingConfig = recordingConfig;
-        // Configure our video parameters for our input:
-        //
-        // -hide_banner                  Suppress printing the startup banner in FFmpeg.
-        // -nostats                      Suppress printing progress reports while encoding in FFmpeg.
-        // -fflags flags                 Set the format flags to generate a presentation timestamp if it's missing and discard any corrupt packets rather than exit.
-        // -err_detect ignore_err        Ignore decoding errors and continue rather than exit.
-        // -probesize number             How many bytes should be analyzed for stream information. Use the size of the timeshift buffer or our configured defaults.
-        // -r fps                        Set the input frame rate for the video stream.
-        // -f mp4                        Tell FFmpeg that it should expect an MP4-encoded input stream.
-        // -i pipe:0                     Use standard input to get video data.
-        // -ss                           Fast forward to where HKSV is expecting us to be for a recording event.
-        this.commandLineArgs = [
-            "-hide_banner",
-            "-nostats",
-            "-fflags", "+discardcorrupt+genpts",
-            "-err_detect", "ignore_err",
-            "-probesize", (protectCamera.stream.hksv?.timeshift.buffer?.length ?? protectCamera.stream.probesize).toString(),
-            "-r", rtspEntry.channel.fps.toString(),
-            "-f", "mp4",
-            "-i", "pipe:0",
-            "-ss", Math.max((protectCamera.stream.hksv?.timeshift.time ?? 0) - recordingConfig.prebufferLength, 0).toString() + "ms"
-        ];
-        // Configure our recording options for the video stream:
-        //
-        // -map 0:v:0                    Selects the first available video track from the stream. Protect actually maps audio
-        //                               and video tracks in opposite locations from where FFmpeg typically expects them. This
-        //                               setting is a more general solution than naming the track locations directly in case
-        //                               Protect changes this in the future.
-        //                               Yes, we included these above as well: they need to be included for every I/O stream to
-        //                               maximize effectiveness it seems.
-        // -movflags flags               In the generated fMP4 stream: start a new fragment at each keyframe, write a blank MOOV box, and avoid writing absolute offsets.
-        // -reset_timestamps             Reset timestamps at the beginning of each segment.
-        // -metadata                     Set the metadata to the name of the camera to distinguish between FFmpeg sessions.
-        this.commandLineArgs.push("-map", "0:v:0", ...protectCamera.stream.ffmpegOptions.recordEncoder({
-            bitrate: recordingConfig.videoCodec.parameters.bitRate,
-            fps: recordingConfig.videoCodec.resolution[2],
-            height: recordingConfig.videoCodec.resolution[1],
-            idrInterval: PROTECT_HKSV_IDR_INTERVAL,
-            inputFps: rtspEntry.channel.fps,
-            level: recordingConfig.videoCodec.parameters.level,
-            profile: recordingConfig.videoCodec.parameters.profile,
-            width: recordingConfig.videoCodec.resolution[0]
-        }), "-movflags", "frag_keyframe+empty_moov+default_base_moof", "-reset_timestamps", "1", "-metadata", "comment=" + protectCamera.accessoryName);
-        if (isAudioActive) {
-            // Configure the audio portion of the command line. Options we use are:
-            //
-            // -map 0:a:0?                 Selects the first available audio track from the stream, if it exists. Protect actually maps audio and video tracks in opposite
-            //                             locations from where FFmpeg typically expects them. This setting is a more general solution than naming the track locations directly
-            //                             in case Protect changes this in the future.
-            // -acodec copy                Copy the stream without reencoding it.
-            this.commandLineArgs.push("-map", "0:a:0?", "-acodec", "copy");
-        }
-        // Configure our video parameters for outputting our final stream:
-        //
-        // -f mp4  Tell ffmpeg that it should create an MP4-encoded output stream.
-        // pipe:1  Output the stream to standard output.
-        this.commandLineArgs.push("-f", "mp4", "pipe:1");
-        // Additional logging, but only if we're debugging.
-        if (protectCamera.platform.verboseFfmpeg) {
-            this.commandLineArgs.unshift("-loglevel", "level+verbose");
-        }
-        // Start the FFmpeg session.
-        this.start();
-    }
-    // Prepare and start our FFmpeg process.
-    configureProcess() {
-        let dataListener;
-        // Call our parent to get started.
-        super.configureProcess();
-        // Initialize our variables that we need to process incoming FFmpeg packets.
-        let header = Buffer.alloc(0);
-        let bufferRemaining = Buffer.alloc(0);
-        let dataLength = 0;
-        let type = "";
-        // Process FFmpeg output and parse out the fMP4 stream it's generating for HomeKit Secure Video.
-        this.process?.stdout.on("data", dataListener = (buffer) => {
-            // If we have anything left from the last buffer we processed, prepend it to this buffer.
-            if (bufferRemaining.length > 0) {
-                buffer = Buffer.concat([bufferRemaining, buffer]);
-                bufferRemaining = Buffer.alloc(0);
-            }
-            let offset = 0;
-            // FFmpeg is outputting an fMP4 stream that's suitable for HomeKit Secure Video. However, we can't just pass this stream directly back to HomeKit since we're using
-            // a generator-based API to send packets back to HKSV. Here, we take on the task of parsing the fMP4 stream that's being generated and split it up into the MP4
-            // boxes that HAP-NodeJS is ultimately expecting.
-            for (;;) {
-                let data;
-                // The MP4 container format is well-documented and designed around the concept of boxes. A box (or atom as they used to be called) is at the center of an MP4
-                // container. It's composed of an 8-byte header, followed by the data payload it carries.
-                // No existing header, let's start a new box.
-                if (!header.length) {
-                    // Grab the header. The first four bytes represents the length of the entire box. Second four bytes represent the box type.
-                    header = buffer.slice(0, 8);
-                    // Now we retrieve the length of the box.
-                    dataLength = header.readUInt32BE(0);
-                    // Get the type of the box. This is always a string and has a funky history to it that makes for an interesting read!
-                    type = header.slice(4).toString();
-                    // Finally, we get the data portion of the box.
-                    data = buffer.slice(8, dataLength);
-                    // Mark our data offset so we account for the length of the data header and subtract it from the overall length to capture just the data portion.
-                    dataLength -= offset = 8;
-                }
-                else {
-                    // Grab the data from our buffer.
-                    data = buffer.slice(0, dataLength);
-                    offset = 0;
-                }
-                // If we don't have enough data in this buffer, save what we have for the next buffer we see and append it there.
-                if (data.length < dataLength) {
-                    bufferRemaining = data;
-                    break;
-                }
-                // Add it to our queue to be eventually pushed out through our generator function.
-                this.recordingBuffer.push({ data: data, header: header, length: dataLength, type: type });
-                this.emit("mp4box");
-                // Prepare to start a new box for the next buffer that we will be processing.
-                data = Buffer.alloc(0);
-                header = Buffer.alloc(0);
-                type = "";
-                // We've parsed an entire box, and there's no more data in this buffer to parse.
-                if (buffer.length === (offset + dataLength)) {
-                    dataLength = 0;
-                    break;
-                }
-                // If there's anything left in the buffer, move us to the new box and let's keep iterating.
-                buffer = buffer.slice(offset + dataLength);
-                dataLength = 0;
-            }
-        });
-        // Make sure we cleanup our listeners when we're done.
-        this.process?.once("exit", () => {
-            this.process?.stdout?.off("data", dataListener);
-        });
-    }
-    // Stop our FFmpeg process and cleanup after ourselves.
-    stopProcess() {
-        // Call our parent to get started.
-        super.stopProcess();
-        // Ensure that we clear out of our segment generator by guaranteeing an exit path.
-        this.isEnded = true;
-        this.emit("mp4box");
-    }
-    // Stop an FFmpeg process and cleanup.
-    stop(logErrors = this.isLoggingErrors) {
-        const savedLogErrors = this.isLoggingErrors;
-        // Flag whether we should log abnormal exits (e.g. being killed) or not.
-        this.isLoggingErrors = logErrors;
-        // Call our parent to finish the job.
-        super.stop();
-        // Restore our previous logging state.
-        this.isLoggingErrors = savedLogErrors;
-    }
-    // Log errors.
-    logFfmpegError(exitCode, signal) {
-        // If we're ignoring errors, we're done.
-        if (!this.isLoggingErrors) {
-            return;
-        }
-        // Known HKSV-related errors due to occasional inconsistencies that are occasionally produced by the Protect livestream API.
-        const ffmpegKnownHksvError = new RegExp([
-            "(Cannot determine format of input stream 0:0 after EOF)",
-            "(Could not write header \\(incorrect codec parameters \\?\\): Broken pipe)",
-            "(Could not write header for output file #0)",
-            "(Error closing file: Broken pipe)",
-            "(Error splitting the input into NAL units\\.)",
-            "(Invalid data found when processing input)",
-            "(moov atom not found)"
-        ].join("|"));
-        // See if we know about this error.
-        if (this.stderrLog.some(x => ffmpegKnownHksvError.test(x))) {
-            this.log.error("FFmpeg ended unexpectedly due to issues processing the media stream provided by the UniFi Protect livestream API. " +
-                "This error can be safely ignored - it will occur occasionally.");
-            return;
-        }
-        // Otherwise, revert to our default logging in our parent.
-        super.logFfmpegError(exitCode, signal);
-    }
-    // Generate complete segments from an FFmpeg output stream that HomeKit Secure Video can process.
-    async *segmentGenerator() {
-        let segment = [];
-        // Loop forever, generating either FTYP/MOOV box pairs or MOOF/MDAT box pairs for HomeKit Secure Video.
-        for (;;) {
-            // FFmpeg has finished it's output - we're done.
-            if (this.isEnded) {
-                return;
-            }
-            // If the buffer is empty, wait for our FFmpeg process to produce more boxes.
-            if (!this.recordingBuffer.length) {
-                // Segments are output by FFmpeg according to our specified IDR interval. If we don't see a segment within the timeframe we need for HKSV's timing requirements,
-                // we flag it accordingly and return null back to the generator that's calling us.
-                // eslint-disable-next-line no-await-in-loop
-                await runWithTimeout(once(this, "mp4box"), PROTECT_HKSV_TIMEOUT);
-            }
-            // Grab the next fMP4 box from our buffer.
-            const box = this.recordingBuffer.shift();
-            // FFmpeg hasn't produced any output. Given the time-sensitive nature of HKSV that constrains us to no more than 5 seconds to provide the next segment, we're done.
-            if (!box) {
-                this.isTimedOut = true;
-                return;
-            }
-            // Queue up this fMP4 box to send back to HomeKit.
-            segment.push(box.header, box.data);
-            // What we want to send are two types of complete segments, made up of multiple MP4 boxes:
-            //
-            // - a complete MOOV box, usually with an accompanying FTYP box, that's sent at the very beginning of any valid fMP4 stream. HomeKit Secure Video looks for this
-            //   before anything else.
-            //
-            // - a complete MOOF/MDAT pair. MOOF describes the sample locations and their sizes and MDAT contains the actual audio and video data related to that segment. Think
-            //   of MOOF as the audio/video data "header", and MDAT as the "payload".
-            //
-            // Once we see these, we combine all the segments in our queue to send back to HomeKit.
-            if ((box.type === "moov") || (box.type === "mdat")) {
-                yield Buffer.concat(segment);
-                segment = [];
-            }
-        }
-    }
-}
-//# sourceMappingURL=protect-ffmpeg-record.js.map

package/dist/ffmpeg/protect-ffmpeg-record.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protect-ffmpeg-record.js","sourceRoot":"","sources":["../../src/ffmpeg/protect-ffmpeg-record.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,+DAA+D;AAC/D,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAE/C,eAAe,CAAU;IAC1B,UAAU,CAAU;IACnB,eAAe,CAAmE;IAClF,eAAe,CAA+B;IAEtD,wCAAwC;IACxC,YAAY,aAA4B,EAAE,eAA6C,EAAE,SAAoB,EAAE,aAAsB;QAEnI,yBAAyB;QACzB,KAAK,CAAC,aAAa,CAAC,CAAC;QAErB,yCAAyC;QACzC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAE5B,mCAAmC;QACnC,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;QAE1B,wBAAwB;QACxB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAExB,oCAAoC;QACpC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QAEvC,gDAAgD;QAChD,EAAE;QACF,gFAAgF;QAChF,6FAA6F;QAC7F,4JAA4J;QAC5J,sFAAsF;QACtF,2JAA2J;QAC3J,+EAA+E;QAC/E,+FAA+F;QAC/F,sEAAsE;QACtE,wGAAwG;QACxG,IAAI,CAAC,eAAe,GAAG;YAErB,cAAc;YACd,UAAU;YACV,SAAS,EAAE,wBAAwB;YACnC,aAAa,EAAE,YAAY;YAC3B,YAAY,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;YAChH,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE;YACtC,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,eAAe,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,IAAI;SACzH,CAAC;QAEF,wDAAwD;QACxD,EAAE;QACF,qHAAqH;QACrH,sHAAsH;QACtH,oHAAoH;QACpH,oEAAoE;QACpE,uHAAuH;QACvH,iEAAiE;QACjE,iKAAiK;QACjK,mFAAmF;QACnF,mHAAmH;QACnH,IAAI,CAAC,eAAe,CAAC,IAAI,CAEvB,MAAM,EAAE,OAAO,EACf,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,aAAa,CAAC;YAElD,OAAO,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO;YACtD,GAAG,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;YAC7C,MAAM,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;YAChD,WAAW,EAAE,yBAAyB;YACtC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG;YAC/B,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK;YAClD,OAAO,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO;YACtD,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC;SAChD,CAAC,EAEF,WAAW,EAAE,4CAA4C,EACzD,mBAAmB,EAAE,GAAG,EACxB,WAAW,EAAE,UAAU,GAAG,aAAa,CAAC,aAAa,CACtD,CAAC;QAEF,IAAG,aAAa,EAAE,CAAC;YAEjB,uEAAuE;YACvE,EAAE;YACF,8JAA8J;YAC9J,mKAAmK;YACnK,0EAA0E;YAC1E,qEAAqE;YACrE,IAAI,CAAC,eAAe,CAAC,IAAI,CAEvB,MAAM,EAAE,QAAQ,EAChB,SAAS,EAAE,MAAM,CAClB,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,EAAE;QACF,0EAA0E;QAC1E,gDAAgD;QAChD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QAEjD,mDAAmD;QACnD,IAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;YAExC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QAC7D,CAAC;QAED,4BAA4B;QAC5B,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED,wCAAwC;IAC9B,gBAAgB;QAExB,IAAI,YAAsC,CAAC;QAE3C,kCAAkC;QAClC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAEzB,4EAA4E;QAC5E,IAAI,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtC,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,gGAAgG;QAChG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,GAAG,CAAC,MAAc,EAAQ,EAAE;YAEtE,yFAAyF;YACzF,IAAG,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAE9B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;gBAClD,eAAe,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;YAED,IAAI,MAAM,GAAG,CAAC,CAAC;YAEf,mKAAmK;YACnK,+JAA+J;YAC/J,iDAAiD;YACjD,SAAQ,CAAC;gBAEP,IAAI,IAAI,CAAC;gBAET,6JAA6J;gBAC7J,yFAAyF;gBAEzF,6CAA6C;gBAC7C,IAAG,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;oBAElB,2HAA2H;oBAC3H,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBAE5B,yCAAyC;oBACzC,UAAU,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;oBAEpC,qHAAqH;oBACrH,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;oBAElC,+CAA+C;oBAC/C,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;oBAEnC,iJAAiJ;oBACjJ,UAAU,IAAI,MAAM,GAAG,CAAC,CAAC;gBAC3B,CAAC;qBAAM,CAAC;oBAEN,iCAAiC;oBACjC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;oBACnC,MAAM,GAAG,CAAC,CAAC;gBACb,CAAC;gBAED,iHAAiH;gBACjH,IAAG,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;oBAE5B,eAAe,GAAG,IAAI,CAAC;oBAEvB,MAAM;gBACR,CAAC;gBAED,kFAAkF;gBAClF,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1F,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAEpB,6EAA6E;gBAC7E,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACzB,IAAI,GAAG,EAAE,CAAC;gBAEV,gFAAgF;gBAChF,IAAG,MAAM,CAAC,MAAM,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC;oBAE3C,UAAU,GAAG,CAAC,CAAC;oBAEf,MAAM;gBACR,CAAC;gBAED,2FAA2F;gBAC3F,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;gBAC3C,UAAU,GAAG,CAAC,CAAC;YACjB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,sDAAsD;QACtD,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YAE9B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,uDAAuD;IAC7C,WAAW;QAEnB,kCAAkC;QAClC,KAAK,CAAC,WAAW,EAAE,CAAC;QAEpB,kFAAkF;QAClF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED,sCAAsC;IAC/B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe;QAE1C,MAAM,cAAc,GAAG,IAAI,CAAC,eAAe,CAAC;QAE5C,wEAAwE;QACxE,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QAEjC,qCAAqC;QACrC,KAAK,CAAC,IAAI,EAAE,CAAC;QAEb,sCAAsC;QACtC,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;IACxC,CAAC;IAED,cAAc;IACJ,cAAc,CAAC,QAAgB,EAAE,MAAsB;QAE/D,wCAAwC;QACxC,IAAG,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAEzB,OAAO;QACT,CAAC;QAED,4HAA4H;QAC5H,MAAM,oBAAoB,GAAG,IAAI,MAAM,CAAC;YAEtC,yDAAyD;YACzD,4EAA4E;YAC5E,6CAA6C;YAC7C,mCAAmC;YACnC,+CAA+C;YAC/C,4CAA4C;YAC5C,uBAAuB;SACxB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEb,mCAAmC;QACnC,IAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAE1D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oHAAoH;gBACjI,gEAAgE,CAAC,CAAC;YAEpE,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,iGAAiG;IAC1F,KAAK,CAAC,CAAC,gBAAgB;QAE5B,IAAI,OAAO,GAAa,EAAE,CAAC;QAE3B,uGAAuG;QACvG,SAAQ,CAAC;YAEP,gDAAgD;YAChD,IAAG,IAAI,CAAC,OAAO,EAAE,CAAC;gBAEhB,OAAO;YACT,CAAC;YAED,6EAA6E;YAC7E,IAAG,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;gBAEhC,gKAAgK;gBAChK,kFAAkF;gBAClF,4CAA4C;gBAC5C,MAAM,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAC,CAAC;YACnE,CAAC;YAED,0CAA0C;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;YAEzC,mKAAmK;YACnK,IAAG,CAAC,GAAG,EAAE,CAAC;gBAER,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;gBAEvB,OAAO;YACT,CAAC;YAED,kDAAkD;YAClD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YAEnC,0FAA0F;YAC1F,EAAE;YACF,gKAAgK;YAChK,0BAA0B;YAC1B,EAAE;YACF,oKAAoK;YACpK,yEAAyE;YACzE,EAAE;YACF,uFAAuF;YACvF,IAAG,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;gBAElD,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7B,OAAO,GAAG,EAAE,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/ffmpeg/protect-ffmpeg-stream.d.ts

@@ -1,17 +0,0 @@
-import { ChildProcessWithoutNullStreams } from "child_process";
-import { FfmpegProcess } from "./protect-ffmpeg.js";
-import { Nullable } from "homebridge-plugin-utils";
-import { ProtectStreamingDelegate } from "../protect-stream.js";
-import { StreamRequestCallback } from "homebridge";
-export declare class FfmpegStreamingProcess extends FfmpegProcess {
-    private delegate;
-    private sessionId;
-    private streamTimeout?;
-    constructor(delegate: ProtectStreamingDelegate, sessionId: string, commandLineArgs: string[], returnPort?: {
-        addressVersion: string;
-        port: number;
-    }, callback?: StreamRequestCallback);
-    private createSocket;
-    get ffmpegProcess(): Nullable<ChildProcessWithoutNullStreams>;
-    protected logFfmpegError(exitCode: number, signal: NodeJS.Signals): void;
-}

package/dist/ffmpeg/protect-ffmpeg-stream.js

@@ -1,102 +0,0 @@
-import { FfmpegProcess } from "./protect-ffmpeg.js";
-import { createSocket } from "node:dgram";
-// FFmpeg streaming process management.
-export class FfmpegStreamingProcess extends FfmpegProcess {
-    delegate;
-    sessionId;
-    streamTimeout;
-    // Create a new FFmpeg process instance.
-    constructor(delegate, sessionId, commandLineArgs, returnPort, callback) {
-        // Initialize our parent.
-        super(delegate.protectCamera);
-        this.delegate = delegate;
-        this.sessionId = sessionId;
-        // Create the return port for FFmpeg, if requested to do so. The only time we don't do this is when we're standing up
-        // a two-way audio stream - in that case, the audio work is done through RtpSplitter and not here.
-        if (returnPort) {
-            this.createSocket(returnPort);
-        }
-        // Start it up, with appropriate error handling.
-        this.start(commandLineArgs, callback, (errorMessage) => {
-            // Stop the stream.
-            this.delegate.stopStream(this.sessionId);
-            // Let homebridge know what happened and stop the stream if we've already started.
-            if (!this.isStarted && this.callback) {
-                this.callback(new Error(errorMessage));
-                this.callback = null;
-                return;
-            }
-            // Tell Homebridge to forcibly stop the streaming session.
-            this.delegate.controller.forceStopStreamingSession(this.sessionId);
-            this.delegate.stopStream(this.sessionId);
-        });
-    }
-    // Create the port for FFmpeg to send data through.
-    createSocket(portInfo) {
-        let errorListener;
-        let messageListener;
-        const socket = createSocket(portInfo.addressVersion === "ipv6" ? "udp6" : "udp4");
-        // Cleanup after ourselves when the socket closes.
-        socket.once("close", () => {
-            if (this.streamTimeout) {
-                clearTimeout(this.streamTimeout);
-            }
-            socket.off("error", errorListener);
-            socket.off("message", messageListener);
-        });
-        // Handle potential network errors.
-        socket.on("error", errorListener = (error) => {
-            this.log.error("Socket error: %s.", error.name);
-            void this.delegate.stopStream(this.sessionId);
-        });
-        // Manage our video streams in case we haven't received a stop request, but we're in fact dead zombies.
-        socket.on("message", messageListener = () => {
-            // Clear our last canary.
-            if (this.streamTimeout) {
-                clearTimeout(this.streamTimeout);
-            }
-            // Set our new canary.
-            this.streamTimeout = setTimeout(() => {
-                this.log.debug("Video stream appears to be inactive for 5 seconds. Stopping stream.", this.protectCamera.name);
-                this.delegate.controller.forceStopStreamingSession(this.sessionId);
-                void this.delegate.stopStream(this.sessionId);
-            }, 5000);
-        });
-        // Bind to the port we're opening.
-        socket.bind(portInfo.port, (portInfo.addressVersion === "ipv6") ? "::1" : "127.0.0.1");
-    }
-    // Return the actual FFmpeg process.
-    get ffmpegProcess() {
-        return this.process;
-    }
-    // Log errors.
-    logFfmpegError(exitCode, signal) {
-        // We want to process known streaming-related errors due to the performance and latency tweaks we've made to the FFmpeg command line. In some cases we inform the
-        // user and take no action, in others, we tune our own internal parameters.
-        // We're using API-based livestreaming. Be attentive to the unique errors they may present.
-        if (this.delegate.protectCamera.hints.apiStreaming && this.delegate.hksv?.isRecording) {
-            // Test for known errors due to occasional inconsistencies in the Protect livestream API.
-            const timeshiftLivestreamRegex = new RegExp([
-                "(Cannot determine format of input stream 0:0 after EOF)",
-                "(Finishing stream without any data written to it)",
-                "(could not find corresponding trex)",
-                "(moov atom not found)"
-            ].join("|"));
-            if (this.stderrLog.some(logEntry => timeshiftLivestreamRegex.test(logEntry))) {
-                this.log.error("FFmpeg ended unexpectedly due to issues processing the media stream provided by the UniFi Protect livestream API. " +
-                    "This error can be safely ignored - it will occur occasionally.");
-                return;
-            }
-        }
-        // Test for probesize errors.
-        const probesizeRegex = new RegExp("not enough frames to estimate rate; consider increasing probesize");
-        if (this.stderrLog.some(logEntry => probesizeRegex.test(logEntry))) {
-            // Let the streaming delegate know to adjust it's parameters for the next run and inform the user.
-            this.delegate.adjustProbeSize();
-            return;
-        }
-        // Otherwise, revert to our default logging in our parent.
-        super.logFfmpegError(exitCode, signal);
-    }
-}
-//# sourceMappingURL=protect-ffmpeg-stream.js.map

package/dist/ffmpeg/protect-ffmpeg-stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"protect-ffmpeg-stream.js","sourceRoot":"","sources":["../../src/ffmpeg/protect-ffmpeg-stream.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,uCAAuC;AACvC,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IAE/C,QAAQ,CAA2B;IACnC,SAAS,CAAS;IAClB,aAAa,CAAkB;IAEvC,wCAAwC;IACxC,YAAY,QAAkC,EAAE,SAAiB,EAAE,eAAyB,EAAE,UAAqD,EACjJ,QAAgC;QAEhC,yBAAyB;QACzB,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAE9B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAE3B,qHAAqH;QACrH,kGAAkG;QAClG,IAAG,UAAU,EAAE,CAAC;YAEd,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAED,gDAAgD;QAChD,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,YAAoB,EAAE,EAAE;YAE7D,mBAAmB;YACnB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAEzC,kFAAkF;YAClF,IAAG,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAEpC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;gBACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;gBAErB,OAAO;YACT,CAAC;YAED,0DAA0D;YAC1D,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mDAAmD;IAC3C,YAAY,CAAC,QAAkD;QAErE,IAAI,aAAqC,CAAC;QAC1C,IAAI,eAA2B,CAAC;QAChC,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAElF,kDAAkD;QAClD,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YAExB,IAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBAEtB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,mCAAmC;QACnC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,GAAG,CAAC,KAAY,EAAQ,EAAE;YAExD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAChD,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,uGAAuG;QACvG,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,GAAG,GAAS,EAAE;YAEhD,yBAAyB;YACzB,IAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBAEtB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnC,CAAC;YAED,sBAAsB;YACtB,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAEnC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,qEAAqE,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;gBAE/G,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACnE,KAAK,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAChD,CAAC,EAAE,IAAI,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,cAAc,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACzF,CAAC;IAED,oCAAoC;IACpC,IAAW,aAAa;QAEtB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,cAAc;IACJ,cAAc,CAAC,QAAgB,EAAE,MAAsB;QAE/D,iKAAiK;QACjK,2EAA2E;QAE3E,2FAA2F;QAC3F,IAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YAErF,yFAAyF;YACzF,MAAM,wBAAwB,GAAG,IAAI,MAAM,CAAC;gBAE1C,yDAAyD;gBACzD,mDAAmD;gBACnD,qCAAqC;gBACrC,uBAAuB;aACxB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAEb,IAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAE5E,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,oHAAoH;oBACjI,gEAAgE,CAAC,CAAC;gBAEpE,OAAO;YACT,CAAC;QACH,CAAC;QAED,6BAA6B;QAC7B,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,mEAAmE,CAAC,CAAC;QAEvG,IAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YAElE,kGAAkG;YAClG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAEhC,OAAO;QACT,CAAC;QAED,0DAA0D;QAC1D,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/ffmpeg/protect-ffmpeg.d.ts

@@ -1,35 +0,0 @@
-import { ChildProcessWithoutNullStreams } from "node:child_process";
-import { HomebridgePluginLogging, Nullable } from "homebridge-plugin-utils";
-import { Readable, Writable } from "node:stream";
-import { EventEmitter } from "node:events";
-import { ProtectCamera } from "../devices/index.js";
-import { ProtectNvr } from "../protect-nvr.js";
-import { StreamRequestCallback } from "homebridge";
-export declare class FfmpegProcess extends EventEmitter {
-    protected callback: Nullable<StreamRequestCallback>;
-    protected commandLineArgs: string[];
-    private ffmpegTimeout?;
-    hasError: boolean;
-    isEnded: boolean;
-    private isLogging;
-    private isPrepared;
-    isStarted: boolean;
-    protected isVerbose: boolean;
-    protected readonly log: HomebridgePluginLogging;
-    protected readonly nvr: ProtectNvr;
-    private readonly platform;
-    protected process: Nullable<ChildProcessWithoutNullStreams>;
-    protected protectCamera: ProtectCamera;
-    private stderrBuffer;
-    protected stderrLog: string[];
-    constructor(protectCamera: ProtectCamera, commandLineArgs?: string[], callback?: StreamRequestCallback);
-    protected prepareProcess(commandLineArgs?: string[], callback?: StreamRequestCallback): void;
-    protected start(commandLineArgs?: string[], callback?: StreamRequestCallback, errorHandler?: (errorMessage: string) => Promise<void> | void): void;
-    protected configureProcess(errorHandler?: (errorMessage: string) => Promise<void> | void): void;
-    protected stopProcess(): void;
-    stop(): void;
-    protected logFfmpegError(exitCode: number, signal: NodeJS.Signals): void;
-    get stdin(): Nullable<Writable>;
-    get stdout(): Nullable<Readable>;
-    get stderr(): Nullable<Readable>;
-}