import type { Job } from 'bullmq'; import { DEFAULT_FEATURE_RECOMPUTE_BATCH_SIZE, FEATURE_RECOMPUTE_JOB_NAME, MAX_FEATURE_RECOMPUTE_BATCH_SIZE, USER_ANALYSIS_JOB_NAME, } from './analysis.constants'; import type { FeatureRecomputeJobData, UserAnalysisJobData, } from './analysis.types'; import { AnalysisPipelineService } from './analysis-pipeline.service'; import { AnalysisProcessor } from './analysis.processor'; function createJobData( overrides: Partial = {}, ): UserAnalysisJobData { return { gameName: 'Hide on bush', tagLine: 'KR1', platformRoute: 'kr', regionalRoute: 'asia', queueId: 420, requestedMatchCount: 20, ...overrides, }; } function createFeatureRecomputeJobData( overrides: Partial = {}, ): FeatureRecomputeJobData { return { platformRoute: 'kr', queueId: 420, batchSize: 25, puuid: 'target-puuid', ...overrides, }; } describe('AnalysisProcessor', () => { it('delegates BullMQ jobs to the analysis pipeline', async () => { const processUserAnalysisJob = jest .fn< Promise, [UserAnalysisJobData, string, { isFinalAttempt?: boolean }] >() .mockResolvedValue(undefined); const processor = new AnalysisProcessor({ processUserAnalysisJob, } as unknown as AnalysisPipelineService); await processor.process({ attemptsMade: 1, id: 'analysis-job-1', name: USER_ANALYSIS_JOB_NAME, opts: { attempts: 2 }, data: createJobData(), } as Job); expect(processUserAnalysisJob).toHaveBeenCalledWith( createJobData(), 'analysis-job-1', { isFinalAttempt: true }, ); }); it('delegates feature recompute jobs to the analysis pipeline', async () => { const processFeatureRecomputeJob = jest .fn< Promise, [FeatureRecomputeJobData, string, { isFinalAttempt?: boolean }] >() .mockResolvedValue(undefined); const processor = new AnalysisProcessor({ processFeatureRecomputeJob, } as unknown as AnalysisPipelineService); await processor.process({ attemptsMade: 0, id: 'recompute-job-1', name: FEATURE_RECOMPUTE_JOB_NAME, opts: { attempts: 2 }, data: createFeatureRecomputeJobData(), } as Job); expect(processFeatureRecomputeJob).toHaveBeenCalledWith( createFeatureRecomputeJobData(), 'recompute-job-1', { isFinalAttempt: false }, ); }); it('normalizes feature recompute batch size from valid queue payloads', async () => { const processFeatureRecomputeJob = jest.fn().mockResolvedValue(undefined); const processor = new AnalysisProcessor({ processFeatureRecomputeJob, } as unknown as AnalysisPipelineService); await processor.process({ attemptsMade: 0, id: 'recompute-job-1', name: FEATURE_RECOMPUTE_JOB_NAME, opts: { attempts: 2 }, data: createFeatureRecomputeJobData({ batchSize: 999 }), } as Job); expect(processFeatureRecomputeJob).toHaveBeenCalledWith( createFeatureRecomputeJobData({ batchSize: MAX_FEATURE_RECOMPUTE_BATCH_SIZE, }), 'recompute-job-1', { isFinalAttempt: false }, ); }); it('defaults fractional feature recompute batch sizes below one', async () => { const processFeatureRecomputeJob = jest.fn().mockResolvedValue(undefined); const processor = new AnalysisProcessor({ processFeatureRecomputeJob, } as unknown as AnalysisPipelineService); await processor.process({ attemptsMade: 0, id: 'recompute-job-1', name: FEATURE_RECOMPUTE_JOB_NAME, opts: { attempts: 2 }, data: createFeatureRecomputeJobData({ batchSize: 0.5 }), } as Job); expect(processFeatureRecomputeJob).toHaveBeenCalledWith( createFeatureRecomputeJobData({ batchSize: DEFAULT_FEATURE_RECOMPUTE_BATCH_SIZE, }), 'recompute-job-1', { isFinalAttempt: false }, ); }); it.each([ { data: null, expectedError: 'Feature recompute job data must be an object.', }, { data: { ...createFeatureRecomputeJobData(), platformRoute: 'invalid', }, expectedError: 'Analysis job platformRoute is unsupported.', }, { data: { ...createFeatureRecomputeJobData(), queueId: 430, }, expectedError: 'Analysis job queueId is unsupported.', }, { data: { ...createFeatureRecomputeJobData(), batchSize: Number.NaN, }, expectedError: 'Feature recompute job batchSize must be finite.', }, { data: { ...createFeatureRecomputeJobData(), puuid: ' ', }, expectedError: 'Analysis job puuid is out of range.', }, { data: { ...createFeatureRecomputeJobData(), puuid: 'x'.repeat(129), }, expectedError: 'Analysis job puuid is out of range.', }, ])( 'rejects malformed feature recompute payloads', async ({ data, expectedError }) => { const processFeatureRecomputeJob = jest.fn(); const processor = new AnalysisProcessor({ processFeatureRecomputeJob, } as unknown as AnalysisPipelineService); await expect( processor.process({ attemptsMade: 0, id: 'recompute-job-1', name: FEATURE_RECOMPUTE_JOB_NAME, opts: { attempts: 2 }, data, } as Job), ).rejects.toThrow(expectedError); expect(processFeatureRecomputeJob).not.toHaveBeenCalled(); }, ); it('rejects jobs without a BullMQ id', async () => { const processor = new AnalysisProcessor({ processUserAnalysisJob: jest.fn(), } as unknown as AnalysisPipelineService); await expect( processor.process({ data: createJobData(), name: USER_ANALYSIS_JOB_NAME, } as Job), ).rejects.toThrow('Analysis job is missing a BullMQ job id.'); }); it('rejects unsupported job names before processing data', async () => { const processUserAnalysisJob = jest.fn(); const processor = new AnalysisProcessor({ processUserAnalysisJob, } as unknown as AnalysisPipelineService); await expect( processor.process({ id: 'analysis-job-1', name: 'unexpected', data: createJobData(), } as Job), ).rejects.toThrow('Unsupported analysis job name "unexpected".'); expect(processUserAnalysisJob).not.toHaveBeenCalled(); }); it('rejects malformed Redis payloads', async () => { const processUserAnalysisJob = jest.fn(); const processor = new AnalysisProcessor({ processUserAnalysisJob, } as unknown as AnalysisPipelineService); await expect( processor.process({ attemptsMade: 0, id: 'analysis-job-1', name: USER_ANALYSIS_JOB_NAME, opts: { attempts: 2 }, data: { ...createJobData(), regionalRoute: 'americas', }, } as Job), ).rejects.toThrow( 'Analysis job regionalRoute does not match platformRoute.', ); expect(processUserAnalysisJob).not.toHaveBeenCalled(); }); it('normalizes requested match count from valid queue payloads', async () => { const processUserAnalysisJob = jest.fn().mockResolvedValue(undefined); const processor = new AnalysisProcessor({ processUserAnalysisJob, } as unknown as AnalysisPipelineService); await processor.process({ attemptsMade: 0, id: 'analysis-job-1', name: USER_ANALYSIS_JOB_NAME, opts: { attempts: 2 }, data: createJobData({ requestedMatchCount: 999 }), } as Job); expect(processUserAnalysisJob).toHaveBeenCalledWith( createJobData({ requestedMatchCount: 50 }), 'analysis-job-1', { isFinalAttempt: false }, ); }); });