jimpex 7.0.2 → 9.0.0

package/dist/index.d.mts

@@ -0,0 +1,46 @@
+export { H as Controller, C as ControllerConnectFn, I as ControllerCreator, F as ControllerCreatorFn, a2 as ControllerLike, O as ControllerProvider, Q as ControllerProviderCreator, M as ControllerProviderCreatorFn, K as ControllerProviderRegisterFn, E as EventPayload, l as Events, J as Jimpex, m as JimpexConfigOptions, k as JimpexEventListener, b as JimpexEventName, i as JimpexEventNameLike, c as JimpexEventPayload, a as JimpexEvents, o as JimpexExpressOptions, s as JimpexHealthCheckFn, r as JimpexHealthStatus, t as JimpexOptions, p as JimpexPathOptions, f as JimpexReducerEventName, h as JimpexReducerEventPayload, e as JimpexReducerEventPayloads, g as JimpexReducerEventTarget, d as JimpexReducerEventTargets, q as JimpexServicesOptions, u as JimpexStartCallback, n as JimpexStaticsOptions, V as Middleware, R as MiddlewareConnectFn, W as MiddlewareCreator, T as MiddlewareCreatorFn, a1 as MiddlewareLike, $ as MiddlewareProvider, a0 as MiddlewareProviderCreator, Z as MiddlewareProviderCreatorFn, X as MiddlewareProviderRegisterFn, y as Provider, z as ProviderCreator, B as ProviderLike, P as ProviderRegisterFn, A as Providers, D as controller, G as controllerCreator, L as controllerProvider, N as controllerProviderCreator, j as jimpex, S as middleware, U as middlewareCreator, Y as middlewareProvider, _ as middlewareProviderCreator, v as provider, w as providerCreator, x as providers } from './index-efeb437e.js';
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './types/express.mjs';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance } from './types/http.mjs';
+export { DeepPartial, DeepReadonly, Dict, NoStringIndex } from './types/utils.mjs';
+export { PathUtils } from '@homer0/path-utils';
+export { SimpleLogger as Logger } from '@homer0/simple-logger';
+export { SimpleConfig as Config } from '@homer0/simple-config';
+export { EventsHub } from '@homer0/events-hub';
+export { ConfigController, ConfigControllerOptions, configController } from './controllers/common/config.mjs';
+export { GetHealthStatus, HealthController, HealthControllerOptions, healthController } from './controllers/common/health.mjs';
+export { AddStaticRouteOptions, StaticsController, StaticsControllerConstructorOptions, StaticsControllerCreatorOptions, StaticsControllerFile, StaticsControllerGetMiddlewaresFn, StaticsControllerOptions, StaticsControllerPathsOptions, staticsController } from './controllers/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 './controllers/utils/gateway.mjs';
+export { ErrorHandler, ErrorHandlerConstructorOptions, ErrorHandlerOptions, ErrorHandlerPartialOptions, ErrorHandlerResponseOptions, errorHandlerMiddleware } from './middlewares/common/errorHandler.mjs';
+export { ForceHTTPS, ForceHTTPSOptions, ForceHTTPSPartialOptions, forceHTTPSMiddleware } from './middlewares/common/forceHTTPS.mjs';
+export { HSTS, HSTSMiddlewareOptions, HSTSMiddlewarePartialOptions, HSTSMiddlewareSettings, hstsMiddleware } from './middlewares/common/hsts.mjs';
+export { FastHTML, FastHTMLConstructorOptions, FastHTMLMiddlewareOptions, FastHTMLOptions, fastHTMLMiddleware } from './middlewares/html/fastHTML.mjs';
+export { ShowHTML, ShowHTMLConstructorOptions, ShowHTMLMiddlewareOptions, ShowHTMLOptions, showHTMLMiddleware } from './middlewares/html/showHTML.mjs';
+export { VersionValidator, VersionValidatorConstructorOptions, VersionValidatorLatestOptions, VersionValidatorMiddlewareOptions, VersionValidatorOptions, VersionValidatorPartialOptions, VersionValidatorPopupOptions, versionValidatorMiddleware } from './middlewares/utils/versionValidator.mjs';
+export { commonServicesProvider } from './services/common/index.mjs';
+export { frontendServicesProvider } from './services/frontend/index.mjs';
+export { htmlServicesProvider } from './services/html/index.mjs';
+export { httpServicesProvider } from './services/http/index.mjs';
+export { utilsServicesProvider } from './services/utils/index.mjs';
+export { notUndefined } from './utils/fns/others.mjs';
+export { createRouteExpression, removeLeadingSlash, removeSlashes, removeTrailingSlash } from './utils/fns/routes.mjs';
+export { Statuses } from './utils/fns/statuses.mjs';
+export { escapeForRegExp } from './utils/fns/text.mjs';
+export { Express, NextFunction, Request, Response, Router } from 'express';
+export { Response as HTTPResponse } from 'node-fetch';
+export { Server as HTTPSServer } from 'https';
+export { Server as HTTPServer } from 'http';
+export { AppError, AppErrorClass, AppErrorContext, CreateAppErrorFn, appErrorProvider, createAppError } from './services/common/appError.mjs';
+export { CreateHTTPErrorFn, HTTPError, HTTPErrorClass, createHTTPError, httpErrorProvider } from './services/common/httpError.mjs';
+export { SendFile, SendFileGeneratorOptions, SendFileOptions, sendFile, sendFileProvider } from './services/common/sendFile.mjs';
+export { FrontendFs, FrontendFsOptions, frontendFsProvider } from './services/frontend/frontendFs.mjs';
+export { HTMLGenerator, HTMLGeneratorConstructorOptions, HTMLGeneratorOptions, HTMLGeneratorProviderOptions, HTMLGeneratorValuesService, htmlGeneratorProvider } from './services/html/htmlGenerator.mjs';
+export { ErrorResponse } from '@homer0/api-utils';
+export { APIClient, APIClientConfig, APIClientConstructorOptions, APIClientProviderOptions, APIClientSettings, EndpointsType, apiClientProvider } from './services/http/apiClient.mjs';
+export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFetchBody, HTTPFetchOptions, HTTPOptions, httpProvider } from './services/http/http.mjs';
+export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './services/http/responsesBuilder.mjs';
+export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, EnsureBearerTokenProviderOptions, ensureBearerTokenProvider } from './services/utils/ensureBearerToken.mjs';
+export { default as statuses } from 'statuses';
+import '@homer0/jimple';
+import 'spdy';
+import 'fs/promises';
+import '@homer0/deferred';

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+export { H as Controller, C as ControllerConnectFn, I as ControllerCreator, F as ControllerCreatorFn, a2 as ControllerLike, O as ControllerProvider, Q as ControllerProviderCreator, M as ControllerProviderCreatorFn, K as ControllerProviderRegisterFn, E as EventPayload, l as Events, J as Jimpex, m as JimpexConfigOptions, k as JimpexEventListener, b as JimpexEventName, i as JimpexEventNameLike, c as JimpexEventPayload, a as JimpexEvents, o as JimpexExpressOptions, s as JimpexHealthCheckFn, r as JimpexHealthStatus, t as JimpexOptions, p as JimpexPathOptions, f as JimpexReducerEventName, h as JimpexReducerEventPayload, e as JimpexReducerEventPayloads, g as JimpexReducerEventTarget, d as JimpexReducerEventTargets, q as JimpexServicesOptions, u as JimpexStartCallback, n as JimpexStaticsOptions, V as Middleware, R as MiddlewareConnectFn, W as MiddlewareCreator, T as MiddlewareCreatorFn, a1 as MiddlewareLike, $ as MiddlewareProvider, a0 as MiddlewareProviderCreator, Z as MiddlewareProviderCreatorFn, X as MiddlewareProviderRegisterFn, y as Provider, z as ProviderCreator, B as ProviderLike, P as ProviderRegisterFn, A as Providers, D as controller, G as controllerCreator, L as controllerProvider, N as controllerProviderCreator, j as jimpex, S as middleware, U as middlewareCreator, Y as middlewareProvider, _ as middlewareProviderCreator, v as provider, w as providerCreator, x as providers } from './index-b2a04c78.js';
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './types/express.js';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance } from './types/http.js';
+export { DeepPartial, DeepReadonly, Dict, NoStringIndex } from './types/utils.js';
+export { PathUtils } from '@homer0/path-utils';
+export { SimpleLogger as Logger } from '@homer0/simple-logger';
+export { SimpleConfig as Config } from '@homer0/simple-config';
+export { EventsHub } from '@homer0/events-hub';
+export { ConfigController, ConfigControllerOptions, configController } from './controllers/common/config.js';
+export { GetHealthStatus, HealthController, HealthControllerOptions, healthController } from './controllers/common/health.js';
+export { AddStaticRouteOptions, StaticsController, StaticsControllerConstructorOptions, StaticsControllerCreatorOptions, StaticsControllerFile, StaticsControllerGetMiddlewaresFn, StaticsControllerOptions, StaticsControllerPathsOptions, staticsController } from './controllers/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 './controllers/utils/gateway.js';
+export { ErrorHandler, ErrorHandlerConstructorOptions, ErrorHandlerOptions, ErrorHandlerPartialOptions, ErrorHandlerResponseOptions, errorHandlerMiddleware } from './middlewares/common/errorHandler.js';
+export { ForceHTTPS, ForceHTTPSOptions, ForceHTTPSPartialOptions, forceHTTPSMiddleware } from './middlewares/common/forceHTTPS.js';
+export { HSTS, HSTSMiddlewareOptions, HSTSMiddlewarePartialOptions, HSTSMiddlewareSettings, hstsMiddleware } from './middlewares/common/hsts.js';
+export { FastHTML, FastHTMLConstructorOptions, FastHTMLMiddlewareOptions, FastHTMLOptions, fastHTMLMiddleware } from './middlewares/html/fastHTML.js';
+export { ShowHTML, ShowHTMLConstructorOptions, ShowHTMLMiddlewareOptions, ShowHTMLOptions, showHTMLMiddleware } from './middlewares/html/showHTML.js';
+export { VersionValidator, VersionValidatorConstructorOptions, VersionValidatorLatestOptions, VersionValidatorMiddlewareOptions, VersionValidatorOptions, VersionValidatorPartialOptions, VersionValidatorPopupOptions, versionValidatorMiddleware } from './middlewares/utils/versionValidator.js';
+export { commonServicesProvider } from './services/common/index.js';
+export { frontendServicesProvider } from './services/frontend/index.js';
+export { htmlServicesProvider } from './services/html/index.js';
+export { httpServicesProvider } from './services/http/index.js';
+export { utilsServicesProvider } from './services/utils/index.js';
+export { notUndefined } from './utils/fns/others.js';
+export { createRouteExpression, removeLeadingSlash, removeSlashes, removeTrailingSlash } from './utils/fns/routes.js';
+export { Statuses } from './utils/fns/statuses.js';
+export { escapeForRegExp } from './utils/fns/text.js';
+export { Express, NextFunction, Request, Response, Router } from 'express';
+export { Response as HTTPResponse } from 'node-fetch';
+export { Server as HTTPSServer } from 'https';
+export { Server as HTTPServer } from 'http';
+export { AppError, AppErrorClass, AppErrorContext, CreateAppErrorFn, appErrorProvider, createAppError } from './services/common/appError.js';
+export { CreateHTTPErrorFn, HTTPError, HTTPErrorClass, createHTTPError, httpErrorProvider } from './services/common/httpError.js';
+export { SendFile, SendFileGeneratorOptions, SendFileOptions, sendFile, sendFileProvider } from './services/common/sendFile.js';
+export { FrontendFs, FrontendFsOptions, frontendFsProvider } from './services/frontend/frontendFs.js';
+export { HTMLGenerator, HTMLGeneratorConstructorOptions, HTMLGeneratorOptions, HTMLGeneratorProviderOptions, HTMLGeneratorValuesService, htmlGeneratorProvider } from './services/html/htmlGenerator.js';
+export { ErrorResponse } from '@homer0/api-utils';
+export { APIClient, APIClientConfig, APIClientConstructorOptions, APIClientProviderOptions, APIClientSettings, EndpointsType, apiClientProvider } from './services/http/apiClient.js';
+export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFetchBody, HTTPFetchOptions, HTTPOptions, httpProvider } from './services/http/http.js';
+export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './services/http/responsesBuilder.js';
+export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, EnsureBearerTokenProviderOptions, ensureBearerTokenProvider } from './services/utils/ensureBearerToken.js';
+export { default as statuses } from 'statuses';
+import '@homer0/jimple';
+import 'spdy';
+import 'fs/promises';
+import '@homer0/deferred';

