@gotza02/sequential-thinking 2026.2.40 → 2026.2.41

package/dist/tools/sports/core/types.d.ts

@@ -0,0 +1,379 @@
+/**
+ * SPORTS MODULE TYPES
+ * Complete data models and interfaces for the football intelligence system
+ */
+export type Position = 'GK' | 'DF' | 'MF' | 'FW' | 'SUB';
+export type MatchStatus = 'scheduled' | 'live' | 'finished' | 'postponed' | 'cancelled' | 'abandoned';
+export type BetType = 'home' | 'draw' | 'away' | 'over' | 'under' | 'btts' | 'handicap';
+export type KellyVariant = 'full' | 'half' | 'quarter';
+export type QueryType = 'general' | 'h2h' | 'form' | 'news' | 'stats' | 'odds' | 'referee' | 'weather' | 'fatigue' | 'setpieces';
+export type ProviderType = 'api-football' | 'football-data' | 'sports-db' | 'scraper';
+export interface SearchQuery {
+    type: QueryType;
+    query: string;
+    priority: number;
+}
+export interface Score {
+    home: number;
+    away: number;
+    halfTime?: {
+        home: number;
+        away: number;
+    };
+    fullTime?: {
+        home: number;
+        away: number;
+    };
+    extraTime?: {
+        home: number;
+        away: number;
+    };
+    penalties?: {
+        home: number;
+        away: number;
+    };
+}
+export interface Team {
+    id: string;
+    name: string;
+    code?: string;
+    country: string;
+    founded?: number;
+    logo?: string;
+    venue?: string;
+    website?: string;
+    stats?: TeamStats;
+}
+export interface TeamStats {
+    matchesPlayed: number;
+    wins: number;
+    draws: number;
+    losses: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points?: number;
+    position?: number;
+    xG?: number;
+    xGA?: number;
+    xGDiff?: number;
+    possessionAvg?: number;
+    shotsPerGame?: number;
+    shotsOnTargetPerGame?: number;
+    cornersPerGame?: number;
+    foulsPerGame?: number;
+    yellowCardsPerGame?: number;
+    redCardsPerGame?: number;
+    homeStats?: TeamStats;
+    awayStats?: TeamStats;
+    form?: 'W' | 'D' | 'L'[];
+}
+export interface Player {
+    id: string;
+    name: string;
+    age?: number;
+    nationality: string;
+    position: Position;
+    number?: number;
+    photo?: string;
+    team?: Team;
+    stats?: PlayerStats;
+    marketValue?: number;
+    injured?: boolean;
+    suspended?: boolean;
+}
+export interface PlayerStats {
+    season?: string;
+    league?: string;
+    matches: number;
+    starts: number;
+    minutes: number;
+    goals: number;
+    assists: number;
+    goalsPlusAssists?: number;
+    shots?: number;
+    shotsOnTarget?: number;
+    xG?: number;
+    xA?: number;
+    xGPlusXA?: number;
+    yellowCards: number;
+    redCards: number;
+    tackles?: number;
+    interceptions?: number;
+    dribbles?: number;
+    dribblesWon?: number;
+    passes?: number;
+    passAccuracy?: number;
+    keyPasses?: number;
+    aerialDuels?: number;
+    aerialDuelsWon?: number;
+}
+export interface League {
+    id: string;
+    name: string;
+    country: string;
+    code?: string;
+    season?: string;
+    type?: 'league' | 'cup' | 'playoff';
+    logo?: string;
+    standings?: TableEntry[];
+    topScorers?: PlayerStats[];
+    topAssists?: PlayerStats[];
+}
+export interface TableEntry {
+    position: number;
+    team: Team;
+    played: number;
+    won: number;
+    drawn: number;
+    lost: number;
+    goalsFor: number;
+    goalsAgainst: number;
+    goalDifference: number;
+    points: number;
+    form?: 'W' | 'D' | 'L'[];
+    homeRecord?: {
+        played: number;
+        won: number;
+        drawn: number;
+        lost: number;
+        goalsFor: number;
+        against: number;
+    };
+    awayRecord?: {
+        played: number;
+        won: number;
+        drawn: number;
+        lost: number;
+        goalsFor: number;
+        against: number;
+    };
+    lastFive?: {
+        result: 'W' | 'D' | 'L';
+        for: number;
+        against: number;
+    }[];
+}
+export interface Match {
+    id: string;
+    homeTeam: Team;
+    awayTeam: Team;
+    league: League;
+    date: Date;
+    status: MatchStatus;
+    venue?: string;
+    referee?: Referee;
+    score?: Score;
+    minute?: number;
+    extraMinute?: number;
+    half?: 'H1' | 'H2' | 'HT' | 'ET' | 'P';
+    odds?: MatchOdds;
+    attendance?: number;
+    weather?: WeatherInfo;
+    homeLineup?: Player[];
+    awayLineup?: Player[];
+    homeSubstitutes?: Player[];
+    awaySubstitutes?: Player[];
+    events?: MatchEvent[];
+}
+export interface MatchOdds {
+    homeWin: number;
+    draw: number;
+    awayWin: number;
+    asianHandicap?: {
+        home: number;
+        away: number;
+        line: number;
+    };
+    overUnder?: {
+        line: number;
+        over: number;
+        under: number;
+    };
+    btts?: {
+        yes: number;
+        no: number;
+    };
+    provider: string;
+    timestamp: Date;
+    opening?: MatchOdds;
+}
+export interface MatchEvent {
+    id: string;
+    type: 'goal' | 'card' | 'substitution' | 'var' | 'injury' | 'whistle';
+    team: 'home' | 'away';
+    player?: Player;
+    assistPlayer?: Player;
+    minute: number;
+    extraMinute?: number;
+    detail?: string;
+}
+export interface Referee {
+    id: string;
+    name: string;
+    country: string;
+    age?: number;
+    photo?: string;
+    stats: RefereeStats;
+}
+export interface RefereeStats {
+    matches: number;
+    yellowCardsAvg: number;
+    redCardsAvg: number;
+    penaltiesAvg: number;
+    homeWinRate: number;
+    awayWinRate: number;
+    drawRate: number;
+    avgGoals: number;
+}
+export interface ValueBet {
+    match: Match;
+    betType: BetType;
+    fairOdds: number;
+    marketOdds: number;
+    value: number;
+    confidence: number;
+    kellyFraction?: number;
+    recommendedStake?: number;
+    reasoning: string;
+}
+export interface WeatherInfo {
+    temperature?: number;
+    condition?: string;
+    humidity?: number;
+    windSpeed?: number;
+    windDirection?: string;
+    precipitation?: number;
+}
+export interface TransferNews {
+    id: string;
+    player: Player;
+    fromTeam?: Team;
+    toTeam?: Team;
+    type: 'rumor' | 'confirmed' | 'loan' | 'free_transfer';
+    fee?: number;
+    feeFormatted?: string;
+    source: string;
+    timestamp: Date;
+    reliability?: 'low' | 'medium' | 'high';
+}
+export interface HeadToHead {
+    homeTeam: Team;
+    awayTeam: Team;
+    totalMatches: number;
+    homeWins: number;
+    draws: number;
+    awayWins: number;
+    homeGoals: number;
+    awayGoals: number;
+    recentMatches: Match[];
+}
+export interface Formation {
+    name: string;
+    defenders: number;
+    midfielders: number;
+    forwards: number;
+}
+export interface TacticalAnalysis {
+    homeFormation?: Formation;
+    awayFormation?: Formation;
+    homeStyle?: string;
+    awayStyle?: string;
+    keyBattles?: TacticalBattle[];
+    strengths?: {
+        home: string[];
+        away: string[];
+    };
+    weaknesses?: {
+        home: string[];
+        away: string[];
+    };
+}
+export interface TacticalBattle {
+    area: string;
+    homePlayer?: Player;
+    awayPlayer?: Player;
+    analysis: string;
+    advantage?: 'home' | 'away' | 'neutral';
+}
+export interface FatigueInfo {
+    team: Team;
+    daysSinceLastMatch: number;
+    lastMatch?: Match;
+    upcomingMatches?: Match[];
+    travelDistance?: number;
+    squadDepth?: number;
+    injuries: number;
+    suspensions: number;
+    fatigueScore: number;
+}
+export interface SetPieceStats {
+    team: Team;
+    cornersPerGame: number;
+    cornersConcededPerGame: number;
+    freeKicksPerGame: number;
+    goalsFromCorners: number;
+    goalsFromFreeKicks: number;
+    concededFromCorners: number;
+    concededFromFreeKicks: number;
+    aerialDuelsWon: number;
+    aerialDuelsTotal: number;
+    aerialWinRate: number;
+}
+export interface WatchlistAlert {
+    id: string;
+    type: 'match' | 'odds' | 'news' | 'injury';
+    target: string;
+    condition: string;
+    triggered: boolean;
+    createdAt: Date;
+    triggeredAt?: Date;
+    data?: any;
+}
+export interface CacheEntry<T = any> {
+    key: string;
+    data: T;
+    timestamp: number;
+    ttl: number;
+    hits: number;
+}
+export interface APIResponse<T = any> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    provider?: ProviderType;
+    cached?: boolean;
+    rateLimited?: boolean;
+}
+export interface ProviderStatus {
+    name: ProviderType;
+    available: boolean;
+    quotaRemaining: number;
+    quotaLimit: number;
+    rateLimitUntil?: Date;
+    lastCall?: Date;
+}
+export interface ComparisonResult {
+    teamA: Team;
+    teamB: Team;
+    metrics: ComparisonMetric[];
+    winner?: 'A' | 'B' | 'draw';
+    summary: string;
+}
+export interface ComparisonMetric {
+    name: string;
+    teamAValue: number | string;
+    teamBValue: number | string;
+    winner?: 'A' | 'B' | 'draw';
+    importance: 'high' | 'medium' | 'low';
+    analysis?: string;
+}
+export interface LiveScoreUpdate {
+    matchId: string;
+    homeTeam: string;
+    awayTeam: string;
+    score: Score;
+    minute: number;
+    events: MatchEvent[];
+    timestamp: Date;
+}

