@rock-js/tools 0.8.13

package/README.md

@@ -0,0 +1,7 @@
+# @rock-js/tools
+
+Development tools and utilities for Rock (Rock). This package is part of the Rock ecosystem.
+
+## Documentation
+
+For detailed documentation about Rock and its tools, visit [Rock Documentation](https://rockjs.dev)

package/dist/src/index.d.ts

@@ -0,0 +1,19 @@
+export * from './lib/prompts.js';
+export * from './lib/env.js';
+export * from './lib/error.js';
+export { default as logger } from './lib/logger.js';
+export * from './lib/fingerprint/index.js';
+export { default as cacheManager } from './lib/cacheManager.js';
+export * from './lib/parse-args.js';
+export * from './lib/path.js';
+export * from './lib/project.js';
+export * from './lib/build-cache/common.js';
+export * from './lib/build-cache/localBuildCache.js';
+export { getBinaryPath } from './lib/build-cache/getBinaryPath.js';
+export { findDevServerPort } from './lib/dev-server/findDevServerPort.js';
+export { isDevServerRunning } from './lib/dev-server/isDevServerRunning.js';
+export { isInteractive } from './lib/isInteractive.js';
+export { spawn, SubprocessError } from './lib/spawn.js';
+export { color, colorLink } from './lib/color.js';
+export { runHermes } from './lib/hermes.js';
+export { fetchCachedBuild, handleDownloadResponse, handleUploadResponse, } from './lib/build-cache/fetchCachedBuild.js';

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,uCAAuC,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,20 @@
+export * from './lib/prompts.js';
+export * from './lib/env.js';
+export * from './lib/error.js';
+export { default as logger } from './lib/logger.js';
+export * from './lib/fingerprint/index.js';
+export { default as cacheManager } from './lib/cacheManager.js';
+export * from './lib/parse-args.js';
+export * from './lib/path.js';
+export * from './lib/project.js';
+export * from './lib/build-cache/common.js';
+export * from './lib/build-cache/localBuildCache.js';
+export { getBinaryPath } from './lib/build-cache/getBinaryPath.js';
+export { findDevServerPort } from './lib/dev-server/findDevServerPort.js';
+export { isDevServerRunning } from './lib/dev-server/isDevServerRunning.js';
+export { isInteractive } from './lib/isInteractive.js';
+export { spawn, SubprocessError } from './lib/spawn.js';
+export { color, colorLink } from './lib/color.js';
+export { runHermes } from './lib/hermes.js';
+export { fetchCachedBuild, handleDownloadResponse, handleUploadResponse, } from './lib/build-cache/fetchCachedBuild.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,uCAAuC,CAAC"}

package/dist/src/lib/build-cache/common.d.ts

@@ -0,0 +1,79 @@
+import type { FingerprintSources } from '../fingerprint/index.js';
+export declare const BUILD_CACHE_DIR = "remote-build";
+export type SupportedRemoteCacheProviders = 'github-actions';
+export type RemoteArtifact = {
+    name: string;
+    url: string;
+    id?: string;
+};
+export type LocalArtifact = {
+    name: string;
+};
+/**
+ * Interface for implementing remote build cache providers.
+ * Remote cache providers allow storing and retrieving native build artifacts (e.g. APK, IPA)
+ * from remote storage like S3, GitHub Artifacts etc.
+ */
+export interface RemoteBuildCache {
+    /** Unique identifier for this cache provider, will be displayed in logs */
+    name: string;
+    /**
+     * List available artifacts matching the given name pattern
+     * @param artifactName - Passed after fingerprinting the build, e.g. `rock-android-debug-1234567890` for android in debug variant
+     * @param limit - Optional maximum number of artifacts to return
+     * @returns Array of matching remote artifacts, or empty array if none found
+     */
+    list({ artifactName, limit, }: {
+        artifactName: string | undefined;
+        limit?: number;
+    }): Promise<RemoteArtifact[]>;
+    /**
+     * Download a remote artifact to local storage
+     * @param artifactName - Name of the artifact to download, e.g. `rock-android-debug-1234567890` for android in debug variant
+     * @returns Response object from fetch, which will be used to download the artifact
+     */
+    download({ artifactName }: {
+        artifactName: string;
+    }): Promise<Response>;
+    /**
+     * Delete a remote artifact
+     * @param artifactName - Name of the artifact to delete, e.g. `rock-android-debug-1234567890` for android in debug variant
+     * @param limit - Optional maximum number of artifacts to delete
+     * @param skipLatest - Optional flag to skip the latest artifact, helpful when deleting all but the latest artifact
+     * @returns Array of deleted artifacts
+     * @throws {Error} Throws if artifact is not found or deletion fails
+     */
+    delete({ artifactName, limit, skipLatest, }: {
+        artifactName: string;
+        limit?: number;
+        skipLatest?: boolean;
+    }): Promise<RemoteArtifact[]>;
+    /**
+     * Upload a local artifact stored in build cache to remote storage
+     * @param artifactName - Name of the artifact to upload, e.g. `rock-android-debug-1234567890` for android in debug variant
+     * @param uploadArtifactName - Name of the artifact to upload, e.g. `ad-hoc/rock-ios-device-Release-1234567890/YourApp.ipa` for ad-hoc distribution
+     * @returns Remote artifact info with response function for upload control
+     * @throws {Error} Throws if upload fails
+     */
+    upload({ artifactName, uploadArtifactName, }: {
+        artifactName: string;
+        uploadArtifactName?: string;
+    }): Promise<RemoteArtifact & {
+        getResponse: (buffer: Buffer | ((baseUrl: string) => Buffer), contentType?: string) => Response;
+    }>;
+}
+/**
+ * Used formats:
+ * - rock-android-debug-1234567890
+ * - rock-ios-simulator-debug-1234567890
+ * - rock-ios-device-debug-1234567890
+ */
+export declare function formatArtifactName({ platform, traits, root, fingerprintOptions, raw, }: {
+    platform?: 'ios' | 'android';
+    traits?: string[];
+    root: string;
+    fingerprintOptions: FingerprintSources;
+    raw?: boolean;
+}): Promise<string>;
+export declare function getLocalArtifactPath(artifactName: string): string;
+export declare function getLocalBinaryPath(artifactPath: string): string | null;

package/dist/src/lib/build-cache/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../../src/lib/build-cache/common.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAMlE,eAAO,MAAM,eAAe,iBAAiB,CAAC;AAE9C,MAAM,MAAM,6BAA6B,GAAG,gBAAgB,CAAC;AAE7D,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,IAAI,CAAC,EACH,YAAY,EACZ,KAAK,GACN,EAAE;QACD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,YAAY,EAAE,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,MAAM,CAAC,EACL,YAAY,EACZ,KAAK,EACL,UAAU,GACX,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAE9B;;;;;;OAMG;IACH,MAAM,CAAC,EACL,YAAY,EACZ,MAAM,GACP,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAE5B;;;;;;;OAOG;IACH,YAAY,CAAC,CAAC,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,GACN,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,kBAAkB,EAClB,GAAG,GACJ,EAAE;IACD,QAAQ,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,MAAM,CAAC,CAuBlB;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,UAExD;AAED,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,iBAKtD"}

package/dist/src/lib/build-cache/common.js

@@ -0,0 +1,44 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { color } from '../color.js';
+import { nativeFingerprint } from '../fingerprint/index.js';
+import { isInteractive } from '../isInteractive.js';
+import { getCacheRootPath } from '../project.js';
+import { spinner } from '../prompts.js';
+export const BUILD_CACHE_DIR = 'remote-build';
+/**
+ * Used formats:
+ * - rock-android-debug-1234567890
+ * - rock-ios-simulator-debug-1234567890
+ * - rock-ios-device-debug-1234567890
+ */
+export async function formatArtifactName({ platform, traits, root, fingerprintOptions, raw, }) {
+    if (!platform || !traits) {
+        return '';
+    }
+    if (raw || !isInteractive()) {
+        const { hash } = await nativeFingerprint(root, {
+            ...fingerprintOptions,
+            platform,
+        });
+        return `rock-${platform}-${traits.join('-')}-${hash}`;
+    }
+    const loader = spinner();
+    loader.start('Calculating project fingerprint');
+    const { hash } = await nativeFingerprint(root, {
+        ...fingerprintOptions,
+        platform,
+    });
+    loader.stop(`Calculated project fingerprint: ${color.bold(color.magenta(hash))}`);
+    return `rock-${platform}-${traits.join('-')}-${hash}`;
+}
+export function getLocalArtifactPath(artifactName) {
+    return path.join(getCacheRootPath(), BUILD_CACHE_DIR, artifactName);
+}
+export function getLocalBinaryPath(artifactPath) {
+    const files = fs.readdirSync(artifactPath);
+    // Get the first non-hidden file as the binary
+    const binaryName = files.find((file) => file && !file.startsWith('.'));
+    return binaryName ? path.join(artifactPath, binaryName) : null;
+}
+//# sourceMappingURL=common.js.map

package/dist/src/lib/build-cache/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../../src/lib/build-cache/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,CAAC,MAAM,eAAe,GAAG,cAAc,CAAC;AAqF9C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,QAAQ,EACR,MAAM,EACN,IAAI,EACJ,kBAAkB,EAClB,GAAG,GAOJ;IACC,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QAC5B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE;YAC7C,GAAG,kBAAkB;YACrB,QAAQ;SACT,CAAC,CAAC;QACH,OAAO,QAAQ,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,CAAC;IACzB,MAAM,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAChD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE;QAC7C,GAAG,kBAAkB;QACrB,QAAQ;KACT,CAAC,CAAC;IACH,MAAM,CAAC,IAAI,CACT,mCAAmC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CACrE,CAAC;IACF,OAAO,QAAQ,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,eAAe,EAAE,YAAY,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAC3C,8CAA8C;IAC9C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;IACvE,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}

