@camstack/types 1.2.151 → 1.2.153

package/dist/index.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-BaEgqJNv.js");
-const require_sleep = require("./sleep-BCUreN6s.js");
+const require_event_category = require("./event-category-b8kBSOTT.js");
+const require_sleep = require("./sleep-TVipGseU.js");
 const require_canonical_hash = require("./canonical-hash-DNV8S5ET.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
@@ -19016,6 +19016,35 @@ var RecentTracksQueryInput = zod.z.object({
 	*/
 	classes: zod.z.array(zod.z.string()).optional()
 });
+/**
+* A Summary (D359): the per-camera session envelope that references tracks.
+* `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
+* served by the event-media plane by key), null until the first frame with a
+* member visible has been materialised.
+*/
+var SummarySchema = zod.z.object({
+	id: zod.z.string(),
+	deviceId: zod.z.number(),
+	openedAt: zod.z.number(),
+	lastActiveAt: zod.z.number(),
+	sealedAt: zod.z.number().nullable(),
+	memberCount: zod.z.number().int().nonnegative(),
+	groupShotKey: zod.z.string().nullable()
+});
+var SUMMARIES_MAX_LIMIT = 200;
+var SUMMARIES_DEFAULT_LIMIT = 50;
+var SummariesQueryInput = zod.z.object({
+	deviceIds: zod.z.array(zod.z.number()).min(1),
+	since: zod.z.number().optional(),
+	until: zod.z.number().optional(),
+	limit: zod.z.number().int().min(1).max(200).default(50)
+});
+var SummariesPageSchema = zod.z.object({ summaries: zod.z.array(SummarySchema).readonly() });
+var SummaryDetailSchema = zod.z.object({
+	summary: SummarySchema,
+	/** Member track ids, in absorption order. */
+	trackIds: zod.z.array(zod.z.string()).readonly()
+});
 var RecentTracksPageSchema = zod.z.object({
 	/** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
 	tracks: zod.z.array(TrackSchema).readonly(),
@@ -19458,6 +19487,10 @@ var pipelineAnalyticsCapability = {
 		* are not included (same contract as `listTracks`).
 		*/
 		listRecentTracks: require_sleep.method(RecentTracksQueryInput, RecentTracksPageSchema),
+		/** Newest first by `openedAt`, for a camera set, inside an optional window. */
+		listSummaries: require_sleep.method(SummariesQueryInput, SummariesPageSchema),
+		/** One summary with its member track ids; `null` for an id nobody wrote. */
+		getSummary: require_sleep.method(zod.z.object({ id: zod.z.string() }), SummaryDetailSchema.nullable()),
 		clearTracks: require_sleep.method(zod.z.object({ deviceId: zod.z.number() }), zod.z.void(), {
 			kind: "mutation",
 			auth: "admin"
@@ -25535,6 +25568,125 @@ onStatusChanged: { data: zod.z.object({
 	volatileStateFields: ["lastUpdated"]
 };
 //#endregion
+//#region src/capabilities/network-link.cap.ts
+/**
+* How a device reaches the network, and how well.
+*
+* NOT `connectivity`: that cap is an UPSTREAM system's binary view of whether
+* an entity is reachable (a Home Assistant `binary_sensor` with
+* `device_class: connectivity`). This one is the device's OWN link — the
+* medium it is on and the signal it sees — the way `battery` is the device's
+* own charge.
+*
+* `'wifi'`, `'ethernet'` and `'cellular'` are links the firmware actually
+* reported. `'unknown'` is the ABSENCE of an answer — the provider has
+* registered the capability but has not read the link yet (D315: unknown is
+* not empty). Consumers skip it rather than draw a wire or a bar.
+*/
+var NETWORK_LINK_TYPES = [
+	"wifi",
+	"ethernet",
+	"cellular",
+	"unknown"
+];
+/**
+* Network-link snapshot. Same shape for every provider (a Reolink wifi
+* camera, a Home Assistant device with a signal-strength sensor, a Tapo
+* plug): one slice under `device.runtimeState['network-link']`, one badge,
+* one Home Assistant projection.
+*/
+var NetworkLinkStatusSchema = zod.z.object({
+	/** The link the device is on. `'unknown'` = not read yet, not "no link". */
+	type: zod.z.enum(NETWORK_LINK_TYPES),
+	/**
+	* Link quality, 0..100 inclusive, normalised by the provider from whatever
+	* the firmware reports (bars, RSSI, a vendor scale). **`null` means NOT
+	* KNOWN or NOT APPLICABLE** — a wired link has no signal, and a wireless
+	* one whose reading has not landed must not be drawn at 0 %. Consumers
+	* SKIP a null rather than coerce it.
+	*/
+	signalPercent: zod.z.number().min(0).max(100).nullable(),
+	/** Raw received signal strength in dBm, when the firmware reports one. */
+	rssiDbm: zod.z.number().optional(),
+	/** Network name of a wireless link, when the firmware reports it. */
+	ssid: zod.z.string().optional(),
+	/** Ms epoch of the last observation. Lets consumers reason about freshness. */
+	lastUpdated: zod.z.number()
+});
+/** The slice a provider seeds before its first read: nothing is known yet. */
+var NETWORK_LINK_UNKNOWN = {
+	type: "unknown",
+	signalPercent: null,
+	lastUpdated: 0
+};
+/**
+* Normalise a signal the firmware reports as BARS (0..`maxBars`) to 0..100.
+* Out-of-range or non-finite input is not a reading: `null`.
+*/
+function signalPercentFromBars(bars, maxBars) {
+	if (bars === void 0 || !Number.isFinite(bars) || maxBars <= 0) return null;
+	if (bars < 0 || bars > maxBars) return null;
+	return Math.round(bars / maxBars * 100);
+}
+/**
+* Normalise an RSSI in dBm to 0..100 on the usual wifi scale: -100 dBm and
+* below is 0 %, -50 dBm and above is 100 %, linear between. Non-finite or
+* positive input is not an RSSI: `null`.
+*/
+function signalPercentFromRssi(rssiDbm) {
+	if (rssiDbm === void 0 || !Number.isFinite(rssiDbm) || rssiDbm > 0) return null;
+	return Math.round((Math.min(-50, Math.max(-100, rssiDbm)) + 100) * 2);
+}
+var networkLinkCapability = {
+	name: "network-link",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [
+		require_sleep.DeviceType.Camera,
+		require_sleep.DeviceType.Sensor,
+		require_sleep.DeviceType.Button,
+		require_sleep.DeviceType.Switch,
+		require_sleep.DeviceType.Light,
+		require_sleep.DeviceType.Lock,
+		require_sleep.DeviceType.Siren
+	],
+	methods: {},
+	events: { 
+	/**
+	* Emitted whenever the cached status changes (a link switch, a signal
+	* reading that moved). Mirrored on the parent chain by the
+	* DeviceEventPropagator like `battery.onStatusChanged`.
+	*/
+onStatusChanged: { data: zod.z.object({
+		deviceId: zod.z.number(),
+		status: NetworkLinkStatusSchema
+	}) } },
+	status: {
+		schema: NetworkLinkStatusSchema,
+		kind: "push",
+		empty: NETWORK_LINK_UNKNOWN
+	},
+	/**
+	* Runtime-state slice — every provider stores the same shape under
+	* `device.runtimeState['network-link']`, read once by the badge and the
+	* Home Assistant projector regardless of the driver.
+	*/
+	runtimeState: NetworkLinkStatusSchema,
+	/**
+	* Runtime-state durability: **restored** — a link reading is slow to
+	* change and a sleeping battery camera may not report for hours; the
+	* restored slice is what the badge shows until the next read.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "restored",
+	/** Clock fields: written, but excluded from the compare that decides
+	*  whether persisting is worth a SQLite commit. */
+	volatileStateFields: ["lastUpdated"]
+};
+//#endregion
 //#region src/capabilities/binary.cap.ts
 /**
 * Generic boolean sensor — last-resort fallback when no domain-
@@ -36035,6 +36187,7 @@ var DEVICE_LOCAL_STATE_CAPS = {
 	motionTrigger: motionTriggerCapability,
 	motionZones: motionZonesCapability,
 	nativeObjectDetection: nativeObjectDetectionCapability,
+	networkLink: networkLinkCapability,
 	notifier: notifierCapability,
 	numericSensor: numericSensorCapability,
 	petFeeder: petFeederCapability,
@@ -38847,6 +39000,7 @@ var CAP_NAMES_WITH_STATUS = [
 	"motion-zones",
 	"mqtt-broker",
 	"native-object-detection",
+	"network-link",
 	"notifier",
 	"numeric-sensor",
 	"osd",
@@ -38966,6 +39120,7 @@ var CAPABILITY_NAMES = {
 	mqttBroker: "mqtt-broker",
 	nativeObjectDetection: "native-object-detection",
 	networkAccess: "network-access",
+	networkLink: "network-link",
 	networkQuality: "network-quality",
 	nodes: "nodes",
 	notificationOutput: "notification-output",
@@ -39391,6 +39546,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "networkAccess",
 		name: "network-access"
 	},
+	{
+		key: "networkLink",
+		name: "network-link"
+	},
 	{
 		key: "networkQuality",
 		name: "network-quality"
@@ -39740,6 +39899,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	mqttBrokerCapability,
 	nativeObjectDetectionCapability,
 	networkAccessCapability,
+	networkLinkCapability,
 	networkQualityCapability,
 	nodesCapability,
 	notificationOutputCapability,
@@ -43106,6 +43266,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.getSummary": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.getTrack": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -43184,6 +43350,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"pipelineAnalytics.listSummaries": {
+		capName: "pipeline-analytics",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"pipelineAnalytics.listTrackMedia": {
 		capName: "pipeline-analytics",
 		capScope: "device",
@@ -47142,6 +47314,11 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "array",
 		optional: true
 	}],
+	"pipelineAnalytics.listSummaries": [{
+		name: "deviceIds",
+		form: "array",
+		optional: false
+	}],
 	"pipelineAnalytics.listTrackMedia": [{
 		name: "deviceId",
 		form: "single",
@@ -48086,7 +48263,7 @@ function getCapsByProviderKind(kind) {
 //#region src/generated/runtime-state-durability.ts
 /**
 * Per-cap runtime-state policy, projected from every `*.cap.ts` that declares
-* `runtimeState`. 64 caps: 34 `restored`, 30 `session`.
+* `runtimeState`. 65 caps: 35 `restored`, 30 `session`.
 *
 * A cap absent from this map has no runtime-state slice at all. A cap PRESENT
 * with `durability: 'session'` has one and has decided not to keep it.
@@ -48248,6 +48425,10 @@ var RUNTIME_STATE_POLICY = {
 		durability: "restored",
 		volatileFields: ["lastFetchedAt"]
 	},
+	"network-link": {
+		durability: "restored",
+		volatileFields: ["lastUpdated"]
+	},
 	"notifier": {
 		durability: "session",
 		volatileFields: []
@@ -48390,6 +48571,7 @@ var RESTORED_CAP_NAMES = [
 	"lock-control",
 	"motion-zones",
 	"native-object-detection",
+	"network-link",
 	"numeric-sensor",
 	"power-meter",
 	"presence",
@@ -53660,6 +53842,8 @@ exports.NC_SNOOZE_MAX_MINUTES = NC_SNOOZE_MAX_MINUTES;
 exports.NC_SYSTEM_DELIVERY = NC_SYSTEM_DELIVERY;
 exports.NC_SYSTEM_EVENT_FILTER_KEYS = NC_SYSTEM_EVENT_FILTER_KEYS;
 exports.NC_TAXONOMY = NC_TAXONOMY;
+exports.NETWORK_LINK_TYPES = NETWORK_LINK_TYPES;
+exports.NETWORK_LINK_UNKNOWN = NETWORK_LINK_UNKNOWN;
 exports.NativeCropBboxSchema = NativeCropBboxSchema;
 exports.NativeCropRefSchema = NativeCropRefSchema;
 exports.NativeCropResultSchema = NativeCropResultSchema;
@@ -53718,6 +53902,7 @@ exports.NcZoneConditionSchema = NcZoneConditionSchema;
 exports.NetworkAccessStatusSchema = NetworkAccessStatusSchema;
 exports.NetworkAddressSchema = NetworkAddressSchema;
 exports.NetworkEndpointSchema = NetworkEndpointSchema;
+exports.NetworkLinkStatusSchema = NetworkLinkStatusSchema;
 exports.NotificationActionIconSchema = NotificationActionIconSchema;
 exports.NotificationActionSchema = NotificationActionSchema;
 exports.NotificationFormatSchema = NotificationFormatSchema;
@@ -53910,6 +54095,8 @@ exports.STORAGE_ACCESS_FALLBACK = STORAGE_ACCESS_FALLBACK;
 exports.STREAM_PROFILE_META = STREAM_PROFILE_META;
 exports.STREAM_QUALITY_LABELS = STREAM_QUALITY_LABELS;
 exports.SUB_DETECTION_TYPES = SUB_DETECTION_TYPES;
+exports.SUMMARIES_DEFAULT_LIMIT = SUMMARIES_DEFAULT_LIMIT;
+exports.SUMMARIES_MAX_LIMIT = SUMMARIES_MAX_LIMIT;
 exports.SYSTEM_CAP_NAMES = SYSTEM_CAP_NAMES;
 exports.SYSTEM_SCOPE_DEVICE_METHODS = SYSTEM_SCOPE_DEVICE_METHODS;
 exports.SceneCheckSchema = SceneCheckSchema;
@@ -54011,6 +54198,7 @@ exports.SubscribeAudioChunksInputSchema = require_sleep.SubscribeAudioChunksInpu
 exports.SubscribeAudioChunksResultSchema = require_sleep.SubscribeAudioChunksResultSchema;
 exports.SubscribeFramesInputSchema = require_sleep.SubscribeFramesInputSchema;
 exports.SubscribeFramesResultSchema = require_sleep.SubscribeFramesResultSchema;
+exports.SummarySchema = SummarySchema;
 exports.SwitchStatusSchema = SwitchStatusSchema;
 exports.SystemMetricsSchema = SystemMetricsSchema;
 exports.SystemMirror = SystemMirror;
@@ -54374,6 +54562,7 @@ exports.motionZonesCapability = motionZonesCapability;
 exports.mqttBrokerCapability = mqttBrokerCapability;
 exports.nativeObjectDetectionCapability = nativeObjectDetectionCapability;
 exports.networkAccessCapability = networkAccessCapability;
+exports.networkLinkCapability = networkLinkCapability;
 exports.networkQualityCapability = networkQualityCapability;
 exports.nodePin = require_sleep.nodePin;
 exports.nodesCapability = nodesCapability;
@@ -54487,6 +54676,8 @@ exports.selectAssignedProfileSlots = require_sleep.selectAssignedProfileSlots;
 exports.serverManagementCapability = serverManagementCapability;
 exports.setByPath = setByPath;
 exports.settingsStoreCapability = settingsStoreCapability;
+exports.signalPercentFromBars = signalPercentFromBars;
+exports.signalPercentFromRssi = signalPercentFromRssi;
 exports.sleep = require_sleep.sleep;
 exports.sleepCancellable = require_sleep.sleepCancellable;
 exports.sliceActiveValue = sliceActiveValue;