cyberia 2.8.885

package/src/db/mongo/MongooseDB.js

@@ -0,0 +1,70 @@
+import mongoose from 'mongoose';
+import { loggerFactory } from '../../server/logger.js';
+import { getCapVariableName } from '../../client/components/core/CommonJs.js';
+
+/**
+ * Module for connecting to and loading models for a MongoDB database using Mongoose.
+ * @module src/db/MongooseDB.js
+ * @namespace MongooseDBNamespace
+ */
+
+const logger = loggerFactory(import.meta);
+
+/**
+ * @class
+ * @alias MongooseDBService
+ * @memberof MongooseDBNamespace
+ * @classdesc Manages the Mongoose connection lifecycle and dynamic loading of database models
+ * based on API configuration.
+ */
+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} name - The database name.
+   * @returns {Promise<mongoose.Connection>} A promise that resolves to the established Mongoose connection object.
+   */
+  async connect(host, name) {
+    const uri = `${host}/${name}`;
+    logger.info('MongooseDB connect', { host, name, uri });
+    return await mongoose
+      .createConnection(uri, {
+        // Options like useNewUrlParser and useUnifiedTopology are often set here.
+      })
+      .asPromise();
+  }
+
+  /**
+   * Dynamically loads Mongoose models for a list of APIs and binds them to the given connection.
+   *
+   * @async
+   * @param {object} [options] - Options for model loading.
+   * @param {Array<string>} [options.apis=['test']] - List of API names (folders) to load models from.
+   * @param {mongoose.Connection} [options.conn=new mongoose.Connection()] - The active Mongoose connection.
+   * @returns {Promise<object>} A promise that resolves to an object map of loaded Mongoose models.
+   */
+  async loadModels(options = { apis: ['test'], conn: new mongoose.Connection() }) {
+    const { conn, apis } = options;
+    const models = {};
+    for (const api of apis) {
+      // Dynamic import of the model file
+      const { ProviderSchema } = await import(`../../api/${api}/${api}.model.js`);
+      const keyModel = getCapVariableName(api); // Assuming this returns a capitalized model name
+      models[keyModel] = conn.model(keyModel, ProviderSchema);
+    }
+
+    return models;
+  }
+}
+
+/**
+ * Singleton instance of the MongooseDBService class for backward compatibility.
+ * @alias MongooseDB
+ * @memberof MongooseDBNamespace
+ * @type {MongooseDBService}
+ */
+const MongooseDB = new MongooseDBService();
+
+export { MongooseDB, MongooseDBService as MongooseDBClass };

package/src/index.js

