vlr-stats-scraper 1.0.1 → 1.1.0

package/README.md

@@ -34,6 +34,18 @@ npx valstats https://www.vlr.gg/event/2977/vct-2026-americas-stage-2/group-stage
 Each player on that event page gets scraped and saved to `players.db` in your current
 directory, linked to that event name.
 
+Running it again with an event name and year that are already saved replaces that event's
+players with the freshly scraped ones.
+
+### Clearing data
+
+```bash
+npx valstats --clear-event "Stage 2"   # remove one event and its players
+npx valstats --clear                   # wipe the whole database (asks for confirmation)
+```
+
+Players that also belong to another event are kept when a single event is cleared.
+
 ## Library usage
 
 ```js
@@ -62,6 +74,9 @@ savePlayer(player);
 - `addPlayerToEvent(eventId, playerName)`
 - `getEvents()` / `getEventByName(name)`
 - `getPlayersByEvent(eventName)` / `getRandomPlayerFromEvent(eventName)`
+- `emptyEvent(eventName)` — removes an event's players but keeps the event.
+- `clearEvent(eventName)` — removes an event and its players.
+- `clearDatabase()` — deletes every event and player.
 
 ## Data storage
 

package/index.mjs

@@ -11,4 +11,7 @@ export {
   getEventByName,
   getPlayersByEvent,
   getRandomPlayerFromEvent,
+  emptyEvent,
+  clearEvent,
+  clearDatabase,
 } from './scripts/db.mjs';

package/main.mjs

@@ -2,12 +2,51 @@
 import promptSync from 'prompt-sync';
 import { scrapeWebsite } from './scripts/player-link-scraper.mjs';
 import scrapePlayer from './scripts/player-info-scraper.mjs';
-import { savePlayer, saveEvent, addPlayerToEvent } from './scripts/db.mjs';
+import {
+  savePlayer,
+  saveEvent,
+  addPlayerToEvent,
+  getEventByName,
+  emptyEvent,
+  clearEvent,
+  clearDatabase,
+} from './scripts/db.mjs';
 
-const [link, year, eventName] = process.argv.slice(2);
+const args = process.argv.slice(2);
+
+if (args[0] === '--clear') {
+  const prompt = promptSync();
+  const answer = prompt('This deletes every event and player in players.db. Type "yes" to continue: ');
+  if (answer?.trim().toLowerCase() === 'yes') {
+    clearDatabase();
+    console.log('Cleared players.db');
+  } else {
+    console.log('Cancelled');
+  }
+  process.exit(0);
+}
+
+if (args[0] === '--clear-event') {
+  const name = args[1];
+  if (!name) {
+    console.error('Usage: valstats --clear-event <event-name>');
+    process.exit(1);
+  }
+  if (clearEvent(name)) {
+    console.log(`Removed "${name}" and its players from players.db`);
+  } else {
+    console.error(`No event named "${name}" in players.db`);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+const [link, year, eventName] = args;
 
 if (!link || !year || !eventName) {
   console.error('Usage: valstats <link> <year> <event-name>');
+  console.error('       valstats --clear-event <event-name>');
+  console.error('       valstats --clear');
   process.exit(1);
 }
 
@@ -19,6 +58,13 @@ if (isStage) {
   region = prompt('Enter the region: ');
 }
 
+// Re-adding an event + year that's already saved replaces its old players.
+const existing = getEventByName(eventName);
+if (existing && existing.year === parseInt(year, 10)) {
+  emptyEvent(eventName);
+  console.log(`"${eventName}" (${year}) is already in players.db, replacing it`);
+}
+
 const eventId = saveEvent({
   name: eventName,
   url: link,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vlr-stats-scraper",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Scrapes player stats from vlr.gg and stores them in a local SQLite database, grouped by tournament or stage.",
   "homepage": "https://github.com/OverYander/VLR-Webscraper#readme",
   "bugs": {

package/scripts/db.mjs

@@ -161,6 +161,33 @@ function getRandomPlayerFromEvent(eventName) {
   `).get(eventName));
 }
 
+// Deletes players that no longer belong to any event.
+function deleteOrphanedPlayers() {
+  db.prepare('DELETE FROM players WHERE name NOT IN (SELECT player_name FROM event_players)').run();
+}
+
+// Removes every player from an event but keeps the event itself, so it can be re-scraped.
+// Players that are still in other events are kept.
+const emptyEvent = db.transaction((eventName) => {
+  const event = getEventByName(eventName);
+  if (!event) return false;
+  db.prepare('DELETE FROM event_players WHERE event_id = ?').run(event.id);
+  deleteOrphanedPlayers();
+  return true;
+});
+
+// Removes an event and its players. Players that are still in other events are kept.
+const clearEvent = db.transaction((eventName) => {
+  if (!emptyEvent(eventName)) return false;
+  db.prepare('DELETE FROM events WHERE name = ?').run(eventName);
+  return true;
+});
+
+// Wipes every event and player from the database.
+const clearDatabase = db.transaction(() => {
+  db.exec('DELETE FROM event_players; DELETE FROM events; DELETE FROM players;');
+});
+
 export {
   savePlayer,
   getPlayer,
@@ -172,4 +199,7 @@ export {
   getEventByName,
   getPlayersByEvent,
   getRandomPlayerFromEvent,
+  emptyEvent,
+  clearEvent,
+  clearDatabase,
 };