@vatvaghool/create-ipl-dashboard 0.1.0

package/template/packages/ipl-dashboard-utils/src/types.ts

@@ -0,0 +1,88 @@
+export type OverallChartItem = {
+  name: string;
+  points: number;
+  rank: number;
+  previousRank?: number;
+  previousPoints?: number;
+  lastMatchPoints?: number;
+  gapToNext?: number;
+  gapPercent?: number;
+  movement?: "up" | "down" | "same" | "new";
+  transfersLeft?: number;
+  transfersUsed?: number;
+  totalTransfers?: number;
+  boostersUsed?: string;
+  efficiency?: number;
+  isLastMatchLeader?: boolean;
+  captain?: ScrapedSquadPlayer | null;
+  viceCaptain?: ScrapedSquadPlayer | null;
+  players?: ScrapedSquadPlayer[];
+};
+
+export type DailyChartRow = {
+  day: string;
+  [teamName: string]: string | number;
+};
+
+export type DashboardData = {
+  overall: OverallChartItem[];
+  daily: DailyChartRow[];
+  updatedAt?: string;
+  dailyTransferUpdatedAt?: string;
+  completedMatches?: number;
+  source?: "database";
+  snapshot?: ScrapedDashboardPayload;
+};
+
+export type RawApiUser = {
+  rno: number;
+  temname: string;
+  points: number;
+  matches: Array<{
+    matchId: number;
+    points: number;
+  }>;
+};
+
+export type ScrapedSquadPlayer = {
+  name: string;
+  number?: string;
+  points?: number;
+};
+
+export type ScrapedLeaderboardItem = {
+  rank: number;
+  name: string;
+  points: number;
+  lastMatchPoints?: number;
+  netPoints?: number;
+  netRank?: number;
+  transfersLeft?: number;
+  transfersUsed?: number;
+  totalTransfers?: number;
+  boostersUsed?: string;
+  captain?: ScrapedSquadPlayer | null;
+  viceCaptain?: ScrapedSquadPlayer | null;
+  players?: ScrapedSquadPlayer[];
+};
+
+export type ScrapedDashboardPayload = {
+  updatedAt?: string;
+  dailyTransferUpdatedAt?: string;
+  completedMatches?: number;
+  leaders: ScrapedLeaderboardItem[];
+};
+
+export type TransformOptions = {
+  teamAliases?: Record<string, string>;
+  totalTransfers?: number;
+};
+
+export type RawUsersSyncResult = {
+  status: "updated" | "unchanged" | "skipped";
+  users: RawApiUser[];
+  matchId?: number;
+  mode?: "append" | "update-latest";
+  completedMatches?: number;
+  unmatchedNames: string[];
+};

package/template/packages/ipl-dashboard-utils/tsconfig.build.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "declaration": true,
+    "declarationMap": false,
+    "sourceMap": false,
+    "strict": true,
+    "skipLibCheck": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "rootDir": "src",
+    "outDir": "dist"
+  },
+  "include": ["src/**/*.ts"]
+}

package/template/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/template/scripts/capture-ipl-auth.mjs

