@prauga/flexdoc-backend 2.9.9 → 3.1.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.
Files changed (49) hide show
  1. package/README.md +36 -179
  2. package/dist/auth.js.map +1 -1
  3. package/dist/contract-validation.d.ts +43 -0
  4. package/dist/contract-validation.js +120 -0
  5. package/dist/contract-validation.js.map +1 -0
  6. package/dist/contract-validation.test.d.ts +1 -0
  7. package/dist/contract-validation.test.js +112 -0
  8. package/dist/contract-validation.test.js.map +1 -0
  9. package/dist/flexdoc.module.js.map +1 -1
  10. package/dist/flexdoc.service.js.map +1 -1
  11. package/dist/framework-adapters.d.ts +2 -0
  12. package/dist/framework-adapters.js +21 -0
  13. package/dist/framework-adapters.js.map +1 -1
  14. package/dist/framework-adapters.test.js +32 -0
  15. package/dist/framework-adapters.test.js.map +1 -1
  16. package/dist/hono-adapter.d.ts +4 -0
  17. package/dist/hono-adapter.js +22 -0
  18. package/dist/hono-adapter.js.map +1 -1
  19. package/dist/hono-adapter.test.js +30 -6
  20. package/dist/hono-adapter.test.js.map +1 -1
  21. package/dist/host-execution-route.d.ts +9 -6
  22. package/dist/host-execution-route.js.map +1 -1
  23. package/dist/host-execution.d.ts +38 -42
  24. package/dist/host-execution.js +1 -1
  25. package/dist/host-execution.js.map +1 -1
  26. package/dist/index.d.ts +5 -1
  27. package/dist/index.js +11 -1
  28. package/dist/index.js.map +1 -1
  29. package/dist/interfaces.d.ts +105 -105
  30. package/dist/page-cache.js.map +1 -1
  31. package/dist/renderer/flexdoc.standalone.css +1 -1
  32. package/dist/renderer/flexdoc.standalone.js +82 -72
  33. package/dist/renderer-assets.js.map +1 -1
  34. package/dist/runtime-intelligence-setup.test.d.ts +1 -0
  35. package/dist/runtime-intelligence-setup.test.js +51 -0
  36. package/dist/runtime-intelligence-setup.test.js.map +1 -0
  37. package/dist/runtime-intelligence.d.ts +66 -0
  38. package/dist/runtime-intelligence.js +270 -0
  39. package/dist/runtime-intelligence.js.map +1 -0
  40. package/dist/runtime-intelligence.test.d.ts +1 -0
  41. package/dist/runtime-intelligence.test.js +143 -0
  42. package/dist/runtime-intelligence.test.js.map +1 -0
  43. package/dist/setup.js +26 -0
  44. package/dist/setup.js.map +1 -1
  45. package/dist/template.d.ts +1 -0
  46. package/dist/template.js +3 -1
  47. package/dist/template.js.map +1 -1
  48. package/dist/tsconfig.tsbuildinfo +1 -1
  49. package/package.json +1 -1
