@govtechsg/oobee 0.10.20

package/eslint.config.js

@@ -0,0 +1,53 @@
+// @ts-check
+import globals from 'globals';
+import eslint from '@eslint/js';
+import tseslint from 'typescript-eslint';
+import * as pluginImport from 'eslint-plugin-import';
+import pluginPrettier from 'eslint-plugin-prettier';
+import { FlatCompat } from '@eslint/eslintrc';
+
+const compat = new FlatCompat();
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    ignores: [
+      'dist/',
+      '__mocks__/',
+      '__tests__/',
+      '**/test.js',
+      'src/constants/__tests__/',
+      'src/crawlers/__tests__/',
+    ],
+  },
+  ...compat.extends('airbnb-base', 'plugin:prettier/recommended'),
+  {
+    languageOptions: {
+      globals: {
+        ...globals.node,
+        ...globals.browser,
+      },
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    plugins: {
+      pluginImport,
+      pluginPrettier,
+    },
+    settings: {
+      'import/resolver': {
+        node: {
+          extensions: ['.js', '.jsx', '.ts', '.tsx'],
+        },
+      },
+    },
+    rules: {
+      'import/no-extraneous-dependencies': ['error', { devDependencies: true }],
+      // disabling import/no-unresolved as typescript already checks this
+      // https://typescript-eslint.io/troubleshooting/typed-linting/performance/#eslint-plugin-import
+      'import/no-unresolved': 'off',
+      'lines-between-class-members': 'off',
+    },
+  },
+);

package/exclusions.txt

@@ -0,0 +1,2 @@
+\.*login.singpass.gov.sg\.*
+\.*auth.singpass.gov.sg\.*

package/gitlab-pipeline-template.yml

@@ -0,0 +1,54 @@
+variables:
+  # DOCKER_IMAGE: <GitLab URL>/<username>/<project name>:latest
+  DOCKER_IMAGE: <GitLab URL>/<username>/<project name>:latest
+  # OOBEE_SCAN_URL: https://www.example.com
+  OOBEE_SCAN_URL: 'https://example.com'
+  # OOBEE_SCAN_TYPE: [choices: "sitemap", "website", "intelligent"]
+  OOBEE_SCAN_TYPE: 'website'
+  # OOBEE_SCAN_DEVICE: "Desktop"
+  # A full list of devices is available at https://github.com/GovTechSG/oobee#mobile-device-options
+  OOBEE_SCAN_DEVICE: 'Desktop'
+  # OOBEE_SCAN_MAX_NUM_PAGES: 100
+  OOBEE_SCAN_MAX_NUM_PAGES: 200
+  # OOBEE_MAX_CONCURRENT_PAGES: 25
+  # If scan encounters blocked pages / error 403, reduce to 1
+  OOBEE_MAX_CONCURRENT_PAGES: 1
+  # Speed up tests by excluding screenshots
+  # OOBEE_INCLUDE_SCREENSHOTS: [choices: "screenshots", "none"]
+  OOBEE_INCLUDE_SCREENSHOTS: 'none'
+  # Safe Mode to prevent unexpected dynamic page behaviours
+  # OOBEE_SCAN_SAFE_MODE: [choices: "yes", "no"]
+  OOBEE_SCAN_SAFE_MODE: 'yes'
+  # OOBEE_SCAN_ARTIFACT_NAME: "oobee-scan-results.zip"
+  OOBEE_SCAN_ARTIFACT_NAME: 'oobee-scan-results.zip'
+  # OOBEE_SCAN_NAME_EMAIL: "John Doe:john@domain.com"
+  OOBEE_SCAN_NAME_EMAIL: ''
+
+oobee-scan:
+  stage: test
+  tags:
+    # - some tag
+  image:
+    name: $DOCKER_IMAGE
+    entrypoint: ['/bin/bash', '-lc']
+  script:
+    # Start in the app dir
+    - cd /app
+    # Run accessibility scan
+    - OOBEE_VERBOSE=true npm run build && npm run cli -- -b chromium -c "$OOBEE_SCAN_TYPE" -d "$OOBEE_SCAN_DEVICE" -o "$CI_PROJECT_DIR/$OOBEE_SCAN_ARTIFACT_NAME" -u "$OOBEE_SCAN_URL" -p "$OOBEE_SCAN_MAX_NUM_PAGES" -a "$OOBEE_INCLUDE_SCREENSHOTS" -f "$OOBEE_SCAN_SAFE_MODE" -k "$OOBEE_SCAN_NAME_EMAIL" || true
+    # Move the results directory to artifacts
+    - results_directory=$(find results -mindepth 1 -maxdepth 1 -type d -print -quit) # Get the first directory within ./results
+    - if [ -n "$results_directory" ]; then mv "$results_directory" "$CI_PROJECT_DIR/artifacts"; fi # Move the directory to ./artifacts
+  artifacts:
+    paths:
+      # Stores the report CSV, HTML, summary PDF only to save storage space
+      - artifacts/report.csv
+      - artifacts/report.html
+      - artifacts/scanDetails.csv
+      - artifacts/summary.pdf
+      # Include screenhots folder
+      # - artifacts/elemScreenshots/
+      # Stores the reports folder so it can be accessed through Browse
+      # - artifacts/
+      # Uploads the results as zipped file
+      # - $OOBEE_SCAN_ARTIFACT_NAME

