restream-sdk 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restream-sdk",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Plug-and-play headless React hooks to add multi-platform restreaming (connect socials, go live, live chat + viewers, collaborative split-screen) with zero client backend.",
   "type": "module",
   "main": "src/index.js",

package/src/core.js

@@ -73,7 +73,7 @@ export class RestreamStudio extends EventTarget {
 
   _emit(type, detail) { this.dispatchEvent(new CustomEvent(type, { detail })); }
 
-  /** Subscribe to an event ("connections" | "job" | "viewers" | "comment" | "comments" | "error" | "collab" | "collab-invite" | "collab-accepted" | "collab-declined" | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-snapshot"). Returns an unsubscribe fn. */
+  /** Subscribe to an event ("connections" | "job" | "viewers" | "comment" | "comments" | "error" | "collab" | "collab-invite" | "collab-accepted" | "collab-declined" | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-reassigned" | "collab-snapshot"). Returns an unsubscribe fn. */
   on(type, cb) {
     const handler = (e) => cb(e.detail);
     this.addEventListener(type, handler);
@@ -802,11 +802,14 @@ export class RestreamStudio extends EventTarget {
       let evt;
       try { evt = JSON.parse(e.data); } catch { return; } // heartbeat / non-JSON
       if (!evt || !evt.type) return;
-      // When the composite starts, transition this client onto the composite job —
-      // critical for the HOST, who was still tracking their (now-superseded) solo
-      // job. The guest already attached via the accept response; the id guard makes
-      // this idempotent so it doesn't restart realtime twice.
-      if (evt.type === "collab-composite" && evt.job?.id && this.job?.id !== evt.job.id) {
+      // Follow a job-id change. Two events carry a new job to adopt:
+      //  • collab-composite — this client joined the composite (critical for the HOST, still tracking
+      //    its now-superseded solo; the guest already attached via the accept response).
+      //  • collab-reassigned — this creator was moved to a FRESH solo job (collab ended, host took
+      //    over, or this guest was swapped out). Without adopting it, the UI is orphaned on a stopped
+      //    composite id while actually re-broadcasting under a job it can't see.
+      // The id guard keeps it idempotent (won't restart realtime twice).
+      if ((evt.type === "collab-composite" || evt.type === "collab-reassigned") && evt.job?.id && this.job?.id !== evt.job.id) {
         this.job = evt.job;
         this._emit("job", evt.job);
         this.startRealtime(evt.job.id);

package/types/index.d.ts

@@ -161,7 +161,7 @@ export interface OverlayUpdate {
 export type RestreamEvent =
   | "connections" | "job" | "viewers" | "comment" | "comments" | "error"
   | "collab" | "collab-invite" | "collab-accepted" | "collab-declined"
-  | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-snapshot";
+  | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-reassigned" | "collab-snapshot";
 
 /** A collaborative split-screen invite (A invites B; the composite starts on accept). */
 export interface CollabInvite {
@@ -230,7 +230,7 @@ export class RestreamStudio extends EventTarget {
   on(type: "error", cb: (e: Error) => void): () => void;
   on(type: "state", cb: (s: StreamState) => void): () => void;
   on(type: "screenshare", cb: (e: { active: boolean; sessionId?: string; trackName?: string }) => void): () => void;
-  on(type: "collab" | "collab-invite" | "collab-accepted" | "collab-declined" | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-snapshot", cb: (e: CollabEvent) => void): () => void;
+  on(type: "collab" | "collab-invite" | "collab-accepted" | "collab-declined" | "collab-revoked" | "collab-ended" | "collab-expired" | "collab-composite" | "collab-reassigned" | "collab-snapshot", cb: (e: CollabEvent) => void): () => void;
   listConnections(): Promise<Connection[]>;
   listOAuthPlatforms(): Promise<OAuthPlatformsResponse>;
   listRestreamChannels(): Promise<RestreamChannel[]>;