@spotlightjs/spotlight 4.5.1 → 4.6.0

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sources":["../src/run.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport Module from \"node:module\";\nimport { join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { setContext, startSpan } from \"@sentry/node\";\nimport { main } from \"./server/cli.ts\";\nimport \"./instrument.ts\";\n\nconst require = Module.createRequire(import.meta.url);\nlet sea: any = null;\ntry {\n  // This is to maintain compatibility with Node 20.11- as\n  // the `node:sea` module is added in Node 20.12+\n  sea = require(\"node:sea\");\n} catch {\n  sea = { isSea: () => false };\n}\n\nconst homeDir = process.env.HOME || process.env.USERPROFILE;\nsetContext(\"CLI\", {\n  sea: sea.isSea(),\n  // TODO: Be less naive with path obscuring\n  argv: homeDir ? process.argv.map(arg => arg.replace(homeDir, \"~\")) : process.argv,\n});\n\nconst withTracing = <T extends (...args: any[]) => any>(\n  fn: T,\n  spanArgs = {},\n): ((...args: Parameters<T>) => ReturnType<T>) => {\n  return (...args: Parameters<T>): ReturnType<T> =>\n    startSpan({ name: fn.name, attributes: { args }, ...spanArgs }, () => fn(...args));\n};\n\nconst readAsset = withTracing(\n  sea.isSea()\n    ? (name: string) => Buffer.from(sea.getRawAsset(name))\n    : (() => {\n        const ASSET_DIR = join(fileURLToPath(import.meta.url), \"../../dist/ui/\");\n\n        return (name: string) => readFileSync(join(ASSET_DIR, name));\n      })(),\n  { name: \"readAsset\", op: \"cli.asset.read\" },\n);\n\nstartSpan({ name: \"Spotlight CLI\", op: \"cli\" }, async () => {\n  await startSpan({ name: \"Setup Spotlight\", op: \"cli.setup\" }, async () => {\n    const MANIFEST_NAME = \"manifest.json\";\n    const ENTRY_POINT_NAME = \"index.html\";\n    const filesToServe = Object.create(null);\n\n    if (process.env.NODE_ENV === \"production\") {\n      startSpan({ name: \"Setup Server Assets\", op: \"cli.setup.assets\" }, () => {\n        // Following the guide here: https://vite.dev/guide/backend-integration.html\n        const manifest = JSON.parse(readAsset(MANIFEST_NAME).toString());\n        filesToServe[ENTRY_POINT_NAME] = readAsset(ENTRY_POINT_NAME);\n        const entries = Object.values(manifest);\n        for (const entry of entries) {\n          if (entry && typeof entry === \"object\" && \"file\" in entry && typeof entry.file === \"string\") {\n            filesToServe[entry.file] = readAsset(entry.file);\n          }\n        }\n      });\n    }\n\n    await main({\n      basePath: process.cwd(),\n      filesToServe,\n    });\n  });\n});\n"],"names":["require"],"mappings":";;;;;;;AAQA,MAAMA,WAAU,OAAO,cAAc,YAAY,GAAG;AACpD,IAAI,MAAW;AACf,IAAI;AAGF,QAAMA,SAAQ,UAAU;AAC1B,QAAQ;AACN,QAAM,EAAE,OAAO,MAAM,MAAA;AACvB;AAEA,MAAM,UAAU,QAAQ,IAAI,QAAQ,QAAQ,IAAI;AAChD,WAAW,OAAO;AAAA,EAChB,KAAK,IAAI,MAAA;AAAA;AAAA,EAET,MAAM,UAAU,QAAQ,KAAK,IAAI,CAAA,QAAO,IAAI,QAAQ,SAAS,GAAG,CAAC,IAAI,QAAQ;AAC/E,CAAC;AAED,MAAM,cAAc,CAClB,IACA,WAAW,OACqC;AAChD,SAAO,IAAI,SACT,UAAU,EAAE,MAAM,GAAG,MAAM,YAAY,EAAE,KAAA,GAAQ,GAAG,SAAA,GAAY,MAAM,GAAG,GAAG,IAAI,CAAC;AACrF;AAEA,MAAM,YAAY;AAAA,EAChB,IAAI,MAAA,IACA,CAAC,SAAiB,OAAO,KAAK,IAAI,YAAY,IAAI,CAAC,KAClD,MAAM;AACL,UAAM,YAAY,KAAK,cAAc,YAAY,GAAG,GAAG,gBAAgB;AAEvE,WAAO,CAAC,SAAiB,aAAa,KAAK,WAAW,IAAI,CAAC;AAAA,EAC7D,GAAA;AAAA,EACJ,EAAE,MAAM,aAAa,IAAI,iBAAA;AAC3B;AAEA,UAAU,EAAE,MAAM,iBAAiB,IAAI,MAAA,GAAS,YAAY;AAC1D,QAAM,UAAU,EAAE,MAAM,mBAAmB,IAAI,YAAA,GAAe,YAAY;AACxE,UAAM,gBAAgB;AACtB,UAAM,mBAAmB;AACzB,UAAM,eAAe,uBAAO,OAAO,IAAI;AAEI;AACzC,gBAAU,EAAE,MAAM,uBAAuB,IAAI,mBAAA,GAAsB,MAAM;AAEvE,cAAM,WAAW,KAAK,MAAM,UAAU,aAAa,EAAE,UAAU;AAC/D,qBAAa,gBAAgB,IAAI,UAAU,gBAAgB;AAC3D,cAAM,UAAU,OAAO,OAAO,QAAQ;AACtC,mBAAW,SAAS,SAAS;AAC3B,cAAI,SAAS,OAAO,UAAU,YAAY,UAAU,SAAS,OAAO,MAAM,SAAS,UAAU;AAC3F,yBAAa,MAAM,IAAI,IAAI,UAAU,MAAM,IAAI;AAAA,UACjD;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAEA,UAAM,KAAK;AAAA,MACT,UAAU,QAAQ,IAAA;AAAA,MAClB;AAAA,IAAA,CACD;AAAA,EACH,CAAC;AACH,CAAC;"}

package/dist/sentry-config.d.ts