package/dist/tools/sports/core/types.js

@@ -0,0 +1,5 @@
+/**
+ * SPORTS MODULE TYPES
+ * Complete data models and interfaces for the football intelligence system
+ */
+export {};

package/dist/tools/sports/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * SPORTS MODULE INDEX
+ * Main entry point - Exports all sports functionality
+ */
+export * from './core/constants.js';
+export * from './core/types.js';
+export * from './core/cache.js';
+export * from './core/base.js';
+export * from './providers/api.js';
+export * from './providers/scraper.js';
+export * from './providers/search.js';
+export { getGlobalCache, resetGlobalCache, CacheService, } from './core/cache.js';
+export { createAPIProvider, } from './providers/api.js';
+export { getSearchProvider, resetSearchProvider, SearchProvider, } from './providers/search.js';
+export { scrapeMatchContent, findBestMatchUrl, } from './providers/scraper.js';
+export * from './utils/calculator.js';
+export * from './utils/formatter.js';
+export { formatMatchesTable, formatComparisonResult, formatPlayerStats, formatMatchRow, formatScore, formatMatchStatus, formatHeadToHead, } from './utils/formatter.js';
+/**
+ * Initialize the sports module with custom configuration
+ */
+export declare function initializeSportsModule(config?: {
+    cachePath?: string;
+    cacheTTL?: number;
+}): Promise<void>;
+/**
+ * Get sports module status
+ */
+export declare function getSportsModuleStatus(): {
+    version: string;
+    providers: string[];
+    searchProviders: string[];
+    cacheEnabled: boolean;
+};

