@spotlightjs/spotlight 4.5.1 → 4.7.0

package/dist/server/cli/tail.js

@@ -0,0 +1,113 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "f35053fc-26c9-45cd-b2da-1b59b921e9cb", e._sentryDebugIdIdentifier = "sentry-dbid-f35053fc-26c9-45cd-b2da-1b59b921e9cb");
+  } catch (e2) {
+  }
+}();
+import { captureException } from "@sentry/core";
+import { metrics } from "@sentry/node";
+import { EventSource } from "eventsource";
+import { SENTRY_CONTENT_TYPE } from "../../shared/constants.js";
+import "../../_virtual/_sentry-release-injection-file.js";
+import { applyFormatter } from "../formatters/index.js";
+import { logger } from "../logger.js";
+import { setupSpotlight } from "../main.js";
+import { getSpotlightURL } from "../utils/extras.js";
+import { getBuffer } from "../utils/getBuffer.js";
+import "../parser/helpers.js";
+import "uuidv7";
+import "node:dns/promises";
+import "node:net";
+import "node:os";
+import { formatters } from "../formatters/human/index.js";
+import { formatters as formatters$1 } from "../formatters/json/index.js";
+import { formatters as formatters$2 } from "../formatters/logfmt/index.js";
+import { formatters as formatters$3 } from "../formatters/md/index.js";
+const NAME_TO_TYPE_MAPPING = Object.freeze({
+  traces: ["transaction", "span"],
+  // profiles: ["profile"],
+  logs: ["log"],
+  attachments: ["attachment"],
+  errors: ["event"]
+  // sessions: ["session"],
+  // replays: ["replay_video"],
+  // client_report
+});
+const SUPPORTED_ENVELOPE_TYPES = new Set(Object.values(NAME_TO_TYPE_MAPPING).flat());
+const EVERYTHING_MAGIC_WORDS = /* @__PURE__ */ new Set(["everything", "all", "*"]);
+const SUPPORTED_TAIL_ARGS = /* @__PURE__ */ new Set([...Object.keys(NAME_TO_TYPE_MAPPING), ...EVERYTHING_MAGIC_WORDS]);
+const FORMATTERS = {
+  md: formatters$3,
+  logfmt: formatters$2,
+  json: formatters$1,
+  human: formatters
+};
+const connectUpstream = async (port) => new Promise((resolve, reject) => {
+  const client = new EventSource(getSpotlightURL(port));
+  client.onerror = reject;
+  client.onopen = () => resolve(client);
+});
+async function tail({ port, cmdArgs, basePath, filesToServe, format = "logfmt", allowedOrigins }, onItem) {
+  const eventTypes = cmdArgs.length > 0 ? cmdArgs.map((arg) => arg.toLowerCase()) : ["everything"];
+  for (const eventType of eventTypes) {
+    if (!SUPPORTED_TAIL_ARGS.has(eventType)) {
+      logger.error(`Error: Unsupported argument "${eventType}".`);
+      logger.error(`Supported arguments are: ${[...SUPPORTED_TAIL_ARGS].join(", ")}`);
+      process.exit(1);
+    }
+  }
+  for (const eventType of eventTypes) {
+    metrics.count("cli.tail.event_type", 1, { attributes: { type: eventType } });
+  }
+  const formatter = FORMATTERS[format];
+  const types = eventTypes.some((type) => EVERYTHING_MAGIC_WORDS.has(type)) ? SUPPORTED_ENVELOPE_TYPES : /* @__PURE__ */ new Set([...eventTypes.flatMap((type) => NAME_TO_TYPE_MAPPING[type] || [])]);
+  const onEnvelope = (envelope) => {
+    const [envelopeHeader, items] = envelope;
+    const formatted = [];
+    for (const item of items) {
+      const [{ type }, payload] = item;
+      if (!type || !types.has(type)) {
+        continue;
+      }
+      if (!(type in formatter)) {
+        continue;
+      }
+      if (onItem && !onItem(type, item, envelopeHeader)) {
+        continue;
+      }
+      formatted.push(...applyFormatter(formatter, type, payload, envelopeHeader));
+    }
+    if (formatted.length > 0) {
+      console.log(formatted.join("\n"));
+    }
+  };
+  try {
+    const client = await connectUpstream(port);
+    client.addEventListener(SENTRY_CONTENT_TYPE, (event) => onEnvelope(JSON.parse(event.data)));
+    return void 0;
+  } catch (err) {
+    if (err instanceof Error && !err.message?.includes(port.toString())) {
+      captureException(err);
+      logger.error("Error when trying to connect to upstream sidecar:");
+      logger.error(err);
+      process.exit(1);
+    }
+  }
+  const serverInstance = await setupSpotlight({ port, filesToServe, basePath, isStandalone: true, allowedOrigins });
+  getBuffer().subscribe((container) => {
+    const parsedEnvelope = container.getParsedEnvelope();
+    if (parsedEnvelope) {
+      onEnvelope(parsedEnvelope.envelope);
+    }
+  });
+  return serverInstance;
+}
+export {
+  EVERYTHING_MAGIC_WORDS,
+  NAME_TO_TYPE_MAPPING,
+  SUPPORTED_TAIL_ARGS,
+  tail as default
+};
+//# sourceMappingURL=tail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sources":["../../../src/server/cli/tail.ts"],"sourcesContent":["import type { ServerType } from \"@hono/node-server\";\nimport { captureException } from \"@sentry/core\";\nimport { metrics } from \"@sentry/node\";\nimport { EventSource } from \"eventsource\";\nimport { SENTRY_CONTENT_TYPE } from \"../constants.ts\";\nimport {\n  type FormatterRegistry,\n  type FormatterType,\n  applyFormatter,\n  humanFormatters,\n  jsonFormatters,\n  logfmtFormatters,\n  mdFormatters,\n} from \"../formatters/index.ts\";\nimport { logger } from \"../logger.ts\";\nimport { setupSpotlight } from \"../main.ts\";\nimport type { ParsedEnvelope } from \"../parser/index.ts\";\nimport type { CLIHandlerOptions } from \"../types/cli.ts\";\nimport { getSpotlightURL } from \"../utils/extras.ts\";\nimport { getBuffer } from \"../utils/index.ts\";\n\nexport type OnItemCallback = (\n  type: string,\n  item: ParsedEnvelope[\"envelope\"][1][number],\n  envelopeHeader: ParsedEnvelope[\"envelope\"][0],\n) => boolean;\nexport const NAME_TO_TYPE_MAPPING: Record<string, string[]> = Object.freeze({\n  traces: [\"transaction\", \"span\"],\n  // profiles: [\"profile\"],\n  logs: [\"log\"],\n  attachments: [\"attachment\"],\n  errors: [\"event\"],\n  // sessions: [\"session\"],\n  // replays: [\"replay_video\"],\n  // client_report\n});\n\nconst SUPPORTED_ENVELOPE_TYPES = new Set(Object.values(NAME_TO_TYPE_MAPPING).flat());\nexport const EVERYTHING_MAGIC_WORDS = new Set([\"everything\", \"all\", \"*\"]);\nexport const SUPPORTED_TAIL_ARGS = new Set([...Object.keys(NAME_TO_TYPE_MAPPING), ...EVERYTHING_MAGIC_WORDS]);\n\nconst FORMATTERS: Record<FormatterType, FormatterRegistry> = {\n  md: mdFormatters,\n  logfmt: logfmtFormatters,\n  json: jsonFormatters,\n  human: humanFormatters,\n};\n\nconst connectUpstream = async (port: number) =>\n  new Promise<EventSource>((resolve, reject) => {\n    const client = new EventSource(getSpotlightURL(port));\n    client.onerror = reject;\n    client.onopen = () => resolve(client);\n  });\n\nexport default async function tail(\n  { port, cmdArgs, basePath, filesToServe, format = \"logfmt\", allowedOrigins }: CLIHandlerOptions,\n  onItem?: OnItemCallback,\n): Promise<ServerType | undefined> {\n  const eventTypes = cmdArgs.length > 0 ? cmdArgs.map(arg => arg.toLowerCase()) : [\"everything\"];\n  for (const eventType of eventTypes) {\n    if (!SUPPORTED_TAIL_ARGS.has(eventType)) {\n      logger.error(`Error: Unsupported argument \"${eventType}\".`);\n      logger.error(`Supported arguments are: ${[...SUPPORTED_TAIL_ARGS].join(\", \")}`);\n      process.exit(1);\n    }\n  }\n\n  // Track which event types users tail\n  for (const eventType of eventTypes) {\n    metrics.count(\"cli.tail.event_type\", 1, { attributes: { type: eventType } });\n  }\n\n  const formatter = FORMATTERS[format];\n  const types = eventTypes.some(type => EVERYTHING_MAGIC_WORDS.has(type))\n    ? SUPPORTED_ENVELOPE_TYPES\n    : new Set([...eventTypes.flatMap(type => NAME_TO_TYPE_MAPPING[type] || [])]);\n  const onEnvelope: (envelope: ParsedEnvelope[\"envelope\"]) => void = envelope => {\n    const [envelopeHeader, items] = envelope;\n    const formatted: string[] = [];\n\n    for (const item of items) {\n      const [{ type }, payload] = item;\n\n      if (!type || !types.has(type)) {\n        // Skip if not a type we're interested in\n        continue;\n      }\n\n      // Check if this event type is supported by the formatter\n      if (!(type in formatter)) {\n        continue;\n      }\n\n      if (onItem && !onItem(type, item, envelopeHeader)) {\n        continue;\n      }\n\n      formatted.push(...applyFormatter(formatter, type as keyof FormatterRegistry, payload, envelopeHeader));\n    }\n\n    if (formatted.length > 0) {\n      console.log(formatted.join(\"\\n\"));\n    }\n  };\n\n  // try to connect to an already existing server first\n  try {\n    const client = await connectUpstream(port);\n    client.addEventListener(SENTRY_CONTENT_TYPE, event => onEnvelope!(JSON.parse(event.data)));\n    // Early return - don't start our own server if we can connect to an upstream one\n    return undefined;\n  } catch (err) {\n    // if we fail, fine then we'll start our own\n    if (err instanceof Error && !err.message?.includes(port.toString())) {\n      captureException(err);\n      logger.error(\"Error when trying to connect to upstream sidecar:\");\n      logger.error(err);\n      process.exit(1);\n    }\n  }\n\n  const serverInstance = await setupSpotlight({ port, filesToServe, basePath, isStandalone: true, allowedOrigins });\n\n  // Subscribe the onEnvelope callback to the message buffer\n  // This ensures it gets called whenever any envelope is added to the buffer\n  getBuffer().subscribe(container => {\n    const parsedEnvelope = container.getParsedEnvelope();\n    if (parsedEnvelope) {\n      onEnvelope(parsedEnvelope.envelope);\n    }\n  });\n\n  return serverInstance;\n}\n"],"names":["mdFormatters","logfmtFormatters","jsonFormatters","humanFormatters"],"mappings":"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"}

