@mappedin/blue-dot 6.0.1-beta.55 → 6.0.1-beta.57

package/lib/esm/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../packages/common/pubsub.ts", "../../src/blue-dot.ts"],
+  "sourcesContent": ["/**\n * Generic PubSub class implementing the Publish-Subscribe pattern for event handling.\n *\n * @template EVENT_PAYLOAD - The type of the event payload.\n * @template EVENT - The type of the event.\n */\nexport class PubSub<EVENT_PAYLOAD, EVENT extends keyof EVENT_PAYLOAD = keyof EVENT_PAYLOAD> {\n\t/**\n\t * @private\n\t * @internal\n\t */\n\tprivate _subscribers: any = {};\n\t/**\n\t * @private\n\t * @internal\n\t */\n\tprivate _destroyed = false;\n\n\t/**\n\t * @private\n\t * @internal\n\t */\n\tpublish<EVENT_NAME extends EVENT>(eventName: EVENT_NAME, data?: EVENT_PAYLOAD[EVENT_NAME]) {\n\t\tif (!this._subscribers || !this._subscribers[eventName] || this._destroyed) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis._subscribers[eventName]!.forEach(function (fn) {\n\t\t\tif (typeof fn !== 'function') {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tfn(data);\n\t\t});\n\t}\n\n\t/**\n\t * Subscribe a function to an event.\n\t *\n\t * @param eventName An event name which, when fired, will call the provided\n\t * function.\n\t * @param fn A callback that gets called when the corresponding event is fired. The\n\t * callback will get passed an argument with a type that's one of event payloads.\n\t * @example\n\t * // Subscribe to the 'click' event\n\t * const handler = (event) => {\n\t *  const { coordinate } = event;\n\t *  const { latitude, longitude } = coordinate;\n\t * \tconsole.log(`Map was clicked at ${latitude}, ${longitude}`);\n\t * };\n\t * map.on('click', handler);\n\t */\n\ton<EVENT_NAME extends EVENT>(\n\t\teventName: EVENT_NAME,\n\t\tfn: (\n\t\t\tpayload: EVENT_PAYLOAD[EVENT_NAME] extends {\n\t\t\t\tdata: null;\n\t\t\t}\n\t\t\t\t? EVENT_PAYLOAD[EVENT_NAME]['data']\n\t\t\t\t: EVENT_PAYLOAD[EVENT_NAME],\n\t\t) => void,\n\t) {\n\t\tif (!this._subscribers || this._destroyed) {\n\t\t\tthis._subscribers = {};\n\t\t}\n\t\tthis._subscribers[eventName] = this._subscribers[eventName] || [];\n\t\tthis._subscribers[eventName]!.push(fn);\n\t}\n\n\t/**\n\t * Unsubscribe a function previously subscribed with {@link on}\n\t *\n\t * @param eventName An event name to which the provided function was previously\n\t * subscribed.\n\t * @param fn A function that was previously passed to {@link on}. The function must\n\t * have the same reference as the function that was subscribed.\n\t * @example\n\t * // Unsubscribe from the 'click' event\n\t * const handler = (event) => {\n\t * \tconsole.log('Map was clicked', event);\n\t * };\n\t * map.off('click', handler);\n\t */\n\toff<EVENT_NAME extends EVENT>(\n\t\teventName: EVENT_NAME,\n\t\tfn: (\n\t\t\tpayload: EVENT_PAYLOAD[EVENT_NAME] extends {\n\t\t\t\tdata: null;\n\t\t\t}\n\t\t\t\t? EVENT_PAYLOAD[EVENT_NAME]['data']\n\t\t\t\t: EVENT_PAYLOAD[EVENT_NAME],\n\t\t) => void,\n\t) {\n\t\tif (!this._subscribers || this._subscribers[eventName] == null || this._destroyed) {\n\t\t\treturn;\n\t\t}\n\t\tconst itemIdx = this._subscribers[eventName]!.indexOf(fn);\n\n\t\tif (itemIdx !== -1) {\n\t\t\tthis._subscribers[eventName]!.splice(itemIdx, 1);\n\t\t}\n\t}\n\t/**\n\t * @private\n\t * @internal\n\t */\n\tdestroy() {\n\t\tthis._destroyed = true;\n\t\tthis._subscribers = {};\n\t}\n}\n", "import { PubSub } from '@packages/internal/common/pubsub';\nimport type { MapView } from '@mappedin/mappedin-js';\nimport type {\n\tBlueDotEventPayloads,\n\tBlueDotOptions,\n\tBlueDotPositionUpdate,\n\tBlueDotState,\n\tFollowCameraOptions,\n\tFollowMode,\n} from './types';\n\n/**\n * Show a Blue Dot indicating the device's position on the map.\n *\n * @example\n * ```ts\n * import { show3dMap } from '@mappedin/mappedin-js';\n * import { BlueDot } from '@mappedin/blue-dot';\n *\n * const mapView = await show3dMap(...);\n *\n * // Enable BlueDot\n * new BlueDot(mapView).enable();\n *\n * // Option 1: Listen for position updates from the device\n * mapView.BlueDot.on('position-update', (position) => {\n *   console.log('User position:', position);\n * });\n *\n * // Option 2: Update position manually\n * new BlueDot(mapView).update({ latitude, longitude, accuracy, floorOrFloorId });\n *\n * ```\n */\nexport class BlueDot {\n\t#pubsub = new PubSub<BlueDotEventPayloads>();\n\t#mapView: MapView;\n\n\t/**\n\t * Create a new {@link BlueDot} instance.\n\t */\n\tconstructor(mapView: MapView) {\n\t\tthis.#mapView = mapView;\n\t\tthis.#mapView.__BlueDot.on('blue-dot-position-error', e => {\n\t\t\tthis.#pubsub.publish('error', e);\n\t\t});\n\t\tthis.#mapView.__BlueDot.on('blue-dot-position-update', e => {\n\t\t\tthis.#pubsub.publish('position-update', e);\n\t\t});\n\t\tthis.#mapView.__BlueDot.on('blue-dot-state-change', e => {\n\t\t\tthis.#pubsub.publish('state-change', e);\n\t\t});\n\t\tthis.#mapView.__BlueDot.on('blue-dot-follow-change', e => {\n\t\t\tthis.#pubsub.publish('follow-change', e);\n\t\t});\n\t\tthis.#mapView.__BlueDot.on('click', e => {\n\t\t\tthis.#pubsub.publish('click', e);\n\t\t});\n\t\tthis.#mapView.__BlueDot.on('hover', () => {\n\t\t\tthis.#pubsub.publish('hover');\n\t\t});\n\t}\n\n\t/**\n\t * The current state of the BlueDot. Can be 'hidden', 'active', 'inactive', or 'disabled'.\n\t * Listen for state changes using the 'state-change' event.\n\t *\n\t * @example\n\t * mapView.BlueDot.on('state-change', ({ state }) => {\n\t *   if (state === 'active') {\n\t *     // BlueDot is visible and tracking\n\t *   }\n\t * });\n\t */\n\tget state(): BlueDotState {\n\t\treturn this.#mapView.__BlueDot.state;\n\t}\n\n\t/**\n\t * Whether the BlueDot is currently following the user (camera follow mode).\n\t */\n\tget following() {\n\t\treturn this.#mapView.__BlueDot.following;\n\t}\n\n\t/**\n\t * The direction the user is facing in degrees from north clockwise.\n\t * @see https://developer.mozilla.org/en-US/docs/Web/API/GeolocationCoordinates/heading\n\t */\n\tget heading() {\n\t\treturn this.#mapView.__BlueDot.heading;\n\t}\n\n\t/**\n\t * The accuracy of the current position in metres.\n\t */\n\tget accuracy() {\n\t\treturn this.#mapView.__BlueDot.accuracy;\n\t}\n\n\t/**\n\t * The coordinate of the current position.\n\t */\n\tget coordinate() {\n\t\treturn this.#mapView.__BlueDot.coordinate;\n\t}\n\n\t/**\n\t * The floor the Blue Dot is currently on. If undefined, the Blue Dot will appear on every floor.\n\t */\n\tget floor() {\n\t\treturn this.#mapView.__BlueDot.floor;\n\t}\n\n\t/**\n\t * Enable the Blue Dot. It will be hidden until a position is received either from the browser or by calling {@link BlueDot.update}.\n\t * @param options - The options to setup the Blue Dot (see {@link BlueDotOptions}).\n\t *\n\t * @example Enable with default options\n\t * mapView.BlueDot.enable();\n\t *\n\t * @example Enable with custom color and accuracy ring\n\t * mapView.BlueDot.enable({ color: '#00ff00', accuracyRing: { color: '#00ff00', opacity: 0.2 } });\n\t *\n\t * @see See the [BlueDot Guide](https://developer.mappedin.com/web-sdk/blue-dot) for more information.\n\t */\n\tenable = (options?: BlueDotOptions) => {\n\t\tthis.#mapView.__BlueDot.enable(options);\n\t};\n\n\t/**\n\t * Disable the Blue Dot. It will be hidden and no longer update.\n\t */\n\tdisable = () => {\n\t\tthis.#mapView.__BlueDot.disable();\n\t};\n\n\ton: PubSub<BlueDotEventPayloads>['on'] = (eventName, fn) => {\n\t\tthis.#pubsub.on(eventName, fn);\n\t};\n\n\toff: PubSub<BlueDotEventPayloads>['off'] = (eventName, fn) => {\n\t\tthis.#pubsub.off(eventName, fn);\n\t};\n\n\t/**\n\t * Enable or disable the devices's geolocation listener to automatically position the Blue Dot.\n\t * If enabled, the device will request permission to access the user's precise location.\n\t * @param watch - Whether to enable or disable the listener.\n\t */\n\twatchDevicePosition = (watch = true) => {\n\t\tthis.#mapView.__BlueDot.watchDevicePosition(watch);\n\t};\n\n\t/**\n\t * Manually override some position properties of the Blue Dot.\n\t * Accepts a full GeolocationPosition object or a partial {@link BlueDotPositionUpdate} object.\n\t * @example Manually set the accuracy and heading\n\t * ```ts\n\t * api.BlueDot.update({ accuracy: 10, heading: 90 });\n\t * ```\n\t * @example Reset accuracy and heading to device values\n\t * ```ts\n\t * api.BlueDot.update({ accuracy: 'device', heading: 'device' });\n\t * ```\n\t */\n\tupdate = (position: BlueDotPositionUpdate) => {\n\t\tthis.#mapView.__BlueDot.update(position);\n\t};\n\n\t/**\n\t * Set the camera to follow the BlueDot in various modes. User interaction will cancel following automatically.\n\t * @param mode The follow mode ('position-only', 'position-and-heading', 'position-and-path-direction', or false to disable).\n\t * @param cameraOptions Optional camera options (zoom, pitch, etc.).\n\t *\n\t * @example\n\t * mapView.BlueDot.follow('position-and-heading', { zoomLevel: 21, pitch: 45 });\n\t */\n\tfollow = (mode: FollowMode, cameraOptions?: FollowCameraOptions) => {\n\t\tthis.#mapView.__BlueDot.follow(mode, cameraOptions);\n\t};\n\n\tdestroy = () => {\n\t\tthis.#pubsub.destroy();\n\t};\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/lib/rn/index-rn.d.ts

@@ -0,0 +1,4 @@
+export { useBlueDot } from './rn/use-blue-dot';
+export { useBlueDotEvent } from './rn/use-blue-dot-events';
+export type { UseBlueDotResult, BlueDotExtensionState } from './rn/use-blue-dot';
+import './rn/extension-augmentation';

package/lib/rn/index-rn.js

@@ -0,0 +1,295 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/rn/use-blue-dot.ts
+import { useCallback as useCallback2, useContext as useContext2, useRef } from "react";
+import { MappedinContext as MappedinContext2 } from "@mappedin/react-native-sdk";
+
+// src/rn/use-blue-dot-events.ts
+import { useCallback, useContext } from "react";
+import {
+  MappedinContext,
+  useEventCallback,
+  createEventSetupScript,
+  createEventCleanupScript
+} from "@mappedin/react-native-sdk";
+
+// src/rn/use-blue-dot-registration.ts
+import { useRegisterExtension } from "@mappedin/react-native-sdk";
+
+// src/rn/extension-source.ts
+var EXTENSION_SOURCE_PLACEHOLDER = `
+			// Define require function that uses bridge.modules for external dependencies
+			globalThis.require = globalThis.require || ((id) => {
+				if (window.bridge?.modules?.[id]) {
+					return window.bridge.modules[id];
+				}
+				throw new Error('Module not found: ' + id);
+			});
+			
+"use strict";var BlueDot=(()=>{var a=Object.defineProperty;var A=Object.getOwnPropertyDescriptor;var f=Object.getOwnPropertyNames;var B=Object.prototype.hasOwnProperty;var c=o=>{throw TypeError(o)};var V=(o,t,e)=>t in o?a(o,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):o[t]=e;var l=(o,t)=>a(o,"name",{value:t,configurable:!0});var T=(o,t)=>{for(var e in t)a(o,e,{get:t[e],enumerable:!0})},y=(o,t,e,E)=>{if(t&&typeof t=="object"||typeof t=="function")for(let _ of f(t))!B.call(o,_)&&_!==e&&a(o,_,{get:()=>t[_],enumerable:!(E=A(t,_))||E.enumerable});return o};var P=o=>y(a({},"__esModule",{value:!0}),o);var r=(o,t,e)=>V(o,typeof t!="symbol"?t+"":t,e),D=(o,t,e)=>t.has(o)||c("Cannot "+e);var s=(o,t,e)=>(D(o,t,"read from private field"),e?e.call(o):t.get(o)),d=(o,t,e)=>t.has(o)?c("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(o):t.set(o,e),N=(o,t,e,E)=>(D(o,t,"write to private field"),E?E.call(o,e):t.set(o,e),e);var w={};T(w,{BlueDot:()=>h});var p=class p{constructor(){r(this,"_subscribers",{});r(this,"_destroyed",!1)}publish(t,e){!this._subscribers||!this._subscribers[t]||this._destroyed||this._subscribers[t].forEach(function(E){typeof E=="function"&&E(e)})}on(t,e){(!this._subscribers||this._destroyed)&&(this._subscribers={}),this._subscribers[t]=this._subscribers[t]||[],this._subscribers[t].push(e)}off(t,e){if(!this._subscribers||this._subscribers[t]==null||this._destroyed)return;let E=this._subscribers[t].indexOf(e);E!==-1&&this._subscribers[t].splice(E,1)}destroy(){this._destroyed=!0,this._subscribers={}}};l(p,"PubSub");var n=p;var u,i,b=class b{constructor(t){d(this,u,new n);d(this,i);r(this,"enable",l(t=>{s(this,i).__BlueDot.enable(t)},"enable"));r(this,"disable",l(()=>{s(this,i).__BlueDot.disable()},"disable"));r(this,"on",l((t,e)=>{s(this,u).on(t,e)},"on"));r(this,"off",l((t,e)=>{s(this,u).off(t,e)},"off"));r(this,"watchDevicePosition",l((t=!0)=>{s(this,i).__BlueDot.watchDevicePosition(t)},"watchDevicePosition"));r(this,"update",l(t=>{s(this,i).__BlueDot.update(t)},"update"));r(this,"follow",l((t,e)=>{s(this,i).__BlueDot.follow(t,e)},"follow"));r(this,"destroy",l(()=>{s(this,u).destroy()},"destroy"));N(this,i,t),s(this,i).__BlueDot.on("blue-dot-position-error",e=>{s(this,u).publish("error",e)}),s(this,i).__BlueDot.on("blue-dot-position-update",e=>{s(this,u).publish("position-update",e)}),s(this,i).__BlueDot.on("blue-dot-state-change",e=>{s(this,u).publish("state-change",e)}),s(this,i).__BlueDot.on("blue-dot-follow-change",e=>{s(this,u).publish("follow-change",e)}),s(this,i).__BlueDot.on("click",e=>{s(this,u).publish("click",e)}),s(this,i).__BlueDot.on("hover",()=>{s(this,u).publish("hover")})}get state(){return s(this,i).__BlueDot.state}get following(){return s(this,i).__BlueDot.following}get heading(){return s(this,i).__BlueDot.heading}get accuracy(){return s(this,i).__BlueDot.accuracy}get coordinate(){return s(this,i).__BlueDot.coordinate}get floor(){return s(this,i).__BlueDot.floor}};u=new WeakMap,i=new WeakMap,l(b,"BlueDot");var h=b;return P(w);})();
+//# sourceMappingURL=blue-dot.iife.js.map
+
+
+// Register the extension
+if (window.bridge && window.bridge.extensions) {
+  try {
+    window.bridge.extensions.register({ name: 'blue-dot', package: { Extension: BlueDot.BlueDot } });
+    if (window.rnDebug) window.rnDebug('BlueDot Extension Registered');
+  } catch(e) {
+    if (window.rnDebug) window.rnDebug('Failed to register blue-dot extension: ' + e.message);
+  }
+} else {
+  if (window.rnDebug) window.rnDebug('Bridge or extensions not available for registration');
+}`;
+function getRegistrationScript() {
+  return EXTENSION_SOURCE_PLACEHOLDER;
+}
+__name(getRegistrationScript, "getRegistrationScript");
+
+// ../packages/common/Mappedin.Logger.ts
+var MI_ERROR_LABEL = "[MappedinJS]";
+function createLogger(name = "", { prefix = MI_ERROR_LABEL } = {}) {
+  const label = `${prefix}${name ? `-${name}` : ""}`;
+  const rnDebug = /* @__PURE__ */ __name((type, args) => {
+    if (typeof window !== "undefined" && window.rnDebug) {
+      const processed = args.map((arg) => {
+        if (arg instanceof Error && arg.stack) {
+          return `${arg.message}
+${arg.stack}`;
+        }
+        return arg;
+      });
+      window.rnDebug(`${name} ${type}: ${processed.join(" ")}`);
+    }
+  }, "rnDebug");
+  return {
+    logState: false ? 3 /* SILENT */ : 0 /* LOG */,
+    log(...args) {
+      if (this.logState <= 0 /* LOG */) {
+        console.log(label, ...args);
+        rnDebug("log", args);
+      }
+    },
+    warn(...args) {
+      if (this.logState <= 1 /* WARN */) {
+        console.warn(label, ...args);
+        rnDebug("warn", args);
+      }
+    },
+    error(...args) {
+      if (this.logState <= 2 /* ERROR */) {
+        console.error(label, ...args);
+        rnDebug("error", args);
+      }
+    },
+    // It's a bit tricky to prepend [MappedinJs] to assert and time because of how the output is structured in the console, so it is left out for simplicity
+    assert(...args) {
+      console.assert(...args);
+    },
+    time(label2) {
+      console.time(label2);
+    },
+    timeEnd(label2) {
+      console.timeEnd(label2);
+    },
+    setLevel(level) {
+      if (0 /* LOG */ <= level && level <= 3 /* SILENT */) {
+        this.logState = level;
+      }
+    }
+  };
+}
+__name(createLogger, "createLogger");
+var Logger = createLogger();
+var Mappedin_Logger_default = Logger;
+
+// src/rn/use-blue-dot-registration.ts
+function useBlueDotRegistration() {
+  useRegisterExtension({
+    extensionName: "blue-dot",
+    getRegistrationScript,
+    logger: {
+      log: /* @__PURE__ */ __name((message) => Mappedin_Logger_default.log(message), "log"),
+      error: /* @__PURE__ */ __name((message, error) => Mappedin_Logger_default.error(message, error), "error")
+    }
+  });
+}
+__name(useBlueDotRegistration, "useBlueDotRegistration");
+
+// src/rn/use-blue-dot-events.ts
+function useBlueDotEvent(eventName, callback) {
+  if (typeof eventName !== "string" || eventName.length === 0) {
+    throw new Error("Event parameter must be a non-empty string");
+  }
+  if (typeof callback !== "function") {
+    throw new Error("Callback parameter must be a function");
+  }
+  const context = useContext(MappedinContext);
+  const { extensions, mapData } = context;
+  if (!mapData) {
+    throw new Error("Map data is not available");
+  }
+  useBlueDotRegistration();
+  const extensionRegistrationState = extensions?.["blue-dot"]?.registrationState || "unregistered";
+  const extensionIsReady = extensionRegistrationState === "registered";
+  const processedCallback = useCallback(
+    (payload) => {
+      try {
+        callback(payload);
+      } catch (error) {
+        console.error(`Error in blue dot event callback for ${String(eventName)}:`, error);
+      }
+    },
+    [eventName, callback]
+  );
+  useEventCallback({
+    eventKey: `blue-dot:${String(eventName)}`,
+    callback: processedCallback,
+    setupScript: /* @__PURE__ */ __name(() => createEventSetupScript({
+      extensionName: "blue-dot",
+      eventName
+    }), "setupScript"),
+    cleanupScript: /* @__PURE__ */ __name(() => createEventCleanupScript({
+      extensionName: "blue-dot",
+      eventName
+    }), "cleanupScript"),
+    shouldInject: extensionIsReady
+  });
+}
+__name(useBlueDotEvent, "useBlueDotEvent");
+
+// src/rn/use-blue-dot.ts
+function useBlueDot() {
+  const context = useContext2(MappedinContext2);
+  const { bridge, extensions, updateExtensionState } = context;
+  useBlueDotRegistration();
+  const extensionState = extensions["blue-dot"];
+  const registrationState = extensionState?.registrationState || "unregistered";
+  const isReady = registrationState === "registered";
+  const isEnabled = extensionState?.isEnabled || false;
+  const state = extensionState?.state || "hidden";
+  const following = extensionState?.following || false;
+  const position = extensionState?.position;
+  const floor = extensionState?.floor;
+  const accuracy = extensionState?.accuracy;
+  const heading = extensionState?.heading;
+  const extensionsRef = useRef(extensions);
+  extensionsRef.current = extensions;
+  useBlueDotEvent(
+    "position-update",
+    useCallback2(
+      (event) => {
+        updateExtensionState("blue-dot", (prev) => ({
+          ...prev,
+          position: event.coordinate,
+          floor: event.floor,
+          accuracy: event.accuracy ?? void 0,
+          heading: event.heading ?? void 0
+        }));
+      },
+      [updateExtensionState]
+    )
+  );
+  useBlueDotEvent(
+    "state-change",
+    useCallback2(
+      (event) => {
+        updateExtensionState("blue-dot", (prev) => ({
+          ...prev,
+          state: event.state
+        }));
+      },
+      [updateExtensionState]
+    )
+  );
+  useBlueDotEvent(
+    "follow-change",
+    useCallback2(
+      (event) => {
+        updateExtensionState("blue-dot", (prev) => ({
+          ...prev,
+          following: event.following
+        }));
+      },
+      [updateExtensionState]
+    )
+  );
+  const callExtensionMethod = useCallback2(
+    async (method, args = []) => {
+      if (!bridge?.isReady) {
+        throw new Error("Bridge is not ready. Ensure the WebView is loaded.");
+      }
+      return await bridge.instruct({
+        type: "extension",
+        payload: {
+          name: "blue-dot",
+          method,
+          args
+        }
+      });
+    },
+    [bridge]
+  );
+  const enable = useCallback2(
+    async (options) => {
+      const currentExtensionState = extensionsRef.current?.["blue-dot"];
+      const currentIsEnabled = currentExtensionState?.isEnabled || false;
+      if (currentIsEnabled) {
+        return;
+      }
+      await callExtensionMethod("enable", [options]);
+      updateExtensionState("blue-dot", (prev) => ({ ...prev, isEnabled: true }));
+    },
+    [callExtensionMethod, updateExtensionState]
+  );
+  const disable = useCallback2(async () => {
+    await callExtensionMethod("disable");
+    updateExtensionState("blue-dot", {
+      registrationState: "unregistered",
+      isEnabled: false,
+      state: "hidden",
+      position: void 0,
+      floor: void 0,
+      following: false,
+      accuracy: void 0,
+      heading: void 0
+    });
+  }, [callExtensionMethod, updateExtensionState]);
+  const update = useCallback2(
+    async (positionUpdate) => {
+      return await callExtensionMethod("update", [positionUpdate]);
+    },
+    [callExtensionMethod]
+  );
+  const follow = useCallback2(
+    async (mode, options) => {
+      return await callExtensionMethod("follow", [mode, options]);
+    },
+    [callExtensionMethod]
+  );
+  const unfollow = useCallback2(async () => {
+    return await callExtensionMethod("unfollow");
+  }, [callExtensionMethod]);
+  return {
+    isReady,
+    isEnabled,
+    state,
+    position,
+    floor,
+    following,
+    accuracy,
+    heading,
+    enable,
+    disable,
+    update,
+    follow,
+    unfollow
+  };
+}
+__name(useBlueDot, "useBlueDot");
+export {
+  useBlueDot,
+  useBlueDotEvent
+};
+//# sourceMappingURL=index-rn.js.map

package/lib/rn/index-rn.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/rn/use-blue-dot.ts", "../../src/rn/use-blue-dot-events.ts", "../../src/rn/use-blue-dot-registration.ts", "../../src/rn/extension-source.ts", "../../../packages/common/Mappedin.Logger.ts"],
+  "sourcesContent": ["import { useCallback, useContext, useRef } from 'react';\nimport type { BlueDotOptions, BlueDotPositionUpdate, BlueDotState, FollowMode, FollowCameraOptions } from '../types';\nimport { MappedinContext } from '@mappedin/react-native-sdk';\nimport type { Coordinate, Floor } from '@mappedin/mappedin-js';\nimport { useBlueDotEvent } from './use-blue-dot-events';\nimport { useBlueDotRegistration } from './use-blue-dot-registration';\n\n/**\n * Extension state for Blue Dot that includes the current state and position\n */\nexport interface BlueDotExtensionState {\n\t/**\n\t * Whether the extension is currently enabled\n\t */\n\tisEnabled: boolean;\n\t/**\n\t * The current state of the Blue Dot\n\t */\n\tstate: BlueDotState;\n\t/**\n\t * The current position of the Blue Dot\n\t */\n\tposition?: Coordinate;\n\t/**\n\t * The current floor of the Blue Dot\n\t */\n\tfloor?: Floor;\n\t/**\n\t * Whether the Blue Dot is currently following the user\n\t */\n\tfollowing: boolean;\n\t/**\n\t * The accuracy of the current position in metres\n\t */\n\taccuracy?: number;\n\t/**\n\t * The direction the user is facing in degrees from north clockwise\n\t */\n\theading?: number;\n}\n\n// Blue Dot hook return type\nexport interface UseBlueDotResult {\n\t/**\n\t * Whether the extension is ready and initialized\n\t */\n\tisReady: boolean;\n\t/**\n\t * Whether the extension is currently enabled\n\t */\n\tisEnabled: boolean;\n\t/**\n\t * The current state of the Blue Dot\n\t */\n\tstate: BlueDotState;\n\t/**\n\t * The current position of the Blue Dot\n\t */\n\tposition?: Coordinate;\n\t/**\n\t * The current floor of the Blue Dot\n\t */\n\tfloor?: Floor;\n\t/**\n\t * Whether the Blue Dot is currently following the user\n\t */\n\tfollowing: boolean;\n\t/**\n\t * The accuracy of the current position in metres\n\t */\n\taccuracy?: number;\n\t/**\n\t * The direction the user is facing in degrees from north clockwise\n\t */\n\theading?: number;\n\n\t/**\n\t * Enables Blue Dot with the given options.\n\t * @param options - The options to enable Blue Dot with\n\t * @returns Promise that resolves when enabling is complete\n\t * @see {@link BlueDot.enable}\n\t */\n\tenable(options?: BlueDotOptions): Promise<void>;\n\n\t/**\n\t * Disables the Blue Dot instance and unsubscribes all MapView event listeners.\n\t * @returns Promise that resolves when disabling is complete\n\t * @see {@link BlueDot.disable}\n\t */\n\tdisable(): Promise<void>;\n\n\t/**\n\t * Update the Blue Dot's position manually.\n\t * @param position - The position update options\n\t * @returns Promise that resolves when the update is complete\n\t * @see {@link BlueDot.update}\n\t */\n\tupdate(position: BlueDotPositionUpdate): Promise<void>;\n\n\t/**\n\t * Enable follow mode for the Blue Dot.\n\t * @param mode - The follow mode to enable\n\t * @param options - The follow camera options\n\t * @returns Promise that resolves when follow mode is enabled\n\t * @see {@link BlueDot.follow}\n\t */\n\tfollow(mode: FollowMode, options?: FollowCameraOptions): Promise<void>;\n\n\t/**\n\t * Disable follow mode for the Blue Dot.\n\t * @returns Promise that resolves when follow mode is disabled\n\t * @see {@link BlueDot.unfollow}\n\t */\n\tunfollow(): Promise<void>;\n}\n\n/**\n * React hook for using BlueDot extension in React Native WebView\n *\n * This hook provides an API for interacting with the BlueDot extension:\n * - Uses the shared state system for automatic extension registration\n * - Provides methods for controlling blue dot behavior\n * - Handles bridge communication and error management\n *\n * @returns Hook API object with Blue Dot methods\n *\n * @example\n * ```tsx\n * import { MapView } from '@mappedin/react-native-sdk';\n * import { useBlueDot } from '@mappedin/blue-dot/rn';\n *\n * function MyComponent() {\n *   const { enable, isReady, state, following } = useBlueDot();\n *\n *   // Use the Blue Dot API\n *   React.useEffect(() => {\n *     if (isReady) {\n *       enable({ radius: 15, color: '#ff0000' });\n *     }\n *   }, [isReady]);\n * }\n * ```\n */\nexport function useBlueDot(): UseBlueDotResult {\n\tconst context = useContext(MappedinContext);\n\tconst { bridge, extensions, updateExtensionState } = context;\n\n\t// Use registration hook to handle extension registration (no parameters needed)\n\tuseBlueDotRegistration();\n\n\t// Get extension state from context - properly typed now, no casting needed!\n\tconst extensionState = extensions['blue-dot'];\n\tconst registrationState = extensionState?.registrationState || 'unregistered';\n\tconst isReady = registrationState === 'registered'; // Backward compatibility\n\tconst isEnabled = extensionState?.isEnabled || false;\n\tconst state = extensionState?.state || 'hidden';\n\tconst following = extensionState?.following || false;\n\tconst position = extensionState?.position;\n\tconst floor = extensionState?.floor;\n\tconst accuracy = extensionState?.accuracy;\n\tconst heading = extensionState?.heading;\n\n\t// Use ref to maintain stable reference for extensions for memoization\n\tconst extensionsRef = useRef(extensions);\n\n\t// Update ref on each render\n\textensionsRef.current = extensions;\n\n\t// Extension registration is handled by useRegisterExtensionHook\n\n\t// Listen for position-update events to update position data\n\tuseBlueDotEvent(\n\t\t'position-update',\n\t\tuseCallback(\n\t\t\tevent => {\n\t\t\t\t// Update extension state to persist position data - use callback to merge\n\t\t\t\tupdateExtensionState('blue-dot', prev => ({\n\t\t\t\t\t...prev,\n\t\t\t\t\tposition: event.coordinate,\n\t\t\t\t\tfloor: event.floor,\n\t\t\t\t\taccuracy: event.accuracy ?? undefined,\n\t\t\t\t\theading: event.heading ?? undefined,\n\t\t\t\t}));\n\t\t\t},\n\t\t\t[updateExtensionState],\n\t\t),\n\t);\n\n\t// Listen for state-change events to update state\n\tuseBlueDotEvent(\n\t\t'state-change',\n\t\tuseCallback(\n\t\t\tevent => {\n\t\t\t\t// Update extension state to reflect state changes - use callback to merge\n\t\t\t\tupdateExtensionState('blue-dot', prev => ({\n\t\t\t\t\t...prev,\n\t\t\t\t\tstate: event.state,\n\t\t\t\t}));\n\t\t\t},\n\t\t\t[updateExtensionState],\n\t\t),\n\t);\n\n\t// Listen for follow-change events to update following state\n\tuseBlueDotEvent(\n\t\t'follow-change',\n\t\tuseCallback(\n\t\t\tevent => {\n\t\t\t\t// Update extension state to reflect following changes - use callback to merge\n\t\t\t\tupdateExtensionState('blue-dot', prev => ({\n\t\t\t\t\t...prev,\n\t\t\t\t\tfollowing: event.following,\n\t\t\t\t}));\n\t\t\t},\n\t\t\t[updateExtensionState],\n\t\t),\n\t);\n\n\t/**\n\t * Helper function to make extension method calls through the bridge\n\t */\n\tconst callExtensionMethod = useCallback(\n\t\tasync <T = any>(method: string, args: any[] = []): Promise<T> => {\n\t\t\tif (!bridge?.isReady) {\n\t\t\t\tthrow new Error('Bridge is not ready. Ensure the WebView is loaded.');\n\t\t\t}\n\n\t\t\treturn (await bridge.instruct({\n\t\t\t\ttype: 'extension',\n\t\t\t\tpayload: {\n\t\t\t\t\tname: 'blue-dot',\n\t\t\t\t\tmethod,\n\t\t\t\t\targs,\n\t\t\t\t},\n\t\t\t})) as T;\n\t\t},\n\t\t[bridge],\n\t);\n\n\t// Memoize the enable method to prevent unnecessary re-renders\n\tconst enable = useCallback(\n\t\tasync (options?: BlueDotOptions): Promise<void> => {\n\t\t\t// Get current isEnabled state from context using ref to avoid dependency\n\t\t\tconst currentExtensionState = extensionsRef.current?.['blue-dot'];\n\t\t\tconst currentIsEnabled = currentExtensionState?.isEnabled || false;\n\n\t\t\t// Check if already enabled to avoid unnecessary calls\n\t\t\tif (currentIsEnabled) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tawait callExtensionMethod<void>('enable', [options]);\n\n\t\t\t// Update extension state to reflect enabled status - use callback to merge\n\t\t\tupdateExtensionState('blue-dot', prev => ({ ...prev, isEnabled: true }));\n\t\t},\n\t\t[callExtensionMethod, updateExtensionState],\n\t);\n\n\t// Memoize the disable method to prevent unnecessary re-renders\n\tconst disable = useCallback(async (): Promise<void> => {\n\t\tawait callExtensionMethod<void>('disable');\n\n\t\t// Reset all state after disabling - replace entire state in this case\n\t\tupdateExtensionState('blue-dot', {\n\t\t\tregistrationState: 'unregistered',\n\t\t\tisEnabled: false,\n\t\t\tstate: 'hidden',\n\t\t\tposition: undefined,\n\t\t\tfloor: undefined,\n\t\t\tfollowing: false,\n\t\t\taccuracy: undefined,\n\t\t\theading: undefined,\n\t\t});\n\t}, [callExtensionMethod, updateExtensionState]);\n\n\t// Memoize the update method to prevent unnecessary re-renders\n\tconst update = useCallback(\n\t\tasync (positionUpdate: BlueDotPositionUpdate): Promise<void> => {\n\t\t\treturn await callExtensionMethod<void>('update', [positionUpdate]);\n\t\t},\n\t\t[callExtensionMethod],\n\t);\n\n\t// Memoize the follow method to prevent unnecessary re-renders\n\tconst follow = useCallback(\n\t\tasync (mode: FollowMode, options?: FollowCameraOptions): Promise<void> => {\n\t\t\treturn await callExtensionMethod<void>('follow', [mode, options]);\n\t\t},\n\t\t[callExtensionMethod],\n\t);\n\n\t// Memoize the unfollow method to prevent unnecessary re-renders\n\tconst unfollow = useCallback(async (): Promise<void> => {\n\t\treturn await callExtensionMethod<void>('unfollow');\n\t}, [callExtensionMethod]);\n\n\t// Return hook API with Blue Dot methods\n\treturn {\n\t\tisReady,\n\t\tisEnabled,\n\t\tstate,\n\t\tposition,\n\t\tfloor,\n\t\tfollowing,\n\t\taccuracy,\n\t\theading,\n\t\tenable,\n\t\tdisable,\n\t\tupdate,\n\t\tfollow,\n\t\tunfollow,\n\t};\n}\n", "import { useCallback, useContext } from 'react';\nimport {\n\tMappedinContext,\n\tuseEventCallback,\n\tcreateEventSetupScript,\n\tcreateEventCleanupScript,\n} from '@mappedin/react-native-sdk';\nimport type { BlueDotEvents, BlueDotEventPayloads } from '../types';\nimport { useBlueDotRegistration } from './use-blue-dot-registration';\n\n/**\n * React hook for subscribing to BlueDot extension events in React Native WebView\n *\n * This hook provides a React-friendly way to listen for BlueDot events:\n * - Automatically manages event subscription/unsubscription\n * - Handles WebView bridge message routing\n * - Provides type-safe event payload handling\n * - Cleans up listeners on component unmount\n *\n * @param eventName - The name of the BlueDot event to listen for\n * @param callback - The callback function to invoke when the event occurs\n *\n * @example\n * ```tsx\n * import { useBlueDotEvent } from '@mappedin/blue-dot/rn';\n *\n * function MyComponent() {\n *   // Listen for position updates\n *   useBlueDotEvent('position-update', (event) => {\n *     console.log('New position:', event.coordinate);\n *     console.log('Floor:', event.floor?.name);\n *     console.log('Accuracy:', event.accuracy);\n *   });\n *\n *   // Listen for state changes\n *   useBlueDotEvent('state-change', (event) => {\n *     console.log('Blue Dot state changed to:', event.state);\n *     console.log('Action that caused change:', event.action);\n *   });\n *\n *   // Listen for follow mode changes\n *   useBlueDotEvent('follow-change', (event) => {\n *     console.log('Following:', event.following);\n *     console.log('Mode:', event.mode);\n *   });\n * }\n * ```\n */\nexport function useBlueDotEvent<K extends BlueDotEvents>(\n\teventName: K,\n\tcallback: (payload: BlueDotEventPayloads[K]) => void,\n): void {\n\t// Parameter validation\n\tif (typeof eventName !== 'string' || eventName.length === 0) {\n\t\tthrow new Error('Event parameter must be a non-empty string');\n\t}\n\n\tif (typeof callback !== 'function') {\n\t\tthrow new Error('Callback parameter must be a function');\n\t}\n\n\tconst context = useContext(MappedinContext);\n\tconst { extensions, mapData } = context;\n\n\tif (!mapData) {\n\t\tthrow new Error('Map data is not available');\n\t}\n\n\t// Use registration hook to ensure extension is registered\n\tuseBlueDotRegistration();\n\n\t// Get extension readiness from context only\n\tconst extensionRegistrationState = extensions?.['blue-dot']?.registrationState || 'unregistered';\n\tconst extensionIsReady = extensionRegistrationState === 'registered';\n\n\t// Create a callback wrapper that handles error catching\n\tconst processedCallback = useCallback(\n\t\t(payload: BlueDotEventPayloads[K]) => {\n\t\t\ttry {\n\t\t\t\t// For Blue Dot events, we don't need complex payload hydration like dynamic-focus\n\t\t\t\t// Call the callback directly with the payload\n\t\t\t\tcallback(payload);\n\t\t\t} catch (error) {\n\t\t\t\t// eslint-disable-next-line\n\t\t\t\tconsole.error(`Error in blue dot event callback for ${String(eventName)}:`, error);\n\t\t\t}\n\t\t},\n\t\t[eventName, callback],\n\t);\n\n\t// Use the shared event callback hook with blue dot specific setup/cleanup\n\tuseEventCallback({\n\t\teventKey: `blue-dot:${String(eventName)}`,\n\t\tcallback: processedCallback,\n\t\tsetupScript: () =>\n\t\t\tcreateEventSetupScript({\n\t\t\t\textensionName: 'blue-dot',\n\t\t\t\teventName: eventName,\n\t\t\t}),\n\t\tcleanupScript: () =>\n\t\t\tcreateEventCleanupScript({\n\t\t\t\textensionName: 'blue-dot',\n\t\t\t\teventName: eventName,\n\t\t\t}),\n\t\tshouldInject: extensionIsReady,\n\t});\n}\n", "import { useRegisterExtension } from '@mappedin/react-native-sdk';\nimport { getRegistrationScript } from './extension-source';\nimport Logger from '@packages/internal/common/Mappedin.Logger';\n\n/**\n * React hook for registering the BlueDot extension with the WebView bridge\n *\n * This hook handles the complete extension registration lifecycle:\n * - Monitors bridge readiness state\n * - Checks if extension is already registered to avoid duplicates\n * - Injects registration script when needed\n * - Updates extension state in shared context\n * - Handles all registration errors gracefully\n *\n * Multiple hooks can use this safely - the registration logic is idempotent\n * and will only register the extension once per bridge lifecycle.\n *\n * @returns void - Hook performs registration as side effect only\n */\nexport function useBlueDotRegistration() {\n\tuseRegisterExtension({\n\t\textensionName: 'blue-dot',\n\t\tgetRegistrationScript,\n\t\tlogger: {\n\t\t\tlog: message => Logger.log(message),\n\t\t\terror: (message, error) => Logger.error(message, error),\n\t\t},\n\t});\n}\n", "// Extension source placeholder - replaced at build time\nconst EXTENSION_SOURCE_PLACEHOLDER = `INJECT_SCRIPT_HERE`;\n\n/**\n * Returns the extension registration script\n * This function's return value is replaced at build time with the actual IIFE content\n * @returns JavaScript code string for extension registration\n */\nexport function getRegistrationScript(): string {\n\treturn EXTENSION_SOURCE_PLACEHOLDER;\n}\n", "/* eslint-disable no-console*/\nexport const MI_DEBUG_KEY = 'mi-debug';\nexport const MI_ERROR_LABEL = '[MappedinJS]';\n\nexport enum E_SDK_LOG_LEVEL {\n\tLOG,\n\tWARN,\n\tERROR,\n\tSILENT,\n}\n\nexport function createLogger(name = '', { prefix = MI_ERROR_LABEL } = {}) {\n\tconst label = `${prefix}${name ? `-${name}` : ''}`;\n\n\tconst rnDebug = (type: 'log' | 'warn' | 'error', args: any[]) => {\n\t\tif (typeof window !== 'undefined' && (window as any).rnDebug) {\n\t\t\tconst processed = args.map(arg => {\n\t\t\t\tif (arg instanceof Error && arg.stack) {\n\t\t\t\t\treturn `${arg.message}\\n${arg.stack}`;\n\t\t\t\t}\n\n\t\t\t\treturn arg;\n\t\t\t});\n\t\t\t(window as any).rnDebug(`${name} ${type}: ${processed.join(' ')}`);\n\t\t}\n\t};\n\n\treturn {\n\t\tlogState: process.env.NODE_ENV === 'test' ? E_SDK_LOG_LEVEL.SILENT : E_SDK_LOG_LEVEL.LOG,\n\n\t\tlog(...args: any[]) {\n\t\t\tif (this.logState <= E_SDK_LOG_LEVEL.LOG) {\n\t\t\t\tconsole.log(label, ...args);\n\t\t\t\trnDebug('log', args);\n\t\t\t}\n\t\t},\n\n\t\twarn(...args: any[]) {\n\t\t\tif (this.logState <= E_SDK_LOG_LEVEL.WARN) {\n\t\t\t\tconsole.warn(label, ...args);\n\t\t\t\trnDebug('warn', args);\n\t\t\t}\n\t\t},\n\n\t\terror(...args: any[]) {\n\t\t\tif (this.logState <= E_SDK_LOG_LEVEL.ERROR) {\n\t\t\t\tconsole.error(label, ...args);\n\n\t\t\t\trnDebug('error', args);\n\t\t\t}\n\t\t},\n\n\t\t// It's a bit tricky to prepend [MappedinJs] to assert and time because of how the output is structured in the console, so it is left out for simplicity\n\t\tassert(...args: any[]) {\n\t\t\tconsole.assert(...args);\n\t\t},\n\n\t\ttime(label: string) {\n\t\t\tconsole.time(label);\n\t\t},\n\n\t\ttimeEnd(label: string) {\n\t\t\tconsole.timeEnd(label);\n\t\t},\n\t\tsetLevel(level: E_SDK_LOG_LEVEL) {\n\t\t\tif (E_SDK_LOG_LEVEL.LOG <= level && level <= E_SDK_LOG_LEVEL.SILENT) {\n\t\t\t\tthis.logState = level;\n\t\t\t}\n\t\t},\n\t};\n}\n\nconst Logger = createLogger();\nexport function setLoggerLevel(level: E_SDK_LOG_LEVEL) {\n\tif (E_SDK_LOG_LEVEL.LOG <= level && level <= E_SDK_LOG_LEVEL.SILENT) {\n\t\tLogger.logState = level;\n\t}\n}\n\nexport default Logger;\n"],
+  "mappings": "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",
+  "names": ["useCallback", "useContext", "MappedinContext", "label", "useContext", "MappedinContext", "useCallback"]
+}

