A tool to help Granblue Fantasy players create and share teams and strategies.
Find a file
Justin Edmund 426645813e
Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428)
## Summary
- Fixes periodic production crashes (undici ECONNREFUSED ::1) by
bounding server cache size/lifetime and hardening server HTTP client.

### Root cause
- React server cache (cache(...)) held axios responses indefinitely
across many parameter combinations, causing slow memory growth until the
Next.js app router worker was OOM-killed. The main server then failed
IPC to the worker (ECONNREFUSED ::1:<port>).

### Changes
- `app/lib/data.ts`: Replace unbounded cache(...) with unstable_cache
and explicit keys; TTLs: 60s for teams/detail/favorites/user, 300s for
meta (jobs/skills/accessories/raids/version).
- `app/lib/api-utils.ts`: Add shared Axios instance with 15s timeout and
keepAlive http/https agents; apply to GET/POST/PUT/DELETE helpers.
- `pages/api/preview/[shortcode].ts`: Remove duplicate handler to dedupe
route; retain the .tsx variant using `NEXT_PUBLIC_SIERO_API_URL`.

### Notes
- Build currently has pre-existing app/pages route duplication errors;
out of scope here but unrelated to this fix.
- Ensure `NEXT_PUBLIC_SIERO_API_URL` and `NEXT_PUBLIC_SIERO_OAUTH_URL`
are set on Railway.

### Risk/impact
- Low risk; behavior is unchanged aside from bounded caching and
resilient HTTP.
- Cache TTLs can be tuned later if needed.

### Test plan
- Verify saved/teams/user pages load and revalidate after TTL.
- Validate API routes still proxy correctly; timeouts occur after ~15s
for hung upstreams.
- Monitor memory over several days; expect stable usage without steady
growth.
2025-08-31 12:16:42 -07:00
.storybook Deploy organization and bug fixes (#299) 2023-04-12 06:37:41 -07:00
.vscode Break collection pages into hooks (#414) 2024-04-21 00:46:04 -07:00
app Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
components Fix saving characters (#427) 2025-02-25 10:53:45 -05:00
data February 2024 updates and bug fixes (#407) 2024-02-21 23:18:53 -05:00
extensions Add support for including/excluding items from team filtering (#363) 2023-08-21 20:01:11 -07:00
hooks Further GridRep and Collection fixes (#417) 2024-04-23 05:11:23 -07:00
pages Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
public Add weapons and items from April and early May (#420) 2024-05-06 16:49:57 -07:00
styles Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
supervisord Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
types Jedmund/image embeds 2 (#424) 2025-02-09 22:54:15 -08:00
utils Fix saving characters (#427) 2025-02-25 10:53:45 -05:00
.aidigestignore Jedmund/image embeds 2 (#424) 2025-02-09 22:54:15 -08:00
.env.sample February 2023 Update (#158) 2023-02-04 23:46:24 -08:00
.eslintrc.json Deploy organization and bug fixes (#299) 2023-04-12 06:37:41 -07:00
.gitignore Jedmund/image embeds 2 (#424) 2025-02-09 22:54:15 -08:00
.prettierignore Add prettierignore 2022-12-04 07:18:59 -08:00
.prettierrc Remove trailing semicolons 2022-12-05 17:54:46 -08:00
CLAUDE.md Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
middleware.ts Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
mise.toml Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
next-env.d.ts Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
next-i18next.config.js Update next-i18next.config.js 2022-03-05 02:29:50 -08:00
next.config.js More work on image embeds (#423) 2025-01-20 03:51:21 -08:00
package-lock.json Updates next-usequerystate to nuqs (#399) 2024-01-08 04:20:45 -08:00
package.json Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
README.md July 2023 Feature Release: Rich text editor and support for tagging objects (#340) (#341) 2023-07-05 21:51:30 -07:00
README.png February 2023 Update (#158) 2023-02-04 23:46:24 -08:00
tsconfig.json Fix intermittent crash: bounded caching + HTTP timeouts/keepAlive + preview route dedupe (#428) 2025-08-31 12:16:42 -07:00
tslint.json Create tslint.json 2022-01-28 23:19:31 -08:00

Header image for hensei-web

hensei-web

hensei-web is the frontend for granblue.team, an app for saving and sharing teams for Granblue Fantasy.

Getting Started

First, you have to set up your environment file. You should start with .env.sample, but here are some gotchas:

App URLs

Don't add a trailing slash to these URLs! The API will run on port 3000 by default, but make sure to change these to match your instance of the API.

NEXT_PUBLIC_SIERO_API_URL='http://127.0.0.1:3000/api/v1'
NEXT_PUBLIC_SIERO_OAUTH_URL='http://127.0.0.1:3000/oauth'

Asset URLs

Next.js serves all assets out of the /public directory. In development we utilize this for all assets, but in production, you will want to host these images on a cloud storage provider like Amazon S3. Once you have that set up and you're running in a production environment, change this to the full bucket URL.

NEXT_PUBLIC_SIERO_IMG_URL='/images'

Dependencies

Once your .env is all set up, install all dependencies:

npm install
# or
yarn install

Then, run the development server with:

npm run dev
# or
yarn dev

Assets

The hensei-api repository has tasks that will help you get assets, although some were crafted or renamed by hand. The front-end expects this folder structure inside of the images folder:

root
├─ accessory-grid/
├─ accessory-square/
├─ awakening/
├─ ax/
├─ character-main/
├─ character-grid/
├─ character-square/
├─ guidebooks/
├─ jobs/
├─ job-icons/
├─ job-portraits/
├─ job-skills/
├─ labels/
├─ mastery/
├─ placeholders/
├─ raids/
├─ summon-main/
├─ summon-grid/
├─ summon-square/
├─ updates/
├─ weapon-main/
├─ weapon-grid/
├─ weapon-keys/
├─ weapon-square/