package/dist/server/cli.d.ts

@@ -0,0 +1,17 @@
+import { FormatterType } from './formatters/types.ts';
+import { CLIHandler, CLIHandlerOptions } from './types/cli.ts';
+export type CLIArgs = {
+    port: number;
+    debug: boolean;
+    help: boolean;
+    format: FormatterType;
+    cmd: string | undefined;
+    cmdArgs: string[];
+    allowedOrigins: string[];
+};
+export declare function parseCLIArgs(): CLIArgs;
+export declare const CLI_CMD_MAP: Map<string | undefined, CLIHandler>;
+export declare function main({ basePath, filesToServe, }?: {
+    basePath?: CLIHandlerOptions["basePath"];
+    filesToServe?: CLIHandlerOptions["filesToServe"];
+}): Promise<any>;

package/dist/server/cli.js

@@ -0,0 +1,146 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "dec52abc-85c7-4e57-b5d4-f48ea3ffc407", e._sentryDebugIdIdentifier = "sentry-dbid-dec52abc-85c7-4e57-b5d4-f48ea3ffc407");
+  } catch (e2) {
+  }
+}();
+import { parseArgs } from "node:util";
+import { metrics } from "@sentry/node";
+import showHelp from "./cli/help.js";
+import mcp from "./cli/mcp.js";
+import run from "./cli/run.js";
+import server from "./cli/server.js";
+import tail from "./cli/tail.js";
+import { DEFAULT_PORT } from "./constants.js";
+import { AVAILABLE_FORMATTERS } from "./formatters/types.js";
+import { enableDebugLogging, logger } from "./logger.js";
+import "../_virtual/_sentry-release-injection-file.js";
+const MAGIC_PORT_FOR_DYNAMIC_ASSIGNMENT = 0;
+const PARSE_ARGS_CONFIG = {
+  options: {
+    port: {
+      type: "string",
+      short: "p",
+      default: void 0
+    },
+    debug: {
+      type: "boolean",
+      short: "d",
+      default: false
+    },
+    format: {
+      type: "string",
+      short: "f",
+      default: "human"
+    },
+    "allowed-origin": {
+      type: "string",
+      short: "A",
+      multiple: true,
+      default: []
+    },
+    // Deprecated -- use the positional `mcp` argument instead
+    "stdio-mcp": {
+      type: "boolean",
+      default: false
+    },
+    help: {
+      type: "boolean",
+      short: "h",
+      default: false
+    }
+  },
+  allowPositionals: true,
+  strict: true
+};
+function parseCLIArgs() {
+  const args = Array.from(process.argv).slice(2);
+  const preParse = parseArgs({
+    ...PARSE_ARGS_CONFIG,
+    strict: false,
+    tokens: true
+  });
+  let cmdArgs = void 0;
+  const runToken = preParse.tokens.find((token) => token.kind === "positional" && token.value === "run");
+  if (runToken) {
+    const cutOff = preParse.tokens.find((token) => token.index > runToken.index && token.kind === "positional");
+    cmdArgs = cutOff ? args.splice(cutOff.index) : [];
+  }
+  const { values, positionals } = parseArgs({
+    args,
+    ...PARSE_ARGS_CONFIG
+  });
+  const portInput = positionals.length === 1 && /^\d{1,5}$/.test(positionals[0]) ? positionals.shift() : values.port;
+  const port = portInput != null ? Number(portInput) : runToken ? MAGIC_PORT_FOR_DYNAMIC_ASSIGNMENT : DEFAULT_PORT;
+  if (Number.isNaN(port)) {
+    console.error(`Error: Invalid port number '${portInput}'`);
+    console.error("Port must be a valid number between 1 and 65535");
+    process.exit(1);
+  }
+  if (port < 0 || port > 65535) {
+    console.error(`Error: Port ${port} is out of valid range (1-65535 or 0 for automatic assignment)`);
+    process.exit(1);
+  }
+  if (values["stdio-mcp"]) {
+    positionals.unshift("mcp");
+    console.warn("Warning: --stdio-mcp is deprecated. Please use the positional argument 'mcp' instead.");
+  }
+  const format = values.format;
+  if (!AVAILABLE_FORMATTERS.includes(format)) {
+    console.error(`Error: Invalid format '${format}'`);
+    console.error(`Valid formats are: ${AVAILABLE_FORMATTERS.join(", ")}`);
+    process.exit(1);
+  }
+  const allowedOriginInput = values["allowed-origin"];
+  const allowedOrigins = allowedOriginInput.flatMap((origin) => origin.split(",").map((o) => o.trim())).filter(Boolean);
+  const result = {
+    debug: values.debug,
+    help: values.help,
+    format,
+    port,
+    cmd: positionals[0],
+    cmdArgs: cmdArgs ?? positionals.slice(1),
+    allowedOrigins
+  };
+  return result;
+}
+const CLI_CMD_MAP = /* @__PURE__ */ new Map([
+  ["help", showHelp],
+  ["mcp", mcp],
+  ["tail", tail],
+  ["run", run],
+  ["server", server],
+  [void 0, server]
+]);
+async function main({
+  basePath,
+  filesToServe
+} = {}) {
+  let { cmd, cmdArgs, help, port, debug, format, allowedOrigins } = parseCLIArgs();
+  if (debug || process.env.SPOTLIGHT_DEBUG) {
+    enableDebugLogging(true);
+  }
+  const spotlightVersion = "4.7.0";
+  logger.info(`Spotlight by Sentry - v${spotlightVersion}`);
+  metrics.count("cli.invocation", 1, {
+    attributes: {
+      command: cmd || "server",
+      format,
+      debug: String(debug)
+    }
+  });
+  if (help) {
+    cmd = "help";
+    cmdArgs = [];
+  }
+  const handler = CLI_CMD_MAP.get(cmd) || showHelp;
+  return await handler({ cmd, cmdArgs, port, help, debug, format, basePath, filesToServe, allowedOrigins });
+}
+export {
+  CLI_CMD_MAP,
+  main,
+  parseCLIArgs
+};
+//# sourceMappingURL=cli.js.map

