@camstack/addon-provider-homeassistant 1.2.618 → 1.2.619

package/dist/{dist-BRSVYxR3.mjs → dist-fqJMr4fu.mjs}

@@ -5563,7 +5563,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-DJFUfKvA.mjs
+//#region ../types/dist/sleep-CUp20JkO.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -8702,7 +8702,11 @@ var ContributionSectionSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any())
 });
@@ -13798,7 +13802,11 @@ var ConfigSectionWithValuesSchema = object({
 		literal(4)
 	]).optional(),
 	tab: string().optional(),
-	location: _enum(["settings", "top-tab"]).optional(),
+	location: _enum([
+		"settings",
+		"top-tab",
+		"hero"
+	]).optional(),
 	order: number().optional(),
 	fields: array(any())
 });
@@ -17727,6 +17735,52 @@ var TierStatusSchema = object({
 	countedAt: number().nullable()
 });
 /** Operator/diagnostic view: rows per tier, last runs, refusals and drops since boot. */
+/**
+* Why a series is orphan. `device-gone`: its device is absent from the
+* successful device listings (the departure clock). `undeclared`: its `cap:`
+* key is declared by no capability any more (a field a cap removed).
+*/
+var DeviceHistoryOrphanReasonSchema = _enum(["device-gone", "undeclared"]);
+/** Rows held per stored tier. */
+var TierRowsSchema = object({
+	raw: number().int(),
+	"5m": number().int(),
+	"1h": number().int(),
+	"1d": number().int()
+});
+var OrphanSeriesSchema = object({
+	seriesId: number().int(),
+	deviceId: number().int(),
+	key: string(),
+	scope: string(),
+	/** The metric's display name; `null` when its metric row is gone too. */
+	displayName: string().nullable(),
+	reason: DeviceHistoryOrphanReasonSchema,
+	/** `device-gone`: since when the device has been absent; `null` otherwise. */
+	missingSince: number().nullable(),
+	firstTs: number(),
+	lastTs: number(),
+	rows: TierRowsSchema
+});
+var DeviceHistoryOrphanDeleteRefusalSchema = _enum([
+	"not-found",
+	"not-orphan",
+	"failed"
+]);
+var OrphanDeleteEntrySchema = discriminatedUnion("ok", [object({
+	seriesId: number().int(),
+	ok: literal(true),
+	deleted: TierRowsSchema
+}), object({
+	seriesId: number().int(),
+	ok: literal(false),
+	reason: DeviceHistoryOrphanDeleteRefusalSchema
+})]);
+var OrphanListSchema = object({
+	series: array(OrphanSeriesSchema).readonly(),
+	/** More orphans exist than {@link DEVICE_HISTORY_ORPHAN_LIST_MAX}. */
+	truncated: boolean()
+});
 var DeviceHistoryStatusSchema = object({
 	startedAt: number(),
 	/** The store is declared, series loaded and the first reconcile has answered. */
@@ -17824,7 +17878,10 @@ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly())
 }), object({ enabled: boolean() }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({}), DeviceHistoryStatusSchema, { auth: "admin" });
