netlify-cli 17.3.1 → 17.4.0

package/src/utils/build-info.mjs

@@ -1,43 +1,39 @@
-// @ts-check
-
-import fuzzy from 'fuzzy'
-import inquirer from 'inquirer'
-
-import { chalk, log } from './command-helpers.mjs'
-
+import fuzzy from 'fuzzy';
+import inquirer from 'inquirer';
+import { chalk, log } from './command-helpers.mjs';
 /**
  * Filters the inquirer settings based on the input
  * @param {ReturnType<typeof formatSettingsArrForInquirer>} scriptInquirerOptions
  * @param {string} input
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'scriptInquirerOptions' implicitly has a... Remove this comment to see the full error message
 const filterSettings = function (scriptInquirerOptions, input) {
-  const filterOptions = scriptInquirerOptions.map((scriptInquirerOption) => scriptInquirerOption.name)
-  // TODO: remove once https://github.com/sindresorhus/eslint-plugin-unicorn/issues/1394 is fixed
-  // eslint-disable-next-line unicorn/no-array-method-this-argument
-  const filteredSettings = fuzzy.filter(input, filterOptions)
-  const filteredSettingNames = new Set(
-    filteredSettings.map((filteredSetting) => (input ? filteredSetting.string : filteredSetting)),
-  )
-  return scriptInquirerOptions.filter((t) => filteredSettingNames.has(t.name))
-}
-
+    // @ts-expect-error TS(7006) FIXME: Parameter 'scriptInquirerOption' implicitly has an... Remove this comment to see the full error message
+    const filterOptions = scriptInquirerOptions.map((scriptInquirerOption) => scriptInquirerOption.name);
+    // TODO: remove once https://github.com/sindresorhus/eslint-plugin-unicorn/issues/1394 is fixed
+    // eslint-disable-next-line unicorn/no-array-method-this-argument
+    const filteredSettings = fuzzy.filter(input, filterOptions);
+    const filteredSettingNames = new Set(filteredSettings.map((filteredSetting) => (input ? filteredSetting.string : filteredSetting)));
+    // @ts-expect-error TS(7006) FIXME: Parameter 't' implicitly has an 'any' type.
+    return scriptInquirerOptions.filter((t) => filteredSettingNames.has(t.name));
+};
 /** @typedef {import('@netlify/build-info').Settings} Settings */
