@cloudparse/up-miniapps-sdk 0.6.1 → 0.6.3

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { R as RouteResponse, a as RouteStep, b as RouteRequest, c as RoutingBackendConfig } from './index-B9dDciJq.cjs';
 export { C as ClearRouteRequest, D as DrawRouteRequest, h as handleClearRoute, d as handleDrawRoute, e as handleRouteRequest } from './index-B9dDciJq.cjs';
-import { ViewState } from '@vis.gl/react-maplibre';
+import { ViewState, StyleSpecification, ImmutableLike } from '@vis.gl/react-maplibre';
 import * as react_dom_client from 'react-dom/client';
 import { ShapeType, ErrorCorrectionLevel, DotType, Gradient, CornerSquareType, CornerDotType } from 'qr-code-styling';
 import 'maplibre-gl';
@@ -681,8 +681,8 @@ interface MapProps {
     style?: React__default.CSSProperties;
     /** Minimum and maximum bounds for the map. */
     maxBounds?: [[number, number], [number, number]];
-    /** MapLibre style URL. Defaults to local server. */
-    mapStyle?: string;
+    /** MapLibre style URL, or an inline style spec object. Defaults to local server. */
+    mapStyle?: string | StyleSpecification | ImmutableLike<StyleSpecification>;
     /** Children components (Source, Layer, etc.) */
     children?: React__default.ReactNode;
     /** Additional CSS classes for the map container. */
@@ -1243,6 +1243,28 @@ declare class MiniAppSDK {
          */
         render: typeof renderMap;
     }>;
+    /**
+     * QR code generation — the single source of truth for every Mini-App.
+     * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
+     * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
+     * Mini-Apps must not reimplement this on their own.
+     */
+    readonly qrCode: Readonly<{
+        /**
+         * Decodes a QR code from a static image (base64 data URI or URL) —
+         * e.g. a photo picked via `sdk.media.pickImage()` that already
+         * contains a QR code, as an alternative to the live `<QRScanner>`.
+         * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
+         * @returns The decoded string, or `null` if no QR code was found.
+         */
+        decode: (imageDataUrl: string) => Promise<string | null>;
+        /**
+         * @param data The value to encode (e.g. a deep link).
+         * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
+         * @returns A base64 PNG data URI.
+         */
+        generate: (data: string, options?: IGenerateQrCodeOptions) => Promise<string>;
+    }>;
     private bridge;
     /**
      * Local SQLite Storage.
@@ -1349,28 +1371,6 @@ declare class MiniAppSDK {
          */
         saveImage: (base64: string, filename?: string) => Promise<ISaveImageResult>;
     }>;
-    /**
-     * QR code generation — the single source of truth for every Mini-App.
-     * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
-     * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
-     * Mini-Apps must not reimplement this on their own.
-     */
-    readonly qrCode: Readonly<{
-        /**
-         * @param data The value to encode (e.g. a deep link).
-         * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
-         * @returns A base64 PNG data URI.
-         */
-        generate: (data: string, options?: IGenerateQrCodeOptions) => Promise<string>;
-        /**
-         * Decodes a QR code from a static image (base64 data URI or URL) —
-         * e.g. a photo picked via `sdk.media.pickImage()` that already
-         * contains a QR code, as an alternative to the live `<QRScanner>`.
-         * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
-         * @returns The decoded string, or `null` if no QR code was found.
-         */
-        decode: (imageDataUrl: string) => Promise<string | null>;
-    }>;
     /**
      * Payments integration.
      */
@@ -1614,6 +1614,15 @@ interface WsMessage {
     event?: string;
     [key: string]: unknown;
 }
