feat: implement auto-instrumentation for fs

[rauno56]

Which problem is this PR solving?

This implements partial auto-instrumentation for the native fs module.

Short description of the changes

This instruments most of the fs functions. Full list in constants.ts file.
Provides two hooks:

• createHook: (functionName: string, info: { args: ArrayLike<unknown> }) => boolean;
• endHook: (functionName: string, info: { args: ArrayLike<unknown>; span: api.Span }) => void;

Returning false from createHook skips creating the trace.

Checklist

• Ran npm run test-all-versions for the edited package(s) on the latest commit if applicable.

[codecov]

Codecov Report

Merging #872 (ab5cf69) into main (982843d) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #872   +/-   ##
=======================================
  Coverage   95.91%   95.91%           
=======================================
  Files          13       13           
  Lines         856      856           
  Branches      178      178           
=======================================
  Hits          821      821           
  Misses         35       35           

[rauno56]

Thanks a lot @vmarchaud and @blumamir. Really valuable feedback! I addressed everything in one way or another and took the liberty to resolve all the threads I found trivial and resolved.

[dyladan]

I'll let you decide on the suppressing. I'm going to approve, but not merge until you've made that decision.

[dyladan]

Why starting at version 27?

[rauno56]

Out of a habit. We used to version-match packages. I guess it can now be 0.1.0, which makes a lot more sense.

[blumamir]

LGTM, great work. Was waiting for instrumentation for this package, thanks for taking it 🤩

[dyladan]

@rauno56 you can merge this if you're happy with it. I think with release-please updated we should no longer need to manually add it to the manifest.

[rauno56]

Hard to go back the other way without breaking alerts and stuff.

I think that's a good point. I'll change that to be strict for now. I'll convert the PR to draft since I will be fixing this next week.

Note to myself: test to make sure user calls in callbacks aren't suppressed.