-
 /**
  * @param {Settings[]} settings
  * @param {'dev' | 'build'} type The type of command (dev or build)
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'settings' implicitly has an 'any' type.
 const formatSettingsArrForInquirer = function (settings, type = 'dev') {
-  return settings.map((setting) => {
-    const cmd = type === 'dev' ? setting.devCommand : setting.buildCommand
-    return {
-      name: `[${chalk.yellow(setting.framework.name)}] '${cmd}'`,
-      value: { ...setting, commands: [cmd] },
-      short: `${setting.name}-${cmd}`,
-    }
-  })
-}
-
+    // @ts-expect-error TS(7006) FIXME: Parameter 'setting' implicitly has an 'any' type.
+    return settings.map((setting) => {
+        const cmd = type === 'dev' ? setting.devCommand : setting.buildCommand;
+        return {
+            name: `[${chalk.yellow(setting.framework.name)}] '${cmd}'`,
+            value: { ...setting, commands: [cmd] },
+            short: `${setting.name}-${cmd}`,
+        };
+    });
+};
 /**
  * Uses @netlify/build-info to detect the dev settings and port based on the framework
  * and the build system that is used.
@@ -45,29 +41,31 @@ const formatSettingsArrForInquirer = function (settings, type = 'dev') {
  * @param {'dev' | 'build'} type The type of command (dev or build)
  * @returns {Promise<Settings | undefined>}
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'command' implicitly has an 'any' type.
 export const detectFrameworkSettings = async (command, type = 'dev') => {
-  const { relConfigFilePath } = command.netlify
-  const settings = await detectBuildSettings(command)
-  if (settings.length === 1) {
-    return settings[0]
-  }
-
-  if (settings.length > 1) {
-    /** multiple matching detectors, make the user choose */
-    const scriptInquirerOptions = formatSettingsArrForInquirer(settings, type)
-    /** @type {{chosenSettings: Settings}} */
-    const { chosenSettings } = await inquirer.prompt({
-      name: 'chosenSettings',
-      message: `Multiple possible ${type} commands found`,
-      type: 'autocomplete',
-      source(/** @type {string} */ _, input = '') {
-        if (!input) return scriptInquirerOptions
-        // only show filtered results
-        return filterSettings(scriptInquirerOptions, input)
-      },
-    })
-
-    log(`
+    const { relConfigFilePath } = command.netlify;
+    const settings = await detectBuildSettings(command);
+    if (settings.length === 1) {
+        return settings[0];
+    }
+    if (settings.length > 1) {
+        /** multiple matching detectors, make the user choose */
+        const scriptInquirerOptions = formatSettingsArrForInquirer(settings, type);
+        /** @type {{chosenSettings: Settings}} */
+        const { chosenSettings } = await inquirer.prompt({
+            name: 'chosenSettings',
+            message: `Multiple possible ${type} commands found`,
+            // @ts-expect-error TS(2769) FIXME: No overload matches this call.
+            type: 'autocomplete',
+            // @ts-expect-error TS(7006) FIXME: Parameter '_' implicitly has an 'any' type.
+            source(/** @type {string} */ _, input = '') {
+                if (!input)
+                    return scriptInquirerOptions;
+                // only show filtered results
+                return filterSettings(scriptInquirerOptions, input);
+            },
+        });
+        log(`
 Update your ${relConfigFilePath} to avoid this selection prompt next time:
 
 [build]
@@ -76,25 +74,26 @@ publish = "${chosenSettings.dist}"
 
 [dev]
 command = "${chosenSettings.devCommand}"
-`)
-    return chosenSettings
-  }
-}
-
+`);
+        return chosenSettings;
+    }
+};
 /**
  * Detects and filters the build setting for a project and a command
  * @param {import('../commands/base-command.mjs').default} command
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'command' implicitly has an 'any' type.
 export const detectBuildSettings = async (command) => {
-  const { project, workspacePackage } = command
-  const buildSettings = await project.getBuildSettings(project.workspace ? workspacePackage : '')
-  return buildSettings
-    .filter((setting) => {
-      if (project.workspace && project.relativeBaseDirectory && setting.packagePath) {
-        return project.relativeBaseDirectory.startsWith(setting.packagePath)
-      }
-
-      return true
+    const { project, workspacePackage } = command;
+    const buildSettings = await project.getBuildSettings(project.workspace ? workspacePackage : '');
+    return buildSettings
+        // @ts-expect-error TS(7006) FIXME: Parameter 'setting' implicitly has an 'any' type.
+        .filter((setting) => {
+        if (project.workspace && project.relativeBaseDirectory && setting.packagePath) {
+            return project.relativeBaseDirectory.startsWith(setting.packagePath);
+        }
+        return true;
     })
-    .filter((setting) => setting.devCommand)
-}
+        // @ts-expect-error TS(7006) FIXME: Parameter 'setting' implicitly has an 'any' type.
+        .filter((setting) => setting.devCommand);
+};

package/src/utils/command-helpers.mjs

@@ -1,41 +1,35 @@
-// @ts-check
-import { once } from 'events'
-import os from 'os'
-import process from 'process'
-import { format, inspect } from 'util'
-
+import { once } from 'events';
+import os from 'os';
+import process from 'process';
+import { format, inspect } from 'util';
 // eslint-disable-next-line no-restricted-imports
-import { Chalk } from 'chalk'
-import chokidar from 'chokidar'
-import decache from 'decache'
-import WSL from 'is-wsl'
-import debounce from 'lodash/debounce.js'
-import terminalLink from 'terminal-link'
-
-import { clearSpinner, startSpinner } from '../lib/spinner.mjs'
-
-import getGlobalConfig from './get-global-config.mjs'
-import getPackageJson from './get-package-json.mjs'
-import { reportError } from './telemetry/report-error.mjs'
-
+import { Chalk } from 'chalk';
+import chokidar from 'chokidar';
+import decache from 'decache';
+import WSL from 'is-wsl';
+import debounce from 'lodash/debounce.js';
+import terminalLink from 'terminal-link';
+import { clearSpinner, startSpinner } from '../lib/spinner.mjs';
+import getGlobalConfig from './get-global-config.mjs';
+import getPackageJson from './get-package-json.mjs';
+import { reportError } from './telemetry/report-error.mjs';
 /** The parsed process argv without the binary only arguments and flags */
