@mentra/engine 0.1.0-beta.0

package/build/services/MiniappRunningRegistry.js

@@ -0,0 +1,52 @@
+/**
+ * MiniappRunningRegistry — module-level set of currently-running miniapp
+ * packageNames.
+ *
+ * "Running" means the miniapp's **background JSContext is alive** in the
+ * host process. The UI WebView open/close state is separate — that's
+ * tracked by MentraUIRouter.isBound(). A miniapp can be "running"
+ * (JSContext alive, processing glasses events) without any WebView
+ * mounted, which is the steady-state.
+ *
+ * MentraJSRouter is the single writer: `spawnAndRegister` adds,
+ * `unregister` removes. Home tile / tray reads from here to project the
+ * `running` field on local applets.
+ */
+const running = new Set();
+const listeners = new Set();
+function notify() {
+    for (const fn of listeners) {
+        try {
+            fn();
+        }
+        catch (e) {
+            console.warn("MiniappRunningRegistry: listener threw", e);
+        }
+    }
+}
+export const miniappRunningRegistry = {
+    add(packageName) {
+        if (running.has(packageName))
+            return;
+        running.add(packageName);
+        notify();
+    },
+    remove(packageName) {
+        if (!running.delete(packageName))
+            return;
+        notify();
+    },
+    has(packageName) {
+        return running.has(packageName);
+    },
+    getAll() {
+        return Array.from(running);
+    },
+    subscribe(fn) {
+        listeners.add(fn);
+        return () => {
+            listeners.delete(fn);
+        };
+    },
+};
+//# sourceMappingURL=MiniappRunningRegistry.js.map

