@norskvideo/norsk-sdk 1.0.391 → 1.0.392

package/dist/norsk-sdk.d.ts

@@ -8,6 +8,7 @@ import { CmafAudioMessage } from '@norskvideo/norsk-api/lib/media_pb';
 import { CmafMultiVariantMessage } from '@norskvideo/norsk-api/lib/media_pb';
 import { CmafVideoMessage } from '@norskvideo/norsk-api/lib/media_pb';
 import { CmafWebVttMessage } from '@norskvideo/norsk-api/lib/media_pb';
+import { Context as Context_2 } from '@norskvideo/norsk-api/lib/media_pb';
 import { CurrentLoad } from '@norskvideo/norsk-api/lib/shared/common_pb';
 import EventEmitter from 'events';
 import { ExplicitChannel } from '@norskvideo/norsk-api/lib/media_pb';
@@ -38,7 +39,6 @@ import { TsInputEvent } from '@norskvideo/norsk-api/lib/media_pb';
 import { UdpTsInputMessage } from '@norskvideo/norsk-api/lib/media_pb';
 import { Version } from '@norskvideo/norsk-api/lib/shared/common_pb';
 import { VideoTransformConfiguration } from '@norskvideo/norsk-api/lib/media_pb';
-import { Wave } from '@norskvideo/norsk-api/lib/media_pb';
 import { Writable } from 'stream';
 
 /** @public */
@@ -572,6 +572,8 @@ export declare type AudioSegmentationStrategy = SegmentationStrategyExactFrameCo
  * see: {@link NorskInput.audioSignal}
  */
 export declare class AudioSignalGeneratorNode extends SourceMediaNode {
+    /** @public */
+    updateConfig(update: AudioSignalGeneratorSettingsUpdate): void;
 }
 
 /**
@@ -595,8 +597,17 @@ export declare interface AudioSignalGeneratorSettings extends SourceNodeSettings
     /** Number of frames to output.  Defaults to infinite */
     numFrames?: number;
     /**
-     * Waveform - create one with {@link mkSine}
-     * */
+     * Waveform - construct a {@link Wave} directoy, or from DMTF digits via {@link mkDtmf}
+     *
+     * If unspecified an arbitrary default signal is generated
+     */
+    wave?: Wave;
+}
+
+export declare interface AudioSignalGeneratorSettingsUpdate {
+    /**
+     * Updated waveform. If unspecified the originally configured waveform is retained
+     */
     wave?: Wave;
 }
 