package/jest.config.js

@@ -0,0 +1 @@
+export default { transform: {} };

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@govtechsg/oobee",
+  "main": "dist/npmIndex.js",
+  "version": "0.10.20",
+  "type": "module",
+  "dependencies": {
+    "@json2csv/node": "^7.0.3",
+    "@napi-rs/canvas": "^0.1.53",
+    "axe-core": "^4.10.2",
+    "axios": "^1.7.4",
+    "cheerio": "^1.0.0-rc.12",
+    "crawlee": "^3.11.1",
+    "ejs": "^3.1.9",
+    "file-type": "^19.5.0",
+    "fs-extra": "^11.2.0",
+    "glob": "^10.3.10",
+    "https": "^1.0.0",
+    "inquirer": "^9.2.12",
+    "jsdom": "^21.1.2",
+    "lodash": "^4.17.21",
+    "mime-types": "^2.1.35",
+    "minimatch": "^9.0.3",
+    "pdfjs-dist": "github:veraPDF/pdfjs-dist#v2.14.305-taggedPdf-0.1.11",
+    "playwright": "1.46.1",
+    "prettier": "^3.1.0",
+    "print-message": "^3.0.1",
+    "safe-regex": "^2.1.1",
+    "text-readability": "^1.1.0",
+    "typescript": "^5.4.5",
+    "url": "^0.11.3",
+    "uuid": "^11.0.3",
+    "validator": "^13.11.0",
+    "which": "^4.0.0",
+    "winston": "^3.11.0",
+    "xml2js": "^0.6.2",
+    "xpath-to-css": "^1.2.0",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@eslint/eslintrc": "^3.0.2",
+    "@eslint/js": "^9.6.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^9.0.7",
+    "@types/lodash": "^4.17.7",
+    "@types/safe-regex": "^1.1.6",
+    "@types/validator": "^13.11.10",
+    "@types/which": "^3.0.4",
+    "@types/xml2js": "^0.4.14",
+    "eslint": "^8.57.0",
+    "eslint-config-airbnb-base": "^15.0.0",
+    "eslint-config-prettier": "^8.6.0",
+    "eslint-plugin-import": "^2.27.4",
+    "eslint-plugin-prettier": "^5.0.0",
+    "globals": "^15.2.0",
+    "jest": "^29.7.0",
+    "typescript-eslint": "^8.3.0"
+  },
+  "overrides": {
+    "node-fetch": "^2.3.0",
+    "json5": "^2.2.3",
+    "ansi-regex": "^5.0.1",
+    "tough-cookie": "^5.0.0-rc.2",
+    "micromatch": "github:micromatch/micromatch.git#4.0.7"
+  },
+  "optionalDependencies": {
+    "@napi-rs/canvas-darwin-arm64": "^0.1.53",
+    "@napi-rs/canvas-darwin-x64": "^0.1.53",
+    "@napi-rs/canvas-linux-arm64-gnu": "0.1.53",
+    "@napi-rs/canvas-linux-arm64-musl": "0.1.53",
+    "@napi-rs/canvas-linux-x64-gnu": "0.1.53",
+    "@napi-rs/canvas-linux-x64-musl": "0.1.53",
+    "@napi-rs/canvas-win32-x64-msvc": "0.1.53"
+  },
+  "scripts": {
+    "build": "npm run copyfiles && tsc",
+    "build:watch": "npm run build -- --watch",
+    "copyfiles": "node ./scripts/copyFiles.js src/static/ejs dist/static && node ./scripts/copyFiles.js src/constants/errorMeta.json dist/constants && node ./scripts/copyFiles.js exclusions.txt dist",
+    "start": "node --max-old-space-size=10000 dist/index.js",
+    "cli": "node --max-old-space-size=10000 dist/cli.js",
+    "test": "node --experimental-vm-modules ./node_modules/.bin/jest",
+    "lint": "eslint . --report-unused-disable-directives --max-warnings 0",
+    "lint:fix": "eslint . --fix --report-unused-disable-directives --max-warnings 0"
+  },
+  "author": "",
+  "license": "MIT",
+  "description": "Oobee is a customisable, automated accessibility testing tool that allows software development teams to assess whether their products are user-friendly to persons with disabilities (PWDs).",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GovTechSG/oobee.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GovTechSG/oobee/issues"
+  },
+  "homepage": "https://github.com/GovTechSG/oobee#readme"
+}

package/scripts/copyFiles.js

@@ -0,0 +1,44 @@
+/* eslint-disable no-console */
+import { exec } from 'child_process';
+import os from 'os';
+
+const sourceDir = process.argv[2];
+const destDir = process.argv[3];
+
+if (!sourceDir || !destDir) {
+  console.error('Usage: node copyFiles.js <sourceDir> <destDir>');
+  process.exit(1);
+}
+
+const platform = os.platform();
+
+if (platform === 'win32') {
+  // Windows
+  exec(
+    `powershell -Command "(New-Item -Path '${destDir}' -ItemType 'directory' -Force); (Copy-item -Path '${sourceDir}' -Destination '${destDir}' -Recurse -Force)"`,
+    (error, stdout, stderr) => {
+      if (error) {
+        console.error(`Error: ${error.message}`);
+        return;
+      }
+      if (stderr) {
+        console.error(`Stderr: ${stderr}`);
+        return;
+      }
+      console.log(`Output: ${stdout}`);
+    },
+  );
+} else {
+  // Other operating systems (Linux, macOS, etc.)
+  exec(`mkdir -p "${destDir}" && cp -vr "${sourceDir}" "${destDir}"`, (error, stdout, stderr) => {
+    if (error) {
+      console.error(`Error: ${error.message}`);
+      return;
+    }
+    if (stderr) {
+      console.error(`Stderr: ${stderr}`);
+      return;
+    }
+    console.log(`Output: ${stdout}`);
+  });
+}

package/scripts/install_oobee_dependencies.cmd

@@ -0,0 +1,13 @@
+@echo OFF
+if [%1]==[] goto usage
+
+@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass "& ""%~dp0oobee_shell_ps.ps1""" %*
+exit /B 1
+
+:usage
+echo oobee Shell - Created By younglim - NO WARRANTY PROVIDED
+echo ================================================================
+echo 
+
+@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -NoExit -ExecutionPolicy Bypass "& ""%~dp0install_oobee_dependencies.ps1"""
+Footer

package/scripts/install_oobee_dependencies.command

