@urun-sh/core 0.2.21 → 0.2.23

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+- Removed the dead compositing-era scene-graph type exports (`Layer`, `SceneContext`,
+  `SceneGraph`, `LayoutConfig`, `LayoutContext`) — they documented `useScene()`/`useLayout()`
+  hooks that no longer exist anywhere. Type-only removal; no runtime surface change.
+  Guarded by `compositing-era-removed.test.ts`.
+
 - Add owner-only `Session.end()` for acknowledged terminal release through the existing authenticated session-request release endpoint. It returns a typed `ended`/`canceled` outcome, memoizes concurrent and repeated calls, and leaves `disconnect()` as the reconnectable transport-detach primitive. Consume-only viewer handles reject terminal release with `SessionEndUnavailableError`; release failures reject with `SessionEndError`.
 
 ## 0.2.19

package/README.md

@@ -26,7 +26,7 @@ const session = app.generate({ prompt: 'A sunset' })
 // arrive ASYNCHRONOUSLY — subscribe with `.on('track', …)`; never read `.track` once.
 const video = session.stream('video')
 video.on('track', (track) => {
-  videoElement.srcObject = new MediaStream([track])
+  if (track) videoElement.srcObject = new MediaStream([track])
 })
 
 // Drive the app by writing DESIRED state into the control doc; the runtime reactively
@@ -70,13 +70,22 @@ second hand-poll (`pipeline.bind` / `stage.bind(doc, mapping)` are retired). Kee
 - `session.stream(name)` — get a named symmetric stream (media or data); first use decides direction.
 - `session.stream(name).track` — read the latest inbound track (consume side).
 - `session.stream(name).on('track', cb)` — subscribe to inbound tracks as they arrive.
-- `session.stream(name).attach(track)` — produce: send a local browser track upstream.
-- `session.stream(name).detach()` — stop producing the local browser track.
+- `session.stream(name).attach(track)` — produce: send a local browser MIC/AUDIO track upstream.
+- `session.stream(name).attachVideo(track)` — produce: send a local browser VIDEO track upstream
+  (a later call swaps the source via `replaceTrack`). `detach()` / `detachVideo()` stop producing.
+- `session.stream(name).emit(payload)` / `.messages()` — the DATA lane: produce a payload on the
+  named stream / consume it as an async iterable (subscribing is opt-in).
 - `session.stream(name).seek(seconds)` — seek a persisted finite stream to seconds from start.
 - `session.stream(name).seek('live')` — return a live stream to the live edge.
 - `session.doc(name).get()` — read the merged document snapshot.
 - `session.doc(name).set(patch)` — write desired state into a session document.
 - `session.doc(name).on('change', cb)` — react to runtime-published document changes.
+- `session.request(payload)` / `.requestStream(payload)` / `.complete(payload)` — correlated
+  request/response riding a session doc (reconnect-safe); `requestStream` yields incremental deltas.
+- `session.onPhase(cb)` / `session.whenLive()` — the nine honest lifecycle phases and the
+  "is media ready?" gate (rejects with a typed `SessionFailedError`).
+- `session.end()` / `session.disconnect()` — terminal release vs. detach-and-stay-reconnectable.
+- `Session.attach(sessionId, options)` — join a running session as a consume-only viewer.
 - `createStore(options)` — content-addressed global store: `get(key)` / `has(key)` reads and
   `on(name, cb)` / `emit(name, data)` global streams. (App-scoped `store.cache` is a runtime
   concern; content-addressed blobs — `store.model`/`store.path`/`store.repo` — are not app-scoped.)

package/dist/index.browser.d.mts

@@ -1,5 +1,5 @@
-import { d as AppOptions, c as App$1, T as SessionPhase, X as SessionStatus, V as SessionPhaseName, A as AccessTokenOptions$1, B as RuntimeArtifact, E as RuntimeArtifactDownload, R as Recording, I as Session$1, C as ChannelEndpoint, a2 as TransportSession, e as AttachOptions, J as SessionDiagnostic, a as ActivationEvent, x as RecordingsAccessor, F as RuntimeArtifactsAccessor, O as SessionEndResult, Y as SessionStream$1, a1 as StreamDataTransport, N as SessionDocumentImpl, a0 as StreamChunkOptions, i as ChunkReadable, P as Presence, m as DocConnector, y as RequestOptions, z as RequestStreamOptions, $ as StoreOptions, _ as Store, g as ChannelMultiplexer, Q as SessionFailureKind, a4 as TransportState } from './stream-data-bZAHTqK-.mjs';
-export { b as ActivationState, L as Layer, n as LayoutConfig, o as LayoutContext, M as MediaChunkBinding, q as MediaChunkSource, r as MediaChunkSourceFactory, s as MediaRecorderChunkSourceOptions, t as PresenceState, u as RecordingBucket, v as RecordingLifecycle, w as RecordingStatus, G as RuntimeAvailability, S as SceneContext, H as SceneGraph, K as SessionDocument, U as SessionPhaseError, Z as SessionText, a8 as isPendingRecording, a9 as mediaRecorderChunkSource } from './stream-data-bZAHTqK-.mjs';
+import { d as AppOptions, c as App$1, J as SessionPhase, Q as SessionStatus, N as SessionPhaseName, A as AccessTokenOptions$1, x as RuntimeArtifact, y as RuntimeArtifactDownload, R as Recording, S as Session$1, C as ChannelEndpoint, Z as TransportSession, e as AttachOptions, E as SessionDiagnostic, a as ActivationEvent, u as RecordingsAccessor, z as RuntimeArtifactsAccessor, H as SessionEndResult, T as SessionStream$1, Y as StreamDataTransport, G as SessionDocumentImpl, X as StreamChunkOptions, i as ChunkReadable, P as Presence, m as DocConnector, v as RequestOptions, w as RequestStreamOptions, W as StoreOptions, V as Store, g as ChannelMultiplexer, I as SessionFailureKind, $ as TransportState } from './stream-data-BQso6wNv.mjs';
+export { b as ActivationState, M as MediaChunkBinding, n as MediaChunkSource, o as MediaChunkSourceFactory, p as MediaRecorderChunkSourceOptions, q as PresenceState, r as RecordingBucket, s as RecordingLifecycle, t as RecordingStatus, B as RuntimeAvailability, F as SessionDocument, K as SessionPhaseError, U as SessionText, a3 as isPendingRecording, a4 as mediaRecorderChunkSource } from './stream-data-BQso6wNv.mjs';
 import 'yjs';
 import 'y-protocols/awareness';
 
