@glassly/engine 0.1.0-dev.0

package/build/services/NativeNavigationService.js

@@ -0,0 +1,154 @@
+/**
+ * NativeNavigationService — trip-scoped bridge to glasses with a
+ * firmware-rendered nav UI (`hasNativeNavigation`; G2 service 0x08 today).
+ * NavigationHandlers drives enter/exit at trip boundaries; miniapp NATIVE_NAV
+ * payloads (card fields, map bitmaps) are forwarded to the bluetooth-sdk.
+ * While active, the glasses magnetometer feeds HeadingService so
+ * session.heading serves the glasses compass instead of the phone's.
+ */
+import BluetoothSdk from "@glassly/bluetooth-sdk/internal";
+import { ISLAND_SETTINGS_KEYS } from "../runtime/config";
+import { useSettingsStore } from "../stores/settings";
+import { DeviceTypes, getModelCapabilities } from "../types";
+import headingService from "./HeadingService";
+const LOG_TAG = "NATIVE_NAV_SERVICE";
+class NativeNavigationService {
+    static instance = null;
+    active = false;
+    compassSub = null;
+    modeSub = null;
+    /** Registered by NavigationHandlers; fires when the WEARER exits nav mode on the glasses. */
+    onGlassesExitCb = null;
+    constructor() { }
+    setOnGlassesExit(cb) {
+        this.onGlassesExitCb = cb;
+    }
+    static getInstance() {
+        if (!NativeNavigationService.instance) {
+            NativeNavigationService.instance = new NativeNavigationService();
+        }
+        return NativeNavigationService.instance;
+    }
+    /** True while the glasses' native nav UI owns the display. */
+    get isActive() {
+        return this.active;
+    }
+    /**
+     * True when the paired glasses render their own nav UI AND this native
+     * build exposes the nav-mode functions (both platforms since the G2.kt
+     * port — the typeof guard keeps older builds safe).
+     */
+    isSupported() {
+        const defaultWearable = useSettingsStore.getState().getSetting(ISLAND_SETTINGS_KEYS.defaultWearable);
+        const capabilities = getModelCapabilities(defaultWearable || DeviceTypes.NONE);
+        return (capabilities.hasNativeNavigation === true &&
+            typeof BluetoothSdk.navigationModeStart === "function");
+    }
+    /** A trip started (NavigationHandlers.handleStart succeeded). */
+    onTripStart(packageName) {
+        if (!this.isSupported() || this.active)
+            return;
+        console.log(`${LOG_TAG}: entering native nav mode for ${packageName}`);
+        this.active = true;
+        this.attachListeners();
+        void Promise.resolve(BluetoothSdk.navigationModeStart()).catch((err) => {
+            console.error(`${LOG_TAG}: navigationModeStart failed:`, err);
+        });
+    }
+    /** The trip ended (arrived / stopped / errored). Safe to call when inactive. */
+    onTripEnd(arrived) {
+        if (!this.active)
+            return;
+        console.log(`${LOG_TAG}: exiting native nav mode (arrived=${arrived})`);
+        this.teardown();
+        void Promise.resolve(BluetoothSdk.navigationModeStop(arrived)).catch((err) => {
+            console.error(`${LOG_TAG}: navigationModeStop failed:`, err);
+        });
+    }
+    /**
+     * Forward a miniapp NATIVE_NAV payload to the glasses. Returns false when
+     * native nav isn't active/supported (the SDK reports "unsupported" so the
+     * miniapp can skip re-encoding bitmaps it doesn't need).
+     */
+    handleMiniappRequest(payload) {
+        if (!this.active || !this.isSupported())
+            return false;
+        const action = payload.action;
+        try {
+            switch (action) {
+                case "info": {
+                    const info = (payload.info ?? {});
+                    void BluetoothSdk.navigationUpdateInfo({
+                        directionIcon: Number(info.directionIcon) || 0,
+                        distance: String(info.distance ?? ""),
+                        roadName: String(info.roadName ?? ""),
+                        spendTime: String(info.spendTime ?? ""),
+                        remainDistance: String(info.remainDistance ?? ""),
+                        etaTime: String(info.etaTime ?? ""),
+                        speed: String(info.speed ?? ""),
+                    });
+                    return true;
+                }
+                case "mini_map": {
+                    const map = (payload.map ?? {});
+                    if (typeof map.data !== "string" || map.data.length === 0)
+                        return false;
+                    void BluetoothSdk.navigationMiniMap({
+                        data: map.data,
+                        rotationDeg: Number(map.rotationDeg) || 0,
+                        border: map.border !== false,
+                    });
+                    return true;
+                }
+                case "overview_map": {
+                    const map = (payload.map ?? {});
+                    if (typeof map.data !== "string" || map.data.length === 0)
+                        return false;
+                    void BluetoothSdk.navigationOverviewMap({ data: map.data });
+                    return true;
+                }
+                default:
+                    console.warn(`${LOG_TAG}: unknown native nav action:`, action);
+                    return false;
+            }
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: native nav forward failed:`, err);
+            return false;
+        }
+    }
+    attachListeners() {
+        // Glasses magnetometer → session.heading for the duration of the trip.
+        headingService.setExternalSourceActive(true);
+        this.compassSub?.remove();
+        this.compassSub = BluetoothSdk.addListener("compass_heading", (event) => {
+            const deg = Number(event.heading);
+            if (!Number.isFinite(deg))
+                return;
+            headingService.pushExternalHeading(((deg % 360) + 360) % 360);
+        });
+        // Glasses-side exit ends the whole trip: release the compass override and
+        // let NavigationHandlers stop navigation + notify the miniapp ("cancelled").
+        // Phone-initiated exits (trip already ending) just tear down.
+        this.modeSub?.remove();
+        this.modeSub = BluetoothSdk.addListener("navigation_mode_change", (event) => {
+            if (event.status === "exited" && this.active) {
+                console.log(`${LOG_TAG}: nav mode exited natively (source=${event.source ?? "phone"})`);
+                this.teardown();
+                if (event.source === "glasses")
+                    this.onGlassesExitCb?.();
+            }
+        });
+    }
+    teardown() {
+        this.active = false;
+        this.compassSub?.remove();
+        this.compassSub = null;
+        this.modeSub?.remove();
+        this.modeSub = null;
+        headingService.setExternalSourceActive(false);
+    }
+}
+const nativeNavigationService = NativeNavigationService.getInstance();
+export default nativeNavigationService;
+//# sourceMappingURL=NativeNavigationService.js.map

package/build/services/NativeNavigationService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeNavigationService.js","sourceRoot":"","sources":["../../src/services/NativeNavigationService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * NativeNavigationService — trip-scoped bridge to glasses with a\n * firmware-rendered nav UI (`hasNativeNavigation`; G2 service 0x08 today).\n * NavigationHandlers drives enter/exit at trip boundaries; miniapp NATIVE_NAV\n * payloads (card fields, map bitmaps) are forwarded to the bluetooth-sdk.\n * While active, the glasses magnetometer feeds HeadingService so\n * session.heading serves the glasses compass instead of the phone's.\n */\n\nimport BluetoothSdk from \"@glassly/bluetooth-sdk/internal\"\n\nimport {ISLAND_SETTINGS_KEYS} from \"../runtime/config\"\nimport {useSettingsStore} from \"../stores/settings\"\nimport {DeviceTypes, getModelCapabilities} from \"../types\"\nimport headingService from \"./HeadingService\"\n\nconst LOG_TAG = \"NATIVE_NAV_SERVICE\"\n\nexport interface NativeNavInfoPayload {\n  directionIcon: number\n  distance: string\n  roadName: string\n  spendTime: string\n  remainDistance: string\n  etaTime: string\n  speed: string\n}\n\nclass NativeNavigationService {\n  private static instance: NativeNavigationService | null = null\n\n  private active = false\n  private compassSub: {remove: () => void} | null = null\n  private modeSub: {remove: () => void} | null = null\n  /** Registered by NavigationHandlers; fires when the WEARER exits nav mode on the glasses. */\n  private onGlassesExitCb: (() => void) | null = null\n\n  private constructor() {}\n\n  public setOnGlassesExit(cb: (() => void) | null): void {\n    this.onGlassesExitCb = cb\n  }\n\n  public static getInstance(): NativeNavigationService {\n    if (!NativeNavigationService.instance) {\n      NativeNavigationService.instance = new NativeNavigationService()\n    }\n    return NativeNavigationService.instance\n  }\n\n  /** True while the glasses' native nav UI owns the display. */\n  public get isActive(): boolean {\n    return this.active\n  }\n\n  /**\n   * True when the paired glasses render their own nav UI AND this native\n   * build exposes the nav-mode functions (both platforms since the G2.kt\n   * port — the typeof guard keeps older builds safe).\n   */\n  public isSupported(): boolean {\n    const defaultWearable = useSettingsStore.getState().getSetting(ISLAND_SETTINGS_KEYS.defaultWearable) as\n      | DeviceTypes\n      | undefined\n    const capabilities = getModelCapabilities(defaultWearable || DeviceTypes.NONE)\n    return (\n      capabilities.hasNativeNavigation === true &&\n      typeof (BluetoothSdk as {navigationModeStart?: unknown}).navigationModeStart === \"function\"\n    )\n  }\n\n  /** A trip started (NavigationHandlers.handleStart succeeded). */\n  public onTripStart(packageName: string): void {\n    if (!this.isSupported() || this.active) return\n    console.log(`${LOG_TAG}: entering native nav mode for ${packageName}`)\n    this.active = true\n    this.attachListeners()\n    void Promise.resolve(BluetoothSdk.navigationModeStart()).catch((err) => {\n      console.error(`${LOG_TAG}: navigationModeStart failed:`, err)\n    })\n  }\n\n  /** The trip ended (arrived / stopped / errored). Safe to call when inactive. */\n  public onTripEnd(arrived: boolean): void {\n    if (!this.active) return\n    console.log(`${LOG_TAG}: exiting native nav mode (arrived=${arrived})`)\n    this.teardown()\n    void Promise.resolve(BluetoothSdk.navigationModeStop(arrived)).catch((err) => {\n      console.error(`${LOG_TAG}: navigationModeStop failed:`, err)\n    })\n  }\n\n  /**\n   * Forward a miniapp NATIVE_NAV payload to the glasses. Returns false when\n   * native nav isn't active/supported (the SDK reports \"unsupported\" so the\n   * miniapp can skip re-encoding bitmaps it doesn't need).\n   */\n  public handleMiniappRequest(payload: Record<string, unknown>): boolean {\n    if (!this.active || !this.isSupported()) return false\n    const action = payload.action\n    try {\n      switch (action) {\n        case \"info\": {\n          const info = (payload.info ?? {}) as Partial<NativeNavInfoPayload>\n          void BluetoothSdk.navigationUpdateInfo({\n            directionIcon: Number(info.directionIcon) || 0,\n            distance: String(info.distance ?? \"\"),\n            roadName: String(info.roadName ?? \"\"),\n            spendTime: String(info.spendTime ?? \"\"),\n            remainDistance: String(info.remainDistance ?? \"\"),\n            etaTime: String(info.etaTime ?? \"\"),\n            speed: String(info.speed ?? \"\"),\n          })\n          return true\n        }\n        case \"mini_map\": {\n          const map = (payload.map ?? {}) as {data?: unknown; rotationDeg?: unknown; border?: unknown}\n          if (typeof map.data !== \"string\" || map.data.length === 0) return false\n          void BluetoothSdk.navigationMiniMap({\n            data: map.data,\n            rotationDeg: Number(map.rotationDeg) || 0,\n            border: map.border !== false,\n          })\n          return true\n        }\n        case \"overview_map\": {\n          const map = (payload.map ?? {}) as {data?: unknown}\n          if (typeof map.data !== \"string\" || map.data.length === 0) return false\n          void BluetoothSdk.navigationOverviewMap({data: map.data})\n          return true\n        }\n        default:\n          console.warn(`${LOG_TAG}: unknown native nav action:`, action)\n          return false\n      }\n    } catch (err) {\n      console.error(`${LOG_TAG}: native nav forward failed:`, err)\n      return false\n    }\n  }\n\n  private attachListeners(): void {\n    // Glasses magnetometer → session.heading for the duration of the trip.\n    headingService.setExternalSourceActive(true)\n    this.compassSub?.remove()\n    this.compassSub = BluetoothSdk.addListener(\"compass_heading\", (event) => {\n      const deg = Number(event.heading)\n      if (!Number.isFinite(deg)) return\n      headingService.pushExternalHeading(((deg % 360) + 360) % 360)\n    })\n\n    // Glasses-side exit ends the whole trip: release the compass override and\n    // let NavigationHandlers stop navigation + notify the miniapp (\"cancelled\").\n    // Phone-initiated exits (trip already ending) just tear down.\n    this.modeSub?.remove()\n    this.modeSub = BluetoothSdk.addListener(\"navigation_mode_change\", (event) => {\n      if (event.status === \"exited\" && this.active) {\n        console.log(`${LOG_TAG}: nav mode exited natively (source=${event.source ?? \"phone\"})`)\n        this.teardown()\n        if (event.source === \"glasses\") this.onGlassesExitCb?.()\n      }\n    })\n  }\n\n  private teardown(): void {\n    this.active = false\n    this.compassSub?.remove()\n    this.compassSub = null\n    this.modeSub?.remove()\n    this.modeSub = null\n    headingService.setExternalSourceActive(false)\n  }\n}\n\nconst nativeNavigationService = NativeNavigationService.getInstance()\nexport default nativeNavigationService\n"]}

package/build/services/NavigationHandlers.d.ts

@@ -0,0 +1,107 @@
+/**
+ * NavigationHandlers — turn-by-turn navigation request handlers for
+ * LocalMiniappRuntime. Extracted from LocalMiniappRuntime so the
+ * navigation surface (Google Maps Navigation SDK adapter, multi-stop
+ * routes, deviation simulator, dev toggles, road-snapped GPS streaming)
+ * lives in one file the reviewer can read in isolation.
+ *
+ * Wire-up: LocalMiniappRuntime owns one instance, constructed with
+ * callbacks for sending results / events back to the miniapp. The
+ * dispatcher's switch statement delegates each `NAVIGATION_*` case to a
+ * handler here. Cross-cutting hooks (cleanup on disconnect, location-
+ * stream gating during a trip) are exposed via {@link onDisconnect} and
+ * {@link isTripActive}.
+ *
+ * State owned here:
+ *   - navListeners: per-package unsubscribers for the nav-update +
+ *     road-snapped-location + route streams. Detached on disconnect,
+ *     reattached on the next NAVIGATION_START from the same package.
+ *   - activeNavApps: packages with a live nav session. Used by the
+ *     dispatcher to gate raw background-GPS forwards (we don't want the
+ *     unsnapped fix interleaving with the simulator's snapped output
+ *     during a trip).
+ */
+import { MiniappErrorCode, MiniappResponseType, MiniappStreamType } from "@glassly/miniapp";
+/**
+ * Shape of the per-miniapp envelope sender — matches
+ * LocalMiniappRuntime.sendToMiniapp's signature.
+ */
+type SendToMiniapp = (packageName: string, envelope: {
+    type: MiniappResponseType;
+    streamType?: MiniappStreamType;
+    data?: unknown;
+}) => void;
+/**
+ * Shape of the request-result sender — matches
+ * LocalMiniappRuntime.sendResult's signature.
+ */
+type SendResult = (packageName: string, requestId: string | undefined, ok: boolean, result?: unknown, error?: {
+    code: MiniappErrorCode;
+    message: string;
+}) => void;
+export declare class NavigationHandlers {
+    private readonly sendToMiniapp;
+    private readonly sendResult;
+    /** packageName → unsubscribe fn for that app's nav event forwarder. */
+    private navListeners;
+    /** Set of packageNames that have called navigation.start() and not yet stop(). */
+    private activeNavApps;
+    constructor(sendToMiniapp: SendToMiniapp, sendResult: SendResult);
+    /**
+     * The wearer exited nav mode on the glasses — end the trip: stop the native
+     * navigator and tell each active nav app via a "cancelled" update so it can
+     * reset its own trip state.
+     */
+    private stopFromGlasses;
+    /** True iff a trip is currently active for the package (used to gate raw-GPS forwards). */
+    isTripActive(packageName: string): boolean;
+    /**
+     * Detach the per-app nav event forwarder. Called when the mini-app
+     * disconnects. The native nav session is left running so the user can
+     * reopen the app and reattach without losing their trip; `activeNavApps`
+     * is kept intact for the same reason.
+     */
+    onDisconnect(packageName: string): void;
+    /**
+     * The user closed/disabled the mini-app (not a crash-respawn). Unlike
+     * {@link onDisconnect}, this ends the trip: the glasses leave native nav
+     * mode and the phone navigator stops once no other app is navigating.
+     */
+    onAppClosed(packageName: string): void;
+    handleStart(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleStop(packageName: string, requestId?: string): Promise<void>;
+    handleDeviate(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleSetWrongSidewalk(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleSetSkipCrossings(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    handleGetState(packageName: string, requestId?: string): void;
+    handleRequestPermission(packageName: string, requestId?: string): Promise<void>;
+    handleComputeRoute(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    /**
+     * Reverse-geocode a coordinate into a short road name + full formatted
+     * address. Backs the SDK pivot engine's road-name fallback (`road`) and the
+     * navigation miniapp's dropped-pin / POI-tap labels (`address`). Always
+     * resolves with `{ok, road?, address?}` — a missing road/address is
+     * `{ok: true, road: null, address: null}`, not an error.
+     */
+    handleReverseGeocode(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    /**
+     * Type-ahead place search. Runs on-device against Mapbox Search Box when the
+     * user saved their own key (Settings > API Keys) — that key exists precisely
+     * so search works without the cloud — and falls back to the v2 cloud maps
+     * service otherwise. Resolves `{ok: true, suggestions}` — an empty query or no
+     * matches is `{ok: true, suggestions: []}`, not an error.
+     */
+    handlePlaceAutocomplete(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    /**
+     * Resolve a suggestion (`placeId` + `sessionToken`) to a full place with
+     * coordinates. Takes the same on-device-vs-cloud branch as
+     * {@link handlePlaceAutocomplete}: the `placeId` and session token come from
+     * whichever provider produced the suggestion, so both calls must run against
+     * the same one. Resolves `{ok: true, place}`.
+     */
+    handlePlaceDetails(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void>;
+    /** Coerce an inbound `near` payload to a {lat,lng}, or undefined when absent/invalid. */
+    private parseNear;
+}
+export {};
+//# sourceMappingURL=NavigationHandlers.d.ts.map

package/build/services/NavigationHandlers.d.ts.map

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