chore: replace Playwright installation command in package.json with a custom postinstall script to improve CI performance

Author: doso

README.md

@@ -20,21 +20,21 @@ A Model Context Protocol (MCP) server for [Factifai](https://github.com/presidio
 ## Table of Contents
 
 - [Factifai MCP Server](#factifai-mcp-server)
-	- [Table of Contents](#table-of-contents)
-	- [Requirements](#requirements)
-	- [Installation](#installation)
-		- [Installation Note](#installation-note)
-		- [Pre-Installation Tip](#pre-installation-tip)
-	- [Configuration](#configuration)
-		- [Environment Variables](#environment-variables)
-		- [Model Provider Configuration Examples](#model-provider-configuration-examples)
-			- [Bedrock Configuration Example](#bedrock-configuration-example)
-			- [OpenAI Configuration Example](#openai-configuration-example)
-	- [Factifai MCP integration with popular IDE and extension](#factifai-mcp-integration-with-popular-ide-and-extension)
-		- [Available Tools](#available-tools)
-	- [Contributing](#contributing)
-	- [Security](#security)
-	- [License](#license)
+  - [Table of Contents](#table-of-contents)
+  - [Requirements](#requirements)
+  - [Installation](#installation)
+    - [Installation Note](#installation-note)
+    - [Pre-Installation Tip](#pre-installation-tip)
+  - [Configuration](#configuration)
+    - [Environment Variables](#environment-variables)
+    - [Model Provider Configuration Examples](#model-provider-configuration-examples)
+      - [Bedrock Configuration Example](#bedrock-configuration-example)
+      - [OpenAI Configuration Example](#openai-configuration-example)
+  - [Factifai MCP integration with popular IDE and extension](#factifai-mcp-integration-with-popular-ide-and-extension)
+    - [Available Tools](#available-tools)
+  - [Contributing](#contributing)
+  - [Security](#security)
+  - [License](#license)
 
 ## Requirements
 
@@ -58,6 +58,7 @@ We recommend `npx` to install the server, but you can use any node package manag
 ⚠️ **Important**: The first time you install Factifai MCP Server, it will automatically download and install browser dependencies using Playwright. This process may take several minutes depending on your internet connection and system specifications.
 
 The installation includes:
+
 - Downloading browser binaries (Chromium, Firefox, WebKit)
 - Installing browser dependencies
 - Setting up the necessary environment
@@ -79,6 +80,7 @@ npx --yes @presidio-dev/factifai-mcp-server@latest
 ```
 
 This pre-installation step:
+
 1. Ensures browsers are downloaded without MCP client timeout constraints
 2. Significantly speeds up the MCP server's first-time installation
 3. Prevents installation failures due to timeout issues in your IDE or MCP client

package.json

@@ -28,7 +28,7 @@
 		"dev": "concurrently \"npm:dev:watch\" \"npm:dev:mcp\"",
 		"dev:link": "npm link",
 		"build": "tsup index.ts --format esm --dts --out-dir dist --clean",
-		"postinstall": "playwright install --with-deps",
+		"postinstall": "node postinstall.cjs",
 		"format": "prettier --write .",
 		"format:check": "prettier --check .",
 		"release": "release-it",
@@ -53,6 +53,7 @@
 	},
 	"files": [
 		"dist",
+		"postinstall.cjs",
 		"README.md",
 		"LICENSE",
 		"package.json"

postinstall.cjs

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for @presidio-dev/factifai-mcp-server
+ *
+ * This script installs Playwright browsers when the package is installed,
+ * but skips installation in CI environments to improve build performance.
+ */
+
+const { execSync } = require('child_process')
+
+// Check if we're in a CI environment
+const isCI =
+	process.env.CI === 'true' ||
+	process.env.GITHUB_ACTIONS === 'true' ||
+	process.env.CONTINUOUS_INTEGRATION === 'true' ||
+	process.env.TRAVIS === 'true' ||
+	process.env.CIRCLECI === 'true' ||
+	process.env.JENKINS_URL ||
+	process.env.BUILDKITE === 'true' ||
+	process.env.DRONE === 'true' ||
+	Boolean(process.env.CI)
+
+if (isCI) {
+	console.log('ℹ️  CI environment detected, skipping Playwright browser installation')
+	console.log('   This speeds up your CI builds. Browsers can be installed manually if needed.')
+	process.exit(0)
+}
+
+// Not in CI, install Playwright browsers
+try {
+	console.log('📦 Installing Playwright browsers...')
+	execSync('npx playwright install --with-deps', {
+		stdio: 'inherit',
+		encoding: 'utf8',
+	})
+	console.log('✅ Playwright browsers installed successfully')
+} catch (error) {
+	console.error('❌ Failed to install Playwright browsers:', error.message)
+	console.error('   You may need to run "npx playwright install --with-deps" manually')
+	// Don't exit with error code to avoid breaking the entire installation
+	// Users can manually install browsers if needed
+	console.log('⚠️  Continuing with installation...')
+}