@@ -2821,6 +2832,14 @@ export declare interface MetadataSendMessage extends MetadataMessage {
 /** @public */
 export declare type MetadataType = 'klv' | 'id3' | 'other';
 
+/**
+ *  @public
+ *
+ * Construct a waveform representing a string of DTMF digits. This is of finite duration, you may wish to sequence silence afterwards
+ *
+ **/
+export declare function mkDtmf(digits: string): Wave;
+
 /**
  * @public
  * Generate encryption parameters from from an encryption KeyID and Key,
@@ -2828,7 +2847,11 @@ export declare type MetadataType = 'klv' | 'id3' | 'other';
  */
 export declare function mkEncryption(encryption: string | undefined, pssh?: string | undefined): EncryptionSettings | undefined;
 
-/** @public */
+/**
+ * @public
+ *
+ * Provided for compatibilty, this is just e.g. `{ type: "sine", freq: 444 }`
+ */
 export declare function mkSine(freq: number): Wave;
 
 /**
@@ -4045,6 +4068,24 @@ export declare type QuadraHevcProfile = "main" | "main10";
 /** @public */
 export declare type QuadraHevcTier = "main" | "high";
 
+/**
+ * @public
+ * Settings for influencing the encode pipeline built for a quadra rung within a ladder
+ */
+export declare type QuadraPipelineHints = {
+    type: 'quadra';
+    rescaler?: QuadraRescalerAlgorithm;
+};
+
+/**
+ * @public
+ * The algorithm used for rescales in quadra pipeline, in ffmpeg parlance this is
+ * 0 = default
+ * 1 = filterblit
+ * 2 = bicubic
+ */
+export declare type QuadraRescalerAlgorithm = "default" | "filterblit" | "bicubic";
+
 /** @public */
 export declare type ReceiveFromAddress<Pins extends string> = {
     source: SourceMediaNode;
@@ -4780,6 +4821,8 @@ export declare class SourceMediaNode<Events extends SourceMediaNodeEvents = Sour
     outputStreams: StreamMetadata[];
     registerForContextChange(subscriber: SubscribeDestination): void;
     unregisterForContextChange(subscriber: SubscribeDestination): void;
+    /** @private */
+    _outboundContextChange(context: Context_2): Promise<void>;
 }
 
 export declare type SourceMediaNodeEvents = {
@@ -5397,7 +5440,7 @@ export declare class StreamTimestampReportNode extends AutoSinkMediaNode<string>
  * see {@link NorskOutput.fileMp4}
  */
 export declare interface StreamTimestampReportSettings extends SinkNodeSettings<StreamTimestampReportNode> {
-    onTimestamp?: (streamKey: StreamKey, timestamp: Interval) => Promise<void>;
+    onTimestamp?: (streamKey: StreamKey, timestamp: Interval) => void;
 }
 
 /**
@@ -5822,6 +5865,10 @@ export declare interface VideoEncodeRung {
      * VideoEncode node will attempt to build a pipeline that uses the hardware efficently
      */
     codec: X264Codec | X265Codec | NvidiaH264 | NvidiaHevc | LoganH264 | LoganHevc | QuadraH264 | QuadraHevc | QuadraAv1 | AmdU30H264 | AmdU30Hevc | AmdMA35DH264 | AmdMA35DHevc | AmdMA35DAv1;
+    /**
+     * Extra options for influencing how the ladder gets constructed and what algorithms get used for certain operations
+     */
+    pipelineHints?: QuadraPipelineHints;
 }
 
 /**
@@ -5930,6 +5977,37 @@ export declare interface VideoTransformSettings extends ProcessorNodeSettings<Vi
     sar?: SampleAspectRatio;
 }
 
+/**
+ *  @public
+ *
+ * Describes a waveform for use by audio signal generator. Constructed from simple sine waves, silence and sequences, loops, combinations
+ * of those. May be finite or infinite in duration, it may often make sense to follow a timed signal with silence.
+ *
+ * See {@link mkDtmf} to construct DTMF tones.
+ */
+export declare type Wave = {
+    type: "sine";
+    /** The wave frequency */
+    freq: number;
+    /** Level of the wave. 0 (the default) representing a full-scale sine wave, value must be negative or 0. */
+    db?: number;
+} | {
+    type: "silence";
+} | {
+    type: "compound";
+    components: Wave[];
+} | {
+    type: "sequence";
+    components: Wave[];
+} | {
+    type: "loop";
+    component: Wave;
+} | {
+    type: "timed";
+    component: Wave;
+    durationMs: number;
+};
+
 /**
  * @public
  * see: {@link NorskDuplex.webRtcBrowser}

package/lib/package.json

@@ -1,11 +1,11 @@
 {
     "license": "MIT",
     "name": "@norskvideo/norsk-sdk",
-    "version": "1.0.391",
+    "version": "1.0.392",
     "dependencies": {
         "@bufbuild/protobuf": "^0.3.0",
         "@grpc/grpc-js": "^1.2.2",
-        "@norskvideo/norsk-api": "1.0.391",
+        "@norskvideo/norsk-api": "1.0.392",
         "lodash": "^4.17.21",
         "typescript-nullable": "^0.6.0"
     },

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

@@ -7,7 +7,7 @@ export type MediaClient = {
     media: MediaClientPB;
     subscriptions: grpc.ClientDuplexStream<SubscriptionChannelMessage, SubscriptionChannelResponse>;
 };
-import { StreamStatisticsSampling, GopStructure, SubscriptionChannelMessage, SubscriptionChannelResponse } from "@norskvideo/norsk-api/lib/media_pb";
+import { Context as ContextPB, StreamStatisticsSampling, GopStructure, SubscriptionChannelMessage, SubscriptionChannelResponse } from "@norskvideo/norsk-api/lib/media_pb";
 import { Nullable } from "typescript-nullable";
 import { StreamKey, MediaNodeId, StreamMetadata, Context, MultiStreamStatistics, SubscriptionError } from "./types";
 export * from "../shared/utils";
@@ -110,6 +110,8 @@ export declare class SourceMediaNode<Events extends SourceMediaNodeEvents = Sour
     outputStreams: StreamMetadata[];
     registerForContextChange(subscriber: SubscribeDestination): void;
     unregisterForContextChange(subscriber: SubscribeDestination): void;
+    /** @private */
+    _outboundContextChange(context: ContextPB): Promise<void>;
 }
 /**
  * @public

package/lib/src/media_nodes/common.js

@@ -141,7 +141,8 @@ class SourceMediaNode extends MediaNodeState {
         (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.subscriptions, this.id, context);
+            // Really should be awaiting this? How far up the callstack does this go???
+            void _ackContext(this.client.subscriptions, this.id, context);
             this.pendingContextAcks.delete(context.blockingCallRef);
         }
         else {
@@ -149,7 +150,11 @@ class SourceMediaNode extends MediaNodeState {
         }
     }
     /** @internal */
