@mcesystems/apple-kit 1.0.23 → 1.0.25

package/scripts/export-resources.ts

@@ -0,0 +1,444 @@
+#!/usr/bin/env tsx
+/**
+ * Export libimobiledevice resources to a specified path
+ *
+ * This script exports the libimobiledevice binaries and their dependencies
+ * to a target directory. The resources can then be used by applications
+ * that depend on apple-kit.
+ *
+ * Usage:
+ *   npx tsx export-resources.ts <target-path>
+ *
+ * Example:
+ *   npx tsx export-resources.ts /path/to/my-app/resources/apple-kit
+ *
+ * Platform support:
+ *   - macOS: Copies binaries from Homebrew installation
+ *   - Windows: Builds from source using MSYS2/MinGW (requires manual setup)
+ */
+
+import { exec } from "node:child_process";
+import {
+    chmodSync,
+    copyFileSync,
+    existsSync,
+    mkdirSync,
+    readFileSync,
+    readlinkSync,
+    writeFileSync,
+} from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+
+// Get the directory of this script
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const execAsync = promisify(exec);
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+// Tools we need to bundle
+const REQUIRED_TOOLS = [
+    "idevice_id",
+    "ideviceinfo",
+    "idevicepair",
+    "idevicename",
+    "idevicedebug",
+    "ideviceinstaller",
+    "iproxy",
+];
+
+// Optional tools (won't fail if not found)
+const OPTIONAL_TOOLS = [
+    "ideviceactivation",
+    "idevicesyslog",
+    "idevicescreenshot",
+    "idevicediagnostics",
+];
+
+// Homebrew paths on macOS
+const HOMEBREW_ARM_PATH = "/opt/homebrew";
+const HOMEBREW_INTEL_PATH = "/usr/local";
+
+// MSYS2 paths on Windows
+const MSYS2_DEFAULT_PATH = "C:\\msys64";
+
+// ============================================================================
+// Utility Functions
+// ============================================================================
+
+function printUsage(): void {
+    console.log(`
+Usage: npx tsx export-resources.ts <target-path>
+
+Arguments:
+  target-path    Directory where resources will be exported
+
+Examples:
+  npx tsx export-resources.ts ./my-app/resources/apple-kit
+  npx tsx export-resources.ts /absolute/path/to/resources
+
+The script will create the following structure:
+  <target-path>/
+    bin/
+      darwin/     (macOS binaries and dylibs)
+      windows/    (Windows binaries and DLLs)
+    licenses/
+      LGPL-2.1.txt
+`);
+}
+
+function resolveSymlink(filePath: string): string {
+    try {
+        const linkTarget = readlinkSync(filePath);
+        if (path.isAbsolute(linkTarget)) {
+            return linkTarget;
+        }
+        return path.resolve(path.dirname(filePath), linkTarget);
+    } catch {
+        return filePath; // Not a symlink
+    }
+}
+
+interface DylibInfo {
+    path: string;
+    name: string;
+}
+
+async function getDylibDependencies(binaryPath: string): Promise<DylibInfo[]> {
+    const dylibs: DylibInfo[] = [];
+
+    try {
+        const { stdout } = await execAsync(`otool -L "${binaryPath}"`);
+        const lines = stdout.split("\n");
+
+        for (const line of lines) {
+            const match = line.match(/^\s+(\S+\.dylib)/);
+            if (match) {
+                const dylibPath = match[1];
+                if (
+                    dylibPath.includes("/opt/homebrew") ||
+                    dylibPath.includes("/usr/local/opt")
+                ) {
+                    dylibs.push({
+                        path: dylibPath,
+                        name: path.basename(dylibPath),
+                    });
+                }
+            }
+        }
+    } catch {
+        console.warn(`Warning: Could not get dependencies for ${binaryPath}`);
+    }
+
+    return dylibs;
+}
+
+async function getAllDylibs(binaries: string[]): Promise<Map<string, string>> {
+    const allDylibs = new Map<string, string>();
+    const processed = new Set<string>();
+
+    async function processBinary(binaryPath: string): Promise<void> {
+        if (processed.has(binaryPath)) return;
+        processed.add(binaryPath);
+
+        const deps = await getDylibDependencies(binaryPath);
+        for (const dep of deps) {
+            if (!allDylibs.has(dep.name)) {
+                allDylibs.set(dep.name, dep.path);
+                await processBinary(dep.path);
+            }
+        }
+    }
+
+    for (const binary of binaries) {
+        await processBinary(binary);
+    }
+
+    return allDylibs;
+}
+
+async function fixDylibPaths(
+    binaryPath: string,
+    dylibs: Map<string, string>
+): Promise<void> {
+    const { stdout } = await execAsync(`otool -L "${binaryPath}"`);
+    const lines = stdout.split("\n");
+
+    for (const [dylibName] of dylibs) {
+        for (const line of lines) {
+            const match = line.match(/^\s+(\S+)/);
+            if (match) {
+                const depPath = match[1];
+                if (
+                    depPath.includes(dylibName) &&
+                    !depPath.startsWith("@loader_path")
+                ) {
+                    try {
+                        await execAsync(
+                            `install_name_tool -change "${depPath}" "@loader_path/${dylibName}" "${binaryPath}"`
+                        );
+                    } catch {
+                        // Ignore errors
+                    }
+                }
+            }
+        }
+    }
+}
+
+async function fixDylibId(dylibPath: string): Promise<void> {
+    const dylibName = path.basename(dylibPath);
+    try {
+        await execAsync(
+            `install_name_tool -id "@loader_path/${dylibName}" "${dylibPath}"`
+        );
+    } catch {
+        console.warn(`Warning: Could not fix dylib id for ${dylibPath}`);
+    }
+}
+
+// ============================================================================
+// macOS Export
+// ============================================================================
+
+function getHomebrewPath(): string | null {
+    if (existsSync(path.join(HOMEBREW_ARM_PATH, "bin", "idevice_id"))) {
+        return HOMEBREW_ARM_PATH;
+    }
+    if (existsSync(path.join(HOMEBREW_INTEL_PATH, "bin", "idevice_id"))) {
+        return HOMEBREW_INTEL_PATH;
+    }
+    return null;
+}
+
+async function exportDarwinResources(targetDir: string): Promise<void> {
+    console.log("\n=== Exporting macOS (Darwin) Resources ===\n");
+
+    const homebrewPath = getHomebrewPath();
+    if (!homebrewPath) {
+        console.error("Error: Homebrew libimobiledevice not found.");
+        console.error(
+            "Please install it first: brew install libimobiledevice ideviceinstaller"
+        );
+        process.exit(1);
+    }
+
+    console.log(`Found Homebrew at: ${homebrewPath}`);
+
+    const darwinBinDir = path.join(targetDir, "bin", "darwin");
+    mkdirSync(darwinBinDir, { recursive: true });
+
+    // Collect all binaries that exist
+    const binaryPaths: string[] = [];
+    const copiedBinaries: string[] = [];
+
+    // Copy required tools
+    for (const tool of REQUIRED_TOOLS) {
+        const toolPath = path.join(homebrewPath, "bin", tool);
+        if (existsSync(toolPath)) {
+            const realPath = resolveSymlink(toolPath);
+            binaryPaths.push(realPath);
+
+            const destPath = path.join(darwinBinDir, tool);
+            copyFileSync(realPath, destPath);
+            chmodSync(destPath, 0o755);
+            copiedBinaries.push(destPath);
+            console.log(`✓ Copied ${tool}`);
+        } else {
+            console.error(`✗ Required tool not found: ${tool}`);
+            console.error(
+                `  Please install: brew install libimobiledevice ideviceinstaller`
+            );
+            process.exit(1);
+        }
+    }
+
+    // Copy optional tools
+    for (const tool of OPTIONAL_TOOLS) {
+        const toolPath = path.join(homebrewPath, "bin", tool);
+        if (existsSync(toolPath)) {
+            const realPath = resolveSymlink(toolPath);
+            binaryPaths.push(realPath);
+
+            const destPath = path.join(darwinBinDir, tool);
+            copyFileSync(realPath, destPath);
+            chmodSync(destPath, 0o755);
+            copiedBinaries.push(destPath);
+            console.log(`✓ Copied ${tool} (optional)`);
+        } else {
+            console.log(`- Skipping ${tool} (optional, not installed)`);
+        }
+    }
+
+    // Get all dylib dependencies
+    console.log("\nCollecting dylib dependencies...");
+    const allDylibs = await getAllDylibs(binaryPaths);
+
+    // Copy dylibs
+    console.log(`\nCopying ${allDylibs.size} dylibs...`);
+    const copiedDylibs: string[] = [];
+
+    for (const [dylibName, dylibPath] of allDylibs) {
+        const realPath = resolveSymlink(dylibPath);
+        const destPath = path.join(darwinBinDir, dylibName);
+
+        if (existsSync(realPath)) {
+            copyFileSync(realPath, destPath);
+            chmodSync(destPath, 0o755);
+            copiedDylibs.push(destPath);
+            console.log(`✓ Copied ${dylibName}`);
+        } else {
+            console.warn(`Warning: Dylib not found: ${realPath}`);
+        }
+    }
+
+    // Fix dylib paths in all binaries and dylibs
+    console.log("\nFixing dylib paths...");
+
+    for (const binaryPath of copiedBinaries) {
+        await fixDylibPaths(binaryPath, allDylibs);
+        console.log(`✓ Fixed paths in ${path.basename(binaryPath)}`);
+    }
+
+    for (const dylibPath of copiedDylibs) {
+        await fixDylibId(dylibPath);
+        await fixDylibPaths(dylibPath, allDylibs);
+        console.log(`✓ Fixed paths in ${path.basename(dylibPath)}`);
+    }
+
+    console.log(`\n✓ macOS resources exported to: ${darwinBinDir}`);
+}
+
+// ============================================================================
+// Windows Export
+// ============================================================================
+
+async function exportWindowsResources(targetDir: string): Promise<void> {
+    console.log("\n=== Exporting Windows Resources ===\n");
+
+    // Check if we're on Windows
+    if (process.platform !== "win32") {
+        console.log("Note: Windows resources can only be built on Windows.");
+        console.log("Generating build script for later use...\n");
+        generateWindowsBuildScript(targetDir);
+        return;
+    }
+
+    // Check for MSYS2
+    const msys2Path = process.env.MSYS2_PATH || MSYS2_DEFAULT_PATH;
+    if (!existsSync(msys2Path)) {
+        console.error(`Error: MSYS2 not found at ${msys2Path}`);
+        console.error("Please install MSYS2 from https://www.msys2.org/");
+        console.error(
+            "Or set MSYS2_PATH environment variable to your MSYS2 installation."
+        );
+        generateWindowsBuildScript(targetDir);
+        return;
+    }
+
+    // Generate the build script
+    generateWindowsBuildScript(targetDir);
+
+    console.log("\nTo build Windows resources:");
+    console.log("1. Open MSYS2 MinGW 64-bit shell");
+    console.log(`2. Run: bash "${path.join(targetDir, "build-windows.sh")}"`);
+}
+
+function generateWindowsBuildScript(targetDir: string): void {
+    const windowsBinDir = path.join(targetDir, "bin", "windows");
+    mkdirSync(windowsBinDir, { recursive: true });
+
+    // Read the template file
+    const templatePath = path.join(__dirname, "build-windows.sh.template");
+    let buildScript = readFileSync(templatePath, "utf-8");
+
+    // Replace the placeholder with the actual target directory
+    buildScript = buildScript.replace(
+        "{{TARGET_DIR}}",
+        windowsBinDir.replace(/\\/g, "/")
+    );
+
+    const scriptPath = path.join(targetDir, "build-windows.sh");
+    writeFileSync(scriptPath, buildScript);
+    console.log(`✓ Generated Windows build script: ${scriptPath}`);
+}
+
+// ============================================================================
+// License File
+// ============================================================================
+
+function createLicenseFile(targetDir: string): void {
+    const licensesDir = path.join(targetDir, "licenses");
+    mkdirSync(licensesDir, { recursive: true });
+
+    const lgplText = `GNU LESSER GENERAL PUBLIC LICENSE
+Version 2.1, February 1999
+
+libimobiledevice and related tools are licensed under the
+GNU Lesser General Public License version 2.1.
+
+For full license text, see:
+https://www.gnu.org/licenses/old-licenses/lgpl-2.1.en.html
+
+These binaries are bundled for convenience. The source code is available at:
+- 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
+`;
+
+    const licensePath = path.join(licensesDir, "LGPL-2.1.txt");
+    writeFileSync(licensePath, lgplText);
+    console.log(`✓ Created license file: ${licensePath}`);
+}
+
+// ============================================================================
+// Main
+// ============================================================================
+
+async function main(): Promise<void> {
+    const args = process.argv.slice(2);
+
+    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+        printUsage();
+        process.exit(args.length === 0 ? 1 : 0);
+    }
+
+    const targetPath = path.resolve(args[0]);
+
+    console.log("=== Apple-kit Resources Export ===");
+    console.log(`Platform: ${process.platform}`);
+    console.log(`Target: ${targetPath}`);
+
+    // Create target directory
+    mkdirSync(targetPath, { recursive: true });
+
+    // Export based on platform
+    if (process.platform === "darwin") {
+        await exportDarwinResources(targetPath);
+    } else if (process.platform === "win32") {
+        await exportWindowsResources(targetPath);
+    } else {
+        console.log("\nNote: This script supports macOS and Windows.");
+        console.log("For Linux, install libimobiledevice-utils via your package manager.");
+    }
+
+    // Always create license file
+    console.log("");
+    createLicenseFile(targetPath);
+
+    console.log("\n=== Export Complete ===");
+    console.log(`Resources exported to: ${targetPath}`);
+}
+
+main().catch((error) => {
+    console.error("Export failed:", error);
+    process.exit(1);
+});
+

