jimpex 7.0.2 → 9.0.0

package/dist/middlewares/utils/versionValidator.d.mts

@@ -0,0 +1,215 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { Statuses } from '../../utils/fns/statuses.mjs';
+import { J as Jimpex, R as MiddlewareConnectFn } from '../../index-efeb437e.js';
+import { ExpressMiddleware } from '../../types/express.mjs';
+import { DeepPartial } from '../../types/utils.mjs';
+import { HTTPErrorClass } from '../../services/common/httpError.mjs';
+import { ResponsesBuilder } from '../../services/http/responsesBuilder.mjs';
+import { Request } from 'express';
+import 'statuses';
+import '../../types/http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '../../services/common/appError.mjs';
+
+/**
+ * The options for how the middleware should behave if the requested version is `latest`.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorLatestOptions = {
+    /**
+     * Whether or not the middleware should validate the _"latest version"_.
+     *
+     * @default true
+     */
+    allow: boolean;
+    /**
+     * The name of the _"latest version"_. Basically, `req.params.version` must match with
+     * this property in order to be consider "latest".
+     *
+     * @default 'latest'
+     */
+    name: string;
+};
+/**
+ * The options for how to detect if the request comes from a popup and how to compose the
+ * post message the middleware will use to respond.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorPopupOptions = {
+    /**
+     * The name of the query string variable the middleware will check in order to indentify
+     * whether the request comes from a popup or not. The variable must have `'true'` as its
+     * value.
+     *
+     * @default 'popup'
+     */
+    variable: string;
+    /**
+     * The title of the page that will be generated to respond in case the versions don't
+     * match.
+     *
+     * @default 'Conflict'
+     */
+    title: string;
+    /**
+     * The contents of the post message the generated page will send if the versions don't
+     * match.
+     *
+     * @default 'version:conflict'
+     */
+    message: string;
+};
+/**
+ * The options used to customize a {@link VersionValidator} instance.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorOptions = {
+    /**
+     * The version used to validate the requests.
+     */
+    version: string;
+    /**
+     * The options for how the middleware should behave if the requested version is
+     * `latest`.
+     */
+    latest: VersionValidatorLatestOptions;
+    /**
+     * The options for how to detect if the request comes from a popup and how to compose
+     * the post message the middleware will use to respond.
+     */
+    popup: VersionValidatorPopupOptions;
+    /**
+     * The error message to show when the version is invalid.
+     *
+     * @default "The application version doesn't match"
+     * @prettierignore
+     */
+    error: string;
+};
+/**
+ * A partial version of the {@link VersionValidatorOptions}, to be used in the constructor
+ * and the middleware creator. The reason it omits `version` it's because for the
+ * constructor it's required, but for the middleware creator it's not.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorPartialOptions = DeepPartial<Omit<VersionValidatorOptions, 'version'>>;
+/**
+ * The options to construct a {@link VersionValidator}.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorConstructorOptions = VersionValidatorPartialOptions & {
+    /**
+     * The version used to validate the requests.
+     */
+    version: string;
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        HTTPError: HTTPErrorClass;
+        responsesBuilder: ResponsesBuilder;
+        statuses: Statuses;
+    };
+};
+/**
+ * The options for the middleware creator that will mount an instance of
+ * {@link VersionValidator}.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorMiddlewareOptions = VersionValidatorPartialOptions & {
+    /**
+     * The version used to validate the requests. This is optional in here because if it's
+     * not specified, it will be obtained from the configuration service.
+     */
+    version?: string;
+};
+/**
+ * This is the handler for the middleware/controller that validates the application
+ * version.
+ * This is useful in cases where you want to restrict the access to specific versions; for
+ * example: you have a frontend which needs to be aligned with the "current" version of
+ * the application, since the frontend won't realize a new version was released, the
+ * validator can be used to let the frontend know.
+ * Also, it can be configured to handle requests from popups, in which case, instead of
+ * generating an error message, it will send a post message.
+ *
+ * @group Middleware Classes
+ * @group Middlewares/VersionValidator
+ * @prettierignore
+ */
+declare class VersionValidator {
+    /**
+     * To generate the errors in case the validation fails.
+     */
+    protected readonly _HTTPError: HTTPErrorClass;
+    /**
+     * To generate responses for popups.
+     */
+    protected readonly _responsesBuilder: ResponsesBuilder;
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    protected readonly _statuses: Statuses;
+    /**
+     * The customization options.
+     */
+    protected readonly _options: VersionValidatorOptions;
+    /**
+     * @param options  The options to construct the class.
+     * @throws If no `version` is specified in the options.
+     */
+    constructor({ inject, version, ...options }: VersionValidatorConstructorOptions);
+    /**
+     * Generates the middleware that validates the version.
+     */
+    getMiddleware(): ExpressMiddleware;
+    /**
+     * The customization options.
+     */
+    get options(): Readonly<VersionValidatorOptions>;
+    /**
+     * Helper method that checks if the incoming request is from a popup. It will look for
+     * the query string variable defined in the constructor options.
+     *
+     * @param req  The request object sent by the application.
+     */
+    protected _isPopup(req: Request): boolean;
+    /**
+     * Helper method that checks if the "latest version" is enabled and if the given version
+     * is "the latest" (comparing it with the option name).
+     *
+     * @param version  The version received in the request.
+     */
+    protected _isTheAllowedLatest(version: string): boolean;
+}
+/**
+ * A middleware that will validate a `version` request parameter against the application
+ * version, and generate an error if they don't match.
+ * This is a "middleware/controller" because the wrappers for both are the same, the
+ * difference is that, for controllers, Jimpex sends a second parameter with the route
+ * where they are mounted.
+ * By validating the route parameter, the function can know whether the implementation is
+ * going to use the middleware by itself or as a route middleware.
+ * If used as middleware, it will just return the result of
+ * {@link VersionValidator.getMiddleware}; but if used as controller, it will mount it on
+ * `[route]/:version/*`.
+ *
+ * @group Middlewares
+ * @group Middlewares/VersionValidator
+ */
+declare const versionValidatorMiddleware: _homer0_jimple.ResourceCreator<"middleware", "connect", (options?: VersionValidatorMiddlewareOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType, route: string | undefined) => ExpressMiddleware, MiddlewareConnectFn>;
+
+export { VersionValidator, VersionValidatorConstructorOptions, VersionValidatorLatestOptions, VersionValidatorMiddlewareOptions, VersionValidatorOptions, VersionValidatorPartialOptions, VersionValidatorPopupOptions, versionValidatorMiddleware };

