@ceralive/cerastream 2026.9.4 → 2026.9.5

package/README.md

@@ -9,6 +9,7 @@ engine's JSON-RPC 2.0 / NDJSON control plane over a Unix domain socket.
 - The nine server-push event payloads (discriminated union)
 - Two-tier error codes (RPC + runtime)
 - Typed capture-probe causes retained on runtime events and rejected-start exceptions
+  (including HDMI `unsupported-format`, `interlaced-unsupported`, `source-changed`)
 - Typed platform capture-converter reporting (`librga`, `v4l2-rga2`, or `none`)
 - Typed RK3588 composition config (secondary input, six PiP/PbP layouts, alpha),
   gated by the READY-trialled `composition` capability token
@@ -18,6 +19,9 @@ engine's JSON-RPC 2.0 / NDJSON control plane over a Unix domain socket.
   local preview availability
 - Per-codec encoder capability entries with format, resolution/framerate, and
   explicit 4K60 qualification-gate truth
+- Additive `client.setEdidProfile()` — switch the HDMI-RX EDID between the named
+  `full` / `robust-4k60` profiles as one transaction: written, byte-verified,
+  persisted, then the device projection re-read only after the link settles
 - Additive `client.changeConfig()` — reconfigure the live session (resolution,
   framerate, codec, pipeline, source) as one transaction with typed rollback;
   composition-only changes use live layout/alpha writes and secondary rebind

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { type HelloResult } from './envelope.js';
 import { type EventParams } from './events.js';
