From aa1867b70d17d200947fd3536d9f6a18ecd89a25 Mon Sep 17 00:00:00 2001
From: Om Gate <om@videodb.io>
Date: Tue, 10 Mar 2026 19:40:50 +0530
Subject: [PATCH 1/2] feat: player config

---
 src/core/rtstream.ts | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/src/core/rtstream.ts b/src/core/rtstream.ts
index 8637121..2a5dcbb 100644
--- a/src/core/rtstream.ts
+++ b/src/core/rtstream.ts
@@ -28,6 +28,15 @@ export interface RTStreamExportResult {
   duration?: number;
 }
 
+export interface RTStreamPlayerConfig {
+  /** Optional title shown in the player share page */
+  title?: string;
+  /** Optional description shown in the player share page */
+  description?: string;
+  /** Optional slug prefix for the generated player share URL */
+  slug?: string;
+}
+
 /**
  * RTStreamShot class for rtstream search results
  */
@@ -340,6 +349,7 @@ export class RTStream {
   public createdAt?: string;
   public sampleRate?: number;
   public status?: string;
+  public playerUrl?: string;
   /** Channel ID this rtstream is associated with */
   public channelId?: string;
   /** Media types this rtstream handles */
@@ -415,16 +425,31 @@ export class RTStream {
    * Generate a stream from the rtstream
    * @param start - Start time of the stream in Unix timestamp format
    * @param end - End time of the stream in Unix timestamp format
+   * @param playerConfig - Optional player share page metadata
    * @returns Stream URL
    */
   public generateStream = async (
     start: number,
-    end: number
+    end: number,
+    playerConfig?: RTStreamPlayerConfig
   ): Promise<string | null> => {
-    const res = await this.#vhttp.get<{ streamUrl: string }>(
+    const params: Record<string, unknown> = { start, end };
+
+    if (playerConfig?.title !== undefined) {
+      params.player_title = playerConfig.title;
+    }
+    if (playerConfig?.description !== undefined) {
+      params.player_description = playerConfig.description;
+    }
+    if (playerConfig?.slug !== undefined) {
+      params.player_slug_prefix = playerConfig.slug;
+    }
+
+    const res = await this.#vhttp.get<{ streamUrl: string; playerUrl?: string }>(
       [ApiPath.rtstream, this.id, ApiPath.stream],
-      { params: { start, end } }
+      { params }
     );
+    this.playerUrl = res.data?.playerUrl;
     return res.data?.streamUrl || null;
   };
 

From f5cc4fe9d5ac707533b261d039d1bdf68219c692 Mon Sep 17 00:00:00 2001
From: Om Gate <om@videodb.io>
Date: Tue, 10 Mar 2026 19:42:10 +0530
Subject: [PATCH 2/2] feat: version bump

---
 CHANGELOG.md | 6 ++++++
 package.json | 2 +-
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 7209a37..6bcfe0e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
 # Changelog
 
+## [0.2.1] (2026-03-10)
+
+### Added
+
+- RTStream `generateStream(start, end, playerConfig?)` now supports `playerConfig.title`, `playerConfig.description`, and `playerConfig.slug` for player share metadata.
+
 ## [0.2.0] (2026-02-02)
 
 ### ⚠️ Breaking Changes
diff --git a/package.json b/package.json
index 3f5cc0f..24bfe60 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "videodb",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "A NodeJS wrapper for VideoDB's API written in TypeScript",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",