Dependencies version updates

[kentcdodds]

Updates various dependencies to their latest compatible versions.

Test Plan

• CI=true npx playwright test tests/e2e/error-boundary.test.ts --retries=0 --workers=1 was used to validate server/router behavior after dependency updates.
• npm run test:e2e:run was started but not completed due to runtime length; full coverage is recommended via CI.

Checklist

• Tests updated
• Docs updated

Screenshots

---

 

---

Note

Medium Risk
Mostly test/docs churn, but the cache DB init now throws when CACHE_DATABASE_PATH is missing and changes file-deletion behavior on startup, which could impact deployments with misconfigured env or corrupted cache files.

Overview
Updates runtime/test compatibility for dependency bumps by adjusting route loader tests to include unstable_pattern (via shared LOADER_ARGS_BASE) and tightening a FileUpload type cast when streaming uploads.

Hardens SQLite cache initialization in cache.server.ts by failing fast when CACHE_DATABASE_PATH is unset and by replacing unlinkSync with a safer rmSync(..., { force: true }) retry path when the cache DB file is corrupt.

Also includes documentation-only reformatting plus a new docs/testing.md prerequisite to copy .env.example to .env before running tests.

^{Written by Cursor Bugbot for commit fb6b060. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

[kentcdodds]

@cursor, please check CI and fix the failures

[cursor]

Taking a look!

 

[kentcdodds]

@cursor, please check and fix CI (again).

[cursor]

Taking a look!

 

[kentcdodds]

@cursor, I would rather not jump into using an in-memory db for tests. Can you remove that and restore the version of whatever dependency required that you do that?

[cursor]

Summary

• Removed the test-only in-memory cache DB and restored file-backed cache handling in cache.server.【F:app/utils/cache.server.ts†L22-L75】
• Restored vitest and @vitest/coverage-v8 to v3.1.3 as the dependency rollback requested.【F:package.json†L136-L154】

Testing

• ✅ npm run typecheck — confirm TypeScript passes after the rollback.【F:/opt/cursor/artifacts/typecheck.log†L1-L4】
• ⚠️ npm run test -- --coverage — not run because global setup executes npx prisma migrate reset --force --skip-seed --skip-generate, which requires explicit consent.【F:tests/setup/global-setup.ts†L12-L36】

Manual UI testing not run because changes are dependency/test infrastructure only. If you want me to run Vitest, confirm the Prisma reset is acceptable in CI/test.

 

[kentcdodds]

@cursor check CI and fix.

[cursor]

Summary

• Kept file-backed cache for tests but isolated it per Vitest worker/thread to avoid SQLite lock contention while honoring your request to avoid in-memory DBs.【F:app/utils/cache.server.ts†L1-L76】

Testing

• ✅ npm run typecheck — confirms TS remains green after the cache change.【F:/opt/cursor/artifacts/typecheck.log†L1-L4】
• ⚠️ npm run test -- --coverage — not run because global setup executes npx prisma migrate reset --force --skip-seed --skip-generate, which requires explicit consent before I can run it.【F:tests/setup/global-setup.ts†L12-L36】

Manual UI testing not run because changes are test/runtime infrastructure only.

If you want me to run Vitest in CI locally, please confirm the Prisma reset is acceptable.

 

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{Bugbot Autofix is ON. A Cloud Agent has been kicked off to fix the reported issue.}

[cursor]

Bugbot Autofix resolved the bug found in the latest run.

• ✅ Fixed: Fetch body handling removed for FileUpload objects
  • Restored the conditional logic file instanceof File ? file : file.stream() to properly handle both File and FileUpload types as fetch body.

[kentcdodds]

@cursor, please fix CI (typescript is failing)

[cursor]

Bugbot Autofix resolved the bug found in the latest run.

• ✅ Fixed: Fetch body handling removed for FileUpload objects
  • Restored the conditional logic file instanceof File ? file : file.stream() to properly handle both File and FileUpload types as fetch body.