homebridge-plugin-utils 1.35.0 → 2.0.0

package/dist/ffmpeg/fmp4.d.ts

@@ -9,13 +9,57 @@
  *
  * @module
  */
-import type { Nullable } from "../util.js";
+import type { Nullable } from "../util.ts";
 /**
  * ISO BMFF box header size in bytes: 4 bytes big-endian size + 4 bytes ASCII type.
  *
  * @category FFmpeg
  */
 export declare const BOX_HEADER_SIZE = 8;
+/**
+ * TRUN fullbox flags bit indicating that a `data_offset` field follows the sample_count in the box header.
+ *
+ * @category FFmpeg
+ */
+export declare const TRUN_FLAG_DATA_OFFSET = 1;
+/**
+ * TRUN fullbox flags bit indicating that a `first_sample_flags` field follows (after `data_offset` if present). When this flag is set, the first sample's flags are
+ * stored in a dedicated header field rather than in the per-sample entries - the common arrangement for fragments emitted with FFmpeg's `frag_keyframe` movflag.
+ *
+ * @category FFmpeg
+ */
+export declare const TRUN_FLAG_FIRST_SAMPLE_FLAGS = 4;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte duration field.
+ *
+ * @category FFmpeg
+ */
+export declare const TRUN_FLAG_SAMPLE_DURATION = 256;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte size field.
+ *
+ * @category FFmpeg
+ */
+export declare const TRUN_FLAG_SAMPLE_SIZE = 512;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte sample_flags field.
+ *
+ * @category FFmpeg
+ */
+export declare const TRUN_FLAG_SAMPLE_FLAGS = 1024;
+/**
+ * Sample-flags bit indicating a non-sync (non-keyframe) sample. When this bit is clear (0), the sample is a sync sample / IDR frame / keyframe.
+ *
+ * @category FFmpeg
+ */
+export declare const SAMPLE_FLAG_NON_SYNC = 65536;
+/**
+ * Handler-type code for audio tracks in ISO BMFF `hdlr` boxes: ASCII `"soun"` encoded as a 32-bit big-endian integer. Compared against the `handler_type` field of
+ * each track's `hdlr` fullbox to identify the audio track during init-segment inspection.
+ *
+ * @category FFmpeg
+ */
+export declare const HDLR_TYPE_SOUN = 1936684398;
 /**
  * Describes the location of an ISO BMFF box within a buffer.
  *
@@ -32,7 +76,9 @@ export interface FMp4Box {
  * Locates the first ISO BMFF box of a given type within a byte range.
  *
  * Walks the standard box headers (4-byte big-endian size + 4-byte ASCII type) starting at `start` and ending at `end`. Returns the offset and size of the first
- * matching box, or `null` if no match is found. Does not handle extended-size boxes (64-bit size field) as these are uncommon in fMP4 livestream contexts.
+ * matching box. Returns `null` when no box of the requested type is found in range, and also when the walk encounters a box whose declared size is invalid - below
+ * the header size, extending past the search range, or an extended/open-ended size (64-bit size field, uncommon in fMP4 livestream contexts and unsupported here) -
+ * since a malformed size makes it unsafe to keep walking; the two cases are indistinguishable from the return value alone.
  *
  * @param buffer       - The buffer containing ISO BMFF box data.
  * @param type         - The 4-character ASCII box type to search for (e.g. "moof", "traf", "trun"). Must be exactly 4 characters.
@@ -88,3 +134,4 @@ export declare function splitMoofMdat(fragment: Buffer): Nullable<{
     mdat: Buffer;
     moof: Buffer;
 }>;
+//# sourceMappingURL=fmp4.d.ts.map

package/dist/ffmpeg/fmp4.js

@@ -10,23 +10,59 @@
 export const BOX_HEADER_SIZE = 8;
 // TRUN fullbox header size: standard box header + 4 bytes version/flags + 4 bytes sample_count.
 const TRUN_HEADER_SIZE = BOX_HEADER_SIZE + 8;
-// TRUN box flags indicating the presence of optional fields.
-const TRUN_FLAG_DATA_OFFSET = 0x000001;
-const TRUN_FLAG_FIRST_SAMPLE_FLAGS = 0x000004;
-const TRUN_FLAG_SAMPLE_DURATION = 0x000100;
-const TRUN_FLAG_SAMPLE_SIZE = 0x000200;
-const TRUN_FLAG_SAMPLE_FLAGS = 0x000400;
-// Sample flags bit indicating a non-sync sample. When this bit is clear (0), the sample is a sync sample (keyframe/IDR).
-const SAMPLE_FLAG_NON_SYNC = 0x00010000;
-// Handler type for audio tracks in ISO BMFF: "soun" encoded as a 32-bit integer.
-const HDLR_TYPE_SOUN = 0x736F756E;
+/**
+ * TRUN fullbox flags bit indicating that a `data_offset` field follows the sample_count in the box header.
+ *
+ * @category FFmpeg
+ */
+export const TRUN_FLAG_DATA_OFFSET = 0x000001;
+/**
+ * TRUN fullbox flags bit indicating that a `first_sample_flags` field follows (after `data_offset` if present). When this flag is set, the first sample's flags are
+ * stored in a dedicated header field rather than in the per-sample entries - the common arrangement for fragments emitted with FFmpeg's `frag_keyframe` movflag.
+ *
+ * @category FFmpeg
+ */
+export const TRUN_FLAG_FIRST_SAMPLE_FLAGS = 0x000004;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte duration field.
+ *
+ * @category FFmpeg
+ */
+export const TRUN_FLAG_SAMPLE_DURATION = 0x000100;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte size field.
+ *
+ * @category FFmpeg
+ */
+export const TRUN_FLAG_SAMPLE_SIZE = 0x000200;
+/**
+ * TRUN fullbox flags bit indicating that each sample entry carries a 4-byte sample_flags field.
+ *
+ * @category FFmpeg
+ */
+export const TRUN_FLAG_SAMPLE_FLAGS = 0x000400;
+/**
+ * Sample-flags bit indicating a non-sync (non-keyframe) sample. When this bit is clear (0), the sample is a sync sample / IDR frame / keyframe.
+ *
+ * @category FFmpeg
+ */
+export const SAMPLE_FLAG_NON_SYNC = 0x00010000;
+/**
+ * Handler-type code for audio tracks in ISO BMFF `hdlr` boxes: ASCII `"soun"` encoded as a 32-bit big-endian integer. Compared against the `handler_type` field of
+ * each track's `hdlr` fullbox to identify the audio track during init-segment inspection.
+ *
+ * @category FFmpeg
+ */
+export const HDLR_TYPE_SOUN = 0x736F756E;
 // Offset from the start of an hdlr fullbox to the handler_type field: standard box header (8 bytes) + version/flags (4 bytes) + pre_defined (4 bytes).
 const HDLR_TYPE_OFFSET = BOX_HEADER_SIZE + 8;
 /**
  * Locates the first ISO BMFF box of a given type within a byte range.
  *
  * Walks the standard box headers (4-byte big-endian size + 4-byte ASCII type) starting at `start` and ending at `end`. Returns the offset and size of the first
- * matching box, or `null` if no match is found. Does not handle extended-size boxes (64-bit size field) as these are uncommon in fMP4 livestream contexts.
+ * matching box. Returns `null` when no box of the requested type is found in range, and also when the walk encounters a box whose declared size is invalid - below
+ * the header size, extending past the search range, or an extended/open-ended size (64-bit size field, uncommon in fMP4 livestream contexts and unsupported here) -
+ * since a malformed size makes it unsafe to keep walking; the two cases are indistinguishable from the return value alone.
  *
  * @param buffer       - The buffer containing ISO BMFF box data.
  * @param type         - The 4-character ASCII box type to search for (e.g. "moof", "traf", "trun"). Must be exactly 4 characters.

package/dist/ffmpeg/fmp4.js.map

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

package/dist/ffmpeg/hap-enums.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Mirrors HAP protocol const enum values that HomeKit camera plugins need at value-side runtime. `verbatimModuleSyntax` disallows value imports of ambient const
+ * enums, so the numeric and string contracts from hap-nodejs must be re-declared at value-side. Centralizing the mirrors here gives every consumer a single import
+ * path and a single update point if upstream `hap-nodejs` ever changes a value.
+ *
+ * Values MUST stay in lockstep with the upstream definitions in `hap-nodejs/.../RecordingManagement.d.ts`, `hap-nodejs/.../RTPStreamManagement.d.ts`, and
+ * `hap-nodejs/.../DataStreamServer.d.ts`. The matching type aliases let consumers import the canonical names from one place rather than re-declaring them.
+ *
+ * @module
+ */
+import type { AudioRecordingCodecType as AudioRecordingCodecTypeEnum, AudioRecordingSamplerate as AudioRecordingSamplerateEnum, AudioStreamingCodecType as AudioStreamingCodecTypeEnum, AudioStreamingSamplerate as AudioStreamingSamplerateEnum, H264Level as H264LevelEnum, H264Profile as H264ProfileEnum, HDSProtocolSpecificErrorReason as HDSProtocolSpecificErrorReasonEnum, MediaContainerType as MediaContainerTypeEnum, SRTPCryptoSuites as SRTPCryptoSuitesEnum, StreamRequestTypes as StreamRequestTypesEnum } from "homebridge";
+import type { VideoCodecType as VideoCodecTypeEnum } from "@homebridge/hap-nodejs";
+/**
+ * Numeric mirror of HAP's `AudioRecordingCodecType` const enum, suitable for runtime indexing into translation tables.
+ *
+ * @category FFmpeg
+ */
+export declare const AudioRecordingCodecType: {
+    readonly AAC_ELD: AudioRecordingCodecTypeEnum.AAC_ELD;
+    readonly AAC_LC: AudioRecordingCodecTypeEnum.AAC_LC;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `codec?: AudioRecordingCodecType` annotations resolve through the shared module rather than
+ * a local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type AudioRecordingCodecType = AudioRecordingCodecTypeEnum;
+/**
+ * Numeric mirror of HAP's `AudioRecordingSamplerate` const enum, suitable for runtime indexing into translation tables and for constructing recording configurations
+ * by enum name rather than by raw numeric value.
+ *
+ * @category FFmpeg
+ */
+export declare const AudioRecordingSamplerate: {
+    readonly KHZ_8: AudioRecordingSamplerateEnum.KHZ_8;
+    readonly KHZ_16: AudioRecordingSamplerateEnum.KHZ_16;
+    readonly KHZ_24: AudioRecordingSamplerateEnum.KHZ_24;
+    readonly KHZ_32: AudioRecordingSamplerateEnum.KHZ_32;
+    readonly KHZ_44_1: AudioRecordingSamplerateEnum.KHZ_44_1;
+    readonly KHZ_48: AudioRecordingSamplerateEnum.KHZ_48;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `samplerate: AudioRecordingSamplerate` annotations resolve through the shared module rather
+ * than a local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type AudioRecordingSamplerate = AudioRecordingSamplerateEnum;
+/**
+ * String mirror of HAP's `AudioStreamingCodecType` const enum, surfaced to HomeKit camera streaming delegates when declaring the audio codecs supported on live-stream
+ * sessions.
+ *
+ * @category FFmpeg
+ */
+export declare const AudioStreamingCodecType: {
+    readonly AAC_ELD: AudioStreamingCodecTypeEnum.AAC_ELD;
+    readonly AMR: AudioStreamingCodecTypeEnum.AMR;
+    readonly AMR_WB: AudioStreamingCodecTypeEnum.AMR_WB;
+    readonly MSBC: AudioStreamingCodecTypeEnum.MSBC;
+    readonly OPUS: AudioStreamingCodecTypeEnum.OPUS;
+    readonly PCMA: AudioStreamingCodecTypeEnum.PCMA;
+    readonly PCMU: AudioStreamingCodecTypeEnum.PCMU;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `type: AudioStreamingCodecType` annotations resolve through the shared module rather than a
+ * local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type AudioStreamingCodecType = AudioStreamingCodecTypeEnum;
+/**
+ * Numeric mirror of HAP's `AudioStreamingSamplerate` const enum, surfaced to HomeKit camera streaming delegates when declaring the audio sample rates supported on
+ * live-stream sessions.
+ *
+ * @category FFmpeg
+ */
+export declare const AudioStreamingSamplerate: {
+    readonly KHZ_8: AudioStreamingSamplerateEnum.KHZ_8;
+    readonly KHZ_16: AudioStreamingSamplerateEnum.KHZ_16;
+    readonly KHZ_24: AudioStreamingSamplerateEnum.KHZ_24;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `samplerate: AudioStreamingSamplerate` annotations resolve through the shared module rather
+ * than a local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type AudioStreamingSamplerate = AudioStreamingSamplerateEnum;
+/**
+ * Numeric mirror of HAP's `H264Level` const enum, surfaced when declaring the H.264 levels a camera codec configuration advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export declare const H264Level: {
+    readonly LEVEL3_1: H264LevelEnum.LEVEL3_1;
+    readonly LEVEL3_2: H264LevelEnum.LEVEL3_2;
+    readonly LEVEL4_0: H264LevelEnum.LEVEL4_0;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `levels: H264Level[]` annotations resolve through the shared module rather than a local
+ * redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type H264Level = H264LevelEnum;
+/**
+ * Numeric mirror of HAP's `H264Profile` const enum, surfaced when declaring the H.264 profiles a camera codec configuration advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export declare const H264Profile: {
+    readonly BASELINE: H264ProfileEnum.BASELINE;
+    readonly HIGH: H264ProfileEnum.HIGH;
+    readonly MAIN: H264ProfileEnum.MAIN;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `profiles: H264Profile[]` annotations resolve through the shared module rather than a local
+ * redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type H264Profile = H264ProfileEnum;
+/**
+ * Numeric mirror of HAP's `HDSProtocolSpecificErrorReason` const enum, surfaced to HKSV recording delegates as the categorical reason a HomeKit data stream session
+ * terminated. Recording delegates compare the value they receive in `close(reason)` against these names rather than against opaque numeric constants.
+ *
+ * @category FFmpeg
+ */
+export declare const HDSProtocolSpecificErrorReason: {
+    readonly NORMAL: HDSProtocolSpecificErrorReasonEnum.NORMAL;
+    readonly NOT_ALLOWED: HDSProtocolSpecificErrorReasonEnum.NOT_ALLOWED;
+    readonly BUSY: HDSProtocolSpecificErrorReasonEnum.BUSY;
+    readonly CANCELLED: HDSProtocolSpecificErrorReasonEnum.CANCELLED;
+    readonly UNSUPPORTED: HDSProtocolSpecificErrorReasonEnum.UNSUPPORTED;
+    readonly UNEXPECTED_FAILURE: HDSProtocolSpecificErrorReasonEnum.UNEXPECTED_FAILURE;
+    readonly TIMEOUT: HDSProtocolSpecificErrorReasonEnum.TIMEOUT;
+    readonly BAD_DATA: HDSProtocolSpecificErrorReasonEnum.BAD_DATA;
+    readonly PROTOCOL_ERROR: HDSProtocolSpecificErrorReasonEnum.PROTOCOL_ERROR;
+    readonly INVALID_CONFIGURATION: HDSProtocolSpecificErrorReasonEnum.INVALID_CONFIGURATION;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `reason: HDSProtocolSpecificErrorReason` annotations resolve through the shared module
+ * rather than a local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type HDSProtocolSpecificErrorReason = HDSProtocolSpecificErrorReasonEnum;
+/**
+ * Numeric mirror of HAP's `SRTPCryptoSuites` const enum, surfaced when negotiating the SRTP cipher suite for HomeKit camera streaming sessions.
+ *
+ * @category FFmpeg
+ */
+export declare const SRTPCryptoSuites: {
+    readonly AES_CM_128_HMAC_SHA1_80: SRTPCryptoSuitesEnum.AES_CM_128_HMAC_SHA1_80;
+    readonly AES_CM_256_HMAC_SHA1_80: SRTPCryptoSuitesEnum.AES_CM_256_HMAC_SHA1_80;
+    readonly NONE: SRTPCryptoSuitesEnum.NONE;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `suite: SRTPCryptoSuites` annotations resolve through the shared module rather than a local
+ * redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type SRTPCryptoSuites = SRTPCryptoSuitesEnum;
+/**
+ * Numeric mirror of HAP's `VideoCodecType` const enum, surfaced when declaring the video codec a camera advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export declare const VideoCodecType: {
+    readonly H264: VideoCodecTypeEnum.H264;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `type: VideoCodecType` annotations resolve through the shared module rather than a local
+ * redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type VideoCodecType = VideoCodecTypeEnum;
+/**
+ * Numeric mirror of HAP's `MediaContainerType` const enum, surfaced when declaring the container format of HKSV recording fragments.
+ *
+ * @category FFmpeg
+ */
+export declare const MediaContainerType: {
+    readonly FRAGMENTED_MP4: MediaContainerTypeEnum.FRAGMENTED_MP4;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `type: MediaContainerType` annotations resolve through the shared module rather than a
+ * local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type MediaContainerType = MediaContainerTypeEnum;
+/**
+ * String mirror of HAP's `StreamRequestTypes` const enum, used by HomeKit camera streaming delegates to dispatch on the `type` field of incoming streaming-control
+ * requests.
+ *
+ * @category FFmpeg
+ */
+export declare const StreamRequestTypes: {
+    readonly RECONFIGURE: StreamRequestTypesEnum.RECONFIGURE;
+    readonly START: StreamRequestTypesEnum.START;
+    readonly STOP: StreamRequestTypesEnum.STOP;
+};
+/**
+ * Type alias re-exposing the HAP enum under its canonical name so existing `type: StreamRequestTypes` annotations resolve through the shared module rather than a
+ * local redeclaration in each consumer.
+ *
+ * @category FFmpeg
+ */
+export type StreamRequestTypes = StreamRequestTypesEnum;
+//# sourceMappingURL=hap-enums.d.ts.map

package/dist/ffmpeg/hap-enums.js

@@ -0,0 +1,92 @@
+/* Copyright(C) 2017-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * ffmpeg/hap-enums.ts: Single source of truth for the HAP protocol const enum mirrors that HomeKit camera plugins need at runtime.
+ */
+/**
+ * Numeric mirror of HAP's `AudioRecordingCodecType` const enum, suitable for runtime indexing into translation tables.
+ *
+ * @category FFmpeg
+ */
+export const AudioRecordingCodecType = { AAC_ELD: 1, AAC_LC: 0 };
+/**
+ * Numeric mirror of HAP's `AudioRecordingSamplerate` const enum, suitable for runtime indexing into translation tables and for constructing recording configurations
+ * by enum name rather than by raw numeric value.
+ *
+ * @category FFmpeg
+ */
+export const AudioRecordingSamplerate = { KHZ_16: 1, KHZ_24: 2, KHZ_32: 3, KHZ_44_1: 4, KHZ_48: 5, KHZ_8: 0 };
+/**
+ * String mirror of HAP's `AudioStreamingCodecType` const enum, surfaced to HomeKit camera streaming delegates when declaring the audio codecs supported on live-stream
+ * sessions.
+ *
+ * @category FFmpeg
+ */
+export const AudioStreamingCodecType = {
+    // String const enum members are nominal in TypeScript: a raw string literal is not assignable to the enum member type without an explicit brand. The per-property
+    // assertions make the intent visible at each value, and the assertion fails fast if the upstream string ever changes out from under us.
+    AAC_ELD: "AAC-eld",
+    AMR: "AMR",
+    AMR_WB: "AMR-WB",
+    MSBC: "mSBC",
+    OPUS: "OPUS",
+    PCMA: "PCMA",
+    PCMU: "PCMU"
+};
+/**
+ * Numeric mirror of HAP's `AudioStreamingSamplerate` const enum, surfaced to HomeKit camera streaming delegates when declaring the audio sample rates supported on
+ * live-stream sessions.
+ *
+ * @category FFmpeg
+ */
+export const AudioStreamingSamplerate = { KHZ_16: 16, KHZ_24: 24, KHZ_8: 8 };
+/**
+ * Numeric mirror of HAP's `H264Level` const enum, surfaced when declaring the H.264 levels a camera codec configuration advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export const H264Level = { LEVEL3_1: 0, LEVEL3_2: 1, LEVEL4_0: 2 };
+/**
+ * Numeric mirror of HAP's `H264Profile` const enum, surfaced when declaring the H.264 profiles a camera codec configuration advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export const H264Profile = { BASELINE: 0, HIGH: 2, MAIN: 1 };
+/**
+ * Numeric mirror of HAP's `HDSProtocolSpecificErrorReason` const enum, surfaced to HKSV recording delegates as the categorical reason a HomeKit data stream session
+ * terminated. Recording delegates compare the value they receive in `close(reason)` against these names rather than against opaque numeric constants.
+ *
+ * @category FFmpeg
+ */
+export const HDSProtocolSpecificErrorReason = { BAD_DATA: 7, BUSY: 2, CANCELLED: 3, INVALID_CONFIGURATION: 9, NORMAL: 0, NOT_ALLOWED: 1, PROTOCOL_ERROR: 8, TIMEOUT: 6, UNEXPECTED_FAILURE: 5, UNSUPPORTED: 4 };
+/**
+ * Numeric mirror of HAP's `SRTPCryptoSuites` const enum, surfaced when negotiating the SRTP cipher suite for HomeKit camera streaming sessions.
+ *
+ * @category FFmpeg
+ */
+export const SRTPCryptoSuites = { AES_CM_128_HMAC_SHA1_80: 0, AES_CM_256_HMAC_SHA1_80: 1, NONE: 2 };
+/**
+ * Numeric mirror of HAP's `VideoCodecType` const enum, surfaced when declaring the video codec a camera advertises to HomeKit.
+ *
+ * @category FFmpeg
+ */
+export const VideoCodecType = { H264: 0 };
+/**
+ * Numeric mirror of HAP's `MediaContainerType` const enum, surfaced when declaring the container format of HKSV recording fragments.
+ *
+ * @category FFmpeg
+ */
+export const MediaContainerType = { FRAGMENTED_MP4: 0 };
+/**
+ * String mirror of HAP's `StreamRequestTypes` const enum, used by HomeKit camera streaming delegates to dispatch on the `type` field of incoming streaming-control
+ * requests.
+ *
+ * @category FFmpeg
+ */
+export const StreamRequestTypes = {
+    // String const enum members are nominal in TypeScript: a raw string literal is not assignable to the enum member type without an explicit brand. The per-property
+    // assertions make the intent visible at each value, and the assertion fails fast if the upstream string ever changes out from under us.
+    RECONFIGURE: "reconfigure",
+    START: "start",
+    STOP: "stop"
+};
+//# sourceMappingURL=hap-enums.js.map

package/dist/ffmpeg/hap-enums.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hap-enums.js","sourceRoot":"","sources":["../../src/ffmpeg/hap-enums.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAClC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;AAU5B;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAOjC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAU1E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAQhC;IAEF,kKAAkK;IAClK,wIAAwI;IACxI,OAAO,EAAE,SAAgD;IACzD,GAAG,EAAE,KAAwC;IAC7C,MAAM,EAAE,QAA8C;IACtD,IAAI,EAAE,MAA0C;IAChD,IAAI,EAAE,MAA0C;IAChD,IAAI,EAAE,MAA0C;IAChD,IAAI,EAAE,MAA0C;CACjD,CAAC;AAUF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAIjC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAUzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GACpB,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;AAU5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GACtB,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAUpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAWvC,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAUtK;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAIzB,EAAE,uBAAuB,EAAE,CAAC,EAAE,uBAAuB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAUxE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAA+C,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;AAUtF;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuE,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;AAU5H;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAI3B;IAEF,kKAAkK;IAClK,wIAAwI;IACxI,WAAW,EAAE,aAAmD;IAChE,KAAK,EAAE,OAAuC;IAC9C,IAAI,EAAE,MAAqC;CAC5C,CAAC"}

package/dist/ffmpeg/index.d.ts

@@ -1,9 +1,16 @@
-export * from "./codecs.js";
-export * from "./exec.js";
-export * from "./fmp4.js";
-export * from "./options.js";
-export * from "./process.js";
-export * from "./record.js";
-export * from "./rtp.js";
-export * from "./settings.js";
-export * from "./stream.js";
+export * from "./codecs.ts";
+export * from "./dgram-util.ts";
+export * from "./exec.ts";
+export * from "./fmp4.ts";
+export * from "./hap-enums.ts";
+export * from "./mp4-assembler.ts";
+export * from "./mp4-parser.ts";
+export * from "./options.ts";
+export * from "./process.ts";
+export * from "./record.ts";
+export * from "./recording-process-double.ts";
+export * from "./rtp-parser.ts";
+export * from "./rtp.ts";
+export * from "./settings.ts";
+export * from "./stream.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/ffmpeg/index.js

@@ -3,11 +3,17 @@
  * ffmpeg/index.ts: FFmpeg classes.
  */
 export * from "./codecs.js";
+export * from "./dgram-util.js";
 export * from "./exec.js";
 export * from "./fmp4.js";
+export * from "./hap-enums.js";
+export * from "./mp4-assembler.js";
+export * from "./mp4-parser.js";
 export * from "./options.js";
 export * from "./process.js";
 export * from "./record.js";
+export * from "./recording-process-double.js";
+export * from "./rtp-parser.js";
 export * from "./rtp.js";
 export * from "./settings.js";
 export * from "./stream.js";

package/dist/ffmpeg/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ffmpeg/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ffmpeg/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/ffmpeg/mp4-assembler.d.ts

@@ -0,0 +1,120 @@
+import type { Readable } from "node:stream";
+/**
+ * Construction-time options for {@link Mp4SegmentAssembler}.
+ *
+ * @property segmentTimeout   - Optional watchdog window, in milliseconds. The timer arms when the initialization segment resolves (we begin expecting media segments)
+ *                              and re-arms on each completed media segment. If no segment arrives within the window, the assembler aborts with
+ *                              `HbpuAbortError("timeout")` and the generator terminates cleanly. Typical value for HKSV is a little under five seconds.
+ * @property signal           - Optional parent {@link AbortSignal} to compose with the assembler's internal controller. When the parent aborts, the assembler tears
+ *                              down and the segment generator exits.
+ *
+ * @category FFmpeg
+ */
+export interface Mp4SegmentAssemblerInit {
+    segmentTimeout?: number;
+    signal?: AbortSignal;
+}
+/**
+ * AsyncDisposable fMP4 segment assembler that converts a Readable byte source into an init segment promise and a media-segment async generator.
+ *
+ * Construction kicks off a background drain loop that feeds {@link Mp4BoxParser} from the source's `data` events and routes each parsed box through a small state
+ * machine: everything before the first `moof` accumulates into the initialization segment; from the first `moof` onward, boxes accumulate into the current media
+ * segment until an `mdat` flushes the accumulated pair to the output queue.
+ *
+ * The single public teardown verb is {@link Mp4SegmentAssembler.abort}, mirroring `AbortController.abort()`. `Symbol.asyncDispose` is implemented in terms of it and
+ * awaits the drain loop's completion before returning, so `await using` guarantees the assembler has fully unwound by the time the surrounding scope exits.
+ *
+ * @example
+ *
+ * ```ts
+ * import { Mp4SegmentAssembler } from "homebridge-plugin-utils";
+ *
+ * await using assembler = new Mp4SegmentAssembler(ffmpegStdout, { segmentTimeout: 4500, signal: session.signal });
+ *
+ * const initSegment = await assembler.initSegment;
+ *
+ * for await (const segment of assembler.segments()) {
+ *
+ *   // Forward segment bytes to HomeKit.
+ * }
+ * ```
+ *
+ * @see Mp4BoxParser
+ *
+ * @category FFmpeg
+ */
+export declare class Mp4SegmentAssembler implements AsyncDisposable {
+    #private;
+    /**
+     * The composed abort signal representing this assembler's lifetime. Aborts exactly once when the source ends, the source errors, the parent signal fires, the
+     * watchdog timeout expires, or {@link Mp4SegmentAssembler.abort} is called; the reason encoded on `signal.reason` names the cause.
+     */
+    readonly signal: AbortSignal;
+    /**
+     * Promise that resolves with the concatenated initialization-segment bytes (typically `ftyp` + `moov`) once the first `moof` box arrives on the source. Rejects with
+     * `this.signal.reason` if the assembler is aborted before the initialization segment completes.
+     */
+    readonly initSegment: Promise<Buffer>;
+    /**
+     * Construct and start a new fMP4 segment assembler.
+     *
+     * The drain loop starts synchronously as part of construction: by the time the constructor returns, the source's `data` events are being observed and the parser is
+     * ready to emit boxes. There is no separate `start()` step.
+     *
+     * @param source - Any {@link Readable} producing fMP4 byte chunks. Typically an FFmpeg process's stdout; any Readable works, which keeps the class testable in
+     *                 isolation with in-memory fixture streams.
+     * @param init   - Optional init options. See {@link Mp4SegmentAssemblerInit}.
+     */
+    constructor(source: Readable, init?: Mp4SegmentAssemblerInit);
+    /**
+     * Abort the assembler and tear it down. Defaults to `HbpuAbortError("shutdown")` when no reason is supplied; explicit reasons pass through unchanged.
+     *
+     * Safe to call more than once: subsequent calls are no-ops because the underlying signal only aborts once. Calling `abort()` after natural completion is also safe
+     * for the same reason.
+     *
+     * @param reason - Optional abort reason. Typically an {@link HbpuAbortError}; platform errors (`TimeoutError`, `AbortError`) also interoperate by convention.
+     */
+    abort(reason?: unknown): void;
+    /**
+     * `AsyncDisposable` implementation. Aborts the assembler (defaulting to `"shutdown"`) and awaits actual drain-loop completion before returning, so callers using
+     * `await using` are guaranteed every internal listener has been detached by the time the block exits.
+     *
+     * @returns A promise that resolves once the drain loop has fully exited.
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+    /**
+     * `true` once `this.signal` has aborted. Derived from the signal; no independent state.
+     */
+    get aborted(): boolean;
+    /**
+     * `true` when the abort reason indicates a timeout. Matches both the canonical `HbpuAbortError("timeout")` emitted by the inter-segment watchdog and the platform
+     * `TimeoutError` emitted by `AbortSignal.timeout()`. The discrimination lives in {@link isTimeoutReason} so this getter stays a one-line delegation and every
+     * resource class in the library shares one definition of "timeout."
+     */
+    get isTimedOut(): boolean;
+    /**
+     * The number of completed media segments buffered between the drain loop and the {@link Mp4SegmentAssembler.segments} consumer - the segments the producer has
+     * assembled but the consumer has not yet pulled. A consumer pacing its reads slower than the source produces accrues a reserve here, and that reserve is what
+     * absorbs an upstream stall: the consumer keeps pulling buffered segments while no new ones arrive. It is zero in steady state when the consumer keeps pace.
+     */
+    get bufferedSegments(): number;
+    /**
+     * Async generator yielding each completed media segment (concatenated `moof` + `mdat` pair) as a single Buffer.
+     *
+     * Yields only after {@link Mp4SegmentAssembler.initSegment} has resolved - the init segment is not surfaced through this stream. Terminates cleanly when the source
+     * ends, the assembler aborts, or the optional caller signal aborts; in every case the queue is drained before the generator returns, so a consumer never loses a
+     * segment that was already assembled before teardown.
+     *
+     * **Single-consumer only.** The internal parked-waiter slot is single-writer; calling `segments()` concurrently with another consumer on the same assembler is
+     * unsupported and will hang one of the consumers when the producer's wake-up resolves only the later parker. If fan-out is needed, tee at the consumer side by
+     * replicating each yielded Buffer into per-consumer queues external to the assembler.
+     *
+     * @param init - Optional init options. `signal` composes with the assembler's own signal - aborting it terminates only this generator call, not the assembler.
+     *
+     * @returns An async generator yielding concatenated `moof` + `mdat` pair buffers in stream order.
+     */
+    segments(init?: {
+        signal?: AbortSignal;
+    }): AsyncGenerator<Buffer>;
+}
+//# sourceMappingURL=mp4-assembler.d.ts.map