@@ -0,0 +1,7 @@
+export declare const sentryBaseConfig: {
+    readonly enabled: boolean;
+    readonly environment: string;
+    readonly release: `spotlight@${string}`;
+    readonly tracesSampleRate: 1;
+    readonly enableLogs: true;
+};

package/dist/sentry-config.js

@@ -0,0 +1,11 @@
+const sentryBaseConfig = {
+  enabled: Boolean("production") && true,
+  environment: "production",
+  release: `spotlight@${"4.6.0"}`,
+  tracesSampleRate: 1,
+  enableLogs: true
+};
+export {
+  sentryBaseConfig
+};
+//# sourceMappingURL=sentry-config.js.map

package/dist/sentry-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sentry-config.js","sources":["../src/sentry-config.ts"],"sourcesContent":["export const sentryBaseConfig = {\n  enabled: Boolean(process.env.NODE_ENV) && process.env.NODE_ENV !== \"development\",\n  environment: process.env.NODE_ENV || \"development\",\n  release: `spotlight@${process.env.npm_package_version}`,\n  tracesSampleRate: 1,\n  enableLogs: true,\n} as const;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB;AAAA,EAC9B,SAAS,QAAQ,YAAoB,KAAK;AAAA,EAC1C,aAAa;AAAA,EACb,SAAS,aAAa,OAA+B;AAAA,EACrD,kBAAkB;AAAA,EAClB,YAAY;AACd;"}

package/dist/server/cli/help.d.ts

@@ -0,0 +1 @@
+export default function showHelp(): void;

package/dist/server/cli/help.js

@@ -0,0 +1,38 @@
+import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from "./tail.js";
+import { AVAILABLE_FORMATTERS } from "../formatters/types.js";
+function showHelp() {
+  console.log(`
+Spotlight Sidecar - Development proxy server for Spotlight
+
+Usage: spotlight [command] [options]
+
+Commands:
+  tail [types...]      Tail Sentry events (default: everything)
+                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(", ")}
+                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(", ")}
+  mcp                  Start in MCP (Model Context Protocol) mode
+  help                 Show this help message
+
+Options:
+  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)
+  -d, --debug            Enable debug logging
+  -f, --format <format>  Output format for tail command (default: human)
+                         Available formats: ${[...AVAILABLE_FORMATTERS].join(", ")}
+  -h, --help             Show this help message
+
+Examples:
+  spotlight                          # Start on default port 8969
+  spotlight tail                     # Tail all event types (human format)
+  spotlight tail errors              # Tail only errors
+  spotlight tail errors logs         # Tail errors and logs
+  spotlight tail --format json       # Explicitly use json format
+  spotlight mcp                      # Start in MCP mode
+  spotlight --port 3000              # Start on port 3000
+  spotlight -p 3000 -d               # Start on port 3000 with debug logging
+`);
+  process.exit(0);
+}
+export {
+  showHelp as default
+};
+//# sourceMappingURL=help.js.map

package/dist/server/cli/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sources":["../../../src/server/cli/help.ts"],"sourcesContent":["import { EVERYTHING_MAGIC_WORDS, NAME_TO_TYPE_MAPPING } from \"../cli/tail.ts\";\nimport { AVAILABLE_FORMATTERS } from \"../formatters/types.ts\";\n\nexport default function showHelp() {\n  console.log(`\nSpotlight Sidecar - Development proxy server for Spotlight\n\nUsage: spotlight [command] [options]\n\nCommands:\n  tail [types...]      Tail Sentry events (default: everything)\n                       Available types: ${[...Object.keys(NAME_TO_TYPE_MAPPING)].join(\", \")}\n                       Magic words: ${[...EVERYTHING_MAGIC_WORDS].join(\", \")}\n  mcp                  Start in MCP (Model Context Protocol) mode\n  help                 Show this help message\n\nOptions:\n  -p, --port <port>      Port to listen on (default: 8969, or 0 for random)\n  -d, --debug            Enable debug logging\n  -f, --format <format>  Output format for tail command (default: human)\n                         Available formats: ${[...AVAILABLE_FORMATTERS].join(\", \")}\n  -h, --help             Show this help message\n\nExamples:\n  spotlight                          # Start on default port 8969\n  spotlight tail                     # Tail all event types (human format)\n  spotlight tail errors              # Tail only errors\n  spotlight tail errors logs         # Tail errors and logs\n  spotlight tail --format json       # Explicitly use json format\n  spotlight mcp                      # Start in MCP mode\n  spotlight --port 3000              # Start on port 3000\n  spotlight -p 3000 -d               # Start on port 3000 with debug logging\n`);\n  process.exit(0);\n}\n"],"names":[],"mappings":";;AAGA,SAAwB,WAAW;AACjC,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0CAO4B,CAAC,GAAG,OAAO,KAAK,oBAAoB,CAAC,EAAE,KAAK,IAAI,CAAC;AAAA,sCACrD,CAAC,GAAG,sBAAsB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,8CAQ9B,CAAC,GAAG,oBAAoB,EAAE,KAAK,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAYjF;AACC,UAAQ,KAAK,CAAC;AAChB;"}

package/dist/server/cli/mcp.d.ts

