@norskvideo/norsk-sdk 1.0.350 → 1.0.351

package/dist/norsk-sdk.d.ts

@@ -102,6 +102,7 @@ export declare class AudioBuildMultichannelNode extends AutoProcessorMediaNode<"
 export declare interface AudioBuildMultichannelSettings extends ProcessorNodeSettings<AudioBuildMultichannelNode> {
     /** The channel layout of the built outgoing stream */
     channelLayout: ChannelLayout;
+    sampleRate: SampleRate;
     /**
      * Stream keys specifying the source for each channel, where the order is
      * significant. The streams must all have the same sample format and sample
@@ -452,8 +453,13 @@ export declare interface AudioTranscribeWhisperSettings extends ProcessorNodeSet
     noFallback?: boolean;
     numThreads?: number;
     useGpu?: boolean;
-    language: string;
+    language?: string;
     model: string;
+    translate?: boolean;
+    tinyDiarize?: boolean;
+    initialPrompt?: string;
+    suppressNonSpeechTokens?: boolean;
+    samplingStrategy?: WhisperSamplingStrategy;
 }
 
 export declare interface AutoProcessorMediaNode<Pins extends string> extends SourceMediaNode, AutoSinkMediaNode<Pins> {
@@ -1348,6 +1354,8 @@ export declare class FileTsOutputNode extends AutoSinkMediaNode<"audio" | "video
 export declare interface FileTsOutputSettings extends SinkNodeSettings<FileTsOutputNode>, StreamStatisticsMixin {
     /** The file to write - this will be truncated if it already exist */
     fileName: string;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: number;
 }
 
 /**
@@ -1363,12 +1371,40 @@ export declare interface FrameRate {
     seconds: number;
 }
 
+/** @public */
 export declare type FrameStoreCut = {
     startDateTime: Date;
     durationMs: number;
     sessionNum?: number;
 };
 
+/** @public */
+export declare type FrameStoreCutRequest = {
+    fileFormat: "mp4";
+    id: string;
+    streamSelection: FrameStoreStreamSelection;
+    cuts: FrameStoreCut[];
+    trimPartialSegments: boolean;
+    fileName: string;
+    progressCb: (progress: number) => void;
+    completeCb: (size: bigint) => void;
+};
+
+/** @public */
+export declare type FrameStoreExpireBySize = {
+    expire: "bySize";
+    size: number;
+};
+
+/** @public */
+export declare type FrameStoreExpireByTime = {
+    expire: "byTime";
+    durationS: number;
+};
+
+/** @public */
+export declare type FrameStoreExpiry = FrameStoreExpireBySize | FrameStoreExpireByTime;
+
 /**
  * @public
  * see: {@link NorskInput.frameStorePlayer}
@@ -1407,6 +1443,7 @@ export declare interface FrameStorePlayerSettings extends InputSettings<FrameSto
  * see: {@link NorskOutput.frameStoreRecording}
  */
 export declare class FrameStoreRecorderNode extends AutoSinkMediaNode<"audio" | "video"> {
+    makeCut(request: FrameStoreCutRequest): void;
 }
 
 /**
@@ -1427,8 +1464,13 @@ export declare interface FrameStoreRecorderSettings extends SinkNodeSettings<Fra
      * Required: Duration of the frame store chunk files
      */
     chunkFileDurationSeconds: number;
+    /**
+     * Optional: Expiry settings - if not supplied, then data will *not* get expired so on long-running events you may exhaust available disk space
+     */
+    expiry?: FrameStoreExpiry;
 }
 
+/** @public */
 export declare type FrameStoreStreamSelection = "all" | StreamKey[];
 
 export declare function fromVancPayloadFormat(format: VancPayloadFormat_2): VancPayloadFormat;
@@ -1962,6 +2004,14 @@ export declare interface MediaSegment {
     number?: number;
 }
 
+export declare class MetadataCombineMode extends AutoProcessorMediaNode<"ancillary"> {
+}
+
+export declare interface MetadataCombineSettings extends ProcessorNodeSettings<MetadataCombineMode> {
+    outputStreamKey: StreamKey;
+    maxSyncDelta?: number;
+}
+
 /**
  * @public
  * Generate encryption parameters from from an encryption KeyID and Key,
@@ -2577,7 +2627,15 @@ export declare interface NorskTransform {
      * hundred milliseconds
      */
     streamAlign(settings: StreamAlignSettings): Promise<StreamAlignNode>;
