@camstack/addon-post-analysis 1.1.12 → 1.1.13

package/dist/{dist-CdflY87D.mjs → dist-COXXWoXN.mjs}

@@ -7049,7 +7049,21 @@ var StorageLocationDeclarationSchema = object({
 	* slots (e.g. `recordingsLow` → `recordings`) so operators only need to
 	* configure the primary location.
 	*/
-	defaultsTo: string().optional()
+	defaultsTo: 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: _enum(["data", "media"]).optional()
 });
 var DecoderStatsSchema = object({
 	inputFps: number(),
@@ -7942,6 +7956,10 @@ var RtspRestreamEntrySchema = object({
 var BrokerRtspClientSchema = object({
 	sessionId: string(),
 	remoteAddr: 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: string().nullish(),
 	playing: boolean(),
 	muted: boolean(),
 	connectedAt: number(),

package/dist/{dist-d6siFYqC.js → dist-DlqrO_A-.js}

@@ -7071,7 +7071,21 @@ var StorageLocationDeclarationSchema = object({
 	* slots (e.g. `recordingsLow` → `recordings`) so operators only need to
 	* configure the primary location.
 	*/
-	defaultsTo: string().optional()
+	defaultsTo: 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: _enum(["data", "media"]).optional()
 });
 var DecoderStatsSchema = object({
 	inputFps: number(),
@@ -7964,6 +7978,10 @@ var RtspRestreamEntrySchema = object({
 var BrokerRtspClientSchema = object({
 	sessionId: string(),
 	remoteAddr: 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: string().nullish(),
 	playing: boolean(),
 	muted: boolean(),
 	connectedAt: number(),

package/dist/embedding-encoder/index.js

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-d6siFYqC.js");
+const require_dist = require("../dist-DlqrO_A-.js");
 let node_fs = require("node:fs");
 let node_fs$1 = require_dist.__toESM(node_fs, 1);
 node_fs = require_dist.__toESM(node_fs);

package/dist/embedding-encoder/index.mjs

@@ -1,4 +1,4 @@
-import { f as BaseAddon, i as embeddingEncoderCapability, o as hfModelUrl } from "../dist-CdflY87D.mjs";
+import { f as BaseAddon, i as embeddingEncoderCapability, o as hfModelUrl } from "../dist-COXXWoXN.mjs";
 import { createRequire } from "node:module";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";

package/dist/enrichment-engine/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-d6siFYqC.js");
-const require_resolve_frame = require("../resolve-frame-BACRPcr1.js");
+const require_dist = require("../dist-DlqrO_A-.js");
+const require_resolve_frame = require("../resolve-frame-DCyc2Qwb.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 //#region src/enrichment-engine/types.ts
 var DEFAULT_ENRICHMENT_CONFIG = {

package/dist/enrichment-engine/index.mjs

@@ -1,4 +1,4 @@
-import { C as string, S as object, b as boolean, f as BaseAddon, g as createEvent, h as asJsonObject, m as EventCategory, v as _enum, w as tuple, x as number, y as array } from "../dist-CdflY87D.mjs";
+import { C as string, S as object, b as boolean, f as BaseAddon, g as createEvent, h as asJsonObject, m as EventCategory, v as _enum, w as tuple, x as number, y as array } from "../dist-COXXWoXN.mjs";
 import { n as extractCrop, t as resolveFrame } from "../resolve-frame-CT1T1tWy.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 //#region src/enrichment-engine/types.ts

package/dist/node-BuPMb-ti.mjs

@@ -0,0 +1,145 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+var STORAGE_LOCATION_TYPES = [
+	"data",
+	"media",
+	"recordings",
+	"recordings-high",
+	"recordings-low",
+	"recordings-clips",
+	"event-images",
+	"models",
+	"addons-data",
+	"cache",
+	"logs",
+	"backups"
+];
+var DEFAULT_LOCATION_SUBDIRS = {
+	data: "db",
+	media: "media",
+	recordings: "recordings",
+	"recordings-high": "recordings-high",
+	"recordings-low": "recordings-low",
+	"recordings-clips": "recordings-clips",
+	"event-images": "event-images",
+	models: "models",
+	"addons-data": "addons-data",
+	cache: "/tmp/camstack-cache",
+	logs: "logs",
+	backups: "backups"
+};
+/**
+* Filesystem storage provider — serves all location types from a local directory tree.
+*
+* Default layout:
+*   {rootPath}/recordings-high/
+*   {rootPath}/recordings-low/
+*   {rootPath}/recordings-clips/
+*   {rootPath}/event-images/
+*   {rootPath}/models/
+*   {rootPath}/addons-data/
+*   {rootPath}/logs/
+*   /tmp/camstack-cache/   (cache is always local)
+*
+* Individual location paths can be overridden.
+*/
+var FilesystemStorageProvider = class {
+	id = "local";
+	name = "Local Filesystem";
+	supportedLocations = [...STORAGE_LOCATION_TYPES];
+	rootPath;
+	locationPaths;
+	constructor(rootPath, overrides) {
+		this.rootPath = path.resolve(rootPath);
+		this.locationPaths = /* @__PURE__ */ new Map();
+		for (const loc of STORAGE_LOCATION_TYPES) {
+			const override = overrides?.[loc];
+			if (override) this.locationPaths.set(loc, path.resolve(override));
+			else {
+				const subdir = DEFAULT_LOCATION_SUBDIRS[loc] ?? loc;
+				this.locationPaths.set(loc, path.isAbsolute(subdir) ? subdir : path.join(this.rootPath, subdir));
+			}
+		}
+	}
+	async resolve({ location, relativePath }) {
+		const base = this.locationPaths.get(location) ?? path.join(this.rootPath, location);
+		return path.join(base, relativePath);
+	}
+	async write({ location, relativePath, data }) {
+		const filePath = await this.resolve({
+			location,
+			relativePath
+		});
+		await fs.promises.mkdir(path.dirname(filePath), { recursive: true });
+		if (Buffer.isBuffer(data)) await fs.promises.writeFile(filePath, data);
+		else {
+			const writeStream = fs.createWriteStream(filePath);
+			await new Promise((resolve, reject) => {
+				data.pipe(writeStream);
+				writeStream.on("finish", resolve);
+				writeStream.on("error", reject);
+			});
+		}
+	}
+	async read({ location, relativePath }) {
+		return fs.promises.readFile(await this.resolve({
+			location,
+			relativePath
+		}));
+	}
+	async exists({ location, relativePath }) {
+		try {
+			await fs.promises.access(await this.resolve({
+				location,
+				relativePath
+			}));
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async list({ location, prefix }) {
+		const base = this.locationPaths.get(location);
+		if (!base) return [];
+		const dir = prefix ? path.join(base, prefix) : base;
+		try {
+			return (await fs.promises.readdir(dir, { withFileTypes: true })).map((e) => prefix ? `${prefix}/${e.name}` : e.name);
+		} catch {
+			return [];
+		}
+	}
+	async delete({ location, relativePath }) {
+		const filePath = await this.resolve({
+			location,
+			relativePath
+		});
+		await fs.promises.rm(filePath, { force: true });
+	}
+	async getAvailableSpace({ location }) {
+		const base = this.locationPaths.get(location);
+		if (!base) return null;
+		try {
+			let target = base;
+			while (!fs.existsSync(target)) {
+				const parent = path.dirname(target);
+				if (!parent || parent === target) return null;
+				target = parent;
+			}
+			const stats = await fs.promises.statfs(target);
+			return stats.bavail * stats.bsize;
+		} catch {
+			return null;
+		}
+	}
+	/** Get the resolved path for a location type (addon-declared ids fall back
+	*  to `<rootPath>/<id>`). */
+	getLocationPath(location) {
+		return this.locationPaths.get(location) ?? path.join(this.rootPath, location);
+	}
+	/** Get the root path */
+	getRootPath() {
+		return this.rootPath;
+	}
+};
+//#endregion
+export { FilesystemStorageProvider };

package/dist/node-CGM1poCk.js

@@ -0,0 +1,150 @@
+const require_dist = require("./dist-DlqrO_A-.js");
+let node_fs = require("node:fs");
+node_fs = require_dist.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_dist.__toESM(node_path, 1);
+require("node:crypto");
+require("node:child_process");
+var STORAGE_LOCATION_TYPES = [
+	"data",
+	"media",
+	"recordings",
+	"recordings-high",
+	"recordings-low",
+	"recordings-clips",
+	"event-images",
+	"models",
+	"addons-data",
+	"cache",
+	"logs",
+	"backups"
+];
+var DEFAULT_LOCATION_SUBDIRS = {
+	data: "db",
+	media: "media",
+	recordings: "recordings",
+	"recordings-high": "recordings-high",
+	"recordings-low": "recordings-low",
+	"recordings-clips": "recordings-clips",
+	"event-images": "event-images",
+	models: "models",
+	"addons-data": "addons-data",
+	cache: "/tmp/camstack-cache",
+	logs: "logs",
+	backups: "backups"
+};
+/**
+* Filesystem storage provider — serves all location types from a local directory tree.
+*
+* Default layout:
+*   {rootPath}/recordings-high/
+*   {rootPath}/recordings-low/
+*   {rootPath}/recordings-clips/
+*   {rootPath}/event-images/
+*   {rootPath}/models/
+*   {rootPath}/addons-data/
+*   {rootPath}/logs/
+*   /tmp/camstack-cache/   (cache is always local)
+*
+* Individual location paths can be overridden.
+*/
+var FilesystemStorageProvider = class {
+	id = "local";
+	name = "Local Filesystem";
+	supportedLocations = [...STORAGE_LOCATION_TYPES];
+	rootPath;
+	locationPaths;
+	constructor(rootPath, overrides) {
+		this.rootPath = node_path.resolve(rootPath);
+		this.locationPaths = /* @__PURE__ */ new Map();
+		for (const loc of STORAGE_LOCATION_TYPES) {
+			const override = overrides?.[loc];
+			if (override) this.locationPaths.set(loc, node_path.resolve(override));
+			else {
+				const subdir = DEFAULT_LOCATION_SUBDIRS[loc] ?? loc;
+				this.locationPaths.set(loc, node_path.isAbsolute(subdir) ? subdir : node_path.join(this.rootPath, subdir));
+			}
+		}
+	}
+	async resolve({ location, relativePath }) {
+		const base = this.locationPaths.get(location) ?? node_path.join(this.rootPath, location);
+		return node_path.join(base, relativePath);
+	}
+	async write({ location, relativePath, data }) {
+		const filePath = await this.resolve({
+			location,
+			relativePath
+		});
+		await node_fs.promises.mkdir(node_path.dirname(filePath), { recursive: true });
+		if (Buffer.isBuffer(data)) await node_fs.promises.writeFile(filePath, data);
+		else {
+			const writeStream = node_fs.createWriteStream(filePath);
+			await new Promise((resolve, reject) => {
+				data.pipe(writeStream);
+				writeStream.on("finish", resolve);
+				writeStream.on("error", reject);
+			});
+		}
+	}
+	async read({ location, relativePath }) {
+		return node_fs.promises.readFile(await this.resolve({
+			location,
+			relativePath
+		}));
+	}
+	async exists({ location, relativePath }) {
+		try {
+			await node_fs.promises.access(await this.resolve({
+				location,
+				relativePath
+			}));
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async list({ location, prefix }) {
+		const base = this.locationPaths.get(location);
+		if (!base) return [];
+		const dir = prefix ? node_path.join(base, prefix) : base;
+		try {
+			return (await node_fs.promises.readdir(dir, { withFileTypes: true })).map((e) => prefix ? `${prefix}/${e.name}` : e.name);
+		} catch {
+			return [];
+		}
+	}
+	async delete({ location, relativePath }) {
+		const filePath = await this.resolve({
+			location,
+			relativePath
+		});
+		await node_fs.promises.rm(filePath, { force: true });
+	}
+	async getAvailableSpace({ location }) {
+		const base = this.locationPaths.get(location);
+		if (!base) return null;
+		try {
+			let target = base;
+			while (!node_fs.existsSync(target)) {
+				const parent = node_path.dirname(target);
+				if (!parent || parent === target) return null;
+				target = parent;
+			}
+			const stats = await node_fs.promises.statfs(target);
+			return stats.bavail * stats.bsize;
+		} catch {
+			return null;
+		}
+	}
+	/** Get the resolved path for a location type (addon-declared ids fall back
+	*  to `<rootPath>/<id>`). */
+	getLocationPath(location) {
+		return this.locationPaths.get(location) ?? node_path.join(this.rootPath, location);
+	}
+	/** Get the root path */
+	getRootPath() {
+		return this.rootPath;
+	}
+};
+//#endregion
+exports.FilesystemStorageProvider = FilesystemStorageProvider;

package/dist/pipeline-analytics/{_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BIz6KjXS.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-B483pGUH.mjs}

@@ -3,7 +3,7 @@ import "./dist-CYZr2fwk.mjs";
 var e = {
 	"@camstack/sdk": {
 		name: "@camstack/sdk",
-		version: "1.1.12",
+		version: "1.1.13",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.1.13",
+		version: "1.1.16",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",
@@ -33,7 +33,7 @@ var e = {
 	},
 	"@camstack/ui-library": {
 		name: "@camstack/ui-library",
-		version: "1.1.13",
+		version: "1.1.15",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_pipeline_analytics_widgets",

package/dist/pipeline-analytics/{hostInit-DtijJmgD.mjs → hostInit-BO8ol3oB.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.1.13",
+				version: "1.1.16",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -45,7 +45,7 @@ async function r() {
 				}
 			},
 			"@camstack/sdk": {
-				version: "1.1.12",
+				version: "1.1.13",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,
@@ -81,7 +81,7 @@ async function r() {
 				}
 			},
 			"@camstack/ui-library": {
-				version: "1.1.13",
+				version: "1.1.15",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/pipeline-analytics/index.js

@@ -2,8 +2,8 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_dist = require("../dist-d6siFYqC.js");
-const require_resolve_frame = require("../resolve-frame-BACRPcr1.js");
+const require_dist = require("../dist-DlqrO_A-.js");
+const require_resolve_frame = require("../resolve-frame-DCyc2Qwb.js");
 let _camstack_shm_ring = require("@camstack/shm-ring");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
@@ -5647,7 +5647,13 @@ var PipelineAnalyticsAddon = class extends require_dist.BaseAddon {
 		await PlateStore.declare(api.settingsStore);
 		await ObjectEmbeddingStore.declare(api.settingsStore);
 		const logger = this.ctx.logger;
-		const storage = this.ctx.kernel.storage;
+		let storage = this.ctx.kernel.storage;
+		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
+		if (mediaRoot) {
+			const { FilesystemStorageProvider } = await Promise.resolve().then(() => require("../node-CGM1poCk.js"));
+			storage = new FilesystemStorageProvider(mediaRoot);
+			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
+		}
 		if (!storage) throw new Error("pipeline-analytics requires ctx.kernel.storage");
 		this.trackStore = new TrackStore({
 			store: api.settingsStore,

package/dist/pipeline-analytics/index.mjs

@@ -1,4 +1,4 @@
-import { S as object, _ as hydrateSchema, a as faceGalleryCapability, b as boolean, c as plateGalleryCapability, d as errMsg, f as BaseAddon, l as videoclipsCapability, m as EventCategory, n as audioMetricsCapability, p as DeviceType, r as cosineSimilarity, s as pipelineAnalyticsCapability, t as addonWidgetsSourceCapability, u as zoneAnalyticsCapability, x as number } from "../dist-CdflY87D.mjs";
+import { S as object, _ as hydrateSchema, a as faceGalleryCapability, b as boolean, c as plateGalleryCapability, d as errMsg, f as BaseAddon, l as videoclipsCapability, m as EventCategory, n as audioMetricsCapability, p as DeviceType, r as cosineSimilarity, s as pipelineAnalyticsCapability, t as addonWidgetsSourceCapability, u as zoneAnalyticsCapability, x as number } from "../dist-COXXWoXN.mjs";
 import { n as extractCrop, t as resolveFrame } from "../resolve-frame-CT1T1tWy.mjs";
 import { FrameRingReaderCache } from "@camstack/shm-ring";
 import sharp from "sharp";
@@ -5642,7 +5642,13 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		await PlateStore.declare(api.settingsStore);
 		await ObjectEmbeddingStore.declare(api.settingsStore);
 		const logger = this.ctx.logger;
-		const storage = this.ctx.kernel.storage;
+		let storage = this.ctx.kernel.storage;
+		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
+		if (mediaRoot) {
+			const { FilesystemStorageProvider } = await import("../node-BuPMb-ti.mjs");
+			storage = new FilesystemStorageProvider(mediaRoot);
+			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
+		}
 		if (!storage) throw new Error("pipeline-analytics requires ctx.kernel.storage");
 		this.trackStore = new TrackStore({
 			store: api.settingsStore,

package/dist/pipeline-analytics/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-BIz6KjXS.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-B483pGUH.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/dist/{resolve-frame-BACRPcr1.js → resolve-frame-DCyc2Qwb.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-d6siFYqC.js");
+const require_dist = require("./dist-DlqrO_A-.js");
 let sharp = require("sharp");
 sharp = require_dist.__toESM(sharp);
 //#region src/shared/frame/crop-extractor.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.1.12",
+  "version": "1.1.13",
   "description": "CamStack Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",
@@ -109,7 +109,8 @@
             "id": "eventMedia",
             "displayName": "Event Media",
             "cardinality": "single",
-            "description": "Detection snapshots, thumbnails and crops."
+            "description": "Detection snapshots, thumbnails and crops.",
+            "defaultRoot": "media"
           }
         ],
         "icon": "assets/icon.svg",