package/dist/src/lib/build-cache/fetchCachedBuild.d.ts

@@ -0,0 +1,12 @@
+import { type RemoteBuildCache } from './common.js';
+import type { LocalBuild } from './localBuildCache.js';
+type FetchCachedBuildOptions = {
+    artifactName: string;
+    remoteCacheProvider: undefined | null | {
+        (): RemoteBuildCache;
+    };
+};
+export declare function fetchCachedBuild({ artifactName, remoteCacheProvider, }: FetchCachedBuildOptions): Promise<LocalBuild | undefined>;
+export declare function handleDownloadResponse(response: Response, localArtifactPath: string, onProgress: (progress: string, totalMB: string) => void): Promise<void>;
+export declare function handleUploadResponse(getResponse: (buffer: Buffer) => Response, buffer: Buffer, onProgress: (progress: string, totalMB: string) => void): Promise<void>;
+export {};

package/dist/src/lib/build-cache/fetchCachedBuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchCachedBuild.d.ts","sourceRoot":"","sources":["../../../../src/lib/build-cache/fetchCachedBuild.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,KAAK,uBAAuB,GAAG;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,SAAS,GAAG,IAAI,GAAG;QAAE,IAAI,gBAAgB,CAAA;KAAE,CAAC;CAClE,CAAC;AAEF,wBAAsB,gBAAgB,CAAC,EACrC,YAAY,EACZ,mBAAmB,GACpB,EAAE,uBAAuB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAkD3D;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,MAAM,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,iBA+CpC"}

