cyberia 2.8.885

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

@@ -0,0 +1,198 @@
+const s = (el) => document.querySelector(el);
+
+const append = (el, html) => s(el).insertAdjacentHTML('beforeend', html);
+
+const getLang = () =>
+  (localStorage.getItem('lang') || navigator.language || navigator.userLanguage || s('html').lang)
+    .slice(0, 2)
+    .toLowerCase();
+
+const main = () => {
+  const Translate = {
+    Data: {
+      ['back']: {
+        en: 'Back to <br>  homepage',
+        es: 'Volver a  <br> la pagina principal',
+      },
+    },
+    Render: function (id) {
+      return this.Data[id][getLang()] ? this.Data[id][getLang()] : this.Data[id]['en'];
+    },
+  };
+  const icon = html`
+    <svg xmlns="http://www.w3.org/2000/svg" width="80" height="80" viewBox="0 0 32 32">
+      <g fill="none">
+        <g filter="url(#f2465id5)">
+          <path fill="#A5D9FF" d="m21.066 4.43l6.992 6.992l-16.926 16.926a4.944 4.944 0 1 1-6.992-6.992z" />
+        </g>
+        <g filter="url(#f2465id6)"><path fill="#C6EFFF" d="m23.37 7.524l1.653 1.653L17 17.199l-1.653-1.652z" /></g>
+        <g filter="url(#f2465id7)">
+          <path fill="#D1F884" d="m26.112 13.368l-14.98 14.98a4.944 4.944 0 1 1-6.992-6.992l7.988-7.988z" />
+          <path fill="url(#f2465id0)" d="m26.112 13.368l-14.98 14.98a4.944 4.944 0 1 1-6.992-6.992l7.988-7.988z" />
+        </g>
+        <path fill="url(#f2465id1)" d="M14.761 10.735L13.6 11.897l2.093 2.092a.822.822 0 0 0 1.162-1.162z" />
+        <path fill="url(#f2465id2)" d="m9.097 16.398l1.162-1.162l2.085 2.085a.822.822 0 1 1-1.162 1.162z" />
+        <path fill="url(#f2465id3)" d="m4.589 20.907l1.162-1.162l2.084 2.084a.822.822 0 0 1-1.163 1.162z" />
+        <g filter="url(#f2465id8)">
+          <path
+            fill="#A9D8FF"
+            d="M19.55 2.617a1.47 1.47 0 0 0 0 2.079l8.242 8.242a1.47 1.47 0 0 0 2.078-2.079l-8.242-8.242a1.47 1.47 0 0 0-2.078 0"
+          />
+          <path
+            fill="url(#f2465id4)"
+            d="M19.55 2.617a1.47 1.47 0 0 0 0 2.079l8.242 8.242a1.47 1.47 0 0 0 2.078-2.079l-8.242-8.242a1.47 1.47 0 0 0-2.078 0"
+          />
+        </g>
+        <g filter="url(#f2465id9)"><path fill="#C4ECFF" d="m19.916 4.001l1.11-1.11l8.376 8.374l-1.111 1.111z" /></g>
+        <defs>
+          <linearGradient id="f2465id0" x1="25.761" x2="17.074" y1="13.875" y2="16.875" gradientUnits="userSpaceOnUse">
+            <stop offset=".203" stop-color="#E9EB7E" />
+            <stop offset="1" stop-color="#E9EB7E" stop-opacity="0" />
+          </linearGradient>
+          <linearGradient id="f2465id1" x1="16.761" x2="14.011" y1="14.063" y2="11.469" gradientUnits="userSpaceOnUse">
+            <stop stop-color="#138979" />
+            <stop offset="1" stop-color="#2E7B65" />
+          </linearGradient>
+          <linearGradient id="f2465id2" x1="12.252" x2="9.508" y1="18.557" y2="15.969" gradientUnits="userSpaceOnUse">
+            <stop stop-color="#138979" />
+            <stop offset="1" stop-color="#2E7B65" />
+          </linearGradient>
+          <linearGradient id="f2465id3" x1="7.743" x2="5" y1="23.065" y2="20.477" gradientUnits="userSpaceOnUse">
+            <stop stop-color="#138979" />
+            <stop offset="1" stop-color="#2E7B65" />
+          </linearGradient>
+          <linearGradient id="f2465id4" x1="28.786" x2="28.656" y1="13.521" y2="11.86" gradientUnits="userSpaceOnUse">
+            <stop stop-color="#A8C3FF" />
+            <stop offset="1" stop-color="#A8C3FF" stop-opacity="0" />
+          </linearGradient>
+          <filter
+            id="f2465id5"
+            width="25.366"
+            height="25.366"
+            x="2.692"
+            y="4.43"
+            color-interpolation-filters="sRGB"
+            filterUnits="userSpaceOnUse"
+          >
+            <feFlood flood-opacity="0" result="BackgroundImageFix" />
+            <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+            <feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" />
+            <feOffset />
+            <feGaussianBlur stdDeviation="1" />
+            <feComposite in2="hardAlpha" k2="-1" k3="1" operator="arithmetic" />
+            <feColorMatrix values="0 0 0 0 0.745098 0 0 0 0 0.85098 0 0 0 0 0.964706 0 0 0 1 0" />
+            <feBlend in2="shape" result="effect1_innerShadow_18_24902" />
+          </filter>
+          <filter
+            id="f2465id6"
+            width="13.675"
+            height="13.675"
+            x="13.347"
+            y="5.524"
+            color-interpolation-filters="sRGB"
+            filterUnits="userSpaceOnUse"
+          >
+            <feFlood flood-opacity="0" result="BackgroundImageFix" />
+            <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+            <feGaussianBlur result="effect1_foregroundBlur_18_24902" stdDeviation="1" />
+          </filter>
+          <filter
+            id="f2465id7"
+            width="26.42"
+            height="17.178"
+            x="2.692"
+            y="12.618"
+            color-interpolation-filters="sRGB"
+            filterUnits="userSpaceOnUse"
+          >
+            <feFlood flood-opacity="0" result="BackgroundImageFix" />
+            <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+            <feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" />
+            <feOffset dx="4" dy="-.75" />
+            <feGaussianBlur stdDeviation="1.5" />
+            <feComposite in2="hardAlpha" k2="-1" k3="1" operator="arithmetic" />
+            <feColorMatrix values="0 0 0 0 0.505882 0 0 0 0 0.811765 0 0 0 0 0.34902 0 0 0 1 0" />
+            <feBlend in2="shape" result="effect1_innerShadow_18_24902" />
+            <feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" />
+            <feOffset dy="-.4" />
+            <feGaussianBlur stdDeviation=".5" />
+            <feComposite in2="hardAlpha" k2="-1" k3="1" operator="arithmetic" />
+            <feColorMatrix values="0 0 0 0 0.788235 0 0 0 0 0.843137 0 0 0 0 0.898039 0 0 0 1 0" />
+            <feBlend in2="effect1_innerShadow_18_24902" result="effect2_innerShadow_18_24902" />
+            <feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" />
+            <feOffset dx=".4" dy="-.4" />
+            <feGaussianBlur stdDeviation=".5" />
+            <feComposite in2="hardAlpha" k2="-1" k3="1" operator="arithmetic" />
+            <feColorMatrix values="0 0 0 0 0.67451 0 0 0 0 0.839216 0 0 0 0 0.623529 0 0 0 1 0" />
+            <feBlend in2="effect2_innerShadow_18_24902" result="effect3_innerShadow_18_24902" />
+          </filter>
+          <filter
+            id="f2465id8"
+            width="11.181"
+            height="11.181"
+            x="19.12"
+            y="2.187"
+            color-interpolation-filters="sRGB"
+            filterUnits="userSpaceOnUse"
+          >
+            <feFlood flood-opacity="0" result="BackgroundImageFix" />
+            <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+            <feColorMatrix in="SourceAlpha" result="hardAlpha" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0" />
+            <feOffset />
+            <feGaussianBlur stdDeviation=".5" />
+            <feComposite in2="hardAlpha" k2="-1" k3="1" operator="arithmetic" />
+            <feColorMatrix values="0 0 0 0 0.658824 0 0 0 0 0.776471 0 0 0 0 0.937255 0 0 0 1 0" />
+            <feBlend in2="shape" result="effect1_innerShadow_18_24902" />
+          </filter>
+          <filter
+            id="f2465id9"
+            width="10.986"
+            height="10.986"
+            x="19.166"
+            y="2.14"
+            color-interpolation-filters="sRGB"
+            filterUnits="userSpaceOnUse"
+          >
+            <feFlood flood-opacity="0" result="BackgroundImageFix" />
+            <feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape" />
+            <feGaussianBlur result="effect1_foregroundBlur_18_24902" stdDeviation=".375" />
+          </filter>
+        </defs>
+      </g>
+    </svg>
+  `;
+  append(
+    'body',
+    html` <style>
+        body {
+          font-family: arial;
+          font-size: 20px;
+          background-color: #d8d8d8;
+          color: #333;
+        }
+        a {
+          color: black;
+        }
+      </style>
+
+      <div class="abs center" style="top: 45%">
+        ${icon}
+        <br />
+        <br />
+        <span class="bold">Test Page</span>
+        <br />
+        <br />
+        <a 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>`;

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

@@ -0,0 +1,14 @@
+import { htmls, loggerFactory } from '../common/SsrCore.js';
+import { Alert } from '../common/Alert.js';
+import { Translate } from '../common/Translate.js';
+import { Worker } from '../common/Worker.js';
+/*imports*/
+
+const logger = loggerFactory({ url: location.toString() });
+
+window.onload = () =>
+  Worker.instance({
+    render: async () => {
+      htmls(`.page-render`, html`${await Alert.maintenance({ Translate })}`);
+    },
+  });

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

@@ -0,0 +1,21 @@
+import { htmls, loggerFactory } from '../common/SsrCore.js';
+import { Alert } from '../common/Alert.js';
+import { Translate } from '../common/Translate.js';
+import { Worker } from '../common/Worker.js';
+/*imports*/
+
+const logger = loggerFactory({ url: location.toString() });
+
+window.onload = () =>
+  Worker.instance({
+    render: async () => {
+      window.ononline = async () => {
+        location.href = location.pathname.split('/')[1] ? `/${location.pathname.split('/')[1].split('.')[0]}` : '/';
+      };
+      window.onoffline = async () => {
+        htmls(`.page-render`, html`${await Alert.noInternet({ Translate })}`);
+      };
+      if (navigator.onLine && !location.hostname.match('localhost')) window.ononline();
+      else window.onoffline();
+    },
+  });

package/src/client/sw/default.sw.js

@@ -0,0 +1,108 @@
+const PRE_CACHED_RESOURCES = self.renderPayload?.PRE_CACHED_RESOURCES ? self.renderPayload.PRE_CACHED_RESOURCES : [];
+const CACHE_NAME = self.renderPayload?.CACHE_NAME ? self.renderPayload.CACHE_NAME : 'app-cache';
+const PROXY_PATH = self.renderPayload?.PROXY_PATH ? self.renderPayload.PROXY_PATH : '/';
+self.addEventListener('install', (event) => {
+  // Activate right away
+  self.skipWaiting();
+
+  event.waitUntil(
+    (async () => {
+      // Open the app's cache.
+      const cache = await caches.open(CACHE_NAME);
+      // Cache all static resources.
+      try {
+        await cache.addAll(PRE_CACHED_RESOURCES);
+      } catch (error) {
+        console.error(error);
+      }
+      // for (const cacheKey of PRE_CACHED_RESOURCES) {
+      //   try {
+      //     await cache.add(cacheKey);
+      //   } catch (error) {
+      //     console.error(error, cacheKey);
+      //   }
+      // }
+    })(),
+  );
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    (async () => {
+      // Enable navigation preload if it's supported.
+      // See https://developers.google.com/web/updates/2017/02/navigation-preload
+      if ('navigationPreload' in self.registration) {
+        await self.registration.navigationPreload.enable();
+      }
+    })(),
+  );
+  // Tell the active service worker to take control of the page immediately.
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  // Cache-First Strategy
+  event.respondWith(
+    (async () => {
+      // First, try to use the navigation preload response if it's supported.
+      try {
+        const preloadResponse = await event.preloadResponse;
+        if (preloadResponse) return preloadResponse;
+        return await fetch(event.request);
+      } catch (error) {
+        console.error('Fetch failed; returning offline page instead.', event.request.url, error);
+        // Fallback to the offline page.
+        const path = PRE_CACHED_RESOURCES.find((path) => event.request.url.match(path.replaceAll('/index.html', '')));
+
+        try {
+          const cachedResponse = await caches.match(event.request);
+          if (cachedResponse) return cachedResponse;
+          const cache = await caches.open(CACHE_NAME);
+          const preCachedResponse = await cache.match(path);
+          if (!preCachedResponse) throw new Error(error.message);
+          return preCachedResponse;
+        } catch (error) {
+          console.error('Error opening cache for pre cached page', {
+            url: event.request.url,
+            error,
+            onLine: navigator.onLine,
+          });
+          try {
+            if (!navigator.onLine) {
+              if (event.request.method.toUpperCase() === 'GET') {
+                const cache = await caches.open(CACHE_NAME);
+                const preCachedResponse = await cache.match(
+                  `${PROXY_PATH === '/' ? '' : PROXY_PATH}/offline/index.html`,
+                );
+                if (!preCachedResponse) throw new Error(error.message);
+                return preCachedResponse;
+              }
+              const response = new Response(JSON.stringify({ status: 'error', message: 'offline test response' }));
+              // response.status = 200;
+              response.headers.set('Content-Type', 'application/json');
+              return response;
+            }
+            if (event.request.method.toUpperCase() === 'GET') {
+              const cache = await caches.open(CACHE_NAME);
+              const preCachedResponse = await cache.match(
+                `${PROXY_PATH === '/' ? '' : PROXY_PATH}/maintenance/index.html`,
+              );
+              if (!preCachedResponse) throw new Error(error.message);
+              return preCachedResponse;
+            }
+            const response = new Response(JSON.stringify({ status: 'error', message: 'server in maintenance' }));
+            // response.status = 200;
+            response.headers.set('Content-Type', 'application/json');
+            return response;
+          } catch (error) {
+            console.error('Error opening cache for offline page', event.request.url, error);
+            const response = new Response(JSON.stringify({ status: 'error', message: error.message }));
+            // response.status = 200;
+            response.headers.set('Content-Type', 'application/json');
+            return response;
+          }
+        }
+      }
+    })(),
+  );
+});

package/src/client/sw/template.sw.js

@@ -0,0 +1,84 @@
+// https://googlechrome.github.io/samples/service-worker/custom-offline-page/
+
+/*
+Copyright 2015, 2019 Google Inc. All Rights Reserved.
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+ http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+*/
+
+// Incrementing OFFLINE_VERSION will kick off the install event and force
+// previously cached resources to be updated from the network.
+const OFFLINE_VERSION = 1;
+const CACHE_NAME = 'offline';
+// Customize this with a different URL if needed.
+const OFFLINE_URL = 'offline.html';
+
+self.addEventListener('install', (event) => {
+  event.waitUntil(
+    (async () => {
+      const cache = await caches.open(CACHE_NAME);
+      // Setting {cache: 'reload'} in the new request will ensure that the response
+      // isn't fulfilled from the HTTP cache; i.e., it will be from the network.
+      await cache.add(new Request(OFFLINE_URL, { cache: 'reload' }));
+    })(),
+  );
+});
+
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    (async () => {
+      // Enable navigation preload if it's supported.
+      // See https://developers.google.com/web/updates/2017/02/navigation-preload
+      if ('navigationPreload' in self.registration) {
+        await self.registration.navigationPreload.enable();
+      }
+    })(),
+  );
+
+  // Tell the active service worker to take control of the page immediately.
+  self.clients.claim();
+});
+
+self.addEventListener('fetch', (event) => {
+  // We only want to call event.respondWith() if this is a navigation request
+  // for an HTML page.
+  if (event.request.mode === 'navigate') {
+    event.respondWith(
+      (async () => {
+        try {
+          // First, try to use the navigation preload response if it's supported.
+          const preloadResponse = await event.preloadResponse;
+          if (preloadResponse) {
+            return preloadResponse;
+          }
+
+          const networkResponse = await fetch(event.request);
+          return networkResponse;
+        } catch (error) {
+          // catch is only triggered if an exception is thrown, which is likely
+          // due to a network error.
+          // If fetch() returns a valid HTTP response with a response code in
+          // the 4xx or 5xx range, the catch() will NOT be called.
+          console.log('Fetch failed; returning offline page instead.', error);
+
+          const cache = await caches.open(CACHE_NAME);
+          const cachedResponse = await cache.match(OFFLINE_URL);
+          return cachedResponse;
+        }
+      })(),
+    );
+  }
+
+  // If our if() condition is false, then this fetch handler won't intercept the
+  // request. If there are any other fetch handlers registered, they will get a
+  // chance to call event.respondWith(). If no fetch handlers call
+  // event.respondWith(), the request will be handled by the browser as if there
+  // were no service worker involvement.
+});

