@camstack/system 1.2.291 → 1.2.292

package/dist/{dist-XnunBp0n.js → dist-D3zw1yHp.js}

@@ -41083,6 +41083,95 @@ function resolveContainerPrimaryChild(children, overrideEntityId, containerName)
 	const namesake = (c) => containerName !== void 0 && containerName.length > 0 && c.name !== void 0 && sameName(c.name, containerName) ? 0 : 1;
 	return [...children].toSorted((a, b) => roleRank(a.role) - roleRank(b.role) || namesake(a) - namesake(b) || rank(a.type) - rank(b.type))[0] ?? null;
 }
+/**
+* Which devices a camera's LINKED set resolves to — the pure rules, with no
+* store and no provider context.
+*
+* They live in `@camstack/types` rather than in the device-manager builtin
+* because two surfaces need the SAME answer and a second copy would be a
+* second definition of what a room contains: the hub's boot backfill, and the
+* admin UI's per-room rebuild. Moving them here also keeps that button a
+* framework-free change — a new cap method would only reach a node through a
+* published `@camstack/server` and a restart (D16), which is not what a
+* convenience button is worth.
+*/
+/**
+* Resolve one candidate id to the ids it should actually contribute to a
+* linked set: itself, unless it is a CONTAINER, in which case its own
+* children (recursively expanded the same way — a container-of-containers
+* is vanishingly unlikely per `DeviceType.Container`'s contract, but this
+* costs nothing to handle). `visited` guards a pathological parent-cycle in
+* persisted data from recursing forever; a candidate already on the current
+* expansion path is dropped rather than re-expanded.
+*
+* This is the STRUCTURAL, location-independent way a container's child
+* becomes reachable: the device-tree "children of the camera" rule and a
+* persisted manual pick are parentDeviceId chains, never location-based —
+* a container named there is excluded by expanding into whatever it
+* actually contains, regardless of what its (or its children's) `location`
+* column holds.
+*/
+function expandContainer(id, byId, byParent, visited, out) {
+	if (visited.has(id)) return;
+	const candidate = byId.get(id);
+	if (!candidate) return;
+	if (candidate.type !== DeviceType.Container) {
+		out.add(id);
+		return;
+	}
+	const nextVisited = new Set(visited);
+	nextVisited.add(id);
+	const primary = resolveContainerPrimaryChild((byParent.get(id) ?? []).map((c) => ({
+		id: c.id,
+		stableId: c.stableId,
+		type: c.type,
+		...c.role !== void 0 && c.role !== null ? { role: c.role } : {},
+		...c.name !== void 0 ? { name: c.name } : {}
+	})), byId.get(id)?.primaryChildEntityId, byId.get(id)?.name);
+	if (primary !== null) expandContainer(primary.id, byId, byParent, nextVisited, out);
+}
+/**
+* What the retired `auto` mode (pre-D356) added beyond the device-tree
+* children: every non-container candidate sharing the camera's location, a
+* container child standing in for its container's PRIMARY child.
+*
+* Two callers, both WRITERS, never the read path: the one-shot boot backfill
+* that materialises it into the manual list
+* (`linked-devices-manual-backfill.ts`), and the admin UI's per-room rebuild.
+* Both ask "what does this room contain", and a second copy of the answer is
+* how two surfaces start disagreeing about a room.
+*
+* A camera with NO location answers `[]`. A caller that would WRITE that must
+* refuse instead: emptying a list because nobody set the room is the silent
+* drop D391 names.
+*/
+function legacyAutoLinkIds(params) {
+	const { selfId, selfLocation, candidates } = params;
+	if (selfLocation === null || selfLocation.length === 0) return [];
+	const byId = new Map(candidates.map((c) => [c.id, c]));
+	const byParent = /* @__PURE__ */ new Map();
+	for (const c of candidates) {
+		if (c.parentDeviceId === null) continue;
+		const siblings = byParent.get(c.parentDeviceId);
+		if (siblings) siblings.push(c);
+		else byParent.set(c.parentDeviceId, [c]);
+	}
+	const ids = /* @__PURE__ */ new Set();
+	const expand = (id) => expandContainer(id, byId, byParent, /* @__PURE__ */ new Set(), ids);
+	for (const c of candidates) {
+		if (c.type === DeviceType.Container) continue;
+		if (c.location !== selfLocation) continue;
+		if (c.parentDeviceId === selfId) continue;
+		const parent = c.parentDeviceId !== null ? byId.get(c.parentDeviceId) : void 0;
+		if (parent !== void 0 && parent.type === DeviceType.Container) {
+			expand(parent.id);
+			continue;
+		}
+		ids.add(c.id);
+	}
+	ids.delete(selfId);
+	return [...ids];
+}
 /** Marker written to a declared integration's `info`. */
 var DECLARED_INTEGRATION_FIXED_KEY = "fixed";
 /**
@@ -53488,6 +53577,12 @@ Object.defineProperty(exports, "expandCapMethods", {
 		return expandCapMethods;
 	}
 });
+Object.defineProperty(exports, "expandContainer", {
+	enumerable: true,
+	get: function() {
+		return expandContainer;
+	}
+});
 Object.defineProperty(exports, "extractNestedAddonId", {
 	enumerable: true,
 	get: function() {
@@ -53584,6 +53679,12 @@ Object.defineProperty(exports, "kebabToCamel", {
 		return kebabToCamel;
 	}
 });
+Object.defineProperty(exports, "legacyAutoLinkIds", {
+	enumerable: true,
+	get: function() {
+		return legacyAutoLinkIds;
+	}
+});
 Object.defineProperty(exports, "legacyModeOf", {
 	enumerable: true,
 	get: function() {
@@ -53740,12 +53841,6 @@ Object.defineProperty(exports, "resolveCapMount", {
 		return resolveCapMount;
 	}
 });
-Object.defineProperty(exports, "resolveContainerPrimaryChild", {
-	enumerable: true,
-	get: function() {
-		return resolveContainerPrimaryChild;
-	}
-});
 Object.defineProperty(exports, "resolveLocationMode", {
 	enumerable: true,
 	get: function() {

package/dist/{dist-DiMNxNDh.mjs → dist-DU72-y3J.mjs}

@@ -41083,6 +41083,95 @@ function resolveContainerPrimaryChild(children, overrideEntityId, containerName)
 	const namesake = (c) => containerName !== void 0 && containerName.length > 0 && c.name !== void 0 && sameName(c.name, containerName) ? 0 : 1;
 	return [...children].toSorted((a, b) => roleRank(a.role) - roleRank(b.role) || namesake(a) - namesake(b) || rank(a.type) - rank(b.type))[0] ?? null;
 }
+/**
+* Which devices a camera's LINKED set resolves to — the pure rules, with no
+* store and no provider context.
+*
+* They live in `@camstack/types` rather than in the device-manager builtin
+* because two surfaces need the SAME answer and a second copy would be a
+* second definition of what a room contains: the hub's boot backfill, and the
+* admin UI's per-room rebuild. Moving them here also keeps that button a
+* framework-free change — a new cap method would only reach a node through a
+* published `@camstack/server` and a restart (D16), which is not what a
+* convenience button is worth.
+*/
+/**
+* Resolve one candidate id to the ids it should actually contribute to a
+* linked set: itself, unless it is a CONTAINER, in which case its own
+* children (recursively expanded the same way — a container-of-containers
+* is vanishingly unlikely per `DeviceType.Container`'s contract, but this
+* costs nothing to handle). `visited` guards a pathological parent-cycle in
+* persisted data from recursing forever; a candidate already on the current
+* expansion path is dropped rather than re-expanded.
+*
+* This is the STRUCTURAL, location-independent way a container's child
+* becomes reachable: the device-tree "children of the camera" rule and a
+* persisted manual pick are parentDeviceId chains, never location-based —
+* a container named there is excluded by expanding into whatever it
+* actually contains, regardless of what its (or its children's) `location`
+* column holds.
+*/
+function expandContainer(id, byId, byParent, visited, out) {
+	if (visited.has(id)) return;
+	const candidate = byId.get(id);
+	if (!candidate) return;
+	if (candidate.type !== DeviceType.Container) {
+		out.add(id);
+		return;
+	}
+	const nextVisited = new Set(visited);
+	nextVisited.add(id);
+	const primary = resolveContainerPrimaryChild((byParent.get(id) ?? []).map((c) => ({
+		id: c.id,
+		stableId: c.stableId,
+		type: c.type,
+		...c.role !== void 0 && c.role !== null ? { role: c.role } : {},
+		...c.name !== void 0 ? { name: c.name } : {}
+	})), byId.get(id)?.primaryChildEntityId, byId.get(id)?.name);
+	if (primary !== null) expandContainer(primary.id, byId, byParent, nextVisited, out);
+}
+/**
+* What the retired `auto` mode (pre-D356) added beyond the device-tree
+* children: every non-container candidate sharing the camera's location, a
+* container child standing in for its container's PRIMARY child.
+*
+* Two callers, both WRITERS, never the read path: the one-shot boot backfill
+* that materialises it into the manual list
+* (`linked-devices-manual-backfill.ts`), and the admin UI's per-room rebuild.
+* Both ask "what does this room contain", and a second copy of the answer is
+* how two surfaces start disagreeing about a room.
+*
+* A camera with NO location answers `[]`. A caller that would WRITE that must
+* refuse instead: emptying a list because nobody set the room is the silent
+* drop D391 names.
+*/
+function legacyAutoLinkIds(params) {
+	const { selfId, selfLocation, candidates } = params;
+	if (selfLocation === null || selfLocation.length === 0) return [];
+	const byId = new Map(candidates.map((c) => [c.id, c]));
+	const byParent = /* @__PURE__ */ new Map();
+	for (const c of candidates) {
+		if (c.parentDeviceId === null) continue;
+		const siblings = byParent.get(c.parentDeviceId);
+		if (siblings) siblings.push(c);
+		else byParent.set(c.parentDeviceId, [c]);
+	}
+	const ids = /* @__PURE__ */ new Set();
+	const expand = (id) => expandContainer(id, byId, byParent, /* @__PURE__ */ new Set(), ids);
+	for (const c of candidates) {
+		if (c.type === DeviceType.Container) continue;
+		if (c.location !== selfLocation) continue;
+		if (c.parentDeviceId === selfId) continue;
+		const parent = c.parentDeviceId !== null ? byId.get(c.parentDeviceId) : void 0;
+		if (parent !== void 0 && parent.type === DeviceType.Container) {
+			expand(parent.id);
+			continue;
+		}
+		ids.add(c.id);
+	}
+	ids.delete(selfId);
+	return [...ids];
+}
 /** Marker written to a declared integration's `info`. */
 var DECLARED_INTEGRATION_FIXED_KEY = "fixed";
 /**
@@ -52990,4 +53079,4 @@ function enumerateInferenceDevices(hw) {
 	return out;
 }
 //#endregion
-export { decodeVectorBase64 as $, snapshotCapability as $t, STREAM_PROFILE_META as A, isDeviceConfigCap as An, mayReadLocation as At, alertsCapability as B, procedureAuthKey as Bt, RECORDING_SOURCE_CAMSTACK_ADDON as C, asNumber as Cn, legacyModeOf as Ct, SOURCE_CAPS as D, emitReadiness as Dn, logDestinationCapability as Dt, RecordingStatusSchema as E, emitDownForOwnedCaps as En, locationIconKey as Et, StorageMigrationJobSchema as F, readinessKey as Fn, normalizeUnit as Ft, buildStreamParamsConfigSchema as G, resolveLocationMode as Gt, backupCapability as H, reducePoints as Ht, UserRecordSchema as I, resolveCapMount as In, objectInputDeclaresAddonId as It, coreBlockAddonId as J, scopesAllowAddon as Jt, cameraGridLayoutCapability as K, resolveMethodAuth as Kt, addonPagesCapability as L, scopeKey as Ln, objectInputDeclaresRequiredDeviceId as Lt, StorageCleanupJobSchema as M, nodePin as Mn, metricsProviderCapability as Mt, StorageLocationModeSchema as N, parseJsonObject as Nn, modeMayWrite as Nt, SOURCE_DEVICE_TYPES as O, expandCapMethods as On, logLevelAtMost as Ot, StorageLocationTypeSchema as P, parseJsonUnknown as Pn, motionCapability as Pt, declarationOwnerNodeId as Q, siteZoneKey as Qt, addonSettingsCapability as R, sleep as Rn, parseStreamParamsFormPatch as Rt, MOTION_CLOSE_AFTER_MS as S, asJsonObject as Sn, kebabToCamel as St, RUNTIME_DEFAULTS as T, createEvent as Tn, localNetworkCapability as Tt, bareAddonId as U, resolveBucketMs as Ut, authProviderCapability as V, ptzAutotrackCapability as Vt, batteryCapability as W, resolveContainerPrimaryChild as Wt, coreBlocksCapability as X, scoreRuntimes as Xt, coreBlockIdFromAddonId as Y, scopesAllowDeviceCap as Yt, dataStoreProviderCapability as Z, settingsStoreCapability as Zt, LOG_LEVEL_RANK as _, DeviceRole as _n, isLocationEnabled as _t, BatteryStatusSchema as a, streamQualityLabel as an, enumerateInferenceDevices as at, METHOD_ACCESS_MAP as b, ReadinessTimeoutError as bn, isSourceCap as bt, CORE_BLOCKS_ADDON_ID as c, vectorStoreCapability as cn, evaluateSensorEdge as ct, DAY_NAMES as d, buildFfmpegArgs as dn, filesystemBrowseCapability as dt, storageCapability as en, deriveBatteryPresence as et, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as f, BaseAddon as fn, foldSnapshotByFunction as ft, FIRST_LEVEL_MACRO_CLASSES as g, DeviceFeature as gn, isCollectionArrayMethod as gt, DeviceStatusSchema as h, DEVICE_STATUS_METHOD as hn, isArrayOutputSchema as ht, BaseDevice as i, streamCatalogCapability as in, doorbellCapability as it, ScopedTokenSchema as j, isEvent as jn, mayWriteToLocation as jt, STORAGE_ACCESS_FALLBACK as k, hydrateSchema as kn, looseSchema as kt, CORE_BLOCK_ADDON_PREFIX as l, withLocationMode as ln, evictionPolicyOfLocation as lt, DeclaredDevices as m, DEVICE_SETTINGS_CONTRIBUTION_METHODS as mn, gbToBytes as mt, AlertSchema as n, storageOccupancyCapability as nn, deviceStateCapability as nt, CAMERA_SWITCH_ORDER as o, userManagementCapability as on, enumerateItemArrayFields as ot, DERIVED_CAMERA_SILENCED_CAP_NAMES as p, DATAPLANE_SECRET_HEADER as pn, formatMinutes as pt, collectSecretConfigKeys as q, runtimeStatePolicyFor as qt, ApiKeyRecordSchema as r, storageProviderCapability as rn, deviceStatusCapability as rt, CAP_NAMES_WITH_STATUS as s, vectorDimFromBase64 as sn, enumerateSchemaFields as st, ALL_CAPABILITY_DEFINITIONS as t, storageMigrationCapability as tn, deviceManagerCapability as tt, CoreBlockSchema as u, errMsg as un, extractNestedAddonId as ut, LegacyStorageLocationDefaultSchema as v, DeviceType as vn, isObjectInput as vt, REDACTED_SECRET as w, asString as wn, lifecycleJobSchema as wt, MINUTES_PER_DAY as x, WELL_KNOWN_TAB_MAP as xn, isVoidInput as xt, LocationIconIdSchema as y, ReadinessRegistry as yn, isSameAddonId as yt, addonWidgetsCapability as z, EventCategory as zn, platformProbeCapability as zt };
+export { decodeVectorBase64 as $, siteZoneKey as $t, STREAM_PROFILE_META as A, hydrateSchema as An, logLevelAtMost as At, alertsCapability as B, EventCategory as Bn, parseStreamParamsFormPatch as Bt, RECORDING_SOURCE_CAMSTACK_ADDON as C, asJsonObject as Cn, kebabToCamel as Ct, SOURCE_CAPS as D, emitDownForOwnedCaps as Dn, localNetworkCapability as Dt, RecordingStatusSchema as E, createEvent as En, lifecycleJobSchema as Et, StorageMigrationJobSchema as F, parseJsonUnknown as Fn, modeMayWrite as Ft, buildStreamParamsConfigSchema as G, resolveBucketMs as Gt, backupCapability as H, procedureAuthKey as Ht, UserRecordSchema as I, readinessKey as In, motionCapability as It, coreBlockAddonId as J, runtimeStatePolicyFor as Jt, cameraGridLayoutCapability as K, resolveLocationMode as Kt, addonPagesCapability as L, resolveCapMount as Ln, normalizeUnit as Lt, StorageCleanupJobSchema as M, isEvent as Mn, mayReadLocation as Mt, StorageLocationModeSchema as N, nodePin as Nn, mayWriteToLocation as Nt, SOURCE_DEVICE_TYPES as O, emitReadiness as On, locationIconKey as Ot, StorageLocationTypeSchema as P, parseJsonObject as Pn, metricsProviderCapability as Pt, declarationOwnerNodeId as Q, settingsStoreCapability as Qt, addonSettingsCapability as R, scopeKey as Rn, objectInputDeclaresAddonId as Rt, MOTION_CLOSE_AFTER_MS as S, WELL_KNOWN_TAB_MAP as Sn, isVoidInput as St, RUNTIME_DEFAULTS as T, asString as Tn, legacyModeOf as Tt, bareAddonId as U, ptzAutotrackCapability as Ut, authProviderCapability as V, platformProbeCapability as Vt, batteryCapability as W, reducePoints as Wt, coreBlocksCapability as X, scopesAllowDeviceCap as Xt, coreBlockIdFromAddonId as Y, scopesAllowAddon as Yt, dataStoreProviderCapability as Z, scoreRuntimes as Zt, LOG_LEVEL_RANK as _, DeviceFeature as _n, isCollectionArrayMethod as _t, BatteryStatusSchema as a, streamCatalogCapability as an, enumerateInferenceDevices as at, METHOD_ACCESS_MAP as b, ReadinessRegistry as bn, isSameAddonId as bt, CORE_BLOCKS_ADDON_ID as c, vectorDimFromBase64 as cn, evaluateSensorEdge as ct, DAY_NAMES as d, errMsg as dn, extractNestedAddonId as dt, snapshotCapability as en, deriveBatteryPresence as et, DEFAULT_FIRST_SIGHTING_FRESHNESS_MS as f, buildFfmpegArgs as fn, filesystemBrowseCapability as ft, FIRST_LEVEL_MACRO_CLASSES as g, DEVICE_STATUS_METHOD as gn, isArrayOutputSchema as gt, DeviceStatusSchema as h, DEVICE_SETTINGS_CONTRIBUTION_METHODS as hn, gbToBytes as ht, BaseDevice as i, storageProviderCapability as in, doorbellCapability as it, ScopedTokenSchema as j, isDeviceConfigCap as jn, looseSchema as jt, STORAGE_ACCESS_FALLBACK as k, expandCapMethods as kn, logDestinationCapability as kt, CORE_BLOCK_ADDON_PREFIX as l, vectorStoreCapability as ln, evictionPolicyOfLocation as lt, DeclaredDevices as m, DATAPLANE_SECRET_HEADER as mn, formatMinutes as mt, AlertSchema as n, storageMigrationCapability as nn, deviceStateCapability as nt, CAMERA_SWITCH_ORDER as o, streamQualityLabel as on, enumerateItemArrayFields as ot, DERIVED_CAMERA_SILENCED_CAP_NAMES as p, BaseAddon as pn, foldSnapshotByFunction as pt, collectSecretConfigKeys as q, resolveMethodAuth as qt, ApiKeyRecordSchema as r, storageOccupancyCapability as rn, deviceStatusCapability as rt, CAP_NAMES_WITH_STATUS as s, userManagementCapability as sn, enumerateSchemaFields as st, ALL_CAPABILITY_DEFINITIONS as t, storageCapability as tn, deviceManagerCapability as tt, CoreBlockSchema as u, withLocationMode as un, expandContainer as ut, LegacyStorageLocationDefaultSchema as v, DeviceRole as vn, isLocationEnabled as vt, REDACTED_SECRET as w, asNumber as wn, legacyAutoLinkIds as wt, MINUTES_PER_DAY as x, ReadinessTimeoutError as xn, isSourceCap as xt, LocationIconIdSchema as y, DeviceType as yn, isObjectInput as yt, addonWidgetsCapability as z, sleep as zn, objectInputDeclaresRequiredDeviceId as zt };

package/dist/index.d.ts

@@ -112,3 +112,7 @@ export { type EnsureAddonNativePrebuildsOptions, ensureAddonNativePrebuilds, typ
 export { type EnsureNativePrebuildsOptions, ensureNativePrebuilds, hasDotNode, NATIVE_SCAN_DEPTH, type PrebuildFetchFn, type PrebuildTarget, TRADITIONAL_NATIVE_PACKAGES, } from './kernel/deps/ensure-native-prebuilds.js';
 export { type NpmInvocation, type RunNpmOptions, buildNpmChildEnv, resolveNpmInvocation, runNpm, } from './kernel/deps/npm-command.js';
 export * from './kernel/index.js';
+/** The token a CHILD uses to say "this method is declared optional and this
+ *  provider does not serve it", which the hub turns into `NOT_IMPLEMENTED`.
+ *  Crosses a UDS boundary as a plain message, so it is a prefix, not a class. */
+export { CAP_METHOD_NOT_IMPLEMENTED } from './kernel/moleculer/child-cap-dispatch.js';