Merge pull request #994 from Availity/feature/build-updates

feat!: migrate to ESM and drop Node 20 support

Author: jordan-a-young

.adiorc.js .adiorc.cjs.adiorc.js renamed to .adiorc.cjs

@@ -4,13 +4,34 @@ This monorepo is managed using [yarn](https://yarnpkg.com/getting-started) and [
 
 ## Installation
 
-Ensure you are running version 20, 22, or 24 of `node` and [yarn](https://classic.yarnpkg.com/en/docs/install#mac-stable) is installed. We recommend using [nvm](https://github.com/nvm-sh/nvm#readme) or [fnm](https://github.com/Schniz/fnm#readme) to manage your installation of `node`.
+Ensure you are running Node.js 22 or 24 (see `engines` in package.json). We recommend using [nvm](https://github.com/nvm-sh/nvm#readme) or [fnm](https://github.com/Schniz/fnm#readme) to manage your Node installation.
 
 ```bash
 node --version
+```
+
+### Setting up Yarn
+
+This repo uses Yarn 4 (defined in `packageManager` in package.json). You can set it up either way:
+
+**Option A: Corepack (recommended)**
+
+Corepack ships with Node.js and automatically uses the correct Yarn version:
+
+```bash
+corepack enable
+```
+
+**Option B: Direct install**
+
+If you don't want to use corepack, install Yarn globally:
+
+```bash
 npm install -g yarn
 ```
 
+### Installing dependencies
+
 Install the dependencies with `yarn`. The first install might take a while. All subsequent installs should proceed more quickly.
 
 ```bash
@@ -55,7 +76,7 @@ The commit messages in this repository are important for two main reasons:
 
 Commits should use the [Angular Commit Format](https://github.com/angular/angular/blob/master/CONTRIBUTING.md#type). Scope should be one of the un-prefixed names of the packages under `./packages/` or `docusaurus` for the docs. If a commit applies to multiple packages, leave out the scope.
 
-For example, here is what the commit message would like when fixing a null-checking error in the [icon](../packages/icon) package:
+For example, here is what the commit message would look like when fixing a null-checking error in the env-var package:
 
 ```bash
 git commit -m "fix(env-var): check for null before doing the action"

.github/CONTRIBUTING.md

@@ -32,10 +32,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        language: ['javascript']
-        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
-        # Learn more:
-        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+        language: ['javascript-typescript']
 
     steps:
       - name: Checkout repository

.github/workflows/codeql-analysis.yml

@@ -1,6 +1,5 @@
 name: Lint Commit Messages
-# Set to pull_request when ready to turn on
-on: [never]
+on: [pull_request]
 
 jobs:
   commitlint:
@@ -15,16 +14,16 @@ jobs:
       - name: Setup Node
         uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
         with:
-          node-version: 22
+          node-version: 24
           cache: 'yarn'
           cache-dependency-path: 'yarn.lock'
 
       - name: Install Dependencies
         run: yarn install --immutable
 
       - name: Lint Commit Message
-        uses: wagoid/commitlint-github-action@9763196e10f27aef304c9b8b660d31d97fce0f99 # v5.5.1
+        uses: wagoid/commitlint-github-action@b948419dd99f3fd78a6548d48f94e3df7f6bf3ed # v6.2.1
         env:
           NODE_PATH: ${{ github.workspace }}/node_modules
         with:
-          configFile: ${{ github.workspace }}/commitlint.config.js
+          configFile: ${{ github.workspace }}/commitlint.config.cjs

.github/workflows/commitlint.yml

@@ -53,6 +53,14 @@ jobs:
       - name: Install Dependencies
         run: yarn install --immutable
 
+      - name: Restore Nx Cache
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: .nx/cache
+          key: nx-${{ runner.os }}-${{ hashFiles('yarn.lock') }}-${{ github.sha }}
+          restore-keys: |
+            nx-${{ runner.os }}-${{ hashFiles('yarn.lock') }}-
+
       - name: Lint Source Code
         run: yarn lint
 
@@ -94,6 +102,14 @@ jobs:
       - name: Install Dependencies
         run: yarn install --immutable
 
+      - name: Restore Nx Cache
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: .nx/cache
+          key: nx-${{ runner.os }}-${{ hashFiles('yarn.lock') }}-${{ github.sha }}
+          restore-keys: |
+            nx-${{ runner.os }}-${{ hashFiles('yarn.lock') }}-
+
       - name: Build Packages
         run: yarn build
 

.github/workflows/deploy.yml

@@ -33,25 +33,17 @@ jobs:
           cache: 'yarn'
           cache-dependency-path: 'yarn.lock'
 
-      # - name: Get yarn cache directory path
-      #   id: yarn-cache-dir-path
-      #   run: echo "dir=$(yarn config get cacheFolder)" >> $GITHUB_OUTPUT
-
-      # - name: Restore yarn cache
-      #   uses: actions/cache@v3
-      #   id: yarn-cache
-      #   with:
-      #     path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-      #     key: ${{ runner.os }}-${{ matrix.node }}-yarn-${{ hashFiles('yarn.lock') }}
-      #     restore-keys: |
-      #       ${{ runner.os }}-${{ matrix.node }}-yarn-
-
-      # - name: Artifactory Check
-      #   run: yarn check:registry
-
       - name: Install Dependencies
         run: yarn install --immutable
 
+      - name: Restore Nx Cache
+        uses: actions/cache@5a3ec84eff668545956fd18022155c47e93e2684 # v4.2.3
+        with:
+          path: .nx/cache
+          key: nx-${{ runner.os }}-${{ matrix.node }}-${{ hashFiles('yarn.lock') }}-${{ github.sha }}
+          restore-keys: |
+            nx-${{ runner.os }}-${{ matrix.node }}-${{ hashFiles('yarn.lock') }}-
+
       - name: Lint
         run: yarn nx affected --target=lint
 

.github/workflows/pr-build.yml

@@ -15,6 +15,12 @@ jobs:
         uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
         with:
           fetch-depth: 0
+      - name: Set Node Version
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: 24
+          cache: 'yarn'
+          cache-dependency-path: 'yarn.lock'
       - name: Install Dependencies
         run: yarn install --immutable
       - name: Run Code Coverage Report

.github/workflows/repo-metrics.yml

@@ -1,3 +1,2 @@
-yarn lint:affected
 yarn test:affected
 yarn check:registry