Refactor/use node native test runners

.github/workflows/build_and_test.yml

@@ -19,7 +19,7 @@ jobs:
         # selected operation systems to run CI
         os: [ubuntu-latest] #, windows-latest, macos-latest]
         # selected node version to run CI
-        node-version: [20.10.x]
+        node-version: [20.11.1]
 
     steps:
       - name: Check Out Repo

.github/workflows/deploy-docs.yml

@@ -37,7 +37,7 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: 20.11.1
           cache: npm # or pnpm / yarn
       - name: Setup Pages
         uses: actions/configure-pages@v4

.github/workflows/publish.yml

@@ -8,12 +8,11 @@ jobs:
       - name: Check Out Repo
         uses: actions/checkout@v4
 
-      - name: Use Node.js ${{ matrix.node-version }}
+      - name: Use Node.js
         uses: actions/setup-node@v4
         with:
-          # use the node version defined in matrix above
-          node-version: ${{ matrix.node-version }}
-          cache: 'npm'
+          node-version: lts
+          cache: npm # or pnpm / ya
 
       - name: Install dependencies
         run: npm ci

.nvmrc

@@ -1 +1 @@
-v20.10.0
+v20.11.1

.vscode/launch.json

@@ -2,29 +2,46 @@
   "version": "0.2.0",
   "configurations": [
     {
-      "name": "Debug",
+      "name": "Debug current file",
       "type": "node",
       "request": "launch",
-      "runtimeExecutable": "npm",
-      "runtimeArgs": ["run-script", "start", "--", "--inspect-brk=9229"],
-      "port": 9229
+
+      // Debug current file in VSCode
+      "program": "${file}",
+
+      /*
+    Path to tsx binary
+    Assuming locally installed
+    */
+      "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/tsx",
+
+      /*
+    Open terminal when debugging starts (Optional)
+    Useful to see console.logs
+    */
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+
+      // Files to exclude from debugger (e.g. call stack)
+      "skipFiles": [
+        // Node.js internal core modules
+        "<node_internals>/**",
+
+        // Ignore all dependencies (optional)
+        "${workspaceFolder}/node_modules/**"
+      ]
     },
     {
-      "name": "Debug Server",
+      "name": "Debug All Tests (Node)",
       "type": "node",
       "request": "launch",
+      "skipFiles": ["<node_internals>/**"],
       "runtimeExecutable": "npm",
-      "runtimeArgs": ["run-script", "start:server", "--", "--inspect-brk=9229"],
-      "port": 9229
-    },
-    {
-      "name": "Jest all tests",
-      "type": "node",
-      "request": "launch",
-      "program": "${workspaceRoot}/node_modules/jest/bin/jest.js",
-      "args": ["--verbose", "-i", "--no-cache", "--watchAll"],
+      "runtimeArgs": ["run-script", "test", "--inspect-brk=9229"], // Use --inspect-brk for debugging
       "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen"
+      "internalConsoleOptions": "neverOpen",
+      "cwd": "${workspaceFolder}",
+      "sourceMaps": true
     },
     {
       "name": "Jest current test",

.vscode/settings.json

@@ -19,5 +19,8 @@
   "files.eol": "\n",
 
   "typescript.preferences.importModuleSpecifier": "relative",
-  "eslint.workingDirectories": [{ "mode": "auto" }]
+  "eslint.workingDirectories": [{ "mode": "auto" }],
+  "debug.javascript.terminalOptions": {
+    "nodeVersionHint": 20
+  }
 }

docs/snippets/gettingStarted/businessLogic.unit.test.ts → docs/snippets/gettingStarted/businessLogic.unit.spec.ts

@@ -1,3 +1,4 @@
+import { describe, it } from 'node:test';
 import { v4 as uuid } from 'uuid';
 import { decide } from './businessLogic';
 import { evolve, getInitialState } from './state';