package/dist/middlewares/utils/versionValidator.d.ts

@@ -0,0 +1,215 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { Statuses } from '../../utils/fns/statuses.js';
+import { J as Jimpex, R as MiddlewareConnectFn } from '../../index-b2a04c78.js';
+import { ExpressMiddleware } from '../../types/express.js';
+import { DeepPartial } from '../../types/utils.js';
+import { HTTPErrorClass } from '../../services/common/httpError.js';
+import { ResponsesBuilder } from '../../services/http/responsesBuilder.js';
+import { Request } from 'express';
+import 'statuses';
+import '../../types/http.js';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '../../services/common/appError.js';
+
+/**
+ * The options for how the middleware should behave if the requested version is `latest`.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorLatestOptions = {
+    /**
+     * Whether or not the middleware should validate the _"latest version"_.
+     *
+     * @default true
+     */
+    allow: boolean;
+    /**
+     * The name of the _"latest version"_. Basically, `req.params.version` must match with
+     * this property in order to be consider "latest".
+     *
+     * @default 'latest'
+     */
+    name: string;
+};
+/**
+ * The options for how to detect if the request comes from a popup and how to compose the
+ * post message the middleware will use to respond.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorPopupOptions = {
+    /**
+     * The name of the query string variable the middleware will check in order to indentify
+     * whether the request comes from a popup or not. The variable must have `'true'` as its
+     * value.
+     *
+     * @default 'popup'
+     */
+    variable: string;
+    /**
+     * The title of the page that will be generated to respond in case the versions don't
+     * match.
+     *
+     * @default 'Conflict'
+     */
+    title: string;
+    /**
+     * The contents of the post message the generated page will send if the versions don't
+     * match.
+     *
+     * @default 'version:conflict'
+     */
+    message: string;
+};
+/**
+ * The options used to customize a {@link VersionValidator} instance.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorOptions = {
+    /**
+     * The version used to validate the requests.
+     */
+    version: string;
+    /**
+     * The options for how the middleware should behave if the requested version is
+     * `latest`.
+     */
+    latest: VersionValidatorLatestOptions;
+    /**
+     * The options for how to detect if the request comes from a popup and how to compose
+     * the post message the middleware will use to respond.
+     */
+    popup: VersionValidatorPopupOptions;
+    /**
+     * The error message to show when the version is invalid.
+     *
+     * @default "The application version doesn't match"
+     * @prettierignore
+     */
+    error: string;
+};
+/**
+ * A partial version of the {@link VersionValidatorOptions}, to be used in the constructor
+ * and the middleware creator. The reason it omits `version` it's because for the
+ * constructor it's required, but for the middleware creator it's not.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorPartialOptions = DeepPartial<Omit<VersionValidatorOptions, 'version'>>;
+/**
+ * The options to construct a {@link VersionValidator}.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorConstructorOptions = VersionValidatorPartialOptions & {
+    /**
+     * The version used to validate the requests.
+     */
+    version: string;
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        HTTPError: HTTPErrorClass;
+        responsesBuilder: ResponsesBuilder;
+        statuses: Statuses;
+    };
+};
+/**
+ * The options for the middleware creator that will mount an instance of
+ * {@link VersionValidator}.
+ *
+ * @group Middlewares/VersionValidator
+ */
+type VersionValidatorMiddlewareOptions = VersionValidatorPartialOptions & {
+    /**
+     * The version used to validate the requests. This is optional in here because if it's
+     * not specified, it will be obtained from the configuration service.
+     */
+    version?: string;
+};
+/**
+ * This is the handler for the middleware/controller that validates the application
+ * version.
+ * This is useful in cases where you want to restrict the access to specific versions; for
+ * example: you have a frontend which needs to be aligned with the "current" version of
+ * the application, since the frontend won't realize a new version was released, the
+ * validator can be used to let the frontend know.
+ * Also, it can be configured to handle requests from popups, in which case, instead of
+ * generating an error message, it will send a post message.
+ *
+ * @group Middleware Classes
+ * @group Middlewares/VersionValidator
+ * @prettierignore
+ */
+declare class VersionValidator {
+    /**
+     * To generate the errors in case the validation fails.
+     */
+    protected readonly _HTTPError: HTTPErrorClass;
+    /**
+     * To generate responses for popups.
+     */
+    protected readonly _responsesBuilder: ResponsesBuilder;
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    protected readonly _statuses: Statuses;
+    /**
+     * The customization options.
+     */
+    protected readonly _options: VersionValidatorOptions;
+    /**
+     * @param options  The options to construct the class.
+     * @throws If no `version` is specified in the options.
+     */
+    constructor({ inject, version, ...options }: VersionValidatorConstructorOptions);
+    /**
+     * Generates the middleware that validates the version.
+     */
+    getMiddleware(): ExpressMiddleware;
+    /**
+     * The customization options.
+     */
+    get options(): Readonly<VersionValidatorOptions>;
+    /**
+     * Helper method that checks if the incoming request is from a popup. It will look for
+     * the query string variable defined in the constructor options.
+     *
+     * @param req  The request object sent by the application.
+     */
+    protected _isPopup(req: Request): boolean;
+    /**
+     * Helper method that checks if the "latest version" is enabled and if the given version
+     * is "the latest" (comparing it with the option name).
+     *
+     * @param version  The version received in the request.
+     */
+    protected _isTheAllowedLatest(version: string): boolean;
+}
+/**
+ * A middleware that will validate a `version` request parameter against the application
+ * version, and generate an error if they don't match.
+ * This is a "middleware/controller" because the wrappers for both are the same, the
+ * difference is that, for controllers, Jimpex sends a second parameter with the route
+ * where they are mounted.
+ * By validating the route parameter, the function can know whether the implementation is
+ * going to use the middleware by itself or as a route middleware.
+ * If used as middleware, it will just return the result of
+ * {@link VersionValidator.getMiddleware}; but if used as controller, it will mount it on
+ * `[route]/:version/*`.
+ *
+ * @group Middlewares
+ * @group Middlewares/VersionValidator
+ */
+declare const versionValidatorMiddleware: _homer0_jimple.ResourceCreator<"middleware", "connect", (options?: VersionValidatorMiddlewareOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType, route: string | undefined) => ExpressMiddleware, MiddlewareConnectFn>;
+
+export { VersionValidator, VersionValidatorConstructorOptions, VersionValidatorLatestOptions, VersionValidatorMiddlewareOptions, VersionValidatorOptions, VersionValidatorPartialOptions, VersionValidatorPopupOptions, versionValidatorMiddleware };

