@mcesystems/apple-kit 1.0.40 → 1.0.41

package/dist/types/logic/actions/pair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pair.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/pair.ts"],"names":[],"mappings":"AAGA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa7D;AAED,wBAAsB,WAAW,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAC5B,OAAO,CAAC,OAAO,CAAC,CA+BlB;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,SAAS,EAChB,YAAY,SAAO,GACjB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBzD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3D"}
+{"version":3,"file":"pair.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/pair.ts"],"names":[],"mappings":"AAGA,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa7D;AAED,wBAAsB,WAAW,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmClB;AAED,wBAAsB,cAAc,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,SAAS,EAChB,YAAY,SAAO,GACjB,OAAO,CAAC,OAAO,CAAC,CAelB;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBzD;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa3D"}

package/dist/types/logic/actions/restore.d.ts

@@ -0,0 +1,36 @@
+export interface RestoreOptions {
+    /**
+     * Timeout in milliseconds (default: 300000 = 5 minutes)
+     * Restore operations can take a long time, especially with firmware download
+     */
+    timeout?: number;
+    /**
+     * Path to IPSW file. If not provided, will restore to latest available firmware
+     */
+    ipswPath?: string;
+    /**
+     * Use erase mode instead of full restore (faster, but may not work on all devices)
+     */
+    erase?: boolean;
+}
+export interface RestoreResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+/**
+ * Restore an iOS device using idevicerestore
+ *
+ * This will restore the device to factory settings. If an IPSW path is provided,
+ * it will restore to that firmware version. Otherwise, it will restore to the
+ * latest available firmware for the device.
+ *
+ * WARNING: This operation will erase all data on the device!
+ *
+ * @param udid Device UDID
+ * @param options Restore options
+ * @returns Restore result
+ */
+export declare function restoreDevice(udid: string, options?: RestoreOptions): Promise<RestoreResult>;
+//# sourceMappingURL=restore.d.ts.map

package/dist/types/logic/actions/restore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/restore.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACjB;AAsHD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC1B,OAAO,CAAC,aAAa,CAAC,CA0ExB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcesystems/apple-kit",
-  "version": "1.0.40",
+  "version": "1.0.41",
   "description": "iOS device management toolkit using libimobiledevice command-line tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/scripts/build-windows.sh.template

@@ -1,166 +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"
-)
-
-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)
-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
-
-# 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
-
-# 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
-
-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."
+