@trevordsouzabrite/test-package 1.0.0

package/.github/workflows/playwright-healer-agent.yml

@@ -0,0 +1,140 @@
+name: Playwright Test Healer Agent
+
+on:
+  workflow_run:
+    workflows: [Playwright Tests]
+    types: [completed]
+  workflow_dispatch:
+    inputs:
+      workflow_run_id:
+        description: Playwright Tests workflow run ID (defaults to latest failed run)
+        required: false
+        type: string
+
+permissions:
+  actions: read
+  contents: read
+  issues: write
+
+concurrency:
+  group: playwright-healer-${{ github.event.workflow_run.id || github.run_id }}
+  cancel-in-progress: true
+
+jobs:
+  healer:
+    if: >-
+      ${{
+        (github.event_name == 'workflow_dispatch') ||
+        (
+          github.event.workflow_run.conclusion == 'failure' &&
+          github.event.workflow_run.repository.id == github.repository_id &&
+          !startsWith(github.event.workflow_run.head_branch, 'copilot/') &&
+          !startsWith(github.event.workflow_run.head_branch, 'autofix/') &&
+          !startsWith(github.event.workflow_run.head_branch, 'healer/')
+        )
+      }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Resolve workflow run
+        id: run
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            if [ -n "${{ inputs.workflow_run_id }}" ]; then
+              RUN_ID="${{ inputs.workflow_run_id }}"
+            else
+              RUN_ID=$(gh run list --workflow=playwright.yml --json databaseId,conclusion --jq '.[] | select(.conclusion=="failure") | .databaseId' | head -1)
+              if [ -z "$RUN_ID" ]; then
+                echo "::error::No failed Playwright Tests run found. Pass workflow_run_id manually."
+                exit 1
+              fi
+            fi
+            RUN_JSON=$(gh run view "$RUN_ID" --json headBranch,headSha,htmlUrl,conclusion,event)
+            echo "run_id=$RUN_ID" >> "$GITHUB_OUTPUT"
+            echo "head_branch=$(echo "$RUN_JSON" | jq -r '.headBranch')" >> "$GITHUB_OUTPUT"
+            echo "head_sha=$(echo "$RUN_JSON" | jq -r '.headSha')" >> "$GITHUB_OUTPUT"
+            echo "html_url=$(echo "$RUN_JSON" | jq -r '.htmlUrl')" >> "$GITHUB_OUTPUT"
+          else
+            echo "run_id=${{ github.event.workflow_run.id }}" >> "$GITHUB_OUTPUT"
+            echo "head_branch=${{ github.event.workflow_run.head_branch }}" >> "$GITHUB_OUTPUT"
+            echo "head_sha=${{ github.event.workflow_run.head_sha }}" >> "$GITHUB_OUTPUT"
+            echo "html_url=${{ github.event.workflow_run.html_url }}" >> "$GITHUB_OUTPUT"
+          fi
+
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ steps.run.outputs.head_sha }}
+
+      - name: Collect CI failure context
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p ci-failure-context
+          RUN_ID="${{ steps.run.outputs.run_id }}"
+          gh run view "$RUN_ID" --log-failed > ci-failure-context/failed-logs.txt 2>&1 || true
+          gh run download "$RUN_ID" -n playwright-report -D ci-failure-context/playwright-report 2>/dev/null || true
+          gh run download "$RUN_ID" -n playwright-test-results -D ci-failure-context/test-results 2>/dev/null || true
+          {
+            echo "Workflow run: ${{ steps.run.outputs.html_url }}"
+            echo "Branch: ${{ steps.run.outputs.head_branch }}"
+            echo "Commit: ${{ steps.run.outputs.head_sha }}"
+          } > ci-failure-context/summary.txt
+
+      - name: Start Playwright Test Healer (Copilot cloud agent)
+        env:
+          GH_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}
+        run: |
+          if [ -z "$GH_TOKEN" ]; then
+            echo "::warning::Secret COPILOT_GITHUB_TOKEN is not set. Cannot start the healer agent."
+            echo "::warning::Add repo secret COPILOT_GITHUB_TOKEN (PAT with Agent tasks read/write)."
+            exit 0
+          fi
+
+          PROMPT=$(cat <<EOF
+          Playwright tests failed in CI.
+
+          - Workflow run: ${{ steps.run.outputs.html_url }}
+          - Branch: ${{ steps.run.outputs.head_branch }}
+          - Commit: ${{ steps.run.outputs.head_sha }}
+          - Failure context directory: ci-failure-context/
+
+          Act as the playwright-test-healer custom agent (.github/agents/playwright-test-healer.agent.md).
+
+          1. Read ci-failure-context/ for logs and the HTML report.
+          2. Run the full suite with Playwright MCP test_run.
+          3. Debug failures with test_debug and browser tools; fix tests/ and related page objects.
+          4. Re-run until green, or use test.fixme() with a comment when the app is broken.
+          5. Open a pull request with fixes.
+
+          Same intent as the /playwright-test-heal repository prompt.
+          EOF
+          )
+
+          BODY=$(jq -n \
+            --arg prompt "$PROMPT" \
+            --arg base_ref "${{ steps.run.outputs.head_branch }}" \
+            '{
+              prompt: $prompt,
+              create_pull_request: true,
+              base_ref: $base_ref, 
+              custom_agent: "playwright-test-healer"
+            }')
+
+          if ! gh api \
+            --method POST \
+            -H "Accept: application/vnd.github+json" \
+            -H "X-GitHub-Api-Version: 2026-03-10" \
+            "/agents/repos/${GITHUB_REPOSITORY}/tasks" \
+            --input - <<<"$BODY"; then
+            echo "::notice::Retrying without custom_agent field..."
+            BODY=$(echo "$BODY" | jq 'del(.custom_agent)')
+            gh api \
+              --method POST \
+              -H "Accept: application/vnd.github+json" \
+              -H "X-GitHub-Api-Version: 2026-03-10" \
+              "/agents/repos/${GITHUB_REPOSITORY}/tasks" \
+              --input - <<<"$BODY"
+          fi
+
+          echo "::notice::Playwright Test Healer started — track at https://github.com/copilot/agents"

