Use TypeScript, ESM, release workflow

.editorconfig

@@ -0,0 +1,11 @@
+# EditorConfig: http://EditorConfig.org
+
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = space
+indent_size = 2

.github/workflows/ci.yml

@@ -1,264 +1,28 @@
-name: ci
+name: CI
 
 on:
-  workflow_dispatch:
-  pull_request:
-  push:
+  - push
+  - pull_request
 
 permissions:
   contents: read
 
 jobs:
-  lint:
-    name: Lint
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-      - name: Setup Node.js
-        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
-        with:
-          node-version: "lts/*"
-
-      - name: Install dependencies
-        run: npm install --ignore-scripts --only=dev
-
-      - name: Run lint
-        run: npm run lint
-
   test:
+    name: Node.js ${{ matrix.node-version }}
     runs-on: ubuntu-latest
     strategy:
-      fail-fast: false
       matrix:
-        name:
-          - Node.js 0.8
-          - Node.js 0.10
-          - Node.js 0.12
-          - io.js 1.x
-          - io.js 2.x
-          - io.js 3.x
-          - Node.js 4.x
-          - Node.js 5.x
-          - Node.js 6.x
-          - Node.js 7.x
-          - Node.js 8.x
-          - Node.js 9.x
-          - Node.js 10.x
-          - Node.js 11.x
-          - Node.js 12.x
-          - Node.js 13.x
-          - Node.js 14.x
-          - Node.js 15.x
-          - Node.js 16.x
-          - Node.js 17.x
-          - Node.js 18.x
-          - Node.js 19.x
-          - Node.js 20.x
-          - Node.js 21.x
-          - Node.js 22.x
-          - Node.js 23.x
-          - Node.js 24.x
-
-        include:
-          - name: Node.js 0.8
-            node-version: "0.8"
-            npm-i: mocha@2.5.3
-            npm-rm: nyc
-
-          - name: Node.js 0.10
-            node-version: "0.10"
-            npm-i: mocha@3.5.3 nyc@10.3.2
-
-          - name: Node.js 0.12
-            node-version: "0.12"
-            npm-i: mocha@3.5.3 nyc@10.3.2
-
-          - name: io.js 1.x
-            node-version: "1.8"
-            npm-i: mocha@3.5.3 nyc@10.3.2
-
-          - name: io.js 2.x
-            node-version: "2.5"
-            npm-i: mocha@3.5.3 nyc@10.3.2
-
-          - name: io.js 3.x
-            node-version: "3.3"
-            npm-i: mocha@3.5.3 nyc@10.3.2
-
-          - name: Node.js 4.x
-            node-version: "4"
-            npm-i: mocha@5.2.0 nyc@11.9.0
-
-          - name: Node.js 5.x
-            node-version: "5"
-            npm-i: mocha@5.2.0 nyc@11.9.0
-
-          - name: Node.js 6.x
-            node-version: "6"
-            npm-i: mocha@6.2.3 nyc@14.1.1
-
-          - name: Node.js 7.x
-            node-version: "7"
-            npm-i: mocha@6.2.3 nyc@14.1.1
-
-          - name: Node.js 8.x
-            node-version: "8"
-            npm-i: mocha@7.2.0 nyc@14.1.1
-
-          - name: Node.js 9.x
-            node-version: "9"
-            npm-i: mocha@7.2.0 nyc@14.1.1
-
-          - name: Node.js 10.x
-            node-version: "10"
-            npm-i: mocha@8.4.0 nyc@15.1.0
-
-          - name: Node.js 11.x
-            node-version: "11"
-            npm-i: mocha@8.4.0 nyc@15.1.0
-
-          - name: Node.js 12.x
-            node-version: "12"
-            npm-i: mocha@9.2.2 nyc@15.1.0
-
-          - name: Node.js 13.x
-            node-version: "13"
-            npm-i: mocha@9.2.2 nyc@15.1.0
-
-          - name: Node.js 14.x
-            node-version: "14"
-            npm-i: mocha@10.8.2 nyc@15.1.0
-
-          - name: Node.js 15.x
-            node-version: "15"
-            npm-i: mocha@9.2.2 nyc@15.1.0
-
-          - name: Node.js 16.x
-            node-version: "16"
-            npm-i: mocha@9.2.2 nyc@15.1.0
-
-          - name: Node.js 17.x
-            node-version: "17"
-            npm-i: mocha@9.2.2 nyc@15.1.0
-
-          - name: Node.js 18.x
-            node-version: "18"
-
-          - name: Node.js 19.x
-            node-version: "19"
-
-          - name: Node.js 20.x
-            node-version: "20"
-
-          - name: Node.js 21.x
-            node-version: "21"
-
-          - name: Node.js 22.x
-            node-version: "22"
-
-          - name: Node.js 23.x
-            node-version: "23"
-
-          - name: Node.js 24.x
-            node-version: "24"
-
+        node-version:
+          - 22
+          - latest
     steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-
