@norskvideo/norsk-sdk 1.0.334 → 1.0.336

package/dist/norsk-sdk.d.ts

@@ -17,6 +17,7 @@ import { Nullable } from 'typescript-nullable';
 import { PlainMessage } from '@bufbuild/protobuf';
 import { RtmpError_UnsupportedAudio } from '@norskvideo/norsk-api/lib/media_pb';
 import { RtmpError_UnsupportedVideo } from '@norskvideo/norsk-api/lib/media_pb';
+import { Scte35SpliceInfoSection } from '@norskvideo/norsk-api/lib/media_pb';
 import { StreamKey as StreamKey_2 } from '@norskvideo/norsk-api/lib/media_pb';
 import { StreamStatisticsSampling } from '@norskvideo/norsk-api/lib/media_pb';
 import { Subscription } from '@norskvideo/norsk-api/lib/media_pb';
@@ -42,6 +43,35 @@ export declare interface AacSettings {
     profile: AacProfile;
 }
 
+export declare class AncillaryNode extends AutoProcessorMediaNode<"ancillary"> {
+    close(): void;
+    sendScte35(key: StreamKey, info: Scte35SpliceInfoSection): void;
+}
+
+export declare interface AncillarySettings extends ProcessorNodeSettings<AncillaryNode> {
+    onScte35?: (stream: StreamKey, message: Scte35SpliceInfoSection) => void;
+}
+
+/**
+ * @public
+ * Returns the stream keys for ancillary streams in a media context
+ * @param streams - The media context from which to return the stream keys
+ * @returns The ancillary stream keys in the media context
+ */
+export declare function ancillaryStreamKeys(streams: readonly StreamMetadata[]): StreamKey[];
+
+/** @public */
+export declare interface AncillaryStreamMetadata {
+}
+
+/**
+ * @public
+ * Filters a context to only the ancillary streams within it
+ * @param streams - The media context from which to return the streams
+ * @returns The ancillary streams in the media context
+ */
+export declare function ancillaryStreams(streams: readonly StreamMetadata[]): StreamMetadata[];
+
 /**
  * @public
  * see: {@link NorskTransform.audioBuildMultichannel}
@@ -329,7 +359,7 @@ export declare interface AudioStreamMetadata {
 export declare function audioStreams(streams: readonly StreamMetadata[]): StreamMetadata[];
 
 /** @public */
-export declare const audioToPin: <Pins extends string>(pin: Pins) => (streams: StreamMetadata[]) => PinToKey<Pins>;
+export declare function audioToPin<Pins extends string>(pin: Pins): (streams: StreamMetadata[]) => PinToKey<Pins>;
 
 /**
  * @public
@@ -389,7 +419,7 @@ export declare class AutoSinkMediaNode<Pins extends string> extends SinkMediaNod
 }
 
 /** @public */
-export declare const avToPin: <Pins extends string>(pin: Pins) => (streams: StreamMetadata[]) => PinToKey<Pins>;
+export declare function avToPin<Pins extends string>(pin: Pins): (streams: StreamMetadata[]) => PinToKey<Pins>;
 
 /** @public */
 export declare interface AwsCredentials {
@@ -443,12 +473,15 @@ export declare interface AwsS3PushDestinationSettings {
 /**
  * @public
  * There are three possible modes:
+ *
  * - "abr": encode in average bitrate mode, specified in kilobits/sec (note, 1
  *   kilobit is 1000 bits).  You can make use of the vbv settings to control
  *   the bounds on how much the actual bitrate can fluctuate within the bounds
  *   of the average
+ *
  * - "cqp": encode in constant quantizer mode.  In general, crf will give better
  *   results, although cqp can be faster to encode
+ *
  * - "crf": encode in constant rate factor mode.  This will give a constant 'quality'
  *   to the encode, but with a variable bitrate
  */
@@ -669,7 +702,7 @@ export declare class CmafAudioOutputNode extends HlsNodeWithPlaylist<CmafAudioMe
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -703,16 +736,21 @@ export declare interface CmafAudioOutputSettings extends SinkNodeSettings<CmafAu
      */
     delayOutputMs?: number;
     /**
-     * Optionally supply encryption details for the stream
+     * Settings for encrypting the audio.
      */
-    encryption?: {
-        encryptionKey: string;
-        encryptionKeyId: string;
-    };
+    encryption?: EncryptionSettings;
+    /**
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
+     */
+    destinations: CmafDestinationSettings[];
+    /**
+     * Directives to add to the m3u media playlist
+     */
+    m3uAdditions?: string;
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * XML fragment to add to the mpd Representation element
      */
-    destinations: CMAFDestinationSettings[];
+    mpdAdditions?: string;
 }
 
 /**
@@ -722,7 +760,7 @@ export declare interface CmafAudioOutputSettings extends SinkNodeSettings<CmafAu
  * - {@link AwsS3PushDestinationSettings}: Push to Amazon S3
  * - {@link LocalPullDestinationSettings}: Serve directly from the Norsk Web Server
  * */
-export declare type CMAFDestinationSettings = HlsPushDestinationSettings | AwsS3PushDestinationSettings | LocalPullDestinationSettings;
+export declare type CmafDestinationSettings = HlsPushDestinationSettings | AwsS3PushDestinationSettings | LocalPullDestinationSettings;
 
 /**
  * @public
@@ -735,7 +773,7 @@ export declare class CmafMasterOutputNode extends CommonHlsNode<CmafMasterMessag
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -751,9 +789,17 @@ export declare interface CmafMasterOutputSettings extends SinkNodeSettings<CmafM
      */
     playlistName: string;
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
      */
-    destinations: CMAFDestinationSettings[];
+    destinations: CmafDestinationSettings[];
+    /**
+     * Directives to add to the m3u master playlist
+     */
+    m3uAdditions?: string;
+    /**
+     * XML fragment to add to the (top-level) MPD element
+     */
+    mpdAdditions?: string;
 }
 
 /**
@@ -765,7 +811,7 @@ export declare class CmafVideoOutputNode extends HlsNodeWithPlaylist<CmafVideoMe
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -799,16 +845,21 @@ export declare interface CmafVideoOutputSettings extends SinkNodeSettings<CmafVi
      */
     delayOutputMs?: number;
     /**
-     * Optionally supply encryption details for the stream
+     * Settings for encrypting the video.
      */
