@nestia/sdk 14.0.0 → 14.0.2

package/lib/generates/SdkGenerator.js

@@ -14,14 +14,34 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SdkGenerator = void 0;
 const fs_1 = __importDefault(require("fs"));
-const path_1 = __importDefault(require("path"));
+const SdkBundlePath_1 = require("../utils/SdkBundlePath");
 const StringUtil_1 = require("../utils/StringUtil");
 const CloneGenerator_1 = require("./CloneGenerator");
 const SdkDistributionComposer_1 = require("./internal/SdkDistributionComposer");
 const SdkFileProgrammer_1 = require("./internal/SdkFileProgrammer");
 const SdkHttpParameterProgrammer_1 = require("./internal/SdkHttpParameterProgrammer");
+/**
+ * Generates the SDK library and validates the analyzed routes it needs.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace bundles the static files, writes the DTOs and the functions, composes the distribution package, and reports the errors the generation would meet.
+ * @evidence contracts/common.md#clear-and-simple-design Two public functions, one public constant, and the private validators.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Validation and generation share the same route model.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Static bundle enumeration and output creation use Node fs; declaration/module path conversion and distribution process launching are delegated to ImportDictionary and SdkDistributionComposer. Existing file spelling is checked by the filesystem rather than an OS-name case rule.
+ */
 var SdkGenerator;
 (function (SdkGenerator) {
+    /**
+     * Writes the SDK into the configured output directory: the bundled files, the
+     * DTOs when `clone` is on, the functions, and the distribution package when
+     * `distribute` is set.
+     *
+     * @evidence contracts/common.md#principled-implementation The steps run in dependency order, the bundle first and the distribution last. An absent output option throws before writing; a configured directory that does not exist is created recursively.
+     * @evidence contracts/common.md#clear-and-simple-design One function that delegates each step.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The steps are sequential and each awaits the previous one.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation Node mkdir and the bundle writer accept the configured native output path; subsequent file and process boundaries belong to their delegated writers. Configuration omission is distinct from a missing on-disk directory.
+     */
     SdkGenerator.generate = (app) => __awaiter(this, void 0, void 0, function* () {
         if (app.project.config.output === undefined)
             throw new Error("Output directory is not defined.");
@@ -43,6 +63,18 @@ var SdkGenerator;
                 websocket: app.routes.some((r) => r.protocol === "websocket"),
             });
     });
+    /**
+     * Returns the errors of routes that cannot become an SDK: MCP tools with
+     * duplicate names or accessors, and, without `clone`, HTTP routes whose
+     * parameter or return types are implicit, plus implicit exception types when
+     * propagation is enabled.
+     *
+     * @evidence contracts/common.md#principled-implementation The MCP checks always apply, and the implicit return check applies only where the SDK would have to name the type, because `clone` writes it as a declaration instead.
+     * @evidence contracts/common.md#clear-and-simple-design One function over three checks.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The list is collected, not thrown, so one run reports every error.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation Validation judges analyzed route types and names and performs no native filesystem or process operation.
+     */
     SdkGenerator.validate = (app) => {
         const errors = [];
         validateMcpDuplicates(errors)(app.routes);
@@ -109,7 +141,7 @@ var SdkGenerator;
                 props.errors.push({
                     file: props.route.controller.file,
                     class: props.route.controller.class.name,
-                    function: props.route.name,
+                    function: props.route.key,
                     from: `parameter ${JSON.stringify(p.name)}`,
                     contents: [`implicit (unnamed) parameter type.`],
                 });
@@ -120,7 +152,7 @@ var SdkGenerator;
                     props.errors.push({
                         file: props.route.controller.file,
                         class: props.route.controller.class.name,
-                        function: props.route.name,
+                        function: props.route.key,
                         from: `exception ${JSON.stringify(key)}`,
                         contents: [`implicit (unnamed) exception type.`],
                     });
@@ -129,7 +161,7 @@ var SdkGenerator;
             props.errors.push({
                 file: props.route.controller.file,
                 class: props.route.controller.class.name,
-                function: props.route.name,
+                function: props.route.key,
                 from: "success",
                 contents: [`implicit (unnamed) return type.`],
             });
@@ -148,6 +180,12 @@ var SdkGenerator;
      * Files the user already has are never touched, so that hand-written
      * customizations (e.g. extra re-exports in `module.ts`) survive regeneration.
      * Only missing files are filled in from the bundle.
+     *
+     * @evidence contracts/common.md#principled-implementation A file that the user has customized is never overwritten, and only files that are missing are filled in from the bundle.
+     * @evidence contracts/common.md#clear-and-simple-design One loop with two guards.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The existing target is checked before the write.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation fs.readdir/stat enumerate the installed bundle and fs.existsSync checks each target under the filesystem's own policy before writing UTF-8. Forward slash suffixes are accepted by Node on supported native platforms; concurrent generation into the same output is not an exclusive ownership guarantee.
      */
     SdkGenerator.bundle = (output) => __awaiter(this, void 0, void 0, function* () {
         const files = yield fs_1.default.promises.readdir(SdkGenerator.BUNDLE_PATH);
@@ -163,6 +201,6 @@ var SdkGenerator;
             yield fs_1.default.promises.writeFile(target, content, "utf8");
         }
     });
