homebridge-powerview-universal 4.3.2

package/dist/settings.d.ts

@@ -0,0 +1,102 @@
+import type { PlatformConfig } from 'homebridge';
+/**
+ * Platform name users put in config.json as `"platform": "PowerView"`.
+ */
+export declare const PLATFORM_NAME = "PowerView";
+/**
+ * Must match package.json `name` — used when registering platform accessories.
+ */
+export declare const PLUGIN_NAME = "homebridge-powerview-universal";
+export declare const SHADE_POLL_INTERVAL_MS = 30000;
+/**
+ * Consecutive hub shade lists a shade must be absent from before its accessory
+ * is unregistered. Removal is irreversible for the user's rooms and automations,
+ * so a single short response must never trigger it.
+ */
+export declare const SHADE_REMOVAL_THRESHOLD = 3;
+/**
+ * How long a shade takes to travel its full range. Used to animate HomeKit's
+ * position while the motor runs, rather than reporting arrival on command.
+ */
+export declare const SHADE_FULL_TRAVEL_MS = 20000;
+/** Floor on an estimated travel, so a tiny nudge still reads as movement. */
+export declare const SHADE_MIN_TRAVEL_MS = 1000;
+/** Minimum gap between cheap background reads of the same shade. */
+export declare const BACKGROUND_REFRESH_INTERVAL_MS = 10000;
+/**
+ * Default local time for the optional daily battery poll (API: updateBatteryLevel).
+ *
+ * The poll is opt-in — see resolveBatteryPollSettings. It is an RF round-trip
+ * that wakes the shade motor: audible, and it nudges the shade.
+ */
+export declare const BATTERY_POLL_DEFAULT_AT = "14:00";
+/**
+ * Default quiet window (local time) for anything that actuates hardware.
+ * Homebridge can restart unattended, so a startup position sync must not be
+ * free to wake five motors at 03:00.
+ */
+export declare const QUIET_START_HOUR = 21;
+export declare const QUIET_END_HOUR = 8;
+export declare enum ShadeKind {
+    ROLLER = 1,
+    TOP_BOTTOM = 2,
+    HORIZONTAL = 3,
+    VERTICAL = 4,
+    /** Capability 6. Primary rail runs reversed relative to bottom-up shades. */
+    TOP_DOWN = 5,
+    /** Capability 2. Tilt spans 180 degrees, not the 90 that HORIZONTAL assumes. */
+    HORIZONTAL_180 = 6,
+    /** Capability 5. Tilt only, no lift. */
+    TILT_ONLY = 7,
+    /** Capabilities 8 and 9. Duolite / overlapped panels. */
+    DUAL_OVERLAPPED = 8
+}
+/**
+ * Shade type -> ShadeCapabilities, from the PowerView Hub REST API v2 appendix
+ * (jlaur/hdpowerview-doc v1.0.4). The official specification leaves the
+ * ShadeType schema empty, so this table is the only published mapping.
+ */
+export declare const SHADE_TYPE_CAPABILITY: Readonly<Record<number, number>>;
+/** Kinds whose position and tilt maths this plugin actually implements. */
+export declare const FULLY_SUPPORTED_KINDS: readonly ShadeKind[];
+export declare const SUBTYPE: {
+    readonly BOTTOM: "bottom";
+    readonly TOP: "top";
+};
+/** Context stored on a scene accessory, to tell it from a shade on restore. */
+export interface SceneContext {
+    sceneId: number;
+}
+export interface PowerViewPlatformConfig extends PlatformConfig {
+    host?: string;
+    refreshShades?: boolean;
+    pollShadesForUpdate?: boolean;
+    strictErrors?: boolean;
+    /** Spacing between serialised hub requests, ms. Raise it if your hub struggles. */
+    requestIntervalMs?: number;
+    /** Expose hub scenes as HomeKit switches. Nothing appears if none are defined. */
+    exposeScenes?: boolean;
+    /** Opt in to the daily battery poll. Off by default: it wakes the shade motor. */
+    batteryPolling?: boolean;
+    /** Local "HH:MM" time for the daily battery poll. Defaults to 14:00. */
+    batteryPollAt?: string;
+    /** Re-sync positions over RF once at startup. Defaults to true. */
+    syncPositionsOnStart?: boolean;
+    /** Local-time window in which nothing may actuate hardware. `false` disables it. */
+    quietHours?: {
+        start: number;
+        end: number;
+    } | false;
+    forceRollerShades?: number[];
+    forceTopBottomShades?: number[];
+    forceHorizontalShades?: number[];
+    forceVerticalShades?: number[];
+}
+export interface ShadeContext {
+    shadeId: number;
+    shadeType: ShadeKind;
+    /** False when the hub rejected motion jog for this shade. */
+    jogSupported?: boolean;
+    /** Last known positions, persisted so a restart does not report 0. */
+    lastPositions?: Partial<Record<number, number>>;
+}