package/dist/types/utils/portManager.d.ts

@@ -1,68 +0,0 @@
-/**
- * Port allocation info
- */
-export interface PortAllocation {
-    /** The logical port (USB hub position) */
-    logicalPort: number;
-    /** The allocated local port for forwarding */
-    localPort: number;
-    /** The device port being forwarded to */
-    devicePort: number;
-}
-/**
- * Manages port allocation for device forwarding.
- * Ensures each logical port gets a unique, available local port.
- */
-export declare class PortManager {
-    private allocations;
-    private readonly basePort;
-    private readonly maxPortRange;
-    /**
-     * Create a new PortManager
-     *
-     * @param basePort Starting port number for allocation (default: 30000)
-     * @param maxPortRange Maximum range of ports to search (default: 1000)
-     */
-    constructor(basePort?: number, maxPortRange?: number);
-    /**
-     * Find an available port starting from the given port number
-     */
-    private findAvailablePort;
-    /**
-     * Check if a port is available for binding
-     */
-    private isPortAvailable;
-    /**
-     * Allocate a local port for a logical port
-     *
-     * @param logicalPort The logical port number (USB hub position)
-     * @param devicePort The device port to forward to
-     * @returns The allocated port info
-     */
-    allocate(logicalPort: number, devicePort: number): Promise<PortAllocation>;
-    /**
-     * Release the port allocation for a logical port
-     */
-    release(logicalPort: number): void;
-    /**
-     * Get the current allocation for a logical port
-     */
-    getAllocation(logicalPort: number): PortAllocation | undefined;
-    /**
-     * Get all current allocations
-     */
-    getAllAllocations(): PortAllocation[];
-    /**
-     * Release all allocations
-     */
-    releaseAll(): void;
-    /**
-     * Check if a logical port has an allocation
-     */
-    hasAllocation(logicalPort: number): boolean;
-}
-/**
- * Get the shared port manager instance
- */
-export declare function getSharedPortManager(): PortManager;
-//# sourceMappingURL=portManager.d.ts.map

package/dist/types/utils/portManager.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"portManager.d.ts","sourceRoot":"","sources":["../../../src/utils/portManager.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IAEtC;;;;;OAKG;gBACS,QAAQ,SAAQ,EAAE,YAAY,SAAO;IAKjD;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkBvB;;;;;;OAMG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAgChF;;OAEG;IACH,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAQlC;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI9D;;OAEG;IACH,iBAAiB,IAAI,cAAc,EAAE;IAIrC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;CAG3C;AAOD;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,WAAW,CAKlD"}