chore: refresh dev tooling stack (plan#2)

Author: mingchuno

.eslintignore

@@ -3,29 +3,31 @@ env:
   node: true
   es6: true
 
+ignorePatterns:
+  - node_modules/*
+  - build/*
+  - coverage/*
+  - example/*
+
 parser: '@typescript-eslint/parser'
 
 parserOptions:
-  ecmaVersion: 9
+  ecmaVersion: 2022
   project: './tsconfig.json'
 
 extends:
-  - standard
-  - prettier
-  - prettier/standard
-  - plugin:eslint-comments/recommended
+  - eslint:recommended
   - plugin:@typescript-eslint/recommended
-  - prettier/@typescript-eslint
+  - plugin:@typescript-eslint/stylistic
+  - plugin:eslint-comments/recommended
+  - plugin:prettier/recommended
 
 plugins:
   - eslint-comments
-  - prettier
   - '@typescript-eslint'
 
 rules:
-  prettier/prettier: error
   camelcase: warn
-  standard/no-callback-literal: off
   '@typescript-eslint/no-unused-vars':
     - warn
     - args: none
@@ -37,5 +39,11 @@ rules:
       ignoreReadBeforeAssign: false
   '@typescript-eslint/explicit-function-return-type': off
   '@typescript-eslint/no-var-requires': off
-  '@typescript-eslint/interface-name-prefix': off
   '@typescript-eslint/ban-ts-comment': off
+  '@typescript-eslint/no-explicit-any': off
+  '@typescript-eslint/consistent-type-definitions': off
+  '@typescript-eslint/consistent-indexed-object-style': off
+  '@typescript-eslint/no-require-imports': off
+
+# TODO(agent): migrate to the flat eslint.config.js format so we can drop the
+# ESLINT_USE_FLAT_CONFIG shim once TypeScript rules are fully modernized.

.eslintrc.yml

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+[ "${HUSKY-}" = "0" ] && exit 0
+
+npx commitlint --edit "$1"

.husky/commit-msg

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+[ "${HUSKY-}" = "0" ] && exit 0
+
+yarn lint-staged

.husky/pre-commit

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Drop Node 12, 14, 16 support
 - Add Node 20, 22, 24 support
 - Clarify compatibility guarantees: require Node >=18.19.0, acknowledge Node 18/20/22/24 LTS plus MongoDB server 4.4-8.0, limit the mongodb peer dependency range to >=5 <8, and expand CI to cover every Node/driver/server combination (drivers 5.x-7.x, servers 4.4-8.0).
+- Refresh developer tooling: bump TypeScript (5.9), Ava (6.x), ESLint (9.x), Prettier (3.x), Husky (9), lint-staged (16), commitlint (20), ts-node (10.9), TypeDoc (0.28), and the @types/* packages so the repo matches modern Node 18+ environments.
 
 ## [5.1.0] - 2023-10-14
 

CHANGELOG.md

@@ -2,8 +2,11 @@
   - Bring the published compatibility story in sync with reality: engines.node still only asserts >=18.12.0, MongoDB is capped to <7, and the README claims MongoDB server 3.6+ (EOL for years) while also saying “mongodb is not a peer dependency” even though it now is (package.json:56-63, README.md:45-55). Bump the
     engine floor so the metadata and docs explicitly cover the currently maintained Node LTS releases (18, 20, 22, 24), extend the peer range to cover MongoDB driver >=5 and <8 plus server 4.4-8.0 (and add corresponding tests), and fix the user-facing docs/badges so consumers aren't misled.
     - [done 2025-11-15] Refine compatibility statements + CI matrix for Node 18/20/22/24, MongoDB server 4.4-8.0, driver >=5<8 (agent: Codex)
+    - TODO(agent): drop src/types/async-disposable.d.ts once tsconfig enables the built-in esnext.disposable lib and the shim is redundant.
   - Refresh the tooling stack: virtually every dev dependency is from 2020 (TypeScript 4.0, Ava 3, ESLint 7, Husky 4, Prettier 2, commitlint 11, etc.), which misses hundreds of bug fixes and no longer understands Node 20/22 typings (package.json:67-107). Plan an across-the-board upgrade (TS ≥5.6, Ava 6, ESLint 9,
     Prettier 3, Husky 9/Lint‑Staged 15, latest @types/*) and run yarn dedupe afterwards.
+    - [done 2025-11-15] Upgrade TS/AVA/ESLint/prettier/husky stacks while keeping Node 18 compatibility (agent: Codex)
+    - TODO(agent): migrate from .eslintrc.yml to an eslint.config.js flat config so ESLINT_USE_FLAT_CONFIG shim can be removed.
   - Examples and fixtures lag far behind: the sample app still consumes connect-mongo@^4.4.0, forces MongoDB 3.6 via Yarn resolutions, and docker-compose.yaml spins up Mongo 4.4 (example/package.json:12-23, docker-compose.yaml:1-11). Update those to your current major, exercise Mongo server 7+, and document SRV/TLS
     flows so contributors can reproduce issues without pinning to obsolete builds.
   - Modernize packaging: you only emit CommonJS (main + typings) yet advertise a non-existent build/module artifact and lack an exports map or dual entry points (package.json:5-8, 28-33, 109-118). Add a build:module/Rollup step (or at least exports: { ".": { "require": "./build/main/index.js", "import": "./build/main/

docs/PLANS.md

@@ -30,9 +30,9 @@
     "build:main": "tsc -p tsconfig.json",
     "fix": "run-s fix:*",
     "fix:prettier": "prettier \"src/**/*.ts\" --write",
-    "fix:lint": "eslint --cache src --ext .ts --fix",
+    "fix:lint": "cross-env ESLINT_USE_FLAT_CONFIG=false eslint --cache src --ext .ts --fix",
     "test": "run-s build test:*",
-    "test:lint": "eslint --cache src --ext .ts",
+    "test:lint": "cross-env ESLINT_USE_FLAT_CONFIG=false eslint --cache src --ext .ts",
     "test:prettier": "prettier \"src/**/*.ts\" --list-different",
     "test:unit": "nyc ava",
     "check-cli": "run-s test diff-integration-tests check-integration-tests",
@@ -46,12 +46,13 @@
     "cov:send": "run-s cov:lcov && codecov",
     "cov:check": "nyc report && nyc check-coverage",
     "doc": "run-s doc:html && open-cli build/docs/index.html",
-    "doc:html": "typedoc src/ --exclude **/*.spec.ts --target ES6 --mode file --out build/docs",
-    "doc:json": "typedoc src/ --exclude **/*.spec.ts --target ES6 --mode file --json build/docs/typedoc.json",
+    "doc:html": "typedoc --entryPointStrategy expand --entryPoints src --exclude **/*.spec.ts --out build/docs",
+    "doc:json": "typedoc --entryPointStrategy expand --entryPoints src --exclude **/*.spec.ts --json build/docs/typedoc.json",
     "doc:publish": "gh-pages -m \"[ci skip] Updates\" -d build/docs",
     "version": "standard-version",
     "reset-hard": "git clean -dfx && git reset --hard && yarn",
-    "prepare-release": "run-s reset-hard test cov:check doc:html version doc:publish"
+    "prepare-release": "run-s reset-hard test cov:check doc:html version doc:publish",
+    "prepare": "husky"
   },
   "engines": {
     "node": ">=18.19.0"
@@ -65,46 +66,41 @@
     "kruptein": "^3.0.0"
   },
   "devDependencies": {
-    "@ava/typescript": "^1.1.1",
-    "@commitlint/cli": "^11.0.0",
-    "@commitlint/config-conventional": "^11.0.0",
+    "@ava/typescript": "^6.0.0",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
     "@istanbuljs/nyc-config-typescript": "^1.0.1",
-    "@types/debug": "^4.1.7",
-    "@types/express": "^4.17.13",
-    "@types/express-session": "^1.17.4",
-    "@types/node": "^14.14.20",
-    "@types/supertest": "^2.0.10",
-    "@typescript-eslint/eslint-plugin": "^4.12.0",
-    "@typescript-eslint/parser": "^4.12.0",
-    "ava": "^3.12.1",
+    "@types/debug": "^4.1.12",
+    "@types/express": "^4.17.21",
+    "@types/express-session": "^1.18.2",
+    "@types/node": "^24.10.1",
+    "@types/supertest": "^6.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
+    "ava": "^6.4.1",
     "codecov": "^3.5.0",
     "cspell": "^4.1.0",
     "cz-conventional-changelog": "^3.3.0",
-    "eslint": "^7.17.0",
-    "eslint-config-prettier": "^7.1.0",
-    "eslint-config-prettier-standard": "^3.0.1",
-    "eslint-config-standard": "^16.0.2",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-eslint-comments": "^3.2.0",
-    "eslint-plugin-import": "^2.22.1",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^3.3.1",
-    "eslint-plugin-promise": "^4.2.1",
-    "eslint-plugin-standard": "^5.0.0",
+    "eslint-plugin-prettier": "^5.5.4",
     "express": "^4.17.1",
     "express-session": "^1.17.1",
     "gh-pages": "^3.1.0",
-    "husky": "4",
-    "lint-staged": "^10.5.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.6",
     "mongodb": "^6.21.0",
     "npm-run-all": "^4.1.5",
     "nyc": "^15.1.0",
     "open-cli": "^6.0.1",
-    "prettier": "^2.2.1",
+    "prettier": "^3.6.2",
     "standard-version": "^9.0.0",
     "supertest": "^6.1.3",
-    "ts-node": "^9.0.0",
-    "typedoc": "^0.19.0",
-    "typescript": "^4.0.2"
+    "ts-node": "^10.9.2",
+    "typedoc": "^0.28.14",
+    "typescript": "^5.9.3",
+    "cross-env": "^10.1.0"
   },
   "files": [
     "build/main",
@@ -122,7 +118,8 @@
     "typescript": {
       "rewritePaths": {
         "src/": "build/main/"
-      }
+      },
+      "compile": false
     },
     "files": [
       "!build/module/**",
@@ -145,15 +142,9 @@
       "**/*.spec.js"
     ]
   },
