keycloak-api-manager 6.0.0 → 6.0.1

package/OIDC_MIGRATION_PLAN.md

@@ -1,5 +1,17 @@
 # OIDC Methods Migration Plan - keycloak-api-manager
 
+## 🚀 Current Status: v6.0.0 - MIGRATION RELEASED
+
+✅ **OIDC Methods Deprecated:** All OIDC authentication methods are now marked `@deprecated` in v6.0.0.
+
+✅ **keycloak-express-middleware v6.1.0 Released:** OIDC methods now available in middleware package with full test coverage.
+
+📅 **Removal Timeline:**
+- **v6.0.0** (NOW) - Methods work but marked @deprecated
+- **v7.0.0** (FUTURE) - Methods will be permanently removed
+
+---
+
 ## Overview
 
 L'architettura prevede una **migrazione pianificata** dei metodi OIDC (`auth()`, `login()`, `loginPKCE()`) da `keycloak-api-manager` a `keycloak-express-middleware`.
@@ -12,6 +24,22 @@ L'architettura prevede una **migrazione pianificata** dei metodi OIDC (`auth()`,
 - ✅ `generateAuthorizationUrl(options)` - PKCE URL generator
 - ✅ `loginPKCE(credentials)` - PKCE token exchange
 
+## Current State (v6.0.0) - NOW
+
+**Status Changes in keycloak-api-manager:**
+- ⚠️ `auth(credentials)` - Marked @deprecated
+- ⚠️ `login(credentials)` - Marked @deprecated
+- ⚠️ `generateAuthorizationUrl(options)` - Marked @deprecated
+- ⚠️ `loginPKCE(credentials)` - Marked @deprecated
+
+✅ Methods **still work** but show deprecation warnings in JSDoc and IDE.
+
+**Status in keycloak-express-middleware v6.1.0:**
+- ✅ `generateAuthorizationUrl(options)` - Fully implemented & tested
+- ✅ `login(credentials)` - Fully implemented & tested
+- ✅ `loginPKCE(credentials)` - Fully implemented & tested
+- ✅ All 21 tests passing
+
 ## Why This Migration?
 
 ### Separation of Concerns
@@ -45,49 +73,80 @@ keycloak-express-middleware (User Authentication)
 - [x] Write comprehensive tests (21 tests, all passing)
 - [x] Document integration guide
 - [x] Commit to middleware repo
+- [x] Integrate OIDC methods into keycloak-express-middleware v6.1.0
+- [x] Release keycloak-express-middleware v6.1.0 to npm
+
+**Status:** ✅ COMPLETE & RELEASED
+
+### Phase 2: ✅ DONE (Done)
+- [x] Mark methods as @deprecated in keycloak-api-manager index.js
+- [x] Update README with deprecation notices
+- [x] Update API documentation with deprecation notices
+- [x] Add migration guide in PKCE-Login-Flow docs
+- [x] Release keycloak-api-manager v6.0.0
+
+**Status:** ✅ COMPLETE - v6.0.0 released with @deprecated warnings
+
+### Phase 3: TODO (Future - v7.0.0)
+- [ ] Remove OIDC methods from keycloak-api-manager
+- [ ] Release keycloak-api-manager v7.0.0 (breaking change)
+- [ ] Update all documentation to reference keycloak-express-middleware only
+
+**Timeline:** TBD based on user feedback and adoption
+
+---
+
+## What You Need to Know
+
+### For Current Users (v5.0.8 or earlier)
+
+**Action Required:** Migrate to keycloak-express-middleware before v7.0.0.
+
+**Timeline:** v6.0.0 is deprecated (warnings only), v7.0.0 will remove methods entirely.
+
+**Steps:**
+1. Install keycloak-express-middleware v6.1.0+
+2. Replace method calls (see examples below)
+3. Test thoroughly
+4. Deploy before v7.0.0 is released
+
+### For New Projects
 
-**Status:** Ready for integration into `keycloak-express-middleware`
+**Action Required:** Do NOT use OIDC methods from keycloak-api-manager.
 
