gridpilot.gg/core/ports/media/MediaResolverPort.test.ts

/**
 * TDD Tests for MediaResolverPort interface contract
 * 
 * Tests cover:
 * - Interface contract compliance
 * - Method signatures
 * - Return types
 * - Error handling behavior
 */

import { MediaReference } from '@core/domain/media/MediaReference';
import { beforeEach, describe, expect, it, vi } from 'vitest';
import { MediaResolverPort } from './MediaResolverPort';

describe('MediaResolverPort', () => {
  let mockResolver: MediaResolverPort;

  beforeEach(() => {
    // Create a mock implementation for testing
    mockResolver = {
      resolve: vi.fn(async (ref: MediaReference): Promise<string | null> => {
        // Mock implementation that returns different URLs based on type
        switch (ref.type) {
          case 'system-default':
            return `/defaults/${ref.variant}`;
          case 'generated':
            return `/generated/${ref.generationRequestId}`;
          case 'uploaded':
            return `/media/${ref.mediaId}`;
          case 'none':
            return null;
          default:
            return null;
        }
      })
    };
  });

  describe('Interface Contract', () => {
    it('should have a resolve method', () => {
      expect(typeof mockResolver.resolve).toBe('function');
    });

    it('should accept MediaReference parameter', async () => {
      const ref = MediaReference.createSystemDefault('avatar');
      
      await expect(mockResolver.resolve(ref)).resolves.toBeDefined();
    });

    it('should return Promise<string | null>', async () => {
      const ref = MediaReference.createSystemDefault('avatar');
      
      const result = await mockResolver.resolve(ref);
      expect(result === null || typeof result === 'string').toBe(true);
    });
  });

  describe('System Default Resolution', () => {
    it('should resolve system-default avatar to correct URL', async () => {
      const ref = MediaReference.createSystemDefault('avatar');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/defaults/avatar');
    });

    it('should resolve system-default logo to correct URL', async () => {
      const ref = MediaReference.createSystemDefault('logo');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/defaults/logo');
    });
  });

  describe('Generated Resolution', () => {
    it('should resolve generated reference to correct URL', async () => {
      const ref = MediaReference.createGenerated('req-123');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/generated/req-123');
    });

    it('should handle generated reference with special characters', async () => {
      const ref = MediaReference.createGenerated('req-abc-123_XYZ');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/generated/req-abc-123_XYZ');
    });
  });

  describe('Uploaded Resolution', () => {
    it('should resolve uploaded reference to correct URL', async () => {
      const ref = MediaReference.createUploaded('media-456');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/media/media-456');
    });

    it('should handle uploaded reference with special characters', async () => {
      const ref = MediaReference.createUploaded('media-abc-456_XYZ');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/media/media-abc-456_XYZ');
    });
  });

  describe('None Resolution', () => {
    it('should resolve none reference to null', async () => {
      const ref = MediaReference.createNone();
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBeNull();
    });
  });

  describe('Edge Cases', () => {
    it('should handle very long media IDs', async () => {
      const longId = 'a'.repeat(1000);
      const ref = MediaReference.createUploaded(longId);
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe(`/media/${longId}`);
    });

    it('should handle Unicode characters in IDs', async () => {
      const ref = MediaReference.createUploaded('media-日本語-123');
      
      const result = await mockResolver.resolve(ref);
      
      expect(result).toBe('/media/media-日本語-123');
    });

    it('should handle multiple calls with different references', async () => {
      const refs = [
        MediaReference.createSystemDefault('avatar'),
        MediaReference.createGenerated('req-123'),
        MediaReference.createUploaded('media-456'),
        MediaReference.createNone()
      ];
      
      const results = await Promise.all(refs.map(ref => mockResolver.resolve(ref)));
      
      expect(results).toEqual([
        '/defaults/avatar',
        '/generated/req-123',
        '/media/media-456',
        null
      ]);
    });
  });

  describe('Performance Considerations', () => {
    it('should resolve quickly for simple cases', async () => {
      const ref = MediaReference.createSystemDefault('avatar');
      
      const start = Date.now();
      await mockResolver.resolve(ref);
      const duration = Date.now() - start;
      
      expect(duration).toBeLessThan(100); // Should be very fast
    });

    it('should handle concurrent resolutions', async () => {
      const refs = Array.from({ length: 100 }, (_, i) => 
        MediaReference.createUploaded(`media-${i}`)
      );
      
      const start = Date.now();
      const results = await Promise.all(refs.map(ref => mockResolver.resolve(ref)));
      const duration = Date.now() - start;
      
      expect(results.length).toBe(100);
      expect(duration).toBeLessThan(1000); // Should handle 100 concurrent calls quickly
    });
  });
});