package/dist/src/lib/build-cache/fetchCachedBuild.js

@@ -0,0 +1,128 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import AdmZip from 'adm-zip';
+import * as tar from 'tar';
+import { color, colorLink } from '../color.js';
+import { RockError } from '../error.js';
+import logger from '../logger.js';
+import { relativeToCwd } from '../path.js';
+import { spinner } from '../prompts.js';
+import { getLocalArtifactPath, getLocalBinaryPath, } from './common.js';
+export async function fetchCachedBuild({ artifactName, remoteCacheProvider, }) {
+    if (remoteCacheProvider === null) {
+        return undefined;
+    }
+    if (remoteCacheProvider === undefined) {
+        logger.warn(`No remote cache provider set. You won't be able to access reusable builds from e.g. GitHub Actions. 
+To configure it, set the "remoteCacheProvider" key in ${colorLink('rock.config.mjs')} file. For example:
+
+import { providerGitHub } from '@rock-js/provider-github';
+export default {
+  // ...
+  remoteCacheProvider: providerGitHub()
+}
+
+To disable this warning, set the provider to null:
+{
+  remoteCacheProvider: null
+}`);
+        return undefined;
+    }
+    const loader = spinner();
+    const localArtifactPath = getLocalArtifactPath(artifactName);
+    const remoteBuildCache = remoteCacheProvider();
+    const response = await remoteBuildCache.download({ artifactName });
+    loader.start(`Downloading cached build from ${color.bold(remoteBuildCache.name)}`);
+    await handleDownloadResponse(response, localArtifactPath, (progress, totalMB) => {
+        loader.message(`Downloading cached build from ${color.bold(remoteBuildCache.name)} (${progress}% of ${totalMB} MB)`);
+    });
+    await extractArtifactTarballIfNeeded(localArtifactPath);
+    const binaryPath = getLocalBinaryPath(localArtifactPath);
+    if (!binaryPath) {
+        loader.stop(`No binary found for ${color.bold(artifactName)}.`);
+        return undefined;
+    }
+    loader.stop(`Downloaded cached build to: ${colorLink(relativeToCwd(localArtifactPath))}`);
+    return {
+        name: artifactName,
+        artifactPath: localArtifactPath,
+        binaryPath,
+    };
+}
+async function trackProgressFromStream(response, onProgress) {
+    const contentLength = response.headers.get('content-length');
+    if (!contentLength || !response.body) {
+        return response;
+    }
+    const totalBytes = parseInt(contentLength, 10);
+    const totalMB = (totalBytes / 1024 / 1024).toFixed(2);
+    let processedBytes = 0;
+    const reader = response.body.getReader();
+    const stream = new ReadableStream({
+        async start(controller) {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done) {
+                    break;
+                }
+                processedBytes += value.length;
+                const progress = ((processedBytes / totalBytes) * 100).toFixed(0);
+                onProgress(progress, totalMB);
+                controller.enqueue(value);
+            }
+            controller.close();
+        },
+    });
+    return new Response(stream);
+}
+export async function handleDownloadResponse(response, localArtifactPath, onProgress) {
+    try {
+        fs.mkdirSync(localArtifactPath, { recursive: true });
+        if (!response.ok || !response.body) {
+            throw new Error(`Failed to download artifact: ${response.statusText}`);
+        }
+        const responseWithProgress = await trackProgressFromStream(response, onProgress);
+        const zipPath = localArtifactPath + '.zip';
+        const buffer = await responseWithProgress.arrayBuffer();
+        fs.writeFileSync(zipPath, new Uint8Array(buffer));
+        unzipFile(zipPath, localArtifactPath);
+        fs.unlinkSync(zipPath);
+    }
+    catch (error) {
+        throw new RockError(`Unexpected error`, { cause: error });
+    }
+}
+export async function handleUploadResponse(getResponse, buffer, onProgress) {
+    try {
+        const response = getResponse(buffer);
+        if (!response.body) {
+            throw new Error('Response body is empty');
+        }
+        const responseWithProgress = await trackProgressFromStream(response, onProgress);
+        await responseWithProgress.arrayBuffer();
+    }
+    catch (error) {
+        throw new RockError(`Unexpected error during upload`, { cause: error });
+    }
+}
+function unzipFile(zipPath, targetPath) {
+    const zip = new AdmZip(zipPath);
+    zip.extractAllTo(targetPath, true);
+}
+async function extractArtifactTarballIfNeeded(artifactPath) {
+    const tarPath = path.join(artifactPath, 'app.tar.gz');
+    // If the tarball is not found, it means the artifact is already unpacked.
+    if (!fs.existsSync(tarPath)) {
+        return;
+    }
+    // iOS simulator build artifact (*.app directory) is packed in .tar.gz file to
+    // preserve execute file permission.
+    // See: https://github.com/actions/upload-artifact?tab=readme-ov-file#permission-loss
+    await tar.extract({
+        file: tarPath,
+        cwd: artifactPath,
+        gzip: true,
+    });
+    fs.unlinkSync(tarPath);
+}
+//# sourceMappingURL=fetchCachedBuild.js.map

