@camstack/system 1.2.414 → 1.2.416

package/dist/builtins/local-network/local-network.addon.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
-const require_tls = require("../../tls-BWpwU-d5.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
+const require_tls = require("../../tls-C0TRPfqc.js");
 let zod = require("zod");
 let node_net = require("node:net");
 let node_os = require("node:os");
@@ -337,6 +337,163 @@ function parseIpv6Groups(address) {
 	];
 }
 //#endregion
+//#region src/builtins/local-network/hub-mdns.ts
+/**
+* Hub mDNS advertisement (D838) — how `camstack login` / `camstack discover`
+* find a hub on the LAN.
+*
+* The hub publishes ONE `_camstack._tcp` service for its HTTPS endpoint. There
+* is no mesh channel in it (D826 retired mesh UDP discovery on purpose) and
+* nothing secret: the TXT record carries the node id, the version, the role
+* and the address URL — finding a hub grants nothing, every client still signs
+* in.
+*
+* The advertised address is NOT ranked here. It is the `internal` role of the
+* address book (the address flagged for LAN clients, else the automatic LAN
+* pick) — this module only reads the answer `local-network` already gives.
+*
+* The responder is injected so the logic is tested with a fake; the real one
+* wraps `@homebridge/ciao`.
+*/
+/** The announcement for the current address, or null when nothing qualifies. */
+function buildHubAnnouncement(inputs) {
+	if (inputs.internalUrl === null) return null;
+	let url;
+	try {
+		url = new URL(inputs.internalUrl);
+	} catch {
+		return null;
+	}
+	if (url.protocol !== "https:") return null;
+	const port = url.port === "" ? 443 : Number.parseInt(url.port, 10);
+	if (!Number.isInteger(port) || port < 1 || port > 65535) return null;
+	const host = url.hostname.replace(/^\[|\]$/g, "");
+	const txt = {
+		[require_dist.HUB_MDNS_TXT_KEYS.nodeId]: inputs.nodeId,
+		[require_dist.HUB_MDNS_TXT_KEYS.role]: "hub",
+		[require_dist.HUB_MDNS_TXT_KEYS.url]: url.origin
+	};
+	if (inputs.version !== null) txt[require_dist.HUB_MDNS_TXT_KEYS.version] = inputs.version;
+	return {
+		name: `camstack-${inputs.nodeId}`,
+		type: require_dist.HUB_MDNS_SERVICE_TYPE,
+		port,
+		address: (0, node_net.isIP)(host) !== 0 ? host : null,
+		txt
+	};
+}
+function announcementKey(a) {
+	return JSON.stringify([
+		a.name,
+		a.type,
+		a.port,
+		a.address,
+		a.txt
+	]);
+}
+/**
+* Keeps one mDNS service in step with the hub's `internal` address. `sync()`
+* is safe to call on any change; it never throws — a failure to advertise is
+* logged and the boot goes on.
+*/
+var HubMdnsAdvertiser = class {
+	options;
+	current = null;
+	running = false;
+	chain = Promise.resolve();
+	constructor(options) {
+		this.options = options;
+	}
+	async start() {
+		this.running = true;
+		await this.sync();
+	}
+	/** Re-read the address and re-announce when it changed. Serialised. */
+	sync() {
+		this.chain = this.chain.then(() => this.syncOnce());
+		return this.chain;
+	}
+	async stop() {
+		this.running = false;
+		await (this.chain = this.chain.then(() => this.withdraw()));
+	}
+	async syncOnce() {
+		if (!this.running) return;
+		const { logger } = this.options;
+		try {
+			const internalUrl = await this.options.readInternalUrl();
+			const next = buildHubAnnouncement({
+				nodeId: this.options.nodeId,
+				version: this.options.version,
+				internalUrl
+			});
+			if (next === null) {
+				if (this.current !== null) {
+					await this.withdraw();
+					logger.info("hub mDNS: no internal address, advertisement withdrawn");
+				}
+				return;
+			}
+			const key = announcementKey(next);
+			if (this.current?.key === key) return;
+			await this.withdraw();
+			const handle = await this.options.publisher.publish(next);
+			this.current = {
+				key,
+				handle
+			};
+			logger.info("hub mDNS: advertising _camstack._tcp", { meta: {
+				url: next.txt[require_dist.HUB_MDNS_TXT_KEYS.url],
+				port: next.port
+			} });
+		} catch (err) {
+			logger.warn("hub mDNS: could not advertise the hub (logins still work with --server)", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+	async withdraw() {
+		const held = this.current;
+		this.current = null;
+		if (held === null) return;
+		try {
+			await held.handle.stop();
+		} catch (err) {
+			this.options.logger.warn("hub mDNS: withdraw failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+};
+/**
+* The address a hub advertises: the `internal` role's answer, exactly as the
+* address book resolved it. Never re-ranked here (D729, D732).
+*/
+function internalUrlOf(book) {
+	return book.roles.internal.resolved;
+}
+//#endregion
+//#region src/builtins/local-network/hub-mdns-ciao.ts
+function createCiaoPublisher() {
+	return { async publish(announcement) {
+		const { getResponder } = await Promise.resolve().then(() => /* @__PURE__ */ require_chunk.__toESM(require("../../lib-DOJ5yyWA.js").default));
+		const responder = getResponder();
+		const service = responder.createService({
+			name: announcement.name,
+			type: announcement.type,
+			port: announcement.port,
+			txt: { ...announcement.txt },
+			...announcement.address !== null ? { restrictedAddresses: [announcement.address] } : {}
+		});
+		try {
+			await service.advertise();
+		} catch (err) {
+			await responder.shutdown().catch(() => void 0);
+			throw err;
+		}
+		return { stop: async () => {
+			await service.destroy();
+			await responder.shutdown();
+		} };
+	} };
+}
+//#endregion
 //#region src/builtins/local-network/local-hostname.ts
 var DNS_NAME = /^(?=.{1,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])$/;
 /**
@@ -419,6 +576,7 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 	* `null` when no mesh provider is joined.
 	*/
 	meshEndpoint = null;
+	mdns = null;
 	constructor() {
 		super({
 			allowedAddresses: [],
@@ -430,7 +588,8 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 			httpPort: require_tls.DEFAULT_LAN_HTTP_PORT,
 			localHostname: "",
 			internalUrl: "",
-			publicEndpointUrl: ""
+			publicEndpointUrl: "",
+			mdnsAdvertise: true
 		});
 	}
 	/**
@@ -481,6 +640,7 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 			customAddresses: changed.custom
 		}, detectedUrls);
 		await this.updateGlobalSettings(addressBookPatch(after));
+		await this.mdns?.sync();
 	}
 	/** The deprecated `getHubAddresses` shape, from the role resolvers. */
 	async snapshotHubAddresses() {
@@ -716,6 +876,7 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 		} catch (err) {
 			this.ctx.logger.warn("local-network: LAN HTTP not applied at boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		}
+		await this.applyMdnsAdvertisement();
 		return [{
 			capability: require_dist.localNetworkCapability,
 			provider
@@ -749,6 +910,14 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 						equals: true
 					}
 				}),
+				this.field({
+					type: "boolean",
+					key: "mdnsAdvertise",
+					label: "Announce this hub on the LAN (mDNS)",
+					description: "Lets `camstack login` find the hub without an address. Advertises only the HTTPS address, never a secret. Needs UDP 5353 multicast to reach the LAN (host networking or a dedicated container IP).",
+					style: "switch",
+					default: true
+				}),
 				this.field({
 					type: "text",
 					key: "localHostname",
@@ -762,8 +931,29 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 	}
 	async onConfigChanged() {
 		await this.applyLanAccessFromSettings();
+		await this.applyMdnsAdvertisement();
+	}
+	/**
+	* Start, re-announce or stop the hub's mDNS service (D838). Never throws:
+	* the advertiser logs its own failures and boot goes on.
+	*/
+	async applyMdnsAdvertisement() {
+		if (this.config.mdnsAdvertise === false) {
+			await this.mdns?.stop();
+			return;
+		}
+		if (this.mdns === null) this.mdns = new HubMdnsAdvertiser({
+			publisher: createCiaoPublisher(),
+			logger: this.ctx.logger,
+			nodeId: this.ctx.kernel.localNodeId ?? "hub",
+			version: null,
+			readInternalUrl: async () => internalUrlOf(await this.addressBook("https"))
+		});
+		await this.mdns.start();
 	}
 	async onShutdown() {
+		await this.mdns?.stop();
+		this.mdns = null;
 		if (this.pollTimer) {
 			clearInterval(this.pollTimer);
 			this.pollTimer = null;
@@ -959,6 +1149,7 @@ var LocalNetworkAddon = class extends require_dist.BaseAddon {
 		} });
 		this.lastSnapshotKey = key;
 		this.persistReconciledAllowlist(interfaces);
+		this.mdns?.sync();
 		this.ctx.eventBus?.emit({
 			id: `local-network-changed-${Date.now()}`,
 			timestamp: /* @__PURE__ */ new Date(),

package/dist/builtins/local-network/local-network.addon.mjs

@@ -1,5 +1,6 @@
-import { Bt as isDefaultAppConnectionEndpoint, Dn as resolveNotificationTapAddress, Lt as isAppLinkBase, Wn as validateCustomAddress, Xt as localNetworkCapability, bn as resolveAppConnections, dr as BaseAddon, pn as pickAppLinkHub, ri as EventCategory, rt as checkRoleAddress, s as CAMSTACK_APP_LINK_ORIGIN, wn as resolveHubAddressRoles } from "../../dist-ItJ3qAAA.mjs";
-import { P as readLanHttpState, _ as writeExtraSans, h as readTlsMode, i as storeUploadedCertificate, j as applyLanHttp, k as DEFAULT_LAN_HTTP_PORT, m as readTlsAccessStatus, n as regenerateCertificate, p as readExtraSans, r as revertToGeneratedCertificate, t as applyCertificateToListener, u as servedHttpsLeafFingerprint, y as ensureTlsCert } from "../../tls-C2NT-Orr.mjs";
+import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
+import { D as HUB_MDNS_TXT_KEYS, E as HUB_MDNS_SERVICE_TYPE, En as resolveHubAddressRoles, Ht as isDefaultAppConnectionEndpoint, Kn as validateCustomAddress, Qt as localNetworkCapability, Sn as resolveAppConnections, ai as EventCategory, at as checkRoleAddress, hn as pickAppLinkHub, kn as resolveNotificationTapAddress, pr as BaseAddon, s as CAMSTACK_APP_LINK_ORIGIN, zt as isAppLinkBase } from "../../dist-DwE9yHdk.mjs";
+import { P as readLanHttpState, _ as writeExtraSans, h as readTlsMode, i as storeUploadedCertificate, j as applyLanHttp, k as DEFAULT_LAN_HTTP_PORT, m as readTlsAccessStatus, n as regenerateCertificate, p as readExtraSans, r as revertToGeneratedCertificate, t as applyCertificateToListener, u as servedHttpsLeafFingerprint, y as ensureTlsCert } from "../../tls-D-2dPY-5.mjs";
 import { z } from "zod";
 import { isIP } from "node:net";
 import * as os from "node:os";
@@ -334,6 +335,163 @@ function parseIpv6Groups(address) {
 	];
 }
 //#endregion
+//#region src/builtins/local-network/hub-mdns.ts
+/**
+* Hub mDNS advertisement (D838) — how `camstack login` / `camstack discover`
+* find a hub on the LAN.
+*
+* The hub publishes ONE `_camstack._tcp` service for its HTTPS endpoint. There
+* is no mesh channel in it (D826 retired mesh UDP discovery on purpose) and
+* nothing secret: the TXT record carries the node id, the version, the role
+* and the address URL — finding a hub grants nothing, every client still signs
+* in.
+*
+* The advertised address is NOT ranked here. It is the `internal` role of the
+* address book (the address flagged for LAN clients, else the automatic LAN
+* pick) — this module only reads the answer `local-network` already gives.
+*
+* The responder is injected so the logic is tested with a fake; the real one
+* wraps `@homebridge/ciao`.
+*/
+/** The announcement for the current address, or null when nothing qualifies. */
+function buildHubAnnouncement(inputs) {
+	if (inputs.internalUrl === null) return null;
+	let url;
+	try {
+		url = new URL(inputs.internalUrl);
+	} catch {
+		return null;
+	}
+	if (url.protocol !== "https:") return null;
+	const port = url.port === "" ? 443 : Number.parseInt(url.port, 10);
+	if (!Number.isInteger(port) || port < 1 || port > 65535) return null;
+	const host = url.hostname.replace(/^\[|\]$/g, "");
+	const txt = {
+		[HUB_MDNS_TXT_KEYS.nodeId]: inputs.nodeId,
+		[HUB_MDNS_TXT_KEYS.role]: "hub",
+		[HUB_MDNS_TXT_KEYS.url]: url.origin
+	};
+	if (inputs.version !== null) txt[HUB_MDNS_TXT_KEYS.version] = inputs.version;
+	return {
+		name: `camstack-${inputs.nodeId}`,
+		type: HUB_MDNS_SERVICE_TYPE,
+		port,
+		address: isIP(host) !== 0 ? host : null,
+		txt
+	};
+}
+function announcementKey(a) {
+	return JSON.stringify([
+		a.name,
+		a.type,
+		a.port,
+		a.address,
+		a.txt
+	]);
+}
+/**
+* Keeps one mDNS service in step with the hub's `internal` address. `sync()`
+* is safe to call on any change; it never throws — a failure to advertise is
+* logged and the boot goes on.
+*/
+var HubMdnsAdvertiser = class {
+	options;
+	current = null;
+	running = false;
+	chain = Promise.resolve();
+	constructor(options) {
+		this.options = options;
+	}
+	async start() {
+		this.running = true;
+		await this.sync();
+	}
+	/** Re-read the address and re-announce when it changed. Serialised. */
+	sync() {
+		this.chain = this.chain.then(() => this.syncOnce());
+		return this.chain;
+	}
+	async stop() {
+		this.running = false;
+		await (this.chain = this.chain.then(() => this.withdraw()));
+	}
+	async syncOnce() {
+		if (!this.running) return;
+		const { logger } = this.options;
+		try {
+			const internalUrl = await this.options.readInternalUrl();
+			const next = buildHubAnnouncement({
+				nodeId: this.options.nodeId,
+				version: this.options.version,
+				internalUrl
+			});
+			if (next === null) {
+				if (this.current !== null) {
+					await this.withdraw();
+					logger.info("hub mDNS: no internal address, advertisement withdrawn");
+				}
+				return;
+			}
+			const key = announcementKey(next);
+			if (this.current?.key === key) return;
+			await this.withdraw();
+			const handle = await this.options.publisher.publish(next);
+			this.current = {
+				key,
+				handle
+			};
+			logger.info("hub mDNS: advertising _camstack._tcp", { meta: {
+				url: next.txt[HUB_MDNS_TXT_KEYS.url],
+				port: next.port
+			} });
+		} catch (err) {
+			logger.warn("hub mDNS: could not advertise the hub (logins still work with --server)", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+	async withdraw() {
+		const held = this.current;
+		this.current = null;
+		if (held === null) return;
+		try {
+			await held.handle.stop();
+		} catch (err) {
+			this.options.logger.warn("hub mDNS: withdraw failed", { meta: { error: err instanceof Error ? err.message : String(err) } });
+		}
+	}
+};
+/**
+* The address a hub advertises: the `internal` role's answer, exactly as the
+* address book resolved it. Never re-ranked here (D729, D732).
+*/
+function internalUrlOf(book) {
+	return book.roles.internal.resolved;
+}
+//#endregion
+//#region src/builtins/local-network/hub-mdns-ciao.ts
+function createCiaoPublisher() {
+	return { async publish(announcement) {
+		const { getResponder } = await import("../../lib-B_R6sPC3.mjs").then((m) => /* @__PURE__ */ __toESM(m.default));
+		const responder = getResponder();
+		const service = responder.createService({
+			name: announcement.name,
+			type: announcement.type,
+			port: announcement.port,
+			txt: { ...announcement.txt },
+			...announcement.address !== null ? { restrictedAddresses: [announcement.address] } : {}
+		});
+		try {
+			await service.advertise();
+		} catch (err) {
+			await responder.shutdown().catch(() => void 0);
+			throw err;
+		}
+		return { stop: async () => {
+			await service.destroy();
+			await responder.shutdown();
+		} };
+	} };
+}
+//#endregion
 //#region src/builtins/local-network/local-hostname.ts
 var DNS_NAME = /^(?=.{1,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)*[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])$/;
 /**
@@ -416,6 +574,7 @@ var LocalNetworkAddon = class extends BaseAddon {
 	* `null` when no mesh provider is joined.
 	*/
 	meshEndpoint = null;
+	mdns = null;
 	constructor() {
 		super({
 			allowedAddresses: [],
@@ -427,7 +586,8 @@ var LocalNetworkAddon = class extends BaseAddon {
 			httpPort: DEFAULT_LAN_HTTP_PORT,
 			localHostname: "",
 			internalUrl: "",
-			publicEndpointUrl: ""
+			publicEndpointUrl: "",
+			mdnsAdvertise: true
 		});
 	}
 	/**
@@ -478,6 +638,7 @@ var LocalNetworkAddon = class extends BaseAddon {
 			customAddresses: changed.custom
 		}, detectedUrls);
 		await this.updateGlobalSettings(addressBookPatch(after));
+		await this.mdns?.sync();
 	}
 	/** The deprecated `getHubAddresses` shape, from the role resolvers. */
 	async snapshotHubAddresses() {
@@ -713,6 +874,7 @@ var LocalNetworkAddon = class extends BaseAddon {
 		} catch (err) {
 			this.ctx.logger.warn("local-network: LAN HTTP not applied at boot", { meta: { error: err instanceof Error ? err.message : String(err) } });
 		}
+		await this.applyMdnsAdvertisement();
 		return [{
 			capability: localNetworkCapability,
 			provider
@@ -746,6 +908,14 @@ var LocalNetworkAddon = class extends BaseAddon {
 						equals: true
 					}
 				}),
+				this.field({
+					type: "boolean",
+					key: "mdnsAdvertise",
+					label: "Announce this hub on the LAN (mDNS)",
+					description: "Lets `camstack login` find the hub without an address. Advertises only the HTTPS address, never a secret. Needs UDP 5353 multicast to reach the LAN (host networking or a dedicated container IP).",
+					style: "switch",
+					default: true
+				}),
 				this.field({
 					type: "text",
 					key: "localHostname",
@@ -759,8 +929,29 @@ var LocalNetworkAddon = class extends BaseAddon {
 	}
 	async onConfigChanged() {
 		await this.applyLanAccessFromSettings();
+		await this.applyMdnsAdvertisement();
+	}
+	/**
+	* Start, re-announce or stop the hub's mDNS service (D838). Never throws:
+	* the advertiser logs its own failures and boot goes on.
+	*/
+	async applyMdnsAdvertisement() {
+		if (this.config.mdnsAdvertise === false) {
+			await this.mdns?.stop();
+			return;
+		}
+		if (this.mdns === null) this.mdns = new HubMdnsAdvertiser({
+			publisher: createCiaoPublisher(),
+			logger: this.ctx.logger,
+			nodeId: this.ctx.kernel.localNodeId ?? "hub",
+			version: null,
+			readInternalUrl: async () => internalUrlOf(await this.addressBook("https"))
+		});
+		await this.mdns.start();
 	}
 	async onShutdown() {
+		await this.mdns?.stop();
+		this.mdns = null;
 		if (this.pollTimer) {
 			clearInterval(this.pollTimer);
 			this.pollTimer = null;
@@ -956,6 +1147,7 @@ var LocalNetworkAddon = class extends BaseAddon {
 		} });
 		this.lastSnapshotKey = key;
 		this.persistReconciledAllowlist(interfaces);
+		this.mdns?.sync();
 		this.ctx.eventBus?.emit({
 			id: `local-network-changed-${Date.now()}`,
 			timestamp: /* @__PURE__ */ new Date(),

package/dist/builtins/loki-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/loki-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Qt as logDestinationCapability, dr as BaseAddon } from "../../dist-ItJ3qAAA.mjs";
+import { en as logDestinationCapability, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 //#region src/builtins/loki-logging/loki-payload.ts
 /**
 * Loki rejects a label name that is not a valid Prometheus label

package/dist/builtins/native-metrics/native-metrics.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 const require_proc_stat = require("../../proc-stat-DL-WUOhl.js");
 let node_fs_promises = require("node:fs/promises");
 let node_os = require("node:os");

package/dist/builtins/native-metrics/native-metrics.addon.mjs

@@ -1,4 +1,4 @@
-import { Er as createEvent, Nt as foldSnapshotByFunction, an as metricsProviderCapability, dr as BaseAddon, ri as EventCategory, ur as errMsg, vn as reducePoints, xn as resolveBucketMs } from "../../dist-ItJ3qAAA.mjs";
+import { Cn as resolveBucketMs, Ft as foldSnapshotByFunction, Or as createEvent, ai as EventCategory, bn as reducePoints, fr as errMsg, pr as BaseAddon, sn as metricsProviderCapability } from "../../dist-DwE9yHdk.mjs";
 import { a as parseProcStat, i as nodeProcReader, n as elapsedSecSince, o as parseProcStatusRss, r as lifetimeCpuPercent, t as commandFromCmdline } from "../../proc-stat-CbC55Kqi.mjs";
 import { access, readFile, readdir } from "node:fs/promises";
 import * as os from "node:os";

package/dist/builtins/platform-probe/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 let node_os = require("node:os");
 node_os = require_chunk.__toESM(node_os);
 let node_fs = require("node:fs");

package/dist/builtins/platform-probe/index.mjs

@@ -1,5 +1,5 @@
 import { o as __toESM } from "../../chunk-CNf5ZN-e.mjs";
-import { Ar as emitReadiness, dr as BaseAddon, hn as platformProbeCapability, jn as scoreRuntimes, ri as EventCategory, ur as errMsg, wt as enumerateInferenceDevices } from "../../dist-ItJ3qAAA.mjs";
+import { Et as enumerateInferenceDevices, Mr as emitReadiness, Nn as scoreRuntimes, _n as platformProbeCapability, ai as EventCategory, fr as errMsg, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 import * as os from "node:os";
 import * as fs from "node:fs";
 import { execFile } from "node:child_process";

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/remote-access-orchestrator/remote-access-orchestrator.addon.mjs

@@ -1,4 +1,4 @@
-import { dr as BaseAddon, ri as EventCategory } from "../../dist-ItJ3qAAA.mjs";
+import { ai as EventCategory, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 //#region src/builtins/remote-access-orchestrator/enabled-providers-reconcile.ts
 /**
 * Reconcile the durable `enabledProviders` set against authoritative

package/dist/builtins/snapshot/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 const require_snapshot_courtesy = require("../../snapshot-courtesy-D_C5-nC0.js");
 let zod = require("zod");
 let node_crypto = require("node:crypto");

package/dist/builtins/snapshot/index.mjs

@@ -1,4 +1,4 @@
-import { Bn as streamQualityLabel, Pn as snapshotCapability, Q as batteryCapability, Vr as nodePin, Z as bareAddonId, a as BatteryStatusSchema, dr as BaseAddon, in as memoizePinnedFfmpeg, lr as DeviceType, ri as EventCategory, sr as DeviceFeature, ur as errMsg, vt as deriveBatteryPresence } from "../../dist-ItJ3qAAA.mjs";
+import { $ as bareAddonId, Hn as streamQualityLabel, In as snapshotCapability, Ur as nodePin, a as BatteryStatusSchema, ai as EventCategory, bt as deriveBatteryPresence, dr as DeviceType, et as batteryCapability, fr as errMsg, lr as DeviceFeature, on as memoizePinnedFfmpeg, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 import { i as renderCourtesyOverlayJpeg, n as courtesyCacheKey, r as renderCourtesyJpeg } from "../../snapshot-courtesy-CyFs1M3I.mjs";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";

package/dist/builtins/sqlite-storage/filesystem-storage.addon.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-BcnmH70Z.js");
+const require_dist = require("../../dist-DxiDI8hZ.js");
 let node_crypto = require("node:crypto");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");

package/dist/builtins/sqlite-storage/filesystem-storage.addon.mjs

@@ -1,4 +1,4 @@
-import { Mt as filesystemBrowseCapability, Rn as storageProviderCapability, dr as BaseAddon } from "../../dist-ItJ3qAAA.mjs";
+import { Bn as storageProviderCapability, Pt as filesystemBrowseCapability, pr as BaseAddon } from "../../dist-DwE9yHdk.mjs";
 import { randomUUID } from "node:crypto";
 import { mkdir, readdir, realpath, statfs } from "node:fs/promises";
 import * as path$1 from "node:path";

package/dist/builtins/storage-orchestrator/storage-location-band-monitor.d.ts

@@ -0,0 +1,43 @@
+/**
+* StorageLocationBandMonitor — free-space bands for Notification Center.
+*
+* Capacity that failed to measure is `null` and becomes CRITICAL (D393) —
+* never folded into 0% or 100%. Disabled / non-managed locations are absent
+* from the sweep input and clear any open episode without an `ok` event.
+*
+* Pure, injected clock, one transition per band change.
+*/
+export type StorageLocationBand = "ok" | "low" | "critical";
+export interface StorageLocationBandConfig {
+	/** Free percent at/below which the location is low (default 15). */
+	readonly lowPercent: number;
+	/** Free percent at/below which the location is critical (default 5). */
+	readonly criticalPercent: number;
+}
+export declare const DEFAULT_STORAGE_LOCATION_BAND_CONFIG: StorageLocationBandConfig;
+export interface StorageLocationBandSample {
+	readonly locationId: string;
+	readonly nodeId?: string;
+	readonly locationName?: string;
+	/** Free percent, or `null` when the probe failed. */
+	readonly freePercent: number | null;
+}
+export interface StorageLocationBandEvent {
+	readonly locationId: string;
+	readonly nodeId?: string;
+	readonly locationName?: string;
+	readonly band: StorageLocationBand;
+	readonly freePercent: number | null;
+	readonly reason: string;
+	readonly previous: StorageLocationBand | null;
+}
+export declare class StorageLocationBandMonitor {
+	private readonly config;
+	private readonly band;
+	constructor(config?: StorageLocationBandConfig);
+	/**
+	* Observe one sweep of managed locations. Locations missing from `samples`
+	* drop their episode without emitting `ok` (disabled / removed).
+	*/
+	observe(samples: readonly StorageLocationBandSample[]): readonly StorageLocationBandEvent[];
+}