fix(timezone): fix timer clock-skew

src/api/timeEntries.ts

@@ -23,7 +23,10 @@ export interface TimeEntry {
   project_details: TimeEntryProjectDetails | null;
   description: string;
   start_time: string;
+  start_time_ms: number;
   end_time: string | null;
+  end_time_ms: number | null;
+  server_now_ms: number;
   duration: string | null;
   tags: string[];
   tag_details: TimeEntryTagDetails[];
@@ -56,6 +59,8 @@ interface GroupedTimeEntryResponse {
   offset: number;
   next_offset: number | null;
   has_more: boolean;
+  server_now_ms: number;
+  server_now: string;
   groups: TimeEntryGroupWeek[];
 }
 

src/pages/Timesheet.tsx

@@ -55,6 +55,11 @@ interface TimerDraftState {
   tags: string[];
 }
 
+interface TimerClockAnchor {
+  serverNowMs: number;
+  performanceNowMs: number;
+}
+
 const EMPTY_FORM: EntryFormState = {
   description: "",
   projectId: "",
@@ -196,9 +201,14 @@ const formatDateOnly = (value: string, locale: "en" | "fa") => {
   }).format(parsed);
 };
 
+const resolveEntryStartMs = (entry: TimeEntry) => entry.start_time_ms ?? parseApiDateTime(entry.start_time)?.getTime();
+
+const resolveEntryEndMs = (entry: TimeEntry, now = Date.now()) =>
+  entry.end_time_ms ?? (entry.end_time ? parseApiDateTime(entry.end_time)?.getTime() : now);
+
 const formatDuration = (entry: TimeEntry, now = Date.now()) => {
-  const start = parseApiDateTime(entry.start_time)?.getTime();
-  const end = entry.end_time ? parseApiDateTime(entry.end_time)?.getTime() : now;
+  const start = resolveEntryStartMs(entry);
+  const end = resolveEntryEndMs(entry, now);
 
   if (!start || !end) return "00:00:00";
 
@@ -211,12 +221,15 @@ const formatDuration = (entry: TimeEntry, now = Date.now()) => {
 };
 
 const getEntryDurationMs = (entry: TimeEntry, now = Date.now()) => {
-  const start = parseApiDateTime(entry.start_time)?.getTime();
-  const end = entry.end_time ? parseApiDateTime(entry.end_time)?.getTime() : now;
+  const start = resolveEntryStartMs(entry);
+  const end = resolveEntryEndMs(entry, now);
   if (!start || !end) return 0;
   return Math.max(0, end - start);
 };
 
+const getAnchoredServerNowMs = (anchor: TimerClockAnchor | null, performanceNow: number) =>
+  anchor ? anchor.serverNowMs + Math.max(0, performanceNow - anchor.performanceNowMs) : Date.now();
+
 const formatDurationMs = (durationMs: number) => {
   const totalSeconds = Math.max(0, Math.floor(durationMs / 1000));
   const hours = Math.floor(totalSeconds / 3600);
@@ -2083,7 +2096,8 @@ export default function Timesheet() {
   const [hasMoreHistory, setHasMoreHistory] = useState(false);
   const [nextOffset, setNextOffset] = useState<number | null>(0);
   const [limit] = useState(20);
-  const [ticker, setTicker] = useState(Date.now());
+  const [ticker, setTicker] = useState(() => performance.now());
+  const [timerClockAnchor, setTimerClockAnchor] = useState<TimerClockAnchor | null>(null);
 
   const [modalMode, setModalMode] = useState<EntryModalMode>(null);
   const [formState, setFormState] = useState<EntryFormState>(EMPTY_FORM);
@@ -2116,6 +2130,7 @@ export default function Timesheet() {
   const [isDiscardingTimer, setIsDiscardingTimer] = useState(false);
 
   const runningEntry = activeRunningEntry;
+  const runningTimerNowMs = getAnchoredServerNowMs(timerClockAnchor, ticker);
   const deletedProjectLabel = extendedTimesheet.deletedProjectLabel || "Deleted project";
   const deletedTagLabel = extendedTimesheet.deletedTagLabel || "Deleted tag";
   const runningTimerProjects = useMemo(
@@ -2138,7 +2153,7 @@ export default function Timesheet() {
   useEffect(() => {
     if (!runningEntry) return;
 
-    const intervalId = window.setInterval(() => setTicker(Date.now()), 1000);
+    const intervalId = window.setInterval(() => setTicker(performance.now()), 1000);
     return () => window.clearInterval(intervalId);
   }, [runningEntry]);
 
@@ -2244,6 +2259,7 @@ export default function Timesheet() {
   const loadRunningEntry = useCallback(async () => {
     if (!activeWorkspace?.id) {
       setActiveRunningEntry(null);
+      setTimerClockAnchor(null);
       return;
     }
 
@@ -2255,6 +2271,14 @@ export default function Timesheet() {
       });
       const entry = data.groups?.[0]?.days?.[0]?.entries?.[0] || null;
       setActiveRunningEntry(entry);
+      setTimerClockAnchor(
+        entry
+          ? {
+              serverNowMs: data.server_now_ms || entry.server_now_ms || Date.now(),
+              performanceNowMs: performance.now(),
+            }
+          : null,
+      );
     } catch (error) {
       console.error(error);
     }
@@ -2276,6 +2300,7 @@ export default function Timesheet() {
 
   useEffect(() => {
     if (!runningEntry) {
+      setTimerClockAnchor(null);
       timerDraftSignatureRef.current = serializeTimerDraft(EMPTY_TIMER_DRAFT);
       pendingTimerSignatureRef.current = timerDraftSignatureRef.current;
       setTimerDraft(EMPTY_TIMER_DRAFT);
@@ -2326,6 +2351,10 @@ export default function Timesheet() {
       pendingTimerSignatureRef.current = syncedSignature;
       setTimerDraft(syncedDraft);
       setActiveRunningEntry(updatedEntry);
+      setTimerClockAnchor({
+        serverNowMs: updatedEntry.server_now_ms || Date.now(),
+        performanceNowMs: performance.now(),
+      });
       toast.success(saveSuccessText);
       return true;
     } catch (error) {
@@ -2640,6 +2669,7 @@ export default function Timesheet() {
       timerDraftSignatureRef.current = serializeTimerDraft(EMPTY_TIMER_DRAFT);
       setTimerDraft(EMPTY_TIMER_DRAFT);
       setActiveRunningEntry(null);
+      setTimerClockAnchor(null);
       setDiscardTimerModal({ isOpen: false, entry: null });
       toast.success(t.timesheet?.deleteSuccess || "Time entry deleted");
       await loadHistory();
@@ -2733,7 +2763,7 @@ export default function Timesheet() {
           </div>
 
           <div className="flex h-12 shrink-0 items-center px-5 text-lg font-semibold text-slate-900 dark:text-white">
-            {runningEntry ? formatDuration(runningEntry, ticker) : "00:00:00"}
+            {runningEntry ? formatDuration(runningEntry, runningTimerNowMs) : "00:00:00"}
           </div>
 
           <div className="ms-2 flex shrink-0 items-center gap-2">
@@ -2813,7 +2843,7 @@ export default function Timesheet() {
             />
 
             <div className="flex h-10 min-w-[110px] items-center justify-center rounded-md border border-slate-200 bg-slate-50 px-3 text-sm font-semibold text-slate-900 dark:border-slate-700 dark:bg-slate-900 dark:text-white">
-              {runningEntry ? formatDuration(runningEntry, ticker) : "00:00:00"}
+              {runningEntry ? formatDuration(runningEntry, runningTimerNowMs) : "00:00:00"}
             </div>
           </div>