package/dist/src/lib/build-cache/fetchCachedBuild.js.map

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

package/dist/src/lib/build-cache/getBinaryPath.d.ts

@@ -0,0 +1,10 @@
+import { type FingerprintSources } from '../fingerprint/index.js';
+import type { RemoteBuildCache } from './common.js';
+export declare function getBinaryPath({ artifactName, binaryPathFlag, localFlag, remoteCacheProvider, fingerprintOptions, sourceDir, }: {
+    artifactName: string;
+    binaryPathFlag?: string;
+    localFlag?: boolean;
+    remoteCacheProvider: null | (() => RemoteBuildCache) | undefined;
+    fingerprintOptions: FingerprintSources;
+    sourceDir: string;
+}): Promise<string | undefined>;

package/dist/src/lib/build-cache/getBinaryPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBinaryPath.d.ts","sourceRoot":"","sources":["../../../../src/lib/build-cache/getBinaryPath.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAIpD,wBAAsB,aAAa,CAAC,EAClC,YAAY,EACZ,cAAc,EACd,SAAS,EACT,mBAAmB,EACnB,kBAAkB,EAClB,SAAS,GACV,EAAE;IACD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mBAAmB,EAAE,IAAI,GAAG,CAAC,MAAM,gBAAgB,CAAC,GAAG,SAAS,CAAC;IACjE,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB,+BAiCA"}

