@prauga/flexdoc-backend 2.9.9 → 3.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -179
- package/dist/flexdoc.module.js.map +1 -1
- package/dist/flexdoc.service.js.map +1 -1
- package/dist/framework-adapters.d.ts +2 -0
- package/dist/framework-adapters.js +21 -0
- package/dist/framework-adapters.js.map +1 -1
- package/dist/framework-adapters.test.js +32 -0
- package/dist/framework-adapters.test.js.map +1 -1
- package/dist/hono-adapter.d.ts +4 -0
- package/dist/hono-adapter.js +22 -0
- package/dist/hono-adapter.js.map +1 -1
- package/dist/hono-adapter.test.js +30 -6
- package/dist/hono-adapter.test.js.map +1 -1
- package/dist/host-execution-route.js.map +1 -1
- package/dist/host-execution.js +1 -1
- package/dist/host-execution.js.map +1 -1
- package/dist/index.d.ts +3 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/interfaces.d.ts +9 -0
- package/dist/renderer/flexdoc.standalone.css +1 -1
- package/dist/renderer/flexdoc.standalone.js +81 -72
- package/dist/runtime-intelligence-setup.test.d.ts +1 -0
- package/dist/runtime-intelligence-setup.test.js +51 -0
- package/dist/runtime-intelligence-setup.test.js.map +1 -0
- package/dist/runtime-intelligence.d.ts +58 -0
- package/dist/runtime-intelligence.js +226 -0
- package/dist/runtime-intelligence.js.map +1 -0
- package/dist/runtime-intelligence.test.d.ts +1 -0
- package/dist/runtime-intelligence.test.js +117 -0
- package/dist/runtime-intelligence.test.js.map +1 -0
- package/dist/setup.js +26 -0
- package/dist/setup.js.map +1 -1
- package/dist/template.d.ts +1 -0
- package/dist/template.js +3 -1
- package/dist/template.js.map +1 -1
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const setup_1 = require("./setup");
|
|
4
|
+
jest.mock('./template', () => ({ generateFlexDocHTML: jest.fn(() => '<html></html>') }));
|
|
5
|
+
jest.mock('./renderer-assets', () => ({ getRendererAssets: jest.fn(() => ({ javascript: 'js', css: 'css', version: 'test' })) }));
|
|
6
|
+
describe('setupFlexDoc runtime intelligence', () => {
|
|
7
|
+
it('exposes a docs-auth-scoped runtime snapshot only when explicitly enabled', async () => {
|
|
8
|
+
const handlers = [];
|
|
9
|
+
const app = {
|
|
10
|
+
router: { stack: [{ route: { path: '/pets/:petId', methods: { get: true } } }] },
|
|
11
|
+
use(path, handler) { handlers.push({ path, handler }); },
|
|
12
|
+
};
|
|
13
|
+
(0, setup_1.setupFlexDoc)(app, '/docs', {
|
|
14
|
+
spec: { openapi: '3.1.0', info: { title: 'Pets', version: '1' }, paths: { '/pets/{petId}': { get: {} } } },
|
|
15
|
+
options: { runtimeIntelligence: true },
|
|
16
|
+
});
|
|
17
|
+
const runtime = handlers.find((entry) => entry.path === '/docs/__flexdoc/runtime');
|
|
18
|
+
expect(runtime).toBeDefined();
|
|
19
|
+
const headers = {};
|
|
20
|
+
let body = '';
|
|
21
|
+
const response = {
|
|
22
|
+
statusCode: 200,
|
|
23
|
+
setHeader(name, value) { headers[name] = value; },
|
|
24
|
+
send(value) { body = value; },
|
|
25
|
+
end(value = '') { body = value; },
|
|
26
|
+
};
|
|
27
|
+
await runtime.handler({ method: 'GET', headers: { host: 'api.example.com' }, protocol: 'https', socket: { localPort: 8443 } }, response);
|
|
28
|
+
expect(headers['Cache-Control']).toBe('no-store');
|
|
29
|
+
const snapshot = JSON.parse(body);
|
|
30
|
+
expect(snapshot.framework).toBe('express');
|
|
31
|
+
expect(snapshot.serverOrigin).toBe('https://api.example.com');
|
|
32
|
+
expect(snapshot.server).toEqual({ localPort: 8443 });
|
|
33
|
+
expect(snapshot.summary.matched).toBe(1);
|
|
34
|
+
});
|
|
35
|
+
it('does not register runtime discovery by default', () => {
|
|
36
|
+
const paths = [];
|
|
37
|
+
const app = { router: { stack: [] }, use(path) { paths.push(path); } };
|
|
38
|
+
(0, setup_1.setupFlexDoc)(app, '/docs', { spec: { openapi: '3.1.0', paths: {} } });
|
|
39
|
+
expect(paths).not.toContain('/docs/__flexdoc/runtime');
|
|
40
|
+
});
|
|
41
|
+
it('does not treat an empty runtime options object as opt-in', () => {
|
|
42
|
+
const paths = [];
|
|
43
|
+
const app = { router: { stack: [] }, use(path) { paths.push(path); } };
|
|
44
|
+
(0, setup_1.setupFlexDoc)(app, '/docs', {
|
|
45
|
+
spec: { openapi: '3.1.0', paths: {} },
|
|
46
|
+
options: { runtimeIntelligence: {} },
|
|
47
|
+
});
|
|
48
|
+
expect(paths).not.toContain('/docs/__flexdoc/runtime');
|
|
49
|
+
});
|
|
50
|
+
});
|
|
51
|
+
//# sourceMappingURL=runtime-intelligence-setup.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-intelligence-setup.test.js","sourceRoot":"","sources":["../src/runtime-intelligence-setup.test.ts"],"names":[],"mappings":";;AAAA,mCAAuC;AAEvC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;AACzF,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAElI,QAAQ,CAAC,mCAAmC,EAAE,GAAG,EAAE;IACjD,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,QAAQ,GAA0C,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAQ;YACf,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE;YAChF,GAAG,CAAC,IAAY,EAAE,OAAY,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;SACtE,CAAC;QACF,IAAA,oBAAY,EAAC,GAAG,EAAE,OAAO,EAAE;YACzB,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE;YAC1G,OAAO,EAAE,EAAE,mBAAmB,EAAE,IAAI,EAAE;SACvC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,yBAAyB,CAAC,CAAC;QACnF,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,MAAM,QAAQ,GAAQ;YACpB,UAAU,EAAE,GAAG;YACf,SAAS,CAAC,IAAY,EAAE,KAAa,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YACjE,IAAI,CAAC,KAAa,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,KAAK,GAAG,EAAE,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;SAClC,CAAC;QACF,MAAM,OAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1I,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,IAAY,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,IAAA,oBAAY,EAAC,GAAG,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,IAAY,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,IAAA,oBAAY,EAAC,GAAG,EAAE,OAAO,EAAE;YACzB,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE;YACrC,OAAO,EAAE,EAAE,mBAAmB,EAAE,EAAS,EAAE;SAC5C,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,yBAAyB,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import type { FlexDocRuntimeIntelligenceOptions } from './interfaces';
|
|
2
|
+
export interface FlexDocRuntimeRoute {
|
|
3
|
+
method: string;
|
|
4
|
+
path: string;
|
|
5
|
+
}
|
|
6
|
+
export interface FlexDocRuntimeMetadata {
|
|
7
|
+
name: 'node';
|
|
8
|
+
version: string;
|
|
9
|
+
platform: string;
|
|
10
|
+
arch: string;
|
|
11
|
+
}
|
|
12
|
+
export interface FlexDocRuntimeServerMetadata {
|
|
13
|
+
localPort?: number;
|
|
14
|
+
}
|
|
15
|
+
export interface FlexDocRuntimeEnvironmentMetadata {
|
|
16
|
+
name: string;
|
|
17
|
+
}
|
|
18
|
+
export interface FlexDocRuntimeDiscovery {
|
|
19
|
+
framework: string;
|
|
20
|
+
frameworkVersion?: string;
|
|
21
|
+
routes: FlexDocRuntimeRoute[];
|
|
22
|
+
complete: boolean;
|
|
23
|
+
}
|
|
24
|
+
export interface FlexDocRuntimeIntelligenceSnapshot {
|
|
25
|
+
framework: string;
|
|
26
|
+
frameworkVersion?: string;
|
|
27
|
+
runtime: FlexDocRuntimeMetadata;
|
|
28
|
+
serverOrigin?: string;
|
|
29
|
+
server?: FlexDocRuntimeServerMetadata;
|
|
30
|
+
environment?: FlexDocRuntimeEnvironmentMetadata;
|
|
31
|
+
discoveryComplete: boolean;
|
|
32
|
+
routes: FlexDocRuntimeRoute[];
|
|
33
|
+
runtimeOnly: FlexDocRuntimeRoute[];
|
|
34
|
+
documentedOnly: FlexDocRuntimeRoute[];
|
|
35
|
+
summary: {
|
|
36
|
+
documented: number;
|
|
37
|
+
runtime: number;
|
|
38
|
+
matched: number;
|
|
39
|
+
runtimeOnly: number;
|
|
40
|
+
documentedOnly: number;
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
export declare function runtimeIntelligenceEnabled(value: boolean | FlexDocRuntimeIntelligenceOptions | undefined): boolean;
|
|
44
|
+
export declare function normalizeRuntimePath(value: string): string;
|
|
45
|
+
export declare function nodeRuntimeMetadata(): FlexDocRuntimeMetadata;
|
|
46
|
+
export declare function nodeEnvironmentMetadata(): FlexDocRuntimeEnvironmentMetadata | undefined;
|
|
47
|
+
export declare function discoverExpressRoutes(app: any, excludePrefix?: string): FlexDocRuntimeDiscovery;
|
|
48
|
+
export declare function discoverFastifyRoutes(app: any, excludePrefix?: string): Promise<FlexDocRuntimeDiscovery>;
|
|
49
|
+
export declare function discoverHonoRoutes(app: any, excludePrefix?: string): FlexDocRuntimeDiscovery;
|
|
50
|
+
export declare function documentedOpenApiRoutes(spec: any): FlexDocRuntimeRoute[];
|
|
51
|
+
export declare function buildRuntimeIntelligenceSnapshot(input: {
|
|
52
|
+
spec: any;
|
|
53
|
+
discovery: FlexDocRuntimeDiscovery;
|
|
54
|
+
serverOrigin?: string;
|
|
55
|
+
server?: FlexDocRuntimeServerMetadata;
|
|
56
|
+
environment?: FlexDocRuntimeEnvironmentMetadata;
|
|
57
|
+
runtime?: FlexDocRuntimeMetadata;
|
|
58
|
+
}): FlexDocRuntimeIntelligenceSnapshot;
|
|
@@ -0,0 +1,226 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.runtimeIntelligenceEnabled = runtimeIntelligenceEnabled;
|
|
4
|
+
exports.normalizeRuntimePath = normalizeRuntimePath;
|
|
5
|
+
exports.nodeRuntimeMetadata = nodeRuntimeMetadata;
|
|
6
|
+
exports.nodeEnvironmentMetadata = nodeEnvironmentMetadata;
|
|
7
|
+
exports.discoverExpressRoutes = discoverExpressRoutes;
|
|
8
|
+
exports.discoverFastifyRoutes = discoverFastifyRoutes;
|
|
9
|
+
exports.discoverHonoRoutes = discoverHonoRoutes;
|
|
10
|
+
exports.documentedOpenApiRoutes = documentedOpenApiRoutes;
|
|
11
|
+
exports.buildRuntimeIntelligenceSnapshot = buildRuntimeIntelligenceSnapshot;
|
|
12
|
+
const HTTP_METHODS = new Set(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'TRACE']);
|
|
13
|
+
function runtimeIntelligenceEnabled(value) {
|
|
14
|
+
return value === true || (typeof value === 'object' && value?.enabled === true);
|
|
15
|
+
}
|
|
16
|
+
function normalizeRuntimePath(value) {
|
|
17
|
+
let path = value.trim();
|
|
18
|
+
if (!path.startsWith('/'))
|
|
19
|
+
path = `/${path}`;
|
|
20
|
+
path = path.replace(/:([A-Za-z0-9_]+)(?:\([^)]*\))?[?+*]?/g, '{$1}');
|
|
21
|
+
path = path.replace(/\/{2,}/g, '/');
|
|
22
|
+
if (path.length > 1 && path.endsWith('/'))
|
|
23
|
+
path = path.slice(0, -1);
|
|
24
|
+
return path || '/';
|
|
25
|
+
}
|
|
26
|
+
function normalizedRoute(method, path) {
|
|
27
|
+
const normalizedMethod = method.toUpperCase();
|
|
28
|
+
if (!HTTP_METHODS.has(normalizedMethod) || typeof path !== 'string')
|
|
29
|
+
return null;
|
|
30
|
+
return { method: normalizedMethod, path: normalizeRuntimePath(path) };
|
|
31
|
+
}
|
|
32
|
+
function routeKey(route) {
|
|
33
|
+
return `${route.method} ${route.path}`;
|
|
34
|
+
}
|
|
35
|
+
function uniqueSorted(routes) {
|
|
36
|
+
const byKey = new Map();
|
|
37
|
+
for (const route of routes)
|
|
38
|
+
byKey.set(routeKey(route), route);
|
|
39
|
+
return [...byKey.values()].sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method));
|
|
40
|
+
}
|
|
41
|
+
function isExcludedRoute(path, excludePrefix) {
|
|
42
|
+
if (!excludePrefix)
|
|
43
|
+
return false;
|
|
44
|
+
const excluded = normalizeRuntimePath(excludePrefix);
|
|
45
|
+
return path === excluded || path.startsWith(`${excluded}/`);
|
|
46
|
+
}
|
|
47
|
+
function withoutImplicitHeadRoutes(routes) {
|
|
48
|
+
const keys = new Set(routes.map(routeKey));
|
|
49
|
+
return routes.filter((route) => route.method !== 'HEAD' || !keys.has(`GET ${route.path}`));
|
|
50
|
+
}
|
|
51
|
+
function nodeRuntimeMetadata() {
|
|
52
|
+
return {
|
|
53
|
+
name: 'node',
|
|
54
|
+
version: process.version,
|
|
55
|
+
platform: process.platform,
|
|
56
|
+
arch: process.arch,
|
|
57
|
+
};
|
|
58
|
+
}
|
|
59
|
+
function nodeEnvironmentMetadata() {
|
|
60
|
+
const name = process.env.NODE_ENV?.trim();
|
|
61
|
+
return name ? { name } : undefined;
|
|
62
|
+
}
|
|
63
|
+
function discoverExpressRoutes(app, excludePrefix) {
|
|
64
|
+
const router = app?.router || app?._router;
|
|
65
|
+
const stack = Array.isArray(router?.stack) ? router.stack : null;
|
|
66
|
+
if (!stack)
|
|
67
|
+
return { framework: 'express', routes: [], complete: false };
|
|
68
|
+
const routes = [];
|
|
69
|
+
let complete = true;
|
|
70
|
+
const visit = (layers, prefix = '') => {
|
|
71
|
+
for (const layer of layers) {
|
|
72
|
+
const route = layer?.route;
|
|
73
|
+
if (route) {
|
|
74
|
+
const rawPaths = Array.isArray(route.path) ? route.path : [route.path];
|
|
75
|
+
for (const rawPath of rawPaths) {
|
|
76
|
+
if (typeof rawPath !== 'string') {
|
|
77
|
+
complete = false;
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
const fullPath = normalizeRuntimePath(`${prefix}${rawPath}`);
|
|
81
|
+
if (isExcludedRoute(fullPath, excludePrefix))
|
|
82
|
+
continue;
|
|
83
|
+
for (const [method, enabled] of Object.entries(route.methods || {})) {
|
|
84
|
+
if (!enabled)
|
|
85
|
+
continue;
|
|
86
|
+
const candidate = normalizedRoute(method, fullPath);
|
|
87
|
+
if (candidate)
|
|
88
|
+
routes.push(candidate);
|
|
89
|
+
}
|
|
90
|
+
}
|
|
91
|
+
continue;
|
|
92
|
+
}
|
|
93
|
+
if (Array.isArray(layer?.handle?.stack)) {
|
|
94
|
+
if (typeof layer.path === 'string')
|
|
95
|
+
visit(layer.handle.stack, `${prefix}${normalizeRuntimePath(layer.path)}`);
|
|
96
|
+
else
|
|
97
|
+
complete = false;
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
};
|
|
101
|
+
visit(stack);
|
|
102
|
+
return { framework: 'express', routes: uniqueSorted(routes), complete };
|
|
103
|
+
}
|
|
104
|
+
async function discoverFastifyRoutes(app, excludePrefix) {
|
|
105
|
+
const frameworkVersion = typeof app?.version === 'string' ? app.version : undefined;
|
|
106
|
+
if (typeof app?.printRoutes !== 'function') {
|
|
107
|
+
return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
|
|
108
|
+
}
|
|
109
|
+
try {
|
|
110
|
+
if (typeof app?.ready === 'function')
|
|
111
|
+
await app.ready();
|
|
112
|
+
const printed = app.printRoutes({ commonPrefix: false });
|
|
113
|
+
if (typeof printed !== 'string') {
|
|
114
|
+
return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
|
|
115
|
+
}
|
|
116
|
+
const fragments = [];
|
|
117
|
+
const routes = [];
|
|
118
|
+
let complete = true;
|
|
119
|
+
for (const line of printed.split(/\r?\n/)) {
|
|
120
|
+
if (!line.trim() || line.includes('•'))
|
|
121
|
+
continue;
|
|
122
|
+
const branch = Math.max(line.lastIndexOf('├── '), line.lastIndexOf('└── '));
|
|
123
|
+
if (branch < 0 || branch % 4 !== 0) {
|
|
124
|
+
complete = false;
|
|
125
|
+
continue;
|
|
126
|
+
}
|
|
127
|
+
const depth = branch / 4;
|
|
128
|
+
const label = line.slice(branch + 4).trim();
|
|
129
|
+
const match = label.match(/^(.*?)\s+\(([^)]+)\)(?:\s+.*)?$/);
|
|
130
|
+
const fragment = (match?.[1] || label).trim();
|
|
131
|
+
fragments[depth] = fragment;
|
|
132
|
+
fragments.length = depth + 1;
|
|
133
|
+
if (!match)
|
|
134
|
+
continue;
|
|
135
|
+
const fullPath = normalizeRuntimePath(fragments.join(''));
|
|
136
|
+
if (isExcludedRoute(fullPath, excludePrefix))
|
|
137
|
+
continue;
|
|
138
|
+
for (const method of match[2].split(',').map((value) => value.trim()).filter(Boolean)) {
|
|
139
|
+
const candidate = normalizedRoute(method, fullPath);
|
|
140
|
+
if (candidate)
|
|
141
|
+
routes.push(candidate);
|
|
142
|
+
else
|
|
143
|
+
complete = false;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
return {
|
|
147
|
+
framework: 'fastify',
|
|
148
|
+
...(frameworkVersion ? { frameworkVersion } : {}),
|
|
149
|
+
routes: uniqueSorted(withoutImplicitHeadRoutes(routes)),
|
|
150
|
+
complete,
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
catch {
|
|
154
|
+
return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
function discoverHonoRoutes(app, excludePrefix) {
|
|
158
|
+
const source = Array.isArray(app?.routes) ? app.routes : null;
|
|
159
|
+
if (!source)
|
|
160
|
+
return { framework: 'hono', routes: [], complete: false };
|
|
161
|
+
const routes = [];
|
|
162
|
+
let complete = true;
|
|
163
|
+
for (const route of source) {
|
|
164
|
+
if (!route || typeof route.path !== 'string' || typeof route.method !== 'string') {
|
|
165
|
+
complete = false;
|
|
166
|
+
continue;
|
|
167
|
+
}
|
|
168
|
+
const method = route.method.toUpperCase();
|
|
169
|
+
if (method === 'ALL' || method === '*') {
|
|
170
|
+
complete = false;
|
|
171
|
+
continue;
|
|
172
|
+
}
|
|
173
|
+
const fullPath = normalizeRuntimePath(route.path);
|
|
174
|
+
if (isExcludedRoute(fullPath, excludePrefix))
|
|
175
|
+
continue;
|
|
176
|
+
const candidate = normalizedRoute(method, fullPath);
|
|
177
|
+
if (candidate)
|
|
178
|
+
routes.push(candidate);
|
|
179
|
+
else
|
|
180
|
+
complete = false;
|
|
181
|
+
}
|
|
182
|
+
return { framework: 'hono', routes: uniqueSorted(routes), complete };
|
|
183
|
+
}
|
|
184
|
+
function documentedOpenApiRoutes(spec) {
|
|
185
|
+
const routes = [];
|
|
186
|
+
for (const [path, pathItem] of Object.entries(spec?.paths || {})) {
|
|
187
|
+
if (!pathItem || typeof pathItem !== 'object')
|
|
188
|
+
continue;
|
|
189
|
+
for (const method of Object.keys(pathItem)) {
|
|
190
|
+
const candidate = normalizedRoute(method, path);
|
|
191
|
+
if (candidate)
|
|
192
|
+
routes.push(candidate);
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
return uniqueSorted(routes);
|
|
196
|
+
}
|
|
197
|
+
function buildRuntimeIntelligenceSnapshot(input) {
|
|
198
|
+
const documented = documentedOpenApiRoutes(input.spec);
|
|
199
|
+
const runtimeRoutes = uniqueSorted(input.discovery.routes);
|
|
200
|
+
const documentedKeys = new Set(documented.map(routeKey));
|
|
201
|
+
const runtimeKeys = new Set(runtimeRoutes.map(routeKey));
|
|
202
|
+
const matched = runtimeRoutes.filter((route) => documentedKeys.has(routeKey(route))).length;
|
|
203
|
+
const runtimeOnly = runtimeRoutes.filter((route) => !documentedKeys.has(routeKey(route)));
|
|
204
|
+
const documentedOnly = documented.filter((route) => !runtimeKeys.has(routeKey(route)));
|
|
205
|
+
const environment = input.environment || nodeEnvironmentMetadata();
|
|
206
|
+
return {
|
|
207
|
+
framework: input.discovery.framework,
|
|
208
|
+
...(input.discovery.frameworkVersion ? { frameworkVersion: input.discovery.frameworkVersion } : {}),
|
|
209
|
+
runtime: input.runtime || nodeRuntimeMetadata(),
|
|
210
|
+
...(input.serverOrigin ? { serverOrigin: input.serverOrigin } : {}),
|
|
211
|
+
...(input.server ? { server: input.server } : {}),
|
|
212
|
+
...(environment ? { environment } : {}),
|
|
213
|
+
discoveryComplete: input.discovery.complete,
|
|
214
|
+
routes: runtimeRoutes,
|
|
215
|
+
runtimeOnly,
|
|
216
|
+
documentedOnly,
|
|
217
|
+
summary: {
|
|
218
|
+
documented: documented.length,
|
|
219
|
+
runtime: runtimeRoutes.length,
|
|
220
|
+
matched,
|
|
221
|
+
runtimeOnly: runtimeOnly.length,
|
|
222
|
+
documentedOnly: documentedOnly.length,
|
|
223
|
+
},
|
|
224
|
+
};
|
|
225
|
+
}
|
|
226
|
+
//# sourceMappingURL=runtime-intelligence.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-intelligence.js","sourceRoot":"","sources":["../src/runtime-intelligence.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
const runtime_intelligence_1 = require("./runtime-intelligence");
|
|
4
|
+
describe('runtime intelligence', () => {
|
|
5
|
+
it('requires an explicit true opt-in', () => {
|
|
6
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)(true)).toBe(true);
|
|
7
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)({ enabled: true })).toBe(true);
|
|
8
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)(false)).toBe(false);
|
|
9
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)(undefined)).toBe(false);
|
|
10
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)({})).toBe(false);
|
|
11
|
+
expect((0, runtime_intelligence_1.runtimeIntelligenceEnabled)({ enabled: false })).toBe(false);
|
|
12
|
+
});
|
|
13
|
+
it('normalizes framework parameter paths to OpenAPI form', () => {
|
|
14
|
+
expect((0, runtime_intelligence_1.normalizeRuntimePath)('/pets/:petId')).toBe('/pets/{petId}');
|
|
15
|
+
expect((0, runtime_intelligence_1.normalizeRuntimePath)('/orgs/:orgId(\\d+)/users/:userId?')).toBe('/orgs/{orgId}/users/{userId}');
|
|
16
|
+
});
|
|
17
|
+
it('discovers direct Express routes without treating middleware as endpoints', () => {
|
|
18
|
+
const app = {
|
|
19
|
+
router: {
|
|
20
|
+
stack: [
|
|
21
|
+
{ route: { path: '/pets', methods: { get: true, post: true } } },
|
|
22
|
+
{ route: { path: '/pets/:petId', methods: { get: true } } },
|
|
23
|
+
{ handle: () => undefined },
|
|
24
|
+
],
|
|
25
|
+
},
|
|
26
|
+
};
|
|
27
|
+
expect((0, runtime_intelligence_1.discoverExpressRoutes)(app)).toEqual({
|
|
28
|
+
framework: 'express',
|
|
29
|
+
complete: true,
|
|
30
|
+
routes: [
|
|
31
|
+
{ method: 'GET', path: '/pets' },
|
|
32
|
+
{ method: 'POST', path: '/pets' },
|
|
33
|
+
{ method: 'GET', path: '/pets/{petId}' },
|
|
34
|
+
],
|
|
35
|
+
});
|
|
36
|
+
});
|
|
37
|
+
it('discovers Fastify route trees after ready and suppresses implicit HEAD siblings', async () => {
|
|
38
|
+
const app = {
|
|
39
|
+
version: '5.12.1',
|
|
40
|
+
ready: jest.fn(async () => undefined),
|
|
41
|
+
printRoutes: jest.fn(() => [
|
|
42
|
+
'└── /',
|
|
43
|
+
' ├── pets (GET, HEAD)',
|
|
44
|
+
' │ └── /:petId (GET, HEAD)',
|
|
45
|
+
' ├── internal/reindex (POST)',
|
|
46
|
+
' └── docs (GET, HEAD)',
|
|
47
|
+
].join('\n')),
|
|
48
|
+
};
|
|
49
|
+
expect(await (0, runtime_intelligence_1.discoverFastifyRoutes)(app, '/docs')).toEqual({
|
|
50
|
+
framework: 'fastify',
|
|
51
|
+
frameworkVersion: '5.12.1',
|
|
52
|
+
complete: true,
|
|
53
|
+
routes: [
|
|
54
|
+
{ method: 'POST', path: '/internal/reindex' },
|
|
55
|
+
{ method: 'GET', path: '/pets' },
|
|
56
|
+
{ method: 'GET', path: '/pets/{petId}' },
|
|
57
|
+
],
|
|
58
|
+
});
|
|
59
|
+
expect(app.ready).toHaveBeenCalledTimes(1);
|
|
60
|
+
expect(app.printRoutes).toHaveBeenCalledWith({ commonPrefix: false });
|
|
61
|
+
});
|
|
62
|
+
it('discovers Hono registered routes and excludes FlexDoc topology', () => {
|
|
63
|
+
const app = {
|
|
64
|
+
routes: [
|
|
65
|
+
{ method: 'GET', path: '/pets' },
|
|
66
|
+
{ method: 'POST', path: '/pets/:petId/actions' },
|
|
67
|
+
{ method: 'GET', path: '/docs' },
|
|
68
|
+
{ method: 'ALL', path: '/middleware/*' },
|
|
69
|
+
],
|
|
70
|
+
};
|
|
71
|
+
expect((0, runtime_intelligence_1.discoverHonoRoutes)(app, '/docs')).toEqual({
|
|
72
|
+
framework: 'hono',
|
|
73
|
+
complete: false,
|
|
74
|
+
routes: [
|
|
75
|
+
{ method: 'GET', path: '/pets' },
|
|
76
|
+
{ method: 'POST', path: '/pets/{petId}/actions' },
|
|
77
|
+
],
|
|
78
|
+
});
|
|
79
|
+
});
|
|
80
|
+
it('reports presence drift plus safe runtime server and environment metadata without enforcement', () => {
|
|
81
|
+
const snapshot = (0, runtime_intelligence_1.buildRuntimeIntelligenceSnapshot)({
|
|
82
|
+
spec: {
|
|
83
|
+
openapi: '3.1.0',
|
|
84
|
+
paths: {
|
|
85
|
+
'/pets': { get: {} },
|
|
86
|
+
'/pets/{petId}': { get: {} },
|
|
87
|
+
},
|
|
88
|
+
},
|
|
89
|
+
discovery: {
|
|
90
|
+
framework: 'fastify',
|
|
91
|
+
frameworkVersion: '5.12.1',
|
|
92
|
+
complete: true,
|
|
93
|
+
routes: [
|
|
94
|
+
{ method: 'GET', path: '/pets' },
|
|
95
|
+
{ method: 'POST', path: '/internal/reindex' },
|
|
96
|
+
],
|
|
97
|
+
},
|
|
98
|
+
serverOrigin: 'https://api.example.com',
|
|
99
|
+
server: { localPort: 8443 },
|
|
100
|
+
environment: { name: 'production' },
|
|
101
|
+
runtime: { name: 'node', version: 'v22.22.3', platform: 'linux', arch: 'x64' },
|
|
102
|
+
});
|
|
103
|
+
expect(snapshot.summary).toEqual({ documented: 2, runtime: 2, matched: 1, runtimeOnly: 1, documentedOnly: 1 });
|
|
104
|
+
expect(snapshot.runtimeOnly).toEqual([{ method: 'POST', path: '/internal/reindex' }]);
|
|
105
|
+
expect(snapshot.documentedOnly).toEqual([{ method: 'GET', path: '/pets/{petId}' }]);
|
|
106
|
+
expect(snapshot.serverOrigin).toBe('https://api.example.com');
|
|
107
|
+
expect(snapshot.server).toEqual({ localPort: 8443 });
|
|
108
|
+
expect(snapshot.environment).toEqual({ name: 'production' });
|
|
109
|
+
expect(snapshot.frameworkVersion).toBe('5.12.1');
|
|
110
|
+
expect(snapshot.runtime).toEqual({ name: 'node', version: 'v22.22.3', platform: 'linux', arch: 'x64' });
|
|
111
|
+
});
|
|
112
|
+
it('marks discovery partial when a mounted Express router prefix cannot be recovered safely', () => {
|
|
113
|
+
const app = { router: { stack: [{ handle: { stack: [{ route: { path: '/child', methods: { get: true } } }] } }] } };
|
|
114
|
+
expect((0, runtime_intelligence_1.discoverExpressRoutes)(app).complete).toBe(false);
|
|
115
|
+
});
|
|
116
|
+
});
|
|
117
|
+
//# sourceMappingURL=runtime-intelligence.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"runtime-intelligence.test.js","sourceRoot":"","sources":["../src/runtime-intelligence.test.ts"],"names":[],"mappings":"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"}
|
package/dist/setup.js
CHANGED
|
@@ -42,6 +42,7 @@ const https = __importStar(require("https"));
|
|
|
42
42
|
const host_execution_1 = require("./host-execution");
|
|
43
43
|
const host_execution_route_1 = require("./host-execution-route");
|
|
44
44
|
const page_cache_1 = require("./page-cache");
|
|
45
|
+
const runtime_intelligence_1 = require("./runtime-intelligence");
|
|
45
46
|
function createAuthMiddleware(authOptions) {
|
|
46
47
|
return (req, res, next) => {
|
|
47
48
|
const decision = (0, auth_1.authorizeFlexDocRequest)(req.headers.authorization, authOptions);
|
|
@@ -108,6 +109,8 @@ function setupFlexDoc(app, path, options) {
|
|
|
108
109
|
const normalizedPath = path.startsWith('/') ? path : `/${path}`;
|
|
109
110
|
const rendererBasePath = `${normalizedPath}/__flexdoc`;
|
|
110
111
|
const hostExecutionState = (0, host_execution_1.createHostExecutionState)(flexDocOptions?.tryIt?.hostExecution);
|
|
112
|
+
const runtimeEnabled = (0, runtime_intelligence_1.runtimeIntelligenceEnabled)(flexDocOptions?.runtimeIntelligence);
|
|
113
|
+
const runtimeEndpoint = `${rendererBasePath}/runtime`;
|
|
111
114
|
if (flexDocOptions?.auth) {
|
|
112
115
|
app.use(normalizedPath, createAuthMiddleware(flexDocOptions.auth));
|
|
113
116
|
}
|
|
@@ -157,8 +160,31 @@ function setupFlexDoc(app, path, options) {
|
|
|
157
160
|
rendererBasePath,
|
|
158
161
|
rendererVersion: rendererAssets.version,
|
|
159
162
|
hostExecutionPublic: (0, host_execution_1.publicHostExecutionOptions)(hostExecutionState, rendererBasePath),
|
|
163
|
+
runtimeIntelligencePublic: runtimeEnabled ? { available: true, endpoint: runtimeEndpoint, framework: 'express' } : undefined,
|
|
160
164
|
});
|
|
161
165
|
});
|
|
166
|
+
if (runtimeEnabled) {
|
|
167
|
+
app.use(runtimeEndpoint, async (req, res) => {
|
|
168
|
+
if (String(req.method || 'GET').toUpperCase() !== 'GET') {
|
|
169
|
+
res.statusCode = 405;
|
|
170
|
+
res.setHeader('Content-Type', 'application/json; charset=utf-8');
|
|
171
|
+
res.setHeader('Cache-Control', 'no-store');
|
|
172
|
+
return typeof res.send === 'function' ? res.send(JSON.stringify({ error: 'Method not allowed.' })) : res.end(JSON.stringify({ error: 'Method not allowed.' }));
|
|
173
|
+
}
|
|
174
|
+
const serverOrigin = (0, host_execution_route_1.hostExecutionRequestOrigin)({ headers: req.headers || {}, protocol: req.protocol || (req.socket?.encrypted ? 'https' : 'http') });
|
|
175
|
+
const localPort = Number.isInteger(req.socket?.localPort) && req.socket.localPort > 0 ? req.socket.localPort : undefined;
|
|
176
|
+
const snapshot = (0, runtime_intelligence_1.buildRuntimeIntelligenceSnapshot)({
|
|
177
|
+
spec: await getSpec(),
|
|
178
|
+
discovery: (0, runtime_intelligence_1.discoverExpressRoutes)(app, normalizedPath),
|
|
179
|
+
serverOrigin,
|
|
180
|
+
...(localPort ? { server: { localPort } } : {}),
|
|
181
|
+
});
|
|
182
|
+
res.setHeader('Content-Type', 'application/json; charset=utf-8');
|
|
183
|
+
res.setHeader('Cache-Control', 'no-store');
|
|
184
|
+
const body = JSON.stringify(snapshot);
|
|
185
|
+
return typeof res.send === 'function' ? res.send(body) : res.end(body);
|
|
186
|
+
});
|
|
187
|
+
}
|
|
162
188
|
const sendHostResult = (res, result) => {
|
|
163
189
|
res.statusCode = result.status;
|
|
164
190
|
for (const [name, value] of Object.entries(result.headers))
|
package/dist/setup.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"setup.js","sourceRoot":"","sources":["../src/setup.ts"],"names":[],"mappings":"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"}
|
package/dist/template.d.ts
CHANGED
|
@@ -12,6 +12,7 @@ interface RenderOptions extends FlexDocOptions {
|
|
|
12
12
|
rendererBasePath?: string;
|
|
13
13
|
rendererVersion?: string;
|
|
14
14
|
hostExecutionPublic?: import('./interfaces').FlexDocHostExecutionPublicOptions;
|
|
15
|
+
runtimeIntelligencePublic?: import('./interfaces').FlexDocRuntimeIntelligencePublicOptions;
|
|
15
16
|
}
|
|
16
17
|
export declare function generateFlexDocHTML(spec: OpenAPISpec | null, options?: RenderOptions): string;
|
|
17
18
|
export {};
|
package/dist/template.js
CHANGED
|
@@ -8,7 +8,7 @@ function serializeForScript(value) {
|
|
|
8
8
|
return JSON.stringify(value).replace(/</g, '\\u003c').replace(/>/g, '\\u003e').replace(/&/g, '\\u0026').replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029');
|
|
9
9
|
}
|
|
10
10
|
function generateFlexDocHTML(spec, options = {}) {
|
|
11
|
-
const { title, description, version, customCss = '', customJs = '', favicon = '', specUrl, rendererBasePath = './__flexdoc', rendererVersion, auth: _serverOnlyAuth, tryIt: serverTryIt, hostExecutionPublic, ...rendererOptions } = options;
|
|
11
|
+
const { title, description, version, customCss = '', customJs = '', favicon = '', specUrl, rendererBasePath = './__flexdoc', rendererVersion, auth: _serverOnlyAuth, runtimeIntelligence: _serverRuntimeIntelligence, tryIt: serverTryIt, hostExecutionPublic, runtimeIntelligencePublic, ...rendererOptions } = options;
|
|
12
12
|
const assetVersion = rendererVersion ? `?v=${encodeURIComponent(rendererVersion)}` : '';
|
|
13
13
|
const documentTitle = title || spec?.info?.title || 'API Documentation';
|
|
14
14
|
const publicTryIt = serverTryIt || hostExecutionPublic ? {
|
|
@@ -24,6 +24,7 @@ function generateFlexDocHTML(spec, options = {}) {
|
|
|
24
24
|
contractVersion: '1',
|
|
25
25
|
...rendererOptions,
|
|
26
26
|
...(publicTryIt ? { tryIt: publicTryIt } : {}),
|
|
27
|
+
...(runtimeIntelligencePublic ? { runtimeIntelligence: runtimeIntelligencePublic } : {}),
|
|
27
28
|
...(title ? { title } : {}),
|
|
28
29
|
...(description ? { description } : {}),
|
|
29
30
|
...(version ? { version } : {}),
|
|
@@ -38,6 +39,7 @@ function generateFlexDocHTML(spec, options = {}) {
|
|
|
38
39
|
${favicon ? `<link rel="icon" href="${escapeHtml(favicon)}" />` : ''}
|
|
39
40
|
<link rel="stylesheet" href="${escapeHtml(rendererBasePath)}/renderer.css${assetVersion}" />
|
|
40
41
|
${customCss ? `<style>${customCss}</style>` : ''}
|
|
42
|
+
<style>html,body,#flexdoc-root{height:100%;margin:0}body{overflow:hidden}</style>
|
|
41
43
|
</head>
|
|
42
44
|
<body>
|
|
43
45
|
<div id="flexdoc-root"></div>
|
package/dist/template.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":";;
|
|
1
|
+
{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"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"}
|