package/dist/index.js

@@ -0,0 +1,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
+__reExport(src_exports, require("./app"), module.exports);
+__reExport(src_exports, require("./types"), module.exports);
+__reExport(src_exports, require("./controllers"), module.exports);
+__reExport(src_exports, require("./middlewares"), module.exports);
+__reExport(src_exports, require("./services"), module.exports);
+__reExport(src_exports, require("./utils"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./app"),
+  ...require("./types"),
+  ...require("./controllers"),
+  ...require("./middlewares"),
+  ...require("./services"),
+  ...require("./utils")
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './app';\nexport * from './types';\nexport * from './controllers';\nexport * from './middlewares';\nexport * from './services';\nexport * from './utils';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wBAAc,kBAAd;AACA,wBAAc,oBADd;AAEA,wBAAc,0BAFd;AAGA,wBAAc,0BAHd;AAIA,wBAAc,uBAJd;AAKA,wBAAc,oBALd;","names":[]}

package/dist/middlewares/common/errorHandler.d.mts

@@ -0,0 +1,132 @@
+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 { ExpressErrorHandler } from '../../types/express.mjs';
+import { SimpleLogger } from '@homer0/simple-logger';
+import { DeepPartial } from '../../types/utils.mjs';
+import { HTTPErrorClass } from '../../services/common/httpError.mjs';
+import { ResponsesBuilder } from '../../services/http/responsesBuilder.mjs';
+import 'statuses';
+import '../../types/http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'express';
+import 'node-fetch';
+import '@homer0/path-utils';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '../../services/common/appError.mjs';
+
+/**
+ * The options for the responses the middleware will create.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerResponseOptions = {
+    /**
+     * The message to show in case `showErrors` is set to `false`.
+     *
+     * @default 'Oops! Something went wrong, please try again'
+     * @prettierignore
+     */
+    message: string;
+    /**
+     * The default status code for the responses.
+     *
+     * @default 500
+     */
+    status: number;
+};
+/**
+ * The customization options for the middleware.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerOptions = {
+    /**
+     * If `false`, unknown errors will show a generic message instead of real message. And
+     * if `true`, it will not only show all kind of errors but it will also show the error
+     * stack.
+     *
+     * By "uknown errors", it means that are not `AppError` nor `HTTPError`.
+     */
+    showErrors: boolean;
+    /**
+     * The options for the default response the middleware will create.
+     */
+    response: ErrorHandlerResponseOptions;
+};
+/**
+ * A partial version of the {@link ErrorHandlerOptions}, to be used in the constructor and
+ * the middleware creator.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerPartialOptions = DeepPartial<ErrorHandlerOptions>;
+/**
+ * The options to construct a {@link ErrorHandler}.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerConstructorOptions = ErrorHandlerPartialOptions & {
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        logger: SimpleLogger;
+        responsesBuilder: ResponsesBuilder;
+        statuses: Statuses;
+        HTTPError: HTTPErrorClass;
+    };
+};
+/**
+ * Creates a middleware that handles errors and generates the responses.
+ *
+ * @group Middleware Classes
+ * @group Middlewares/ErrorHandler
+ * @prettierignore
+ */
+declare class ErrorHandler {
+    /**
+     * The service that will log the messages in the console.
+     */
+    protected readonly _logger: SimpleLogger;
+    /**
+     * The service to generate the responses.
+     */
+    protected readonly _responsesBuilder: ResponsesBuilder;
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    protected readonly _statuses: Statuses;
+    /**
+     * The Error class used by the "known errors".
+     */
+    protected readonly _HTTPError: HTTPErrorClass;
+    /**
+     * The customization options.
+     */
+    protected readonly _options: ErrorHandlerOptions;
+    /**
+     * @param options  The options to construct the class.
+     */
+    constructor({ inject: { logger, responsesBuilder, statuses, HTTPError }, ...options }: ErrorHandlerConstructorOptions);
+    /**
+     * Generates the middleware that handles the errors.
+     */
+    getMiddleware(): ExpressErrorHandler;
+    /**
+     * The handler customization options.
+     */
+    get options(): Readonly<ErrorHandlerOptions>;
+}
+/**
+ * Creates the middleware that handles errors.
+ *
+ * @group Middlewares
+ * @group Middlewares/ErrorHandler
+ */
+declare const errorHandlerMiddleware: _homer0_jimple.ResourceCreator<"middleware", "connect", (options?: ErrorHandlerPartialOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType) => ExpressErrorHandler, MiddlewareConnectFn>;
+
+export { ErrorHandler, ErrorHandlerConstructorOptions, ErrorHandlerOptions, ErrorHandlerPartialOptions, ErrorHandlerResponseOptions, errorHandlerMiddleware };

