@mimik/api-helper 3.0.0 → 3.0.1

package/README.md

@@ -1,3 +1,21 @@
+## Modules
+
+<dl>
+<dt><a href="#module_api-helper">api-helper</a></dt>
+<dd></dd>
+</dl>
+
+## Typedefs
+
+<dl>
+<dt><a href="#UUID">UUID</a> : <code>string</code></dt>
+<dd><p>UUID string in RFC 4122 format.</p>
+</dd>
+<dt><a href="#PATH">PATH</a> : <code>string</code></dt>
+<dd><p>File system path string.</p>
+</dd>
+</dl>
+
 <a name="module_api-helper"></a>
 
 ## api-helper
@@ -50,7 +68,7 @@ The default formats for validation are: `date`, `time`, `date-time`, `byte`, `uu
 | securityHandlers | <code>object</code> | List of the security handlers to add for the service. |
 | extraFormats | <code>object</code> | list of the formats to add for validating properties. |
 | config | <code>object</code> | Configuration of the service. |
-| correlationId | <code>UUID.&lt;string&gt;</code> | CorrelationId when logging activities. |
+| correlationId | [<code>UUID</code>](#UUID) | CorrelationId when logging activities. |
 
 <a name="module_api-helper..getAPIFile"></a>
 
@@ -80,8 +98,8 @@ Gets the API file from swaggerhub and stores it in the given PATH location.
 
 | Param | Type | Description |
 | --- | --- | --- |
-| apiFilename | <code>PATH.&lt;string&gt;</code> | Name of the file where the API file will be stored. |
-| correlationId | <code>UUID.&lt;string&gt;</code> | CorrelationId when logging activities. |
+| apiFilename | [<code>PATH</code>](#PATH) | Name of the file where the API file will be stored. |
+| correlationId | [<code>UUID</code>](#UUID) | CorrelationId when logging activities. |
 | options | <code>object</code> | Options associated with the call. Use to pass `metrics` to `rpRetry` and `apiInfo` to access the api file in the api provider. |
 
 <a name="module_api-helper..setupServerFiles"></a>
@@ -100,10 +118,10 @@ Setup and validates files for the server
 
 | Param | Type | Description |
 | --- | --- | --- |
-| apiFilename | <code>PATH.&lt;string&gt;</code> | Name of the file where the API file will be stored. |
-| controllersDirectory | <code>PATH.&lt;string&gt;</code> | Directory to find the controller files. |
-| buildDirectory | <code>PATH.&lt;string&gt;</code> | Directory where the register file will be stored. |
-| correlationId | <code>UUID.&lt;string&gt;</code> | CorrelationId when logging activities. |
+| apiFilename | [<code>PATH</code>](#PATH) | Name of the file where the API file will be stored. |
+| controllersDirectory | [<code>PATH</code>](#PATH) | Directory to find the controller files. |
+| buildDirectory | [<code>PATH</code>](#PATH) | Directory where the register file will be stored. |
+| correlationId | [<code>UUID</code>](#UUID) | CorrelationId when logging activities. |
 | options | <code>object</code> | Options associated with the call. Use to pass `metrics` to `rpRetry` and `apiKey` to access private API. |
 
 <a name="module_api-helper..securityLib"></a>
@@ -144,7 +162,7 @@ Validates the known SecuritySchemes: `SystemSecurity`, `AdminSecurity`, `UserSec
 | Param | Type | Description |
 | --- | --- | --- |
 | apiDefinition | <code>object</code> | JSON object containing the API definition. |