-const argv = process.argv.slice(2)
+const argv = process.argv.slice(2);
 /**
  * Chalk instance for CLI that can be initialized with no colors mode
  * needed for json outputs where we don't want to have colors
  * @param  {boolean} noColors - disable chalk colors
  * @return {import('chalk').ChalkInstance} - default or custom chalk instance
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'noColors' implicitly has an 'any' type.
 const safeChalk = function (noColors) {
-  if (noColors) {
-    const colorlessChalk = new Chalk({ level: 0 })
-    return colorlessChalk
-  }
-  return new Chalk()
-}
-
-export const chalk = safeChalk(argv.includes('--json'))
-
+    if (noColors) {
+        const colorlessChalk = new Chalk({ level: 0 });
+        return colorlessChalk;
+    }
+    return new Chalk();
+};
+export const chalk = safeChalk(argv.includes('--json'));
 /**
  * Adds the filler to the start of the string
  * @param {string} str
@@ -43,27 +37,20 @@ export const chalk = safeChalk(argv.includes('--json'))
  * @param {string} [filler]
  * @returns {string}
  */
-export const padLeft = (str, count, filler = ' ') => str.padStart(str.length + count, filler)
-
-const platform = WSL ? 'wsl' : os.platform()
-const arch = os.arch() === 'ia32' ? 'x86' : os.arch()
-
-const { name, version } = await getPackageJson()
-
-export const USER_AGENT = `${name}/${version} ${platform}-${arch} node-${process.version}`
-
+// @ts-expect-error TS(7006) FIXME: Parameter 'str' implicitly has an 'any' type.
+export const padLeft = (str, count, filler = ' ') => str.padStart(str.length + count, filler);
+const platform = WSL ? 'wsl' : os.platform();
+const arch = os.arch() === 'ia32' ? 'x86' : os.arch();
+const { name, version } = await getPackageJson();
+export const USER_AGENT = `${name}/${version} ${platform}-${arch} node-${process.version}`;
 /** A list of base command flags that needs to be sorted down on documentation and on help pages */