package/src/client.build.js

@@ -0,0 +1,22 @@
+'use strict';
+
+// 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);
+
+await logger.setUpInfo();
+
+await clientLiveBuild();
+
+// ProcessController.init(logger);

package/src/client.dev.js

@@ -0,0 +1,24 @@
+'use strict';
+
+// 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();
+
+await buildClientStaticConf();
+
+await Config.build();
+
+await createClientDevServer();
+
+ProcessController.init(logger);

package/src/db/DataBaseProvider.js

@@ -0,0 +1,98 @@
+import { MongooseDB } from './mongo/MongooseDB.js';
+import { loggerFactory } from '../server/logger.js';
+
+/**
+ * Module for managing and loading various database connections (e.g., Mongoose, MariaDB).
+ * @module src/db/DataBaseProvider.js
+ * @namespace DataBaseProviderNamespace
+ */
+
+const logger = loggerFactory(import.meta);
+
+/**
+ * @class
+ * @alias DataBaseProviderService
+ * @memberof DataBaseProviderNamespace
+ * @classdesc Centralized service for loading, managing, and accessing multiple database connections
+ * based on application configuration (host, path, provider type).
+ */
+class DataBaseProviderService {
+  /**
+   * Internal storage for database connection instances, keyed by host+path.
+   * @type {object.<string, object>}
+   * @private
+   */
+  #instance = {};
+
+  /**
+   * Retrieves the internal instance storage for direct access (used for backward compatibility).
+   * @returns {object.<string, object>} The internal connection instance map.
+   */
+  get instance() {
+    return this.#instance;
+  }
+
+  /**
+   * Loads and initializes a database provider based on the configuration.
+   * If the connection is already loaded for the given host/path, it returns the existing instance.
+   *
+   * @async
+   * @param {object} [options] - Configuration for the database connection.
+   * @param {Array<string>} [options.apis=[]] - List of APIs whose models should be loaded (for Mongoose).
+   * @param {string} [options.host=''] - The host part of the application context (e.g., domain).
+   * @param {string} [options.path=''] - The path part of the application context.
+   * @param {object} [options.db={}] - The specific database configuration object.
+   * @param {string} options.db.provider - The name of the database provider ('mongoose', 'mariadb', etc.).
+   * @param {string} options.db.host - The database server host.
+   * @param {string} options.db.name - The database name.
+   * @returns {Promise<object|undefined>} A promise that resolves to the initialized provider object
+   * or `undefined` on error or if the provider is already loaded.
+   */
+  async load(options = { apis: [], host: '', path: '', db: {} }) {
+    try {
+      const { apis, host, path, db } = options;
+      const key = `${host}${path}`;
+
+      if (!this.#instance[key]) this.#instance[key] = {};
+
+      if (!db || this.#instance[key][db.provider]) return this.#instance[key][db.provider];
+
+      // logger.info(`Load ${db.provider} provider`, key);
+      switch (db.provider) {
+        case 'mongoose':
+          {
+            const conn = await MongooseDB.connect(db.host, db.name);
+            this.#instance[key][db.provider] = {
+              models: await MongooseDB.loadModels({ conn, apis }),
+              connection: conn,
+              close: async () => {
+                return await new Promise((resolve) => {
+                  this.#instance[key][db.provider].connection.close().then(() => {
+                    // logger.info('Mongoose connection is disconnected', db);
+                    return resolve();
+                  });
+                });
+              },
+            };
+          }
+          break;
+        default:
+          break;
+      }
+      return this.#instance[key][db.provider];
+    } catch (error) {
+      logger.error(error, { error: error.stack, options });
+      return undefined;
+    }
+  }
+}
+
+/**
+ * Singleton instance of the DataBaseProviderService class for backward compatibility.
+ * @alias DataBaseProvider
+ * @memberof DataBaseProviderNamespace
+ * @type {DataBaseProviderService}
+ */
+const DataBaseProvider = new DataBaseProviderService();
+
+export { DataBaseProvider, DataBaseProviderService as DataBaseProviderClass };

