@camstack/types 1.2.540 → 1.2.541

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 (32) hide show
  1. package/CHANGELOG.md +12 -4
  2. package/dist/addon.js +1 -1
  3. package/dist/addon.mjs +1 -1
  4. package/dist/capabilities/cluster-update.cap.d.ts +376 -0
  5. package/dist/capabilities/device-manager.cap.d.ts +103 -0
  6. package/dist/capabilities/device-search.d.ts +168 -0
  7. package/dist/capabilities/hero-layout.cap.d.ts +4 -0
  8. package/dist/capabilities/hub-address.d.ts +10 -0
  9. package/dist/capabilities/index.d.ts +6 -3
  10. package/dist/capabilities/notification-rules.cap.d.ts +115 -1
  11. package/dist/client.d.ts +2 -1
  12. package/dist/client.js +54 -8
  13. package/dist/client.mjs +54 -9
  14. package/dist/device/container-primary-child.d.ts +39 -4
  15. package/dist/device/device-management.d.ts +9 -0
  16. package/dist/device/hero/hero-model.d.ts +14 -0
  17. package/dist/device/linked-device-resolve.d.ts +2 -0
  18. package/dist/generated/addon-api.d.ts +43 -0
  19. package/dist/generated/capability-router-map.d.ts +5 -2
  20. package/dist/generated/device-proxy.d.ts +1 -1
  21. package/dist/generated/method-access-map.d.ts +1 -1
  22. package/dist/generated/method-device-selectors.d.ts +2 -2
  23. package/dist/generated/system-proxy.d.ts +3 -1
  24. package/dist/index.d.ts +2 -2
  25. package/dist/index.js +507 -22
  26. package/dist/index.mjs +478 -23
  27. package/dist/notification/degrade-engine.d.ts +7 -1
  28. package/dist/notification/notification-fields.d.ts +20 -2
  29. package/dist/notification/timelapse-rule.d.ts +69 -0
  30. package/dist/{sleep-Dz1P6--1.mjs → sleep-Cw1uUXvl.mjs} +3 -0
  31. package/dist/{sleep-DPMn-Sik.js → sleep-PfAAmxV-.js} +3 -0
  32. package/package.json +1 -1
package/dist/client.js CHANGED
@@ -23765,13 +23765,23 @@ var NcRuleTargetSchema = zod.z.object({
23765
23765
  */
23766
23766
  params: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
23767
23767
  });
23768
+ /** Which picture kind one target receives (#487). */
23769
+ var NcTargetAttachmentSchema = zod.z.enum([
23770
+ "none",
23771
+ "image",
23772
+ "clip",
23773
+ "gif"
23774
+ ]);
23768
23775
  var NcTargetOverrideSchema = zod.z.object({
23769
23776
  template: zod.z.object({
23770
23777
  title: zod.z.string().max(500).optional(),
23771
23778
  body: zod.z.string().max(2e3).optional()
23772
23779
  }).optional(),
23773
23780
  schedule: NcScheduleSchema.optional(),
23774
- priority: zod.z.number().int().min(1).max(5).optional()
23781
+ priority: zod.z.number().int().min(1).max(5).optional(),
23782
+ attachment: NcTargetAttachmentSchema.optional(),
23783
+ /** `false` = no buttons for this target; `true` is the same as absent. */
23784
+ actions: zod.z.boolean().optional()
23775
23785
  });
23776
23786
  /** Per-target settings keyed by target id (#487). */
23777
23787
  var NcTargetOverridesSchema = zod.z.record(zod.z.string(), NcTargetOverrideSchema);