package/build/services/MiniappRunningRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MiniappRunningRegistry.js","sourceRoot":"","sources":["../../src/services/MiniappRunningRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;AACjC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;AAErC,SAAS,MAAM;IACb,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,EAAE,EAAE,CAAA;QACN,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,wCAAwC,EAAE,CAAC,CAAC,CAAA;QAC3D,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,CAAC,WAAmB;QACrB,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAM;QACpC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACxB,MAAM,EAAE,CAAA;IACV,CAAC;IAED,MAAM,CAAC,WAAmB;QACxB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;YAAE,OAAM;QACxC,MAAM,EAAE,CAAA;IACV,CAAC;IAED,GAAG,CAAC,WAAmB;QACrB,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,SAAS,CAAC,EAAY;QACpB,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACjB,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QACtB,CAAC,CAAA;IACH,CAAC;CACF,CAAA","sourcesContent":["/**\n * MiniappRunningRegistry — module-level set of currently-running miniapp\n * packageNames.\n *\n * \"Running\" means the miniapp's **background JSContext is alive** in the\n * host process. The UI WebView open/close state is separate — that's\n * tracked by MentraUIRouter.isBound(). A miniapp can be \"running\"\n * (JSContext alive, processing glasses events) without any WebView\n * mounted, which is the steady-state.\n *\n * MentraJSRouter is the single writer: `spawnAndRegister` adds,\n * `unregister` removes. Home tile / tray reads from here to project the\n * `running` field on local applets.\n */\n\ntype Listener = () => void\n\nconst running = new Set<string>()\nconst listeners = new Set<Listener>()\n\nfunction notify(): void {\n  for (const fn of listeners) {\n    try {\n      fn()\n    } catch (e) {\n      console.warn(\"MiniappRunningRegistry: listener threw\", e)\n    }\n  }\n}\n\nexport const miniappRunningRegistry = {\n  add(packageName: string): void {\n    if (running.has(packageName)) return\n    running.add(packageName)\n    notify()\n  },\n\n  remove(packageName: string): void {\n    if (!running.delete(packageName)) return\n    notify()\n  },\n\n  has(packageName: string): boolean {\n    return running.has(packageName)\n  },\n\n  getAll(): string[] {\n    return Array.from(running)\n  },\n\n  subscribe(fn: Listener): () => void {\n    listeners.add(fn)\n    return () => {\n      listeners.delete(fn)\n    }\n  },\n}\n"]}

package/build/services/NativeHttpResponse.d.ts

@@ -0,0 +1,3 @@
+/** Fetch forbids a non-null Response body for these HTTP statuses. */
+export declare function nativeHttpResponseBody(status: number, body: string): string | null;
+//# sourceMappingURL=NativeHttpResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHttpResponse.d.ts","sourceRoot":"","sources":["../../src/services/NativeHttpResponse.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAElF"}

package/build/services/NativeHttpResponse.js

@@ -0,0 +1,6 @@
+const BODY_FORBIDDEN_STATUSES = new Set([204, 205, 304]);
+/** Fetch forbids a non-null Response body for these HTTP statuses. */
+export function nativeHttpResponseBody(status, body) {
+    return BODY_FORBIDDEN_STATUSES.has(status) ? null : body;
+}
+//# sourceMappingURL=NativeHttpResponse.js.map

package/build/services/NativeHttpResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHttpResponse.js","sourceRoot":"","sources":["../../src/services/NativeHttpResponse.ts"],"names":[],"mappings":"AAAA,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;AAExD,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,MAAc,EAAE,IAAY;IACjE,OAAO,uBAAuB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC","sourcesContent":["const BODY_FORBIDDEN_STATUSES = new Set([204, 205, 304])\n\n/** Fetch forbids a non-null Response body for these HTTP statuses. */\nexport function nativeHttpResponseBody(status: number, body: string): string | null {\n  return BODY_FORBIDDEN_STATUSES.has(status) ? null : body\n}\n"]}

package/build/services/NavigationHandlers.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 "@mentra/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);
+    /** 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;
+    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. Proxies to the v2 cloud maps service (Mapbox
+     * Search Box today). 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, via the v2 cloud maps service. 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":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAC,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAC,MAAM,iBAAiB,CAAA;AAIxF;;;GAGG;AACH,KAAK,aAAa,GAAG,CACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAC,KAClF,IAAI,CAAA;AAET;;;GAGG;AACH,KAAK,UAAU,GAAG,CAChB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,EAAE,EAAE,OAAO,EACX,MAAM,CAAC,EAAE,OAAO,EAChB,KAAK,CAAC,EAAE;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,KAC9C,IAAI,CAAA;AAET,qBAAa,kBAAkB;IAO3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAP7B,uEAAuE;IACvE,OAAO,CAAC,YAAY,CAAgC;IACpD,kFAAkF;IAClF,OAAO,CAAC,aAAa,CAAoB;gBAGtB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU;IAGzC,2FAA2F;IAC3F,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAI1C;;;;;OAKG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQjC,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4HrG,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBvG,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAiBV,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAiBhB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvD,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB/E,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBlH;;;;;;OAMG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpH;;;;OAIG;IACG,uBAAuB,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;OAGG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBlH,yFAAyF;IACzF,OAAO,CAAC,SAAS;CAQlB"}

package/build/services/NavigationHandlers.js

@@ -0,0 +1,379 @@
+/**
+ * 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 { cloudClientService } from "./CloudClientService";
+import navigationService from "./NavigationService";
+import { MiniappErrorCode, MiniappResponseType, MiniappStreamType } from "@mentra/miniapp";
+const LOG_TAG = "LocalMiniappRuntime";
+export class NavigationHandlers {
+    sendToMiniapp;
+    sendResult;
+    /** packageName → unsubscribe fn for that app's nav event forwarder. */
+    navListeners = new Map();
+    /** Set of packageNames that have called navigation.start() and not yet stop(). */
+    activeNavApps = new Set();
+    constructor(sendToMiniapp, sendResult) {
+        this.sendToMiniapp = sendToMiniapp;
+        this.sendResult = sendResult;
+    }
+    /** True iff a trip is currently active for the package (used to gate raw-GPS forwards). */
+    isTripActive(packageName) {
+        return this.activeNavApps.has(packageName);
+    }
+    /**
+     * 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) {
+        const unsub = this.navListeners.get(packageName);
+        if (unsub) {
+            unsub();
+            this.navListeners.delete(packageName);
+        }
+    }
+    async handleStart(packageName, payload, requestId) {
+        console.log(`${LOG_TAG}: handleNavigationStart from ${packageName}`, JSON.stringify(payload));
+        // v2 wire shape sends `stops`; v1 shape sends bare lat/lng. Accept both.
+        const rawStops = payload.stops;
+        const stops = [];
+        if (Array.isArray(rawStops)) {
+            for (const s of rawStops) {
+                const sLat = Number(s?.lat);
+                const sLng = Number(s?.lng);
+                if (Number.isFinite(sLat) && Number.isFinite(sLng))
+                    stops.push({ lat: sLat, lng: sLng });
+            }
+        }
+        if (stops.length === 0) {
+            const lat = Number(payload.lat);
+            const lng = Number(payload.lng);
+            if (Number.isFinite(lat) && Number.isFinite(lng))
+                stops.push({ lat, lng });
+        }
+        if (stops.length === 0) {
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: "stops or lat/lng required",
+            });
+            return;
+        }
+        const lat = stops[0].lat;
+        const lng = stops[0].lng;
+        const simulate = payload.simulate === true;
+        const speedNum = Number(payload.speedMultiplier);
+        const speedMultiplier = Number.isFinite(speedNum) && speedNum > 0 ? speedNum : 5;
+        const mode = typeof payload.mode === "string" ? payload.mode : "driving";
+        const avoidRaw = payload.avoid;
+        const avoid = avoidRaw
+            ? {
+                highways: avoidRaw.highways === true,
+                tolls: avoidRaw.tolls === true,
+                ferries: avoidRaw.ferries === true,
+            }
+            : undefined;
+        const missedRaw = Number(payload.missedTurnRerouteMeters);
+        const missedTurnRerouteMeters = Number.isFinite(missedRaw) && missedRaw > 0 ? missedRaw : undefined;
+        const navigation = navigationService;
+        if (!navigation) {
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: "navigation adapter not configured on host",
+            });
+            return;
+        }
+        // Reattach the per-app event forwarder (it may have been detached when the
+        // mini-app closed its UI without stopping the trip).
+        if (!this.navListeners.has(packageName)) {
+            const unsubNav = navigation.addListener((update) => {
+                this.sendToMiniapp(packageName, {
+                    type: MiniappResponseType.EVENT,
+                    streamType: MiniappStreamType.NAVIGATION_UPDATE,
+                    data: update,
+                });
+                // Trip ended naturally — keep the forwarder alive (miniapp may
+                // restart nav) but remove from active set so stop() accounting
+                // stays accurate.
+                if (update.kind === "arrived" || update.kind === "error") {
+                    this.activeNavApps.delete(packageName);
+                }
+            });
+            // Forward the nav-SDK's road-snapped GPS fixes as a location_update
+            // stream, so the miniapp's existing session.events.onLocation(...) just
+            // works while a trip is active.
+            const unsubLoc = navigation.addLocationListener((loc) => {
+                this.sendToMiniapp(packageName, {
+                    type: MiniappResponseType.EVENT,
+                    streamType: MiniappStreamType.LOCATION_UPDATE,
+                    data: {
+                        lat: loc.lat,
+                        lng: loc.lng,
+                        accuracy: loc.accuracy ?? undefined,
+                        timestamp: loc.timestamp,
+                    },
+                });
+            });
+            const unsubRoute = navigation.addRouteListener((route) => {
+                this.sendToMiniapp(packageName, {
+                    type: MiniappResponseType.EVENT,
+                    streamType: MiniappStreamType.NAVIGATION_ROUTE,
+                    data: route,
+                });
+            });
+            this.navListeners.set(packageName, () => {
+                unsubNav();
+                unsubLoc();
+                unsubRoute();
+            });
+        }
+        // If a trip is already active for this app (user closed the UI and came
+        // back), reuse the running session — replay current snapshot and return
+        // ok without restarting the native navigator.
+        if (this.activeNavApps.has(packageName) && navigation.getState() !== "idle") {
+            console.log(`${LOG_TAG}: resuming existing nav session for ${packageName}`);
+            const snapshot = navigation.getSnapshot();
+            this.sendResult(packageName, requestId, true, { ok: true, resumed: true, snapshot });
+            return;
+        }
+        try {
+            const result = await navigation.start({ lat, lng }, { simulate, speedMultiplier, stops, mode, avoid, missedTurnRerouteMeters });
+            if (result.ok) {
+                this.activeNavApps.add(packageName);
+            }
+            this.sendResult(packageName, requestId, result.ok, result, undefined);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation start error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation start error",
+            });
+        }
+    }
+    async handleStop(packageName, requestId) {
+        try {
+            const unsub = this.navListeners.get(packageName);
+            if (unsub) {
+                unsub();
+                this.navListeners.delete(packageName);
+            }
+            this.activeNavApps.delete(packageName);
+            // Only stop the native trip when no other miniapp is still navigating.
+            if (this.activeNavApps.size === 0) {
+                const navigation = navigationService;
+                const result = navigation ? await navigation.stop() : { ok: true };
+                this.sendResult(packageName, requestId, result.ok, result, undefined);
+            }
+            else {
+                this.sendResult(packageName, requestId, true, { ok: true }, undefined);
+            }
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation stop error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation stop error",
+            });
+        }
+    }
+    async handleDeviate(packageName, payload, requestId) {
+        try {
+            const offsetNum = Number(payload.offsetMeters);
+            const offsetMeters = Number.isFinite(offsetNum) && offsetNum > 0 ? offsetNum : 20;
+            const navigation = navigationService;
+            const result = navigation
+                ? await navigation.simulateDeviation(offsetMeters)
+                : { ok: false, error: "navigation adapter not configured" };
+            this.sendResult(packageName, requestId, result.ok, result, undefined);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation deviate error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation deviate error",
+            });
+        }
+    }
+    async handleSetWrongSidewalk(packageName, payload, requestId) {
+        try {
+            const enabled = payload.enabled === true;
+            const navigation = navigationService;
+            const result = navigation
+                ? await navigation.setWrongSidewalkOffset(enabled)
+                : { ok: false, error: "navigation adapter not configured" };
+            this.sendResult(packageName, requestId, result.ok, result, undefined);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation setWrongSidewalkOffset error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation setWrongSidewalkOffset error",
+            });
+        }
+    }
+    async handleSetSkipCrossings(packageName, payload, requestId) {
+        try {
+            const enabled = payload.enabled === true;
+            const navigation = navigationService;
+            const result = navigation
+                ? await navigation.setSkipCrossings(enabled)
+                : { ok: false, error: "navigation adapter not configured" };
+            this.sendResult(packageName, requestId, result.ok, result, undefined);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation setSkipCrossings error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation setSkipCrossings error",
+            });
+        }
+    }
+    handleGetState(packageName, requestId) {
+        const snapshot = navigationService.getSnapshot() ?? null;
+        this.sendResult(packageName, requestId, true, { state: snapshot });
+    }
+    async handleRequestPermission(packageName, requestId) {
+        try {
+            const navigation = navigationService;
+            const result = navigation
+                ? await navigation.requestPermission()
+                : { ok: false, accepted: false, error: "navigation adapter not configured" };
+            this.sendResult(packageName, requestId, true, result);
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation requestPermission error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation requestPermission error",
+            });
+        }
+    }
+    async handleComputeRoute(packageName, payload, requestId) {
+        try {
+            // Computed in the v2 cloud (provider-abstracted maps service). The SDK
+            // payload shape ({origin, stops, mode, avoid, alternatives}) is the v2
+            // DirectionsRequest field-for-field, so it passes straight through. The
+            // direct-Mapbox path in NavigationService is deprecated.
+            const { routes } = await cloudClientService.maps.directions(payload);
+            this.sendResult(packageName, requestId, true, { ok: true, routes });
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation computeRoute error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation computeRoute error",
+            });
+        }
+    }
+    /**
+     * 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.
+     */
+    async handleReverseGeocode(packageName, payload, requestId) {
+        try {
+            const lat = Number(payload.lat);
+            const lng = Number(payload.lng);
+            if (!Number.isFinite(lat) || !Number.isFinite(lng)) {
+                this.sendResult(packageName, requestId, false, undefined, {
+                    code: MiniappErrorCode.INTERNAL,
+                    message: "lat/lng required",
+                });
+                return;
+            }
+            // Resolved in the v2 cloud (provider-abstracted maps service). The
+            // direct-Mapbox geocoding path in NavigationService is deprecated.
+            const { road, address } = await cloudClientService.maps.reverseGeocode({ lat, lng });
+            this.sendResult(packageName, requestId, true, { ok: true, road, address });
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation reverseGeocode error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation reverseGeocode error",
+            });
+        }
+    }
+    /**
+     * Type-ahead place search. Proxies to the v2 cloud maps service (Mapbox
+     * Search Box today). Resolves `{ok: true, suggestions}` — an empty query or no
+     * matches is `{ok: true, suggestions: []}`, not an error.
+     */
+    async handlePlaceAutocomplete(packageName, payload, requestId) {
+        try {
+            const query = typeof payload.query === "string" ? payload.query : "";
+            const sessionToken = typeof payload.sessionToken === "string" ? payload.sessionToken : "";
+            const near = this.parseNear(payload.near);
+            const { suggestions } = await cloudClientService.maps.placeAutocomplete({ query, near, sessionToken });
+            this.sendResult(packageName, requestId, true, { ok: true, suggestions });
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation placeAutocomplete error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation placeAutocomplete error",
+            });
+        }
+    }
+    /**
+     * Resolve a suggestion (`placeId` + `sessionToken`) to a full place with
+     * coordinates, via the v2 cloud maps service. Resolves `{ok: true, place}`.
+     */
+    async handlePlaceDetails(packageName, payload, requestId) {
+        try {
+            const placeId = typeof payload.placeId === "string" ? payload.placeId : "";
+            const sessionToken = typeof payload.sessionToken === "string" ? payload.sessionToken : "";
+            if (!placeId) {
+                this.sendResult(packageName, requestId, false, undefined, {
+                    code: MiniappErrorCode.INTERNAL,
+                    message: "placeId required",
+                });
+                return;
+            }
+            const place = await cloudClientService.maps.placeDetails({ placeId, sessionToken });
+            this.sendResult(packageName, requestId, true, { ok: true, place });
+        }
+        catch (err) {
+            console.error(`${LOG_TAG}: navigation placeDetails error:`, err);
+            this.sendResult(packageName, requestId, false, undefined, {
+                code: MiniappErrorCode.INTERNAL,
+                message: err instanceof Error ? err.message : "navigation placeDetails error",
+            });
+        }
+    }
+    /** Coerce an inbound `near` payload to a {lat,lng}, or undefined when absent/invalid. */
+    parseNear(raw) {
+        if (!raw || typeof raw !== "object")
+            return undefined;
+        const obj = raw;
+        const lat = Number(obj.lat);
+        const lng = Number(obj.lng);
+        if (!Number.isFinite(lat) || !Number.isFinite(lng))
+            return undefined;
+        return { lat, lng };
+    }
+}
+//# sourceMappingURL=NavigationHandlers.js.map

