@camstack/addon-provider-bosch 0.1.53 → 0.1.54

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.54] - 2026-11-12
+
+### Changed
+
+- A new Bosch SHC gateway is named "Bosch SHC", and a new HomeCom gateway "Bosch HomeCom" plus its device type.
+
 ## [0.1.53] - 2026-11-12
 
 ### Changed

package/dist/{account-integration-offline-KQcJ_VVK.mjs → account-integration-offline-C9glrBvy.mjs}

@@ -1,4 +1,4 @@
-import { et as errMsg } from "./bosch-instances-y_A00js_.mjs";
+import { nt as errMsg } from "./bosch-instances-DMzZSMxW.mjs";
 import { randomBytes } from "node:crypto";
 //#region src/shared/sign-in-redirects.ts
 /** The addresses each vendor sends the browser to after a sign-in; no browser can open them. Kept free of imports so the form schema can name them. */

package/dist/{account-integration-offline-C-KJYRdX.js → account-integration-offline-DK6CYsvB.js}

@@ -1,4 +1,4 @@
-const require_bosch_instances = require("./bosch-instances-dqTG9no9.js");
+const require_bosch_instances = require("./bosch-instances-DkTzZrlR.js");
 let node_crypto = require("node:crypto");
 //#region src/shared/sign-in-redirects.ts
 /** The addresses each vendor sends the browser to after a sign-in; no browser can open them. Kept free of imports so the form schema can name them. */

package/dist/{bosch-instances-y_A00js_.mjs → bosch-instances-DMzZSMxW.mjs}

@@ -44097,6 +44097,51 @@ function macroOnly(macro) {
 		};
 	}
 }
+var EventVocabularyKindSchema = _enum([
+	"press",
+	"long-press",
+	"long-press-start",
+	"release",
+	"repeat",
+	"double-press",
+	"other"
+]);
+/** The part of the device an event comes from: a button, a channel. */
+var EventVocabularySourceSchema = object({
+	id: string().min(1),
+	label: string().min(1)
+});
+/** One scalar field of an event's `data`, by dotted path. */
+var EventVocabularyFieldSchema = object({
+	path: string().min(1),
+	kind: _enum([
+		"string",
+		"number",
+		"boolean",
+		"enum"
+	]),
+	enumValues: array(string()).optional(),
+	label: string().min(1).optional()
+});
+var EventVocabularyEntrySchema = object({
+	/** The native token, verbatim. */
+	id: string().min(1),
+	source: EventVocabularySourceSchema.optional(),
+	label: string().min(1),
+	description: string().optional(),
+	kind: EventVocabularyKindSchema.optional(),
+	payload: array(EventVocabularyFieldSchema).optional()
+});
+/**
+* The vocabulary of a source that declares tokens and nothing else: one
+* entry per token, labelled with the token itself.
+*/
+function plainEventVocabulary(eventTypes) {
+	return [...new Set(eventTypes)].filter((eventType) => eventType !== "").map((eventType) => ({
+		id: eventType,
+		label: eventType
+	}));
+}
 Math.PI / 180;
 /**
 * WHEN something happens, as data (D983) — the one time vocabulary of the
@@ -44304,6 +44349,33 @@ var ScheduleLeafSchema = object({
 	/** @deprecated legacy cron — new schedules use `at`. */
 	cron: string().min(1).max(120).optional()
 }).refine((leaf) => leaf.at === void 0 !== (leaf.cron === void 0), { message: "a schedule names exactly one of `at` (a time spec) and `cron` (legacy)" }).refine((leaf) => leaf.days === void 0 || leaf.at !== void 0, { message: "`days` goes with `at`; a cron expression carries its own days" });
+/**
+* One payload predicate of a `device-fired` row: the value at `path` inside
+* the fire's `data` (dotted) equals `equals`. Compared strictly, no coercion.
+*/
+var DeviceFiredMatchSchema = object({
+	path: string().min(1).max(120),
+	equals: union([
+		string(),
+		number$1(),
+		boolean()
+	])
+});
+/**
+* "fires": one device of the `event-emitter` capability reported an event
+* (D1045). Every list is an OR, the lists together an AND; an absent list does
+* not narrow. `eventIds` are the device's own tokens, `sourceIds` the parts of
+* the device (a button), `kinds` the shared press kinds of its vocabulary.
+*/
+var DeviceFiredLeafSchema = object({
+	kind: literal("device-fired"),
+	...eventLeafId,
+	deviceId: number$1().int().nonnegative(),
+	eventIds: array(string().min(1)).min(1).max(64).optional(),
+	sourceIds: array(string().min(1)).min(1).max(64).optional(),
+	kinds: array(EventVocabularyKindSchema).min(1).optional(),
+	match: array(DeviceFiredMatchSchema).min(1).max(8).optional()
+});
 var ManualLeafSchema = object({
 	kind: literal("manual"),
 	...eventLeafId
@@ -44445,6 +44517,7 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	}),
 	DeviceBecomesLeafSchema,
 	DeviceEventLeafSchema,
+	DeviceFiredLeafSchema,
 	ScheduleLeafSchema,
 	ManualLeafSchema,
 	IntervalLeafSchema,
