appshot-cli 0.7.0 → 0.8.1

package/dist/services/processing-queue.js

@@ -0,0 +1,150 @@
+import { createHash } from 'crypto';
+import fs from 'fs/promises';
+import path from 'path';
+import pc from 'picocolors';
+export class ProcessingQueue {
+    queue = [];
+    processing = false;
+    processed = new Set(); // Track by hash
+    stats = {
+        pending: 0,
+        processed: 0,
+        failed: 0,
+        duplicates: 0
+    };
+    hashCacheFile = '.appshot/processed/hashes.json';
+    processor;
+    constructor(processor) {
+        this.processor = processor;
+        this.loadHashCache();
+    }
+    async add(filepath) {
+        // Check if file exists
+        try {
+            await fs.stat(filepath);
+        }
+        catch {
+            console.warn(pc.yellow(`⚠️  File not found: ${filepath}`));
+            return false;
+        }
+        // Calculate hash
+        const hash = await this.hashFile(filepath);
+        // Check for duplicates
+        if (this.processed.has(hash)) {
+            console.log(pc.dim(`⏭️  Skipping duplicate: ${path.basename(filepath)}`));
+            this.stats.duplicates++;
+            return false;
+        }
+        // Add to queue
+        this.queue.push({
+            filepath,
+            hash,
+            addedAt: new Date(),
+            attempts: 0
+        });
+        this.stats.pending++;
+        // Start processing if not already running
+        if (!this.processing) {
+            this.processNext();
+        }
+        return true;
+    }
+    async processNext() {
+        if (this.queue.length === 0) {
+            this.processing = false;
+            await this.saveHashCache();
+            return;
+        }
+        this.processing = true;
+        const item = this.queue.shift();
+        this.stats.pending--;
+        try {
+            item.attempts++;
+            if (this.processor) {
+                await this.processor(item.filepath);
+            }
+            // Mark as processed
+            if (item.hash) {
+                this.processed.add(item.hash);
+            }
+            this.stats.processed++;
+        }
+        catch (error) {
+            console.error(pc.red(`❌ Failed to process ${path.basename(item.filepath)}:`), error);
+            // Retry logic
+            if (item.attempts < 3) {
+                console.log(pc.yellow(`   Retrying... (attempt ${item.attempts + 1}/3)`));
+                this.queue.push(item);
+                this.stats.pending++;
+            }
+            else {
+                console.error(pc.red('   Giving up after 3 attempts'));
+                this.stats.failed++;
+            }
+        }
+        // Process next item
+        setTimeout(() => this.processNext(), 100);
+    }
+    async hashFile(filepath) {
+        try {
+            const buffer = await fs.readFile(filepath);
+            return createHash('md5').update(buffer).digest('hex');
+        }
+        catch {
+            // If can't read file, use filepath + size + mtime as hash
+            const stat = await fs.stat(filepath);
+            return createHash('md5')
+                .update(`${filepath}-${stat.size}-${stat.mtime.getTime()}`)
+                .digest('hex');
+        }
+    }
+    async isDuplicate(filepath) {
+        const hash = await this.hashFile(filepath);
+        return this.processed.has(hash);
+    }
+    async flush() {
+        // Process all remaining items immediately
+        while (this.queue.length > 0) {
+            await new Promise(resolve => setTimeout(resolve, 50));
+        }
+        // Wait for current processing to complete
+        while (this.processing) {
+            await new Promise(resolve => setTimeout(resolve, 50));
+        }
+        await this.saveHashCache();
+    }
+    async loadHashCache() {
+        try {
+            const content = await fs.readFile(this.hashCacheFile, 'utf8');
+            const hashes = JSON.parse(content);
+            hashes.forEach(hash => this.processed.add(hash));
+        }
+        catch {
+            // File doesn't exist or is invalid, start fresh
+        }
+    }
+    async saveHashCache() {
+        try {
+            const dir = path.dirname(this.hashCacheFile);
+            await fs.mkdir(dir, { recursive: true });
+            // Keep only last 1000 hashes to prevent unbounded growth
+            const hashes = Array.from(this.processed).slice(-1000);
+            await fs.writeFile(this.hashCacheFile, JSON.stringify(hashes, null, 2));
+        }
+        catch (error) {
+            console.warn(pc.yellow('⚠️  Failed to save hash cache:'), error);
+        }
+    }
+    getStats() {
+        return { ...this.stats };
+    }
+    getPendingCount() {
+        return this.queue.length;
+    }
+    clear() {
+        this.queue = [];
+        this.stats.pending = 0;
+        this.processing = false;
+    }
+}
+//# sourceMappingURL=processing-queue.js.map