+/**
+ * `"open"` is the only state where the wire connection is actually live —
+ * `"connecting"` covers both the initial handshake and every reconnect
+ * backoff wait, `"closed"` covers not-yet-started and lost-and-not-yet-
+ * retried. A consumer that wants a poll-based fallback (only meaningful
+ * while genuinely disconnected) should treat anything other than `"open"`
+ * as "poll".
+ */
+type WsConnectionStatus = "connecting" | "open" | "closed";
 interface BaseWsServiceOptions<TMessage extends WsMessage> {
     /**
      * The REST client from `createApiService` — reused here for two things:
@@ -1720,6 +1729,21 @@ interface WsServiceClient<TMessage extends WsMessage = WsMessage> {
      * function.
      */
     onMessage(callback: (message: TMessage) => void): () => void;
+    /**
+     * Current connection status, read synchronously — no subscription needed
+     * for a one-off check.
+     */
+    getStatus(): WsConnectionStatus;
+    /**
+     * Subscribes to connection status transitions. Fires once immediately
+     * with the current status on subscribe, then again on every change.
+     * Returns an unsubscribe function. Intended for a consumer that wants a
+     * poll-based fallback only while genuinely disconnected (see
+     * `WsConnectionStatus`'s own doc comment) — driving that off `onMessage`
+     * pings alone can't distinguish "connected but quiet" from "never
+     * connected".
+     */
+    onStatusChange(callback: (status: WsConnectionStatus) => void): () => void;
 }
 interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
     /** Opens the connection if not already open/connecting. Safe to call repeatedly. */
@@ -1733,6 +1757,10 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
      * client. Implicitly calls `connect()`. Returns an unsubscribe function.
      */
     onMessage(callback: (message: TMessage) => void): () => void;
+    /** Current connection status, read synchronously. See `WsConnectionStatus`. */
+    getStatus(): WsConnectionStatus;
+    /** Subscribes to connection status transitions. See `WsServiceClient.onStatusChange`. */
+    onStatusChange(callback: (status: WsConnectionStatus) => void): () => void;
 }
 /**
  * Creates a reconnecting, (usually) authenticated WebSocket client — the WS
@@ -1769,4 +1797,4 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateChannelWsServiceOptions<TMessage>): WsServiceClient<TMessage>;
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateBroadcastWsServiceOptions<TMessage>): BroadcastWsServiceClient<TMessage>;
 
-export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTrimmedRoute, useUserLocation };
+export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTrimmedRoute, useUserLocation };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as React from 'react';
 import React__default, { ReactNode } from 'react';
 import { R as RouteResponse, a as RouteStep, b as RouteRequest, c as RoutingBackendConfig } from './index-B9dDciJq.js';
 export { C as ClearRouteRequest, D as DrawRouteRequest, h as handleClearRoute, d as handleDrawRoute, e as handleRouteRequest } from './index-B9dDciJq.js';
-import { ViewState } from '@vis.gl/react-maplibre';
+import { ViewState, StyleSpecification, ImmutableLike } from '@vis.gl/react-maplibre';
 import * as react_dom_client from 'react-dom/client';
 import { ShapeType, ErrorCorrectionLevel, DotType, Gradient, CornerSquareType, CornerDotType } from 'qr-code-styling';
 import 'maplibre-gl';
@@ -681,8 +681,8 @@ interface MapProps {
     style?: React__default.CSSProperties;
     /** Minimum and maximum bounds for the map. */
     maxBounds?: [[number, number], [number, number]];
-    /** MapLibre style URL. Defaults to local server. */
-    mapStyle?: string;
+    /** MapLibre style URL, or an inline style spec object. Defaults to local server. */
+    mapStyle?: string | StyleSpecification | ImmutableLike<StyleSpecification>;
     /** Children components (Source, Layer, etc.) */
     children?: React__default.ReactNode;
     /** Additional CSS classes for the map container. */
@@ -1243,6 +1243,28 @@ declare class MiniAppSDK {
          */
         render: typeof renderMap;
     }>;
