@urun-sh/core 0.2.56 → 0.2.57

package/dist/internal.mjs

@@ -1,2 +1,2 @@
 import { createRequire as __urunCreateRequire } from 'node:module'; const require = globalThis.require ?? __urunCreateRequire(import.meta.url);
-import{E as r,H as t,I as n,J as a,K as s,M as p,N as m,O as c,S as i,T as l,U as S,V as f,W as x,X as C,Y as D,a as e,b as o}from"./chunk-ROHOB3GT.mjs";export{e as ChannelMultiplexer,l as DOC_SYNC_WIRE_CONTRACT_VERSION,o as DeferredChannelMultiplexer,x as DeferredDocConnector,p as LoopbackStreamData,C as SessionDocumentImpl,i as TransportSession,r as allocateSession,D as createPresence,f as createWebsocketDocConnector,S as deriveYjsServerUrl,s as ensureNodeWebRTC,t as isNodeRuntime,n as nodeMediasoupHandlerName,a as nodeWebRTCUnavailableReason,c as streamDataLabel,m as transportStreamData};
+import{E as r,H as t,I as n,J as a,K as s,O as p,P as m,Q as c,U as i,V as l,W as S,X as f,Y as x,Z as C,_ as D,a as e,b as o}from"./chunk-GR7O2DMI.mjs";export{e as ChannelMultiplexer,l as DOC_SYNC_WIRE_CONTRACT_VERSION,o as DeferredChannelMultiplexer,x as DeferredDocConnector,p as LoopbackStreamData,C as SessionDocumentImpl,i as TransportSession,r as allocateSession,D as createPresence,f as createWebsocketDocConnector,S as deriveYjsServerUrl,s as ensureNodeWebRTC,t as isNodeRuntime,n as nodeMediasoupHandlerName,a as nodeWebRTCUnavailableReason,c as streamDataLabel,m as transportStreamData};

package/dist/{stream-data-Cb0t-gV0.d.mts → stream-data-Cgh02-qs.d.mts}

@@ -263,6 +263,10 @@ interface TransportSessionOptions {
     
     audioPlayout?: AudioPlayoutOptions;
     
+    videoPlayout?: VideoPlayoutOptions;
+    
+    sessionStats?: SessionStatsOptions;
+    
     diagnosticSink?: (diagnostic: SessionDiagnostic) => void;
 }
 
@@ -271,6 +275,57 @@ interface AudioPlayoutOptions {
     jitterBufferTargetMs?: number;
 }
 
