jimpex 10.0.2 → 11.0.0

package/dist/services/common/httpError.js

@@ -1,31 +1,6 @@
-"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 httpError_exports = {};
-__export(httpError_exports, {
-  HTTPError: () => HTTPError,
-  createHTTPError: () => createHTTPError,
-  httpErrorProvider: () => httpErrorProvider
-});
-module.exports = __toCommonJS(httpError_exports);
-var import_utils = require("../../utils");
-var import_appError = require("./appError");
-class HTTPError extends import_appError.AppError {
+import { provider, statuses as statusesFn } from "../../utils/index.js";
+import { AppError } from "./appError.js";
+class HTTPError extends AppError {
   /**
    * @param message   The error message.
    * @param status    The HTTP status code.
@@ -35,19 +10,18 @@ class HTTPError extends import_appError.AppError {
    *                  the container; otherwise, it will use the `statuses` library
    *                  directly.
    */
-  constructor(message, status = (0, import_utils.statuses)("ok"), context = {}, statuses = import_utils.statuses) {
+  constructor(message, status = statusesFn("ok"), context = {}, statuses = statusesFn) {
     super(message, { ...context, status }, statuses);
   }
 }
 const createHTTPError = (...args) => new HTTPError(...args);
-const httpErrorProvider = (0, import_utils.provider)((app) => {
+const httpErrorProvider = provider((app) => {
   app.set("HTTPError", () => HTTPError);
   app.set("httpError", () => createHTTPError);
 });
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   HTTPError,
   createHTTPError,
   httpErrorProvider
-});
+};
 //# sourceMappingURL=httpError.js.map

package/dist/services/common/httpError.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/common/httpError.ts"],"sourcesContent":["import { provider, statuses as statusesFn, type Statuses } from '../../utils';\nimport { AppError, type AppErrorContext } from './appError';\n/**\n * A type of error to be used on HTTP requests. This is the most common type of error used\n * by Jimpex.\n *\n * @group Services\n * @group Services/HTTPError\n */\nexport class HTTPError extends AppError {\n  /**\n   * @param message   The error message.\n   * @param status    The HTTP status code.\n   * @param context   Context information related to the error.\n   * @param statuses  A reference to the service that generates HTTP status codes. This\n   *                  is in case the implementation wants to use a special version from\n   *                  the container; otherwise, it will use the `statuses` library\n   *                  directly.\n   */\n  constructor(\n    message: string,\n    status: number | string = statusesFn('ok'),\n    context: AppErrorContext = {},\n    statuses: Statuses = statusesFn,\n  ) {\n    super(message, { ...context, status }, statuses);\n  }\n}\n/**\n * Shorthand for `new HTTPError()`.\n *\n * @param args  The same parameters as the {@link HTTPError} constructor.\n * @returns A new instance of {@link HTTPError}.\n * @group Services\n * @group Services/HTTPError\n */\nexport const createHTTPError = (\n  ...args: ConstructorParameters<typeof HTTPError>\n): HTTPError => new HTTPError(...args);\n/**\n * The type of the function that generates a new instance of {@link HTTPError}.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/HTTPError\n */\nexport type CreateHTTPErrorFn = typeof createHTTPError;\n/**\n * THe type of the {@link HTTPError} class.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/HTTPError\n */\nexport type HTTPErrorClass = typeof HTTPError;\n/**\n * A service provider that will register both the {@link HTTPError} and a generator\n * function on the container. `HTTPError` will be the key for class, and `httpError` will\n * be for the generator function.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(httpErrorProvider);\n *   // Getting access to the class.\n *   const HTTPError = container.get<HTTPErrorClass>('HTTPError');\n *   // Getting access to the function.\n *   const httpError = container.get<CreateHTTPErrorFn>('httpError');\n *\n * @group Providers\n * @group Services/HTTPError\n */\nexport const httpErrorProvider = provider((app) => {\n  app.set('HTTPError', () => HTTPError);\n  app.set('httpError', () => createHTTPError);\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAgE;AAChE,sBAA+C;AAQxC,MAAM,kBAAkB,yBAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUtC,YACE,SACA,aAA0B,aAAAA,UAAW,IAAI,GACzC,UAA2B,CAAC,GAC5B,WAAqB,aAAAA,UACrB;AACA,UAAM,SAAS,EAAE,GAAG,SAAS,OAAO,GAAG,QAAQ;AAAA,EACjD;AACF;AASO,MAAM,kBAAkB,IAC1B,SACW,IAAI,UAAU,GAAG,IAAI;AAgC9B,MAAM,wBAAoB,uBAAS,CAAC,QAAQ;AACjD,MAAI,IAAI,aAAa,MAAM,SAAS;AACpC,MAAI,IAAI,aAAa,MAAM,eAAe;AAC5C,CAAC;","names":["statusesFn"]}
+{"version":3,"sources":["../../../src/services/common/httpError.ts"],"sourcesContent":["import { provider, statuses as statusesFn, type Statuses } from '../../utils/index.js';\nimport { AppError, type AppErrorContext } from './appError.js';\n/**\n * A type of error to be used on HTTP requests. This is the most common type of error used\n * by Jimpex.\n *\n * @group Services\n * @group Services/HTTPError\n */\nexport class HTTPError extends AppError {\n  /**\n   * @param message   The error message.\n   * @param status    The HTTP status code.\n   * @param context   Context information related to the error.\n   * @param statuses  A reference to the service that generates HTTP status codes. This\n   *                  is in case the implementation wants to use a special version from\n   *                  the container; otherwise, it will use the `statuses` library\n   *                  directly.\n   */\n  constructor(\n    message: string,\n    status: number | string = statusesFn('ok'),\n    context: AppErrorContext = {},\n    statuses: Statuses = statusesFn,\n  ) {\n    super(message, { ...context, status }, statuses);\n  }\n}\n/**\n * Shorthand for `new HTTPError()`.\n *\n * @param args  The same parameters as the {@link HTTPError} constructor.\n * @returns A new instance of {@link HTTPError}.\n * @group Services\n * @group Services/HTTPError\n */\nexport const createHTTPError = (\n  ...args: ConstructorParameters<typeof HTTPError>\n): HTTPError => new HTTPError(...args);\n/**\n * The type of the function that generates a new instance of {@link HTTPError}.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/HTTPError\n */\nexport type CreateHTTPErrorFn = typeof createHTTPError;\n/**\n * THe type of the {@link HTTPError} class.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/HTTPError\n */\nexport type HTTPErrorClass = typeof HTTPError;\n/**\n * A service provider that will register both the {@link HTTPError} and a generator\n * function on the container. `HTTPError` will be the key for class, and `httpError` will\n * be for the generator function.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(httpErrorProvider);\n *   // Getting access to the class.\n *   const HTTPError = container.get<HTTPErrorClass>('HTTPError');\n *   // Getting access to the function.\n *   const httpError = container.get<CreateHTTPErrorFn>('httpError');\n *\n * @group Providers\n * @group Services/HTTPError\n */\nexport const httpErrorProvider = provider((app) => {\n  app.set('HTTPError', () => HTTPError);\n  app.set('httpError', () => createHTTPError);\n});\n"],"mappings":"AAAA,SAAS,UAAU,YAAY,kBAAiC;AAChE,SAAS,gBAAsC;AAQxC,MAAM,kBAAkB,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUtC,YACE,SACA,SAA0B,WAAW,IAAI,GACzC,UAA2B,CAAC,GAC5B,WAAqB,YACrB;AACA,UAAM,SAAS,EAAE,GAAG,SAAS,OAAO,GAAG,QAAQ;AAAA,EACjD;AACF;AASO,MAAM,kBAAkB,IAC1B,SACW,IAAI,UAAU,GAAG,IAAI;AAgC9B,MAAM,oBAAoB,SAAS,CAAC,QAAQ;AACjD,MAAI,IAAI,aAAa,MAAM,SAAS;AACpC,MAAI,IAAI,aAAa,MAAM,eAAe;AAC5C,CAAC;","names":[]}

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

@@ -1,5 +1,5 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../index-C6I3NCC-.js';
+import { J as Jimpex } from '../../index-BlSpNHox.js';
 export { AppError, AppErrorClass, AppErrorContext, CreateAppErrorFn, appErrorProvider, createAppError } from './appError.js';
 export { CreateHTTPErrorFn, HTTPError, HTTPErrorClass, createHTTPError, httpErrorProvider } from './httpError.js';
 export { SendFile, SendFileGeneratorOptions, SendFileOptions, sendFile, sendFileProvider } from './sendFile.js';

package/dist/services/common/index.js

@@ -1,44 +1,16 @@
-"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 common_exports = {};
-__export(common_exports, {
-  commonServicesProvider: () => commonServicesProvider
-});
-module.exports = __toCommonJS(common_exports);
-var import_utils = require("../../utils");
-var import_appError = require("./appError");
-var import_httpError = require("./httpError");
-var import_sendFile = require("./sendFile");
-__reExport(common_exports, require("./appError"), module.exports);
-__reExport(common_exports, require("./httpError"), module.exports);
-__reExport(common_exports, require("./sendFile"), module.exports);
-const commonServicesProvider = (0, import_utils.providers)({
-  appErrorProvider: import_appError.appErrorProvider,
-  httpErrorProvider: import_httpError.httpErrorProvider,
-  sendFileProvider: import_sendFile.sendFileProvider
-});
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  commonServicesProvider,
-  ...require("./appError"),
-  ...require("./httpError"),
-  ...require("./sendFile")
+import { providers } from "../../utils/index.js";
+import { appErrorProvider } from "./appError.js";
+import { httpErrorProvider } from "./httpError.js";
+import { sendFileProvider } from "./sendFile.js";
+const commonServicesProvider = providers({
+  appErrorProvider,
+  httpErrorProvider,
+  sendFileProvider
 });
+export * from "./appError.js";
+export * from "./httpError.js";
+export * from "./sendFile.js";
+export {
+  commonServicesProvider
+};
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/common/index.ts"],"sourcesContent":["import { providers } from '../../utils';\nimport { appErrorProvider } from './appError';\nimport { httpErrorProvider } from './httpError';\nimport { sendFileProvider } from './sendFile';\n/**\n * Registers all the common services on the container.\n *\n * - {@link AppError | appError}\n * - {@link HTTPError | httpError}\n * - {@link SendFile | sendFile}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(commonServicesProvider);\n *   // Getting access to one the services instance\n *   const sendFile = container.get<SendFile>('sendFile');\n *\n * @group Providers\n */\nexport const commonServicesProvider = providers({\n  appErrorProvider,\n  httpErrorProvider,\n  sendFileProvider,\n});\n\nexport * from './appError';\nexport * from './httpError';\nexport * from './sendFile';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;AAC1B,sBAAiC;AACjC,uBAAkC;AAClC,sBAAiC;AAuBjC,2BAAc,uBA1Bd;AA2BA,2BAAc,wBA3Bd;AA4BA,2BAAc,uBA5Bd;AAoBO,MAAM,6BAAyB,wBAAU;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../../src/services/common/index.ts"],"sourcesContent":["import { providers } from '../../utils/index.js';\nimport { appErrorProvider } from './appError.js';\nimport { httpErrorProvider } from './httpError.js';\nimport { sendFileProvider } from './sendFile.js';\n/**\n * Registers all the common services on the container.\n *\n * - {@link AppError | appError}\n * - {@link HTTPError | httpError}\n * - {@link SendFile | sendFile}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(commonServicesProvider);\n *   // Getting access to one the services instance\n *   const sendFile = container.get<SendFile>('sendFile');\n *\n * @group Providers\n */\nexport const commonServicesProvider = providers({\n  appErrorProvider,\n  httpErrorProvider,\n  sendFileProvider,\n});\n\nexport * from './appError.js';\nexport * from './httpError.js';\nexport * from './sendFile.js';\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,wBAAwB;AACjC,SAAS,yBAAyB;AAClC,SAAS,wBAAwB;AAiB1B,MAAM,yBAAyB,UAAU;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/services/common/sendFile.d.ts

@@ -1,5 +1,5 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../index-C6I3NCC-.js';
+import { J as Jimpex } from '../../index-BlSpNHox.js';
 import { Response, NextFunction } from 'express';
 import { PathUtils } from '@homer0/path-utils';
 import '../../types/express.js';

package/dist/services/common/sendFile.js

@@ -1,28 +1,4 @@
-"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 sendFile_exports = {};
-__export(sendFile_exports, {
-  sendFile: () => sendFile,
-  sendFileProvider: () => sendFileProvider
-});
-module.exports = __toCommonJS(sendFile_exports);
-var import_utils = require("../../utils");
+import { provider } from "../../utils/index.js";
 const sendFile = ({ inject: { pathUtils } }) => ({ res, filepath, from = "app", next = () => {
 } }) => {
   res.sendFile(pathUtils.joinFrom(from, filepath), (error) => {
@@ -33,7 +9,7 @@ const sendFile = ({ inject: { pathUtils } }) => ({ res, filepath, from = "app",
     }
   });
 };
-const sendFileProvider = (0, import_utils.provider)((app) => {
+const sendFileProvider = provider((app) => {
   app.set(
     "sendFile",
     () => sendFile({
@@ -43,9 +19,8 @@ const sendFileProvider = (0, import_utils.provider)((app) => {
     })
   );
 });
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   sendFile,
   sendFileProvider
-});
+};
 //# sourceMappingURL=sendFile.js.map

package/dist/services/common/sendFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/common/sendFile.ts"],"sourcesContent":["import { provider } from '../../utils';\nimport type { Response, NextFunction, PathUtils } from '../../types';\n/**\n * The options to create a {@link SendFile} function.\n *\n * @group Services/SendFile\n */\nexport type SendFileGeneratorOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    pathUtils: PathUtils;\n  };\n};\n/**\n * The options for the function that actually serves a file.\n *\n * @group Services/SendFile\n */\nexport type SendFileOptions = {\n  /**\n   * The response object sent by the application. Necessary to write the file.\n   */\n  res: Response;\n  /**\n   * The path of the file to serve. Depending on the `from` option, it will be either\n   * relative to the project root, or the application executable.\n   */\n  filepath: string;\n  /**\n   * The name of a location on the `pathUtils` service from where the `filepath` is\n   * relative to. It can be `app` for the directory containing the application executable,\n   * or `project` for the project root. It could also be any other location that the\n   * implementation may have registered.\n   *\n   * @default 'app'\n   */\n  from?: string;\n  /**\n   * The function to move to the next middleware. It can be used to report an error in\n   * case the file can't be served.\n   *\n   * @default {() => {}}\n   */\n  next?: NextFunction;\n};\n/**\n * The type of the function that serves a file.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/SendFile\n */\nexport type SendFile = (options: SendFileOptions) => void;\n/**\n * Generates a function to send files on the application response.\n *\n * @param options  To inject the required dependencies.\n * @example\n *\n * <caption>Basic usage</caption>\n *\n *   // Let's say this is inside an Express middleware.\n *   // Get the function\n *   const send = sendFile(pathUtils);\n *   send({ res, filepath: 'some-file.html', next });\n *   // If your app is on \"/app/index.js\", this will send \"/app/some-file.html\".\n *\n * @group Services\n * @group Services/SendFile\n */\nexport const sendFile =\n  ({ inject: { pathUtils } }: SendFileGeneratorOptions): SendFile =>\n  ({ res, filepath, from = 'app', next = () => {} }) => {\n    res.sendFile(pathUtils.joinFrom(from, filepath), (error) => {\n      if (error) {\n        next(error);\n      } else {\n        res.end();\n      }\n    });\n  };\n\n/**\n * The service provider that once registered on the container will set the result of\n * {@link sendFile} as the `sendFile` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(sendFileProvider);\n *   // Getting access to the service instance\n *   const sendFile = container.get<SendFile>('sendFile');\n *\n * @group Providers\n * @group Services/SendFile\n */\nexport const sendFileProvider = provider((app) => {\n  app.set('sendFile', () =>\n    sendFile({\n      inject: {\n        pathUtils: app.get('pathUtils'),\n      },\n    }),\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAyB;AAuElB,MAAM,WACX,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MACzB,CAAC,EAAE,KAAK,UAAU,OAAO,OAAO,OAAO,MAAM;AAAC,EAAE,MAAM;AACpD,MAAI,SAAS,UAAU,SAAS,MAAM,QAAQ,GAAG,CAAC,UAAU;AAC1D,QAAI,OAAO;AACT,WAAK,KAAK;AAAA,IACZ,OAAO;AACL,UAAI,IAAI;AAAA,IACV;AAAA,EACF,CAAC;AACH;AAgBK,MAAM,uBAAmB,uBAAS,CAAC,QAAQ;AAChD,MAAI;AAAA,IAAI;AAAA,IAAY,MAClB,SAAS;AAAA,MACP,QAAQ;AAAA,QACN,WAAW,IAAI,IAAI,WAAW;AAAA,MAChC;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../../src/services/common/sendFile.ts"],"sourcesContent":["import { provider } from '../../utils/index.js';\nimport type { Response, NextFunction, PathUtils } from '../../types/index.js';\n/**\n * The options to create a {@link SendFile} function.\n *\n * @group Services/SendFile\n */\nexport type SendFileGeneratorOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    pathUtils: PathUtils;\n  };\n};\n/**\n * The options for the function that actually serves a file.\n *\n * @group Services/SendFile\n */\nexport type SendFileOptions = {\n  /**\n   * The response object sent by the application. Necessary to write the file.\n   */\n  res: Response;\n  /**\n   * The path of the file to serve. Depending on the `from` option, it will be either\n   * relative to the project root, or the application executable.\n   */\n  filepath: string;\n  /**\n   * The name of a location on the `pathUtils` service from where the `filepath` is\n   * relative to. It can be `app` for the directory containing the application executable,\n   * or `project` for the project root. It could also be any other location that the\n   * implementation may have registered.\n   *\n   * @default 'app'\n   */\n  from?: string;\n  /**\n   * The function to move to the next middleware. It can be used to report an error in\n   * case the file can't be served.\n   *\n   * @default {() => {}}\n   */\n  next?: NextFunction;\n};\n/**\n * The type of the function that serves a file.\n * This is exported to make it easy to type the dependency injection.\n *\n * @group Services/SendFile\n */\nexport type SendFile = (options: SendFileOptions) => void;\n/**\n * Generates a function to send files on the application response.\n *\n * @param options  To inject the required dependencies.\n * @example\n *\n * <caption>Basic usage</caption>\n *\n *   // Let's say this is inside an Express middleware.\n *   // Get the function\n *   const send = sendFile(pathUtils);\n *   send({ res, filepath: 'some-file.html', next });\n *   // If your app is on \"/app/index.js\", this will send \"/app/some-file.html\".\n *\n * @group Services\n * @group Services/SendFile\n */\nexport const sendFile =\n  ({ inject: { pathUtils } }: SendFileGeneratorOptions): SendFile =>\n  ({ res, filepath, from = 'app', next = () => {} }) => {\n    res.sendFile(pathUtils.joinFrom(from, filepath), (error) => {\n      if (error) {\n        next(error);\n      } else {\n        res.end();\n      }\n    });\n  };\n\n/**\n * The service provider that once registered on the container will set the result of\n * {@link sendFile} as the `sendFile` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(sendFileProvider);\n *   // Getting access to the service instance\n *   const sendFile = container.get<SendFile>('sendFile');\n *\n * @group Providers\n * @group Services/SendFile\n */\nexport const sendFileProvider = provider((app) => {\n  app.set('sendFile', () =>\n    sendFile({\n      inject: {\n        pathUtils: app.get('pathUtils'),\n      },\n    }),\n  );\n});\n"],"mappings":"AAAA,SAAS,gBAAgB;AAuElB,MAAM,WACX,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,MACzB,CAAC,EAAE,KAAK,UAAU,OAAO,OAAO,OAAO,MAAM;AAAC,EAAE,MAAM;AACpD,MAAI,SAAS,UAAU,SAAS,MAAM,QAAQ,GAAG,CAAC,UAAU;AAC1D,QAAI,OAAO;AACT,WAAK,KAAK;AAAA,IACZ,OAAO;AACL,UAAI,IAAI;AAAA,IACV;AAAA,EACF,CAAC;AACH;AAgBK,MAAM,mBAAmB,SAAS,CAAC,QAAQ;AAChD,MAAI;AAAA,IAAI;AAAA,IAAY,MAClB,SAAS;AAAA,MACP,QAAQ;AAAA,QACN,WAAW,IAAI,IAAI,WAAW;AAAA,MAChC;AAAA,IACF,CAAC;AAAA,EACH;AACF,CAAC;","names":[]}

package/dist/services/frontend/frontendFs.d.ts

@@ -1,7 +1,7 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../index-C6I3NCC-.js';
+import { J as Jimpex } from '../../index-BlSpNHox.js';
 import { PathUtils } from '@homer0/path-utils';
-import fs from 'fs/promises';
+import fs from 'node:fs/promises';
 import '../../types/express.js';
 import 'express';
 import '../../types/http.js';

package/dist/services/frontend/frontendFs.js

@@ -1,50 +1,14 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-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 __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
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
-var frontendFs_exports = {};
-__export(frontendFs_exports, {
-  FrontendFs: () => FrontendFs,
-  frontendFsProvider: () => frontendFsProvider
-});
-module.exports = __toCommonJS(frontendFs_exports);
-var import_promises = __toESM(require("fs/promises"));
-var import_utils = require("../../utils");
+import fs from "node:fs/promises";
+import { provider } from "../../utils/index.js";
 class FrontendFs {
+  /**
+   * The service that generates the relative paths.
+   */
+  _pathUtils;
   /**
    * @param options  The options to construct the service.
    */
   constructor({ inject: { pathUtils } }) {
-    /**
-     * The service that generates the relative paths.
-     */
-    __publicField(this, "_pathUtils");
     this._pathUtils = pathUtils;
   }
   /**
@@ -53,7 +17,7 @@ class FrontendFs {
    * @param filepath  The path to the file.
    */
   delete(filepath) {
-    return import_promises.default.unlink(this.getAppPath(filepath));
+    return fs.unlink(this.getAppPath(filepath));
   }
   /**
    * Reads a file from the file system.
@@ -62,7 +26,7 @@ class FrontendFs {
    * @param encoding  The text encoding in which the file should be read.
    */
   read(filepath, encoding = "utf-8") {
-    return import_promises.default.readFile(this.getAppPath(filepath), encoding);
+    return fs.readFile(this.getAppPath(filepath), encoding);
   }
   /**
    * Writes a file on the file system.
@@ -71,7 +35,7 @@ class FrontendFs {
    * @param content   The contents of the file.
    */
   write(filepath, content) {
-    return import_promises.default.writeFile(this.getAppPath(filepath), content);
+    return fs.writeFile(this.getAppPath(filepath), content);
   }
   /**
    * Utility method to get the path of a file relative to the application executable.
@@ -82,7 +46,7 @@ class FrontendFs {
     return this._pathUtils.joinFrom("app", filepath);
   }
 }
-const frontendFsProvider = (0, import_utils.provider)((app) => {
+const frontendFsProvider = provider((app) => {
   app.set(
     "frontendFs",
     () => new FrontendFs({
@@ -92,9 +56,8 @@ const frontendFsProvider = (0, import_utils.provider)((app) => {
     })
   );
 });
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
+export {
   FrontendFs,
   frontendFsProvider
-});
+};
 //# sourceMappingURL=frontendFs.js.map

package/dist/services/frontend/frontendFs.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/frontend/frontendFs.ts"],"sourcesContent":["import fs from 'fs/promises';\nimport { provider } from '../../utils';\nimport type { PathUtils } from '../../types';\n/**\n * The options to construct a {@link FrontendFs}.\n *\n * @group Services/FrontendFs\n */\nexport type FrontendFsOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    pathUtils: PathUtils;\n  };\n};\n/**\n * This service allows the application to easily work with the filesystem. The idea behind\n * centralizing this functionalities into a service is that is pretty common to have\n * bundling tools to generate the frontend, and on that process files can have different\n * paths or not even be generated all. The service can be extended/overwritten to\n * accommodate any requirements and avoid having to update or add `if`s to every `fs` call\n * the application does.\n * Another _'feature'_ of this service is that all the paths are relative to the directory\n * where the app executable is located, so you don't have to remember the relative path\n * from the place you are accessing a file to the place where it's located.\n *\n * @group Services\n * @group Services/FrontendFs\n */\nexport class FrontendFs {\n  /**\n   * The service that generates the relative paths.\n   */\n  protected readonly _pathUtils: PathUtils;\n  /**\n   * @param options  The options to construct the service.\n   */\n  constructor({ inject: { pathUtils } }: FrontendFsOptions) {\n    this._pathUtils = pathUtils;\n  }\n  /**\n   * Deletes a file from the file system.\n   *\n   * @param filepath  The path to the file.\n   */\n  delete(filepath: string): Promise<void> {\n    return fs.unlink(this.getAppPath(filepath));\n  }\n  /**\n   * Reads a file from the file system.\n   *\n   * @param filepath  The path to the file.\n   * @param encoding  The text encoding in which the file should be read.\n   */\n  read(filepath: string, encoding: BufferEncoding = 'utf-8'): Promise<string> {\n    return fs.readFile(this.getAppPath(filepath), encoding);\n  }\n  /**\n   * Writes a file on the file system.\n   *\n   * @param filepath  The path to the file.\n   * @param content   The contents of the file.\n   */\n  write(filepath: string, content: Parameters<typeof fs.writeFile>[1]): Promise<void> {\n    return fs.writeFile(this.getAppPath(filepath), content);\n  }\n  /**\n   * Utility method to get the path of a file relative to the application executable.\n   *\n   * @param filepath  The path to the file.\n   */\n  protected getAppPath(filepath: string): string {\n    return this._pathUtils.joinFrom('app', filepath);\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link FrontendFs} as the `frontendFs` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(frontendFsProvider);\n *   // Getting access to the service instance\n *   const frontendFs = container.get<FrontendFs>('frontendFs');\n *\n * @group Providers\n * @group Services/FrontendFs\n */\nexport const frontendFsProvider = provider((app) => {\n  app.set(\n    'frontendFs',\n    () =>\n      new FrontendFs({\n        inject: {\n          pathUtils: app.get<PathUtils>('pathUtils'),\n        },\n      }),\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAe;AACf,mBAAyB;AA6BlB,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAQtB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAsB;AAJ1D;AAAA;AAAA;AAAA,wBAAmB;AAKjB,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,UAAiC;AACtC,WAAO,gBAAAA,QAAG,OAAO,KAAK,WAAW,QAAQ,CAAC;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAK,UAAkB,WAA2B,SAA0B;AAC1E,WAAO,gBAAAA,QAAG,SAAS,KAAK,WAAW,QAAQ,GAAG,QAAQ;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAkB,SAA4D;AAClF,WAAO,gBAAAA,QAAG,UAAU,KAAK,WAAW,QAAQ,GAAG,OAAO;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,WAAW,UAA0B;AAC7C,WAAO,KAAK,WAAW,SAAS,OAAO,QAAQ;AAAA,EACjD;AACF;AAeO,MAAM,yBAAqB,uBAAS,CAAC,QAAQ;AAClD,MAAI;AAAA,IACF;AAAA,IACA,MACE,IAAI,WAAW;AAAA,MACb,QAAQ;AAAA,QACN,WAAW,IAAI,IAAe,WAAW;AAAA,MAC3C;AAAA,IACF,CAAC;AAAA,EACL;AACF,CAAC;","names":["fs"]}
+{"version":3,"sources":["../../../src/services/frontend/frontendFs.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport { provider } from '../../utils/index.js';\nimport type { PathUtils } from '../../types/index.js';\n/**\n * The options to construct a {@link FrontendFs}.\n *\n * @group Services/FrontendFs\n */\nexport type FrontendFsOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    pathUtils: PathUtils;\n  };\n};\n/**\n * This service allows the application to easily work with the filesystem. The idea behind\n * centralizing this functionalities into a service is that is pretty common to have\n * bundling tools to generate the frontend, and on that process files can have different\n * paths or not even be generated all. The service can be extended/overwritten to\n * accommodate any requirements and avoid having to update or add `if`s to every `fs` call\n * the application does.\n * Another _'feature'_ of this service is that all the paths are relative to the directory\n * where the app executable is located, so you don't have to remember the relative path\n * from the place you are accessing a file to the place where it's located.\n *\n * @group Services\n * @group Services/FrontendFs\n */\nexport class FrontendFs {\n  /**\n   * The service that generates the relative paths.\n   */\n  protected readonly _pathUtils: PathUtils;\n  /**\n   * @param options  The options to construct the service.\n   */\n  constructor({ inject: { pathUtils } }: FrontendFsOptions) {\n    this._pathUtils = pathUtils;\n  }\n  /**\n   * Deletes a file from the file system.\n   *\n   * @param filepath  The path to the file.\n   */\n  delete(filepath: string): Promise<void> {\n    return fs.unlink(this.getAppPath(filepath));\n  }\n  /**\n   * Reads a file from the file system.\n   *\n   * @param filepath  The path to the file.\n   * @param encoding  The text encoding in which the file should be read.\n   */\n  read(filepath: string, encoding: BufferEncoding = 'utf-8'): Promise<string> {\n    return fs.readFile(this.getAppPath(filepath), encoding);\n  }\n  /**\n   * Writes a file on the file system.\n   *\n   * @param filepath  The path to the file.\n   * @param content   The contents of the file.\n   */\n  write(filepath: string, content: Parameters<typeof fs.writeFile>[1]): Promise<void> {\n    return fs.writeFile(this.getAppPath(filepath), content);\n  }\n  /**\n   * Utility method to get the path of a file relative to the application executable.\n   *\n   * @param filepath  The path to the file.\n   */\n  protected getAppPath(filepath: string): string {\n    return this._pathUtils.joinFrom('app', filepath);\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link FrontendFs} as the `frontendFs` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(frontendFsProvider);\n *   // Getting access to the service instance\n *   const frontendFs = container.get<FrontendFs>('frontendFs');\n *\n * @group Providers\n * @group Services/FrontendFs\n */\nexport const frontendFsProvider = provider((app) => {\n  app.set(\n    'frontendFs',\n    () =>\n      new FrontendFs({\n        inject: {\n          pathUtils: app.get<PathUtils>('pathUtils'),\n        },\n      }),\n  );\n});\n"],"mappings":"AAAA,OAAO,QAAQ;AACf,SAAS,gBAAgB;AA6BlB,MAAM,WAAW;AAAA;AAAA;AAAA;AAAA,EAIH;AAAA;AAAA;AAAA;AAAA,EAInB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAsB;AACxD,SAAK,aAAa;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,UAAiC;AACtC,WAAO,GAAG,OAAO,KAAK,WAAW,QAAQ,CAAC;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,KAAK,UAAkB,WAA2B,SAA0B;AAC1E,WAAO,GAAG,SAAS,KAAK,WAAW,QAAQ,GAAG,QAAQ;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAkB,SAA4D;AAClF,WAAO,GAAG,UAAU,KAAK,WAAW,QAAQ,GAAG,OAAO;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,WAAW,UAA0B;AAC7C,WAAO,KAAK,WAAW,SAAS,OAAO,QAAQ;AAAA,EACjD;AACF;AAeO,MAAM,qBAAqB,SAAS,CAAC,QAAQ;AAClD,MAAI;AAAA,IACF;AAAA,IACA,MACE,IAAI,WAAW;AAAA,MACb,QAAQ;AAAA,QACN,WAAW,IAAI,IAAe,WAAW;AAAA,MAC3C;AAAA,IACF,CAAC;AAAA,EACL;AACF,CAAC;","names":[]}

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

@@ -1,5 +1,5 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../index-C6I3NCC-.js';
+import { J as Jimpex } from '../../index-BlSpNHox.js';
 export { FrontendFs, FrontendFsOptions, frontendFsProvider } from './frontendFs.js';
 import '../../types/express.js';
 import 'express';
@@ -13,7 +13,7 @@ import '@homer0/path-utils';
 import '@homer0/simple-logger';
 import '@homer0/simple-config';
 import '@homer0/events-hub';
-import 'fs/promises';
+import 'node:fs/promises';
 
 /**
  * Registers all the frontend services on the container.

package/dist/services/frontend/index.js

@@ -1,36 +1,10 @@
-"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 frontend_exports = {};
-__export(frontend_exports, {
-  frontendServicesProvider: () => frontendServicesProvider
-});
-module.exports = __toCommonJS(frontend_exports);
-var import_utils = require("../../utils");
-var import_frontendFs = require("./frontendFs");
-__reExport(frontend_exports, require("./frontendFs"), module.exports);
-const frontendServicesProvider = (0, import_utils.providers)({
-  frontendFsProvider: import_frontendFs.frontendFsProvider
-});
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  frontendServicesProvider,
-  ...require("./frontendFs")
+import { providers } from "../../utils/index.js";
+import { frontendFsProvider } from "./frontendFs.js";
+const frontendServicesProvider = providers({
+  frontendFsProvider
 });
+export * from "./frontendFs.js";
+export {
+  frontendServicesProvider
+};
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/frontend/index.ts"],"sourcesContent":["import { providers } from '../../utils';\nimport { frontendFsProvider } from './frontendFs';\n/**\n * Registers all the frontend services on the container.\n *\n * - {@link FrontendFs | frontendFs}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(frontendServicesProvider);\n *   // Getting access to one the services instance\n *   const frontendFs = container.get<FrontendFs>('frontendFs');\n *\n * @group Providers\n */\nexport const frontendServicesProvider = providers({\n  frontendFsProvider,\n});\n\nexport * from './frontendFs';\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA0B;AAC1B,wBAAmC;AAmBnC,6BAAc,yBApBd;AAgBO,MAAM,+BAA2B,wBAAU;AAAA,EAChD;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../../src/services/frontend/index.ts"],"sourcesContent":["import { providers } from '../../utils/index.js';\nimport { frontendFsProvider } from './frontendFs.js';\n/**\n * Registers all the frontend services on the container.\n *\n * - {@link FrontendFs | frontendFs}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(frontendServicesProvider);\n *   // Getting access to one the services instance\n *   const frontendFs = container.get<FrontendFs>('frontendFs');\n *\n * @group Providers\n */\nexport const frontendServicesProvider = providers({\n  frontendFsProvider,\n});\n\nexport * from './frontendFs.js';\n"],"mappings":"AAAA,SAAS,iBAAiB;AAC1B,SAAS,0BAA0B;AAe5B,MAAM,2BAA2B,UAAU;AAAA,EAChD;AACF,CAAC;AAED,cAAc;","names":[]}

package/dist/services/html/htmlGenerator.d.ts

@@ -1,5 +1,5 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../index-C6I3NCC-.js';
+import { J as Jimpex } from '../../index-BlSpNHox.js';
 import { SimpleLogger } from '@homer0/simple-logger';
 import { SimpleConfig } from '@homer0/simple-config';
 import { FrontendFs } from '../frontend/frontendFs.js';
@@ -14,7 +14,7 @@ import 'node-fetch';
 import '../../types/utils.js';
 import '@homer0/path-utils';
 import '@homer0/events-hub';
-import 'fs/promises';
+import 'node:fs/promises';
 
 /**
  * The options to customize a {@link HTMLGenerator} instance.
@@ -41,7 +41,7 @@ type HTMLGeneratorOptions = {
      */
     silent: boolean;
     /**
-     * Whether or not to delete the tempalte after generating the file.
+     * Whether or not to delete the template after generating the file.
      *
      * @default true
      */
@@ -49,7 +49,7 @@ type HTMLGeneratorOptions = {
     /**
      * The placeholder string where the information will be written.
      *
-     * @default /\{\{appConfi(?:guration)?\}\}/
+     * @default /\{\{appConfig(?:uration)?\}\}/
      */
     replacePlaceholder: string | RegExp;
     /**
@@ -165,7 +165,7 @@ declare class HTMLGenerator {
     protected _fileReady: boolean;
     /**
      * A deferred promise to return when another service asks if the file has been
-     * generated. Once this sevice finishes generating the file, the promise will be
+     * generated. Once this service finishes generating the file, the promise will be
      * resolved for all implementations that hold a reference to this deferred.
      */
     protected _fileDeferred?: DeferredPromise<void>;