-    SdkGenerator.BUNDLE_PATH = path_1.default.join(__dirname, "..", "..", "assets", "bundle", "api");
+    SdkGenerator.BUNDLE_PATH = SdkBundlePath_1.SDK_BUNDLE_PATH;
 })(SdkGenerator || (exports.SdkGenerator = SdkGenerator = {}));
 //# sourceMappingURL=SdkGenerator.js.map

package/lib/generates/SdkGenerator.js.map

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

package/lib/generates/SwaggerGenerator.d.ts

@@ -1,13 +1,43 @@
 import { OpenApi } from "@typia/interface";
 import { INestiaConfig } from "../INestiaConfig";
 import { ITypedApplication } from "../structures/ITypedApplication";
-import { ITypedHttpRoute } from "../structures/ITypedHttpRoute";
+/**
+ * Composes and writes the OpenAPI document.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace resolves the output location, builds the document from the routes, downgrades it when an older version is configured, and writes it.
+ * @evidence contracts/common.md#clear-and-simple-design Three public functions and private helpers for security, customizers, and the copy of the document.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The composition never edits data it does not own.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Output locations use Node path.parse/resolve/join and UTF-8 fs writes; package defaults are located through FileRetriever from the current native working directory. HTTP operation paths remain protocol strings handled by PathAnalyzer.
+ */
 export declare namespace SwaggerGenerator {
+    /**
+     * Writes the document to the configured location: a `.json` path as it is,
+     * and a directory as its `swagger.json`.
+     *
+     * The document is downgraded when `openapi` names an older version.
+     *
+     * @evidence contracts/common.md#principled-implementation The directory is created recursively and a failure to create it is reported with its cause; the document is composed, converted, and written in that order.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The failure to create the directory is not swallowed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation path.parse classifies an output by its extension, path.resolve and path.dirname obtain native destinations, and fs.mkdir/writeFile own creation and writing without shell interpretation. Any nonempty extension denotes a file; the example .json extension is not an exclusive suffix check.
+     */
     const generate: (app: ITypedApplication) => Promise<void>;
-    const compose: (props: {
-        config: Omit<INestiaConfig.ISwaggerConfig, "output">;
-        routes: ITypedHttpRoute[];
-        document: OpenApi.IDocument;
-    }) => OpenApi.IDocument;
+    /**
+     * Returns the document the composition starts from: the configured info,
+     * servers, security schemes, and tags, or the defaults.
+     *
+     * Tags are copied immediately; configured servers, security schemes and
+     * nested info values remain shared until compose detaches the document before
+     * customizers run. Callers using initialize alone must preserve those shared
+     * values.
+     *
+     * @evidence contracts/common.md#principled-implementation A per-call lazy Singleton reads package metadata at most once when info defaults need it. Each call allocates a document and copies the tag list; configured servers, security schemes and nested info values are detached later by compose before customization.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults follow the configuration contract; initialize does not mutate configured values, while compose owns detaching the remaining shared JSON trees.
+     * @evidence contracts/common.md#meaningful-documentation The comment identifies defaults and distinguishes the immediate tag copy from values shared until compose, including the restriction on initialize-only callers.
+     * @evidence contracts/portability.md#os-neutral-implementation The lazy package-info reader starts from process.cwd and FileRetriever supplies the nearest package.json within its bounded native-parent search. fs.readFile reads UTF-8; unreadable or malformed package metadata yields documented info defaults rather than an OS-specific fallback command.
+     */
     const initialize: (config: Omit<INestiaConfig.ISwaggerConfig, "output">) => Promise<OpenApi.IDocument>;
 }