-const BASE_FLAGS = new Set(['--debug', '--httpProxy', '--httpProxyCertificateFilename'])
-
-export const NETLIFY_CYAN = chalk.rgb(40, 180, 170)
-
-export const NETLIFYDEV = `${chalk.greenBright('◈')} ${NETLIFY_CYAN('Netlify Dev')} ${chalk.greenBright('◈')}`
-export const NETLIFYDEVLOG = `${chalk.greenBright('◈')}`
-export const NETLIFYDEVWARN = `${chalk.yellowBright('◈')}`
-export const NETLIFYDEVERR = `${chalk.redBright('◈')}`
-
-export const BANG = process.platform === 'win32' ? '»' : '›'
-
+const BASE_FLAGS = new Set(['--debug', '--httpProxy', '--httpProxyCertificateFilename']);
+export const NETLIFY_CYAN = chalk.rgb(40, 180, 170);
+export const NETLIFYDEV = `${chalk.greenBright('◈')} ${NETLIFY_CYAN('Netlify Dev')} ${chalk.greenBright('◈')}`;
+export const NETLIFYDEVLOG = `${chalk.greenBright('◈')}`;
+export const NETLIFYDEVWARN = `${chalk.yellowBright('◈')}`;
+export const NETLIFYDEVERR = `${chalk.redBright('◈')}`;
+export const BANG = process.platform === 'win32' ? '»' : '›';
 /**
  * Sorts two options so that the base flags are at the bottom of the list
  * @param {import('commander').Option} optionA
@@ -72,17 +59,16 @@ export const BANG = process.platform === 'win32' ? '»' : '›'
  * @example
  * options.sort(sortOptions)
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'optionA' implicitly has an 'any' type.
 export const sortOptions = (optionA, optionB) => {
-  // base flags should be always at the bottom
-  if (BASE_FLAGS.has(optionA.long) || BASE_FLAGS.has(optionB.long)) {
-    return -1
-  }
-  return optionA.long.localeCompare(optionB.long)
-}
-
+    // base flags should be always at the bottom
+    if (BASE_FLAGS.has(optionA.long) || BASE_FLAGS.has(optionB.long)) {
+        return -1;
+    }
+    return optionA.long.localeCompare(optionB.long);
+};
 // Poll Token timeout 5 Minutes
-const TOKEN_TIMEOUT = 3e5
-
+const TOKEN_TIMEOUT = 3e5;
 /**
  *
  * @param {object} config
@@ -90,94 +76,89 @@ const TOKEN_TIMEOUT = 3e5
  * @param {object} config.ticket
  * @returns
  */
