jimpex 8.0.0 → 9.0.0

package/dist/controllers/common/statics.d.mts

@@ -0,0 +1,215 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex, a1 as MiddlewareLike, C as ControllerConnectFn } from '../../index-efeb437e.js';
+import { RouterMethod, ExpressMiddleware } from '../../types/express.mjs';
+import { DeepPartial } from '../../types/utils.mjs';
+import { SendFile } from '../../services/common/sendFile.mjs';
+import { Router } from 'express';
+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';
+
+/**
+ * The definition for each file the controller handles.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerFile = {
+    /**
+     * The route, relative to the controller root, to the file.
+     */
+    route: string;
+    /**
+     * The path to the file in the filesystem. Since the file is served using the
+     * {@link SendFile} service, whether the file is relative to the project root or the
+     * application executable depends on how the service is configured (relative to the
+     * executable by default).
+     */
+    path: string;
+    /**
+     * A dictionary of headers for the response.
+     */
+    headers?: Record<string, string>;
+};
+/**
+ * These are like "master paths" that get prepended to all the file paths and routes the
+ * controller use.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerPathsOptions = {
+    /**
+     * A custom route to prefix all the file routes with.
+     */
+    route: string;
+    /**
+     * A custom path to prefix all the file paths with.
+     */
+    source: string;
+};
+/**
+ * The options to customize the controller.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerOptions = {
+    /**
+     * A list of filenames, or definitions for the files to handle.
+     */
+    files: Array<string | StaticsControllerFile>;
+    /**
+     * A dictionary with the allowed router (HTTP) methods the controller can use to serve
+     * the files. If `all` is set to `true`, the rest of the values will be ignored.
+     *
+     * @default {get: true, all: false}
+     */
+    methods: Partial<Record<RouterMethod, boolean>>;
+    /**
+     * The "master paths" the controller can use to prefix the file paths and routes.
+     *
+     * @default {route: '', source: './',}
+     */
+    paths: StaticsControllerPathsOptions;
+};
+/**
+ * The options to construct a {@link StaticsController}.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerConstructorOptions = DeepPartial<StaticsControllerOptions> & {
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        sendFile: SendFile;
+    };
+};
+/**
+ * A function to generate a list of middlewares that can be executed before the tontroller
+ * main middleware.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerGetMiddlewaresFn = (app: Jimpex) => MiddlewareLike[];
+/**
+ * The options for the controller creator that mounts {@link StaticsController}.
+ *
+ * @group Controllers/Statics
+ */
+type StaticsControllerCreatorOptions = DeepPartial<StaticsControllerOptions> & {
+    /**
+     * A function to generate a list of middlewares that can be executed before the
+     * tontroller main middleware.
+     */
+    getMiddlewares?: StaticsControllerGetMiddlewaresFn;
+};
+/**
+ * The options for {@link StaticsController._addRoute}.
+ *
+ * @access protected
+ * @group Controllers/Statics
+ */
+type AddStaticRouteOptions = {
+    /**
+     * The reference for the router in which the middlewares will be added.
+     */
+    router: Router;
+    /**
+     * The router method in which the middlewares will be added.
+     */
+    method: RouterMethod;
+    /**
+     * The definition of the file to serve.
+     */
+    file: StaticsControllerFile;
+    /**
+     * The middleware created by {@link StaticsController}, that will serve the file.
+     */
+    fileMiddleware: ExpressMiddleware;
+    /**
+     * A list of extra middlewares to execute before the file middleware.
+     */
+    middlewares: ExpressMiddleware[];
+};
+/**
+ * The controller class that allows the application to serve specific files from any
+ * folder to any route without the need of mounting directories as "static".
+ *
+ * @group Controller Classes
+ * @group Controllers/Statics
+ * @prettierignore
+ */
+declare class StaticsController {
+    /**
+     * The service that serves static files.
+     */
+    protected readonly _sendFile: SendFile;
+    /**
+     * The controller customization options.
+     */
+    protected _options: StaticsControllerOptions;
+    /**
+     * A dictionary with the formatted definitions of the files that will be served.
+     * It uses the files' routes as keys, for easy access in the middleware.
+     */
+    protected files: Record<string, StaticsControllerFile>;
+    /**
+     * @param options  The options to construct the controller.
+     */
+    constructor({ inject, ...options }: StaticsControllerConstructorOptions);
+    /**
+     * Mounts the middlewares in the router in order to serve the files.
+     *
+     * @param router       A reference to the application router.
+     * @param middlewares  A list of extra middlewares to execute before the file
+     *                     middleware.
+     */
+    addRoutes(router: Router, middlewares?: ExpressMiddleware[]): Router;
+    /**
+     * The controller options.
+     */
+    get options(): Readonly<StaticsControllerOptions>;
+    /**
+     * Generates the middleware that will serve the file.
+     *
+     * @param file  The definition of the file to serve.
+     */
+    protected _getMiddleware(file: StaticsControllerFile): ExpressMiddleware;
+    /**
+     * Mounts the middleware(s) for a file in the router.
+     *
+     * @param options  The information of the file and how it needs to be added.
+     */
+    protected _addRoute({ router, method, file, fileMiddleware, middlewares, }: AddStaticRouteOptions): void;
+    /**
+     * Validates and formats the options sent to the constructor in order to get the final
+     * set that will be stored in the controller.
+     *
+     * @param options  The options to validate.
+     * @throws If no files are specified.
+     * @throws If methods is not defined.
+     * @throws If no methods are enabled.
+     * @throws If there's an invalid HTTP method.
+     */
+    protected _validateOptions(options: StaticsControllerOptions): StaticsControllerOptions;
+    /**
+     * Parses the files received from the constructor's options, and formats them into
+     * proper definitions the controller can use.
+     */
+    protected _createFiles(): Record<string, StaticsControllerFile>;
+}
+/**
+ * A controller that allows the application to server specific files from any folder to
+ * any route without the need of mounting directories as "static" folders.
+ *
+ * @group Controllers
+ * @group Controllers/Statics
+ */
+declare const staticsController: _homer0_jimple.ResourceCreator<"controller", "connect", ({ getMiddlewares, ...options }?: StaticsControllerCreatorOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType) => Router, ControllerConnectFn>;
+
+export { AddStaticRouteOptions, StaticsController, StaticsControllerConstructorOptions, StaticsControllerCreatorOptions, StaticsControllerFile, StaticsControllerGetMiddlewaresFn, StaticsControllerOptions, StaticsControllerPathsOptions, staticsController };

