jimpex 7.0.2 → 8.0.0

package/dist/esm/services/http/http.js

@@ -0,0 +1,125 @@
+import {
+  __publicField
+} from "../../chunk-T2T6Q22Z.js";
+import fetch from "node-fetch";
+import urijs from "urijs";
+import { deepAssignWithOverwrite } from "@homer0/deep-assign";
+import { provider } from "../../utils";
+class HTTP {
+  constructor({ inject: { logger }, ...options }) {
+    __publicField(this, "_logger");
+    __publicField(this, "_options");
+    this._logger = logger;
+    this._options = deepAssignWithOverwrite(
+      {
+        logRequests: false
+      },
+      options
+    );
+    this.fetch = this.fetch.bind(this);
+  }
+  async fetch(url, options = {}) {
+    let useURL = url;
+    if (options.qs) {
+      useURL = urijs(url).query(options.qs).toString();
+    }
+    const fetchOptions = {
+      method: (options.method || "get").toUpperCase(),
+      body: options.body
+    };
+    let defaultHeaders;
+    if (options.req) {
+      defaultHeaders = this.getCustomHeadersFromRequest(options.req);
+      const ip = this.getIPFromRequest(options.req);
+      if (ip) {
+        defaultHeaders["x-forwarded-for"] = ip;
+      }
+    }
+    const headers = {
+      ...defaultHeaders,
+      ...options.headers
+    };
+    if (Object.keys(headers).length) {
+      fetchOptions.headers = this.normalizeHeaders(headers);
+    }
+    const { logRequests } = this._options;
+    if (logRequests) {
+      this._logRequest(useURL, fetchOptions);
+    }
+    const response = await fetch(useURL, fetchOptions);
+    if (logRequests) {
+      this._logResponse(response);
+    }
+    return response;
+  }
+  getIPFromRequest(req) {
+    const headerValue = req.headers["x-forwarded-for"];
+    if (headerValue) {
+      return String(headerValue);
+    }
+    return req?.connection?.remoteAddress || req?.socket?.remoteAddress;
+  }
+  getCustomHeadersFromRequest(req, options = {}) {
+    const { includeXForwardedHeaders = false } = options;
+    return Object.keys(req.headers).reduce((acc, headerName) => {
+      if (headerName.startsWith("x-") && (includeXForwardedHeaders || !headerName.startsWith("x-forwarded-"))) {
+        acc[headerName] = req.headers[headerName];
+      }
+      return acc;
+    }, {});
+  }
+  normalizeHeaders(headers) {
+    return Object.keys(headers).reduce((acc, name) => {
+      const newName = name.split("-").map((part) => part.replace(/^(\w)/, (_, letter) => letter.toUpperCase())).join("-");
+      acc[newName] = headers[name];
+      return acc;
+    }, {});
+  }
+  get options() {
+    return deepAssignWithOverwrite({}, this._options);
+  }
+  _logRequest(url, options) {
+    const { method, headers } = options;
+    const prefix = "REQUEST> ";
+    const lines = ["--->>", `${prefix}${method} ${url}`];
+    if (headers) {
+      Object.keys(headers).forEach((header) => {
+        const value = headers[header];
+        lines.push(`${prefix}${header}: ${value}`);
+      });
+    }
+    if (options.body) {
+      lines.push(`${prefix}body: "${options.body}"`);
+    }
+    this._logger.info(lines);
+  }
+  _logResponse(response) {
+    const prefix = "RESPONSE> ";
+    const lines = [
+      "<<---",
+      `${prefix}${response.url}`,
+      `${prefix}status: ${response.status}`
+    ];
+    response.headers.forEach((value, header) => {
+      lines.push(`${prefix}${header}: ${value}`);
+    });
+    this._logger.info(lines);
+  }
+}
+const httpProvider = provider((app) => {
+  app.set("http", () => {
+    const config = app.getConfig();
+    const logRequests = config.get("debug.logRequests") === true;
+    return new HTTP({
+      inject: {
+        logger: app.get("logger")
+      },
+      logRequests
+    });
+  });
+});
+export {
+  HTTP,
+  httpProvider
+};
+//# sourceMappingURL=http.js.map

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

@@ -0,0 +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":[]}

package/dist/esm/services/http/index.js

