foreground-location 0.0.1

package/dist/plugin.js

@@ -0,0 +1,141 @@
+var capacitorForeGroundLocation = (function (exports, core) {
+    'use strict';
+
+    /**
+     * 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;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.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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"}

package/docs/CHANGES-SUMMARY.md

@@ -0,0 +1,69 @@
+# Documentation Updates Summary
+
+## Changes Made
+
+### 1. ✅ Created Documentation Folder
+
+- **Created**: `docs/setup-and-examples.md` - Comprehensive guide consolidating all separate documentation files
+- **Removed**: Individual documentation files that were scattered in the root:
+  - `AndroidManifest-example.xml`
+  - `example-usage.ts`
+  - `QUICK-SETUP.md`
+  - `ICON-USAGE-EXAMPLES.md`
+  - `NOTIFICATION-ICONS-GUIDE.md`
+  - `TYPESCRIPT-IMPORT-FIX.md`
+
+### 2. ✅ Updated README.md
+
+- **Fixed**: All package name references from `foreground-location-plugin` to `foreground-location`
+- **Fixed**: Removed `@xconcepts/capacitor-foreground-location` references
+- **Updated**: Version number from `1.0.0` to `0.0.1` in changelog (matching package.json)
+- **Added**: Reference to comprehensive documentation in docs folder
+- **Verified**: All import statements now use correct package name
+
+### 3. ✅ Fixed Package Naming
+
+- **Confirmed**: Package name is correctly set to `foreground-location` (not `foreground-location-plugin`)
+- **Updated**: Repository URLs to remove `-plugin` suffix
+- **Added**: `docs/` folder to files array in package.json for npm inclusion
+
+### 4. ✅ NPM Publish Configuration
+
+- **Created**: `.npmignore` file to exclude development files from npm package
+- **Hidden**: `plugin-plan-doc/` folder renamed to `.plugin-plan-doc/` (hidden folder)
+- **Excluded**: Development files like `DEVELOPMENT-ITERATION.md`, `CONTRIBUTING.md`
+- **Protected**: Planning documents and development artifacts from being published
+
+## Final Project Structure
+
+```
+foreground-location/
+├── docs/
+│   └── setup-and-examples.md          # ✨ New comprehensive guide
+├── .npmignore                          # ✨ New npm exclusion rules
+├── .plugin-plan-doc/                   # ✨ Hidden (was plugin-plan-doc/)
+├── README.md                           # ✅ Updated with correct package names
+├── package.json                        # ✅ Updated repository URLs
+└── [other project files...]
+```
+
+## Package Name Standardization
+
+- **NPM Package**: `foreground-location`
+- **Import Statement**: `import { ForeGroundLocation } from 'foreground-location';`
+- **Installation**: `npm install foreground-location`
+- **Repository**: `github.com/xconcepts17/foreground-location`
+
+## Build Verification
+
+✅ Project builds successfully with `npm run build`
+✅ All TypeScript imports corrected
+✅ Documentation consolidated and updated
+✅ NPM publish configuration implemented
+
+## Next Steps
+
+1. The plugin is ready for npm publishing with `npm publish`
+2. Planning documents are hidden and excluded from npm package
+3. Users will get clean, consolidated documentation
+4. Package naming is consistent across all files