module creation

apps/api/src/modules/sponsor/SponsorController.ts

@@ -0,0 +1,48 @@
+import { Controller, Get, Post, Body, HttpCode, HttpStatus, Param } from '@nestjs/common';
+import { ApiTags, ApiResponse, ApiOperation } from '@nestjs/swagger';
+import { SponsorService } from './SponsorService';
+import { GetEntitySponsorshipPricingResultDto, GetSponsorsOutput, CreateSponsorInput, CreateSponsorOutput, GetSponsorDashboardQueryParams, SponsorDashboardDTO, GetSponsorSponsorshipsQueryParams, SponsorSponsorshipsDTO } from './dto/SponsorDto';
+
+@ApiTags('sponsors')
+@Controller('sponsors')
+export class SponsorController {
+  constructor(private readonly sponsorService: SponsorService) {}
+
+  @Get('pricing')
+  @ApiOperation({ summary: 'Get sponsorship pricing for an entity' })
+  @ApiResponse({ status: 200, description: 'Sponsorship pricing', type: GetEntitySponsorshipPricingResultDto })
+  async getEntitySponsorshipPricing(): Promise<GetEntitySponsorshipPricingResultDto> {
+    return this.sponsorService.getEntitySponsorshipPricing();
+  }
+
+  @Get()
+  @ApiOperation({ summary: 'Get all sponsors' })
+  @ApiResponse({ status: 200, description: 'List of sponsors', type: GetSponsorsOutput })
+  async getSponsors(): Promise<GetSponsorsOutput> {
+    return this.sponsorService.getSponsors();
+  }
+
+  @Post()
+  @HttpCode(HttpStatus.CREATED)
+  @ApiOperation({ summary: 'Create a new sponsor' })
+  @ApiResponse({ status: 201, description: 'Sponsor created', type: CreateSponsorOutput })
+  async createSponsor(@Body() input: CreateSponsorInput): Promise<CreateSponsorOutput> {
+    return this.sponsorService.createSponsor(input);
+  }
+
+  // Add other Sponsor endpoints here based on other presenters
+  @Get('dashboard/:sponsorId')
+  @ApiOperation({ summary: 'Get sponsor dashboard metrics and sponsored leagues' })
+  @ApiResponse({ status: 200, description: 'Sponsor dashboard data', type: SponsorDashboardDTO })
+  @ApiResponse({ status: 404, description: 'Sponsor not found' })
+  async getSponsorDashboard(@Param('sponsorId') sponsorId: string): Promise<SponsorDashboardDTO | null> {
+    return this.sponsorService.getSponsorDashboard({ sponsorId });
+  }
+  @Get(':sponsorId/sponsorships')
+  @ApiOperation({ summary: 'Get all sponsorships for a given sponsor' })
+  @ApiResponse({ status: 200, description: 'List of sponsorships', type: SponsorSponsorshipsDTO })
+  @ApiResponse({ status: 404, description: 'Sponsor not found' })
+  async getSponsorSponsorships(@Param('sponsorId') sponsorId: string): Promise<SponsorSponsorshipsDTO | null> {
+    return this.sponsorService.getSponsorSponsorships({ sponsorId });
+  }
+}

apps/api/src/modules/sponsor/SponsorModule.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { SponsorService } from './SponsorService';
+import { SponsorController } from './SponsorController';
+
+@Module({
+  controllers: [SponsorController],
+  providers: [SponsorService],
+  exports: [SponsorService],
+})
+export class SponsorModule {}

apps/api/src/modules/sponsor/SponsorProviders.ts

@@ -0,0 +1,5 @@
+import { SponsorService } from './SponsorService';
+
+export const SponsorProviders = [
+  SponsorService,
+];

apps/api/src/modules/sponsor/SponsorService.ts