package/dist/tools/sports/index.js

@@ -0,0 +1,50 @@
+/**
+ * SPORTS MODULE INDEX
+ * Main entry point - Exports all sports functionality
+ */
+// ============= Core Exports =============
+export * from './core/constants.js';
+export * from './core/types.js';
+export * from './core/cache.js';
+export * from './core/base.js';
+// ============= Provider Exports =============
+export * from './providers/api.js';
+export * from './providers/scraper.js';
+export * from './providers/search.js';
+// Re-exports for convenience
+export { getGlobalCache, resetGlobalCache, CacheService, } from './core/cache.js';
+export { createAPIProvider, } from './providers/api.js';
+export { getSearchProvider, resetSearchProvider, SearchProvider, } from './providers/search.js';
+export { scrapeMatchContent, findBestMatchUrl, } from './providers/scraper.js';
+// ============= Utility Exports =============
+export * from './utils/calculator.js';
+export * from './utils/formatter.js';
+// Re-export specific utility functions for convenience
+export { formatMatchesTable, formatComparisonResult, formatPlayerStats, formatMatchRow, formatScore, formatMatchStatus, formatHeadToHead, } from './utils/formatter.js';
+// ============= Utility Functions =============
+/**
+ * Initialize the sports module with custom configuration
+ */
+export async function initializeSportsModule(config) {
+    const { getGlobalCache } = await import('./core/cache.js');
+    // Initialize cache with config if provided
+    if (config?.cachePath || config?.cacheTTL) {
+        // Cache is already initialized, but we could add reconfiguration here
+    }
+}
+/**
+ * Get sports module status
+ */
+export function getSportsModuleStatus() {
+    const { MODULE_INFO } = require('./core/constants.js');
+    const apiProvider = require('./providers/api.js').createAPIProvider();
+    const searchProvider = require('./providers/search.js').getSearchProvider();
+    return {
+        version: MODULE_INFO.VERSION,
+        providers: apiProvider.getStatus().available
+            ? ['api-football', 'football-data', 'sports-db'].filter((p) => process.env[`${p.replace('-', '_').toUpperCase()}_KEY`])
+            : [],
+        searchProviders: searchProvider.getAvailableProviders(),
+        cacheEnabled: true,
+    };
+}