@@ -26575,9 +26585,11 @@ function remoteRoleLabel(role, locale) {
26575
26585
  * priority-in-sync.ts` fails the build when either drifts — the comment that
26576
26586
  * used to ask for this could not.
26577
26587
  *
26578
- * The rule has three halves and the ORDER matters: an operator's explicit pick
26579
- * wins outright; else a declaration on the device type
26580
- * ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
26588
+ * The rule has four steps and the ORDER matters: an operator's explicit pick
26589
+ * wins outright; else the container's own declaration, an ordered list of
26590
+ * child keys its provider stamped at create
26591
+ * ({@link ContainerPrimaryChildPreference}); else a declaration on the device
26592
+ * type ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
26581
26593
  * priority. The pick is keyed on the child's re-sync-stable `entityId`, not
26582
26594
  * its numeric id, so it survives a re-sync that reallocates ids.
26583
26595
  */
@@ -26590,6 +26602,25 @@ var CONTAINER_PRIMARY_CHILD_RULES = [{
26590
26602
  deviceType: DeviceType.HeatPump,
26591
26603
  primary: "self"
26592
26604
  }];
26605
+ /** The declaration of a container read from its meta, or undefined when it declared none. */
26606
+ function primaryChildPreferenceOf(container) {
26607
+ const keys = container.primaryChildPreference;
26608
+ if (container.stableId === void 0 || keys === void 0 || keys === null) return void 0;
26609
+ if (keys.length === 0) return void 0;
26610
+ return {
26611
+ parentStableId: container.stableId,
26612
+ childKeys: keys
26613
+ };
26614
+ }
26615
+ /** The first declared child that exists, or undefined when none does. */
26616
+ function applyPrimaryChildPreference(preference, children) {
26617
+ if (preference === void 0) return void 0;
26618
+ for (const key of preference.childKeys) {
26619
+ const expected = `${preference.parentStableId}-${key}`;
26620
+ const match = children.find((child) => child.stableId === expected);
26621
+ if (match !== void 0) return match;
26622
+ }
26623
+ }
26593
26624
  /**
26594
26625
  * The type declaration, before the heuristic. `fall-through` means the
26595
26626
  * heuristic still decides: the type declared nothing, or it named a child
@@ -26697,7 +26728,8 @@ function rank(type) {
26697
26728
  }
26698
26729
  /**
26699
26730
  * The child a container stands for: the operator's pick when it still exists,
26700
- * else the device type's declaration, else the highest-priority type. `null`
26731
+ * else the container's declared preference, else the device type's
26732
+ * declaration, else the highest-priority type. `null`
26701
26733
  * for a childless container, and for a type that stands for itself — a caller
26702
26734
  * must decide what "no child" means for it, rather than being handed a child
26703
26735
  * that is not the device.
@@ -26729,11 +26761,13 @@ function sameName(childName, containerName) {
26729
26761
  const flatten = (v) => v.toLowerCase().replace(/[-_\s]+/g, " ").trim();
26730
26762
  return flatten(childName) === flatten(containerName);
26731
26763
  }
26732
- function resolveContainerPrimaryChild(children, overrideEntityId, containerName, containerType) {
26764
+ function resolveContainerPrimaryChild(children, overrideEntityId, containerName, containerType, preference) {
26733
26765
  if (overrideEntityId !== void 0 && overrideEntityId !== null) {
26734
26766
  const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
26735
26767
  if (picked !== void 0) return picked;
26736
26768
  }
26769
+ const preferred = applyPrimaryChildPreference(preference, children);
26770
+ if (preferred !== void 0) return preferred;
26737
26771
  const declared = applyPrimaryChildRule(CONTAINER_PRIMARY_CHILD_RULES.find((entry) => entry.deviceType === containerType), children);
26738
26772
  if (declared.kind === "none") return null;
26739
26773
  if (declared.kind === "child") return declared.child;
@@ -27645,6 +27679,7 @@ function createDeviceProxy(api, binding, opts) {
27645
27679
  setLinkDeviceId: (input) => dispatchSystem("deviceManager", "setLinkDeviceId", "mutation", input),
27646
27680
  setPrimaryChildEntityId: (input) => dispatchSystem("deviceManager", "setPrimaryChildEntityId", "mutation", input),
27647
27681
  setChildLayout: (input) => dispatchSystem("deviceManager", "setChildLayout", "mutation", input),
27682
+ setPrimaryChildPreference: (input) => dispatchSystem("deviceManager", "setPrimaryChildPreference", "mutation", input),
27648
27683
  setDisplay: (input) => dispatchSystem("deviceManager", "setDisplay", "mutation", input),
27649
27684
  getWireableFields: (input) => dispatchSystem("deviceManager", "getWireableFields", "query", input),
27650
27685
  setRole: (input) => dispatchSystem("deviceManager", "setRole", "mutation", input),
@@ -28801,6 +28836,11 @@ function createSystemProxy(api) {
28801
28836
  getPreferences: (input) => dispatch("calendars", "getPreferences", "query", input),
28802
28837
  setCalendarPreference: (input) => dispatch("calendars", "setCalendarPreference", "mutation", input)
28803
28838
  },
28839
+ clusterUpdate: {
28840
+ previewClusterUpdate: (input) => dispatch("clusterUpdate", "previewClusterUpdate", "query", input),
28841
+ startClusterUpdate: (input) => dispatch("clusterUpdate", "startClusterUpdate", "mutation", input),
28842
+ getClusterUpdateJob: (input) => dispatch("clusterUpdate", "getClusterUpdateJob", "query", input)
28843
+ },
28804
28844
  coreBlocks: {
28805
28845
  list: (input) => dispatch("coreBlocks", "list", "query", input),
28806
28846
  get: (input) => dispatch("coreBlocks", "get", "query", input),
@@ -28896,6 +28936,7 @@ function createSystemProxy(api) {
28896
28936
  setLocationZone: (input) => dispatch("deviceManager", "setLocationZone", "mutation", input),
28897
28937
  listPersistedByAddon: (input) => dispatch("deviceManager", "listPersistedByAddon", "query", input),
28898
28938
  listAll: (input) => dispatch("deviceManager", "listAll", "query", input),
28939
+ search: (input) => dispatch("deviceManager", "search", "query", input),
28899
28940
  getChildren: (input) => dispatch("deviceManager", "getChildren", "query", input),
28900
28941
  getChildrenBatch: (input) => dispatch("deviceManager", "getChildrenBatch", "query", input),
28901
28942
  getLinkedDevicesBatch: (input) => dispatch("deviceManager", "getLinkedDevicesBatch", "query", input),
@@ -32966,7 +33007,9 @@ var TimelapseRuleInputSchema = zod.z.object({
32966
33007
  /** Classes the notification counts — see {@link ReportClassesField}. */
32967
33008
  reportClasses: ReportClassesField.optional(),
32968
33009
  /** Canonical notification priority ordinal (1..5); per-target overridable. */
32969
- priority: PriorityField.default(3)
33010
+ priority: PriorityField.default(3),
33011
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33012
+ targetOverrides: NcTargetOverridesSchema.optional()
32970
33013
  });
32971
33014
  /**
32972
33015
  * The caption a rule that never set one gets.
@@ -32990,7 +33033,9 @@ zod.z.object({
32990
33033
  previewText: PreviewTextField.optional(),
32991
33034
  previewMode: PreviewModeField.optional(),
32992
33035
  reportClasses: ReportClassesField.optional(),
32993
- priority: PriorityField.optional()
33036
+ priority: PriorityField.optional(),
33037
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33038
+ targetOverrides: NcTargetOverridesSchema.optional()
32994
33039
  });
32995
33040
  /** A persisted timelapse rule. */
32996
33041
  var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
@@ -33125,6 +33170,7 @@ exports.parseDeviceEnrollmentLink = parseDeviceEnrollmentLink;
33125
33170
  exports.parseRetrainRevisionConflict = parseRetrainRevisionConflict;
33126
33171
  exports.pickerForCondition = pickerForCondition;
33127
33172
  exports.pickerForRuleClasses = pickerForRuleClasses;
33173
+ exports.primaryChildPreferenceOf = primaryChildPreferenceOf;
33128
33174
  exports.projectSubjectPath = projectSubjectPath;
33129
33175
  exports.remoteRoleIcon = remoteRoleIcon;
33130
33176
  exports.remoteRoleLabel = remoteRoleLabel;
package/dist/client.mjs CHANGED
@@ -23764,13 +23764,23 @@ var NcRuleTargetSchema = z.object({
23764
23764
  */
23765
23765
  params: z.record(z.string(), z.unknown()).optional()
23766
23766
  });
23767
+ /** Which picture kind one target receives (#487). */
23768
+ var NcTargetAttachmentSchema = z.enum([
23769
+ "none",
23770
+ "image",
23771
+ "clip",
23772
+ "gif"
23773
+ ]);
23767
23774
  var NcTargetOverrideSchema = z.object({
23768
23775
  template: z.object({
23769
23776
  title: z.string().max(500).optional(),
23770
23777
  body: z.string().max(2e3).optional()
23771
23778
  }).optional(),
23772
23779
  schedule: NcScheduleSchema.optional(),
23773
- priority: z.number().int().min(1).max(5).optional()
23780
+ priority: z.number().int().min(1).max(5).optional(),
23781
+ attachment: NcTargetAttachmentSchema.optional(),
23782
+ /** `false` = no buttons for this target; `true` is the same as absent. */
23783
+ actions: z.boolean().optional()
23774
23784
  });
23775
23785
  /** Per-target settings keyed by target id (#487). */
23776
23786
  var NcTargetOverridesSchema = z.record(z.string(), NcTargetOverrideSchema);
@@ -26574,9 +26584,11 @@ function remoteRoleLabel(role, locale) {
26574
26584
  * priority-in-sync.ts` fails the build when either drifts — the comment that
26575
26585
  * used to ask for this could not.
26576
26586
  *
26577
- * The rule has three halves and the ORDER matters: an operator's explicit pick
26578
- * wins outright; else a declaration on the device type
26579
- * ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
26587
+ * The rule has four steps and the ORDER matters: an operator's explicit pick
26588
+ * wins outright; else the container's own declaration, an ordered list of
26589
+ * child keys its provider stamped at create
26590
+ * ({@link ContainerPrimaryChildPreference}); else a declaration on the device
26591
+ * type ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
26580
26592
  * priority. The pick is keyed on the child's re-sync-stable `entityId`, not
26581
26593
  * its numeric id, so it survives a re-sync that reallocates ids.
26582
26594
  */
@@ -26589,6 +26601,25 @@ var CONTAINER_PRIMARY_CHILD_RULES = [{
26589
26601
  deviceType: DeviceType.HeatPump,
26590
26602
  primary: "self"
26591
26603
  }];
26604
+ /** The declaration of a container read from its meta, or undefined when it declared none. */
26605
+ function primaryChildPreferenceOf(container) {
26606
+ const keys = container.primaryChildPreference;
26607
+ if (container.stableId === void 0 || keys === void 0 || keys === null) return void 0;
26608
+ if (keys.length === 0) return void 0;
26609
+ return {
26610
+ parentStableId: container.stableId,
26611
+ childKeys: keys
26612
+ };
26613
+ }
26614
+ /** The first declared child that exists, or undefined when none does. */
26615
+ function applyPrimaryChildPreference(preference, children) {
26616
+ if (preference === void 0) return void 0;
26617
+ for (const key of preference.childKeys) {
26618
+ const expected = `${preference.parentStableId}-${key}`;
26619
+ const match = children.find((child) => child.stableId === expected);
26620
+ if (match !== void 0) return match;
26621
+ }
26622
+ }
26592
26623
  /**
26593
26624
  * The type declaration, before the heuristic. `fall-through` means the
26594
26625
  * heuristic still decides: the type declared nothing, or it named a child
@@ -26696,7 +26727,8 @@ function rank(type) {
26696
26727
  }
26697
26728
  /**
26698
26729
  * The child a container stands for: the operator's pick when it still exists,
26699
- * else the device type's declaration, else the highest-priority type. `null`
26730
+ * else the container's declared preference, else the device type's
26731
+ * declaration, else the highest-priority type. `null`
26700
26732
  * for a childless container, and for a type that stands for itself — a caller
26701
26733
  * must decide what "no child" means for it, rather than being handed a child
26702
26734
  * that is not the device.
@@ -26728,11 +26760,13 @@ function sameName(childName, containerName) {
26728
26760
  const flatten = (v) => v.toLowerCase().replace(/[-_\s]+/g, " ").trim();
26729
26761
  return flatten(childName) === flatten(containerName);
26730
26762
  }
26731
- function resolveContainerPrimaryChild(children, overrideEntityId, containerName, containerType) {
26763
+ function resolveContainerPrimaryChild(children, overrideEntityId, containerName, containerType, preference) {
26732
26764
  if (overrideEntityId !== void 0 && overrideEntityId !== null) {
26733
26765
  const picked = children.find((c) => c.stableId === overrideEntityId) ?? children.find((c) => c.entityId !== void 0 && c.entityId === overrideEntityId);
26734
26766
  if (picked !== void 0) return picked;
26735
26767
  }
26768
+ const preferred = applyPrimaryChildPreference(preference, children);
26769
+ if (preferred !== void 0) return preferred;
26736
26770
  const declared = applyPrimaryChildRule(CONTAINER_PRIMARY_CHILD_RULES.find((entry) => entry.deviceType === containerType), children);
26737
26771
  if (declared.kind === "none") return null;
26738
26772
  if (declared.kind === "child") return declared.child;
@@ -27644,6 +27678,7 @@ function createDeviceProxy(api, binding, opts) {
27644
27678
  setLinkDeviceId: (input) => dispatchSystem("deviceManager", "setLinkDeviceId", "mutation", input),
27645
27679
  setPrimaryChildEntityId: (input) => dispatchSystem("deviceManager", "setPrimaryChildEntityId", "mutation", input),
27646
27680
  setChildLayout: (input) => dispatchSystem("deviceManager", "setChildLayout", "mutation", input),
27681
+ setPrimaryChildPreference: (input) => dispatchSystem("deviceManager", "setPrimaryChildPreference", "mutation", input),
27647
27682
  setDisplay: (input) => dispatchSystem("deviceManager", "setDisplay", "mutation", input),
27648
27683
  getWireableFields: (input) => dispatchSystem("deviceManager", "getWireableFields", "query", input),
27649
27684
  setRole: (input) => dispatchSystem("deviceManager", "setRole", "mutation", input),
@@ -28800,6 +28835,11 @@ function createSystemProxy(api) {
28800
28835
  getPreferences: (input) => dispatch("calendars", "getPreferences", "query", input),
28801
28836
  setCalendarPreference: (input) => dispatch("calendars", "setCalendarPreference", "mutation", input)
28802
28837
  },
28838
+ clusterUpdate: {
28839
+ previewClusterUpdate: (input) => dispatch("clusterUpdate", "previewClusterUpdate", "query", input),
28840
+ startClusterUpdate: (input) => dispatch("clusterUpdate", "startClusterUpdate", "mutation", input),
28841
+ getClusterUpdateJob: (input) => dispatch("clusterUpdate", "getClusterUpdateJob", "query", input)
28842
+ },
28803
28843
  coreBlocks: {
28804
28844
  list: (input) => dispatch("coreBlocks", "list", "query", input),
28805
28845
  get: (input) => dispatch("coreBlocks", "get", "query", input),
@@ -28895,6 +28935,7 @@ function createSystemProxy(api) {
28895
28935
  setLocationZone: (input) => dispatch("deviceManager", "setLocationZone", "mutation", input),
28896
28936
  listPersistedByAddon: (input) => dispatch("deviceManager", "listPersistedByAddon", "query", input),
28897
28937
  listAll: (input) => dispatch("deviceManager", "listAll", "query", input),
28938
+ search: (input) => dispatch("deviceManager", "search", "query", input),
28898
28939
  getChildren: (input) => dispatch("deviceManager", "getChildren", "query", input),
28899
28940
  getChildrenBatch: (input) => dispatch("deviceManager", "getChildrenBatch", "query", input),
28900
28941
  getLinkedDevicesBatch: (input) => dispatch("deviceManager", "getLinkedDevicesBatch", "query", input),
@@ -32965,7 +33006,9 @@ var TimelapseRuleInputSchema = z.object({
32965
33006
  /** Classes the notification counts — see {@link ReportClassesField}. */
32966
33007
  reportClasses: ReportClassesField.optional(),
32967
33008
  /** Canonical notification priority ordinal (1..5); per-target overridable. */
32968
- priority: PriorityField.default(3)
33009
+ priority: PriorityField.default(3),
33010
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33011
+ targetOverrides: NcTargetOverridesSchema.optional()
32969
33012
  });
