feat: enhanced input validation and error handling

[DerekRoberts]

Summary

This PR adds a new triggered output to the action and enhances error handling with better debugging information.

🚀 New Features

Triggered Output

• New Output: Added triggered output that exposes steps.diff.outputs.triggered
• Use Case: Allows downstream actions to conditionally run based on whether this action was triggered
• Example:

- uses: ./
  id: test-action
- if: steps.test-action.outputs.triggered == 'true'
  run: echo 'Action was triggered!'

Enhanced Error Handling

• Better Command Failure Messages: Added comprehensive error handling for test command failures
• Debug Information: Shows Node/NPM versions, working directory, and available scripts
• Troubleshooting Steps: Provides common solutions for test failures
• Multi-line Command Support: Fixed handling of multi-line commands in bash

🛠️ Input Validation

Pattern Validation

Added regex pattern validation for:

• node_version: ^[0-9]+(\.[0-9]+)*$ (e.g., '18', '20', '22')
• cache: ^(npm|yarn|pnpm)$ (package manager validation)
• dir: ^[a-zA-Z0-9._/-]+$ (directory path validation)
• sonar_token: ^[a-zA-Z0-9]{20,}$ (minimum 20 characters)
• repository: ^[a-zA-Z0-9-_]+/[a-zA-Z0-9-_]+$ (owner/repo format)
• diff_branch: ^[a-zA-Z0-9._/-]+$ (branch name validation)

🧪 Testing

Trigger Behavior Verification

• Backend Job: Verifies it correctly doesn't trigger (no backend/ changes)
• Frontend-merge Job: Verifies it triggers (triggers: '.')
• Frontend-pr Job: Verifies it triggers (no triggers = always run)

Test Strategy

• Uses matrix strategy to test different trigger scenarios
• Verifies the new triggered output works correctly
• Tests with real repository (bcgov/quickstart-openshift)
• Includes SonarCloud integration testing

📈 Benefits

• Better Integration: Downstream actions can now check if this action was triggered
• Improved Debugging: Clear error messages and troubleshooting steps
• Input Validation: Prevents invalid inputs from causing runtime failures
• Reliable Testing: Comprehensive test coverage of core functionality

🔍 Example Usage

- uses: bcgov/action-test-and-analyse@v1
  id: test-action
  with:
    commands: |
      npm ci
      npm run test:cov
    dir: frontend
    node_version: '20'

- name: Deploy if tests passed
  if: steps.test-action.outputs.triggered == 'true'
  run: echo 'Tests were triggered and passed!'