@ceralive/cerastream 2026.8.0 → 2026.8.1

package/dist/constants.d.ts

@@ -56,14 +56,27 @@ export declare const SUPPORTED_PROFILES: readonly ['balanced', 'low-latency', 'r
  * set or any preset's meaning changes. Mirrors the Rust `PROFILE_CATALOG_VERSION`.
  */
 export declare const PROFILE_CATALOG_VERSION: '1.0.0';
+/**
+ * PipeWire-backed audio capture: the engine addresses capture nodes by
+ * `node.name`/`object.serial`, so a source with no ALSA card — a Bluetooth
+ * microphone is the first one — is selectable as an ordinary node. Unlike the
+ * other tokens this one describes the engine's RUNNING configuration, so an
+ * engine configured for ALSA omits it even though this catalog lists it. Mirrors
+ * the Rust `PIPEWIRE_CAPTURE_FEATURE`.
+ */
+export declare const PIPEWIRE_CAPTURE_FEATURE: 'pipewire-capture';
 /**
  * Named engine features `get-capabilities` advertises in `features`. This is the
  * fail-closed negotiation contract: CeraUI sends a new out-of-schema field ONLY
  * when its feature is listed, so an engine that predates a feature (and silently
  * ignores the field) never applies a semantic the caller assumed. Mirrors the
  * Rust `ENGINE_FEATURES`.
+ *
+ * This is the full CATALOG. Gate on the token in the engine's own `features`
+ * array, never on membership here — a configuration-dependent token is filtered
+ * out of the response the engine actually sends.
  */
-export declare const ENGINE_FEATURES: readonly ['video-passthrough', 'input-mode', 'audio-pcm-spec'];
+export declare const ENGINE_FEATURES: readonly ['video-passthrough', 'input-mode', 'audio-pcm-spec', "pipewire-capture"];
 /** 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

@@ -65,14 +65,32 @@ export const SUPPORTED_PROFILES = [
  * set or any preset's meaning changes. Mirrors the Rust `PROFILE_CATALOG_VERSION`.
  */
 export const PROFILE_CATALOG_VERSION = '1.0.0';
+/**
+ * PipeWire-backed audio capture: the engine addresses capture nodes by
+ * `node.name`/`object.serial`, so a source with no ALSA card — a Bluetooth
+ * microphone is the first one — is selectable as an ordinary node. Unlike the
+ * other tokens this one describes the engine's RUNNING configuration, so an
+ * engine configured for ALSA omits it even though this catalog lists it. Mirrors
+ * the Rust `PIPEWIRE_CAPTURE_FEATURE`.
+ */
+export const PIPEWIRE_CAPTURE_FEATURE = 'pipewire-capture';
 /**
  * Named engine features `get-capabilities` advertises in `features`. This is the
  * fail-closed negotiation contract: CeraUI sends a new out-of-schema field ONLY
  * when its feature is listed, so an engine that predates a feature (and silently
  * ignores the field) never applies a semantic the caller assumed. Mirrors the
  * Rust `ENGINE_FEATURES`.
+ *
+ * This is the full CATALOG. Gate on the token in the engine's own `features`
+ * array, never on membership here — a configuration-dependent token is filtered
+ * out of the response the engine actually sends.
  */
-export const ENGINE_FEATURES = ['video-passthrough', 'input-mode', 'audio-pcm-spec'];
+export const ENGINE_FEATURES = [
+    'video-passthrough',
+    'input-mode',
+    'audio-pcm-spec',
+    PIPEWIRE_CAPTURE_FEATURE,
+];
 /** 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/events.d.ts

@@ -192,6 +192,7 @@ export declare const deviceEventSchema: z.ZodObject<{
         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>;
 /** Payload of a {@link deviceEventSchema} event. */
@@ -424,6 +425,7 @@ export declare const eventParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         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>, z.ZodObject<{
     type: z.ZodLiteral<"bitrate">;
@@ -615,6 +617,7 @@ export declare const cerastreamEventSchema: z.ZodObject<{
             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>, z.ZodObject<{
         type: z.ZodLiteral<"bitrate">;
@@ -812,6 +815,7 @@ export declare const eventSchemas: {
             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>;
     readonly bitrate: z.ZodObject<{

package/dist/messages.d.ts

@@ -241,6 +241,7 @@ export declare const listDevicesResultSchema: z.ZodObject<{
         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 ListDevicesResult = z.infer<typeof listDevicesResultSchema>;
@@ -711,6 +712,7 @@ export declare const requestSchemas: {
                 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>;
     };

package/dist/types.d.ts

@@ -276,6 +276,7 @@ export declare const captureDeviceSchema: z.ZodObject<{
     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>;
 export type CaptureDevice = z.infer<typeof captureDeviceSchema>;
 export declare const srtStatsSchema: z.ZodObject<{

package/dist/types.js

@@ -184,6 +184,7 @@ export const captureDeviceSchema = z.object({
     stable_id: z.string().optional(), // additive (Todo 20): reboot-stable hardware identity, distinct from input_id/device_path
     physical_group_id: z.string().optional(), // additive (0.10.0, ADR-0008): `usb:<topology-token>` shared by one physical device's rows; absent on non-USB + legacy producers, and an absent group NEVER matches
     hardware_serial: z.string().optional(), // additive (0.10.0, ADR-0008): USB serial, DIAGNOSTIC ONLY — vendors ship placeholder serials, so never match/group/select on it
+    device_address: z.string().optional(), // additive: the address the node's provider advertises, carried verbatim; the engine attaches no meaning to it, so the consumer owning the address space is the one that matches on it. Absent unless a provider published one
 });
 // ---- transport telemetry (srt-stats event payload) ----
 export const srtStatsSchema = z.object({

package/package.json

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