@camstack/types 0.1.34 → 0.1.36

package/dist/capabilities/stream-broker.cap.d.ts

@@ -1,6 +1,5 @@
 import { z } from 'zod';
 import { type InferProvider } from './capability-definition.js';
-import type { IStreamBroker } from '../interfaces/stream-broker.js';
 declare const RtspRestreamEntrySchema: z.ZodObject<{
     brokerId: z.ZodString;
     url: z.ZodString;
@@ -205,9 +204,9 @@ export declare const streamBrokerCapability: {
             status: z.ZodEnum<{
                 error: "error";
                 streaming: "streaming";
+                unassigned: "unassigned";
                 idle: "idle";
                 connecting: "connecting";
-                unassigned: "unassigned";
             }>;
             resolution: z.ZodOptional<z.ZodObject<{
                 width: z.ZodNumber;
@@ -352,9 +351,103 @@ export declare const streamBrokerCapability: {
             released: z.ZodBoolean;
             refcount: z.ZodNumber;
         }, z.core.$strip>, "mutation">;
-        readonly getBroker: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+        /**
+         * ── Decoded audio-chunk plane (Phase 5 / D9) ──────────────────────
+         *
+         * The serialisable replacement for the live-object `IStreamBroker.
+         * onDecodedAudioChunk` callback path. Unlike the video frame plane,
+         * audio chunks are tiny (a ~500ms PCM window is a few KB) so they ship
+         * their bytes INLINE over tRPC — no shared-memory ring. A consumer:
+         *
+         *   1. `subscribeAudioChunks({ brokerId, tag })` — the broker registers
+         *      a per-subscription bounded FIFO queue and returns a
+         *      `subscriptionId`.
+         *   2. polls `pullAudioChunks({ subscriptionId, maxCount })` — drains
+         *      `DecodedAudioChunk[]` in arrival order (FIFO, no latest-wins
+         *      drop: an audio gap is audible / breaks an analysis window). The
+         *      queue is generously sized; it only drops its oldest chunk if a
+         *      truly stalled consumer lets it overflow.
+         *   3. `unsubscribeAudioChunks({ subscriptionId })` on teardown.
+         */
+        readonly subscribeAudioChunks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             brokerId: z.ZodString;
-        }, z.core.$strip>, z.ZodCustom<IStreamBroker | null, IStreamBroker | null>, import("./capability-definition.js").CapabilityMethodKind>;
+            tag: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            subscriptionId: z.ZodString;
+        }, z.core.$strip>, "mutation">;
+        readonly pullAudioChunks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subscriptionId: z.ZodString;
+            maxCount: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            data: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+            sampleRate: z.ZodNumber;
+            channels: z.ZodNumber;
+            timestamp: z.ZodNumber;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly unsubscribeAudioChunks: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subscriptionId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            released: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
+        /**
+         * ── Shared-memory frame plane (Phase 5 / D9) ──────────────────────
+         *
+         * The handle-based replacement for the live-object `IStreamBroker.
+         * onDecodedFrame` callback path. A consumer:
+         *
+         *   1. `subscribeFrames({ brokerId, format })` — the broker spins up
+         *      (or reuses) a `frameSink: 'shm'` decoder session producing that
+         *      `format` and returns a `subscriptionId`.
+         *   2. polls `pullFrameHandles({ subscriptionId, maxCount })` — drains
+         *      zero-pixel `FrameHandle[]`; each handle is fed to a
+         *      `FrameRingReader` that opens the named shm segment and reads the
+         *      pixels back zero-copy.
+         *   3. `unsubscribeFrames({ subscriptionId })` on teardown.
+         *
+         * The broker keeps one shm ring per `(brokerId, format)` actually
+         * requested — no broker-side `sharp` conversion. fps throttling is
+         * implicit (latest-wins ring reads drop frames for a slow consumer).
+         */
+        readonly subscribeFrames: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            brokerId: z.ZodString;
+            format: z.ZodEnum<{
+                rgb: "rgb";
+                bgr: "bgr";
+                yuv420: "yuv420";
+                gray: "gray";
+            }>;
+            maxFps: z.ZodOptional<z.ZodNumber>;
+            tag: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            subscriptionId: z.ZodString;
+            maxFps: z.ZodNumber;
+        }, z.core.$strip>, "mutation">;
+        readonly pullFrameHandles: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subscriptionId: z.ZodString;
+            maxCount: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            shmId: z.ZodString;
+            slot: z.ZodNumber;
+            seq: z.ZodNumber;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            format: z.ZodEnum<{
+                jpeg: "jpeg";
+                rgb: "rgb";
+                bgr: "bgr";
+                yuv420: "yuv420";
+                gray: "gray";
+            }>;
+            pts: z.ZodNumber;
+            byteLength: z.ZodNumber;
+            nodeId: z.ZodString;
+            slotCount: z.ZodNumber;
+        }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly unsubscribeFrames: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            subscriptionId: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            released: z.ZodBoolean;
+        }, z.core.$strip>, "mutation">;
         readonly setPreBufferDuration: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             brokerId: z.ZodString;
             seconds: z.ZodNumber;