package/lib/rn/rn/extension-augmentation.d.ts

@@ -0,0 +1,15 @@
+import type { BaseExtensionState } from '@mappedin/react-native-sdk';
+import type { BlueDotExtensionState } from './use-blue-dot';
+/**
+ * Module augmentation to register the blue-dot extension type
+ * with the React Native SDK's extension registry.
+ *
+ * This allows TypeScript to properly type the extension state
+ * when accessed from the MappedinContext without type casting.
+ */
+declare module '@mappedin/react-native-sdk' {
+    interface ExtensionRegistry {
+        'blue-dot': BlueDotExtensionState & BaseExtensionState;
+    }
+}
+export {};

package/lib/rn/rn/extension-source.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Returns the extension registration script
+ * This function's return value is replaced at build time with the actual IIFE content
+ * @returns JavaScript code string for extension registration
+ */
+export declare function getRegistrationScript(): string;

package/lib/rn/rn/use-blue-dot-events.d.ts

@@ -0,0 +1,40 @@
+import type { BlueDotEvents, BlueDotEventPayloads } from '../types';
+/**
+ * React hook for subscribing to BlueDot extension events in React Native WebView
+ *
+ * This hook provides a React-friendly way to listen for BlueDot events:
+ * - Automatically manages event subscription/unsubscription
+ * - Handles WebView bridge message routing
+ * - Provides type-safe event payload handling
+ * - Cleans up listeners on component unmount
+ *
+ * @param eventName - The name of the BlueDot event to listen for
+ * @param callback - The callback function to invoke when the event occurs
+ *
+ * @example
+ * ```tsx
+ * import { useBlueDotEvent } from '@mappedin/blue-dot/rn';
+ *
+ * function MyComponent() {
+ *   // Listen for position updates
+ *   useBlueDotEvent('position-update', (event) => {
+ *     console.log('New position:', event.coordinate);
+ *     console.log('Floor:', event.floor?.name);
+ *     console.log('Accuracy:', event.accuracy);
+ *   });
+ *
+ *   // Listen for state changes
+ *   useBlueDotEvent('state-change', (event) => {
+ *     console.log('Blue Dot state changed to:', event.state);
+ *     console.log('Action that caused change:', event.action);
+ *   });
+ *
+ *   // Listen for follow mode changes
+ *   useBlueDotEvent('follow-change', (event) => {
+ *     console.log('Following:', event.following);
+ *     console.log('Mode:', event.mode);
+ *   });
+ * }
+ * ```
+ */
+export declare function useBlueDotEvent<K extends BlueDotEvents>(eventName: K, callback: (payload: BlueDotEventPayloads[K]) => void): void;

