foreground-location 0.0.1

package/dist/esm/definitions.d.ts

@@ -0,0 +1,240 @@
+import type { PermissionState, PluginListenerHandle } from '@capacitor/core';
+export type { PermissionState, PluginListenerHandle };
+export interface ForeGroundLocationPlugin {
+    /**
+     * Check current permission status
+     * @since 1.0.0
+     */
+    checkPermissions(): Promise<LocationPermissionStatus>;
+    /**
+     * Request location permissions
+     * @since 1.0.0
+     */
+    requestPermissions(): Promise<LocationPermissionStatus>;
+    /**
+     * Start foreground location service
+     * @since 1.0.0
+     */
+    startForegroundLocationService(options: LocationServiceOptions): Promise<void>;
+    /**
+     * Stop foreground location service
+     * @since 1.0.0
+     */
+    stopForegroundLocationService(): Promise<void>;
+    /**
+     * Check if location service is running
+     * @since 1.0.0
+     */
+    isServiceRunning(): Promise<{
+        isRunning: boolean;
+    }>;
+    /**
+     * Get current location once
+     * @since 1.0.0
+     */
+    getCurrentLocation(): Promise<LocationResult>;
+    /**
+     * Update location service settings
+     * @since 1.0.0
+     */
+    updateLocationSettings(options: LocationServiceOptions): Promise<void>;
+    /**
+     * Get API service status
+     * @since 1.0.0
+     */
+    getApiServiceStatus(): Promise<ApiServiceStatus>;
+    /**
+     * Clear API service buffers
+     * @since 1.0.0
+     */
+    clearApiBuffers(): Promise<void>;
+    /**
+     * Reset API service circuit breaker
+     * @since 1.0.0
+     */
+    resetApiCircuitBreaker(): Promise<void>;
+    /**
+     * Listen for location updates
+     * @since 1.0.0
+     */
+    addListener(eventName: 'locationUpdate', listenerFunc: (location: LocationResult) => void): Promise<PluginListenerHandle>;
+    /**
+     * Listen for service status changes
+     * @since 1.0.0
+     */
+    addListener(eventName: 'serviceStatusChanged', listenerFunc: (status: ServiceStatus) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners
+     * @since 1.0.0
+     */
+    removeAllListeners(): Promise<void>;
+}
+export interface LocationServiceOptions {
+    /**
+     * Update interval in milliseconds
+     * @default 60000
+     * @minimum 1000
+     */
+    interval?: number;
+    /**
+     * Fastest update interval in milliseconds
+     * @default 30000
+     * @minimum 1000
+     */
+    fastestInterval?: number;
+    /**
+     * Location accuracy priority
+     * @default 'HIGH_ACCURACY'
+     */
+    priority?: 'HIGH_ACCURACY' | 'BALANCED_POWER' | 'LOW_POWER' | 'NO_POWER';
+    /**
+     * Notification configuration for foreground service (REQUIRED)
+     */
+    notification: {
+        /**
+         * Notification title (REQUIRED)
+         */
+        title: string;
+        /**
+         * Notification text/content (REQUIRED)
+         */
+        text: string;
+        /**
+         * Optional notification icon resource name
+         */
+        icon?: string;
+    };
+    /**
+     * Enable high accuracy mode
+     * @default true
+     */
+    enableHighAccuracy?: boolean;
+    /**
+     * Minimum distance in meters to trigger update
+     */
+    distanceFilter?: number;
+    /**
+     * API service configuration (optional)
+     * If provided, location data will be sent to the specified API endpoint in batches
+     */
+    api?: ApiServiceConfig;
+}
+export interface ApiServiceConfig {
+    /**
+     * API endpoint URL (REQUIRED if api config is provided)
+     */
+    url: string;
+    /**
+     * HTTP method to use
+     * @default 'POST'
+     */
+    type?: 'GET' | 'POST' | 'PUT' | 'PATCH';
+    /**
+     * HTTP headers to include in API requests
+     */
+    header?: Record<string, string>;
+    /**
+     * Additional parameters to include in API request body
+     */
+    additionalParams?: Record<string, any>;
+    /**
+     * Interval in minutes for sending batched location data to API
+     * @default 5
+     * @minimum 1
+     */
+    apiInterval?: number;
+}
+export interface ApiServiceStatus {
+    /**
+     * Whether API service is enabled and configured
+     */
+    isEnabled: boolean;
+    /**
+     * Number of location points in buffer waiting to be sent
+     */
+    bufferSize: number;
+    /**
+     * Whether API service is healthy (not in circuit breaker state)
+     */
+    isHealthy: boolean;
+}
+export interface LocationResult {
+    /**
+     * Latitude in decimal degrees
+     */
+    latitude: number;
+    /**
+     * Longitude in decimal degrees
+     */
+    longitude: number;
+    /**
+     * Accuracy of the location in meters
+     */
+    accuracy: number;
+    /**
+     * Altitude in meters (if available)
+     */
+    altitude?: number;
+    /**
+     * Bearing in degrees (if available)
+     */
+    bearing?: number;
+    /**
+     * Speed in meters per second (if available)
+     */
+    speed?: number;
+    /**
+     * Timestamp in ISO 8601 format
+     */
+    timestamp: string;
+}
+export interface LocationPermissionStatus {
+    /**
+     * Fine and coarse location permission status
+     */
+    location: PermissionState;
+    /**
+     * Background location permission status (Android 10+)
+     */
+    backgroundLocation: PermissionState;
+    /**
+     * Notification permission status (Android 13+)
+     */
+    notifications: PermissionState;
+}
+export interface ServiceStatus {
+    /**
+     * Whether the service is currently running
+     */
+    isRunning: boolean;
+    /**
+     * Error message if service failed
+     */
+    error?: string;
+}
+/**
+ * Plugin error codes for consistent error handling
+ */
+export declare const ERROR_CODES: {
+    /**
+     * Location permission denied or not granted
+     */
+    readonly PERMISSION_DENIED: "PERMISSION_DENIED";
+    /**
+     * Invalid notification configuration
+     */
+    readonly INVALID_NOTIFICATION: "INVALID_NOTIFICATION";
+    /**
+     * Invalid parameters provided
+     */
+    readonly INVALID_PARAMETERS: "INVALID_PARAMETERS";
+    /**
+     * Location services disabled
+     */
+    readonly LOCATION_SERVICES_DISABLED: "LOCATION_SERVICES_DISABLED";
+    /**
+     * Feature not supported on current platform
+     */
+    readonly UNSUPPORTED_PLATFORM: "UNSUPPORTED_PLATFORM";
+};
+export declare type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];

