feat: 턴 처리 및 데이터베이스 연동을 위한 새로운 클래스 및 인터페이스 추가

app/game-engine/src/turn/turnDaemon.ts

@@ -0,0 +1,119 @@
+import type { TurnSchedule } from '@sammo-ts/logic';
+
+import { SystemClock } from '../lifecycle/clock.js';
+import { getNextTickTime } from '../lifecycle/getNextTickTime.js';
+import { InMemoryControlQueue } from '../lifecycle/inMemoryControlQueue.js';
+import type {
+    Clock,
+    TurnDaemonControlQueue,
+    TurnDaemonHooks,
+    TurnRunBudget,
+} from '../lifecycle/types.js';
+import { TurnDaemonLifecycle } from '../lifecycle/turnDaemonLifecycle.js';
+import type { MapLoaderOptions } from '../scenario/mapLoader.js';
+import { createDatabaseTurnHooks } from './databaseHooks.js';
+import type {
+    GeneralTurnHandler,
+    InMemoryTurnWorldOptions,
+    TurnCalendarHandler,
+} from './inMemoryWorld.js';
+import { InMemoryTurnWorld } from './inMemoryWorld.js';
+import { InMemoryTurnProcessor } from './inMemoryTurnProcessor.js';
+import { InMemoryTurnStateStore } from './inMemoryStateStore.js';
+import { loadTurnWorldFromDatabase } from './worldLoader.js';
+
+export interface TurnDaemonRuntimeOptions {
+    profile: string;
+    databaseUrl: string;
+    defaultBudget?: TurnRunBudget;
+    clock?: Clock;
+    controlQueue?: TurnDaemonControlQueue;
+    schedule?: TurnSchedule;
+    tickMinutes?: number;
+    mapOptions?: MapLoaderOptions;
+    generalTurnHandler?: GeneralTurnHandler;
+    calendarHandler?: TurnCalendarHandler;
+    enableDatabaseFlush?: boolean;
+}
+
+export interface TurnDaemonRuntime {
+    lifecycle: TurnDaemonLifecycle;
+    world: InMemoryTurnWorld;
+    controlQueue: TurnDaemonControlQueue;
+    stateStore: InMemoryTurnStateStore;
+    processor: InMemoryTurnProcessor;
+    hooks?: TurnDaemonHooks;
+    close(): Promise<void>;
+}
+
+const resolveTickMinutes = (tickSeconds: number, override?: number): number => {
+    if (override !== undefined) {
+        return Math.max(1, override);
+    }
+    return Math.max(1, Math.round(tickSeconds / 60));
+};
+
+const buildFixedSchedule = (tickMinutes: number): TurnSchedule => ({
+    entries: [{ startMinute: 0, tickMinutes }],
+});
+
+export const createTurnDaemonRuntime = async (
+    options: TurnDaemonRuntimeOptions
+): Promise<TurnDaemonRuntime> => {
+    // DB에서 월드를 읽고 턴 데몬을 구동할 런타임을 만든다.
+    const { state, snapshot } = await loadTurnWorldFromDatabase({
+        databaseUrl: options.databaseUrl,
+        mapOptions: options.mapOptions,
+    });
+
+    const tickMinutes = resolveTickMinutes(state.tickSeconds, options.tickMinutes);
+    const schedule = options.schedule ?? buildFixedSchedule(tickMinutes);
+    const worldOptions: InMemoryTurnWorldOptions = {
+        schedule,
+        generalTurnHandler: options.generalTurnHandler,
+        calendarHandler: options.calendarHandler,
+    };
+    const world = new InMemoryTurnWorld(state, snapshot, worldOptions);
+
+    const stateStore = new InMemoryTurnStateStore(world);
+    const processor = new InMemoryTurnProcessor(world, { tickMinutes });
+    const controlQueue = options.controlQueue ?? new InMemoryControlQueue();
+    const clock = options.clock ?? new SystemClock();
+
+    let hooks: TurnDaemonHooks | undefined;
+    let close = async () => {};
+    if (options.enableDatabaseFlush ?? true) {
+        const dbHooks = await createDatabaseTurnHooks(options.databaseUrl, world);
+        hooks = dbHooks.hooks;
+        close = dbHooks.close;
+    }
+
+    const defaultBudget: TurnRunBudget = options.defaultBudget ?? {
+        budgetMs: 5000,
+        maxGenerals: 200,
+        catchUpCap: 1,
+    };
+
+    const lifecycle = new TurnDaemonLifecycle(
+        {
+            clock,
+            controlQueue,
+            getNextTickTime: (lastTurnTime) =>
+                getNextTickTime(lastTurnTime, tickMinutes),
+            stateStore,
+            processor,
+            hooks,
+        },
+        { profile: options.profile, defaultBudget }
+    );
+
+    return {
+        lifecycle,
+        world,
+        controlQueue,
+        stateStore,
+        processor,
+        hooks,
+        close,
+    };
+};