user-analytics-tracker 2.0.0 → 2.2.0

package/CHANGELOG.md

@@ -1,3 +1,41 @@
+# [2.2.0](https://github.com/switch-org/analytics-tracker/compare/v2.1.0...v2.2.0) (2025-12-30)
+
+
+### Features
+
+* ip-location, connection update with ipwho-is api ([fa1b369](https://github.com/switch-org/analytics-tracker/commit/fa1b36997ecad6f71c758f738c768090529bb2b0))
+
+# [2.1.0](https://github.com/switch-org/analytics-tracker/compare/v2.0.0...v2.1.0) (2025-12-29)
+
+
+### Features
+
+* migrate IP geolocation to ipwho.is API with dynamic key storage ([0605f72](https://github.com/switch-org/analytics-tracker/commit/0605f7207baa590b776a3b52cbc055e98a8a22e4))
+
+# [2.1.0](https://github.com/switch-org/analytics-tracker/compare/v2.0.0...v2.1.0) (TBD)
+
+### Features
+
+* **IP Geolocation API Migration**: Migrated from ip-api.com to ipwho.is API for IP-based location tracking
+  - More comprehensive location data including continent, flag, connection details, and timezone information
+  - Dynamic key storage: All API response keys are automatically stored, including nested objects
+  - Future-proof: New fields added by the API are automatically captured without code changes
+  - No API key required: Free tier with no authentication needed
+* **Enhanced IP Location Data**: The `IPLocation` interface now includes all fields from the ipwho.is API response
+  - New fields: `continent`, `continent_code`, `flag`, `connection`, `timezone` (with full details), `is_eu`, `postal`, `calling_code`, `capital`, `borders`
+  - Full backward compatibility: All existing fields (`lat`, `lon`, `countryCode`, etc.) remain available
+  - Access to full IP location data in analytics events via `ipLocationData` field
+
+### Improvements
+
+* Better IP location data coverage with additional metadata
+* Automatic storage of all API response keys, including future additions
+* Improved type definitions for IP location data
+
+### Migration Notes
+
+This upgrade is **fully backward compatible**. No code changes are required. See the [Upgrade Guide](./docs/upgrade-guide.md) for details on accessing new fields.
+
 # [2.0.0](https://github.com/switch-org/analytics-tracker/compare/v1.7.0...v2.0.0) (2025-12-01)
 
 

package/README.md

@@ -15,7 +15,8 @@ A comprehensive, lightweight analytics tracking library for React applications.
 - 📍 **Location Tracking**: 
   - **IP-based location** - Requires user consent (privacy-compliant)
   - **GPS location** - Requires explicit user consent and browser permission
-  - Includes public IP address, country, city, region, timezone
+  - Includes public IP address, country, city, region, timezone, continent, flag, connection details
+  - Dynamic key storage: All IP location API fields are automatically captured
   - Automatic fallback from GPS to IP when GPS unavailable
   - Consent management utilities included
 - 🎯 **Attribution Tracking**: UTM parameters, referrer tracking, first/last touch attribution
@@ -855,6 +856,14 @@ export async function POST(req: NextRequest) {
 
 Comprehensive documentation is available in the [`docs/`](./docs) directory:
 
+- **[Upgrade Guide](./docs/upgrade-guide.md)** - Step-by-step migration instructions for upgrading between versions
+
+- **[Upgrade Guide](./docs/upgrade-guide.md)** - Step-by-step migration instructions for upgrading between versions
+  - Breaking changes and compatibility notes
+  - New features and improvements
+  - Migration examples
+  - Troubleshooting upgrade issues
+
 - **[Usage Guide](./docs/usage-guide.md)** - Complete guide on how to use the package in your applications
   - Installation instructions
   - Basic and advanced usage examples
@@ -964,7 +973,7 @@ MIT © [Switch Org](https://github.com/switch-org)
 
 ## 🙏 Acknowledgments
 
-- Uses [ip-api.com](http://ip-api.com) for free IP geolocation
+- Uses [ipwho.is](https://ipwho.is/) for free IP geolocation
 - Built with modern web APIs (User-Agent Client Hints, Network Information API, Geolocation API)
 
 <!-- ## 📞 Support