jimpex 7.0.2 → 8.0.0

package/dist/services/utils/ensureBearerToken.js

@@ -0,0 +1,105 @@
+"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 ensureBearerToken_exports = {};
+__export(ensureBearerToken_exports, {
+  EnsureBearerToken: () => EnsureBearerToken,
+  ensureBearerTokenProvider: () => ensureBearerTokenProvider
+});
+module.exports = __toCommonJS(ensureBearerToken_exports);
+var import_deep_assign = require("@homer0/deep-assign");
+var import_utils = require("../../utils");
+class EnsureBearerToken {
+  constructor({
+    inject: { HTTPError, statuses },
+    ...options
+  }) {
+    __publicField(this, "_HTTPError");
+    __publicField(this, "_options");
+    this._HTTPError = HTTPError;
+    this._options = (0, import_deep_assign.deepAssignWithOverwrite)(
+      {
+        error: {
+          message: "Unauthorized",
+          status: statuses("unauthorized"),
+          response: {}
+        },
+        expression: /bearer (.*?)(?:$|\s)/i,
+        local: "token"
+      },
+      options
+    );
+  }
+  getMiddleware() {
+    return (req, res, next) => {
+      let unauthorized = true;
+      const {
+        headers: { authorization }
+      } = req;
+      if (authorization) {
+        const matches = this._options.expression.exec(authorization);
+        if (matches) {
+          const [, token] = matches;
+          res.locals[this._options.local] = token;
+          unauthorized = false;
+        }
+      }
+      if (unauthorized) {
+        const {
+          error: { message, status, response }
+        } = this._options;
+        next(
+          new this._HTTPError(message, status, {
+            response
+          })
+        );
+      } else {
+        next();
+      }
+    };
+  }
+  get options() {
+    return (0, import_deep_assign.deepAssignWithOverwrite)({}, this._options);
+  }
+}
+const ensureBearerTokenProvider = (0, import_utils.providerCreator)(
+  (options = {}) => (app) => {
+    const { serviceName = "ensureBearerToken", ...rest } = options;
+    app.set(
+      serviceName,
+      () => new EnsureBearerToken({
+        inject: {
+          HTTPError: app.get("HTTPError"),
+          statuses: app.get("statuses")
+        },
+        ...rest
+      }).getMiddleware()
+    );
+  }
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EnsureBearerToken,
+  ensureBearerTokenProvider
+});
+//# sourceMappingURL=ensureBearerToken.js.map

