Merge branch 'main' into feat/onboarding

hmd-ali · hmd-ali · commit facfd9f72dbe · 2025-11-12T23:35:25.000+02:00
diff --git a/.env.example b/.env.example
@@ -1,17 +1,27 @@
-# Local Environment Variables (Secrets)
-# Copy this file to .env and fill in your actual values
-# .env is gitignored and should NEVER be committed
+# Discord Bot Credentials (REQUIRED - Secret values, do not commit!)
+DISCORD_TOKEN=your_discord_bot_token_here
+CLIENT_ID=your_discord_client_id_here
 
-# Discord Bot Token & Application ID (REQUIRED)
-# Get this from: https://discord.com/developers/applications
-DISCORD_TOKEN=your-bot-token-here
-CLIENT_ID=your-bot-application-id
+# Server Configuration (REQUIRED)
+SERVER_ID=your_server_id_here
 
-# Override any public config values for local testing
+# Channel IDs (REQUIRED)
+GUIDES_CHANNEL_ID=your_guides_channel_id_here
+ADVENT_OF_CODE_CHANNEL_ID=your_advent_of_code_forum_channel_id_here
+REPEL_LOG_CHANNEL_ID=your_repel_log_channel_id_here
 
-# Discord Server ID (your dev server)
-SERVER_ID=your-server-id
+# Role IDs (REQUIRED)
+MODERATORS_ROLE_IDS=role_id_1,role_id_2,role_id_3
+REPEL_ROLE_ID=your_repel_role_id_here
 
+# Optional Role IDs
+# ROLE_A_ID=optional_role_a_id
+# ROLE_B_ID=optional_role_b_id
+# ROLE_C_ID=optional_role_c_id
+
+# Data Persistence (OPTIONAL)
+# Local development defaults to current directory
+# Docker deployments should use /app/data for persistence
 # Channel IDs (from your dev server)
 GUIDES_CHANNEL_ID=your-guide-channel-id
 REPEL_LOG_CHANNEL_ID=your-repel-log-channel-id
@@ -23,5 +33,7 @@ MODERATORS_ROLE_IDS=your-moderator-role-id
 ONBOARDING_ROLE_ID=onboarding-role-id
 # Other
 GUIDES_TRACKER_PATH=guides-tracker.json
+ADVENT_OF_CODE_TRACKER_PATH=advent-of-code-tracker.json
+
 
 
diff --git a/.env.production b/.env.production
@@ -8,12 +8,14 @@ SERVER_ID=434487340535382016
 # Channel IDs (from your dev server)
 GUIDES_CHANNEL_ID=1429492053825290371
 REPEL_LOG_CHANNEL_ID=1403558160144531589
+ADVENT_OF_CODE_CHANNEL_ID=1047623689488830495
 
 # Role IDs (from your dev server)
 REPEL_ROLE_ID=1002411741776461844
 MODERATORS_ROLE_IDS=849481536654803004
 
 # Other
 GUIDES_TRACKER_PATH=/app/data/guides-tracker.json
+ADVENT_OF_CODE_TRACKER_PATH=/app/data/advent-of-code-tracker.json
 
 # Note: DISCORD_TOKEN & CLIENT_ID should be in .env.local (not committed)
diff --git a/.env.test b/.env.test
@@ -14,11 +14,13 @@ SERVER_ID=your-server-id
 
 # Channel IDs (from your dev server)
 GUIDES_CHANNEL_ID=your-guide-channel-id
+ADVENT_OF_CODE_CHANNEL_ID=your_advent_of_code_forum_channel_id_here
 REPEL_LOG_CHANNEL_ID=your-repel-log-channel-id
 
 # Role IDs (from your dev server)
 REPEL_ROLE_ID=your-repel-role-id
 MODERATORS_ROLE_IDS=your-moderator-role-id
 
 # Other
-GUIDES_TRACKER_PATH=guides-tracker.json
+GUIDES_TRACKER_PATH=guides-tracker.json
+ADVENT_OF_CODE_TRACKER_PATH=test-advent-tracker.json
diff --git a/.gitignore b/.gitignore
@@ -20,8 +20,9 @@ yarn-error.log*
 !.env.example
 !.env.test
 
-# guides tracker
+# tracker
 guides-tracker.json
+advent-of-code-tracker.json
 
 # Docker
 docker-compose.yml
diff --git a/docker-compose.yml b/docker-compose.yml
@@ -15,7 +15,7 @@ services:
     volumes:
       # Mount environment config file
       - ./.env.production:/app/.env.production:ro
-      # Persist guides tracker data
+      # Persist tracker data
       - guides-data:/app/data
     profiles:
       - prod
diff --git a/package.json b/package.json
@@ -21,7 +21,7 @@
     "check": "biome check .",
     "check:fix": "biome check --write .",
     "typecheck": "tsc --noEmit",
