restream-sdk 0.1.5 → 0.1.6

package/package.json

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

package/src/core.js

@@ -4,7 +4,7 @@
 // (publisherSessionId) is produced by the client's existing stream and passed
 // into goLive() — this module never captures or publishes media itself.
 
-export const PLATFORMS = ["twitch", "kick", "youtube", "facebook", "instagram", "tiktok"];
+export const PLATFORMS = ["twitch", "kick", "youtube", "facebook", "instagram", "tiktok", "restream"];
 
 const TERMINAL_STATUS = new Set(["stopped", "failed", "ended", "error", "completed"]);
 
@@ -293,8 +293,11 @@ export class RestreamStudio extends EventTarget {
    * @param {object} [opts.overlay]            { topBanner?, bottomBanner?, htmlBanner?, enabled? }
    * @param {boolean} [opts.recording]
    * @param {string[]} [opts.trackNames]       tracks actually published, e.g. ["audio","video"]
+   * @param {object} [opts.streamMeta]         { title?, description?, tags?:string[] } applied to
+   *                                           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 } = {}) {
+  async goLive({ publisherSessionId, destinations, overlay, recording, trackNames, restreamChannels, streamMeta } = {}) {
     if (!publisherSessionId) throw new Error("publisherSessionId is required (from your existing stream session)");
     const body = {
       publisherSessionId,
@@ -305,6 +308,11 @@ export class RestreamStudio extends EventTarget {
     if (trackNames && trackNames.length) body.trackNames = trackNames;
     // Per-platform selection for the "restream" fan-out bridge (channel ids or platform names).
     if (restreamChannels && restreamChannels.length) body.restreamChannels = restreamChannels;
+    // Stream title/description/tags. Send only what you have — omitted fields fall
+    // back to the creator's pre-set default on the platform.
+    if (streamMeta && (streamMeta.title || streamMeta.description || (streamMeta.tags && streamMeta.tags.length))) {
+      body.streamMeta = streamMeta;
+    }
     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;

package/types/index.d.ts

@@ -75,6 +75,18 @@ export interface GoLiveParams {
    * Omit to use whichever channels are currently active in the Restream account.
    */
   restreamChannels?: string[];
+  /**
+   * Stream title / description / tags applied to the Restream channels. Send only
+   * the fields you have — any field you omit falls back to the default pre-set for
+   * this creator on the platform. Omit entirely to use the pre-set defaults.
+   */
+  streamMeta?: StreamMeta;
+}
+
+export interface StreamMeta {
+  title?: string;
+  description?: string;
+  tags?: string[];
 }
 
 export interface OverlayUpdate {