@urun-sh/core 0.2.6 → 0.2.8

package/dist/internal.mjs

@@ -1 +1,2 @@
-import{a as e,b as r,c as o,d as t,e as a,g as n,h as p,i as s,j as m,l as c,m as i,n as f,o as x}from"./chunk-H23H4OCS.mjs";export{e as ChannelMultiplexer,r as DeferredChannelMultiplexer,f as DeferredDocConnector,n as LoopbackStreamData,m as TransportSession,x as createPresence,i as createWebsocketDocConnector,c as deriveYjsServerUrl,a as ensureNodeWebRTC,o as isNodeRuntime,t as nodeMediasoupHandlerName,s as streamDataLabel,p as transportStreamData};
+import { createRequire as __urunCreateRequire } from 'node:module'; const require = globalThis.require ?? __urunCreateRequire(import.meta.url);
+import{A as f,B as x,C,D as l,a as e,b as r,q as o,r as t,s as a,u as n,v as p,w as s,x as m,y as c,z as i}from"./chunk-C2B5BLQW.mjs";export{e as ChannelMultiplexer,c as DOC_SYNC_WIRE_CONTRACT_VERSION,r as DeferredChannelMultiplexer,x as DeferredDocConnector,n as LoopbackStreamData,C as SessionDocumentImpl,m as TransportSession,l as createPresence,f as createWebsocketDocConnector,i as deriveYjsServerUrl,a as ensureNodeWebRTC,o as isNodeRuntime,t as nodeMediasoupHandlerName,s as streamDataLabel,p as transportStreamData};

package/dist/{stream-data-u76USIkQ.d.mts → stream-data-BS3Z4V1D.d.mts}

@@ -33,6 +33,8 @@ interface MediaRecorderChunkSourceOptions {
 
 declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?: MediaRecorderChunkSourceOptions): MediaChunkSource;
 