package/dist/src/lib/build-cache/getBinaryPath.js

@@ -0,0 +1,60 @@
+import { color, colorLink } from '../color.js';
+import { DEFAULT_IGNORE_PATHS, EXPO_DEFAULT_IGNORE_PATHS, } from '../fingerprint/index.js';
+import logger from '../logger.js';
+import { spawn } from '../spawn.js';
+import { fetchCachedBuild } from './fetchCachedBuild.js';
+import { getLocalBuildCacheBinaryPath } from './localBuildCache.js';
+export async function getBinaryPath({ artifactName, binaryPathFlag, localFlag, remoteCacheProvider, fingerprintOptions, sourceDir, }) {
+    // 1. First check if the binary path is provided
+    let binaryPath = binaryPathFlag;
+    // 2. If not, check if the local build is requested
+    if (!binaryPath && !localFlag) {
+        binaryPath = getLocalBuildCacheBinaryPath(artifactName);
+    }
+    // 3. If not, check if the remote cache is requested
+    if (!binaryPath && !localFlag) {
+        try {
+            const cachedBuild = await fetchCachedBuild({
+                artifactName,
+                remoteCacheProvider,
+            });
+            if (cachedBuild) {
+                binaryPath = cachedBuild.binaryPath;
+            }
+        }
+        catch (error) {
+            const message = error.message;
+            const cause = error.cause;
+            logger.warn(`Failed to fetch cached build for ${artifactName}: \n${message}`, cause ? `\nCause: ${cause.toString()}` : '');
+            await warnIgnoredFiles(fingerprintOptions, sourceDir);
+            logger.debug('Remote cache failure error:', error);
+            logger.info('Continuing with local build');
+        }
+    }
+    return binaryPath;
+}
+async function warnIgnoredFiles(fingerprintOptions, sourceDir) {
+    const ignorePaths = [
+        ...(fingerprintOptions?.ignorePaths ?? []),
+        ...EXPO_DEFAULT_IGNORE_PATHS,
+        ...DEFAULT_IGNORE_PATHS,
+    ];
+    const { output } = await spawn('git', [
+        'clean',
+        '-fdx',
+        '--dry-run',
+        sourceDir,
+        ...ignorePaths.flatMap((path) => ['-e', `${path}`]),
+    ]);
+    const ignoredFiles = output
+        .split('\n')
+        .map((line) => line.replace('Would remove ', ''))
+        .filter((line) => line !== '');
+    if (ignoredFiles.length > 0) {
+        logger.warn(`There are files that likely affect fingerprint:
+${ignoredFiles.map((file) => `- ${color.bold(file)}`).join('\n')}
+Consider removing them or update ${color.bold('fingerprint.ignorePaths')} in ${colorLink('rock.config.mjs')}:
+Read more: ${colorLink('https://www.rockjs.dev/docs/configuration#fingerprint-configuration')}`);
+    }
+}
+//# sourceMappingURL=getBinaryPath.js.map