-    encryption?: {
-        encryptionKey: string;
-        encryptionKeyId: string;
-    };
+    encryption?: EncryptionSettings;
+    /**
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
+     */
+    destinations: CmafDestinationSettings[];
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * Directives to add to the m3u media playlist
      */
-    destinations: CMAFDestinationSettings[];
+    m3uAdditions?: string;
+    /**
+     * XML fragment to add to the mpd Representation element
+     */
+    mpdAdditions?: string;
 }
 
 /**
@@ -820,7 +871,7 @@ export declare class CmafWebVttOutputNode extends HlsNodeWithPlaylist<CmafWebVtt
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -849,9 +900,9 @@ export declare interface CmafWebVttOutputSettings extends SinkNodeSettings<CmafW
      */
     delayOutputMs?: number;
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
      */
-    destinations: CMAFDestinationSettings[];
+    destinations: CmafDestinationSettings[];
     /**
      * A local directory in which to store the segments while they're available
      */
@@ -1033,6 +1084,34 @@ export declare interface DropRandom {
     percentage: number;
 }
 
+/** @public */
+export declare interface EncryptionSettings {
+    /**
+     * The 16-byte key ID used to identify the key, hexadecimal or GUID encoded.
+     */
+    encryptionKeyId: string;
+    /**
+     * The 16-byte key used to encrypt the data, hexadecimal encoded.
+     */
+    encryptionKey: string;
+    /**
+     * The PSSH box(es) to include in the MP4, base64 encoded.
+     * This is typically given by the DRM provider.
+     */
+    encryptionPssh: string;
+    /**
+     * The common encryption scheme used to encrypt data, as per ISO/IEC 23001-7:2016.
+     *
+     * - Default: CBCS encryption scheme (AES-CBC 10% pattern encryption).
+     *   Full-sample encryption for audio tracks, subsample encryption for video
+     *   tracks.
+     *
+     * - CENC encryption scheme (AES-CTR). Full-sample encryption for audio tracks,
+     *   subsample encryption for video tracks.
+     */
+    encryptionScheme?: "cbcs" | "cenc";
+}
+
 /**
  * @public
  * see: {@link NorskInput.fileImage}
@@ -1076,6 +1155,7 @@ export declare class FileMp4InputNode extends SourceMediaNode {
      * Applies a gradual nudge to the outgoing stream timestamps by the specified number of milliseconds
      * */
     nudge(nudge: number): void;
+    updateSettings(settings: FileMp4InputSettingsUpdate): void;
     close(): void;
 }
 
@@ -1093,6 +1173,13 @@ export declare interface FileMp4InputSettings extends SourceNodeSettings<FileMp4
     onEof?: () => void;
     /** Callback to be notified when the file is initially read */
     onInfo?: (info: FileMp4Info) => void;
