@camstack/types 1.2.435 → 1.2.437

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",
@@ -44634,6 +44650,17 @@ var LlmProfileSchema = zod.z.object({
 	*  field in its editor only when its descriptor lists it in `profileFields`. */
 	topK: zod.z.number().int().positive().optional(),
 	maxTokens: zod.z.number().int().positive().optional(),
+	/** How hard the model "thinks" before it answers. Omitted = the model's own
+	*  default. `off` matters for structured output: a thinking model can spend
+	*  the whole completion on reasoning and return an empty `content`. Carried
+	*  only by the wires that have it — a kind offers the field in its editor
+	*  only when its descriptor lists it in `profileFields`. */
+	reasoningEffort: zod.z.enum([
+		"off",
+		"low",
+		"medium",
+		"high"
+	]).optional(),
 	/** Prompt context window. Advisory for cloud kinds (they enforce their own). */
 	contextLength: zod.z.number().int().positive().optional(),
 	/** Default system prompt. A caller's `system` REPLACES it (never appends —
@@ -44672,6 +44699,7 @@ var LlmProfileFieldSchema = zod.z.enum([
 	"topP",
 	"topK",
 	"maxTokens",
+	"reasoningEffort",
 	"contextLength",
 	"systemPrompt",
 	"timeoutMs",
@@ -46320,6 +46348,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 +46407,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 +46521,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 +63763,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 +81475,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 +81495,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 +81535,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 +109960,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,
@@ -118171,6 +118292,29 @@ function rewriteSetCookie(cookie, route) {
 	return kept.join("; ");
 }
 /**
+* Every Set-Cookie of one vendor response, rewritten. Dropping `Domain` folds cookies
+* the vendor keeps apart (`session-id` on `.amazon.it` and on `.www.amazon.it`) into
+* one, so a past-dated set that only deleted the other domain's copy would delete the
+* live one the same response just set: that deletion is dropped.
+*/
+function rewriteSetCookies(cookies, route) {
+	const now = Date.now();
+	const liveNames = new Set(cookies.filter((c) => !isExpiredCookie(c, now)).map(cookieName));
+	return cookies.filter((c) => !(isExpiredCookie(c, now) && liveNames.has(cookieName(c)))).map((c) => rewriteSetCookie(c, route));
+}
+function cookieName(cookie) {
+	return cookie.split(";")[0]?.split("=")[0]?.trim() ?? "";
+}
+function isExpiredCookie(cookie, now) {
+	const attrs = cookie.split(";").slice(1).map((part) => part.trim());
+	const maxAge = attrs.find((a) => /^max-age=/i.test(a));
+	if (maxAge !== void 0) return Number(maxAge.slice(8)) <= 0;
+	const expires = attrs.find((a) => /^expires=/i.test(a));
+	if (expires === void 0) return false;
+	const at = Date.parse(expires.slice(8));
+	return Number.isFinite(at) && at <= now;
+}
+/**
 * A browser `Referer` that points into this proxy, turned back into the vendor URL it
 * stands for. A Referer that is not ours is dropped (null): it names the hub.
 */
@@ -118189,6 +118333,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 +118416,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;
 }
@@ -118263,6 +118433,26 @@ async function readRequestBody(req) {
 	}
 	return Buffer.concat(chunks);
 }
+/** The path of the Referer sent upstream, or why none was sent — the query is never logged. */
+function forwardedRefererPath(forwarded, received) {
+	if (forwarded !== void 0) return URL.canParse(forwarded) ? new URL(forwarded).pathname : "unparsable";
+	return received === void 0 ? "absent" : "unmapped";
+}
+/** The form targets a vendor page posts to, path only (no query), so a lost path prefix is visible. */
+function formActionPaths(html) {
+	const actions = [...html.matchAll(/<form\b[^>]*\baction\s*=\s*["']([^"']*)["']/gi)].map((m) => (m[1] ?? "").split("?")[0] ?? "").slice(0, 5);
+	return actions.length === 0 ? "none" : actions.join(" | ");
+}
+/** Cookie NAMES only — values are session secrets and are never logged. */
+function cookieNames(header) {
+	if (header === void 0 || header.length === 0) return "none";
+	return header.split(";").map((part) => part.split("=")[0]?.trim() ?? "").join(",");
+}
+/** A Set-Cookie's name and attributes without its value, so a cookie the browser refuses is visible. */
+function setCookieShape(cookie) {
+	const [first, ...attrs] = cookie.split(";").map((part) => part.trim());
+	return [first?.split("=")[0] ?? "", ...attrs.filter((a) => !/^expires=/i.test(a))].join(";");
+}
 function sendPlain(res, status, text) {
 	res.writeHead(status, {
 		"content-type": "text/plain; charset=utf-8",
@@ -118379,7 +118569,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,11 +118583,16 @@ 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
+			method,
+			refererPath: forwardedRefererPath(headers["referer"], req.headers["referer"]),
+			formActions: kind === "html" && text !== null ? formActionPaths(text) : void 0,
+			sentNames: cookieNames(headers["cookie"]),
+			vendorSets: setCookies.map(setCookieShape).join(" | ")
 		} });
 		const settled = await attempt.evaluate({
 			status: upstreamRes.status,
@@ -118419,7 +118614,7 @@ var VendorLoginProxy = class {
 		upstreamRes.headers.forEach((value, name) => {
 			if (!DROP_RESPONSE_HEADERS.has(name.toLowerCase())) out[name] = value;
 		});
-		if (setCookies.length > 0) out["set-cookie"] = setCookies.map((c) => rewriteSetCookie(c, route));
+		if (setCookies.length > 0) out["set-cookie"] = rewriteSetCookies(setCookies, route);
 		if (location !== null) out["location"] = rewriteLocation(location, upstream, route);
 		out["cache-control"] = "no-store";
 		if (text !== null && kind !== null) {
@@ -120086,6 +120281,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 +122080,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 +122639,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;