@mcesystems/apple-kit 1.0.68 → 1.0.70

package/README.md

@@ -1,258 +1,258 @@
-# @mcesystems/apple-kit
-
-iOS device management toolkit using libimobiledevice and go-ios command-line tools. We use both because they each provide capabilities that the other does not. The package provides app installation/uninstallation, port forwarding, activation, and device property access.
-
-## Features
-
-- **App Management**: Install and uninstall iOS applications (.ipa files)
-- **Port Forwarding**: Forward local ports to device ports (for debugging, etc.)
-- **Device Activation**: Activate devices and skip setup steps
-- **Trust/Pairing**: Handle device trust and pairing
-- **Device Info**: Access device properties (name, model, iOS version, UDID, etc.)
-- **Profile Management**: List and remove configuration profiles
-- **Device Wipe**: Erase device data (factory reset)
-- **Cross-platform**: Works on Windows, macOS, and Linux
-
-## Installation
-
-```bash
-npm install @mcesystems/apple-kit
-```
-
-## Requirements
-
-- Node.js 18+
-- iOS device connected via USB
-- Device must be trusted/paired with the computer
-- libimobiledevice tools (idevice\*)
-- go-ios `ios` CLI binary
-
-### Platform-specific Requirements
-
-#### Windows
-- libimobiledevice binaries - use the export script (see below)
-- go-ios `ios.exe` (see Resources section below)
-- iTunes installed OR Apple Mobile Device Support
-
-#### macOS
-**Option 1: Use bundled binaries (recommended for distribution)**
-
-Use the export script to bundle libimobiledevice for your application:
-```bash
-# Using npx (after installing the package)
-npx export-apple-resources /path/to/your-app/resources/apple-kit
-
-# Or run the script directly
-npx tsx node_modules/@mcesystems/apple-kit/scripts/export-resources.ts /path/to/your-app/resources
-```
-
-See [scripts/README.md](./scripts/README.md) for detailed prerequisites and instructions.
-
-**Option 2: Use Homebrew installation (for development)**
-- Install via Homebrew: `brew install libimobiledevice ideviceinstaller`
-- Tools are auto-detected from `/opt/homebrew/bin` (Apple Silicon) or `/usr/local/bin` (Intel)
-
-#### Linux
-- libimobiledevice-utils: `sudo apt install libimobiledevice-utils`
-- Tools are auto-detected from `/usr/bin` or `/usr/local/bin`
-
-### Resources and Binary Resolution
-
-Set a resources directory once so both toolchains can be located:
-
-```typescript
-import path from "node:path";
-import { AppleDeviceKit } from "@mcesystems/apple-kit";
-
-AppleDeviceKit.setResourcesDir(path.join(process.cwd(), "resources"));
-```
-
-If you do not set a resources directory, make sure both toolchains are on your PATH.
-
-The package looks for tools in this order:
-1. `resourcesDir/ios/bin/{platform}/` (go-ios `ios` and libimobiledevice tools)
-2. Homebrew paths on macOS (`/opt/homebrew/bin`, `/usr/local/bin`)
-3. System PATH (for global installations)
-
-## Usage
-
-### List Devices (go-ios)
-
-```typescript
-import { createIosCli } from "@mcesystems/apple-kit";
-
-// Example: <resourcesDir>/ios/bin/{platform}/ios(.exe)
-const cli = createIosCli("path/to/ios");
-const list = await cli.listDevices();
-console.log(list.udids);
-```
-
-### Install/Uninstall Agent
-
-```typescript
-import { AppleDeviceKit } from '@mcesystems/apple-kit';
-
-const device = new AppleDeviceKit('device-udid', 1);
-
-// Install app locally, then (if MDM is configured) take over management
-await device.installApp('/path/to/agent.ipa', {
-  appId: 'com.example.agent',
-  url: 'https://example.com/agent.ipa',
-  waitForInstalled: true
-});
-
-// Check if installed
-const isInstalled = await device.isAppInstalled('com.example.agent');
-
-// List all installed apps
-const apps = await device.listApps();
-
-// Uninstall an agent/app
-await device.uninstallApp('com.example.agent');
-```
-
-### Device Info
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-const info = await device.info();
-console.log(`Device: ${info.DeviceName}`);
-console.log(`Model: ${info.ProductType}`);
-console.log(`iOS: ${info.ProductVersion} (${info.BuildVersion})`);
-console.log(`Serial: ${info.SerialNumber}`);
-console.log(`UDID: ${info.UniqueDeviceID}`);
-```
-
-### Trust/Pairing
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-// Check if device is trusted
-const isPaired = await device.isPaired();
-
-// Trust the device (initiates pairing and waits for user acceptance)
-await device.trustDevice(60000);
-
-// Unpair device
-await device.unpair();
-```
-
-### Port Forwarding
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-// Forward device port 8080 to a local port (auto-allocated)
-const forward = await device.startPortForwardAsync(8080);
-console.log(`Local port: ${forward.localPort}`);
-
-// Use the forwarded connection...
-// connect to localhost:8080 to reach device:8080
-
-// Stop forwarding when done
-device.closePortForward();
-```
-
-### Activation
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-// Get activation state
-const state = await device.getActivationState();
-console.log(`Activated: ${state.isActivated}`);
-console.log(`State: ${state.activationState}`);
-
-// Activate device (uses go-ios and MDM client)
-const cleanup = await device.activate();
-if (cleanup) {
-  await cleanup(); // removes WiFi profile when done
-}
-```
-
-The activation flow can install a WiFi profile based on environment variables:
-`WIFI_SSID`, `WIFI_PASSWORD`, `WIFI_ENCRYPTION`, `WIFI_HIDDEN`, `WIFI_ENTERPRISE`,
-`WIFI_USERNAME`, and `WIFI_EAP_TYPE`.
-
-### Profiles
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-// List profiles
-const profiles = await device.listProfiles();
-console.log(profiles.profiles);
-
-// Remove a profile by identifier
-await device.removeProfile("com.example.profile");
-```
-
-### Wipe Device
-
-```typescript
-const device = new AppleDeviceKit('device-udid', 1);
-
-// WARNING: this erases all data
-await device.wipe();
-```
-
-## API Reference
-
-### AppleDeviceKit
-
-**Static methods:**
-- `setResourcesDir(dir)`: Configure resources location
-
-**Device Info:**
-- `info()`: Get device properties
-- `getDeviceId()`: Get the device UDID
-- `getLogicalPort()`: Get the logical port number
-- `getDevicePort()`: Get current local forwarded port (or null)
-
-**App Management:**
-- `installApp(ipaPath, options)`: Install IPA and take over via MDM if configured
-- `uninstallApp(bundleId)`: Uninstall an app by bundle ID
-- `isAppInstalled(bundleId)`: Check if app is installed
-- `listApps()`: List all installed user apps
-
-**Trust/Pairing:**
-- `isPaired()`: Check if device is paired/trusted
-- `pair()`: Initiate pairing (user must accept on device)
-- `trustDevice(timeout?, onWaiting?)`: Pair and wait for user acceptance
-- `unpair()`: Remove pairing/trust
-- `waitForPairing(timeout?, pollInterval?)`: Wait for device to be paired
-
-**Port Forwarding:**
-- `startPortForwardAsync(devicePort, startupTimeout?)`: Start and wait for ready
-- `closePortForward()`: Stop forwarding
-
-**Profiles:**
-- `listProfiles()`: List installed profiles
-- `removeProfile(identifier)`: Remove profile by identifier
-
-**Activation:**
-- `getActivationState()`: Get activation state
-- `activate()`: Activate the device (returns cleanup function)
-
-**Device Wipe:**
-- `wipe()`: Erase device data
-
-**Lifecycle:**
-- `dispose()`: Clean up resources and port forwards
-
-### Types
-
-```typescript
-interface ActivationState {
-  isActivated: boolean;
-  activationState: string;
-}
-```
-
-## License
-
-ISC
-
-libimobiledevice is licensed under LGPL-2.1.
+# @mcesystems/apple-kit
+
+iOS device management toolkit using libimobiledevice and go-ios command-line tools. We use both because they each provide capabilities that the other does not. The package provides app installation/uninstallation, port forwarding, activation, and device property access.
+
+## Features
+
+- **App Management**: Install and uninstall iOS applications (.ipa files)
+- **Port Forwarding**: Forward local ports to device ports (for debugging, etc.)
+- **Device Activation**: Activate devices and skip setup steps
+- **Trust/Pairing**: Handle device trust and pairing
+- **Device Info**: Access device properties (name, model, iOS version, UDID, etc.)
+- **Profile Management**: List and remove configuration profiles
+- **Device Wipe**: Erase device data (factory reset)
+- **Cross-platform**: Works on Windows, macOS, and Linux
+
+## Installation
+
+```bash
+npm install @mcesystems/apple-kit
+```
+
+## Requirements
+
+- Node.js 18+
+- iOS device connected via USB
+- Device must be trusted/paired with the computer
+- libimobiledevice tools (idevice\*)
+- go-ios `ios` CLI binary
+
+### Platform-specific Requirements
+
+#### Windows
+- libimobiledevice binaries - use the export script (see below)
+- go-ios `ios.exe` (see Resources section below)
+- iTunes installed OR Apple Mobile Device Support
+
+#### macOS
+**Option 1: Use bundled binaries (recommended for distribution)**
+
+Use the export script to bundle libimobiledevice for your application:
+```bash
+# Using npx (after installing the package)
+npx export-apple-resources /path/to/your-app/resources/apple-kit
+
+# Or run the script directly
+npx tsx node_modules/@mcesystems/apple-kit/scripts/export-resources.ts /path/to/your-app/resources
+```
+
+See [scripts/README.md](./scripts/README.md) for detailed prerequisites and instructions.
+
+**Option 2: Use Homebrew installation (for development)**
+- Install via Homebrew: `brew install libimobiledevice ideviceinstaller`
+- Tools are auto-detected from `/opt/homebrew/bin` (Apple Silicon) or `/usr/local/bin` (Intel)
+
+#### Linux
+- libimobiledevice-utils: `sudo apt install libimobiledevice-utils`
+- Tools are auto-detected from `/usr/bin` or `/usr/local/bin`
+
+### Resources and Binary Resolution
+
+Set a resources directory once so both toolchains can be located:
+
+```typescript
+import path from "node:path";
+import { AppleDeviceKit } from "@mcesystems/apple-kit";
+
+AppleDeviceKit.setResourcesDir(path.join(process.cwd(), "resources"));
+```
+
+If you do not set a resources directory, make sure both toolchains are on your PATH.
+
+The package looks for tools in this order:
+1. `resourcesDir/ios/bin/{platform}/` (go-ios `ios` and libimobiledevice tools)
+2. Homebrew paths on macOS (`/opt/homebrew/bin`, `/usr/local/bin`)
+3. System PATH (for global installations)
+
+## Usage
+
+### List Devices (go-ios)
+
+```typescript
+import { createIosCli } from "@mcesystems/apple-kit";
+
+// Example: <resourcesDir>/ios/bin/{platform}/ios(.exe)
+const cli = createIosCli("path/to/ios");
+const list = await cli.listDevices();
+console.log(list.udids);
+```
+
+### Install/Uninstall Agent
+
+```typescript
+import { AppleDeviceKit } from '@mcesystems/apple-kit';
+
+const device = new AppleDeviceKit('device-udid', 1);
+
+// Install app locally, then (if MDM is configured) take over management
+await device.installApp('/path/to/agent.ipa', {
+  appId: 'com.example.agent',
+  url: 'https://example.com/agent.ipa',
+  waitForInstalled: true
+});
+
+// Check if installed
+const isInstalled = await device.isAppInstalled('com.example.agent');
+
+// List all installed apps
+const apps = await device.listApps();
+
+// Uninstall an agent/app
+await device.uninstallApp('com.example.agent');
+```
+
+### Device Info
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+const info = await device.info();
+console.log(`Device: ${info.DeviceName}`);
+console.log(`Model: ${info.ProductType}`);
+console.log(`iOS: ${info.ProductVersion} (${info.BuildVersion})`);
+console.log(`Serial: ${info.SerialNumber}`);
+console.log(`UDID: ${info.UniqueDeviceID}`);
+```
+
+### Trust/Pairing
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+// Check if device is trusted
+const isPaired = await device.isPaired();
+
+// Trust the device (initiates pairing and waits for user acceptance)
+await device.trustDevice(60000);
+
+// Unpair device
+await device.unpair();
+```
+
+### Port Forwarding
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+// Forward device port 8080 to a local port (auto-allocated)
+const forward = await device.startPortForwardAsync(8080);
+console.log(`Local port: ${forward.localPort}`);
+
+// Use the forwarded connection...
+// connect to localhost:8080 to reach device:8080
+
+// Stop forwarding when done
+device.closePortForward();
+```
+
+### Activation
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+// Get activation state
+const state = await device.getActivationState();
+console.log(`Activated: ${state.isActivated}`);
+console.log(`State: ${state.activationState}`);
+
+// Activate device (uses go-ios and MDM client)
+const cleanup = await device.activate();
+if (cleanup) {
+  await cleanup(); // removes WiFi profile when done
+}
+```
+
+The activation flow can install a WiFi profile based on environment variables:
+`WIFI_SSID`, `WIFI_PASSWORD`, `WIFI_ENCRYPTION`, `WIFI_HIDDEN`, `WIFI_ENTERPRISE`,
+`WIFI_USERNAME`, and `WIFI_EAP_TYPE`.
+
+### Profiles
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+// List profiles
+const profiles = await device.listProfiles();
+console.log(profiles.profiles);
+
+// Remove a profile by identifier
+await device.removeProfile("com.example.profile");
+```
+
+### Wipe Device
+
+```typescript
+const device = new AppleDeviceKit('device-udid', 1);
+
+// WARNING: this erases all data
+await device.wipe();
+```
+
+## API Reference
+
+### AppleDeviceKit
+
+**Static methods:**
+- `setResourcesDir(dir)`: Configure resources location
+
+**Device Info:**
+- `info()`: Get device properties
+- `getDeviceId()`: Get the device UDID
+- `getLogicalPort()`: Get the logical port number
+- `getDevicePort()`: Get current local forwarded port (or null)
+
+**App Management:**
+- `installApp(ipaPath, options)`: Install IPA and take over via MDM if configured
+- `uninstallApp(bundleId)`: Uninstall an app by bundle ID
+- `isAppInstalled(bundleId)`: Check if app is installed
+- `listApps()`: List all installed user apps
+
+**Trust/Pairing:**
+- `isPaired()`: Check if device is paired/trusted
+- `pair()`: Initiate pairing (user must accept on device)
+- `trustDevice(timeout?, onWaiting?)`: Pair and wait for user acceptance
+- `unpair()`: Remove pairing/trust
+- `waitForPairing(timeout?, pollInterval?)`: Wait for device to be paired
+
+**Port Forwarding:**
+- `startPortForwardAsync(devicePort, startupTimeout?)`: Start and wait for ready
+- `closePortForward()`: Stop forwarding
+
+**Profiles:**
+- `listProfiles()`: List installed profiles
+- `removeProfile(identifier)`: Remove profile by identifier
+
+**Activation:**
+- `getActivationState()`: Get activation state
+- `activate()`: Activate the device (returns cleanup function)
+
+**Device Wipe:**
+- `wipe()`: Erase device data
+
+**Lifecycle:**
+- `dispose()`: Clean up resources and port forwards
+
+### Types
+
+```typescript
+interface ActivationState {
+  isActivated: boolean;
+  activationState: string;
+}
+```
+
+## License
+
+ISC
+
+libimobiledevice is licensed under LGPL-2.1.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcesystems/apple-kit",
-  "version": "1.0.68",
+  "version": "1.0.70",
   "description": "iOS device management toolkit using libimobiledevice command-line tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -36,8 +36,8 @@
     "graphql": "^14.5.8",
     "graphql-request": "^5.2.0",
     "tsx": "^4.21.0",
