@urun-sh/core 0.1.48 → 0.2.0

package/dist/internal.mjs

@@ -1 +1 @@
-import{a as e,b as o,c as r,d as n,e as t,g as s,h as p,i as a}from"./chunk-DFVMGNRH.mjs";export{e as ChannelMultiplexer,o as DeferredChannelMultiplexer,a as TransportSession,p as decodeDocSyncFrame,s as encodeDocSyncFrame,t as ensureNodeWebRTC,r as isNodeRuntime,n as nodeMediasoupHandlerName};
+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-2TYDFOWI.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};

package/dist/{transport-C3iRb9nz.d.mts → stream-data-BQHZia_W.d.mts}

@@ -1,4 +1,5 @@
-
+import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
 
 interface MediaChunkSource {
     
@@ -32,6 +33,64 @@ interface MediaRecorderChunkSourceOptions {
 
 declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?: MediaRecorderChunkSourceOptions): MediaChunkSource;
 
+interface DocConnection {
+    
+    readonly awareness: Awareness;
+    
+    readonly synced: boolean;
+    
+    onSync(handler: (synced: boolean) => void): () => void;
+    
+    destroy(): void;
+}
+
+type DocConnector = (docName: string, doc: Y.Doc, awareness: Awareness) => DocConnection;
+
+declare function deriveYjsServerUrl(signalingWsUrl: string): string;
+
+interface WebsocketDocConnectorOptions {
+    
+    serverUrl: string;
+    
+    sessionId: string;
+    
+    token?: string;
+    
+    WebSocketPolyfill?: typeof WebSocket;
+}
+
+declare function createWebsocketDocConnector(opts: WebsocketDocConnectorOptions): DocConnector;
+
+declare class DeferredDocConnector {
+    private _target;
+    private _bridges;
+    
+    readonly connect: DocConnector;
+    
+    get connected(): boolean;
+    
+    setTarget(target: DocConnector): void;
+}
+
+type PresenceState = Record<string, unknown>;
+
+interface Presence {
+    
+    readonly clientId: number;
+    
+    set(state: PresenceState | null): void;
+    
+    setField(field: string, value: unknown): void;
+    
+    getLocal(): PresenceState | null;
+    
+    getStates(): Map<number, PresenceState>;
+    
+    on(event: 'change', handler: (states: Map<number, PresenceState>) => void): () => void;
+}
+
+declare function createPresence(awareness: Awareness): Presence;
+
 type TransportState = 'connecting' | 'connected' | 'reconnecting' | 'renegotiating' | 'disconnected' | 'failed';
 
 type SessionPhaseName = 'idle' | 'queued' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
@@ -259,6 +318,8 @@ interface Session {
     
     doc(key: string): SessionDocument;
     
+    readonly presence: Presence;
+    
     request(payload: unknown, options?: RequestOptions): Promise<unknown>;
     
     requestStream(payload: unknown, options?: RequestStreamOptions): AsyncIterable<string>;
@@ -267,9 +328,71 @@ interface Session {
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
     
+    readonly recordings: RecordingsAccessor;
+    
     disconnect(): void;
 }
 
+type RecordingBucket = 'temp' | 'pinned';
+
+type RecordingLifecycle = 'temp' | 'pinned' | 'permanent';
+
+type RecordingStatus = 'active' | 'deleting' | 'deleted' | 'pending_pin' | 'pending_unpin' | 'pending_permanent' | 'pending_delete';
+
+interface Recording {
+    
+    id: string;
+    
+    org_id: string;
+    
+    session_id: string;
+    
+    stream_name: string;
+    
+    bucket: RecordingBucket;
+    
+    s3_key: string;
+    
+    init_key: string;
+    
+    manifest_key: string;
+    
+    expires_at: string | null;
+    
+    lifecycle: RecordingLifecycle;
+    
+    retention: string | null;
+    
+    size_bytes: number | null;
+    
+    duration_s: number | null;
+    
+    status: RecordingStatus;
+    
+    created_at: string;
+    
+    updated_at: string;
+}
+
+declare function isPendingRecording(recording: Pick<Recording, 'status'>): boolean;
+
+interface RecordingsAccessor {
+    
+    list(sessionId?: string): Promise<Recording[]>;
+    
+    get(id: string): Promise<Recording>;
+    
+    retain(id: string, duration: string): Promise<Recording>;
+    
+    pin(id: string): Promise<Recording>;
+    
+    unpin(id: string): Promise<Recording>;
+    
+    permanent(id: string): Promise<Recording>;
+    
+    delete(id: string): Promise<Recording>;
+}
+
 interface AppOptions {
     
     baseUrl: string;
@@ -283,6 +406,8 @@ interface AppOptions {
     getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
+    
+    functionsUrl?: string;
 }
 interface AccessTokenOptions {
     forceRefresh?: boolean;
@@ -302,6 +427,8 @@ interface AttachOptions {
     getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
+    
+    functionsUrl?: string;
 }
 
 interface App {
@@ -351,13 +478,7 @@ interface TransportConnection {
     
     iceServers?: RTCIceServer[];
 }
-
-declare function encodeDocSyncFrame(docKey: string, payload: Uint8Array): Uint8Array;
-
-declare function decodeDocSyncFrame(frame: Uint8Array): {
-    docKey: string;
-    payload: Uint8Array;
-} | null;
+declare function streamDataLabel(name: string): string;
 interface TransportEvents {
     connected: () => void;
     disconnected: () => void;
@@ -366,10 +487,6 @@ interface TransportEvents {
     started: () => void;
     audioTransportReady: () => void;
     
-    docSync: (docKey: string, payload: Uint8Array) => void;
-    
-    docSyncReady: () => void;
-    
     stateChange: (state: TransportState) => void;
     
     phase: (phase: SessionPhase) => void;
@@ -439,6 +556,16 @@ declare class TransportSession {
     
     private _pendingStreamSubscribes;
     
+    private _streamDataHandlers;
+    
+    private _dataProducers;
+    
+    private _dataProducerPromises;
+    
+    private _dataConsumers;
+    
+    private _pendingDataProduce;
+    
     get consumerId(): string;
     get state(): TransportState;
     
@@ -467,13 +594,17 @@ declare class TransportSession {
     on<E extends keyof TransportEvents>(event: E, handler: TransportEvents[E]): () => void;
     sendInput(data: Record<string, unknown>, sequence?: number): void;
     
-    sendDocSync(docKey: string, payload: Uint8Array): void;
+    onStreamData(name: string, handler: (payload: unknown) => void): () => void;
     
-    onDocSync(docKey: string, handler: (payload: Uint8Array) => void): () => void;
+    sendStreamData(name: string, payload: unknown, _options?: {
+        to?: string;
+    }): void;
+    
+    private _ensureDataProducer;
     
-    onDocSyncReady(handler: () => void): () => void;
+    private _dispatchStreamData;
     
-    private _emitDocSyncFrame;
+    private _streamNameFromLabel;
     addTrack(track: MediaStreamTrack, name?: string): Promise<void>;
     removeTrack(): void;
     
@@ -502,6 +633,8 @@ declare class TransportSession {
     
     private _failoverRecvToTcp;
     private _onCreateSendTransport;
+    
+    private _onConsumeData;
     private _onConsume;
     private _mediaPollMs;
     private _mediaStallTimeoutMs;
@@ -519,6 +652,8 @@ declare class TransportSession {
     
     private _scheduleReconnectBudgetReset;
     private _clearReconnectBudgetReset;
+    
+    private _cleanupDataChannels;
     private _cleanupMedia;
     private _send;
     private _setState;
@@ -528,4 +663,35 @@ declare class TransportSession {
     private _emitError;
 }
 
-export { type App as A, encodeDocSyncFrame as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, mediaRecorderChunkSource as E, type Layer as L, type MediaChunkBinding as M, type RequestOptions as R, type SceneContext as S, TransportSession as T, type AppOptions as a, type AttachOptions as b, type ChannelMessage as c, ChannelMultiplexer as d, type ChannelName as e, type ChunkReadable as f, type LayoutConfig as g, type LayoutContext as h, type MediaChunkSource as i, type MediaChunkSourceFactory as j, type MediaRecorderChunkSourceOptions as k, type RequestStreamOptions as l, type SceneGraph as m, type Session as n, type SessionDocument as o, type SessionPhase as p, type SessionPhaseName as q, type SessionStartOptions as r, type SessionStream as s, type SessionText as t, type Store as u, type StoreOptions as v, type StreamChunkOptions as w, type TransportSessionOptions as x, type TransportState as y, decodeDocSyncFrame as z };
+interface StreamDataTransport {
+    
+    readonly consumerId: string;
+    
+    onData(name: string, handler: (payload: unknown) => void): () => void;
+    
+    sendData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+declare class LoopbackStreamData implements StreamDataTransport {
+    readonly consumerId: string;
+    private _handlers;
+    constructor(consumerId?: string);
+    onData(name: string, handler: (payload: unknown) => void): () => void;
+    sendData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+interface DataChannelTransport {
+    readonly consumerId: string;
+    onStreamData(name: string, handler: (payload: unknown) => void): () => void;
+    sendStreamData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
+
+export { type AccessTokenOptions as A, type SessionPhase as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, type SessionPhaseName as E, type SessionStartOptions as F, type SessionStream as G, type SessionText as H, type Store as I, type StoreOptions as J, type StreamChunkOptions as K, type Layer as L, type MediaChunkBinding as M, type StreamDataTransport as N, type TransportSessionOptions as O, type Presence as P, type TransportState as Q, type Recording as R, type SceneContext as S, TransportSession as T, createPresence as U, createWebsocketDocConnector as V, deriveYjsServerUrl as W, isPendingRecording as X, mediaRecorderChunkSource as Y, streamDataLabel as Z, transportStreamData as _, type App as a, 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 SceneGraph as x, type Session as y, type SessionDocument as z };

package/dist/{transport-C3iRb9nz.d.ts → stream-data-BQHZia_W.d.ts}

@@ -1,4 +1,5 @@
-
+import * as Y from 'yjs';
+import { Awareness } from 'y-protocols/awareness';
 
 interface MediaChunkSource {
     
@@ -32,6 +33,64 @@ interface MediaRecorderChunkSourceOptions {
 
 declare function mediaRecorderChunkSource(binding: MediaChunkBinding, options?: MediaRecorderChunkSourceOptions): MediaChunkSource;
 
+interface DocConnection {
+    
+    readonly awareness: Awareness;
+    
+    readonly synced: boolean;
+    
+    onSync(handler: (synced: boolean) => void): () => void;
+    
+    destroy(): void;
+}
+
+type DocConnector = (docName: string, doc: Y.Doc, awareness: Awareness) => DocConnection;
+
+declare function deriveYjsServerUrl(signalingWsUrl: string): string;
+
+interface WebsocketDocConnectorOptions {
+    
+    serverUrl: string;
+    
+    sessionId: string;
+    
+    token?: string;
+    
+    WebSocketPolyfill?: typeof WebSocket;
+}
+
+declare function createWebsocketDocConnector(opts: WebsocketDocConnectorOptions): DocConnector;
+
+declare class DeferredDocConnector {
+    private _target;
+    private _bridges;
+    
+    readonly connect: DocConnector;
+    
+    get connected(): boolean;
+    
+    setTarget(target: DocConnector): void;
+}
+
+type PresenceState = Record<string, unknown>;
+
+interface Presence {
+    
+    readonly clientId: number;
+    
+    set(state: PresenceState | null): void;
+    
+    setField(field: string, value: unknown): void;
+    
+    getLocal(): PresenceState | null;
+    
+    getStates(): Map<number, PresenceState>;
+    
+    on(event: 'change', handler: (states: Map<number, PresenceState>) => void): () => void;
+}
+
+declare function createPresence(awareness: Awareness): Presence;
+
 type TransportState = 'connecting' | 'connected' | 'reconnecting' | 'renegotiating' | 'disconnected' | 'failed';
 
 type SessionPhaseName = 'idle' | 'queued' | 'provisioning' | 'connecting' | 'live' | 'error' | 'ended';
@@ -259,6 +318,8 @@ interface Session {
     
     doc(key: string): SessionDocument;
     
+    readonly presence: Presence;
+    
     request(payload: unknown, options?: RequestOptions): Promise<unknown>;
     
     requestStream(payload: unknown, options?: RequestStreamOptions): AsyncIterable<string>;
@@ -267,9 +328,71 @@ interface Session {
     
     onPhase(handler: (phase: SessionPhase) => void): () => void;
     
+    readonly recordings: RecordingsAccessor;
+    
     disconnect(): void;
 }
 
+type RecordingBucket = 'temp' | 'pinned';
+
+type RecordingLifecycle = 'temp' | 'pinned' | 'permanent';
+
+type RecordingStatus = 'active' | 'deleting' | 'deleted' | 'pending_pin' | 'pending_unpin' | 'pending_permanent' | 'pending_delete';
+
+interface Recording {
+    
+    id: string;
+    
+    org_id: string;
+    
+    session_id: string;
+    
+    stream_name: string;
+    
+    bucket: RecordingBucket;
+    
+    s3_key: string;
+    
+    init_key: string;
+    
+    manifest_key: string;
+    
+    expires_at: string | null;
+    
+    lifecycle: RecordingLifecycle;
+    
+    retention: string | null;
+    
+    size_bytes: number | null;
+    
+    duration_s: number | null;
+    
+    status: RecordingStatus;
+    
+    created_at: string;
+    
+    updated_at: string;
+}
+
+declare function isPendingRecording(recording: Pick<Recording, 'status'>): boolean;
+
+interface RecordingsAccessor {
+    
+    list(sessionId?: string): Promise<Recording[]>;
+    
+    get(id: string): Promise<Recording>;
+    
+    retain(id: string, duration: string): Promise<Recording>;
+    
+    pin(id: string): Promise<Recording>;
+    
+    unpin(id: string): Promise<Recording>;
+    
+    permanent(id: string): Promise<Recording>;
+    
+    delete(id: string): Promise<Recording>;
+}
+
 interface AppOptions {
     
     baseUrl: string;
@@ -283,6 +406,8 @@ interface AppOptions {
     getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
+    
+    functionsUrl?: string;
 }
 interface AccessTokenOptions {
     forceRefresh?: boolean;
@@ -302,6 +427,8 @@ interface AttachOptions {
     getAccessToken?: (options?: AccessTokenOptions) => string | null | undefined | Promise<string | null | undefined>;
     
     authProvider?: string;
+    
+    functionsUrl?: string;
 }
 
 interface App {
@@ -351,13 +478,7 @@ interface TransportConnection {
     
     iceServers?: RTCIceServer[];
 }
-
-declare function encodeDocSyncFrame(docKey: string, payload: Uint8Array): Uint8Array;
-
-declare function decodeDocSyncFrame(frame: Uint8Array): {
-    docKey: string;
-    payload: Uint8Array;
-} | null;
+declare function streamDataLabel(name: string): string;
 interface TransportEvents {
     connected: () => void;
     disconnected: () => void;
@@ -366,10 +487,6 @@ interface TransportEvents {
     started: () => void;
     audioTransportReady: () => void;
     
-    docSync: (docKey: string, payload: Uint8Array) => void;
-    
-    docSyncReady: () => void;
-    
     stateChange: (state: TransportState) => void;
     
     phase: (phase: SessionPhase) => void;
@@ -439,6 +556,16 @@ declare class TransportSession {
     
     private _pendingStreamSubscribes;
     
+    private _streamDataHandlers;
+    
+    private _dataProducers;
+    
+    private _dataProducerPromises;
+    
+    private _dataConsumers;
+    
+    private _pendingDataProduce;
+    
     get consumerId(): string;
     get state(): TransportState;
     
@@ -467,13 +594,17 @@ declare class TransportSession {
     on<E extends keyof TransportEvents>(event: E, handler: TransportEvents[E]): () => void;
     sendInput(data: Record<string, unknown>, sequence?: number): void;
     
-    sendDocSync(docKey: string, payload: Uint8Array): void;
+    onStreamData(name: string, handler: (payload: unknown) => void): () => void;
     
-    onDocSync(docKey: string, handler: (payload: Uint8Array) => void): () => void;
+    sendStreamData(name: string, payload: unknown, _options?: {
+        to?: string;
+    }): void;
+    
+    private _ensureDataProducer;
     
-    onDocSyncReady(handler: () => void): () => void;
+    private _dispatchStreamData;
     
-    private _emitDocSyncFrame;
+    private _streamNameFromLabel;
     addTrack(track: MediaStreamTrack, name?: string): Promise<void>;
     removeTrack(): void;
     
@@ -502,6 +633,8 @@ declare class TransportSession {
     
     private _failoverRecvToTcp;
     private _onCreateSendTransport;
+    
+    private _onConsumeData;
     private _onConsume;
     private _mediaPollMs;
     private _mediaStallTimeoutMs;
@@ -519,6 +652,8 @@ declare class TransportSession {
     
     private _scheduleReconnectBudgetReset;
     private _clearReconnectBudgetReset;
+    
+    private _cleanupDataChannels;
     private _cleanupMedia;
     private _send;
     private _setState;
@@ -528,4 +663,35 @@ declare class TransportSession {
     private _emitError;
 }
 
-export { type App as A, encodeDocSyncFrame as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, mediaRecorderChunkSource as E, type Layer as L, type MediaChunkBinding as M, type RequestOptions as R, type SceneContext as S, TransportSession as T, type AppOptions as a, type AttachOptions as b, type ChannelMessage as c, ChannelMultiplexer as d, type ChannelName as e, type ChunkReadable as f, type LayoutConfig as g, type LayoutContext as h, type MediaChunkSource as i, type MediaChunkSourceFactory as j, type MediaRecorderChunkSourceOptions as k, type RequestStreamOptions as l, type SceneGraph as m, type Session as n, type SessionDocument as o, type SessionPhase as p, type SessionPhaseName as q, type SessionStartOptions as r, type SessionStream as s, type SessionText as t, type Store as u, type StoreOptions as v, type StreamChunkOptions as w, type TransportSessionOptions as x, type TransportState as y, decodeDocSyncFrame as z };
+interface StreamDataTransport {
+    
+    readonly consumerId: string;
+    
+    onData(name: string, handler: (payload: unknown) => void): () => void;
+    
+    sendData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+declare class LoopbackStreamData implements StreamDataTransport {
+    readonly consumerId: string;
+    private _handlers;
+    constructor(consumerId?: string);
+    onData(name: string, handler: (payload: unknown) => void): () => void;
+    sendData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+interface DataChannelTransport {
+    readonly consumerId: string;
+    onStreamData(name: string, handler: (payload: unknown) => void): () => void;
+    sendStreamData(name: string, payload: unknown, options?: {
+        to?: string;
+    }): void;
+}
+
+declare function transportStreamData(transport: DataChannelTransport): StreamDataTransport;
+
+export { type AccessTokenOptions as A, type SessionPhase as B, type ChannelEndpoint as C, DeferredChannelMultiplexer as D, type SessionPhaseName as E, type SessionStartOptions as F, type SessionStream as G, type SessionText as H, type Store as I, type StoreOptions as J, type StreamChunkOptions as K, type Layer as L, type MediaChunkBinding as M, type StreamDataTransport as N, type TransportSessionOptions as O, type Presence as P, type TransportState as Q, type Recording as R, type SceneContext as S, TransportSession as T, createPresence as U, createWebsocketDocConnector as V, deriveYjsServerUrl as W, isPendingRecording as X, mediaRecorderChunkSource as Y, streamDataLabel as Z, transportStreamData as _, type App as a, 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 SceneGraph as x, type Session as y, type SessionDocument as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urun-sh/core",
-  "version": "0.1.48",
+  "version": "0.2.0",
   "description": "Core transport and channel primitives for the urun TypeScript SDK",
   "repository": {
     "type": "git",
@@ -17,11 +17,21 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "browser": {
+        "types": "./dist/index.browser.d.ts",
+        "import": "./dist/index.browser.mjs",
+        "require": "./dist/index.browser.js"
+      },
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
     "./internal": {
       "types": "./dist/internal.d.ts",
+      "browser": {
+        "types": "./dist/internal.browser.d.ts",
+        "import": "./dist/internal.browser.mjs",
+        "require": "./dist/internal.browser.js"
+      },
       "import": "./dist/internal.mjs",
       "require": "./dist/internal.js"
     },
@@ -59,7 +69,9 @@
   },
   "license": "MIT",
   "dependencies": {
-    "yjs": "^13.6.0"
+    "y-protocols": "1.0.7",
+    "y-websocket": "3.0.0",
+    "yjs": "^13.6.31"
   },
   "optionalDependencies": {
     "werift": "0.23.0",