package/dist/server/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../../src/server/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { metrics } from \"@sentry/node\";\nimport showHelp from \"./cli/help.ts\";\nimport mcp from \"./cli/mcp.ts\";\nimport run from \"./cli/run.ts\";\nimport server from \"./cli/server.ts\";\nimport tail from \"./cli/tail.ts\";\nimport { DEFAULT_PORT } from \"./constants.ts\";\nimport { AVAILABLE_FORMATTERS } from \"./formatters/types.ts\";\nimport type { FormatterType } from \"./formatters/types.ts\";\nimport { enableDebugLogging, logger } from \"./logger.ts\";\nimport type { CLIHandler, CLIHandlerOptions } from \"./types/cli.ts\";\n\n// When port is set to `0` for a server to listen on,\n// it tells the OS to find a random available port.\n// This can then be retrieved after the server starts.\nconst MAGIC_PORT_FOR_DYNAMIC_ASSIGNMENT = 0;\nconst PARSE_ARGS_CONFIG = {\n  options: {\n    port: {\n      type: \"string\",\n      short: \"p\",\n      default: undefined,\n    },\n    debug: {\n      type: \"boolean\",\n      short: \"d\",\n      default: false,\n    },\n    format: {\n      type: \"string\",\n      short: \"f\",\n      default: \"human\",\n    },\n    \"allowed-origin\": {\n      type: \"string\",\n      short: \"A\",\n      multiple: true,\n      default: [] as string[],\n    },\n    // Deprecated -- use the positional `mcp` argument instead\n    \"stdio-mcp\": {\n      type: \"boolean\",\n      default: false,\n    },\n    help: {\n      type: \"boolean\",\n      short: \"h\",\n      default: false,\n    },\n  },\n  allowPositionals: true,\n  strict: true,\n} as const;\n\nexport type CLIArgs = {\n  port: number;\n  debug: boolean;\n  help: boolean;\n  format: FormatterType;\n  cmd: string | undefined;\n  cmdArgs: string[];\n  allowedOrigins: string[];\n};\n\nexport function parseCLIArgs(): CLIArgs {\n  const args = Array.from(process.argv).slice(2);\n  const preParse = parseArgs({\n    ...PARSE_ARGS_CONFIG,\n    strict: false,\n    tokens: true,\n  });\n  let cmdArgs: string[] | undefined = undefined;\n  const runToken = preParse.tokens.find(token => token.kind === \"positional\" && token.value === \"run\");\n  if (runToken) {\n    const cutOff = preParse.tokens.find(token => token.index > runToken.index && token.kind === \"positional\");\n    cmdArgs = cutOff ? args.splice(cutOff.index) : [];\n  }\n  const { values, positionals } = parseArgs({\n    args,\n    ...PARSE_ARGS_CONFIG,\n  });\n\n  // Handle legacy positional argument for port (backwards compatibility)\n  const portInput = positionals.length === 1 && /^\\d{1,5}$/.test(positionals[0]) ? positionals.shift() : values.port;\n\n  const port = portInput != null ? Number(portInput) : runToken ? MAGIC_PORT_FOR_DYNAMIC_ASSIGNMENT : DEFAULT_PORT;\n  if (Number.isNaN(port)) {\n    // Validate port number\n    console.error(`Error: Invalid port number '${portInput}'`);\n    console.error(\"Port must be a valid number between 1 and 65535\");\n    process.exit(1);\n  }\n\n  if (port < 0 || port > 65535) {\n    console.error(`Error: Port ${port} is out of valid range (1-65535 or 0 for automatic assignment)`);\n    process.exit(1);\n  }\n\n  if (values[\"stdio-mcp\"]) {\n    positionals.unshift(\"mcp\");\n    console.warn(\"Warning: --stdio-mcp is deprecated. Please use the positional argument 'mcp' instead.\");\n  }\n\n  const format = values.format as string;\n  if (!AVAILABLE_FORMATTERS.includes(format as FormatterType)) {\n    console.error(`Error: Invalid format '${format}'`);\n    console.error(`Valid formats are: ${AVAILABLE_FORMATTERS.join(\", \")}`);\n    process.exit(1);\n  }\n\n  // Parse allowed origins - supports both repeatable flags and comma-separated values\n  const allowedOriginInput = values[\"allowed-origin\"] as string[];\n  const allowedOrigins = allowedOriginInput.flatMap(origin => origin.split(\",\").map(o => o.trim())).filter(Boolean);\n\n  const result: CLIArgs = {\n    debug: values.debug as boolean,\n    help: values.help as boolean,\n    format: format as FormatterType,\n    port,\n    cmd: positionals[0],\n    cmdArgs: cmdArgs ?? positionals.slice(1),\n    allowedOrigins,\n  };\n\n  return result;\n}\nexport const CLI_CMD_MAP = new Map<string | undefined, CLIHandler>([\n  [\"help\", showHelp],\n  [\"mcp\", mcp],\n  [\"tail\", tail],\n  [\"run\", run],\n  [\"server\", server],\n  [undefined, server],\n]);\n\nexport async function main({\n  basePath,\n  filesToServe,\n}: { basePath?: CLIHandlerOptions[\"basePath\"]; filesToServe?: CLIHandlerOptions[\"filesToServe\"] } = {}) {\n  let { cmd, cmdArgs, help, port, debug, format, allowedOrigins } = parseCLIArgs();\n  if (debug || process.env.SPOTLIGHT_DEBUG) {\n    enableDebugLogging(true);\n  }\n  const spotlightVersion = process.env.npm_package_version || \"{unknown}\";\n  logger.info(`Spotlight by Sentry - v${spotlightVersion}`);\n\n  metrics.count(\"cli.invocation\", 1, {\n    attributes: {\n      command: cmd || \"server\",\n      format,\n      debug: String(debug),\n    },\n  });\n\n  if (help) {\n    cmd = \"help\";\n    cmdArgs = [];\n  }\n\n  const handler = CLI_CMD_MAP.get(cmd) || showHelp;\n\n  return await handler({ cmd, cmdArgs, port, help, debug, format, basePath, filesToServe, allowedOrigins });\n}\n"],"names":[],"mappings":"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"}

