@camstack/system 1.1.50 → 1.1.51

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 { Q as streamQualityLabel, Y as snapshotCapability, lt as DeviceType, nt as errMsg, rt as BaseAddon, st as DeviceFeature, z as nodePin } from "../../dist-BWQX9yUj.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-C3uHEBtP.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 { D as filesystemBrowseCapability, Z as storageProviderCapability, rt as BaseAddon } from "../../dist-BWQX9yUj.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-C3uHEBtP.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 { Ct as parseJsonUnknown, J as settingsStoreCapability, nt as errMsg, pt as asJsonObject, rt as BaseAddon, s as RUNTIME_DEFAULTS } from "../../dist-BWQX9yUj.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-C3uHEBtP.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 { St as parseJsonObject, X as storageCapability, rt as BaseAddon, u as StorageLocationTypeSchema } from "../../dist-BWQX9yUj.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-C3uHEBtP.js");
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

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 { bt as hydrateSchema, nt as errMsg, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 //#region src/builtins/system-config/system-config.addon.ts
 /**
 * Built-in `system-config` addon — Phase 4 of the settings redesign.

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-C3uHEBtP.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 { I as logDestinationCapability, rt as BaseAddon } from "../../dist-BWQX9yUj.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 import * as path$1 from "node:path";
 import path from "node:path";

package/dist/{dist-CC3E-_3h.mjs → dist-BWQX9yUj.mjs}

@@ -1,5 +1,5 @@
 import { z } from "zod";
-//#region ../types/dist/sleep-_sv7WKkq.mjs
+//#region ../types/dist/event-category-CFZs3jI4.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -17952,7 +17952,15 @@ var webrtcSessionCapability = {
 			*/
 			disableIpv6: z.boolean().optional(),
 			/** Subscriber attribution. See `createSession` for the contract. */
-			consumerAttribution: BrokerConsumerAttributionSchema.optional()
+			consumerAttribution: BrokerConsumerAttributionSchema.optional(),
+			/**
+			* Client-side stream hints (viewport, downlink) — same contract as
+			* `createSession.hints`. Client-offer viewers (the RN viewer's
+			* `WebrtcLiveSession`) negotiate via `handleOffer`, so without this
+			* field their hints were silently stripped by the schema and the
+			* adaptive ladder started blind on the client's display size.
+			*/
+			hints: webrtcClientHintsSchema.optional()
 		}), z.object({
 			sessionId: z.string(),
 			sdpAnswer: z.string()
@@ -26318,4 +26326,4 @@ function scoreRuntimes(hw) {
 	};
 }
 //#endregion
-export { toExpressionValue as $, isCollectionArrayMethod as A, normalizeUnit as B, enumerateItemArrayFields as C, parseJsonObject as Ct, filesystemBrowseCapability as D, scopeKey as Dt, extractNestedAddonId as E, resolveCapMount as Et, localNetworkCapability as F, readNodePin as G, parseStreamParamsFormPatch as H, logDestinationCapability as I, settingsStoreCapability as J, scoreRuntimes as K, looseSchema as L, isVoidInput as M, kebabToCamel as N, getByPath as O, sleep as Ot, lifecycleJobSchema as P, streamQualityLabel as Q, metricsProviderCapability as R, deviceStatusCapability as S, isDeviceConfigCap as St, evaluateLinkExpression as T, readinessKey as Tt, platformProbeCapability as U, objectInputDeclaresAddonId as V, procedureAuthKey as W, storageCapability as X, snapshotCapability as Y, storageProviderCapability as Z, authProviderCapability as _, createEvent as _t, DeviceStatusSchema as a, DEVICE_SETTINGS_CONTRIBUTION_METHODS as at, deviceManagerCapability as b, expandCapMethods as bt, STREAM_PROFILE_META as c, DeviceRole as ct, UserRecordSchema as d, ReadinessRegistry as dt, userManagementCapability as et, addonPagesCapability as f, ReadinessTimeoutError as ft, applyTransform as g, asString as gt, alertsCapability as h, asNumber as ht, CAP_NAMES_WITH_STATUS as i, DATAPLANE_SECRET_HEADER as it, isObjectInput as j, isArrayOutputSchema as k, ScopedTokenSchema as l, DeviceType as lt, addonWidgetsCapability as m, asJsonObject as mt, AlertSchema as n, errMsg as nt, METHOD_ACCESS_MAP as o, DEVICE_STATUS_METHOD as ot, addonSettingsCapability as p, WELL_KNOWN_TAB_MAP as pt, setByPath as q, ApiKeyRecordSchema as r, BaseAddon as rt, RUNTIME_DEFAULTS as s, DeviceFeature as st, ALL_CAPABILITY_DEFINITIONS as t, validateExpressionSource as tt, StorageLocationTypeSchema as u, EventCategory as ut, backupCapability as v, emitDownForOwnedCaps as vt, enumerateSchemaFields as w, parseJsonUnknown as wt, deviceStateCapability as x, hydrateSchema as xt, buildStreamParamsConfigSchema as y, emitReadiness as yt, nodePin as z };
+export { toExpressionValue as $, isCollectionArrayMethod as A, normalizeUnit as B, enumerateItemArrayFields as C, parseJsonUnknown as Ct, filesystemBrowseCapability as D, sleep as Dt, extractNestedAddonId as E, scopeKey as Et, localNetworkCapability as F, readNodePin as G, parseStreamParamsFormPatch as H, logDestinationCapability as I, settingsStoreCapability as J, scoreRuntimes as K, looseSchema as L, isVoidInput as M, kebabToCamel as N, getByPath as O, EventCategory as Ot, lifecycleJobSchema as P, streamQualityLabel as Q, metricsProviderCapability as R, deviceStatusCapability as S, parseJsonObject as St, evaluateLinkExpression as T, resolveCapMount as Tt, platformProbeCapability as U, objectInputDeclaresAddonId as V, procedureAuthKey as W, storageCapability as X, snapshotCapability as Y, storageProviderCapability as Z, authProviderCapability as _, emitDownForOwnedCaps as _t, DeviceStatusSchema as a, DEVICE_SETTINGS_CONTRIBUTION_METHODS as at, deviceManagerCapability as b, hydrateSchema as bt, STREAM_PROFILE_META as c, DeviceRole as ct, UserRecordSchema as d, ReadinessTimeoutError as dt, userManagementCapability as et, addonPagesCapability as f, WELL_KNOWN_TAB_MAP as ft, applyTransform as g, createEvent as gt, alertsCapability as h, asString as ht, CAP_NAMES_WITH_STATUS as i, DATAPLANE_SECRET_HEADER as it, isObjectInput as j, isArrayOutputSchema as k, ScopedTokenSchema as l, DeviceType as lt, addonWidgetsCapability as m, asNumber as mt, AlertSchema as n, errMsg as nt, METHOD_ACCESS_MAP as o, DEVICE_STATUS_METHOD as ot, addonSettingsCapability as p, asJsonObject as pt, setByPath as q, ApiKeyRecordSchema as r, BaseAddon as rt, RUNTIME_DEFAULTS as s, DeviceFeature as st, ALL_CAPABILITY_DEFINITIONS as t, validateExpressionSource as tt, StorageLocationTypeSchema as u, ReadinessRegistry as ut, backupCapability as v, emitReadiness as vt, enumerateSchemaFields as w, readinessKey as wt, deviceStateCapability as x, isDeviceConfigCap as xt, buildStreamParamsConfigSchema as y, expandCapMethods as yt, nodePin as z };

package/dist/{dist-CQYo6Zp8.js → dist-C3uHEBtP.js}

@@ -1,5 +1,5 @@
 let zod = require("zod");
-//#region ../types/dist/sleep-_sv7WKkq.mjs
+//#region ../types/dist/event-category-CFZs3jI4.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -17952,7 +17952,15 @@ var webrtcSessionCapability = {
 			*/
 			disableIpv6: zod.z.boolean().optional(),
 			/** Subscriber attribution. See `createSession` for the contract. */
-			consumerAttribution: BrokerConsumerAttributionSchema.optional()
+			consumerAttribution: BrokerConsumerAttributionSchema.optional(),
+			/**
+			* Client-side stream hints (viewport, downlink) — same contract as
+			* `createSession.hints`. Client-offer viewers (the RN viewer's
+			* `WebrtcLiveSession`) negotiate via `handleOffer`, so without this
+			* field their hints were silently stripped by the schema and the
+			* adaptive ladder started blind on the client's display size.
+			*/
+			hints: webrtcClientHintsSchema.optional()
 		}), zod.z.object({
 			sessionId: zod.z.string(),
 			sdpAnswer: zod.z.string()

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { proxyToUpstream } from './http/reverse-proxy.js';
 export type { ReverseProxyOptions } from './http/reverse-proxy.js';
 export { createFileDataPlaneHandler } from './http/file-data-plane.js';
 export type { FileDataPlaneOptions } from './http/file-data-plane.js';
+export { createAddonDataPlaneFacility } from './kernel/moleculer/addon-data-plane-facility.js';
+export type { AddonDataPlaneFacility, DataPlaneSink, } from './kernel/moleculer/addon-data-plane-facility.js';
 export { downloadModel, downloadFile, fetchJson, ensureModel, getModelFilePath, isModelDownloaded, deleteModelFromDisk, collectModelFiles, } from './download/model-downloader.js';
 export type { DownloadProgressCallback } from './download/model-downloader.js';
 export { ModelDownloadService } from './download/model-download-service.js';

package/dist/index.js

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("./chunk-Cek0wNdY.js");
-const require_dist = require("./dist-CQYo6Zp8.js");
+const require_dist = require("./dist-C3uHEBtP.js");
 const require_model_download_service = require("./model-download-service-D-Umz4-L.js");
+const require_manifest_python_deps = require("./manifest-python-deps-CVcJ9hDX.js");
 const require_resource_monitor = require("./resource-monitor-DNNomR-i.js");
 const require_builtins_sqlite_storage_filesystem_storage_addon = require("./builtins/sqlite-storage/filesystem-storage.addon.js");
 const require_builtins_sqlite_storage_sqlite_settings_addon = require("./builtins/sqlite-storage/sqlite-settings.addon.js");
@@ -21,7 +22,6 @@ const require_builtins_local_auth_local_auth_addon = require("./builtins/local-a
 require("./builtins/local-auth/index.js");
 const require_builtins_device_manager_device_manager_addon = require("./builtins/device-manager/device-manager.addon.js");
 require("./builtins/device-manager/index.js");
-const require_manifest_python_deps = require("./manifest-python-deps-Wy8dNJpr.js");
 const require_custom_action_registry = require("./custom-action-registry-vLYEFTtv.js");
 let _camstack_types_node = require("@camstack/types/node");
 let zod = require("zod");
@@ -32,6 +32,7 @@ node_fs = require_chunk.__toESM(node_fs);
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path, 1);
 let node_crypto = require("node:crypto");
+let _camstack_types_addon = require("@camstack/types/addon");
 let node_child_process = require("node:child_process");
 let node_util = require("node:util");
 node_util = require_chunk.__toESM(node_util);
@@ -40,7 +41,6 @@ node_vm = require_chunk.__toESM(node_vm);
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs_promises = require("node:fs/promises");
-let _camstack_types_addon = require("@camstack/types/addon");
 let node_events = require("node:events");
 let node_stream = require("node:stream");
 node_stream = require_chunk.__toESM(node_stream, 1);
@@ -3064,6 +3064,24 @@ var AddonInstaller = class AddonInstaller {
 		else this.installSource = "npm";
 	}
 	/**
+	* Where a bootstrapped npm lives when the host has none on PATH (packaged
+	* Electron agents ship a bare node binary). Persistent — sibling of the
+	* installed addons, survives restarts, downloaded at most once per host.
+	*/
+	get npmCacheDir() {
+		return node_path.join(this.addonsDir, ".npm-bootstrap");
+	}
+	/** Shared options for every npm invocation this installer performs. */
+	npmRunOptions(cwd, timeout) {
+		return {
+			cacheDir: this.npmCacheDir,
+			registry: this.registry,
+			logger: this.logger,
+			cwd,
+			timeout
+		};
+	}
+	/**
 	* Derive the bootstrap addon list from a meta-package's runtime dependencies.
 	* Single source of truth: the meta-package's `package.json` declares which
 	* `@camstack/addon-*` packages the deployment needs. Replaces previously
@@ -3247,17 +3265,16 @@ var AddonInstaller = class AddonInstaller {
 		});
 		const strippedDeps = stripBundledDeps(pkgData);
 		if (strippedDeps["dependencies"] && typeof strippedDeps["dependencies"] === "object" && Object.keys(strippedDeps["dependencies"]).length > 0) try {
-			await execFileAsync("npm", [
+			await require_manifest_python_deps.runNpm([
 				"install",
 				"--omit=dev",
 				"--ignore-scripts=false"
-			], {
-				cwd: targetDir,
-				timeout: 12e4
-			});
-		} catch {}
+			], this.npmRunOptions(targetDir, 12e4));
+		} catch (err) {
+			this.logger.warn(`${packageName} — npm install failed (continuing)`, { meta: { error: require_dist.errMsg(err) } });
+		}
 		try {
-			await require_manifest_python_deps.installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry);
+			await require_manifest_python_deps.installManifestNativeDeps(targetDir, pkgData, this.logger, this.registry, this.npmCacheDir);
 		} catch (err) {
 			this.logger.warn(`${packageName} — native deps install failed (continuing)`, { meta: { error: require_dist.errMsg(err) } });
 		}
@@ -3288,7 +3305,7 @@ var AddonInstaller = class AddonInstaller {
 					tmpDir
 				];
 				if (this.registry) args.push("--registry", this.registry);
-				const { stdout } = await execFileAsync("npm", args, { timeout: 12e4 });
+				const { stdout } = await require_manifest_python_deps.runNpm(args, this.npmRunOptions(tmpDir, 12e4));
 				const tgzFiles = node_fs.readdirSync(tmpDir).filter((f) => f.endsWith(".tgz"));
 				if (tgzFiles.length === 0) throw new Error(`npm pack produced no tgz. stdout: ${stdout.trim()}`);
 				return node_path.join(tmpDir, tgzFiles[0]);
@@ -3429,7 +3446,7 @@ var AddonInstaller = class AddonInstaller {
 			if (strippedRuntimeDeps != null && typeof strippedRuntimeDeps === "object" && Object.keys(strippedRuntimeDeps).length > 0) {
 				this.logger.info(`${pkgView.name} — installing runtime dependencies`, { meta: { stagingDir: pkgDir } });
 				try {
-					await execFileAsync("npm", [
+					await require_manifest_python_deps.runNpm([
 						"install",
 						"--omit=dev",
 						"--omit=peer",
@@ -3437,16 +3454,13 @@ var AddonInstaller = class AddonInstaller {
 						"--no-fund",
 						"--no-package-lock",
 						...this.registry ? ["--registry", this.registry] : []
-					], {
-						cwd: pkgDir,
-						timeout: 24e4
-					});
+					], this.npmRunOptions(pkgDir, 24e4));
 				} catch (err) {
-					this.logger.warn(`${pkgView.name} — npm install failed (continuing)`, { meta: { error: err instanceof Error ? err.message : String(err) } });
+					throw new Error(`${pkgView.name} — runtime dependency install failed: ${require_dist.errMsg(err)}`, { cause: err });
 				}
 			}
 			try {
-				await require_manifest_python_deps.installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry);
+				await require_manifest_python_deps.installManifestNativeDeps(pkgDir, pkgView.raw, this.logger, this.registry, this.npmCacheDir);
 			} catch (nativeErr) {
 				throw new Error(`${pkgView.name} — native deps install failed: ${require_dist.errMsg(nativeErr)}`, { cause: nativeErr });
 			}
@@ -3748,10 +3762,7 @@ var AddonInstaller = class AddonInstaller {
 		if (!(!node_fs.existsSync(distDir) || this.isDistIncomplete(pkgData, sourceDir))) return;
 		this.logger.info(`${packageName} — building (dist/ missing or incomplete)`);
 		try {
-			await execFileAsync("npm", ["run", "build"], {
-				cwd: sourceDir,
-				timeout: 18e4
-			});
+			await require_manifest_python_deps.runNpm(["run", "build"], this.npmRunOptions(sourceDir, 18e4));
 		} catch (err) {
 			const msg = require_dist.errMsg(err);
 			this.logger.warn(`${packageName} auto-build failed`, { meta: { error: msg } });
@@ -93515,6 +93526,7 @@ exports.contentTypeFor = require_model_download_service.contentTypeFor;
 exports.copyDirRecursive = copyDirRecursive;
 exports.copyExtraFileDirs = copyExtraFileDirs;
 exports.createAddonContext = require_manifest_python_deps.createAddonContext;
+exports.createAddonDataPlaneFacility = require_manifest_python_deps.createAddonDataPlaneFacility;
 exports.createAddonService = require_manifest_python_deps.createAddonService;
 exports.createAuthenticatedFileServer = require_model_download_service.createAuthenticatedFileServer;
 exports.createBroker = createBroker;