feat: add getAccessKind

[JoshuaKGoldberg]

PR Checklist

• Addresses an existing open issue: fixes 🚀 Feature: Add getAccessKind #397
• That issue was marked as status: accepting prs
• Steps in CONTRIBUTING.md were taken

Overview

Adds the function, with some rudimentary unit tests.

[codecov]

Codecov Report

Attention: Patch coverage is 60.09390% with 85 lines in your changes are missing coverage. Please review.

Project coverage is 79.60%. Comparing base (49d5dd0) to head (4f0ccaf).
Report is 1 commits behind head on main.

Files	Patch %	Lines
src/nodes/access.ts	60.37%	84 Missing ⚠️
src/nodes/index.ts	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #398      +/-   ##
==========================================
- Coverage   80.25%   79.60%   -0.65%     
==========================================
  Files          35       36       +1     
  Lines        6426     6639     +213     
  Branches      360      437      +77     
==========================================
+ Hits         5157     5285     +128     
- Misses       1269     1354      +85     

Flag	Coverage Δ
4.3.5	79.39% <60.09%> (-0.64%)	⬇️
4.6.4	79.42% <60.09%> (-0.65%)	⬇️
4.9.5	79.42% <60.09%> (-0.65%)	⬇️
latest	79.39% <60.09%> (-0.64%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[JoshuaKGoldberg]

I'll add some more tests 🙂

[JoshuaKGoldberg]

Added some, ran out of time+energy to add more. Can file a followup issue.

[ghost]

It would be great to have this (and through this, get isReassignmentTarget) for migrating https://github.com/cartant/eslint-plugin-etc 😉

[RebeccaStevens]

Could it be better to express these in bitwise notation, to make it clear that's how they are supposed to be used?

export enum AccessKind {
  None = 0,
	Read = 1 << 0,
	Write = 1 << 1,
	Delete = 1 << 2,
	ReadWrite = Read | Write,
}

[RebeccaStevens]

It's probably a bit unnecessary though.

[JoshuaKGoldberg]

I like it!