package/dist/server/constants.d.ts

@@ -0,0 +1,3 @@
+export { CONTEXT_LINES_ENDPOINT, RAW_TYPES, SENTRY_CONTENT_TYPE } from '../shared/constants.ts';
+export declare const DEFAULT_PORT = 8969;
+export declare const SERVER_IDENTIFIER = "spotlight-by-sentry";

package/dist/server/constants.js

@@ -0,0 +1,16 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "bf986a16-cf7c-49bb-90cf-ea2bc54c2015", e._sentryDebugIdIdentifier = "sentry-dbid-bf986a16-cf7c-49bb-90cf-ea2bc54c2015");
+  } catch (e2) {
+  }
+}();
+import "../_virtual/_sentry-release-injection-file.js";
+const DEFAULT_PORT = 8969;
+const SERVER_IDENTIFIER = "spotlight-by-sentry";
+export {
+  DEFAULT_PORT,
+  SERVER_IDENTIFIER
+};
+//# sourceMappingURL=constants.js.map

package/dist/server/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sources":["../../src/server/constants.ts"],"sourcesContent":["// Re-export shared constants\nexport { CONTEXT_LINES_ENDPOINT, RAW_TYPES, SENTRY_CONTENT_TYPE } from \"../shared/constants.ts\";\n\n// Spotlight server constants\nexport const DEFAULT_PORT = 8969;\nexport const SERVER_IDENTIFIER = \"spotlight-by-sentry\";\n"],"names":[],"mappings":";;;;;;;;;AAIO,MAAM,eAAe;AACrB,MAAM,oBAAoB;"}

