currency_sdk 1.0.1

Free, open-source currency conversion SDK for Flutter with 160+ currencies and offline-first architecture. No API keys required.

Changelog

All notable changes to the Currency SDK will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.1 - 2025-12-04

Changed

• Updated README to emphasize open-source nature
• Removed references to paid plans (SDK is completely free)
• Removed internal architecture details from documentation
• Added author contact information (LinkedIn, Twitter/X)
• Improved description to highlight "free" and "no API keys required"

Fixed

• Updated GitHub URLs to correct repository

1.0.0 - 2025-12-04

Added

• Initial release of Currency SDK
• 160+ currency support including major and obscure currencies
• Offline-first architecture with Hive caching
• Cloudflare Workers integration for edge computing
• Free tier with 10,000 requests/month (no API key required)
• CurrencyClient main API class
• CurrencyClient.initialize() for SDK setup
• CurrencyClient.convert() for direct currency conversion
• CurrencyClient.getRates() for fetching full rate data
• CurrencyClient.getSupportedCurrencies() for listing available currencies
• CurrencyClient.syncCurrencies() for preloading cache
• CurrencyClient.connectivityStream for monitoring online/offline status
• CurrencyClient.cacheUpdateStream for cache update notifications
• CurrencyClient.enterprise() constructor for custom Worker URLs
• Exception types: CurrencySDKException, InvalidApiKeyException, RateLimitExceededException, NetworkException, UnsupportedCurrencyException, NoCachedDataException, SDKNotInitializedException
• Automatic cache refresh every 2 hours
• Atomic overwrite pattern for cache consistency
• O(1) cache lookups for instant offline response
• Complete example app with UI
• Comprehensive documentation

Technical Details

• Cloudflare Worker URL hidden inside SDK (not user-configurable)
• Master API key for free tier usage
• Feature flags for gradual monetization (requirePerDeveloperKeys, allowCustomWorkerUrls)
• Hive 2.2.3 for local storage
• Connectivity Plus 6.1.0 for network monitoring
• HTTP 1.2.0 for API requests

Infrastructure

• Cloudflare Worker deployed at currency-worker.pixora-ai.workers.dev
• Cron job runs every 2 hours (0 */2 * * *)
• KV namespace for distributed caching
• ExchangeRate-API v6 as data source
• Single API call optimization (USD base with mathematical derivation)

[Unreleased]

Planned Features

• Dashboard for API key management
• Rate limit headers in responses
• Historical exchange rate support
• Currency symbols and display names
• Localization support
• WebSocket support for real-time updates
• Flutter Web support optimization
• More granular error messages

---

Note: This is the initial release. Future versions will include more features based on community feedback.