package/dist/esm/definitions.js

@@ -0,0 +1,26 @@
+/**
+ * Plugin error codes for consistent error handling
+ */
+export const ERROR_CODES = {
+    /**
+     * Location permission denied or not granted
+     */
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    /**
+     * Invalid notification configuration
+     */
+    INVALID_NOTIFICATION: 'INVALID_NOTIFICATION',
+    /**
+     * Invalid parameters provided
+     */
+    INVALID_PARAMETERS: 'INVALID_PARAMETERS',
+    /**
+     * Location services disabled
+     */
+    LOCATION_SERVICES_DISABLED: 'LOCATION_SERVICES_DISABLED',
+    /**
+     * Feature not supported on current platform
+     */
+    UNSUPPORTED_PLATFORM: 'UNSUPPORTED_PLATFORM'
+};
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAqQA;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB;;OAEG;IACH,iBAAiB,EAAE,mBAAmB;IAEtC;;OAEG;IACH,oBAAoB,EAAE,sBAAsB;IAE5C;;OAEG;IACH,kBAAkB,EAAE,oBAAoB;IAExC;;OAEG;IACH,0BAA0B,EAAE,4BAA4B;IAExD;;OAEG;IACH,oBAAoB,EAAE,sBAAsB;CACpC,CAAC","sourcesContent":["import type { PermissionState, PluginListenerHandle } from '@capacitor/core';\n\n// Re-export Capacitor types for user convenience\nexport type { PermissionState, PluginListenerHandle };\n\nexport interface ForeGroundLocationPlugin {\n  /**\n   * Check current permission status\n   * @since 1.0.0\n   */\n  checkPermissions(): Promise<LocationPermissionStatus>;\n\n  /**\n   * Request location permissions\n   * @since 1.0.0\n   */\n  requestPermissions(): Promise<LocationPermissionStatus>;\n\n  /**\n   * Start foreground location service\n   * @since 1.0.0\n   */\n  startForegroundLocationService(options: LocationServiceOptions): Promise<void>;\n\n  /**\n   * Stop foreground location service\n   * @since 1.0.0\n   */\n  stopForegroundLocationService(): Promise<void>;\n\n  /**\n   * Check if location service is running\n   * @since 1.0.0\n   */\n  isServiceRunning(): Promise<{ isRunning: boolean }>;\n\n  /**\n   * Get current location once\n   * @since 1.0.0\n   */\n  getCurrentLocation(): Promise<LocationResult>;\n\n  /**\n   * Update location service settings\n   * @since 1.0.0\n   */\n  updateLocationSettings(options: LocationServiceOptions): Promise<void>;\n\n  /**\n   * Get API service status\n   * @since 1.0.0\n   */\n  getApiServiceStatus(): Promise<ApiServiceStatus>;\n\n  /**\n   * Clear API service buffers\n   * @since 1.0.0\n   */\n  clearApiBuffers(): Promise<void>;\n\n  /**\n   * Reset API service circuit breaker\n   * @since 1.0.0\n   */\n  resetApiCircuitBreaker(): Promise<void>;\n\n  /**\n   * Listen for location updates\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'locationUpdate',\n    listenerFunc: (location: LocationResult) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Listen for service status changes\n   * @since 1.0.0\n   */\n  addListener(\n    eventName: 'serviceStatusChanged',\n    listenerFunc: (status: ServiceStatus) => void,\n  ): Promise<PluginListenerHandle>;\n\n  /**\n   * Remove all listeners\n   * @since 1.0.0\n   */\n  removeAllListeners(): Promise<void>;\n}\n\nexport interface LocationServiceOptions {\n  /**\n   * Update interval in milliseconds\n   * @default 60000\n   * @minimum 1000\n   */\n  interval?: number;\n\n  /**\n   * Fastest update interval in milliseconds\n   * @default 30000\n   * @minimum 1000\n   */\n  fastestInterval?: number;\n\n  /**\n   * Location accuracy priority\n   * @default 'HIGH_ACCURACY'\n   */\n  priority?: 'HIGH_ACCURACY' | 'BALANCED_POWER' | 'LOW_POWER' | 'NO_POWER';\n\n  /**\n   * Notification configuration for foreground service (REQUIRED)\n   */\n  notification: {\n    /**\n     * Notification title (REQUIRED)\n     */\n    title: string;\n    /**\n     * Notification text/content (REQUIRED)\n     */\n    text: string;\n    /**\n     * Optional notification icon resource name\n     */\n    icon?: string;\n  };\n\n  /**\n   * Enable high accuracy mode\n   * @default true\n   */\n  enableHighAccuracy?: boolean;\n\n  /**\n   * Minimum distance in meters to trigger update\n   */\n  distanceFilter?: number;\n\n  /**\n   * API service configuration (optional)\n   * If provided, location data will be sent to the specified API endpoint in batches\n   */\n  api?: ApiServiceConfig;\n}\n\nexport interface ApiServiceConfig {\n  /**\n   * API endpoint URL (REQUIRED if api config is provided)\n   */\n  url: string;\n\n  /**\n   * HTTP method to use\n   * @default 'POST'\n   */\n  type?: 'GET' | 'POST' | 'PUT' | 'PATCH';\n\n  /**\n   * HTTP headers to include in API requests\n   */\n  header?: Record<string, string>;\n\n  /**\n   * Additional parameters to include in API request body\n   */\n  additionalParams?: Record<string, any>;\n\n  /**\n   * Interval in minutes for sending batched location data to API\n   * @default 5\n   * @minimum 1\n   */\n  apiInterval?: number;\n}\n\nexport interface ApiServiceStatus {\n  /**\n   * Whether API service is enabled and configured\n   */\n  isEnabled: boolean;\n\n  /**\n   * Number of location points in buffer waiting to be sent\n   */\n  bufferSize: number;\n\n  /**\n   * Whether API service is healthy (not in circuit breaker state)\n   */\n  isHealthy: boolean;\n}\n\nexport interface LocationResult {\n  /**\n   * Latitude in decimal degrees\n   */\n  latitude: number;\n\n  /**\n   * Longitude in decimal degrees\n   */\n  longitude: number;\n\n  /**\n   * Accuracy of the location in meters\n   */\n  accuracy: number;\n\n  /**\n   * Altitude in meters (if available)\n   */\n  altitude?: number;\n\n  /**\n   * Bearing in degrees (if available)\n   */\n  bearing?: number;\n\n  /**\n   * Speed in meters per second (if available)\n   */\n  speed?: number;\n\n  /**\n   * Timestamp in ISO 8601 format\n   */\n  timestamp: string;\n}\n\nexport interface LocationPermissionStatus {\n  /**\n   * Fine and coarse location permission status\n   */\n  location: PermissionState;\n\n  /**\n   * Background location permission status (Android 10+)\n   */\n  backgroundLocation: PermissionState;\n\n  /**\n   * Notification permission status (Android 13+)\n   */\n  notifications: PermissionState;\n}\n\nexport interface ServiceStatus {\n  /**\n   * Whether the service is currently running\n   */\n  isRunning: boolean;\n\n  /**\n   * Error message if service failed\n   */\n  error?: string;\n}\n\n/**\n * Plugin error codes for consistent error handling\n */\nexport const ERROR_CODES = {\n  /**\n   * Location permission denied or not granted\n   */\n  PERMISSION_DENIED: 'PERMISSION_DENIED',\n\n  /**\n   * Invalid notification configuration\n   */\n  INVALID_NOTIFICATION: 'INVALID_NOTIFICATION',\n\n  /**\n   * Invalid parameters provided\n   */\n  INVALID_PARAMETERS: 'INVALID_PARAMETERS',\n\n  /**\n   * Location services disabled\n   */\n  LOCATION_SERVICES_DISABLED: 'LOCATION_SERVICES_DISABLED',\n\n  /**\n   * Feature not supported on current platform\n   */\n  UNSUPPORTED_PLATFORM: 'UNSUPPORTED_PLATFORM'\n} as const;\n\nexport type ErrorCode = typeof ERROR_CODES[keyof typeof ERROR_CODES];\n"]}