package/dist/server/formatters/human/errors.d.ts

@@ -0,0 +1,6 @@
+import { Envelope } from '@sentry/core';
+import { SentryErrorEvent } from '../../parser/index.ts';
+/**
+ * Format an error event with envelope headers for source inference
+ */
+export declare function formatError(event: SentryErrorEvent, envelopeHeader: Envelope[0]): string[];

package/dist/server/formatters/human/errors.js

@@ -0,0 +1,37 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df48d045-c98f-4e83-b67a-1ef1520d0a1a", e._sentryDebugIdIdentifier = "sentry-dbid-df48d045-c98f-4e83-b67a-1ef1520d0a1a");
+  } catch (e2) {
+  }
+}();
+import { inferEnvelopeSource, formatLogLine } from "./utils.js";
+import "../../../_virtual/_sentry-release-injection-file.js";
+function formatError(event, envelopeHeader) {
+  const source = inferEnvelopeSource(envelopeHeader, event);
+  const exception = event.exception?.values?.[0];
+  const errorType = exception?.type || "Error";
+  const errorValue = exception?.value || event.message || "Unknown error";
+  let message = `${errorType}: ${errorValue}`;
+  const frames = exception?.stacktrace?.frames;
+  if (frames?.length) {
+    const frame = frames.find((f) => f.in_app) || frames[frames.length - 1];
+    if (frame) {
+      if (frame.filename && frame.lineno) {
+        const location = frame.colno ? `${frame.filename}:${frame.lineno}:${frame.colno}` : `${frame.filename}:${frame.lineno}`;
+        message += ` [${location}]`;
+      } else if (frame.filename) {
+        message += ` [${frame.filename}]`;
+      }
+      if (frame.function && !message.includes(frame.function)) {
+        message += ` [${frame.function}]`;
+      }
+    }
+  }
+  return [formatLogLine(event.timestamp, source, "error", message)];
+}
+export {
+  formatError
+};
+//# sourceMappingURL=errors.js.map