package/dist/middlewares/utils/versionValidator.js

@@ -0,0 +1,162 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+var versionValidator_exports = {};
+__export(versionValidator_exports, {
+  VersionValidator: () => VersionValidator,
+  versionValidatorMiddleware: () => versionValidatorMiddleware
+});
+module.exports = __toCommonJS(versionValidator_exports);
+var import_deep_assign = require("@homer0/deep-assign");
+var import_utils = require("../../utils");
+class VersionValidator {
+  /**
+   * @param options  The options to construct the class.
+   * @throws If no `version` is specified in the options.
+   */
+  constructor({ inject, version, ...options }) {
+    /**
+     * To generate the errors in case the validation fails.
+     */
+    __publicField(this, "_HTTPError");
+    /**
+     * To generate responses for popups.
+     */
+    __publicField(this, "_responsesBuilder");
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    __publicField(this, "_statuses");
+    /**
+     * The customization options.
+     */
+    __publicField(this, "_options");
+    this._HTTPError = inject.HTTPError;
+    this._responsesBuilder = inject.responsesBuilder;
+    this._statuses = inject.statuses;
+    this._options = (0, import_deep_assign.deepAssignWithOverwrite)(
+      {
+        error: "The application version doesn't match",
+        latest: {
+          allow: true,
+          name: "latest"
+        },
+        popup: {
+          variable: "popup",
+          title: "Conflict",
+          message: "vesion:conflict"
+        },
+        version
+      },
+      options
+    );
+    if (!this._options.version) {
+      throw new Error("You need to supply a version");
+    }
+  }
+  /**
+   * Generates the middleware that validates the version.
+   */
+  getMiddleware() {
+    return (req, res, next) => {
+      const { version } = req.params;
+      if (!version) {
+        next();
+        return;
+      }
+      if (version === this._options.version || this._isTheAllowedLatest(version)) {
+        next();
+        return;
+      }
+      const status = this._statuses("conflict");
+      if (this._isPopup(req)) {
+        const { title, message } = this._options.popup;
+        this._responsesBuilder.htmlPostMessage({
+          res,
+          title,
+          message,
+          status
+        });
+        return;
+      }
+      next(
+        new this._HTTPError(this._options.error, status, {
+          response: {
+            validation: true
+          }
+        })
+      );
+    };
+  }
+  /**
+   * The customization options.
+   */
+  get options() {
+    return (0, import_deep_assign.deepAssignWithOverwrite)({}, this._options);
+  }
+  /**
+   * Helper method that checks if the incoming request is from a popup. It will look for
+   * the query string variable defined in the constructor options.
+   *
+   * @param req  The request object sent by the application.
+   */
+  _isPopup(req) {
+    const popup = req.query[this._options.popup.variable];
+    return !!(popup && String(popup).toLowerCase() === "true");
+  }
+  /**
+   * Helper method that checks if the "latest version" is enabled and if the given version
+   * is "the latest" (comparing it with the option name).
+   *
+   * @param version  The version received in the request.
+   */
+  _isTheAllowedLatest(version) {
+    const { allow, name } = this._options.latest;
+    return allow && version === name;
+  }
+}
+const versionValidatorMiddleware = (0, import_utils.middlewareCreator)(
+  (options = {}) => (app, route) => {
+    const version = app.getConfig("version");
+    const middleware = new VersionValidator({
+      inject: {
+        HTTPError: app.get("HTTPError"),
+        responsesBuilder: app.get("responsesBuilder"),
+        statuses: app.get("statuses")
+      },
+      version,
+      ...options
+    }).getMiddleware();
+    if (route) {
+      const router = app.getRouter();
+      return router.all("/:version/*", middleware);
+    }
+    return middleware;
+  }
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VersionValidator,
+  versionValidatorMiddleware
+});
+//# sourceMappingURL=versionValidator.js.map

