fix: restore subpath imports after ESM builder migration

Author: charlesmulder

.github/actions/lint/action.yaml

@@ -4,7 +4,6 @@ runs:
   using: "composite"
   steps:
     - uses: nrwl/nx-set-shas@v4
-    - uses: './.github/actions/node-cache'
     - name: Install deps
       shell: bash
       run: npm i

.github/actions/setup-environment/action.yaml

@@ -4,7 +4,22 @@ description: Setup Node.js and cache dependencies consistently
 runs:
   using: "composite"
   steps:
+    - name: Show Node.js environment info
+      shell: bash
+      run: |
+        echo "=== Pre-installed Node.js versions ==="
+        ls -la /opt/hostedtoolcache/node/ 2>/dev/null || ls -la /opt/acttoolcache/node/ 2>/dev/null || echo "No pre-installed Node versions found"
+        echo "=== Current default Node.js ==="
+        which node && node --version || echo "No default Node.js found"
+        echo "=== .nvmrc content ==="
+        cat .nvmrc 2>/dev/null || echo "No .nvmrc file found"
     - uses: actions/setup-node@v5
       with:
-        node-version: '20.19.5'
-    - uses: './.github/actions/node-cache'
+        node-version-file: '.nvmrc'
+    - name: Show final Node.js version
+      shell: bash
+      run: |
+        echo "=== Final Node.js version after setup ==="
+        which node && node --version
+        npm --version
+    - uses: './.github/actions/node-cache'

.github/actions/test-integration/action.yml

@@ -4,7 +4,6 @@ runs:
   using: "composite"
   steps:
     - uses: nrwl/nx-set-shas@v4
-    - uses: './.github/actions/node-cache'
     - name: integration test
       shell: bash
       run: npm run test:integration

.github/actions/test-unit/action.yaml

@@ -4,7 +4,6 @@ runs:
   using: "composite"
   steps:
     - uses: nrwl/nx-set-shas@v4
-    - uses: './.github/actions/node-cache'
     - name: Install deps
       shell: bash
       run: npm i

.nvmrc

@@ -0,0 +1 @@
+20.19.5

README.md

@@ -15,6 +15,30 @@ We are using Java to install and build this generator. Please install Java and p
 
 ### Troubleshooting
 
+#### Publish to local registry 
+
+You can publish a package to a local registry to test that the import works. 
+
+```sh
+# start local registry
+docker run -it --rm --name verdaccio -p 4873:4873 verdaccio/verdaccio
+# add user and login
+npm adduser --registry http://127.0.0.1:4873
+# build package
+npx nx build @redhat-cloud-services/rbac-client 
+# publish package 
+NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 npm publish --tag local ./packages/rbac
+```
+
+Testing from package consumer perspective. 
+
+```sh
+# install package from local registry
+NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 npm install @redhat-cloud-services/rbac-client@4.2.12-local
+# build
+NPM_CONFIG_REGISTRY=http://127.0.0.1:4873 npx tsc
+```
+
 #### CI fails due to mismatch between package.json and package-lock.json
 
 The Ubuntu 24.04 container running the Github Actions uses node 20.19.5.