Skip to content

Refactor SARIF-related types and functions into a separate module#3528

Open
mbg wants to merge 4 commits intomainfrom
mbg/refactor/sarif
Open

Refactor SARIF-related types and functions into a separate module#3528
mbg wants to merge 4 commits intomainfrom
mbg/refactor/sarif

Conversation

@mbg
Copy link
Member

@mbg mbg commented Mar 1, 2026

This PR refactors SARIF-related types and functions from util.ts and upload-lib.ts to a separate sarif module. The primary motivation for this is follow-up PRs in which we can then make use of the sarif module without introducing circular dependencies and add tests that mock functions from the sarif module more easily.

Risk assessment

For internal use only. Please select the risk level of this change:

  • Low risk: Changes are fully under feature flags, or have been fully tested and validated in pre-production environments and are highly observable, or are documentation or test only.

Which use cases does this change impact?

Workflow types:

  • Advanced setup - Impacts users who have custom CodeQL workflows.
  • Managed - Impacts users with dynamic workflows (Default Setup, Code Quality, ...).

Products:

  • Code Scanning - The changes impact analyses when analysis-kinds: code-scanning.
  • Code Quality - The changes impact analyses when analysis-kinds: code-quality.
  • Other first-party - The changes impact other first-party analyses.
  • Third-party analyses - The changes affect the upload-sarif action.

Environments:

  • Dotcom - Impacts CodeQL workflows on github.com and/or GitHub Enterprise Cloud with Data Residency.
  • GHES - Impacts CodeQL workflows on GitHub Enterprise Server.

How did/will you validate this change?

  • Unit tests - I am depending on unit test coverage (i.e. tests in .test.ts files).
  • End-to-end tests - I am depending on PR checks (i.e. tests in pr-checks).

If something goes wrong after this change is released, what are the mitigation and rollback strategies?

  • Rollback - Change can only be disabled by rolling back the release or releasing a new version with a fix.

How will you know if something goes wrong after this change is released?

  • Telemetry - I rely on existing telemetry or have made changes to the telemetry.
    • Dashboards - I will watch relevant dashboards for issues after the release. Consider whether this requires this change to be released at a particular time rather than as part of a regular release.
    • Alerts - New or existing monitors will trip if something goes wrong with this change.

Are there any special considerations for merging or releasing this change?

  • No special considerations - This change can be merged at any time.

Merge / deployment checklist

  • Confirm this change is backwards compatible with existing workflows.
  • Consider adding a changelog entry for this change.
  • Confirm the readme and docs have been updated if necessary.

@mbg mbg self-assigned this Mar 1, 2026
@mbg mbg requested a review from a team as a code owner March 1, 2026 14:51
Copilot AI review requested due to automatic review settings March 1, 2026 14:51
@github-actions github-actions bot added the size/XL May be very hard to review label Mar 1, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Refactors SARIF-related types/errors/helpers out of util.ts and upload-lib.ts into a dedicated src/sarif module to reduce coupling (and help avoid circular dependencies) while keeping existing call sites working via re-exports.

Changes:

  • Introduces src/sarif/index.ts with SARIF types and helper functions (e.g., parsing, combining, uniqueness checks) plus InvalidSarifUploadError.
  • Re-exports SARIF symbols from src/util.ts and updates src/upload-lib.ts / src/upload-sarif-action.ts to reference the new module layout.
  • Moves the getToolNames unit test into a new src/sarif/index.test.ts test file.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file
File Description
src/util.ts Re-exports the new sarif module and removes inlined SARIF types/helpers.
src/util.test.ts Removes SARIF-related tests that were moved out of util.
src/upload-sarif-action.ts Updates error-type check to use InvalidSarifUploadError from the new SARIF module (via util re-export).
src/upload-lib.ts Imports SARIF types/helpers from ./sarif instead of defining them inline; uses shared SARIF parsing helper.
src/sarif/index.ts New module containing SARIF interfaces and helper functions previously located in util.ts/upload-lib.ts.
src/sarif/index.test.ts New tests for SARIF helper(s) (currently getToolNames).
lib/upload-sarif-action.js Generated bundle output update (not reviewed).
lib/upload-lib.js Generated bundle output update (not reviewed).
lib/init-action-post.js Generated bundle output update (not reviewed).
lib/analyze-action.js Generated bundle output update (not reviewed).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/XL May be very hard to review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants