underpost 3.2.8 → 3.2.9

package/src/client/services/default/default.management.js

@@ -675,28 +675,27 @@ class DefaultManagement {
       EventsUI.onClick(`.management-table-btn-clear-filter-${id}`, async () => {
         try {
           const gridApi = AgGrid.grids[gridId];
-          // Clear all filters
-          DefaultManagement.clearIdFilter(id);
-          if (gridApi) {
-            gridApi.setFilterModel({});
-            gridApi.applyColumnState({ defaultState: { sort: null } });
-          }
-          // Clear token state
-          if (DefaultManagement.Tokens[id]) {
-            DefaultManagement.Tokens[id].filterModel = {};
-            DefaultManagement.Tokens[id].sortModel = [];
-          }
-          // Update URL - keep only page and limit
-          const queryParams = getQueryParams();
-          setQueryParams({
-            page: queryParams.page || 1,
-            limit: queryParams.limit || DefaultManagement.Tokens[id]?.limit || 10,
-            filterModel: null,
-            sortModel: null,
-            id: null,
+          await DefaultManagement.runIsolated(id, async () => {
+            // Clear all filters without letting grid/query listeners trigger their own reloads.
+            DefaultManagement.clearIdFilter(id);
+            if (gridApi) {
+              gridApi.setFilterModel({});
+              gridApi.applyColumnState({ defaultState: { sort: null } });
+            }
+            if (DefaultManagement.Tokens[id]) {
+              DefaultManagement.Tokens[id].filterModel = {};
+              DefaultManagement.Tokens[id].sortModel = [];
+            }
+            const queryParams = getQueryParams();
+            setQueryParams({
+              page: queryParams.page || 1,
+              limit: queryParams.limit || DefaultManagement.Tokens[id]?.limit || 10,
+              filterModel: null,
+              sortModel: null,
+              id: null,
+            });
+            await DefaultManagement.loadTable(id, { force: true, reload: true, skipUrlUpdate: true });
           });
-          // Reload table
-          await DefaultManagement.loadTable(id, { force: true, reload: true });
           NotificationManager.Push({
             html: Translate.instance('success-clear-filter') || 'Filters cleared',
             status: 'success',
@@ -729,15 +728,11 @@ class DefaultManagement {
       s(`#ag-pagination-${gridId}`).addEventListener('page-change', async (event) => {
         const token = DefaultManagement.Tokens[id];
         token.page = event.detail.page;
-        // Skip URL update since Pagination component already updated it
-        await DefaultManagement.loadTable(id, { skipUrlUpdate: true });
       });
       s(`#ag-pagination-${gridId}`).addEventListener('limit-change', async (event) => {
         const token = DefaultManagement.Tokens[id];
         token.limit = event.detail.limit;
         token.page = 1; // Reset to first page
-        // Skip URL update since Pagination component already updated it
-        await DefaultManagement.loadTable(id, { skipUrlUpdate: true });
       });
       RouterEvents[id] = async (...args) => {
         const queryParams = getQueryParams();

package/src/client/services/user/guest.service.js

@@ -15,7 +15,14 @@ class SessionMetaDb extends Dexie {
   }
 }
 
-const db = new SessionMetaDb();
+// Lazy singleton — avoids opening IndexedDB at module-load time.
+// Firefox is measurably slower at IDB open than Chromium; deferring the
+// open until first actual read/write eliminates that latency from page startup.
+let _db = null;
+const getDb = () => {
+  if (!_db) _db = new SessionMetaDb();
+  return _db;
+};
 
 class GuestService {
   static setUserToken(value = '') {
@@ -59,7 +66,7 @@ class GuestService {
 
   static async setMeta(key, value) {
     try {
-      await db.meta.put({ key, value, updatedAt: Date.now() });
+      await getDb().meta.put({ key, value, updatedAt: Date.now() });
     } catch (error) {
       logger.warn('session meta write failed', { key, error: error?.message });
     }
@@ -67,7 +74,7 @@ class GuestService {
 
   static async getMeta(key) {
     try {
-      const row = await db.meta.get(key);
+      const row = await getDb().meta.get(key);
       return row ? row.value : null;
     } catch (error) {
       logger.warn('session meta read failed', { key, error: error?.message });

package/src/index.js

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

package/src/server/data-query.js

@@ -5,7 +5,16 @@
  * @namespace DataQuery
  */
 
-export const DataQuery = {
+/**
+ * @class DataQuery
+ * @description Utility class for parsing request query parameters into Mongoose query options,
+ * including support for AG Grid filterModel and sortModel. Provides a static `parse`
+ * method that takes in request query parameters and returns an object containing the MongoDB
+ * query, sort options, pagination skip/limit, and page number. Designed to be used in API
+ * controllers to handle complex querying needs from the frontend.
+ * @memberof DataQuery
+ */
+class DataQuery {
   /**
    * Parse request query parameters into Mongoose query options
    * @param {Object} params - The request query parameters (req.query)
@@ -20,7 +29,7 @@ export const DataQuery = {
    * @memberof DataQuery
    * @returns {Object} { query, sort, skip, limit, page }
    */
-  parse: (params = {}) => {
+  static parse(params = {}) {
     let { filterModel, sortModel, page, limit, sort: sortParam, asc, order, query: defaultQuery } = params;
 
     // === 1. Pagination ===
@@ -35,7 +44,7 @@ export const DataQuery = {
     const query = DataQuery._parseFilter(filterModel, defaultQuery);
 
     return { query, sort, skip, limit, page };
-  },
+  }
 
   /**
    * Parse sort parameters from AG Grid sortModel or simple sort params
@@ -47,7 +56,7 @@ export const DataQuery = {
    * @return {Object} sort object for Mongoose
    * @memberof DataQuery
    */
-  _parseSort: (sortModel, sortParam, asc, order) => {
+  static _parseSort(sortModel, sortParam, asc, order) {
     const sort = {};
 
     // Parse sortModel from string if needed
@@ -90,7 +99,7 @@ export const DataQuery = {
     }
 
     return sort;
-  },
+  }
 
   /**
    * Parse filter parameters from AG Grid filterModel
@@ -100,7 +109,7 @@ export const DataQuery = {
    * @return {Object} query object for Mongoose
    * @memberof DataQuery
    */
-  _parseFilter: (filterModel, defaultQuery) => {
+  static _parseFilter(filterModel, defaultQuery) {
     let query = defaultQuery ? { ...defaultQuery } : {};
 
     // Parse filterModel from string if needed
@@ -127,7 +136,7 @@ export const DataQuery = {
     });
 
     return query;
-  },
+  }
 
   /**
    * Parse a single field filter
@@ -137,7 +146,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the field or null if invalid
    * @memberof DataQuery
    */
-  _parseFieldFilter: (field, filter) => {
+  static _parseFieldFilter(field, filter) {
     if (!filter || !filter.filterType) {
       return null;
     }
@@ -158,7 +167,7 @@ export const DataQuery = {
       default:
         return null;
     }
-  },
+  }
 
   /**
    * Parse text filter
@@ -168,7 +177,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the text field or null if invalid
    * @memberof DataQuery
    */
-  _parseTextFilter: (field, filter) => {
+  static _parseTextFilter(field, filter) {
     const { type, filter: filterValue } = filter;
 
     if (filterValue === null || filterValue === undefined || filterValue === '') {
@@ -219,7 +228,7 @@ export const DataQuery = {
     }
 
     return query;
-  },
+  }
 
   /**
    * Parse number filter
@@ -229,7 +238,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the number field or null if invalid
    * @memberof DataQuery
    */
-  _parseNumberFilter: (field, filter) => {
+  static _parseNumberFilter(field, filter) {
     const { type, filter: filterValue, filterTo } = filter;
 
     if (filterValue === null || filterValue === undefined) {
@@ -281,7 +290,7 @@ export const DataQuery = {
     }
 
     return query;
-  },
+  }
 
   /**
    * Parse date filter
@@ -291,7 +300,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the date field or null if invalid
    * @memberof DataQuery
    */
-  _parseDateFilter: (field, filter) => {
+  static _parseDateFilter(field, filter) {
     const { type, dateFrom, dateTo } = filter;
 
     // Handle blank/notBlank without dates
@@ -391,7 +400,7 @@ export const DataQuery = {
     }
 
     return query;
-  },
+  }
 
   /**
    * Parse set filter
@@ -401,7 +410,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the set field or null if invalid
    * @memberof DataQuery
    */
-  _parseSetFilter: (field, filter) => {
+  static _parseSetFilter(field, filter) {
     const { values } = filter;
 
     if (!Array.isArray(values) || values.length === 0) {
@@ -409,7 +418,7 @@ export const DataQuery = {
     }
 
     return { [field]: { $in: values } };
-  },
+  }
 
   /**
    * Parse multi filter (combines multiple filters with AND/OR)
@@ -419,7 +428,7 @@ export const DataQuery = {
    * @return {Object|null} query condition for the multi filter or null if invalid
    * @memberof DataQuery
    */
-  _parseMultiFilter: (field, filter) => {
+  static _parseMultiFilter(field, filter) {
     const { filterModels, operator } = filter;
 
     if (!Array.isArray(filterModels) || filterModels.length === 0) {
@@ -445,5 +454,8 @@ export const DataQuery = {
       // AND operator (default)
       return { $and: conditions };
     }
-  },
-};
+  }
+}
+
+export { DataQuery };
+export default DataQuery;

package/src/server/dns.js

@@ -101,6 +101,22 @@ class Dns {
     return ipv4.address;
   }
 
+  /**
+   * Gets the MAC address of the main (default route) network interface.
+   * @static
+   * @memberof UnderpostDns
+   * @returns {string|null} The MAC address, or null if not found.
+   */
+  static getMainInterfaceMac() {
+    const interfaceName = Dns.getDefaultNetworkInterface();
+    const networkInfo = os.networkInterfaces()[interfaceName];
+    if (!networkInfo || networkInfo.length === 0) {
+      logger.error(`Could not find network interface: ${interfaceName}`);
+      return null;
+    }
+    return networkInfo[0].mac;
+  }
+
   /**
    * Setup nftables tables and chains if they don't exist.
    * @static
@@ -491,6 +507,12 @@ class Dns {
       });
     }
 
+    if (options.mac) {
+      const mac = Dns.getMainInterfaceMac();
+      console.log(mac);
+      return mac;
+    }
+
     let ip;
     if (options.dhcp) ip = Dns.getLocalIPv4Address();
     else ip = await Dns.getPublicIp();

package/src/server/start.js

@@ -133,11 +133,19 @@ class UnderpostStartUp {
      * @param {boolean} options.underpostQuicklyInstall - Whether to use underpost quickly install.
      * @param {boolean} options.skipPullBase - Whether to skip pulling the base code.
      * @param {boolean} options.skipFullBuild - Whether to skip building the full client bundle.
+     * @param {boolean} options.pullBundle - When true, download pre-built client bundle from Cloudinary via pull-bundle before starting.
      */
     async callback(
       deployId = 'dd-default',
       env = 'development',
-      options = { build: false, run: false, underpostQuicklyInstall: false, skipPullBase: false, skipFullBuild: false },
+      options = {
+        build: false,
+        run: false,
+        underpostQuicklyInstall: false,
+        skipPullBase: false,
+        skipFullBuild: false,
+        pullBundle: false,
+      },
     ) {
       Underpost.env.set('container-status', `${deployId}-${env}-build-deployment`);
       if (options.build === true) await Underpost.start.build(deployId, env, options);
@@ -152,12 +160,14 @@ class UnderpostStartUp {
      * @param {boolean} options.skipPullBase - Whether to skip pulling the base code and use the current workspace code directly.
      * @param {boolean} options.underpostQuicklyInstall - Whether to use underpost quickly install.
      * @param {boolean} options.skipFullBuild - Whether to skip building the full client bundle.
+     * @param {boolean} options.pullBundle - When true, download pre-built client bundle from Cloudinary via pull-bundle (must be pushed first with push-bundle).
+     *   This flag is independent of skipFullBuild: it can be combined with skipFullBuild or used alone.
      * @memberof UnderpostStartUp
      */
     async build(
       deployId = 'dd-default',
       env = 'development',
-      options = { underpostQuicklyInstall: false, skipPullBase: false, skipFullBuild: false },
+      options = { underpostQuicklyInstall: false, skipPullBase: false, skipFullBuild: false, pullBundle: false },
     ) {
       const buildBasePath = `/home/dd`;
       const repoName = `engine-${deployId.split('-')[1]}`;
@@ -176,7 +186,8 @@ class UnderpostStartUp {
         for (const itcScript of itcScripts)
           if (itcScript.match(deployId)) shellExec(`node ./engine-private/itc-scripts/${itcScript}`);
       }
-      if (!options.skipFullBuild) shellExec(`node bin client ${deployId}`);
+      if (options.pullBundle === true) shellExec(`node bin run pull-bundle --deploy-id ${deployId}`);
+      else if (!options.skipFullBuild) shellExec(`node bin client ${deployId}`);
     },
     /**
      * Runs a deployment.

package/src/server/valkey.js

@@ -22,7 +22,7 @@ const logger = loggerFactory(import.meta);
 /** @type {Record<string, import('iovalkey').default>} */
 const ValkeyInstances = {};
 
-/** @type {Record<string, 'connected' | 'error'>} */
+/** @type {Record<string, 'connected' | 'reconnecting' | 'error'>} */
 const ValkeyStatus = {};
 
 /**
@@ -57,7 +57,10 @@ const createValkeyConnection = async (instance = {}, connectionOptions = {}) =>
   const client = new Valkey({
     port: connectionOptions.port ?? undefined,
     host: connectionOptions.host ?? undefined,
-    retryStrategy: (attempt) => (attempt === 1 ? undefined : 1000),
+    // Retry indefinitely with capped exponential backoff (1 s → 30 s)
+    retryStrategy: (attempt) => Math.min(attempt * 1000, 30000),
+    // Fail commands immediately when not connected; do NOT queue them
+    maxRetriesPerRequest: 0,
   });
 
   client.on('ready', () => {
@@ -68,6 +71,10 @@ const createValkeyConnection = async (instance = {}, connectionOptions = {}) =>
     ValkeyStatus[key] = 'error';
     logger.error('Valkey error', { err: err?.message, instance });
   });
+  client.on('reconnecting', () => {
+    ValkeyStatus[key] = 'reconnecting';
+    logger.warn('Valkey reconnecting...', { instance });
+  });
   client.on('end', () => {
     ValkeyStatus[key] = 'error';
     logger.warn('Valkey connection ended', { instance });

package/typedoc.json

@@ -1,6 +1,15 @@
 {
   "name": "Nexodev - ERP, CRM Development & Cloud DevOps Services",
-  "entryPoints": ["./src/server", "./src/api", "./src/db", "./src/ws", "./src/grpc", "./src/mailer", "./src/runtime"],
+  "entryPoints": [
+    "./src/server",
+    "./src/api",
+    "./src/cli",
+    "./src/db",
+    "./src/ws",
+    "./src/grpc",
+    "./src/mailer",
+    "./src/runtime"
+  ],
   "entryPointStrategy": "expand",
   "exclude": ["**/node_modules/**", "**/docs/**", "**/client/**"],
   "out": "./public/www.nexodev.org/docs/",