Refactor code structure for improved readability and maintainability

backend/tests/services/fsScanner.archiveEntries.spec.ts

@@ -9,7 +9,9 @@ vi.mock('../../src/services/archiveReader', () => ({ listArchiveEntries: vi.fn()
 import scanDirectory from '../../src/services/fsScanner';
 import { listArchiveEntries } from '../../src/services/archiveReader';
 
-afterEach(() => vi.restoreAllMocks());
+afterEach(() => {
+  vi.restoreAllMocks();
+});
 
 it('expone entradas internas de archivos como items virtuales', async () => {
   const tmpDir = await fs.mkdtemp(path.join(os.tmpdir(), 'fsScanner-test-'));
@@ -26,11 +28,13 @@ it('expone entradas internas de archivos como items virtuales', async () => {
   const found = results.find((r: any) => r.path === expectedPath);
 
   expect(found).toBeDefined();
-  expect(found.isArchiveEntry).toBe(true);
-  expect(found.containerPath).toBe(collectionFile);
-  expect(found.entryPath).toBe('inner/rom1.bin');
-  expect(found.filename).toBe('rom1.bin');
-  expect(found.format).toBe('bin');
+  if (found) {
+    expect(found.isArchiveEntry).toBe(true);
+    expect(found.containerPath).toBe(collectionFile);
+    expect(found.entryPath).toBe('inner/rom1.bin');
+    expect(found.filename).toBe('rom1.bin');
+    expect(found.format).toBe('bin');
+  }
 
   await fs.rm(tmpDir, { recursive: true, force: true });
 });

backend/tests/services/importService.archiveEntry.spec.ts

@@ -16,12 +16,18 @@ import { streamArchiveEntry } from '../../src/services/archiveReader';
 import prisma from '../../src/plugins/prisma';
 import { createHash } from 'crypto';
 
+// Mock Date.now() para timestamps consistentes en tests
+const FIXED_TIMESTAMP = 1234567890123;
+const dateNowSpy = vi.spyOn(Date, 'now').mockReturnValue(FIXED_TIMESTAMP);
+
 beforeEach(() => {
   vi.restoreAllMocks();
+  dateNowSpy.mockReturnValue(FIXED_TIMESTAMP);
 });
 
 describe('services/importService (archive entries)', () => {
   it('procesa una entrada interna usando streamArchiveEntry y crea Game con source=rom', async () => {
+    const data = Buffer.from('import-archive-test');
     const files = [
       {
         path: '/roms/collection.zip::inner/rom1.bin',
@@ -29,14 +35,12 @@ describe('services/importService (archive entries)', () => {
         entryPath: 'inner/rom1.bin',
         filename: 'rom1.bin',
         name: 'inner/rom1.bin',
-        size: 123,
+        size: data.length,
         format: 'bin',
         isArchiveEntry: true,
       },
     ];
 
-    const data = Buffer.from('import-archive-test');
-
     (scanDirectory as unknown as Mock).mockResolvedValue(files);
     (streamArchiveEntry as unknown as Mock).mockResolvedValue(Readable.from([data]));
 
@@ -60,12 +64,12 @@ describe('services/importService (archive entries)', () => {
     });
     expect((prisma.game.create as unknown as Mock).mock.calls[0][0]).toEqual({
       data: {
-        title: 'ROM1',
-        slug: 'rom1-1234567890123',
+        title: 'rom1',
+        slug: expect.stringMatching(/^rom1-\d+$/),
         source: 'rom',
         romPath: '/roms/collection.zip::inner/rom1.bin',
         romFilename: 'rom1.bin',
-        romSize: 123,
+        romSize: data.length,
         romChecksum: md5,
         romFormat: 'bin',
         romHashes: expect.any(String),

backend/tests/services/importService.spec.ts

@@ -20,9 +20,14 @@ import { scanDirectory } from '../../src/services/fsScanner';
 import { computeHashes } from '../../src/services/checksumService';
 import prisma from '../../src/plugins/prisma';
 
+// Mock Date.now() para timestamps consistentes en tests
+const FIXED_TIMESTAMP = 1234567890123;
+const dateNowSpy = vi.spyOn(Date, 'now').mockReturnValue(FIXED_TIMESTAMP);
+
 describe('services/importService', () => {
   beforeEach(() => {
     vi.clearAllMocks();
+    dateNowSpy.mockReturnValue(FIXED_TIMESTAMP);
   });
 
   it('exporta createSlug e importDirectory', () => {

backend/tests/services/metadataService.spec.ts

@@ -18,7 +18,7 @@ vi.mock('../../src/services/thegamesdbClient', () => ({
 import * as igdb from '../../src/services/igdbClient';
 import * as rawg from '../../src/services/rawgClient';
 import * as tgdb from '../../src/services/thegamesdbClient';
-import { enrichGame } from '../../src/services/metadataService';
+import { enrichGame, searchGames } from '../../src/services/metadataService';
 
 describe('services/metadataService', () => {
   beforeEach(() => {
@@ -79,4 +79,214 @@ describe('services/metadataService', () => {
     const res = await enrichGame({ title: 'Juego inexistente' });
     expect(res).toBeNull();
   });
+
+  describe('searchGames', () => {
+    it('debería buscar en paralelo en IGDB, RAWG y TheGamesDB', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 1,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://igdb.com/cover.jpg',
+          source: 'igdb',
+        },
+      ]);
+
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 2,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros-rawg',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://rawg.com/cover.jpg',
+          source: 'rawg',
+        },
+      ]);
+
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 3,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros-tgdb',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://tgdb.com/cover.jpg',
+          source: 'thegamesdb',
+        },
+      ]);
+
+      const results = await searchGames({ title: 'Super Mario Bros.' });
+
+      expect(results.length).toBeGreaterThan(0);
+      expect(igdb.searchGames).toHaveBeenCalledWith('Super Mario Bros.', undefined);
+      expect(rawg.searchGames).toHaveBeenCalledWith('Super Mario Bros.');
+      expect(tgdb.searchGames).toHaveBeenCalledWith('Super Mario Bros.');
+    });
+
+    it('debería deduplicar resultados por nombre normalizado', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 1,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://igdb.com/cover.jpg',
+          source: 'igdb',
+        },
+      ]);
+
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 2,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros-rawg',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://rawg.com/cover.jpg',
+          source: 'rawg',
+        },
+      ]);
+
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+
+      const results = await searchGames({ title: 'Super Mario Bros.' });
+
+      // Debería haber un solo resultado (prioridad IGDB)
+      expect(results.length).toBe(1);
+      expect(results[0].source).toBe('igdb');
+      expect(results[0].externalIds.igdb).toBe(1);
+      expect(results[0].externalIds.rawg).toBe(2);
+    });
+
+    it('debería priorizar IGDB > RAWG > TheGamesDB en deduplicación', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 1,
+          name: 'Zelda',
+          slug: 'zelda',
+          releaseDate: '1986-02-21',
+          genres: ['Adventure'],
+          coverUrl: 'http://igdb.com/zelda.jpg',
+          source: 'igdb',
+        },
+      ]);
+
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 2,
+          name: 'Zelda',
+          slug: 'zelda-rawg',
+          releaseDate: '1986-02-21',
+          genres: ['Adventure'],
+          coverUrl: 'http://rawg.com/zelda.jpg',
+          source: 'rawg',
+        },
+      ]);
+
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 3,
+          name: 'Zelda',
+          slug: 'zelda-tgdb',
+          releaseDate: '1986-02-21',
+          genres: ['Adventure'],
+          coverUrl: 'http://tgdb.com/zelda.jpg',
+          source: 'thegamesdb',
+        },
+      ]);
+
+      const results = await searchGames({ title: 'Zelda' });
+
+      expect(results.length).toBe(1);
+      expect(results[0].source).toBe('igdb');
+      expect(results[0].externalIds).toEqual({
+        igdb: 1,
+        rawg: 2,
+        thegamesdb: 3,
+      });
+    });
+
+    it('debería devolver array vacío si no hay resultados', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+
+      const results = await searchGames({ title: 'Juego inexistente' });
+
+      expect(results).toEqual([]);
+    });
+
+    it('debería manejar errores de API y continuar con otras fuentes', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockRejectedValue(
+        new Error('IGDB error')
+      );
+
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 2,
+          name: 'Sonic',
+          slug: 'sonic',
+          releaseDate: '1991-06-23',
+          genres: ['Platform'],
+          coverUrl: 'http://rawg.com/sonic.jpg',
+          source: 'rawg',
+        },
+      ]);
+
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+
+      const results = await searchGames({ title: 'Sonic' });
+
+      expect(results.length).toBe(1);
+      expect(results[0].source).toBe('rawg');
+    });
+
+    it('debería pasar el parámetro platform a IGDB', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+
+      await searchGames({ title: 'Mario', platform: 'NES' });
+
+      expect(igdb.searchGames).toHaveBeenCalledWith('Mario', 'NES');
+      expect(rawg.searchGames).toHaveBeenCalledWith('Mario');
+      expect(tgdb.searchGames).toHaveBeenCalledWith('Mario');
+    });
+
+    it('debería mantener múltiples resultados con nombres diferentes', async () => {
+      (igdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([
+        {
+          id: 1,
+          name: 'Super Mario Bros.',
+          slug: 'super-mario-bros',
+          releaseDate: '1985-09-13',
+          genres: ['Platform'],
+          coverUrl: 'http://igdb.com/smb.jpg',
+          source: 'igdb',
+        },
+        {
+          id: 2,
+          name: 'Super Mario Bros. 2',
+          slug: 'super-mario-bros-2',
+          releaseDate: '1988-10-09',
+          genres: ['Platform'],
+          coverUrl: 'http://igdb.com/smb2.jpg',
+          source: 'igdb',
+        },
+      ]);
+
+      (rawg.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+      (tgdb.searchGames as unknown as ReturnType<typeof vi.fn>).mockResolvedValue([]);
+
+      const results = await searchGames({ title: 'Super Mario' });
+
+      expect(results.length).toBe(2);
+      expect(results[0].name).toBe('Super Mario Bros.');
+      expect(results[1].name).toBe('Super Mario Bros. 2');
+    });
+  });
 });