package/dist/settings.js

@@ -0,0 +1,75 @@
+/**
+ * Platform name users put in config.json as `"platform": "PowerView"`.
+ */
+export const PLATFORM_NAME = 'PowerView';
+/**
+ * Must match package.json `name` — used when registering platform accessories.
+ */
+export const PLUGIN_NAME = 'homebridge-powerview-universal';
+export const SHADE_POLL_INTERVAL_MS = 30_000;
+/**
+ * Consecutive hub shade lists a shade must be absent from before its accessory
+ * is unregistered. Removal is irreversible for the user's rooms and automations,
+ * so a single short response must never trigger it.
+ */
+export const SHADE_REMOVAL_THRESHOLD = 3;
+/**
+ * How long a shade takes to travel its full range. Used to animate HomeKit's
+ * position while the motor runs, rather than reporting arrival on command.
+ */
+export const SHADE_FULL_TRAVEL_MS = 20_000;
+/** Floor on an estimated travel, so a tiny nudge still reads as movement. */
+export const SHADE_MIN_TRAVEL_MS = 1_000;
+/** Minimum gap between cheap background reads of the same shade. */
+export const BACKGROUND_REFRESH_INTERVAL_MS = 10_000;
+/**
+ * Default local time for the optional daily battery poll (API: updateBatteryLevel).
+ *
+ * The poll is opt-in — see resolveBatteryPollSettings. It is an RF round-trip
+ * that wakes the shade motor: audible, and it nudges the shade.
+ */
+export const BATTERY_POLL_DEFAULT_AT = '14:00';
+/**
+ * Default quiet window (local time) for anything that actuates hardware.
+ * Homebridge can restart unattended, so a startup position sync must not be
+ * free to wake five motors at 03:00.
+ */
+export const QUIET_START_HOUR = 21;
+export const QUIET_END_HOUR = 8;
+export var ShadeKind;
+(function (ShadeKind) {
+    ShadeKind[ShadeKind["ROLLER"] = 1] = "ROLLER";
+    ShadeKind[ShadeKind["TOP_BOTTOM"] = 2] = "TOP_BOTTOM";
+    ShadeKind[ShadeKind["HORIZONTAL"] = 3] = "HORIZONTAL";
+    ShadeKind[ShadeKind["VERTICAL"] = 4] = "VERTICAL";
+    /** Capability 6. Primary rail runs reversed relative to bottom-up shades. */
+    ShadeKind[ShadeKind["TOP_DOWN"] = 5] = "TOP_DOWN";
+    /** Capability 2. Tilt spans 180 degrees, not the 90 that HORIZONTAL assumes. */
+    ShadeKind[ShadeKind["HORIZONTAL_180"] = 6] = "HORIZONTAL_180";
+    /** Capability 5. Tilt only, no lift. */
+    ShadeKind[ShadeKind["TILT_ONLY"] = 7] = "TILT_ONLY";
+    /** Capabilities 8 and 9. Duolite / overlapped panels. */
+    ShadeKind[ShadeKind["DUAL_OVERLAPPED"] = 8] = "DUAL_OVERLAPPED";
+})(ShadeKind || (ShadeKind = {}));
+/**
+ * Shade type -> ShadeCapabilities, from the PowerView Hub REST API v2 appendix
+ * (jlaur/hdpowerview-doc v1.0.4). The official specification leaves the
+ * ShadeType schema empty, so this table is the only published mapping.
+ */
+export const SHADE_TYPE_CAPABILITY = {
+    1: 0, 4: 0, 5: 0, 6: 0, 7: 6, 8: 7, 9: 7, 18: 1, 23: 1, 38: 9,
+    42: 0, 43: 1, 44: 1, 47: 7, 49: 0, 51: 2, 54: 3, 55: 3, 56: 3,
+    62: 2, 65: 8, 66: 5, 69: 4, 70: 4, 71: 4, 79: 8,
+};
+/** Kinds whose position and tilt maths this plugin actually implements. */
+export const FULLY_SUPPORTED_KINDS = [
+    ShadeKind.ROLLER,
+    ShadeKind.TOP_BOTTOM,
+    ShadeKind.HORIZONTAL,
+    ShadeKind.VERTICAL,
+];
+export const SUBTYPE = {
+    BOTTOM: 'bottom',
+    TOP: 'top',
+};
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gCAAgC,CAAC;AAE5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC3C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAEzC,oEAAoE;AACpE,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,6CAAU,CAAA;IACV,qDAAc,CAAA;IACd,qDAAc,CAAA;IACd,iDAAY,CAAA;IACZ,6EAA6E;IAC7E,iDAAY,CAAA;IACZ,gFAAgF;IAChF,6DAAkB,CAAA;IAClB,wCAAwC;IACxC,mDAAa,CAAA;IACb,yDAAyD;IACzD,+DAAmB,CAAA;AACrB,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAqC;IACrE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC7D,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IAC7D,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;CAChD,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAyB;IACzD,SAAS,CAAC,MAAM;IAChB,SAAS,CAAC,UAAU;IACpB,SAAS,CAAC,UAAU;IACpB,SAAS,CAAC,QAAQ;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,MAAM,EAAE,QAAQ;IAChB,GAAG,EAAE,KAAK;CACF,CAAC"}