package/build/services/NavigationHandlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationHandlers.js","sourceRoot":"","sources":["../../src/services/NavigationHandlers.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * NavigationHandlers — turn-by-turn navigation request handlers for\n * LocalMiniappRuntime. Extracted from LocalMiniappRuntime so the\n * navigation surface (Google Maps Navigation SDK adapter, multi-stop\n * routes, deviation simulator, dev toggles, road-snapped GPS streaming)\n * lives in one file the reviewer can read in isolation.\n *\n * Wire-up: LocalMiniappRuntime owns one instance, constructed with\n * callbacks for sending results / events back to the miniapp. The\n * dispatcher's switch statement delegates each `NAVIGATION_*` case to a\n * handler here. Cross-cutting hooks (cleanup on disconnect, location-\n * stream gating during a trip) are exposed via {@link onDisconnect} and\n * {@link isTripActive}.\n *\n * State owned here:\n *   - navListeners: per-package unsubscribers for the nav-update +\n *     road-snapped-location + route streams. Detached on disconnect,\n *     reattached on the next NAVIGATION_START from the same package.\n *   - activeNavApps: packages with a live nav session. Used by the\n *     dispatcher to gate raw background-GPS forwards (we don't want the\n *     unsnapped fix interleaving with the simulator's snapped output\n *     during a trip).\n */\n\nimport {type NavLocation, type NavRoute, type NavUpdate} from \"../runtime/config\"\nimport {cloudClientService} from \"./CloudClientService\"\nimport navigationService from \"./NavigationService\"\nimport {MiniappErrorCode, MiniappResponseType, MiniappStreamType} from \"@mentra/miniapp\"\n\nconst LOG_TAG = \"LocalMiniappRuntime\"\n\n/**\n * Shape of the per-miniapp envelope sender — matches\n * LocalMiniappRuntime.sendToMiniapp's signature.\n */\ntype SendToMiniapp = (\n  packageName: string,\n  envelope: {type: MiniappResponseType; streamType?: MiniappStreamType; data?: unknown},\n) => void\n\n/**\n * Shape of the request-result sender — matches\n * LocalMiniappRuntime.sendResult's signature.\n */\ntype SendResult = (\n  packageName: string,\n  requestId: string | undefined,\n  ok: boolean,\n  result?: unknown,\n  error?: {code: MiniappErrorCode; message: string},\n) => void\n\nexport class NavigationHandlers {\n  /** packageName → unsubscribe fn for that app's nav event forwarder. */\n  private navListeners = new Map<string, () => void>()\n  /** Set of packageNames that have called navigation.start() and not yet stop(). */\n  private activeNavApps = new Set<string>()\n\n  constructor(\n    private readonly sendToMiniapp: SendToMiniapp,\n    private readonly sendResult: SendResult,\n  ) {}\n\n  /** True iff a trip is currently active for the package (used to gate raw-GPS forwards). */\n  isTripActive(packageName: string): boolean {\n    return this.activeNavApps.has(packageName)\n  }\n\n  /**\n   * Detach the per-app nav event forwarder. Called when the mini-app\n   * disconnects. The native nav session is left running so the user can\n   * reopen the app and reattach without losing their trip; `activeNavApps`\n   * is kept intact for the same reason.\n   */\n  onDisconnect(packageName: string): void {\n    const unsub = this.navListeners.get(packageName)\n    if (unsub) {\n      unsub()\n      this.navListeners.delete(packageName)\n    }\n  }\n\n  async handleStart(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void> {\n    console.log(`${LOG_TAG}: handleNavigationStart from ${packageName}`, JSON.stringify(payload))\n\n    // v2 wire shape sends `stops`; v1 shape sends bare lat/lng. Accept both.\n    const rawStops = payload.stops as Array<{lat?: unknown; lng?: unknown}> | undefined\n    const stops: Array<{lat: number; lng: number}> = []\n    if (Array.isArray(rawStops)) {\n      for (const s of rawStops) {\n        const sLat = Number(s?.lat)\n        const sLng = Number(s?.lng)\n        if (Number.isFinite(sLat) && Number.isFinite(sLng)) stops.push({lat: sLat, lng: sLng})\n      }\n    }\n    if (stops.length === 0) {\n      const lat = Number(payload.lat)\n      const lng = Number(payload.lng)\n      if (Number.isFinite(lat) && Number.isFinite(lng)) stops.push({lat, lng})\n    }\n    if (stops.length === 0) {\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: \"stops or lat/lng required\",\n      })\n      return\n    }\n    const lat = stops[0].lat\n    const lng = stops[0].lng\n    const simulate = payload.simulate === true\n    const speedNum = Number(payload.speedMultiplier)\n    const speedMultiplier = Number.isFinite(speedNum) && speedNum > 0 ? speedNum : 5\n    const mode = typeof payload.mode === \"string\" ? payload.mode : \"driving\"\n    const avoidRaw = payload.avoid as Record<string, unknown> | undefined\n    const avoid = avoidRaw\n      ? {\n          highways: avoidRaw.highways === true,\n          tolls: avoidRaw.tolls === true,\n          ferries: avoidRaw.ferries === true,\n        }\n      : undefined\n    const missedRaw = Number(payload.missedTurnRerouteMeters)\n    const missedTurnRerouteMeters = Number.isFinite(missedRaw) && missedRaw > 0 ? missedRaw : undefined\n\n    const navigation = navigationService\n    if (!navigation) {\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: \"navigation adapter not configured on host\",\n      })\n      return\n    }\n\n    // Reattach the per-app event forwarder (it may have been detached when the\n    // mini-app closed its UI without stopping the trip).\n    if (!this.navListeners.has(packageName)) {\n      const unsubNav = navigation.addListener((update: NavUpdate) => {\n        this.sendToMiniapp(packageName, {\n          type: MiniappResponseType.EVENT,\n          streamType: MiniappStreamType.NAVIGATION_UPDATE,\n          data: update,\n        })\n        // Trip ended naturally — keep the forwarder alive (miniapp may\n        // restart nav) but remove from active set so stop() accounting\n        // stays accurate.\n        if (update.kind === \"arrived\" || update.kind === \"error\") {\n          this.activeNavApps.delete(packageName)\n        }\n      })\n      // Forward the nav-SDK's road-snapped GPS fixes as a location_update\n      // stream, so the miniapp's existing session.events.onLocation(...) just\n      // works while a trip is active.\n      const unsubLoc = navigation.addLocationListener((loc: NavLocation) => {\n        this.sendToMiniapp(packageName, {\n          type: MiniappResponseType.EVENT,\n          streamType: MiniappStreamType.LOCATION_UPDATE,\n          data: {\n            lat: loc.lat,\n            lng: loc.lng,\n            accuracy: loc.accuracy ?? undefined,\n            timestamp: loc.timestamp,\n          },\n        })\n      })\n      const unsubRoute = navigation.addRouteListener((route: NavRoute) => {\n        this.sendToMiniapp(packageName, {\n          type: MiniappResponseType.EVENT,\n          streamType: MiniappStreamType.NAVIGATION_ROUTE,\n          data: route,\n        })\n      })\n      this.navListeners.set(packageName, () => {\n        unsubNav()\n        unsubLoc()\n        unsubRoute()\n      })\n    }\n\n    // If a trip is already active for this app (user closed the UI and came\n    // back), reuse the running session — replay current snapshot and return\n    // ok without restarting the native navigator.\n    if (this.activeNavApps.has(packageName) && navigation.getState() !== \"idle\") {\n      console.log(`${LOG_TAG}: resuming existing nav session for ${packageName}`)\n      const snapshot = navigation.getSnapshot()\n      this.sendResult(packageName, requestId, true, {ok: true, resumed: true, snapshot})\n      return\n    }\n\n    try {\n      const result = await navigation.start(\n        {lat, lng},\n        {simulate, speedMultiplier, stops, mode, avoid, missedTurnRerouteMeters},\n      )\n      if (result.ok) {\n        this.activeNavApps.add(packageName)\n      }\n      this.sendResult(packageName, requestId, result.ok, result, undefined)\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation start error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation start error\",\n      })\n    }\n  }\n\n  async handleStop(packageName: string, requestId?: string): Promise<void> {\n    try {\n      const unsub = this.navListeners.get(packageName)\n      if (unsub) {\n        unsub()\n        this.navListeners.delete(packageName)\n      }\n      this.activeNavApps.delete(packageName)\n      // Only stop the native trip when no other miniapp is still navigating.\n      if (this.activeNavApps.size === 0) {\n        const navigation = navigationService\n        const result = navigation ? await navigation.stop() : {ok: true}\n        this.sendResult(packageName, requestId, result.ok, result, undefined)\n      } else {\n        this.sendResult(packageName, requestId, true, {ok: true}, undefined)\n      }\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation stop error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation stop error\",\n      })\n    }\n  }\n\n  async handleDeviate(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void> {\n    try {\n      const offsetNum = Number(payload.offsetMeters)\n      const offsetMeters = Number.isFinite(offsetNum) && offsetNum > 0 ? offsetNum : 20\n      const navigation = navigationService\n      const result = navigation\n        ? await navigation.simulateDeviation(offsetMeters)\n        : {ok: false, error: \"navigation adapter not configured\"}\n      this.sendResult(packageName, requestId, result.ok, result, undefined)\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation deviate error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation deviate error\",\n      })\n    }\n  }\n\n  async handleSetWrongSidewalk(\n    packageName: string,\n    payload: Record<string, unknown>,\n    requestId?: string,\n  ): Promise<void> {\n    try {\n      const enabled = payload.enabled === true\n      const navigation = navigationService\n      const result = navigation\n        ? await navigation.setWrongSidewalkOffset(enabled)\n        : {ok: false, error: \"navigation adapter not configured\"}\n      this.sendResult(packageName, requestId, result.ok, result, undefined)\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation setWrongSidewalkOffset error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation setWrongSidewalkOffset error\",\n      })\n    }\n  }\n\n  async handleSetSkipCrossings(\n    packageName: string,\n    payload: Record<string, unknown>,\n    requestId?: string,\n  ): Promise<void> {\n    try {\n      const enabled = payload.enabled === true\n      const navigation = navigationService\n      const result = navigation\n        ? await navigation.setSkipCrossings(enabled)\n        : {ok: false, error: \"navigation adapter not configured\"}\n      this.sendResult(packageName, requestId, result.ok, result, undefined)\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation setSkipCrossings error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation setSkipCrossings error\",\n      })\n    }\n  }\n\n  handleGetState(packageName: string, requestId?: string): void {\n    const snapshot = navigationService.getSnapshot() ?? null\n    this.sendResult(packageName, requestId, true, {state: snapshot})\n  }\n\n  async handleRequestPermission(packageName: string, requestId?: string): Promise<void> {\n    try {\n      const navigation = navigationService\n      const result = navigation\n        ? await navigation.requestPermission()\n        : {ok: false, accepted: false, error: \"navigation adapter not configured\"}\n      this.sendResult(packageName, requestId, true, result)\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation requestPermission error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation requestPermission error\",\n      })\n    }\n  }\n\n  async handleComputeRoute(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void> {\n    try {\n      // Computed in the v2 cloud (provider-abstracted maps service). The SDK\n      // payload shape ({origin, stops, mode, avoid, alternatives}) is the v2\n      // DirectionsRequest field-for-field, so it passes straight through. The\n      // direct-Mapbox path in NavigationService is deprecated.\n      const {routes} = await cloudClientService.maps.directions(payload as never)\n      this.sendResult(packageName, requestId, true, {ok: true, routes})\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation computeRoute error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation computeRoute error\",\n      })\n    }\n  }\n\n  /**\n   * Reverse-geocode a coordinate into a short road name + full formatted\n   * address. Backs the SDK pivot engine's road-name fallback (`road`) and the\n   * navigation miniapp's dropped-pin / POI-tap labels (`address`). Always\n   * resolves with `{ok, road?, address?}` — a missing road/address is\n   * `{ok: true, road: null, address: null}`, not an error.\n   */\n  async handleReverseGeocode(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void> {\n    try {\n      const lat = Number(payload.lat)\n      const lng = Number(payload.lng)\n      if (!Number.isFinite(lat) || !Number.isFinite(lng)) {\n        this.sendResult(packageName, requestId, false, undefined, {\n          code: MiniappErrorCode.INTERNAL,\n          message: \"lat/lng required\",\n        })\n        return\n      }\n      // Resolved in the v2 cloud (provider-abstracted maps service). The\n      // direct-Mapbox geocoding path in NavigationService is deprecated.\n      const {road, address} = await cloudClientService.maps.reverseGeocode({lat, lng})\n      this.sendResult(packageName, requestId, true, {ok: true, road, address})\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation reverseGeocode error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation reverseGeocode error\",\n      })\n    }\n  }\n\n  /**\n   * Type-ahead place search. Proxies to the v2 cloud maps service (Mapbox\n   * Search Box today). Resolves `{ok: true, suggestions}` — an empty query or no\n   * matches is `{ok: true, suggestions: []}`, not an error.\n   */\n  async handlePlaceAutocomplete(\n    packageName: string,\n    payload: Record<string, unknown>,\n    requestId?: string,\n  ): Promise<void> {\n    try {\n      const query = typeof payload.query === \"string\" ? payload.query : \"\"\n      const sessionToken = typeof payload.sessionToken === \"string\" ? payload.sessionToken : \"\"\n      const near = this.parseNear(payload.near)\n\n      const {suggestions} = await cloudClientService.maps.placeAutocomplete({query, near, sessionToken})\n      this.sendResult(packageName, requestId, true, {ok: true, suggestions})\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation placeAutocomplete error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation placeAutocomplete error\",\n      })\n    }\n  }\n\n  /**\n   * Resolve a suggestion (`placeId` + `sessionToken`) to a full place with\n   * coordinates, via the v2 cloud maps service. Resolves `{ok: true, place}`.\n   */\n  async handlePlaceDetails(packageName: string, payload: Record<string, unknown>, requestId?: string): Promise<void> {\n    try {\n      const placeId = typeof payload.placeId === \"string\" ? payload.placeId : \"\"\n      const sessionToken = typeof payload.sessionToken === \"string\" ? payload.sessionToken : \"\"\n      if (!placeId) {\n        this.sendResult(packageName, requestId, false, undefined, {\n          code: MiniappErrorCode.INTERNAL,\n          message: \"placeId required\",\n        })\n        return\n      }\n\n      const place = await cloudClientService.maps.placeDetails({placeId, sessionToken})\n      this.sendResult(packageName, requestId, true, {ok: true, place})\n    } catch (err) {\n      console.error(`${LOG_TAG}: navigation placeDetails error:`, err)\n      this.sendResult(packageName, requestId, false, undefined, {\n        code: MiniappErrorCode.INTERNAL,\n        message: err instanceof Error ? err.message : \"navigation placeDetails error\",\n      })\n    }\n  }\n\n  /** Coerce an inbound `near` payload to a {lat,lng}, or undefined when absent/invalid. */\n  private parseNear(raw: unknown): {lat: number; lng: number} | undefined {\n    if (!raw || typeof raw !== \"object\") return undefined\n    const obj = raw as Record<string, unknown>\n    const lat = Number(obj.lat)\n    const lng = Number(obj.lng)\n    if (!Number.isFinite(lat) || !Number.isFinite(lng)) return undefined\n    return {lat, lng}\n  }\n}\n"]}