package/dist/middlewares/common/errorHandler.d.ts

@@ -0,0 +1,132 @@
+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 { ExpressErrorHandler } from '../../types/express.js';
+import { SimpleLogger } from '@homer0/simple-logger';
+import { DeepPartial } from '../../types/utils.js';
+import { HTTPErrorClass } from '../../services/common/httpError.js';
+import { ResponsesBuilder } from '../../services/http/responsesBuilder.js';
+import 'statuses';
+import '../../types/http.js';
+import 'https';
+import 'http';
+import 'spdy';
+import 'express';
+import 'node-fetch';
+import '@homer0/path-utils';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '../../services/common/appError.js';
+
+/**
+ * The options for the responses the middleware will create.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerResponseOptions = {
+    /**
+     * The message to show in case `showErrors` is set to `false`.
+     *
+     * @default 'Oops! Something went wrong, please try again'
+     * @prettierignore
+     */
+    message: string;
+    /**
+     * The default status code for the responses.
+     *
+     * @default 500
+     */
+    status: number;
+};
+/**
+ * The customization options for the middleware.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerOptions = {
+    /**
+     * If `false`, unknown errors will show a generic message instead of real message. And
+     * if `true`, it will not only show all kind of errors but it will also show the error
+     * stack.
+     *
+     * By "uknown errors", it means that are not `AppError` nor `HTTPError`.
+     */
+    showErrors: boolean;
+    /**
+     * The options for the default response the middleware will create.
+     */
+    response: ErrorHandlerResponseOptions;
+};
+/**
+ * A partial version of the {@link ErrorHandlerOptions}, to be used in the constructor and
+ * the middleware creator.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerPartialOptions = DeepPartial<ErrorHandlerOptions>;
+/**
+ * The options to construct a {@link ErrorHandler}.
+ *
+ * @group Middlewares/ErrorHandler
+ */
+type ErrorHandlerConstructorOptions = ErrorHandlerPartialOptions & {
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        logger: SimpleLogger;
+        responsesBuilder: ResponsesBuilder;
+        statuses: Statuses;
+        HTTPError: HTTPErrorClass;
+    };
+};
+/**
+ * Creates a middleware that handles errors and generates the responses.
+ *
+ * @group Middleware Classes
+ * @group Middlewares/ErrorHandler
+ * @prettierignore
+ */
+declare class ErrorHandler {
+    /**
+     * The service that will log the messages in the console.
+     */
+    protected readonly _logger: SimpleLogger;
+    /**
+     * The service to generate the responses.
+     */
+    protected readonly _responsesBuilder: ResponsesBuilder;
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    protected readonly _statuses: Statuses;
+    /**
+     * The Error class used by the "known errors".
+     */
+    protected readonly _HTTPError: HTTPErrorClass;
+    /**
+     * The customization options.
+     */
+    protected readonly _options: ErrorHandlerOptions;
+    /**
+     * @param options  The options to construct the class.
+     */
+    constructor({ inject: { logger, responsesBuilder, statuses, HTTPError }, ...options }: ErrorHandlerConstructorOptions);
+    /**
+     * Generates the middleware that handles the errors.
+     */
+    getMiddleware(): ExpressErrorHandler;
+    /**
+     * The handler customization options.
+     */
+    get options(): Readonly<ErrorHandlerOptions>;
+}
+/**
+ * Creates the middleware that handles errors.
+ *
+ * @group Middlewares
+ * @group Middlewares/ErrorHandler
+ */
+declare const errorHandlerMiddleware: _homer0_jimple.ResourceCreator<"middleware", "connect", (options?: ErrorHandlerPartialOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType) => ExpressErrorHandler, MiddlewareConnectFn>;
+
+export { ErrorHandler, ErrorHandlerConstructorOptions, ErrorHandlerOptions, ErrorHandlerPartialOptions, ErrorHandlerResponseOptions, errorHandlerMiddleware };

