be-components 7.4.7 → 7.5.1

package/src/BetRouter/types/api-contracts.ts

@@ -0,0 +1,1164 @@
+// API Contracts - All API endpoints with their request/response types
+// This is the SINGLE SOURCE OF TRUTH for API types
+// Copy the entire src/types folder to your client project
+
+import type { BuyOpportunity, OpportunityProps, OpportunityStatusLegProps, OpportunitySummaryProps } from './opportunities';
+import type { RouterOrderProps } from './orders';
+import type { RouterAccountProps, AccountPartnerProps } from './accounts';
+import type { RouterPartnerProps } from './partners';
+import type { RouterLeagueProps, PartnerLeagueProps, RawLeagueProps } from './leagues';
+import type { RouterContestProps, PartnerContestProps, RawContestProps } from './contests';
+import type { RouterParticipantProps, RawParticipantProps, PartnerParticipantProps } from './participants';
+import type {
+  RouterMarketProps,
+  RouterMarketVariableProps,
+  RouterMarketSideProps,
+  PartnerMarketProps,
+  RawMarketProps,
+  MarketContestProps
+} from './markets';
+import type { RouterLiquidityProps } from './liquidity';
+import type { PartnerCredentialProps } from './credentials';
+import type { ConfigProps } from './config';
+import type { RouterJobProps, RouterJobStatusProps } from './jobs';
+
+// Auto-linking types
+export interface AutoLinkResult {
+  success: boolean;
+  router_entity_id: string;
+  partner_id: string;
+  partner_name: string;
+  raw_entity_id?: string;
+  partner_entity_id?: string;
+  confidence: number;
+  match_method: string;
+  error?: string;
+}
+
+export interface AutoLinkSummary {
+  entity_type: 'league' | 'contest' | 'participant' | 'market';
+  partner_name: string;
+  total_router_entities: number;
+  matched_count: number;
+  created_count: number;
+  updated_count: number;
+  failed_count: number;
+  results: AutoLinkResult[];
+}
+
+// Base response types
+export interface SuccessResponse {
+  message: string;
+}
+
+export interface ErrorResponse {
+  message: string;
+  error: string;
+}
+
+// API Contracts Definition
+export const ApiContracts = {
+  // ========== Opportunities Routes ==========
+  'POST /opportunities/opportunity/buy': {
+    auth: true,
+    body: {
+      buy_opportunity: {} as BuyOpportunity
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        success: boolean;
+        total_legs: number;
+        successful_orders: number;
+        router_orders: RouterOrderProps[];
+        buy_results: RouterOrderProps[]; // Deprecated, use router_orders
+      },
+      400: {} as ErrorResponse & {
+        success: boolean;
+      }
+    }
+  },
+
+  'GET /opportunities/open/me': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        opportunities: OpportunityProps[];
+        opportunity_status_legs: OpportunityStatusLegProps[];
+        router_orders: RouterOrderProps[];
+        router_contests: RouterContestProps[];
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /opportunities/past/me': {
+    auth: true,
+    query: {
+      from: 0 as number,  // UNIX timestamp in milliseconds
+      to: 0 as number,    // UNIX timestamp in milliseconds
+      offset: 0 as number // Pagination offset (0-based)
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        opportunities: OpportunityProps[];
+        opportunity_summary: OpportunitySummaryProps[];
+        opportunity_status_legs: OpportunityStatusLegProps[];
+        router_orders: RouterOrderProps[];
+        router_contests: RouterContestProps[];
+        pages: number;
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /opportunities/reconcile': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse,
+      500: {} as ErrorResponse
+    }
+  },
+
+  // ========== Accounts Routes ==========
+  'POST /accounts/join': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        account: RouterAccountProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/leave': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        account: RouterAccountProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /accounts/me': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        account: RouterAccountProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /accounts/partners/me': {
+    auth: true,
+    query: {
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partner: AccountPartnerProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/partner/connect': {
+    auth: true,
+    body: {
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partner: AccountPartnerProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/partner/disconnect': {
+    auth: true,
+    body: {
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partner: AccountPartnerProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/partner/credentials/update': {
+    auth: true,
+    body: {
+      partner_id: '' as string,
+      credentials: {} as PartnerCredentialProps
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partner: AccountPartnerProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/partner/credentials/test': {
+    auth: true,
+    body: {
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partner: AccountPartnerProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /accounts/balance/update': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partners: AccountPartnerProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /accounts/balance/me': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        account_partners: AccountPartnerProps[];
+        balance: number
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Partners Routes ==========
+  'GET /partners': {
+    auth: false,
+    responses: {
+      200: {} as RouterPartnerProps[]
+    }
+  },
+
+  'POST /partners/load': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        partners: RouterPartnerProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Leagues Routes ==========
+  'GET /leagues': {
+    auth: false,
+    query: {
+      status: '' as string | undefined
+    },
+    responses: {
+      200: {} as RouterLeagueProps[]
+    }
+  },
+
+  'GET /leagues/open': {
+    auth: false,
+    query: {
+      partner_ids: '' as string | undefined // Comma-separated partner IDs to filter by
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_leagues: RouterLeagueProps[];
+        raw_leagues: RawLeagueProps[];
+        partner_leagues: PartnerLeagueProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /leagues/link': {
+    auth: false,
+    body: {
+      raw_league_ids: '' as string | string[], // Support both single string and array
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        partnerLeagues: PartnerLeagueProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /leagues/load': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        leagues: RouterLeagueProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /leagues/:router_league_id/available-raw/:partner_id': {
+    auth: false,
+    params: {
+      router_league_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_league: RouterLeagueProps;
+        raw_leagues: RawLeagueProps[];
+        already_linked: RawLeagueProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /leagues/load-raw': {
+    auth: false,
+    body: {
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        raw_leagues: RawLeagueProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Contests Routes ==========
+  'GET /contests/router': {
+    auth: false,
+    query: {
+      status: '' as string | undefined
+    },
+    responses: {
+      200: {} as RouterContestProps[]
+    }
+  },
+
+  'GET /contests/partner': {
+    auth: false,
+    responses: {
+      200: {} as PartnerContestProps[]
+    }
+  },
+
+  'GET /contests/auto-fill': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contests: RouterContestProps[];
+        market_contests: MarketContestProps[]
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'GET /contests/open/:router_league_id': {
+    auth: false,
+    params: {
+      router_league_id: '' as string
+    },
+    query: {
+      status: 'open' as string | undefined, // Filter by status. Default: 'open'
+      offset: 0 as number | undefined // Pagination offset (only used with status='closed'). Max 100 results per page
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contests: RouterContestProps[];
+        raw_contests: RawContestProps[];
+        partner_contests: PartnerContestProps[];
+        total_count: number; // Total count of contests (useful for pagination)
+        has_more: boolean; // Whether there are more results available
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /contests/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        partner_contests: PartnerContestProps[];
+        market_contests: MarketContestProps[];
+        router_markets: RouterMarketProps[];
+        partner_markets: PartnerMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /contests/link': {
+    auth: false,
+    body: {
+      raw_contest_ids: [] as string[],
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        partner_contests: PartnerContestProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /contests/load': {
+    auth: false,
+    body: {
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        contests: RouterContestProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /contests/load-raw': {
+    auth: false,
+    body: {
+      partner_id: '' as string,
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        raw_contests: RawContestProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /contests/check-status': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        updated: number;
+        closed_contest_ids: string[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'PATCH /contests/router/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    body: {} as Partial<Omit<RouterContestProps, 'router_contest_id' | 'create_datetime'>>,
+    responses: {
+      200: {} as SuccessResponse & {
+        contest: RouterContestProps
+      },
+      400: {} as ErrorResponse,
+      404: {} as ErrorResponse & {
+        router_contest_id: string
+      }
+    },
+    notes: 'When setting auto_fill=false, all market_contests for this contest will also be disabled. When setting auto_fill=true, only the contest level is updated.'
+  },
+
+  'GET /contests/:router_contest_id/available-raw/:partner_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        raw_contests: RawContestProps[];
+        already_linked: RawContestProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Participants Routes ==========
+  'GET /participants/router': {
+    auth: false,
+    query: {
+      router_league_id: '' as string | undefined,
+      participant_type: '' as string | undefined,
+      status: '' as string | undefined
+    },
+    responses: {
+      200: {} as RouterParticipantProps[]
+    }
+  },
+
+  'GET /participants/raw': {
+    auth: false,
+    responses: {
+      200: {} as RawParticipantProps[]
+    }
+  },
+
+  'GET /participants/partner': {
+    auth: false,
+    responses: {
+      200: {} as PartnerParticipantProps[]
+    }
+  },
+
+  'POST /participants/load': {
+    auth: false,
+    body: {
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_participants_count: number;
+        raw_participants_count: number;
+        router_participants: RouterParticipantProps[];
+        raw_participants: RawParticipantProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /participants/load-raw': {
+    auth: false,
+    body: {
+      partner_id: '' as string,
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        raw_participants: RawParticipantProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /participants/link': {
+    auth: false,
+    body: {
+      raw_participant_ids: [] as string[],
+      router_participant_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        partner_participants: PartnerParticipantProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /participants/:router_participant_id/available-raw/:partner_id/:router_league_id': {
+    auth: false,
+    params: {
+      router_participant_id: '' as string,
+      partner_id: '' as string,
+      router_league_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_participant: RouterParticipantProps;
+        raw_participants: RawParticipantProps[];
+        already_linked: RawParticipantProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Markets Routes ==========
+  'GET /markets/router': {
+    auth: false,
+    responses: {
+      200: {} as RouterMarketProps[]
+    }
+  },
+
+  'GET /markets/variables': {
+    auth: false,
+    responses: {
+      200: {} as RouterMarketVariableProps[]
+    }
+  },
+
+  'GET /markets/sides': {
+    auth: false,
+    responses: {
+      200: {} as RouterMarketSideProps[]
+    }
+  },
+
+  'GET /markets/partner': {
+    auth: false,
+    responses: {
+      200: {} as PartnerMarketProps[]
+    }
+  },
+
+  'GET /markets/supported/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        market_contests: MarketContestProps[];
+        router_markets: RouterMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /markets/available-to-support/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        all_router_markets: RouterMarketProps[];
+        market_contests: MarketContestProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /markets/supported': {
+    auth: false,
+    body: {
+      router_contest_id: '' as string,
+      router_market_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        market_contest: MarketContestProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'DELETE /markets/supported/:market_contest_id': {
+    auth: false,
+    params: {
+      market_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse,
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /markets/:router_contest_id/:router_market_id/linking-data/:partner_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string,
+      router_market_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        router_market: RouterMarketProps;
+        market_sides: RouterMarketSideProps[];
+        timeframes: any[];
+        participants: {
+          partner_participant_id: string;
+          router_participant_id: string;
+          name: string;
+          participant_type: string;
+          external_id: string;
+          raw_name: string;
+          tags: string[];
+        }[];
+        variables: RouterMarketVariableProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /markets/:router_contest_id/:router_market_id/variables-and-raw/:partner_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string,
+      router_market_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        router_market: RouterMarketProps;
+        existing_variables: Array<{
+          router_market_variable_id: string;
+          variable: number;
+          variable_type: 'total' | 'spread';
+          linked_count: number;
+        }>;
+        existing_participants: Array<{
+          partner_participant_id: string;
+          name: string;
+          participant_type: string;
+          linked_count: number;
+          variables: number[];
+        }>;
+        raw_markets: RawMarketProps[];
+        already_linked_by_variable: Record<string, string[]>;
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /markets/:router_contest_id/:router_market_id/available-raw/:partner_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string,
+      router_market_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        router_market: RouterMarketProps;
+        raw_markets: RawMarketProps[];
+        already_linked: RawMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /markets/load-raw': {
+    auth: false,
+    body: {
+      partner_id: '' as string,
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        raw_markets: RawMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'GET /markets/raw/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_contest: RouterContestProps;
+        raw_markets_count: number;
+        partner_markets_count: number;
+        router_market_sides_count: number;
+        router_markets_count: number;
+        raw_markets: RawMarketProps[];
+        partner_markets: PartnerMarketProps[];
+        router_market_sides: RouterMarketSideProps[];
+        router_markets: RouterMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /markets/load': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        markets: RawMarketProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /markets/link': {
+    auth: false,
+    body: {
+      raw_market_id: '' as string,
+      router_market_id: '' as string,
+      market_side_id: '' as string,
+      partner_participant_id: '' as string,
+      timeframe_id: '' as string,
+      variable: 0 as number,
+      variable_type: '' as 'total' | 'spread',
+      price_key: '' as string | undefined
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        partnerMarket: PartnerMarketProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /markets/add-variable': {
+    auth: false,
+    body: {
+      router_contest_id: '' as string,
+      router_market_id: '' as string,
+      partner_id: '' as string,
+      variable: 0 as number
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        partner_markets_created: PartnerMarketProps[];
+        count: number;
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'PATCH /markets/supported/:market_contest_id': {
+    auth: false,
+    params: {
+      market_contest_id: '' as string
+    },
+    body: {} as Partial<Omit<MarketContestProps, 'market_contest_id' | 'create_datetime'>>,
+    responses: {
+      200: {} as SuccessResponse & {
+        market_contest: MarketContestProps
+      },
+      400: {} as ErrorResponse,
+      404: {} as ErrorResponse & {
+        market_contest_id: string
+      }
+    }
+  },
+
+  // ========== Liquidity Routes ==========
+  'GET /liquidity/contest/:router_contest_id': {
+    auth: false,
+    params: {
+      router_contest_id: '' as string
+    },
+    query: {
+      partner_ids: '' as string | undefined, // CSV of partner IDs (e.g., "partner1,partner2")
+      include_opportunities: '' as string | undefined // 'true' to include opportunities in response (default: false)
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        contest: RouterContestProps;
+        partners: RouterPartnerProps[];
+        liquidity_count: number;
+        liquidities: RouterLiquidityProps[];
+        partner_contests: PartnerContestProps[];
+        partner_markets: PartnerMarketProps[];
+        router_markets: RouterMarketProps[];
+        router_market_sides: RouterMarketSideProps[];
+        router_market_variables: RouterMarketVariableProps[];
+        opportunity_count?: number; // Only present when include_opportunities=true
+        opportunities?: BuyOpportunity[]; // Only present when include_opportunities=true
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'POST /liquidity/generate-all': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        contests_processed: number;
+        total_liquidity_count: number;
+        total_opportunities: number;
+        opportunities: BuyOpportunity[];
+        router_contests: RouterContestProps[];
+        partner_markets: PartnerMarketProps[];
+        router_market_variables: RouterMarketVariableProps[];
+        router_markets: RouterMarketProps[];
+        router_market_sides: RouterMarketSideProps[];
+        partners: RouterPartnerProps[]
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  // ========== Auto-Linking Routes ==========
+  'POST /autolinking/contests': {
+    auth: false,
+    body: {
+      router_league_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & AutoLinkSummary,
+      500: {} as ErrorResponse
+    }
+  },
+
+  'POST /autolinking/participants': {
+    auth: false,
+    body: {
+      router_league_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & AutoLinkSummary,
+      500: {} as ErrorResponse
+    }
+  },
+
+  'POST /autolinking/markets': {
+    auth: false,
+    body: {
+      router_league_id: '' as string,
+      router_market_id: '' as string,
+      partner_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & AutoLinkSummary,
+      500: {} as ErrorResponse
+    }
+  },
+
+  // ========== Config Routes ==========
+  'GET /config': {
+    auth: false,
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        configs: ConfigProps[]
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'GET /config/:config': {
+    auth: false,
+    params: {
+      config: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        config: ConfigProps
+      },
+      404: {} as ErrorResponse & {
+        config: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'GET /config/:config/value': {
+    auth: false,
+    params: {
+      config: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        config: string;
+        value: any
+      },
+      404: {} as ErrorResponse & {
+        config: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'POST /config': {
+    auth: false,
+    body: {
+      config: '' as string,
+      value: '' as any,
+      config_format: 'string' as 'string' | 'number' | 'boolean' | 'json'
+    },
+    responses: {
+      201: {} as SuccessResponse & {
+        config: ConfigProps
+      },
+      400: {} as ErrorResponse,
+      409: {} as ErrorResponse & {
+        config: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'PUT /config/:config': {
+    auth: false,
+    params: {
+      config: '' as string
+    },
+    body: {
+      value: '' as any | undefined,
+      config_format: '' as ('string' | 'number' | 'boolean' | 'json') | undefined
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        config: ConfigProps
+      },
+      400: {} as ErrorResponse,
+      404: {} as ErrorResponse & {
+        config: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'DELETE /config/:config': {
+    auth: false,
+    params: {
+      config: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        config: string
+      },
+      404: {} as ErrorResponse & {
+        config: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  // ========== Jobs Routes ==========
+  'POST /jobs/create': {
+    auth: true,
+    body: {
+      job_key: '' as string,
+      name: '' as string,
+      description: '' as string,
+      frequency: 0 as number,
+      frequency_type: 'seconds' as 'seconds' | 'minutes' | 'hours' | 'days'
+    },
+    responses: {
+      201: {} as SuccessResponse & {
+        job: RouterJobProps
+      },
+      400: {} as ErrorResponse
+    }
+  },
+
+  'PUT /jobs/update': {
+    auth: true,
+    body: {} as { router_job_id: string } & Partial<Omit<RouterJobProps, 'router_job_id' | 'create_datetime'>>,
+    responses: {
+      200: {} as SuccessResponse & {
+        job: RouterJobProps
+      },
+      400: {} as ErrorResponse,
+      404: {} as ErrorResponse & {
+        router_job_id: string
+      }
+    }
+  },
+
+  'POST /jobs/queue': {
+    auth: true,
+    body: {
+      job_key: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        job_key: string;
+        job_name: string;
+        note: string
+      },
+      400: {} as ErrorResponse,
+      404: {} as ErrorResponse & {
+        job_key: string
+      }
+    }
+  },
+
+  'GET /jobs': {
+    auth: true,
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        jobs: RouterJobProps[]
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'GET /jobs/:job_key': {
+    auth: true,
+    params: {
+      job_key: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        job: RouterJobProps
+      },
+      404: {} as ErrorResponse & {
+        job_key: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'DELETE /jobs/:router_job_id': {
+    auth: true,
+    params: {
+      router_job_id: '' as string
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        router_job_id: string;
+        job_key: string
+      },
+      404: {} as ErrorResponse & {
+        router_job_id: string
+      },
+      500: {} as ErrorResponse
+    }
+  },
+
+  'GET /jobs/statuses/recent': {
+    auth: true,
+    query: {
+      limit: 0 as number | undefined, // Default: 50
+      offset: 0 as number | undefined // Default: 0
+    },
+    responses: {
+      200: {} as SuccessResponse & {
+        count: number;
+        limit: number;
+        offset: number;
+        statuses: RouterJobStatusProps[];
+        jobs: RouterJobProps[]
+      },
+      500: {} as ErrorResponse
+    }
+  }
+} as const;
+
+// Type helpers to extract types from contracts
+export type ApiContract = typeof ApiContracts;
+
+export type ExtractRequestBody<T extends keyof ApiContract> =
+  ApiContract[T] extends { body: infer B } ? B : never;
+
+export type ExtractRequestQuery<T extends keyof ApiContract> =
+  ApiContract[T] extends { query: infer Q } ? Q : never;
+
+export type ExtractRequestParams<T extends keyof ApiContract> =
+  ApiContract[T] extends { params: infer P } ? P : never;
+
+export type ExtractSuccessResponse<T extends keyof ApiContract> =
+  ApiContract[T] extends { responses: { 200: infer R } } ? R :
+  ApiContract[T] extends { responses: { 201: infer R } } ? R : never;
+
+export type ExtractErrorResponse<T extends keyof ApiContract> =
+  ApiContract[T] extends { responses: { 400: infer R } } ? R :
+  ApiContract[T] extends { responses: { 500: infer R } } ? R : never;