api.matthew-hre.com#

Personal API powering matthew-hre.com. Built with Hono on Cloudflare Workers, backed by D1, and managed with Wrangler.

Endpoints#

GET /vinyl#

Paginated vinyl collection, synced from Discogs every 6 hours via cron.

GET /activity/music#

Currently playing (or last played) track from Last.fm. Polled into D1 every minute by a cron trigger.

GET /activity/music/stream#

SSE stream that pushes track changes. Reads from the D1-cached value every 10s and emits when it changes.

Local Development#

nix develop                              # gets you bun + wrangler

bun install
wrangler d1 create api                   # one-time; copy the id into wrangler.toml
bun run migrate:local                    # applies migrations/ to local D1
bun run dev                              # starts the worker on :8787

Trigger the cron handlers locally with:

# Last.fm poll
curl 'http://localhost:8787/__scheduled?cron=*+*+*+*+*'
# Discogs sync
curl 'http://localhost:8787/__scheduled?cron=0+*/6+*+*+*'

Deployment#

bun run migrate:remote    # apply migrations to remote D1
bun run deploy            # wrangler deploy

Secrets#

Set with wrangler secret put <NAME>:

LASTFM_USERNAME and DISCOGS_USER are plain [vars] in wrangler.toml.