@mappedin/react-native-sdk 6.0.0-alpha.9 → 6.0.0-beta.0

package/lib/hooks/use-bridge.d.ts

@@ -0,0 +1,81 @@
+import type { WebView, WebViewMessageEvent } from 'react-native-webview';
+/**
+ * React hook for communicating with a WebView using a bridge pattern.
+ *
+ * @example
+ * ```tsx
+ * import { useRef, useState } from 'react';
+ * import { WebView } from 'react-native-webview';
+ * import { useBridge } from './hooks/use-bridge';
+ *
+ * function MyComponent() {
+ *   const [webView, setWebView] = useState<WebView | null>(null);
+ *   const { instruct, handleMessage, cleanup } = useBridge(webView);
+ *
+ *   const handlePress = async () => {
+ *     try {
+ *       const result = await instruct({
+ *         type: 'function',
+ *         payload: {
+ *           name: 'getMapData',
+ *           options: [{ venueId: '123' }]
+ *         }
+ *       });
+ *       console.log('Map data:', result);
+ *     } catch (error) {
+ *       console.error('Failed to get map data:', error);
+ *     }
+ *   };
+ *
+ *   // Clean up on unmount
+ *   useEffect(() => {
+ *     return () => {
+ *       cleanup();
+ *     };
+ *   }, [cleanup]);
+ *
+ *   return (
+ *     <WebView
+ *       ref={setWebView}
+ *       source={{ uri: 'https://example.com' }}
+ *       onMessage={handleMessage}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * @param webView - The WebView instance (can be null)
+ * @returns Object containing the instruct function, handleMessage callback, and cleanup function
+ */
+type FunctionInstruction = {
+    type: 'function';
+    payload: {
+        name: string;
+        options?: any[];
+    };
+};
+type MethodInstruction = {
+    type: 'method';
+    payload: {
+        target: string;
+        method: string;
+        args?: any[];
+    };
+};
+export type Instruction = FunctionInstruction | MethodInstruction;
+/**
+ * React hook for communicating with a WebView or iframe using a bridge pattern.
+ * Automatically detects platform and uses appropriate communication method.
+ *
+ * @param container - The WebView instance (React Native) or HTMLIFrameElement (web) - can be null
+ * @returns An object containing the instruct function, handleMessage callback, cleanup function, and isReady state
+ */
+export declare function useBridge(container: WebView | HTMLIFrameElement | null): {
+    instruct: <T = any>(instruction: Instruction) => Promise<T>;
+    handleMessage: (event: WebViewMessageEvent | MessageEvent) => void;
+    destroy: () => void;
+    isReady: boolean;
+};
+export type UseBridgeHook = ReturnType<typeof useBridge>;
+export {};
+//# sourceMappingURL=use-bridge.d.ts.map

package/lib/hooks/use-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-bridge.d.ts","sourceRoot":"","sources":["../../src/hooks/use-bridge.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAGH,KAAK,mBAAmB,GAAG;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;KAChB,CAAC;CACF,CAAC;AACF,KAAK,iBAAiB,GAAG;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;KACb,CAAC;CACF,CAAC;AACF,MAAM,MAAM,WAAW,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAqBlE;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,iBAAiB,GAAG,IAAI;eAyCpE,CAAC,qBAAqB,WAAW,KAAG,OAAO,CAAC,CAAC,CAAC;2BA7BN,mBAAmB,GAAG,YAAY;;;EA8F5E;AAED,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/lib/hooks/use-map-view-event.d.ts

@@ -0,0 +1,27 @@
+import type { TEvents } from '@mappedin/mappedin-js';
+type TEventPayload<EventName extends keyof TEvents> = TEvents[EventName] extends {
+    data: null;
+} ? TEvents[EventName]['data'] : TEvents[EventName];
+/**
+ * Hook to subscribe to an event on the MapView in React Native.
+ *
+ * This hook uses the MapView's .on() and .off() methods to subscribe to events
+ * on the MapView instance running in the WebView.
+ *
+ * @param event - The event to listen for.
+ * @param callback - The callback to call when the event is triggered.
+ *
+ * @category Hooks
+ *
+ * @example
+ * ```tsx
+ * useMapViewEvent('click', event => {
+ *  const { coordinate } = event;
+ *  const { latitude, longitude } = coordinate;
+ *  console.log(`Map was clicked at ${latitude}, ${longitude}`);
+ * });
+ * ```
+ */
+export declare function useMapViewEvent<T extends keyof TEvents>(event: T, callback: (payload: TEventPayload<T>) => void): void;
+export {};
+//# sourceMappingURL=use-map-view-event.d.ts.map