+    /** Whether to loop back to the start of the file after reaching the end (default false) */
+    loop?: boolean;
+}
+
+export declare interface FileMp4InputSettingsUpdate {
+    /** Whether to loop back to the start of the file after reaching the end */
+    loop?: boolean;
 }
 
 /**
@@ -1125,13 +1212,13 @@ export declare interface FileMp4OutputSettings extends SinkNodeSettings<FileMp4O
      */
     nonfragmentedFileName?: string;
     /**
-     * Common encryption (CENC) key and key ID to use, both 16-bytes encoded in
-     * hexadecimal (32 chars).
+     * Settings for encrypting the audio track.
      */
-    encryption?: {
-        encryptionKey: string;
-        encryptionKeyId: string;
-    };
+    audioEncryption?: EncryptionSettings;
+    /**
+     * Settings for encrypting the video track.
+     */
+    videoEncryption?: EncryptionSettings;
 }
 
 /**
@@ -1139,6 +1226,17 @@ export declare interface FileMp4OutputSettings extends SinkNodeSettings<FileMp4O
  * see: {@link NorskInput.fileTs}
  */
 export declare class FileTsInputNode extends TsCommonInputNode<FileTsInputMessage, FileTsInputNode> {
+    updateSettings(settings: FileTsInputSettingsUpdate): void;
+}
+
+declare interface FileTsInputSettings extends LocalFileInputSettings {
+    /** Whether to loop back to the start of the file after reaching the end */
+    loop?: boolean;
+}
+
+declare interface FileTsInputSettingsUpdate {
+    /** Whether to loop back to the start of the file after reaching the end */
+    loop?: boolean;
 }
 
 /**
@@ -1252,7 +1350,7 @@ export declare class HlsTsAudioOutputNode extends CommonHlsNode<HlsTsAudioMessag
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -1281,9 +1379,17 @@ export declare interface HlsTsAudioOutputSettings extends SinkNodeSettings<HlsTs
      */
     delayOutputMs?: number;
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
      */
-    destinations: CMAFDestinationSettings[];
+    destinations: CmafDestinationSettings[];
+    /**
+     * Directives to add to the m3u media playlist
+     */
+    m3uAdditions?: string;
+    /**
+     * XML fragment to add to the mpd Representation element
+     */
+    mpdAdditions?: string;
 }
 
 /**
@@ -1318,13 +1424,21 @@ export declare interface HlsTsCombinedPushOutputSettings extends SinkNodeSetting
      */
     delayOutputMs?: number;
     /**
-     * The destination {@link CMAFDestinationSettings} for this stream to be published to
+     * The destination {@link CmafDestinationSettings} for this stream to be published to
      */
-    destination: CMAFDestinationSettings;
+    destination: CmafDestinationSettings;
     /**
      * The name of this media playlist (.m3u8 will be added onto this field to generate a filename)
      */
     playlistName: string;
+    /**
+     * Directives to add to the m3u media playlists
+     */
+    m3uAdditions?: string;
+    /**
+     * XML fragment to add to the mpd Representation elements
+     */
+    mpdAdditions?: string;
 }
 
 /**
@@ -1336,7 +1450,7 @@ export declare class HlsTsVideoOutputNode extends CommonHlsNode<HlsTsVideoMessag
      * @public
      * Updates the credentials for a specific destination within this output by id
      * see: {@link UpdateCredentials}
-     * see: {@link CMAFDestinationSettings}
+     * see: {@link CmafDestinationSettings}
      */
     updateCredentials(settings: UpdateCredentials): void;
 }
@@ -1365,11 +1479,26 @@ export declare interface HlsTsVideoOutputSettings extends SinkNodeSettings<HlsTs
      */
     delayOutputMs?: number;
     /**
-     * A list of destinations {@link CMAFDestinationSettings} for this stream to be published to
+     * A list of destinations {@link CmafDestinationSettings} for this stream to be published to
      */
-    destinations: CMAFDestinationSettings[];
+    destinations: CmafDestinationSettings[];
+    /**
+     * Directives to add to the m3u media playlist
+     */
+    m3uAdditions?: string;
+    /**
+     * XML fragment to add to the mpd Representation element
+     */
+    mpdAdditions?: string;
 }
 
+/** @public */
+export declare type IceServerSettings = {
+    urls: string[];
+    username?: string;
+    credential?: string;
+};
+
 /** @public */
 export declare type ImageFormat = "png" | "jpeg" | "gif" | "webp" | "pnm" | "tiff" | "tga" | "dds" | "bmp" | "ico" | "hdr" | "openexr" | "farbfeld" | "avif";
 
@@ -1388,6 +1517,24 @@ export declare interface Interval {
     d: number;
 }
 
