@mcesystems/apple-kit 1.0.23 → 1.0.25

package/{resources → dist/resources}/licenses/LGPL-2.1.txt

@@ -1,33 +1,33 @@
-GNU LESSER GENERAL PUBLIC LICENSE
-Version 2.1, February 1999
-
-Copyright (C) 1991, 1999 Free Software Foundation, Inc.
-51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-
-Everyone is permitted to copy and distribute verbatim copies
-of this license document, but changing it is not allowed.
-
-[This is the first released version of the Lesser GPL.  It also counts
- as the successor of the GNU Library Public License, version 2, hence
- the version number 2.1.]
-
-                            Preamble
-
-  The licenses for most software are designed to take away your
-freedom to share and change it.  By contrast, the GNU General Public
-Licenses are intended to guarantee your freedom to share and change
-free software--to make sure the software is free for all its users.
-
-  This license, the Lesser General Public License, applies to some
-specially designated software packages--typically libraries--of the
-Free Software Foundation and other authors who decide to use it.  You
-can use it too, but we suggest you first think carefully about whether
-this license or the ordinary General Public License is the better
-strategy to use in any particular case, based on the explanations below.
-
-libimobiledevice is licensed under the GNU Lesser General Public License
-version 2.1 or later (LGPL-2.1+).
-
-For the full text of the LGPL-2.1 license, see:
-https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
-
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 2.1, February 1999
+
+Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL.  It also counts
+ as the successor of the GNU Library Public License, version 2, hence
+ the version number 2.1.]
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+Licenses are intended to guarantee your freedom to share and change
+free software--to make sure the software is free for all its users.
+
+  This license, the Lesser General Public License, applies to some
+specially designated software packages--typically libraries--of the
+Free Software Foundation and other authors who decide to use it.  You
+can use it too, but we suggest you first think carefully about whether
+this license or the ordinary General Public License is the better
+strategy to use in any particular case, based on the explanations below.
+
+libimobiledevice is licensed under the GNU Lesser General Public License
+version 2.1 or later (LGPL-2.1+).
+
+For the full text of the LGPL-2.1 license, see:
+https://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
+

package/dist/types/index.d.ts

@@ -10,6 +10,4 @@
 export { AppleDeviceKit } from "./logic/appleDeviceKit";
 export { ActivationState } from "./types";
 export type { AppInfo, AppleListenerConfig, DeviceListEntry, iOSDeviceInfo, PortForwardResult, } from "./types";
-export { PortManager, getSharedPortManager } from "./utils/portManager";
-export type { PortAllocation } from "./utils/portManager";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EACX,OAAO,EACP,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,GACjB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,YAAY,EACX,OAAO,EACP,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,GACjB,MAAM,SAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AAI5E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAM7C,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BxE;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAW9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,QAAQ,EAAE,aAAa,EACvB,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,WAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CAGrB;AAiDD;;GAEG;AACH,wBAAgB,eAAe;;;;;;;;;EAW9B"}
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/device.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAwB,MAAM,oBAAoB,CAAC;AAI5E,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAkB7C,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA4BxE;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAW9D;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,QAAQ,EAAE,aAAa,EACvB,IAAI,GAAE,MAAM,EAAO,EACnB,OAAO,GAAE,WAAgB,GACvB,OAAO,CAAC,UAAU,CAAC,CASrB;AAoJD;;GAEG;AACH,wBAAgB,eAAe;;;;;;;;;EAW9B"}

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

