chore: enforce explicit Buffer import and add lint rule

[shivarm]

explicitly import Buffer using const { Buffer } = require('node:buffer') for clarity and future compatibility, following Node.js best practices.

[bjohansebas]

I'm not sure this is a good practice, Buffer is a global property

[krzysdz]

I'm not sure this is a good practice, Buffer is a global property

Node.js docs say:

While the Buffer class is available within the global scope, it is still recommended to explicitly reference it via an import or require statement.

This sentence replaced the previous

The Buffer class is within the global scope, making it unlikely that one would need to ever use require('buffer').Buffer.

in nodejs/node#39043, but I can't find any arguments for why it is recommended. I think that it's just a cosmetic change for compatibility (or explicit incompatibility) reasons with other environments, but that's just a guess.

[bjohansebas]

@krzysdz Thanks for the references

[wesleytodd]

It would be good to keep consistency, so if anyone is willing I think we have a bunch of other packages that could use this change.

FWIW, it is a cosmetic change but is still worth it to do because it sets a good example for anyone reading this code to learn from.

[Phillip9587]

@shivarm Could you please update all occurrences of Buffer?

@wesleytodd If we want to keep that consistent we should add a lint rule to prevent usage of global Buffer:

rules:
  no-restricted-globals:
    - error
    - name: Buffer
      message: Use `import { Buffer } from "node:buffer"` instead of the global Buffer.

[Phillip9587]

See comment above

[wesleytodd]

@wesleytodd If we want to keep that consistent we should add a lint rule to prevent usage of global Buffer:

I am against one off lint rule discussions on principal, but I agree it would be best if we had these things enforced by linting. Since we have an eslint config already in the repo, I am not opposed to adding one as a temporary step until we get a better setup overall. @shivarm you could add this rule so that you can find and fix all the other implicit global usage.

[shivarm]

@wesleytodd Done 👍

[Hardanish-Singh]

LGTM!