@@ -0,0 +1,2 @@
+import { CLIHandlerOptions } from '../types/cli.ts';
+export default function mcp({ port, basePath, filesToServe }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;

package/dist/server/cli/mcp.js

@@ -0,0 +1,105 @@
+import { Client } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.16.0/node_modules/@modelcontextprotocol/sdk/dist/esm/client/index.js";
+import { StdioServerTransport } from "../../node_modules/.pnpm/@modelcontextprotocol_sdk@1.16.0/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js";
+import { captureException } from "@sentry/node";
+import { startStdioServer, ServerType } from "mcp-proxy";
+import { logger } from "../logger.js";
+import { startServer, setShutdownHandlers } from "../main.js";
+import { createMCPInstance } from "../mcp/mcp.js";
+import { isSidecarRunning } from "../utils/extras.js";
+async function startServerWithStdioMCP(port, basePath, filesToServe) {
+  const serverInstance = await startServer({
+    port,
+    basePath,
+    filesToServe
+  });
+  setShutdownHandlers(serverInstance);
+  logger.info("Starting MCP over stdio too...");
+  const mcpInstance = createMCPInstance();
+  await mcpInstance.connect(new StdioServerTransport());
+  const shutdownMcp = () => {
+    mcpInstance.close();
+  };
+  process.on("SIGINT", shutdownMcp);
+  process.on("SIGTERM", shutdownMcp);
+  return serverInstance;
+}
+async function startMCPStdioHTTPProxy(port, basePath, filesToServe) {
+  let intentionalShutdown = false;
+  let client = null;
+  let server = null;
+  const shutdown = async () => {
+    if (intentionalShutdown) {
+      logger.info("Bye.");
+      process.exit(0);
+    }
+    intentionalShutdown = true;
+    logger.info("Shutting down MCP stdio proxy...");
+    if (client) {
+      await client.close();
+    }
+    if (server) {
+      await server.close();
+    }
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+  server = await startStdioServer({
+    // We need to hook into `initStreamClient` as the returned object from startStdioServer
+    // is not a meta proxy object giving access to both the server and the client. It just
+    // returns the StdioServerTransport instance without a way to access the client or its errors.
+    // TODO: We should probably upstream a fix for this to close the server or bubble the errors
+    initStreamClient: () => {
+      client = new Client({
+        name: "Spotlight Sidecar (stdio proxy)",
+        version: "1.0.0"
+      });
+      client.onerror = async (err) => {
+        if (err.message.startsWith("Maximum reconnection attempts") || /disconnected|fetch failed|connection closed/i.test(err.message)) {
+          if (client) await client.close();
+          if (server) await server.close();
+        } else if (!/conflict/i.test(err.message)) {
+          captureException(err);
+          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);
+        }
+      };
+      return Promise.resolve(client);
+    },
+    serverType: ServerType.HTTPStream,
+    url: `http://localhost:${port}/mcp`
+  });
+  server.onclose = async () => {
+    if (intentionalShutdown) {
+      logger.info("MCP stdio proxy server closed.");
+      return;
+    }
+    logger.info("MCP stdio proxy server closed unexpectedly. Attempting to restart...");
+    process.off("SIGINT", shutdown);
+    process.off("SIGTERM", shutdown);
+    process.stdin.resume();
+    try {
+      await startMCPStdioHTTPProxy(port, basePath, filesToServe);
+      logger.info("Connection restored");
+    } catch (_err) {
+      try {
+        return await startServerWithStdioMCP(port, basePath, filesToServe);
+      } catch (_err2) {
+        logger.error("Failed to restart sidecar server after MCP stdio proxy closed.");
+        captureException(_err2);
+        await startMCPStdioHTTPProxy(port, basePath, filesToServe);
+      }
+    }
+  };
+}
+async function mcp({ port, basePath, filesToServe }) {
+  if (port > 0 && await isSidecarRunning(port)) {
+    logger.info("Connecting to existing MCP instance with stdio proxy...");
+    await startMCPStdioHTTPProxy(port, basePath, filesToServe);
+    logger.info(`Connected to existing MCP instance on port ${port}`);
+  } else {
+    return await startServerWithStdioMCP(port, basePath, filesToServe);
+  }
+}
+export {
+  mcp as default
+};
+//# sourceMappingURL=mcp.js.map

package/dist/server/cli/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sources":["../../../src/server/cli/mcp.ts"],"sourcesContent":["import { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\nimport { captureException } from \"@sentry/node\";\nimport { ServerType as ProxyServerType, startStdioServer } from \"mcp-proxy\";\nimport { logger } from \"../logger.ts\";\nimport { setShutdownHandlers, startServer } from \"../main.ts\";\nimport { createMCPInstance } from \"../mcp/mcp.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport { isSidecarRunning } from \"../utils/extras.ts\";\n\nasync function startServerWithStdioMCP(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n) {\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n  });\n  setShutdownHandlers(serverInstance);\n\n  logger.info(\"Starting MCP over stdio too...\");\n  const mcpInstance = createMCPInstance();\n  await mcpInstance.connect(new StdioServerTransport());\n\n  const shutdownMcp = () => {\n    mcpInstance.close();\n  };\n\n  process.on(\"SIGINT\", shutdownMcp);\n  process.on(\"SIGTERM\", shutdownMcp);\n\n  return serverInstance;\n}\n\nasync function startMCPStdioHTTPProxy(\n  port: CLIHandlerOptions[\"port\"],\n  basePath: CLIHandlerOptions[\"basePath\"],\n  filesToServe: CLIHandlerOptions[\"filesToServe\"],\n) {\n  let intentionalShutdown = false;\n  let client: Client | null = null;\n  let server: Awaited<ReturnType<typeof startStdioServer>> | null = null;\n\n  const shutdown = async () => {\n    if (intentionalShutdown) {\n      // If we get the signal again, exit immediately\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    intentionalShutdown = true;\n    logger.info(\"Shutting down MCP stdio proxy...\");\n\n    if (client) {\n      await client.close();\n    }\n    if (server) {\n      await server.close();\n    }\n  };\n\n  // Set up signal handlers for graceful shutdown\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n\n  server = await startStdioServer({\n    // We need to hook into `initStreamClient` as the returned object from startStdioServer\n    // is not a meta proxy object giving access to both the server and the client. It just\n    // returns the StdioServerTransport instance without a way to access the client or its errors.\n    // TODO: We should probably upstream a fix for this to close the server or bubble the errors\n    initStreamClient: () => {\n      client = new Client({\n        name: \"Spotlight Sidecar (stdio proxy)\",\n        version: \"1.0.0\",\n      });\n      client.onerror = async (err: Error) => {\n        if (\n          err.message.startsWith(\"Maximum reconnection attempts\") ||\n          /disconnected|fetch failed|connection closed/i.test(err.message)\n        ) {\n          if (client) await client.close();\n          if (server) await server.close();\n        } else if (!/conflict/i.test(err.message)) {\n          captureException(err);\n          logger.error(`MCP stdio proxy error: ${err.name}: ${err.message}`);\n        }\n      };\n      return Promise.resolve(client);\n    },\n    serverType: ProxyServerType.HTTPStream,\n    url: `http://localhost:${port}/mcp`,\n  });\n  server.onclose = async () => {\n    // If this is an intentional shutdown, don't restart\n    if (intentionalShutdown) {\n      logger.info(\"MCP stdio proxy server closed.\");\n      return;\n    }\n\n    logger.info(\"MCP stdio proxy server closed unexpectedly. Attempting to restart...\");\n    process.off(\"SIGINT\", shutdown);\n    process.off(\"SIGTERM\", shutdown);\n    // We need to manually resume stdin as `StdioServerTransport` pauses it on\n    // close but does not `resume` it when a new instance is created. Probably\n    // a bug in https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/stdio.ts\n    process.stdin.resume();\n\n    try {\n      await startMCPStdioHTTPProxy(port, basePath, filesToServe);\n      logger.info(\"Connection restored\");\n    } catch (_err) {\n      try {\n        return await startServerWithStdioMCP(port, basePath, filesToServe);\n      } catch (_err2) {\n        logger.error(\"Failed to restart sidecar server after MCP stdio proxy closed.\");\n        captureException(_err2);\n        await startMCPStdioHTTPProxy(port, basePath, filesToServe);\n      }\n    }\n  };\n}\n\nexport default async function mcp({ port, basePath, filesToServe }: CLIHandlerOptions) {\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(\"Connecting to existing MCP instance with stdio proxy...\");\n    await startMCPStdioHTTPProxy(port, basePath, filesToServe);\n    logger.info(`Connected to existing MCP instance on port ${port}`);\n  } else {\n    return await startServerWithStdioMCP(port, basePath, filesToServe);\n  }\n}\n"],"names":["ProxyServerType"],"mappings":";;;;;;;;AAUA,eAAe,wBACb,MACA,UACA,cACA;AACA,QAAM,iBAAiB,MAAM,YAAY;AAAA,IACvC;AAAA,IACA;AAAA,IACA;AAAA,EAAA,CACD;AACD,sBAAoB,cAAc;AAElC,SAAO,KAAK,gCAAgC;AAC5C,QAAM,cAAc,kBAAA;AACpB,QAAM,YAAY,QAAQ,IAAI,sBAAsB;AAEpD,QAAM,cAAc,MAAM;AACxB,gBAAY,MAAA;AAAA,EACd;AAEA,UAAQ,GAAG,UAAU,WAAW;AAChC,UAAQ,GAAG,WAAW,WAAW;AAEjC,SAAO;AACT;AAEA,eAAe,uBACb,MACA,UACA,cACA;AACA,MAAI,sBAAsB;AAC1B,MAAI,SAAwB;AAC5B,MAAI,SAA8D;AAElE,QAAM,WAAW,YAAY;AAC3B,QAAI,qBAAqB;AAEvB,aAAO,KAAK,MAAM;AAClB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,0BAAsB;AACtB,WAAO,KAAK,kCAAkC;AAE9C,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AACA,QAAI,QAAQ;AACV,YAAM,OAAO,MAAA;AAAA,IACf;AAAA,EACF;AAGA,UAAQ,GAAG,UAAU,QAAQ;AAC7B,UAAQ,GAAG,WAAW,QAAQ;AAE9B,WAAS,MAAM,iBAAiB;AAAA;AAAA;AAAA;AAAA;AAAA,IAK9B,kBAAkB,MAAM;AACtB,eAAS,IAAI,OAAO;AAAA,QAClB,MAAM;AAAA,QACN,SAAS;AAAA,MAAA,CACV;AACD,aAAO,UAAU,OAAO,QAAe;AACrC,YACE,IAAI,QAAQ,WAAW,+BAA+B,KACtD,+CAA+C,KAAK,IAAI,OAAO,GAC/D;AACA,cAAI,OAAQ,OAAM,OAAO,MAAA;AACzB,cAAI,OAAQ,OAAM,OAAO,MAAA;AAAA,QAC3B,WAAW,CAAC,YAAY,KAAK,IAAI,OAAO,GAAG;AACzC,2BAAiB,GAAG;AACpB,iBAAO,MAAM,0BAA0B,IAAI,IAAI,KAAK,IAAI,OAAO,EAAE;AAAA,QACnE;AAAA,MACF;AACA,aAAO,QAAQ,QAAQ,MAAM;AAAA,IAC/B;AAAA,IACA,YAAYA,WAAgB;AAAA,IAC5B,KAAK,oBAAoB,IAAI;AAAA,EAAA,CAC9B;AACD,SAAO,UAAU,YAAY;AAE3B,QAAI,qBAAqB;AACvB,aAAO,KAAK,gCAAgC;AAC5C;AAAA,IACF;AAEA,WAAO,KAAK,sEAAsE;AAClF,YAAQ,IAAI,UAAU,QAAQ;AAC9B,YAAQ,IAAI,WAAW,QAAQ;AAI/B,YAAQ,MAAM,OAAA;AAEd,QAAI;AACF,YAAM,uBAAuB,MAAM,UAAU,YAAY;AACzD,aAAO,KAAK,qBAAqB;AAAA,IACnC,SAAS,MAAM;AACb,UAAI;AACF,eAAO,MAAM,wBAAwB,MAAM,UAAU,YAAY;AAAA,MACnE,SAAS,OAAO;AACd,eAAO,MAAM,gEAAgE;AAC7E,yBAAiB,KAAK;AACtB,cAAM,uBAAuB,MAAM,UAAU,YAAY;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AACF;AAEA,eAA8B,IAAI,EAAE,MAAM,UAAU,gBAAmC;AACrF,MAAI,OAAO,KAAM,MAAM,iBAAiB,IAAI,GAAI;AAC9C,WAAO,KAAK,yDAAyD;AACrE,UAAM,uBAAuB,MAAM,UAAU,YAAY;AACzD,WAAO,KAAK,8CAA8C,IAAI,EAAE;AAAA,EAClE,OAAO;AACL,WAAO,MAAM,wBAAwB,MAAM,UAAU,YAAY;AAAA,EACnE;AACF;"}