package/lib/generates/SwaggerGenerator.js

@@ -17,13 +17,34 @@ const utils_1 = require("@typia/utils");
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const tstl_1 = require("tstl");
+const PathAnalyzer_1 = require("../analyses/PathAnalyzer");
 const legacy_1 = require("../internal/legacy");
 const FileRetriever_1 = require("../utils/FileRetriever");
 const SdkHttpParameterProgrammer_1 = require("./internal/SdkHttpParameterProgrammer");
 const SwaggerOperationComposer_1 = require("./internal/SwaggerOperationComposer");
-const SwaggerReadonlyArrayEmender_1 = require("./internal/SwaggerReadonlyArrayEmender");
+/**
+ * Composes and writes the OpenAPI document.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace resolves the output location, builds the document from the routes, downgrades it when an older version is configured, and writes it.
+ * @evidence contracts/common.md#clear-and-simple-design Three public functions and private helpers for security, customizers, and the copy of the document.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The composition never edits data it does not own.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Output locations use Node path.parse/resolve/join and UTF-8 fs writes; package defaults are located through FileRetriever from the current native working directory. HTTP operation paths remain protocol strings handled by PathAnalyzer.
+ */
 var SwaggerGenerator;
 (function (SwaggerGenerator) {
+    /**
+     * Writes the document to the configured location: a `.json` path as it is,
+     * and a directory as its `swagger.json`.
+     *
+     * The document is downgraded when `openapi` names an older version.
+     *
+     * @evidence contracts/common.md#principled-implementation The directory is created recursively and a failure to create it is reported with its cause; the document is composed, converted, and written in that order.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The failure to create the directory is not swallowed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation path.parse classifies an output by its extension, path.resolve and path.dirname obtain native destinations, and fs.mkdir/writeFile own creation and writing without shell interpretation. Any nonempty extension denotes a file; the example .json extension is not an exclusive suffix check.
+     */
     SwaggerGenerator.generate = (app) => __awaiter(this, void 0, void 0, function* () {
         var _a;
         // GET CONFIGURATION
@@ -37,13 +58,12 @@ var SwaggerGenerator;
             ? path_1.default.resolve(config.output)
             : path_1.default.join(path_1.default.resolve(config.output), "swagger.json");
         const directory = path_1.default.dirname(location);
-        if (fs_1.default.existsSync(directory) === false)
-            try {
-                yield fs_1.default.promises.mkdir(directory, { recursive: true });
-            }
-            catch (_b) { }
-        if (fs_1.default.existsSync(directory) === false)
-            throw new Error(`Error on NestiaApplication.swagger(): failed to create output directory: ${directory}`);
+        try {
+            yield fs_1.default.promises.mkdir(directory, { recursive: true });
+        }
+        catch (error) {
+            throw new Error(`Error on NestiaApplication.swagger(): failed to create output directory: ${directory} (${error instanceof Error ? error.message : String(error)})`);
+        }
         // COMPOSE SWAGGER DOCUMENT
         const document = SwaggerGenerator.compose({
             config,
@@ -57,6 +77,19 @@ var SwaggerGenerator;
             ? JSON.stringify(specified)
             : JSON.stringify(specified, null, typeof config.beautify === "number" ? config.beautify : 2), "utf8");
     });
+    /**
+     * Composes the document of the HTTP routes into the given document: the
+     * components of every schema, and the paths.
+     *
+     * A route tagged `@internal` or `@hidden`, or excluded by
+     * `@ApiExcludeEndpoint`, is left out.
+     *
+     * @evidence contracts/common.md#principled-implementation The schemas of all routes are composed in one call, so a component shared by routes exists once, and the readonly arrays are emended before the paths refer to them.
+     * @evidence contracts/common.md#clear-and-simple-design One function of sequential steps.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exclusion is the documented set of tags and decorators.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation compose operates on analyzed metadata and OpenAPI protocol paths; it neither opens native files nor launches processes.
+     */
     SwaggerGenerator.compose = (props) => {
         var _a;
         var _b;
@@ -75,11 +108,6 @@ var SwaggerGenerator;
             version: "3.1",
             metadatas,
         });
-        json.schemas.forEach((schema, i) => SwaggerReadonlyArrayEmender_1.SwaggerReadonlyArrayEmender.emend({
-            components: json.components,
-            schema,
-            metadata: metadatas[i],
-        }));
         const dict = new WeakMap();
         json.schemas.forEach((schema, i) => dict.set(metadatas[i], schema));
         const schema = (metadata) => dict.get(metadata);
@@ -92,6 +120,21 @@ var SwaggerGenerator;
             document }));
         return document;
     };
