@devrongx/games 0.3.5 → 0.4.1

package/src/pools/hooks.ts

@@ -0,0 +1,173 @@
+// @devrongx/games — pools/hooks.ts
+"use client";
+
+import { useState, useEffect, useCallback, useRef } from "react";
+import {
+  fetchTDPools,
+  fetchTDPoolDetail,
+  fetchTDLeaderboard,
+  fetchTDMyEntry,
+} from "./fetcher";
+import type {
+  ITDPool,
+  ITDPoolDetail,
+  ITDMyEntryResponse,
+  ITDLeaderboardResponse,
+  ITDLeaderboardEntry,
+} from "./types";
+
+// ─── useTDPools ────────────────────────────────────────────────────────────────
+
+export interface UseTDPoolsResult {
+  pools: ITDPool[];
+  loading: boolean;
+  error: string | null;
+  refetch: () => void;
+}
+
+export function useTDPools(matchId: number, partnerSource?: string): UseTDPoolsResult {
+  const [pools, setPools] = useState<ITDPool[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await fetchTDPools(matchId, partnerSource);
+      setPools(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : "Failed to fetch pools");
+    } finally {
+      setLoading(false);
+    }
+  }, [matchId, partnerSource]);
+
+  useEffect(() => { load(); }, [load]);
+
+  return { pools, loading, error, refetch: load };
+}
+
+// ─── useTDPool ─────────────────────────────────────────────────────────────────
+
+export interface UseTDPoolResult {
+  pool: ITDPoolDetail | null;
+  loading: boolean;
+  error: string | null;
+  refetch: () => void;
+}
+
+export function useTDPool(poolId: number): UseTDPoolResult {
+  const [pool, setPool] = useState<ITDPoolDetail | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const data = await fetchTDPoolDetail(poolId);
+      setPool(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : "Failed to fetch pool");
+    } finally {
+      setLoading(false);
+    }
+  }, [poolId]);
+
+  useEffect(() => { load(); }, [load]);
+
+  return { pool, loading, error, refetch: load };
+}
+
+// ─── useTDPoolEntry ─────────────────────────────────────────────────────────────
+
+export interface UseTDPoolEntryResult {
+  data: ITDMyEntryResponse | null;
+  loading: boolean;
+  error: string | null;
+  refetch: () => void;
+}
+
+export function useTDPoolEntry(poolId: number): UseTDPoolEntryResult {
+  const [data, setData] = useState<ITDMyEntryResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const res = await fetchTDMyEntry(poolId);
+      setData(res);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : "Failed to fetch entry");
+    } finally {
+      setLoading(false);
+    }
+  }, [poolId]);
+
+  useEffect(() => { load(); }, [load]);
+
+  return { data, loading, error, refetch: load };
+}
+
+// ─── useTDLeaderboard ──────────────────────────────────────────────────────────
+
+export interface UseTDLeaderboardOptions {
+  sort?: string;
+  order?: string;
+  limit?: number;
+  offset?: number;
+  pollMs?: number;   // Polling interval in ms (0 = disabled)
+}
+
+export interface UseTDLeaderboardResult {
+  rankings: ITDLeaderboardEntry[];
+  total: number;
+  loading: boolean;
+  error: string | null;
+  refetch: () => void;
+}
+
+export function useTDLeaderboard(
+  poolId: number,
+  options?: UseTDLeaderboardOptions,
+): UseTDLeaderboardResult {
+  const [result, setResult] = useState<ITDLeaderboardResponse | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+  const pollRef = useRef<ReturnType<typeof setInterval> | null>(null);
+
+  const { sort, order, limit, offset, pollMs } = options ?? {};
+
+  const load = useCallback(async () => {
+    setError(null);
+    try {
+      const data = await fetchTDLeaderboard(poolId, { sort, order, limit, offset });
+      setResult(data);
+    } catch (err: unknown) {
+      setError(err instanceof Error ? err.message : "Failed to fetch leaderboard");
+    } finally {
+      setLoading(false);
+    }
+  }, [poolId, sort, order, limit, offset]);
+
+  useEffect(() => {
+    setLoading(true);
+    load();
+
+    if (pollMs && pollMs > 0) {
+      pollRef.current = setInterval(load, pollMs);
+      return () => { if (pollRef.current) clearInterval(pollRef.current); };
+    }
+  }, [load, pollMs]);
+
+  return {
+    rankings: result?.leaderboard ?? [],
+    total: result?.total_entries ?? 0,
+    loading,
+    error,
+    refetch: load,
+  };
+}