package/dist/middlewares/common/errorHandler.js

@@ -0,0 +1,143 @@
+"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 errorHandler_exports = {};
+__export(errorHandler_exports, {
+  ErrorHandler: () => ErrorHandler,
+  errorHandlerMiddleware: () => errorHandlerMiddleware
+});
+module.exports = __toCommonJS(errorHandler_exports);
+var import_deep_assign = require("@homer0/deep-assign");
+var import_utils = require("../../utils");
+var import_services = require("../../services");
+class ErrorHandler {
+  /**
+   * @param options  The options to construct the class.
+   */
+  constructor({
+    inject: { logger, responsesBuilder, statuses, HTTPError },
+    ...options
+  }) {
+    /**
+     * The service that will log the messages in the console.
+     */
+    __publicField(this, "_logger");
+    /**
+     * The service to generate the responses.
+     */
+    __publicField(this, "_responsesBuilder");
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    __publicField(this, "_statuses");
+    /**
+     * The Error class used by the "known errors".
+     */
+    __publicField(this, "_HTTPError");
+    /**
+     * The customization options.
+     */
+    __publicField(this, "_options");
+    this._logger = logger;
+    this._responsesBuilder = responsesBuilder;
+    this._statuses = statuses;
+    this._HTTPError = HTTPError;
+    this._options = (0, import_deep_assign.deepAssignWithOverwrite)(
+      {
+        showErrors: false,
+        response: {
+          message: "Unexpected error",
+          status: this._statuses("internal server error")
+        }
+      },
+      options
+    );
+  }
+  /**
+   * Generates the middleware that handles the errors.
+   */
+  getMiddleware() {
+    return (err, _, res, next) => {
+      if (!err) {
+        next();
+        return;
+      }
+      const { response, showErrors } = this._options;
+      let { status } = response;
+      let data = {
+        error: true,
+        message: response.message
+      };
+      const knownError = err instanceof import_services.AppError;
+      if (showErrors || knownError) {
+        data.message = err.message;
+        if (knownError) {
+          data = {
+            ...data,
+            ...err.getResponse()
+          };
+          status = err.status || this._statuses("bad request");
+        }
+        if (showErrors && err instanceof Error && err.stack) {
+          const stack = err.stack.split("\n").map((line) => line.trim());
+          data.stack = stack;
+          stack.splice(0, 1);
+          this._logger.error(`ERROR: ${err.message}`);
+          this._logger.info(stack);
+        }
+      }
+      this._responsesBuilder.json({
+        res,
+        data,
+        status
+      });
+    };
+  }
+  /**
+   * The handler customization options.
+   */
+  get options() {
+    return (0, import_deep_assign.deepAssignWithOverwrite)({}, this._options);
+  }
+}
+const errorHandlerMiddleware = (0, import_utils.middlewareCreator)(
+  (options = {}) => (app) => {
+    const showErrors = app.getConfig("debug.showErrors") === true;
+    return new ErrorHandler({
+      inject: {
+        logger: app.get("logger"),
+        responsesBuilder: app.get("responsesBuilder"),
+        statuses: app.get("statuses"),
+        HTTPError: app.get("HTTPError")
+      },
+      showErrors,
+      ...options
+    }).getMiddleware();
+  }
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ErrorHandler,
+  errorHandlerMiddleware
+});
+//# sourceMappingURL=errorHandler.js.map

