@camstack/types 1.2.585 → 1.2.587

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 (78) hide show
  1. package/CHANGELOG.md +38 -1
  2. package/dist/addon.d.ts +2 -0
  3. package/dist/addon.js +21 -5
  4. package/dist/addon.mjs +18 -6
  5. package/dist/capabilities/camera-grid-layout.cap.d.ts +3 -5
  6. package/dist/capabilities/cap-method-absent.d.ts +19 -0
  7. package/dist/capabilities/device-manager.cap.d.ts +422 -0
  8. package/dist/capabilities/hero-layout.cap.d.ts +2 -2
  9. package/dist/capabilities/index.d.ts +11 -7
  10. package/dist/capabilities/network-link.cap.d.ts +10 -0
  11. package/dist/capabilities/notification-rules.cap.d.ts +70 -0
  12. package/dist/capabilities/power-source.cap.d.ts +20 -0
  13. package/dist/capabilities/recording-export.cap.d.ts +1 -0
  14. package/dist/capabilities/siren-duration.d.ts +45 -7
  15. package/dist/capabilities/siren.cap.d.ts +45 -2
  16. package/dist/capabilities/switch-settable.d.ts +15 -0
  17. package/dist/capabilities/switch.cap.d.ts +71 -0
  18. package/dist/capabilities/tags.cap.d.ts +42 -16
  19. package/dist/capabilities/terminal-session.cap.d.ts +9 -60
  20. package/dist/capabilities/videoclips.cap.d.ts +3 -0
  21. package/dist/capabilities/workload.cap.d.ts +655 -0
  22. package/dist/client.js +119 -6
  23. package/dist/client.mjs +119 -6
  24. package/dist/{composed-stable-id-RvQIEpqg.mjs → composed-stable-id-BBL71oUQ.mjs} +20 -0
  25. package/dist/{composed-stable-id-C3NfRTj8.js → composed-stable-id-CVbyajE5.js} +20 -0
  26. package/dist/composition/engine-hosted-blocks.d.ts +131 -0
  27. package/dist/composition/helpers/index.d.ts +1 -1
  28. package/dist/composition/helpers/spec.d.ts +56 -2
  29. package/dist/composition/index.d.ts +1 -0
  30. package/dist/device/base-device.d.ts +29 -0
  31. package/dist/device/cap-vocabulary/declaration.d.ts +12 -1
  32. package/dist/device/cap-vocabulary/index.d.ts +4 -4
  33. package/dist/device/cap-vocabulary/resolve.d.ts +47 -1
  34. package/dist/device/cap-vocabulary/types.d.ts +26 -1
  35. package/dist/device/declare-identifiers.d.ts +58 -0
  36. package/dist/device/device-control-resolution.d.ts +1 -1
  37. package/dist/device/device-icon.d.ts +7 -0
  38. package/dist/device/device-identifiers.d.ts +190 -0
  39. package/dist/device/device-management.d.ts +10 -0
  40. package/dist/device/device-type.d.ts +22 -2
  41. package/dist/device/hero/build-hero-model.d.ts +15 -0
  42. package/dist/device/hero/hero-fragment.d.ts +11 -0
  43. package/dist/device/hero/hero-layout.d.ts +1 -0
  44. package/dist/device/hero/hero-look.d.ts +12 -0
  45. package/dist/device/hero/hero-model.d.ts +4 -4
  46. package/dist/device/hero/hero-scene.d.ts +7 -0
  47. package/dist/device/index.d.ts +5 -1
  48. package/dist/enums/event-category.d.ts +8 -0
  49. package/dist/enums.js +1 -1
  50. package/dist/enums.mjs +1 -1
  51. package/dist/{event-category-d9kiqCqC.js → event-category-CE_VCE2G.js} +8 -0
  52. package/dist/{event-category-Dhcd0TRH.mjs → event-category-Hwx_JSCU.mjs} +8 -0
  53. package/dist/generated/addon-api.d.ts +106 -14
  54. package/dist/generated/addon-cap-facts.d.ts +1 -1
  55. package/dist/generated/cap-status-types.d.ts +3 -1
  56. package/dist/generated/cap-vocabulary.d.ts +1 -1
  57. package/dist/generated/capability-router-map.d.ts +5 -2
  58. package/dist/generated/collection-array-methods.d.ts +1 -1
  59. package/dist/generated/customize-catalog.d.ts +1 -1
  60. package/dist/generated/device-local-state.d.ts +3 -0
  61. package/dist/generated/device-proxy.d.ts +4 -1
  62. package/dist/generated/device-scoped-caps.d.ts +1 -1
  63. package/dist/generated/history-catalog.d.ts +2 -2
  64. package/dist/generated/method-access-map.d.ts +1 -1
  65. package/dist/generated/method-device-selectors.d.ts +2 -2
  66. package/dist/generated/runtime-state-durability.d.ts +1 -1
  67. package/dist/generated/system-proxy.d.ts +2 -2
  68. package/dist/{implemented-methods-C7ScGvEz.js → implemented-methods-ChtdIofW.js} +128 -1
  69. package/dist/{implemented-methods-C5FMXLGP.mjs → implemented-methods-u7ddjc-_.mjs} +57 -2
  70. package/dist/index.d.ts +7 -3
  71. package/dist/index.js +2086 -439
  72. package/dist/index.mjs +2027 -438
  73. package/dist/node.js +2 -2
  74. package/dist/node.mjs +2 -2
  75. package/dist/notification/timelapse-rule.d.ts +3 -0
  76. package/dist/{sleep-DwRtgB2i.js → sleep-CsZJsb8n.js} +692 -35
  77. package/dist/{sleep-Ch7Q7UtE.mjs → sleep-D6Pih0Qt.mjs} +669 -36
  78. package/package.json +1 -1
package/dist/client.js CHANGED
@@ -21134,6 +21134,25 @@ function iconCategoryLabel(category) {
21134
21134
  const spaced = category.replace(/-/g, " ");
21135
21135
  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
21136
21136
  }