package/.github/workflows/playwright.yml

@@ -0,0 +1,40 @@
+name: Playwright Tests
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+jobs:
+  test:
+    timeout-minutes: 60
+    runs-on: ubuntu-latest
+    env:
+      ENV: qa
+      LOGIN: ${{ secrets.LOGIN }}
+      PASSWORD: ${{ secrets.PASSWORD }}
+    steps:
+    - uses: actions/checkout@v4
+    - uses: actions/setup-node@v4
+      with:
+        node-version: lts/*
+    - name: Install dependencies
+      run: npm ci
+    - name: Install Playwright Browsers
+      run: npx playwright install --with-deps
+    - name: Run Playwright tests (no-auth)
+      run: npm run test:ci:no-auth
+    - name: Run Playwright tests (auth)
+      run: npm run test:ci:auth
+    - uses: actions/upload-artifact@v4
+      if: ${{ !cancelled() }}
+      with:
+        name: playwright-report
+        path: playwright-report/
+        retention-days: 30
+    - uses: actions/upload-artifact@v4
+      if: failure()
+      with:
+        name: playwright-test-results
+        path: test-results/
+        retention-days: 14
+        if-no-files-found: ignore

package/.mcp.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "playwright-test": {
+      "command": "cmd",
+      "args": [
+        "/c",
+        "npx",
+        "playwright",
+        "run-test-mcp-server"
+      ]
+    }
+  }
+}

package/.vscode/extensions.json

@@ -0,0 +1,6 @@
+{
+  "recommendations": [
+    "anthropic.claude-code",
+    "ms-playwright.playwright"
+  ]
+}

package/.vscode/mcp.json

@@ -0,0 +1,13 @@
+{
+  "servers": {
+    "playwright-test": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "playwright",
+        "run-test-mcp-server"
+      ]
+    }
+  },
+  "inputs": []
+}

package/.vscode/settings.example.json

@@ -0,0 +1,15 @@
+{
+  "//": "Copy these keys into your USER settings.json (not this file).",
+  "//": "VS Code: Ctrl+Shift+P → Preferences: Open User Settings (JSON)",
+  "claudeCode.environmentVariables": [
+    {
+      "name": "ANTHROPIC_API_KEY",
+      "value": "sk-ant-api03-REPLACE-WITH-YOUR-KEY"
+    }
+  ],
+  "claudeCode.disableLoginPrompt": true,
+  "terminal.integrated.env.windows": {
+    "OPENAI_API_KEY": "sk-proj-REPLACE-WITH-YOUR-KEY",
+    "OPENAI_MODEL": "gpt-5.4-mini"
+  }
+}

package/bitbucket-pipelines.yml

@@ -0,0 +1,86 @@
+# Pin to the Playwright version that matches @playwright/test in package.json.
+image: mcr.microsoft.com/playwright:v1.58.2-jammy
+
+options:
+  max-time: 60
+
+definitions:
+  caches:
+    npmcache: ~/.npm
+  steps:
+    - step: &playwright-tests
+        name: Playwright tests
+        size: 2x
+        caches:
+          - node
+          - npmcache
+        script:
+          - node -v && npm -v
+          - npm ci
+          - bash scripts/bitbucket/run-pipeline-tests.sh
+        artifacts:
+          - playwright-report/**
+          - test-results/**
+          - ci-failure-context/**
+        after-script:
+          - bash scripts/bitbucket/after-test-healer.sh
+    - step: &playwright-smoke-tests
+        name: Playwright smoke tests
+        size: 2x
+        caches:
+          - node
+          - npmcache
+        script:
+          - node -v && npm -v
+          - npm ci
+          - PLAYWRIGHT_SUITE_TAG="@smoke" bash scripts/bitbucket/run-pipeline-tests.sh
+        artifacts:
+          - playwright-report/**
+          - test-results/**
+          - ci-failure-context/**
+        after-script:
+          - export HEALER_VERIFY_COMMAND='PLAYWRIGHT_SUITE_TAG="@smoke" npm run test:bitbucket'
+          - bash scripts/bitbucket/after-test-healer.sh
+    - step: &playwright-tagged-tests
+        name: Playwright tagged tests
+        size: 2x
+        caches:
+          - node
+          - npmcache
+        script:
+          - node -v && npm -v
+          - npm ci
+          - |
+            if [ -z "$TEST_TAGS" ]; then
+              echo "TEST_TAGS is required. Example: @smoke or (?=.*@smoke)(?=.*@auth)";
+              exit 1;
+            fi
+          - PLAYWRIGHT_SUITE_TAG="$TEST_TAGS" bash scripts/bitbucket/run-pipeline-tests.sh
+        artifacts:
+          - playwright-report/**
+          - test-results/**
+          - ci-failure-context/**
+        after-script:
+          - export HEALER_VERIFY_COMMAND="PLAYWRIGHT_SUITE_TAG=\"$TEST_TAGS\" npm run test:bitbucket"
+          - bash scripts/bitbucket/after-test-healer.sh
+
+pipelines:
+  default:
+    - step: *playwright-tests
+  branches:
+    main:
+      - step: *playwright-tests
+    master:
+      - step: *playwright-tests
+
+  custom:
+    regression-tests:
+      - step: *playwright-tests
+    smoke-tests:
+      - step: *playwright-smoke-tests
+    tagged-tests:
+      - variables:
+          - name: TEST_TAGS
+            default: "@smoke"
+            description: "Tag to combine with @no-auth and @auth, for example @smoke or @sprint15052026"
+      - step: *playwright-tagged-tests

package/lib/WebActions.ts

@@ -0,0 +1,107 @@
+import fs from 'fs';
+import * as CryptoJS from 'crypto-js';
+import type { Locator, Page } from '@playwright/test';
+import { BrowserContext, expect } from '@playwright/test';
+import { Workbook } from 'exceljs';
+import { testConfig } from '../testConfig';
+import * as pdfjslib from 'pdfjs-dist-es5';
+
+export class WebActions {
+    readonly page: Page;
+    readonly context: BrowserContext;
+
+    constructor(page: Page, context: BrowserContext) {
+        this.page = page;
+        this.context = context;
+    }
+
+    async decipherPassword(): Promise<string> {
+        const key = `SECRET`;
+        //ENCRYPT
+        // const cipher = CryptoJS.AES.encrypt('Demouat@09',key);
+        // console.log(cipher.toString());
+        return CryptoJS.AES.decrypt(testConfig.password, key).toString(CryptoJS.enc.Utf8);
+    }
+
+    async delay(time: number): Promise<void> {
+        return new Promise(function (resolve) {
+            setTimeout(resolve, time);
+        });
+    }
+
+    async clickByText(text: string): Promise<void> {
+        await this.page.getByText(text, { exact: true }).click();  //Matches locator with exact text and clicks
+    }
+
+    async clickElementJS(locator: string): Promise<void> {
+        await this.page.$eval(locator, (element: HTMLElement) => element.click());
+    }
+
+    async readDataFromExcel(fileName: string, sheetName: string, rowNum: number, cellNum: number): Promise<string> {
+        const workbook = new Workbook();
+        return workbook.xlsx.readFile(`./Downloads/${fileName}`).then(function () {
+            const sheet = workbook.getWorksheet(sheetName);
+            return sheet.getRow(rowNum).getCell(cellNum).toString();
+        });
+    }
+
+    async readValuesFromTextFile(filePath: string): Promise<string> {
+        return fs.readFileSync(`${filePath}`, `utf-8`);
+    }
+
+    async writeDataIntoTextFile(filePath: number | fs.PathLike, data: string | NodeJS.ArrayBufferView): Promise<void> {
+        fs.writeFile(filePath, data, (error) => {
+            if (error)
+                throw error;
+        });
+    }
+
+    async getPdfPageText(pdf: any, pageNo: number) {
+        const page = await pdf.getPage(pageNo);
+        const tokenizedText = await page.getTextContent();
+        const pageText = tokenizedText.items.map((token: any) => token.str).join('');
+        return pageText;
+    }
+
+    async getPDFText(filePath: any): Promise<string> {
+        const dataBuffer = fs.readFileSync(filePath);
+        const pdf = await pdfjslib.getDocument(dataBuffer).promise;
+        const maxPages = pdf.numPages;
+        const pageTextPromises = [];
+        for (let pageNo = 1; pageNo <= maxPages; pageNo += 1) {
+          pageTextPromises.push(this.getPdfPageText(pdf, pageNo));
+        }
+        const pageTexts = await Promise.all(pageTextPromises);
+        return pageTexts.join(' ');
+      }
+    
+    async waitForElementAttached(locator: Locator)
+    {
+        console.log(`Waiting for the element ${locator} to be attached to the DOM...`);
+        await locator.waitFor( { state: 'attached' });
+    }
+
+    /** Returns true if the element has no meaningful value/text (after trim). */
+    async checkIfFieldIsEmptyOrNot(locator: Locator): Promise<boolean> {
+        return locator.evaluate((el) => {
+            if (
+                el instanceof HTMLInputElement ||
+                el instanceof HTMLTextAreaElement ||
+                el instanceof HTMLSelectElement
+            ) {
+                return el.value.trim().length === 0;
+            }
+            if (el instanceof HTMLElement && el.isContentEditable) {
+                return (el.innerText ?? '').trim().length === 0;
+            }
+            return (el.textContent ?? '').trim().length === 0;
+        });
+    }
+
+    async getErrorMessage(locator: Locator): Promise<string>
+    {
+        const message =  await locator.evaluate(
+            (el) => (el as HTMLInputElement).validationMessage);
+        return message;
+    }
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@trevordsouzabrite/test-package",
+  "version": "1.0.0",
+  "description": "test description",
+  "license": "ISC",
+  "author": "",
+  "type": "commonjs",
+  "dependencies": {
+    "@axe-core/playwright": "^4.10.2",
+    "@playwright/test": "^1.58.2",
+    "crypto-js": "^4.2.0",
+    "dotenv": "^16.4.7",
+    "exceljs": "^4.4.0",
+    "pdfjs-dist-es5": "^2.13.216",
+    "settings": "^0.1.1"
+  },
+  "files": [
+    ".claude/",
+    ".github/",
+    ".vscode/",
+    "lib/",
+    "pageRepository/",
+    "playwright/",
+    "specs/",
+    "test-data/",
+    "tests/",
+    ".mcp.json",
+    "bitbucket-pipelines.yml"
+  ],
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}