package/dist/services/utils/ensureBearerToken.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/utils/ensureBearerToken.ts"],"sourcesContent":["import { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport { providerCreator, type Statuses } from '../../utils';\nimport type { HTTPErrorClass } from '../common';\nimport type { DeepPartial, ExpressMiddleware } from '../../types';\n/**\n * The options for the error the middleare can generate.\n *\n * @group Services/EnsureBearerToken\n */\nexport type EnsureBearerTokenErrorOptions = {\n  /**\n   * The error message for the response.\n   *\n   * @default 'Unauthorized'\n   */\n  message: string;\n  /**\n   * The HTTP status that will be added to the error context.\n   *\n   * @default 401\n   */\n  status: number;\n  /**\n   * Context information for the error handler and that can be added to the actual\n   * response.\n   */\n  response: unknown;\n};\n/**\n * The options to customize the service/middleware.\n *\n * @group Services/EnsureBearerToken\n */\nexport type EnsureBearerTokenOptions = {\n  error: EnsureBearerTokenErrorOptions;\n  expression: RegExp;\n  local: string;\n};\n/**\n * The options to construct a {@link EnsureBearerToken}.\n *\n * @group Services/EnsureBearerToken\n */\nexport type EnsureBearerConstructorOptions = DeepPartial<EnsureBearerTokenOptions> & {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    HTTPError: HTTPErrorClass;\n    statuses: Statuses;\n  };\n};\n/**\n * Custom options for the provider that will register an instance of\n * {@link EnsureBearerToken}\n * as a service.\n *\n * @group Services/EnsureBearerToken\n */\nexport type EnsureBearerTokenProviderOptions = DeepPartial<EnsureBearerTokenOptions> & {\n  /**\n   * The name that will be used to register the service on the container. This is to allow\n   * multiple \"instances\" of the service to be created.\n   *\n   * @default 'ensureBearerToken'\n   */\n  serviceName?: string;\n};\n/**\n * This service gives you a middleware that verifies if a request has an `Authorization`\n * header with a bearer token; if it does, the token will be saved on the `res.locals`,\n * otherwise, it will generate an error.\n *\n * This is a \"service middleware\" to allow certain flexibility: you can have controllers\n * where some routes are protected and others are not. For those cases, you get the\n * service from the container, and include it only in the routes that need it.\n *\n * @group Services\n * @group Services/EnsureBearerToken\n */\nexport class EnsureBearerToken {\n  /**\n   * To generate the errors when the validation fails.\n   */\n  protected readonly _HTTPError: HTTPErrorClass;\n  /**\n   * The customization options for the service.\n   */\n  protected readonly _options: EnsureBearerTokenOptions;\n  /**\n   * @param options  The options to construct the class.\n   */\n  constructor({\n    inject: { HTTPError, statuses },\n    ...options\n  }: EnsureBearerConstructorOptions) {\n    this._HTTPError = HTTPError;\n    this._options = deepAssignWithOverwrite(\n      {\n        error: {\n          message: 'Unauthorized',\n          status: statuses('unauthorized'),\n          response: {},\n        },\n        expression: /bearer (.*?)(?:$|\\s)/i,\n        local: 'token',\n      },\n      options,\n    );\n  }\n  /**\n   * Generates the middleware that verifies if a request has an `Authorization` header\n   * with a bearer token.\n   */\n  getMiddleware(): ExpressMiddleware {\n    return (req, res, next) => {\n      let unauthorized = true;\n      const {\n        headers: { authorization },\n      } = req;\n      if (authorization) {\n        const matches = this._options.expression.exec(authorization);\n        if (matches) {\n          const [, token] = matches;\n          res.locals[this._options.local] = token;\n          unauthorized = false;\n        }\n      }\n\n      if (unauthorized) {\n        const {\n          error: { message, status, response },\n        } = this._options;\n        next(\n          new this._HTTPError(message, status, {\n            response,\n          }),\n        );\n      } else {\n        next();\n      }\n    };\n  }\n  /**\n   * The customization options.\n   */\n  get options(): Readonly<EnsureBearerTokenOptions> {\n    return deepAssignWithOverwrite({}, this._options);\n  }\n}\n/**\n * Generates a \"service middleware\" that can be used on route controllers in order to\n * validate the presence of a bearer token on the requests authorization header.\n *\n * The registered service is an instance of {@link EnsureBearerToken}, and it uses the key\n * `ensureBearerToken`.\n *\n * Since it's a \"provider creator\", when registering it, you can pass custom options.\n *\n * @example\n *\n * <caption>Basic usage</caption>\n *\n *   // Register it on the container\n *   container.register(ensureBearerTokenProvider);\n *\n *   // Let's assume we are in a controller now...\n *   // Getting access to the middleware.\n *   const ensureBearerToken = container.get<ExpressMiddleware>('ensureBearerToken');\n *\n * @example\n *\n * <caption>Customizing the service</caption>\n *\n *   // Register it on the container\n *   container.register(\n *     ensureBearerTokenProvider({\n *       serviceName: 'ensureBearerTokenCustom',\n *       error: {\n *         message: 'Missing token!',\n *       },\n *     }),\n *   );\n *\n * @group Providers\n * @group Services/EnsureBearerToken\n */\nexport const ensureBearerTokenProvider = providerCreator(\n  (options: EnsureBearerTokenProviderOptions = {}) =>\n    (app) => {\n      const { serviceName = 'ensureBearerToken', ...rest } = options;\n      app.set(serviceName, () =>\n        new EnsureBearerToken({\n          inject: {\n            HTTPError: app.get('HTTPError'),\n            statuses: app.get('statuses'),\n          },\n          ...rest,\n        }).getMiddleware(),\n      );\n    },\n);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAwC;AACxC,mBAA+C;AA+ExC,MAAM,kBAAkB;AAAA,EAY7B,YAAY;AAAA,IACV,QAAQ,EAAE,WAAW,SAAS;AAAA,OAC3B;AAAA,EACL,GAAmC;AAXnC,wBAAmB;AAInB,wBAAmB;AAQjB,SAAK,aAAa;AAClB,SAAK,eAAW;AAAA,MACd;AAAA,QACE,OAAO;AAAA,UACL,SAAS;AAAA,UACT,QAAQ,SAAS,cAAc;AAAA,UAC/B,UAAU,CAAC;AAAA,QACb;AAAA,QACA,YAAY;AAAA,QACZ,OAAO;AAAA,MACT;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAAA,EAKA,gBAAmC;AACjC,WAAO,CAAC,KAAK,KAAK,SAAS;AACzB,UAAI,eAAe;AACnB,YAAM;AAAA,QACJ,SAAS,EAAE,cAAc;AAAA,MAC3B,IAAI;AACJ,UAAI,eAAe;AACjB,cAAM,UAAU,KAAK,SAAS,WAAW,KAAK,aAAa;AAC3D,YAAI,SAAS;AACX,gBAAM,CAAC,EAAE,KAAK,IAAI;AAClB,cAAI,OAAO,KAAK,SAAS,SAAS;AAClC,yBAAe;AAAA,QACjB;AAAA,MACF;AAEA,UAAI,cAAc;AAChB,cAAM;AAAA,UACJ,OAAO,EAAE,SAAS,QAAQ,SAAS;AAAA,QACrC,IAAI,KAAK;AACT;AAAA,UACE,IAAI,KAAK,WAAW,SAAS,QAAQ;AAAA,YACnC;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF,OAAO;AACL,aAAK;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA,EAIA,IAAI,UAA8C;AAChD,eAAO,4CAAwB,CAAC,GAAG,KAAK,QAAQ;AAAA,EAClD;AACF;AAsCO,MAAM,gCAA4B;AAAA,EACvC,CAAC,UAA4C,CAAC,MAC5C,CAAC,QAAQ;AACP,UAAM,EAAE,cAAc,wBAAwB,KAAK,IAAI;AACvD,QAAI;AAAA,MAAI;AAAA,MAAa,MACnB,IAAI,kBAAkB;AAAA,QACpB,QAAQ;AAAA,UACN,WAAW,IAAI,IAAI,WAAW;AAAA,UAC9B,UAAU,IAAI,IAAI,UAAU;AAAA,QAC9B;AAAA,QACA,GAAG;AAAA,MACL,CAAC,EAAE,cAAc;AAAA,IACnB;AAAA,EACF;AACJ;","names":[]}

package/dist/services/utils/index.d.ts

