@camstack/addon-post-analysis 1.2.55 → 1.2.58

package/dist/pipeline-analytics/index.mjs

@@ -1,7 +1,11 @@
-import { $ as array, B as subKindsOf, C as addonWidgetsSourceCapability, D as cosineSimilarity, E as buildEventKindDescriptor, F as kebabToCamel, G as BaseAddon, H as videoclipsCapability, I as notificationRulesCapability, J as hydrateSchema, K as DeviceType, L as pipelineAnalyticsCapability, M as faceGalleryCapability, O as customAction, P as isScheduleActive, Q as _enum, R as plateGalleryCapability, S as TrackSourceSchema, T as audioMetricsCapability, U as zoneAnalyticsCapability, V as vectorDimFromBase64, W as errMsg, X as nodePin, Y as isDeviceScopedCap, Z as sleep, _ as NcTaxonomySchema, a as EVENT_PAD_MS, at as string, b as TimelapseRuleInputSchema, c as NC_CONDITION_CATALOG, d as NcRuleInputSchema, et as boolean, f as NcRulePatchSchema, g as NcSnoozeSuppressedSchema, h as NcSnoozeSchema, i as EVENT_KIND_BY_CAP, it as record, j as encodeVectorBase64, k as defineCustomActions, l as NC_TAXONOMY, m as NcSnoozeInputSchema, n as DEFAULT_EVENT_COLOR, nt as number, o as LabelAttributionSchema, ot as unknown, p as NcRuleSchema, q as createEvent, r as DeclaredDevices, rt as object, s as MACRO_LABELS, st as EventCategory, t as BaseDevice, tt as literal, u as NcConditionDescriptorSchema, v as OpsLogEntrySchema, w as alarmPanelCapability, x as TimelapseRuleSchema, y as RetrainStatusSchema, z as readDeviceStateFrom } from "../dist-D9Bm8RyD.mjs";
+import { $ as array, B as subKindsOf, C as addonWidgetsSourceCapability, D as cosineSimilarity, E as buildEventKindDescriptor, F as kebabToCamel, G as BaseAddon, H as videoclipsCapability, I as notificationRulesCapability, J as hydrateSchema, K as DeviceType, L as pipelineAnalyticsCapability, M as faceGalleryCapability, O as customAction, P as isScheduleActive, Q as _enum, R as plateGalleryCapability, S as TrackSourceSchema, T as audioMetricsCapability, U as zoneAnalyticsCapability, V as vectorDimFromBase64, W as errMsg, X as nodePin, Y as isDeviceScopedCap, Z as sleep, _ as NcTaxonomySchema, a as EVENT_PAD_MS, at as string, b as TimelapseRuleInputSchema, c as NC_CONDITION_CATALOG, d as NcRuleInputSchema, et as boolean, f as NcRulePatchSchema, g as NcSnoozeSuppressedSchema, h as NcSnoozeSchema, i as EVENT_KIND_BY_CAP, it as record, j as encodeVectorBase64, k as defineCustomActions, l as NC_TAXONOMY, m as NcSnoozeInputSchema, n as DEFAULT_EVENT_COLOR, nt as number, o as LabelAttributionSchema, ot as unknown, p as NcRuleSchema, q as createEvent, r as DeclaredDevices, rt as object, s as MACRO_LABELS, st as EventCategory, t as BaseDevice, tt as literal, u as NcConditionDescriptorSchema, v as OpsLogEntrySchema, w as alarmPanelCapability, x as TimelapseRuleSchema, y as RetrainStatusSchema, z as readDeviceStateFrom } from "../dist-CI2VspUN.mjs";
+import { t as __exportAll } from "../embedding-encoder/index.mjs";
+import * as fs from "node:fs";
 import { promises } from "node:fs";
+import * as path$1 from "node:path";
 import path from "node:path";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
