@camstack/addon-export-alexa 1.2.147 → 1.2.148

package/dist/export-alexa.addon.js

@@ -34,7 +34,7 @@ let node_path = require("node:path");
 node_path = __toESM(node_path, 1);
 require("node:child_process");
 require("node:zlib");
-//#region ../types/dist/event-category-BvOFi6PY.mjs
+//#region ../types/dist/event-category-DOl51-Ij.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -113,9 +113,18 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/**
 	* The node's one-shot runner boot check (D877): planned runners against the
 	* process service, `degraded` when any is failed, refused or missing. The
-	* alert centre turns it into one alert and a direct critical push.
+	* alert centre turns it into one critical alert.
 	*/
 	EventCategory["SystemRunnerCheck"] = "system.runner-check";
+	/**
+	* An alert EPISODE opened or closed, emitted by the alert centre for alerts
+	* of severity `critical` or `error` (`AlertEpisodePayload`). The alert
+	* centre sends no notification of its own: Notification Center turns this
+	* into the `alert-critical` / `alert-error` / `alert-critical-resolved`
+	* system-event kinds, and reconciles from the alerts store because a bus
+	* event may be dropped (D8, D11).
+	*/
+	EventCategory["AlertEpisode"] = "alert.episode";
 	EventCategory["AddonError"] = "addon.error";
 	EventCategory["AddonPageReady"] = "addon.page-ready";
 	EventCategory["AddonWidgetReady"] = "addon.widget-ready";