+    /**
+     * Returns the document the composition starts from: the configured info,
+     * servers, security schemes, and tags, or the defaults.
+     *
+     * Tags are copied immediately; configured servers, security schemes and
+     * nested info values remain shared until compose detaches the document before
+     * customizers run. Callers using initialize alone must preserve those shared
+     * values.
+     *
+     * @evidence contracts/common.md#principled-implementation A per-call lazy Singleton reads package metadata at most once when info defaults need it. Each call allocates a document and copies the tag list; configured servers, security schemes and nested info values are detached later by compose before customization.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The defaults follow the configuration contract; initialize does not mutate configured values, while compose owns detaching the remaining shared JSON trees.
+     * @evidence contracts/common.md#meaningful-documentation The comment identifies defaults and distinguishes the immediate tag copy from values shared until compose, including the restriction on initialize-only callers.
+     * @evidence contracts/portability.md#os-neutral-implementation The lazy package-info reader starts from process.cwd and FileRetriever supplies the nearest package.json within its bounded native-parent search. fs.readFile reads UTF-8; unreadable or malformed package metadata yields documented info defaults rather than an OS-specific fallback command.
+     */
     SwaggerGenerator.initialize = (config) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b, _c, _d, _e, _f, _g, _h;
         var _j, _k, _l, _m, _o, _p, _q, _r, _s, _t;
@@ -137,7 +180,8 @@ var SwaggerGenerator;
                 schemas: {},
                 securitySchemes: config.security,
             },
-            tags: (_t = config.tags) !== null && _t !== void 0 ? _t : [],
+            // a copy, because composing pushes each route's tags into this list
+            tags: clone((_t = config.tags) !== null && _t !== void 0 ? _t : []),
             "x-typia-emended-v12": true,
         };
     });