+// @ts-expect-error TS(7031) FIXME: Binding element 'api' implicitly has an 'any' type... Remove this comment to see the full error message
 export const pollForToken = async ({ api, ticket }) => {
-  const spinner = startSpinner({ text: 'Waiting for authorization...' })
-  try {
-    const accessToken = await api.getAccessToken(ticket, { timeout: TOKEN_TIMEOUT })
-    if (!accessToken) {
-      error('Could not retrieve access token')
+    const spinner = startSpinner({ text: 'Waiting for authorization...' });
+    try {
+        const accessToken = await api.getAccessToken(ticket, { timeout: TOKEN_TIMEOUT });
+        if (!accessToken) {
+            error('Could not retrieve access token');
+        }
+        return accessToken;
+    }
+    catch (error_) {
+        // @ts-expect-error TS(2571) FIXME: Object is of type 'unknown'.
+        if (error_.name === 'TimeoutError') {
+            error(`Timed out waiting for authorization. If you do not have a ${chalk.bold.greenBright('Netlify')} account, please create one at ${chalk.magenta('https://app.netlify.com/signup')}, then run ${chalk.cyanBright('netlify login')} again.`);
+        }
+        else {
+            // @ts-expect-error TS(2345) FIXME: Argument of type 'unknown' is not assignable to pa... Remove this comment to see the full error message
+            error(error_);
+        }
     }
-    return accessToken
-  } catch (error_) {
-    if (error_.name === 'TimeoutError') {
-      error(
-        `Timed out waiting for authorization. If you do not have a ${chalk.bold.greenBright(
-          'Netlify',
-        )} account, please create one at ${chalk.magenta(
-          'https://app.netlify.com/signup',
-        )}, then run ${chalk.cyanBright('netlify login')} again.`,
-      )
-    } else {
-      error(error_)
+    finally {
+        clearSpinner({ spinner });
     }
-  } finally {
-    clearSpinner({ spinner })
-  }
-}
-
+};
 /**
  * Get a netlify token
  * @param {string} [tokenFromOptions] optional token from the provided --auth options
  * @returns {Promise<[null|string, 'flag' | 'env' |'config' |'not found']>}
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'tokenFromOptions' implicitly has an 'an... Remove this comment to see the full error message
 export const getToken = async (tokenFromOptions) => {
-  // 1. First honor command flag --auth
-  if (tokenFromOptions) {
-    return [tokenFromOptions, 'flag']
-  }
-  // 2. then Check ENV var
-  const { NETLIFY_AUTH_TOKEN } = process.env
-  if (NETLIFY_AUTH_TOKEN && NETLIFY_AUTH_TOKEN !== 'null') {
-    return [NETLIFY_AUTH_TOKEN, 'env']
-  }
-  // 3. If no env var use global user setting
-  const globalConfig = await getGlobalConfig()
-  const userId = globalConfig.get('userId')
-  const tokenFromConfig = globalConfig.get(`users.${userId}.auth.token`)
-  if (tokenFromConfig) {
-    return [tokenFromConfig, 'config']
-  }
-  return [null, 'not found']
-}
-
+    // 1. First honor command flag --auth
+    if (tokenFromOptions) {
+        return [tokenFromOptions, 'flag'];
+    }
+    // 2. then Check ENV var
+    const { NETLIFY_AUTH_TOKEN } = process.env;
+    if (NETLIFY_AUTH_TOKEN && NETLIFY_AUTH_TOKEN !== 'null') {
+        return [NETLIFY_AUTH_TOKEN, 'env'];
+    }
+    // 3. If no env var use global user setting
+    const globalConfig = await getGlobalConfig();
+    const userId = globalConfig.get('userId');
+    const tokenFromConfig = globalConfig.get(`users.${userId}.auth.token`);
+    if (tokenFromConfig) {
+        return [tokenFromConfig, 'config'];
+    }
+    return [null, 'not found'];
+};
 // 'api' command uses JSON output by default
 // 'functions:invoke' need to return the data from the function as is
-const isDefaultJson = () => argv[0] === 'functions:invoke' || (argv[0] === 'api' && !argv.includes('--list'))
-
+const isDefaultJson = () => argv[0] === 'functions:invoke' || (argv[0] === 'api' && !argv.includes('--list'));
 /**
  * logs a json message
- * @param {string|object} message
  */
 export const logJson = (message = '') => {
-  if (argv.includes('--json') || isDefaultJson()) {
-    process.stdout.write(JSON.stringify(message, null, 2))
-  }
-}
-
+    if (argv.includes('--json') || isDefaultJson()) {
+        process.stdout.write(JSON.stringify(message, null, 2));
+    }
+};
+// @ts-expect-error TS(7019) FIXME: Rest parameter 'args' implicitly has an 'any[]' ty... Remove this comment to see the full error message
 export const log = (message = '', ...args) => {
-  // If  --silent or --json flag passed disable logger
-  if (argv.includes('--json') || argv.includes('--silent') || isDefaultJson()) {
-    return
-  }
-  message = typeof message === 'string' ? message : inspect(message)
-  process.stdout.write(`${format(message, ...args)}\n`)
-}
-
+    // If  --silent or --json flag passed disable logger
+    if (argv.includes('--json') || argv.includes('--silent') || isDefaultJson()) {
+        return;
+    }
+    message = typeof message === 'string' ? message : inspect(message);
+    process.stdout.write(`${format(message, ...args)}\n`);
+};
+// @ts-expect-error TS(7019) FIXME: Rest parameter 'args' implicitly has an 'any[]' ty... Remove this comment to see the full error message
 export const logPadded = (message = '', ...args) => {
-  log('')
-  log(message, ...args)
-  log('')
-}
-
+    log('');
+    log(message, ...args);
+    log('');
+};
 /**
  * logs a warning message
  * @param {string} message
  */
 export const warn = (message = '') => {
-  const bang = chalk.yellow(BANG)
-  log(` ${bang}   Warning: ${message}`)
-}
-
+    const bang = chalk.yellow(BANG);
+    log(` ${bang}   Warning: ${message}`);
+};
 /**
  * throws an error or log it
  * @param {unknown} message
@@ -185,31 +166,32 @@ export const warn = (message = '') => {
  * @param {boolean} [options.exit]
  */
 export const error = (message = '', options = {}) => {
-  const err =
+    const err = 
+    // @ts-expect-error TS(2358) FIXME: The left-hand side of an 'instanceof' expression m... Remove this comment to see the full error message
     message instanceof Error
-      ? message
-      : // eslint-disable-next-line unicorn/no-nested-ternary
-      typeof message === 'string'
-      ? new Error(message)
-      : /** @type {Error} */ ({ message, stack: undefined, name: 'Error' })
-
-  if (options.exit === false) {
-    const bang = chalk.red(BANG)
-    if (process.env.DEBUG) {
-      process.stderr.write(` ${bang}   Warning: ${err.stack?.split('\n').join(`\n ${bang}   `)}\n`)
-    } else {
-      process.stderr.write(` ${bang}   ${chalk.red(`${err.name}:`)} ${err.message}\n`)
+        ? message
+        : // eslint-disable-next-line unicorn/no-nested-ternary
+            typeof message === 'string'
+                ? new Error(message)
+                : /** @type {Error} */ { message, stack: undefined, name: 'Error' };
+    // @ts-expect-error TS(2339) FIXME: Property 'exit' does not exist on type '{}'.
+    if (options.exit === false) {
+        const bang = chalk.red(BANG);
+        if (process.env.DEBUG) {
+            process.stderr.write(` ${bang}   Warning: ${err.stack?.split('\n').join(`\n ${bang}   `)}\n`);
+        }
+        else {
+            process.stderr.write(` ${bang}   ${chalk.red(`${err.name}:`)} ${err.message}\n`);
+        }
     }
-  } else {
-    reportError(err, { severity: 'error' })
-    throw err
-  }
-}
-
+    else {
+        reportError(err, { severity: 'error' });
+        throw err;
+    }
+};
 export const exit = (code = 0) => {
-  process.exit(code)
-}
-
+    process.exit(code);
+};
 /**
  * When `build.publish` is not set by the user, the CLI behavior differs in
  * several ways. It detects it by checking if `build.publish` is `undefined`.
@@ -217,16 +199,14 @@ export const exit = (code = 0) => {
  * This removes 'publish' and 'publishOrigin' in this case.
  * @param {*} config
  */