package/dist/controllers/common/statics.d.ts

@@ -1,18 +1,18 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex, a1 as MiddlewareLike, C as ControllerConnectFn } from '../../jimpex-7eaee271.js';
+import { J as Jimpex, a1 as MiddlewareLike, C as ControllerConnectFn } from '../../index-b2a04c78.js';
 import { RouterMethod, ExpressMiddleware } from '../../types/express.js';
 import { DeepPartial } from '../../types/utils.js';
 import { SendFile } from '../../services/common/sendFile.js';
 import { Router } from 'express';
-import '@homer0/events-hub';
 import '../../types/http.js';
 import 'https';
 import 'http';
 import 'spdy';
 import 'node-fetch';
-import '@homer0/simple-config';
-import '@homer0/simple-logger';
 import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
 
 /**
  * The definition for each file the controller handles.

package/dist/controllers/common/statics.js

@@ -19,6 +19,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -38,9 +42,22 @@ var mime = __toESM(require("mime"));
 var import_deep_assign = require("@homer0/deep-assign");
 var import_utils = require("../../utils");
 class StaticsController {
+  /**
+   * @param options  The options to construct the controller.
+   */
   constructor({ inject, ...options }) {
+    /**
+     * The service that serves static files.
+     */
     __publicField(this, "_sendFile");
+    /**
+     * The controller customization options.
+     */
     __publicField(this, "_options");
+    /**
+     * A dictionary with the formatted definitions of the files that will be served.
+     * It uses the files' routes as keys, for easy access in the middleware.
+     */
     __publicField(this, "files");
     this._sendFile = inject.sendFile;
     this._options = this._validateOptions(
@@ -61,6 +78,13 @@ class StaticsController {
     );
     this.files = this._createFiles();
   }
+  /**
+   * Mounts the middlewares in the router in order to serve the files.
+   *
+   * @param router       A reference to the application router.
+   * @param middlewares  A list of extra middlewares to execute before the file
+   *                     middleware.
+   */
   addRoutes(router, middlewares = []) {
     const { methods } = this._options;
     const use = methods.all ? ["all"] : Object.keys(methods).reduce((acc, name) => {
@@ -79,9 +103,17 @@ class StaticsController {
     });
     return router;
   }
+  /**
+   * The controller options.
+   */
   get options() {
     return { ...this._options };
   }
+  /**
+   * Generates the middleware that will serve the file.
+   *
+   * @param file  The definition of the file to serve.
+   */
   _getMiddleware(file) {
     return (_, res, next) => {
       const extension = path.parse(file.path).ext.substring(1);
@@ -99,6 +131,11 @@ class StaticsController {
       });
     };
   }
+  /**
+   * Mounts the middleware(s) for a file in the router.
+   *
+   * @param options  The information of the file and how it needs to be added.
+   */
   _addRoute({
     router,
     method,
@@ -109,6 +146,16 @@ class StaticsController {
     const { route } = file;
     router[method](route, [...middlewares, fileMiddleware]);
   }
+  /**
+   * Validates and formats the options sent to the constructor in order to get the final
+   * set that will be stored in the controller.
+   *
+   * @param options  The options to validate.
+   * @throws If no files are specified.
+   * @throws If methods is not defined.
+   * @throws If no methods are enabled.
+   * @throws If there's an invalid HTTP method.
+   */
   _validateOptions(options) {
     if (!options.files || !options.files.length) {
       throw new Error("You need to specify a list of files");
@@ -148,6 +195,10 @@ class StaticsController {
       methods: newMethods
     };
   }
+  /**
+   * Parses the files received from the constructor's options, and formats them into
+   * proper definitions the controller can use.
+   */
   _createFiles() {
     const { files, paths } = this._options;
     const routePath = (0, import_utils.removeSlashes)(paths.route, false, true);

package/dist/controllers/common/statics.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/controllers/common/statics.ts"],"sourcesContent":["import * as path from 'path';\nimport * as mime from 'mime';\nimport { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport {\n  controllerCreator,\n  removeSlashes,\n  notUndefined,\n  type MiddlewareLike,\n} from '../../utils';\nimport type { SendFile } from '../../services';\nimport type { Jimpex } from '../../app';\nimport type { DeepPartial, ExpressMiddleware, Router, RouterMethod } from '../../types';\n/**\n * The definition for each file the controller handles.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerFile = {\n  /**\n   * The route, relative to the controller root, to the file.\n   */\n  route: string;\n  /**\n   * The path to the file in the filesystem. Since the file is served using the\n   * {@link SendFile} service, whether the file is relative to the project root or the\n   * application executable depends on how the service is configured (relative to the\n   * executable by default).\n   */\n  path: string;\n  /**\n   * A dictionary of headers for the response.\n   */\n  headers?: Record<string, string>;\n};\n/**\n * These are like \"master paths\" that get prepended to all the file paths and routes the\n * controller use.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerPathsOptions = {\n  /**\n   * A custom route to prefix all the file routes with.\n   */\n  route: string;\n  /**\n   * A custom path to prefix all the file paths with.\n   */\n  source: string;\n};\n/**\n * The options to customize the controller.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerOptions = {\n  /**\n   * A list of filenames, or definitions for the files to handle.\n   */\n  files: Array<string | StaticsControllerFile>;\n  /**\n   * A dictionary with the allowed router (HTTP) methods the controller can use to serve\n   * the files. If `all` is set to `true`, the rest of the values will be ignored.\n   *\n   * @default {get: true, all: false}\n   */\n  methods: Partial<Record<RouterMethod, boolean>>;\n  /**\n   * The \"master paths\" the controller can use to prefix the file paths and routes.\n   *\n   * @default {route: '', source: './',}\n   */\n  paths: StaticsControllerPathsOptions;\n};\n/**\n * The options to construct a {@link StaticsController}.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerConstructorOptions =\n  DeepPartial<StaticsControllerOptions> & {\n    /**\n     * A dictionary with the dependencies to inject.\n     */\n    inject: {\n      sendFile: SendFile;\n    };\n  };\n/**\n * A function to generate a list of middlewares that can be executed before the tontroller\n * main middleware.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerGetMiddlewaresFn = (app: Jimpex) => MiddlewareLike[];\n/**\n * The options for the controller creator that mounts {@link StaticsController}.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerCreatorOptions = DeepPartial<StaticsControllerOptions> & {\n  /**\n   * A function to generate a list of middlewares that can be executed before the\n   * tontroller main middleware.\n   */\n  getMiddlewares?: StaticsControllerGetMiddlewaresFn;\n};\n/**\n * The options for {@link StaticsController._addRoute}.\n *\n * @access protected\n * @group Controllers/Statics\n */\nexport type AddStaticRouteOptions = {\n  /**\n   * The reference for the router in which the middlewares will be added.\n   */\n  router: Router;\n  /**\n   * The router method in which the middlewares will be added.\n   */\n  method: RouterMethod;\n  /**\n   * The definition of the file to serve.\n   */\n  file: StaticsControllerFile;\n  /**\n   * The middleware created by {@link StaticsController}, that will serve the file.\n   */\n  fileMiddleware: ExpressMiddleware;\n  /**\n   * A list of extra middlewares to execute before the file middleware.\n   */\n  middlewares: ExpressMiddleware[];\n};\n\n/**\n * The controller class that allows the application to serve specific files from any\n * folder to any route without the need of mounting directories as \"static\".\n *\n * @group Controller Classes\n * @group Controllers/Statics\n * @prettierignore\n */\nexport class StaticsController {\n  /**\n   * The service that serves static files.\n   */\n  protected readonly _sendFile: SendFile;\n  /**\n   * The controller customization options.\n   */\n  protected _options: StaticsControllerOptions;\n  /**\n   * A dictionary with the formatted definitions of the files that will be served.\n   * It uses the files' routes as keys, for easy access in the middleware.\n   */\n  protected files: Record<string, StaticsControllerFile>;\n  /**\n   * @param options  The options to construct the controller.\n   */\n  constructor({ inject, ...options }: StaticsControllerConstructorOptions) {\n    this._sendFile = inject.sendFile;\n    this._options = this._validateOptions(\n      deepAssignWithOverwrite(\n        {\n          files: ['favicon.ico', 'index.html'],\n          methods: options.methods || {\n            all: false,\n            get: true,\n          },\n          paths: {\n            route: '',\n            source: './',\n          },\n        },\n        options,\n      ),\n    );\n    this.files = this._createFiles();\n  }\n  /**\n   * Mounts the middlewares in the router in order to serve the files.\n   *\n   * @param router       A reference to the application router.\n   * @param middlewares  A list of extra middlewares to execute before the file\n   *                     middleware.\n   */\n  addRoutes(router: Router, middlewares: ExpressMiddleware[] = []): Router {\n    const { methods } = this._options;\n    const use: RouterMethod[] = methods.all\n      ? ['all']\n      : Object.keys(methods).reduce<RouterMethod[]>((acc, name) => {\n          const methodName = name as RouterMethod;\n          if (methods[methodName]) {\n            acc.push(methodName);\n          }\n\n          return acc;\n        }, []);\n\n    Object.keys(this.files).forEach((route) => {\n      const file = this.files[route as keyof typeof this.files]!;\n      const fileMiddleware = this._getMiddleware(file);\n      use.forEach((method) =>\n        this._addRoute({ router, method, file, fileMiddleware, middlewares }),\n      );\n    });\n\n    return router;\n  }\n  /**\n   * The controller options.\n   */\n  get options(): Readonly<StaticsControllerOptions> {\n    return { ...this._options };\n  }\n  /**\n   * Generates the middleware that will serve the file.\n   *\n   * @param file  The definition of the file to serve.\n   */\n  protected _getMiddleware(file: StaticsControllerFile): ExpressMiddleware {\n    return (_, res, next) => {\n      const extension = path.parse(file.path).ext.substring(1);\n      const headers = {\n        'Content-Type': mime.getType(extension) || 'text/html',\n        ...file.headers,\n      };\n\n      Object.entries(headers).forEach(([key, value]) => {\n        res.setHeader(key, value);\n      });\n\n      this._sendFile({\n        res,\n        filepath: file.path,\n        next,\n      });\n    };\n  }\n  /**\n   * Mounts the middleware(s) for a file in the router.\n   *\n   * @param options  The information of the file and how it needs to be added.\n   */\n  protected _addRoute({\n    router,\n    method,\n    file,\n    fileMiddleware,\n    middlewares,\n  }: AddStaticRouteOptions): void {\n    const { route } = file;\n    router[method](route, [...middlewares, fileMiddleware]);\n  }\n  /**\n   * Validates and formats the options sent to the constructor in order to get the final\n   * set that will be stored in the controller.\n   *\n   * @param options  The options to validate.\n   * @throws If no files are specified.\n   * @throws If methods is not defined.\n   * @throws If no methods are enabled.\n   * @throws If there's an invalid HTTP method.\n   */\n  protected _validateOptions(\n    options: StaticsControllerOptions,\n  ): StaticsControllerOptions {\n    if (!options.files || !options.files.length) {\n      throw new Error('You need to specify a list of files');\n    }\n\n    if (!options.methods) {\n      throw new Error('You need to specify which HTTP methods are allowed for the files');\n    }\n\n    const methods = Object.keys(options.methods) as RouterMethod[];\n\n    const atLeastOne = methods.some((method) => options.methods[method]);\n    if (!atLeastOne) {\n      throw new Error('You need to enable at least one HTTP method to serve the files');\n    }\n\n    const allowedMethods: RouterMethod[] = [\n      'all',\n      'get',\n      'head',\n      'post',\n      'patch',\n      'put',\n      'delete',\n      'connect',\n      'options',\n      'trace',\n    ];\n\n    const invalid = methods.find(\n      (method) => !allowedMethods.includes(method.toLowerCase() as RouterMethod),\n    );\n\n    if (invalid) {\n      throw new Error(`${invalid} is not a valid HTTP method`);\n    }\n\n    const newMethods = methods.reduce<Record<string, boolean>>((acc, method) => {\n      acc[method.toLowerCase()] = !!options.methods[method];\n      return acc;\n    }, {});\n\n    return {\n      ...options,\n      methods: newMethods,\n    };\n  }\n  /**\n   * Parses the files received from the constructor's options, and formats them into\n   * proper definitions the controller can use.\n   */\n  protected _createFiles(): Record<string, StaticsControllerFile> {\n    const { files, paths } = this._options;\n    const routePath = removeSlashes(paths.route, false, true);\n    return files.reduce<Record<string, StaticsControllerFile>>((acc, file) => {\n      let src;\n      let route;\n      let headers;\n      if (typeof file === 'object') {\n        ({ route, path: src, headers } = file);\n      } else {\n        src = file;\n        route = file;\n      }\n\n      src = path.join(paths.source, src);\n      route = removeSlashes(route, true, false);\n      route = `${routePath}/${route}`;\n      acc[route] = {\n        path: src,\n        route,\n        headers: headers || {},\n      };\n\n      return acc;\n    }, {});\n  }\n}\n/**\n * A controller that allows the application to server specific files from any folder to\n * any route without the need of mounting directories as \"static\" folders.\n *\n * @group Controllers\n * @group Controllers/Statics\n */\nexport const staticsController = controllerCreator(\n  ({ getMiddlewares, ...options }: StaticsControllerCreatorOptions = {}) =>\n    (app) => {\n      const router = app.getRouter();\n      const ctrl = new StaticsController({\n        inject: {\n          sendFile: app.get('sendFile'),\n        },\n        ...options,\n      });\n\n      let useMiddlewares: ExpressMiddleware[] | undefined;\n      if (getMiddlewares) {\n        useMiddlewares = getMiddlewares(app)\n          .map((middleware) => {\n            if ('middleware' in middleware) {\n              return middleware.connect(app) as ExpressMiddleware | undefined;\n            }\n\n            return middleware as ExpressMiddleware;\n          })\n          .filter(notUndefined);\n      }\n\n      return ctrl.addRoutes(router, useMiddlewares);\n    },\n);\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/controllers/common/statics.ts"],"sourcesContent":["import * as path from 'path';\nimport * as mime from 'mime';\nimport { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport {\n  controllerCreator,\n  removeSlashes,\n  notUndefined,\n  type MiddlewareLike,\n} from '../../utils';\nimport type { SendFile } from '../../services';\nimport type { Jimpex } from '../../app';\nimport type { DeepPartial, ExpressMiddleware, Router, RouterMethod } from '../../types';\n/**\n * The definition for each file the controller handles.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerFile = {\n  /**\n   * The route, relative to the controller root, to the file.\n   */\n  route: string;\n  /**\n   * The path to the file in the filesystem. Since the file is served using the\n   * {@link SendFile} service, whether the file is relative to the project root or the\n   * application executable depends on how the service is configured (relative to the\n   * executable by default).\n   */\n  path: string;\n  /**\n   * A dictionary of headers for the response.\n   */\n  headers?: Record<string, string>;\n};\n/**\n * These are like \"master paths\" that get prepended to all the file paths and routes the\n * controller use.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerPathsOptions = {\n  /**\n   * A custom route to prefix all the file routes with.\n   */\n  route: string;\n  /**\n   * A custom path to prefix all the file paths with.\n   */\n  source: string;\n};\n/**\n * The options to customize the controller.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerOptions = {\n  /**\n   * A list of filenames, or definitions for the files to handle.\n   */\n  files: Array<string | StaticsControllerFile>;\n  /**\n   * A dictionary with the allowed router (HTTP) methods the controller can use to serve\n   * the files. If `all` is set to `true`, the rest of the values will be ignored.\n   *\n   * @default {get: true, all: false}\n   */\n  methods: Partial<Record<RouterMethod, boolean>>;\n  /**\n   * The \"master paths\" the controller can use to prefix the file paths and routes.\n   *\n   * @default {route: '', source: './',}\n   */\n  paths: StaticsControllerPathsOptions;\n};\n/**\n * The options to construct a {@link StaticsController}.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerConstructorOptions =\n  DeepPartial<StaticsControllerOptions> & {\n    /**\n     * A dictionary with the dependencies to inject.\n     */\n    inject: {\n      sendFile: SendFile;\n    };\n  };\n/**\n * A function to generate a list of middlewares that can be executed before the tontroller\n * main middleware.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerGetMiddlewaresFn = (app: Jimpex) => MiddlewareLike[];\n/**\n * The options for the controller creator that mounts {@link StaticsController}.\n *\n * @group Controllers/Statics\n */\nexport type StaticsControllerCreatorOptions = DeepPartial<StaticsControllerOptions> & {\n  /**\n   * A function to generate a list of middlewares that can be executed before the\n   * tontroller main middleware.\n   */\n  getMiddlewares?: StaticsControllerGetMiddlewaresFn;\n};\n/**\n * The options for {@link StaticsController._addRoute}.\n *\n * @access protected\n * @group Controllers/Statics\n */\nexport type AddStaticRouteOptions = {\n  /**\n   * The reference for the router in which the middlewares will be added.\n   */\n  router: Router;\n  /**\n   * The router method in which the middlewares will be added.\n   */\n  method: RouterMethod;\n  /**\n   * The definition of the file to serve.\n   */\n  file: StaticsControllerFile;\n  /**\n   * The middleware created by {@link StaticsController}, that will serve the file.\n   */\n  fileMiddleware: ExpressMiddleware;\n  /**\n   * A list of extra middlewares to execute before the file middleware.\n   */\n  middlewares: ExpressMiddleware[];\n};\n\n/**\n * The controller class that allows the application to serve specific files from any\n * folder to any route without the need of mounting directories as \"static\".\n *\n * @group Controller Classes\n * @group Controllers/Statics\n * @prettierignore\n */\nexport class StaticsController {\n  /**\n   * The service that serves static files.\n   */\n  protected readonly _sendFile: SendFile;\n  /**\n   * The controller customization options.\n   */\n  protected _options: StaticsControllerOptions;\n  /**\n   * A dictionary with the formatted definitions of the files that will be served.\n   * It uses the files' routes as keys, for easy access in the middleware.\n   */\n  protected files: Record<string, StaticsControllerFile>;\n  /**\n   * @param options  The options to construct the controller.\n   */\n  constructor({ inject, ...options }: StaticsControllerConstructorOptions) {\n    this._sendFile = inject.sendFile;\n    this._options = this._validateOptions(\n      deepAssignWithOverwrite(\n        {\n          files: ['favicon.ico', 'index.html'],\n          methods: options.methods || {\n            all: false,\n            get: true,\n          },\n          paths: {\n            route: '',\n            source: './',\n          },\n        },\n        options,\n      ),\n    );\n    this.files = this._createFiles();\n  }\n  /**\n   * Mounts the middlewares in the router in order to serve the files.\n   *\n   * @param router       A reference to the application router.\n   * @param middlewares  A list of extra middlewares to execute before the file\n   *                     middleware.\n   */\n  addRoutes(router: Router, middlewares: ExpressMiddleware[] = []): Router {\n    const { methods } = this._options;\n    const use: RouterMethod[] = methods.all\n      ? ['all']\n      : Object.keys(methods).reduce<RouterMethod[]>((acc, name) => {\n          const methodName = name as RouterMethod;\n          if (methods[methodName]) {\n            acc.push(methodName);\n          }\n\n          return acc;\n        }, []);\n\n    Object.keys(this.files).forEach((route) => {\n      const file = this.files[route as keyof typeof this.files]!;\n      const fileMiddleware = this._getMiddleware(file);\n      use.forEach((method) =>\n        this._addRoute({ router, method, file, fileMiddleware, middlewares }),\n      );\n    });\n\n    return router;\n  }\n  /**\n   * The controller options.\n   */\n  get options(): Readonly<StaticsControllerOptions> {\n    return { ...this._options };\n  }\n  /**\n   * Generates the middleware that will serve the file.\n   *\n   * @param file  The definition of the file to serve.\n   */\n  protected _getMiddleware(file: StaticsControllerFile): ExpressMiddleware {\n    return (_, res, next) => {\n      const extension = path.parse(file.path).ext.substring(1);\n      const headers = {\n        'Content-Type': mime.getType(extension) || 'text/html',\n        ...file.headers,\n      };\n\n      Object.entries(headers).forEach(([key, value]) => {\n        res.setHeader(key, value);\n      });\n\n      this._sendFile({\n        res,\n        filepath: file.path,\n        next,\n      });\n    };\n  }\n  /**\n   * Mounts the middleware(s) for a file in the router.\n   *\n   * @param options  The information of the file and how it needs to be added.\n   */\n  protected _addRoute({\n    router,\n    method,\n    file,\n    fileMiddleware,\n    middlewares,\n  }: AddStaticRouteOptions): void {\n    const { route } = file;\n    router[method](route, [...middlewares, fileMiddleware]);\n  }\n  /**\n   * Validates and formats the options sent to the constructor in order to get the final\n   * set that will be stored in the controller.\n   *\n   * @param options  The options to validate.\n   * @throws If no files are specified.\n   * @throws If methods is not defined.\n   * @throws If no methods are enabled.\n   * @throws If there's an invalid HTTP method.\n   */\n  protected _validateOptions(\n    options: StaticsControllerOptions,\n  ): StaticsControllerOptions {\n    if (!options.files || !options.files.length) {\n      throw new Error('You need to specify a list of files');\n    }\n\n    if (!options.methods) {\n      throw new Error('You need to specify which HTTP methods are allowed for the files');\n    }\n\n    const methods = Object.keys(options.methods) as RouterMethod[];\n\n    const atLeastOne = methods.some((method) => options.methods[method]);\n    if (!atLeastOne) {\n      throw new Error('You need to enable at least one HTTP method to serve the files');\n    }\n\n    const allowedMethods: RouterMethod[] = [\n      'all',\n      'get',\n      'head',\n      'post',\n      'patch',\n      'put',\n      'delete',\n      'connect',\n      'options',\n      'trace',\n    ];\n\n    const invalid = methods.find(\n      (method) => !allowedMethods.includes(method.toLowerCase() as RouterMethod),\n    );\n\n    if (invalid) {\n      throw new Error(`${invalid} is not a valid HTTP method`);\n    }\n\n    const newMethods = methods.reduce<Record<string, boolean>>((acc, method) => {\n      acc[method.toLowerCase()] = !!options.methods[method];\n      return acc;\n    }, {});\n\n    return {\n      ...options,\n      methods: newMethods,\n    };\n  }\n  /**\n   * Parses the files received from the constructor's options, and formats them into\n   * proper definitions the controller can use.\n   */\n  protected _createFiles(): Record<string, StaticsControllerFile> {\n    const { files, paths } = this._options;\n    const routePath = removeSlashes(paths.route, false, true);\n    return files.reduce<Record<string, StaticsControllerFile>>((acc, file) => {\n      let src;\n      let route;\n      let headers;\n      if (typeof file === 'object') {\n        ({ route, path: src, headers } = file);\n      } else {\n        src = file;\n        route = file;\n      }\n\n      src = path.join(paths.source, src);\n      route = removeSlashes(route, true, false);\n      route = `${routePath}/${route}`;\n      acc[route] = {\n        path: src,\n        route,\n        headers: headers || {},\n      };\n\n      return acc;\n    }, {});\n  }\n}\n/**\n * A controller that allows the application to server specific files from any folder to\n * any route without the need of mounting directories as \"static\" folders.\n *\n * @group Controllers\n * @group Controllers/Statics\n */\nexport const staticsController = controllerCreator(\n  ({ getMiddlewares, ...options }: StaticsControllerCreatorOptions = {}) =>\n    (app) => {\n      const router = app.getRouter();\n      const ctrl = new StaticsController({\n        inject: {\n          sendFile: app.get('sendFile'),\n        },\n        ...options,\n      });\n\n      let useMiddlewares: ExpressMiddleware[] | undefined;\n      if (getMiddlewares) {\n        useMiddlewares = getMiddlewares(app)\n          .map((middleware) => {\n            if ('middleware' in middleware) {\n              return middleware.connect(app) as ExpressMiddleware | undefined;\n            }\n\n            return middleware as ExpressMiddleware;\n          })\n          .filter(notUndefined);\n      }\n\n      return ctrl.addRoutes(router, useMiddlewares);\n    },\n);\n"],"mappings":"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","names":[]}

