underpost 3.1.1 → 3.1.3

package/src/client/ssr/body/SwaggerDarkMode.js

@@ -0,0 +1,285 @@
+const swaggerDarkCss = css`
+  /* ── Toggle button ── */
+  .swagger-ui .topbar-wrapper {
+    display: flex;
+    align-items: center;
+  }
+  .swagger-theme-toggle-btn {
+    background: rgba(255, 255, 255, 0.12);
+    border: 1px solid rgba(255, 255, 255, 0.3);
+    color: #fff;
+    padding: 5px 14px;
+    border-radius: 4px;
+    cursor: pointer;
+    font-size: 13px;
+    margin-left: auto;
+    margin-right: 16px;
+    white-space: nowrap;
+    transition: background 0.2s ease;
+  }
+  .swagger-theme-toggle-btn:hover {
+    background: rgba(255, 255, 255, 0.25);
+  }
+
+  /* ── Dark mode overrides — black/gray gradients ── */
+  body.swagger-dark {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui .wrapper {
+    background: #0f0f0f;
+  }
+
+  /* Info block */
+  body.swagger-dark .swagger-ui .info .title,
+  body.swagger-dark .swagger-ui .info h1,
+  body.swagger-dark .swagger-ui .info h2,
+  body.swagger-dark .swagger-ui .info h3,
+  body.swagger-dark .swagger-ui .info p,
+  body.swagger-dark .swagger-ui .info li,
+  body.swagger-dark .swagger-ui .info a {
+    color: #e8e8e8;
+  }
+
+  /* Scheme / server selector bar */
+  body.swagger-dark .swagger-ui .scheme-container {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    box-shadow: 0 1px 0 #383838;
+  }
+  body.swagger-dark .swagger-ui select {
+    background: #2a2a2a;
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+
+  /* Operation tags */
+  body.swagger-dark .swagger-ui .opblock-tag {
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock-tag small {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-tag:hover {
+    background: rgba(255, 255, 255, 0.04);
+  }
+
+  /* Operation blocks */
+  body.swagger-dark .swagger-ui .opblock {
+    background: linear-gradient(180deg, #161616 0%, #1e1e1e 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock .opblock-summary {
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock .opblock-summary-description,
+  body.swagger-dark .swagger-ui .opblock .opblock-summary-operation-id {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-body {
+    background: #0f0f0f;
+  }
+  body.swagger-dark .swagger-ui .opblock-description-wrapper p,
+  body.swagger-dark .swagger-ui .opblock-external-docs-wrapper p {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .opblock-section-header {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .opblock-section-header h4 {
+    color: #e8e8e8;
+  }
+
+  /* Models section */
+  body.swagger-dark .swagger-ui section.models {
+    background: linear-gradient(180deg, #161616 0%, #1e1e1e 100%);
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui section.models h4,
+  body.swagger-dark .swagger-ui section.models h5 {
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui .model-container {
+    background: #0f0f0f;
+    border-color: #2a2a2a;
+  }
+  body.swagger-dark .swagger-ui .model-box {
+    background: #1a1a1a;
+  }
+  body.swagger-dark .swagger-ui .model,
+  body.swagger-dark .swagger-ui .model-title,
+  body.swagger-dark .swagger-ui .model span,
+  body.swagger-dark .swagger-ui .model .property {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .model .property.primitive {
+    color: #a8a8a8;
+  }
+
+  /* Tables */
+  body.swagger-dark .swagger-ui table thead tr th {
+    background: linear-gradient(180deg, #222222 0%, #2a2a2a 100%);
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+  body.swagger-dark .swagger-ui table tbody tr td {
+    color: #a8a8a8;
+    border-color: #2a2a2a;
+  }
+
+  /* Parameters */
+  body.swagger-dark .swagger-ui .parameter__name,
+  body.swagger-dark .swagger-ui .parameter__type,
+  body.swagger-dark .swagger-ui .parameter__in,
+  body.swagger-dark .swagger-ui .parameter__extension,
+  body.swagger-dark .swagger-ui .parameter__empty_value_toggle {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .parameter__name.required:after {
+    color: #ff6b6b;
+  }
+
+  /* Inputs & textareas */
+  body.swagger-dark .swagger-ui input[type='text'],
+  body.swagger-dark .swagger-ui input[type='email'],
+  body.swagger-dark .swagger-ui input[type='password'],
+  body.swagger-dark .swagger-ui input[type='search'],
+  body.swagger-dark .swagger-ui input[type='number'],
+  body.swagger-dark .swagger-ui textarea {
+    background: #2a2a2a;
+    color: #e8e8e8;
+    border-color: #383838;
+  }
+
+  /* Buttons */
+  body.swagger-dark .swagger-ui .btn {
+    color: #e8e8e8;
+    border-color: #383838;
+    background: #222222;
+  }
+  body.swagger-dark .swagger-ui .btn:hover {
+    background: #2a2a2a;
+  }
+  body.swagger-dark .swagger-ui .btn.authorize {
+    color: #49cc90;
+    border-color: #49cc90;
+    background: transparent;
+  }
+  body.swagger-dark .swagger-ui .btn.execute {
+    background: linear-gradient(180deg, #333333 0%, #262626 100%);
+    border-color: #484848;
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .btn.cancel {
+    color: #ff6b6b;
+    border-color: #ff6b6b;
+  }
+
+  /* Responses */
+  body.swagger-dark .swagger-ui .responses-inner h4,
+  body.swagger-dark .swagger-ui .responses-inner h5 {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .response-col_status {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .response-col_description__inner p {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .response {
+    border-color: #2a2a2a;
+  }
+
+  /* Code / highlight */
+  body.swagger-dark .swagger-ui .highlight-code,
+  body.swagger-dark .swagger-ui .microlight {
+    background: #1a1a1a;
+    border: 1px solid #2a2a2a;
+  }
+
+  /* Markdown */
+  body.swagger-dark .swagger-ui .markdown p,
+  body.swagger-dark .swagger-ui .markdown li,
+  body.swagger-dark .swagger-ui .markdown a {
+    color: #a8a8a8;
+  }
+
+  /* Tabs */
+  body.swagger-dark .swagger-ui .tab li {
+    color: #a8a8a8;
+  }
+  body.swagger-dark .swagger-ui .tab li.active {
+    color: #e8e8e8;
+  }
+
+  /* Auth / modal dialog */
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux {
+    background: linear-gradient(180deg, #1a1a1a 0%, #222222 100%);
+    border: 1px solid #383838;
+    box-shadow: 0 4px 24px rgba(0, 0, 0, 0.7);
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-header {
+    border-bottom: 1px solid #383838;
+    background: linear-gradient(180deg, #222222 0%, #1a1a1a 100%);
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-header h3 {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content p,
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content label,
+  body.swagger-dark .swagger-ui .dialog-ux .modal-ux-content h4 {
+    color: #e8e8e8;
+  }
+  body.swagger-dark .swagger-ui .auth-container .errors {
+    color: #ff6b6b;
+  }
+
+  /* Info / description */
+  body.swagger-dark .swagger-ui .info .base-url,
+  body.swagger-dark .swagger-ui .servers-title,
+  body.swagger-dark .swagger-ui .servers > label {
+    color: #a8a8a8;
+  }
+
+  /* Expand/collapse arrows */
+  body.swagger-dark .swagger-ui svg.arrow path {
+    fill: #a8a8a8;
+  }
+`;
+
+const swaggerDarkJs = `(function () {
+  function injectThemeToggle() {
+    var topbarWrapper = document.querySelector('.swagger-ui .topbar-wrapper');
+    if (!topbarWrapper || document.getElementById('swagger-theme-toggle')) return;
+
+    var savedTheme = localStorage.getItem('swagger-theme') || 'light';
+    if (savedTheme === 'dark') document.body.classList.add('swagger-dark');
+
+    var btn = document.createElement('button');
+    btn.id = 'swagger-theme-toggle';
+    btn.className = 'swagger-theme-toggle-btn';
+    btn.setAttribute('title', 'Toggle dark / light mode');
+    btn.textContent = savedTheme === 'dark' ? '\u2600\uFE0F Light Mode' : '\uD83C\uDF19 Dark Mode';
+
+    btn.addEventListener('click', function () {
+      var isDark = document.body.classList.toggle('swagger-dark');
+      localStorage.setItem('swagger-theme', isDark ? 'dark' : 'light');
+      btn.textContent = isDark ? '\u2600\uFE0F Light Mode' : '\uD83C\uDF19 Dark Mode';
+    });
+
+    topbarWrapper.appendChild(btn);
+  }
+
+  var poll = setInterval(function () {
+    if (document.querySelector('.swagger-ui .topbar-wrapper')) {
+      injectThemeToggle();
+      clearInterval(poll);
+    }
+  }, 100);
+})();`;
+
+SrrComponent = () => ({ css: swaggerDarkCss, js: swaggerDarkJs });

