@sleeksky/alt-swagger 2.3.1 → 2.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sleeksky/alt-swagger",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Quickly spec your APIs for Swagger / OpenAPI interface",
   "main": "./src/index.js",
   "scripts": {

package/src/index.js

@@ -22,11 +22,14 @@ function server(url, description) {
 }
 
 function api(opt) {
-  const spec = { parameters: [], responses: {}, description: "" };
-  const pathParams = pathParameters(opt.path);
-  if (pathParams.length > 0) spec.parameters = pathParams;
-
-  _.set(paths, `${pathClean(opt.path)}.${opt.method}`, spec);
+  let path = `${pathClean(opt.path)}.${opt.method}`;
+  let spec = _.get(paths, path, false);
+  if (!spec) {
+    spec = { parameters: [], responses: {}, description: "" };
+    const pathParams = pathParameters(opt.path);
+    if (pathParams.length > 0) spec.parameters = pathParams;
+    _.set(paths, path, spec);
+  }
 
   let ext = {};
 
@@ -62,10 +65,11 @@ function api(opt) {
   const tag = (str) => { spec.tags = [str]; return ext; };
   const summary = (str) => { spec.summary = str; return ext; };
   const desc = (str) => { spec.description = str; return ext; };
+  const security = (str) => { spec.security = [ { [str]: []}]; return ext; }
   const deprecate = () => { spec.deprecated = true; return ext; };
   const remove = () => { _.unset(paths, `${pathClean(opt.path)}.${opt.method}`); };
 
-  Object.assign(ext, { req, res, query, header, tag, summary, desc, deprecate, remove });
+  Object.assign(ext, { req, res, query, header, tag, summary, desc, deprecate, remove, security });
 
   // support all ext in parameters
   Object.keys(ext).forEach(k => {
@@ -106,6 +110,12 @@ function del(path = "", opt = {}) {
   return api(opt);
 }
 
+function security(name, {type = "http", schema = "bearer", bearerFormat = null, required = true}) {
+  components.securitySchemes = components.securitySchemes || {};
+  components.securitySchemes[name] = { type, scheme: schema, bearerFormat, "in": "header", required };
+  return `#/components/securitySchemes/${name}`;
+}
+
 function _ref({ type, name, def }) {
   components[type] = components[type] || {};
   components[type][name] = def;
@@ -142,6 +152,7 @@ module.exports = {
   put,
   patch,
   del,
+  security,
   swaggerDoc,
   reset,
 };