@@ -0,0 +1,43 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex } from '../../jimpex-7eaee271.js';
+import { EnsureBearerTokenProviderOptions } from './ensureBearerToken.js';
+export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, ensureBearerTokenProvider } from './ensureBearerToken.js';
+import '@homer0/events-hub';
+import '../../types/express.js';
+import 'express';
+import '../../types/http.js';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import '@homer0/simple-config';
+import '../../types/utils.js';
+import '@homer0/simple-logger';
+import '../../utils/fns/statuses.js';
+import 'statuses';
+import '../common/httpError.js';
+import '../common/appError.js';
+
+/**
+ * Registers all the utility services on the container.
+ *
+ * - {@link EnsureBearerToken | ensureBearerToken}
+ *
+ * @example
+ *
+ *   // Register the collection on the container
+ *   container.register(utilsServicesProvider);
+ *   // Getting access to one the services instance
+ *   const ensureBearerToken = container.get<EnsureBearerToken>('ensureBearerToken');
+ *
+ * @group Providers
+ */
+declare const utilsServicesProvider: {
+    ensureBearerTokenProvider: _homer0_jimple.ResourceCreator<"provider", "register", (options?: EnsureBearerTokenProviderOptions) => (app: Jimpex) => void, _homer0_jimple.ProviderRegisterFn<Jimpex>>;
+} & Record<string, _homer0_jimple.Resource<"provider", "register", _homer0_jimple.ProviderRegisterFn<Jimpex>>> & {
+    provider: true;
+} & {
+    register: _homer0_jimple.ProviderRegisterFn<Jimpex>;
+} & Record<string, unknown>;
+
+export { EnsureBearerTokenProviderOptions, utilsServicesProvider };

package/dist/services/utils/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+__export(utils_exports, {
+  utilsServicesProvider: () => utilsServicesProvider
+});
+module.exports = __toCommonJS(utils_exports);
+var import_utils = require("../../utils");
+var import_ensureBearerToken = require("./ensureBearerToken");
+__reExport(utils_exports, require("./ensureBearerToken"), module.exports);
+const utilsServicesProvider = (0, import_utils.providers)({
+  ensureBearerTokenProvider: import_ensureBearerToken.ensureBearerTokenProvider
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  utilsServicesProvider
+});
+//# sourceMappingURL=index.js.map

package/dist/services/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/utils/index.ts"],"sourcesContent":["import { providers } from '../../utils';\nimport { ensureBearerTokenProvider } from './ensureBearerToken';\n/**\n * Registers all the utility services on the container.\n *\n * - {@link EnsureBearerToken | ensureBearerToken}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(utilsServicesProvider);\n *   // Getting access to one the services instance\n *   const ensureBearerToken = container.get<EnsureBearerToken>('ensureBearerToken');\n *\n * @group Providers\n */\nexport const utilsServicesProvider = providers({\n  ensureBearerTokenProvider,\n});\n\nexport * from './ensureBearerToken';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;AAC1B,+BAA0C;AAmB1C,0BAAc,gCApBd;AAgBO,MAAM,4BAAwB,wBAAU;AAAA,EAC7C;AACF,CAAC;","names":[]}

package/dist/types/events.d.ts

@@ -0,0 +1,13 @@
+import './express.js';
+export { E as EventPayload, l as Events, k as JimpexEventListener, b as JimpexEventName, i as JimpexEventNameLike, c as JimpexEventPayload, a as JimpexEvents, f as JimpexReducerEventName, h as JimpexReducerEventPayload, e as JimpexReducerEventPayloads, g as JimpexReducerEventTarget, d as JimpexReducerEventTargets } from '../jimpex-7eaee271.js';
+import 'express';
+import '@homer0/jimple';
+import '@homer0/events-hub';
+import './http.js';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import '@homer0/simple-config';
+import './utils.js';
+import '@homer0/simple-logger';

package/dist/types/events.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var events_exports = {};
+module.exports = __toCommonJS(events_exports);
+//# sourceMappingURL=events.js.map

