@camstack/addon-provider-homeassistant 1.2.621 → 1.2.622

package/dist/{dist-DdSdlgON.js → dist-33tQA0eu.js}

@@ -9195,7 +9195,7 @@ function errMsg(err) {
 	return String(err);
 }
 //#endregion
-//#region ../types/dist/composition-xz-ud5EQ.mjs
+//#region ../types/dist/composition-BJ8iAZb3.mjs
 /**
 * The ffmpeg build every CamStack node downloads, per platform and arch.
 *
@@ -9255,7 +9255,7 @@ portable("linux64"), portable("linuxarm64"), portable("macarm64"), portable("mac
 * ONE table for everyone who asks "is this device HIGH?": the
 * recorder's `RecordingTriggers.sensorDeviceIds` trigger, the post-analysis
 * sensor markers, the orchestrator's camera-sensors bridge and
-* the sources of a composite doorbell (`doorbellFeatureSources`, D671).
+* the sources of a pulse (`compilePulseOverride`, D936).
 * A second copy would diverge at the first cap added, and the symptom — "the
 * sensor rings the doorbell but does not record" — is exactly D62.
 *
@@ -55249,20 +55249,68 @@ var BatteryStatusSchema = object({
 	*/
 	binary: boolean().optional()
 });
+var BATTERY_DEVICE_TYPES = [
+	DeviceType.Camera,
+	DeviceType.Sensor,
+	DeviceType.Button,
+	DeviceType.Switch,
+	DeviceType.PetFeeder,
+	DeviceType.Container,
+	DeviceType.Thermostat
+];
+/** Generic Customize target for the percentage reading (D936). */
+var batteryCustomize = {
+	version: 1,
+	targets: [{
+		id: "percentage",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "battery",
+			stateField: "percentage"
+		},
+		deviceTypes: BATTERY_DEVICE_TYPES,
+		apply: "add-or-replace",
+		path: "percentage",
+		sources: [{
+			kind: "field",
+			valueKinds: ["number", "string"],
+			transforms: [{ kind: "identity" }, {
+				kind: "linear",
+				defaultScale: 1,
+				defaultOffset: 0,
+				clampMin: 0,
+				clampMax: 100
+			}]
+		}],
+		companions: [
+			{
+				kind: "constant",
+				path: "charging",
+				value: "unknown",
+				when: "add"
+			},
+			{
+				kind: "constant",
+				path: "sleeping",
+				value: false,
+				when: "add"
+			},
+			{
+				kind: "clock",
+				path: "lastUpdated",
+				when: "add"
+			}
+		],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: true
+	}]
+};
 var batteryCapability = {
 	name: "battery",
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: [
-		DeviceType.Camera,
-		DeviceType.Sensor,
-		DeviceType.Button,
-		DeviceType.Switch,
-		DeviceType.PetFeeder,
-		DeviceType.Container,
-		DeviceType.Thermostat
-	],
+	deviceTypes: BATTERY_DEVICE_TYPES,
 	methods: { 
 	/**
 	* Explicitly wake the camera from low-power sleep ahead of a
@@ -55346,6 +55394,7 @@ onStatusChanged: { data: object({
 		kind: "gauge",
 		unit: "%"
 	} } },
+	customize: batteryCustomize,
 	/** Clock fields: written, but excluded from the compare that decides
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastUpdated"]
@@ -56347,6 +56396,106 @@ var ConsumablesStatusSchema = object({
 	items: array(ConsumableItemSchema),
 	lastChangedAt: number()
 });
+/** Synthesize seed for a link-built status (no native provider).
+*
+*  ⚠ NO LIVE CALLER since 2026-08-08 (device-links deleted; see
+*  `CapabilityStatusSchema.empty`). The wiring guidance below was written for
+*  exactly the case the operator is asking about again — a Dreame's HA
+*  consumable-life sensors — so it is kept for that conversation, not because
+*  anything reads it today. */
+var EMPTY_STATUS = {
+	items: [],
+	lastChangedAt: 0
+};
+/** Seed for a NEW link-built consumable item. `key`/`label` are overwritten
+*  with the link's `itemKey` (see `status.itemArray`), so the placeholder
+*  empty strings never survive into a validated item. Link-built items are
+*  not resettable — there is no native provider to receive `reset()`.
+*
+*  Wiring guidance (HA vacuum consumable-life sensors):
+*  - a percent-remaining source (`numeric-sensor`, unit '%') → `level` via
+*    `identity` (or `linear` scale 1 offset 0 clamp [0,100] to be safe);
+*  - an hours-remaining source (e.g. Dreame 'Main Brush Time Left', unit 'h')
+*    → `level` via `linear` with scale = 100 / max-hours for that item
+*    (e.g. main brush 300 h → scale 0.3333) + clamp [0,100];
+*  - a discrete source (`enum-sensor`, e.g. mop pad 'installed') → `status`
+*    via `enum-map` (e.g. { installed: 'ok', missing: 'replace' }).
+*  A numeric→'replace' THRESHOLD (level < 10 → 'replace') is NOT expressible
+*  with the current transform kinds — leave `status` null (valid) until the
+*  expression transform lands. */
+/** Generic Customize target for one consumable item (D936). Native rows stay read-only. */
+var consumablesCustomize = {
+	version: 1,
+	targets: [{
+		id: "items",
+		cardinality: "keyedArray",
+		vocabulary: { cap: "consumables" },
+		deviceTypes: Object.values(DeviceType),
+		apply: "add",
+		path: "items",
+		keyField: "key",
+		labelField: "label",
+		itemSchema: ConsumableItemSchema,
+		nativeItems: "read-only",
+		sourceReport: { status: "assignment-status" },
+		fields: [
+			{
+				path: "level",
+				sources: [{
+					kind: "numeric",
+					transforms: [{ kind: "identity" }, {
+						kind: "linear",
+						defaultScale: 1,
+						defaultOffset: 0,
+						clampMin: 0,
+						clampMax: 100
+					}]
+				}]
+			},
+			{
+				path: "remaining.value",
+				sources: [{
+					kind: "numeric",
+					transforms: [{ kind: "identity" }]
+				}],
+				literals: [{
+					path: "remaining.unit",
+					values: [...ConsumableRemainingUnitSchema.options]
+				}]
+			},
+			{
+				path: "status",
+				sources: [{
+					kind: "enum",
+					transforms: [{
+						kind: "enum-map",
+						outputValues: [...ConsumableStatusSchema.options],
+						unmapped: null
+					}]
+				}]
+			}
+		],
+		traits: [{
+			path: "kind",
+			values: [...ConsumableKindSchema.options],
+			defaultValue: "wear"
+		}, {
+			path: "form",
+			values: [...ConsumableFormSchema.options],
+			defaultValue: "part"
+		}],
+		companions: [{
+			kind: "clock",
+			path: "lastChangedAt",
+			when: "add"
+		}, {
+			kind: "clock",
+			path: "lastFetchedAt",
+			when: "add"
+		}],
+		advancedExpression: true
+	}]
+};
 var consumablesCapability = {
 	name: "consumables",
 	scope: "device",
@@ -56384,10 +56533,7 @@ reset: method(object({
 	status: {
 		schema: ConsumablesStatusSchema,
 		kind: "push",
-		empty: {
-			items: [],
-			lastChangedAt: 0
-		},
+		empty: EMPTY_STATUS,
 		itemArray: {
 			path: "items",
 			keyField: "key",
@@ -56423,6 +56569,7 @@ reset: method(object({
 	* 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.
 	*/
+	customize: consumablesCustomize,
 	history: {
 		fields: {},
 		items: {
@@ -57165,6 +57312,36 @@ var dishwasherCapability = {
 		powerOn: { kind: "boolean" }
 	} }
 };
+/** Pulse override: a rising edge advances `lastPressedAt` and the press count. */
+var doorbellCustomize = {
+	version: 1,
+	targets: [{
+		id: "pressed",
+		cardinality: "event",
+		shape: "pulse",
+		vocabulary: {
+			cap: "doorbell",
+			eventName: "onPressed"
+		},
+		deviceTypes: [DeviceType.Camera],
+		apply: "add",
+		applyAuthority: { kind: "composition-claim" },
+		eventName: "onPressed",
+		edges: ["rising"],
+		timestampPath: "lastPressedAt",
+		counterPath: "pressCountSinceStart",
+		highWater: "composer-advance",
+		combine: "any",
+		debounce: {
+			kind: "rising-edge",
+			defaultDebounceMs: 2e3,
+			changedAtRequired: true
+		},
+		sources: [{ kind: "binary" }, { kind: "switch" }],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: true
+	}]
+};
 var DoorbellStatusSchema = object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: number().nullable(),
@@ -57231,7 +57408,8 @@ onPressed: {
 	/**
 	* History (D850): none — `pressCountSinceStart` resets with the addon, so it is not a monotonic meter; presses live in the events ledger.
 	*/
-	history: "none"
+	history: "none",
+	customize: doorbellCustomize
 };
 /**
 * Enum-state sensor — a string value picked from a finite option set.
@@ -59627,6 +59805,38 @@ authKey: string().optional() }), object({
 	/** Human-readable error when `ok: false`. */
 	error: string().optional()
 }), { kind: "mutation" });
+/** Span override: start on a rising edge, end on a fall or this timeout. */
+var motionCustomize = {
+	version: 1,
+	targets: [{
+		id: "detected",
+		cardinality: "event",
+		shape: "span",
+		vocabulary: {
+			cap: "motion",
+			eventName: "onMotionChanged"
+		},
+		deviceTypes: [DeviceType.Camera],
+		apply: "replace",
+		applyAuthority: {
+			kind: "camera-sensors",
+			timeoutField: "motionCooldownMs"
+		},
+		eventName: "onMotionChanged",
+		start: "rising-edge",
+		end: "falling-edge-or-timeout",
+		timeoutMs: 3e4,
+		combine: "any",
+		sourceModes: [
+			"in-addition",
+			"confirm",
+			"replace"
+		],
+		sources: [{ kind: "binary" }, { kind: "switch" }],
+		sourceReport: { status: "assignment-status" },
+		advancedExpression: false
+	}]
+};
 var MotionStatusSchema = object({
 	detected: boolean(),
 	/** Ms epoch of the last detected-true observation. Null if never detected. */
@@ -59766,7 +59976,8 @@ onMotionChanged: { data: MotionOnMotionChangedDataSchema } },
 	history: { fields: { detected: {
 		kind: "boolean",
 		excludeDeviceTypes: [DeviceType.Camera]
-	} } }
+	} } },
+	customize: motionCustomize
 };
 /**
 * Motion-trigger toggle for accessory devices.
@@ -62492,6 +62703,16 @@ var ptzAutotrackCapability = {
 	*/
 	history: "none"
 };
+var RUNNING_POWER_START_DELAY_MS = 3e4;
+var RUNNING_POWER_STOP_DELAY_MS = 18e4;
+/** Before any provider reading — all fields unknown (D933). */
+var RUNNING_STATE_COLD = {
+	running: null,
+	since: null,
+	source: "native",
+	phase: null,
+	lastFetchedAt: null
+};
 var RunningStateSourceSchema = _enum(["native", "assigned"]);
 var RunningStateStatusSchema = object({
 	/** null = unknown — never coerced to false (D393). */
@@ -62500,19 +62721,100 @@ var RunningStateStatusSchema = object({
 	since: number().nullable(),
 	source: RunningStateSourceSchema,
 	phase: string().nullable(),
-	lastFetchedAt: number()
+	/** null until a reading has been published (D393). */
+	lastFetchedAt: number().nullable()
 });
 var RunningFlipEventDataSchema = object({
 	deviceId: number(),
 	since: number().nullable(),
 	phase: string().nullable()
 });
+var RUNNING_DEVICE_TYPES = Object.values(DeviceType);
+/** Generic Customize target for the running boolean (D936). */
+var runningCustomize = {
+	version: 1,
+	targets: [{
+		id: "running",
+		cardinality: "scalar",
+		vocabulary: {
+			cap: "running-state",
+			stateField: "running"
+		},
+		deviceTypes: [
+			DeviceType.Dishwasher,
+			DeviceType.Vacuum,
+			DeviceType.LawnMower,
+			DeviceType.MediaPlayer,
+			DeviceType.WaterHeater,
+			DeviceType.Humidifier,
+			DeviceType.Fan,
+			DeviceType.Climate,
+			DeviceType.Thermostat,
+			DeviceType.PetFeeder
+		],
+		apply: "add-or-replace",
+		path: "running",
+		sources: [
+			{
+				kind: "switch",
+				transforms: [{ kind: "identity" }]
+			},
+			{
+				kind: "binary",
+				transforms: [{ kind: "identity" }, { kind: "invert" }]
+			},
+			{
+				kind: "numeric",
+				requiredUnit: "W",
+				transforms: [{
+					kind: "threshold",
+					comparison: "gte",
+					defaultThreshold: 5,
+					defaultStartDwellMs: RUNNING_POWER_START_DELAY_MS,
+					defaultStopDwellMs: RUNNING_POWER_STOP_DELAY_MS,
+					thresholdUnit: "W"
+				}]
+			}
+		],
+		companions: [
+			{
+				kind: "constant",
+				path: "source",
+				value: "assigned",
+				when: "always"
+			},
+			{
+				kind: "constant",
+				path: "phase",
+				value: null,
+				when: "always"
+			},
+			{
+				kind: "clock",
+				path: "lastFetchedAt",
+				when: "always"
+			},
+			{
+				kind: "transition-time",
+				path: "since",
+				sourceChangedAt: "prefer"
+			}
+		],
+		sourceReport: {
+			status: "assignment-status",
+			runtimeField: "source",
+			nativeValue: "native",
+			assignedValue: "assigned"
+		},
+		advancedExpression: true
+	}]
+};
 var runningStateCapability = {
 	name: "running-state",
 	scope: "device",
 	deviceNative: true,
 	mode: "singleton",
-	deviceTypes: Object.values(DeviceType),
+	deviceTypes: RUNNING_DEVICE_TYPES,
 	methods: {},
 	events: {
 		onStarted: { data: RunningFlipEventDataSchema },
@@ -62525,7 +62827,8 @@ var runningStateCapability = {
 	runtimeState: RunningStateStatusSchema,
 	durability: "restored",
 	history: { fields: { running: { kind: "boolean" } } },
-	volatileStateFields: ["lastFetchedAt"]
+	volatileStateFields: ["lastFetchedAt"],
+	customize: runningCustomize
 };
 DeviceType.Camera, DeviceType.Sensor, DeviceType.Switch, method(object({ deviceId: number().int().nonnegative() }), object({ success: literal(true) }), {
 	kind: "mutation",
@@ -67157,37 +67460,42 @@ method(object({}), array(TrainingBaseModelSchema).readonly(), { auth: "admin" })
 	kind: "mutation",
 	auth: "admin"
 });
-function resolveSince(running, previous, sinceMs) {
+function resolveSince(running, previous, transitionAtMs, bootstrapSinceMs) {
 	if (running === null) return null;
-	if ((previous?.running ?? null) !== running) return sinceMs;
-	return previous?.since ?? sinceMs;
+	const prevRunning = previous?.running ?? null;
+	if (prevRunning === null) return bootstrapSinceMs;
+	if (prevRunning !== running) return transitionAtMs;
+	return previous?.since ?? null;
 }
-function nativeSlice(running, phase, previous, sinceMs, now) {
+function nativeSlice(running, phase, previous, transitionAtMs, fetchedAt, bootstrapSinceMs) {
 	return {
 		running,
-		since: resolveSince(running, previous, sinceMs),
+		since: resolveSince(running, previous, transitionAtMs, bootstrapSinceMs),
 		source: "native",
 		phase: running === null ? null : phase,
-		lastFetchedAt: now
+		lastFetchedAt: fetchedAt
 	};
 }
-function runningFromVacuumState(state, previous, now) {
-	if (state === null) return nativeSlice(null, null, previous, now, now);
-	if (state === "cleaning" || state === "returning" || state === "drying") return nativeSlice(true, state, previous, now, now);
-	if (state === "paused") return nativeSlice(false, "paused", previous, now, now);
-	return nativeSlice(false, state, previous, now, now);
+function runningFromVacuumState(state, previous, fetchedAt, transitionAt) {
+	const transitionAtMs = transitionAt ?? fetchedAt;
+	if (state === null) return nativeSlice(null, null, previous, transitionAtMs, fetchedAt, null);
+	if (state === "cleaning" || state === "returning" || state === "drying") return nativeSlice(true, state, previous, transitionAtMs, fetchedAt, null);
+	if (state === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
+	return nativeSlice(false, state, previous, transitionAtMs, fetchedAt, null);
 }
-function runningFromLawnMower(activity, previous, now) {
-	if (activity === null) return nativeSlice(null, null, previous, now, now);
-	if (activity === "mowing") return nativeSlice(true, activity, previous, now, now);
-	if (activity === "paused") return nativeSlice(false, "paused", previous, now, now);
-	return nativeSlice(false, activity, previous, now, now);
+function runningFromLawnMower(activity, previous, fetchedAt, transitionAt) {
+	const transitionAtMs = transitionAt ?? fetchedAt;
+	if (activity === null) return nativeSlice(null, null, previous, transitionAtMs, fetchedAt, null);
+	if (activity === "mowing") return nativeSlice(true, activity, previous, transitionAtMs, fetchedAt, null);
+	if (activity === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
+	return nativeSlice(false, activity, previous, transitionAtMs, fetchedAt, null);
 }
-function runningFromMediaPlayer(state, previous, now) {
-	if (state === null) return nativeSlice(null, null, previous, now, now);
-	if (state === "playing" || state === "buffering") return nativeSlice(true, state, previous, now, now);
-	if (state === "paused") return nativeSlice(false, "paused", previous, now, now);
-	return nativeSlice(false, state, previous, now, now);
+function runningFromMediaPlayer(state, previous, fetchedAt, transitionAt) {
+	const transitionAtMs = transitionAt ?? fetchedAt;
+	if (state === null) return nativeSlice(null, null, previous, transitionAtMs, fetchedAt, null);
+	if (state === "playing" || state === "buffering") return nativeSlice(true, state, previous, transitionAtMs, fetchedAt, null);
+	if (state === "paused") return nativeSlice(false, "paused", previous, transitionAtMs, fetchedAt, null);
+	return nativeSlice(false, state, previous, transitionAtMs, fetchedAt, null);
 }
 SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
 Object.freeze({
@@ -85073,6 +85381,96 @@ Object.freeze({
 	"smtp-provider": "email"
 });
 DeviceType.Camera;
+DeviceType.Camera, DeviceType.Sensor, DeviceType.Button, DeviceType.Switch, DeviceType.PetFeeder, DeviceType.Container, DeviceType.Thermostat, DeviceType.Camera, DeviceType.Hub, DeviceType.Light, DeviceType.Siren, DeviceType.Switch, DeviceType.Sensor, DeviceType.Thermostat, DeviceType.Climate, DeviceType.Button, DeviceType.EventEmitter, DeviceType.Update, DeviceType.Generic, DeviceType.Notifier, DeviceType.Script, DeviceType.Automation, DeviceType.Lock, DeviceType.Cover, DeviceType.Valve, DeviceType.Humidifier, DeviceType.WaterHeater, DeviceType.Fan, DeviceType.MediaPlayer, DeviceType.AlarmPanel, DeviceType.Control, DeviceType.Presence, DeviceType.Weather, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.Container, DeviceType.Image, DeviceType.PetFeeder, DeviceType.Dishwasher, DeviceType.Camera, DeviceType.Camera, DeviceType.Dishwasher, DeviceType.Vacuum, DeviceType.LawnMower, DeviceType.MediaPlayer, DeviceType.WaterHeater, DeviceType.Humidifier, DeviceType.Fan, DeviceType.Climate, DeviceType.Thermostat, DeviceType.PetFeeder;
+/**
+* A saved Customize assignment (D936). The schema is the type: callers use
+* `z.infer`, they do not restate the shape.
+*/
+var OverrideSourceSchema = object({
+	addonId: string().min(1),
+	stableId: string().min(1),
+	cap: string().min(1),
+	fieldPath: string().min(1)
+});
+var CustomizeTransformDraftSchema = discriminatedUnion("kind", [
+	object({ kind: literal("identity") }),
+	object({ kind: literal("invert") }),
+	object({
+		kind: literal("threshold"),
+		comparison: _enum(["gte", "lte"]),
+		threshold: number(),
+		startDwellMs: number().nonnegative(),
+		stopDwellMs: number().nonnegative()
+	}),
+	object({
+		kind: literal("linear"),
+		scale: number(),
+		offset: number(),
+		clampMin: number().optional(),
+		clampMax: number().optional()
+	}),
+	object({
+		kind: literal("enum-map"),
+		mapping: record(string(), string().nullable())
+	}),
+	object({ kind: literal("number") })
+]);
+var ScalarOverrideDraftSchema = object({
+	kind: literal("scalar"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var KeyedArrayOverrideDraftSchema = object({
+	kind: literal("keyedArray"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	key: string().min(1),
+	label: string().min(1),
+	fieldPath: string().min(1),
+	source: OverrideSourceSchema,
+	transform: CustomizeTransformDraftSchema
+});
+var PulseOverrideDraftSchema = object({
+	kind: literal("pulse"),
+	cap: string().min(1),
+	targetId: string().min(1),
+	enabled: boolean(),
+	debounceMs: number().nonnegative(),
+	sources: array(OverrideSourceSchema).min(1)
+});
+var SpanSourceDraftSchema = OverrideSourceSchema.extend({ mode: _enum([
+	"in-addition",
+	"confirm",
+	"replace"
+]).optional() });
+discriminatedUnion("kind", [
+	ScalarOverrideDraftSchema,
+	KeyedArrayOverrideDraftSchema,
+	PulseOverrideDraftSchema,
+	object({
+		kind: literal("span"),
+		cap: string().min(1),
+		targetId: string().min(1),
+		timeoutMs: number().nonnegative(),
+		cooldownMs: number().nonnegative().optional(),
+		sources: array(SpanSourceDraftSchema)
+	})
+]);
+object({
+	targetId: string().min(1),
+	configured: boolean(),
+	source: _enum(["native", "assigned"]),
+	state: _enum([
+		"active",
+		"stale",
+		"released",
+		"unavailable"
+	]),
+	reason: string().nullable()
+});
+String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
 var G711_SCALE_CORRECTION_DB = {
 	PCMU: 20 * Math.log10(4),
 	PCMA: 20 * Math.log10(8)
@@ -86634,6 +87032,12 @@ Object.defineProperty(exports, "MediaPlayerRepeatSchema", {
 		return MediaPlayerRepeatSchema;
 	}
 });
+Object.defineProperty(exports, "RUNNING_STATE_COLD", {
+	enumerable: true,
+	get: function() {
+		return RUNNING_STATE_COLD;
+	}
+});
 Object.defineProperty(exports, "RecordSecretUnavailableError", {
 	enumerable: true,
 	get: function() {