TetherModel<T> class abstract

An abstract base class for all data models managed by the Tether system.

TetherModel provides a common interface for models that can be serialized to and from JSON (for network communication, e.g., with Supabase) and an SQLite-compatible format (for local database persistence).

Subclasses must implement:

• toJson(): To serialize the model to a JSON map.
• toSqlite(): To serialize the model to a map suitable for SQLite insertion/update. This might involve converting complex types (like DateTime or enums) to SQLite-compatible types (like ISO8601 strings or integers).
• copyWith(...): A method to create a new instance of the model with some fields updated. The actual parameters for copyWith should be specific to the subclass and its properties.
• A static fromJson(Map<String, dynamic> json) factory constructor (or equivalent) for deserializing from JSON.
• A static fromSqlite(Row sqliteData) factory constructor (or equivalent) for deserializing from an SQLite Row.

The generic type T should be the type of the implementing class itself, enabling type-safe copyWith and factory methods.

Example (conceptual subclass):

class MyData extends TetherModel<MyData> {
  final int id;
  final String name;
  final DateTime createdAt;

  MyData({required this.id, required this.name, required this.createdAt})
      : super({'id': id, 'name': name, 'created_at': createdAt.toIso8601String()});

  MyData.fromData(Map<String, dynamic> data)
      : id = data['id'] as int,
        name = data['name'] as String,
        createdAt = DateTime.parse(data['created_at'] as String),
        super(data);

  @override
  dynamic get localId => id;

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

  @override
  Map<String, dynamic> toSqlite() => {
        'id': id,
        'name': name,
        'created_at': createdAt.toIso8601String(), // SQLite stores as TEXT
      };

  @override
  MyData copyWith({int? id, String? name, DateTime? createdAt}) =>
      MyData(
        id: id ?? this.id,
        name: name ?? this.name,
        createdAt: createdAt ?? this.createdAt,
      );

  static MyData fromJson(Map<String, dynamic> json) => MyData(
        id: json['id'] as int,
        name: json['name'] as String,
        createdAt: DateTime.parse(json['created_at'] as String),
      );

  static MyData fromSqlite(Row row) => MyData(
        id: row['id'] as int,
        name: row['name'] as String,
        createdAt: DateTime.parse(row['created_at'] as String),
      );

  @override
  String toString() => 'MyData(id: $id, name: $name, createdAt: $createdAt)';
}

T is the concrete model type (e.g., BookModel) I is the corresponding input type (e.g., BookInput)