@limrun/api 0.19.3 → 0.20.0

package/exec-client.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * Client for executing commands on limbuild server with streaming output.
+ *
+ * The interface is designed to be similar to Node.js's child_process.spawn()
+ * for familiarity and ease of extension.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExecChildProcess = exports.ReadableStream = void 0;
+exports.exec = exec;
+const eventsource_client_1 = require("eventsource-client");
+/**
+ * A Readable-like stream interface, similar to Node.js stream.Readable.
+ * Emits 'data' for each chunk and 'close' when the stream ends.
+ */
+class ReadableStream {
+    constructor() {
+        this.dataListeners = [];
+        this.closeListeners = [];
+        this.closed = false;
+    }
+    on(event, listener) {
+        if (event === 'data') {
+            this.dataListeners.push(listener);
+        }
+        else if (event === 'close') {
+            this.closeListeners.push(listener);
+        }
+        return this;
+    }
+    emit(event, arg) {
+        if (event === 'data' && typeof arg === 'string') {
+            for (const l of this.dataListeners)
+                l(arg);
+        }
+        else if (event === 'close' && !this.closed) {
+            this.closed = true;
+            for (const l of this.closeListeners)
+                l();
+        }
+    }
+}
+exports.ReadableStream = ReadableStream;
+/**
+ * A ChildProcess-like object similar to Node.js's ChildProcess.
+ *
+ * Implements PromiseLike so it can be awaited directly.
+ *
+ * @example
+ * // Stream-based (like Node.js spawn)
+ * const proc = exec({ command: 'xcodebuild' }, options);
+ * proc.stdout.on('data', (chunk) => process.stdout.write(chunk));
+ * proc.stderr.on('data', (chunk) => process.stderr.write(chunk));
+ * proc.on('exit', (code) => console.log(`Exited with code ${code}`));
+ *
+ * // Promise-based (can be awaited)
+ * const { exitCode, status } = await proc;
+ */
+class ExecChildProcess {
+    constructor(request, options) {
+        /** Stdout stream - emits 'data' and 'close' events */
+        this.stdout = new ReadableStream();
+        /** Stderr stream - emits 'data' and 'close' events */
+        this.stderr = new ReadableStream();
+        this.exitListeners = [];
+        this.abortController = null;
+        this.sseConnection = null;
+        this.killed = false;
+        this.options = options;
+        this.log = options.log ?? (() => { });
+        this.resultPromise = this.run(request);
+    }
+    /** Implement PromiseLike so this object can be awaited */
+    then(onfulfilled, onrejected) {
+        return this.resultPromise.then(onfulfilled, onrejected);
+    }
+    /** Catch errors */
+    catch(onrejected) {
+        return this.resultPromise.catch(onrejected);
+    }
+    /** Finally handler */
+    finally(onfinally) {
+        return this.resultPromise.finally(onfinally);
+    }
+    /** Listen for process events */
+    on(event, listener) {
+        if (event === 'exit') {
+            this.exitListeners.push(listener);
+        }
+        return this;
+    }
+    /** Send a signal to terminate the process */
+    async kill() {
+        this.killed = true;
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        if (this.sseConnection) {
+            this.sseConnection.close();
+            this.sseConnection = null;
+        }
+        if (!this.execId) {
+            this.log('warn', 'Failed to cancel build: execId is not set');
+            return;
+        }
+        try {
+            await fetch(`${this.options.apiUrl}/exec/${this.execId}/cancel`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.options.token}`,
+                },
+            });
+            this.log('info', 'Build cancelled');
+        }
+        catch (err) {
+            this.log('warn', `Failed to cancel build: ${err}`);
+        }
+    }
+    async run(request) {
+        const { log } = this;
+        const { apiUrl, token } = this.options;
+        // 1. Trigger the build via POST /exec
+        log('debug', `POST ${apiUrl}/exec`);
+        const execRes = await fetch(`${apiUrl}/exec`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(request),
+        });
+        if (!execRes.ok) {
+            const text = await execRes.text();
+            throw new Error(`exec failed: ${execRes.status} ${text}`);
+        }
+        const execData = (await execRes.json());
+        this.execId = execData.execId;
+        log('info', `Build started: ${this.execId}`);
+        // 2. Connect to SSE for log streaming and completion detection
+        this.abortController = new AbortController();
+        const eventsUrl = `${apiUrl}/exec/${this.execId}/events`;
+        log('debug', `GET ${eventsUrl} (SSE)`);
+        // Promise that resolves when build completes (via exitCode event)
+        let sseCompletionResolve = null;
+        const sseCompletionPromise = new Promise((resolve) => {
+            sseCompletionResolve = resolve;
+        });
+        const ssePromise = this.connectSSE(eventsUrl, sseCompletionResolve);
+        // Wait for SSE to signal completion (with timeout fallback)
+        const timeoutMs = 3600 * 1000; // 1 hour max
+        let exitCode;
+        try {
+            exitCode = await Promise.race([
+                sseCompletionPromise,
+                new Promise((_, reject) => setTimeout(() => reject(new Error('SSE timeout')), timeoutMs)),
+            ]);
+        }
+        catch {
+            log('warn', 'SSE completion timeout');
+            exitCode = 1;
+        }
+        // Cleanup SSE connection
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        await ssePromise.catch(() => { });
+        // Emit close events on streams
+        this.stdout.emit('close');
+        this.stderr.emit('close');
+        // Emit exit event
+        for (const listener of this.exitListeners) {
+            listener(exitCode);
+        }
+        // Determine status from exit code
+        const status = exitCode === 0 ? 'SUCCEEDED'
+            : exitCode === -1 ? 'CANCELLED'
+                : 'FAILED';
+        const result = {
+            exitCode,
+            execId: this.execId,
+            status,
+        };
+        this.log('info', `Build finished: ${result.status} (exit ${result.exitCode})`);
+        return result;
+    }
+    async connectSSE(eventsUrl, onComplete) {
+        return new Promise((resolve) => {
+            const authHeader = `Bearer ${this.options.token}`;
+            let resolved = false;
+            const resolveOnce = () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                this.sseConnection?.close();
+                this.sseConnection = null;
+                resolve();
+            };
+            try {
+                const eventSource = (0, eventsource_client_1.createEventSource)({
+                    url: eventsUrl,
+                    headers: { Authorization: authHeader },
+                    onMessage: (message) => {
+                        const data = typeof message.data === 'string' ? message.data : String(message.data ?? '');
+                        const eventType = message.event;
+                        if (eventType === 'stdout') {
+                            this.stdout.emit('data', data);
+                            return;
+                        }
+                        if (eventType === 'stderr') {
+                            this.stderr.emit('data', data);
+                            return;
+                        }
+                        if (eventType === 'exitCode') {
+                            const exitCode = parseInt(data, 10);
+                            if (Number.isNaN(exitCode)) {
+                                this.log('warn', `SSE exitCode event has invalid data: ${data}`);
+                                return;
+                            }
+                            this.log('debug', `Build completed via SSE: exitCode=${exitCode}`);
+                            onComplete?.(exitCode);
+                            resolveOnce();
+                        }
+                    },
+                    onDisconnect: () => {
+                        if (!this.killed) {
+                            this.log('warn', 'SSE disconnected');
+                        }
+                    },
+                });
+                this.sseConnection = eventSource;
+                const abortSignal = this.abortController?.signal;
+                if (abortSignal) {
+                    abortSignal.addEventListener('abort', () => {
+                        resolveOnce();
+                    }, { once: true });
+                }
+            }
+            catch (err) {
+                if (!this.killed) {
+                    this.log('warn', `SSE setup failed: ${err}`);
+                }
+                resolveOnce();
+            }
+        });
+    }
+}
+exports.ExecChildProcess = ExecChildProcess;
+/**
+ * Execute a command on the limbuild server.
+ * Returns a ChildProcess-like object with stdout/stderr streams.
+ *
+ * @example
+ * const proc = exec({ command: 'xcodebuild' }, { apiUrl: '...', token: '...' });
+ *
+ * // Stream output
+ * proc.stdout.on('data', (chunk) => console.log('[stdout]', chunk));
+ * proc.stderr.on('data', (chunk) => console.error('[stderr]', chunk));
+ *
+ * // Wait for completion
+ * const { exitCode, status } = await proc;
+ */
+function exec(request, options) {
+    return new ExecChildProcess(request, options);
+}
+//# sourceMappingURL=exec-client.js.map

package/exec-client.js.map

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

package/exec-client.mjs

@@ -0,0 +1,259 @@
+/**
+ * Client for executing commands on limbuild server with streaming output.
+ *
+ * The interface is designed to be similar to Node.js's child_process.spawn()
+ * for familiarity and ease of extension.
+ */
+import { createEventSource } from 'eventsource-client';
+/**
+ * A Readable-like stream interface, similar to Node.js stream.Readable.
+ * Emits 'data' for each chunk and 'close' when the stream ends.
+ */
+export class ReadableStream {
+    constructor() {
+        this.dataListeners = [];
+        this.closeListeners = [];
+        this.closed = false;
+    }
+    on(event, listener) {
+        if (event === 'data') {
+            this.dataListeners.push(listener);
+        }
+        else if (event === 'close') {
+            this.closeListeners.push(listener);
+        }
+        return this;
+    }
+    emit(event, arg) {
+        if (event === 'data' && typeof arg === 'string') {
+            for (const l of this.dataListeners)
+                l(arg);
+        }
+        else if (event === 'close' && !this.closed) {
+            this.closed = true;
+            for (const l of this.closeListeners)
+                l();
+        }
+    }
+}
+/**
+ * A ChildProcess-like object similar to Node.js's ChildProcess.
+ *
+ * Implements PromiseLike so it can be awaited directly.
+ *
+ * @example
+ * // Stream-based (like Node.js spawn)
+ * const proc = exec({ command: 'xcodebuild' }, options);
+ * proc.stdout.on('data', (chunk) => process.stdout.write(chunk));
+ * proc.stderr.on('data', (chunk) => process.stderr.write(chunk));
+ * proc.on('exit', (code) => console.log(`Exited with code ${code}`));
+ *
+ * // Promise-based (can be awaited)
+ * const { exitCode, status } = await proc;
+ */
+export class ExecChildProcess {
+    constructor(request, options) {
+        /** Stdout stream - emits 'data' and 'close' events */
+        this.stdout = new ReadableStream();
+        /** Stderr stream - emits 'data' and 'close' events */
+        this.stderr = new ReadableStream();
+        this.exitListeners = [];
+        this.abortController = null;
+        this.sseConnection = null;
+        this.killed = false;
+        this.options = options;
+        this.log = options.log ?? (() => { });
+        this.resultPromise = this.run(request);
+    }
+    /** Implement PromiseLike so this object can be awaited */
+    then(onfulfilled, onrejected) {
+        return this.resultPromise.then(onfulfilled, onrejected);
+    }
+    /** Catch errors */
+    catch(onrejected) {
+        return this.resultPromise.catch(onrejected);
+    }
+    /** Finally handler */
+    finally(onfinally) {
+        return this.resultPromise.finally(onfinally);
+    }
+    /** Listen for process events */
+    on(event, listener) {
+        if (event === 'exit') {
+            this.exitListeners.push(listener);
+        }
+        return this;
+    }
+    /** Send a signal to terminate the process */
+    async kill() {
+        this.killed = true;
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        if (this.sseConnection) {
+            this.sseConnection.close();
+            this.sseConnection = null;
+        }
+        if (!this.execId) {
+            this.log('warn', 'Failed to cancel build: execId is not set');
+            return;
+        }
+        try {
+            await fetch(`${this.options.apiUrl}/exec/${this.execId}/cancel`, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.options.token}`,
+                },
+            });
+            this.log('info', 'Build cancelled');
+        }
+        catch (err) {
+            this.log('warn', `Failed to cancel build: ${err}`);
+        }
+    }
+    async run(request) {
+        const { log } = this;
+        const { apiUrl, token } = this.options;
+        // 1. Trigger the build via POST /exec
+        log('debug', `POST ${apiUrl}/exec`);
+        const execRes = await fetch(`${apiUrl}/exec`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify(request),
+        });
+        if (!execRes.ok) {
+            const text = await execRes.text();
+            throw new Error(`exec failed: ${execRes.status} ${text}`);
+        }
+        const execData = (await execRes.json());
+        this.execId = execData.execId;
+        log('info', `Build started: ${this.execId}`);
+        // 2. Connect to SSE for log streaming and completion detection
+        this.abortController = new AbortController();
+        const eventsUrl = `${apiUrl}/exec/${this.execId}/events`;
+        log('debug', `GET ${eventsUrl} (SSE)`);
+        // Promise that resolves when build completes (via exitCode event)
+        let sseCompletionResolve = null;
+        const sseCompletionPromise = new Promise((resolve) => {
+            sseCompletionResolve = resolve;
+        });
+        const ssePromise = this.connectSSE(eventsUrl, sseCompletionResolve);
+        // Wait for SSE to signal completion (with timeout fallback)
+        const timeoutMs = 3600 * 1000; // 1 hour max
+        let exitCode;
+        try {
+            exitCode = await Promise.race([
+                sseCompletionPromise,
+                new Promise((_, reject) => setTimeout(() => reject(new Error('SSE timeout')), timeoutMs)),
+            ]);
+        }
+        catch {
+            log('warn', 'SSE completion timeout');
+            exitCode = 1;
+        }
+        // Cleanup SSE connection
+        if (this.abortController) {
+            this.abortController.abort();
+        }
+        await ssePromise.catch(() => { });
+        // Emit close events on streams
+        this.stdout.emit('close');
+        this.stderr.emit('close');
+        // Emit exit event
+        for (const listener of this.exitListeners) {
+            listener(exitCode);
+        }
+        // Determine status from exit code
+        const status = exitCode === 0 ? 'SUCCEEDED'
+            : exitCode === -1 ? 'CANCELLED'
+                : 'FAILED';
+        const result = {
+            exitCode,
+            execId: this.execId,
+            status,
+        };
+        this.log('info', `Build finished: ${result.status} (exit ${result.exitCode})`);
+        return result;
+    }
+    async connectSSE(eventsUrl, onComplete) {
+        return new Promise((resolve) => {
+            const authHeader = `Bearer ${this.options.token}`;
+            let resolved = false;
+            const resolveOnce = () => {
+                if (resolved)
+                    return;
+                resolved = true;
+                this.sseConnection?.close();
+                this.sseConnection = null;
+                resolve();
+            };
+            try {
+                const eventSource = createEventSource({
+                    url: eventsUrl,
+                    headers: { Authorization: authHeader },
+                    onMessage: (message) => {
+                        const data = typeof message.data === 'string' ? message.data : String(message.data ?? '');
+                        const eventType = message.event;
+                        if (eventType === 'stdout') {
+                            this.stdout.emit('data', data);
+                            return;
+                        }
+                        if (eventType === 'stderr') {
+                            this.stderr.emit('data', data);
+                            return;
+                        }
+                        if (eventType === 'exitCode') {
+                            const exitCode = parseInt(data, 10);
+                            if (Number.isNaN(exitCode)) {
+                                this.log('warn', `SSE exitCode event has invalid data: ${data}`);
+                                return;
+                            }
+                            this.log('debug', `Build completed via SSE: exitCode=${exitCode}`);
+                            onComplete?.(exitCode);
+                            resolveOnce();
+                        }
+                    },
+                    onDisconnect: () => {
+                        if (!this.killed) {
+                            this.log('warn', 'SSE disconnected');
+                        }
+                    },
+                });
+                this.sseConnection = eventSource;
+                const abortSignal = this.abortController?.signal;
+                if (abortSignal) {
+                    abortSignal.addEventListener('abort', () => {
+                        resolveOnce();
+                    }, { once: true });
+                }
+            }
+            catch (err) {
+                if (!this.killed) {
+                    this.log('warn', `SSE setup failed: ${err}`);
+                }
+                resolveOnce();
+            }
+        });
+    }
+}
+/**
+ * Execute a command on the limbuild server.
+ * Returns a ChildProcess-like object with stdout/stderr streams.
+ *
+ * @example
+ * const proc = exec({ command: 'xcodebuild' }, { apiUrl: '...', token: '...' });
+ *
+ * // Stream output
+ * proc.stdout.on('data', (chunk) => console.log('[stdout]', chunk));
+ * proc.stderr.on('data', (chunk) => console.error('[stderr]', chunk));
+ *
+ * // Wait for completion
+ * const { exitCode, status } = await proc;
+ */
+export function exec(request, options) {
+    return new ExecChildProcess(request, options);
+}
+//# sourceMappingURL=exec-client.mjs.map

