fix TS backwards compat following ControlledTransaction. (#1193)

.github/workflows/test.yml

@@ -208,5 +208,8 @@ jobs:
       - name: Install older TypeScript
         run: npm i -D typescript@${{ matrix.typescript-version }} tsd@${{ fromJson('{ "^4.6":"0.20.0", "^4.7":"0.22.0", "^4.8":"0.24.1", "^4.9":"0.27.0", "^5.0":"0.28.1", "^5.2":"0.29.0", "^5.3":"0.30.7", "^5.4":"0.31.2" }')[matrix.typescript-version] }}
 
+      - name: Exclude non-backward compatible tests
+        run: npx tsx ./scripts/exclude-test-files-for-backwards-compat.mts
+
       - name: Run tests with older TypeScript
         run: npm run test:typings && npm run test:node:build

package.json

@@ -80,6 +80,7 @@
     "@types/node": "^22.5.0",
     "@types/pg": "^8.11.6",
     "@types/pg-cursor": "^2.7.2",
+    "@types/semver": "^7.5.8",
     "@types/sinon": "^17.0.2",
     "@types/tedious": "^4.0.9",
     "better-sqlite3": "^11.2.1",
@@ -90,14 +91,17 @@
     "lodash": "^4.17.21",
     "mocha": "^10.7.3",
     "mysql2": "^3.11.0",
+    "pathe": "^1.1.2",
     "pg": "^8.12.0",
     "pg-cursor": "^2.11.0",
     "playwright": "^1.46.1",
     "prettier": "^3.3.3",
+    "semver": "^7.6.3",
     "sinon": "^18.0.0",
     "tarn": "^3.0.2",
     "tedious": "^19.0.0",
     "tsd": "^0.31.1",
+    "tsx": "^4.19.1",
     "typescript": "^5.6.3"
   }
 }

scripts/exclude-test-files-for-backwards-compat.mts

@@ -0,0 +1,22 @@
+import { writeFile } from 'node:fs/promises'
+import { dirname, resolve } from 'pathe'
+import { lt } from 'semver'
+import { devDependencies } from '../package.json'
+
+const typescriptVersion = devDependencies.typescript.replace('^', '')
+const testTsConfigRelativePath = '../test/node/tsconfig.json'
+
+if (lt(typescriptVersion, '5.0.0')) {
+  const tsconfig = await import('../test/node/tsconfig.json')
+
+  await writeFile(
+    resolve(
+      dirname(new URL(import.meta.url).pathname),
+      testTsConfigRelativePath,
+    ),
+    JSON.stringify({
+      ...tsconfig,
+      exclude: [...(tsconfig.exclude || []), 'src/async-dispose.test.ts'],
+    }),
+  )
+}