package.json

@@ -62,7 +62,7 @@
 		"@ampproject/remapping": "^2.2.1",
 		"@pvtnbr/eslint-config": "^0.37.0",
 		"@types/cross-spawn": "^6.0.3",
-		"@types/node": "^20.6.0",
+		"@types/node": "^20.9.0",
 		"@types/react": "^18.2.21",
 		"@types/semver": "^7.5.1",
 		"@types/source-map-support": "^0.5.7",
@@ -95,5 +95,10 @@
 		"ignorePatterns": [
 			"tests/fixtures"
 		]
+	},
+	"pnpm": {
+		"patchedDependencies": {
+			"@types/node@20.9.0": "patches/@types__node@20.9.0.patch"
+		}
 	}
 }

patches/@types__node@20.9.0.patch

@@ -0,0 +1,14 @@
+diff --git a/module.d.ts b/module.d.ts
+index 3d04c3303f0eae7b23af318b68bc101ad6fe2613..d7797b36b268f7d4eca81dda508cc17b9f10d159 100644
+--- a/module.d.ts
++++ b/module.d.ts
+@@ -211,7 +211,8 @@ declare module "module" {
+             /**
+              *  An object whose key-value pairs represent the assertions for the module to import
+              */
+-            importAssertions: ImportAssertions;
++            importAssertions?: ImportAssertions;
++            importAttributes?: ImportAssertions;
+         }
+         interface LoadFnOutput {
+             format: ModuleFormat;

src/esm/loaders.ts

@@ -8,6 +8,7 @@ import type { TransformOptions } from 'esbuild';
 import { transform, transformDynamicImport } from '../utils/transform';
 import { resolveTsPath } from '../utils/resolve-ts-path';
 import { installSourceMapSupport, shouldStripSourceMap, stripSourceMap } from '../source-map';
+import { importAttributes } from '../utils/node-features';
 import {
 	tsconfigPathsMatcher,
 	fileMatcher,
@@ -245,6 +246,8 @@ export const resolve: resolve = async function (
 	}
 };
 
+const contextAttributesProperty = importAttributes ? 'importAttributes' : 'importAssertions';
+
 export const load: LoadHook = async function (
 	url,
 	context,
@@ -262,10 +265,11 @@ export const load: LoadHook = async function (
 	}
 
 	if (isJsonPattern.test(url)) {
-		if (!context.importAssertions) {
-			context.importAssertions = {};
+		if (!context[contextAttributesProperty]) {
+			context[contextAttributesProperty] = {};
 		}
-		context.importAssertions.type = 'json';
+
+		context[contextAttributesProperty]!.type = 'json';
 	}
 
 	const loaded = await defaultLoad(url, context);

src/suppress-warnings.cts

@@ -1,16 +1,11 @@
 // Deprecated: Move to preflight.cts & delete entry-point in next major
 
 const ignoreWarnings = new Set([
-	'--experimental-loader is an experimental feature. This feature could change at any time',
-	'Custom ESM Loaders is an experimental feature. This feature could change at any time',
-
 	// Changed in Node v18.13.0 via https://github.com/nodejs/node/pull/45424
 	'Custom ESM Loaders is an experimental feature and might change at any time',
 
 	// For JSON modules via https://github.com/nodejs/node/pull/46901
 	'Import assertions are not a stable feature of the JavaScript language. Avoid relying on their current behavior and syntax as those might change in a future version of Node.js.',
-
-	'`globalPreload` is planned for removal in favor of `initialize`. `globalPreload` is an experimental feature and might change at any time',
 ]);
 
 const { emit } = process;

src/utils/node-features.ts

@@ -16,3 +16,5 @@ const compareNodeVersion = (version: Version) => (
 export const isolatedLoader = compareNodeVersion([20, 0, 0]) >= 0;
 
 export const supportsModuleRegister = compareNodeVersion([20, 6, 0]) >= 0;
+
+export const importAttributes = compareNodeVersion([21, 0, 0]) >= 0;

src/utils/transform/cache.ts

@@ -8,6 +8,21 @@ const getTime = () => Math.floor(Date.now() / 1e8);
 
 const tmpdir = os.tmpdir();
 const noop = () => {};
+
+/**
+ * Cache directory is based on the user's identifier
+ * to avoid permission issues when accessed by a different user
+ */
+const { geteuid } = process;
+const userId = (
+	geteuid
+		// For Linux users with virtual users on CI (e.g. Docker)
+		? geteuid()
+
+		// Use username on Windows because it doesn't have id
+		: os.userInfo().username
+);
+
 class FileCache<ReturnType> extends Map<string, ReturnType> {
 	/**
 	 * By using tmpdir, the expectation is for the OS to clean any files
@@ -22,9 +37,7 @@ class FileCache<ReturnType> extends Map<string, ReturnType> {
 	cacheDirectory = path.join(
 		// Write permissions by anyone
 		tmpdir,
-
-		// Write permissions only by current user
-		`tsx-${os.userInfo().uid}`,
+		`tsx-${userId}`,
 	);
 
 	// Maintained so we can remove it on Windows

tests/utils/node-versions.ts

@@ -1,11 +1,12 @@
 export const nodeVersions = [
-	'20',
+	'21',
 	...(
 		(
 			process.env.CI
 			&& process.platform !== 'win32'
 		)
 			? [
+				'20',
 				'18',
 			] as const
 			: [] as const