@camstack/addon-provider-bosch 0.1.28 → 0.1.30

package/CHANGELOG.md

@@ -7,6 +7,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.30] - 2026-10-27
+
+### Changed
+
+- Home Connect and HomeCom now sign in through a page served by the hub; no more copying the redirect address out of the browser's developer tools.
+
+## [0.1.29] - 2026-10-27
+
+### Changed
+
+- The Smart Home Controller addon is shown as "Bosch Smart Home" (was "Bosch SHC").
+
+## [0.1.28] - 2026-10-27
+
 ### Added
 
-- Package README and changelog, included in the published files list.
+- Bosch: Bosch smart-home device-provider addons for CamStack — SHC, Home Connect, and HomeCom cloud integrations (scaffold).
+- Provides the addons Bosch Smart Home, Bosch Home Connect, Bosch HomeCom.

package/README.md

@@ -1,24 +1,31 @@
-# @camstack/addon-provider-bosch
+# Bosch
 
-Bosch smart-home device-provider addons for CamStack — SHC, Home Connect, and HomeCom cloud integrations (scaffold)
+Bosch smart-home device-provider addons for CamStack — SHC, Home Connect, and HomeCom cloud integrations (scaffold).
 
-## What it does
+<!-- readme:generated:start (derived from the manifest; edit outside this block) -->
 
-- **Bosch SHC** (`bosch-shc`): Adopt Bosch Smart Home Controller (SHC) devices via account onboarding — scaffold
-  - Node placement: `hub-only`.
+Package `@camstack/addon-provider-bosch` on npm.
+
+## What it provides
+
+- **Bosch Smart Home** (`bosch-shc`): Adopt Bosch Smart Home Controller (SHC) devices via account onboarding — scaffold. Category: providers.
   - Capabilities: `device-provider`, `device-adoption`, `connection-test`.
-- **Bosch Home Connect** (`bosch-home-connect`): Adopt Bosch Home Connect appliances via account onboarding — scaffold
-  - Node placement: `hub-only`.
+- **Bosch Home Connect** (`bosch-home-connect`): Adopt Bosch Home Connect appliances via account onboarding — scaffold. Category: providers.
   - Capabilities: `device-provider`, `device-adoption`, `connection-test`, `dishwasher`, `consumables`, `running-state`.
-- **Bosch HomeCom** (`bosch-homecom`): Adopt Bosch HomeCom climate and water-heating devices via account onboarding — scaffold
-  - Node placement: `hub-only`.
+- **Bosch HomeCom** (`bosch-homecom`): Adopt Bosch HomeCom climate and water-heating devices via account onboarding — scaffold. Category: providers.
   - Capabilities: `device-provider`, `device-adoption`, `connection-test`, `climate-control`, `water-heater`.
 
-## Settings
+## Requirements
 
-Settings this addon exposes are edited from System → Addons → this addon → Settings when they apply to the whole cluster, and from the device page when they belong to one device. A password field is stored in the keychain.
+- Placement: hub-only.
+- A CamStack hub. An agent is used only where the placement above allows it.
 