package/dist/tools/sports/providers/api.d.ts

@@ -0,0 +1,73 @@
+/**
+ * SPORTS MODULE API PROVIDERS
+ * Concrete implementations of football API providers
+ */
+import { Match, Team, Player, TableEntry, APIResponse } from '../core/types.js';
+import { APIProviderBase, FallbackProvider } from '../core/base.js';
+/**
+ * API-Football Provider (via RapidAPI)
+ * Documentation: https://rapidapi.com/api-sports/api/api-football
+ */
+export declare class APIFootballProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(leagueId?: string): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string, season?: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatch;
+    private transformTeam;
+    private transformPlayer;
+    private transformTableEntry;
+    private mapStatus;
+    private mapPosition;
+}
+/**
+ * Football-Data.org Provider
+ * Documentation: https://www.football-data.org/
+ */
+export declare class FootballDataProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(leagueId?: string): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string, season?: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatchFD;
+    private transformTeamFD;
+    private transformTableEntryFD;
+    private mapStatusFD;
+}
+/**
+ * TheSportsDB Provider
+ * Documentation: https://www.thesportsdb.com/api.php
+ */
+export declare class SportsDBProvider extends APIProviderBase {
+    constructor();
+    protected getAuthHeaders(): Record<string, string>;
+    protected transformResponse<T>(data: any): T;
+    getMatch(matchId: string): Promise<APIResponse<Match>>;
+    getLiveMatches(): Promise<APIResponse<Match[]>>;
+    getStandings(leagueId: string): Promise<APIResponse<TableEntry[]>>;
+    getTeam(teamId: string): Promise<APIResponse<Team>>;
+    getPlayer(playerId: string): Promise<APIResponse<Player>>;
+    searchTeams(query: string): Promise<APIResponse<Team[]>>;
+    searchPlayers(query: string): Promise<APIResponse<Player[]>>;
+    private transformMatchDB;
+    private transformTeamDB;
+    private transformPlayerDB;
+    private transformTableEntryDB;
+    private mapPositionDB;
+}
+/**
+ * Create a fallback provider with all available API providers
+ */
+export declare function createAPIProvider(): FallbackProvider;