package/dist/services/processing-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processing-queue.js","sourceRoot":"","sources":["../../src/services/processing-queue.ts"],"names":[],"mappings":"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"}

package/dist/services/screenshot-router.d.ts

@@ -0,0 +1,31 @@
+import { UnifiedDevice, DeviceCategory } from '../types/device.js';
+export interface RoutingOptions {
+    strategy: 'smart' | 'manual' | 'strict';
+    deleteOriginal: boolean;
+    filenamePattern: string;
+    overwrite: boolean;
+}
+export interface RouteResult {
+    sourcePath: string;
+    targetPath: string;
+    category: DeviceCategory;
+    filename: string;
+}
+export declare class ScreenshotRouter {
+    private options;
+    private projectRoot;
+    private fileCounter;
+    constructor(options?: RoutingOptions);
+    routeScreenshot(device: UnifiedDevice, screenshotPath: string, screenName?: string): Promise<RouteResult>;
+    moveScreenshot(result: RouteResult): Promise<void>;
+    routeAndMove(device: UnifiedDevice, screenshotPath: string, screenName?: string): Promise<string>;
+    private getProjectDirectory;
+    private generateFilename;
+    private expandPattern;
+    private generateUniqueFilename;
+    private fileExists;
+    detectCategoryFromDimensions(width: number, height: number): DeviceCategory;
+    setProjectRoot(root: string): Promise<void>;
+}
+export declare const screenshotRouter: ScreenshotRouter;
+//# sourceMappingURL=screenshot-router.d.ts.map

package/dist/services/screenshot-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-router.d.ts","sourceRoot":"","sources":["../../src/services/screenshot-router.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACxC,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAIf,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,WAAW,CAAkC;gBAEjC,OAAO,GAAE,cAK5B;IAEK,eAAe,CACnB,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,CAAC;IA0CjB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBlD,YAAY,CAChB,MAAM,EAAE,aAAa,EACrB,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;YAMJ,mBAAmB;YAoEnB,gBAAgB;IAgC9B,OAAO,CAAC,aAAa;YAeP,sBAAsB;YAetB,UAAU;IASxB,4BAA4B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc;IA+CrE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGlD;AAED,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/services/screenshot-router.js

