feat(esm): Phase 4 - Convert remaining lib infrastructure files to ESM

Converted the last 12 files in lib/ directory to ES modules:
- Helpers: AI.js, Appium.js, GraphQL.js, GraphQLDataFactory.js
- Listeners: steps.js, retryEnhancer.js, enhancedGlobalRetry.js
- Plugins: enhancedRetryFailedStep.js, htmlReporter.js
- Support: retryCoordinator.js, test-server.js, clientscripts/PollyWebDriverExt.js

All files now use import/export statements instead of require/module.exports.
Added __dirname polyfills to test-server.js for CLI usage.
All core library files are now fully converted to ESM.

Author: kobenguyent

lib/helper/AI.js

@@ -1,13 +1,13 @@
-const HelperModule = require('@codeceptjs/helper')
-const ora = require('ora-classic')
-const fs = require('fs')
-const path = require('path')
-const ai = require('../ai')
-const Container = require('../container')
-const { splitByChunks, minifyHtml } = require('../html')
-const { beautify } = require('../utils')
-const output = require('../output')
-const { registerVariable } = require('../pause')
+import HelperModule from '@codeceptjs/helper'
+import ora from 'ora-classic'
+import fs from 'fs'
+import path from 'path'
+import ai from '../ai.js'
+import Container from '../container.js'
+import { splitByChunks, minifyHtml } from '../html.js'
+import { beautify } from '../utils.js'
+import output from '../output.js'
+import { registerVariable } from '../pause.js'
 
 const standardActingHelpers = Container.STANDARD_ACTING_HELPERS
 
@@ -211,4 +211,4 @@ class AI extends Helper {
   }
 }
 
-module.exports = AI
+export default AI

lib/helper/Appium.js

@@ -1,15 +1,15 @@
 let webdriverio
 
-const fs = require('fs')
-const axios = require('axios').default
-const { v4: uuidv4 } = require('uuid')
+import fs from 'fs'
+import axios from 'axios'
+import { v4 as uuidv4 } from 'uuid'
 
-const Webdriver = require('./WebDriver')
-const AssertionFailedError = require('../assert/error')
-const { truth } = require('../assert/truth')
-const recorder = require('../recorder')
-const Locator = require('../locator')
-const ConnectionRefused = require('./errors/ConnectionRefused')
+import Webdriver from './WebDriver.js'
+import AssertionFailedError from '../assert/error.js'
+import { truth } from '../assert/truth.js'
+import recorder from '../recorder.js'
+import Locator from '../locator.js'
+import ConnectionRefused from './errors/ConnectionRefused.js'
 
 const mobileRoot = '//*'
 const webRoot = 'body'
@@ -1908,4 +1908,4 @@ function onlyForApps(expectedPlatform) {
   }
 }
 
-module.exports = Appium
+export default Appium

lib/helper/GraphQL.js

@@ -1,5 +1,5 @@
-const axios = require('axios').default
-const HelperModule = require('@codeceptjs/helper')
+import axios from 'axios'
+import HelperModule from '@codeceptjs/helper'
 
 /**
  * GraphQL helper allows to send additional requests to a GraphQl endpoint during acceptance tests.
@@ -227,4 +227,4 @@ class GraphQL extends Helper {
     this.haveRequestHeaders({ Authorization: `Bearer ${accessToken}` })
   }
 }
-module.exports = GraphQL
+export default GraphQL

lib/helper/GraphQLDataFactory.js

@@ -1,7 +1,7 @@
-const path = require('path')
+import path from 'path'
 
-const HelperModule = require('@codeceptjs/helper')
-const GraphQL = require('./GraphQL')
+import HelperModule from '@codeceptjs/helper'
+import GraphQL from './GraphQL.js'
 
 /**
  * Helper for managing remote data using GraphQL queries.
@@ -305,4 +305,4 @@ class GraphQLDataFactory extends Helper {
   }
 }
 
-module.exports = GraphQLDataFactory
+export default GraphQLDataFactory

lib/helper/clientscripts/PollyWebDriverExt.js

@@ -108,4 +108,4 @@ const pollyWebDriver = {
   },
 };
 
-module.exports = pollyWebDriver;
+export default pollyWebDriver;

lib/listener/enhancedGlobalRetry.js

@@ -1,7 +1,7 @@
-const event = require('../event')
-const output = require('../output')
-const Config = require('../config')
-const { isNotSet } = require('../utils')
+import event from '../event.js'
+import output from '../output.js'
+import Config from '../config.js'
+import { isNotSet } from '../utils.js'
 
 const hooks = ['Before', 'After', 'BeforeSuite', 'AfterSuite']
 
@@ -20,7 +20,7 @@ const RETRY_PRIORITIES = {
 /**
  * Enhanced global retry mechanism that coordinates with other retry types
  */