package/dist/src/lib/build-cache/getBinaryPath.js.map

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

package/dist/src/lib/build-cache/localBuildCache.d.ts

@@ -0,0 +1,8 @@
+export type LocalBuild = {
+    name: string;
+    artifactPath: string;
+    binaryPath: string;
+};
+export declare function queryLocalBuildCache(artifactName: string): LocalBuild | null;
+export declare function saveLocalBuildCache(artifactName: string, binaryPath: string): void;
+export declare function getLocalBuildCacheBinaryPath(artifactName: string): string | undefined;

package/dist/src/lib/build-cache/localBuildCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localBuildCache.d.ts","sourceRoot":"","sources":["../../../../src/lib/build-cache/localBuildCache.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAc5E;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAsB3E;AAED,wBAAgB,4BAA4B,CAC1C,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CASpB"}

package/dist/src/lib/build-cache/localBuildCache.js

@@ -0,0 +1,50 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { color, colorLink } from '../color.js';
+import logger from '../logger.js';
+import { relativeToCwd } from '../path.js';
+import { getLocalArtifactPath, getLocalBinaryPath } from './common.js';
+export function queryLocalBuildCache(artifactName) {
+    const artifactPath = getLocalArtifactPath(artifactName);
+    if (!fs.statSync(artifactPath, { throwIfNoEntry: false })?.isDirectory()) {
+        return null;
+    }
+    const binaryPath = getLocalBinaryPath(artifactPath);
+    if (binaryPath == null || !fs.existsSync(binaryPath)) {
+        return null;
+    }
+    return {
+        name: artifactName,
+        artifactPath,
+        binaryPath,
+    };
+}
+export function saveLocalBuildCache(artifactName, binaryPath) {
+    try {
+        const cachePath = getLocalArtifactPath(artifactName);
+        if (!fs.existsSync(cachePath)) {
+            fs.mkdirSync(cachePath, { recursive: true });
+        }
+        if (fs.statSync(binaryPath).isDirectory()) {
+            fs.cpSync(binaryPath, path.join(cachePath, path.basename(binaryPath)), {
+                recursive: true,
+            });
+        }
+        else {
+            fs.copyFileSync(binaryPath, path.join(cachePath, path.basename(binaryPath)));
+        }
+        logger.debug(`Saved build cache to: ${colorLink(relativeToCwd(cachePath))}`);
+    }
+    catch (error) {
+        logger.debug('Failed to copy binary to local build cache', error);
+    }
+}
+export function getLocalBuildCacheBinaryPath(artifactName) {
+    const localBuild = queryLocalBuildCache(artifactName);
+    if (localBuild) {
+        logger.log(`Found build cache for: ${color.bold(color.blue(localBuild.name))}`);
+        return localBuild.binaryPath;
+    }
+    return undefined;
+}
+//# sourceMappingURL=localBuildCache.js.map

package/dist/src/lib/build-cache/localBuildCache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localBuildCache.js","sourceRoot":"","sources":["../../../../src/lib/build-cache/localBuildCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,MAAM,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAQvE,MAAM,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,YAAY,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACxD,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,UAAU,GAAG,kBAAkB,CAAC,YAAY,CAAC,CAAC;IACpD,IAAI,UAAU,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,YAAoB,EAAE,UAAkB;IAC1E,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACrD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;YAC1C,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,EAAE;gBACrE,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,YAAY,CACb,UAAU,EACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAChD,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,KAAK,CACV,yBAAyB,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,YAAoB;IAEpB,MAAM,UAAU,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACtD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,CACR,0BAA0B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,EAAE,CACpE,CAAC;QACF,OAAO,UAAU,CAAC,UAAU,CAAC;IAC/B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/lib/cacheManager.d.ts

