Modernize generator (#54)

* feat: modernize generator - oclif v4, fast-xml-parser v5, native fetch, vitest tests
* fix: address code review and CodeQL findings from validation
* Regenerate generator README to remove duplicate commands section
* Update npm-publish job: add packages:write, node 24, GitHub Package Registry publish

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>

Author: Copilot

.github/workflows/generator.yml

@@ -1,74 +1,89 @@
 on:
-  workflow_dispatch:
   push:
     branches:
       - main
-      - ci-build
     paths:
       - '.github/workflows/generator.yml'
       - 'generator/sonos-docs/src/**/*.ts'
-      - 'generator/sonos-docs/.releaserc'
+      - 'generator/sonos-docs/package.json'
 
   pull_request:
     branches:
       - main
     paths:
       - '.github/workflows/generator.yml'
       - 'generator/sonos-docs/src/**/*.ts'
+      - 'generator/sonos-docs/package.json'
+
+  release:
+    types: [published]
 
 jobs:
   test:
-    name: 'Build and test on Node v${{ matrix.node }}'
+    name: 'Build and test on Node ${{ matrix.node }}'
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     strategy:
       matrix:
-        node: [16, 18]
+        node: [22, 24]
     defaults:
       run:
         working-directory: generator/sonos-docs
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node }}
-      - name: Install depencencies
+      - name: Install dependencies
         run: npm ci
       - name: Build library
-        run: npm run prepack
+        run: npm run build
+      - name: Run tests
+        run: npm test
 
-  release:
-    name: 'Release generator'
+  npm-publish:
+    name: 'Publish to npm'
     needs: [test]
     runs-on: ubuntu-latest
-    if: github.event_name != 'pull_request'
+    if: github.event_name == 'release'
+    permissions:
+      contents: read
+      id-token: write
+      packages: write
     defaults:
       run:
         working-directory: generator/sonos-docs
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - name: Checkout
+        uses: actions/checkout@v7
+
+      - name: Setup node for npm registry
+        uses: actions/setup-node@v6
         with:
-          node-version: 16
-      - name: Install depencencies
+          node-version: 24
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
         run: npm ci
-      - name: Semantic Release
-        uses: cycjimmy/semantic-release-action@v4
-        id: semantic
-        with:
-          working_directory: generator/sonos-docs
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
-      - name: Setup node for Github Registry
-        if: steps.semantic.outputs.new_release_published == 'true'
-        uses: actions/setup-node@v4
+
+      - name: Set version from release tag
+        run: npm version --no-git-tag-version "${{ github.event.release.tag_name }}"
+
+      - name: Build library
+        run: npm run prepack
+
+      - name: Publish to npm
+        run: npm publish --access public --provenance --tag ${{ github.event.release.prerelease && 'beta' || 'latest' }}
+
+      - name: Setup node for GitHub Package Registry
+        uses: actions/setup-node@v6
         with:
-          node-version: 16
+          node-version: 24
           registry-url: 'https://npm.pkg.github.com'
-          scope: 'svrooij'
-      - name: Publish To GitHub Package Registry
-        if: steps.semantic.outputs.new_release_published == 'true'
-        run: |
-          npm publish
+          scope: '@svrooij'
+
+      - name: Publish to GitHub Package Registry
+        run: npm publish --tag ${{ github.event.release.prerelease && 'beta' || 'latest' }}
         env:
-          NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/json-validation.yml

@@ -21,9 +21,9 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
       - name: Use node 16
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v6
         with:
           node-version: 16
       - name: Install ajv-cli

.github/workflows/linter.yml

@@ -39,7 +39,7 @@ jobs:
       # Checkout the code base #
       ##########################
       - name: Checkout Code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
         with:
           # Full git history is needed to get list of changed files 
           fetch-depth: 0