-    async outboundContextChange(context) {
+    outboundContextChange(context) {
+        void this._outboundContextChange(context);
+    }
+    /** @private */
+    async _outboundContextChange(context) {
         (0, utils_1.debuglog)("Node '%s' received new outbound context %O", this.id, debugFormatContext(context));
         this.outputStreams = context.streams.map(types_1.fromStreamMetadata);
         // The client can do something before we notify subscribers then unblock - e.g. maybe spinning up a new node and subscribing it
@@ -283,7 +288,7 @@ class SinkMediaNode extends MediaNodeState {
         else {
             this.subscriptionValidation = this.defaultSubscriptionValidation;
         }
-        this.sourceContextChange(done || (() => { }));
+        void this.sourceContextChange(done || (() => { }));
     }
     async sourceContextChange(responseCallback) {
         const stream = this.getGrpcStream();
@@ -326,11 +331,11 @@ class SinkMediaNode extends MediaNodeState {
         return subscribed;
     }
     /** @internal */
-    async subscriptionResponse(response) {
-        await this.finaliseSubscription(response.id, response.error);
+    subscriptionResponse(response) {
+        void this.finaliseSubscription(response.id, response.error);
     }
     /** @internal */
-    async finaliseSubscription(id, err) {
+    finaliseSubscription(id, err) {
         const callback = this.subscriptionResponseCallbacks.get(id);
         this.subscriptionResponseCallbacks.delete(id);
         if (callback) {
@@ -354,7 +359,7 @@ class SinkMediaNode extends MediaNodeState {
         }
     }
     /** @internal */
-    async handleInboundContext(context) {
+    handleInboundContext(context) {
         const validationResponse = this.subscriptionValidation((0, types_1.fromContext)(context));
         this.client.subscriptions.write((0, utils_1.provideFull)(media_pb_1.SubscriptionChannelMessage, (0, utils_1.mkMessageCase)({
             validationResponse: new media_pb_1.ValidationResponse({
@@ -362,7 +367,7 @@ class SinkMediaNode extends MediaNodeState {
                 result: this.toValidationResponse(validationResponse),
             })
         })));
-        _ackContext(this.client.subscriptions, this.id, context);
+        void _ackContext(this.client.subscriptions, this.id, context);
     }
     /** @internal */
     toValidationResponse(response) {
@@ -462,10 +467,10 @@ function registerStreamHandlers(grpcStream, unregisterNode, tag, reject, setting
         settings.onError && settings.onError(error);
         rejectReason = error;
     });
-    grpcStream.on("close", async () => {
+    grpcStream.on("close", () => {
         (0, utils_1.debuglog)(`${tag} node close`);
-        settings.onClose && await settings.onClose();
         unregisterNode();
+        settings.onClose && void settings.onClose();
         reject(rejectReason);
     });
 }

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

@@ -6,7 +6,7 @@ import { Interval, StreamKey } from "./types";
  * see {@link NorskOutput.fileMp4}
  */
 export interface StreamTimestampReportSettings extends SinkNodeSettings<StreamTimestampReportNode> {
-    onTimestamp?: (streamKey: StreamKey, timestamp: Interval) => Promise<void>;
+    onTimestamp?: (streamKey: StreamKey, timestamp: Interval) => void;
 }
 /**
  * @public

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

@@ -1,6 +1,6 @@
 import * as grpc from "@grpc/grpc-js";
-import { TsInputEvent, StreamKey as StreamKeyPB, Wave, FileTsInputMessage, UdpTsInputMessage, M3u8MediaInputMessage, TimestampProgramNudge, RtmpError_UnsupportedVideo, RtmpError_UnsupportedAudio } from "@norskvideo/norsk-api/lib/media_pb";
-import { BrowserEvent, ChannelLayout, RtmpServerInputStatus, RtpLinearPcmBitDepth, SampleFormat, SampleRate, SrtMode, SrtInputStatus, ImageFormat, IceServerSettings, PixelFormat } from "./types";
+import { TsInputEvent, StreamKey as StreamKeyPB, FileTsInputMessage, UdpTsInputMessage, M3u8MediaInputMessage, TimestampProgramNudge, RtmpError_UnsupportedVideo, RtmpError_UnsupportedAudio } from "@norskvideo/norsk-api/lib/media_pb";
+import { BrowserEvent, ChannelLayout, RtmpServerInputStatus, RtpLinearPcmBitDepth, SampleFormat, SampleRate, SrtMode, SrtInputStatus, ImageFormat, IceServerSettings, PixelFormat, Wave } from "./types";
 import { FrameRate } from "../types";
 import { DeckLinkPixelFormat, DeckLinkVideoConnection, DeckLinkDisplayModeId } from "../types";
 import { MediaNodeState, MediaClient, SourceMediaNode, SourceNodeSettings, StreamStatisticsMixin } from "./common";
@@ -641,8 +641,16 @@ export interface AudioSignalGeneratorSettings extends SourceNodeSettings<AudioSi
     /** Number of frames to output.  Defaults to infinite */
     numFrames?: number;
     /**
-     * Waveform - create one with {@link mkSine}
-     * */
+     * Waveform - construct a {@link Wave} directoy, or from DMTF digits via {@link mkDtmf}
+     *
+     * If unspecified an arbitrary default signal is generated
+     */
+    wave?: Wave;
+}
+export interface AudioSignalGeneratorSettingsUpdate {
+    /**
+     * Updated waveform. If unspecified the originally configured waveform is retained
+    */
     wave?: Wave;
 }
 /**
@@ -650,6 +658,8 @@ export interface AudioSignalGeneratorSettings extends SourceNodeSettings<AudioSi
  * see: {@link NorskInput.audioSignal}
  */
 export declare class AudioSignalGeneratorNode extends SourceMediaNode {
+    /** @public */
+    updateConfig(update: AudioSignalGeneratorSettingsUpdate): void;
 }
 /**
  * @public

package/lib/src/media_nodes/input.js

@@ -1136,9 +1136,11 @@ class AudioSignalGeneratorNode extends common_1.SourceMediaNode {
             channelLayout: (0, types_1.toChannelLayout)(settings.channelLayout),
             language: (0, types_1.toOptString)(settings.language),
             samplesPerFrame: (0, types_1.toOptInt)(settings.numSamplesPerFrame),
-            outputFrameCount: (0, types_1.toOptInt)(settings.numFrames)
+            outputFrameCount: (0, types_1.toOptInt)(settings.numFrames),
+            wave: settings.wave !== undefined ? (0, types_1.toWave)(settings.wave) : undefined
         });
-        this.grpcStream = this.client.media.createInputAudioSignalGenerator(config);
+        this.grpcStream = this.client.media.createInputAudioSignalGenerator();
+        this.grpcStream.write((0, utils_1.provideFull)(media_pb_1.AudioSignalGeneratorMessage, (0, utils_1.mkMessageCase)({ initialConfig: config })));
         this.initialised = new Promise((resolve, reject) => {
             this.grpcStream.on("data", (data) => {
                 const messageCase = data.message.case;
@@ -1163,6 +1165,13 @@ class AudioSignalGeneratorNode extends common_1.SourceMediaNode {
             (0, common_1.registerStreamHandlers)(this.grpcStream, () => unregisterNode(this), "audiosignal", reject, settings);
         });
     }
+    /** @public */
+    updateConfig(update) {
+        const config = (0, utils_1.provideFull)(media_pb_1.AudioSignalGeneratorConfigurationUpdate, {
+            wave: update.wave !== undefined ? (0, types_1.toWave)(update.wave) : undefined
+        });
+        this.grpcStream.write((0, utils_1.provideFull)(media_pb_1.AudioSignalGeneratorMessage, (0, utils_1.mkMessageCase)({ updateConfig: config })));
+    }
 }
 exports.AudioSignalGeneratorNode = AudioSignalGeneratorNode;
 function toPattern(p) {

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

@@ -3,7 +3,7 @@ import { PlainMessage } from "@bufbuild/protobuf";
 import { StreamStatisticsSampling, Subscription, SipEvent_Status, AudioWatermarkLicenseInformation, AudioWatermarkSnapEvent } from "@norskvideo/norsk-api/lib/media_pb";
 import { FrameRate, VancPayloadFormat, VancType2AncillaryId } from "../types";
 import { AutoSinkMediaNode, MediaClient, MediaNodeState, SinkNodeSettings, SourceMediaNode, SourceMediaNodeEvents, SourceNodeSettings, StreamStatisticsMixin } from "./common";
-import { AacProfile, AudioMeasureLevels, AwsCredentials, ChannelLayout, ComposeMissingStreamBehaviour, ComposeHardwareAcceleration, Db, IceServerSettings, LoganH264, LoganHevc, MultiStreamStatistics, NvidiaH264, NvidiaHevc, PixelFormat, QuadraH264, QuadraHevc, AmdU30H264, AmdU30Hevc, AmdMA35DH264, AmdMA35DHevc, Resolution, SampleAspectRatio, SampleRate, SentenceBuildMode, SimpleEasing, StabilizationMode, StreamKey, StreamMetadata, X264Codec, X265Codec, SubscriptionError, DeinterlaceSettings, Scte35SpliceInfoSection, Interval, SampleFormat, VideoStreamMetadata, QuadraAv1, AmdMA35DAv1 } from "./types";
+import { AacProfile, AudioMeasureLevels, AwsCredentials, ChannelLayout, ComposeMissingStreamBehaviour, ComposeHardwareAcceleration, Db, IceServerSettings, LoganH264, LoganHevc, MultiStreamStatistics, NvidiaH264, NvidiaHevc, PixelFormat, QuadraH264, QuadraHevc, AmdU30H264, AmdU30Hevc, AmdMA35DH264, AmdMA35DHevc, Resolution, SampleAspectRatio, SampleRate, SentenceBuildMode, SimpleEasing, StabilizationMode, StreamKey, StreamMetadata, X264Codec, X265Codec, SubscriptionError, DeinterlaceSettings, Scte35SpliceInfoSection, Interval, SampleFormat, VideoStreamMetadata, QuadraAv1, AmdMA35DAv1, QuadraPipelineHints } from "./types";
 import { Writable, Readable } from 'stream';
 /** @public */
 export interface ProcessorMediaNode<Pins extends string> extends SourceMediaNode<SourceMediaNodeEvents>, AutoSinkMediaNode<Pins, SourceMediaNodeEvents> {
@@ -1069,6 +1069,10 @@ export interface VideoEncodeRung {
      * VideoEncode node will attempt to build a pipeline that uses the hardware efficently
      */
     codec: X264Codec | X265Codec | NvidiaH264 | NvidiaHevc | LoganH264 | LoganHevc | QuadraH264 | QuadraHevc | QuadraAv1 | AmdU30H264 | AmdU30Hevc | AmdMA35DH264 | AmdMA35DHevc | AmdMA35DAv1;
+    /**
+    * Extra options for influencing how the ladder gets constructed and what algorithms get used for certain operations
+    */
+    pipelineHints?: QuadraPipelineHints;
 }
 /**
  * @public

package/lib/src/media_nodes/processor.js

@@ -186,7 +186,7 @@ class StreamSwitchSmoothNode extends ProcessorMediaNode {
                             }
                         }
                         const onChange = settings.onInboundContextChange ? settings.onInboundContextChange(ctxMap) : Promise.resolve();
-                        onChange.then(() => {
+                        void onChange.then(() => {
                             client.subscriptions.write((0, utils_1.provideFull)(media_pb_1.SubscriptionChannelMessage, (0, utils_1.mkMessageCase)({
                                 unblock: (0, utils_1.provideFull)(media_pb_1.BlockingCallRef, {
                                     mediaNodeId: (0, types_2.toMediaNodeId)(this.id),
@@ -2253,6 +2253,7 @@ class VideoEncodeNode extends AutoProcessorMediaNode {
                     ? (0, utils_1.provideFull)(media_pb_1.SampleAspectRatio, stream.sar)
                     : undefined,
                 codec,
+                hints: stream.pipelineHints ? { case: 'quadra', value: new media_pb_1.QuadraEncodeHints((0, types_2.toEncodeHint)(stream.pipelineHints)) } : { case: undefined }
             });
             return x;
         });

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

@@ -567,6 +567,22 @@ export type QuadraAv1Level = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6
 export type QuadraH264Level = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
 /** @public */
 export type QuadraHevcLevel = 1 | 2 | 2.1 | 3 | 3.1 | 4 | 4.1 | 5 | 5.1 | 5.2 | 6 | 6.1 | 6.2;
+/**
+* @public
+* The algorithm used for rescales in quadra pipeline, in ffmpeg parlance this is
+* 0 = default
+* 1 = filterblit
+* 2 = bicubic
+*/
+export type QuadraRescalerAlgorithm = "default" | "filterblit" | "bicubic";
+/**
+* @public
+* Settings for influencing the encode pipeline built for a quadra rung within a ladder
+*/
+export type QuadraPipelineHints = {
+    type: 'quadra';
+    rescaler?: QuadraRescalerAlgorithm;
+};
 /**
  * @public
  * Settings for a H264 Encode using Netint Quadra hardware
@@ -1441,4 +1457,41 @@ export type SegmentationStrategyExactIdrCount = {
     type: 'exact_idr_count';
     count: number;
 };
+/**
+ *  @public
+ *
+ * Describes a waveform for use by audio signal generator. Constructed from simple sine waves, silence and sequences, loops, combinations
+ * of those. May be finite or infinite in duration, it may often make sense to follow a timed signal with silence.
+ *
+ * See {@link mkDtmf} to construct DTMF tones.
+ */
+export type Wave = {
+    type: "sine";
+    /** The wave frequency */
+    freq: number;
+    /** Level of the wave. 0 (the default) representing a full-scale sine wave, value must be negative or 0. */
+    db?: number;
+} | {
+    type: "silence";
+} | {
+    type: "compound";
+    components: Wave[];
+} | {
+    type: "sequence";
+    components: Wave[];
+} | {
+    type: "loop";
+    component: Wave;
+} | {
+    type: "timed";
+    component: Wave;
+    durationMs: number;
+};
+/**
+ *  @public
+ *
+ * Construct a waveform representing a string of DTMF digits. This is of finite duration, you may wish to sequence silence afterwards
+ *
+ **/
+export declare function mkDtmf(digits: string): Wave;
 //# sourceMappingURL=types.d.ts.map

package/lib/src/media_nodes/types.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toTrinary = exports.toAmdMA35DEncodeCommon = exports.toAmdMA35DH264Profile = exports.toAmdMA35DHevcProfile = exports.toAmdMA35DHevcTier = exports.toAmdMA35DAv1Profile = exports.toAmdMA35DAv1Tier = exports.toAmdU30Hevc = exports.toAmdU30H264 = exports.toAmdU30H264Profile = exports.toAmdU30HevcProfile = exports.toAmdU30HevcTier = exports.toQuadraAv1 = exports.toQuadraHevc = exports.toQuadraH264 = exports.toQuadraH264Profile = exports.toQuadraAv1Profile = exports.toQuadraHevcProfile = exports.toQuadraAv1Tier = exports.toQuadraHevcTier = exports.toLoganHevc = exports.toLoganH264 = exports.toLoganH264Profile = exports.toLoganHevcProfile = exports.toLoganHevcTier = exports.toNvidiaH264 = exports.toNvidiaHevc = exports.toNvidiaH264Profile = exports.toNvidiaHevcProfile = exports.toNvidiaHevcTier = exports.toNvidiaPreset = exports.toCabrMode = exports.toNvidiaRateControl = exports.toNvidiaRateControlMode = exports.toX265Codec = exports.toX265Tune = exports.toX264Codec = exports.toDeinterlaceSettings = exports.fromContext = exports.fromStreamMetadata = exports.metadataForStreamKey = exports.fromStreamKey = exports.mkStreamKey = exports.toMediaNodeId = exports.toOptString = exports.mkOptString = exports.toOptBool = exports.mkOptBool = exports.toOptInt = exports.mkOptInt = void 0;
-exports.toSegmentationStrategy = exports.fromScte35PB = exports.toScte35PB = exports.mkWebrtcServerSettings = exports.mkEncryptionSettings = exports.fromSourceSubscriptionError = exports.fromSubscriptionError = exports.fromStreamStatistics = exports.fromAudioMeasureLevels = exports.mkDb = exports.toInterval = exports.fromInterval = exports.addInterval = exports.fromChannelName = exports.toChannelName = exports.getAmountOfChannels = exports.fromChannelLayout = exports.toChannelLayout = exports.fromSampleRate = exports.toSampleRate = exports.toApiMetrics = exports.fromSampleFormat = exports.toSampleFormat = exports.toSsHardwareAcceleration = exports.toComposeHardwareAcceleration = exports.toComposeMissingStreamBehaviour = exports.toPixelFormat = exports.toSimpleEasing = exports.toAacProfile = exports.toImageFormat = exports.toStabilizationMode = exports.toSentenceBuildMode = exports.fromBrowserEvent = exports.toSrtMode = exports.fromSrtInputState = exports.fromRtmpServerInputState = exports.toBitDepth = exports.toAmdMA35DAv1 = exports.toAmdMA35DHevc = exports.toAmdMA35DH264 = void 0;
+exports.toAmdMA35DEncodeCommon = exports.toAmdMA35DH264Profile = exports.toAmdMA35DHevcProfile = exports.toAmdMA35DHevcTier = exports.toAmdMA35DAv1Profile = exports.toAmdMA35DAv1Tier = exports.toAmdU30Hevc = exports.toAmdU30H264 = exports.toAmdU30H264Profile = exports.toAmdU30HevcProfile = exports.toAmdU30HevcTier = exports.toQuadraAv1 = exports.toQuadraHevc = exports.toQuadraH264 = exports.toEncodeHint = exports.toQuadraH264Profile = exports.toQuadraAv1Profile = exports.toQuadraHevcProfile = exports.toQuadraAv1Tier = exports.toQuadraHevcTier = exports.toLoganHevc = exports.toLoganH264 = exports.toLoganH264Profile = exports.toLoganHevcProfile = exports.toLoganHevcTier = exports.toNvidiaH264 = exports.toNvidiaHevc = exports.toNvidiaH264Profile = exports.toNvidiaHevcProfile = exports.toNvidiaHevcTier = exports.toNvidiaPreset = exports.toCabrMode = exports.toNvidiaRateControl = exports.toNvidiaRateControlMode = exports.toX265Codec = exports.toX265Tune = exports.toX264Codec = exports.toDeinterlaceSettings = exports.fromContext = exports.fromStreamMetadata = exports.metadataForStreamKey = exports.fromStreamKey = exports.mkStreamKey = exports.toMediaNodeId = exports.toOptString = exports.mkOptString = exports.toOptBool = exports.mkOptBool = exports.toOptInt = exports.mkOptInt = void 0;
+exports.mkDtmf = exports.toWave = exports.toSegmentationStrategy = exports.fromScte35PB = exports.toScte35PB = exports.mkWebrtcServerSettings = exports.mkEncryptionSettings = exports.fromSourceSubscriptionError = exports.fromSubscriptionError = exports.fromStreamStatistics = exports.fromAudioMeasureLevels = exports.mkDb = exports.toInterval = exports.fromInterval = exports.addInterval = exports.fromChannelName = exports.toChannelName = exports.getAmountOfChannels = exports.fromChannelLayout = exports.toChannelLayout = exports.fromSampleRate = exports.toSampleRate = exports.toApiMetrics = exports.fromSampleFormat = exports.toSampleFormat = exports.toSsHardwareAcceleration = exports.toComposeHardwareAcceleration = exports.toComposeMissingStreamBehaviour = exports.toPixelFormat = exports.toSimpleEasing = exports.toAacProfile = exports.toImageFormat = exports.toStabilizationMode = exports.toSentenceBuildMode = exports.fromBrowserEvent = exports.toSrtMode = exports.fromSrtInputState = exports.fromRtmpServerInputState = exports.toBitDepth = exports.toAmdMA35DAv1 = exports.toAmdMA35DHevc = exports.toAmdMA35DH264 = exports.toTrinary = void 0;
 const media_pb_1 = require("@norskvideo/norsk-api/lib/media_pb");
 const common_pb_1 = require("@norskvideo/norsk-api/lib/shared/common_pb");
 const utils_1 = require("../shared/utils");
@@ -820,6 +820,28 @@ function toQuadraH264Profile(profile) {
 }
 exports.toQuadraH264Profile = toQuadraH264Profile;
 /** @internal */
+function toEncodeHint(hint) {
+    const options = {
+        rescale: media_pb_1.QuadraEncodeHints_QuadraRescaleAlgorithm.QUADRA_RESCALE_DEFAULT
+    };
+    const rescale = hint.rescaler;
+    switch (rescale) {
+        case undefined:
+        case 'default':
+            break;
+        case 'filterblit':
+            options.rescale = media_pb_1.QuadraEncodeHints_QuadraRescaleAlgorithm.QUADRA_RESCALE_FILTERBLIT;
+            break;
+        case 'bicubic':
+            options.rescale = media_pb_1.QuadraEncodeHints_QuadraRescaleAlgorithm.QUADRA_RESCALE_BICUBIC;
+            break;
+        default:
+            (0, utils_1.exhaustiveCheck)(rescale);
+    }
+    return options;
+}
+exports.toEncodeHint = toEncodeHint;
+/** @internal */
 function toQuadraH264(codec) {
     const codecOptions = {
         extraOpts: "",
@@ -2560,4 +2582,109 @@ function toSegmentationStrategy(strategy) {
     }
 }
 exports.toSegmentationStrategy = toSegmentationStrategy;
+/** @internal */
+function toWave(wave) {
+    switch (wave.type) {
+        case "sine":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ sine: (0, utils_1.provideFull)(media_pb_1.SineWave, { freq: wave.freq, db: wave.db || 0 }) }));
+        case "silence":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ silence: (0, utils_1.provideFull)(media_pb_1.Silence, {}) }));
+        case "compound":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ compound: (0, utils_1.provideFull)(media_pb_1.Compound, { components: wave.components.map(toWave) }) }));
+        case "sequence":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ sequence: (0, utils_1.provideFull)(media_pb_1.Sequence, { components: wave.components.map(toWave) }) }));
+        case "loop":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ loop: (0, utils_1.provideFull)(media_pb_1.Loop, { component: toWave(wave.component) }) }));
+        case "timed":
+            return (0, utils_1.provideFull)(media_pb_1.Wave, (0, utils_1.mkMessageCase)({ timed: (0, utils_1.provideFull)(media_pb_1.Timed, { component: toWave(wave.component), durationMs: wave.durationMs }) }));
+    }
+}
+exports.toWave = toWave;
+/**
+ *  @public
+ *
+ * Construct a waveform representing a string of DTMF digits. This is of finite duration, you may wish to sequence silence afterwards
+ *
+ **/
+function mkDtmf(digits) {
+    if (!digits) {
+        digits = "";
+    }
+    return {
+        type: "sequence",
+        components: digits.split("").flatMap(mkDtmfDigit)
+    };
+}
+exports.mkDtmf = mkDtmf;
+function mkDtmfDigit(digit) {
+    if (!digit || digit.length !== 1) {
+        throw new Error("Expected single digit");
+    }
+    let pair;
+    switch (digit.toUpperCase()) {
+        case "1":
+            pair = [697.0, 1209.0];
+            break;
+        case "2":
+            pair = [697.0, 1336.0];
+            break;
+        case "3":
+            pair = [697.0, 1477.0];
+            break;
+        case "A":
+            pair = [697.0, 1633.0];
+            break;
+        case "4":
+            pair = [770.0, 1209.0];
+            break;
+        case "5":
+            pair = [770.0, 1336.0];
+            break;
+        case "6":
+            pair = [770.0, 1477.0];
+            break;
+        case "B":
+            pair = [770.0, 1633.0];
+            break;
+        case "7":
+            pair = [852.0, 1209.0];
+            break;
+        case "8":
+            pair = [852.0, 1336.0];
+            break;
+        case "9":
+            pair = [852.0, 1477.0];
+            break;
+        case "C":
+            pair = [852.0, 1633.0];
+            break;
+        case "*":
+            pair = [941.0, 1209.0];
+            break;
+        case "0":
+            pair = [941.0, 1336.0];
+            break;
+        case "#":
+            pair = [941.0, 1477.0];
+            break;
+        case "D":
+            pair = [941.0, 1633.0];
+            break;
+        default:
+            throw new Error("Unexpected digit: " + digit);
+    }
+    return [
+        {
+            type: "timed",
+            durationMs: 250,
+            component: {
+                type: "compound", components: [
+                    { type: "sine", freq: pair[0], db: -5.0 },
+                    { type: "sine", freq: pair[1], db: -5.0 }
+                ]
+            }
+        },
+        { type: "timed", component: { type: "silence" }, durationMs: 250 }
+    ];
+}
 //# sourceMappingURL=types.js.map