@@ -0,0 +1,101 @@
+#!/bin/bash
+
+NODE_VERSION="20.10.0"
+
+# Get current shell command
+SHELL_COMMAND=$(ps -o comm= -p $$)
+SHELL_NAME="${SHELL_COMMAND#-}"
+
+cd "$(dirname "${BASH_SOURCE[0]}")"
+__dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+CURR_FOLDERNAME="$(basename "$PWD")"
+if [ "$CURR_FOLDERNAME" = "scripts" ]; then
+  cd ..
+  CURR_FOLDERNAME="$(basename "$PWD")"
+fi
+
+if ! [ -f nodejs-mac-arm64/bin/node ]; then
+  echo "Downloading NodeJS LTS (ARM64)"
+  curl -o ./nodejs-mac-arm64.tar.gz --create-dirs https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-darwin-arm64.tar.gz  
+  mkdir nodejs-mac-arm64
+  tar -xzf nodejs-mac-arm64.tar.gz -C nodejs-mac-arm64 --strip-components=1 && rm ./nodejs-mac-arm64.tar.gz
+  rm nodejs-mac-arm64.tar.gz
+fi
+
+if ! [ -f nodejs-mac-x64/bin/node ]; then
+  echo "Downloading NodeJS LTS (x64)"
+  curl -o ./nodejs-mac-x64.tar.gz --create-dirs https://nodejs.org/dist/v$NODE_VERSION/node-v$NODE_VERSION-darwin-x64.tar.gz     
+  mkdir nodejs-mac-x64
+  tar -xzf nodejs-mac-x64.tar.gz -C nodejs-mac-x64 --strip-components=1 && rm ./nodejs-mac-x64.tar.gz
+  rm node-*-darwin-x64.tar.gz
+fi
+
+export CORRETTO_BASEDIR="$HOME/Library/Application Support/Oobee"
+mkdir -p "$CORRETTO_BASEDIR" 
+
+echo "INFO: Set path to Corretto-11 JDK"
+export JAVA_HOME="$CORRETTO_BASEDIR/amazon-corretto-11.jdk.x64/Contents/Home"
+export PATH="$JAVA_HOME/bin:$PATH"
+
+if ! [ -f jre/bin/java ]; then
+  cd "$CORRETTO_BASEDIR" 
+  if ! [ -f amazon-corretto-11.jdk.x64/Contents/Home/bin/java ]; then
+      echo "Downloading Corretto (x64)"
+      curl -L -o ./corretto-11.tar.gz "https://corretto.aws/downloads/latest/amazon-corretto-11-x64-macos-jdk.tar.gz"
+      tar -zxf ./corretto-11.tar.gz
+      rm -f ./corretto-11.tar.gz
+      mv amazon-corretto-11.jdk amazon-corretto-11.jdk.x64
+  else
+    echo "Found Corretto (x64)"
+  fi
+
+  echo "INFO: Build JRE SE"
+  cd "$__dir"
+  jlink --output jre --add-modules java.se
+
+fi
+
+if ! [ -f verapdf/verapdf ]; then
+  echo "Downloading VeraPDF"
+  if [ -d "./verapdf" ]; then rm -Rf ./verapdf; fi
+  if [ -d "./verapdf-installer" ]; then rm -Rf ./verapdf-installer; fi
+  curl -L -o ./verapdf-installer.zip https://github.com/GovTechSG/oobee/releases/download/cache/verapdf-installer.zip
+  unzip -j ./verapdf-installer.zip -d ./verapdf-installer
+  ./verapdf-installer/verapdf-install "${__dir}/verapdf-auto-install-macos.xml"
+  cp -r /tmp/verapdf .
+  rm -rf ./verapdf-installer.zip ./verapdf-installer /tmp/verapdf
+  
+fi
+
+if [ -d "/Applications/Cloudflare WARP.app" ]; then
+  curl -sSLJ -o "/tmp/Cloudflare_CA.pem" "https://developers.cloudflare.com/cloudflare-one/static/documentation/connections/Cloudflare_CA.pem"
+  export NODE_EXTRA_CA_CERTS="/tmp/Cloudflare_CA.pem"
+fi
+
+source "${__dir}/oobee_shell.sh"
+
+if ! [ -f package.json ] && [ -d oobee ]; then
+  cd oobee
+fi
+
+if [ -d "node_modules" ]; then
+  echo "Deleting node_modules before installation"
+  rm -rf node_modules 
+fi
+
+echo "Installing Node dependencies to $PWD"
+npm install --force --omit=dev
+
+# Add additional canvas dependency in x64 mode
+if [ "$(uname -m)" = "arm64" ] && /usr/bin/pgrep oahd >/dev/null 2>&1; then
+    if [ -f package.json ]; then
+      export PATH="$(dirname "$PWD")/nodejs-mac-x64/bin:$PATH"
+    else
+      export PATH="$PWD/nodejs-mac-x64/bin:$PATH"
+    fi
+    arch -x86_64 npm install @napi-rs/canvas-darwin-x64@0.1.53 --force --omit=dev
+fi
+
+echo "Build TypeScript"
+npm run build || true

package/scripts/install_oobee_dependencies.ps1

