<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.mycompany</groupId>
    <artifactId>ecommerce-test-automation</artifactId>
    <version>1.0.0</version>
    <name>Sample E-Commerce Consumer Test Project</name>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <thread.count>2</thread.count>
        <aspectj.version>1.9.22</aspectj.version>
        <allure.version>2.27.0</allure.version>
    </properties>

    <repositories>
        <!-- Pre-bundled local repository: Zero GitHub auth or settings.xml required -->
        <repository>
            <id>healqa-local-repo</id>
            <name>HealQA Embedded Core Repository</name>
            <url>file://${project.basedir}/.repo</url>
            <releases>
                <enabled>true</enabled>
                <checksumPolicy>ignore</checksumPolicy>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>

    <dependencies>
        <!-- AI-Powered Automation Framework Core SDK Dependency -->
        <dependency>
            <groupId>com.automation</groupId>
            <artifactId>ai-automation-core</artifactId>
            <version>1.0.0</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <release>17</release>
                </configuration>
            </plugin>
            <!-- Maven Surefire with AspectJ for AI Healing -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.2.5</version>
                <configuration>
                    <testFailureIgnore>true</testFailureIgnore>
                    <argLine>
                        -javaagent:"${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar"
                    </argLine>
                    <properties>
                        <property>
                            <name>listener</name>
                            <value>com.automation.listeners.AnnotationTransformer</value>
                        </property>
                    </properties>
                    <includes>
                        <include>**/*Runner.java</include>
                    </includes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

# ── 1. Core Execution & Browser Settings ───────────────────
browser=chrome
headless=true
execution.mode=local         # local | remote
thread.count=3
environment=qa               # loads config/qa.properties for URLs
test.retry.count=1
execution.delay.ms=300

# ── 2. Timeouts & Polling ──────────────────────────────────
timeout.explicit=20
timeout.implicit=0
timeout.pageload=60
timeout.retry.count=3
timeout.polling.ms=500

# ── 3. Remote Grid & Cloud Platforms ────────────────────────
grid.url=http://localhost:4444/wd/hub
cloud.provider=              # browserstack | saucelabs | lambdatest
cloud.username=
cloud.accesskey=

# ── 4. AI Self-Healing Engine Settings ─────────────────────
ai.healing.enabled=true
ai.healing.provider=hybrid   # heuristic | gemini | openai | claude | ollama | hybrid
ai.healing.confidence.threshold=0.70
ai.runtime.healing.enabled=true

# Google Gemini (if provider=gemini or hybrid)
ai.gemini.api.key=           # or set GEMINI_API_KEY env var
ai.gemini.model=gemini-2.0-flash

# Local Ollama (zero cost, air-gapped)
ai.ollama.base.url=http://localhost:11434
ai.ollama.model=deepseek-r1:8b

# ── 5. Dashboard Live Telemetry ────────────────────────────
ai.telemetry.enabled=true
ai.telemetry.url=http://localhost:8080/api/telemetry/report
dashboard.telemetry.enabled=true
dashboard.telemetry.url=http://localhost:8080/api/telemetry/report

# ── 6. Git Auto-Patch ──────────────────────────────────────
ai.autopatch.enabled=false
ai.autopatch.auto.branch=true
ai.autopatch.branch.prefix=ai-heal/patch-
ai.autopatch.git.commit=true
ai.autopatch.create.pr=false

# QA Environment Settings for Consumer Tests
# --------------------------------------------------------
base.url=https://example.com/login
api.url=https://example.com/api
# Dynamic multi-user concurrency pool
user.pool=Admin:admin123:admin,Admin2:admin123:admin,Admin3:admin123:admin

package com.mycompany.tests.pages;

import com.automation.components.ButtonComponent;
import com.automation.pages.BasePage;
import org.openqa.selenium.By;

/**
 * Consumer Project Page Object:
 * Extends BasePage from Core SDK and binds typed UI Components!
 */
public class ConsumerLoginPage extends BasePage {

    // Declare high-level typed UI component wrappers
    public ButtonComponent loginBtn;

    public ConsumerLoginPage() {
        // Pass page name to super — used across AI healing audit logs and telemetry
        super("ConsumerLoginPage");
    }

