@farmslot/adapter-rn 0.15.0 → 0.16.0

package/metro/metro-config.cjs

@@ -0,0 +1,92 @@
+'use strict';
+
+const fs = require('node:fs');
+const { createRequire } = require('node:module');
+const path = require('node:path');
+const { pathToFileURL } = require('node:url');
+
+function escapeRegExp(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+function appendBlockList(blockList, pattern) {
+  if (Array.isArray(blockList)) return [...blockList, pattern];
+  return blockList instanceof RegExp ? [blockList, pattern] : [pattern];
+}
+
+function blockListFlags(blockList) {
+  const first = Array.isArray(blockList) ? blockList[0] : blockList;
+  return first instanceof RegExp && first.ignoreCase ? 'i' : '';
+}
+
+function resolveExpoConfigLoader(projectRoot) {
+  const requireFromProject = createRequire(path.join(projectRoot, 'package.json'));
+  let requireUtilsPath;
+  try {
+    requireUtilsPath = requireFromProject.resolve('@expo/require-utils');
+  } catch (error) {
+    if (error?.code !== 'MODULE_NOT_FOUND') throw error;
+    return null;
+  }
+  const { loadModuleSync } = requireFromProject(requireUtilsPath);
+  return typeof loadModuleSync === 'function' ? loadModuleSync : null;
+}
+
+async function loadProductConfig(configPath, baseConfig, projectRoot) {
+  let loaded;
+  const expoConfigLoader = resolveExpoConfigLoader(projectRoot);
+  if (expoConfigLoader) {
+    loaded = expoConfigLoader(configPath);
+  } else {
+    try {
+      loaded = require(configPath);
+    } catch (error) {
+      if (error?.code !== 'ERR_REQUIRE_ESM') throw error;
+      loaded = await import(pathToFileURL(configPath).href);
+    }
+  }
+
+  const moduleValue = await loaded;
+  const exported =
+    moduleValue?.__esModule || moduleValue?.[Symbol.toStringTag] === 'Module'
+      ? moduleValue.default
+      : moduleValue;
+  const config = await exported;
+  return typeof config === 'function' ? config(baseConfig) : config;
+}
+
+module.exports = async function harnessMetroConfig(baseConfig) {
+  const projectRoot = path.resolve(process.env.RECIPE_RN_METRO_PROJECT_ROOT || process.cwd());
+  const productConfigPath = path.resolve(
+    process.env.RECIPE_RN_METRO_BASE_CONFIG || path.join(projectRoot, 'metro.config.js'),
+  );
+  if (productConfigPath === __filename) {
+    throw new Error(
+      'RECIPE_RN_METRO_BASE_CONFIG must reference the product Metro config, not the harness wrapper.',
+    );
+  }
+  let productConfig = baseConfig;
+  if (fs.existsSync(productConfigPath)) {
+    productConfig = await loadProductConfig(productConfigPath, baseConfig, projectRoot);
+  }
+
+  const tempRoot = path.join(projectRoot, 'temp');
+  const existingBlockList = productConfig.resolver?.blockList ?? baseConfig.resolver?.blockList;
+  const tempPattern = new RegExp(
+    `^${escapeRegExp(tempRoot)}(?:${escapeRegExp(path.sep)}|$)`,
+    blockListFlags(existingBlockList),
+  );
+  // Inline environment values affect transformed JavaScript. Keep separate
+  // cache generations for those inputs instead of deleting the shared cache.
+  const envFingerprint = process.env.RECIPE_RN_METRO_ENV_FINGERPRINT;
+  return {
+    ...productConfig,
+    ...(envFingerprint
+      ? { cacheVersion: `${productConfig.cacheVersion ?? ''}:mm-env:${envFingerprint}` }
+      : {}),
+    resolver: {
+      ...productConfig.resolver,
+      blockList: appendBlockList(existingBlockList, tempPattern),
+    },
+  };
+};

package/metro/metro-log-generation.cjs

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+
+const generationIdPattern = /^[A-Za-z0-9-]+$/u;
+
+function archiveGenerationId(name) {
+  if (!name.startsWith('metro.') || !name.endsWith('.log')) return null;
+  const generationId = name.slice('metro.'.length, -'.log'.length);
+  return generationIdPattern.test(generationId) ? generationId : null;
+}
+
+function positiveInteger(name, fallback) {
+  const raw = process.env[name];
+  if (raw === undefined || raw === '') return fallback;
+  if (!/^[1-9][0-9]*$/u.test(raw)) throw new Error(`${name} must be a positive integer`);
+  return Number(raw);
+}
+
+function main() {
+  const runtimeArg = process.argv[2];
+  const port = process.argv[3];
+  const reason = process.argv[4];
+  if (!runtimeArg || !/^[1-9][0-9]*$/u.test(port ?? '') || !reason) {
+    throw new Error('usage: metro-log-generation.cjs <runtime-dir> <port> <reason>');
+  }
+  const runtimeDir = fs.realpathSync(runtimeArg);
+  const activeLog = path.join(runtimeDir, 'metro.log');
+  const evidenceFile = path.join(runtimeDir, 'metro-generation.json');
+  const maxArchives = positiveInteger('RECIPE_RN_METRO_LOG_ARCHIVE_COUNT', 4);
+  const maxArchiveBytes = positiveInteger('RECIPE_RN_METRO_LOG_ARCHIVE_BYTES', 8 * 1024 * 1024);
+  const generationId = `${new Date().toISOString().replace(/[-:.]/gu, '')}-${port}-${process.pid}-${crypto.randomBytes(4).toString('hex')}`;
+  if (!generationIdPattern.test(generationId))
+    throw new Error('generated Metro log identity is invalid');
+  let rotatedLog = null;
+
+  rotatedLog = path.join(runtimeDir, `metro.${generationId}.log`);
+  try {
+    fs.renameSync(activeLog, rotatedLog);
+    const stat = fs.lstatSync(rotatedLog);
+    if (!stat.isFile()) {
+      fs.renameSync(rotatedLog, activeLog);
+      throw new Error('metro.log must be a regular file');
+    }
+  } catch (error) {
+    if (error && error.code === 'ENOENT') rotatedLog = null;
+    else throw error;
+  }
+  try {
+    fs.closeSync(fs.openSync(activeLog, 'wx', 0o600));
+  } catch (error) {
+    if (error && error.code === 'EEXIST')
+      throw new Error('another Metro generation recreated metro.log; refusing to truncate it');
+    throw error;
+  }
+
+  const archives = fs
+    .readdirSync(runtimeDir)
+    .filter((name) => archiveGenerationId(name) !== null)
+    .map((name) => {
+      const file = path.join(runtimeDir, name);
+      const stat = fs.lstatSync(file);
+      if (!stat.isFile()) return null;
+      return { file, size: stat.size, mtimeMs: stat.mtimeMs };
+    })
+    .filter(Boolean)
+    .sort((left, right) => right.mtimeMs - left.mtimeMs || right.file.localeCompare(left.file));
+
+  let retainedBytes = 0;
+  let retainedCount = 0;
+  const retained = [];
+  const removed = [];
+  for (const archive of archives) {
+    if (retainedCount < maxArchives && retainedBytes + archive.size <= maxArchiveBytes) {
+      retained.push(archive.file);
+      retainedCount += 1;
+      retainedBytes += archive.size;
+      continue;
+    }
+    fs.unlinkSync(archive.file);
+    removed.push({
+      path: archive.file,
+      size: archive.size,
+      reason: retainedCount >= maxArchives ? 'count-limit' : 'size-limit',
+    });
+  }
+
+  const evidence = {
+    schemaVersion: 1,
+    generationId,
+    port: Number(port),
+    startedAt: new Date().toISOString(),
+    currentLog: activeLog,
+    rotatedLog: rotatedLog && fs.existsSync(rotatedLog) ? rotatedLog : null,
+    archivedLogs: retained,
+    rotationReason: reason,
+    retention: { maxArchives, maxArchiveBytes, retainedBytes, removed },
+  };
+  const temporary = `${evidenceFile}.${process.pid}.tmp`;
+  fs.writeFileSync(temporary, `${JSON.stringify(evidence, null, 2)}\n`, {
+    mode: 0o600,
+    flag: 'wx',
+  });
+  fs.renameSync(temporary, evidenceFile);
+  process.stdout.write(`${JSON.stringify(evidence)}\n`);
+}
+
+try {
+  main();
+} catch (error) {
+  console.error(`metro-log-generation: ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farmslot/adapter-rn",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -12,23 +12,39 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
-    }
+    },
+    "./bridge-runtime/lib/bridge-errors.cjs": "./bridge-runtime/lib/bridge-errors.cjs",
+    "./bridge-runtime/lib/cdp-eval.cjs": "./bridge-runtime/lib/cdp-eval.cjs",
+    "./bridge-runtime/lib/config.cjs": "./bridge-runtime/lib/config.cjs",
+    "./bridge-runtime/lib/console-format.cjs": "./bridge-runtime/lib/console-format.cjs",
+    "./bridge-runtime/lib/devtools-proxy.cjs": "./bridge-runtime/lib/devtools-proxy.cjs",
+    "./bridge-runtime/lib/issue-capture.cjs": "./bridge-runtime/lib/issue-capture.cjs",
+    "./bridge-runtime/lib/match-bridge-target.cjs": "./bridge-runtime/lib/match-bridge-target.cjs",
+    "./bridge-runtime/lib/target-discovery.cjs": "./bridge-runtime/lib/target-discovery.cjs",
+    "./bridge-runtime/lib/ws-client.cjs": "./bridge-runtime/lib/ws-client.cjs",
+    "./bridge-runtime/console-forwarder.cjs": "./bridge-runtime/console-forwarder.cjs",
+    "./metro/coalesce-metro-log.cjs": "./metro/coalesce-metro-log.cjs",
+    "./metro/launch-metro.cjs": "./metro/launch-metro.cjs",
+    "./metro/metro-config.cjs": "./metro/metro-config.cjs",
+    "./metro/metro-log-generation.cjs": "./metro/metro-log-generation.cjs",
+    "./package.json": "./package.json"
   },
   "scripts": {
     "typecheck": "tsc --noEmit --project tsconfig.json",
     "build": "yarn workspace @farmslot/protocol build && yarn workspace @farmslot/recipe-runner build && rm -rf dist && tsc --project tsconfig.build.json",
-    "test": "tsx --tsconfig tsconfig.json --test src/agent-device-ui-transport.test.ts src/adapter-rn.test.ts src/metro-recipe-bridge-transport.test.ts",
+    "test": "node ../../scripts/quality/run-tsx-tests.mjs --cwd . --tsconfig tsconfig.json src/agent-device-ui-transport.test.ts src/adapter-rn.test.ts src/metro-recipe-bridge-transport.test.ts test",
     "format": "prettier --write --ignore-path ../../.prettierignore .",
     "format:check": "prettier --check --ignore-path ../../.prettierignore .",
     "lint": "eslint \"src/**/*.ts\" \"templates/src/farmslot/**/*.{ts,tsx}\"",
-    "quality": "prettier --check --ignore-path ../../.prettierignore . && eslint \"src/**/*.ts\" \"templates/src/farmslot/**/*.{ts,tsx}\" && tsc --noEmit --project tsconfig.json && yarn build && yarn test",
+    "quality": "prettier --check --ignore-path ../../.prettierignore . && eslint \"src/**/*.ts\" \"test/**/*.ts\" \"templates/src/farmslot/**/*.{ts,tsx}\" && tsc --noEmit --project tsconfig.json && yarn build && yarn test",
     "prepack": "yarn build",
     "prepublishOnly": "node ../../scripts/quality/check-farmslot-package-readiness.mjs --publish --packages @farmslot/adapter-rn"
   },
   "dependencies": {
     "@farmslot/protocol": "0.34.0",
-    "@farmslot/recipe-runner": "0.23.0",
-    "pngjs": "^7.0.0"
+    "@farmslot/recipe-runner": "0.24.0",
+    "pngjs": "^7.0.0",
+    "ws": "^8.18.0"
   },
   "peerDependencies": {
     "agent-device": ">=0.19.3"
@@ -41,6 +57,7 @@
   "devDependencies": {
     "@types/node": "^22.0.0",
     "@types/pngjs": "^6.0.5",
+    "@types/ws": "^8.5.12",
     "agent-device": "0.19.3",
     "eslint": "^10.3.0",
     "prettier": "^3.8.3",
@@ -73,7 +90,9 @@
     "dist/**/*.d.ts",
     "dist/**/*.d.ts.map",
     "dist/**/*.js.map",
-    "templates/**/*"
+    "templates/**/*",
+    "bridge-runtime/**/*.cjs",
+    "metro/*.cjs"
   ],
   "publishConfig": {
     "access": "public"