package/src/client/ssr/offline/NoNetworkConnection.js

@@ -51,17 +51,18 @@ const main = () => {
         <br />
         <br />${Translate.Render('no-internet-connection')} <br />
         <br />
-        <a href="${location.origin}">${Translate.Render('back')}</a>
+        <a target="_top" href="${location.origin}">${Translate.Render('back')}</a>
       </div>`,
   );
 };
 
-SrrComponent = () => html`<script>
-  {
-    const s = ${s};
-    const append = ${append};
-    const getLang = ${getLang};
-    const main = ${main};
-    window.onload = main;
-  }
-</script>`;
+SrrComponent = () =>
+  html`<script>
+    {
+      const s = ${s};
+      const append = ${append};
+      const getLang = ${getLang};
+      const main = ${main};
+      window.onload = main;
+    }
+  </script>`;

package/src/client/ssr/pages/Test.js

@@ -182,17 +182,18 @@ const main = () => {
         <span class="bold">Test Page</span>
         <br />
         <br />
-        <a href="${location.origin}">${Translate.Render('back')}</a>
+        <a target="_top" href="${location.origin}">${Translate.Render('back')}</a>
       </div>`,
   );
 };
 
-SrrComponent = () => html`<script>
-  {
-    const s = ${s};
-    const append = ${append};
-    const getLang = ${getLang};
-    const main = ${main};
-    window.onload = main;
-  }
-</script>`;
+SrrComponent = () =>
+  html`<script>
+    {
+      const s = ${s};
+      const append = ${append};
+      const getLang = ${getLang};
+      const main = ${main};
+      window.onload = main;
+    }
+  </script>`;

