@camstack/types 1.1.14 → 1.1.16

package/dist/capabilities/audio-codec.cap.d.ts

@@ -70,6 +70,7 @@ export declare const audioCodecCapability: {
     readonly name: "audio-codec";
     readonly scope: "system";
     readonly mode: "singleton";
+    readonly preferredProvider: "audio-codec-ffmpeg";
     readonly methods: {
         /** Probe the local runtime and return the supported codec matrix. */
         readonly listSupportedCodecs: import("./capability-definition.js").CapabilityMethodSchema<z.ZodVoid, z.ZodReadonly<z.ZodArray<z.ZodObject<{

package/dist/capabilities/decoder.cap.d.ts

@@ -51,6 +51,7 @@ export declare const decoderCapability: {
     readonly name: "decoder";
     readonly scope: "system";
     readonly mode: "singleton";
+    readonly preferredProvider: "decoder-ffmpeg";
     readonly methods: {
         readonly supportsCodec: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             codec: z.ZodString;

package/dist/capabilities/storage.cap.d.ts

@@ -122,6 +122,10 @@ export declare const storageCapability: {
                 multi: "multi";
             }>;
             defaultsTo: z.ZodOptional<z.ZodString>;
+            defaultRoot: z.ZodOptional<z.ZodEnum<{
+                data: "data";
+                media: "media";
+            }>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly upsertLocation: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             id: z.ZodString;

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

@@ -14,6 +14,7 @@ declare const RtspRestreamEntrySchema: z.ZodObject<{
 export declare const BrokerRtspClientSchema: z.ZodObject<{
     sessionId: z.ZodString;
     remoteAddr: z.ZodString;
+    userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     playing: z.ZodBoolean;
     muted: z.ZodBoolean;
     connectedAt: z.ZodNumber;
@@ -135,6 +136,7 @@ export declare const BrokerClientsSchema: z.ZodObject<{
     rtsp: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         sessionId: z.ZodString;
         remoteAddr: z.ZodString;
+        userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
         playing: z.ZodBoolean;
         muted: z.ZodBoolean;
         connectedAt: z.ZodNumber;
@@ -475,6 +477,7 @@ export declare const streamBrokerCapability: {
             rtsp: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 sessionId: z.ZodString;
                 remoteAddr: z.ZodString;
+                userAgent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
                 playing: z.ZodBoolean;
                 muted: z.ZodBoolean;
                 connectedAt: z.ZodNumber;

package/dist/generated/addon-api.d.ts

@@ -11524,6 +11524,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 cardinality: "single" | "multi";
                 description?: string | undefined;
                 defaultsTo?: string | undefined;
+                defaultRoot?: "data" | "media" | undefined;
             }[];
             meta: object;
         }>;
@@ -12155,6 +12156,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                     connectedAt: number;
                     lastRtpAt: number;
                     bytesSent: number;
+                    userAgent?: string | null | undefined;
                 }[];
                 decoded: readonly {
                     tag: string;
@@ -25361,6 +25363,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                 cardinality: "single" | "multi";
                 description?: string | undefined;
                 defaultsTo?: string | undefined;
+                defaultRoot?: "data" | "media" | undefined;
             }[];
             meta: object;
         }>;
@@ -25992,6 +25995,7 @@ export type AppRouter = import("@trpc/server/unstable-core-do-not-import").Route
                     connectedAt: number;
                     lastRtpAt: number;
                     bytesSent: number;
+                    userAgent?: string | null | undefined;
                 }[];
                 decoded: readonly {
                     tag: string;

package/dist/index.js

@@ -832,7 +832,21 @@ var StorageLocationDeclarationSchema = zod.z.object({
 	* slots (e.g. `recordingsLow` → `recordings`) so operators only need to
 	* configure the primary location.
 	*/
-	defaultsTo: zod.z.string().optional()
+	defaultsTo: zod.z.string().optional(),
+	/**
+	* Which node root the seeded `<id>:default` instance is placed under on a
+	* FRESH install:
+	* - `'data'` (default) — the node's data dir (`CAMSTACK_DATA` / boot dir),
+	*   the appData volume. Right for small/durable data (backups, logs, models).
+	* - `'media'` — the dedicated media volume (`CAMSTACK_MEDIA_ROOT`) when that
+	*   env is set, else falls back to the data root. Right for bulky, hot media
+	*   (recordings, event media) that should stay off the appData disk.
+	*
+	* Only affects the seeded default's `basePath`; operators can repoint any
+	* location afterwards, and a `defaultsTo` slot inherits its parent's root
+	* regardless of this field. Absent (the common case) is treated as `'data'`.
+	*/
+	defaultRoot: zod.z.enum(["data", "media"]).optional()
 });
 //#endregion
 //#region src/interfaces/device-capabilities/camera.ts
@@ -3504,6 +3518,10 @@ var RtspRestreamEntrySchema = zod.z.object({
 var BrokerRtspClientSchema = zod.z.object({
 	sessionId: zod.z.string(),
 	remoteAddr: zod.z.string(),
+	/** Client `User-Agent` (e.g. `recorder` for the recorder's RTSP pull), or
+	*  null/absent when the client sent none. Lets the UI label a consumer by
+	*  purpose. Optional so a client built against an older schema stays valid. */
+	userAgent: zod.z.string().nullish(),
 	playing: zod.z.boolean(),
 	muted: zod.z.boolean(),
 	connectedAt: zod.z.number(),
@@ -11888,6 +11906,7 @@ var audioCodecCapability = {
 	name: "audio-codec",
 	scope: "system",
 	mode: "singleton",
+	preferredProvider: "audio-codec-ffmpeg",
 	methods: {
 		/** Probe the local runtime and return the supported codec matrix. */
 		listSupportedCodecs: require_sleep.method(zod.z.void(), zod.z.array(AudioCodecInfoSchema).readonly()),
@@ -12633,6 +12652,7 @@ var decoderCapability = {
 	name: "decoder",
 	scope: "system",
 	mode: "singleton",
+	preferredProvider: "decoder-ffmpeg",
 	methods: {
 		supportsCodec: require_sleep.method(zod.z.object({ codec: zod.z.string() }), zod.z.boolean()),
 		getInfo: require_sleep.method(zod.z.void(), zod.z.object({

package/dist/index.mjs

@@ -831,7 +831,21 @@ var StorageLocationDeclarationSchema = z.object({
 	* slots (e.g. `recordingsLow` → `recordings`) so operators only need to
 	* configure the primary location.
 	*/
-	defaultsTo: z.string().optional()
+	defaultsTo: z.string().optional(),
+	/**
+	* Which node root the seeded `<id>:default` instance is placed under on a
+	* FRESH install:
+	* - `'data'` (default) — the node's data dir (`CAMSTACK_DATA` / boot dir),
+	*   the appData volume. Right for small/durable data (backups, logs, models).
+	* - `'media'` — the dedicated media volume (`CAMSTACK_MEDIA_ROOT`) when that
+	*   env is set, else falls back to the data root. Right for bulky, hot media
+	*   (recordings, event media) that should stay off the appData disk.
+	*
+	* Only affects the seeded default's `basePath`; operators can repoint any
+	* location afterwards, and a `defaultsTo` slot inherits its parent's root
+	* regardless of this field. Absent (the common case) is treated as `'data'`.
+	*/
+	defaultRoot: z.enum(["data", "media"]).optional()
 });
 //#endregion
 //#region src/interfaces/device-capabilities/camera.ts
@@ -3503,6 +3517,10 @@ var RtspRestreamEntrySchema = z.object({
 var BrokerRtspClientSchema = z.object({
 	sessionId: z.string(),
 	remoteAddr: z.string(),
+	/** Client `User-Agent` (e.g. `recorder` for the recorder's RTSP pull), or
+	*  null/absent when the client sent none. Lets the UI label a consumer by
+	*  purpose. Optional so a client built against an older schema stays valid. */
+	userAgent: z.string().nullish(),
 	playing: z.boolean(),
 	muted: z.boolean(),
 	connectedAt: z.number(),
@@ -11887,6 +11905,7 @@ var audioCodecCapability = {
 	name: "audio-codec",
 	scope: "system",
 	mode: "singleton",
+	preferredProvider: "audio-codec-ffmpeg",
 	methods: {
 		/** Probe the local runtime and return the supported codec matrix. */
 		listSupportedCodecs: method(z.void(), z.array(AudioCodecInfoSchema).readonly()),
@@ -12632,6 +12651,7 @@ var decoderCapability = {
 	name: "decoder",
 	scope: "system",
 	mode: "singleton",
+	preferredProvider: "decoder-ffmpeg",
 	methods: {
 		supportsCodec: method(z.object({ codec: z.string() }), z.boolean()),
 		getInfo: method(z.void(), z.object({

package/dist/interfaces/storage-location-declaration.d.ts

@@ -28,6 +28,10 @@ export declare const StorageLocationDeclarationSchema: z.ZodObject<{
         multi: "multi";
     }>;
     defaultsTo: z.ZodOptional<z.ZodString>;
+    defaultRoot: z.ZodOptional<z.ZodEnum<{
+        data: "data";
+        media: "media";
+    }>>;
 }, z.core.$strip>;
 /** Inferred TypeScript type for `StorageLocationDeclarationSchema`. */
 export type StorageLocationDeclaration = z.infer<typeof StorageLocationDeclarationSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.1.14",
+  "version": "1.1.16",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",