@limrun/api 0.33.2 → 0.33.3

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.33.3 (2026-06-23)
+
+Full Changelog: [v0.33.2...v0.33.3](https://github.com/limrun-inc/typescript-sdk/compare/v0.33.2...v0.33.3)
+
 ## 0.33.2 (2026-06-21)
 
 Full Changelog: [v0.33.1...v0.33.2](https://github.com/limrun-inc/typescript-sdk/compare/v0.33.1...v0.33.2)

package/app-archive.d.mts

@@ -0,0 +1,19 @@
+type LogFn = (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+export type PreparedAppBundle = {
+    appPath: string;
+    cacheIdentityPath: string;
+    isArchive: boolean;
+    archivePath?: string;
+};
+export type ArchiveWatcher = {
+    close: () => void;
+};
+export declare function extractAppArchiveToStablePath(archivePath: string): Promise<PreparedAppBundle>;
+export declare function prepareAppBundlePath(inputPath: string): Promise<PreparedAppBundle>;
+export declare function watchAppArchive(opts: {
+    archivePath: string;
+    log?: LogFn;
+    onExtracted?: () => void | Promise<void>;
+}): ArchiveWatcher;
+export {};
+//# sourceMappingURL=app-archive.d.mts.map

package/app-archive.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-archive.d.mts","sourceRoot":"","sources":["src/app-archive.ts"],"names":[],"mappings":"AAOA,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAkKF,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgDnG;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAcxF;AA4BD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,GAAG,cAAc,CAoEjB"}

package/app-archive.d.ts

@@ -0,0 +1,19 @@
+type LogFn = (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+export type PreparedAppBundle = {
+    appPath: string;
+    cacheIdentityPath: string;
+    isArchive: boolean;
+    archivePath?: string;
+};
+export type ArchiveWatcher = {
+    close: () => void;
+};
+export declare function extractAppArchiveToStablePath(archivePath: string): Promise<PreparedAppBundle>;
+export declare function prepareAppBundlePath(inputPath: string): Promise<PreparedAppBundle>;
+export declare function watchAppArchive(opts: {
+    archivePath: string;
+    log?: LogFn;
+    onExtracted?: () => void | Promise<void>;
+}): ArchiveWatcher;
+export {};
+//# sourceMappingURL=app-archive.d.ts.map

package/app-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-archive.d.ts","sourceRoot":"","sources":["src/app-archive.ts"],"names":[],"mappings":"AAOA,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAkKF,wBAAsB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgDnG;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAcxF;AA4BD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,GAAG,cAAc,CAoEjB"}

package/app-archive.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractAppArchiveToStablePath = extractAppArchiveToStablePath;
+exports.prepareAppBundlePath = prepareAppBundlePath;
+exports.watchAppArchive = watchAppArchive;
+const tslib_1 = require("./internal/tslib.js");
+const crypto_1 = tslib_1.__importDefault(require("crypto"));
+const fs_1 = tslib_1.__importDefault(require("fs"));
+const os_1 = tslib_1.__importDefault(require("os"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const promises_1 = require("stream/promises");
+const yauzl = tslib_1.__importStar(require("yauzl"));
+const noopLogger = () => { };
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function stableArchiveRoot(archivePath) {
+    const resolved = path_1.default.resolve(archivePath);
+    const hash = crypto_1.default.createHash('sha1').update(resolved).digest('hex').slice(0, 12);
+    const base = path_1.default
+        .basename(resolved, path_1.default.extname(resolved))
+        .replace(/[^A-Za-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const safeBase = base === '' ? 'app' : base;
+    return path_1.default.join(os_1.default.tmpdir(), `limrun-sync-app-${safeBase}-${hash}`);
+}
+function stableAppPath(archivePath) {
+    return path_1.default.join(stableArchiveRoot(archivePath), 'Extracted.app');
+}
+function toZipPath(name) {
+    return name.replace(/\\/g, '/');
+}
+function isUnsafeZipPath(name) {
+    if (name.includes('\0'))
+        return true;
+    if (path_1.default.posix.isAbsolute(name))
+        return true;
+    return name.split('/').some((part) => part === '..');
+}
+function entryMode(entry) {
+    return (entry.externalFileAttributes >>> 16) & 0xffff;
+}
+function isSymlinkEntry(entry) {
+    return (entryMode(entry) & 0o170000) === 0o120000;
+}
+function isDirectoryEntry(entry) {
+    return entry.fileName.endsWith('/');
+}
+function entryPerm(entry, fallback) {
+    return entryMode(entry) & 0o7777 || fallback;
+}
+async function openZip(archivePath) {
+    try {
+        return await yauzl.openPromise(archivePath, {
+            autoClose: false,
+            lazyEntries: true,
+            strictFileNames: true,
+            validateEntrySizes: true,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? `: ${err.message}` : '';
+        throw new Error(`The path is not a valid app bundle directory or ZIP/IPA archive: ${archivePath}${message}`);
+    }
+}
+async function readEntries(zip) {
+    const entries = [];
+    for await (const entry of zip.eachEntry()) {
+        entries.push(entry);
+    }
+    return entries;
+}
+async function ensureDirectoryNotSymlink(dir) {
+    const stat = await fs_1.default.promises.lstat(dir).catch((err) => {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    });
+    if (stat && (!stat.isDirectory() || stat.isSymbolicLink())) {
+        await fs_1.default.promises.rm(dir, { recursive: true, force: true });
+    }
+    await fs_1.default.promises.mkdir(dir, { recursive: true });
+}
+function discoverPayloadApp(entries, archivePath) {
+    const appNames = new Set();
+    const appsWithInfoPlist = new Set();
+    for (const entry of entries) {
+        const name = toZipPath(entry.fileName);
+        if (isUnsafeZipPath(name)) {
+            throw new Error(`ZIP entry has an unsafe path: ${entry.fileName}`);
+        }
+        if (isDirectoryEntry(entry)) {
+            continue;
+        }
+        const rest = name.startsWith('Payload/') ? name.slice('Payload/'.length) : '';
+        if (rest === '') {
+            continue;
+        }
+        const [appName, ...parts] = rest.split('/');
+        if (!appName?.endsWith('.app')) {
+            continue;
+        }
+        appNames.add(appName);
+        if (parts.join('/') === 'Info.plist') {
+            appsWithInfoPlist.add(appName);
+        }
+    }
+    if (appNames.size === 0) {
+        throw new Error(`ZIP/IPA archive contains no Payload/*.app bundle: ${archivePath}`);
+    }
+    if (appNames.size > 1) {
+        throw new Error(`ZIP/IPA archive contains more than one Payload/*.app bundle (${[...appNames].join(', ')}); expected exactly one`);
+    }
+    const appName = [...appNames][0];
+    if (!appsWithInfoPlist.has(appName)) {
+        throw new Error(`ZIP/IPA archive app bundle is missing Info.plist: Payload/${appName}/Info.plist`);
+    }
+    return appName;
+}
+async function extractEntry(zip, entry, target, appRoot) {
+    if (isDirectoryEntry(entry)) {
+        await fs_1.default.promises.mkdir(target, { recursive: true, mode: entryPerm(entry, 0o755) });
+        return;
+    }
+    await fs_1.default.promises.mkdir(path_1.default.dirname(target), { recursive: true });
+    if (isSymlinkEntry(entry)) {
+        const stream = await zip.openReadStreamPromise(entry);
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        const linkTarget = Buffer.concat(chunks).toString('utf8');
+        const resolved = path_1.default.resolve(path_1.default.dirname(target), linkTarget);
+        const appRootResolved = path_1.default.resolve(appRoot);
+        if (resolved !== appRootResolved && !resolved.startsWith(appRootResolved + path_1.default.sep)) {
+            throw new Error(`ZIP/IPA symlink escapes app bundle: ${entry.fileName} -> ${linkTarget}`);
+        }
+        await fs_1.default.promises.rm(target, { force: true });
+        await fs_1.default.promises.symlink(linkTarget, target);
+        return;
+    }
+    const stream = await zip.openReadStreamPromise(entry);
+    await (0, promises_1.pipeline)(stream, fs_1.default.createWriteStream(target, { mode: entryPerm(entry, 0o644) }));
+    await fs_1.default.promises.chmod(target, entryPerm(entry, 0o644));
+}
+async function extractAppArchiveToStablePath(archivePath) {
+    const resolvedArchivePath = path_1.default.resolve(archivePath);
+    const appPath = stableAppPath(resolvedArchivePath);
+    const stableRoot = path_1.default.dirname(appPath);
+    await ensureDirectoryNotSymlink(stableRoot);
+    const zip = await openZip(resolvedArchivePath);
+    try {
+        const entries = await readEntries(zip);
+        const appName = discoverPayloadApp(entries, resolvedArchivePath);
+        const payloadPrefix = `Payload/${appName}/`;
+        await fs_1.default.promises.rm(appPath, { recursive: true, force: true });
+        await ensureDirectoryNotSymlink(appPath);
+        for (const entry of entries) {
+            const name = toZipPath(entry.fileName);
+            if (name !== `Payload/${appName}` && !name.startsWith(payloadPrefix)) {
+                continue;
+            }
+            const rel = name === `Payload/${appName}` ? '' : name.slice(payloadPrefix.length);
+            if (rel === '') {
+                await fs_1.default.promises.mkdir(appPath, { recursive: true });
+                continue;
+            }
+            if (isUnsafeZipPath(rel)) {
+                throw new Error(`ZIP entry has an unsafe app-relative path: ${entry.fileName}`);
+            }
+            const target = path_1.default.join(appPath, rel.split('/').join(path_1.default.sep));
+            const stagingAppResolved = path_1.default.resolve(appPath);
+            const targetResolved = path_1.default.resolve(target);
+            if (targetResolved !== stagingAppResolved &&
+                !targetResolved.startsWith(stagingAppResolved + path_1.default.sep)) {
+                throw new Error(`ZIP entry escapes app bundle: ${entry.fileName}`);
+            }
+            await extractEntry(zip, entry, target, appPath);
+        }
+        return {
+            appPath,
+            cacheIdentityPath: resolvedArchivePath,
+            isArchive: true,
+            archivePath: resolvedArchivePath,
+        };
+    }
+    finally {
+        zip.close();
+    }
+}
+async function prepareAppBundlePath(inputPath) {
+    const resolvedPath = path_1.default.resolve(inputPath);
+    const stat = await fs_1.default.promises.stat(resolvedPath);
+    if (stat.isDirectory()) {
+        return {
+            appPath: resolvedPath,
+            cacheIdentityPath: resolvedPath,
+            isArchive: false,
+        };
+    }
+    if (!stat.isFile()) {
+        throw new Error(`The path is neither an app bundle directory nor a ZIP/IPA archive: ${inputPath}`);
+    }
+    return await extractAppArchiveToStablePath(resolvedPath);
+}
+async function waitForStableArchiveFile(archivePath, shouldStop) {
+    const deadline = Date.now() + 10000;
+    let previous;
+    while (!shouldStop() && Date.now() < deadline) {
+        const stat = await fs_1.default.promises.stat(archivePath).catch((err) => {
+            if (err.code === 'ENOENT')
+                return null;
+            throw err;
+        });
+        if (stat?.isFile()) {
+            const current = { size: stat.size, mtimeMs: stat.mtimeMs };
+            if (previous && previous.size === current.size && previous.mtimeMs === current.mtimeMs) {
+                return true;
+            }
+            previous = current;
+        }
+        else {
+            previous = undefined;
+        }
+        await sleep(100);
+    }
+    return false;
+}
+function watchAppArchive(opts) {
+    const archivePath = path_1.default.resolve(opts.archivePath);
+    const log = opts.log ?? noopLogger;
+    const parentDir = path_1.default.dirname(archivePath);
+    const archiveBase = path_1.default.basename(archivePath);
+    let timer;
+    let inFlight = false;
+    let queued = false;
+    let closed = false;
+    const run = async () => {
+        if (closed)
+            return;
+        if (inFlight) {
+            queued = true;
+            return;
+        }
+        inFlight = true;
+        try {
+            const ready = await waitForStableArchiveFile(archivePath, () => closed);
+            if (!ready) {
+                if (!closed) {
+                    log('warn', `ZIP/IPA archive did not become readable after change: ${archivePath}`);
+                }
+                return;
+            }
+            await extractAppArchiveToStablePath(archivePath);
+            log('debug', `re-extracted ZIP/IPA archive: ${archivePath}`);
+            await opts.onExtracted?.();
+        }
+        catch (err) {
+            log('error', `failed to re-extract ZIP/IPA archive ${archivePath}: ${err instanceof Error ? err.message : err}`);
+        }
+        finally {
+            inFlight = false;
+            if (queued) {
+                queued = false;
+                void run();
+            }
+        }
+    };
+    const schedule = () => {
+        if (closed)
+            return;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            void run();
+        }, 500);
+    };
+    const watcher = fs_1.default.watch(parentDir, (_eventType, filename) => {
+        if (filename?.toString() === archiveBase) {
+            schedule();
+        }
+    });
+    log('debug', `watchAppArchive: ${archivePath}`);
+    return {
+        close: () => {
+            closed = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            watcher.close();
+        },
+    };
+}
+//# sourceMappingURL=app-archive.js.map

package/app-archive.js.map

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

package/app-archive.mjs

@@ -0,0 +1,290 @@
+import crypto from 'crypto';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { pipeline } from 'stream/promises';
+import * as yauzl from 'yauzl';
+const noopLogger = () => { };
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function stableArchiveRoot(archivePath) {
+    const resolved = path.resolve(archivePath);
+    const hash = crypto.createHash('sha1').update(resolved).digest('hex').slice(0, 12);
+    const base = path
+        .basename(resolved, path.extname(resolved))
+        .replace(/[^A-Za-z0-9._-]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    const safeBase = base === '' ? 'app' : base;
+    return path.join(os.tmpdir(), `limrun-sync-app-${safeBase}-${hash}`);
+}
+function stableAppPath(archivePath) {
+    return path.join(stableArchiveRoot(archivePath), 'Extracted.app');
+}
+function toZipPath(name) {
+    return name.replace(/\\/g, '/');
+}
+function isUnsafeZipPath(name) {
+    if (name.includes('\0'))
+        return true;
+    if (path.posix.isAbsolute(name))
+        return true;
+    return name.split('/').some((part) => part === '..');
+}
+function entryMode(entry) {
+    return (entry.externalFileAttributes >>> 16) & 0xffff;
+}
+function isSymlinkEntry(entry) {
+    return (entryMode(entry) & 0o170000) === 0o120000;
+}
+function isDirectoryEntry(entry) {
+    return entry.fileName.endsWith('/');
+}
+function entryPerm(entry, fallback) {
+    return entryMode(entry) & 0o7777 || fallback;
+}
+async function openZip(archivePath) {
+    try {
+        return await yauzl.openPromise(archivePath, {
+            autoClose: false,
+            lazyEntries: true,
+            strictFileNames: true,
+            validateEntrySizes: true,
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? `: ${err.message}` : '';
+        throw new Error(`The path is not a valid app bundle directory or ZIP/IPA archive: ${archivePath}${message}`);
+    }
+}
+async function readEntries(zip) {
+    const entries = [];
+    for await (const entry of zip.eachEntry()) {
+        entries.push(entry);
+    }
+    return entries;
+}
+async function ensureDirectoryNotSymlink(dir) {
+    const stat = await fs.promises.lstat(dir).catch((err) => {
+        if (err.code === 'ENOENT')
+            return null;
+        throw err;
+    });
+    if (stat && (!stat.isDirectory() || stat.isSymbolicLink())) {
+        await fs.promises.rm(dir, { recursive: true, force: true });
+    }
+    await fs.promises.mkdir(dir, { recursive: true });
+}
+function discoverPayloadApp(entries, archivePath) {
+    const appNames = new Set();
+    const appsWithInfoPlist = new Set();
+    for (const entry of entries) {
+        const name = toZipPath(entry.fileName);
+        if (isUnsafeZipPath(name)) {
+            throw new Error(`ZIP entry has an unsafe path: ${entry.fileName}`);
+        }
+        if (isDirectoryEntry(entry)) {
+            continue;
+        }
+        const rest = name.startsWith('Payload/') ? name.slice('Payload/'.length) : '';
+        if (rest === '') {
+            continue;
+        }
+        const [appName, ...parts] = rest.split('/');
+        if (!appName?.endsWith('.app')) {
+            continue;
+        }
+        appNames.add(appName);
+        if (parts.join('/') === 'Info.plist') {
+            appsWithInfoPlist.add(appName);
+        }
+    }
+    if (appNames.size === 0) {
+        throw new Error(`ZIP/IPA archive contains no Payload/*.app bundle: ${archivePath}`);
+    }
+    if (appNames.size > 1) {
+        throw new Error(`ZIP/IPA archive contains more than one Payload/*.app bundle (${[...appNames].join(', ')}); expected exactly one`);
+    }
+    const appName = [...appNames][0];
+    if (!appsWithInfoPlist.has(appName)) {
+        throw new Error(`ZIP/IPA archive app bundle is missing Info.plist: Payload/${appName}/Info.plist`);
+    }
+    return appName;
+}
+async function extractEntry(zip, entry, target, appRoot) {
+    if (isDirectoryEntry(entry)) {
+        await fs.promises.mkdir(target, { recursive: true, mode: entryPerm(entry, 0o755) });
+        return;
+    }
+    await fs.promises.mkdir(path.dirname(target), { recursive: true });
+    if (isSymlinkEntry(entry)) {
+        const stream = await zip.openReadStreamPromise(entry);
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        }
+        const linkTarget = Buffer.concat(chunks).toString('utf8');
+        const resolved = path.resolve(path.dirname(target), linkTarget);
+        const appRootResolved = path.resolve(appRoot);
+        if (resolved !== appRootResolved && !resolved.startsWith(appRootResolved + path.sep)) {
+            throw new Error(`ZIP/IPA symlink escapes app bundle: ${entry.fileName} -> ${linkTarget}`);
+        }
+        await fs.promises.rm(target, { force: true });
+        await fs.promises.symlink(linkTarget, target);
+        return;
+    }
+    const stream = await zip.openReadStreamPromise(entry);
+    await pipeline(stream, fs.createWriteStream(target, { mode: entryPerm(entry, 0o644) }));
+    await fs.promises.chmod(target, entryPerm(entry, 0o644));
+}
+export async function extractAppArchiveToStablePath(archivePath) {
+    const resolvedArchivePath = path.resolve(archivePath);
+    const appPath = stableAppPath(resolvedArchivePath);
+    const stableRoot = path.dirname(appPath);
+    await ensureDirectoryNotSymlink(stableRoot);
+    const zip = await openZip(resolvedArchivePath);
+    try {
+        const entries = await readEntries(zip);
+        const appName = discoverPayloadApp(entries, resolvedArchivePath);
+        const payloadPrefix = `Payload/${appName}/`;
+        await fs.promises.rm(appPath, { recursive: true, force: true });
+        await ensureDirectoryNotSymlink(appPath);
+        for (const entry of entries) {
+            const name = toZipPath(entry.fileName);
+            if (name !== `Payload/${appName}` && !name.startsWith(payloadPrefix)) {
+                continue;
+            }
+            const rel = name === `Payload/${appName}` ? '' : name.slice(payloadPrefix.length);
+            if (rel === '') {
+                await fs.promises.mkdir(appPath, { recursive: true });
+                continue;
+            }
+            if (isUnsafeZipPath(rel)) {
+                throw new Error(`ZIP entry has an unsafe app-relative path: ${entry.fileName}`);
+            }
+            const target = path.join(appPath, rel.split('/').join(path.sep));
+            const stagingAppResolved = path.resolve(appPath);
+            const targetResolved = path.resolve(target);
+            if (targetResolved !== stagingAppResolved &&
+                !targetResolved.startsWith(stagingAppResolved + path.sep)) {
+                throw new Error(`ZIP entry escapes app bundle: ${entry.fileName}`);
+            }
+            await extractEntry(zip, entry, target, appPath);
+        }
+        return {
+            appPath,
+            cacheIdentityPath: resolvedArchivePath,
+            isArchive: true,
+            archivePath: resolvedArchivePath,
+        };
+    }
+    finally {
+        zip.close();
+    }
+}
+export async function prepareAppBundlePath(inputPath) {
+    const resolvedPath = path.resolve(inputPath);
+    const stat = await fs.promises.stat(resolvedPath);
+    if (stat.isDirectory()) {
+        return {
+            appPath: resolvedPath,
+            cacheIdentityPath: resolvedPath,
+            isArchive: false,
+        };
+    }
+    if (!stat.isFile()) {
+        throw new Error(`The path is neither an app bundle directory nor a ZIP/IPA archive: ${inputPath}`);
+    }
+    return await extractAppArchiveToStablePath(resolvedPath);
+}
+async function waitForStableArchiveFile(archivePath, shouldStop) {
+    const deadline = Date.now() + 10000;
+    let previous;
+    while (!shouldStop() && Date.now() < deadline) {
+        const stat = await fs.promises.stat(archivePath).catch((err) => {
+            if (err.code === 'ENOENT')
+                return null;
+            throw err;
+        });
+        if (stat?.isFile()) {
+            const current = { size: stat.size, mtimeMs: stat.mtimeMs };
+            if (previous && previous.size === current.size && previous.mtimeMs === current.mtimeMs) {
+                return true;
+            }
+            previous = current;
+        }
+        else {
+            previous = undefined;
+        }
+        await sleep(100);
+    }
+    return false;
+}
+export function watchAppArchive(opts) {
+    const archivePath = path.resolve(opts.archivePath);
+    const log = opts.log ?? noopLogger;
+    const parentDir = path.dirname(archivePath);
+    const archiveBase = path.basename(archivePath);
+    let timer;
+    let inFlight = false;
+    let queued = false;
+    let closed = false;
+    const run = async () => {
+        if (closed)
+            return;
+        if (inFlight) {
+            queued = true;
+            return;
+        }
+        inFlight = true;
+        try {
+            const ready = await waitForStableArchiveFile(archivePath, () => closed);
+            if (!ready) {
+                if (!closed) {
+                    log('warn', `ZIP/IPA archive did not become readable after change: ${archivePath}`);
+                }
+                return;
+            }
+            await extractAppArchiveToStablePath(archivePath);
+            log('debug', `re-extracted ZIP/IPA archive: ${archivePath}`);
+            await opts.onExtracted?.();
+        }
+        catch (err) {
+            log('error', `failed to re-extract ZIP/IPA archive ${archivePath}: ${err instanceof Error ? err.message : err}`);
+        }
+        finally {
+            inFlight = false;
+            if (queued) {
+                queued = false;
+                void run();
+            }
+        }
+    };
+    const schedule = () => {
+        if (closed)
+            return;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            void run();
+        }, 500);
+    };
+    const watcher = fs.watch(parentDir, (_eventType, filename) => {
+        if (filename?.toString() === archiveBase) {
+            schedule();
+        }
+    });
+    log('debug', `watchAppArchive: ${archivePath}`);
+    return {
+        close: () => {
+            closed = true;
+            if (timer) {
+                clearTimeout(timer);
+                timer = undefined;
+            }
+            watcher.close();
+        },
+    };
+}
+//# sourceMappingURL=app-archive.mjs.map