package/dist/server/formatters/human/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sources":["../../../../src/server/formatters/human/errors.ts"],"sourcesContent":["import type { Envelope } from \"@sentry/core\";\nimport type { SentryErrorEvent } from \"../../parser/index.ts\";\nimport { formatLogLine, inferEnvelopeSource } from \"./utils.ts\";\n\n/**\n * Format an error event with envelope headers for source inference\n */\nexport function formatError(event: SentryErrorEvent, envelopeHeader: Envelope[0]): string[] {\n  const source = inferEnvelopeSource(envelopeHeader, event);\n\n  const exception = event.exception?.values?.[0];\n  const errorType = exception?.type || \"Error\";\n  const errorValue = exception?.value || event.message || \"Unknown error\";\n\n  let message = `${errorType}: ${errorValue}`;\n\n  const frames = exception?.stacktrace?.frames;\n  if (frames?.length) {\n    const frame = frames.find((f: any) => f.in_app) || frames[frames.length - 1];\n    if (frame) {\n      if (frame.filename && frame.lineno) {\n        const location = frame.colno\n          ? `${frame.filename}:${frame.lineno}:${frame.colno}`\n          : `${frame.filename}:${frame.lineno}`;\n        message += ` [${location}]`;\n      } else if (frame.filename) {\n        message += ` [${frame.filename}]`;\n      }\n\n      if (frame.function && !message.includes(frame.function)) {\n        message += ` [${frame.function}]`;\n      }\n    }\n  }\n\n  return [formatLogLine(event.timestamp, source, \"error\", message)];\n}\n"],"names":[],"mappings":";;;;;;;;;;AAOO,SAAS,YAAY,OAAyB,gBAAuC;AAC1F,QAAM,SAAS,oBAAoB,gBAAgB,KAAK;AAExD,QAAM,YAAY,MAAM,WAAW,SAAS,CAAC;AAC7C,QAAM,YAAY,WAAW,QAAQ;AACrC,QAAM,aAAa,WAAW,SAAS,MAAM,WAAW;AAExD,MAAI,UAAU,GAAG,SAAS,KAAK,UAAU;AAEzC,QAAM,SAAS,WAAW,YAAY;AACtC,MAAI,QAAQ,QAAQ;AAClB,UAAM,QAAQ,OAAO,KAAK,CAAC,MAAW,EAAE,MAAM,KAAK,OAAO,OAAO,SAAS,CAAC;AAC3E,QAAI,OAAO;AACT,UAAI,MAAM,YAAY,MAAM,QAAQ;AAClC,cAAM,WAAW,MAAM,QACnB,GAAG,MAAM,QAAQ,IAAI,MAAM,MAAM,IAAI,MAAM,KAAK,KAChD,GAAG,MAAM,QAAQ,IAAI,MAAM,MAAM;AACrC,mBAAW,KAAK,QAAQ;AAAA,MAC1B,WAAW,MAAM,UAAU;AACzB,mBAAW,KAAK,MAAM,QAAQ;AAAA,MAChC;AAEA,UAAI,MAAM,YAAY,CAAC,QAAQ,SAAS,MAAM,QAAQ,GAAG;AACvD,mBAAW,KAAK,MAAM,QAAQ;AAAA,MAChC;AAAA,IACF;AAAA,EACF;AAEA,SAAO,CAAC,cAAc,MAAM,WAAW,QAAQ,SAAS,OAAO,CAAC;AAClE;"}

package/dist/server/formatters/human/index.d.ts

@@ -0,0 +1,2 @@
+import { FormatterRegistry } from '../types.ts';
+export declare const formatters: FormatterRegistry;

package/dist/server/formatters/human/index.js

@@ -0,0 +1,22 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "07c7f71c-5201-4f0b-ad81-eae990612a3f", e._sentryDebugIdIdentifier = "sentry-dbid-07c7f71c-5201-4f0b-ad81-eae990612a3f");
+  } catch (e2) {
+  }
+}();
+import { isTraceEvent, isLogEvent, isErrorEvent } from "../../parser/helpers.js";
+import { formatError } from "./errors.js";
+import { formatLog } from "./logs.js";
+import { formatTrace } from "./traces.js";
+import "../../../_virtual/_sentry-release-injection-file.js";
+const formatters = {
+  event: { typeGuard: isErrorEvent, format: formatError },
+  log: { typeGuard: isLogEvent, format: formatLog },
+  transaction: { typeGuard: isTraceEvent, format: formatTrace }
+};
+export {
+  formatters
+};
+//# sourceMappingURL=index.js.map

package/dist/server/formatters/human/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/server/formatters/human/index.ts"],"sourcesContent":["import { isErrorEvent, isLogEvent, isTraceEvent } from \"../../parser/helpers.ts\";\nimport type { FormatterRegistry } from \"../types.ts\";\nimport { formatError } from \"./errors.ts\";\nimport { formatLog } from \"./logs.ts\";\nimport { formatTrace } from \"./traces.ts\";\n\nexport const formatters: FormatterRegistry = {\n  event: { typeGuard: isErrorEvent, format: formatError },\n  log: { typeGuard: isLogEvent, format: formatLog },\n  transaction: { typeGuard: isTraceEvent, format: formatTrace },\n};\n"],"names":[],"mappings":";;;;;;;;;;;;;AAMO,MAAM,aAAgC;AAAA,EAC3C,OAAO,EAAE,WAAW,cAAc,QAAQ,YAAA;AAAA,EAC1C,KAAK,EAAE,WAAW,YAAY,QAAQ,UAAA;AAAA,EACtC,aAAa,EAAE,WAAW,cAAc,QAAQ,YAAA;AAClD;"}

package/dist/server/formatters/human/logs.d.ts

@@ -0,0 +1,6 @@
+import { Envelope } from '@sentry/core';
+import { SentryLogEvent } from '../../parser/index.ts';
+/**
+ * Format a log event with envelope headers for source inference
+ */
+export declare function formatLog(event: SentryLogEvent, envelopeHeader: Envelope[0]): string[];