@@ -173,48 +217,154 @@ var SwaggerGenerator;
             get: new tstl_1.Singleton(() => (key) => {
                 var _a, _b;
                 const method = key.method.toLowerCase();
-                const path = "/" +
+                const normalized = "/" +
                     key.path
                         .split("/")
                         .filter((str) => !!str.length)
-                        .map((str) => str.startsWith(":") ? `{${str.substring(1)}}` : str)
                         .join("/");
+                // a route path, `:id`, as the router reads it; an accessor already
+                // in OpenAPI form, `{id}`, is taken as is
+                const path = normalized.includes(":")
+                    ? PathAnalyzer_1.PathAnalyzer.toOpenApi(normalized)
+                    : normalized;
                 return (_b = (_a = props.document.paths) === null || _a === void 0 ? void 0 : _a[path]) === null || _b === void 0 ? void 0 : _b[method];
             }),
         };
         // COMPOSE OPERATIONS
+        const violations = [];
         for (const r of props.routes) {
-            const operation = SwaggerOperationComposer_1.SwaggerOperationComposer.compose(Object.assign(Object.assign({}, props), { route: r }));
+            const method = r.method.toLowerCase();
             const path = getPath(r);
             (_a = (_c = props.document).paths) !== null && _a !== void 0 ? _a : (_c.paths = {});
             (_b = (_d = props.document.paths)[path]) !== null && _b !== void 0 ? _b : (_d[path] = {});
-            props.document.paths[path][r.method.toLowerCase()] = operation;
-            const closure = Reflect.getMetadata("nestia/SwaggerCustomizer", r.controller.class.prototype, r.name);
-            if (closure !== undefined) {
-                const array = Array.isArray(closure) ? closure : [closure];
-                customizers.push(() => {
-                    for (const closure of array)
-                        closure({
-                            swagger: props.document,
-                            method: r.method,
-                            path,
-                            route: operation,
-                            at: (func) => neighbor.at.get().get(func),
-                            get: (accessor) => neighbor.get.get()(accessor),
-                        });
+            props.document.paths[path][method] = SwaggerOperationComposer_1.SwaggerOperationComposer.compose(Object.assign(Object.assign({}, props), { route: r }));
+            violations.push(...validateSecurity({
+                config: props.config,
+                route: r,
+                security: props.document.paths[path][method].security,
+            }));
+            const closure = Reflect.getMetadata("nestia/SwaggerCustomizer", r.controller.class.prototype, r.key);
+            if (closure !== undefined)
+                customizers.push({
+                    route: r,
+                    method,
+                    path,
+                    closures: Array.isArray(closure) ? closure : [closure],
                 });
-            }
         }
-        // DO CUSTOMIZE
-        for (const fn of customizers)
-            fn();
+        if (violations.length !== 0)
+            throw new Error([
+                `Error on Swagger composition: invalid security requirements. Declare every scheme a route names, with its scopes, in the "security" of the Swagger configuration: "swagger.security" of "nestia.config.ts", or the configuration given to NestiaSwaggerComposer.document().`,
+                "",
+                "List of violations:",
+                ...violations,
+            ].join("\n"));
+        // DETACH, then DO CUSTOMIZE
+        detach(props.document);
+        // Each customizer receives the operation composed for its own route, found
+        // before any customizer runs, since one may move or delete paths.
+        const operations = customizers.map((c) => props.document.paths[c.path][c.method]);
+        customizers.forEach((c, i) => {
+            for (const closure of c.closures)
+                closure({
+                    swagger: props.document,
+                    method: c.route.method,
+                    path: c.path,
+                    route: operations[i],
+                    at: (func) => neighbor.at.get().get(func),
+                    get: (accessor) => neighbor.get.get()(accessor),
+                });
+        });
+    };
+    /**
+     * Replaces every member of the composed document with a copy, in place.
+     *
+     * Operations still hold values nestia does not own by reference: decorator
+     * examples, `@ApiExtension` values, security requirements, and the configured
+     * servers, security schemes, and document info. They outlive the document,
+     * since route metadata and the configuration serve every composition in the
+     * process, so a `SwaggerCustomizer` or a caller editing one document edited
+     * all of them, and the next composition started from the edit. It runs before
+     * the customizers, which may then edit freely.
+     */
+    const detach = (document) => {
+        const copy = clone(document);
+        for (const key of Object.keys(document))
+            delete document[key];
+        Object.assign(document, copy);
     };
-    const getPath = (route) => {
-        let str = route.path;
-        for (const param of route.pathParameters)
-            str = str.replace(`:${param.field}`, `{${param.field}}`);
-        return str;
+    /**
+     * Copies the arrays and plain objects `value` is built of, keeping every
+     * other value as it is.
+     *
+     * A document is edited as the tree its JSON is, so every reference to an
+     * array or plain object gets its own copy, except a reference back to an
+     * enclosing one, which stays circular. Values are not converted: a JSON copy
+     * would throw on a bigint example or turn a `Date` into a string before the
+     * customizer or caller that handles it runs.
+     */
+    const clone = (value, ancestors = new Map()) => {
+        if (typeof value !== "object" || value === null)
+            return value;
+        const prototype = Object.getPrototypeOf(value);
+        const array = Array.isArray(value);
+        if (!array && prototype !== Object.prototype && prototype !== null)
+            return value;
+        const circular = ancestors.get(value);
+        if (circular !== undefined)
+            return circular;
+        const output = (array ? new Array(value.length) : {});
+        ancestors.set(value, output);
+        for (const key of Object.keys(value))
+            Object.defineProperty(output, key, {
+                value: clone(value[key], ancestors),
+                writable: true,
+                enumerable: true,
+                configurable: true,
+            });
+        ancestors.delete(value);
+        return output;
+    };
+    /**
+     * The violations of an operation's security requirements against the
+     * configured `swagger.security` schemes: a scheme it never declares, an
+     * OAuth2 scope no flow of the scheme declares, and, for an OpenAPI 3.0 or
+     * Swagger 2.0 document, scopes on a scheme other than OAuth2 or OpenID
+     * Connect, which those versions require to be empty. From 3.1 on, such a
+     * scheme's array lists the role names the operation requires. An OpenID
+     * Connect scheme lists no scopes of its own, so its scopes are not checked.
+     */
+    const validateSecurity = (props) => {
+        var _a;
+        var _b, _c, _d;
+        const violations = [];
+        const report = (message) => {
+            violations.push(`  - ${message} (${props.route.controller.class.name}.${props.route.key}() at "${props.route.method} ${props.route.path}")`);
+        };
+        for (const requirement of (_b = props.security) !== null && _b !== void 0 ? _b : [])
+            for (const [name, scopes] of Object.entries(requirement)) {
+                const scheme = (_a = props.config.security) === null || _a === void 0 ? void 0 : _a[name];
+                if (scheme === undefined)
+                    report(`target security scheme "${name}" does not exist.`);
+                else if (scopes.length === 0 || scheme.type === "openIdConnect")
+                    continue;
+                else if (scheme.type !== "oauth2") {
+                    const version = (_c = props.config.openapi) !== null && _c !== void 0 ? _c : "3.2";
+                    if (version === "3.0" || version === "2.0")
+                        report(`target security scheme "${name}" is neither "oauth2" nor "openIdConnect" type, but you've configured the scopes, which OpenAPI ${version} requires to be empty.`);
+                }
+                else {
+                    const declared = new Set(Object.values((_d = scheme.flows) !== null && _d !== void 0 ? _d : {}).flatMap((flow) => { var _a; return Object.keys((_a = flow === null || flow === void 0 ? void 0 : flow.scopes) !== null && _a !== void 0 ? _a : {}); }));
+                    for (const scope of scopes)
+                        if (declared.has(scope) === false)
+                            report(`target security scheme "${name}" does not have a specific scope "${scope}".`);
+                }
+            }
+        return violations;
     };
+    // each parameter where the router reads it; a replacement by text would
+    // turn `:identity` into `{id}entity` for a path also holding `:id`
+    const getPath = (route) => PathAnalyzer_1.PathAnalyzer.toOpenApi(route.path);
     const isSwaggerExcluded = (route) => {
         const controller = Reflect.getMetadata("swagger/apiExcludeController", route.controller.class);
         if (Array.isArray(controller) && controller[0] === true)

package/lib/generates/SwaggerGenerator.js.map

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

package/lib/generates/internal/E2eFileProgrammer.d.ts

@@ -1,6 +1,25 @@
 import { INestiaProject } from "../../structures/INestiaProject";
 import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
+/**
+ * Writes the e2e test file of one HTTP route.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace prints an exported function that calls the route's SDK function with random arguments and asserts its result.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated file uses the SDK the same way a user does.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The caller supplies native api/current locations; ImportDictionary converts relative imports to slash-separated language specifiers, and FilePrinter writes the computed test pathname through Node fs with UTF-8. No filename case policy is inferred.
+ */
 export declare namespace E2eFileProgrammer {
+    /**
+     * Writes the test file of a route, named after its accessor, with the imports
+     * it needs.
+     *
+     * @evidence contracts/common.md#principled-implementation The imports are collected while the function is built and printed before it.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The file name is derived from the route accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation The caller supplies native api/current locations; ImportDictionary converts relative imports to slash-separated language specifiers, and FilePrinter writes the computed test pathname through Node fs with UTF-8. No filename case policy is inferred.
+     */
     const generate: (project: INestiaProject) => (props: {
         api: string;
         current: string;

package/lib/generates/internal/E2eFileProgrammer.js

@@ -18,8 +18,27 @@ const ImportDictionary_1 = require("./ImportDictionary");
 const SdkAliasCollection_1 = require("./SdkAliasCollection");
 const SdkHttpParameterProgrammer_1 = require("./SdkHttpParameterProgrammer");
 const SdkImportWizard_1 = require("./SdkImportWizard");
+/**
+ * Writes the e2e test file of one HTTP route.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace prints an exported function that calls the route's SDK function with random arguments and asserts its result.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and private helpers.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The generated file uses the SDK the same way a user does.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation The caller supplies native api/current locations; ImportDictionary converts relative imports to slash-separated language specifiers, and FilePrinter writes the computed test pathname through Node fs with UTF-8. No filename case policy is inferred.
+ */
 var E2eFileProgrammer;
 (function (E2eFileProgrammer) {
+    /**
+     * Writes the test file of a route, named after its accessor, with the imports
+     * it needs.
+     *
+     * @evidence contracts/common.md#principled-implementation The imports are collected while the function is built and printed before it.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The file name is derived from the route accessor.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation The caller supplies native api/current locations; ImportDictionary converts relative imports to slash-separated language specifiers, and FilePrinter writes the computed test pathname through Node fs with UTF-8. No filename case policy is inferred.
+     */
     E2eFileProgrammer.generate = (project) => (props) => (route) => __awaiter(this, void 0, void 0, function* () {
         const importer = new ImportDictionary_1.ImportDictionary(`${props.current}/${getFunctionName(route)}.ts`);
         if (project.config.clone !== true)
@@ -73,7 +92,7 @@ var E2eFileProgrammer;
                     LiteralFactory_1.LiteralFactory.write(Object.fromEntries(entries.map((e) => [
                         e.key,
                         factory_1.factory.createCallExpression(IdentifierFactory_1.IdentifierFactory.access(factory_1.factory.createIdentifier(SdkImportWizard_1.SdkImportWizard.typia(importer)), "random"), [getRandomType(importer)(e)], undefined),
-                    ]))),
+                    ])), true),
                 ]
                 : entries.map((e) => factory_1.factory.createCallExpression(IdentifierFactory_1.IdentifierFactory.access(factory_1.factory.createIdentifier(SdkImportWizard_1.SdkImportWizard.typia(importer)), "random"), [getRandomType(importer)(e)], undefined))),
         ]);