+    /**
+     * QR code generation — the single source of truth for every Mini-App.
+     * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
+     * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
+     * Mini-Apps must not reimplement this on their own.
+     */
+    readonly qrCode: Readonly<{
+        /**
+         * Decodes a QR code from a static image (base64 data URI or URL) —
+         * e.g. a photo picked via `sdk.media.pickImage()` that already
+         * contains a QR code, as an alternative to the live `<QRScanner>`.
+         * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
+         * @returns The decoded string, or `null` if no QR code was found.
+         */
+        decode: (imageDataUrl: string) => Promise<string | null>;
+        /**
+         * @param data The value to encode (e.g. a deep link).
+         * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
+         * @returns A base64 PNG data URI.
+         */
+        generate: (data: string, options?: IGenerateQrCodeOptions) => Promise<string>;
+    }>;
     private bridge;
     /**
      * Local SQLite Storage.
@@ -1349,28 +1371,6 @@ declare class MiniAppSDK {
          */
         saveImage: (base64: string, filename?: string) => Promise<ISaveImageResult>;
     }>;
-    /**
-     * QR code generation — the single source of truth for every Mini-App.
-     * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
-     * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
-     * Mini-Apps must not reimplement this on their own.
-     */
-    readonly qrCode: Readonly<{
-        /**
-         * @param data The value to encode (e.g. a deep link).
-         * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
-         * @returns A base64 PNG data URI.
-         */
-        generate: (data: string, options?: IGenerateQrCodeOptions) => Promise<string>;
-        /**
-         * Decodes a QR code from a static image (base64 data URI or URL) —
-         * e.g. a photo picked via `sdk.media.pickImage()` that already
-         * contains a QR code, as an alternative to the live `<QRScanner>`.
-         * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
-         * @returns The decoded string, or `null` if no QR code was found.
-         */
-        decode: (imageDataUrl: string) => Promise<string | null>;
-    }>;
     /**
      * Payments integration.
      */
@@ -1614,6 +1614,15 @@ interface WsMessage {
     event?: string;
     [key: string]: unknown;
 }
+/**
+ * `"open"` is the only state where the wire connection is actually live —
+ * `"connecting"` covers both the initial handshake and every reconnect
+ * backoff wait, `"closed"` covers not-yet-started and lost-and-not-yet-
+ * retried. A consumer that wants a poll-based fallback (only meaningful
+ * while genuinely disconnected) should treat anything other than `"open"`
+ * as "poll".
+ */
+type WsConnectionStatus = "connecting" | "open" | "closed";
 interface BaseWsServiceOptions<TMessage extends WsMessage> {
     /**
      * The REST client from `createApiService` — reused here for two things:
@@ -1720,6 +1729,21 @@ interface WsServiceClient<TMessage extends WsMessage = WsMessage> {
      * function.
      */
     onMessage(callback: (message: TMessage) => void): () => void;
+    /**
+     * Current connection status, read synchronously — no subscription needed
+     * for a one-off check.
+     */
+    getStatus(): WsConnectionStatus;
+    /**
+     * Subscribes to connection status transitions. Fires once immediately
+     * with the current status on subscribe, then again on every change.
+     * Returns an unsubscribe function. Intended for a consumer that wants a
+     * poll-based fallback only while genuinely disconnected (see
+     * `WsConnectionStatus`'s own doc comment) — driving that off `onMessage`
+     * pings alone can't distinguish "connected but quiet" from "never
+     * connected".
+     */
+    onStatusChange(callback: (status: WsConnectionStatus) => void): () => void;
 }
 interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
     /** Opens the connection if not already open/connecting. Safe to call repeatedly. */
@@ -1733,6 +1757,10 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
      * client. Implicitly calls `connect()`. Returns an unsubscribe function.
      */
     onMessage(callback: (message: TMessage) => void): () => void;