-| correlationId | <code>UUID.&lt;string&gt;</code> | CorrelationId when logging activities. |
+| correlationId | [<code>UUID</code>](#UUID) | CorrelationId when logging activities. |
 
 <a name="module_api-helper..extractProperties"></a>
 
@@ -162,7 +180,19 @@ Extracts the properties from API definition and creates a file binding the handl
 | Param | Type | Description |
 | --- | --- | --- |
 | apiDefinition | <code>object</code> | JSON object containing the API definition. |
-| controllersDirectory | <code>PATH.&lt;string&gt;</code> | Directory to find the controller files. |
-| buildDirectory | <code>PATH.&lt;string&gt;</code> | Directory where the register file will be stored. |
-| correlationId | <code>UUID.&lt;string&gt;</code> | CorrelationId when logging activities. |
+| controllersDirectory | [<code>PATH</code>](#PATH) | Directory to find the controller files. |
+| buildDirectory | [<code>PATH</code>](#PATH) | Directory where the register file will be stored. |
+| correlationId | [<code>UUID</code>](#UUID) | CorrelationId when logging activities. |
+
+<a name="UUID"></a>
+
+## UUID : <code>string</code>
+UUID string in RFC 4122 format.
+
+**Kind**: global typedef  
+<a name="PATH"></a>
+
+## PATH : <code>string</code>
+File system path string.
 
+**Kind**: global typedef  

package/index.js

@@ -38,6 +38,14 @@ import pathLib from 'path';
 import { rpRetry } from '@mimik/request-retry';
 import { saveProperties } from './lib/extract-helper.js';
 import { securityLib } from './lib/securityHandlers.js';
+/**
+ * UUID string in RFC 4122 format.
+ * @typedef {string} UUID
+ */
+/**
+ * File system path string.
+ * @typedef {string} PATH
+ */
 /**
  * @module api-helper
  * @example
@@ -86,7 +94,7 @@ export { securityLib };
  * @param {object} securityHandlers - List of the security handlers to add for the service.
  * @param {object} extraFormats - list of the formats to add for validating properties.
  * @param {object} config - Configuration of the service.
- * @param {UUID.<string>} correlationId - CorrelationId when logging activities.
+ * @param {UUID} correlationId - CorrelationId when logging activities.
  * @return {Promise.<object>} The API file itself.
  * @throws {Promise} An error is thrown if the initialization failed.
  *
@@ -238,8 +246,8 @@ const buildProviderRequest = (params, apiInfo, apiFilename) => {
  * @requires fs
  * @requires js-yaml
  * @requires path
- * @param {PATH.<string>} apiFilename -  Name of the file where the API file will be stored.
- * @param {UUID.<string>} correlationId - CorrelationId when logging activities.
+ * @param {PATH} apiFilename -  Name of the file where the API file will be stored.
+ * @param {UUID} correlationId - CorrelationId when logging activities.
  * @param {object} options - Options associated with the call. Use to pass `metrics` to `rpRetry` and `apiInfo` to access the api file in the api provider.
  * @return {Promise.<object>} The API file itself.
  * @throws {Promise} An error is thrown if the apiFilename resolution generates an error or the request to the API provider fails or the file cannot be saved.
@@ -368,7 +376,7 @@ export const getAPIFile = (apiFilename, correlationId, options) => {
  * @requires @mimik/sumologic-winston-logger
  * @requires @mimik/response-helper
  * @param {object} apiDefinition - JSON object containing the API definition.
- * @param {UUID.<string>} correlationId - CorrelationId when logging activities.
+ * @param {UUID} correlationId - CorrelationId when logging activities.
  * @return {Array.<string>} An array of the known securitySchemes that are in the API definition.
  * @throws An error is thrown if a validation fails.
  */
@@ -398,9 +406,9 @@ export const validateSecuritySchemes = (apiDefinition, correlationId) => {
  * @requires @mimik/sumologic-winston-logger
  * @requires fs
  * @param {object} apiDefinition - JSON object containing the API definition.
- * @param {PATH.<string>} controllersDirectory - Directory to find the controller files.
- * @param {PATH.<string>} buildDirectory - Directory where the register file will be stored.
- * @param {UUID.<string>} correlationId - CorrelationId when logging activities.
+ * @param {PATH} controllersDirectory - Directory to find the controller files.
+ * @param {PATH} buildDirectory - Directory where the register file will be stored.
+ * @param {UUID} correlationId - CorrelationId when logging activities.
  * @return {void}
  * @throws An error is thrown for many reasons, like operationId does not exist in controllers, controller does not exist...
  */
@@ -483,10 +491,10 @@ export const extractProperties = (apiDefinition, controllersDirectory, buildDire
  * @requires fs
  * @requires js-yaml
  * @requires path
- * @param {PATH.<string>} apiFilename -  Name of the file where the API file will be stored.
- * @param {PATH.<string>} controllersDirectory - Directory to find the controller files.
- * @param {PATH.<string>} buildDirectory - Directory where the register file will be stored.
- * @param {UUID.<string>} correlationId - CorrelationId when logging activities.
+ * @param {PATH} apiFilename -  Name of the file where the API file will be stored.
+ * @param {PATH} controllersDirectory - Directory to find the controller files.
+ * @param {PATH} buildDirectory - Directory where the register file will be stored.
+ * @param {UUID} correlationId - CorrelationId when logging activities.
  * @param {object} options - Options associated with the call. Use to pass `metrics` to `rpRetry` and `apiKey` to access private API.
  * @return {Promise.<object>} The API file, the API filename, the existing known security schemes and the defined security schemes.
  * @throws {Promise} An error is thrown for many reasons associated with getAPIFile or validateSecuritySchemes or extractProperties.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@mimik/api-helper",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "helper for openAPI backend and mimik service",
   "main": "./index.js",
   "type": "module",
   "scripts": {
     "lint": "eslint . --no-error-on-unmatched-pattern",
     "docs": "jsdoc2md index.js > README.md",
-    "test": "mocha test/ --recursive",
+    "test": "mocha --reporter mochawesome test/ --recursive",
     "test-ci": "c8 --reporter=lcov --reporter=text npm test",
     "prepublishOnly": "npm run docs && npm run lint && npm run test-ci",
     "commit-ready": "npm run docs && npm run lint && npm run test-ci"
@@ -36,7 +36,7 @@
     "js-yaml": "4.1.1",
     "jsonwebtoken": "9.0.3",
     "openapi-backend": "5.16.1",
-    "swagger-client": "3.36.2"
+    "swagger-client": "3.37.0"
   },
   "devDependencies": {
     "@eslint/js": "9.32.0",
@@ -47,9 +47,10 @@
     "eslint": "9.32.0",
     "eslint-plugin-import": "2.32.0",
     "esmock": "2.7.3",
-    "globals": "17.3.0",
+    "globals": "17.4.0",
     "husky": "9.1.7",
     "jsdoc-to-markdown": "9.1.3",
-    "mocha": "11.7.5"
+    "mocha": "11.7.5",
+    "mochawesome": "7.1.4"
   }
 }

package/.claude/settings.local.json

@@ -1,9 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx mocha:*)",
-      "Bash(npm test:*)",
-      "Bash(npx eslint:*)"
-    ]
-  }
-}

package/.husky/pre-commit

@@ -1,2 +0,0 @@
-#!/bin/sh
-npm run commit-ready

package/.husky/pre-push

@@ -1,2 +0,0 @@
-#!/bin/sh
-npm run test

package/eslint.config.js

@@ -1,82 +0,0 @@
-import globals from 'globals';
-import importPlugin from 'eslint-plugin-import';
-import js from '@eslint/js';
-import processDoc from '@mimik/eslint-plugin-document-env';
-import stylistic from '@stylistic/eslint-plugin';
-
-const MAX_LENGTH_LINE = 180;
-const MAX_FUNCTION_PARAMETERS = 6;
-const MAX_LINES_IN_FILES = 600;
-const MAX_LINES_IN_FUNCTION = 150;
-const MAX_STATEMENTS_IN_FUNCTION = 45;
-const MIN_KEYS_IN_OBJECT = 10;
-const MAX_COMPLEXITY = 30;
-const ECMA_VERSION = 'latest';
-const MAX_DEPTH = 6;
-const ALLOWED_CONSTANTS = [0, 1, -1];
-
-export default [
-  {
-    ignores: ['mochawesome-report/**', 'node_modules/**', 'dist/**'],
-  },
-  importPlugin.flatConfigs.recommended,
-  stylistic.configs.recommended,
-  js.configs.all,
-  {
-    plugins: {
-      processDoc,
-    },
-    languageOptions: {
-      ecmaVersion: ECMA_VERSION,
-      globals: {
-        ...globals.mocha,
-        ...globals.nodeBuiltin,
-      },
-      sourceType: 'module',
-    },
-    rules: {
-      '@stylistic/brace-style': ['warn', 'stroustrup', { allowSingleLine: true }],
-      '@stylistic/line-comment-position': ['off'],
-      '@stylistic/max-len': ['warn', MAX_LENGTH_LINE, { ignoreComments: true, ignoreStrings: true, ignoreRegExpLiterals: true }],
-      '@stylistic/quotes': ['warn', 'single'],
-      '@stylistic/semi': ['error', 'always'],
-      'capitalized-comments': ['off'],
-      'complexity': ['error', MAX_COMPLEXITY],
-      'curly': ['off'],
-      'id-length': ['error', { exceptions: ['x', 'y', 'z', 'i', 'j', 'k'] }],
-      'import/no-extraneous-dependencies': ['error', { devDependencies: true }],
-      'import/no-unresolved': ['error', { amd: true, caseSensitiveStrict: true, commonjs: true }],
-      'init-declarations': ['off'],
-      'linebreak-style': ['off'],
-      'max-depth': ['error', MAX_DEPTH],
-      'max-len': ['off'],
-      'max-lines': ['warn', { max: MAX_LINES_IN_FILES, skipComments: true, skipBlankLines: true }],
-      'max-lines-per-function': ['warn', { max: MAX_LINES_IN_FUNCTION, skipComments: true, skipBlankLines: true }],
-      'max-params': ['error', MAX_FUNCTION_PARAMETERS],
-      'max-statements': ['warn', MAX_STATEMENTS_IN_FUNCTION],
-      'no-confusing-arrow': ['off'],
-      'no-inline-comments': ['off'],
-      'no-magic-numbers': ['error', { ignore: ALLOWED_CONSTANTS, enforceConst: true, detectObjects: true }],
-      'no-process-env': ['error'],
-      'no-ternary': ['off'],
-      'no-undefined': ['off'],
-      'one-var': ['error', 'never'],
-      'processDoc/validate-document-env': ['error'],
-      'quotes': ['off'],
-      'sort-imports': ['error', { allowSeparatedGroups: true }],
-      'sort-keys': ['error', 'asc', { caseSensitive: true, minKeys: MIN_KEYS_IN_OBJECT, natural: false, allowLineSeparatedGroups: true }],
-    },
-  },
-  {
-    files: ['test/**/*.js'],
-    rules: {
-      'class-methods-use-this': ['off'],
-      'max-classes-per-file': ['off'],
-      'max-lines': ['off'],
-      'max-lines-per-function': ['off'],
-      'max-statements': ['off'],
-      'no-empty-function': ['off'],
-      'no-magic-numbers': ['off'],
-    },
-  },
-];

package/test/ajvHelpers.test.js

@@ -1,159 +0,0 @@
-import esmock from 'esmock';
-import { expect } from 'chai';
-
-let ajvFormats;
-let addedLibFormats;
-let addedCustomFormats;
-
-describe('ajvHelpers', () => {
-  before(async () => {
-    const mod = await esmock('../lib/ajvHelpers.js', {
-      'ajv-formats': {
-        default: (ajv, formats) => {
-          addedLibFormats = formats;
-        },
-      },
-    });
-
-    ({ ajvFormats } = mod);
-  });
-
-  beforeEach(() => {
-    addedLibFormats = null;
-    addedCustomFormats = {};
-  });
-
-  const createMockAjv = () => ({
-    addFormat: (name, format) => {
-      addedCustomFormats[name] = format;
-    },
-  });
-
-  describe('with no extra formats', () => {
-    it('should add default library formats', () => {
-      const ajv = createMockAjv();
-      const configurer = ajvFormats();
-
-      configurer(ajv);
-      expect(addedLibFormats).to.deep.equal(['date', 'time', 'date-time', 'byte', 'uuid', 'uri', 'email', 'ipv4', 'ipv6']);
-    });
-
-    it('should add built-in semver and ip custom formats', () => {
-      const ajv = createMockAjv();
-      const configurer = ajvFormats();
-
-      configurer(ajv);
-      expect(addedCustomFormats).to.have.property('semver');
-      expect(addedCustomFormats.semver.type).to.equal('string');
-      expect(addedCustomFormats).to.have.property('ip');
-      expect(addedCustomFormats.ip.type).to.equal('string');
-    });
-
-    it('should return the ajv instance', () => {
-      const ajv = createMockAjv();
-      const configurer = ajvFormats();
-      const result = configurer(ajv);
-
-      expect(result).to.equal(ajv);
-    });
-  });
-
-  describe('with null extra formats', () => {
-    it('should treat null as no extra formats', () => {
-      const ajv = createMockAjv();
-      const configurer = ajvFormats(null);
-
-      configurer(ajv);
-      expect(addedLibFormats).to.deep.equal(['date', 'time', 'date-time', 'byte', 'uuid', 'uri', 'email', 'ipv4', 'ipv6']);
-    });
-  });
-
-  describe('with extra library formats (string-only)', () => {
-    it('should append format names to the library formats list', () => {
-      const ajv = createMockAjv();
-      const configurer = ajvFormats({ hostname: {} });
-
-      configurer(ajv);
-      expect(addedLibFormats).to.include('hostname');
-      expect(addedLibFormats).to.have.lengthOf(10);
-    });
-  });
-
-  describe('with extra custom formats (with type)', () => {
-    it('should add custom format via ajv.addFormat', () => {
-      const customFormat = { type: 'string', validate: /^[A-Z]+$/u };
-      const ajv = createMockAjv();
-      const configurer = ajvFormats({ uppercase: customFormat });
-
-      configurer(ajv);
-      expect(addedCustomFormats).to.have.property('uppercase');
-      expect(addedCustomFormats.uppercase).to.equal(customFormat);
-      expect(addedLibFormats).to.not.include('uppercase');
-    });
-  });
-
-  describe('semver validation', () => {
-    it('should accept valid semver strings', () => {
-      const ajv = createMockAjv();
-
-      ajvFormats()(ajv);
-      const { validate } = addedCustomFormats.semver;
-
-      expect(validate.test('1.0.0')).to.equal(true);
-      expect(validate.test('0.1.0')).to.equal(true);
-      expect(validate.test('1.2.3-alpha.1')).to.equal(true);
-      expect(validate.test('1.2.3+build.123')).to.equal(true);
-      expect(validate.test('1.2.3-beta+build')).to.equal(true);
-    });
-
-    it('should reject invalid semver strings', () => {
-      const ajv = createMockAjv();
-
-      ajvFormats()(ajv);
-      const { validate } = addedCustomFormats.semver;
-
-      expect(validate.test('1.0')).to.equal(false);
-      expect(validate.test('abc')).to.equal(false);
-      expect(validate.test('1.0.0.0')).to.equal(false);
-    });
-  });
-
-  describe('ip validation', () => {
-    it('should accept valid IPv4 addresses', () => {
-      const ajv = createMockAjv();
-
-      ajvFormats()(ajv);
-      const { validate } = addedCustomFormats.ip;
-
-      expect(validate.test('192.168.1.1')).to.equal(true);
-      expect(validate.test('10.0.0.1')).to.equal(true);
-      expect(validate.test('255.255.255.255')).to.equal(true);
-    });
-
-    it('should accept valid IPv6 addresses', () => {
-      const ajv = createMockAjv();
-
-      ajvFormats()(ajv);
-      const { validate } = addedCustomFormats.ip;
-
-      expect(validate.test('::1')).to.equal(true);
-      expect(validate.test('2001:0db8:85a3:0000:0000:8a2e:0370:7334')).to.equal(true);
-    });
-  });
-
-  describe('DEFAULT_FORMATS isolation', () => {
-    it('should not mutate DEFAULT_FORMATS between calls', () => {
-      const ajv1 = createMockAjv();
-      const ajv2 = createMockAjv();
-
-      ajvFormats({ extra1: {} })(ajv1);
-      const firstCallLength = addedLibFormats.length;
-
-      ajvFormats()(ajv2);
-      const secondCallLength = addedLibFormats.length;
-
-      expect(secondCallLength).to.equal(9);
-      expect(firstCallLength).to.equal(10);
-    });
-  });
-});

package/test/baseHandlers.test.js

@@ -1,150 +0,0 @@
-import { ERROR_CODE } from '@mimik/response-helper';
-import esmock from 'esmock';
-import { expect } from 'chai';
-
-let baseHandlers;
-let lastRejectArgs;
-
-describe('baseHandlers', () => {
-  before(async () => {
-    const mod = await esmock('../lib/baseHandlers.js', {
-      '@mimik/swagger-helper': {
-        rejectRequest: (error, con, res) => {
-          lastRejectArgs = { error, con, res };
-        },
-      },
-    });
-
-    baseHandlers = mod.default;
-  });
-
-  beforeEach(() => {
-    lastRejectArgs = null;
-  });
-
-  describe('validationFail', () => {
-    it('should create error with status 400 and call rejectRequest', () => {
-      const con = { validation: { errors: [{ message: 'bad field' }], warnings: ['warn1'] } };
-      const req = { method: 'POST', url: '/test' };
-      const res = {};
-
-      baseHandlers.validationFail(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('Failed schema validation');
-      expect(lastRejectArgs.error.statusCode).to.equal(ERROR_CODE.PARAMETER);
-      expect(lastRejectArgs.error.info).to.deep.equal({
-        method: 'POST',
-        path: '/test',
-        errors: [{ message: 'bad field' }],
-        warnings: ['warn1'],
-      });
-      expect(lastRejectArgs.con).to.equal(con);
-      expect(lastRejectArgs.res).to.equal(res);
-    });
-
-    it('should default warnings to empty array when not present', () => {
-      const con = { validation: { errors: [] } };
-      const req = { method: 'GET', url: '/path' };
-      const res = {};
-
-      baseHandlers.validationFail(con, req, res);
-      expect(lastRejectArgs.error.info.warnings).to.deep.equal([]);
-    });
-  });
-
-  describe('notFound', () => {
-    it('should create error with status 404 and the path', () => {
-      const con = {};
-      const req = { method: 'GET', url: '/unknown' };
-      const res = {};
-
-      baseHandlers.notFound(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('path /unknown not defined in Swagger specification');
-      expect(lastRejectArgs.error.statusCode).to.equal(ERROR_CODE.NOT_FOUND);
-      expect(lastRejectArgs.error.info).to.deep.equal({ method: 'GET', path: '/unknown' });
-    });
-  });
-
-  describe('unauthorizedHandler', () => {
-    it('should use default Unauthorized error when no scheme error exists', () => {
-      const con = { security: { authorized: true, SystemSecurity: {} } };
-      const req = {};
-      const res = {};
-
-      baseHandlers.unauthorizedHandler(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('Unauthorized');
-      expect(lastRejectArgs.error.statusCode).to.equal(ERROR_CODE.UNAUTHORIZED);
-    });
-
-    it('should use scheme error when present', () => {
-      const schemeError = new Error('token expired');
-
-      schemeError.statusCode = ERROR_CODE.FORBIDDEN;
-      const con = { security: { authorized: false, SystemSecurity: { error: schemeError } } };
-      const req = {};
-      const res = {};
-
-      baseHandlers.unauthorizedHandler(con, req, res);
-      expect(lastRejectArgs.error).to.equal(schemeError);
-      expect(lastRejectArgs.error.message).to.equal('token expired');
-    });
-
-    it('should filter out the authorized key from security schemes', () => {
-      const schemeError = new Error('forbidden');
-      const con = { security: { authorized: true, AdminSecurity: { error: schemeError } } };
-      const req = {};
-      const res = {};
-
-      baseHandlers.unauthorizedHandler(con, req, res);
-      expect(lastRejectArgs.error).to.equal(schemeError);
-    });
-
-    it('should handle scheme with no error property', () => {
-      const con = { security: { authorized: false, SystemSecurity: null } };
-      const req = {};
-      const res = {};
-
-      baseHandlers.unauthorizedHandler(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('Unauthorized');
-    });
-  });
-
-  describe('notImplemented', () => {
-    it('should create error with status 501 and include operationId', () => {
-      const con = { operation: { operationId: 'getUsers' } };
-      const req = { method: 'GET', url: '/users' };
-      const res = {};
-
-      baseHandlers.notImplemented(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('GET /users defined in Swagger specification, but not implemented');
-      expect(lastRejectArgs.error.statusCode).to.equal(ERROR_CODE.NOT_IMPLEMENTED);
-      expect(lastRejectArgs.error.info).to.deep.equal({
-        method: 'GET',
-        path: '/users',
-        operationId: 'getUsers',
-      });
-    });
-  });
-
-  describe('methodNotAllowed', () => {
-    it('should create error with status 501 for disallowed method', () => {
-      const con = {};
-      const req = { method: 'DELETE', url: '/items' };
-      const res = {};
-
-      baseHandlers.methodNotAllowed(con, req, res);
-      expect(lastRejectArgs.error.message).to.equal('path /items defined in Swagger specification, but the method DELETE is not defined');
-      expect(lastRejectArgs.error.statusCode).to.equal(ERROR_CODE.NOT_IMPLEMENTED);
-      expect(lastRejectArgs.error.info).to.deep.equal({ method: 'DELETE', path: '/items' });
-    });
-  });
-
-  describe('exports', () => {
-    it('should export all five handlers', () => {
-      expect(baseHandlers).to.have.property('validationFail').that.is.a('function');
-      expect(baseHandlers).to.have.property('notFound').that.is.a('function');
-      expect(baseHandlers).to.have.property('unauthorizedHandler').that.is.a('function');
-      expect(baseHandlers).to.have.property('notImplemented').that.is.a('function');
-      expect(baseHandlers).to.have.property('methodNotAllowed').that.is.a('function');
-    });
-  });
-});