package/dist/esm/index.d.ts

@@ -0,0 +1,4 @@
+import type { ForeGroundLocationPlugin } from './definitions';
+declare const ForeGroundLocation: ForeGroundLocationPlugin;
+export * from './definitions';
+export { ForeGroundLocation };

package/dist/esm/index.js

@@ -0,0 +1,7 @@
+import { registerPlugin } from '@capacitor/core';
+const ForeGroundLocation = registerPlugin('ForeGroundLocation', {
+    web: () => import('./web').then((m) => new m.ForeGroundLocationWeb()),
+});
+export * from './definitions';
+export { ForeGroundLocation };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjD,MAAM,kBAAkB,GAAG,cAAc,CAA2B,oBAAoB,EAAE;IACxF,GAAG,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,qBAAqB,EAAE,CAAC;CACtE,CAAC,CAAC;AAEH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC","sourcesContent":["import { registerPlugin } from '@capacitor/core';\n\nimport type { ForeGroundLocationPlugin } from './definitions';\n\nconst ForeGroundLocation = registerPlugin<ForeGroundLocationPlugin>('ForeGroundLocation', {\n  web: () => import('./web').then((m) => new m.ForeGroundLocationWeb()),\n});\n\nexport * from './definitions';\nexport { ForeGroundLocation };\n"]}

