jimpex 8.0.0 → 10.0.0

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

@@ -1 +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":[]}
+{"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;AAAA;AAAA;AAAA,EAY7B,YAAY;AAAA,IACV,QAAQ,EAAE,WAAW,SAAS;AAAA,IAC9B,GAAG;AAAA,EACL,GAAmC;AAXnC;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,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;AAAA;AAAA;AAAA;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,KAAK,IAAI;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;AAAA;AAAA;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,qBAAqB,GAAG,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.mts

@@ -0,0 +1,44 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex } from '../../index-Bwf7JHu9.mjs';
+import { EnsureBearerTokenProviderOptions } from './ensureBearerToken.mjs';
+export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, ensureBearerTokenProvider } from './ensureBearerToken.mjs';
+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 '../../utils/fns/statuses.mjs';
+import 'statuses';
+import '../common/httpError.mjs';
+import '../common/appError.mjs';
+
+/**
+ * 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.d.ts

@@ -1,8 +1,7 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../jimpex-7eaee271.js';
+import { J as Jimpex } from '../../index-C6I3NCC-.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';
@@ -10,9 +9,11 @@ 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 '../../utils/fns/statuses.js';
 import 'statuses';
 import '../common/httpError.js';

package/dist/services/utils/index.js

@@ -30,6 +30,7 @@ const utilsServicesProvider = (0, import_utils.providers)({
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  utilsServicesProvider
+  utilsServicesProvider,
+  ...require("./ensureBearerToken")
 });
 //# sourceMappingURL=index.js.map

package/dist/types/events.d.mts

@@ -0,0 +1,14 @@
+import './express.mjs';
+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 '../index-Bwf7JHu9.mjs';
+import 'express';
+import './http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import './utils.mjs';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '@homer0/jimple';

package/dist/types/events.d.ts

@@ -1,13 +1,14 @@
 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';
+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 '../index-C6I3NCC-.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/path-utils';
 import '@homer0/simple-logger';
+import '@homer0/simple-config';
+import '@homer0/events-hub';
+import '@homer0/jimple';

package/dist/types/express.d.mts

@@ -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 type { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod };

package/dist/types/express.d.ts

@@ -7,4 +7,4 @@ type AsyncExpressMiddleware = (...args: Parameters<ExpressMiddleware>) => Promis
 type ExpressErrorHandler = ErrorRequestHandler;
 type RouterMethod = 'all' | 'get' | 'head' | 'post' | 'patch' | 'put' | 'delete' | 'connect' | 'options' | 'trace';
 
-export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod };
+export type { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod };

package/dist/types/http.d.mts

@@ -0,0 +1,82 @@
+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 NodeFetchFn from 'node-fetch';
+export { Response as HTTPResponse } from 'node-fetch';
+import { Express } from 'express';
+
+type NodeFetch = typeof NodeFetchFn;
+
+/**
+ * @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 type { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance, NodeFetch };

package/dist/types/http.d.ts

@@ -3,8 +3,11 @@ 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';
+import NodeFetchFn from 'node-fetch';
 export { Response as HTTPResponse } from 'node-fetch';
+import { Express } from 'express';
+
+type NodeFetch = typeof NodeFetchFn;
 
 /**
  * @group Jimpex
@@ -76,4 +79,4 @@ type JimpexHTTPSOptions = {
     };
 };
 
-export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance };
+export type { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance, NodeFetch };

package/dist/types/http.js.map

@@ -1 +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":[]}
+{"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 NodeFetchFn from 'node-fetch';\nimport type { Express } from './express';\n\nexport type { Response as HTTPResponse } from 'node-fetch';\n\nexport type NodeFetch = typeof NodeFetchFn;\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.mts

@@ -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 '../index-Bwf7JHu9.mjs';
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './express.mjs';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance, NodeFetch } from './http.mjs';
+export { DeepPartial, DeepReadonly, Dict, NoStringIndex } from './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 { 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.d.ts

@@ -1,6 +1,6 @@
-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 { 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 '../index-C6I3NCC-.js';
 export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './express.js';
-export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance } from './http.js';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance, NodeFetch } 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';

package/dist/types/index.js

@@ -21,4 +21,13 @@ __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);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./events"),
+  ...require("./express"),
+  ...require("./http"),
+  ...require("./options"),
+  ...require("./utils"),
+  ...require("./wootils")
+});
 //# sourceMappingURL=index.js.map

package/dist/types/options.d.mts

@@ -0,0 +1,14 @@
+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 '../index-Bwf7JHu9.mjs';
+import './express.mjs';
+import 'express';
+import './http.mjs';
+import 'https';
+import 'http';
+import 'spdy';
+import 'node-fetch';
+import './utils.mjs';
+import '@homer0/path-utils';
+import '@homer0/simple-logger';
+import '@homer0/events-hub';
+import '@homer0/jimple';

package/dist/types/options.d.ts

@@ -1,7 +1,5 @@
 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';
+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 '../index-C6I3NCC-.js';
 import './express.js';
 import 'express';
 import './http.js';
@@ -10,4 +8,7 @@ import 'http';
 import 'spdy';
 import 'node-fetch';
 import './utils.js';
+import '@homer0/path-utils';
 import '@homer0/simple-logger';
+import '@homer0/events-hub';
+import '@homer0/jimple';

package/dist/types/utils.d.mts

@@ -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 type { DeepPartial, DeepReadonly, Dict, NoStringIndex };

package/dist/types/utils.d.ts

@@ -45,4 +45,4 @@ type NoStringIndex<T> = {
     [K in keyof T as string extends K ? never : K]: T[K];
 };
 
-export { DeepPartial, DeepReadonly, Dict, NoStringIndex };
+export type { DeepPartial, DeepReadonly, Dict, NoStringIndex };

package/dist/types/wootils.d.mts

@@ -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/utils/fns/index.d.mts

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

package/dist/utils/fns/index.js

@@ -19,4 +19,11 @@ __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);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./others"),
+  ...require("./routes"),
+  ...require("./statuses"),
+  ...require("./text")
+});
 //# sourceMappingURL=index.js.map

package/dist/utils/fns/others.d.mts

@@ -0,0 +1,17 @@
+/**
+ * A utility function that can be used in `.filter` calls to remove `undefined` values and
+ * assert that the type is not longer `undefined`.
+ *
+ * @param value  The value to check.
+ * @template T  The type that is not `undefined`.
+ * @example
+ *
+ *   const arr: (number | undefined)[] = [1, 2, 3, undefined];
+ *   const filtered = arr.filter(notUndefined);
+ *   // filtered = [1, 2, 3] and its type is number[]
+ *
+ * @group Utilities
+ */
+declare const notUndefined: <T>(value: T | undefined) => value is T;
+
+export { notUndefined };

