@urun-sh/core 0.2.56 → 0.2.58

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { g as AppOptions, f as App$1, a1 as SessionPhase, a5 as SessionStatus, a3 as SessionPhaseName, A as AccessTokenOptions, O as RuntimeArtifact, Q as RuntimeArtifactDownload, R as Recording, X as Session$1, C as ChannelEndpoint, ac as TransportSession, h as AttachOptions, Y as SessionDiagnostic, b as ActivationEvent, I as RecordingsAccessor, S as RuntimeArtifactsAccessor, $ as SessionEndResult, a6 as SessionStream$1, ab as StreamDataTransport, _ as SessionDocumentImpl, aa as StreamChunkOptions, m as ChunkReadable, P as Presence, t as DocConnector, u as DocTokenSupplier, K as RequestOptions, N as RequestStreamOptions, a9 as StoreOptions, a8 as Store, k as ChannelMultiplexer, a0 as SessionFailureKind, ae as TransportState } from './stream-data-Cb0t-gV0.js';
-export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, q as DerivedLegRole, s as DocConnectionState, M as MediaChunkBinding, v as MediaChunkSource, w as MediaChunkSourceFactory, x as MediaRecorderChunkSourceOptions, y as PresenceState, z as PrewakeOptions, B as PrewakeResult, E as PrewakeStatus, F as RecordingBucket, G as RecordingLifecycle, H as RecordingStatus, J as ReleaseSessionBeaconOptions, T as RuntimeAvailability, U as RuntimeWakeDetail, V as RuntimeWakeGolden, W as RuntimeWakeReasonCode, Z as SessionDocument, a2 as SessionPhaseError, a7 as SessionText, aj as derivedLegName, ak as derivedLegRole, al as isPendingRecording, am as mediaRecorderChunkSource, an as prewake, ao as releaseSessionBeacon } from './stream-data-Cb0t-gV0.js';
+import { g as AppOptions, f as App$1, a2 as SessionPhase, a8 as SessionStatus, a4 as SessionPhaseName, A as AccessTokenOptions, Q as RuntimeArtifact, S as RuntimeArtifactDownload, R as Recording, Y as Session$1, C as ChannelEndpoint, af as TransportSession, h as AttachOptions, Z as SessionDiagnostic, b as ActivationEvent, a7 as SessionStatsSample, J as RecordingsAccessor, T as RuntimeArtifactsAccessor, a0 as SessionEndResult, a9 as SessionStream$1, ae as StreamDataTransport, $ as SessionDocumentImpl, ad as StreamChunkOptions, m as ChunkReadable, P as Presence, t as DocConnector, u as DocTokenSupplier, N as RequestOptions, O as RequestStreamOptions, ac as StoreOptions, ab as Store, k as ChannelMultiplexer, a1 as SessionFailureKind, ah as TransportState } from './stream-data-Cgh02-qs.js';
+export { c as ActivationState, i as AudioPlayoutOptions, D as DERIVED_LEG_SEP, q as DerivedLegRole, s as DocConnectionState, I as InboundStatsSample, M as MediaChunkBinding, v as MediaChunkSource, w as MediaChunkSourceFactory, x as MediaRecorderChunkSourceOptions, y as PresenceState, z as PrewakeOptions, B as PrewakeResult, E as PrewakeStatus, F as RecordingBucket, G as RecordingLifecycle, H as RecordingStatus, K as ReleaseSessionBeaconOptions, U as RuntimeAvailability, V as RuntimeWakeDetail, W as RuntimeWakeGolden, X as RuntimeWakeReasonCode, _ as SessionDocument, a3 as SessionPhaseError, a6 as SessionStatsOptions, aa as SessionText, ai as VideoPlayoutOptions, an as derivedLegName, ao as derivedLegRole, ap as isPendingRecording, aq as mediaRecorderChunkSource, ar as prewake, as as releaseSessionBeacon } from './stream-data-Cgh02-qs.js';
 import 'yjs';
 import 'y-protocols/awareness';
 
