- InitSchema migration now issues PRAGMA journal_mode = WAL after
PRAGMA foreign_keys = ON so fresh DBs are created in WAL mode.
- DatabaseInitService.init() also calls ensureWalMode() after
dataSource.initialize() so warm DBs (where migrations are skipped)
have WAL applied and persisted on every startup. Logs whether it
was already set or just enabled.
- main.ts now serves an OpenAPI 3.1 document at /api/docs and
/api/docs-json. A new toOpenApi31() utility converts the
NestJS-generated 3.0 document by setting openapi=3.1.0, normalising
the required info fields, and rewriting every legacy
'nullable: true' marker into a JSON Schema 2020-12 type union
('type: [<orig>, "null"]'). Recursion handles components, paths,
parameters, request bodies, response bodies, properties, items,
oneOf/anyOf/allOf, and parameter/request schemas.
- 7 new unit tests in tests/backend/openapi31.spec.ts lock the
conversion behaviour; total suite: 83 tests across 18 specs.
- main.ts awaits DatabaseInitService.init() before app.listen(), ensuring
migrations + seed run before the HTTP server accepts traffic.
- AppModule now uses NestModule with consumer.apply() no longer needed for
CSRF (registered globally via app.use after body parsers in main.ts).
- JwtAuthGuard extended from AuthGuard('jwt') so protected endpoints
actually validate the bearer token.
- Admin controller now uses Zod-validated DTOs for body/path/query:
createUser, updateUserRole, userIdParam, listUsersQuery; with @Public
/ @Roles decorators and AdminGuard applied.
- Multer upload module + controller (POST /api/v1/uploads/category-icon
and /challenge-file) with safe-filename strategy, configured
UPLOAD_SIZE_LIMIT, admin-only via AdminGuard, served via /uploads
static handler.
- ThemeLoaderService now requires all 10 canonical theme ids at startup,
backfilling missing themes from built-ins with a warning; validates the
configured themeKey setting and falls back to 'classic' if invalid;
gracefully tolerates missing setting table during early boot.
- Test suite expanded to 76 tests / 17 suites; new specs:
admin-validation, uploads, theme-required, database-init.
OpenVelo Agent