+/**
+ * @public
+ * see: {@link NorskTransform.jitterBuffer}
+ */
+export declare class JitterBufferNode extends AutoProcessorMediaNode<"audio" | "video" | "subtitle"> {
+    close(): void;
+}
+
+/**
+ * @public
+ * Settings for a Jitter Buffer
+ * see: {@link NorskTransform.jitterBuffer}
+ * */
+export declare interface JitterBufferSettings extends ProcessorNodeSettings<JitterBufferNode> {
+    /** Buffer delay in milliseconds */
+    delayMs: number;
+}
+
 /**
  * @public
  * The standard settings for any node reading from a file
@@ -1428,46 +1575,6 @@ export declare type Log = {
     message: string;
 };
 
-/** @public */
-export declare type LogicalCpuId = number;
-
-/** @public */
-export declare type MediaNodeId = string;
-
-/** @public */
-export declare class MediaNodeState {
-    id: MediaNodeId | undefined;
-    constructor(client: MediaClient);
-    close(): void;
-}
-
-/**
- * @public
- * Generate encryption parameters from from an encryption KeyID and Key,
- * in the form KEYID:KEY, both 16byte hexadecimal
- */
-export declare function mkEncryption(encryption: string | undefined): {
-    encryptionKey: string;
-    encryptionKeyId: string;
-} | undefined;
-
-/** @public */
-export declare function mkSine(freq: number): Wave;
-
-/** @public */
-export declare interface MultiStreamStatistics {
-    allStreams: SingleStreamStatistics[];
-    sampleSizeSeconds: number;
-    /**
-     * Either `"default"`, if there is only one direction, or `"input"`/`"output"`
-     * (for duplex nodes, where there are two directions)
-     */
-    label: string;
-    total: StreamStatistics;
-    audio: StreamStatistics;
-    video: StreamStatistics;
-}
-
 /**
  * @public
  * Settings for a H264 Encode using Netint Logan hardware
@@ -1475,12 +1582,12 @@ export declare interface MultiStreamStatistics {
  * on the Netint Logan Encoder Documentation
  *
  * These fields have deliberately been written to maintain the same semantics as the
- * Netint documentation where possible.
+ * Logan documentation where possible.
  *
- * If left undefined, all will default to Netint's own defaults
+ * If left undefined, all will default to Logan's own defaults
  * */
