@camstack/types 1.2.435 → 1.2.436

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sleep = require("./sleep-DHitF_e4.js");
 const require_event_category = require("./event-category-E17zaHjN.js");
-const require_composition = require("./composition-BZf_gqG7.js");
+const require_composition = require("./composition-WNkEpwkF.js");
 const require_node_color = require("./node-color.js");
 const require_err_msg = require("./err-msg-U7lLUMNz.js");
 const require_enums = require("./enums.js");
@@ -15574,12 +15574,13 @@ var CHANGED = {
 	expr: "now"
 };
 function numeric(input) {
+	const { alsoFrom, ...base } = input;
 	return {
-		...input,
+		...base,
 		family: "numeric",
 		deviceType: require_err_msg.DeviceType.Sensor,
 		memberDeviceType: require_err_msg.DeviceType.Sensor,
-		memberDeviceTypes: [require_err_msg.DeviceType.Sensor],
+		memberDeviceTypes: [require_err_msg.DeviceType.Sensor, ...alsoFrom?.deviceTypes ?? []],
 		activeWhen: void 0,
 		commandCaps: [],
 		baseUnit: require_sleep.baseUnitOf(input.quantity),
@@ -15587,9 +15588,10 @@ function numeric(input) {
 		accept: [{
 			cap: input.outputCap,
 			fieldPath: input.outputField
-		}]
+		}, ...alsoFrom === void 0 ? [] : [alsoFrom.accept]]
 	};
 }
