universal-logs 0.1.0

package/README.md

@@ -0,0 +1,125 @@
+# universal-logs
+
+`universal-logs` is a small npm package with two parts:
+
+- A CLI that reads logs from HTTP endpoints or React Native Metro
+- Runtime helpers that expose HTTP log snapshots from Node or Electron apps
+
+## CLI
+
+Run against a named target from config:
+
+```bash
+npx universal-logs electron --limit 80
+```
+
+Run against an explicit endpoint:
+
+```bash
+npx universal-logs --endpoint http://127.0.0.1:6973/logs --limit 80
+```
+
+Read live React Native logs from Metro:
+
+```bash
+npx universal-logs metro --app com.fieldy --limit 80 --timeout 5000
+```
+
+List configured targets:
+
+```bash
+npx universal-logs list
+```
+
+## Config
+
+Create `universal-logs.config.json` in your repo:
+
+```json
+{
+  "targets": {
+    "electron": {
+      "endpoint": "http://127.0.0.1:6973/logs"
+    },
+    "api": {
+      "endpoint": "http://127.0.0.1:6971/logs"
+    },
+    "native": {
+      "provider": "metro",
+      "metroUrl": "http://127.0.0.1:8081",
+      "app": "com.fieldy",
+      "timeoutMs": 5000
+    }
+  }
+}
+```
+
+The CLI also reads `package.json` from a top-level `universalLogs` field.
+
+Configured Metro targets work like any other target:
+
+```bash
+npx universal-logs native --limit 80
+```
+
+Metro is a live stream, not a snapshot. The CLI listens for new console events until it reaches `--limit` or `--timeout`.
+
+## Runtime
+
+Expose a log buffer from a Node process:
+
+```ts
+import {
+  createConsoleMirror,
+  createLogBuffer,
+  startHttpLogEndpoint,
+} from "universal-logs/runtime"
+
+const buffer = createLogBuffer({ limit: 500 })
+createConsoleMirror({ buffer, source: "api" })
+
+await startHttpLogEndpoint({
+  buffer,
+  port: 6971,
+  service: "api",
+})
+```
+
+Attach renderer logs in Electron:
+
+```ts
+import {
+  attachElectronRendererConsoleMirror,
+  createLogBuffer,
+} from "universal-logs/runtime"
+
+const buffer = createLogBuffer()
+app.on("browser-window-created", (_event, window) => {
+  attachElectronRendererConsoleMirror({
+    buffer,
+    webContents: window.webContents,
+  })
+})
+```
+
+Metro support does not need a runtime helper. It attaches to Metro's inspector endpoints at `/json/list` and `/json`, then listens for `Runtime.consoleAPICalled` over CDP.
+
+## Response shape
+
+`GET /logs?limit=100` returns:
+
+```json
+{
+  "service": "electron",
+  "limit": 100,
+  "total": 42,
+  "entries": [
+    {
+      "timestamp": "2026-04-03T10:00:00.000Z",
+      "level": "info",
+      "source": "desktop:renderer",
+      "message": "hello"
+    }
+  ]
+}
+```

package/dist/chunk-IUSSBPEQ.js