package/dist/esm/web.d.ts

@@ -0,0 +1,16 @@
+import { WebPlugin } from '@capacitor/core';
+import type { ForeGroundLocationPlugin, LocationPermissionStatus, LocationResult, ApiServiceStatus } from './definitions';
+export declare class ForeGroundLocationWeb extends WebPlugin implements ForeGroundLocationPlugin {
+    checkPermissions(): Promise<LocationPermissionStatus>;
+    requestPermissions(): Promise<LocationPermissionStatus>;
+    startForegroundLocationService(): Promise<void>;
+    stopForegroundLocationService(): Promise<void>;
+    isServiceRunning(): Promise<{
+        isRunning: boolean;
+    }>;
+    getCurrentLocation(): Promise<LocationResult>;
+    updateLocationSettings(): Promise<void>;
+    getApiServiceStatus(): Promise<ApiServiceStatus>;
+    clearApiBuffers(): Promise<void>;
+    resetApiCircuitBreaker(): Promise<void>;
+}

package/dist/esm/web.js

@@ -0,0 +1,97 @@
+import { WebPlugin } from '@capacitor/core';
+export class ForeGroundLocationWeb extends WebPlugin {
+    async checkPermissions() {
+        if (typeof navigator === 'undefined') {
+            throw this.unavailable('Navigator not available');
+        }
+        if (!navigator.permissions) {
+            throw this.unavailable('Permissions API not available in this browser');
+        }
+        if (!navigator.geolocation) {
+            throw this.unavailable('Geolocation API not available in this browser');
+        }
+        try {
+            const permission = await navigator.permissions.query({ name: 'geolocation' });
+            return {
+                location: permission.state,
+                backgroundLocation: 'denied',
+                notifications: 'denied'
+            };
+        }
+        catch (error) {
+            // Fallback for browsers that support geolocation but not permissions query
+            return {
+                location: 'prompt',
+                backgroundLocation: 'denied',
+                notifications: 'denied'
+            };
+        }
+    }
+    async requestPermissions() {
+        throw this.unimplemented('Background location service not supported on web. Use getCurrentLocation() for one-time location access.');
+    }
+    async startForegroundLocationService() {
+        throw this.unimplemented('Foreground location service not supported on web. Use getCurrentLocation() for one-time location access.');
+    }
+    async stopForegroundLocationService() {
+        throw this.unimplemented('Foreground location service not supported on web.');
+    }
+    async isServiceRunning() {
+        return { isRunning: false };
+    }
+    async getCurrentLocation() {
+        if (typeof navigator === 'undefined') {
+            throw this.unavailable('Navigator not available');
+        }
+        if (!navigator.geolocation) {
+            throw this.unavailable('Geolocation API not available in this browser');
+        }
+        return new Promise((resolve, reject) => {
+            navigator.geolocation.getCurrentPosition((position) => {
+                resolve({
+                    latitude: position.coords.latitude,
+                    longitude: position.coords.longitude,
+                    accuracy: position.coords.accuracy,
+                    altitude: position.coords.altitude || undefined,
+                    bearing: position.coords.heading || undefined,
+                    speed: position.coords.speed || undefined,
+                    timestamp: new Date(position.timestamp).toISOString(),
+                });
+            }, (error) => {
+                let errorMessage = 'Location error';
+                switch (error.code) {
+                    case error.PERMISSION_DENIED:
+                        errorMessage = 'Location permission denied';
+                        break;
+                    case error.POSITION_UNAVAILABLE:
+                        errorMessage = 'Location position unavailable';
+                        break;
+                    case error.TIMEOUT:
+                        errorMessage = 'Location request timed out';
+                        break;
+                    default:
+                        errorMessage = `Location error: ${error.message}`;
+                        break;
+                }
+                reject(errorMessage);
+            }, {
+                enableHighAccuracy: true,
+                timeout: 10000,
+                maximumAge: 300000,
+            });
+        });
+    }
+    async updateLocationSettings() {
+        throw this.unimplemented('Location service settings not supported on web.');
+    }
+    async getApiServiceStatus() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+    async clearApiBuffers() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+    async resetApiCircuitBreaker() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"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","sourcesContent":["import { WebPlugin } from '@capacitor/core';\n\nimport type {\n  ForeGroundLocationPlugin,\n  LocationPermissionStatus,\n  LocationResult,\n  ApiServiceStatus\n} from './definitions';\n\nexport class ForeGroundLocationWeb extends WebPlugin implements ForeGroundLocationPlugin {\n\n  async checkPermissions(): Promise<LocationPermissionStatus> {\n    if (typeof navigator === 'undefined') {\n      throw this.unavailable('Navigator not available');\n    }\n\n    if (!navigator.permissions) {\n      throw this.unavailable('Permissions API not available in this browser');\n    }\n\n    if (!navigator.geolocation) {\n      throw this.unavailable('Geolocation API not available in this browser');\n    }\n\n    try {\n      const permission = await navigator.permissions.query({ name: 'geolocation' as PermissionName });\n      return {\n        location: permission.state as any,\n        backgroundLocation: 'denied',\n        notifications: 'denied'\n      };\n    } catch (error) {\n      // Fallback for browsers that support geolocation but not permissions query\n      return {\n        location: 'prompt',\n        backgroundLocation: 'denied',\n        notifications: 'denied'\n      };\n    }\n  }\n\n  async requestPermissions(): Promise<LocationPermissionStatus> {\n    throw this.unimplemented('Background location service not supported on web. Use getCurrentLocation() for one-time location access.');\n  }\n\n  async startForegroundLocationService(): Promise<void> {\n    throw this.unimplemented('Foreground location service not supported on web. Use getCurrentLocation() for one-time location access.');\n  }\n\n  async stopForegroundLocationService(): Promise<void> {\n    throw this.unimplemented('Foreground location service not supported on web.');\n  }\n\n  async isServiceRunning(): Promise<{ isRunning: boolean }> {\n    return { isRunning: false };\n  }\n\n  async getCurrentLocation(): Promise<LocationResult> {\n    if (typeof navigator === 'undefined') {\n      throw this.unavailable('Navigator not available');\n    }\n\n    if (!navigator.geolocation) {\n      throw this.unavailable('Geolocation API not available in this browser');\n    }\n\n    return new Promise((resolve, reject) => {\n      navigator.geolocation.getCurrentPosition(\n        (position) => {\n          resolve({\n            latitude: position.coords.latitude,\n            longitude: position.coords.longitude,\n            accuracy: position.coords.accuracy,\n            altitude: position.coords.altitude || undefined,\n            bearing: position.coords.heading || undefined,\n            speed: position.coords.speed || undefined,\n            timestamp: new Date(position.timestamp).toISOString(),\n          });\n        },\n        (error) => {\n          let errorMessage = 'Location error';\n          switch (error.code) {\n            case error.PERMISSION_DENIED:\n              errorMessage = 'Location permission denied';\n              break;\n            case error.POSITION_UNAVAILABLE:\n              errorMessage = 'Location position unavailable';\n              break;\n            case error.TIMEOUT:\n              errorMessage = 'Location request timed out';\n              break;\n            default:\n              errorMessage = `Location error: ${error.message}`;\n              break;\n          }\n          reject(errorMessage);\n        },\n        {\n          enableHighAccuracy: true,\n          timeout: 10000,\n          maximumAge: 300000,\n        }\n      );\n    });\n  }\n\n  async updateLocationSettings(): Promise<void> {\n    throw this.unimplemented('Location service settings not supported on web.');\n  }\n\n  async getApiServiceStatus(): Promise<ApiServiceStatus> {\n    throw this.unimplemented('API service not supported on web.');\n  }\n\n  async clearApiBuffers(): Promise<void> {\n    throw this.unimplemented('API service not supported on web.');\n  }\n\n  async resetApiCircuitBreaker(): Promise<void> {\n    throw this.unimplemented('API service not supported on web.');\n  }\n}\n"]}

