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

package/README.md

@@ -115,3 +115,125 @@ export type BlueDotOptions = {
 	debug?: boolean;
 };
 ```
+
+### React Native
+
+```tsx
+import React, { useEffect, useCallback } from 'react';
+import { View, Text, TouchableOpacity } from 'react-native';
+import { MapView, useMapData } from '@mappedin/react-native-sdk';
+import { useBlueDot, useBlueDotEvent } from '@mappedin/blue-dot/rn';
+
+function MyComponent() {
+	const { mapData } = useMapData({
+		key: 'your-api-key',
+		secret: 'your-api-secret',
+		mapId: 'your-map-id',
+	});
+
+	return (
+		<MapView mapData={mapData}>
+			<BlueDotDisplay />
+		</MapView>
+	);
+}
+
+function BlueDotDisplay() {
+	// All methods are async and return Promises
+	const {
+		isReady,
+		isEnabled,
+		state,
+		position,
+		floor,
+		following,
+		accuracy,
+		heading,
+		enable,
+		disable,
+		update,
+		follow,
+		unfollow,
+	} = useBlueDot();
+
+	// Listen for position updates
+	useBlueDotEvent(
+		'position-update',
+		useCallback(event => {
+			console.log('Position updated:', event.coordinate, event.floor);
+		}, []),
+	);
+
+	// Listen for state changes
+	useBlueDotEvent(
+		'state-change',
+		useCallback(event => {
+			console.log('State changed:', event.state);
+		}, []),
+	);
+
+	// Listen for follow mode changes
+	useBlueDotEvent(
+		'follow-change',
+		useCallback(event => {
+			console.log('Follow mode:', event.following);
+		}, []),
+	);
+
+	useEffect(() => {
+		if (isReady && !isEnabled) {
+			// All methods are async - use await or .then()
+			enable({
+				radius: 15,
+				color: '#ff0000',
+				watchDevicePosition: false,
+			});
+		}
+	}, [isReady, isEnabled, enable]);
+
+	const handleUpdatePosition = useCallback(async () => {
+		try {
+			// Update position manually
+			await update({
+				latitude: 43.6532,
+				longitude: -79.3832,
+				accuracy: 5,
+				heading: 90,
+				floorOrFloorId: floor,
+			});
+
+			// Enable follow mode
+			await follow('position-and-heading', {
+				zoomLevel: 19,
+			});
+		} catch (error) {
+			console.error('Failed to update position:', error);
+		}
+	}, [update, follow, floor]);
+
+	return (
+		<View>
+			<Text>Is Ready: {isReady ? 'Yes' : 'No'}</Text>
+			<Text>Is Enabled: {isEnabled ? 'Yes' : 'No'}</Text>
+			<Text>State: {state}</Text>
+			<Text>Following: {following ? 'Yes' : 'No'}</Text>
+			{position && (
+				<Text>
+					Position: {position.latitude.toFixed(4)}, {position.longitude.toFixed(4)}
+				</Text>
+			)}
+			{accuracy && <Text>Accuracy: {accuracy.toFixed(1)}m</Text>}
+			{heading && <Text>Heading: {heading.toFixed(0)}°</Text>}
+			<TouchableOpacity onPress={handleUpdatePosition}>
+				<Text>Update Position & Follow</Text>
+			</TouchableOpacity>
+		</View>
+	);
+}
+```
+
+**Key Differences from Vanilla JS:**
+
+- **All methods are async**: `enable()`, `disable()`, `update()`, `follow()`, and `unfollow()` return Promises
+- **Rich state**: Hook returns `isReady`, `state`, `position`, `floor`, `following`, `accuracy`, `heading` for real-time updates
+- **Separate event hook**: Use `useBlueDotEvent` for listening to position-update, state-change, and follow-change events

package/lib/blue-dot.iife.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts", "../../packages/common/pubsub.ts", "../src/blue-dot.ts"],
+  "sourcesContent": ["export { BlueDot } from './blue-dot';\nexport type {\n\tBlueDotEvents,\n\tBlueDotEventPayloads,\n\tBlueDotPositionUpdate,\n\tBlueDotState,\n\tBlueDotAction,\n\tFollowMode,\n\tFollowCameraOptions,\n\tBlueDotOptions,\n} from './types';\n", "/**\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": ["index_exports", "__export", "BlueDot", "_PubSub", "__publicField", "eventName", "data", "fn", "itemIdx", "__name", "PubSub", "_pubsub", "_mapView", "_BlueDot", "mapView", "__privateAdd", "PubSub", "__publicField", "__name", "options", "__privateGet", "eventName", "fn", "watch", "position", "mode", "cameraOptions", "__privateSet", "BlueDot"]
+}

package/lib/esm/index.d.ts

@@ -1,9 +1,8 @@
 // Generated by dts-bundle v0.7.3
 // Dependencies for this module:
-//   ../blue-dot/@packages/internal/common
+//   ../blue-dot/@packages/internal/common/pubsub
 //   ../blue-dot/@mappedin/mappedin-js
 //   ../blue-dot/three
-//   ../blue-dot/type-fest
 
 declare module '@mappedin/blue-dot' {
     export { BlueDot } from '@mappedin/blue-dot/blue-dot/src/blue-dot';
@@ -11,7 +10,7 @@ declare module '@mappedin/blue-dot' {
 }
 
 declare module '@mappedin/blue-dot/blue-dot/src/blue-dot' {
-    import { PubSub } from '@packages/internal/common';
+    import { PubSub } from '@packages/internal/common/pubsub';
     import type { MapView } from '@mappedin/mappedin-js';
     import type { BlueDotEventPayloads, BlueDotOptions, BlueDotPositionUpdate, BlueDotState, FollowCameraOptions, FollowMode } from '@mappedin/blue-dot/blue-dot/src/types';
     /**
@@ -220,7 +219,7 @@ declare module '@mappedin/blue-dot/blue-dot/src/types' {
     };
     export type BlueDotEvents = keyof BlueDotEventPayloads;
     export type BlueDotState = 'hidden' | 'active' | 'inactive' | 'disabled';
-    export type BlueDotAction = 'timeout' | 'error' | 'position-update' | 'enable' | 'disable';
+    export type BlueDotAction = 'timeout' | 'error' | 'position-update' | 'enable' | 'disable' | 'initialize';
     export type BlueDotOptions = {
             /**
                 * The radius of the BlueDot in pixels. The BlueDot will maintain this size clamped to a minimum of 0.35 metres.
@@ -336,7 +335,6 @@ declare module '@mappedin/blue-dot/packages/common' {
     export { Logger };
     export * from '@mappedin/blue-dot/packages/common/color';
     export * from '@mappedin/blue-dot/packages/common/interpolate';
-    export * from '@mappedin/blue-dot/packages/common/type-utils';
 }
 
 declare module '@mappedin/blue-dot/packages/common/Mappedin.Logger' {
@@ -517,6 +515,7 @@ declare module '@mappedin/blue-dot/packages/common/random-id' {
       */
     export const randomId: () => string;
     export function cyrb53(str: string, seed?: number): number;
+    export function shortId(): string;
 }
 
 declare module '@mappedin/blue-dot/packages/common/pubsub' {
@@ -669,44 +668,6 @@ declare module '@mappedin/blue-dot/packages/common/interpolate' {
     export function interpolateMulti(value: number, inputRange: number[], outputRange: number[], easeFunc?: EasingCurve | ((t: number) => number)): number;
 }
 
-declare module '@mappedin/blue-dot/packages/common/type-utils' {
-    import type { SetOptional } from 'type-fest';
-    type Primitive = string | number | boolean | null | undefined;
-    export type PartialExcept<T, K extends string> = {
-            [P in keyof T as P extends K ? P : never]: T[P];
-    } & {
-            [P in keyof T as P extends K ? never : P]?: T[P] extends Primitive ? T[P] : T[P] extends (infer U)[] ? PartialExcept<U, K>[] : PartialExcept<T[P], K>;
-    };
-    /**
-        * Utility type that extracts nested values matching a specific type with recursion depth limit
-        * @example
-        * type A = ExtractDeep<{ a: { b: string; c: number; }; d: string; e: number; }, number>;
-        * // { a: { c: number; } e: number; }
-        */
-    export type ExtractDeep<T, U, Depth extends readonly number[] = []> = Depth['length'] extends 3 ? any : {
-            [K in keyof T as T[K] extends U ? K : T[K] extends object | undefined ? ExtractDeep<NonNullable<T[K]>, U, [...Depth, 0]> extends never ? never : K : never]: T[K] extends object | undefined ? undefined extends T[K] ? ExtractDeep<NonNullable<T[K]>, U, [...Depth, 0]> | undefined : ExtractDeep<NonNullable<T[K]>, U, [...Depth, 0]> : T[K] extends U ? T[K] : never;
-    };
-    /**
-        * Utility type that makes all properties of a type required, but allows undefined values
-        * to satisfy the required type.
-        * https://medium.com/terria/typescript-transforming-optional-properties-to-required-properties-that-may-be-undefined-7482cb4e1585
-        * @example
-        * type A = Complete<{ a: string; b: number; c: undefined; }>;
-        * // { a: string; b: number; c: undefined; }
-        */
-    export type Complete<T> = {
-            [P in keyof Required<T>]: Pick<T, P> extends Required<Pick<T, P>> ? T[P] : T[P] | undefined;
-    };
-    /**
-        * Utility type that makes all properties required except for the ones specified in the second argument.
-        * @example
-        * type A = RequiredExcept<{ a: string; b: number; c: undefined; }, 'c'>;
-        * // { a: string; b: number; c?: undefined; }
-        */
-    export type RequiredExcept<T, K extends keyof T> = SetOptional<Required<T>, K>;
-    export {};
-}
-
 declare module '@mappedin/blue-dot/packages/common/math-utils' {
     /**
       * Clamp a number between lower and upper bounds with a warning