@underpostnet/underpost 2.99.8 → 3.0.1

package/src/client/components/core/Docs.js

@@ -1,9 +1,9 @@
 import { Badge } from './Badge.js';
 import { BtnIcon } from './BtnIcon.js';
-import { Css, renderCssAttr, simpleIconsRender, ThemeEvents, Themes } from './Css.js';
+import { Css, darkTheme, renderCssAttr, simpleIconsRender, ThemeEvents, Themes } from './Css.js';
 import { buildBadgeToolTipMenuOption, Modal, renderViewTitle } from './Modal.js';
 import { listenQueryPathInstance, setQueryPath, closeModalRouteChangeEvent, getProxyPath } from './Router.js';
-import { htmls, s } from './VanillaJs.js';
+import { htmls, s, sIframe } from './VanillaJs.js';
 
 // https://mintlify.com/docs/quickstart
 
@@ -39,6 +39,7 @@ const Docs = {
       RouterInstance: Modal.Data['modal-docs'].options.RouterInstance,
     });
     const iframeEl = s(`.iframe-${ModalId}`);
+    let swaggerThemeEventKey = null;
     if (iframeEl) {
       iframeEl.addEventListener('load', () => {
         try {
@@ -51,7 +52,95 @@ const Docs = {
           // cross-origin or security restriction — safe to ignore
         }
         window.scrollTo(0, 0);
+        // Bind Shift+K inside the iframe to focus the parent SearchBox (mirrors app-wide shortcut)
+        try {
+          const iframeDoc = iframeEl.contentDocument || iframeEl.contentWindow?.document;
+          if (iframeDoc) {
+            iframeDoc.addEventListener('keydown', (e) => {
+              if (e.shiftKey && e.key.toLowerCase() === 'k') {
+                e.preventDefault();
+                e.stopPropagation();
+                if (s(`.top-bar-search-box`)) {
+                  if (s(`.main-body-btn-ui-close`) && s(`.main-body-btn-ui-close`).classList.contains('hide')) {
+                    s(`.main-body-btn-ui-open`).click();
+                  }
+                  s(`.top-bar-search-box`).blur();
+                  s(`.top-bar-search-box`).focus();
+                  s(`.top-bar-search-box`).select();
+                }
+              }
+            });
+          }
+        } catch (e) {
+          // cross-origin or security restriction — safe to ignore
+        }
       });
+
+      if (type === 'src') {
+        swaggerThemeEventKey = `jsdocs-iframe-${ModalId}`;
+
+        const applyJsDocsTheme = (isDark) => {
+          try {
+            const iframeWin = iframeEl.contentWindow;
+            if (!iframeWin) return;
+            const theme = isDark ? 'dark' : 'light';
+            if (typeof iframeWin.updateTheme === 'function') {
+              // clean-jsdoc-theme exposes updateTheme() globally
+              iframeWin.updateTheme(theme);
+            } else {
+              // Fallback: replicate localUpdateTheme manually
+              const iframeDoc = iframeEl.contentDocument || iframeWin.document;
+              if (!iframeDoc || !iframeDoc.body) return;
+              iframeDoc.body.setAttribute('data-theme', theme);
+              iframeDoc.body.classList.remove('dark', 'light');
+              iframeDoc.body.classList.add(theme);
+              const iconID = isDark ? '#light-theme-icon' : '#dark-theme-icon';
+              const svgUses = sIframe(iframeEl, '.theme-svg-use') ? iframeDoc.querySelectorAll('.theme-svg-use') : [];
+              svgUses.forEach((svg) => svg.setAttribute('xlink:href', iconID));
+              iframeWin.localStorage?.setItem('theme', theme);
+            }
+          } catch (e) {
+            // cross-origin or security restriction — safe to ignore
+          }
+        };
+
+        // Apply current theme as soon as the iframe content is ready
+        iframeEl.addEventListener('load', () => applyJsDocsTheme(darkTheme));
+
+        // Keep in sync whenever the parent page theme changes
+        ThemeEvents[swaggerThemeEventKey] = () => {
+          if (s(`.iframe-${ModalId}`)) applyJsDocsTheme(darkTheme);
+        };
+      }
+
+      if (type === 'api') {
+        swaggerThemeEventKey = `swagger-iframe-${ModalId}`;
+
+        const applySwaggerTheme = (isDark) => {
+          try {
+            const iframeDoc = iframeEl.contentDocument || iframeEl.contentWindow?.document;
+            if (!iframeDoc || !iframeDoc.body) return;
+            if (isDark) {
+              iframeDoc.body.classList.add('swagger-dark');
+            } else {
+              iframeDoc.body.classList.remove('swagger-dark');
+            }
+            iframeEl.contentWindow?.localStorage?.setItem('swagger-theme', isDark ? 'dark' : 'light');
+            const toggleBtn = sIframe(iframeEl, '#swagger-theme-toggle');
+            if (toggleBtn) toggleBtn.textContent = isDark ? '\u2600\uFE0F Light Mode' : '\uD83C\uDF19 Dark Mode';
+          } catch (e) {
+            // cross-origin or security restriction — safe to ignore
+          }
+        };
+
+        // Apply current theme as soon as the iframe content is ready
+        iframeEl.addEventListener('load', () => applySwaggerTheme(darkTheme));
+
+        // Keep in sync whenever the parent page theme changes
+        ThemeEvents[swaggerThemeEventKey] = () => {
+          if (s(`.iframe-${ModalId}`)) applySwaggerTheme(darkTheme);
+        };
+      }
     }
     Modal.Data[ModalId].onObserverListener[ModalId] = () => {
       if (s(`.iframe-${ModalId}`)) {
@@ -67,6 +156,7 @@ const Docs = {
     };
     Modal.Data[ModalId].onObserverListener[ModalId]();
     Modal.Data[ModalId].onCloseListener[ModalId] = () => {
+      if (swaggerThemeEventKey) delete ThemeEvents[swaggerThemeEventKey];
       closeModalRouteChangeEvent({ closedId: ModalId });
     };
   },
@@ -342,10 +432,6 @@ const Docs = {
         <div class="docs-landing">
           <div class="docs-header">
             <h1>Documentation</h1>
-            <p>
-              Find everything you need to build amazing applications with our platform. Get started with our guides, API
-              reference, and examples.
-            </p>
             <!--
                     <div class="search-bar">
                       <i class="fas fa-search"></i>

package/src/client/components/core/VanillaJs.js

@@ -7,31 +7,6 @@
 import { s4 } from './CommonJs.js';
 import { windowGetH, windowGetW } from './windowGetDimensions.js';
 
-/*
-
-Name: es6-string-html
-Id: Tobermory.es6-string-html
-Description: Syntax highlighting in es6 multiline strings
-Version: 2.12.1
-Publisher: Tobermory
-VS Marketplace Link: https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html
-
-Name: es6-string-css
-Id: bashmish.es6-string-css
-Description: Highlight CSS language in ES6 template literals
-Version: 0.1.0
-Publisher: Mikhail Bashkirov
-VS Marketplace Link: https://marketplace.visualstudio.com/items?itemName=bashmish.es6-string-css
-
-Name: lit-html
-Id: bierner.lit-html
-Description: Syntax highlighting and IntelliSense for html inside of JavaScript and TypeScript tagged template strings
-Version: 1.11.1
-Publisher: Matt Bierner
-VS Marketplace Link: https://marketplace.visualstudio.com/items?itemName=bierner.lit-html
-
-*/
-
 /**
  * Query selector.
  *
@@ -443,12 +418,48 @@ function hexToRgbA(hex) {
 
 const htmlStrSanitize = (str) => (str ? str.replace(/<\/?[^>]+(>|$)/g, '').trim() : '');
 
+/**
+ * Query selector inside an iframe. Allows obtaining a single element that is
+ * inside an iframe in order to execute events on it.
+ * Note: the iframe must be same-origin for this to work.
+ *
+ * @param {string|Element} iframeEl The CSS selector string or the iframe Element itself.
+ * @param {string} el The query selector for the element inside the iframe.
+ * @returns {Element|null} The matched element inside the iframe, or null if not found.
+ * @memberof VanillaJS
+ */
+const sIframe = (iframeEl, el) => {
+  const iframe = typeof iframeEl === 'string' ? s(iframeEl) : iframeEl;
+  if (!iframe) return null;
+  const iframeDoc = iframe.contentDocument || iframe.contentWindow?.document;
+  return iframeDoc ? iframeDoc.querySelector(el) : null;
+};
+
+/**
+ * Query selector all inside an iframe. Allows obtaining all elements matching a
+ * selector that are inside an iframe in order to execute events on them.
+ * Note: the iframe must be same-origin for this to work.
+ *
+ * @param {string|Element} iframeEl The CSS selector string or the iframe Element itself.
+ * @param {string} el The query selector for the elements inside the iframe.
+ * @returns {NodeList|null} A NodeList of matched elements inside the iframe, or null if not found.
+ * @memberof VanillaJS
+ */
+const saIframe = (iframeEl, el) => {
+  const iframe = typeof iframeEl === 'string' ? s(iframeEl) : iframeEl;
+  if (!iframe) return null;
+  const iframeDoc = iframe.contentDocument || iframe.contentWindow?.document;
+  return iframeDoc ? iframeDoc.querySelectorAll(el) : null;
+};
+
 export {
   s,
   htmls,
   append,
   prepend,
   sa,
+  sIframe,
+  saIframe,
   copyData,
   pasteData,
   preHTML,

package/src/client/services/user/user.management.js

@@ -45,11 +45,6 @@ const UserManagement = {
       ],
       defaultColKeyFocus: 'username',
       ServiceProvider: UserService,
-      serviceOptions: {
-        get: {
-          id: 'all',
-        },
-      },
     });
   },
 };

