@tsoa-next/runtime 8.0.4 → 8.0.5-dev.57.84bb4a63

package/dist/decorators/specPath.d.ts

@@ -0,0 +1,45 @@
+import { Readable } from 'node:stream';
+import { Swagger } from '../swagger/swagger';
+export type SpecRuntime = 'express' | 'koa' | 'hapi';
+export type BuiltinSpecPathTarget = 'json' | 'yaml' | 'swagger' | 'redoc' | 'rapidoc';
+export type SpecDocumentFormat = 'json' | 'yaml';
+export type SpecResponseValue = string | Readable;
+export interface SpecGenerator {
+    getSpecObject(): Promise<Swagger.Spec>;
+    getSpecString(format: SpecDocumentFormat): Promise<string>;
+}
+export interface SpecCacheContext {
+    cacheKey: string;
+    controllerClass: object;
+    fullPath: string;
+    path: string;
+    runtime: SpecRuntime;
+    target: BuiltinSpecPathTarget | 'custom';
+    format?: SpecDocumentFormat | 'html';
+}
+export interface SpecRequestContext extends SpecCacheContext {
+    request?: unknown;
+    response?: unknown;
+    getSpecObject(): Promise<Swagger.Spec>;
+    getSpecString(format: SpecDocumentFormat): Promise<string>;
+}
+export type SpecResponseHandler = (context: SpecRequestContext) => SpecResponseValue | Promise<SpecResponseValue>;
+export interface SpecCacheHandler {
+    get(context: SpecCacheContext): SpecResponseValue | Promise<SpecResponseValue | undefined> | undefined;
+    set(context: SpecCacheContext, value: string): void | Promise<void>;
+}
+export type SpecPathTarget = BuiltinSpecPathTarget | SpecResponseHandler;
+export type SpecPathCache = 'none' | 'memory' | SpecCacheHandler;
+export interface SpecPathDefinition {
+    path: string;
+    normalizedPath: string;
+    target: SpecPathTarget;
+    cache: SpecPathCache;
+}
+export declare function SpecPath(path?: string, target?: SpecPathTarget, cache?: SpecPathCache): ClassDecorator;
+export declare function fetchSpecPaths(target: object): readonly SpecPathDefinition[];
+export declare function describeSpecPath(specPath: SpecPathDefinition): {
+    cache: string;
+    path: string;
+    target: string;
+};

package/dist/decorators/specPath.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpecPath = SpecPath;
+exports.fetchSpecPaths = fetchSpecPaths;
+exports.describeSpecPath = describeSpecPath;
+const pathUtils_1 = require("../utils/pathUtils");
+const SPEC_PATHS_SYMBOL = Symbol.for('@tsoa-next/spec-paths');
+function isBuiltinSpecTarget(target) {
+    return typeof target === 'string';
+}
+function getTargetDescription(target) {
+    return isBuiltinSpecTarget(target) ? target : 'custom handler';
+}
+function getCacheDescription(cache) {
+    return typeof cache === 'string' ? cache : 'custom cache';
+}
+function getExistingSpecPaths(target) {
+    const existing = Reflect.get(target, SPEC_PATHS_SYMBOL);
+    return existing ? [...existing] : [];
+}
+function defineSpecPaths(target, specPaths) {
+    Reflect.defineProperty(target, SPEC_PATHS_SYMBOL, {
+        configurable: true,
+        enumerable: false,
+        value: specPaths,
+        writable: true,
+    });
+}
+function normalizeSpecPath(path) {
+    return (0, pathUtils_1.normalisePath)(path ?? 'spec', '/');
+}
+function SpecPath(path = 'spec', target = 'json', cache = 'memory') {
+    return classTarget => {
+        const normalizedPath = normalizeSpecPath(path);
+        const existing = getExistingSpecPaths(classTarget);
+        if (existing.some(specPath => specPath.normalizedPath === normalizedPath)) {
+            const className = typeof classTarget === 'function' && classTarget.name ? classTarget.name : 'anonymous controller';
+            throw new Error(`Duplicate @SpecPath('${path}') found on '${className}'. Multiple SpecPath decorators must resolve to unique paths.`);
+        }
+        existing.push({
+            cache,
+            normalizedPath,
+            path,
+            target,
+        });
+        defineSpecPaths(classTarget, existing);
+    };
+}
+function fetchSpecPaths(target) {
+    return getExistingSpecPaths(target);
+}
+function describeSpecPath(specPath) {
+    return {
+        cache: getCacheDescription(specPath.cache),
+        path: specPath.path,
+        target: getTargetDescription(specPath.target),
+    };
+}
+//# sourceMappingURL=specPath.js.map