+    /**
+     * Observe, modify or inject ancillary data such as SCTE-35
+     */
     ancillary(settings: AncillarySettings): Promise<AncillaryNode>;
+    /**
+     * Combine compatible streams of metadata (this refers to ancillary streams of metadata messages, such as that
+     * carried in an MPEG-TS PES metadata stream (e.g. KLV), unrelated to operations on the metadata of audio/video/etc streams.
+     */
+    metadataCombine(settings: MetadataCombineSettings): Promise<MetadataCombineMode>;
 }
 
 /** @public */
@@ -3043,6 +3101,8 @@ export declare interface RtmpOutputSettings extends SinkNodeSettings<RtmpOutputN
     url: string;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds (to allow embedded captions to be added) */
+    avDelayMs?: number;
     /** Called when the RTMP output succesfully connects to a server and starts publishing data */
     onPublishStart?: () => void;
     /** Called when the connection to the RTMP server fails */
@@ -3467,7 +3527,28 @@ export declare type Scte35TimeSignalCommand = {
     spliceTime: Scte35SpliceTime;
 };
 
-/** @public */
+/**
+ * @public
+ * Select all the streams from the input
+ * @param streams - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
+export declare function selectAll(streams: readonly StreamMetadata[]): StreamKey[];
+
+/**
+ * @public
+ * Select all the ancillary data streams from the input
+ * @param streams - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
+export declare function selectAncillary(streams: readonly StreamMetadata[]): StreamKey[];
+
+/**
+ * @public
+ * Select all the audio streams from the input
+ * @param streams - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
 export declare function selectAudio(streams: readonly StreamMetadata[]): StreamKey[];
 
 /**
@@ -3484,13 +3565,28 @@ export declare function selectExactKey(key: StreamKey): (streams: readonly Strea
 /** @public */
 export declare function selectPlaylist(streams: readonly StreamMetadata[]): StreamKey[];
 
-/** @public */
+/**
+ * @public
+ * Select all the subtitle streams from the input
+ * @param streams - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
 export declare function selectSubtitles(streams: readonly StreamMetadata[]): StreamKey[];
 
-/** @public */
+/**
+ * @public
+ * Select all the video streams from the input
+ * @param streams - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
 export declare function selectVideo(streams: readonly StreamMetadata[]): StreamKey[];
 
-/** @public */
+/**
+ * @public
+ * Create a selector selecting all the video streams from the input with the specified rendition name
+ * @param renditionName - The streams from the inbound Context
+ * @returns Array of selected StreamKeys
+ */
 export declare function selectVideoRendition(renditionName: string): (streams: readonly StreamMetadata[]) => StreamKey[];
 
 /** @public */
@@ -3715,6 +3811,8 @@ export declare interface SrtOutputSettings extends SinkNodeSettings<SrtOutputNod
     port: number;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: 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
@@ -3958,6 +4056,17 @@ export declare interface StreamSwitchHardSettings<Pins extends string> extends P
     outputSource: string;
 }
 
+/** @public */
+export declare type StreamSwitchSmoothHardwareAcceleration = 
+/**
+* Use the quadra overlay functionality to perform the compose
+*/
+"quadra"
+/**
+* Use an nvidia CUDA kernel to perform the compose
+*/
+| "nvidia";
+
 /**
  * @public
  * see: {@link NorskControl.streamSwitchSmooth}
@@ -4014,6 +4123,10 @@ export declare interface StreamSwitchSmoothSettings<Pins extends string> extends
      * @param allStreams The collection of input contexts received over all input pins
      */
     onInboundContextChange?: (allStreams: Map<Pins, StreamMetadata[]>) => Promise<void>;
