cyberia 3.0.3 → 3.2.5

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

@@ -46,9 +46,12 @@ const main = () => {
         a {
           color: black;
         }
+        .main-body-ssr-500 {
+          top: 45%;
+        }
       </style>
 
-      <div class="abs center" style="top: 45%">
+      <div class="abs center main-body-ssr-500">
         ${icon}
         <br />
         <br />
@@ -56,17 +59,18 @@ const main = () => {
         <br />
         <br />${Translate.Render('page-broken')} <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/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/head/PwaItemledger.js

@@ -0,0 +1,60 @@
+SrrComponent = () => html`<link rel="icon" type="image/x-icon" href="/favicon.ico">
+<link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png">
+<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png">
+<link rel="icon" type="image/png" sizes="48x48" href="/favicon-48x48.png">
+<link rel="manifest" href="/manifest.webmanifest" crossOrigin="use-credentials">
+<meta name="mobile-web-app-capable" content="yes">
+<meta name="theme-color" content="#0551C4">
+<meta name="application-name" content="Item Ledger">
+<link rel="apple-touch-icon" sizes="57x57" href="/apple-touch-icon-57x57.png">
+<link rel="apple-touch-icon" sizes="60x60" href="/apple-touch-icon-60x60.png">
+<link rel="apple-touch-icon" sizes="72x72" href="/apple-touch-icon-72x72.png">
+<link rel="apple-touch-icon" sizes="76x76" href="/apple-touch-icon-76x76.png">
+<link rel="apple-touch-icon" sizes="114x114" href="/apple-touch-icon-114x114.png">
+<link rel="apple-touch-icon" sizes="120x120" href="/apple-touch-icon-120x120.png">
+<link rel="apple-touch-icon" sizes="144x144" href="/apple-touch-icon-144x144.png">
+<link rel="apple-touch-icon" sizes="152x152" href="/apple-touch-icon-152x152.png">
+<link rel="apple-touch-icon" sizes="167x167" href="/apple-touch-icon-167x167.png">
+<link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon-180x180.png">
+<link rel="apple-touch-icon" sizes="1024x1024" href="/apple-touch-icon-1024x1024.png">
+<meta name="apple-mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+<meta name="apple-mobile-web-app-title" content="Item Ledger">
+<link rel="apple-touch-startup-image" media="(device-width: 320px) and (device-height: 568px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-640x1136.png">
+<link rel="apple-touch-startup-image" media="(device-width: 320px) and (device-height: 568px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1136x640.png">
+<link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 667px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-750x1334.png">
+<link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 667px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1334x750.png">
+<link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 812px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1125x2436.png">
+<link rel="apple-touch-startup-image" media="(device-width: 375px) and (device-height: 812px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2436x1125.png">
+<link rel="apple-touch-startup-image" media="(device-width: 390px) and (device-height: 844px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1170x2532.png">
+<link rel="apple-touch-startup-image" media="(device-width: 390px) and (device-height: 844px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2532x1170.png">
+<link rel="apple-touch-startup-image" media="(device-width: 393px) and (device-height: 852px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1179x2556.png">
+<link rel="apple-touch-startup-image" media="(device-width: 393px) and (device-height: 852px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2556x1179.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-828x1792.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-1792x828.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1242x2688.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 896px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2688x1242.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 736px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1242x2208.png">
+<link rel="apple-touch-startup-image" media="(device-width: 414px) and (device-height: 736px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2208x1242.png">
+<link rel="apple-touch-startup-image" media="(device-width: 428px) and (device-height: 926px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1284x2778.png">
+<link rel="apple-touch-startup-image" media="(device-width: 428px) and (device-height: 926px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2778x1284.png">
+<link rel="apple-touch-startup-image" media="(device-width: 430px) and (device-height: 932px) and (-webkit-device-pixel-ratio: 3) and (orientation: portrait)" href="/apple-touch-startup-image-1290x2796.png">
+<link rel="apple-touch-startup-image" media="(device-width: 430px) and (device-height: 932px) and (-webkit-device-pixel-ratio: 3) and (orientation: landscape)" href="/apple-touch-startup-image-2796x1290.png">
+<link rel="apple-touch-startup-image" media="(device-width: 744px) and (device-height: 1133px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1488x2266.png">
+<link rel="apple-touch-startup-image" media="(device-width: 744px) and (device-height: 1133px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2266x1488.png">
+<link rel="apple-touch-startup-image" media="(device-width: 768px) and (device-height: 1024px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1536x2048.png">
+<link rel="apple-touch-startup-image" media="(device-width: 768px) and (device-height: 1024px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2048x1536.png">
+<link rel="apple-touch-startup-image" media="(device-width: 810px) and (device-height: 1080px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1620x2160.png">
+<link rel="apple-touch-startup-image" media="(device-width: 810px) and (device-height: 1080px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2160x1620.png">
+<link rel="apple-touch-startup-image" media="(device-width: 820px) and (device-height: 1080px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1640x2160.png">
+<link rel="apple-touch-startup-image" media="(device-width: 820px) and (device-height: 1080px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2160x1640.png">
+<link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1194px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1668x2388.png">
+<link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1194px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2388x1668.png">
+<link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1112px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-1668x2224.png">
+<link rel="apple-touch-startup-image" media="(device-width: 834px) and (device-height: 1112px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2224x1668.png">
+<link rel="apple-touch-startup-image" media="(device-width: 1024px) and (device-height: 1366px) and (-webkit-device-pixel-ratio: 2) and (orientation: portrait)" href="/apple-touch-startup-image-2048x2732.png">
+<link rel="apple-touch-startup-image" media="(device-width: 1024px) and (device-height: 1366px) and (-webkit-device-pixel-ratio: 2) and (orientation: landscape)" href="/apple-touch-startup-image-2732x2048.png">
+<meta name="msapplication-TileColor" content="#0551C4">
+<meta name="msapplication-TileImage" content="/mstile-144x144.png">
+<meta name="msapplication-config" content="/browserconfig.xml">
+<link rel="yandex-tableau-widget" href="/yandex-browser-manifest.json">`;

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/CyberiaServerMetrics.js

@@ -93,7 +93,7 @@ const createEntityCard = (entityType) => {
 
 const fetchMetrics = async () => {
   try {
-    const response = await fetch('http://localhost:8080/api/v1/metrics');
+    const response = await fetch('/api/v1/metrics');
     if (!response.ok) throw new Error('Failed to fetch metrics');
     return await response.json();
   } catch (error) {

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/client.build.js

@@ -3,14 +3,11 @@
 // https://nodejs.org/api
 // https://expressjs.com/en/4x/api.html
 
-import dotenv from 'dotenv';
 import { loggerFactory } from './server/logger.js';
 import { Config } from './server/conf.js';
 import { ProcessController } from './server/process.js';
 import { clientLiveBuild } from './server/client-build-live.js';
 
-dotenv.config();
-
 await Config.build();
 
 const logger = loggerFactory(import.meta);

package/src/client.dev.js

@@ -3,14 +3,11 @@
 // https://nodejs.org/api
 // https://expressjs.com/en/4x/api.html
 
-import dotenv from 'dotenv';
 import { loggerFactory } from './server/logger.js';
 import { ProcessController } from './server/process.js';
 import { Config, buildClientStaticConf } from './server/conf.js';
 import { createClientDevServer } from './server/client-dev-server.js';
 
-dotenv.config();
-
 const logger = loggerFactory(import.meta);
 
 await logger.setUpInfo();

package/src/db/DataBaseProvider.js

@@ -13,7 +13,7 @@ const logger = loggerFactory(import.meta);
  * @class
  * @alias DataBaseProviderService
  * @memberof DataBaseProviderService
- * @classdesc Centralized service for loading, managing, and accessing multiple database connections
+ * @classdesc Service for loading, managing, and accessing multiple database connections
  * based on application configuration (host, path, provider type).
  */
 class DataBaseProviderService {
@@ -81,7 +81,22 @@ class DataBaseProviderService {
       }
       return this.#instance[key][db.provider];
     } catch (error) {
-      logger.error(error, { error: error.stack, options });
+      // Sanitize options to prevent credential exposure in logs
+      const safeOptions = {
+        apis: options.apis,
+        host: options.host,
+        path: options.path,
+        db: options.db
+          ? {
+              provider: options.db.provider,
+              name: options.db.name ? '***' : undefined,
+              host: options.db.host ? '***' : undefined,
+              user: options.db.user ? '***' : undefined,
+              password: options.db.password ? '***' : undefined,
+            }
+          : {},
+      };
+      logger.error(error.message, { safeOptions });
       return undefined;
     }
   }

package/src/db/mariadb/MariaDB.js

@@ -16,6 +16,11 @@ const logger = loggerFactory(import.meta);
  * @memberof MariaDBService
  * @classdesc Provides a simplified interface for executing queries against a MariaDB/MySQL database
  * using a connection pool, ensuring connection management (acquisition and release).
+ *
+ * Connection credentials are resolved in the following order:
+ * 1. Explicit values passed in the `options` parameter.
+ * 2. Environment variables (`MARIADB_HOST`, `MARIADB_PORT`, `MARIADB_USER`, `MARIADB_PASSWORD`).
+ * 3. Safe built-in defaults (`127.0.0.1`, `3306`, `root`, empty password).
  */
 class MariaDBService {
   /**
@@ -23,20 +28,20 @@ class MariaDBService {
    *
    * @async
    * @param {object} options - The database connection and query options.
-   * @param {string} [options.host='127.0.0.1'] - The database host.
-   * @param {number} [options.port=3306] - The database port.
-   * @param {string} [options.user='root'] - The database user.
-   * @param {string} [options.password=''] - The database password.
+   * @param {string} [options.host] - The database host. Falls back to `process.env.MARIADB_HOST` then `'127.0.0.1'`.
+   * @param {number} [options.port] - The database port. Falls back to `process.env.MARIADB_PORT` then `3306`.
+   * @param {string} [options.user] - The database user. Falls back to `process.env.MARIADB_USER` then `'root'`.
+   * @param {string} [options.password] - The database password. Falls back to `process.env.MARIADB_PASSWORD` then `''`.
    * @param {string} options.query - The SQL query string to execute.
    * @returns {Promise<any>} The result of the database query.
    */
   async query(options) {
     const { host, port, user, password, query } = options;
     const pool = createPool({
-      host: 'host' in options ? host : '127.0.0.1',
-      port: 'port' in options ? port : 3306,
-      user: 'user' in options ? user : 'root',
-      password: 'password' in options ? password : '',
+      host: 'host' in options ? host : process.env.MARIADB_HOST || '127.0.0.1',
+      port: 'port' in options ? port : parseInt(process.env.MARIADB_PORT, 10) || 3306,
+      user: 'user' in options ? user : process.env.MARIADB_USER || 'root',
+      password: 'password' in options ? password : process.env.MARIADB_PASSWORD || '',
     });
     let conn, result;
     try {
@@ -45,7 +50,7 @@ class MariaDBService {
       logger.info('query');
       console.log(result);
     } catch (error) {
-      logger.error(error, error.stack);
+      logger.error('MariaDB query failed', { error: error.message });
     } finally {
       if (conn) conn.release(); // release to pool
       await pool.end();

package/src/db/mongo/MongooseDB.js

@@ -16,17 +16,33 @@ const logger = loggerFactory(import.meta);
  * @memberof MongooseDBService
  * @classdesc Manages the Mongoose connection lifecycle and dynamic loading of database models
  * based on API configuration.
+ *
+ * Connection parameters are resolved in the following order:
+ * 1. Explicit values passed as arguments to {@link MongooseDBService#connect}.
+ * 2. Environment variables (`DB_HOST` for host, `DB_NAME` for database name).
+ * 3. No built-in defaults — both `host` and `name` are required from the caller or environment.
  */
 class MongooseDBService {
   /**
    * Establishes a Mongoose connection to the specified MongoDB instance.
    *
    * @async
-   * @param {string} host - The MongoDB host (e.g., 'mongodb://localhost:27017').
+   * @param {string} host - The MongoDB host URI (e.g., `'mongodb://localhost:27017'`).
+   *   Falls back to `process.env.DB_HOST` when not provided.
    * @param {string} name - The database name.
+   *   Falls back to `process.env.DB_NAME` when not provided.
    * @returns {Promise<mongoose.Connection>} A promise that resolves to the established Mongoose connection object.
+   * @throws {Error} If neither the argument nor the corresponding environment variable supplies a value.
    */
   async connect(host, name) {
+    host = host || process.env.DB_HOST;
+    name = name || process.env.DB_NAME;
+
+    if (!host || !name) {
+      const missing = [!host && 'host (DB_HOST)', !name && 'name (DB_NAME)'].filter(Boolean).join(', ');
+      throw new Error(`MongooseDBService.connect: missing required parameter(s): ${missing}`);
+    }
+
     const uri = `${host}/${name}`;
     // logger.info('MongooseDB connect', { host, name, uri });
     return await mongoose