package/dist/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/events.ts"],"sourcesContent":["import type { Router, ExpressMiddlewareLike } from './express';\nimport type { Controller, Middleware } from '../utils';\nimport type { Jimpex } from '../app/jimpex';\n/**\n * The base payload the events emitted by the application send.\n *\n * @template T  Extra properties beside the reference to the application.\n * @group Services/Events\n */\nexport type EventPayload<T = Record<string, unknown>> = {\n  /**\n   * A reference to the application.\n   */\n  app: Jimpex;\n} & T;\n/**\n * A dictionary with the events emitted by the application and their payloads.\n *\n * @group Services/Events\n */\nexport interface JimpexEvents {\n  /**\n   * Called right before creating the server and calling `listen` on it.\n   */\n  beforeStart: EventPayload;\n  /**\n   * Called once the server confirmed that is listening.\n   */\n  start: EventPayload;\n  /**\n   * Called after the controllers and middlewares have been mounted.\n   */\n  afterStart: EventPayload;\n  /**\n   * Called after the `onStart` callback has been called.\n   */\n  afterStartCallback: EventPayload;\n  /**\n   * Called before closing the server instance.\n   */\n  beforeStop: EventPayload;\n  /**\n   * Called after the server instance has been closed.\n   */\n  afterStop: EventPayload;\n  /**\n   * Called every time a new route is mounted in the application.\n   */\n  routeAdded: EventPayload<{ route: string }>;\n}\n/**\n * The events emitted by the application.\n *\n * @group Services/Events\n */\nexport type JimpexEventName = keyof JimpexEvents;\n/**\n * The type of the payload sent by a specific event.\n *\n * @template EventName  The literal type of the event, to obtain the type of the\n *                      payload.\n * @group Services/Events\n */\nexport type JimpexEventPayload<EventName extends JimpexEventName> =\n  JimpexEvents[EventName];\n/**\n * A dictionary of the reducer events and their targets.\n *\n * @group Services/Events\n */\nexport interface JimpexReducerEventTargets {\n  /**\n   * It gets called before mounting a router/middleware for a specific route.\n   */\n  controllerWillBeMounted: Router | ExpressMiddlewareLike;\n  /**\n   * It gets called before using a middleware without route.\n   */\n  middlewareWillBeUsed: ExpressMiddlewareLike;\n}\n/**\n * A dictionary of the payloads the reducer events the application uses.\n *\n * @group Services/Events\n */\nexport interface JimpexReducerEventPayloads {\n  /**\n   * It gets called before mounting a router/middleware for a specific route.\n   */\n  controllerWillBeMounted: EventPayload<{\n    /**\n     * The route in which the controller will be mounted.\n     */\n    route: string;\n    /**\n     * A reference for the controller/middleware before being \"connected\".\n     */\n    controller: Controller | Middleware;\n  }>;\n  /**\n   * It gets called before using a middleware without route.\n   */\n  middlewareWillBeUsed: EventPayload;\n}\n/**\n * The reducer events used by the application.\n *\n * @group Services/Events\n */\nexport type JimpexReducerEventName = keyof JimpexReducerEventTargets;\n/**\n * The type of the target of a specific reducer event.\n *\n * @template EventName  The literal type of the event, to obtain the type of the\n *                      target.\n * @group Services/Events\n */\nexport type JimpexReducerEventTarget<EventName extends JimpexReducerEventName> =\n  JimpexReducerEventTargets[EventName];\n/**\n * The type of the payload of a specific reducer event.\n *\n * @template EventName  The literal type of the event, to obtain the type of the\n *                      payload.\n * @group Services/Events\n */\nexport type JimpexReducerEventPayload<EventName extends JimpexReducerEventName> =\n  JimpexReducerEventPayloads[EventName];\n/**\n * The name of the events o reducer events emitted/used by the application.\n * This generic type exists because the listener for both types are added using the same\n * method.\n *\n * @group Services/Events\n */\nexport type JimpexEventNameLike = JimpexEventName | JimpexReducerEventName;\n/**\n * The definition of a listener for an event or a reducer event.\n *\n * @template EventName  The literal type of the event, to validate whether the\n *                      parameters should be for a reducer event or an event.\n * @group Services/Events\n */\nexport type JimpexEventListener<EventName extends JimpexEventNameLike> =\n  EventName extends JimpexEventName\n    ? (payload: JimpexEventPayload<EventName>) => void\n    : EventName extends JimpexReducerEventName\n    ? (\n        target: JimpexReducerEventTarget<EventName>,\n        payload: JimpexReducerEventPayload<EventName>,\n      ) => JimpexReducerEventTarget<EventName>\n    : never;\n/**\n * The `events` service Jimpex uses.\n * This is an alternative declaration of the `EventsHub` class that uses the interfaces\n * and types from this project.\n *\n * @group Services\n * @group Services/Events\n */\nexport type Events = {\n  /**\n   * Adds a new event listener.\n   *\n   * @param event     The name of the event.\n   * @param listener  The listener function.\n   * @returns An unsubscribe function to remove the listener.\n   * @template EventName  The literal type of the event, to generate the type of the\n   *                      listener.\n   * @example\n   *\n   *   const unsubscribe = events.on('afterStart', ({ app }) => {\n   *     app.getLogger().info('Hello world!');\n   *     unsubscribe();\n   *   });\n   *\n   */\n  on: <EventName extends JimpexEventNameLike>(\n    eventName: EventName,\n    listener: JimpexEventListener<EventName>,\n  ) => () => boolean;\n  /**\n   * Adds an event listener that will only be executed once.\n   *\n   * @param event     The name of the event.\n   * @param listener  The listener function.\n   * @returns An unsubscribe function to remove the listener.\n   * @template EventName  The literal type of the event, to generate the type of the\n   *                      listener.\n   * @example\n   *\n   *   events.once('afterStart', ({ app }) => {\n   *     app.getLogger().info('Hello world!');\n   *     unsubscribe();\n   *   });\n   *\n   */\n  once: <EventName extends JimpexEventNameLike>(\n    eventName: EventName,\n    listener: JimpexEventListener<EventName>,\n  ) => () => boolean;\n  /**\n   * Emits an event and call all its listeners.\n   *\n   * @param event    The name of the events.\n   * @param payload  Context information for the event.\n   * @template EventName  The literal type of the event, to generate the type of the\n   *                      payload.\n   * @example\n   *\n   *   // Extend the interface to type the payload.\n   *   interface JimpexEvents {\n   *     myEvent: { message: string };\n   *   }\n   *   // Add the listener.\n   *   events.on('myEvent', ({ message }) => {\n   *     console.log('Event received:', message);\n   *   });\n   *   // Trigger the event.\n   *   events.emit('myEvent', { message: 'Hello' });\n   *   // prints \"Event received: Hello\"\n   *\n   */\n  emit: <EventName extends JimpexEventName>(\n    event: JimpexEventName,\n    payload: JimpexEventPayload<EventName>,\n  ) => void;\n  /**\n   * Asynchronously reduces a target using an event. It's like emit, but the event\n   * listeners return a modified (or not) version of the `target`.\n   *\n   * @param event    The name of the event.\n   * @param target   The variable to reduce with the reducers/listeners.\n   * @param payload  Context information for the event.\n   * @returns A version of the `target` processed by the listeners.\n   * @template EventName  The literal type of the event, to generate the types of the\n   *                      target and the payload.\n   * @example\n   *\n   *   // Extend the interface to type the target.\n   *   interface JimpexReducerEventTargets {\n   *     myReducer: unknown[];\n   *   }\n   *   // Extend the interface to type the payload.\n   *   interface JimpexReducerEventPayloads {\n   *     myReducer: {\n   *       message: string;\n   *     };\n   *   }\n   *   // Add the reducer.\n   *   events.on('myReducer', async (target, { message }) => {\n   *     const data = await fetch('https://api.example.com/' + message);\n   *     target.push(data);\n   *     return target;\n   *   });\n   *   // Trigger the event.\n   *   const result = await events.reduce('myReducer', [], { message: 'Hello' });\n   *   // result would be a list of data fetched from the API.\n   *\n   */\n  reduce: <EventName extends JimpexReducerEventName>(\n    event: JimpexReducerEventName,\n    target: JimpexReducerEventTarget<EventName>,\n    payload: JimpexReducerEventPayload<EventName>,\n  ) => Promise<JimpexReducerEventTarget<EventName>>;\n  /**\n   * Synchronously reduces a target using an event. It's like emit, but the events\n   * listener return a modified (or not) version of the `target`.\n   *\n   * @param event    The name of the event.\n   * @param target   The variable to reduce with the reducers/listeners.\n   * @param payload  Context information for the event.\n   * @returns A version of the `target` processed by the listeners.\n   * @template EventName  The literal type of the event, to generate the types of the\n   *                      target and the payload.\n   * @example\n   *\n   *   // Extend the interface to type the target.\n   *   interface JimpexReducerEventTargets {\n   *     myReducer: string[];\n   *   }\n   *   // Extend the interface to type the payload.\n   *   interface JimpexReducerEventPayloads {\n   *     myReducer: {\n   *       message: string;\n   *     };\n   *   }\n   *   // Add the reducer.\n   *   events.on('myReducer', (target, { message }) => {\n   *     target.push(message);\n   *     return target;\n   *   });\n   *   // Trigger the event.\n   *   events.reduce('event', [], 'Hello');\n   *   // returns ['Hello']\n   *\n   */\n  reduceSync: <EventName extends JimpexReducerEventName>(\n    event: JimpexReducerEventName,\n    target: JimpexReducerEventTarget<EventName>,\n    payload: JimpexReducerEventPayload<EventName>,\n  ) => JimpexReducerEventTarget<EventName>;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/express.d.ts

@@ -0,0 +1,10 @@
+import { RequestHandler, ErrorRequestHandler } from 'express';
+export { Express, NextFunction, Request, Response, Router } from 'express';
+
+type ExpressMiddlewareLike = RequestHandler | ErrorRequestHandler;
+type ExpressMiddleware = RequestHandler;
+type AsyncExpressMiddleware = (...args: Parameters<ExpressMiddleware>) => Promise<void>;
+type ExpressErrorHandler = ErrorRequestHandler;
+type RouterMethod = 'all' | 'get' | 'head' | 'post' | 'patch' | 'put' | 'delete' | 'connect' | 'options' | 'trace';
+
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod };

