chore: remove mocha chai and c8

Author: theorderingmachine

.github/maintainers_guide.md

@@ -15,13 +15,13 @@ All you need to work with this project is a supported version of [Node.js](https
 
 #### Unit Tests
 
-This package has unit tests for most files in the same directory the code is in with the suffix `.spec` (i.e. `exampleFile.spec.ts`). You can run the entire test suite using the npm script `npm test`. This command is also executed by GitHub Actions, the continuous integration service, for every Pull Request and branch. The coverage is computed with the `codecov` package. The tests themselves are run using the `mocha` test runner.
+This package has unit tests for most files in the same directory the code is in with the suffix `.spec` (i.e. `exampleFile.spec.ts`). You can run the entire test suite using the npm script `npm test`. This command is also executed by GitHub Actions, the continuous integration service, for every Pull Request and branch. Coverage is collected with Node.js's built-in test coverage support and uploaded by CI. The tests themselves are run using Node.js's built-in test runner.
 
 Test code should be written in syntax that runs on the oldest supported Node.js version. This ensures that backwards compatibility is tested and the APIs look reasonable in versions of Node.js that do not support the most modern syntax.
 
 #### Debugging
 
-A useful trick for debugging inside tests is to use the Chrome Debugging Protocol feature of Node.js to set breakpoints and interactively debug. In order to do this you must run mocha directly. This means that you should have already linted the source (`npm run lint`), manually. You then run the tests using the following command: `./node_modules/.bin/mocha test/{test-name}.js --debug-brk --inspect` (replace {test-name} with an actual test file).
+A useful trick for debugging inside tests is to use the Chrome Debugging Protocol feature of Node.js to set breakpoints and interactively debug. In order to do this you should have already linted the source (`npm run lint`), manually. You can then run a specific test file with Node.js's test runner, for example: `node --inspect-brk --require ts-node/register --require source-map-support/register --require ./test/unit/node-test-globals.cjs --test test/unit/{test-name}.spec.ts` (replace `{test-name}` with an actual test file path).
 
 #### Local Development
 

.vscode/launch.json

@@ -8,14 +8,23 @@
       "type": "node",
       "request": "launch",
       "name": "Spec tests",
-      "program": "${workspaceFolder}/node_modules/mocha/bin/_mocha",
+      "runtimeExecutable": "node",
       "stopOnEntry": false,
-      "args": ["--config", ".mocharc.json", "--no-timeouts", "src/*.spec.ts", "src/**/*.spec.ts"],
+      "args": [
+        "--inspect-brk",
+        "--require",
+        "ts-node/register",
+        "--require",
+        "source-map-support/register",
+        "--require",
+        "./test/unit/node-test-globals.cjs",
+        "--test",
+        "test/unit/**/*.spec.ts"
+      ],
       "cwd": "${workspaceFolder}",
-      "runtimeExecutable": null,
       "env": {
         "NODE_ENV": "testing",
-        "TS_NODE_PROJECT": "tsconfig.test.json"
+        "TS_NODE_PROJECT": "tsconfig.json"
       },
       "skipFiles": ["<node_internals>/**"]
     }

AGENTS.md

@@ -31,8 +31,8 @@ npm test              # Full pipeline: build -> lint -> type tests -> unit test
 npm run build         # Clean build (rm dist/ + tsc compilation)
 npm run lint          # Biome check (formatting + linting)
 npm run lint:fix      # Biome auto-fix
