@ceralive/cerastream 2026.6.1 → 2026.6.2

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.1.0-stub";
+export declare const SCHEMA_VERSION: "0.3.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}. */
@@ -23,6 +23,8 @@ export declare const CONTROL_SOCKET_PATH: "/run/cerastream/control.sock";
 export declare const PREVIEW_SOCKET_PATH: "/run/cerastream/preview.sock";
 /** Per-line framing cap (ADR-0002 §1): an oversized line is a fatal protocol error. */
 export declare const MAX_LINE_BYTES: number;
+/** Upper bound (ms) for `reload-config.audio.delay_ms`. Mirrors the Rust `AUDIO_DELAY_MAX_MS` and CeraUI's `AUDIO_DELAY_MAX`. */
+export declare const AUDIO_DELAY_MAX_MS = 2000;
 /** Engine binary name (systemd-owned; CeraUI never spawns it — ADR-0005). */
 export declare const CERASTREAM_BIN: "cerastream";
 export declare const DEFAULT_MIN_BITRATE = 300;

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.1.0-stub";
+export const SCHEMA_VERSION = "0.3.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}. */
@@ -26,6 +26,8 @@ export const CONTROL_SOCKET_PATH = "/run/cerastream/control.sock";
 export const PREVIEW_SOCKET_PATH = "/run/cerastream/preview.sock";
 /** Per-line framing cap (ADR-0002 §1): an oversized line is a fatal protocol error. */
 export const MAX_LINE_BYTES = 1024 * 1024; // 1 MiB
+/** Upper bound (ms) for `reload-config.audio.delay_ms`. Mirrors the Rust `AUDIO_DELAY_MAX_MS` and CeraUI's `AUDIO_DELAY_MAX`. */
+export const AUDIO_DELAY_MAX_MS = 2000;
 /** Engine binary name (systemd-owned; CeraUI never spawns it — ADR-0005). */
 export const CERASTREAM_BIN = "cerastream";
 // ---- config defaults (mirror ceracoder, the engine being replaced) ----

package/dist/errors.d.ts

