@tryline/interface 1.0.0

package/dist/api/nrl/index.js

@@ -0,0 +1,6 @@
+export * from "./matches";
+export * from "./ladder";
+export * from "./stats";
+export * from "./analytics";
+export * from "./team-player-stats";
+export * from "./teams";

package/dist/api/nrl/ladder.d.ts

@@ -0,0 +1,67 @@
+import { MatchTeam } from "../shared";
+/**
+ * NRL Ladder API types
+ * Shared between backend and frontend for ladder-related operations
+ */
+/**
+ * Performance outcome for a match
+ */
+export type PerformanceOutcome = "win" | "loss" | "draw";
+/**
+ * Performance location for a match
+ */
+export type PerformanceLocation = "home" | "away";
+/**
+ * Recent performance record for a team
+ * Represents outcome and location of a single completed match
+ */
+export interface TeamRecentPerformance {
+    outcome: PerformanceOutcome;
+    location: PerformanceLocation;
+}
+/**
+ * Complete team information for ladder display
+ * Includes team details and recent performance history
+ */
+export interface TeamLadderInfo {
+    team_details: MatchTeam;
+    team_recent_performance: TeamRecentPerformance[];
+}
+/**
+ * Ladder ranking entry for a single team in a specific round
+ * Contains all ladder statistics for the team at that point in the season
+ */
+export interface LadderTeamRanking {
+    position: number;
+    team_id: number;
+    played: number;
+    points: number;
+    wins: number;
+    drawn: number;
+    lost: number;
+    byes: number;
+    for_points: number;
+    against_points: number;
+    diff: number;
+    home_record: string;
+    away_record: string;
+}
+/**
+ * Ladder standings for a single round
+ * Contains round information and team rankings for that round
+ */
+export interface LadderRound {
+    round: number;
+    round_text: string;
+    team_rankings: LadderTeamRanking[];
+}
+/**
+ * Response type for GET /nrl/ladder?season_id={season_id}
+ * Returns ladder data grouped by rounds and team information
+ * If no data exists, rounds will be empty array and teams will be null
+ */
+export interface GetLadderResponse {
+    rounds: LadderRound[];
+    teams: Record<number, TeamLadderInfo> | null;
+}
+//# sourceMappingURL=ladder.d.ts.map

package/dist/api/nrl/ladder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ladder.d.ts","sourceRoot":"","sources":["../../../src/api/nrl/ladder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,kBAAkB,CAAC;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,SAAS,CAAC;IACxB,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;CAClD;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI,CAAC;CAC9C"}

package/dist/api/nrl/ladder.js

@@ -0,0 +1 @@
+export {};

package/dist/api/nrl/matches.d.ts