package/dist/plugin.cjs.js

@@ -0,0 +1,138 @@
+'use strict';
+
+var core = require('@capacitor/core');
+
+/**
+ * Plugin error codes for consistent error handling
+ */
+const ERROR_CODES = {
+    /**
+     * Location permission denied or not granted
+     */
+    PERMISSION_DENIED: 'PERMISSION_DENIED',
+    /**
+     * Invalid notification configuration
+     */
+    INVALID_NOTIFICATION: 'INVALID_NOTIFICATION',
+    /**
+     * Invalid parameters provided
+     */
+    INVALID_PARAMETERS: 'INVALID_PARAMETERS',
+    /**
+     * Location services disabled
+     */
+    LOCATION_SERVICES_DISABLED: 'LOCATION_SERVICES_DISABLED',
+    /**
+     * Feature not supported on current platform
+     */
+    UNSUPPORTED_PLATFORM: 'UNSUPPORTED_PLATFORM'
+};
+
+const ForeGroundLocation = core.registerPlugin('ForeGroundLocation', {
+    web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.ForeGroundLocationWeb()),
+});
+
+class ForeGroundLocationWeb extends core.WebPlugin {
+    async checkPermissions() {
+        if (typeof navigator === 'undefined') {
+            throw this.unavailable('Navigator not available');
+        }
+        if (!navigator.permissions) {
+            throw this.unavailable('Permissions API not available in this browser');
+        }
+        if (!navigator.geolocation) {
+            throw this.unavailable('Geolocation API not available in this browser');
+        }
+        try {
+            const permission = await navigator.permissions.query({ name: 'geolocation' });
+            return {
+                location: permission.state,
+                backgroundLocation: 'denied',
+                notifications: 'denied'
+            };
+        }
+        catch (error) {
+            // Fallback for browsers that support geolocation but not permissions query
+            return {
+                location: 'prompt',
+                backgroundLocation: 'denied',
+                notifications: 'denied'
+            };
+        }
+    }
+    async requestPermissions() {
+        throw this.unimplemented('Background location service not supported on web. Use getCurrentLocation() for one-time location access.');
+    }
+    async startForegroundLocationService() {
+        throw this.unimplemented('Foreground location service not supported on web. Use getCurrentLocation() for one-time location access.');
+    }
+    async stopForegroundLocationService() {
+        throw this.unimplemented('Foreground location service not supported on web.');
+    }
+    async isServiceRunning() {
+        return { isRunning: false };
+    }
+    async getCurrentLocation() {
+        if (typeof navigator === 'undefined') {
+            throw this.unavailable('Navigator not available');
+        }
+        if (!navigator.geolocation) {
+            throw this.unavailable('Geolocation API not available in this browser');
+        }
+        return new Promise((resolve, reject) => {
+            navigator.geolocation.getCurrentPosition((position) => {
+                resolve({
+                    latitude: position.coords.latitude,
+                    longitude: position.coords.longitude,
+                    accuracy: position.coords.accuracy,
+                    altitude: position.coords.altitude || undefined,
+                    bearing: position.coords.heading || undefined,
+                    speed: position.coords.speed || undefined,
+                    timestamp: new Date(position.timestamp).toISOString(),
+                });
+            }, (error) => {
+                let errorMessage = 'Location error';
+                switch (error.code) {
+                    case error.PERMISSION_DENIED:
+                        errorMessage = 'Location permission denied';
+                        break;
+                    case error.POSITION_UNAVAILABLE:
+                        errorMessage = 'Location position unavailable';
+                        break;
+                    case error.TIMEOUT:
+                        errorMessage = 'Location request timed out';
+                        break;
+                    default:
+                        errorMessage = `Location error: ${error.message}`;
+                        break;
+                }
+                reject(errorMessage);
+            }, {
+                enableHighAccuracy: true,
+                timeout: 10000,
+                maximumAge: 300000,
+            });
+        });
+    }
+    async updateLocationSettings() {
+        throw this.unimplemented('Location service settings not supported on web.');
+    }
+    async getApiServiceStatus() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+    async clearApiBuffers() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+    async resetApiCircuitBreaker() {
+        throw this.unimplemented('API service not supported on web.');
+    }
+}
+
+var web = /*#__PURE__*/Object.freeze({
+    __proto__: null,
+    ForeGroundLocationWeb: ForeGroundLocationWeb
+});
+
+exports.ERROR_CODES = ERROR_CODES;
+exports.ForeGroundLocation = ForeGroundLocation;
+//# sourceMappingURL=plugin.cjs.js.map

