File Explorer

1'use strict'2 3/** @typedef {`node:${string}`} NodeModuleName */4 5/** @type {Record<NodeModuleName, () => any>} */6const lazyLoaders = {7  __proto__: null,8  'node:crypto': () => require('node:crypto'),9  'node:sqlite': () => require('node:sqlite'),10  'node:worker_threads': () => require('node:worker_threads'),11  'node:zlib': () => require('node:zlib')12}13 14/**15 * @param {NodeModuleName} moduleName16 * @returns {boolean}17 */18function detectRuntimeFeatureByNodeModule (moduleName) {19  try {20    lazyLoaders[moduleName]()21    return true22  } catch (err) {23    if (err.code !== 'ERR_UNKNOWN_BUILTIN_MODULE' && err.code !== 'ERR_NO_CRYPTO') {24      throw err25    }26    return false27  }28}29 30/**31 * @param {NodeModuleName} moduleName32 * @param {string} property33 * @returns {boolean}34 */35function detectRuntimeFeatureByExportedProperty (moduleName, property) {36  const module = lazyLoaders[moduleName]()37  return typeof module[property] !== 'undefined'38}39 40const runtimeFeaturesByExportedProperty = /** @type {const} */ (['markAsUncloneable', 'zstd'])41 42/** @type {Record<RuntimeFeatureByExportedProperty, [NodeModuleName, string]>} */43const exportedPropertyLookup = {44  markAsUncloneable: ['node:worker_threads', 'markAsUncloneable'],45  zstd: ['node:zlib', 'createZstdDecompress']46}47 48/** @typedef {typeof runtimeFeaturesByExportedProperty[number]} RuntimeFeatureByExportedProperty */49 50const runtimeFeaturesAsNodeModule = /** @type {const} */ (['crypto', 'sqlite'])51/** @typedef {typeof runtimeFeaturesAsNodeModule[number]} RuntimeFeatureByNodeModule */52 53const features = /** @type {const} */ ([54  ...runtimeFeaturesAsNodeModule,55  ...runtimeFeaturesByExportedProperty56])57 58/** @typedef {typeof features[number]} Feature */59 60/**61 * @param {Feature} feature62 * @returns {boolean}63 */64function detectRuntimeFeature (feature) {65  if (runtimeFeaturesAsNodeModule.includes(/** @type {RuntimeFeatureByNodeModule} */ (feature))) {66    return detectRuntimeFeatureByNodeModule(`node:${feature}`)67  } else if (runtimeFeaturesByExportedProperty.includes(/** @type {RuntimeFeatureByExportedProperty} */ (feature))) {68    const [moduleName, property] = exportedPropertyLookup[feature]69    return detectRuntimeFeatureByExportedProperty(moduleName, property)70  }71  throw new TypeError(`unknown feature: ${feature}`)72}73 74/**75 * @class76 * @name RuntimeFeatures77 */78class RuntimeFeatures {79  /** @type {Map<Feature, boolean>} */80  #map = new Map()81 82  /**83   * Clears all cached feature detections.84   */85  clear () {86    this.#map.clear()87  }88 89  /**90   * @param {Feature} feature91   * @returns {boolean}92   */93  has (feature) {94    return (95      this.#map.get(feature) ?? this.#detectRuntimeFeature(feature)96    )97  }98 99  /**100   * @param {Feature} feature101   * @param {boolean} value102   */103  set (feature, value) {104    if (features.includes(feature) === false) {105      throw new TypeError(`unknown feature: ${feature}`)106    }107    this.#map.set(feature, value)108  }109 110  /**111   * @param {Feature} feature112   * @returns {boolean}113   */114  #detectRuntimeFeature (feature) {115    const result = detectRuntimeFeature(feature)116    this.#map.set(feature, result)117    return result118  }119}120 121const instance = new RuntimeFeatures()122 123module.exports.runtimeFeatures = instance124module.exports.default = instance125