@mappedin/blue-dot 6.0.1-beta.56 → 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/esm/index.d.ts

@@ -3,7 +3,6 @@
 //   ../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';
@@ -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' {
@@ -670,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mappedin/blue-dot",
-  "version": "6.0.1-beta.56",
+  "version": "6.0.1-beta.57",
   "homepage": "https://developer.mappedin.com/",
   "private": false,
   "main": "lib/esm/index.js",
@@ -33,22 +33,11 @@
     "THIRD_PARTY_LICENSES.txt"
   ],
   "license": "SEE LICENSE IN LICENSE.txt",
-  "scripts": {
-    "start": "pnpm build && concurrently \"node scripts/build.mjs --watchChanges\" \"node scripts/start.mjs\"",
-    "build:deps": "RN_BUILD=true npx turbo build --filter=@mappedin/blue-dot --ui stream",
-    "build": "pnpm clean && tsc -b && node scripts/build.mjs",
-    "build:prod": "cross-env NODE_ENV=production pnpm build && pnpm build:rn",
-    "build:rn": "cross-env RN_BUILD=true pnpm build",
-    "types": "tsc -b",
-    "test": "pnpm -w test blue-dot",
-    "test:cov": "NODE_ENV=test jest --coverage",
-    "clean": "rm -rf lib/** && rm -rf examples/dist/**",
-    "docs": "pnpm build && typedoc"
-  },
+  "dependencies": {},
   "peerDependencies": {
-    "@mappedin/mappedin-js": "^6.0.1-beta.42",
-    "@mappedin/react-native-sdk": ">=6.0.0-alpha.0",
-    "react": ">=16.8.0"
+    "react": ">=16.8.0",
+    "@mappedin/mappedin-js": "^6.0.0-rc.4",
+    "@mappedin/react-native-sdk": "^6.0.0-beta.1"
   },
   "peerDependenciesMeta": {
     "@mappedin/react-native-sdk": {
@@ -58,8 +47,21 @@
       "optional": true
     }
   },
+  "devDependencies": {},
   "volta": {
     "extends": "../../package.json"
   },
-  "gitHead": "deada2546fa6868b53fe81ce8c007edda58f76fa"
-}
+  "scripts": {
+    "start": "pnpm build && concurrently \"node scripts/build.mjs --watchChanges\" \"node scripts/start.mjs\"",
+    "build:deps": "RN_BUILD=true npx turbo build --filter=@mappedin/blue-dot --ui stream",
+    "build": "pnpm clean && tsc -b && node scripts/build.mjs",
+    "build:prod": "cross-env NODE_ENV=production pnpm build && pnpm build:rn",
+    "build:rn": "cross-env RN_BUILD=true pnpm build",
+    "types": "tsc -b",
+    "version:ci": "pnpm version --no-commit-hooks --no-git-tag-version",
+    "test": "pnpm -w test blue-dot",
+    "test:cov": "NODE_ENV=test jest --coverage",
+    "clean": "rm -rf lib/** && rm -rf examples/dist/**",
+    "docs": "pnpm build && typedoc"
+  }
+}