+    /**
+     * Optionally attempt to perform the compose operation on hardware
+     */
+    hardwareAcceleration?: ComposeHardwareAcceleration;
 }
 
 /**
@@ -4108,8 +4221,10 @@ export declare type SubscriptionError = {
  * - false/deny: Deny the incoming context, if no context has been accepted, then queue data until one is
  * - accept_and_terminate: Allow the incoming context, then deny further data, flush and shut down the node
  *      this is useful for cleanly terminating outputs when the context is empty
+ * - deny_and_queue: Deny the incoming context, and revert to the original queueing behaviour as if no context has been accepted
+ *      this is useful when switching from one full context to another, avoiding any "in-between"
  * */
-export declare type SubscriptionValidationResponse = true | false | "accept" | "deny" | "accept_and_terminate";
+export declare type SubscriptionValidationResponse = true | false | "accept" | "deny" | "accept_and_terminate" | "deny_and_queue";
 
 /** @public */
 export declare function subtitlesToPin<Pins extends string>(pin: Pins): (streams: StreamMetadata[]) => PinToKey<Pins>;
@@ -4203,6 +4318,8 @@ export declare interface UdpTsOutputSettings extends SinkNodeSettings<UdpTsOutpu
     port: number;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: number;
     /** Whether to encapsulate in RTP via RFC 2250 (default: false) */
     rtpEncapsulate?: boolean;
 }
@@ -4558,6 +4675,14 @@ export declare interface WhipOutputSettings extends SinkNodeSettings<WhipOutputN
     bufferDelayMs?: number;
 }
 
