Files

T

branderson a1f53c5d1e fix(auth): read a repeated trusted header as one value, refuse conflicts

A proxy that sets the username header twice, as when Authentik's nginx
snippet and the documented lines are both present, made Node join the values
into "brad, brad" and create an account of that name instead of signing in
brad. Read each occurrence separately: identical repeats count once, and
conflicting ones are refused. The docs now note Authentik's snippet already
sets the headers.

2026-10-12 01:59:31 -07:00

scripts

feat: revamp the game serving feature

2026-02-07 23:36:45 +07:00

src

fix(auth): read a repeated trusted header as one value, refuse conflicts

2026-10-12 01:59:31 -07:00

.env.example

chore(config): centralize and document environment variables

2026-08-11 16:02:06 +07:00

.eslintrc.json

chore: apply consistent code formatting across codebase

2026-02-04 06:03:39 +07:00

.gitignore

feat: initial features

2026-01-16 23:58:21 +07:00

docker-entrypoint.sh

feat(startup): serve the app while the server warms up

2026-08-12 14:05:14 +07:00

package-lock.json

feat: initial features

2026-01-16 23:58:21 +07:00

package.json

fix(playlists): bundle community playlist index

2026-08-13 13:57:52 +07:00

README.md

feat: revamp the game serving feature

2026-02-07 23:36:45 +07:00

tsconfig.json

feat: add shared download registry, type safety, and test infra

2026-02-11 14:43:00 +07:00

vitest.config.ts

feat: add shared download registry, type safety, and test infra

2026-02-11 14:43:00 +07:00

README.md

Flashpoint Web Backend

Node.js/Express API server for the Flashpoint Archive web application.

Features

RESTful API for game metadata
Direct SQLite database access (read-only)
Integrated game content serving (proxy + ZIP)
Image and logo serving
Playlist management
Platform and tag endpoints

Quick Start

# Install dependencies
npm install

# Configure environment
cp .env.example .env

# Start development server
npm run dev

Server runs on http://localhost:3100

API Endpoints

See ../../api-specification.md for complete API documentation.

Core Endpoints

GET /health - Health check
GET /api/games - List games
GET /api/games/:id - Get game details
GET /api/platforms - List platforms
GET /api/tags - List tags
GET /api/playlists - List playlists

Architecture

src/
├── routes/          # Express route handlers
├── services/        # Business logic layer
├── game/            # Integrated game service (proxy, ZIP, CGI)
├── middleware/      # Express middleware
├── utils/           # Helper functions
├── config.ts        # Configuration management
└── server.ts        # Application entry point

Database

Uses sql.js (pure JavaScript SQLite) for direct read-only access to:

D:\Flashpoint\Data\flashpoint.sqlite

No native compilation required! sql.js is a WebAssembly-based SQLite implementation that works without Visual Studio or build tools.

Schema includes tables for games, platforms, tags, and more.

Development

npm run dev        # Start with hot reload (tsx)
npm run build      # Compile TypeScript
npm run start      # Run compiled version
npm run typecheck  # Type checking only
npm run lint       # ESLint

Environment Variables

Required:

FLASHPOINT_PATH - Path to Flashpoint installation
FLASHPOINT_DB_PATH - Path to SQLite database

Optional:

PORT - Server port (default: 3100)
NODE_ENV - Environment (development/production)
DOMAIN - Frontend origin (default: http://localhost:5173)

See .env.example for all options.