@urun-sh/core 0.2.46 → 0.2.48

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 a,J as n,L as s,M as p,N as m,R as c,S as i,T as l,U as f,V as x,W as S,X as C,a as e,b as o}from"./chunk-DUCJ3UFC.mjs";export{e as ChannelMultiplexer,i as DOC_SYNC_WIRE_CONTRACT_VERSION,o as DeferredChannelMultiplexer,x as DeferredDocConnector,s as LoopbackStreamData,S as SessionDocumentImpl,c as TransportSession,r as allocateSession,C as createPresence,f as createWebsocketDocConnector,l as deriveYjsServerUrl,n as ensureNodeWebRTC,t as isNodeRuntime,a as nodeMediasoupHandlerName,m as streamDataLabel,p as transportStreamData};
+import{E as r,H as t,I as n,J as a,L as s,M as p,N as m,R as c,S as i,T as l,U as S,V as f,W as x,X as C,a as e,b as o}from"./chunk-BQIH7RYF.mjs";export{e as ChannelMultiplexer,i as DOC_SYNC_WIRE_CONTRACT_VERSION,o as DeferredChannelMultiplexer,f as DeferredDocConnector,s as LoopbackStreamData,x as SessionDocumentImpl,c as TransportSession,r as allocateSession,C as createPresence,S as createWebsocketDocConnector,l as deriveYjsServerUrl,a as ensureNodeWebRTC,t as isNodeRuntime,n as nodeMediasoupHandlerName,m as streamDataLabel,p as transportStreamData};

package/dist/{stream-data-a_RrPi2p.d.mts → stream-data-TWBl_kh7.d.mts}

@@ -35,6 +35,19 @@ declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?:
 
 declare const DOC_SYNC_WIRE_CONTRACT_VERSION = 1;
 