-module.exports = function () {
+export default function () {
   event.dispatcher.on(event.suite.before, suite => {
     let retryConfig = Config.get('retry')
     if (!retryConfig) return
@@ -107,4 +107,4 @@ module.exports = function () {
 }
 
 // Export priority constants for use by other retry mechanisms
-module.exports.RETRY_PRIORITIES = RETRY_PRIORITIES
+export { RETRY_PRIORITIES }

lib/listener/retryEnhancer.js

@@ -1,11 +1,11 @@
-const event = require('../event')
-const { enhanceMochaTest } = require('../mocha/test')
+import event from '../event.js'
+import { enhanceMochaTest } from '../mocha/test.js'
 
 /**
  * Enhance retried tests by copying CodeceptJS-specific properties from the original test
  * This fixes the issue where Mocha's shallow clone during retries loses CodeceptJS properties
  */
-module.exports = function () {
+export default function () {
   event.dispatcher.on(event.test.before, test => {
     // Check if this test is a retry (has a reference to the original test)
     const originalTest = test.retriedTest && test.retriedTest()

lib/listener/steps.js

@@ -1,9 +1,10 @@
-const debug = require('debug')('codeceptjs:steps')
-const event = require('../event')
-const store = require('../store')
-const output = require('../output')
-const { BeforeHook, AfterHook, BeforeSuiteHook, AfterSuiteHook } = require('../mocha/hooks')
-const recorder = require('../recorder')
+import debugModule from 'debug'
+const debug = debugModule('codeceptjs:steps')
+import event from '../event.js'
+import store from '../store.js'
+import output from '../output.js'
+import { BeforeHook, AfterHook, BeforeSuiteHook, AfterSuiteHook } from '../mocha/hooks.js'
+import recorder from '../recorder.js'
 
 let currentTest
 let currentHook

lib/plugin/enhancedRetryFailedStep.js

@@ -1,8 +1,8 @@
-const event = require('../event')
-const recorder = require('../recorder')
-const store = require('../store')
-const output = require('../output')
-const { RETRY_PRIORITIES } = require('../retryCoordinator')
+import event from '../event.js'
+import recorder from '../recorder.js'
+import store from '../store.js'
+import output from '../output.js'
+import { RETRY_PRIORITIES } from '../retryCoordinator.js'
 
 const defaultConfig = {
   retries: 3,
@@ -17,7 +17,7 @@ const defaultConfig = {
  * This plugin provides step-level retries and coordinates with global retry settings
  * to avoid conflicts and provide predictable behavior.
  */
-module.exports = config => {
+export default config => {
   config = Object.assign({}, defaultConfig, config)
   config.ignoredSteps = config.ignoredSteps.concat(config.defaultIgnoredSteps)
   const customWhen = config.when

lib/plugin/htmlReporter.js

@@ -2,17 +2,17 @@
 // TypeScript: Import Node.js types for process, fs, path, etc.
 /// <reference types="node" />
 
-const fs = require('fs')
-const path = require('path')
-const mkdirp = require('mkdirp')
-const crypto = require('crypto')
-const { threadId } = require('worker_threads')
-const { template } = require('../utils')
-const { getMachineInfo } = require('../command/info')
-
-const event = require('../event')
-const output = require('../output')
-const Codecept = require('../codecept')
+import fs from 'fs'
+import path from 'path'
+import mkdirp from 'mkdirp'
+import crypto from 'crypto'
+import { threadId } from 'worker_threads'
+import { template } from '../utils.js'
+import { getMachineInfo } from '../command/info.js'
+
+import event from '../event.js'
+import output from '../output.js'
+import Codecept from '../codecept.js'
 
 const defaultConfig = {
   output: typeof global !== 'undefined' && global.output_dir ? global.output_dir : './output',
@@ -62,7 +62,7 @@ const defaultConfig = {
  * }
  * ```
  */
-module.exports = function (config) {
+export default function (config) {
   const options = { ...defaultConfig, ...config }
   /**
    * TypeScript: Explicitly type reportData arrays as any[] to avoid 'never' errors