Align Flow lib defs for Node.js crypto with v24

[robhogan]

Summary:
This is an AI-assisted change to align the Flow definitions for the crypto module with the Node.js docs as at v24.

New v24 APIs:

1. hash(algorithm, data, [outputEncoding]) - One-shot hashing convenience function

   • Added in Node.js v21.7.0, v20.12.0
   • https://nodejs.org/api/crypto.html#cryptohashalgorithm-data-outputencoding

2. X509Certificate new properties (added in v22.10.0):

   • validFromDate - Certificate valid-from as Date object
   • validToDate - Certificate valid-to as Date object
   • https://nodejs.org/api/crypto.html#x509certificatevalidfromdate
   • https://nodejs.org/api/crypto.html#x509certificatevalidtodate

New Classes:

3. KeyObject - Represents cryptographic keys (symmetric/asymmetric)

   • Properties: type, asymmetricKeyType, asymmetricKeySize, symmetricKeySize
   • Methods: export(), equals()
   • https://nodejs.org/api/crypto.html#class-keyobject

4. X509Certificate - X.509 certificate handling

   • Properties: ca, fingerprint*, issuer, subject, publicKey, raw, etc.
   • Methods: checkEmail(), checkHost(), checkIP(), verify(), etc.
   • https://nodejs.org/api/crypto.html#class-x509certificate

5. Certificate - Legacy SPKAC (Signed Public Key and Challenge) support

   • Static methods: exportChallenge(), exportPublicKey(), verifySpkac()
   • https://nodejs.org/api/crypto.html#class-certificate

Key Management Functions:

6. Key Creation:

   • createSecretKey(key, [encoding]) - Create symmetric KeyObject
   • createPublicKey(key) - Create public KeyObject
   • createPrivateKey(key) - Create private KeyObject
   • https://nodejs.org/api/crypto.html#cryptocreatesecretkeykey-encoding
   • https://nodejs.org/api/crypto.html#cryptocreatepublickeykey
   • https://nodejs.org/api/crypto.html#cryptocreateprivatekeykey

7. Key Generation:

   • generateKeyPair() / generateKeyPairSync() - Generate asymmetric key pairs
   • generateKey() / generateKeySync() - Generate symmetric keys
   • Supports: RSA, RSA-PSS, DSA, EC, Ed25519, Ed448, X25519, X448
   • https://nodejs.org/api/crypto.html#cryptogeneratekeypairtype-options-callback
   • https://nodejs.org/api/crypto.html#cryptogeneratekeytype-options-callback

8. Primality Testing:

   • checkPrime() / checkPrimeSync() - Test if candidate is prime
   • https://nodejs.org/api/crypto.html#cryptocheckprimecandidate-options-callback

Other Improvements:

9. Hash.copy() - Create deep copy of Hash object

   • https://nodejs.org/api/crypto.html#hashcopyoptions

10. webcrypto property - References web Crypto type

    • Web Crypto API types are NOT redefined (use existing definitions where available)
    • https://nodejs.org/api/webcrypto.html

Type Safety:

• All options objects use modern Readonly<{...}> syntax for inputs
• Exact-by-default types throughout
• Proper overloading for functions with optional parameters

References:

• Node.js crypto module docs: https://nodejs.org/api/crypto.html
• Node.js Web Crypto API: https://nodejs.org/api/webcrypto.html

Changelog: [Internal]

Generated by Confucius Code Assist (CCA)
Confucius Session, Trace

Reviewed By: vzaidman

Differential Revision: D89934145

[meta-codesync]

@robhogan has exported this pull request. If you are a Meta employee, you can view the originating Diff in D89934145.

[meta-codesync]

This pull request has been merged in 83b21bb.

[react-native-bot]

This pull request was successfully merged by @robhogan in 83b21bb

^{When will my fix make it into a release? | How to file a pick request?}