streamkit-orchestrator 0.4.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StreamKit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,304 @@
+# @streamkit/orchestrator
+
+Lightweight stream orchestrator for coordinating multiple WebRTC streams.
+
+## What This Package Does
+
+The orchestrator acts as a coordination layer that:
+
+- **Registers** multiple named streams (binary or JSON)
+- **Enables/disables** streams dynamically
+- **Routes** incoming data to the correct handler
+- **Coordinates** stream state via control messages
+
+## What This Package Does NOT Do
+
+- ❌ WebRTC signaling (offer/answer exchange)
+- ❌ Binary frame parsing (delegated to @streamkit/binary-stream)
+- ❌ DataChannel management (delegated to @streamkit/webrtc)
+- ❌ Data decoding or rendering
+- ❌ Retry or reconnection logic
+
+## Position in the Stack
+
+```
+┌─────────────────────┐
+│   Your Application  │
+└──────────┬──────────┘
+           │
+           ▼
+┌─────────────────────┐
+│ @streamkit/         │  ← THIS PACKAGE
+│ orchestrator        │     Coordinates streams
+└──────────┬──────────┘
+           │
+     ┌─────┴─────┐
+     │           │
+     ▼           ▼
+┌─────────┐ ┌─────────┐
+│ binary  │ │  json   │
+│ streams │ │ streams │
+└────┬────┘ └────┬────┘
+     │           │
+     ▼           │
+┌─────────────┐  │
+│ @streamkit/ │  │
+│ webrtc      │  │
+└──────┬──────┘  │
+       │         │
+       ▼         │
+┌─────────────┐  │
+│ @streamkit/ │  │
+│ binary-     │  │
+│ stream      │  │
+└──────┬──────┘  │
+       │         │
+       └────┬────┘
+            │
+            ▼
+┌─────────────────────┐
+│ RTCPeerConnection   │
+└─────────────────────┘
+```
+
+## Installation
+
+```bash
+npm install @streamkit/orchestrator
+```
+
+## Quick Start
+
+```typescript
+import { createOrchestrator } from "@streamkit/orchestrator";
+
+// You create and configure the peer connection
+const pc = new RTCPeerConnection();
+
+// Create orchestrator
+const orch = createOrchestrator({ pc });
+
+// Register a binary stream (e.g., point cloud data)
+orch.registerStream({
+  name: "pointcloud",
+  type: "binary",
+  onFrame(frame) {
+    console.log("PointCloud frame:", frame.id, frame.payload.byteLength);
+    // Pass to @streamkit/pointcloud decoder
+  },
+});
+
+// Register a JSON stream (e.g., telemetry)
+orch.registerStream({
+  name: "telemetry",
+  type: "json",
+  onMessage(data) {
+    console.log("Telemetry:", data);
+  },
+});
+
+// Enable streams when ready
+orch.enable("pointcloud");
+orch.enable("telemetry");
+
+// Later: disable a stream
+orch.disable("pointcloud");
+
+// Cleanup
+orch.dispose();
+```
+
+## Mental Model
+
+Think of the orchestrator as a **switchboard operator**:
+
+1. **Registration** = Plugging in a phone line (no connection yet)
+2. **Enable** = Connecting the call (DataChannel created)
+3. **Disable** = Hanging up (DataChannel closed)
+4. **Control messages** = Signaling to the remote switchboard
+
+```
+Local Orchestrator          Remote Orchestrator
+       │                           │
+       │ ──── control: enable ───► │
+       │                           │
+       │ ◄─── data frames ──────── │
+       │                           │
+       │ ──── control: disable ──► │
+       │                           │
+```
+
+## API Reference
+
+### `createOrchestrator(options)`
+
+Creates a stream orchestrator.
+
+**Options:**
+
+| Option             | Type                            | Description                       |
+| ------------------ | ------------------------------- | --------------------------------- |
+| `pc`               | `RTCPeerConnection`             | The peer connection to manage     |
+| `onError`          | `(error: Error) => void`        | Optional error callback           |
+| `onControlMessage` | `(msg: ControlMessage) => void` | Optional control message observer |
+
+**Returns:** `Orchestrator`
+
+### `Orchestrator`
+
+```typescript
+interface Orchestrator {
+  registerStream(descriptor: StreamDescriptor): void;
+  enable(name: string): void;
+  disable(name: string): void;
+  isEnabled(name: string): boolean;
+  isRegistered(name: string): boolean;
+  getStreamNames(): string[];
+  sendControl(message: ControlMessage): void;
+  dispose(): void;
+}
+```
+
+### Stream Descriptors
+
+#### Binary Stream
+
+For frame-based binary data (point clouds, video frames, sensor data):
+
+```typescript
+orch.registerStream({
+  name: "pointcloud",
+  type: "binary",
+  enabledByDefault: false,
+  maxFrameSize: 10_000_000, // 10MB max frame
+  maxBufferSize: 50_000_000, // 50MB buffer limit
+  onFrame(frame) {
+    // frame.id: number
+    // frame.timestamp: number
+    // frame.payload: ArrayBuffer
+  },
+});
+```
+
+#### JSON Stream
+
+For structured messages (telemetry, commands, events):
+
+```typescript
+orch.registerStream({
+  name: "telemetry",
+  type: "json",
+  enabledByDefault: true,
+  onMessage(data) {
+    // data: unknown (parsed JSON)
+  },
+});
+```
+
+### Control Messages
+
+Control messages coordinate stream state between peers:
+
+```typescript
+interface ControlMessage {
+  type: "control";
+  stream: string;
+  enabled: boolean;
+}
+```
+
+**Automatic behavior:**
+
+- `enable()` sends `{ type: 'control', stream: 'name', enabled: true }`
+- `disable()` sends `{ type: 'control', stream: 'name', enabled: false }`
+
+**Manual control:**
+
+```typescript
+orch.sendControl({
+  type: "control",
+  stream: "custom",
+  enabled: true,
+});
+```
+
+## Integration with @streamkit/pointcloud
+
+```typescript
+import { createOrchestrator } from "@streamkit/orchestrator";
+import { createPointCloudLayer, decodeDraco } from "@streamkit/pointcloud";
+
+const scene = new THREE.Scene();
+const layer = createPointCloudLayer({ scene });
+
+const orch = createOrchestrator({ pc });
+
+orch.registerStream({
+  name: "pointcloud",
+  type: "binary",
+  async onFrame(frame) {
+    // Decode Draco-compressed point cloud
+    const data = await decodeDraco(frame.payload);
+    // Update Three.js layer
+    layer.update(data, { mode: "append" });
+  },
+});
+
+orch.enable("pointcloud");
+```
+
+## Lifecycle
+
+```
+┌──────────────┐
+│  registered  │ ← registerStream()
+└──────┬───────┘
+       │ enable()
+       ▼
+┌──────────────┐
+│   enabled    │ ← DataChannel open, receiving data
+└──────┬───────┘
+       │ disable()
+       ▼
+┌──────────────┐
+│   disabled   │ ← DataChannel closed
+└──────┬───────┘
+       │ enable() (can re-enable)
+       ▼
+      ...
+       │
+       │ dispose()
+       ▼
+┌──────────────┐
+│   disposed   │ ← All resources released
+└──────────────┘
+```
+
+## TypeScript
+
+Full type exports:
+
+```typescript
+import type {
+  Orchestrator,
+  OrchestratorOptions,
+  StreamDescriptor,
+  BinaryStreamDescriptor,
+  JSONStreamDescriptor,
+  StreamType,
+  ControlMessage,
+  BinaryFrame,
+} from "@streamkit/orchestrator";
+```
+
+## Design Principles
+
+1. **Lazy initialization**: Channels created only on `enable()`
+2. **Explicit lifecycle**: No hidden state transitions
+3. **Delegation**: Frame parsing and channel management delegated to specialized packages
+4. **Coordination**: Control messages keep both peers in sync
+5. **Minimal surface**: Only what's needed for orchestration
+
+## License
+
+MIT