+import "node:child_process";
 import sharp from "sharp";
 //#region src/notification-center/action-token.ts
 /**
@@ -721,6 +725,227 @@ var NC_ALARM_DECLARATION = {
 	DeviceClass: NcAlarmPanelDevice
 };
 //#endregion
+//#region ../types/dist/node.mjs
+var node_exports = /* @__PURE__ */ __exportAll({
+	FilesystemStorageProvider: () => FilesystemStorageProvider,
+	PYTHON_VERSION: () => PYTHON_VERSION,
+	signExpiringUrl: () => signExpiringUrl,
+	verifyExpiringUrl: () => verifyExpiringUrl
+});
+/**
+* Download portable Python (headless) from bjia56/portable-python.
+*
+* Source: https://github.com/bjia56/portable-python
+*
+* Advantages over python-build-standalone:
+* - macOS universal2 binary (arm64+x86_64 in one)
+* - Lighter (~24-28MB headless zip)
+* - glibc 2.17 minimum (better compat)
+* - Headless variant excludes tkinter/UI (ideal for ML inference)
+*
+* The zip's top-level dir is platform-specific (e.g.
+* `python-headless-3.12.12-darwin-universal2/`); after extraction
+* we rename it to a stable `python/` so consumers can rely on
+* `<dataDir>/deps/python/bin/python3`.
+*/
+var PYTHON_VERSION = "3.12.12";
+`${PYTHON_VERSION}`;
+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$1.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$1.resolve(override));
+			else {
+				const subdir = DEFAULT_LOCATION_SUBDIRS[loc] ?? loc;
+				this.locationPaths.set(loc, path$1.isAbsolute(subdir) ? subdir : path$1.join(this.rootPath, subdir));
+			}
+		}
+		for (const [loc, override] of Object.entries(overrides ?? {})) if (typeof override === "string" && !this.locationPaths.has(loc)) this.locationPaths.set(loc, path$1.resolve(override));
+	}
+	async resolve({ location, relativePath }) {
+		const base = this.locationPaths.get(location) ?? path$1.join(this.rootPath, location);
+		return path$1.join(base, relativePath);
+	}
+	async write({ location, relativePath, data }) {
+		const filePath = await this.resolve({
+			location,
+			relativePath
+		});
+		await fs.promises.mkdir(path$1.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$1.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$1.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$1.join(this.rootPath, location);
+	}
+	/** Get the root path */
+	getRootPath() {
+		return this.rootPath;
+	}
+};
+/**
+* The ONE derivation of "a signed, expiring URL".
+*
+* This repo mints unguessable, self-expiring links in three places now — the
+* notification artifact plane, the Home Assistant media plane, and the snapshot
+* link plane. The first two grew independently and are byte-identical logic
+* (`hmac(secret, "<id>:<exp>")`, expiry checked before a constant-time compare),
+* each restating the crypto locally because **addons never import each other**.
+*
+* That reason is real, and the conclusion drawn from it was wrong. Two copies of
+* a signing scheme is how one of them quietly ends up with a different TTL, a
+* different compare, or a missing expiry check, and nothing fails until a link
+* that should have died keeps working. The fix is the same one D52 applies to
+* crop geometry: one derivation, in a place every addon may depend on. A
+* framework package is exactly that place — `@camstack/types/node`, off the root
+* entry because `node:crypto` must never be traversed by a browser bundler.
+*
+* What this module deliberately does NOT decide: the TTL, the base URL, the
+* shape of `id`, and the access level of the route. Those are per-plane policy
+* and each caller states them where a reader can see them.
+*/
+/**
+* The signature over `(id, expMs)`.
+*
+* `id` is whatever the plane uses to name the thing being served — an artifact
+* id, a track id, a `<deviceId>:<width>` pair. It is joined with `:` so a caller
+* must not put a `:` inside a field whose boundary matters; where a plane has
+* more than one field, it composes them itself and owns that ambiguity.
+*/
+function signExpiringUrl(secret, id, expMs) {
+	return createHmac("sha256", secret).update(`${id}:${String(expMs)}`).digest("hex");
+}
+/**
+* Verify a request's `(id, exp, sig)`.
+*
+* **Expiry is checked BEFORE the compare**, so an expired link is refused
+* whether or not its signature is valid — a leaked URL stops working on its own
+* and cannot be kept alive by holding a correct signature. The compare itself is
+* constant-time so a public route cannot be probed for the signature byte by
+* byte.
+*/
+function verifyExpiringUrl(input) {
+	const { secret, id, exp, sig, nowMs } = input;
+	if (exp === void 0 || sig === void 0) return false;
+	const expMs = typeof exp === "number" ? exp : Number(exp);
+	if (!Number.isFinite(expMs)) return false;
+	if (expMs <= nowMs) return false;
+	const expected = signExpiringUrl(secret, id, expMs);
+	const a = Buffer.from(expected, "utf8");
+	const b = Buffer.from(sig, "utf8");
+	if (a.length !== b.length) return false;
+	return timingSafeEqual(a, b);
+}
+//#endregion
 //#region src/notification-center/artifact-url.ts
 /**
 * Signed, externally-reachable URLs for notification artifacts.
@@ -737,7 +962,10 @@ var NC_ALARM_DECLARATION = {
 *    recipient's phone) — it holds no session and no admin token. The route is
 *    therefore `access:'public'` and the authority is the signature: an
 *    unguessable HMAC over `(id, exp)` with a per-install secret, expiring on
-*    its own. Nothing else about the install is reachable through it.
+*    its own. Nothing else about the install is reachable through it. The HMAC
+*    is the shared one in `@camstack/types/node` — this module used to restate
+*    it, as did the Home Assistant media plane, and two copies of a signing
+*    scheme is how one of them quietly loses its expiry check.
 *  - **The base URL is CHOSEN, never assumed.** A notification carrying
 *    `http://127.0.0.1:...` is useless (the Alexa `hubUrl` bug, again). The
 *    ranked endpoint list the `local-network` cap already computes — public
@@ -754,9 +982,17 @@ var NC_ALARM_DECLARATION = {
 function pickArtifactBaseUrl(endpoints) {
 	return endpoints.filter((e) => e.kind !== "loopback").toSorted((a, b) => a.priority - b.priority)[0]?.baseUrl ?? null;
 }
-/** Sign `(id, exp)` — the exact string the verifier recomputes. */
+/**
+* Sign `(id, exp)` — the exact string the verifier recomputes.
+*
+* Delegates to the one derivation in `@camstack/types/node`. This used to
+* restate the HMAC locally, and so did the Home Assistant media plane, on the
+* correct reasoning that addons never import each other — but two copies of a
+* signing scheme is how one of them ends up with a different expiry check that
+* nothing catches.
+*/
 function signArtifact(secret, id, expMs) {
-	return createHmac("sha256", secret).update(`${id}:${expMs}`).digest("hex");
+	return signExpiringUrl(secret, id, expMs);
 }
 /**
 * Build the fully-qualified, signed URL for an artifact.
@@ -773,12 +1009,7 @@ function buildArtifactUrl(input) {
 * the compare so an expired link is rejected even with a valid signature.
 */
 function verifyArtifactSignature(input) {
-	if (!Number.isFinite(input.exp) || input.exp <= input.nowMs) return false;
-	const expected = signArtifact(input.secret, input.id, input.exp);
-	const a = Buffer.from(expected, "utf8");
-	const b = Buffer.from(input.sig, "utf8");
-	if (a.length !== b.length) return false;
-	return timingSafeEqual(a, b);
+	return verifyExpiringUrl(input);
 }
 //#endregion
 //#region src/notification-center/artifact-plane.ts