-    "test": "pnpm run build:dev && node --test dist/**/*.test.js",
+    "test": "tsx --test '**/*.test.ts'",
     "test:ci": "NODE_ENV=test node --test dist/**/*.test.js",
     "prepare": "husky",
     "pre-commit": "lint-staged",
@@ -34,12 +34,14 @@
   "packageManager": "pnpm@10.17.1",
   "dependencies": {
     "discord.js": "^14.22.1",
+    "node-cron": "^4.2.1",
     "typescript": "^5.9.3",
     "web-features": "^3.7.0"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.4",
     "@types/node": "^24.5.2",
+    "@types/node-cron": "^3.0.11",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.1",
     "tsup": "^8.5.0",
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/src/env.ts b/src/env.ts
@@ -23,6 +23,7 @@ export const config = {
   serverId: requireEnv('SERVER_ID'),
   fetchAndSyncMessages: true,
   guidesTrackerPath: optionalEnv('GUIDES_TRACKER_PATH'),
+  adventOfCodeTrackerPath: requireEnv('ADVENT_OF_CODE_TRACKER_PATH'),
   roleIds: {
     moderators: requireEnv('MODERATORS_ROLE_IDS')
       ? requireEnv('MODERATORS_ROLE_IDS').split(',')
@@ -35,6 +36,7 @@ export const config = {
   channelIds: {
     repelLogs: requireEnv('REPEL_LOG_CHANNEL_ID'),
     guides: requireEnv('GUIDES_CHANNEL_ID'),
+    adventOfCode: requireEnv('ADVENT_OF_CODE_CHANNEL_ID'),
   },
   onboarding: {
     channelId: optionalEnv('ONBOARDING_CHANNEL_ID'),
diff --git a/src/events/ready.ts b/src/events/ready.ts
@@ -1,5 +1,6 @@
 import { Events } from 'discord.js';
 import { config } from '../env.js';
+import { initializeAdventScheduler } from '../util/advent-scheduler.js';
 import { fetchAndCachePublicChannelsMessages } from '../util/cache.js';
 import { createEvent } from '../util/events.js';
 import { syncGuidesToChannel } from '../util/post-guides.js';
@@ -44,5 +45,12 @@ export const readyEvent = createEvent(
         }
       }
     }
+
+    // Initialize Advent of Code scheduler
+    try {
+      initializeAdventScheduler(client, config.channelIds.adventOfCode);
+    } catch (error) {
+      console.error('❌ Failed to initialize Advent of Code scheduler:', error);
+    }
   }
 );
diff --git a/src/util/advent-scheduler.test.ts b/src/util/advent-scheduler.test.ts
@@ -0,0 +1,47 @@
+import assert from 'node:assert/strict';
+import { promises as fs } from 'node:fs';
+import test from 'node:test';
+import { config } from '../env.js';
+
+// Import after setting env var
+const { loadTracker, saveTracker } = await import('./advent-scheduler.js');
+
+async function cleanupTestTracker() {
+  try {
+    await fs.unlink(config.adventOfCodeTrackerPath);
+  } catch (_error) {
+    // File might not exist, that's fine
+  }
+}
+
+test('advent scheduler: tracker file operations', async (t) => {
+  await t.test('should create empty tracker if file does not exist', async () => {
+    await cleanupTestTracker();
+    const tracker = await loadTracker();
+    assert.deepEqual(tracker, {});
+  });
+
+  await t.test('should save and load tracker data correctly', async () => {
+    const testData = {
+      '2025': [1, 2, 3],
+      '2026': [1],
+    };
+    await saveTracker(testData);
+    const loaded = await loadTracker();
+    assert.deepEqual(loaded, testData);
+  });
+
+  await t.test('should track multiple days per year', async () => {
+    const tracker = {
+      '2025': [1, 5, 10, 15, 20, 25],
+    };
+    await saveTracker(tracker);
+    const loaded = await loadTracker();
+    assert.equal(loaded['2025'].length, 6);
+    assert.ok(loaded['2025'].includes(1));
+    assert.ok(loaded['2025'].includes(25));
+  });
+
+  // Cleanup
+  await cleanupTestTracker();
+});
diff --git a/src/util/advent-scheduler.ts b/src/util/advent-scheduler.ts
@@ -0,0 +1,133 @@
+import { ChannelType, type Client } from 'discord.js';
+import * as cron from 'node-cron';
+import { promises as fs } from 'node:fs';
+import { config } from '../env.js';
+
+const TRACKER_FILE = config.adventOfCodeTrackerPath;
+
+type TrackerData = {
+  [year: string]: number[];
+};
+
+export async function loadTracker(): Promise<TrackerData> {
+  try {
+    const data = await fs.readFile(TRACKER_FILE, 'utf-8');
+    return JSON.parse(data);
+  } catch {
+    // If file doesn't exist or can't be read, return empty object
+    return {};
+  }
+}
+
+export async function saveTracker(data: TrackerData): Promise<void> {
+  await fs.writeFile(TRACKER_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+async function isDayPosted(year: number, day: number): Promise<boolean> {
+  const tracker = await loadTracker();
+  const yearData = tracker[year.toString()];
+  return yearData ? yearData.includes(day) : false;
+}
+
+async function markDayAsPosted(year: number, day: number): Promise<void> {
+  const tracker = await loadTracker();
+  const yearKey = year.toString();
+
+  if (!tracker[yearKey]) {
+    tracker[yearKey] = [];
+  }
+
+  if (!tracker[yearKey].includes(day)) {
+    tracker[yearKey].push(day);
+    tracker[yearKey].sort((a, b) => a - b);
+    await saveTracker(tracker);
+  }
+}
+
+async function createAdventPost(
+  client: Client,
+  channelId: string,
+  year: number,
+  day: number
+): Promise<boolean> {
+  try {
+    const channel = await client.channels.fetch(channelId);
+
+    if (!channel) {
+      console.error(`❌ Advent of Code channel not found: ${channelId}`);
+      return false;
+    }
+
+    if (channel.type !== ChannelType.GuildForum) {
+      console.error(`❌ Advent of Code channel is not a forum channel. Type: ${channel.type}`);
+      return false;
+    }
+
+    const forumChannel = channel;
+    const title = `Day ${day}, ${year}`;
+    const content = `https://adventofcode.com/${year}/day/${day}`;
+
+    await forumChannel.threads.create({
+      name: title,
+      message: {
+        content: content,
+      },
+    });
+
+    console.log(`✅ Created Advent of Code post: ${title}`);
+    return true;
+  } catch (error) {
+    console.error(`❌ Failed to create Advent of Code post for day ${day}:`, error);
+    return false;
+  }
+}
+
+async function checkAndCreateTodaysPost(client: Client, channelId: string): Promise<void> {
+  const now = new Date();
+  const month = now.getUTCMonth(); // 0-indexed, so December is 11
+  const day = now.getUTCDate();
+  const year = now.getUTCFullYear();
+
+  if (month !== 11) {
+    return;
+  }
+
+  if (day < 1 || day > 25) {
+    return;
+  }
+
+  const alreadyPosted = await isDayPosted(year, day);
+  if (alreadyPosted) {
+    console.log(`ℹ️ Advent of Code post for ${year} day ${day} already exists`);
+    return;
+  }
+
+  const success = await createAdventPost(client, channelId, year, day);
+
+  if (success) {
+    await markDayAsPosted(year, day);
+  }
+}
+
+/**
+ * Initialize the Advent of Code scheduler
+ * Runs every day at midnight UTC-5 and checks if we should create a post
+ */
+export function initializeAdventScheduler(client: Client, channelId: string): void {
+  console.log('🎄 Initializing Advent of Code scheduler...');
+
+  checkAndCreateTodaysPost(client, channelId).catch((error) => {
+    console.error('❌ Error checking for Advent of Code post on startup:', error);
+  });
+
+  // Schedule to run every day at midnight UTC-5
+  // https://github.com/node-cron/node-cron?tab=readme-ov-file#cron-syntax
+  cron.schedule('0 5 * * *', () => {
+    console.log('⏰ Running scheduled Advent of Code check...');
+    checkAndCreateTodaysPost(client, channelId).catch((error) => {
+      console.error('❌ Error in scheduled Advent of Code check:', error);
+    });
+  });
+
+  console.log('✅ Advent of Code scheduler initialized (runs daily at midnight UTC)');
+}

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,6 @@`
`1`	`1`	`import { Events } from 'discord.js';`
`2`	`2`	`import { config } from '../env.js';`
	`3`	`+import { initializeAdventScheduler } from '../util/advent-scheduler.js';`
`3`	`4`	`import { fetchAndCachePublicChannelsMessages } from '../util/cache.js';`
`4`	`5`	`import { createEvent } from '../util/events.js';`
`5`	`6`	`import { syncGuidesToChannel } from '../util/post-guides.js';`
`@@ -44,5 +45,12 @@ export const readyEvent = createEvent(`
`44`	`45`	`}`
`45`	`46`	`}`
`46`	`47`	`}`
	`48`	`+`
	`49`	`+ // Initialize Advent of Code scheduler`
	`50`	`+ try {`
	`51`	`+ initializeAdventScheduler(client, config.channelIds.adventOfCode);`
	`52`	`+ } catch (error) {`
	`53`	`+ console.error('❌ Failed to initialize Advent of Code scheduler:', error);`
	`54`	`+ }`
`47`	`55`	`}`
`48`	`56`	`);`