@@ -0,0 +1,198 @@
+/**
+ * Underpost index npm package
+ * @module src/index.js
+ * @namespace Underpost
+ */
+
+import UnderpostBaremetal from './cli/baremetal.js';
+import UnderpostCloudInit from './cli/cloud-init.js';
+import UnderpostCluster from './cli/cluster.js';
+import UnderpostCron from './cli/cron.js';
+import UnderpostDB from './cli/db.js';
+import UnderpostDeploy from './cli/deploy.js';
+import UnderpostRootEnv from './cli/env.js';
+import UnderpostFileStorage from './cli/fs.js';
+import UnderpostImage from './cli/image.js';
+import UnderpostLxd from './cli/lxd.js';
+import UnderpostMonitor from './cli/monitor.js';
+import UnderpostRepository from './cli/repository.js';
+import UnderpostRun from './cli/run.js';
+import UnderpostScript from './cli/script.js';
+import UnderpostSecret from './cli/secrets.js';
+import UnderpostSSH from './cli/ssh.js';
+import UnderpostTest from './cli/test.js';
+import UnderpostStartUp from './server/start.js';
+
+/**
+ * Underpost main module methods
+ * @class Underpost
+ * @memberof Underpost
+ */
+class Underpost {
+  /**
+   * Underpost engine version
+   * @static
+   * @type {String}
+   * @memberof Underpost
+   */
+  static version = 'v2.8.885';
+  /**
+   * Repository cli API
+   * @static
+   * @type {UnderpostRepository.API}
+   * @memberof Underpost
+   */
+  static repo = UnderpostRepository.API;
+  /**
+   * Root Env cli API
+   * @static
+   * @type {UnderpostRootEnv.API}
+   * @memberof Underpost
+   */
+  static env = UnderpostRootEnv.API;
+  /**
+   * Test cli API
+   * @static
+   * @type {UnderpostTest.API}
+   * @memberof Underpost
+   */
+  static test = UnderpostTest.API;
+  /**
+   * Underpost Start Up cli API
+   * @static
+   * @type {UnderpostStartUp.API}
+   * @memberof Underpost
+   */
+  static start = UnderpostStartUp.API;
+  /**
+   * Cluster cli API
+   * @static
+   * @type {UnderpostCluster.API}
+   * @memberof Underpost
+   */
+  static cluster = UnderpostCluster.API;
+  /**
+   * Image cli API
+   * @static
+   * @type {UnderpostImage.API}
+   * @memberof Underpost
+   */
+  static image = UnderpostImage.API;
+  /**
+   * Secrets cli API
+   * @static
+   * @type {UnderpostSecret.API}
+   * @memberof Underpost
+   */
+  static secret = UnderpostSecret.API;
+  /**
+   * Scripts cli API
+   * @static
+   * @type {UnderpostScript.API}
+   * @memberof Underpost
+   */
+  static script = UnderpostScript.API;
+  /**
+   * Database cli API
+   * @static
+   * @type {UnderpostDB.API}
+   * @memberof Underpost
+   */
+  static db = UnderpostDB.API;
+  /**
+   * Deployment cli API
+   * @static
+   * @type {UnderpostDeploy.API}
+   * @memberof Underpost
+   */
+  static deploy = UnderpostDeploy.API;
+  /**
+   * Cron cli API
+   * @static
+   * @type {UnderpostCron.API}
+   * @memberof Underpost
+   */
+  static cron = UnderpostCron.API;
+  /**
+   * File Storage cli API
+   * @static
+   * @type {UnderpostFileStorage.API}
+   * @memberof Underpost
+   */
+  static fs = UnderpostFileStorage.API;
+  /**
+   * Monitor cli API
+   * @static
+   * @type {UnderpostMonitor.API}
+   * @memberof Underpost
+   */
+  static monitor = UnderpostMonitor.API;
+  /**
+   * SSH cli API
+   * @static
+   * @type {UnderpostSSH.API}
+   * @memberof Underpost
+   */
+  static ssh = UnderpostSSH.API;
+  /**
+   * LXD cli API
+   * @static
+   * @type {UnderpostLxd.API}
+   * @memberof Underpost
+   */
+  static lxd = UnderpostLxd.API;
+
+  /**
+   * Cloud Init cli API
+   * @static
+   * @type {UnderpostCloudInit.API}
+   * @memberof Underpost
+   */
+  static cloudInit = UnderpostCloudInit.API;
+
+  /**
+   * Run cli API
+   * @static
+   * @type {UnderpostRun.API}
+   * @memberof Underpost
+   */
+  static run = UnderpostRun.API;
+
+  /**
+   * Baremetal cli API
+   * @static
+   * @type {UnderpostBaremetal.API}
+   * @memberof Underpost
+   */
+  static baremetal = UnderpostBaremetal.API;
+}
+
+const up = Underpost;
+
+const underpost = Underpost;
+
+export {
+  underpost,
+  up,
+  Underpost,
+  UnderpostBaremetal,
+  UnderpostCloudInit,
+  UnderpostCluster,
+  UnderpostCron,
+  UnderpostDB,
+  UnderpostDeploy,
+  UnderpostRootEnv,
+  UnderpostFileStorage,
+  UnderpostImage,
+  UnderpostLxd,
+  UnderpostMonitor,
+  UnderpostRepository,
+  UnderpostRun,
+  UnderpostScript,
+  UnderpostSecret,
+  UnderpostSSH,
+  UnderpostTest,
+  UnderpostStartUp,
+};
+
+export default Underpost;

package/src/mailer/EmailRender.js

