@e22m4u/js-http-static-router 0.0.1 → 0.1.0

package/README.md

@@ -29,42 +29,48 @@ import http from 'http';
 import {HttpStaticRouter} from '@e22m4u/js-http-static-router';
 
 // создание экземпляра маршрутизатора
-const staticRouter = new HttpStaticRouter();
-
-// определение директории "../static"
-// доступной по адресу "/static"
-staticRouter.addRoute(
-  '/static',                          // путь маршрута
-  `${import.meta.dirname}/../static`, // файловый путь
-);
-
-// объявление файла "./static/file.txt"
-// доступным по адресу "/static"
-staticRouter.addRoute(
-  '/file.txt',
-  `${import.meta.dirname}/static/file.txt`,
-);
-
-// создание HTTP сервера и подключение обработчика
+const staticRouter = new HttpStaticRouter({
+  // при использовании опции "rootDir", относительные пути
+  // в регистрируемых маршрутах будут разрешаться относительно
+  // указанного адреса файловой системы
+  rootDir: import.meta.dirname,
+  // в данном случае "rootDir" указывает
+  // на путь к директории текущего модуля
+});
+// доступ к import.meta.dirname возможен
+// только для ESM начиная с Node.js 20.11.0
+
+// экспозиция содержимого директории "/static"
+// доступным по адресу "/assets/{file_name}"
+staticRouter.defineRoute({
+  remotePath: '/assets',     // путь маршрута
+  resourcePath: '../static', // файловый путь
+});
+
+// объявление файла "./index.html"
+// доступным по адресу "/home"
+staticRouter.defineRoute({
+  remotePath: '/home',
+  resourcePath: './static/index.html',
+});
+
+// создание HTTP сервера и определение
+// функции для обработки запросов
 const server = new http.Server();
