refactor: use Bun, Biome.js, Lefthook; upgrade packages (#151)

* refactor: use Bun, Biome.js; upgrade packages

* feat: rename Countries JS workflow

* chore: update version to 3.2.0; use lefthook; adjust lock file references

* fix: update biome schema path and improve test assertions

* build: 3.2.0

* feat: rename GitHub Actions workflow for build and test

* fix: update AGENTS.md

* feat: rename packages/test-node to packages/test-js

Author: dmythro

.eslintrc.json

@@ -6,7 +6,7 @@
   - unit tests are passing
   - separate changes with commits where necessary
   - when data needs to be changed, only files within `/data/` were modified
-  - when there is an update for `package.json`, please also push `package-lock.json` changes
+  - when there is an update for `package.json`, please also push `bun.lock` changes
   - no `/dist/` file changes accepted (they are built with every version bump)
 
  -->

.github/pull_request_template.md

@@ -15,29 +15,21 @@ on:
       - '!**README*'
 
 jobs:
-  nodejs:
+  build-test:
     runs-on: ubuntu-latest
 
-    strategy:
-      matrix:
-        node-version: [20, 18]
-
     steps:
       - uses: actions/checkout@v3
 
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v3
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v1
         with:
-          cache: 'npm'
-          node-version: ${{ matrix.node-version }}
+          bun-version: 1.3.0
 
-      - name: NPM install
-        run: npm install --prefer-offline --no-audit
-        env:
-          CI: true
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
 
       - name: Build & Test
-        # Runs lint, build & tests
-        run: npm run ci
+        run: bun run ci
         env:
           CI: true

.github/workflows/nodejs.yml renamed to .github/workflows/build-test.yml

@@ -3,10 +3,8 @@
 
 # IDE
 .idea
-*.lock
 
 coverage
-.eslintcache
 .phpunit.cache
 .turbo
 

.gitignore

@@ -0,0 +1,69 @@
+#!/bin/sh
+
+if [ "$LEFTHOOK_VERBOSE" = "1" -o "$LEFTHOOK_VERBOSE" = "true" ]; then
+  set -x
+fi
+
+if [ "$LEFTHOOK" = "0" ]; then
+  exit 0
+fi
+
+call_lefthook()
+{
+  if test -n "$LEFTHOOK_BIN"
+  then
+    "$LEFTHOOK_BIN" "$@"
+  elif lefthook -h >/dev/null 2>&1
+  then
+    lefthook "$@"
+  else
+    dir="$(git rev-parse --show-toplevel)"
+    osArch=$(uname | tr '[:upper:]' '[:lower:]')
+    cpuArch=$(uname -m | sed 's/aarch64/arm64/;s/x86_64/x64/')
+    if test -f "$dir/node_modules/lefthook-${osArch}-${cpuArch}/bin/lefthook"
+    then
+      "$dir/node_modules/lefthook-${osArch}-${cpuArch}/bin/lefthook" "$@"
+    elif test -f "$dir/node_modules/@evilmartians/lefthook/bin/lefthook-${osArch}-${cpuArch}/lefthook"
+    then
+      "$dir/node_modules/@evilmartians/lefthook/bin/lefthook-${osArch}-${cpuArch}/lefthook" "$@"
+    elif test -f "$dir/node_modules/@evilmartians/lefthook-installer/bin/lefthook"
+    then
+      "$dir/node_modules/@evilmartians/lefthook-installer/bin/lefthook" "$@"
+    elif test -f "$dir/node_modules/lefthook/bin/index.js"
+    then
+      "$dir/node_modules/lefthook/bin/index.js" "$@"
+    
+    elif go tool lefthook -h >/dev/null 2>&1
+    then
+      go tool lefthook "$@"
+    elif bundle exec lefthook -h >/dev/null 2>&1
+    then
+      bundle exec lefthook "$@"
+    elif yarn lefthook -h >/dev/null 2>&1
+    then
+      yarn lefthook "$@"
+    elif pnpm lefthook -h >/dev/null 2>&1
+    then
+      pnpm lefthook "$@"
+    elif swift package lefthook >/dev/null 2>&1
+    then
+      swift package --build-path .build/lefthook --disable-sandbox lefthook "$@"
+    elif command -v mint >/dev/null 2>&1
+    then
+      mint run csjones/lefthook-plugin "$@"
+    elif uv run lefthook -h >/dev/null 2>&1
+    then
+      uv run lefthook "$@"
+    elif mise exec -- lefthook -h >/dev/null 2>&1
+    then
+      mise exec -- lefthook "$@"
+    elif devbox run lefthook -h >/dev/null 2>&1
+    then
+      devbox run lefthook "$@"
+    else
+      echo "Can't find lefthook in PATH"
+    fi
+  fi
+}
+
+call_lefthook run "pre-commit" "$@"

.husky/.gitignore

@@ -0,0 +1,69 @@
+#!/bin/sh
+
+if [ "$LEFTHOOK_VERBOSE" = "1" -o "$LEFTHOOK_VERBOSE" = "true" ]; then
+  set -x
+fi
+
+if [ "$LEFTHOOK" = "0" ]; then
+  exit 0
+fi
+
+call_lefthook()
+{
+  if test -n "$LEFTHOOK_BIN"
+  then
+    "$LEFTHOOK_BIN" "$@"
+  elif lefthook -h >/dev/null 2>&1
+  then
+    lefthook "$@"
+  else
+    dir="$(git rev-parse --show-toplevel)"
+    osArch=$(uname | tr '[:upper:]' '[:lower:]')
+    cpuArch=$(uname -m | sed 's/aarch64/arm64/;s/x86_64/x64/')
+    if test -f "$dir/node_modules/lefthook-${osArch}-${cpuArch}/bin/lefthook"
+    then
+      "$dir/node_modules/lefthook-${osArch}-${cpuArch}/bin/lefthook" "$@"
+    elif test -f "$dir/node_modules/@evilmartians/lefthook/bin/lefthook-${osArch}-${cpuArch}/lefthook"
+    then
+      "$dir/node_modules/@evilmartians/lefthook/bin/lefthook-${osArch}-${cpuArch}/lefthook" "$@"
+    elif test -f "$dir/node_modules/@evilmartians/lefthook-installer/bin/lefthook"
+    then
+      "$dir/node_modules/@evilmartians/lefthook-installer/bin/lefthook" "$@"
+    elif test -f "$dir/node_modules/lefthook/bin/index.js"
+    then
+      "$dir/node_modules/lefthook/bin/index.js" "$@"
+    
+    elif go tool lefthook -h >/dev/null 2>&1
+    then
+      go tool lefthook "$@"
+    elif bundle exec lefthook -h >/dev/null 2>&1
+    then
+      bundle exec lefthook "$@"
+    elif yarn lefthook -h >/dev/null 2>&1
+    then
+      yarn lefthook "$@"
+    elif pnpm lefthook -h >/dev/null 2>&1
+    then
+      pnpm lefthook "$@"
+    elif swift package lefthook >/dev/null 2>&1
+    then
+      swift package --build-path .build/lefthook --disable-sandbox lefthook "$@"
+    elif command -v mint >/dev/null 2>&1
+    then
+      mint run csjones/lefthook-plugin "$@"
+    elif uv run lefthook -h >/dev/null 2>&1
+    then
+      uv run lefthook "$@"
+    elif mise exec -- lefthook -h >/dev/null 2>&1
+    then
+      mise exec -- lefthook "$@"
+    elif devbox run lefthook -h >/dev/null 2>&1
+    then
+      devbox run lefthook "$@"
+    else
+      echo "Can't find lefthook in PATH"
+    fi
+  fi
+}
+
+call_lefthook run "prepare-commit-msg" "$@"

.husky/_/pre-commit

@@ -1,4 +1,4 @@
 #!/usr/bin/env sh
 . "$(dirname "$0")/_/husky.sh"
 
-npx lint-staged
+bunx lefthook run pre-commit

.husky/_/prepare-commit-msg

@@ -0,0 +1,25 @@
+# Agent Instructions
+
+## Commands
+
+- Build: `bun run build` (builds all packages via turbo)
+- Lint: `bun run lint` (runs biome check)
+- Lint fix: `bun run lint:fix` (runs biome check --write)
+- Format: `bun run format` (runs biome format --write)
+- Test: `bun run test` (runs all tests)
+- Single test: `cd packages/test-js && bun test <test-file.test.ts>` (Bun test runner)
+- CI: `bun run ci` (lint + build + test)
+
+## Code Style
+
+- Use Biome for linting and formatting: 100 char width, single quotes, no semicolons, 2 spaces, trailing commas (ES5)
+- TypeScript: Avoid `any` (warn level), use explicit types for exports
+- Imports: Use `.ts` extensions in import paths (e.g., `from './types.ts'`)
+- Naming: camelCase for functions/variables, PascalCase for types/interfaces (prefix `I` for interfaces, `T` for type aliases)
+- Error handling: TypeScript strict mode, no explicit any unless necessary
+- Exports: Named exports only (no default exports)
+- Files: One primary export per file matching filename (e.g., `getCountryData.ts` exports `getCountryData`)
+- Format: Run `bun run format` before committing (enforced by husky pre-commit hook)
+- Code should be clear and self-explanatory as much as possible
+- Do not write any documentation unless it was asked for
+- Do not write unnecessary comments in code, unless: code is not obvious, URLs should be linked to the issue, docs etc