DocumentSerializable class abstract interface

Contract for objects that can be serialized to/from JSON.

Implementations must provide both instance serialization and static deserialization capabilities. The static factory pattern is preferred over constructors for better error handling and type safety.

Example implementation:

class User implements DocumentSerializable {
  const User({required this.id, required this.name});

  final int id;
  final String name;

  @override
  Map<String, dynamic> toJson() => {'id': id, 'name': name};

  static User fromJson(Map<String, dynamic> json) {
    return User(
      id: json['id'] as int,
      name: json['name'] as String,
    );
  }
}