package/dist/shadeUtils.d.ts

@@ -0,0 +1,138 @@
+import { HubPosition, type ShadePositions } from './powerviewHub.js';
+import { ShadeKind, type PowerViewPlatformConfig } from './settings.js';
+export interface TimeOfDay {
+    hour: number;
+    minute: number;
+}
+export interface BatteryPollSettings {
+    enabled: boolean;
+    at: TimeOfDay;
+}
+/** Parses an "HH:MM" local time. Returns null on anything malformed. */
+export declare function parseTimeOfDay(value: unknown): TimeOfDay | null;
+/**
+ * Milliseconds from `now` until the next occurrence of `hour:minute` local time,
+ * rolling to tomorrow when today's slot has already passed.
+ *
+ * Callers must recompute this from a fresh Date after every run rather than
+ * adding 24h to the previous deadline: only recomputing keeps the poll pinned to
+ * the same wall-clock time across a DST change.
+ */
+export declare function msUntilNextDailyRun(now: Date, hour: number, minute: number): number;
+/**
+ * Resolves battery-poll timing from user config.
+ *
+ * Polling is opt-in: `updateBatteryLevel=true` is an RF round-trip that audibly
+ * wakes the shade motor and nudges the shade, so a default-on timer actuates
+ * hardware in someone's home that they never asked for. Battery state still
+ * reaches HomeKit from ordinary hub reads; this poll only forces a fresh
+ * measurement.
+ */
+export declare function resolveBatteryPollSettings(config: Partial<PowerViewPlatformConfig>): BatteryPollSettings;
+export declare function decodeBase64Name(encoded: string | undefined, fallback: string): string;
+/** A shade's reported positions, keyed by position kind. */
+export type PositionMap = Partial<Record<HubPosition, number>>;
+/** API PositionKind value when the hub reports a position error. */
+export declare const POSITION_KIND_ERROR = 4;
+/**
+ * How many posKindN/positionN pairs a shade response may carry. The hub uses
+ * two in practice; the loop is bounded rather than stopping at the first gap.
+ */
+export declare const MAX_POSITION_KINDS = 4;
+export declare function isValidPositionKind(kind: number): boolean;
+/**
+ * Builds a map of position kind → hub value, skipping invalid/error kinds.
+ */
+export declare function parsePositionMap(positions: ShadePositions): Partial<Record<HubPosition, number>>;
+/**
+ * Serializes a position map back to hub posKindN/positionN fields.
+ */
+export declare function serializePositionMap(positions: Record<number, number>): ShadePositions;
+/**
+ * Nominal pack voltage in tenths of a volt. Gen 1/2 hubs report `batteryStrength`
+ * as tenths of a volt (e.g. 146 = 14.6V) against an 18.0V nominal pack, NOT as a
+ * percentage. Matches the conversion used by aiopvapi / Home Assistant.
+ */
+export declare const BATTERY_NOMINAL_TENTHS_VOLT = 180;
+/** Percentage at or below which HomeKit should show a low-battery warning. */
+export declare const LOW_BATTERY_PERCENT = 20;
+/**
+ * Converts a hub `batteryStrength` (tenths of a volt) to a 0-100 percentage.
+ * Returns undefined when the value is absent or 0 — the hub reports 0 for shades
+ * it has not polled yet, which is "unknown", not "empty".
+ */
+export declare function batteryStrengthToPercent(batteryStrength?: number): number | undefined;
+/** BatteryStatus: 0 = none, 1 = low, 2 = medium, 3 = high, 4 = plugged in. */
+export declare function isLowBattery(batteryStatus?: number, batteryStrength?: number): boolean;
+export interface BatteryReading {
+    /** HomeKit BatteryLevel (0–100). */
+    level: number;
+    low: boolean;
+    /** Hub reports mains-powered (BatteryStatus plugged in). */
+    mainsPowered: boolean;
+}
+/**
+ * Maps PowerView shade battery fields to HomeKit Battery service values.
+ * Returns undefined when the hub provides no usable battery data.
+ */
+export declare function resolveBatteryReading(batteryStatus?: number, batteryStrength?: number): BatteryReading | undefined;
+export declare function formatShadeFirmware(firmware?: {
+    revision: number;
+    subRevision: number;
+    build: number;
+}): string | undefined;
+export type PositionLookup = {
+    kind: 'ok';
+    value: number;
+} | {
+    kind: 'missing';
+} | {
+    kind: 'invalid';
+    value: unknown;
+};
+/**
+ * Distinguishes "the hub did not report this position" from "the hub reported
+ * something unusable".
+ *
+ * The distinction is not academic: a PowerView Gen 2 hub returns no `positions`
+ * object at all on a cached read — positions exist only after a `refresh=true`
+ * read or a set — so `missing` is the normal path on every HomeKit read, while
+ * `invalid` means the hub really did send bad data. Collapsing the two logged a
+ * warning on the happy path 77 times a day and pointed diagnosis at the hub's
+ * values when the hub had sent no values at all.
+ */
+export declare function lookupPosition(positions: PositionMap, position: HubPosition): PositionLookup;
+/**
+ * Validates a position map restored from persisted accessory context, which is
+ * plain JSON written by an earlier run and must not be trusted structurally.
+ */
+export declare function sanitizePositionMap(value: unknown): PositionMap;
+/** Shallow equality for position maps, treating a missing map as empty. */
+export declare function positionMapsEqual(a: PositionMap | undefined, b: PositionMap | undefined): boolean;
+export interface QuietHours {
+    /** Start of the quiet window, inclusive. Equal to endHour means "no quiet window". */
+    startHour: number;
+    /** End of the quiet window, exclusive. */
+    endHour: number;
+}
+/**
+ * True when `date`'s local hour falls in [startHour, endHour), wrapping across
+ * midnight when startHour > endHour. An empty window is never within.
+ */
+export declare function isWithinQuietHours(date: Date, startHour: number, endHour: number): boolean;
+/** Resolves the window during which the plugin must not actuate hardware. */
+export declare function resolveQuietHours(config: Partial<PowerViewPlatformConfig>): QuietHours;
+/**
+ * Resolves a shade's ShadeCapabilities value: the hub's own `capabilities`
+ * field when it reports one, otherwise the documented type table.
+ *
+ * Capability is the right axis, not `type`: 26 published types collapse onto
+ * 10 capability classes, and behaviour (reversed rail, tilt range, dual
+ * panels) follows the capability. Older hubs omit the field entirely.
+ */
+export declare function resolveShadeCapability(shade: {
+    type?: number;
+    capabilities?: number;
+}): number | undefined;
+/** Maps a ShadeCapabilities value onto the kind the plugin drives it as. */
+export declare function shadeKindForCapability(capability: number): ShadeKind | undefined;