-npm run test:unit     # Unit tests only (mocha)
-npm run test:coverage # Unit tests with coverage (c8)
+npm run test:unit     # Unit tests only (Node.js test runner)
+npm run test:coverage # Unit tests with built-in Node.js coverage
 npm run test:types    # Type definition tests (tsd)
 npm run watch         # Watch mode for development (rebuilds on src/ changes)
 ```
@@ -171,9 +171,9 @@ test/types/         # tsd type tests
 ### Test Conventions
 
 - **Test files** use `*.spec.ts` suffix
-- **Assertions** use chai (`expect`, `assert`)
+- **Assertions** use the local `test/unit/helpers/assert.ts` compatibility helper backed by Node.js `assert` and Sinon assertions
 - **Mocking** uses sinon (`stub`, `spy`, `fake`) and proxyquire for module-level dependency replacement
-- **Test config** in `test/unit/.mocharc.json`
+- **Test config** lives in `package.json` scripts plus `test/unit/node-test-globals.cjs`
 - **Where to put new tests:** Mirror the source structure. For `src/Foo.ts`, add `test/unit/Foo.spec.ts`. For `src/receivers/Bar.ts`, add `test/unit/receivers/Bar.spec.ts`.
 
 ### CI

package.json

@@ -32,8 +32,8 @@
     "lint": "npx @biomejs/biome check docs src test examples",
     "lint:fix": "npx @biomejs/biome check --write docs src test examples",
     "test": "npm run build && npm run lint && npm run test:types && npm run test:coverage",
-    "test:unit": "TS_NODE_PROJECT=tsconfig.json mocha --config test/unit/.mocharc.json",
-    "test:coverage": "c8 npm run test:unit",
+    "test:unit": "TS_NODE_PROJECT=tsconfig.test.json TS_NODE_FILES=true node --require ts-node/register --require source-map-support/register --require ./test/unit/node-test-globals.cjs --test test/unit/**/*.spec.ts",
+    "test:coverage": "TS_NODE_PROJECT=tsconfig.test.json TS_NODE_FILES=true node --experimental-test-coverage --require ts-node/register --require source-map-support/register --require ./test/unit/node-test-globals.cjs --test test/unit/**/*.spec.ts",
     "test:types": "tsd --files test/types",
     "watch": "npx nodemon --watch 'src' --ext 'ts' --exec npm run build"
   },
@@ -61,15 +61,10 @@
     "@biomejs/biome": "^1.9.0",
     "@changesets/cli": "^2.29.8",
     "@tsconfig/node18": "^18.2.4",
-    "@types/chai": "^4.1.7",
-    "@types/mocha": "^10.0.1",
     "@types/node": "18.19.130",
     "@types/proxyquire": "^1.3.31",
     "@types/sinon": "^17.0.4",
     "@types/tsscmp": "^1.0.0",
-    "c8": "^10.1.2",
-    "chai": "~4.3.0",
-    "mocha": "^10.2.0",
     "proxyquire": "^2.1.3",
     "shx": "^0.3.2",
     "sinon": "^20.0.0",

test/unit/App/basic.spec.ts

@@ -1,5 +1,5 @@
 import { LogLevel } from '@slack/logger';
-import { assert } from 'chai';
+import { assert } from '../helpers/assert';
 import sinon from 'sinon';
 import { ErrorCode } from '../../../src/errors';
 import SocketModeReceiver from '../../../src/receivers/SocketModeReceiver';

test/unit/App/middlewares/arguments.spec.ts

@@ -1,5 +1,5 @@
 import type { WebClient } from '@slack/web-api';
-import { assert } from 'chai';
+import { assert } from '../../helpers/assert';
 import sinon, { type SinonSpy } from 'sinon';
 import { LogLevel } from '../../../../src/App';
 import type { SayStreamFn } from '../../../../src/context/create-say-stream';

test/unit/App/middlewares/global.spec.ts

@@ -1,5 +1,5 @@
 import type { WebClient } from '@slack/web-api';
-import { assert } from 'chai';
+import { assert } from '../../helpers/assert';
 import sinon, { type SinonSpy } from 'sinon';
 import type App from '../../../../src/App';
 import type { ExtendedErrorHandlerArgs } from '../../../../src/App';

test/unit/App/middlewares/listener.spec.ts

@@ -1,4 +1,4 @@
-import { assert } from 'chai';
+import { assert } from '../../helpers/assert';
 import sinon, { type SinonSpy } from 'sinon';
 import type App from '../../../../src/App';
 import { ErrorCode, isCodedError } from '../../../../src/errors';

test/unit/App/routing-action.spec.ts

@@ -1,4 +1,4 @@
-import { assert } from 'chai';
+import { assert } from '../helpers/assert';
 import sinon, { type SinonSpy } from 'sinon';
 import type App from '../../../src/App';
 import {

test/unit/App/routing-function.spec.ts

@@ -1,4 +1,4 @@
-import { assert } from 'chai';
+import { assert } from '../helpers/assert';
 import sinon from 'sinon';
 import type App from '../../../src/App';
 import {