package/src/pools/index.ts

@@ -0,0 +1,44 @@
+// @devrongx/games — pools/index.ts
+export type {
+  ITDCurrency,
+  ITDPool,
+  ITDPoolDetail,
+  ITDPMBConfig,
+  ITDPoolContentConfig,
+  ITDChallenge,
+  ITDChallengeOption,
+  ITDPayoutTier,
+  ITDLeaderboardEntry,
+  ITDLeaderboardResponse,
+  ITDPoolEntryRecord,
+  ITDPoolBet,
+  ITDPoolParlay,
+  ITDMyEntryResponse,
+  ITDBetInput,
+} from "./types";
+
+export {
+  fetchTDPools,
+  fetchTDPoolDetail,
+  fetchTDLeaderboard,
+  fetchTDMyEntry,
+} from "./fetcher";
+
+export {
+  useTDPools,
+  useTDPool,
+  useTDPoolEntry,
+  useTDLeaderboard,
+} from "./hooks";
+
+export type {
+  UseTDPoolsResult,
+  UseTDPoolResult,
+  UseTDPoolEntryResult,
+  UseTDLeaderboardResult,
+  UseTDLeaderboardOptions,
+} from "./hooks";
+
+export { joinTDPool, placeTDBets } from "./actions";
+
+export { buildPMBConfig } from "./mapper";

package/src/pools/mapper.ts

@@ -0,0 +1,85 @@
+// @devrongx/games — pools/mapper.ts
+// Converts ITDPoolDetail + ITDMatch → IChallengeConfig for the PMB UI.
+// This lets all existing PreMatchGame/Questions/Intro components consume real API data.
+
+import type { IChallengeConfig, IChallengeMarket, IChallengeSection } from "../games/prematch-bets/config";
+import type { ITDPoolDetail, ITDPMBConfig } from "./types";
+import type { ITDMatch } from "../matches/types";
+
+const DEFAULT_PARLAY_COLORS = ["#22E3E8", "#9945FF", "#f83cc5", "#f59e0b", "#22c55e", "#f97316"];
+const DEFAULT_BANNER = "/ipl/default_banner.jpg";
+const DEFAULT_PLAYER_IMAGES: [string, string] = ["/ipl/player1.jpg", "/ipl/player2.jpg"];
+
+function buildTeam(team: ITDMatch["team_a"]) {
+  return {
+    name: team.name,
+    shortName: team.short_name || team.name.slice(0, 3).toUpperCase(),
+    logo: `/ipl/${team.short_name?.toLowerCase() ?? "team"}.png`,
+    gradient: "linear-gradient(180deg, rgba(255,255,255,0.15) 0%, rgba(255,255,255,0.05) 100%)",
+  };
+}
+
+export function buildPMBConfig(pool: ITDPoolDetail, match: ITDMatch): IChallengeConfig {
+  const config = pool.config as ITDPMBConfig;
+  const contentConfig = pool.content_config;
+
+  const markets: IChallengeMarket[] = pool.challenges
+    .sort((a, b) => a.sort_order - b.sort_order)
+    .map((c) => ({
+      id: c.category,
+      question: c.question,
+      icon: c.icon,
+      accent: c.accent_color,
+      category: c.category,
+      backendChallengeId: c.id,
+      options: c.options.map((o) => ({
+        label: o.label,
+        odds: o.odds,
+        entry: o.entry,
+        risk: o.risk,
+      })),
+    }));
+
+  const sections: IChallengeSection[] = (contentConfig?.sections ?? []).map((s) => ({
+    type: s.type as "info" | "challenge",
+    title: s.title,
+    content: s.content,
+  }));
+
+  return {
+    id: pool.machine_name ?? String(pool.id),
+    title: pool.name,
+    matchTitle: `${match.team_a.short_name ?? match.team_a.name} vs ${match.team_b.short_name ?? match.team_b.name}`,
+    tag: "STRATEGY",
+    teamA: buildTeam(match.team_a),
+    teamB: buildTeam(match.team_b),
+    venue: match.venue?.name ?? "",
+    bannerImage: contentConfig?.banner_image ?? DEFAULT_BANNER,
+    playerImages: (contentConfig?.player_images as [string, string] | undefined) ?? DEFAULT_PLAYER_IMAGES,
+    opponents: [buildTeam(match.team_a), buildTeam(match.team_b)],
+    matchStartTime: match.scheduled_start_at ?? "",
+    startingBalance: pool.starting_coins,
+    entryFee: pool.entry_fee,
+    totalEntries: pool.entry_count,
+    rakePercent: pool.rake_percentage / 100,
+    rankBrackets: (config.payout_tiers ?? []).map((t) => ({
+      from: t.rank_from,
+      to: t.rank_to,
+      poolPercent: t.payout_type === "percentage" ? t.value / 100 : 0,
+    })),
+    leaderboardSeed: `pool-${pool.id}`,
+    compoundMultipliers: config.compound_multipliers ?? [],
+    parlayConfig: {
+      maxSlots: config.parlay?.max_slots ?? 6,
+      minLegs: config.parlay?.min_legs ?? 2,
+      maxLegs: config.parlay?.max_legs ?? 14,
+      defaultStake: config.parlay?.default_stake ?? 100,
+      stakeIncrements: config.parlay?.stake_increments ?? 50,
+      colors: contentConfig?.colors?.parlay_slot_colors ?? DEFAULT_PARLAY_COLORS,
+    },
+    categoryLabels: config.category_labels ?? {},
+    games: [],
+    markets,
+    sections,
+  };
+}