@@ -0,0 +1,110 @@
+# If currently within script, go one directory up
+if ((Split-Path -Path $pwd -Leaf) -eq "scripts") {
+	cd ..
+}
+
+$ProgressPreferences = 'SilentlyContinue'
+$ErrorActionPreference = 'Stop'
+
+# Install NodeJS binaries
+if (-Not (Test-Path nodejs-win\node.exe)) {
+    Write-Output "Downloading Node"
+    Invoke-WebRequest -o ./nodejs-win.zip "https://nodejs.org/dist/v20.10.0/node-v20.10.0-win-x64.zip"     
+    
+    Write-Output "Unzip Node"
+    Expand-Archive .\nodejs-win.zip -DestinationPath .
+    Rename-Item node-v20.10.0-win-x64 -NewName nodejs-win
+    Remove-Item -Force .\nodejs-win.zip
+}
+
+# Install Coretto-11
+if (-Not (Test-Path jre\bin\java.exe)) {
+    if (-Not (Test-Path jdk\bin\java.exe)) {
+        Write-Output "Downloading Corretto-11"
+        Invoke-WebRequest -o ./corretto-11.zip "https://corretto.aws/downloads/latest/amazon-corretto-11-x64-windows-jdk.zip"     
+        
+        Write-Output "Unzip Corretto-11"
+        Expand-Archive .\corretto-11.zip -DestinationPath .
+        Get-ChildItem ./jdk* -Directory | Rename-Item -NewName jdk
+        Remove-Item -Force .\corretto-11.zip
+    }
+
+    Write-Output "Set path to JDK"
+    $env:JAVA_HOME = "$PWD\jdk"
+    $env:Path = "$env:JAVA_HOME\bin;$env:Path"
+
+    Write-Output "Build JRE SE"
+    Start-Process jlink -ArgumentList "--output jre --add-modules java.se" -Wait -NoNewWindow
+}
+
+# Install VeraPDF
+if (-Not (Test-Path verapdf\verapdf.bat)) {
+    Write-Output "INFO: Downloading VeraPDF"
+    Invoke-WebRequest -o .\verapdf-installer.zip "https://github.com/GovTechSG/oobee/releases/download/cache/verapdf-installer.zip"
+    Expand-Archive .\verapdf-installer.zip -DestinationPath .
+    Get-ChildItem ./verapdf-greenfield-* -Directory | Rename-Item -NewName verapdf-installer
+
+    Write-Output "INFO: Set path to JRE for this session"
+    $env:JAVA_HOME = "$PWD\jre"
+    $env:Path = "$env:JAVA_HOME\bin;$env:Path"
+
+    Write-Output "INFO: Installing VeraPDF"
+    .\verapdf-installer\verapdf-install "$PWD\verapdf-auto-install-windows.xml"
+    Move-Item -Path C:\Windows\Temp\verapdf -Destination verapdf
+    Remove-Item -Force -Path .\verapdf-installer.zip 
+    Remove-Item -Force -Path .\verapdf-installer -recurse
+}
+
+# Check if the jdk directory exists and remove
+if (Test-Path -Path .\jdk -PathType Container) {
+    # Remove the directory forcefully
+    Remove-Item -Path .\jdk -Recurse -Force
+}
+
+# Install Node dependencies
+if (Test-Path oobee) {
+    Write-Output "Installing node dependencies"
+    & ".\oobee_shell_ps.ps1" "cd oobee;npm install --force --omit=dev;cd .."
+
+    # Omit installing Playwright browsers as it is not reuqired
+    # Write-Output "Install Playwright browsers"
+    # & ".\oobee_shell_ps.ps1" "npx playwright install chromium"
+    
+    try {
+	Write-Output "Building Typescript" 
+	& ".\oobee_shell_ps.ps1" "cd oobee;npm run build" 
+    } catch {
+	Write-Output "Build with some errors but continuing. $_.Exception.Message" 
+    } 
+    
+    if (Test-Path oobee\.git) {
+        Write-Output "Unhide .git folder"
+        attrib -s -h oobee\.git
+    }
+
+} else {
+    Write-Output "Trying to search for package.json instead"
+
+    if (Test-Path package.json) {
+        Write-Output "Installing node dependencies"
+        & ".\oobee_shell_ps.ps1" "npm install --force --omit=dev" 
+
+        Write-Output "Install Playwright browsers"
+        & "npx playwright install chromium"
+
+        if (Test-Path .git) {
+            Write-Output "Unhide .git folder"
+            attrib -s -h .git
+        }
+	
+	try {
+		Write-Output "Building Typescript" 
+		npm run build
+ 	} catch {
+ 		Write-Output "Build with some errors but continuing" 
+	} 
+
+    } else {
+        Write-Output "Could not find oobee"
+    }
+}

package/scripts/oobee_shell.cmd

@@ -0,0 +1,13 @@
+@echo OFF
+
+if [%1]==[] goto usage
+
+@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -ExecutionPolicy Bypass "& ""%~dp0oobee_shell_ps.ps1""" %*
+exit /B 1
+
+:usage
+echo oobee Shell - Created By younglim - NO WARRANTY PROVIDED
+echo ================================================================
+echo\
+
+@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -NoExit -ExecutionPolicy Bypass "& ""%~dp0oobee_shell_ps.ps1"""

package/scripts/oobee_shell.command

