chore: migrate to biome, vitest, and next.js 15

Replace ESLint/Prettier with Biome for faster linting and formatting.
Replace Jest with Vitest for modern testing. Replace node-mocks-http
with next-test-api-route-handler for better Next.js integration.
Upgrade to Next.js 15 with backward compatibility for v12-15.

- Node.js 16+ still required (no changes)
- Consumers using Next.js 12-15 remain supported
- Add: @biomejs/biome, vitest, @vitest/ui, next-test-api-route-handler
- Add: react, react-dom, @types/react (dev/test dependencies)
- Remove: eslint and plugins, prettier, jest, ts-jest, node-mocks-http
- Update: next (12.3.0 -> 15.0.3), @types/node, commitlint, husky
- Add: biome.json, vitest.config.ts, tsconfig.build.json
- Remove: .eslintrc.js, .prettierrc.js, jest.config.js
- Update: tsconfig.json (added vitest types, separate build config)
- Convert: commitlint.config.js -> commitlint.config.ts
- Add: typecheck, lint:fix, format, test:watch
- Update: lint (biome), test (vitest), build (use tsconfig.build.json)
- Update imports to use node: protocol (e.g., node:fs/promises)
- Add explicit vitest imports to test file
- Rewrite all tests to use testApiHandler with pagesHandler

All tests passing: typecheck ✓, lint ✓, build ✓, tests 9/9 ✓

Author: JackCuthbert

.eslintrc.js

@@ -1 +1,3 @@
-dist/
+dist/
+node_modules/
+.claude/

.gitignore

@@ -1,4 +1,4 @@
-Copyright © 2022 Bueno Systems
+Copyright © 2025 Bueno Systems
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
 

.prettierrc.js

@@ -0,0 +1,102 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "ignore": ["node_modules", "dist", ".husky", ".claude"]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 80
+  },
+  "javascript": {
+    "globals": [],
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "asNeeded",
+      "trailingCommas": "none",
+      "arrowParentheses": "asNeeded"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "complexity": {
+        "noExtraBooleanCast": "error",
+        "noMultipleSpacesInRegularExpressionLiterals": "error",
+        "noUselessCatch": "error",
+        "noUselessTypeConstraint": "error",
+        "noWith": "error"
+      },
+      "correctness": {
+        "noConstAssign": "error",
+        "noConstantCondition": "error",
+        "noEmptyCharacterClassInRegex": "error",
+        "noEmptyPattern": "error",
+        "noGlobalObjectCalls": "error",
+        "noInnerDeclarations": "error",
+        "noInvalidConstructorSuper": "error",
+        "noNewSymbol": "error",
+        "noNonoctalDecimalEscape": "error",
+        "noPrecisionLoss": "error",
+        "noSelfAssign": "error",
+        "noSetterReturn": "error",
+        "noSwitchDeclarations": "error",
+        "noUndeclaredVariables": "error",
+        "noUnreachable": "error",
+        "noUnreachableSuper": "error",
+        "noUnsafeFinally": "error",
+        "noUnsafeOptionalChaining": "error",
+        "noUnusedLabels": "error",
+        "noUnusedVariables": "error",
+        "useIsNan": "error",
+        "useValidForDirection": "error",
+        "useYield": "error"
+      },
+      "style": {
+        "noArguments": "error",
+        "noVar": "error",
+        "useConst": "error"
+      },
+      "suspicious": {
+        "noAsyncPromiseExecutor": "error",
+        "noCatchAssign": "error",
+        "noClassAssign": "error",
+        "noCompareNegZero": "error",
+        "noControlCharactersInRegex": "error",
+        "noDebugger": "error",
+        "noDoubleEquals": "error",
+        "noDuplicateCase": "error",
+        "noDuplicateClassMembers": "error",
+        "noDuplicateObjectKeys": "error",
+        "noDuplicateParameters": "error",
+        "noEmptyBlockStatements": "error",
+        "noExplicitAny": "off",
+        "noExtraNonNullAssertion": "error",
+        "noFallthroughSwitchClause": "error",
+        "noFunctionAssign": "error",
+        "noGlobalAssign": "error",
+        "noImportAssign": "error",
+        "noMisleadingCharacterClass": "error",
+        "noMisleadingInstantiator": "error",
+        "noPrototypeBuiltins": "error",
+        "noRedeclare": "error",
+        "noShadowRestrictedNames": "error",
+        "noUnsafeDeclarationMerging": "error",
+        "noUnsafeNegation": "error",
+        "useGetterReturn": "error",
+        "useValidTypeof": "error"
+      }
+    }
+  },
+  "organizeImports": {
+    "enabled": true
+  }
+}

LICENSE

@@ -1,4 +1,4 @@
-module.exports = {
+export default {
   extends: ['@commitlint/config-conventional'],
   rules: {
     // To have appropriate formatting when viewed in source control UI

biome.json

@@ -0,0 +1,2 @@
+[tools]
+node = "24.11.1"

commitlint.config.js commitlint.config.tscommitlint.config.js renamed to commitlint.config.ts

@@ -9,14 +9,16 @@
   "license": "MIT",
   "private": false,
   "scripts": {
-    "build": "tsc -b",
+    "build": "tsc -p tsconfig.build.json",
     "prepublish": "yarn build",
-    "lint": "eslint --ext .js,.ts,.tsx .",
-    "test": "jest"
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "engines": {
     "node": ">=16.0.0"
   },
@@ -36,39 +38,29 @@
     "url": "git+https://github.com/bueno-systems/next-actuator.git"
   },
   "release": {
-    "branches": [
-      "main",
-      "next"
-    ]
+    "branches": ["main", "next"]
   },
   "publishConfig": {
     "access": "public"
   },
   "homepage": "https://github.com/bueno-systems/next-actuator#readme",
   "devDependencies": {
-    "@commitlint/cli": "^17.1.2",
-    "@commitlint/config-conventional": "^17.1.0",
-    "@types/jest": "^29.0.3",
-    "@types/node": "^18.7.18",
-    "@typescript-eslint/eslint-plugin": "^5.37.0",
-    "eslint": "^8.23.1",
-    "eslint-config-prettier": "^8.5.0",
-    "eslint-config-standard-with-typescript": "^23.0.0",
-    "eslint-plugin-import": "^2.26.0",
-    "eslint-plugin-n": "^15.2.5",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^4.2.1",
-    "eslint-plugin-promise": "^6.0.1",
-    "husky": "^8.0.0",
-    "jest": "^29.0.3",
-    "next": "^12.3.0",
-    "node-mocks-http": "^1.11.0",
-    "prettier": "^2.7.1",
-    "semantic-release": "^19.0.5",
-    "ts-jest": "^29.0.1",
-    "typescript": "^4.8.3"
+    "@biomejs/biome": "^1.9.4",
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@types/node": "^22.10.1",
+    "@types/react": "^19.0.1",
+    "@vitest/ui": "^2.1.8",
+    "husky": "^9.1.7",
+    "next": "^15.0.3",
+    "next-test-api-route-handler": "^4.0.10",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "semantic-release": "^25.0.2",
+    "typescript": "^4.8.3",
+    "vitest": "^2.1.8"
   },
   "peerDependencies": {
-    "next": ">=12.0.0"
+    "next": "^12 || ^13 || ^14 || ^15"
   }
 }