@camstack/types 1.2.437 → 1.2.439

package/dist/index.js

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-DHitF_e4.js");
+const require_sleep = require("./sleep-g6ZjBHBL.js");
 const require_event_category = require("./event-category-E17zaHjN.js");
-const require_composition = require("./composition-WNkEpwkF.js");
+const require_composition = require("./composition-DCmtFE-X.js");
 const require_node_color = require("./node-color.js");
-const require_err_msg = require("./err-msg-U7lLUMNz.js");
+const require_err_msg = require("./err-msg-COHgq7Mb.js");
 const require_enums = require("./enums.js");
 let zod = require("zod");
 //#region src/media/media-owner-key.ts
@@ -11180,9 +11180,21 @@ var AlertSeveritySchema = zod.z.enum([
 	"error",
 	"critical"
 ]);
+/**
+* An action that RUNS something instead of going somewhere: the admin UI calls
+* the addon's custom action (`addons.custom`) with exactly these fields. The
+* producer owns the meaning; the UI knows nothing about the addon or the kind.
+*/
+var AlertActionInvokeSchema = zod.z.object({
+	addonId: zod.z.string().min(1),
+	action: zod.z.string().min(1),
+	input: zod.z.record(zod.z.string(), zod.z.unknown()).optional()
+});
+/** An action has `href` (a link) OR `invoke` (a button that runs a custom action). */
 var AlertActionSchema = zod.z.object({
 	label: zod.z.string(),
 	href: zod.z.string().optional(),
+	invoke: AlertActionInvokeSchema.optional(),
 	/**
 	* How `href` is followed. Absent / `app`: an admin-ui route (client-side).
 	* `server`: a route the HUB serves (an addon HTTP route such as an OAuth
@@ -65208,6 +65220,83 @@ var buttonCapability = {
 	}) }
 };
 //#endregion
+//#region src/ir/ir-timings.ts
+/** Maximum number of mark/space entries one pulse train may carry. */
+var IR_TIMINGS_MAX = 1024;
+/**
+* A pulse train in signed microseconds: mark (+) first, then space (-), strictly
+* alternating, no zeros, 2..1024 entries.
+*/
+var IrTimingsSchema = zod.z.array(zod.z.number().int()).min(2).max(IR_TIMINGS_MAX).superRefine((timings, ctx) => {
+	timings.forEach((value, index) => {
+		const expectMark = index % 2 === 0;
+		if (value === 0 || value > 0 !== expectMark) ctx.addIssue({
+			code: "custom",
+			message: `timing ${index} must be a non-zero ${expectMark ? "mark (positive)" : "space (negative)"}`,
+			path: [index]
+		});
+	});
+});
+/** Per-command transmit options. Every key is optional; a transmitter applies what it can. */
+var TransmitSettingsSchema = zod.z.object({
+	carrierHz: zod.z.number().int().positive().optional(),
+	dutyCyclePercent: zod.z.number().int().min(1).max(100).optional(),
+	repeat: zod.z.number().int().min(0).max(20).optional(),
+	repeatDelayMs: zod.z.number().int().min(0).optional()
+});
+//#endregion
+//#region src/capabilities/ir-transmitter.cap.ts
+/** The setting keys a transmitter may declare as settable (`getInfo.settable`). */
+var TransmitSettingKeySchema = zod.z.enum([
+	"carrierHz",
+	"dutyCyclePercent",
+	"repeat",
+	"repeatDelayMs"
+]);
+var IrMediumSchema = zod.z.enum(["ir", "rf"]);
+var IrSendResultSchema = zod.z.object({
+	ok: zod.z.literal(true),
+	/** Settings the transmitter could not apply; the train was still sent. */
+	ignoredSettings: zod.z.array(zod.z.string())
+});
+var IrTransmitterInfoSchema = zod.z.object({
+	media: zod.z.array(IrMediumSchema),
+	settable: zod.z.array(TransmitSettingKeySchema),
+	maxTimings: zod.z.number().int().positive()
+});
+/**
+* ir-transmitter — emit a pulse train (infrared or RF) with settings. One cap
+* for both media: everything medium-specific is a per-call setting, validated
+* against what the transmitter declares in `getInfo`.
+*
+* `send` refuses with a typed user error: `ir-transmitter.offline` (the
+* transmitter cannot be reached) and `ir-transmitter.too-long` (more pulses
+* than the transmitter's `maxTimings`). A setting the transmitter cannot apply
+* is NOT a refusal: the train is sent and the key comes back in
+* `ignoredSettings`.
+*/
+var irTransmitterCapability = {
+	name: "ir-transmitter",
+	scope: "device",
+	deviceNative: true,
+	mode: "singleton",
+	deviceTypes: [require_err_msg.DeviceType.Generic],
+	methods: {
+		send: require_sleep.method(zod.z.object({
+			deviceId: zod.z.number().int().nonnegative(),
+			timings: IrTimingsSchema,
+			settings: TransmitSettingsSchema.optional()
+		}), IrSendResultSchema, {
+			kind: "mutation",
+			auth: "protected"
+		}),
+		getInfo: require_sleep.method(zod.z.object({ deviceId: zod.z.number().int().nonnegative() }), IrTransmitterInfoSchema, {
+			kind: "query",
+			auth: "protected"
+		})
+	}
+};
+//#endregion
 //#region src/capabilities/calendar-source.cap.ts
 /**
 * `calendar-source` — collection cap exposing per-provider calendars and
@@ -72357,9 +72446,14 @@ var PetFeederStatusSchema = zod.z.object({
 	*  (`device_class: problem`, on = low). True when the tank reports empty,
 	*  or, on a dual-hopper model, when EITHER hopper is empty. */
 	lowFood: zod.z.boolean(),
-	/** Battery charge 0..100 (%). Null on mains-powered models or when the
-	*  device has no battery reading. */
+	/** Battery charge 0..100 (%). On a feeder running on `mains` this is the
+	*  BACKUP battery's charge, not the power source. Null when the device has
+	*  no battery reading. */
 	batteryPower: zod.z.number().min(0).max(100).nullable().meta(require_sleep.readingMeta("percentage")),
+	/** What the feeder is powered from right now: `mains` (plugged in, the
+	*  battery is only a backup) or `battery`. Null when the device does not
+	*  report it. */
+	powerSource: zod.z.enum(["mains", "battery"]).nullable(),
 	/**
 	* Desiccant life remaining, stored in seconds (duration base, D944).
 	* Providers convert from the days the feeder reports. Null when the
@@ -90859,6 +90953,20 @@ var METHOD_ACCESS_MAP = Object.freeze({
 		access: "create",
 		role: "viewer"
 	},
+	"irTransmitter.getInfo": {
+		capName: "ir-transmitter",
+		capScope: "device",
+		addonId: null,
+		access: "view",
+		role: "viewer"
+	},
+	"irTransmitter.send": {
+		capName: "ir-transmitter",
+		capScope: "device",
+		addonId: null,
+		access: "create",
+		role: "viewer"
+	},
 	"keychain.delete": {
 		capName: "keychain",
 		capScope: "system",
@@ -97227,6 +97335,7 @@ var KNOWN_CAP_NAMES = [
 	"image-settings",
 	"integrations",
 	"intercom",
+	"ir-transmitter",
 	"keychain",
 	"keychain-admin",
 	"lawn-mower-control",
@@ -97378,6 +97487,7 @@ var DEVICE_CAP_NAMES = [
 	"image",
 	"image-settings",
 	"intercom",
+	"ir-transmitter",
 	"lawn-mower-control",
 	"lock-control",
 	"media-player",
@@ -98869,6 +98979,11 @@ var ACTUATOR_CAP_VOCABULARY = {
 			icon: "circle-dot"
 		}]
 	},
+	"ir-transmitter": {
+		scope: "device",
+		noun: t("IR / RF transmitter", "Trasmettitore IR / RF"),
+		notOperatorFacing: { send: "a raw pulse train is not something an operator composes in an automation; the remote that owns the command table sends it" }
+	},
 	control: {
 		scope: "device",
 		noun: t("Control", "Controllo"),
@@ -103315,6 +103430,7 @@ var CAPABILITY_NAMES = {
 	imageSettings: "image-settings",
 	integrations: "integrations",
 	intercom: "intercom",
+	irTransmitter: "ir-transmitter",
 	keychain: "keychain",
 	keychainAdmin: "keychain-admin",
 	lawnMowerControl: "lawn-mower-control",
@@ -103763,6 +103879,10 @@ var CAPABILITY_ROUTER_KEYS = [
 		key: "intercom",
 		name: "intercom"
 	},
+	{
+		key: "irTransmitter",
+		name: "ir-transmitter"
+	},
 	{
 		key: "keychain",
 		name: "keychain"
@@ -104264,6 +104384,7 @@ var ALL_CAPABILITY_DEFINITIONS = [
 	imageSettingsCapability,
 	integrationsCapability,
 	intercomCapability,
+	irTransmitterCapability,
 	keychainCapability,
 	keychainAdminCapability,
 	lawnMowerControlCapability,
@@ -105459,6 +105580,16 @@ var METHOD_DEVICE_SELECTORS = Object.freeze({
 		form: "single",
 		optional: false
 	}],
+	"irTransmitter.getInfo": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
+	"irTransmitter.send": [{
+		name: "deviceId",
+		form: "single",
+		optional: false
+	}],
 	"keychain.deleteDeviceScope": [{
 		name: "deviceId",
 		form: "single",
@@ -119719,6 +119850,177 @@ function armRemovalReconcile(opts) {
 	return () => clearInterval(timer);
 }
 //#endregion
+//#region src/ir/ir-error.ts
+var IrCodecError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.name = "IrCodecError";
+		this.code = code;
+	}
+};
+//#endregion
+//#region src/ir/pronto.ts
+/** One Pronto frequency-word unit, in microseconds, per unit of the word. */
+var PRONTO_CLOCK_US = .241246;
+var LEARNED_FORM = 0;
+/**
+* Decode a learned (0000 form) Pronto hex string. The intro burst is followed by
+* the repeat burst once; a different form is refused with `pronto-unsupported-form`.
+*/
+function decodePronto(code) {
+	const words = code.trim().split(/\s+/).filter((w) => w.length > 0);
+	if (words.length < 4) throw new IrCodecError("pronto-malformed", `Pronto code needs at least 4 words, got ${words.length}`);
+	const values = words.map((w) => /^[0-9a-fA-F]{1,4}$/.test(w) ? parseInt(w, 16) : NaN);
+	if (values.some((v) => Number.isNaN(v))) throw new IrCodecError("pronto-malformed", "Pronto code must be 4-digit hexadecimal words");
+	const [form, freqWord, introCount, repeatCount] = values;
+	if (form === void 0 || freqWord === void 0 || introCount === void 0 || repeatCount === void 0) throw new IrCodecError("pronto-malformed", "Pronto header incomplete");
+	if (form !== LEARNED_FORM) throw new IrCodecError("pronto-unsupported-form", `Pronto form ${words[0] ?? ""} is not supported, only the learned 0000 form`);
+	if (freqWord === 0) throw new IrCodecError("pronto-malformed", "Pronto frequency word is zero");
+	const pairs = introCount + repeatCount;
+	if (pairs === 0 || values.length !== 4 + pairs * 2) throw new IrCodecError("pronto-malformed", `Pronto declares ${pairs} burst pairs but carries ${(values.length - 4) / 2} word pairs`);
+	const unitUs = freqWord * PRONTO_CLOCK_US;
+	const timings = values.slice(4).map((count, index) => {
+		const us = Math.max(1, Math.round(count * unitUs));
+		return index % 2 === 0 ? us : -us;
+	});
+	const checked = IrTimingsSchema.safeParse(timings);
+	if (!checked.success) throw new IrCodecError("invalid-timings", `Pronto decoded to invalid timings: ${checked.error.message}`);
+	return {
+		timings: checked.data,
+		carrierHz: Math.round(1e6 / unitUs)
+	};
+}
+//#endregion
+//#region src/ir/ir-payload.ts
+/** What a remote command stores: a raw pulse train, or a learned Pronto code. */
+var IrPayloadSchema = zod.z.discriminatedUnion("kind", [zod.z.object({
+	kind: zod.z.literal("raw"),
+	timings: zod.z.array(zod.z.number().int()),
+	settings: TransmitSettingsSchema.optional()
+}), zod.z.object({
+	kind: zod.z.literal("pronto"),
+	code: zod.z.string()
+})]);
+/** Resolve a payload to what `ir-transmitter.send` takes. Throws `IrCodecError`. */
+function toTimings(payload) {
+	if (payload.kind === "pronto") {
+		const decoded = decodePronto(payload.code);
+		return {
+			timings: decoded.timings,
+			settings: { carrierHz: decoded.carrierHz }
+		};
+	}
+	const checked = IrTimingsSchema.safeParse(payload.timings);
+	if (!checked.success) throw new IrCodecError("invalid-timings", checked.error.message);
+	return {
+		timings: checked.data,
+		settings: payload.settings ?? {}
+	};
+}
+//#endregion
+//#region src/ir/smartir.ts
+/** SmartIR's own default pause between two commands, in seconds. */
+var DEFAULT_DELAY_S = .5;
+var SOURCES_KEY = "sources";
+var SmartIrDocumentSchema = zod.z.object({
+	manufacturer: zod.z.string().optional(),
+	supportedModels: zod.z.array(zod.z.string()).optional(),
+	supportedController: zod.z.string().optional(),
+	commandsEncoding: zod.z.string(),
+	delay: zod.z.number().nonnegative().optional(),
+	commands: zod.z.record(zod.z.string(), zod.z.unknown())
+});
+function describe(error) {
+	return error instanceof Error ? error.message : "unknown error";
+}
+function rawPayload(value) {
+	let parsed;
+	try {
+		parsed = JSON.parse(value);
+	} catch (error) {
+		throw new IrCodecError("invalid-raw", `Raw command is not a JSON array: ${describe(error)}`);
+	}
+	const checked = IrTimingsSchema.safeParse(parsed);
+	if (!checked.success) throw new IrCodecError("invalid-timings", checked.error.message);
+	return {
+		kind: "raw",
+		timings: checked.data
+	};
+}
+function prontoPayload(value) {
+	decodePronto(value);
+	return {
+		kind: "pronto",
+		code: value
+	};
+}
+/** Parse a SmartIR media_player JSON. Raw and Pronto are imported; other encodings are reported in `skipped`. */
+function parseSmartIr(document) {
+	const parsed = SmartIrDocumentSchema.safeParse(document);
+	if (!parsed.success) throw new IrCodecError("smartir-malformed", `Not a SmartIR document: ${parsed.error.message}`);
+	const doc = parsed.data;
+	const encoding = doc.commandsEncoding;
+	const entries = [];
+	for (const [name, value] of Object.entries(doc.commands)) if (name === SOURCES_KEY && typeof value === "object" && value !== null && !Array.isArray(value)) for (const [sourceName, sourceValue] of Object.entries(value)) entries.push({
+		name: sourceName,
+		group: "source",
+		value: sourceValue
+	});
+	else entries.push({
+		name,
+		group: "command",
+		value
+	});
+	const commands = [];
+	const skipped = [];
+	const supported = encoding === "Raw" || encoding === "Pronto";
+	for (const { name, group, value } of entries) {
+		if (!supported) {
+			skipped.push({
+				name,
+				group,
+				reason: `${encoding} encoding is not supported`
+			});
+			continue;
+		}
+		if (typeof value !== "string") {
+			skipped.push({
+				name,
+				group,
+				reason: "command is not a string"
+			});
+			continue;
+		}
+		try {
+			commands.push({
+				name,
+				group,
+				payload: encoding === "Raw" ? rawPayload(value) : prontoPayload(value)
+			});
+		} catch (error) {
+			skipped.push({
+				name,
+				group,
+				reason: describe(error)
+			});
+		}
+	}
+	return {
+		table: {
+			commands,
+			interCommandDelayMs: Math.round((doc.delay ?? DEFAULT_DELAY_S) * 1e3),
+			origin: {
+				format: "smartir",
+				manufacturer: doc.manufacturer,
+				models: doc.supportedModels,
+				controller: doc.supportedController
+			}
+		},
+		skipped
+	};
+}
+//#endregion
 exports.ACCESSORY_LABEL = ACCESSORY_LABEL;
 exports.ACCESS_ROLES = ACCESS_ROLES;
 exports.ACTIVE_CRITERIA = require_composition.ACTIVE_CRITERIA;
@@ -120551,6 +120853,7 @@ exports.INITIAL_SPAN = INITIAL_SPAN;
 exports.INTEGRAL_OUTPUTS = require_composition.INTEGRAL_OUTPUTS;
 exports.INTERNAL_ACTION_PREFIX = INTERNAL_ACTION_PREFIX;
 exports.INVERTIBLE_CAPS = INVERTIBLE_CAPS;
+exports.IR_TIMINGS_MAX = IR_TIMINGS_MAX;
 exports.IconKeySchema = IconKeySchema;
 exports.ImageContractSchema = ImageContractSchema;
 exports.ImageContractStateSchema = ImageContractStateSchema;
@@ -120571,6 +120874,12 @@ exports.IntegrationWithStateSchema = IntegrationWithStateSchema;
 exports.IntercomAbilitySchema = IntercomAbilitySchema;
 exports.IntercomStatusSchema = IntercomStatusSchema;
 exports.InvalidRecordError = require_sleep.InvalidRecordError;
+exports.IrCodecError = IrCodecError;
+exports.IrMediumSchema = IrMediumSchema;
+exports.IrPayloadSchema = IrPayloadSchema;
+exports.IrSendResultSchema = IrSendResultSchema;
+exports.IrTimingsSchema = IrTimingsSchema;
+exports.IrTransmitterInfoSchema = IrTransmitterInfoSchema;
 exports.KEYCHAIN_MAX_REFS_PER_CALL = KEYCHAIN_MAX_REFS_PER_CALL;
 exports.KEYCHAIN_RESET_CONFIRMATION = KEYCHAIN_RESET_CONFIRMATION;
 exports.KEYCHAIN_RESET_TRIGGER_ACTOR = KEYCHAIN_RESET_TRIGGER_ACTOR;
@@ -121722,6 +122031,8 @@ exports.TrainingResultSchema = TrainingResultSchema;
 exports.TrainingSplitPlanSchema = TrainingSplitPlanSchema;
 exports.TrainingStageSchema = TrainingStageSchema;
 exports.TransactRefusedError = require_sleep.TransactRefusedError;
+exports.TransmitSettingKeySchema = TransmitSettingKeySchema;
+exports.TransmitSettingsSchema = TransmitSettingsSchema;
 exports.TransportPlaneCountsSchema = TransportPlaneCountsSchema;
 exports.TransportPlaneSchema = TransportPlaneSchema;
 exports.TurnServerSchema = TurnServerSchema;
@@ -122067,6 +122378,7 @@ exports.declareLogChannel = declareLogChannel;
 exports.declaredSeriesKind = declaredSeriesKind;
 exports.decodeCompositionToCards = decodeCompositionToCards;
 exports.decodeKeyedArrayOverride = decodeKeyedArrayOverride;
+exports.decodePronto = decodePronto;
 exports.decodePulseOverride = decodePulseOverride;
 exports.decodeScalarOverride = decodeScalarOverride;
 exports.decodeVectorBase64 = decodeVectorBase64;
@@ -122282,6 +122594,7 @@ exports.interpretStoredClusterModel = interpretStoredClusterModel;
 exports.invalidClusterStepModelEntries = invalidClusterStepModelEntries;
 exports.invertPresetFeature = invertPresetFeature;
 exports.invocationFromEncodeProfile = require_composition.invocationFromEncodeProfile;
+exports.irTransmitterCapability = irTransmitterCapability;
 exports.isAgentOnlyPlacement = isAgentOnlyPlacement;
 exports.isAlarmControllableCap = isAlarmControllableCap;
 exports.isAlertEpisodeOpen = isAlertEpisodeOpen;
@@ -122520,6 +122833,7 @@ exports.parseSecretRef = require_sleep.parseSecretRef;
 exports.parseSecretStatePath = require_sleep.parseSecretStatePath;
 exports.parseSessionPlacementPolicy = parseSessionPlacementPolicy;
 exports.parseShareSource = parseShareSource;
+exports.parseSmartIr = parseSmartIr;
 exports.parseStreamParamsFormPatch = parseStreamParamsFormPatch;
 exports.parseTrainingEventLine = parseTrainingEventLine;
 exports.patchAudio = patchAudio;
@@ -122856,6 +123170,7 @@ exports.toNodeId = require_sleep.toNodeId;
 exports.toPercentShares = toPercentShares;
 exports.toSecretFieldView = require_sleep.toSecretFieldView;
 exports.toStreamSourceEntry = toStreamSourceEntry;
+exports.toTimings = toTimings;
 exports.toastCapability = toastCapability;
 exports.toggleAudioLabel = toggleAudioLabel;
 exports.tokenize = require_composition.tokenize;