@@ -12300,26 +12531,6 @@ function wideCentralSquareLayout(bbox, frame) {
 		frameOriginX
 	};
 }
-//#endregion
-//#region src/shared/frame/subject-crop-variants.ts
-/**
-* Best-shot subject-crop variants (best-crop fast-load, 2026-07-21; 16:9
-* central-square reframe, 2026-07-22).
-*
-* ONE native fetch (the 16:9 central-square WINDOW — see
-* {@link wide-central-square-crop}) backs both persisted variants:
-*  - `thumbnail`      — the native uncapped 16:9 window JPEG (subject in the
-*                       central square, lateral scene context, never upscaled).
-*  - `thumbnailSmall` — the SAME window downscaled to {@link WIDE_THUMBNAIL_SMALL_MAX_WIDTH}
-*                       long side (854×480), the reel / lists / grid fast-load
-*                       representative.
-*
-* The small variant is DERIVED from the already-composed native window — never a
-* second native round-trip and NEVER upscaled: if the window is already ≤ 854 on
-* its long side it is stored AS-IS (byte-identical). The window is composed from
-* the in-frame slab plus lateral letterbox padding for the (rare) part of the
-* 16:9 window that falls outside the frame at a horizontal edge.
-*/
 /** Gaussian sigma for the blurred-scene letterbox fill. */
 var LETTERBOX_BLUR_SIGMA = 25;
 /** Brightness factor for the blurred fill — dimmed so the real slab reads as
@@ -12365,15 +12576,12 @@ async function composeWideCentralSquareThumbnail(slab, layout) {
 }
 /**
 * Derive the `thumbnailSmall` JPEG from the composed native 16:9 window.
-* Downscales to at most {@link WIDE_THUMBNAIL_SMALL_MAX_WIDTH} (854) on the long
-* side (aspect preserved → ~854×480). If the window's long side is already ≤ the
-* cap, the ORIGINAL buffer is returned unchanged (store as-is, never upscale).
+* Downscales to at most {@link WIDE_THUMBNAIL_SMALL_MAX_WIDTH} (480) on the long
+* side (aspect preserved → 480×270) and re-encodes at representative quality.
+* `withoutEnlargement` preserves smaller sources.
 */
 async function deriveThumbnailSmall(nativeWideJpeg) {
-	const meta = await sharp(nativeWideJpeg).metadata();
-	const longSide = Math.max(meta.width ?? 0, meta.height ?? 0);
-	if (longSide > 0 && longSide <= 854) return nativeWideJpeg;
-	return sharp(nativeWideJpeg).resize(854, null, { withoutEnlargement: true }).jpeg({ quality: 88 }).toBuffer();
+	return sharp(nativeWideJpeg).resize(480, null, { withoutEnlargement: true }).jpeg({ quality: 75 }).toBuffer();
 }
 //#endregion
 //#region src/shared/frame/keyframe-wide-thumbnail.ts