-### Phase 2: Manual Integration (When You're Ready)
-- [ ] Integrate `oidc-methods.js` into middleware `index.js`
-- [ ] Run tests to verify
-- [ ] Release `keycloak-express-middleware v6.1.0`
+**Recommendation:** Use keycloak-express-middleware v6.1.0+ for all user authentication.
 
-**Your Action:** Follow `keycloak-express-middleware/OIDC_INTEGRATION_GUIDE.md`
+---
 
-### Phase 3: Deprecation in keycloak-api-manager (v6.0.0)
+## NPM Packages
 
-Once middleware integration is confirmed:
+### keycloak-api-manager
 
-1. **Mark methods as deprecated** in index.js:
-   ```javascript
-   exports.auth = async function auth(credentials = {}) {
-       console.warn('⚠️ DEPRECATED: auth() is deprecated in v6.0. ' +
-           'Use keycloak-express-middleware.login() instead. ' +
-           'See: https://...');
-       return requestOidcToken(credentials);
-   };
-   ```
+| Version | OIDC Methods | Status |
+|---------|------------|--------|
+| v5.0.8 | Supported | Legacy (should migrate) |
+| v6.0.0 | Deprecated | Current (shows warnings) |
+| v7.0.0 | Removed | Future (no OIDC methods) |
 
-2. **Update documentation:**
-   - Add migration guide in README
-   - Mark OIDC methods as deprecated in API docs
-   - Link to middleware documentation
+**NPM:** https://www.npmjs.com/package/keycloak-api-manager
 
-3. **Release v6.0.0:**
-   - Update package.json version
-   - Add breaking change notice
-   - Include migration guide in release notes
+### keycloak-express-middleware
 
-4. **Future (v7.0.0):**
-   - Optionally remove these methods entirely
-   - Keep at least 1 major version for migration
+| Version | OIDC Methods | Status |
+|---------|------------|--------|
+| < 6.1.0 | Not available | Legacy |
+| v6.1.0+ | Available | Current - RECOMMENDED |
 
-## Current keycloak-api-manager Methods
+**NPM:** https://www.npmjs.com/package/keycloak-express-middleware
+
+**GitHub:** https://github.com/smartenv-crs4/keycloak-express-middleware
+
+---
+
+### `auth(credentials)` - Generic OIDC Token Grant (DEPRECATED)
 
-### `auth(credentials)` - Generic OIDC Token Grant
 ```javascript
-// Still works, but should use middleware
+// ⚠️ DEPRECATED - Don't use in new code
 const token = await KeycloakManager.auth({
   grant_type: 'password',
   username: 'user',
@@ -97,7 +156,7 @@ const token = await KeycloakManager.auth({
 
 **Migration Path:**
 ```javascript
