Add install action for macOS.

.github/workflows/pull_request_validation.yml

@@ -36,3 +36,18 @@ jobs:
         continue-on-error: true
         with:
           project-id: "507f1f77bcf86cd799439011"
+  validate_macos:
+    runs-on: macos-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4.2.2
+
+      - name: Install Dashcam - MacOS
+        uses: ./.
+        with:
+          version: "1.0.49"
+          cli-version: "0.8.3"
+          node-version: "22.19.0"
+          node-directory: "${{ runner.temp }}/nodejs22"
+          node-prefix: "${{ runner.temp }}/nodejs22/npm-installs"
+

README.md

@@ -3,12 +3,14 @@ GitHub actions for TestDriver Dashcam service
 
 # Usage
 
+> **_NOTE:_** These actions are currently only supported on Windows runners.
+
 First step must be to install the Dashcam CLI/GUI on the runner. The GUI is required for the CLI to function correctly.
 ```yaml
   - name: Install Dashcam
     id: install_dashcam
     continue-on-error: true # Optional
-    uses: thebrowsercompany/action-dashcam@<VERSION_TAG>
+    uses: testdriverai/action-dashcam@<VERSION_TAG>
     with:
         version: "1.0.49" # See releases here: https://github.com/replayableio/replayable/releases
 ```
@@ -19,7 +21,7 @@ Right before the step that you want to record you need to Start the Dashcam.
     id: start_dashcam
     if: ${{ steps.install_dashcam.outcome == 'success' }} # Only needed if continue-on-error is used on the install_dashcam
     continue-on-error: true
-    uses: thebrowsercompany/action-dashcam/start@<VERSION_TAG>
+    uses: testdriverai/action-dashcam/start@<VERSION_TAG>
     with:
       api-key: ${{ secrets.DASHCAM_API_KEY }}
 ```
@@ -29,7 +31,7 @@ To stop the recording and upload the results use:
   - name: Submit Dashcam recording
     if: ${{ always() && steps.start_dashcam.outcome == 'success' }}
     continue-on-error: true
-    uses: thebrowsercompany/action-dashcam/stop@dev
+    uses: testdriverai/action-dashcam/stop@dev
     with:
         project-id: "507f1f77bcf86cd799439011" # The project-id value is the 'slug' component of the project URL on the Dashcam website.
 ```

action.yml

@@ -65,24 +65,25 @@ runs:
       shell: bash
       run: |
         echo "Installing Dashcam GUI on ${{ runner.os }}"
-        echo "Not supported yet"
-        exit 1
+        bash "$GITHUB_ACTION_PATH/src/mac/Install-DashcamGUI.sh" --version "${{ inputs.version }}"
+        echo "Dashcam GUI installed"
 
     - name: Install Node.js for Dashcam CLI (macOS)
       if: ${{ runner.os == 'macOS' }}
       shell: bash
       run: |
         echo "Installing Node.js for Dashcam CLI on ${{ runner.os }}"
-        echo "Not supported yet"
-        exit 1
+        bash "$GITHUB_ACTION_PATH/src/mac/Install-Node.sh" --version "${{ inputs.node-version }}" --directory "${{ inputs.node-directory }}" --prefix "${{ inputs.node-prefix }}"
+        echo "Node.js installed to ${{ inputs.node-directory }}"
 
     - name: Install Dashcam CLI (macOS)
       if: ${{ runner.os == 'macOS' }}
       shell: bash
       run: |
         echo "Installing Dashcam CLI on ${{ runner.os }}"
-        echo "Not supported yet"
-        exit 1
+        bash "$GITHUB_ACTION_PATH/src/mac/Install-DashcamCLI.sh" --version "${{ inputs.cli-version }}"
+        echo "Dashcam CLI installed"
+        echo "DASHCAM_NODE_DIR=${{ inputs.node-directory }}" >> $GITHUB_ENV
 
     - name: Install Dashcam GUI (Linux)
       if: ${{ runner.os == 'Linux' }}

src/mac/Install-DashcamCLI.sh

@@ -0,0 +1,81 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Install-DashcamCLI.sh
+# Usage: Install-DashcamCLI.sh --version <version>
+
+usage() {
+  cat <<EOF
+Usage: $0 --version VERSION
+
+Installs the Dashcam CLI globally via npm and verifies the installation.
+
+Options:
+  --version, -v   Dashcam CLI version (example: 1.2.3 or "latest")
+  --help, -h      Show this help
+EOF
+}
+
+if [ $# -eq 0 ]; then
+  usage
+  exit 1
+fi
+
+VERSION=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --version|-v)
+      VERSION="$2"; shift 2;;
+    --help|-h)
+      usage; exit 0;;
+    *)
+      echo "Unknown option: $1" >&2; usage; exit 1;;
+  esac
+done
+
+if [ -z "$VERSION" ]; then
+  echo "--version is required" >&2
+  usage
+  exit 1
+fi
+
+echo "Installing Dashcam CLI $VERSION..."
+
+# Verify npm is available
+if ! command -v npm >/dev/null 2>&1; then
+  echo "npm not found in PATH. Make sure Node.js/npm is installed and on PATH." >&2
+  exit 2
+fi
+
+echo "Using npm: $(npm --version)"
+
+# Try installing without sudo first. If it fails due to permission, retry with sudo.
+if npm install --location=global "dashcam@$VERSION"; then
+  echo "dashcam installed successfully (no sudo)"
+else
+  echo "Initial npm install failed; retrying with sudo..."
+  if sudo npm install --location=global "dashcam@$VERSION"; then
+    echo "dashcam installed successfully (with sudo)"
+  else
+    echo "Failed to install dashcam globally via npm." >&2
+    exit 3
+  fi
+fi
+
+echo "Verifying Dashcam CLI Install..."
+
+if ! command -v dashcam >/dev/null 2>&1; then
+  echo "dashcam binary not found in PATH." >&2
+  echo "If you set a custom npm prefix, ensure its bin/ directory is on PATH. Example:"
+  echo "  export PATH=\"\${NODE_PREFIX:-/usr/local}/bin:\$PATH\""
+  echo "You can also run: npm bin -g to find the global bin directory."
+  exit 4
+fi
+
+dashcam --help || { echo "dashcam --help failed" >&2; exit 5; }
+dashcam --version || { echo "dashcam --version failed" >&2; exit 6; }
+
+echo "Dashcam CLI installed and verified."
+
+exit 0