+interface VideoPlayoutOptions {
+    
+    jitterBufferTargetMs?: number;
+}
+
+interface SessionStatsOptions {
+    
+    pollMs?: number;
+}
+
+interface InboundStatsSample {
+    
+    consumerId: string;
+    
+    total: number;
+    framesDecoded: number | null;
+    
+    jitter: number | null;
+    packetsReceived: number | null;
+    packetsLost: number | null;
+    nackCount: number | null;
+    pliCount: number | null;
+    firCount: number | null;
+    keyFramesDecoded: number | null;
+    framesReceived: number | null;
+    framesDropped: number | null;
+    retransmittedPacketsReceived: number | null;
+    retransmittedBytesReceived: number | null;
+    jitterBufferDelay: number | null;
+    jitterBufferEmittedCount: number | null;
+    
+    estimatedPlayoutTimestamp: number | null;
+    jitterBufferTargetDelay: number | null;
+    jitterBufferMinimumDelay: number | null;
+    concealedSamples: number | null;
+    insertedSamplesForDeceleration: number | null;
+}
+
+interface SessionStatsSample {
+    
+    timestamp: number;
+    
+    stream: string | null;
+    
+    avSyncMs: number | null;
+    
+    audio: InboundStatsSample | null;
+    
+    video: InboundStatsSample | null;
+}
+
 interface MediaLivenessOptions {
     
     pollMs?: number;
@@ -424,6 +479,8 @@ interface Session {
     
     onActivation?(handler: (event: ActivationEvent) => void): () => void;
     
+    onStats?(handler: (sample: SessionStatsSample) => void): () => void;
+    
     whenLive(options?: {
         timeout?: number;
         signal?: AbortSignal;
@@ -550,6 +607,10 @@ interface AppOptions {
     priority?: 'preempt';
     
     audioPlayout?: AudioPlayoutOptions;
+    
+    videoPlayout?: VideoPlayoutOptions;
+    
+    sessionStats?: SessionStatsOptions;
 }
 interface AccessTokenOptions$1 {
     forceRefresh?: boolean;
@@ -750,6 +811,8 @@ interface TransportEvents {
     
     diagnostic: (diagnostic: SessionDiagnostic) => void;
     
+    stats: (sample: SessionStatsSample) => void;
+    
     seeked: (stream: string, target: number | 'live') => void;
     
     signal: (msg: Record<string, unknown>) => void;
@@ -822,6 +885,10 @@ declare class TransportSession {
     
     private _mediaProbeTimer;
     
+    private _statsTimer;
+    
+    private _statsSampleInFlight;
+    
     private _joinProbes;
     
     private _decodeDeathHandled;
@@ -838,6 +905,8 @@ declare class TransportSession {
     
     private _streamDataHandlers;
     
+    private _streamDataLane;
+    
     private _dataProducers;
     
     private _dataProducerPromises;
@@ -914,6 +983,14 @@ declare class TransportSession {
     
     private _dispatchStreamData;
     
+    markStreamDataLaneQuic(): void;
+    
+    dispatchQuicStreamData(name: string, payload: unknown): void;
+    
+    raiseQuicStreamDataError(err: Error): void;
+    
+    quicStreamDataLaneLost(reason: string): void;
+    
     private _streamNameFromLabel;
     
     mediaUnavailableReason(): string | null;
@@ -962,9 +1039,9 @@ declare class TransportSession {
     private _onConsumeData;
     private _onConsume;
     
-    private _audioJitterBufferTargetMs;
+    private _jitterBufferTargetMs;
     
-    private _capAudioJitterBuffer;
+    private _capJitterBuffer;
     
     private _closeConsumer;
     
@@ -976,6 +1053,13 @@ declare class TransportSession {
     private _startMediaProbe;
     private _stopMediaProbe;
     
+    private _statsPollMs;
+    private _startStatsSampler;
+    private _stopStatsSampler;
+    
+    private _lanePairKey;
+    private _sampleSessionStats;
+    
     private _resetJoinProbes;
     private _sampleMediaArrival;
     
@@ -1103,4 +1187,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { type SessionEndResult as $, type AccessTokenOptions$1 as A, type PrewakeResult as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type PrewakeStatus as E, type RecordingBucket as F, type RecordingLifecycle as G, type RecordingStatus as H, type RecordingsAccessor as I, type ReleaseSessionBeaconOptions as J, type RequestOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RequestStreamOptions as N, type RuntimeArtifact as O, type Presence as P, type RuntimeArtifactDownload as Q, type Recording as R, type RuntimeArtifactsAccessor as S, type RuntimeAvailability as T, type RuntimeWakeDetail as U, type RuntimeWakeGolden as V, type RuntimeWakeReasonCode as W, type Session as X, type SessionDiagnostic as Y, type SessionDocument as Z, SessionDocumentImpl as _, type AccessTokenOptions as a, type SessionFailureKind as a0, type SessionPhase as a1, type SessionPhaseError as a2, type SessionPhaseName as a3, type SessionStartOptions as a4, type SessionStatus as a5, type SessionStream as a6, type SessionText as a7, type Store as a8, type StoreOptions as a9, type StreamChunkOptions as aa, type StreamDataTransport as ab, TransportSession as ac, type TransportSessionOptions as ad, type TransportState as ae, allocateSession as af, createPresence as ag, createWebsocketDocConnector as ah, deriveYjsServerUrl as ai, derivedLegName as aj, derivedLegRole as ak, isPendingRecording as al, mediaRecorderChunkSource as am, prewake as an, releaseSessionBeacon as ao, streamDataLabel as ap, transportStreamData as aq, type ActivationEvent as b, type ActivationState as c, type AllocateSessionOptions as d, type AllocatedSession as e, type App as f, type AppOptions as g, type AttachOptions as h, type AudioPlayoutOptions as i, type ChannelMessage as j, ChannelMultiplexer as k, type ChannelName as l, type ChunkReadable as m, DOC_SYNC_WIRE_CONTRACT_VERSION as n, DeferredChannelMultiplexer as o, DeferredDocConnector as p, type DerivedLegRole as q, type DocConnection as r, type DocConnectionState as s, type DocConnector as t, type DocTokenSupplier as u, type MediaChunkSource as v, type MediaChunkSourceFactory as w, type MediaRecorderChunkSourceOptions as x, type PresenceState as y, type PrewakeOptions as z };
+export { SessionDocumentImpl as $, type AccessTokenOptions$1 as A, type PrewakeResult as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type PrewakeStatus as E, type RecordingBucket as F, type RecordingLifecycle as G, type RecordingStatus as H, type InboundStatsSample as I, type RecordingsAccessor as J, type ReleaseSessionBeaconOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RequestOptions as N, type RequestStreamOptions as O, type Presence as P, type RuntimeArtifact as Q, type Recording as R, type RuntimeArtifactDownload as S, type RuntimeArtifactsAccessor as T, type RuntimeAvailability as U, type RuntimeWakeDetail as V, type RuntimeWakeGolden as W, type RuntimeWakeReasonCode as X, type Session as Y, type SessionDiagnostic as Z, type SessionDocument as _, type AccessTokenOptions as a, type SessionEndResult as a0, type SessionFailureKind as a1, type SessionPhase as a2, type SessionPhaseError as a3, type SessionPhaseName as a4, type SessionStartOptions as a5, type SessionStatsOptions as a6, type SessionStatsSample as a7, type SessionStatus as a8, type SessionStream as a9, type SessionText as aa, type Store as ab, type StoreOptions as ac, type StreamChunkOptions as ad, type StreamDataTransport as ae, TransportSession as af, type TransportSessionOptions as ag, type TransportState as ah, type VideoPlayoutOptions as ai, allocateSession as aj, createPresence as ak, createWebsocketDocConnector as al, deriveYjsServerUrl as am, derivedLegName as an, derivedLegRole as ao, isPendingRecording as ap, mediaRecorderChunkSource as aq, prewake as ar, releaseSessionBeacon as as, streamDataLabel as at, transportStreamData as au, type ActivationEvent as b, type ActivationState as c, type AllocateSessionOptions as d, type AllocatedSession as e, type App as f, type AppOptions as g, type AttachOptions as h, type AudioPlayoutOptions as i, type ChannelMessage as j, ChannelMultiplexer as k, type ChannelName as l, type ChunkReadable as m, DOC_SYNC_WIRE_CONTRACT_VERSION as n, DeferredChannelMultiplexer as o, DeferredDocConnector as p, type DerivedLegRole as q, type DocConnection as r, type DocConnectionState as s, type DocConnector as t, type DocTokenSupplier as u, type MediaChunkSource as v, type MediaChunkSourceFactory as w, type MediaRecorderChunkSourceOptions as x, type PresenceState as y, type PrewakeOptions as z };

package/dist/{stream-data-Cb0t-gV0.d.ts → stream-data-Cgh02-qs.d.ts}

@@ -263,6 +263,10 @@ interface TransportSessionOptions {
     
     audioPlayout?: AudioPlayoutOptions;
     
+    videoPlayout?: VideoPlayoutOptions;
+    
+    sessionStats?: SessionStatsOptions;
+    
     diagnosticSink?: (diagnostic: SessionDiagnostic) => void;
 }
 
@@ -271,6 +275,57 @@ interface AudioPlayoutOptions {
     jitterBufferTargetMs?: number;
 }
 
+interface VideoPlayoutOptions {
+    
+    jitterBufferTargetMs?: number;
+}
+
+interface SessionStatsOptions {
+    
+    pollMs?: number;
+}
+
+interface InboundStatsSample {
+    
+    consumerId: string;
+    
+    total: number;
+    framesDecoded: number | null;
+    
+    jitter: number | null;
+    packetsReceived: number | null;
+    packetsLost: number | null;
+    nackCount: number | null;
+    pliCount: number | null;
+    firCount: number | null;
+    keyFramesDecoded: number | null;
+    framesReceived: number | null;
+    framesDropped: number | null;
+    retransmittedPacketsReceived: number | null;
+    retransmittedBytesReceived: number | null;
+    jitterBufferDelay: number | null;
+    jitterBufferEmittedCount: number | null;
+    
+    estimatedPlayoutTimestamp: number | null;
+    jitterBufferTargetDelay: number | null;
+    jitterBufferMinimumDelay: number | null;
+    concealedSamples: number | null;
+    insertedSamplesForDeceleration: number | null;
+}
+
+interface SessionStatsSample {
+    
+    timestamp: number;
+    
+    stream: string | null;
+    
+    avSyncMs: number | null;
+    
+    audio: InboundStatsSample | null;
+    
+    video: InboundStatsSample | null;
+}
+
 interface MediaLivenessOptions {
     
     pollMs?: number;
@@ -424,6 +479,8 @@ interface Session {
     
     onActivation?(handler: (event: ActivationEvent) => void): () => void;
     
+    onStats?(handler: (sample: SessionStatsSample) => void): () => void;
+    
     whenLive(options?: {
         timeout?: number;
         signal?: AbortSignal;
@@ -550,6 +607,10 @@ interface AppOptions {
     priority?: 'preempt';
     
     audioPlayout?: AudioPlayoutOptions;
+    
+    videoPlayout?: VideoPlayoutOptions;
+    
+    sessionStats?: SessionStatsOptions;
 }
 interface AccessTokenOptions$1 {
     forceRefresh?: boolean;
@@ -750,6 +811,8 @@ interface TransportEvents {
     
     diagnostic: (diagnostic: SessionDiagnostic) => void;
     
+    stats: (sample: SessionStatsSample) => void;
+    
     seeked: (stream: string, target: number | 'live') => void;
     
     signal: (msg: Record<string, unknown>) => void;
@@ -822,6 +885,10 @@ declare class TransportSession {
     
     private _mediaProbeTimer;
     
+    private _statsTimer;
+    
+    private _statsSampleInFlight;
+    
     private _joinProbes;
     
     private _decodeDeathHandled;
@@ -838,6 +905,8 @@ declare class TransportSession {
     
     private _streamDataHandlers;
     
+    private _streamDataLane;
+    
     private _dataProducers;
     
     private _dataProducerPromises;
@@ -914,6 +983,14 @@ declare class TransportSession {
     
     private _dispatchStreamData;
     
+    markStreamDataLaneQuic(): void;
+    
+    dispatchQuicStreamData(name: string, payload: unknown): void;
+    
+    raiseQuicStreamDataError(err: Error): void;
+    
+    quicStreamDataLaneLost(reason: string): void;
+    
     private _streamNameFromLabel;
     
     mediaUnavailableReason(): string | null;
@@ -962,9 +1039,9 @@ declare class TransportSession {
     private _onConsumeData;
     private _onConsume;
     
-    private _audioJitterBufferTargetMs;
+    private _jitterBufferTargetMs;
     
-    private _capAudioJitterBuffer;
+    private _capJitterBuffer;
     
     private _closeConsumer;
     
@@ -976,6 +1053,13 @@ declare class TransportSession {
     private _startMediaProbe;
     private _stopMediaProbe;
     
+    private _statsPollMs;
+    private _startStatsSampler;
+    private _stopStatsSampler;
+    
+    private _lanePairKey;
+    private _sampleSessionStats;
+    
     private _resetJoinProbes;
     private _sampleMediaArrival;
     
@@ -1103,4 +1187,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { type SessionEndResult as $, type AccessTokenOptions$1 as A, type PrewakeResult as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type PrewakeStatus as E, type RecordingBucket as F, type RecordingLifecycle as G, type RecordingStatus as H, type RecordingsAccessor as I, type ReleaseSessionBeaconOptions as J, type RequestOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RequestStreamOptions as N, type RuntimeArtifact as O, type Presence as P, type RuntimeArtifactDownload as Q, type Recording as R, type RuntimeArtifactsAccessor as S, type RuntimeAvailability as T, type RuntimeWakeDetail as U, type RuntimeWakeGolden as V, type RuntimeWakeReasonCode as W, type Session as X, type SessionDiagnostic as Y, type SessionDocument as Z, SessionDocumentImpl as _, type AccessTokenOptions as a, type SessionFailureKind as a0, type SessionPhase as a1, type SessionPhaseError as a2, type SessionPhaseName as a3, type SessionStartOptions as a4, type SessionStatus as a5, type SessionStream as a6, type SessionText as a7, type Store as a8, type StoreOptions as a9, type StreamChunkOptions as aa, type StreamDataTransport as ab, TransportSession as ac, type TransportSessionOptions as ad, type TransportState as ae, allocateSession as af, createPresence as ag, createWebsocketDocConnector as ah, deriveYjsServerUrl as ai, derivedLegName as aj, derivedLegRole as ak, isPendingRecording as al, mediaRecorderChunkSource as am, prewake as an, releaseSessionBeacon as ao, streamDataLabel as ap, transportStreamData as aq, type ActivationEvent as b, type ActivationState as c, type AllocateSessionOptions as d, type AllocatedSession as e, type App as f, type AppOptions as g, type AttachOptions as h, type AudioPlayoutOptions as i, type ChannelMessage as j, ChannelMultiplexer as k, type ChannelName as l, type ChunkReadable as m, DOC_SYNC_WIRE_CONTRACT_VERSION as n, DeferredChannelMultiplexer as o, DeferredDocConnector as p, type DerivedLegRole as q, type DocConnection as r, type DocConnectionState as s, type DocConnector as t, type DocTokenSupplier as u, type MediaChunkSource as v, type MediaChunkSourceFactory as w, type MediaRecorderChunkSourceOptions as x, type PresenceState as y, type PrewakeOptions as z };
+export { SessionDocumentImpl as $, type AccessTokenOptions$1 as A, type PrewakeResult as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type PrewakeStatus as E, type RecordingBucket as F, type RecordingLifecycle as G, type RecordingStatus as H, type InboundStatsSample as I, type RecordingsAccessor as J, type ReleaseSessionBeaconOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RequestOptions as N, type RequestStreamOptions as O, type Presence as P, type RuntimeArtifact as Q, type Recording as R, type RuntimeArtifactDownload as S, type RuntimeArtifactsAccessor as T, type RuntimeAvailability as U, type RuntimeWakeDetail as V, type RuntimeWakeGolden as W, type RuntimeWakeReasonCode as X, type Session as Y, type SessionDiagnostic as Z, type SessionDocument as _, type AccessTokenOptions as a, type SessionEndResult as a0, type SessionFailureKind as a1, type SessionPhase as a2, type SessionPhaseError as a3, type SessionPhaseName as a4, type SessionStartOptions as a5, type SessionStatsOptions as a6, type SessionStatsSample as a7, type SessionStatus as a8, type SessionStream as a9, type SessionText as aa, type Store as ab, type StoreOptions as ac, type StreamChunkOptions as ad, type StreamDataTransport as ae, TransportSession as af, type TransportSessionOptions as ag, type TransportState as ah, type VideoPlayoutOptions as ai, allocateSession as aj, createPresence as ak, createWebsocketDocConnector as al, deriveYjsServerUrl as am, derivedLegName as an, derivedLegRole as ao, isPendingRecording as ap, mediaRecorderChunkSource as aq, prewake as ar, releaseSessionBeacon as as, streamDataLabel as at, transportStreamData as au, type ActivationEvent as b, type ActivationState as c, type AllocateSessionOptions as d, type AllocatedSession as e, type App as f, type AppOptions as g, type AttachOptions as h, type AudioPlayoutOptions as i, type ChannelMessage as j, ChannelMultiplexer as k, type ChannelName as l, type ChunkReadable as m, DOC_SYNC_WIRE_CONTRACT_VERSION as n, DeferredChannelMultiplexer as o, DeferredDocConnector as p, type DerivedLegRole as q, type DocConnection as r, type DocConnectionState as s, type DocConnector as t, type DocTokenSupplier as u, type MediaChunkSource as v, type MediaChunkSourceFactory as w, type MediaRecorderChunkSourceOptions as x, type PresenceState as y, type PrewakeOptions as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urun-sh/core",
-  "version": "0.2.56",
+  "version": "0.2.57",
   "description": "Core transport and channel primitives for the urun TypeScript SDK",
   "repository": {
     "type": "git",