package/dist/middlewares/common/errorHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/middlewares/common/errorHandler.ts"],"sourcesContent":["import { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport { middlewareCreator, type Statuses } from '../../utils';\nimport type { DeepPartial, Logger, ExpressErrorHandler } from '../../types';\nimport { AppError, type HTTPErrorClass, type ResponsesBuilder } from '../../services';\n/**\n * The options for the responses the middleware will create.\n *\n * @group Middlewares/ErrorHandler\n */\nexport type ErrorHandlerResponseOptions = {\n  /**\n   * The message to show in case `showErrors` is set to `false`.\n   *\n   * @default 'Oops! Something went wrong, please try again'\n   * @prettierignore\n   */\n  message: string;\n  /**\n   * The default status code for the responses.\n   *\n   * @default 500\n   */\n  status: number;\n};\n/**\n * The customization options for the middleware.\n *\n * @group Middlewares/ErrorHandler\n */\nexport type ErrorHandlerOptions = {\n  /**\n   * If `false`, unknown errors will show a generic message instead of real message. And\n   * if `true`, it will not only show all kind of errors but it will also show the error\n   * stack.\n   *\n   * By \"uknown errors\", it means that are not `AppError` nor `HTTPError`.\n   */\n  showErrors: boolean;\n  /**\n   * The options for the default response the middleware will create.\n   */\n  response: ErrorHandlerResponseOptions;\n};\n/**\n * A partial version of the {@link ErrorHandlerOptions}, to be used in the constructor and\n * the middleware creator.\n *\n * @group Middlewares/ErrorHandler\n */\nexport type ErrorHandlerPartialOptions = DeepPartial<ErrorHandlerOptions>;\n/**\n * The options to construct a {@link ErrorHandler}.\n *\n * @group Middlewares/ErrorHandler\n */\nexport type ErrorHandlerConstructorOptions = ErrorHandlerPartialOptions & {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    logger: Logger;\n    responsesBuilder: ResponsesBuilder;\n    statuses: Statuses;\n    HTTPError: HTTPErrorClass;\n  };\n};\n/**\n * Creates a middleware that handles errors and generates the responses.\n *\n * @group Middleware Classes\n * @group Middlewares/ErrorHandler\n * @prettierignore\n */\nexport class ErrorHandler {\n  /**\n   * The service that will log the messages in the console.\n   */\n  protected readonly _logger: Logger;\n  /**\n   * The service to generate the responses.\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 Error class used by the \"known errors\".\n   */\n  protected readonly _HTTPError: HTTPErrorClass;\n  /**\n   * The customization options.\n   */\n  protected readonly _options: ErrorHandlerOptions;\n  /**\n   * @param options  The options to construct the class.\n   */\n  constructor({\n    inject: { logger, responsesBuilder, statuses, HTTPError },\n    ...options\n  }: ErrorHandlerConstructorOptions) {\n    this._logger = logger;\n    this._responsesBuilder = responsesBuilder;\n    this._statuses = statuses;\n    this._HTTPError = HTTPError;\n    this._options = deepAssignWithOverwrite(\n      {\n        showErrors: false,\n        response: {\n          message: 'Unexpected error',\n          status: this._statuses('internal server error'),\n        },\n      },\n      options,\n    );\n  }\n  /**\n   * Generates the middleware that handles the errors.\n   */\n  getMiddleware(): ExpressErrorHandler {\n    return (err, _, res, next) => {\n      // If there wasn't any error, continue the execution.\n      if (!err) {\n        next();\n        return;\n      }\n\n      const { response, showErrors } = this._options;\n\n      // Define the base status and response.\n      let { status } = response;\n      let data: {\n        error: boolean;\n        message: string;\n        stack?: string[];\n      } & Record<string, unknown> = {\n        error: true,\n        message: response.message,\n      };\n\n      const knownError = err instanceof AppError;\n      // If it's a \"known error\" or the `showErrors` flag is set to `true`...\n      if (showErrors || knownError) {\n        // Get the real message.\n        data.message = err.message;\n        // If it's a \"known error\"...\n        if (knownError) {\n          // Try to extract information for the response.\n          data = {\n            ...data,\n            ...err.getResponse(),\n          };\n          status = err.status || (this._statuses('bad request') as number);\n        }\n        /**\n         * If the flag is set to `true`, and it's a \"valid error\", try to extract the\n         * stack, format it, and include it in the response.\n         */\n        if (showErrors && err instanceof Error && err.stack) {\n          const stack = err.stack.split('\\n').map((line) => line.trim());\n          data.stack = stack;\n          stack.splice(0, 1);\n          this._logger.error(`ERROR: ${err.message}`);\n          this._logger.info(stack);\n        }\n      }\n\n      this._responsesBuilder.json({\n        res,\n        data,\n        status,\n      });\n    };\n  }\n  /**\n   * The handler customization options.\n   */\n  get options(): Readonly<ErrorHandlerOptions> {\n    return deepAssignWithOverwrite({}, this._options);\n  }\n}\n/**\n * Creates the middleware that handles errors.\n *\n * @group Middlewares\n * @group Middlewares/ErrorHandler\n */\nexport const errorHandlerMiddleware = middlewareCreator(\n  (options: ErrorHandlerPartialOptions = {}) =>\n    (app) => {\n      const showErrors = app.getConfig<boolean | undefined>('debug.showErrors') === true;\n      return new ErrorHandler({\n        inject: {\n          logger: app.get('logger'),\n          responsesBuilder: app.get('responsesBuilder'),\n          statuses: app.get('statuses'),\n          HTTPError: app.get('HTTPError'),\n        },\n        showErrors,\n        ...options,\n      }).getMiddleware();\n    },\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwC;AACxC,mBAAiD;AAEjD,sBAAqE;AAsE9D,MAAM,aAAa;AAAA;AAAA;AAAA;AAAA,EAwBxB,YAAY;AAAA,IACV,QAAQ,EAAE,QAAQ,kBAAkB,UAAU,UAAU;AAAA,IACxD,GAAG;AAAA,EACL,GAAmC;AAvBnC;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAQjB,SAAK,UAAU;AACf,SAAK,oBAAoB;AACzB,SAAK,YAAY;AACjB,SAAK,aAAa;AAClB,SAAK,eAAW;AAAA,MACd;AAAA,QACE,YAAY;AAAA,QACZ,UAAU;AAAA,UACR,SAAS;AAAA,UACT,QAAQ,KAAK,UAAU,uBAAuB;AAAA,QAChD;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAIA,gBAAqC;AACnC,WAAO,CAAC,KAAK,GAAG,KAAK,SAAS;AAE5B,UAAI,CAAC,KAAK;AACR,aAAK;AACL;AAAA,MACF;AAEA,YAAM,EAAE,UAAU,WAAW,IAAI,KAAK;AAGtC,UAAI,EAAE,OAAO,IAAI;AACjB,UAAI,OAI0B;AAAA,QAC5B,OAAO;AAAA,QACP,SAAS,SAAS;AAAA,MACpB;AAEA,YAAM,aAAa,eAAe;AAElC,UAAI,cAAc,YAAY;AAE5B,aAAK,UAAU,IAAI;AAEnB,YAAI,YAAY;AAEd,iBAAO;AAAA,YACL,GAAG;AAAA,YACH,GAAG,IAAI,YAAY;AAAA,UACrB;AACA,mBAAS,IAAI,UAAW,KAAK,UAAU,aAAa;AAAA,QACtD;AAKA,YAAI,cAAc,eAAe,SAAS,IAAI,OAAO;AACnD,gBAAM,QAAQ,IAAI,MAAM,MAAM,IAAI,EAAE,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC;AAC7D,eAAK,QAAQ;AACb,gBAAM,OAAO,GAAG,CAAC;AACjB,eAAK,QAAQ,MAAM,UAAU,IAAI,OAAO,EAAE;AAC1C,eAAK,QAAQ,KAAK,KAAK;AAAA,QACzB;AAAA,MACF;AAEA,WAAK,kBAAkB,KAAK;AAAA,QAC1B;AAAA,QACA;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAIA,IAAI,UAAyC;AAC3C,eAAO,4CAAwB,CAAC,GAAG,KAAK,QAAQ;AAAA,EAClD;AACF;AAOO,MAAM,6BAAyB;AAAA,EACpC,CAAC,UAAsC,CAAC,MACtC,CAAC,QAAQ;AACP,UAAM,aAAa,IAAI,UAA+B,kBAAkB,MAAM;AAC9E,WAAO,IAAI,aAAa;AAAA,MACtB,QAAQ;AAAA,QACN,QAAQ,IAAI,IAAI,QAAQ;AAAA,QACxB,kBAAkB,IAAI,IAAI,kBAAkB;AAAA,QAC5C,UAAU,IAAI,IAAI,UAAU;AAAA,QAC5B,WAAW,IAAI,IAAI,WAAW;AAAA,MAChC;AAAA,MACA;AAAA,MACA,GAAG;AAAA,IACL,CAAC,EAAE,cAAc;AAAA,EACnB;AACJ;","names":[]}

package/dist/middlewares/common/forceHTTPS.d.mts

@@ -0,0 +1,69 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex, R as MiddlewareConnectFn } from '../../index-efeb437e.js';
+import { ExpressMiddleware } from '../../types/express.mjs';
+import '../../types/http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'express';
+import 'node-fetch';
+import '../../types/utils.mjs';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+
+/**
+ * The customization options for the middleware.
+ *
+ * @group Middlewares/ForceHTTPS
+ */
+type ForceHTTPSOptions = {
+    /**
+     * A list of regular expressions to match routes that should be ignored.
+     *
+     * @default [/^\/service\//]
+     */
+    ignoredRoutes: RegExp[];
+};
+/**
+ * A partial version of the {@link ForceHTTPSOptions}, to be used in the constructor and
+ * the middleware creator.
+ *
+ * @group Middlewares/ForceHTTPS
+ */
+type ForceHTTPSPartialOptions = Partial<ForceHTTPSOptions>;
+/**
+ * Creates a middleware that forces all the traffic to be through HTTPS.
+ *
+ * @group Middleware Classes
+ * @group Middlewares/ForceHTTPS
+ * @prettierignore
+ */
+declare class ForceHTTPS {
+    /**
+     * The customization options.
+     */
+    protected readonly _options: ForceHTTPSOptions;
+    /**
+     * @param options  The options to construct the class.
+     */
+    constructor(options?: ForceHTTPSPartialOptions);
+    /**
+     * Generates the middleware that redirects the traffic.
+     */
+    getMiddleware(): ExpressMiddleware;
+    /**
+     * The customization options.
+     */
+    get options(): Readonly<ForceHTTPSOptions>;
+}
+/**
+ * Creates the middleware that redirects the traffic to HTTPS.
+ *
+ * @group Middlewares
+ * @group Middlewares/ForceHTTPS
+ */
+declare const forceHTTPSMiddleware: _homer0_jimple.ResourceCreator<"middleware", "connect", (options?: ForceHTTPSPartialOptions) => <ContainerType extends Jimpex = Jimpex>(app: ContainerType) => ExpressMiddleware | undefined, MiddlewareConnectFn>;
+
+export { ForceHTTPS, ForceHTTPSOptions, ForceHTTPSPartialOptions, forceHTTPSMiddleware };