[@types/node] is missing globalThis.crypto type

[olalonde]

https://nodejs.org/api/webcrypto.html#class-crypto
https://nodejs.org/api/webcrypto.html#web-crypto-api

globalThis.crypto is an instance of the Crypto class. Crypto is a singleton that provides access to the remainder of the crypto API.

[typescript-bot]

Thanks for the discussion about "node", some useful links for everyone:

• npm
• DT
• Related discussions

Pinging the DT module owners: @microsoft, @DefinitelyTyped, @jkomyno, @alvis, @r3nya, @btoueg, @smac89, @Touffy, @DeividasBakanas, @eyqs, @Hannes-Magnusson-CK, @hoo29, @kjin, @ajafff, @islishude, @mwiktorczyk, @mohsen1, @n-e, @galkin, @parambirs, @eps1lon, @ThomasdenH, @WilcoBakker, @wwwy3y3, @samuela, @kuehlein, @bhongy, @chyzwar, @trivikr, @yoursunny, @qwelias, @ExE-Boss, @peterblazejewicz, @addaleax, @victorperin, @ZYSzys, @nodejs, @LinusU, @wafuwafu13, @mcollina, @Semigradsky.

[Semigradsky]

I am on it

[Semigradsky]

I see that interface Crypto from TS lib.dom.d.ts is very different from webcrypto namespace in node:crypto. Looks like it is why we haven't globalThis.crypto yet.

[hax]

Actually there are too many globals missing in @types/node, even fetch is missing!

Here is the list:

ByteLengthQueuingStrategy
CompressionStream
CountQueuingStrategy
Crypto
crypto
CryptoKey
CustomEvent
DecompressionStream
fetch // #66824
File
FormData // #66824
Headers // #66824
MessageEvent
PerformanceEntry
PerformanceMark
PerformanceMeasure
PerformanceObserver
PerformanceObserverEntryList
PerformanceResourceTiming
ReadableByteStreamController
ReadableStream
ReadableStreamBYOBReader
ReadableStreamBYOBRequest
ReadableStreamDefaultController
ReadableStreamDefaultReader
Response // #66824
Request // #66824
SubtleCrypto
DOMException
TextDecoderStream
TextEncoderStream
TransformStream
TransformStreamDefaultController
WebAssembly
WritableStream
WritableStreamDefaultController
WritableStreamDefaultWriter

[hax]

After #66824 land, fetch related globals will be available. We still need web stream and web crypto related patch.

[simhnna]

at least DOMException is still missing. Created a new discussion about that #69588

[hax]

This is my current patch to add some missing globals (notably globalThis.crypto, globalThis.File and web stream APIs)

// Patch for @types/node, add some missing globals

export {} // force it to be recognized as ESM

declare global {
  export {
    ByteLengthQueuingStrategy,
    CountQueuingStrategy,
    ReadableByteStreamController,
    ReadableStream,
    ReadableStreamBYOBReader,
    ReadableStreamBYOBRequest,
    ReadableStreamDefaultController,
    ReadableStreamDefaultReader,
    TextDecoderStream,
    TextEncoderStream,
    TransformStream,
    TransformStreamDefaultController,
    WritableStream,
    WritableStreamDefaultController,
    WritableStreamDefaultWriter,
    BufferSource,
    QueuingStrategy,
    QueuingStrategyInit,
    QueuingStrategySize,
    ReadableByteStreamControllerCallback,
    ReadableStreamController,
    ReadableStreamDefaultReadDoneResult,
    ReadableStreamDefaultReadResult,
    ReadableStreamDefaultReadValueResult,
    ReadableStreamErrorCallback,
    ReadableStreamGenericReader,
    ReadableStreamReadDoneResult,
    ReadableStreamReadResult,
    ReadableStreamReadValueResult,
    ReadableWritablePair,
    StreamPipeOptions,
    TextDecoderOptions,
    Transformer,
    TransformerFlushCallback,
    TransformerStartCallback,
    TransformerTransformCallback,
    UnderlyingByteSource,
    UnderlyingSink,
    UnderlyingSinkAbortCallback,
    UnderlyingSinkCloseCallback,
    UnderlyingSinkStartCallback,
    UnderlyingSinkWriteCallback,
    UnderlyingSource,
    UnderlyingSourceCancelCallback,
    UnderlyingSourcePullCallback,
    UnderlyingSourceStartCallback
  } from 'node:stream/web'

  export { webcrypto as crypto } from 'node:crypto'

  export { File, FileOptions } from 'node:buffer'

  export {
    PerformanceEntry,
    PerformanceMark,
    PerformanceMeasure,
    PerformanceObserver,
    Performance,
    PerformanceObserverCallback,
    PerformanceObserverEntryList
  } from 'node:perf_hooks'
}