package/dist/decorators/specPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specPath.js","sourceRoot":"","sources":["../../src/decorators/specPath.ts"],"names":[],"mappings":";;AAgFA,4BAmBC;AAED,wCAEC;AAED,4CAMC;AA7GD,kDAAkD;AA8ClD,MAAM,iBAAiB,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AAE7D,SAAS,mBAAmB,CAAC,MAAsB;IACjD,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAA;AACnC,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAsB;IAClD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAA;AAChE,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAoB;IAC/C,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAA;AAC3D,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAqC,CAAA;IAC3F,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACtC,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,SAA+B;IACtE,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,iBAAiB,EAAE;QAChD,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,IAAI;KACf,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAwB;IACjD,OAAO,IAAA,yBAAa,EAAC,IAAI,IAAI,MAAM,EAAE,GAAG,CAAC,CAAA;AAC3C,CAAC;AAED,SAAgB,QAAQ,CAAC,IAAI,GAAG,MAAM,EAAE,SAAyB,MAAM,EAAE,QAAuB,QAAQ;IACtG,OAAO,WAAW,CAAC,EAAE;QACnB,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAA;QAC9C,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAA;QAElD,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,cAAc,KAAK,cAAc,CAAC,EAAE,CAAC;YAC1E,MAAM,SAAS,GAAG,OAAO,WAAW,KAAK,UAAU,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,sBAAsB,CAAA;YACnH,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,gBAAgB,SAAS,+DAA+D,CAAC,CAAA;QACvI,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK;YACL,cAAc;YACd,IAAI;YACJ,MAAM;SACP,CAAC,CAAA;QAEF,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,MAAc;IAC3C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACrC,CAAC;AAED,SAAgB,gBAAgB,CAAC,QAA4B;IAC3D,OAAO;QACL,KAAK,EAAE,mBAAmB,CAAC,QAAQ,CAAC,KAAK,CAAC;QAC1C,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC;KAC9C,CAAA;AACH,CAAC"}

package/dist/index.d.ts

@@ -10,6 +10,7 @@ export * from './decorators/parameter';
 export * from './decorators/response';
 export * from './decorators/route';
 export * from './decorators/security';
+export * from './decorators/specPath';
 export * from './decorators/tags';
 export * from './decorators/validate';
 export * from './interfaces/controller';
@@ -19,8 +20,10 @@ export * from './interfaces/response';
 export * from './metadataGeneration/tsoa';
 export * from './routeGeneration/additionalProps';
 export * from './routeGeneration/externalValidation';
+export * from './routeGeneration/specPathSupport';
 export * from './routeGeneration/templateHelpers';
 export * from './routeGeneration/templates';
 export * from './routeGeneration/tsoa-route';
 export * from './swagger/swagger';
 export * from './utils/assertNever';
+export * from './utils/pathUtils';

package/dist/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./decorators/parameter"), exports);
 __exportStar(require("./decorators/response"), exports);
 __exportStar(require("./decorators/route"), exports);
 __exportStar(require("./decorators/security"), exports);
+__exportStar(require("./decorators/specPath"), exports);
 __exportStar(require("./decorators/tags"), exports);
 __exportStar(require("./decorators/validate"), exports);
 __exportStar(require("./interfaces/controller"), exports);
@@ -35,9 +36,11 @@ __exportStar(require("./interfaces/response"), exports);
 __exportStar(require("./metadataGeneration/tsoa"), exports);
 __exportStar(require("./routeGeneration/additionalProps"), exports);
 __exportStar(require("./routeGeneration/externalValidation"), exports);
+__exportStar(require("./routeGeneration/specPathSupport"), exports);
 __exportStar(require("./routeGeneration/templateHelpers"), exports);
 __exportStar(require("./routeGeneration/templates"), exports);
 __exportStar(require("./routeGeneration/tsoa-route"), exports);
 __exportStar(require("./swagger/swagger"), exports);
 __exportStar(require("./utils/assertNever"), exports);