package/lib/src/sdk.d.ts

@@ -1,10 +1,10 @@
 import { Version, CurrentLoad } from "@norskvideo/norsk-api/lib/shared/common_pb";
-import { Wave, AmdMA35DLoad } from "@norskvideo/norsk-api/lib/media_pb";
+import { AmdMA35DLoad } from "@norskvideo/norsk-api/lib/media_pb";
 import { PinToKey } from "./media_nodes/common";
 import { NorskInput } from "./media_nodes/input";
 import { Gain, NorskProcessor, NorskDuplex } from "./media_nodes/processor";
 import { NorskOutput } from "./media_nodes/output";
-import { EncryptionSettings, StreamKey, StreamMetadata, Context } from "./media_nodes/types";
+import { EncryptionSettings, StreamKey, StreamMetadata, Context, Wave } from "./media_nodes/types";
 import { NorskSystem } from "./system";
 import { NorskDebug } from "./media_nodes/debug";
 import { NorskMediaStore } from "./media_nodes/mediaStore";
@@ -183,7 +183,11 @@ export declare function playlistStreamKeys(streams: readonly StreamMetadata[]):
 export declare function ancillaryStreamKeys(streams: readonly StreamMetadata[]): StreamKey[];
 /** @public */
 export declare function newSilentMatrix(rows: number, cols: number): Gain[][];