@@ -0,0 +1,11 @@
+#!/bin/zsh
+cd "$(dirname "${BASH_SOURCE[0]}")"
+
+# Get current shell command
+SHELL_COMMAND=$(ps -o comm= -p $$)
+SHELL_NAME="${SHELL_COMMAND#-}"
+CURR_FOLDERNAME="$(dirname "$0")"
+
+cd "$CURR_FOLDERNAME"
+
+$SHELL_NAME "$CURR_FOLDERNAME/oobee_shell.sh" $SHELL_NAME

package/scripts/oobee_shell.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+echo "oobee Shell - Created By younglim - NO WARRANTY PROVIDED"
+echo "================================================================"
+echo ""
+
+__dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+ORIGINAL_DIR="$PWD"
+
+CURR_FOLDERNAME="$(basename "$PWD")"
+
+if [ "$CURR_FOLDERNAME" = "scripts" ]; then
+  cd ..
+  CURR_FOLDERNAME="$(basename "$PWD")"
+fi
+
+# Get current shell command
+SHELL_COMMAND=$(ps -o comm= -p $$)
+SHELL_NAME="${SHELL_COMMAND#-}"
+
+if [[ $(uname -m) == 'arm64' ]]; then
+    echo "INFO: Setting path to node arm64 for this session"
+    export PATH_TO_NODE="$PWD/nodejs-mac-arm64/bin"
+
+else
+    echo "INFO: Setting path to node x64 for this session"
+    export PATH_TO_NODE="$PWD/nodejs-mac-x64/bin"
+fi
+
+
+export PATH="$PATH_TO_NODE:$PATH"
+
+echo "INFO: Set path to node_modules for this session"
+if find ./oobee -name "node_modules" -maxdepth 1 -type l -ls &> /dev/null; then
+    export PATH="$PWD/oobee/node_modules/.bin:$PATH"
+else
+    export PATH="$PWD/node_modules/.bin:$PATH"
+fi
+
+echo "INFO: Set path to Java JRE"
+export JAVA_HOME="$PWD/jre"
+export PATH="$JAVA_HOME/bin:$PATH"
+
+echo "INFO: Set path to VeraPDF"
+export PATH="$PWD/verapdf:$PATH"
+
+echo "INFO: Set path to Playwright cache for this session"
+export PLAYWRIGHT_BROWSERS_PATH="$PWD/ms-playwright"
+export PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD="true"
+
+echo "INFO: Removing com.apple.quarantine attributes for required binaries to run"
+xattr -rd com.apple.quarantine . &>/dev/null
+
+cd "$ORIGINAL_DIR"
+$@

package/scripts/oobee_shell_ps.ps1

@@ -0,0 +1,54 @@
+# If currently within script, go one directory up
+if ((Split-Path -Path $pwd -Leaf) -eq "scripts") {
+	cd ..
+}
+
+# Set current path
+$current_path = (Get-Item -Path ".\" -Verbose).FullName
+
+echo "INFO: Stored current working directory at $current_path"
+
+# INFO: Set path to oobee
+# $path_to_oobee  = split-path -parent $MyInvocation.MyCommand.Definition
+$path_to_oobee = "$PSScriptRoot"
+
+echo "INFO: Set path to node for this session"
+$env:Path = "$path_to_oobee\nodejs-win;$env:Path";
+
+echo "INFO: Set path to node_modules for this session"
+$env:Path = "$path_to_oobee\node_modules\.bin;./node_modules/.bin;$env:Path";
+
+echo "INFO: Set path to Playwright cache for this session"
+$env:PLAYWRIGHT_BROWSERS_PATH = "$path_to_oobee\ms-playwright"
+$env:PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD = "true"
+
+echo "INFO: Set path to JRE for this session"
+$env:JAVA_HOME = "$path_to_oobee\jre"
+$env:Path = "$env:JAVA_HOME\bin;$env:Path"
+
+echo "INFO: Set path to VeraPDF for this session"
+$env:Path = "$path_to_oobee\verapdf;$env:Path"
+
+if (Test-Path oobee) {
+   echo "INFO: Set path to oobee for this session"
+	$env:Path = "$path_to_oobee\oobee;$env:Path"	
+} else {
+    if (Test-Path package.json) {
+    	echo "INFO: Set path to oobee for this session"
+	$env:Path = "$path_to_oobee;$env:Path"	
+    } else {
+        Write-Output "Could not find oobee"
+    }
+}
+
+echo ""
+$allArgs = $PsBoundParameters.Values + $args + ""
+
+if ($allArgs)
+{
+	echo "Running: $allArgs"
+	iex "& $allArgs"
+} else
+{
+	echo ""
+}