-import { type ChangeConfigParams, type ChangeConfigResult, type GetCapabilitiesResult, type ListDevicesParams, type ListDevicesResult, type PreviewSessionParams, type PreviewSessionResult, type ReloadConfigParams, type ReloadConfigResult, type RequestKeyframeResult, 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 ChangeConfigParams, type ChangeConfigResult, type GetCapabilitiesResult, type ListDevicesParams, type ListDevicesResult, type PreviewSessionParams, type PreviewSessionResult, type ReloadConfigParams, type ReloadConfigResult, type RequestKeyframeResult, type SetBitrateParams, type SetBitrateResult, type SetEdidProfileParams, type SetEdidProfileResult, 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. */
@@ -65,6 +65,16 @@ export interface CerastreamClient {
      */
     setBitrate(params: SetBitrateParams): Promise<SetBitrateResult>;
     requestKeyframe(): Promise<RequestKeyframeResult>;
+    /**
+     * Switch the HDMI-RX EDID profile transactionally: write, byte-verify,
+     * persist, then re-read the device projection once the link has settled.
+     * @param params The profile to advertise.
+     * @returns The committed profile, the one it replaced, and the post-settle devices.
+     * @throws {CerastreamRpcError} `cerastream.params.invalid` prefixed
+     * `capture-active` while any capture leg is live — including when the driver
+     * itself refuses the write — and `hdmirx-unavailable` on a board with no receiver.
+     */
+    setEdidProfile(params: SetEdidProfileParams): Promise<SetEdidProfileResult>;
     /**
      * Switch the active capture source (manual) or hand selection to failover (auto).
      * @param params The target input id and switch mode.

package/dist/client.js

@@ -3,7 +3,7 @@ import { CONTROL_SOCKET_PATH, PROTOCOL_VERSION } from './constants.js';
 import { helloResultSchema, rpcErrorSchema, rpcResponseSchema, } from './envelope.js';
 import { CerastreamConnectionError, CerastreamRpcError, CerastreamTimeoutError, } from './errors.js';
 import { eventParamsSchema } from './events.js';
-import { changeConfigParamsSchema, changeConfigResultSchema, getCapabilitiesResultSchema, requestKeyframeResultSchema, requestSchemas, } from './messages.js';
+import { changeConfigParamsSchema, changeConfigResultSchema, getCapabilitiesResultSchema, requestKeyframeResultSchema, requestSchemas, setEdidProfileResultSchema, } from './messages.js';
 import { controlSocketPath } from './paths.js';
 import { LineSocket } from './transport.js';
 const DEFAULTS = {
@@ -73,6 +73,9 @@ class ClientImpl {
     async requestKeyframe() {
         return requestKeyframeResultSchema.parse(await this.rawRequest('request-keyframe', {}));
     }
+    async setEdidProfile(params) {
+        return setEdidProfileResultSchema.parse(await this.rawRequest('hdmirx.setEdidProfile', params));
+    }
     switchInput(params) {
         return this.call('switch-input', params);
     }

package/dist/constants.d.ts

@@ -8,7 +8,7 @@ export declare const PROTOCOL_VERSION: 'cerastream-ipc/1';
  * additive-only within protocol major `cerastream-ipc/1` (ADR-0002 §4); this value
  * only moves when the wire schema itself does, in lockstep across both languages.
  */
-export declare const SCHEMA_VERSION: '0.16.0';
+export declare const SCHEMA_VERSION: '0.17.0';
 /** Runtime dir holding both control + preview sockets. systemd `RuntimeDirectory=cerastream`. */
 export declare const DEFAULT_IPC_DIR: '/run/cerastream';
 /** Env override for the IPC dir (tests/dev). Defaults to {@link DEFAULT_IPC_DIR}. */

package/dist/constants.js

@@ -11,7 +11,7 @@ export const PROTOCOL_VERSION = 'cerastream-ipc/1';
  * additive-only within protocol major `cerastream-ipc/1` (ADR-0002 §4); this value
  * only moves when the wire schema itself does, in lockstep across both languages.
  */
-export const SCHEMA_VERSION = '0.16.0';
+export const SCHEMA_VERSION = '0.17.0';
 /** Runtime dir holding both control + preview sockets. systemd `RuntimeDirectory=cerastream`. */
 export const DEFAULT_IPC_DIR = '/run/cerastream';
 /** Env override for the IPC dir (tests/dev). Defaults to {@link DEFAULT_IPC_DIR}. */

package/dist/errors.d.ts

@@ -99,11 +99,14 @@ export declare const captureCauseSchema: z.ZodEnum<{
     "composition-unsupported": "composition-unsupported";
     "decoder-unavailable": "decoder-unavailable";
     device_busy: "device_busy";
+    "interlaced-unsupported": "interlaced-unsupported";
     negotiation_failed: "negotiation_failed";
     no_signal: "no_signal";
     no_silicon_converter: "no_silicon_converter";
     "secondary-unavailable": "secondary-unavailable";
     "software-pixel-path-rejected": "software-pixel-path-rejected";
+    "source-changed": "source-changed";
+    "unsupported-format": "unsupported-format";
 }>;
 export type CaptureCause = z.infer<typeof captureCauseSchema>;
 export declare const captureCauseEntrySchema: z.ZodObject<{
@@ -112,11 +115,14 @@ export declare const captureCauseEntrySchema: z.ZodObject<{
         "composition-unsupported": "composition-unsupported";
         "decoder-unavailable": "decoder-unavailable";
         device_busy: "device_busy";
+        "interlaced-unsupported": "interlaced-unsupported";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
         no_silicon_converter: "no_silicon_converter";
         "secondary-unavailable": "secondary-unavailable";
         "software-pixel-path-rejected": "software-pixel-path-rejected";
+        "source-changed": "source-changed";
+        "unsupported-format": "unsupported-format";
     }>;
 }, z.core.$strip>;
 export type CaptureCauseEntry = z.infer<typeof captureCauseEntrySchema>;

package/dist/errors.js

@@ -147,6 +147,9 @@ export const captureCauseSchema = z.enum([
     'software-pixel-path-rejected',
     'composition-unsupported',
     'secondary-unavailable',
+    'unsupported-format',
+    'interlaced-unsupported',
+    'source-changed',
 ]);
 export const captureCauseEntrySchema = z.object({
     device: z.string(),

package/dist/events.d.ts

@@ -243,11 +243,14 @@ export declare const runtimeErrorEventSchema: z.ZodObject<{
         "composition-unsupported": "composition-unsupported";
         "decoder-unavailable": "decoder-unavailable";
         device_busy: "device_busy";
+        "interlaced-unsupported": "interlaced-unsupported";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
         no_silicon_converter: "no_silicon_converter";
         "secondary-unavailable": "secondary-unavailable";
         "software-pixel-path-rejected": "software-pixel-path-rejected";
+        "source-changed": "source-changed";
+        "unsupported-format": "unsupported-format";
     }>>;
 }, z.core.$strip>;
 /** Payload of a {@link runtimeErrorEventSchema} event. */
@@ -471,11 +474,14 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         "composition-unsupported": "composition-unsupported";
         "decoder-unavailable": "decoder-unavailable";
         device_busy: "device_busy";
+        "interlaced-unsupported": "interlaced-unsupported";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
         no_silicon_converter: "no_silicon_converter";
         "secondary-unavailable": "secondary-unavailable";
         "software-pixel-path-rejected": "software-pixel-path-rejected";
+        "source-changed": "source-changed";
+        "unsupported-format": "unsupported-format";
     }>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"preview">;
@@ -673,11 +679,14 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             "composition-unsupported": "composition-unsupported";
             "decoder-unavailable": "decoder-unavailable";
             device_busy: "device_busy";
+            "interlaced-unsupported": "interlaced-unsupported";
             negotiation_failed: "negotiation_failed";
             no_signal: "no_signal";
             no_silicon_converter: "no_silicon_converter";
             "secondary-unavailable": "secondary-unavailable";
             "software-pixel-path-rejected": "software-pixel-path-rejected";
+            "source-changed": "source-changed";
+            "unsupported-format": "unsupported-format";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"preview">;
@@ -884,11 +893,14 @@ export declare const eventSchemas: {
             "composition-unsupported": "composition-unsupported";
             "decoder-unavailable": "decoder-unavailable";
             device_busy: "device_busy";
+            "interlaced-unsupported": "interlaced-unsupported";
             negotiation_failed: "negotiation_failed";
             no_signal: "no_signal";
             no_silicon_converter: "no_silicon_converter";
             "secondary-unavailable": "secondary-unavailable";
             "software-pixel-path-rejected": "software-pixel-path-rejected";
+            "source-changed": "source-changed";
+            "unsupported-format": "unsupported-format";
         }>>;
     }, z.core.$strip>;
     readonly preview: z.ZodObject<{

package/dist/messages.d.ts

@@ -179,6 +179,97 @@ export declare const requestKeyframeResultSchema: z.ZodObject<{
     applied: z.ZodLiteral<true>;
 }, z.core.$strip>;
 export type RequestKeyframeResult = z.infer<typeof requestKeyframeResultSchema>;
+export declare const edidProfileSchema: z.ZodEnum<{
+    full: "full";
+    "robust-4k60": "robust-4k60";
+}>;
+export type EdidProfile = z.infer<typeof edidProfileSchema>;
+export declare const setEdidProfileParamsSchema: z.ZodObject<{
+    profile: z.ZodEnum<{
+        full: "full";
+        "robust-4k60": "robust-4k60";
+    }>;
+}, z.core.$strip>;
+export type SetEdidProfileParams = z.infer<typeof setEdidProfileParamsSchema>;
+export declare const edidSettleOutcomeSchema: z.ZodEnum<{
+    "no-signal": "no-signal";
+    relocked: "relocked";
+    unknown: "unknown";
+}>;
+export type EdidSettleOutcome = z.infer<typeof edidSettleOutcomeSchema>;
+export declare const setEdidProfileResultSchema: z.ZodObject<{
+    profile: z.ZodEnum<{
+        full: "full";
+        "robust-4k60": "robust-4k60";
+    }>;
+    previous: z.ZodEnum<{
+        full: "full";
+        "robust-4k60": "robust-4k60";
+    }>;
+    applied: z.ZodLiteral<true>;
+    settle: z.ZodEnum<{
+        "no-signal": "no-signal";
+        relocked: "relocked";
+        unknown: "unknown";
+    }>;
+    devices: z.ZodArray<z.ZodObject<{
+        input_id: z.ZodString;
+        device_path: z.ZodString;
+        display_name: z.ZodString;
+        media_class: z.ZodEnum<{
+            audio: "audio";
+            video: "video";
+        }>;
+        caps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            framerate: z.ZodOptional<z.ZodString>;
+            media_type: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        kind: z.ZodOptional<z.ZodEnum<{
+            audio: "audio";
+            camlink: "camlink";
+            hdmi: "hdmi";
+            mjpeg: "mjpeg";
+            network: "network";
+            test: "test";
+            uvc_h264: "uvc_h264";
+            uvc_h265: "uvc_h265";
+        }>>;
+        modes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            media_type: z.ZodString;
+            pipeline_kind: z.ZodEnum<{
+                audio: "audio";
+                camlink: "camlink";
+                hdmi: "hdmi";
+                mjpeg: "mjpeg";
+                network: "network";
+                test: "test";
+                uvc_h264: "uvc_h264";
+                uvc_h265: "uvc_h265";
+            }>;
+            caps: z.ZodArray<z.ZodObject<{
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                framerate: z.ZodOptional<z.ZodString>;
+                media_type: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        alsa_card_id: z.ZodOptional<z.ZodString>;
+        product_name: z.ZodOptional<z.ZodString>;
+        transport: z.ZodOptional<z.ZodEnum<{
+            bluetooth: "bluetooth";
+            hdmi: "hdmi";
+            onboard: "onboard";
+            usb: "usb";
+        }>>;
+        stable_id: z.ZodOptional<z.ZodString>;
+        physical_group_id: z.ZodOptional<z.ZodString>;
+        hardware_serial: z.ZodOptional<z.ZodString>;
+        device_address: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SetEdidProfileResult = z.infer<typeof setEdidProfileResultSchema>;
 export declare const switchInputParamsSchema: z.ZodObject<{
     input_id: z.ZodString;
     mode: z.ZodDefault<z.ZodEnum<{

package/dist/messages.js

@@ -74,6 +74,23 @@ export const setBitrateResultSchema = z.object({
 });
 export const requestKeyframeParamsSchema = z.object({});
 export const requestKeyframeResultSchema = z.object({ applied: z.literal(true) });
+// ---- 4b. hdmirx.setEdidProfile (additive, 0.17.0; not in V1_METHODS) ----
+// The operator picks a named POLICY, never a blob: an EDID is a checksummed
+// 256-byte structure whose contents the device owns.
+export const edidProfileSchema = z.enum(['full', 'robust-4k60']);
+export const setEdidProfileParamsSchema = z.object({ profile: edidProfileSchema });
+// How the receiver settled before `devices` below was re-read, so a consumer can
+// tell "relocked and here are its real modes" from "the link is dark".
+export const edidSettleOutcomeSchema = z.enum(['relocked', 'no-signal', 'unknown']);
+export const setEdidProfileResultSchema = z.object({
+    profile: edidProfileSchema,
+    previous: edidProfileSchema,
+    // Always true: a non-applied attempt is an RPC error, never this result.
+    applied: z.literal(true),
+    settle: edidSettleOutcomeSchema,
+    // The POST-SETTLE list-devices projection — never the pre-switch mode list.
+    devices: z.array(captureDeviceSchema),
+});
 // ---- 5. switch-input ----
 export const switchInputParamsSchema = z.object({
     input_id: z.string(), // device/input identifier from list-devices

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ceralive/cerastream",
-	"version": "2026.9.4",
+	"version": "2026.9.5",
 	"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",