feat: TypeScript configs now support top-level await with dynamic imports

- Updated transpiler to enable lib.esnext for latest features including top-level await
- Users can now use 'await import()' in TypeScript config files
- Added test case for top-level await with dynamic environment loading
- This allows dynamic loading of .ts or .js files at runtime using import()
- Bumped version to 4.0.0-beta.18

Example usage:
  const environment = await import('./environments/environment.${env}.js');

Note: IDE may show TypeScript warning but code runs correctly.

Author: kobenguyent

lib/utils/typescript.js

@@ -25,6 +25,9 @@ export async function transpileTypeScript(mainFilePath, typescript) {
       target: 99, // ScriptTarget.ESNext
       esModuleInterop: true,
       allowSyntheticDefaultImports: true,
+      lib: ['lib.esnext.d.ts'], // Enable latest features including top-level await
+      suppressOutputPathCheck: true,
+      skipLibCheck: true,
     })
 
     // Check if the code uses CommonJS globals
@@ -57,6 +60,7 @@ const require = (id) => {
       const hasKnownExt = ext && __knownExts.includes(ext.toLowerCase());
       if (!hasKnownExt) {
         // Try common extensions in order: .js, .cjs, .json, .node
+        // Note: .ts files cannot be required - they need transpilation first
         const extensions = ['.js', '.cjs', '.json', '.node'];
         for (const testExt of extensions) {
           try {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeceptjs",
-  "version": "4.0.0-beta.17",
+  "version": "4.0.0-beta.18",
   "type": "module",
   "description": "Supercharged End 2 End Testing Framework for NodeJS",
   "keywords": [

test/data/typescript-top-level-await/codecept.conf.ts

@@ -0,0 +1,16 @@
+import { E2EEnvironment } from './environments';
+
+// Use top-level await in codecept.conf.ts
+const environment = await E2EEnvironment;
+
+export const config = {
+  tests: './*_test.js',
+  output: './output',
+  helpers: {
+    REST: {
+      endpoint: environment.url,
+      timeout: environment.timeout
+    }
+  },
+  name: 'typescript-top-level-await-test'
+};

test/data/typescript-top-level-await/environments.ts

@@ -0,0 +1,31 @@
+// Test top-level await in TypeScript
+let env = process.env.E2E_ENV || "TEST";
+
+if (process.env.PROD === 'true') {
+    env = 'PROD';
+}
+
+async function loadEnvironment() {
+  const environmentPath = `./environments/environment.${env}.js`;
+  const environmentModule = await import(environmentPath);
+  const environment = environmentModule.default || environmentModule;
+
+  environment.url = process.env.E2E_URL || environment.url;
+
+  if (environment.url.endsWith("/")) {
+      environment.url = environment.url.slice(0, -1);
+  }
+
+  if (!environment.urlApi) {
+      environment.urlApi = `${environment.url}/api`;
+  }
+
+  environment.outputDir = `./../reports/e2e/results/`;
+  environment.env = env;
+
+  console.log(`Parsed E2E environment:`, environment);
+  
+  return environment;
+}
+
+export const E2EEnvironment = loadEnvironment();

test/data/typescript-top-level-await/environments/environment.TEST.js

@@ -0,0 +1,4 @@
+export default {
+  url: 'https://test.example.com',
+  timeout: 10000
+};

test/data/typescript-top-level-await/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "typescript-top-level-await",
+  "version": "1.0.0",
+  "type": "module"
+}

test/unit/config_test.js

@@ -119,4 +119,17 @@ describe('Config', () => {
     expect(cfg.name).to.equal('typescript-require-relative-test')
     delete process.env.E2E_ENV
   })
+
+  it('should load TypeScript config with top-level await and dynamic imports', async () => {
+    const configPath = './test/data/typescript-top-level-await/codecept.conf.ts'
+    process.env.E2E_ENV = 'TEST'
+    const cfg = await config.load(configPath)
+    
+    expect(cfg).to.be.ok
+    expect(cfg.helpers).to.have.property('REST')
+    expect(cfg.helpers.REST.endpoint).to.equal('https://test.example.com')
+    expect(cfg.helpers.REST.timeout).to.equal(10000)
+    expect(cfg.name).to.equal('typescript-top-level-await-test')
+    delete process.env.E2E_ENV
+  })
 })