-    "@mcesystems/mdm-client-g4": "1.0.68",
-    "@mcesystems/tool-debug-g4": "1.0.68"
+    "@mcesystems/tool-debug-g4": "1.0.70",
+    "@mcesystems/mdm-client-g4": "1.0.70"
   },
   "devDependencies": {
     "@types/node": "^22.10.2",
@@ -46,6 +46,7 @@
     "esbuild": "^0.27.0",
     "esbuild-plugin-copy": "^2.1.1",
     "go-ios": "^1.0.188",
+    "pnpm": "10.24.0",
     "rimraf": "^6.0.1",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
@@ -64,6 +65,7 @@
   },
   "scripts": {
     "build": "tsx esbuild.config.mts && tsc --emitDeclarationOnly",
+    "build:all": "pnpm --filter @mcesystems/apple-kit... build",
     "clean": "rimraf dist",
     "check:types": "tsc --noEmit",
     "activate:example": "tsx src/examples/activationExample.ts",

package/scripts/build-windows.sh.template

@@ -1,222 +1,222 @@
-#!/bin/bash
-# =============================================================================
-# libimobiledevice Windows Build Script
-# =============================================================================
-#
-# This script builds libimobiledevice and related tools from source using
-# MSYS2/MinGW environment.
-#
-# Prerequisites:
-#   1. MSYS2 installed (https://www.msys2.org/)
-#   2. Run this script from MSYS2 MinGW 64-bit shell
-#   3. Required packages installed (see below)
-#
-# To install required packages, run in MSYS2 MinGW 64-bit shell:
-#   pacman -S base-devel git mingw-w64-x86_64-gcc make libtool autoconf automake-wrapper
-#
-# Usage:
-#   bash build-windows.sh
-#
-# =============================================================================
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-TARGET_DIR="{{TARGET_DIR}}"
-BUILD_DIR="$SCRIPT_DIR/limd-build"
-
-echo "=== libimobiledevice Windows Build ==="
-echo ""
-echo "Target directory: $TARGET_DIR"
-echo "Build directory: $BUILD_DIR"
-echo ""
-
-# Check if running in MinGW environment
-if [[ -z "$MSYSTEM" ]] || [[ "$MSYSTEM" != "MINGW64" ]]; then
-    echo "Error: This script must be run from MSYS2 MinGW 64-bit shell"
-    echo "Open 'MSYS2 MinGW 64-bit' from Start menu and run this script again."
-    exit 1
-fi
-
-# Check for required tools
-echo "Checking prerequisites..."
-for cmd in gcc make git autoconf automake libtool; do
-    if ! command -v $cmd &> /dev/null; then
-        echo "Error: $cmd not found. Please install required packages:"
-        echo "  pacman -S base-devel git mingw-w64-x86_64-gcc make libtool autoconf automake-wrapper"
-        exit 1
-    fi
-done
-echo "✓ All prerequisites found"
-echo ""
-
-# Create build directory
-mkdir -p "$BUILD_DIR"
-cd "$BUILD_DIR"
-
-# Download and run the official build script
-echo "Downloading libimobiledevice build script..."
-curl -Ls -o limd-build-msys2.sh https://is.gd/limdmsys2
-
-echo ""
-echo "Running libimobiledevice build script..."
-echo "(This may take 10-30 minutes depending on your system)"
-echo ""
-
-bash ./limd-build-msys2.sh
-
-# After build, copy the binaries to target directory
-echo ""
-echo "Copying binaries to target directory..."
-
-mkdir -p "$TARGET_DIR"
-
-# The build script installs to /mingw64 by default
-MINGW_BIN="/mingw64/bin"
-
-TOOLS=(
-    "idevice_id.exe"
-    "ideviceinfo.exe"
-    "idevicepair.exe"
-    "idevicename.exe"
-    "idevicedebug.exe"
-    "ideviceinstaller.exe"
-    "iproxy.exe"
-    "ideviceactivation.exe"
-    "idevicesyslog.exe"
-    "idevicescreenshot.exe"
-    "idevicediagnostics.exe"
-    "idevicerestore.exe"
-)
-
-for tool in "${TOOLS[@]}"; do
-    if [[ -f "$MINGW_BIN/$tool" ]]; then
-        cp "$MINGW_BIN/$tool" "$TARGET_DIR/"
-        echo "✓ Copied $tool"
-    else
-        echo "- Skipping $tool (not found)"
-    fi
-done
-
-# Copy required DLLs by discovering dependencies
-echo ""
-echo "Discovering and copying required DLLs..."
-
-# Function to recursively find all DLL dependencies
-find_dll_deps() {
-    local file="$1"
-    ldd "$file" 2>/dev/null | grep '/mingw64' | awk '{print $3}' | sort -u
-}
-
-# Collect all unique DLLs needed by all tools
-ALL_DLLS=""
-for tool in "${TOOLS[@]}"; do
-    if [[ -f "$TARGET_DIR/$tool" ]]; then
-        TOOL_DLLS=$(find_dll_deps "$TARGET_DIR/$tool")
-        ALL_DLLS="$ALL_DLLS $TOOL_DLLS"
-    fi
-done
-
-# Also check dependencies of the DLLs themselves (transitive deps)
-# Do multiple passes to ensure we get all nested dependencies
-for pass in {1..3}; do
-    for dll_path in $ALL_DLLS; do
-        if [[ -f "$dll_path" ]]; then
-            NESTED_DLLS=$(find_dll_deps "$dll_path")
-            ALL_DLLS="$ALL_DLLS $NESTED_DLLS"
-        fi
-    done
-done
-
-# Get unique list
-UNIQUE_DLLS=$(echo "$ALL_DLLS" | tr ' ' '\n' | sort -u | grep -v '^$')
-
-# Copy each DLL
-for dll_path in $UNIQUE_DLLS; do
-    if [[ -f "$dll_path" ]]; then
-        dll_name=$(basename "$dll_path")
-        cp "$dll_path" "$TARGET_DIR/"
-        echo "✓ Copied $dll_name"
-    fi
-done
-
-# Specifically check for idevicerestore dependencies (libirecovery, libidevicerestore)
-if [[ -f "$TARGET_DIR/idevicerestore.exe" ]]; then
-    echo ""
-    echo "Checking idevicerestore-specific dependencies..."
-    
-    # Look for libirecovery and libidevicerestore DLLs
-    IRECOVERY_DLLS=$(find "$MINGW_BIN" -name "libirecovery*.dll" 2>/dev/null || true)
-    IDEVICERESTORE_DLLS=$(find "$MINGW_BIN" -name "libidevicerestore*.dll" 2>/dev/null || true)
-    
-    for dll in $IRECOVERY_DLLS $IDEVICERESTORE_DLLS; do
-        if [[ -f "$dll" ]]; then
-            dll_name=$(basename "$dll")
-            if [[ ! -f "$TARGET_DIR/$dll_name" ]]; then
-                cp "$dll" "$TARGET_DIR/"
-                echo "✓ Copied $dll_name (idevicerestore dependency)"
-            fi
-        fi
-    done
-fi
-
-# Explicitly copy all libimobiledevice core libraries
-echo ""
-echo "Copying libimobiledevice core libraries..."
-CORE_LIBS=(
-    "libimobiledevice-1.0.dll"
-    "libimobiledevice-glue-1.0.dll"
-    "libusbmuxd-2.0.dll"
-    "libplist-2.0.dll"
-    "libirecovery-1.0.dll"
-    "libidevicerestore-1.0.dll"
-    "libideviceactivation-1.0.dll"
-)
-
-for lib in "${CORE_LIBS[@]}"; do
-    if [[ -f "$MINGW_BIN/$lib" ]] && [[ ! -f "$TARGET_DIR/$lib" ]]; then
-        cp "$MINGW_BIN/$lib" "$TARGET_DIR/"
-        echo "✓ Copied $lib (core library)"
-    fi
-done
-
-# Also copy these common runtime DLLs that might not show up in ldd
-RUNTIME_DLLS=(
-    "libgcc_s_seh-1.dll"
-    "libwinpthread-1.dll"
-    "libstdc++-6.dll"
-    "libssl-3-x64.dll"
-    "libcrypto-3-x64.dll"
-    "liblzma-5.dll"
-    "libzstd.dll"
-    "zlib1.dll"
-)
-
-echo ""
-echo "Copying runtime DLLs..."
-for dll in "${RUNTIME_DLLS[@]}"; do
-    if [[ -f "$MINGW_BIN/$dll" ]] && [[ ! -f "$TARGET_DIR/$dll" ]]; then
-        cp "$MINGW_BIN/$dll" "$TARGET_DIR/"
-        echo "✓ Copied $dll"
-    fi
-done
-
-# List all DLLs that were copied for verification
-echo ""
-echo "=== Summary of copied libraries ==="
-echo "Core libimobiledevice libraries:"
-for lib in "${CORE_LIBS[@]}"; do
-    if [[ -f "$TARGET_DIR/$lib" ]]; then
-        echo "  ✓ $lib"
-    else
-        echo "  ✗ $lib (missing)"
-    fi
-done
-
-echo ""
-echo "=== Build Complete ==="
-echo "Windows binaries exported to: $TARGET_DIR"
-echo ""
-echo "Note: On Windows, iTunes or Apple Mobile Device Support must be installed"
-echo "for USB communication to work."
-
+#!/bin/bash
+# =============================================================================
+# libimobiledevice Windows Build Script
+# =============================================================================
+#
+# This script builds libimobiledevice and related tools from source using
+# MSYS2/MinGW environment.
+#
+# Prerequisites:
+#   1. MSYS2 installed (https://www.msys2.org/)
+#   2. Run this script from MSYS2 MinGW 64-bit shell
+#   3. Required packages installed (see below)
+#
+# To install required packages, run in MSYS2 MinGW 64-bit shell:
+#   pacman -S base-devel git mingw-w64-x86_64-gcc make libtool autoconf automake-wrapper
+#
+# Usage:
+#   bash build-windows.sh
+#
+# =============================================================================
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+TARGET_DIR="{{TARGET_DIR}}"
+BUILD_DIR="$SCRIPT_DIR/limd-build"
+
+echo "=== libimobiledevice Windows Build ==="
+echo ""
+echo "Target directory: $TARGET_DIR"
+echo "Build directory: $BUILD_DIR"
+echo ""
+
+# Check if running in MinGW environment
+if [[ -z "$MSYSTEM" ]] || [[ "$MSYSTEM" != "MINGW64" ]]; then
+    echo "Error: This script must be run from MSYS2 MinGW 64-bit shell"
+    echo "Open 'MSYS2 MinGW 64-bit' from Start menu and run this script again."
+    exit 1
+fi
+
+# Check for required tools
+echo "Checking prerequisites..."
+for cmd in gcc make git autoconf automake libtool; do
+    if ! command -v $cmd &> /dev/null; then
+        echo "Error: $cmd not found. Please install required packages:"
+        echo "  pacman -S base-devel git mingw-w64-x86_64-gcc make libtool autoconf automake-wrapper"
+        exit 1
+    fi
+done
+echo "✓ All prerequisites found"
+echo ""
+
+# Create build directory
+mkdir -p "$BUILD_DIR"
+cd "$BUILD_DIR"
+
+# Download and run the official build script
+echo "Downloading libimobiledevice build script..."
+curl -Ls -o limd-build-msys2.sh https://is.gd/limdmsys2
+
+echo ""
+echo "Running libimobiledevice build script..."
+echo "(This may take 10-30 minutes depending on your system)"
+echo ""
+
+bash ./limd-build-msys2.sh
+
+# After build, copy the binaries to target directory
+echo ""
+echo "Copying binaries to target directory..."
+
+mkdir -p "$TARGET_DIR"
+
+# The build script installs to /mingw64 by default
+MINGW_BIN="/mingw64/bin"
+
+TOOLS=(
+    "idevice_id.exe"
+    "ideviceinfo.exe"
+    "idevicepair.exe"
+    "idevicename.exe"
+    "idevicedebug.exe"
+    "ideviceinstaller.exe"
+    "iproxy.exe"
+    "ideviceactivation.exe"
+    "idevicesyslog.exe"
+    "idevicescreenshot.exe"
+    "idevicediagnostics.exe"
+    "idevicerestore.exe"
+)
+
+for tool in "${TOOLS[@]}"; do
+    if [[ -f "$MINGW_BIN/$tool" ]]; then
+        cp "$MINGW_BIN/$tool" "$TARGET_DIR/"
+        echo "✓ Copied $tool"
+    else
+        echo "- Skipping $tool (not found)"
+    fi
+done
+
+# Copy required DLLs by discovering dependencies
+echo ""
+echo "Discovering and copying required DLLs..."
+
+# Function to recursively find all DLL dependencies
+find_dll_deps() {
+    local file="$1"
+    ldd "$file" 2>/dev/null | grep '/mingw64' | awk '{print $3}' | sort -u
+}
+
+# Collect all unique DLLs needed by all tools
+ALL_DLLS=""
+for tool in "${TOOLS[@]}"; do
+    if [[ -f "$TARGET_DIR/$tool" ]]; then
+        TOOL_DLLS=$(find_dll_deps "$TARGET_DIR/$tool")
+        ALL_DLLS="$ALL_DLLS $TOOL_DLLS"
+    fi
+done
+
+# Also check dependencies of the DLLs themselves (transitive deps)
+# Do multiple passes to ensure we get all nested dependencies
+for pass in {1..3}; do
+    for dll_path in $ALL_DLLS; do
+        if [[ -f "$dll_path" ]]; then
+            NESTED_DLLS=$(find_dll_deps "$dll_path")
+            ALL_DLLS="$ALL_DLLS $NESTED_DLLS"
+        fi
+    done
+done
+
+# Get unique list
+UNIQUE_DLLS=$(echo "$ALL_DLLS" | tr ' ' '\n' | sort -u | grep -v '^$')
+
+# Copy each DLL
+for dll_path in $UNIQUE_DLLS; do
+    if [[ -f "$dll_path" ]]; then
+        dll_name=$(basename "$dll_path")
+        cp "$dll_path" "$TARGET_DIR/"
+        echo "✓ Copied $dll_name"
+    fi
+done
+
+# Specifically check for idevicerestore dependencies (libirecovery, libidevicerestore)
+if [[ -f "$TARGET_DIR/idevicerestore.exe" ]]; then
+    echo ""
+    echo "Checking idevicerestore-specific dependencies..."
+    
+    # Look for libirecovery and libidevicerestore DLLs
+    IRECOVERY_DLLS=$(find "$MINGW_BIN" -name "libirecovery*.dll" 2>/dev/null || true)
+    IDEVICERESTORE_DLLS=$(find "$MINGW_BIN" -name "libidevicerestore*.dll" 2>/dev/null || true)
+    
+    for dll in $IRECOVERY_DLLS $IDEVICERESTORE_DLLS; do
+        if [[ -f "$dll" ]]; then
+            dll_name=$(basename "$dll")
+            if [[ ! -f "$TARGET_DIR/$dll_name" ]]; then
+                cp "$dll" "$TARGET_DIR/"
+                echo "✓ Copied $dll_name (idevicerestore dependency)"
+            fi
+        fi
+    done
+fi
+
+# Explicitly copy all libimobiledevice core libraries
+echo ""
+echo "Copying libimobiledevice core libraries..."
+CORE_LIBS=(
+    "libimobiledevice-1.0.dll"
+    "libimobiledevice-glue-1.0.dll"
+    "libusbmuxd-2.0.dll"
+    "libplist-2.0.dll"
+    "libirecovery-1.0.dll"
+    "libidevicerestore-1.0.dll"
+    "libideviceactivation-1.0.dll"
+)
+
+for lib in "${CORE_LIBS[@]}"; do
+    if [[ -f "$MINGW_BIN/$lib" ]] && [[ ! -f "$TARGET_DIR/$lib" ]]; then
+        cp "$MINGW_BIN/$lib" "$TARGET_DIR/"
+        echo "✓ Copied $lib (core library)"
+    fi
+done
+
+# Also copy these common runtime DLLs that might not show up in ldd
+RUNTIME_DLLS=(
+    "libgcc_s_seh-1.dll"
+    "libwinpthread-1.dll"
+    "libstdc++-6.dll"
+    "libssl-3-x64.dll"
+    "libcrypto-3-x64.dll"
+    "liblzma-5.dll"
+    "libzstd.dll"
+    "zlib1.dll"
+)
+
+echo ""
+echo "Copying runtime DLLs..."
+for dll in "${RUNTIME_DLLS[@]}"; do
+    if [[ -f "$MINGW_BIN/$dll" ]] && [[ ! -f "$TARGET_DIR/$dll" ]]; then
+        cp "$MINGW_BIN/$dll" "$TARGET_DIR/"
+        echo "✓ Copied $dll"
+    fi
+done
+
+# List all DLLs that were copied for verification
+echo ""
+echo "=== Summary of copied libraries ==="
+echo "Core libimobiledevice libraries:"
+for lib in "${CORE_LIBS[@]}"; do
+    if [[ -f "$TARGET_DIR/$lib" ]]; then
+        echo "  ✓ $lib"
+    else
+        echo "  ✗ $lib (missing)"
+    fi
+done
+
+echo ""
+echo "=== Build Complete ==="
+echo "Windows binaries exported to: $TARGET_DIR"
+echo ""
+echo "Note: On Windows, iTunes or Apple Mobile Device Support must be installed"
+echo "for USB communication to work."
+