flutter_sync_client 0.2.7

flutter_sync_client: ^0.2.7 copied to clipboard

• Fix: Fixed a TypeError by ensuring all id fields are safely converted to strings, preventing crashes when the server sends numeric IDs.

• Refactor: Removed client-side data decompression to simplify the logic and enforce that the server sends uncompressed data.

• Fix: Correctly use ZLibCodec for data decompression to match server-side compression, resolving mobile client errors.

• Refactor: Centralized server data handling logic into SyncClient to simplify collection classes and improve data processing consistency.

• Fix: Resolved a data deserialization issue by improving the handling of mixed compressed and uncompressed server data.

• Critical Fix: Cross-Platform Decompression: Replaced dart:io ZLibDecoder with GZipCodec and a fallback for web compatibility, fixing data decompression on web builds.
• Enhanced Error Handling: Introduced an onError stream in SyncClient to allow developers to listen for and handle synchronization and connection errors.
• Optimized Typed Collections: Refactored TypedCollectionReference to use incremental updates for caching and indexing, significantly improving performance for large collections.
• Implemented Bulk Operations: Added insertMany, updateMany, and deleteMany methods to both CollectionReference and TypedCollectionReference for efficient batch operations.
• Updated Example App: Revamped the example app to demonstrate the new features, including typed collections, bulk operations, and error handling.

• Dependency Updates: Upgraded socket_io_client to ^3.1.2 and uuid to ^4.5.2.
• Minor bug fixes and performance improvements.

• Refactored Decompression: Switched from third-party libraries to Dart's built-in dart:io for ZLib decompression and dart:convert for JSON serialization. This removes the archive and msgpack_dart dependencies and resolves web compatibility issues.

• Upsert and Delete Handling: Updated HiveManager to handle upsert (update or insert) and delete operations from the server.
• Data Decompression: Implemented data decompression for incoming data from the server using msgpack_dart and archive.
• Refactored SocketManager: Moved the decompression logic to the SocketManager to handle all incoming events.

• Added Hive web test example demonstrating IndexedDB storage
• Confirmed Hive fully works on web through IndexedDB
• Added visual test app for web platform validation
• Documentation clarification: Hive uses IndexedDB on web (no limitations)

• Flutter Web support - Full support for running in web browsers
• Production server support - Fixed connection issues with production servers
• Added configurable Socket.IO transport (polling, websocket, or both)
• Added custom Socket.IO path configuration
• Added configurable reconnection attempts, delay, and timeout
• Created web example with real-time sync demo
• Created SmartWind production server example
• Added comprehensive web support guide (WEB_SUPPORT.md)
• Added comprehensive troubleshooting guide (SMARTWIND_SETUP.md)
• Added flutter_web_plugins dependency for web platform
• Default transport changed to ['polling', 'websocket'] for better compatibility

New Platform Support:

• ✅ Flutter Web (Chrome, Firefox, Safari, Edge)
• ✅ Works with IndexedDB for offline storage on web
• ✅ Socket.IO works in browser with polling/websocket

Breaking Changes:

• None - fully backward compatible with default settings

• Documentation release - comprehensive README update
• Added pub.flutter-io.cn and MIT license badges
• Improved documentation structure with complete examples
• Added authentication and advanced features sections
• Added server setup example with Socket.IO code
• Added links to all documentation files
• Enhanced overall package presentation

• Internal version (not published)

• Added type-safe TypedCollectionReference<T> with generics support
• Implemented fast O(1) searching with in-memory field indexing
• Added in-memory caching for instant ID-based lookups
• New query methods: findByField(), where(), findFirst(), count()
• Fixed type casting issue in SyncItem.fromJson() to handle both string and numeric IDs
• Added comprehensive documentation in TYPED_COLLECTIONS.md
• Added typed collection example code

• Initial release
• Real-time data synchronization with Socket.IO
• Local storage with Hive database
• Automatic offline/online detection and sync
• Support for Android and iOS platforms

• Project setup