@ceralive/cerastream 2026.9.1 → 2026.9.2

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
+- Typed platform capture-converter reporting (`librga`, `v4l2-rga2`, or `none`)
 - A unified engine config schema (= `start` params)
 - A `CerastreamClient` interface + `connect()` factory (UDS transport)
 - Additive `client.getCapabilities()` discovery for platform, source, encoder, and

package/dist/errors.d.ts

@@ -99,6 +99,7 @@ export declare const captureCauseSchema: z.ZodEnum<{
     device_busy: "device_busy";
     negotiation_failed: "negotiation_failed";
     no_signal: "no_signal";
+    no_silicon_converter: "no_silicon_converter";
 }>;
 export type CaptureCause = z.infer<typeof captureCauseSchema>;
 export declare const captureCauseEntrySchema: z.ZodObject<{
@@ -107,6 +108,7 @@ export declare const captureCauseEntrySchema: z.ZodObject<{
         device_busy: "device_busy";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
+        no_silicon_converter: "no_silicon_converter";
     }>;
 }, z.core.$strip>;
 export type CaptureCauseEntry = z.infer<typeof captureCauseEntrySchema>;

package/dist/errors.js

@@ -138,7 +138,12 @@ export const processErrorCodeSchema = z.enum([
     // would be lying. Always carries a captureUnrecoverableReasonSchema `reason`.
     'capture_unrecoverable',
 ]);
-export const captureCauseSchema = z.enum(['negotiation_failed', 'no_signal', 'device_busy']);
+export const captureCauseSchema = z.enum([
+    'negotiation_failed',
+    'no_signal',
+    'device_busy',
+    'no_silicon_converter',
+]);
 export const captureCauseEntrySchema = z.object({
     device: z.string(),
     cause: captureCauseSchema,

package/dist/events.d.ts

@@ -243,6 +243,7 @@ export declare const runtimeErrorEventSchema: z.ZodObject<{
         device_busy: "device_busy";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
+        no_silicon_converter: "no_silicon_converter";
     }>>;
 }, z.core.$strip>;
 /** Payload of a {@link runtimeErrorEventSchema} event. */
@@ -466,6 +467,7 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         device_busy: "device_busy";
         negotiation_failed: "negotiation_failed";
         no_signal: "no_signal";
+        no_silicon_converter: "no_silicon_converter";
     }>>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"preview">;
@@ -663,6 +665,7 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             device_busy: "device_busy";
             negotiation_failed: "negotiation_failed";
             no_signal: "no_signal";
+            no_silicon_converter: "no_silicon_converter";
         }>>;
     }, z.core.$strip>, z.ZodObject<{
         type: z.ZodLiteral<"preview">;
@@ -869,6 +872,7 @@ export declare const eventSchemas: {
             device_busy: "device_busy";
             negotiation_failed: "negotiation_failed";
             no_signal: "no_signal";
+            no_silicon_converter: "no_silicon_converter";
         }>>;
     }, z.core.$strip>;
     readonly preview: z.ZodObject<{

package/dist/messages.d.ts

@@ -359,6 +359,12 @@ export declare const encoderCapsSchema: z.ZodObject<{
     }, z.core.$strip>;
 }, z.core.$strip>;
 export type EncoderCaps = z.infer<typeof encoderCapsSchema>;
+export declare const platformConverterSchema: z.ZodEnum<{
+    librga: "librga";
+    none: "none";
+    "v4l2-rga2": "v4l2-rga2";
+}>;
+export type PlatformConverter = z.infer<typeof platformConverterSchema>;
 export declare const platformCapsSchema: z.ZodObject<{
     supports_h265: z.ZodBoolean;
     hardware_accelerated: z.ZodBoolean;
@@ -373,6 +379,11 @@ export declare const platformCapsSchema: z.ZodObject<{
         detected: "detected";
         override: "override";
     }>>;
+    converter: z.ZodOptional<z.ZodEnum<{
+        librga: "librga";
+        none: "none";
+        "v4l2-rga2": "v4l2-rga2";
+    }>>;
 }, z.core.$strip>;
 export type PlatformCaps = z.infer<typeof platformCapsSchema>;
 export declare const previewAvailabilitySchema: z.ZodObject<{
@@ -397,6 +408,11 @@ export declare const getCapabilitiesResultSchema: z.ZodObject<{
             detected: "detected";
             override: "override";
         }>>;
+        converter: z.ZodOptional<z.ZodEnum<{
+            librga: "librga";
+            none: "none";
+            "v4l2-rga2": "v4l2-rga2";
+        }>>;
     }, z.core.$strip>;
     encoder: z.ZodObject<{
         codecs: z.ZodArray<z.ZodString>;

package/dist/messages.js

@@ -172,6 +172,7 @@ export const encoderCapsSchema = z.object({
     codecs: z.array(z.string()),
     bitrate_range: bitrateRangeCapsSchema,
 });
+export const platformConverterSchema = z.enum(['librga', 'v4l2-rga2', 'none']);
 export const platformCapsSchema = z.object({
     supports_h265: z.boolean(),
     hardware_accelerated: z.boolean(),
@@ -180,6 +181,7 @@ export const platformCapsSchema = z.object({
     // Optional so a pre-field engine (which omits both) still parses.
     hardware_kind: z.enum(['rk3588', 'jetson', 'n100', 'generic']).optional(),
     source: z.enum(['detected', 'override']).optional(),
+    converter: platformConverterSchema.optional(),
 });
 // Preview-server availability (0.4.0, additive). Lets the UI tell an unbound /
 // port-conflicted preview (enabled:true, bound:false) from a down engine.

package/package.json

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