feat: add logical game clock

2026-08-04 02:51:27 +00:00
parent 87965a39d6
commit a26031dc3f
51 changed files with 1605 additions and 398 deletions
@@ -0,0 +1,48 @@
+import { GameClock, type GameClockMode } from '@sammo-ts/common';
+
+import type { DatabaseClient } from '../context.js';
+
+export interface CurrentGameTime {
+    now: Date;
+    tick: number | null;
+    mode: GameClockMode | null;
+    dateToTick(date: Date): number | null;
+}
+
+export const loadCurrentGameTime = async (db: DatabaseClient, wallNow = new Date()): Promise<CurrentGameTime> => {
+    if (!db.worldState) {
+        return { now: wallNow, tick: null, mode: null, dateToTick: () => null };
+    }
+    const state = await db.worldState.findFirst({
+        orderBy: { id: 'asc' },
+        select: {
+            clockBaseTime: true,
+            clockTick: true,
+            clockMode: true,
+            clockWallAnchor: true,
+            tickSeconds: true,
+        },
+    });
+    if (!state?.clockBaseTime || state.clockTick === null || !state.clockWallAnchor) {
+        return { now: wallNow, tick: null, mode: null, dateToTick: () => null };
+    }
+    const mode: GameClockMode = state.clockMode === 'manual' ? 'manual' : 'realtime';
+    const storedTick = Number(state.clockTick);
+    if (!Number.isSafeInteger(storedTick)) {
+        throw new Error(`world_state.clock_tick is outside the JavaScript safe integer range: ${state.clockTick}`);
+    }
+    const clock = new GameClock({
+        baseTime: state.clockBaseTime,
+        tick: storedTick,
+        mode,
+        wallAnchor: state.clockWallAnchor,
+        turnSeconds: state.tickSeconds,
+    });
+    const tick = clock.nowTick(wallNow);
+    return {
+        now: clock.tickToDate(tick),
+        tick,
+        mode,
+        dateToTick: (date) => clock.dateToTick(date),
+    };
+};