package/lib/hooks/use-map-view-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-map-view-event.d.ts","sourceRoot":"","sources":["../../src/hooks/use-map-view-event.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAErD,KAAK,aAAa,CAAC,SAAS,SAAS,MAAM,OAAO,IAAI,OAAO,CAAC,SAAS,CAAC,SAAS;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAC5F,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,GAC1B,OAAO,CAAC,SAAS,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,QAwC/G"}

package/lib/hooks/use-map.d.ts

@@ -0,0 +1,58 @@
+import type { WebView, WebViewMessageEvent } from 'react-native-webview';
+import type { Mappedin } from '../types';
+import type { MapViewControl } from '../controls/map-view-control';
+import type { EventControl } from '../controls/event-control';
+import type { PubSub } from '@mappedin/mappedin-js';
+interface WebViewMessageEventPayload {
+    'webview-message-received': WebViewMessageEvent;
+}
+export declare const MappedinContext: import("react").Context<{
+    mapData?: Mappedin.MapData;
+    mapView?: MapViewControl;
+    /**
+     * Event control system for managing event callbacks.
+     * @internal
+     */
+    _events?: EventControl;
+    /**
+     * Container instance for bridge communication (WebView on native, HTMLIFrameElement on web).
+     * @internal
+     */
+    _webView?: WebView | HTMLIFrameElement | null;
+    /**
+     * PubSub instance for WebView message events.
+     * @internal
+     */
+    _webViewMessagePubSub?: PubSub<WebViewMessageEventPayload>;
+}>;
+/**
+ * Hook to get the MapData and MapView instances from the MapView context.
+ *
+ * This hook provides access to the mapData and mapView instances that are
+ * created and managed by the MapView component. It ensures that the hook
+ * is used within a MapView component context.
+ *
+ * @throws {MapViewNullError} When used outside of a MapView component or when mapData/mapView are not yet initialized
+ *
+ * @returns Object containing mapData and mapView instances
+ *
+ * @example
+ * ```tsx
+ * function MyMapComponent() {
+ *   const { mapData, mapView } = useMap();
+ *
+ *   useEffect(() => {
+ *     // Use mapView to interact with the map
+ *     mapView.Camera.animateTo({ center: mapData.getByType('space')[0] });
+ *   }, [mapData, mapView]);
+ *
+ *   return <Text>Map is ready!</Text>;
+ * }
+ * ```
+ */
+export declare function useMap(): {
+    mapData: Mappedin.MapData;
+    mapView: MapViewControl;
+};
+export {};
+//# sourceMappingURL=use-map.d.ts.map

package/lib/hooks/use-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-map.d.ts","sourceRoot":"","sources":["../../src/hooks/use-map.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAGpD,UAAU,0BAA0B;IACnC,0BAA0B,EAAE,mBAAmB,CAAC;CAChD;AAGD,eAAO,MAAM,eAAe;cACjB,QAAQ,CAAC,OAAO;cAChB,cAAc;IACxB;;;OAGG;cACO,YAAY;IACtB;;;OAGG;eACQ,OAAO,GAAG,iBAAiB,GAAG,IAAI;IAC7C;;;OAGG;4BACqB,MAAM,CAAC,0BAA0B,CAAC;EAOzD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,MAAM,IAAI;IACzB,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;CACxB,CAQA"}

package/lib/index.d.ts

@@ -0,0 +1,21 @@
+export { MapView } from './map-view';
+export type { MapViewProps } from './map-view';
+export { useMap, MappedinContext } from './hooks/use-map';
+export type { MapViewControl, Promisify, PromisifiedUpdateState } from './controls/map-view-control';
+export { useMapViewEvent } from './hooks/use-map-view-event';
+export { Marker } from './components/marker';
+export type { MarkerProps } from './components/marker';
+export { Label } from './components/label';
+export type { LabelProps } from './components/label';
+export { Path } from './components/path';
+export type { PathProps } from './components/path';
+export { Shape } from './components/shape';
+export type { ShapeProps } from './components/shape';
+export type { Navigation } from './controls/map-view-control';
+export { Model } from './components/model';
+export type { ModelProps } from './components/model';
+export { setLoggerLevel } from './utils';
+import type { hydrateMapData as HydrateMapData, unzipAndParseMVFv2 as UnzipAndParseMVFv2 } from '@mappedin/mappedin-js';
+export declare const hydrateMapData: typeof HydrateMapData;
+export declare const unzipAndParseMVFv2: typeof UnzipAndParseMVFv2;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC1D,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAMzC,OAAO,KAAK,EAAE,cAAc,IAAI,cAAc,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAExH,eAAO,MAAM,cAAc,EAAE,OAAO,cAAgC,CAAC;AACrE,eAAO,MAAM,kBAAkB,EAAE,OAAO,kBAAwC,CAAC"}