Refactor

.dockerignore

@@ -0,0 +1,70 @@
+# =============================================================================
+# Docker ignore file - exclude unnecessary files from build context
+# =============================================================================
+
+# Dependencies
+node_modules/
+npm-debug.log*
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# IDE and editor files
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Documentation
+*.md
+!README.md
+docs/
+LICENSE
+
+# Testing
+coverage/
+.nyc_output/
+test/
+tests/
+
+# Configuration files that might contain secrets
+.env
+.env.*
+!.env.example
+
+# Logs
+logs/
+*.log
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# ESLint
+.eslintcache
+
+# Docker files (not needed in image)
+Dockerfile*
+docker-compose*.yml
+.dockerignore
+
+# CI/CD
+.github/
+.gitlab-ci.yml
+.travis.yml
+Jenkinsfile
+
+# Dev tools
+.eslintrc*
+.eslint.config*
+tsconfig.json
+jest.config.*
+config.json

.env.example

@@ -0,0 +1,146 @@
+# =============================================================================
+# Discord CS:GO Server Bot - Environment Variables
+# =============================================================================
+# Copy this file to .env and fill in your values
+# All variables are optional except DISCORD_TOKEN (required)
+# =============================================================================
+
+# -----------------------------------------------------------------------------
+# REQUIRED - Discord Bot Configuration
+# -----------------------------------------------------------------------------
+
+# Your Discord bot token (get from https://discord.com/developers/applications)
+DISCORD_TOKEN=your_bot_token_here
+
+# Discord guild ID for registering slash commands (optional, for faster command propagation)
+# If not set, commands are registered globally (may take up to 1 hour to propagate)
+DISCORD_GUILD_ID=
+
+# Discord role ID with admin access (optional - leave empty to disable admin commands)
+# Get your Discord role ID by right-clicking the role in server settings
+ADMIN_ROLE_ID=123456789012345678
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Logging Configuration
+# -----------------------------------------------------------------------------
+
+# Enable or disable logging (true/false)
+LOGGING_ENABLED=true
+
+# Discord guild ID for logging (server where the bot logs activity)
+LOG_GUILD_ID=123456789012345678
+
+# Discord channel ID for logging (channel where the bot posts logs)
+LOG_CHANNEL_ID=123456789012345678
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Fallback Notification Configuration
+# -----------------------------------------------------------------------------
+
+# Fallback guild ID for DM failures
+FALLBACK_GUILD_ID=123456789012345678
+
+# Fallback channel ID for DM failures
+FALLBACK_CHANNEL_ID=123456789012345678
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Embed Configuration
+# -----------------------------------------------------------------------------
+
+# JSON array of embed configurations for server status messages
+# Format: [{"channelID": "xxx", "messageID": "yyy"}]
+# Leave empty to disable embed updates
+EMBEDS=
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Database Configuration
+# -----------------------------------------------------------------------------
+
+# Path to SQLite database file (default: db.sqlite in working directory)
+# For Docker deployments, use: /app/data/db.sqlite
+DATABASE_PATH=db.sqlite
+
+# Embed color in decimal (default: 7980240 = #499999)
+EMBED_COLOR=7980240
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Server Update Configuration
+# -----------------------------------------------------------------------------
+
+# How often to update server status (seconds)
+SERVER_UPDATE_INTERVAL=90
+
+# How often to check for map changes (seconds)
+MAP_CHECK_INTERVAL=91
+
+# Maximum concurrent server queries
+MAX_CONCURRENT_QUERIES=10
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Follow System Configuration
+# -----------------------------------------------------------------------------
+
+# Timeout for follow/unfollow actions (seconds)
+FOLLOW_TIMEOUT=30
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Cache Configuration
+# -----------------------------------------------------------------------------
+
+# User cache TTL (seconds)
+USER_CACHE_TTL=300
+
+# Map image cache TTL (seconds)
+MAP_IMAGE_CACHE_TTL=86400
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Retry Configuration
+# -----------------------------------------------------------------------------
+
+# Maximum retry attempts for failed operations
+RETRY_MAX_RETRIES=3
+
+# Base delay for exponential backoff (seconds)
+RETRY_BASE_DELAY=1
+
+# Maximum retries for GameDig server queries
+GAMEDIG_MAX_RETRIES=4
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Image URLs
+# -----------------------------------------------------------------------------
+
+# Fallback avatar URL for users without profile pictures
+FALLBACK_AVATAR_URL=https://i.imgur.com/cBiDnMi.png
+
+# Image for offline servers
+OFFLINE_SERVER_IMAGE=https://i.imgur.com/WnS0Biz.png
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Map URLs
+# -----------------------------------------------------------------------------
+
+# Surf map statistics URL
+MAP_URLS_SURF_STATS=https://snksrv.com/surfstats/
+MAP_URLS_SURF_IMAGE=https://bans.snksrv.com/images/maps/
+
+# KZ map statistics URL
+MAP_URLS_KZ_STATS=https://snksrv.com/kzstats/#/maps/
+MAP_URLS_KZ_IMAGE=https://raw.githubusercontent.com/KZGlobalTeam/map-images/public/images/
+
+# Bhop map statistics URL
+MAP_URLS_BHOP_STATS=https://snksrv.com/bhopstats/index.php?map=
+MAP_URLS_BHOP_IMAGE=https://bans.snksrv.com/images/maps/
+
+# -----------------------------------------------------------------------------
+# OPTIONAL - Rate Limiting Configuration
+# -----------------------------------------------------------------------------
+
+# Maximum follow commands per minute per user
+RATE_LIMIT_FOLLOW_PER_MINUTE=5
+
+# Maximum unfollow commands per minute per user
+RATE_LIMIT_UNFOLLOW_PER_MINUTE=5
+
+# Maximum IP check commands per minute per user
+RATE_LIMIT_IP_CHECK_PER_MINUTE=10