package/dist/controllers/index.d.mts

@@ -0,0 +1,24 @@
+export { ConfigController, ConfigControllerOptions, configController } from './common/config.mjs';
+export { GetHealthStatus, HealthController, HealthControllerOptions, healthController } from './common/health.mjs';
+export { AddStaticRouteOptions, StaticsController, StaticsControllerConstructorOptions, StaticsControllerCreatorOptions, StaticsControllerFile, StaticsControllerGetMiddlewaresFn, StaticsControllerOptions, StaticsControllerPathsOptions, staticsController } from './common/statics.mjs';
+export { AddGatewayRouteOptions, GatewayConfig, GatewayConfigEndpointDefinition, GatewayConfigEndpointProps, GatewayConfigEndpoints, GatewayController, GatewayControllerAPIConfig, GatewayControllerAPIConfigOptions, GatewayControllerConstructorOptions, GatewayControllerCreatorOptions, GatewayControllerEndpointInfo, GatewayControllerExtraOptions, GatewayControllerGetMiddlewaresFn, GatewayControllerHeaderOptions, GatewayControllerHelperOptions, GatewayControllerOptions, GatewayControllerRequest, GatewayControllerRoute, GatewayControllerRouteMethod, GatewayHelperService, GatewayHelperServiceBaseFnOptions, GatewayHelperServiceErrorHandler, GatewayHelperServiceErrorHandlerOptions, GatewayHelperServiceRequestReducer, GatewayHelperServiceRequestReducerOptions, GatewayHelperServiceResponseHandler, GatewayHelperServiceResponseReducer, GatewayHelperServiceResponseReducerOptions, GatewayHelperServiceStreamVerification, gatewayController } from './utils/gateway.mjs';
+import '@homer0/jimple';
+import '../index-efeb437e.js';
+import '../types/express.mjs';
+import 'express';
+import '../types/http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import '../types/utils.mjs';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '../services/http/responsesBuilder.mjs';
+import '../utils/fns/statuses.mjs';
+import 'statuses';
+import '../services/common/sendFile.mjs';
+import '@homer0/api-utils';
+import '../services/http/http.mjs';