package/src/client/services/user/user.service.js

@@ -38,7 +38,7 @@ const UserService = {
         }),
     ),
   get: (options = {}) => {
-    const { id, page, limit, filterModel, sortModel, sort, asc, order } = options;
+    const { id = 'all', page, limit, filterModel, sortModel, sort, asc, order } = options;
     const url = buildQueryUrl(getApiBaseUrl({ id, endpoint }), {
       page,
       limit,

package/src/index.js

@@ -12,6 +12,7 @@ import UnderpostDB from './cli/db.js';
 import UnderpostDeploy from './cli/deploy.js';
 import UnderpostRootEnv from './cli/env.js';
 import UnderpostFileStorage from './cli/fs.js';
+import UnderpostIPFS from './cli/ipfs.js';
 import UnderpostImage from './cli/image.js';
 import UnderpostLxd from './cli/lxd.js';
 import UnderpostMonitor from './cli/monitor.js';
@@ -41,7 +42,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v2.99.8';
+  static version = 'v3.0.1';
 
   /**
    * Required Node.js major version
@@ -143,6 +144,15 @@ class Underpost {
   static get fs() {
     return UnderpostFileStorage.API;
   }
+  /**
+   * IPFS cli API
+   * @static
+   * @type {UnderpostIPFS.API}
+   * @memberof Underpost
+   */
+  static get ipfs() {
+    return UnderpostIPFS.API;
+  }
   /**
    * Monitor cli API
    * @static
@@ -296,6 +306,7 @@ export {
   UnderpostStatic,
   UnderpostLxd,
   UnderpostKickStart,
+  UnderpostIPFS,
   UnderpostMonitor,
   UnderpostRepository,
   UnderpostRun,

package/src/runtime/express/Express.js

@@ -20,6 +20,7 @@ import { createPeerServer } from '../../server/peer.js';
 import { createValkeyConnection } from '../../server/valkey.js';
 import { applySecurity, authMiddlewareFactory } from '../../server/auth.js';
 import { ssrMiddlewareFactory } from '../../server/ssr.js';
+import { buildSwaggerUiOptions } from '../../server/client-build-docs.js';
 
 import { shellExec } from '../../server/process.js';
 import { devProxyHostFactory, isDevProxyContext, isTlsDevProxy } from '../../server/conf.js';
@@ -167,8 +168,8 @@ class ExpressService {
       // Swagger UI setup
       if (fs.existsSync(swaggerJsonPath)) {
         const swaggerDoc = JSON.parse(fs.readFileSync(swaggerJsonPath, 'utf8'));
-        // Reusing swaggerPath defined outside, removing unnecessary redeclaration
-        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc));
+        const swaggerUiOptions = await buildSwaggerUiOptions();
+        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc, swaggerUiOptions));
       }
 
       // Security and CORS

package/src/server/client-build-docs.js

@@ -7,10 +7,10 @@
  */
 
 import fs from 'fs-extra';
-import swaggerAutoGen from 'swagger-autogen';
 import { shellExec } from './process.js';
 import { loggerFactory } from './logger.js';
 import { JSONweb } from './client-formatted.js';
+import { ssrFactory } from './ssr.js';
 
 /**
  * Builds API documentation using Swagger
@@ -63,53 +63,91 @@ const buildApiDocs = async ({
     components: {
       schemas: {
         userRequest: {
-          username: 'user123',
-          password: 'Password123',
-          email: 'user@example.com',
+          type: 'object',
+          required: ['username', 'password', 'email'],
+          properties: {
+            username: { type: 'string', example: 'user123' },
+            password: { type: 'string', example: 'Password123!' },
+            email: { type: 'string', format: 'email', example: 'user@example.com' },
+          },
         },
         userResponse: {
-          status: 'success',
-          data: {
-            token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7Il9pZCI6IjY2YzM3N2Y1N2Y5OWU1OTY5YjgxZG...',
-            user: {
-              _id: '66c377f57f99e5969b81de89',
-              email: 'user@example.com',
-              emailConfirmed: false,
-              username: 'user123',
-              role: 'user',
-              profileImageId: '66c377f57f99e5969b81de87',
+          type: 'object',
+          properties: {
+            status: { type: 'string', example: 'success' },
+            data: {
+              type: 'object',
+              properties: {
+                token: {
+                  type: 'string',
+                  example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7Il9pZCI6IjY2YzM3N2Y1N2Y5OWU1OTY5YjgxZG...',
+                },
+                user: {
+                  type: 'object',
+                  properties: {
+                    _id: { type: 'string', example: '66c377f57f99e5969b81de89' },
+                    email: { type: 'string', format: 'email', example: 'user@example.com' },
+                    emailConfirmed: { type: 'boolean', example: false },
+                    username: { type: 'string', example: 'user123' },
+                    role: { type: 'string', example: 'user' },
+                    profileImageId: { type: 'string', example: '66c377f57f99e5969b81de87' },
+                  },
+                },
+              },
             },
           },
         },
         userUpdateResponse: {
-          status: 'success',
-          data: {
-            _id: '66c377f57f99e5969b81de89',
-            email: 'user@example.com',
-            emailConfirmed: false,
-            username: 'user123222',
-            role: 'user',
-            profileImageId: '66c377f57f99e5969b81de87',
+          type: 'object',
+          properties: {
+            status: { type: 'string', example: 'success' },
+            data: {
+              type: 'object',
+              properties: {
+                _id: { type: 'string', example: '66c377f57f99e5969b81de89' },
+                email: { type: 'string', format: 'email', example: 'user@example.com' },
+                emailConfirmed: { type: 'boolean', example: false },
+                username: { type: 'string', example: 'user123222' },
+                role: { type: 'string', example: 'user' },
+                profileImageId: { type: 'string', example: '66c377f57f99e5969b81de87' },
+              },
+            },
           },
         },
         userGetResponse: {
-          status: 'success',
-          data: {
-            _id: '66c377f57f99e5969b81de89',
-            email: 'user@example.com',
-            emailConfirmed: false,
-            username: 'user123222',
-            role: 'user',
-            profileImageId: '66c377f57f99e5969b81de87',
+          type: 'object',
+          properties: {
+            status: { type: 'string', example: 'success' },
+            data: {
+              type: 'object',
+              properties: {
+                _id: { type: 'string', example: '66c377f57f99e5969b81de89' },
+                email: { type: 'string', format: 'email', example: 'user@example.com' },
+                emailConfirmed: { type: 'boolean', example: false },
+                username: { type: 'string', example: 'user123222' },
+                role: { type: 'string', example: 'user' },
+                profileImageId: { type: 'string', example: '66c377f57f99e5969b81de87' },
+              },
+            },
           },
         },
         userLogInRequest: {
-          email: 'user@example.com',
-          password: 'Password123',
+          type: 'object',
+          required: ['email', 'password'],
+          properties: {
+            email: { type: 'string', format: 'email', example: 'user@example.com' },
+            password: { type: 'string', example: 'Password123!' },
+          },
         },
         userBadRequestResponse: {
-          status: 'error',
-          message: 'Bad request. Please check your inputs, and try again',
+          type: 'object',
+          properties: {
+            status: { type: 'string', example: 'error' },
+            message: {
+              type: 'string',
+              example: 'Bad request. Please check your inputs, and try again',
+            },
+          },
         },
       },
       securitySchemes: {
@@ -121,15 +159,100 @@ const buildApiDocs = async ({
     },
   };
 
+  /**
+   * swagger-autogen has no requestBody annotation support — it only handles
+   * #swagger.parameters, responses, security, etc.  We define the requestBody
+   * objects here and inject them into the generated JSON as a post-processing step.
+   *
+   * Each key is an "<method> <path>" pair matching the generated paths object.
+   * The value is a valid OAS 3.0 requestBody object.
+   */
+  const requestBodies = {
+    'post /user': {
+      description: 'User registration data',
+      required: true,
+      content: {
+        'application/json': {
+          schema: { $ref: '#/components/schemas/userRequest' },
+        },
+      },
+    },
+    'post /user/auth': {
+      description: 'User login credentials',
+      required: true,
+      content: {
+        'application/json': {
+          schema: { $ref: '#/components/schemas/userLogInRequest' },
+        },
+      },
+    },
+    'put /user/{id}': {
+      description: 'User fields to update',
+      required: true,
+      content: {
+        'application/json': {
+          schema: { $ref: '#/components/schemas/userRequest' },
+        },
+      },
+    },
+  };
+
   logger.warn('build swagger api docs', doc.info);
 
-  const outputFile = `./public/${host}${path === '/' ? path : `${path}/`}swagger-output.json`;
-  const routes = [];
-  for (const api of apis) {
-    if (['user'].includes(api)) routes.push(`./src/api/${api}/${api}.router.js`);
-  }
+  // swagger-autogen@2.9.2 bug: getProducesTag, getConsumesTag, getResponsesTag missing __¬¬¬__ decode before eval
+  fs.writeFileSync(
+    `node_modules/swagger-autogen/src/swagger-tags.js`,
+    fs
+      .readFileSync(`node_modules/swagger-autogen/src/swagger-tags.js`, 'utf8')
+      // getProducesTag and getConsumesTag: already decode &quot; but not __¬¬¬__
+      .replaceAll(
+        `data.replaceAll('\\n', ' ').replaceAll('\u201c', '\u201d')`,
+        `data.replaceAll('\\n', ' ').replaceAll('\u201c', '\u201d').replaceAll('__\u00ac\u00ac\u00ac__', '"')`,
+      )
+      // getResponsesTag: decodes neither &quot; nor __¬¬¬__
+      .replaceAll(
+        `data.replaceAll('\\n', ' ');`,
+        `data.replaceAll('\\n', ' ').replaceAll('__\u00ac\u00ac\u00ac__', '"');`,
+      ),
+    'utf8',
+  );
+  setTimeout(async () => {
+    const { default: swaggerAutoGen } = await import('swagger-autogen');
+    const outputFile = `./public/${host}${path === '/' ? path : `${path}/`}swagger-output.json`;
+    const routes = [];
+    for (const api of apis) {
+      if (['user'].includes(api)) routes.push(`./src/api/${api}/${api}.router.js`);
+    }
+
+    await swaggerAutoGen({ openapi: '3.0.0' })(outputFile, routes, doc);
+
+    // Post-process: inject requestBody into operations — swagger-autogen silently
+    // ignores #swagger.requestBody annotations and has no internal OAS-3 body support.
+    if (fs.existsSync(outputFile)) {
+      const swaggerJson = JSON.parse(fs.readFileSync(outputFile, 'utf8'));
+      let patched = false;
+
+      for (const [key, requestBody] of Object.entries(requestBodies)) {
+        const [method, ...pathParts] = key.split(' ');
+        const opPath = pathParts.join(' ');
+        if (swaggerJson.paths?.[opPath]?.[method]) {
+          swaggerJson.paths[opPath][method].requestBody = requestBody;
+          // Remove any stale in:body entry from parameters (OAS 3.0 doesn't allow it)
+          if (Array.isArray(swaggerJson.paths[opPath][method].parameters)) {
+            swaggerJson.paths[opPath][method].parameters = swaggerJson.paths[opPath][method].parameters.filter(
+              (p) => p.in !== 'body',
+            );
+          }
+          patched = true;
+        }
+      }
 
-  await swaggerAutoGen({ openapi: '3.0.0' })(outputFile, routes, doc);
+      if (patched) {
+        fs.writeFileSync(outputFile, JSON.stringify(swaggerJson, null, 2), 'utf8');
+        // logger.warn('swagger post-process: requestBody injected', Object.keys(requestBodies));
+      }
+    }
+  });
 };
 
 /**
@@ -228,4 +351,18 @@ const buildDocs = async ({
   });
 };
 
-export { buildDocs };
+/**
+ * Builds Swagger UI customization options by rendering the SwaggerDarkMode SSR body component.
+ * Returns the customCss and customJsStr strings required by swagger-ui-express to enable
+ * a dark/light mode toggle button with a black/gray gradient dark theme.
+ * @function buildSwaggerUiOptions
+ * @memberof clientBuildDocs
+ * @returns {Promise<{customCss: string, customJsStr: string}>} Swagger UI setup options
+ */
+const buildSwaggerUiOptions = async () => {
+  const swaggerDarkMode = await ssrFactory('./src/client/ssr/body/SwaggerDarkMode.js');
+  const { css, js } = swaggerDarkMode();
+  return { customCss: css, customJsStr: js };
+};
+
+export { buildDocs, buildSwaggerUiOptions };

package/src/server/conf.js

@@ -1335,7 +1335,7 @@ const buildCliDoc = (program, oldVersion, newVersion) => {
   });
   md = md.replaceAll(oldVersion, newVersion);
   fs.writeFileSync(`./src/client/public/nexodev/docs/references/Command Line Interface.md`, md, 'utf8');
-  fs.writeFileSync(`./cli.md`, md, 'utf8');
+  fs.writeFileSync(`./CLI-HELP.md`, md, 'utf8');
   const readme = fs.readFileSync(`./README.md`, 'utf8');
   fs.writeFileSync('./README.md', readme.replaceAll(oldVersion, newVersion), 'utf8');
 };

