@camstack/types 1.2.588 → 1.2.590

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/dist/addon.js +4 -4
  3. package/dist/addon.mjs +4 -4
  4. package/dist/capabilities/alarm-panel.cap.d.ts +15 -7
  5. package/dist/capabilities/battery.cap.d.ts +7 -41
  6. package/dist/capabilities/capability-definition.d.ts +12 -0
  7. package/dist/capabilities/index.d.ts +5 -1
  8. package/dist/capabilities/lock-control.cap.d.ts +5 -2
  9. package/dist/capabilities/low-power-sleep.cap.d.ts +83 -0
  10. package/dist/capabilities/resync.cap.d.ts +40 -0
  11. package/dist/client.js +19 -11
  12. package/dist/client.mjs +19 -11
  13. package/dist/{composed-stable-id-BBL71oUQ.mjs → composed-stable-id-BNTaDZEh.mjs} +9 -13
  14. package/dist/{composed-stable-id-CVbyajE5.js → composed-stable-id-BdeYe5dD.js} +9 -13
  15. package/dist/device/device-feature-requirements.d.ts +3 -6
  16. package/dist/device/device-profile.d.ts +1 -1
  17. package/dist/device/device-type.d.ts +9 -13
  18. package/dist/device/low-power-sleep.d.ts +19 -0
  19. package/dist/device/resync-through-adoption.d.ts +12 -0
  20. package/dist/enums/event-category.d.ts +1 -1
  21. package/dist/enums.js +1 -1
  22. package/dist/enums.mjs +1 -1
  23. package/dist/{event-category-CE_VCE2G.js → event-category-BKxXXxnV.js} +1 -1
  24. package/dist/{event-category-Hwx_JSCU.mjs → event-category-CY27-fF0.mjs} +1 -1
  25. package/dist/generated/addon-api.d.ts +113 -8
  26. package/dist/generated/addon-cap-facts.d.ts +1 -1
  27. package/dist/generated/cap-status-types.d.ts +3 -1
  28. package/dist/generated/cap-vocabulary.d.ts +1 -1
  29. package/dist/generated/capability-router-map.d.ts +8 -2
  30. package/dist/generated/device-local-state.d.ts +3 -0
  31. package/dist/generated/device-proxy.d.ts +5 -0
  32. package/dist/generated/device-scoped-caps.d.ts +1 -1
  33. package/dist/generated/history-catalog.d.ts +1 -1
  34. package/dist/generated/method-access-map.d.ts +1 -1
  35. package/dist/generated/method-device-selectors.d.ts +1 -1
  36. package/dist/generated/runtime-state-durability.d.ts +6 -1
  37. package/dist/{implemented-methods-ChtdIofW.js → implemented-methods-BarLh7tc.js} +1 -1
  38. package/dist/{implemented-methods-u7ddjc-_.mjs → implemented-methods-k3KProJd.mjs} +1 -1
  39. package/dist/index.d.ts +3 -0
  40. package/dist/index.js +357 -82
  41. package/dist/index.mjs +342 -83
  42. package/dist/interfaces/event-bus.d.ts +1 -1
  43. package/dist/node.js +2 -2
  44. package/dist/node.mjs +2 -2
  45. package/dist/schemas/api-catalog.d.ts +170 -0
  46. package/dist/{sleep-CsZJsb8n.js → sleep-BA_SIc0O.js} +51 -10
  47. package/dist/{sleep-D6Pih0Qt.mjs → sleep-BT1bLgPq.mjs} +51 -10
  48. package/package.json +1 -1
