feat: daily aoc post

.env.example

@@ -1,24 +1,26 @@
-# 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
 
-# Channel IDs (from your dev server)
-GUIDES_CHANNEL_ID=your-guide-channel-id
-REPEL_LOG_CHANNEL_ID=your-repel-log-channel-id
+# Optional Role IDs
+# ROLE_A_ID=optional_role_a_id
+# ROLE_B_ID=optional_role_b_id
+# ROLE_C_ID=optional_role_c_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
+# Data Persistence (OPTIONAL)
+# Local development defaults to current directory
+# Docker deployments should use /app/data for persistence
+GUIDES_TRACKER_PATH=guides-tracker.json
+ADVENT_OF_CODE_TRACKER_PATH=advent-of-code-tracker.json

.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)

.gitignore

@@ -19,8 +19,9 @@ yarn-error.log*
 !.env.production
 !.env.example
 
-# guides tracker
+# tracker
 guides-tracker.json
+advent-of-code-tracker.json
 
 # Docker
 docker-compose.yml

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

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": "pnpm run build:dev && node --test test/*.test.mjs",
     "test:ci": "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",

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'),
   },
 };
 

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);
+    }
   }
 );

src/util/advent-scheduler.ts

@@ -0,0 +1,157 @@
+import { ChannelType, type Client, type ForumChannel } 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[];
+};
+
+/**
+ * Load the tracker file to see which days have already been posted
+ */
+async function loadTracker(): Promise<TrackerData> {
+  try {
+    const data = await fs.readFile(TRACKER_FILE, 'utf-8');
+    return JSON.parse(data);
+  } catch (_error) {
+    // If file doesn't exist or can't be read, return empty object
+    return {};
+  }
+}
+
+/**
+ * Save the tracker file with updated data
+ */
+async function saveTracker(data: TrackerData): Promise<void> {
+  await fs.writeFile(TRACKER_FILE, JSON.stringify(data, null, 2), 'utf-8');
+}
+
+/**
+ * Check if a specific day has already been posted for a given year
+ */
+async function isDayPosted(year: number, day: number): Promise<boolean> {
+  const tracker = await loadTracker();
+  const yearData = tracker[year.toString()];
+  return yearData ? yearData.includes(day) : false;
+}
+
+/**
+ * Mark a day as posted for a given year
+ */
+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);
+  }
+}
+
+/**
+ * Create a forum post for a specific Advent of Code day
+ */
+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 as ForumChannel;
+    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;
+  }
+}
+
+/**
+ * Check if today is during Advent of Code (December 1-25) and create post if needed
+ */
+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();
+
+  // Only run during December (month 11)
+  if (month !== 11) {
+    return;
+  }
+
+  // Only run for days 1-25
+  if (day < 1 || day > 25) {
+    return;
+  }
+
+  // Check if we've already posted for this day this year
+  const alreadyPosted = await isDayPosted(year, day);
+  if (alreadyPosted) {
+    console.log(`ℹ️ Advent of Code post for ${year} day ${day} already exists`);
+    return;
+  }
+
+  // Create the post
+  const success = await createAdventPost(client, channelId, year, day);
+
+  // Mark as posted if successful
+  if (success) {
+    await markDayAsPosted(year, day);
+  }
+}
+
+/**
+ * Initialize the Advent of Code scheduler
+ * Runs every day at midnight UTC and checks if we should create a post
+ */
+export function initializeAdventScheduler(client: Client, channelId: string): void {
+  console.log('🎄 Initializing Advent of Code scheduler...');
+
+  // Run immediately on startup to check if we need to post today
+  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
+  // Cron pattern: '0 5 * * *' = At 05:00 UTC every day (midnight UTC-5)
+  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)');
+}