@flighthq/power 0.3.1-next.975.01aea94 → 0.4.0-edge.1908.751021c

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { attachPower, createPower, detachPower, disposePower, enablePowerSignals, getPowerBatteryHealth, getPowerIdlePollingIntervalMs, getPowerStatus, getPowerSystemIdleState, getPowerSystemIdleTime, getPowerThermalState, hasPowerKeepAwake, setPowerIdlePollingIntervalMs, setPowerKeepAwake, } from './contract';
+export { attachPower, createPower, detachPower, disposePower, enablePowerSignals, explainPowerBackend, getPowerBatteryHealth, getPowerIdlePollingIntervalMs, getPowerStatus, getPowerSystemIdleState, getPowerSystemIdleTime, getPowerThermalState, hasPowerKeepAwake, setPowerIdlePollingIntervalMs, setPowerKeepAwake, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { attachPower, createPower, detachPower, disposePower, enablePowerSignals, getPowerBatteryHealth, getPowerIdlePollingIntervalMs, getPowerStatus, getPowerSystemIdleState, getPowerSystemIdleTime, getPowerThermalState, hasPowerKeepAwake, setPowerIdlePollingIntervalMs, setPowerKeepAwake, } from './contract';
+export { attachPower, createPower, detachPower, disposePower, enablePowerSignals, explainPowerBackend, getPowerBatteryHealth, getPowerIdlePollingIntervalMs, getPowerStatus, getPowerSystemIdleState, getPowerSystemIdleTime, getPowerThermalState, hasPowerKeepAwake, setPowerIdlePollingIntervalMs, setPowerKeepAwake, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,6BAA6B,EAC7B,cAAc,EACd,uBAAuB,EACvB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,6BAA6B,EAC7B,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/power.d.ts

@@ -1,12 +1,13 @@
+import type { BackendExplanation } from '@flighthq/types/contract';
 import type { Power, PowerBackend, PowerBatteryHealth, PowerIdleState, PowerKeepAwakeMode, PowerStatus, PowerThermalState } from '@flighthq/types/contract';
 export declare function attachPower(power: Power, idleThresholdSeconds?: number): void;
 export declare function createPower(): Power;
 export declare function createPowerBatteryHealth(): PowerBatteryHealth;
 export declare function createPowerStatus(): PowerStatus;
-export declare function createWebPowerBackend(): PowerBackend;
 export declare function detachPower(power: Power): void;
 export declare function disposePower(power: Power): void;
 export declare function enablePowerSignals(power: Power): void;
+export declare function explainPowerBackend(): BackendExplanation;
 export declare function getPowerBackend(): PowerBackend;
 export declare function getPowerBatteryHealth(out: PowerBatteryHealth): PowerBatteryHealth | null;
 export declare function getPowerIdlePollingIntervalMs(): number;
@@ -15,6 +16,9 @@ export declare function getPowerSystemIdleState(thresholdSeconds: number): Power
 export declare function getPowerSystemIdleTime(): number;
 export declare function getPowerThermalState(): PowerThermalState;
 export declare function hasPowerKeepAwake(): boolean;
+export declare function installPowerHostBackend(backend: PowerBackend): void;
+export declare function observePowerHostResult(operation: string, succeeded: boolean): void;
+export declare function resetPowerBackendForTest(): void;
 export declare function setPowerBackend(backend: PowerBackend | null): void;
 export declare function setPowerIdlePollingIntervalMs(intervalMs: number): void;
 export declare function setPowerKeepAwake(enabled: boolean, mode?: PowerKeepAwakeMode): boolean;

package/dist/power.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"power.d.ts","sourceRoot":"","sources":["../src/power.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,oBAAoB,SAAK,GAAG,IAAI,CAyDzE;AAID,wBAAgB,WAAW,IAAI,KAAK,CAanC;AAGD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAQ7D;AAGD,wBAAgB,iBAAiB,IAAI,WAAW,CAW/C;AAID,wBAAgB,qBAAqB,IAAI,YAAY,CA0JpD;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAM9C;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE/C;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAWrD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAExF;AAGD,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAE5D;AAGD,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAEhF;AAGD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAGD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAKD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtE;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAEtF"}
+{"version":3,"file":"power.d.ts","sourceRoot":"","sources":["../src/power.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,oBAAoB,SAAK,GAAG,IAAI,CAyDzE;AAID,wBAAgB,WAAW,IAAI,KAAK,CAanC;AAGD,wBAAgB,wBAAwB,IAAI,kBAAkB,CAQ7D;AAGD,wBAAgB,iBAAiB,IAAI,WAAW,CAW/C;AAGD,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAM9C;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE/C;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAWrD;AAED,wBAAgB,mBAAmB,IAAI,kBAAkB,CAaxD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,kBAAkB,GAAG,kBAAkB,GAAG,IAAI,CAExF;AAGD,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAGD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAE5D;AAGD,wBAAgB,uBAAuB,CAAC,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAEhF;AAGD,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAGD,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAGD,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAMnE;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKlF;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAK/C;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAElE;AAKD,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAEtE;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAEtF"}

package/dist/power.js

@@ -110,174 +110,6 @@ export function createPowerStatus() {
         thermalState: 'Unknown',
     };
 }
-// Builds the default web backend over the Battery Status API and the Screen Wake Lock API. Degrades
-// to batteryLevel=-1 / not charging and a no-op subscription where the APIs are absent.
-export function createWebPowerBackend() {
-    let cachedLevel = -1;
-    let cachedCharging = false;
-    let cachedChargingTime = -1;
-    let cachedDischargingTime = -1;
-    return {
-        getBatteryHealth(_out) {
-            // Browser Battery Status API does not expose health information.
-            return null;
-        },
-        isKeepAwakeActive() {
-            return _wakeLockSentinel !== null;
-        },
-        getStatus(out) {
-            // Read all input values first (alias-safe: out may be the same object as an input).
-            const level = cachedLevel;
-            const charging = cachedCharging;
-            const chargingTime = cachedChargingTime;
-            const dischargingTime = cachedDischargingTime;
-            out.batteryLevel = level;
-            out.chargingTime = chargingTime;
-            out.dischargingTime = dischargingTime;
-            out.isBatteryLow = level >= 0 && level <= 0.2 && !charging;
-            out.isCharging = charging;
-            // Web Battery Status API: isOnBattery = device has a battery and is not charging/AC.
-            // If level is -1 (API absent), we cannot determine the power source; use false as sentinel.
-            out.isOnBattery = level >= 0 && !charging;
-            // No real OS low-power-mode read available on web; use false as sentinel.
-            out.isLowPower = false;
-            out.thermalState = 'Unknown';
-            return out;
-        },
-        getSystemIdleState(_thresholdSeconds) {
-            // The Idle Detection API is permission-gated and not widely available; return sentinel.
-            return 'Unknown';
-        },
-        getSystemIdleTime() {
-            // No idle-time API available on web; return sentinel.
-            return -1;
-        },
-        setKeepAwake(enabled, mode) {
-            const resolvedMode = mode ?? 'PreventDisplaySleep';
-            // Web only supports display-sleep prevention via the Screen Wake Lock API.
-            if (resolvedMode === 'PreventAppSuspension')
-                return false;
-            if (typeof navigator === 'undefined')
-                return false;
-            const wakeLock = navigator.wakeLock;
-            if (wakeLock === undefined)
-                return false;
-            try {
-                if (!enabled) {
-                    _wakeLockSentinel?.release?.().catch(() => { });
-                    _wakeLockSentinel = null;
-                    return true;
-                }
-                wakeLock
-                    .request('screen')
-                    .then((sentinel) => {
-                    _wakeLockSentinel = sentinel;
-                    // Re-acquire the lock after visibility is restored; browsers auto-release it when the
-                    // tab goes hidden.
-                    sentinel.addEventListener?.('release', () => {
-                        if (_wakeLockSentinel === sentinel && !document.hidden) {
-                            wakeLock
-                                .request('screen')
-                                .then((newSentinel) => {
-                                if (_wakeLockSentinel === sentinel)
-                                    _wakeLockSentinel = newSentinel;
-                            })
-                                .catch(() => { });
-                        }
-                    });
-                })
-                    .catch(() => { });
-                return true;
-            }
-            catch {
-                return false;
-            }
-        },
-        subscribe(listener) {
-            const battery = getWebBatteryManagerPromise();
-            if (battery === null)
-                return () => { };
-            let manager = null;
-            const onLevelChange = () => {
-                if (manager !== null)
-                    cachedLevel = manager.level;
-                listener();
-            };
-            const onChargingChange = () => {
-                if (manager !== null)
-                    cachedCharging = manager.charging;
-                listener();
-            };
-            const onChargingTimeChange = () => {
-                if (manager !== null) {
-                    const t = manager.chargingTime;
-                    cachedChargingTime = t === Infinity ? -1 : t;
-                }
-                listener();
-            };
-            const onDischargingTimeChange = () => {
-                if (manager !== null) {
-                    const t = manager.dischargingTime;
-                    cachedDischargingTime = t === Infinity ? -1 : t;
-                }
-                listener();
-            };
-            let cancelled = false;
-            battery
-                .then((m) => {
-                if (cancelled)
-                    return;
-                manager = m;
-                cachedLevel = m.level;
-                cachedCharging = m.charging;
-                cachedChargingTime = m.chargingTime === Infinity ? -1 : m.chargingTime;
-                cachedDischargingTime = m.dischargingTime === Infinity ? -1 : m.dischargingTime;
-                m.addEventListener?.('levelchange', onLevelChange);
-                m.addEventListener?.('chargingchange', onChargingChange);
-                m.addEventListener?.('chargingtimechange', onChargingTimeChange);
-                m.addEventListener?.('dischargingtimechange', onDischargingTimeChange);
-                listener();
-            })
-                .catch(() => { });
-            return () => {
-                cancelled = true;
-                manager?.removeEventListener?.('levelchange', onLevelChange);
-                manager?.removeEventListener?.('chargingchange', onChargingChange);
-                manager?.removeEventListener?.('chargingtimechange', onChargingTimeChange);
-                manager?.removeEventListener?.('dischargingtimechange', onDischargingTimeChange);
-                manager = null;
-            };
-        },
-        subscribeLockScreen() {
-            // The Web Platform has no lock-screen API; only native hosts can detect screen lock.
-            return () => { };
-        },
-        subscribeLowPowerModeChange() {
-            // No OS low-power-mode API available on web; return a no-op unsubscriber.
-            return () => { };
-        },
-        subscribeResume(listener) {
-            if (typeof document === 'undefined')
-                return () => { };
-            document.addEventListener('resume', listener);
-            return () => document.removeEventListener('resume', listener);
-        },
-        subscribeSuspend(listener) {
-            if (typeof document === 'undefined')
-                return () => { };
-            document.addEventListener('freeze', listener);
-            return () => document.removeEventListener('freeze', listener);
-        },
-        subscribeThermalStateChange() {
-            // No thermal state API available on web; return a no-op unsubscriber.
-            return () => { };
-        },
-        subscribeUnlockScreen() {
-            // The Web Platform has no unlock-screen API; only native hosts can detect screen unlock.
-            return () => { };
-        },
-    };
-}
 // Stops delivery to `power` and forgets its subscription. Safe to call when not attached.
 export function detachPower(power) {
     const unsubscribe = _subscriptions.get(power);
@@ -315,10 +147,22 @@ export function enablePowerSignals(power) {
     if (power.onUnlockScreen === null)
         power.onUnlockScreen = createSignal();
 }
+export function explainPowerBackend() {
+    if (_custom !== null) {
+        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
+    }
+    if (_host !== null) {
+        return {
+            conflict: _hostConflict,
+            layer: 'host',
+            operation: _hostObservation !== null ? _hostObservation.operation : null,
+            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
+        };
+    }
+    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
+}
 export function getPowerBackend() {
-    if (_backend === null)
-        _backend = createWebPowerBackend();
-    return _backend;
+    return _custom ?? _host ?? _sentinel;
 }
 // Returns the battery health detail from the active backend, writing into `out` and returning it,
 // or returns null when the active backend does not support battery health reporting.
@@ -349,9 +193,28 @@ export function getPowerThermalState() {
 export function hasPowerKeepAwake() {
     return getPowerBackend().isKeepAwakeActive();
 }
-// Installs a native host power backend; pass null to fall back to the web default.
+export function installPowerHostBackend(backend) {
+    if (_host !== null) {
+        if (_host !== backend)
+            _hostConflict = true;
+        return;
+    }
+    _host = backend;
+}
+export function observePowerHostResult(operation, succeeded) {
+    _hostObservation = {
+        operation,
+        viability: succeeded ? 'available' : 'runtime-api-unavailable',
+    };
+}
+export function resetPowerBackendForTest() {
+    _custom = null;
+    _host = null;
+    _hostConflict = false;
+    _hostObservation = null;
+}
 export function setPowerBackend(backend) {
-    _backend = backend;
+    _custom = backend;
 }
 // Sets the interval at which attachPower polls the backend for idle state changes. The default is
 // 5000ms (5 seconds); set lower for more responsive idle detection at the cost of more frequent
@@ -364,22 +227,60 @@ export function setPowerIdlePollingIntervalMs(intervalMs) {
 export function setPowerKeepAwake(enabled, mode) {
     return getPowerBackend().setKeepAwake(enabled, mode);
 }
-let _backend = null;
+let _custom = null;
+let _host = null;
+let _hostConflict = false;
+let _hostObservation = null;
 let _idlePollingIntervalMs = 5000;
-let _wakeLockSentinel = null;
 const _scratch = createPowerStatus();
-const _subscriptions = new WeakMap();
-function getWebBatteryManagerPromise() {
-    if (typeof navigator === 'undefined')
+const _sentinel = {
+    getBatteryHealth() {
         return null;
-    const nav = navigator;
-    if (typeof nav.getBattery !== 'function')
-        return null;
-    try {
-        return nav.getBattery();
-    }
-    catch {
-        return null;
-    }
-}
+    },
+    getStatus(out) {
+        out.batteryLevel = -1;
+        out.chargingTime = -1;
+        out.dischargingTime = -1;
+        out.isBatteryLow = false;
+        out.isCharging = false;
+        out.isLowPower = false;
+        out.isOnBattery = false;
+        out.thermalState = 'Unknown';
+        return out;
+    },
+    getSystemIdleState() {
+        return 'Unknown';
+    },
+    getSystemIdleTime() {
+        return -1;
+    },
+    isKeepAwakeActive() {
+        return false;
+    },
+    setKeepAwake() {
+        return false;
+    },
+    subscribe() {
+        return () => { };
+    },
+    subscribeLockScreen() {
+        return () => { };
+    },
+    subscribeLowPowerModeChange() {
+        return () => { };
+    },
+    subscribeResume() {
+        return () => { };
+    },
+    subscribeSuspend() {
+        return () => { };
+    },
+    subscribeThermalStateChange() {
+        return () => { };
+    },
+    subscribeUnlockScreen() {
+        return () => { };
+    },
+};
+const _subscriptions = new WeakMap();
 //# sourceMappingURL=power.js.map

package/dist/power.js.map

@@ -1 +1 @@
-{"version":3,"file":"power.js","sourceRoot":"","sources":["../src/power.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"power.js","sourceRoot":"","sources":["../src/power.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAYtF,qGAAqG;AACrG,8FAA8F;AAC9F,uFAAuF;AACvF,qGAAqG;AACrG,kGAAkG;AAClG,iGAAiG;AACjG,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,oBAAoB,GAAG,EAAE;IACjE,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAClC,IAAI,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC;IACzD,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChE,IAAI,MAAM,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;YACtC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;YAC9E,IAAI,UAAU,KAAK,IAAI;gBAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QAClD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,MAAM,qBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,EAAE;QAC7D,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IACH,MAAM,6BAA6B,GAAG,OAAO,CAAC,2BAA2B,CAAC,GAAG,EAAE;QAC7E,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,MAAM,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,EAAE;QACrD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IACH,MAAM,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,EAAE;QACvD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,MAAM,6BAA6B,GAAG,OAAO,CAAC,2BAA2B,CAAC,GAAG,EAAE;QAC7E,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,MAAM,uBAAuB,GAAG,OAAO,CAAC,qBAAqB,CAAC,GAAG,EAAE;QACjE,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI;YAAE,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,iGAAiG;IACjG,8FAA8F;IAC9F,+FAA+F;IAC/F,yCAAyC;IACzC,IAAI,aAAa,GAAmB,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;IACrF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,iBAAiB,CAAC;QAC3C,IAAI,UAAU,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC;YAAE,OAAO;QAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,CAAC;QACjE,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC9B,aAAa,GAAG,OAAO,CAAC;YACxB,UAAU,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAE3B,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE;QAC7B,iBAAiB,EAAE,CAAC;QACpB,qBAAqB,EAAE,CAAC;QACxB,6BAA6B,EAAE,CAAC;QAChC,iBAAiB,EAAE,CAAC;QACpB,kBAAkB,EAAE,CAAC;QACrB,6BAA6B,EAAE,CAAC;QAChC,uBAAuB,EAAE,CAAC;QAC1B,aAAa,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,qGAAqG;AACrG,wFAAwF;AACxF,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,aAAa,EAAE,IAAI;QACnB,iBAAiB,EAAE,IAAI;QACvB,YAAY,EAAE,IAAI;QAClB,oBAAoB,EAAE,IAAI;QAC1B,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,oBAAoB,EAAE,IAAI;QAC1B,cAAc,EAAE,IAAI;KACrB,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,iBAAiB,EAAE,CAAC,CAAC;QACrB,UAAU,EAAE,CAAC,CAAC;QACd,WAAW,EAAE,SAAS;QACtB,kBAAkB,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE,CAAC,CAAC;KACZ,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,YAAY,EAAE,CAAC,CAAC;QAChB,YAAY,EAAE,CAAC,CAAC;QAChB,eAAe,EAAE,CAAC,CAAC;QACnB,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,SAAS;KACxB,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,WAAW,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,WAAW,EAAE,CAAC;QACd,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,qCAAqC;AACrC,MAAM,UAAU,YAAY,CAAC,KAAY;IACvC,WAAW,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED,oGAAoG;AACpG,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,KAAK,CAAC,QAAQ,GAAG,YAAY,EAAE,CAAC;IAC7D,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;QAAE,KAAK,CAAC,UAAU,GAAG,YAAY,EAAE,CAAC;IACjE,IAAI,KAAK,CAAC,aAAa,KAAK,IAAI;QAAE,KAAK,CAAC,aAAa,GAAG,YAAY,EAAE,CAAC;IACvE,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI;QAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,EAAE,CAAC;IAC/E,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI;QAAE,KAAK,CAAC,YAAY,GAAG,YAAY,EAAE,CAAC;IACrE,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI;QAAE,KAAK,CAAC,oBAAoB,GAAG,YAAY,EAAE,CAAC;IACrF,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;QAAE,KAAK,CAAC,QAAQ,GAAG,YAAY,EAAE,CAAC;IAC7D,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI;QAAE,KAAK,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;IAC/D,IAAI,KAAK,CAAC,oBAAoB,KAAK,IAAI;QAAE,KAAK,CAAC,oBAAoB,GAAG,YAAY,EAAE,CAAC;IACrF,IAAI,KAAK,CAAC,cAAc,KAAK,IAAI;QAAE,KAAK,CAAC,cAAc,GAAG,YAAY,EAAE,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO;YACL,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;YACxE,SAAS,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;SACjF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,IAAI,KAAK,IAAI,SAAS,CAAC;AACvC,CAAC;AAED,kGAAkG;AAClG,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CAAC,GAAuB;IAC3D,OAAO,eAAe,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,6BAA6B;IAC3C,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,cAAc,CAAC,GAAgB;IAC7C,OAAO,eAAe,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,uBAAuB,CAAC,gBAAwB;IAC9D,OAAO,eAAe,EAAE,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,CAAC;AAChE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,sBAAsB;IACpC,OAAO,eAAe,EAAE,CAAC,iBAAiB,EAAE,CAAC;AAC/C,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,oBAAoB;IAClC,OAAO,eAAe,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC;AAC5D,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,eAAe,EAAE,CAAC,iBAAiB,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAqB;IAC3D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,KAAK,KAAK,OAAO;YAAE,aAAa,GAAG,IAAI,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,KAAK,GAAG,OAAO,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAiB,EAAE,SAAkB;IAC1E,gBAAgB,GAAG;QACjB,SAAS;QACT,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,GAAG,IAAI,CAAC;IACf,KAAK,GAAG,IAAI,CAAC;IACb,aAAa,GAAG,KAAK,CAAC;IACtB,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,OAAO,GAAG,OAAO,CAAC;AACpB,CAAC;AAED,kGAAkG;AAClG,gGAAgG;AAChG,uEAAuE;AACvE,MAAM,UAAU,6BAA6B,CAAC,UAAkB;IAC9D,sBAAsB,GAAG,UAAU,CAAC;AACtC,CAAC;AAED,sFAAsF;AACtF,0CAA0C;AAC1C,MAAM,UAAU,iBAAiB,CAAC,OAAgB,EAAE,IAAyB;IAC3E,OAAO,eAAe,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACvD,CAAC;AAED,IAAI,OAAO,GAAwB,IAAI,CAAC;AACxC,IAAI,KAAK,GAAwB,IAAI,CAAC;AACtC,IAAI,aAAa,GAAG,KAAK,CAAC;AAC1B,IAAI,gBAAgB,GAAqF,IAAI,CAAC;AAC9G,IAAI,sBAAsB,GAAG,IAAI,CAAC;AAClC,MAAM,QAAQ,GAAgB,iBAAiB,EAAE,CAAC;AAClD,MAAM,SAAS,GAAiB;IAC9B,gBAAgB;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IACD,SAAS,CAAC,GAAG;QACX,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QACtB,GAAG,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;QACtB,GAAG,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QACzB,GAAG,CAAC,YAAY,GAAG,KAAK,CAAC;QACzB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC;QACvB,GAAG,CAAC,WAAW,GAAG,KAAK,CAAC;QACxB,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC;QAC7B,OAAO,GAAG,CAAC;IACb,CAAC;IACD,kBAAkB;QAChB,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,iBAAiB;QACf,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,iBAAiB;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IACD,YAAY;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,SAAS;QACP,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,mBAAmB;QACjB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,2BAA2B;QACzB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,eAAe;QACb,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,gBAAgB;QACd,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,2BAA2B;QACzB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IACD,qBAAqB;QACnB,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;CACF,CAAC;AACF,MAAM,cAAc,GAAG,IAAI,OAAO,EAAqB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/power",
-  "version": "0.3.1-next.975.01aea94",
+  "version": "0.4.0-edge.1908.751021c",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,8 +38,8 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/signals": "0.3.1-next.975.01aea94",
-    "@flighthq/types": "0.3.1-next.975.01aea94"
+    "@flighthq/signals": "0.4.0-edge.1908.751021c",
+    "@flighthq/types": "0.4.0-edge.1908.751021c"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/power.test.ts

@@ -6,10 +6,10 @@ import {
   createPower,
   createPowerBatteryHealth,
   createPowerStatus,
-  createWebPowerBackend,
   detachPower,
   disposePower,
   enablePowerSignals,
+  explainPowerBackend,
   getPowerBackend,
   getPowerBatteryHealth,
   getPowerIdlePollingIntervalMs,
@@ -18,6 +18,9 @@ import {
   getPowerSystemIdleTime,
   getPowerThermalState,
   hasPowerKeepAwake,
+  installPowerHostBackend,
+  observePowerHostResult,
+  resetPowerBackendForTest,
   setPowerBackend,
   setPowerIdlePollingIntervalMs,
   setPowerKeepAwake,
@@ -137,7 +140,7 @@ function fakeBackend(): PowerBackend & {
   };
 }
 
-afterEach(() => setPowerBackend(null));
+afterEach(() => resetPowerBackendForTest());
 
 describe('attachPower', () => {
   it('emits onChange and the charging transition signals', () => {
@@ -335,72 +338,6 @@ describe('createPowerStatus', () => {
   });
 });
 
-describe('createWebPowerBackend', () => {
-  it('isKeepAwakeActive returns false when no lock is held', () => {
-    expect(createWebPowerBackend().isKeepAwakeActive()).toBe(false);
-  });
-
-  it('reads a status without throwing', () => {
-    const out = createPowerStatus();
-    expect(typeof createWebPowerBackend().getStatus(out).isCharging).toBe('boolean');
-  });
-
-  it('getStatus is alias-safe when out is the scratch object', () => {
-    const backend = createWebPowerBackend();
-    const out = createPowerStatus();
-    const result = backend.getStatus(out);
-    expect(result).toBe(out);
-  });
-
-  it('getBatteryHealth returns null on web', () => {
-    const backend = createWebPowerBackend();
-    const out = createPowerBatteryHealth();
-    expect(backend.getBatteryHealth(out)).toBeNull();
-  });
-
-  it('getSystemIdleTime returns -1 on web', () => {
-    expect(createWebPowerBackend().getSystemIdleTime()).toBe(-1);
-  });
-
-  it('getSystemIdleState returns Unknown on web', () => {
-    expect(createWebPowerBackend().getSystemIdleState(5)).toBe('Unknown');
-  });
-
-  it('subscribeLockScreen and subscribeUnlockScreen return inert no-ops on the web', () => {
-    const backend = createWebPowerBackend();
-    expect(() => backend.subscribeLockScreen(() => {})()).not.toThrow();
-    expect(() => backend.subscribeUnlockScreen(() => {})()).not.toThrow();
-  });
-
-  it('subscribeLowPowerModeChange returns an inert no-op on the web', () => {
-    const backend = createWebPowerBackend();
-    expect(() => backend.subscribeLowPowerModeChange(() => {})()).not.toThrow();
-  });
-
-  it('subscribeThermalStateChange returns an inert no-op on the web', () => {
-    const backend = createWebPowerBackend();
-    expect(() => backend.subscribeThermalStateChange(() => {})()).not.toThrow();
-  });
-
-  it('subscribes without throwing when battery API is absent', () => {
-    const unsubscribe = createWebPowerBackend().subscribe(() => {});
-    expect(() => unsubscribe()).not.toThrow();
-  });
-
-  it('toggles keep-awake without throwing', () => {
-    expect(typeof createWebPowerBackend().setKeepAwake(true)).toBe('boolean');
-  });
-
-  it('setKeepAwake returns false for PreventAppSuspension mode (web unsupported)', () => {
-    expect(createWebPowerBackend().setKeepAwake(true, 'PreventAppSuspension')).toBe(false);
-  });
-
-  it('setKeepAwake honors PreventDisplaySleep mode (web default path)', () => {
-    // Web may not have wakeLock, but should not throw.
-    expect(() => createWebPowerBackend().setKeepAwake(true, 'PreventDisplaySleep')).not.toThrow();
-  });
-});
-
 describe('detachPower', () => {
   it('stops further delivery', () => {
     const backend = fakeBackend();
@@ -472,12 +409,105 @@ describe('enablePowerSignals', () => {
   });
 });
 
+describe('explainPowerBackend', () => {
+  afterEach(() => resetPowerBackendForTest());
+
+  it('reports host-not-enabled when no backend is installed', () => {
+    resetPowerBackendForTest();
+    const explanation = explainPowerBackend();
+    expect(explanation.layer).toBe('host-not-enabled');
+    expect(explanation.conflict).toBe(false);
+    expect(explanation.viability).toBe('unobserved');
+  });
+
+  it('reports custom layer when a custom backend is set', () => {
+    setPowerBackend(fakeBackend());
+    expect(explainPowerBackend().layer).toBe('custom');
+  });
+
+  it('reports host layer when a host backend is installed', () => {
+    installPowerHostBackend(fakeBackend());
+    expect(explainPowerBackend().layer).toBe('host');
+  });
+
+  it('reports conflict when two different host backends are installed', () => {
+    installPowerHostBackend(fakeBackend());
+    installPowerHostBackend(fakeBackend());
+    expect(explainPowerBackend().conflict).toBe(true);
+  });
+});
+
 describe('getPowerBackend', () => {
   it('falls back to a web backend', () => {
     expect(getPowerBackend()).not.toBeNull();
   });
 });
 
+describe('getPowerBackend (sentinel)', () => {
+  it('isKeepAwakeActive returns false when no lock is held', () => {
+    expect(getPowerBackend().isKeepAwakeActive()).toBe(false);
+  });
+
+  it('reads a status without throwing', () => {
+    const out = createPowerStatus();
+    expect(typeof getPowerBackend().getStatus(out).isCharging).toBe('boolean');
+  });
+
+  it('getStatus is alias-safe when out is the scratch object', () => {
+    const backend = getPowerBackend();
+    const out = createPowerStatus();
+    const result = backend.getStatus(out);
+    expect(result).toBe(out);
+  });
+
+  it('getBatteryHealth returns null', () => {
+    const backend = getPowerBackend();
+    const out = createPowerBatteryHealth();
+    expect(backend.getBatteryHealth(out)).toBeNull();
+  });
+
+  it('getSystemIdleTime returns -1', () => {
+    expect(getPowerBackend().getSystemIdleTime()).toBe(-1);
+  });
+
+  it('getSystemIdleState returns Unknown', () => {
+    expect(getPowerBackend().getSystemIdleState(5)).toBe('Unknown');
+  });
+
+  it('subscribeLockScreen and subscribeUnlockScreen return inert no-ops', () => {
+    const backend = getPowerBackend();
+    expect(() => backend.subscribeLockScreen(() => {})()).not.toThrow();
+    expect(() => backend.subscribeUnlockScreen(() => {})()).not.toThrow();
+  });
+
+  it('subscribeLowPowerModeChange returns an inert no-op', () => {
+    const backend = getPowerBackend();
+    expect(() => backend.subscribeLowPowerModeChange(() => {})()).not.toThrow();
+  });
+
+  it('subscribeThermalStateChange returns an inert no-op', () => {
+    const backend = getPowerBackend();
+    expect(() => backend.subscribeThermalStateChange(() => {})()).not.toThrow();
+  });
+
+  it('subscribes without throwing', () => {
+    const unsubscribe = getPowerBackend().subscribe(() => {});
+    expect(() => unsubscribe()).not.toThrow();
+  });
+
+  it('setKeepAwake returns false', () => {
+    expect(getPowerBackend().setKeepAwake(true)).toBe(false);
+  });
+
+  it('setKeepAwake returns false for PreventAppSuspension mode', () => {
+    expect(getPowerBackend().setKeepAwake(true, 'PreventAppSuspension')).toBe(false);
+  });
+
+  it('setKeepAwake returns false for PreventDisplaySleep mode', () => {
+    expect(getPowerBackend().setKeepAwake(true, 'PreventDisplaySleep')).toBe(false);
+  });
+});
+
 describe('getPowerBatteryHealth', () => {
   it('returns null from the default web backend', () => {
     const out = createPowerBatteryHealth();
@@ -570,6 +600,57 @@ describe('hasPowerKeepAwake', () => {
   });
 });
 
+describe('installPowerHostBackend', () => {
+  afterEach(() => resetPowerBackendForTest());
+
+  it('installs a host backend that getPowerBackend returns', () => {
+    const backend = fakeBackend();
+    installPowerHostBackend(backend);
+    expect(getPowerBackend()).toBe(backend);
+  });
+
+  it('is first-host-wins: a second different backend sets conflict', () => {
+    const first = fakeBackend();
+    const second = fakeBackend();
+    installPowerHostBackend(first);
+    installPowerHostBackend(second);
+    expect(getPowerBackend()).toBe(first);
+    expect(explainPowerBackend().conflict).toBe(true);
+  });
+});
+
+describe('observePowerHostResult', () => {
+  afterEach(() => resetPowerBackendForTest());
+
+  it('records a successful observation', () => {
+    installPowerHostBackend(fakeBackend());
+    observePowerHostResult('setKeepAwake', true);
+    const explanation = explainPowerBackend();
+    expect(explanation.operation).toBe('setKeepAwake');
+    expect(explanation.viability).toBe('available');
+  });
+
+  it('records a failed observation', () => {
+    installPowerHostBackend(fakeBackend());
+    observePowerHostResult('setKeepAwake', false);
+    expect(explainPowerBackend().viability).toBe('runtime-api-unavailable');
+  });
+});
+
+describe('resetPowerBackendForTest', () => {
+  it('clears all backend slots', () => {
+    const backend = fakeBackend();
+    setPowerBackend(backend);
+    installPowerHostBackend(fakeBackend());
+    observePowerHostResult('setKeepAwake', true);
+    resetPowerBackendForTest();
+    expect(getPowerBackend()).not.toBe(backend);
+    expect(explainPowerBackend().layer).toBe('host-not-enabled');
+    expect(explainPowerBackend().conflict).toBe(false);
+    expect(explainPowerBackend().viability).toBe('unobserved');
+  });
+});
+
 describe('setPowerBackend', () => {
   it('clears back to the web fallback when passed null', () => {
     setPowerBackend(fakeBackend());