@@ -14627,6 +14835,7 @@ function createEventMediaHandler(deps) {
 		}
 		const variant = parseEventMediaVariant(query);
 		const preferKind = parseEventMediaKind(query);
+		const resolveStartedAt = performance.now();
 		let media = null;
 		try {
 			media = await deps.getMedia(eventId, variant ?? void 0, preferKind ?? void 0);
@@ -14634,21 +14843,24 @@ function createEventMediaHandler(deps) {
 			const body = "Internal server error";
 			res.writeHead(500, {
 				"content-type": "text/plain",
-				"content-length": String(Buffer.byteLength(body))
+				"content-length": String(Buffer.byteLength(body)),
+				"server-timing": `resolve;dur=${(performance.now() - resolveStartedAt).toFixed(1)}`
 			});
 			if (req.method !== "HEAD") res.end(body);
 			else res.end();
 			return;
 		}
 		if (media === null) {
-			res.writeHead(404).end();
+			res.writeHead(404, { "server-timing": `resolve;dur=${(performance.now() - resolveStartedAt).toFixed(1)}` }).end();
 			return;
 		}
 		const etag = "\"" + media.key + "\"";
+		const serverTiming = `resolve;dur=${(performance.now() - resolveStartedAt).toFixed(1)}`;
 		if (req.headers["if-none-match"] === etag) {
 			res.writeHead(304, {
 				etag,
-				"cache-control": CACHE_CONTROL
+				"cache-control": CACHE_CONTROL,
+				"server-timing": serverTiming
 			}).end();
 			return;
 		}
@@ -14656,7 +14868,8 @@ function createEventMediaHandler(deps) {
 			"content-type": "image/jpeg",
 			"cache-control": CACHE_CONTROL,
 			etag,
-			"content-length": String(media.bytes.byteLength)
+			"content-length": String(media.bytes.byteLength),
+			"server-timing": serverTiming
 		});
 		if (req.method === "HEAD") res.end();
 		else res.end(Buffer.from(media.bytes));
@@ -27383,9 +27596,9 @@ var EventMediaDispatcher = class {
 	* the runner's retained native surface with NO `maxWidth` (uncapped TRUE
 	* native). It is composed into the full 16:9 window (lateral letterbox only for
 	* the part outside the frame) → the `thumbnail`. The `thumbnailSmall` is
-	* DERIVED by downscaling that SAME window to the 854 long-side cap (854×480) —
+	* DERIVED by downscaling that SAME window to the 480 long-side cap (480×270) —
 	* never a second `getNativeCropJpeg`, never upscaled ({@link deriveThumbnailSmall}
-	* returns the window as-is when it is already ≤ 854).
+	* never upscales a smaller window).
 	*
 	* Both variants share the SAME framing + central-square containment guarantee:
 	* wide consumers use the 16:9 image as-is (subject centered, no cut); square