21137
+ /** One tag name: trimmed, 1..40 characters. */
21138
+ var TagNameSchema = zod.z.string().trim().min(1).max(40);
21139
+ /** The `tags` field every owner record carries. Absent = no tags. */
21140
+ var TagsFieldSchema = zod.z.array(TagNameSchema).max(20);
21141
+ var TagColorIdSchema = zod.z.enum([
21142
+ "tag-a",
21143
+ "tag-b",
21144
+ "tag-c",
21145
+ "tag-d",
21146
+ "tag-e",
21147
+ "tag-f",
21148
+ "tag-g",
21149
+ "tag-h"
21150
+ ]);
21151
+ zod.z.object({
21152
+ name: TagNameSchema,
21153
+ color: TagColorIdSchema,
21154
+ icon: IconKeySchema
21155
+ });
21137
21156
  //#endregion
21138
21157
  //#region src/device/device-type.ts
21139
21158
  var DeviceType = /* @__PURE__ */ function(DeviceType) {
@@ -21257,6 +21276,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
21257
21276
  * and the storage as branches of one bus. One read-only `energy-system` cap carries
21258
21277
  * every value; the storage is a field of it, never the `battery` cap (#513, #522). */
21259
21278
  DeviceType["EnergySystem"] = "energy-system";
21279
+ /** Something that RUNS on a machine, or the machine itself (#585): a VM, an app
21280
+ * container, an LXC, an app, or a host. The kind is the ROLE (D1033, D1056), never
21281
+ * a field; one `workload` cap carries the state, the controls and the resources. */
21282
+ DeviceType["Workload"] = "workload";
21260
21283
  return DeviceType;
21261
21284
  }({});
21262
21285
  /**
@@ -21315,6 +21338,11 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
21315
21338
  * `light` type: the provider owns the type, and a light implies brightness
21316
21339
  * or colour this relay lacks. */
21317
21340
  DeviceRole["SwitchLight"] = "switch-light";
21341
+ /** One port of a network switch that powers the device behind it (PoE): on /
21342
+ * off feeds or cuts that power. Its link is `network-link`, its draw
21343
+ * `power-meter`. Restarting the powered device through the port is that
21344
+ * device's `power-source` cap, never a reboot of the port. */
21345
+ DeviceRole["PoePort"] = "poe-port";
21318
21346
  /** Air conditioner / split unit: cooling, fan speed, louvres. */
21319
21347
  DeviceRole["ClimateAc"] = "climate-ac";
21320
21348
  /** Room thermostat: a setpoint and a room temperature. The default. */
@@ -21395,6 +21423,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
21395
21423
  /** Emits a pulse train (infrared or RF) on request — the `ir-transmitter`
21396
21424
  * cap. A `DeviceType.Generic` device. */
21397
21425
  DeviceRole["IrTransmitter"] = "ir-transmitter";
21426
+ /** A virtual machine on a hypervisor. */
21427
+ DeviceRole["Vm"] = "vm";
21428
+ /** An application container (Docker, Podman). */
21429
+ DeviceRole["AppContainer"] = "app-container";
21430
+ /** A system container (LXC). */
21431
+ DeviceRole["Lxc"] = "lxc";
21432
+ /** An application or service running on a host. */
21433
+ DeviceRole["App"] = "app";
21434
+ /** A machine that runs workloads or is an appliance with its own OS: a
21435
+ * server, a hypervisor, a gateway console, a CCU. */
21436
+ DeviceRole["Host"] = "host";
21398
21437
  return DeviceRole;
21399
21438
  }({});
21400
21439
  zod.z.enum(["new-session", "step-up"]);
@@ -24499,7 +24538,32 @@ var NcRuleInputSchema = zod.z.object({
24499
24538
  * authored before this field meant. An editor turns it off by writing
24500
24539
  * `false`, so it needs no `clear` key.
24501
24540
  */
24502
- askVerdict: zod.z.boolean().optional()
24541
+ askVerdict: zod.z.boolean().optional(),
24542
+ /**
24543
+ * Operator tags (D1054), kept on the rule like a core block's. Absent = no
24544
+ * tags. `.optional()`, never `.default()`: a partial `updateRule` patch that
24545
+ * does not name `tags` keeps the stored ones (the store merges), and an
24546
+ * editor empties them by sending `[]` (the store drops an empty list).
24547
+ * Renamed or removed fleet-wide only through the `tags` cap, which writes
24548
+ * here with `setRuleTags`.
24549
+ */
24550
+ tags: TagsFieldSchema.optional()
24551
+ });
24552
+ /**
24553
+ * The rule kinds that carry tags (D1054) — each one its own store. Every kind
24554
+ * labels its rules the same way; this names which store a tag write goes to.
24555
+ */
24556
+ var NcTaggedRuleKindSchema = zod.z.enum([
24557
+ "event",
24558
+ "summary",
24559
+ "timelapse",
24560
+ "calendar-events"
24561
+ ]);
24562
+ /** One rule's tags, as the `tags` cap reads them across every kind. */
24563
+ var NcRuleTagsEntrySchema = zod.z.object({
24564
+ kind: NcTaggedRuleKindSchema,
24565
+ ruleId: zod.z.string(),
24566
+ tags: zod.z.array(zod.z.string())
24503
24567
  });
24504
24568
  /**
24505
24569
  * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -25541,6 +25605,16 @@ method(zod.z.object({}), zod.z.object({ rules: zod.z.array(NcRuleSchema) }), { a
25541
25605
  }), zod.z.object({ success: zod.z.literal(true) }), {
25542
25606
  kind: "mutation",
25543
25607
  auth: "admin"
25608
+ }), method(zod.z.object({}), zod.z.object({ rules: zod.z.array(NcRuleTagsEntrySchema) }), {
25609
+ kind: "query",
25610
+ auth: "admin"
25611
+ }), method(zod.z.object({
25612
+ kind: NcTaggedRuleKindSchema,
25613
+ ruleId: zod.z.string(),
25614
+ tags: TagsFieldSchema
25615
+ }), zod.z.object({ success: zod.z.literal(true) }), {
25616
+ kind: "mutation",
25617
+ auth: "admin"
25544
25618
  }), method(zod.z.object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(zod.z.object({}), zod.z.object({ mutedDeviceIds: zod.z.array(zod.z.number().int()).readonly() }), { auth: "admin" }), method(zod.z.object({
25545
25619
  deviceId: zod.z.number().int(),
25546
25620
  muted: zod.z.boolean()
@@ -26257,7 +26331,18 @@ DeviceType.Camera, method(zod.z.object({
26257
26331
  * older than this field keeps working unchanged (D382 — an unstated
26258
26332
  * ask is zero).
26259
26333
  */
