pro-clubs-shared-dtos 3.15.21 → 3.16.0

package/README.md

@@ -0,0 +1,20 @@
+# Introduction 
+TODO: Give a short introduction of your project. Let this section explain the objectives or the motivation behind this project. 
+
+# Getting Started
+TODO: Guide users through getting your code up and running on their own system. In this section you can talk about:
+1.	Installation process
+2.	Software dependencies
+3.	Latest releases
+4.	API references
+
+# Build and Test
+TODO: Describe and show how to build your code and run the tests. 
+
+# Contribute
+TODO: Explain how other users and developers can contribute to make your code better. 
+
+If you want to learn more about creating good readme files then refer the following [guidelines](https://docs.microsoft.com/en-us/azure/devops/repos/git/create-a-readme?view=azure-devops). You can also seek inspiration from the below readme files:
+- [ASP.NET Core](https://github.com/aspnet/Home)
+- [Visual Studio Code](https://github.com/Microsoft/vscode)
+- [Chakra Core](https://github.com/Microsoft/ChakraCore)

package/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared DTOs - Central export point for all data transfer objects
+ */
+
+export * from './seasonal-stats.dto';

package/package.json

@@ -1,32 +1,21 @@
 {
   "name": "pro-clubs-shared-dtos",
-  "version": "3.15.21",
-  "description": "Shared DTOs for Pro Clubs Manager Client and Server",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "version": "3.16.0",
+  "description": "Shared DTOs for ProClubs Stats applications",
+  "main": "index.ts",
+  "types": "index.ts",
   "scripts": {
-    "build": "tsc",
-    "watch": "tsc --watch",
-    "clean": "rm -rf dist"
+    "publish": "npm publish --access public"
   },
   "keywords": [
-    "pro-clubs",
     "dtos",
     "shared",
-    "types",
-    "interfaces",
-    "models"
+    "pro-clubs",
+    "typescript"
   ],
-  "author": "",
-  "license": "ISC",
-  "dependencies": {
-    "mongoose": "^7.0.0 || ^8.0.0"
-  },
-  "peerDependencies": {
-    "mongoose": "^7.0.0 || ^8.0.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.3.2",
-    "@types/node": "^20.0.0"
+  "author": "ProClubs Manager",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
   }
 }

package/seasonal-stats.dto.ts

@@ -0,0 +1,53 @@
+/**
+ * Seasonal Statistics DTOs
+ * Data transfer objects for seasonal stats snapshots
+ */
+
+export interface PlayerSeasonStat {
+  playerId: string;
+  playerName: string;
+  playerImgUrl?: string;
+  teamName?: string;
+  position?: string;
+  rank: number;
+  value: number;
+  gamesPlayed: number;
+  perGame?: number;
+}
+
+export interface SeasonSnapshot {
+  _id?: string;
+  leagueId: string;
+  seasonNumber: number;
+  leagueName?: string;
+  topScorers: PlayerSeasonStat[];
+  topAssisters: PlayerSeasonStat[];
+  topContributors: PlayerSeasonStat[];
+  topAverageRating: PlayerSeasonStat[];
+  topShots: PlayerSeasonStat[];
+  topSaves: PlayerSeasonStat[];
+  topCleanSheets: PlayerSeasonStat[];
+  topPasses: PlayerSeasonStat[];
+  topPassSuccessRate: PlayerSeasonStat[];
+  topTackles: PlayerSeasonStat[];
+  topTackleSuccessRate: PlayerSeasonStat[];
+  topShotsOnTarget: PlayerSeasonStat[];
+  topShotsOffTarget: PlayerSeasonStat[];
+  topShootingAccuracy: PlayerSeasonStat[];
+  topInterceptions: PlayerSeasonStat[];
+  topFoulsCommitted: PlayerSeasonStat[];
+  topYellowCards: PlayerSeasonStat[];
+  topRedCards: PlayerSeasonStat[];
+  topPlayerOfTheMatch: PlayerSeasonStat[];
+  builtAt?: Date;
+  builtBy?: string;
+  createdAt?: Date;
+  updatedAt?: Date;
+}
+
+export interface SeasonSnapshotResponse {
+  success: boolean;
+  data?: SeasonSnapshot;
+  metric?: string;
+  error?: string;
+}

package/INTEGRATION_GUIDE.md

@@ -1,237 +0,0 @@
-# Integration Guide - Using @pro-clubs-manager/shared-dtos
-
-## Overview
-This guide explains how to integrate the shared-dtos package in both the client and server applications.
-
-## Installation
-
-### Step 1: Publish the Package
-Once the shared-dtos package is ready, publish it to npm:
-
-```bash
-cd shared-dtos
-npm publish
-```
-
-### Step 2: Install in Client (ProClubsStatsClient)
-
-Update `ProClubsStatsClient/package.json`:
-```json
-{
-  "dependencies": {
-    "@pro-clubs-manager/shared-dtos": "^3.0.0"
-  }
-}
-```
-
-Then run:
-```bash
-npm install
-```
-
-### Step 3: Install in Server (ProClubsStatsServer)
-
-Update `ProClubsStatsServer/package.json`:
-```json
-{
-  "dependencies": {
-    "@pro-clubs-manager/shared-dtos": "^3.0.0"
-  }
-}
-```
-
-Then run:
-```bash
-npm install
-```
-
-## Usage Patterns
-
-### Client (Angular)
-
-```typescript
-import {
-  IUser,
-  ITeam,
-  IPlayer,
-  IGame,
-  EXTENDED_GAME_STATUS,
-  EVENT_TYPE
-} from '@pro-clubs-manager/shared-dtos';
-
-// Use in services
-@Injectable()
-export class PlayerService {
-  getPlayer(id: string): Observable<IPlayer> {
-    return this.http.get<IPlayer>(`/api/players/${id}`);
-  }
-
-  getPlayerTeams(playerId: string): Observable<ITeam[]> {
-    return this.http.get<ITeam[]>(`/api/players/${playerId}/teams`);
-  }
-}
-
-// Use in components
-export class TeamComponent {
-  team: ITeam | null = null;
-  players: IPlayer[] = [];
-
-  constructor(private teamService: TeamService) {}
-
-  loadTeam(teamId: string): void {
-    this.teamService.getTeam(teamId).subscribe(team => {
-      this.team = team;
-    });
-  }
-}
-```
-
-### Server (Express/Node)
-
-```typescript
-import {
-  IUser,
-  ITeam,
-  IPlayer,
-  AddGameData,
-  EXTENDED_GAME_STATUS
-} from '@pro-clubs-manager/shared-dtos';
-
-// Use in services
-@injectable()
-export class PlayerService {
-  async getPlayer(id: string): Promise<IPlayer> {
-    return Player.findById(id);
-  }
-
-  async createPlayer(data: any): Promise<IPlayer> {
-    const player = new Player(data);
-    return player.save();
-  }
-}
-
-// Use in controllers
-@Controller('/players')
-export class PlayerController {
-  @Get(':id')
-  async getPlayer(@Param('id') id: string): Promise<IPlayer> {
-    return this.playerService.getPlayer(id);
-  }
-}
-
-// Use in repositories
-export class PlayerRepository {
-  async findByTeam(teamId: string): Promise<IPlayer[]> {
-    return Player.find({ team: teamId });
-  }
-}
-```
-
-## Import Organization
-
-### Group imports by category
-
-```typescript
-// Models
-import {
-  IUser,
-  ITeam,
-  IPlayer,
-  IGame,
-  ILeague
-} from '@pro-clubs-manager/shared-dtos';
-
-// Types
-import {
-  IPlayerStats,
-  ITeamSeason,
-  PlayerGamePerformance,
-  PlayoffDetails,
-  TeamWithPlayers
-} from '@pro-clubs-manager/shared-dtos';
-
-// Enums
-import {
-  EXTENDED_GAME_STATUS,
-  GAME_STATUS,
-  EVENT_TYPE,
-  EVENT_STATUS,
-  PLAYOFF_STAGE
-} from '@pro-clubs-manager/shared-dtos';
-```
-
-## Breaking Changes and Compatibility
-
-### Version 3.0.0
-- Initial release as centralized package
-- Contains all model interfaces
-- Mongoose is now a dependency
-
-### Backward Compatibility
-- All interfaces remain exactly the same as before
-- No property names or types were changed
-- Existing code should work with just import path changes
-
-## Migration Checklist
-
-- [ ] Publish @pro-clubs-manager/shared-dtos to npm
-- [ ] Install package in ProClubsStatsServer
-- [ ] Update server imports:
-  - [ ] Replace `import from '../models/*'` with shared-dtos (for interfaces only)
-  - [ ] Keep Mongoose model imports local
-  - [ ] Update interface imports in interfaces folder
-- [ ] Install package in ProClubsStatsClient
-- [ ] Update client imports:
-  - [ ] Replace all model imports with shared-dtos
-  - [ ] Update service return types
-  - [ ] Update component model properties
-- [ ] Run tests
-- [ ] Update documentation
-
-## Common Issues and Solutions
-
-### Issue: "Cannot find module '@pro-clubs-manager/shared-dtos'"
-**Solution**: 
-1. Ensure npm install was run
-2. Check package.json has the correct version
-3. Verify npm cache: `npm cache clean --force`
-
-### Issue: "Module has no exported member 'TypeName'"
-**Solution**:
-1. Check the type exists in shared-dtos/src/index.ts
-2. Verify the export path in the index file
-3. Run `npm run build` in shared-dtos folder to regenerate
-
-### Issue: Type mismatches in strict mode
-**Solution**:
-1. Update tsconfig.json strictNullChecks setting
-2. Add proper null checks for optional fields
-3. Use type guards for safety
-
-## Version Management
-
-### Future Updates
-- Bug fixes: Patch version (3.0.x)
-- New models/types: Minor version (3.1.0)
-- Breaking changes: Major version (4.0.0)
-
-Use npm version commands:
-```bash
-npm version patch   # 3.0.0 -> 3.0.1
-npm version minor   # 3.0.0 -> 3.1.0
-npm version major   # 3.0.0 -> 4.0.0
-```
-
-## FAQ
-
-**Q: Should I include the shared-dtos source in version control?**
-A: No, it will be installed via npm. Only include it in the monorepo for development purposes.
-
-**Q: Can I use shared-dtos in other projects?**
-A: Yes! Once published to npm, any TypeScript project can use it.
-
-**Q: How do I add new types to shared-dtos?**
-A: Add the type definition to shared-dtos/src, update index.ts exports, rebuild, and publish a new version.
-
-**Q: Is there a changelog?**
-A: Check MIGRATION_SUMMARY.md for the initial release info.

package/dist/config/player-stats-config.d.ts

@@ -1,23 +0,0 @@
-export interface PlayerStatConfig {
-    key: string;
-    label: string;
-    category: 'basic' | 'shooting' | 'passing' | 'defensive' | 'goalkeeper' | 'disciplinary' | 'derived';
-    format?: 'number' | 'percentage' | 'decimal';
-    decimals?: number;
-    suffix?: string;
-    description?: string;
-    icon?: string;
-    displayOrder?: number;
-}
-export interface StatCategoryConfig {
-    id: string;
-    label: string;
-    icon: string;
-    description: string;
-    stats: PlayerStatConfig[];
-}
-export declare const PLAYER_STAT_CONFIGS: Record<string, PlayerStatConfig>;
-export declare const PLAYER_STATS_BY_CATEGORY: Record<string, StatCategoryConfig>;
-export declare function getStatsForPosition(position: string): PlayerStatConfig[];
-export declare function getCategoriesForPosition(position: string): StatCategoryConfig[];
-//# sourceMappingURL=player-stats-config.d.ts.map

package/dist/config/player-stats-config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"player-stats-config.d.ts","sourceRoot":"","sources":["../../src/config/player-stats-config.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;IACrG,MAAM,CAAC,EAAE,QAAQ,GAAG,YAAY,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAMD,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CA8PhE,CAAC;AAKF,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAkFvE,CAAC;AAKF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAexE;AAKD,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAS/E"}