@rn-iso/core 1.3.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Janic Duplessis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,13 @@
+# @rn-iso/core
+
+The primitives [`rn-iso`](https://www.npmjs.com/package/rn-iso),
+[`@rn-iso/metro`](https://www.npmjs.com/package/@rn-iso/metro) and
+[`@rn-iso/expo-build-cache`](https://www.npmjs.com/package/@rn-iso/expo-build-cache)
+must agree on, implemented once: where the rn-iso config dir and the two
+shared caches live (env override > machine config > default), how a build
+cache key is derived, and how a cache registers itself for `rn-iso gc`.
+
+This is an internal dependency of those packages, not a user-facing API --
+install one of them instead. It is deliberately CJS with no dependencies, so
+a `metro.config.js` or an Expo build-cache provider can `require()` it on any
+supported Node.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+//#region index.d.ts
+declare function configDir(): string;
+declare function cachePathSetting(key: 'buildCache' | 'metroCache'): string | null;
+declare function cacheNameSegment(name: string | null | undefined): string;
+declare function buildCacheRoot(): string;
+declare function metroCacheRoot(name?: string | null): string;
+interface BuildRunOptions {
+  variant?: string;
+  configuration?: string;
+  buildConfiguration?: string;
+  isSimulator?: boolean;
+  device?: string | boolean | null;
+}
+declare function buildCacheKey(platform: string, fingerprintHash: string, options?: unknown): string;
+interface RegisterOptions {
+  dir: string;
+  name: string;
+  prune: string;
+  note: string;
+  entriesDepth?: number;
+}
+declare function registerCache({ dir, name, prune, note, entriesDepth }: RegisterOptions): void;
+//#endregion
+export { BuildRunOptions, RegisterOptions, buildCacheKey, buildCacheRoot, cacheNameSegment, cachePathSetting, configDir, metroCacheRoot, registerCache };

package/dist/index.js

@@ -0,0 +1,116 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
+let node_os = require("node:os");
+node_os = __toESM(node_os);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
+//#region index.ts
+function configDir() {
+	return process.env.RN_ISO_HOME || node_path.default.join(node_os.default.homedir(), ".rn-iso");
+}
+function cachePathSetting(key) {
+	try {
+		const value = JSON.parse(node_fs.default.readFileSync(node_path.default.join(configDir(), "config.json"), "utf-8"))?.caches?.[key];
+		return typeof value === "string" && value.startsWith("/") ? value : null;
+	} catch {
+		return null;
+	}
+}
+function cacheNameSegment(name) {
+	return String(name).replace(/[^A-Za-z0-9._-]+/g, "-").replace(/^\.+/, "") || "app";
+}
+function buildCacheRoot() {
+	return process.env.RN_ISO_BUILD_CACHE || cachePathSetting("buildCache") || node_path.default.join(configDir(), "build-cache");
+}
+function metroCacheRoot(name) {
+	const override = process.env.RN_ISO_METRO_CACHE || cachePathSetting("metroCache");
+	if (override) return override;
+	const root = node_path.default.join(configDir(), "metro-cache");
+	return name === void 0 || name === null || name === "" ? root : node_path.default.join(root, cacheNameSegment(name));
+}
+const SIMULATOR_UDID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const EMULATOR_SERIAL = /^emulator-\d+$/;
+function slug(value) {
+	return String(value).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function buildVariant(platform, options) {
+	const raw = platform === "android" ? options.variant : options.configuration ?? options.buildConfiguration;
+	return (typeof raw === "string" ? slug(raw) : "") || "debug";
+}
+function buildTarget(options) {
+	if (typeof options.isSimulator === "boolean") return options.isSimulator ? "sim" : "device";
+	const device = options.device;
+	if (device === void 0 || device === null || device === false) return "sim";
+	if (typeof device !== "string") return "prompted";
+	const name = device.trim();
+	if (name === "" || name === "generic") return "sim";
+	if (SIMULATOR_UDID.test(name) || EMULATOR_SERIAL.test(name)) return "sim";
+	return `on-${slug(name)}`;
+}
+function buildCacheKey(platform, fingerprintHash, options = {}) {
+	const opts = options && typeof options === "object" ? options : {};
+	return `${fingerprintHash}-${buildVariant(platform, opts)}-${buildTarget(opts)}`;
+}
+function registerCache({ dir, name, prune, note, entriesDepth }) {
+	try {
+		const home = configDir();
+		const file = node_path.default.join(home, "caches.json");
+		let manifest = {
+			version: 1,
+			caches: []
+		};
+		try {
+			const parsed = JSON.parse(node_fs.default.readFileSync(file, "utf-8"));
+			if (Array.isArray(parsed?.caches)) manifest = {
+				version: 1,
+				caches: parsed.caches
+			};
+		} catch {}
+		const others = manifest.caches.filter((c) => c.dir !== dir);
+		const record = {
+			dir,
+			name,
+			prune,
+			note,
+			registeredBy: process.cwd()
+		};
+		if (entriesDepth) record.entriesDepth = entriesDepth;
+		others.push(record);
+		node_fs.default.mkdirSync(home, { recursive: true });
+		node_fs.default.writeFileSync(file, JSON.stringify({
+			version: 1,
+			caches: others
+		}, null, 2));
+	} catch {}
+}
+//#endregion
+exports.buildCacheKey = buildCacheKey;
+exports.buildCacheRoot = buildCacheRoot;
+exports.cacheNameSegment = cacheNameSegment;
+exports.cachePathSetting = cachePathSetting;
+exports.configDir = configDir;
+exports.metroCacheRoot = metroCacheRoot;
+exports.registerCache = registerCache;

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@rn-iso/core",
+  "version": "1.3.3",
+  "description": "Shared primitives for rn-iso and its cache packages: config-dir and cache-root resolution, the build cache key, and cache self-registration. Not a user-facing API.",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsdown"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}