26260
- audio: ClipStreamAudioSchema.optional()
26334
+ audio: ClipStreamAudioSchema.optional(),
26335
+ /**
26336
+ * The operator's authorisation to wake a sleeping camera for this
26337
+ * dial — the same {@link ClipWakeSchema} the byte reads carry. Absent
26338
+ * — the default — means a sleeping standalone battery camera is
26339
+ * REFUSED by name before any URL is minted. A caller sets it only
26340
+ * when a viewer itself asked for the clip (the broker's `playClip`);
26341
+ * a prefetch, a reconcile or a retry never does. With it, the
26342
+ * provider wakes the camera and waits under a bound; a camera that
26343
+ * does not come up is refused `wake-timeout`, naming the wait.
26344
+ */
26345
+ wake: ClipWakeSchema.optional()
26261
26346
  }), ClipStreamDialSchema, {
26262
26347
  kind: "query",
26263
26348
  auth: "protected"
@@ -26522,7 +26607,8 @@ zod.z.enum([
26522
26607
  "camera-refused",
26523
26608
  "fetch-failed",
26524
26609
  "too-large-to-transfer",
26525
- "wake-expired"
26610
+ "wake-expired",
26611
+ "wake-timeout"
26526
26612
  ]);
26527
26613
  /** Candidate download URLs (LAN first, then operator extra hosts). */
26528
26614
  var ExportDownloadSchema = zod.z.object({
@@ -27298,6 +27384,7 @@ var DEVICE_TYPE_ICON = {
27298
27384
  [DeviceType.Climate]: "thermometer",
27299
27385
  [DeviceType.HeatPump]: "flame",
27300
27386
  [DeviceType.EnergySystem]: "solar-panel",
27387
+ [DeviceType.Workload]: "server",
27301
27388
  [DeviceType.Button]: "circle-dot",
27302
27389
  [DeviceType.EventEmitter]: "zap",
27303
27390
  [DeviceType.Update]: "refresh-cw",
@@ -27352,6 +27439,7 @@ var DEVICE_ROLE_ICON = {
27352
27439
  [DeviceRole.SwitchHeater]: "flame",
27353
27440
  [DeviceRole.SwitchFan]: "fan",
27354
27441
  [DeviceRole.SwitchLight]: "lightbulb",
27442
+ [DeviceRole.PoePort]: "ethernet-port",
27355
27443
  [DeviceRole.ClimateAc]: "air-vent",
27356
27444
  [DeviceRole.ClimateThermostat]: "thermometer",
27357
27445
  [DeviceRole.ClimateFloor]: "waves",
@@ -27396,7 +27484,12 @@ var DEVICE_ROLE_ICON = {
27396
27484
  [DeviceRole.MessagingNotifier]: "message-square",
27397
27485
  [DeviceRole.EmailNotifier]: "mail",
27398
27486
  [DeviceRole.GenericNotifier]: "bell",
27399
- [DeviceRole.IrTransmitter]: "radio-tower"
27487
+ [DeviceRole.IrTransmitter]: "radio-tower",
27488
+ [DeviceRole.Vm]: "monitor",
27489
+ [DeviceRole.AppContainer]: "container",
27490
+ [DeviceRole.Lxc]: "box",
27491
+ [DeviceRole.App]: "app-window",
27492
+ [DeviceRole.Host]: "server"
27400
27493
  };
27401
27494
  var TYPE_VALUES = new Set(Object.values(DeviceType));
27402
27495
  var ROLE_VALUES = new Set(Object.values(DeviceRole));
@@ -28024,6 +28117,7 @@ function createDeviceProxy(api, binding, opts) {
28024
28117
  };
28025
28118
  const sirenInterface = {
28026
28119
  getOptions: (input, options) => dispatch("siren", "siren", "getOptions", "query", input, void 0, options),
28120
+ getPlayChoices: (input, options) => dispatch("siren", "siren", "getPlayChoices", "query", input, void 0, options),
28027
28121
  trigger: (input, options) => dispatch("siren", "siren", "trigger", "mutation", input, void 0, options),
28028
28122
  stop: (input, options) => dispatch("siren", "siren", "stop", "mutation", input, void 0, options),
28029
28123
  getStatus: (input, options) => dispatch("siren", "siren", "getStatus", "query", input, void 0, options)
@@ -28050,6 +28144,8 @@ function createDeviceProxy(api, binding, opts) {
28050
28144
  const streamSignalsInterface = { listSignals: (input, options) => dispatch("stream-signals", "streamSignals", "listSignals", "query", input, void 0, options) };
28051
28145
  const switchInterface = {
28052
28146
  setState: (input, options) => dispatch("switch", "switch", "setState", "mutation", input, void 0, options),
28147
+ getOptions: (input, options) => dispatch("switch", "switch", "getOptions", "query", input, void 0, options),
28148
+ powerCycle: (input, options) => dispatch("switch", "switch", "powerCycle", "mutation", input, void 0, options),
28053
28149
  toggle: (input, options) => dispatch("switch", "switch", "toggle", "mutation", input, void 0, options),
28054
28150
  getStatus: (input, options) => dispatch("switch", "switch", "getStatus", "query", input, void 0, options)
28055
28151
  };
@@ -28113,6 +28209,16 @@ function createDeviceProxy(api, binding, opts) {
28113
28209
  applyDownlinkProbe: (input, options) => dispatch("webrtc-session", "webrtcSession", "applyDownlinkProbe", "mutation", input, void 0, options),
28114
28210
  getSessionDebug: (input, options) => dispatch("webrtc-session", "webrtcSession", "getSessionDebug", "query", input, void 0, options)
28115
28211
  };
28212
+ const workloadInterface = {
28213
+ start: (input, options) => dispatch("workload", "workload", "start", "mutation", input, void 0, options),
28214
+ stop: (input, options) => dispatch("workload", "workload", "stop", "mutation", input, void 0, options),
28215
+ restart: (input, options) => dispatch("workload", "workload", "restart", "mutation", input, void 0, options),
28216
+ pause: (input, options) => dispatch("workload", "workload", "pause", "mutation", input, void 0, options),
28217
+ resume: (input, options) => dispatch("workload", "workload", "resume", "mutation", input, void 0, options),
28218
+ forceStop: (input, options) => dispatch("workload", "workload", "forceStop", "mutation", input, void 0, options),
28219
+ getOptions: (input, options) => dispatch("workload", "workload", "getOptions", "query", input, void 0, options),
28220
+ getStatus: (input, options) => dispatch("workload", "workload", "getStatus", "query", input, void 0, options)
28221
+ };
28116
28222
  const zoneAnalyticsInterface = {
28117
28223
  getCurrentSnapshot: (input, options) => dispatch("zone-analytics", "zoneAnalytics", "getCurrentSnapshot", "query", input, void 0, options),
28118
28224
  getCurrentSnapshotBatch: (input, options) => dispatch("zone-analytics", "zoneAnalytics", "getCurrentSnapshotBatch", "query", input, void 0, options),
@@ -28174,6 +28280,7 @@ function createDeviceProxy(api, binding, opts) {
28174
28280
  setRole: (input, options) => dispatchSystem("deviceManager", "setRole", "mutation", input, void 0, options),
28175
28281
  applyInitialMeta: (input, options) => dispatchSystem("deviceManager", "applyInitialMeta", "mutation", input, void 0, options),
28176
28282
  setMetadata: (input, options) => dispatchSystem("deviceManager", "setMetadata", "mutation", input, void 0, options),
28283
+ setIdentifiers: (input, options) => dispatchSystem("deviceManager", "setIdentifiers", "mutation", input, void 0, options),
28177
28284
  setDisabled: (input, options) => dispatchSystem("deviceManager", "setDisabled", "mutation", input, void 0, options),
28178
28285
  getDevice: (input, options) => dispatchSystem("deviceManager", "getDevice", "query", input, void 0, options),
28179
28286
  getLinkedDevices: (input, options) => dispatchSystem("deviceManager", "getLinkedDevices", "query", input, void 0, options),
@@ -28387,6 +28494,7 @@ function createDeviceProxy(api, binding, opts) {
28387
28494
  waterHeater: createSliceHandle(stateSource, binding.deviceId, "water-heater"),
28388
28495
  weather: createSliceHandle(stateSource, binding.deviceId, "weather"),
28389
28496
  weatherStation: createSliceHandle(stateSource, binding.deviceId, "weather-station"),
28497
+ workload: createSliceHandle(stateSource, binding.deviceId, "workload"),
28390
28498
  zoneAnalytics: createSliceHandle(stateSource, binding.deviceId, "zone-analytics"),
28391
28499
  zoneRules: createSliceHandle(stateSource, binding.deviceId, "zone-rules"),
28392
28500
  zones: createSliceHandle(stateSource, binding.deviceId, "zones")
@@ -28496,6 +28604,7 @@ function createDeviceProxy(api, binding, opts) {
28496
28604
  ...bound("weather") ? { weather: weatherInterface } : {},
28497
28605
  ...bound("weather-station") ? { weatherStation: weatherStationInterface } : {},
28498
28606
  ...bound("webrtc-session") ? { webrtcSession: webrtcSessionInterface } : {},
28607
+ ...bound("workload") ? { workload: workloadInterface } : {},
28499
28608
  ...bound("zone-analytics") ? { zoneAnalytics: zoneAnalyticsInterface } : {},
28500
28609
  ...bound("zone-rules") ? { zoneRules: zoneRulesInterface } : {},
28501
28610
  ...bound("zones") ? { zones: zonesInterface } : {},
@@ -29671,6 +29780,8 @@ function createSystemProxy(api) {
29671
29780
  updateRule: (input) => dispatch("notificationRules", "updateRule", "mutation", input),
29672
29781
  deleteRule: (input) => dispatch("notificationRules", "deleteRule", "mutation", input),
29673
29782
  setRuleEnabled: (input) => dispatch("notificationRules", "setRuleEnabled", "mutation", input),
29783
+ listRuleTags: (input) => dispatch("notificationRules", "listRuleTags", "query", input),
29784
+ setRuleTags: (input) => dispatch("notificationRules", "setRuleTags", "mutation", input),
29674
29785
  getClipRetentionAsks: (input) => dispatch("notificationRules", "getClipRetentionAsks", "query", input),
29675
29786
  listDeviceMutes: (input) => dispatch("notificationRules", "listDeviceMutes", "query", input),
29676
29787
  testRule: (input) => dispatch("notificationRules", "testRule", "mutation", input),
@@ -29990,8 +30101,6 @@ function createSystemProxy(api) {
29990
30101
  },
29991
30102
  terminalSession: {
29992
30103
  listProfiles: (input) => dispatch("terminalSession", "listProfiles", "query", input),
29993
- listLegacyCameras: (input) => dispatch("terminalSession", "listLegacyCameras", "query", input),
29994
- adoptLegacyMonitor: (input) => dispatch("terminalSession", "adoptLegacyMonitor", "mutation", input),
29995
30104
  listSessions: (input) => dispatch("terminalSession", "listSessions", "query", input),
29996
30105
  serverShellStatus: (input) => dispatch("terminalSession", "serverShellStatus", "query", input),
29997
30106
  openSession: (input) => dispatch("terminalSession", "openSession", "mutation", input),
@@ -33672,6 +33781,8 @@ var TimelapseRuleInputSchema = zod.z.object({
33672
33781
  /** Canonical notification priority ordinal (1..5); per-target overridable. */
33673
33782
  priority: PriorityField.default(3),
33674
33783
  /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33784
+ /** Operator labels (D1054) — optional and NEVER defaulted: an absent key leaves the stored tags alone; `[]` clears them. Admin-only. */
33785
+ tags: TagsFieldSchema.optional(),
33675
33786
  targetOverrides: NcTargetOverridesSchema.optional()
33676
33787
  });
33677
33788
  /**
@@ -33698,6 +33809,8 @@ zod.z.object({
33698
33809
  reportClasses: ReportClassesField.optional(),
33699
33810
  priority: PriorityField.optional(),
33700
33811
  /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33812
+ /** Absent = keep the stored tags; `[]` clears them (D1054). Never defaulted. */
33813
+ tags: TagsFieldSchema.optional(),
33701
33814
  targetOverrides: NcTargetOverridesSchema.optional()
33702
33815
  });
33703
33816
  /** A persisted timelapse rule. */
package/dist/client.mjs CHANGED
@@ -21133,6 +21133,25 @@ function iconCategoryLabel(category) {
21133
21133
  const spaced = category.replace(/-/g, " ");
21134
21134
  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
21135
21135
  }
21136
+ /** One tag name: trimmed, 1..40 characters. */
21137
+ var TagNameSchema = z.string().trim().min(1).max(40);
21138
+ /** The `tags` field every owner record carries. Absent = no tags. */
21139
+ var TagsFieldSchema = z.array(TagNameSchema).max(20);
21140
+ var TagColorIdSchema = z.enum([
21141
+ "tag-a",
21142
+ "tag-b",
21143
+ "tag-c",
21144
+ "tag-d",
21145
+ "tag-e",
21146
+ "tag-f",
21147
+ "tag-g",
21148
+ "tag-h"
21149
+ ]);
21150
+ z.object({
21151
+ name: TagNameSchema,
21152
+ color: TagColorIdSchema,
21153
+ icon: IconKeySchema
21154
+ });
21136
21155
  //#endregion
21137
21156
  //#region src/device/device-type.ts
21138
21157
  var DeviceType = /* @__PURE__ */ function(DeviceType) {
@@ -21256,6 +21275,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
21256
21275
  * and the storage as branches of one bus. One read-only `energy-system` cap carries
21257
21276
  * every value; the storage is a field of it, never the `battery` cap (#513, #522). */
21258
21277
  DeviceType["EnergySystem"] = "energy-system";
21278
+ /** Something that RUNS on a machine, or the machine itself (#585): a VM, an app
21279
+ * container, an LXC, an app, or a host. The kind is the ROLE (D1033, D1056), never
21280
+ * a field; one `workload` cap carries the state, the controls and the resources. */
21281
+ DeviceType["Workload"] = "workload";
21259
21282
  return DeviceType;
21260
21283
  }({});
21261
21284
  /**
@@ -21314,6 +21337,11 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
21314
21337
  * `light` type: the provider owns the type, and a light implies brightness
21315
21338
  * or colour this relay lacks. */
21316
21339
  DeviceRole["SwitchLight"] = "switch-light";
21340
+ /** One port of a network switch that powers the device behind it (PoE): on /
21341
+ * off feeds or cuts that power. Its link is `network-link`, its draw
21342
+ * `power-meter`. Restarting the powered device through the port is that
21343
+ * device's `power-source` cap, never a reboot of the port. */
21344
+ DeviceRole["PoePort"] = "poe-port";
21317
21345
  /** Air conditioner / split unit: cooling, fan speed, louvres. */
21318
21346
  DeviceRole["ClimateAc"] = "climate-ac";
21319
21347
  /** Room thermostat: a setpoint and a room temperature. The default. */
@@ -21394,6 +21422,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
21394
21422
  /** Emits a pulse train (infrared or RF) on request — the `ir-transmitter`
21395
21423
  * cap. A `DeviceType.Generic` device. */
21396
21424
  DeviceRole["IrTransmitter"] = "ir-transmitter";
21425
+ /** A virtual machine on a hypervisor. */
21426
+ DeviceRole["Vm"] = "vm";
21427
+ /** An application container (Docker, Podman). */
21428
+ DeviceRole["AppContainer"] = "app-container";
21429
+ /** A system container (LXC). */
21430
+ DeviceRole["Lxc"] = "lxc";
21431
+ /** An application or service running on a host. */
21432
+ DeviceRole["App"] = "app";
21433
+ /** A machine that runs workloads or is an appliance with its own OS: a
21434
+ * server, a hypervisor, a gateway console, a CCU. */
21435
+ DeviceRole["Host"] = "host";
21397
21436
  return DeviceRole;
21398
21437
  }({});
21399
21438
  z.enum(["new-session", "step-up"]);
@@ -24498,7 +24537,32 @@ var NcRuleInputSchema = z.object({
24498
24537
  * authored before this field meant. An editor turns it off by writing
24499
24538
  * `false`, so it needs no `clear` key.
24500
24539
  */
24501
- askVerdict: z.boolean().optional()
24540
+ askVerdict: z.boolean().optional(),
24541
+ /**
24542
+ * Operator tags (D1054), kept on the rule like a core block's. Absent = no
24543
+ * tags. `.optional()`, never `.default()`: a partial `updateRule` patch that
24544
+ * does not name `tags` keeps the stored ones (the store merges), and an
24545
+ * editor empties them by sending `[]` (the store drops an empty list).
24546
+ * Renamed or removed fleet-wide only through the `tags` cap, which writes
24547
+ * here with `setRuleTags`.
24548
+ */
24549
+ tags: TagsFieldSchema.optional()
24550
+ });
24551
+ /**
24552
+ * The rule kinds that carry tags (D1054) — each one its own store. Every kind
24553
+ * labels its rules the same way; this names which store a tag write goes to.
24554
+ */
24555
+ var NcTaggedRuleKindSchema = z.enum([
24556
+ "event",
24557
+ "summary",
24558
+ "timelapse",
24559
+ "calendar-events"
24560
+ ]);
24561
+ /** One rule's tags, as the `tags` cap reads them across every kind. */
24562
+ var NcRuleTagsEntrySchema = z.object({
24563
+ kind: NcTaggedRuleKindSchema,
24564
+ ruleId: z.string(),
24565
+ tags: z.array(z.string())
24502
24566
  });
24503
24567
  /**
24504
24568
  * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -25540,6 +25604,16 @@ method(z.object({}), z.object({ rules: z.array(NcRuleSchema) }), { auth: "admin"
25540
25604
  }), z.object({ success: z.literal(true) }), {
25541
25605
  kind: "mutation",
25542
25606
  auth: "admin"
25607
+ }), method(z.object({}), z.object({ rules: z.array(NcRuleTagsEntrySchema) }), {
25608
+ kind: "query",
25609
+ auth: "admin"
25610
+ }), method(z.object({
25611
+ kind: NcTaggedRuleKindSchema,
25612
+ ruleId: z.string(),
25613
+ tags: TagsFieldSchema
25614
+ }), z.object({ success: z.literal(true) }), {
25615
+ kind: "mutation",
25616
+ auth: "admin"
25543
25617
  }), method(z.object({}), NcClipRetentionPlanSchema, { auth: "admin" }), method(z.object({}), z.object({ mutedDeviceIds: z.array(z.number().int()).readonly() }), { auth: "admin" }), method(z.object({
25544
25618
  deviceId: z.number().int(),
25545
25619
  muted: z.boolean()
@@ -26256,7 +26330,18 @@ DeviceType.Camera, method(z.object({
26256
26330
  * older than this field keeps working unchanged (D382 — an unstated
26257
26331
  * ask is zero).
26258
26332
  */
26259
- audio: ClipStreamAudioSchema.optional()
26333
+ audio: ClipStreamAudioSchema.optional(),
26334
+ /**
26335
+ * The operator's authorisation to wake a sleeping camera for this
26336
+ * dial — the same {@link ClipWakeSchema} the byte reads carry. Absent
26337
+ * — the default — means a sleeping standalone battery camera is
26338
+ * REFUSED by name before any URL is minted. A caller sets it only
26339
+ * when a viewer itself asked for the clip (the broker's `playClip`);
26340
+ * a prefetch, a reconcile or a retry never does. With it, the
26341
+ * provider wakes the camera and waits under a bound; a camera that
26342
+ * does not come up is refused `wake-timeout`, naming the wait.
26343
+ */
26344
+ wake: ClipWakeSchema.optional()
26260
26345
  }), ClipStreamDialSchema, {
26261
26346
  kind: "query",
26262
26347
  auth: "protected"
@@ -26521,7 +26606,8 @@ z.enum([
26521
26606
  "camera-refused",
26522
26607
  "fetch-failed",
26523
26608
  "too-large-to-transfer",
26524
- "wake-expired"
26609
+ "wake-expired",
26610
+ "wake-timeout"
26525
26611
  ]);
26526
26612
  /** Candidate download URLs (LAN first, then operator extra hosts). */
26527
26613
  var ExportDownloadSchema = z.object({
@@ -27297,6 +27383,7 @@ var DEVICE_TYPE_ICON = {
27297
27383
  [DeviceType.Climate]: "thermometer",
27298
27384
  [DeviceType.HeatPump]: "flame",
27299
27385
  [DeviceType.EnergySystem]: "solar-panel",
27386
+ [DeviceType.Workload]: "server",
27300
27387
  [DeviceType.Button]: "circle-dot",
27301
27388
  [DeviceType.EventEmitter]: "zap",
27302
27389
  [DeviceType.Update]: "refresh-cw",
@@ -27351,6 +27438,7 @@ var DEVICE_ROLE_ICON = {
27351
27438
  [DeviceRole.SwitchHeater]: "flame",
27352
27439
  [DeviceRole.SwitchFan]: "fan",
27353
27440
  [DeviceRole.SwitchLight]: "lightbulb",
27441
+ [DeviceRole.PoePort]: "ethernet-port",
27354
27442
  [DeviceRole.ClimateAc]: "air-vent",
27355
27443
  [DeviceRole.ClimateThermostat]: "thermometer",
27356
27444
  [DeviceRole.ClimateFloor]: "waves",
@@ -27395,7 +27483,12 @@ var DEVICE_ROLE_ICON = {
27395
27483
  [DeviceRole.MessagingNotifier]: "message-square",
27396
27484
  [DeviceRole.EmailNotifier]: "mail",
27397
27485
  [DeviceRole.GenericNotifier]: "bell",
27398
- [DeviceRole.IrTransmitter]: "radio-tower"
27486
+ [DeviceRole.IrTransmitter]: "radio-tower",
27487
+ [DeviceRole.Vm]: "monitor",
27488
+ [DeviceRole.AppContainer]: "container",
27489
+ [DeviceRole.Lxc]: "box",
27490
+ [DeviceRole.App]: "app-window",
27491
+ [DeviceRole.Host]: "server"
27399
27492
  };
27400
27493
  var TYPE_VALUES = new Set(Object.values(DeviceType));
27401
27494
  var ROLE_VALUES = new Set(Object.values(DeviceRole));
@@ -28023,6 +28116,7 @@ function createDeviceProxy(api, binding, opts) {
28023
28116
  };
28024
28117
  const sirenInterface = {
28025
28118
  getOptions: (input, options) => dispatch("siren", "siren", "getOptions", "query", input, void 0, options),
28119
+ getPlayChoices: (input, options) => dispatch("siren", "siren", "getPlayChoices", "query", input, void 0, options),
28026
28120
  trigger: (input, options) => dispatch("siren", "siren", "trigger", "mutation", input, void 0, options),
28027
28121
  stop: (input, options) => dispatch("siren", "siren", "stop", "mutation", input, void 0, options),
28028
28122
  getStatus: (input, options) => dispatch("siren", "siren", "getStatus", "query", input, void 0, options)
@@ -28049,6 +28143,8 @@ function createDeviceProxy(api, binding, opts) {
28049
28143
  const streamSignalsInterface = { listSignals: (input, options) => dispatch("stream-signals", "streamSignals", "listSignals", "query", input, void 0, options) };
28050
28144
  const switchInterface = {
28051
28145
  setState: (input, options) => dispatch("switch", "switch", "setState", "mutation", input, void 0, options),
28146
+ getOptions: (input, options) => dispatch("switch", "switch", "getOptions", "query", input, void 0, options),
28147
+ powerCycle: (input, options) => dispatch("switch", "switch", "powerCycle", "mutation", input, void 0, options),
28052
28148
  toggle: (input, options) => dispatch("switch", "switch", "toggle", "mutation", input, void 0, options),
28053
28149
  getStatus: (input, options) => dispatch("switch", "switch", "getStatus", "query", input, void 0, options)
28054
28150
  };
@@ -28112,6 +28208,16 @@ function createDeviceProxy(api, binding, opts) {
28112
28208
  applyDownlinkProbe: (input, options) => dispatch("webrtc-session", "webrtcSession", "applyDownlinkProbe", "mutation", input, void 0, options),
28113
28209
  getSessionDebug: (input, options) => dispatch("webrtc-session", "webrtcSession", "getSessionDebug", "query", input, void 0, options)
28114
28210
  };
28211
+ const workloadInterface = {
28212
+ start: (input, options) => dispatch("workload", "workload", "start", "mutation", input, void 0, options),
28213
+ stop: (input, options) => dispatch("workload", "workload", "stop", "mutation", input, void 0, options),
28214
+ restart: (input, options) => dispatch("workload", "workload", "restart", "mutation", input, void 0, options),
28215
+ pause: (input, options) => dispatch("workload", "workload", "pause", "mutation", input, void 0, options),
28216
+ resume: (input, options) => dispatch("workload", "workload", "resume", "mutation", input, void 0, options),
28217
+ forceStop: (input, options) => dispatch("workload", "workload", "forceStop", "mutation", input, void 0, options),
28218
+ getOptions: (input, options) => dispatch("workload", "workload", "getOptions", "query", input, void 0, options),
28219
+ getStatus: (input, options) => dispatch("workload", "workload", "getStatus", "query", input, void 0, options)
28220
+ };
28115
28221
  const zoneAnalyticsInterface = {
28116
28222
  getCurrentSnapshot: (input, options) => dispatch("zone-analytics", "zoneAnalytics", "getCurrentSnapshot", "query", input, void 0, options),
28117
28223
  getCurrentSnapshotBatch: (input, options) => dispatch("zone-analytics", "zoneAnalytics", "getCurrentSnapshotBatch", "query", input, void 0, options),
@@ -28173,6 +28279,7 @@ function createDeviceProxy(api, binding, opts) {
28173
28279
  setRole: (input, options) => dispatchSystem("deviceManager", "setRole", "mutation", input, void 0, options),
28174
28280
  applyInitialMeta: (input, options) => dispatchSystem("deviceManager", "applyInitialMeta", "mutation", input, void 0, options),
28175
28281
  setMetadata: (input, options) => dispatchSystem("deviceManager", "setMetadata", "mutation", input, void 0, options),
28282
+ setIdentifiers: (input, options) => dispatchSystem("deviceManager", "setIdentifiers", "mutation", input, void 0, options),
28176
28283
  setDisabled: (input, options) => dispatchSystem("deviceManager", "setDisabled", "mutation", input, void 0, options),
28177
28284
  getDevice: (input, options) => dispatchSystem("deviceManager", "getDevice", "query", input, void 0, options),
28178
28285
  getLinkedDevices: (input, options) => dispatchSystem("deviceManager", "getLinkedDevices", "query", input, void 0, options),
@@ -28386,6 +28493,7 @@ function createDeviceProxy(api, binding, opts) {
28386
28493
  waterHeater: createSliceHandle(stateSource, binding.deviceId, "water-heater"),
28387
28494
  weather: createSliceHandle(stateSource, binding.deviceId, "weather"),
28388
28495
  weatherStation: createSliceHandle(stateSource, binding.deviceId, "weather-station"),
28496
+ workload: createSliceHandle(stateSource, binding.deviceId, "workload"),
28389
28497
  zoneAnalytics: createSliceHandle(stateSource, binding.deviceId, "zone-analytics"),
28390
28498
  zoneRules: createSliceHandle(stateSource, binding.deviceId, "zone-rules"),
28391
28499
  zones: createSliceHandle(stateSource, binding.deviceId, "zones")
@@ -28495,6 +28603,7 @@ function createDeviceProxy(api, binding, opts) {
28495
28603
  ...bound("weather") ? { weather: weatherInterface } : {},
28496
28604
  ...bound("weather-station") ? { weatherStation: weatherStationInterface } : {},
28497
28605
  ...bound("webrtc-session") ? { webrtcSession: webrtcSessionInterface } : {},
28606
+ ...bound("workload") ? { workload: workloadInterface } : {},
28498
28607
  ...bound("zone-analytics") ? { zoneAnalytics: zoneAnalyticsInterface } : {},
28499
28608
  ...bound("zone-rules") ? { zoneRules: zoneRulesInterface } : {},
28500
28609
  ...bound("zones") ? { zones: zonesInterface } : {},
@@ -29670,6 +29779,8 @@ function createSystemProxy(api) {
29670
29779
  updateRule: (input) => dispatch("notificationRules", "updateRule", "mutation", input),
29671
29780
  deleteRule: (input) => dispatch("notificationRules", "deleteRule", "mutation", input),
29672
29781
  setRuleEnabled: (input) => dispatch("notificationRules", "setRuleEnabled", "mutation", input),
29782
+ listRuleTags: (input) => dispatch("notificationRules", "listRuleTags", "query", input),
29783
+ setRuleTags: (input) => dispatch("notificationRules", "setRuleTags", "mutation", input),
29673
29784
  getClipRetentionAsks: (input) => dispatch("notificationRules", "getClipRetentionAsks", "query", input),
29674
29785
  listDeviceMutes: (input) => dispatch("notificationRules", "listDeviceMutes", "query", input),
29675
29786
  testRule: (input) => dispatch("notificationRules", "testRule", "mutation", input),
@@ -29989,8 +30100,6 @@ function createSystemProxy(api) {
29989
30100
  },
29990
30101
  terminalSession: {
29991
30102
  listProfiles: (input) => dispatch("terminalSession", "listProfiles", "query", input),
29992
- listLegacyCameras: (input) => dispatch("terminalSession", "listLegacyCameras", "query", input),
29993
- adoptLegacyMonitor: (input) => dispatch("terminalSession", "adoptLegacyMonitor", "mutation", input),
29994
30103
  listSessions: (input) => dispatch("terminalSession", "listSessions", "query", input),
29995
30104
  serverShellStatus: (input) => dispatch("terminalSession", "serverShellStatus", "query", input),
29996
30105
  openSession: (input) => dispatch("terminalSession", "openSession", "mutation", input),
@@ -33671,6 +33780,8 @@ var TimelapseRuleInputSchema = z.object({
33671
33780
  /** Canonical notification priority ordinal (1..5); per-target overridable. */
33672
33781
  priority: PriorityField.default(3),
33673
33782
  /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33783
+ /** Operator labels (D1054) — optional and NEVER defaulted: an absent key leaves the stored tags alone; `[]` clears them. Admin-only. */
33784
+ tags: TagsFieldSchema.optional(),
33674
33785
  targetOverrides: NcTargetOverridesSchema.optional()
33675
33786
  });
33676
33787
  /**
@@ -33697,6 +33808,8 @@ z.object({
33697
33808
  reportClasses: ReportClassesField.optional(),
33698
33809
  priority: PriorityField.optional(),
33699
33810
  /** Per-target settings keyed by target id (D1032) — absent = every target follows the rule. */
33811
+ /** Absent = keep the stored tags; `[]` clears them (D1054). Never defaulted. */
33812
+ tags: TagsFieldSchema.optional(),
33700
33813
  targetOverrides: NcTargetOverridesSchema.optional()
33701
33814
  });
33702
33815
  /** A persisted timelapse rule. */
@@ -132,6 +132,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
132
132
  * and the storage as branches of one bus. One read-only `energy-system` cap carries
133
133
  * every value; the storage is a field of it, never the `battery` cap (#513, #522). */
134
134
  DeviceType["EnergySystem"] = "energy-system";
135
+ /** Something that RUNS on a machine, or the machine itself (#585): a VM, an app
136
+ * container, an LXC, an app, or a host. The kind is the ROLE (D1033, D1056), never
137
+ * a field; one `workload` cap carries the state, the controls and the resources. */
138
+ DeviceType["Workload"] = "workload";
135
139
  return DeviceType;
136
140
  }({});
137
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
@@ -367,6 +371,11 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
367
371
  * `light` type: the provider owns the type, and a light implies brightness
368
372
  * or colour this relay lacks. */
369
373
  DeviceRole["SwitchLight"] = "switch-light";
374
+ /** One port of a network switch that powers the device behind it (PoE): on /
375
+ * off feeds or cuts that power. Its link is `network-link`, its draw
376
+ * `power-meter`. Restarting the powered device through the port is that
377
+ * device's `power-source` cap, never a reboot of the port. */
378
+ DeviceRole["PoePort"] = "poe-port";
370
379
  /** Air conditioner / split unit: cooling, fan speed, louvres. */
371
380
  DeviceRole["ClimateAc"] = "climate-ac";
372
381
  /** Room thermostat: a setpoint and a room temperature. The default. */
@@ -447,6 +456,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
447
456
  /** Emits a pulse train (infrared or RF) on request — the `ir-transmitter`
448
457
  * cap. A `DeviceType.Generic` device. */
449
458
  DeviceRole["IrTransmitter"] = "ir-transmitter";
459
+ /** A virtual machine on a hypervisor. */
460
+ DeviceRole["Vm"] = "vm";
461
+ /** An application container (Docker, Podman). */
462
+ DeviceRole["AppContainer"] = "app-container";
463
+ /** A system container (LXC). */
464
+ DeviceRole["Lxc"] = "lxc";
465
+ /** An application or service running on a host. */
466
+ DeviceRole["App"] = "app";
467
+ /** A machine that runs workloads or is an appliance with its own OS: a
468
+ * server, a hypervisor, a gateway console, a CCU. */
469
+ DeviceRole["Host"] = "host";
450
470
  return DeviceRole;
451
471
  }({});
452
472
  //#endregion
@@ -132,6 +132,10 @@ var DeviceType = /* @__PURE__ */ function(DeviceType) {
132
132
  * and the storage as branches of one bus. One read-only `energy-system` cap carries
133
133
  * every value; the storage is a field of it, never the `battery` cap (#513, #522). */
134
134
  DeviceType["EnergySystem"] = "energy-system";
135
+ /** Something that RUNS on a machine, or the machine itself (#585): a VM, an app
136
+ * container, an LXC, an app, or a host. The kind is the ROLE (D1033, D1056), never
137
+ * a field; one `workload` cap carries the state, the controls and the resources. */
138
+ DeviceType["Workload"] = "workload";
135
139
  return DeviceType;
136
140
  }({});
137
141
  var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
@@ -367,6 +371,11 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
367
371
  * `light` type: the provider owns the type, and a light implies brightness
368
372
  * or colour this relay lacks. */
369
373
  DeviceRole["SwitchLight"] = "switch-light";
374
+ /** One port of a network switch that powers the device behind it (PoE): on /
375
+ * off feeds or cuts that power. Its link is `network-link`, its draw
376
+ * `power-meter`. Restarting the powered device through the port is that
377
+ * device's `power-source` cap, never a reboot of the port. */
378
+ DeviceRole["PoePort"] = "poe-port";
370
379
  /** Air conditioner / split unit: cooling, fan speed, louvres. */
371
380
  DeviceRole["ClimateAc"] = "climate-ac";
372
381
  /** Room thermostat: a setpoint and a room temperature. The default. */
@@ -447,6 +456,17 @@ var DeviceRole = /* @__PURE__ */ function(DeviceRole) {
447
456
  /** Emits a pulse train (infrared or RF) on request — the `ir-transmitter`
448
457
  * cap. A `DeviceType.Generic` device. */
449
458
  DeviceRole["IrTransmitter"] = "ir-transmitter";
459
+ /** A virtual machine on a hypervisor. */
460
+ DeviceRole["Vm"] = "vm";
461
+ /** An application container (Docker, Podman). */
462
+ DeviceRole["AppContainer"] = "app-container";
463
+ /** A system container (LXC). */
464
+ DeviceRole["Lxc"] = "lxc";
465
+ /** An application or service running on a host. */
466
+ DeviceRole["App"] = "app";
467
+ /** A machine that runs workloads or is an appliance with its own OS: a
468
+ * server, a hypervisor, a gateway console, a CCU. */
469
+ DeviceRole["Host"] = "host";
450
470
  return DeviceRole;
451
471
  }({});
452
472
  //#endregion