-/** @public */
+/**
+ * @public
+ *
+ * Provided for compatibilty, this is just e.g. `{ type: "sine", freq: 444 }`
+ */
 export declare function mkSine(freq: number): Wave;
 /**
  * @public

package/lib/src/sdk.js

@@ -30,7 +30,6 @@ exports.streamKeysAreEqual = exports.requireExactAV = exports.requireAV = export
 const grpc = __importStar(require("@grpc/grpc-js"));
 const media_grpc_pb_1 = require("@norskvideo/norsk-api/lib/media_grpc_pb");
 const common_pb_1 = require("@norskvideo/norsk-api/lib/shared/common_pb");
-const media_pb_1 = require("@norskvideo/norsk-api/lib/media_pb");
 const protobuf_1 = require("@bufbuild/protobuf");
 const utils_1 = require("./shared/utils");
 const input_1 = require("./media_nodes/input");
@@ -52,10 +51,10 @@ __exportStar(require("./media_nodes/common"), exports);
 __exportStar(require("./media_nodes/mediaStore"), exports);
 var common_pb_2 = require("@norskvideo/norsk-api/lib/shared/common_pb");
 Object.defineProperty(exports, "CurrentLoad", { enumerable: true, get: function () { return common_pb_2.CurrentLoad; } });
+var media_pb_1 = require("@norskvideo/norsk-api/lib/media_pb");
+Object.defineProperty(exports, "AmdMA35DLoad", { enumerable: true, get: function () { return media_pb_1.AmdMA35DLoad; } });
 var media_pb_2 = require("@norskvideo/norsk-api/lib/media_pb");
-Object.defineProperty(exports, "AmdMA35DLoad", { enumerable: true, get: function () { return media_pb_2.AmdMA35DLoad; } });
-var media_pb_3 = require("@norskvideo/norsk-api/lib/media_pb");
-Object.defineProperty(exports, "AudioCodec", { enumerable: true, get: function () { return media_pb_3.AudioCodec; } });
+Object.defineProperty(exports, "AudioCodec", { enumerable: true, get: function () { return media_pb_2.AudioCodec; } });
 __exportStar(require("./system"), exports);
 var common_pb_3 = require("@norskvideo/norsk-api/lib/shared/common_pb");
 Object.defineProperty(exports, "Version", { enumerable: true, get: function () { return common_pb_3.Version; } });
@@ -73,7 +72,7 @@ class Norsk {
     registerNode(node) {
         this.nodes.push(node);
         if (this.closing) {
-            node.close();
+            void node.close();
         }
         return node;
     }
@@ -485,9 +484,13 @@ function newSilentMatrix(rows, cols) {
     return new Array(rows).fill(0).map(() => new Array(cols).fill(null));
 }
 exports.newSilentMatrix = newSilentMatrix;
-/** @public */
+/**
+ * @public
+ *
+ * Provided for compatibilty, this is just e.g. `{ type: "sine", freq: 444 }`
+ */
 function mkSine(freq) {
-    return new media_pb_1.Wave({ message: { case: "sine", value: new media_pb_1.SineWave({ freq }) } });
+    return { type: "sine", freq };
 }
 exports.mkSine = mkSine;
 /**

package/package.json

@@ -1,11 +1,11 @@
 {
   "license": "MIT",
   "name": "@norskvideo/norsk-sdk",
-  "version": "1.0.391",
+  "version": "1.0.392",
   "dependencies": {
     "@bufbuild/protobuf": "^0.3.0",
     "@grpc/grpc-js": "^1.2.2",
-    "@norskvideo/norsk-api": "1.0.391",
+    "@norskvideo/norsk-api": "1.0.392",
     "lodash": "^4.17.21",
     "typescript-nullable": "^0.6.0"
   },

package/src/sdk.ts

@@ -6,9 +6,7 @@ import {
   Log_Level,
 } from "@norskvideo/norsk-api/lib/shared/common_pb";
 import {
-  Wave,
   NorskStatusEvent,
-  SineWave,
   AmdMA35DLoad,
   SubscriptionChannelResponse
 } from "@norskvideo/norsk-api/lib/media_pb";
@@ -99,7 +97,7 @@ import {
   WhipOutputNode,
   WhipOutputSettings,
 } from "./media_nodes/output";
-import { EncryptionSettings, StreamKey, StreamMetadata, Context } from "./media_nodes/types";
+import { EncryptionSettings, StreamKey, StreamMetadata, Context, Wave } from "./media_nodes/types";
 import { hardwareInfo, NorskSystem } from "./system";
 import { NorskDebug, StreamTimestampReportNode, StreamTimestampReportSettings } from "./media_nodes/debug";
 import {
@@ -268,7 +266,7 @@ export class Norsk {
   registerNode<N extends MediaNodeState>(node: N): N {
     this.nodes.push(node);
     if (this.closing) {
-      node.close();
+      void node.close();
     }
     return node;
   }
@@ -631,7 +629,7 @@ export class Norsk {
     this.duplex = {
       webRtcBrowser: async (settings: WebRTCBrowserSettings) =>
         WebRTCBrowserNode.create(settings, this._client(), unregisterNode).then(registerNode),
-      sip: async (settings: SipSettings) => 
+      sip: async (settings: SipSettings) =>
         SipNode.create(settings, this._client(), unregisterNode).then(registerNode)
     };
   }
@@ -773,9 +771,13 @@ export function newSilentMatrix(rows: number, cols: number): Gain[][] {
   return new Array(rows).fill(0).map(() => new Array(cols).fill(null));
 }
 
-/** @public */
-export function mkSine(freq: number) {
-  return new Wave({ message: { case: "sine", value: new SineWave({ freq }) } });
+/**
+ * @public
+ * 
+ * Provided for compatibilty, this is just e.g. `{ type: "sine", freq: 444 }`
+ */
+export function mkSine(freq: number): Wave {
+  return { type: "sine", freq }
 }
 
 /**