@camstack/types 1.1.35 → 1.1.36

package/dist/interfaces/event-bus.d.ts

@@ -345,6 +345,17 @@ export interface TopologyNode {
     }>;
     readonly processes: readonly TopologyProcess[];
     readonly categories: readonly TopologyCategory[];
+    /**
+     * The node's runtime-updatable ROOT package (`@camstack/server` /
+     * `@camstack/agent`) from its `registerNode` manifest — version
+     * visibility for the Server management surface. Null for offline rows
+     * and nodes that never reported one. Mirrors `TopologyRootPackageSchema`
+     * in `nodes.cap.ts`.
+     */
+    readonly rootPackage: {
+        readonly name: string;
+        readonly version: string;
+    } | null;
 }
 /** All known event categories with their typed payloads */
 export interface EventCatalog {

package/dist/{sleep-DuN1nc6O.js → sleep-BtS3xMHv.js}

@@ -739,6 +739,68 @@ function isValuelessField(field) {
 	return field.type === "separator" || field.type === "info" || field.type === "qr-code" || field.type === "button" || field.type === "object-array" || field.type === "widget" || field.type === "addon-action-button" || field.type === "device-action-button";
 }
 /**
+* Base collector: flatten a hydrated `ConfigUISchemaWithValues` into
+* `key → { value, default }`, recursing through `group` and `sub-tabs`
+* layout fields. Keeping `value` and `default` SEPARATE (rather than
+* pre-resolving) lets callers both read the effective value AND detect
+* overrides (`value` differs from `default`). Structural over `unknown`;
+* malformed input yields an empty map, never throws.
+*/
+function collectHydratedFieldEntries(schema) {
+	const out = /* @__PURE__ */ new Map();
+	if (typeof schema !== "object" || schema === null) return out;
+	const sections = schema.sections;
+	if (!Array.isArray(sections)) return out;
+	for (const section of sections) if (typeof section === "object" && section !== null) collectFieldEntriesInto(section.fields, out);
+	return out;
+}
+/** Recursive field walker for {@link collectHydratedFieldEntries}. */
+function collectFieldEntriesInto(fields, into) {
+	if (!Array.isArray(fields)) return;
+	for (const field of fields) {
+		if (typeof field !== "object" || field === null) continue;
+		const type = field.type;
+		if (type === "group") {
+			collectFieldEntriesInto(field.fields, into);
+			continue;
+		}
+		if (type === "sub-tabs") {
+			const tabs = field.tabs;
+			if (Array.isArray(tabs)) {
+				for (const tab of tabs) if (typeof tab === "object" && tab !== null) collectFieldEntriesInto(tab.fields, into);
+			}
+			continue;
+		}
+		const key = field.key;
+		if (typeof key !== "string" || key.length === 0) continue;
+		if (!("value" in field)) continue;
+		into.set(key, {
+			value: field.value,
+			default: field.default
+		});
+	}
+}
+/**
+* Flatten a hydrated settings payload into `key → EFFECTIVE value`
+* (`value ?? default`). The read-side inverse of `hydrateSchema` for the
+* common "just give me the resolved values" case. Built on
+* {@link collectHydratedFieldEntries}.
+*/
+function collectHydratedFieldValues(schema) {
+	const out = /* @__PURE__ */ new Map();
+	for (const [key, entry] of collectHydratedFieldEntries(schema)) out.set(key, entry.value ?? entry.default);
+	return out;
+}
+/**
+* Read one field's effective value out of a hydrated settings payload —
+* convenience wrapper over {@link collectHydratedFieldValues} for the
+* single-field case. Returns `undefined` when the field is absent.
+*/
+function resolveHydratedFieldValue(schema, key) {
+	const entry = collectHydratedFieldEntries(schema).get(key);
+	return entry === void 0 ? void 0 : entry.value ?? entry.default;
+}
+/**
 * Merge a `ConfigUISchema` with a raw `values` record into a
 * `ConfigUISchemaWithValues`. Used by every `get*Settings` backend endpoint
 * before returning to the admin UI. Groups are walked recursively.
@@ -795,10 +857,6 @@ function hydrateField(field, values) {
 		};
 	}
 	const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
-	if (field.type === "password") return {
-		...field,
-		value: ""
-	};
 	const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
 	return {
 		...field,
@@ -3589,13 +3647,34 @@ function createDeviceProxy(api, binding, opts) {
 }
 //#endregion
 //#region src/capabilities/admin-ui.cap.ts
-var StaticDirOutputSchema = zod.z.object({ staticDir: zod.z.string() });
-var VersionOutputSchema = zod.z.object({ version: zod.z.string() });
+var StaticDirOutputSchema$1 = zod.z.object({ staticDir: zod.z.string() });
+var VersionOutputSchema$1 = zod.z.object({ version: zod.z.string() });
 var adminUiCapability = {
 	name: "admin-ui",
 	scope: "system",
 	mode: "singleton",
 	internal: true,
+	methods: {
+		getStaticDir: method(zod.z.void(), StaticDirOutputSchema$1),
+		getVersion: method(zod.z.void(), VersionOutputSchema$1)
+	}
+};
+//#endregion
+//#region src/capabilities/viewer-ui.cap.ts
+var StaticDirOutputSchema = zod.z.object({ staticDir: zod.z.string() });
+var VersionOutputSchema = zod.z.object({ version: zod.z.string() });
+/**
+* viewer-ui — serves the CamStack VIEWER web build (the Expo/React-Native
+* universal client's PWA export) from the hub, alongside admin-ui. Mirrors
+* `admin-ui` exactly: a singleton, server-internal cap exposing the static
+* dist directory + build version so `main.ts` can mount the SPA under a
+* dedicated prefix.
+*/
+var viewerUiCapability = {
+	name: "viewer-ui",
+	scope: "system",
+	mode: "singleton",
+	internal: true,
 	methods: {
 		getStaticDir: method(zod.z.void(), StaticDirOutputSchema),
 		getVersion: method(zod.z.void(), VersionOutputSchema)
@@ -4025,6 +4104,18 @@ Object.defineProperty(exports, "asString", {
 		return asString;
 	}
 });
+Object.defineProperty(exports, "collectHydratedFieldEntries", {
+	enumerable: true,
+	get: function() {
+		return collectHydratedFieldEntries;
+	}
+});
+Object.defineProperty(exports, "collectHydratedFieldValues", {
+	enumerable: true,
+	get: function() {
+		return collectHydratedFieldValues;
+	}
+});
 Object.defineProperty(exports, "createDeviceProxy", {
 	enumerable: true,
 	get: function() {
@@ -4169,6 +4260,12 @@ Object.defineProperty(exports, "resolveCapMount", {
 		return resolveCapMount;
 	}
 });
+Object.defineProperty(exports, "resolveHydratedFieldValue", {
+	enumerable: true,
+	get: function() {
+		return resolveHydratedFieldValue;
+	}
+});
 Object.defineProperty(exports, "scopeKey", {
 	enumerable: true,
 	get: function() {
@@ -4193,3 +4290,9 @@ Object.defineProperty(exports, "sleepCancellable", {
 		return sleepCancellable;
 	}
 });
+Object.defineProperty(exports, "viewerUiCapability", {
+	enumerable: true,
+	get: function() {
+		return viewerUiCapability;
+	}
+});

package/dist/{sleep-DiQ8xW1M.mjs → sleep-DJaTV2D7.mjs}

@@ -739,6 +739,68 @@ function isValuelessField(field) {
 	return field.type === "separator" || field.type === "info" || field.type === "qr-code" || field.type === "button" || field.type === "object-array" || field.type === "widget" || field.type === "addon-action-button" || field.type === "device-action-button";
 }
 /**
+* Base collector: flatten a hydrated `ConfigUISchemaWithValues` into
+* `key → { value, default }`, recursing through `group` and `sub-tabs`
+* layout fields. Keeping `value` and `default` SEPARATE (rather than
+* pre-resolving) lets callers both read the effective value AND detect
+* overrides (`value` differs from `default`). Structural over `unknown`;
+* malformed input yields an empty map, never throws.
+*/
+function collectHydratedFieldEntries(schema) {
+	const out = /* @__PURE__ */ new Map();
+	if (typeof schema !== "object" || schema === null) return out;
+	const sections = schema.sections;
+	if (!Array.isArray(sections)) return out;
+	for (const section of sections) if (typeof section === "object" && section !== null) collectFieldEntriesInto(section.fields, out);
+	return out;
+}
+/** Recursive field walker for {@link collectHydratedFieldEntries}. */
+function collectFieldEntriesInto(fields, into) {
+	if (!Array.isArray(fields)) return;
+	for (const field of fields) {
+		if (typeof field !== "object" || field === null) continue;
+		const type = field.type;
+		if (type === "group") {
+			collectFieldEntriesInto(field.fields, into);
+			continue;
+		}
+		if (type === "sub-tabs") {
+			const tabs = field.tabs;
+			if (Array.isArray(tabs)) {
+				for (const tab of tabs) if (typeof tab === "object" && tab !== null) collectFieldEntriesInto(tab.fields, into);
+			}
+			continue;
+		}
+		const key = field.key;
+		if (typeof key !== "string" || key.length === 0) continue;
+		if (!("value" in field)) continue;
+		into.set(key, {
+			value: field.value,
+			default: field.default
+		});
+	}
+}
+/**
+* Flatten a hydrated settings payload into `key → EFFECTIVE value`
+* (`value ?? default`). The read-side inverse of `hydrateSchema` for the
+* common "just give me the resolved values" case. Built on
+* {@link collectHydratedFieldEntries}.
+*/
+function collectHydratedFieldValues(schema) {
+	const out = /* @__PURE__ */ new Map();
+	for (const [key, entry] of collectHydratedFieldEntries(schema)) out.set(key, entry.value ?? entry.default);
+	return out;
+}
+/**
+* Read one field's effective value out of a hydrated settings payload —
+* convenience wrapper over {@link collectHydratedFieldValues} for the
+* single-field case. Returns `undefined` when the field is absent.
+*/
+function resolveHydratedFieldValue(schema, key) {
+	const entry = collectHydratedFieldEntries(schema).get(key);
+	return entry === void 0 ? void 0 : entry.value ?? entry.default;
+}
+/**
 * Merge a `ConfigUISchema` with a raw `values` record into a
 * `ConfigUISchemaWithValues`. Used by every `get*Settings` backend endpoint
 * before returning to the admin UI. Groups are walked recursively.
@@ -795,10 +857,6 @@ function hydrateField(field, values) {
 		};
 	}
 	const rawValue = storedValue !== void 0 ? storedValue : defaultValue !== void 0 ? defaultValue : null;
-	if (field.type === "password") return {
-		...field,
-		value: ""
-	};
 	const value = field.type === "textarea" && field.isJson && rawValue !== null && typeof rawValue === "object" ? JSON.stringify(rawValue, null, 2) : rawValue;
 	return {
 		...field,
@@ -3589,13 +3647,34 @@ function createDeviceProxy(api, binding, opts) {
 }
 //#endregion
 //#region src/capabilities/admin-ui.cap.ts
-var StaticDirOutputSchema = z.object({ staticDir: z.string() });
-var VersionOutputSchema = z.object({ version: z.string() });
+var StaticDirOutputSchema$1 = z.object({ staticDir: z.string() });
+var VersionOutputSchema$1 = z.object({ version: z.string() });
 var adminUiCapability = {
 	name: "admin-ui",
 	scope: "system",
 	mode: "singleton",
 	internal: true,
+	methods: {
+		getStaticDir: method(z.void(), StaticDirOutputSchema$1),
+		getVersion: method(z.void(), VersionOutputSchema$1)
+	}
+};
+//#endregion
+//#region src/capabilities/viewer-ui.cap.ts
+var StaticDirOutputSchema = z.object({ staticDir: z.string() });
+var VersionOutputSchema = z.object({ version: z.string() });
+/**
+* viewer-ui — serves the CamStack VIEWER web build (the Expo/React-Native
+* universal client's PWA export) from the hub, alongside admin-ui. Mirrors
+* `admin-ui` exactly: a singleton, server-internal cap exposing the static
+* dist directory + build version so `main.ts` can mount the SPA under a
+* dedicated prefix.
+*/
+var viewerUiCapability = {
+	name: "viewer-ui",
+	scope: "system",
+	mode: "singleton",
+	internal: true,
 	methods: {
 		getStaticDir: method(z.void(), StaticDirOutputSchema),
 		getVersion: method(z.void(), VersionOutputSchema)
@@ -3773,4 +3852,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { SubscribeAudioChunksResultSchema as $, ReadinessRegistry as A, CamStreamResolutionSchema as B, asJsonObject as C, parseJsonObject as D, parseJsonArray as E, BrokerStatsSchema as F, FrameHandleFormatSchema as G, DecodedAudioChunkSchema as H, BrokerStatusSchema as I, ProfileSlotSchema as J, FrameHandleSchema as K, CAM_PROFILE_ORDER as L, emitDownForOwnedCaps as M, readinessKey as N, parseJsonUnknown as O, scopeKey as P, SubscribeAudioChunksInputSchema as Q, CamProfileSchema as R, asJsonArray as S, asString as T, DecodedFrameSchema as U, CameraStreamSchema as V, EncodedPacketSchema as W, StreamSourceEntrySchema$1 as X, ProfileSlotStatusSchema as Y, StreamSourceSchema as Z, ChargingStatus as _, adminUiCapability as a, selectAssignedProfileSlots as at, DeviceType as b, createMirrorSource as c, createDurableState as ct, DEVICE_STATUS_METHOD as d, isEvent as dt, SubscribeFramesInputSchema as et, event as f, WELL_KNOWN_TABS as ft, resolveCapMount as g, DisposerChain as gt, method as h, EventCategory as ht, deviceOpsCapability as i, parseProfileBrokerId as it, ReadinessTimeoutError as j, DATAPLANE_SECRET_HEADER as k, createSliceHandle as l, createEvent as lt, isDeviceConfigCap as m, hydrateSchema as mt, sleepCancellable as n, makeProfileBrokerId as nt, createDeviceProxy as o, BaseAddon as ot, expandCapMethods as p, WELL_KNOWN_TAB_MAP as pt, ProfileRtspEntrySchema as q, RawStateResultSchema as r, makeSourceBrokerId as rt, createLazyTrpcSource as s, normalizeAddonInitResult as st, sleep as t, SubscribeFramesResultSchema as tt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as u, emitReadiness as ut, DeviceFeature as v, asNumber as w, asBoolean as x, DeviceRole as y, CamStreamKindSchema as z };
+export { SubscribeAudioChunksInputSchema as $, DATAPLANE_SECRET_HEADER as A, CamStreamKindSchema as B, asJsonArray as C, parseJsonArray as D, asString as E, scopeKey as F, EncodedPacketSchema as G, CameraStreamSchema as H, BrokerStatsSchema as I, ProfileRtspEntrySchema as J, FrameHandleFormatSchema as K, BrokerStatusSchema as L, ReadinessTimeoutError as M, emitDownForOwnedCaps as N, parseJsonObject as O, readinessKey as P, StreamSourceSchema as Q, CAM_PROFILE_ORDER as R, asBoolean as S, asNumber as T, DecodedAudioChunkSchema as U, CamStreamResolutionSchema as V, DecodedFrameSchema as W, ProfileSlotStatusSchema as X, ProfileSlotSchema as Y, StreamSourceEntrySchema$1 as Z, resolveCapMount as _, hydrateSchema as _t, viewerUiCapability as a, parseProfileBrokerId as at, DeviceRole as b, DisposerChain as bt, createLazyTrpcSource as c, normalizeAddonInitResult as ct, DEVICE_SETTINGS_CONTRIBUTION_METHODS as d, emitReadiness as dt, SubscribeAudioChunksResultSchema as et, DEVICE_STATUS_METHOD as f, isEvent as ft, method as g, collectHydratedFieldValues as gt, isDeviceConfigCap as h, collectHydratedFieldEntries as ht, deviceOpsCapability as i, makeSourceBrokerId as it, ReadinessRegistry as j, parseJsonUnknown as k, createMirrorSource as l, createDurableState as lt, expandCapMethods as m, WELL_KNOWN_TAB_MAP as mt, sleepCancellable as n, SubscribeFramesResultSchema as nt, adminUiCapability as o, selectAssignedProfileSlots as ot, event as p, WELL_KNOWN_TABS as pt, FrameHandleSchema as q, RawStateResultSchema as r, makeProfileBrokerId as rt, createDeviceProxy as s, BaseAddon as st, sleep as t, SubscribeFramesInputSchema as tt, createSliceHandle as u, createEvent as ut, ChargingStatus as v, resolveHydratedFieldValue as vt, asJsonObject as w, DeviceType as x, DeviceFeature as y, EventCategory as yt, CamProfileSchema as z };

package/package.json

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