+}), 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() }), {
+	kind: "mutation",
+	auth: "admin"
+});
 var DeviceCaStatusSchema = discriminatedUnion("state", [
 	object({ state: literal("absent") }),
 	object({
@@ -56038,17 +56095,83 @@ var connectivityCapability = {
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Generic device-consumables capability — surfaces a device's
-* maintenance items (vacuum filters/brushes, replaceable cartridges,
-* descaling cycles, …) with their remaining life and an optional
-* "Replaced" reset action. Device-agnostic: any provider that knows its
-* device tracks consumables can register it; the cap declares no
-* vocabulary of its own — the provider names each item verbatim.
+* Generic device-consumables capability — the ONE place a device reports what
+* it uses up or fills: wear parts (vacuum filters/brushes, cartridges,
+* descaling cycles), supplies it draws from (a vacuum's clean-water tank and
+* detergent, a dishwasher's salt and rinse aid) and waste it collects (a dirty
+* water tank, a dust bin). Each item carries its remaining life or fill and an
+* optional "Replaced" reset action. Device-agnostic: any provider that knows
+* its device tracks consumables registers it; the provider names each item
+* verbatim and says which `kind` it is.
+*
+* The admin UI renders it as ONE collapsible section directly under the
+* device page's hero card (`placement: 'hero'`), for every device bound to
+* this cap — never drawn by a device type's hero card itself (D915).
 *
 * Like `childLayout`, the cap is INERT until a provider sets items: no
 * provider populates it by guessing (no HA inference). The UI renders a
 * "No consumables reported" placeholder when `items` is empty.
 */
+/**
+* What an item IS, which decides which direction is bad:
+*  - `wear`   — a part that wears out (a brush, a filter); low life is bad.
+*  - `supply` — something the device draws from (clean water, detergent,
+*    salt, rinse aid); low or empty is bad.
+*  - `waste`  — something the device fills (dirty water, a dust bin); full is
+*    bad.
+* Absent = `wear`.
+*/
+var ConsumableKindSchema = _enum([
+	"wear",
+	"supply",
+	"waste"
+]);
+/**
+* What an item LOOKS like, which decides how a client draws it — independent
+* of `kind`, which decides which direction is bad:
+*  - `part`    — a part that wears (a brush, a filter, a mop pad): a wear bar,
+*    remaining time and a reset.
+*  - `tank`    — a container of liquid (clean water, dirty water): a fill gauge.
+*  - `product` — something bought and refilled (detergent, salt, rinse aid):
+*    a stepped level and "refill".
+*  - `bin`     — a container that collects waste (a dust bin): a fill gauge
+*    that warns when full.
+* Absent = derived from the kind ({@link consumableFormOf}).
+*/
+var ConsumableFormSchema = _enum([
+	"part",
+	"tank",
+	"product",
+	"bin"
+]);
+/** The provider's own discrete verdict on an item. */
+var ConsumableStatusSchema = _enum([
+	"ok",
+	"low",
+	"empty",
+	"full",
+	"replace"
+]);
+_enum([
+	"ok",
+	"low",
+	"empty",
+	"full"
+]);
+/** The kind of an item, with the documented default for an absent one. */
+function consumableKindOf(item) {
+	return item.kind ?? "wear";
+}
+/** The kind's default form: wear → part, waste → bin, supply → product. */
+var FORM_OF_KIND = {
+	wear: "part",
+	waste: "bin",
+	supply: "product"
+};
+/** The form of an item: its own when the provider names one, else its kind's default. */
+function consumableFormOf(item) {
+	return item.form ?? FORM_OF_KIND[consumableKindOf(item)];
+}
 /** Units a remaining-life counter is reported in. Closed: the panel renders
 *  each. */
 var ConsumableRemainingUnitSchema = _enum([
@@ -56063,18 +56186,23 @@ var ConsumableRemainingSchema = object({
 	unit: ConsumableRemainingUnitSchema
 });
 /** A single consumable item. Either a continuous `level` (remaining
-*  life %) or a discrete `status` may be known — both may be null when a
-*  provider only knows the item exists. `level` and `status` are not
-*  mutually exclusive; a provider may report both. */
+*  life %, or fill % for a `supply` / `waste` item) or a discrete `status`
+*  may be known — both may be null when a provider only knows the item
+*  exists. `level` and `status` are not mutually exclusive; a provider may
+*  report both. */
 var ConsumableItemSchema = object({
 	/** Stable id, e.g. 'main-brush'. */
 	key: string().min(1),
 	/** Display name. */
 	label: string().min(1),
-	/** Remaining life % when known (0..100). */
+	/** Remaining life % (`wear`) or fill % (`supply`, `waste`) when known (0..100). */
 	level: number().min(0).max(100).nullable(),
-	/** Discrete state when known (binary mode). */
-	status: _enum(["ok", "replace"]).nullable(),
+	/** The provider's discrete verdict when known (binary mode). */
+	status: ConsumableStatusSchema.nullable(),
+	/** What the item is — decides whether low or full is bad. Absent = `wear`. */
+	kind: ConsumableKindSchema.optional(),
+	/** How the item is drawn (part, tank, product, bin). Absent = derived from `kind`. */
+	form: ConsumableFormSchema.optional(),
 	/** Ms epoch of the last replace, when known. */
 	lastResetAt: number().nullable(),
 	/** Whether `reset()` is meaningful for this item. */
@@ -56097,7 +56225,7 @@ var consumablesCapability = {
 		kind: "widget",
 		widgetId: "host/consumables-panel",
 		tab: "consumables",
-		topTab: true,
+		placement: "hero",
 		label: "Consumables",
 		order: 5
 	} },
@@ -56158,9 +56286,37 @@ reset: method(object({
 	*/
 	durability: "restored",
 	/**
-	* History (D850): none — `items` is an array keyed by runtime ids; a history path never enters it.
+	* History (D850, D917): one series per (item field, item `key`) — the item key
+	* is the series scope, the item `label` names it. A vacuum tank's fill, a
+	* brush's remaining life and a dishwasher's salt are each recorded the moment
+	* their provider reports them; an item that appears later gets its series.
 	*/
-	history: "none",
+	history: {
+		fields: {},
+		items: {
+			path: "items",
+			key: "key",
+			label: "label",
+			fields: {
+				level: {
+					kind: "gauge",
+					unit: "%",
+					deadband: 2,
+					displayName: "Level"
+				},
+				status: {
+					kind: "enum",
+					displayName: "Status"
+				},
+				"remaining.value": {
+					kind: "gauge",
+					unitFrom: "remaining.unit",
+					deadband: 1,
+					displayName: "Remaining"
+				}
+			}
+		}
+	},
 	/** Clocks, not content: a re-read that changed no item costs no commit. */
 	volatileStateFields: ["lastChangedAt", "lastFetchedAt"]
 };
@@ -56575,8 +56731,9 @@ onStatusChanged: { data: object({
 	volatileStateFields: ["lastChangedAt"]
 };
 /**
-* Smart-dishwasher cap — program lifecycle, door / remote-start gates,
-* consumable levels (salt, rinse aid) and common program options.
+* Smart-dishwasher cap — program lifecycle, door / remote-start gates and
+* common program options. Salt and rinse aid are NOT here: they are items of
+* the device's `consumables` cap, like every other device's (D915).
 *
 * Sources: native Bosch Home Connect (`dishwasher` device type). Reusable
 * by any integration that exposes the same program / option surface.
@@ -56624,11 +56781,6 @@ var DishwasherAvailabilitySchema = _enum([
 	"offline",
 	"description-missing"
 ]);
-var DishwasherConsumableLevelSchema = _enum([
-	"ok",
-	"low",
-	"empty"
-]);
 var DishwasherStatusSchema = object({
 	availability: DishwasherAvailabilitySchema,
 	/** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
@@ -56661,8 +56813,6 @@ var DishwasherStatusSchema = object({
 	powerOn: boolean().nullable(),
 	/** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
 	powerState: string().nullable(),
-	saltLevel: DishwasherConsumableLevelSchema.nullable(),
-	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
 	/**
 	* True while the appliance asks for its filter to be cleaned (smart-filter, filter-system or
 	* combined care-and-filter reminder raised); false when every such reminder reads clear; null
@@ -65478,60 +65628,17 @@ method(_void(), array(UserSummarySchema), { auth: "admin" }), method(CreateUserI
 	auth: "admin",
 	access: "delete"
 });
-/**
-* Robot-vacuum cap. Models HA `vacuum.*` entities — anything with a
-* cleaning lifecycle plus a return-to-base / locate surface and an
-* optional fan-speed selector.
-*
-* State follows HA's canonical vacuum lifecycle: `idle` / `cleaning` /
-* `paused` / `returning` / `docked` / `error`. `batteryLevel`
-* (0..100) is nullable — some vacuums don't report a battery
-* percentage. `fanSpeed` is the current speed token (provider-verbatim,
-* e.g. `'standard'` / `'turbo'`) and `availableFanSpeeds` lists the
-* tokens the hardware accepts so the UI renders only supported choices.
-*
-* The `setFanSpeed` method takes the bare `speed` token — the provider
-* validates it against the vacuum's own list. `locate` triggers the
-* find-me chirp; `returnToBase` sends it home.
-*
-* Consumable / waste tanks: `cleanWater` / `dirtyWater` / `detergent` /
-* `dustBin` each carry a nullable `{ level (0..100 %), status ('ok' |
-* 'low' | 'full') }` reading. Native providers (e.g. Dreame, Roborock)
-* SHOULD populate whichever tanks the hardware has — leave a field `null`
-* only when the device has no such tank at all, and use a `TankStatus`
-* with both inner fields `null` when the tank exists but its level is
-* currently unknown. HA `vacuum.*` entities expose no per-tank telemetry,
-* so the HA provider leaves all four `null`.
-*/
-var VacuumStateSchema = _enum([
-	"idle",
-	"cleaning",
-	"paused",
-	"returning",
-	"docked",
-	"drying",
-	"error"
-]);
-/**
-* One consumable / waste tank on a robot vacuum (clean-water, dirty-water,
-* detergent or dust-bin). A tank can report a numeric fill `level` (0..100),
-* a discrete `status` (binary-style hardware), or both. Both `null` means the
-* level is currently unknown; the OWNING field being `null` means the
-* hardware has no such tank at all.
-*/
-var TankStatusSchema = object({
-	/** Numeric fill 0..100 when the hardware reports a percentage; null otherwise. */
-	level: number().min(0).max(100).nullable(),
-	/** Discrete state when the hardware is binary-mode; null otherwise. */
-	status: _enum([
-		"ok",
-		"low",
-		"full"
-	]).nullable()
-});
 var VacuumControlStatusSchema = object({
 	/** Lifecycle state of the vacuum. */
-	state: VacuumStateSchema,
+	state: _enum([
+		"idle",
+		"cleaning",
+		"paused",
+		"returning",
+		"docked",
+		"drying",
+		"error"
+	]),
 	/** 0..100 battery percentage. Null when the device has no battery
 	*  reading. */
 	batteryLevel: number().min(0).max(100).nullable(),
@@ -65540,14 +65647,6 @@ var VacuumControlStatusSchema = object({
 	fanSpeed: string().nullable(),
 	/** Speed tokens the hardware accepts — drives the UI selector. */
 	availableFanSpeeds: array(string()),
-	/** Clean-water (mop) tank. Null when the hardware has no clean-water tank. */
-	cleanWater: TankStatusSchema.nullable(),
-	/** Dirty-water (recovery) tank. Null when the hardware has no dirty-water tank. */
-	dirtyWater: TankStatusSchema.nullable(),
-	/** Detergent tank. Null when the hardware has no detergent tank. */
-	detergent: TankStatusSchema.nullable(),
-	/** Dust bin. Null when the hardware has no dust bin. */
-	dustBin: TankStatusSchema.nullable(),
 	/** 0..100 cleaning-completion percentage of the current task, or null. */
 	progressPercent: number().min(0).max(100).nullable(),
 	/** Current error code (0 / null = no error). */
@@ -65609,35 +65708,14 @@ var vacuumControlCapability = {
 	*/
 	durability: "session",
 	/**
-	* History (D850): recorded series. Tank levels are fixed-object paths (`cleanWater.level`, ...).
+	* History (D850): recorded series. The tanks moved to `consumables` (D915), whose
+	* items are keyed by runtime ids and record no history.
 	*/
-	history: { fields: {
-		batteryLevel: {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"cleanWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dirtyWater.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"detergent.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		},
-		"dustBin.level": {
-			kind: "gauge",
-			unit: "%",
-			deadband: 2
-		}
-	} }
+	history: { fields: { batteryLevel: {
+		kind: "gauge",
+		unit: "%",
+		deadband: 2
+	} } }
 };
 var ValveStatusSchema = object({
 	/** Lifecycle state of the valve. */
@@ -70031,6 +70109,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"deviceHistory.deleteOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "delete"
+	},
 	"deviceHistory.getDeviceEnabled": {
 		capName: "device-history",
 		capScope: "system",
@@ -70049,6 +70133,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"deviceHistory.listOrphanSeries": {
+		capName: "device-history",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"deviceHistory.listSeries": {
 		capName: "device-history",
 		capScope: "system",
@@ -80261,7 +80351,7 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...COMBINED_ALARM]),
 	([...RULE_TEXT], [...DEVICE_EVENTS]),
 	([...RULE_TEXT], [...BATTERY, ...CONSUMABLE]),
-	([...RULE_TEXT], [...CONSUMABLE]),
+	([...RULE_TEXT], [...CONSUMABLE, ...TANK]),
 	([...RULE_TEXT], [...TANK]),
 	[...RULE_TEXT],
 	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
@@ -81011,4 +81101,4 @@ function bestLocationMatch(externalName, existing, threshold = .8) {
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
 //#endregion
-export { oauthIntegrationCapability as $, connectivityCapability as A, discriminatedUnion as At, floodCapability as B, buildAddonRouteProvider as C, defineEntryKind as Ct, carbonMonoxideCapability as D, _enum as Dt, calendarSourceCapability as E, nodePin as Et, deviceAdoptionCapability as F, string as Ft, lawnMowerControlCapability as G, humidifierCapability as H, deviceExportCapability as I, union as It, motionCapability as J, lockControlCapability as K, enumSensorCapability as L, unknown as Lt, controlCapability as M, number as Mt, coverCapability as N, object as Nt, climateControlCapability as O, array as Ot, deviceAdminLinkCapability as P, record as Pt, numericSensorCapability as Q, eventEmitterCapability as R, url as Rt, brokerCapability as S, createEvent as St, buttonCapability as T, entryBody as Tt, humiditySensorCapability as U, gasCapability as V, imageCapability as W, notificationOutputCapability as X, normalizeUnit as Y, notifierCapability as Z, automationControlCapability as _, DeviceRole as _t, COCO_TO_MACRO as a, scriptRunnerCapability as at, binaryCapability as b, BaseAddon as bt, FanDirectionSchema as c, tamperCapability as ct, TargetSchema as d, vacuumControlCapability as dt, parseAdminBase as et, accessoriesCapability as f, valveCapability as ft, ambientLightSensorCapability as g, DeviceFeature as gt, alarmPanelCapability as h, weatherCapability as ht, CAMERA_SWITCH_ORDER as i, pressureSensorCapability as it, contactCapability as j, literal as jt, colorCapability as k, boolean as kt, HvacModeSchema as l, temperatureSensorCapability as lt, airQualitySensorCapability as m, waterHeaterCapability as mt, BaseDevice as n, prepareNotification as nt, CameraSwitchIdSchema as o, smokeCapability as ot, addonRoutesCapability as p, vibrationCapability as pt, mediaPlayerCapability as q, BaseDeviceProvider as r, presenceCapability as rt, EnumSensorDateTimeFormatSchema as s, switchCapability as st, AlarmArmModeSchema as t, powerMeterCapability as tt, MediaPlayerRepeatSchema as u, updateCapability as ut, batteryCapability as v, DeviceType as vt, buildDeviceAdminUrl as w, defineRecordKinds as wt, brightnessCapability as x, RecordSecretUnavailableError as xt, bestLocationMatch as y, errMsg as yt, fanControlCapability as z, EventCategory as zt };
+export { motionCapability as $, carbonMonoxideCapability as A, entryBody as At, deviceAdoptionCapability as B, string as Bt, binaryCapability as C, DeviceType as Ct, buildDeviceAdminUrl as D, createEvent as Dt, buildAddonRouteProvider as E, RecordSecretUnavailableError as Et, consumableKindOf as F, discriminatedUnion as Ft, floodCapability as G, enumSensorCapability as H, unknown as Ht, contactCapability as I, literal as It, humiditySensorCapability as J, gasCapability as K, controlCapability as L, number as Lt, colorCapability as M, _enum as Mt, connectivityCapability as N, array as Nt, buttonCapability as O, defineEntryKind as Ot, consumableFormOf as P, boolean as Pt, mediaPlayerCapability as Q, coverCapability as R, object as Rt, bestLocationMatch as S, DeviceRole as St, brokerCapability as T, BaseAddon as Tt, eventEmitterCapability as U, url as Ut, deviceExportCapability as V, union as Vt, fanControlCapability as W, EventCategory as Wt, lawnMowerControlCapability as X, imageCapability as Y, lockControlCapability as Z, airQualitySensorCapability as _, valveCapability as _t, COCO_TO_MACRO as a, parseAdminBase as at, automationControlCapability as b, weatherCapability as bt, ConsumableItemSchema as c, presenceCapability as ct, FanDirectionSchema as d, smokeCapability as dt, normalizeUnit as et, HvacModeSchema as f, switchCapability as ft, addonRoutesCapability as g, vacuumControlCapability as gt, accessoriesCapability as h, updateCapability as ht, CAMERA_SWITCH_ORDER as i, oauthIntegrationCapability as it, climateControlCapability as j, nodePin as jt, calendarSourceCapability as k, defineRecordKinds as kt, ConsumableStatusSchema as l, pressureSensorCapability as lt, TargetSchema as m, temperatureSensorCapability as mt, BaseDevice as n, notifierCapability as nt, CameraSwitchIdSchema as o, powerMeterCapability as ot, MediaPlayerRepeatSchema as p, tamperCapability as pt, humidifierCapability as q, BaseDeviceProvider as r, numericSensorCapability as rt, ConsumableFormSchema as s, prepareNotification as st, AlarmArmModeSchema as t, notificationOutputCapability as tt, EnumSensorDateTimeFormatSchema as u, scriptRunnerCapability as ut, alarmPanelCapability as v, vibrationCapability as vt, brightnessCapability as w, errMsg as wt, batteryCapability as x, DeviceFeature as xt, ambientLightSensorCapability as y, waterHeaterCapability as yt, deviceAdminLinkCapability as z, record as zt };