package/dist/utils/fns/routes.d.mts

@@ -0,0 +1,39 @@
+/**
+ * Removes any leading slash from a URL.
+ *
+ * @param url  The URL to format.
+ * @group Utilities
+ */
+declare const removeLeadingSlash: (url: string) => string;
+/**
+ * Removes any trailing slash from a URL.
+ *
+ * @param url  The URL to format.
+ * @group Utilities
+ */
+declare const removeTrailingSlash: (url: string) => string;
+/**
+ * Remove any leading and trailing slash from a URL.
+ *
+ * @param url       The URL to format.
+ * @param leading   Whether or not to remove any leading slash.
+ * @param trailing  Whether or not to remove the trailing slash.
+ * @group Utilities
+ */
+declare const removeSlashes: (url: string, leading?: boolean, trailing?: boolean) => string;
+/**
+ * Given a server route definition, this function creates a regular expression to match
+ * it: The expression replaces the routes parameters with placeholders so it can be
+ * compared with real routes.
+ *
+ * @param route          The route from which the expression will be created.
+ * @param leadingSlash   Whether or not the expression should match a leading slash.
+ * @param trailingSlash  Whether or not the expression should match a trailing slash.
+ *                       The reason this is `false` by default is because these
+ *                       expressions are often used to match against incoming requests,
+ *                       and they don't have a trailing slash.
+ * @group Utilities
+ */
+declare const createRouteExpression: (route: string, leadingSlash?: boolean, trailingSlash?: boolean) => RegExp;
+
+export { createRouteExpression, removeLeadingSlash, removeSlashes, removeTrailingSlash };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/fns/routes.ts"],"sourcesContent":["import { escapeForRegExp } from './text';\n\n/**\n * Removes any leading slash from a URL.\n *\n * @param url  The URL to format.\n * @group Utilities\n */\nexport const removeLeadingSlash = (url: string): string => url.replace(/^\\/+/, '');\n/**\n * Removes any trailing slash from a URL.\n *\n * @param url  The URL to format.\n * @group Utilities\n */\nexport const removeTrailingSlash = (url: string): string => url.replace(/\\/+$/, '');\n/**\n * Remove any leading and trailing slash from a URL.\n *\n * @param url       The URL to format.\n * @param leading   Whether or not to remove any leading slash.\n * @param trailing  Whether or not to remove the trailing slash.\n * @group Utilities\n */\nexport const removeSlashes = (\n  url: string,\n  leading: boolean = true,\n  trailing: boolean = true,\n) => {\n  const newUrl = leading ? removeLeadingSlash(url) : url;\n  return trailing ? removeTrailingSlash(newUrl) : newUrl;\n};\n\n/**\n * Given a server route definition, this function creates a regular expression to match\n * it: The expression replaces the routes parameters with placeholders so it can be\n * compared with real routes.\n *\n * @param route          The route from which the expression will be created.\n * @param leadingSlash   Whether or not the expression should match a leading slash.\n * @param trailingSlash  Whether or not the expression should match a trailing slash.\n *                       The reason this is `false` by default is because these\n *                       expressions are often used to match against incoming requests,\n *                       and they don't have a trailing slash.\n * @group Utilities\n */\nexport const createRouteExpression = (\n  route: string,\n  leadingSlash: boolean = true,\n  trailingSlash: boolean = false,\n): RegExp => {\n  let expression = removeSlashes(route)\n    .split('/')\n    .map((part) => (part.startsWith(':') ? '(?:([^\\\\/]+?))' : escapeForRegExp(part)))\n    .join('\\\\/');\n  if (leadingSlash) {\n    expression = `\\\\/${expression}`;\n  }\n  if (trailingSlash) {\n    expression = `${expression}\\\\/`;\n  }\n\n  return new RegExp(expression);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAgC;AAQzB,MAAM,qBAAqB,CAAC,QAAwB,IAAI,QAAQ,QAAQ,EAAE;AAO1E,MAAM,sBAAsB,CAAC,QAAwB,IAAI,QAAQ,QAAQ,EAAE;AAS3E,MAAM,gBAAgB,CAC3B,KACA,UAAmB,MACnB,WAAoB,SACjB;AACH,QAAM,SAAS,UAAU,mBAAmB,GAAG,IAAI;AACnD,SAAO,WAAW,oBAAoB,MAAM,IAAI;AAClD;AAeO,MAAM,wBAAwB,CACnC,OACA,eAAwB,MACxB,gBAAyB,UACd;AACX,MAAI,aAAa,cAAc,KAAK,EACjC,MAAM,GAAG,EACT,IAAI,CAAC,SAAU,KAAK,WAAW,GAAG,IAAI,uBAAmB,6BAAgB,IAAI,CAAE,EAC/E,KAAK,KAAK;AACb,MAAI,cAAc;AAChB,iBAAa,MAAM;AAAA,EACrB;AACA,MAAI,eAAe;AACjB,iBAAa,GAAG;AAAA,EAClB;AAEA,SAAO,IAAI,OAAO,UAAU;AAC9B;","names":[]}
+{"version":3,"sources":["../../../src/utils/fns/routes.ts"],"sourcesContent":["import { escapeForRegExp } from './text';\n\n/**\n * Removes any leading slash from a URL.\n *\n * @param url  The URL to format.\n * @group Utilities\n */\nexport const removeLeadingSlash = (url: string): string => url.replace(/^\\/+/, '');\n/**\n * Removes any trailing slash from a URL.\n *\n * @param url  The URL to format.\n * @group Utilities\n */\nexport const removeTrailingSlash = (url: string): string => url.replace(/\\/+$/, '');\n/**\n * Remove any leading and trailing slash from a URL.\n *\n * @param url       The URL to format.\n * @param leading   Whether or not to remove any leading slash.\n * @param trailing  Whether or not to remove the trailing slash.\n * @group Utilities\n */\nexport const removeSlashes = (\n  url: string,\n  leading: boolean = true,\n  trailing: boolean = true,\n) => {\n  const newUrl = leading ? removeLeadingSlash(url) : url;\n  return trailing ? removeTrailingSlash(newUrl) : newUrl;\n};\n\n/**\n * Given a server route definition, this function creates a regular expression to match\n * it: The expression replaces the routes parameters with placeholders so it can be\n * compared with real routes.\n *\n * @param route          The route from which the expression will be created.\n * @param leadingSlash   Whether or not the expression should match a leading slash.\n * @param trailingSlash  Whether or not the expression should match a trailing slash.\n *                       The reason this is `false` by default is because these\n *                       expressions are often used to match against incoming requests,\n *                       and they don't have a trailing slash.\n * @group Utilities\n */\nexport const createRouteExpression = (\n  route: string,\n  leadingSlash: boolean = true,\n  trailingSlash: boolean = false,\n): RegExp => {\n  let expression = removeSlashes(route)\n    .split('/')\n    .map((part) => (part.startsWith(':') ? '(?:([^\\\\/]+?))' : escapeForRegExp(part)))\n    .join('\\\\/');\n  if (leadingSlash) {\n    expression = `\\\\/${expression}`;\n  }\n  if (trailingSlash) {\n    expression = `${expression}\\\\/`;\n  }\n\n  return new RegExp(expression);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAAgC;AAQzB,MAAM,qBAAqB,CAAC,QAAwB,IAAI,QAAQ,QAAQ,EAAE;AAO1E,MAAM,sBAAsB,CAAC,QAAwB,IAAI,QAAQ,QAAQ,EAAE;AAS3E,MAAM,gBAAgB,CAC3B,KACA,UAAmB,MACnB,WAAoB,SACjB;AACH,QAAM,SAAS,UAAU,mBAAmB,GAAG,IAAI;AACnD,SAAO,WAAW,oBAAoB,MAAM,IAAI;AAClD;AAeO,MAAM,wBAAwB,CACnC,OACA,eAAwB,MACxB,gBAAyB,UACd;AACX,MAAI,aAAa,cAAc,KAAK,EACjC,MAAM,GAAG,EACT,IAAI,CAAC,SAAU,KAAK,WAAW,GAAG,IAAI,uBAAmB,6BAAgB,IAAI,CAAE,EAC/E,KAAK,KAAK;AACb,MAAI,cAAc;AAChB,iBAAa,MAAM,UAAU;AAAA,EAC/B;AACA,MAAI,eAAe;AACjB,iBAAa,GAAG,UAAU;AAAA,EAC5B;AAEA,SAAO,IAAI,OAAO,UAAU;AAC9B;","names":[]}

package/dist/utils/fns/statuses.d.mts

@@ -0,0 +1,45 @@
+export { default as statuses } from 'statuses';
+
+/**
+ * The type definitions for the `statuses` library.
+ *
+ * While the library has type definitions, TypeScript throws an error that they can't be
+ * exported, so that's why they are copied in there.
+ */
+type Statuses = {
+    /**
+     * Given a status code, returns the status text, and given a status text, returns the
+     * status code.
+     *
+     * @param code  The status code or status text to look up.
+     * @throws If the status is invalid.
+     */
+    (code: number | string): number | string;
+    /**
+     * A list of all the supported status codes.
+     */
+    codes: number[];
+    /**
+     * A dictionary with the status texts and their corresponding status codes.
+     */
+    code: Record<string, number | undefined>;
+    /**
+     * A dictionary with the status codes and their corresponding status texts, for
+     * responses that expect an empty body.
+     */
+    empty: Record<number, boolean | undefined>;
+    /**
+     * A dictionary with the status codes and their corresponding status texts.
+     */
+    message: Record<number, string | undefined>;
+    /**
+     * A dictionary with status codes for responses that are valid for redirections.
+     */
+    redirect: Record<number, boolean | undefined>;
+    /**
+     * A dictionary with status codes that should be retried.
+     */
+    retry: Record<number, boolean | undefined>;
+};
+
+export type { Statuses };

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

@@ -42,4 +42,4 @@ type Statuses = {
     retry: Record<number, boolean | undefined>;
 };
 
-export { Statuses };
+export type { Statuses };

package/dist/utils/fns/statuses.js

@@ -18,6 +18,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
 ));

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/utils/fns/statuses.ts"],"sourcesContent":["import statuses from 'statuses';\n/**\n * The type definitions for the `statuses` library.\n *\n * While the library has type definitions, TypeScript throws an error that they can't be\n * exported, so that's why they are copied in there.\n */\nexport type Statuses = {\n  /**\n   * Given a status code, returns the status text, and given a status text, returns the\n   * status code.\n   *\n   * @param code  The status code or status text to look up.\n   * @throws If the status is invalid.\n   */\n  (code: number | string): number | string;\n  /**\n   * A list of all the supported status codes.\n   */\n  codes: number[];\n  /**\n   * A dictionary with the status texts and their corresponding status codes.\n   */\n  code: Record<string, number | undefined>;\n  /**\n   * A dictionary with the status codes and their corresponding status texts, for\n   * responses that expect an empty body.\n   */\n  empty: Record<number, boolean | undefined>;\n  /**\n   * A dictionary with the status codes and their corresponding status texts.\n   */\n  message: Record<number, string | undefined>;\n  /**\n   * A dictionary with status codes for responses that are valid for redirections.\n   */\n  redirect: Record<number, boolean | undefined>;\n  /**\n   * A dictionary with status codes that should be retried.\n   */\n  retry: Record<number, boolean | undefined>;\n};\n\nexport { statuses };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,kCAAAA;AAAA;AAAA;AAAA,sBAAqB;","names":["statuses"]}
+{"version":3,"sources":["../../../src/utils/fns/statuses.ts"],"sourcesContent":["import statuses from 'statuses';\n/**\n * The type definitions for the `statuses` library.\n *\n * While the library has type definitions, TypeScript throws an error that they can't be\n * exported, so that's why they are copied in there.\n */\nexport type Statuses = {\n  /**\n   * Given a status code, returns the status text, and given a status text, returns the\n   * status code.\n   *\n   * @param code  The status code or status text to look up.\n   * @throws If the status is invalid.\n   */\n  (code: number | string): number | string;\n  /**\n   * A list of all the supported status codes.\n   */\n  codes: number[];\n  /**\n   * A dictionary with the status texts and their corresponding status codes.\n   */\n  code: Record<string, number | undefined>;\n  /**\n   * A dictionary with the status codes and their corresponding status texts, for\n   * responses that expect an empty body.\n   */\n  empty: Record<number, boolean | undefined>;\n  /**\n   * A dictionary with the status codes and their corresponding status texts.\n   */\n  message: Record<number, string | undefined>;\n  /**\n   * A dictionary with status codes for responses that are valid for redirections.\n   */\n  redirect: Record<number, boolean | undefined>;\n  /**\n   * A dictionary with status codes that should be retried.\n   */\n  retry: Record<number, boolean | undefined>;\n};\n\nexport { statuses };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,kCAAAA;AAAA;AAAA;AAAA,sBAAqB;","names":["statuses"]}

package/dist/utils/fns/text.d.mts

@@ -0,0 +1,9 @@
+/**
+ * Escapes a string to be used on `new RegExp(...)`.
+ *
+ * @param text  The text to escape.
+ * @group Utilities
+ */
+declare const escapeForRegExp: (text: string) => string;
+
+export { escapeForRegExp };

package/dist/utils/index.d.mts

@@ -0,0 +1,19 @@
+export { notUndefined } from './fns/others.mjs';
+export { createRouteExpression, removeLeadingSlash, removeSlashes, removeTrailingSlash } from './fns/routes.mjs';
+export { Statuses } from './fns/statuses.mjs';
+export { escapeForRegExp } from './fns/text.mjs';
+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, 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, S as middleware, U as middlewareCreator, Y as middlewareProvider, _ as middlewareProviderCreator, v as provider, w as providerCreator, x as providers } from '../index-Bwf7JHu9.mjs';
+export { default as statuses } from 'statuses';
+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 '@homer0/jimple';