From 9e3decc91abe1d33d9be4fc23b47c542e94d4ef0 Mon Sep 17 00:00:00 2001
From: Mikkeli Matlock <matlockib@gmail.com>
Date: Wed, 11 Feb 2026 19:13:39 +0900
Subject: [PATCH] feat(03-01): add timestamp field to OverlayMessage model

- Add timestamp field with auto-population via DateTime.now()
- Update all factory constructors to include timestamp
- Serialize timestamp as millisecondsSinceEpoch in toMap()
- Deserialize with fallback to DateTime.now() in fromMap()
- Add timestamp parameter to copyWith() method
- Remove const modifiers to allow DateTime.now() runtime values

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
---
 lib/models/overlay_message.dart | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/lib/models/overlay_message.dart b/lib/models/overlay_message.dart
index 000fa46..c587c09 100644
--- a/lib/models/overlay_message.dart
+++ b/lib/models/overlay_message.dart
@@ -10,8 +10,9 @@ class OverlayMessage {
   final int? themeIndex;
   final double? overlayWidth;
   final double? overlayHeight;
+  final DateTime timestamp;
 
-  const OverlayMessage({
+  OverlayMessage({
     required this.action,
     this.speedText,
     this.unitText,
@@ -21,6 +22,7 @@ class OverlayMessage {
     this.themeIndex,
     this.overlayWidth,
     this.overlayHeight,
+    required this.timestamp,
   });
 
   /// Factory constructor for display update messages
@@ -44,17 +46,24 @@ class OverlayMessage {
       themeIndex: themeIndex,
       overlayWidth: overlayWidth,
       overlayHeight: overlayHeight,
+      timestamp: DateTime.now(),
     );
   }
 
   /// Factory constructor for long press close signal
   factory OverlayMessage.longPressClose() {
-    return const OverlayMessage(action: 'longPressClose');
+    return OverlayMessage(
+      action: 'longPressClose',
+      timestamp: DateTime.now(),
+    );
   }
 
   /// Factory constructor for overlay closed notification
   factory OverlayMessage.overlayClosed() {
-    return const OverlayMessage(action: 'overlayClosed');
+    return OverlayMessage(
+      action: 'overlayClosed',
+      timestamp: DateTime.now(),
+    );
   }
 
   /// Serialize to Map for overlay IPC
@@ -68,6 +77,7 @@ class OverlayMessage {
     if (themeIndex != null) map['themeIndex'] = themeIndex;
     if (overlayWidth != null) map['overlayWidth'] = overlayWidth;
     if (overlayHeight != null) map['overlayHeight'] = overlayHeight;
+    map['timestamp'] = timestamp.millisecondsSinceEpoch;
     return map;
   }
 
@@ -83,6 +93,9 @@ class OverlayMessage {
       themeIndex: map['themeIndex'] as int?,
       overlayWidth: (map['overlayWidth'] as num?)?.toDouble(),
       overlayHeight: (map['overlayHeight'] as num?)?.toDouble(),
+      timestamp: DateTime.fromMillisecondsSinceEpoch(
+        map['timestamp'] as int? ?? DateTime.now().millisecondsSinceEpoch,
+      ),
     );
   }
 
@@ -97,6 +110,7 @@ class OverlayMessage {
     int? themeIndex,
     double? overlayWidth,
     double? overlayHeight,
+    DateTime? timestamp,
   }) {
     return OverlayMessage(
       action: action ?? this.action,
@@ -108,6 +122,7 @@ class OverlayMessage {
       themeIndex: themeIndex ?? this.themeIndex,
       overlayWidth: overlayWidth ?? this.overlayWidth,
       overlayHeight: overlayHeight ?? this.overlayHeight,
+      timestamp: timestamp ?? this.timestamp,
     );
   }
 }