Feature - TrackingOptions (#14)

* feat: creating TrackingOptions object to allow dynamic configuration

* feat: adjusting hooks and module to work dynamic configuration

* chore(lint): adjusting eslint config to ignore auto-generated files

* feat(example): upgrading example app with mapping with current route

* feat(example): upgrading example app with mapping with current route

* chore(docs): updating docs

* chore(version): updating package beta version

* chore(CICD): disabling automatic deploy for develop changes

* chore(tests): adjusting tests to use new config + new tests

* chore(tests): adjusting tests

* chore(CICD): adjusting podfile of example project

Author: gabriel-sisjr

.github/workflows/prerelease.yml

@@ -1,9 +1,21 @@
 name: Pre-release to NPM
 
 on:
-  push:
-    branches:
-      - develop
+  workflow_dispatch:
+    inputs:
+      branch:
+        description: 'Branch to release from (default: develop)'
+        required: false
+        type: string
+        default: 'develop'
+      version_suffix:
+        description: 'Optional version suffix (e.g., "rc1", "beta1"). Leave empty for auto-generated beta version.'
+        required: false
+        type: string
+      description:
+        description: 'Optional description for this pre-release'
+        required: false
+        type: string
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
@@ -23,6 +35,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
         with:
+          ref: ${{ github.event.inputs.branch || 'develop' }}
           fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
 
@@ -45,9 +58,15 @@ jobs:
           COMMIT_SHA=${GITHUB_SHA::7}
           TIMESTAMP=$(date +%Y%m%d%H%M%S)
           
-          # Remove any existing pre-release tag and add beta
+          # Remove any existing pre-release tag
           BASE_VERSION=$(echo $CURRENT_VERSION | sed 's/-.*$//')
-          PRERELEASE_VERSION="${BASE_VERSION}-beta.${TIMESTAMP}.${COMMIT_SHA}"
+          
+          # Use custom suffix if provided, otherwise auto-generate beta version
+          if [ -n "${{ github.event.inputs.version_suffix }}" ]; then
+            PRERELEASE_VERSION="${BASE_VERSION}-${{ github.event.inputs.version_suffix }}"
+          else
+            PRERELEASE_VERSION="${BASE_VERSION}-beta.${TIMESTAMP}.${COMMIT_SHA}"
+          fi
           
           echo "version=$PRERELEASE_VERSION" >> $GITHUB_OUTPUT
           echo "Generated pre-release version: $PRERELEASE_VERSION"
@@ -124,13 +143,15 @@ jobs:
             const version = '${{ steps.version.outputs.version }}';
             const tagName = `v${version}`;
             
+            const description = '${{ github.event.inputs.description }}' || 'This is a beta release from the develop branch.';
+            
             await github.rest.repos.createRelease({
               owner: context.repo.owner,
               repo: context.repo.repo,
               tag_name: tagName,
               name: `Pre-release ${tagName}`,
               body: `🚀 Pre-release version ${version}\n\n` +
-                    `This is a beta release from the develop branch.\n\n` +
+                    `${description}\n\n` +
                     `Install with: \`npm install @gabriel-sisjr/react-native-background-location@beta\`\n\n` +
                     `Commit: ${context.sha}`,
               draft: false,

CHANGELOG.md

@@ -5,6 +5,61 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2025-11-05
+
+### Added
+
+- ⚙️ **Configurable Tracking Options**: Full customization of location tracking parameters
+  - `TrackingOptions` interface for comprehensive configuration
+  - Customizable update intervals (`updateInterval`, `fastestInterval`, `maxWaitTime`)
+  - Location accuracy levels (`LocationAccuracy` enum)
+  - Notification customization (`notificationTitle`, `notificationText`, `notificationChannelName`, `notificationPriority`)
+  - `waitForAccurateLocation` option for precise GPS tracking
+  - Support for configuration options in `startTracking()` method and `useBackgroundLocation` hook
+
+- 📊 **Location Accuracy Enums**: Type-safe location accuracy levels
+  - `LocationAccuracy.HIGH_ACCURACY` - Highest accuracy using GPS and sensors
+  - `LocationAccuracy.BALANCED_POWER_ACCURACY` - Balanced accuracy and power consumption
+  - `LocationAccuracy.LOW_POWER` - Low power consumption using network-based location
+  - `LocationAccuracy.NO_POWER` - No power consumption, passive updates
+  - `LocationAccuracy.PASSIVE` - Receives location updates from other apps
+
+- 🔔 **Notification Priority Enums**: Type-safe notification priority levels
+  - `NotificationPriority.LOW` - Low priority (default)
+  - `NotificationPriority.DEFAULT` - Default priority
+  - `NotificationPriority.HIGH` - High priority
+  - `NotificationPriority.MAX` - Maximum priority
+
+- 🗑️ **Clear Locations Method**: Added `clearLocations()` method to `useLocationUpdates` hook
+  - Allows clearing all locations for the current trip
+  - Prevents immediate reloading of data after clear operation
+  - Works seamlessly with auto-update functionality
+
+- 📱 **Configuration Presets**: Example app includes predefined configuration presets
+  - **High Accuracy**: Optimized for navigation (2s interval, GPS)
+  - **Balanced**: Good balance between accuracy and battery (10s interval)
+  - **Low Power**: Optimized for battery efficiency (30s interval, network-based)
+  - **Default**: Standard configuration (5s interval)
+
+### Changed
+
+- 🔧 **API Enhancement**: `startTracking()` now accepts optional `TrackingOptions` parameter
+  - `startTracking(tripId?: string, options?: TrackingOptions): Promise<string>`
+  - Backwards compatible with existing code (options are optional)
+  - Default values applied when options not provided
+
+- 📚 **Documentation Updates**: Comprehensive documentation for new features
+  - Updated README.md with configuration examples and enums documentation
+  - Enhanced hooks.md with TrackingOptions examples
+  - Updated QUICKSTART.md with configuration examples
+  - Added configuration presets documentation
+
+### Fixed
+
+- 🐛 Fixed inline styles warnings in RouteMap component
+- 🐛 Fixed enum export/import issues for proper TypeScript support
+- 🐛 Improved type safety for TrackingOptions across the codebase
+
 ## [0.1.0] - 2025-10-26
 
 ### Added