v7

.cursor/Dockerfile

@@ -1,5 +1,5 @@
 # [Choice] Node.js version (use -bullseye variants on local arm64/Apple Silicon): 18, 16, 14, 18-bullseye, 16-bullseye, 14-bullseye, 18-buster, 16-buster, 14-buster
-ARG VARIANT=16-bullseye
+ARG VARIANT=18-bullseye
 FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${VARIANT}
 
 USER root
@@ -32,8 +32,10 @@ RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
     && mkdir -p /root/.local/share \
     && tldr -u
 
-# Install specific yarn version globally
-RUN npm install -g "yarn@2.4.3"
+# Install pnpm globally
+RUN npm i -g corepack@latest
+RUN corepack enable
+RUN corepack install
 
 # Install pre-commit globally (this doesn't need the repo to be present)
 RUN pip3 install pre-commit
@@ -47,6 +49,6 @@ WORKDIR /home/ubuntu
 
 # The agent will handle:
 # 1. Cloning the repository
-# 2. Running `yarn install`
-# 3. Running `yarn tsc --build`
+# 2. Running `pnpm install`
+# 3. Running `pnpm exec tsc --build`
 # 4. Setting up pre-commit hooks

.cursor/environment.json

@@ -3,35 +3,35 @@
     "context": ".",
     "dockerfile": "Dockerfile"
   },