@@ -317,6 +317,8 @@ declare class Session implements Session$1 {
     
     onActivation(handler: (event: ActivationEvent) => void): () => void;
     
+    onStats(handler: (sample: SessionStatsSample) => void): () => void;
+    
     whenLive(options?: WhenLiveOptions): Promise<void>;
     
     get recordings(): RecordingsAccessor;
@@ -790,6 +792,61 @@ interface CameraWarp {
 }
 declare function createCameraWarp(options?: CameraWarpOptions): CameraWarp;
 
+declare const WT_DATA_STREAM_VERSION = 1;
+
+interface WtDataEnvelope {
+    name: string;
+    payload: unknown;
+}
+
+interface WtDataLaneSink {
+    onData(name: string, payload: unknown): void;
+    onLaneError(err: Error): void;
+}
+
+interface QuicStreamDataTransport {
+    
+    markStreamDataLaneQuic(): void;
+    
+    dispatchQuicStreamData(name: string, payload: unknown): void;
+    
+    quicStreamDataLaneLost(reason: string): void;
+    
+    raiseQuicStreamDataError(err: Error): void;
+}
+
+declare class WtDataStreamParser {
+    private buf;
+    private name;
+    private ended;
+    
+    get streamName(): string | null;
+    push(chunk: Uint8Array): WtDataEnvelope[];
+    
+    finish(): void;
+}
+
+interface WtByteReader {
+    read(): Promise<{
+        value?: Uint8Array;
+        done: boolean;
+    }>;
+    cancel?(reason?: unknown): Promise<void>;
+}
+interface WtIncomingUniStream {
+    getReader(): WtByteReader;
+}
+interface WtIncomingUniStreams {
+    getReader(): {
+        read(): Promise<{
+            value?: WtIncomingUniStream;
+            done: boolean;
+        }>;
+    };
+}
+
+declare function consumeWtDataStreams(incoming: WtIncomingUniStreams, sink: WtDataLaneSink): Promise<void>;
+
 interface MediaSession {
     readonly kind: 'webtransport' | 'webrtc';
     start(): Promise<void>;
@@ -804,6 +861,8 @@ interface MediaSession {
     };
     
     readonly firstMedia: Promise<void>;
+    
+    consumeDataStreams?(sink: WtDataLaneSink): void;
 }
 
 interface Signaling {
@@ -837,6 +896,8 @@ interface TransportOfferRequest {
         webcodecs: boolean;
         
         codecs: string[];
+        
+        wtData?: boolean;
     };
 }
 interface TransportOfferResponse {
@@ -852,6 +913,8 @@ interface TransportOfferResponse {
         
         token: string;
         codec: string;
+        
+        data?: boolean;
     };
 }
 interface TransportEstablishedNotify {
@@ -905,6 +968,16 @@ declare function parseDgramHeader(view: DataView): DgramHeader;
 
 declare function writeDgramHeader(h: DgramHeader): Uint8Array;
 
+interface NegotiatorDataLaneSeam {
+    
+    onData(name: string, payload: unknown): void;
+    
+    onQuicLane(): void;
+    
+    onQuicLaneLost(reason: string): void;
+    
+    onLaneError(err: Error): void;
+}
 interface NegotiatorOptions {
     
     quicDeadlineMs?: number;
@@ -916,6 +989,8 @@ interface NegotiatorOptions {
     
     createWebRtcSession: () => MediaSession;
     createWebTransportSession?: (offer: NonNullable<TransportOfferResponse['webtransport']>) => MediaSession;
+    
+    dataLane?: NegotiatorDataLaneSeam;
 }
 declare class TransportNegotiator {
     private signaling;
@@ -923,12 +998,16 @@ declare class TransportNegotiator {
     private opts;
     private session;
     private offer;
+    
+    private quicDataLane;
     constructor(signaling: Signaling, sessionId: string, opts: NegotiatorOptions);
     get activeTransport(): MediaSession['kind'] | null;
     connect(): Promise<MediaSession>;
     disconnect(): Promise<void>;
     
     retryWebTransport(): Promise<MediaSession | null>;
+    
+    private engageQuicDataLane;
     private createWebTransportSession;
     private startWebRtc;
     
@@ -956,6 +1035,8 @@ declare class WebTransportSession implements MediaSession {
     private lastArrivalTs;
     private jitterEwmaMs;
     private lastStats;
+    
+    private dataLaneSink;
     private firstFrameResolve;
     private firstFrameReject;
     
@@ -973,6 +1054,8 @@ declare class WebTransportSession implements MediaSession {
         lossPct: number;
         jitterMs: number;
     };
+    
+    consumeDataStreams(sink: WtDataLaneSink): void;
     private initDecoder;
     
     private onDecoderError;
@@ -1063,4 +1146,4 @@ declare class FrameReassembler {
     private requestKeyframe;
 }
 
-export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DGRAM_HEADER_BYTES, type DgramHeader, DocTokenSupplier, FOREGROUND_COALESCE_MS, FrameReassembler, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, type MediaSession, type NegotiatorOptions, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, ProduceAckTimeoutError, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatus, SessionStream$1 as SessionStream, type SignalCarrier, type Signaling, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type TransportEstablishedNotify, TransportNegotiator, type TransportOfferRequest, type TransportOfferResponse, TransportSessionMismatchError, TransportSessionSignaling, TransportState, URUN_DEV_ENV, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WT_CONTROL_FRAME_MAX, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtControlDecoder, type WtControlMessage, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, createActivityTracker, createCameraWarp, createClientToken, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, encodeWtControlFrame, fitWithin, isDurationString, isRetryableSessionError, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, parseDgramHeader, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive, writeDgramHeader };
+export { ACTIVATION_COLD_BOOT_AFTER_MS, ACTIVATION_DEGRADED_AFTER_MS, ACTIVATION_HINT_PATH, ACTIVATION_STILL_AFTER_MS, ACTIVITY_DOM_EVENTS, ACTIVITY_FIELD, ACTIVITY_STAMP_MIN_INTERVAL_MS, ActivationEvent, ActivationMonitor, type ActivationMonitorOptions, type ActivationStreamLike, type ActivityAwareness, type ActivityTracker, type ActivityTrackerOptions, App, App$1 as AppInterface, AppOptions, AttachOptions, BACKOFF_BASE_MS, BACKOFF_MAX_ATTEMPTS, BACKOFF_MAX_MS, type CameraWarp, type CameraWarpOptions, type CameraWarpTransform, type CaptureClaim, CaptureController, type CaptureControllerOptions, type CaptureKind, CaptureUnavailableError, ChunkReadable, type ClientToken, ClientTokenError, type ConsumingTransport, type CreateClientTokenOptions, DATA_CHANNEL_MESSAGE_CEILING, DEFAULT_DOC_SYNC_TIMEOUT_MS, DEFAULT_GATEWAY_URL, DEFAULT_PRODUCE_ACK_TIMEOUT_MS, DEFAULT_REFERENCE_JPEG_QUALITY, DEFAULT_REFERENCE_MAX_SIZE, DEFAULT_WHEN_LIVE_TIMEOUT_MS, DGRAM_HEADER_BYTES, type DgramHeader, DocTokenSupplier, FOREGROUND_COALESCE_MS, FrameReassembler, INPUT_PRESENCE_DEFAULT_HZ, INPUT_PRESENCE_FIELD, type InputPresenceAwareness, type InputPresencePublisher, type InputPresencePublisherOptions, type InputPresenceState, InvalidDurationError, LEGACY_ACTIVATION_HINT_PATH, type MediaSession, type NegotiatorDataLaneSeam, type NegotiatorOptions, type NormalizeReferenceImageOptions, PLATFORM_DOC_NAME, PermanentLockedError, type PhaseObservable, PinRequiresActiveTempError, Presence, ProduceAckTimeoutError, type QuicStreamDataTransport, type ReassembledFrame, type ReassemblerCallbacks, type ReassemblerOptions, Recording, RecordingNotFoundError, RecordingsAccessor, RecordingsClient, type RecordingsClientOptions, RecordingsError, RecordingsUnauthorizedError, type ReferenceImage, type ReferenceImageSource, type ReferenceImageType, RequestAbortError, RequestCancelledError, RequestDocSyncError, RequestError, RequestOptions, RequestStreamOptions, RequestTimeoutError, RetainNotTempError, type RetentionIntent, RuntimeArtifact, RuntimeArtifactDownload, RuntimeArtifactNotFoundError, RuntimeArtifactsAccessor, RuntimeArtifactsClient, type RuntimeArtifactsClientOptions, RuntimeArtifactsError, RuntimeArtifactsUnauthorizedError, Session, SessionAllocationError, SessionDiagnostic, SessionEndError, SessionEndResult, SessionEndUnavailableError, SessionFailedError, SessionFailureKind, Session$1 as SessionInterface, SessionPhase, SessionPhaseName, SessionStatsSample, SessionStatus, SessionStream$1 as SessionStream, type SignalCarrier, type Signaling, Store, StoreOptions, StreamChunkOptions, StreamDirectionConflict, type TransportEstablishedNotify, TransportNegotiator, type TransportOfferRequest, type TransportOfferResponse, TransportSessionMismatchError, TransportSessionSignaling, TransportState, URUN_DEV_ENV, VISIBILITY_FIELD, type VideoStreamOptions, WIRE_MESSAGE_BUDGET, WT_CONTROL_FRAME_MAX, WT_DATA_STREAM_VERSION, WebRtcSession, WebTransportSession, type WhenLiveOptions, WtControlDecoder, type WtControlMessage, type WtDataEnvelope, type WtDataLaneSink, WtDataStreamParser, activationHintFrom, cameraCaptureAvailable, captureStillFromVideo, computeBackoffDelay, consumeWtDataStreams, createActivityTracker, createCameraWarp, createClientToken, createInputPresencePublisher, createRecordingsClient, createRuntimeArtifactsClient, createStore, describeSessionFailure, describeSessionPhase, encodeWtControlFrame, fitWithin, isDurationString, isRetryableSessionError, isWakingPhase, normalizeReferenceImage, normalizeRetention, observeLeaveConfirm, observePageLifecycle, observePageTeardown, parseDgramHeader, referenceImageErrorMessage, sessionFailureFromMediaError, sharedCaptureController, videoStream, whenLive, writeDgramHeader };