feat: auto-download prebuilt node-pty binaries for Windows

Eliminates the need for Visual Studio Build Tools on Windows by:

1. GitHub Actions workflow (.github/workflows/build-prebuilds.yml)
   - Builds node-pty for Windows x64 with correct Electron ABI
   - Uploads prebuilt binaries as release assets
   - Triggered on releases and manual dispatch

2. Smart postinstall script (auto-claude-ui/scripts/postinstall.js)
   - On Windows: tries to download prebuilts first
   - Falls back to electron-rebuild if prebuilts unavailable
   - Shows clear instructions if compilation fails

3. Download helper (auto-claude-ui/scripts/download-prebuilds.js)
   - Fetches prebuilt binaries from GitHub releases
   - Extracts and installs to node_modules/node-pty

Windows users can now run `npm install` without installing Visual Studio
Build Tools, as long as prebuilt binaries exist for their Electron version.

Fixes #8

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <[email protected]>
This commit is contained in:
AndyMik90
2025-12-18 23:53:06 +01:00
co-authored by Claude Opus 4.5
parent e02aa597f2
commit 41a507fe8b
5 changed files with 533 additions and 1 deletions
+132
View File
@@ -0,0 +1,132 @@
name: Build Native Module Prebuilds
on:
# Build on releases
release:
types: [published]
# Manual trigger for testing
workflow_dispatch:
inputs:
electron_version:
description: 'Electron version to build for'
required: false
default: '39.2.6'
env:
# Default Electron version - update when upgrading Electron in package.json
ELECTRON_VERSION: ${{ github.event.inputs.electron_version || '39.2.6' }}
jobs:
build-windows:
runs-on: windows-latest
strategy:
matrix:
arch: [x64]
# Add arm64 when GitHub Actions supports Windows ARM runners
# arch: [x64, arm64]
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node.js
uses: actions/setup-node@v4
with:
node-version: '20'
- name: Setup pnpm
uses: pnpm/action-setup@v4
with:
version: 9
- name: Install Visual Studio Build Tools
uses: microsoft/setup-msbuild@v2
- name: Install node-pty and rebuild for Electron
working-directory: auto-claude-ui
shell: pwsh
run: |
# Install only node-pty
pnpm add [email protected]
# Get Electron ABI version
$electronAbi = (npx electron-abi $env:ELECTRON_VERSION)
Write-Host "Building for Electron $env:ELECTRON_VERSION (ABI: $electronAbi)"
# Rebuild node-pty for Electron
npx @electron/rebuild --version $env:ELECTRON_VERSION --module-dir node_modules/node-pty --arch ${{ matrix.arch }}
- name: Package prebuilt binaries
working-directory: auto-claude-ui
shell: pwsh
run: |
$electronAbi = (npx electron-abi $env:ELECTRON_VERSION)
$prebuildDir = "prebuilds/win32-${{ matrix.arch }}-electron-$electronAbi"
New-Item -ItemType Directory -Force -Path $prebuildDir
# Copy all built native files
$buildDir = "node_modules/node-pty/build/Release"
if (Test-Path $buildDir) {
Copy-Item "$buildDir/*.node" $prebuildDir/ -Force
Copy-Item "$buildDir/*.dll" $prebuildDir/ -Force -ErrorAction SilentlyContinue
Copy-Item "$buildDir/*.exe" $prebuildDir/ -Force -ErrorAction SilentlyContinue
# Also copy conpty files if they exist in subdirectory
if (Test-Path "$buildDir/conpty") {
Copy-Item "$buildDir/conpty/*" $prebuildDir/ -Force
}
}
# List what we packaged
Write-Host "Packaged prebuilds:"
Get-ChildItem $prebuildDir
- name: Create archive
working-directory: auto-claude-ui
shell: pwsh
run: |
$electronAbi = (npx electron-abi $env:ELECTRON_VERSION)
$archiveName = "node-pty-win32-${{ matrix.arch }}-electron-$electronAbi.zip"
Compress-Archive -Path "prebuilds/*" -DestinationPath $archiveName
Write-Host "Created archive: $archiveName"
Get-ChildItem $archiveName
- name: Upload artifact
uses: actions/upload-artifact@v4
with:
name: node-pty-win32-${{ matrix.arch }}
path: auto-claude-ui/node-pty-*.zip
retention-days: 90
- name: Upload to release
if: github.event_name == 'release'
uses: softprops/action-gh-release@v1
with:
files: auto-claude-ui/node-pty-*.zip
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
# Create a combined prebuilds package
package-prebuilds:
needs: build-windows
runs-on: ubuntu-latest
steps:
- name: Download all artifacts
uses: actions/download-artifact@v4
with:
path: artifacts
- name: List artifacts
run: |
echo "Downloaded artifacts:"
find artifacts -type f -name "*.zip"
- name: Upload combined artifact
uses: actions/upload-artifact@v4
with:
name: node-pty-prebuilds-all
path: artifacts/**/*.zip
retention-days: 90