restream-sdk 0.6.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restream-sdk",
-  "version": "0.6.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);
@@ -402,6 +402,15 @@ export class RestreamStudio extends EventTarget {
    */
   async goLive({ publisherSessionId, destinations, overlay, recording, trackNames, restreamChannels, streamMeta, destinationMeta, streamingProvider, layout, screenSessionId, participantOnly } = {}) {
     if (!publisherSessionId) throw new Error("publisherSessionId is required (from your existing stream session)");
+    // Idempotency guard: refuse a second goLive while a job is already live. Re-publishing a fresh
+    // session and calling goLive() again on reconnect / screen toggle / collaborator change is the #1
+    // cause of duplicate + stale jobs — those are LIVE changes, so use setStreamState() /
+    // startScreenShare() / acceptCollab(), NOT a new goLive. Keep ONE publisher session for the whole
+    // stream; call stopLive() first to intentionally start over. Only live states block, so after the
+    // job stops (status becomes stopping/stopped/failed/ended) a genuine restart works normally.
+    if (this.job?.id && ["queued", "starting", "connecting", "running"].includes(this.job.status)) {
+      throw new Error(`goLive blocked: a stream is already live (job ${this.job.id}, status ${this.job.status}). Use setStreamState()/startScreenShare()/acceptCollab() for live changes, and call stopLive() before starting a new stream — do not re-publish or re-goLive on reconnect/screen/collab changes.`);
+    }
     const body = {
       publisherSessionId,
       destinations: destinations || this._armed?.destinations || [],
@@ -793,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[]>;