@camstack/addon-provider-unifi 0.2.143 → 0.2.144

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
@@ -5431,7 +5431,7 @@ var ZodIssueCode = {
5431
5431
  var ZodFirstPartyTypeKind;
5432
5432
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5433
5433
  //#endregion
5434
- //#region ../types/dist/sleep-DJFUfKvA.mjs
5434
+ //#region ../types/dist/sleep-CUp20JkO.mjs
5435
5435
  /**
5436
5436
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5437
5437
  * window to float samples (D455).
@@ -8323,7 +8323,11 @@ var ContributionSectionSchema = object({
8323
8323
  literal(4)
8324
8324
  ]).optional(),
8325
8325
  tab: string().optional(),
8326
- location: _enum(["settings", "top-tab"]).optional(),
8326
+ location: _enum([
8327
+ "settings",
8328
+ "top-tab",
8329
+ "hero"
8330
+ ]).optional(),
8327
8331
  order: number().optional(),
8328
8332
  fields: array(any())
8329
8333
  });
@@ -13270,7 +13274,11 @@ var ConfigSectionWithValuesSchema = object({
13270
13274
  literal(4)
13271
13275
  ]).optional(),
13272
13276
  tab: string().optional(),
13273
- location: _enum(["settings", "top-tab"]).optional(),
13277
+ location: _enum([
13278
+ "settings",
13279
+ "top-tab",
13280
+ "hero"
13281
+ ]).optional(),
13274
13282
  order: number().optional(),
13275
13283
  fields: array(any())
13276
13284
  });
@@ -17150,6 +17158,52 @@ var TierStatusSchema = object({
17150
17158
  countedAt: number().nullable()
17151
17159
  });
17152
17160
  /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
17161
+ /**
17162
+ * Why a series is orphan. `device-gone`: its device is absent from the
17163
+ * successful device listings (the departure clock). `undeclared`: its `cap:`
17164
+ * key is declared by no capability any more (a field a cap removed).
17165
+ */
17166
+ var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
17167
+ /** Rows held per stored tier. */
17168
+ var TierRowsSchema = object({
17169
+ raw: number().int(),
17170
+ "5m": number().int(),
17171
+ "1h": number().int(),
17172
+ "1d": number().int()
17173
+ });
17174
+ var OrphanSeriesSchema = object({
17175
+ seriesId: number().int(),
17176
+ deviceId: number().int(),
17177
+ key: string(),
17178
+ scope: string(),
17179
+ /** The metric's display name; `null` when its metric row is gone too. */
17180
+ displayName: string().nullable(),
17181
+ reason: DeviceHistoryOrphanReasonSchema,
17182
+ /** `device-gone`: since when the device has been absent; `null` otherwise. */
17183
+ missingSince: number().nullable(),
17184
+ firstTs: number(),
17185
+ lastTs: number(),
17186
+ rows: TierRowsSchema
17187
+ });
17188
+ var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
17189
+ "not-found",
17190
+ "not-orphan",
17191
+ "failed"
17192
+ ]);
17193
+ var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
17194
+ seriesId: number().int(),
17195
+ ok: literal(true),
17196
+ deleted: TierRowsSchema
17197
+ }), object({
17198
+ seriesId: number().int(),
17199
+ ok: literal(false),
17200
+ reason: DeviceHistoryOrphanDeleteRefusalSchema
17201
+ })]);
17202
+ var OrphanListSchema = object({
17203
+ series: array(OrphanSeriesSchema).readonly(),
17204
+ /** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
17205
+ truncated: boolean()
17206
+ });
17153
17207
  var DeviceHistoryStatusSchema = object({
17154
17208
  startedAt: number(),
17155
17209
  /** The store is declared, series loaded and the first reconcile has answered. */
@@ -17247,7 +17301,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
17247
17301
  }), object({ enabled: boolean() }), {
17248
17302
  kind: "mutation",
17249
17303
  auth: "admin"
17250
- }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
17304
+ }), 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() }), {
17305
+ kind: "mutation",
17306
+ auth: "admin"
17307
+ });
17251
17308
  var DeviceCaStatusSchema = discriminatedUnion("state", [
17252
17309
  object({ state: literal("absent") }),
17253
17310
  object({
@@ -55220,17 +55277,69 @@ var connectivityCapability = {
55220
55277
  volatileStateFields: ["lastChangedAt"]
55221
55278
  };
55222
55279
  /**
55223
- * Generic device-consumables capability — surfaces a device's
55224
- * maintenance items (vacuum filters/brushes, replaceable cartridges,
55225
- * descaling cycles, …) with their remaining life and an optional
55226
- * "Replaced" reset action. Device-agnostic: any provider that knows its
55227
- * device tracks consumables can register it; the cap declares no
55228
- * vocabulary of its own — the provider names each item verbatim.
55280
+ * Generic device-consumables capability — the ONE place a device reports what
55281
+ * it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
55282
+ * descaling cycles), supplies it draws from (a vacuum's clean-water tank and
55283
+ * detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
55284
+ * water tank, a dust bin). Each item carries its remaining life or fill and an
55285
+ * optional "Replaced" reset action. Device-agnostic: any provider that knows
55286
+ * its device tracks consumables registers it; the provider names each item
55287
+ * verbatim and says which `kind` it is.
55288
+ *
55289
+ * The admin UI renders it as ONE collapsible section directly under the
55290
+ * device page's hero card (`placement: 'hero'`), for every device bound to
55291
+ * this cap — never drawn by a device type's hero card itself (D915).
55229
55292
  *
55230
55293
  * Like `childLayout`, the cap is INERT until a provider sets items: no
55231
55294
  * provider populates it by guessing (no HA inference). The UI renders a
55232
55295
  * "No consumables reported" placeholder when `items` is empty.
55233
55296
  */
55297
+ /**
55298
+ * What an item IS, which decides which direction is bad:
55299
+ * - `wear` — a part that wears out (a brush, a filter); low life is bad.
55300
+ * - `supply` — something the device draws from (clean water, detergent,
55301
+ * salt, rinse aid); low or empty is bad.
55302
+ * - `waste` — something the device fills (dirty water, a dust bin); full is
55303
+ * bad.
55304
+ * Absent = `wear`.
55305
+ */
55306
+ var ConsumableKindSchema = _enum([
55307
+ "wear",
55308
+ "supply",
55309
+ "waste"
55310
+ ]);
55311
+ /**
55312
+ * What an item LOOKS like, which decides how a client draws it — independent
55313
+ * of `kind`, which decides which direction is bad:
55314
+ * - `part` — a part that wears (a brush, a filter, a mop pad): a wear bar,
55315
+ * remaining time and a reset.
55316
+ * - `tank` — a container of liquid (clean water, dirty water): a fill gauge.
55317
+ * - `product` — something bought and refilled (detergent, salt, rinse aid):
55318
+ * a stepped level and "refill".
55319
+ * - `bin` — a container that collects waste (a dust bin): a fill gauge
55320
+ * that warns when full.
55321
+ * Absent = derived from the kind ({@link consumableFormOf}).
55322
+ */
55323
+ var ConsumableFormSchema = _enum([
55324
+ "part",
55325
+ "tank",
55326
+ "product",
55327
+ "bin"
55328
+ ]);
55329
+ /** The provider's own discrete verdict on an item. */
55330
+ var ConsumableStatusSchema = _enum([
55331
+ "ok",
55332
+ "low",
55333
+ "empty",
55334
+ "full",
55335
+ "replace"
55336
+ ]);
55337
+ _enum([
55338
+ "ok",
55339
+ "low",
55340
+ "empty",
55341
+ "full"
55342
+ ]);
55234
55343
  /** Units a remaining-life counter is reported in. Closed: the panel renders
55235
55344
  * each. */
55236
55345
  var ConsumableRemainingUnitSchema = _enum([
@@ -55245,18 +55354,23 @@ var ConsumableRemainingSchema = object({
55245
55354
  unit: ConsumableRemainingUnitSchema
55246
55355
  });
55247
55356
  /** A single consumable item. Either a continuous `level` (remaining
55248
- * life %) or a discrete `status` may be known — both may be null when a
55249
- * provider only knows the item exists. `level` and `status` are not
55250
- * mutually exclusive; a provider may report both. */
55357
+ * life %, or fill % for a `supply` / `waste` item) or a discrete `status`
55358
+ * may be known — both may be null when a provider only knows the item
55359
+ * exists. `level` and `status` are not mutually exclusive; a provider may
55360
+ * report both. */
55251
55361
  var ConsumableItemSchema = object({
55252
55362
  /** Stable id, e.g. 'main-brush'. */
55253
55363
  key: string().min(1),
55254
55364
  /** Display name. */
55255
55365
  label: string().min(1),
55256
- /** Remaining life % when known (0..100). */
55366
+ /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
55257
55367
  level: number().min(0).max(100).nullable(),
55258
- /** Discrete state when known (binary mode). */
55259
- status: _enum(["ok", "replace"]).nullable(),
55368
+ /** The provider's discrete verdict when known (binary mode). */
55369
+ status: ConsumableStatusSchema.nullable(),
55370
+ /** What the item is — decides whether low or full is bad. Absent = `wear`. */
55371
+ kind: ConsumableKindSchema.optional(),
55372
+ /** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
55373
+ form: ConsumableFormSchema.optional(),
55260
55374
  /** Ms epoch of the last replace, when known. */
55261
55375
  lastResetAt: number().nullable(),
55262
55376
  /** Whether `reset()` is meaningful for this item. */
@@ -55279,7 +55393,7 @@ var consumablesCapability = {
55279
55393
  kind: "widget",
55280
55394
  widgetId: "host/consumables-panel",
55281
55395
  tab: "consumables",
55282
- topTab: true,
55396
+ placement: "hero",
55283
55397
  label: "Consumables",
55284
55398
  order: 5
55285
55399
  } },
@@ -55340,9 +55454,37 @@ reset: method(object({
55340
55454
  */
55341
55455
  durability: "restored",
55342
55456
  /**
55343
- * History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
55457
+ * History (D850, D917): one series per (item field, item `key`) — the item key
55458
+ * is the series scope, the item `label` names it. A vacuum tank's fill, a
55459
+ * brush's remaining life and a dishwasher's salt are each recorded the moment
55460
+ * their provider reports them; an item that appears later gets its series.
55344
55461
  */
55345
- history: "none",
55462
+ history: {
55463
+ fields: {},
55464
+ items: {
55465
+ path: "items",
55466
+ key: "key",
55467
+ label: "label",
55468
+ fields: {
55469
+ level: {
55470
+ kind: "gauge",
55471
+ unit: "%",
55472
+ deadband: 2,
55473
+ displayName: "Level"
55474
+ },
55475
+ status: {
55476
+ kind: "enum",
55477
+ displayName: "Status"
55478
+ },
55479
+ "remaining.value": {
55480
+ kind: "gauge",
55481
+ unitFrom: "remaining.unit",
55482
+ deadband: 1,
55483
+ displayName: "Remaining"
55484
+ }
55485
+ }
55486
+ }
55487
+ },
55346
55488
  /** Clocks, not content: a re-read that changed no item costs no commit. */
55347
55489
  volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
55348
55490
  };
@@ -55757,8 +55899,9 @@ onStatusChanged: { data: object({
55757
55899
  volatileStateFields: ["lastChangedAt"]
55758
55900
  };
55759
55901
  /**
55760
- * Smart-dishwasher cap — program lifecycle, door / remote-start gates,
55761
- * consumable levels (salt, rinse aid) and common program options.
55902
+ * Smart-dishwasher cap — program lifecycle, door / remote-start gates and
55903
+ * common program options. Salt and rinse aid are NOT here: they are items of
55904
+ * the device's `consumables` cap, like every other device's (D915).
55762
55905
  *
55763
55906
  * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
55764
55907
  * by any integration that exposes the same program / option surface.
@@ -55806,11 +55949,6 @@ var DishwasherAvailabilitySchema = _enum([
55806
55949
  "offline",
55807
55950
  "description-missing"
55808
55951
  ]);
55809
- var DishwasherConsumableLevelSchema = _enum([
55810
- "ok",
55811
- "low",
55812
- "empty"
55813
- ]);
55814
55952
  var DishwasherStatusSchema = object({
55815
55953
  availability: DishwasherAvailabilitySchema,
55816
55954
  /** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -55843,8 +55981,6 @@ var DishwasherStatusSchema = object({
55843
55981
  powerOn: boolean().nullable(),
55844
55982
  /** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
55845
55983
  powerState: string().nullable(),
55846
- saltLevel: DishwasherConsumableLevelSchema.nullable(),
55847
- rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
55848
55984
  /**
55849
55985
  * True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
55850
55986
  * combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -64660,60 +64796,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
64660
64796
  auth: "admin",
64661
64797
  access: "delete"
64662
64798
  });
64663
- /**
64664
- * Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
64665
- * cleaning lifecycle plus a return-to-base / locate surface and an
64666
- * optional fan-speed selector.
64667
- *
64668
- * State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
64669
- * `paused` / `returning` / `docked` / `error`. `batteryLevel`
64670
- * (0..100) is nullable — some vacuums don't report a battery
64671
- * percentage. `fanSpeed` is the current speed token (provider-verbatim,
64672
- * e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
64673
- * tokens the hardware accepts so the UI renders only supported choices.
64674
- *
64675
- * The `setFanSpeed` method takes the bare `speed` token — the provider
64676
- * validates it against the vacuum's own list. `locate` triggers the
64677
- * find-me chirp; `returnToBase` sends it home.
64678
- *
64679
- * Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
64680
- * `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
64681
- * 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
64682
- * SHOULD populate whichever tanks the hardware has — leave a field `null`
64683
- * only when the device has no such tank at all, and use a `TankStatus`
64684
- * with both inner fields `null` when the tank exists but its level is
64685
- * currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
64686
- * so the HA provider leaves all four `null`.
64687
- */
64688
- var VacuumStateSchema = _enum([
64689
- "idle",
64690
- "cleaning",
64691
- "paused",
64692
- "returning",
64693
- "docked",
64694
- "drying",
64695
- "error"
64696
- ]);
64697
- /**
64698
- * One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
64699
- * detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
64700
- * a discrete `status` (binary-style hardware), or both. Both `null` means the
64701
- * level is currently unknown; the OWNING field being `null` means the
64702
- * hardware has no such tank at all.
64703
- */
64704
- var TankStatusSchema = object({
64705
- /** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
64706
- level: number().min(0).max(100).nullable(),
64707
- /** Discrete state when the hardware is binary-mode; null otherwise. */
64708
- status: _enum([
64709
- "ok",
64710
- "low",
64711
- "full"
64712
- ]).nullable()
64713
- });
64714
64799
  var VacuumControlStatusSchema = object({
64715
64800
  /** Lifecycle state of the vacuum. */
64716
- state: VacuumStateSchema,
64801
+ state: _enum([
64802
+ "idle",
64803
+ "cleaning",
64804
+ "paused",
64805
+ "returning",
64806
+ "docked",
64807
+ "drying",
64808
+ "error"
64809
+ ]),
64717
64810
  /** 0..100 battery percentage. Null when the device has no battery
64718
64811
  * reading. */
64719
64812
  batteryLevel: number().min(0).max(100).nullable(),
@@ -64722,14 +64815,6 @@ var VacuumControlStatusSchema = object({
64722
64815
  fanSpeed: string().nullable(),
64723
64816
  /** Speed tokens the hardware accepts — drives the UI selector. */
64724
64817
  availableFanSpeeds: array(string()),
64725
- /** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
64726
- cleanWater: TankStatusSchema.nullable(),
64727
- /** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
64728
- dirtyWater: TankStatusSchema.nullable(),
64729
- /** Detergent tank. Null when the hardware has no detergent tank. */
64730
- detergent: TankStatusSchema.nullable(),
64731
- /** Dust bin. Null when the hardware has no dust bin. */
64732
- dustBin: TankStatusSchema.nullable(),
64733
64818
  /** 0..100 cleaning-completion percentage of the current task, or null. */
64734
64819
  progressPercent: number().min(0).max(100).nullable(),
64735
64820
  /** Current error code (0 / null = no error). */
@@ -64791,35 +64876,14 @@ var vacuumControlCapability = {
64791
64876
  */
64792
64877
  durability: "session",
64793
64878
  /**
64794
- * History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
64879
+ * History (D850): recorded series. The tanks moved to `consumables` (D915), whose
64880
+ * items are keyed by runtime ids and record no history.
64795
64881
  */
64796
- history: { fields: {
64797
- batteryLevel: {
64798
- kind: "gauge",
64799
- unit: "%",
64800
- deadband: 2
64801
- },
64802
- "cleanWater.level": {
64803
- kind: "gauge",
64804
- unit: "%",
64805
- deadband: 2
64806
- },
64807
- "dirtyWater.level": {
64808
- kind: "gauge",
64809
- unit: "%",
64810
- deadband: 2
64811
- },
64812
- "detergent.level": {
64813
- kind: "gauge",
64814
- unit: "%",
64815
- deadband: 2
64816
- },
64817
- "dustBin.level": {
64818
- kind: "gauge",
64819
- unit: "%",
64820
- deadband: 2
64821
- }
64822
- } }
64882
+ history: { fields: { batteryLevel: {
64883
+ kind: "gauge",
64884
+ unit: "%",
64885
+ deadband: 2
64886
+ } } }
64823
64887
  };
64824
64888
  var ValveStatusSchema = object({
64825
64889
  /** Lifecycle state of the valve. */
@@ -69213,6 +69277,12 @@ Object.freeze({
69213
69277
  addonId: null,
69214
69278
  access: "create"
69215
69279
  },
69280
+ "deviceHistory.deleteOrphanSeries": {
69281
+ capName: "device-history",
69282
+ capScope: "system",
69283
+ addonId: null,
69284
+ access: "delete"
69285
+ },
69216
69286
  "deviceHistory.getDeviceEnabled": {
69217
69287
  capName: "device-history",
69218
69288
  capScope: "system",
@@ -69231,6 +69301,12 @@ Object.freeze({
69231
69301
  addonId: null,
69232
69302
  access: "view"
69233
69303
  },
69304
+ "deviceHistory.listOrphanSeries": {
69305
+ capName: "device-history",
69306
+ capScope: "system",
69307
+ addonId: null,
69308
+ access: "view"
69309
+ },
69234
69310
  "deviceHistory.listSeries": {
69235
69311
  capName: "device-history",
69236
69312
  capScope: "system",
@@ -79236,7 +79312,7 @@ var STATE_SUMMARY_VARS = [
79236
79312
  ([...RULE_TEXT], [...COMBINED_ALARM]),
79237
79313
  ([...RULE_TEXT], [...DEVICE_EVENTS]),
79238
79314
  ([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
79239
- ([...RULE_TEXT], [...CONSUMABLE]),
79315
+ ([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
79240
79316
  ([...RULE_TEXT], [...TANK]),
79241
79317
  [...RULE_TEXT],
79242
79318
  ([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
package/dist/addon.mjs CHANGED
@@ -5430,7 +5430,7 @@ var ZodIssueCode = {
5430
5430
  var ZodFirstPartyTypeKind;
5431
5431
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5432
5432
  //#endregion
5433
- //#region ../types/dist/sleep-DJFUfKvA.mjs
5433
+ //#region ../types/dist/sleep-CUp20JkO.mjs
5434
5434
  /**
5435
5435
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5436
5436
  * window to float samples (D455).
@@ -8322,7 +8322,11 @@ var ContributionSectionSchema = object({
8322
8322
  literal(4)
8323
8323
  ]).optional(),
8324
8324
  tab: string().optional(),
8325
- location: _enum(["settings", "top-tab"]).optional(),
8325
+ location: _enum([
8326
+ "settings",
8327
+ "top-tab",
8328
+ "hero"
8329
+ ]).optional(),
8326
8330
  order: number().optional(),
8327
8331
  fields: array(any())
8328
8332
  });
@@ -13269,7 +13273,11 @@ var ConfigSectionWithValuesSchema = object({
13269
13273
  literal(4)
13270
13274
  ]).optional(),
13271
13275
  tab: string().optional(),
13272
- location: _enum(["settings", "top-tab"]).optional(),
13276
+ location: _enum([
13277
+ "settings",
13278
+ "top-tab",
13279
+ "hero"
13280
+ ]).optional(),
13273
13281
  order: number().optional(),
13274
13282
  fields: array(any())
13275
13283
  });
@@ -17149,6 +17157,52 @@ var TierStatusSchema = object({
17149
17157
  countedAt: number().nullable()
17150
17158
  });
17151
17159
  /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
17160
+ /**
17161
+ * Why a series is orphan. `device-gone`: its device is absent from the
17162
+ * successful device listings (the departure clock). `undeclared`: its `cap:`
17163
+ * key is declared by no capability any more (a field a cap removed).
17164
+ */
17165
+ var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
17166
+ /** Rows held per stored tier. */
17167
+ var TierRowsSchema = object({
17168
+ raw: number().int(),
17169
+ "5m": number().int(),
17170
+ "1h": number().int(),
17171
+ "1d": number().int()
17172
+ });
17173
+ var OrphanSeriesSchema = object({
17174
+ seriesId: number().int(),
17175
+ deviceId: number().int(),
17176
+ key: string(),
17177
+ scope: string(),
17178
+ /** The metric's display name; `null` when its metric row is gone too. */
17179
+ displayName: string().nullable(),
17180
+ reason: DeviceHistoryOrphanReasonSchema,
17181
+ /** `device-gone`: since when the device has been absent; `null` otherwise. */
17182
+ missingSince: number().nullable(),
17183
+ firstTs: number(),
17184
+ lastTs: number(),
17185
+ rows: TierRowsSchema
17186
+ });
17187
+ var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
17188
+ "not-found",
17189
+ "not-orphan",
17190
+ "failed"
17191
+ ]);
17192
+ var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
17193
+ seriesId: number().int(),
17194
+ ok: literal(true),
17195
+ deleted: TierRowsSchema
17196
+ }), object({
17197
+ seriesId: number().int(),
17198
+ ok: literal(false),
17199
+ reason: DeviceHistoryOrphanDeleteRefusalSchema
17200
+ })]);
17201
+ var OrphanListSchema = object({
17202
+ series: array(OrphanSeriesSchema).readonly(),
17203
+ /** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
17204
+ truncated: boolean()
17205
+ });
17152
17206
  var DeviceHistoryStatusSchema = object({
17153
17207
  startedAt: number(),
17154
17208
  /** The store is declared, series loaded and the first reconcile has answered. */
@@ -17246,7 +17300,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
17246
17300
  }), object({ enabled: boolean() }), {
17247
17301
  kind: "mutation",
17248
17302
  auth: "admin"
17249
- }), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
17303
+ }), 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() }), {
17304
+ kind: "mutation",
17305
+ auth: "admin"
17306
+ });
17250
17307
  var DeviceCaStatusSchema = discriminatedUnion("state", [
17251
17308
  object({ state: literal("absent") }),
17252
17309
  object({
@@ -55219,17 +55276,69 @@ var connectivityCapability = {
55219
55276
  volatileStateFields: ["lastChangedAt"]
55220
55277
  };
55221
55278
  /**
55222
- * Generic device-consumables capability — surfaces a device's
55223
- * maintenance items (vacuum filters/brushes, replaceable cartridges,
55224
- * descaling cycles, …) with their remaining life and an optional
55225
- * "Replaced" reset action. Device-agnostic: any provider that knows its
55226
- * device tracks consumables can register it; the cap declares no
55227
- * vocabulary of its own — the provider names each item verbatim.
55279
+ * Generic device-consumables capability — the ONE place a device reports what
55280
+ * it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
55281
+ * descaling cycles), supplies it draws from (a vacuum's clean-water tank and
55282
+ * detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
55283
+ * water tank, a dust bin). Each item carries its remaining life or fill and an
55284
+ * optional "Replaced" reset action. Device-agnostic: any provider that knows
55285
+ * its device tracks consumables registers it; the provider names each item
55286
+ * verbatim and says which `kind` it is.
55287
+ *
55288
+ * The admin UI renders it as ONE collapsible section directly under the
55289
+ * device page's hero card (`placement: 'hero'`), for every device bound to
55290
+ * this cap — never drawn by a device type's hero card itself (D915).
55228
55291
  *
55229
55292
  * Like `childLayout`, the cap is INERT until a provider sets items: no
55230
55293
  * provider populates it by guessing (no HA inference). The UI renders a
55231
55294
  * "No consumables reported" placeholder when `items` is empty.
55232
55295
  */
55296
+ /**
55297
+ * What an item IS, which decides which direction is bad:
55298
+ * - `wear` — a part that wears out (a brush, a filter); low life is bad.
55299
+ * - `supply` — something the device draws from (clean water, detergent,
55300
+ * salt, rinse aid); low or empty is bad.
55301
+ * - `waste` — something the device fills (dirty water, a dust bin); full is
55302
+ * bad.
55303
+ * Absent = `wear`.
55304
+ */
55305
+ var ConsumableKindSchema = _enum([
55306
+ "wear",
55307
+ "supply",
55308
+ "waste"
55309
+ ]);
55310
+ /**
55311
+ * What an item LOOKS like, which decides how a client draws it — independent
55312
+ * of `kind`, which decides which direction is bad:
55313
+ * - `part` — a part that wears (a brush, a filter, a mop pad): a wear bar,
55314
+ * remaining time and a reset.
55315
+ * - `tank` — a container of liquid (clean water, dirty water): a fill gauge.
55316
+ * - `product` — something bought and refilled (detergent, salt, rinse aid):
55317
+ * a stepped level and "refill".
55318
+ * - `bin` — a container that collects waste (a dust bin): a fill gauge
55319
+ * that warns when full.
55320
+ * Absent = derived from the kind ({@link consumableFormOf}).
55321
+ */
55322
+ var ConsumableFormSchema = _enum([
55323
+ "part",
55324
+ "tank",
55325
+ "product",
55326
+ "bin"
55327
+ ]);
55328
+ /** The provider's own discrete verdict on an item. */
55329
+ var ConsumableStatusSchema = _enum([
55330
+ "ok",
55331
+ "low",
55332
+ "empty",
55333
+ "full",
55334
+ "replace"
55335
+ ]);
55336
+ _enum([
55337
+ "ok",
55338
+ "low",
55339
+ "empty",
55340
+ "full"
55341
+ ]);
55233
55342
  /** Units a remaining-life counter is reported in. Closed: the panel renders
55234
55343
  * each. */
55235
55344
  var ConsumableRemainingUnitSchema = _enum([
@@ -55244,18 +55353,23 @@ var ConsumableRemainingSchema = object({
55244
55353
  unit: ConsumableRemainingUnitSchema
55245
55354
  });
55246
55355
  /** A single consumable item. Either a continuous `level` (remaining
55247
- * life %) or a discrete `status` may be known — both may be null when a
55248
- * provider only knows the item exists. `level` and `status` are not
55249
- * mutually exclusive; a provider may report both. */
55356
+ * life %, or fill % for a `supply` / `waste` item) or a discrete `status`
55357
+ * may be known — both may be null when a provider only knows the item
55358
+ * exists. `level` and `status` are not mutually exclusive; a provider may
55359
+ * report both. */
55250
55360
  var ConsumableItemSchema = object({
55251
55361
  /** Stable id, e.g. 'main-brush'. */
55252
55362
  key: string().min(1),
55253
55363
  /** Display name. */
55254
55364
  label: string().min(1),
55255
- /** Remaining life % when known (0..100). */
55365
+ /** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
55256
55366
  level: number().min(0).max(100).nullable(),
55257
- /** Discrete state when known (binary mode). */
55258
- status: _enum(["ok", "replace"]).nullable(),
55367
+ /** The provider's discrete verdict when known (binary mode). */
55368
+ status: ConsumableStatusSchema.nullable(),
55369
+ /** What the item is — decides whether low or full is bad. Absent = `wear`. */
55370
+ kind: ConsumableKindSchema.optional(),
55371
+ /** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
55372
+ form: ConsumableFormSchema.optional(),
55259
55373
  /** Ms epoch of the last replace, when known. */
55260
55374
  lastResetAt: number().nullable(),
55261
55375
  /** Whether `reset()` is meaningful for this item. */
@@ -55278,7 +55392,7 @@ var consumablesCapability = {
55278
55392
  kind: "widget",
55279
55393
  widgetId: "host/consumables-panel",
55280
55394
  tab: "consumables",
55281
- topTab: true,
55395
+ placement: "hero",
55282
55396
  label: "Consumables",
55283
55397
  order: 5
55284
55398
  } },
@@ -55339,9 +55453,37 @@ reset: method(object({
55339
55453
  */
55340
55454
  durability: "restored",
55341
55455
  /**
55342
- * History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
55456
+ * History (D850, D917): one series per (item field, item `key`) — the item key
55457
+ * is the series scope, the item `label` names it. A vacuum tank's fill, a
55458
+ * brush's remaining life and a dishwasher's salt are each recorded the moment
55459
+ * their provider reports them; an item that appears later gets its series.
55343
55460
  */
55344
- history: "none",
55461
+ history: {
55462
+ fields: {},
55463
+ items: {
55464
+ path: "items",
55465
+ key: "key",
55466
+ label: "label",
55467
+ fields: {
55468
+ level: {
55469
+ kind: "gauge",
55470
+ unit: "%",
55471
+ deadband: 2,
55472
+ displayName: "Level"
55473
+ },
55474
+ status: {
55475
+ kind: "enum",
55476
+ displayName: "Status"
55477
+ },
55478
+ "remaining.value": {
55479
+ kind: "gauge",
55480
+ unitFrom: "remaining.unit",
55481
+ deadband: 1,
55482
+ displayName: "Remaining"
55483
+ }
55484
+ }
55485
+ }
55486
+ },
55345
55487
  /** Clocks, not content: a re-read that changed no item costs no commit. */
55346
55488
  volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
55347
55489
  };
@@ -55756,8 +55898,9 @@ onStatusChanged: { data: object({
55756
55898
  volatileStateFields: ["lastChangedAt"]
55757
55899
  };
55758
55900
  /**
55759
- * Smart-dishwasher cap — program lifecycle, door / remote-start gates,
55760
- * consumable levels (salt, rinse aid) and common program options.
55901
+ * Smart-dishwasher cap — program lifecycle, door / remote-start gates and
55902
+ * common program options. Salt and rinse aid are NOT here: they are items of
55903
+ * the device's `consumables` cap, like every other device's (D915).
55761
55904
  *
55762
55905
  * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
55763
55906
  * by any integration that exposes the same program / option surface.
@@ -55805,11 +55948,6 @@ var DishwasherAvailabilitySchema = _enum([
55805
55948
  "offline",
55806
55949
  "description-missing"
55807
55950
  ]);
55808
- var DishwasherConsumableLevelSchema = _enum([
55809
- "ok",
55810
- "low",
55811
- "empty"
55812
- ]);
55813
55951
  var DishwasherStatusSchema = object({
55814
55952
  availability: DishwasherAvailabilitySchema,
55815
55953
  /** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -55842,8 +55980,6 @@ var DishwasherStatusSchema = object({
55842
55980
  powerOn: boolean().nullable(),
55843
55981
  /** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
55844
55982
  powerState: string().nullable(),
55845
- saltLevel: DishwasherConsumableLevelSchema.nullable(),
55846
- rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
55847
55983
  /**
55848
55984
  * True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
55849
55985
  * combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -64659,60 +64795,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
64659
64795
  auth: "admin",
64660
64796
  access: "delete"
64661
64797
  });
64662
- /**
64663
- * Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
64664
- * cleaning lifecycle plus a return-to-base / locate surface and an
64665
- * optional fan-speed selector.
64666
- *
64667
- * State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
64668
- * `paused` / `returning` / `docked` / `error`. `batteryLevel`
64669
- * (0..100) is nullable — some vacuums don't report a battery
64670
- * percentage. `fanSpeed` is the current speed token (provider-verbatim,
64671
- * e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
64672
- * tokens the hardware accepts so the UI renders only supported choices.
64673
- *
64674
- * The `setFanSpeed` method takes the bare `speed` token — the provider
64675
- * validates it against the vacuum's own list. `locate` triggers the
64676
- * find-me chirp; `returnToBase` sends it home.
64677
- *
64678
- * Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
64679
- * `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
64680
- * 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
64681
- * SHOULD populate whichever tanks the hardware has — leave a field `null`
64682
- * only when the device has no such tank at all, and use a `TankStatus`
64683
- * with both inner fields `null` when the tank exists but its level is
64684
- * currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
64685
- * so the HA provider leaves all four `null`.
64686
- */
64687
- var VacuumStateSchema = _enum([
64688
- "idle",
64689
- "cleaning",
64690
- "paused",
64691
- "returning",
64692
- "docked",
64693
- "drying",
64694
- "error"
64695
- ]);
64696
- /**
64697
- * One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
64698
- * detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
64699
- * a discrete `status` (binary-style hardware), or both. Both `null` means the
64700
- * level is currently unknown; the OWNING field being `null` means the
64701
- * hardware has no such tank at all.
64702
- */
64703
- var TankStatusSchema = object({
64704
- /** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
64705
- level: number().min(0).max(100).nullable(),
64706
- /** Discrete state when the hardware is binary-mode; null otherwise. */
64707
- status: _enum([
64708
- "ok",
64709
- "low",
64710
- "full"
64711
- ]).nullable()
64712
- });
64713
64798
  var VacuumControlStatusSchema = object({
64714
64799
  /** Lifecycle state of the vacuum. */
64715
- state: VacuumStateSchema,
64800
+ state: _enum([
64801
+ "idle",
64802
+ "cleaning",
64803
+ "paused",
64804
+ "returning",
64805
+ "docked",
64806
+ "drying",
64807
+ "error"
64808
+ ]),
64716
64809
  /** 0..100 battery percentage. Null when the device has no battery
64717
64810
  * reading. */
64718
64811
  batteryLevel: number().min(0).max(100).nullable(),
@@ -64721,14 +64814,6 @@ var VacuumControlStatusSchema = object({
64721
64814
  fanSpeed: string().nullable(),
64722
64815
  /** Speed tokens the hardware accepts — drives the UI selector. */
64723
64816
  availableFanSpeeds: array(string()),
64724
- /** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
64725
- cleanWater: TankStatusSchema.nullable(),
64726
- /** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
64727
- dirtyWater: TankStatusSchema.nullable(),
64728
- /** Detergent tank. Null when the hardware has no detergent tank. */
64729
- detergent: TankStatusSchema.nullable(),
64730
- /** Dust bin. Null when the hardware has no dust bin. */
64731
- dustBin: TankStatusSchema.nullable(),
64732
64817
  /** 0..100 cleaning-completion percentage of the current task, or null. */
64733
64818
  progressPercent: number().min(0).max(100).nullable(),
64734
64819
  /** Current error code (0 / null = no error). */
@@ -64790,35 +64875,14 @@ var vacuumControlCapability = {
64790
64875
  */
64791
64876
  durability: "session",
64792
64877
  /**
64793
- * History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
64878
+ * History (D850): recorded series. The tanks moved to `consumables` (D915), whose
64879
+ * items are keyed by runtime ids and record no history.
64794
64880
  */
64795
- history: { fields: {
64796
- batteryLevel: {
64797
- kind: "gauge",
64798
- unit: "%",
64799
- deadband: 2
64800
- },
64801
- "cleanWater.level": {
64802
- kind: "gauge",
64803
- unit: "%",
64804
- deadband: 2
64805
- },
64806
- "dirtyWater.level": {
64807
- kind: "gauge",
64808
- unit: "%",
64809
- deadband: 2
64810
- },
64811
- "detergent.level": {
64812
- kind: "gauge",
64813
- unit: "%",
64814
- deadband: 2
64815
- },
64816
- "dustBin.level": {
64817
- kind: "gauge",
64818
- unit: "%",
64819
- deadband: 2
64820
- }
64821
- } }
64881
+ history: { fields: { batteryLevel: {
64882
+ kind: "gauge",
64883
+ unit: "%",
64884
+ deadband: 2
64885
+ } } }
64822
64886
  };
64823
64887
  var ValveStatusSchema = object({
64824
64888
  /** Lifecycle state of the valve. */
@@ -69212,6 +69276,12 @@ Object.freeze({
69212
69276
  addonId: null,
69213
69277
  access: "create"
69214
69278
  },
69279
+ "deviceHistory.deleteOrphanSeries": {
69280
+ capName: "device-history",
69281
+ capScope: "system",
69282
+ addonId: null,
69283
+ access: "delete"
69284
+ },
69215
69285
  "deviceHistory.getDeviceEnabled": {
69216
69286
  capName: "device-history",
69217
69287
  capScope: "system",
@@ -69230,6 +69300,12 @@ Object.freeze({
69230
69300
  addonId: null,
69231
69301
  access: "view"
69232
69302
  },
69303
+ "deviceHistory.listOrphanSeries": {
69304
+ capName: "device-history",
69305
+ capScope: "system",
69306
+ addonId: null,
69307
+ access: "view"
69308
+ },
69233
69309
  "deviceHistory.listSeries": {
69234
69310
  capName: "device-history",
69235
69311
  capScope: "system",
@@ -79235,7 +79311,7 @@ var STATE_SUMMARY_VARS = [
79235
79311
  ([...RULE_TEXT], [...COMBINED_ALARM]),
79236
79312
  ([...RULE_TEXT], [...DEVICE_EVENTS]),
79237
79313
  ([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
79238
- ([...RULE_TEXT], [...CONSUMABLE]),
79314
+ ([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
79239
79315
  ([...RULE_TEXT], [...TANK]),
79240
79316
  [...RULE_TEXT],
79241
79317
  ([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-unifi",
3
- "version": "0.2.143",
3
+ "version": "0.2.144",
4
4
  "description": "UniFi Network controller device-provider addon for CamStack — local-controller infra switches/APs (as containers) + network-client presence. NO cameras/Protect.",
5
5
  "keywords": [
6
6
  "camstack",