homebridge-plugin-utils 1.33.0 → 1.35.0

package/dist/ffmpeg/process.js

@@ -24,9 +24,12 @@
  * @module
  */
 import { spawn } from "node:child_process";
+import { EOL } from "node:os";
 import { EventEmitter } from "node:events";
-import os from "node:os";
+import { FFMPEG_INPUT_TIMEOUT } from "./settings.js";
 import util from "node:util";
+// Matches non-printable control characters for stripping from FFmpeg stderr output. Compiled once at module scope rather than per data event.
+const NON_PRINTABLE_CHARS = /\p{C}+/gu;
 /**
  * Base class providing FFmpeg process management and capability introspection.
  *
@@ -58,18 +61,6 @@ import util from "node:util";
  * @category FFmpeg
  */
 export class FfmpegProcess extends EventEmitter {
-    /**
-     * Indicates if an error has occurred during FFmpeg process execution.
-     */
-    hasError;
-    /**
-     * Indicates whether the FFmpeg process has ended.
-     */
-    isEnded;
-    /**
-     * Indicates whether the FFmpeg process has started.
-     */
-    isStarted;
     /**
      * Optional callback to be called when the FFmpeg process is ready for streaming.
      */
@@ -94,28 +85,34 @@ export class FfmpegProcess extends EventEmitter {
      * The underlying Node.js ChildProcess instance for the FFmpeg process.
      */
     process;
+    _hasError;
+    _isStarted;
     /**
      * Accumulated log lines from standard error for error reporting and debugging.
      */
-    stderrLog;
+    _stderrLog;
     ffmpegTimeout;
     isLogging;
     stderrBuffer;
+    /**
+     * Indicates whether the FFmpeg process has ended. Protected to allow subclass state transitions (e.g., signaling generators before shutdown).
+     */
+    _isEnded;
     // Create a new FFmpeg process instance.
     constructor(options, commandLineArgs, callback) {
         // Initialize our parent.
         super();
         this.callback = null;
         this.commandLineArgs = [];
-        this.hasError = false;
+        this._hasError = false;
+        this._isEnded = false;
+        this._isStarted = false;
         this.isLogging = false;
-        this.isEnded = false;
-        this.isStarted = false;
         this.log = options.log;
         this.options = options;
         this.process = null;
         this.stderrBuffer = "";
-        this.stderrLog = [];
+        this._stderrLog = [];
         // Toggle FFmpeg logging, if configured.
         this.isVerbose = this.options.codecSupport.verbose;
         // If we've specified a command line or a callback, let's save them.
@@ -139,8 +136,8 @@ export class FfmpegProcess extends EventEmitter {
         // See if we should display ffmpeg command output.
         this.isLogging = false;
         // Track if we've started or ended FFmpeg.
-        this.isStarted = false;
-        this.isEnded = false;
+        this._isStarted = false;
+        this._isEnded = false;
         // If we've got a loglevel specified, ensure we display it.
         if (this.commandLineArgs.includes("-loglevel")) {
             this.isLogging = true;
@@ -205,10 +202,10 @@ export class FfmpegProcess extends EventEmitter {
             // Inform us when we start receiving data back from FFmpeg. We do this here because it's the only
             // truly reliable place we can check on FFmpeg. stdin and stdout may not be used at all, depending
             // on the way FFmpeg is called, but stderr will always be there.
-            if (!this.isStarted) {
-                this.isStarted = true;
-                this.isEnded = false;
-                this.log.debug("Received the first frame.");
+            if (!this._isStarted) {
+                this._isStarted = true;
+                this._isEnded = false;
+                this.log.debug("FFmpeg process started.");
                 // Always remember to execute the callback once we're setup to let homebridge know we're streaming.
                 if (this.callback) {
                     this.callback();
@@ -216,19 +213,19 @@ export class FfmpegProcess extends EventEmitter {
                 }
             }
             // Append to the current line we've been buffering. We don't want to output not-printable characters to ensure the log output is readable.
-            this.stderrBuffer += data.toString().replace(/\p{C}+/gu, os.EOL);
+            this.stderrBuffer += data.toString().replace(NON_PRINTABLE_CHARS, EOL);
             // Debugging and additional logging collection.
             for (;;) {
                 // Find the next newline.
-                const lineIndex = this.stderrBuffer.indexOf(os.EOL);
+                const lineIndex = this.stderrBuffer.indexOf(EOL);
                 // If there's no newline, we're done until we get more data.
                 if (lineIndex === -1) {
                     return;
                 }
                 // Grab the next complete line, and increment our buffer.
                 const line = this.stderrBuffer.slice(0, lineIndex);
-                this.stderrBuffer = this.stderrBuffer.slice(lineIndex + os.EOL.length);
-                this.stderrLog.push(line);
+                this.stderrBuffer = this.stderrBuffer.slice(lineIndex + EOL.length);
+                this._stderrLog.push(line);
                 // Show it to the user if it's been requested.
                 if (this.isLogging || this.isVerbose || this.options.debug) {
                     this.log.info(line);
@@ -241,8 +238,8 @@ export class FfmpegProcess extends EventEmitter {
             if (this.ffmpegTimeout) {
                 clearTimeout(this.ffmpegTimeout);
             }
-            this.isStarted = false;
-            this.isEnded = true;
+            this._isStarted = false;
+            this._isEnded = true;
             // Some utilities to streamline things.
             const logPrefix = "FFmpeg process ended ";
             // FFmpeg ended normally and our canary didn't need to enforce FFmpeg's extinction.
@@ -255,10 +252,10 @@ export class FfmpegProcess extends EventEmitter {
             }
             else {
                 // Flag that we've run into an FFmpeg error.
-                this.hasError = true;
+                this._hasError = true;
                 // Flush out any remaining output in our error buffer.
                 if (this.stderrBuffer.length) {
-                    this.stderrLog.push(this.stderrBuffer + "\n");
+                    this._stderrLog.push(this.stderrBuffer + "\n");
                     this.stderrBuffer = "";
                 }
                 // Inform the user.
@@ -268,11 +265,10 @@ export class FfmpegProcess extends EventEmitter {
                     void errorHandler(util.format(this.options.name() + ": " + logPrefix + " unexpectedly with exit code %s and signal %s.", exitCode, signal));
                 }
             }
-            // Cleanup after ourselves.
+            // Cleanup after ourselves. We intentionally preserve _stderrLog so callers can inspect it for post-mortem diagnostics after the process exits.
             this.process?.stdin.off("error", errorListener);
             this.process?.stderr.off("data", dataListener);
             this.process = null;
-            this.stderrLog = [];
         });
     }
     // Stop the FFmpeg process and complete any cleanup activities.
@@ -287,7 +283,7 @@ export class FfmpegProcess extends EventEmitter {
         // In case we need to kill it again, just to be sure it's really dead.
         this.ffmpegTimeout = setTimeout(() => {
             this.process?.kill("SIGKILL");
-        }, 5000);
+        }, FFMPEG_INPUT_TIMEOUT);
         // Send the kill shot.
         this.process?.kill();
     }
@@ -313,7 +309,35 @@ export class FfmpegProcess extends EventEmitter {
         // Something else has occurred. Inform the user, and stop everything.
         this.log.error("FFmpeg process ended unexpectedly with %s%s%s.", (exitCode !== null) ? "an exit code of " + exitCode.toString() : "", ((exitCode !== null) && signal) ? " and " : "", signal ? "a signal received of " + signal : "");
         this.log.error("FFmpeg (%s) command that errored out was: %s %s", this.options.codecSupport.ffmpegVersion, this.options.codecSupport.ffmpegExec, this.commandLineArgs.join(" "));
-        this.stderrLog.map(x => { this.log.error(x); });
+        for (const x of this._stderrLog) {
+            this.log.error(x);
+        }
+    }
+    /**
+     * Indicates if an error has occurred during FFmpeg process execution.
+     */
+    get hasError() {
+        return this._hasError;
+    }
+    /**
+     * Indicates whether the FFmpeg process has ended.
+     */
+    get isEnded() {
+        return this._isEnded;
+    }
+    /**
+     * Indicates whether the FFmpeg process has started.
+     */
+    get isStarted() {
+        return this._isStarted;
+    }
+    /**
+     * Returns the accumulated standard error log lines from the FFmpeg process.
+     *
+     * @returns An array of stderr log lines.
+     */
+    get stderrLog() {
+        return this._stderrLog;
     }
     /**
      * Returns the writable standard input stream for the FFmpeg process, if available.

package/dist/ffmpeg/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/ffmpeg/process.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../src/ffmpeg/process.ts"],"names":[],"mappings":"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"}

package/dist/ffmpeg/record.d.ts

@@ -10,7 +10,7 @@
  * - Automated setup and management of FFmpeg processes for HKSV event recording and livestreaming (with support for audio and video).
  * - Parsing and generation of fMP4 boxes/segments for HomeKit, including initialization and media segments.
  * - Async generator APIs for efficient, event-driven segment handling.
- * - Flexible error handling and timeouts for HomeKit’s strict realtime requirements.
+ * - Flexible error handling and timeouts for HomeKit's strict realtime requirements.
  * - Designed for Homebridge plugin authors or advanced users who need robust, platform-aware FFmpeg session control for HomeKit and related integrations.
  *
  * @module
@@ -20,21 +20,27 @@ import { type Nullable, type PartialWithId } from "../util.js";
 import type { FfmpegOptions } from "./options.js";
 import { FfmpegProcess } from "./process.js";
 /**
- * Base options for configuring an fMP4 recording or livestream session. These options aren't used directly but are inherited and used by it's descendents.
- *
- * @property audioStream          - Audio stream input to use, if the input contains multiple audio streams. Defaults to `0` (the first audio stream).
- * @property codec                - The codec for the input video stream. Valid values are `av1`, `h264`, and `hevc`. Defaults to `h264`.
- * @property enableAudio          - Indicates whether to enable audio or not.
- * @property hardwareDecoding     - Enable hardware-accelerated video decoding if available. Defaults to what was specified in `ffmpegOptions`.
- * @property hardwareTranscoding  - Enable hardware-accelerated video transcoding if available. Defaults to what was specified in `ffmpegOptions`.
- * @property videoStream          - Video stream input to use, if the input contains multiple video streams. Defaults to `0` (the first video stream).
+ * Base options shared by both fMP4 recording and livestream sessions.
+ *
+ * @property audioFilters        - Audio filters for FFmpeg to process. These are passed as an array of filters.
+ * @property audioStream         - Audio stream input to use, if the input contains multiple audio streams. Defaults to `0` (the first audio stream).
+ * @property codec               - The codec for the input video stream. Valid values are `av1`, `h264`, and `hevc`. Defaults to `h264`.
+ * @property enableAudio         - Indicates whether to enable audio or not.
+ * @property hardwareDecoding    - Enable hardware-accelerated video decoding if available. Defaults to what was specified in `ffmpegOptions`.
+ * @property hardwareTranscoding - Enable hardware-accelerated video transcoding if available. Defaults to what was specified in `ffmpegOptions`.
+ * @property transcodeAudio      - Transcode audio to AAC. This can be set to false if the audio stream is already in AAC. Defaults to `true`.
+ * @property videoFilters        - Video filters for FFmpeg to process. These are passed as an array of filters.
+ * @property videoStream         - Video stream input to use, if the input contains multiple video streams. Defaults to `0` (the first video stream).
  */
 export interface FMp4BaseOptions {
+    audioFilters: string[];
     audioStream: number;
     codec: string;
     enableAudio: boolean;
     hardwareDecoding: boolean;
     hardwareTranscoding: boolean;
+    transcodeAudio: boolean;
+    videoFilters: string[];
     videoStream: number;
 }
 /**
@@ -61,7 +67,7 @@ export interface FMp4BaseOptions {
  *   url: "http://doorbird-ip/bha-api/audio.cgi"
  * };
  *
- * // Self-describing RTSP audio stream — only URL is needed.
+ * // Self-describing RTSP audio stream - only URL is needed.
  * const rtspAudioInput: FMp4AudioInputConfig = {
  *
  *   url: "rtsp://camera-ip/audio"
@@ -79,22 +85,16 @@ export interface FMp4AudioInputConfig {
     url: string;
 }
 /**
- * Options for configuring an fMP4 recording or livestream session.
+ * Options for configuring an fMP4 HKSV recording session.
  *
- * @property audioFilters    - Audio filters for FFmpeg to process. These are passed as an array of filters.
  * @property fps             - The video frames per second for the session.
  * @property probesize       - Number of bytes to analyze for stream information.
  * @property timeshift       - Timeshift offset for event-based recording (in milliseconds).
- * @property transcodeAudio  - Transcode audio to AAC. This can be set to false if the audio stream is already in AAC. Defaults to `true`.
- * @property videoFilters    - Video filters for FFmpeg to process. These are passed as an array of filters.
  */
 export interface FMp4RecordingOptions extends FMp4BaseOptions {
-    audioFilters: string[];
     fps: number;
     probesize: number;
     timeshift: number;
-    transcodeAudio: boolean;
-    videoFilters: string[];
 }
 /**
  * Options for configuring an fMP4 livestream session.
@@ -112,94 +112,48 @@ export interface FMp4LivestreamOptions extends FMp4BaseOptions {
     url: string;
 }
 /**
- * FFmpeg process controller for HomeKit Secure Video (HKSV) and fMP4 livestreaming and recording.
- *
- * This class manages the lifecycle and parsing of an FFmpeg process to support HKSV and livestreaming in fMP4 format. It handles initialization segments, media segment
- * parsing, buffering, and HomeKit segment generation, and emits events for segment and initialization.
- *
- * @example
+ * Abstract base class for fMP4 FFmpeg processes. Owns the shared command line skeleton (preamble, video mapping, movflags, audio encoding, output format) and the fMP4
+ * box-parsing loop. Subclasses provide mode-specific pieces (input args, encoder selection, box handling) via protected hook methods, following the template method
+ * pattern.
  *
- * ```ts
- * // Create a new recording process for an HKSV event.
- * const process = new FfmpegRecordingProcess(ffmpegOptions, recordingConfig, 30, true, 5000000, 0);
- *
- * // Start the process.
- * process.start();
- *
- * // Iterate over generated segments.
- * for await(const segment of process.segmentGenerator()) {
- *
- *   // Send segment to HomeKit, etc.
- * }
- *
- * // Stop when finished.
- * process.stop();
- * ```
- *
- * @see FfmpegOptions
+ * @see FfmpegRecordingProcess
+ * @see FfmpegLivestreamProcess
  * @see FfmpegProcess
  * @see {@link https://ffmpeg.org/ffmpeg.html | FFmpeg Documentation}
  */
-declare class FfmpegFMp4Process extends FfmpegProcess {
-    private hasInitSegment;
-    private _initSegment;
-    private isLivestream;
+declare abstract class FfmpegFMp4Process extends FfmpegProcess {
     private isLoggingErrors;
-    isTimedOut: boolean;
-    private recordingBuffer;
-    segmentLength?: number;
+    protected readonly fMp4Options: Required<FMp4BaseOptions>;
+    protected readonly recordingConfig: CameraRecordingConfiguration;
     /**
-     * Constructs a new fMP4 FFmpeg process for HKSV event recording or livestreaming.
+     * Constructs a new fMP4 FFmpeg process. Stores shared state and applies defaults to the base options. The command line is not assembled here...subclasses call
+     * `buildCommandLine()` after their own initialization to trigger the template method assembly.
      *
      * @param ffmpegOptions     - FFmpeg configuration options.
      * @param recordingConfig   - HomeKit recording configuration for the session.
-     * @param isAudioActive     - If `true`, enables audio stream processing.
-     * @param fMp4Options       - Configuration for the fMP4 session (fps, type, url, audio input, etc.).
+     * @param fMp4Options       - Partial base options with defaults applied for any unset fields.
      * @param isVerbose         - If `true`, enables more verbose logging for debugging purposes. Defaults to `false`.
-     *
-     * @example
-     *
-     * ```ts
-     * const process = new FfmpegFMp4Process(ffmpegOptions, recordingConfig, true, { fps: 30 });
-     * ```
      */
-    constructor(ffmpegOptions: FfmpegOptions, recordingConfig: CameraRecordingConfiguration, fMp4Options?: Partial<FMp4LivestreamOptions & FMp4RecordingOptions>, isVerbose?: boolean);
+    constructor(ffmpegOptions: FfmpegOptions, recordingConfig: CameraRecordingConfiguration, fMp4Options?: Partial<FMp4BaseOptions>, isVerbose?: boolean);
+    private _isVerbose;
+    protected buildCommandLine(): void;
+    protected abstract inputArgs(): string[];
+    protected abstract separateAudioInputArgs(): string[];
+    protected abstract audioInputIndex(): number;
+    protected abstract videoEncoderArgs(): string[];
+    protected abstract postFilterArgs(): string[];
+    protected abstract metadataLabel(): string;
+    protected abstract handleParsedBox(header: Buffer, data: Buffer, dataLength: number, type: number): void;
     /**
-     * Prepares and configures the FFmpeg process for reading and parsing output fMP4 data.
-     *
-     * This method is called internally by the process lifecycle and is not typically invoked directly by consumers.
+     * Prepares and configures the FFmpeg process for reading and parsing output fMP4 data. The box parsing loop is shared...each complete box is dispatched to the
+     * subclass via handleParsedBox().
      */
     protected configureProcess(): void;
     /**
-     * Retrieves the fMP4 initialization segment generated by FFmpeg.
-     *
-     * Waits until the initialization segment is available, then returns it.
-     *
-     * @returns A promise resolving to the initialization segment as a Buffer.
-     *
-     * @example
-     *
-     * ```ts
-     * const initSegment = await process.getInitSegment();
-     * ```
-     */
-    protected getInitSegment(): Promise<Buffer>;
-    /**
-     * Stops the FFmpeg process and performs cleanup, including emitting termination events for segment generators.
-     *
-     * This is called as part of the process shutdown sequence.
+     * Stops the FFmpeg process and performs cleanup. Subclasses override this to emit mode-specific events before calling super, which handles the shared teardown and
+     * emits the "close" event.
      */
     protected stopProcess(): void;
-    /**
-     * Starts the FFmpeg process, adjusting segment length for livestreams if set.
-     *
-     * @example
-     *
-     * ```ts
-     * process.start();
-     * ```
-     */
-    start(): void;
     /**
      * Stops the FFmpeg process and logs errors if specified.
      *
@@ -218,40 +172,7 @@ declare class FfmpegFMp4Process extends FfmpegProcess {
      * @param exitCode - The exit code from the FFmpeg process.
      * @param signal   - The signal (if any) used to terminate the process.
      */
-    protected logFfmpegError(exitCode: number, signal: NodeJS.Signals): void;
-    /**
-     * Asynchronously generates complete segments from FFmpeg output, formatted for HomeKit Secure Video.
-     *
-     * This async generator yields fMP4 segments as Buffers, or ends on process termination or timeout.
-     *
-     * @yields A Buffer containing a complete MP4 segment suitable for HomeKit.
-     *
-     * @example
-     *
-     * ```ts
-     * for await(const segment of process.segmentGenerator()) {
-     *
-     *   // Process each segment for HomeKit.
-     * }
-     * ```
-     */
-    segmentGenerator(): AsyncGenerator<Buffer>;
-    /**
-     * Returns the initialization segment as a Buffer, or null if not yet available.
-     *
-     * @returns The initialization segment Buffer, or `null` if not yet generated.
-     *
-     * @example
-     *
-     * ```ts
-     * const init = process.initSegment;
-     * if(init) {
-     *
-     *   // Use the initialization segment.
-     * }
-     * ```
-     */
-    get initSegment(): Nullable<Buffer>;
+    protected logFfmpegError(exitCode: Nullable<number>, signal: Nullable<NodeJS.Signals>): void;
 }
 /**
  * Manages a HomeKit Secure Video recording FFmpeg process.
@@ -268,6 +189,14 @@ declare class FfmpegFMp4Process extends FfmpegProcess {
  * @category FFmpeg
  */
 export declare class FfmpegRecordingProcess extends FfmpegFMp4Process {
+    /**
+     * Indicates whether the recording has timed out waiting for FFmpeg output.
+     */
+    isTimedOut: boolean;
+    private readonly fps;
+    private readonly probesize;
+    private recordingBuffer;
+    private readonly timeshift;
     /**
      * Constructs a new FFmpeg recording process for HKSV events.
      *
@@ -277,6 +206,34 @@ export declare class FfmpegRecordingProcess extends FfmpegFMp4Process {
      * @param isVerbose        - If `true`, enables more verbose logging for debugging purposes. Defaults to `false`.
      */
     constructor(options: FfmpegOptions, recordingConfig: CameraRecordingConfiguration, fMp4Options?: Partial<FMp4RecordingOptions>, isVerbose?: boolean);
+    protected inputArgs(): string[];
+    protected separateAudioInputArgs(): string[];
+    protected audioInputIndex(): number;
+    protected videoEncoderArgs(): string[];
+    protected postFilterArgs(): string[];
+    protected metadataLabel(): string;
+    protected handleParsedBox(header: Buffer, data: Buffer, dataLength: number, type: number): void;
+    /**
+     * Stops the FFmpeg process and performs cleanup, ensuring the segment generator can exit.
+     */
+    protected stopProcess(): void;
+    /**
+     * Asynchronously generates complete segments from FFmpeg output, formatted for HomeKit Secure Video.
+     *
+     * This async generator yields fMP4 segments as Buffers, or ends on process termination or timeout.
+     *
+     * @yields A Buffer containing a complete MP4 segment suitable for HomeKit.
+     *
+     * @example
+     *
+     * ```ts
+     * for await(const segment of process.segmentGenerator()) {
+     *
+     *   // Process each segment for HomeKit.
+     * }
+     * ```
+     */
+    segmentGenerator(): AsyncGenerator<Buffer>;
 }
 /**
  * Manages a HomeKit livestream FFmpeg process for generating fMP4 segments.
@@ -295,6 +252,15 @@ export declare class FfmpegRecordingProcess extends FfmpegFMp4Process {
  * @category FFmpeg
  */
 export declare class FfmpegLivestreamProcess extends FfmpegFMp4Process {
+    /**
+     * Optional override for the fMP4 fragment duration, in milliseconds. When set, the `-frag_duration` argument is updated before starting the FFmpeg process.
+     */
+    segmentLength?: number;
+    private _hasAudioInput;
+    private _initSegment;
+    private _initSegmentParts;
+    private hasInitSegment;
+    private readonly livestreamOptions;
     /**
      * Constructs a new FFmpeg livestream process.
      *
@@ -304,6 +270,23 @@ export declare class FfmpegLivestreamProcess extends FfmpegFMp4Process {
      * @param isVerbose          - If `true`, enables more verbose logging for debugging purposes. Defaults to `false`.
      */
     constructor(options: FfmpegOptions, recordingConfig: CameraRecordingConfiguration, livestreamOptions: PartialWithId<FMp4LivestreamOptions, "url">, isVerbose?: boolean);
+    protected inputArgs(): string[];
+    protected separateAudioInputArgs(): string[];
+    protected audioInputIndex(): number;
+    protected videoEncoderArgs(): string[];
+    protected postFilterArgs(): string[];
+    protected metadataLabel(): string;
+    protected handleParsedBox(header: Buffer, data: Buffer, _dataLength: number, type: number): void;
+    /**
+     * Starts the FFmpeg process, adjusting the fragment duration if segmentLength has been set.
+     *
+     * @example
+     *
+     * ```ts
+     * process.start();
+     * ```
+     */
+    start(): void;
     /**
      * Gets the fMP4 initialization segment generated by FFmpeg for the livestream.
      *
@@ -316,5 +299,21 @@ export declare class FfmpegLivestreamProcess extends FfmpegFMp4Process {
      * ```
      */
     getInitSegment(): Promise<Buffer>;
+    /**
+     * Returns the initialization segment as a Buffer, or null if not yet available.
+     *
+     * @returns The initialization segment Buffer, or `null` if not yet generated.
+     *
+     * @example
+     *
+     * ```ts
+     * const init = process.initSegment;
+     * if(init) {
+     *
+     *   // Use the initialization segment.
+     * }
+     * ```
+     */
+    get initSegment(): Nullable<Buffer>;
 }
 export {};