underpost 2.6.3 → 2.7.1

package/AUTHORS.md

@@ -0,0 +1,10 @@
+# Authors
+
+#### Ordered by first contribution.
+
+- fcoverdugo ([fcoverdugoa@underpost.net](mailto:fcoverdugoa@underpost.net))
+- underpost.net ([52893447+underpostnet@users.noreply.github.com](mailto:52893447+underpostnet@users.noreply.github.com))
+- fcoverdugoa ([52893447+underpostnet@users.noreply.github.com](mailto:52893447+underpostnet@users.noreply.github.com))
+- underpostnet ([fcoverdugoa@underpost.net](mailto:fcoverdugoa@underpost.net))
+
+#### Generated by [underpost.net](https://underpost.net)

package/CHANGELOG.md

@@ -0,0 +1,91 @@
+### Changelog
+
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
+
+#### [v2.6.3](https://github.com/underpostnet/engine/compare/v2.6.2...v2.6.3)
+
+> 14 September 2024
+
+- update version 2.6.3 [`85c585d`](https://github.com/underpostnet/engine/commit/85c585d1cce30de4389772605cf56e774e2b7d3c)
+- update refactor docs and coverage [`b455016`](https://github.com/underpostnet/engine/commit/b455016f5f2b2bdc142aacb4dfd66ab890125662)
+- update [`b8f01f2`](https://github.com/underpostnet/engine/commit/b8f01f258999c9ebc1173b0616f0f7b8f7171048)
+
+#### [v2.6.2](https://github.com/underpostnet/engine/compare/v2.5.6...v2.6.2)
+
+> 13 September 2024
+
+- update version 2.6.2 [`0895afb`](https://github.com/underpostnet/engine/commit/0895afbde42dd5a573507ccfcb07c328648b4eb0)
+- update [`344d303`](https://github.com/underpostnet/engine/commit/344d303702ebce22dff50d8c0f8d8d870a2860ee)
+
+#### [v2.5.6](https://github.com/underpostnet/engine/compare/v2.5.2...v2.5.6)
+
+> 13 September 2024
+
+- update version 2.5.6 [`ca57b87`](https://github.com/underpostnet/engine/commit/ca57b87c56a544e7b7e53baa5a6e15415e16b99b)
+- update [`eec4943`](https://github.com/underpostnet/engine/commit/eec49433f50b4dfa7b7bbff48891a60f5be25545)
+- update [`5f0a6ac`](https://github.com/underpostnet/engine/commit/5f0a6aca1ae971bc42f654cf3f2bf7ace7fe613d)
+
+#### [v2.5.2](https://github.com/underpostnet/engine/compare/v2.5.1...v2.5.2)
+
+> 12 September 2024
+
+- update dependebot security [`1289b96`](https://github.com/underpostnet/engine/commit/1289b9627dc59bf08e66edbef1bf7bf08e53984c)
+- update [`ec11af8`](https://github.com/underpostnet/engine/commit/ec11af86e884ca3eeaeaa12695edddaa8b46492d)
+- remove toast-ui [`40c207f`](https://github.com/underpostnet/engine/commit/40c207f13f3e6d7ab71fc4cc203ce6ff02101bb5)
+
+#### [v2.5.1](https://github.com/underpostnet/engine/compare/v2.5.0...v2.5.1)
+
+> 27 August 2024
+
+- refactor ssr [`4fa5d24`](https://github.com/underpostnet/engine/commit/4fa5d24531f791fa860a4ba38b9784491f084a68)
+- bucket to document [`747cb0b`](https://github.com/underpostnet/engine/commit/747cb0bf5198e4b97df186e642413fa49ed9383f)
+- add user control table managements [`2cfb710`](https://github.com/underpostnet/engine/commit/2cfb7103a591b941897ff3834ad5874565cba6b4)
+
+#### [v2.5.0](https://github.com/underpostnet/engine/compare/v2.0.0...v2.5.0)
+
+> 23 August 2024
+
+- css refactor [`49b1904`](https://github.com/underpostnet/engine/commit/49b1904e83162f9066fbf843ced37d4e87db5581)
+- refactor [`dad4f95`](https://github.com/underpostnet/engine/commit/dad4f9567629b737254702ce8be6b243e68fb01e)
+- add sitemap builder [`53d05a6`](https://github.com/underpostnet/engine/commit/53d05a62d03ea327df3d37181a4b5c272d417289)
+
+### [v2.0.0](https://github.com/underpostnet/engine/compare/v1.0.4...v2.0.0)
+
+> 30 March 2024
+
+- seed-city assets [`6d9decb`](https://github.com/underpostnet/engine/commit/6d9decbae96b828aa001777f96dd75aab3fc71d1)
+- update [`1069fc5`](https://github.com/underpostnet/engine/commit/1069fc5268aa5ef7c101695393de59edfc14daf8)
+- update [`41ae7d4`](https://github.com/underpostnet/engine/commit/41ae7d4c969cce0608171c820e05ebab42610a7f)
+
+#### [v1.0.4](https://github.com/underpostnet/engine/compare/v1.0.3...v1.0.4)
+
+> 14 January 2023
+
+- update [`8109700`](https://github.com/underpostnet/engine/commit/81097008baa95ac50efb760b228dc4abae63c379)
+- update [`b6bb47f`](https://github.com/underpostnet/engine/commit/b6bb47f95bd56c0062066ecae5f03813cf1ed6f8)
+- update [`15c0ca9`](https://github.com/underpostnet/engine/commit/15c0ca9f9a8203bec53a9677d5a8edcd04a7f1df)
+
+#### [v1.0.3](https://github.com/underpostnet/engine/compare/v1.0.2...v1.0.3)
+
+> 21 December 2022
+
+- update [`69418ba`](https://github.com/underpostnet/engine/commit/69418ba34831983e07aa458d1ea4a742c7b66096)
+- update [`003412f`](https://github.com/underpostnet/engine/commit/003412fadf3efe6b819f037e99855192f13ccd7e)
+
+#### [v1.0.2](https://github.com/underpostnet/engine/compare/v1.0.1...v1.0.2)
+
+> 21 December 2022
+
+- update [`470f07a`](https://github.com/underpostnet/engine/commit/470f07a72398792ac9ecf07bf1ba5170bc427dc5)
+- update [`dacc20a`](https://github.com/underpostnet/engine/commit/dacc20a14971388bcf2a5077286989a77197aadc)
+- update [`d2efee0`](https://github.com/underpostnet/engine/commit/d2efee08f9b31dd9fca31a3b1b15bdaa0e75faea)
+
+#### v1.0.1
+
+> 11 October 2022
+
+- update [`bd40237`](https://github.com/underpostnet/engine/commit/bd402372513151a15a972a7727f7d77d014739f1)
+- update [`39dd3b9`](https://github.com/underpostnet/engine/commit/39dd3b9a5a6b4292b899840dd5cd333cc80410d1)
+- First Commit [`ad7b2a3`](https://github.com/underpostnet/engine/commit/ad7b2a3be0746b34fa19ba896d3faa7f1b4f40dc)

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://underpost.net/assets/splash/apple-touch-icon-precomposed.png" alt="underpost engine core server"/>
+  <img src="https://underpost.net/assets/splash/apple-touch-icon-precomposed.png" alt="underpost.net"/>
 </p>
 
 <div align="center">
@@ -22,7 +22,7 @@ template
 
 <div align="center">
 
-[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.yml) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master)
+[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Coverage Status](https://coveralls.io/repos/github/underpostnet/engine/badge.svg?branch=master)](https://coveralls.io/github/underpostnet/engine?branch=master) [![Version](https://img.shields.io/npm/v/underpost.svg)](https://www.npmjs.org/package/underpost) [![License](https://img.shields.io/npm/l/underpost.svg)](https://www.npmjs.com/package/underpost)
 
 </div>
 
@@ -45,7 +45,7 @@ npm install -g underpost
 ```
 
 ```bash
-underpost new my-project-name
+underpost new app-name
 ```
 
 After template installation, the server will be running on [http://localhost:4001](http://localhost:4001)
@@ -53,7 +53,7 @@ After template installation, the server will be running on [http://localhost:400
 #### Usage
 
 ```bash
-cd my-project-name
+cd app-name
 ```
 
 Build client bundle
@@ -90,7 +90,7 @@ Run on `docker`
 
 ```bash
 # build image
-docker build . -t engine
+docker build . -t app-name
 # run image
-docker run --name engine-instance -p 41061:3001 -p 41062:3002 engine
+docker run --name app-name-instance -p 41061:3001 -p 41062:3002 app-name
 ```

package/bin/deploy.js

@@ -23,8 +23,9 @@ import {
   getDataDeploy,
 } from '../src/server/conf.js';
 import { buildClient } from '../src/server/client-build.js';
-import { range, setPad, timer } from '../src/client/components/core/CommonJs.js';
+import { range, setPad, timer, uniqueArray } from '../src/client/components/core/CommonJs.js';
 import toJsonSchema from 'to-json-schema';
+import simpleGit from 'simple-git';
 
 const logger = loggerFactory(import.meta);
 
@@ -337,7 +338,7 @@ try {
             if (argHost && argPath && (!argHost.includes(host) || !argPath.includes(path))) {
               delete serverConf[host][path];
             } else {
-              serverConf[host][path].lightBuild = process.argv.includes('l') ? true : false;
+              serverConf[host][path].liteBuild = process.argv.includes('l') ? true : false;
               serverConf[host][path].minifyBuild = process.env.NODE_ENV === 'production' ? true : false;
             }
           }
@@ -449,6 +450,8 @@ try {
       break;
 
     case 'fix-uml': {
+      // required: java jdk-11.0.1
+
       // comment:
       // '--add-opens=java.xml/com.sun.org.apache.xalan.internal.xsltc.trax="ALL-UNNAMED"'
       // in plantuml.js src
@@ -616,8 +619,40 @@ try {
             .replaceAll(`v${version}`, `v${newVersion}`),
           'utf8',
         );
+
+        fs.writeFileSync(
+          `./bin/index.js`,
+          fs.readFileSync(`./bin/index.js`, 'utf8').replaceAll(`${version}`, `${newVersion}`),
+          'utf8',
+        );
       }
       break;
+
+    case 'update-authors': {
+      // shellExec(`git log --reverse --format='%aN (<%aE>)' | sort -u`, { stdout: true });
+      const logs = await simpleGit().log();
+
+      fs.writeFileSync(
+        './AUTHORS.md',
+        `# Authors
+
+#### Ordered by first contribution.
+
+${uniqueArray(logs.all.map((log) => `- ${log.author_name} ([${log.author_email}](mailto:${log.author_email}))`)).join(`
+`)}
+
+#### Generated by [underpost.net](https://underpost.net)`,
+        'utf8',
+      );
+
+      // hash: '1c7418ad2f49c7798a6d28d370b34c69d31dce46',
+      // date: '2024-09-16T17:10:13-03:00',
+      // message: 'update',
+      // refs: '',
+      // body: '',
+      // author_name: 'fcoverdugo',
+      // author_email: 'fcoverdugoa@underpost.net'
+    }
     default:
       break;
   }

package/bin/index.js

@@ -1,34 +1,53 @@
 #! /usr/bin/env node
 
-import { loggerFactory } from '../src/server/logger.js';
 import dotenv from 'dotenv';
 import { shellCd, shellExec } from '../src/server/process.js';
 import fs from 'fs-extra';
+import { Command } from 'commander';
 
 dotenv.config();
 
-const logger = loggerFactory(import.meta);
-
-await logger.setUpInfo();
-
-const globalBinFolder = `${shellExec(`npm root -g`, { stdout: true, silent: true }).trim()}/underpost`;
-
-switch (process.argv[2]) {
-  case 'new':
-    {
-      const projectName = process.argv[3] || 'my-project';
-      const destFolder = `${process.cwd()}/${projectName}`;
-      fs.mkdirSync(destFolder, { recursive: true });
-      fs.copySync(globalBinFolder, destFolder);
-      shellCd(`${destFolder}`);
-      shellExec(`npm run install-template`);
-      shellExec(`npm run dev`);
-    }
-    break;
-  case 'test': {
-    shellCd(globalBinFolder);
-    shellExec(`npm test`);
-  }
-  default:
-    break;
-}
+const globalBinFolder = `${shellExec(`npm root -g`, {
+  stdout: true,
+  silent: true,
+  disableLog: true,
+}).trim()}/underpost`;
+
+const program = new Command();
+
+const version = '2.7.1';
+
+program.name('underpost').description(`underpost.net ci/cd cli ${version}`).version(version);
+
+program
+  .command('new <app-name>')
+  .description('Create a new project')
+  .action((appName) => {
+    const destFolder = `${process.cwd()}/${appName}`;
+    console.log('Note: This process may take several minutes to complete');
+    console.log('build app', { destFolder });
+    fs.mkdirSync(destFolder, { recursive: true });
+    fs.copySync(globalBinFolder, destFolder);
+    fs.writeFileSync(`${destFolder}/.gitignore`, fs.readFileSync(`${globalBinFolder}/.dockerignore`, 'utf8'), 'utf8');
+    shellCd(`${destFolder}`);
+    shellExec(`git init && git add . && git commit -m "Base template implementation"`);
+    shellExec(`npm run install-template`);
+    shellExec(`npm run dev`);
+  });
+
+program
+  .command('test')
+  .description('Run tests')
+  .action(() => {
+    shellCd(`${globalBinFolder}`);
+    shellExec(`npm run test`);
+  });
+
+program
+  .command('help')
+  .description('Display help information')
+  .action(() => {
+    program.outputHelp();
+  });
+
+program.parse();

package/bin/ssl.js

@@ -29,6 +29,9 @@ try {
       cmd = `certbot certonly --webroot --webroot-path ${
         directory ? directory : `${getRootDirectory()}/public/${host}`
       } -d ${host}`;
+      // directory ? directory : `${getRootDirectory()}/public/${host}`
+      // directory ? directory : `${getRootDirectory()}/public/www.${host.split('.').slice(-2).join('.')}`
+
       // You can get multi domain cert by specifying (extra) -d
       // For example
       // certbot -d example.com -d example.net -d www.example.org

package/conf.js

@@ -179,7 +179,7 @@ const DefaultConf = {
         origins: [],
         minifyBuild: false,
         iconsBuild: true,
-        lightBuild: false,
+        liteBuild: false,
         docsBuild: false,
         ws: 'core',
         peer: true,
@@ -217,7 +217,7 @@ const DefaultConf = {
         apis: [],
         origins: [],
         minifyBuild: false,
-        lightBuild: true,
+        liteBuild: true,
         proxy: [80, 443],
       },
     },

package/docker-compose.yml

@@ -58,7 +58,7 @@ services:
           cpus: '0.25'
           memory: 20M
     labels: # labels in Compose file instead of Dockerfile
-      engine.version: '2.6.3'
+      engine.version: '2.7.1'
     networks:
       - load-balancer
 

package/package.json

@@ -1,8 +1,8 @@
 {
     "type": "module",
-    "main": "src/server.js",
+    "main": "src/index.js",
     "name": "underpost",
-    "version": "2.6.3",
+    "version": "2.7.1",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",
@@ -15,7 +15,7 @@
         "docs": "jsdoc -c jsdoc.json",
         "backup": "node bin/db default.net/ export",
         "install-template": "npm install && npm run build",
-        "install-global": "npm install -g pm2 && npm install -g jsdoc && npm install -g prettier && npm install -g env-cmd",
+        "install-global": "npm install -g pm2 && npm install -g jsdoc && npm install -g prettier && npm install -g env-cmd && npm install -g yarn && npm install -g auto-changelog",
         "install-test": "npm install -g mocha && npm install -g c8 && npm install -g nyc && npm install -g coveralls",
         "install-vs-extensions": "node bin/vs import",
         "preinstall": "npm config set audit false && npm config set loglevel error",
@@ -58,13 +58,16 @@
         "@loadingio/css-spinner": "^2.0.2",
         "@neodrag/vanilla": "^2.0.3",
         "@pinata/sdk": "^2.1.0",
+        "@xenova/transformers": "^2.17.2",
         "adm-zip": "^0.5.10",
         "ag-grid-community": "31.0.0",
         "axios": "^1.5.1",
+        "chai": "^5.1.0",
         "cli-progress": "^3.12.0",
         "cli-spinners": "^3.0.0",
         "color": "^4.2.3",
         "colors": "^1.4.0",
+        "commander": "^12.1.0",
         "compression": "^1.7.4",
         "copy-paste": "^1.5.3",
         "cors": "^2.8.5",
@@ -96,6 +99,7 @@
         "marked": "^12.0.1",
         "mongoose": "^8.0.1",
         "morgan": "^1.10.0",
+        "node-cron": "^3.0.3",
         "nodemailer": "^6.9.9",
         "nodemon": "^3.0.1",
         "pathfinding": "^0.4.18",
@@ -107,6 +111,7 @@
         "read": "^2.1.0",
         "sharp": "^0.32.5",
         "shelljs": "^0.8.5",
+        "simple-git": "^3.26.0",
         "simple-icons": "^13.9.0",
         "sitemap": "^7.1.1",
         "socket.io": "^4.7.2",
@@ -116,8 +121,7 @@
         "text-to-image": "^5.2.0",
         "uglify-js": "^3.17.4",
         "validator": "^13.11.0",
-        "winston": "^3.11.0",
-        "chai": "^5.1.0"
+        "winston": "^3.11.0"
     },
     "devDependencies": {
         "clean-jsdoc-theme": "^4.3.0",

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

@@ -33,10 +33,10 @@ const range = (start, end) => {
  * @param arr - The `arr` parameter in the `getId` function is an array of objects or an object. If it
  * is an object, the function converts it into an array of objects where each object has a key
  * specified by the `keyId` parameter.
- * @param [suffix] - The `suffix` parameter in the `getId` function is a string that can be added to
+ * @param suffix - The `suffix` parameter in the `getId` function is a string that can be added to
  * the generated ID. It is optional and by default is an empty string. You can provide a suffix to be
  * appended to the generated ID if needed.
- * @param [keyId=id] - The `keyId` parameter in the `getId` function is used to specify the key in the
+ * @param keyId - The `keyId` parameter in the `getId` function is used to specify the key in the
  * array elements that contains the unique identifier (ID) for each element. By default, the function
  * assumes that the ID is stored in a property named `'id'`, but you can customize this by providing
  * @returns The `getId` function returns a unique identifier `_id` based on the input array `arr`,

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

@@ -62,7 +62,7 @@ const Docs = {
       icon: html`<i class="fa-brands fa-osi"></i>`,
       text: 'Source Docs',
       url: function () {
-        return `${getProxyPath()}docs/engine/2.6.3`;
+        return `${getProxyPath()}docs/engine/2.7.1`;
       },
     },
     {

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

@@ -136,14 +136,14 @@ const pasteData = () => new Promise((resolve) => navigator.clipboard.readText().
 
 /**
  * The setPath function in JavaScript updates the browser's history with a new path, state, and title.
- * @param [path=/] - The `path` parameter is a string that represents the URL path where you want to
+ * @param path - The `path` parameter is a string that represents the URL path where you want to
  * navigate or update in the browser history. It is the first parameter in the `setPath` function and
  * has a default value of `'/'`.
- * @param [stateStorage] - The `stateStorage` parameter in the `setPath` function is an object that
+ * @param stateStorage - The `stateStorage` parameter in the `setPath` function is an object that
  * represents the state object associated with the new history entry. It is used to store data related
  * to the state of the application when navigating to a new path using `history.pushState()`. This data
  * can be accessed later
- * @param [title] - The `title` parameter in the `setPath` function is a string that represents the
+ * @param title - The `title` parameter in the `setPath` function is a string that represents the
  * title of the new history entry. It is used as the title of the new history entry in the browser's
  * history.
  * @memberof VanillaJS
@@ -312,7 +312,7 @@ function downloadFile(fileInstance, fileName) {
 
 /**
  * The function `getRawContentFile` reads the raw content of a file using a FileReader in JavaScript.
- * @param [blob] - The `blob` parameter in the `getRawContentFile` function is a Buffer object that
+ * @param blob - The `blob` parameter in the `getRawContentFile` function is a Buffer object that
  * represents raw binary data. It is used to read the content of a file as text using a FileReader in
  * the browser environment.
  * @memberof VanillaJS
@@ -329,9 +329,9 @@ const getRawContentFile = (blob = new Buffer()) =>
 /**
  * The function `getBlobFromUint8ArrayFile` creates a Blob object from a Uint8Array file data with a
  * specified mimetype.
- * @param [data] - The `data` parameter in the `getBlobFromUint8ArrayFile` function is an array of
+ * @param data - The `data` parameter in the `getBlobFromUint8ArrayFile` function is an array of
  * arrays containing Uint8Array data.
- * @param [mimetype=application/octet-stream] - The `mimetype` parameter in the
+ * @param mimetype - The `mimetype` parameter in the
  * `getBlobFromUint8ArrayFile` function is a string that specifies the type of the Blob object being
  * created. It indicates the MIME type of the data contained in the Blob. For example, common MIME
  * types include 'image/jpeg' for JPEG images,
@@ -409,7 +409,7 @@ const isActiveTab = () => document.hasFocus();
 /**
  * The function `isActiveElement` checks if the active element in the document matches a specified
  * class search.
- * @param [classSearch] - The `classSearch` parameter is a string that is used to search for a specific
+ * @param classSearch - The `classSearch` parameter is a string that is used to search for a specific
  * class name within the `classList` of the active element in the document.
  * @memberof VanillaJS
  */

package/src/client/ssr/body-components/CacheControl.js

@@ -108,6 +108,6 @@ SrrComponent = ({ ttiLoadTimeLimit }) => {
       const CacheControl = ${CacheControl};
       CacheControl({ ttiLoadTimeLimit: ${ttiLoadTimeLimit ? ttiLoadTimeLimit : 1000 * 70 * 1} });
     </script>
-    <div class="clean-cache-container">v2.6.3</div>
+    <div class="clean-cache-container">v2.7.1</div>
   `;
 };

package/src/index.js

@@ -0,0 +1,29 @@
+/**
+ * Underpost index npm package
+ * @module src/index.js
+ * @namespace Underpost
+ */
+
+import { loggerFactory, setUpInfo } from './server/logger.js';
+
+const logger = loggerFactory(import.meta);
+
+const underpost = {
+  /**
+   * Logs information about the current process environment to the console.
+   *
+   * This function is used to log details about
+   * the execution context, such as command-line arguments,
+   * environment variables, the process's administrative privileges,
+   * and the maximum available heap space size.
+   *
+   * @memberof Underpost
+   */
+  setUpInfo: async () => await setUpInfo(logger),
+};
+
+const up = underpost;
+
+export { underpost, up };
+
+export default underpost;

package/src/server/auth.js

@@ -67,7 +67,7 @@ const hashJWT = (payload, expire) =>
 /**
  * The function `verifyJWT` is used to verify a JSON Web Token (JWT) using a secret key stored in the
  * environment variables.
- * @param [token] - The `token` parameter is a JSON Web Token (JWT) that is passed to the `verifyJWT`
+ * @param token - The `token` parameter is a JSON Web Token (JWT) that is passed to the `verifyJWT`
  * function for verification.
  * @memberof Auth
  */

package/src/server/backup.js

@@ -2,15 +2,25 @@ import fs from 'fs-extra';
 import { loggerFactory } from './logger.js';
 import { shellExec } from './process.js';
 import { getDataDeploy } from './conf.js';
+import cron from 'node-cron';
 
 const logger = loggerFactory(import.meta);
 
 const BackUpManagement = {
   Init: async function () {
     await this.Callback();
-    setInterval(async () => {
-      await this.Callback();
-    }, 1000 * 60 * 60); // hourly interval
+
+    // Schedule the sending process to run every day at 1 am
+    cron.schedule(
+      '0 1 * * *',
+      async () => {
+        await this.Callback();
+      },
+      {
+        scheduled: true,
+        timezone: process.env.TIME_ZONE || 'America/New_York',
+      },
+    );
   },
   Callback: async function () {
     const privateCronConfPath = `./engine-private/conf/${process.argv[2]}/conf.cron.json`;
@@ -42,9 +52,9 @@ const BackUpManagement = {
         for (const host of Object.keys(confServer))
           for (const path of Object.keys(confServer[host])) {
             // retention policy
-            let { db, backupFrequency, maxBackupRetention } = confServer[host][path];
+            let { db, backupFrequency, maxBackupRetention, singleReplica } = confServer[host][path];
 
-            if (!db) continue;
+            if (!db || singleReplica) continue;
 
             if (!backupFrequency) backupFrequency = 'daily';
             if (!maxBackupRetention) maxBackupRetention = 5;

package/src/server/client-build.js

@@ -150,7 +150,7 @@ const buildClient = async (options = { liveClientBuildPaths: [], instances: [] }
       const rootClientPath = directory ? directory : `${publicPath}/${host}${path}`;
       const port = newInstance(currentPort);
       const publicClientId = publicRef ? publicRef : client;
-      const fullBuildEnabled = !process.argv.includes('l') && !confServer[host][path].lightBuild && !enableLiveRebuild;
+      const fullBuildEnabled = !process.argv.includes('l') && !confServer[host][path].liteBuild && !enableLiveRebuild;
       // const baseHost = process.env.NODE_ENV === 'production' ? `https://${host}` : `http://localhost:${port}`;
       const baseHost = process.env.NODE_ENV === 'production' ? `https://${host}` : ``;
       // ''; // process.env.NODE_ENV === 'production' ? `https://${host}` : ``;
@@ -171,7 +171,7 @@ const buildClient = async (options = { liveClientBuildPaths: [], instances: [] }
       }
 
       if (fullBuildEnabled)
-        //  !(confServer[host]['/'] && confServer[host]['/'].lightBuild)
+        //  !(confServer[host]['/'] && confServer[host]['/'].liteBuild)
         await fullBuild({
           path,
           logger,
@@ -540,7 +540,7 @@ Sitemap: https://${host}${path === '/' ? '' : path}/sitemap.xml`,
         );
       }
 
-      if (!enableLiveRebuild && !process.argv.includes('l') && docsBuild) {
+      if (!enableLiveRebuild && !process.argv.includes('l') && !process.argv.includes('deploy') && docsBuild) {
         // fullBuildEnabled || process.argv.includes('docs')
 
         // https://www.pullrequest.com/blog/leveraging-jsdoc-for-better-code-documentation-in-javascript/

package/src/server/dns.js

@@ -1,6 +1,7 @@
 import axios from 'axios';
 import dotenv from 'dotenv';
 import fs from 'fs';
+import cron from 'node-cron';
 
 import { ip } from './network.js';
 import { loggerFactory } from './logger.js';
@@ -58,7 +59,17 @@ const Dns = {
       }
     };
     await callback();
-    this.ipDaemon = setInterval(async () => await callback(), confCronData.ipDaemon.minutesTimeInterval * 1000 * 60);
+    // every minute
+    cron.schedule(
+      '* * * * *',
+      async () => {
+        await callback();
+      },
+      {
+        scheduled: true,
+        timezone: process.env.TIME_ZONE || 'America/New_York',
+      },
+    );
   },
   services: {
     updateIp: {

package/src/server/logger.js

@@ -1,3 +1,9 @@
+/**
+ * Module for managing logger control and configuration
+ * @module src/server/logger.js
+ * @namespace Logger
+ */
+
 'use strict';
 
 import dotenv from 'dotenv';
@@ -68,7 +74,38 @@ const format = (meta) =>
     }),
   );
 
-const loggerFactory = (meta) => {
+/**
+ * Logs information about the current process environment to the console.
+ *
+ * This function is used to log details about
+ * the execution context, such as command-line arguments,
+ * environment variables, the process's administrative privileges,
+ * and the maximum available heap space size.
+ *
+ * @param {winston.Logger} logger - A pre-configured Winston logger object.
+ * @memberof Logger
+ */
+const setUpInfo = async (logger = new winston.Logger()) => {
+  logger.info('argv', process.argv);
+  logger.info('env', process.env.NODE_ENV);
+  logger.info('admin', await isAdmin());
+  logger.info('--max-old-space-size', {
+    total_available_size: formatBytes(v8.getHeapStatistics().total_available_size),
+  });
+};
+
+/**
+ * The function `loggerFactory` creates a logger instance with specified transports for printing out
+ * messages.
+ * @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.
+ * @returns {winston.Logger} 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: '' }) => {
   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
@@ -98,17 +135,25 @@ const loggerFactory = (meta) => {
     // exitOnError: false,
   });
   logger.setUpInfo = async () => {
-    logger.info('argv', process.argv);
-    logger.info('env', process.env.NODE_ENV);
-    logger.info('admin', await isAdmin());
-    logger.info('--max-old-space-size', {
-      total_available_size: formatBytes(v8.getHeapStatistics().total_available_size),
-    });
+    await setUpInfo(logger);
   };
   return logger;
 };
 
-const loggerMiddleware = (meta) => {
+/**
+ * The `loggerMiddleware` function creates a middleware for logging HTTP requests using Morgan with
+ * custom message format and options.
+ * @param meta - The `meta` parameter in the `loggerMiddleware` function is an object that contains
+ * information about the request URL. It has a default value of an empty object `{ url: '' }`. This
+ * object is used to provide additional metadata for logging purposes.
+ * @returns {Handler<any, any>} The `loggerMiddleware` function returns a middleware function that uses the Morgan library
+ * to log HTTP request information. The middleware function formats the log message using predefined
+ * tokens provided by Morgan and custom tokens like `:host` to include specific request details. The
+ * log message format includes information such as remote address, HTTP method, host, URL, status code,
+ * content length, and response time in milliseconds. The middleware
+ * @memberof Logger
+ */
+const loggerMiddleware = (meta = { url: '' }) => {
   const stream = {
     // Use the http severity
     write: (message) => loggerFactory(meta).http(message),
@@ -132,4 +177,4 @@ const loggerMiddleware = (meta) => {
   );
 };
 
-export { loggerFactory, loggerMiddleware };
+export { loggerFactory, loggerMiddleware, setUpInfo };

package/src/server/process.js

@@ -53,13 +53,13 @@ const ProcessController = {
   },
 };
 
-const shellExec = (cmd, options = { silent: false, async: false, stdout: false }) => {
-  logger.info(`cmd`, cmd);
+const shellExec = (cmd, options = { silent: false, async: false, stdout: false, disableLog: true }) => {
+  if (!options.disableLog) logger.info(`cmd`, cmd);
   return options.stdout ? shell.exec(cmd, options).stdout : shell.exec(cmd, options);
 };
 
-const shellCd = (cd) => {
-  logger.info(`cd`, cd);
+const shellCd = (cd, options = { disableLog: true }) => {
+  if (options.disableLog) logger.info(`cd`, cd);
   return shell.cd(cd);
 };
 

package/src/server/prompt-optimizer.js

@@ -0,0 +1,28 @@
+// https://github.com/xenova/transformers.js/blob/f43d3dd348fd7b293008802590bb3a1afa218dc7/src/models.js#L10
+
+import { AutoModelForSeq2SeqLM, AutoTokenizer } from '@xenova/transformers';
+import { loggerFactory } from './logger.js';
+import dotenv from 'dotenv';
+
+dotenv.config();
+
+const logger = loggerFactory(import.meta);
+
+const tokenizer = await AutoTokenizer.from_pretrained('Xenova/t5-small');
+
+const model = await AutoModelForSeq2SeqLM.from_pretrained('Xenova/t5-small');
+
+const prompt = 'translate English to German: I love transformers!';
+
+logger.info('input', { prompt });
+
+const tokenizerData = await tokenizer(prompt);
+
+const { input_ids } = tokenizerData;
+
+const outputs = await model.generate(input_ids);
+
+for (const output of outputs) {
+  const decoded = tokenizer.decode(output, { skip_special_tokens: true });
+  logger.info('decoded', { decoded });
+}

package/bin/help.js

@@ -1,110 +0,0 @@
-import { loggerFactory } from '../src/server/logger.js';
-import colors from 'colors';
-
-colors.enable();
-
-const logger = loggerFactory(import.meta);
-
-// backup: `node bin/db <host><path> export <deploy-id>`
-// restore: `node bin/db <host><path> import <deploy-id>`
-// new-api-src: `node bin/deploy build-nodejs-src-api <api-id>`
-// text-to-image: `node bin/util text-to-image 's4()' white black 100x100`
-// sync-packages: `node bin/deploy update-package`
-// ssl: `npm run ssl <os> <deploy-id> <host>`
-// clean empty folder: `node bin/util delete-empty-folder`
-// sync env port: `node bin/deploy sync-env-port <deployId>`
-// node bin/vs import
-// node bin/vs export
-// build macro replica: `node bin/deploy build-macro-replica dd`
-// node bin/deploy update-version 2.5.2
-
-const data = {
-  help: `
----------------------------------------------------------------
-${`Help`.white}
----------------------------------------------------------------
-
-Arguments:
-
-> [optional] section: help | install | ssl
-> [optional] sections: section,section,...
-
-Command Line:
-
-> ${`node bin/help <section/s>`.yellow}
-`,
-  install: `
----------------------------------------------------------------
-${`Programs installer`.white}
----------------------------------------------------------------
-
-Arguments:
-
-> [required] os: windows
-> [required] program: certbot | xampp | docker | wordpress
-> [required] host/path: example.com | example.com/path | www.example.com
-
-Command Line:
-
-> ${`node bin/install <os> <program> <host/path>`.yellow}
-`,
-  ssl: `
----------------------------------------------------------------
-${`SSL management`.white}
----------------------------------------------------------------
-
-Arguments:
-
-> [required] os: windows
-> [required] hosts: example.com,www.example.com
-
-Command Line:
-
-> ${`node bin/ssl <os> <hosts>`.yellow}
-`,
-  mariadb: `
----------------------------------------------------------------
-${`DataBase management`.white}
----------------------------------------------------------------
-
-Arguments:
-
-> [required] operator: show | create | delete | import | export
-> [required] host/path: example.com | example.com/path | www.example.com
-
-Command Line:
-
-> ${`node bin/db <host/path> <operator>`.yellow}
-`,
-  shortcut: `
----------------------------------------------------------------
-${`Shortcut Generator`.white}
----------------------------------------------------------------
-
-Arguments:
-
-> [required] os: windows | linux
-> [required] env: development | production | test
-
-Command Line:
-
-> ${`node bin/shortcut <os> <env>`.yellow}
-`,
-  end: '---------------------------------------------------------------',
-};
-
-logger.info('argv', process.argv);
-
-const [exe, dir, sections] = process.argv;
-
-try {
-  let out = '';
-  if (!sections) Object.keys(data).map((section) => (out += data[section]));
-  else {
-    for (const section of sections.split(',')) out += data[section];
-    out += data['end'];
-  }
-  logger.info(out);
-} catch (error) {
-  logger.error(error, error.stack);
-}