🐛 Bug Report: realtimeMessage.fromMap crashes with _Map<String, dynamic> is not a subtype of Iterable<dynamic>

[yassir150]

👟 Reproduction steps

1. Set up an Appwrite Realtime subscription on a collection/document channel (e.g., messaging).
2. Trigger a document creation event (e.g., send a message that creates a document in the subscribed collection).
3. The Realtime WebSocket receives the event of type "event".
4. The SDK attempts to parse the incoming event data via RealtimeMessage.fromMap().
5. The app crashes with an unhandled exception.

👍 Expected behavior

The RealtimeMessage.fromMap() factory constructor should correctly parse the incoming WebSocket event data regardless of whether the server sends events or channels as a List or a Map. The Realtime subscription callback should fire with a valid RealtimeMessage object containing the event payload.

👎 Actual Behavior

E/flutter (16642): [ERROR:flutter/runtime/dart_vm_initializer.cc(40)] Unhandled Exception: type '_Map<String, dynamic>' is not a subtype of type 'Iterable<dynamic>'
E/flutter (16642): #0      new RealtimeMessage.fromMap (package:appwrite/src/realtime_message.dart:57:47)
E/flutter (16642): #1      RealtimeMixin._createSocket.<anonymous closure> (package:appwrite/src/realtime_mixin.dart:100:45)
E/flutter (16642): #2      _RootZone.runUnaryGuarded (dart:async/zone.dart:1778:10)
...

🎲 Appwrite version

Version 2.0.x

💻 Operating system

Windows

🧱 Your Environment

Flutter app using BLoC pattern for state management
Appwrite Realtime subscriptions on tablesdb/tables channels
Standard Appwrite Cloud

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

[Skynse]

I can reproduce this on appwrite: 21.4.0 with Appwrite server 1.8.1 during realtime card moves.

Root cause:
RealtimeMessage.fromMap assumes events/channels/subscriptions are always List, but some realtime packets come
through as Map.
That causes:
type '_Map<String, dynamic>' is not a subtype of type 'Iterable<dynamic>'.

Temporary fix (works for me):
Patch Flutter SDK realtime parsing to accept both List and Map shapes.

1) lib/src/realtime_message.dart

• Parse events and channels from either List or Map.values
• Parse payload safely from Map

2) lib/src/realtime_mixin.dart (event case)

• Guard if (data.data is! Map) break;
• Parse subscriptions from either List or Map.values

After this patch, realtime crash disappears. I actually noticed this on my web app, but was able to properly diagnose it when debugging natively.

Gonna be watching for a fix if someone takes it up, but my suggestions are valid I think. I patched those two files locally and bootstrapped them into my app for now.