A simple Bun-powered API service for managing and retrieving user timezones.

Find a file

creations c78e106644 All checks were successful Code quality checks / biome (push) Successful in 13s Details add workflow		2025-05-28 11:00:50 -04:00
.forgejo/workflows	add workflow	2025-05-28 11:00:50 -04:00
config	first commit	2025-05-27 18:36:08 -04:00
src	add route logging	2025-05-28 10:39:10 -04:00
types	first commit	2025-05-27 18:36:08 -04:00
.dockerignore	first commit	2025-05-27 18:36:08 -04:00
.editorconfig	first commit	2025-05-27 18:36:08 -04:00
.gitattributes	first commit	2025-05-27 18:36:08 -04:00
.gitignore	first commit	2025-05-27 18:36:08 -04:00
biome.json	first commit	2025-05-27 18:36:08 -04:00
compose.yml	first commit	2025-05-27 18:36:08 -04:00
Dockerfile	first commit	2025-05-27 18:36:08 -04:00
LICENSE	first commit	2025-05-27 18:36:08 -04:00
logger.json	first commit	2025-05-27 18:36:08 -04:00
package.json	first commit	2025-05-27 18:36:08 -04:00
README.md	first commit	2025-05-27 18:36:08 -04:00
tsconfig.json	fix some issue s with cors and discord	2025-05-27 19:11:19 -04:00

README.md

timezone-db

A simple Bun-powered API service for managing and retrieving user timezones. It supports both local and Discord OAuth-authenticated timezone storage, backed by PostgreSQL and Redis.

Features

Store user timezones via /set endpoint (requires Discord OAuth)
Retrieve timezones by user ID via /get
Cookie-based session handling using Redis
Built-in CORS support
Dockerized with PostgreSQL and DragonflyDB

Requirements

Bun
Docker & Docker Compose
.env file with required environment variables

Environment Variables

Create a .env file with the following:

HOST=0.0.0.0
PORT=3000

PGHOST=postgres
PGPORT=5432
PGUSERNAME=postgres
PGPASSWORD=postgres
PGDATABASE=timezone

REDIS_URL=redis://dragonfly:6379

CLIENT_ID=your_discord_client_id
CLIENT_SECRET=your_discord_client_secret
REDIRECT_URI=https://your.domain/auth/discord/callback

Setup

Build and Run with Docker

docker compose up --build

Development Mode

bun dev

API Endpoints

`GET /get?id=<discord_user_id>`

Returns stored timezone and username for the given user ID.

`GET /set?timezone=<iana_timezone>`

Stores timezone for the authenticated user. Requires Discord OAuth session.

`GET /me`

Returns Discord profile info for the current session.

`GET /auth/discord`

Starts OAuth2 authentication flow.

`GET /auth/discord/callback`

Handles OAuth2 redirect and sets a session cookie.

License

BSD-3-Clause