package/src/index.js

@@ -42,7 +42,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v3.1.1';
+  static version = 'v3.1.3';
 
   /**
    * Required Node.js major version

package/src/runtime/express/Express.js

@@ -165,14 +165,7 @@ class ExpressService {
         });
       }
 
-      // Swagger UI setup
-      if (fs.existsSync(swaggerJsonPath)) {
-        const swaggerDoc = JSON.parse(fs.readFileSync(swaggerJsonPath, 'utf8'));
-        const swaggerUiOptions = await buildSwaggerUiOptions();
-        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc, swaggerUiOptions));
-      }
-
-      // Security and CORS
+      // Security and CORS — must run before swagger-ui so CSP headers are included in swagger responses
       if (process.env.NODE_ENV === 'development' && useLocalSsl)
         origins = origins.map((origin) => origin.replace('http', 'https'));
 
@@ -180,6 +173,13 @@ class ExpressService {
         origin: origins,
       });
 
+      // Swagger UI setup (after security middleware so responses carry correct CSP headers)
+      if (fs.existsSync(swaggerJsonPath)) {
+        const swaggerDoc = JSON.parse(fs.readFileSync(swaggerJsonPath, 'utf8'));
+        const swaggerUiOptions = await buildSwaggerUiOptions();
+        app.use(swaggerPath, swaggerUi.serve, swaggerUi.setup(swaggerDoc, swaggerUiOptions));
+      }
+
       // Database and Valkey connections
       if (db && apis) await DataBaseProvider.load({ apis, host, path, db });
 

package/src/server/auth.js

@@ -613,13 +613,13 @@ function applySecurity(app, opts = {}) {
         frameAncestors: frameAncestors,
         imgSrc: ["'self'", 'data:', httpDirective, 'https:', 'blob:'],
         objectSrc: ["'none'"],
-        // script-src and script-src-elem include dynamic nonce
-        scriptSrc: [
+        // script-src and script-src-elem: use 'unsafe-inline' for swagger (no nonce, otherwise
+        // the nonce causes 'unsafe-inline' to be ignored per CSP3 spec), nonce for everything else.
+        scriptSrc: ["'self'", (req, res) => (res.locals.isSwagger ? "'unsafe-inline'" : `'nonce-${res.locals.nonce}'`)],
+        scriptSrcElem: [
           "'self'",
-          (req, res) => `'nonce-${res.locals.nonce}'`,
-          (req, res) => (res.locals.isSwagger ? "'unsafe-inline'" : ''),
+          (req, res) => (res.locals.isSwagger ? "'unsafe-inline'" : `'nonce-${res.locals.nonce}'`),
         ],
-        scriptSrcElem: ["'self'", (req, res) => `'nonce-${res.locals.nonce}'`],
         // style-src: avoid 'unsafe-inline' when possible; if you must inline styles,
         // use a nonce for them too (or hash).
         styleSrc: [
@@ -627,6 +627,7 @@ function applySecurity(app, opts = {}) {
           httpDirective,
           (req, res) => (res.locals.isSwagger ? "'unsafe-inline'" : `'nonce-${res.locals.nonce}'`),
         ],
+        styleSrcAttr: [(req, res) => (res.locals.isSwagger ? "'unsafe-inline'" : "'none'")],
         // deny plugins
         objectSrc: ["'none'"],
       },

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

@@ -332,56 +332,17 @@ const buildApiDocs = async ({
  * @param {string} options.path - The base path for the documentation
  * @param {Object} options.metadata - Metadata for the documentation
  * @param {string} options.publicClientId - Client ID used to resolve the tutorials/references directory
+ * @param {Object} options.docs - Documentation config from server conf
+ * @param {string} options.docs.jsJsonPath - Path to the JSDoc JSON config file
  */