package/dist/capabilities/stream-broker.cap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-broker.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/stream-broker.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAMzG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAEnE,QAAA,MAAM,uBAAuB;;;;;iBAK3B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;iBAQjC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,uBAAuB;;;;;;EAMlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAIvE,QAAA,MAAM,sBAAsB;;;;EAAmC,CAAA;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,QAAA,MAAM,sBAAsB;;;;;EAA0C,CAAA;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAOrE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;iBAMxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAQ1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqF/B;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEkC,CAAA;AAEzC,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAEhF,OAAO,EAAE,uBAAuB,EAAE,CAAA"}
+{"version":3,"file":"stream-broker.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/stream-broker.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAUzG,QAAA,MAAM,uBAAuB;;;;;iBAK3B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;;;;;;iBAQjC,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;iBAMpC,CAAA;AAEF,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAA;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;iBAM9B,CAAA;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AACrE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AACvE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,uBAAuB;;;;;;EAMlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAIvE,QAAA,MAAM,sBAAsB;;;;EAAmC,CAAA;AAC/D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAErE,QAAA,MAAM,sBAAsB;;;;;EAA0C,CAAA;AACtE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAOrE,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;iBAMxC,CAAA;AACF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAA;AAEnF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;iBAQ1B,CAAA;AACF,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAEvD,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAqF/B;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAWH;;;;;;;;;;;;;;;;;WAiBG;;;;;;;;;;;;;;;;;;;;;QAkBH;;;;;;;;;;;;;;;;;;WAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmEkC,CAAA;AAEzC,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAEhF,OAAO,EAAE,uBAAuB,EAAE,CAAA"}

package/dist/capabilities/stream-params-config-schema.d.ts

@@ -0,0 +1,56 @@
+/**
+ * stream-params — server-side `ConfigUISchema` builder.
+ *
+ * Pure schema-shaping helper: turns the camera-probed `StreamParamsOptions`
+ * (availability descriptor) + the current `StreamParamsStatus` (per-profile
+ * config) into a `ConfigUISchema` the admin-ui `ConfigFormBuilder` renders
+ * directly — one section per profile (main / sub / ext) with resolution,
+ * codec, framerate, bitrate, bitrate-mode, encoder-profile and GOP controls.
+ *
+ * This is the server-side home of the logic that the bespoke
+ * `StreamParamsSettings` cap-settings composite used to run client-side
+ * (`buildProfileSection`). Both the Reolink and Hikvision `stream-params`
+ * providers call `buildStreamParamsConfigSchema` from their
+ * `getConfigSchema` cap method so the two cameras emit a structurally
+ * identical form. No addon dependencies — only `@camstack/types` shapes —
+ * so it lives in `@camstack/types` and is shared without a cross-addon
+ * import.
+ *
+ * The form field keys follow the `stream<Profile>_<prop>` convention
+ * (`streamMain_resolution`, `streamSub_codec`, …) so a flat form patch can
+ * be re-split per profile on save by `parseStreamParamsFormPatch`.
+ */
+import type { ConfigUISchema } from '../interfaces/config-ui.js';
+import type { StreamParamsOptions, StreamParamsStatus, StreamProfile, StreamProfilePatch } from './stream-params.cap.js';
+/** Layout metadata for one of the camera's stream profiles. */
+export interface StreamProfileMeta {
+    readonly profile: StreamProfile;
+    /** Form-field key prefix (`streamMain`, `streamSub`, `streamExt`). */
+    readonly prefix: string;
+    /** Human-facing section title. */
+    readonly label: string;
+}
+/**
+ * The three well-known stream profiles in render order. Exported so the
+ * providers and the save-path parser share one definition.
+ */
+export declare const STREAM_PROFILE_META: readonly StreamProfileMeta[];
+/**
+ * Build the full `stream-params` `ConfigUISchema` from the camera-probed
+ * options + current per-profile config. Returns `null` when no profile
+ * exposes a configurable property — the cap then reports "no schema" and
+ * the renderer shows the unsupported-camera message.
+ *
+ * `default` on each field is seeded from the current config so the
+ * `ConfigFormBuilder` (which reads `value ?? default`) renders the live
+ * camera state without a separate `values` map.
+ */
+export declare function buildStreamParamsConfigSchema(options: StreamParamsOptions, status: StreamParamsStatus | null): ConfigUISchema | null;
+/**
+ * Re-split a flat `ConfigFormBuilder` patch into a `StreamProfilePatch`
+ * for one profile. Returns `null` when no field for the profile changed.
+ * Select fields arrive as strings — coerced here. Mirrors the save path
+ * the bespoke `StreamParamsSettings` composite used.
+ */
+export declare function parseStreamParamsFormPatch(patch: Record<string, unknown>, prefix: string): StreamProfilePatch | null;
+//# sourceMappingURL=stream-params-config-schema.d.ts.map