@@ -1 +1 @@
-{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAcjD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,cAAc,SAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CA+D/D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAKlE"}
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../../src/logic/actions/proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAG9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAiHjD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,cAAc,SAAM,GAClB,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,CAAC,CAsE/D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAKlE"}

package/dist/types/logic/appleDeviceKit.d.ts

@@ -1,5 +1,4 @@
 import type { ActivationState, AppInfo, PortForwardResult, iOSDeviceInfo } from "../types";
-import { type PortAllocation } from "../utils/portManager";
 /**
  * AppleDeviceKit - iOS device operations wrapper
  *
@@ -16,7 +15,7 @@ export declare class AppleDeviceKit {
     private readonly logicalPort;
     private deviceId;
     private proxyProcess;
-    private portAllocation;
+    private localDevicePort;
     private isDisposed;
     constructor(udid: string, logicalPort: number);
     /**
@@ -141,11 +140,7 @@ export declare class AppleDeviceKit {
      * Get the currently allocated local port for forwarding
      * Returns undefined if no port forward is active
      */
-    getAllocatedPort(): number | undefined;
-    /**
-     * Get the current port allocation info
-     */
-    getPortAllocation(): PortAllocation | null;
+    getDevicePort(): number | null;
     /**
      * Check if this kit has been disposed
      */

package/dist/types/logic/appleDeviceKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"appleDeviceKit.d.ts","sourceRoot":"","sources":["../../../src/logic/appleDeviceKit.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE3F,OAAO,EAAE,KAAK,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAOjF;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAQzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,UAAU,CAAS;gBAG1B,IAAI,EAAE,MAAM,EACK,WAAW,EAAE,MAAM;IAMrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAKpD;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;;;OAMG;IACU,cAAc,CAAC,OAAO,SAAS,EAAE,YAAY,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpF;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,OAAO,SAAQ,EAAE,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3F;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKvC;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;;;OAIG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;;;OAIG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAK3C;;;;;OAKG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;;;;;;;;;;;;OAaG;IACU,qBAAqB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,SAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAuB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACI,gBAAgB,IAAI,IAAI;IAW/B;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAK3D;;;;;;;;;OASG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;;OAGG;IACI,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAI7C;;OAEG;IACI,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAIjD;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED;;;;;OAKG;IACI,OAAO,IAAI,IAAI;IAatB;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}
+{"version":3,"file":"appleDeviceKit.d.ts","sourceRoot":"","sources":["../../../src/logic/appleDeviceKit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQ3F;;;;;;;;;;;GAWG;AACH,qBAAa,cAAc;IAQzB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAP7B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,UAAU,CAAS;gBAG1B,IAAI,EAAE,MAAM,EACK,WAAW,EAAE,MAAM;IAQrC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,aAAa,CAAC;IAKpD;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;;;;;OAMG;IACU,cAAc,CAAC,OAAO,SAAS,EAAE,YAAY,SAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAKpF;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAKrC;;;;;;;;;;;;OAYG;IACU,WAAW,CAAC,OAAO,SAAQ,EAAE,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;IAK3F;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAKvC;;;;OAIG;IACU,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD;;;;OAIG;IACU,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;;;OAIG;IACU,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/D;;OAEG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAK3C;;;;;OAKG;IACU,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5E;;;;;;;;;;;;;OAaG;IACU,qBAAqB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,SAAM,GAClB,OAAO,CAAC,iBAAiB,CAAC;IAsB7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACI,gBAAgB,IAAI,IAAI;IAS/B;;OAEG;IACU,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC;IAK3D;;;;;;;;;OASG;IACU,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;IAKzC;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACI,cAAc,IAAI,MAAM;IAI/B;;;OAGG;IACI,aAAa,IAAI,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAW,oBAAoB,IAAI,OAAO,CAEzC;IAED;;;;;OAKG;IACI,OAAO,IAAI,IAAI;IAatB;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcesystems/apple-kit",
-  "version": "1.0.23",
+  "version": "1.0.25",
   "description": "iOS device management toolkit using libimobiledevice command-line tools",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -33,7 +33,8 @@
   },
   "dependencies": {
     "debug": "^4.4.3",
-    "get-port": "^7.1.0"
+    "get-port": "^7.1.0",
+    "tsx": "^4.21.0"
   },
   "devDependencies": {
     "@types/debug": "^4.1.12",
@@ -42,15 +43,17 @@
     "esbuild": "^0.27.0",
     "esbuild-plugin-copy": "^2.1.1",
     "rimraf": "^6.0.1",
-    "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   },
   "files": [
     "dist",
-    "resources",
+    "scripts",
     "README.md"
   ],
+  "bin": {
+    "export-apple-resources": "./scripts/export-resources.ts"
+  },
   "scripts": {
     "build": "tsx esbuild.config.mts && tsc --emitDeclarationOnly",
     "clean": "rimraf dist",

package/scripts/README.md

@@ -0,0 +1,209 @@
+# Export Apple Resources Script
+
+This script exports libimobiledevice binaries and their dependencies to a specified target directory. The exported resources can be used by applications that depend on `@mcesystems/apple-kit`.
+
+## Usage
+
+After installing `@mcesystems/apple-kit`:
+
+```bash
+# Using the binary (recommended)
+npx export-apple-resources <target-path>
+
+# Or run the script directly with tsx
+npx tsx node_modules/@mcesystems/apple-kit/scripts/export-resources.ts <target-path>
+```
+
+### Examples
+
+```bash
+# Export to a relative path
+npx tsx export-resources.ts ./my-app/resources/apple-kit
+
+# Export to an absolute path
+npx tsx export-resources.ts /Users/me/projects/my-app/resources
+```
+
+### Output Structure
+
+The script creates the following directory structure:
+
+```
+<target-path>/
+├── bin/
+│   ├── darwin/          # macOS binaries and dylibs
+│   │   ├── idevice_id
+│   │   ├── ideviceinfo
+│   │   ├── iproxy
+│   │   ├── libimobiledevice-1.0.6.dylib
+│   │   └── ... (other tools and dylibs)
+│   └── windows/         # Windows binaries and DLLs
+│       ├── idevice_id.exe
+│       ├── ideviceinfo.exe
+│       ├── iproxy.exe
+│       ├── libimobiledevice-1.0-6.dll
+│       └── ... (other tools and DLLs)
+├── licenses/
+│   └── LGPL-2.1.txt
+└── build-windows.sh     # Windows build script (generated on non-Windows)
+```
+
+---
+
+## Platform-Specific Prerequisites
+
+### macOS
+
+#### Prerequisites
+
+1. **Homebrew** installed ([https://brew.sh](https://brew.sh))
+
+2. **libimobiledevice tools** installed via Homebrew:
+   ```bash
+   brew install libimobiledevice ideviceinstaller
+   ```
+
+3. **Node.js 18+** with `tsx` available:
+   ```bash
+   npm install -g tsx
+   # or use npx
+   ```
+
+#### How It Works
+
+On macOS, the script:
+1. Locates Homebrew installation (`/opt/homebrew` for Apple Silicon, `/usr/local` for Intel)
+2. Copies required binaries (`idevice_id`, `ideviceinfo`, `iproxy`, etc.)
+3. Recursively collects all dylib dependencies
+4. Fixes dylib paths using `install_name_tool` to use `@loader_path` (makes binaries portable)
+
+#### Running
+
+```bash
+cd scripts/export-apple-resources
+npx tsx export-resources.ts /path/to/output
+```
+
+---
+
+### Windows
+
+#### Prerequisites
+
+1. **MSYS2** installed from [https://www.msys2.org](https://www.msys2.org)
+   - Download and run the installer
+   - Default installation path: `C:\msys64`
+
+2. **Required MSYS2 packages** - Open **MSYS2 MinGW 64-bit** shell and run:
+   ```bash
+   pacman -S base-devel \
+       git \
+       mingw-w64-x86_64-gcc \
+       make \
+       libtool \
+       autoconf \
+       automake-wrapper
+   ```
+
+3. **Apple Mobile Device Support** (for USB communication)
+   - Either install iTunes from [https://www.apple.com/itunes/](https://www.apple.com/itunes/)
+   - Or install just "Apple Mobile Device Support" from the iTunes installer
+
+#### How It Works
+
+On Windows, building libimobiledevice from source is required. The script:
+1. Generates a `build-windows.sh` script in the target directory
+2. The build script downloads the official libimobiledevice build script
+3. Compiles all required libraries and tools from source
+4. Copies the resulting binaries and DLLs to the target directory
+
+#### Running
+
+**Step 1:** Generate the build script (can be done on any platform):
+```bash
+cd scripts/export-apple-resources
+npx tsx export-resources.ts /path/to/output
+```
+
+**Step 2:** Open **MSYS2 MinGW 64-bit** shell (NOT regular MSYS2 shell!)
+- Find it in Start Menu: "MSYS2 MinGW 64-bit"
+
+**Step 3:** Run the build script:
+```bash
+cd /path/to/output
+bash build-windows.sh
+```
+
+> **Note:** The build process may take 10-30 minutes depending on your system.
+
+#### Troubleshooting Windows Build
+
+| Issue | Solution |
+|-------|----------|
+| "gcc not found" | Install packages: `pacman -S mingw-w64-x86_64-gcc` |
+| "This script must be run from MSYS2 MinGW 64-bit shell" | Open the correct shell from Start Menu |
+| Build fails with SSL errors | `pacman -S mingw-w64-x86_64-openssl` |
+| Device not detected | Ensure iTunes or Apple Mobile Device Support is installed |
+
+---
+
+## Tools Included
+
+### Required Tools (must be present)
+| Tool | Description |
+|------|-------------|
+| `idevice_id` | List connected iOS devices |
+| `ideviceinfo` | Get device information |
+| `idevicepair` | Manage device pairing/trust |
+| `idevicename` | Get/set device name |
+| `idevicedebug` | Debug applications |
+| `ideviceinstaller` | Install/uninstall apps |
+| `iproxy` | Port forwarding |
+
+### Optional Tools (copied if available)
+| Tool | Description |
+|------|-------------|
+| `ideviceactivation` | Device activation |
+| `idevicesyslog` | View device system log |
+| `idevicescreenshot` | Take screenshots |
+| `idevicediagnostics` | Device diagnostics |
+
+---
+
+## Integrating with Your Application
+
+After exporting resources, configure `apple-kit` to use them:
+
+### Option 1: Environment Variable
+
+Set `IDeviceBinPath` to point to the bin directory:
+
+```bash
+# macOS
+export IDeviceBinPath=/path/to/resources/bin/darwin
+
+# Windows (PowerShell)
+$env:IDeviceBinPath = "C:\path\to\resources\bin\windows"
+```
+
+### Option 2: Bundle with Your App
+
+Copy the exported resources into your application's resources folder. The `apple-kit` package will automatically detect binaries in:
+- `<your-app>/resources/bin/darwin/` (macOS)
+- `<your-app>/resources/bin/windows/` (Windows)
+
+---
+
+## License
+
+The libimobiledevice tools are licensed under **LGPL-2.1**. When distributing these binaries, you must:
+1. Include the LGPL-2.1 license (automatically included in `licenses/` folder)
+2. Provide access to the source code (links included in the license file)
+
+Source code repositories:
+- https://github.com/libimobiledevice/libimobiledevice
+- https://github.com/libimobiledevice/libusbmuxd
+- https://github.com/libimobiledevice/libplist
+- https://github.com/libimobiledevice/libimobiledevice-glue
+- https://github.com/libimobiledevice/ideviceinstaller
+

package/scripts/build-windows.sh.template

@@ -0,0 +1,134 @@
+#!/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
+echo ""
+echo "Copying required DLLs..."
+
+DLLS=(
+    "libimobiledevice-1.0-6.dll"
+    "libusbmuxd-2.0-6.dll"
+    "libplist-2.0-4.dll"
+    "libimobiledevice-glue-1.0-0.dll"
+    "libssl-3-x64.dll"
+    "libcrypto-3-x64.dll"
+    "libzip-5.dll"
+    "liblzma-5.dll"
+    "libzstd.dll"
+    "libgcc_s_seh-1.dll"
+    "libwinpthread-1.dll"
+    "libstdc++-6.dll"
+)
+
+for dll in "${DLLS[@]}"; do
+    if [[ -f "$MINGW_BIN/$dll" ]]; then
+        cp "$MINGW_BIN/$dll" "$TARGET_DIR/"
+        echo "✓ Copied $dll"
+    else
+        echo "- Skipping $dll (not found)"
+    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."
+