@camstack/system 1.1.50 → 1.1.52

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 let node_child_process = require("node:child_process");
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -200,12 +200,102 @@ function raceForResult(promise, timeoutMs) {
 	});
 }
 //#endregion
+//#region src/builtins/snapshot/snapshot-media-handler.ts
+/**
+* Parse the handler-relative path (`/<deviceId>.jpg?query`) into a request.
+* Returns null for a malformed / nested / non-numeric id so the handler answers
+* 404 without ever reaching `getMedia`.
+*/
+function parseSnapshotMediaRequest(url) {
+	const qIdx = url.indexOf("?");
+	const rawPath = qIdx === -1 ? url : url.slice(0, qIdx);
+	const query = qIdx === -1 ? "" : url.slice(qIdx + 1);
+	const segment = rawPath.replace(/^\/+/, "");
+	if (segment.length === 0 || segment.includes("/")) return null;
+	const idPart = segment.replace(/\.jpe?g$/i, "");
+	if (!/^\d+$/.test(idPart)) return null;
+	const deviceId = Number.parseInt(idPart, 10);
+	if (!Number.isSafeInteger(deviceId)) return null;
+	const params = new URLSearchParams(query);
+	const rawStream = params.get("streamId");
+	const streamId = rawStream !== null && rawStream.length > 0 ? rawStream : void 0;
+	const rawForce = params.get("force");
+	return {
+		deviceId,
+		streamId,
+		force: rawForce === "1" || rawForce === "true"
+	};
+}
+/**
+* Create a data-plane handler that serves per-device snapshots as JPEG images.
+* `deps.getMedia` is called once per request; null → 404, throw → 500. A
+* conditional GET with a matching `If-None-Match` produces a 304.
+*/
+function createSnapshotMediaHandler(deps) {
+	return async (req, res) => {
+		if (req.method !== "GET" && req.method !== "HEAD") {
+			res.writeHead(405, { allow: "GET, HEAD" }).end();
+			return;
+		}
+		const parsed = parseSnapshotMediaRequest(req.url ?? "/");
+		if (parsed === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		let media;
+		try {
+			media = await deps.getMedia(parsed.deviceId, parsed.streamId, parsed.force);
+		} catch {
+			const body = "Internal server error";
+			res.writeHead(500, {
+				"content-type": "text/plain",
+				"content-length": String(Buffer.byteLength(body))
+			});
+			if (req.method === "HEAD") res.end();
+			else res.end(body);
+			return;
+		}
+		if (media === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		const etag = `"${parsed.deviceId}-${media.capturedAt}"`;
+		const cacheControl = `private, max-age=${Math.max(0, Math.floor(media.maxAgeS))}`;
+		if (req.headers["if-none-match"] === etag) {
+			res.writeHead(304, {
+				etag,
+				"cache-control": cacheControl
+			}).end();
+			return;
+		}
+		res.writeHead(200, {
+			"content-type": media.contentType,
+			"cache-control": cacheControl,
+			etag,
+			"content-length": String(media.bytes.byteLength)
+		});
+		if (req.method === "HEAD") res.end();
+		else res.end(Buffer.from(media.bytes));
+	};
+}
+//#endregion
 //#region src/builtins/snapshot/snapshot.addon.ts
 /** Default cache window for non-battery cams (seconds). 10s feels live. */
 var NON_BATTERY_DEFAULT_MAX_AGE_S = 10;
 /** Default cache window for battery cams (seconds). 1h ≈ "don't wake the cam unless asked". */
 var BATTERY_DEFAULT_MAX_AGE_S = 3600;
 /**
+* Effective per-device max cache age (seconds): the operator override
+* (`snapshotMaxAgeS`) when a finite non-negative number, else the battery-aware
+* default. Shared by the freshness gate (`getSnapshot`) and the HTTP endpoint's
+* `Cache-Control: max-age` (so the browser/`expo-image` layer caches for exactly
+* as long as the wrapper considers the frame fresh).
+*/
+function effectiveMaxAgeS(prefs, isBattery) {
+	const def = isBattery ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
+	return typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : def;
+}
+/**
 * SnapshotAddon — wrapper over the `snapshot` capability.
 *
 * Activated per-device (toggleable by user; default active). When active,
@@ -245,25 +335,86 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 	*/
 	ownerCache = null;
 	static OWNER_CACHE_TTL_MS = 3e4;
+	/**
+	* Handle for the `/addon/snapshot/media/<deviceId>.jpg` HTTP data-plane
+	* endpoint (§3.1). Null when the host provides no `ctx.dataPlane` facility
+	* (the tRPC `getSnapshot` base64 surface still works — the endpoint is a
+	* strictly-additive delivery path). Disposed on shutdown.
+	*/
+	mediaDataPlane = null;
 	constructor() {
 		super({ staleTtlMs: 6e4 });
 	}
 	async onInitialize() {
 		this.ctx.logger.info("Snapshot wrapper initialized");
+		const provider = {
+			getSnapshot: (input) => this.getSnapshot(input),
+			invalidateCache: (input) => this.invalidateCache(input),
+			getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
+			getDeviceLiveContribution: async () => null,
+			applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
+			getStatus: async (input) => this.getStatus(input.deviceId),
+			getSnapshotOverview: (input) => this.getSnapshotOverview(input)
+		};
+		await this.serveMediaDataPlane();
 		return [{
 			capability: require_dist.snapshotCapability,
-			provider: {
-				getSnapshot: (input) => this.getSnapshot(input),
-				invalidateCache: (input) => this.invalidateCache(input),
-				getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
-				getDeviceLiveContribution: async () => null,
-				applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
-				getStatus: async (input) => this.getStatus(input.deviceId),
-				getSnapshotOverview: (input) => this.getSnapshotOverview(input)
-			}
+			provider
 		}];
 	}
+	/**
+	* Serve the per-device snapshot image endpoint on the addon data-plane
+	* (§3.1). Delivery: `GET /addon/snapshot/media/<deviceId>.jpg` → raw JPEG with
+	* `ETag` + `Cache-Control: private, max-age=<device maxAgeS>`, so a grid is N
+	* independent `<Image>` tiles served from the coalesced server cache (no
+	* base64 tax, no batch head-of-line blocking, browser/`expo-image` caching for
+	* free). Best-effort: a host without a `dataPlane` facility keeps the tRPC
+	* base64 path.
+	*/
+	async serveMediaDataPlane() {
+		const handler = createSnapshotMediaHandler({ getMedia: (deviceId, streamId, force) => this.resolveSnapshotMedia(deviceId, streamId, force) });
+		try {
+			this.mediaDataPlane = await this.ctx.dataPlane?.serve({
+				prefix: "media",
+				access: "authenticated",
+				handler
+			}) ?? null;
+			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${this.ctx.id}/media` : "(no dataPlane facility)" } });
+		} catch (err) {
+			this.ctx.logger.warn("snapshot media data-plane failed to serve", { meta: { error: require_dist.errMsg(err) } });
+			this.mediaDataPlane = null;
+		}
+	}
+	/**
+	* Resolve a device (+ optional stream, + force) to renderable JPEG bytes for
+	* the HTTP endpoint. Runs the same coalesced capture ladder as the tRPC
+	* `getSnapshot` (so every consumer shares one upstream pull), then decodes the
+	* base64 cache into raw bytes and stamps the frame identity: `capturedAt` from
+	* the cache entry (matching the ETag `getSnapshotOverview` advertises) and the
+	* effective per-device `maxAgeS` for `Cache-Control`. Null → 404.
+	*/
+	async resolveSnapshotMedia(deviceId, streamId, force) {
+		const image = await this.getSnapshot({
+			deviceId,
+			...streamId !== void 0 ? { streamId } : {},
+			force
+		});
+		if (!image) return null;
+		const capturedAt = this.cache.get(deviceId)?.ts ?? Date.now();
+		const prefs = await this.readDeviceSettings(deviceId).catch(() => ({}));
+		const isBattery = (await this.lookupDeviceMeta(deviceId))?.isBattery ?? false;
+		return {
+			bytes: Buffer.from(image.base64, "base64"),
+			contentType: image.contentType,
+			capturedAt,
+			maxAgeS: effectiveMaxAgeS(prefs, isBattery)
+		};
+	}
 	async onShutdown() {
+		if (this.mediaDataPlane) {
+			await this.mediaDataPlane.dispose().catch(() => void 0);
+			this.mediaDataPlane = null;
+		}
 		this.cache.clear();
 		this.captureFlight.clear();
 		this.ownerCache = null;
@@ -316,8 +467,7 @@ var SnapshotAddon = class SnapshotAddon extends require_dist.BaseAddon {
 			tags: { deviceId },
 			meta: { stream: effectiveStreamId ?? "auto" }
 		});
-		const defaultMaxAgeS = isBatteryDevice ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
-		const effectiveMaxAgeMs = (typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : defaultMaxAgeS) * 1e3;
+		const effectiveMaxAgeMs = effectiveMaxAgeS(prefs, isBatteryDevice) * 1e3;
 		const decision = decideSnapshotServe({
 			now,
 			cachedAt: hit?.ts ?? null,

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { Q as streamQualityLabel, Y as snapshotCapability, lt as DeviceType, nt as errMsg, rt as BaseAddon, st as DeviceFeature, z as nodePin } from "../../dist-CC3E-_3h.mjs";
+import { $ as streamQualityLabel, B as nodePin, X as snapshotCapability, ct as DeviceFeature, it as BaseAddon, rt as errMsg, ut as DeviceType } from "../../dist-B_PSvr-m.mjs";
 import { execFile } from "node:child_process";
 //#region src/builtins/snapshot/snapshot-coalescing.ts
 /**
@@ -195,12 +195,102 @@ function raceForResult(promise, timeoutMs) {
 	});
 }
 //#endregion
+//#region src/builtins/snapshot/snapshot-media-handler.ts
+/**
+* Parse the handler-relative path (`/<deviceId>.jpg?query`) into a request.
+* Returns null for a malformed / nested / non-numeric id so the handler answers
+* 404 without ever reaching `getMedia`.
+*/
+function parseSnapshotMediaRequest(url) {
+	const qIdx = url.indexOf("?");
+	const rawPath = qIdx === -1 ? url : url.slice(0, qIdx);
+	const query = qIdx === -1 ? "" : url.slice(qIdx + 1);
+	const segment = rawPath.replace(/^\/+/, "");
+	if (segment.length === 0 || segment.includes("/")) return null;
+	const idPart = segment.replace(/\.jpe?g$/i, "");
+	if (!/^\d+$/.test(idPart)) return null;
+	const deviceId = Number.parseInt(idPart, 10);
+	if (!Number.isSafeInteger(deviceId)) return null;
+	const params = new URLSearchParams(query);
+	const rawStream = params.get("streamId");
+	const streamId = rawStream !== null && rawStream.length > 0 ? rawStream : void 0;
+	const rawForce = params.get("force");
+	return {
+		deviceId,
+		streamId,
+		force: rawForce === "1" || rawForce === "true"
+	};
+}
+/**
+* Create a data-plane handler that serves per-device snapshots as JPEG images.
+* `deps.getMedia` is called once per request; null → 404, throw → 500. A
+* conditional GET with a matching `If-None-Match` produces a 304.
+*/
+function createSnapshotMediaHandler(deps) {
+	return async (req, res) => {
+		if (req.method !== "GET" && req.method !== "HEAD") {
+			res.writeHead(405, { allow: "GET, HEAD" }).end();
+			return;
+		}
+		const parsed = parseSnapshotMediaRequest(req.url ?? "/");
+		if (parsed === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		let media;
+		try {
+			media = await deps.getMedia(parsed.deviceId, parsed.streamId, parsed.force);
+		} catch {
+			const body = "Internal server error";
+			res.writeHead(500, {
+				"content-type": "text/plain",
+				"content-length": String(Buffer.byteLength(body))
+			});
+			if (req.method === "HEAD") res.end();
+			else res.end(body);
+			return;
+		}
+		if (media === null) {
+			res.writeHead(404).end();
+			return;
+		}
+		const etag = `"${parsed.deviceId}-${media.capturedAt}"`;
+		const cacheControl = `private, max-age=${Math.max(0, Math.floor(media.maxAgeS))}`;
+		if (req.headers["if-none-match"] === etag) {
+			res.writeHead(304, {
+				etag,
+				"cache-control": cacheControl
+			}).end();
+			return;
+		}
+		res.writeHead(200, {
+			"content-type": media.contentType,
+			"cache-control": cacheControl,
+			etag,
+			"content-length": String(media.bytes.byteLength)
+		});
+		if (req.method === "HEAD") res.end();
+		else res.end(Buffer.from(media.bytes));
+	};
+}
+//#endregion
 //#region src/builtins/snapshot/snapshot.addon.ts
 /** Default cache window for non-battery cams (seconds). 10s feels live. */
 var NON_BATTERY_DEFAULT_MAX_AGE_S = 10;
 /** Default cache window for battery cams (seconds). 1h ≈ "don't wake the cam unless asked". */
 var BATTERY_DEFAULT_MAX_AGE_S = 3600;
 /**
+* Effective per-device max cache age (seconds): the operator override
+* (`snapshotMaxAgeS`) when a finite non-negative number, else the battery-aware
+* default. Shared by the freshness gate (`getSnapshot`) and the HTTP endpoint's
+* `Cache-Control: max-age` (so the browser/`expo-image` layer caches for exactly
+* as long as the wrapper considers the frame fresh).
+*/
+function effectiveMaxAgeS(prefs, isBattery) {
+	const def = isBattery ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
+	return typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : def;
+}
+/**
 * SnapshotAddon — wrapper over the `snapshot` capability.
 *
 * Activated per-device (toggleable by user; default active). When active,
@@ -240,25 +330,86 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 	*/
 	ownerCache = null;
 	static OWNER_CACHE_TTL_MS = 3e4;
+	/**
+	* Handle for the `/addon/snapshot/media/<deviceId>.jpg` HTTP data-plane
+	* endpoint (§3.1). Null when the host provides no `ctx.dataPlane` facility
+	* (the tRPC `getSnapshot` base64 surface still works — the endpoint is a
+	* strictly-additive delivery path). Disposed on shutdown.
+	*/
+	mediaDataPlane = null;
 	constructor() {
 		super({ staleTtlMs: 6e4 });
 	}
 	async onInitialize() {
 		this.ctx.logger.info("Snapshot wrapper initialized");
+		const provider = {
+			getSnapshot: (input) => this.getSnapshot(input),
+			invalidateCache: (input) => this.invalidateCache(input),
+			getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
+			getDeviceLiveContribution: async () => null,
+			applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
+			getStatus: async (input) => this.getStatus(input.deviceId),
+			getSnapshotOverview: (input) => this.getSnapshotOverview(input)
+		};
+		await this.serveMediaDataPlane();
 		return [{
 			capability: snapshotCapability,
-			provider: {
-				getSnapshot: (input) => this.getSnapshot(input),
-				invalidateCache: (input) => this.invalidateCache(input),
-				getDeviceSettingsContribution: (input) => this.buildDeviceSettingsContribution(input.deviceId),
-				getDeviceLiveContribution: async () => null,
-				applyDeviceSettingsPatch: (input) => this.saveDeviceSettingsPatch(input.deviceId, input.patch),
-				getStatus: async (input) => this.getStatus(input.deviceId),
-				getSnapshotOverview: (input) => this.getSnapshotOverview(input)
-			}
+			provider
 		}];
 	}
+	/**
+	* Serve the per-device snapshot image endpoint on the addon data-plane
+	* (§3.1). Delivery: `GET /addon/snapshot/media/<deviceId>.jpg` → raw JPEG with
+	* `ETag` + `Cache-Control: private, max-age=<device maxAgeS>`, so a grid is N
+	* independent `<Image>` tiles served from the coalesced server cache (no
+	* base64 tax, no batch head-of-line blocking, browser/`expo-image` caching for
+	* free). Best-effort: a host without a `dataPlane` facility keeps the tRPC
+	* base64 path.
+	*/
+	async serveMediaDataPlane() {
+		const handler = createSnapshotMediaHandler({ getMedia: (deviceId, streamId, force) => this.resolveSnapshotMedia(deviceId, streamId, force) });
+		try {
+			this.mediaDataPlane = await this.ctx.dataPlane?.serve({
+				prefix: "media",
+				access: "authenticated",
+				handler
+			}) ?? null;
+			this.ctx.logger.info("snapshot media data-plane served", { meta: { baseUrl: this.mediaDataPlane ? `/addon/${this.ctx.id}/media` : "(no dataPlane facility)" } });
+		} catch (err) {
+			this.ctx.logger.warn("snapshot media data-plane failed to serve", { meta: { error: errMsg(err) } });
+			this.mediaDataPlane = null;
+		}
+	}
+	/**
+	* Resolve a device (+ optional stream, + force) to renderable JPEG bytes for
+	* the HTTP endpoint. Runs the same coalesced capture ladder as the tRPC
+	* `getSnapshot` (so every consumer shares one upstream pull), then decodes the
+	* base64 cache into raw bytes and stamps the frame identity: `capturedAt` from
+	* the cache entry (matching the ETag `getSnapshotOverview` advertises) and the
+	* effective per-device `maxAgeS` for `Cache-Control`. Null → 404.
+	*/
+	async resolveSnapshotMedia(deviceId, streamId, force) {
+		const image = await this.getSnapshot({
+			deviceId,
+			...streamId !== void 0 ? { streamId } : {},
+			force
+		});
+		if (!image) return null;
+		const capturedAt = this.cache.get(deviceId)?.ts ?? Date.now();
+		const prefs = await this.readDeviceSettings(deviceId).catch(() => ({}));
+		const isBattery = (await this.lookupDeviceMeta(deviceId))?.isBattery ?? false;
+		return {
+			bytes: Buffer.from(image.base64, "base64"),
+			contentType: image.contentType,
+			capturedAt,
+			maxAgeS: effectiveMaxAgeS(prefs, isBattery)
+		};
+	}
 	async onShutdown() {
+		if (this.mediaDataPlane) {
+			await this.mediaDataPlane.dispose().catch(() => void 0);
+			this.mediaDataPlane = null;
+		}
 		this.cache.clear();
 		this.captureFlight.clear();
 		this.ownerCache = null;
@@ -311,8 +462,7 @@ var SnapshotAddon = class SnapshotAddon extends BaseAddon {
 			tags: { deviceId },
 			meta: { stream: effectiveStreamId ?? "auto" }
 		});
-		const defaultMaxAgeS = isBatteryDevice ? BATTERY_DEFAULT_MAX_AGE_S : NON_BATTERY_DEFAULT_MAX_AGE_S;
-		const effectiveMaxAgeMs = (typeof prefs.snapshotMaxAgeS === "number" && prefs.snapshotMaxAgeS >= 0 ? prefs.snapshotMaxAgeS : defaultMaxAgeS) * 1e3;
+		const effectiveMaxAgeMs = effectiveMaxAgeS(prefs, isBatteryDevice) * 1e3;
 		const decision = decideSnapshotServe({
 			now,
 			cachedAt: hit?.ts ?? null,

package/dist/builtins/snapshot/snapshot-media-handler.d.ts

@@ -0,0 +1,38 @@
+import { DataPlaneHandler } from '@camstack/types';
+/** A renderable snapshot frame resolved for one device. */
+export interface SnapshotMedia {
+    /** Raw image bytes (already decoded from the wrapper's base64 cache). */
+    readonly bytes: Uint8Array;
+    /** MIME type — practically always `image/jpeg`. */
+    readonly contentType: string;
+    /** Epoch ms of the cached capture — drives the ETag and frame identity. */
+    readonly capturedAt: number;
+    /** Effective per-device max cache age (seconds) → `Cache-Control: max-age`. */
+    readonly maxAgeS: number;
+}
+export interface SnapshotMediaHandlerDeps {
+    /**
+     * Resolve a device (+ optional stream, + force) to a renderable frame. Runs
+     * the wrapper's coalesced capture ladder; returns null when no frame can be
+     * produced (→ 404). Throwing produces an opaque 500 (caller logs).
+     */
+    readonly getMedia: (deviceId: number, streamId: string | undefined, force: boolean) => Promise<SnapshotMedia | null>;
+}
+/** Parsed `/<deviceId>[.jpg][?streamId=…&force=1]` request. */
+export interface SnapshotMediaRequest {
+    readonly deviceId: number;
+    readonly streamId: string | undefined;
+    readonly force: boolean;
+}
+/**
+ * Parse the handler-relative path (`/<deviceId>.jpg?query`) into a request.
+ * Returns null for a malformed / nested / non-numeric id so the handler answers
+ * 404 without ever reaching `getMedia`.
+ */
+export declare function parseSnapshotMediaRequest(url: string): SnapshotMediaRequest | null;
+/**
+ * Create a data-plane handler that serves per-device snapshots as JPEG images.
+ * `deps.getMedia` is called once per request; null → 404, throw → 500. A
+ * conditional GET with a matching `If-None-Match` produces a 304.
+ */
+export declare function createSnapshotMediaHandler(deps: SnapshotMediaHandlerDeps): DataPlaneHandler;

package/dist/builtins/snapshot/snapshot.addon.d.ts

@@ -50,8 +50,34 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      */
     private ownerCache;
     private static readonly OWNER_CACHE_TTL_MS;
+    /**
+     * Handle for the `/addon/snapshot/media/<deviceId>.jpg` HTTP data-plane
+     * endpoint (§3.1). Null when the host provides no `ctx.dataPlane` facility
+     * (the tRPC `getSnapshot` base64 surface still works — the endpoint is a
+     * strictly-additive delivery path). Disposed on shutdown.
+     */
+    private mediaDataPlane;
     constructor();
     protected onInitialize(): Promise<ProviderRegistration[]>;
+    /**
+     * Serve the per-device snapshot image endpoint on the addon data-plane
+     * (§3.1). Delivery: `GET /addon/snapshot/media/<deviceId>.jpg` → raw JPEG with
+     * `ETag` + `Cache-Control: private, max-age=<device maxAgeS>`, so a grid is N
+     * independent `<Image>` tiles served from the coalesced server cache (no
+     * base64 tax, no batch head-of-line blocking, browser/`expo-image` caching for
+     * free). Best-effort: a host without a `dataPlane` facility keeps the tRPC
+     * base64 path.
+     */
+    private serveMediaDataPlane;
+    /**
+     * Resolve a device (+ optional stream, + force) to renderable JPEG bytes for
+     * the HTTP endpoint. Runs the same coalesced capture ladder as the tRPC
+     * `getSnapshot` (so every consumer shares one upstream pull), then decodes the
+     * base64 cache into raw bytes and stamps the frame identity: `capturedAt` from
+     * the cache entry (matching the ETag `getSnapshotOverview` advertises) and the
+     * effective per-device `maxAgeS` for `Cache-Control`. Null → 404.
+     */
+    private resolveSnapshotMedia;
     protected onShutdown(): Promise<void>;
     /**
      * Drop the cached ingest owner whenever addon-level settings change —

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 let node_fs = require("node:fs");
 node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { D as filesystemBrowseCapability, Z as storageProviderCapability, rt as BaseAddon } from "../../dist-CC3E-_3h.mjs";
+import { O as filesystemBrowseCapability, Q as storageProviderCapability, it as BaseAddon } from "../../dist-B_PSvr-m.mjs";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import { basename, dirname, join, resolve, sep } from "node:path";

package/dist/builtins/sqlite-storage/sqlite-settings.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 let node_crypto = require("node:crypto");
 let better_sqlite3 = require("better-sqlite3");
 better_sqlite3 = require_chunk.__toESM(better_sqlite3);

package/dist/builtins/sqlite-storage/sqlite-settings.addon.mjs

@@ -1,4 +1,4 @@
-import { J as settingsStoreCapability, mt as asJsonObject, nt as errMsg, rt as BaseAddon, s as RUNTIME_DEFAULTS, wt as parseJsonUnknown } from "../../dist-CC3E-_3h.mjs";
+import { Y as settingsStoreCapability, it as BaseAddon, mt as asJsonObject, rt as errMsg, s as RUNTIME_DEFAULTS, wt as parseJsonUnknown } from "../../dist-B_PSvr-m.mjs";
 import { randomUUID } from "node:crypto";
 import Database from "better-sqlite3";
 //#region src/builtins/sqlite-storage/sqlite-settings-backend.ts

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/storage-orchestrator/storage-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { Ct as parseJsonObject, X as storageCapability, rt as BaseAddon, u as StorageLocationTypeSchema } from "../../dist-CC3E-_3h.mjs";
+import { Ct as parseJsonObject, Z as storageCapability, it as BaseAddon, u as StorageLocationTypeSchema } from "../../dist-B_PSvr-m.mjs";
 import * as path$1 from "node:path";
 import * as fs from "node:fs/promises";
 import { buildStorageLocationRegistry } from "@camstack/system";

package/dist/builtins/system-config/system-config.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -108,9 +108,9 @@ var SystemConfigAddon = class extends require_dist.BaseAddon {
 				type: "text",
 				key: "tokenExpiry",
 				label: "Token Expiry",
-				description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
-				placeholder: "24h",
-				default: "24h"
+				description: "JWT token lifetime (e.g. 24h, 7d, 30d)",
+				placeholder: "30d",
+				default: "30d"
 			}]
 		}] };
 	}

package/dist/builtins/system-config/system-config.addon.mjs

@@ -1,4 +1,4 @@
-import { nt as errMsg, rt as BaseAddon, xt as hydrateSchema } from "../../dist-CC3E-_3h.mjs";
+import { it as BaseAddon, rt as errMsg, xt as hydrateSchema } from "../../dist-B_PSvr-m.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.
@@ -103,9 +103,9 @@ var SystemConfigAddon = class extends BaseAddon {
 				type: "text",
 				key: "tokenExpiry",
 				label: "Token Expiry",
-				description: "JWT token lifetime (e.g. 24h, 7d, 1h)",
-				placeholder: "24h",
-				default: "24h"
+				description: "JWT token lifetime (e.g. 24h, 7d, 30d)",
+				placeholder: "30d",
+				default: "30d"
 			}]
 		}] };
 	}

package/dist/builtins/winston-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-CQYo6Zp8.js");
+const require_dist = require("../../dist-BduBhv6N.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path);

package/dist/builtins/winston-logging/index.mjs

@@ -1,4 +1,4 @@
-import { I as logDestinationCapability, rt as BaseAddon } from "../../dist-CC3E-_3h.mjs";
+import { L as logDestinationCapability, it as BaseAddon } from "../../dist-B_PSvr-m.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";