32970
33013
  /**
32971
33014
  * The caption a rule that never set one gets.
@@ -32989,7 +33032,9 @@ z.object({
32989
33032
  previewText: PreviewTextField.optional(),
32990
33033
  previewMode: PreviewModeField.optional(),
32991
33034
  reportClasses: ReportClassesField.optional(),
32992
- priority: PriorityField.optional()
33035
+ priority: PriorityField.optional(),
33036
+ /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33037
+ targetOverrides: NcTargetOverridesSchema.optional()
32993
33038
  });
32994
33039
  /** A persisted timelapse rule. */
32995
33040
  var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
@@ -33029,4 +33074,4 @@ var TimelapseRuleSchema = TimelapseRuleInputSchema.extend({
33029
33074
  updatedAt: z.number()
33030
33075
  });
33031
33076
  //#endregion
33032
- export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CONTAINER_PRIMARY_CHILD_RULES, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, REMOTE_CUSTOM_ROLE_ICON, REMOTE_ROLE_VOCABULARY, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, bundledCamstack, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, paintHex, paletteResultSchema, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, projectSubjectPath, remoteRoleIcon, remoteRoleLabel, remoteRoleLegend, resolveContainerPrimaryChild, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };
33077
+ export { APPLE_SA_TO_MACRO, AUDIO_MACRO_LABELS, AlarmArmModeSchema, CLIP_BROKER_PACED_RATES, COCO_TO_MACRO, CONTAINER_PRIMARY_CHILD_RULES, CamProfileSchema, DEFAULT_TIMELAPSE_PREVIEW_TEXT, DEFINITIVE_DEVICE_REFUSALS, DEVICE_CERT_RENEW_WINDOW_DAYS, DEVICE_CERT_SIGNATURE, DEVICE_DEFINITIVE_REFUSALS_BEFORE_DELETE, DEVICE_REFRESH_REFUSAL_PREFIX, DEVICE_SIGNATURE_MESSAGE_VERSION, DeviceType, EVENTFUL_CAP_NAMES, EVENT_KIND_BY_CAP, EVENT_TAXONOMY, ICON_CATEGORIES, ICON_ENTRIES, ICON_KEYS, ICON_VIEWER_MODULES, IconKeySchema, LOCATION_ICON_FALLBACK, MACRO_LABELS, NC_ALARM_DELAY_MAX_SEC, NC_ALARM_SENSORS_MAX, NC_ALARM_SYSTEM_EVENT_KINDS, NC_ALARM_TRIGGERED_MAX_SEC, NC_BATTERY_CONSUMABLE_SYSTEM_EVENT_KINDS, NC_CAMERA_SCOPE_CAP_NAME, NC_CONSUMABLE_LOW_PERCENT_DEFAULT, NC_CONSUMABLE_LOW_PERCENT_MAX, NC_GROUPING_DEFAULT_SEC, NC_GROUPING_MAX_SEC, NC_GROUPING_MIN_SEC, NC_RULE_EDITOR_SECTION_ORDER, NC_RULE_KIND_SPECS, NC_SENSOR_TRANSITION_UNSUPPORTED_REASON, NC_SYSTEM_EVENT_CLASS_SPECS, NC_SYSTEM_EVENT_FAMILY_FILTERS, NC_SYSTEM_EVENT_KIND_GROUP_SPECS, NC_SYSTEM_EVENT_SUMMARY_FAMILIES, NC_TEMPLATE_HELD_BACK_SYSTEM_EVENT_KINDS, NC_TEMPLATE_VARS, NcAlarmConfigSchema, NcAlarmSensorsSchema, NcAlarmSettingsPatchSchema, NcHistoryEntrySchema, NcRuleLastRunsSchema, NodeDirectorySchema, RECORDING_EXPORT_MAX_READ_BYTES, REMOTE_CUSTOM_ROLE_ICON, REMOTE_ROLE_VOCABULARY, RETRAIN_REVIEW_ADJUSTED_IOU, RETRAIN_REVIEW_MATCH_IOU, RETRAIN_REVIEW_STATUSES, RETRAIN_REVISION_CONFLICT, SystemMirror, TIMELAPSE_DENSE_FLOOR_SEC, TimelapseRuleSchema, YAMNET_TO_MACRO, alarmDeviceBlocksArming, alarmDeviceSecureOnArm, alarmPatchLanded, buildDeviceEnrollmentLink, buildDeviceSignatureMessage, buildSubjectPath, bundledCamstack, canonicalIconKey, classifyRetrainReview, conditionVisibleForKind, createSystemProxy, deviceRefusalFromMessage, droppedConditionsForKind, expandSystemEventClasses, iconCategoryLabel, iconEntry, iconsInCategory, isDefinitiveDeviceRefusal, isDrawableSubjectPath, isHeldBackTemplateVar, isIconKey, isSystemRuleKind, kindsForDiscriminator, knownValues, locationIconKey, nodePickerItems, packagePickerItems, paintHex, paletteResultSchema, parseDeviceEnrollmentLink, parseRetrainRevisionConflict, pickerForCondition, pickerForRuleClasses, primaryChildPreferenceOf, projectSubjectPath, remoteRoleIcon, remoteRoleLabel, remoteRoleLegend, resolveContainerPrimaryChild, resolveIconKey, resolveModeDelays, retrainBoxIou, retrainRevisionConflictMessage, ruleDeviceCompatCapNames, ruleEditorSectionsForKind, ruleGroupingApplies, ruleKindOf, ruleKindSpec, ruleSeedForSection, searchIcons, sensorTransitionNeverFires, sensorTransitionOffered, stateLabel, subjectPathSampleFromBox, subjectPathSvgPoints, summarizeReview, systemEventClassKinds, systemEventClassesFor, systemEventDeliveryProblems, systemEventFilterAppliesToAnyKind, systemEventKindsOfFamily, systemFamilyOfKind, templateCarriesSummary, templateVarDeliveryApplies, templateVarKindApplies, templateVarSystemEventApplies, withSystemEventClasses };
@@ -23,9 +23,11 @@
23
23
  * priority-in-sync.ts` fails the build when either drifts — the comment that
24
24
  * used to ask for this could not.
25
25
  *
26
- * The rule has three halves and the ORDER matters: an operator's explicit pick
27
- * wins outright; else a declaration on the device type
28
- * ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
26
+ * The rule has four steps and the ORDER matters: an operator's explicit pick
27
+ * wins outright; else the container's own declaration, an ordered list of
28
+ * child keys its provider stamped at create
29
+ * ({@link ContainerPrimaryChildPreference}); else a declaration on the device
30
+ * type ({@link CONTAINER_PRIMARY_CHILD_RULES}); else role, namesake, then type
29
31
  * priority. The pick is keyed on the child's re-sync-stable `entityId`, not
30
32
  * its numeric id, so it survives a re-sync that reallocates ids.
31
33
  */
@@ -51,6 +53,32 @@ export interface ContainerPrimaryChildRule {
51
53
  * otherwise pick.
52
54
  */
53
55
  export declare const CONTAINER_PRIMARY_CHILD_RULES: readonly ContainerPrimaryChildRule[];
56
+ /**
57
+ * What one CONTAINER declares it stands for, in preference order.
58
+ *
59
+ * A device type cannot tell a vendor's children apart when they all share one
60
+ * type (an energy installation whose PV, battery and house readings are all
61
+ * `sensor` children). The provider knows, so it stamps an ordered list of
62
+ * accessory `childKey`s (the `stableIdSuffix` it spawned each child with) on
63
+ * the container's meta (`DeviceMeta.primaryChildPreference`). The first key
64
+ * whose child exists wins. A child matches when its `stableId` is
65
+ * `${parentStableId}-${childKey}`, the convention `childLayout` uses.
66
+ */
67
+ export interface ContainerPrimaryChildPreference {
68
+ /** The container's own `stableId`. */
69
+ readonly parentStableId: string;
70
+ /** Accessory `childKey`s, most preferred first. */
71
+ readonly childKeys: readonly string[];
72
+ }
73
+ /** The slice of a container's meta its declaration is read from. */
74
+ export interface ContainerPreferenceSource {
75
+ readonly stableId?: string | undefined;
76
+ readonly primaryChildPreference?: readonly string[] | null | undefined;
77
+ }
78
+ /** The declaration of a container read from its meta, or undefined when it declared none. */
79
+ export declare function primaryChildPreferenceOf(container: ContainerPreferenceSource): ContainerPrimaryChildPreference | undefined;
80
+ /** The first declared child that exists, or undefined when none does. */
81
+ export declare function applyPrimaryChildPreference(preference: ContainerPrimaryChildPreference | undefined, children: readonly ContainerChildRef[]): ContainerChildRef | undefined;
54
82
  export type AppliedPrimaryChildRule = {
55
83
  readonly kind: 'fall-through';
56
84
  } | {
@@ -122,4 +150,11 @@ export interface ContainerChildRef {
122
150
  * they are deliberately absent and fall through to type priority.
123
151
  */
124
152
  export declare const CONTAINER_CHILD_ROLE_PRIORITY: readonly string[];
125
- export declare function resolveContainerPrimaryChild(children: readonly ContainerChildRef[], overrideEntityId: string | null | undefined, containerName: string | undefined, containerType: string | undefined): ContainerChildRef | null;
153
+ export declare function resolveContainerPrimaryChild(children: readonly ContainerChildRef[], overrideEntityId: string | null | undefined, containerName: string | undefined, containerType: string | undefined,
154
+ /**
155
+ * The container's own declaration (`primaryChildPreferenceOf(container)`).
156
+ * Required, `undefined` when the container declared none: a caller that
157
+ * forgets it would silently answer the heuristic's child instead of the one
158
+ * the provider named, so the compiler must find every caller.
159
+ */
160
+ preference: ContainerPrimaryChildPreference | undefined): ContainerChildRef | null;
@@ -178,6 +178,12 @@ export interface DeviceMeta {
178
178
  * same lifecycle as `primaryChildEntityId`. Absent ⇒ no layout declared (all
179
179
  * children render in the plain Overview list). */
180
180
  readonly childLayout?: ChildLayout;
181
+ /** Which children a CONTAINER stands for, most preferred first, as accessory
182
+ * `childKey`s (the child's `stableIdSuffix`). Declared by the PROVIDER at
183
+ * create, so the pick does not depend on the order children come back in;
184
+ * the operator's `primaryChildEntityId` still wins. Same create/persist/
185
+ * project/restore lifecycle as `childLayout`. Absent ⇒ no declaration. */
186
+ readonly primaryChildPreference?: readonly string[];
181
187
  /** Operator-authored per-device display override (icon/label/unit/precision/
182
188
  * hidden). Same create/persist/project/restore lifecycle as `childLayout`.
183
189
  * Absent ⇒ no override; the renderer falls back to role default → live slice
@@ -212,6 +218,9 @@ export interface InitialDeviceMeta {
212
218
  * across re-register/restore. Optional: only set for CONTAINER devices that
213
219
  * declare a layout. */
214
220
  readonly childLayout?: ChildLayout;
221
+ /** The children a CONTAINER stands for, most preferred first, by accessory
222
+ * `childKey`. Mirrors `DeviceMeta.primaryChildPreference`. */
223
+ readonly primaryChildPreference?: readonly string[];
215
224
  /** Per-device display override set at create. Mirrors `DeviceMeta.display`. */
216
225
  readonly display?: DeviceDisplayOverride;
217
226
  }
@@ -249,6 +249,12 @@ export interface HeroPill {
249
249
  }
250
250
  /** Declared by its interface: a `z.infer` of one more icon union pushes the cap's inferred type past what the compiler can print. */
251
251
  export declare const HeroPillSchema: z.ZodType<HeroPill>;
252
+ /**
253
+ * Rows whose action and slider controls belong ON the scene (the curtain's buttons, the
254
+ * lock's key, the player's transport) and not in a row under it. The model says it, so
255
+ * every client draws the same placement; a control of another kind stays in a row.
256
+ */
257
+ export declare const HERO_SCENE_ROW_IDS: ReadonlySet<HeroRowId>;
252
258
  export declare const HeroRowSchema: z.ZodObject<{
253
259
  id: z.ZodEnum<{
254
260
  alarm: "alarm";
@@ -290,6 +296,10 @@ export declare const HeroRowSchema: z.ZodObject<{
290
296
  valve: "valve";
291
297
  volume: "volume";
292
298
  }>;
299
+ placement: z.ZodOptional<z.ZodEnum<{
300
+ row: "row";
301
+ scene: "scene";
302
+ }>>;
293
303
  label: z.ZodOptional<z.ZodObject<{
294
304
  en: z.ZodString;
295
305
  it: z.ZodString;
@@ -1404,6 +1414,10 @@ export declare const HeroModelSchema: z.ZodObject<{
1404
1414
  valve: "valve";
1405
1415
  volume: "volume";
1406
1416
  }>;
1417
+ placement: z.ZodOptional<z.ZodEnum<{
1418
+ row: "row";
1419
+ scene: "scene";
1420
+ }>>;
1407
1421
  label: z.ZodOptional<z.ZodObject<{
1408
1422
  en: z.ZodString;
1409
1423
  it: z.ZodString;
@@ -25,6 +25,8 @@ export interface LinkCandidate {
25
25
  readonly stableId: string;
26
26
  /** The container's own operator pick, when one was made. */
27
27
  readonly primaryChildEntityId?: string | null;
28
+ /** The container's provider-declared preference (accessory `childKey`s). A JSON column. */
29
+ readonly primaryChildPreference?: readonly string[] | null;
28
30
  /**
29
31
  * The child's `DeviceRole`. Ranked ABOVE `type` when a container picks the
30
32
  * child it stands for, because `DeviceType` cannot tell a door contact from a
@@ -31,6 +31,7 @@ import type { cameraCredentialsCapability } from '../capabilities/camera-credent
31
31
  import type { cameraGridLayoutCapability } from '../capabilities/camera-grid-layout.cap.js';
32
32
  import type { cameraStreamsCapability } from '../capabilities/camera-streams.cap.js';
33
33
  import type { climateControlCapability } from '../capabilities/climate-control.cap.js';
34
+ import type { clusterUpdateCapability } from '../capabilities/cluster-update.cap.js';
34
35
  import type { colorCapability } from '../capabilities/color.cap.js';
35
36
  import type { composerCapability } from '../capabilities/composer.cap.js';
36
37
  import type { consumablesCapability } from '../capabilities/consumables.cap.js';
@@ -1603,6 +1604,34 @@ export type AppRouter = TrpcCoreRouter<{
1603
1604
  meta: object;
1604
1605
  }>;
1605
1606
  }>>;
1607
+ clusterUpdate: TRPCBuiltRouter<{
1608
+ ctx: TrpcContext;
1609
+ meta: object;
1610
+ errorShape: AugmentedErrorShape;
1611
+ transformer: true;
1612
+ }, TRPCDecorateCreateRouterOptions<{
1613
+ previewClusterUpdate: TRPCQueryProcedure<{
1614
+ input: {
1615
+ [x: string]: unknown;
1616
+ } & z.input<typeof clusterUpdateCapability.methods.previewClusterUpdate.input>;
1617
+ output: z.infer<typeof clusterUpdateCapability.methods.previewClusterUpdate.output>;
1618
+ meta: object;
1619
+ }>;
1620
+ startClusterUpdate: TRPCMutationProcedure<{
1621
+ input: {
1622
+ [x: string]: unknown;
1623
+ } & z.input<typeof clusterUpdateCapability.methods.startClusterUpdate.input>;
1624
+ output: z.infer<typeof clusterUpdateCapability.methods.startClusterUpdate.output>;
1625
+ meta: object;
1626
+ }>;
1627
+ getClusterUpdateJob: TRPCQueryProcedure<{
1628
+ input: {
1629
+ [x: string]: unknown;
1630
+ } & z.input<typeof clusterUpdateCapability.methods.getClusterUpdateJob.input>;
1631
+ output: z.infer<typeof clusterUpdateCapability.methods.getClusterUpdateJob.output>;
1632
+ meta: object;
1633
+ }>;
1634
+ }>>;
1606
1635
  color: TRPCBuiltRouter<{
1607
1636
  ctx: TrpcContext;
1608
1637
  meta: object;
@@ -2733,6 +2762,13 @@ export type AppRouter = TrpcCoreRouter<{
2733
2762
  output: z.infer<typeof deviceManagerCapability.methods.setChildLayout.output>;
2734
2763
  meta: object;
2735
2764
  }>;
2765
+ setPrimaryChildPreference: TRPCMutationProcedure<{
2766
+ input: {
2767
+ [x: string]: unknown;
2768
+ } & z.input<typeof deviceManagerCapability.methods.setPrimaryChildPreference.input>;
2769
+ output: z.infer<typeof deviceManagerCapability.methods.setPrimaryChildPreference.output>;
2770
+ meta: object;
2771
+ }>;
2736
2772
  setDisplay: TRPCMutationProcedure<{
2737
2773
  input: {
2738
2774
  [x: string]: unknown;
@@ -2894,6 +2930,13 @@ export type AppRouter = TrpcCoreRouter<{
2894
2930
  output: z.infer<typeof deviceManagerCapability.methods.listAll.output>;
2895
2931
  meta: object;
2896
2932
  }>;
2933
+ search: TRPCQueryProcedure<{
2934
+ input: {
2935
+ [x: string]: unknown;
2936
+ } & z.input<typeof deviceManagerCapability.methods.search.input>;
2937
+ output: z.infer<typeof deviceManagerCapability.methods.search.output>;
2938
+ meta: object;
2939
+ }>;
2897
2940
  getDevice: TRPCQueryProcedure<{
2898
2941
  input: {
2899
2942
  [x: string]: unknown;
@@ -34,6 +34,7 @@ export { cameraPipelineConfigCapability } from '../capabilities/camera-pipeline-
34
34
  export { cameraStreamsCapability } from '../capabilities/camera-streams.cap.js';
35
35
  export { carbonMonoxideCapability } from '../capabilities/carbon-monoxide.cap.js';
36
36
  export { climateControlCapability } from '../capabilities/climate-control.cap.js';
37
+ export { clusterUpdateCapability } from '../capabilities/cluster-update.cap.js';
37
38
  export { colorCapability } from '../capabilities/color.cap.js';
38
39
  export { composerCapability } from '../capabilities/composer.cap.js';
39
40
  export { connectivityCapability } from '../capabilities/connectivity.cap.js';
@@ -240,6 +241,7 @@ export declare const CAPABILITY_NAMES: {
240
241
  readonly cameraStreams: 'camera-streams';
241
242
  readonly carbonMonoxide: 'carbon-monoxide';
242
243
  readonly climateControl: 'climate-control';
244
+ readonly clusterUpdate: 'cluster-update';
243
245
  readonly color: 'color';
244
246
  readonly composer: 'composer';
245
247
  readonly connectivity: 'connectivity';
@@ -459,6 +461,7 @@ export interface CapabilityRouterMap<TRouter = unknown> {
459
461
  readonly cameraStreams: TRouter;
460
462
  readonly carbonMonoxide: TRouter;
461
463
  readonly climateControl: TRouter;
464
+ readonly clusterUpdate: TRouter;
462
465
  readonly color: TRouter;
463
466
  readonly composer: TRouter;
464
467
  readonly connectivity: TRouter;
@@ -629,8 +632,8 @@ export interface CapabilityRouterMap<TRouter = unknown> {
629
632
  readonly zoneRules: TRouter;
630
633
  readonly zones: TRouter;
631
634
  }
632
- /** Capability names whose mode is `singleton` (165 caps). */
633
- export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
635
+ /** Capability names whose mode is `singleton` (166 caps). */
636
+ export declare const SINGLETON_CAPABILITY_NAMES: readonly ['accessories', 'actions', 'addon-pages', 'addon-settings', 'addon-widgets', 'addons', 'admin-ui', 'air-quality-sensor', 'alarm-panel', 'alerts', 'ambient-light-sensor', 'audio-analysis', 'audio-analyzer', 'audio-codec', 'audio-metrics', 'automation-control', 'backup', 'battery', 'binary', 'brightness', 'button', 'calendars', 'camera-credentials', 'camera-grid-layout', 'camera-pipeline-config', 'camera-streams', 'carbon-monoxide', 'climate-control', 'cluster-update', 'color', 'composer', 'connectivity', 'consumables', 'contact', 'control', 'core-blocks', 'cover', 'database-snapshot', 'day-night', 'decoder', 'detection-pipeline', 'device-admin-link', 'device-credentials', 'device-discovery', 'device-history', 'device-manager', 'device-ops', 'device-runs', 'device-state', 'device-status', 'device-transitions', 'dishwasher', 'display-palette', 'do-not-disturb', 'doorbell', 'enum-sensor', 'event-emitter', 'face-gallery', 'fan-control', 'fan-presets', 'feature-probe', 'filesystem-browse', 'flood', 'gas', 'group-active', 'group-commands', 'group-status', 'heat-pump-control', 'heat-pump-status', 'heating-valve', 'hero-layout', 'humidifier', 'humidity-sensor', 'image', 'image-settings', 'integrations', 'intercom', 'ir-transmitter', 'keychain', 'keychain-admin', 'lawn-mower-control', 'llm-runtime', 'local-network', 'lock-control', 'media-player', 'meter', 'metrics-provider', 'migrations', 'model-convert', 'model-distributor', 'motion', 'motion-detection', 'motion-trigger', 'motion-zones', 'native-object-detection', 'navigation', 'network-link', 'network-quality', 'node-certificates', 'nodes', 'notification-rules', 'notifier', 'numeric-sensor', 'osd', 'osd-manager', 'pet-feeder', 'pet-fountain', 'pipeline-analytics', 'pipeline-executor', 'pipeline-orchestrator', 'pipeline-runner', 'plate-gallery', 'platform-probe', 'power-meter', 'power-source', 'presence', 'pressure-sensor', 'privacy-mask', 'ptz', 'ptz-autotrack', 'pump-cycle', 'reboot', 'record-entries', 'recording-archive', 'recording-export', 'recording-onboard', 'recording-signal', 'records', 'remote', 'running-state', 'scene-monitor', 'schedulers', 'script-runner', 'server-management', 'settings-store', 'smoke', 'snapshot', 'sso-bridge', 'storage', 'storage-admin', 'storage-migration', 'stream-broker', 'stream-catalog', 'stream-params', 'stream-signals', 'switch', 'system', 'tamper', 'temperature-sensor', 'terminal-session', 'timed-run', 'toast', 'training', 'update', 'user-management', 'vacuum-control', 'valve', 'vector-store', 'vibration', 'viewer-ui', 'water-heater', 'weather', 'webrtc-session', 'zone-analytics', 'zone-rules', 'zones'];
634
637
  /** Union of singleton capability names (literal string union). */
635
638
  export type SingletonCapabilityName = typeof SINGLETON_CAPABILITY_NAMES[number];
636
639
  /** Capability names whose mode is `collection` (40 caps). */
@@ -346,7 +346,7 @@ export interface DeviceProxy {
346
346
  readonly deviceAdoption: Pick<InferDeviceProxyCap<typeof deviceAdoptionCapability>, 'getStatus'>;
347
347
  readonly deviceExport: Pick<InferDeviceProxyCap<typeof deviceExportCapability>, 'getDeviceSettingsContribution' | 'getDeviceLiveContribution' | 'applyDeviceSettingsPatch'>;
348
348
  readonly deviceHistory: Pick<InferDeviceProxyCap<typeof deviceHistoryCapability>, 'listSeries' | 'query' | 'getDeviceEnabled' | 'setDeviceEnabled'>;
349
- readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setAlias' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getWrapperActivation' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate'>;
349
+ readonly deviceManager: Pick<InferDeviceProxyCap<typeof deviceManagerCapability>, 'loadConfig' | 'loadRuntimeState' | 'loadMeta' | 'setName' | 'setAlias' | 'setLocation' | 'setType' | 'setIntegrationId' | 'setLinkDeviceId' | 'setPrimaryChildEntityId' | 'setChildLayout' | 'setPrimaryChildPreference' | 'setDisplay' | 'getWireableFields' | 'setRole' | 'applyInitialMeta' | 'setMetadata' | 'setDisabled' | 'getDevice' | 'getLinkedDevices' | 'getStreamSources' | 'getConfigSchema' | 'getSettingsSchema' | 'updateConfig' | 'enable' | 'disable' | 'remove' | 'getStreamProfileMap' | 'setStreamProfileMap' | 'probeStreams' | 'getBindings' | 'setWrapperActive' | 'getWrapperActivation' | 'getDeviceSettingsAggregate' | 'getDeviceLiveInfoAggregate' | 'getDeviceAggregate' | 'runDeviceAction' | 'updateDeviceField' | 'updateDeviceFieldsBatch' | 'testField' | 'getDeviceStatusAggregate'>;
350
350
  readonly deviceState: Pick<InferDeviceProxyCap<typeof deviceStateCapability>, 'getSnapshot' | 'getCapSlice' | 'setCapSlice' | 'claimFields' | 'patchOwnedFields' | 'releaseClaim' | 'getNativeCapSlice'>;
351
351
  readonly faceGallery: Pick<InferDeviceProxyCap<typeof faceGalleryCapability>, 'listRecentFaces' | 'getFaceByTrack'>;
352
352
  readonly networkQuality: Pick<InferDeviceProxyCap<typeof networkQualityCapability>, 'getDeviceStats' | 'reportClientStats'>;
@@ -6,7 +6,7 @@
6
6
  * scope+access check inside `protectedProcedure` (see
7
7
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
8
8
  *
9
- * Coverage: 1482 method paths across 205 capabilities.
9
+ * Coverage: 1487 method paths across 206 capabilities.
10
10
  */
11
11
  import type { MethodRole } from '../auth/viewer-access.js';
12
12
  import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
@@ -6,8 +6,8 @@
6
6
  * system-scope cap that takes a deviceId was previously never device-filtered
7
7
  * — see the generator header).
8
8
  *
9
- * Coverage: 616 methods carry a device reference, of which
10
- * 194 are on SYSTEM-scope caps.
9
+ * Coverage: 617 methods carry a device reference, of which
10
+ * 195 are on SYSTEM-scope caps.
11
11
  *
12
12
  * Top-level fields, number arrays, and one-level arrays of objects carrying
13
13
  * a numeric device field (targets[].deviceId) are all mapped; the matcher
@@ -13,6 +13,7 @@ import type { backupCapability } from '../capabilities/backup.cap.js';
13
13
  import type { boardKeySourceCapability } from '../capabilities/board-key-source.cap.js';
14
14
  import type { brokerCapability } from '../capabilities/broker.cap.js';
15
15
  import type { calendarsCapability } from '../capabilities/calendars.cap.js';
16
+ import type { clusterUpdateCapability } from '../capabilities/cluster-update.cap.js';
16
17
  import type { coreBlocksCapability } from '../capabilities/core-blocks.cap.js';
17
18
  import type { decoderCapability } from '../capabilities/decoder.cap.js';
18
19
  import type { deviceAdoptionCapability } from '../capabilities/device-adoption.cap.js';
@@ -85,13 +86,14 @@ export interface SystemProxy {
85
86
  readonly boardKeySource: Pick<InferProvider<typeof boardKeySourceCapability>, 'listSources' | 'listBoards' | 'getBoardKey'>;
86
87
  readonly broker: Pick<InferProvider<typeof brokerCapability>, 'getBrokerConfig' | 'publish' | 'subscribe' | 'unsubscribe' | 'getState' | 'getStatus'>;
87
88
  readonly calendars: Pick<InferProvider<typeof calendarsCapability>, 'listCalendars' | 'listEvents' | 'getPreferences' | 'setCalendarPreference'>;
89
+ readonly clusterUpdate: Pick<InferProvider<typeof clusterUpdateCapability>, 'previewClusterUpdate' | 'startClusterUpdate' | 'getClusterUpdateJob'>;
88
90
  readonly coreBlocks: Pick<InferProvider<typeof coreBlocksCapability>, 'list' | 'get' | 'create' | 'update' | 'delete' | 'setEnabled' | 'restart' | 'compile' | 'getBlockSettings' | 'updateBlockSettings' | 'migrateRawSecrets' | 'getTypeDefs' | 'createComposition' | 'updateComposition' | 'getComposition' | 'listCompositions' | 'getCustomization' | 'listComposableCaps' | 'validateComposition' | 'reportAutomationRun' | 'getAutomationRunState' | 'getTraces'>;
89
91
  readonly decoder: Pick<InferProvider<typeof decoderCapability>, 'getInfo' | 'reprobeHwaccel'>;
90
92
  readonly deviceAdoption: Pick<InferProvider<typeof deviceAdoptionCapability>, 'listCandidateFilters' | 'listCandidates' | 'getCandidate' | 'refresh' | 'adopt' | 'release' | 'resync'>;
91
93
  readonly deviceCredentials: Pick<InferProvider<typeof deviceCredentialsCapability>, 'listDeviceCredentials' | 'startEnrollment' | 'revokeDeviceCredential' | 'getDeviceCertificateSettings' | 'setDeviceCertificateSettings' | 'deleteDeviceCredential' | 'getDeviceCaStatus' | 'renameDeviceCredential'>;
92
94
  readonly deviceExport: Pick<InferProvider<typeof deviceExportCapability>, 'getStatus' | 'listInstances' | 'listSupportedDeviceKinds' | 'listExposedDevices' | 'exposeDevice' | 'unexposeDevice' | 'listSupportedEntityKinds' | 'listExposedEntities' | 'exposeEntity' | 'unexposeEntity'>;
93
95
  readonly deviceHistory: Pick<InferProvider<typeof deviceHistoryCapability>, 'listNodeSeries' | 'queryNode' | 'queryMany' | 'declareSeries' | 'record' | 'recordBuckets' | 'getStatus' | 'listOrphanSeries' | 'deleteOrphanSeries'>;
94
- readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'renderDeviceTemplates' | 'checkDeviceTemplates' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listLocationIcons' | 'setLocationIcon' | 'listLocationDescriptions' | 'setLocationDescription' | 'listSiteZones' | 'setSiteZone' | 'removeSiteZone' | 'renameSiteZone' | 'setLocationZone' | 'listPersistedByAddon' | 'listAll' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'listDeletedSince' | 'cleanupDeletedDevicesData' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listDeviceIdsByCaps' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'listDiscoveryProposals' | 'dismissDiscoveryProposal' | 'reportDiscoveryObservations' | 'runDiscoverySweep' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
96
+ readonly deviceManager: Pick<InferProvider<typeof deviceManagerCapability>, 'allocateDeviceId' | 'migrateDevice' | 'registerDevice' | 'removeDevice' | 'persistConfig' | 'renderDeviceTemplates' | 'checkDeviceTemplates' | 'getRoleDisplayDefaults' | 'setRoleDisplayDefaults' | 'listLocations' | 'addLocation' | 'removeLocation' | 'renameLocation' | 'listLocationIcons' | 'setLocationIcon' | 'listLocationDescriptions' | 'setLocationDescription' | 'listSiteZones' | 'setSiteZone' | 'removeSiteZone' | 'renameSiteZone' | 'setLocationZone' | 'listPersistedByAddon' | 'listAll' | 'search' | 'getChildren' | 'getChildrenBatch' | 'getLinkedDevicesBatch' | 'listDeletedSince' | 'cleanupDeletedDevicesData' | 'removeByIntegration' | 'getBindingsBatch' | 'getAllBindings' | 'listDeviceIdsByCaps' | 'listWrappersForCap' | 'listBindableCapsForDeviceType' | 'discoverDevices' | 'adoptDevice' | 'getCreationSchema' | 'createDevice' | 'testCreationField' | 'adoptionListCandidateFilters' | 'adoptionListCandidates' | 'adoptionRefresh' | 'adoptionAdopt' | 'adoptionRelease' | 'adoptionStartJob' | 'adoptionListJobs' | 'adoptionCancelJob' | 'adoptionResync' | 'discoveryProviders' | 'discoverAllProviders' | 'discoverProvider' | 'listDiscoveryProposals' | 'dismissDiscoveryProposal' | 'reportDiscoveryObservations' | 'runDiscoverySweep' | 'providerCreationType' | 'providerDiscoveryParamsSchema' | 'getDeviceStatusAggregateBatch'>;
95
97
  readonly deviceProvider: Pick<InferProvider<typeof deviceProviderCapability>, 'start' | 'stop' | 'getStatus' | 'getDevices' | 'reloadDevice' | 'supportsDiscovery' | 'discoverDevices' | 'getDiscoveryModes' | 'classifyDiscoveryHits' | 'getDiscoveryParamsSchema' | 'getManualCreationType' | 'adoptDiscoveredDevice' | 'supportsManualCreation' | 'getChildCreationSchema' | 'createDevice' | 'testCreationField'>;
96
98
  readonly deviceState: Pick<InferProvider<typeof deviceStateCapability>, 'getAllSnapshots' | 'listClaims'>;
97
99
  readonly displayPalette: Pick<InferProvider<typeof displayPaletteCapability>, 'getPalette' | 'listPresets' | 'setPalette'>;