@@ -0,0 +1,297 @@
+import { MatchTeam, MatchVenue } from "../shared";
+import { Season } from "../competitions";
+/**
+ * Single NRL match highlight
+ * Contains match info with highlight URL and round information
+ */
+export interface MatchHighlight {
+    match_id: number;
+    datetime: string;
+    status: "completed";
+    slug: string;
+    round_text: string;
+    official_highlights_url: string;
+    home_team: MatchTeam;
+    away_team: MatchTeam;
+}
+/**
+ * Response type for GET /nrl/latest-highlights
+ * Returns array of up to 8 most recent completed NRL matches with highlights
+ */
+export interface GetLatestHighlightsResponse {
+    highlights: MatchHighlight[];
+}
+/**
+ * Team ranking information from the ladder
+ * Contains position and additional stats
+ */
+export interface TeamRanking {
+    rank: number;
+    played: number | null;
+    wins: number | null;
+    drawn: number | null;
+    lost: number | null;
+    byes: number | null;
+    diff: number | null;
+    points: number | null;
+}
+/**
+ * NRL-specific team information extending base MatchTeam
+ * Includes team ranking from the ladder
+ */
+export interface MatchTeamWithRanking extends MatchTeam {
+    ranking: TeamRanking | null;
+}
+/**
+ * Response type for GET /nrl/basic-info/:match_id
+ * Contains comprehensive match data specific to NRL
+ * Returned directly in the data field of ApiResponse
+ */
+export interface GetMatchBasicInfoResponse {
+    match_id: number;
+    slug: string;
+    season: Season;
+    round: number;
+    round_text: string;
+    datetime: string;
+    status: "scheduled" | "live" | "completed" | "postponed" | "cancelled";
+    ground_condition: string | null;
+    official_page_url: string | null;
+    official_highlights_url: string | null;
+    home_team_interview_url: string | null;
+    away_team_interview_url: string | null;
+    weather: string | null;
+    venue: MatchVenue | null;
+    public_broadcast: boolean;
+    home_team: MatchTeamWithRanking;
+    away_team: MatchTeamWithRanking;
+    referee: string | null;
+    analysis: string | null;
+    golden_point: boolean | null;
+    home_team_dotpoints: string[] | null;
+    away_team_dotpoints: string[] | null;
+    update_24h: string | null;
+    update_1h: string | null;
+    home_team_final_score_f: number | null;
+    home_team_final_score_h: number | null;
+    away_team_final_score_f: number | null;
+    away_team_final_score_h: number | null;
+    home_team_possession: string | null;
+    away_team_possession: string | null;
+    scoring_events: ScoringEvent[];
+}
+/**
+ * Try overall location enum
+ */
+export type TryOverallLocation = "left" | "middle" | "right";
+/**
+ * Scoring type enum
+ */
+export type ScoringType = "try" | "conversion" | "penalty_goal" | "field_goal_1pt" | "field_goal_2pt";
+/**
+ * Player information for scoring events
+ * Contains player details plus lineup info (jersey number, captain)
+ */
+export interface ScoringEventPlayer {
+    player_id: number;
+    first_name: string;
+    last_name: string;
+    image_default: string | null;
+    image_headshot: string | null;
+    competition_image_default: string | null;
+    competition_image_headshot: string | null;
+    jersey_number: number;
+    captain: boolean;
+}
+/**
+ * Single NRL scoring event
+ * Contains scoring data with player and positional information
+ */
+export interface ScoringEvent {
+    side: "home" | "away";
+    player: ScoringEventPlayer;
+    sample_offset_s: number;
+    scoring_type: ScoringType;
+    try_score_x: number | null;
+    try_score_y: number | null;
+    break_x: number | null;
+    break_y: number | null;
+    kicking_x: number | null;
+    kicking_y: number | null;
+    kick_successful: boolean | null;
+    try_associated: number | null;
+    try_comments: string | null;
+    try_overall_location: TryOverallLocation | null;
+}
+/**
+ * Single H2H match result
+ * Contains the outcome of a previous match between two teams
+ */
+export interface H2HMatchResult {
+    match_id: number;
+    slug: string;
+    home_team_id: number;
+    home_team_score: number;
+    away_team_id: number;
+    away_team_score: number;
+    winner: "home" | "away" | "draw";
+    round_text: string;
+    season_value: string;
+}
+/**
+ * Response type for GET /nrl/recent-performance-h2h
+ * Returns head-to-head statistics and recent match results between two teams
+ */
+export interface GetH2HResponse {
+    home_team: MatchTeam;
+    away_team: MatchTeam;
+    home_team_wins: number;
+    away_team_wins: number;
+    draws: number;
+    results: H2HMatchResult[];
+}
+/**
+ * Single recent match result for a team's form
+ * Contains the outcome from the perspective of the team
+ */
+export interface TeamRecentFormMatch {
+    match_id: number;
+    slug: string;
+    team_score: number;
+    opponent_score: number;
+    winner: "team" | "opponent" | "draw";
+    opponent_logo: string | null;
+    team_host: "home" | "away";
+}
+/**
+ * Team form data with details and recent performance
+ */
+export interface TeamFormData {
+    details: MatchTeam;
+    recent_performance: TeamRecentFormMatch[];
+}
+/**
+ * Response type for GET /nrl/recent-performance-form
+ * Returns recent form for both teams in the context of the current match
+ */
+export interface GetRecentFormResponse {
+    home_team: TeamFormData;
+    away_team: TeamFormData;
+}
+/**
+ * NRL position definition
+ * Contains both unadjusted (broad) and adjusted (specific) position names
+ */
+export interface Position {
+    position_id: number;
+    unadjusted_position_name: string;
+    short_unadjusted_position_name: string;
+    adjusted_position_name: string;
+    short_adjusted_position_name: string;
+}
+/**
+ * Single lineup entry for a player
+ * Contains position information and player metadata
+ */
+export interface LineupEntry {
+    lineup_entry_id: number;
+    player_id: number;
+    jersey_number: number;
+    captain: boolean;
+    original_position_id: number;
+    updated_position_id: number | null;
+    details: unknown[];
+}
+/**
+ * Team lineup data
+ * Contains team identification, team colour, and all player entries
+ */
+export interface LineupTeam {
+    team_id: number;
+    side: "home" | "away";
+    colour: string;
+    entries: LineupEntry[];
+}
+/**
+ * Player details for lineup display
+ * Contains both global and competition-specific images
+ */
+export interface LineupPlayer {
+    player_id: number;
+    slug: string;
+    first_name: string;
+    last_name: string;
+    image_headshot: string | null;
+    image_default: string | null;
+    competition_image_headshot: string | null;
+    competition_image_default: string | null;
+}
+/**
+ * Response type for GET /nrl/lineup/:match_id
+ * Returns comprehensive lineup information for both teams in an NRL match
+ *
+ * positions_adjusted is true only when ALL players have updated_position_id != null
+ * If any player has updated_position_id = null, positions_adjusted is false
+ * This acts as a validation guard for frontend rendering logic
+ *
+ * When lineup is not announced yet, entries arrays will be empty and players object will be {}
+ */
+export interface GetLineupResponse {
+    match_id: number;
+    competition_id: number;
+    positions_adjusted: boolean;
+    positions: Position[];
+    teams: LineupTeam[];
+    players: Record<string, LineupPlayer>;
+}
+/**
+ * Season information for stats filter context (with round ranges)
+ * Used by scoring-by-position, scoring-map, and overs-unders filters
+ */
+export interface StatsFilterContextSeason {
+    season_id: number;
+    value: string;
+    min_round: number;
+    max_round: number;
+}
+/**
+ * Season information for analytics filter context (no round ranges)
+ * Used by analytics-scoring and analytics-stats filters
+ * Analytics data is available for all seasons
+ */
+export interface AnalyticsFilterContextSeason {
+    season_id: number;
+    value: string;
+}
+/**
+ * Filter configuration for stats endpoints (scoring-by-position, scoring-map, overs-unders)
+ */
+export interface StatsFilterContextFilter {
+    filter_id: "scoring-by-position" | "scoring-map" | "overs-unders";
+    seasons: StatsFilterContextSeason[];
+}
+/**
+ * Filter configuration for analytics endpoints (analytics-scoring, analytics-stats)
+ */
+export interface AnalyticsFilterContextFilter {
+    filter_id: "analytics-scoring" | "analytics-stats";
+    seasons: AnalyticsFilterContextSeason[];
+}
+/**
+ * Union type for all filter configurations
+ */
+export type FilterContextFilter = StatsFilterContextFilter | AnalyticsFilterContextFilter;
+/**
+ * Response type for GET /nrl/matches/filter-context/:match_id
+ * Returns available seasons and rounds for each filter type
+ * - Stats filters: Include min_round/max_round based on data availability
+ * - Analytics filters: Include all seasons (no round ranges needed)
+ */
+export interface GetMatchFilterContextResponse {
+    match_id: number;
+    competition_id: number;
+    default_season_id: number;
+    default_season_id_value: string;
+    filters: FilterContextFilter[];
+}
+//# sourceMappingURL=matches.d.ts.map