+declare type WhisperSamplingStrategy = {
+    strategy: 'greedy';
+    bestOf?: number;
+} | {
+    strategy: "beam_search";
+    beam_size?: number;
+};
+
 /** @public */
 export declare interface X264Codec {
     type: "x264";
@@ -4768,9 +4893,9 @@ export declare type X265Tune = "psnr" | "ssim" | "grain" | "zerolatency" | "fast
 
 /**
  * @public
- * Settings for a H264 Encode using Netint Xilinx hardware
+ * Settings for a H264 Encode using Xilinx hardware
  * A detailed description of these params can be found
- * on the Netint Xilinx Encoder Documentation
+ * on the Xilinx Encoder Documentation
  *
  * These fields have deliberately been written to maintain the same semantics as the
  * Xilinx documentation where possible.
@@ -4781,6 +4906,13 @@ export declare interface XilinxH264 {
     type: "xilinx-h264";
     profile?: XilinxH264Profile;
     level?: XilinxH264Level;
+    rateControl?: XilinxRateControl;
+    lookaheadDepth?: number;
+    idrPeriod?: number;
+    bframes?: number;
+    gopSize?: number;
+    minQp?: number;
+    maxQp?: number;
 }
 
 /** @public */
@@ -4791,9 +4923,9 @@ export declare type XilinxH264Profile = "baseline" | "main" | "extended" | "high
 
 /**
  * @public
- * Settings for a HEVC Encode using Netint Xilinx hardware
+ * Settings for a HEVC Encode using Xilinx hardware
  * A detailed description of these params can be found
- * on the Netint Xilinx Encoder Documentation
+ * on the Xilinx Encoder Documentation
  *
  * These fields have deliberately been written to maintain the same semantics as the
  * Xilinx documentation where possible.
@@ -4816,4 +4948,10 @@ export declare type XilinxHevcProfile = "main" | "main10";
 /** @public */
 export declare type XilinxHevcTier = "main" | "high";
 
+/** @public */
+export declare interface XilinxRateControl {
+    value: number;
+    mode: "constQp" | "cbr" | "vbr" | "lowLatency";
+}
+
 export { }

package/lib/src/media_nodes/common.d.ts

@@ -94,8 +94,10 @@ export declare class SourceMediaNode extends MediaNodeState {
  * - false/deny: Deny the incoming context, if no context has been accepted, then queue data until one is
  * - accept_and_terminate: Allow the incoming context, then deny further data, flush and shut down the node
  *      this is useful for cleanly terminating outputs when the context is empty
+ * - deny_and_queue: Deny the incoming context, and revert to the original queueing behaviour as if no context has been accepted
+ *      this is useful when switching from one full context to another, avoiding any "in-between"
  * */
-export declare type SubscriptionValidationResponse = true | false | "accept" | "deny" | "accept_and_terminate";
+export declare type SubscriptionValidationResponse = true | false | "accept" | "deny" | "accept_and_terminate" | "deny_and_queue";
 /** @public */
 export declare class SinkMediaNode<Pins extends string> extends MediaNodeState implements SubscribeDestination {
     permissiveSubscriptionValidation(_context: Context): SubscriptionValidationResponse;

package/lib/src/media_nodes/common.js

@@ -114,22 +114,37 @@ class SourceMediaNode extends MediaNodeState {
     /** @internal */
     subscriptionComplete(context, subscriber) {
         return () => {
-            const pending = this.pendingContextAcks.get(context);
-            if (pending === undefined)
+            const pending = this.pendingContextAcks.get(context.blockingCallRef);
+            if (pending === undefined) {
+                // Subscription completed before even adding it!!
+                // should never happen now
+                (0, utils_1.errorlog)("No pending subscription found for ref %s on %s, something went horribly wrong", context.blockingCallRef, this.id);
                 return;
-            (0, utils_1.debuglog)("Checking context on %s:  %O", this.id, context.blockingCallRef);
-            if (pending.length == 1) {
-                (0, utils_1.debuglog)("Node '%s' acknowledging context %O", this.id, context.blockingCallRef);
-                _ackContext(this.client, this.id, context);
-                this.pendingContextAcks.delete(context);
-            }
-            else {
-                let index = pending.indexOf(subscriber); // should error if not null?
-                this.pendingContextAcks.set(context, pending.splice(index, 1));
             }
+            ;
+            let index = pending.pendingSubscribes.indexOf(subscriber);
+            pending.pendingSubscribes.splice(index, 1);
+            this.maybeAckPendingContext(context);
         };
     }
     /** @internal */
+    maybeAckPendingContext(context) {
+        const pending = this.pendingContextAcks.get(context.blockingCallRef);
+        if (!pending) {
+            (0, utils_1.errorlog)("No pending subscription found for ref %s on %s, something went horribly wrong", context.blockingCallRef, this.id);
+            return;
+        }
+        (0, utils_1.debuglog)("Checking context on %s:  %O", this.id, context.blockingCallRef);
+        if (pending.pendingSubscribes.length == 0 && pending.readyToAck) {
+            (0, utils_1.debuglog)("Node '%s' acknowledging context %O", this.id, context.blockingCallRef);
+            _ackContext(this.client, this.id, context);
+            this.pendingContextAcks.delete(context.blockingCallRef);
+        }
+        else {
+            (0, utils_1.debuglog)("Node '%s' not acknowledging context yet, pending: %d %O", this.id, pending.pendingSubscribes.length, context.blockingCallRef);
+        }
+    }
+    /** @internal */
     outboundContextChange(context) {
         return __awaiter(this, void 0, void 0, function* () {
             (0, utils_1.debuglog)("Node '%s' received new outbound context %O", this.id, debugFormatContext(context));
@@ -138,23 +153,22 @@ class SourceMediaNode extends MediaNodeState {
             if (this.onOutboundContextChange) {
                 yield this.onOutboundContextChange(this.outputStreams);
             }
-            let pending = [];
+            let pending = { pendingSubscribes: [], readyToAck: false };
+            this.pendingContextAcks.set(context.blockingCallRef, pending);
             for (let [subscriber, _] of this.subscribers) {
+                // Okay, this is async
+                // which means that while one is executing, another can complete
+                // and that just messes the whole world up beause we haven't stashed it away yet!
                 const alive = yield subscriber.sourceContextChange(this.subscriptionComplete(context, subscriber));
                 if (alive) {
-                    pending.push(subscriber);
+                    pending.pendingSubscribes.push(subscriber);
                 }
                 else {
                     (0, utils_1.debuglog)("Skipping updating subscription to closed node %s", subscriber.id);
                 }
             }
-            if (pending.length > 0) {
-                this.pendingContextAcks.set(context, pending);
-            }
-            else {
-                (0, utils_1.debuglog)("Node '%s' acknowledging context immediately %O", this.id, context.blockingCallRef);
-                _ackContext(this.client, this.id, context);
-            }
+            pending.readyToAck = true;
+            this.maybeAckPendingContext(context);
         });
     }
 }
@@ -365,6 +379,8 @@ class SinkMediaNode extends MediaNodeState {
                 return media_pb_1.ValidationResponse_ContextValidationResponse.CONTEXT_VALIDATION_DENY;
             case "accept_and_terminate":
                 return media_pb_1.ValidationResponse_ContextValidationResponse.CONTEXT_VALIDATION_ALLOW_AND_TERMINATE;
+            case "deny_and_queue":
+                return media_pb_1.ValidationResponse_ContextValidationResponse.CONTEXT_VALIDATION_DENY_AND_QUEUE;
             default:
                 (0, utils_1.exhaustiveCheck)(response);
         }

package/lib/src/media_nodes/input.d.ts

@@ -1,7 +1,7 @@
 import * as grpc from "@grpc/grpc-js";
 import { MediaClient } from "@norskvideo/norsk-api/lib/media_grpc_pb";
 import { TsInputEvent, StreamKey as StreamKeyPB, Wave, FileTsInputMessage, UdpTsInputMessage, TimestampProgramNudge, RtmpError_UnsupportedVideo, RtmpError_UnsupportedAudio } from "@norskvideo/norsk-api/lib/media_pb";
-import { BrowserEvent, ChannelLayout, RtmpServerInputStatus, RtpLinearPcmBitDepth, SampleFormat, SampleRate, SrtMode, SrtInputStatus, ImageFormat, IceServerSettings, StreamKey } from "./types";
+import { BrowserEvent, ChannelLayout, RtmpServerInputStatus, RtpLinearPcmBitDepth, SampleFormat, SampleRate, SrtMode, SrtInputStatus, ImageFormat, IceServerSettings, FrameStoreStreamSelection, FrameStoreCut } from "./types";
 import { FrameRate } from "../types";
 import { DeckLinkPixelFormat, DeckLinkVideoConnection, DeckLinkDisplayModeId } from "../types";
 import { MediaNodeState, SourceMediaNode, SourceNodeSettings, StreamStatisticsMixin } from "./common";
@@ -602,12 +602,6 @@ export declare class FileMp4InputNode extends SourceMediaNode {
     nudge(nudge: number): void;
     updateSettings(settings: FileMp4InputSettingsUpdate): void;
 }
-export declare type FrameStoreStreamSelection = "all" | StreamKey[];
-export declare type FrameStoreCut = {
-    startDateTime: Date;
-    durationMs: number;
-    sessionNum?: number;
-};
 /**
  * @public
  * Settings for Frame Store playback

package/lib/src/media_nodes/input.js

@@ -1246,13 +1246,13 @@ class FrameStorePlayerNode extends common_1.SourceMediaNode {
                 durationMs,
                 sessionNum: sessionNum ? (0, utils_1.provideFull)(common_pb_1.OptionalInt, { value: sessionNum }) : undefined
             })),
-            streamSelection: (settings.streamSelection == "all") ?
-                (0, utils_1.mkCase)({ all: (0, utils_1.provideFull)(media_pb_1.FrameStorePlayerConfiguration_All, {}) }) :
-                (0, utils_1.mkCase)({
-                    subset: (0, utils_1.provideFull)(media_pb_1.FrameStorePlayerConfiguration_Subset, {
-                        streamList: settings.streamSelection.map(types_1.mkStreamKey)
-                    })
-                }),
+            streamSelection: (0, utils_1.provideFull)(media_pb_1.StreamSelection, { streamSelection: (settings.streamSelection == "all") ?
+                    (0, utils_1.mkCase)({ all: (0, utils_1.provideFull)(media_pb_1.StreamSelection_All, {}) }) :
+                    (0, utils_1.mkCase)({
+                        subset: (0, utils_1.provideFull)(media_pb_1.StreamSelection_Subset, {
+                            streamList: settings.streamSelection.map(types_1.mkStreamKey)
+                        })
+                    }) }),
             trimPartialSegments: settings.trimPartialSegments
         });
         this.grpcStream = client.createInputFrameStorePlayer();

package/lib/src/media_nodes/output.d.ts

@@ -1,7 +1,7 @@
 import * as grpc from "@grpc/grpc-js";
 import { MediaClient } from "@norskvideo/norsk-api/lib/media_grpc_pb";
 import { CmafAudioMessage, CmafMultiVariantMessage, CmafVideoMessage, CmafWebVttMessage, HlsOutputEvent, HlsTsAudioMessage, HlsTsCombinedPushMessage, HlsTsVideoMessage, Subscription, HlsTsMultiVariantMessage } from "@norskvideo/norsk-api/lib/media_pb";
-import { AwsCredentials, EncryptionSettings, IceServerSettings, SrtMode, StreamMetadata, Scte35SpliceInfoSection } from "./types";
+import { AwsCredentials, EncryptionSettings, IceServerSettings, SrtMode, StreamMetadata, Scte35SpliceInfoSection, FrameStoreStreamSelection, FrameStoreCut } from "./types";
 import { AutoProcessorMediaNode, ProcessorNodeSettings } from "./processor";
 import { AutoSinkMediaNode, MediaNodeState, SinkNodeSettings, StreamStatisticsMixin } from "./common";
 /**
@@ -616,6 +616,8 @@ export interface UdpTsOutputSettings extends SinkNodeSettings<UdpTsOutputNode>,
     port: number;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: number;
     /** Whether to encapsulate in RTP via RFC 2250 (default: false) */
     rtpEncapsulate?: boolean;
 }
@@ -653,6 +655,8 @@ export interface SrtOutputSettings extends SinkNodeSettings<SrtOutputNode>, Stre
     port: number;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: 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
@@ -731,6 +735,8 @@ export interface RtmpOutputSettings extends SinkNodeSettings<RtmpOutputNode>, St
     url: string;
     /** Jitter buffer delay in milliseconds */
     bufferDelayMs?: number;
+    /** A/V delay in milliseconds (to allow embedded captions to be added) */
+    avDelayMs?: number;
     /** Called when the RTMP output succesfully connects to a server and starts publishing data */
     onPublishStart?: () => void;
     /** Called when the connection to the RTMP server fails */
@@ -758,6 +764,8 @@ export declare class RtmpOutputNode extends AutoSinkMediaNode<"audio" | "video">
 export interface FileTsOutputSettings extends SinkNodeSettings<FileTsOutputNode>, StreamStatisticsMixin {
     /** The file to write - this will be truncated if it already exist */
     fileName: string;
+    /** A/V delay in milliseconds - to allow inclusion of subtitles, metadata and other ancillary data. May be set to 0 if these are not present to reduce latency */
+    avDelayMs?: number;
 }
 /**
  * @public
@@ -806,6 +814,29 @@ export declare class FileMp4OutputNode extends AutoSinkMediaNode<"audio" | "vide
      */
     writeFile(nonfragmentedFileName: string): void;
 }
+/** @public */
+export declare type FrameStoreExpireByTime = {
+    expire: "byTime";
+    durationS: number;
+};
+/** @public */
+export declare type FrameStoreExpireBySize = {
+    expire: "bySize";
+    size: number;
+};
+/** @public */
+export declare type FrameStoreExpiry = FrameStoreExpireBySize | FrameStoreExpireByTime;
+/** @public */
+export declare type FrameStoreCutRequest = {
+    fileFormat: "mp4";
+    id: string;
+    streamSelection: FrameStoreStreamSelection;
+    cuts: FrameStoreCut[];
+    trimPartialSegments: boolean;
+    fileName: string;
+    progressCb: (progress: number) => void;
+    completeCb: (size: bigint) => void;
+};
 /**
  * @public
  * Settings to configure a frame store recorder
@@ -824,12 +855,17 @@ export interface FrameStoreRecorderSettings extends SinkNodeSettings<FrameStoreR
      * Required: Duration of the frame store chunk files
      */
     chunkFileDurationSeconds: number;
+    /**
+     * Optional: Expiry settings - if not supplied, then data will *not* get expired so on long-running events you may exhaust available disk space
+     */
+    expiry?: FrameStoreExpiry;
 }
 /**
  * @public
  * see: {@link NorskOutput.frameStoreRecording}
  */
 export declare class FrameStoreRecorderNode extends AutoSinkMediaNode<"audio" | "video"> {
+    makeCut(request: FrameStoreCutRequest): void;
 }
 /**
  * @public