jimpex 8.0.0 → 9.0.0

package/dist/services/http/http.js

@@ -19,6 +19,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
 ));
@@ -38,8 +42,17 @@ var import_urijs = __toESM(require("urijs"));
 var import_deep_assign = require("@homer0/deep-assign");
 var import_utils = require("../../utils");
 class HTTP {
+  /**
+   * @param options  The options to construct the class.
+   */
   constructor({ inject: { logger }, ...options }) {
+    /**
+     * The service used to log information in the terminal.
+     */
     __publicField(this, "_logger");
+    /**
+     * The service customization options.
+     */
     __publicField(this, "_options");
     this._logger = logger;
     this._options = (0, import_deep_assign.deepAssignWithOverwrite)(
@@ -50,6 +63,12 @@ class HTTP {
     );
     this.fetch = this.fetch.bind(this);
   }
+  /**
+   * Makes a fetch request.
+   *
+   * @param url      The URL to fetch.
+   * @param options  The custom options for the request.
+   */
   async fetch(url, options = {}) {
     let useURL = url;
     if (options.qs) {
@@ -84,6 +103,11 @@ class HTTP {
     }
     return response;
   }
+  /**
+   * Tries to get the IP address from a given request.
+   *
+   * @param req  The request from which it will try to obtain the IP address.
+   */
   getIPFromRequest(req) {
     const headerValue = req.headers["x-forwarded-for"];
     if (headerValue) {
@@ -91,6 +115,13 @@ class HTTP {
     }
     return req?.connection?.remoteAddress || req?.socket?.remoteAddress;
   }
+  /**
+   * Creates a dictionary with all the custom headers a request has. By custom header it
+   * means all the headers which name start with `x-`.
+   *
+   * @param req      The request from which it will try to get the headers.
+   * @param options  The options to customize the behavior with certain headers.
+   */
   getCustomHeadersFromRequest(req, options = {}) {
     const { includeXForwardedHeaders = false } = options;
     return Object.keys(req.headers).reduce((acc, headerName) => {
@@ -100,6 +131,14 @@ class HTTP {
       return acc;
     }, {});
   }
+  /**
+   * It takes a dictionary of headers and normalize the names so each word will start with
+   * an upper case character. This is helpful in case you added custom headers and didn't
+   * care about the casing, or when copying headers from a server request, as they all
+   * come tranformed into lower case.
+   *
+   * @param headers  The dictionary of headers to normalize.
+   */
   normalizeHeaders(headers) {
     return Object.keys(headers).reduce((acc, name) => {
       const newName = name.split("-").map((part) => part.replace(/^(\w)/, (_, letter) => letter.toUpperCase())).join("-");
@@ -107,9 +146,18 @@ class HTTP {
       return acc;
     }, {});
   }
+  /**
+   * The customization options.
+   */
   get options() {
     return (0, import_deep_assign.deepAssignWithOverwrite)({}, this._options);
   }
+  /**
+   * Logs a request information into the terminal.
+   *
+   * @param url      The request URL.
+   * @param options  The options for the request.
+   */
   _logRequest(url, options) {
     const { method, headers } = options;
     const prefix = "REQUEST> ";
@@ -125,6 +173,11 @@ class HTTP {
     }
     this._logger.info(lines);
   }
+  /**
+   * Logs a response information into the terminal.
+   *
+   * @param response  The response to log.
+   */
   _logResponse(response) {
     const prefix = "RESPONSE> ";
     const lines = [

package/dist/services/http/http.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/http/http.ts"],"sourcesContent":["import fetch, { type RequestInit, type BodyInit } from 'node-fetch';\nimport urijs from 'urijs';\nimport { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport { provider } from '../../utils';\nimport { Logger, Request, HTTPResponse } from '../../types';\n/**\n * The options to customize the service.\n *\n * @group Services/HTTP\n */\nexport type HTTPOptions = {\n  /**\n   * Whether or not the service should log the requests and their responses.\n   */\n  logRequests?: boolean;\n};\n/**\n * The options to construct a {@link HTTP}.\n *\n * @group Services/HTTP\n */\nexport type HTTPContructorOptions = Partial<HTTPOptions> & {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    logger: Logger;\n  };\n};\n/**\n * The allowed formats for the body of a request.\n *\n * @group Services/HTTP\n */\nexport type HTTPFetchBody = string | Record<string | number, unknown> | BodyInit;\n/**\n * The options for a request.\n *\n * @group Services/HTTP\n */\nexport type HTTPFetchOptions = {\n  /**\n   * The HTTP method.\n   *\n   * @default 'GET'\n   */\n  method?: string;\n  /**\n   * The headers dictionary.\n   */\n  headers?: Record<string, string>;\n  /**\n   * The body of the request.\n   */\n  body?: HTTPFetchBody;\n  /**\n   * A dictionary of query string parameters.\n   */\n  qs?: Record<string, unknown>;\n  /**\n   * A request object generated by the application. This can be used to copy information\n   * like custom headers or the IP (for the X-Forwarded-For header).\n   */\n  req?: Request;\n};\n/**\n * The options for the method that extracts custom headers from a request.\n *\n * @group Services/HTTP\n */\nexport type GetCustomHeadersFromRequestOptions = {\n  /**\n   * Since the method considers all headers that start with `x-` as custom headers,\n   * setting this to `false` is the only way to exclude `x-forwarded-` headers from the\n   * list.\n   *\n   * @default false\n   */\n  includeXForwardedHeaders?: boolean;\n};\n/**\n * A set of utilities to work with HTTP requests and responses.\n *\n * @group Services\n * @group Services/HTTP\n */\nexport class HTTP {\n  /**\n   * The service used to log information in the terminal.\n   */\n  protected readonly _logger: Logger;\n  /**\n   * The service customization options.\n   */\n  protected readonly _options: HTTPOptions;\n  /**\n   * @param options  The options to construct the class.\n   */\n  constructor({ inject: { logger }, ...options }: HTTPContructorOptions) {\n    this._logger = logger;\n    this._options = deepAssignWithOverwrite(\n      {\n        logRequests: false,\n      },\n      options,\n    );\n\n    this.fetch = this.fetch.bind(this);\n  }\n  /**\n   * Makes a fetch request.\n   *\n   * @param url      The URL to fetch.\n   * @param options  The custom options for the request.\n   */\n  async fetch(url: string, options: HTTPFetchOptions = {}): Promise<HTTPResponse> {\n    let useURL = url;\n    if (options.qs) {\n      useURL = urijs(url).query(options.qs).toString();\n    }\n\n    const fetchOptions: RequestInit = {\n      method: (options.method || 'get').toUpperCase(),\n      body: options.body as BodyInit,\n    };\n\n    let defaultHeaders: Record<string, string> | undefined;\n    if (options.req) {\n      defaultHeaders = this.getCustomHeadersFromRequest(options.req);\n      const ip = this.getIPFromRequest(options.req);\n      if (ip) {\n        defaultHeaders['x-forwarded-for'] = ip;\n      }\n    }\n    const headers = {\n      ...defaultHeaders,\n      ...options.headers,\n    };\n\n    if (Object.keys(headers).length) {\n      fetchOptions.headers = this.normalizeHeaders(headers);\n    }\n\n    const { logRequests } = this._options;\n    if (logRequests) {\n      this._logRequest(useURL, fetchOptions);\n    }\n\n    const response = await fetch(useURL, fetchOptions);\n    if (logRequests) {\n      this._logResponse(response);\n    }\n\n    return response;\n  }\n  /**\n   * Tries to get the IP address from a given request.\n   *\n   * @param req  The request from which it will try to obtain the IP address.\n   */\n  getIPFromRequest(req: Request): string | undefined {\n    const headerValue = req.headers['x-forwarded-for'];\n    if (headerValue) {\n      return String(headerValue);\n    }\n\n    return req?.connection?.remoteAddress || req?.socket?.remoteAddress;\n  }\n  /**\n   * Creates a dictionary with all the custom headers a request has. By custom header it\n   * means all the headers which name start with `x-`.\n   *\n   * @param req      The request from which it will try to get the headers.\n   * @param options  The options to customize the behavior with certain headers.\n   */\n  getCustomHeadersFromRequest(\n    req: Request,\n    options: GetCustomHeadersFromRequestOptions = {},\n  ): Record<string, string> {\n    const { includeXForwardedHeaders = false } = options;\n    return Object.keys(req.headers).reduce<Record<string, string>>((acc, headerName) => {\n      if (\n        headerName.startsWith('x-') &&\n        (includeXForwardedHeaders || !headerName.startsWith('x-forwarded-'))\n      ) {\n        acc[headerName] = req.headers[headerName] as string;\n      }\n      return acc;\n    }, {});\n  }\n  /**\n   * It takes a dictionary of headers and normalize the names so each word will start with\n   * an upper case character. This is helpful in case you added custom headers and didn't\n   * care about the casing, or when copying headers from a server request, as they all\n   * come tranformed into lower case.\n   *\n   * @param headers  The dictionary of headers to normalize.\n   */\n  normalizeHeaders(headers: Record<string, string>): Record<string, string> {\n    return Object.keys(headers).reduce<Record<string, string>>((acc, name) => {\n      const newName = name\n        .split('-')\n        .map((part) => part.replace(/^(\\w)/, (_, letter) => letter.toUpperCase()))\n        .join('-');\n\n      acc[newName] = headers[name]!;\n      return acc;\n    }, {});\n  }\n  /**\n   * The customization options.\n   */\n  get options(): Readonly<HTTPOptions> {\n    return deepAssignWithOverwrite({}, this._options);\n  }\n  /**\n   * Logs a request information into the terminal.\n   *\n   * @param url      The request URL.\n   * @param options  The options for the request.\n   */\n  protected _logRequest(url: string, options: RequestInit): void {\n    const { method, headers } = options;\n    const prefix = 'REQUEST> ';\n    const lines = ['--->>', `${prefix}${method} ${url}`];\n    if (headers) {\n      Object.keys(headers).forEach((header) => {\n        const value = headers[header as keyof typeof headers];\n        lines.push(`${prefix}${header}: ${value}`);\n      });\n    }\n\n    if (options.body) {\n      lines.push(`${prefix}body: \"${options.body}\"`);\n    }\n\n    this._logger.info(lines);\n  }\n  /**\n   * Logs a response information into the terminal.\n   *\n   * @param response  The response to log.\n   */\n  protected _logResponse(response: HTTPResponse) {\n    const prefix = 'RESPONSE> ';\n    const lines = [\n      '<<---',\n      `${prefix}${response.url}`,\n      `${prefix}status: ${response.status}`,\n    ];\n\n    response.headers.forEach((value, header) => {\n      lines.push(`${prefix}${header}: ${value}`);\n    });\n\n    this._logger.info(lines);\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link HTTP} as the `http` service. The provider also checks the `debug.logRequests`\n * setting on the application configuration in order to enable or not the logging of\n * requests/responses.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(httpProvider);\n *   // Getting access to the service instance\n *   const http = container.get<HTTP>('http');\n *\n * @group Providers\n * @group Services/HTTP\n */\nexport const httpProvider = provider((app) => {\n  app.set('http', () => {\n    const config = app.getConfig();\n    const logRequests = config.get<boolean | undefined>('debug.logRequests') === true;\n    return new HTTP({\n      inject: {\n        logger: app.get('logger'),\n      },\n      logRequests,\n    });\n  });\n});\n"],"mappings":"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","names":["urijs","fetch"]}
+{"version":3,"sources":["../../../src/services/http/http.ts"],"sourcesContent":["import fetch, { type RequestInit, type BodyInit } from 'node-fetch';\nimport urijs from 'urijs';\nimport { deepAssignWithOverwrite } from '@homer0/deep-assign';\nimport { provider } from '../../utils';\nimport { Logger, Request, HTTPResponse } from '../../types';\n/**\n * The options to customize the service.\n *\n * @group Services/HTTP\n */\nexport type HTTPOptions = {\n  /**\n   * Whether or not the service should log the requests and their responses.\n   */\n  logRequests?: boolean;\n};\n/**\n * The options to construct a {@link HTTP}.\n *\n * @group Services/HTTP\n */\nexport type HTTPContructorOptions = Partial<HTTPOptions> & {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    logger: Logger;\n  };\n};\n/**\n * The allowed formats for the body of a request.\n *\n * @group Services/HTTP\n */\nexport type HTTPFetchBody = string | Record<string | number, unknown> | BodyInit;\n/**\n * The options for a request.\n *\n * @group Services/HTTP\n */\nexport type HTTPFetchOptions = {\n  /**\n   * The HTTP method.\n   *\n   * @default 'GET'\n   */\n  method?: string;\n  /**\n   * The headers dictionary.\n   */\n  headers?: Record<string, string>;\n  /**\n   * The body of the request.\n   */\n  body?: HTTPFetchBody;\n  /**\n   * A dictionary of query string parameters.\n   */\n  qs?: Record<string, unknown>;\n  /**\n   * A request object generated by the application. This can be used to copy information\n   * like custom headers or the IP (for the X-Forwarded-For header).\n   */\n  req?: Request;\n};\n/**\n * The options for the method that extracts custom headers from a request.\n *\n * @group Services/HTTP\n */\nexport type GetCustomHeadersFromRequestOptions = {\n  /**\n   * Since the method considers all headers that start with `x-` as custom headers,\n   * setting this to `false` is the only way to exclude `x-forwarded-` headers from the\n   * list.\n   *\n   * @default false\n   */\n  includeXForwardedHeaders?: boolean;\n};\n/**\n * A set of utilities to work with HTTP requests and responses.\n *\n * @group Services\n * @group Services/HTTP\n */\nexport class HTTP {\n  /**\n   * The service used to log information in the terminal.\n   */\n  protected readonly _logger: Logger;\n  /**\n   * The service customization options.\n   */\n  protected readonly _options: HTTPOptions;\n  /**\n   * @param options  The options to construct the class.\n   */\n  constructor({ inject: { logger }, ...options }: HTTPContructorOptions) {\n    this._logger = logger;\n    this._options = deepAssignWithOverwrite(\n      {\n        logRequests: false,\n      },\n      options,\n    );\n\n    this.fetch = this.fetch.bind(this);\n  }\n  /**\n   * Makes a fetch request.\n   *\n   * @param url      The URL to fetch.\n   * @param options  The custom options for the request.\n   */\n  async fetch(url: string, options: HTTPFetchOptions = {}): Promise<HTTPResponse> {\n    let useURL = url;\n    if (options.qs) {\n      useURL = urijs(url).query(options.qs).toString();\n    }\n\n    const fetchOptions: RequestInit = {\n      method: (options.method || 'get').toUpperCase(),\n      body: options.body as BodyInit,\n    };\n\n    let defaultHeaders: Record<string, string> | undefined;\n    if (options.req) {\n      defaultHeaders = this.getCustomHeadersFromRequest(options.req);\n      const ip = this.getIPFromRequest(options.req);\n      if (ip) {\n        defaultHeaders['x-forwarded-for'] = ip;\n      }\n    }\n    const headers = {\n      ...defaultHeaders,\n      ...options.headers,\n    };\n\n    if (Object.keys(headers).length) {\n      fetchOptions.headers = this.normalizeHeaders(headers);\n    }\n\n    const { logRequests } = this._options;\n    if (logRequests) {\n      this._logRequest(useURL, fetchOptions);\n    }\n\n    const response = await fetch(useURL, fetchOptions);\n    if (logRequests) {\n      this._logResponse(response);\n    }\n\n    return response;\n  }\n  /**\n   * Tries to get the IP address from a given request.\n   *\n   * @param req  The request from which it will try to obtain the IP address.\n   */\n  getIPFromRequest(req: Request): string | undefined {\n    const headerValue = req.headers['x-forwarded-for'];\n    if (headerValue) {\n      return String(headerValue);\n    }\n\n    return req?.connection?.remoteAddress || req?.socket?.remoteAddress;\n  }\n  /**\n   * Creates a dictionary with all the custom headers a request has. By custom header it\n   * means all the headers which name start with `x-`.\n   *\n   * @param req      The request from which it will try to get the headers.\n   * @param options  The options to customize the behavior with certain headers.\n   */\n  getCustomHeadersFromRequest(\n    req: Request,\n    options: GetCustomHeadersFromRequestOptions = {},\n  ): Record<string, string> {\n    const { includeXForwardedHeaders = false } = options;\n    return Object.keys(req.headers).reduce<Record<string, string>>((acc, headerName) => {\n      if (\n        headerName.startsWith('x-') &&\n        (includeXForwardedHeaders || !headerName.startsWith('x-forwarded-'))\n      ) {\n        acc[headerName] = req.headers[headerName] as string;\n      }\n      return acc;\n    }, {});\n  }\n  /**\n   * It takes a dictionary of headers and normalize the names so each word will start with\n   * an upper case character. This is helpful in case you added custom headers and didn't\n   * care about the casing, or when copying headers from a server request, as they all\n   * come tranformed into lower case.\n   *\n   * @param headers  The dictionary of headers to normalize.\n   */\n  normalizeHeaders(headers: Record<string, string>): Record<string, string> {\n    return Object.keys(headers).reduce<Record<string, string>>((acc, name) => {\n      const newName = name\n        .split('-')\n        .map((part) => part.replace(/^(\\w)/, (_, letter) => letter.toUpperCase()))\n        .join('-');\n\n      acc[newName] = headers[name]!;\n      return acc;\n    }, {});\n  }\n  /**\n   * The customization options.\n   */\n  get options(): Readonly<HTTPOptions> {\n    return deepAssignWithOverwrite({}, this._options);\n  }\n  /**\n   * Logs a request information into the terminal.\n   *\n   * @param url      The request URL.\n   * @param options  The options for the request.\n   */\n  protected _logRequest(url: string, options: RequestInit): void {\n    const { method, headers } = options;\n    const prefix = 'REQUEST> ';\n    const lines = ['--->>', `${prefix}${method} ${url}`];\n    if (headers) {\n      Object.keys(headers).forEach((header) => {\n        const value = headers[header as keyof typeof headers];\n        lines.push(`${prefix}${header}: ${value}`);\n      });\n    }\n\n    if (options.body) {\n      lines.push(`${prefix}body: \"${options.body}\"`);\n    }\n\n    this._logger.info(lines);\n  }\n  /**\n   * Logs a response information into the terminal.\n   *\n   * @param response  The response to log.\n   */\n  protected _logResponse(response: HTTPResponse) {\n    const prefix = 'RESPONSE> ';\n    const lines = [\n      '<<---',\n      `${prefix}${response.url}`,\n      `${prefix}status: ${response.status}`,\n    ];\n\n    response.headers.forEach((value, header) => {\n      lines.push(`${prefix}${header}: ${value}`);\n    });\n\n    this._logger.info(lines);\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link HTTP} as the `http` service. The provider also checks the `debug.logRequests`\n * setting on the application configuration in order to enable or not the logging of\n * requests/responses.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(httpProvider);\n *   // Getting access to the service instance\n *   const http = container.get<HTTP>('http');\n *\n * @group Providers\n * @group Services/HTTP\n */\nexport const httpProvider = provider((app) => {\n  app.set('http', () => {\n    const config = app.getConfig();\n    const logRequests = config.get<boolean | undefined>('debug.logRequests') === true;\n    return new HTTP({\n      inject: {\n        logger: app.get('logger'),\n      },\n      logRequests,\n    });\n  });\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,wBAAuD;AACvD,mBAAkB;AAClB,yBAAwC;AACxC,mBAAyB;AAmFlB,MAAM,KAAK;AAAA;AAAA;AAAA;AAAA,EAYhB,YAAY,EAAE,QAAQ,EAAE,OAAO,GAAG,GAAG,QAAQ,GAA0B;AARvE;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAKjB,SAAK,UAAU;AACf,SAAK,eAAW;AAAA,MACd;AAAA,QACE,aAAa;AAAA,MACf;AAAA,MACA;AAAA,IACF;AAEA,SAAK,QAAQ,KAAK,MAAM,KAAK,IAAI;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAM,KAAa,UAA4B,CAAC,GAA0B;AAC9E,QAAI,SAAS;AACb,QAAI,QAAQ,IAAI;AACd,mBAAS,aAAAA,SAAM,GAAG,EAAE,MAAM,QAAQ,EAAE,EAAE,SAAS;AAAA,IACjD;AAEA,UAAM,eAA4B;AAAA,MAChC,SAAS,QAAQ,UAAU,OAAO,YAAY;AAAA,MAC9C,MAAM,QAAQ;AAAA,IAChB;AAEA,QAAI;AACJ,QAAI,QAAQ,KAAK;AACf,uBAAiB,KAAK,4BAA4B,QAAQ,GAAG;AAC7D,YAAM,KAAK,KAAK,iBAAiB,QAAQ,GAAG;AAC5C,UAAI,IAAI;AACN,uBAAe,iBAAiB,IAAI;AAAA,MACtC;AAAA,IACF;AACA,UAAM,UAAU;AAAA,MACd,GAAG;AAAA,MACH,GAAG,QAAQ;AAAA,IACb;AAEA,QAAI,OAAO,KAAK,OAAO,EAAE,QAAQ;AAC/B,mBAAa,UAAU,KAAK,iBAAiB,OAAO;AAAA,IACtD;AAEA,UAAM,EAAE,YAAY,IAAI,KAAK;AAC7B,QAAI,aAAa;AACf,WAAK,YAAY,QAAQ,YAAY;AAAA,IACvC;AAEA,UAAM,WAAW,UAAM,kBAAAC,SAAM,QAAQ,YAAY;AACjD,QAAI,aAAa;AACf,WAAK,aAAa,QAAQ;AAAA,IAC5B;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,iBAAiB,KAAkC;AACjD,UAAM,cAAc,IAAI,QAAQ,iBAAiB;AACjD,QAAI,aAAa;AACf,aAAO,OAAO,WAAW;AAAA,IAC3B;AAEA,WAAO,KAAK,YAAY,iBAAiB,KAAK,QAAQ;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,4BACE,KACA,UAA8C,CAAC,GACvB;AACxB,UAAM,EAAE,2BAA2B,MAAM,IAAI;AAC7C,WAAO,OAAO,KAAK,IAAI,OAAO,EAAE,OAA+B,CAAC,KAAK,eAAe;AAClF,UACE,WAAW,WAAW,IAAI,MACzB,4BAA4B,CAAC,WAAW,WAAW,cAAc,IAClE;AACA,YAAI,UAAU,IAAI,IAAI,QAAQ,UAAU;AAAA,MAC1C;AACA,aAAO;AAAA,IACT,GAAG,CAAC,CAAC;AAAA,EACP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,iBAAiB,SAAyD;AACxE,WAAO,OAAO,KAAK,OAAO,EAAE,OAA+B,CAAC,KAAK,SAAS;AACxE,YAAM,UAAU,KACb,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,QAAQ,SAAS,CAAC,GAAG,WAAW,OAAO,YAAY,CAAC,CAAC,EACxE,KAAK,GAAG;AAEX,UAAI,OAAO,IAAI,QAAQ,IAAI;AAC3B,aAAO;AAAA,IACT,GAAG,CAAC,CAAC;AAAA,EACP;AAAA;AAAA;AAAA;AAAA,EAIA,IAAI,UAAiC;AACnC,eAAO,4CAAwB,CAAC,GAAG,KAAK,QAAQ;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOU,YAAY,KAAa,SAA4B;AAC7D,UAAM,EAAE,QAAQ,QAAQ,IAAI;AAC5B,UAAM,SAAS;AACf,UAAM,QAAQ,CAAC,SAAS,GAAG,MAAM,GAAG,MAAM,IAAI,GAAG,EAAE;AACnD,QAAI,SAAS;AACX,aAAO,KAAK,OAAO,EAAE,QAAQ,CAAC,WAAW;AACvC,cAAM,QAAQ,QAAQ,MAA8B;AACpD,cAAM,KAAK,GAAG,MAAM,GAAG,MAAM,KAAK,KAAK,EAAE;AAAA,MAC3C,CAAC;AAAA,IACH;AAEA,QAAI,QAAQ,MAAM;AAChB,YAAM,KAAK,GAAG,MAAM,UAAU,QAAQ,IAAI,GAAG;AAAA,IAC/C;AAEA,SAAK,QAAQ,KAAK,KAAK;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMU,aAAa,UAAwB;AAC7C,UAAM,SAAS;AACf,UAAM,QAAQ;AAAA,MACZ;AAAA,MACA,GAAG,MAAM,GAAG,SAAS,GAAG;AAAA,MACxB,GAAG,MAAM,WAAW,SAAS,MAAM;AAAA,IACrC;AAEA,aAAS,QAAQ,QAAQ,CAAC,OAAO,WAAW;AAC1C,YAAM,KAAK,GAAG,MAAM,GAAG,MAAM,KAAK,KAAK,EAAE;AAAA,IAC3C,CAAC;AAED,SAAK,QAAQ,KAAK,KAAK;AAAA,EACzB;AACF;AAiBO,MAAM,mBAAe,uBAAS,CAAC,QAAQ;AAC5C,MAAI,IAAI,QAAQ,MAAM;AACpB,UAAM,SAAS,IAAI,UAAU;AAC7B,UAAM,cAAc,OAAO,IAAyB,mBAAmB,MAAM;AAC7E,WAAO,IAAI,KAAK;AAAA,MACd,QAAQ;AAAA,QACN,QAAQ,IAAI,IAAI,QAAQ;AAAA,MAC1B;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH,CAAC;","names":["urijs","fetch"]}

package/dist/services/http/index.d.mts

@@ -0,0 +1,51 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex } from '../../index-efeb437e.js';
+export { ErrorResponse } from '@homer0/api-utils';
+import { APIClientProviderOptions } from './apiClient.mjs';
+export { APIClient, APIClientConfig, APIClientConstructorOptions, APIClientSettings, EndpointsType, apiClientProvider } from './apiClient.mjs';
+export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFetchBody, HTTPFetchOptions, HTTPOptions, httpProvider } from './http.mjs';
+export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './responsesBuilder.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 '../common/httpError.mjs';
+import '../../utils/fns/statuses.mjs';
+import 'statuses';
+import '../common/appError.mjs';
+
+/**
+ * Registers all the HTTP services on the container.
+ *
+ * - {@link APIClient | apiClient}
+ * - {@link HTTP | http}
+ * - {@link ResponsesBuilder | responsesBuilder}
+ *
+ * @example
+ *
+ *   // Register the collection on the container
+ *   container.register(httpServicesProvider);
+ *   // Getting access to one the services instance
+ *   const apiClient = container.get<APIClient>('apiClient');
+ *
+ * @group Providers
+ */
+declare const httpServicesProvider: {
+    apiClientProvider: _homer0_jimple.ResourceCreator<"provider", "register", (options?: APIClientProviderOptions) => (app: Jimpex) => void, _homer0_jimple.ProviderRegisterFn<Jimpex>>;
+    httpProvider: _homer0_jimple.Resource<"provider", "register", _homer0_jimple.ProviderRegisterFn<Jimpex>>;
+    responsesBuilderProvider: _homer0_jimple.Resource<"provider", "register", _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 { APIClientProviderOptions, httpServicesProvider };

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

@@ -1,11 +1,10 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../jimpex-7eaee271.js';
+import { J as Jimpex } from '../../index-b2a04c78.js';
 export { ErrorResponse } from '@homer0/api-utils';
 import { APIClientProviderOptions } from './apiClient.js';
 export { APIClient, APIClientConfig, APIClientConstructorOptions, APIClientSettings, EndpointsType, apiClientProvider } from './apiClient.js';
 export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFetchBody, HTTPFetchOptions, HTTPOptions, httpProvider } from './http.js';
 export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './responsesBuilder.js';
-import '@homer0/events-hub';
 import '../../types/express.js';
 import 'express';
 import '../../types/http.js';
@@ -13,9 +12,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 '../common/httpError.js';
 import '../../utils/fns/statuses.js';
 import 'statuses';

package/dist/services/http/index.js

@@ -36,6 +36,9 @@ const httpServicesProvider = (0, import_utils.providers)({
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  httpServicesProvider
+  httpServicesProvider,
+  ...require("./apiClient"),
+  ...require("./http"),
+  ...require("./responsesBuilder")
 });
 //# sourceMappingURL=index.js.map

package/dist/services/http/responsesBuilder.d.mts

@@ -0,0 +1,179 @@
+import * as _homer0_jimple from '@homer0/jimple';
+import { J as Jimpex } from '../../index-efeb437e.js';
+import { Response } from 'express';
+import { Statuses } from '../../utils/fns/statuses.mjs';
+import { SimpleConfig } from '@homer0/simple-config';
+import '../../types/express.mjs';
+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/events-hub';
+import 'statuses';
+
+/**
+ * The options to construct a {@link ResponsesBuilder}.
+ *
+ * @group Services/ResponsesBuilder
+ */
+type ResponsesBuilderConstructorOptions = {
+    /**
+     * A dictionary with the dependencies to inject.
+     */
+    inject: {
+        config: SimpleConfig;
+        statuses: Statuses;
+    };
+};
+/**
+ * The options to build a response for a post message.
+ *
+ * @group Services/ResponsesBuilder
+ */
+type HTMLPostMessageResponseOptions = {
+    /**
+     * The response object generated by the application.
+     */
+    res: Response;
+    /**
+     * The title for the HTML.
+     */
+    title: string;
+    /**
+     * The contents of the post message.
+     */
+    message: string;
+    /**
+     * The status code for the response.
+     *
+     * @default 200
+     */
+    status?: number | string;
+    /**
+     * From which object will the `postMessage` method called from.
+     *
+     * @default 'window.opener'
+     */
+    target?: string;
+    /**
+     * Whether or not to call `window.close` after sending the message.
+     *
+     * @default true
+     */
+    close?: boolean;
+    /**
+     * In case `close` is set to `true`, this option is to specify how many milliseconds
+     * should be waited before closing the window.
+     *
+     * @default 700
+     */
+    closeDelay?: number;
+};
+/**
+ * The options to build a reponse for JSON.
+ *
+ * @group Services/ResponsesBuilder
+ */
+type JSONResponseOptions = {
+    /**
+     * The response object generated by the application.
+     */
+    res: Response;
+    /**
+     * The actual data for the response. It will be added in a `data` property.
+     */
+    data: unknown;
+    /**
+     * The status code for the response.
+     *
+     * @default 200
+     */
+    status?: number | string;
+    /**
+     * Extra information to include inside the `metadata` object.
+     */
+    metadata?: object;
+};
+/**
+ * A utility service to build responses.
+ *
+ * @group Services
+ * @group Services/ResponsesBuilder
+ */
+declare class ResponsesBuilder {
+    /**
+     * The application configuration, to get the `version` and the `postMessagesPrefix`.
+     */
+    protected readonly _config: SimpleConfig;
+    /**
+     * The uility service to get HTTP status codes.
+     */
+    protected readonly _statuses: Statuses;
+    /**
+     * @param options  The options to construct the service.
+     */
+    constructor({ inject: { config, statuses } }: ResponsesBuilderConstructorOptions);
+    /**
+     * Generates and send an HTML response that emits a post message.
+     * The post message will be prefixed with the value of the configuration setting
+     * `postMessagesPrefix`.
+     *
+     * @param options  The options to customize how the HTML is generated.
+     */
+    htmlPostMessage(options: HTMLPostMessageResponseOptions): void;
+    /**
+     * Generates and sends a JSON response.
+     *
+     * @param options  The options to customize how the JSON is generated.
+     * @example
+     *
+     * <caption>The generated looks like this.</caption>
+     *
+     * {
+     *   metadata: {
+     *     version: 'dev',
+     *     status: 200,
+     *   },
+     *   data: { foo: 'bar' },
+     * }
+     *
+     */
+    json(options: JSONResponseOptions): void;
+    /**
+     * Generates a basic HTML template for the service to use when generating a post message
+     * response.
+     *
+     * @param title  The HTML `<title />` attribute.
+     * @param code   Javascript code to be wrapped on a `<script />` tag.
+     */
+    protected _htmlTemplate(title: string, code: string): string;
+    /**
+     * Utility method used to make sure a recevied status is a valid status code. If the
+     * status is a string, the method will try to find the code from the `statuses` package.
+     *
+     * @param status  The status to normalize.
+     * @returns If `status` is a string, but there's no valid code, it will return 200.
+     */
+    protected _normalizeStatus(status: number | string): number;
+}
+/**
+ * The service provider that once registered on the container will set an instance of
+ * {@link ResponsesBuilder} as the `responsesBuilder` service.
+ *
+ * @example
+ *
+ *   // Register it on the container
+ *   container.register(responsesBuilderProvider);
+ *   // Getting access to the service instance
+ *   const responsesBuilder = container.get<ResponsesBuilder>('responsesBuilder');
+ *
+ * @group Providers
+ * @group Services/ResponsesBuilder
+ */
+declare const responsesBuilderProvider: _homer0_jimple.Resource<"provider", "register", _homer0_jimple.ProviderRegisterFn<Jimpex>>;
+
+export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider };

package/dist/services/http/responsesBuilder.d.ts

@@ -1,9 +1,8 @@
 import * as _homer0_jimple from '@homer0/jimple';
-import { J as Jimpex } from '../../jimpex-7eaee271.js';
+import { J as Jimpex } from '../../index-b2a04c78.js';
 import { Response } from 'express';
 import { Statuses } from '../../utils/fns/statuses.js';
 import { SimpleConfig } from '@homer0/simple-config';
-import '@homer0/events-hub';
 import '../../types/express.js';
 import '../../types/http.js';
 import 'https';
@@ -11,7 +10,9 @@ import 'http';
 import 'spdy';
 import 'node-fetch';
 import '../../types/utils.js';
+import '@homer0/path-utils';
 import '@homer0/simple-logger';
+import '@homer0/events-hub';
 import 'statuses';
 
 /**

package/dist/services/http/responsesBuilder.js

@@ -30,12 +30,28 @@ module.exports = __toCommonJS(responsesBuilder_exports);
 var import_utils = require("../../utils");
 const DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE = 700;
 class ResponsesBuilder {
+  /**
+   * @param options  The options to construct the service.
+   */
   constructor({ inject: { config, statuses } }) {
+    /**
+     * The application configuration, to get the `version` and the `postMessagesPrefix`.
+     */
     __publicField(this, "_config");
+    /**
+     * The uility service to get HTTP status codes.
+     */
     __publicField(this, "_statuses");
     this._config = config;
     this._statuses = statuses;
   }
+  /**
+   * Generates and send an HTML response that emits a post message.
+   * The post message will be prefixed with the value of the configuration setting
+   * `postMessagesPrefix`.
+   *
+   * @param options  The options to customize how the HTML is generated.
+   */
   htmlPostMessage(options) {
     const {
       res,
@@ -66,6 +82,23 @@ class ResponsesBuilder {
     res.write(html);
     res.end();
   }
+  /**
+   * Generates and sends a JSON response.
+   *
+   * @param options  The options to customize how the JSON is generated.
+   * @example
+   *
+   * <caption>The generated looks like this.</caption>
+   *
+   * {
+   *   metadata: {
+   *     version: 'dev',
+   *     status: 200,
+   *   },
+   *   data: { foo: 'bar' },
+   * }
+   *
+   */
   json(options) {
     const { res, data, status, metadata = {} } = options;
     const useStatus = typeof status === "undefined" ? this._statuses("ok") : this._normalizeStatus(status);
@@ -80,6 +113,13 @@ class ResponsesBuilder {
     });
     res.end();
   }
+  /**
+   * Generates a basic HTML template for the service to use when generating a post message
+   * response.
+   *
+   * @param title  The HTML `<title />` attribute.
+   * @param code   Javascript code to be wrapped on a `<script />` tag.
+   */
   _htmlTemplate(title, code) {
     return `
       <!DOCTYPE html>
@@ -93,11 +133,18 @@ class ResponsesBuilder {
         <body>
           <script type="text/javascript">
           ${code}
-        <\/script>
+        </script>
       </body>
     </html>
     `;
   }
+  /**
+   * Utility method used to make sure a recevied status is a valid status code. If the
+   * status is a string, the method will try to find the code from the `statuses` package.
+   *
+   * @param status  The status to normalize.
+   * @returns If `status` is a string, but there's no valid code, it will return 200.
+   */
   _normalizeStatus(status) {
     let useStatus;
     try {

package/dist/services/http/responsesBuilder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/services/http/responsesBuilder.ts"],"sourcesContent":["import type { Config, Response } from '../../types';\nimport { provider, type Statuses } from '../../utils';\n/**\n * The options to construct a {@link ResponsesBuilder}.\n *\n * @group Services/ResponsesBuilder\n */\nexport type ResponsesBuilderConstructorOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    config: Config;\n    statuses: Statuses;\n  };\n};\n/**\n * The options to build a response for a post message.\n *\n * @group Services/ResponsesBuilder\n */\nexport type HTMLPostMessageResponseOptions = {\n  /**\n   * The response object generated by the application.\n   */\n  res: Response;\n  /**\n   * The title for the HTML.\n   */\n  title: string;\n  /**\n   * The contents of the post message.\n   */\n  message: string;\n  /**\n   * The status code for the response.\n   *\n   * @default 200\n   */\n  status?: number | string;\n  /**\n   * From which object will the `postMessage` method called from.\n   *\n   * @default 'window.opener'\n   */\n  target?: string;\n  /**\n   * Whether or not to call `window.close` after sending the message.\n   *\n   * @default true\n   */\n  close?: boolean;\n  /**\n   * In case `close` is set to `true`, this option is to specify how many milliseconds\n   * should be waited before closing the window.\n   *\n   * @default 700\n   */\n  closeDelay?: number;\n};\n/**\n * The options to build a reponse for JSON.\n *\n * @group Services/ResponsesBuilder\n */\nexport type JSONResponseOptions = {\n  /**\n   * The response object generated by the application.\n   */\n  res: Response;\n  /**\n   * The actual data for the response. It will be added in a `data` property.\n   */\n  data: unknown;\n  /**\n   * The status code for the response.\n   *\n   * @default 200\n   */\n  status?: number | string;\n  /**\n   * Extra information to include inside the `metadata` object.\n   */\n  metadata?: object;\n};\n/**\n * The default time to wait before closing a window, in case it's enabled.\n */\nconst DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE = 700;\n/**\n * A utility service to build responses.\n *\n * @group Services\n * @group Services/ResponsesBuilder\n */\nexport class ResponsesBuilder {\n  /**\n   * The application configuration, to get the `version` and the `postMessagesPrefix`.\n   */\n  protected readonly _config: Config;\n  /**\n   * The uility service to get HTTP status codes.\n   */\n  protected readonly _statuses: Statuses;\n  /**\n   * @param options  The options to construct the service.\n   */\n  constructor({ inject: { config, statuses } }: ResponsesBuilderConstructorOptions) {\n    this._config = config;\n    this._statuses = statuses;\n  }\n  /**\n   * Generates and send an HTML response that emits a post message.\n   * The post message will be prefixed with the value of the configuration setting\n   * `postMessagesPrefix`.\n   *\n   * @param options  The options to customize how the HTML is generated.\n   */\n  htmlPostMessage(options: HTMLPostMessageResponseOptions): void {\n    const {\n      res,\n      title,\n      message,\n      status,\n      target = 'window.opener',\n      close = true,\n      closeDelay = DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE,\n    } = options;\n    const prefix = this._config.get<string | undefined>('postMessagesPrefix') ?? '';\n    const closeCode = close\n      ? `setTimeout(function() { window.close(); }, ${closeDelay});`\n      : '';\n\n    const html = this._htmlTemplate(\n      title,\n      `\n      (function() {\n        if (${target}) {\n          ${target}.postMessage('${prefix}${message}', '*');\n          ${closeCode}\n        }\n      })();\n      `,\n    );\n\n    const useStatus =\n      typeof status === 'undefined'\n        ? (this._statuses('ok') as number)\n        : this._normalizeStatus(status);\n\n    res.setHeader('Content-Type', 'text/html');\n    res.setHeader('Cache-Control', 'no-cache, max-age=0, must-revalidate, no-store');\n    res.status(useStatus);\n    res.write(html);\n    res.end();\n  }\n  /**\n   * Generates and sends a JSON response.\n   *\n   * @param options  The options to customize how the JSON is generated.\n   * @example\n   *\n   * <caption>The generated looks like this.</caption>\n   *\n   * {\n   *   metadata: {\n   *     version: 'dev',\n   *     status: 200,\n   *   },\n   *   data: { foo: 'bar' },\n   * }\n   *\n   */\n  json(options: JSONResponseOptions): void {\n    const { res, data, status, metadata = {} } = options;\n    const useStatus =\n      typeof status === 'undefined'\n        ? (this._statuses('ok') as number)\n        : this._normalizeStatus(status);\n\n    res.status(useStatus);\n    res.json({\n      metadata: {\n        version: this._config.get<string>('version'),\n        status: useStatus,\n        ...metadata,\n      },\n      data,\n    });\n    res.end();\n  }\n  /**\n   * Generates a basic HTML template for the service to use when generating a post message\n   * response.\n   *\n   * @param title  The HTML `<title />` attribute.\n   * @param code   Javascript code to be wrapped on a `<script />` tag.\n   */\n  protected _htmlTemplate(title: string, code: string): string {\n    return `\n      <!DOCTYPE html>\n      <html>\n        <head>\n          <meta charset=\"utf-8\" />\n          <meta http-equiv=\"x-ua-compatible\" content=\"ie=edge\" />\n          <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n          <title>${title}</title>\n        </head>\n        <body>\n          <script type=\"text/javascript\">\n          ${code}\n        </script>\n      </body>\n    </html>\n    `;\n  }\n  /**\n   * Utility method used to make sure a recevied status is a valid status code. If the\n   * status is a string, the method will try to find the code from the `statuses` package.\n   *\n   * @param status  The status to normalize.\n   * @returns If `status` is a string, but there's no valid code, it will return 200.\n   */\n  protected _normalizeStatus(status: number | string): number {\n    let useStatus: number;\n    try {\n      if (typeof status === 'string') {\n        useStatus = this._statuses(status) as number;\n      } else {\n        this._statuses(status);\n        useStatus = status;\n      }\n    } catch (_) {\n      useStatus = this._statuses('ok') as number;\n    }\n\n    return useStatus;\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link ResponsesBuilder} as the `responsesBuilder` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(responsesBuilderProvider);\n *   // Getting access to the service instance\n *   const responsesBuilder = container.get<ResponsesBuilder>('responsesBuilder');\n *\n * @group Providers\n * @group Services/ResponsesBuilder\n */\nexport const responsesBuilderProvider = provider((app) => {\n  app.set(\n    'responsesBuilder',\n    () =>\n      new ResponsesBuilder({\n        inject: {\n          config: app.getConfig(),\n          statuses: app.get('statuses'),\n        },\n      }),\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAwC;AAuFxC,MAAM,uCAAuC;AAOtC,MAAM,iBAAiB;AAAA,EAY5B,YAAY,EAAE,QAAQ,EAAE,QAAQ,SAAS,EAAE,GAAuC;AARlF,wBAAmB;AAInB,wBAAmB;AAKjB,SAAK,UAAU;AACf,SAAK,YAAY;AAAA,EACnB;AAAA,EAQA,gBAAgB,SAA+C;AAC7D,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,aAAa;AAAA,IACf,IAAI;AACJ,UAAM,SAAS,KAAK,QAAQ,IAAwB,oBAAoB,KAAK;AAC7E,UAAM,YAAY,QACd,8CAA8C,iBAC9C;AAEJ,UAAM,OAAO,KAAK;AAAA,MAChB;AAAA,MACA;AAAA;AAAA,cAEQ;AAAA,YACF,uBAAuB,SAAS;AAAA,YAChC;AAAA;AAAA;AAAA;AAAA,IAIR;AAEA,UAAM,YACJ,OAAO,WAAW,cACb,KAAK,UAAU,IAAI,IACpB,KAAK,iBAAiB,MAAM;AAElC,QAAI,UAAU,gBAAgB,WAAW;AACzC,QAAI,UAAU,iBAAiB,gDAAgD;AAC/E,QAAI,OAAO,SAAS;AACpB,QAAI,MAAM,IAAI;AACd,QAAI,IAAI;AAAA,EACV;AAAA,EAkBA,KAAK,SAAoC;AACvC,UAAM,EAAE,KAAK,MAAM,QAAQ,WAAW,CAAC,EAAE,IAAI;AAC7C,UAAM,YACJ,OAAO,WAAW,cACb,KAAK,UAAU,IAAI,IACpB,KAAK,iBAAiB,MAAM;AAElC,QAAI,OAAO,SAAS;AACpB,QAAI,KAAK;AAAA,MACP,UAAU;AAAA,QACR,SAAS,KAAK,QAAQ,IAAY,SAAS;AAAA,QAC3C,QAAQ;AAAA,QACR,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF,CAAC;AACD,QAAI,IAAI;AAAA,EACV;AAAA,EAQU,cAAc,OAAe,MAAsB;AAC3D,WAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAOQ;AAAA;AAAA;AAAA;AAAA,YAIP;AAAA;AAAA;AAAA;AAAA;AAAA,EAKV;AAAA,EAQU,iBAAiB,QAAiC;AAC1D,QAAI;AACJ,QAAI;AACF,UAAI,OAAO,WAAW,UAAU;AAC9B,oBAAY,KAAK,UAAU,MAAM;AAAA,MACnC,OAAO;AACL,aAAK,UAAU,MAAM;AACrB,oBAAY;AAAA,MACd;AAAA,IACF,SAAS,GAAP;AACA,kBAAY,KAAK,UAAU,IAAI;AAAA,IACjC;AAEA,WAAO;AAAA,EACT;AACF;AAeO,MAAM,+BAA2B,uBAAS,CAAC,QAAQ;AACxD,MAAI;AAAA,IACF;AAAA,IACA,MACE,IAAI,iBAAiB;AAAA,MACnB,QAAQ;AAAA,QACN,QAAQ,IAAI,UAAU;AAAA,QACtB,UAAU,IAAI,IAAI,UAAU;AAAA,MAC9B;AAAA,IACF,CAAC;AAAA,EACL;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../../src/services/http/responsesBuilder.ts"],"sourcesContent":["import type { Config, Response } from '../../types';\nimport { provider, type Statuses } from '../../utils';\n/**\n * The options to construct a {@link ResponsesBuilder}.\n *\n * @group Services/ResponsesBuilder\n */\nexport type ResponsesBuilderConstructorOptions = {\n  /**\n   * A dictionary with the dependencies to inject.\n   */\n  inject: {\n    config: Config;\n    statuses: Statuses;\n  };\n};\n/**\n * The options to build a response for a post message.\n *\n * @group Services/ResponsesBuilder\n */\nexport type HTMLPostMessageResponseOptions = {\n  /**\n   * The response object generated by the application.\n   */\n  res: Response;\n  /**\n   * The title for the HTML.\n   */\n  title: string;\n  /**\n   * The contents of the post message.\n   */\n  message: string;\n  /**\n   * The status code for the response.\n   *\n   * @default 200\n   */\n  status?: number | string;\n  /**\n   * From which object will the `postMessage` method called from.\n   *\n   * @default 'window.opener'\n   */\n  target?: string;\n  /**\n   * Whether or not to call `window.close` after sending the message.\n   *\n   * @default true\n   */\n  close?: boolean;\n  /**\n   * In case `close` is set to `true`, this option is to specify how many milliseconds\n   * should be waited before closing the window.\n   *\n   * @default 700\n   */\n  closeDelay?: number;\n};\n/**\n * The options to build a reponse for JSON.\n *\n * @group Services/ResponsesBuilder\n */\nexport type JSONResponseOptions = {\n  /**\n   * The response object generated by the application.\n   */\n  res: Response;\n  /**\n   * The actual data for the response. It will be added in a `data` property.\n   */\n  data: unknown;\n  /**\n   * The status code for the response.\n   *\n   * @default 200\n   */\n  status?: number | string;\n  /**\n   * Extra information to include inside the `metadata` object.\n   */\n  metadata?: object;\n};\n/**\n * The default time to wait before closing a window, in case it's enabled.\n */\nconst DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE = 700;\n/**\n * A utility service to build responses.\n *\n * @group Services\n * @group Services/ResponsesBuilder\n */\nexport class ResponsesBuilder {\n  /**\n   * The application configuration, to get the `version` and the `postMessagesPrefix`.\n   */\n  protected readonly _config: Config;\n  /**\n   * The uility service to get HTTP status codes.\n   */\n  protected readonly _statuses: Statuses;\n  /**\n   * @param options  The options to construct the service.\n   */\n  constructor({ inject: { config, statuses } }: ResponsesBuilderConstructorOptions) {\n    this._config = config;\n    this._statuses = statuses;\n  }\n  /**\n   * Generates and send an HTML response that emits a post message.\n   * The post message will be prefixed with the value of the configuration setting\n   * `postMessagesPrefix`.\n   *\n   * @param options  The options to customize how the HTML is generated.\n   */\n  htmlPostMessage(options: HTMLPostMessageResponseOptions): void {\n    const {\n      res,\n      title,\n      message,\n      status,\n      target = 'window.opener',\n      close = true,\n      closeDelay = DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE,\n    } = options;\n    const prefix = this._config.get<string | undefined>('postMessagesPrefix') ?? '';\n    const closeCode = close\n      ? `setTimeout(function() { window.close(); }, ${closeDelay});`\n      : '';\n\n    const html = this._htmlTemplate(\n      title,\n      `\n      (function() {\n        if (${target}) {\n          ${target}.postMessage('${prefix}${message}', '*');\n          ${closeCode}\n        }\n      })();\n      `,\n    );\n\n    const useStatus =\n      typeof status === 'undefined'\n        ? (this._statuses('ok') as number)\n        : this._normalizeStatus(status);\n\n    res.setHeader('Content-Type', 'text/html');\n    res.setHeader('Cache-Control', 'no-cache, max-age=0, must-revalidate, no-store');\n    res.status(useStatus);\n    res.write(html);\n    res.end();\n  }\n  /**\n   * Generates and sends a JSON response.\n   *\n   * @param options  The options to customize how the JSON is generated.\n   * @example\n   *\n   * <caption>The generated looks like this.</caption>\n   *\n   * {\n   *   metadata: {\n   *     version: 'dev',\n   *     status: 200,\n   *   },\n   *   data: { foo: 'bar' },\n   * }\n   *\n   */\n  json(options: JSONResponseOptions): void {\n    const { res, data, status, metadata = {} } = options;\n    const useStatus =\n      typeof status === 'undefined'\n        ? (this._statuses('ok') as number)\n        : this._normalizeStatus(status);\n\n    res.status(useStatus);\n    res.json({\n      metadata: {\n        version: this._config.get<string>('version'),\n        status: useStatus,\n        ...metadata,\n      },\n      data,\n    });\n    res.end();\n  }\n  /**\n   * Generates a basic HTML template for the service to use when generating a post message\n   * response.\n   *\n   * @param title  The HTML `<title />` attribute.\n   * @param code   Javascript code to be wrapped on a `<script />` tag.\n   */\n  protected _htmlTemplate(title: string, code: string): string {\n    return `\n      <!DOCTYPE html>\n      <html>\n        <head>\n          <meta charset=\"utf-8\" />\n          <meta http-equiv=\"x-ua-compatible\" content=\"ie=edge\" />\n          <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n          <title>${title}</title>\n        </head>\n        <body>\n          <script type=\"text/javascript\">\n          ${code}\n        </script>\n      </body>\n    </html>\n    `;\n  }\n  /**\n   * Utility method used to make sure a recevied status is a valid status code. If the\n   * status is a string, the method will try to find the code from the `statuses` package.\n   *\n   * @param status  The status to normalize.\n   * @returns If `status` is a string, but there's no valid code, it will return 200.\n   */\n  protected _normalizeStatus(status: number | string): number {\n    let useStatus: number;\n    try {\n      if (typeof status === 'string') {\n        useStatus = this._statuses(status) as number;\n      } else {\n        this._statuses(status);\n        useStatus = status;\n      }\n    } catch (_) {\n      useStatus = this._statuses('ok') as number;\n    }\n\n    return useStatus;\n  }\n}\n/**\n * The service provider that once registered on the container will set an instance of\n * {@link ResponsesBuilder} as the `responsesBuilder` service.\n *\n * @example\n *\n *   // Register it on the container\n *   container.register(responsesBuilderProvider);\n *   // Getting access to the service instance\n *   const responsesBuilder = container.get<ResponsesBuilder>('responsesBuilder');\n *\n * @group Providers\n * @group Services/ResponsesBuilder\n */\nexport const responsesBuilderProvider = provider((app) => {\n  app.set(\n    'responsesBuilder',\n    () =>\n      new ResponsesBuilder({\n        inject: {\n          config: app.getConfig(),\n          statuses: app.get('statuses'),\n        },\n      }),\n  );\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,mBAAwC;AAuFxC,MAAM,uCAAuC;AAOtC,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA,EAY5B,YAAY,EAAE,QAAQ,EAAE,QAAQ,SAAS,EAAE,GAAuC;AARlF;AAAA;AAAA;AAAA,wBAAmB;AAInB;AAAA;AAAA;AAAA,wBAAmB;AAKjB,SAAK,UAAU;AACf,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAgB,SAA+C;AAC7D,UAAM;AAAA,MACJ;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,aAAa;AAAA,IACf,IAAI;AACJ,UAAM,SAAS,KAAK,QAAQ,IAAwB,oBAAoB,KAAK;AAC7E,UAAM,YAAY,QACd,8CAA8C,UAAU,OACxD;AAEJ,UAAM,OAAO,KAAK;AAAA,MAChB;AAAA,MACA;AAAA;AAAA,cAEQ,MAAM;AAAA,YACR,MAAM,iBAAiB,MAAM,GAAG,OAAO;AAAA,YACvC,SAAS;AAAA;AAAA;AAAA;AAAA,IAIjB;AAEA,UAAM,YACJ,OAAO,WAAW,cACb,KAAK,UAAU,IAAI,IACpB,KAAK,iBAAiB,MAAM;AAElC,QAAI,UAAU,gBAAgB,WAAW;AACzC,QAAI,UAAU,iBAAiB,gDAAgD;AAC/E,QAAI,OAAO,SAAS;AACpB,QAAI,MAAM,IAAI;AACd,QAAI,IAAI;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,KAAK,SAAoC;AACvC,UAAM,EAAE,KAAK,MAAM,QAAQ,WAAW,CAAC,EAAE,IAAI;AAC7C,UAAM,YACJ,OAAO,WAAW,cACb,KAAK,UAAU,IAAI,IACpB,KAAK,iBAAiB,MAAM;AAElC,QAAI,OAAO,SAAS;AACpB,QAAI,KAAK;AAAA,MACP,UAAU;AAAA,QACR,SAAS,KAAK,QAAQ,IAAY,SAAS;AAAA,QAC3C,QAAQ;AAAA,QACR,GAAG;AAAA,MACL;AAAA,MACA;AAAA,IACF,CAAC;AACD,QAAI,IAAI;AAAA,EACV;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQU,cAAc,OAAe,MAAsB;AAC3D,WAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAOQ,KAAK;AAAA;AAAA;AAAA;AAAA,YAIZ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,EAKd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQU,iBAAiB,QAAiC;AAC1D,QAAI;AACJ,QAAI;AACF,UAAI,OAAO,WAAW,UAAU;AAC9B,oBAAY,KAAK,UAAU,MAAM;AAAA,MACnC,OAAO;AACL,aAAK,UAAU,MAAM;AACrB,oBAAY;AAAA,MACd;AAAA,IACF,SAAS,GAAG;AACV,kBAAY,KAAK,UAAU,IAAI;AAAA,IACjC;AAEA,WAAO;AAAA,EACT;AACF;AAeO,MAAM,+BAA2B,uBAAS,CAAC,QAAQ;AACxD,MAAI;AAAA,IACF;AAAA,IACA,MACE,IAAI,iBAAiB;AAAA,MACnB,QAAQ;AAAA,QACN,QAAQ,IAAI,UAAU;AAAA,QACtB,UAAU,IAAI,IAAI,UAAU;AAAA,MAC9B;AAAA,IACF,CAAC;AAAA,EACL;AACF,CAAC;","names":[]}

package/dist/services/index.d.mts

@@ -0,0 +1,33 @@
+export { commonServicesProvider } from './common/index.mjs';
+export { frontendServicesProvider } from './frontend/index.mjs';
+export { htmlServicesProvider } from './html/index.mjs';
+export { httpServicesProvider } from './http/index.mjs';
+export { utilsServicesProvider } from './utils/index.mjs';
+export { AppError, AppErrorClass, AppErrorContext, CreateAppErrorFn, appErrorProvider, createAppError } from './common/appError.mjs';
+export { CreateHTTPErrorFn, HTTPError, HTTPErrorClass, createHTTPError, httpErrorProvider } from './common/httpError.mjs';
+export { SendFile, SendFileGeneratorOptions, SendFileOptions, sendFile, sendFileProvider } from './common/sendFile.mjs';
+export { FrontendFs, FrontendFsOptions, frontendFsProvider } from './frontend/frontendFs.mjs';
+export { HTMLGenerator, HTMLGeneratorConstructorOptions, HTMLGeneratorOptions, HTMLGeneratorProviderOptions, HTMLGeneratorValuesService, htmlGeneratorProvider } from './html/htmlGenerator.mjs';
+export { ErrorResponse } from '@homer0/api-utils';
+export { APIClient, APIClientConfig, APIClientConstructorOptions, APIClientProviderOptions, APIClientSettings, EndpointsType, apiClientProvider } from './http/apiClient.mjs';
+export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFetchBody, HTTPFetchOptions, HTTPOptions, httpProvider } from './http/http.mjs';
+export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './http/responsesBuilder.mjs';
+export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, EnsureBearerTokenProviderOptions, ensureBearerTokenProvider } from './utils/ensureBearerToken.mjs';
+import '@homer0/jimple';
+import '../index-efeb437e.js';
+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 'fs/promises';
+import '@homer0/deferred';

package/dist/services/index.d.ts

@@ -14,8 +14,7 @@ export { GetCustomHeadersFromRequestOptions, HTTP, HTTPContructorOptions, HTTPFe
 export { HTMLPostMessageResponseOptions, JSONResponseOptions, ResponsesBuilder, ResponsesBuilderConstructorOptions, responsesBuilderProvider } from './http/responsesBuilder.js';
 export { EnsureBearerConstructorOptions, EnsureBearerToken, EnsureBearerTokenErrorOptions, EnsureBearerTokenOptions, EnsureBearerTokenProviderOptions, ensureBearerTokenProvider } from './utils/ensureBearerToken.js';
 import '@homer0/jimple';
-import '../jimpex-7eaee271.js';
-import '@homer0/events-hub';
+import '../index-b2a04c78.js';
 import '../types/express.js';
 import 'express';
 import '../types/http.js';
@@ -23,11 +22,12 @@ 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 '@homer0/path-utils';
 import 'fs/promises';
 import '@homer0/deferred';