-  "install": "yarn install",
+  "install": "pnpm install",
   "terminals": [
     {
-      "name": "yarn build",
+      "name": "pnpm build",
       "description": "Build the project",
-      "command": "yarn build"
+      "command": "pnpm build"
     },
     {
-      "name": "yarn clean",
+      "name": "pnpm clean",
       "description": "Clean the project",
-      "command": "yarn clean"
+      "command": "pnpm clean"
     },
     {
-      "name": "yarn lint",
+      "name": "pnpm lint",
       "description": "Lint the project",
-      "command": "yarn lint"
+      "command": "pnpm lint"
     },
     {
-      "name": "yarn prepublish",
+      "name": "pnpm prepublish",
       "description": "Pre-publish the project",
-      "command": "yarn prepublish"
+      "command": "pnpm prepublish"
     },
     {
-      "name": "yarn test",
+      "name": "pnpm test",
       "description": "Test the project",
-      "command": "yarn test"
+      "command": "pnpm test"
     },
     {
-      "name": "pre-commit",
+      "name": "pnpm pre-commit",
       "description": "Run pre-commit hooks on changed files",
       "command": "pre-commit"
     },

.depcheckrc

@@ -1 +1 @@
-ignores: ["@yarnpkg/sdks", "depcheck", "prettier"]
+ignores: ["depcheck", "prettier", "doctoc"]

.devcontainer/Dockerfile

@@ -1,5 +1,5 @@
 # [Choice] Node.js version (use -bullseye variants on local arm64/Apple Silicon): 18, 16, 14, 18-bullseye, 16-bullseye, 14-bullseye, 18-buster, 16-buster, 14-buster
-ARG VARIANT=16-bullseye
+ARG VARIANT=18-bullseye
 FROM mcr.microsoft.com/vscode/devcontainers/javascript-node:0-${VARIANT}
 
 USER root

.devcontainer/devcontainer.json

@@ -12,8 +12,6 @@
   "customizations": {
     "vscode": {
       "extensions": [
-        "arcanis.vscode-zipfs",
-        "slevesque.vscode-zipexplorer",
         "dbaeumer.vscode-eslint",
         "esbenp.prettier-vscode",
         "bcanzanella.openmatchingfiles",

.devcontainer/docker-compose.yml

@@ -7,7 +7,7 @@ services:
       context: ..
       dockerfile: .devcontainer/Dockerfile
       args:
-        VARIANT: 16-bullseye
+        VARIANT: 18-bullseye
 
     volumes:
       - ..:/workspaces/main:cached

.eslintignore

@@ -1,14 +1,12 @@
 .gitignore
 .git/*
-.yarn/*
 **/docs/*
 **/package.json
 **/node_modules/*
 **/build/*
 **/dist/*
 **/builds/*
 **/coverage/*
-**/.yarn/*
 *.testjs
 *.testts
 examples/code-scanning/test-package-json/src/*

.eslintrc.js → .eslintrc.cjs

@@ -74,6 +74,8 @@ module.exports = {
 
     /** handled by no-restricted-syntax */
     'guard-for-in': 0,
+    'no-restricted-syntax': 0,
+    'no-await-in-loop': 0,
 
     /**
      * We prefer to use types instead of interfaces
@@ -249,6 +251,33 @@ module.exports = {
     '@typescript-eslint/ban-types': ['error'],
     '@typescript-eslint/no-explicit-any': ['error'],
   },
+  overrides: [
+    {
+      files: ['src/commands/**/*'],
+      rules: {
+        'max-len': 'off',
+        'max-lines': 'off',
+        'jsdoc/require-jsdoc': 'off',
+      },
+    },
+    {
+      files: [
+        '**/*.test.ts',
+        '**/*.test.js',
+        '**/*.spec.ts',
+        '**/*.spec.js',
+        './scripts/**/*',
+      ],
+      rules: {
+        'import/no-extraneous-dependencies': [
+          'error',
+          {
+            devDependencies: true,
+          },
+        ],
+      },
+    },
+  ],
   settings: {
     /** Allow for typescript alias resolution */
     'import/resolver': {

.github/commands/dependencies/install_deps/action.yml

@@ -0,0 +1,36 @@
+name: Install pnpm Dependencies
+description: Installs pnpm Dependencies
+runs:
+  using: 'composite'
+  steps:
+    # Install pnpm dependencies (see https://github.com/pnpm/action-setup?tab=readme-ov-file#use-cache-to-reduce-installation-time)
+    - uses: pnpm/action-setup@v4
+      name: Install pnpm
+      with:
+        run_install: false
+
+    - name: Install Node.js
+      uses: actions/setup-node@v4
+      with:
+        cache: 'pnpm'
+        node-version-file: '.nvmrc'
+        registry-url: https://registry.npmjs.org
+
+    - name: Get pnpm store directory
+      shell: bash
+      run: |
+        echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+    - uses: actions/cache@v4
+      name: Setup pnpm cache
+      with:
+        path: ${{ env.STORE_PATH }}
+        key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+        restore-keys: |
+          ${{ runner.os }}-pnpm-store-
+
+    - name: Install dependencies
+      run: pnpm install
+      shell: bash
+# Note: You don't need to run pnpm store prune at the end; post-action has already taken care of that.
+

.github/workflows/ci.yml

@@ -6,55 +6,36 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Use Node.js 18.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-      - run: yarn
+      - uses: ./.github/commands/dependencies/install_deps
       - name: Build the typescript code
-        run: yarn build
+        run: pnpm build
       - uses: actions/upload-artifact@v4
         with:
           name: build artifacts
-          path: build/
+          path: dist/
 
-  run-mocha:
+  run-vitest:
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        node-version: [18.x]
     steps:
       - uses: actions/checkout@v4
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      - run: yarn
-      - run: yarn test
+      - uses: ./.github/commands/dependencies/install_deps
+      - run: pnpm test
 
   run-depcheck:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Use Node.js 18.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-      - run: yarn
-      - run: yarn depcheck
+      - uses: ./.github/commands/dependencies/install_deps
+      - run: pnpm depcheck
 
-  generate-json-schema:
+  generate:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Use Node.js 18.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-      - run: yarn
-      - run: yarn script:transcend-json-schema
-      - run: yarn script:pathfinder-json-schema
+      - uses: ./.github/commands/dependencies/install_deps
+      - run: pnpm script:transcend-json-schema
+      - run: pnpm script:pathfinder-json-schema
+      - run: pnpm script:build-readme-docs
       - name: Ensure no files changed
         run: git diff --quiet HEAD || (git diff --raw && echo "Detected untracked changes in git after running command '${{ matrix.command }}'" && exit 1)
 
@@ -65,11 +46,7 @@ jobs:
         with:
           fetch-depth: 100 # need the history to do a changed files check below (source, origin)
       - uses: actions/setup-python@v4
-      - name: Use Node.js 18.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-      - run: yarn
+      - uses: ./.github/commands/dependencies/install_deps
       - uses: pre-commit/action@v3.0.0
         with:
           extra_args: --source ${{ github.event.pull_request.base.sha || 'HEAD~1' }} --origin ${{ github.event.pull_request.head.sha || 'HEAD' }}
@@ -78,44 +55,38 @@ jobs:
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     needs:
-      - run-mocha
+      - run-vitest
       - run-depcheck
       - build-and-upload-artifacts
       - run-pre-commits
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '18.x'
-      - run: yarn
+      - uses: ./.github/commands/dependencies/install_deps
       - name: Configure NPM authentication
         run: |
-          yarn config set npmAlwaysAuth true
-          yarn config set npmAuthToken ${{ secrets.NPM_TOKEN }}
-      - name: Publish to yarn/npm
-        run: yarn npm publish
+          npm config set npmAlwaysAuth true
+          npm config set npmAuthToken ${{ secrets.NPM_TOKEN }}
+      - name: Publish to pnpm/npm
+        run: npm publish
 
   build-to-github-packages:
     if: github.ref == 'refs/heads/main'
     runs-on: ubuntu-latest
     needs:
-      - run-mocha
+      - run-vitest
       - run-depcheck
       - build-and-upload-artifacts
       - run-pre-commits
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '18.x'
-      - run: yarn
+      - uses: ./.github/commands/dependencies/install_deps
       - name: Configure Github Packages authentication
         run: |
-          yarn config set npmAlwaysAuth true
-          yarn config set npmRegistryServer https://npm.pkg.github.com
-          yarn config set npmPublishRegistry https://npm.pkg.github.com
-          yarn config set npmAuthToken ${{ secrets.GITHUB_TOKEN }}
+          npm config set npmAlwaysAuth true
+          npm config set npmRegistryServer https://npm.pkg.github.com
+          npm config set npmPublishRegistry https://npm.pkg.github.com
+          npm config set npmAuthToken ${{ secrets.GITHUB_TOKEN }}
       - name: Publish to Github packages
-        run: yarn npm publish
+        run: npm publish

.github/workflows/update_transcend_packages.yml

@@ -13,17 +13,10 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - name: Use Node.js 18.x
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-      - run: yarn
+      - uses: ./.github/commands/dependencies/install_deps
 
       # Install
-      - run: yarn up @transcend-io/internationalization
-      - run: yarn up @transcend-io/privacy-types
-      - run: yarn up @transcend-io/persisted-state
-      - run: yarn up @transcend-io/type-utils
+      - run: pnpm up "@transcend-io/*" --latest
 
       - name: Create Pull Request
         id: cpr

.github/workflows/version_check.yml

@@ -42,8 +42,8 @@ jobs:
             echo "$ALL_CHANGED_FILES";
             echo ""
             echo "Please bump the version in package.json using one of:";
-            echo "  - yarn version patch (for bug fixes)";
-            echo "  - yarn version minor (for new features)";
-            echo "  - yarn version major (for breaking changes)";
+            echo "  - npm version patch (for bug fixes)";
+            echo "  - npm version minor (for new features)";
+            echo "  - npm version major (for breaking changes)";
             exit 1;
           fi

.gitignore

@@ -4,6 +4,7 @@ cron-identifiers.csv
 manual-enrichment-identifiers.csv
 preference-management-upload-receipts.json
 build/
+dist/
 privacy-request-upload-receipts/
 dsr-files/