package/dist/controlChannel.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @streamkit/orchestrator - Control Channel
+ *
+ * Dedicated channel for orchestrator control messages.
+ */
+import type { ControlMessage } from "./types.js";
+/** Reserved channel name for control messages */
+export declare const CONTROL_CHANNEL_LABEL = "__streamkit_control__";
+/**
+ * Validates and parses a control message.
+ * @param data - Raw message data
+ * @returns Parsed ControlMessage or null if invalid
+ */
+export declare function parseControlMessage(data: unknown): ControlMessage | null;
+/**
+ * Serializes a control message to JSON string.
+ * @param message - Control message to serialize
+ */
+export declare function serializeControlMessage(message: ControlMessage): string;
+/**
+ * Creates a control message for stream state change.
+ * @param streamName - Name of the stream
+ * @param enabled - Whether stream is being enabled
+ */
+export declare function createControlMessage(streamName: string, enabled: boolean): ControlMessage;
+/**
+ * Internal control channel manager.
+ */
+export interface ControlChannel {
+    send(message: ControlMessage): void;
+    close(): void;
+    readonly isOpen: boolean;
+}
+/**
+ * Creates a control channel on the peer connection.
+ * @param pc - RTCPeerConnection
+ * @param onMessage - Callback for incoming control messages
+ * @param onError - Optional error callback
+ */
+export declare function createControlChannel(pc: RTCPeerConnection, onMessage: (message: ControlMessage) => void, onError?: (error: Error) => void): ControlChannel;
+/**
+ * Sets up handler for incoming control channels from remote peer.
+ * @param pc - RTCPeerConnection
+ * @param onMessage - Callback for incoming control messages
+ */
+export declare function handleIncomingControlChannel(pc: RTCPeerConnection, onMessage: (message: ControlMessage) => void): void;
+//# sourceMappingURL=controlChannel.d.ts.map