package/src/server/logger.js

@@ -101,27 +101,37 @@ const setUpInfo = async (logger = new winston.Logger()) => {
  * @param meta - The `meta` parameter in the `loggerFactory` function is used to extract the last part
  * of a URL and use it to create log files in a specific directory.
  * @param logLevel - Specify the logging level for the logger instance. e.g., 'error', 'warn', 'info', 'debug'.
+ * @param enableFileLogs - Whether to write logs to files. Defaults to the value of the `ENABLE_FILE_LOGS` environment variable.
  * @returns {underpostLogger} The `loggerFactory` function returns a logger instance created using Winston logger
  * library. The logger instance is configured with various transports for printing out messages to
  * different destinations such as the terminal, error.log file, and all.log file. The logger instance
  * also has a method `setUpInfo` attached to it for setting up additional information.
  * @memberof Logger
  */
-const loggerFactory = (meta = { url: '' }, logLevel = '') => {
+const loggerFactory = (
+  meta = { url: '' },
+  logLevel = '',
+  enableFileLogs = process.env.ENABLE_FILE_LOGS === 'true' || process.env.ENABLE_FILE_LOGS === true,
+) => {
   meta = meta.url.split('/').pop();
   // Define which transports the logger must use to print out messages.
   // In this example, we are using three different transports
   const transports = [
     // Allow the use the terminal to print the messages
     new winston.transports.Console(),
-    // Allow to print all the error level messages inside the error.log file
-    // new winston.transports.File({
-    //   filename: `logs/${meta}/error.log`,
-    //   level: 'error',
-    // }),
-    // Allow to print all the error message inside the all.log file
-    // (also the error log that are also printed inside the error.log(
-    new winston.transports.File({ filename: `logs/${meta}/all.log` }),
+    // Optionally write log files when enableFileLogs is true
+    ...(enableFileLogs
+      ? [
+          // Allow to print all the error level messages inside the error.log file
+          new winston.transports.File({
+            filename: `logs/${meta}/error.log`,
+            level: 'error',
+          }),
+          // Allow to print all the error messages inside the all.log file
+          // (also includes error logs that are also printed inside error.log)
+          new winston.transports.File({ filename: `logs/${meta}/all.log` }),
+        ]
+      : []),
   ];
 
   // Create the logger instance that has to be exported
@@ -154,6 +164,7 @@ const loggerFactory = (meta = { url: '' }, logLevel = '') => {
  * @param {Object} meta - An object containing metadata, such as the URL, to be used in the logger.
  * @param {string} logLevel - The logging level to be used for the logger (e.g., 'error', 'warn', 'info', 'debug').
  * @param {Function} skip - A function to determine whether to skip logging for a particular request.
+ * @param {boolean} enableFileLogs - Whether to write logs to files. Defaults to false.
  * @returns {Function} A middleware function that can be used in an Express application to log HTTP requests.
  * @memberof Logger
  */
@@ -161,10 +172,11 @@ const loggerMiddleware = (
   meta = { url: '' },
   logLevel = 'info',
   skip = (req, res) => process.env.NODE_ENV === 'production',
+  enableFileLogs = process.env.ENABLE_FILE_LOGS === 'true' || process.env.ENABLE_FILE_LOGS === true,
 ) => {
   const stream = {
     // Use the http severity
-    write: (message) => loggerFactory(meta, logLevel).http(message),
+    write: (message) => loggerFactory(meta, logLevel, enableFileLogs).http(message),
   };
 
   morgan.token('host', function (req, res) {