+// @ts-expect-error TS(7006) FIXME: Parameter 'config' implicitly has an 'any' type.
 export const normalizeConfig = (config) => {
-  // Unused var here is in order to omit 'publish' from build config
-  // eslint-disable-next-line no-unused-vars
-  const { publish, publishOrigin, ...build } = config.build
-
-  return publishOrigin === 'default' ? { ...config, build } : config
-}
-
-const DEBOUNCE_WAIT = 100
-
+    // Unused var here is in order to omit 'publish' from build config
+    // eslint-disable-next-line no-unused-vars
+    const { publish, publishOrigin, ...build } = config.build;
+    return publishOrigin === 'default' ? { ...config, build } : config;
+};
+const DEBOUNCE_WAIT = 100;
 /**
  * Adds a file watcher to a path or set of paths and debounces the events.
  *
@@ -239,49 +219,55 @@ const DEBOUNCE_WAIT = 100
  * @param {(paths: string[]) => any} [opts.onUnlink]
  */
 export const watchDebounced = async (
-  target,
-  { depth, ignored = [], onAdd = () => {}, onChange = () => {}, onUnlink = () => {} },
-) => {
-  const baseIgnores = [/\/(node_modules|.git)\//]
-  const watcher = chokidar.watch(target, { depth, ignored: [...baseIgnores, ...ignored], ignoreInitial: true })
-
-  await once(watcher, 'ready')
-
-  let onChangeQueue = []
-  let onAddQueue = []
-  let onUnlinkQueue = []
-
-  const debouncedOnChange = debounce(() => {
-    onChange(onChangeQueue)
-    onChangeQueue = []
-  }, DEBOUNCE_WAIT)
-  const debouncedOnAdd = debounce(() => {
-    onAdd(onAddQueue)
-    onAddQueue = []
-  }, DEBOUNCE_WAIT)
-  const debouncedOnUnlink = debounce(() => {
-    onUnlink(onUnlinkQueue)
-    onUnlinkQueue = []
-  }, DEBOUNCE_WAIT)
-
-  watcher
-    .on('change', (path) => {
-      decache(path)
-      onChangeQueue.push(path)
-      debouncedOnChange()
-    })
-    .on('unlink', (path) => {
-      decache(path)
-      onUnlinkQueue.push(path)
-      debouncedOnUnlink()
+// @ts-expect-error TS(7006) FIXME: Parameter 'target' implicitly has an 'any' type.
+target, 
+// @ts-expect-error TS(7031) FIXME: Binding element 'depth' implicitly has an 'any' ty... Remove this comment to see the full error message
+{ depth, ignored = [], onAdd = () => { }, onChange = () => { }, onUnlink = () => { } }) => {
+    const baseIgnores = [/\/(node_modules|.git)\//];
+    const watcher = chokidar.watch(target, { depth, ignored: [...baseIgnores, ...ignored], ignoreInitial: true });
+    await once(watcher, 'ready');
+    // @ts-expect-error TS(7034) FIXME: Variable 'onChangeQueue' implicitly has type 'any[... Remove this comment to see the full error message
+    let onChangeQueue = [];
+    // @ts-expect-error TS(7034) FIXME: Variable 'onAddQueue' implicitly has type 'any[]' ... Remove this comment to see the full error message
+    let onAddQueue = [];
+    // @ts-expect-error TS(7034) FIXME: Variable 'onUnlinkQueue' implicitly has type 'any[... Remove this comment to see the full error message
+    let onUnlinkQueue = [];
+    const debouncedOnChange = debounce(() => {
+        // @ts-expect-error TS(2554) FIXME: Expected 0 arguments, but got 1.
+        onChange(onChangeQueue);
+        onChangeQueue = [];
+    }, DEBOUNCE_WAIT);
+    const debouncedOnAdd = debounce(() => {
+        // @ts-expect-error TS(2554) FIXME: Expected 0 arguments, but got 1.
+        onAdd(onAddQueue);
+        onAddQueue = [];
+    }, DEBOUNCE_WAIT);
+    const debouncedOnUnlink = debounce(() => {
+        // @ts-expect-error TS(2554) FIXME: Expected 0 arguments, but got 1.
+        onUnlink(onUnlinkQueue);
+        onUnlinkQueue = [];
+    }, DEBOUNCE_WAIT);
+    watcher
+        .on('change', (path) => {
+        // @ts-expect-error
+        decache(path);
+        onChangeQueue.push(path);
+        debouncedOnChange();
     })
-    .on('add', (path) => {
-      decache(path)
-      onAddQueue.push(path)
-      debouncedOnAdd()
+        .on('unlink', (path) => {
+        // @ts-expect-error
+        decache(path);
+        onUnlinkQueue.push(path);
+        debouncedOnUnlink();
     })
-
-  return watcher
-}
-
-export const getTerminalLink = (text, url) => terminalLink(text, url, { fallback: () => `${text} (${url})` })
+        .on('add', (path) => {
+        // @ts-expect-error
+        decache(path);
+        onAddQueue.push(path);
+        debouncedOnAdd();
+    });
+    return watcher;
+};
+// @ts-expect-error TS(7006) FIXME: Parameter 'text' implicitly has an 'any' type.
+export const getTerminalLink = (text, url) => terminalLink(text, url, { fallback: () => `${text} (${url})` });
+export const isNodeError = (err) => error instanceof Error;