package/dist/controlChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlChannel.d.ts","sourceRoot":"","sources":["../src/controlChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,iDAAiD;AACjD,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAoBxE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,cAAc,CAMhB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,EAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAC/B,cAAc,CA0EhB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,GAC3C,IAAI,CA2BN"}

package/dist/controlChannel.js

@@ -0,0 +1,149 @@
+/**
+ * @streamkit/orchestrator - Control Channel
+ *
+ * Dedicated channel for orchestrator control messages.
+ */
+/** Reserved channel name for control messages */
+export const CONTROL_CHANNEL_LABEL = "__streamkit_control__";
+/**
+ * Validates and parses a control message.
+ * @param data - Raw message data
+ * @returns Parsed ControlMessage or null if invalid
+ */
+export function parseControlMessage(data) {
+    if (typeof data !== "object" || data === null) {
+        return null;
+    }
+    const msg = data;
+    if (msg.type !== "control" ||
+        typeof msg.stream !== "string" ||
+        typeof msg.enabled !== "boolean") {
+        return null;
+    }
+    return {
+        type: "control",
+        stream: msg.stream,
+        enabled: msg.enabled,
+    };
+}
+/**
+ * Serializes a control message to JSON string.
+ * @param message - Control message to serialize
+ */
+export function serializeControlMessage(message) {
+    return JSON.stringify(message);
+}
+/**
+ * Creates a control message for stream state change.
+ * @param streamName - Name of the stream
+ * @param enabled - Whether stream is being enabled
+ */
+export function createControlMessage(streamName, enabled) {
+    return {
+        type: "control",
+        stream: streamName,
+        enabled,
+    };
+}
+/**
+ * Creates a control channel on the peer connection.
+ * @param pc - RTCPeerConnection
+ * @param onMessage - Callback for incoming control messages
+ * @param onError - Optional error callback
+ */
+export function createControlChannel(pc, onMessage, onError) {
+    const channel = pc.createDataChannel(CONTROL_CHANNEL_LABEL, {
+        ordered: true,
+    });
+    // Control channel uses string messages (JSON)
+    channel.binaryType = "arraybuffer"; // Not used, but required
+    let isOpen = false;
+    let isClosed = false;
+    channel.onopen = () => {
+        isOpen = true;
+    };
+    channel.onclose = () => {
+        isOpen = false;
+        isClosed = true;
+    };
+    channel.onerror = (event) => {
+        const error = new Error(`Control channel error: ${event}`);
+        onError?.(error);
+        console.error("Orchestrator control channel error:", event);
+    };
+    channel.onmessage = (event) => {
+        try {
+            const data = typeof event.data === "string" ? JSON.parse(event.data) : null;
+            const message = parseControlMessage(data);
+            if (message) {
+                onMessage(message);
+            }
+        }
+        catch (err) {
+            console.warn("Orchestrator: invalid control message received", err);
+        }
+    };
+    return {
+        send(message) {
+            if (isClosed) {
+                throw new Error("Control channel is closed");
+            }
+            if (!isOpen) {
+                // Queue message until channel opens
+                const checkAndSend = () => {
+                    if (isOpen && !isClosed) {
+                        channel.send(serializeControlMessage(message));
+                    }
+                    else if (!isClosed) {
+                        setTimeout(checkAndSend, 10);
+                    }
+                };
+                checkAndSend();
+                return;
+            }
+            channel.send(serializeControlMessage(message));
+        },
+        close() {
+            if (!isClosed) {
+                isClosed = true;
+                isOpen = false;
+                channel.close();
+            }
+        },
+        get isOpen() {
+            return isOpen;
+        },
+    };
+}
+/**
+ * Sets up handler for incoming control channels from remote peer.
+ * @param pc - RTCPeerConnection
+ * @param onMessage - Callback for incoming control messages
+ */
+export function handleIncomingControlChannel(pc, onMessage) {
+    const existingHandler = pc.ondatachannel;
+    pc.ondatachannel = (event) => {
+        if (event.channel.label === CONTROL_CHANNEL_LABEL) {
+            const channel = event.channel;
+            channel.onmessage = (msgEvent) => {
+                try {
+                    const data = typeof msgEvent.data === "string"
+                        ? JSON.parse(msgEvent.data)
+                        : null;
+                    const message = parseControlMessage(data);
+                    if (message) {
+                        onMessage(message);
+                    }
+                }
+                catch (err) {
+                    console.warn("Orchestrator: invalid control message received", err);
+                }
+            };
+        }
+        else {
+            // Pass through to existing handler if any
+            existingHandler?.call(pc, event);
+        }
+    };
+}
+//# sourceMappingURL=controlChannel.js.map