-      - name: Install Node.js ${{ matrix.node-version }}
-        shell: bash -eo pipefail -l {0}
-        run: |
-          nvm install --default ${{ matrix.node-version }}
-          if [[ "${{ matrix.node-version }}" == 0.* && "$(cut -d. -f2 <<< "${{ matrix.node-version }}")" -lt 10 ]]; then
-            nvm install --alias=npm 0.10
-            nvm use ${{ matrix.node-version }}
-            sed -i '1s;^.*$;'"$(printf '#!%q' "$(nvm which npm)")"';' "$(readlink -f "$(which npm)")"
-            npm config set strict-ssl false
-          fi
-          dirname "$(nvm which ${{ matrix.node-version }})" >> "$GITHUB_PATH"
-
-      - name: Configure npm
-        run: |
-          if [[ "$(npm config get package-lock)" == "true" ]]; then
-            npm config set package-lock false
-          else
-            npm config set shrinkwrap false
-          fi
-
-      - name: Remove npm module(s) ${{ matrix.npm-rm }}
-        run: npm rm --silent --save-dev ${{ matrix.npm-rm }}
-        if: matrix.npm-rm != ''
-
-      - name: Install npm module(s) ${{ matrix.npm-i }}
-        run: npm install --save-dev ${{ matrix.npm-i }}
-        if: matrix.npm-i != ''
-
-      - name: Setup Node.js version-specific dependencies
-        shell: bash
-        run: |
-          # eslint for linting
-          # - remove on Node.js < 10
-          if [[ "$(cut -d. -f1 <<< "${{ matrix.node-version }}")" -lt 10 ]]; then
-          node -pe 'Object.keys(require("./package").devDependencies).join("\n")' | \
-              grep -E '^eslint(-|$)' | \
-              sort -r | \
-              xargs -n1 npm rm --silent --save-dev
-          fi
-
-      - name: Install Node.js dependencies
-        run: npm install
-
-      - name: List environment
-        id: list_env
-        shell: bash
-        run: |
-          echo "node@$(node -v)"
-          echo "npm@$(npm -v)"
-          npm -s ls ||:
-          (npm -s ls --depth=0 ||:) | awk -F'[ @]' 'NR>1 && $2 { print $2 "=" $3 }' >> "$GITHUB_OUTPUT"
-
-      - name: Run tests
-        shell: bash
-        run: |
-          if npm -ps ls nyc | grep -q nyc; then
-            npm run test-ci
-          else
-            npm test
-          fi
-
-      - name: Upload code coverage
-        if: steps.list_env.outputs.nyc != ''
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
-        with:
-          name: coverage-node-${{ matrix.node-version }}
-          path: ./coverage/lcov.info
-          retention-days: 1
-
-  coverage:
-    needs: test
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      checks: write
-    steps:
-      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
-
-      - name: Install lcov
-        shell: bash
-        run: sudo apt-get -y install lcov
-
-      - name: Collect coverage reports
-        uses: actions/download-artifact@d3f86a106a0bac45b974a628896c90dbdf5c8093 # v4.3.0
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
         with:
-          path: ./coverage
-          pattern: coverage-node-*
-
-      - name: Merge coverage reports
-        shell: bash
-        run: find ./coverage -name lcov.info -exec printf '-a %q\n' {} \; | xargs lcov -o ./lcov.info
-
-      - name: Upload coverage report
-        uses: coverallsapp/github-action@648a8eb78e6d50909eff900e4ec85cab4524a45b # v2.3.6
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - run: npm test
+      - uses: codecov/codecov-action@v7
         with:
-          github-token: ${{ secrets.GITHUB_TOKEN }}
-          file: ./lcov.info
+          name: Node.js ${{ matrix.node-version }}

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+
+permissions:
+  id-token: write # Required for NPM trusted publishing.
+  contents: read
+
+jobs:
+  npm:
+    name: Publish to npm
+    runs-on: ubuntu-latest
+    environment:
+      name: release
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v7
+        with:
+          node-version: latest
+          package-manager-cache: false # Disable automatic npm dependency caching to reduce cache poisoning risk
+      - run: npm ci --ignore-scripts
+      - run: npm test
+      - run: npm stage publish # Runs prepublish script.

.gitignore

@@ -1,5 +1,6 @@
-coverage/
+.vscode/
 node_modules/
+coverage/
+dist/
+*.tsbuildinfo
 npm-debug.log
-package-lock.json
-.nyc_output/