package/dist/server/formatters/human/logs.js

@@ -0,0 +1,32 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "6053728c-2596-4305-9832-86e87e07df6b", e._sentryDebugIdIdentifier = "sentry-dbid-6053728c-2596-4305-9832-86e87e07df6b");
+  } catch (e2) {
+  }
+}();
+import { inferEnvelopeSource, formatLogLine } from "./utils.js";
+import "../../../_virtual/_sentry-release-injection-file.js";
+function formatSingleLog(log, source) {
+  const level = log.level || "log";
+  const message = log.body || "";
+  const attrs = [];
+  if (log.attributes) {
+    for (const [key, attr] of Object.entries(log.attributes)) {
+      if (!key.startsWith("sentry.") && attr.value !== void 0 && attr.value !== null) {
+        attrs.push(`[${key}=${attr.value}]`);
+      }
+    }
+  }
+  const fullMessage = attrs.length > 0 ? `${message} ${attrs.join(" ")}` : message;
+  return formatLogLine(log.timestamp, source, level, fullMessage);
+}
+function formatLog(event, envelopeHeader) {
+  const source = inferEnvelopeSource(envelopeHeader, event);
+  return event.items.map((log) => formatSingleLog(log, source));
+}
+export {
+  formatLog
+};
+//# sourceMappingURL=logs.js.map

package/dist/server/formatters/human/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sources":["../../../../src/server/formatters/human/logs.ts"],"sourcesContent":["import type { Envelope, SerializedLog } from \"@sentry/core\";\nimport type { SentryLogEvent } from \"../../parser/index.ts\";\nimport { type SourceType, formatLogLine, inferEnvelopeSource } from \"./utils.ts\";\n\n/**\n * Format a single log entry with source inference\n */\nfunction formatSingleLog(log: SerializedLog, source: SourceType): string {\n  const level = log.level || \"log\";\n  const message = log.body || \"\";\n\n  const attrs: string[] = [];\n  if (log.attributes) {\n    for (const [key, attr] of Object.entries(log.attributes)) {\n      if (!key.startsWith(\"sentry.\") && attr.value !== undefined && attr.value !== null) {\n        attrs.push(`[${key}=${attr.value}]`);\n      }\n    }\n  }\n\n  const fullMessage = attrs.length > 0 ? `${message} ${attrs.join(\" \")}` : message;\n\n  return formatLogLine(log.timestamp, source, level, fullMessage);\n}\n\n/**\n * Format a log event with envelope headers for source inference\n */\nexport function formatLog(event: SentryLogEvent, envelopeHeader: Envelope[0]): string[] {\n  const source = inferEnvelopeSource(envelopeHeader, event);\n  return event.items.map(log => formatSingleLog(log, source));\n}\n"],"names":[],"mappings":";;;;;;;;;;AAOA,SAAS,gBAAgB,KAAoB,QAA4B;AACvE,QAAM,QAAQ,IAAI,SAAS;AAC3B,QAAM,UAAU,IAAI,QAAQ;AAE5B,QAAM,QAAkB,CAAA;AACxB,MAAI,IAAI,YAAY;AAClB,eAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,IAAI,UAAU,GAAG;AACxD,UAAI,CAAC,IAAI,WAAW,SAAS,KAAK,KAAK,UAAU,UAAa,KAAK,UAAU,MAAM;AACjF,cAAM,KAAK,IAAI,GAAG,IAAI,KAAK,KAAK,GAAG;AAAA,MACrC;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,SAAS,IAAI,GAAG,OAAO,IAAI,MAAM,KAAK,GAAG,CAAC,KAAK;AAEzE,SAAO,cAAc,IAAI,WAAW,QAAQ,OAAO,WAAW;AAChE;AAKO,SAAS,UAAU,OAAuB,gBAAuC;AACtF,QAAM,SAAS,oBAAoB,gBAAgB,KAAK;AACxD,SAAO,MAAM,MAAM,IAAI,SAAO,gBAAgB,KAAK,MAAM,CAAC;AAC5D;"}

package/dist/server/formatters/human/traces.d.ts

@@ -0,0 +1,6 @@
+import { Envelope } from '@sentry/core';
+import { SentryTransactionEvent } from '../../parser/index.ts';
+/**
+ * Format a trace/transaction event with envelope headers for source inference
+ */
+export declare function formatTrace(event: SentryTransactionEvent, envelopeHeader: Envelope[0]): string[];

package/dist/server/formatters/human/traces.js

@@ -0,0 +1,38 @@
+;
+!function() {
+  try {
+    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "9cea3498-c982-4376-a62c-45554f99f0e3", e._sentryDebugIdIdentifier = "sentry-dbid-9cea3498-c982-4376-a62c-45554f99f0e3");
+  } catch (e2) {
+  }
+}();
+import { getDuration } from "../utils.js";
+import { inferEnvelopeSource, formatLogLine } from "./utils.js";
+import "../../../_virtual/_sentry-release-injection-file.js";
+function formatTrace(event, envelopeHeader) {
+  const source = inferEnvelopeSource(envelopeHeader, event);
+  const transaction = event.transaction;
+  const trace = event.contexts?.trace;
+  let message = transaction || trace?.description || "Transaction";
+  const op = trace?.op;
+  if (op && op !== "default" && op !== "unknown") {
+    message = `[${op}] ${message}`;
+  }
+  const duration = getDuration(event.timestamp, event.start_timestamp);
+  if (duration !== void 0) {
+    message += ` [${Math.round(duration)}ms]`;
+  }
+  const status = trace?.status;
+  if (status && status !== "ok") {
+    message += ` [${status}]`;
+  }
+  const spanCount = event.spans?.length;
+  if (spanCount && spanCount > 0) {
+    message += ` [${spanCount} span${spanCount === 1 ? "" : "s"}]`;
+  }
+  return [formatLogLine(event.timestamp, source, "trace", message)];
+}
+export {
+  formatTrace
+};
+//# sourceMappingURL=traces.js.map

