fix(ssr): remove spider-only gate — serve full SSR to all users
CI Pipeline / backend-test (pull_request) Successful in 9m46s
CI Pipeline / frontend-test (pull_request) Successful in 23s
CI Pipeline / frontend-build (pull_request) Successful in 30s
CI Pipeline / backend-lint (pull_request) Successful in 8s
CI Pipeline / quality-gate (push) Successful in 2s
CI Pipeline / backend-test (push) Successful in 9m58s
CI Pipeline / frontend-test (push) Successful in 23s
CI Pipeline / frontend-build (push) Successful in 29s
CI Pipeline / backend-lint (push) Successful in 8s
CI Pipeline / quality-gate (pull_request) Successful in 2s

The CSR shell served to regular browsers caused a visible blank-to-content
flash: the browser painted an empty <app-root>, then waited for Angular
to bootstrap and lazy-load the route before any content appeared.

All requests now route through the Angular SSR engine (appEngine.handle()),
which fetches fresh station config from the API via APP_INITIALIZER before
rendering. The first paint carries real content, colors, and assets.
This commit is contained in:
robot committed 2026-08-09 08:13:35 +00:00
1 parent bb45e8d6ae
commit 83b79fe0da
2 files changed
+27 -30

No files matched your search

+16 -18
View File
@@ -33,28 +33,26 @@ vi.mock('./angular-app-engine-manifest.mjs', () => ({
})); }));
describe('SSR server — server.ts', () => { describe('SSR server — server.ts', () => {
it('should export a request handler', async () => { it('should route all requests through Angular SSR engine (no spider gate)', async () => {
const fs = require('fs');
const content = fs.readFileSync('./server.ts', 'utf-8');
expect(content).toContain('requestHandler(req, res,');
// Should NOT have spider-only SSR gate
expect(content).not.toContain('if (!isSpider(userAgent))');
expect(content).not.toContain('isSpider');
});
it('should still have serveCsrShell as a fallback for when SSR engine fails', async () => {
const fs = require('fs');
const content = fs.readFileSync('./server.ts', 'utf-8');
expect(content).toContain('serveCsrShell');
});
it('should have request handler export', async () => {
const mod = await import('./server'); const mod = await import('./server');
expect(mod.requestHandler).toBeDefined(); expect(mod.requestHandler).toBeDefined();
}); });
it('should have spider detection imports and serveCsrShell', async () => {
const fs = require('fs');
const content = fs.readFileSync('./server.ts', 'utf-8');
expect(content).toContain('isSpider');
expect(content).toContain('getUserAgent');
expect(content).toContain('serveCsrShell');
expect(content).toContain('spider_detection');
});
it('should gate SSR behind spider detection', async () => {
const fs = require('fs');
const content = fs.readFileSync('./server.ts', 'utf-8');
// Verify the spider detection gate exists
expect(content).toContain("if (!isSpider(userAgent))");
expect(content).toContain('serveCsrShell(res)');
});
it('should inject fresh station config as window.__STATION_CONFIG', async () => { it('should inject fresh station config as window.__STATION_CONFIG', async () => {
const fs = require('fs'); const fs = require('fs');
const content = fs.readFileSync('./server.ts', 'utf-8'); const content = fs.readFileSync('./server.ts', 'utf-8');
+11 -12
View File
@@ -8,7 +8,6 @@ import * as fs from 'node:fs';
import * as http from 'node:http'; import * as http from 'node:http';
import * as https from 'node:https'; import * as https from 'node:https';
import * as path from 'node:path'; import * as path from 'node:path';
import { isSpider, getUserAgent } from './spider_detection';
/** /**
* Manually import and register the Angular app engine manifest. * Manually import and register the Angular app engine manifest.
@@ -263,17 +262,17 @@ if (isMainModule(import.meta.url)) {
const server = http.createServer(); const server = http.createServer();
server.on('request', async (req, res) => { server.on('request', async (req, res) => {
try { try {
// ── Spider detection gate ────────────────────────── // ── SSR rendering for all users ────────────────────
// Only search engine spiders get full SSR rendering. // Every user — spiders and regular browsers — gets full
// Regular users receive the CSR app shell from disk, // Angular SSR rendering. The SSR engine (main.server.ts)
// enhanced with fresh station config injected at runtime. // fetches fresh station config from the API via APP_INITIALIZER
const userAgent = getUserAgent(req.headers); // before rendering, so the first paint carries real content,
if (!isSpider(userAgent)) { // colors, and assets. No CSR shell flash, no blank gap.
await serveCsrShell(res); //
return; // NOTE: The spider-only SSR gate was removed because serving
} // a CSR shell (empty <app-root>) to regular browsers caused
// a visible blank-to-content transition. The SSR engine is
// Spider — render full HTML via Angular SSR with live API data // fast enough to handle regular traffic.
await requestHandler(req, res, () => { await requestHandler(req, res, () => {
res.statusCode = 404; res.statusCode = 404;
res.end('Not Found'); res.end('Not Found');