-  "husky": {
-    "hooks": {
-      "pre-commit": "lint-staged",
-      "commit-msg": "commitlint -E HUSKY_GIT_PARAMS"
-    }
-  },
   "lint-staged": {
-    "*.{js,ts}": [
-      "eslint --fix"
+    "**/*.{ts,js}": [
+      "cross-env ESLINT_USE_FLAT_CONFIG=false eslint --cache --fix"
     ]
   },
   "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"

package.json

@@ -87,44 +87,71 @@ test.serial('basic operation flow', async (t) => {
   t.is(await storePromise.length(), 0)
 })
 
-test.serial.cb('set and listen to event', (t) => {
+test.serial('set and listen to event', async (t) => {
   ;({ store, storePromise } = createStoreHelper())
-  let orgSession = makeData()
   const sid = 'test-set-event'
-  store.set(sid, orgSession)
-  orgSession = JSON.parse(JSON.stringify(orgSession))
-  store.on('set', (sessionId) => {
-    t.is(sessionId, sid)
-    store.get(sid, (err, session) => {
-      t.is(err, null)
-      t.is(typeof session, 'object')
-      t.deepEqual(session, orgSession)
-      t.end()
+  const orgSession = makeData()
+  const expectedSession = JSON.parse(JSON.stringify(orgSession))
+
+  const waitForSet = new Promise<void>((resolve, reject) => {
+    store.once('set', async (sessionId) => {
+      try {
+        t.is(sessionId, sid)
+        const session = await storePromise.get(sid)
+        t.truthy(session)
+        t.is(typeof session, 'object')
+        t.deepEqual(session, expectedSession)
+        resolve()
+      } catch (err) {
+        reject(err)
+      }
     })
   })
+
+  await storePromise.set(sid, orgSession)
+  await waitForSet
 })
 
-test.serial.cb('set and listen to create event', (t) => {
+test.serial('set and listen to create event', async (t) => {
   ;({ store, storePromise } = createStoreHelper())
-  const orgSession = makeData()
   const sid = 'test-create-event'
-  store.set(sid, orgSession)
-  store.on('create', (sessionId) => {
-    t.is(sessionId, sid)
-    t.end()
+  const orgSession = makeData()
+
+  const waitForCreate = new Promise<void>((resolve, reject) => {
+    store.once('create', (sessionId) => {
+      try {
+        t.is(sessionId, sid)
+        resolve()
+      } catch (err) {
+        reject(err)
+      }
+    })
   })
+
+  await storePromise.set(sid, orgSession)
+  await waitForCreate
 })
 
-test.serial.cb('set and listen to update event', (t) => {
+test.serial('set and listen to update event', async (t) => {
   ;({ store, storePromise } = createStoreHelper())
-  const orgSession = makeData()
   const sid = 'test-update-event'
-  store.set(sid, orgSession)
-  store.set(sid, { ...orgSession, foo: 'new-bar' } as SessionData)
-  store.on('update', (sessionId) => {
-    t.is(sessionId, sid)
-    t.end()
+  const orgSession = makeData()
+
+  await storePromise.set(sid, orgSession)
+
+  const waitForUpdate = new Promise<void>((resolve, reject) => {
+    store.once('update', (sessionId) => {
+      try {
+        t.is(sessionId, sid)
+        resolve()
+      } catch (err) {
+        reject(err)
+      }
+    })
   })
+
+  await storePromise.set(sid, { ...orgSession, foo: 'new-bar' } as SessionData)
+  await waitForUpdate
 })
 
 test.serial('set with no stringify', async (t) => {
@@ -146,17 +173,25 @@ test.serial('set with no stringify', async (t) => {
   t.is(await storePromise.length(), 0)
 })
 
-test.serial.cb('test destory event', (t) => {
+test.serial('test destory event', async (t) => {
   ;({ store, storePromise } = createStoreHelper())
   const orgSession = makeData()
   const sid = 'test-destory-event'
-  store.on('destroy', (sessionId) => {
-    t.is(sessionId, sid)
-    t.end()
-  })
-  storePromise.set(sid, orgSession).then(() => {
-    store.destroy(sid)
+
+  const waitForDestroy = new Promise<void>((resolve, reject) => {
+    store.once('destroy', (sessionId) => {
+      try {
+        t.is(sessionId, sid)
+        resolve()
+      } catch (err) {
+        reject(err)
+      }
+    })
   })
+
+  await storePromise.set(sid, orgSession)
+  await storePromise.destroy(sid)
+  await waitForDestroy
 })
 
 test.serial('test set default TTL', async (t) => {