@@ -0,0 +1,227 @@
+import fs from 'fs/promises';
+import path from 'path';
+import pc from 'picocolors';
+export class ScreenshotRouter {
+    options;
+    projectRoot = null;
+    fileCounter = new Map();
+    constructor(options = {
+        strategy: 'smart',
+        deleteOriginal: false,
+        filenamePattern: '{screen}-{counter}.png',
+        overwrite: false
+    }) {
+        this.options = options;
+    }
+    async routeScreenshot(device, screenshotPath, screenName) {
+        // 1. Determine category
+        const category = device.category;
+        // 2. Find or create project directory
+        const projectDir = await this.getProjectDirectory();
+        // 3. Build target directory path
+        const targetDir = path.join(projectDir, 'screenshots', category);
+        // 4. Ensure directory exists
+        await fs.mkdir(targetDir, { recursive: true });
+        // 5. Generate filename
+        const filename = await this.generateFilename(device, targetDir, screenName);
+        // 6. Build full target path
+        const targetPath = path.join(targetDir, filename);
+        // 7. Check if file exists and handle accordingly
+        if (!this.options.overwrite && await this.fileExists(targetPath)) {
+            const newFilename = await this.generateUniqueFilename(targetDir, filename);
+            const newTargetPath = path.join(targetDir, newFilename);
+            console.log(pc.yellow(`⚠️  File exists, saving as: ${newFilename}`));
+            return {
+                sourcePath: screenshotPath,
+                targetPath: newTargetPath,
+                category,
+                filename: newFilename
+            };
+        }
+        return {
+            sourcePath: screenshotPath,
+            targetPath,
+            category,
+            filename
+        };
+    }
+    async moveScreenshot(result) {
+        try {
+            // Copy file to target
+            await fs.copyFile(result.sourcePath, result.targetPath);
+            console.log(pc.green(`✅ Saved to: ${result.targetPath}`));
+            // Delete original if configured
+            if (this.options.deleteOriginal) {
+                await fs.unlink(result.sourcePath);
+                console.log(pc.dim(`   Removed original: ${result.sourcePath}`));
+            }
+        }
+        catch (error) {
+            console.error(pc.red(`❌ Failed to move screenshot: ${error}`));
+            throw error;
+        }
+    }
+    async routeAndMove(device, screenshotPath, screenName) {
+        const result = await this.routeScreenshot(device, screenshotPath, screenName);
+        await this.moveScreenshot(result);
+        return result.targetPath;
+    }
+    async getProjectDirectory() {
+        if (this.projectRoot) {
+            return this.projectRoot;
+        }
+        // Strategy 1: Look for .appshot directory
+        const cwd = process.cwd();
+        let currentDir = cwd;
+        while (currentDir !== '/') {
+            const appshotDir = path.join(currentDir, '.appshot');
+            try {
+                const stat = await fs.stat(appshotDir);
+                if (stat.isDirectory()) {
+                    this.projectRoot = currentDir;
+                    return currentDir;
+                }
+            }
+            catch {
+                // Directory doesn't exist, continue searching
+            }
+            currentDir = path.dirname(currentDir);
+        }
+        // Strategy 2: Look for package.json or Xcode project
+        currentDir = cwd;
+        while (currentDir !== '/') {
+            const indicators = [
+                'package.json',
+                '*.xcodeproj',
+                '*.xcworkspace',
+                'pubspec.yaml', // Flutter
+                'app.json' // React Native
+            ];
+            for (const indicator of indicators) {
+                try {
+                    if (indicator.includes('*')) {
+                        // Handle glob patterns
+                        const files = await fs.readdir(currentDir);
+                        const pattern = indicator.replace('*', '');
+                        if (files.some(f => f.endsWith(pattern))) {
+                            this.projectRoot = currentDir;
+                            return currentDir;
+                        }
+                    }
+                    else {
+                        // Check for specific file
+                        await fs.stat(path.join(currentDir, indicator));
+                        this.projectRoot = currentDir;
+                        return currentDir;
+                    }
+                }
+                catch {
+                    // File doesn't exist
+                }
+            }
+            currentDir = path.dirname(currentDir);
+        }
+        // Strategy 3: Use current working directory
+        console.log(pc.yellow('⚠️  No project detected, using current directory'));
+        this.projectRoot = cwd;
+        return cwd;
+    }
+    async generateFilename(device, targetDir, screenName) {
+        const pattern = this.options.filenamePattern;
+        // Get or initialize counter for this directory
+        const counterKey = targetDir;
+        let counter = this.fileCounter.get(counterKey) || 1;
+        // Find next available counter
+        while (true) {
+            const filename = this.expandPattern(pattern, {
+                screen: screenName || 'screenshot',
+                counter: counter.toString().padStart(3, '0'),
+                device: device.name.replace(/[^a-zA-Z0-9]/g, '-'),
+                category: device.category,
+                timestamp: new Date().toISOString().replace(/[:.]/g, '-')
+            });
+            const fullPath = path.join(targetDir, filename);
+            if (!await this.fileExists(fullPath) || this.options.overwrite) {
+                this.fileCounter.set(counterKey, counter + 1);
+                return filename;
+            }
+            counter++;
+        }
+    }
+    expandPattern(pattern, values) {
+        let result = pattern;
+        for (const [key, value] of Object.entries(values)) {
+            result = result.replace(`{${key}}`, value);
+        }
+        // Ensure .png extension
+        if (!result.endsWith('.png')) {
+            result += '.png';
+        }
+        return result;
+    }
+    async generateUniqueFilename(directory, baseFilename) {
+        const ext = path.extname(baseFilename);
+        const base = path.basename(baseFilename, ext);
+        let counter = 1;
+        let newFilename;
+        do {
+            newFilename = `${base}-${counter}${ext}`;
+            counter++;
+        } while (await this.fileExists(path.join(directory, newFilename)));
+        return newFilename;
+    }
+    async fileExists(filePath) {
+        try {
+            await fs.stat(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    detectCategoryFromDimensions(width, height) {
+        // Portrait orientation
+        if (height > width) {
+            // iPhone dimensions
+            if (width >= 750 && width <= 1320 && height >= 1334 && height <= 2868) {
+                return 'iphone';
+            }
+            // iPad dimensions
+            if (width >= 1488 && width <= 2064 && height >= 2266 && height <= 2752) {
+                return 'ipad';
+            }
+            // Watch dimensions
+            if (width >= 352 && width <= 410 && height >= 430 && height <= 502) {
+                return 'watch';
+            }
+        }
+        else {
+            // Landscape orientation - swap width/height checks
+            if (height >= 750 && height <= 1320 && width >= 1334 && width <= 2868) {
+                return 'iphone';
+            }
+            if (height >= 1488 && height <= 2064 && width >= 2266 && width <= 2752) {
+                return 'ipad';
+            }
+        }
+        // Mac dimensions (16:10 aspect ratio)
+        if (width >= 2560 && height >= 1600) {
+            return 'mac';
+        }
+        // Vision Pro
+        if (width === 3840 && height === 2160) {
+            return 'vision';
+        }
+        // Apple TV
+        if ((width === 1920 && height === 1080) || (width === 3840 && height === 2160)) {
+            return 'tv';
+        }
+        // Default to iPhone if unclear
+        return 'iphone';
+    }
+    async setProjectRoot(root) {
+        this.projectRoot = root;
+    }
+}
+export const screenshotRouter = new ScreenshotRouter();
+//# sourceMappingURL=screenshot-router.js.map

package/dist/services/screenshot-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-router.js","sourceRoot":"","sources":["../../src/services/screenshot-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,YAAY,CAAC;AAiB5B,MAAM,OAAO,gBAAgB;IAIP;IAHZ,WAAW,GAAkB,IAAI,CAAC;IAClC,WAAW,GAAwB,IAAI,GAAG,EAAE,CAAC;IAErD,YAAoB,UAA0B;QAC5C,QAAQ,EAAE,OAAO;QACjB,cAAc,EAAE,KAAK;QACrB,eAAe,EAAE,wBAAwB;QACzC,SAAS,EAAE,KAAK;KACjB;QALmB,YAAO,GAAP,OAAO,CAK1B;IAAG,CAAC;IAEL,KAAK,CAAC,eAAe,CACnB,MAAqB,EACrB,cAAsB,EACtB,UAAmB;QAEnB,wBAAwB;QACxB,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAEjC,sCAAsC;QACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAEpD,iCAAiC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAEjE,6BAA6B;QAC7B,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,uBAAuB;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAE5E,4BAA4B;QAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAElD,iDAAiD;QACjD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACjE,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC3E,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAExD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,+BAA+B,WAAW,EAAE,CAAC,CAAC,CAAC;YAErE,OAAO;gBACL,UAAU,EAAE,cAAc;gBAC1B,UAAU,EAAE,aAAa;gBACzB,QAAQ;gBACR,QAAQ,EAAE,WAAW;aACtB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,UAAU,EAAE,cAAc;YAC1B,UAAU;YACV,QAAQ;YACR,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAmB;QACtC,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;YAExD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YAE1D,gCAAgC;YAChC,IAAI,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAChC,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,MAAqB,EACrB,cAAsB,EACtB,UAAmB;QAEnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,UAAU,CAAC,CAAC;QAC9E,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,0CAA0C;QAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC1B,IAAI,UAAU,GAAG,GAAG,CAAC;QAErB,OAAO,UAAU,KAAK,GAAG,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAErD,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBACvC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;oBAC9B,OAAO,UAAU,CAAC;gBACpB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;YAED,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAED,qDAAqD;QACrD,UAAU,GAAG,GAAG,CAAC;QAEjB,OAAO,UAAU,KAAK,GAAG,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG;gBACjB,cAAc;gBACd,aAAa;gBACb,eAAe;gBACf,cAAc,EAAG,UAAU;gBAC3B,UAAU,CAAO,eAAe;aACjC,CAAC;YAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC;oBACH,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC5B,uBAAuB;wBACvB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;wBAC3C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;wBAE3C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;4BACzC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;4BAC9B,OAAO,UAAU,CAAC;wBACpB,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,0BAA0B;wBAC1B,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;wBAChD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;wBAC9B,OAAO,UAAU,CAAC;oBACpB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,qBAAqB;gBACvB,CAAC;YACH,CAAC;YAED,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,CAAC;QAED,4CAA4C;QAC5C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,kDAAkD,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,MAAqB,EACrB,SAAiB,EACjB,UAAmB;QAEnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC;QAE7C,+CAA+C;QAC/C,MAAM,UAAU,GAAG,SAAS,CAAC;QAC7B,IAAI,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAEpD,8BAA8B;QAC9B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;gBAC3C,MAAM,EAAE,UAAU,IAAI,YAAY;gBAClC,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC5C,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC;gBACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aAC1D,CAAC,CAAC;YAEH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAEhD,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;gBAC/D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBAC9C,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAe,EAAE,MAA8B;QACnE,IAAI,MAAM,GAAG,OAAO,CAAC;QAErB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,wBAAwB;QACxB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,MAAM,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,sBAAsB,CAAC,SAAiB,EAAE,YAAoB;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAE9C,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,WAAmB,CAAC;QAExB,GAAG,CAAC;YACF,WAAW,GAAG,GAAG,IAAI,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;YACzC,OAAO,EAAE,CAAC;QACZ,CAAC,QAAQ,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,EAAE;QAEnE,OAAO,WAAW,CAAC;IACrB,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,QAAgB;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,4BAA4B,CAAC,KAAa,EAAE,MAAc;QACxD,uBAAuB;QACvB,IAAI,MAAM,GAAG,KAAK,EAAE,CAAC;YACnB,oBAAoB;YACpB,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACtE,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,kBAAkB;YAClB,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;gBACvE,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,mBAAmB;YACnB,IAAI,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBACnE,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mDAAmD;YACnD,IAAI,MAAM,IAAI,GAAG,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBACtE,OAAO,QAAQ,CAAC;YAClB,CAAC;YAED,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;gBACvE,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,KAAK,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACpC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,aAAa;QACb,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACtC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,WAAW;QACX,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+BAA+B;QAC/B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/services/system-requirements.d.ts

@@ -0,0 +1,26 @@
+export interface SystemCheck {
+    success: boolean;
+    error?: string;
+    fix?: string;
+    checks?: {
+        xcrun: boolean;
+        simctl: boolean;
+        devicectl: boolean;
+        xcodebuild: boolean;
+        xcodeVersion: string | null;
+        commandLineTools: boolean;
+    };
+}
+export interface OptionalTools {
+    libimobiledevice: boolean;
+    iosDeploy: boolean;
+}
+export declare class SystemRequirements {
+    private isMacOS;
+    checkXcodeTools(): Promise<SystemCheck>;
+    checkOptionalTools(): Promise<OptionalTools>;
+    printDiagnostics(): Promise<void>;
+    ensureRequirements(): Promise<boolean>;
+}
+export declare const systemRequirements: SystemRequirements;
+//# sourceMappingURL=system-requirements.d.ts.map

package/dist/services/system-requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-requirements.d.ts","sourceRoot":"","sources":["../../src/services/system-requirements.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC;QACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA2B;IAEpC,eAAe,IAAI,OAAO,CAAC,WAAW,CAAC;IAwGvC,kBAAkB,IAAI,OAAO,CAAC,aAAa,CAAC;IA8B5C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;CA4B7C;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/services/system-requirements.js

@@ -0,0 +1,189 @@
+import { exec as execCallback } from 'child_process';
+import { promisify } from 'util';
+import { platform } from 'os';
+import pc from 'picocolors';
+const exec = promisify(execCallback);
+export class SystemRequirements {
+    isMacOS = platform() === 'darwin';
+    async checkXcodeTools() {
+        // Only available on macOS
+        if (!this.isMacOS) {
+            return {
+                success: false,
+                error: 'Device features are only available on macOS',
+                fix: 'Use a Mac to capture screenshots from iOS devices and simulators'
+            };
+        }
+        const checks = {
+            xcrun: false,
+            simctl: false,
+            devicectl: false,
+            xcodebuild: false,
+            xcodeVersion: null,
+            commandLineTools: false
+        };
+        // Check for Xcode Command Line Tools
+        try {
+            const { stdout } = await exec('xcode-select -p');
+            if (stdout.trim()) {
+                checks.commandLineTools = true;
+            }
+        }
+        catch {
+            return {
+                success: false,
+                error: 'Xcode Command Line Tools not installed',
+                fix: 'Run: xcode-select --install'
+            };
+        }
+        // Check for xcrun
+        try {
+            await exec('xcrun --version');
+            checks.xcrun = true;
+        }
+        catch {
+            return {
+                success: false,
+                error: 'xcrun not available',
+                fix: 'Ensure Xcode or Command Line Tools are properly installed'
+            };
+        }
+        // Check for simctl (simulator control)
+        try {
+            await exec('xcrun simctl help');
+            checks.simctl = true;
+        }
+        catch {
+            return {
+                success: false,
+                error: 'simctl not available - simulator features will not work',
+                fix: 'Install Xcode from the Mac App Store for full simulator support'
+            };
+        }
+        // Check for devicectl (physical device control, Xcode 15+)
+        try {
+            await exec('xcrun devicectl --version 2>/dev/null');
+            checks.devicectl = true;
+        }
+        catch {
+            // Not fatal - can fallback to libimobiledevice
+            console.warn(pc.yellow('⚠️  devicectl not available (requires Xcode 15+)'));
+            console.warn(pc.dim('   Physical device support may be limited'));
+        }
+        // Check for xcodebuild
+        try {
+            await exec('xcodebuild -version');
+            checks.xcodebuild = true;
+        }
+        catch {
+            // Not fatal but limits functionality
+            console.warn(pc.yellow('⚠️  xcodebuild not available'));
+        }
+        // Check Xcode version if available
+        if (checks.xcodebuild) {
+            try {
+                const { stdout } = await exec('xcodebuild -version');
+                const match = stdout.match(/Xcode (\d+\.\d+)/);
+                if (match) {
+                    checks.xcodeVersion = match[1];
+                    const version = parseFloat(match[1]);
+                    if (version < 14.0) {
+                        return {
+                            success: false,
+                            error: `Xcode ${checks.xcodeVersion} is too old`,
+                            fix: 'Update to Xcode 14.0 or later from the Mac App Store'
+                        };
+                    }
+                }
+            }
+            catch {
+                // Ignore version check errors
+            }
+        }
+        return {
+            success: true,
+            checks
+        };
+    }
+    async checkOptionalTools() {
+        const tools = {
+            libimobiledevice: false,
+            iosDeploy: false
+        };
+        // Only check on macOS
+        if (!this.isMacOS) {
+            return tools;
+        }
+        // Check for libimobiledevice (alternative for physical devices)
+        try {
+            await exec('which idevicescreenshot');
+            tools.libimobiledevice = true;
+        }
+        catch {
+            // Tool not installed - this is optional
+        }
+        // Check for ios-deploy
+        try {
+            await exec('which ios-deploy');
+            tools.iosDeploy = true;
+        }
+        catch {
+            // Tool not installed - this is optional
+        }
+        return tools;
+    }
+    async printDiagnostics() {
+        console.log(pc.bold('\n📱 Xcode Tools Check:\n'));
+        const xcodeCheck = await this.checkXcodeTools();
+        if (xcodeCheck.success && xcodeCheck.checks) {
+            console.log('  ' + (xcodeCheck.checks.commandLineTools ? pc.green('✅') : pc.red('❌')) + ' Xcode Command Line Tools');
+            console.log('  ' + (xcodeCheck.checks.xcrun ? pc.green('✅') : pc.red('❌')) + ' xcrun');
+            console.log('  ' + (xcodeCheck.checks.simctl ? pc.green('✅') : pc.red('❌')) + ' simctl (simulator control)');
+            console.log('  ' + (xcodeCheck.checks.devicectl ? pc.green('✅') : pc.yellow('⚠️')) + ' devicectl (physical devices, Xcode 15+)');
+            console.log('  ' + (xcodeCheck.checks.xcodebuild ? pc.green('✅') : pc.yellow('⚠️')) + ' xcodebuild');
+            if (xcodeCheck.checks.xcodeVersion) {
+                console.log(`  ${pc.green('✅')} Xcode version: ${xcodeCheck.checks.xcodeVersion}`);
+            }
+        }
+        else {
+            console.log(pc.red(`  ❌ ${xcodeCheck.error}`));
+            console.log(pc.cyan(`     Fix: ${xcodeCheck.fix}`));
+        }
+        console.log(pc.bold('\n📦 Optional Tools:\n'));
+        const optional = await this.checkOptionalTools();
+        console.log('  ' + (optional.libimobiledevice ? pc.green('✅') : pc.yellow('⚠️')) + ' libimobiledevice');
+        if (!optional.libimobiledevice) {
+            console.log(pc.dim('     Install: brew install libimobiledevice'));
+            console.log(pc.dim('     Provides: idevicescreenshot for physical devices'));
+        }
+        console.log('  ' + (optional.iosDeploy ? pc.green('✅') : pc.yellow('⚠️')) + ' ios-deploy');
+        if (!optional.iosDeploy) {
+            console.log(pc.dim('     Install: npm install -g ios-deploy'));
+            console.log(pc.dim('     Provides: App deployment to physical devices'));
+        }
+    }
+    async ensureRequirements() {
+        const check = await this.checkXcodeTools();
+        if (!check.success) {
+            console.error(pc.red('\n❌ System requirements not met'));
+            console.error(pc.yellow(`\nError: ${check.error}`));
+            console.error(pc.cyan(`\nHow to fix:\n  ${check.fix}`));
+            if (check.error?.includes('Command Line Tools')) {
+                console.error(pc.dim('\nAfter installation, you may need to:'));
+                console.error(pc.dim('  1. Restart your terminal'));
+                console.error(pc.dim('  2. Accept the license: sudo xcodebuild -license accept'));
+            }
+            return false;
+        }
+        // Check for optional tools and provide helpful messages
+        const optional = await this.checkOptionalTools();
+        if (!optional.libimobiledevice && (!check.checks?.devicectl)) {
+            console.warn(pc.yellow('\n⚠️  Limited physical device support'));
+            console.warn(pc.dim('   For physical device screenshots, install:'));
+            console.warn(pc.cyan('   brew install libimobiledevice'));
+        }
+        return true;
+    }
+}
+export const systemRequirements = new SystemRequirements();
+//# sourceMappingURL=system-requirements.js.map