src/mac/Install-DashcamGUI.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Install-DashcamGUI.sh
+# Usage: Install-DashcamGUI.sh --version <version>
+
+usage() {
+  cat <<EOF
+Usage: $0 --version VERSION
+
+Downloads the Dashcam GUI portable release for macOS, installs the .app to
+/Applications (using sudo when required), creates helpful user_data files and
+settings.json, and launches the application.
+
+Options:
+  --version, -v   Dashcam GUI version (example: 1.2.3)
+  --help, -h      Show this help
+EOF
+}
+
+if [ $# -eq 0 ]; then
+  usage
+  exit 1
+fi
+
+VERSION=""
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --version|-v)
+      VERSION="$2"; shift 2;;
+    --help|-h)
+      usage; exit 0;;
+    *)
+      echo "Unknown option: $1" >&2; usage; exit 1;;
+  esac
+done
+
+if [ -z "$VERSION" ]; then
+  echo "--version is required" >&2
+  usage
+  exit 1
+fi
+
+echo "Installing Dashcam GUI version $VERSION for macOS"
+
+INSTALL_DIR="$(mktemp -d -t dashcam-gui.XXXXXX)"
+echo "Using temporary install directory: $INSTALL_DIR"
+
+# Download the arm64 zip file
+ASSET_URL_BASE="https://github.com/replayableio/replayable/releases/download/v${VERSION}"
+FILENAME="Dashcam-${VERSION}-arm64-mac.zip"
+DEST="$INSTALL_DIR/$FILENAME"
+
+echo "Trying $ASSET_URL_BASE/$FILENAME"
+if ! curl -fSL -o "$DEST" "$ASSET_URL_BASE/$FILENAME"; then
+  echo "Failed to download $FILENAME from $ASSET_URL_BASE" >&2
+  exit 2
+fi
+
+DOWNLOADED="$DEST"
+
+if [ -z "$DOWNLOADED" ]; then
+  echo "Failed to find a Dashcam portable artifact for version $VERSION" >&2
+  exit 2
+fi
+
+# Zip extraction
+echo "Unzipping..."
+unzip -q "$DOWNLOADED" -d "$INSTALL_DIR/extracted"
+APP_PATH="$(find "$INSTALL_DIR/extracted" -maxdepth 3 -name "*.app" -print -quit || true)"
+
+if [ -z "$APP_PATH" ]; then
+  echo "Could not locate Dashcam .app after extraction." >&2
+  exit 5
+fi
+
+echo "Found app at: $APP_PATH"
+
+# Install to /Applications
+TARGET_APP="/Applications/$(basename "$APP_PATH")"
+if [ -d "$TARGET_APP" ]; then
+  echo "Removing existing application at $TARGET_APP"
+  if [ -w "$TARGET_APP" ]; then
+    rm -rf "$TARGET_APP"
+  else
+    sudo rm -rf "$TARGET_APP"
+  fi
+fi
+
+echo "Copying app to /Applications"
+if [ -w "/Applications" ]; then
+  cp -R "$APP_PATH" "/Applications/"
+else
+  sudo cp -R "$APP_PATH" "/Applications/"
+fi
+
+# Create user_data directory and files similar to the Windows installer
+USER_DATA_DIR="$INSTALL_DIR/user_data"
+mkdir -p "$USER_DATA_DIR"
+
+CONFIG_FILES=(
+  ".replayable--mainwindow-ever-launched"
+  ".replayable--has-accepted-tos"
+  ".replayable--segment-done"
+  ".replayable--ever-launched"
+  ".replayable--do-not-update"
+  ".replayable--do-not-open-browser"
+)
+
+for f in "${CONFIG_FILES[@]}"; do
+  touch "$USER_DATA_DIR/$f"
+done
+
+cat > "$USER_DATA_DIR/settings.json" <<'JSON'
+{
+  "EDIT_ON_CLIP": false,
+  "CAPTURE_ERROR": false,
+  "DETECT_ERRORS_ONCE": true
+}
+JSON
+
+echo "Created user_data at $USER_DATA_DIR"
+
+# Launch the app
+echo "Launching Dashcam.app from /Applications"
+if open "/Applications/$(basename "$APP_PATH")"; then
+  echo "Dashcam started"
+else
+  echo "Failed to launch Dashcam via open; attempting to run from installed bundle"
+  if [ -d "$TARGET_APP" ]; then
+    exec "${TARGET_APP}/Contents/MacOS/$(basename "${TARGET_APP%.*}")" &
+  else
+    echo "Cannot locate installed app to run." >&2
+    exit 6
+  fi
+fi
+
+echo "Installation complete. Temporary files are in $INSTALL_DIR (will be removed)."
+
+# Note: we intentionally do not remove INSTALL_DIR right away so logs and user_data
+# are available immediately after the script. Remove if desired.
+
+exit 0