package/dist/capabilities/stream-params-config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-params-config-schema.d.ts","sourceRoot":"","sources":["../../src/capabilities/stream-params-config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,EAA8B,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAExH,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;IAC/B,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,iBAAiB,EAIlD,CAAA;AAoKV;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAChC,cAAc,GAAG,IAAI,CAUvB;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,GACb,kBAAkB,GAAG,IAAI,CA6C3B"}

package/dist/capabilities/stream-params.cap.d.ts

@@ -0,0 +1,482 @@
+import { z } from 'zod';
+import { type InferNativeProvider } from './capability-definition.js';
+import { DeviceType } from '../device/device-type.js';
+/** One of the camera's stream profiles. */
+export declare const StreamProfileSchema: z.ZodEnum<{
+    sub: "sub";
+    main: "main";
+    ext: "ext";
+}>;
+/** The current encoding config of one stream profile. */
+declare const StreamProfileConfigSchema: z.ZodObject<{
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    codec: z.ZodEnum<{
+        h264: "h264";
+        h265: "h265";
+    }>;
+    framerate: z.ZodNumber;
+    bitrate: z.ZodNumber;
+    bitrateMode: z.ZodOptional<z.ZodEnum<{
+        vbr: "vbr";
+        cbr: "cbr";
+    }>>;
+    encoderProfile: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        main: "main";
+        baseline: "baseline";
+    }>>;
+    gop: z.ZodOptional<z.ZodNumber>;
+    audio: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const StreamParamsStatusSchema: z.ZodObject<{
+    main: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        codec: z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>;
+        framerate: z.ZodNumber;
+        bitrate: z.ZodNumber;
+        bitrateMode: z.ZodOptional<z.ZodEnum<{
+            vbr: "vbr";
+            cbr: "cbr";
+        }>>;
+        encoderProfile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            main: "main";
+            baseline: "baseline";
+        }>>;
+        gop: z.ZodOptional<z.ZodNumber>;
+        audio: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    sub: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        codec: z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>;
+        framerate: z.ZodNumber;
+        bitrate: z.ZodNumber;
+        bitrateMode: z.ZodOptional<z.ZodEnum<{
+            vbr: "vbr";
+            cbr: "cbr";
+        }>>;
+        encoderProfile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            main: "main";
+            baseline: "baseline";
+        }>>;
+        gop: z.ZodOptional<z.ZodNumber>;
+        audio: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    ext: z.ZodOptional<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+        codec: z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>;
+        framerate: z.ZodNumber;
+        bitrate: z.ZodNumber;
+        bitrateMode: z.ZodOptional<z.ZodEnum<{
+            vbr: "vbr";
+            cbr: "cbr";
+        }>>;
+        encoderProfile: z.ZodOptional<z.ZodEnum<{
+            high: "high";
+            main: "main";
+            baseline: "baseline";
+        }>>;
+        gop: z.ZodOptional<z.ZodNumber>;
+        audio: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    lastFetchedAt: z.ZodNumber;
+}, z.core.$strip>;
+/** What a profile CAN be set to — drives the UI selectors. */
+declare const StreamProfileOptionsSchema: z.ZodObject<{
+    resolutions: z.ZodArray<z.ZodObject<{
+        width: z.ZodNumber;
+        height: z.ZodNumber;
+    }, z.core.$strip>>;
+    codecs: z.ZodArray<z.ZodEnum<{
+        h264: "h264";
+        h265: "h265";
+    }>>;
+    framerates: z.ZodArray<z.ZodNumber>;
+    bitrates: z.ZodArray<z.ZodNumber>;
+    bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    supportsBitrateMode: z.ZodBoolean;
+    supportsEncoderProfile: z.ZodBoolean;
+    supportsGop: z.ZodBoolean;
+    gop: z.ZodOptional<z.ZodObject<{
+        min: z.ZodNumber;
+        max: z.ZodNumber;
+        step: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare const StreamParamsOptionsSchema: z.ZodObject<{
+    main: z.ZodOptional<z.ZodObject<{
+        resolutions: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        codecs: z.ZodArray<z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>>;
+        framerates: z.ZodArray<z.ZodNumber>;
+        bitrates: z.ZodArray<z.ZodNumber>;
+        bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        supportsBitrateMode: z.ZodBoolean;
+        supportsEncoderProfile: z.ZodBoolean;
+        supportsGop: z.ZodBoolean;
+        gop: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            step: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    sub: z.ZodOptional<z.ZodObject<{
+        resolutions: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        codecs: z.ZodArray<z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>>;
+        framerates: z.ZodArray<z.ZodNumber>;
+        bitrates: z.ZodArray<z.ZodNumber>;
+        bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        supportsBitrateMode: z.ZodBoolean;
+        supportsEncoderProfile: z.ZodBoolean;
+        supportsGop: z.ZodBoolean;
+        gop: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            step: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    ext: z.ZodOptional<z.ZodObject<{
+        resolutions: z.ZodArray<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+        }, z.core.$strip>>;
+        codecs: z.ZodArray<z.ZodEnum<{
+            h264: "h264";
+            h265: "h265";
+        }>>;
+        framerates: z.ZodArray<z.ZodNumber>;
+        bitrates: z.ZodArray<z.ZodNumber>;
+        bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        supportsBitrateMode: z.ZodBoolean;
+        supportsEncoderProfile: z.ZodBoolean;
+        supportsGop: z.ZodBoolean;
+        gop: z.ZodOptional<z.ZodObject<{
+            min: z.ZodNumber;
+            max: z.ZodNumber;
+            step: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** A partial change to one profile — every field optional; a provider
+ *  ignores fields it doesn't support. */
+export declare const StreamProfilePatchSchema: z.ZodObject<{
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    codec: z.ZodOptional<z.ZodEnum<{
+        h264: "h264";
+        h265: "h265";
+    }>>;
+    framerate: z.ZodOptional<z.ZodNumber>;
+    bitrate: z.ZodOptional<z.ZodNumber>;
+    bitrateMode: z.ZodOptional<z.ZodEnum<{
+        vbr: "vbr";
+        cbr: "cbr";
+    }>>;
+    encoderProfile: z.ZodOptional<z.ZodEnum<{
+        high: "high";
+        main: "main";
+        baseline: "baseline";
+    }>>;
+    gop: z.ZodOptional<z.ZodNumber>;
+    audio: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type StreamParamsStatus = z.infer<typeof StreamParamsStatusSchema>;
+export type StreamParamsOptions = z.infer<typeof StreamParamsOptionsSchema>;
+export type StreamProfile = z.infer<typeof StreamProfileSchema>;
+export type StreamProfilePatch = z.infer<typeof StreamProfilePatchSchema>;
+export declare const streamParamsCapability: {
+    readonly name: "stream-params";
+    readonly scope: "device";
+    readonly mode: "singleton";
+    readonly deviceTypes: readonly [DeviceType.Camera];
+    readonly deviceConfig: {
+        readonly ui: {
+            readonly kind: "derived-form";
+            readonly builderId: "stream-params";
+            readonly tab: "streaming";
+        };
+    };
+    readonly methods: {
+        readonly getOptions: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodObject<{
+            main: z.ZodOptional<z.ZodObject<{
+                resolutions: z.ZodArray<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                codecs: z.ZodArray<z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>>;
+                framerates: z.ZodArray<z.ZodNumber>;
+                bitrates: z.ZodArray<z.ZodNumber>;
+                bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                supportsBitrateMode: z.ZodBoolean;
+                supportsEncoderProfile: z.ZodBoolean;
+                supportsGop: z.ZodBoolean;
+                gop: z.ZodOptional<z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    step: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            sub: z.ZodOptional<z.ZodObject<{
+                resolutions: z.ZodArray<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                codecs: z.ZodArray<z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>>;
+                framerates: z.ZodArray<z.ZodNumber>;
+                bitrates: z.ZodArray<z.ZodNumber>;
+                bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                supportsBitrateMode: z.ZodBoolean;
+                supportsEncoderProfile: z.ZodBoolean;
+                supportsGop: z.ZodBoolean;
+                gop: z.ZodOptional<z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    step: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            ext: z.ZodOptional<z.ZodObject<{
+                resolutions: z.ZodArray<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strip>>;
+                codecs: z.ZodArray<z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>>;
+                framerates: z.ZodArray<z.ZodNumber>;
+                bitrates: z.ZodArray<z.ZodNumber>;
+                bitrateRange: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+                supportsBitrateMode: z.ZodBoolean;
+                supportsEncoderProfile: z.ZodBoolean;
+                supportsGop: z.ZodBoolean;
+                gop: z.ZodOptional<z.ZodObject<{
+                    min: z.ZodNumber;
+                    max: z.ZodNumber;
+                    step: z.ZodNumber;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
+        readonly setProfile: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            profile: z.ZodEnum<{
+                sub: "sub";
+                main: "main";
+                ext: "ext";
+            }>;
+            patch: z.ZodObject<{
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                codec: z.ZodOptional<z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>>;
+                framerate: z.ZodOptional<z.ZodNumber>;
+                bitrate: z.ZodOptional<z.ZodNumber>;
+                bitrateMode: z.ZodOptional<z.ZodEnum<{
+                    vbr: "vbr";
+                    cbr: "cbr";
+                }>>;
+                encoderProfile: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    main: "main";
+                    baseline: "baseline";
+                }>>;
+                gop: z.ZodOptional<z.ZodNumber>;
+                audio: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodVoid, "mutation">;
+        /**
+         * Build the `ConfigUISchema` (admin-ui `ConfigFormBuilder` input
+         * shape) for this camera's stream-encoder settings — one section per
+         * profile (main / sub / ext) with the resolution / codec / framerate
+         * / bitrate / bitrate-mode / encoder-profile / GOP controls the
+         * firmware actually exposes.
+         *
+         * Driven by `getOptions` (camera-probed availability) + `getStatus`
+         * (current per-profile config); each field's `default` is seeded
+         * from the live config so the form renders the camera state in one
+         * pass. Returns `null` when the camera exposes no configurable
+         * stream property — the renderer then shows the unsupported message.
+         *
+         * Output is `z.unknown().nullable()` — the same convention every
+         * other `ConfigUISchema`-returning cap method uses (`device-ops`,
+         * `device-manager`); `ConfigUISchema` is a TS-only type with no
+         * companion Zod schema, and a concrete object would collapse
+         * unrelated AppRouter branches to `unknown` during codegen.
+         */
+        readonly getConfigSchema: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+        }, z.core.$strip>, z.ZodNullable<z.ZodUnknown>, import("./capability-definition.js").CapabilityMethodKind>;
+    };
+    readonly status: {
+        readonly schema: z.ZodObject<{
+            main: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                codec: z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>;
+                framerate: z.ZodNumber;
+                bitrate: z.ZodNumber;
+                bitrateMode: z.ZodOptional<z.ZodEnum<{
+                    vbr: "vbr";
+                    cbr: "cbr";
+                }>>;
+                encoderProfile: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    main: "main";
+                    baseline: "baseline";
+                }>>;
+                gop: z.ZodOptional<z.ZodNumber>;
+                audio: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            sub: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                codec: z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>;
+                framerate: z.ZodNumber;
+                bitrate: z.ZodNumber;
+                bitrateMode: z.ZodOptional<z.ZodEnum<{
+                    vbr: "vbr";
+                    cbr: "cbr";
+                }>>;
+                encoderProfile: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    main: "main";
+                    baseline: "baseline";
+                }>>;
+                gop: z.ZodOptional<z.ZodNumber>;
+                audio: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            ext: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                codec: z.ZodEnum<{
+                    h264: "h264";
+                    h265: "h265";
+                }>;
+                framerate: z.ZodNumber;
+                bitrate: z.ZodNumber;
+                bitrateMode: z.ZodOptional<z.ZodEnum<{
+                    vbr: "vbr";
+                    cbr: "cbr";
+                }>>;
+                encoderProfile: z.ZodOptional<z.ZodEnum<{
+                    high: "high";
+                    main: "main";
+                    baseline: "baseline";
+                }>>;
+                gop: z.ZodOptional<z.ZodNumber>;
+                audio: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>>;
+            lastFetchedAt: z.ZodNumber;
+        }, z.core.$strip>;
+        readonly kind: "poll";
+    };
+    readonly runtimeState: z.ZodObject<{
+        main: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            codec: z.ZodEnum<{
+                h264: "h264";
+                h265: "h265";
+            }>;
+            framerate: z.ZodNumber;
+            bitrate: z.ZodNumber;
+            bitrateMode: z.ZodOptional<z.ZodEnum<{
+                vbr: "vbr";
+                cbr: "cbr";
+            }>>;
+            encoderProfile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                main: "main";
+                baseline: "baseline";
+            }>>;
+            gop: z.ZodOptional<z.ZodNumber>;
+            audio: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        sub: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            codec: z.ZodEnum<{
+                h264: "h264";
+                h265: "h265";
+            }>;
+            framerate: z.ZodNumber;
+            bitrate: z.ZodNumber;
+            bitrateMode: z.ZodOptional<z.ZodEnum<{
+                vbr: "vbr";
+                cbr: "cbr";
+            }>>;
+            encoderProfile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                main: "main";
+                baseline: "baseline";
+            }>>;
+            gop: z.ZodOptional<z.ZodNumber>;
+            audio: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        ext: z.ZodOptional<z.ZodObject<{
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            codec: z.ZodEnum<{
+                h264: "h264";
+                h265: "h265";
+            }>;
+            framerate: z.ZodNumber;
+            bitrate: z.ZodNumber;
+            bitrateMode: z.ZodOptional<z.ZodEnum<{
+                vbr: "vbr";
+                cbr: "cbr";
+            }>>;
+            encoderProfile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                main: "main";
+                baseline: "baseline";
+            }>>;
+            gop: z.ZodOptional<z.ZodNumber>;
+            audio: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        lastFetchedAt: z.ZodNumber;
+    }, z.core.$strip>;
+};
+export type IStreamParamsProvider = InferNativeProvider<typeof streamParamsCapability>;
+export { StreamProfileConfigSchema, StreamProfileOptionsSchema };
+//# sourceMappingURL=stream-params.cap.d.ts.map

package/dist/capabilities/stream-params.cap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-params.cap.d.ts","sourceRoot":"","sources":["../../src/capabilities/stream-params.cap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAqC,KAAK,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AACxG,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAErD,2CAA2C;AAC3C,eAAO,MAAM,mBAAmB;;;;EAAiC,CAAA;AAEjE,yDAAyD;AACzD,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;iBAU7B,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMnC,CAAA;AAEF,8DAA8D;AAC9D,QAAA,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;iBAgB9B,CAAA;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAIpC,CAAA;AAEF;yCACyC;AACzC,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;iBAUnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AACzE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAC3E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAC/D,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAsB/B;;;;;;;;;;;;;;;;;;WAkBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWkC,CAAA;AAEzC,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAEtF,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,CAAA"}