package/dist/plugin.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\r\n * Plugin error codes for consistent error handling\r\n */\r\nexport const ERROR_CODES = {\r\n    /**\r\n     * Location permission denied or not granted\r\n     */\r\n    PERMISSION_DENIED: 'PERMISSION_DENIED',\r\n    /**\r\n     * Invalid notification configuration\r\n     */\r\n    INVALID_NOTIFICATION: 'INVALID_NOTIFICATION',\r\n    /**\r\n     * Invalid parameters provided\r\n     */\r\n    INVALID_PARAMETERS: 'INVALID_PARAMETERS',\r\n    /**\r\n     * Location services disabled\r\n     */\r\n    LOCATION_SERVICES_DISABLED: 'LOCATION_SERVICES_DISABLED',\r\n    /**\r\n     * Feature not supported on current platform\r\n     */\r\n    UNSUPPORTED_PLATFORM: 'UNSUPPORTED_PLATFORM'\r\n};\r\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\r\nconst ForeGroundLocation = registerPlugin('ForeGroundLocation', {\r\n    web: () => import('./web').then((m) => new m.ForeGroundLocationWeb()),\r\n});\r\nexport * from './definitions';\r\nexport { ForeGroundLocation };\r\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\r\nexport class ForeGroundLocationWeb extends WebPlugin {\r\n    async checkPermissions() {\r\n        if (typeof navigator === 'undefined') {\r\n            throw this.unavailable('Navigator not available');\r\n        }\r\n        if (!navigator.permissions) {\r\n            throw this.unavailable('Permissions API not available in this browser');\r\n        }\r\n        if (!navigator.geolocation) {\r\n            throw this.unavailable('Geolocation API not available in this browser');\r\n        }\r\n        try {\r\n            const permission = await navigator.permissions.query({ name: 'geolocation' });\r\n            return {\r\n                location: permission.state,\r\n                backgroundLocation: 'denied',\r\n                notifications: 'denied'\r\n            };\r\n        }\r\n        catch (error) {\r\n            // Fallback for browsers that support geolocation but not permissions query\r\n            return {\r\n                location: 'prompt',\r\n                backgroundLocation: 'denied',\r\n                notifications: 'denied'\r\n            };\r\n        }\r\n    }\r\n    async requestPermissions() {\r\n        throw this.unimplemented('Background location service not supported on web. Use getCurrentLocation() for one-time location access.');\r\n    }\r\n    async startForegroundLocationService() {\r\n        throw this.unimplemented('Foreground location service not supported on web. Use getCurrentLocation() for one-time location access.');\r\n    }\r\n    async stopForegroundLocationService() {\r\n        throw this.unimplemented('Foreground location service not supported on web.');\r\n    }\r\n    async isServiceRunning() {\r\n        return { isRunning: false };\r\n    }\r\n    async getCurrentLocation() {\r\n        if (typeof navigator === 'undefined') {\r\n            throw this.unavailable('Navigator not available');\r\n        }\r\n        if (!navigator.geolocation) {\r\n            throw this.unavailable('Geolocation API not available in this browser');\r\n        }\r\n        return new Promise((resolve, reject) => {\r\n            navigator.geolocation.getCurrentPosition((position) => {\r\n                resolve({\r\n                    latitude: position.coords.latitude,\r\n                    longitude: position.coords.longitude,\r\n                    accuracy: position.coords.accuracy,\r\n                    altitude: position.coords.altitude || undefined,\r\n                    bearing: position.coords.heading || undefined,\r\n                    speed: position.coords.speed || undefined,\r\n                    timestamp: new Date(position.timestamp).toISOString(),\r\n                });\r\n            }, (error) => {\r\n                let errorMessage = 'Location error';\r\n                switch (error.code) {\r\n                    case error.PERMISSION_DENIED:\r\n                        errorMessage = 'Location permission denied';\r\n                        break;\r\n                    case error.POSITION_UNAVAILABLE:\r\n                        errorMessage = 'Location position unavailable';\r\n                        break;\r\n                    case error.TIMEOUT:\r\n                        errorMessage = 'Location request timed out';\r\n                        break;\r\n                    default:\r\n                        errorMessage = `Location error: ${error.message}`;\r\n                        break;\r\n                }\r\n                reject(errorMessage);\r\n            }, {\r\n                enableHighAccuracy: true,\r\n                timeout: 10000,\r\n                maximumAge: 300000,\r\n            });\r\n        });\r\n    }\r\n    async updateLocationSettings() {\r\n        throw this.unimplemented('Location service settings not supported on web.');\r\n    }\r\n    async getApiServiceStatus() {\r\n        throw this.unimplemented('API service not supported on web.');\r\n    }\r\n    async clearApiBuffers() {\r\n        throw this.unimplemented('API service not supported on web.');\r\n    }\r\n    async resetApiCircuitBreaker() {\r\n        throw this.unimplemented('API service not supported on web.');\r\n    }\r\n}\r\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}