package/dist/server/cli/run.d.ts

@@ -0,0 +1,2 @@
+import { CLIHandlerOptions } from '../types/cli.ts';
+export default function run({ port, cmdArgs, basePath, filesToServe, format }: CLIHandlerOptions): Promise<void>;

package/dist/server/cli/run.js

@@ -0,0 +1,271 @@
+import { spawn } from "node:child_process";
+import { readFileSync } from "node:fs";
+import * as path from "node:path";
+import * as readline from "node:readline";
+import { Searcher } from "fast-fuzzy";
+import { uuidv7 } from "uuidv7";
+import { SENTRY_CONTENT_TYPE } from "../../shared/constants.js";
+import { logger } from "../logger.js";
+import { detectDockerCompose, buildDockerComposeCommand } from "../utils/docker-compose.js";
+import { getSpotlightURL } from "../utils/extras.js";
+import { getBuffer } from "../utils/getBuffer.js";
+import { EventContainer } from "../utils/eventContainer.js";
+import tail from "./tail.js";
+const SPOTLIGHT_VERSION = "4.6.0";
+const LOCALHOST_HOST = "localhost";
+const DOCKER_HOST = "host.docker.internal";
+function detectPackageJson() {
+  try {
+    const scripts = JSON.parse(readFileSync("./package.json", "utf-8")).scripts;
+    const scriptName = ["dev", "develop", "serve", "start"].find((name) => scripts[name]);
+    if (!scriptName || !scripts[scriptName]) {
+      return null;
+    }
+    return { scriptName, scriptCommand: scripts[scriptName] };
+  } catch {
+  }
+  return null;
+}
+async function promptUserChoice() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    console.log("\n⚠️  Both Docker Compose and package.json detected!");
+    console.log("\nWhich would you like to use?");
+    console.log("  1) docker compose");
+    console.log("  2) package.json");
+    rl.question("Enter your choice (1 or 2): ", (answer) => {
+      rl.close();
+      const choice = answer.trim();
+      const selected = choice === "2" ? "package" : "docker";
+      logger.info(`Selected: ${selected === "docker" ? "Docker compose" : "package.json"}`);
+      resolve(selected);
+    });
+  });
+}
+function createLogEnvelope(level, body, timestamp) {
+  const envelopeHeader = {
+    sdk: {
+      name: "sentry.spotlight.stdio",
+      version: SPOTLIGHT_VERSION
+    }
+  };
+  const logItem = {
+    timestamp,
+    level,
+    body,
+    attributes: {}
+  };
+  const logPayload = {
+    type: "log",
+    event_id: uuidv7(),
+    timestamp,
+    items: [
+      {
+        ...logItem,
+        id: uuidv7(),
+        severity_number: level === "error" ? 17 : 9,
+        // ERROR=17, INFO=9 per OpenTelemetry spec
+        sdk: void 0
+      }
+    ]
+  };
+  const payloadJson = JSON.stringify(logPayload);
+  const payloadBuffer = Buffer.from(payloadJson, "utf-8");
+  const itemHeader = {
+    type: "log",
+    length: payloadBuffer.length,
+    // Use byte length, not string length
+    item_count: 1,
+    content_type: "application/json"
+  };
+  const parts = [JSON.stringify(envelopeHeader), JSON.stringify(itemHeader), payloadJson];
+  return Buffer.from(`${parts.join("\n")}
+`, "utf-8");
+}
+async function run({ port, cmdArgs, basePath, filesToServe, format }) {
+  let relayStdioAsLogs = true;
+  const fuzzySearcher = new Searcher([], {
+    threshold: 0.8,
+    ignoreCase: false
+  });
+  const logChecker = (type, item, envelopeHeader) => {
+    if (type !== "log") return true;
+    const [, payload] = item;
+    const logEvent = payload;
+    if (logEvent.items && logEvent.items.length > 0) {
+      for (const logItem of logEvent.items) {
+        if (envelopeHeader.sdk?.name === "sentry.spotlight.stdio") {
+          continue;
+        }
+        if (!relayStdioAsLogs) continue;
+        const logBody = typeof logItem.body === "string" ? logItem.body : String(logItem.body);
+        const trimmedBody = logBody.trim();
+        if (trimmedBody) {
+          const matches = fuzzySearcher.search(trimmedBody);
+          if (matches.length > 0) {
+            logger.debug("Detected Sentry logging in the process, disabling stdio relay");
+            relayStdioAsLogs = false;
+            return false;
+          }
+        }
+      }
+    }
+    return true;
+  };
+  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format }, logChecker);
+  if (!serverInstance) {
+    logger.error("Failed to start Spotlight sidecar server.");
+    logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);
+    process.exit(1);
+  }
+  const actualServerPort = serverInstance.address().port;
+  const spotlightUrl = getSpotlightURL(actualServerPort, LOCALHOST_HOST);
+  let shell = false;
+  let stdin = void 0;
+  const env = {
+    ...process.env,
+    SENTRY_SPOTLIGHT: spotlightUrl,
+    // We need the one below for Next.js projects -- they only allow NEXT_PUBLIC_ prefixed env vars
+    // on frontend code
+    NEXT_PUBLIC_SENTRY_SPOTLIGHT: spotlightUrl,
+    // This is not supported in all SDKs but worth adding
+    // for the ones that support it
+    SENTRY_TRACES_SAMPLE_RATE: "1"
+  };
+  if (cmdArgs.length === 0) {
+    const dockerCompose = detectDockerCompose();
+    const packageJson = detectPackageJson();
+    if (dockerCompose && packageJson) {
+      if (!process.stdin.isTTY) {
+        logger.error("Both Docker Compose and package.json detected, but cannot prompt in non-interactive mode.");
+        logger.error("Please specify a command explicitly or run in an interactive terminal.");
+        process.exit(1);
+      }
+      const choice = await promptUserChoice();
+      if (choice === "docker") {
+        logger.info(
+          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(", ")}`
+        );
+        env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);
+        const command = buildDockerComposeCommand(dockerCompose);
+        cmdArgs = command.cmdArgs;
+        stdin = command.stdin;
+        delete env.COMPOSE_FILE;
+      } else {
+        logger.info(`Using package.json script: ${packageJson.scriptName}`);
+        cmdArgs = [packageJson.scriptCommand];
+        shell = true;
+        env.PATH = path.resolve("./node_modules/.bin") + path.delimiter + env.PATH;
+      }
+    } else if (dockerCompose) {
+      logger.info(
+        `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(", ")}`
+      );
+      env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);
+      const command = buildDockerComposeCommand(dockerCompose);
+      cmdArgs = command.cmdArgs;
+      stdin = command.stdin;
+      delete env.COMPOSE_FILE;
+    } else if (packageJson) {
+      logger.info(`Using package.json script: ${packageJson.scriptName}`);
+      cmdArgs = [packageJson.scriptCommand];
+      shell = true;
+      env.PATH = path.resolve("./node_modules/.bin") + path.delimiter + env.PATH;
+    }
+  }
+  if (cmdArgs.length === 0) {
+    logger.error("Error: No command specified to run and could not infer the command automatically.");
+    process.exit(1);
+  }
+  const cmdStr = cmdArgs.join(" ");
+  logger.info(`Starting command: ${cmdStr}`);
+  const stdinMode = stdin ? "pipe" : "inherit";
+  const runCmd = spawn(cmdArgs[0], cmdArgs.slice(1), {
+    cwd: process.cwd(),
+    env,
+    shell,
+    windowsVerbatimArguments: true,
+    windowsHide: true,
+    stdio: [stdinMode, "pipe", "pipe"]
+  });
+  const { stdout, stderr } = runCmd;
+  if (!stdout || !stderr) {
+    logger.error("Failed to create process streams");
+    process.exit(1);
+  }
+  if (stdin) {
+    if (!runCmd.stdin) {
+      logger.error("Failed to pipe Docker Compose override: stdin is not available");
+      process.exit(1);
+    }
+    runCmd.stdin.write(stdin);
+    runCmd.stdin.end();
+  }
+  const processLogLine = (line, level) => {
+    if (!relayStdioAsLogs) return;
+    const trimmedLine = line.trim();
+    if (!trimmedLine) return;
+    fuzzySearcher.add(trimmedLine);
+    const timestamp = Date.now() / 1e3;
+    const envelopeBuffer = createLogEnvelope(level, trimmedLine, timestamp);
+    const container = new EventContainer(SENTRY_CONTENT_TYPE, envelopeBuffer);
+    getBuffer().put(container);
+  };
+  let stdoutBuffer = "";
+  let stderrBuffer = "";
+  stdout.on("data", (data) => {
+    stdoutBuffer += data.toString();
+    const lines = stdoutBuffer.split("\n");
+    stdoutBuffer = lines.pop() || "";
+    for (const line of lines) {
+      processLogLine(line, "info");
+    }
+  });
+  stderr.on("data", (data) => {
+    stderrBuffer += data.toString();
+    const lines = stderrBuffer.split("\n");
+    stderrBuffer = lines.pop() || "";
+    for (const line of lines) {
+      processLogLine(line, "error");
+    }
+  });
+  runCmd.on("error", (err) => {
+    logger.error(`Failed to run ${cmdStr}:`);
+    logger.error(err);
+    process.exit(1);
+  });
+  runCmd.on("close", (code) => {
+    if (stdoutBuffer.trim()) {
+      processLogLine(stdoutBuffer, "info");
+    }
+    if (stderrBuffer.trim()) {
+      processLogLine(stderrBuffer, "error");
+    }
+    if (!code) {
+      logger.error(`${cmdStr} exited, terminating.`);
+    } else {
+      logger.error(`${cmdStr} exited with code ${code}.`);
+    }
+    process.exit(code);
+  });
+  const killRunCmd = () => {
+    if (runCmd.killed) return;
+    stdout.destroy();
+    stderr.destroy();
+    runCmd.kill();
+  };
+  runCmd.on("spawn", () => {
+    runCmd.removeAllListeners("spawn");
+    runCmd.removeAllListeners("error");
+    process.on("SIGINT", killRunCmd);
+    process.on("SIGTERM", killRunCmd);
+    process.on("beforeExit", killRunCmd);
+  });
+}
+export {
+  run as default
+};
+//# sourceMappingURL=run.js.map

package/dist/server/cli/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sources":["../../../src/server/cli/run.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { readFileSync } from \"node:fs\";\nimport type { AddressInfo } from \"node:net\";\nimport * as path from \"node:path\";\nimport * as readline from \"node:readline\";\nimport type { SerializedLog } from \"@sentry/core\";\nimport { Searcher } from \"fast-fuzzy\";\nimport { uuidv7 } from \"uuidv7\";\nimport { SENTRY_CONTENT_TYPE } from \"../constants.ts\";\nimport { logger } from \"../logger.ts\";\nimport type { SentryLogEvent } from \"../parser/types.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport { buildDockerComposeCommand, detectDockerCompose } from \"../utils/docker-compose.ts\";\nimport { getSpotlightURL } from \"../utils/extras.ts\";\nimport { EventContainer, getBuffer } from \"../utils/index.ts\";\nimport tail, { type OnItemCallback } from \"./tail.ts\";\n\nconst SPOTLIGHT_VERSION = process.env.npm_package_version || \"unknown\";\n\n// Environment variable host configurations\nconst LOCALHOST_HOST = \"localhost\";\nconst DOCKER_HOST = \"host.docker.internal\";\n\n/**\n * Detect if there's a package.json with runnable scripts\n */\nfunction detectPackageJson(): { scriptName: string; scriptCommand: string } | null {\n  try {\n    const scripts = JSON.parse(readFileSync(\"./package.json\", \"utf-8\")).scripts;\n    const scriptName = [\"dev\", \"develop\", \"serve\", \"start\"].find(name => scripts[name]);\n    if (!scriptName || !scripts[scriptName]) {\n      return null;\n    }\n    return { scriptName, scriptCommand: scripts[scriptName] };\n  } catch {\n    // pass\n  }\n  return null;\n}\n\n/**\n * Prompt the user to choose between Docker Compose and package.json\n */\nasync function promptUserChoice(): Promise<\"docker\" | \"package\"> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  return new Promise(resolve => {\n    console.log(\"\\n⚠️  Both Docker Compose and package.json detected!\");\n    console.log(\"\\nWhich would you like to use?\");\n    console.log(\"  1) docker compose\");\n    console.log(\"  2) package.json\");\n\n    rl.question(\"Enter your choice (1 or 2): \", answer => {\n      rl.close();\n      const choice = answer.trim();\n      const selected = choice === \"2\" ? \"package\" : \"docker\";\n      logger.info(`Selected: ${selected === \"docker\" ? \"Docker compose\" : \"package.json\"}`);\n      resolve(selected);\n    });\n  });\n}\n\nfunction createLogEnvelope(level: \"info\" | \"error\", body: string, timestamp: number): Buffer {\n  const envelopeHeader = {\n    sdk: {\n      name: \"sentry.spotlight.stdio\",\n      version: SPOTLIGHT_VERSION,\n    },\n  };\n\n  const logItem: SerializedLog = {\n    timestamp,\n    level,\n    body,\n    attributes: {},\n  };\n\n  const logPayload: SentryLogEvent = {\n    type: \"log\",\n    event_id: uuidv7(),\n    timestamp,\n    items: [\n      {\n        ...logItem,\n        id: uuidv7(),\n        severity_number: level === \"error\" ? 17 : 9, // ERROR=17, INFO=9 per OpenTelemetry spec\n        sdk: undefined,\n      },\n    ],\n  };\n\n  const payloadJson = JSON.stringify(logPayload);\n  const payloadBuffer = Buffer.from(payloadJson, \"utf-8\");\n\n  const itemHeader = {\n    type: \"log\",\n    length: payloadBuffer.length, // Use byte length, not string length\n    item_count: 1,\n    content_type: \"application/json\",\n  };\n\n  const parts = [JSON.stringify(envelopeHeader), JSON.stringify(itemHeader), payloadJson];\n\n  return Buffer.from(`${parts.join(\"\\n\")}\\n`, \"utf-8\");\n}\n\nexport default async function run({ port, cmdArgs, basePath, filesToServe, format }: CLIHandlerOptions) {\n  let relayStdioAsLogs = true;\n\n  const fuzzySearcher = new Searcher([] as string[], {\n    threshold: 0.8,\n    ignoreCase: false,\n  });\n\n  const logChecker: OnItemCallback = (type, item, envelopeHeader) => {\n    if (type !== \"log\") return true;\n\n    const [, payload] = item;\n    const logEvent = payload as SentryLogEvent;\n\n    if (logEvent.items && logEvent.items.length > 0) {\n      for (const logItem of logEvent.items) {\n        // Check if this is a stdio log from Spotlight itself\n        if (envelopeHeader.sdk?.name === \"sentry.spotlight.stdio\") {\n          continue;\n        }\n\n        if (!relayStdioAsLogs) continue;\n\n        const logBody = typeof logItem.body === \"string\" ? logItem.body : String(logItem.body);\n        const trimmedBody = logBody.trim();\n\n        if (trimmedBody) {\n          const matches = fuzzySearcher.search(trimmedBody);\n          if (matches.length > 0) {\n            logger.debug(\"Detected Sentry logging in the process, disabling stdio relay\");\n            relayStdioAsLogs = false;\n            return false;\n          }\n        }\n      }\n    }\n\n    return true;\n  };\n\n  const serverInstance = await tail({ port, cmdArgs: [], basePath, filesToServe, format }, logChecker);\n  if (!serverInstance) {\n    logger.error(\"Failed to start Spotlight sidecar server.\");\n    logger.error(`The port ${port} might already be in use — most likely by another Spotlight instance.`);\n    process.exit(1);\n  }\n\n  // We *MUST* have an instance address and a port here\n  // as not having that indicates either the server did not start\n  // or started in a weird manner (like over a unix socket)\n  const actualServerPort = (serverInstance.address() as AddressInfo).port;\n  const spotlightUrl = getSpotlightURL(actualServerPort, LOCALHOST_HOST);\n  let shell = false;\n  let stdin: string | undefined = undefined;\n  const env = {\n    ...process.env,\n    SENTRY_SPOTLIGHT: spotlightUrl,\n    // We need the one below for Next.js projects -- they only allow NEXT_PUBLIC_ prefixed env vars\n    // on frontend code\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: spotlightUrl,\n    // This is not supported in all SDKs but worth adding\n    // for the ones that support it\n    SENTRY_TRACES_SAMPLE_RATE: \"1\",\n  } as {\n    PATH: string;\n    SENTRY_SPOTLIGHT: string;\n    NEXT_PUBLIC_SENTRY_SPOTLIGHT: string;\n    SENTRY_TRACES_SAMPLE_RATE: string;\n    [key: string]: string;\n  };\n  if (cmdArgs.length === 0) {\n    const dockerCompose = detectDockerCompose();\n    const packageJson = detectPackageJson();\n\n    // If both Docker Compose and package.json are detected, ask the user which one to use\n    if (dockerCompose && packageJson) {\n      if (!process.stdin.isTTY) {\n        logger.error(\"Both Docker Compose and package.json detected, but cannot prompt in non-interactive mode.\");\n        logger.error(\"Please specify a command explicitly or run in an interactive terminal.\");\n        process.exit(1);\n      }\n      const choice = await promptUserChoice();\n\n      if (choice === \"docker\") {\n        logger.info(\n          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n        );\n        // Use host.docker.internal for backend services to access the host machine\n        env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);\n        const command = buildDockerComposeCommand(dockerCompose);\n        cmdArgs = command.cmdArgs;\n        stdin = command.stdin;\n        // Always unset COMPOSE_FILE to avoid conflicts with explicit -f flags\n        delete env.COMPOSE_FILE;\n      } else {\n        logger.info(`Using package.json script: ${packageJson.scriptName}`);\n        cmdArgs = [packageJson.scriptCommand];\n        shell = true;\n        env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n      }\n    } else if (dockerCompose) {\n      logger.info(\n        `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n      );\n      // Use host.docker.internal for backend services to access the host machine\n      env.SENTRY_SPOTLIGHT = getSpotlightURL(actualServerPort, DOCKER_HOST);\n\n      const command = buildDockerComposeCommand(dockerCompose);\n      cmdArgs = command.cmdArgs;\n      stdin = command.stdin;\n      // Always unset COMPOSE_FILE to avoid conflicts with explicit -f flags\n      delete env.COMPOSE_FILE;\n    } else if (packageJson) {\n      logger.info(`Using package.json script: ${packageJson.scriptName}`);\n      cmdArgs = [packageJson.scriptCommand];\n      shell = true;\n      env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n    }\n  }\n  if (cmdArgs.length === 0) {\n    logger.error(\"Error: No command specified to run and could not infer the command automatically.\");\n    process.exit(1);\n  }\n  const cmdStr = cmdArgs.join(\" \");\n  logger.info(`Starting command: ${cmdStr}`);\n  // When we have Docker Compose override YAML (for -f -), we need to pipe stdin\n  // Otherwise, inherit stdin to relay user input to the downstream process\n  const stdinMode: \"pipe\" | \"inherit\" = stdin ? \"pipe\" : \"inherit\";\n  const runCmd = spawn(cmdArgs[0], cmdArgs.slice(1), {\n    cwd: process.cwd(),\n    env,\n    shell,\n    windowsVerbatimArguments: true,\n    windowsHide: true,\n    stdio: [stdinMode, \"pipe\", \"pipe\"],\n  });\n\n  const { stdout, stderr } = runCmd;\n  if (!stdout || !stderr) {\n    logger.error(\"Failed to create process streams\");\n    process.exit(1);\n  }\n\n  // If our command has a stdin input _and_ we can send to stdin, write and close\n  if (stdin) {\n    if (!runCmd.stdin) {\n      logger.error(\"Failed to pipe Docker Compose override: stdin is not available\");\n      process.exit(1);\n    }\n    runCmd.stdin.write(stdin);\n    runCmd.stdin.end();\n  }\n\n  const processLogLine = (line: string, level: \"info\" | \"error\") => {\n    if (!relayStdioAsLogs) return;\n    const trimmedLine = line.trim();\n    if (!trimmedLine) return;\n\n    fuzzySearcher.add(trimmedLine);\n\n    const timestamp = Date.now() / 1000;\n    const envelopeBuffer = createLogEnvelope(level, trimmedLine, timestamp);\n\n    const container = new EventContainer(SENTRY_CONTENT_TYPE, envelopeBuffer);\n    // Add to buffer - this will automatically trigger all subscribers\n    // including the onEnvelope callback registered in tail()\n    getBuffer().put(container);\n  };\n\n  let stdoutBuffer = \"\";\n  let stderrBuffer = \"\";\n\n  // Stream stdout as info-level logs\n  stdout.on(\"data\", (data: Buffer) => {\n    stdoutBuffer += data.toString();\n    const lines = stdoutBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stdoutBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"info\");\n    }\n  });\n\n  // Stream stderr as error-level logs\n  stderr.on(\"data\", (data: Buffer) => {\n    stderrBuffer += data.toString();\n    const lines = stderrBuffer.split(\"\\n\");\n    // Keep the last partial line in the buffer\n    stderrBuffer = lines.pop() || \"\";\n\n    for (const line of lines) {\n      processLogLine(line, \"error\");\n    }\n  });\n\n  runCmd.on(\"error\", err => {\n    logger.error(`Failed to run ${cmdStr}:`);\n    logger.error(err);\n    process.exit(1);\n  });\n\n  runCmd.on(\"close\", code => {\n    // Handle any remaining buffered lines\n    if (stdoutBuffer.trim()) {\n      processLogLine(stdoutBuffer, \"info\");\n    }\n    if (stderrBuffer.trim()) {\n      processLogLine(stderrBuffer, \"error\");\n    }\n\n    if (!code) {\n      logger.error(`${cmdStr} exited, terminating.`);\n    } else {\n      logger.error(`${cmdStr} exited with code ${code}.`);\n    }\n    process.exit(code);\n  });\n  const killRunCmd = () => {\n    if (runCmd.killed) return;\n    stdout.destroy();\n    stderr.destroy();\n    runCmd.kill();\n  };\n  runCmd.on(\"spawn\", () => {\n    runCmd.removeAllListeners(\"spawn\");\n    runCmd.removeAllListeners(\"error\");\n    process.on(\"SIGINT\", killRunCmd);\n    process.on(\"SIGTERM\", killRunCmd);\n    process.on(\"beforeExit\", killRunCmd);\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/server/cli/server.d.ts

@@ -0,0 +1,2 @@
+import { CLIHandlerOptions } from '../types/cli.ts';
+export default function server({ port, basePath, filesToServe }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;

package/dist/server/cli/server.js

@@ -0,0 +1,13 @@
+import { setupSpotlight } from "../main.js";
+async function server({ port, basePath, filesToServe }) {
+  return await setupSpotlight({
+    port,
+    basePath,
+    filesToServe,
+    isStandalone: true
+  });
+}
+export {
+  server as default
+};
+//# sourceMappingURL=server.js.map

package/dist/server/cli/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sources":["../../../src/server/cli/server.ts"],"sourcesContent":["import { setupSpotlight } from \"../main.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\n\nexport default async function server({ port, basePath, filesToServe }: CLIHandlerOptions) {\n  return await setupSpotlight({\n    port,\n    basePath,\n    filesToServe,\n    isStandalone: true,\n  });\n}\n"],"names":[],"mappings":";AAGA,eAA8B,OAAO,EAAE,MAAM,UAAU,gBAAmC;AACxF,SAAO,MAAM,eAAe;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,EAAA,CACf;AACH;"}

package/dist/server/cli/tail.d.ts

@@ -0,0 +1,8 @@
+import { ServerType } from '@hono/node-server';
+import { ParsedEnvelope } from '../parser/index.ts';
+import { CLIHandlerOptions } from '../types/cli.ts';
+export type OnItemCallback = (type: string, item: ParsedEnvelope["envelope"][1][number], envelopeHeader: ParsedEnvelope["envelope"][0]) => boolean;
+export declare const NAME_TO_TYPE_MAPPING: Record<string, string[]>;
+export declare const EVERYTHING_MAGIC_WORDS: Set<string>;
+export declare const SUPPORTED_TAIL_ARGS: Set<string>;
+export default function tail({ port, cmdArgs, basePath, filesToServe, format }: CLIHandlerOptions, onItem?: OnItemCallback): Promise<ServerType | undefined>;