-## Requirements
+## Documentation
+
+- [docs/addons/addon-provider-bosch-homecom.md](https://github.com/camstack/server/blob/main/docs/addons/addon-provider-bosch-homecom.md)
+- [docs/addons/addon-provider-bosch-home-connect.md](https://github.com/camstack/server/blob/main/docs/addons/addon-provider-bosch-home-connect.md)
+- [docs/architecture/device-model.md](https://github.com/camstack/server/blob/main/docs/architecture/device-model.md)
 
-- A CamStack hub. An agent is used only when the placement above allows it.
+See [CHANGELOG.md](./CHANGELOG.md) for what changed in each version.
 
+<!-- readme:generated:end -->

package/dist/{account-integration-offline-2MI94wOE.js → account-integration-offline-BMoYdiX2.js}

@@ -1,4 +1,4 @@
-const require_dist = require("./dist-DEZDBpGW.js");
+const require_dist = require("./dist-BioIJ3NA.js");
 let node_crypto = require("node:crypto");
 //#region src/shared/oauth-callback.ts
 /** A code on its own: no scheme, no query, no separators. */
@@ -118,6 +118,119 @@ function loginFailureForAttempt(reason) {
 	return reason === "expired" ? "code-rejected" : "state-mismatch";
 }
 //#endregion
+//#region src/shared/login-proxy-sign-in.ts
+function createSignInClaims(ttlMs = SIGN_IN_ATTEMPT_TTL_MS) {
+	const parked = /* @__PURE__ */ new Map();
+	return {
+		settle(attemptId, outcome, nowMs) {
+			parked.set(attemptId, {
+				outcome,
+				expiresAtMs: nowMs + ttlMs
+			});
+		},
+		claim(attemptId, nowMs) {
+			const found = parked.get(attemptId);
+			if (found === void 0) return { state: "pending" };
+			parked.delete(attemptId);
+			if (nowMs > found.expiresAtMs) return { state: "pending" };
+			if (!found.outcome.ok) throw new Error(found.outcome.message);
+			return {
+				state: "done",
+				result: found.outcome.result
+			};
+		}
+	};
+}
+/** An `&`-escaped address inside HTML is the same address. */
+function unescapeHtml(text) {
+	return text.replace(/&/g, "&");
+}
+/**
+* Terminal condition for an app-scheme redirect: the `Location` of a response, or — when the
+* vendor's page navigates by script — the first address in its body, that starts with the app
+* scheme.
+*/
+function appSchemeTerminal(scheme) {
+	const inBody = new RegExp(`${scheme.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[^"'<>\\s\\\\]+`);
+	return (view) => {
+		if (view.location !== null && view.location.startsWith(scheme)) return {
+			kind: "done",
+			payload: view.location
+		};
+		const fromBody = view.bodyText === null ? null : inBody.exec(unescapeHtml(view.bodyText));
+		if (fromBody !== null) return {
+			kind: "done",
+			payload: fromBody[0]
+		};
+		return { kind: "continue" };
+	};
+}
+/** The result-page reason code for a sign-in failure reason (`HomeConnectLoginFailure`, …). */
+function landingReasonForLogin(reason) {
+	switch (reason) {
+		case "denied": return "access_denied";
+		case "state-mismatch":
+		case "state-missing": return "invalid_state";
+		case "empty":
+		case "no-code": return "invalid_request";
+		case "code-rejected":
+		case "rejected": return "exchange_failed";
+		case "no-refresh": return "no_refresh_token";
+		default: return "unknown";
+	}
+}
+function reasonOf(err) {
+	if (typeof err === "object" && err !== null && "reason" in err) {
+		const reason = err.reason;
+		if (typeof reason === "string") return reason;
+	}
+	return "unknown";
+}
+/**
+* Open the proxied login for one attempt and return the hub-relative path the browser opens.
+* A failed exchange is parked as an operator-facing message and the browser lands on the
+* result page with a reason code; nothing about the captured address leaves this function.
+*/
+function openSignInProxy(input) {
+	const started = input.nowMs();
+	input.proxy.open({
+		attemptId: input.attemptId,
+		expiresAtMs: started + SIGN_IN_ATTEMPT_TTL_MS,
+		upstreams: input.hosts.map((host) => ({
+			host,
+			scheme: input.scheme ?? "https"
+		})),
+		terminal: appSchemeTerminal(input.appScheme),
+		onDone: async (callback) => {
+			try {
+				const result = await input.finish(callback);
+				input.claims.settle(input.attemptId, {
+					ok: true,
+					result
+				}, input.nowMs());
+				return {
+					status: "success",
+					addonId: input.addonId
+				};
+			} catch (err) {
+				const message = err instanceof Error ? err.message : "The sign-in failed.";
+				input.claims.settle(input.attemptId, {
+					ok: false,
+					message
+				}, input.nowMs());
+				return {
+					status: "error",
+					addonId: input.addonId,
+					reason: landingReasonForLogin(reasonOf(err))
+				};
+			}
+		}
+	});
+	const entry = input.proxy.entryPath(input.attemptId, input.authorizeUrl);
+	if (entry === null) throw new Error("The sign-in page host is not reachable through the proxy.");
+	return entry;
+}
+//#endregion
 //#region src/shared/account-integration-cascade.ts
 async function cascadeRemoveDevicesForIntegration(input) {
 	const { reg, devices, addonId, system, integrationId, logger } = input;
@@ -167,12 +280,24 @@ Object.defineProperty(exports, "createSignInAttemptStore", {
 		return createSignInAttemptStore;
 	}
 });
+Object.defineProperty(exports, "createSignInClaims", {
+	enumerable: true,
+	get: function() {
+		return createSignInClaims;
+	}
+});
 Object.defineProperty(exports, "loginFailureForAttempt", {
 	enumerable: true,
 	get: function() {
 		return loginFailureForAttempt;
 	}
 });
+Object.defineProperty(exports, "openSignInProxy", {
+	enumerable: true,
+	get: function() {
+		return openSignInProxy;
+	}
+});
 Object.defineProperty(exports, "parseOAuthCallback", {
 	enumerable: true,
 	get: function() {

package/dist/{account-integration-offline-DKaazSyb.mjs → account-integration-offline-pv6cqOKu.mjs}

@@ -1,4 +1,4 @@
-import { E as errMsg } from "./dist-Cbcvh8mB.mjs";
+import { D as errMsg } from "./dist-DBUnIovD.mjs";
 import { randomBytes } from "node:crypto";
 //#region src/shared/oauth-callback.ts
 /** A code on its own: no scheme, no query, no separators. */
@@ -118,6 +118,119 @@ function loginFailureForAttempt(reason) {
 	return reason === "expired" ? "code-rejected" : "state-mismatch";
 }
 //#endregion
+//#region src/shared/login-proxy-sign-in.ts
+function createSignInClaims(ttlMs = SIGN_IN_ATTEMPT_TTL_MS) {
+	const parked = /* @__PURE__ */ new Map();
+	return {
+		settle(attemptId, outcome, nowMs) {
+			parked.set(attemptId, {
+				outcome,
+				expiresAtMs: nowMs + ttlMs
+			});
+		},
+		claim(attemptId, nowMs) {
+			const found = parked.get(attemptId);
+			if (found === void 0) return { state: "pending" };
+			parked.delete(attemptId);
+			if (nowMs > found.expiresAtMs) return { state: "pending" };
+			if (!found.outcome.ok) throw new Error(found.outcome.message);
+			return {
+				state: "done",
+				result: found.outcome.result
+			};
+		}
+	};
+}
+/** An `&`-escaped address inside HTML is the same address. */
+function unescapeHtml(text) {
+	return text.replace(/&/g, "&");
+}
+/**
+* Terminal condition for an app-scheme redirect: the `Location` of a response, or — when the
+* vendor's page navigates by script — the first address in its body, that starts with the app
+* scheme.
+*/
+function appSchemeTerminal(scheme) {
+	const inBody = new RegExp(`${scheme.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[^"'<>\\s\\\\]+`);
+	return (view) => {
+		if (view.location !== null && view.location.startsWith(scheme)) return {
+			kind: "done",
+			payload: view.location
+		};
+		const fromBody = view.bodyText === null ? null : inBody.exec(unescapeHtml(view.bodyText));
+		if (fromBody !== null) return {
+			kind: "done",
+			payload: fromBody[0]
+		};
+		return { kind: "continue" };
+	};
+}
+/** The result-page reason code for a sign-in failure reason (`HomeConnectLoginFailure`, …). */
+function landingReasonForLogin(reason) {
+	switch (reason) {
+		case "denied": return "access_denied";
+		case "state-mismatch":
+		case "state-missing": return "invalid_state";
+		case "empty":
+		case "no-code": return "invalid_request";
+		case "code-rejected":
+		case "rejected": return "exchange_failed";
+		case "no-refresh": return "no_refresh_token";
+		default: return "unknown";
+	}
+}
+function reasonOf(err) {
+	if (typeof err === "object" && err !== null && "reason" in err) {
+		const reason = err.reason;
+		if (typeof reason === "string") return reason;
+	}
+	return "unknown";
+}
+/**
+* Open the proxied login for one attempt and return the hub-relative path the browser opens.
+* A failed exchange is parked as an operator-facing message and the browser lands on the
+* result page with a reason code; nothing about the captured address leaves this function.
+*/
+function openSignInProxy(input) {
+	const started = input.nowMs();
+	input.proxy.open({
+		attemptId: input.attemptId,
+		expiresAtMs: started + SIGN_IN_ATTEMPT_TTL_MS,
+		upstreams: input.hosts.map((host) => ({
+			host,
+			scheme: input.scheme ?? "https"
+		})),
+		terminal: appSchemeTerminal(input.appScheme),
+		onDone: async (callback) => {
+			try {
+				const result = await input.finish(callback);
+				input.claims.settle(input.attemptId, {
+					ok: true,
+					result
+				}, input.nowMs());
+				return {
+					status: "success",
+					addonId: input.addonId
+				};
+			} catch (err) {
+				const message = err instanceof Error ? err.message : "The sign-in failed.";
+				input.claims.settle(input.attemptId, {
+					ok: false,
+					message
+				}, input.nowMs());
+				return {
+					status: "error",
+					addonId: input.addonId,
+					reason: landingReasonForLogin(reasonOf(err))
+				};
+			}
+		}
+	});
+	const entry = input.proxy.entryPath(input.attemptId, input.authorizeUrl);
+	if (entry === null) throw new Error("The sign-in page host is not reachable through the proxy.");
+	return entry;
+}
+//#endregion
 //#region src/shared/account-integration-cascade.ts
 async function cascadeRemoveDevicesForIntegration(input) {
 	const { reg, devices, addonId, system, integrationId, logger } = input;
@@ -155,4 +268,4 @@ function setIntegrationDevicesOnline(devices, system, integrationId, online) {
 	return count;
 }
 //#endregion
-export { parseOAuthCallback as a, loginFailureForAttempt as i, cascadeRemoveDevicesForIntegration as n, createSignInAttemptStore as r, setIntegrationDevicesOnline as t };
+export { createSignInAttemptStore as a, openSignInProxy as i, cascadeRemoveDevicesForIntegration as n, loginFailureForAttempt as o, createSignInClaims as r, parseOAuthCallback as s, setIntegrationDevicesOnline as t };