package/dist/controlChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlChannel.js","sourceRoot":"","sources":["../src/controlChannel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,iDAAiD;AACjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAa;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,IACE,GAAG,CAAC,IAAI,KAAK,SAAS;QACtB,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,OAAO,GAAG,CAAC,OAAO,KAAK,SAAS,EAChC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAuB;IAC7D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,OAAgB;IAEhB,OAAO;QACL,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,UAAU;QAClB,OAAO;KACR,CAAC;AACJ,CAAC;AAWD;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,EAAqB,EACrB,SAA4C,EAC5C,OAAgC;IAEhC,MAAM,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,qBAAqB,EAAE;QAC1D,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,8CAA8C;IAC9C,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,CAAC,yBAAyB;IAE7D,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE;QACpB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE;QACrB,MAAM,GAAG,KAAK,CAAC;QACf,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC,CAAC;IAEF,OAAO,CAAC,SAAS,GAAG,CAAC,KAAK,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,IAAI,GACR,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEjE,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,OAAO,EAAE,CAAC;gBACZ,SAAS,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,CAAC,OAAuB;YAC1B,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAC/C,CAAC;YAED,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,oCAAoC;gBACpC,MAAM,YAAY,GAAG,GAAG,EAAE;oBACxB,IAAI,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACxB,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;oBACjD,CAAC;yBAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;wBACrB,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC,CAAC;gBACF,YAAY,EAAE,CAAC;gBACf,OAAO;YACT,CAAC;YAED,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,KAAK;YACH,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM,GAAG,KAAK,CAAC;gBACf,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,MAAM;YACR,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,EAAqB,EACrB,SAA4C;IAE5C,MAAM,eAAe,GAAG,EAAE,CAAC,aAAa,CAAC;IAEzC,EAAE,CAAC,aAAa,GAAG,CAAC,KAAK,EAAE,EAAE;QAC3B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,KAAK,qBAAqB,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAE9B,OAAO,CAAC,SAAS,GAAG,CAAC,QAAQ,EAAE,EAAE;gBAC/B,IAAI,CAAC;oBACH,MAAM,IAAI,GACR,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;wBAC/B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAC3B,CAAC,CAAC,IAAI,CAAC;oBAEX,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;oBAC1C,IAAI,OAAO,EAAE,CAAC;wBACZ,SAAS,CAAC,OAAO,CAAC,CAAC;oBACrB,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CAAC,gDAAgD,EAAE,GAAG,CAAC,CAAC;gBACtE,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,0CAA0C;YAC1C,eAAe,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @streamkit/orchestrator
+ *
+ * Lightweight stream orchestrator for coordinating multiple WebRTC streams.
+ *
+ * This package provides:
+ * - Multi-stream registration and management
+ * - Dynamic enable/disable of streams
+ * - Control message coordination
+ * - Automatic routing to stream handlers
+ *
+ * This package does NOT provide:
+ * - WebRTC signaling
+ * - Binary frame parsing (delegated to @streamkit/binary-stream)
+ * - DataChannel management (delegated to @streamkit/webrtc)
+ * - Data decoding or rendering
+ *
+ * @packageDocumentation
+ */
+export type { BaseStreamDescriptor, BinaryFrame, BinaryStreamDescriptor, ControlMessage, JSONStreamDescriptor, Orchestrator, OrchestratorOptions, StreamDescriptor, StreamType, } from "./types.js";
+export { createOrchestrator } from "./orchestrator.js";
+export { CONTROL_CHANNEL_LABEL, createControlMessage, parseControlMessage, } from "./controlChannel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAMpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAMvD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @streamkit/orchestrator
+ *
+ * Lightweight stream orchestrator for coordinating multiple WebRTC streams.
+ *
+ * This package provides:
+ * - Multi-stream registration and management
+ * - Dynamic enable/disable of streams
+ * - Control message coordination
+ * - Automatic routing to stream handlers
+ *
+ * This package does NOT provide:
+ * - WebRTC signaling
+ * - Binary frame parsing (delegated to @streamkit/binary-stream)
+ * - DataChannel management (delegated to @streamkit/webrtc)
+ * - Data decoding or rendering
+ *
+ * @packageDocumentation
+ */
+// =============================================================================
+// Orchestrator Factory
+// =============================================================================
+export { createOrchestrator } from "./orchestrator.js";
+// =============================================================================
+// Control Channel Utilities
+// =============================================================================
+export { CONTROL_CHANNEL_LABEL, createControlMessage, parseControlMessage, } from "./controlChannel.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAkBH,gFAAgF;AAChF,uBAAuB;AACvB,gFAAgF;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,gFAAgF;AAChF,4BAA4B;AAC5B,gFAAgF;AAEhF,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/orchestrator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @streamkit/orchestrator - Stream Orchestrator Implementation
+ *
+ * Coordinates multiple logical streams over a single RTCPeerConnection.
+ */
+import type { Orchestrator, OrchestratorOptions } from "./types.js";
+/**
+ * Creates a stream orchestrator for coordinating multiple WebRTC streams.
+ *
+ * The orchestrator:
+ * - Registers streams by unique name
+ * - Lazily creates DataChannels on enable()
+ * - Routes incoming data to correct handlers
+ * - Sends/receives control messages for coordination
+ *
+ * @param options - Orchestrator configuration
+ * @returns Orchestrator controller
+ *
+ * @example
+ * ```typescript
+ * const orch = createOrchestrator({ pc });
+ *
+ * orch.registerStream({
+ *   name: 'pointcloud',
+ *   type: 'binary',
+ *   onFrame(frame) {
+ *     console.log('Frame:', frame.id);
+ *   }
+ * });
+ *
+ * orch.enable('pointcloud');
+ * ```
+ */
+export declare function createOrchestrator(options: OrchestratorOptions): Orchestrator;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,OAAO,KAAK,EAIV,YAAY,EACZ,mBAAmB,EAEpB,MAAM,YAAY,CAAC;AAepB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAgV7E"}