    @Override
    protected void initElements() {
        // Syntax: register(uniqueKey, semanticDescriptionForAI, By locator)
        register("username", "Username text input field", By.name("username"));
        register("password", "Password text input field", By.name("password"));
        register("loginBtn", "Login submit button", By.cssSelector("button[type='submit']"));
        register("forgotPasswordLink", "Forgot your password link on login page",
            By.xpath("//a[contains(@href,'forgot')] | //*[contains(normalize-space(),'Forgot your password?')]"));

        // Wrap raw PageElement into an SDK typed component (ButtonComponent, SelectComponent, etc.)
        loginBtn = initComponent(ButtonComponent.class, getElement("loginBtn"));
    }

    public void login(String username, String password) {
        sendKeys(getElement("username"), username);
        sendKeys(getElement("password"), password);
        click(getElement("loginBtn"));
    }

    public void clickForgotPassword() {
        click(getElement("forgotPasswordLink"));
    }
}

// SelectComponent (Standard & Custom Searchable Dropdowns)
SelectComponent roleSelect = initComponent(SelectComponent.class, getElement("roleSelect"));
roleSelect.selectByVisibleText("Admin");
roleSelect.selectByValue("1");
List<String> allRoles = roleSelect.getOptions();

// CheckboxComponent
CheckboxComponent agreeTerms = initComponent(CheckboxComponent.class, getElement("agreeCheckbox"));
agreeTerms.check();
agreeTerms.uncheck();
boolean isChecked = agreeTerms.isChecked();

// DatePickerComponent
DatePickerComponent hireDate = initComponent(DatePickerComponent.class, getElement("hireDatePicker"));
hireDate.selectDate("2026-09-06");

// ModalComponent
ModalComponent confirmModal = initComponent(ModalComponent.class, getElement("deleteConfirmModal"));
confirmModal.confirm();
confirmModal.dismiss();
String title = confirmModal.getTitle();

package com.mycompany.tests.stepdefinitions;

import com.automation.data.DataGenerator;
import com.automation.data.ScenarioContext;
import com.automation.utils.Log;
import io.cucumber.java.en.Given;
import io.cucumber.java.en.Then;
import io.cucumber.java.en.When;
import org.testng.Assert;

public class CrossStepStateDemoSteps {

    // ── STEP 1: Generate dynamic runtime data and store in ScenarioContext ──
    @Given("I generate a dynamic employee profile with random synthetic data")
    public void generateDynamicData() {
        String randomName = DataGenerator.randomFullName();
        String randomEmail = DataGenerator.randomEmail("company.com");
        String randomEmpId = DataGenerator.randomNumeric(6);

        Log.info("Generated Employee: " + randomName + " (" + randomEmpId + ")");

        // Store into ThreadLocal ScenarioContext
        ScenarioContext.set("employeeName", randomName);
        ScenarioContext.set("employeeEmail", randomEmail);
        ScenarioContext.set("employeeId", randomEmpId);
    }

    // ── STEP 2: Retrieve the data in a subsequent step and use it ──
    @When("I search for the newly created employee")
    public void searchEmployee() {
        // Retrieve string values stored by previous steps
        String empName = ScenarioContext.getString("employeeName");
        String empId = ScenarioContext.getString("employeeId");

        Assert.assertNotNull(empName, "employeeName missing in ScenarioContext!");
        Log.info("Searching for employee by name: " + empName + " and ID: " + empId);
        
        // Use with Page Object
        // directoryPage.searchByName(empName);
    }

    // ── STEP 3: Validate results using the stored context state ──
    @Then("I verify the employee details match the generated profile")
    public void verifyEmployeeDetails() {
        String expectedEmail = ScenarioContext.getString("employeeEmail");
        Assert.assertTrue(ScenarioContext.contains("employeeEmail"), "Key not found!");
        Log.info("Verified active employee email against ScenarioContext: " + expectedEmail);
    }
}

{
  "activeAdmin": {
    "role": "Admin",
    "status": "Enabled",
    "username": "admin_user",
    "email": "{{random_email}}",
    "notes": "Automated test administrator account"
  },
  "standardUser": {
    "role": "ESS",
    "status": "Enabled",
    "username": "standard_user",
    "email": "{{random_email}}",
    "notes": "Standard employee self-service profile"
  }
}

package com.mycompany.tests.stepdefinitions;

import com.automation.data.ScenarioContext;
import com.automation.data.TestData;
import com.automation.data.TestDataManager;
import com.automation.utils.Log;
import io.cucumber.java.en.Given;

public class DataDrivenStepDefinitions {