package/dist/renderer-assets.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"renderer-assets.js","sourceRoot":"","sources":["../src/renderer-assets.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,8CAYC;AAvCD,uCAAyB;AACzB,2CAA6B;AAC7B,mCAAoC;AAQpC,SAAS,SAAS,CAAC,YAAoB;IACrC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,8BAA8B,EAAE,YAAY,CAAC;KACtE,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,gEAAgE,CAClH,CAAC;AACJ,CAAC;AAED,IAAI,YAAY,GAA0B,IAAI,CAAC;AAE/C,SAAgB,iBAAiB;IAC/B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC,CAAC;IACzE,YAAY,GAAG;QACb,UAAU;QACV,GAAG;QACH,OAAO,EAAE,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KACrG,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC"}
1
+ {"version":3,"file":"renderer-assets.js","sourceRoot":"","sources":["../src/renderer-assets.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoCA,8CAYC;AAhDD,uCAAyB;AACzB,2CAA6B;AAC7B,mCAAoC;AAYpC,SAAS,SAAS,CAAC,YAAoB;IACrC,MAAM,UAAU,GAAG;QACjB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC;QAC9C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,8BAA8B,EAAE,YAAY,CAAC;KACtE,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IACjD,CAAC;IAED,MAAM,IAAI,KAAK,CACb,qCAAqC,YAAY,gEAAgE,CAClH,CAAC;AACJ,CAAC;AAED,IAAI,YAAY,GAA0B,IAAI,CAAC;AAO/C,SAAgB,iBAAiB;IAC/B,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IAEtC,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC,CAAC;IACzE,YAAY,GAAG;QACb,UAAU;QACV,GAAG;QACH,OAAO,EAAE,IAAA,mBAAU,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;KACrG,CAAC;IAEF,OAAO,YAAY,CAAC;AACtB,CAAC"}
package/dist/runtime-intelligence-setup.test.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/dist/runtime-intelligence-setup.test.js ADDED
@@ -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
package/dist/runtime-intelligence-setup.test.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-intelligence-setup.test.js","sourceRoot":"","sources":["../src/runtime-intelligence-setup.test.ts"],"names":[],"mappings":"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"}
package/dist/runtime-intelligence.d.ts ADDED
@@ -0,0 +1,66 @@
1
+ import type { FlexDocRuntimeIntelligenceOptions } from './interfaces';
2
+ import type { FlexDocContractValidationResult } from './contract-validation';
3
+ export interface FlexDocRuntimeRoute {
4
+ method: string;
5
+ path: string;
6
+ }
7
+ export interface FlexDocRuntimeDuplicateRoute extends FlexDocRuntimeRoute {
8
+ count: number;
9
+ }
10
+ export interface FlexDocRuntimeMetadata {
11
+ name: 'node';
12
+ version: string;
13
+ platform: string;
14
+ arch: string;
15
+ }
16
+ export interface FlexDocRuntimeServerMetadata {
17
+ localPort?: number;
18
+ }
19
+ export interface FlexDocRuntimeEnvironmentMetadata {
20
+ name: string;
21
+ }
22
+ export interface FlexDocRuntimeDiscovery {
23
+ framework: string;
24
+ frameworkVersion?: string;
25
+ routes: FlexDocRuntimeRoute[];
26
+ duplicateRoutes?: FlexDocRuntimeDuplicateRoute[];
27
+ complete: boolean;
28
+ }
29
+ export interface FlexDocRuntimeIntelligenceSummary {
30
+ documented: number;
31
+ runtime: number;
32
+ matched: number;
33
+ runtimeOnly: number;
34
+ documentedOnly: number;
35
+ }
36
+ export interface FlexDocRuntimeIntelligenceSnapshot {
37
+ framework: string;
38
+ frameworkVersion?: string;
39
+ runtime: FlexDocRuntimeMetadata;
40
+ serverOrigin?: string;
41
+ server?: FlexDocRuntimeServerMetadata;
42
+ environment?: FlexDocRuntimeEnvironmentMetadata;
43
+ discoveryComplete: boolean;
44
+ routes: FlexDocRuntimeRoute[];
45
+ runtimeOnly: FlexDocRuntimeRoute[];
46
+ documentedOnly: FlexDocRuntimeRoute[];
47
+ summary: FlexDocRuntimeIntelligenceSummary;
48
+ validation: FlexDocContractValidationResult;
49
+ }
50
+ export declare function runtimeIntelligenceEnabled(value: boolean | FlexDocRuntimeIntelligenceOptions | undefined): boolean;
51
+ export declare function normalizeRuntimePath(value: string): string;
52
+ export declare function nodeRuntimeMetadata(): FlexDocRuntimeMetadata;
53
+ export declare function nodeEnvironmentMetadata(): FlexDocRuntimeEnvironmentMetadata | undefined;
54
+ export declare function discoverExpressRoutes(app: any, excludePrefix?: string): FlexDocRuntimeDiscovery;
55
+ export declare function discoverFastifyRoutes(app: any, excludePrefix?: string): Promise<FlexDocRuntimeDiscovery>;
56
+ export declare function discoverHonoRoutes(app: any, excludePrefix?: string): FlexDocRuntimeDiscovery;
57
+ export declare function documentedOpenApiRoutes(spec: any): FlexDocRuntimeRoute[];
58
+ export interface FlexDocRuntimeIntelligenceSnapshotInput {
59
+ spec: any;
60
+ discovery: FlexDocRuntimeDiscovery;
61
+ serverOrigin?: string;
62
+ server?: FlexDocRuntimeServerMetadata;
63
+ environment?: FlexDocRuntimeEnvironmentMetadata;
64
+ runtime?: FlexDocRuntimeMetadata;
65
+ }
66
+ export declare function buildRuntimeIntelligenceSnapshot(input: FlexDocRuntimeIntelligenceSnapshotInput): FlexDocRuntimeIntelligenceSnapshot;
package/dist/runtime-intelligence.js ADDED
@@ -0,0 +1,270 @@
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 contract_validation_1 = require("./contract-validation");
13
+ const HTTP_METHODS = new Set(['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS', 'HEAD', 'TRACE']);
14
+ function runtimeIntelligenceEnabled(value) {
15
+ return value === true || (typeof value === 'object' && value?.enabled === true);
16
+ }
17
+ function normalizeRuntimePath(value) {
18
+ let path = value.trim();
19
+ if (!path.startsWith('/'))
20
+ path = `/${path}`;
21
+ path = path.replace(/:([A-Za-z0-9_]+)(?:\([^)]*\))?[?+*]?/g, '{$1}');
22
+ path = path.replace(/\/{2,}/g, '/');
23
+ if (path.length > 1 && path.endsWith('/'))
24
+ path = path.slice(0, -1);
25
+ return path || '/';
26
+ }
27
+ function normalizedRoute(method, path) {
28
+ const normalizedMethod = method.toUpperCase();
29
+ if (!HTTP_METHODS.has(normalizedMethod) || typeof path !== 'string')
30
+ return null;
31
+ return { method: normalizedMethod, path: normalizeRuntimePath(path) };
32
+ }
33
+ function routeKey(route) {
34
+ return `${route.method} ${route.path}`;
35
+ }
36
+ function contractRouteKey(route) {
37
+ return `${route.method} ${route.path.replace(/\{[^/{}]+\}/g, '{}')}`;
38
+ }
39
+ function uniqueSorted(routes) {
40
+ const byKey = new Map();
41
+ for (const route of routes) {
42
+ const key = contractRouteKey(route);
43
+ if (!byKey.has(key))
44
+ byKey.set(key, route);
45
+ }
46
+ return [...byKey.values()].sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method));
47
+ }
48
+ function duplicateRuntimeRoutes(routes) {
49
+ const registrations = new Map();
50
+ for (const route of routes) {
51
+ const key = contractRouteKey(route);
52
+ const current = registrations.get(key);
53
+ if (current)
54
+ current.count += 1;
55
+ else
56
+ registrations.set(key, { route, count: 1 });
57
+ }
58
+ return [...registrations.values()]
59
+ .filter(({ count }) => count > 1)
60
+ .map(({ route, count }) => ({ ...route, count }))
61
+ .sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method));
62
+ }
63
+ function isExcludedRoute(path, excludePrefix) {
64
+ if (!excludePrefix)
65
+ return false;
66
+ const excluded = normalizeRuntimePath(excludePrefix);
67
+ return path === excluded || path.startsWith(`${excluded}/`);
68
+ }
69
+ function withoutImplicitHeadRoutes(routes) {
70
+ const keys = new Set(routes.map(routeKey));
71
+ return routes.filter((route) => route.method !== 'HEAD' || !keys.has(`GET ${route.path}`));
72
+ }
73
+ function nodeRuntimeMetadata() {
74
+ return {
75
+ name: 'node',
76
+ version: process.version,
77
+ platform: process.platform,
78
+ arch: process.arch,
79
+ };
80
+ }
81
+ function nodeEnvironmentMetadata() {
82
+ const name = process.env.NODE_ENV?.trim();
83
+ return name ? { name } : undefined;
84
+ }
85
+ function discoverExpressRoutes(app, excludePrefix) {
86
+ const router = app?.router || app?._router;
87
+ const stack = Array.isArray(router?.stack) ? router.stack : null;
88
+ if (!stack)
89
+ return { framework: 'express', routes: [], complete: false };
90
+ const routes = [];
91
+ let complete = true;
92
+ const visit = (layers, prefix = '') => {
93
+ for (const layer of layers) {
94
+ const route = layer?.route;
95
+ if (route) {
96
+ const rawPaths = Array.isArray(route.path) ? route.path : [route.path];
97
+ for (const rawPath of rawPaths) {
98
+ if (typeof rawPath !== 'string') {
99
+ complete = false;
100
+ continue;
101
+ }
102
+ const fullPath = normalizeRuntimePath(`${prefix}${rawPath}`);
103
+ if (isExcludedRoute(fullPath, excludePrefix))
104
+ continue;
105
+ for (const [method, enabled] of Object.entries(route.methods || {})) {
106
+ if (!enabled)
107
+ continue;
108
+ const candidate = normalizedRoute(method, fullPath);
109
+ if (candidate)
110
+ routes.push(candidate);
111
+ }
112
+ }
113
+ continue;
114
+ }
115
+ if (Array.isArray(layer?.handle?.stack)) {
116
+ if (typeof layer.path === 'string')
117
+ visit(layer.handle.stack, `${prefix}${normalizeRuntimePath(layer.path)}`);
118
+ else
119
+ complete = false;
120
+ }
121
+ }
122
+ };
123
+ visit(stack);
124
+ const duplicates = duplicateRuntimeRoutes(routes);
125
+ return {
126
+ framework: 'express',
127
+ routes: uniqueSorted(routes),
128
+ ...(duplicates.length ? { duplicateRoutes: duplicates } : {}),
129
+ complete,
130
+ };
131
+ }
132
+ async function discoverFastifyRoutes(app, excludePrefix) {
133
+ const frameworkVersion = typeof app?.version === 'string' ? app.version : undefined;
134
+ if (typeof app?.printRoutes !== 'function') {
135
+ return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
136
+ }
137
+ try {
138
+ if (typeof app?.ready === 'function')
139
+ await app.ready();
140
+ const printed = app.printRoutes({ commonPrefix: false });
141
+ if (typeof printed !== 'string') {
142
+ return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
143
+ }
144
+ const fragments = [];
145
+ const routes = [];
146
+ let complete = true;
147
+ for (const line of printed.split(/\r?\n/)) {
148
+ if (!line.trim() || line.includes('•'))
149
+ continue;
150
+ const branch = Math.max(line.lastIndexOf('├── '), line.lastIndexOf('└── '));
151
+ if (branch < 0 || branch % 4 !== 0) {
152
+ complete = false;
153
+ continue;
154
+ }
155
+ const depth = branch / 4;
156
+ const label = line.slice(branch + 4).trim();
157
+ const match = label.match(/^(.*?)\s+\(([^)]+)\)(?:\s+.*)?$/);
158
+ const fragment = (match?.[1] || label).trim();
159
+ fragments[depth] = fragment;
160
+ fragments.length = depth + 1;
161
+ if (!match)
162
+ continue;
163
+ const fullPath = normalizeRuntimePath(fragments.join(''));
164
+ if (isExcludedRoute(fullPath, excludePrefix))
165
+ continue;
166
+ for (const method of match[2].split(',').map((value) => value.trim()).filter(Boolean)) {
167
+ const candidate = normalizedRoute(method, fullPath);
168
+ if (candidate)
169
+ routes.push(candidate);
170
+ else
171
+ complete = false;
172
+ }
173
+ }
174
+ const explicitRoutes = withoutImplicitHeadRoutes(routes);
175
+ const duplicates = duplicateRuntimeRoutes(explicitRoutes);
176
+ return {
177
+ framework: 'fastify',
178
+ ...(frameworkVersion ? { frameworkVersion } : {}),
179
+ routes: uniqueSorted(explicitRoutes),
180
+ ...(duplicates.length ? { duplicateRoutes: duplicates } : {}),
181
+ complete,
182
+ };
183
+ }
184
+ catch {
185
+ return { framework: 'fastify', ...(frameworkVersion ? { frameworkVersion } : {}), routes: [], complete: false };
186
+ }
187
+ }
188
+ function discoverHonoRoutes(app, excludePrefix) {
189
+ const source = Array.isArray(app?.routes) ? app.routes : null;
190
+ if (!source)
191
+ return { framework: 'hono', routes: [], complete: false };
192
+ const routes = [];
193
+ let complete = true;
194
+ for (const route of source) {
195
+ if (!route || typeof route.path !== 'string' || typeof route.method !== 'string') {
196
+ complete = false;
197
+ continue;
198
+ }
199
+ const method = route.method.toUpperCase();
200
+ if (method === 'ALL' || method === '*') {
201
+ complete = false;
202
+ continue;
203
+ }
204
+ const fullPath = normalizeRuntimePath(route.path);
205
+ if (isExcludedRoute(fullPath, excludePrefix))
206
+ continue;
207
+ const candidate = normalizedRoute(method, fullPath);
208
+ if (candidate)
209
+ routes.push(candidate);
210
+ else
211
+ complete = false;
212
+ }
213
+ const duplicates = duplicateRuntimeRoutes(routes);
214
+ return {
215
+ framework: 'hono',
216
+ routes: uniqueSorted(routes),
217
+ ...(duplicates.length ? { duplicateRoutes: duplicates } : {}),
218
+ complete,
219
+ };
220
+ }
221
+ function documentedOpenApiRoutes(spec) {
222
+ const routes = [];
223
+ for (const [path, pathItem] of Object.entries(spec?.paths || {})) {
224
+ if (!pathItem || typeof pathItem !== 'object')
225
+ continue;
226
+ for (const method of Object.keys(pathItem)) {
227
+ const candidate = normalizedRoute(method, path);
228
+ if (candidate)
229
+ routes.push(candidate);
230
+ }
231
+ }
232
+ return uniqueSorted(routes);
233
+ }
234
+ function buildRuntimeIntelligenceSnapshot(input) {
235
+ const documented = documentedOpenApiRoutes(input.spec);
236
+ const runtimeRoutes = uniqueSorted(input.discovery.routes);
237
+ const documentedKeys = new Set(documented.map(contractRouteKey));
238
+ const runtimeKeys = new Set(runtimeRoutes.map(contractRouteKey));
239
+ const matched = runtimeRoutes.filter((route) => documentedKeys.has(contractRouteKey(route))).length;
240
+ const runtimeOnly = runtimeRoutes.filter((route) => !documentedKeys.has(contractRouteKey(route)));
241
+ const documentedOnly = documented.filter((route) => !runtimeKeys.has(contractRouteKey(route)));
242
+ const environment = input.environment || nodeEnvironmentMetadata();
243
+ const validation = (0, contract_validation_1.validateRuntimeContract)({
244
+ documentedRoutes: documented,
245
+ runtimeRoutes,
246
+ duplicateRuntimeRoutes: input.discovery.duplicateRoutes,
247
+ discoveryComplete: input.discovery.complete,
248
+ });
249
+ return {
250
+ framework: input.discovery.framework,
251
+ ...(input.discovery.frameworkVersion ? { frameworkVersion: input.discovery.frameworkVersion } : {}),
252
+ runtime: input.runtime || nodeRuntimeMetadata(),
253
+ ...(input.serverOrigin ? { serverOrigin: input.serverOrigin } : {}),
254
+ ...(input.server ? { server: input.server } : {}),
255
+ ...(environment ? { environment } : {}),
256
+ discoveryComplete: input.discovery.complete,
257
+ routes: runtimeRoutes,
258
+ runtimeOnly,
259
+ documentedOnly,
260
+ summary: {
261
+ documented: documented.length,
262
+ runtime: runtimeRoutes.length,
263
+ matched,
264
+ runtimeOnly: runtimeOnly.length,
265
+ documentedOnly: documentedOnly.length,
266
+ },
267
+ validation,
268
+ };
269
+ }
270
+ //# sourceMappingURL=runtime-intelligence.js.map
package/dist/runtime-intelligence.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"runtime-intelligence.js","sourceRoot":"","sources":["../src/runtime-intelligence.ts"],"names":[],"mappings":"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"}
package/dist/runtime-intelligence.test.d.ts ADDED
@@ -0,0 +1 @@
1
+ export {};
package/dist/runtime-intelligence.test.js ADDED
@@ -0,0 +1,143 @@
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('retains duplicate Express registration evidence without double-counting wire-equivalent routes', () => {
38
+ const discovery = (0, runtime_intelligence_1.discoverExpressRoutes)({
39
+ router: {
40
+ stack: [
41
+ { route: { path: '/pets/:id', methods: { get: true } } },
42
+ { route: { path: '/pets/:petId', methods: { get: true } } },
43
+ ],
44
+ },
45
+ });
46
+ expect(discovery.routes).toEqual([{ method: 'GET', path: '/pets/{id}' }]);
47
+ expect(discovery.duplicateRoutes).toEqual([{ method: 'GET', path: '/pets/{id}', count: 2 }]);
48
+ });
49
+ it('discovers Fastify route trees after ready and suppresses implicit HEAD siblings', async () => {
50
+ const app = {
51
+ version: '5.12.1',
52
+ ready: jest.fn(async () => undefined),
53
+ printRoutes: jest.fn(() => [
54
+ '└── /',
55
+ ' ├── pets (GET, HEAD)',
56
+ ' │ └── /:petId (GET, HEAD)',
57
+ ' ├── internal/reindex (POST)',
58
+ ' └── docs (GET, HEAD)',
59
+ ].join('\n')),
60
+ };
61
+ expect(await (0, runtime_intelligence_1.discoverFastifyRoutes)(app, '/docs')).toEqual({
62
+ framework: 'fastify',
63
+ frameworkVersion: '5.12.1',
64
+ complete: true,
65
+ routes: [
66
+ { method: 'POST', path: '/internal/reindex' },
67
+ { method: 'GET', path: '/pets' },
68
+ { method: 'GET', path: '/pets/{petId}' },
69
+ ],
70
+ });
71
+ expect(app.ready).toHaveBeenCalledTimes(1);
72
+ expect(app.printRoutes).toHaveBeenCalledWith({ commonPrefix: false });
73
+ });
74
+ it('discovers Hono registered routes and excludes FlexDoc topology', () => {
75
+ const app = {
76
+ routes: [
77
+ { method: 'GET', path: '/pets' },
78
+ { method: 'POST', path: '/pets/:petId/actions' },
79
+ { method: 'GET', path: '/docs' },
80
+ { method: 'ALL', path: '/middleware/*' },
81
+ ],
82
+ };
83
+ expect((0, runtime_intelligence_1.discoverHonoRoutes)(app, '/docs')).toEqual({
84
+ framework: 'hono',
85
+ complete: false,
86
+ routes: [
87
+ { method: 'GET', path: '/pets' },
88
+ { method: 'POST', path: '/pets/{petId}/actions' },
89
+ ],
90
+ });
91
+ });
92
+ it('reports presence drift plus safe runtime server and environment metadata without enforcement', () => {
93
+ const snapshot = (0, runtime_intelligence_1.buildRuntimeIntelligenceSnapshot)({
94
+ spec: {
95
+ openapi: '3.1.0',
96
+ paths: {
97
+ '/pets': { get: {} },
98
+ '/pets/{petId}': { get: {} },
99
+ },
100
+ },
101
+ discovery: {
102
+ framework: 'fastify',
103
+ frameworkVersion: '5.12.1',
104
+ complete: true,
105
+ routes: [
106
+ { method: 'GET', path: '/pets' },
107
+ { method: 'POST', path: '/internal/reindex' },
108
+ ],
109
+ },
110
+ serverOrigin: 'https://api.example.com',
111
+ server: { localPort: 8443 },
112
+ environment: { name: 'production' },
113
+ runtime: { name: 'node', version: 'v22.22.3', platform: 'linux', arch: 'x64' },
114
+ });
115
+ expect(snapshot.summary).toEqual({ documented: 2, runtime: 2, matched: 1, runtimeOnly: 1, documentedOnly: 1 });
116
+ expect(snapshot.runtimeOnly).toEqual([{ method: 'POST', path: '/internal/reindex' }]);
117
+ expect(snapshot.documentedOnly).toEqual([{ method: 'GET', path: '/pets/{petId}' }]);
118
+ expect(snapshot.validation.summary).toEqual({ total: 2, errors: 1, warnings: 1, info: 0 });
119
+ expect(snapshot.serverOrigin).toBe('https://api.example.com');
120
+ expect(snapshot.server).toEqual({ localPort: 8443 });
121
+ expect(snapshot.environment).toEqual({ name: 'production' });
122
+ expect(snapshot.frameworkVersion).toBe('5.12.1');
123
+ expect(snapshot.runtime).toEqual({ name: 'node', version: 'v22.22.3', platform: 'linux', arch: 'x64' });
124
+ });
125
+ it('feeds duplicate host registrations into contract validation', () => {
126
+ const snapshot = (0, runtime_intelligence_1.buildRuntimeIntelligenceSnapshot)({
127
+ spec: { openapi: '3.1.0', paths: { '/pets/{petId}': { get: {} } } },
128
+ discovery: {
129
+ framework: 'express',
130
+ complete: true,
131
+ routes: [{ method: 'GET', path: '/pets/{id}' }],
132
+ duplicateRoutes: [{ method: 'GET', path: '/pets/{id}', count: 2 }],
133
+ },
134
+ });
135
+ expect(snapshot.summary).toEqual({ documented: 1, runtime: 1, matched: 1, runtimeOnly: 0, documentedOnly: 0 });
136
+ expect(snapshot.validation.findings).toEqual([expect.objectContaining({ code: 'runtime.duplicate-operation' })]);
137
+ });
138
+ it('marks discovery partial when a mounted Express router prefix cannot be recovered safely', () => {
139
+ const app = { router: { stack: [{ handle: { stack: [{ route: { path: '/child', methods: { get: true } } }] } }] } };
140
+ expect((0, runtime_intelligence_1.discoverExpressRoutes)(app).complete).toBe(false);
141
+ });
142
+ });
143
+ //# sourceMappingURL=runtime-intelligence.test.js.map
package/dist/runtime-intelligence.test.js.map ADDED
@@ -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))