package/dist/types/express.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var express_exports = {};
+module.exports = __toCommonJS(express_exports);
+//# sourceMappingURL=express.js.map

package/dist/types/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/express.ts"],"sourcesContent":["import type { RequestHandler, ErrorRequestHandler } from 'express';\n\nexport type { Express, Router, Request, Response, NextFunction } from 'express';\n\nexport type ExpressMiddlewareLike = RequestHandler | ErrorRequestHandler;\nexport type ExpressMiddleware = RequestHandler;\nexport type AsyncExpressMiddleware = (\n  ...args: Parameters<ExpressMiddleware>\n) => Promise<void>;\nexport type ExpressErrorHandler = ErrorRequestHandler;\nexport type RouterMethod =\n  | 'all'\n  | 'get'\n  | 'head'\n  | 'post'\n  | 'patch'\n  | 'put'\n  | 'delete'\n  | 'connect'\n  | 'options'\n  | 'trace';\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/http.d.ts

@@ -0,0 +1,79 @@
+import { Server } from 'https';
+export { Server as HTTPSServer } from 'https';
+import { Server as Server$1 } from 'http';
+export { Server as HTTPServer } from 'http';
+import { ServerOptions } from 'spdy';
+import { Express } from 'express';
+export { Response as HTTPResponse } from 'node-fetch';
+
+/**
+ * @group Jimpex
+ */
+type JimpexServer = Express | Server;
+/**
+ * @group Jimpex
+ */
+type JimpexServerInstance = Server$1 | Server;
+/**
+ * The paths to the SSL credentials. Depending on the application options, they can be
+ * relative to the project root, or the application executable, but they can't be
+ * absolute.
+ *
+ * @group Jimpex
+ */
+type JimpexHTTPSCredentials = {
+    /**
+     * The path to the certificate authority file.
+     */
+    ca?: string;
+    /**
+     * The path to the certificate file.
+     */
+    cert?: string;
+    /**
+     * The path to the key file.
+     */
+    key?: string;
+};
+/**
+ * The options to enable HTTP2.
+ *
+ * @group Jimpex
+ */
+type JimpexHTTP2Options = {
+    /**
+     * Whether or not to enable HTTP2.
+     */
+    enabled?: boolean;
+    /**
+     * Custom options for the Spdy server.
+     *
+     * @see {@link https://github.com/spdy-http2/node-spdy#options}
+     */
+    spdy?: ServerOptions['spdy'];
+};
+/**
+ * The options to enable HTTPS.
+ *
+ * @group Jimpex
+ */
+type JimpexHTTPSOptions = {
+    /**
+     * Whether or not to enable HTTPS.
+     */
+    enabled?: boolean;
+    /**
+     * The SSL credentials, and their location.
+     */
+    credentials?: JimpexHTTPSCredentials & {
+        /**
+         * If `true`, the credentials will be located relative to the project root, otherwise,
+         * they will be located relative to the application executable.
+         *
+         * @default false
+         */
+        onHome?: boolean;
+    };
+};
+
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance };

