jimpex 7.0.2 → 9.0.0

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.mts

@@ -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.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.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-efeb437e.js';
+export { AsyncExpressMiddleware, ExpressErrorHandler, ExpressMiddleware, ExpressMiddlewareLike, RouterMethod } from './express.mjs';
+export { JimpexHTTP2Options, JimpexHTTPSCredentials, JimpexHTTPSOptions, JimpexServer, JimpexServerInstance } 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

@@ -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-b2a04c78.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,33 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var 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);
+// 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/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.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-efeb437e.js';
+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

@@ -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-b2a04c78.js';
+import './express.js';
+import 'express';
+import './http.js';
+import 'https';
+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/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.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 { DeepPartial, DeepReadonly, Dict, NoStringIndex };

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.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/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.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.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,29 @@
+"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);
+// 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/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":[]}

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/others.d.ts

@@ -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/others.js

@@ -0,0 +1,29 @@
+"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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var others_exports = {};
+__export(others_exports, {
+  notUndefined: () => notUndefined
+});
+module.exports = __toCommonJS(others_exports);
+const notUndefined = (value) => value !== void 0;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  notUndefined
+});
+//# sourceMappingURL=others.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/fns/others.ts"],"sourcesContent":["/**\n * A utility function that can be used in `.filter` calls to remove `undefined` values and\n * assert that the type is not longer `undefined`.\n *\n * @param value  The value to check.\n * @template T  The type that is not `undefined`.\n * @example\n *\n *   const arr: (number | undefined)[] = [1, 2, 3, undefined];\n *   const filtered = arr.filter(notUndefined);\n *   // filtered = [1, 2, 3] and its type is number[]\n *\n * @group Utilities\n */\nexport const notUndefined = <T>(value: T | undefined): value is T => value !== undefined;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAcO,MAAM,eAAe,CAAI,UAAqC,UAAU;","names":[]}