overtime-live-trading-utils 2.1.45 → 3.0.0-rc.1

package/src/tests/unit/resolution.test.ts

@@ -1,1489 +1,1489 @@
-import {
-    detectCompletedPeriods,
-    canResolveMarketsForEvent,
-    canResolveMultipleTypeIdsForEvent,
-    filterMarketsThatCanBeResolved,
-} from '../../utils/resolution';
-import { SportPeriodType } from '../../types/resolution';
-import {
-    MockSoccerCompletedEvent,
-    MockSoccerLiveSecondHalf,
-    MockSoccerLiveFirstHalf,
-    MockNFLCompletedEvent,
-    MockNFLLiveThirdQuarter,
-    MockMLBCompletedEvent,
-    MockMLBLiveSixthInning,
-    MockSoccerLiveFirstHalfInProgress,
-    MockNFLCompletedWithOvertime,
-    MockNBACompletedEvent,
-    MockNBALiveAtHalftime,
-} from '../mock/MockOpticOddsEvents';
-
-describe('Resolution Utils', () => {
-    describe('detectCompletedPeriods', () => {
-        it('Should detect completed periods for real completed soccer game (UEFA Europa League)', () => {
-            const result = detectCompletedPeriods(MockSoccerCompletedEvent);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 0.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 1.0, away: 0.0 });
-        });
-
-        it('Should detect completed first half in real live soccer game (2nd half)', () => {
-            const result = detectCompletedPeriods(MockSoccerLiveSecondHalf);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 1.0 });
-            expect(result?.currentPeriod).toBe(2);
-        });
-
-        it('Should return null for real live soccer game in first half (no completed periods)', () => {
-            const result = detectCompletedPeriods(MockSoccerLiveFirstHalf);
-
-            expect(result).toBeNull();
-        });
-
-        it('Should detect completed periods for real completed NFL game (Patriots vs Panthers)', () => {
-            const result = detectCompletedPeriods(MockNFLCompletedEvent);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 6.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 21.0, away: 0.0 });
-            expect(result?.periodScores['period3']).toEqual({ home: 7.0, away: 0.0 });
-            expect(result?.periodScores['period4']).toEqual({ home: 7.0, away: 7.0 });
-        });
-
-        it('Should detect completed quarters in real live NFL game (3rd quarter)', () => {
-            const result = detectCompletedPeriods(MockNFLLiveThirdQuarter);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
-            expect(result?.currentPeriod).toBe(3);
-        });
-
-        it('Should detect completed innings for real completed MLB game (Tigers vs Guardians)', () => {
-            const result = detectCompletedPeriods(MockMLBCompletedEvent);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 0.0 });
-            expect(result?.periodScores['period3']).toEqual({ home: 0.0, away: 1.0 });
-            expect(result?.periodScores['period7']).toEqual({ home: 0.0, away: 4.0 });
-            expect(result?.periodScores['period8']).toEqual({ home: 2.0, away: 0.0 });
-            expect(result?.periodScores['period9']).toEqual({ home: 0.0, away: 0.0 });
-        });
-
-        it('Should detect completed innings in real live MLB game (6th inning)', () => {
-            const result = detectCompletedPeriods(MockMLBLiveSixthInning);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 1.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 2.0, away: 0.0 });
-            expect(result?.periodScores['period3']).toEqual({ home: 1.0, away: 0.0 });
-            expect(result?.periodScores['period4']).toEqual({ home: 0.0, away: 0.0 });
-            expect(result?.periodScores['period5']).toEqual({ home: 1.0, away: 1.0 });
-            expect(result?.currentPeriod).toBe(6);
-        });
-
-        it('Should detect completed periods for real completed NBA game (Warriors vs Suns)', () => {
-            const result = detectCompletedPeriods(MockNBACompletedEvent);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 33.0, away: 19.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 35.0, away: 30.0 });
-            expect(result?.periodScores['period3']).toEqual({ home: 24.0, away: 34.0 });
-            expect(result?.periodScores['period4']).toEqual({ home: 26.0, away: 24.0 });
-        });
-
-        it('Should detect completed quarters at halftime for real NBA game (Warriors vs Suns)', () => {
-            const result = detectCompletedPeriods(MockNBALiveAtHalftime);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Both quarters complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 33.0, away: 19.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 35.0, away: 30.0 });
-            expect(result?.currentPeriod).toBe(2); // Highest period with data at halftime
-        });
-
-        it('Should return null for real live soccer game with non-numeric period indicator (1H)', () => {
-            const result = detectCompletedPeriods(MockSoccerLiveFirstHalfInProgress);
-
-            // Period 1 exists in data but period is "1H" (non-numeric) meaning first half is still in progress
-            // Period 1 is NOT complete until we see period_2 in the data or status becomes completed
-            expect(result).toBeNull();
-        });
-
-        it('Should detect completed periods for completed American Football game', () => {
-            const event = {
-                sport: {
-                    id: 'football',
-                    name: 'Football',
-                },
-                fixture: {
-                    id: '20250930BEED03AA',
-                    status: 'completed',
-                    is_live: false,
-                },
-                scores: {
-                    home: {
-                        total: 28.0,
-                        periods: {
-                            period_1: 7.0,
-                            period_2: 14.0,
-                            period_3: 0.0,
-                            period_4: 7.0,
-                        },
-                    },
-                    away: {
-                        total: 3.0,
-                        periods: {
-                            period_1: 3.0,
-                            period_2: 0.0,
-                            period_3: 0.0,
-                            period_4: 0.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '4',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 0.0 });
-            expect(result?.periodScores['period3']).toEqual({ home: 0.0, away: 0.0 });
-            expect(result?.periodScores['period4']).toEqual({ home: 7.0, away: 0.0 });
-        });
-
-        it('Should detect completed quarters in live American Football game', () => {
-            const event = {
-                sport: {
-                    name: 'Football',
-                },
-                fixture: {
-                    id: 'nfl-live-123',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 21.0,
-                        periods: {
-                            period_1: 7.0,
-                            period_2: 14.0,
-                            period_3: 0.0,
-                        },
-                    },
-                    away: {
-                        total: 10.0,
-                        periods: {
-                            period_1: 3.0,
-                            period_2: 7.0,
-                            period_3: 0.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '3',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
-            expect(result?.currentPeriod).toBe(3);
-        });
-
-        it('Should detect all quarters complete in American Football overtime', () => {
-            const event = {
-                sport: {
-                    name: 'American Football',
-                },
-                fixture: {
-                    id: 'nfl-ot-456',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 24.0,
-                        periods: {
-                            period_1: 7.0,
-                            period_2: 7.0,
-                            period_3: 3.0,
-                            period_4: 7.0,
-                        },
-                    },
-                    away: {
-                        total: 24.0,
-                        periods: {
-                            period_1: 10.0,
-                            period_2: 7.0,
-                            period_3: 0.0,
-                            period_4: 7.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'overtime',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Should detect completed first half in live soccer game', () => {
-            const event = {
-                sport: {
-                    name: 'Soccer',
-                },
-                fixture: {
-                    id: 'soccer-123',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 2.0,
-                        periods: {
-                            period_1: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 0.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '2',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 0.0 });
-        });
-
-        it('Should detect completed quarters in live basketball game', () => {
-            const event = {
-                sport: {
-                    name: 'Basketball',
-                },
-                fixture: {
-                    id: 'nba-789',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 65.0,
-                        periods: {
-                            period_1: 25.0,
-                            period_2: 20.0,
-                        },
-                    },
-                    away: {
-                        total: 62.0,
-                        periods: {
-                            period_1: 22.0,
-                            period_2: 18.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '3',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 25.0, away: 22.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 20.0, away: 18.0 });
-        });
-
-        it('Should detect completed sets in live tennis match', () => {
-            const event = {
-                sport: {
-                    name: 'Tennis',
-                },
-                fixture: {
-                    id: 'tennis-101',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 6.0,
-                            period_2: 3.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 4.0,
-                            period_2: 6.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '3',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 6.0, away: 4.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 3.0, away: 6.0 });
-        });
-
-        it('Should detect completed periods in live hockey game', () => {
-            const event = {
-                sport: {
-                    name: 'Ice Hockey',
-                },
-                fixture: {
-                    id: 'nhl-202',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 2.0,
-                        periods: {
-                            period_1: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 1.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '2',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1]);
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 1.0 });
-        });
-
-        it('Should detect all periods complete in hockey overtime', () => {
-            const event = {
-                sport: {
-                    name: 'Hockey',
-                },
-                fixture: {
-                    id: 'nhl-303',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 3.0,
-                        periods: {
-                            period_1: 1.0,
-                            period_2: 1.0,
-                            period_3: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 3.0,
-                        periods: {
-                            period_1: 0.0,
-                            period_2: 2.0,
-                            period_3: 1.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'overtime',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3]);
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Should detect completed innings in live baseball game', () => {
-            const event = {
-                sport: {
-                    name: 'Baseball',
-                },
-                fixture: {
-                    id: 'mlb-404',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 4.0,
-                        periods: {
-                            period_1: 1.0,
-                            period_2: 0.0,
-                            period_3: 2.0,
-                            period_4: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 3.0,
-                        periods: {
-                            period_1: 0.0,
-                            period_2: 1.0,
-                            period_3: 1.0,
-                            period_4: 1.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '5',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Should detect completed sets in live volleyball match', () => {
-            const event = {
-                sport: {
-                    name: 'Volleyball',
-                },
-                fixture: {
-                    id: 'volleyball-505',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 25.0,
-                            period_2: 22.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 23.0,
-                            period_2: 25.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '3',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]);
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Should return null for game not started', () => {
-            const event = {
-                sport: {
-                    name: 'Soccer',
-                },
-                fixture: {
-                    id: 'future-game',
-                    status: 'scheduled',
-                    is_live: false,
-                },
-                scores: {
-                    home: {
-                        total: 0.0,
-                        periods: {},
-                    },
-                    away: {
-                        total: 0.0,
-                        periods: {},
-                    },
-                },
-                in_play: {
-                    period: null,
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).toBeNull();
-        });
-
-        it('Should return null for game in first period with no completed periods', () => {
-            const event = {
-                sport: {
-                    name: 'Basketball',
-                },
-                fixture: {
-                    id: 'early-game',
-                    status: 'live',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 12.0,
-                        periods: {},
-                    },
-                    away: {
-                        total: 10.0,
-                        periods: {},
-                    },
-                },
-                in_play: {
-                    period: '1',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).toBeNull();
-        });
-
-        it('Bug Fix: Should NOT mark current period as complete when future periods have data (live in period 3)', () => {
-            // This tests the bug where OpticOdds API includes future period data with scores (including zeros)
-            // Period 3 is currently being played, period 4 has 0-0 scores but hasn't started
-            const event = {
-                status: 'live',
-                is_live: true,
-                in_play: { period: '3' },
-                scores: {
-                    home: { periods: { period_1: 33, period_2: 32, period_3: 12, period_4: 0 } },
-                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 0 } },
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Only periods 1 and 2 are complete
-            expect(result?.currentPeriod).toBe(3);
-            // Period 3 is currently being played, so NOT complete
-            // Period 4 has data (0-0) but hasn't started, so NOT complete
-        });
-
-        it('Bug Fix: Should mark all periods as complete for completed game', () => {
-            const event = {
-                status: 'completed',
-                is_live: false,
-                scores: {
-                    home: { periods: { period_1: 33, period_2: 32, period_3: 25, period_4: 20 } },
-                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 22 } },
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
-            // All periods complete because game status is 'completed'
-        });
-
-        it('Bug Fix: Should NOT mark current period as complete during transition to period 4', () => {
-            const event = {
-                status: 'live',
-                is_live: true,
-                in_play: { period: '4' },
-                scores: {
-                    home: { periods: { period_1: 33, period_2: 32, period_3: 25, period_4: 5 } },
-                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 3 } },
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3]); // Periods 1, 2, 3 are complete
-            expect(result?.currentPeriod).toBe(4);
-            // Period 4 is currently in_play, so NOT complete yet
-        });
-
-        it('Basketball at halftime should mark periods 1 AND 2 as complete (quarters-based)', () => {
-            const event = {
-                sport: {
-                    id: 'basketball',
-                    name: 'Basketball',
-                },
-                fixture: {
-                    id: 'nba-halftime-123',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 52.0,
-                        periods: {
-                            period_1: 25.0,
-                            period_2: 27.0,
-                        },
-                    },
-                    away: {
-                        total: 48.0,
-                        periods: {
-                            period_1: 22.0,
-                            period_2: 26.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 25.0, away: 22.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 27.0, away: 26.0 });
-        });
-
-        it('Basketball at halftime with status "halftime" should mark periods 1 AND 2 as complete', () => {
-            const event = {
-                sport: {
-                    id: 'basketball',
-                    name: 'Basketball',
-                },
-                fixture: {
-                    id: 'nba-halftime-456',
-                    status: 'halftime',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 55.0,
-                        periods: {
-                            period_1: 28.0,
-                            period_2: 27.0,
-                        },
-                    },
-                    away: {
-                        total: 50.0,
-                        periods: {
-                            period_1: 24.0,
-                            period_2: 26.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '2',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Football at halftime should mark periods 1 AND 2 as complete (quarters-based)', () => {
-            const event = {
-                sport: {
-                    id: 'football',
-                    name: 'Football',
-                },
-                fixture: {
-                    id: 'nfl-halftime-789',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 21.0,
-                        periods: {
-                            period_1: 7.0,
-                            period_2: 14.0,
-                        },
-                    },
-                    away: {
-                        total: 10.0,
-                        periods: {
-                            period_1: 3.0,
-                            period_2: 7.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
-            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
-        });
-
-        it('Football at halftime with status "halftime" should mark periods 1 AND 2 as complete', () => {
-            const event = {
-                sport: {
-                    id: 'football',
-                    name: 'American Football',
-                },
-                fixture: {
-                    id: 'nfl-halftime-890',
-                    status: 'halftime',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 17.0,
-                        periods: {
-                            period_1: 10.0,
-                            period_2: 7.0,
-                        },
-                    },
-                    away: {
-                        total: 14.0,
-                        periods: {
-                            period_1: 7.0,
-                            period_2: 7.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: '2',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-        });
-
-        it('Baseball at halftime should mark periods 1-5 as complete (innings-based)', () => {
-            const event = {
-                sport: {
-                    id: 'baseball',
-                    name: 'Baseball',
-                },
-                fixture: {
-                    id: 'mlb-halftime-789',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 3.0,
-                        periods: {
-                            period_1: 0.0,
-                            period_2: 1.0,
-                            period_3: 1.0,
-                            period_4: 0.0,
-                            period_5: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 2.0,
-                        periods: {
-                            period_1: 1.0,
-                            period_2: 0.0,
-                            period_3: 0.0,
-                            period_4: 1.0,
-                            period_5: 0.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]); // First 5 innings complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 1.0 });
-            expect(result?.periodScores['period5']).toEqual({ home: 1.0, away: 0.0 });
-        });
-
-        it('Soccer at halftime should mark only period 1 as complete (halves-based)', () => {
-            const event = {
-                sport: {
-                    id: 'soccer',
-                    name: 'Soccer',
-                },
-                fixture: {
-                    id: 'soccer-halftime-101',
-                    status: 'halftime',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 2.0,
-                        periods: {
-                            period_1: 2.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 1.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            expect(result).not.toBeNull();
-            expect(result?.completedPeriods).toEqual([1]); // Only first half complete at halftime
-            expect(result?.readyForResolution).toBe(true);
-            expect(result?.periodScores['period1']).toEqual({ home: 2.0, away: 1.0 });
-        });
-
-        it('Hockey at halftime should NOT mark any periods as complete (period-based, no halftime concept)', () => {
-            const event = {
-                sport: {
-                    id: 'hockey',
-                    name: 'Hockey',
-                },
-                fixture: {
-                    id: 'nhl-halftime-202',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 2.0,
-                        periods: {
-                            period_1: 1.0,
-                            period_2: 1.0,
-                        },
-                    },
-                    away: {
-                        total: 1.0,
-                        periods: {
-                            period_1: 0.0,
-                            period_2: 1.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            // Hockey doesn't have traditional halftime, so halftime status shouldn't mark periods complete
-            // Periods should only be marked complete based on in_play.period progression
-            expect(result).toBeNull();
-        });
-
-        it('Unknown sport at halftime should default to PERIOD_BASED (no halftime processing)', () => {
-            const event = {
-                sport: {
-                    id: 'unknown_sport',
-                    name: 'Unknown Sport',
-                },
-                fixture: {
-                    id: 'unknown-halftime-123',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 50.0,
-                        periods: {
-                            period_1: 25.0,
-                            period_2: 25.0,
-                        },
-                    },
-                    away: {
-                        total: 40.0,
-                        periods: {
-                            period_1: 20.0,
-                            period_2: 20.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            // Unknown sports default to PERIOD_BASED (no halftime processing)
-            // So halftime status should NOT mark any periods as complete
-            expect(result).toBeNull();
-        });
-
-        it('Event with missing sport.id should default to PERIOD_BASED (no halftime processing)', () => {
-            const event = {
-                sport: {
-                    name: 'Some Sport',
-                },
-                fixture: {
-                    id: 'no-sport-id-123',
-                    status: 'half',
-                    is_live: true,
-                },
-                scores: {
-                    home: {
-                        total: 50.0,
-                        periods: {
-                            period_1: 25.0,
-                            period_2: 25.0,
-                        },
-                    },
-                    away: {
-                        total: 40.0,
-                        periods: {
-                            period_1: 20.0,
-                            period_2: 20.0,
-                        },
-                    },
-                },
-                in_play: {
-                    period: 'half',
-                },
-            };
-
-            const result = detectCompletedPeriods(event);
-
-            // Missing sport.id defaults to PERIOD_BASED (no halftime processing)
-            expect(result).toBeNull();
-        });
-    });
-
-    describe('canResolveMarketsForEvent', () => {
-        describe('Single typeId checks', () => {
-            it('Should return true for 1st period typeId when period 1 is complete (Soccer 2nd half)', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10021, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('Should return false for 2nd period typeId when only period 1 is complete', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10022, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(false);
-            });
-
-            it('Should return false for full game typeId during live game', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10001, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(false);
-            });
-
-            it('Should return true for full game typeId when game is completed', () => {
-                const result = canResolveMarketsForEvent(MockSoccerCompletedEvent, 10001, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('Should return true for 1st quarter typeId when quarter 1 complete (NFL)', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    10021,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(true);
-            });
-
-            it('Should return true for 2nd quarter typeId when quarters 1-2 complete (NFL)', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    10022,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(true);
-            });
-
-            it('Should return false for 3rd quarter typeId during 3rd quarter (NFL)', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    10023,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(false);
-            });
-
-            it('Should return true for all quarter typeIds when game is completed (NFL)', () => {
-                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10021, SportPeriodType.QUARTERS_BASED)).toBe(
-                    true
-                );
-                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10022, SportPeriodType.QUARTERS_BASED)).toBe(
-                    true
-                );
-                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10023, SportPeriodType.QUARTERS_BASED)).toBe(
-                    true
-                );
-                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10024, SportPeriodType.QUARTERS_BASED)).toBe(
-                    true
-                );
-            });
-
-            it('Should return false when no periods are complete', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveFirstHalf, 10021, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(false);
-            });
-
-            it('Should return false for non-existent typeId', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 99999, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(false);
-            });
-        });
-
-        describe('Batch typeIds checks', () => {
-            it('Should return only resolvable typeIds for live soccer in 2nd half', () => {
-                const typeIds = [10021, 10022, 10031, 10001];
-                const result = filterMarketsThatCanBeResolved(
-                    MockSoccerLiveSecondHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([10021, 10031]); // Only period 1 typeIds
-            });
-
-            it('Should exclude full game typeIds during live game', () => {
-                const typeIds = [10021, 10001, 10002, 10003];
-                const result = filterMarketsThatCanBeResolved(
-                    MockNFLLiveThirdQuarter,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                expect(result).toEqual([10021]); // Full game typeIds excluded
-            });
-
-            it('Should include full game typeIds when game is completed', () => {
-                const typeIds = [10021, 10022, 10001, 10002];
-                const result = filterMarketsThatCanBeResolved(
-                    MockSoccerCompletedEvent,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([10021, 10022, 10001, 10002]);
-            });
-
-            it('Should return empty array when no typeIds are resolvable', () => {
-                const typeIds = [10022, 10023, 10024];
-                const result = filterMarketsThatCanBeResolved(
-                    MockSoccerLiveSecondHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([]);
-            });
-
-            it('Should return multiple period typeIds for NFL game in 3rd quarter', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10031, 10032, 10051];
-                const result = filterMarketsThatCanBeResolved(
-                    MockNFLLiveThirdQuarter,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                // Periods 1 and 2 are complete (period 2 also completes 1st half = 10051)
-                expect(result).toEqual([10021, 10022, 10031, 10032, 10051]);
-            });
-
-            it('Should handle all 9 periods for completed MLB game', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10025, 10026, 10027, 10028, 10029];
-                const result = filterMarketsThatCanBeResolved(
-                    MockMLBCompletedEvent,
-                    typeIds,
-                    SportPeriodType.INNINGS_BASED
-                );
-
-                expect(result).toEqual(typeIds); // All 9 innings complete
-            });
-
-            it('Should return empty array when no periods complete', () => {
-                const typeIds = [10021, 10022, 10031];
-                const result = filterMarketsThatCanBeResolved(
-                    MockSoccerLiveFirstHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([]);
-            });
-        });
-
-        describe('Multiple typeIds boolean array checks', () => {
-            it('Should return boolean array for live soccer in 2nd half', () => {
-                const typeIds = [10021, 10022, 10031, 10001];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockSoccerLiveSecondHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([true, false, true, false]); // Period 1 typeIds are true, period 2 and full game are false
-            });
-
-            it('Should return false for full game typeIds during live game', () => {
-                const typeIds = [10021, 10001, 10002, 10003];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                expect(result).toEqual([true, false, false, false]); // Only period 1 is true
-            });
-
-            it('Should return all true for completed game', () => {
-                const typeIds = [10021, 10022, 10001, 10002];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockSoccerCompletedEvent,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([true, true, true, true]); // All complete
-            });
-
-            it('Should return all false when no typeIds are resolvable', () => {
-                const typeIds = [10022, 10023, 10024];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockSoccerLiveSecondHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([false, false, false]);
-            });
-
-            it('Should return mixed booleans for NFL game in 3rd quarter', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10031, 10032, 10051];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                // Periods 1 and 2 are complete (period 2 also completes 1st half = 10051)
-                expect(result).toEqual([true, true, false, false, true, true, true]);
-            });
-
-            it('Should handle all 9 periods for completed MLB game', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10025, 10026, 10027, 10028, 10029];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockMLBCompletedEvent,
-                    typeIds,
-                    SportPeriodType.INNINGS_BASED
-                );
-
-                expect(result).toEqual([true, true, true, true, true, true, true, true, true]); // All 9 innings complete
-            });
-
-            it('Should return all false when no periods complete', () => {
-                const typeIds = [10021, 10022, 10031];
-                const result = canResolveMultipleTypeIdsForEvent(
-                    MockSoccerLiveFirstHalf,
-                    typeIds,
-                    SportPeriodType.HALVES_BASED
-                );
-
-                expect(result).toEqual([false, false, false]);
-            });
-
-            it('Should work with numeric sport type parameter', () => {
-                const typeIds = [10021, 10022];
-                const result = canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, 0); // 0 = HALVES_BASED
-
-                expect(result).toEqual([true, false]);
-            });
-        });
-
-        describe('Edge cases', () => {
-            it('Should handle event with no completed periods', () => {
-                const result = canResolveMarketsForEvent(
-                    MockSoccerLiveFirstHalfInProgress,
-                    10021,
-                    SportPeriodType.HALVES_BASED
-                );
-                expect(result).toBe(false);
-            });
-
-            it('Should respect full game typeIds list', () => {
-                // Test all full game typeIds
-                const fullGameTypeIds = [0, 10001, 10002, 10003, 10004, 10010, 10011, 10012];
-
-                fullGameTypeIds.forEach((typeId) => {
-                    const result = canResolveMarketsForEvent(
-                        MockNFLLiveThirdQuarter,
-                        typeId,
-                        SportPeriodType.QUARTERS_BASED
-                    );
-                    expect(result).toBe(false);
-                });
-            });
-
-            it('Should work with sport type parameter for single typeId', () => {
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10021, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('Should work with sport type parameter for batch typeIds', () => {
-                const result = filterMarketsThatCanBeResolved(
-                    MockSoccerLiveSecondHalf,
-                    [10021, 10022],
-                    SportPeriodType.HALVES_BASED
-                );
-                expect(result).toEqual([10021]);
-            });
-        });
-
-        describe('Real overtime NFL game (Rams vs 49ers)', () => {
-            it('Should detect all 5 periods complete including overtime', () => {
-                const result = detectCompletedPeriods(MockNFLCompletedWithOvertime);
-
-                expect(result).not.toBeNull();
-                expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]);
-                expect(result?.readyForResolution).toBe(true);
-                expect(result?.periodScores['period5']).toEqual({ home: 0.0, away: 3.0 });
-            });
-
-            it('Should resolve all quarter typeIds (10021-10024) for completed overtime game', () => {
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10021, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10022, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10023, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10024, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-            });
-
-            it('Should NOT resolve overtime period typeId (10025) - overtime has no specific markets', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLCompletedWithOvertime,
-                    10025,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(false);
-            });
-
-            it('Should resolve full game typeIds for completed overtime game', () => {
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10001, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-                expect(
-                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10002, SportPeriodType.QUARTERS_BASED)
-                ).toBe(true);
-            });
-
-            it('Should return all resolvable typeIds excluding overtime in batch check', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10025, 10001];
-                const result = filterMarketsThatCanBeResolved(
-                    MockNFLCompletedWithOvertime,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                // 10025 (overtime) should not be included as period 5 has no specific markets
-                expect(result).toEqual([10021, 10022, 10023, 10024, 10001]);
-            });
-
-            it('Should return false for 8th period typeId (period did not occur)', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLCompletedWithOvertime,
-                    10028,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(false);
-            });
-
-            it('Should return false for 9th period typeId (period did not occur)', () => {
-                const result = canResolveMarketsForEvent(
-                    MockNFLCompletedWithOvertime,
-                    10029,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(false);
-            });
-
-            it('Should not include non-existent periods in batch check', () => {
-                const typeIds = [10021, 10022, 10023, 10024, 10025, 10028, 10029];
-                const result = filterMarketsThatCanBeResolved(
-                    MockNFLCompletedWithOvertime,
-                    typeIds,
-                    SportPeriodType.QUARTERS_BASED
-                );
-
-                // Periods 1-4 are resolvable; period 5 (overtime) has no markets; periods 8-9 did not occur
-                expect(result).toEqual([10021, 10022, 10023, 10024]);
-            });
-        });
-
-        describe('Sport-type-specific resolution for typeId 10051 (1st half)', () => {
-            it('Soccer (HALVES_BASED): Should resolve typeId 10051 after period 1', () => {
-                // Soccer: Period 1 = 1st half
-                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10051, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('NFL (QUARTERS_BASED): Should resolve typeId 10051 after period 2', () => {
-                // NFL: Period 2 completes 1st half (quarters 1+2)
-                const result = canResolveMarketsForEvent(
-                    MockNFLLiveThirdQuarter,
-                    10051,
-                    SportPeriodType.QUARTERS_BASED
-                );
-                expect(result).toBe(true);
-            });
-
-            it('NFL (QUARTERS_BASED): Should NOT resolve typeId 10051 after only period 1', () => {
-                // Create mock with only period 1 complete
-                const mockNFLFirstQuarter = {
-                    ...MockNFLLiveThirdQuarter,
-                    scores: {
-                        home: { total: 7.0, periods: { period_1: 7.0 } },
-                        away: { total: 3.0, periods: { period_1: 3.0 } },
-                    },
-                    in_play: { period: '2', clock: '5:00' },
-                };
-
-                const result = canResolveMarketsForEvent(mockNFLFirstQuarter, 10051, SportPeriodType.QUARTERS_BASED);
-                expect(result).toBe(false);
-            });
-
-            it('MLB (INNINGS_BASED): Should resolve typeId 10051 after period 5', () => {
-                // MLB: Period 5 completes 1st half (innings 1-5)
-                const result = canResolveMarketsForEvent(MockMLBLiveSixthInning, 10051, SportPeriodType.INNINGS_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('MLB (INNINGS_BASED): Should NOT resolve typeId 10051 after only period 4', () => {
-                // Create mock with only period 1-4 complete
-                const mockMLBFourthInning = {
-                    ...MockMLBLiveSixthInning,
-                    scores: {
-                        home: {
-                            total: 3.0,
-                            periods: {
-                                period_1: 0.0,
-                                period_2: 2.0,
-                                period_3: 1.0,
-                                period_4: 0.0,
-                            },
-                        },
-                        away: {
-                            total: 1.0,
-                            periods: {
-                                period_1: 1.0,
-                                period_2: 0.0,
-                                period_3: 0.0,
-                                period_4: 0.0,
-                            },
-                        },
-                    },
-                    in_play: { period: '5', clock: null },
-                };
-
-                const result = canResolveMarketsForEvent(mockMLBFourthInning, 10051, SportPeriodType.INNINGS_BASED);
-                expect(result).toBe(false);
-            });
-        });
-
-        describe('Sport-type-specific resolution for typeId 10052 (2nd half)', () => {
-            it('Soccer (HALVES_BASED): Should resolve typeId 10052 after period 2', () => {
-                const result = canResolveMarketsForEvent(MockSoccerCompletedEvent, 10052, SportPeriodType.HALVES_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('NFL (QUARTERS_BASED): Should resolve typeId 10052 after period 4', () => {
-                const result = canResolveMarketsForEvent(MockNFLCompletedEvent, 10052, SportPeriodType.QUARTERS_BASED);
-                expect(result).toBe(true);
-            });
-
-            it('MLB (INNINGS_BASED): Should resolve typeId 10052 after period 9', () => {
-                const result = canResolveMarketsForEvent(MockMLBCompletedEvent, 10052, SportPeriodType.INNINGS_BASED);
-                expect(result).toBe(true);
-            });
-        });
-
-        describe('Error handling for invalid sport type numbers', () => {
-            it('Should throw error for invalid sport type number when using numeric parameter', () => {
-                const typeIds = [10021, 10022];
-
-                // Invalid sport type number (must be 0-3)
-                expect(() => {
-                    canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, 99);
-                }).toThrow('Invalid sport type number: 99. Must be 0 (halves), 1 (quarters), 2 (innings), or 3 (period).');
-            });
-
-            it('Should throw error for negative sport type number', () => {
-                const typeIds = [10021];
-
-                expect(() => {
-                    canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, -1);
-                }).toThrow('Invalid sport type number: -1. Must be 0 (halves), 1 (quarters), 2 (innings), or 3 (period).');
-            });
-        });
-    });
-});
+import {
+    detectCompletedPeriods,
+    canResolveMarketsForEvent,
+    canResolveMultipleTypeIdsForEvent,
+    filterMarketsThatCanBeResolved,
+} from '../../utils/resolution';
+import { SportPeriodType } from '../../types/resolution';
+import {
+    MockSoccerCompletedEvent,
+    MockSoccerLiveSecondHalf,
+    MockSoccerLiveFirstHalf,
+    MockNFLCompletedEvent,
+    MockNFLLiveThirdQuarter,
+    MockMLBCompletedEvent,
+    MockMLBLiveSixthInning,
+    MockSoccerLiveFirstHalfInProgress,
+    MockNFLCompletedWithOvertime,
+    MockNBACompletedEvent,
+    MockNBALiveAtHalftime,
+} from '../mock/MockOpticOddsEvents';
+
+describe('Resolution Utils', () => {
+    describe('detectCompletedPeriods', () => {
+        it('Should detect completed periods for real completed soccer game (UEFA Europa League)', () => {
+            const result = detectCompletedPeriods(MockSoccerCompletedEvent);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 0.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 1.0, away: 0.0 });
+        });
+
+        it('Should detect completed first half in real live soccer game (2nd half)', () => {
+            const result = detectCompletedPeriods(MockSoccerLiveSecondHalf);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 1.0 });
+            expect(result?.currentPeriod).toBe(2);
+        });
+
+        it('Should return null for real live soccer game in first half (no completed periods)', () => {
+            const result = detectCompletedPeriods(MockSoccerLiveFirstHalf);
+
+            expect(result).toBeNull();
+        });
+
+        it('Should detect completed periods for real completed NFL game (Patriots vs Panthers)', () => {
+            const result = detectCompletedPeriods(MockNFLCompletedEvent);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 6.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 21.0, away: 0.0 });
+            expect(result?.periodScores['period3']).toEqual({ home: 7.0, away: 0.0 });
+            expect(result?.periodScores['period4']).toEqual({ home: 7.0, away: 7.0 });
+        });
+
+        it('Should detect completed quarters in real live NFL game (3rd quarter)', () => {
+            const result = detectCompletedPeriods(MockNFLLiveThirdQuarter);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
+            expect(result?.currentPeriod).toBe(3);
+        });
+
+        it('Should detect completed innings for real completed MLB game (Tigers vs Guardians)', () => {
+            const result = detectCompletedPeriods(MockMLBCompletedEvent);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 0.0 });
+            expect(result?.periodScores['period3']).toEqual({ home: 0.0, away: 1.0 });
+            expect(result?.periodScores['period7']).toEqual({ home: 0.0, away: 4.0 });
+            expect(result?.periodScores['period8']).toEqual({ home: 2.0, away: 0.0 });
+            expect(result?.periodScores['period9']).toEqual({ home: 0.0, away: 0.0 });
+        });
+
+        it('Should detect completed innings in real live MLB game (6th inning)', () => {
+            const result = detectCompletedPeriods(MockMLBLiveSixthInning);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 1.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 2.0, away: 0.0 });
+            expect(result?.periodScores['period3']).toEqual({ home: 1.0, away: 0.0 });
+            expect(result?.periodScores['period4']).toEqual({ home: 0.0, away: 0.0 });
+            expect(result?.periodScores['period5']).toEqual({ home: 1.0, away: 1.0 });
+            expect(result?.currentPeriod).toBe(6);
+        });
+
+        it('Should detect completed periods for real completed NBA game (Warriors vs Suns)', () => {
+            const result = detectCompletedPeriods(MockNBACompletedEvent);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 33.0, away: 19.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 35.0, away: 30.0 });
+            expect(result?.periodScores['period3']).toEqual({ home: 24.0, away: 34.0 });
+            expect(result?.periodScores['period4']).toEqual({ home: 26.0, away: 24.0 });
+        });
+
+        it('Should detect completed quarters at halftime for real NBA game (Warriors vs Suns)', () => {
+            const result = detectCompletedPeriods(MockNBALiveAtHalftime);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Both quarters complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 33.0, away: 19.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 35.0, away: 30.0 });
+            expect(result?.currentPeriod).toBe(2); // Highest period with data at halftime
+        });
+
+        it('Should return null for real live soccer game with non-numeric period indicator (1H)', () => {
+            const result = detectCompletedPeriods(MockSoccerLiveFirstHalfInProgress);
+
+            // Period 1 exists in data but period is "1H" (non-numeric) meaning first half is still in progress
+            // Period 1 is NOT complete until we see period_2 in the data or status becomes completed
+            expect(result).toBeNull();
+        });
+
+        it('Should detect completed periods for completed American Football game', () => {
+            const event = {
+                sport: {
+                    id: 'football',
+                    name: 'Football',
+                },
+                fixture: {
+                    id: '20250930BEED03AA',
+                    status: 'completed',
+                    is_live: false,
+                },
+                scores: {
+                    home: {
+                        total: 28.0,
+                        periods: {
+                            period_1: 7.0,
+                            period_2: 14.0,
+                            period_3: 0.0,
+                            period_4: 7.0,
+                        },
+                    },
+                    away: {
+                        total: 3.0,
+                        periods: {
+                            period_1: 3.0,
+                            period_2: 0.0,
+                            period_3: 0.0,
+                            period_4: 0.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '4',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 0.0 });
+            expect(result?.periodScores['period3']).toEqual({ home: 0.0, away: 0.0 });
+            expect(result?.periodScores['period4']).toEqual({ home: 7.0, away: 0.0 });
+        });
+
+        it('Should detect completed quarters in live American Football game', () => {
+            const event = {
+                sport: {
+                    name: 'Football',
+                },
+                fixture: {
+                    id: 'nfl-live-123',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 21.0,
+                        periods: {
+                            period_1: 7.0,
+                            period_2: 14.0,
+                            period_3: 0.0,
+                        },
+                    },
+                    away: {
+                        total: 10.0,
+                        periods: {
+                            period_1: 3.0,
+                            period_2: 7.0,
+                            period_3: 0.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '3',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
+            expect(result?.currentPeriod).toBe(3);
+        });
+
+        it('Should detect all quarters complete in American Football overtime', () => {
+            const event = {
+                sport: {
+                    name: 'American Football',
+                },
+                fixture: {
+                    id: 'nfl-ot-456',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 24.0,
+                        periods: {
+                            period_1: 7.0,
+                            period_2: 7.0,
+                            period_3: 3.0,
+                            period_4: 7.0,
+                        },
+                    },
+                    away: {
+                        total: 24.0,
+                        periods: {
+                            period_1: 10.0,
+                            period_2: 7.0,
+                            period_3: 0.0,
+                            period_4: 7.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'overtime',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Should detect completed first half in live soccer game', () => {
+            const event = {
+                sport: {
+                    name: 'Soccer',
+                },
+                fixture: {
+                    id: 'soccer-123',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 2.0,
+                        periods: {
+                            period_1: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 0.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '2',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 0.0 });
+        });
+
+        it('Should detect completed quarters in live basketball game', () => {
+            const event = {
+                sport: {
+                    name: 'Basketball',
+                },
+                fixture: {
+                    id: 'nba-789',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 65.0,
+                        periods: {
+                            period_1: 25.0,
+                            period_2: 20.0,
+                        },
+                    },
+                    away: {
+                        total: 62.0,
+                        periods: {
+                            period_1: 22.0,
+                            period_2: 18.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '3',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 25.0, away: 22.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 20.0, away: 18.0 });
+        });
+
+        it('Should detect completed sets in live tennis match', () => {
+            const event = {
+                sport: {
+                    name: 'Tennis',
+                },
+                fixture: {
+                    id: 'tennis-101',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 6.0,
+                            period_2: 3.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 4.0,
+                            period_2: 6.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '3',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 6.0, away: 4.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 3.0, away: 6.0 });
+        });
+
+        it('Should detect completed periods in live hockey game', () => {
+            const event = {
+                sport: {
+                    name: 'Ice Hockey',
+                },
+                fixture: {
+                    id: 'nhl-202',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 2.0,
+                        periods: {
+                            period_1: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 1.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '2',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1]);
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 1.0, away: 1.0 });
+        });
+
+        it('Should detect all periods complete in hockey overtime', () => {
+            const event = {
+                sport: {
+                    name: 'Hockey',
+                },
+                fixture: {
+                    id: 'nhl-303',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 3.0,
+                        periods: {
+                            period_1: 1.0,
+                            period_2: 1.0,
+                            period_3: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 3.0,
+                        periods: {
+                            period_1: 0.0,
+                            period_2: 2.0,
+                            period_3: 1.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'overtime',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3]);
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Should detect completed innings in live baseball game', () => {
+            const event = {
+                sport: {
+                    name: 'Baseball',
+                },
+                fixture: {
+                    id: 'mlb-404',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 4.0,
+                        periods: {
+                            period_1: 1.0,
+                            period_2: 0.0,
+                            period_3: 2.0,
+                            period_4: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 3.0,
+                        periods: {
+                            period_1: 0.0,
+                            period_2: 1.0,
+                            period_3: 1.0,
+                            period_4: 1.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '5',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Should detect completed sets in live volleyball match', () => {
+            const event = {
+                sport: {
+                    name: 'Volleyball',
+                },
+                fixture: {
+                    id: 'volleyball-505',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 25.0,
+                            period_2: 22.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 23.0,
+                            period_2: 25.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '3',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]);
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Should return null for game not started', () => {
+            const event = {
+                sport: {
+                    name: 'Soccer',
+                },
+                fixture: {
+                    id: 'future-game',
+                    status: 'scheduled',
+                    is_live: false,
+                },
+                scores: {
+                    home: {
+                        total: 0.0,
+                        periods: {},
+                    },
+                    away: {
+                        total: 0.0,
+                        periods: {},
+                    },
+                },
+                in_play: {
+                    period: null,
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).toBeNull();
+        });
+
+        it('Should return null for game in first period with no completed periods', () => {
+            const event = {
+                sport: {
+                    name: 'Basketball',
+                },
+                fixture: {
+                    id: 'early-game',
+                    status: 'live',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 12.0,
+                        periods: {},
+                    },
+                    away: {
+                        total: 10.0,
+                        periods: {},
+                    },
+                },
+                in_play: {
+                    period: '1',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).toBeNull();
+        });
+
+        it('Bug Fix: Should NOT mark current period as complete when future periods have data (live in period 3)', () => {
+            // This tests the bug where OpticOdds API includes future period data with scores (including zeros)
+            // Period 3 is currently being played, period 4 has 0-0 scores but hasn't started
+            const event = {
+                status: 'live',
+                is_live: true,
+                in_play: { period: '3' },
+                scores: {
+                    home: { periods: { period_1: 33, period_2: 32, period_3: 12, period_4: 0 } },
+                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 0 } },
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Only periods 1 and 2 are complete
+            expect(result?.currentPeriod).toBe(3);
+            // Period 3 is currently being played, so NOT complete
+            // Period 4 has data (0-0) but hasn't started, so NOT complete
+        });
+
+        it('Bug Fix: Should mark all periods as complete for completed game', () => {
+            const event = {
+                status: 'completed',
+                is_live: false,
+                scores: {
+                    home: { periods: { period_1: 33, period_2: 32, period_3: 25, period_4: 20 } },
+                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 22 } },
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4]);
+            // All periods complete because game status is 'completed'
+        });
+
+        it('Bug Fix: Should NOT mark current period as complete during transition to period 4', () => {
+            const event = {
+                status: 'live',
+                is_live: true,
+                in_play: { period: '4' },
+                scores: {
+                    home: { periods: { period_1: 33, period_2: 32, period_3: 25, period_4: 5 } },
+                    away: { periods: { period_1: 23, period_2: 27, period_3: 18, period_4: 3 } },
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3]); // Periods 1, 2, 3 are complete
+            expect(result?.currentPeriod).toBe(4);
+            // Period 4 is currently in_play, so NOT complete yet
+        });
+
+        it('Basketball at halftime should mark periods 1 AND 2 as complete (quarters-based)', () => {
+            const event = {
+                sport: {
+                    id: 'basketball',
+                    name: 'Basketball',
+                },
+                fixture: {
+                    id: 'nba-halftime-123',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 52.0,
+                        periods: {
+                            period_1: 25.0,
+                            period_2: 27.0,
+                        },
+                    },
+                    away: {
+                        total: 48.0,
+                        periods: {
+                            period_1: 22.0,
+                            period_2: 26.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 25.0, away: 22.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 27.0, away: 26.0 });
+        });
+
+        it('Basketball at halftime with status "halftime" should mark periods 1 AND 2 as complete', () => {
+            const event = {
+                sport: {
+                    id: 'basketball',
+                    name: 'Basketball',
+                },
+                fixture: {
+                    id: 'nba-halftime-456',
+                    status: 'halftime',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 55.0,
+                        periods: {
+                            period_1: 28.0,
+                            period_2: 27.0,
+                        },
+                    },
+                    away: {
+                        total: 50.0,
+                        periods: {
+                            period_1: 24.0,
+                            period_2: 26.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '2',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Football at halftime should mark periods 1 AND 2 as complete (quarters-based)', () => {
+            const event = {
+                sport: {
+                    id: 'football',
+                    name: 'Football',
+                },
+                fixture: {
+                    id: 'nfl-halftime-789',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 21.0,
+                        periods: {
+                            period_1: 7.0,
+                            period_2: 14.0,
+                        },
+                    },
+                    away: {
+                        total: 10.0,
+                        periods: {
+                            period_1: 3.0,
+                            period_2: 7.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 7.0, away: 3.0 });
+            expect(result?.periodScores['period2']).toEqual({ home: 14.0, away: 7.0 });
+        });
+
+        it('Football at halftime with status "halftime" should mark periods 1 AND 2 as complete', () => {
+            const event = {
+                sport: {
+                    id: 'football',
+                    name: 'American Football',
+                },
+                fixture: {
+                    id: 'nfl-halftime-890',
+                    status: 'halftime',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 17.0,
+                        periods: {
+                            period_1: 10.0,
+                            period_2: 7.0,
+                        },
+                    },
+                    away: {
+                        total: 14.0,
+                        periods: {
+                            period_1: 7.0,
+                            period_2: 7.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: '2',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2]); // Both Q1 and Q2 complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+        });
+
+        it('Baseball at halftime should mark periods 1-5 as complete (innings-based)', () => {
+            const event = {
+                sport: {
+                    id: 'baseball',
+                    name: 'Baseball',
+                },
+                fixture: {
+                    id: 'mlb-halftime-789',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 3.0,
+                        periods: {
+                            period_1: 0.0,
+                            period_2: 1.0,
+                            period_3: 1.0,
+                            period_4: 0.0,
+                            period_5: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 2.0,
+                        periods: {
+                            period_1: 1.0,
+                            period_2: 0.0,
+                            period_3: 0.0,
+                            period_4: 1.0,
+                            period_5: 0.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]); // First 5 innings complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 0.0, away: 1.0 });
+            expect(result?.periodScores['period5']).toEqual({ home: 1.0, away: 0.0 });
+        });
+
+        it('Soccer at halftime should mark only period 1 as complete (halves-based)', () => {
+            const event = {
+                sport: {
+                    id: 'soccer',
+                    name: 'Soccer',
+                },
+                fixture: {
+                    id: 'soccer-halftime-101',
+                    status: 'halftime',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 2.0,
+                        periods: {
+                            period_1: 2.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 1.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            expect(result).not.toBeNull();
+            expect(result?.completedPeriods).toEqual([1]); // Only first half complete at halftime
+            expect(result?.readyForResolution).toBe(true);
+            expect(result?.periodScores['period1']).toEqual({ home: 2.0, away: 1.0 });
+        });
+
+        it('Hockey at halftime should NOT mark any periods as complete (period-based, no halftime concept)', () => {
+            const event = {
+                sport: {
+                    id: 'hockey',
+                    name: 'Hockey',
+                },
+                fixture: {
+                    id: 'nhl-halftime-202',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 2.0,
+                        periods: {
+                            period_1: 1.0,
+                            period_2: 1.0,
+                        },
+                    },
+                    away: {
+                        total: 1.0,
+                        periods: {
+                            period_1: 0.0,
+                            period_2: 1.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            // Hockey doesn't have traditional halftime, so halftime status shouldn't mark periods complete
+            // Periods should only be marked complete based on in_play.period progression
+            expect(result).toBeNull();
+        });
+
+        it('Unknown sport at halftime should default to PERIOD_BASED (no halftime processing)', () => {
+            const event = {
+                sport: {
+                    id: 'unknown_sport',
+                    name: 'Unknown Sport',
+                },
+                fixture: {
+                    id: 'unknown-halftime-123',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 50.0,
+                        periods: {
+                            period_1: 25.0,
+                            period_2: 25.0,
+                        },
+                    },
+                    away: {
+                        total: 40.0,
+                        periods: {
+                            period_1: 20.0,
+                            period_2: 20.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            // Unknown sports default to PERIOD_BASED (no halftime processing)
+            // So halftime status should NOT mark any periods as complete
+            expect(result).toBeNull();
+        });
+
+        it('Event with missing sport.id should default to PERIOD_BASED (no halftime processing)', () => {
+            const event = {
+                sport: {
+                    name: 'Some Sport',
+                },
+                fixture: {
+                    id: 'no-sport-id-123',
+                    status: 'half',
+                    is_live: true,
+                },
+                scores: {
+                    home: {
+                        total: 50.0,
+                        periods: {
+                            period_1: 25.0,
+                            period_2: 25.0,
+                        },
+                    },
+                    away: {
+                        total: 40.0,
+                        periods: {
+                            period_1: 20.0,
+                            period_2: 20.0,
+                        },
+                    },
+                },
+                in_play: {
+                    period: 'half',
+                },
+            };
+
+            const result = detectCompletedPeriods(event);
+
+            // Missing sport.id defaults to PERIOD_BASED (no halftime processing)
+            expect(result).toBeNull();
+        });
+    });
+
+    describe('canResolveMarketsForEvent', () => {
+        describe('Single typeId checks', () => {
+            it('Should return true for 1st period typeId when period 1 is complete (Soccer 2nd half)', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10021, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('Should return false for 2nd period typeId when only period 1 is complete', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10022, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(false);
+            });
+
+            it('Should return false for full game typeId during live game', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10001, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(false);
+            });
+
+            it('Should return true for full game typeId when game is completed', () => {
+                const result = canResolveMarketsForEvent(MockSoccerCompletedEvent, 10001, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('Should return true for 1st quarter typeId when quarter 1 complete (NFL)', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    10021,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(true);
+            });
+
+            it('Should return true for 2nd quarter typeId when quarters 1-2 complete (NFL)', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    10022,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(true);
+            });
+
+            it('Should return false for 3rd quarter typeId during 3rd quarter (NFL)', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    10023,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(false);
+            });
+
+            it('Should return true for all quarter typeIds when game is completed (NFL)', () => {
+                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10021, SportPeriodType.QUARTERS_BASED)).toBe(
+                    true
+                );
+                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10022, SportPeriodType.QUARTERS_BASED)).toBe(
+                    true
+                );
+                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10023, SportPeriodType.QUARTERS_BASED)).toBe(
+                    true
+                );
+                expect(canResolveMarketsForEvent(MockNFLCompletedEvent, 10024, SportPeriodType.QUARTERS_BASED)).toBe(
+                    true
+                );
+            });
+
+            it('Should return false when no periods are complete', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveFirstHalf, 10021, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(false);
+            });
+
+            it('Should return false for non-existent typeId', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 99999, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(false);
+            });
+        });
+
+        describe('Batch typeIds checks', () => {
+            it('Should return only resolvable typeIds for live soccer in 2nd half', () => {
+                const typeIds = [10021, 10022, 10031, 10001];
+                const result = filterMarketsThatCanBeResolved(
+                    MockSoccerLiveSecondHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([10021, 10031]); // Only period 1 typeIds
+            });
+
+            it('Should exclude full game typeIds during live game', () => {
+                const typeIds = [10021, 10001, 10002, 10003];
+                const result = filterMarketsThatCanBeResolved(
+                    MockNFLLiveThirdQuarter,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                expect(result).toEqual([10021]); // Full game typeIds excluded
+            });
+
+            it('Should include full game typeIds when game is completed', () => {
+                const typeIds = [10021, 10022, 10001, 10002];
+                const result = filterMarketsThatCanBeResolved(
+                    MockSoccerCompletedEvent,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([10021, 10022, 10001, 10002]);
+            });
+
+            it('Should return empty array when no typeIds are resolvable', () => {
+                const typeIds = [10022, 10023, 10024];
+                const result = filterMarketsThatCanBeResolved(
+                    MockSoccerLiveSecondHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([]);
+            });
+
+            it('Should return multiple period typeIds for NFL game in 3rd quarter', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10031, 10032, 10051];
+                const result = filterMarketsThatCanBeResolved(
+                    MockNFLLiveThirdQuarter,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                // Periods 1 and 2 are complete (period 2 also completes 1st half = 10051)
+                expect(result).toEqual([10021, 10022, 10031, 10032, 10051]);
+            });
+
+            it('Should handle all 9 periods for completed MLB game', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10025, 10026, 10027, 10028, 10029];
+                const result = filterMarketsThatCanBeResolved(
+                    MockMLBCompletedEvent,
+                    typeIds,
+                    SportPeriodType.INNINGS_BASED
+                );
+
+                expect(result).toEqual(typeIds); // All 9 innings complete
+            });
+
+            it('Should return empty array when no periods complete', () => {
+                const typeIds = [10021, 10022, 10031];
+                const result = filterMarketsThatCanBeResolved(
+                    MockSoccerLiveFirstHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([]);
+            });
+        });
+
+        describe('Multiple typeIds boolean array checks', () => {
+            it('Should return boolean array for live soccer in 2nd half', () => {
+                const typeIds = [10021, 10022, 10031, 10001];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockSoccerLiveSecondHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([true, false, true, false]); // Period 1 typeIds are true, period 2 and full game are false
+            });
+
+            it('Should return false for full game typeIds during live game', () => {
+                const typeIds = [10021, 10001, 10002, 10003];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                expect(result).toEqual([true, false, false, false]); // Only period 1 is true
+            });
+
+            it('Should return all true for completed game', () => {
+                const typeIds = [10021, 10022, 10001, 10002];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockSoccerCompletedEvent,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([true, true, true, true]); // All complete
+            });
+
+            it('Should return all false when no typeIds are resolvable', () => {
+                const typeIds = [10022, 10023, 10024];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockSoccerLiveSecondHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([false, false, false]);
+            });
+
+            it('Should return mixed booleans for NFL game in 3rd quarter', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10031, 10032, 10051];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                // Periods 1 and 2 are complete (period 2 also completes 1st half = 10051)
+                expect(result).toEqual([true, true, false, false, true, true, true]);
+            });
+
+            it('Should handle all 9 periods for completed MLB game', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10025, 10026, 10027, 10028, 10029];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockMLBCompletedEvent,
+                    typeIds,
+                    SportPeriodType.INNINGS_BASED
+                );
+
+                expect(result).toEqual([true, true, true, true, true, true, true, true, true]); // All 9 innings complete
+            });
+
+            it('Should return all false when no periods complete', () => {
+                const typeIds = [10021, 10022, 10031];
+                const result = canResolveMultipleTypeIdsForEvent(
+                    MockSoccerLiveFirstHalf,
+                    typeIds,
+                    SportPeriodType.HALVES_BASED
+                );
+
+                expect(result).toEqual([false, false, false]);
+            });
+
+            it('Should work with numeric sport type parameter', () => {
+                const typeIds = [10021, 10022];
+                const result = canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, 0); // 0 = HALVES_BASED
+
+                expect(result).toEqual([true, false]);
+            });
+        });
+
+        describe('Edge cases', () => {
+            it('Should handle event with no completed periods', () => {
+                const result = canResolveMarketsForEvent(
+                    MockSoccerLiveFirstHalfInProgress,
+                    10021,
+                    SportPeriodType.HALVES_BASED
+                );
+                expect(result).toBe(false);
+            });
+
+            it('Should respect full game typeIds list', () => {
+                // Test all full game typeIds
+                const fullGameTypeIds = [0, 10001, 10002, 10003, 10004, 10010, 10011, 10012];
+
+                fullGameTypeIds.forEach((typeId) => {
+                    const result = canResolveMarketsForEvent(
+                        MockNFLLiveThirdQuarter,
+                        typeId,
+                        SportPeriodType.QUARTERS_BASED
+                    );
+                    expect(result).toBe(false);
+                });
+            });
+
+            it('Should work with sport type parameter for single typeId', () => {
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10021, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('Should work with sport type parameter for batch typeIds', () => {
+                const result = filterMarketsThatCanBeResolved(
+                    MockSoccerLiveSecondHalf,
+                    [10021, 10022],
+                    SportPeriodType.HALVES_BASED
+                );
+                expect(result).toEqual([10021]);
+            });
+        });
+
+        describe('Real overtime NFL game (Rams vs 49ers)', () => {
+            it('Should detect all 5 periods complete including overtime', () => {
+                const result = detectCompletedPeriods(MockNFLCompletedWithOvertime);
+
+                expect(result).not.toBeNull();
+                expect(result?.completedPeriods).toEqual([1, 2, 3, 4, 5]);
+                expect(result?.readyForResolution).toBe(true);
+                expect(result?.periodScores['period5']).toEqual({ home: 0.0, away: 3.0 });
+            });
+
+            it('Should resolve all quarter typeIds (10021-10024) for completed overtime game', () => {
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10021, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10022, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10023, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10024, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+            });
+
+            it('Should NOT resolve overtime period typeId (10025) - overtime has no specific markets', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLCompletedWithOvertime,
+                    10025,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(false);
+            });
+
+            it('Should resolve full game typeIds for completed overtime game', () => {
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10001, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+                expect(
+                    canResolveMarketsForEvent(MockNFLCompletedWithOvertime, 10002, SportPeriodType.QUARTERS_BASED)
+                ).toBe(true);
+            });
+
+            it('Should return all resolvable typeIds excluding overtime in batch check', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10025, 10001];
+                const result = filterMarketsThatCanBeResolved(
+                    MockNFLCompletedWithOvertime,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                // 10025 (overtime) should not be included as period 5 has no specific markets
+                expect(result).toEqual([10021, 10022, 10023, 10024, 10001]);
+            });
+
+            it('Should return false for 8th period typeId (period did not occur)', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLCompletedWithOvertime,
+                    10028,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(false);
+            });
+
+            it('Should return false for 9th period typeId (period did not occur)', () => {
+                const result = canResolveMarketsForEvent(
+                    MockNFLCompletedWithOvertime,
+                    10029,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(false);
+            });
+
+            it('Should not include non-existent periods in batch check', () => {
+                const typeIds = [10021, 10022, 10023, 10024, 10025, 10028, 10029];
+                const result = filterMarketsThatCanBeResolved(
+                    MockNFLCompletedWithOvertime,
+                    typeIds,
+                    SportPeriodType.QUARTERS_BASED
+                );
+
+                // Periods 1-4 are resolvable; period 5 (overtime) has no markets; periods 8-9 did not occur
+                expect(result).toEqual([10021, 10022, 10023, 10024]);
+            });
+        });
+
+        describe('Sport-type-specific resolution for typeId 10051 (1st half)', () => {
+            it('Soccer (HALVES_BASED): Should resolve typeId 10051 after period 1', () => {
+                // Soccer: Period 1 = 1st half
+                const result = canResolveMarketsForEvent(MockSoccerLiveSecondHalf, 10051, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('NFL (QUARTERS_BASED): Should resolve typeId 10051 after period 2', () => {
+                // NFL: Period 2 completes 1st half (quarters 1+2)
+                const result = canResolveMarketsForEvent(
+                    MockNFLLiveThirdQuarter,
+                    10051,
+                    SportPeriodType.QUARTERS_BASED
+                );
+                expect(result).toBe(true);
+            });
+
+            it('NFL (QUARTERS_BASED): Should NOT resolve typeId 10051 after only period 1', () => {
+                // Create mock with only period 1 complete
+                const mockNFLFirstQuarter = {
+                    ...MockNFLLiveThirdQuarter,
+                    scores: {
+                        home: { total: 7.0, periods: { period_1: 7.0 } },
+                        away: { total: 3.0, periods: { period_1: 3.0 } },
+                    },
+                    in_play: { period: '2', clock: '5:00' },
+                };
+
+                const result = canResolveMarketsForEvent(mockNFLFirstQuarter, 10051, SportPeriodType.QUARTERS_BASED);
+                expect(result).toBe(false);
+            });
+
+            it('MLB (INNINGS_BASED): Should resolve typeId 10051 after period 5', () => {
+                // MLB: Period 5 completes 1st half (innings 1-5)
+                const result = canResolveMarketsForEvent(MockMLBLiveSixthInning, 10051, SportPeriodType.INNINGS_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('MLB (INNINGS_BASED): Should NOT resolve typeId 10051 after only period 4', () => {
+                // Create mock with only period 1-4 complete
+                const mockMLBFourthInning = {
+                    ...MockMLBLiveSixthInning,
+                    scores: {
+                        home: {
+                            total: 3.0,
+                            periods: {
+                                period_1: 0.0,
+                                period_2: 2.0,
+                                period_3: 1.0,
+                                period_4: 0.0,
+                            },
+                        },
+                        away: {
+                            total: 1.0,
+                            periods: {
+                                period_1: 1.0,
+                                period_2: 0.0,
+                                period_3: 0.0,
+                                period_4: 0.0,
+                            },
+                        },
+                    },
+                    in_play: { period: '5', clock: null },
+                };
+
+                const result = canResolveMarketsForEvent(mockMLBFourthInning, 10051, SportPeriodType.INNINGS_BASED);
+                expect(result).toBe(false);
+            });
+        });
+
+        describe('Sport-type-specific resolution for typeId 10052 (2nd half)', () => {
+            it('Soccer (HALVES_BASED): Should resolve typeId 10052 after period 2', () => {
+                const result = canResolveMarketsForEvent(MockSoccerCompletedEvent, 10052, SportPeriodType.HALVES_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('NFL (QUARTERS_BASED): Should resolve typeId 10052 after period 4', () => {
+                const result = canResolveMarketsForEvent(MockNFLCompletedEvent, 10052, SportPeriodType.QUARTERS_BASED);
+                expect(result).toBe(true);
+            });
+
+            it('MLB (INNINGS_BASED): Should resolve typeId 10052 after period 9', () => {
+                const result = canResolveMarketsForEvent(MockMLBCompletedEvent, 10052, SportPeriodType.INNINGS_BASED);
+                expect(result).toBe(true);
+            });
+        });
+
+        describe('Error handling for invalid sport type numbers', () => {
+            it('Should throw error for invalid sport type number when using numeric parameter', () => {
+                const typeIds = [10021, 10022];
+
+                // Invalid sport type number (must be 0-3)
+                expect(() => {
+                    canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, 99);
+                }).toThrow('Invalid sport type number: 99. Must be 0 (halves), 1 (quarters), 2 (innings), or 3 (period).');
+            });
+
+            it('Should throw error for negative sport type number', () => {
+                const typeIds = [10021];
+
+                expect(() => {
+                    canResolveMultipleTypeIdsForEvent(MockSoccerLiveSecondHalf, typeIds, -1);
+                }).toThrow('Invalid sport type number: -1. Must be 0 (halves), 1 (quarters), 2 (innings), or 3 (period).');
+            });
+        });
+    });
+});