package/dist/controllers/index.d.ts

@@ -3,8 +3,7 @@ export { GetHealthStatus, HealthController, HealthControllerOptions, healthContr
 export { AddStaticRouteOptions, StaticsController, StaticsControllerConstructorOptions, StaticsControllerCreatorOptions, StaticsControllerFile, StaticsControllerGetMiddlewaresFn, StaticsControllerOptions, StaticsControllerPathsOptions, staticsController } from './common/statics.js';
 export { AddGatewayRouteOptions, GatewayConfig, GatewayConfigEndpointDefinition, GatewayConfigEndpointProps, GatewayConfigEndpoints, GatewayController, GatewayControllerAPIConfig, GatewayControllerAPIConfigOptions, GatewayControllerConstructorOptions, GatewayControllerCreatorOptions, GatewayControllerEndpointInfo, GatewayControllerExtraOptions, GatewayControllerGetMiddlewaresFn, GatewayControllerHeaderOptions, GatewayControllerHelperOptions, GatewayControllerOptions, GatewayControllerRequest, GatewayControllerRoute, GatewayControllerRouteMethod, GatewayHelperService, GatewayHelperServiceBaseFnOptions, GatewayHelperServiceErrorHandler, GatewayHelperServiceErrorHandlerOptions, GatewayHelperServiceRequestReducer, GatewayHelperServiceRequestReducerOptions, GatewayHelperServiceResponseHandler, GatewayHelperServiceResponseReducer, GatewayHelperServiceResponseReducerOptions, GatewayHelperServiceStreamVerification, gatewayController } from './utils/gateway.js';
 import '@homer0/jimple';
-import '../jimpex-7eaee271.js';
-import '@homer0/events-hub';
+import '../index-b2a04c78.js';
 import '../types/express.js';
 import 'express';
 import '../types/http.js';
@@ -12,13 +11,14 @@ import 'https';
 import 'http';
 import 'spdy';
 import 'node-fetch';
-import '@homer0/simple-config';
 import '../types/utils.js';
+import '@homer0/path-utils';
 import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
 import '../services/http/responsesBuilder.js';
 import '../utils/fns/statuses.js';
 import 'statuses';
 import '../services/common/sendFile.js';
-import '@homer0/path-utils';
 import '@homer0/api-utils';
 import '../services/http/http.js';

package/dist/controllers/index.js

@@ -17,4 +17,9 @@ var controllers_exports = {};
 module.exports = __toCommonJS(controllers_exports);
 __reExport(controllers_exports, require("./common"), module.exports);
 __reExport(controllers_exports, require("./utils"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./common"),
+  ...require("./utils")
+});
 //# sourceMappingURL=index.js.map