package/src/db/mariadb/MariaDB.js

@@ -0,0 +1,66 @@
+import mariadb from 'mariadb';
+
+import { loggerFactory } from '../../server/logger.js';
+
+/**
+ * Module for interacting with MariaDB/MySQL databases using the mariadb connector.
+ * @module src/db/MariaDB.js
+ * @namespace MariaDBNamespace
+ */
+
+const logger = loggerFactory(import.meta);
+
+/**
+ * @class
+ * @alias MariaDBService
+ * @memberof MariaDBNamespace
+ * @classdesc Provides a simplified interface for executing queries against a MariaDB/MySQL database
+ * using a connection pool, ensuring connection management (acquisition and release).
+ */
+class MariaDBService {
+  /**
+   * Executes a SQL query against the MariaDB database.
+   *
+   * @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.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 = mariadb.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 : '',
+    });
+    let conn, result;
+    try {
+      conn = await pool.getConnection();
+      result = await conn.query(query, { supportBigNumbers: true, bigNumberStrings: true });
+      logger.info(query, result);
+    } catch (error) {
+      if (error.stack.startsWith('TypeError: Do not know how to serialize a BigInt')) return;
+      logger.error(error, error.stack);
+    } finally {
+      if (conn) conn.release(); // release to pool
+      await pool.end();
+    }
+
+    return result;
+  }
+}
+
+/**
+ * Singleton instance of the MariaDBService class for backward compatibility.
+ * @alias MariaDB
+ * @memberof MariaDBNamespace
+ * @type {MariaDBService}
+ */
+const MariaDB = new MariaDBService();
+
+export { MariaDB, MariaDBService as MariaDBClass };