package/dist/types/http.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var http_exports = {};
+module.exports = __toCommonJS(http_exports);
+//# sourceMappingURL=http.js.map

package/dist/types/http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/http.ts"],"sourcesContent":["import type { Server as HTTPSServer } from 'https';\nimport type { Server as HTTPServer } from 'http';\nimport type { ServerOptions as SpdyServerOptions } from 'spdy';\nimport type { Express } from './express';\n\nexport type { Response as HTTPResponse } from 'node-fetch';\n\nexport type { HTTPSServer, HTTPServer };\n/**\n * @group Jimpex\n */\nexport type JimpexServer = Express | HTTPSServer;\n/**\n * @group Jimpex\n */\nexport type JimpexServerInstance = HTTPServer | HTTPSServer;\n/**\n * The paths to the SSL credentials. Depending on the application options, they can be\n * relative to the project root, or the application executable, but they can't be\n * absolute.\n *\n * @group Jimpex\n */\nexport type JimpexHTTPSCredentials = {\n  /**\n   * The path to the certificate authority file.\n   */\n  ca?: string;\n  /**\n   * The path to the certificate file.\n   */\n  cert?: string;\n  /**\n   * The path to the key file.\n   */\n  key?: string;\n};\n/**\n * The options to enable HTTP2.\n *\n * @group Jimpex\n */\nexport type JimpexHTTP2Options = {\n  /**\n   * Whether or not to enable HTTP2.\n   */\n  enabled?: boolean;\n  /**\n   * Custom options for the Spdy server.\n   *\n   * @see {@link https://github.com/spdy-http2/node-spdy#options}\n   */\n  spdy?: SpdyServerOptions['spdy'];\n};\n/**\n * The options to enable HTTPS.\n *\n * @group Jimpex\n */\nexport type JimpexHTTPSOptions = {\n  /**\n   * Whether or not to enable HTTPS.\n   */\n  enabled?: boolean;\n  /**\n   * The SSL credentials, and their location.\n   */\n  credentials?: JimpexHTTPSCredentials & {\n    /**\n     * If `true`, the credentials will be located relative to the project root, otherwise,\n     * they will be located relative to the application executable.\n     *\n     * @default false\n     */\n    onHome?: boolean;\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/index.d.ts

@@ -0,0 +1,14 @@
+export { E as EventPayload, l as Events, 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 } from '../jimpex-7eaee271.js';
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './express.js';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance } from './http.js';
+export { DeepPartial, DeepReadonly, Dict, NoStringIndex } from './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 { 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';
+import '@homer0/jimple';
+import 'spdy';

package/dist/types/index.js

@@ -0,0 +1,24 @@
+"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 types_exports = {};
+module.exports = __toCommonJS(types_exports);
+__reExport(types_exports, require("./events"), module.exports);
+__reExport(types_exports, require("./express"), module.exports);
+__reExport(types_exports, require("./http"), module.exports);
+__reExport(types_exports, require("./options"), module.exports);
+__reExport(types_exports, require("./utils"), module.exports);
+__reExport(types_exports, require("./wootils"), module.exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/index.ts"],"sourcesContent":["export * from './events';\nexport * from './express';\nexport * from './http';\nexport * from './options';\nexport * from './utils';\nexport * from './wootils';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,qBAAd;AACA,0BAAc,sBADd;AAEA,0BAAc,mBAFd;AAGA,0BAAc,sBAHd;AAIA,0BAAc,oBAJd;AAKA,0BAAc,sBALd;","names":[]}

package/dist/types/options.d.ts

@@ -0,0 +1,13 @@
+import '@homer0/simple-config';
+export { m as JimpexConfigOptions, o as JimpexExpressOptions, s as JimpexHealthCheckFn, r as JimpexHealthStatus, t as JimpexOptions, p as JimpexPathOptions, q as JimpexServicesOptions, u as JimpexStartCallback, n as JimpexStaticsOptions } from '../jimpex-7eaee271.js';
+import '@homer0/jimple';
+import '@homer0/events-hub';
+import './express.js';
+import 'express';
+import './http.js';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import './utils.js';
+import '@homer0/simple-logger';

package/dist/types/options.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var options_exports = {};
+module.exports = __toCommonJS(options_exports);
+//# sourceMappingURL=options.js.map

package/dist/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/options.ts"],"sourcesContent":["import type { Config } from './wootils';\nimport type { Jimpex } from '../app';\n/**\n * The options for the application's configuration service.\n *\n * @see {@link https://www.npmjs.com/package/@homer0/simple-config}\n * @group Jimpex\n */\nexport type JimpexConfigOptions = {\n  /**\n   * The default settings for the configuration. If no external configuration is used,\n   * this needs to include a `port` property.\n   */\n  default: unknown;\n  /**\n   * The name of the application, used for external configuration files.\n   *\n   * @default 'app'\n   */\n  name: string;\n  /**\n   * The path to where external configuration files are stored. Relative to the project\n   * root.\n   *\n   * @default 'config/'\n   */\n  path: string;\n  /**\n   * Whether the configuration files are inside a sub directory or not. If `true`, a\n   * configuration path would be `config/[app-name]/[file]`.\n   *\n   * @default false\n   */\n  hasFolder: boolean;\n  /**\n   * Whether or not to check for the environment variable and load a configuration file\n   * based on its value.\n   *\n   * @default true\n   */\n  loadFromEnvironment: boolean;\n  /**\n   * The name of the environment variable that will be used to set the active\n   * configuration.\n   *\n   * @default 'CONFIG'\n   */\n  environmentVariable: string;\n  /**\n   * The name of the default configuration file.\n   *\n   * @default '[app-name].config.js'\n   */\n  defaultConfigFilename: string;\n  /**\n   * The name format of other external configuration files.\n   *\n   * @default '[app-name].[config-name].config.js'\n   */\n  filenameFormat: string;\n};\n/**\n * The options for the middleware that serves static files.\n *\n * @group Jimpex\n */\nexport type JimpexStaticsOptions = {\n  /**\n   * Whether or not to enable the middleware.\n   *\n   * @default true\n   */\n  enabled: boolean;\n  /**\n   * If `true`, the path to the statics folder will be relative to the project root\n   * directory, otherwise, it will be relative to the directory where the app executable\n   * file is located.\n   *\n   * @default false\n   */\n  onHome: boolean;\n  /**\n   * The name of both the route and the folder, relative to whatever you defined with the\n   * `onHome` option.\n   *\n   * @default 'statics'\n   */\n  route: string;\n  /**\n   * By default, the folder will be the same as the `route`,\n   * but you can use this option to define a relative path that won't affect the route.\n   *\n   * @default ''\n   */\n  folder?: string;\n};\n/**\n * The options for the Express application.\n *\n * @group Jimpex\n */\nexport type JimpexExpressOptions = {\n  /**\n   * Whether or not to enable the `trust proxy` option.\n   *\n   * @default true\n   */\n  trustProxy: boolean;\n  /**\n   * Whether or not to remove the `x-powered-by` header.\n   *\n   * @default true\n   */\n  disableXPoweredBy: boolean;\n  /**\n   * Whether or not to add the `compression` middleware.\n   *\n   * @default true\n   */\n  compression: boolean;\n  /**\n   * Whether or not to add the `body-parser` middleware.\n   *\n   * @default true\n   */\n  bodyParser: boolean;\n  /**\n   * Whether or not to add the `multer` middleware.\n   *\n   * @see {@link https://www.npmjs.com/package/multer}\n   */\n  multer: boolean;\n};\n/**\n * The options to configure the application executable path.\n *\n * @group Jimpex\n */\nexport type JimpexPathOptions = {\n  /**\n   * A \"hardcoded\" path to the application executable file.\n   *\n   * @default ''\n   */\n  appPath?: string;\n  /**\n   * If `true`, it will try to figure out the parent file path, and use its directory as\n   * the path.\n   *\n   * @default true\n   */\n  useParentPath: boolean;\n};\n/**\n * The options to enable some of the default services Jimpex comes with.\n *\n * @group Jimpex\n */\nexport type JimpexServicesOptions = {\n  /**\n   * Whether or not to register all the `common` services: `appError`, `httpError`, and\n   * `sendFile`.\n   *\n   * @default true\n   */\n  common: boolean;\n  /**\n   * Whether or not to register the `http` services: `apiClient`, `http`, and\n   * `responsesBuilder`.\n   *\n   * @default true\n   */\n  http: boolean;\n  /**\n   * Whether or not to register the `utils` services: `ensureBearerToken`.\n   */\n  utils: boolean;\n};\n/**\n * The format in which the application's health status can be returned.\n * It's either a simple boolean, or a more detailed object.\n *\n * @group Jimpex\n */\nexport type JimpexHealthStatus =\n  | boolean\n  | {\n      isHealthy?: boolean;\n      services?: Record<string, boolean>;\n    };\n/**\n * Returns the application health status. This is normally used by the `healthController`.\n *\n * @group Jimpex\n */\nexport type JimpexHealthCheckFn = (app: Jimpex) => Promise<JimpexHealthStatus>;\n/**\n * The options to create a new instance of Jimpex.\n *\n * @group Jimpex\n */\nexport type JimpexOptions = {\n  /**\n   * The size limit for the requests payload.\n   *\n   * @default '15MB'\n   */\n  filesizeLimit: string;\n  /**\n   * Whether or not to call the `boot` method after initialization. This is useful if you\n   * want to register/overwrite services only on certain contexts, like a dev environment.\n   *\n   * @default true\n   */\n  boot: boolean;\n  /**\n   * The options to configure the application executable path.\n   */\n  path: JimpexPathOptions;\n  /**\n   * Options for the configuration service.\n   *\n   * @see {@link https://www.npmjs.com/package/@homer0/simple-config}\n   */\n  config: JimpexConfigOptions;\n  /**\n   * Options for the middleware that serves static files.\n   */\n  statics: JimpexStaticsOptions;\n  /**\n   * Options for the Express application.\n   */\n  express: JimpexExpressOptions;\n  /**\n   * Options to manage the default services.\n   */\n  services: JimpexServicesOptions;\n  /**\n   * A function that will be used to check the application health status.\n   */\n  healthCheck: JimpexHealthCheckFn;\n};\n/**\n * The function called when the application starts listening for requests.\n *\n * @group Jimpex\n */\nexport type JimpexStartCallback = (config: Config) => void;\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/utils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * A simple dictionary with unknown values.
+ *
+ * @group Utilities
+ */
+type Dict = Record<string, unknown>;
+/**
+ * Utility to make a deep "partial" of an existing type.
+ *
+ * @template T  The type to make a partial of.
+ * @group Utilities
+ */
+type DeepPartial<T> = {
+    [P in keyof T]?: T[P] extends (infer U)[] ? DeepPartial<U>[] : T[P] extends object ? DeepPartial<T[P]> : T[P];
+};
+/**
+ * Utility to make a deep "readonly" of an existing type.
+ *
+ * @template T  The type to make a readonly of.
+ * @group Utilities
+ */
+type DeepReadonly<T> = {
+    readonly [P in keyof T]: T[P] extends (infer U)[] ? DeepReadonly<U>[] : T[P] extends object ? DeepReadonly<T[P]> : T[P];
+};
+/**
+ * Utility to remove string indexes from types.
+ *
+ * @template T  The type to remove string indexes from.
+ * @example
+ *
+ *   type Foo = {
+ *     a: string;
+ *     b: string;
+ *     [key: string]: string;
+ *   };
+ *   type Bar = RemoveStringIndexes<Foo>;
+ *   // Bar = {
+ *   //  a: string;
+ *   //  b: string;
+ *   // };
+ *
+ * @group Utilities
+ */
+type NoStringIndex<T> = {
+    [K in keyof T as string extends K ? never : K]: T[K];
+};
+
+export { DeepPartial, DeepReadonly, Dict, NoStringIndex };

package/dist/types/utils.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var utils_exports = {};
+module.exports = __toCommonJS(utils_exports);
+//# sourceMappingURL=utils.js.map

package/dist/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/utils.ts"],"sourcesContent":["/**\n * A simple dictionary with unknown values.\n *\n * @group Utilities\n */\nexport type Dict = Record<string, unknown>;\n/**\n * Utility to make a deep \"partial\" of an existing type.\n *\n * @template T  The type to make a partial of.\n * @group Utilities\n */\nexport type DeepPartial<T> = {\n  [P in keyof T]?: T[P] extends (infer U)[]\n    ? DeepPartial<U>[]\n    : T[P] extends object\n    ? DeepPartial<T[P]>\n    : T[P];\n};\n/**\n * Utility to make a deep \"readonly\" of an existing type.\n *\n * @template T  The type to make a readonly of.\n * @group Utilities\n */\nexport type DeepReadonly<T> = {\n  readonly [P in keyof T]: T[P] extends (infer U)[]\n    ? DeepReadonly<U>[]\n    : T[P] extends object\n    ? DeepReadonly<T[P]>\n    : T[P];\n};\n/**\n * Utility to remove string indexes from types.\n *\n * @template T  The type to remove string indexes from.\n * @example\n *\n *   type Foo = {\n *     a: string;\n *     b: string;\n *     [key: string]: string;\n *   };\n *   type Bar = RemoveStringIndexes<Foo>;\n *   // Bar = {\n *   //  a: string;\n *   //  b: string;\n *   // };\n *\n * @group Utilities\n */\nexport type NoStringIndex<T> = { [K in keyof T as string extends K ? never : K]: T[K] };\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types/wootils.d.ts

@@ -0,0 +1,4 @@
+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';

package/dist/types/wootils.js

@@ -0,0 +1,17 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var wootils_exports = {};
+module.exports = __toCommonJS(wootils_exports);
+//# sourceMappingURL=wootils.js.map

package/dist/types/wootils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/wootils.ts"],"sourcesContent":["export type { PathUtils } from '@homer0/path-utils';\nexport type { SimpleLogger as Logger } from '@homer0/simple-logger';\nexport type { SimpleConfig as Config } from '@homer0/simple-config';\nexport type { EventsHub } from '@homer0/events-hub';\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/utils/fns/index.d.ts

@@ -0,0 +1,5 @@
+export { notUndefined } from './others.js';
+export { createRouteExpression, removeLeadingSlash, removeSlashes, removeTrailingSlash } from './routes.js';
+export { Statuses } from './statuses.js';
+export { escapeForRegExp } from './text.js';
+export { default as statuses } from 'statuses';

package/dist/utils/fns/index.js

@@ -0,0 +1,22 @@
+"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 fns_exports = {};
+module.exports = __toCommonJS(fns_exports);
+__reExport(fns_exports, require("./others"), module.exports);
+__reExport(fns_exports, require("./routes"), module.exports);
+__reExport(fns_exports, require("./statuses"), module.exports);
+__reExport(fns_exports, require("./text"), module.exports);
+//# sourceMappingURL=index.js.map

package/dist/utils/fns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/fns/index.ts"],"sourcesContent":["export * from './others';\nexport * from './routes';\nexport * from './statuses';\nexport * from './text';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wBAAc,qBAAd;AACA,wBAAc,qBADd;AAEA,wBAAc,uBAFd;AAGA,wBAAc,mBAHd;","names":[]}