@@ -0,0 +1,15 @@
+import { getCacheRootPath } from './project.js';
+type CacheKey = string;
+export declare function getCacheFile(): string;
+declare function removeProjectCache(): void;
+declare function get(key: CacheKey): string | undefined;
+declare function set(key: CacheKey, value: string): void;
+declare function remove(key: CacheKey): void;
+declare const _default: {
+    get: typeof get;
+    set: typeof set;
+    remove: typeof remove;
+    removeProjectCache: typeof removeProjectCache;
+    getCacheRootPath: typeof getCacheRootPath;
+};
+export default _default;

package/dist/src/lib/cacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheManager.d.ts","sourceRoot":"","sources":["../../../src/lib/cacheManager.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,KAAK,QAAQ,GAAG,MAAM,CAAC;AAGvB,wBAAgB,YAAY,WAE3B;AAwBD,iBAAS,kBAAkB,SAc1B;AAED,iBAAS,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAG9C;AAED,iBAAS,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,QAIxC;AAED,iBAAS,MAAM,CAAC,GAAG,EAAE,QAAQ,QAI5B;;;;;;;;AAED,wBAME"}

package/dist/src/lib/cacheManager.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { colorLink } from './color.js';
+import { RockError } from './error.js';
+import logger from './logger.js';
+import { getCacheRootPath } from './project.js';
+const CACHE_FILE_NAME = 'project.json';
+export function getCacheFile() {
+    return path.join(getCacheRootPath(), CACHE_FILE_NAME);
+}
+function loadCache() {
+    try {
+        const cachePath = path.resolve(getCacheFile());
+        if (!fs.existsSync(cachePath)) {
+            logger.debug(`No cache found at: ${cachePath}`);
+            return {};
+        }
+        const content = fs.readFileSync(cachePath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        logger.warn('Failed to load cache', error);
+        return {};
+    }
+}
+function saveCache(cache) {
+    const cachePath = path.resolve(getCacheFile());
+    fs.mkdirSync(path.dirname(cachePath), { recursive: true });
+    fs.writeFileSync(cachePath, JSON.stringify(cache, null, 2));
+}
+function removeProjectCache() {
+    try {
+        const cachePath = path.resolve(getCacheFile());
+        if (fs.existsSync(cachePath)) {
+            fs.rmSync(cachePath, { recursive: true });
+        }
+    }
+    catch (error) {
+        throw new RockError(`Failed to remove cache for ${name}. If you experience any issues when running freshly initialized project, please remove the "${colorLink(path.join(getCacheFile()))}" folder manually.`, { cause: error });
+    }
+}
+function get(key) {
+    const cache = loadCache();
+    return cache[key];
+}
+function set(key, value) {
+    const cache = loadCache();
+    cache[key] = value;
+    saveCache(cache);
+}
+function remove(key) {
+    const cache = loadCache();
+    delete cache[key];
+    saveCache(cache);
+}
+export default {
+    get,
+    set,
+    remove,
+    removeProjectCache,
+    getCacheRootPath,
+};
+//# sourceMappingURL=cacheManager.js.map

package/dist/src/lib/cacheManager.js.map

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

package/dist/src/lib/color.d.ts

@@ -0,0 +1,3 @@
+import color from 'picocolors';
+export { color };
+export declare function colorLink(text: string): string;

package/dist/src/lib/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../../src/lib/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,UAErC"}

package/dist/src/lib/color.js

@@ -0,0 +1,6 @@
+import color from 'picocolors';
+export { color };
+export function colorLink(text) {
+    return color.cyan(color.underline(color.bold(text)));
+}
+//# sourceMappingURL=color.js.map

package/dist/src/lib/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../../src/lib/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAE/B,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist/src/lib/dev-server/findDevServerPort.d.ts

@@ -0,0 +1,4 @@
+export declare const findDevServerPort: (initialPort: number, root: string) => Promise<{
+    port: string;
+    startDevServer: boolean;
+}>;

package/dist/src/lib/dev-server/findDevServerPort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findDevServerPort.d.ts","sourceRoot":"","sources":["../../../../src/lib/dev-server/findDevServerPort.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,gBACf,MAAM,QACb,MAAM,KACX,OAAO,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;CACzB,CAuBA,CAAC"}