timers-promises.ts

/**
 * @file Lazy-loader for `node:timers/promises`. See `node/fs.ts` for the design
 *   rationale shared across all `node/*.ts` lazy-loaders.
 */

import type * as NodeTimersPromises from 'node:timers/promises'

import { IS_NODE } from '../constants/runtime'

let timersPromises: typeof NodeTimersPromises | undefined

/**
 * @unused No internal or Socket consumers (exercised only by its unit tests).
 */
export function getNodeTimersPromises(): typeof NodeTimersPromises {
  if (!IS_NODE) {
    return undefined as unknown as typeof NodeTimersPromises
  }
  return (timersPromises ??=
    // oxlint-disable-next-line unicorn/prefer-node-protocol -- bare specifier (not node:) so webpack resolve.fallback / browser-field can stub this builtin for browser bundles; node: prefix throws UnhandledSchemeError there
    /*@__PURE__*/ require('timers/promises') as typeof NodeTimersPromises)
}