@@ -0,0 +1,116 @@
+import { ssrFactory } from '../server/ssr.js';
+
+/**
+ * Module for handling the rendering and styling of HTML emails using SSR components.
+ * @module src/mailer/EmailRender.js
+ * @namespace EmailRenderNamespace
+ */
+
+/**
+ * @class
+ * @alias EmailRenderService
+ * @memberof EmailRenderNamespace
+ * @classdesc Utility class for managing CSS styles and rendering email templates using
+ * Server-Side Rendering (SSR) components.
+ */
+class EmailRenderService {
+  /**
+   * Defines the base CSS styles for different elements within the email template.
+   * Keys are CSS selectors (or class names), and values are objects of CSS properties.
+   * @type {object.<string, object.<string, string>>}
+   * @property {object} body - Styles for the main email body wrapper.
+   * @property {object} .container - Styles for the main content container.
+   * @property {object} h1 - Styles for primary headings.
+   * @property {object} p - Styles for standard paragraphs.
+   * @property {object} button - Styles for call-to-action buttons.
+   * @property {object} .footer - Styles for the email footer.
+   */
+  style = {
+    body: {
+      'font-family': 'Arial, sans-serif',
+      'background-color': '#f4f4f4',
+      margin: 0,
+      padding: '20px',
+      'min-height': '300px',
+      width: '100%',
+      'max-width': '700px',
+      display: 'block',
+    },
+    '.container': {
+      'max-width': '600px',
+      margin: '0 auto',
+      'background-color': '#ffffff',
+      padding: '20px',
+      'border-radius': '5px',
+      // 'box-shadow': '0 4px 8px 0 rgba(0, 0, 0, 0.2), 0 6px 20px 0 rgba(0, 0, 0, 0.19)',
+    },
+    h1: {
+      'font-size': '24px',
+      'margin-bottom': '20px',
+      color: '#333333',
+    },
+    p: {
+      'font-size': '16px',
+      'line-height': 1.5,
+      'margin-bottom': '20px',
+      color: '#666666',
+    },
+    button: {
+      display: 'inline-block',
+      padding: '10px 20px',
+      'background-color': '#007bff',
+      color: '#ffffff',
+      'text-decoration': 'none',
+      'border-radius': '5px',
+      'font-size': '16px',
+    },
+    '.footer': {
+      'text-align': 'center',
+      padding: '20px',
+      'font-size': '14px',
+      color: '#999999',
+    },
+  };
+
+  /**
+   * Converts a style object defined in the `this.style` property into a CSS style string.
+   *
+   * @param {string} classObj - The key corresponding to a style object in `this.style`.
+   * @returns {string} A string containing inline CSS properties (e.g., ` property: value;`).
+   */
+  renderStyle(classObj) {
+    if (!this.style[classObj]) return '';
+    return Object.keys(this.style[classObj])
+      .map((classKey) => ` ${classKey}: ${this.style[classObj][classKey]};`)
+      .join(``);
+  }
+
+  /**
+   * Loads and renders email templates using the SSR factory.
+   *
+   * @async
+   * @param {object} [options] - Options containing the template names.
+   * @param {object.<string, string>} [options.templates={}] - Map of template keys to their SSR component file names.
+   * @returns {Promise<object.<string, string>>} A promise that resolves to an object map of rendered HTML email strings.
+   */
+  async getTemplates(options = { templates: {} }) {
+    const templates = {};
+    for (const templateKey of Object.keys(options.templates)) {
+      const ssrEmailComponent = options.templates[templateKey];
+      // Note: ssrFactory is assumed to load and return a functional component/function
+      const SrrComponent = await ssrFactory(`./src/client/ssr/mailer/${ssrEmailComponent}.js`);
+      templates[templateKey] = SrrComponent(this, options);
+    }
+    return templates;
+  }
+}
+
+/**
+ * Singleton instance of the EmailRenderService class for backward compatibility.
+ * @alias EmailRender
+ * @memberof EmailRenderNamespace
+ * @type {EmailRenderService}
+ */
+const EmailRender = new EmailRenderService();
+
+export { EmailRender, EmailRenderService as EmailRenderClass };

