chore: use latest TS module resolution (#8419)

**Motivation**

Use latest `module` and `moduleResolution` for TS.

**Description**

- To use [subpath
imports](https://nodejs.org/api/packages.html#subpath-imports) in the PR
#8320 we need to update the module solution strategy for TS.
- That requires to change the `module` for the TS as well. 
- Earlier tried to stay with `node18` or `node20`, but the `ts-node`
does not work with that.
- Maintaining different tsconfig for ts-node is more of hassle on wrong
run.
- So decided to stick with `nodenext` strategy for `moduleResolution` 

**Steps to test or reproduce**

Run all tests

---------

Co-authored-by: Cayman <[email protected]>

Author: nazarhussain

package.json

@@ -68,7 +68,7 @@
     "supertest": "^6.3.3",
     "ts-node": "^10.9.2",
     "typescript": "^5.9.2",
-    "typescript-docs-verifier": "^2.5.3",
+    "typescript-docs-verifier": "^3.0.1",
     "vite": "^6.0.11",
     "vite-plugin-dts": "^4.5.0",
     "vite-plugin-node-polyfills": "^0.23.0",

packages/api/test/utils/checkAgainstSpec.ts

@@ -1,10 +1,15 @@
-import Ajv, {ErrorObject} from "ajv";
+import ajvPkg, {ErrorObject} from "ajv";
 import {beforeAll, describe, expect, it} from "vitest";
 import {Endpoint, RequestWithBodyCodec, RouteDefinitions, isRequestWithoutBody} from "../../src/utils/types.js";
 import {WireFormat} from "../../src/utils/wireFormat.js";
 import {GenericServerTestCases} from "./genericServerTest.js";
 import {JsonSchema, OpenApiJson, applyRecursively, parseOpenApiSpec} from "./parseOpenApiSpec.js";
 
+// Current Ajv package is a commonjs package which cause problem
+// when we have moduleResolution set to node16
+// This syntax works and tested with Node and Bun both
+const Ajv = ajvPkg.default;
+
 const ajv = new Ajv({
   strict: true,
 });

packages/beacon-node/package.json

@@ -102,7 +102,7 @@
     "@chainsafe/prometheus-gc-stats": "^1.0.0",
     "@chainsafe/pubkey-index-map": "^3.0.0",
     "@chainsafe/ssz": "^1.2.2",
-    "@chainsafe/threads": "^1.11.2",
+    "@chainsafe/threads": "^1.11.3",
     "@crate-crypto/node-eth-kzg": "0.8.0",
     "@ethersproject/abi": "^5.7.0",
     "@fastify/bearer-auth": "^10.0.1",

packages/beacon-node/src/api/rest/swaggerUI.ts

@@ -6,7 +6,8 @@ export async function registerSwaggerUIRoutes(
   opts: BeaconRestApiServerOpts,
   version = ""
 ): Promise<void> {
-  await server.register(await import("@fastify/swagger"), {
+  const {fastifySwagger} = await import("@fastify/swagger");
+  await server.register(fastifySwagger, {
     openapi: {
       info: {
         title: "Lodestar API",
@@ -24,7 +25,8 @@ export async function registerSwaggerUIRoutes(
       tags: opts.api.map((namespace) => ({name: namespace})),
     },
   });
-  await server.register(await import("@fastify/swagger-ui"), {
+  const {fastifySwaggerUi} = await import("@fastify/swagger-ui");
+  await server.register(fastifySwaggerUi, {
     theme: {
       title: "Lodestar API",
       favicon: await getFavicon(),

packages/beacon-node/src/network/core/networkCore.ts

@@ -1,4 +1,4 @@
-import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/dist/src/score/peer-score.js";
+import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
 import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
 import {Connection, PrivateKey} from "@libp2p/interface";
 import {peerIdFromPrivateKey} from "@libp2p/peer-id";

packages/beacon-node/src/network/core/networkCoreWorkerHandler.ts

@@ -1,6 +1,6 @@
 import path from "node:path";
 import workerThreads from "node:worker_threads";
-import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/dist/src/score/peer-score.js";
+import {PeerScoreStatsDump} from "@chainsafe/libp2p-gossipsub/score";
 import {PublishOpts} from "@chainsafe/libp2p-gossipsub/types";
 import {ModuleThread, Thread, Worker, spawn} from "@chainsafe/threads";
 import {privateKeyToProtobuf} from "@libp2p/crypto/keys";

packages/beacon-node/src/network/discv5/worker.ts

@@ -1,7 +1,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import worker from "node:worker_threads";
-import {Discv5} from "@chainsafe/discv5";
+import {Discv5, Discv5EventEmitter} from "@chainsafe/discv5";
 import {ENR, ENRData, SignableENR, SignableENRData} from "@chainsafe/enr";
 import {Observable, Subject} from "@chainsafe/threads/observable";
 import {expose} from "@chainsafe/threads/worker";
@@ -59,7 +59,7 @@ const discv5 = Discv5.create({
   },
   config: workerData.config,
   metricsRegistry,
-});
+}) as Discv5 & Discv5EventEmitter;
 
 // Load boot enrs
 for (const bootEnr of workerData.bootEnrs) {
@@ -93,13 +93,13 @@ const module: Discv5WorkerApi = {
     discv5.enr.set(key, value);
   },
   async kadValues(): Promise<ENRData[]> {
-    return discv5.kadValues().map((enr) => enr.toObject());
+    return discv5.kadValues().map((enr: ENR) => enr.toObject());
   },
   async discoverKadValues(): Promise<void> {
     discv5.kadValues().map(onDiscovered);
   },
   async findRandomNode(): Promise<ENRData[]> {
-    return (await discv5.findRandomNode()).map((enr) => enr.toObject());
+    return (await discv5.findRandomNode()).map((enr: ENR) => enr.toObject());
   },
   discovered() {
     return Observable.from(subject);

packages/beacon-node/test/e2e/doppelganger/doppelganger.test.ts

@@ -4,7 +4,6 @@ import {ChainConfig} from "@lodestar/config";
 import {SLOTS_PER_EPOCH} from "@lodestar/params";
 import {BLSPubkey, Epoch, Slot, phase0, ssz} from "@lodestar/types";
 import {Validator} from "@lodestar/validator";
-import {PubkeyHex} from "@lodestar/validator/src/types";
 import {afterEach, describe, expect, it} from "vitest";
 import {BeaconNode} from "../../../src/node/index.js";
 import {ClockEvent} from "../../../src/util/clock.js";
@@ -14,6 +13,8 @@ import {connect} from "../../utils/network.js";
 import {getDevBeaconNode} from "../../utils/node/beacon.js";
 import {getAndInitDevValidators} from "../../utils/node/validator.js";
 
+type PubkeyHex = string;
+
 // TODO: Reconsider this tests latter.
 // Doppelganger testing can be split in two items:
 // 1. Can a running beacon node detect liveness of the validator?

packages/beacon-node/test/e2e/sync/finalizedSync.test.ts

@@ -1,6 +1,5 @@
 import {fromHexString} from "@chainsafe/ssz";
 import {routes} from "@lodestar/api";
-import {EventData, EventType} from "@lodestar/api/lib/beacon/routes/events.js";
 import {ChainConfig} from "@lodestar/config";
 import {TimestampFormatCode} from "@lodestar/logger";
 import {SLOTS_PER_EPOCH} from "@lodestar/params";
@@ -99,7 +98,7 @@ describe("sync / finalized sync for fulu", () => {
         240000,
         (finalized) => finalized.epoch >= FULU_FORK_EPOCH
       ),
-      waitForEvent<EventData[EventType.head]>(
+      waitForEvent<routes.events.EventData[routes.events.EventType.head]>(
         bn.chain.emitter,
         routes.events.EventType.head,
         100000,
@@ -128,7 +127,7 @@ describe("sync / finalized sync for fulu", () => {
     const headSummary = bn.chain.forkChoice.getHead();
     const head = await bn.db.block.get(fromHexString(headSummary.blockRoot));
     if (!head) throw Error("First beacon node has no head block");
-    const waitForSynced = waitForEvent<EventData[EventType.head]>(
+    const waitForSynced = waitForEvent<routes.events.EventData[routes.events.EventType.head]>(
       bn2.chain.emitter,
       routes.events.EventType.head,
       100000,

packages/beacon-node/test/e2e/sync/unknownBlockSync.test.ts

@@ -1,6 +1,5 @@
 import {fromHexString} from "@chainsafe/ssz";
 import {routes} from "@lodestar/api";
-import {EventData, EventType} from "@lodestar/api/lib/beacon/routes/events.js";
 import {ChainConfig} from "@lodestar/config";
 import {TimestampFormatCode} from "@lodestar/logger";
 import {SLOTS_PER_EPOCH} from "@lodestar/params";
@@ -107,7 +106,7 @@ describe("sync / unknown block sync for fulu", () => {
       afterEachCallbacks.push(() => bn.close().catch(() => {}));
 
       // wait until the 2nd slot of fulu
-      await waitForEvent<EventData[EventType.head]>(
+      await waitForEvent<routes.events.EventData[routes.events.EventType.head]>(
         bn.chain.emitter,
         routes.events.EventType.head,
         240000,
@@ -133,7 +132,7 @@ describe("sync / unknown block sync for fulu", () => {
       const headSummary = bn.chain.forkChoice.getHead();
       const head = await bn.db.block.get(fromHexString(headSummary.blockRoot));
       if (!head) throw Error("First beacon node has no head block");
-      const waitForSynced = waitForEvent<EventData[EventType.head]>(
+      const waitForSynced = waitForEvent<routes.events.EventData[routes.events.EventType.head]>(
         bn2.chain.emitter,
         routes.events.EventType.head,
         100000,