@nestia/sdk 1.4.12 → 1.4.13-dev.20230726

package/lib/generates/SwaggerGenerator.js

@@ -29,6 +29,8 @@ var SwaggerGenerator;
     SwaggerGenerator.generate = (checker) => (config) => (routeList) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
         console.log("Generating Swagger Documents");
+        // VALIDATE SECURITY
+        validate_security(config)(routeList);
         // PREPARE ASSETS
         const parsed = path_1.default.parse(config.output);
         const directory = path_1.default.dirname(parsed.dir);
@@ -73,6 +75,44 @@ var SwaggerGenerator;
         // DO GENERATE
         yield fs_1.default.promises.writeFile(location, JSON.stringify(swagger, null, 2), "utf8");
     });
+    const validate_security = (config) => (routeList) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+        const securityMap = new Map();
+        for (const [key, value] of Object.entries((_a = config.security) !== null && _a !== void 0 ? _a : {}))
+            securityMap.set(key, {
+                scheme: emend_security(value),
+                scopes: value.type === "oauth2"
+                    ? new Set([
+                        ...Object.keys((_c = (_b = value.flows.authorizationCode) === null || _b === void 0 ? void 0 : _b.scopes) !== null && _c !== void 0 ? _c : {}),
+                        ...Object.keys((_e = (_d = value.flows.implicit) === null || _d === void 0 ? void 0 : _d.scopes) !== null && _e !== void 0 ? _e : {}),
+                        ...Object.keys((_g = (_f = value.flows.password) === null || _f === void 0 ? void 0 : _f.scopes) !== null && _g !== void 0 ? _g : {}),
+                        ...Object.keys((_j = (_h = value.flows.clientCredentials) === null || _h === void 0 ? void 0 : _h.scopes) !== null && _j !== void 0 ? _j : {}),
+                    ])
+                    : new Set(),
+            });
+        const validate = (reporter) => (key, scopes) => {
+            const security = securityMap.get(key);
+            if (security === undefined)
+                return reporter(`target security "${key}" does not exists.`);
+            else if (scopes.length === 0)
+                return;
+            else if (security.scheme.type !== "oauth2")
+                return reporter(`target security "${key}" is not "oauth2" type, but you've configured the scopes.`);
+            for (const s of scopes)
+                if (security.scopes.has(s) === false)
+                    reporter(`target security ${key} does not have scope "${s}".`);
+        };
+        const violations = [];
+        for (const route of routeList)
+            for (const record of route.security)
+                for (const [key, scopes] of Object.entries(record))
+                    validate((str) => violations.push(`  - ${str} (${route.symbol} at "${route.location}")`))(key, scopes);
+        if (violations.length)
+            throw new Error(`Error on NestiaApplication.swagger(): invalid security configuration.\n` +
+                `\n` +
+                `List of violations:\n` +
+                violations.join("\n"));
+    };
     /* ---------------------------------------------------------
         INITIALIZERS
     --------------------------------------------------------- */
@@ -186,6 +226,7 @@ var SwaggerGenerator;
             responses: generate_response_body(checker, collection, tupleList, route),
             summary,
             description,
+            security: route.security.length ? route.security : undefined,
             "x-nestia-namespace": [
                 ...route.path
                     .split("/")
@@ -193,6 +234,7 @@ var SwaggerGenerator;
                 route.name,
             ].join("."),
             "x-nestia-jsDocTags": route.tags,