+__exportStar(require("./utils/pathUtils"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAAyB;AACzB,2CAAwB;AACxB,0DAAuC;AACvC,uDAAoC;AACpC,yDAAsC;AACtC,uDAAoC;AACpC,2DAAwC;AACxC,2DAAwC;AACxC,yDAAsC;AACtC,wDAAqC;AACrC,qDAAkC;AAClC,wDAAqC;AACrC,oDAAiC;AACjC,wDAAqC;AACrC,0DAAuC;AACvC,oDAAiC;AACjC,yDAAsC;AACtC,wDAAqC;AACrC,4DAAyC;AACzC,oEAAiD;AACjD,uEAAoD;AACpD,oEAAiD;AACjD,8DAA2C;AAC3C,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4BAAyB;AACzB,2CAAwB;AACxB,0DAAuC;AACvC,uDAAoC;AACpC,yDAAsC;AACtC,uDAAoC;AACpC,2DAAwC;AACxC,2DAAwC;AACxC,yDAAsC;AACtC,wDAAqC;AACrC,qDAAkC;AAClC,wDAAqC;AACrC,wDAAqC;AACrC,oDAAiC;AACjC,wDAAqC;AACrC,0DAAuC;AACvC,oDAAiC;AACjC,yDAAsC;AACtC,wDAAqC;AACrC,4DAAyC;AACzC,oEAAiD;AACjD,uEAAoD;AACpD,oEAAiD;AACjD,oEAAiD;AACjD,8DAA2C;AAC3C,+DAA4C;AAC5C,oDAAiC;AACjC,sDAAmC;AACnC,oDAAiC"}

package/dist/routeGeneration/specPathSupport.d.ts

@@ -0,0 +1,27 @@
+import { SpecGenerator, SpecPathDefinition, SpecResponseValue, SpecRuntime } from '../decorators/specPath';
+import { Config, SpecConfig } from '../config';
+export interface RuntimeSpecConfigSnapshot {
+    compilerOptions?: Record<string, unknown>;
+    defaultNumberType?: Config['defaultNumberType'];
+    ignore?: string[];
+    spec: SpecConfig & {
+        entryFile: Config['entryFile'];
+        controllerPathGlobs?: Config['controllerPathGlobs'];
+        noImplicitAdditionalProperties: Exclude<Config['noImplicitAdditionalProperties'], undefined>;
+    };
+}
+export interface ResolvedSpecResponse {
+    body: SpecResponseValue;
+    contentType?: string;
+}
+type SpecContextArgs = {
+    controllerClass: object;
+    fullPath: string;
+    request?: unknown;
+    response?: unknown;
+    runtime: SpecRuntime;
+    specGenerator: SpecGenerator;
+    specPath: SpecPathDefinition;
+};
+export declare function resolveSpecPathResponse(args: SpecContextArgs): Promise<ResolvedSpecResponse>;
+export {};

package/dist/routeGeneration/specPathSupport.js

@@ -0,0 +1,405 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSpecPathResponse = resolveSpecPathResponse;
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_module_1 = require("node:module");
+const node_path_1 = require("node:path");
+const node_stream_1 = require("node:stream");
+const memoryCache = new WeakMap();
+const assetCache = new Map();
+const controllerCacheScopes = new WeakMap();
+const specGeneratorCacheScopes = new WeakMap();
+let controllerCacheScopeId = 0;
+let specGeneratorCacheScopeId = 0;
+function isAsyncIterable(value) {
+    return value != null && typeof value[Symbol.asyncIterator] === 'function';
+}
+function isReadableStream(value) {
+    return (isAsyncIterable(value) ||
+        value instanceof node_stream_1.Readable ||
+        (typeof value === 'object' &&
+            value !== null &&
+            'pipe' in value &&
+            typeof value.pipe === 'function' &&
+            'on' in value &&
+            typeof value.on === 'function'));
+}
+function getMemoryCache(specGenerator) {
+    const cached = memoryCache.get(specGenerator);
+    if (cached) {
+        return cached;
+    }
+    const created = new Map();
+    memoryCache.set(specGenerator, created);
+    return created;
+}
+function getControllerCacheScope(controllerClass) {
+    const cached = controllerCacheScopes.get(controllerClass);
+    if (cached) {
+        return cached;
+    }
+    const created = `controller:${controllerCacheScopeId++}`;
+    controllerCacheScopes.set(controllerClass, created);
+    return created;
+}
+function getSpecGeneratorCacheScope(specGenerator) {
+    const cached = specGeneratorCacheScopes.get(specGenerator);
+    if (cached) {
+        return cached;
+    }
+    const created = `spec-generator:${specGeneratorCacheScopeId++}`;
+    specGeneratorCacheScopes.set(specGenerator, created);
+    return created;
+}
+function getContentType(target) {
+    switch (target) {
+        case 'json':
+            return 'application/json; charset=utf-8';
+        case 'yaml':
+            return 'application/yaml; charset=utf-8';
+        default:
+            return 'text/html; charset=utf-8';
+    }
+}
+function getFormat(target) {
+    switch (target) {
+        case 'json':
+            return 'json';
+        case 'yaml':
+            return 'yaml';
+        case 'swagger':
+        case 'redoc':
+        case 'rapidoc':
+            return 'html';
+        default:
+            return undefined;
+    }
+}
+function getCacheHandler({ specGenerator, specPath }) {
+    const { cache } = specPath;
+    if (cache === 'none') {
+        return undefined;
+    }
+    if (cache === 'memory') {
+        const scopedMemoryCache = getMemoryCache(specGenerator);
+        return {
+            get(context) {
+                return scopedMemoryCache.get(context.cacheKey);
+            },
+            set(context, value) {
+                scopedMemoryCache.set(context.cacheKey, value);
+            },
+        };
+    }
+    return cache;
+}
+function getCacheKey({ controllerClass, fullPath, runtime, specGenerator, specPath }) {
+    const format = typeof specPath.target === 'string' ? specPath.target : 'custom';
+    let cacheMode;
+    if (specPath.cache === 'none') {
+        cacheMode = 'none';
+    }
+    else if (specPath.cache === 'memory') {
+        cacheMode = 'memory';
+    }
+    else {
+        cacheMode = 'custom';
+    }
+    const cacheInput = JSON.stringify({
+        cache: cacheMode,
+        controller: getControllerCacheScope(controllerClass),
+        fullPath,
+        format,
+        runtime,
+        specGenerator: getSpecGeneratorCacheScope(specGenerator),
+    });
+    return (0, node_crypto_1.createHash)('sha256').update(cacheInput).digest('hex');
+}
+function createSpecRequestContext(args) {
+    const target = typeof args.specPath.target === 'string' ? args.specPath.target : 'custom';
+    const cacheContext = {
+        cacheKey: getCacheKey(args),
+        controllerClass: args.controllerClass,
+        format: getFormat(target),
+        fullPath: args.fullPath,
+        path: args.specPath.path,
+        runtime: args.runtime,
+        target,
+    };
+    return {
+        ...cacheContext,
+        getSpecObject: () => args.specGenerator.getSpecObject(),
+        getSpecString: format => args.specGenerator.getSpecString(format),
+        request: args.request,
+        response: args.response,
+    };
+}
+async function readResponseValue(value) {
+    if (!isReadableStream(value)) {
+        return value;
+    }
+    if (isAsyncIterable(value)) {
+        const chunks = [];
+        for await (const chunk of value) {
+            chunks.push(toResponseChunkBuffer(chunk));
+        }
+        return Buffer.concat(chunks).toString('utf8');
+    }
+    return readReadableStreamFromEvents(value);
+}
+function toResponseChunkBuffer(chunk) {
+    if (typeof chunk === 'string') {
+        return Buffer.from(chunk);
+    }
+    if (chunk instanceof Uint8Array) {
+        return chunk;
+    }
+    return Buffer.from(String(chunk));
+}
+function readReadableStreamFromEvents(value) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        value.on('data', (chunk) => {
+            chunks.push(toResponseChunkBuffer(chunk));
+        });
+        value.once('end', () => {
+            resolve(Buffer.concat(chunks).toString('utf8'));
+        });
+        value.once('error', reject);
+    });
+}
+function serializeSpecForHtml(spec) {
+    return JSON.stringify(spec)
+        .replaceAll('<', String.raw `\u003c`)
+        .replaceAll('>', String.raw `\u003e`)
+        .replaceAll('&', String.raw `\u0026`);
+}
+function escapeHtmlText(value) {
+    return value.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
+}
+async function readPeerFile(packageName, candidates) {
+    const cacheKey = `${packageName}:${candidates.join('|')}`;
+    const cached = assetCache.get(cacheKey);
+    if (cached) {
+        return cached;
+    }
+    const loadPromise = (async () => {
+        let packageJsonPath;
+        try {
+            packageJsonPath = require.resolve(`${packageName}/package.json`);
+        }
+        catch {
+            throw new Error(`SpecPath target requires optional peer dependency '${packageName}'. Install it to serve this documentation target.`);
+        }
+        const packageRoot = (0, node_path_1.dirname)(packageJsonPath);
+        for (const candidate of candidates) {
+            try {
+                return await (0, promises_1.readFile)((0, node_path_1.join)(packageRoot, candidate), 'utf8');
+            }
+            catch {
+                continue;
+            }
+        }
+        throw new Error(`Unable to locate runtime asset for optional peer dependency '${packageName}'. Checked: ${candidates.join(', ')}`);
+    })();
+    assetCache.set(cacheKey, loadPromise);
+    return loadPromise;
+}
+async function readSwaggerDistAsset(runtime, assetName) {
+    let packageName;
+    if (runtime === 'express') {
+        packageName = 'swagger-ui-express';
+    }
+    else if (runtime === 'koa') {
+        packageName = 'swagger-ui-koa';
+    }
+    else {
+        packageName = 'hapi-swagger';
+    }
+    let packageJsonPath;
+    try {
+        packageJsonPath = require.resolve(`${packageName}/package.json`);
+    }
+    catch {
+        throw new Error(`SpecPath target 'swagger' requires optional peer dependency '${packageName}' for the '${runtime}' runtime.`);
+    }
+    const directPackageRoot = (0, node_path_1.dirname)(packageJsonPath);
+    const directCandidates = runtime === 'koa' ? [(0, node_path_1.join)('static', assetName)] : [];
+    for (const candidate of directCandidates) {
+        try {
+            return await (0, promises_1.readFile)((0, node_path_1.join)(directPackageRoot, candidate), 'utf8');
+        }
+        catch {
+            continue;
+        }
+    }
+    const requireFromPackage = (0, node_module_1.createRequire)(packageJsonPath);
+    let swaggerUiDistPackagePath;
+    try {
+        swaggerUiDistPackagePath = requireFromPackage.resolve('swagger-ui-dist/package.json');
+    }
+    catch {
+        throw new Error(`SpecPath target 'swagger' requires '${packageName}' to provide 'swagger-ui-dist'. Install or re-install '${packageName}'.`);
+    }
+    return (0, promises_1.readFile)((0, node_path_1.join)((0, node_path_1.dirname)(swaggerUiDistPackagePath), assetName), 'utf8');
+}
+async function loadSwaggerAssets(runtime) {
+    const [script, preset, style] = await Promise.all([
+        readSwaggerDistAsset(runtime, 'swagger-ui-bundle.js'),
+        readSwaggerDistAsset(runtime, 'swagger-ui-standalone-preset.js'),
+        readSwaggerDistAsset(runtime, 'swagger-ui.css'),
+    ]);
+    return { preset, script, style };
+}
+async function loadRedocAssets() {
+    return {
+        script: await readPeerFile('redoc', ['bundles/redoc.standalone.js']),
+    };
+}
+async function loadRapiDocAssets() {
+    return {
+        script: await readPeerFile('rapidoc', ['dist/rapidoc-min.js']),
+    };
+}
+async function renderSwaggerHtml(spec, runtime) {
+    const assets = await loadSwaggerAssets(runtime);
+    const title = escapeHtmlText(spec.info.title || 'API documentation');
+    const serializedSpec = serializeSpecForHtml(spec);
+    return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${title}</title>
+    <style>
+      html { box-sizing: border-box; overflow-y: scroll; }
+      *, *:before, *:after { box-sizing: inherit; }
+      body { margin: 0; background: #fafafa; }
+      ${assets.style ?? ''}
+    </style>
+  </head>
+  <body>
+    <div id="swagger-ui"></div>
+    <script>${assets.script}</script>
+    <script>${assets.preset ?? ''}</script>
+    <script>
+      window.ui = SwaggerUIBundle({
+        spec: ${serializedSpec},
+        dom_id: '#swagger-ui',
+        deepLinking: true,
+        presets: [SwaggerUIBundle.presets.apis, SwaggerUIStandalonePreset],
+        layout: 'BaseLayout'
+      });
+    </script>
+  </body>
+</html>`;
+}
+async function renderRedocHtml(spec) {
+    const assets = await loadRedocAssets();
+    const title = escapeHtmlText(spec.info.title || 'API documentation');
+    const serializedSpec = serializeSpecForHtml(spec);
+    return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${title}</title>
+    <style>
+      body { margin: 0; padding: 0; }
+    </style>
+  </head>
+  <body>
+    <div id="redoc-container"></div>
+    <script>${assets.script}</script>
+    <script>
+      Redoc.init(${serializedSpec}, {}, document.getElementById('redoc-container'));
+    </script>
+  </body>
+</html>`;
+}
+async function renderRapiDocHtml(spec) {
+    const assets = await loadRapiDocAssets();
+    const title = escapeHtmlText(spec.info.title || 'API documentation');
+    const serializedSpec = serializeSpecForHtml(spec);
+    return `<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${title}</title>
+    <style>
+      body { margin: 0; padding: 0; }
+      rapi-doc { width: 100vw; height: 100vh; display: block; }
+    </style>
+  </head>
+  <body>
+    <rapi-doc id="rapidoc" render-style="read" show-header="false"></rapi-doc>
+    <script>${assets.script}</script>
+    <script>
+      document.getElementById('rapidoc').loadSpec(${serializedSpec});
+    </script>
+  </body>
+</html>`;
+}
+async function buildBuiltinResponse(target, context) {
+    switch (target) {
+        case 'json':
+            return {
+                body: await context.getSpecString('json'),
+                contentType: getContentType(target),
+            };
+        case 'yaml':
+            return {
+                body: await context.getSpecString('yaml'),
+                contentType: getContentType(target),
+            };
+        case 'swagger':
+            return {
+                body: await renderSwaggerHtml(await context.getSpecObject(), context.runtime),
+                contentType: getContentType(target),
+            };
+        case 'redoc':
+            return {
+                body: await renderRedocHtml(await context.getSpecObject()),
+                contentType: getContentType(target),
+            };
+        case 'rapidoc':
+            return {
+                body: await renderRapiDocHtml(await context.getSpecObject()),
+                contentType: getContentType(target),
+            };
+    }
+}
+async function resolveHandlerResponse(specPath, context) {
+    if (typeof specPath.target === 'string') {
+        return buildBuiltinResponse(specPath.target, context);
+    }
+    const body = await specPath.target(context);
+    return { body };
+}
+async function resolveSpecPathResponse(args) {
+    const context = createSpecRequestContext(args);
+    const cacheHandler = getCacheHandler(args);
+    if (cacheHandler) {
+        const cached = await cacheHandler.get(context);
+        if (cached !== undefined) {
+            return {
+                body: cached,
+                contentType: typeof args.specPath.target === 'string' ? getContentType(args.specPath.target) : undefined,
+            };
+        }
+    }
+    const resolved = await resolveHandlerResponse(args.specPath, context);
+    if (!cacheHandler) {
+        return resolved;
+    }
+    if (typeof resolved.body === 'string') {
+        await cacheHandler.set(context, resolved.body);
+        return resolved;
+    }
+    const serialized = await readResponseValue(resolved.body);
+    await cacheHandler.set(context, serialized);
+    return { ...resolved, body: serialized };
+}
+//# sourceMappingURL=specPathSupport.js.map

package/dist/routeGeneration/specPathSupport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specPathSupport.js","sourceRoot":"","sources":["../../src/routeGeneration/specPathSupport.ts"],"names":[],"mappings":"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"}

package/dist/utils/pathUtils.d.ts

@@ -0,0 +1 @@
+export declare function normalisePath(path: string, withPrefix?: string, withSuffix?: string, skipPrefixAndSuffixIfEmpty?: boolean): string;

package/dist/utils/pathUtils.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalisePath = normalisePath;
+function isPathDelimiter(character) {
+    return character === '/' || character === '\\' || character.trim() === '';
+}
+function trimPathDelimiters(path) {
+    let start = 0;
+    let end = path.length;
+    while (start < end && isPathDelimiter(path[start])) {
+        start += 1;
+    }
+    while (end > start && isPathDelimiter(path[end - 1])) {
+        end -= 1;
+    }
+    return path.slice(start, end);
+}
+function collapsePathDelimiters(path) {
+    const normalizedChars = [];
+    let previousWasDelimiter = false;
+    for (const character of path) {
+        if (isPathDelimiter(character)) {
+            if (!previousWasDelimiter) {
+                normalizedChars.push('/');
+                previousWasDelimiter = true;
+            }
+            continue;
+        }
+        normalizedChars.push(character);
+        previousWasDelimiter = false;
+    }
+    return normalizedChars.join('');
+}
+function normalisePath(path, withPrefix, withSuffix, skipPrefixAndSuffixIfEmpty = true) {
+    if ((!path || path === '/') && skipPrefixAndSuffixIfEmpty) {
+        return '';
+    }
+    if (!path || typeof path !== 'string') {
+        path = '' + path;
+    }
+    let normalized = trimPathDelimiters(path);
+    normalized = withPrefix ? withPrefix + normalized : normalized;
+    normalized = withSuffix ? normalized + withSuffix : normalized;
+    return collapsePathDelimiters(normalized);
+}
+//# sourceMappingURL=pathUtils.js.map

package/dist/utils/pathUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathUtils.js","sourceRoot":"","sources":["../../src/utils/pathUtils.ts"],"names":[],"mappings":";;AAuCA,sCAcC;AArDD,SAAS,eAAe,CAAC,SAAiB;IACxC,OAAO,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,CAAA;AAC3E,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY;IACtC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAA;IAErB,OAAO,KAAK,GAAG,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QACnD,KAAK,IAAI,CAAC,CAAA;IACZ,CAAC;IAED,OAAO,GAAG,GAAG,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,IAAI,CAAC,CAAA;IACV,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;AAC/B,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,MAAM,eAAe,GAAa,EAAE,CAAA;IACpC,IAAI,oBAAoB,GAAG,KAAK,CAAA;IAEhC,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAC1B,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACzB,oBAAoB,GAAG,IAAI,CAAA;YAC7B,CAAC;YACD,SAAQ;QACV,CAAC;QAED,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC/B,oBAAoB,GAAG,KAAK,CAAA;IAC9B,CAAC;IAED,OAAO,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AACjC,CAAC;AAED,SAAgB,aAAa,CAAC,IAAY,EAAE,UAAmB,EAAE,UAAmB,EAAE,0BAA0B,GAAG,IAAI;IACrH,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,0BAA0B,EAAE,CAAC;QAC1D,OAAO,EAAE,CAAA;IACX,CAAC;IAED,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,IAAI,UAAU,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;IACzC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IAC9D,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;IAE9D,OAAO,sBAAsB,CAAC,UAAU,CAAC,CAAA;AAC3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsoa-next/runtime",
-  "version": "8.0.4",
+  "version": "8.0.5-dev.57.84bb4a63",
   "description": "Build swagger-compliant REST APIs using TypeScript and Node",
   "main": "./dist/index.js",
   "typings": "./dist/index.d.ts",
@@ -29,7 +29,7 @@
   "license": "MIT",
   "dependencies": {
     "@hapi/boom": "^10.0.1",
-    "@hapi/hapi": "^21.4.7",
+    "@hapi/hapi": "^21.4.8",
     "@types/koa": "^2.15.0",
     "@types/multer": "^2.1.0",
     "reflect-metadata": "^0.2.2",
@@ -44,10 +44,15 @@
   "peerDependencies": {
     "express": "^4.21.0 || ^5.0.0",
     "fp-ts": "^2.16.11",
+    "hapi-swagger": "^17.3.2",
     "io-ts": "^2.2.21",
     "io-ts-types": "^0.5.19",
     "joi": "^17.13.3",
+    "rapidoc": "^9.3.8",
+    "redoc": "^2.5.2",
     "superstruct": "^2.0.2",
+    "swagger-ui-express": "^5.0.1",
+    "swagger-ui-koa": "^0.0.1",
     "yup": "^1.7.1",
     "zod": "^4.1.11"
   },
@@ -58,6 +63,9 @@
     "fp-ts": {
       "optional": true
     },
+    "hapi-swagger": {
+      "optional": true
+    },
     "io-ts": {
       "optional": true
     },
@@ -67,9 +75,21 @@
     "joi": {
       "optional": true
     },
+    "rapidoc": {
+      "optional": true
+    },
+    "redoc": {
+      "optional": true
+    },
     "superstruct": {
       "optional": true
     },
+    "swagger-ui-express": {
+      "optional": true
+    },
+    "swagger-ui-koa": {
+      "optional": true
+    },
     "yup": {
       "optional": true
     },