-// Instead use middleware
+// ✅ NEW - Use keycloak-express-middleware instead
 const token = await keycloakMiddleware.login({
   grant_type: 'password',
   username: 'user',
@@ -105,9 +164,12 @@ const token = await keycloakMiddleware.login({
 });
 ```
 
-### `login(credentials)` - Preferred Alias
+---
+
+### `login(credentials)` - Preferred Alias (DEPRECATED)
+
 ```javascript
-// Currently the preferred way in API manager
+// ⚠️ DEPRECATED - Don't use in new code
 const token = await KeycloakManager.login({
   grant_type: 'client_credentials'
 });
@@ -115,15 +177,18 @@ const token = await KeycloakManager.login({
 
 **Migration Path:**
 ```javascript
-// Move to middleware
+// ✅ NEW - Use keycloak-express-middleware instead
 const token = await keycloakMiddleware.login({
   grant_type: 'client_credentials'
 });
 ```
 
-### `generateAuthorizationUrl(options)` - PKCE URL Generator
+---
+
+### `generateAuthorizationUrl(options)` - PKCE URL Generator (DEPRECATED)
+
 ```javascript
-// Generates OAuth2 authorization URL + PKCE pair
+// ⚠️ DEPRECATED - Don't use in new code
 const pkceFlow = KeycloakManager.generateAuthorizationUrl({
   redirect_uri: 'https://app/callback'
 });
@@ -131,15 +196,18 @@ const pkceFlow = KeycloakManager.generateAuthorizationUrl({
 
 **Migration Path:**
 ```javascript
-// Move to middleware
+// ✅ NEW - Use keycloak-express-middleware instead
 const pkceFlow = keycloakMiddleware.generateAuthorizationUrl({
   redirect_uri: 'https://app/callback'
 });
 ```
 
-### `loginPKCE(credentials)` - PKCE Token Exchange
+---
+
+### `loginPKCE(credentials)` - PKCE Token Exchange (DEPRECATED)
+
 ```javascript
-// Exchange auth code for tokens in callback
+// ⚠️ DEPRECATED - Don't use in new code
 const token = await KeycloakManager.loginPKCE({
   code: req.query.code,
   redirect_uri: 'https://app/callback',
@@ -147,6 +215,16 @@ const token = await KeycloakManager.loginPKCE({
 });
 ```
 
+**Migration Path:**
+```javascript
+// ✅ NEW - Use keycloak-express-middleware instead
+const token = await keycloakMiddleware.loginPKCE({
+  code: req.query.code,
+  redirect_uri: 'https://app/callback',
+  code_verifier: req.session.verifier
+});
+```
+
 **Migration Path:**
 ```javascript
 // Move to middleware
@@ -157,6 +235,8 @@ const token = await keycloakMiddleware.loginPKCE({
 });
 ```
 
+---
+
 ## What Stays in keycloak-api-manager
 
 ✅ **These remain unchanged forever:**

package/README.md

@@ -54,6 +54,8 @@ console.log(users.length);
 KeycloakManager.stop();
 ```
 
+> **💡 Tip:** For user authentication (login with credentials, PKCE flow, token exchange), use [`keycloak-express-middleware`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead. See [PKCE Login Flow Guide](docs/guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended) for migration examples.
+
 ## Keycloak Feature Flags
 
 For full API coverage in this package (especially Organizations, Client Policies, User Profile, Group permissions), run Keycloak with:

package/docs/api/configuration.md

@@ -239,9 +239,15 @@ const response = await axios.get('https://keycloak.example.com/admin/realms/mast
 
 ## auth()
 
-Backward-compatible alias of `login()`.
+⚠️ **DEPRECATED (v6.0.0)** - Use [`keycloak-express-middleware.login()`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead.
 
-Use `login()` in new code for clearer intent.
+This method will be removed in v7.0.0. For user authentication flows, use `keycloak-express-middleware` v6.1.0+.
+
+See: [Migration Guide](../guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended)
+
+---
+
+**Legacy Note:** Backward-compatible alias of `login()`. Use `login()` instead (also deprecated).
 
 **Syntax:**
 ```javascript
@@ -256,6 +262,14 @@ await KeycloakManager.auth(credentials)
 
 ## login()
 
+⚠️ **DEPRECATED (v6.0.0)** - Use [`keycloak-express-middleware.login()`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead.
+
+This method will be removed in v7.0.0. For user authentication flows, use `keycloak-express-middleware` v6.1.0+.
+
+See: [Migration Guide](../guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended)
+
+---
+
 Request tokens from Keycloak via the OIDC token endpoint.
 
 This method is intended for application-level login/token flows (for users, service clients, or third-party integrations) using this package as a wrapper.
@@ -351,6 +365,14 @@ console.log(refreshed.access_token);
 
 ## generateAuthorizationUrl()
 
+⚠️ **DEPRECATED (v6.0.0)** - Use [`keycloak-express-middleware.generateAuthorizationUrl()`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead.
+
+This method will be removed in v7.0.0. For PKCE authentication flows, use `keycloak-express-middleware` v6.1.0+.
+
+See: [Migration Guide](../guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended)
+
+---
+
 Generate OAuth2 Authorization Code + PKCE flow initialization. Returns a ready-to-use authorization URL and PKCE pair for server-side session storage.
 
 This helper simplifies the first step of PKCE login: generating the authorization URL with PKCE challenge and state parameter.
@@ -440,11 +462,19 @@ app.get('/auth/callback', async (req, res) => {
 
 ## loginPKCE()
 
+⚠️ **DEPRECATED (v6.0.0)** - Use [`keycloak-express-middleware.loginPKCE()`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead.
+
+This method will be removed in v7.0.0. For PKCE authentication flows, use `keycloak-express-middleware` v6.1.0+.
+
+See: [Migration Guide](../guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended)
+
+---
+
 Perform Authorization Code + PKCE token exchange.
 
 This helper is intended for the callback step after user login on Keycloak, where your backend receives an authorization `code` and exchanges it with `code_verifier`.
 
-> **📖 For a complete step-by-step guide on implementing PKCE flow in your application, see [PKCE Login Flow Guide](../guides/PKCE-Login-Flow.md)**
+> **📖 For a complete step-by-step guide on implementing PKCE flow in your application, see [PKCE Login Flow Guide](../guides/PKCE-Login-Flow.md#-migration-to-keycloak-express-middleware-recommended)**
 
 **Syntax:**
 ```javascript

package/docs/guides/PKCE-Login-Flow.md

@@ -1,5 +1,13 @@
 # PKCE Login Flow Guide
 
+⚠️ **DEPRECATION NOTICE (v6.0.0):** This guide describes PKCE implementation using **deprecated methods** in keycloak-api-manager. 
+
+**👉 NEW APPROACH (Recommended):** For user authentication flows, use [`keycloak-express-middleware v6.1.0+`](https://github.com/smartenv-crs4/keycloak-express-middleware) instead. The middleware package provides a more integrated and Express-native implementation of PKCE flows.
+
+**See:** Migration instructions at the end of this guide.
+
+---
+
 This guide walks you through implementing OAuth2 Authorization Code + PKCE flow in your application using Keycloak and the keycloak-api-manager library.
 
 ## Overview
@@ -506,3 +514,154 @@ function verifyToken(token) {
 - [login() API Reference](../api/configuration.md#login)
 - [OAuth2 PKCE Specification](https://tools.ietf.org/html/rfc7636)
 - [Keycloak Authorization Code Flow](https://www.keycloak.org/docs/latest/server_admin/#_oidc)
+
+---
+
+## 🚀 Migration to keycloak-express-middleware (Recommended)
+
+The methods described in this guide (`generateAuthorizationUrl()`, `loginPKCE()`, `login()`) are **deprecated in v6.0.0** and will be removed in v7.0.0.
+
+### Why Migrate?
+
+`keycloak-express-middleware` provides:
+- ✅ Native Express integration (sessions, cookies, redirects)
+- ✅ Cleaner PKCE implementation focused on user authentication
+- ✅ Better separation of concerns (admin API vs user auth)
+- ✅ Tighter integration with Express middleware patterns
+
+### Migration Example
+
+**Old Code (keycloak-api-manager, DEPRECATED):**
+```javascript
+const KeycloakManager = require('keycloak-api-manager');
+
+// Configure admin API
+await KeycloakManager.configure({
+  baseUrl: 'https://keycloak:8443',
+  realmName: 'master',
+  clientId: 'admin-cli',
+  username: 'admin',
+  password: 'admin'
+});
+
+// Use OIDC methods (deprecated)
+const pkceFlow = KeycloakManager.generateAuthorizationUrl({
+  redirect_uri: 'http://localhost:3000/callback'
+});
+
+const tokens = await KeycloakManager.loginPKCE({
+  code: req.query.code,
+  redirect_uri: 'http://localhost:3000/callback',
+  code_verifier: req.session.pkce_verifier
+});
+```
+
+**New Code (keycloak-express-middleware, RECOMMENDED):**
+```javascript
+const KeycloakMiddleware = require('keycloak-express-middleware');
+
+// Configure middleware for user authentication
+const keycloakMiddleware = new KeycloakMiddleware({
+  baseUrl: 'https://keycloak:8443',
+  realmName: 'my-realm',
+  clientId: 'my-app',
+  clientSecret: 'my-app-secret'
+});
+
+// Use OIDC methods from middleware
+const pkceFlow = keycloakMiddleware.generateAuthorizationUrl({
+  redirect_uri: 'http://localhost:3000/callback'
+});
+
+const tokens = await keycloakMiddleware.loginPKCE({
+  code: req.query.code,
+  redirect_uri: 'http://localhost:3000/callback',
+  code_verifier: req.session.pkce_verifier
+});
+```
+
+### Step-by-Step Migration
+
+**1. Install keycloak-express-middleware:**
+```bash
+npm install keycloak-express-middleware@6.1.0
+npm uninstall keycloak-api-manager  # if no longer needed for admin operations
+```
+
+**2. Initialize middleware instead of manager:**
+```javascript
+// Replace this:
+// const KeycloakManager = require('keycloak-api-manager');
+// await KeycloakManager.configure({...});
+
+// With this:
+const KeycloakMiddleware = require('keycloak-express-middleware');
+const keycloakMiddleware = new KeycloakMiddleware({
+  baseUrl: process.env.KEYCLOAK_URL,
+  realmName: process.env.KEYCLOAK_REALM,
+  clientId: process.env.KEYCLOAK_CLIENT_ID,
+  clientSecret: process.env.KEYCLOAK_CLIENT_SECRET
+});
+```
+
+**3. Replace method calls:**
+```javascript
+// Old (keycloak-api-manager)
+const pkceFlow = KeycloakManager.generateAuthorizationUrl({...});
+const tokens = await KeycloakManager.loginPKCE({...});
+const newTokens = await KeycloakManager.login({...});
+
+// New (keycloak-express-middleware)
+const pkceFlow = keycloakMiddleware.generateAuthorizationUrl({...});
+const tokens = await keycloakMiddleware.loginPKCE({...});
+const newTokens = await keycloakMiddleware.login({...});
+```
+
+**4. Keep using keycloak-api-manager for admin operations (unchanged):**
+```javascript
+const KeycloakManager = require('keycloak-api-manager');
+
+await KeycloakManager.configure({
+  baseUrl: 'https://keycloak:8443',
+  realmName: 'master',
+  clientId: 'admin-cli',
+  username: 'admin',
+  password: 'admin'
+});
+
+// Admin operations still work the same
+const users = await KeycloakManager.users.find();
+const realms = await KeycloakManager.realms.find();
+```
+
+### API Comparison
+
+| Operation | keycloak-api-manager (Deprecated) | keycloak-express-middleware (Recommended) |
+|-----------|-----------------------------------|------------------------------------------|
+| Generate PKCE URL | `KeycloakManager.generateAuthorizationUrl()` | `middleware.generateAuthorizationUrl()` |
+| Login PKCE | `KeycloakManager.loginPKCE()` | `middleware.loginPKCE()` |
+| Token Grant | `KeycloakManager.login()` | `middleware.login()` |
+| Deprecated Alias | `KeycloakManager.auth()` | *(Use login()*)  |
+
+### Additional Resources
+
+- **Middleware Documentation:** https://github.com/smartenv-crs4/keycloak-express-middleware
+- **Migration Guide:** https://github.com/smartenv-crs4/keycloak-api-manager/blob/main/OIDC_MIGRATION_PLAN.md
+- **Middleware Integration Report:** See keycloak-express-middleware/DETAILED_INTEGRATION_REPORT.md
+
+### Deprecation Timeline
+
+| Version | Status | Notes |
+|---------|--------|-------|
+| v5.0.8  | Supported | Last version with working OIDC methods |
+| v6.0.0  | Deprecated | Methods work but marked @deprecated |
+| v7.0.0  | Removed | OIDC methods will be permanently removed |
+
+**Action Required:** Migrate to keycloak-express-middleware before v7.0.0 is released.
+
+## Related Documentation
+
+- [loginPKCE() API Reference](../api/configuration.md#loginpkce)
+- [login() API Reference](../api/configuration.md#login)
+- [OAuth2 PKCE Specification](https://tools.ietf.org/html/rfc7636)
+- [Keycloak Authorization Code Flow](https://www.keycloak.org/docs/latest/server_admin/#_oidc)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "keycloak-api-manager",
-  "version": "6.0.0",
+  "version": "6.0.1",
   "description": "Enhanced Node.js wrapper for Keycloak Admin REST API. Professional alternative to @keycloak/keycloak-admin-client with advanced features, bug fixes, automatic token refresh, Organizations API support, fine-grained permissions, and comprehensive resource management. Battle-tested with 113+ integration tests.",
   "main": "index.js",
   "scripts": {

package/test-output.log

@@ -1,72 +0,0 @@
-
-> keycloak-api-manager@4.1.0 test
-> npm --prefix test install && npm --prefix test test
-
-
-up to date, audited 260 packages in 2s
-
-48 packages are looking for funding
-  run `npm fund` for details
-
-12 vulnerabilities (3 low, 3 moderate, 4 high, 2 critical)
-
-To address all issues possible (including breaking changes), run:
-  npm audit fix --force
-
-Some issues need review, and may require choosing
-a different dependency.
-
-Run `npm audit` for details.
-
-> keycloak-api-manager-tests@1.0.0 test
-> NODE_ENV=test NODE_PATH=./node_modules mocha --exit
-
-
- Exception during run: /Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/Handlers/userProfileHandler.js:79
-        body: JSON.strasync function(filter) {
-                            ^^^^^^^^
-
-SyntaxError: Unexpected token 'function'
-    at wrapSafe (node:internal/modules/cjs/loader:1515:18)
-    at Module._compile (node:internal/modules/cjs/loader:1537:20)
-    at Object..js (node:internal/modules/cjs/loader:1708:10)
-    at Module.load (node:internal/modules/cjs/loader:1318:32)
-    at Function._load (node:internal/modules/cjs/loader:1128:12)
-    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
-    at wrapModuleLoad (node:internal/modules/cjs/loader:219:24)
-    at Module.require (node:internal/modules/cjs/loader:1340:12)
-    at require (node:internal/modules/helpers:138:16)
-    at Object.<anonymous> (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/index.js:15:24)
-    at Module._compile (node:internal/modules/cjs/loader:1565:14)
-    at Object..js (node:internal/modules/cjs/loader:1708:10)
-    at Module.load (node:internal/modules/cjs/loader:1318:32)
-    at Function._load (node:internal/modules/cjs/loader:1128:12)
-    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
-    at wrapModuleLoad (node:internal/modules/cjs/loader:219:24)
-    at Module.require (node:internal/modules/cjs/loader:1340:12)
-    at require (node:internal/modules/helpers:138:16)
-    at Object.<anonymous> (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/enableServerFeatures.js:47:25)
-    at Module._compile (node:internal/modules/cjs/loader:1565:14)
-    at Object..js (node:internal/modules/cjs/loader:1708:10)
-    at Module.load (node:internal/modules/cjs/loader:1318:32)
-    at Function._load (node:internal/modules/cjs/loader:1128:12)
-    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
-    at wrapModuleLoad (node:internal/modules/cjs/loader:219:24)
-    at Module.require (node:internal/modules/cjs/loader:1340:12)
-    at require (node:internal/modules/helpers:138:16)
-    at Object.<anonymous> (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/setup.js:29:30)
-    at Module._compile (node:internal/modules/cjs/loader:1565:14)
-    at Object..js (node:internal/modules/cjs/loader:1708:10)
-    at Module.load (node:internal/modules/cjs/loader:1318:32)
-    at Function._load (node:internal/modules/cjs/loader:1128:12)
-    at TracingChannel.traceSync (node:diagnostics_channel:322:14)
-    at wrapModuleLoad (node:internal/modules/cjs/loader:219:24)
-    at cjsLoader (node:internal/modules/esm/translators:263:5)
-    at ModuleWrap.<anonymous> (node:internal/modules/esm/translators:196:7)
-    at ModuleJob.run (node:internal/modules/esm/module_job:271:25)
-    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:547:26)
-    at async formattedImport (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/node_modules/mocha/lib/nodejs/esm-utils.js:9:14)
-    at async exports.requireOrImport (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/node_modules/mocha/lib/nodejs/esm-utils.js:42:28)
-    at async exports.loadFilesAsync (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/node_modules/mocha/lib/nodejs/esm-utils.js:100:20)
-    at async singleRun (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/node_modules/mocha/lib/cli/run-helpers.js:162:3)
-    at async exports.handler (/Users/Alessandro/Src/WorkSpace/WorkspaceDemo/Idealia/Keyclock/keycloak-api-manager/test/node_modules/mocha/lib/cli/run.js:375:5)