underpost 2.89.0 → 2.89.1

package/.github/workflows/release.cd.yml

@@ -30,7 +30,9 @@ jobs:
             echo "Starting remote release deploy"
             underpost run pull
             underpost run secret
+            npm install -g underpost
             cd /home/dd/engine
+            underpost run secret
             node bin run --dev git-conf
             node bin run --dev template-deploy-image
             node bin run --dev ssh-deploy sync-engine-test

package/README.md

@@ -18,7 +18,7 @@
 
 <!-- badges -->
 
-[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.89.0)](https://socket.dev/npm/package/underpost/overview/2.89.0) [![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)
+[![Node.js CI](https://github.com/underpostnet/engine/actions/workflows/docker-image.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/docker-image.yml) [![Test](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml/badge.svg?branch=master)](https://github.com/underpostnet/engine/actions/workflows/coverall.ci.yml) [![Downloads](https://img.shields.io/npm/dm/underpost.svg)](https://www.npmjs.com/package/underpost) [![Socket Badge](https://socket.dev/api/badge/npm/package/underpost/2.89.1)](https://socket.dev/npm/package/underpost/overview/2.89.1) [![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)
 
 <!-- end-badges -->
 
@@ -66,7 +66,7 @@ Run dev client server
 npm run dev
 ```
 <!-- -->
-## underpost ci/cd cli v2.89.0
+## underpost ci/cd cli v2.89.1
 
 ### Usage: `underpost [options] [command]`
   ```

package/bin/index.js

@@ -1,5 +1,12 @@
 #! /usr/bin/env node
 
 import { program } from '../src/cli/index.js';
+import { loggerFactory } from '../src/server/logger.js';
 
-program.parse();
+const logger = loggerFactory(import.meta);
+
+try {
+  program.parse();
+} catch (error) {
+  logger.error(error);
+}

package/cli.md

@@ -1,4 +1,4 @@
-## underpost ci/cd cli v2.89.0
+## underpost ci/cd cli v2.89.1
 
 ### Usage: `underpost [options] [command]`
   ```

package/manifests/deployment/dd-default-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-blue
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.1
           #          resources:
           #            requests:
           #              memory: "124Ki"
@@ -100,7 +100,7 @@ spec:
     spec:
       containers:
         - name: dd-default-development-green
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.1
           #          resources:
           #            requests:
           #              memory: "124Ki"

package/manifests/deployment/dd-test-development/deployment.yaml

@@ -17,7 +17,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-blue
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.1
 #          resources:
 #            requests:
 #              memory: "96294Ki"
@@ -104,7 +104,7 @@ spec:
     spec:
       containers:
         - name: dd-test-development-green
-          image: localhost/rockylinux9-underpost:v2.89.0
+          image: localhost/rockylinux9-underpost:v2.89.1
 #          resources:
 #            requests:
 #              memory: "96294Ki"

package/package.json

@@ -2,7 +2,7 @@
     "type": "module",
     "main": "src/index.js",
     "name": "underpost",
-    "version": "2.89.0",
+    "version": "2.89.1",
     "description": "pwa api rest template",
     "scripts": {
         "start": "env-cmd -f .env.production node --max-old-space-size=8192 src/server",

package/scripts/rpmfusion-ffmpeg-setup.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Purpose: enable required repos (CRB, EPEL, RPM Fusion) and attempt to install ffmpeg on Rocky/Alma/RHEL-9 compatible systems.
+
+if [ "${EUID:-$(id -u)}" -ne 0 ]; then
+  echo "This script must be run as root or with sudo. Exiting."
+  exit 1
+fi
+
+echo "1) Ensure dnf-plugins-core is available (for config-manager)"
+dnf -y install dnf-plugins-core || true
+
+echo "2) Enable CodeReady / CRB (needed for some deps, e.g. ladspa)"
+# On RHEL you'd use subscription-manager; on CentOS/Rocky/Alma use config-manager
+dnf config-manager --set-enabled crb || true
+
+echo "3) Install EPEL release (required by some ffmpeg deps)"
+dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm || true
+
+echo "4) Add RPM Fusion (free + nonfree) repositories"
+# Using mirrors.rpmfusion.org recommended links
+dnf -y install https://mirrors.rpmfusion.org/free/el/rpmfusion-free-release-9.noarch.rpm \
+               https://mirrors.rpmfusion.org/nonfree/el/rpmfusion-nonfree-release-9.noarch.rpm || true
+
+echo "5) Refresh metadata and update system"
+dnf -y makecache
+# Optional: update system packages (comment out if you don't want a full update)
+# dnf -y update
+
+echo "6) Try to install audio helper packages that sometimes block ffmpeg (ladspa, rubberband)"
+# These may be provided by CRB/EPEL or other compatible repos
+dnf -y install ladspa || echo "ladspa not available from enabled repos (will try later)"
+dnf -y install rubberband || echo "rubberband not available from enabled repos (will try later)"
+
+echo "7) Try installing ffmpeg (several fallbacks tried)"
+if dnf -y install ffmpeg ffmpeg-devel --allowerasing; then
+  echo "ffmpeg installed successfully (used --allowerasing)."
+elif dnf -y install ffmpeg ffmpeg-devel --nobest; then
+  echo "ffmpeg installed successfully (used --nobest)."
+elif dnf -y install ffmpeg ffmpeg-devel --skip-broken; then
+  echo "ffmpeg installed (skip-broken). Some optional packages may have been skipped."
+else
+  echo "Automatic install failed."
+  echo "Helpful troubleshooting steps:"
+  echo " - Check which repo provides ladspa: dnf repoquery --whatprovides 'ladspa'"
+  echo " - Check which package provides librubberband: dnf repoquery --whatprovides 'librubberband.so.2'"
+  echo " - Try enabling CRB and EPEL (we already attempted that). If ladspa/rubberband are still missing you can fetch their EL9 rpm from a trusted mirror or build them."
+  echo " - Example manual install (ONLY if you trust the source): sudo dnf install /path/to/ladspa-*.el9.rpm /path/to/rubberband-*.el9.rpm"
+  echo " - After satisfying ladspa/rubberband, rerun: sudo dnf install ffmpeg ffmpeg-devel"
+  exit 2
+fi
+
+echo "\nInstallation finished. Verify with: ffmpeg -version"
+exit 0

package/src/cli/run.js

@@ -938,7 +938,14 @@ class UnderpostRun {
      * @param {Object} options - The default underpost runner options for customizing workflow
      * @memberof UnderpostRun
      */
-    sh: async (path, options = UnderpostRun.DEFAULT_OPTION) => {
+    sh: async (path = '', options = UnderpostRun.DEFAULT_OPTION) => {
+      let [operator, arg0, arg1] = path.split(',');
+      if (operator == 'copy') {
+        shellExec(
+          `kitty @ get-text ${arg0 === 'all' ? '--match all' : '--self'} --extent all${arg1 === 'ansi' ? ' --ansi yes' : ''} | kitty +kitten clipboard`,
+        );
+        return;
+      }
       shellExec(`kitty -o allow_remote_control=yes`);
     },
 

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

@@ -1,11 +1,11 @@
-import { getQueryParams, setQueryParams } from './Router.js';
+import { getQueryParams, setQueryParams, listenQueryParamsChange } from './Router.js';
 
 class AgPagination extends HTMLElement {
   constructor() {
     super();
     this.attachShadow({ mode: 'open' });
     this._gridId = null;
-    const queryParams = getQueryParams();
+    let queryParams = getQueryParams();
     this._currentPage = parseInt(queryParams.page, 10) || 1;
     this._limit = parseInt(queryParams.limit, 10) || 10;
     this._totalPages = 1;
@@ -13,6 +13,8 @@ class AgPagination extends HTMLElement {
     this._limitOptions = [10, 20, 50, 100]; // Default options
     this.handlePageChange = this.handlePageChange.bind(this);
     this.handleLimitChange = this.handleLimitChange.bind(this);
+
+    this.handleQueryParamsChange = this.handleQueryParamsChange.bind(this);
   }
 
   static get observedAttributes() {
@@ -53,11 +55,43 @@ class AgPagination extends HTMLElement {
   connectedCallback() {
     this.render();
     this.addEventListeners();
-    this.update();
+    // Subscribe to query parameter changes once the component is connected and _gridId is potentially set.
+    listenQueryParamsChange({
+      id: `ag-pagination-${this._gridId || 'default'}`, // Use _gridId for a unique listener ID
+      event: this.handleQueryParamsChange,
+    });
+    // The initial state is already set in the constructor from getQueryParams().
+    // The `listenQueryParamsChange` in `Router.js` will trigger an immediate (setTimeout) call
+    // to `handleQueryParamsChange`, which will re-sync the state if needed and update the component.
+    this.update(); // Keep the initial update for rendering based on constructor's initial state.
   }
 
   disconnectedCallback() {
-    // Event listeners on shadow DOM are garbage collected with the component
+    // If Router.js held strong references to queryParamsChangeListeners, you might need to unsubscribe here.
+    // However, for this example, we'll assume the component's lifecycle or weak references handle cleanup.
+  }
+
+  handleQueryParamsChange(queryParams) {
+    const newPage = parseInt(queryParams.page, 10) || 1;
+    const newLimit = parseInt(queryParams.limit, 10) || 10;
+
+    let shouldUpdate = false;
+
+    if (newPage !== this._currentPage) {
+      this._currentPage = newPage;
+      shouldUpdate = true;
+    }
+    if (newLimit !== this._limit) {
+      this._limit = newLimit;
+      shouldUpdate = true;
+    }
+
+    if (shouldUpdate) {
+      this.update();
+      this.dispatchEvent(
+        new CustomEvent('pagination-query-params-change', { detail: { page: this._currentPage, limit: this._limit } }),
+      );
+    }
   }
 
   handlePageChange(newPage) {
@@ -65,7 +99,7 @@ class AgPagination extends HTMLElement {
       return;
     }
     this._currentPage = newPage;
-    setQueryParams({ page: newPage, limit: this._limit });
+    setQueryParams({ page: newPage, limit: this._limit }, { replace: false }); // Use pushState
     this.dispatchEvent(new CustomEvent('page-change', { detail: { page: newPage } }));
   }
 
@@ -76,7 +110,7 @@ class AgPagination extends HTMLElement {
     }
     this._limit = newLimit;
     this._currentPage = 1; // Reset to first page on limit change
-    setQueryParams({ page: 1, limit: newLimit });
+    setQueryParams({ page: 1, limit: newLimit }, { replace: false }); // Use pushState
     this.dispatchEvent(new CustomEvent('limit-change', { detail: { limit: newLimit } }));
   }
 
@@ -98,7 +132,8 @@ class AgPagination extends HTMLElement {
     this.shadowRoot.querySelector('#page-info').textContent = `Page ${this._currentPage} of ${this._totalPages}`;
 
     const limitSelector = this.shadowRoot.querySelector('#limit-selector');
-    if (limitSelector.value != this._limit) {
+    if (limitSelector && limitSelector.value != this._limit) {
+      // Added null check for limitSelector
       limitSelector.value = this._limit;
     }
 

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

@@ -19,6 +19,13 @@ const logger = loggerFactory(import.meta, { trace: true });
  */
 const RouterEvents = {};
 
+/**
+ * @type {Object.<string, function>}\n
+ * @description Holds event listeners for query parameter changes.\n
+ * @memberof PwaRouter
+ */
+const queryParamsChangeListeners = {};
+
 /**
  * @type {string[]}
  * @description Array of core UI component IDs that should not trigger modal close route changes.
@@ -227,6 +234,22 @@ const listenQueryPathInstance = ({ id, routeId, event }, queryKey = 'cid') => {
     });
 };
 
+/**
+ * Registers a listener for changes to query parameters.\n
+ * The provided event callback is triggered with the current query parameters object.\n
+ * @param {object} options - The listener options.\n
+ * @param {string} options.id - A unique ID for the listener.\n
+ * @param {function(Object.<string, string>): void} options.event - The callback function to execute with the new query parameters.\n
+ * @memberof PwaRouter
+ */
+const listenQueryParamsChange = ({ id, event }) => {
+  queryParamsChangeListeners[id] = event;
+  // Immediately call with current query params for initial state
+  setTimeout(() => {
+    event(getQueryParams());
+  });
+};
+
 /**
  * Handles the logic for changing the route when a modal is closed. It determines the next URL
  * based on the remaining open modals or falls back to a home URL.
@@ -305,6 +328,13 @@ const setQueryParams = (newParams, options = { replace: true }) => {
   } else {
     history.pushState(history.state, '', newPath);
   }
+
+  const updatedParams = getQueryParams();
+  for (const listenerId in queryParamsChangeListeners) {
+    if (Object.hasOwnProperty.call(queryParamsChangeListeners, listenerId)) {
+      queryParamsChangeListeners[listenerId](updatedParams);
+    }
+  }
 };
 
 export {
@@ -323,4 +353,6 @@ export {
   setPath,
   setQueryParams,
   sanitizeRoute,
+  queryParamsChangeListeners,
+  listenQueryParamsChange,
 };

package/src/index.js

@@ -35,7 +35,7 @@ class Underpost {
    * @type {String}
    * @memberof Underpost
    */
-  static version = 'v2.89.0';
+  static version = 'v2.89.1';
   /**
    * Repository cli API
    * @static

package/src/server/client-build.js

@@ -573,7 +573,7 @@ const buildClient = async (options = { liveClientBuildPaths: [], instances: [] }
                 apiBaseHost,
                 apiBasePath: process.env.BASE_API,
                 version: Underpost.version,
-                dev: isDevelopment,
+                ...(isDevelopment ? { dev: true } : undefined),
               },
               renderApi: {
                 JSONweb,
@@ -667,7 +667,7 @@ Sitemap: https://${host}${path === '/' ? '' : path}/sitemap.xml`,
                   apiBaseHost,
                   apiBasePath: process.env.BASE_API,
                   version: Underpost.version,
-                  dev: isDevelopment,
+                  ...(isDevelopment ? { dev: true } : undefined),
                 },
                 renderApi: {
                   JSONweb,