feat(tls-securepair-to-tlssocket): introduce

[menace31]

This PR introduces a new codemod to migrate the deprecated tls.SecurePair class to tls.TLSSocket.

Key features of this codemod:

- Constructor Transformation: Replaces new SecurePair() with new TLSSocket(socket).

- Smart Renaming: deep-renames variables (e.g., pair → socket, myPair → mySocket) while preserving CamelCase and scope integrity.

- Import Handling: Supports both CommonJS (require) and ESM (import) patterns, including destructured imports.

- Cleanup: Removes usage of deprecated properties like .cleartext and .encrypted.

- Safety: Adds a comment warning users that manual verification is required for the injected socket argument.

Testing: I have added comprehensive test cases covering:

- CommonJS and ESM import styles.

- Variable renaming in complex scopes (nested blocks).

- Destructuring patterns.

Tests were verified locally using a custom test script ensuring input/output matches expectations.

[AugustinMauroy]

there are some copy pasta

[AugustinMauroy]

Pr title should be updated + the architecture need to fit with the good way to create a codemod

[menace31]

@AugustinMauroy I have addressed the comments. Could you please review the code again? If the architecture is still not correct, could you please clarify the expected approach so I can be sure I understand?

[AugustinMauroy]

you can have on code snippets here that use diff

[AugustinMauroy]

this file isn't needed codemod cli furnish us the needed tooling

[AugustinMauroy]

we have utilities for that plz read that https://github.com/nodejs/userland-migrations/blob/main/utils/README.md

[menace31]

I've addressed the previous PR issues. The transformation now uses the recommended utilities from @nodejs/codemod-utils for detecting and manipulating imports/requires (getNodeImportStatements, getNodeRequireCalls, updateBinding, removeLines). I've also removed test.sh from Git, updated the documentation to reference npm test, and all eight tests pass. I hope my work will pass the tests this time.

[menace31]

I just corrected the codemod error and ran all tests with npm run test. It should work correctly this time. Thank you for your patience