package/lib/rn/rn/use-blue-dot-registration.d.ts

@@ -0,0 +1,16 @@
+/**
+ * React hook for registering the BlueDot extension with the WebView bridge
+ *
+ * This hook handles the complete extension registration lifecycle:
+ * - Monitors bridge readiness state
+ * - Checks if extension is already registered to avoid duplicates
+ * - Injects registration script when needed
+ * - Updates extension state in shared context
+ * - Handles all registration errors gracefully
+ *
+ * Multiple hooks can use this safely - the registration logic is idempotent
+ * and will only register the extension once per bridge lifecycle.
+ *
+ * @returns void - Hook performs registration as side effect only
+ */
+export declare function useBlueDotRegistration(): void;

package/lib/rn/rn/use-blue-dot.d.ts

@@ -0,0 +1,131 @@
+import type { BlueDotOptions, BlueDotPositionUpdate, BlueDotState, FollowMode, FollowCameraOptions } from '../types';
+import type { Coordinate, Floor } from '@mappedin/mappedin-js';
+/**
+ * Extension state for Blue Dot that includes the current state and position
+ */
+export interface BlueDotExtensionState {
+    /**
+     * Whether the extension is currently enabled
+     */
+    isEnabled: boolean;
+    /**
+     * The current state of the Blue Dot
+     */
+    state: BlueDotState;
+    /**
+     * The current position of the Blue Dot
+     */
+    position?: Coordinate;
+    /**
+     * The current floor of the Blue Dot
+     */
+    floor?: Floor;
+    /**
+     * Whether the Blue Dot is currently following the user
+     */
+    following: boolean;
+    /**
+     * The accuracy of the current position in metres
+     */
+    accuracy?: number;
+    /**
+     * The direction the user is facing in degrees from north clockwise
+     */
+    heading?: number;
+}
+export interface UseBlueDotResult {
+    /**
+     * Whether the extension is ready and initialized
+     */
+    isReady: boolean;
+    /**
+     * Whether the extension is currently enabled
+     */
+    isEnabled: boolean;
+    /**
+     * The current state of the Blue Dot
+     */
+    state: BlueDotState;
+    /**
+     * The current position of the Blue Dot
+     */
+    position?: Coordinate;
+    /**
+     * The current floor of the Blue Dot
+     */
+    floor?: Floor;
+    /**
+     * Whether the Blue Dot is currently following the user
+     */
+    following: boolean;
+    /**
+     * The accuracy of the current position in metres
+     */
+    accuracy?: number;
+    /**
+     * The direction the user is facing in degrees from north clockwise
+     */
+    heading?: number;
+    /**
+     * Enables Blue Dot with the given options.
+     * @param options - The options to enable Blue Dot with
+     * @returns Promise that resolves when enabling is complete
+     * @see {@link BlueDot.enable}
+     */
+    enable(options?: BlueDotOptions): Promise<void>;
+    /**
+     * Disables the Blue Dot instance and unsubscribes all MapView event listeners.
+     * @returns Promise that resolves when disabling is complete
+     * @see {@link BlueDot.disable}
+     */
+    disable(): Promise<void>;
+    /**
+     * Update the Blue Dot's position manually.
+     * @param position - The position update options
+     * @returns Promise that resolves when the update is complete
+     * @see {@link BlueDot.update}
+     */
+    update(position: BlueDotPositionUpdate): Promise<void>;
+    /**
+     * Enable follow mode for the Blue Dot.
+     * @param mode - The follow mode to enable
+     * @param options - The follow camera options
+     * @returns Promise that resolves when follow mode is enabled
+     * @see {@link BlueDot.follow}
+     */
+    follow(mode: FollowMode, options?: FollowCameraOptions): Promise<void>;
+    /**
+     * Disable follow mode for the Blue Dot.
+     * @returns Promise that resolves when follow mode is disabled
+     * @see {@link BlueDot.unfollow}
+     */
+    unfollow(): Promise<void>;
+}
+/**
+ * React hook for using BlueDot extension in React Native WebView
+ *
+ * This hook provides an API for interacting with the BlueDot extension:
+ * - Uses the shared state system for automatic extension registration
+ * - Provides methods for controlling blue dot behavior
+ * - Handles bridge communication and error management
+ *
+ * @returns Hook API object with Blue Dot methods
+ *
+ * @example
+ * ```tsx
+ * import { MapView } from '@mappedin/react-native-sdk';
+ * import { useBlueDot } from '@mappedin/blue-dot/rn';
+ *
+ * function MyComponent() {
+ *   const { enable, isReady, state, following } = useBlueDot();
+ *
+ *   // Use the Blue Dot API
+ *   React.useEffect(() => {
+ *     if (isReady) {
+ *       enable({ radius: 15, color: '#ff0000' });
+ *     }
+ *   }, [isReady]);
+ * }
+ * ```
+ */
+export declare function useBlueDot(): UseBlueDotResult;