package/dist/orchestrator.js

@@ -0,0 +1,298 @@
+/**
+ * @streamkit/orchestrator - Stream Orchestrator Implementation
+ *
+ * Coordinates multiple logical streams over a single RTCPeerConnection.
+ */
+import { createBinaryStream } from "@streamkit/binary-stream";
+import { createWebRTCBinaryChannel, wrapDataChannel } from "@streamkit/webrtc";
+import { CONTROL_CHANNEL_LABEL, createControlChannel, createControlMessage, handleIncomingControlChannel, } from "./controlChannel.js";
+/**
+ * Creates a stream orchestrator for coordinating multiple WebRTC streams.
+ *
+ * The orchestrator:
+ * - Registers streams by unique name
+ * - Lazily creates DataChannels on enable()
+ * - Routes incoming data to correct handlers
+ * - Sends/receives control messages for coordination
+ *
+ * @param options - Orchestrator configuration
+ * @returns Orchestrator controller
+ *
+ * @example
+ * ```typescript
+ * const orch = createOrchestrator({ pc });
+ *
+ * orch.registerStream({
+ *   name: 'pointcloud',
+ *   type: 'binary',
+ *   onFrame(frame) {
+ *     console.log('Frame:', frame.id);
+ *   }
+ * });
+ *
+ * orch.enable('pointcloud');
+ * ```
+ */
+export function createOrchestrator(options) {
+    const { pc, onError, onControlMessage } = options;
+    if (!pc) {
+        throw new Error("Orchestrator: RTCPeerConnection is required");
+    }
+    // Internal state
+    const streams = new Map();
+    let controlChannel = null;
+    let disposed = false;
+    // ─────────────────────────────────────────────────────────────────────────
+    // Control Channel Setup
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Handles incoming control messages.
+     */
+    function handleControlMessage(message) {
+        // Notify application
+        onControlMessage?.(message);
+        // Handle stream enable/disable from remote
+        const stream = streams.get(message.stream);
+        if (stream) {
+            if (message.enabled && !stream.enabled) {
+                enableStreamInternal(message.stream, false); // Don't send control back
+            }
+            else if (!message.enabled && stream.enabled) {
+                disableStreamInternal(message.stream, false); // Don't send control back
+            }
+        }
+    }
+    // Create outgoing control channel
+    controlChannel = createControlChannel(pc, handleControlMessage, onError);
+    // Handle incoming control channel from remote peer
+    handleIncomingControlChannel(pc, handleControlMessage);
+    // Handle incoming data channels from remote peer
+    setupIncomingDataChannelHandler();
+    // ─────────────────────────────────────────────────────────────────────────
+    // Incoming Channel Handling
+    // ─────────────────────────────────────────────────────────────────────────
+    function setupIncomingDataChannelHandler() {
+        const existingHandler = pc.ondatachannel;
+        pc.ondatachannel = (event) => {
+            const channel = event.channel;
+            const label = channel.label;
+            // Skip control channel (handled separately)
+            if (label === CONTROL_CHANNEL_LABEL) {
+                existingHandler?.call(pc, event);
+                return;
+            }
+            // Find registered stream
+            const managed = streams.get(label);
+            if (!managed) {
+                console.warn(`Orchestrator: received channel for unknown stream '${label}'`);
+                channel.close();
+                return;
+            }
+            // Setup channel based on stream type
+            if (managed.descriptor.type === "binary") {
+                setupIncomingBinaryChannel(managed, channel);
+            }
+            else {
+                setupIncomingJSONChannel(managed, channel);
+            }
+            managed.enabled = true;
+        };
+    }
+    function setupIncomingBinaryChannel(managed, channel) {
+        const descriptor = managed.descriptor;
+        // Create binary stream for frame reassembly
+        managed.binaryStream = createBinaryStream({
+            maxFrameSize: descriptor.maxFrameSize,
+            maxBufferSize: descriptor.maxBufferSize,
+            dropStrategy: "oldest",
+            onFrame: descriptor.onFrame,
+        });
+        // Wrap incoming channel
+        managed.webrtcChannel = wrapDataChannel(channel, (chunk) => managed.binaryStream?.push(chunk));
+    }
+    function setupIncomingJSONChannel(managed, channel) {
+        const descriptor = managed.descriptor;
+        channel.binaryType = "arraybuffer";
+        managed.jsonChannel = channel;
+        channel.onmessage = (event) => {
+            try {
+                const data = typeof event.data === "string" ? JSON.parse(event.data) : null;
+                if (data !== null) {
+                    descriptor.onMessage(data);
+                }
+            }
+            catch (err) {
+                console.warn(`Orchestrator: invalid JSON on stream '${descriptor.name}'`, err);
+            }
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Stream Management
+    // ─────────────────────────────────────────────────────────────────────────
+    function assertNotDisposed() {
+        if (disposed) {
+            throw new Error("Orchestrator has been disposed");
+        }
+    }
+    function enableStreamInternal(name, sendControl) {
+        const managed = streams.get(name);
+        if (!managed) {
+            throw new Error(`Orchestrator: stream '${name}' not registered`);
+        }
+        if (managed.enabled) {
+            return; // Already enabled
+        }
+        if (managed.descriptor.type === "binary") {
+            enableBinaryStream(managed);
+        }
+        else {
+            enableJSONStream(managed);
+        }
+        managed.enabled = true;
+        // Send control message to remote
+        if (sendControl) {
+            controlChannel?.send(createControlMessage(name, true));
+        }
+    }
+    function disableStreamInternal(name, sendControl) {
+        const managed = streams.get(name);
+        if (!managed) {
+            throw new Error(`Orchestrator: stream '${name}' not registered`);
+        }
+        if (!managed.enabled) {
+            return; // Already disabled
+        }
+        // Cleanup resources
+        if (managed.descriptor.type === "binary") {
+            managed.webrtcChannel?.close();
+            managed.binaryStream?.dispose();
+            managed.webrtcChannel = undefined;
+            managed.binaryStream = undefined;
+        }
+        else {
+            managed.jsonChannel?.close();
+            managed.jsonChannel = undefined;
+        }
+        managed.enabled = false;
+        // Send control message to remote
+        if (sendControl) {
+            controlChannel?.send(createControlMessage(name, false));
+        }
+    }
+    function enableBinaryStream(managed) {
+        const descriptor = managed.descriptor;
+        // Create binary stream for frame reassembly
+        managed.binaryStream = createBinaryStream({
+            maxFrameSize: descriptor.maxFrameSize,
+            maxBufferSize: descriptor.maxBufferSize,
+            dropStrategy: "oldest",
+            onFrame: descriptor.onFrame,
+        });
+        // Create WebRTC channel
+        managed.webrtcChannel = createWebRTCBinaryChannel({
+            pc,
+            label: descriptor.name,
+            ordered: true,
+            onChunk: (chunk) => managed.binaryStream?.push(chunk),
+            onStateChange: (state) => {
+                if (state === "closed") {
+                    managed.enabled = false;
+                }
+            },
+        });
+    }
+    function enableJSONStream(managed) {
+        const descriptor = managed.descriptor;
+        const channel = pc.createDataChannel(descriptor.name, {
+            ordered: true,
+        });
+        channel.binaryType = "arraybuffer";
+        managed.jsonChannel = channel;
+        channel.onmessage = (event) => {
+            try {
+                const data = typeof event.data === "string" ? JSON.parse(event.data) : null;
+                if (data !== null) {
+                    descriptor.onMessage(data);
+                }
+            }
+            catch (err) {
+                console.warn(`Orchestrator: invalid JSON on stream '${descriptor.name}'`, err);
+            }
+        };
+        channel.onclose = () => {
+            managed.enabled = false;
+        };
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Public Interface
+    // ─────────────────────────────────────────────────────────────────────────
+    return {
+        registerStream(descriptor) {
+            assertNotDisposed();
+            if (!descriptor.name) {
+                throw new Error("Orchestrator: stream name is required");
+            }
+            if (streams.has(descriptor.name)) {
+                throw new Error(`Orchestrator: stream '${descriptor.name}' already registered`);
+            }
+            const streamType = descriptor.type;
+            if (streamType !== "binary" && streamType !== "json") {
+                throw new Error(`Orchestrator: invalid stream type '${streamType}'`);
+            }
+            const managed = {
+                descriptor,
+                enabled: false,
+            };
+            streams.set(descriptor.name, managed);
+            // Enable if configured
+            if (descriptor.enabledByDefault) {
+                enableStreamInternal(descriptor.name, true);
+            }
+        },
+        enable(name) {
+            assertNotDisposed();
+            enableStreamInternal(name, true);
+        },
+        disable(name) {
+            assertNotDisposed();
+            disableStreamInternal(name, true);
+        },
+        isEnabled(name) {
+            const managed = streams.get(name);
+            return managed?.enabled ?? false;
+        },
+        isRegistered(name) {
+            return streams.has(name);
+        },
+        getStreamNames() {
+            return Array.from(streams.keys());
+        },
+        sendControl(message) {
+            assertNotDisposed();
+            controlChannel?.send(message);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            // Disable all streams (without sending control)
+            for (const name of streams.keys()) {
+                const managed = streams.get(name);
+                if (managed?.enabled) {
+                    if (managed.descriptor.type === "binary") {
+                        managed.webrtcChannel?.close();
+                        managed.binaryStream?.dispose();
+                    }
+                    else {
+                        managed.jsonChannel?.close();
+                    }
+                }
+            }
+            streams.clear();
+            // Close control channel
+            controlChannel?.close();
+            controlChannel = null;
+        },
+    };
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../src/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @streamkit/orchestrator - Type Definitions
+ *
+ * Types for stream orchestration and coordination.
+ */
+import type { BinaryFrame } from "@streamkit/binary-stream";
+/**
+ * Stream transport type.
+ */
+export type StreamType = "binary" | "json";
+/**
+ * Base descriptor for all stream types.
+ */
+export interface BaseStreamDescriptor {
+    /** Unique stream identifier */
+    name: string;
+    /** Transport type */
+    type: StreamType;
+    /** Whether stream is enabled on registration (default: false) */
+    enabledByDefault?: boolean;
+}
+/**
+ * Descriptor for binary frame streams.
+ * Uses @streamkit/binary-stream for frame reassembly.
+ */
+export interface BinaryStreamDescriptor extends BaseStreamDescriptor {
+    type: "binary";
+    /** Callback for complete binary frames */
+    onFrame: (frame: BinaryFrame) => void;
+    /** Maximum frame size in bytes (default: 10MB) */
+    maxFrameSize?: number;
+    /** Maximum buffer size in bytes (default: 50MB) */
+    maxBufferSize?: number;
+}
+/**
+ * Descriptor for JSON message streams.
+ * Used for control messages, telemetry, and structured data.
+ */
+export interface JSONStreamDescriptor extends BaseStreamDescriptor {
+    type: "json";
+    /** Callback for parsed JSON messages */
+    onMessage: (data: unknown) => void;
+}
+/**
+ * Union type for all stream descriptors.
+ */
+export type StreamDescriptor = BinaryStreamDescriptor | JSONStreamDescriptor;
+/**
+ * Control message format for stream coordination.
+ */
+export interface ControlMessage {
+    type: "control";
+    stream: string;
+    enabled: boolean;
+}
+/**
+ * Options for creating an orchestrator.
+ */
+export interface OrchestratorOptions {
+    /** RTCPeerConnection to manage streams on */
+    pc: RTCPeerConnection;
+    /** Optional callback for orchestrator-level errors */
+    onError?: (error: Error) => void;
+    /** Optional callback for control messages received */
+    onControlMessage?: (message: ControlMessage) => void;
+}
+/**
+ * Stream orchestrator interface.
+ */
+export interface Orchestrator {
+    /**
+     * Register a stream descriptor.
+     * Does not open the channel until enable() is called.
+     * @param descriptor - Stream configuration
+     */
+    registerStream(descriptor: StreamDescriptor): void;
+    /**
+     * Enable a registered stream.
+     * Creates the DataChannel and starts receiving data.
+     * Sends control message to remote peer.
+     * @param name - Stream name
+     */
+    enable(name: string): void;
+    /**
+     * Disable an active stream.
+     * Closes the DataChannel and stops receiving data.
+     * Sends control message to remote peer.
+     * @param name - Stream name
+     */
+    disable(name: string): void;
+    /**
+     * Check if a stream is currently enabled.
+     * @param name - Stream name
+     */
+    isEnabled(name: string): boolean;
+    /**
+     * Check if a stream is registered.
+     * @param name - Stream name
+     */
+    isRegistered(name: string): boolean;
+    /**
+     * Get list of all registered stream names.
+     */
+    getStreamNames(): string[];
+    /**
+     * Send a control message to the remote peer.
+     * @param message - Control message to send
+     */
+    sendControl(message: ControlMessage): void;
+    /**
+     * Dispose all streams and release resources.
+     */
+    dispose(): void;
+}
+export type { BinaryFrame } from "@streamkit/binary-stream";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,IAAI,EAAE,QAAQ,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,oBAAoB,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6CAA6C;IAC7C,EAAE,EAAE,iBAAiB,CAAC;IACtB,sDAAsD;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,cAAc,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAEjC;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE,CAAC;IAE3B;;;OAGG;IACH,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAE3C;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAGD,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @streamkit/orchestrator - Type Definitions
+ *
+ * Types for stream orchestration and coordination.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "streamkit-orchestrator",
+  "version": "0.4.0-alpha.0",
+  "description": "Lightweight stream orchestrator for coordinating multiple WebRTC binary streams",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "webrtc",
+    "stream",
+    "orchestrator",
+    "binary",
+    "real-time"
+  ],
+  "dependencies": {
+    "@jervis/streamkit-binary-stream": "^0.4.0-alpha.0",
+    "@jervis/streamkit-webrtc": "^0.4.0-alpha.0"
+  },
+  "devDependencies": {
+    "rimraf": "^5.0.5",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}