package/dist/client.mjs CHANGED
@@ -21829,9 +21829,8 @@ function t(en, it) {
21829
21829
  * Many panels require a PIN code on arm / disarm — the optional
21830
21830
  * `code` field on the methods passes it through to the upstream
21831
21831
  * service; it's NEVER persisted in the runtime slice or any event
21832
- * payload. The presence of a required code is signalled by
21833
- * `DeviceFeature.AlarmPinRequired` so the UI gates a code-entry
21834
- * field without a slice fetch.
21832
+ * payload. Whether a code is required is the slice's `codeRequired`
21833
+ * (#459): `null` when the provider cannot tell (D393).
21835
21834
  *
21836
21835
  * `availableModes` mirrors HA's `supported_features`-derived arm
21837
21836
  * mode list — the UI renders only the buttons the panel accepts.
@@ -21870,9 +21869,13 @@ z.object({
21870
21869
  /** Subset of arm modes the panel accepts. UI renders one button per
21871
21870
  * mode in this list. */
21872
21871
  availableModes: z.array(AlarmArmModeSchema),
21873
- /** Whether the panel requires a PIN on arm / disarm. Mirrors
21874
- * `DeviceFeature.AlarmPinRequired` for slice consumers. */
21875
- requiresCode: z.boolean(),
21872
+ /**
21873
+ * Whether the panel requires a PIN on arm / disarm (#459; the field was
21874
+ * `requiresCode`, and the `alarm-pin-required` device feature is gone).
21875
+ * `null` = the provider cannot tell (D393), never `false`. A slice restored
21876
+ * from before the rename is upgraded at boot by `restoredFieldRenames`.
21877
+ */
21878
+ codeRequired: z.boolean().nullable(),
21876
21879
  /** Ms epoch when the slice was last updated. */
21877
21880
  lastChangedAt: z.number()
21878
21881
  });
@@ -21913,7 +21916,7 @@ DeviceType.AlarmPanel, method(z.object({ deviceId: z.number().int().nonnegative(
21913
21916
  }), method(z.object({
21914
21917
  deviceId: z.number().int().nonnegative(),
21915
21918
  mode: AlarmArmModeSchema,
21916
- /** Optional PIN code. Required when `requiresCode === true`.
21919
+ /** Optional PIN code. Required when `codeRequired === true`.
21917
21920
  * Passed through to the upstream service; never persisted. */
21918
21921
  code: z.string().min(1).optional()
21919
21922
  }), z.void(), {
@@ -27648,10 +27651,7 @@ function createDeviceProxy(api, binding, opts) {
27648
27651
  trigger: (input, options) => dispatch("automation-control", "automationControl", "trigger", "mutation", input, void 0, options),
27649
27652
  getStatus: (input, options) => dispatch("automation-control", "automationControl", "getStatus", "query", input, void 0, options)
27650
27653
  };
27651
- const batteryInterface = {
27652
- wakeForStream: (input, options) => dispatch("battery", "battery", "wakeForStream", "mutation", input, void 0, options),
27653
- getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options)
27654
- };
27654
+ const batteryInterface = { getStatus: (input, options) => dispatch("battery", "battery", "getStatus", "query", input, void 0, options) };
27655
27655
  const binaryInterface = { getStatus: (input, options) => dispatch("binary", "binary", "getStatus", "query", input, void 0, options) };
27656
27656
  const brightnessInterface = {
27657
27657
  setBrightness: (input, options) => dispatch("brightness", "brightness", "setBrightness", "mutation", input, void 0, options),
@@ -27855,6 +27855,10 @@ function createDeviceProxy(api, binding, opts) {
27855
27855
  open: (input, options) => dispatch("lock-control", "lockControl", "open", "mutation", input, void 0, options),
27856
27856
  getStatus: (input, options) => dispatch("lock-control", "lockControl", "getStatus", "query", input, void 0, options)
27857
27857
  };
27858
+ const lowPowerSleepInterface = {
27859
+ wakeUp: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "wakeUp", "mutation", input, void 0, options),
27860
+ getStatus: (input, options) => dispatch("low-power-sleep", "lowPowerSleep", "getStatus", "query", input, void 0, options)
27861
+ };
27858
27862
  const mediaPlayerInterface = {
27859
27863
  turnOn: (input, options) => dispatch("media-player", "mediaPlayer", "turnOn", "mutation", input, void 0, options),
27860
27864
  turnOff: (input, options) => dispatch("media-player", "mediaPlayer", "turnOff", "mutation", input, void 0, options),
@@ -28096,6 +28100,7 @@ function createDeviceProxy(api, binding, opts) {
28096
28100
  getStatus: (input, options) => dispatch("recording-onboard", "recordingOnboard", "getStatus", "query", input, void 0, options)
28097
28101
  };
28098
28102
  const recordingSignalInterface = { getStatus: (input, options) => dispatch("recording-signal", "recordingSignal", "getStatus", "query", input, void 0, options) };
28103
+ const resyncInterface = { resync: (input, options) => dispatch("resync", "resync", "resync", "mutation", input, void 0, options) };
28099
28104
  const runningStateInterface = { getStatus: (input, options) => dispatch("running-state", "runningState", "getStatus", "query", input, void 0, options) };
28100
28105
  const sceneMonitorInterface = {
28101
28106
  listScenes: (input, options) => dispatch("scene-monitor", "sceneMonitor", "listScenes", "query", input, void 0, options),
@@ -28453,6 +28458,7 @@ function createDeviceProxy(api, binding, opts) {
28453
28458
  irTransmitter: createSliceHandle(stateSource, binding.deviceId, "ir-transmitter"),
28454
28459
  lawnMowerControl: createSliceHandle(stateSource, binding.deviceId, "lawn-mower-control"),
28455
28460
  lockControl: createSliceHandle(stateSource, binding.deviceId, "lock-control"),
28461
+ lowPowerSleep: createSliceHandle(stateSource, binding.deviceId, "low-power-sleep"),
28456
28462
  mediaPlayer: createSliceHandle(stateSource, binding.deviceId, "media-player"),
28457
28463
  meter: createSliceHandle(stateSource, binding.deviceId, "meter"),
28458
28464
  motion: createSliceHandle(stateSource, binding.deviceId, "motion"),
@@ -28554,6 +28560,7 @@ function createDeviceProxy(api, binding, opts) {
28554
28560
  ...bound("ir-transmitter") ? { irTransmitter: irTransmitterInterface } : {},
28555
28561
  ...bound("lawn-mower-control") ? { lawnMowerControl: lawnMowerControlInterface } : {},
28556
28562
  ...bound("lock-control") ? { lockControl: lockControlInterface } : {},
28563
+ ...bound("low-power-sleep") ? { lowPowerSleep: lowPowerSleepInterface } : {},
28557
28564
  ...bound("media-player") ? { mediaPlayer: mediaPlayerInterface } : {},
28558
28565
  ...bound("meter") ? { meter: meterInterface } : {},
28559
28566
  ...bound("motion") ? { motion: motionInterface } : {},
@@ -28581,6 +28588,7 @@ function createDeviceProxy(api, binding, opts) {
28581
28588
  ...bound("recording") ? { recording: recordingInterface } : {},
28582
28589
  ...bound("recording-onboard") ? { recordingOnboard: recordingOnboardInterface } : {},
28583
28590
  ...bound("recording-signal") ? { recordingSignal: recordingSignalInterface } : {},
28591
+ ...bound("resync") ? { resync: resyncInterface } : {},
28584
28592
  ...bound("running-state") ? { runningState: runningStateInterface } : {},
28585
28593
  ...bound("scene-monitor") ? { sceneMonitor: sceneMonitorInterface } : {},
28586
28594
  ...bound("script-runner") ? { scriptRunner: scriptRunnerInterface } : {},
@@ -139,12 +139,19 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
139
139
  return DeviceType;
140
140
  }({});
141
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
142
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
142
143
  DeviceFeature["BatteryOperated"] = "battery-operated";
144
+ /**
145
+ * The device goes into low-power sleep and must be WOKEN before it streams
146
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
147
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
148
+ */
149
+ DeviceFeature["Sleeps"] = "sleeps";
143
150
  DeviceFeature["Rebootable"] = "rebootable";
144
151
  /**
145
152
  * Device supports an on-demand re-sync of its derived spec with its
146
- * upstream source — drives the generic Re-sync button. The owning
147
- * provider implements the action via the `device-adoption.resync` cap.
153
+ * upstream source — drives the generic Re-sync button. Present when the
154
+ * device has the `resync` cap bound (#459, Q6).
148
155
  */
149
156
  DeviceFeature["Resyncable"] = "resyncable";
150
157
  DeviceFeature["NativeSnapshot"] = "native-snapshot";
@@ -228,9 +235,6 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
228
235
  DeviceFeature["FanDirection"] = "fan-direction";
229
236
  /** Fan exposes an oscillation toggle. */
230
237
  DeviceFeature["FanOscillating"] = "fan-oscillating";
231
- /** Lock requires a PIN code on lock/unlock. Gates the code-entry
232
- * field on the UI lock-controls panel. */
233
- DeviceFeature["LockPinRequired"] = "lock-pin-required";
234
238
  /** Lock supports a latch-release ("open door") action distinct from
235
239
  * unlock. Mirrors HA `LockEntityFeature.OPEN` (bit 1) in
236
240
  * `supported_features`. Gates the Open Door button in the UI. */
@@ -261,8 +265,6 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
261
265
  DeviceFeature["MediaPlayerChannelStep"] = "media-player-channel-step";
262
266
  /** Media player exposes power on / off. */
263
267
  DeviceFeature["MediaPlayerPower"] = "media-player-power";
264
- /** Alarm panel requires a PIN code on arm/disarm. */
265
- DeviceFeature["AlarmPinRequired"] = "alarm-pin-required";
266
268
  /** Presence device carries GPS coordinates (lat/lng/accuracy) in
267
269
  * addition to a textual location. */
268
270
  DeviceFeature["PresenceGps"] = "presence-gps";
@@ -282,15 +284,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
282
284
  /** Automation `trigger` accepts a skipCondition flag — fires the
283
285
  * automation's actions while bypassing its condition block. */
284
286
  DeviceFeature["AutomationSkipCondition"] = "automation-skip-condition";
285
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
286
- * map tile in the vacuum UI. */
287
- DeviceFeature["VacuumHasMap"] = "vacuum-has-map";
288
287
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
289
288
  * switches group. */
290
289
  DeviceFeature["VacuumHasAi"] = "vacuum-has-ai";
291
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
292
- * mower map tile. */
293
- DeviceFeature["MowerHasMap"] = "mower-has-map";
294
290
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
295
291
  * spots) — gates the Mow action + map selectors. */
296
292
  DeviceFeature["MowerHasTargetedMowing"] = "mower-has-targeted-mowing";
@@ -139,12 +139,19 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
139
139
  return DeviceType;
140
140
  }({});
141
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
142
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
142
143
  DeviceFeature["BatteryOperated"] = "battery-operated";
144
+ /**
145
+ * The device goes into low-power sleep and must be WOKEN before it streams
146
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
147
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
148
+ */
149
+ DeviceFeature["Sleeps"] = "sleeps";
143
150
  DeviceFeature["Rebootable"] = "rebootable";
144
151
  /**
145
152
  * Device supports an on-demand re-sync of its derived spec with its
146
- * upstream source — drives the generic Re-sync button. The owning
147
- * provider implements the action via the `device-adoption.resync` cap.
153
+ * upstream source — drives the generic Re-sync button. Present when the
154
+ * device has the `resync` cap bound (#459, Q6).
148
155
  */
149
156
  DeviceFeature["Resyncable"] = "resyncable";
150
157
  DeviceFeature["NativeSnapshot"] = "native-snapshot";
@@ -228,9 +235,6 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
228
235
  DeviceFeature["FanDirection"] = "fan-direction";
229
236
  /** Fan exposes an oscillation toggle. */
230
237
  DeviceFeature["FanOscillating"] = "fan-oscillating";
231
- /** Lock requires a PIN code on lock/unlock. Gates the code-entry
232
- * field on the UI lock-controls panel. */
233
- DeviceFeature["LockPinRequired"] = "lock-pin-required";
234
238
  /** Lock supports a latch-release ("open door") action distinct from
235
239
  * unlock. Mirrors HA `LockEntityFeature.OPEN` (bit 1) in
236
240
  * `supported_features`. Gates the Open Door button in the UI. */
@@ -261,8 +265,6 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
261
265
  DeviceFeature["MediaPlayerChannelStep"] = "media-player-channel-step";
262
266
  /** Media player exposes power on / off. */
263
267
  DeviceFeature["MediaPlayerPower"] = "media-player-power";
264
- /** Alarm panel requires a PIN code on arm/disarm. */
265
- DeviceFeature["AlarmPinRequired"] = "alarm-pin-required";
266
268
  /** Presence device carries GPS coordinates (lat/lng/accuracy) in
267
269
  * addition to a textual location. */
268
270
  DeviceFeature["PresenceGps"] = "presence-gps";
@@ -282,15 +284,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
282
284
  /** Automation `trigger` accepts a skipCondition flag — fires the
283
285
  * automation's actions while bypassing its condition block. */
284
286
  DeviceFeature["AutomationSkipCondition"] = "automation-skip-condition";
285
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
286
- * map tile in the vacuum UI. */
287
- DeviceFeature["VacuumHasMap"] = "vacuum-has-map";
288
287
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
289
288
  * switches group. */
290
289
  DeviceFeature["VacuumHasAi"] = "vacuum-has-ai";
291
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
292
- * mower map tile. */
293
- DeviceFeature["MowerHasMap"] = "mower-has-map";
294
290
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
295
291
  * spots) — gates the Mow action + map selectors. */
296
292
  DeviceFeature["MowerHasTargetedMowing"] = "mower-has-targeted-mowing";
@@ -33,9 +33,10 @@ export interface ReportedFeature {
33
33
  export type FeatureRequirement = CapBackedFeature | ReportedFeature;
34
34
  /** Exhaustive: a new `DeviceFeature` without a row does not compile. */
35
35
  export declare const DEVICE_FEATURE_REQUIREMENTS: {
36
- readonly "battery-operated": ReportedFeature;
36
+ readonly "battery-operated": CapBackedFeature;
37
+ readonly sleeps: CapBackedFeature;
37
38
  readonly rebootable: CapBackedFeature;
38
- readonly resyncable: ReportedFeature;
39
+ readonly resyncable: CapBackedFeature;
39
40
  readonly "native-snapshot": ReportedFeature;
40
41
  readonly "doorbell-button": CapBackedFeature;
41
42
  readonly "two-way-audio": CapBackedFeature;
@@ -61,7 +62,6 @@ export declare const DEVICE_FEATURE_REQUIREMENTS: {
61
62
  readonly "fan-preset": CapBackedFeature;
62
63
  readonly "fan-direction": CapBackedFeature;
63
64
  readonly "fan-oscillating": CapBackedFeature;
64
- readonly "lock-pin-required": ReportedFeature;
65
65
  readonly "lock-open": CapBackedFeature;
66
66
  readonly "media-player-seek": CapBackedFeature;
67
67
  readonly "media-player-volume": CapBackedFeature;
@@ -76,7 +76,6 @@ export declare const DEVICE_FEATURE_REQUIREMENTS: {
76
76
  readonly "media-player-volume-step": CapBackedFeature;
77
77
  readonly "media-player-channel-step": CapBackedFeature;
78
78
  readonly "media-player-power": CapBackedFeature;
79
- readonly "alarm-pin-required": ReportedFeature;
80
79
  readonly "presence-gps": ReportedFeature;
81
80
  readonly "notifier-image": ReportedFeature;
82
81
  readonly "notifier-priority": ReportedFeature;
@@ -85,9 +84,7 @@ export declare const DEVICE_FEATURE_REQUIREMENTS: {
85
84
  readonly "notifier-recipients": ReportedFeature;
86
85
  readonly "script-variables": ReportedFeature;
87
86
  readonly "automation-skip-condition": ReportedFeature;
88
- readonly "vacuum-has-map": ReportedFeature;
89
87
  readonly "vacuum-has-ai": ReportedFeature;
90
- readonly "mower-has-map": ReportedFeature;
91
88
  readonly "mower-has-targeted-mowing": ReportedFeature;
92
89
  readonly navigation: CapBackedFeature;
93
90
  readonly "network-link": CapBackedFeature;
@@ -128,7 +128,7 @@ export interface DeviceProfile {
128
128
  * shipped populated — `snapshot.minRefreshIntervalSec: 3600` and
129
129
  * `streamBroker.preBufferEnabled: false` on the battery profile — which read
130
130
  * as live policy and were not: both behaviours are really enforced off
131
- * `DeviceFeature.BatteryOperated` directly, by `BATTERY_DEFAULT_MAX_AGE_S`
131
+ * `DeviceFeature.Sleeps` directly, by `BATTERY_DEFAULT_MAX_AGE_S`
132
132
  * in `snapshot.addon.ts` and by `getEffectivePreBufferSec` in
133
133
  * `stream-broker-manager.ts`. Emptied 2026-08-07; keep it empty until a
134
134
  * reader exists, or an entry here is just documentation that lies.
@@ -125,12 +125,19 @@ export declare enum DeviceType {
125
125
  Workload = "workload"
126
126
  }
127
127
  export declare enum DeviceFeature {
128
+ /** The device reports a battery reading (the `battery` cap). Says nothing about sleep. */
128
129
  BatteryOperated = "battery-operated",
130
+ /**
131
+ * The device goes into low-power sleep and must be WOKEN before it streams
132
+ * (the `low-power-sleep` cap, `wakeUp`). A battery reading alone is
133
+ * not this: a battery sensor reports charge and never sleeps (#459, Q2).
134
+ */
135
+ Sleeps = "sleeps",
129
136
  Rebootable = "rebootable",
130
137
  /**
131
138
  * Device supports an on-demand re-sync of its derived spec with its
132
- * upstream source — drives the generic Re-sync button. The owning
133
- * provider implements the action via the `device-adoption.resync` cap.
139
+ * upstream source — drives the generic Re-sync button. Present when the
140
+ * device has the `resync` cap bound (#459, Q6).
134
141
  */
135
142
  Resyncable = "resyncable",
136
143
  NativeSnapshot = "native-snapshot",
@@ -214,9 +221,6 @@ export declare enum DeviceFeature {
214
221
  FanDirection = "fan-direction",
215
222
  /** Fan exposes an oscillation toggle. */
216
223
  FanOscillating = "fan-oscillating",
217
- /** Lock requires a PIN code on lock/unlock. Gates the code-entry
218
- * field on the UI lock-controls panel. */
219
- LockPinRequired = "lock-pin-required",
220
224
  /** Lock supports a latch-release ("open door") action distinct from
221
225
  * unlock. Mirrors HA `LockEntityFeature.OPEN` (bit 1) in
222
226
  * `supported_features`. Gates the Open Door button in the UI. */
@@ -247,8 +251,6 @@ export declare enum DeviceFeature {
247
251
  MediaPlayerChannelStep = "media-player-channel-step",
248
252
  /** Media player exposes power on / off. */
249
253
  MediaPlayerPower = "media-player-power",
250
- /** Alarm panel requires a PIN code on arm/disarm. */
251
- AlarmPinRequired = "alarm-pin-required",
252
254
  /** Presence device carries GPS coordinates (lat/lng/accuracy) in
253
255
  * addition to a textual location. */
254
256
  PresenceGps = "presence-gps",
@@ -268,15 +270,9 @@ export declare enum DeviceFeature {
268
270
  /** Automation `trigger` accepts a skipCondition flag — fires the
269
271
  * automation's actions while bypassing its condition block. */
270
272
  AutomationSkipCondition = "automation-skip-condition",
271
- /** Robot vacuum exposes a live cleaning map (image child). Gates the
272
- * map tile in the vacuum UI. */
273
- VacuumHasMap = "vacuum-has-map",
274
273
  /** Robot vacuum exposes AI obstacle-detection toggles. Gates the AI
275
274
  * switches group. */
276
275
  VacuumHasAi = "vacuum-has-ai",
277
- /** Robot mower exposes a live mowing map (SVG image child). Gates the
278
- * mower map tile. */
279
- MowerHasMap = "mower-has-map",
280
276
  /** Robot mower exposes targeted mowing (all-area / zones / edges /
281
277
  * spots) — gates the Mow action + map selectors. */
282
278
  MowerHasTargetedMowing = "mower-has-targeted-mowing",
@@ -0,0 +1,19 @@
1
+ import type { BatteryStatus } from '../capabilities/battery.cap.js';
2
+ import type { LowPowerSleepStatus } from '../capabilities/low-power-sleep.cap.js';
3
+ /**
4
+ * Does this device SLEEP and need waking before it streams (#459, Q2)?
5
+ *
6
+ * The one predicate every data-plane consumer asks (prebuffer, wake-on-play,
7
+ * the recorder, sentry, the snapshot wrapper, the detection profile). It reads
8
+ * `DeviceFeature.Sleeps`, derived from the `low-power-sleep` cap — never
9
+ * `DeviceFeature.BatteryOperated`, which only says the device reports a
10
+ * battery: a battery sensor reports charge and never sleeps.
11
+ */
12
+ export declare function deviceSleeps(features: readonly string[]): boolean;
13
+ /**
14
+ * The `low-power-sleep` slice a provider projects from the `battery` slice it
15
+ * already keeps: the sleep inputs, nothing else. One fact, one writer — the
16
+ * provider's battery bookkeeping stays the source until the sleep state gets
17
+ * its own writer.
18
+ */
19
+ export declare function sleepSliceOfBattery(status: BatteryStatus): LowPowerSleepStatus;
@@ -0,0 +1,12 @@
1
+ import type { AddonApi } from '../generated/addon-api.js';
2
+ import type { resyncCapability } from '../capabilities/resync.cap.js';
3
+ import type { InferNativeProvider } from '../capabilities/capability-definition.js';
4
+ /** The one deviceManager method a `resync` provider needs. */
5
+ export type AdoptionResyncClient = Pick<AddonApi['deviceManager'], 'adoptionResync'>;
6
+ /**
7
+ * The `resync` provider of an adopted container (#459, Q6): the work is the
8
+ * owning addon's `device-adoption.resync`, reached through
9
+ * `deviceManager.adoptionResync`, which also owns the "resync from zero" child
10
+ * purge. Registering this is what makes `DeviceFeature.Resyncable` true.
11
+ */
12
+ export declare function resyncThroughAdoption(deviceManager: AdoptionResyncClient, ownDeviceId: number): InferNativeProvider<typeof resyncCapability>;
@@ -497,7 +497,7 @@ export declare enum EventCategory {
497
497
  */
498
498
  NetworkLinkOnStatusChanged = "network-link.onStatusChanged",
499
499
  /**
500
- * Emitted by the battery cap provider WHEN `wakeForStream` enters the
500
+ * Emitted by the battery cap provider WHEN `wakeUp` enters the
501
501
  * "wake in progress" window — between the Baichuan wake-up issue and
502
502
  * the camera's first dialed-back RTP packet. The stream-broker
503
503
  * manager subscribes to flip the per-broker placeholder reason to
package/dist/enums.js CHANGED
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_event_category = require("./event-category-CE_VCE2G.js");
2
+ const require_event_category = require("./event-category-BKxXXxnV.js");
3
3
  //#region src/enums/event-source-type.ts
4
4
  var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
5
5
  EventSourceType["Addon"] = "addon";
package/dist/enums.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { t as EventCategory } from "./event-category-Hwx_JSCU.mjs";
1
+ import { t as EventCategory } from "./event-category-CY27-fF0.mjs";
2
2
  //#region src/enums/event-source-type.ts
3
3
  var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
4
4
  EventSourceType["Addon"] = "addon";
@@ -498,7 +498,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
498
498
  */
499
499
  EventCategory["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
500
500
  /**
501
- * Emitted by the battery cap provider WHEN `wakeForStream` enters the
501
+ * Emitted by the battery cap provider WHEN `wakeUp` enters the
502
502
  * "wake in progress" window — between the Baichuan wake-up issue and
503
503
  * the camera's first dialed-back RTP packet. The stream-broker
504
504
  * manager subscribes to flip the per-broker placeholder reason to
@@ -498,7 +498,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
498
498
  */
499
499
  EventCategory["NetworkLinkOnStatusChanged"] = "network-link.onStatusChanged";
500
500
  /**
501
- * Emitted by the battery cap provider WHEN `wakeForStream` enters the
501
+ * Emitted by the battery cap provider WHEN `wakeUp` enters the
502
502
  * "wake in progress" window — between the Baichuan wake-up issue and
503
503
  * the camera's first dialed-back RTP packet. The stream-broker
504
504
  * manager subscribes to flip the per-broker placeholder reason to
@@ -20,7 +20,6 @@ import type { audioCodecCapability } from '../capabilities/audio-codec.cap.js';
20
20
  import type { audioMetricsCapability } from '../capabilities/audio-metrics.cap.js';
21
21
  import type { automationControlCapability } from '../capabilities/automation-control.cap.js';
22
22
  import type { backupCapability } from '../capabilities/backup.cap.js';
23
- import type { batteryCapability } from '../capabilities/battery.cap.js';
24
23
  import type { boardKeySourceCapability } from '../capabilities/board-key-source.cap.js';
25
24
  import type { brightnessCapability } from '../capabilities/brightness.cap.js';
26
25
  import type { brokerCapability } from '../capabilities/broker.cap.js';
@@ -83,6 +82,7 @@ import type { localNetworkCapability } from '../capabilities/local-network.cap.j
83
82
  import type { lockControlCapability } from '../capabilities/lock-control.cap.js';
84
83
  import type { logChannelsCapability } from '../capabilities/log-channels.cap.js';
85
84
  import type { loginMethodCapability } from '../capabilities/login-method.cap.js';
85
+ import type { lowPowerSleepCapability } from '../capabilities/low-power-sleep.cap.js';
86
86
  import type { mediaPlayerCapability } from '../capabilities/media-player.cap.js';
87
87
  import type { meshNetworkCapability } from '../capabilities/mesh-network.cap.js';
88
88
  import type { metricsProviderCapability } from '../capabilities/metrics-provider.cap.js';
@@ -130,6 +130,7 @@ import type { recordingCapability } from '../capabilities/recording.cap.js';
130
130
  import type { recordsCapability } from '../capabilities/records.cap.js';
131
131
  import type { remoteLayoutComponentsCapability } from '../capabilities/remote-layout-components.cap.js';
132
132
  import type { remoteCapability } from '../capabilities/remote.cap.js';
133
+ import type { resyncCapability } from '../capabilities/resync.cap.js';
133
134
  import type { sceneMonitorCapability } from '../capabilities/scene-monitor.cap.js';
134
135
  import type { schedulersCapability } from '../capabilities/schedulers.cap.js';
135
136
  import type { scriptRunnerCapability } from '../capabilities/script-runner.cap.js';
@@ -1196,13 +1197,6 @@ export type AppRouter = TrpcCoreRouter<{
1196
1197
  output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
1197
1198
  meta: object;
1198
1199
  }>;
1199
- wakeForStream: TRPCMutationProcedure<{
1200
- input: {
1201
- [x: string]: unknown;
1202
- } & z.input<typeof batteryCapability.methods.wakeForStream.input>;
1203
- output: z.infer<typeof batteryCapability.methods.wakeForStream.output>;
1204
- meta: object;
1205
- }>;
1206
1200
  }>>;
1207
1201
  binary: TRPCBuiltRouter<{
1208
1202
  ctx: TrpcContext;
@@ -5426,6 +5420,27 @@ export type AppRouter = TrpcCoreRouter<{
5426
5420
  meta: object;
5427
5421
  }>;
5428
5422
  }>>;
5423
+ lowPowerSleep: TRPCBuiltRouter<{
5424
+ ctx: TrpcContext;
5425
+ meta: object;
5426
+ errorShape: AugmentedErrorShape;
5427
+ transformer: true;
5428
+ }, TRPCDecorateCreateRouterOptions<{
5429
+ getStatus: TRPCQueryProcedure<{
5430
+ input: {
5431
+ [x: string]: unknown;
5432
+ } & z.input<typeof DEVICE_STATUS_METHOD.getStatus.input>;
5433
+ output: z.infer<typeof DEVICE_STATUS_METHOD.getStatus.output>;
5434
+ meta: object;
5435
+ }>;
5436
+ wakeUp: TRPCMutationProcedure<{
5437
+ input: {
5438
+ [x: string]: unknown;
5439
+ } & z.input<typeof lowPowerSleepCapability.methods.wakeUp.input>;
5440
+ output: z.infer<typeof lowPowerSleepCapability.methods.wakeUp.output>;
5441
+ meta: object;
5442
+ }>;
5443
+ }>>;
5429
5444
  mediaPlayer: TRPCBuiltRouter<{
5430
5445
  ctx: TrpcContext;
5431
5446
  meta: object;
@@ -9478,6 +9493,20 @@ export type AppRouter = TrpcCoreRouter<{
9478
9493
  meta: object;
9479
9494
  }>;
9480
9495
  }>>;
9496
+ resync: TRPCBuiltRouter<{
9497
+ ctx: TrpcContext;
9498
+ meta: object;
9499
+ errorShape: AugmentedErrorShape;
9500
+ transformer: true;
9501
+ }, TRPCDecorateCreateRouterOptions<{
9502
+ resync: TRPCMutationProcedure<{
9503
+ input: {
9504
+ [x: string]: unknown;
9505
+ } & z.input<typeof resyncCapability.methods.resync.input>;
9506
+ output: z.infer<typeof resyncCapability.methods.resync.output>;
9507
+ meta: object;
9508
+ }>;
9509
+ }>>;
9481
9510
  runningState: TRPCBuiltRouter<{
9482
9511
  ctx: TrpcContext;
9483
9512
  meta: object;
@@ -13442,6 +13471,82 @@ export type AppRouter = TrpcCoreRouter<{
13442
13471
  meta: object;
13443
13472
  }>;
13444
13473
  }>;
13474
+ apiCatalog: import("@trpc/server/unstable-core-do-not-import").Router<{
13475
+ ctx: any;
13476
+ meta: object;
13477
+ errorShape: AugmentedErrorShape;
13478
+ transformer: true;
13479
+ }, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
13480
+ list: import("@trpc/server").TRPCQueryProcedure<{
13481
+ input: void;
13482
+ output: {
13483
+ methods: {
13484
+ path: string;
13485
+ router: string;
13486
+ method: string;
13487
+ kind: "query" | "mutation" | "subscription";
13488
+ tier: "public" | "protected" | "admin";
13489
+ source: "capability" | "core";
13490
+ scope: {
13491
+ capName: string;
13492
+ capScope: "system" | "device";
13493
+ access: "delete" | "view" | "create";
13494
+ role: string;
13495
+ } | null;
13496
+ hasInput: boolean;
13497
+ callable: "no" | "per-device" | "yes";
13498
+ }[];
13499
+ };
13500
+ meta: object;
13501
+ }>;
13502
+ inputSchema: import("@trpc/server").TRPCQueryProcedure<{
13503
+ input: {
13504
+ path: string;
13505
+ };
13506
+ output: {
13507
+ path: string;
13508
+ hasInput: boolean;
13509
+ schema: Record<string, unknown> | null;
13510
+ error: string | null;
13511
+ };
13512
+ meta: object;
13513
+ }>;
13514
+ }>> & import("@trpc/server").TRPCDecorateCreateRouterOptions<{
13515
+ list: import("@trpc/server").TRPCQueryProcedure<{
13516
+ input: void;
13517
+ output: {
13518
+ methods: {
13519
+ path: string;
13520
+ router: string;
13521
+ method: string;
13522
+ kind: "query" | "mutation" | "subscription";
13523
+ tier: "public" | "protected" | "admin";
13524
+ source: "capability" | "core";
13525
+ scope: {
13526
+ capName: string;
13527
+ capScope: "system" | "device";
13528
+ access: "delete" | "view" | "create";
13529
+ role: string;
13530
+ } | null;
13531
+ hasInput: boolean;
13532
+ callable: "no" | "per-device" | "yes";
13533
+ }[];
13534
+ };
13535
+ meta: object;
13536
+ }>;
13537
+ inputSchema: import("@trpc/server").TRPCQueryProcedure<{
13538
+ input: {
13539
+ path: string;
13540
+ };
13541
+ output: {
13542
+ path: string;
13543
+ hasInput: boolean;
13544
+ schema: Record<string, unknown> | null;
13545
+ error: string | null;
13546
+ };
13547
+ meta: object;
13548
+ }>;
13549
+ }>;
13445
13550
  preferences: import("@trpc/server/unstable-core-do-not-import").Router<{
13446
13551
  ctx: any;
13447
13552
  meta: object;
@@ -5,7 +5,7 @@
5
5
  * `ALL_CAPABILITY_DEFINITIONS` (the whole Zod schema graph, ~+100 MB heap per
6
6
  * runner). See docs/decisions/adr-0028.md.
7
7
  *
8
- * Coverage: 1 advance-derived caps, 88 caps with 471 state leaves, 15 caps with a declared method timeout.
8
+ * Coverage: 1 advance-derived caps, 89 caps with 475 state leaves, 15 caps with a declared method timeout.
9
9
  */
10
10
  /** A bindable scalar in a capability's runtime state. */
11
11
  export interface CapStateLeaf {
@@ -44,6 +44,7 @@ import type { ImageSettingsStatusSchema } from '../capabilities/image-settings.c
44
44
  import type { IntercomStatusSchema } from '../capabilities/intercom.cap.js';
45
45
  import type { LawnMowerControlStatusSchema } from '../capabilities/lawn-mower-control.cap.js';
46
46
  import type { LockControlStatusSchema } from '../capabilities/lock-control.cap.js';
47
+ import type { LowPowerSleepStatusSchema } from '../capabilities/low-power-sleep.cap.js';
47
48
  import type { MediaPlayerStatusSchema } from '../capabilities/media-player.cap.js';
48
49
  import type { MeterStatusSchema } from '../capabilities/meter.cap.js';
49
50
  import type { MotionStatusSchema } from '../capabilities/motion.cap.js';
@@ -138,6 +139,7 @@ export type CapStatusTypeMap = {
138
139
  readonly 'intercom': z.infer<typeof IntercomStatusSchema>;
139
140
  readonly 'lawn-mower-control': z.infer<typeof LawnMowerControlStatusSchema>;
140
141
  readonly 'lock-control': z.infer<typeof LockControlStatusSchema>;
142
+ readonly 'low-power-sleep': z.infer<typeof LowPowerSleepStatusSchema>;
141
143
  readonly 'media-player': z.infer<typeof MediaPlayerStatusSchema>;
142
144
  readonly 'meter': z.infer<typeof MeterStatusSchema>;
143
145
  readonly 'motion': z.infer<typeof MotionStatusSchema>;
@@ -189,4 +191,4 @@ export type CapNameWithStatus = keyof CapStatusTypeMap;
189
191
  * aggregator to enumerate caps whose `status` should be polled +
190
192
  * streamed via `subscribeDeviceStatusAggregate`.
191
193
  */
192
- export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-export", "device-status", "dishwasher", "do-not-disturb", "doorbell", "energy-system", "enum-sensor", "error", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "group-active", "group-commands", "group-status", "heat-pump-status", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "media-player", "meter", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "pet-fountain", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "pump-cycle", "recording-archive", "recording-onboard", "recording-signal", "running-state", "scene-monitor", "script-runner", "siren", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "timed-run", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather", "weather-station", "workload"];
194
+ export declare const CAP_NAMES_WITH_STATUS: readonly ["accessories", "air-quality-sensor", "alarm-panel", "ambient-light-sensor", "automation-control", "battery", "binary", "brightness", "broker", "camera-credentials", "carbon-monoxide", "climate-control", "color", "connectivity", "consumables", "contact", "control", "cover", "day-night", "device-adoption", "device-export", "device-status", "dishwasher", "do-not-disturb", "doorbell", "energy-system", "enum-sensor", "error", "event-emitter", "fan-control", "feature-probe", "flood", "gas", "group-active", "group-commands", "group-status", "heat-pump-status", "heating-valve", "humidifier", "humidity-sensor", "image", "image-settings", "intercom", "lawn-mower-control", "lock-control", "low-power-sleep", "media-player", "meter", "motion", "motion-trigger", "motion-zones", "mqtt-broker", "native-object-detection", "navigation", "network-link", "notifier", "numeric-sensor", "osd", "pet-feeder", "pet-fountain", "power-meter", "presence", "pressure-sensor", "privacy-mask", "ptz", "ptz-autotrack", "pump-cycle", "recording-archive", "recording-onboard", "recording-signal", "running-state", "scene-monitor", "script-runner", "siren", "smoke", "snapshot", "stream-params", "switch", "tamper", "temperature-sensor", "timed-run", "update", "vacuum-control", "valve", "vibration", "water-heater", "weather", "weather-station", "workload"];
@@ -1,7 +1,7 @@
1
1
  import type { CapVocabularyMap } from '../device/cap-vocabulary/types.js';
2
2
  /**
3
3
  * THE cap vocabulary (D920), projected from the declarations of every
4
- * `*.cap.ts` (D1050): 211 caps (109 device, 102 system).
4
+ * `*.cap.ts` (D1050): 213 caps (111 device, 102 system).
5
5
  * Device caps in their declared picker order, then system caps by name.
6
6
  */
7
7
  export declare const CAP_VOCABULARY: CapVocabularyMap;