@@ -845,6 +845,10 @@ declare class WebTransportSession implements MediaSession {
     readonly kind: "webtransport";
     private wt;
     private decoder;
+    
+    private decoderConfig;
+    
+    private decoderErrorsAt;
     private writer;
     private deadCb;
     private deadFired;
@@ -869,6 +873,8 @@ declare class WebTransportSession implements MediaSession {
         jitterMs: number;
     };
     private initDecoder;
+    
+    private onDecoderError;
     private datagramLoop;
     private decodeFrame;
     private sendControl;
@@ -943,6 +949,8 @@ declare class FrameReassembler {
     
     push(chunk: Uint8Array): void;
     
+    requireKeyframe(): void;
+    
     drainWindow(): {
         bytes: number;
         delivered: number;

package/dist/index.browser.d.ts

@@ -1,5 +1,5 @@
-import { d as AppOptions, c as App$1, T as SessionPhase, X as SessionStatus, V as SessionPhaseName, A as AccessTokenOptions$1, B as RuntimeArtifact, E as RuntimeArtifactDownload, R as Recording, I as Session$1, C as ChannelEndpoint, a2 as TransportSession, e as AttachOptions, J as SessionDiagnostic, a as ActivationEvent, x as RecordingsAccessor, F as RuntimeArtifactsAccessor, O as SessionEndResult, Y as SessionStream$1, a1 as StreamDataTransport, N as SessionDocumentImpl, a0 as StreamChunkOptions, i as ChunkReadable, P as Presence, m as DocConnector, y as RequestOptions, z as RequestStreamOptions, $ as StoreOptions, _ as Store, g as ChannelMultiplexer, Q as SessionFailureKind, a4 as TransportState } from './stream-data-bZAHTqK-.js';
-export { b as ActivationState, L as Layer, n as LayoutConfig, o as LayoutContext, M as MediaChunkBinding, q as MediaChunkSource, r as MediaChunkSourceFactory, s as MediaRecorderChunkSourceOptions, t as PresenceState, u as RecordingBucket, v as RecordingLifecycle, w as RecordingStatus, G as RuntimeAvailability, S as SceneContext, H as SceneGraph, K as SessionDocument, U as SessionPhaseError, Z as SessionText, a8 as isPendingRecording, a9 as mediaRecorderChunkSource } from './stream-data-bZAHTqK-.js';
+import { d as AppOptions, c as App$1, J as SessionPhase, Q as SessionStatus, N as SessionPhaseName, A as AccessTokenOptions$1, x as RuntimeArtifact, y as RuntimeArtifactDownload, R as Recording, S as Session$1, C as ChannelEndpoint, Z as TransportSession, e as AttachOptions, E as SessionDiagnostic, a as ActivationEvent, u as RecordingsAccessor, z as RuntimeArtifactsAccessor, H as SessionEndResult, T as SessionStream$1, Y as StreamDataTransport, G as SessionDocumentImpl, X as StreamChunkOptions, i as ChunkReadable, P as Presence, m as DocConnector, v as RequestOptions, w as RequestStreamOptions, W as StoreOptions, V as Store, g as ChannelMultiplexer, I as SessionFailureKind, $ as TransportState } from './stream-data-BQso6wNv.js';
+export { b as ActivationState, M as MediaChunkBinding, n as MediaChunkSource, o as MediaChunkSourceFactory, p as MediaRecorderChunkSourceOptions, q as PresenceState, r as RecordingBucket, s as RecordingLifecycle, t as RecordingStatus, B as RuntimeAvailability, F as SessionDocument, K as SessionPhaseError, U as SessionText, a3 as isPendingRecording, a4 as mediaRecorderChunkSource } from './stream-data-BQso6wNv.js';
 import 'yjs';
 import 'y-protocols/awareness';
 
@@ -845,6 +845,10 @@ declare class WebTransportSession implements MediaSession {
     readonly kind: "webtransport";
     private wt;
     private decoder;
+    
+    private decoderConfig;
+    
+    private decoderErrorsAt;
     private writer;
     private deadCb;
     private deadFired;
@@ -869,6 +873,8 @@ declare class WebTransportSession implements MediaSession {
         jitterMs: number;
     };
     private initDecoder;
+    
+    private onDecoderError;
     private datagramLoop;
     private decodeFrame;
     private sendControl;
@@ -943,6 +949,8 @@ declare class FrameReassembler {
     
     push(chunk: Uint8Array): void;
     
+    requireKeyframe(): void;
+    
     drainWindow(): {
         bytes: number;
         delivered: number;