package/exec-client.mjs.map

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

package/folder-sync.d.mts

@@ -7,7 +7,7 @@ export type FolderSyncOptions = {
      * Used to store the last-synced “basis” copies of files (and related sync metadata) so we can compute xdelta patches
      * on subsequent syncs without re-downloading server state.
      *
-     * Can be absolute or relative to process.cwd(). Defaults to `.lim-metadata-cache/`.
+     * Can be absolute or relative to process.cwd(). Defaults to `.limsync-cache/`.
      */
     basisCacheDir?: string;
     install?: boolean;
@@ -18,6 +18,21 @@ export type FolderSyncOptions = {
     maxPatchBytes?: number;
     /** Controls logging verbosity */
     log?: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+    /**
+     * Optional filter function to include/exclude files and directories.
+     * Called with the relative path from localFolderPath (using forward slashes).
+     * For directories, the path ends with '/'.
+     * Return true to include, false to exclude.
+     *
+     * @example
+     * // Exclude build folder
+     * filter: (path) => !path.startsWith('build/')
+     *
+     * @example
+     * // Only include source files
+     * filter: (path) => path.startsWith('src/') || path.endsWith('.json')
+     */
+    filter?: (relativePath: string) => boolean;
 };
 export type SyncFolderResult = {
     installedAppPath?: string;
@@ -27,5 +42,4 @@ export type SyncFolderResult = {
 };
 export type SyncAppResult = SyncFolderResult;
 export declare function syncApp(localFolderPath: string, opts: FolderSyncOptions): Promise<SyncFolderResult>;
-export declare function syncFolder(localFolderPath: string, opts: FolderSyncOptions): Promise<SyncFolderResult>;
 //# sourceMappingURL=folder-sync.d.mts.map

package/folder-sync.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"folder-sync.d.mts","sourceRoot":"","sources":["src/folder-sync.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC3E,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AA4QF,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,wBAAsB,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CzG;AAGD,wBAAsB,UAAU,CAC9B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}
+{"version":3,"file":"folder-sync.d.mts","sourceRoot":"","sources":["src/folder-sync.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC3E,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAmTF,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,wBAAsB,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4CzG"}

package/folder-sync.d.ts

@@ -7,7 +7,7 @@ export type FolderSyncOptions = {
      * Used to store the last-synced “basis” copies of files (and related sync metadata) so we can compute xdelta patches
      * on subsequent syncs without re-downloading server state.
      *
-     * Can be absolute or relative to process.cwd(). Defaults to `.lim-metadata-cache/`.
+     * Can be absolute or relative to process.cwd(). Defaults to `.limsync-cache/`.
      */
     basisCacheDir?: string;
     install?: boolean;
@@ -18,6 +18,21 @@ export type FolderSyncOptions = {
     maxPatchBytes?: number;
     /** Controls logging verbosity */
     log?: (level: 'debug' | 'info' | 'warn' | 'error', msg: string) => void;
+    /**
+     * Optional filter function to include/exclude files and directories.
+     * Called with the relative path from localFolderPath (using forward slashes).
+     * For directories, the path ends with '/'.
+     * Return true to include, false to exclude.
+     *
+     * @example
+     * // Exclude build folder
+     * filter: (path) => !path.startsWith('build/')
+     *
+     * @example
+     * // Only include source files
+     * filter: (path) => path.startsWith('src/') || path.endsWith('.json')
+     */
+    filter?: (relativePath: string) => boolean;
 };
 export type SyncFolderResult = {
     installedAppPath?: string;
@@ -27,5 +42,4 @@ export type SyncFolderResult = {
 };
 export type SyncAppResult = SyncFolderResult;
 export declare function syncApp(localFolderPath: string, opts: FolderSyncOptions): Promise<SyncFolderResult>;
-export declare function syncFolder(localFolderPath: string, opts: FolderSyncOptions): Promise<SyncFolderResult>;
 //# sourceMappingURL=folder-sync.d.ts.map

package/folder-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"folder-sync.d.ts","sourceRoot":"","sources":["src/folder-sync.ts"],"names":[],"mappings":"AAaA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC3E,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AA4QF,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,wBAAsB,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA2CzG;AAGD,wBAAsB,UAAU,CAC9B,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAE3B"}
+{"version":3,"file":"folder-sync.d.ts","sourceRoot":"","sources":["src/folder-sync.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,GAAG,eAAe,CAAC;IAC3E,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACxE;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B,CAAC;AAmTF,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE7C,wBAAsB,OAAO,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4CzG"}