@camstack/addon-provider-hikvision 1.2.169 → 1.2.170

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 (3) hide show
  1. package/dist/addon.js +193 -117
  2. package/dist/addon.mjs +193 -117
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -5466,7 +5466,7 @@ var ZodIssueCode = {
5466
5466
  var ZodFirstPartyTypeKind;
5467
5467
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5468
5468
  //#endregion
5469
- //#region ../types/dist/sleep-DJFUfKvA.mjs
5469
+ //#region ../types/dist/sleep-CUp20JkO.mjs
5470
5470
  /**
5471
5471
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5472
5472
  * window to float samples (D455).
@@ -8358,7 +8358,11 @@ var ContributionSectionSchema = object({
8358
8358
  literal(4)
8359
8359
  ]).optional(),
8360
8360
  tab: string().optional(),
8361
- location: _enum(["settings", "top-tab"]).optional(),
8361
+ location: _enum([
8362
+ "settings",
8363
+ "top-tab",
8364
+ "hero"
8365
+ ]).optional(),
8362
8366
  order: number().optional(),
8363
8367
  fields: array(any())
8364
8368
  });
@@ -13608,7 +13612,11 @@ var ConfigSectionWithValuesSchema = object({
13608
13612
  literal(4)
13609
13613
  ]).optional(),
13610
13614
  tab: string().optional(),
13611
- location: _enum(["settings", "top-tab"]).optional(),
13615
+ location: _enum([
13616
+ "settings",
13617
+ "top-tab",
13618
+ "hero"
13619
+ ]).optional(),
13612
13620
  order: number().optional(),
13613
13621
  fields: array(any())
13614
13622
  });
@@ -17488,6 +17496,52 @@ var TierStatusSchema = object({
17488
17496
  countedAt: number().nullable()
17489
17497
  });
17490
17498
  /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
17499
+ /**
17500
+ * Why a series is orphan. `device-gone`: its device is absent from the
17501
+ * successful device listings (the departure clock). `undeclared`: its `cap:`
17502
+ * key is declared by no capability any more (a field a cap removed).
17503
+ */
17504
+ var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
17505
+ /** Rows held per stored tier. */
17506
+ var TierRowsSchema = object({
17507
+ raw: number().int(),
17508
+ "5m": number().int(),
17509
+ "1h": number().int(),
17510
+ "1d": number().int()
17511
+ });
17512
+ var OrphanSeriesSchema = object({
17513
+ seriesId: number().int(),
17514
+ deviceId: number().int(),
17515
+ key: string(),
17516
+ scope: string(),
17517
+ /** The metric's display name; `null` when its metric row is gone too. */
17518
+ displayName: string().nullable(),
17519
+ reason: DeviceHistoryOrphanReasonSchema,
17520
+ /** `device-gone`: since when the device has been absent; `null` otherwise. */
17521
+ missingSince: number().nullable(),
17522
+ firstTs: number(),
17523
+ lastTs: number(),
17524
+ rows: TierRowsSchema
17525
+ });
17526
+ var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
17527
+ "not-found",
17528
+ "not-orphan",
17529
+ "failed"
17530
+ ]);
17531
+ var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
17532
+ seriesId: number().int(),
17533
+ ok: literal(true),
17534
+ deleted: TierRowsSchema
17535
+ }), object({
17536
+ seriesId: number().int(),
17537
+ ok: literal(false),
17538
+ reason: DeviceHistoryOrphanDeleteRefusalSchema
17539
+ })]);
17540
+ var OrphanListSchema = object({
17541
+ series: array(OrphanSeriesSchema).readonly(),
17542
+ /** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
17543
+ truncated: boolean()
17544
+ });
17491
17545
  var DeviceHistoryStatusSchema = object({
17492
17546
  startedAt: number(),
17493
17547
  /** The store is declared, series loaded and the first reconcile has answered. */
@@ -17585,7 +17639,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
17585
17639
  }), object({ enabled: boolean() }), {
17586
17640
  kind: "mutation",
17587
17641
  auth: "admin"
17588
- }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
17642
+ }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" }), method(object({}), OrphanListSchema, { auth: "admin" }), method(object({ seriesIds: array(number().int()).min(1).max(50) }), object({ results: array(OrphanDeleteEntrySchema).readonly() }), {
17643
+ kind: "mutation",
17644
+ auth: "admin"
17645
+ });
17589
17646
  var DeviceCaStatusSchema = discriminatedUnion("state", [
17590
17647
  object({ state: literal("absent") }),
17591
17648
  object({
@@ -56082,17 +56139,69 @@ var connectivityCapability = {
56082
56139
  volatileStateFields: ["lastChangedAt"]
56083
56140
  };
56084
56141
  /**
56085
- * Generic device-consumables capability — surfaces a device's
56086
- * maintenance items (vacuum filters/brushes, replaceable cartridges,
56087
- * descaling cycles, …) with their remaining life and an optional
56088
- * "Replaced" reset action. Device-agnostic: any provider that knows its
56089
- * device tracks consumables can register it; the cap declares no
56090
- * vocabulary of its own — the provider names each item verbatim.
56142
+ * Generic device-consumables capability — the ONE place a device reports what
56143
+ * it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
56144
+ * descaling cycles), supplies it draws from (a vacuum's clean-water tank and
56145
+ * detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
56146
+ * water tank, a dust bin). Each item carries its remaining life or fill and an
56147
+ * optional "Replaced" reset action. Device-agnostic: any provider that knows
56148
+ * its device tracks consumables registers it; the provider names each item
56149
+ * verbatim and says which `kind` it is.
56150
+ *
56151
+ * The admin UI renders it as ONE collapsible section directly under the
56152
+ * device page's hero card (`placement: 'hero'`), for every device bound to
56153
+ * this cap — never drawn by a device type's hero card itself (D915).
56091
56154
  *
56092
56155
  * Like `childLayout`, the cap is INERT until a provider sets items: no
56093
56156
  * provider populates it by guessing (no HA inference). The UI renders a
56094
56157
  * "No consumables reported" placeholder when `items` is empty.
56095
56158
  */
56159
+ /**
56160
+ * What an item IS, which decides which direction is bad:
56161
+ * - `wear` — a part that wears out (a brush, a filter); low life is bad.
56162
+ * - `supply` — something the device draws from (clean water, detergent,
56163
+ * salt, rinse aid); low or empty is bad.
56164
+ * - `waste` — something the device fills (dirty water, a dust bin); full is
56165
+ * bad.
56166
+ * Absent = `wear`.
56167
+ */
56168
+ var ConsumableKindSchema = _enum([
56169
+ "wear",
56170
+ "supply",
56171
+ "waste"
56172
+ ]);
56173
+ /**
56174
+ * What an item LOOKS like, which decides how a client draws it — independent
56175
+ * of `kind`, which decides which direction is bad:
56176
+ * - `part` — a part that wears (a brush, a filter, a mop pad): a wear bar,
56177
+ * remaining time and a reset.
56178
+ * - `tank` — a container of liquid (clean water, dirty water): a fill gauge.
56179
+ * - `product` — something bought and refilled (detergent, salt, rinse aid):
56180
+ * a stepped level and "refill".
56181
+ * - `bin` — a container that collects waste (a dust bin): a fill gauge
56182
+ * that warns when full.
56183
+ * Absent = derived from the kind ({@link consumableFormOf}).
56184
+ */
56185
+ var ConsumableFormSchema = _enum([
56186
+ "part",
56187
+ "tank",
56188
+ "product",
56189
+ "bin"
56190
+ ]);
56191
+ /** The provider's own discrete verdict on an item. */
56192
+ var ConsumableStatusSchema = _enum([
56193
+ "ok",
56194
+ "low",
56195
+ "empty",
56196
+ "full",
56197
+ "replace"
56198
+ ]);
56199
+ _enum([
56200
+ "ok",
56201
+ "low",
56202
+ "empty",
56203
+ "full"
56204
+ ]);
56096
56205
  /** Units a remaining-life counter is reported in. Closed: the panel renders
56097
56206
  * each. */
56098
56207
  var ConsumableRemainingUnitSchema = _enum([
@@ -56107,18 +56216,23 @@ var ConsumableRemainingSchema = object({
56107
56216
  unit: ConsumableRemainingUnitSchema
56108
56217
  });
56109
56218
  /** A single consumable item. Either a continuous `level` (remaining
56110
- * life %) or a discrete `status` may be known — both may be null when a
56111
- * provider only knows the item exists. `level` and `status` are not
56112
- * mutually exclusive; a provider may report both. */
56219
+ * life %, or fill % for a `supply` / `waste` item) or a discrete `status`
56220
+ * may be known — both may be null when a provider only knows the item
56221
+ * exists. `level` and `status` are not mutually exclusive; a provider may
56222
+ * report both. */
56113
56223
  var ConsumableItemSchema = object({
56114
56224
  /** Stable id, e.g. 'main-brush'. */
56115
56225
  key: string().min(1),
56116
56226
  /** Display name. */
56117
56227
  label: string().min(1),
56118
- /** Remaining life % when known (0..100). */
56228
+ /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
56119
56229
  level: number().min(0).max(100).nullable(),
56120
- /** Discrete state when known (binary mode). */
56121
- status: _enum(["ok", "replace"]).nullable(),
56230
+ /** The provider's discrete verdict when known (binary mode). */
56231
+ status: ConsumableStatusSchema.nullable(),
56232
+ /** What the item is — decides whether low or full is bad. Absent = `wear`. */
56233
+ kind: ConsumableKindSchema.optional(),
56234
+ /** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
56235
+ form: ConsumableFormSchema.optional(),
56122
56236
  /** Ms epoch of the last replace, when known. */
56123
56237
  lastResetAt: number().nullable(),
56124
56238
  /** Whether `reset()` is meaningful for this item. */
@@ -56141,7 +56255,7 @@ var consumablesCapability = {
56141
56255
  kind: "widget",
56142
56256
  widgetId: "host/consumables-panel",
56143
56257
  tab: "consumables",
56144
- topTab: true,
56258
+ placement: "hero",
56145
56259
  label: "Consumables",
56146
56260
  order: 5
56147
56261
  } },
@@ -56202,9 +56316,37 @@ reset: method(object({
56202
56316
  */
56203
56317
  durability: "restored",
56204
56318
  /**
56205
- * History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
56319
+ * History (D850, D917): one series per (item field, item `key`) — the item key
56320
+ * is the series scope, the item `label` names it. A vacuum tank's fill, a
56321
+ * brush's remaining life and a dishwasher's salt are each recorded the moment
56322
+ * their provider reports them; an item that appears later gets its series.
56206
56323
  */
56207
- history: "none",
56324
+ history: {
56325
+ fields: {},
56326
+ items: {
56327
+ path: "items",
56328
+ key: "key",
56329
+ label: "label",
56330
+ fields: {
56331
+ level: {
56332
+ kind: "gauge",
56333
+ unit: "%",
56334
+ deadband: 2,
56335
+ displayName: "Level"
56336
+ },
56337
+ status: {
56338
+ kind: "enum",
56339
+ displayName: "Status"
56340
+ },
56341
+ "remaining.value": {
56342
+ kind: "gauge",
56343
+ unitFrom: "remaining.unit",
56344
+ deadband: 1,
56345
+ displayName: "Remaining"
56346
+ }
56347
+ }
56348
+ }
56349
+ },
56208
56350
  /** Clocks, not content: a re-read that changed no item costs no commit. */
56209
56351
  volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
56210
56352
  };
@@ -56619,8 +56761,9 @@ onStatusChanged: { data: object({
56619
56761
  volatileStateFields: ["lastChangedAt"]
56620
56762
  };
56621
56763
  /**
56622
- * Smart-dishwasher cap — program lifecycle, door / remote-start gates,
56623
- * consumable levels (salt, rinse aid) and common program options.
56764
+ * Smart-dishwasher cap — program lifecycle, door / remote-start gates and
56765
+ * common program options. Salt and rinse aid are NOT here: they are items of
56766
+ * the device's `consumables` cap, like every other device's (D915).
56624
56767
  *
56625
56768
  * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
56626
56769
  * by any integration that exposes the same program / option surface.
@@ -56668,11 +56811,6 @@ var DishwasherAvailabilitySchema = _enum([
56668
56811
  "offline",
56669
56812
  "description-missing"
56670
56813
  ]);
56671
- var DishwasherConsumableLevelSchema = _enum([
56672
- "ok",
56673
- "low",
56674
- "empty"
56675
- ]);
56676
56814
  var DishwasherStatusSchema = object({
56677
56815
  availability: DishwasherAvailabilitySchema,
56678
56816
  /** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -56705,8 +56843,6 @@ var DishwasherStatusSchema = object({
56705
56843
  powerOn: boolean().nullable(),
56706
56844
  /** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
56707
56845
  powerState: string().nullable(),
56708
- saltLevel: DishwasherConsumableLevelSchema.nullable(),
56709
- rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
56710
56846
  /**
56711
56847
  * True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
56712
56848
  * combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -66083,60 +66219,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
66083
66219
  auth: "admin",
66084
66220
  access: "delete"
66085
66221
  });
66086
- /**
66087
- * Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
66088
- * cleaning lifecycle plus a return-to-base / locate surface and an
66089
- * optional fan-speed selector.
66090
- *
66091
- * State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
66092
- * `paused` / `returning` / `docked` / `error`. `batteryLevel`
66093
- * (0..100) is nullable — some vacuums don't report a battery
66094
- * percentage. `fanSpeed` is the current speed token (provider-verbatim,
66095
- * e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
66096
- * tokens the hardware accepts so the UI renders only supported choices.
66097
- *
66098
- * The `setFanSpeed` method takes the bare `speed` token — the provider
66099
- * validates it against the vacuum's own list. `locate` triggers the
66100
- * find-me chirp; `returnToBase` sends it home.
66101
- *
66102
- * Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
66103
- * `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
66104
- * 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
66105
- * SHOULD populate whichever tanks the hardware has — leave a field `null`
66106
- * only when the device has no such tank at all, and use a `TankStatus`
66107
- * with both inner fields `null` when the tank exists but its level is
66108
- * currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
66109
- * so the HA provider leaves all four `null`.
66110
- */
66111
- var VacuumStateSchema = _enum([
66112
- "idle",
66113
- "cleaning",
66114
- "paused",
66115
- "returning",
66116
- "docked",
66117
- "drying",
66118
- "error"
66119
- ]);
66120
- /**
66121
- * One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
66122
- * detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
66123
- * a discrete `status` (binary-style hardware), or both. Both `null` means the
66124
- * level is currently unknown; the OWNING field being `null` means the
66125
- * hardware has no such tank at all.
66126
- */
66127
- var TankStatusSchema = object({
66128
- /** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
66129
- level: number().min(0).max(100).nullable(),
66130
- /** Discrete state when the hardware is binary-mode; null otherwise. */
66131
- status: _enum([
66132
- "ok",
66133
- "low",
66134
- "full"
66135
- ]).nullable()
66136
- });
66137
66222
  var VacuumControlStatusSchema = object({
66138
66223
  /** Lifecycle state of the vacuum. */
66139
- state: VacuumStateSchema,
66224
+ state: _enum([
66225
+ "idle",
66226
+ "cleaning",
66227
+ "paused",
66228
+ "returning",
66229
+ "docked",
66230
+ "drying",
66231
+ "error"
66232
+ ]),
66140
66233
  /** 0..100 battery percentage. Null when the device has no battery
66141
66234
  * reading. */
66142
66235
  batteryLevel: number().min(0).max(100).nullable(),
@@ -66145,14 +66238,6 @@ var VacuumControlStatusSchema = object({
66145
66238
  fanSpeed: string().nullable(),
66146
66239
  /** Speed tokens the hardware accepts — drives the UI selector. */
66147
66240
  availableFanSpeeds: array(string()),
66148
- /** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
66149
- cleanWater: TankStatusSchema.nullable(),
66150
- /** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
66151
- dirtyWater: TankStatusSchema.nullable(),
66152
- /** Detergent tank. Null when the hardware has no detergent tank. */
66153
- detergent: TankStatusSchema.nullable(),
66154
- /** Dust bin. Null when the hardware has no dust bin. */
66155
- dustBin: TankStatusSchema.nullable(),
66156
66241
  /** 0..100 cleaning-completion percentage of the current task, or null. */
66157
66242
  progressPercent: number().min(0).max(100).nullable(),
66158
66243
  /** Current error code (0 / null = no error). */
@@ -66214,35 +66299,14 @@ var vacuumControlCapability = {
66214
66299
  */
66215
66300
  durability: "session",
66216
66301
  /**
66217
- * History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
66302
+ * History (D850): recorded series. The tanks moved to `consumables` (D915), whose
66303
+ * items are keyed by runtime ids and record no history.
66218
66304
  */
66219
- history: { fields: {
66220
- batteryLevel: {
66221
- kind: "gauge",
66222
- unit: "%",
66223
- deadband: 2
66224
- },
66225
- "cleanWater.level": {
66226
- kind: "gauge",
66227
- unit: "%",
66228
- deadband: 2
66229
- },
66230
- "dirtyWater.level": {
66231
- kind: "gauge",
66232
- unit: "%",
66233
- deadband: 2
66234
- },
66235
- "detergent.level": {
66236
- kind: "gauge",
66237
- unit: "%",
66238
- deadband: 2
66239
- },
66240
- "dustBin.level": {
66241
- kind: "gauge",
66242
- unit: "%",
66243
- deadband: 2
66244
- }
66245
- } }
66305
+ history: { fields: { batteryLevel: {
66306
+ kind: "gauge",
66307
+ unit: "%",
66308
+ deadband: 2
66309
+ } } }
66246
66310
  };
66247
66311
  var ValveStatusSchema = object({
66248
66312
  /** Lifecycle state of the valve. */
@@ -70655,6 +70719,12 @@ Object.freeze({
70655
70719
  addonId: null,
70656
70720
  access: "create"
70657
70721
  },
70722
+ "deviceHistory.deleteOrphanSeries": {
70723
+ capName: "device-history",
70724
+ capScope: "system",
70725
+ addonId: null,
70726
+ access: "delete"
70727
+ },
70658
70728
  "deviceHistory.getDeviceEnabled": {
70659
70729
  capName: "device-history",
70660
70730
  capScope: "system",
@@ -70673,6 +70743,12 @@ Object.freeze({
70673
70743
  addonId: null,
70674
70744
  access: "view"
70675
70745
  },
70746
+ "deviceHistory.listOrphanSeries": {
70747
+ capName: "device-history",
70748
+ capScope: "system",
70749
+ addonId: null,
70750
+ access: "view"
70751
+ },
70676
70752
  "deviceHistory.listSeries": {
70677
70753
  capName: "device-history",
70678
70754
  capScope: "system",
@@ -80896,7 +80972,7 @@ var STATE_SUMMARY_VARS = [
80896
80972
  ([...RULE_TEXT], [...COMBINED_ALARM]),
80897
80973
  ([...RULE_TEXT], [...DEVICE_EVENTS]),
80898
80974
  ([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
80899
- ([...RULE_TEXT], [...CONSUMABLE]),
80975
+ ([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
80900
80976
  ([...RULE_TEXT], [...TANK]),
80901
80977
  [...RULE_TEXT],
80902
80978
  ([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
package/dist/addon.mjs CHANGED
@@ -5445,7 +5445,7 @@ var ZodIssueCode = {
5445
5445
  var ZodFirstPartyTypeKind;
5446
5446
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5447
5447
  //#endregion
5448
- //#region ../types/dist/sleep-DJFUfKvA.mjs
5448
+ //#region ../types/dist/sleep-CUp20JkO.mjs
5449
5449
  /**
5450
5450
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5451
5451
  * window to float samples (D455).
@@ -8337,7 +8337,11 @@ var ContributionSectionSchema = object({
8337
8337
  literal(4)
8338
8338
  ]).optional(),
8339
8339
  tab: string().optional(),
8340
- location: _enum(["settings", "top-tab"]).optional(),
8340
+ location: _enum([
8341
+ "settings",
8342
+ "top-tab",
8343
+ "hero"
8344
+ ]).optional(),
8341
8345
  order: number().optional(),
8342
8346
  fields: array(any())
8343
8347
  });
@@ -13587,7 +13591,11 @@ var ConfigSectionWithValuesSchema = object({
13587
13591
  literal(4)
13588
13592
  ]).optional(),
13589
13593
  tab: string().optional(),
13590
- location: _enum(["settings", "top-tab"]).optional(),
13594
+ location: _enum([
13595
+ "settings",
13596
+ "top-tab",
13597
+ "hero"
13598
+ ]).optional(),
13591
13599
  order: number().optional(),
13592
13600
  fields: array(any())
13593
13601
  });
@@ -17467,6 +17475,52 @@ var TierStatusSchema = object({
17467
17475
  countedAt: number().nullable()
17468
17476
  });
17469
17477
  /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
17478
+ /**
17479
+ * Why a series is orphan. `device-gone`: its device is absent from the
17480
+ * successful device listings (the departure clock). `undeclared`: its `cap:`
17481
+ * key is declared by no capability any more (a field a cap removed).
17482
+ */
17483
+ var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
17484
+ /** Rows held per stored tier. */
17485
+ var TierRowsSchema = object({
17486
+ raw: number().int(),
17487
+ "5m": number().int(),
17488
+ "1h": number().int(),
17489
+ "1d": number().int()
17490
+ });
17491
+ var OrphanSeriesSchema = object({
17492
+ seriesId: number().int(),
17493
+ deviceId: number().int(),
17494
+ key: string(),
17495
+ scope: string(),
17496
+ /** The metric's display name; `null` when its metric row is gone too. */
17497
+ displayName: string().nullable(),
17498
+ reason: DeviceHistoryOrphanReasonSchema,
17499
+ /** `device-gone`: since when the device has been absent; `null` otherwise. */
17500
+ missingSince: number().nullable(),
17501
+ firstTs: number(),
17502
+ lastTs: number(),
17503
+ rows: TierRowsSchema
17504
+ });
17505
+ var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
17506
+ "not-found",
17507
+ "not-orphan",
17508
+ "failed"
17509
+ ]);
17510
+ var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
17511
+ seriesId: number().int(),
17512
+ ok: literal(true),
17513
+ deleted: TierRowsSchema
17514
+ }), object({
17515
+ seriesId: number().int(),
17516
+ ok: literal(false),
17517
+ reason: DeviceHistoryOrphanDeleteRefusalSchema
17518
+ })]);
17519
+ var OrphanListSchema = object({
17520
+ series: array(OrphanSeriesSchema).readonly(),
17521
+ /** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
17522
+ truncated: boolean()
17523
+ });
17470
17524
  var DeviceHistoryStatusSchema = object({
17471
17525
  startedAt: number(),
17472
17526
  /** The store is declared, series loaded and the first reconcile has answered. */
@@ -17564,7 +17618,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
17564
17618
  }), object({ enabled: boolean() }), {
17565
17619
  kind: "mutation",
17566
17620
  auth: "admin"
17567
- }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
17621
+ }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" }), method(object({}), OrphanListSchema, { auth: "admin" }), method(object({ seriesIds: array(number().int()).min(1).max(50) }), object({ results: array(OrphanDeleteEntrySchema).readonly() }), {
17622
+ kind: "mutation",
17623
+ auth: "admin"
17624
+ });
17568
17625
  var DeviceCaStatusSchema = discriminatedUnion("state", [
17569
17626
  object({ state: literal("absent") }),
17570
17627
  object({
@@ -56061,17 +56118,69 @@ var connectivityCapability = {
56061
56118
  volatileStateFields: ["lastChangedAt"]
56062
56119
  };
56063
56120
  /**
56064
- * Generic device-consumables capability — surfaces a device's
56065
- * maintenance items (vacuum filters/brushes, replaceable cartridges,
56066
- * descaling cycles, …) with their remaining life and an optional
56067
- * "Replaced" reset action. Device-agnostic: any provider that knows its
56068
- * device tracks consumables can register it; the cap declares no
56069
- * vocabulary of its own — the provider names each item verbatim.
56121
+ * Generic device-consumables capability — the ONE place a device reports what
56122
+ * it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
56123
+ * descaling cycles), supplies it draws from (a vacuum's clean-water tank and
56124
+ * detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
56125
+ * water tank, a dust bin). Each item carries its remaining life or fill and an
56126
+ * optional "Replaced" reset action. Device-agnostic: any provider that knows
56127
+ * its device tracks consumables registers it; the provider names each item
56128
+ * verbatim and says which `kind` it is.
56129
+ *
56130
+ * The admin UI renders it as ONE collapsible section directly under the
56131
+ * device page's hero card (`placement: 'hero'`), for every device bound to
56132
+ * this cap — never drawn by a device type's hero card itself (D915).
56070
56133
  *
56071
56134
  * Like `childLayout`, the cap is INERT until a provider sets items: no
56072
56135
  * provider populates it by guessing (no HA inference). The UI renders a
56073
56136
  * "No consumables reported" placeholder when `items` is empty.
56074
56137
  */
56138
+ /**
56139
+ * What an item IS, which decides which direction is bad:
56140
+ * - `wear` — a part that wears out (a brush, a filter); low life is bad.
56141
+ * - `supply` — something the device draws from (clean water, detergent,
56142
+ * salt, rinse aid); low or empty is bad.
56143
+ * - `waste` — something the device fills (dirty water, a dust bin); full is
56144
+ * bad.
56145
+ * Absent = `wear`.
56146
+ */
56147
+ var ConsumableKindSchema = _enum([
56148
+ "wear",
56149
+ "supply",
56150
+ "waste"
56151
+ ]);
56152
+ /**
56153
+ * What an item LOOKS like, which decides how a client draws it — independent
56154
+ * of `kind`, which decides which direction is bad:
56155
+ * - `part` — a part that wears (a brush, a filter, a mop pad): a wear bar,
56156
+ * remaining time and a reset.
56157
+ * - `tank` — a container of liquid (clean water, dirty water): a fill gauge.
56158
+ * - `product` — something bought and refilled (detergent, salt, rinse aid):
56159
+ * a stepped level and "refill".
56160
+ * - `bin` — a container that collects waste (a dust bin): a fill gauge
56161
+ * that warns when full.
56162
+ * Absent = derived from the kind ({@link consumableFormOf}).
56163
+ */
56164
+ var ConsumableFormSchema = _enum([
56165
+ "part",
56166
+ "tank",
56167
+ "product",
56168
+ "bin"
56169
+ ]);
56170
+ /** The provider's own discrete verdict on an item. */
56171
+ var ConsumableStatusSchema = _enum([
56172
+ "ok",
56173
+ "low",
56174
+ "empty",
56175
+ "full",
56176
+ "replace"
56177
+ ]);
56178
+ _enum([
56179
+ "ok",
56180
+ "low",
56181
+ "empty",
56182
+ "full"
56183
+ ]);
56075
56184
  /** Units a remaining-life counter is reported in. Closed: the panel renders
56076
56185
  * each. */
56077
56186
  var ConsumableRemainingUnitSchema = _enum([
@@ -56086,18 +56195,23 @@ var ConsumableRemainingSchema = object({
56086
56195
  unit: ConsumableRemainingUnitSchema
56087
56196
  });
56088
56197
  /** A single consumable item. Either a continuous `level` (remaining
56089
- * life %) or a discrete `status` may be known — both may be null when a
56090
- * provider only knows the item exists. `level` and `status` are not
56091
- * mutually exclusive; a provider may report both. */
56198
+ * life %, or fill % for a `supply` / `waste` item) or a discrete `status`
56199
+ * may be known — both may be null when a provider only knows the item
56200
+ * exists. `level` and `status` are not mutually exclusive; a provider may
56201
+ * report both. */
56092
56202
  var ConsumableItemSchema = object({
56093
56203
  /** Stable id, e.g. 'main-brush'. */
56094
56204
  key: string().min(1),
56095
56205
  /** Display name. */
56096
56206
  label: string().min(1),
56097
- /** Remaining life % when known (0..100). */
56207
+ /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
56098
56208
  level: number().min(0).max(100).nullable(),
56099
- /** Discrete state when known (binary mode). */
56100
- status: _enum(["ok", "replace"]).nullable(),
56209
+ /** The provider's discrete verdict when known (binary mode). */
56210
+ status: ConsumableStatusSchema.nullable(),
56211
+ /** What the item is — decides whether low or full is bad. Absent = `wear`. */
56212
+ kind: ConsumableKindSchema.optional(),
56213
+ /** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
56214
+ form: ConsumableFormSchema.optional(),
56101
56215
  /** Ms epoch of the last replace, when known. */
56102
56216
  lastResetAt: number().nullable(),
56103
56217
  /** Whether `reset()` is meaningful for this item. */
@@ -56120,7 +56234,7 @@ var consumablesCapability = {
56120
56234
  kind: "widget",
56121
56235
  widgetId: "host/consumables-panel",
56122
56236
  tab: "consumables",
56123
- topTab: true,
56237
+ placement: "hero",
56124
56238
  label: "Consumables",
56125
56239
  order: 5
56126
56240
  } },
@@ -56181,9 +56295,37 @@ reset: method(object({
56181
56295
  */
56182
56296
  durability: "restored",
56183
56297
  /**
56184
- * History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
56298
+ * History (D850, D917): one series per (item field, item `key`) — the item key
56299
+ * is the series scope, the item `label` names it. A vacuum tank's fill, a
56300
+ * brush's remaining life and a dishwasher's salt are each recorded the moment
56301
+ * their provider reports them; an item that appears later gets its series.
56185
56302
  */
56186
- history: "none",
56303
+ history: {
56304
+ fields: {},
56305
+ items: {
56306
+ path: "items",
56307
+ key: "key",
56308
+ label: "label",
56309
+ fields: {
56310
+ level: {
56311
+ kind: "gauge",
56312
+ unit: "%",
56313
+ deadband: 2,
56314
+ displayName: "Level"
56315
+ },
56316
+ status: {
56317
+ kind: "enum",
56318
+ displayName: "Status"
56319
+ },
56320
+ "remaining.value": {
56321
+ kind: "gauge",
56322
+ unitFrom: "remaining.unit",
56323
+ deadband: 1,
56324
+ displayName: "Remaining"
56325
+ }
56326
+ }
56327
+ }
56328
+ },
56187
56329
  /** Clocks, not content: a re-read that changed no item costs no commit. */
56188
56330
  volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
56189
56331
  };
@@ -56598,8 +56740,9 @@ onStatusChanged: { data: object({
56598
56740
  volatileStateFields: ["lastChangedAt"]
56599
56741
  };
56600
56742
  /**
56601
- * Smart-dishwasher cap — program lifecycle, door / remote-start gates,
56602
- * consumable levels (salt, rinse aid) and common program options.
56743
+ * Smart-dishwasher cap — program lifecycle, door / remote-start gates and
56744
+ * common program options. Salt and rinse aid are NOT here: they are items of
56745
+ * the device's `consumables` cap, like every other device's (D915).
56603
56746
  *
56604
56747
  * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
56605
56748
  * by any integration that exposes the same program / option surface.
@@ -56647,11 +56790,6 @@ var DishwasherAvailabilitySchema = _enum([
56647
56790
  "offline",
56648
56791
  "description-missing"
56649
56792
  ]);
56650
- var DishwasherConsumableLevelSchema = _enum([
56651
- "ok",
56652
- "low",
56653
- "empty"
56654
- ]);
56655
56793
  var DishwasherStatusSchema = object({
56656
56794
  availability: DishwasherAvailabilitySchema,
56657
56795
  /** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -56684,8 +56822,6 @@ var DishwasherStatusSchema = object({
56684
56822
  powerOn: boolean().nullable(),
56685
56823
  /** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
56686
56824
  powerState: string().nullable(),
56687
- saltLevel: DishwasherConsumableLevelSchema.nullable(),
56688
- rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
56689
56825
  /**
56690
56826
  * True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
56691
56827
  * combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -66062,60 +66198,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
66062
66198
  auth: "admin",
66063
66199
  access: "delete"
66064
66200
  });
66065
- /**
66066
- * Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
66067
- * cleaning lifecycle plus a return-to-base / locate surface and an
66068
- * optional fan-speed selector.
66069
- *
66070
- * State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
66071
- * `paused` / `returning` / `docked` / `error`. `batteryLevel`
66072
- * (0..100) is nullable — some vacuums don't report a battery
66073
- * percentage. `fanSpeed` is the current speed token (provider-verbatim,
66074
- * e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
66075
- * tokens the hardware accepts so the UI renders only supported choices.
66076
- *
66077
- * The `setFanSpeed` method takes the bare `speed` token — the provider
66078
- * validates it against the vacuum's own list. `locate` triggers the
66079
- * find-me chirp; `returnToBase` sends it home.
66080
- *
66081
- * Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
66082
- * `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
66083
- * 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
66084
- * SHOULD populate whichever tanks the hardware has — leave a field `null`
66085
- * only when the device has no such tank at all, and use a `TankStatus`
66086
- * with both inner fields `null` when the tank exists but its level is
66087
- * currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
66088
- * so the HA provider leaves all four `null`.
66089
- */
66090
- var VacuumStateSchema = _enum([
66091
- "idle",
66092
- "cleaning",
66093
- "paused",
66094
- "returning",
66095
- "docked",
66096
- "drying",
66097
- "error"
66098
- ]);
66099
- /**
66100
- * One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
66101
- * detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
66102
- * a discrete `status` (binary-style hardware), or both. Both `null` means the
66103
- * level is currently unknown; the OWNING field being `null` means the
66104
- * hardware has no such tank at all.
66105
- */
66106
- var TankStatusSchema = object({
66107
- /** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
66108
- level: number().min(0).max(100).nullable(),
66109
- /** Discrete state when the hardware is binary-mode; null otherwise. */
66110
- status: _enum([
66111
- "ok",
66112
- "low",
66113
- "full"
66114
- ]).nullable()
66115
- });
66116
66201
  var VacuumControlStatusSchema = object({
66117
66202
  /** Lifecycle state of the vacuum. */
66118
- state: VacuumStateSchema,
66203
+ state: _enum([
66204
+ "idle",
66205
+ "cleaning",
66206
+ "paused",
66207
+ "returning",
66208
+ "docked",
66209
+ "drying",
66210
+ "error"
66211
+ ]),
66119
66212
  /** 0..100 battery percentage. Null when the device has no battery
66120
66213
  * reading. */
66121
66214
  batteryLevel: number().min(0).max(100).nullable(),
@@ -66124,14 +66217,6 @@ var VacuumControlStatusSchema = object({
66124
66217
  fanSpeed: string().nullable(),
66125
66218
  /** Speed tokens the hardware accepts — drives the UI selector. */
66126
66219
  availableFanSpeeds: array(string()),
66127
- /** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
66128
- cleanWater: TankStatusSchema.nullable(),
66129
- /** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
66130
- dirtyWater: TankStatusSchema.nullable(),
66131
- /** Detergent tank. Null when the hardware has no detergent tank. */
66132
- detergent: TankStatusSchema.nullable(),
66133
- /** Dust bin. Null when the hardware has no dust bin. */
66134
- dustBin: TankStatusSchema.nullable(),
66135
66220
  /** 0..100 cleaning-completion percentage of the current task, or null. */
66136
66221
  progressPercent: number().min(0).max(100).nullable(),
66137
66222
  /** Current error code (0 / null = no error). */
@@ -66193,35 +66278,14 @@ var vacuumControlCapability = {
66193
66278
  */
66194
66279
  durability: "session",
66195
66280
  /**
66196
- * History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
66281
+ * History (D850): recorded series. The tanks moved to `consumables` (D915), whose
66282
+ * items are keyed by runtime ids and record no history.
66197
66283
  */
66198
- history: { fields: {
66199
- batteryLevel: {
66200
- kind: "gauge",
66201
- unit: "%",
66202
- deadband: 2
66203
- },
66204
- "cleanWater.level": {
66205
- kind: "gauge",
66206
- unit: "%",
66207
- deadband: 2
66208
- },
66209
- "dirtyWater.level": {
66210
- kind: "gauge",
66211
- unit: "%",
66212
- deadband: 2
66213
- },
66214
- "detergent.level": {
66215
- kind: "gauge",
66216
- unit: "%",
66217
- deadband: 2
66218
- },
66219
- "dustBin.level": {
66220
- kind: "gauge",
66221
- unit: "%",
66222
- deadband: 2
66223
- }
66224
- } }
66284
+ history: { fields: { batteryLevel: {
66285
+ kind: "gauge",
66286
+ unit: "%",
66287
+ deadband: 2
66288
+ } } }
66225
66289
  };
66226
66290
  var ValveStatusSchema = object({
66227
66291
  /** Lifecycle state of the valve. */
@@ -70634,6 +70698,12 @@ Object.freeze({
70634
70698
  addonId: null,
70635
70699
  access: "create"
70636
70700
  },
70701
+ "deviceHistory.deleteOrphanSeries": {
70702
+ capName: "device-history",
70703
+ capScope: "system",
70704
+ addonId: null,
70705
+ access: "delete"
70706
+ },
70637
70707
  "deviceHistory.getDeviceEnabled": {
70638
70708
  capName: "device-history",
70639
70709
  capScope: "system",
@@ -70652,6 +70722,12 @@ Object.freeze({
70652
70722
  addonId: null,
70653
70723
  access: "view"
70654
70724
  },
70725
+ "deviceHistory.listOrphanSeries": {
70726
+ capName: "device-history",
70727
+ capScope: "system",
70728
+ addonId: null,
70729
+ access: "view"
70730
+ },
70655
70731
  "deviceHistory.listSeries": {
70656
70732
  capName: "device-history",
70657
70733
  capScope: "system",
@@ -80875,7 +80951,7 @@ var STATE_SUMMARY_VARS = [
80875
80951
  ([...RULE_TEXT], [...COMBINED_ALARM]),
80876
80952
  ([...RULE_TEXT], [...DEVICE_EVENTS]),
80877
80953
  ([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
80878
- ([...RULE_TEXT], [...CONSUMABLE]),
80954
+ ([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
80879
80955
  ([...RULE_TEXT], [...TANK]),
80880
80956
  [...RULE_TEXT],
80881
80957
  ([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-hikvision",
3
- "version": "1.2.169",
3
+ "version": "1.2.170",
4
4
  "description": "Hikvision camera device provider addon for CamStack — ISAPI over HTTP(S) with digest auth (snapshot, alarm stream, RTSP discovery)",
5
5
  "keywords": [
6
6
  "camstack",