@@ -0,0 +1,198 @@
+// src/runtime/console-mirror.ts
+import util from "util";
+var consoleMethodLevels = {
+  debug: "debug",
+  error: "error",
+  info: "info",
+  log: "info",
+  trace: "trace",
+  warn: "warn"
+};
+function createConsoleMirror(options) {
+  const { buffer, consoleObject = console, source = "console" } = options;
+  const originals = /* @__PURE__ */ new Map();
+  const consoleTarget = consoleObject;
+  for (const method of Object.keys(
+    consoleMethodLevels
+  )) {
+    originals.set(method, consoleTarget[method].bind(consoleObject));
+    const level = consoleMethodLevels[method];
+    consoleTarget[method] = (...args) => {
+      buffer.append({
+        level,
+        message: util.formatWithOptions(
+          {
+            colors: false,
+            depth: 5,
+            maxArrayLength: 50
+          },
+          ...args
+        ),
+        source,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+      const original = originals.get(method);
+      if (original) {
+        original(...args);
+      }
+    };
+  }
+  return {
+    restore() {
+      for (const method of Object.keys(
+        consoleMethodLevels
+      )) {
+        const original = originals.get(method);
+        if (original) {
+          consoleTarget[method] = original;
+        }
+      }
+    }
+  };
+}
+
+// src/runtime/electron.ts
+function attachElectronRendererConsoleMirror(options) {
+  const { buffer, source = "electron:renderer", webContents } = options;
+  webContents.on(
+    "console-message",
+    (_event, level, message, line, sourceId) => {
+      const location = sourceId.length > 0 ? ` (${sourceId}${line > 0 ? `:${line}` : ""})` : "";
+      buffer.append({
+        level: normalizeElectronLogLevel(level),
+        message: `${message}${location}`,
+        source,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  );
+}
+function normalizeElectronLogLevel(level) {
+  if (level >= 3) {
+    return "error";
+  }
+  if (level === 2) {
+    return "warn";
+  }
+  if (level === 0) {
+    return "debug";
+  }
+  return "info";
+}
+
+// src/runtime/http-endpoint.ts
+import http from "http";
+var DEFAULT_LIMIT = 200;
+var MAX_LIMIT = 500;
+async function startHttpLogEndpoint(options) {
+  const {
+    buffer,
+    healthPath = "/health",
+    host = "127.0.0.1",
+    logsPath = "/logs",
+    port,
+    service
+  } = options;
+  const server = http.createServer((req, res) => {
+    const requestUrl = new URL(req.url ?? "/", `http://${host}:${port}`);
+    if (req.method === "GET" && requestUrl.pathname === healthPath) {
+      writeJson(res, 200, { service, status: "ok" });
+      return;
+    }
+    if (req.method === "GET" && requestUrl.pathname === logsPath) {
+      const limit = normalizeLimit(requestUrl.searchParams.get("limit"));
+      writeJson(res, 200, buffer.getSnapshot(service, limit));
+      return;
+    }
+    writeJson(res, 404, { error: "Not Found" });
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(port, host, () => {
+      server.off("error", reject);
+      resolve();
+    });
+  });
+  const address = server.address();
+  const addressHost = address?.address ?? host;
+  const addressPort = address?.port ?? port;
+  const url = `http://${addressHost}:${addressPort}${logsPath}`;
+  return {
+    async close() {
+      await new Promise((resolve, reject) => {
+        server.close((error) => {
+          if (error) {
+            reject(error);
+            return;
+          }
+          resolve();
+        });
+      });
+    },
+    server,
+    url
+  };
+}
+function normalizeLimit(limitParam) {
+  const raw = Number(limitParam ?? DEFAULT_LIMIT);
+  if (!Number.isFinite(raw) || raw <= 0) {
+    return DEFAULT_LIMIT;
+  }
+  return Math.min(MAX_LIMIT, Math.floor(raw));
+}
+function writeJson(response, statusCode, payload) {
+  response.writeHead(statusCode, {
+    "Cache-Control": "no-store",
+    "Content-Type": "application/json"
+  });
+  response.end(JSON.stringify(payload));
+}
+
+// src/runtime/log-buffer.ts
+var DEFAULT_BUFFER_LIMIT = 1e3;
+var DEFAULT_SNAPSHOT_LIMIT = 200;
+function createLogBuffer(options = {}) {
+  const bufferLimit = normalizePositiveInt(options.limit, DEFAULT_BUFFER_LIMIT);
+  const entries = [];
+  return {
+    append(entry) {
+      entries.push(entry);
+      if (entries.length > bufferLimit) {
+        entries.splice(0, entries.length - bufferLimit);
+      }
+    },
+    clear() {
+      entries.length = 0;
+    },
+    getEntries(limit = DEFAULT_SNAPSHOT_LIMIT) {
+      const snapshotLimit = normalizePositiveInt(limit, DEFAULT_SNAPSHOT_LIMIT);
+      return entries.slice(Math.max(0, entries.length - snapshotLimit));
+    },
+    getSnapshot(service, limit = DEFAULT_SNAPSHOT_LIMIT) {
+      const snapshotLimit = normalizePositiveInt(limit, DEFAULT_SNAPSHOT_LIMIT);
+      return {
+        entries: this.getEntries(snapshotLimit),
+        limit: snapshotLimit,
+        service,
+        total: entries.length
+      };
+    },
+    size() {
+      return entries.length;
+    }
+  };
+}
+function normalizePositiveInt(value, fallback) {
+  if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
+    return fallback;
+  }
+  return Math.floor(value);
+}
+
+export {
+  createConsoleMirror,
+  attachElectronRendererConsoleMirror,
+  startHttpLogEndpoint,
+  createLogBuffer
+};
+//# sourceMappingURL=chunk-IUSSBPEQ.js.map

package/dist/chunk-IUSSBPEQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/console-mirror.ts","../src/runtime/electron.ts","../src/runtime/http-endpoint.ts","../src/runtime/log-buffer.ts"],"sourcesContent":["import util from \"node:util\"\nimport type { LogBuffer, UniversalLogLevel } from \"./types\"\n\nconst consoleMethodLevels = {\n  debug: \"debug\",\n  error: \"error\",\n  info: \"info\",\n  log: \"info\",\n  trace: \"trace\",\n  warn: \"warn\",\n} as const\n\ntype ConsoleMethodName = keyof typeof consoleMethodLevels\n\nexport function createConsoleMirror(options: {\n  buffer: LogBuffer\n  consoleObject?: Console\n  source?: string\n}): { restore: () => void } {\n  const { buffer, consoleObject = console, source = \"console\" } = options\n  const originals = new Map<ConsoleMethodName, (...args: unknown[]) => void>()\n  const consoleTarget = consoleObject as Console &\n    Record<ConsoleMethodName, (...args: unknown[]) => void>\n\n  for (const method of Object.keys(\n    consoleMethodLevels,\n  ) as ConsoleMethodName[]) {\n    originals.set(method, consoleTarget[method].bind(consoleObject))\n    const level = consoleMethodLevels[method] satisfies UniversalLogLevel\n\n    consoleTarget[method] = (...args: unknown[]): void => {\n      buffer.append({\n        level,\n        message: util.formatWithOptions(\n          {\n            colors: false,\n            depth: 5,\n            maxArrayLength: 50,\n          },\n          ...args,\n        ),\n        source,\n        timestamp: new Date().toISOString(),\n      })\n\n      const original = originals.get(method)\n      if (original) {\n        original(...args)\n      }\n    }\n  }\n\n  return {\n    restore(): void {\n      for (const method of Object.keys(\n        consoleMethodLevels,\n      ) as ConsoleMethodName[]) {\n        const original = originals.get(method)\n        if (original) {\n          consoleTarget[method] = original\n        }\n      }\n    },\n  }\n}\n","import type { LogBuffer, UniversalLogLevel } from \"./types\"\n\ntype ElectronConsoleMessageSource = {\n  on: (\n    event: \"console-message\",\n    listener: (\n      event: unknown,\n      level: number,\n      message: string,\n      line: number,\n      sourceId: string,\n    ) => void,\n  ) => void\n}\n\nexport function attachElectronRendererConsoleMirror(options: {\n  buffer: LogBuffer\n  source?: string\n  webContents: ElectronConsoleMessageSource\n}): void {\n  const { buffer, source = \"electron:renderer\", webContents } = options\n\n  webContents.on(\n    \"console-message\",\n    (_event, level, message, line, sourceId) => {\n      const location =\n        sourceId.length > 0 ? ` (${sourceId}${line > 0 ? `:${line}` : \"\"})` : \"\"\n\n      buffer.append({\n        level: normalizeElectronLogLevel(level),\n        message: `${message}${location}`,\n        source,\n        timestamp: new Date().toISOString(),\n      })\n    },\n  )\n}\n\nfunction normalizeElectronLogLevel(level: number): UniversalLogLevel {\n  if (level >= 3) {\n    return \"error\"\n  }\n\n  if (level === 2) {\n    return \"warn\"\n  }\n\n  if (level === 0) {\n    return \"debug\"\n  }\n\n  return \"info\"\n}\n","import http from \"node:http\"\nimport type { AddressInfo } from \"node:net\"\nimport type { LogBuffer, UniversalLogSnapshot } from \"./types\"\n\nconst DEFAULT_LIMIT = 200\nconst MAX_LIMIT = 500\n\nexport async function startHttpLogEndpoint(options: {\n  buffer: LogBuffer\n  healthPath?: string\n  host?: string\n  logsPath?: string\n  port: number\n  service: string\n}): Promise<{\n  close: () => Promise<void>\n  server: http.Server\n  url: string\n}> {\n  const {\n    buffer,\n    healthPath = \"/health\",\n    host = \"127.0.0.1\",\n    logsPath = \"/logs\",\n    port,\n    service,\n  } = options\n\n  const server = http.createServer((req, res) => {\n    const requestUrl = new URL(req.url ?? \"/\", `http://${host}:${port}`)\n\n    if (req.method === \"GET\" && requestUrl.pathname === healthPath) {\n      writeJson(res, 200, { service, status: \"ok\" })\n      return\n    }\n\n    if (req.method === \"GET\" && requestUrl.pathname === logsPath) {\n      const limit = normalizeLimit(requestUrl.searchParams.get(\"limit\"))\n      writeJson(res, 200, buffer.getSnapshot(service, limit))\n      return\n    }\n\n    writeJson(res, 404, { error: \"Not Found\" })\n  })\n\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject)\n    server.listen(port, host, () => {\n      server.off(\"error\", reject)\n      resolve()\n    })\n  })\n\n  const address = server.address() as AddressInfo | null\n  const addressHost = address?.address ?? host\n  const addressPort = address?.port ?? port\n  const url = `http://${addressHost}:${addressPort}${logsPath}`\n\n  return {\n    async close(): Promise<void> {\n      await new Promise<void>((resolve, reject) => {\n        server.close((error) => {\n          if (error) {\n            reject(error)\n            return\n          }\n\n          resolve()\n        })\n      })\n    },\n    server,\n    url,\n  }\n}\n\nfunction normalizeLimit(limitParam: string | null): number {\n  const raw = Number(limitParam ?? DEFAULT_LIMIT)\n  if (!Number.isFinite(raw) || raw <= 0) {\n    return DEFAULT_LIMIT\n  }\n\n  return Math.min(MAX_LIMIT, Math.floor(raw))\n}\n\nfunction writeJson(\n  response: http.ServerResponse,\n  statusCode: number,\n  payload:\n    | UniversalLogSnapshot\n    | { error: string }\n    | { service: string; status: string },\n): void {\n  response.writeHead(statusCode, {\n    \"Cache-Control\": \"no-store\",\n    \"Content-Type\": \"application/json\",\n  })\n  response.end(JSON.stringify(payload))\n}\n","import type {\n  LogBuffer,\n  UniversalLogEntry,\n  UniversalLogSnapshot,\n} from \"./types\"\n\nconst DEFAULT_BUFFER_LIMIT = 1000\nconst DEFAULT_SNAPSHOT_LIMIT = 200\n\nexport function createLogBuffer(options: { limit?: number } = {}): LogBuffer {\n  const bufferLimit = normalizePositiveInt(options.limit, DEFAULT_BUFFER_LIMIT)\n  const entries: UniversalLogEntry[] = []\n\n  return {\n    append(entry): void {\n      entries.push(entry)\n\n      if (entries.length > bufferLimit) {\n        entries.splice(0, entries.length - bufferLimit)\n      }\n    },\n    clear(): void {\n      entries.length = 0\n    },\n    getEntries(limit = DEFAULT_SNAPSHOT_LIMIT): UniversalLogEntry[] {\n      const snapshotLimit = normalizePositiveInt(limit, DEFAULT_SNAPSHOT_LIMIT)\n      return entries.slice(Math.max(0, entries.length - snapshotLimit))\n    },\n    getSnapshot(\n      service: string,\n      limit = DEFAULT_SNAPSHOT_LIMIT,\n    ): UniversalLogSnapshot {\n      const snapshotLimit = normalizePositiveInt(limit, DEFAULT_SNAPSHOT_LIMIT)\n\n      return {\n        entries: this.getEntries(snapshotLimit),\n        limit: snapshotLimit,\n        service,\n        total: entries.length,\n      }\n    },\n    size(): number {\n      return entries.length\n    },\n  }\n}\n\nfunction normalizePositiveInt(\n  value: number | undefined,\n  fallback: number,\n): number {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    return fallback\n  }\n\n  return Math.floor(value)\n}\n"],"mappings":"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","names":[]}

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,670 @@
+#!/usr/bin/env node
+
+// src/lib/config.ts
+import fs from "fs";
+import path from "path";
+var CONFIG_FILE_NAME = "universal-logs.config.json";
+function findConfigPath(cwd) {
+  let currentDir = path.resolve(cwd);
+  while (true) {
+    const configPath = path.join(currentDir, CONFIG_FILE_NAME);
+    if (fs.existsSync(configPath)) {
+      return configPath;
+    }
+    const packageJsonPath = path.join(currentDir, "package.json");
+    if (fs.existsSync(packageJsonPath)) {
+      const packageJson = JSON.parse(
+        fs.readFileSync(packageJsonPath, "utf8")
+      );
+      if (packageJson.universalLogs) {
+        return packageJsonPath;
+      }
+    }
+    const parentDir = path.dirname(currentDir);
+    if (parentDir === currentDir) {
+      return null;
+    }
+    currentDir = parentDir;
+  }
+}
+function loadConfig(options = {}) {
+  const { configPath, cwd = process.cwd() } = options;
+  const resolvedPath = configPath ? path.resolve(cwd, configPath) : findConfigPath(cwd);
+  if (!resolvedPath) {
+    return null;
+  }
+  if (path.basename(resolvedPath) === "package.json") {
+    const packageJson = JSON.parse(fs.readFileSync(resolvedPath, "utf8"));
+    if (!packageJson.universalLogs) {
+      throw new Error(`No universalLogs field found in ${resolvedPath}`);
+    }
+    return validateConfig(packageJson.universalLogs, resolvedPath);
+  }
+  const parsed = JSON.parse(
+    fs.readFileSync(resolvedPath, "utf8")
+  );
+  return validateConfig(parsed, resolvedPath);
+}
+function validateConfig(config, sourcePath) {
+  if (!config || typeof config !== "object" || !config.targets) {
+    throw new Error(`Invalid config in ${sourcePath}: missing targets object`);
+  }
+  const targets = Object.fromEntries(
+    Object.entries(config.targets).map(([name, target]) => [
+      name,
+      validateTarget(name, target, sourcePath)
+    ])
+  );
+  return {
+    targets
+  };
+}
+function validateTarget(name, target, sourcePath) {
+  if (!target || typeof target !== "object") {
+    throw new Error(`Invalid target "${name}" in ${sourcePath}`);
+  }
+  if (target.provider === "metro") {
+    if (target.app !== void 0 && typeof target.app !== "string") {
+      throw new Error(`Invalid target "${name}" in ${sourcePath}: invalid app`);
+    }
+    if (target.metroUrl !== void 0 && typeof target.metroUrl !== "string") {
+      throw new Error(
+        `Invalid target "${name}" in ${sourcePath}: invalid metroUrl`
+      );
+    }
+    if (target.timeoutMs !== void 0 && (!Number.isFinite(target.timeoutMs) || target.timeoutMs <= 0)) {
+      throw new Error(
+        `Invalid target "${name}" in ${sourcePath}: invalid timeoutMs`
+      );
+    }
+    return target;
+  }
+  if (target.provider !== void 0 && target.provider !== "endpoint") {
+    throw new Error(
+      `Invalid target "${name}" in ${sourcePath}: unsupported provider`
+    );
+  }
+  if (typeof target.endpoint !== "string") {
+    throw new Error(
+      `Invalid target "${name}" in ${sourcePath}: missing endpoint`
+    );
+  }
+  if (target.headers !== void 0 && !isStringRecord(target.headers)) {
+    throw new Error(
+      `Invalid target "${name}" in ${sourcePath}: invalid headers`
+    );
+  }
+  return target;
+}
+function isStringRecord(value) {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  return Object.values(value).every((entry) => typeof entry === "string");
+}
+
+// src/lib/fetch-logs.ts
+async function fetchLogs(options) {
+  const { endpoint, headers, limit } = options;
+  const url = new URL(endpoint);
+  url.searchParams.set("limit", String(limit));
+  let response;
+  try {
+    response = await fetch(url, {
+      headers
+    });
+  } catch (error) {
+    throw new Error(
+      `Failed to fetch logs from ${url.origin}${url.pathname}: ${formatFetchError(error)}`
+    );
+  }
+  if (!response.ok) {
+    throw new Error(
+      `Endpoint returned ${response.status} ${response.statusText}`
+    );
+  }
+  return await response.json();
+}
+function formatFetchError(error) {
+  if (!(error instanceof Error)) {
+    return String(error);
+  }
+  const cause = error.cause;
+  if (cause instanceof Error && cause.message) {
+    return cause.message;
+  }
+  if (cause && typeof cause === "object" && "code" in cause && typeof cause.code === "string") {
+    return cause.code;
+  }
+  return error.message;
+}
+
+// src/lib/fetch-metro-logs.ts
+import WebSocket from "ws";
+var DEFAULT_METRO_URL = "http://127.0.0.1:8081";
+var DEFAULT_METRO_TIMEOUT_MS = 5e3;
+async function fetchMetroLogs(options) {
+  const metroOrigin = getMetroServerOrigin(options.metroUrl);
+  const apps = await fetchMetroInspectorApps(metroOrigin);
+  if (apps.length === 0) {
+    const status = await fetchMetroStatus(metroOrigin);
+    if (status?.includes("packager-status:running")) {
+      throw new Error(
+        `Metro is running at ${metroOrigin}, but no React Native inspector apps are connected. Open the app on a simulator/device and make sure it is using this Metro server.`
+      );
+    }
+    throw new Error(
+      `No supported React Native inspector apps found at ${metroOrigin}`
+    );
+  }
+  const app = selectMetroInspectorApp(apps, options.app);
+  const entries = await captureMetroConsoleLogs({
+    app,
+    limit: options.limit,
+    timeoutMs: options.timeoutMs ?? DEFAULT_METRO_TIMEOUT_MS
+  });
+  return {
+    entries,
+    limit: options.limit,
+    service: options.service ?? app.appId ?? "metro",
+    total: entries.length
+  };
+}
+function getMetroServerOrigin(rawMetroUrl) {
+  const input = rawMetroUrl?.trim() || DEFAULT_METRO_URL;
+  const hasScheme = /^[a-z][a-z0-9+.-]*:\/\//i.test(input);
+  const url = hasScheme ? new URL(input) : new URL(`http://${input}`);
+  if (!url.port) {
+    url.port = "8081";
+  }
+  return url.origin;
+}
+function formatMetroTarget(target) {
+  const parts = ["metro", getMetroServerOrigin(target.metroUrl)];
+  if (target.app) {
+    parts.push(`app=${target.app}`);
+  }
+  if (target.timeoutMs) {
+    parts.push(`timeout=${target.timeoutMs}ms`);
+  }
+  return parts.join("	");
+}
+async function fetchMetroInspectorApps(metroOrigin) {
+  const endpoints = ["/json/list", "/json"];
+  let lastError = null;
+  for (const endpoint of endpoints) {
+    try {
+      const response = await fetch(`${metroOrigin}${endpoint}`);
+      if (!response.ok) {
+        continue;
+      }
+      const data = await response.json();
+      if (!Array.isArray(data)) {
+        continue;
+      }
+      const apps = [...data].reverse().filter(isSupportedMetroApp);
+      if (apps.length > 0) {
+        return apps;
+      }
+      return [...data].reverse().filter(hasDebuggerUrl);
+    } catch (error) {
+      lastError = normalizeError(error);
+    }
+  }
+  if (lastError) {
+    throw new Error(
+      `Failed to query Metro inspector at ${metroOrigin}: ${lastError.message}`
+    );
+  }
+  return [];
+}
+async function fetchMetroStatus(metroOrigin) {
+  try {
+    const response = await fetch(`${metroOrigin}/status`);
+    if (!response.ok) {
+      return null;
+    }
+    return await response.text();
+  } catch {
+    return null;
+  }
+}
+function isSupportedMetroApp(app) {
+  if (!hasDebuggerUrl(app)) {
+    return false;
+  }
+  return app.title === "React Native Experimental (Improved Chrome Reloads)" || app.reactNative?.capabilities?.nativePageReloads === true;
+}
+function hasDebuggerUrl(app) {
+  return Boolean(
+    app && typeof app === "object" && "id" in app && "title" in app && "webSocketDebuggerUrl" in app && typeof app.id === "string" && typeof app.title === "string" && typeof app.webSocketDebuggerUrl === "string"
+  );
+}
+function selectMetroInspectorApp(apps, selector) {
+  if (!selector) {
+    if (apps.length === 1) {
+      return apps[0];
+    }
+    throw new Error(
+      `Multiple Metro apps found. Pass --app. Available: ${apps.map(formatMetroApp).join(", ")}`
+    );
+  }
+  const normalizedSelector = selector.trim().toLowerCase();
+  const matches = apps.filter((app) => {
+    return [app.id, app.appId, app.deviceName].filter((value) => Boolean(value)).some((value) => value.toLowerCase() === normalizedSelector);
+  });
+  if (matches.length === 1) {
+    return matches[0];
+  }
+  if (matches.length > 1) {
+    throw new Error(
+      `Multiple Metro apps match "${selector}". Available: ${apps.map(formatMetroApp).join(", ")}`
+    );
+  }
+  throw new Error(
+    `No Metro app matched "${selector}". Available: ${apps.map(formatMetroApp).join(", ")}`
+  );
+}
+async function captureMetroConsoleLogs(options) {
+  const { app, limit, timeoutMs } = options;
+  return new Promise((resolve, reject) => {
+    const entries = [];
+    let settled = false;
+    let opened = false;
+    const socket = new WebSocket(app.webSocketDebuggerUrl);
+    const finish = (error) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      clearTimeout(timer);
+      socket.removeAllListeners();
+      if (socket.readyState === WebSocket.OPEN) {
+        socket.close();
+      }
+      if (error) {
+        reject(error);
+        return;
+      }
+      resolve(entries);
+    };
+    const timer = setTimeout(() => {
+      finish();
+    }, timeoutMs);
+    socket.once("open", () => {
+      opened = true;
+      socket.send(JSON.stringify({ id: 1, method: "Runtime.enable" }));
+    });
+    socket.on("message", (data) => {
+      const payload = parseSocketMessage(data);
+      if (!isRuntimeConsoleApiCalledEvent(payload)) {
+        return;
+      }
+      entries.push(formatMetroLogEntry(app, payload));
+      if (entries.length >= limit) {
+        finish();
+      }
+    });
+    socket.once("close", () => {
+      finish();
+    });
+    socket.once("error", (error) => {
+      const normalizedError = normalizeError(error);
+      if (!opened) {
+        finish(normalizedError);
+        return;
+      }
+      finish(normalizedError);
+    });
+  });
+}
+function parseSocketMessage(data) {
+  const text = typeof data === "string" ? data : data.toString();
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function isRuntimeConsoleApiCalledEvent(value) {
+  return Boolean(
+    value && typeof value === "object" && "method" in value && value.method === "Runtime.consoleAPICalled"
+  );
+}
+function formatMetroLogEntry(app, event) {
+  return {
+    level: normalizeLogLevel(event.params?.type),
+    message: formatConsoleArguments(event.params?.args ?? []),
+    source: formatMetroSource(app),
+    timestamp: normalizeTimestamp(event.params?.timestamp)
+  };
+}
+function normalizeLogLevel(rawType) {
+  switch (rawType) {
+    case "trace":
+      return "trace";
+    case "debug":
+      return "debug";
+    case "warning":
+      return "warn";
+    case "error":
+    case "assert":
+      return "error";
+    default:
+      return "info";
+  }
+}
+function formatConsoleArguments(args) {
+  const values = args.map(formatConsoleArgument).filter(Boolean);
+  return values.join(" ").trim();
+}
+function formatConsoleArgument(arg) {
+  if (arg.type === "undefined") {
+    return "undefined";
+  }
+  if (arg.subtype === "null") {
+    return "null";
+  }
+  if (arg.description !== void 0) {
+    return arg.description;
+  }
+  if (arg.value !== void 0) {
+    if (typeof arg.value === "string") {
+      return arg.value;
+    }
+    if (typeof arg.value === "number" || typeof arg.value === "boolean" || typeof arg.value === "bigint") {
+      return String(arg.value);
+    }
+    return JSON.stringify(arg.value);
+  }
+  if (arg.unserializableValue !== void 0) {
+    return arg.unserializableValue;
+  }
+  return `[${arg.type}${arg.subtype ? ` ${arg.subtype}` : ""}]`;
+}
+function formatMetroSource(app) {
+  return `metro:${app.deviceName ?? app.appId ?? app.id}`;
+}
+function normalizeTimestamp(rawTimestamp) {
+  if (!rawTimestamp || Number.isNaN(rawTimestamp)) {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  const milliseconds = rawTimestamp < 1e12 ? rawTimestamp * 1e3 : rawTimestamp;
+  return new Date(milliseconds).toISOString();
+}
+function formatMetroApp(app) {
+  return [app.id, app.appId, app.deviceName].filter(Boolean).join("/");
+}
+function normalizeError(error) {
+  if (error instanceof Error) {
+    return error;
+  }
+  return new Error(String(error));
+}
+
+// src/lib/format.ts
+function formatSnapshot(snapshot) {
+  const lines = [
+    `service: ${snapshot.service}`,
+    `entries: ${snapshot.entries.length}/${snapshot.total}`
+  ];
+  for (const entry of snapshot.entries) {
+    const context = entry.context && Object.keys(entry.context).length > 0 ? ` ${JSON.stringify(entry.context)}` : "";
+    lines.push(
+      `${entry.timestamp} [${entry.level.toUpperCase()}] [${entry.source}] ${entry.message}${context}`
+    );
+  }
+  return lines.join("\n");
+}
+
+// src/lib/parse-args.ts
+var DEFAULT_LIMIT = 120;
+function parseCliArgs(args) {
+  const parsed = {
+    headers: {},
+    json: false,
+    limit: DEFAULT_LIMIT
+  };
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+    if (!arg) {
+      continue;
+    }
+    if (!arg.startsWith("--") && !parsed.target) {
+      parsed.target = arg;
+      continue;
+    }
+    if (arg === "--json") {
+      parsed.json = true;
+      continue;
+    }
+    if (arg === "--endpoint") {
+      parsed.endpoint = readValue(args, ++index, "--endpoint");
+      continue;
+    }
+    if (arg === "--provider") {
+      parsed.provider = normalizeProvider(
+        readValue(args, ++index, "--provider")
+      );
+      continue;
+    }
+    if (arg === "--metro-url") {
+      parsed.metroUrl = readValue(args, ++index, "--metro-url");
+      continue;
+    }
+    if (arg === "--app") {
+      parsed.app = readValue(args, ++index, "--app");
+      continue;
+    }
+    if (arg === "--config") {
+      parsed.configPath = readValue(args, ++index, "--config");
+      continue;
+    }
+    if (arg === "--limit") {
+      parsed.limit = normalizeLimit(readValue(args, ++index, "--limit"));
+      continue;
+    }
+    if (arg === "--header") {
+      const rawHeader = readValue(args, ++index, "--header");
+      const separatorIndex = rawHeader.indexOf(":");
+      if (separatorIndex <= 0) {
+        throw new Error(`Invalid header "${rawHeader}". Use name:value.`);
+      }
+      const name = rawHeader.slice(0, separatorIndex).trim();
+      const value = rawHeader.slice(separatorIndex + 1).trim();
+      parsed.headers[name] = value;
+      continue;
+    }
+    if (arg === "--timeout") {
+      parsed.timeoutMs = normalizePositiveNumber(
+        readValue(args, ++index, "--timeout"),
+        "--timeout"
+      );
+      continue;
+    }
+    throw new Error(`Unknown argument: ${arg}`);
+  }
+  return parsed;
+}
+function normalizeLimit(rawLimit) {
+  const limit = Number(rawLimit);
+  if (!Number.isFinite(limit) || limit <= 0) {
+    throw new Error(`Invalid limit: ${rawLimit}`);
+  }
+  return Math.floor(limit);
+}
+function normalizePositiveNumber(rawValue, optionName) {
+  const value = Number(rawValue);
+  if (!Number.isFinite(value) || value <= 0) {
+    throw new Error(`Invalid value for ${optionName}: ${rawValue}`);
+  }
+  return Math.floor(value);
+}
+function normalizeProvider(rawProvider) {
+  if (rawProvider === "endpoint" || rawProvider === "metro") {
+    return rawProvider;
+  }
+  throw new Error(`Invalid provider: ${rawProvider}`);
+}
+function readValue(args, index, optionName) {
+  const value = args[index];
+  if (!value) {
+    throw new Error(`Missing value for ${optionName}`);
+  }
+  return value;
+}
+
+// src/lib/run-cli.ts
+async function runCli(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return 0;
+  }
+  const command = args[0];
+  if (command === "list") {
+    return runList(args.slice(1));
+  }
+  const parsed = parseCliArgs(args);
+  const config = loadConfig({ configPath: parsed.configPath });
+  const targetConfig = parsed.target && config ? config.targets[parsed.target] : void 0;
+  const directProvider = resolveDirectProvider(parsed);
+  if (parsed.target && !targetConfig && !directProvider) {
+    if (!config) {
+      throw new Error(
+        `Target "${parsed.target}" was provided, but no config was found. Create universal-logs.config.json, add package.json#universalLogs, or pass --config/--endpoint.`
+      );
+    }
+    throw new Error(
+      `Target "${parsed.target}" was not found in config. Run "universal-logs list" or check universal-logs.config.json.`
+    );
+  }
+  const request = resolveLogRequest({
+    directProvider,
+    parsed,
+    targetConfig
+  });
+  const snapshot = request.provider === "metro" ? await fetchMetroLogs({
+    app: request.app,
+    limit: parsed.limit,
+    metroUrl: request.metroUrl,
+    service: request.service,
+    timeoutMs: request.timeoutMs
+  }) : await fetchLogs({
+    endpoint: request.endpoint,
+    headers: request.headers,
+    limit: parsed.limit
+  });
+  if (parsed.json) {
+    process.stdout.write(`${JSON.stringify(snapshot, null, 2)}
+`);
+  } else {
+    process.stdout.write(`${formatSnapshot(snapshot)}
+`);
+  }
+  return 0;
+}
+function runList(args) {
+  const parsed = parseCliArgs(args);
+  const config = loadConfig({ configPath: parsed.configPath });
+  if (!config) {
+    throw new Error("No config found. Create universal-logs.config.json first.");
+  }
+  for (const [name, target] of Object.entries(config.targets)) {
+    const details = target.provider === "metro" ? formatMetroTarget(target) : formatEndpointTarget(target);
+    process.stdout.write(`${name}	${details}
+`);
+  }
+  return 0;
+}
+function resolveLogRequest(options) {
+  const { directProvider, parsed, targetConfig } = options;
+  if (targetConfig) {
+    if (targetConfig.provider === "metro") {
+      return {
+        app: parsed.app ?? targetConfig.app,
+        metroUrl: parsed.metroUrl ?? targetConfig.metroUrl,
+        provider: "metro",
+        service: parsed.target,
+        timeoutMs: parsed.timeoutMs ?? targetConfig.timeoutMs ?? DEFAULT_METRO_TIMEOUT_MS
+      };
+    }
+    return {
+      endpoint: parsed.endpoint ?? targetConfig.endpoint,
+      headers: {
+        ...targetConfig.headers,
+        ...parsed.headers
+      },
+      provider: "endpoint"
+    };
+  }
+  const provider = directProvider ?? resolveDirectProvider(parsed);
+  if (provider === "metro") {
+    return {
+      app: parsed.app,
+      metroUrl: parsed.metroUrl,
+      provider: "metro",
+      service: parsed.target === "metro" ? "metro" : parsed.target,
+      timeoutMs: parsed.timeoutMs ?? DEFAULT_METRO_TIMEOUT_MS
+    };
+  }
+  if (provider === "endpoint" && parsed.endpoint) {
+    return {
+      endpoint: parsed.endpoint,
+      headers: parsed.headers,
+      provider: "endpoint"
+    };
+  }
+  throw new Error(
+    "No log source resolved. Pass --endpoint, use --provider metro, or configure a target in universal-logs.config.json."
+  );
+}
+function resolveDirectProvider(parsed) {
+  if (parsed.provider) {
+    return parsed.provider;
+  }
+  if (parsed.endpoint) {
+    return "endpoint";
+  }
+  if (parsed.metroUrl || parsed.app || parsed.target === "metro") {
+    return "metro";
+  }
+  return null;
+}
+function formatEndpointTarget(target) {
+  return ["endpoint", target.endpoint].join("	");
+}
+function printHelp() {
+  process.stdout.write(
+    `${[
+      "Usage:",
+      "  universal-logs <target> [--limit 120] [--json]",
+      "  universal-logs --endpoint <url> [--limit 120] [--json]",
+      "  universal-logs metro [--app <selector>] [--metro-url <url>] [--timeout 5000] [--limit 120] [--json]",
+      "  universal-logs list",
+      "",
+      "Options:",
+      "  --app <selector>    Select a Metro app by id, appId, or device name",
+      "  --config <path>      Use a specific config file",
+      "  --endpoint <url>     Override the configured endpoint",
+      "  --header name:value  Add a request header",
+      "  --limit <n>          Number of log entries to request",
+      "  --metro-url <url>    Override the Metro server origin",
+      "  --provider <name>    Force endpoint or metro mode",
+      "  --timeout <ms>       Metro capture window before exiting",
+      "  --json               Print raw JSON"
+    ].join("\n")}
+`
+  );
+}
+
+// src/cli.ts
+try {
+  const exitCode = await runCli(process.argv.slice(2));
+  process.exit(exitCode);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`${message}
+`);
+  process.exit(1);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/config.ts","../src/lib/fetch-logs.ts","../src/lib/fetch-metro-logs.ts","../src/lib/format.ts","../src/lib/parse-args.ts","../src/lib/run-cli.ts","../src/cli.ts"],"sourcesContent":["import fs from \"node:fs\"\nimport path from \"node:path\"\n\nexport type EndpointTargetConfig = {\n  endpoint: string\n  headers?: Record<string, string>\n  provider?: \"endpoint\"\n}\n\nexport type MetroTargetConfig = {\n  app?: string\n  metroUrl?: string\n  provider: \"metro\"\n  timeoutMs?: number\n}\n\nexport type UniversalLogsTargetConfig = EndpointTargetConfig | MetroTargetConfig\n\nexport type UniversalLogsConfig = {\n  targets: Record<string, UniversalLogsTargetConfig>\n}\n\nconst CONFIG_FILE_NAME = \"universal-logs.config.json\"\n\nexport function findConfigPath(cwd: string): string | null {\n  let currentDir = path.resolve(cwd)\n\n  while (true) {\n    const configPath = path.join(currentDir, CONFIG_FILE_NAME)\n    if (fs.existsSync(configPath)) {\n      return configPath\n    }\n\n    const packageJsonPath = path.join(currentDir, \"package.json\")\n    if (fs.existsSync(packageJsonPath)) {\n      const packageJson = JSON.parse(\n        fs.readFileSync(packageJsonPath, \"utf8\"),\n      ) as {\n        universalLogs?: UniversalLogsConfig\n      }\n\n      if (packageJson.universalLogs) {\n        return packageJsonPath\n      }\n    }\n\n    const parentDir = path.dirname(currentDir)\n    if (parentDir === currentDir) {\n      return null\n    }\n\n    currentDir = parentDir\n  }\n}\n\nexport function loadConfig(\n  options: { configPath?: string; cwd?: string } = {},\n): UniversalLogsConfig | null {\n  const { configPath, cwd = process.cwd() } = options\n  const resolvedPath = configPath\n    ? path.resolve(cwd, configPath)\n    : findConfigPath(cwd)\n\n  if (!resolvedPath) {\n    return null\n  }\n\n  if (path.basename(resolvedPath) === \"package.json\") {\n    const packageJson = JSON.parse(fs.readFileSync(resolvedPath, \"utf8\")) as {\n      universalLogs?: UniversalLogsConfig\n    }\n\n    if (!packageJson.universalLogs) {\n      throw new Error(`No universalLogs field found in ${resolvedPath}`)\n    }\n\n    return validateConfig(packageJson.universalLogs, resolvedPath)\n  }\n\n  const parsed = JSON.parse(\n    fs.readFileSync(resolvedPath, \"utf8\"),\n  ) as UniversalLogsConfig\n  return validateConfig(parsed, resolvedPath)\n}\n\nfunction validateConfig(\n  config: UniversalLogsConfig,\n  sourcePath: string,\n): UniversalLogsConfig {\n  if (!config || typeof config !== \"object\" || !config.targets) {\n    throw new Error(`Invalid config in ${sourcePath}: missing targets object`)\n  }\n\n  const targets = Object.fromEntries(\n    Object.entries(config.targets).map(([name, target]) => [\n      name,\n      validateTarget(name, target, sourcePath),\n    ]),\n  )\n\n  return {\n    targets,\n  }\n}\n\nfunction validateTarget(\n  name: string,\n  target: UniversalLogsTargetConfig,\n  sourcePath: string,\n): UniversalLogsTargetConfig {\n  if (!target || typeof target !== \"object\") {\n    throw new Error(`Invalid target \"${name}\" in ${sourcePath}`)\n  }\n\n  if (target.provider === \"metro\") {\n    if (target.app !== undefined && typeof target.app !== \"string\") {\n      throw new Error(`Invalid target \"${name}\" in ${sourcePath}: invalid app`)\n    }\n\n    if (target.metroUrl !== undefined && typeof target.metroUrl !== \"string\") {\n      throw new Error(\n        `Invalid target \"${name}\" in ${sourcePath}: invalid metroUrl`,\n      )\n    }\n\n    if (\n      target.timeoutMs !== undefined &&\n      (!Number.isFinite(target.timeoutMs) || target.timeoutMs <= 0)\n    ) {\n      throw new Error(\n        `Invalid target \"${name}\" in ${sourcePath}: invalid timeoutMs`,\n      )\n    }\n\n    return target\n  }\n\n  if (target.provider !== undefined && target.provider !== \"endpoint\") {\n    throw new Error(\n      `Invalid target \"${name}\" in ${sourcePath}: unsupported provider`,\n    )\n  }\n\n  if (typeof target.endpoint !== \"string\") {\n    throw new Error(\n      `Invalid target \"${name}\" in ${sourcePath}: missing endpoint`,\n    )\n  }\n\n  if (target.headers !== undefined && !isStringRecord(target.headers)) {\n    throw new Error(\n      `Invalid target \"${name}\" in ${sourcePath}: invalid headers`,\n    )\n  }\n\n  return target\n}\n\nfunction isStringRecord(value: unknown): value is Record<string, string> {\n  if (!value || typeof value !== \"object\") {\n    return false\n  }\n\n  return Object.values(value).every((entry) => typeof entry === \"string\")\n}\n","import type { UniversalLogSnapshot } from \"../runtime\"\n\nexport async function fetchLogs(options: {\n  endpoint: string\n  headers?: HeadersInit\n  limit: number\n}): Promise<UniversalLogSnapshot> {\n  const { endpoint, headers, limit } = options\n  const url = new URL(endpoint)\n  url.searchParams.set(\"limit\", String(limit))\n\n  let response: Response\n\n  try {\n    response = await fetch(url, {\n      headers,\n    })\n  } catch (error) {\n    throw new Error(\n      `Failed to fetch logs from ${url.origin}${url.pathname}: ${formatFetchError(error)}`,\n    )\n  }\n\n  if (!response.ok) {\n    throw new Error(\n      `Endpoint returned ${response.status} ${response.statusText}`,\n    )\n  }\n\n  return (await response.json()) as UniversalLogSnapshot\n}\n\nfunction formatFetchError(error: unknown): string {\n  if (!(error instanceof Error)) {\n    return String(error)\n  }\n\n  const cause = error.cause\n  if (cause instanceof Error && cause.message) {\n    return cause.message\n  }\n\n  if (\n    cause &&\n    typeof cause === \"object\" &&\n    \"code\" in cause &&\n    typeof cause.code === \"string\"\n  ) {\n    return cause.code\n  }\n\n  return error.message\n}\n","import WebSocket from \"ws\"\nimport type {\n  UniversalLogEntry,\n  UniversalLogLevel,\n  UniversalLogSnapshot,\n} from \"../runtime\"\n\ntype MetroInspectorApp = {\n  appId?: string\n  deviceName?: string\n  id: string\n  reactNative?: {\n    capabilities?: {\n      nativePageReloads?: boolean\n    }\n  }\n  title: string\n  webSocketDebuggerUrl: string\n}\n\ntype MetroRemoteObject = {\n  description?: string\n  subtype?: string\n  type: string\n  unserializableValue?: string\n  value?: unknown\n}\n\ntype RuntimeConsoleApiCalledEvent = {\n  method: \"Runtime.consoleAPICalled\"\n  params?: {\n    args?: MetroRemoteObject[]\n    timestamp?: number\n    type?: string\n  }\n}\n\nexport const DEFAULT_METRO_URL = \"http://127.0.0.1:8081\"\nexport const DEFAULT_METRO_TIMEOUT_MS = 5000\n\nexport async function fetchMetroLogs(options: {\n  app?: string\n  limit: number\n  metroUrl?: string\n  service?: string\n  timeoutMs?: number\n}): Promise<UniversalLogSnapshot> {\n  const metroOrigin = getMetroServerOrigin(options.metroUrl)\n  const apps = await fetchMetroInspectorApps(metroOrigin)\n\n  if (apps.length === 0) {\n    const status = await fetchMetroStatus(metroOrigin)\n    if (status?.includes(\"packager-status:running\")) {\n      throw new Error(\n        `Metro is running at ${metroOrigin}, but no React Native inspector apps are connected. Open the app on a simulator/device and make sure it is using this Metro server.`,\n      )\n    }\n\n    throw new Error(\n      `No supported React Native inspector apps found at ${metroOrigin}`,\n    )\n  }\n\n  const app = selectMetroInspectorApp(apps, options.app)\n  const entries = await captureMetroConsoleLogs({\n    app,\n    limit: options.limit,\n    timeoutMs: options.timeoutMs ?? DEFAULT_METRO_TIMEOUT_MS,\n  })\n\n  return {\n    entries,\n    limit: options.limit,\n    service: options.service ?? app.appId ?? \"metro\",\n    total: entries.length,\n  }\n}\n\nexport function getMetroServerOrigin(rawMetroUrl?: string): string {\n  const input = rawMetroUrl?.trim() || DEFAULT_METRO_URL\n  const hasScheme = /^[a-z][a-z0-9+.-]*:\\/\\//i.test(input)\n  const url = hasScheme ? new URL(input) : new URL(`http://${input}`)\n\n  if (!url.port) {\n    url.port = \"8081\"\n  }\n\n  return url.origin\n}\n\nexport function formatMetroTarget(target: {\n  app?: string\n  metroUrl?: string\n  timeoutMs?: number\n}): string {\n  const parts = [\"metro\", getMetroServerOrigin(target.metroUrl)]\n\n  if (target.app) {\n    parts.push(`app=${target.app}`)\n  }\n\n  if (target.timeoutMs) {\n    parts.push(`timeout=${target.timeoutMs}ms`)\n  }\n\n  return parts.join(\"\\t\")\n}\n\nasync function fetchMetroInspectorApps(\n  metroOrigin: string,\n): Promise<MetroInspectorApp[]> {\n  const endpoints = [\"/json/list\", \"/json\"]\n  let lastError: Error | null = null\n\n  for (const endpoint of endpoints) {\n    try {\n      const response = await fetch(`${metroOrigin}${endpoint}`)\n      if (!response.ok) {\n        continue\n      }\n\n      const data = (await response.json()) as unknown\n      if (!Array.isArray(data)) {\n        continue\n      }\n\n      const apps = [...data].reverse().filter(isSupportedMetroApp)\n      if (apps.length > 0) {\n        return apps\n      }\n\n      return [...data].reverse().filter(hasDebuggerUrl)\n    } catch (error) {\n      lastError = normalizeError(error)\n    }\n  }\n\n  if (lastError) {\n    throw new Error(\n      `Failed to query Metro inspector at ${metroOrigin}: ${lastError.message}`,\n    )\n  }\n\n  return []\n}\n\nasync function fetchMetroStatus(metroOrigin: string): Promise<string | null> {\n  try {\n    const response = await fetch(`${metroOrigin}/status`)\n    if (!response.ok) {\n      return null\n    }\n\n    return await response.text()\n  } catch {\n    return null\n  }\n}\n\nfunction isSupportedMetroApp(app: unknown): app is MetroInspectorApp {\n  if (!hasDebuggerUrl(app)) {\n    return false\n  }\n\n  return (\n    app.title === \"React Native Experimental (Improved Chrome Reloads)\" ||\n    app.reactNative?.capabilities?.nativePageReloads === true\n  )\n}\n\nfunction hasDebuggerUrl(app: unknown): app is MetroInspectorApp {\n  return Boolean(\n    app &&\n      typeof app === \"object\" &&\n      \"id\" in app &&\n      \"title\" in app &&\n      \"webSocketDebuggerUrl\" in app &&\n      typeof app.id === \"string\" &&\n      typeof app.title === \"string\" &&\n      typeof app.webSocketDebuggerUrl === \"string\",\n  )\n}\n\nfunction selectMetroInspectorApp(\n  apps: MetroInspectorApp[],\n  selector?: string,\n): MetroInspectorApp {\n  if (!selector) {\n    if (apps.length === 1) {\n      return apps[0]\n    }\n\n    throw new Error(\n      `Multiple Metro apps found. Pass --app. Available: ${apps.map(formatMetroApp).join(\", \")}`,\n    )\n  }\n\n  const normalizedSelector = selector.trim().toLowerCase()\n  const matches = apps.filter((app) => {\n    return [app.id, app.appId, app.deviceName]\n      .filter((value): value is string => Boolean(value))\n      .some((value) => value.toLowerCase() === normalizedSelector)\n  })\n\n  if (matches.length === 1) {\n    return matches[0]\n  }\n\n  if (matches.length > 1) {\n    throw new Error(\n      `Multiple Metro apps match \"${selector}\". Available: ${apps.map(formatMetroApp).join(\", \")}`,\n    )\n  }\n\n  throw new Error(\n    `No Metro app matched \"${selector}\". Available: ${apps.map(formatMetroApp).join(\", \")}`,\n  )\n}\n\nasync function captureMetroConsoleLogs(options: {\n  app: MetroInspectorApp\n  limit: number\n  timeoutMs: number\n}): Promise<UniversalLogEntry[]> {\n  const { app, limit, timeoutMs } = options\n\n  return new Promise((resolve, reject) => {\n    const entries: UniversalLogEntry[] = []\n    let settled = false\n    let opened = false\n    const socket = new WebSocket(app.webSocketDebuggerUrl)\n\n    const finish = (error?: Error) => {\n      if (settled) {\n        return\n      }\n\n      settled = true\n      clearTimeout(timer)\n      socket.removeAllListeners()\n\n      if (socket.readyState === WebSocket.OPEN) {\n        socket.close()\n      }\n\n      if (error) {\n        reject(error)\n        return\n      }\n\n      resolve(entries)\n    }\n\n    const timer = setTimeout(() => {\n      finish()\n    }, timeoutMs)\n\n    socket.once(\"open\", () => {\n      opened = true\n      socket.send(JSON.stringify({ id: 1, method: \"Runtime.enable\" }))\n    })\n\n    socket.on(\"message\", (data: WebSocket.RawData) => {\n      const payload = parseSocketMessage(data)\n      if (!isRuntimeConsoleApiCalledEvent(payload)) {\n        return\n      }\n\n      entries.push(formatMetroLogEntry(app, payload))\n      if (entries.length >= limit) {\n        finish()\n      }\n    })\n\n    socket.once(\"close\", () => {\n      finish()\n    })\n\n    socket.once(\"error\", (error: Error) => {\n      const normalizedError = normalizeError(error)\n      if (!opened) {\n        finish(normalizedError)\n        return\n      }\n\n      finish(normalizedError)\n    })\n  })\n}\n\nfunction parseSocketMessage(data: WebSocket.RawData): unknown {\n  const text = typeof data === \"string\" ? data : data.toString()\n\n  try {\n    return JSON.parse(text) as unknown\n  } catch {\n    return text\n  }\n}\n\nfunction isRuntimeConsoleApiCalledEvent(\n  value: unknown,\n): value is RuntimeConsoleApiCalledEvent {\n  return Boolean(\n    value &&\n      typeof value === \"object\" &&\n      \"method\" in value &&\n      value.method === \"Runtime.consoleAPICalled\",\n  )\n}\n\nfunction formatMetroLogEntry(\n  app: MetroInspectorApp,\n  event: RuntimeConsoleApiCalledEvent,\n): UniversalLogEntry {\n  return {\n    level: normalizeLogLevel(event.params?.type),\n    message: formatConsoleArguments(event.params?.args ?? []),\n    source: formatMetroSource(app),\n    timestamp: normalizeTimestamp(event.params?.timestamp),\n  }\n}\n\nfunction normalizeLogLevel(rawType?: string): UniversalLogLevel {\n  switch (rawType) {\n    case \"trace\":\n      return \"trace\"\n    case \"debug\":\n      return \"debug\"\n    case \"warning\":\n      return \"warn\"\n    case \"error\":\n    case \"assert\":\n      return \"error\"\n    default:\n      return \"info\"\n  }\n}\n\nfunction formatConsoleArguments(args: MetroRemoteObject[]): string {\n  const values = args.map(formatConsoleArgument).filter(Boolean)\n  return values.join(\" \").trim()\n}\n\nfunction formatConsoleArgument(arg: MetroRemoteObject): string {\n  if (arg.type === \"undefined\") {\n    return \"undefined\"\n  }\n\n  if (arg.subtype === \"null\") {\n    return \"null\"\n  }\n\n  if (arg.description !== undefined) {\n    return arg.description\n  }\n\n  if (arg.value !== undefined) {\n    if (typeof arg.value === \"string\") {\n      return arg.value\n    }\n\n    if (\n      typeof arg.value === \"number\" ||\n      typeof arg.value === \"boolean\" ||\n      typeof arg.value === \"bigint\"\n    ) {\n      return String(arg.value)\n    }\n\n    return JSON.stringify(arg.value)\n  }\n\n  if (arg.unserializableValue !== undefined) {\n    return arg.unserializableValue\n  }\n\n  return `[${arg.type}${arg.subtype ? ` ${arg.subtype}` : \"\"}]`\n}\n\nfunction formatMetroSource(app: MetroInspectorApp): string {\n  return `metro:${app.deviceName ?? app.appId ?? app.id}`\n}\n\nfunction normalizeTimestamp(rawTimestamp?: number): string {\n  if (!rawTimestamp || Number.isNaN(rawTimestamp)) {\n    return new Date().toISOString()\n  }\n\n  const milliseconds =\n    rawTimestamp < 1_000_000_000_000 ? rawTimestamp * 1000 : rawTimestamp\n\n  return new Date(milliseconds).toISOString()\n}\n\nfunction formatMetroApp(app: MetroInspectorApp): string {\n  return [app.id, app.appId, app.deviceName].filter(Boolean).join(\"/\")\n}\n\nfunction normalizeError(error: unknown): Error {\n  if (error instanceof Error) {\n    return error\n  }\n\n  return new Error(String(error))\n}\n","import type { UniversalLogSnapshot } from \"../runtime\"\n\nexport function formatSnapshot(snapshot: UniversalLogSnapshot): string {\n  const lines = [\n    `service: ${snapshot.service}`,\n    `entries: ${snapshot.entries.length}/${snapshot.total}`,\n  ]\n\n  for (const entry of snapshot.entries) {\n    const context =\n      entry.context && Object.keys(entry.context).length > 0\n        ? ` ${JSON.stringify(entry.context)}`\n        : \"\"\n\n    lines.push(\n      `${entry.timestamp} [${entry.level.toUpperCase()}] [${entry.source}] ${entry.message}${context}`,\n    )\n  }\n\n  return lines.join(\"\\n\")\n}\n","export type ParsedCliArgs = {\n  app?: string\n  configPath?: string\n  endpoint?: string\n  headers: Record<string, string>\n  json: boolean\n  limit: number\n  metroUrl?: string\n  provider?: \"endpoint\" | \"metro\"\n  target?: string\n  timeoutMs?: number\n}\n\nconst DEFAULT_LIMIT = 120\n\nexport function parseCliArgs(args: string[]): ParsedCliArgs {\n  const parsed: ParsedCliArgs = {\n    headers: {},\n    json: false,\n    limit: DEFAULT_LIMIT,\n  }\n\n  for (let index = 0; index < args.length; index += 1) {\n    const arg = args[index]\n\n    if (!arg) {\n      continue\n    }\n\n    if (!arg.startsWith(\"--\") && !parsed.target) {\n      parsed.target = arg\n      continue\n    }\n\n    if (arg === \"--json\") {\n      parsed.json = true\n      continue\n    }\n\n    if (arg === \"--endpoint\") {\n      parsed.endpoint = readValue(args, ++index, \"--endpoint\")\n      continue\n    }\n\n    if (arg === \"--provider\") {\n      parsed.provider = normalizeProvider(\n        readValue(args, ++index, \"--provider\"),\n      )\n      continue\n    }\n\n    if (arg === \"--metro-url\") {\n      parsed.metroUrl = readValue(args, ++index, \"--metro-url\")\n      continue\n    }\n\n    if (arg === \"--app\") {\n      parsed.app = readValue(args, ++index, \"--app\")\n      continue\n    }\n\n    if (arg === \"--config\") {\n      parsed.configPath = readValue(args, ++index, \"--config\")\n      continue\n    }\n\n    if (arg === \"--limit\") {\n      parsed.limit = normalizeLimit(readValue(args, ++index, \"--limit\"))\n      continue\n    }\n\n    if (arg === \"--header\") {\n      const rawHeader = readValue(args, ++index, \"--header\")\n      const separatorIndex = rawHeader.indexOf(\":\")\n      if (separatorIndex <= 0) {\n        throw new Error(`Invalid header \"${rawHeader}\". Use name:value.`)\n      }\n\n      const name = rawHeader.slice(0, separatorIndex).trim()\n      const value = rawHeader.slice(separatorIndex + 1).trim()\n      parsed.headers[name] = value\n      continue\n    }\n\n    if (arg === \"--timeout\") {\n      parsed.timeoutMs = normalizePositiveNumber(\n        readValue(args, ++index, \"--timeout\"),\n        \"--timeout\",\n      )\n      continue\n    }\n\n    throw new Error(`Unknown argument: ${arg}`)\n  }\n\n  return parsed\n}\n\nfunction normalizeLimit(rawLimit: string): number {\n  const limit = Number(rawLimit)\n  if (!Number.isFinite(limit) || limit <= 0) {\n    throw new Error(`Invalid limit: ${rawLimit}`)\n  }\n\n  return Math.floor(limit)\n}\n\nfunction normalizePositiveNumber(rawValue: string, optionName: string): number {\n  const value = Number(rawValue)\n  if (!Number.isFinite(value) || value <= 0) {\n    throw new Error(`Invalid value for ${optionName}: ${rawValue}`)\n  }\n\n  return Math.floor(value)\n}\n\nfunction normalizeProvider(rawProvider: string): \"endpoint\" | \"metro\" {\n  if (rawProvider === \"endpoint\" || rawProvider === \"metro\") {\n    return rawProvider\n  }\n\n  throw new Error(`Invalid provider: ${rawProvider}`)\n}\n\nfunction readValue(args: string[], index: number, optionName: string): string {\n  const value = args[index]\n  if (!value) {\n    throw new Error(`Missing value for ${optionName}`)\n  }\n\n  return value\n}\n","import type { EndpointTargetConfig, UniversalLogsTargetConfig } from \"./config\"\nimport { loadConfig } from \"./config\"\nimport { fetchLogs } from \"./fetch-logs\"\nimport {\n  DEFAULT_METRO_TIMEOUT_MS,\n  fetchMetroLogs,\n  formatMetroTarget,\n} from \"./fetch-metro-logs\"\nimport { formatSnapshot } from \"./format\"\nimport { parseCliArgs } from \"./parse-args\"\n\nexport async function runCli(args: string[]): Promise<number> {\n  if (args.includes(\"--help\") || args.includes(\"-h\")) {\n    printHelp()\n    return 0\n  }\n\n  const command = args[0]\n  if (command === \"list\") {\n    return runList(args.slice(1))\n  }\n\n  const parsed = parseCliArgs(args)\n  const config = loadConfig({ configPath: parsed.configPath })\n  const targetConfig =\n    parsed.target && config ? config.targets[parsed.target] : undefined\n  const directProvider = resolveDirectProvider(parsed)\n\n  if (parsed.target && !targetConfig && !directProvider) {\n    if (!config) {\n      throw new Error(\n        `Target \"${parsed.target}\" was provided, but no config was found. Create universal-logs.config.json, add package.json#universalLogs, or pass --config/--endpoint.`,\n      )\n    }\n\n    throw new Error(\n      `Target \"${parsed.target}\" was not found in config. Run \"universal-logs list\" or check universal-logs.config.json.`,\n    )\n  }\n\n  const request = resolveLogRequest({\n    directProvider,\n    parsed,\n    targetConfig,\n  })\n\n  const snapshot =\n    request.provider === \"metro\"\n      ? await fetchMetroLogs({\n          app: request.app,\n          limit: parsed.limit,\n          metroUrl: request.metroUrl,\n          service: request.service,\n          timeoutMs: request.timeoutMs,\n        })\n      : await fetchLogs({\n          endpoint: request.endpoint,\n          headers: request.headers,\n          limit: parsed.limit,\n        })\n\n  if (parsed.json) {\n    process.stdout.write(`${JSON.stringify(snapshot, null, 2)}\\n`)\n  } else {\n    process.stdout.write(`${formatSnapshot(snapshot)}\\n`)\n  }\n\n  return 0\n}\n\nfunction runList(args: string[]): number {\n  const parsed = parseCliArgs(args)\n  const config = loadConfig({ configPath: parsed.configPath })\n\n  if (!config) {\n    throw new Error(\"No config found. Create universal-logs.config.json first.\")\n  }\n\n  for (const [name, target] of Object.entries(config.targets)) {\n    const details =\n      target.provider === \"metro\"\n        ? formatMetroTarget(target)\n        : formatEndpointTarget(target)\n    process.stdout.write(`${name}\\t${details}\\n`)\n  }\n\n  return 0\n}\n\ntype ResolvedLogRequest =\n  | {\n      app?: string\n      metroUrl?: string\n      provider: \"metro\"\n      service?: string\n      timeoutMs: number\n    }\n  | {\n      endpoint: string\n      headers: Record<string, string>\n      provider: \"endpoint\"\n    }\n\nfunction resolveLogRequest(options: {\n  directProvider?: \"endpoint\" | \"metro\" | null\n  parsed: ReturnType<typeof parseCliArgs>\n  targetConfig?: UniversalLogsTargetConfig\n}): ResolvedLogRequest {\n  const { directProvider, parsed, targetConfig } = options\n\n  if (targetConfig) {\n    if (targetConfig.provider === \"metro\") {\n      return {\n        app: parsed.app ?? targetConfig.app,\n        metroUrl: parsed.metroUrl ?? targetConfig.metroUrl,\n        provider: \"metro\",\n        service: parsed.target,\n        timeoutMs:\n          parsed.timeoutMs ??\n          targetConfig.timeoutMs ??\n          DEFAULT_METRO_TIMEOUT_MS,\n      }\n    }\n\n    return {\n      endpoint: parsed.endpoint ?? targetConfig.endpoint,\n      headers: {\n        ...targetConfig.headers,\n        ...parsed.headers,\n      },\n      provider: \"endpoint\",\n    }\n  }\n\n  const provider = directProvider ?? resolveDirectProvider(parsed)\n  if (provider === \"metro\") {\n    return {\n      app: parsed.app,\n      metroUrl: parsed.metroUrl,\n      provider: \"metro\",\n      service: parsed.target === \"metro\" ? \"metro\" : parsed.target,\n      timeoutMs: parsed.timeoutMs ?? DEFAULT_METRO_TIMEOUT_MS,\n    }\n  }\n\n  if (provider === \"endpoint\" && parsed.endpoint) {\n    return {\n      endpoint: parsed.endpoint,\n      headers: parsed.headers,\n      provider: \"endpoint\",\n    }\n  }\n\n  throw new Error(\n    \"No log source resolved. Pass --endpoint, use --provider metro, or configure a target in universal-logs.config.json.\",\n  )\n}\n\nfunction resolveDirectProvider(\n  parsed: ReturnType<typeof parseCliArgs>,\n): \"endpoint\" | \"metro\" | null {\n  if (parsed.provider) {\n    return parsed.provider\n  }\n\n  if (parsed.endpoint) {\n    return \"endpoint\"\n  }\n\n  if (parsed.metroUrl || parsed.app || parsed.target === \"metro\") {\n    return \"metro\"\n  }\n\n  return null\n}\n\nfunction formatEndpointTarget(target: EndpointTargetConfig): string {\n  return [\"endpoint\", target.endpoint].join(\"\\t\")\n}\n\nfunction printHelp(): void {\n  process.stdout.write(\n    `${[\n      \"Usage:\",\n      \"  universal-logs <target> [--limit 120] [--json]\",\n      \"  universal-logs --endpoint <url> [--limit 120] [--json]\",\n      \"  universal-logs metro [--app <selector>] [--metro-url <url>] [--timeout 5000] [--limit 120] [--json]\",\n      \"  universal-logs list\",\n      \"\",\n      \"Options:\",\n      \"  --app <selector>    Select a Metro app by id, appId, or device name\",\n      \"  --config <path>      Use a specific config file\",\n      \"  --endpoint <url>     Override the configured endpoint\",\n      \"  --header name:value  Add a request header\",\n      \"  --limit <n>          Number of log entries to request\",\n      \"  --metro-url <url>    Override the Metro server origin\",\n      \"  --provider <name>    Force endpoint or metro mode\",\n      \"  --timeout <ms>       Metro capture window before exiting\",\n      \"  --json               Print raw JSON\",\n    ].join(\"\\n\")}\\n`,\n  )\n}\n","#!/usr/bin/env node\nimport { runCli } from \"./lib/run-cli\"\n\ntry {\n  const exitCode = await runCli(process.argv.slice(2))\n  process.exit(exitCode)\n} catch (error) {\n  const message = error instanceof Error ? error.message : String(error)\n  process.stderr.write(`${message}\\n`)\n  process.exit(1)\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { LogBuffer, UniversalLogEntry, UniversalLogLevel, UniversalLogSnapshot, attachElectronRendererConsoleMirror, createConsoleMirror, createLogBuffer, startHttpLogEndpoint } from './runtime/index.js';
+import 'node:http';

package/dist/index.js

@@ -0,0 +1,13 @@
+import {
+  attachElectronRendererConsoleMirror,
+  createConsoleMirror,
+  createLogBuffer,
+  startHttpLogEndpoint
+} from "./chunk-IUSSBPEQ.js";
+export {
+  attachElectronRendererConsoleMirror,
+  createConsoleMirror,
+  createLogBuffer,
+  startHttpLogEndpoint
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/runtime/index.d.ts

@@ -0,0 +1,59 @@
+import http from 'node:http';
+
+type UniversalLogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+type UniversalLogEntry = {
+    context?: Record<string, unknown>;
+    level: UniversalLogLevel;
+    message: string;
+    source: string;
+    timestamp: string;
+};
+type UniversalLogSnapshot = {
+    entries: UniversalLogEntry[];
+    limit: number;
+    service: string;
+    total: number;
+};
+type LogBuffer = {
+    append: (entry: UniversalLogEntry) => void;
+    clear: () => void;
+    getEntries: (limit?: number) => UniversalLogEntry[];
+    getSnapshot: (service: string, limit?: number) => UniversalLogSnapshot;
+    size: () => number;
+};
+
+declare function createConsoleMirror(options: {
+    buffer: LogBuffer;
+    consoleObject?: Console;
+    source?: string;
+}): {
+    restore: () => void;
+};
+
+type ElectronConsoleMessageSource = {
+    on: (event: "console-message", listener: (event: unknown, level: number, message: string, line: number, sourceId: string) => void) => void;
+};
+declare function attachElectronRendererConsoleMirror(options: {
+    buffer: LogBuffer;
+    source?: string;
+    webContents: ElectronConsoleMessageSource;
+}): void;
+
+declare function startHttpLogEndpoint(options: {
+    buffer: LogBuffer;
+    healthPath?: string;
+    host?: string;
+    logsPath?: string;
+    port: number;
+    service: string;
+}): Promise<{
+    close: () => Promise<void>;
+    server: http.Server;
+    url: string;
+}>;
+
+declare function createLogBuffer(options?: {
+    limit?: number;
+}): LogBuffer;
+
+export { type LogBuffer, type UniversalLogEntry, type UniversalLogLevel, type UniversalLogSnapshot, attachElectronRendererConsoleMirror, createConsoleMirror, createLogBuffer, startHttpLogEndpoint };

package/dist/runtime/index.js

@@ -0,0 +1,13 @@
+import {
+  attachElectronRendererConsoleMirror,
+  createConsoleMirror,
+  createLogBuffer,
+  startHttpLogEndpoint
+} from "../chunk-IUSSBPEQ.js";
+export {
+  attachElectronRendererConsoleMirror,
+  createConsoleMirror,
+  createLogBuffer,
+  startHttpLogEndpoint
+};
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "universal-logs",
+  "version": "0.1.0",
+  "description": "CLI and runtime helpers for exposing local log endpoints and reading them from coding agents.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "universal-logs": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "check": "biome check .",
+    "format": "biome format --write .",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "verify": "bun run typecheck && bun run test && bun run check"
+  },
+  "dependencies": {
+    "ws": "^8.18.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.8",
+    "@types/node": "^24.10.2",
+    "@types/ws": "^8.18.1",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.10"
+  }
+}