@umituz/react-native-location 1.0.0 → 1.0.3

package/package.json

@@ -1,16 +1,14 @@
 {
   "name": "@umituz/react-native-location",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "description": "Device location services for React Native with GPS, permissions, caching, and reverse geocoding",
-  "main": "./lib/index.js",
-  "types": "./lib/index.d.ts",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
   "scripts": {
-    "build": "tsc",
     "typecheck": "tsc --noEmit",
     "lint": "tsc --noEmit",
     "clean": "rm -rf lib",
     "prebuild": "npm run clean",
-    "prepublishOnly": "npm run build",
     "version:patch": "npm version patch -m 'chore: release v%s'",
     "version:minor": "npm version minor -m 'chore: release v%s'",
     "version:major": "npm version major -m 'chore: release v%s'"
@@ -48,10 +46,8 @@
     "access": "public"
   },
   "files": [
-    "lib",
     "src",
     "README.md",
     "LICENSE"
   ]
 }
-

package/src/domain/entities/Location.ts

@@ -1,175 +1,23 @@
-/**
- * Location Domain Entities
- *
- * Core location types and interfaces for device location services
- * and geolocation features
- *
- * Features:
- * - Current location retrieval with GPS
- * - Location permission management
- * - Location caching (15-minute cache)
- * - Reverse geocoding (address lookup)
- * - Fallback strategies (High → Balanced → Cached)
- * - Platform-aware (iOS/Android only, no web)
- *
- * Dependencies:
- * - expo-location (GPS and permissions)
- * - AsyncStorage (location cache)
- */
-
-/**
- * Location data with coordinates and optional address
- */
-export interface LocationData {
-  /** Latitude coordinate */
-  latitude: number;
-
-  /** Longitude coordinate */
-  longitude: number;
-
-  /** Human-readable address (reverse geocoded) */
-  address?: string;
-
-  /** Timestamp when location was captured (milliseconds since epoch) */
-  timestamp: number;
-
-  /** GPS accuracy in meters (lower is better) */
-  accuracy?: number;
-
-  /** Whether this location is from cache (not fresh GPS) */
-  isCached?: boolean;
+export interface Coordinates {
+    latitude: number;
+    longitude: number;
 }
 
-/**
- * Location permission status
- */
-export type LocationPermissionStatus = 'granted' | 'denied' | 'unknown';
-
-/**
- * Location accuracy levels for GPS
- */
-export enum LocationAccuracy {
-  /** Lowest accuracy, fastest response, battery-friendly */
-  Lowest = 1,
-
-  /** Low accuracy */
-  Low = 2,
-
-  /** Balanced accuracy (recommended for most use cases) */
-  Balanced = 3,
-
-  /** High accuracy (GPS-based) */
-  High = 4,
-
-  /** Highest accuracy (most battery-intensive) */
-  Highest = 5,
-
-  /** Best for navigation (continuous high accuracy) */
-  BestForNavigation = 6,
+export interface LocationAddress {
+    city?: string | null;
+    region?: string | null;
+    country?: string | null;
+    street?: string | null;
+    formattedAddress?: string | null;
 }
 
-/**
- * Location cache configuration
- */
-export interface LocationCacheConfig {
-  /** Cache duration in milliseconds (default: 15 minutes) */
-  duration: number;
-
-  /** Storage key for cached location */
-  storageKey: string;
-}
-
-/**
- * Location retrieval configuration
- */
-export interface LocationRetrievalConfig {
-  /** Timeout for high accuracy request (milliseconds) */
-  highAccuracyTimeout: number;
-
-  /** Timeout for balanced accuracy request (milliseconds) */
-  balancedAccuracyTimeout: number;
-
-  /** Whether to enable reverse geocoding (address lookup) */
-  enableGeocoding: boolean;
-}
-
-/**
- * Cached location storage format
- */
-export interface CachedLocation {
-  /** Location data */
-  data: LocationData;
-
-  /** Timestamp when location was cached (milliseconds since epoch) */
-  cachedAt: number;
+export interface LocationData {
+    coords: Coordinates;
+    timestamp: number;
+    address?: LocationAddress;
 }
 
-/**
- * Location Service Interface
- * Defines all location-related operations
- */
-export interface ILocationService {
-  /**
-   * Request location permissions from user
-   * @returns Promise resolving to true if granted, false otherwise
-   */
-  requestPermissions(): Promise<boolean>;
-
-  /**
-   * Check if location permissions are granted
-   * @returns Promise resolving to true if granted, false otherwise
-   */
-  hasPermissions(): Promise<boolean>;
-
-  /**
-   * Get current permission status without requesting
-   * @returns Current permission status ('granted' | 'denied' | 'unknown')
-   */
-  getPermissionStatus(): LocationPermissionStatus;
-
-  /**
-   * Get current device location with fallback strategies
-   * Priority: High accuracy → Balanced accuracy → Cached location → null
-   * @returns Promise resolving to LocationData or null if unavailable
-   */
-  getCurrentLocation(): Promise<LocationData | null>;
-
-  /**
-   * Get cached location if available and not expired
-   * @returns Cached location or null
-   */
-  getCachedLocation(): LocationData | null;
-
-  /**
-   * Format location for display (address or coordinates)
-   * @param location - LocationData to format
-   * @returns Formatted string (address or "lat, lng")
-   */
-  formatLocation(location: LocationData): string;
-
-  /**
-   * Check if location services are available on this platform
-   * @returns True if available (iOS/Android), false otherwise (web)
-   */
-  isLocationAvailable(): boolean;
+export interface LocationError {
+    code: string;
+    message: string;
 }
-
-/**
- * Location service constants
- */
-export const LOCATION_CONSTANTS = {
-  /** Cache duration: 15 minutes */
-  CACHE_DURATION: 15 * 60 * 1000,
-
-  /** High accuracy timeout: 15 seconds */
-  HIGH_ACCURACY_TIMEOUT: 15000,
-
-  /** Balanced accuracy timeout: 8 seconds */
-  BALANCED_ACCURACY_TIMEOUT: 8000,
-
-  /** AsyncStorage key for cached location */
-  CACHE_KEY: '@location_cache',
-
-  /** Coordinate decimal precision for display */
-  COORDINATE_PRECISION: 4,
-} as const;

package/src/index.ts

@@ -1,107 +1,3 @@
-/**
- * Location Domain - Barrel Export
- *
- * Global infrastructure domain for device location services and geolocation
- *
- * Features:
- * - Current location retrieval with GPS
- * - Location permission management (iOS/Android)
- * - 15-minute location caching for performance
- * - Reverse geocoding (coordinates → address)
- * - Multi-tier accuracy fallback (High → Balanced → Cached)
- * - Platform-aware (iOS/Android only, no web support)
- * - Silent failures (no console logging)
- *
- * Dependencies:
- * - expo-location (GPS and permissions API)
- * - AsyncStorage (cache persistence)
- *
- * USAGE:
- * ```typescript
- * // Recommended: Use hook in components
- * import { useLocation } from '@umituz/react-native-location';
- *
- * const MyComponent = () => {
- *   const {
- *     location,
- *     loading,
- *     hasPermission,
- *     requestPermission,
- *     getCurrentLocation,
- *     formatLocation,
- *   } = useLocation();
- *
- *   useEffect(() => {
- *     // Auto-fetch on mount
- *     getCurrentLocation();
- *   }, []);
- *
- *   if (loading) return <LoadingIndicator />;
- *
- *   return (
- *     <View>
- *       {location && (
- *         <>
- *           <Text>Location: {formatLocation(location)}</Text>
- *           <Text>Lat: {location.latitude}</Text>
- *           <Text>Lng: {location.longitude}</Text>
- *           {location.accuracy && (
- *             <Text>Accuracy: {location.accuracy.toFixed(0)}m</Text>
- *           )}
- *         </>
- *       )}
- *       <AtomicButton onPress={getCurrentLocation}>
- *         Refresh Location
- *       </AtomicButton>
- *     </View>
- *   );
- * };
- *
- * // Alternative: Use service directly (for non-component code)
- * import { locationService } from '@umituz/react-native-location';
- *
- * const location = await locationService.getCurrentLocation();
- * if (location) {
- *   console.log(locationService.formatLocation(location));
- * }
- * ```
- *
- * PLATFORM SUPPORT:
- * - ✅ iOS: Full support (GPS, permissions, geocoding)
- * - ✅ Android: Full support (GPS, permissions, geocoding)
- * - ❌ Web: Not supported (returns null)
- *
- * PERMISSION FLOW:
- * 1. Check: hasPermissions() → true/false
- * 2. Request: requestPermissions() → true/false
- * 3. Retrieve: getCurrentLocation() → LocationData | null
- *
- * FALLBACK STRATEGY:
- * 1. High accuracy GPS (15s timeout)
- * 2. Balanced accuracy GPS (8s timeout)
- * 3. Cached location (15min cache)
- * 4. null (no location available)
- *
- * CACHING:
- * - Duration: 15 minutes
- * - Storage: AsyncStorage (@location_cache)
- * - Auto-refresh: On getCurrentLocation() if expired
- */
-
-// Domain Entities
-export type {
-  LocationData,
-  LocationPermissionStatus,
-  CachedLocation,
-  LocationCacheConfig,
-  LocationRetrievalConfig,
-  ILocationService,
-} from './domain/entities/Location';
-export { LocationAccuracy, LOCATION_CONSTANTS } from './domain/entities/Location';
-
-// Infrastructure Services
-export { locationService } from './infrastructure/services/LocationService';
-
-// Presentation Hooks
-export { useLocation } from './presentation/hooks/useLocation';
-export type { UseLocationReturn } from './presentation/hooks/useLocation';
+export * from "./domain/entities/Location";
+export * from "./infrastructure/services/LocationService";
+export * from "./presentation/hooks/useLocation";