+interface DocConnectionState {
+    
+    connected: boolean;
+    
+    consecutiveFailures: number;
+    
+    lastCloseCode: number | null;
+    
+    lastCloseReason: string | null;
+}
+
+type DocTokenSupplier = () => string | undefined | Promise<string | undefined>;
+
 interface DocConnection {
     
     readonly awareness: Awareness;
@@ -45,6 +58,8 @@ interface DocConnection {
     
     ensureConnected?(): void;
     
+    onConnectionState?(handler: (state: DocConnectionState) => void): () => void;
+    
     destroy(): void;
 }
 
@@ -58,9 +73,13 @@ interface WebsocketDocConnectorOptions {
     
     sessionId: string;
     
-    token?: string;
+    token?: string | DocTokenSupplier;
     
     WebSocketPolyfill?: typeof WebSocket;
+    
+    maxBackoffTimeMs?: number;
+    
+    dialTimeoutMs?: number;
 }
 
 declare function createWebsocketDocConnector(opts: WebsocketDocConnectorOptions): DocConnector;
@@ -104,8 +123,39 @@ interface RuntimeAvailability {
     state: 'unavailable' | 'starting' | 'busy';
     
     reason?: string;
+    
+    wake?: RuntimeWakeDetail;
+}
+
+type RuntimeWakeReasonCode = 'capture-attested' | 'no-portable-golden' | 'portable-golden-release-mismatch' | 'portable-golden-attestation-invalid';
+
+interface RuntimeWakeGolden {
+    snapshotId: string;
+    snapshotCompatKey: string;
+    artifactSizeBytes: number;
+    durableArenaBytes: number;
+    volatileArenaBytes: 0;
+    uncoveredWeightBytes: number;
+}
+interface RuntimeWakeDetailBase {
+    schema: 'urun.runtime.wake.v1';
+    expectationBasis: 'snapshot-registry';
+    restoreObservation: 'not-observed';
 }
 
+type RuntimeWakeDetail = (RuntimeWakeDetailBase & {
+    portability: 'portable';
+    expectedWakePath: 'portable-golden-restore';
+    reasonCode: 'capture-attested';
+    golden: RuntimeWakeGolden;
+}) | (RuntimeWakeDetailBase & {
+    portability: 'none';
+    expectedWakePath: 'cold-boot';
+    reasonCode: Exclude<RuntimeWakeReasonCode, 'capture-attested'>;
+    
+    golden?: never;
+});
+
 type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended' | 'runtime-failed' | 'expired' | 'produce-timeout';
 
 interface SessionPhaseError {
@@ -278,6 +328,8 @@ interface SessionDocument {
     readonly synced: boolean;
     
     onSynced(handler: () => void): () => void;
+    
+    onConnectionState?(handler: (state: DocConnectionState) => void): () => void;
 }
 
 interface SessionStream {
@@ -527,6 +579,8 @@ interface SessionGatewayResponse {
     
     runtime_reason?: string;
     
+    runtime_wake?: unknown;
+    
     ends_at?: string;
     error_code?: string;
     error_message?: string;
@@ -748,28 +802,12 @@ declare class TransportSession {
     
     private _wakingSince;
     
-    private _mediaMonitorTimer;
-    
-    private _lastInboundTotal;
-    
-    private _mediaEverFlowed;
-    
-    private _lastInboundAdvanceAt;
+    private _mediaProbeTimer;
     
-    private _mediaDeathHandled;
-    
-    private _decodeSignalSeen;
-    
-    private _lastFramesDecoded;
-    
-    private _lastDecodeAdvanceAt;
+    private _joinProbes;
     
     private _decodeDeathHandled;
     
-    private _latestInboundSample;
-    
-    private _decodeWindowStartSample;
-    
     private _selectedCandidatePair;
     
     private _candidatePairDiagnosticEmitted;
@@ -902,13 +940,14 @@ declare class TransportSession {
     
     private _closeConsumersByProducer;
     private _mediaPollMs;
-    private _mediaStallTimeoutMs;
     
-    private _startMediaMonitor;
-    private _stopMediaMonitor;
-    private _sampleMediaLiveness;
+    private _firstFrameWindowMs;
+    
+    private _startMediaProbe;
+    private _stopMediaProbe;
     
-    private _checkDecodeLiveness;
+    private _resetJoinProbes;
+    private _sampleMediaArrival;
     
     private _renegotiate;
     
@@ -974,6 +1013,8 @@ declare class SessionDocumentImpl implements SessionDocument {
     
     ensureConnected(): void;
     
+    onConnectionState(handler: (state: DocConnectionState) => void): () => void;
+    
     onSynced(handler: () => void): () => void;
     
     set(patch: Record<string, unknown>): void;
@@ -1032,4 +1073,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { type SessionStatus as $, type AccessTokenOptions$1 as A, type RecordingLifecycle as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type RecordingStatus as E, type RecordingsAccessor as F, type ReleaseSessionBeaconOptions as G, type RequestOptions as H, type RequestStreamOptions as I, type RuntimeArtifact as J, type RuntimeArtifactDownload as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RuntimeArtifactsAccessor as N, type RuntimeAvailability as O, type Presence as P, type SessionDiagnostic as Q, type Recording as R, type Session as S, type SessionDocument as T, SessionDocumentImpl as U, type SessionEndResult as V, type SessionFailureKind as W, type SessionPhase as X, type SessionPhaseError as Y, type SessionPhaseName as Z, type SessionStartOptions as _, type AccessTokenOptions as a, type SessionStream as a0, type SessionText as a1, type Store as a2, type StoreOptions as a3, type StreamChunkOptions as a4, type StreamDataTransport as a5, TransportSession as a6, type TransportSessionOptions as a7, type TransportState as a8, allocateSession as a9, createPresence as aa, createWebsocketDocConnector as ab, deriveYjsServerUrl as ac, derivedLegName as ad, derivedLegRole as ae, isPendingRecording as af, mediaRecorderChunkSource as ag, prewake as ah, releaseSessionBeacon as ai, streamDataLabel as aj, transportStreamData as ak, 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 ChannelMessage as i, ChannelMultiplexer as j, type ChannelName as k, type ChunkReadable as l, DOC_SYNC_WIRE_CONTRACT_VERSION as m, DeferredChannelMultiplexer as n, DeferredDocConnector as o, type DerivedLegRole as p, type DocConnection as q, type DocConnector as r, type MediaChunkSource as s, type MediaChunkSourceFactory as t, type MediaRecorderChunkSourceOptions as u, type PresenceState as v, type PrewakeOptions as w, type PrewakeResult as x, type PrewakeStatus as y, type RecordingBucket as z };
+export { type SessionFailureKind as $, type AccessTokenOptions$1 as A, type PrewakeStatus as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type RecordingBucket as E, type RecordingLifecycle as F, type RecordingStatus as G, type RecordingsAccessor as H, type ReleaseSessionBeaconOptions as I, type RequestOptions as J, type RequestStreamOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RuntimeArtifact as N, type RuntimeArtifactDownload as O, type Presence as P, type RuntimeArtifactsAccessor as Q, type Recording as R, type RuntimeAvailability as S, type RuntimeWakeDetail as T, type RuntimeWakeGolden as U, type RuntimeWakeReasonCode as V, type Session as W, type SessionDiagnostic as X, type SessionDocument as Y, SessionDocumentImpl as Z, type SessionEndResult as _, type AccessTokenOptions as a, type SessionPhase as a0, type SessionPhaseError as a1, type SessionPhaseName as a2, type SessionStartOptions as a3, type SessionStatus as a4, type SessionStream as a5, type SessionText as a6, type Store as a7, type StoreOptions as a8, type StreamChunkOptions as a9, type StreamDataTransport as aa, TransportSession as ab, type TransportSessionOptions as ac, type TransportState as ad, allocateSession as ae, createPresence as af, createWebsocketDocConnector as ag, deriveYjsServerUrl as ah, derivedLegName as ai, derivedLegRole as aj, isPendingRecording as ak, mediaRecorderChunkSource as al, prewake as am, releaseSessionBeacon as an, streamDataLabel as ao, transportStreamData as ap, 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 ChannelMessage as i, ChannelMultiplexer as j, type ChannelName as k, type ChunkReadable as l, DOC_SYNC_WIRE_CONTRACT_VERSION as m, DeferredChannelMultiplexer as n, DeferredDocConnector as o, type DerivedLegRole as p, type DocConnection as q, type DocConnectionState as r, type DocConnector as s, type DocTokenSupplier as t, type MediaChunkSource as u, type MediaChunkSourceFactory as v, type MediaRecorderChunkSourceOptions as w, type PresenceState as x, type PrewakeOptions as y, type PrewakeResult as z };

package/dist/{stream-data-a_RrPi2p.d.ts → stream-data-TWBl_kh7.d.ts}

@@ -35,6 +35,19 @@ declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?:
 
 declare const DOC_SYNC_WIRE_CONTRACT_VERSION = 1;
 
+interface DocConnectionState {
+    
+    connected: boolean;
+    
+    consecutiveFailures: number;
+    
+    lastCloseCode: number | null;
+    
+    lastCloseReason: string | null;
+}
+
+type DocTokenSupplier = () => string | undefined | Promise<string | undefined>;
+
 interface DocConnection {
     
     readonly awareness: Awareness;
@@ -45,6 +58,8 @@ interface DocConnection {
     
     ensureConnected?(): void;
     
+    onConnectionState?(handler: (state: DocConnectionState) => void): () => void;
+    
     destroy(): void;
 }
 
@@ -58,9 +73,13 @@ interface WebsocketDocConnectorOptions {
     
     sessionId: string;
     
-    token?: string;
+    token?: string | DocTokenSupplier;
     
     WebSocketPolyfill?: typeof WebSocket;
+    
+    maxBackoffTimeMs?: number;
+    
+    dialTimeoutMs?: number;
 }
 
 declare function createWebsocketDocConnector(opts: WebsocketDocConnectorOptions): DocConnector;
@@ -104,8 +123,39 @@ interface RuntimeAvailability {
     state: 'unavailable' | 'starting' | 'busy';
     
     reason?: string;
+    
+    wake?: RuntimeWakeDetail;
+}
+
+type RuntimeWakeReasonCode = 'capture-attested' | 'no-portable-golden' | 'portable-golden-release-mismatch' | 'portable-golden-attestation-invalid';
+
+interface RuntimeWakeGolden {
+    snapshotId: string;
+    snapshotCompatKey: string;
+    artifactSizeBytes: number;
+    durableArenaBytes: number;
+    volatileArenaBytes: 0;
+    uncoveredWeightBytes: number;
+}
+interface RuntimeWakeDetailBase {
+    schema: 'urun.runtime.wake.v1';
+    expectationBasis: 'snapshot-registry';
+    restoreObservation: 'not-observed';
 }
 
+type RuntimeWakeDetail = (RuntimeWakeDetailBase & {
+    portability: 'portable';
+    expectedWakePath: 'portable-golden-restore';
+    reasonCode: 'capture-attested';
+    golden: RuntimeWakeGolden;
+}) | (RuntimeWakeDetailBase & {
+    portability: 'none';
+    expectedWakePath: 'cold-boot';
+    reasonCode: Exclude<RuntimeWakeReasonCode, 'capture-attested'>;
+    
+    golden?: never;
+});
+
 type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended' | 'runtime-failed' | 'expired' | 'produce-timeout';
 
 interface SessionPhaseError {
@@ -278,6 +328,8 @@ interface SessionDocument {
     readonly synced: boolean;
     
     onSynced(handler: () => void): () => void;
+    
+    onConnectionState?(handler: (state: DocConnectionState) => void): () => void;
 }
 
 interface SessionStream {
@@ -527,6 +579,8 @@ interface SessionGatewayResponse {
     
     runtime_reason?: string;
     
+    runtime_wake?: unknown;
+    
     ends_at?: string;
     error_code?: string;
     error_message?: string;
@@ -748,28 +802,12 @@ declare class TransportSession {
     
     private _wakingSince;
     
-    private _mediaMonitorTimer;
-    
-    private _lastInboundTotal;
-    
-    private _mediaEverFlowed;
-    
-    private _lastInboundAdvanceAt;
+    private _mediaProbeTimer;
     
-    private _mediaDeathHandled;
-    
-    private _decodeSignalSeen;
-    
-    private _lastFramesDecoded;
-    
-    private _lastDecodeAdvanceAt;
+    private _joinProbes;
     
     private _decodeDeathHandled;
     
-    private _latestInboundSample;
-    
-    private _decodeWindowStartSample;
-    
     private _selectedCandidatePair;
     
     private _candidatePairDiagnosticEmitted;
@@ -902,13 +940,14 @@ declare class TransportSession {
     
     private _closeConsumersByProducer;
     private _mediaPollMs;
-    private _mediaStallTimeoutMs;
     
-    private _startMediaMonitor;
-    private _stopMediaMonitor;
-    private _sampleMediaLiveness;
+    private _firstFrameWindowMs;
+    
+    private _startMediaProbe;
+    private _stopMediaProbe;
     
-    private _checkDecodeLiveness;
+    private _resetJoinProbes;
+    private _sampleMediaArrival;
     
     private _renegotiate;
     
@@ -974,6 +1013,8 @@ declare class SessionDocumentImpl implements SessionDocument {
     
     ensureConnected(): void;
     
+    onConnectionState(handler: (state: DocConnectionState) => void): () => void;
+    
     onSynced(handler: () => void): () => void;
     
     set(patch: Record<string, unknown>): void;
@@ -1032,4 +1073,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { type SessionStatus as $, type AccessTokenOptions$1 as A, type RecordingLifecycle as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type RecordingStatus as E, type RecordingsAccessor as F, type ReleaseSessionBeaconOptions as G, type RequestOptions as H, type RequestStreamOptions as I, type RuntimeArtifact as J, type RuntimeArtifactDownload as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RuntimeArtifactsAccessor as N, type RuntimeAvailability as O, type Presence as P, type SessionDiagnostic as Q, type Recording as R, type Session as S, type SessionDocument as T, SessionDocumentImpl as U, type SessionEndResult as V, type SessionFailureKind as W, type SessionPhase as X, type SessionPhaseError as Y, type SessionPhaseName as Z, type SessionStartOptions as _, type AccessTokenOptions as a, type SessionStream as a0, type SessionText as a1, type Store as a2, type StoreOptions as a3, type StreamChunkOptions as a4, type StreamDataTransport as a5, TransportSession as a6, type TransportSessionOptions as a7, type TransportState as a8, allocateSession as a9, createPresence as aa, createWebsocketDocConnector as ab, deriveYjsServerUrl as ac, derivedLegName as ad, derivedLegRole as ae, isPendingRecording as af, mediaRecorderChunkSource as ag, prewake as ah, releaseSessionBeacon as ai, streamDataLabel as aj, transportStreamData as ak, 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 ChannelMessage as i, ChannelMultiplexer as j, type ChannelName as k, type ChunkReadable as l, DOC_SYNC_WIRE_CONTRACT_VERSION as m, DeferredChannelMultiplexer as n, DeferredDocConnector as o, type DerivedLegRole as p, type DocConnection as q, type DocConnector as r, type MediaChunkSource as s, type MediaChunkSourceFactory as t, type MediaRecorderChunkSourceOptions as u, type PresenceState as v, type PrewakeOptions as w, type PrewakeResult as x, type PrewakeStatus as y, type RecordingBucket as z };
+export { type SessionFailureKind as $, type AccessTokenOptions$1 as A, type PrewakeStatus as B, type ChannelEndpoint as C, DERIVED_LEG_SEP as D, type RecordingBucket as E, type RecordingLifecycle as F, type RecordingStatus as G, type RecordingsAccessor as H, type ReleaseSessionBeaconOptions as I, type RequestOptions as J, type RequestStreamOptions as K, LoopbackStreamData as L, type MediaChunkBinding as M, type RuntimeArtifact as N, type RuntimeArtifactDownload as O, type Presence as P, type RuntimeArtifactsAccessor as Q, type Recording as R, type RuntimeAvailability as S, type RuntimeWakeDetail as T, type RuntimeWakeGolden as U, type RuntimeWakeReasonCode as V, type Session as W, type SessionDiagnostic as X, type SessionDocument as Y, SessionDocumentImpl as Z, type SessionEndResult as _, type AccessTokenOptions as a, type SessionPhase as a0, type SessionPhaseError as a1, type SessionPhaseName as a2, type SessionStartOptions as a3, type SessionStatus as a4, type SessionStream as a5, type SessionText as a6, type Store as a7, type StoreOptions as a8, type StreamChunkOptions as a9, type StreamDataTransport as aa, TransportSession as ab, type TransportSessionOptions as ac, type TransportState as ad, allocateSession as ae, createPresence as af, createWebsocketDocConnector as ag, deriveYjsServerUrl as ah, derivedLegName as ai, derivedLegRole as aj, isPendingRecording as ak, mediaRecorderChunkSource as al, prewake as am, releaseSessionBeacon as an, streamDataLabel as ao, transportStreamData as ap, 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 ChannelMessage as i, ChannelMultiplexer as j, type ChannelName as k, type ChunkReadable as l, DOC_SYNC_WIRE_CONTRACT_VERSION as m, DeferredChannelMultiplexer as n, DeferredDocConnector as o, type DerivedLegRole as p, type DocConnection as q, type DocConnectionState as r, type DocConnector as s, type DocTokenSupplier as t, type MediaChunkSource as u, type MediaChunkSourceFactory as v, type MediaRecorderChunkSourceOptions as w, type PresenceState as x, type PrewakeOptions as y, type PrewakeResult as z };

package/package.json

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