package/dist/server/formatters/human/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sources":["../../../../src/server/formatters/human/traces.ts"],"sourcesContent":["import type { Envelope } from \"@sentry/core\";\nimport type { SentryTransactionEvent } from \"../../parser/index.ts\";\nimport { getDuration } from \"../utils.ts\";\nimport { formatLogLine, inferEnvelopeSource } from \"./utils.ts\";\n\n/**\n * Format a trace/transaction event with envelope headers for source inference\n */\nexport function formatTrace(event: SentryTransactionEvent, envelopeHeader: Envelope[0]): string[] {\n  const source = inferEnvelopeSource(envelopeHeader, event);\n\n  const transaction = event.transaction;\n  const trace = event.contexts?.trace;\n\n  let message = transaction || trace?.description || \"Transaction\";\n\n  const op = trace?.op;\n  if (op && op !== \"default\" && op !== \"unknown\") {\n    message = `[${op}] ${message}`;\n  }\n\n  const duration = getDuration(event.timestamp, event.start_timestamp);\n  if (duration !== undefined) {\n    message += ` [${Math.round(duration)}ms]`;\n  }\n\n  const status = trace?.status;\n  if (status && status !== \"ok\") {\n    message += ` [${status}]`;\n  }\n\n  const spanCount = event.spans?.length;\n  if (spanCount && spanCount > 0) {\n    message += ` [${spanCount} span${spanCount === 1 ? \"\" : \"s\"}]`;\n  }\n\n  return [formatLogLine(event.timestamp, source, \"trace\", message)];\n}\n"],"names":[],"mappings":";;;;;;;;;;;AAQO,SAAS,YAAY,OAA+B,gBAAuC;AAChG,QAAM,SAAS,oBAAoB,gBAAgB,KAAK;AAExD,QAAM,cAAc,MAAM;AAC1B,QAAM,QAAQ,MAAM,UAAU;AAE9B,MAAI,UAAU,eAAe,OAAO,eAAe;AAEnD,QAAM,KAAK,OAAO;AAClB,MAAI,MAAM,OAAO,aAAa,OAAO,WAAW;AAC9C,cAAU,IAAI,EAAE,KAAK,OAAO;AAAA,EAC9B;AAEA,QAAM,WAAW,YAAY,MAAM,WAAW,MAAM,eAAe;AACnE,MAAI,aAAa,QAAW;AAC1B,eAAW,KAAK,KAAK,MAAM,QAAQ,CAAC;AAAA,EACtC;AAEA,QAAM,SAAS,OAAO;AACtB,MAAI,UAAU,WAAW,MAAM;AAC7B,eAAW,KAAK,MAAM;AAAA,EACxB;AAEA,QAAM,YAAY,MAAM,OAAO;AAC/B,MAAI,aAAa,YAAY,GAAG;AAC9B,eAAW,KAAK,SAAS,QAAQ,cAAc,IAAI,KAAK,GAAG;AAAA,EAC7D;AAEA,SAAO,CAAC,cAAc,MAAM,WAAW,QAAQ,SAAS,OAAO,CAAC;AAClE;"}

package/dist/server/formatters/human/utils.d.ts

@@ -0,0 +1,43 @@
+import { Envelope } from '@sentry/core';
+export declare const SOURCE_TYPES: readonly ["browser", "mobile", "server"];
+export type SourceType = (typeof SOURCE_TYPES)[number];
+export declare const LOG_LEVELS: readonly ["error", "warning", "log", "info", "trace", "debug"];
+export type LogLevel = (typeof LOG_LEVELS)[number];
+export declare const SOURCE_COLORS: Record<SourceType, (text: string) => string>;
+export declare const LOG_LEVEL_COLORS: Record<LogLevel, (text: string) => string>;
+/**
+ * Infer the source of an envelope as browser, mobile, or server using multiple signals
+ * Priority order:
+ * 1. Sender User-Agent (from HTTP request header)
+ * 2. Platform & Runtime tags (from event payload)
+ * 3. SDK name (fallback)
+ *
+ * Rules based on https://release-registry.services.sentry.io/sdks
+ */
+export declare function inferEnvelopeSource(envelopeHeader: Envelope[0], event?: any): SourceType;
+/**
+ * Format timestamp as local time HH:MM:SS
+ */
+export declare function formatLocalTime(timestamp?: number | string): string;
+/**
+ * Padding helper for vertical alignment
+ */
+export declare function padLabel(label: string, width: number): string;
+export declare const SOURCE_WIDTH: number;
+export declare const TYPE_WIDTH: number;
+/**
+ * Colorize time with dim gray
+ */
+export declare function colorizeTime(time: string): string;
+/**
+ * Colorize source based on envelope source
+ */
+export declare function colorizeSource(source: string): string;
+/**
+ * Colorize event type
+ */
+export declare function colorizeType(type: string): string;
+/**
+ * Format a complete log line with proper alignment and colors
+ */
+export declare function formatLogLine(timestamp: number | string | undefined, source: SourceType, type: string, message: string): string;