$ show claabs/epicgames-freegames-node
This is a Node.js CLI application (Docker containerized) that automatically logs into the Epic Games Store using device code authentication (OAuth2 device grant), discovers currently free games (weekly promotions and general store discounts), validates ownership via Epic's GraphQL APIs, and sends actionable checkout links to the user through a variety of notification channels (email, Discord, Telegram, Pushover, Gotify, Slack, Home Assistant, Bark, Ntfy, Apprise, webhook, and local browser open). The application uses Puppeteer with a stealth plugin to simulate a browser session for cookie management and authenticated API calls. It runs on a configurable cron schedule, with optional run-on-startup and one-shot modes. It includes a lightweight Express web server to handle device code login redirects and optionally exposes itself via localtunnel for remote accessibility. Configuration is JSON/JSON5 with full class-validator based schema validation and environment variable fallbacks.
The LLM identified 3 files worth highlighting for reuse:
Defines the entire configuration schema using TypeScript classes with class-validator decorators, class-transformer for type casting, and environment variable merging. Provides nested validation for notification configs with discriminated union types via @Type decorator. This pattern is reusable in any TypeScript project needing robust, validated configuration with env overrides.
Defines an abstract NotifierService with a single `sendNotification()` method. Each notification channel (Discord, Telegram, Email, etc.) implements this class, allowing clean plugability. The external API is consistent across all implementations. This pattern can be extacted to any multi-channel notification system.
Contains utility functions to convert between different cookie representtations: EditThisCookie (browser extenion format) to ToughCookie file store, ToughCookie to Puppeteer cookies, and vice versa. Also includes idempotent cookie file conersion and validation. These functions are isolated and can be reused in any project dealing with cookie management and format migratons.