feat: Support top-level await on Node 22.12+

[epelc]

Fixes #268 which is broken on node v22.12.0 and later(works on <= v22.11.0). Gulp cli was trying to use require(), failing and not trying to fallback to import() since the error code changed. Previously gulp would detect the error and attempt to use import().

This makes it detect the new error code in node v22.12.0 and later. Keeps the old behavior to support older node versions as well.

See node change log which describes the changes that lead to this.

https://nodejs.org/en/blog/release/v22.12.0#requireesm-is-now-enabled-by-default

[mikestreety]

I can confirm this works for me and solves the problems I was having reported in this issue: #267

Is there anything stopping this being merged?

[phated]

I need to figure out a regression test for this because CI isn't failing in #272 when it should be.

[phated]

It looks like this will cause the failure:

const dynamicNoop = await Promise.resolve(function noop(cb) {
  cb();
});

export const registered = dynamicNoop;
export function exported(){};
export const string = 'no function';

[phated]

Excellent work here @epelc! Sorry for the delay but we'll get this released shortly.

[epelc]

Excellent work here @epelc! Sorry for the delay but we'll get this released shortly.

Thanks! Excited to get this in. Been blocking a node upgrade.

Gulp works really well for auxiliary build steps around modern angular.

[mikestreety]

Thanks for getting this merged and released 🙏

[crowjake]

Node version 25.2.1 and I'm seeing this error, despite using the gulp & gulp-cli versions where this was supposedly merged... I can't work it out:

$ gulp --experimental-print-required-tla
[18:51:44] Node flags detected: --experimental-print-required-tla
[18:51:44] Respawned to PID: 26796
Error: unexpected top-level await at file:///[...]/node_modules/gulp-imagemin/index.js:96
export const gifsicle = await exposePlugin('gifsicle');
                        ^

Error [ERR_REQUIRE_ASYNC_MODULE]: require() cannot be used on an ESM graph with top-level await. Use import() instead. To see where the top-level await comes from, use --experimental-print-required-tla.
  From [...]\gulpfile.js
  Requiring [...]\node_modules\gulp-imagemin\index.js
    at ModuleLoader.importSyncForRequire (node:internal/modules/esm/loader:331:15)
    at loadESMFromCJS (node:internal/modules/cjs/loader:1577:24)
    at Module._compile (node:internal/modules/cjs/loader:1742:5)
    at Object..js (node:internal/modules/cjs/loader:1892:10)
    at Module.load (node:internal/modules/cjs/loader:1480:32)
    at Module._load (node:internal/modules/cjs/loader:1299:12)
    at TracingChannel.traceSync (node:diagnostics_channel:328:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:245:24)
    at Module.require (node:internal/modules/cjs/loader:1503:12)
    at require (node:internal/modules/helpers:152:16) {
  code: 'ERR_REQUIRE_ASYNC_MODULE'
}