package/src/pools/types.ts

@@ -0,0 +1,229 @@
+// @devrongx/games — pools/types.ts
+// Types matching TD backend pool API responses (pool.repo.ts).
+// Status and game_type fields are integers matching DBEnum values in the TD backend.
+
+// ─── Game type constants (mirrors DBEnumGameType in TD backend) ────────────────
+export const TDGameType = {
+  PRE_MATCH_BETS: 1,
+  FANTASY_11: 2,
+  BALL_SEQUENCE: 3,
+} as const;
+
+// ─── Pool status constants (mirrors DBEnumPoolStatus) ─────────────────────────
+export const TDPoolStatus = {
+  DRAFT: 1,
+  OPEN: 2,
+  CLOSED: 3,
+  RESOLVING: 4,
+  COMPLETE: 5,
+  CANCELLED: 6,
+} as const;
+
+// ─── Challenge status constants (mirrors DBEnumChallengeStatus) ────────────────
+export const TDChallengeStatus = {
+  DRAFT: 1,
+  OPEN: 2,
+  CLOSED: 3,
+  RESOLVED: 4,
+  CANCELLED: 5,
+} as const;
+
+// ─── Bet status constants (mirrors DBEnumBetStatus) ───────────────────────────
+export const TDBetStatus = {
+  PENDING: 1,
+  WON: 2,
+  LOST: 3,
+  CANCELLED: 4,
+} as const;
+
+// ─── Currency ───────────────────────────────────────────────────────────────
+
+export interface ITDCurrency {
+  id: number;
+  name: string;      // "Game Coins" | "Match Credits"
+  symbol: string;    // "GC" | "MC"
+  partner_payout: boolean;  // true = IAG handles USDC payout
+}
+
+// ─── Pool list item (GET /api/pools/match/:matchId) ─────────────────────────
+
+export interface ITDPool {
+  id: number;
+  match_id: number;
+  game_type: number;         // TDGameType: 1=PRE_MATCH_BETS, 2=FANTASY_11, 3=BALL_SEQUENCE
+  name: string;
+  machine_name: string | null;
+  display_price: string;     // "Free" | "$1" | "$5"
+  entry_fee: number;
+  starting_coins: number;
+  status: number;            // TDPoolStatus: 1=DRAFT, 2=OPEN, 3=CLOSED, 4=RESOLVING, 5=COMPLETE, 6=CANCELLED
+  entry_count: number;
+  challenge_count: number;
+  currency: ITDCurrency;
+}
+
+// ─── Challenge option (nested in pool detail) ────────────────────────────────
+
+export interface ITDChallengeOption {
+  key: string;
+  label: string;
+  odds: number;
+  entry: number;
+  risk: number;
+}
+
+// ─── Challenge (nested in pool detail) ───────────────────────────────────────
+
+export interface ITDChallenge {
+  id: number;
+  question: string;
+  category: string;
+  icon: string;
+  accent_color: string;
+  sort_order: number;
+  options: ITDChallengeOption[];
+  status: number;            // TDChallengeStatus: 1=DRAFT, 2=OPEN, 3=CLOSED, 4=RESOLVED, 5=CANCELLED
+  correct_option: string | null;
+  resolved_at: string | null;
+}
+
+// ─── Payout tier ─────────────────────────────────────────────────────────────
+
+export interface ITDPayoutTier {
+  rank_from: number;
+  rank_to: number;
+  payout_type: "percentage" | "fixed" | "multiplier";
+  value: number;
+}
+
+// ─── PMB pool config (config JSON for pre_match_bets pools) ──────────────────
+
+export interface ITDPMBConfig {
+  payout_tiers: ITDPayoutTier[];
+  compound_multipliers: number[];
+  parlay: {
+    max_slots: number;
+    min_legs: number;
+    max_legs: number;
+    default_stake: number;
+    stake_increments: number;
+  };
+  category_labels: Record<string, string>;
+  max_entries?: number;
+}
+
+// ─── Content/display config ──────────────────────────────────────────────────
+
+export interface ITDPoolContentConfig {
+  banner_image?: string;
+  player_images?: [string, string];
+  sections?: { type: string; title: string; content: string }[];
+  colors?: {
+    parlay_slot_colors?: string[];
+    accent_color?: string;
+  };
+}
+
+// ─── Pool detail (GET /api/pools/:id) ────────────────────────────────────────
+
+export interface ITDPoolDetail extends ITDPool {
+  description: string | null;
+  rake_percentage: number;
+  config: ITDPMBConfig | Record<string, unknown>;
+  content_config: ITDPoolContentConfig | null;
+  opens_at: string | null;
+  closes_at: string | null;
+  challenges: ITDChallenge[];
+}
+
+// ─── Leaderboard entry ───────────────────────────────────────────────────────
+
+export interface ITDLeaderboardEntry {
+  rank: number;
+  user_id: number;
+  partner_ext_id: string | null;
+  entry_id: number;
+  current_coins: number;
+  final_coins: number | null;
+  total_risked: number;
+  max_possible: number;
+  bets_placed: number;
+  bets_won: number;
+  bets_lost: number;
+  questions_left: number;
+  active_parlays: number;
+}
+
+export interface ITDLeaderboardResponse {
+  pool_id: number;
+  total_entries: number;
+  leaderboard: ITDLeaderboardEntry[];
+}
+
+// ─── Pool entry (GET /api/pools/:id/my-entry) ─────────────────────────────────
+
+export interface ITDPoolEntryRecord {
+  id: number;
+  pool_id: number;
+  user_id: number;
+  entry_fee_paid: number;
+  current_coins: number;
+  final_coins: number | null;
+  total_risked: number;
+  max_possible: number;
+  bets_placed: number;
+  bets_won: number;
+  bets_lost: number;
+  questions_left: number;
+  questions_total: number;
+  active_parlays: number;
+  created_at: string;
+}
+
+export interface ITDPoolBet {
+  id: number;
+  entry_id: number;
+  pool_challenge_id: number;
+  challenge_id: number;
+  selected_option: string;
+  coin_amount: number;
+  odds_at_bet: number;
+  potential_return: number;
+  actual_return: number | null;
+  status: number;  // TDBetStatus: 1=PENDING, 2=WON, 3=LOST, 4=CANCELLED
+  parlay_id: number | null;
+  created_at: string;
+}
+
+export interface ITDPoolParlay {
+  id: number;
+  entry_id: number;
+  total_coin_amount: number;
+  combined_multiplier: number;
+  potential_return: number;
+  actual_return: number | null;
+  status: number;  // TDBetStatus: 1=PENDING, 2=WON, 3=LOST, 4=CANCELLED
+  bets: {
+    id: number;
+    challenge_id: number;
+    selected_option: string;
+    coin_amount: number;
+    odds_at_bet: number;
+    status: number;  // TDBetStatus
+  }[];
+  created_at: string;
+}
+
+export interface ITDMyEntryResponse {
+  entry: ITDPoolEntryRecord;
+  bets: ITDPoolBet[];
+  parlays: ITDPoolParlay[];
+}
+
+// ─── Bet input ────────────────────────────────────────────────────────────────
+
+export interface ITDBetInput {
+  challenge_id: number;
+  selected_option: string;
+  coin_amount: number;
+}