package/src/mailer/MailerProvider.js

@@ -0,0 +1,213 @@
+import nodemailer from 'nodemailer';
+import { loggerFactory } from '../server/logger.js';
+import { EmailRender } from './EmailRender.js';
+
+/**
+ * Module for configuring and sending emails using Nodemailer.
+ * @module src/mailer/MailerProvider.js
+ * @namespace MailerProviderNamespace
+ */
+
+const logger = loggerFactory(import.meta);
+
+/**
+ * @typedef {object} MailerOptions
+ * @property {string} id - Unique identifier for the mailer configuration.
+ * @property {string} [meta='mailer'] - Meta identifier for logging/context.
+ * @property {object} sender - The default sender details.
+ * @property {string} sender.email - The default sender email address.
+ * @property {string} sender.name - The default sender name.
+ * @property {object} transport - Nodemailer transport configuration.
+ * @property {string} transport.host - SMTP host.
+ * @property {number} [transport.port=587] - SMTP port.
+ * @property {boolean} [transport.secure=false] - Use TLS (true for 465, false for other ports).
+ * @property {object} transport.auth - Authentication details.
+ * @property {string} transport.auth.user - Username.
+ * @property {string} transport.auth.pass - Password.
+ * @property {string} [host=''] - Application host for context.
+ * @property {string} [path=''] - Application path for context.
+ * @property {object.<string, string>} templates - Map of template keys to SSR component file names.
+ * @memberof MailerProviderNamespace
+ */
+
+/**
+ * @class
+ * @alias MailerProviderService
+ * @memberof MailerProviderNamespace
+ * @classdesc Manages multiple Nodemailer transporter instances and handles loading of
+ * email templates and sending emails.
+ */
+class MailerProviderService {
+  /**
+   * Internal storage for mailer instances (transporters, options, templates), keyed by ID.
+   * @type {object.<string, object>}
+   * @private
+   */
+  #instance = {};
+
+  /**
+   * Retrieves the internal instance storage for direct access (used for backward compatibility).
+   * @returns {object.<string, object>} The internal mailer instance map.
+   */
+  get instance() {
+    return this.#instance;
+  }
+
+  /**
+   * Loads and initializes a new mailer provider instance using Nodemailer.
+   * The created instance is stored internally and includes the transporter and rendered templates.
+   *
+   * @async
+   * @param {MailerOptions} [options] - Configuration options for the mailer instance.
+   * @returns {Promise<object|undefined>} A promise that resolves to the initialized mailer instance
+   * object, or `undefined` on error.
+   */
+  async load(
+    options = {
+      id: '',
+      meta: 'mailer',
+      sender: {
+        email: '',
+        name: '',
+      },
+      transport: {
+        host: '', // smtp host
+        port: 587,
+        secure: false, // true for 465, false for other ports
+        auth: {
+          user: '', // generated ethereal user
+          pass: '', // generated ethereal password
+        },
+      },
+      host: '',
+      path: '',
+      templates: {
+        userVerifyEmail: 'DefaultVerifyEmail',
+        userRecoverEmail: 'DefaultRecoverEmail',
+      },
+    },
+  ) {
+    try {
+      options.transport.tls = {
+        rejectUnauthorized: false, // allows self-signed certs for local/dev
+      };
+      const { id } = options;
+
+      const transporter = nodemailer.createTransport(options.transport);
+
+      this.#instance[id] = {
+        ...options,
+        transporter,
+        templates: await EmailRender.getTemplates(options),
+        translateTemplates: {
+          confirmEmail: {
+            H1: {
+              en: 'Confirm Your Email',
+              es: 'Confirma tu correo electrónico',
+            },
+            P1: {
+              en: `Email confirmed! Thanks.
+               <br />
+             <span style="font-size: 12px; color: gray"> 
+                If it is not automatically verified, 
+                please allow the image to be seen, thank you.
+             </span>
+              `,
+              es: `Correo electrónico confirmado! Gracias.
+              <br />
+              <span style="font-size: 12px; color: gray"> 
+               Si no se verifica automáticamente, por favor permita que se vea la imagen, gracias.
+              </span>
+              `,
+            },
+          },
+          recoverEmail: {
+            H1: {
+              en: 'Recover your account',
+              es: 'Recupera tu cuenta',
+            },
+            P1: {
+              en: 'To recover your account, please click the button below:',
+              es: 'Para recuperar tu cuenta, haz click en el botón de abajo:',
+            },
+            BTN_LABEL: {
+              en: 'Recover Password',
+              es: 'Recuperar Contraseña',
+            },
+          },
+        },
+      };
+
+      return this.#instance[id];
+    } catch (error) {
+      logger.error(error, error.stack);
+      return undefined;
+    }
+  }
+
+  /**
+   * Sends an email using a previously loaded transporter instance.
+   *
+   * @async
+   * @param {object} [options] - Options for sending the email.
+   * @param {string} options.id - The ID of the mailer instance/transporter to use.
+   * @param {object} options.sendOptions - Nodemailer mail options.
+   * @param {string} [options.sendOptions.from] - Sender address (defaults to loaded instance sender).
+   * @param {string} options.sendOptions.to - List of receivers (comma-separated).
+   * @param {string} options.sendOptions.subject - Subject line.
+   * @param {string} [options.sendOptions.text] - Plain text body.
+   * @param {string} [options.sendOptions.html] - HTML body.
+   * @returns {Promise<object|undefined>} A promise that resolves to the Nodemailer `info` object, or `undefined` on error.
+   */
+  async send(
+    options = {
+      id: '',
+      sendOptions: {
+        from: '"Fred Foo 👻" <foo@example.com>', // sender address
+        to: 'bar@example.com, baz@example.com', // list of receivers
+        subject: 'Hello ✔', // Subject line
+        text: 'Hello world?', // plain text body
+        html: '<b>Hello world?</b>', // html body
+        attachments: [
+          {
+            filename: 'logo.png',
+            path: `./logo.png`,
+            cid: 'logo', // <img src='cid:logo'>
+          },
+        ],
+      },
+    },
+  ) {
+    try {
+      const { id, sendOptions } = options;
+      const instance = this.#instance[id];
+
+      if (!instance) {
+        logger.error(`Mailer instance with ID '${id}' not loaded.`);
+        return undefined;
+      }
+
+      if (!sendOptions.from) sendOptions.from = `${instance.sender.name} <${instance.sender.email}>`;
+
+      // send mail with defined transport object
+      const info = await instance.transporter.sendMail(sendOptions);
+
+      // logger.info('Message sent', info);
+
+      return info;
+    } catch (error) {
+      logger.error(error, error.stack);
+      return undefined;
+    }
+  }
+}
+
+/**
+ * Singleton instance of the MailerProviderService class for backward compatibility.
+ * @alias MailerProvider
+ * @memberof MailerProviderNamespace
+ * @type {MailerProviderService}
+ */
+const MailerProvider = new MailerProviderService();
+
+export { MailerProvider, MailerProviderService as MailerProviderClass };

package/src/monitor.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 { getUnderpostRootPath } from './server/conf.js';
+import fs from 'fs-extra';
+import UnderpostMonitor from './cli/monitor.js';
+
+const underpostRootPath = getUnderpostRootPath();
+fs.existsSync(`${underpostRootPath}/.env`)
+  ? dotenv.config({ path: `${underpostRootPath}/.env`, override: true })
+  : dotenv.config();
+
+const logger = loggerFactory(import.meta);
+
+await logger.setUpInfo();
+
+UnderpostMonitor.API.callback(process.argv[2], process.argv[3], { type: 'blue-green', sync: true });
+
+ProcessController.init(logger);

package/src/proxy.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 { buildProxy } from './server/proxy.js';
+import { ProcessController } from './server/process.js';
+import { Config } from './server/conf.js';
+
+dotenv.config();
+
+await Config.build();
+
+const logger = loggerFactory(import.meta);
+
+await logger.setUpInfo();
+
+await buildProxy();
+
+ProcessController.init(logger);