-server.on('request', (req, res) => {
-  // если статический маршрут найден,
-  // выполняется поиск и отдача файла
-  const staticRoute = staticRouter.matchRoute(req);
-  if (staticRoute) {
-    return staticRouter.sendFileByRoute(staticRoute, req, res);
+server.on('request', async (req, res) => {
+  const fileSent = await staticRouter.handleRequest(req, res);
+  if (!fileSent) {
+    res.writeHead(404, {'Content-Type': 'text/plain'});
+    res.write('404 Not Found');
+    res.end();
   }
-  // в противном случае запрос обрабатывается
-  // основной логикой приложения
-  res.writeHead(200, {'Content-Type': 'text/plain'});
-  res.end('Hello from App!');
 });
 
 server.listen(3000, () => {
   console.log('Server is running on http://localhost:3000');
   console.log('Try to open:');
-  console.log('http://localhost:3000/static/');
-  console.log('http://localhost:3000/file.txt');
+  console.log('http://localhost:3000/home');
+  console.log('http://localhost:3000/assets/file.txt');
 });
 ```
 

package/dist/cjs/index.cjs

@@ -31,14 +31,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.js
 var index_exports = {};
 __export(index_exports, {
-  HttpStaticRouter: () => HttpStaticRouter
+  HttpStaticRouter: () => HttpStaticRouter,
+  StaticRoute: () => StaticRoute
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/http-static-router.js
-var import_path = __toESM(require("path"), 1);
-var import_mime_types = __toESM(require("mime-types"), 1);
+// src/static-route.js
 var import_fs = __toESM(require("fs"), 1);
+var import_path = __toESM(require("path"), 1);
 
 // src/utils/escape-regexp.js
 function escapeRegexp(input) {
@@ -46,173 +46,363 @@ function escapeRegexp(input) {
 }
 __name(escapeRegexp, "escapeRegexp");
 
-// src/utils/normalize-path.js
-function normalizePath(value, noStartingSlash = false) {
-  if (typeof value !== "string") {
-    return "/";
+// src/static-route.js
+var import_js_format = require("@e22m4u/js-format");
+var _StaticRoute = class _StaticRoute {
+  /**
+   * Remote path.
+   *
+   * @type {string}
+   */
+  remotePath;
+  /**
+   * Resource path.
+   *
+   * @type {string}
+   */
+  resourcePath;
+  /**
+   * RegExp.
+   *
+   * @type {RegExp}
+   */
+  regexp;
+  /**
+   * Is file.
+   *
+   * @type {boolean}
+   */
+  isFile;
+  /**
+   * Constructor.
+   *
+   * @param {string} routeDef
+   */
+  constructor(routeDef) {
+    if (!routeDef || typeof routeDef !== "object" || Array.isArray(routeDef)) {
+      throw new import_js_format.InvalidArgumentError(
+        'Parameter "routeDef" must be an Object, but %v was given.',
+        routeDef
+      );
+    }
+    if (typeof routeDef.remotePath !== "string") {
+      throw new import_js_format.InvalidArgumentError(
+        'Option "remotePath" must be a String, but %v was given.',
+        routeDef.remotePath
+      );
+    }
+    if (!routeDef.remotePath.startsWith("/")) {
+      throw new import_js_format.InvalidArgumentError(
+        'Option "remotePath" must starts with "/", but %v was given.',
+        routeDef.remotePath
+      );
+    }
+    if (typeof routeDef.resourcePath !== "string") {
+      throw new import_js_format.InvalidArgumentError(
+        'Option "resourcePath" must be a String, but %v was given.',
+        routeDef.resourcePath
+      );
+    }
+    const resourcePath = import_path.default.resolve(routeDef.resourcePath);
+    let stats;
+    try {
+      stats = import_fs.default.statSync(resourcePath);
+    } catch (error) {
+      console.error(error);
+      throw new import_js_format.InvalidArgumentError(
+        "Resource path %v does not exist.",
+        resourcePath
+      );
+    }
+    const isFile = stats.isFile();
+    const escapedRemotePath = escapeRegexp(routeDef.remotePath);
+    const regexp = isFile ? new RegExp(`^${escapedRemotePath}$`) : new RegExp(`^${escapedRemotePath}(?:$|\\/)`);
+    this.remotePath = routeDef.remotePath;
+    this.resourcePath = resourcePath;
+    this.regexp = regexp;
+    this.isFile = isFile;
+  }
+};
+__name(_StaticRoute, "StaticRoute");
+var StaticRoute = _StaticRoute;
+
+// src/http-static-router.js
+var import_path2 = __toESM(require("path"), 1);
+var import_mime_types = __toESM(require("mime-types"), 1);
+var import_http = require("http");
+var import_fs2 = __toESM(require("fs"), 1);
+
+// src/utils/get-pathname-from-url.js
+var import_js_format2 = require("@e22m4u/js-format");
+var HOST_RE = /^https?:\/\/[^/]+/;
+var QUERY_STRING_RE = /\?.*$/;
+function getPathnameFromUrl(url) {
+  if (typeof url !== "string") {
+    throw new import_js_format2.InvalidArgumentError(
+      'Parameter "url" must be a String, but %v was given.',
+      url
+    );
   }
-  const res = value.trim().replace(/\/+/g, "/").replace(/(^\/|\/$)/g, "");
-  return noStartingSlash ? res : "/" + res;
+  return url.replace(HOST_RE, "").replace(QUERY_STRING_RE, "");
 }
-__name(normalizePath, "normalizePath");
+__name(getPathnameFromUrl, "getPathnameFromUrl");
 
 // src/http-static-router.js
+var import_js_format3 = require("@e22m4u/js-format");
 var import_js_service = require("@e22m4u/js-service");
-var import_js_format = require("@e22m4u/js-format");
 var _HttpStaticRouter = class _HttpStaticRouter extends import_js_service.DebuggableService {
   /**
    * Routes.
    *
    * @protected
+   * @type {StaticRoute[]}
    */
   _routes = [];
+  /**
+   * Options.
+   *
+   * @type {import('./http-static-router.js').HttpStaticRouterOptions}
+   * @protected
+   */
+  _options = {};
   /**
    * Constructor.
    *
-   * @param {import('@e22m4u/js-service').ServiceContainer} container
+   * @param {import('@e22m4u/js-service').ServiceContainer|import('./http-static-router.js').HttpStaticRouterOptions} containerOrOptions
+   * @param {import('./http-static-router.js').HttpStaticRouterOptions} options
    */
-  constructor(container) {
-    super(container, {
+  constructor(containerOrOptions, options) {
+    const debugOptions = {
       noEnvironmentNamespace: true,
       namespace: "jsHttpStaticRouter"
-    });
+    };
+    if ((0, import_js_service.isServiceContainer)(containerOrOptions)) {
+      super(containerOrOptions, debugOptions);
+    } else if (containerOrOptions !== void 0) {
+      if (!containerOrOptions || typeof containerOrOptions !== "object" || Array.isArray(containerOrOptions)) {
+        throw new import_js_format3.InvalidArgumentError(
+          'Parameter "containerOrOptions" must be an Object or an instance of ServiceContainer, but %v was given.',
+          options
+        );
+      }
+      super(void 0, debugOptions);
+      if (options === void 0) {
+        options = containerOrOptions;
+        containerOrOptions = void 0;
+      }
+    } else {
+      super(void 0, debugOptions);
+    }
+    if (options !== void 0) {
+      if (!options || typeof options !== "object" || Array.isArray(options)) {
+        throw new import_js_format3.InvalidArgumentError(
+          'Parameter "options" must be an Object, but %v was given.',
+          options
+        );
+      }
+      if (options.rootDir !== void 0) {
+        if (typeof options.rootDir !== "string") {
+          throw new import_js_format3.InvalidArgumentError(
+            'Option "rootDir" must be a String, but %v was given.',
+            options.rootDir
+          );
+        }
+        if (!import_path2.default.isAbsolute(options.rootDir)) {
+          throw new import_js_format3.InvalidArgumentError(
+            'Option "rootDir" must be an absolute path, but %v was given.',
+            options.rootDir
+          );
+        }
+      }
+      this._options = { ...options };
+    }
+    Object.freeze(this._options);
   }
   /**
-   * Add route.
+   * Define route.
    *
-   * @param {string} remotePath
-   * @param {string} resourcePath
-   * @returns {object}
+   * @param {import('./static-route.js').StaticRouteDefinition} routeDef
+   * @returns {this}
    */
-  addRoute(remotePath, resourcePath) {
-    const debug = this.getDebuggerFor(this.addRoute);
-    resourcePath = import_path.default.resolve(resourcePath);
-    debug("Adding a new route.");
-    debug("Resource path is %v.", resourcePath);
-    debug("Remote path is %v.", remotePath);
-    let stats;
-    try {
-      stats = import_fs.default.statSync(resourcePath);
-    } catch (error) {
-      console.error(error);
-      throw new import_js_format.InvalidArgumentError(
-        "Static resource path does not exist %v.",
-        resourcePath
+  defineRoute(routeDef) {
+    if (!routeDef || typeof routeDef !== "object" || Array.isArray(routeDef)) {
+      throw new import_js_format3.InvalidArgumentError(
+        'Parameter "routeDef" must be an Object, but %v was given.',
+        routeDef
       );
     }
-    const isFile = stats.isFile();
-    debug("Resource type is %s.", isFile ? "File" : "Folder");
-    const normalizedRemotePath = normalizePath(remotePath);
-    const escapedRemotePath = escapeRegexp(normalizedRemotePath);
-    const regexp = isFile ? new RegExp(`^${escapedRemotePath}$`) : new RegExp(`^${escapedRemotePath}(?:$|\\/)`);
-    const route = { remotePath, resourcePath, regexp, isFile };
+    if (this._options.rootDir !== void 0 && !import_path2.default.isAbsolute(routeDef.resourcePath)) {
+      routeDef = { ...routeDef };
+      routeDef.resourcePath = import_path2.default.join(
+        this._options.rootDir,
+        routeDef.resourcePath
+      );
+    }
+    const debug = this.getDebuggerFor(this.defineRoute);
+    const route = new StaticRoute(routeDef);
+    debug("Adding a new route.");
+    debug("Resource path is %v.", route.resourcePath);
+    debug("Remote path is %v.", route.remotePath);
+    debug("Resource type is %s.", route.isFile ? "File" : "Folder");
     this._routes.push(route);
     this._routes.sort((a, b) => b.remotePath.length - a.remotePath.length);
     return this;
   }
   /**
-   * Match route.
+   * Handle request.
    *
-   * @param {import('http').IncomingMessage} req
-   * @returns {object|undefined}
+   * @param {import('http').IncomingMessage} request
+   * @param {import('http').ServerResponse} response
+   * @returns {Promise<boolean>}
    */
-  matchRoute(req) {
-    const debug = this.getDebuggerFor(this.matchRoute);
-    debug("Matching routes with incoming request.");
-    const url = (req.url || "/").replace(/\?.*$/, "");
-    debug("Incoming request is %s %v.", req.method, url);
-    if (req.method !== "GET" && req.method !== "HEAD") {
-      debug("Method not allowed.");
-      return;
+  async handleRequest(request, response) {
+    const fileInfo = await this._findFileForRequest(request);
+    if (fileInfo !== void 0) {
+      this._sendFile(request, response, fileInfo);
+      return true;
     }
-    debug("Walking through %v routes.", this._routes.length);
-    const route = this._routes.find((route2) => {
-      const res = route2.regexp.test(url);
-      const phrase = res ? "matched" : "not matched";
-      debug("Resource %v %s.", route2.resourcePath, phrase);
-      return res;
-    });
-    route ? debug("Resource %v matched.", route.resourcePath) : debug("No route matched.");
-    return route;
+    return false;
   }
   /**
-   * Send file by route.
+   * Find file for request.
    *
-   * @param {object} route
-   * @param {import('http').IncomingMessage} req
-   * @param {import('http').ServerResponse} res
+   * @param {import('http').IncomingMessage} request
+   * @returns {Promise<FileInfo|undefined>|undefined}
    */
-  sendFileByRoute(route, req, res) {
-    const reqUrl = req.url || "/";
-    const reqPath = reqUrl.replace(/\?.*$/, "");
-    let targetPath = route.resourcePath;
-    if (!route.isFile) {
-      const relativePath = reqPath.replace(route.regexp, "");
-      targetPath = import_path.default.join(route.resourcePath, relativePath);
-    }
-    targetPath = import_path.default.resolve(targetPath);
-    const resourceRoot = import_path.default.resolve(route.resourcePath);
-    if (!targetPath.startsWith(resourceRoot)) {
-      res.writeHead(403, { "content-type": "text/plain" });
-      res.end("403 Forbidden");
+  async _findFileForRequest(request) {
+    if (!(request instanceof import_http.IncomingMessage)) {
+      throw new import_js_format3.InvalidArgumentError(
+        'Parameter "request" must be an instance of IncomingMessage, but %v was given.',
+        request
+      );
+    }
+    const debug = this.getDebuggerFor(this._findFileForRequest);
+    debug("File finding for an incoming request.");
+    debug("Incoming request %s %v.", request.method, request.url);
+    let requestPath;
+    try {
+      requestPath = decodeURIComponent(getPathnameFromUrl(request.url || ""));
+    } catch {
+      debug("Invalid URL encoding .");
       return;
     }
-    import_fs.default.stat(targetPath, (statsError, stats) => {
-      if (statsError) {
-        return _handleFsError(statsError, res);
-      }
-      if (stats.isDirectory()) {
-        if (/[^/]$/.test(reqPath)) {
-          const searchMatch = reqUrl.match(/\?.*$/);
-          const search = searchMatch ? searchMatch[0] : "";
-          const normalizedPath = reqUrl.replace(/\/{2,}/g, "/");
-          res.writeHead(302, { location: `${normalizedPath}/${search}` });
-          res.end();
-          return;
+    if (request.method !== "GET" && request.method !== "HEAD") {
+      debug("Method not allowed.");
+      return;
+    }
+    if (requestPath.includes("//")) {
+      debug("Request path contains duplicate slashes.");
+      return;
+    }
+    if (!this._routes.length) {
+      debug("No registered routes.");
+      return;
+    }
+    debug("Walking through %v routes.", this._routes.length);
+    for (const route of this._routes) {
+      const isMatched = route.regexp.test(requestPath);
+      if (isMatched) {
+        debug("Matched route %v.", route.remotePath);
+        let targetPath = route.resourcePath;
+        if (!route.isFile) {
+          const relativePath = requestPath.replace(route.regexp, "");
+          targetPath = import_path2.default.join(route.resourcePath, relativePath);
         }
-        if (/\/{2,}/.test(reqUrl)) {
-          const normalizedUrl = reqUrl.replace(/\/{2,}/g, "/");
-          res.writeHead(302, { location: normalizedUrl });
-          res.end();
+        targetPath = import_path2.default.resolve(targetPath);
+        const resourceRoot = import_path2.default.resolve(route.resourcePath);
+        if (targetPath !== resourceRoot && !targetPath.startsWith(resourceRoot + import_path2.default.sep)) {
           return;
         }
-        targetPath = import_path.default.join(targetPath, "index.html");
-      }
-      const extname = import_path.default.extname(targetPath);
-      const contentType = import_mime_types.default.contentType(extname) || "application/octet-stream";
-      const fileStream = (0, import_fs.createReadStream)(targetPath);
-      fileStream.on("error", (error) => {
-        _handleFsError(error, res);
-      });
-      fileStream.on("open", () => {
-        res.writeHead(200, { "content-type": contentType });
-        if (req.method === "HEAD") {
-          res.end();
-          return;
+        const fileSize = await new Promise((resolve) => {
+          import_fs2.default.stat(targetPath, (statsError, stats) => {
+            if (statsError || stats.isDirectory()) {
+              resolve(void 0);
+              return;
+            }
+            resolve(stats.size);
+            return;
+          });
+        });
+        if (fileSize !== void 0) {
+          if (requestPath.endsWith("/")) {
+            continue;
+          }
+          debug("File found %v.", targetPath);
+          return { path: targetPath, size: fileSize };
         }
-        fileStream.pipe(res);
+      }
+    }
+    debug("File not found.");
+  }
+  /**
+   * Send file.
+   *
+   * @param {import('http').IncomingMessage} request
+   * @param {import('http').ServerResponse} response
+   * @param {FileInfo} fileInfo
+   */
+  _sendFile(request, response, fileInfo) {
+    const debug = this.getDebuggerFor(this._sendFile);
+    debug("File sending for an incoming request.");
+    debug("Incoming request %s %v.", request.method, request.url);
+    debug("File path %v.", fileInfo.path);
+    debug("File size %v bytes.", fileInfo.size);
+    if (request.method !== "GET" && request.method !== "HEAD") {
+      debug("Method not allowed.");
+      return;
+    }
+    const extname = import_path2.default.extname(fileInfo.path);
+    const contentType = import_mime_types.default.contentType(extname) || "application/octet-stream";
+    const fileStream = (0, import_fs2.createReadStream)(fileInfo.path);
+    fileStream.on("error", (error) => {
+      debug("Unable to open a file stream.");
+      this._handleFsError(error, response);
+    });
+    fileStream.on("open", () => {
+      response.writeHead(200, {
+        "Content-Type": contentType,
+        "Content-Length": fileInfo.size
       });
+      if (request.method === "HEAD") {
+        response.end();
+        debug("Response has been sent without a body for the HEAD request.");
+        fileStream.destroy();
+        return;
+      }
+      fileStream.pipe(response);
+    });
+    request.on("close", () => {
+      debug("File has been sent.");
+      fileStream.destroy();
     });
   }
+  /**
+   * Handle filesystem error.
+   *
+   * @param {object} error
+   * @param {object} response
+   * @returns {undefined}
+   */
+  _handleFsError(error, response) {
+    if (response.headersSent) {
+      response.destroy();
+      return;
+    }
+    if ("code" in error && error.code === "ENOENT") {
+      response.writeHead(404, { "Content-Type": "text/plain" });
+      response.write("404 Not Found");
+      response.end();
+    } else {
+      response.writeHead(500, { "Content-Type": "text/plain" });
+      response.write("500 Internal Server Error");
+      response.end();
+    }
+  }
 };
 __name(_HttpStaticRouter, "HttpStaticRouter");
 var HttpStaticRouter = _HttpStaticRouter;
-function _handleFsError(error, res) {
-  if (res.headersSent) {
-    return;
-  }
-  if ("code" in error && error.code === "ENOENT") {
-    res.writeHead(404, { "content-type": "text/plain" });
-    res.write("404 Not Found");
-    res.end();
-  } else {
-    res.writeHead(500, { "content-type": "text/plain" });
-    res.write("500 Internal Server Error");
-    res.end();
-  }
-}
-__name(_handleFsError, "_handleFsError");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  HttpStaticRouter
+  HttpStaticRouter,
+  StaticRoute
 });

package/example/server.js

@@ -2,40 +2,43 @@ import http from 'http';
 import {HttpStaticRouter} from '@e22m4u/js-http-static-router';
 
 // создание экземпляра маршрутизатора
-const staticRouter = new HttpStaticRouter();
+const staticRouter = new HttpStaticRouter({
+  // при использовании опции "rootDir", относительные пути
+  // в регистрируемых маршрутах будут разрешаться относительно
+  // указанного адреса файловой системы
+  rootDir: import.meta.dirname,
+});
 
-// определение директории "../static"
-// доступной по адресу "/static"
-staticRouter.addRoute(
-  '/static',                       // путь маршрута
-  `${import.meta.dirname}/static`, // файловый путь
-);
+// экспозиция содержимого директории "/static"
+// доступным по адресу "/assets/{file_name}"
+staticRouter.defineRoute({
+  remotePath: '/assets',    // путь маршрута
+  resourcePath: './static', // файловый путь
+});
 
-// объявление файла "./static/file.txt"
-// доступным по адресу "/static"
-staticRouter.addRoute(
-  '/file.txt',
-  `${import.meta.dirname}/static/file.txt`,
-);
+// объявление файла "./index.html"
+// доступным по адресу "/home"
+staticRouter.defineRoute({
+  remotePath: '/home',
+  resourcePath: './static/index.html',
+});
 
-// создание HTTP сервера и подключение обработчика
+// создание HTTP сервера и определение
+// функции для обработки запросов
 const server = new http.Server();
-server.on('request', (req, res) => {
-  // если статический маршрут найден,
-  // выполняется поиск и отдача файла
-  const staticRoute = staticRouter.matchRoute(req);
-  if (staticRoute) {
-    return staticRouter.sendFileByRoute(staticRoute, req, res);
+server.on('request', async (req, res) => {
+  const fileSent = await staticRouter.handleRequest(req, res);
+  if (!fileSent) {
+    res.writeHead(404, {'Content-Type': 'text/plain'});
+    res.write('404 Not Found');
+    res.end();
   }
-  // в противном случае запрос обрабатывается
-  // основной логикой приложения
-  res.writeHead(200, {'Content-Type': 'text/plain'});
-  res.end('Hello from App!');
 });
 
 server.listen(3000, () => {
   console.log('Server is running on http://localhost:3000');
   console.log('Try to open:');
-  console.log('http://localhost:3000/static/');
-  console.log('http://localhost:3000/file.txt');
+  console.log('http://localhost:3000/home');
+  console.log('http://localhost:3000/assets/file.txt');
+  console.log('http://localhost:3000/assets/nested/file.txt');
 });

package/example/static/nested/file.txt

@@ -0,0 +1,11 @@
+⠀⠀⠀⣀⣤⣤⣀⡀⠀⠀⠀⠀⢀⣀⣤⣤⣀⡀   
+⠀⣴⣿⣋⢯⣩⢭⣟⣶⡄⢀⣴⣟⡏⣭⣉⣏⡻⣷⡀ 
+⣸⣿⡷⣯⣿⡽⣿⣞⣷⣿⣾⣿⣯⣿⣽⣳⣾⣽⣻⣷ 
+⢿⣿⣟⣿⡷⣿⣿⣿⣿⣻⣿⢿⣾⣿⣾⢿⣽⡿⣿⣿⠀
+⠸⣿⣿⣿⣽⣿⢿⣾⣿⡿⣽⣿⣿⣷⢿⣿⣯⣿⣿⡟⠀
+⠀⠻⣿⣿⣿⣿⣿⣿⣷⣿⣿⢿⣾⡿⣿⣻⣽⣿⡟⠀⠀
+⠀⠀⠙⢿⣿⣿⣿⣷⣿⣻⣾⣿⣿⣿⣿⣿⣿⠏⠀⠀
+⠀⠀⠀⠈⠻⣿⣿⣿⣿⣿⣿⣟⣿⣿⣿⠟⠁⠀⠀⠀
+⠀⠀⠀⠀⠀⠘⢿⣿⣿⣿⣿⣿⣿⡿⠋⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠙⠿⣿⣿⡿⠋⠀⠀⠀⠀⠀
+⠀⠀⠀⠀⠀⠀⠀⠀⠀⠘⠏⠀⠀⠀⠀⠀⠀