');
+ });
+
+ it('serves a nested JS asset with the correct Content-Type', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/assets/app.js')
+ .expect(200);
+
+ expect(res.headers['content-type']).toMatch(/javascript/);
+ expect(res.text).toContain('console.log');
+ });
+
+ it('serves a nested CSS asset with the correct Content-Type', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/assets/style.css')
+ .expect(200);
+
+ expect(res.headers['content-type']).toMatch(/css/);
+ expect(res.text).toContain('margin');
+ });
+
+ it('serves favicon.ico', async () => {
+ await supertest(`http://localhost:${PORT}`)
+ .get('/favicon.ico')
+ .expect(200);
+ });
+ });
+
+ // ── 3. SPA fallback enabled (default) ──────────────────────────────────────
+ describe('SPA fallback — spaFallback: true (default)', () => {
+ let server: IOServer;
+ const PORT = 3021;
+
+ beforeAll(async () => {
+ server = new IOServer({
+ host: 'localhost',
+ port: PORT,
+ verbose: 'ERROR',
+ routes: './tests/routes',
+ rootDir: staticDir,
+ spaFallback: true,
+ });
+ await server.start();
+ });
+
+ afterAll(async () => {
+ await server.stop();
+ });
+
+ it('returns index.html (200) for an unknown deep route', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/settings/profile')
+ .expect(200);
+
+ expect(res.headers['content-type']).toMatch(/text\/html/);
+ expect(res.text).toContain('
');
+ });
+
+ it('returns index.html for any unknown route at root level', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/about')
+ .expect(200);
+
+ expect(res.text).toContain('
');
+ });
+ });
+
+ // ── 4. SPA fallback disabled ───────────────────────────────────────────────
+ describe('SPA fallback — spaFallback: false', () => {
+ let server: IOServer;
+ const PORT = 3022;
+
+ beforeAll(async () => {
+ server = new IOServer({
+ host: 'localhost',
+ port: PORT,
+ verbose: 'ERROR',
+ routes: './tests/routes',
+ rootDir: staticDir,
+ spaFallback: false,
+ });
+ await server.start();
+ });
+
+ afterAll(async () => {
+ await server.stop();
+ });
+
+ it('returns 404 JSON for an unknown route', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/does-not-exist')
+ .expect(404);
+
+ expect(res.body).toHaveProperty('statusCode', 404);
+ expect(res.body).toHaveProperty('error', 'Not Found');
+ });
+
+ it('still serves existing static files normally', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/assets/app.js')
+ .expect(200);
+
+ expect(res.headers['content-type']).toMatch(/javascript/);
+ });
+ });
+
+ // ── 5. API routes have priority over static files ──────────────────────────
+ describe('API route priority over static assets', () => {
+ let server: IOServer;
+ const PORT = 3023;
+
+ class ApiController extends BaseController {
+ async getStatus(request: any, reply: any): Promise {
+ reply.send({ source: 'api', ok: true });
+ }
+
+ async postData(request: any, reply: any): Promise {
+ reply.send({ received: request.body });
+ }
+ }
+
+ beforeAll(async () => {
+ server = new IOServer({
+ host: 'localhost',
+ port: PORT,
+ verbose: 'ERROR',
+ routes: './tests/routes',
+ rootDir: staticDir,
+ spaFallback: true,
+ });
+
+ server.addController({
+ name: 'api',
+ controller: ApiController,
+ prefix: '/api',
+ });
+
+ await server.start();
+ });
+
+ afterAll(async () => {
+ await server.stop();
+ });
+
+ it('returns JSON from the controller at /api/status', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/api/status')
+ .expect(200);
+
+ expect(res.body).toEqual({ source: 'api', ok: true });
+ // Must NOT be the HTML index
+ expect(res.headers['content-type']).toMatch(/json/);
+ });
+
+ it('still serves static files alongside API routes', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/assets/app.js')
+ .expect(200);
+
+ expect(res.headers['content-type']).toMatch(/javascript/);
+ });
+
+ it('SPA fallback does not intercept API routes (returns JSON, not HTML)', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/api/status')
+ .expect(200);
+
+ expect(res.headers['content-type']).not.toMatch(/text\/html/);
+ });
+ });
+
+ // ── 6. Server without rootDir preserves default 404 behaviour ─────────────
+ describe('No rootDir — standard 404 behaviour preserved', () => {
+ let server: IOServer;
+ const PORT = 3024;
+
+ beforeAll(async () => {
+ server = new IOServer({
+ host: 'localhost',
+ port: PORT,
+ verbose: 'ERROR',
+ routes: './tests/routes',
+ // rootDir intentionally omitted
+ });
+ await server.start();
+ });
+
+ afterAll(async () => {
+ await server.stop();
+ });
+
+ it('returns 404 JSON for unknown routes when no rootDir is set', async () => {
+ const res = await supertest(`http://localhost:${PORT}`)
+ .get('/some/unknown/path')
+ .expect(404);
+
+ expect(res.body).toHaveProperty('statusCode', 404);
+ expect(res.body).toHaveProperty('error', 'Not Found');
+ expect(res.headers['content-type']).toMatch(/json/);
+ });
+ });
+});