rhdh-e2e-test-utils 1.1.5 → 1.1.7

package/README.md

@@ -1,1170 +1,6 @@
 # rhdh-e2e-test-utils
 
-A comprehensive test utility package for Red Hat Developer Hub (RHDH) end-to-end testing. This package provides a unified framework for deploying RHDH instances, running Playwright tests, and managing Kubernetes resources in OpenShift environments.
+Documentation is available online:
 
-## Table of Contents
-
-- [Overview](#overview)
-- [Features](#features)
-- [Installation](#installation)
-- [Requirements](#requirements)
-- [Package Exports](#package-exports)
-- [Quick Start](#quick-start)
-- [Detailed Usage](#detailed-usage)
-  - [Playwright Test Fixtures](#playwright-test-fixtures)
-  - [Playwright Configuration](#playwright-configuration)
-  - [Global Setup](#global-setup)
-  - [RHDH Deployment](#rhdh-deployment)
-  - [Keycloak Deployment](#keycloak-deployment)
-  - [Utilities](#utilities)
-  - [Helpers](#helpers)
-  - [Page Objects](#page-objects)
-  - [ESLint Configuration](#eslint-configuration)
-  - [TypeScript Configuration](#typescript-configuration)
-- [Configuration Files](#configuration-files)
-- [Environment Variables](#environment-variables)
-- [Examples](#examples)
-- [Development](#development)
-  - [Testing Local Changes in Consumer Projects](#testing-local-changes-in-consumer-projects)
-
-## Overview
-
-`rhdh-e2e-test-utils` simplifies end-to-end testing for RHDH plugins by providing:
-
-- **Automated RHDH Deployment**: Deploy RHDH instances via Helm or the RHDH Operator
-- **Keycloak Integration**: Deploy and configure Keycloak for OIDC authentication testing
-- **Modular Auth Configuration**: Switch between guest and Keycloak authentication with a single option
-- **Playwright Integration**: Custom test fixtures that manage deployment lifecycle
-- **Kubernetes Utilities**: Helper functions for managing namespaces, ConfigMaps, Secrets, and Routes
-- **Configuration Merging**: YAML merging with environment variable substitution
-- **Standardized ESLint Rules**: Pre-configured linting for Playwright tests
-
-## Features
-
-- Deploy RHDH using Helm charts or the RHDH Operator
-- Deploy Keycloak for authentication testing with automatic realm, client, and user configuration
-- Modular authentication configuration (guest, Keycloak)
-- Automatic namespace creation and cleanup
-- Dynamic plugin configuration
-- Helpers for UI, API and common Utils
-- Kubernetes client helper for OpenShift resources
-- Pre-configured Playwright settings optimized for RHDH testing
-- ESLint configuration with Playwright and TypeScript best practices
-
-## Installation
-
-```bash
-npm install rhdh-e2e-test-utils
-```
-
-Or directly from GitHub:
-
-```bash
-npm install github:redhat-developer/rhdh-e2e-test-utils#main
-```
-
-## Requirements
-
-### System Requirements
-
-- **Node.js**: >= 22
-- **Yarn**: >= 3 (this project uses Yarn 3 with Corepack)
-
-### OpenShift Cluster
-
-You must be logged into an OpenShift cluster with sufficient permissions to:
-
-- Create and delete namespaces
-- Create ConfigMaps and Secrets
-- Install Helm charts or use the RHDH Operator
-- Read cluster ingress configuration
-
-## Package Exports
-
-The package provides multiple entry points for different use cases:
-
-| Export Path | Description |
-|-------------|-------------|
-| `rhdh-e2e-test-utils/test` | Playwright test fixtures with RHDH deployment |
-| `rhdh-e2e-test-utils/playwright-config` | Base Playwright configuration |
-| `rhdh-e2e-test-utils/rhdh` | RHDH deployment class and types |
-| `rhdh-e2e-test-utils/keycloak` | Keycloak deployment helper for authentication testing |
-| `rhdh-e2e-test-utils/utils` | Utility functions (bash, YAML, Kubernetes) |
-| `rhdh-e2e-test-utils/helpers` | UI, API, and login helper classes |
-| `rhdh-e2e-test-utils/pages` | Page object classes for common RHDH pages |
-| `rhdh-e2e-test-utils/eslint` | ESLint configuration factory |
-| `rhdh-e2e-test-utils/tsconfig` | Base TypeScript configuration |
-
-## Quick Start
-
-### 1. Set Up Your E2E Test Project
-
-```bash
-mkdir e2e-tests && cd e2e-tests
-yarn init -y
-yarn add @playwright/test rhdh-e2e-test-utils
-```
-
-### 2. Create Playwright Configuration
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "rhdh-e2e-test-utils/playwright-config";
-
-export default defineConfig({
-  projects: [
-    {
-      name: "my-plugin",
-    },
-  ],
-});
-```
-
-### 3. Create Your Test
-
-```typescript
-// tests/my-plugin.spec.ts
-import { test, expect } from "rhdh-e2e-test-utils/test";
-
-test.beforeAll(async ({ rhdh }) => {
-  await rhdh.deploy();
-});
-
-test("my plugin test", async ({ page }) => {
-  await page.goto("/");
-  await expect(page).toHaveTitle(/Red Hat Developer Hub/);
-});
-```
-
-### 4. Create Configuration Files
-
-Create a `tests/config/` directory with your RHDH configuration:
-
-```
-tests/config/
-├── app-config-rhdh.yaml    # App configuration
-├── dynamic-plugins.yaml     # Dynamic plugins configuration
-└── rhdh-secrets.yaml        # Secrets (with env var placeholders)
-```
-
-### 5. Set Environment Variables
-
-```bash
-export RHDH_VERSION="1.5"              # RHDH version
-export INSTALLATION_METHOD="helm"       # "helm" or "operator"
-```
-
-### 6. Run Tests
-
-```bash
-yarn playwright test
-```
-
-## Detailed Usage
-
-### Playwright Test Fixtures
-
-The package extends Playwright's test with RHDH-specific fixtures:
-
-```typescript
-import { test, expect } from "rhdh-e2e-test-utils/test";
-```
-
-#### Available Fixtures
-
-| Fixture | Scope | Description |
-|---------|-------|-------------|
-| `rhdh` | worker | Shared RHDHDeployment across all tests in a worker |
-| `uiHelper` | test | UIhelper instance for common UI interactions |
-| `loginHelper` | test | LoginHelper instance for authentication flows |
-| `baseURL` | test | Automatically set to the RHDH instance URL |
-
-#### Fixture Behavior
-
-- **Automatic Namespace**: The namespace is derived from the Playwright project name
-- **Auto-cleanup**: In CI environments, namespaces are automatically deleted after tests
-- **Shared Deployment**: All tests in a worker share the same RHDH deployment
-
-```typescript
-import { test, expect } from "rhdh-e2e-test-utils/test";
-
-test.beforeAll(async ({ rhdh }) => {
-  // Configure RHDH (creates namespace, and optional DeploymentOptions)
-  await rhdh.configure();
-
-  // Perform any pre-deployment setup
-  // ...
-
-  // Deploy RHDH
-  await rhdh.deploy();
-});
-
-test("example test", async ({ page, rhdh, uiHelper, loginHelper }) => {
-  // page.goto("/") will use rhdh.rhdhUrl as base
-  await page.goto("/");
-
-  // Login as guest user
-  await loginHelper.loginAsGuest();
-
-  // Use UI helper for common interactions
-  await uiHelper.verifyHeading("Welcome");
-  await uiHelper.clickButton("Get Started");
-
-  // Access deployment info
-  console.log(`Namespace: ${rhdh.deploymentConfig.namespace}`);
-  console.log(`URL: ${rhdh.rhdhUrl}`);
-
-  // Perform any deployment/config update
-  // ...
-  await rhdh.rolloutRestart();
-  // ...
-});
-```
-
-### Playwright Configuration
-
-Use `defineConfig` for sensible defaults:
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "rhdh-e2e-test-utils/playwright-config";
-
-export default defineConfig({
-  projects: [
-    {
-      name: "tech-radar",  // Also used as namespace
-    },
-    {
-      name: "catalog",
-    },
-  ],
-});
-```
-
-#### Base Configuration Defaults
-
-| Setting | Value |
-|---------|-------|
-| `testDir` | `./tests` |
-| `timeout` | 90,000ms |
-| `retries` | 2 in CI, 0 locally |
-| `workers` | 50% of CPUs |
-| `viewport` | 1920x1080 |
-| `video` | Always on |
-| `trace` | Retain on failure |
-| `screenshot` | Only on failure |
-
-#### Global Setup
-
-The package includes a global setup function that runs once before all tests. It performs the following:
-
-1. **Binary Check**: Verifies that required binaries (`oc`, `kubectl`, `helm`) are installed
-2. **Cluster Router Base**: Fetches the OpenShift ingress domain and sets `K8S_CLUSTER_ROUTER_BASE`
-3. **Keycloak Deployment**: Automatically deploys and configures Keycloak for OIDC authentication
-
-```typescript
-// playwright.config.ts
-import { defineConfig } from "rhdh-e2e-test-utils/playwright-config";
-
-export default defineConfig({
-  // Global setup is automatically included
-  projects: [{ name: "my-plugin" }],
-});
-```
-
-**Keycloak Auto-Deployment Behavior:**
-
-- Keycloak is deployed to the `rhdh-keycloak` namespace
-- If Keycloak is already running, deployment is skipped
-- All Keycloak environment variables are automatically set after deployment
-- The following test credentials are created:
-  - Username: `test1`, Password: `test1@123`
-  - Username: `test2`, Password: `test2@123`
-
-**Skip Keycloak Deployment:**
-
-If your tests don't require Keycloak/OIDC authentication, set the environment variable:
-
-```bash
-SKIP_KEYCLOAK_DEPLOYMENT=true yarn playwright test
-```
-
-### RHDH Deployment
-
-#### RHDHDeployment Class
-
-The core class for managing RHDH deployments:
-
-```typescript
-import { RHDHDeployment } from "rhdh-e2e-test-utils/rhdh";
-
-// Create deployment with namespace (required)
-const deployment = new RHDHDeployment("my-test-namespace");
-
-// Configure with options (call before deploy)
-await deployment.configure({
-  version: "1.5",                              // Optional, uses RHDH_VERSION env
-  method: "helm",                              // Optional, uses INSTALLATION_METHOD env
-  auth: "keycloak",                            // Optional, defaults to "keycloak"
-  appConfig: "config/app-config-rhdh.yaml",    // Optional
-  secrets: "config/rhdh-secrets.yaml",         // Optional
-  dynamicPlugins: "config/dynamic-plugins.yaml", // Optional
-  valueFile: "config/value_file.yaml",         // Optional & Helm only
-  subscription: "config/subscription.yaml",    // Optional & Operator only
-});
-
-// Deploy RHDH
-await deployment.deploy();
-```
-
-#### Deployment Options
-
-```typescript
-type DeploymentOptions = {
-  namespace?: string;             // Kubernetes namespace (set via constructor)
-  version?: string;               // RHDH version (e.g., "1.5", "1.5.1-CI")
-  method?: "helm" | "operator";   // Installation method
-  auth?: "guest" | "keycloak";    // Authentication provider (default: "keycloak")
-  appConfig?: string;             // Path to app-config YAML
-  secrets?: string;               // Path to secrets YAML
-  dynamicPlugins?: string;        // Path to dynamic-plugins YAML
-  valueFile?: string;             // Helm values file (helm only)
-  subscription?: string;          // Backstage CR file (operator only)
-};
-```
-
-#### Authentication Providers
-
-The package supports modular authentication configuration. Set the `auth` option to automatically include the appropriate auth-specific configurations:
-
-| Provider | Description |
-|----------|-------------|
-| `guest` | Guest authentication for development/testing |
-| `keycloak` | OIDC authentication via Keycloak (default) |
-
-Auth-specific configurations are automatically merged with your project configurations. For Keycloak authentication, see [Keycloak Deployment](#keycloak-deployment).
-
-#### Deployment Methods
-
-##### Helm Deployment
-
-```typescript
-const rhdh = new RHDHDeployment({
-  namespace: "my-plugin-tests",
-  method: "helm",
-  valueFile: "config/value_file.yaml",
-});
-
-await rhdh.deploy();
-```
-
-##### Operator Deployment
-
-```typescript
-const rhdh = new RHDHDeployment({
-  namespace: "my-plugin-tests",
-  method: "operator",
-  subscription: "config/subscription.yaml",
-});
-
-await rhdh.deploy();
-```
-
-#### RHDHDeployment API
-
-| Method | Description |
-|--------|-------------|
-| `configure(options?)` | Create namespace and prepare for deployment |
-| `deploy()` | Full deployment (configs, secrets, plugins, RHDH) |
-| `waitUntilReady(timeout?)` | Wait for deployment to be ready |
-| `rolloutRestart()` | Restart the RHDH deployment |
-| `teardown()` | Delete the namespace and all resources |
-
-#### Properties
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `rhdhUrl` | `string` | The RHDH instance URL |
-| `deploymentConfig` | `DeploymentConfig` | Current deployment configuration |
-| `k8sClient` | `KubernetesClientHelper` | Kubernetes client instance |
-
-### Keycloak Deployment
-
-The package provides a `KeycloakHelper` class for deploying and configuring Keycloak in OpenShift, enabling OIDC authentication testing with RHDH.
-
-#### KeycloakHelper Class
-
-```typescript
-import { KeycloakHelper } from "rhdh-e2e-test-utils/keycloak";
-
-const keycloak = new KeycloakHelper({
-  namespace: "rhdh-keycloak",     // Optional, defaults to "rhdh-keycloak"
-  releaseName: "keycloak",        // Optional, defaults to "keycloak"
-  adminUser: "admin",             // Optional, defaults to "admin"
-  adminPassword: "admin123",      // Optional, defaults to "admin123"
-});
-
-// Deploy Keycloak using Bitnami Helm chart
-await keycloak.deploy();
-
-// Configure realm, client, groups, and users for RHDH
-await keycloak.configureForRHDH();
-```
-
-#### Deployment Options
-
-```typescript
-type KeycloakDeploymentOptions = {
-  namespace?: string;       // Kubernetes namespace (default: "rhdh-keycloak")
-  releaseName?: string;     // Helm release name (default: "keycloak")
-  valuesFile?: string;      // Custom Helm values file
-  adminUser?: string;       // Admin username (default: "admin")
-  adminPassword?: string;   // Admin password (default: "admin123")
-};
-```
-
-#### KeycloakHelper API
-
-| Method | Description |
-|--------|-------------|
-| `deploy()` | Deploy Keycloak using Helm and wait for it to be ready |
-| `configureForRHDH(options?)` | Configure realm, client, groups, and users for RHDH |
-| `isRunning()` | Check if Keycloak is accessible |
-| `connect(config)` | Connect to an existing Keycloak instance |
-| `createRealm(config)` | Create a new realm |
-| `createClient(realm, config)` | Create a client in a realm |
-| `createGroup(realm, config)` | Create a group in a realm |
-| `createUser(realm, config)` | Create a user with optional group membership |
-| `getUsers(realm)` | Get all users in a realm |
-| `getGroups(realm)` | Get all groups in a realm |
-| `deleteUser(realm, username)` | Delete a user |
-| `deleteGroup(realm, groupName)` | Delete a group |
-| `deleteRealm(realm)` | Delete a realm |
-| `teardown()` | Delete the Keycloak namespace |
-| `waitUntilReady(timeout?)` | Wait for Keycloak StatefulSet to be ready |
-
-#### Properties
-
-| Property | Type | Description |
-|----------|------|-------------|
-| `keycloakUrl` | `string` | The Keycloak instance URL |
-| `realm` | `string` | Configured realm name |
-| `clientId` | `string` | Configured client ID |
-| `clientSecret` | `string` | Configured client secret |
-| `deploymentConfig` | `KeycloakDeploymentConfig` | Current deployment configuration |
-| `k8sClient` | `KubernetesClientHelper` | Kubernetes client instance |
-
-#### Default Configuration
-
-When using `configureForRHDH()`, the following defaults are applied:
-
-**Default Realm**: `rhdh`
-
-**Default Client** (`rhdh-client`):
-- Client secret: `rhdh-client-secret`
-- Standard flow, implicit flow, direct access grants enabled
-- Service accounts enabled with realm-management roles
-
-**Default Groups**:
-- `developers`
-- `admins`
-- `viewers`
-
-**Default Users**:
-| Username | Password | Groups |
-|----------|----------|--------|
-| `test1` | `test1@123` | developers |
-| `test2` | `test2@123` | developers |
-
-#### Example: Full RHDH + Keycloak Setup
-
-```typescript
-import { test } from "rhdh-e2e-test-utils/test";
-import { KeycloakHelper } from "rhdh-e2e-test-utils/keycloak";
-
-let keycloak: KeycloakHelper;
-
-test.beforeAll(async ({ rhdh }) => {
-  // Deploy Keycloak
-  keycloak = new KeycloakHelper({ namespace: "rhdh-keycloak" });
-  await keycloak.deploy();
-  await keycloak.configureForRHDH();
-
-  // Set environment variables for RHDH
-  process.env.KEYCLOAK_BASE_URL = keycloak.keycloakUrl;
-  process.env.KEYCLOAK_REALM = keycloak.realm;
-  process.env.KEYCLOAK_CLIENT_ID = keycloak.clientId;
-  process.env.KEYCLOAK_CLIENT_SECRET = keycloak.clientSecret;
-  process.env.KEYCLOAK_METADATA_URL = `${keycloak.keycloakUrl}/realms/${keycloak.realm}/.well-known/openid-configuration`;
-  process.env.KEYCLOAK_LOGIN_REALM = keycloak.realm;
-
-  // Deploy RHDH with Keycloak authentication
-  await rhdh.configure({ auth: "keycloak" });
-  await rhdh.deploy();
-});
-
-test("login with Keycloak user", async ({ page, loginHelper }) => {
-  await page.goto("/");
-  await loginHelper.loginAsKeycloakUser("test1", "test1@123");
-  // ... test assertions
-});
-
-test.afterAll(async () => {
-  await keycloak.teardown();
-});
-```
-
-#### Connect to Existing Keycloak
-
-```typescript
-import { KeycloakHelper } from "rhdh-e2e-test-utils/keycloak";
-
-const keycloak = new KeycloakHelper();
-
-// Connect with admin credentials
-await keycloak.connect({
-  baseUrl: "https://keycloak.example.com",
-  username: "admin",
-  password: "admin-password",
-});
-
-// Or connect with client credentials
-await keycloak.connect({
-  baseUrl: "https://keycloak.example.com",
-  realm: "my-realm",
-  clientId: "admin-client",
-  clientSecret: "client-secret",
-});
-
-// Now you can manage users, groups, etc.
-await keycloak.createUser("my-realm", {
-  username: "newuser",
-  password: "password123",
-  groups: ["developers"],
-});
-```
-
-### Utilities
-
-#### Bash Command Execution
-
-Execute shell commands using `zx`:
-
-```typescript
-import { $ } from "rhdh-e2e-test-utils/utils";
-
-// Execute commands
-await $`oc get pods -n my-namespace`;
-
-// With variables
-const namespace = "my-namespace";
-await $`oc get pods -n ${namespace}`;
-
-// Capture output
-const result = await $`oc get pods -o json`;
-console.log(result.stdout);
-```
-
-#### Kubernetes Client Helper
-
-```typescript
-import { KubernetesClientHelper } from "rhdh-e2e-test-utils/utils";
-
-const k8sClient = new KubernetesClientHelper();
-
-// Create namespace
-await k8sClient.createNamespaceIfNotExists("my-namespace");
-
-// Apply ConfigMap from object
-await k8sClient.applyConfigMapFromObject(
-  "my-config",
-  { key: "value" },
-  "my-namespace"
-);
-
-// Apply Secret from object
-await k8sClient.applySecretFromObject(
-  "my-secret",
-  { stringData: { TOKEN: "secret-value" } },
-  "my-namespace"
-);
-
-// Get route URL
-const url = await k8sClient.getRouteLocation("my-namespace", "my-route");
-
-// Get cluster ingress domain
-const domain = await k8sClient.getClusterIngressDomain();
-
-// Delete namespace
-await k8sClient.deleteNamespace("my-namespace");
-```
-
-#### Environment Variable Substitution
-
-```typescript
-import { envsubst } from "rhdh-e2e-test-utils/utils";
-
-// Simple substitution
-const result = envsubst("Hello $USER");
-
-// With default values
-const result = envsubst("Port: ${PORT:-8080}");
-
-// With braces
-const result = envsubst("API: ${API_URL}");
-```
-
-### Helpers
-
-The package provides helper classes for common testing operations.
-
-#### UIhelper
-
-A utility class for common UI interactions with Material-UI components:
-
-```typescript
-import { UIhelper } from "rhdh-e2e-test-utils/helpers";
-
-const uiHelper = new UIhelper(page);
-
-// Wait for page to fully load
-await uiHelper.waitForLoad();
-
-// Verify headings and text
-await uiHelper.verifyHeading("Welcome to RHDH");
-await uiHelper.verifyText("Some content");
-
-// Button interactions
-await uiHelper.clickButton("Submit");
-await uiHelper.clickButtonByLabel("Close");
-
-// Navigation
-await uiHelper.openSidebar("Catalog");
-await uiHelper.clickTab("Overview");
-
-// Table operations
-await uiHelper.verifyRowsInTable(["row1", "row2"]);
-await uiHelper.verifyCellsInTable(["cell1", "cell2"]);
-
-// MUI component interactions
-await uiHelper.selectMuiBox("Kind", "Component");
-await uiHelper.fillTextInputByLabel("Name", "my-component");
-```
-
-#### LoginHelper
-
-Handles authentication flows for different providers:
-
-```typescript
-import { LoginHelper } from "rhdh-e2e-test-utils/helpers";
-
-const loginHelper = new LoginHelper(page);
-
-// Guest authentication
-await loginHelper.loginAsGuest();
-await loginHelper.signOut();
-
-// Keycloak authentication
-await loginHelper.loginAsKeycloakUser("username", "password");
-
-// GitHub authentication (requires environment variables)
-await loginHelper.loginAsGithubUser();
-```
-
-#### APIHelper
-
-Provides utilities for API interactions with both GitHub and Backstage catalog:
-
-```typescript
-import { APIHelper } from "rhdh-e2e-test-utils/helpers";
-
-// GitHub API operations
-await APIHelper.createGitHubRepo("owner", "repo-name");
-await APIHelper.deleteGitHubRepo("owner", "repo-name");
-const prs = await APIHelper.getGitHubPRs("owner", "repo", "open");
-
-// Backstage catalog API operations
-const apiHelper = new APIHelper();
-await apiHelper.setBaseUrl(rhdhUrl);
-await apiHelper.setStaticToken(token);
-
-const users = await apiHelper.getAllCatalogUsersFromAPI();
-const groups = await apiHelper.getAllCatalogGroupsFromAPI();
-const locations = await apiHelper.getAllCatalogLocationsFromAPI();
-
-// Schedule entity refresh
-await apiHelper.scheduleEntityRefreshFromAPI("my-component", "component", token);
-```
-
-#### setupBrowser
-
-Utility function for setting up a shared browser context with video recording. Use this in `test.beforeAll` for serial test suites or when you want to persist the browser context across multiple tests (e.g., to avoid repeated logins):
-
-```typescript
-import { test } from "@playwright/test";
-import { setupBrowser, LoginHelper } from "rhdh-e2e-test-utils/helpers";
-import type { Page, BrowserContext } from "@playwright/test";
-
-test.describe.configure({ mode: "serial" });
-
-let page: Page;
-let context: BrowserContext;
-
-test.beforeAll(async ({ browser }, testInfo) => {
-  // Setup shared browser context with video recording
-  ({ page, context } = await setupBrowser(browser, testInfo));
-
-  // Login once, session persists across all tests in this suite
-  const loginHelper = new LoginHelper(page);
-  await page.goto("/");
-  await loginHelper.loginAsKeycloakUser();
-});
-
-test.afterAll(async () => {
-  await context.close();
-});
-
-test("first test - already logged in", async () => {
-  await page.goto("/catalog");
-  // No need to login again
-});
-
-test("second test - session persists", async () => {
-  await page.goto("/settings");
-  // Still logged in from beforeAll
-});
-```
-
-### Page Objects
-
-Pre-built page object classes for common RHDH pages:
-
-```typescript
-import {
-  CatalogPage,
-  HomePage,
-  CatalogImportPage,
-  ExtensionsPage,
-  NotificationPage,
-} from "rhdh-e2e-test-utils/pages";
-```
-
-#### CatalogPage
-
-```typescript
-const catalogPage = new CatalogPage(page);
-
-// Navigate to catalog
-await catalogPage.go();
-
-// Search for entities
-await catalogPage.search("my-component");
-
-// Navigate to specific component
-await catalogPage.goToByName("my-component");
-```
-
-#### HomePage
-
-```typescript
-const homePage = new HomePage(page);
-
-// Verify quick search functionality
-await homePage.verifyQuickSearchBar("search-term");
-
-// Verify quick access sections
-await homePage.verifyQuickAccess("Favorites", "My Component");
-```
-
-#### CatalogImportPage
-
-```typescript
-const catalogImportPage = new CatalogImportPage(page);
-
-// Register or refresh an existing component
-const wasAlreadyRegistered = await catalogImportPage.registerExistingComponent(
-  "https://github.com/org/repo/blob/main/catalog-info.yaml"
-);
-
-// Analyze a component URL
-await catalogImportPage.analyzeComponent("https://github.com/org/repo/blob/main/catalog-info.yaml");
-
-// Inspect entity and verify YAML content
-await catalogImportPage.inspectEntityAndVerifyYaml("kind: Component");
-```
-
-#### ExtensionsPage
-
-```typescript
-const extensionsPage = new ExtensionsPage(page);
-
-// Filter by support type
-await extensionsPage.selectSupportTypeFilter("Red Hat");
-
-// Verify plugin details
-await extensionsPage.verifyPluginDetails({
-  pluginName: "Topology",
-  badgeLabel: "Red Hat support",
-  badgeText: "Red Hat",
-});
-
-// Search and verify results
-await extensionsPage.waitForSearchResults("catalog");
-```
-
-#### NotificationPage
-
-```typescript
-const notificationPage = new NotificationPage(page);
-
-// Navigate to notifications
-await notificationPage.clickNotificationsNavBarItem();
-
-// Check notification content
-await notificationPage.notificationContains("Build completed");
-
-// Manage notifications
-await notificationPage.markAllNotificationsAsRead();
-await notificationPage.selectSeverity("critical");
-await notificationPage.viewSaved();
-await notificationPage.sortByNewestOnTop();
-```
-
-### ESLint Configuration
-
-Pre-configured ESLint rules for Playwright tests:
-
-```javascript
-// eslint.config.js
-import { createEslintConfig } from "rhdh-e2e-test-utils/eslint";
-
-export default createEslintConfig(import.meta.dirname);
-```
-
-
-### TypeScript Configuration
-
-Extend the base tsconfig:
-
-```json
-{
-  "extends": "rhdh-e2e-test-utils/tsconfig",
-  "include": ["tests/**/*.ts"]
-}
-```
-
-## Configuration Files
-
-### Default Configuration Structure
-
-The package includes default configurations organized in a modular structure:
-
-```
-src/deployment/rhdh/config/
-├── common/                       # Base configurations (always applied)
-│   ├── app-config-rhdh.yaml      # Base app configuration
-│   ├── dynamic-plugins.yaml      # Default dynamic plugins
-│   └── rhdh-secrets.yaml         # Base secrets template
-├── auth/                         # Auth-specific configurations
-│   ├── guest/
-│   │   └── app-config.yaml       # Guest auth configuration
-│   └── keycloak/
-│       ├── app-config.yaml       # Keycloak OIDC configuration
-│       ├── dynamic-plugins.yaml  # Keycloak-specific plugins
-│       └── secrets.yaml          # Keycloak secrets template
-├── helm/
-│   └── value_file.yaml           # Default Helm values
-└── operator/
-    └── subscription.yaml         # Default Backstage CR
-```
-
-### Configuration Merging
-
-Configurations are merged in the following order (later overrides earlier):
-
-1. **Common configs** (`config/common/`) - Base configurations
-2. **Auth configs** (`config/auth/{provider}/`) - Auth-provider-specific configurations
-3. **Project configs** (`tests/config/`) - Your project's custom configurations
-
-This allows you to use built-in defaults while only overriding what you need.
-
-### Project Configuration
-
-Create these files in your project's `tests/config/` directory:
-
-#### app-config-rhdh.yaml
-
-```yaml
-app:
-  title: My RHDH Test Instance
-
-backend:
-  reading:
-    allow:
-      - host: ${MY_BACKEND_HOST}
-
-# Plugin-specific config
-techRadar:
-  url: "http://${DATA_SOURCE_URL}/tech-radar"
-
-# Note: Auth configuration is automatically included based on the 'auth' option
-# You only need to add auth config here if you want to override the defaults
-```
-
-#### dynamic-plugins.yaml
-
-```yaml
-includes:
-  - dynamic-plugins.default.yaml
-
-plugins:
-  - package: ./dynamic-plugins/dist/my-frontend-plugin
-    disabled: false
-  - package: ./dynamic-plugins/dist/my-backend-plugin-dynamic
-    disabled: false
-```
-
-#### rhdh-secrets.yaml
-
-Secrets support environment variable substitution (`$VAR` or `${VAR}` syntax).
-
-```yaml
-apiVersion: v1
-kind: Secret
-metadata:
-  name: rhdh-secrets
-type: Opaque
-stringData:
-  GITHUB_TOKEN: $GITHUB_TOKEN
-  MY_API_KEY: $MY_API_KEY
-```
-
-- **Local development**: Define secrets in a `.env` file at your project root
-- **CI**: Set environment variables directly in your CI pipeline
-- **Runtime secrets**: Set `process.env.MY_SECRET` before calling `rhdh.deploy()`
-
-## Environment Variables
-
-### Required Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `RHDH_VERSION` | RHDH version to deploy (e.g., "1.5") |
-| `INSTALLATION_METHOD` | Deployment method ("helm" or "operator") |
-
-### Auto-Generated Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `K8S_CLUSTER_ROUTER_BASE` | OpenShift ingress domain (set by global setup) |
-| `RHDH_BASE_URL` | Full RHDH URL (set during deployment) |
-
-### Optional Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `CI` | If set, namespaces are auto-deleted after tests |
-| `CHART_URL` | Custom Helm chart URL (default: `oci://quay.io/rhdh/chart`) |
-| `SKIP_KEYCLOAK_DEPLOYMENT` | Set to `true` to skip automatic Keycloak deployment in global setup |
-
-### Keycloak Environment Variables (for `auth: "keycloak"`)
-
-When using Keycloak authentication, these environment variables are required:
-
-| Variable | Description |
-|----------|-------------|
-| `KEYCLOAK_BASE_URL` | Keycloak instance URL |
-| `KEYCLOAK_METADATA_URL` | OIDC metadata URL (e.g., `{KEYCLOAK_BASE_URL}/realms/{realm}/.well-known/openid-configuration`) |
-| `KEYCLOAK_CLIENT_ID` | OIDC client ID |
-| `KEYCLOAK_CLIENT_SECRET` | OIDC client secret |
-| `KEYCLOAK_REALM` | Keycloak realm name |
-| `KEYCLOAK_LOGIN_REALM` | Login realm (usually same as `KEYCLOAK_REALM`) |
-
-These are automatically set when using `KeycloakHelper.configureForRHDH()`. See [Keycloak Deployment](#keycloak-deployment) for details.
-
-
-## Examples
-
-### Custom Deployment Configuration
-
-```typescript
-import { test } from "rhdh-e2e-test-utils/test";
-
-test.beforeAll(async ({ rhdh }) => {
-  await rhdh.configure({
-    version: "1.5",
-    method: "helm",
-    auth: "keycloak",  // or "guest" for development
-    appConfig: "tests/config/app-config.yaml",
-    secrets: "tests/config/secrets.yaml",
-    dynamicPlugins: "tests/config/plugins.yaml",
-    valueFile: "tests/config/values.yaml",
-  });
-
-  await rhdh.deploy();
-});
-```
-
-### Guest Authentication (Development)
-
-```typescript
-import { test } from "rhdh-e2e-test-utils/test";
-
-test.beforeAll(async ({ rhdh }) => {
-  await rhdh.configure({ auth: "guest" });
-  await rhdh.deploy();
-});
-
-test("test with guest login", async ({ page, loginHelper }) => {
-  await page.goto("/");
-  await loginHelper.loginAsGuest();
-  // ... test assertions
-});
-```
-
-### Using Helpers and Page Objects
-
-```typescript
-import { test, expect } from "rhdh-e2e-test-utils/test";
-import { CatalogPage } from "rhdh-e2e-test-utils/pages";
-import { APIHelper } from "rhdh-e2e-test-utils/helpers";
-
-test.beforeAll(async ({ rhdh }) => {
-  await rhdh.deploy();
-});
-
-test("catalog interaction", async ({ page, uiHelper, loginHelper }) => {
-  // Login
-  await loginHelper.loginAsKeycloakUser();
-
-  // Use page object for catalog operations
-  const catalogPage = new CatalogPage(page);
-  await catalogPage.go();
-  await catalogPage.search("my-component");
-
-  // Use UI helper for assertions
-  await uiHelper.verifyRowsInTable(["my-component"]);
-});
-
-test("API operations", async ({ rhdh }) => {
-  // Create GitHub repo via API
-  await APIHelper.createGitHubRepo("my-org", "test-repo");
-
-  // Clean up
-  await APIHelper.deleteGitHubRepo("my-org", "test-repo");
-});
-```
-
-
-## Development
-
-### Setup
-
-This project uses Yarn 3 with Corepack. To get started:
-
-```bash
-# Enable Corepack (if not already enabled)
-corepack enable
-
-# Install dependencies
-yarn install
-
-# Build the project
-yarn build
-```
-
-### Available Scripts
-
-| Script | Description |
-|--------|-------------|
-| `yarn build` | Clean and build the TypeScript project |
-| `yarn check` | Run typecheck, lint, and prettier checks |
-| `yarn lint:check` | Check for ESLint issues |
-| `yarn lint:fix` | Auto-fix ESLint issues |
-| `yarn prettier:check` | Check code formatting |
-| `yarn prettier:fix` | Auto-fix code formatting |
-
-### Testing Local Changes in Consumer Projects
-
-When developing features or fixes in `rhdh-e2e-test-utils`, you can test your local changes in a consumer project (e.g., a plugin's e2e-tests) before publishing.
-
-#### 1. Build your local changes
-
-```bash
-cd /path/to/rhdh-e2e-test-utils
-yarn build
-```
-
-#### 2. Update the consumer project's package.json
-
-In your e2e-tests project, update the dependency to point to your local package using the `file:` protocol:
-
-```json
-"rhdh-e2e-test-utils": "file:/path/to/rhdh-e2e-test-utils"
-```
-
-Example:
-```json
-"rhdh-e2e-test-utils": "file:/Users/yourname/Documents/rhdh/rhdh-e2e-test-utils"
-```
-
-#### 3. Install dependencies in the consumer project
-
-```bash
-yarn install
-```
-
-#### 4. Run tests with NODE_PRESERVE_SYMLINKS
-
-When running tests with a local symlinked package, you **must** set the `NODE_PRESERVE_SYMLINKS` environment variable:
-
-```bash
-NODE_PRESERVE_SYMLINKS=1 yarn test
-NODE_PRESERVE_SYMLINKS=1 yarn test:headed
-NODE_PRESERVE_SYMLINKS=1 yarn test:ui
-```
-
-> **Why is NODE_PRESERVE_SYMLINKS needed?**
->
-> When using local packages via `file:` protocol, the package manager creates a symlink. Node.js follows symlinks by default and tries to resolve peer dependencies (like `@playwright/test`) from the original package location. This causes duplicate Playwright instances which fails with:
-> ```
-> Error: Requiring @playwright/test second time
-> ```
-> Setting `NODE_PRESERVE_SYMLINKS=1` tells Node.js to resolve dependencies from the symlink location (your project's `node_modules`) instead of the original package location.
-
-#### 5. Rebuild after making changes
-
-When you make further changes to `rhdh-e2e-test-utils`, rebuild before running tests:
-
-```bash
-cd /path/to/rhdh-e2e-test-utils
-yarn build
-```
-
-Then run your tests again in the consumer project (no need to reinstall).
-
-#### 6. Restore the published version
-
-After testing, restore the published version in the consumer project's `package.json`:
-
-```json
-"rhdh-e2e-test-utils": "^1.0.0"
-```
-
-Then run:
-```bash
-yarn install
-```
-
-You can now run tests normally without `NODE_PRESERVE_SYMLINKS`.
-
-### CI/CD
-
-The project includes GitHub Actions workflows:
-
-- **PR Build and Check**: Runs on pull requests to `main`. Executes linting, type checking, and build verification.
-- **Publish to NPM**: Manual workflow dispatch to publish the package to npm registry.
-
-## License
-
-Apache-2.0
+- Package documentation: https://redhat-developer.github.io/rhdh-e2e-test-utils/
+- Overlay testing documentation: https://redhat-developer.github.io/rhdh-e2e-test-utils/overlay/

package/dist/deployment/rhdh/deployment.d.ts

@@ -26,6 +26,11 @@ export declare class RHDHDeployment {
     waitUntilReady(timeout?: number): Promise<void>;
     teardown(): Promise<void>;
     private _resolveChartVersion;
+    /**
+     * Resolve the semantic version from the "next" tag by looking up the
+     * downstream image (rhdh-hub-rhel9) and finding tags with the same digest.
+     */
+    private _resolveVersionFromNextTag;
     private _buildDeploymentConfig;
     configure(deploymentOptions?: DeploymentOptions): Promise<void>;
     private _buildBaseUrl;

package/dist/deployment/rhdh/deployment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../../src/deployment/rhdh/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAgB1E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IAClB,SAAS,yBAAgC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;gBAE9B,SAAS,EAAE,MAAM;IAUvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBf,eAAe;YAgBf,aAAa;IAe3B;;;OAGG;YACW,0BAA0B;YAuC1B,oBAAoB;YAWpB,eAAe;YAmCf,mBAAmB;IA4B3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,cAAc,CAAC,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,oBAAoB;IA6BlC,OAAO,CAAC,sBAAsB;IAoCxB,SAAS,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../../src/deployment/rhdh/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAiB1E,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IAClB,SAAS,yBAAgC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,gBAAgB,CAAC;gBAE9B,SAAS,EAAE,MAAM;IAUvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;YAqBf,eAAe;YAgBf,aAAa;IAqB3B;;;OAGG;YACW,0BAA0B;YAuC1B,oBAAoB;YAWpB,eAAe;YAmCf,mBAAmB;IAiD3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAWrC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOpC,cAAc,CAAC,OAAO,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,oBAAoB;IAsClC;;;OAGG;YACW,0BAA0B;IAwCxC,OAAO,CAAC,sBAAsB;IAoCxB,SAAS,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAcrE,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,SAAS;CAMlB"}

package/dist/deployment/rhdh/deployment.js

@@ -5,6 +5,7 @@ import { test } from "@playwright/test";
 import { mergeYamlFilesIfExists, deepMerge } from "../../utils/merge-yamls.js";
 import { loadAndInjectPluginMetadata, generateDynamicPluginsConfigFromMetadata, } from "../../utils/plugin-metadata.js";
 import { envsubst } from "../../utils/common.js";
+import cloneDeepWith from "lodash.clonedeepwith";
 import fs from "fs-extra";
 import { DEFAULT_CONFIG_PATHS, AUTH_CONFIG_PATHS, CHART_URL, } from "./constants.js";
 export class RHDHDeployment {
@@ -51,7 +52,13 @@ export class RHDHDeployment {
             authConfig.secrets,
             this.deploymentConfig.secrets,
         ]);
-        await this.k8sClient.applySecretFromObject("rhdh-secrets", JSON.parse(envsubst(JSON.stringify(secretsYaml))), this.deploymentConfig.namespace);
+        // Use cloneDeepWith to substitute env vars in-place, avoiding JSON.parse issues
+        // with control characters in secrets (e.g., private keys with newlines)
+        const substituted = cloneDeepWith(secretsYaml, (value) => {
+            if (typeof value === "string")
+                return envsubst(value);
+        });
+        await this.k8sClient.applySecretFromObject("rhdh-secrets", substituted, this.deploymentConfig.namespace);
     }
     /**
      * Builds the merged dynamic plugins configuration.
@@ -117,9 +124,25 @@ export class RHDHDeployment {
         ]);
         this._logBoxen("Subscription", subscriptionObject);
         fs.writeFileSync(`/tmp/${this.deploymentConfig.namespace}-subscription.yaml`, yaml.dump(subscriptionObject));
+        const version = this.deploymentConfig.version;
+        const isSemanticVersion = /^\d+(\.\d+)?$/.test(version);
+        // Use main branch for non-semantic versions (e.g., "next", "latest")
+        const branch = isSemanticVersion ? `release-${version}` : "main";
+        // Build version argument based on version type
+        let versionArg;
+        if (isSemanticVersion) {
+            versionArg = `-v ${version}`;
+        }
+        else if (version === "next") {
+            versionArg = "--next";
+        }
+        else {
+            throw new Error(`Invalid RHDH version "${version}". Use semantic version (e.g., "1.5") or "next".`);
+        }
+        this._log(`Using operator branch: ${branch}, version arg: ${versionArg}`);
         await $ `
       set -e;
-      curl -s https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/release-${this.deploymentConfig.version}/.rhdh/scripts/install-rhdh-catalog-source.sh | bash -s -- -v ${this.deploymentConfig.version} --install-operator rhdh
+      curl -sf https://raw.githubusercontent.com/redhat-developer/rhdh-operator/refs/heads/${branch}/.rhdh/scripts/install-rhdh-catalog-source.sh | bash -s -- ${versionArg} --install-operator rhdh
 
       timeout 300 bash -c '
         while ! oc get crd/backstages.rhdh.redhat.com -n "${this.deploymentConfig.namespace}" >/dev/null 2>&1; do
@@ -165,33 +188,66 @@ export class RHDHDeployment {
         await this.k8sClient.deleteNamespace(this.deploymentConfig.namespace);
     }
     async _resolveChartVersion(version) {
-        // Semantic versions (e.g., 1.2)
-        if (/^(\d+(\.\d+)?)$/.test(version)) {
+        let resolvedVersion = version;
+        // Handle "next" tag by looking up the corresponding version from downstream image
+        if (version === "next") {
+            resolvedVersion = await this._resolveVersionFromNextTag();
+            this._log(`Resolved "next" tag to version: ${resolvedVersion}`);
+        }
+        // Semantic versions (e.g., 1.2, 1.10)
+        if (/^(\d+(\.\d+)?)$/.test(resolvedVersion)) {
             const response = await fetch("https://quay.io/api/v1/repository/rhdh/chart/tag/?onlyActiveTags=true&limit=600");
             if (!response.ok)
                 throw new Error(`Failed to fetch chart versions: ${response.statusText}`);
             const data = (await response.json());
             const matching = data.tags
                 .map((t) => t.name)
-                .filter((name) => name.startsWith(`${version}-`))
+                .filter((name) => name.startsWith(`${resolvedVersion}-`))
                 .sort((a, b) => a.localeCompare(b, undefined, { numeric: true }));
             const latest = matching.at(-1);
             if (!latest)
-                throw new Error(`No chart version found for ${version}`);
+                throw new Error(`No chart version found for ${resolvedVersion}`);
             return latest;
         }
         // CI build versions (e.g., 1.2.3-CI)
-        if (version.endsWith("CI"))
-            return version;
+        if (resolvedVersion.endsWith("CI"))
+            return resolvedVersion;
         throw new Error(`Invalid Helm chart version format: "${version}"`);
     }
+    /**
+     * Resolve the semantic version from the "next" tag by looking up the
+     * downstream image (rhdh-hub-rhel9) and finding tags with the same digest.
+     */
+    async _resolveVersionFromNextTag() {
+        // Fetch all active tags in a single API call
+        const response = await fetch("https://quay.io/api/v1/repository/rhdh/rhdh-hub-rhel9/tag/?onlyActiveTags=true&limit=75");
+        if (!response.ok) {
+            throw new Error(`Failed to fetch image tags: ${response.statusText}`);
+        }
+        // Use Record to avoid snake_case linting issues with Quay API response
+        const data = (await response.json());
+        // Find the "next" tag and get its digest
+        const nextTag = data.tags.find((t) => t["name"] === "next");
+        if (!nextTag) {
+            throw new Error('No "next" tag found in rhdh-hub-rhel9 repository');
+        }
+        const digest = nextTag["manifest_digest"];
+        this._log(`"next" tag digest: ${digest}`);
+        // Find semantic version tag (e.g., "1.10") with the same digest
+        const semanticVersionTag = data.tags.find((t) => t["manifest_digest"] === digest &&
+            /^\d+\.\d+$/.test(t["name"]));
+        if (!semanticVersionTag) {
+            throw new Error(`Could not find semantic version tag for "next" (digest: ${digest})`);
+        }
+        return semanticVersionTag["name"];
+    }
     _buildDeploymentConfig(input) {
-        const version = input.version ?? process.env.RHDH_VERSION;
-        const method = input.method ?? process.env.INSTALLATION_METHOD;
-        if (!version)
-            throw new Error("RHDH version is required");
-        if (!method)
-            throw new Error("Installation method (helm/operator) is required");
+        // Default to "next" if RHDH_VERSION not set
+        const version = input.version ?? process.env.RHDH_VERSION ?? "next";
+        // Default to "helm" if INSTALLATION_METHOD not set
+        const method = input.method ??
+            process.env.INSTALLATION_METHOD ??
+            "helm";
         const base = {
             version,
             namespace: input.namespace ?? this.deploymentConfig.namespace,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rhdh-e2e-test-utils",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "Test utilities for RHDH E2E tests",
   "license": "Apache-2.0",
   "type": "module",
@@ -74,6 +74,7 @@
     "@playwright/test": "^1.57.0",
     "@types/fs-extra": "^11.0.4",
     "@types/js-yaml": "^4.0.9",
+    "@types/lodash.clonedeepwith": "^4.5.9",
     "@types/lodash.mergewith": "^4.6.9",
     "@types/node": "^24.10.1"
   },
@@ -87,6 +88,7 @@
     "eslint-plugin-playwright": "^2.4.0",
     "fs-extra": "^11.3.2",
     "js-yaml": "^4.1.1",
+    "lodash.clonedeepwith": "^4.5.0",
     "lodash.mergewith": "^4.6.2",
     "otplib": "12.0.1",
     "prettier": "^3.7.4",