+    /** Current connection status, read synchronously. See `WsConnectionStatus`. */
+    getStatus(): WsConnectionStatus;
+    /** Subscribes to connection status transitions. See `WsServiceClient.onStatusChange`. */
+    onStatusChange(callback: (status: WsConnectionStatus) => void): () => void;
 }
 /**
  * Creates a reconnecting, (usually) authenticated WebSocket client — the WS
@@ -1769,4 +1797,4 @@ interface BroadcastWsServiceClient<TMessage extends WsMessage = WsMessage> {
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateChannelWsServiceOptions<TMessage>): WsServiceClient<TMessage>;
 declare function createWsService<TMessage extends WsMessage = WsMessage>(options: CreateBroadcastWsServiceOptions<TMessage>): BroadcastWsServiceClient<TMessage>;
 
-export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTrimmedRoute, useUserLocation };
+export { type ApiServiceClient, type BridgeMessageType, BridgeMocker, type BridgeMockerProps, type BroadcastWsServiceClient, type CenterCallbackParams, type CreateApiServiceOptions, type CreateBroadcastWsServiceOptions, type CreateChannelWsServiceOptions, type CreateWsServiceOptions, type CustomControl, DebugConsole, type DebugConsoleProps, type DeclarativeJourneyOptions, type DrawerState, type EtaData, type FidelityTransactionTypeType, type FlyToParams, GeolocationEvent, GlobalEvent, type HapticStyleType, type IBridgeEnvelope, type IContextState, type IEdgeInsets, type IFidelityBalance, type IFidelityHistoryParams, type IFidelityTransaction, type IGenerateQrCodeOptions, type IInitializationOptions, type IInitializationResponse, type ILocationData, type INetworkOptions, type INetworkResponse, type IPaymentRequest, type IPickImageResult, type ISaveImageResult, type IUserProfile, type LiveRoutingOptions, type LiveRoutingResult, type LocationStreamConfig, Map, MapControls, MapControlsContext, type MapControlsProps, type MapControlsState, type MapInsets, MapMenu, MapMenuDivider, type MapMenuDividerProps, MapMenuFooter, type MapMenuFooterProps, MapMenuItem, type MapMenuItemProps, type MapMenuProps, MapMenuTitle, type MapMenuTitleProps, type MapProps, type MenuItem, MiniAppSDK, MockLocationContext, type MockLocationContextType, type NetworkMethodType, type POI, QRScanner, type QRScannerProps, RouteLayer, type RouteLayerProps, RouteRequest, RouteResponse, RouteStep, type SDKEvent, SDKMapProvider, SDKProvider, type SDKProviderProps, type ScrollConfig, type StreamAccelerometerData, type StreamHeadingData, type StreamLocationData, type StreamUpdatePayload, type SwipeAxisPriority, SwipeCarousel, type SwipeCarouselItem, type SwipeCarouselProps, type SwipeCarouselVerticalDragConfig, UIEvent, type UseJourneyOptions, type UseJourneyResult, type UserLocationState, type WsConnectionStatus, type WsMessage, type WsServiceClient, createApiService, createWsService, sdk as default, renderMap, sdk, useIsMocked, useJourney, useLiveRouting, useMapControls, useMockLocation, useRoute, useTrimmedRoute, useUserLocation };

package/dist/index.js

@@ -161,35 +161,6 @@ var Bridge = class {
       return this.send(type, payload, timeoutMs, retries - 1);
     });
   }
-  sendOnce(type, payload, timeoutMs) {
-    return new Promise((resolve, reject) => {
-      const callbackId = `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
-      const timeout = setTimeout(() => {
-        if (this.callbacks.has(callbackId)) {
-          this.callbacks.delete(callbackId);
-          reject(new BridgeTimeoutError(`Bridge request timeout: ${type}`));
-        }
-      }, timeoutMs);
-      this.callbacks.set(callbackId, {
-        reject,
-        resolve,
-        timeout
-      });
-      const message = {
-        callbackId,
-        payload,
-        type
-      };
-      const win = window;
-      if (win.ReactNativeWebView?.postMessage) {
-        win.ReactNativeWebView.postMessage(JSON.stringify(message));
-      } else {
-        clearTimeout(timeout);
-        this.callbacks.delete(callbackId);
-        reject(new Error("Bridge not available"));
-      }
-    });
-  }
   /**
    * Internal handler for all incoming messages from the native shell.
    * Matches incoming payloads to either pending callbacks or event listeners.
@@ -237,6 +208,35 @@ var Bridge = class {
     console.warn(`[Bridge] Mock mode active: Unhandled message type ${type}`);
     return Promise.resolve();
   }
+  sendOnce(type, payload, timeoutMs) {
+    return new Promise((resolve, reject) => {
+      const callbackId = `${type}_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+      const timeout = setTimeout(() => {
+        if (this.callbacks.has(callbackId)) {
+          this.callbacks.delete(callbackId);
+          reject(new BridgeTimeoutError(`Bridge request timeout: ${type}`));
+        }
+      }, timeoutMs);
+      this.callbacks.set(callbackId, {
+        reject,
+        resolve,
+        timeout
+      });
+      const message = {
+        callbackId,
+        payload,
+        type
+      };
+      const win = window;
+      if (win.ReactNativeWebView?.postMessage) {
+        win.ReactNativeWebView.postMessage(JSON.stringify(message));
+      } else {
+        clearTimeout(timeout);
+        this.callbacks.delete(callbackId);
+        reject(new Error("Bridge not available"));
+      }
+    });
+  }
   /**
    * Determine environment. Check flag or cache result.
    */