-const buildJsDocs = async ({ host, path, metadata = {}, publicClientId }) => {
+const buildJsDocs = async ({ host, path, metadata = {}, publicClientId, docs }) => {
   const logger = loggerFactory(import.meta);
 
-  // Detect custom jsdoc.<deployId>.json by matching host against deploy server configs
-  let customJsDocPath = '';
-  const privateConfBase = `./engine-private/conf`;
-  if (fs.existsSync(privateConfBase)) {
-    for (const deployId of fs.readdirSync(privateConfBase)) {
-      const candidatePath = `./jsdoc.${deployId}.json`;
-      if (!fs.existsSync(candidatePath)) continue;
-
-      // Check if this deployId's server config contains the current host
-      const serverConfPath = `${privateConfBase}/${deployId}/conf.server.json`;
-      if (fs.existsSync(serverConfPath)) {
-        try {
-          const serverConf = JSON.parse(fs.readFileSync(serverConfPath, 'utf8'));
-          if (serverConf[host]) {
-            customJsDocPath = candidatePath;
-            logger.info('detected custom jsdoc config', { deployId, host, path: candidatePath });
-            break;
-          }
-        } catch (e) {
-          // skip invalid JSON
-        }
-      }
-
-      // Fallback: also check dev server configs
-      if (!customJsDocPath) {
-        const devConfFiles = fs
-          .readdirSync(`${privateConfBase}/${deployId}`)
-          .filter((f) => f.match(/^conf\.server\.dev\..*\.json$/));
-        for (const devFile of devConfFiles) {
-          try {
-            const devConf = JSON.parse(fs.readFileSync(`${privateConfBase}/${deployId}/${devFile}`, 'utf8'));
-            if (devConf[host]) {
-              customJsDocPath = candidatePath;
-              logger.info('detected custom jsdoc config (dev)', { deployId, host, path: candidatePath });
-              break;
-            }
-          } catch (e) {
-            // skip invalid JSON
-          }
-        }
-      }
-      if (customJsDocPath) break;
-    }
+  const jsDocSourcePath = docs.jsJsonPath;
+  if (!fs.existsSync(jsDocSourcePath)) {
+    logger.warn('jsdoc config not found, skipping', jsDocSourcePath);
+    return;
   }
-
-  const jsDocSourcePath = customJsDocPath || `./jsdoc.json`;
   const jsDocsConfig = JSON.parse(fs.readFileSync(jsDocSourcePath, 'utf8'));
   logger.info('using jsdoc config', jsDocSourcePath);
 
@@ -391,22 +352,14 @@ const buildJsDocs = async ({ host, path, metadata = {}, publicClientId }) => {
 
   const tutorialsPath = `./src/client/public/${publicClientId}/docs/references`;
 
-  // Auto-prepare hardhat references when jsdoc config includes hardhat source files
-  const includesHardhat =
-    jsDocsConfig.source &&
-    Array.isArray(jsDocsConfig.source.include) &&
-    jsDocsConfig.source.include.some((p) => p.includes('hardhat/'));
-  if (includesHardhat && fs.existsSync(`./hardhat`)) {
+  if (Array.isArray(docs.references) && docs.references.length > 0) {
     fs.mkdirSync(tutorialsPath, { recursive: true });
-    const hardhatReadmePath = `./hardhat/README.md`;
-    const hardhatWhitePaperPath = `./hardhat/WHITE-PAPER.md`;
-    if (fs.existsSync(hardhatReadmePath)) {
-      fs.copySync(hardhatReadmePath, `${tutorialsPath}/Hardhat Module.md`);
-      logger.info('copied hardhat README.md to tutorials references');
-    }
-    if (fs.existsSync(hardhatWhitePaperPath)) {
-      fs.copySync(hardhatWhitePaperPath, `${tutorialsPath}/White Paper.md`);
-      logger.info('copied hardhat WHITE-PAPER.md to tutorials references');
+    for (const refPath of docs.references) {
+      if (fs.existsSync(refPath)) {
+        const fileName = refPath.split('/').pop();
+        fs.copySync(refPath, `${tutorialsPath}/${fileName}`);
+        logger.info('copied reference to tutorials', refPath);
+      }
     }
   }
 
@@ -420,10 +373,10 @@ const buildJsDocs = async ({ host, path, metadata = {}, publicClientId }) => {
     delete jsDocsConfig.opts.tutorials;
   }
 
-  fs.writeFileSync(`./jsdoc.json`, JSON.stringify(jsDocsConfig, null, 4), 'utf8');
+  fs.writeFileSync(jsDocSourcePath, JSON.stringify(jsDocsConfig, null, 4), 'utf8');
   logger.warn('build jsdoc view', jsDocsConfig.opts.destination);
 
-  shellExec(`npm run docs`, { silent: true });
+  shellExec(`npx jsdoc -c ${jsDocSourcePath}`, { silent: true });
 };
 
 /**
@@ -433,58 +386,37 @@ const buildJsDocs = async ({ host, path, metadata = {}, publicClientId }) => {
  * @param {Object} options - Coverage build options
  * @param {string} options.host - The hostname for the coverage
  * @param {string} options.path - The base path for the coverage
+ * @param {Object} options.docs - Documentation config from server conf
+ * @param {string} options.docs.coveragePath - Directory where to run npm run coverage
  */
-const buildCoverage = async ({ host, path }) => {
+const buildCoverage = async ({ host, path, docs }) => {
   const logger = loggerFactory(import.meta);
-  const jsDocsConfig = JSON.parse(fs.readFileSync(`./jsdoc.json`, 'utf8'));
-
-  if (!fs.existsSync(`./coverage`)) {
-    shellExec(`npm test`);
-  }
-
-  const coverageBuildPath = `${jsDocsConfig.opts.destination}coverage`;
-  fs.mkdirSync(coverageBuildPath, { recursive: true });
-  fs.copySync(`./coverage`, coverageBuildPath);
-
-  logger.warn('build coverage', coverageBuildPath);
+  const jsDocSourcePath = docs.jsJsonPath;
+  const jsDocsConfig = JSON.parse(fs.readFileSync(jsDocSourcePath, 'utf8'));
+  const coveragePath = docs.coveragePath;
 
-  // Include hardhat coverage for cyberia-related builds
-  const hardhatCoveragePath = `./hardhat/coverage`;
-  if (fs.existsSync(hardhatCoveragePath) && fs.readdirSync(hardhatCoveragePath).length > 0) {
-    const hardhatCoverageBuildPath = `${jsDocsConfig.opts.destination}hardhat-coverage`;
-    fs.mkdirSync(hardhatCoverageBuildPath, { recursive: true });
-    fs.copySync(hardhatCoveragePath, hardhatCoverageBuildPath);
-    logger.warn('build hardhat coverage', hardhatCoverageBuildPath);
-  } else if (fs.existsSync(`./hardhat/package.json`)) {
-    // Attempt to generate hardhat coverage if the hardhat project exists
-    try {
-      const hardhatPkg = JSON.parse(fs.readFileSync(`./hardhat/package.json`, 'utf8'));
-      if (hardhatPkg.scripts && hardhatPkg.scripts.coverage) {
-        logger.info('generating hardhat coverage report');
-        shellExec(`cd ./hardhat && npx hardhat coverage`, { silent: true });
-        if (fs.existsSync(hardhatCoveragePath) && fs.readdirSync(hardhatCoveragePath).length > 0) {
-          const hardhatCoverageBuildPath = `${jsDocsConfig.opts.destination}hardhat-coverage`;
-          fs.mkdirSync(hardhatCoverageBuildPath, { recursive: true });
-          fs.copySync(hardhatCoveragePath, hardhatCoverageBuildPath);
-          logger.warn('build hardhat coverage (generated)', hardhatCoverageBuildPath);
-        }
+  const coverageOutputPath = `${coveragePath}/coverage`;
+  if (!fs.existsSync(coverageOutputPath)) {
+    const pkgPath = `${coveragePath}/package.json`;
+    if (fs.existsSync(pkgPath)) {
+      const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+      if (pkg.scripts && pkg.scripts.coverage) {
+        logger.info('generating coverage report', coveragePath);
+        shellExec(`cd ${coveragePath} && npm run coverage`, { silent: true });
+      } else if (pkg.scripts && pkg.scripts.test) {
+        logger.info('generating coverage via test', coveragePath);
+        shellExec(`cd ${coveragePath} && npm test`, { silent: true });
       }
-    } catch (e) {
-      logger.warn('hardhat coverage generation skipped', e.message);
     }
   }
 
-  // Copy hardhat README and WHITE-PAPER as markdown docs
-  const docsDestBase = jsDocsConfig.opts.destination;
-  const hardhatReadmePath = `./hardhat/README.md`;
-  const hardhatWhitePaperPath = `./hardhat/WHITE-PAPER.md`;
-  if (fs.existsSync(hardhatReadmePath)) {
-    fs.copySync(hardhatReadmePath, `${docsDestBase}hardhat-README.md`);
-    logger.info('copied hardhat README.md to docs');
-  }
-  if (fs.existsSync(hardhatWhitePaperPath)) {
-    fs.copySync(hardhatWhitePaperPath, `${docsDestBase}hardhat-WHITE-PAPER.md`);
-    logger.info('copied hardhat WHITE-PAPER.md to docs');
+  if (fs.existsSync(coverageOutputPath) && fs.readdirSync(coverageOutputPath).length > 0) {
+    const coverageBuildPath = `${jsDocsConfig.opts.destination}coverage`;
+    fs.mkdirSync(coverageBuildPath, { recursive: true });
+    fs.copySync(coverageOutputPath, coverageBuildPath);
+    logger.warn('build coverage', coverageBuildPath);
+  } else {
+    logger.warn('no coverage output found, skipping', coverageOutputPath);
   }
 };
 
@@ -501,6 +433,7 @@ const buildCoverage = async ({ host, path }) => {
  * @param {string} options.publicClientId - Client ID for the public documentation
  * @param {string} options.rootClientPath - Root path for client files
  * @param {Object} options.packageData - Package.json data
+ * @param {Object} options.docs - Documentation config from server conf
  */
 const buildDocs = async ({
   host,
@@ -511,9 +444,10 @@ const buildDocs = async ({
   publicClientId,
   rootClientPath,
   packageData,
+  docs,
 }) => {
-  await buildJsDocs({ host, path, metadata, publicClientId });
-  await buildCoverage({ host, path });
+  await buildJsDocs({ host, path, metadata, publicClientId, docs });
+  await buildCoverage({ host, path, docs });
   await buildApiDocs({
     host,
     path,