Usage

TrackIt.* is what both platforms do; TrackIt.ios.* and TrackIt.android.* hold the platform-specific rest, and calling the wrong one rejects with unsupportedOnPlatform.

``` import TrackIt, { onTrackItEvent, onLiveTrack, TrackMapView } from '@devstree/react-native-trackit';

const res = await TrackIt.ready({ trackingMode: 'adaptive', intervalMs: 1000 }); if (!res.ok) console.warn(res.code, res.message);

await TrackIt.start('my-trip'); const track = await TrackIt.buildTrack(); await TrackIt.stop(); ```

How failures cross the bridge

Domain failures resolve as TrackItResult - { ok: false, code, message }. Promises reject only for bridge faults: bad arguments, a call before init, or unsupportedOnPlatform. Never swallow the ready() result; everything downstream is gated on it.

Subscriptions return an unsubscribe function

onTrackItEvent, onLiveTrack, onPoints, onStateChange and onProviderStateChange each return a function - call it on unmount.