restream-sdk 0.1.7 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "restream-sdk",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "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

@@ -299,7 +299,7 @@ export class RestreamStudio extends EventTarget {
    *                                           Restream channels. Any field omitted falls back to the
    *                                           default pre-set for this creator on the platform.
    */
-  async goLive({ publisherSessionId, destinations, overlay, recording, trackNames, restreamChannels, streamMeta } = {}) {
+  async goLive({ publisherSessionId, destinations, overlay, recording, trackNames, restreamChannels, streamMeta, destinationMeta } = {}) {
     if (!publisherSessionId) throw new Error("publisherSessionId is required (from your existing stream session)");
     const body = {
       publisherSessionId,
@@ -315,6 +315,12 @@ export class RestreamStudio extends EventTarget {
     if (streamMeta && (streamMeta.title || streamMeta.description || (streamMeta.tags && streamMeta.tags.length))) {
       body.streamMeta = streamMeta;
     }
+    // Per-destination overrides, keyed by platform name (e.g. { youtube: {title},
+    // twitch: {title, tags} }). Each field falls back to streamMeta, then the
+    // creator's pre-set per-destination / global default on the platform.
+    if (destinationMeta && typeof destinationMeta === "object" && Object.keys(destinationMeta).length) {
+      body.destinationMeta = destinationMeta;
+    }
     if (this.publishableKey && this.userId) body.clientUserId = this.userId; // token mode binds server-side
     const job = await this._req("POST", "/api/v1/jobs", body);
     this.job = job;
@@ -526,6 +532,15 @@ 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) {
+        this.job = evt.job;
+        this._emit("job", evt.job);
+        this.startRealtime(evt.job.id);
+      }
       this._emit(evt.type, evt);
       this._emit("collab", evt);
     };

package/types/index.d.ts

@@ -81,6 +81,13 @@ export interface GoLiveParams {
    * this creator on the platform. Omit entirely to use the pre-set defaults.
    */
   streamMeta?: StreamMeta;
+  /**
+   * Per-destination overrides, keyed by platform name (e.g.
+   * `{ youtube: { title }, twitch: { title, tags } }`). Each field falls back, in
+   * order, to: this map → `streamMeta` → the creator's pre-set per-destination
+   * default → the creator's pre-set global default → the platform's existing value.
+   */
+  destinationMeta?: DestinationMeta;
 }
 
 export interface StreamMeta {
@@ -89,6 +96,9 @@ export interface StreamMeta {
   tags?: string[];
 }
 
+/** Per-platform stream metadata overrides, keyed by platform name. */
+export type DestinationMeta = Partial<Record<Platform, StreamMeta>> & Record<string, StreamMeta>;
+
 export interface OverlayUpdate {
   topBanner?: string;
   bottomBanner?: string;