@@ -44459,6 +44532,7 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 var EVENT_KINDS = new Set([
 	"device-becomes",
 	"device-event",
+	"device-fired",
 	"schedule",
 	"manual",
 	"interval",
@@ -44539,6 +44613,7 @@ function hasEmptyContainer(node) {
 var LEAF_WORDS = {
 	"device-becomes": "a device value that becomes",
 	"device-event": "a device event",
+	"device-fired": "a device firing an event",
 	schedule: "a schedule",
 	manual: "a manual run",
 	interval: "an interval",
@@ -45182,6 +45257,16 @@ var BECOMES_DESCRIPTIONS = {
 	from: "the value before the change, empty when it is not known",
 	to: "the value it changed to"
 };
+/**
+* A fire's payload is offered too, as `data.<path>` (`{{vars.data.channel}}`):
+* those names depend on the device, so they are not in this list.
+*/
+var FIRED_DESCRIPTIONS = {
+	deviceId: "the device that fired",
+	eventType: "the event, as the device names it",
+	sourceId: "the part of the device that fired (a button), empty when it names none",
+	eventKind: "the kind of press (press, long-press …), empty when the device declares none"
+};
 function describe$1(descriptions) {
 	return Object.entries(descriptions).map(([name, description]) => ({
 		name,
@@ -45190,12 +45275,74 @@ function describe$1(descriptions) {
 }
 describe$1(DETECTION_DESCRIPTIONS);
 describe$1(STATIONARY_DESCRIPTIONS);
+describe$1(FIRED_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "firedDeviceId"
+} : v);
 describe$1(BECOMES_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
 	...v,
 	hintKey: "becomesDeviceId"
 } : v);
 new Set(Object.values(COCO_TO_MACRO.mapping));
 /**
+* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
+* device. Carries the device's EXACT declared event vocabulary verbatim
+* (NO normalization). Two shapes:
+*  - structured source (HA `event.*` entity) → `vocabulary` is the fixed
+*    declared set (e.g. press_short, press_long, …).
+*  - generic/legacy source (HA bus events, e.g. zha_event) → `vocabulary`
+*    is [] (open) and `lastEvent.data` carries the complex payload.
+* `vocabulary` (D1044) names each event for a person and types it for a
+* rule; `eventTypes` is its list of native tokens, kept for older readers.
+* A fire names the part of the device it came from in `sourceId` when the
+* vocabulary declares sources (a remote's buttons).
+* `seq` is monotonic so two identical events still produce distinct slice writes.
+*/
+var EventFireSchema = object({
+	deviceId: number$1(),
+	eventType: string(),
+	sourceId: string().optional(),
+	data: record(string(), unknown()).nullable(),
+	timestamp: number$1().meta(readingMeta("none")),
+	seq: number$1().meta(readingMeta("count"))
+});
+var EventEmitterStatusSchema = object({
+	eventTypes: array(string()),
+	/**
+	* Required of a provider by the type. A status written before the field
+	* existed still parses, as an empty vocabulary: read it through
+	* `readEventVocabulary`, which then answers with the plain tokens.
+	*/
+	vocabulary: array(EventVocabularyEntrySchema).default([]),
+	lastEvent: EventFireSchema.nullable(),
+	eventCountSinceStart: number$1().meta(readingMeta("count"))
+});
+var eventEmitterCapability = {
+	name: "event-emitter",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.EventEmitter],
+	methods: {},
+	events: { onEvent: { data: EventFireSchema } },
+	status: {
+		schema: EventEmitterStatusSchema,
+		kind: "push"
+	},
+	runtimeState: EventEmitterStatusSchema,
+	/**
+	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	/**
+	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
+	*/
+	history: "none"
+};
+/**
 * Schedulers (D983) — an entity that performs actions over the day.
 *
 * A scheduler has profiles; a profile has weekdays and a timeline of POINTS.
@@ -45453,6 +45600,7 @@ var AutomationConditionTraceNodeSchema = object({
 		"triggered-by",
 		"device-becomes",
 		"device-event",
+		"device-fired",
 		"schedule",
 		"interval",
 		"manual",
@@ -56661,109 +56809,6 @@ var enumSensorCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastFetchedAt", "timestamp"]
 };
-var EventVocabularyKindSchema = _enum([
-	"press",
-	"long-press",
-	"long-press-start",
-	"release",
-	"repeat",
-	"double-press",
-	"other"
-]);
-/** The part of the device an event comes from: a button, a channel. */
-var EventVocabularySourceSchema = object({
-	id: string().min(1),
-	label: string().min(1)
-});
-/** One scalar field of an event's `data`, by dotted path. */
-var EventVocabularyFieldSchema = object({
-	path: string().min(1),
-	kind: _enum([
-		"string",
-		"number",
-		"boolean",
-		"enum"
-	]),
-	enumValues: array(string()).optional(),
-	label: string().min(1).optional()
-});
-var EventVocabularyEntrySchema = object({
-	/** The native token, verbatim. */
-	id: string().min(1),
-	source: EventVocabularySourceSchema.optional(),
-	label: string().min(1),
-	description: string().optional(),
-	kind: EventVocabularyKindSchema.optional(),
-	payload: array(EventVocabularyFieldSchema).optional()
-});
-/**
-* The vocabulary of a source that declares tokens and nothing else: one
-* entry per token, labelled with the token itself.
-*/
-function plainEventVocabulary(eventTypes) {
-	return [...new Set(eventTypes)].filter((eventType) => eventType !== "").map((eventType) => ({
-		id: eventType,
-		label: eventType
-	}));
-}
-/**
-* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
-* device. Carries the device's EXACT declared event vocabulary verbatim
-* (NO normalization). Two shapes:
-*  - structured source (HA `event.*` entity) → `vocabulary` is the fixed
-*    declared set (e.g. press_short, press_long, …).
-*  - generic/legacy source (HA bus events, e.g. zha_event) → `vocabulary`
-*    is [] (open) and `lastEvent.data` carries the complex payload.
-* `vocabulary` (D1044) names each event for a person and types it for a
-* rule; `eventTypes` is its list of native tokens, kept for older readers.
-* A fire names the part of the device it came from in `sourceId` when the
-* vocabulary declares sources (a remote's buttons).
-* `seq` is monotonic so two identical events still produce distinct slice writes.
-*/
-var EventFireSchema = object({
-	deviceId: number$1(),
-	eventType: string(),
-	sourceId: string().optional(),
-	data: record(string(), unknown()).nullable(),
-	timestamp: number$1().meta(readingMeta("none")),
-	seq: number$1().meta(readingMeta("count"))
-});
-var EventEmitterStatusSchema = object({
-	eventTypes: array(string()),
-	/**
-	* Required of a provider by the type. A status written before the field
-	* existed still parses, as an empty vocabulary: read it through
-	* `readEventVocabulary`, which then answers with the plain tokens.
-	*/
-	vocabulary: array(EventVocabularyEntrySchema).default([]),
-	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number$1().meta(readingMeta("count"))
-});
-var eventEmitterCapability = {
-	name: "event-emitter",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.EventEmitter],
-	methods: {},
-	events: { onEvent: { data: EventFireSchema } },
-	status: {
-		schema: EventEmitterStatusSchema,
-		kind: "push"
-	},
-	runtimeState: EventEmitterStatusSchema,
-	/**
-	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	/**
-	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
-	*/
-	history: "none"
-};
 var IdentitySchema = object({
 	id: string(),
 	name: string(),
@@ -59366,6 +59411,12 @@ var IntegrationLiteSchema = object({
 var AvailableIntegrationTypeSchema = object({
 	addonId: string(),
 	name: string(),
+	/**
+	* Product name a new integration is prefilled from (`<label> - Home`).
+	* Absent: the client uses `name`. Set when the catalog title is not the
+	* product (Bosch SHC, MQTT).
+	*/
+	providerLabel: string().optional(),
 	description: string(),
 	iconUrl: string().nullable(),
 	color: string(),
@@ -103091,6 +103142,38 @@ function ingestReading(input) {
 		value: converted
 	};
 }
+/**
+* Names chosen when an integration or a Gateway device is created.
+* A stored name is never rewritten from these helpers.
+*/
+var HOME_SUFFIX = "Home";
+function collapse(value) {
+	return value.trim().replace(/\s+/g, " ");
+}
+/** "KLF-200" → "KLF200". A hyphen between words ("Home Hub") stays. */
+function compactModelToken(value) {
+	return value.replace(/([A-Za-z])-(\d)/g, "$1$2");
+}
+/** Prefill for a new integration: "<provider> - Home". The operator can edit it. */
+function defaultIntegrationName(providerLabel) {
+	const label = collapse(providerLabel);
+	if (label.length === 0) return HOME_SUFFIX;
+	return `${label} - ${HOME_SUFFIX}`;
+}
+/**
+* A Gateway device: "<Brand> <Model>". An unknown model is the brand alone
+* (the caller passes the brand-level fallback it already has, e.g. "Velux KLF-200").
+*/
+function gatewayDeviceName(brand, model) {
+	const brandPart = compactModelToken(collapse(brand));
+	const raw = collapse(model ?? "");
+	if (raw.length === 0) return brandPart;
+	const modelPart = compactModelToken(raw);
+	const prefix = `${brandPart.toLowerCase()} `;
+	if (modelPart.toLowerCase() === brandPart.toLowerCase()) return brandPart;
+	if (modelPart.toLowerCase().startsWith(prefix)) return modelPart;
+	return `${brandPart} ${modelPart}`;
+}
 String.raw`(?<=^|["'(\s>,\[{])`;
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
@@ -103199,4 +103282,4 @@ function keepBodyKeys(provider, keys) {
 	};
 }
 //#endregion
-export { DeviceType as $, temperatureSensorCapability as A, rowsDepsOver as B, plainEventVocabulary as C, runningFromDishwasherOperation as D, registerPowerSwitch as E, defineCustomActions as F, literal as G, _null as H, defineEntryKind as I, record as J, number$1 as K, entryBody as L, RecordIntegrationInstances as M, createEvent as N, runningStateCapability as O, customAction as P, DeviceRole as Q, isSecretMarker as R, numericSensorCapability as S, quantityFromUnit as T, array as U, _enum as V, boolean as W, union as X, string as Y, unknown as Z, heatPumpControlCapability as _, BaseDevice as a, ingestReading as b, RUNNING_STATE_COLD as c, climateControlCapability as d, errMsg as et, consumablesCapability as f, eventEmitterCapability as g, enumSensorCapability as h, testBoschInstance as i, waterHeaterCapability as j, switchCapability as k, batteryCapability as l, dishwasherCapability as m, boschRowsPorts as n, BaseDeviceProvider as o, deviceAdoptionCapability as p, object as q, keepBodyKeys as r, DishwasherOperationStateSchema as s, boschRowsMigration as t, EventCategory as tt, binaryCapability as u, heatPumpStatusCapability as v, powerMeterCapability as w, integrationInstancesCapability as x, heatingValveCapability as y, isSecretMarkerLike as z };
+export { unknown as $, runningStateCapability as A, isSecretMarker as B, integrationInstancesCapability as C, quantityFromUnit as D, powerMeterCapability as E, createEvent as F, array as G, rowsDepsOver as H, customAction as I, number$1 as J, boolean as K, defineCustomActions as L, temperatureSensorCapability as M, waterHeaterCapability as N, registerPowerSwitch as O, RecordIntegrationInstances as P, union as Q, defineEntryKind as R, ingestReading as S, plainEventVocabulary as T, _enum as U, isSecretMarkerLike as V, _null as W, record as X, object as Y, string as Z, eventEmitterCapability as _, BaseDevice as a, heatPumpStatusCapability as b, RUNNING_STATE_COLD as c, climateControlCapability as d, DeviceRole as et, consumablesCapability as f, enumSensorCapability as g, dishwasherCapability as h, testBoschInstance as i, switchCapability as j, runningFromDishwasherOperation as k, batteryCapability as l, deviceAdoptionCapability as m, boschRowsPorts as n, errMsg as nt, BaseDeviceProvider as o, defaultIntegrationName as p, literal as q, keepBodyKeys as r, EventCategory as rt, DishwasherOperationStateSchema as s, boschRowsMigration as t, DeviceType as tt, binaryCapability as u, gatewayDeviceName as v, numericSensorCapability as w, heatingValveCapability as x, heatPumpControlCapability as y, entryBody as z };

package/dist/{bosch-instances-dqTG9no9.js → bosch-instances-DkTzZrlR.js}

@@ -44097,6 +44097,51 @@ function macroOnly(macro) {
 		};
 	}
 }
+var EventVocabularyKindSchema = _enum([
+	"press",
+	"long-press",
+	"long-press-start",
+	"release",
+	"repeat",
+	"double-press",
+	"other"
+]);
+/** The part of the device an event comes from: a button, a channel. */
+var EventVocabularySourceSchema = object({
+	id: string().min(1),
+	label: string().min(1)
+});
+/** One scalar field of an event's `data`, by dotted path. */
+var EventVocabularyFieldSchema = object({
+	path: string().min(1),
+	kind: _enum([
+		"string",
+		"number",
+		"boolean",
+		"enum"
+	]),
+	enumValues: array(string()).optional(),
+	label: string().min(1).optional()
+});
+var EventVocabularyEntrySchema = object({
+	/** The native token, verbatim. */
+	id: string().min(1),
+	source: EventVocabularySourceSchema.optional(),
+	label: string().min(1),
+	description: string().optional(),
+	kind: EventVocabularyKindSchema.optional(),
+	payload: array(EventVocabularyFieldSchema).optional()
+});
+/**
+* The vocabulary of a source that declares tokens and nothing else: one
+* entry per token, labelled with the token itself.
+*/
+function plainEventVocabulary(eventTypes) {
+	return [...new Set(eventTypes)].filter((eventType) => eventType !== "").map((eventType) => ({
+		id: eventType,
+		label: eventType
+	}));
+}
 Math.PI / 180;
 /**
 * WHEN something happens, as data (D983) — the one time vocabulary of the
@@ -44304,6 +44349,33 @@ var ScheduleLeafSchema = object({
 	/** @deprecated legacy cron — new schedules use `at`. */
 	cron: string().min(1).max(120).optional()
 }).refine((leaf) => leaf.at === void 0 !== (leaf.cron === void 0), { message: "a schedule names exactly one of `at` (a time spec) and `cron` (legacy)" }).refine((leaf) => leaf.days === void 0 || leaf.at !== void 0, { message: "`days` goes with `at`; a cron expression carries its own days" });
+/**
+* One payload predicate of a `device-fired` row: the value at `path` inside
+* the fire's `data` (dotted) equals `equals`. Compared strictly, no coercion.
+*/
+var DeviceFiredMatchSchema = object({
+	path: string().min(1).max(120),
+	equals: union([
+		string(),
+		number$1(),
+		boolean()
+	])
+});
+/**
+* "fires": one device of the `event-emitter` capability reported an event
+* (D1045). Every list is an OR, the lists together an AND; an absent list does
+* not narrow. `eventIds` are the device's own tokens, `sourceIds` the parts of
+* the device (a button), `kinds` the shared press kinds of its vocabulary.
+*/
+var DeviceFiredLeafSchema = object({
+	kind: literal("device-fired"),
+	...eventLeafId,
+	deviceId: number$1().int().nonnegative(),
+	eventIds: array(string().min(1)).min(1).max(64).optional(),
+	sourceIds: array(string().min(1)).min(1).max(64).optional(),
+	kinds: array(EventVocabularyKindSchema).min(1).optional(),
+	match: array(DeviceFiredMatchSchema).min(1).max(8).optional()
+});
 var ManualLeafSchema = object({
 	kind: literal("manual"),
 	...eventLeafId
@@ -44445,6 +44517,7 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 	}),
 	DeviceBecomesLeafSchema,
 	DeviceEventLeafSchema,
+	DeviceFiredLeafSchema,
 	ScheduleLeafSchema,
 	ManualLeafSchema,
 	IntervalLeafSchema,
@@ -44459,6 +44532,7 @@ var AutomationWhenSchema = lazy(() => discriminatedUnion("kind", [
 var EVENT_KINDS = new Set([
 	"device-becomes",
 	"device-event",
+	"device-fired",
 	"schedule",
 	"manual",
 	"interval",
@@ -44539,6 +44613,7 @@ function hasEmptyContainer(node) {
 var LEAF_WORDS = {
 	"device-becomes": "a device value that becomes",
 	"device-event": "a device event",
+	"device-fired": "a device firing an event",
 	schedule: "a schedule",
 	manual: "a manual run",
 	interval: "an interval",
@@ -45182,6 +45257,16 @@ var BECOMES_DESCRIPTIONS = {
 	from: "the value before the change, empty when it is not known",
 	to: "the value it changed to"
 };
+/**
+* A fire's payload is offered too, as `data.<path>` (`{{vars.data.channel}}`):
+* those names depend on the device, so they are not in this list.
+*/
+var FIRED_DESCRIPTIONS = {
+	deviceId: "the device that fired",
+	eventType: "the event, as the device names it",
+	sourceId: "the part of the device that fired (a button), empty when it names none",
+	eventKind: "the kind of press (press, long-press …), empty when the device declares none"
+};
 function describe$1(descriptions) {
 	return Object.entries(descriptions).map(([name, description]) => ({
 		name,
@@ -45190,12 +45275,74 @@ function describe$1(descriptions) {
 }
 describe$1(DETECTION_DESCRIPTIONS);
 describe$1(STATIONARY_DESCRIPTIONS);
+describe$1(FIRED_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
+	...v,
+	hintKey: "firedDeviceId"
+} : v);
 describe$1(BECOMES_DESCRIPTIONS).map((v) => v.name === "deviceId" ? {
 	...v,
 	hintKey: "becomesDeviceId"
 } : v);
 new Set(Object.values(COCO_TO_MACRO.mapping));
 /**
+* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
+* device. Carries the device's EXACT declared event vocabulary verbatim
+* (NO normalization). Two shapes:
+*  - structured source (HA `event.*` entity) → `vocabulary` is the fixed
+*    declared set (e.g. press_short, press_long, …).
+*  - generic/legacy source (HA bus events, e.g. zha_event) → `vocabulary`
+*    is [] (open) and `lastEvent.data` carries the complex payload.
+* `vocabulary` (D1044) names each event for a person and types it for a
+* rule; `eventTypes` is its list of native tokens, kept for older readers.
+* A fire names the part of the device it came from in `sourceId` when the
+* vocabulary declares sources (a remote's buttons).
+* `seq` is monotonic so two identical events still produce distinct slice writes.
+*/
+var EventFireSchema = object({
+	deviceId: number$1(),
+	eventType: string(),
+	sourceId: string().optional(),
+	data: record(string(), unknown()).nullable(),
+	timestamp: number$1().meta(readingMeta("none")),
+	seq: number$1().meta(readingMeta("count"))
+});
+var EventEmitterStatusSchema = object({
+	eventTypes: array(string()),
+	/**
+	* Required of a provider by the type. A status written before the field
+	* existed still parses, as an empty vocabulary: read it through
+	* `readEventVocabulary`, which then answers with the plain tokens.
+	*/
+	vocabulary: array(EventVocabularyEntrySchema).default([]),
+	lastEvent: EventFireSchema.nullable(),
+	eventCountSinceStart: number$1().meta(readingMeta("count"))
+});
+var eventEmitterCapability = {
+	name: "event-emitter",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [DeviceType.EventEmitter],
+	methods: {},
+	events: { onEvent: { data: EventFireSchema } },
+	status: {
+		schema: EventEmitterStatusSchema,
+		kind: "push"
+	},
+	runtimeState: EventEmitterStatusSchema,
+	/**
+	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
+	*
+	* See `RuntimeStateDurability`. Enforced by
+	* `scripts/check-runtime-state-durability.ts`.
+	*/
+	durability: "session",
+	/**
+	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
+	*/
+	history: "none"
+};
+/**
 * Schedulers (D983) — an entity that performs actions over the day.
 *
 * A scheduler has profiles; a profile has weekdays and a timeline of POINTS.
@@ -45453,6 +45600,7 @@ var AutomationConditionTraceNodeSchema = object({
 		"triggered-by",
 		"device-becomes",
 		"device-event",
+		"device-fired",
 		"schedule",
 		"interval",
 		"manual",
@@ -56661,109 +56809,6 @@ var enumSensorCapability = {
 	*  whether persisting is worth a SQLite commit. */
 	volatileStateFields: ["lastFetchedAt", "timestamp"]
 };
-var EventVocabularyKindSchema = _enum([
-	"press",
-	"long-press",
-	"long-press-start",
-	"release",
-	"repeat",
-	"double-press",
-	"other"
-]);
-/** The part of the device an event comes from: a button, a channel. */
-var EventVocabularySourceSchema = object({
-	id: string().min(1),
-	label: string().min(1)
-});
-/** One scalar field of an event's `data`, by dotted path. */
-var EventVocabularyFieldSchema = object({
-	path: string().min(1),
-	kind: _enum([
-		"string",
-		"number",
-		"boolean",
-		"enum"
-	]),
-	enumValues: array(string()).optional(),
-	label: string().min(1).optional()
-});
-var EventVocabularyEntrySchema = object({
-	/** The native token, verbatim. */
-	id: string().min(1),
-	source: EventVocabularySourceSchema.optional(),
-	label: string().min(1),
-	description: string().optional(),
-	kind: EventVocabularyKindSchema.optional(),
-	payload: array(EventVocabularyFieldSchema).optional()
-});
-/**
-* The vocabulary of a source that declares tokens and nothing else: one
-* entry per token, labelled with the token itself.
-*/
-function plainEventVocabulary(eventTypes) {
-	return [...new Set(eventTypes)].filter((eventType) => eventType !== "").map((eventType) => ({
-		id: eventType,
-		label: eventType
-	}));
-}
-/**
-* Generic stateless event emitter. Installed on a `DeviceType.EventEmitter`
-* device. Carries the device's EXACT declared event vocabulary verbatim
-* (NO normalization). Two shapes:
-*  - structured source (HA `event.*` entity) → `vocabulary` is the fixed
-*    declared set (e.g. press_short, press_long, …).
-*  - generic/legacy source (HA bus events, e.g. zha_event) → `vocabulary`
-*    is [] (open) and `lastEvent.data` carries the complex payload.
-* `vocabulary` (D1044) names each event for a person and types it for a
-* rule; `eventTypes` is its list of native tokens, kept for older readers.
-* A fire names the part of the device it came from in `sourceId` when the
-* vocabulary declares sources (a remote's buttons).
-* `seq` is monotonic so two identical events still produce distinct slice writes.
-*/
-var EventFireSchema = object({
-	deviceId: number$1(),
-	eventType: string(),
-	sourceId: string().optional(),
-	data: record(string(), unknown()).nullable(),
-	timestamp: number$1().meta(readingMeta("none")),
-	seq: number$1().meta(readingMeta("count"))
-});
-var EventEmitterStatusSchema = object({
-	eventTypes: array(string()),
-	/**
-	* Required of a provider by the type. A status written before the field
-	* existed still parses, as an empty vocabulary: read it through
-	* `readEventVocabulary`, which then answers with the plain tokens.
-	*/
-	vocabulary: array(EventVocabularyEntrySchema).default([]),
-	lastEvent: EventFireSchema.nullable(),
-	eventCountSinceStart: number$1().meta(readingMeta("count"))
-});
-var eventEmitterCapability = {
-	name: "event-emitter",
-	scope: "device",
-	deviceNative: true,
-	mode: "singleton",
-	deviceTypes: [DeviceType.EventEmitter],
-	methods: {},
-	events: { onEvent: { data: EventFireSchema } },
-	status: {
-		schema: EventEmitterStatusSchema,
-		kind: "push"
-	},
-	runtimeState: EventEmitterStatusSchema,
-	/**
-	* Runtime-state durability: **session** — `eventCountSinceStart` names its own scope.
-	*
-	* See `RuntimeStateDurability`. Enforced by
-	* `scripts/check-runtime-state-durability.ts`.
-	*/
-	durability: "session",
-	/**
-	* History (D850): none — `eventCountSinceStart` resets with the addon; events live in ledgers.
-	*/
-	history: "none"
-};
 var IdentitySchema = object({
 	id: string(),
 	name: string(),
@@ -59366,6 +59411,12 @@ var IntegrationLiteSchema = object({
 var AvailableIntegrationTypeSchema = object({
 	addonId: string(),
 	name: string(),
+	/**
+	* Product name a new integration is prefilled from (`<label> - Home`).
+	* Absent: the client uses `name`. Set when the catalog title is not the
+	* product (Bosch SHC, MQTT).
+	*/
+	providerLabel: string().optional(),
 	description: string(),
 	iconUrl: string().nullable(),
 	color: string(),
@@ -103091,6 +103142,38 @@ function ingestReading(input) {
 		value: converted
 	};
 }
+/**
+* Names chosen when an integration or a Gateway device is created.
+* A stored name is never rewritten from these helpers.
+*/
+var HOME_SUFFIX = "Home";
+function collapse(value) {
+	return value.trim().replace(/\s+/g, " ");
+}
+/** "KLF-200" → "KLF200". A hyphen between words ("Home Hub") stays. */
+function compactModelToken(value) {
+	return value.replace(/([A-Za-z])-(\d)/g, "$1$2");
+}
+/** Prefill for a new integration: "<provider> - Home". The operator can edit it. */
+function defaultIntegrationName(providerLabel) {
+	const label = collapse(providerLabel);
+	if (label.length === 0) return HOME_SUFFIX;
+	return `${label} - ${HOME_SUFFIX}`;
+}
+/**
+* A Gateway device: "<Brand> <Model>". An unknown model is the brand alone
+* (the caller passes the brand-level fallback it already has, e.g. "Velux KLF-200").
+*/
+function gatewayDeviceName(brand, model) {
+	const brandPart = compactModelToken(collapse(brand));
+	const raw = collapse(model ?? "");
+	if (raw.length === 0) return brandPart;
+	const modelPart = compactModelToken(raw);
+	const prefix = `${brandPart.toLowerCase()} `;
+	if (modelPart.toLowerCase() === brandPart.toLowerCase()) return brandPart;
+	if (modelPart.toLowerCase().startsWith(prefix)) return modelPart;
+	return `${brandPart} ${modelPart}`;
+}
 String.raw`(?<=^|["'(\s>,\[{])`;
 var MB = 1024 * 1024;
 1024 * MB, 3072 * MB;
@@ -103319,6 +103402,12 @@ Object.defineProperty(exports, "customAction", {
 		return customAction;
 	}
 });
+Object.defineProperty(exports, "defaultIntegrationName", {
+	enumerable: true,
+	get: function() {
+		return defaultIntegrationName;
+	}
+});
 Object.defineProperty(exports, "defineCustomActions", {
 	enumerable: true,
 	get: function() {
@@ -103367,6 +103456,12 @@ Object.defineProperty(exports, "eventEmitterCapability", {
 		return eventEmitterCapability;
 	}
 });
+Object.defineProperty(exports, "gatewayDeviceName", {
+	enumerable: true,
+	get: function() {
+		return gatewayDeviceName;
+	}
+});
 Object.defineProperty(exports, "heatPumpControlCapability", {
 	enumerable: true,
 	get: function() {

package/dist/home-connect/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_bosch_instances = require("../bosch-instances-dqTG9no9.js");
-const require_account_integration_offline = require("../account-integration-offline-C-KJYRdX.js");
+const require_bosch_instances = require("../bosch-instances-DkTzZrlR.js");
+const require_account_integration_offline = require("../account-integration-offline-DK6CYsvB.js");
 let node_crypto = require("node:crypto");
 let node_tls = require("node:tls");
 let node_zlib = require("node:zlib");

package/dist/home-connect/addon.mjs

@@ -1,5 +1,5 @@
-import { $ as DeviceType, B as rowsDepsOver, C as plainEventVocabulary, D as runningFromDishwasherOperation, F as defineCustomActions, G as literal, I as defineEntryKind, J as record, L as entryBody, M as RecordIntegrationInstances, N as createEvent, O as runningStateCapability, P as customAction, Q as DeviceRole, R as isSecretMarker, S as numericSensorCapability, T as quantityFromUnit, U as array, V as _enum, X as union, Y as string, Z as unknown, a as BaseDevice, b as ingestReading, c as RUNNING_STATE_COLD, et as errMsg, f as consumablesCapability, g as eventEmitterCapability, h as enumSensorCapability, i as testBoschInstance, m as dishwasherCapability, n as boschRowsPorts, o as BaseDeviceProvider, p as deviceAdoptionCapability, q as object, r as keepBodyKeys, s as DishwasherOperationStateSchema, t as boschRowsMigration, tt as EventCategory, u as binaryCapability, w as powerMeterCapability, x as integrationInstancesCapability, z as isSecretMarkerLike } from "../bosch-instances-y_A00js_.mjs";
-import { a as loginFailureForAttempt, c as HOME_CONNECT_REDIRECT_URI, i as createSignInAttemptStore, n as cascadeRemoveDevicesForIntegration, o as parseOAuthCallback, r as buildSignInGuideFields, t as setIntegrationDevicesOnline } from "../account-integration-offline-KQcJ_VVK.mjs";
+import { $ as unknown, A as runningStateCapability, B as isSecretMarker, C as integrationInstancesCapability, D as quantityFromUnit, E as powerMeterCapability, F as createEvent, G as array, H as rowsDepsOver, I as customAction, L as defineCustomActions, P as RecordIntegrationInstances, Q as union, R as defineEntryKind, S as ingestReading, T as plainEventVocabulary, U as _enum, V as isSecretMarkerLike, X as record, Y as object, Z as string, _ as eventEmitterCapability, a as BaseDevice, c as RUNNING_STATE_COLD, et as DeviceRole, f as consumablesCapability, g as enumSensorCapability, h as dishwasherCapability, i as testBoschInstance, k as runningFromDishwasherOperation, m as deviceAdoptionCapability, n as boschRowsPorts, nt as errMsg, o as BaseDeviceProvider, q as literal, r as keepBodyKeys, rt as EventCategory, s as DishwasherOperationStateSchema, t as boschRowsMigration, tt as DeviceType, u as binaryCapability, w as numericSensorCapability, z as entryBody } from "../bosch-instances-DMzZSMxW.mjs";
+import { a as loginFailureForAttempt, c as HOME_CONNECT_REDIRECT_URI, i as createSignInAttemptStore, n as cascadeRemoveDevicesForIntegration, o as parseOAuthCallback, r as buildSignInGuideFields, t as setIntegrationDevicesOnline } from "../account-integration-offline-C9glrBvy.mjs";
 import { createHash, randomBytes } from "node:crypto";
 import { connect } from "node:tls";
 import { inflateRawSync } from "node:zlib";

package/dist/homecom/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_bosch_instances = require("../bosch-instances-dqTG9no9.js");
-const require_account_integration_offline = require("../account-integration-offline-C-KJYRdX.js");
+const require_bosch_instances = require("../bosch-instances-DkTzZrlR.js");
+const require_account_integration_offline = require("../account-integration-offline-DK6CYsvB.js");
 let node_crypto = require("node:crypto");
 let node_child_process = require("node:child_process");
 let node_fs = require("node:fs");
@@ -2471,7 +2471,7 @@ var HOMECOM_GATEWAY_NATIVE_ID = "gateway:0";
 function gatewayDiscoverable(snapshot) {
 	return {
 		nativeId: HOMECOM_GATEWAY_NATIVE_ID,
-		name: snapshot.gateway.name.length > 0 ? snapshot.gateway.name : "HomeCom gateway",
+		name: require_bosch_instances.gatewayDeviceName("Bosch HomeCom", snapshot.deviceType),
 		kind: "gateway"
 	};
 }

package/dist/homecom/addon.mjs

@@ -1,5 +1,5 @@
-import { $ as DeviceType, B as rowsDepsOver, E as registerPowerSwitch, F as defineCustomActions, G as literal, H as _null, I as defineEntryKind, J as record, K as number, L as entryBody, M as RecordIntegrationInstances, P as customAction, Q as DeviceRole, U as array, V as _enum, W as boolean, X as union, Y as string, _ as heatPumpControlCapability, a as BaseDevice, d as climateControlCapability, et as errMsg, i as testBoschInstance, j as waterHeaterCapability, n as boschRowsPorts, o as BaseDeviceProvider, p as deviceAdoptionCapability, q as object, r as keepBodyKeys, t as boschRowsMigration, tt as EventCategory, v as heatPumpStatusCapability, x as integrationInstancesCapability } from "../bosch-instances-y_A00js_.mjs";
-import { a as loginFailureForAttempt, i as createSignInAttemptStore, n as cascadeRemoveDevicesForIntegration, o as parseOAuthCallback, r as buildSignInGuideFields, s as HOMECOM_REDIRECT_URI, t as setIntegrationDevicesOnline } from "../account-integration-offline-KQcJ_VVK.mjs";
+import { C as integrationInstancesCapability, G as array, H as rowsDepsOver, I as customAction, J as number, K as boolean, L as defineCustomActions, N as waterHeaterCapability, O as registerPowerSwitch, P as RecordIntegrationInstances, Q as union, R as defineEntryKind, U as _enum, W as _null, X as record, Y as object, Z as string, a as BaseDevice, b as heatPumpStatusCapability, d as climateControlCapability, et as DeviceRole, i as testBoschInstance, m as deviceAdoptionCapability, n as boschRowsPorts, nt as errMsg, o as BaseDeviceProvider, q as literal, r as keepBodyKeys, rt as EventCategory, t as boschRowsMigration, tt as DeviceType, v as gatewayDeviceName, y as heatPumpControlCapability, z as entryBody } from "../bosch-instances-DMzZSMxW.mjs";
+import { a as loginFailureForAttempt, i as createSignInAttemptStore, n as cascadeRemoveDevicesForIntegration, o as parseOAuthCallback, r as buildSignInGuideFields, s as HOMECOM_REDIRECT_URI, t as setIntegrationDevicesOnline } from "../account-integration-offline-C9glrBvy.mjs";
 import { createHash, randomBytes } from "node:crypto";
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
@@ -2470,7 +2470,7 @@ var HOMECOM_GATEWAY_NATIVE_ID = "gateway:0";
 function gatewayDiscoverable(snapshot) {
 	return {
 		nativeId: HOMECOM_GATEWAY_NATIVE_ID,
-		name: snapshot.gateway.name.length > 0 ? snapshot.gateway.name : "HomeCom gateway",
+		name: gatewayDeviceName("Bosch HomeCom", snapshot.deviceType),
 		kind: "gateway"
 	};
 }

package/dist/shc/addon.js

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region \0rolldown/runtime.js
 var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 //#endregion
-const require_bosch_instances = require("../bosch-instances-dqTG9no9.js");
+const require_bosch_instances = require("../bosch-instances-DkTzZrlR.js");
 let node_crypto = require("node:crypto");
 let node_https = require("node:https");
 let node_child_process = require("node:child_process");
@@ -638,7 +638,7 @@ function shcDiscoveryCandidates(proposals) {
 	return proposals.map((found) => ({
 		stableId: `bosch-shc:${found.id}`,
 		type: require_bosch_instances.DeviceType.Gateway,
-		suggestedName: found.name,
+		suggestedName: require_bosch_instances.defaultIntegrationName("Bosch SHC"),
 		prefilledConfig: { host: found.host },
 		setupIntegration: true
 	}));
@@ -895,7 +895,7 @@ function buildShcCandidates(input) {
 	const gatewayAdopted = input.adopted.get(gatewayId) ?? null;
 	const out = [{
 		childNativeId: gatewayId,
-		name: input.integrationName,
+		name: require_bosch_instances.gatewayDeviceName("Bosch", "SHC"),
 		type: require_bosch_instances.DeviceType.Gateway,
 		status: "online",
 		metadata: {
@@ -1376,7 +1376,7 @@ function buildShcAdoptionProvider(deps) {
 			let failures = 0;
 			for (const shcDeviceId of childNativeIds) try {
 				if (shcDeviceId === shcGatewayNativeId(integrationId)) {
-					const name = perCandidate?.[shcDeviceId]?.name ?? integrationName(integrationId) ?? "Bosch SHC";
+					const name = perCandidate?.[shcDeviceId]?.name ?? require_bosch_instances.gatewayDeviceName("Bosch", "SHC");
 					const { deviceId } = await adoptDevice({
 						shcDeviceId,
 						integrationId,

package/dist/shc/addon.mjs

@@ -1,4 +1,4 @@
-import { $ as DeviceType, A as temperatureSensorCapability, B as rowsDepsOver, E as registerPowerSwitch, F as defineCustomActions, G as literal, I as defineEntryKind, K as number, L as entryBody, M as RecordIntegrationInstances, P as customAction, Q as DeviceRole, U as array, V as _enum, Y as string, a as BaseDevice, d as climateControlCapability, et as errMsg, i as testBoschInstance, k as switchCapability, l as batteryCapability, n as boschRowsPorts, o as BaseDeviceProvider, p as deviceAdoptionCapability, q as object, r as keepBodyKeys, t as boschRowsMigration, tt as EventCategory, x as integrationInstancesCapability, y as heatingValveCapability } from "../bosch-instances-y_A00js_.mjs";
+import { C as integrationInstancesCapability, G as array, H as rowsDepsOver, I as customAction, J as number, L as defineCustomActions, M as temperatureSensorCapability, O as registerPowerSwitch, P as RecordIntegrationInstances, R as defineEntryKind, U as _enum, Y as object, Z as string, a as BaseDevice, d as climateControlCapability, et as DeviceRole, i as testBoschInstance, j as switchCapability, l as batteryCapability, m as deviceAdoptionCapability, n as boschRowsPorts, nt as errMsg, o as BaseDeviceProvider, p as defaultIntegrationName, q as literal, r as keepBodyKeys, rt as EventCategory, t as boschRowsMigration, tt as DeviceType, v as gatewayDeviceName, x as heatingValveCapability, z as entryBody } from "../bosch-instances-DMzZSMxW.mjs";
 import { createRequire } from "node:module";
 import { randomUUID } from "node:crypto";
 import { request } from "node:https";
@@ -639,7 +639,7 @@ function shcDiscoveryCandidates(proposals) {
 	return proposals.map((found) => ({
 		stableId: `bosch-shc:${found.id}`,
 		type: DeviceType.Gateway,
-		suggestedName: found.name,
+		suggestedName: defaultIntegrationName("Bosch SHC"),
 		prefilledConfig: { host: found.host },
 		setupIntegration: true
 	}));
@@ -896,7 +896,7 @@ function buildShcCandidates(input) {
 	const gatewayAdopted = input.adopted.get(gatewayId) ?? null;
 	const out = [{
 		childNativeId: gatewayId,
-		name: input.integrationName,
+		name: gatewayDeviceName("Bosch", "SHC"),
 		type: DeviceType.Gateway,
 		status: "online",
 		metadata: {
@@ -1377,7 +1377,7 @@ function buildShcAdoptionProvider(deps) {
 			let failures = 0;
 			for (const shcDeviceId of childNativeIds) try {
 				if (shcDeviceId === shcGatewayNativeId(integrationId)) {
-					const name = perCandidate?.[shcDeviceId]?.name ?? integrationName(integrationId) ?? "Bosch SHC";
+					const name = perCandidate?.[shcDeviceId]?.name ?? gatewayDeviceName("Bosch", "SHC");
 					const { deviceId } = await adoptDevice({
 						shcDeviceId,
 						integrationId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-bosch",
-  "version": "0.1.53",
+  "version": "0.1.54",
   "description": "Bosch smart-home device-provider addons for CamStack — SHC, Home Connect, and HomeCom cloud integrations (scaffold)",
   "keywords": [
     "camstack",
@@ -39,6 +39,7 @@
         "integrationRole": "devices",
         "category": "providers",
         "name": "Bosch Smart Home",
+        "providerLabel": "Bosch SHC",
         "version": "0.1.0",
         "description": "Adopt Bosch Smart Home Controller (SHC) devices via account onboarding — scaffold",
         "entry": "./dist/shc/addon.js",
@@ -141,7 +142,7 @@
       }
     ],
     "requires": {
-      "server": ">=1.2.842"
+      "server": ">=1.2.846"
     }
   },
   "files": [