@@ -0,0 +1,17 @@
+import "../../chunk-T2T6Q22Z.js";
+import { providers } from "../../utils";
+import { apiClientProvider } from "./apiClient";
+import { httpProvider } from "./http";
+import { responsesBuilderProvider } from "./responsesBuilder";
+const httpServicesProvider = providers({
+  apiClientProvider,
+  httpProvider,
+  responsesBuilderProvider
+});
+export * from "./apiClient";
+export * from "./http";
+export * from "./responsesBuilder";
+export {
+  httpServicesProvider
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/services/http/index.ts"],"sourcesContent":["import { providers } from '../../utils';\nimport { apiClientProvider } from './apiClient';\nimport { httpProvider } from './http';\nimport { responsesBuilderProvider } from './responsesBuilder';\n/**\n * Registers all the HTTP services on the container.\n *\n * - {@link APIClient | apiClient}\n * - {@link HTTP | http}\n * - {@link ResponsesBuilder | responsesBuilder}\n *\n * @example\n *\n *   // Register the collection on the container\n *   container.register(httpServicesProvider);\n *   // Getting access to one the services instance\n *   const apiClient = container.get<APIClient>('apiClient');\n *\n * @group Providers\n */\nexport const httpServicesProvider = providers({\n  apiClientProvider,\n  httpProvider,\n  responsesBuilderProvider,\n});\n\nexport * from './apiClient';\nexport * from './http';\nexport * from './responsesBuilder';\n"],"mappings":";AAAA,SAAS,iBAAiB;AAC1B,SAAS,yBAAyB;AAClC,SAAS,oBAAoB;AAC7B,SAAS,gCAAgC;AAiBlC,MAAM,uBAAuB,UAAU;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

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

@@ -0,0 +1,105 @@
+import {
+  __publicField
+} from "../../chunk-T2T6Q22Z.js";
+import { provider } from "../../utils";
+const DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE = 700;
+class ResponsesBuilder {
+  constructor({ inject: { config, statuses } }) {
+    __publicField(this, "_config");
+    __publicField(this, "_statuses");
+    this._config = config;
+    this._statuses = statuses;
+  }
+  htmlPostMessage(options) {
+    const {
+      res,
+      title,
+      message,
+      status,
+      target = "window.opener",
+      close = true,
+      closeDelay = DEFAULT_CLOSE_DELAY_FOR_POST_MESSAGE
+    } = options;
+    const prefix = this._config.get("postMessagesPrefix") ?? "";
+    const closeCode = close ? `setTimeout(function() { window.close(); }, ${closeDelay});` : "";
+    const html = this._htmlTemplate(
+      title,
+      `
+      (function() {
+        if (${target}) {
+          ${target}.postMessage('${prefix}${message}', '*');
+          ${closeCode}
+        }
+      })();
+      `
+    );
+    const useStatus = typeof status === "undefined" ? this._statuses("ok") : this._normalizeStatus(status);
+    res.setHeader("Content-Type", "text/html");
+    res.setHeader("Cache-Control", "no-cache, max-age=0, must-revalidate, no-store");
+    res.status(useStatus);
+    res.write(html);
+    res.end();
+  }
+  json(options) {
+    const { res, data, status, metadata = {} } = options;
+    const useStatus = typeof status === "undefined" ? this._statuses("ok") : this._normalizeStatus(status);
+    res.status(useStatus);
+    res.json({
+      metadata: {
+        version: this._config.get("version"),
+        status: useStatus,
+        ...metadata
+      },
+      data
+    });
+    res.end();
+  }
+  _htmlTemplate(title, code) {
+    return `
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta charset="utf-8" />
+          <meta http-equiv="x-ua-compatible" content="ie=edge" />
+          <meta name="viewport" content="width=device-width, initial-scale=1" />
+          <title>${title}</title>
+        </head>
+        <body>
+          <script type="text/javascript">
+          ${code}
+        <\/script>
+      </body>
+    </html>
+    `;
+  }
+  _normalizeStatus(status) {
+    let useStatus;
+    try {
+      if (typeof status === "string") {
+        useStatus = this._statuses(status);
+      } else {
+        this._statuses(status);
+        useStatus = status;
+      }
+    } catch (_) {
+      useStatus = this._statuses("ok");
+    }
+    return useStatus;
+  }
+}
+const responsesBuilderProvider = provider((app) => {
+  app.set(
+    "responsesBuilder",
+    () => new ResponsesBuilder({
+      inject: {
+        config: app.getConfig(),
+        statuses: app.get("statuses")
+      }
+    })
+  );
+});
+export {
+  ResponsesBuilder,
+  responsesBuilderProvider
+};
+//# sourceMappingURL=responsesBuilder.js.map

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

@@ -0,0 +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":";;;AACA,SAAS,gBAA+B;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,2BAA2B,SAAS,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/esm/services/index.js

@@ -0,0 +1,6 @@
+export * from "./common";
+export * from "./frontend";
+export * from "./html";
+export * from "./http";
+export * from "./utils";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/index.ts"],"sourcesContent":["export * from './common';\nexport * from './frontend';\nexport * from './html';\nexport * from './http';\nexport * from './utils';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

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

@@ -0,0 +1,78 @@
+import {
+  __publicField
+} from "../../chunk-T2T6Q22Z.js";
+import { deepAssignWithOverwrite } from "@homer0/deep-assign";
+import { providerCreator } from "../../utils";
+class EnsureBearerToken {
+  constructor({
+    inject: { HTTPError, statuses },
+    ...options
+  }) {
+    __publicField(this, "_HTTPError");
+    __publicField(this, "_options");
+    this._HTTPError = HTTPError;
+    this._options = deepAssignWithOverwrite(
+      {
+        error: {
+          message: "Unauthorized",
+          status: statuses("unauthorized"),
+          response: {}
+        },
+        expression: /bearer (.*?)(?:$|\s)/i,
+        local: "token"
+      },
+      options
+    );
+  }
+  getMiddleware() {
+    return (req, res, next) => {
+      let unauthorized = true;
+      const {
+        headers: { authorization }
+      } = req;
+      if (authorization) {
+        const matches = this._options.expression.exec(authorization);
+        if (matches) {
+          const [, token] = matches;
+          res.locals[this._options.local] = token;
+          unauthorized = false;
+        }
+      }
+      if (unauthorized) {
+        const {
+          error: { message, status, response }
+        } = this._options;
+        next(
+          new this._HTTPError(message, status, {
+            response
+          })
+        );
+      } else {
+        next();
+      }
+    };
+  }
+  get options() {
+    return deepAssignWithOverwrite({}, this._options);
+  }
+}
+const ensureBearerTokenProvider = providerCreator(
+  (options = {}) => (app) => {
+    const { serviceName = "ensureBearerToken", ...rest } = options;
+    app.set(
+      serviceName,
+      () => new EnsureBearerToken({
+        inject: {
+          HTTPError: app.get("HTTPError"),
+          statuses: app.get("statuses")
+        },
+        ...rest
+      }).getMiddleware()
+    );
+  }
+);
+export {
+  EnsureBearerToken,
+  ensureBearerTokenProvider
+};
+//# sourceMappingURL=ensureBearerToken.js.map

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

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

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

@@ -0,0 +1,11 @@
+import "../../chunk-T2T6Q22Z.js";
+import { providers } from "../../utils";
+import { ensureBearerTokenProvider } from "./ensureBearerToken";
+const utilsServicesProvider = providers({
+  ensureBearerTokenProvider
+});
+export * from "./ensureBearerToken";
+export {
+  utilsServicesProvider
+};
+//# sourceMappingURL=index.js.map

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

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

package/dist/esm/types/events.js

@@ -0,0 +1 @@
+//# sourceMappingURL=events.js.map

package/dist/esm/types/events.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/express.js

@@ -0,0 +1 @@
+//# sourceMappingURL=express.js.map

package/dist/esm/types/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/http.js

@@ -0,0 +1 @@
+//# sourceMappingURL=http.js.map

package/dist/esm/types/http.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/index.js

@@ -0,0 +1,7 @@
+export * from "./events";
+export * from "./express";
+export * from "./http";
+export * from "./options";
+export * from "./utils";
+export * from "./wootils";
+//# sourceMappingURL=index.js.map

package/dist/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/index.ts"],"sourcesContent":["export * from './events';\nexport * from './express';\nexport * from './http';\nexport * from './options';\nexport * from './utils';\nexport * from './wootils';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/esm/types/options.js

@@ -0,0 +1 @@
+//# sourceMappingURL=options.js.map

package/dist/esm/types/options.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/utils.js

@@ -0,0 +1 @@
+//# sourceMappingURL=utils.js.map

package/dist/esm/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/esm/types/wootils.js

@@ -0,0 +1 @@
+//# sourceMappingURL=wootils.js.map

package/dist/esm/types/wootils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,5 @@
+export * from "./others";
+export * from "./routes";
+export * from "./statuses";
+export * from "./text";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/fns/index.ts"],"sourcesContent":["export * from './others';\nexport * from './routes';\nexport * from './statuses';\nexport * from './text';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

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

@@ -0,0 +1,6 @@
+import "../../chunk-T2T6Q22Z.js";
+const notUndefined = (value) => value !== void 0;
+export {
+  notUndefined
+};
+//# sourceMappingURL=others.js.map

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

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

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

@@ -0,0 +1,25 @@
+import "../../chunk-T2T6Q22Z.js";
+import { escapeForRegExp } from "./text";
+const removeLeadingSlash = (url) => url.replace(/^\/+/, "");
+const removeTrailingSlash = (url) => url.replace(/\/+$/, "");
+const removeSlashes = (url, leading = true, trailing = true) => {
+  const newUrl = leading ? removeLeadingSlash(url) : url;
+  return trailing ? removeTrailingSlash(newUrl) : newUrl;
+};
+const createRouteExpression = (route, leadingSlash = true, trailingSlash = false) => {
+  let expression = removeSlashes(route).split("/").map((part) => part.startsWith(":") ? "(?:([^\\/]+?))" : escapeForRegExp(part)).join("\\/");
+  if (leadingSlash) {
+    expression = `\\/${expression}`;
+  }
+  if (trailingSlash) {
+    expression = `${expression}\\/`;
+  }
+  return new RegExp(expression);
+};
+export {
+  createRouteExpression,
+  removeLeadingSlash,
+  removeSlashes,
+  removeTrailingSlash
+};
+//# sourceMappingURL=routes.js.map

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

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

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

@@ -0,0 +1,6 @@
+import "../../chunk-T2T6Q22Z.js";
+import statuses from "statuses";
+export {
+  statuses
+};
+//# sourceMappingURL=statuses.js.map

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

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

package/dist/esm/utils/fns/text.js

@@ -0,0 +1,6 @@
+import "../../chunk-T2T6Q22Z.js";
+const escapeForRegExp = (text) => text.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
+export {
+  escapeForRegExp
+};
+//# sourceMappingURL=text.js.map

package/dist/esm/utils/fns/text.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/utils/fns/text.ts"],"sourcesContent":["/**\n * Escapes a string to be used on `new RegExp(...)`.\n *\n * @param text  The text to escape.\n * @group Utilities\n */\nexport const escapeForRegExp = (text: string): string =>\n  text.replace(/[-[\\]{}()*+?.,\\\\^$|#\\s]/g, '\\\\$&');\n"],"mappings":";AAMO,MAAM,kBAAkB,CAAC,SAC9B,KAAK,QAAQ,4BAA4B,MAAM;","names":[]}

package/dist/esm/utils/index.js

@@ -0,0 +1,3 @@
+export * from "./fns";
+export * from "./wrappers";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/utils/index.ts"],"sourcesContent":["export * from './fns';\nexport * from './wrappers';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/esm/utils/wrappers.js

@@ -0,0 +1,41 @@
+import "../chunk-T2T6Q22Z.js";
+import {
+  createProvider,
+  createProviderCreator,
+  createProviders,
+  resourceFactory,
+  resourceCreatorFactory
+} from "@homer0/jimple";
+const provider = createProvider();
+const providerCreator = createProviderCreator();
+const providers = createProviders();
+const controllerFactory = resourceFactory();
+const controller = (connect) => controllerFactory("controller", "connect", connect);
+const controllerCreatorFactory = resourceCreatorFactory();
+const controllerCreator = (creator) => controllerCreatorFactory("controller", "connect", creator);
+const controllerProviderFactory = resourceFactory();
+const controllerProvider = (register) => controllerProviderFactory("provider", "register", register);
+const controllerProviderCreatorFactory = resourceCreatorFactory();
+const controllerProviderCreator = (creator) => controllerProviderCreatorFactory("provider", "register", creator);
+const middlewareFactory = resourceFactory();
+const middleware = (connect) => middlewareFactory("middleware", "connect", connect);
+const middlewareCreatorFactory = resourceCreatorFactory();
+const middlewareCreator = (creator) => middlewareCreatorFactory("middleware", "connect", creator);
+const middlewareProviderFactory = resourceFactory();
+const middlewareProvider = (register) => middlewareProviderFactory("provider", "register", register);
+const middlewareProviderCreatorFactory = resourceCreatorFactory();
+const middlewareProviderCreator = (creator) => middlewareProviderCreatorFactory("provider", "register", creator);
+export {
+  controller,
+  controllerCreator,
+  controllerProvider,
+  controllerProviderCreator,
+  middleware,
+  middlewareCreator,
+  middlewareProvider,
+  middlewareProviderCreator,
+  provider,
+  providerCreator,
+  providers
+};
+//# sourceMappingURL=wrappers.js.map