@@ -0,0 +1,162 @@
+import { Injectable } from '@nestjs/common';
+import { GetEntitySponsorshipPricingResultDto, SponsorDto, GetSponsorsOutput, CreateSponsorInput, CreateSponsorOutput, GetSponsorDashboardQueryParams, SponsorDashboardDTO, GetSponsorSponsorshipsQueryParams, SponsorshipDetailDTO, SponsorSponsorshipsDTO, SponsoredLeagueDTO, SponsorDashboardMetricsDTO, SponsorDashboardInvestmentDTO } from './dto/SponsorDto';
+
+const sponsors: Map<string, SponsorDto> = new Map();
+
+@Injectable()
+export class SponsorService {
+
+  constructor() {
+    // Seed some demo sponsors for dashboard if empty
+    if (sponsors.size === 0) {
+      const demoSponsor1: SponsorDto = {
+        id: 'sponsor-demo-1',
+        name: 'Demo Sponsor Co.',
+        contactEmail: 'contact@demosponsor.com',
+        websiteUrl: 'https://demosponsor.com',
+        logoUrl: 'https://fakeimg.pl/200x100/aaaaaa/ffffff?text=DemoCo',
+        createdAt: new Date(),
+      };
+      const demoSponsor2: SponsorDto = {
+        id: 'sponsor-demo-2',
+        name: 'Second Brand',
+        contactEmail: 'info@secondbrand.net',
+        websiteUrl: 'https://secondbrand.net',
+        logoUrl: 'https://fakeimg.pl/200x100/cccccc/ffffff?text=Brand2',
+        createdAt: new Date(Date.now() - 86400000 * 5),
+      };
+      sponsors.set(demoSponsor1.id, demoSponsor1);
+      sponsors.set(demoSponsor2.id, demoSponsor2);
+    }
+  }
+
+  getEntitySponsorshipPricing(): Promise<GetEntitySponsorshipPricingResultDto> {
+    // This logic relies on external factors (e.g., pricing configuration, entity type)
+    // For now, return mock data
+    return Promise.resolve({
+      pricing: [
+        { id: 'tier-bronze', level: 'Bronze', price: 100, currency: 'USD' },
+        { id: 'tier-silver', level: 'Silver', price: 250, currency: 'USD' },
+        { id: 'tier-gold', level: 'Gold', price: 500, currency: 'USD' },
+      ],
+    });
+  }
+
+  async getSponsors(): Promise<GetSponsorsOutput> {
+    return { sponsors: Array.from(sponsors.values()) };
+  }
+
+  async createSponsor(input: CreateSponsorInput): Promise<CreateSponsorOutput> {
+    const id = `sponsor-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    const newSponsor: SponsorDto = {
+      id,
+      name: input.name,
+      contactEmail: input.contactEmail,
+      websiteUrl: input.websiteUrl,
+      logoUrl: input.logoUrl,
+      createdAt: new Date(),
+    };
+    sponsors.set(id, newSponsor);
+    return { sponsor: newSponsor };
+  }
+
+  async getSponsorDashboard(params: GetSponsorDashboardQueryParams): Promise<SponsorDashboardDTO | null> {
+    const { sponsorId } = params;
+
+    const sponsor = sponsors.get(sponsorId); 
+    if (!sponsor) {
+      return null;
+    }
+
+    // Simplified mock data for dashboard metrics and sponsored leagues
+    const metrics: SponsorDashboardMetricsDTO = {
+      impressions: 10000,
+      impressionsChange: 12.5,
+      uniqueViewers: 7000,
+      viewersChange: 8.3,
+      races: 50,
+      drivers: 100,
+      exposure: 75,
+      exposureChange: 5.2,
+    };
+
+    const sponsoredLeagues: SponsoredLeagueDTO[] = [
+      { id: 'league-1', name: 'League 1', tier: 'main', drivers: 50, races: 10, impressions: 5000, status: 'active' },
+      { id: 'league-2', name: 'League 2', tier: 'secondary', drivers: 30, races: 5, impressions: 1500, status: 'upcoming' }, 
+    ];
+
+    const investment: SponsorDashboardInvestmentDTO = {
+      activeSponsorships: 2,
+      totalInvestment: 5000,
+      costPerThousandViews: 0.5,
+    };
+
+    return {
+      sponsorId,
+      sponsorName: sponsor.name,
+      metrics,
+      sponsoredLeagues,
+      investment,
+    };
+  }
+
+  async getSponsorSponsorships(params: GetSponsorSponsorshipsQueryParams): Promise<SponsorSponsorshipsDTO | null> {
+    const { sponsorId } = params;
+
+    const sponsor = sponsors.get(sponsorId); 
+    if (!sponsor) {
+      return null;
+    };
+
+    const sponsorshipDetails: SponsorshipDetailDTO[] = [
+      { 
+        id: 'sponsorship-1', 
+        leagueId: 'league-1', 
+        leagueName: 'League 1', 
+        seasonId: 'season-1', 
+        seasonName: 'Season 1', 
+        seasonStartDate: new Date('2025-01-01'),
+        seasonEndDate: new Date('2025-12-31'),
+        tier: 'main', 
+        status: 'active', 
+        pricing: { amount: 1000, currency: 'USD' },
+        platformFee: { amount: 100, currency: 'USD' },
+        netAmount: { amount: 900, currency: 'USD' },
+        metrics: { drivers: 50, races: 10, completedRaces: 8, impressions: 5000 },
+        createdAt: new Date('2024-12-01'),
+        activatedAt: new Date('2025-01-01'),
+      },
+      { 
+        id: 'sponsorship-2', 
+        leagueId: 'league-2', 
+        leagueName: 'League 2', 
+        seasonId: 'season-2', 
+        seasonName: 'Season 2', 
+        tier: 'secondary', 
+        status: 'pending', 
+        pricing: { amount: 500, currency: 'USD' },
+        platformFee: { amount: 50, currency: 'USD' },
+        netAmount: { amount: 450, currency: 'USD' },
+        metrics: { drivers: 30, races: 5, completedRaces: 0, impressions: 0 },
+        createdAt: new Date('2025-03-15'),
+      },
+    ];
+
+    const totalInvestment = sponsorshipDetails.reduce((sum, s) => sum + s.pricing.amount, 0);
+    const totalPlatformFees = sponsorshipDetails.reduce((sum, s) => sum + s.platformFee.amount, 0);
+    const activeSponsorships = sponsorshipDetails.filter(s => s.status === 'active').length;
+
+    return {
+      sponsorId,
+      sponsorName: sponsor.name,
+      sponsorships: sponsorshipDetails,
+      summary: {
+        totalSponsorships: sponsorshipDetails.length,
+        activeSponsorships,
+        totalInvestment,
+        totalPlatformFees,
+        currency: 'USD',
+      },
+    };
+  }
+}

apps/api/src/modules/sponsor/dto/SponsorDto.ts

@@ -0,0 +1,299 @@
+import { ApiProperty } from '@nestjs/swagger';
+import { IsString, IsNotEmpty, IsNumber, IsEnum, IsOptional, IsDate, IsBoolean, IsUrl, IsEmail } from 'class-validator';
+
+export class SponsorshipPricingItemDto {
+  @ApiProperty()
+  @IsString()
+  id: string;
+
+  @ApiProperty()
+  @IsString()
+  level: string;
+
+  @ApiProperty()
+  @IsNumber()
+  price: number;
+
+  @ApiProperty()
+  @IsString()
+  currency: string;
+}
+
+export class GetEntitySponsorshipPricingResultDto {
+  @ApiProperty({ type: [SponsorshipPricingItemDto] })
+  pricing: SponsorshipPricingItemDto[];
+}
+
+export class SponsorDto {
+  @ApiProperty()
+  @IsString()
+  id: string;
+
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @ApiProperty()
+  @IsString()
+  @IsEmail()
+  @IsNotEmpty()
+  contactEmail: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  @IsUrl()
+  websiteUrl?: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  @IsUrl()
+  logoUrl?: string;
+
+  @ApiProperty()
+  @IsDate()
+  createdAt: Date;
+}
+
+export class GetSponsorsOutput {
+  @ApiProperty({ type: [SponsorDto] })
+  sponsors: SponsorDto[];
+}
+
+export class CreateSponsorInput {
+  @ApiProperty()
+  @IsString()
+  @IsNotEmpty()
+  name: string;
+
+  @ApiProperty()
+  @IsEmail()
+  @IsNotEmpty()
+  contactEmail: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  @IsUrl()
+  websiteUrl?: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsString()
+  @IsUrl()
+  logoUrl?: string;
+}
+
+export class CreateSponsorOutput {
+  @ApiProperty({ type: SponsorDto })
+  sponsor: SponsorDto;
+}
+
+export class GetSponsorDashboardQueryParams {
+  @ApiProperty()
+  @IsString()
+  sponsorId: string;
+}
+
+export class SponsoredLeagueDTO {
+  @ApiProperty()
+  @IsString()
+  id: string;
+
+  @ApiProperty()
+  @IsString()
+  name: string;
+
+  @ApiProperty({ enum: ['main', 'secondary'] })
+  @IsEnum(['main', 'secondary'])
+  tier: 'main' | 'secondary';
+
+  @ApiProperty()
+  @IsNumber()
+  drivers: number;
+
+  @ApiProperty()
+  @IsNumber()
+  races: number;
+
+  @ApiProperty()
+  @IsNumber()
+  impressions: number;
+
+  @ApiProperty({ enum: ['active', 'upcoming', 'completed'] })
+  @IsEnum(['active', 'upcoming', 'completed'])
+  status: 'active' | 'upcoming' | 'completed';
+}
+
+export class SponsorDashboardMetricsDTO {
+  @ApiProperty()
+  @IsNumber()
+  impressions: number;
+
+  @ApiProperty()
+  @IsNumber()
+  impressionsChange: number;
+
+  @ApiProperty()
+  @IsNumber()
+  uniqueViewers: number;
+
+  @ApiProperty()
+  @IsNumber()
+  viewersChange: number;
+
+  @ApiProperty()
+  @IsNumber()
+  races: number;
+
+  @ApiProperty()
+  @IsNumber()
+  drivers: number;
+
+  @ApiProperty()
+  @IsNumber()
+  exposure: number;
+
+  @ApiProperty()
+  @IsNumber()
+  exposureChange: number;
+}
+
+export class SponsorDashboardInvestmentDTO {
+  @ApiProperty()
+  @IsNumber()
+  activeSponsorships: number;
+
+  @ApiProperty()
+  @IsNumber()
+  totalInvestment: number;
+
+  @ApiProperty()
+  @IsNumber()
+  costPerThousandViews: number;
+}
+
+export class SponsorDashboardDTO {
+  @ApiProperty()
+  @IsString()
+  sponsorId: string;
+
+  @ApiProperty()
+  @IsString()
+  sponsorName: string;
+
+  @ApiProperty({ type: SponsorDashboardMetricsDTO })
+  metrics: SponsorDashboardMetricsDTO;
+
+  @ApiProperty({ type: [SponsoredLeagueDTO] })
+  sponsoredLeagues: SponsoredLeagueDTO[];
+
+  @ApiProperty({ type: SponsorDashboardInvestmentDTO })
+  investment: SponsorDashboardInvestmentDTO;
+}
+
+export class GetSponsorSponsorshipsQueryParams {
+  @ApiProperty()
+  @IsString()
+  sponsorId: string;
+}
+
+export class SponsorshipDetailDTO {
+  @ApiProperty()
+  @IsString()
+  id: string;
+
+  @ApiProperty()
+  @IsString()
+  leagueId: string;
+
+  @ApiProperty()
+  @IsString()
+  leagueName: string;
+
+  @ApiProperty()
+  @IsString()
+  seasonId: string;
+
+  @ApiProperty()
+  @IsString()
+  seasonName: string;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsDate()
+  seasonStartDate?: Date;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsDate()
+  seasonEndDate?: Date;
+
+  @ApiProperty({ enum: ['main', 'secondary'] })
+  @IsEnum(['main', 'secondary'])
+  tier: 'main' | 'secondary';
+
+  @ApiProperty({ enum: ['pending', 'active', 'expired', 'cancelled'] })
+  @IsEnum(['pending', 'active', 'expired', 'cancelled'])
+  status: 'pending' | 'active' | 'expired' | 'cancelled';
+
+  @ApiProperty()
+  pricing: {
+    amount: number;
+    currency: string;
+  };
+
+  @ApiProperty()
+  platformFee: {
+    amount: number;
+    currency: string;
+  };
+
+  @ApiProperty()
+  netAmount: {
+    amount: number;
+    currency: string;
+  };
+
+  @ApiProperty()
+  metrics: {
+    drivers: number;
+    races: number;
+    completedRaces: number;
+    impressions: number;
+  };
+
+  @ApiProperty()
+  createdAt: Date;
+
+  @ApiProperty({ required: false })
+  @IsOptional()
+  @IsDate()
+  activatedAt?: Date;
+}
+
+export class SponsorSponsorshipsDTO {
+  @ApiProperty()
+  @IsString()
+  sponsorId: string;
+
+  @ApiProperty()
+  @IsString()
+  sponsorName: string;
+
+  @ApiProperty({ type: [SponsorshipDetailDTO] })
+  sponsorships: SponsorshipDetailDTO[];
+
+  @ApiProperty()
+  summary: {
+    totalSponsorships: number;
+    activeSponsorships: number;
+    totalInvestment: number;
+    totalPlatformFees: number;
+    currency: string;
+  };
+}
+
+// Add other DTOs for sponsor-related logic as needed