@@ -0,0 +1,54 @@
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+
+const DEFAULT_LEAGUE_URL =
+  "https://fantasy.iplt20.com/classic/league/view/66930102";
+const DEFAULT_OUTPUT_PATH = "ipl-auth.json";
+
+const readEnv = (name, fallback = "") => {
+  const value = process.env[name]?.trim();
+  return value || fallback;
+};
+
+const run = async () => {
+  const moduleName = "playwright";
+  const { chromium } = await import(moduleName).catch(() => {
+    throw new Error(
+      'Playwright is not installed. Run "npm install --no-save playwright" first.',
+    );
+  });
+
+  const leagueUrl = readEnv("IPL_LEAGUE_URL", DEFAULT_LEAGUE_URL);
+  const outputPath = readEnv("IPL_AUTH_OUTPUT_PATH", DEFAULT_OUTPUT_PATH);
+  const browser = await chromium.launch({ headless: false });
+  const context = await browser.newContext();
+  const page = await context.newPage();
+  const rl = readline.createInterface({ input, output });
+
+  try {
+    await page.goto(leagueUrl, { waitUntil: "domcontentloaded", timeout: 60000 });
+
+    console.log("");
+    console.log("Playwright browser opened.");
+    console.log(`League URL: ${leagueUrl}`);
+    console.log("Log in manually in the browser window.");
+    console.log("After login fully completes and the leaderboard is visible, press Enter here.");
+    console.log("");
+
+    await rl.question("Press Enter to save auth state...");
+
+    await context.storageState({ path: outputPath });
+    console.log("");
+    console.log(`Saved Playwright auth state to ${outputPath}`);
+    console.log(`Base64 encode it for GitHub secret IPL_STORAGE_STATE_B64:`);
+    console.log(`base64 ${outputPath}`);
+  } finally {
+    rl.close();
+    await browser.close();
+  }
+};
+
+run().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/template/scripts/deploy-cloud-run-sync.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+PROJECT_ID="${PROJECT_ID:?Set PROJECT_ID}"
+REGION="${REGION:?Set REGION}"
+REPOSITORY="${REPOSITORY:-ipl-dashboard}"
+IMAGE_NAME="${IMAGE_NAME:-ipl-sync}"
+JOB_NAME="${JOB_NAME:-ipl-sync}"
+APP_BASE_URL="${APP_BASE_URL:?Set APP_BASE_URL}"
+LEAGUE_URL="${LEAGUE_URL:-https://fantasy.iplt20.com/classic/league/view/66930102}"
+
+IMAGE_URI="${REGION}-docker.pkg.dev/${PROJECT_ID}/${REPOSITORY}/${IMAGE_NAME}:latest"
+
+gcloud artifacts repositories describe "${REPOSITORY}" \
+  --location="${REGION}" >/dev/null 2>&1 || \
+gcloud artifacts repositories create "${REPOSITORY}" \
+  --repository-format=docker \
+  --location="${REGION}"
+
+gcloud builds submit \
+  --project="${PROJECT_ID}" \
+  --tag="${IMAGE_URI}" \
+  -f Dockerfile.sync \
+  .
+
+gcloud run jobs deploy "${JOB_NAME}" \
+  --project="${PROJECT_ID}" \
+  --region="${REGION}" \
+  --image="${IMAGE_URI}" \
+  --max-retries=1 \
+  --task-timeout=20m \
+  --set-env-vars="NODE_ENV=production,IPL_HEADLESS=1,IPL_LEAGUE_URL=${LEAGUE_URL},IPL_API_BASE_URL=${APP_BASE_URL}" \
+  --set-secrets="IPL_POST_SECRET=IPL_POST_SECRET:latest,IPL_STORAGE_STATE_B64=IPL_STORAGE_STATE_B64:latest"
+
+echo ""
+echo "Cloud Run job deployed:"
+echo "  Job: ${JOB_NAME}"
+echo "  Image: ${IMAGE_URI}"
+echo ""
+echo "Next step:"
+echo "  gcloud scheduler jobs create http ${JOB_NAME}-schedule \\"
+echo "    --project=${PROJECT_ID} \\"
+echo "    --location=${REGION} \\"
+echo "    --schedule='*/10 * * * *' \\"
+echo "    --uri=https://${REGION}-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/${PROJECT_ID}/jobs/${JOB_NAME}:run \\"
+echo "    --http-method=POST \\"
+echo "    --oauth-service-account-email=YOUR_SCHEDULER_SA@${PROJECT_ID}.iam.gserviceaccount.com"

package/template/scripts/deploy-cloud-scheduler.sh

