feat(data): add history data structure

Author: sikelio

lib/main.dart

@@ -21,6 +21,10 @@ import 'package:app_links/app_links.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/foundation.dart' show kIsWeb;
 import 'package:flutter/services.dart';
+import 'package:hive_flutter/hive_flutter.dart';
+import 'models/conversion_history_entry.dart';
+import 'models/music_platform.dart';
+import 'models/track_metadata.dart';
 import 'pages/home_page.dart';
 import 'theme/app_theme.dart';
 import 'utils/web_share_handler.dart';
@@ -30,6 +34,14 @@ Future<void> main() async {
 
   await SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
 
+  await Hive.initFlutter();
+
+  Hive.registerAdapter(ConversionHistoryEntryAdapter());
+  Hive.registerAdapter(MusicPlatformAdapter());
+  Hive.registerAdapter(TrackMetadataAdapter());
+
+  await Hive.openBox<ConversionHistoryEntry>('conversion_history');
+
   runApp(const MusicSharityApp());
 }
 

lib/models/conversion_history_entry.dart

@@ -0,0 +1,59 @@
+/*
+ * Music Sharity - Share music across all platforms
+ * Copyright (C) 2026 Sikelio (Byte Roast)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+import 'package:hive/hive.dart';
+import 'music_platform.dart';
+import 'track_metadata.dart';
+
+part 'conversion_history_entry.g.dart';
+
+@HiveType(typeId: 0)
+class ConversionHistoryEntry {
+  @HiveField(0)
+  final DateTime timestamp;
+
+  @HiveField(1)
+  final String sourceUrl;
+
+  @HiveField(2)
+  final MusicPlatform sourcePlatform;
+
+  @HiveField(3)
+  final MusicPlatform targetPlatform;
+
+  @HiveField(4)
+  final String targetUrl;
+
+  @HiveField(5)
+  final TrackMetadata? metadata;
+
+  ConversionHistoryEntry({
+    required this.timestamp,
+    required this.sourceUrl,
+    required this.sourcePlatform,
+    required this.targetPlatform,
+    required this.targetUrl,
+    this.metadata,
+  });
+
+  @override
+  String toString() {
+    return 'ConversionHistoryEntry(timestamp: $timestamp, '
+        'source: ${sourcePlatform.displayName} -> target: ${targetPlatform.displayName}, '
+        'track: ${metadata?.title ?? 'Unknown'})';
+  }
+}

lib/models/conversion_history_entry.g.dart

@@ -15,13 +15,31 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
+import 'package:hive/hive.dart';
+
+part 'music_platform.g.dart';
+
+@HiveType(typeId: 2)
 enum MusicPlatform {
+  @HiveField(0)
   spotify,
+
+  @HiveField(1)
   deezer,
+
+  @HiveField(2)
   appleMusic,
+
+  @HiveField(3)
   youtubeMusic,
+
+  @HiveField(4)
   tidal,
+
+  @HiveField(5)
   soundCloud,
+
+  @HiveField(6)
   unknown,
 }
 

lib/models/music_platform.dart

@@ -15,10 +15,22 @@
  * You should have received a copy of the GNU General Public License
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
+import 'package:hive/hive.dart';
+
+part 'track_metadata.g.dart';
+
+@HiveType(typeId: 1)
 class TrackMetadata {
+  @HiveField(0)
   final String title;
+
+  @HiveField(1)
   final String artist;
+
+  @HiveField(2)
   final String? album;
+
+  @HiveField(3)
   final String? imageUrl;
 
   TrackMetadata({