+var CLIMATE_DEVICES = [require_err_msg.DeviceType.Thermostat, require_err_msg.DeviceType.Climate];
 function binary(input) {
 	return {
 		...input,
@@ -15615,7 +15617,14 @@ var GROUP_TEMPLATES = [
 		quantity: "temperature",
 		defaultAggregate: "mean",
 		empty: "null",
-		companions: [NOW$2]
+		companions: [NOW$2],
+		alsoFrom: {
+			deviceTypes: CLIMATE_DEVICES,
+			accept: {
+				cap: "climate-control",
+				fieldPath: "currentTemp"
+			}
+		}
 	}),
 	numeric({
 		id: "humidity",
@@ -15626,7 +15635,14 @@ var GROUP_TEMPLATES = [
 		quantity: "humidity",
 		defaultAggregate: "mean",
 		empty: "null",
-		companions: [NOW$2]
+		companions: [NOW$2],
+		alsoFrom: {
+			deviceTypes: CLIMATE_DEVICES,
+			accept: {
+				cap: "climate-control",
+				fieldPath: "currentHumidity"
+			}
+		}
 	}),
 	numeric({
 		id: "pressure",
@@ -46320,6 +46336,43 @@ var NotificationActionSchema = zod.z.object({
 	*/
 	mode: zod.z.enum(["navigate", "background"]).optional()
 });
+/** A delivery parameter value: what a notifier declared it takes. */
+var DeliveryParamValueSchema = zod.z.union([
+	zod.z.string(),
+	zod.z.number(),
+	zod.z.boolean()
+]);
+/**
+* One extra delivery parameter a notifier KIND declares (D938). A rule that
+* addresses a target of that kind may set it; a kind that declares nothing is
+* never handed one. The admin UI derives its control from this descriptor —
+* no editor knows a service by name.
+*
+* Optional fields are `.optional()`, never `.default()` (a Zod default does not
+* run on the addon cap path).
+*/
+var DeliveryParamSchema = zod.z.object({
+	key: zod.z.string().min(1),
+	label: zod.z.string(),
+	/** i18n key of the label, resolved by the declaring addon's namespace. */
+	labelKey: zod.z.string().optional(),
+	type: zod.z.enum([
+		"enum",
+		"number",
+		"boolean",
+		"string"
+	]),
+	/** `enum` only: the closed set of accepted values. */
+	options: zod.z.array(zod.z.object({
+		value: zod.z.string(),
+		label: zod.z.string()
+	})).optional(),
+	/** `number` only. */
+	min: zod.z.number().optional(),
+	max: zod.z.number().optional(),
+	/** What the notifier does when the rule sets nothing; shown as the placeholder. */
+	default: DeliveryParamValueSchema.optional()
+});
 /**
 * The canonical notification. `body` is the only hard field (Apprise model).
 * `priority` is a 5-level ORDINAL (1=lowest … 3=normal(default) … 5=urgent),
@@ -46342,7 +46395,13 @@ var NotificationSchema = zod.z.object({
 	tag: zod.z.string().optional(),
 	deviceId: zod.z.number().optional(),
 	eventId: zod.z.string().optional(),
-	metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+	metadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+	/**
+	* Values for the parameters the target's kind DECLARES in
+	* {@link TargetKindSchema} `deliveryParams`. Already validated against the
+	* declaration by the sender; a notifier reads only the keys it declared.
+	*/
+	delivery: zod.z.record(zod.z.string(), DeliveryParamValueSchema).optional()
 });
 /** One declared native severity/priority level for a kind. */
 var TargetKindLevelSchema = zod.z.object({
@@ -46450,6 +46509,11 @@ var TargetKindSchema = zod.z.object({
 	*/
 	destinationKeys: zod.z.array(zod.z.string()).optional(),
 	supportsDiscovery: zod.z.boolean(),
+	/**
+	* Extra delivery parameters a rule may set for a target of this kind (D938).
+	* Absent = none; the rule editor then offers nothing.
+	*/
+	deliveryParams: zod.z.array(DeliveryParamSchema).optional(),
 	caps: TargetKindCapsSchema
 });
 /**
@@ -63687,7 +63751,9 @@ var ManifestShapeSchema = zod.z.object({
 		icon: zod.z.string().optional()
 	}).optional(),
 	protected: zod.z.boolean().optional(),
-	removable: zod.z.boolean().optional()
+	removable: zod.z.boolean().optional(),
+	/** Declared Integrations-page block (mirror of `AddonDeclaration.integrationSection`). */
+	integrationSection: zod.z.enum(["system", "providers"]).optional()
 });
 var AddonProcessSchema = zod.z.object({
 	pid: zod.z.number().optional(),
@@ -81397,6 +81463,7 @@ function evaluateAggregate(input) {
 function sourcePickForTemplate(template) {
 	const valueKind = template.family === "numeric" ? "number" : template.activeWhen === void 0 ? "boolean" : "state";
 	return {
+		fieldChoice: template.family === "numeric" ? "first-match" : "operator",
 		purpose: "member",
 		multiple: true,
 		max: 64,
@@ -81416,6 +81483,7 @@ function sourcePickForTemplate(template) {
 /** A statistic or integral reads one field that declares history. */
 function sourcePickForHistory(kind) {
 	return {
+		fieldChoice: "operator",
 		purpose: "historised",
 		multiple: false,
 		max: 1,
@@ -81455,6 +81523,7 @@ function sourcePickForMath(kind) {
 	const multiple = kind === "sum" || kind === "expression";
 	const max = kind === "difference" || kind === "ratio" ? 2 : multiple ? 64 : 1;
 	return {
+		fieldChoice: "operator",
 		purpose: "reading",
 		multiple: multiple || max > 1,
 		max,
@@ -109879,6 +109948,46 @@ function prepareNotification(caps, n) {
 	};
 }
 //#endregion
+//#region src/notification/delivery-params.ts
+function valueFor(param, raw) {
+	switch (param.type) {
+		case "enum": return typeof raw === "string" && (param.options ?? []).some((o) => o.value === raw) ? raw : void 0;
+		case "number": {
+			if (typeof raw !== "number" || !Number.isFinite(raw)) return void 0;
+			const floor = param.min ?? Number.NEGATIVE_INFINITY;
+			const ceil = param.max ?? Number.POSITIVE_INFINITY;
+			return Math.min(ceil, Math.max(floor, raw));
+		}
+		case "boolean": return typeof raw === "boolean" ? raw : void 0;
+		case "string": return typeof raw === "string" && raw.length > 0 ? raw : void 0;
+	}
+}
+/**
+* The values a rule target's `params` contribute for a kind: only declared
+* keys, only valid values. `undefined` when nothing survives — a notifier that
+* declared nothing is never handed a `delivery` block.
+*/
+function resolveDeliveryParams(declared, params) {
+	if (declared === void 0 || params === void 0) return void 0;
+	const out = {};
+	for (const param of declared) {
+		const value = valueFor(param, params[param.key]);
+		if (value !== void 0) out[param.key] = value;
+	}
+	return Object.keys(out).length > 0 ? out : void 0;
+}
+/** The union of several kinds' declarations; the first declaration of a key wins. */
+function deliveryParamsDeclaredBy(perKind) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	for (const declared of perKind) for (const param of declared ?? []) {
+		if (seen.has(param.key)) continue;
+		seen.add(param.key);
+		out.push(param);
+	}
+	return out;
+}
+//#endregion
 //#region src/notification/system-event-filters.ts
 /**
 * WHICH narrowing filter speaks about WHICH system-event kind — one predicate,
@@ -118189,6 +118298,29 @@ function rewriteReferer(referer, route) {
 	if (upstream === void 0) return null;
 	return `${upstream.scheme}://${upstream.host}${rest?.[2] ?? "/"}${url.search}`;
 }
+function decodeFormComponent(raw) {
+	try {
+		return decodeURIComponent(raw.replace(/\+/g, " "));
+	} catch {
+		return null;
+	}
+}
+/**
+* An `application/x-www-form-urlencoded` body whose field VALUES that are proxy URLs of
+* this attempt (absolute or root-relative) are turned back into the vendor URL they stand
+* for — the page's hidden inputs were rewritten on the way out (`rewriteBody`), and the
+* vendor must get its own URL back. Field order and every untouched pair stay byte-identical.
+*/
+function rewriteFormBody(body, route) {
+	return body.split("&").map((pair) => {
+		const eq = pair.indexOf("=");
+		if (eq === -1) return pair;
+		const value = decodeFormComponent(pair.slice(eq + 1));
+		if (value === null || !/^(?:https?:\/\/|\/)/i.test(value)) return pair;
+		const back = rewriteReferer(value, route);
+		return back === null ? pair : `${pair.slice(0, eq + 1)}${encodeURIComponent(back)}`;
+	}).join("&");
+}
 /** Cookies the browser holds for the hub itself must never reach a vendor. */
 function filterForwardedCookies(cookieHeader) {
 	return cookieHeader.split(";").map((part) => part.trim()).filter((part) => part.length > 0 && !part.toLowerCase().startsWith("camstack_")).join("; ");
@@ -118249,6 +118381,9 @@ function bodyKindOf(contentType) {
 	if (type.startsWith("text/") || type.includes("javascript") || type.includes("json") || type.includes("xml")) return "other";
 	return null;
 }
+function isFormEncoded(contentType) {
+	return (firstHeader(contentType) ?? "").toLowerCase().startsWith("application/x-www-form-urlencoded");
+}
 function firstHeader(value) {
 	return Array.isArray(value) ? value[0] : value;
 }
@@ -118379,7 +118514,7 @@ var VendorLoginProxy = class {
 				sendPlain(res, 413, "Request too large");
 				return;
 			}
-			body = read;
+			body = isFormEncoded(req.headers["content-type"]) ? Buffer.from(rewriteFormBody(read.toString("utf8"), route), "utf8") : read;
 		}
 		const headers = this.#requestHeaders(req, route, upstream);
 		const upstreamRes = await this.#fetch(target, {
@@ -118393,9 +118528,10 @@ var VendorLoginProxy = class {
 		const kind = bodyKindOf(upstreamRes.headers.get("content-type") ?? "");
 		const declaredLength = Number(upstreamRes.headers.get("content-length") ?? "0");
 		const text = kind !== null && !(declaredLength > MAX_TEXT_BODY_BYTES) && method !== "HEAD" ? await upstreamRes.text() : null;
-		this.#logger.debug("vendor login proxy: upstream answered", { meta: {
+		this.#logger.info("vendor login proxy: upstream answered", { meta: {
 			addonId: this.#addonId,
 			host: upstream.host,
+			path: target.pathname,
 			status: upstreamRes.status,
 			method
 		} });
@@ -120086,6 +120222,8 @@ exports.DeclareKindResultSchema = DeclareKindResultSchema;
 exports.DeclaredDevices = DeclaredDevices;
 exports.DecodedAudioChunkSchema = require_sleep.DecodedAudioChunkSchema;
 exports.DeleteIntegrationResultSchema = DeleteIntegrationResultSchema;
+exports.DeliveryParamSchema = DeliveryParamSchema;
+exports.DeliveryParamValueSchema = DeliveryParamValueSchema;
 exports.DerivativeHelperSpecSchema = require_composition.DerivativeHelperSpecSchema;
 exports.DetailCropConventionSchema = DetailCropConventionSchema;
 exports.DetectionCatalogClassMapSchema = DetectionCatalogClassMapSchema;
@@ -121883,6 +122021,7 @@ exports.defineRecordKinds = require_sleep.defineRecordKinds;
 exports.dehydrateConfigField = require_sleep.dehydrateConfigField;
 exports.dehydrateSchema = require_sleep.dehydrateSchema;
 exports.deleteAlarmProfile = deleteAlarmProfile;
+exports.deliveryParamsDeclaredBy = deliveryParamsDeclaredBy;
 exports.derivativeDraft = derivativeDraft;
 exports.derivativeUnitLabel = derivativeUnitLabel;
 exports.deriveBatteryPresence = deriveBatteryPresence;
@@ -122441,6 +122580,7 @@ exports.resolveContainerPrimaryChild = resolveContainerPrimaryChild;
 exports.resolveCoreBlockEntry = resolveCoreBlockEntry;
 exports.resolveCoreBlockFiles = resolveCoreBlockFiles;
 exports.resolveCreateExportSubject = resolveCreateExportSubject;
+exports.resolveDeliveryParams = resolveDeliveryParams;
 exports.resolveDeviceControlKind = resolveDeviceControlKind;
 exports.resolveDeviceProfile = resolveDeviceProfile;
 exports.resolveDeviceTarget = resolveDeviceTarget;