+declare const DOC_SYNC_WIRE_CONTRACT_VERSION = 1;
+
 interface DocConnection {
     
     readonly awareness: Awareness;
@@ -41,6 +43,8 @@ interface DocConnection {
     
     onSync(handler: (synced: boolean) => void): () => void;
     
+    ensureConnected?(): void;
+    
     destroy(): void;
 }
 
@@ -93,9 +97,15 @@ declare function createPresence(awareness: Awareness): Presence;
 
 type TransportState = 'connecting' | 'connected' | 'reconnecting' | 'renegotiating' | 'disconnected' | 'failed';
 
-type SessionPhaseName = 'idle' | 'queued' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
+type SessionPhaseName = 'idle' | 'queued' | 'unavailable' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
+
+interface RuntimeAvailability {
+    state: 'unavailable' | 'starting' | 'busy';
+    
+    reason?: string;
+}
 
-type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended';
+type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended' | 'runtime-failed';
 
 interface SessionPhaseError {
     
@@ -117,6 +127,10 @@ interface SessionPhase {
         depth: number;
     };
     
+    runtime?: RuntimeAvailability;
+    
+    wakingSince?: number;
+    
     requestId?: string;
     
     sessionId?: string;
@@ -143,6 +157,10 @@ interface SessionStatus {
         depth: number;
     };
     
+    runtime?: RuntimeAvailability;
+    
+    wakingSince?: number;
+    
     error?: SessionPhaseError;
 }
 
@@ -371,6 +389,10 @@ interface Session {
     
     readonly artifacts: RuntimeArtifactsAccessor;
     
+    recover(): void;
+    
+    onRecovery(hook: () => void): () => void;
+    
     disconnect(): void;
 }
 
@@ -610,6 +632,8 @@ declare class TransportSession {
     
     private _connectStartedAt;
     
+    private _wakingSince;
+    
     private _mediaMonitorTimer;
     
     private _lastInboundTotal;
@@ -748,6 +772,8 @@ declare class TransportSession {
     private _checkDecodeLiveness;
     
     private _renegotiate;
+    
+    recover(): void;
     private _attemptReconnect;
     private _connectUrls;
     private _connectOnce;
@@ -764,11 +790,74 @@ declare class TransportSession {
     
     private _setPhase;
     
+    reportAdmission(update: {
+        status: 'queued' | 'pending';
+        requestId?: string;
+        queue?: {
+            position: number;
+            depth: number;
+        };
+        runtime?: RuntimeAvailability;
+    }): void;
+    
     private _emitError;
     
     reportAllocationFailure(error: Error, httpStatus?: number): void;
 }
 
+declare class SessionDocumentImpl implements SessionDocument {
+    private _doc;
+    private _root;
+    private _awareness;
+    private _listeners;
+    private _key;
+    private _sessionId;
+    private _connection;
+    private _connUnsub;
+    
+    private _synced;
+    
+    private _syncWaiters;
+    
+    private _texts;
+    private _observer;
+    constructor(key: string, sessionId: string, connector?: DocConnector | null);
+    
+    get awareness(): Awareness;
+    
+    setSessionId(sessionId: string): void;
+    
+    get synced(): boolean;
+    
+    ensureConnected(): void;
+    
+    onSynced(handler: () => void): () => void;
+    
+    set(patch: Record<string, unknown>): void;
+    get(path?: string, defaultValue?: unknown): unknown;
+    on(event: 'change', handler: (snap: Record<string, unknown>) => void): () => void;
+    
+    text(field: string): SessionTextImpl;
+    dispose(): void;
+    private _markSynced;
+    
+    private applyPatch;
+    private snapshot;
+    private notify;
+}
+
+declare class SessionTextImpl implements SessionText {
+    private _ytext;
+    private _delta;
+    private _observer;
+    constructor(_ytext: Y.Text);
+    append(text: string): void;
+    toString(): string;
+    get length(): number;
+    on(event: 'delta', handler: (inserted: string) => void): () => void;
+    dispose(): void;
+}
+
 interface StreamDataTransport {
     
     readonly consumerId: string;
@@ -800,4 +889,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { createWebsocketDocConnector as $, type AccessTokenOptions as A, type SceneGraph as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, type Session as E, type SessionDocument as F, type SessionFailureKind as G, type SessionPhase as H, type SessionPhaseError as I, type SessionPhaseName as J, type SessionStartOptions as K, type Layer as L, type MediaChunkBinding as M, type SessionStatus as N, type SessionStream as O, type Presence as P, type SessionText as Q, type Recording as R, type SceneContext as S, type Store as T, type StoreOptions as U, type StreamChunkOptions as V, type StreamDataTransport as W, TransportSession as X, type TransportSessionOptions as Y, type TransportState as Z, createPresence as _, type App as a, deriveYjsServerUrl as a0, isPendingRecording as a1, mediaRecorderChunkSource as a2, streamDataLabel as a3, transportStreamData as a4, type AppOptions as b, type AttachOptions as c, type ChannelMessage as d, ChannelMultiplexer as e, type ChannelName as f, type ChunkReadable as g, DeferredDocConnector as h, type DocConnection as i, type DocConnector as j, type LayoutConfig as k, type LayoutContext as l, LoopbackStreamData as m, type MediaChunkSource as n, type MediaChunkSourceFactory as o, type MediaRecorderChunkSourceOptions as p, type PresenceState as q, type RecordingBucket as r, type RecordingLifecycle as s, type RecordingStatus as t, type RecordingsAccessor as u, type RequestOptions as v, type RequestStreamOptions as w, type RuntimeArtifact as x, type RuntimeArtifactDownload as y, type RuntimeArtifactsAccessor as z };
+export { type TransportSessionOptions as $, type AccessTokenOptions as A, type RuntimeArtifactsAccessor as B, type ChannelEndpoint as C, DOC_SYNC_WIRE_CONTRACT_VERSION as D, type RuntimeAvailability as E, type SceneGraph as F, type Session as G, type SessionDocument as H, SessionDocumentImpl as I, type SessionFailureKind as J, type SessionPhase as K, type Layer as L, type MediaChunkBinding as M, type SessionPhaseError as N, type SessionPhaseName as O, type Presence as P, type SessionStartOptions as Q, type Recording as R, type SceneContext as S, type SessionStatus as T, type SessionStream as U, type SessionText as V, type Store as W, type StoreOptions as X, type StreamChunkOptions as Y, type StreamDataTransport as Z, TransportSession as _, type App as a, type TransportState as a0, createPresence as a1, createWebsocketDocConnector as a2, deriveYjsServerUrl as a3, isPendingRecording as a4, mediaRecorderChunkSource as a5, streamDataLabel as a6, transportStreamData as a7, type AppOptions as b, type AttachOptions as c, type ChannelMessage as d, ChannelMultiplexer as e, type ChannelName as f, type ChunkReadable as g, DeferredChannelMultiplexer as h, DeferredDocConnector as i, type DocConnection as j, type DocConnector as k, type LayoutConfig as l, type LayoutContext as m, LoopbackStreamData as n, type MediaChunkSource as o, type MediaChunkSourceFactory as p, type MediaRecorderChunkSourceOptions as q, type PresenceState as r, type RecordingBucket as s, type RecordingLifecycle as t, type RecordingStatus as u, type RecordingsAccessor as v, type RequestOptions as w, type RequestStreamOptions as x, type RuntimeArtifact as y, type RuntimeArtifactDownload as z };

package/dist/{stream-data-u76USIkQ.d.ts → stream-data-BS3Z4V1D.d.ts}

@@ -33,6 +33,8 @@ interface MediaRecorderChunkSourceOptions {
 
 declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?: MediaRecorderChunkSourceOptions): MediaChunkSource;
 
+declare const DOC_SYNC_WIRE_CONTRACT_VERSION = 1;
+
 interface DocConnection {
     
     readonly awareness: Awareness;
@@ -41,6 +43,8 @@ interface DocConnection {
     
     onSync(handler: (synced: boolean) => void): () => void;
     
+    ensureConnected?(): void;
+    
     destroy(): void;
 }
 
@@ -93,9 +97,15 @@ declare function createPresence(awareness: Awareness): Presence;
 
 type TransportState = 'connecting' | 'connected' | 'reconnecting' | 'renegotiating' | 'disconnected' | 'failed';
 
-type SessionPhaseName = 'idle' | 'queued' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
+type SessionPhaseName = 'idle' | 'queued' | 'unavailable' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
+
+interface RuntimeAvailability {
+    state: 'unavailable' | 'starting' | 'busy';
+    
+    reason?: string;
+}
 
-type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended';
+type SessionFailureKind = 'create-failed' | 'never-live' | 'transport-failed' | 'media-permission' | 'ended' | 'runtime-failed';
 
 interface SessionPhaseError {
     
@@ -117,6 +127,10 @@ interface SessionPhase {
         depth: number;
     };
     
+    runtime?: RuntimeAvailability;
+    
+    wakingSince?: number;
+    
     requestId?: string;
     
     sessionId?: string;
@@ -143,6 +157,10 @@ interface SessionStatus {
         depth: number;
     };
     
+    runtime?: RuntimeAvailability;
+    
+    wakingSince?: number;
+    
     error?: SessionPhaseError;
 }
 
@@ -371,6 +389,10 @@ interface Session {
     
     readonly artifacts: RuntimeArtifactsAccessor;
     
+    recover(): void;
+    
+    onRecovery(hook: () => void): () => void;
+    
     disconnect(): void;
 }
 
@@ -610,6 +632,8 @@ declare class TransportSession {
     
     private _connectStartedAt;
     
+    private _wakingSince;
+    
     private _mediaMonitorTimer;
     
     private _lastInboundTotal;
@@ -748,6 +772,8 @@ declare class TransportSession {
     private _checkDecodeLiveness;
     
     private _renegotiate;
+    
+    recover(): void;
     private _attemptReconnect;
     private _connectUrls;
     private _connectOnce;
@@ -764,11 +790,74 @@ declare class TransportSession {
     
     private _setPhase;
     
+    reportAdmission(update: {
+        status: 'queued' | 'pending';
+        requestId?: string;
+        queue?: {
+            position: number;
+            depth: number;
+        };
+        runtime?: RuntimeAvailability;
+    }): void;
+    
     private _emitError;
     
     reportAllocationFailure(error: Error, httpStatus?: number): void;
 }
 
+declare class SessionDocumentImpl implements SessionDocument {
+    private _doc;
+    private _root;
+    private _awareness;
+    private _listeners;
+    private _key;
+    private _sessionId;
+    private _connection;
+    private _connUnsub;
+    
+    private _synced;
+    
+    private _syncWaiters;
+    
+    private _texts;
+    private _observer;
+    constructor(key: string, sessionId: string, connector?: DocConnector | null);
+    
+    get awareness(): Awareness;
+    
+    setSessionId(sessionId: string): void;
+    
+    get synced(): boolean;
+    
+    ensureConnected(): void;
+    
+    onSynced(handler: () => void): () => void;
+    
+    set(patch: Record<string, unknown>): void;
+    get(path?: string, defaultValue?: unknown): unknown;
+    on(event: 'change', handler: (snap: Record<string, unknown>) => void): () => void;
+    
+    text(field: string): SessionTextImpl;
+    dispose(): void;
+    private _markSynced;
+    
+    private applyPatch;
+    private snapshot;
+    private notify;
+}
+
+declare class SessionTextImpl implements SessionText {
+    private _ytext;
+    private _delta;
+    private _observer;
+    constructor(_ytext: Y.Text);
+    append(text: string): void;
+    toString(): string;
+    get length(): number;
+    on(event: 'delta', handler: (inserted: string) => void): () => void;
+    dispose(): void;
+}
+
 interface StreamDataTransport {
     
     readonly consumerId: string;
@@ -800,4 +889,4 @@ interface DataChannelTransport {
 
 declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
 
-export { createWebsocketDocConnector as $, type AccessTokenOptions as A, type SceneGraph as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, type Session as E, type SessionDocument as F, type SessionFailureKind as G, type SessionPhase as H, type SessionPhaseError as I, type SessionPhaseName as J, type SessionStartOptions as K, type Layer as L, type MediaChunkBinding as M, type SessionStatus as N, type SessionStream as O, type Presence as P, type SessionText as Q, type Recording as R, type SceneContext as S, type Store as T, type StoreOptions as U, type StreamChunkOptions as V, type StreamDataTransport as W, TransportSession as X, type TransportSessionOptions as Y, type TransportState as Z, createPresence as _, type App as a, deriveYjsServerUrl as a0, isPendingRecording as a1, mediaRecorderChunkSource as a2, streamDataLabel as a3, transportStreamData as a4, type AppOptions as b, type AttachOptions as c, type ChannelMessage as d, ChannelMultiplexer as e, type ChannelName as f, type ChunkReadable as g, DeferredDocConnector as h, type DocConnection as i, type DocConnector as j, type LayoutConfig as k, type LayoutContext as l, LoopbackStreamData as m, type MediaChunkSource as n, type MediaChunkSourceFactory as o, type MediaRecorderChunkSourceOptions as p, type PresenceState as q, type RecordingBucket as r, type RecordingLifecycle as s, type RecordingStatus as t, type RecordingsAccessor as u, type RequestOptions as v, type RequestStreamOptions as w, type RuntimeArtifact as x, type RuntimeArtifactDownload as y, type RuntimeArtifactsAccessor as z };
+export { type TransportSessionOptions as $, type AccessTokenOptions as A, type RuntimeArtifactsAccessor as B, type ChannelEndpoint as C, DOC_SYNC_WIRE_CONTRACT_VERSION as D, type RuntimeAvailability as E, type SceneGraph as F, type Session as G, type SessionDocument as H, SessionDocumentImpl as I, type SessionFailureKind as J, type SessionPhase as K, type Layer as L, type MediaChunkBinding as M, type SessionPhaseError as N, type SessionPhaseName as O, type Presence as P, type SessionStartOptions as Q, type Recording as R, type SceneContext as S, type SessionStatus as T, type SessionStream as U, type SessionText as V, type Store as W, type StoreOptions as X, type StreamChunkOptions as Y, type StreamDataTransport as Z, TransportSession as _, type App as a, type TransportState as a0, createPresence as a1, createWebsocketDocConnector as a2, deriveYjsServerUrl as a3, isPendingRecording as a4, mediaRecorderChunkSource as a5, streamDataLabel as a6, transportStreamData as a7, type AppOptions as b, type AttachOptions as c, type ChannelMessage as d, ChannelMultiplexer as e, type ChannelName as f, type ChunkReadable as g, DeferredChannelMultiplexer as h, DeferredDocConnector as i, type DocConnection as j, type DocConnector as k, type LayoutConfig as l, type LayoutContext as m, LoopbackStreamData as n, type MediaChunkSource as o, type MediaChunkSourceFactory as p, type MediaRecorderChunkSourceOptions as q, type PresenceState as r, type RecordingBucket as s, type RecordingLifecycle as t, type RecordingStatus as u, type RecordingsAccessor as v, type RequestOptions as w, type RequestStreamOptions as x, type RuntimeArtifact as y, type RuntimeArtifactDownload as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urun-sh/core",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Core transport and channel primitives for the urun TypeScript SDK",
   "repository": {
     "type": "git",
@@ -17,6 +17,21 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "edge-light": {
+        "types": "./dist/index.browser.d.ts",
+        "import": "./dist/index.browser.mjs",
+        "require": "./dist/index.browser.js"
+      },
+      "workerd": {
+        "types": "./dist/index.browser.d.ts",
+        "import": "./dist/index.browser.mjs",
+        "require": "./dist/index.browser.js"
+      },
+      "worker": {
+        "types": "./dist/index.browser.d.ts",
+        "import": "./dist/index.browser.mjs",
+        "require": "./dist/index.browser.js"
+      },
       "browser": {
         "types": "./dist/index.browser.d.ts",
         "import": "./dist/index.browser.mjs",
@@ -27,6 +42,21 @@
     },
     "./internal": {
       "types": "./dist/internal.d.ts",
+      "edge-light": {
+        "types": "./dist/internal.browser.d.ts",
+        "import": "./dist/internal.browser.mjs",
+        "require": "./dist/internal.browser.js"
+      },
+      "workerd": {
+        "types": "./dist/internal.browser.d.ts",
+        "import": "./dist/internal.browser.mjs",
+        "require": "./dist/internal.browser.js"
+      },
+      "worker": {
+        "types": "./dist/internal.browser.d.ts",
+        "import": "./dist/internal.browser.mjs",
+        "require": "./dist/internal.browser.js"
+      },
       "browser": {
         "types": "./dist/internal.browser.d.ts",
         "import": "./dist/internal.browser.mjs",
@@ -69,6 +99,7 @@
   },
   "license": "MIT",
   "dependencies": {
+    "debug": "^4.4.3",
     "y-protocols": "1.0.7",
     "y-websocket": "3.0.0",
     "yjs": "^13.6.31"