    @Given("I apply the user profile {string} from JSON test data")
    public void applyUserProfile(String profileKey) {
        // 1. Dynamic TestData container - Zero POJOs required!
        // Format: TestDataManager.getData("filename.key")
        TestData profile = TestDataManager.getData("user-profiles." + profileKey);
        
        String role = profile.getString("role");
        String status = profile.getString("status");
        String email = profile.getString("email"); // {{random_email}} is already resolved!

        Log.info("Loaded JSON test data: role=" + role + ", email=" + email);

        // Combine with ScenarioContext for cross-step sharing
        ScenarioContext.set("activeRole", role);
        ScenarioContext.set("activeEmail", email);

        // 2. Direct dot-path value access is also supported
        String notes = TestDataManager.getString("user-profiles." + profileKey + ".notes");
        Log.info("Profile notes: " + notes);
    }
}

@ConsumerSuite @Smoke
Feature: Consumer Application Login and Portal Access

  Scenario: Consumer test successfully logs into portal using Core SDK
    Given I acquire a consumer user with role "admin"
    When I navigate to the application portal
    And the AI pre-flight agent validates consumer page elements
    And I perform login using consumer credentials
    Then I should see the dashboard loaded successfully
    And the AI element healing JSON report should be generated in the consumer project

package com.mycompany.tests.stepdefinitions;

import com.automation.config.ConfigReader;
import com.automation.users.User;
import com.automation.users.UserManager;
import com.automation.utils.ElementActions;
import com.automation.utils.Log;
import com.mycompany.tests.pages.ConsumerDashboardPage;
import com.mycompany.tests.pages.ConsumerLoginPage;
import io.cucumber.java.en.Given;
import io.cucumber.java.en.Then;
import io.cucumber.java.en.When;
import org.testng.Assert;

public class ConsumerLoginSteps {

    private final ConsumerLoginPage loginPage = new ConsumerLoginPage();
    private final ConsumerDashboardPage dashboardPage = new ConsumerDashboardPage();
    private User currentUser;

    @Given("I acquire a consumer user with role {string}")
    public void acquireConsumerUser(String role) {
        // Leases a credential from the platform's dynamic User Session Pool!
        currentUser = UserManager.getUser(role);
        Log.info("Consumer test leased user: " + currentUser.username());
    }

    @When("I navigate to the application portal")
    public void navigateToPortal() {
        // Navigates directly using the single configured base.url
        String baseUrl = ConfigReader.get("base.url");
        ElementActions.navigateToUrl(baseUrl);
    }

    @When("the AI pre-flight agent validates consumer page elements")
    public void validateConsumerPageElements() {
        loginPage.validateAndHealPageElements();
    }

    @When("I perform login using consumer credentials")
    public void performLogin() {
        loginPage.login(currentUser.username(), currentUser.password());
    }

    @Then("I should see the dashboard loaded successfully")
    public void verifyDashboard() {
        Assert.assertTrue(dashboardPage.isDashboardLoaded(), "Dashboard failed to load!");
        Log.info("Consumer scenario successfully validated dashboard!");
    }

    @Then("the AI element healing JSON report should be generated in the consumer project")
    public void verifyConsumerJsonReport() {
        com.automation.ai.HealingAuditLogger.exportJsonReport();
        Log.info("Exported element healing JSON report.");
    }
}

package com.mycompany.tests.runners;

import com.automation.config.ConfigReader;
import io.cucumber.testng.AbstractTestNGCucumberTests;
import io.cucumber.testng.CucumberOptions;
import org.testng.ITestContext;
import org.testng.annotations.BeforeTest;
import org.testng.annotations.DataProvider;

@CucumberOptions(
    features = "src/test/resources/features",
    glue = {
        "com.mycompany.tests.stepdefinitions",  // your step definitions package
        "com.automation.hooks"                  // Core SDK lifecycle & telemetry hooks (MANDATORY)
    },
    plugin = {
        "pretty",
        "html:target/cucumber-reports/cucumber-pretty.html",
        "io.qameta.allure.cucumber7jvm.AllureCucumber7Jvm"
    },
    monochrome = true
)
public class ConsumerTestRunner extends AbstractTestNGCucumberTests {

    @BeforeTest(alwaysRun = true)
    public void setupSuite(ITestContext context) {
        int threads = ConfigReader.getInt("thread.count", 2);
        context.getSuite().getXmlSuite().setDataProviderThreadCount(threads);
    }

    @Override
    @DataProvider(parallel = true)  // Enables concurrent scenario execution
    public Object[][] scenarios() {
        return super.scenarios();
    }
}

mvn clean test

mvn clean test -Dcucumber.filter.tags="@Smoke" -Dbrowser=chrome -Dheadless=true