@@ -0,0 +1,42 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+PROJECT_ID="${PROJECT_ID:?Set PROJECT_ID}"
+REGION="${REGION:?Set REGION}"
+JOB_NAME="${JOB_NAME:-ipl-sync}"
+SCHEDULER_JOB_NAME="${SCHEDULER_JOB_NAME:-ipl-sync-schedule}"
+SCHEDULE="${SCHEDULE:-*/10 * * * *}"
+TIME_ZONE="${TIME_ZONE:-Asia/Kolkata}"
+SERVICE_ACCOUNT_EMAIL="${SERVICE_ACCOUNT_EMAIL:?Set SERVICE_ACCOUNT_EMAIL}"
+
+RUN_URI="https://${REGION}-run.googleapis.com/apis/run.googleapis.com/v1/namespaces/${PROJECT_ID}/jobs/${JOB_NAME}:run"
+
+if gcloud scheduler jobs describe "${SCHEDULER_JOB_NAME}" \
+  --project="${PROJECT_ID}" \
+  --location="${REGION}" >/dev/null 2>&1; then
+  gcloud scheduler jobs update http "${SCHEDULER_JOB_NAME}" \
+    --project="${PROJECT_ID}" \
+    --location="${REGION}" \
+    --schedule="${SCHEDULE}" \
+    --time-zone="${TIME_ZONE}" \
+    --uri="${RUN_URI}" \
+    --http-method=POST \
+    --oauth-service-account-email="${SERVICE_ACCOUNT_EMAIL}"
+else
+  gcloud scheduler jobs create http "${SCHEDULER_JOB_NAME}" \
+    --project="${PROJECT_ID}" \
+    --location="${REGION}" \
+    --schedule="${SCHEDULE}" \
+    --time-zone="${TIME_ZONE}" \
+    --uri="${RUN_URI}" \
+    --http-method=POST \
+    --oauth-service-account-email="${SERVICE_ACCOUNT_EMAIL}"
+fi
+
+echo ""
+echo "Cloud Scheduler job configured:"
+echo "  Name: ${SCHEDULER_JOB_NAME}"
+echo "  Schedule: ${SCHEDULE}"
+echo "  Time zone: ${TIME_ZONE}"
+echo "  Target: ${RUN_URI}"

package/template/scripts/dev-simple.js