package/dist/api/nrl/matches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matches.d.ts","sourceRoot":"","sources":["../../../src/api/nrl/matches.ts"],"names":[],"mappings":"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"}

package/dist/api/nrl/matches.js

@@ -0,0 +1 @@
+export {};

package/dist/api/nrl/stats.d.ts

@@ -0,0 +1,280 @@
+import { MatchTeam } from "../shared";
+/**
+ * Mode for scoring by position query
+ * - season: Use the match's season, rounds 1 through last completed round
+ * - l5: Last 5 completed matches for each team across seasons
+ * - l10: Last 10 completed matches for each team across seasons
+ * - h2h: Last 3 head-to-head encounters between the two teams
+ * - rd: Custom round range with specified season_id, round_from, round_to
+ */
+export type ScoringByPositionMode = "season" | "l5" | "l10" | "h2h" | "rd";
+/**
+ * Selection context for scoring by position
+ * For l5/l10/h2h modes, all values will be null
+ * For season/rd modes, values will be populated
+ */
+export interface ScoringByPositionSelection {
+    season_id: number | null;
+    season_value: string | null;
+    round_from: number | null;
+    round_to: number | null;
+}
+/**
+ * Scoring data by position for a team
+ * Contains scored and conceded points for each position
+ * Position keys are uppercase (LW, LC, L2R, FE, HLF, R2R, RC, RW, FB, PR, HK, LK)
+ */
+export interface PositionScoring {
+    scored: Record<string, number>;
+    conceded: Record<string, number>;
+}
+/**
+ * Response type for GET /nrl/scoring-by-position/:match_id
+ * Returns scoring statistics by position for both teams
+ *
+ * Query params:
+ * - mode: season (default), l5, l10, h2h, rd
+ * - season_id: Required for rd mode, optional for season mode
+ * - round_from/round_to: Required for rd mode
+ *
+ * When a team has no data for the selected range (e.g., new team),
+ * all position values will be 0.
+ */
+export interface GetScoringByPositionResponse {
+    match_id: number;
+    competition_id: number;
+    home_team: MatchTeam;
+    away_team: MatchTeam;
+    mode: ScoringByPositionMode;
+    selection: ScoringByPositionSelection;
+    /** Position codes in display order */
+    positions: string[];
+    home: PositionScoring;
+    away: PositionScoring;
+}
+/**
+ * Mode for scoring map query
+ * - season: Use the match's season, all completed rounds
+ * - l5: Last 5 completed matches for each team across seasons
+ * - l10: Last 10 completed matches for each team across seasons
+ * - rd: Custom round range with specified season_id, round_from, round_to
+ *
+ * Note: H2H mode is intentionally excluded due to ranking complexity
+ */
+export type ScoringMapMode = "season" | "l5" | "l10" | "rd";
+/**
+ * Side-specific attacking statistics
+ */
+export interface AttackingSideStats {
+    /** Rank among all teams (1 = most tries scored on this side) */
+    rank: number;
+    /** Total tries scored on this side */
+    tries: number;
+    /** Percentage of team's total tries scored on this side */
+    percentageTotal: number;
+}
+/**
+ * Side-specific defending statistics
+ */
+export interface DefendingSideStats {
+    /** Rank among all teams (1 = fewest tries conceded on this side) */
+    rank: number;
+    /** Total tries conceded on this side */
+    concededTries: number;
+    /** Percentage of team's total tries conceded on this side */
+    percentageTotal: number;
+}
+/**
+ * Overall attacking statistics
+ */
+export interface AttackingOverallStats {
+    /** Rank among all teams (1 = most total tries) */
+    rank: number;
+    /** Total tries scored */
+    tries: number;
+    /** Average tries per game */
+    triesPerGame: number;
+}
+/**
+ * Overall defending statistics
+ */
+export interface DefendingOverallStats {
+    /** Rank among all teams (1 = fewest total tries conceded) */
+    rank: number;
+    /** Total tries conceded */
+    concededTries: number;
+    /** Average tries conceded per game */
+    concededPerGame: number;
+}
+/**
+ * Attacking statistics for a team
+ */
+export interface TeamAttacking {
+    leftSide: AttackingSideStats;
+    middle: AttackingSideStats;
+    rightSide: AttackingSideStats;
+    overall: AttackingOverallStats;
+}
+/**
+ * Defending statistics for a team
+ * Note: Sides are flipped from attacker's perspective
+ * If attacker scores on their left, defender conceded on their right
+ */
+export interface TeamDefending {
+    leftSide: DefendingSideStats;
+    middle: DefendingSideStats;
+    rightSide: DefendingSideStats;
+    overall: DefendingOverallStats;
+}
+/**
+ * Complete scoring map for a single team
+ */
+export interface TeamScoringMap {
+    team_id: number;
+    display_name: string;
+    display_name_short: string | null;
+    display_name_code: string | null;
+    logo: string | null;
+    colour: string;
+    /** Number of matches in the dataset for this team */
+    matches_played: number;
+    attacking: TeamAttacking;
+    defending: TeamDefending;
+}
+/**
+ * Selection context for scoring map
+ * For l5/l10 modes, all values will be null
+ * For season/rd modes, values will be populated
+ */
+export interface ScoringMapSelection {
+    season_id: number | null;
+    season_value: string | null;
+    round_from: number | null;
+    round_to: number | null;
+}
+/**
+ * Response type for GET /nrl/scoring-map/:match_id
+ * Returns try scoring statistics by field location (left/middle/right) for both teams
+ *
+ * Query params:
+ * - mode: season (default), l5, l10, rd
+ * - season_id: Required for rd mode
+ * - round_from/round_to: Required for rd mode
+ *
+ * Rankings are calculated across all teams in the dataset.
+ * Teams with no data will have rank: 0 and all stats set to 0.
+ */
+export interface GetScoringMapResponse {
+    match_id: number;
+    competition_id: number;
+    mode: ScoringMapMode;
+    selection: ScoringMapSelection;
+    /** Total number of teams included in rankings */
+    total_teams_in_ranking: number;
+    home_team: TeamScoringMap;
+    away_team: TeamScoringMap;
+}
+/**
+ * Mode for overs/unders query
+ * - season: Use the match's season, rounds 1 through last completed round
+ * - l5: Last 5 completed matches for each team across seasons
+ * - l10: Last 10 completed matches for each team across seasons
+ * - h2h: Last head-to-head encounters between the two teams
+ * - rd: Custom round range with specified season_id, round_from, round_to
+ */
+export type OversUndersMode = "season" | "l5" | "l10" | "h2h" | "rd";
+/**
+ * Selection context for overs/unders
+ * For l5/l10/h2h modes, all values will be null
+ * For season/rd modes, values will be populated
+ */
+export interface OversUndersSelection {
+    season_id: number | null;
+    season_value: string | null;
+    round_from: number | null;
+    round_to: number | null;
+}
+/**
+ * Tags indicating opponent's current ladder position
+ * Based on the latest available ladder data (most recent season by start_date, latest round)
+ * Teams can have multiple tags (e.g., top_4 implies top_8)
+ */
+export interface OpponentTags {
+    /** Opponent is currently ranked 1-4 */
+    top_4: boolean;
+    /** Opponent is currently ranked 1-8 */
+    top_8: boolean;
+    /** Opponent is currently ranked 9-17 */
+    bottom_9: boolean;
+}
+/**
+ * Individual match data in the overs/unders response
+ * Contains combined scores (team + opponent) for each half and full game
+ */
+export interface OversUndersMatch {
+    match_id: number;
+    /** The opponent team's ID (for lookup in teams object) */
+    opponent_team_id: number;
+    /** Combined 1st half score (team's 1st half + opponent's 1st half) */
+    first_half_total: number;
+    /** Combined 2nd half score (team's 2nd half + opponent's 2nd half) */
+    second_half_total: number;
+    /** Combined full time score (team's final + opponent's final) */
+    full_time_total: number;
+    /** Tags for client-side filtering (vs Top 4, vs Top 8, vs Bottom 9) */
+    opponent_tags: OpponentTags;
+}
+/**
+ * Aggregated statistics for a team's historical matches
+ */
+export interface OversUndersTeamStats {
+    /** Array of historical matches with scoring data */
+    matches: OversUndersMatch[];
+    /** Average scores across all matches (not filtered) */
+    averages: {
+        first_half: number;
+        second_half: number;
+        full_time: number;
+    };
+}
+/**
+ * Max values for y-axis chart labelling
+ * Separate values allow proper scaling when switching between views
+ */
+export interface OversUndersMaxValues {
+    /** Highest 1st half score across all matches for both teams + 10 */
+    first_half: number;
+    /** Highest 2nd half score across all matches for both teams + 10 */
+    second_half: number;
+    /** Highest full time score across all matches for both teams + 10 */
+    full_time: number;
+}
+/**
+ * Response type for GET /nrl/overs-unders/:match_id
+ * Returns historical match scoring data for both teams
+ *
+ * Query params:
+ * - mode: season (default), l5, l10, h2h, rd
+ * - season_id: Required for rd mode
+ * - round_from/round_to: Required for rd mode
+ *
+ * Used by frontend to display interactive chart where users can
+ * drag a threshold line to see which matches went "over" or "under"
+ */
+export interface GetOversUndersResponse {
+    match_id: number;
+    competition_id: number;
+    home_team: MatchTeam;
+    away_team: MatchTeam;
+    mode: OversUndersMode;
+    selection: OversUndersSelection;
+    /** Object mapping team_id to team info for quick lookup of opponent names */
+    teams: Record<number, MatchTeam>;
+    /** Home team's historical match data */
+    home: OversUndersTeamStats;
+    /** Away team's historical match data */
+    away: OversUndersTeamStats;
+    /** Max values for y-axis labelling (highest score + 10 for each category) */
+    max_values: OversUndersMaxValues;
+}
+//# sourceMappingURL=stats.d.ts.map

package/dist/api/nrl/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/api/nrl/stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAMtC;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IAErB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,SAAS,EAAE,0BAA0B,CAAC;IAEtC,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,eAAe,CAAC;CACvB;AAMD;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,OAAO,EAAE,qBAAqB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IAEvB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,mBAAmB,CAAC;IAE/B,iDAAiD;IACjD,sBAAsB,EAAE,MAAM,CAAC;IAE/B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;CAC3B;AAMD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,uCAAuC;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,aAAa,EAAE,YAAY,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,uDAAuD;IACvD,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IAEvB,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IAErB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;IAEhC,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEjC,wCAAwC;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,wCAAwC;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAE3B,6EAA6E;IAC7E,UAAU,EAAE,oBAAoB,CAAC;CAClC"}

package/dist/api/nrl/stats.js

@@ -0,0 +1 @@
+export {};