@elizaos/capacitor-mobile-signals 1.0.0

package/dist/esm/definitions.d.ts

@@ -0,0 +1,162 @@
+import type { PluginListenerHandle } from "@capacitor/core";
+export type MobileSignalsPlatform = "android" | "ios" | "web";
+export type MobileSignalsSource = "mobile_device" | "mobile_health";
+export type MobileSignalsState = "active" | "idle" | "background" | "locked" | "sleeping";
+export type MobileSignalsHealthSource = "healthkit" | "health_connect";
+export type MobileSignalsSettingsTarget = "app" | "health" | "healthConnect" | "screenTime" | "usageAccess" | "notification" | "batteryOptimization" | "localNetwork" | "deviceSettings";
+export type MobileSignalsSetupActionStatus = "ready" | "needs-action" | "unavailable";
+export interface MobileSignalsSetupAction {
+    id: "health_permissions" | "screen_time_authorization" | "android_usage_access" | "app_settings" | "notification_settings" | "battery_optimization" | "local_network";
+    label: string;
+    status: MobileSignalsSetupActionStatus;
+    canRequest: boolean;
+    canOpenSettings: boolean;
+    settingsTarget: MobileSignalsSettingsTarget | null;
+    reason: string | null;
+}
+export interface MobileSignalsOpenSettingsOptions {
+    target?: MobileSignalsSettingsTarget;
+}
+export interface MobileSignalsOpenSettingsResult {
+    opened: boolean;
+    target: MobileSignalsSettingsTarget;
+    actualTarget: MobileSignalsSettingsTarget;
+    reason: string | null;
+}
+export interface MobileSignalsScreenTimeStatus {
+    supported: boolean;
+    requirements: {
+        entitlements: {
+            familyControls: string;
+        };
+        frameworks: string[];
+        deviceActivityReportExtension: boolean;
+        deviceActivityMonitorExtension: boolean;
+        android?: {
+            usageStatsPermission: string;
+            usageAccessSettingsAction: string;
+        };
+    };
+    entitlements: {
+        familyControls: boolean;
+    };
+    provisioning: {
+        satisfied: boolean;
+        inspected: "code-signature" | "not-inspectable";
+        reason: string | null;
+    };
+    authorization: {
+        status: "approved" | "denied" | "not-determined" | "unavailable";
+        canRequest: boolean;
+    };
+    reportAvailable: boolean;
+    coarseSummaryAvailable: boolean;
+    thresholdEventsAvailable: boolean;
+    rawUsageExportAvailable: false;
+    android?: {
+        usageAccessGranted: boolean;
+        packageUsageStatsPermissionDeclared: boolean;
+        canOpenUsageAccessSettings: boolean;
+        foregroundEventsAvailable: boolean;
+        totalTimeForegroundMs: number | null;
+    };
+    reason: string | null;
+}
+export interface MobileSignalsHealthSleepSnapshot {
+    available: boolean;
+    isSleeping: boolean;
+    asleepAt: number | null;
+    awakeAt: number | null;
+    durationMinutes: number | null;
+    stage: string | null;
+}
+export interface MobileSignalsHealthBiometricSnapshot {
+    sampleAt: number | null;
+    heartRateBpm: number | null;
+    restingHeartRateBpm: number | null;
+    heartRateVariabilityMs: number | null;
+    respiratoryRate: number | null;
+    bloodOxygenPercent: number | null;
+}
+export interface MobileSignalsHealthSnapshot {
+    source: "mobile_health";
+    platform: MobileSignalsPlatform;
+    state: "idle" | "sleeping";
+    observedAt: number;
+    idleState: "active" | "idle" | "locked" | "unknown" | null;
+    idleTimeSeconds: number | null;
+    onBattery: boolean | null;
+    healthSource: MobileSignalsHealthSource;
+    screenTime: MobileSignalsScreenTimeStatus;
+    permissions: {
+        sleep: boolean;
+        biometrics: boolean;
+    };
+    sleep: MobileSignalsHealthSleepSnapshot;
+    biometrics: MobileSignalsHealthBiometricSnapshot;
+    warnings: string[];
+    metadata: Record<string, unknown>;
+}
+export interface MobileSignalsSnapshot {
+    source: "mobile_device";
+    platform: MobileSignalsPlatform;
+    state: MobileSignalsState;
+    observedAt: number;
+    idleState: "active" | "idle" | "locked" | "unknown" | null;
+    idleTimeSeconds: number | null;
+    onBattery: boolean | null;
+    metadata: Record<string, unknown>;
+}
+export type MobileSignalsSignal = MobileSignalsSnapshot | MobileSignalsHealthSnapshot;
+export interface MobileSignalsStartOptions {
+    emitInitial?: boolean;
+}
+export interface MobileSignalsStartResult {
+    enabled: boolean;
+    supported: boolean;
+    platform: MobileSignalsPlatform;
+    snapshot: MobileSignalsSnapshot | null;
+    healthSnapshot: MobileSignalsHealthSnapshot | null;
+}
+export interface MobileSignalsStopResult {
+    stopped: boolean;
+}
+export interface MobileSignalsSnapshotResult {
+    supported: boolean;
+    snapshot: MobileSignalsSnapshot | null;
+    healthSnapshot: MobileSignalsHealthSnapshot | null;
+}
+export interface MobileSignalsBackgroundRefreshResult {
+    scheduled: boolean;
+    identifier?: string;
+    earliestBeginInSeconds?: number;
+    reason?: string;
+}
+export interface MobileSignalsCancelBackgroundRefreshResult {
+    cancelled: boolean;
+    reason?: string;
+}
+export interface MobileSignalsPlugin {
+    checkPermissions(): Promise<MobileSignalsPermissionStatus>;
+    requestPermissions(): Promise<MobileSignalsPermissionStatus>;
+    openSettings(options?: MobileSignalsOpenSettingsOptions): Promise<MobileSignalsOpenSettingsResult>;
+    startMonitoring(options?: MobileSignalsStartOptions): Promise<MobileSignalsStartResult>;
+    stopMonitoring(): Promise<MobileSignalsStopResult>;
+    getSnapshot(): Promise<MobileSignalsSnapshotResult>;
+    scheduleBackgroundRefresh(): Promise<MobileSignalsBackgroundRefreshResult>;
+    cancelBackgroundRefresh(): Promise<MobileSignalsCancelBackgroundRefreshResult>;
+    addListener(eventName: "signal", listenerFunc: (event: MobileSignalsSignal) => void): Promise<PluginListenerHandle>;
+    removeAllListeners(): Promise<void>;
+}
+export interface MobileSignalsPermissionStatus {
+    status: "granted" | "denied" | "not-determined" | "not-applicable";
+    canRequest: boolean;
+    reason?: string;
+    screenTime: MobileSignalsScreenTimeStatus;
+    setupActions: MobileSignalsSetupAction[];
+    permissions: {
+        sleep: boolean;
+        biometrics: boolean;
+    };
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/esm/definitions.d.ts.map

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

package/dist/esm/definitions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { MobileSignalsPlugin } from "./definitions";
+export * from "./definitions";
+export declare const MobileSignals: MobileSignalsPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,cAAc,eAAe,CAAC;AAI9B,eAAO,MAAM,aAAa,qBAKzB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+import { registerPlugin } from "@capacitor/core";
+export * from "./definitions";
+const loadWeb = () => import("./web").then((m) => new m.MobileSignalsWeb());
+export const MobileSignals = registerPlugin("MobileSignals", {
+    web: loadWeb,
+});

package/dist/esm/web.d.ts

@@ -0,0 +1,29 @@
+import { WebPlugin } from "@capacitor/core";
+import type { MobileSignalsOpenSettingsOptions, MobileSignalsOpenSettingsResult, MobileSignalsPermissionStatus, MobileSignalsPlugin, MobileSignalsScreenTimeStatus, MobileSignalsSnapshotResult, MobileSignalsStartOptions, MobileSignalsStartResult, MobileSignalsStopResult } from "./definitions";
+declare function buildScreenTimeStatus(reason: string): MobileSignalsScreenTimeStatus;
+export declare class MobileSignalsWeb extends WebPlugin implements MobileSignalsPlugin {
+    private monitoring;
+    private cleanup;
+    checkPermissions(): Promise<MobileSignalsPermissionStatus>;
+    requestPermissions(): Promise<MobileSignalsPermissionStatus>;
+    openSettings(options?: MobileSignalsOpenSettingsOptions): Promise<MobileSignalsOpenSettingsResult>;
+    private emitSignal;
+    private attachListeners;
+    private clearListeners;
+    startMonitoring(options?: MobileSignalsStartOptions): Promise<MobileSignalsStartResult>;
+    stopMonitoring(): Promise<MobileSignalsStopResult>;
+    getSnapshot(): Promise<MobileSignalsSnapshotResult>;
+    scheduleBackgroundRefresh(): Promise<{
+        scheduled: boolean;
+        reason: string;
+    }>;
+    cancelBackgroundRefresh(): Promise<{
+        cancelled: boolean;
+        reason: string;
+    }>;
+}
+export declare const __internal: {
+    buildScreenTimeStatus: typeof buildScreenTimeStatus;
+};
+export {};
+//# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAEV,gCAAgC,EAChC,+BAA+B,EAC/B,6BAA6B,EAE7B,mBAAmB,EACnB,6BAA6B,EAG7B,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,eAAe,CAAC;AAiCvB,iBAAS,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,6BAA6B,CA6B5E;AA6HD,qBAAa,gBAAiB,SAAQ,SAAU,YAAW,mBAAmB;IAC5E,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAiB;IAE1B,gBAAgB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAkB1D,kBAAkB,IAAI,OAAO,CAAC,6BAA6B,CAAC;IAI5D,YAAY,CAChB,OAAO,GAAE,gCAAqC,GAC7C,OAAO,CAAC,+BAA+B,CAAC;IAS3C,OAAO,CAAC,UAAU,CAKhB;IAEF,OAAO,CAAC,eAAe;IA4BvB,OAAO,CAAC,cAAc;IAOhB,eAAe,CACnB,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC;IAqB9B,cAAc,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAMlD,WAAW,IAAI,OAAO,CAAC,2BAA2B,CAAC;IASnD,yBAAyB,IAAI,OAAO,CAAC;QACzC,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAOI,uBAAuB,IAAI,OAAO,CAAC;QACvC,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CAMH;AAED,eAAO,MAAM,UAAU;;CAEtB,CAAC"}

package/dist/esm/web.js

@@ -0,0 +1,272 @@
+import { WebPlugin } from "@capacitor/core";
+const SCREEN_TIME_REQUIREMENTS = {
+    entitlements: {
+        familyControls: "com.apple.developer.family-controls",
+    },
+    frameworks: ["FamilyControls", "DeviceActivity"],
+    deviceActivityReportExtension: false,
+    deviceActivityMonitorExtension: false,
+    android: {
+        usageStatsPermission: "android.permission.PACKAGE_USAGE_STATS",
+        usageAccessSettingsAction: "android.settings.USAGE_ACCESS_SETTINGS",
+    },
+};
+function getPlatform() {
+    if (typeof navigator === "undefined") {
+        return "web";
+    }
+    const ua = navigator.userAgent.toLowerCase();
+    if (ua.includes("android"))
+        return "android";
+    if (ua.includes("iphone") || ua.includes("ipad") || ua.includes("ipod")) {
+        return "ios";
+    }
+    return "web";
+}
+function buildScreenTimeStatus(reason) {
+    return {
+        supported: false,
+        requirements: SCREEN_TIME_REQUIREMENTS,
+        entitlements: {
+            familyControls: false,
+        },
+        provisioning: {
+            satisfied: false,
+            inspected: "not-inspectable",
+            reason,
+        },
+        authorization: {
+            status: "unavailable",
+            canRequest: false,
+        },
+        reportAvailable: false,
+        coarseSummaryAvailable: false,
+        thresholdEventsAvailable: false,
+        rawUsageExportAvailable: false,
+        android: {
+            usageAccessGranted: false,
+            packageUsageStatsPermissionDeclared: false,
+            canOpenUsageAccessSettings: false,
+            foregroundEventsAvailable: false,
+            totalTimeForegroundMs: null,
+        },
+        reason,
+    };
+}
+function buildSetupActions(reason) {
+    return [
+        {
+            id: "health_permissions",
+            label: "Health permissions",
+            status: "unavailable",
+            canRequest: false,
+            canOpenSettings: false,
+            settingsTarget: null,
+            reason,
+        },
+        {
+            id: "screen_time_authorization",
+            label: "Screen Time",
+            status: "unavailable",
+            canRequest: false,
+            canOpenSettings: false,
+            settingsTarget: null,
+            reason: "Web fallback cannot open native Screen Time settings.",
+        },
+    ];
+}
+async function getBatterySnapshot() {
+    const nav = typeof navigator !== "undefined"
+        ? navigator
+        : null;
+    if (!nav || typeof nav.getBattery !== "function") {
+        return { onBattery: null, batteryLevel: null, isCharging: null };
+    }
+    const battery = await nav.getBattery();
+    return {
+        onBattery: !battery.charging,
+        batteryLevel: typeof battery.level === "number"
+            ? Math.max(0, Math.min(1, battery.level))
+            : null,
+        isCharging: battery.charging,
+    };
+}
+async function buildSnapshot(reason) {
+    const isVisible = typeof document !== "undefined"
+        ? document.visibilityState === "visible"
+        : true;
+    const hasFocus = typeof document !== "undefined" && typeof document.hasFocus === "function"
+        ? document.hasFocus()
+        : true;
+    const battery = await getBatterySnapshot();
+    const state = isVisible && hasFocus ? "active" : "background";
+    const idleState = isVisible
+        ? "active"
+        : "idle";
+    return {
+        source: "mobile_device",
+        platform: getPlatform(),
+        state,
+        observedAt: Date.now(),
+        idleState,
+        idleTimeSeconds: null,
+        onBattery: battery.onBattery,
+        metadata: {
+            reason,
+            visibilityState: typeof document !== "undefined" ? document.visibilityState : "visible",
+            hasFocus,
+            ...battery,
+        },
+    };
+}
+function buildHealthSnapshot(reason) {
+    return {
+        source: "mobile_health",
+        platform: getPlatform(),
+        state: "idle",
+        observedAt: Date.now(),
+        idleState: null,
+        idleTimeSeconds: null,
+        onBattery: null,
+        healthSource: "healthkit",
+        screenTime: buildScreenTimeStatus("Web fallback has no Family Controls or DeviceActivity access."),
+        permissions: {
+            sleep: false,
+            biometrics: false,
+        },
+        sleep: {
+            available: false,
+            isSleeping: false,
+            asleepAt: null,
+            awakeAt: null,
+            durationMinutes: null,
+            stage: null,
+        },
+        biometrics: {
+            sampleAt: null,
+            heartRateBpm: null,
+            restingHeartRateBpm: null,
+            heartRateVariabilityMs: null,
+            respiratoryRate: null,
+            bloodOxygenPercent: null,
+        },
+        warnings: [`web fallback has no health access (${reason})`],
+        metadata: {
+            reason,
+            platform: getPlatform(),
+            supported: false,
+        },
+    };
+}
+export class MobileSignalsWeb extends WebPlugin {
+    constructor() {
+        super(...arguments);
+        this.monitoring = false;
+        this.cleanup = [];
+        this.emitSignal = async (reason) => {
+            if (!this.monitoring)
+                return;
+            const snapshot = await buildSnapshot(reason);
+            this.notifyListeners("signal", snapshot);
+            this.notifyListeners("signal", buildHealthSnapshot(reason));
+        };
+    }
+    async checkPermissions() {
+        return {
+            status: "not-applicable",
+            canRequest: false,
+            screenTime: buildScreenTimeStatus("Web fallback has no Family Controls or DeviceActivity access."),
+            setupActions: buildSetupActions("Web fallback has no HealthKit or Health Connect access."),
+            permissions: {
+                sleep: false,
+                biometrics: false,
+            },
+            reason: "Web fallback has no HealthKit or Health Connect access.",
+        };
+    }
+    async requestPermissions() {
+        return this.checkPermissions();
+    }
+    async openSettings(options = {}) {
+        return {
+            opened: false,
+            target: options.target ?? "app",
+            actualTarget: "app",
+            reason: "Web fallback cannot open native device settings.",
+        };
+    }
+    attachListeners() {
+        if (typeof document !== "undefined") {
+            const handleVisibilityChange = () => {
+                void this.emitSignal("visibilitychange");
+            };
+            document.addEventListener("visibilitychange", handleVisibilityChange);
+            this.cleanup.push(() => document.removeEventListener("visibilitychange", handleVisibilityChange));
+        }
+        if (typeof window !== "undefined") {
+            const handleFocus = () => {
+                void this.emitSignal("focus");
+            };
+            const handleBlur = () => {
+                void this.emitSignal("blur");
+            };
+            window.addEventListener("focus", handleFocus);
+            window.addEventListener("blur", handleBlur);
+            this.cleanup.push(() => window.removeEventListener("focus", handleFocus));
+            this.cleanup.push(() => window.removeEventListener("blur", handleBlur));
+        }
+    }
+    clearListeners() {
+        while (this.cleanup.length > 0) {
+            const cleanup = this.cleanup.pop();
+            cleanup?.();
+        }
+    }
+    async startMonitoring(options = {}) {
+        if (!this.monitoring) {
+            this.monitoring = true;
+            this.attachListeners();
+        }
+        const snapshot = await buildSnapshot("start");
+        const healthSnapshot = buildHealthSnapshot("start");
+        if (options.emitInitial ?? true) {
+            this.notifyListeners("signal", snapshot);
+            this.notifyListeners("signal", healthSnapshot);
+        }
+        return {
+            enabled: this.monitoring,
+            supported: true,
+            platform: snapshot.platform,
+            snapshot,
+            healthSnapshot,
+        };
+    }
+    async stopMonitoring() {
+        this.monitoring = false;
+        this.clearListeners();
+        return { stopped: true };
+    }
+    async getSnapshot() {
+        const snapshot = await buildSnapshot("snapshot");
+        return {
+            supported: true,
+            snapshot,
+            healthSnapshot: buildHealthSnapshot("snapshot"),
+        };
+    }
+    async scheduleBackgroundRefresh() {
+        return {
+            scheduled: false,
+            reason: "Web fallback cannot schedule native background refresh tasks.",
+        };
+    }
+    async cancelBackgroundRefresh() {
+        return {
+            cancelled: false,
+            reason: "Web fallback has no native background refresh task to cancel.",
+        };
+    }
+}
+export const __internal = {
+    buildScreenTimeStatus,
+};

package/dist/esm/web.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=web.test.d.ts.map

package/dist/esm/web.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.test.d.ts","sourceRoot":"","sources":["../../src/web.test.ts"],"names":[],"mappings":""}

package/dist/esm/web.test.js

@@ -0,0 +1,75 @@
+import { describe, expect, it } from "vitest";
+import { MobileSignalsWeb } from "./web.js";
+describe("MobileSignalsWeb Screen Time status", () => {
+    it("reports Screen Time as unavailable without fabricating usage data", async () => {
+        const plugin = new MobileSignalsWeb();
+        const permissions = await plugin.checkPermissions();
+        expect(permissions.screenTime).toEqual({
+            supported: false,
+            requirements: {
+                entitlements: {
+                    familyControls: "com.apple.developer.family-controls",
+                },
+                frameworks: ["FamilyControls", "DeviceActivity"],
+                deviceActivityReportExtension: false,
+                deviceActivityMonitorExtension: false,
+                android: {
+                    usageStatsPermission: "android.permission.PACKAGE_USAGE_STATS",
+                    usageAccessSettingsAction: "android.settings.USAGE_ACCESS_SETTINGS",
+                },
+            },
+            entitlements: {
+                familyControls: false,
+            },
+            provisioning: {
+                satisfied: false,
+                inspected: "not-inspectable",
+                reason: "Web fallback has no Family Controls or DeviceActivity access.",
+            },
+            authorization: {
+                status: "unavailable",
+                canRequest: false,
+            },
+            reportAvailable: false,
+            coarseSummaryAvailable: false,
+            thresholdEventsAvailable: false,
+            rawUsageExportAvailable: false,
+            android: {
+                usageAccessGranted: false,
+                packageUsageStatsPermissionDeclared: false,
+                canOpenUsageAccessSettings: false,
+                foregroundEventsAvailable: false,
+                totalTimeForegroundMs: null,
+            },
+            reason: "Web fallback has no Family Controls or DeviceActivity access.",
+        });
+        expect(permissions.setupActions).toEqual([
+            {
+                id: "health_permissions",
+                label: "Health permissions",
+                status: "unavailable",
+                canRequest: false,
+                canOpenSettings: false,
+                settingsTarget: null,
+                reason: "Web fallback has no HealthKit or Health Connect access.",
+            },
+            {
+                id: "screen_time_authorization",
+                label: "Screen Time",
+                status: "unavailable",
+                canRequest: false,
+                canOpenSettings: false,
+                settingsTarget: null,
+                reason: "Web fallback cannot open native Screen Time settings.",
+            },
+        ]);
+        const snapshot = await plugin.getSnapshot();
+        expect(snapshot.healthSnapshot?.screenTime).toEqual(permissions.screenTime);
+        await expect(plugin.openSettings({ target: "usageAccess" })).resolves.toEqual({
+            opened: false,
+            target: "usageAccess",
+            actualTarget: "app",
+            reason: "Web fallback cannot open native device settings.",
+        });
+    });
+});