@@ -0,0 +1,31 @@
+import { spawn, spawnSync } from "node:child_process";
+
+const seedMongoIfConfigured = () => {
+  if (!process.env.MONGODB_URI) {
+    console.log("No MONGODB_URI configured. Using local snapshot/raw fallback.");
+    return;
+  }
+
+  console.log("MONGODB_URI detected. Running seed once (best effort)...");
+  const result = spawnSync("npm", ["run", "seed:mongodb"], {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  if (result.status !== 0) {
+    console.warn("Seed failed. Continuing with dev server.");
+  }
+};
+
+seedMongoIfConfigured();
+
+console.log("Starting dev server...");
+const child = spawn("next", ["dev"], {
+  stdio: "inherit",
+  env: process.env,
+  shell: true,
+});
+
+child.on("exit", (code) => {
+  process.exit(code ?? 0);
+});

package/template/scripts/dev-welcome.mjs

@@ -0,0 +1,38 @@
+const reset = "\x1b[0m";
+const bold = "\x1b[1m";
+const dim = "\x1b[2m";
+const cyan = "\x1b[36m";
+const amber = "\x1b[33m";
+const magenta = "\x1b[35m";
+const lime = "\x1b[32m";
+
+const cmds = [
+  { cmd: "capture:ipl-auth", desc: "Log in to fantasy.iplt20.com and save auth state" },
+  { cmd: "sync:ipl", desc: "Scrape live leaderboard + squad data (one-shot)" },
+  { cmd: "sync:ipl:transfers-daily", desc: "Scrape transfer/booster data for all teams" },
+  { cmd: "sync:ipl:watch", desc: "Watch mode — rescrape leaderboard every 60s" },
+  { cmd: "test", desc: "Run all tests (43 total)" },
+  { cmd: "lint", desc: "Run ESLint" },
+  { cmd: "build", desc: "Production build" },
+];
+
+console.log("");
+console.log(`  ${bold}${magenta}╭──────────────────────────────────────────╮${reset}`);
+console.log(`  ${bold}${magenta}│${reset}  ${bold}🏏  IPL Dashboard Dev Server Ready${reset}   ${bold}${magenta}│${reset}`);
+console.log(`  ${bold}${magenta}╰──────────────────────────────────────────╯${reset}`);
+console.log("");
+console.log(`  ${bold}${cyan}Next Steps${reset}`);
+console.log(`  ${dim}────────────────────────────────────────────${reset}`);
+console.log("");
+
+for (const { cmd, desc } of cmds) {
+  console.log(`  ${amber}npm run${reset} ${bold}${cmd.padEnd(25)}${reset} ${dim}${desc}${reset}`);
+}
+
+console.log("");
+console.log(`  ${bold}${lime}Quick Start${reset}`);
+console.log(`  ${dim}  1. Run${reset} ${amber}npm run capture:ipl-auth${reset} ${dim}(one-time login)${reset}`);
+console.log(`  ${dim}  2. Run${reset} ${amber}npm run sync:ipl:transfers-daily${reset} ${dim}(load transfer data)${reset}`);
+console.log(`  ${dim}  3. Run${reset} ${amber}npm run sync:ipl:watch${reset} ${dim}(start live sync)${reset}`);
+console.log(`  ${dim}  4. Open${reset} ${cyan}http://localhost:3000${reset} ${dim}to view the dashboard${reset}`);
+console.log("");

package/template/scripts/monitor-ops-status.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+APP_BASE_URL="${APP_BASE_URL:-}"
+
+if [ -z "${APP_BASE_URL}" ]; then
+  echo "APP_BASE_URL is required. Example: APP_BASE_URL=https://your-app-domain" >&2
+  exit 1
+fi
+
+URL="${APP_BASE_URL%/}/api/ops/status"
+TMP_BODY="$(mktemp)"
+TMP_HEADERS="$(mktemp)"
+
+cleanup() {
+  rm -f "${TMP_BODY}" "${TMP_HEADERS}"
+}
+
+trap cleanup EXIT
+
+HTTP_CODE="$(
+  curl -sS \
+    -D "${TMP_HEADERS}" \
+    -o "${TMP_BODY}" \
+    -w "%{http_code}" \
+    -H "Accept: application/json" \
+    "${URL}"
+)"
+
+if [ "${HTTP_CODE}" -ge 500 ]; then
+  echo "monitor failure: ${URL} returned HTTP ${HTTP_CODE}" >&2
+  cat "${TMP_BODY}" >&2
+  exit 1
+fi
+
+if grep -q '"status":"critical"' "${TMP_BODY}"; then
+  echo "monitor failure: critical app status reported by ${URL}" >&2
+  cat "${TMP_BODY}" >&2
+  exit 1
+fi
+
+if grep -q '"status":"degraded"' "${TMP_BODY}"; then
+  echo "monitor warning: degraded app status reported by ${URL}" >&2
+  cat "${TMP_BODY}"
+  exit 2
+fi
+
+echo "monitor ok: ${URL} returned HTTP ${HTTP_CODE}"
+cat "${TMP_BODY}"

package/template/scripts/seed-mongodb.ts

@@ -0,0 +1,115 @@
+import { MongoClient } from "mongodb";
+import {
+  buildManualDashboard,
+  normalizeRawApiUsers,
+} from "../app/api/ipl/transform.ts";
+import { rawApiUsers } from "../app/api/ipl/data.ts";
+
+try {
+  process.loadEnvFile(".env");
+} catch {
+  // Environment variables may already be provided by the shell.
+}
+
+const DB_NAME = "ipl";
+const COLLECTION_NAME = "ipl";
+const RAW_USERS_DOCUMENT_TYPE = "raw-users";
+
+const args = new Set(process.argv.slice(2));
+const dryRun = args.has("--dry-run");
+const force = args.has("--force");
+const reset = args.has("--reset");
+
+const loadSeedUsers = () => {
+  const users = normalizeRawApiUsers(rawApiUsers);
+
+  if (!users) {
+    throw new Error(
+      "Failed to normalize raw seed users from app/api/ipl/data.ts",
+    );
+  }
+
+  return users;
+};
+
+const createRawUsersDocument = (users: ReturnType<typeof loadSeedUsers>) => ({
+  type: RAW_USERS_DOCUMENT_TYPE,
+  updatedAt: new Date().toISOString(),
+  users: users.map((user) => ({
+    rno: user.rno,
+    temname: user.temname,
+    points: user.points,
+    matches: [...user.matches].sort((a, b) => a.matchId - b.matchId),
+  })),
+});
+
+const logPlan = () => {
+  const users = loadSeedUsers();
+  const dashboard = buildManualDashboard(users);
+
+  console.log(`Seed users: ${users.length}`);
+  console.log(
+    `Latest match id: ${Math.max(
+      ...users.flatMap((user) => user.matches.map((match) => match.matchId)),
+    )}`,
+  );
+  console.log(`Reset requested: ${reset ? "yes" : "no"}`);
+  console.log(`Dashboard rows: ${dashboard.daily.length}`);
+  console.log(`Leaderboard rows: ${dashboard.overall.length}`);
+};
+
+const run = async () => {
+  if (dryRun) {
+    logPlan();
+    console.log("Dry run only. No MongoDB writes performed.");
+    return;
+  }
+
+  const uri = process.env.MONGODB_URI;
+
+  if (!uri) {
+    throw new Error("MONGODB_URI is required to seed MongoDB.");
+  }
+
+  const users = loadSeedUsers();
+  const client = new MongoClient(uri);
+
+  try {
+    await client.connect();
+
+    const collection = client.db(DB_NAME).collection(COLLECTION_NAME);
+
+    if (reset) {
+      const result = await collection.deleteMany({});
+      console.log(`Deleted ${result.deletedCount} IPL MongoDB documents.`);
+    }
+
+    const existingRawUsers = await collection.findOne({
+      type: RAW_USERS_DOCUMENT_TYPE,
+    });
+
+    if (!existingRawUsers || force || reset) {
+      await collection.updateOne(
+        { type: RAW_USERS_DOCUMENT_TYPE },
+        { $set: createRawUsersDocument(users) },
+        { upsert: true },
+      );
+      console.log(
+        existingRawUsers
+          ? "Updated raw-users document from local seed data."
+          : "Inserted raw-users document from local seed data.",
+      );
+    } else {
+      console.log(
+        "Skipped raw-users document because it already exists. Use --force to overwrite.",
+      );
+    }
+  } finally {
+    await client.close();
+  }
+};
+
+run().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/template/scripts/sync-cloud.mjs

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+
+const steps = [
+  {
+    label: "dashboard",
+    script: "scripts/sync-ipl.mjs",
+  },
+  {
+    label: "transfers",
+    script: "scripts/sync-transfers-daily.mjs",
+  },
+];
+
+const runStep = (step) =>
+  new Promise((resolve, reject) => {
+    console.log(`\n[cloud-sync] starting ${step.label} sync`);
+
+    const child = spawn(process.execPath, [step.script], {
+      stdio: "inherit",
+      env: process.env,
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code, signal) => {
+      if (code === 0) {
+        console.log(`[cloud-sync] finished ${step.label} sync`);
+        resolve();
+        return;
+      }
+
+      reject(
+        new Error(
+          `[cloud-sync] ${step.label} sync failed with ${
+            signal ? `signal ${signal}` : `exit code ${code ?? "unknown"}`
+          }`,
+        ),
+      );
+    });
+  });
+
+const run = async () => {
+  for (const step of steps) {
+    await runStep(step);
+  }
+};
+
+run().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});