@@ -42,6 +42,7 @@ export declare const rpcErrorCodeSchema: z.ZodEnum<{
     "cerastream.state.not_streaming": "cerastream.state.not_streaming";
     "cerastream.state.already_streaming": "cerastream.state.already_streaming";
     "cerastream.device.not_found": "cerastream.device.not_found";
+    "cerastream.audio.device_not_found": "cerastream.audio.device_not_found";
     "cerastream.bitrate.out_of_range": "cerastream.bitrate.out_of_range";
     "cerastream.preview.unsupported_tier": "cerastream.preview.unsupported_tier";
     "cerastream.internal": "cerastream.internal";

package/dist/errors.js

@@ -60,6 +60,7 @@ export const rpcErrorCodeSchema = z.enum([
     "cerastream.state.not_streaming",
     "cerastream.state.already_streaming",
     "cerastream.device.not_found",
+    "cerastream.audio.device_not_found",
     "cerastream.bitrate.out_of_range",
     "cerastream.preview.unsupported_tier",
     "cerastream.internal",
@@ -75,6 +76,7 @@ export const RPC_ERROR_NUMERIC = {
     "cerastream.state.not_streaming": -32001,
     "cerastream.state.already_streaming": -32002,
     "cerastream.device.not_found": -32003,
+    "cerastream.audio.device_not_found": -32006,
     "cerastream.bitrate.out_of_range": -32004,
     "cerastream.preview.unsupported_tier": -32005,
     "cerastream.internal": -32603,

package/dist/events.d.ts

@@ -21,6 +21,10 @@ export declare const switchEventSchema: z.ZodObject<{
         auto: "auto";
     }>;
     reason: z.ZodOptional<z.ZodString>;
+    media_class: z.ZodOptional<z.ZodEnum<{
+        video: "video";
+        audio: "audio";
+    }>>;
 }, z.core.$strip>;
 export type SwitchEvent = z.infer<typeof switchEventSchema>;
 export declare const deviceEventSchema: z.ZodObject<{
@@ -109,6 +113,10 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         auto: "auto";
     }>;
     reason: z.ZodOptional<z.ZodString>;
+    media_class: z.ZodOptional<z.ZodEnum<{
+        video: "video";
+        audio: "audio";
+    }>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"device">;
     seq: z.ZodNumber;
@@ -190,6 +198,10 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             auto: "auto";
         }>;
         reason: z.ZodOptional<z.ZodString>;
+        media_class: z.ZodOptional<z.ZodEnum<{
+            video: "video";
+            audio: "audio";
+        }>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"device">;
         seq: z.ZodNumber;
@@ -274,6 +286,10 @@ export declare const eventSchemas: {
             auto: "auto";
         }>;
         reason: z.ZodOptional<z.ZodString>;
+        media_class: z.ZodOptional<z.ZodEnum<{
+            video: "video";
+            audio: "audio";
+        }>>;
     }, z.core.$strip>;
     readonly device: z.ZodObject<{
         type: z.ZodLiteral<"device">;

package/dist/events.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { processErrorCodeSchema, processErrorSourceSchema, } from "./errors.js";
-import { captureDeviceSchema, inputModeSchema, streamStateSchema, } from "./types.js";
+import { captureDeviceSchema, inputModeSchema, mediaClassSchema, streamStateSchema, } from "./types.js";
 // Server → client `event` notifications, delivered after `subscribe-events`
 // (schema.md "Events"). Each event is the inner `params` of an rpcEventSchema:
 // { type, seq, … }. `type` discriminates; `seq` is a per-type monotonic counter.
@@ -13,13 +13,15 @@ export const statusEventSchema = z.object({
     streaming: z.boolean(),
     active_input: z.string().optional(),
 });
-// switch — active input changed (manual or failover)
+// switch — active input changed (manual or failover). media_class is additive
+// (absent on legacy video-only emitters); switch-audio sets it to "audio".
 export const switchEventSchema = z.object({
     type: z.literal("switch"),
     seq,
     active_input: z.string(),
     mode: inputModeSchema,
     reason: z.string().optional(),
+    media_class: mediaClassSchema.optional(),
 });
 // device — GstDeviceMonitor hotplug
 export const deviceEventSchema = z.object({

package/dist/messages.d.ts

@@ -56,6 +56,9 @@ export declare const reloadConfigParamsSchema: z.ZodObject<{
     srt: z.ZodOptional<z.ZodObject<{
         latency_ms: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    audio: z.ZodOptional<z.ZodObject<{
+        delay_ms: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ReloadConfigParams = z.infer<typeof reloadConfigParamsSchema>;
 export declare const reloadConfigResultSchema: z.ZodObject<{
@@ -72,6 +75,9 @@ export declare const reloadConfigResultSchema: z.ZodObject<{
         srt: z.ZodOptional<z.ZodObject<{
             latency_ms: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        audio: z.ZodOptional<z.ZodObject<{
+            delay_ms: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type ReloadConfigResult = z.infer<typeof reloadConfigResultSchema>;
@@ -101,6 +107,22 @@ export declare const switchInputResultSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export type SwitchInputResult = z.infer<typeof switchInputResultSchema>;
+export declare const switchAudioParamsSchema: z.ZodObject<{
+    audio_input_id: z.ZodString;
+    mode: z.ZodOptional<z.ZodEnum<{
+        manual: "manual";
+        auto: "auto";
+    }>>;
+}, z.core.$strip>;
+export type SwitchAudioParams = z.infer<typeof switchAudioParamsSchema>;
+export declare const switchAudioResultSchema: z.ZodObject<{
+    active_audio_input: z.ZodString;
+    mode: z.ZodEnum<{
+        manual: "manual";
+        auto: "auto";
+    }>;
+}, z.core.$strip>;
+export type SwitchAudioResult = z.infer<typeof switchAudioResultSchema>;
 export declare const listDevicesParamsSchema: z.ZodOptional<z.ZodObject<{
     media_class: z.ZodOptional<z.ZodEnum<{
         video: "video";
@@ -243,6 +265,7 @@ export declare const getCapabilitiesResultSchema: z.ZodObject<{
         default_resolution: z.ZodString;
         default_framerate: z.ZodNumber;
     }, z.core.$strip>>;
+    audio_live_switch: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type GetCapabilitiesResult = z.infer<typeof getCapabilitiesResultSchema>;
 /** The eight v1 control methods (the literal JSON-RPC `method` strings). */
@@ -323,6 +346,9 @@ export declare const requestSchemas: {
             srt: z.ZodOptional<z.ZodObject<{
                 latency_ms: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>;
+            audio: z.ZodOptional<z.ZodObject<{
+                delay_ms: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
         readonly result: z.ZodObject<{
             applied: z.ZodObject<{
@@ -338,6 +364,9 @@ export declare const requestSchemas: {
                 srt: z.ZodOptional<z.ZodObject<{
                     latency_ms: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>;
+                audio: z.ZodOptional<z.ZodObject<{
+                    delay_ms: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
             }, z.core.$strip>;
         }, z.core.$strip>;
     };

package/dist/messages.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { AUDIO_DELAY_MAX_MS } from "./constants.js";
 import { helloParamsSchema, helloResultSchema, } from "./envelope.js";
 import { balancerAlgorithmSchema, captureDeviceSchema, cerastreamConfigSchema, inputModeSchema, mediaClassSchema, previewTierSchema, streamStateSchema, } from "./types.js";
 // The eight v1 control methods (schema.md "v1 messages"). Each is matched
@@ -34,6 +35,11 @@ export const reloadConfigParamsSchema = z.object({
         latency_ms: z.number().int().min(100).max(10_000).optional(),
     })
         .optional(),
+    audio: z
+        .object({
+        delay_ms: z.number().int().min(0).max(AUDIO_DELAY_MAX_MS).optional(),
+    })
+        .optional(),
 });
 export const reloadConfigResultSchema = z.object({
     applied: reloadConfigParamsSchema, // post-clamp values actually applied
@@ -54,6 +60,18 @@ export const switchInputResultSchema = z.object({
     active_input: z.string(),
     mode: inputModeSchema,
 });
+// ---- 5b. switch-audio (additive; the audio mirror of switch-input) ----
+// Drives the live audio fallbackswitch active-pad. Additive standalone schema
+// (like get-capabilities): kept OUT of V1_METHODS / requestSchemas so the frozen
+// eight-method contract count is unchanged. `mode` is optional (absent ⇒ manual).
+export const switchAudioParamsSchema = z.object({
+    audio_input_id: z.string(), // audio device/input identifier from list-devices
+    mode: inputModeSchema.optional(),
+});
+export const switchAudioResultSchema = z.object({
+    active_audio_input: z.string(),
+    mode: inputModeSchema,
+});
 // ---- 6. list-devices ----
 export const listDevicesParamsSchema = z
     .object({
@@ -133,6 +151,7 @@ export const getCapabilitiesResultSchema = z.object({
     platform: platformCapsSchema,
     encoder: encoderCapsSchema,
     sources: z.array(videoSourceCapSchema),
+    audio_live_switch: z.boolean().optional(),
 });
 // ---- method registry (count-assertion source of truth) ----
 /** The eight v1 control methods (the literal JSON-RPC `method` strings). */

package/package.json

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