underpost 2.8.851 → 2.8.852

package/README.md

@@ -48,12 +48,13 @@ template
 
 
 
+
 
 
 <!-- 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.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.8.851)](https://socket.dev/npm/package/underpost/overview/2.8.851) [![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.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.8.852)](https://socket.dev/npm/package/underpost/overview/2.8.852) [![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 -->
@@ -84,6 +85,7 @@ template
 
 
 
+
 
 
 </div>
@@ -130,43 +132,43 @@ Run dev client server
 npm run dev
 ```
 <!-- -->
-## underpost ci/cd cli v2.8.851
+## underpost ci/cd cli v2.8.852
 
 ### Usage: `underpost [options] [command]`
-
-```
-Options:
--V, --version                                              output the version number
--h, --help                                                 display help for command
+  ```
+ Options:
+  -V, --version                                              output the version number
+  -h, --help                                                 display help for command
 
 Commands:
-new <app-name>                                             Initializes a new Underpost project with a predefined structure.
-start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
-clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
-pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
-cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
-push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
-env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
-config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
-root                                                       Displays the root path of the npm installation.
-cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
-deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
-secret [options] <platform>                                Manages secrets for various platforms.
-dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
-dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
-install                                                    Quickly imports Underpost npm dependencies by copying them.
-db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
-script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
-cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
-fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
-test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
-monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
-ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
-run [options] <runner-id> [path]                           Runs a script from the specified path.
-lxd [options]                                              Manages LXD containers and virtual machines.
-baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
-help [command]                                             display help for command
-
+  new <app-name>                                             Initializes a new Underpost project with a predefined structure.
+  start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
+  clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
+  pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
+  cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
+  push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
+  env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
+  config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
+  root                                                       Displays the root path of the npm installation.
+  cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
+  deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
+  secret [options] <platform>                                Manages secrets for various platforms.
+  dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
+  dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
+  install                                                    Quickly imports Underpost npm dependencies by copying them.
+  db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
+  script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
+  cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
+  fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
+  test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
+  monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
+  ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
+  run [options] <runner-id> [path]                           Runs a script from the specified path.
+  lxd [options]                                              Manages LXD containers and virtual machines.
+  baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+  help [command]                                             display help for command
+ 
 ```
-
+      
 <a target="_top" href="https://github.com/underpostnet/pwa-microservices-template/blob/master/cli.md">See complete CLI Docs here.</a>
+      

package/cli.md

@@ -1,46 +1,45 @@
-## underpost ci/cd cli v2.8.851
+## underpost ci/cd cli v2.8.852
 
 ### Usage: `underpost [options] [command]`
-
-```
-Options:
--V, --version                                              output the version number
--h, --help                                                 display help for command
+  ```
+ Options:
+  -V, --version                                              output the version number
+  -h, --help                                                 display help for command
 
 Commands:
-new <app-name>                                             Initializes a new Underpost project with a predefined structure.
-start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
-clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
-pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
-cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
-push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
-env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
-config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
-root                                                       Displays the root path of the npm installation.
-cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
-deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
-secret [options] <platform>                                Manages secrets for various platforms.
-dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
-dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
-install                                                    Quickly imports Underpost npm dependencies by copying them.
-db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
-script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
-cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
-fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
-test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
-monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
-ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
-run [options] <runner-id> [path]                           Runs a script from the specified path.
-lxd [options]                                              Manages LXD containers and virtual machines.
-baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
-help [command]                                             display help for command
-
+  new <app-name>                                             Initializes a new Underpost project with a predefined structure.
+  start [options] <deploy-id> [env]                          Initiates application servers, build pipelines, or other defined services based on the deployment ID.
+  clone [options] <uri>                                      Clones a specified GitHub repository into the current directory.
+  pull [options] <path> <uri>                                Pulls the latest changes from a specified GitHub repository.
+  cmt [options] <path> <commit-type> [module-tag] [message]  Manages commits to a GitHub repository, supporting various commit types and options.
+  push [options] <path> <uri>                                Pushes committed changes from a local repository to a remote GitHub repository.
+  env <deploy-id> [env]                                      Sets environment variables and configurations related to a specific deployment ID.
+  config [options] <operator> [key] [value]                  Manages Underpost configurations using various operators.
+  root                                                       Displays the root path of the npm installation.
+  cluster [options] [pod-name]                               Manages Kubernetes clusters, defaulting to Kind cluster initialization.
+  deploy [options] [deploy-list] [env]                       Manages application deployments, defaulting to deploying development pods.
+  secret [options] <platform>                                Manages secrets for various platforms.
+  dockerfile-image-build [options]                           Builds a Docker image from a specified Dockerfile with various options for naming, saving, and loading.
+  dockerfile-pull-base-images [options]                      Pulls required Underpost Dockerfile base images and optionally loads them into clusters.
+  install                                                    Quickly imports Underpost npm dependencies by copying them.
+  db [options] <deploy-list>                                 Manages database operations, including import, export, and collection management.
+  script [options] <operator> <script-name> [script-value]   Supports a variety of built-in Underpost global scripts, their preset lifecycle events, and arbitrary custom scripts.
+  cron [options] [deploy-list] [job-list]                    Manages cron jobs, including initialization, execution, and configuration updates.
+  fs [options] [path]                                        Manages file storage, defaulting to file upload operations.
+  test [options] [deploy-list]                               Manages and runs tests, defaulting to the current Underpost default test suite.
+  monitor [options] <deploy-id> [env]                        Manages health server monitoring for specified deployments.
+  ssh [options]                                              Import and start ssh server and client based on current default deployment ID.
+  run [options] <runner-id> [path]                           Runs a script from the specified path.
+  lxd [options]                                              Manages LXD containers and virtual machines.
+  baremetal [options] [workflow-id] [hostname] [ip-address]  Manages baremetal server operations, including installation, database setup, commissioning, and user management.
+  help [command]                                             display help for command
+ 
 ```
 
 ## Commands:
+    
 
 ### `new` :
-
 ```
  Usage: underpost new [options] <app-name>
 
@@ -51,11 +50,11 @@ Arguments:
 
 Options:
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `start` :
-
 ```
  Usage: underpost start [options] <deploy-id> [env]
 
@@ -71,11 +70,11 @@ Options:
   --run       Starts application servers and monitors their health.
   --build     Triggers the client-side application build process.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `clone` :
-
 ```
  Usage: underpost clone [options] <uri>
 
@@ -88,11 +87,11 @@ Options:
   --bare      Performs a bare clone, downloading only the .git files.
   -g8         Uses the g8 repository extension for cloning.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `pull` :
-
 ```
  Usage: underpost pull [options] <path> <uri>
 
@@ -106,11 +105,11 @@ Arguments:
 Options:
   -g8         Uses the g8 repository extension for pulling.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `cmt` :
-
 ```
  Usage: underpost cmt [options] <path> <commit-type> [module-tag] [message]
 
@@ -130,11 +129,11 @@ Options:
   --copy       Copies the generated commit message to the clipboard.
   --info       Displays information about available commit types.
   -h, --help   display help for command
-
+ 
 ```
+  
 
 ### `push` :
-
 ```
  Usage: underpost push [options] <path> <uri>
 
@@ -148,11 +147,11 @@ Options:
   -f          Forces the push, overwriting the remote repository history.
   -g8         Uses the g8 repository extension for pushing.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `env` :
-
 ```
  Usage: underpost env [options] <deploy-id> [env]
 
@@ -167,11 +166,11 @@ Arguments:
 
 Options:
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `config` :
-
 ```
  Usage: underpost config [options] <operator> [key] [value]
 
@@ -186,11 +185,11 @@ Arguments:
 Options:
   --plain     Prints the configuration value in plain text.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `root` :
-
 ```
  Usage: underpost root [options]
 
@@ -198,11 +197,11 @@ Displays the root path of the npm installation.
 
 Options:
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `cluster` :
-
 ```
  Usage: underpost cluster [options] [pod-name]
 
@@ -256,11 +255,11 @@ Options:
   --k3s                   Initializes the cluster using K3s (Lightweight
                           Kubernetes).
   -h, --help              display help for command
-
+ 
 ```
+  
 
 ### `deploy` :
-
 ```
  Usage: underpost deploy [options] [deploy-list] [env]
 
@@ -307,11 +306,11 @@ Options:
                                     bundles (only static public or storage
                                     client files).
   -h, --help                        display help for command
-
+ 
 ```
+  
 
 ### `secret` :
-
 ```
  Usage: underpost secret [options] <platform>
 
@@ -329,11 +328,11 @@ Options:
   --list                              Lists all available secrets for the
                                       platform.
   -h, --help                          display help for command
-
+ 
 ```
+  
 
 ### `dockerfile-image-build` :
-
 ```
  Usage: underpost dockerfile-image-build [options]
 
@@ -360,11 +359,11 @@ Options:
                                        cache.
   --k3s-load                           Loads the image into a K3s cluster.
   -h, --help                           display help for command
-
+ 
 ```
+  
 
 ### `dockerfile-pull-base-images` :
-
 ```
  Usage: underpost dockerfile-pull-base-images [options]
 
@@ -378,11 +377,11 @@ Options:
   --version       Sets a custom version for the base images.
   --k3s-load      Loads the image into a K3s cluster.
   -h, --help      display help for command
-
+ 
 ```
+  
 
 ### `install` :
-
 ```
  Usage: underpost install [options]
 
@@ -390,11 +389,11 @@ Quickly imports Underpost npm dependencies by copying them.
 
 Options:
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `db` :
-
 ```
  Usage: underpost db [options] <deploy-list>
 
@@ -424,11 +423,11 @@ Options:
   --ns <ns-name>               Optional: Specifies the namespace context for
                                database operations.
   -h, --help                   display help for command
-
+ 
 ```
+  
 
 ### `script` :
-
 ```
  Usage: underpost script [options] <operator> <script-name> [script-value]
 
@@ -450,11 +449,11 @@ Options:
                          execution.
   --pod-name <pod-name>  Optional: Specifies the pod name for script execution.
   -h, --help             display help for command
-
+ 
 ```
+  
 
 ### `cron` :
-
 ```
  Usage: underpost cron [options] [deploy-list] [job-list]
 
@@ -475,11 +474,11 @@ Options:
   --dashboard-update  Updates dashboard cron data with the current job
                       configurations.
   -h, --help          display help for command
-
+ 
 ```
+  
 
 ### `fs` :
-
 ```
  Usage: underpost fs [options] [path]
 
@@ -497,11 +496,11 @@ Options:
   --force                                  Forces the action, overriding any warnings or conflicts.
   --storage-file-path <storage-file-path>  Specifies a custom file storage path.
   -h, --help                               display help for command
-
+ 
 ```
+  
 
 ### `test` :
-
 ```
  Usage: underpost test [options] [deploy-list]
 
@@ -523,11 +522,11 @@ Options:
   --kind-type <kind-type>    Optional: Specifies the Kind cluster type for
                              tests.
   -h, --help                 display help for command
-
+ 
 ```
+  
 
 ### `monitor` :
-
 ```
  Usage: underpost monitor [options] <deploy-id> [env]
 
@@ -550,11 +549,11 @@ Options:
   --sync                       Synchronizes with current proxy deployments and
                                traffic configurations.
   -h, --help                   display help for command
-
+ 
 ```
+  
 
 ### `ssh` :
-
 ```
  Usage: underpost ssh [options]
 
@@ -564,11 +563,11 @@ Options:
   --generate  Generates new ssh credential and stores it in current private
               keys file storage.
   -h, --help  display help for command
-
+ 
 ```
+  
 
 ### `run` :
-
 ```
  Usage: underpost run [options] <runner-id> [path]
 
@@ -590,11 +589,11 @@ Options:
   --container-name <container-name>        Optional: Specifies the container name for test execution.
   --namespace <namespace>                  Optional: Specifies the namespace for test execution.
   -h, --help                               display help for command
-
+ 
 ```
+  
 
 ### `lxd` :
-
 ```
  Usage: underpost lxd [options]
 
@@ -635,11 +634,11 @@ Options:
   --auto-expose-k8s-ports <vm-id>  Automatically exposes common Kubernetes
                                    ports for the specified VM.
   -h, --help                       display help for command
-
+ 
 ```
+  
 
 ### `baremetal` :
-
 ```
  Usage: underpost baremetal [options] [workflow-id] [hostname] [ip-address]
 
@@ -673,5 +672,6 @@ Options:
                                  baremetal operations.
   --ls                           Lists available boot resources and machines.
   -h, --help                     display help for command
-
+ 
 ```
+  

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.8.851'
+      engine.version: '2.8.852'
     networks:
       - load-balancer
 

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

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

package/package.json

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

package/src/api/user/user.service.js

@@ -32,7 +32,7 @@ const UserService = {
       const payloadToken = hashJWT({ email: req.body.email }, '15m');
       const id = `${options.host}${options.path}`;
       const translate = MailerProvider.instance[id].translateTemplates.recoverEmail;
-      const recoverUrl = `${process.env.NODE_ENV === 'development' ? 'http://' : 'https://'}${req.hostname}${
+      const recoverUrl = `${process.env.NODE_ENV === 'development' ? 'http://' : 'https://'}${req.body.hostname}${
         req.body.proxyPath
       }recover?payload=${payloadToken}`;
       const sendResult = await MailerProvider.send({
@@ -45,7 +45,7 @@ const UserService = {
             .replace('{{H1}}', translate.H1[req.lang])
             .replace('{{P1}}', translate.P1[req.lang])
             .replace('{{TOKEN}}', token)
-            .replace(`{{COMPANY}}`, req.hostname) // html body
+            .replace(`{{COMPANY}}`, req.body.hostname) // html body
             .replace('{{RECOVER_WEB_URL}}', recoverUrl)
             .replace('{{RECOVER_BTN_LABEL}}', translate.BTN_LABEL[req.lang]),
 
@@ -94,7 +94,7 @@ const UserService = {
             .replace('{{H1}}', translate.H1[req.lang])
             .replace('{{P1}}', translate.P1[req.lang])
             .replace('{{TOKEN}}', token)
-            .replace(`{{COMPANY}}`, req.hostname), // html body
+            .replace(`{{COMPANY}}`, req.body.hostname), // html body
           attachments: [
             // {
             //   filename: 'logo.png',

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

@@ -103,7 +103,11 @@ const Account = {
             e.preventDefault();
             const result = await UserService.post({
               id: 'mailer/verify-email',
-              body: { email: s(`.account-email`).value },
+              body: {
+                email: s(`.account-email`).value,
+                hostname: `${location.hostname}`,
+                proxyPath: getProxyPath(),
+              },
             });
             NotificationManager.Push({
               html: result.status === 'error' ? result.message : Translate.Render(`email send`),

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

@@ -81,6 +81,7 @@ const Recover = {
         switch (mode) {
           case 'recover-verify-email': {
             body.proxyPath = getProxyPath();
+            body.hostname = `${location.hostname}`;
             const result = await UserService.post({ id: 'recover-verify-email', body });
             NotificationManager.Push({
               html:

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

@@ -133,56 +133,54 @@ const copyData = (data) =>
 const pasteData = () => new Promise((resolve) => navigator.clipboard.readText().then((clipText) => resolve(clipText)));
 
 /**
- * Normalize a path/URL (ensure leading slash, collapse duplicate slashes,
- * keep query + hash, remove trailing slash except for root).
- * Examples:
- *  - 'a/b' -> '/a/b'
- *  - '/a//b/' -> '/a/b'
- *  - 'https://example.com/a/b?q=1#top' -> '/a/b?q=1#top' (origin ignored)
- *  - '#section' -> '/current/path#section' (resolved relative by new URL)
- */
-function normalizePath(input) {
-  // ensure string and trim
-  if (typeof input !== 'string') input = String(input ?? '');
-  input = input.trim();
-
-  // empty -> root
-  if (input === '') return '/';
-
-  // Use URL to parse relative or absolute paths relative to current origin
-  let url;
-  try {
-    url = new URL(input, window.location.origin);
-  } catch (e) {
-    // fallback (very rare)
-    input = input.replace(/\s+/g, ''); // remove problematic spaces
-    input = input.replace(/\/+/g, '/'); // collapse multiple '/'
-    if (!input.startsWith('/')) input = '/' + input;
-    if (input.length > 1 && input.endsWith('/')) input = input.slice(0, -1);
-    return input;
-  }
-
-  // Normalize pathname: collapse slashes, ensure leading slash, remove trailing except root
-  let pathname = url.pathname.replace(/\/+/g, '/');
-  if (!pathname.startsWith('/')) pathname = '/' + pathname;
-  if (pathname.length > 1 && pathname.endsWith('/')) pathname = pathname.slice(0, -1);
-
-  // Rebuild: pathname + search + hash
-  return pathname + url.search + url.hash;
-}
-
-/**
- * Improved setPath: normalizes path and avoids pushState if nothing changes.
+ * 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
+ * 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
+ * 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
+ * title of the new history entry. It is used as the title of the new history entry in the browser's
+ * history.
+ * @memberof VanillaJS
  */
 const setPath = (path = '/', stateStorage = {}, title = '') => {
-  const normalized = normalizePath(path);
-
-  // Compare the full form (pathname + search + hash) with current
-  const currentFull = window.location.pathname + window.location.search + window.location.hash;
-  if (currentFull === normalized) return; // nothing to do
-
-  // pushState: third arg should be a path relative to same origin (we pass normalized)
-  return history.pushState(stateStorage, title, normalized);
+  if (!path) path = '/';
+
+  const [inputPath, inputSearch] = `${path}`.split('?');
+
+  let sanitizedPath = (inputPath[0] !== '/' ? `/${inputPath}` : inputPath)
+    .trim()
+    .replaceAll('//', '/')
+    .replaceAll(`\\`, '/');
+
+  if (sanitizedPath.length > 1 && sanitizedPath[sanitizedPath.length - 1] === '/')
+    sanitizedPath = sanitizedPath.slice(0, -1);
+
+  if (window.location.pathname === sanitizedPath && (!inputSearch || inputSearch === location.search)) {
+    console.warn('Prevent overwriting same path', {
+      inputPath: inputPath,
+      inputSearch: inputSearch,
+      sanitizedPath: sanitizedPath,
+      currentLocationSearch: location.search,
+      currentLocationHash: location.hash,
+    });
+    return;
+  }
+  console.warn('Set path', {
+    inputPath: inputPath,
+    inputSearch: inputSearch,
+    sanitizedPath: sanitizedPath,
+    currentLocationSearch: location.search,
+    currentLocationHash: location.hash,
+  });
+  return history.pushState(
+    stateStorage,
+    title,
+    `${sanitizedPath}${inputSearch ? `?${inputSearch}` : ''}${location.hash ?? ''}`,
+  );
 };
 
 /**

package/src/index.js

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