package/dist/shadeUtils.js

@@ -0,0 +1,292 @@
+import { HubPosition } from './powerviewHub.js';
+import { BATTERY_POLL_DEFAULT_AT, SHADE_TYPE_CAPABILITY, ShadeKind, QUIET_END_HOUR, QUIET_START_HOUR, } from './settings.js';
+/** Parses an "HH:MM" local time. Returns null on anything malformed. */
+export function parseTimeOfDay(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const match = /^(\d{1,2}):(\d{2})$/.exec(value.trim());
+    if (!match) {
+        return null;
+    }
+    const hour = Number(match[1]);
+    const minute = Number(match[2]);
+    return hour <= 23 && minute <= 59 ? { hour, minute } : null;
+}
+/**
+ * Milliseconds from `now` until the next occurrence of `hour:minute` local time,
+ * rolling to tomorrow when today's slot has already passed.
+ *
+ * Callers must recompute this from a fresh Date after every run rather than
+ * adding 24h to the previous deadline: only recomputing keeps the poll pinned to
+ * the same wall-clock time across a DST change.
+ */
+export function msUntilNextDailyRun(now, hour, minute) {
+    const next = new Date(now);
+    next.setHours(hour, minute, 0, 0);
+    if (next.getTime() <= now.getTime()) {
+        next.setDate(next.getDate() + 1);
+        next.setHours(hour, minute, 0, 0);
+    }
+    return next.getTime() - now.getTime();
+}
+/**
+ * Resolves battery-poll timing from user config.
+ *
+ * Polling is opt-in: `updateBatteryLevel=true` is an RF round-trip that audibly
+ * wakes the shade motor and nudges the shade, so a default-on timer actuates
+ * hardware in someone's home that they never asked for. Battery state still
+ * reaches HomeKit from ordinary hub reads; this poll only forces a fresh
+ * measurement.
+ */
+export function resolveBatteryPollSettings(config) {
+    return {
+        enabled: config.batteryPolling === true,
+        at: parseTimeOfDay(config.batteryPollAt) ?? parseTimeOfDay(BATTERY_POLL_DEFAULT_AT),
+    };
+}
+export function decodeBase64Name(encoded, fallback) {
+    if (!encoded) {
+        return fallback;
+    }
+    try {
+        return Buffer.from(encoded, 'base64').toString();
+    }
+    catch {
+        return encoded;
+    }
+}
+/** API PositionKind value when the hub reports a position error. */
+export const POSITION_KIND_ERROR = 4;
+/**
+ * How many posKindN/positionN pairs a shade response may carry. The hub uses
+ * two in practice; the loop is bounded rather than stopping at the first gap.
+ */
+export const MAX_POSITION_KINDS = 4;
+export function isValidPositionKind(kind) {
+    return kind >= HubPosition.BOTTOM && kind <= HubPosition.VANES;
+}
+/**
+ * Builds a map of position kind → hub value, skipping invalid/error kinds.
+ */
+export function parsePositionMap(positions) {
+    const map = {};
+    for (let i = 1; positions[`posKind${i}`] != null; ++i) {
+        const kind = positions[`posKind${i}`];
+        if (kind === POSITION_KIND_ERROR || !isValidPositionKind(kind)) {
+            continue;
+        }
+        map[kind] = positions[`position${i}`];
+    }
+    return map;
+}
+/**
+ * Serializes a position map back to hub posKindN/positionN fields.
+ */
+export function serializePositionMap(positions) {
+    const result = {};
+    let i = 1;
+    for (const key of Object.keys(positions).sort((a, b) => Number(a) - Number(b))) {
+        const kind = parseInt(key, 10);
+        if (kind === POSITION_KIND_ERROR || !isValidPositionKind(kind)) {
+            continue;
+        }
+        result[`posKind${i}`] = kind;
+        result[`position${i}`] = positions[kind];
+        ++i;
+    }
+    return result;
+}
+/**
+ * Nominal pack voltage in tenths of a volt. Gen 1/2 hubs report `batteryStrength`
+ * as tenths of a volt (e.g. 146 = 14.6V) against an 18.0V nominal pack, NOT as a
+ * percentage. Matches the conversion used by aiopvapi / Home Assistant.
+ */
+export const BATTERY_NOMINAL_TENTHS_VOLT = 180;
+/** Percentage at or below which HomeKit should show a low-battery warning. */
+export const LOW_BATTERY_PERCENT = 20;
+/**
+ * Converts a hub `batteryStrength` (tenths of a volt) to a 0-100 percentage.
+ * Returns undefined when the value is absent or 0 — the hub reports 0 for shades
+ * it has not polled yet, which is "unknown", not "empty".
+ */
+export function batteryStrengthToPercent(batteryStrength) {
+    if (typeof batteryStrength !== 'number' || !Number.isFinite(batteryStrength)) {
+        return undefined;
+    }
+    if (batteryStrength <= 0) {
+        return undefined;
+    }
+    return Math.min(100, Math.round((batteryStrength / BATTERY_NOMINAL_TENTHS_VOLT) * 100));
+}
+/** BatteryStatus: 0 = none, 1 = low, 2 = medium, 3 = high, 4 = plugged in. */
+export function isLowBattery(batteryStatus, batteryStrength) {
+    if (batteryStatus === 1) {
+        return true;
+    }
+    const percent = batteryStrengthToPercent(batteryStrength);
+    if (percent != null) {
+        return percent <= LOW_BATTERY_PERCENT;
+    }
+    return false;
+}
+/**
+ * Maps PowerView shade battery fields to HomeKit Battery service values.
+ * Returns undefined when the hub provides no usable battery data.
+ */
+export function resolveBatteryReading(batteryStatus, batteryStrength) {
+    if (batteryStatus == null && batteryStrength == null) {
+        return undefined;
+    }
+    if (batteryStatus === 0) {
+        return undefined;
+    }
+    let level = batteryStrengthToPercent(batteryStrength);
+    if (level == null && batteryStatus != null) {
+        switch (batteryStatus) {
+            case 1:
+                level = 15;
+                break;
+            case 2:
+                level = 50;
+                break;
+            case 3:
+                level = 90;
+                break;
+            case 4:
+                level = 100;
+                break;
+            default:
+                return undefined;
+        }
+    }
+    if (level == null) {
+        return undefined;
+    }
+    return {
+        level,
+        low: isLowBattery(batteryStatus, batteryStrength),
+        mainsPowered: batteryStatus === 4,
+    };
+}
+export function formatShadeFirmware(firmware) {
+    if (!firmware) {
+        return undefined;
+    }
+    return `${firmware.revision}.${firmware.subRevision}.${firmware.build}`;
+}
+/**
+ * Distinguishes "the hub did not report this position" from "the hub reported
+ * something unusable".
+ *
+ * The distinction is not academic: a PowerView Gen 2 hub returns no `positions`
+ * object at all on a cached read — positions exist only after a `refresh=true`
+ * read or a set — so `missing` is the normal path on every HomeKit read, while
+ * `invalid` means the hub really did send bad data. Collapsing the two logged a
+ * warning on the happy path 77 times a day and pointed diagnosis at the hub's
+ * values when the hub had sent no values at all.
+ */
+export function lookupPosition(positions, position) {
+    if (!Object.prototype.hasOwnProperty.call(positions, position)) {
+        return { kind: 'missing' };
+    }
+    const value = positions[position];
+    return typeof value === 'number' && Number.isFinite(value)
+        ? { kind: 'ok', value }
+        : { kind: 'invalid', value };
+}
+/**
+ * Validates a position map restored from persisted accessory context, which is
+ * plain JSON written by an earlier run and must not be trusted structurally.
+ */
+export function sanitizePositionMap(value) {
+    const clean = {};
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return clean;
+    }
+    for (const [key, entry] of Object.entries(value)) {
+        const kind = Number(key);
+        if (!Number.isInteger(kind) || !isValidPositionKind(kind)) {
+            continue;
+        }
+        if (typeof entry === 'number' && Number.isFinite(entry)) {
+            clean[kind] = entry;
+        }
+    }
+    return clean;
+}
+/** Shallow equality for position maps, treating a missing map as empty. */
+export function positionMapsEqual(a, b) {
+    const left = a ?? {};
+    const right = b ?? {};
+    const leftKeys = Object.keys(left);
+    if (leftKeys.length !== Object.keys(right).length) {
+        return false;
+    }
+    return leftKeys.every((key) => {
+        const kind = Number(key);
+        return Object.prototype.hasOwnProperty.call(right, kind) && left[kind] === right[kind];
+    });
+}
+/**
+ * True when `date`'s local hour falls in [startHour, endHour), wrapping across
+ * midnight when startHour > endHour. An empty window is never within.
+ */
+export function isWithinQuietHours(date, startHour, endHour) {
+    if (startHour === endHour) {
+        return false;
+    }
+    const hour = date.getHours();
+    return startHour < endHour
+        ? hour >= startHour && hour < endHour
+        : hour >= startHour || hour < endHour;
+}
+/** Resolves the window during which the plugin must not actuate hardware. */
+export function resolveQuietHours(config) {
+    const quiet = config.quietHours;
+    if (quiet === false) {
+        return { startHour: 0, endHour: 0 };
+    }
+    if (quiet
+        && Number.isInteger(quiet.start) && quiet.start >= 0 && quiet.start <= 23
+        && Number.isInteger(quiet.end) && quiet.end >= 0 && quiet.end <= 23) {
+        return { startHour: quiet.start, endHour: quiet.end };
+    }
+    return { startHour: QUIET_START_HOUR, endHour: QUIET_END_HOUR };
+}
+/**
+ * Resolves a shade's ShadeCapabilities value: the hub's own `capabilities`
+ * field when it reports one, otherwise the documented type table.
+ *
+ * Capability is the right axis, not `type`: 26 published types collapse onto
+ * 10 capability classes, and behaviour (reversed rail, tilt range, dual
+ * panels) follows the capability. Older hubs omit the field entirely.
+ */
+export function resolveShadeCapability(shade) {
+    const reported = shade.capabilities;
+    if (typeof reported === 'number' && Number.isInteger(reported) && reported >= 0 && reported <= 9) {
+        return reported;
+    }
+    const type = shade.type;
+    if (typeof type !== 'number') {
+        return undefined;
+    }
+    return SHADE_TYPE_CAPABILITY[type];
+}
+/** Maps a ShadeCapabilities value onto the kind the plugin drives it as. */
+export function shadeKindForCapability(capability) {
+    switch (capability) {
+        case 0: return ShadeKind.ROLLER;
+        case 1: return ShadeKind.HORIZONTAL;
+        case 2: return ShadeKind.HORIZONTAL_180;
+        case 3:
+        case 4: return ShadeKind.VERTICAL;
+        case 5: return ShadeKind.TILT_ONLY;
+        case 6: return ShadeKind.TOP_DOWN;
+        case 7: return ShadeKind.TOP_BOTTOM;
+        case 8:
+        case 9: return ShadeKind.DUAL_OVERLAPPED;
+        default: return undefined;
+    }
+}
+//# sourceMappingURL=shadeUtils.js.map

package/dist/shadeUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadeUtils.js","sourceRoot":"","sources":["../src/shadeUtils.ts"],"names":[],"mappings":"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"}