+            "x-nestia-method": route.method,
         };
     }
     function fill_security(security, swagger) {

package/lib/generates/SwaggerGenerator.js.map

@@ -1 +1 @@
-{"version":3,"file":"SwaggerGenerator.js","sourceRoot":"","sources":["../../src/generates/SwaggerGenerator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,4CAAoB;AACpB,gDAA4B;AAC5B,qDAAkD;AAClD,qEAAkE;AAClE,4DAA4B;AAE5B,kDAA0B;AAE1B,+EAA4E;AAC5E,yEAAsE;AAEtE,uFAAoF;AAKpF,0DAAuD;AACvD,8CAA2C;AAE3C,IAAiB,gBAAgB,CA8chC;AA9cD,WAAiB,gBAAgB;IAChB,yBAAQ,GACjB,CAAC,OAAuB,EAAE,EAAE,CAC5B,CAAC,MAAoC,EAAE,EAAE,CACzC,CAAO,SAAmB,EAAiB,EAAE;;QACzC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;QAE5C,iBAAiB;QACjB,MAAM,MAAM,GAAwB,cAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClE,MAAM,SAAS,GAAW,cAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,KAAK;YAClC,IAAI;gBACA,MAAM,YAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;aACtC;YAAC,WAAM,GAAE;QACd,IAAI,YAAE,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,KAAK;YAClC,MAAM,IAAI,KAAK,CACX,4EAA4E,SAAS,EAAE,CAC1F,CAAC;QAEN,MAAM,QAAQ,GAAW,CAAC,CAAC,MAAM,CAAC,GAAG;YACjC,CAAC,CAAC,cAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YACjC,CAAC,CAAC,cAAQ,CAAC,IAAI,CACT,cAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAC/B,cAAc,CACjB,CAAC;QAER,MAAM,UAAU,GAAuB,IAAI,uCAAkB,CAAC;YAC1D,OAAO,EAAE,uCAAkB,CAAC,OAAO;SACtC,CAAC,CAAC;QAEH,8BAA8B;QAC9B,MAAM,SAAS,GAAwB,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAqB,MAAM,UAAU,CAAC,MAAM,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAwC,IAAI,GAAG,EAAE,CAAC;QAEhE,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE;YAC3B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC;gBAAE,SAAS;YAEhE,MAAM,IAAI,GAA2B,iBAAO,CAAC,IAAI,CAC7C,QAAQ,EACR,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,EACtC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CACb,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,GAAG,cAAc,CAC7C,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,CACR,CAAC;SACL;QACD,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC;QACnB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,QAAQ,EAAE;YACnC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;SAChC;QAED,oBAAoB;QACpB,MAAM,WAAW,GAAqB,6CAAqB,CAAC,KAAK,CAAC;YAC9D,OAAO,EAAE,SAAS;SACrB,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,OAAO,CAAC,UAAU,mCACX,CAAC,MAAA,OAAO,CAAC,UAAU,mCAAI,EAAE,CAAC,GAC1B,CAAC,MAAA,WAAW,CAAC,UAAU,mCAAI,EAAE,CAAC,CACpC,CAAC;QACF,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE;YACpC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAE,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,qBAAqB;QACrB,IAAI,MAAM,CAAC,QAAQ;YAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAE7D,cAAc;QACd,MAAM,YAAE,CAAC,QAAQ,CAAC,SAAS,CACvB,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAChC,MAAM,CACT,CAAC;IACN,CAAC,CAAA,CAAC;IAEN;;gEAE4D;IAC5D,MAAM,UAAU,GAAG,CACf,MAAoC,EACX,EAAE;;QAC3B,MAAM,IAAI,GAAG,IAAI,qBAAS,CACtB,GAA0D,EAAE;YACxD,MAAM,QAAQ,GAAkB,MAAM,6BAAa,CAAC,IAAI,CACpD,cAAc,CACjB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACjB,IAAI,QAAQ,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YAEnC,IAAI;gBACA,MAAM,OAAO,GAAW,MAAM,YAAE,CAAC,QAAQ,CAAC,QAAQ,CAC9C,QAAQ,EACR,MAAM,CACT,CAAC;gBACF,MAAM,IAAI;;;;;;;2CAAG,eAAK,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;uEAI3B,OAAO,CAAC,CAAC;gBACZ,OAAO;oBACH,KAAK,EAAE,IAAI,CAAC,IAAI;oBAChB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,WAAW,EAAE,IAAI,CAAC,WAAW;iBAChC,CAAC;aACL;YAAC,WAAM;gBACJ,OAAO,IAAI,CAAC;aACf;QACL,CAAC,CAAA,CACJ,CAAC;QAEF,OAAO;YACH,OAAO,EAAE,OAAO;YAChB,OAAO,EAAE,MAAA,MAAM,CAAC,OAAO,mCAAI;gBACvB;oBACI,GAAG,EAAE,mCAAmC;oBACxC,WAAW,EAAE,wBAAwB;iBACxC;aACJ;YACD,IAAI,EAAE;gBACF,OAAO,EACH,MAAA,MAAA,MAAA,MAAM,CAAC,IAAI,0CAAE,OAAO,mCACpB,MAAA,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,0CAAE,OAAO,mCAC3B,OAAO;gBACX,KAAK,EACD,MAAA,MAAA,MAAA,MAAM,CAAC,IAAI,0CAAE,KAAK,mCAClB,MAAA,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,0CAAE,KAAK,mCACzB,mBAAmB;gBACvB,WAAW,EACP,MAAA,MAAA,MAAA,MAAM,CAAC,IAAI,0CAAE,WAAW,mCACxB,MAAA,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,0CAAE,WAAW,mCAC/B,yDAAyD;aAChE;YACD,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE;SACjB,CAAC;IACN,CAAC,CAAA,CAAC;IAEF,SAAS,QAAQ,CAAC,IAAY,EAAE,UAA+B;QAC3D,MAAM,QAAQ,GAAwB,UAAU,CAAC,MAAM,CACnD,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CACzD,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,QAAQ;YACxB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,SAAS,cAAc,CACnB,OAAuB,EACvB,UAA8B,EAC9B,SAA8B,EAC9B,KAAa;;QAEb,MAAM,SAAS,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CACnC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CACvC,CAAC;QAEF,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CACjC,KAAK,CAAC,IAAI;aACL,MAAM,CACH,CAAC,GAAG,EAAE,EAAE,CACJ,GAAG,CAAC,IAAI,KAAK,IAAI;YACjB,GAAG,CAAC,IAAI;YACR,GAAG,CAAC,IAAI,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CACrD,KAAK,SAAS,CACtB;aACA,GAAG,CACA,CAAC,GAAG,EAAE,EAAE,CACJ,GAAG,CAAC,IAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAE,CAAC,IAAI,CAC3D,CAAC;QAEV,MAAM,WAAW,GAAuB,CAAA,MAAA,KAAK,CAAC,WAAW,0CAAE,MAAM;YAC7D,CAAC,CAAC,KAAK,CAAC,WAAW;YACnB,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,OAAO,GAAuB,CAAC,GAAG,EAAE;YACtC,IAAI,WAAW,KAAK,SAAS;gBAAE,OAAO,SAAS,CAAC;YAEhD,MAAM,CAAC,QAAQ,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,MAAM;gBAAE,OAAO,QAAQ,CAAC;YAEtC,MAAM,KAAK,GAAW,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/C,IAAI,KAAK,IAAI,CAAC;gBAAE,OAAO,SAAS,CAAC;YAEjC,MAAM,OAAO,GAAW,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/D,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAChD,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC;QAEvE,OAAO;YACH,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YACzC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;iBACvB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC;iBAC5C,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACX,kBAAkB,CACd,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,EACL,KAAK,CACR,CACJ;YACL,WAAW,EAAE,SAAS;gBAClB,CAAC,CAAC,qBAAqB,CACjB,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,EACL,SAAS,CACZ;gBACH,CAAC,CAAC,SAAS;YACf,SAAS,EAAE,sBAAsB,CAC7B,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,CACR;YACD,OAAO;YACP,WAAW;YACX,oBAAoB,EAAE;gBAClB,GAAG,KAAK,CAAC,IAAI;qBACR,KAAK,CAAC,GAAG,CAAC;qBACV,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;gBAClD,KAAK,CAAC,IAAI;aACb,CAAC,IAAI,CAAC,GAAG,CAAC;YACX,oBAAoB,EAAE,KAAK,CAAC,IAAI;SACnC,CAAC;IACN,CAAC;IAED,SAAS,aAAa,CAClB,QAA4D,EAC5D,OAAyB;QAEzB,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAC;QACxB,OAAO,CAAC,UAAU,CAAC,eAAe,GAAG,EAAE,CAAC;QAExC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE;YACjD,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YAC/B,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;SACnE;IACL,CAAC;IAED,SAAS,cAAc,CACnB,KAAmD;;QAEnD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YACvB,uCACO,KAAK,KACR,EAAE,EAAE,MAAA,KAAK,CAAC,EAAE,mCAAI,QAAQ,EACxB,IAAI,EAAE,MAAA,KAAK,CAAC,IAAI,mCAAI,eAAe,IACrC;QACN,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;gEAE4D;IAC5D,SAAS,kBAAkB,CACvB,OAAuB,EACvB,UAA8B,EAC9B,SAA8B,EAC9B,KAAa,EACb,SAA4B;;QAE5B,MAAM,MAAM,GAAuB,eAAe,CAC9C,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,CAAC,IAAI,CAAC,IAAI,CACtB,CAAC;QACF,IAAI,MAAM,KAAK,IAAI;YACf,MAAM,IAAI,KAAK,CACX,mEAAmE,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC,IAAI,EAAE,CACtG,CAAC;aACD,IACD,SAAS,CAAC,MAAM;YAChB,SAAS,CAAC,QAAQ,KAAK,OAAO;YAC9B,CAAC,CAAC,SAAS,CAAC,IAAI;YAChB,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;gBAC3B,SAAS,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;YACnC,MAAM,KAAK,IAAI,EACjB;YACE,MAAM,MAAM,GAAwB,MAA6B,CAAC;YAClE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SACvC;QAED,OAAO;YACH,IAAI,EAAE,MAAA,SAAS,CAAC,KAAK,mCAAI,SAAS,CAAC,IAAI;YACvC,EAAE,EAAE,SAAS,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ;YAChE,WAAW,EACP,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC;gBAC1D,EAAE;YACN,MAAM;YACN,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SAC1C,CAAC;IACN,CAAC;IAED,SAAS,qBAAqB,CAC1B,OAAuB,EACvB,UAA8B,EAC9B,SAA8B,EAC9B,KAAa,EACb,SAA4B;;QAE5B,MAAM,MAAM,GAAuB,eAAe,CAC9C,OAAO,EACP,UAAU,EACV,SAAS,EACT,SAAS,CAAC,IAAI,CAAC,IAAI,CACtB,CAAC;QACF,IAAI,MAAM,KAAK,IAAI;YACf,MAAM,IAAI,KAAK,CACX,kEAAkE,KAAK,CAAC,MAAM,GAAG,CACpF,CAAC;aACD,IAAI,SAAS,CAAC,QAAQ,KAAK,MAAM;YAClC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM;YAChC,CAAC,CAAC,SAAS,CAAC,WAAW;YACvB,CAAC,CAAC,kBAAkB,CAAC;QAEzB,OAAO;YACH,WAAW,EACP,OAAO;iBACF,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,SAAS,CAAC;iBAC5C,GAAG,CAAC,SAAS,CAAC;gBACnB,CAAC,MAAA,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,mCACvD,EAAE,CAAC;YACX,OAAO,EAAE;gBACL,CAAC,WAAW,CAAC,EAAE;oBACX,MAAM;iBACT;aACJ;YACD,QAAQ,EAAE,IAAI;YACd,oBAAoB,EAAE,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,SAAS;SAChE,CAAC;IACN,CAAC;IAED,SAAS,sBAAsB,CAC3B,OAAuB,EACvB,UAA8B,EAC9B,SAA8B,EAC9B,KAAa;;QAEb,6BAA6B;QAC7B,MAAM,MAAM,GACR,KAAK,CAAC,MAAM,KAAK,SAAS;YACtB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;YACtB,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ;gBACrD,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,KAAK,CAAC;QAChB,MAAM,MAAM,GAAuB,eAAe,CAC9C,OAAO,EACP,UAAU,EACV,SAAS,EACT,KAAK,CAAC,MAAM,CAAC,IAAI,CACpB,CAAC;QACF,MAAM,OAAO,GAAmC;YAC5C,CAAC,MAAM,CAAC,EAAE;gBACN,WAAW,EACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC;oBAC1D,CAAC,MAAA,MAAA,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,mCACxC,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,mCAC5C,EAAE,CAAC;gBACX,OAAO,EACH,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;oBAC3C,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC;wBACI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE;4BACxB,MAAM;yBACT;qBACJ;gBACX,oBAAoB,EAAE,KAAK,CAAC,SAAS;aACxC;SACJ,CAAC;QAEF,qBAAqB;QACrB,MAAM,UAAU,GAAmC,MAAM,CAAC,WAAW,CACjE,KAAK,CAAC,IAAI;aACL,MAAM,CACH,CAAC,GAAG,EAAE,EAAE,CACJ,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,CAAC;YAC/C,GAAG,CAAC,IAAI;YACR,GAAG,CAAC,IAAI,CAAC,IAAI,CACT,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,CAAC,IAAI,KAAK,MAAM;gBACpB,KAAK,CACD,MAAM,CACF,IAAI,CAAC,IAAI;qBACJ,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CACnC,CACJ,KAAK,KAAK,CAClB,KAAK,SAAS,CACtB;aACA,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACT,MAAM,IAAI,GAAW,GAAG,CAAC,IAAK,CAAC,IAAI,CAC/B,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAChC,CAAC,IAAI,CAAC;YACR,MAAM,QAAQ,GAAa,IAAI;iBAC1B,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAE9B,OAAO;gBACH,QAAQ,CAAC,CAAC,CAAC;gBACX;oBACI,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;iBAC3C;aACJ,CAAC;QACN,CAAC,CAAC,CACT,CAAC;QACF,uCAAY,UAAU,GAAK,OAAO,EAAG;IACzC,CAAC;IAED;;gEAE4D;IAC5D,SAAS,eAAe,CACpB,OAAuB,EACvB,UAA8B,EAC9B,SAA8B,EAC9B,IAAa;QAEb,MAAM,QAAQ,GAAa,iCAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YACxD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;gBACf,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,QAAQ,CAAC;oBAC5C,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;SACJ,CAAC,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,QAAQ,CAAC,KAAK,EAAE,IAAI,QAAQ,CAAC,QAAQ,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;QAEjE,MAAM,MAAM,GAAgB,EAAiB,CAAC;QAC9C,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACrC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,SAAS,0BAA0B,CAC/B,KAAa,EACb,OAAe,EACf,aAAsB;;QAEtB,MAAM,UAAU,GAAuC,aAAa;YAChE,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CACJ,GAAG,CAAC,IAAK,CAAC,IAAI,CACV,CAAC,IAAI,EAAE,EAAE,CACL,IAAI,CAAC,IAAI,KAAK,eAAe;gBAC7B,IAAI,CAAC,IAAI,KAAK,aAAa,CAClC,KAAK,SAAS;YACrB,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;QAEjB,MAAM,GAAG,GAAgC,KAAK,CAAC,IAAI,CAAC,IAAI,CACpD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,IAAI,UAAU,CAAC,GAAG,CAAC,CAC/D,CAAC;QACF,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI;YAClB,CAAC,CAAC,MAAA,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,0CAAE,IAAI;YACrD,CAAC,CAAC,SAAS,CAAC;IACpB,CAAC;AACL,CAAC,EA9cgB,gBAAgB,gCAAhB,gBAAgB,QA8chC;AAED,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAW,EAAE;IACxC,IAAI,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,CAAC,KAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1E,OAAO,CACH,QAAQ,CAAC,oBAAE,CAAC,SAAS,CAAC,SAAS,CAAC;QAChC,QAAQ,CAAC,oBAAE,CAAC,SAAS,CAAC,KAAK,CAAC;QAC5B,QAAQ,CAAC,oBAAE,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3B,QAAQ,CAAC,oBAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAClC,CAAC;AACN,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,IAAI,qCAAiB,CAAC,CAAC,SAAkB,EAAE,EAAE;IACzD,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,IAAI,qBAAS,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAExD,OAAO,IAAI,qCAAiB,CACxB,CAAC,IAA4B,EAAE,MAAe,EAAE,EAAE;QAC9C,MAAM,OAAO,GACT,IAAI,KAAK,SAAS;YACd,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,oCAAoC,CAAC;QAE/C,MAAM,SAAS,GACX,IAAI,KAAK,SAAS;YACd,CAAC,CAAC,wEAAwE;YAC1E,CAAC,CAAC,mBAAmB,MAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,MAAO;iBACjD,SAAS,CAAC,CAAC,CAAC;iBACZ,WAAW,EAAE,2DAA2D,CAAC;QAExF,OAAO;EACjB,OAAO;;MAEH,IAAI,8GAA8G,SAAS;;;;;;CAMhI,CAAC;IACM,CAAC,CACJ,CAAC;AACN,CAAC,CAAC,CAAC;AAOH,MAAM,QAAQ,GAAG,2DAA2D,CAAC"}
+{"version":3,"file":"SwaggerGenerator.js","sourceRoot":"","sources":["../../src/generates/SwaggerGenerator.ts"],"names":[],"mappings":"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"}

package/lib/structures/IController.d.ts

@@ -4,6 +4,7 @@ export interface IController {
     name: string;
     paths: string[];
     functions: IController.IFunction[];
+    security: Record<string, string[]>[];
 }
 export declare namespace IController {
     interface IFunction {
@@ -15,6 +16,7 @@ export declare namespace IController {
         status?: number;
         type?: string;
         contentType: "application/json" | "text/plain";
+        security: Record<string, string[]>[];
     }
     type IParameter = ICommonParameter | IQueryParameter | IBodyParameter | IPathParameter;
     interface ICommonParameter {

package/lib/structures/IRoute.d.ts

@@ -23,6 +23,7 @@ export interface IRoute {
         type: "assigner";
         source: string;
     }>;
+    security: Record<string, string[]>[];
 }
 export declare namespace IRoute {
     type IParameter = IController.IParameter & {

package/lib/structures/ISwaggerComponents.d.ts

@@ -0,0 +1,26 @@
+import { IJsonComponents } from "typia";
+import { ISwaggerSecurityScheme } from "./ISwaggerSecurityScheme";
+/**
+ * Reusable components in Swagger.
+ *
+ * `ISwaggerComponents` is a data structure representing content of `components` object
+ * in `swagger.json` file generated by Nestia. Note that, this is not an universal
+ * structure, but a dedicated structure only for Nestia.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export interface ISwaggerComponents {
+    /**
+     * An object to hold reusable DTO schemas.
+     *
+     * For reference, `nestia` stores every object and alias types as reusable DTO
+     * schemas. The alias type means that defined by `type` keyword in TypeScript.
+     */
+    schemas?: Record<string, IJsonComponents.IObject | IJsonComponents.IAlias>;
+    /**
+     * An object to hold reusable security schemes.
+     *
+     * This property be configured by user in `nestia.config.ts` file.
+     */
+    securitySchemes?: Record<string, ISwaggerSecurityScheme>;
+}

package/lib/structures/ISwaggerComponents.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISwaggerComponents.js.map

package/lib/structures/ISwaggerComponents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISwaggerComponents.js","sourceRoot":"","sources":["../../src/structures/ISwaggerComponents.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerDocument.d.ts

@@ -1,102 +1,86 @@
-import { IJsonComponents, IJsonSchema } from "typia";
-import { IJsDocTagInfo } from "typia/lib/metadata/IJsDocTagInfo";
+import { ISwaggerComponents } from "./ISwaggerComponents";
+import { ISwaggerRoute } from "./ISwaggerRoute";
+/**
+ * Swagger Document.
+ *
+ * `ISwaggerDocument` is a data structure representing content of `swagger.json` file
+ * generated by Nestia. Note that, this is not an universal structure, but a dedicated
+ * structure only for Nestia.
+ *
+ * @author Jeongho Nam - https://github.com/samchon
+ */
 export interface ISwaggerDocument {
-    openapi: "3.0.1";
+    /**
+     * The version of the OpenAPI document.
+     *
+     * Nestia always generate OpenAPI 3.0.x document.
+     */
+    openapi: `3.0.${number}`;
+    /**
+     * List of servers that provide the API.
+     */
     servers: ISwaggerDocument.IServer[];
+    /**
+     * Information about the API.
+     */
     info: ISwaggerDocument.IInfo;
-    components: ISwaggerDocument.IComponents;
+    /**
+     * The available paths and operations for the API.
+     *
+     * The 1st key is the path, and the 2nd key is the HTTP method.
+     */
+    paths: Record<string, Record<string, ISwaggerRoute>>;
+    /**
+     * An object to hold reusable data structures.
+     *
+     * It stores both DTO schemas and security schemes.
+     *
+     * For reference, `nestia` defines every object and alias types as reusable DTO
+     * schemas. The alias type means that defined by `type` keyword in TypeScript.
+     */
+    components: ISwaggerComponents;
+    /**
+     * A declaration of which security mechanisms can be used across the API.
+     *
+     * When this property be configured, it would be overwritten in every API routes.
+     *
+     * For reference, key means the name of security scheme and value means the `scopes`.
+     * The `scopes` can be used only when target security scheme is `oauth2` type,
+     * especially for {@link ISwaggerSecurityScheme.IOAuth2.IFlow.scopes} property.
+     */
     security?: Record<string, string[]>[];
-    paths: Record<string, ISwaggerDocument.IPath>;
 }
 export declare namespace ISwaggerDocument {
+    /**
+     * Remote server definition.
+     */
     interface IServer {
+        /**
+         * A URL to the target host.
+         *
+         * @format url
+         */
         url: string;
+        /**
+         * An optional string describing the target server.
+         */
         description?: string;
     }
+    /**
+     * General information about the API.
+     */
     interface IInfo {
+        /**
+         * Version of the API.
+         */
         version: string;
+        /**
+         * The title of the API.
+         */
         title: string;
+        /**
+         * A short description of the API.
+         */
         description?: string;
     }
-    interface IComponents extends IJsonComponents {
-        securitySchemes?: Record<string, ISecurityScheme>;
-    }
-    type ISecurityScheme = ISecurityScheme.IHttpBasic | ISecurityScheme.IHttpBearer | ISecurityScheme.IApiKey | ISecurityScheme.IOpenId | ISecurityScheme.IOAuth2;
-    namespace ISecurityScheme {
-        interface IHttpBasic {
-            type: "http";
-            schema: "basic";
-        }
-        interface IHttpBearer {
-            type: "http";
-            scheme: "bearer";
-            bearerFormat?: string;
-        }
-        interface IApiKey {
-            type: "apiKey";
-            in: "header" | "query" | "cookie";
-            name: string;
-        }
-        interface IOpenId {
-            type: "openIdConnect";
-            openIdConnectUrl: string;
-        }
-        interface IOAuth2 {
-            type: "oauth2";
-            flows: IOAuth2.IFlowSet;
-            description?: string;
-        }
-        namespace IOAuth2 {
-            interface IFlowSet {
-                authorizationCode?: IFlow;
-                implicit?: Omit<IFlow, "tokenUrl">;
-                password?: Omit<IFlow, "authorizationUrl">;
-                clientCredentials?: Omit<IFlow, "authorizationUrl">;
-            }
-            interface IFlow {
-                authorizationUrl: string;
-                tokenUrl: string;
-                refreshUrl: string;
-                scopes?: Record<string, string>;
-            }
-        }
-    }
-    type IPath = Record<string, IRoute>;
-    interface IRoute {
-        deprecated?: boolean;
-        tags: string[];
-        parameters: IParameter[];
-        requestBody?: IRequestBody;
-        responses: IResponseBody;
-        summary?: string;
-        description?: string;
-        "x-nestia-namespace": string;
-        "x-nestia-jsDocTags": IJsDocTagInfo[];
-    }
-    interface IParameter {
-        name: string;
-        in: string;
-        schema: IJsonSchema;
-        required: boolean;
-        description: string;
-    }
-    interface IRequestBody {
-        description: string;
-        content: IJsonContent;
-        required: true;
-        "x-nestia-encrypted": boolean;
-    }
-    type IResponseBody = Record<string, {
-        description: string;
-        content?: IJsonContent;
-        "x-nestia-encrypted"?: boolean;
-    }>;
-    interface IJsonContent {
-        "application/json"?: {
-            schema: IJsonSchema;
-        };
-        "text/plain"?: {
-            schema: IJsonSchema;
-        };
-    }
 }

package/lib/structures/ISwaggerRoute.d.ts

@@ -0,0 +1,43 @@
+import { IJsonSchema } from "typia";
+import { IJsDocTagInfo } from "typia/lib/metadata/IJsDocTagInfo";
+export interface ISwaggerRoute {
+    deprecated?: boolean;
+    security?: Record<string, string[]>[];
+    tags: string[];
+    parameters: ISwaggerRoute.IParameter[];
+    requestBody?: ISwaggerRoute.IRequestBody;
+    responses: ISwaggerRoute.IResponseBody;
+    summary?: string;
+    description?: string;
+    "x-nestia-method": string;
+    "x-nestia-namespace": string;
+    "x-nestia-jsDocTags": IJsDocTagInfo[];
+}
+export declare namespace ISwaggerRoute {
+    interface IParameter {
+        name: string;
+        in: string;
+        schema: IJsonSchema;
+        required: boolean;
+        description: string;
+    }
+    interface IRequestBody {
+        description: string;
+        content: IContent;
+        required: true;
+        "x-nestia-encrypted": boolean;
+    }
+    type IResponseBody = Record<string, {
+        description: string;
+        content?: IContent;
+        "x-nestia-encrypted"?: boolean;
+    }>;
+    interface IContent {
+        "application/json"?: {
+            schema: IJsonSchema;
+        };
+        "text/plain"?: {
+            schema: IJsonSchema;
+        };
+    }
+}

package/lib/structures/ISwaggerRoute.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISwaggerRoute.js.map

package/lib/structures/ISwaggerRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISwaggerRoute.js","sourceRoot":"","sources":["../../src/structures/ISwaggerRoute.ts"],"names":[],"mappings":""}

package/lib/structures/ISwaggerSecurityScheme.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Security schema of Swagger Documents.
+ *
+ * `ISwaggerSecurityScheme` is a data structure representing content of
+ * `securitySchemes` in `swagger.json` file. It is composed with 5 types of security
+ * schemes as an union type like below.
+ *
+ * @reference https://swagger.io/specification/#security-scheme-object
+ * @author Jeongho Nam - https://github.com/samchon
+ */
+export type ISwaggerSecurityScheme = ISwaggerSecurityScheme.IHttpBasic | ISwaggerSecurityScheme.IHttpBearer | ISwaggerSecurityScheme.IApiKey | ISwaggerSecurityScheme.IOpenId | ISwaggerSecurityScheme.IOAuth2;
+export declare namespace ISwaggerSecurityScheme {
+    interface IHttpBasic {
+        type: "http";
+        schema: "basic";
+    }
+    interface IHttpBearer {
+        type: "http";
+        scheme: "bearer";
+        bearerFormat?: string;
+    }
+    interface IApiKey {
+        type: "apiKey";
+        in?: "header" | "query" | "cookie";
+        name?: string;
+    }
+    interface IOpenId {
+        type: "openIdConnect";
+        openIdConnectUrl: string;
+    }
+    interface IOAuth2 {
+        type: "oauth2";
+        flows: IOAuth2.IFlowSet;
+        description?: string;
+    }
+    namespace IOAuth2 {
+        interface IFlowSet {
+            authorizationCode?: IFlow;
+            implicit?: Omit<IFlow, "tokenUrl">;
+            password?: Omit<IFlow, "authorizationUrl">;
+            clientCredentials?: Omit<IFlow, "authorizationUrl">;
+        }
+        interface IFlow {
+            authorizationUrl: string;
+            tokenUrl: string;
+            refreshUrl: string;
+            scopes?: Record<string, string>;
+        }
+    }
+}

package/lib/structures/ISwaggerSecurityScheme.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ISwaggerSecurityScheme.js.map

package/lib/structures/ISwaggerSecurityScheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISwaggerSecurityScheme.js","sourceRoot":"","sources":["../../src/structures/ISwaggerSecurityScheme.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/sdk",
-  "version": "1.4.12",
+  "version": "1.4.13-dev.20230726",
   "description": "Nestia SDK and Swagger generator",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -35,15 +35,16 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@nestia/fetcher": "^1.4.0",
+    "@nestia/fetcher": ">= 1.4.0",
     "cli": "^1.0.1",
     "glob": "^7.2.0",
     "path-to-regexp": "^6.2.1",
+    "reflect-metadata": ">= 0.1.12",
     "tgrid": "^0.8.7",
     "tsconfck": "^2.0.1",
     "tsconfig-paths": "^4.1.1",
     "tstl": "^2.5.13",
-    "typia": "^4.1.6"
+    "typia": "^4.1.7"
   },
   "peerDependencies": {
     "@nestia/fetcher": ">= 1.4.0",

package/src/INestiaConfig.ts

@@ -1,6 +1,7 @@
 import type ts from "typescript";
 
 import type { ISwaggerDocument } from "./structures/ISwaggerDocument";
+import { ISwaggerSecurityScheme } from "./structures/ISwaggerSecurityScheme";
 import type { StripEnums } from "./utils/StripEnums";
 
 /**
@@ -178,28 +179,11 @@ export namespace INestiaConfig {
 
         /**
          * Security schemes.
+         *
+         * When generating `swagger.json` file through `nestia`, if your controllers or
+         * theirs methods have a security key which is not enrolled in here property,
+         * it would be an error.
          */
-        security?: Record<string, ISwaggerConfig.ISecurityScheme>;
-    }
-    export namespace ISwaggerConfig {
-        export type ISecurityScheme =
-            | IApiKey
-            | Exclude<
-                  ISwaggerDocument.ISecurityScheme,
-                  ISwaggerDocument.ISecurityScheme.IApiKey
-              >;
-        export interface IApiKey {
-            type: "apiKey";
-
-            /**
-             * @default header
-             */
-            in?: "header" | "query" | "cookie";
-
-            /**
-             * @default Authorization
-             */
-            name?: string;
-        }
+        security?: Record<string, ISwaggerSecurityScheme>;
     }
 }

package/src/analyses/ControllerAnalyzer.ts

@@ -10,6 +10,7 @@ import { PathUtil } from "../utils/PathUtil";
 import { GenericAnalyzer } from "./GenericAnalyzer";
 import { ImportAnalyzer } from "./ImportAnalyzer";
 import { PathAnalyzer } from "./PathAnalyzer";
+import { SecurityAnalyzer } from "./SecurityAnalyzer";
 
 export namespace ControllerAnalyzer {
     export function analyze(
@@ -134,8 +135,29 @@ export namespace ControllerAnalyzer {
             .toJSON()
             .map((pair) => [pair.first, pair.second.toJSON()]);
 
-        // CONSTRUCT COMMON DATA
+        // PARSE COMMENT TAGS
         const tags = signature.getJsDocTags();
+        const security: Record<string, string[]>[] = SecurityAnalyzer.merge(
+            ...controller.security,
+            ...func.security,
+            ...tags
+                .filter((tag) => tag.name === "security")
+                .map((tag) =>
+                    (tag.text ?? []).map((text) => {
+                        const line: string[] = text.text
+                            .split(" ")
+                            .filter((s) => s.trim())
+                            .filter((s) => !!s.length);
+                        if (line.length === 0) return {};
+                        return {
+                            [line[0]]: line.slice(1),
+                        };
+                    }),
+                )
+                .flat(),
+        );
+
+        // CONSTRUCT COMMON DATA
         const common: Omit<IRoute, "path" | "accessors"> = {
             ...func,
             parameters,
@@ -168,6 +190,7 @@ export namespace ControllerAnalyzer {
                               source: t.text![0].text,
                           },
                 ),
+            security,
         };
 
         // CONFIGURE PATHS

package/src/analyses/ReflectAnalyzer.ts

@@ -1,12 +1,12 @@
 import * as Constants from "@nestjs/common/constants";
+import "reflect-metadata";
 import { equal } from "tstl/ranges/module";
 
 import { IController } from "../structures/IController";
 import { ParamCategory } from "../structures/ParamCategory";
 import { ArrayUtil } from "../utils/ArrayUtil";
 import { PathAnalyzer } from "./PathAnalyzer";
-
-declare const Reflect: any;
+import { SecurityAnalyzer } from "./SecurityAnalyzer";
 
 type IModule = {
     [key: string]: any;
@@ -89,6 +89,7 @@ export namespace ReflectAnalyzer {
             name,
             paths,
             functions: [],
+            security: _Get_security(creator),
         };
 
         // PARSE CHILDREN DATA
@@ -125,6 +126,12 @@ export namespace ReflectAnalyzer {
         else return value;
     }
 
+    function _Get_security(value: any): Record<string, string[]>[] {
+        const entire: Record<string, string[]>[] | undefined =
+            Reflect.getMetadata("swagger/apiSecurity", value);
+        return entire ? SecurityAnalyzer.merge(...entire) : [];
+    }
+
     /* ---------------------------------------------------------
         FUNCTION
     --------------------------------------------------------- */
@@ -173,6 +180,7 @@ export namespace ReflectAnalyzer {
                         typeof h?.value === "string" &&
                         h.name.toLowerCase() === "content-type",
                 )?.value ?? "application/json",
+            security: _Get_security(proto),
         };
 
         // PARSE CHILDREN DATA

package/src/analyses/SecurityAnalyzer.ts

@@ -0,0 +1,20 @@
+import { MapUtil } from "../utils/MapUtil";
+
+export namespace SecurityAnalyzer {
+    export const merge = (...entire: Record<string, string[]>[]) => {
+        const dict: Map<string, Set<string>> = new Map();
+        for (const obj of entire)
+            for (const [key, value] of Object.entries(obj)) {
+                const set = MapUtil.take(dict, key, () => new Set());
+                for (const val of value) set.add(val);
+            }
+        const output: Record<string, string[]>[] = [];
+        for (const [key, set] of dict) {
+            const obj = {
+                [key]: [...set],
+            };
+            output.push(obj);
+        }
+        return output;
+    };
+}