@stim-cli/metro 1.0.0-rc.9 → 1.1.0

package/README.md

@@ -3,7 +3,7 @@
 Optional Metro integration for Stim. It exports a transform cache shared across
 worktrees and an NDJSON reporter for structured Metro and client logs.
 
-If Stim is not installed globally, replace `stim` with `npx stim-cli`.
+If Stim is not installed globally, replace `stim` with `npx stim`.
 
 ```bash
 npm install --save-dev @stim-cli/metro
@@ -36,7 +36,8 @@ blocking Metro. Provider failures are misses.
 ```
 
 Under `stim start` the supervisor passes the resolved selection to Metro. A
-Metro process outside Stim reads the nearest committed `.stim.json`. See
+Metro process outside Stim reads `.stim.json` only from its app working directory;
+it does not inherit a monorepo-root provider. See
 [`@stim-cli/cache`](https://www.npmjs.com/package/@stim-cli/cache) for the
 provider contract. `clear()` only clears the local tier.
 
@@ -55,5 +56,5 @@ The reporter must be attached to the config passed directly to
 Stim supplies this integration automatically for Stim-managed servers. Add the
 package directly only for Metro processes that run outside Stim.
 
-See the [cache package documentation](https://appandflow.github.io/stim/docs/cache-packages)
+See the [cache package documentation](https://stim.appandflow.com/docs/cache-packages)
 for current usage and cleanup guidance.

package/dist/index.d.mts

@@ -18,7 +18,8 @@ interface MetroEvent {
   level?: unknown;
   data?: unknown;
   error?: unknown;
-  stack?: string;
+  stack?: unknown;
+  codeFrame?: unknown;
   buildID?: string;
   bundleDetails?: {
     platform?: string | null;

package/dist/index.mjs

@@ -22,37 +22,22 @@ function registerOnce(dir, replaces = []) {
 function isPlainObject(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function repositoryRoot(startDir) {
-	let dir = startDir;
-	for (;;) {
-		if (fs.existsSync(path.join(dir, ".git"))) return dir;
-		const parent = path.dirname(dir);
-		if (parent === dir) return null;
-		dir = parent;
-	}
-}
 function committedProviderConfig(startDir) {
-	const start = path.resolve(startDir);
-	const stop = repositoryRoot(start) ?? start;
-	let dir = start;
-	for (;;) {
-		let parsed;
-		try {
-			parsed = JSON.parse(fs.readFileSync(path.join(dir, ".stim.json"), "utf-8"));
-		} catch {
-			parsed = null;
-		}
-		const cache = isPlainObject(parsed) && isPlainObject(parsed.cache) ? parsed.cache : null;
-		const reference = cache?.provider;
-		if (typeof reference === "string" && reference.trim() !== "") return {
-			provider: reference.trim(),
-			options: isPlainObject(cache?.options) ? cache.options : {},
-			baseDir: dir
-		};
-		const parent = path.dirname(dir);
-		if (dir === stop || parent === dir) return null;
-		dir = parent;
+	let dir;
+	let parsed;
+	try {
+		dir = fs.realpathSync(startDir);
+		parsed = JSON.parse(fs.readFileSync(path.join(dir, ".stim.json"), "utf-8"));
+	} catch {
+		return null;
 	}
+	const cache = isPlainObject(parsed) && isPlainObject(parsed.cache) ? parsed.cache : null;
+	const reference = cache?.provider;
+	return typeof reference === "string" && reference.trim() !== "" ? {
+		provider: reference.trim(),
+		options: isPlainObject(cache?.options) ? cache.options : {},
+		baseDir: dir
+	} : null;
 }
 function warnToStderr(_code, message) {
 	process.stderr.write(`warning: ${message}\n`);
@@ -129,6 +114,23 @@ function errorMessage(error) {
 	if (typeof error.message === "string" && error.message) return error.message;
 	return formatValue(error);
 }
+function symbolicationMessage(codeFrame) {
+	if (!isPlainObject(codeFrame) || typeof codeFrame.content !== "string") return "Call Stack";
+	const fileName = typeof codeFrame.fileName === "string" ? codeFrame.fileName : "unknown source";
+	const location = isPlainObject(codeFrame.location) ? codeFrame.location : null;
+	return `Code: ${fileName}${typeof location?.row === "number" ? `:${location.row}` : ""}${typeof location?.column === "number" ? `:${location.column}` : ""}\n${codeFrame.content}\nCall Stack`;
+}
+function symbolicationStack(stack) {
+	if (!Array.isArray(stack)) return [];
+	return stack.filter((frame) => isPlainObject(frame) && frame.collapse !== true).map((frame) => {
+		const normalized = {};
+		if (typeof frame.file === "string") normalized.file = frame.file;
+		if (typeof frame.lineNumber === "number") normalized.line = frame.lineNumber;
+		if (typeof frame.column === "number") normalized.column = frame.column;
+		if (typeof frame.methodName === "string") normalized.fn = frame.methodName;
+		return normalized;
+	}).filter((frame) => Object.keys(frame).length > 0);
+}
 function ndjsonReporter({ dir } = {}) {
 	const logDir = dir || workspaceLogDir(process.cwd());
 	let ensured = false;
@@ -185,6 +187,16 @@ function ndjsonReporter({ dir } = {}) {
 				write("client.ndjson", record);
 				return;
 			}
+			if (type === "client_symbolication") {
+				const stack = symbolicationStack(event.stack);
+				if (!(isPlainObject(event.codeFrame) && typeof event.codeFrame.content === "string") && stack.length === 0) return;
+				record.src = "client";
+				record.level = "info";
+				record.msg = symbolicationMessage(event.codeFrame);
+				if (stack.length > 0) record.stack = stack;
+				write("client.ndjson", record);
+				return;
+			}
 			if (type === "bundling_error" || type === "transformer_error") {
 				record.level = "error";
 				record.msg = errorMessage(event.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stim-cli/metro",
-  "version": "1.0.0-rc.9",
+  "version": "1.1.0",
   "description": "Metro integration for Stim: shared transforms across worktrees and structured logs.",
   "license": "MIT",
   "repository": {
@@ -24,8 +24,8 @@
     }
   },
   "dependencies": {
-    "@stim-cli/cache": "^1.0.0-rc.9",
-    "@stim-cli/core": "^1.0.0-rc.9"
+    "@stim-cli/cache": "^1.1.0",
+    "@stim-cli/core": "^1.1.0"
   },
   "peerDependencies": {
     "metro-cache": "*"