.github/dependabot.yml

@@ -1,9 +1,16 @@
 version: 2
 updates:
-- package-ecosystem: npm
-  directory: "/"
-  schedule:
-    interval: weekly
-  open-pull-requests-limit: 10
-  reviewers:
-  - Frumpy9
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "docker"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [ master, refactor ]
+  pull_request:
+    branches: [ master, refactor ]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Setup Node.js
+      uses: actions/setup-node@v4
+      with:
+        node-version: '24'
+        cache: 'npm'
+
+    - name: Install dependencies
+      run: npm install
+
+    - name: Run linter
+      run: npm run lint

.gitignore

@@ -1,6 +1,8 @@
 node_modules
-package-lock.json
 config.json
+.env
 notes.txt
 .vscode
-db.sqlite
+db.sqlite
+plans/
+*.backup

.nvmrc

@@ -0,0 +1 @@
+24

Dockerfile

@@ -0,0 +1,64 @@
+ARG NODE_VERSION=24
+# -----------------------------------------------------------------------------
+# Stage 1: Builder - Install dependencies and compile native modules
+# -----------------------------------------------------------------------------
+FROM node:${NODE_VERSION}-alpine AS builder
+
+# Install build dependencies for native modules (better-sqlite3)
+RUN apk add --no-cache \
+    python3 \
+    make \
+    g++ \
+    sqlite \
+    sqlite-dev
+
+WORKDIR /app
+
+# Copy package files first for better layer caching
+COPY package*.json ./
+
+# Install all dependencies (including devDependencies for native module compilation)
+RUN npm ci
+
+# Copy source code
+COPY src/ ./src/
+
+# Rebuild native modules for current Node.js version
+RUN npm rebuild better-sqlite3
+
+# Prune to production dependencies only
+RUN npm prune --production
+
+# -----------------------------------------------------------------------------
+# Stage 2: Production - Minimal runtime image
+# -----------------------------------------------------------------------------
+FROM node:${NODE_VERSION}-alpine AS production
+
+# Install runtime dependencies only
+RUN apk add --no-cache \
+    sqlite
+
+# Create non-root user for security
+RUN addgroup -g 1001 -S nodejs && \
+    adduser -S nodejs -u 1001 -G nodejs
+
+WORKDIR /app
+
+# Copy production dependencies from builder
+COPY --from=builder /app/node_modules ./node_modules
+
+# Copy package.json for version info
+COPY package*.json ./
+
+# Copy application source
+COPY src/ ./src/
+
+# Create data directory for SQLite database and set permissions
+RUN mkdir -p /app/data && \
+    chown -R nodejs:nodejs /app
+
+# Switch to non-root user
+USER nodejs
+
+# Run the bot
+CMD ["node", "src/index.js"]