@@ -5440,7 +5449,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BegKjwUu.mjs
+//#region ../types/dist/sleep-BxjU_fJM.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -13437,7 +13446,14 @@ var AlertSeveritySchema = _enum([
 ]);
 var AlertActionSchema = object({
 	label: string(),
-	href: string().optional()
+	href: string().optional(),
+	/**
+	* How `href` is followed. Absent / `app`: an admin-ui route (client-side).
+	* `server`: a route the HUB serves (an addon HTTP route such as an OAuth
+	* start) — the browser must leave the SPA with a full navigation, because
+	* the SPA has no such route and would bounce to the home page.
+	*/
+	navigation: _enum(["app", "server"]).optional()
 });
 var AlertStatusSchema = _enum([
 	"active",
@@ -41838,6 +41854,9 @@ var NcSystemEventKindSchema = _enum([
 	"server-updated",
 	"export-completed",
 	"backup-completed",
+	"alert-critical",
+	"alert-error",
+	"alert-critical-resolved",
 	"camera-online",
 	"camera-offline",
 	"camera-disabled",
@@ -50886,7 +50905,10 @@ method(StorageMigrationInputSchema, StorageMigrationPlanSchema, { auth: "admin"
 }), method(object({ jobId: string().optional() }), StorageMigrationJobSchema.nullable(), { auth: "admin" }), method(object({ jobId: string() }), object({ cancelled: boolean() }), {
 	kind: "mutation",
 	auth: "admin"
-}), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
+}), method(object({}), array(StorageMigrationMoverSchema).readonly(), { auth: "admin" }), method(object({ locationIds: array(string()).readonly() }), object({
+	clear: boolean(),
+	repointLocationId: string().optional()
+}), { auth: "admin" }), method(object({}), array(StorageMigrationResidueSchema).readonly(), { auth: "admin" }), method(StorageMigrationDrainInputSchema, object({ jobId: string() }), {
 	kind: "mutation",
 	auth: "admin"
 }), method(StorageCleanupInputSchema, object({ jobId: string() }), {
@@ -54345,6 +54367,11 @@ object({
 *
 * `kind: 'poll'` — cloud REST APIs typically have no push channel; the
 * provider refreshes the slice on an interval and eagerly after commands.
+*
+* UNKNOWN IS NOT OFF. Every field the appliance reports separately is
+* nullable: `null` means "not known right now" (the appliance has not said,
+* the link is down, or the description does not carry it) and is never
+* rendered or exported as `false` / `0`. `availability` says why.
 */
 var DishwasherStateSchema = _enum([
 	"idle",
@@ -54354,112 +54381,227 @@ var DishwasherStateSchema = _enum([
 	"error",
 	"unavailable"
 ]);
+/**
+* The appliance's own operation state, uncollapsed. `state` above is the coarse
+* view for compact surfaces; this is what the appliance said.
+*/
+var DishwasherOperationStateSchema = _enum([
+	"Inactive",
+	"Ready",
+	"DelayedStart",
+	"Run",
+	"Pause",
+	"ActionRequired",
+	"Finished",
+	"Error",
+	"Aborting"
+]);
+/**
+* Why fields may be `null`:
+*  - `available`           — the link is up and the description is loaded;
+*  - `offline`             — the local link is down (values are unknown, not last-known);
+*  - `description-missing` — the link is up but the appliance's description could not
+*                            be loaded, so its values cannot be decoded.
+*/
+var DishwasherAvailabilitySchema = _enum([
+	"available",
+	"offline",
+	"description-missing"
+]);
 var DishwasherConsumableLevelSchema = _enum([
 	"ok",
 	"low",
 	"empty"
 ]);
 object({
+	availability: DishwasherAvailabilitySchema,
+	/** Coarse state for compact surfaces; `unavailable` whenever the appliance state is not known. */
 	state: DishwasherStateSchema,
-	/** Active program id/name, or null when none selected / unknown. */
+	/** The appliance's operation state as reported; null when not known. */
+	operationState: DishwasherOperationStateSchema.nullable(),
+	/** Feature key of the ACTIVE (running) program, or null when none runs / not known. */
 	program: string().nullable(),
-	/** Program tokens the hardware accepts — drives the UI selector. */
+	/** Feature key of the SELECTED program (what Start would run), or null when none / not known. */
+	selectedProgram: string().nullable(),
+	/** Feature keys of the programs the appliance currently offers — drives the UI selector. */
 	availablePrograms: array(string()),
-	/** Minutes remaining on the active cycle, or null when not running. */
-	remainingMinutes: number().int().nonnegative().nullable(),
+	/** Seconds remaining on the active cycle, or null when not running / not known. */
+	remainingSeconds: number().int().nonnegative().nullable(),
+	/** Seconds the delayed start is set to (time until the cycle starts), or null. */
+	delayedStartSeconds: number().int().nonnegative().nullable(),
 	/** Cycle completion 0..100, or null when not applicable. */
 	progressPercent: number().min(0).max(100).nullable(),
-	/** True when the door is reported open. */
-	doorOpen: boolean(),
-	/** True when remote start is allowed (door closed, power on, etc.). */
-	remoteStartAllowed: boolean(),
-	/** Main power / switched-on state. */
-	powerOn: boolean(),
+	/** True when the door is reported open; null when the door state is not known. */
+	doorOpen: boolean().nullable(),
+	/** True when the door is latched (locked) during a cycle; null when not reported. */
+	doorLocked: boolean().nullable(),
+	/** True when remote start is allowed (door closed, power on, etc.); null when not known. */
+	remoteStartAllowed: boolean().nullable(),
+	/** True when the appliance accepts remote control now; null when not known. */
+	remoteControlActive: boolean().nullable(),
+	/** True while somebody operates the appliance at its panel; null when not reported. */
+	localControlActive: boolean().nullable(),
+	/** Main power / switched-on state; null when not known. */
+	powerOn: boolean().nullable(),
+	/** The raw power state (`On`, `Off`, `Standby`, …); null when not known. */
+	powerState: string().nullable(),
 	saltLevel: DishwasherConsumableLevelSchema.nullable(),
 	rinseAidLevel: DishwasherConsumableLevelSchema.nullable(),
-	halfLoad: boolean(),
-	hygienePlus: boolean(),
+	/** Option states: null when the appliance does not expose the option or has not said. */
+	halfLoad: boolean().nullable(),
+	hygienePlus: boolean().nullable(),
 	/** Extra dry option when the appliance exposes it. */
-	extraDry: boolean(),
+	extraDry: boolean().nullable(),
 	/** Intensive zone (lower basket) when the appliance exposes it. */
-	intensiveZone: boolean(),
+	intensiveZone: boolean().nullable(),
 	/** VarioSpeed / VarioSpeed+ when the appliance exposes it. */
-	varioSpeedPlus: boolean(),
-	/** Child lock (controls disabled on the appliance). */
-	childLock: boolean(),
+	varioSpeedPlus: boolean().nullable(),
+	/** Child lock (controls disabled on the appliance); null when not known. */
+	childLock: boolean().nullable(),
+	/** Feature keys of the events currently raised (salt low, rinse aid low, program finished, …). */
+	activeEvents: array(string()),
+	/** Numeric error code when the appliance reports one; null otherwise. */
 	errorCode: number().nullable(),
+	/** Name of the raised alert-level event while the appliance is in error; null otherwise. */
 	errorLabel: string().nullable(),
+	/** Ms epoch of the last value received from the appliance; 0 = never. */
 	lastFetchedAt: number()
 });
-DeviceType.Dishwasher, method(object({ deviceId: number().int().nonnegative() }), _void(), {
+var DeviceIdSchema = number().int().nonnegative();
+/** A value a program option or setting can take. */
+var DishwasherValueSchema = union([
+	boolean(),
+	string(),
+	number()
+]);
+var DishwasherAccessSchema = _enum([
+	"none",
+	"read",
+	"readWrite",
+	"writeOnly",
+	"readStatic"
+]);
+/**
+* One option or setting the appliance declares, with the constraints its description
+* gives. A `readWrite` descriptor that is `available` is what `setOption` accepts.
+*/
+var DishwasherOptionDescriptorSchema = object({
+	/** Feature key (`Dishcare.Dishwasher.Option.ExtraDry`). */
+	key: string(),
+	/** Last segment of the key, for display. */
+	name: string(),
+	type: _enum([
+		"boolean",
+		"number",
+		"enum",
+		"string"
+	]),
+	access: DishwasherAccessSchema,
+	/** The appliance reports this entity as currently available. */
+	available: boolean(),
+	/** Unit the description declares for a number; null when it declares none. */
+	unit: string().nullable(),
+	min: number().nullable(),
+	max: number().nullable(),
+	step: number().nullable(),
+	/** Allowed members of an enum; null for other types. */
+	enumValues: array(string()).nullable(),
+	defaultValue: DishwasherValueSchema.nullable()
+});
+var DishwasherProgramSchema = object({
+	/** Feature key (`Dishcare.Dishwasher.Program.Eco50`) — what `setProgram` / `start` take. */
+	key: string(),
+	name: string(),
+	/** The appliance currently offers this program. */
+	available: boolean(),
+	/** The options this program lists, with the program-level access / availability / default. */
+	options: array(DishwasherOptionDescriptorSchema)
+});
+var DishwasherOptionsSchema = object({
+	availability: DishwasherAvailabilitySchema,
+	/** What the appliance can be told to do, from the commands its description declares. */
+	supportsStart: boolean(),
+	supportsPause: boolean(),
+	supportsResume: boolean(),
+	supportsStop: boolean(),
+	supportsPower: boolean(),
+	/** Every program the description lists, with its options. */
+	programs: array(DishwasherProgramSchema),
+	/** Every option and setting entity the description lists (programs reference these by key). */
+	options: array(DishwasherOptionDescriptorSchema)
+});
+DeviceType.Dishwasher, method(object({
+	deviceId: DeviceIdSchema,
+	program: string().min(1).optional(),
+	options: record(string(), DishwasherValueSchema).optional()
+}), _void(), {
 	kind: "mutation",
 	auth: "protected"
-}), method(object({ deviceId: number().int().nonnegative() }), _void(), {
+}), method(object({ deviceId: DeviceIdSchema }), _void(), {
 	kind: "mutation",
 	auth: "protected"
-}), method(object({ deviceId: number().int().nonnegative() }), _void(), {
+}), method(object({ deviceId: DeviceIdSchema }), _void(), {
+	kind: "mutation",
+	auth: "protected"
+}), method(object({ deviceId: DeviceIdSchema }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	program: string().min(1)
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	on: boolean()
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
 }), method(object({
-	deviceId: number().int().nonnegative(),
+	deviceId: DeviceIdSchema,
 	key: string().min(1),
-	value: union([
-		boolean(),
-		string(),
-		number()
-	])
+	value: DishwasherValueSchema
 }), _void(), {
 	kind: "mutation",
 	auth: "protected"
-});
+}), method(object({ deviceId: DeviceIdSchema }), DishwasherOptionsSchema, { auth: "protected" });
 object({
 	/** Ms epoch of the last press. null = never observed since this provider started. */
 	lastPressedAt: number().nullable(),
@@ -64550,6 +64692,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"dishwasher.getOptions": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "view"
+	},
 	"dishwasher.getStatus": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -64562,6 +64710,12 @@ Object.freeze({
 		addonId: null,
 		access: "create"
 	},
+	"dishwasher.resume": {
+		capName: "dishwasher",
+		capScope: "device",
+		addonId: null,
+		access: "create"
+	},
 	"dishwasher.setChildLock": {
 		capName: "dishwasher",
 		capScope: "device",
@@ -69062,6 +69216,12 @@ Object.freeze({
 		addonId: null,
 		access: "view"
 	},
+	"storageMigration.moverClearance": {
+		capName: "storage-migration",
+		capScope: "system",
+		addonId: null,
+		access: "view"
+	},
 	"storageMigration.movers": {
 		capName: "storage-migration",
 		capScope: "system",
@@ -71255,6 +71415,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.getOptions": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.getStatus": [{
 		name: "deviceId",
 		form: "single",
@@ -71265,6 +71430,11 @@ Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"dishwasher.resume": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"dishwasher.setChildLock": [{
 		name: "deviceId",
 		form: "single",
@@ -73351,6 +73521,9 @@ new Map(Object.entries({
 	"wrapper-update-available": "system",
 	"backup-completed": "system",
 	"export-completed": "system",
+	"alert-critical": "system",
+	"alert-error": "system",
+	"alert-critical-resolved": "system",
 	"storage-location-low": "system",
 	"storage-location-critical": "system",
 	"storage-location-ok": "system",
@@ -73475,6 +73648,16 @@ var NC_SYSTEM_EVENT_KIND_GROUP_SPECS = [
 			"storage-location-ok"
 		]
 	},
+	{
+		id: "alerts",
+		family: "system",
+		label: "Alerts",
+		kinds: [
+			"alert-critical",
+			"alert-error",
+			"alert-critical-resolved"
+		]
+	},
 	{
 		id: "alarm",
 		family: "alarm",
@@ -73519,6 +73702,21 @@ var NC_SENSOR_RAISED_FIELD_BY_KIND = Object.freeze(Object.fromEntries(Object.ent
 	return [[descriptor.kind, field]];
 })));
 Object.freeze(Object.keys(NC_SENSOR_RAISED_FIELD_BY_KIND));
+object({
+	phase: _enum(["raised", "resolved"]),
+	episodeId: string().min(1),
+	alertId: string().min(1),
+	severity: AlertSeveritySchema,
+	category: string(),
+	title: string(),
+	message: string(),
+	sourceType: string().optional(),
+	sourceId: string().optional(),
+	nodeId: string().optional(),
+	/** The alert's own action link (where the operator acts on it), when it has one. */
+	actionUrl: string().optional(),
+	at: number()
+});
 var RULE_BODY_ONLY = ["body"];
 var RULE_TEXT = ["title", "body"];
 var BATTERY = ["device-battery-low", "device-battery-normal"];
@@ -73528,6 +73726,11 @@ var TANK = [
 	"device-tank-full",
 	"device-tank-normal"
 ];
+var ALERT_EPISODE = [
+	"alert-critical",
+	"alert-error",
+	"alert-critical-resolved"
+];
 var UPDATES = [
 	"addon-update-available",
 	"server-update-available",
@@ -73720,14 +73923,14 @@ var STATE_SUMMARY_VARS = [
 	([...RULE_TEXT], [...CONSUMABLE]),
 	([...RULE_TEXT], [...TANK]),
 	[...RULE_TEXT],
-	([...RULE_TEXT], [...UPDATES]),
-	([...RULE_TEXT], [...UPDATES]),
-	[...RULE_TEXT],
+	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
+	([...RULE_TEXT], [...UPDATES, ...ALERT_EPISODE]),
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
+	([...RULE_TEXT], [...ALERT_EPISODE]),
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
@@ -73745,7 +73948,11 @@ var STATE_SUMMARY_VARS = [
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
-	[...RULE_TEXT],
+	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...ALERT_EPISODE]),
+	([...RULE_TEXT], [...ALERT_EPISODE]),
 	[...RULE_TEXT],
 	[...RULE_TEXT],
 	[...RULE_TEXT],
@@ -83634,13 +83841,20 @@ function buildAlexaOauthIntegration(publicHubUrl) {
 function buildAlexaSetupBlock(input) {
 	const base = input.publicHubUrl.replace(/\/+$/, "");
 	return {
-		fields: [...base ? [{
-			label: "Directive endpoint",
-			value: `${base}/addon/export-alexa/directive`
-		}] : [], ...input.ingressToken && input.skillMode === "custom" ? [{
-			label: "Ingress token (Lambda HUB_INGRESS_TOKEN) — use \"Show ingress token\" in settings",
-			value: maskSecretTail(input.ingressToken)
-		}] : []],
+		fields: [
+			...base ? [{
+				label: "Hub address to enter in the Alexa app",
+				value: base
+			}] : [],
+			...base ? [{
+				label: "Directive endpoint",
+				value: `${base}/addon/export-alexa/directive`
+			}] : [],
+			...input.ingressToken && input.skillMode === "custom" ? [{
+				label: "Ingress token (Lambda HUB_INGRESS_TOKEN) — use \"Show ingress token\" in settings",
+				value: maskSecretTail(input.ingressToken)
+			}] : []
+		],
 		note: base ? "Account linking is handled by the core OAuth server. Use the hub's /api/oauth2/authorize endpoint with integration=export-alexa." : "Set the public hub URL on the settings form first — the directive endpoint URL is derived from it."
 	};
 }