name: "Diagnostic export"
description: "Tests that manually added diagnostics are correctly exported to SARIF."
# Test on 2.12.5 (which requires a workaround in the Action), the latest release, and the latest
# nightly.
versions: ["stable-20230317", "latest", "nightly-latest"]
env:
  CODEQL_ACTION_EXPORT_DIAGNOSTICS: true
steps:
  - uses: ./../action/init
    id: init
    with:
      languages: javascript
      tools: ${{ steps.prepare-test.outputs.tools-url }}
  - name: Add test diagnostics
    shell: bash
    env:
      CODEQL_PATH: ${{ steps.init.outputs.codeql-path }}
    run: |
      for i in {1..2}; do
        # Use the same location twice to test the workaround for the bug in CodeQL CLI 2.12.5 that
        # produces an invalid diagnostic with multiple identical location objects.
        "$CODEQL_PATH" database add-diagnostic \
          "$RUNNER_TEMP/codeql_databases/javascript" \
          --file-path /path/to/file \
          --plaintext-message "Plaintext message $i" \
          --source-id "lang/diagnostics/example" \
          --source-name "Diagnostic name" \
          --ready-for-status-page
      done
  - uses: ./../action/analyze
    with:
      output: "${{ runner.temp }}/results"
      upload-database: false
  - name: Upload SARIF
    uses: actions/upload-artifact@v3
    with:
      name: diagnostics-export-${{ matrix.os }}-${{ matrix.version }}.sarif.json
      path: "${{ runner.temp }}/results/javascript.sarif"
      retention-days: 7
  - name: Check diagnostics appear in SARIF
    uses: actions/github-script@v6
    env:
      SARIF_PATH: "${{ runner.temp }}/results/javascript.sarif"
    with:
      script: |
        const fs = require('fs');

        function checkStatusPageNotification(n) {
          const expectedMessage = 'Plaintext message 1\n\nCodeQL also found 1 other diagnostic like this. See the workflow log for details.';
          if (n.message.text !== expectedMessage) {
            core.setFailed(`Expected the status page diagnostic to have the message '${expectedMessage}', but found '${n.message.text}'.`);
          }
          if (n.locations.length !== 1) {
            core.setFailed(`Expected the status page diagnostic to have exactly 1 location, but found ${n.locations.length}.`);
          }
        }

        const sarif = JSON.parse(fs.readFileSync(process.env['SARIF_PATH'], 'utf8'));
        const run = sarif.runs[0];

        const toolExecutionNotifications = run.invocations[0].toolExecutionNotifications;
        const statusPageNotifications = toolExecutionNotifications.filter(n =>
          n.descriptor.id === 'lang/diagnostics/example' && n.properties?.visibility?.statusPage
        );
        if (statusPageNotifications.length !== 1) {
          core.setFailed(
            'Expected exactly one status page reporting descriptor for this diagnostic in the ' +
              `'runs[].invocations[].toolExecutionNotifications[]' SARIF property, but found ` +
              `${statusPageNotifications.length}. All notification reporting descriptors: ` + 
              `${JSON.stringify(toolExecutionNotifications)}.`
          );
        }
        checkStatusPageNotification(statusPageNotifications[0]);

        const notifications = run.tool.driver.notifications;
        const diagnosticNotification = notifications.filter(n =>
          n.id === 'lang/diagnostics/example' && n.name === 'lang/diagnostics/example' &&
            n.fullDescription.text === 'Diagnostic name'
        );
        if (diagnosticNotification.length !== 1) {
          core.setFailed(
            'Expected exactly one notification for this diagnostic in the ' +
              `'runs[].tool.driver.notifications[]' SARIF property, but found ` +
              `${diagnosticNotification.length}. All notifications: ` +
              `${JSON.stringify(notifications)}.`
          );
        }

        core.info('Finished diagnostic export test');