@@ -2444,18 +2444,6 @@ var RouteLayer = ({
   ] });
 };
 
-// src/components/Map/Map.tsx
-import { Map as MapLibre, MapProvider } from "@vis.gl/react-maplibre";
-import React4, {
-  useCallback as useCallback6,
-  useContext as useContext5,
-  useEffect as useEffect7,
-  useMemo as useMemo6,
-  useRef as useRef7,
-  useState as useState8
-} from "react";
-import "maplibre-gl/dist/maplibre-gl.css";
-
 // src/components/Map/utils/geoCircle.ts
 var EARTH_RADIUS_METERS = 6371e3;
 var buildGeoCircle = (center, radiusMeters, points = 64) => {
@@ -2847,6 +2835,16 @@ var UserLocationLayer = ({
 };
 
 // src/components/Map/Map.tsx
+import { Map as MapLibre, MapProvider } from "@vis.gl/react-maplibre";
+import React4, {
+  useCallback as useCallback6,
+  useContext as useContext5,
+  useEffect as useEffect7,
+  useMemo as useMemo6,
+  useRef as useRef7,
+  useState as useState8
+} from "react";
+import "maplibre-gl/dist/maplibre-gl.css";
 import { Fragment as Fragment4, jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
 var MapInternal = ({
   initialViewState = {
@@ -3382,7 +3380,12 @@ async function generateQrCode(data, options = {}) {
   const outerPadding = options.outerPadding ?? 32;
   const borderRadiusPercent = options.borderRadius ?? DEFAULT_BORDER_RADIUS_PERCENT;
   const composed = label ? await composeWithLabel(qrDataUrl, label, size, backgroundColor, color) : qrDataUrl;
-  return finalizeImage(composed, outerPadding, borderRadiusPercent, backgroundColor);
+  return finalizeImage(
+    composed,
+    outerPadding,
+    borderRadiusPercent,
+    backgroundColor
+  );
 }
 var blobToDataUrl = (blob) => new Promise((resolve, reject) => {
   const reader = new FileReader();
@@ -3487,7 +3490,7 @@ var loadImage2 = (src) => new Promise((resolve, reject) => {
 });
 
 // package.json
-var version = "0.6.1";
+var version = "0.6.3";
 
 // src/sdk.ts
 function deepFreeze(obj) {
@@ -3515,6 +3518,28 @@ var MiniAppSDK = class {
      */
     render: renderMap
   });
+  /**
+   * QR code generation — the single source of truth for every Mini-App.
+   * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
+   * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
+   * Mini-Apps must not reimplement this on their own.
+   */
+  qrCode = Object.freeze({
+    /**
+     * Decodes a QR code from a static image (base64 data URI or URL) —
+     * e.g. a photo picked via `sdk.media.pickImage()` that already
+     * contains a QR code, as an alternative to the live `<QRScanner>`.
+     * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
+     * @returns The decoded string, or `null` if no QR code was found.
+     */
+    decode: (imageDataUrl) => decodeQrCode(imageDataUrl),
+    /**
+     * @param data The value to encode (e.g. a deep link).
+     * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
+     * @returns A base64 PNG data URI.
+     */
+    generate: (data, options) => generateQrCode(data, options)
+  });
   bridge;
   /**
    * Local SQLite Storage.
@@ -3618,28 +3643,6 @@ var MiniAppSDK = class {
      */
     saveImage: (base64, filename) => this.bridge.send("SAVE_IMAGE", { base64, filename })
   });
-  /**
-   * QR code generation — the single source of truth for every Mini-App.
-   * Runs entirely client-side (canvas, no Host Shell round-trip) and returns
-   * a base64 PNG data URI, ready for an `<img src>` or `media.saveImage()`.
-   * Mini-Apps must not reimplement this on their own.
-   */
-  qrCode = Object.freeze({
-    /**
-     * @param data The value to encode (e.g. a deep link).
-     * @param options Styling/labeling options — see {@link IGenerateQrCodeOptions}.
-     * @returns A base64 PNG data URI.
-     */
-    generate: (data, options) => generateQrCode(data, options),
-    /**
-     * Decodes a QR code from a static image (base64 data URI or URL) —
-     * e.g. a photo picked via `sdk.media.pickImage()` that already
-     * contains a QR code, as an alternative to the live `<QRScanner>`.
-     * @param imageDataUrl A base64 data URI (e.g. from `sdk.media.pickImage()`).
-     * @returns The decoded string, or `null` if no QR code was found.
-     */
-    decode: (imageDataUrl) => decodeQrCode(imageDataUrl)
-  });
   /**
    * Payments integration.
    */
@@ -3931,6 +3934,40 @@ function getMockAvatarUrl(seed) {
   const shortSeed = hashToShortSeed(seed);
   return `https://api.dicebear.com/10.x/notionists-neutral/png?seed=${shortSeed}&mouth=${AVATAR_MOUTH_VARIANTS}&eyes=${AVATAR_EYES_VARIANTS}&glassesProbability=50`;
 }
+function decodeMockJWTPayload(token) {
+  try {
+    const raw = token.startsWith("Bearer ") ? token.slice(7) : token;
+    const base64Url = raw.split(".")[1];
+    const base64 = base64Url.replace(/-/g, "+").replace(/_/g, "/");
+    const jsonPayload = decodeURIComponent(
+      atob(base64).split("").map((c) => `%${`00${c.charCodeAt(0).toString(16)}`.slice(-2)}`).join("")
+    );
+    return JSON.parse(jsonPayload);
+  } catch {
+    return null;
+  }
+}
+function buildMockProfile(mockJWTToken) {
+  const claims = mockJWTToken ? decodeMockJWTPayload(mockJWTToken) : null;
+  const uuid = claims?.sub || "mock-user-42";
+  const fullName = claims?.name || claims?.username || "Smart Caveman";
+  const username = claims?.username || "smart_caveman";
+  const [firstName, ...lastNameParts] = fullName.split(" ");
+  return {
+    admin: true,
+    countryCode: "FR",
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    email: "caveman@up.app",
+    firstName: firstName || "Smart",
+    fullName,
+    lastName: lastNameParts.join(" ") || "Caveman",
+    localNumber: "0600000000",
+    ups: 100,
+    username,
+    uuid,
+    xp: 500
+  };
+}
 var getBearing = (p1, p2) => {
   const lat1 = p1[1] * Math.PI / 180;
   const lat2 = p2[1] * Math.PI / 180;
@@ -4162,20 +4199,7 @@ var BridgeMocker = ({
           insets: { bottom: 0, left: 0, right: 0, top: 0 },
           name: "Vite Dev (Mock)",
           params: {},
-          profile: {
-            admin: true,
-            countryCode: "FR",
-            createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-            email: "caveman@up.app",
-            firstName: "Smart",
-            fullName: "Smart Caveman",
-            lastName: "Caveman",
-            localNumber: "0600000000",
-            ups: 100,
-            username: "smart_caveman",
-            uuid: "mock-user-42",
-            xp: 500
-          },
+          profile: buildMockProfile(stateRef.current.mockJWTToken),
           success: true,
           userData: {},
           uuid: appId || "mock-app-id",
@@ -4216,20 +4240,7 @@ var BridgeMocker = ({
         return Promise.resolve();
       }
       if (type === "GET_USER_PROFILE") {
-        return Promise.resolve({
-          admin: true,
-          countryCode: "FR",
-          createdAt: (/* @__PURE__ */ new Date()).toISOString(),
-          email: "caveman@up.app",
-          firstName: "Smart",
-          fullName: "Smart Caveman",
-          lastName: "Caveman",
-          localNumber: "0600000000",
-          ups: 100,
-          username: "smart_caveman",
-          uuid: "mock-user-42",
-          xp: 500
-        });
+        return Promise.resolve(buildMockProfile(stateRef.current.mockJWTToken));
       }
       if (type === "GET_PROFILE_PICTURE") {
         const uuids = payload?.uuids || [];
@@ -5093,6 +5104,13 @@ function createWsService(options) {
   let reconnectTimeout = null;
   let reconnectDelay = 1e3;
   let isConnecting = false;
+  let status = "closed";
+  const statusListeners = /* @__PURE__ */ new Set();
+  const setStatus = (next) => {
+    if (status === next) return;
+    status = next;
+    for (const cb of statusListeners) cb(status);
+  };
   const getWsUrl = () => options.baseUrl || options.api.wsUrl || "";
   const sendAction = (action, channelId) => {
     if (ws?.readyState === WebSocket.OPEN) {
@@ -5111,6 +5129,7 @@ function createWsService(options) {
       return;
     }
     isConnecting = true;
+    setStatus("connecting");
     try {
       const wsUrl = getWsUrl();
       if (!wsUrl) {
@@ -5118,6 +5137,7 @@ function createWsService(options) {
           "[WS] No WebSocket backend URL available, connection delayed."
         );
         isConnecting = false;
+        setStatus("closed");
         return;
       }
       let authParams = {};
@@ -5133,6 +5153,7 @@ function createWsService(options) {
       } else {
         console.warn("[WS] No auth available, connection delayed.");
         isConnecting = false;
+        setStatus("closed");
         return;
       }
       const params = new URLSearchParams({ ...options.query, ...authParams });
@@ -5140,6 +5161,7 @@ function createWsService(options) {
       ws = new WebSocket(query ? `${wsUrl}?${query}` : wsUrl);
       ws.onopen = () => {
         isConnecting = false;
+        setStatus("open");
         reconnectDelay = 1e3;
         if (channelField) {
           for (const channelId of subscriptions.keys()) {
@@ -5166,6 +5188,7 @@ function createWsService(options) {
       };
       ws.onclose = () => {
         isConnecting = false;
+        setStatus("closed");
         scheduleReconnect();
       };
       ws.onerror = (err) => {
@@ -5176,6 +5199,7 @@ function createWsService(options) {
     } catch (err) {
       console.error("[WS] Failed to establish connection:", err);
       isConnecting = false;
+      setStatus("closed");
       scheduleReconnect();
     }
   };
@@ -5189,6 +5213,15 @@ function createWsService(options) {
       ws.close();
       ws = null;
     }
+    setStatus("closed");
+  };
+  const getStatus = () => status;
+  const onStatusChange = (callback) => {
+    statusListeners.add(callback);
+    callback(status);
+    return () => {
+      statusListeners.delete(callback);
+    };
   };
   const subscribe = (channelId, callback) => {
     const isNewChannel = !subscriptions.has(channelId);
@@ -5214,9 +5247,16 @@ function createWsService(options) {
     };
   };
   if (channelField) {
-    return { connect, disconnect, onMessage, subscribe };
+    return {
+      connect,
+      disconnect,
+      getStatus,
+      onMessage,
+      onStatusChange,
+      subscribe
+    };
   }
-  return { connect, disconnect, onMessage };
+  return { connect, disconnect, getStatus, onMessage, onStatusChange };
 }
 
 // src/index.ts