@@ -30644,6 +30857,7 @@ var MOTION_EVENT_HEARTBEAT_MS = 5e3;
 var CLEAN_MEDIA_KINDS = [
 	"crop",
 	"thumbnail",
+	"thumbnailSmall",
 	"fullFrame",
 	"keyFrame",
 	"keyFrameSmall"
@@ -31495,7 +31709,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		let storage = this.ctx.kernel.storage;
 		const mediaRoot = process.env.CAMSTACK_MEDIA_ROOT?.trim();
 		if (mediaRoot) {
-			const { FilesystemStorageProvider } = await import("../node-Co0YpEFr.mjs");
+			const { FilesystemStorageProvider } = await Promise.resolve().then(() => node_exports);
 			storage = new FilesystemStorageProvider(mediaRoot, { eventMedia: mediaRoot });
 			logger.info("pipeline-analytics: event media rooted at CAMSTACK_MEDIA_ROOT", { meta: { mediaRoot } });
 		}
@@ -35982,6 +36196,7 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 	* failure the full blob is served (a thumb must never 500 / blank a tile).
 	*/
 	async applyThumbVariant(media, variant) {
+		if (media.key.includes(":thumbnailSmall") && media.bytes.byteLength <= 64 * 1024) return media;
 		try {
 			return {
 				bytes: await makeSquareThumb(media.bytes, variant.size),
@@ -36000,7 +36215,13 @@ var PipelineAnalyticsAddon = class extends BaseAddon {
 		const eventFiles = await (this.mediaStore?.listByOwner("event", id) ?? Promise.resolve([]));
 		if (preferKind !== void 0 && preferKind.length > 0) {
 			const trackFiles = await (this.mediaStore?.listByOwner("track", id) ?? Promise.resolve([]));
-			const chosen = resolveCropForcedMedia([...eventFiles, ...trackFiles], (files) => pickCleanMedia(files, preferKind));
+			const ownerTrackId = trackFiles.length === 0 ? await (this.eventStore?.getTrackIdForEvent(id) ?? Promise.resolve(null)) : null;
+			const owningTrackFiles = ownerTrackId === null ? [] : await (this.mediaStore?.listByOwner("track", ownerTrackId) ?? Promise.resolve([]));
+			const chosen = resolveCropForcedMedia([
+				...eventFiles,
+				...trackFiles,
+				...owningTrackFiles
+			], (files) => pickCleanMedia(files, preferKind));
 			if (!chosen) return null;
 			return {
 				bytes: Buffer.from(chosen.base64, "base64"),

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-BuCI6peK.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_pipeline_analytics_widgets-CUxRQmzz.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-post-analysis",
-  "version": "1.2.55",
+  "version": "1.2.58",
   "description": "Post-Analysis bundle — enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping addons that consume pipeline output.",
   "keywords": [
     "camstack",

package/dist/node-Co0YpEFr.mjs

@@ -1,148 +0,0 @@
-import * as fs from "node:fs";
-import * as path$1 from "node:path";
-import "node:crypto";
-import "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 = path$1.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$1.resolve(override));
-			else {
-				const subdir = DEFAULT_LOCATION_SUBDIRS[loc] ?? loc;
-				this.locationPaths.set(loc, path$1.isAbsolute(subdir) ? subdir : path$1.join(this.rootPath, subdir));
-			}
-		}
-		for (const [loc, override] of Object.entries(overrides ?? {})) if (typeof override === "string" && !this.locationPaths.has(loc)) this.locationPaths.set(loc, path$1.resolve(override));
-	}
-	async resolve({ location, relativePath }) {
-		const base = this.locationPaths.get(location) ?? path$1.join(this.rootPath, location);
-		return path$1.join(base, relativePath);
-	}
-	async write({ location, relativePath, data }) {
-		const filePath = await this.resolve({
-			location,
-			relativePath
-		});
-		await fs.promises.mkdir(path$1.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$1.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$1.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$1.join(this.rootPath, location);
-	}
-	/** Get the root path */
-	getRootPath() {
-		return this.rootPath;
-	}
-};
-//#endregion
-export { FilesystemStorageProvider };