@ceralive/cerastream 2026.7.1 → 2026.7.2

package/README.md

@@ -10,6 +10,8 @@ engine's JSON-RPC 2.0 / NDJSON control plane over a Unix domain socket.
 - Two-tier error codes (RPC + runtime)
 - A unified engine config schema (= `start` params)
 - A `CerastreamClient` interface + `connect()` factory (UDS transport)
+- Additive `client.getCapabilities()` discovery for platform, source, encoder, and
+  local preview availability
 
 The Zod schemas, types, and constants are the frozen wire contract; `connect()`
 drives that contract over an NDJSON/UDS transport with no native dependencies.
@@ -45,6 +47,8 @@ import { connect } from "@ceralive/cerastream";
 
 const client = await connect({ autoReconnect: true }); // hello handshake runs here
 console.log(client.hello.engine_version);
+const capabilities = await client.getCapabilities();
+console.log(capabilities.preview?.bound);
 
 const sub = await client.subscribeEvents({ topics: ["status", "bitrate"] }, (ev) => {
   if (ev.type === "bitrate") console.log("bitrate", ev.current_bitrate);

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { type HelloResult } from "./envelope.js";
 import { type EventParams } from "./events.js";
-import { type ListDevicesParams, type ListDevicesResult, type PreviewSessionParams, type PreviewSessionResult, type ReloadConfigParams, type ReloadConfigResult, type SetBitrateParams, type SetBitrateResult, type StartParams, type StartResult, type StopParams, type StopResult, type SubscribeEventsParams, type SubscribeEventsResult, type SwitchInputParams, type SwitchInputResult } from "./messages.js";
+import { type GetCapabilitiesResult, type ListDevicesParams, type ListDevicesResult, type PreviewSessionParams, type PreviewSessionResult, type ReloadConfigParams, type ReloadConfigResult, type SetBitrateParams, type SetBitrateResult, type StartParams, type StartResult, type StopParams, type StopResult, type SubscribeEventsParams, type SubscribeEventsResult, type SwitchInputParams, type SwitchInputResult } from "./messages.js";
 /** Options for {@link connect}. All optional — `connect({})` is valid. */
 export interface ConnectOptions {
     /** Control socket path override. Defaults to the resolved /run/cerastream/control.sock. */
@@ -77,6 +77,11 @@ export interface CerastreamClient {
      * @returns The discovered capture devices.
      */
     listDevices(params?: ListDevicesParams): Promise<ListDevicesResult>;
+    /**
+     * Read the engine's additive capability contract, including local preview
+     * availability. This request intentionally sits outside the frozen v1 map.
+     */
+    getCapabilities(): Promise<GetCapabilitiesResult>;
     /**
      * Subscribe to the live event stream; `handler` fires for each pushed event.
      * @param params The topics to subscribe to (absent ⇒ all topics).

package/dist/client.js

@@ -3,7 +3,7 @@ import { helloResultSchema, rpcErrorSchema, rpcResponseSchema, } from "./envelop
 import { CerastreamConnectionError, CerastreamRpcError, CerastreamTimeoutError, } from "./errors.js";
 import { eventParamsSchema } from "./events.js";
 import { controlSocketPath } from "./paths.js";
-import { requestSchemas, } from "./messages.js";
+import { getCapabilitiesResultSchema, requestSchemas, } from "./messages.js";
 import { LineSocket } from "./transport.js";
 const DEFAULTS = {
     requestTimeoutMs: 10_000,
@@ -78,6 +78,9 @@ class ClientImpl {
     listDevices(params) {
         return this.call("list-devices", params);
     }
+    async getCapabilities() {
+        return getCapabilitiesResultSchema.parse(await this.rawRequest("get-capabilities", undefined));
+    }
     previewSession(params) {
         return this.call("preview-session", params);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ceralive/cerastream",
-  "version": "2026.7.1",
+  "version": "2026.7.2",
   "description": "Type-safe TypeScript schema + IPC client for the cerastream streaming engine (JSON-RPC 2.0 / NDJSON over a Unix domain socket).",
   "type": "module",
   "main": "dist/index.js",