-export declare interface NetintH264 {
-    type: "ni-h264";
+export declare interface LoganH264 {
+    type: "logan-h264";
     /** This (for convenience) takes the xcoder string that Logan's
      * Ffmpeg integration accepts, this is to aid developers in getting up and running
      * quickly and will override any values set manually in the rest of this interface.
@@ -1501,15 +1608,15 @@ export declare interface NetintH264 {
     rcEnable?: boolean;
     intraQp?: number;
     rcInitDelay?: number;
-    profile?: NetintH264Profile;
-    level?: NetintH264Level;
+    profile?: LoganH264Profile;
+    level?: LoganH264Level;
 }
 
 /** @public */
-export declare type NetintH264Level = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+export declare type LoganH264Level = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
 
 /** @public */
-export declare type NetintH264Profile = "baseline" | "main" | "extended" | "high" | "high10";
+export declare type LoganH264Profile = "baseline" | "main" | "extended" | "high" | "high10";
 
 /**
  * @public
@@ -1518,12 +1625,12 @@ export declare type NetintH264Profile = "baseline" | "main" | "extended" | "high
  * on the Netint Logan Encoder Documentation
  *
  * These fields have deliberately been written to maintain the same semantics as the
- * Netint documentation where possible.
+ * Logan documentation where possible.
  *
- * If left undefined, all will default to Netint's own defaults
+ * If left undefined, all will default to Logan's own defaults
  * */
-export declare interface NetintHevc {
-    type: "ni-hevc";
+export declare interface LoganHevc {
+    type: "logan-hevc";
     /** This (for convenience) takes the xcoder string that Logan's
      * Ffmpeg integration accepts, this is to aid developers in getting up and running
      * quickly and will override any values set manually in the rest of this interface.
@@ -1544,22 +1651,59 @@ export declare interface NetintHevc {
     rcEnable?: boolean;
     intraQp?: number;
     rcInitDelay?: number;
-    profile?: NetintHevcProfile;
-    level?: NetintHevcLevel;
-    tier?: NetintHevcTier;
+    profile?: LoganHevcProfile;
+    level?: LoganHevcLevel;
+    tier?: LoganHevcTier;
     lossless?: boolean;
     hrdEnable?: boolean;
     dolbyVisionProfile?: number;
 }
 
 /** @public */
-export declare type NetintHevcLevel = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+export declare type LoganHevcLevel = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+
+/** @public */
+export declare type LoganHevcProfile = "main" | "main10";
+
+/** @public */
+export declare type LoganHevcTier = "main" | "high";
+
+/** @public */
+export declare type LogicalCpuId = number;
+
+/** @public */
+export declare type MediaNodeId = string;
+
+/** @public */
+export declare class MediaNodeState {
+    id: MediaNodeId | undefined;
+    constructor(client: MediaClient);
+    close(): void;
+}
+
+/**
+ * @public
+ * Generate encryption parameters from from an encryption KeyID and Key,
+ * in the form KEYID:KEY, both 16byte hexadecimal
+ */
+export declare function mkEncryption(encryption: string | undefined, pssh?: string | undefined): EncryptionSettings | undefined;
 
 /** @public */
-export declare type NetintHevcProfile = "main" | "main10";
+export declare function mkSine(freq: number): Wave;
 
 /** @public */
-export declare type NetintHevcTier = "main" | "high";
+export declare interface MultiStreamStatistics {
+    allStreams: SingleStreamStatistics[];
+    sampleSizeSeconds: number;
+    /**
+     * Either `"default"`, if there is only one direction, or `"input"`/`"output"`
+     * (for duplex nodes, where there are two directions)
+     */
+    label: string;
+    total: StreamStatistics;
+    audio: StreamStatistics;
+    video: StreamStatistics;
+}
 
 /** @public */
 export declare function newSilentMatrix(rows: number, cols: number): Gain[][];
@@ -1696,12 +1840,21 @@ export declare interface NorskInput {
      * Read from a Transport Stream file with realtime playback.
      * @param settings - Configuration for the file input
      */
-    fileTs(settings: LocalFileInputSettings): Promise<FileTsInputNode>;
+    fileTs(settings: FileTsInputSettings): Promise<FileTsInputNode>;
     /**
      * Stream from a SRT source
      * @param settings - Configuration for the SRT input
      */
     srt(settings: SrtInputSettings): Promise<SrtInputNode>;
+    /**
+     * Receive media via WebRTC via the WHIP standard.
+     *
+     * Here Norsk acts as the Media Server receiving from a remote WHIP client, to act as the
+     * WHIP client sending to a remote media server see {@link NorskOutput.whip}. For a duplex
+     * connection to a browser peer see {@link NorskDuplex.webRtcBrowser}.
+     *
+     * @param settings - Configuration for the WHIP input
+     */
     whip(settings: WhipInputSettings): Promise<WhipInputNode>;
     /**
      * Read from a Transport Stream on the network
@@ -1764,7 +1917,7 @@ export declare interface NorskOutput {
      * HLS or DASH manifests.
      *
      * These can optionally be served the Norsk web server or be pushed
-     * to other locations - see {@link CMAFDestinationSettings}
+     * to other locations - see {@link CmafDestinationSettings}
      *
      * @param settings - Configuration for the CMAF Video Stream
      */
@@ -1774,7 +1927,7 @@ export declare interface NorskOutput {
      * HLS or DASH manifests.
      *
      * These can optionally be served via the Norsk web server or be pushed
-     * to other locations - see {@link CMAFDestinationSettings}
+     * to other locations - see {@link CmafDestinationSettings}
      *
      * @param settings - Configuration for the CMAF Audio Stream
      */
@@ -1790,7 +1943,7 @@ export declare interface NorskOutput {
      * Produces a master (hls and/or dash) manifest for a collection of media streams
      *
      * This can optionally be served via the Norsk web server or be pushed
-     * to other locations - see {@link CMAFDestinationSettings}
+     * to other locations - see {@link CmafDestinationSettings}
      *
      * @param settings - Configuration for the CMAF Master Manifest
      */
@@ -1798,7 +1951,7 @@ export declare interface NorskOutput {
     /**
      * Produces Transport Stream video segments with the supplied settings for use in
      * HLS manifests and builds a playlist served locally from the Norsk Web Server
-     * or from other locations - see {@link CMAFDestinationSettings}
+     * or from other locations - see {@link CmafDestinationSettings}
      *
      * @param settings - Configuration for the HLS TS Stream
      */
@@ -1806,14 +1959,14 @@ export declare interface NorskOutput {
     /**
      * Produces Transport Stream audio segments with the supplied settings for use in
      * HLS manifests and builds a playlist served locally from the Norsk Web Server
-     *  or from other locations - see {@link CMAFDestinationSettings}
+     *  or from other locations - see {@link CmafDestinationSettings}
      *
      * @param settings - Configuration for the HLS TS Stream
      */
     hlsTsAudio(settings: HlsTsAudioOutputSettings): Promise<HlsTsAudioOutputNode>;
     /**
      * Produces Transport Stream segments containing both video and audio with the supplied settings for use in
-     * HLS manifests and pushes them to the configured location (see {@link CMAFDestinationSettings})
+     * HLS manifests and pushes them to the configured location (see {@link CmafDestinationSettings})
      *
      * @param settings - Configuration for the HLS TS Stream
      */
@@ -1833,11 +1986,24 @@ export declare interface NorskOutput {
      */
     srt(settings: SrtOutputSettings): Promise<SrtOutputNode>;
     /**
-     * Connects and sends media to a remote server via WebRTC using the WHIP standard
+     * Connects and sends media to a remote server via WebRTC using the WHIP standard.
+     *
+     * Here Norsk acts as the WHIP client sending to a remote Media Server; to
+     * have Norsk act as the Media Server ingesting from some other WHIP client, see
+     * {@link NorskInput.whip}
      *
      * @param settings - Configuration for the WebRTC Stream
      */
     whip(settings: WhipOutputSettings): Promise<WhipOutputNode>;
+    /**
+     * Hosts media for clients connecting via WebRTC using the WHEP standard.
+     *
+     * To send media to a remote Media Server via WebRTC see {@link NorskOutput.whip}.
+     * See also {@link NorskInput.whip}, {@link NorskDuplex.webRtcBrowser}.
+     *
+     * @param settings - Configuration for the WebRTC Stream
+     */
+    whep(settings: WhepOutputSettings): Promise<WhepOutputNode>;
     /**
      * Connects and sends media to a remote RTMP server
      *
@@ -2031,12 +2197,19 @@ export declare interface NorskTransform {
      * @param settings - Bitrate and language metadata plus general node settings.
      */
     streamMetadataOverride(settings: StreamMetadataOverrideSettings): Promise<StreamMetadataOverrideNode>;
+    /**
+     * Buffer a stream for the specified number of milliseconds. This can be used
+     * to reduce or eliminate jitter.
+     * @param settings - Buffer delay time.
+     */
+    jitterBuffer(settings: JitterBufferSettings): Promise<JitterBufferNode>;
     /**
      * Sync multiple streams together by timestamps, queuing frames from streams
      * that are behind the others. This is already included in most nodes,
      * especially outputs.
      */
     streamSync(settings: StreamSyncSettings): Promise<StreamSyncNode>;
+    ancillary(settings: AncillarySettings): Promise<AncillaryNode>;
 }
 
 /** @public */
@@ -2284,6 +2457,99 @@ export declare interface ProcessorNodeSettings<T extends MediaNodeState> extends
 /** @public */
 export declare function publicUrlPrefix(): string;
 
+/**
+ * @public
+ * Settings for a H264 Encode using Netint Quadra hardware
+ * A detailed description of these params can be found
+ * on the Netint Quadra Encoder Documentation
+ *
+ * These fields have deliberately been written to maintain the same semantics as the
+ * Quadra documentation where possible.
+ *
+ * If left undefined, all will default to Quadra's own defaults
+ * */
+export declare interface QuadraH264 {
+    type: "quadra-h264";
+    /** This (for convenience) takes the xcoder string that Quadra's
+     * Ffmpeg integration accepts, this is to aid developers in getting up and running
+     * quickly and will override any values set manually in the rest of this interface.
+     *
+     * It is expected that developers will choose to use the typed fields for most things instead
+     * when moving to production, as they offer a degree of validation and type safety
+     * */
+    extraOpts?: string;
+    enableAud?: boolean;
+    gpuIndex?: number;
+    bitrate?: number;
+    flushGop?: boolean;
+    enableVfr?: boolean;
+    crf?: number;
+    cbr?: boolean;
+    gopPresetIndex?: number;
+    intraPeriod?: number;
+    rcEnable?: boolean;
+    intraQp?: number;
+    rcInitDelay?: number;
+    profile?: QuadraH264Profile;
+    level?: QuadraH264Level;
+}
+
+/** @public */
+export declare type QuadraH264Level = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+
+/** @public */
+export declare type QuadraH264Profile = "baseline" | "main" | "extended" | "high" | "high10";
+
+/**
+ * @public
+ * Settings for a HEVC Encode using Netint Quadra hardware
+ * A detailed description of these params can be found
+ * on the Netint Quadra Encoder Documentation
+ *
+ * These fields have deliberately been written to maintain the same semantics as the
+ * Quadra documentation where possible.
+ *
+ * If left undefined, all will default to Quadra's own defaults
+ * */
+export declare interface QuadraHevc {
+    type: "quadra-hevc";
+    /** This (for convenience) takes the xcoder string that Quadra's
+     * Ffmpeg integration accepts, this is to aid developers in getting up and running
+     * quickly and will override any values set manually in the rest of this interface.
+     *
+     * It is expected that developers will choose to use the typed fields for most things instead
+     * when moving to production, as they offer a degree of validation and type safety
+     * */
+    extraOpts?: string;
+    enableAud?: boolean;
+    gpuIndex?: number;
+    bitrate?: number;
+    flushGop?: boolean;
+    enableVfr?: boolean;
+    crf?: number;
+    cbr?: boolean;
+    gopPresetIndex?: number;
+    intraPeriod?: number;
+    rcEnable?: boolean;
+    intraQp?: number;
+    rcInitDelay?: number;
+    profile?: QuadraHevcProfile;
+    level?: QuadraHevcLevel;
+    tier?: QuadraHevcTier;
+    lossless?: boolean;
+    hrdEnable?: boolean;
+    dolbyVisionProfile?: number;
+}
+
+/** @public */
+export declare type QuadraHevcLevel = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+
+/** @public */
+export declare type QuadraHevcProfile = "main" | "main10";
+
+/** @public */
+export declare type QuadraHevcTier = "main" | "high";
+
 /** @public */
 export declare type ReceiveFromAddress<Pins extends string> = {
     source: SourceMediaNode;
@@ -2307,6 +2573,25 @@ export declare interface RemoteInputSettings<T extends MediaNodeState> extends I
     port: number;
 }
 
+/**
+ * @public
+ * Validation function to require at least one audio and at least one video stream. Often the default validation
+ * will happen to ensure this, as audio and video are subscribed from separate media nodes, but when one media node
+ * will produce both audio and video, default validation cannot know that both are required.
+ */
+export declare const requireAV: (ctx: Context) => boolean;
+
+/**
+ * @public
+ * Validation function to require exactly N audio and exactly N video streams. Often the default validation
+ * will happen to ensure this, as audio and video are subscribed from separate media nodes, but when one media node
+ * will produce both audio and video, default validation cannot know that both are required.
+ */
+export declare const requireExactAV: ({ audio, video }: {
+    audio: number;
+    video: number;
+}) => (ctx: Context) => boolean;
+
 /**
  * @public
  * The resolution of a video within Norsk
@@ -2334,6 +2619,8 @@ export declare interface RtmpOutputSettings extends SinkNodeSettings<RtmpOutputN
      * The URL of the remote RTMP server to connect to, including the full stream path and credentials
      */
     url: string;
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
 }
 
 /**
@@ -2783,6 +3070,8 @@ export declare interface SrtOutputSettings extends SinkNodeSettings<SrtOutputNod
      * The port to listen on in listener mode, or to connect to in caller mode
      */
     port: number;
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
     /**
      * On connect callback, notifying that a new caller has connected (in listener mode) and providing the stream_id that was set on the socket
      * @eventProperty
@@ -2817,6 +3106,10 @@ export declare interface StreamChaosMonkeySettings extends ProcessorNodeSettings
      * leaving this undefined means don't drop any frames
      * */
     frameDrop?: DropRandom | DropEvery;
+    /**
+     * Introduce random jitter
+     */
+    jitterMs?: number;
 }
 
 /** @public */
@@ -2873,6 +3166,9 @@ export declare type StreamMetadataMessage = {
 } | {
     case: "subtitle";
     value: SubtitleStreamMetadata;
+} | {
+    case: "ancillary";
+    value: AncillaryStreamMetadata;
 } | {
     case: undefined;
     value?: undefined;
@@ -3025,6 +3321,9 @@ export declare interface StreamSwitchSmoothSettings<Pins extends string> extends
     outputResolution: Resolution;
     /** The constant samplerate that all output audio will be resampled to */
     sampleRate: SampleRate;
+    /** Callback which will be called if a switch request cannot be fulfilled */
+    onSwitchError?: (message: string, inputPin?: Pins) => void;
+    onInboundContextChange?: (allStreams: Map<Pins, StreamMetadata[]>) => Promise<void>;
 }
 
 /**
@@ -3093,7 +3392,7 @@ export declare type SubscriptionError = {
 };
 
 /** @public */
-export declare const subtitlesToPin: <Pins extends string>(pin: Pins) => (streams: StreamMetadata[]) => PinToKey<Pins>;
+export declare function subtitlesToPin<Pins extends string>(pin: Pins): (streams: StreamMetadata[]) => PinToKey<Pins>;
 
 /**
  * @public
@@ -3174,6 +3473,8 @@ export declare interface UdpTsOutputSettings extends SinkNodeSettings<UdpTsOutpu
     iface: string;
     /** The port to send to */
     port: number;
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
 }
 
 /**
@@ -3312,13 +3613,13 @@ export declare interface VideoEncodeRung {
     /**
      * The codec (and detailed configuration) to use for the encoding operation.
      *
-     * Note: Nvidia and Netint require Nvidia or Netint hardware to be set up and
+     * Note: Nvidia and Logan/Quadra require Nvidia or Logan/Quadra hardware to be set up and
      * made available to Norsk
      *
      * A ladder can use several different codecs across its various rungs and the
      * VideoEncode node will attempt to build a pipeline that uses the hardware efficently
      */
-    codec: X264Codec | X265Codec | NvidiaH264 | NvidiaHevc | NetintH264 | NetintHevc;
+    codec: X264Codec | X265Codec | NvidiaH264 | NvidiaHevc | LoganH264 | LoganHevc | QuadraH264 | QuadraHevc;
 }
 
 /**
@@ -3354,7 +3655,7 @@ export declare interface VideoStreamMetadata {
 export declare function videoStreams(streams: readonly StreamMetadata[]): StreamMetadata[];
 
 /** @public */
-export declare const videoToPin: <Pins extends string>(pin: Pins) => (streams: StreamMetadata[]) => PinToKey<Pins>;
+export declare function videoToPin<Pins extends string>(pin: Pins): (streams: StreamMetadata[]) => PinToKey<Pins>;
 
 /**
  * @public
@@ -3397,6 +3698,34 @@ export declare class WebRTCBrowserNode extends AutoProcessorMediaNode<"audio" |
  * see: {@link NorskDuplex.webRtcBrowser}
  * */
 export declare interface WebRTCBrowserSettings extends ProcessorNodeSettings<WebRTCBrowserNode>, StreamStatisticsMixin {
+    iceServers?: IceServerSettings[];
+    reportedIceServers?: IceServerSettings[];
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
+}
+
+/**
+ * @public
+ * see: {@link NorskOutput.whep}
+ */
+export declare class WhepOutputNode extends AutoSinkMediaNode<"audio" | "video"> {
+    /** @public The URL of the local player */
+    playerUrl: string;
+    /** @public The URL of the WHEP endpoint */
+    endpointUrl: string;
+    close(): void;
+}
+
+/**
+ * @public
+ * The settings for a WebRTC WHEP Output
+ * see {@link NorskOutput.whep}
+ */
+export declare interface WhepOutputSettings extends SinkNodeSettings<WhepOutputNode>, StreamStatisticsMixin {
+    iceServers?: IceServerSettings[];
+    reportedIceServers?: IceServerSettings[];
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
 }
 
 /**
@@ -3404,6 +3733,10 @@ export declare interface WebRTCBrowserSettings extends ProcessorNodeSettings<Web
  * see: {@link NorskInput.whip}
  */
 export declare class WhipInputNode extends SourceMediaNode {
+    /** @public The URL of the local test client */
+    clientUrl: string;
+    /** @public The URL of the WHIP endpoint */
+    endpointUrl: string;
     /**
      * @public
      * Applies a gradual nudge to the outgoing stream timestamps by the specified number of milliseconds
@@ -3414,6 +3747,8 @@ export declare class WhipInputNode extends SourceMediaNode {
 
 /** @public */
 export declare interface WhipInputSettings extends InputSettings<WhipInputNode>, StreamStatisticsMixin {
+    iceServers?: IceServerSettings[];
+    reportedIceServers?: IceServerSettings[];
 }
 
 /**
@@ -3436,6 +3771,8 @@ export declare interface WhipOutputSettings extends SinkNodeSettings<WhipOutputN
     uri: string;
     /** The auth header to supply (for example: 'Bearer: mybearertoken') */
     authHeader: string;
+    /** Jitter buffer delay in milliseconds */
+    bufferDelayMs?: number;
 }
 
 /** @public */
@@ -3527,9 +3864,13 @@ export declare type X264Level = 1 | 1.1 | 1.2 | 1.3 | 2 | 2.1 | 2.2 | 3 | 3.1 |
 /**
  * @public
  * Three possible values:
+ *
  * - "none": specify no HRD information
+ *
  * - "vbr": specify HRD information
+ *
  * - "cbr": specify HRD information and pack the bitstream to the bitrate specified
+ *
  * See the X264 Docs for a further description of this value
  */
 export declare type X264NalHrd = "none" | "vbr" | "cbr";