package/dist/middlewares/utils/versionValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/middlewares/utils/versionValidator.ts"],"sourcesContent":["import { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport { middlewareCreator, type Statuses } from '../../utils';\nimport { DeepPartial, Request, ExpressMiddleware } from '../../types';\nimport type { HTTPErrorClass, ResponsesBuilder } from '../../services';\n/**\n * The options for how the middleware should behave if the requested version is `latest`.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorLatestOptions = {\n  /**\n   * Whether or not the middleware should validate the _\"latest version\"_.\n   *\n   * @default true\n   */\n  allow: boolean;\n  /**\n   * The name of the _\"latest version\"_. Basically, `req.params.version` must match with\n   * this property in order to be consider \"latest\".\n   *\n   * @default 'latest'\n   */\n  name: string;\n};\n/**\n * The options for how to detect if the request comes from a popup and how to compose the\n * post message the middleware will use to respond.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorPopupOptions = {\n  /**\n   * The name of the query string variable the middleware will check in order to indentify\n   * whether the request comes from a popup or not. The variable must have `'true'` as its\n   * value.\n   *\n   * @default 'popup'\n   */\n  variable: string;\n  /**\n   * The title of the page that will be generated to respond in case the versions don't\n   * match.\n   *\n   * @default 'Conflict'\n   */\n  title: string;\n  /**\n   * The contents of the post message the generated page will send if the versions don't\n   * match.\n   *\n   * @default 'version:conflict'\n   */\n  message: string;\n};\n/**\n * The options used to customize a {@link VersionValidator} instance.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorOptions = {\n  /**\n   * The version used to validate the requests.\n   */\n  version: string;\n  /**\n   * The options for how the middleware should behave if the requested version is\n   * `latest`.\n   */\n  latest: VersionValidatorLatestOptions;\n  /**\n   * The options for how to detect if the request comes from a popup and how to compose\n   * the post message the middleware will use to respond.\n   */\n  popup: VersionValidatorPopupOptions;\n  /**\n   * The error message to show when the version is invalid.\n   *\n   * @default \"The application version doesn't match\"\n   * @prettierignore\n   */\n  error: string;\n};\n/**\n * A partial version of the {@link VersionValidatorOptions}, to be used in the constructor\n * and the middleware creator. The reason it omits `version` it's because for the\n * constructor it's required, but for the middleware creator it's not.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorPartialOptions = DeepPartial<\n  Omit<VersionValidatorOptions, 'version'>\n>;\n/**\n * The options to construct a {@link VersionValidator}.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorConstructorOptions = VersionValidatorPartialOptions & {\n  /**\n   * The version used to validate the requests.\n   */\n  version: string;\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    HTTPError: HTTPErrorClass;\n    responsesBuilder: ResponsesBuilder;\n    statuses: Statuses;\n  };\n};\n/**\n * The options for the middleware creator that will mount an instance of\n * {@link VersionValidator}.\n *\n * @group Middlewares/VersionValidator\n */\nexport type VersionValidatorMiddlewareOptions = VersionValidatorPartialOptions & {\n  /**\n   * The version used to validate the requests. This is optional in here because if it's\n   * not specified, it will be obtained from the configuration service.\n   */\n  version?: string;\n};\n/**\n * This is the handler for the middleware/controller that validates the application\n * version.\n * This is useful in cases where you want to restrict the access to specific versions; for\n * example: you have a frontend which needs to be aligned with the \"current\" version of\n * the application, since the frontend won't realize a new version was released, the\n * validator can be used to let the frontend know.\n * Also, it can be configured to handle requests from popups, in which case, instead of\n * generating an error message, it will send a post message.\n *\n * @group Middleware Classes\n * @group Middlewares/VersionValidator\n * @prettierignore\n */\nexport class VersionValidator {\n  /**\n   * To generate the errors in case the validation fails.\n   */\n  protected readonly _HTTPError: HTTPErrorClass;\n  /**\n   * To generate responses for popups.\n   */\n  protected readonly _responsesBuilder: ResponsesBuilder;\n  /**\n   * The uility service to get HTTP status codes.\n   */\n  protected readonly _statuses: Statuses;\n  /**\n   * The customization options.\n   */\n  protected readonly _options: VersionValidatorOptions;\n  /**\n   * @param options  The options to construct the class.\n   * @throws If no `version` is specified in the options.\n   */\n  constructor({ inject, version, ...options }: VersionValidatorConstructorOptions) {\n    this._HTTPError = inject.HTTPError;\n    this._responsesBuilder = inject.responsesBuilder;\n    this._statuses = inject.statuses;\n    this._options = deepAssignWithOverwrite(\n      {\n        error: \"The application version doesn't match\",\n        latest: {\n          allow: true,\n          name: 'latest',\n        },\n        popup: {\n          variable: 'popup',\n          title: 'Conflict',\n          message: 'vesion:conflict',\n        },\n        version,\n      },\n      options,\n    );\n\n    if (!this._options.version) {\n      throw new Error('You need to supply a version');\n    }\n  }\n  /**\n   * Generates the middleware that validates the version.\n   */\n  getMiddleware(): ExpressMiddleware {\n    return (req, res, next) => {\n      // Get the `version` parameter from the request.\n      const { version } = req.params;\n      // If no version is present, move on to the next middleware.\n      if (!version) {\n        next();\n        return;\n      }\n      // If the version matches, or it's a \"latest\" version, move on to the next middleware.\n      if (version === this._options.version || this._isTheAllowedLatest(version)) {\n        next();\n        return;\n      }\n\n      const status = this._statuses('conflict');\n      // If the request comes from a popup, send the post message.\n      if (this._isPopup(req)) {\n        const { title, message } = this._options.popup;\n        this._responsesBuilder.htmlPostMessage({\n          res,\n          title,\n          message,\n          status,\n        });\n        return;\n      }\n\n      // Every other validation failed, and it's not a popup, so generate an error.\n      next(\n        new this._HTTPError(this._options.error, status, {\n          response: {\n            validation: true,\n          },\n        }),\n      );\n    };\n  }\n  /**\n   * The customization options.\n   */\n  get options(): Readonly<VersionValidatorOptions> {\n    return deepAssignWithOverwrite({}, this._options);\n  }\n  /**\n   * Helper method that checks if the incoming request is from a popup. It will look for\n   * the query string variable defined in the constructor options.\n   *\n   * @param req  The request object sent by the application.\n   */\n  protected _isPopup(req: Request): boolean {\n    const popup = req.query[this._options.popup.variable];\n    return !!(popup && String(popup).toLowerCase() === 'true');\n  }\n  /**\n   * Helper method that checks if the \"latest version\" is enabled and if the given version\n   * is \"the latest\" (comparing it with the option name).\n   *\n   * @param version  The version received in the request.\n   */\n  protected _isTheAllowedLatest(version: string): boolean {\n    const { allow, name } = this._options.latest;\n    return allow && version === name;\n  }\n}\n/**\n * A middleware that will validate a `version` request parameter against the application\n * version, and generate an error if they don't match.\n * This is a \"middleware/controller\" because the wrappers for both are the same, the\n * difference is that, for controllers, Jimpex sends a second parameter with the route\n * where they are mounted.\n * By validating the route parameter, the function can know whether the implementation is\n * going to use the middleware by itself or as a route middleware.\n * If used as middleware, it will just return the result of\n * {@link VersionValidator.getMiddleware}; but if used as controller, it will mount it on\n * `[route]/:version/*`.\n *\n * @group Middlewares\n * @group Middlewares/VersionValidator\n */\nexport const versionValidatorMiddleware = middlewareCreator(\n  (options: VersionValidatorMiddlewareOptions = {}) =>\n    (app, route) => {\n      const version = app.getConfig<string>('version');\n      const middleware = new VersionValidator({\n        inject: {\n          HTTPError: app.get('HTTPError'),\n          responsesBuilder: app.get('responsesBuilder'),\n          statuses: app.get('statuses'),\n        },\n        version,\n        ...options,\n      }).getMiddleware();\n\n      if (route) {\n        const router = app.getRouter();\n        return router.all('/:version/*', middleware);\n      }\n\n      return middleware;\n    },\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwC;AACxC,mBAAiD;AAyI1C,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,EAqB5B,YAAY,EAAE,QAAQ,SAAS,GAAG,QAAQ,GAAuC;AAjBjF;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAMjB,SAAK,aAAa,OAAO;AACzB,SAAK,oBAAoB,OAAO;AAChC,SAAK,YAAY,OAAO;AACxB,SAAK,eAAW;AAAA,MACd;AAAA,QACE,OAAO;AAAA,QACP,QAAQ;AAAA,UACN,OAAO;AAAA,UACP,MAAM;AAAA,QACR;AAAA,QACA,OAAO;AAAA,UACL,UAAU;AAAA,UACV,OAAO;AAAA,UACP,SAAS;AAAA,QACX;AAAA,QACA;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAEA,QAAI,CAAC,KAAK,SAAS,SAAS;AAC1B,YAAM,IAAI,MAAM,8BAA8B;AAAA,IAChD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAIA,gBAAmC;AACjC,WAAO,CAAC,KAAK,KAAK,SAAS;AAEzB,YAAM,EAAE,QAAQ,IAAI,IAAI;AAExB,UAAI,CAAC,SAAS;AACZ,aAAK;AACL;AAAA,MACF;AAEA,UAAI,YAAY,KAAK,SAAS,WAAW,KAAK,oBAAoB,OAAO,GAAG;AAC1E,aAAK;AACL;AAAA,MACF;AAEA,YAAM,SAAS,KAAK,UAAU,UAAU;AAExC,UAAI,KAAK,SAAS,GAAG,GAAG;AACtB,cAAM,EAAE,OAAO,QAAQ,IAAI,KAAK,SAAS;AACzC,aAAK,kBAAkB,gBAAgB;AAAA,UACrC;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,CAAC;AACD;AAAA,MACF;AAGA;AAAA,QACE,IAAI,KAAK,WAAW,KAAK,SAAS,OAAO,QAAQ;AAAA,UAC/C,UAAU;AAAA,YACR,YAAY;AAAA,UACd;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAIA,IAAI,UAA6C;AAC/C,eAAO,4CAAwB,CAAC,GAAG,KAAK,QAAQ;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,SAAS,KAAuB;AACxC,UAAM,QAAQ,IAAI,MAAM,KAAK,SAAS,MAAM,QAAQ;AACpD,WAAO,CAAC,EAAE,SAAS,OAAO,KAAK,EAAE,YAAY,MAAM;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,oBAAoB,SAA0B;AACtD,UAAM,EAAE,OAAO,KAAK,IAAI,KAAK,SAAS;AACtC,WAAO,SAAS,YAAY;AAAA,EAC9B;AACF;AAgBO,MAAM,iCAA6B;AAAA,EACxC,CAAC,UAA6C,CAAC,MAC7C,CAAC,KAAK,UAAU;AACd,UAAM,UAAU,IAAI,UAAkB,SAAS;AAC/C,UAAM,aAAa,IAAI,iBAAiB;AAAA,MACtC,QAAQ;AAAA,QACN,WAAW,IAAI,IAAI,WAAW;AAAA,QAC9B,kBAAkB,IAAI,IAAI,kBAAkB;AAAA,QAC5C,UAAU,IAAI,IAAI,UAAU;AAAA,MAC9B;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL,CAAC,EAAE,cAAc;AAEjB,QAAI,OAAO;AACT,YAAM,SAAS,IAAI,UAAU;AAC7B,aAAO,OAAO,IAAI,eAAe,UAAU;AAAA,IAC7C;AAEA,WAAO;AAAA,EACT;AACJ;","names":[]}