feat: handle crypto.createCredentials() depreciation #123
Description
Description
Since crypto.createCredentials() is deprecated (DEP0010) and has reached End-of-Life status, we should provide a codemod to replace it.
- The codemod should replace all instances of
crypto.createCredentials()withtls.createSecureContext(). - The codemod should update import/require statements to replace
node:cryptowithnode:tlswhencreateCredentialsis the only crypto function being used. - If the
node:cryptoimport is destructured and only containscreateCredentials, it should be replaced withnode:tlsdestructured import. - If there are other crypto functions being used, the codemod should add a separate
node:tlsimport and keep the existingnode:cryptoimport.
Additional Information
Note that crypto.createCredentials() was removed in Node.js v11.0.0 and replaced with tls.createSecureContext(). The functionality is identical, but the API has been moved to the more appropriate tls module. The options object format remains the same (key, cert, ca, etc.).
Examples
Case 1: Destructured import with only createCredentials
Before:
const { createCredentials } = require('node:crypto');
const credentials = createCredentials({
key: privateKey,
cert: certificate,
ca: [caCertificate]
});After:
const { createSecureContext } = require('node:tls');
const credentials = createSecureContext({
key: privateKey,
cert: certificate,
ca: [caCertificate]
});Case 2: Namespace import
Before:
const crypto = require('node:crypto');
const credentials = crypto.createCredentials({
key: fs.readFileSync('server-key.pem'),
cert: fs.readFileSync('server-cert.pem')
});After:
const tls = require('node:tls');
const credentials = tls.createSecureContext({
key: fs.readFileSync('server-key.pem'),
cert: fs.readFileSync('server-cert.pem')
});Case 3: Mixed usage with other crypto functions
Before:
const { createCredentials, createHash } = require('node:crypto');
const credentials = createCredentials({
key: privateKey,
cert: certificate
});
const hash = createHash('sha256');
hash.update('some data');After:
const { createHash } = require('node:crypto');
const { createSecureContext } = require('node:tls');
const credentials = createSecureContext({
key: privateKey,
cert: certificate
});
const hash = createHash('sha256');
hash.update('some data');Case 4: ESM import
Before:
import { createCredentials } from 'node:crypto';
const credentials = createCredentials({
key: privateKey,
cert: certificate,
ca: [caCertificate]
});After:
import { createSecureContext } from 'node:tls';
const credentials = createSecureContext({
key: privateKey,
cert: certificate,
ca: [caCertificate]
});Case 5: ESM namespace import
Before:
import * as crypto from 'node:crypto';
const credentials = crypto.createCredentials({
key: privateKey,
cert: certificate
});After:
import * as tls from 'node:tls';
const credentials = tls.createSecureContext({
key: privateKey,
cert: certificate
});