@spotlightjs/spotlight 4.7.2 → 4.9.0

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

@@ -1 +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 { metrics } from \"@sentry/node\";\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({\n  port,\n  cmdArgs,\n  basePath,\n  filesToServe,\n  format,\n  allowedOrigins,\n}: 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, allowedOrigins }, 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      metrics.count(\"cli.run.prompt_choice\", 1, { attributes: { choice } });\n\n      if (choice === \"docker\") {\n        logger.info(\n          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n        );\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\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        // biome-ignore lint/performance/noDelete: need to remove env var entirely\n        delete env.COMPOSE_FILE;\n      } else {\n        logger.info(`Using package.json script: ${packageJson.scriptName}`);\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\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      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\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      // biome-ignore lint/performance/noDelete: need to remove env var entirely\n      delete env.COMPOSE_FILE;\n    } else if (packageJson) {\n      logger.info(`Using package.json script: ${packageJson.scriptName}`);\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\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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"}
+{"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 { metrics } from \"@sentry/node\";\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, Command, CommandMeta } from \"../types/cli.ts\";\nimport { detectDockerCompose, parseExplicitDockerCompose, prepareDockerComposeRun } from \"../utils/docker-compose.ts\";\nimport { getSpotlightURL, openInBrowser } from \"../utils/extras.ts\";\nimport { EventContainer, getBuffer } from \"../utils/index.ts\";\nimport { type OnItemCallback, handler as tail } from \"./tail.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"run\",\n  short: \"Run your app with automatic Spotlight instrumentation\",\n  usage: \"spotlight run [options] [command...]\",\n  long: `Run your application with Spotlight, automatically setting up the necessary\nenvironment variables and capturing telemetry data.\n\nIf no command is provided, Spotlight auto-detects:\n  - Docker Compose projects (docker-compose.yml, compose.yml, etc.)\n  - package.json scripts (dev, develop, serve, start)\n\nEnvironment variables set automatically:\n  - SENTRY_SPOTLIGHT=http://localhost:<port>/stream\n  - NEXT_PUBLIC_SENTRY_SPOTLIGHT=http://localhost:<port>/stream\n  - SENTRY_TRACES_SAMPLE_RATE=1\n\nstdout/stderr are captured and sent to Spotlight as log events.`,\n  examples: [\n    \"spotlight run                      # Auto-detect and run (package.json or docker-compose)\",\n    \"spotlight run node server.js       # Run a specific command with Spotlight\",\n    \"spotlight run -p 3000 npm start    # Run with custom port\",\n    \"spotlight run python manage.py runserver  # Run Python app\",\n    \"spotlight run docker compose up    # Run Docker Compose with Spotlight injection\",\n  ],\n};\n\nconst SPOTLIGHT_VERSION = process.env.npm_package_version || \"unknown\";\n\n// Environment variable host configurations\nconst LOCALHOST_HOST = \"localhost\";\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 async function handler({\n  port,\n  cmdArgs,\n  basePath,\n  filesToServe,\n  format,\n  allowedOrigins,\n  open,\n}: 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, allowedOrigins }, 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\n  if (open) {\n    openInBrowser(actualServerPort);\n  }\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      metrics.count(\"cli.run.prompt_choice\", 1, { attributes: { choice } });\n\n      if (choice === \"docker\") {\n        logger.info(\n          `Detected Docker Compose project with ${dockerCompose.serviceNames.length} service(s): ${dockerCompose.serviceNames.join(\", \")}`,\n        );\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n        ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n      } else {\n        logger.info(`Using package.json script: ${packageJson.scriptName}`);\n        metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\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      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"docker-compose\" } });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(dockerCompose, actualServerPort, env));\n    } else if (packageJson) {\n      logger.info(`Using package.json script: ${packageJson.scriptName}`);\n      metrics.count(\"cli.run.autodetect\", 1, { attributes: { type: \"package-json\" } });\n      cmdArgs = [packageJson.scriptCommand];\n      shell = true;\n      env.PATH = path.resolve(\"./node_modules/.bin\") + path.delimiter + env.PATH;\n    }\n  } else {\n    // Handle explicit docker compose commands (e.g., \"spotlight run docker compose up\")\n    const explicitDockerConfig = parseExplicitDockerCompose(cmdArgs);\n    if (explicitDockerConfig) {\n      logger.info(\n        `Detected explicit Docker Compose command with ${explicitDockerConfig.serviceNames.length} service(s): ${explicitDockerConfig.serviceNames.join(\", \")}`,\n      );\n      metrics.count(\"cli.run.docker_compose.explicit\", 1, {\n        attributes: {\n          services: explicitDockerConfig.serviceNames.length,\n          subcommand: explicitDockerConfig.subcommandArgs.join(\" \"),\n        },\n      });\n      ({ cmdArgs, stdin } = prepareDockerComposeRun(explicitDockerConfig, actualServerPort, env));\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\nexport default { meta, handler } satisfies Command;\n"],"names":["tail"],"mappings":"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"}

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

@@ -1,2 +1,8 @@
-import { CLIHandlerOptions } from '../types/cli.ts';
-export default function server({ port, basePath, filesToServe, allowedOrigins }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+import { CLIHandlerOptions, CommandMeta } from '../types/cli.ts';
+export declare const meta: CommandMeta;
+export declare function handler({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions): Promise<import('http').Server<typeof import('http').IncomingMessage, typeof import('http').ServerResponse> | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/server.js

@@ -2,22 +2,52 @@
 !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] = "b0df70d8-9df1-45bb-8915-b98805fbbb55", e._sentryDebugIdIdentifier = "sentry-dbid-b0df70d8-9df1-45bb-8915-b98805fbbb55");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "ce0912cd-6bc9-403e-885e-b9e4cee0c3a4", e._sentryDebugIdIdentifier = "sentry-dbid-ce0912cd-6bc9-403e-885e-b9e4cee0c3a4");
   } catch (e2) {
   }
 }();
 import { setupSpotlight } from "../main.js";
+import { openInBrowser } from "../utils/extras.js";
 import "../../_virtual/_sentry-release-injection-file.js";
-async function server({ port, basePath, filesToServe, allowedOrigins }) {
-  return await setupSpotlight({
+const meta = {
+  name: "server",
+  short: "Start the Spotlight sidecar server (default command)",
+  usage: "spotlight [server] [options]",
+  long: `Start the Spotlight sidecar HTTP server.
+
+This is the default command when running 'spotlight' without arguments.
+The server listens for events from Sentry SDKs and serves the Spotlight UI.
+
+The server provides:
+  - HTTP endpoint for receiving Sentry envelopes
+  - Server-Sent Events (SSE) stream for real-time updates
+  - Web UI at http://localhost:PORT`,
+  examples: [
+    "spotlight                          # Start on default port 8969",
+    "spotlight server                   # Explicit server command",
+    "spotlight --open                   # Start and open dashboard in browser",
+    "spotlight --port 3000              # Start on port 3000",
+    "spotlight -p 3000 -d               # Start on port 3000 with debug logging"
+  ]
+};
+async function handler({ port, basePath, filesToServe, allowedOrigins, open }) {
+  const serverInstance = await setupSpotlight({
     port,
     basePath,
     filesToServe,
     isStandalone: true,
     allowedOrigins
   });
+  if (open) {
+    const actualPort = serverInstance ? serverInstance.address().port : port;
+    openInBrowser(actualPort);
+  }
+  return serverInstance;
 }
+const server = { meta, handler };
 export {
-  server as default
+  server as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=server.js.map

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

@@ -1 +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, allowedOrigins }: CLIHandlerOptions) {\n  return await setupSpotlight({\n    port,\n    basePath,\n    filesToServe,\n    isStandalone: true,\n    allowedOrigins,\n  });\n}\n"],"names":[],"mappings":";;;;;;;;;;AAGA,eAA8B,OAAO,EAAE,MAAM,UAAU,cAAc,kBAAqC;AACxG,SAAO,MAAM,eAAe;AAAA,IAC1B;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,EAAA,CACD;AACH;"}
+{"version":3,"file":"server.js","sources":["../../../src/server/cli/server.ts"],"sourcesContent":["import type { AddressInfo } from \"node:net\";\nimport { setupSpotlight } from \"../main.ts\";\nimport type { CLIHandlerOptions, Command, CommandMeta } from \"../types/cli.ts\";\nimport { openInBrowser } from \"../utils/extras.ts\";\n\nexport const meta: CommandMeta = {\n  name: \"server\",\n  short: \"Start the Spotlight sidecar server (default command)\",\n  usage: \"spotlight [server] [options]\",\n  long: `Start the Spotlight sidecar HTTP server.\n\nThis is the default command when running 'spotlight' without arguments.\nThe server listens for events from Sentry SDKs and serves the Spotlight UI.\n\nThe server provides:\n  - HTTP endpoint for receiving Sentry envelopes\n  - Server-Sent Events (SSE) stream for real-time updates\n  - Web UI at http://localhost:PORT`,\n  examples: [\n    \"spotlight                          # Start on default port 8969\",\n    \"spotlight server                   # Explicit server command\",\n    \"spotlight --open                   # Start and open dashboard in browser\",\n    \"spotlight --port 3000              # Start on port 3000\",\n    \"spotlight -p 3000 -d               # Start on port 3000 with debug logging\",\n  ],\n};\n\nexport async function handler({ port, basePath, filesToServe, allowedOrigins, open }: CLIHandlerOptions) {\n  const serverInstance = await setupSpotlight({\n    port,\n    basePath,\n    filesToServe,\n    isStandalone: true,\n    allowedOrigins,\n  });\n\n  if (open) {\n    // Use actual port from server instance, or fall back to requested port\n    // (when serverInstance is undefined, a server is already running on the requested port)\n    const actualPort = serverInstance ? (serverInstance.address() as AddressInfo).port : port;\n    openInBrowser(actualPort);\n  }\n\n  return serverInstance;\n}\n\nexport default { meta, handler } satisfies Command;\n"],"names":[],"mappings":";;;;;;;;;;;AAKO,MAAM,OAAoB;AAAA,EAC/B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASN,UAAU;AAAA,IACR;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEJ;AAEA,eAAsB,QAAQ,EAAE,MAAM,UAAU,cAAc,gBAAgB,QAA2B;AACvG,QAAM,iBAAiB,MAAM,eAAe;AAAA,IAC1C;AAAA,IACA;AAAA,IACA;AAAA,IACA,cAAc;AAAA,IACd;AAAA,EAAA,CACD;AAED,MAAI,MAAM;AAGR,UAAM,aAAa,iBAAkB,eAAe,QAAA,EAA0B,OAAO;AACrF,kBAAc,UAAU;AAAA,EAC1B;AAEA,SAAO;AACT;AAEA,MAAA,SAAe,EAAE,MAAM,QAAA;"}

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

@@ -1,8 +1,14 @@
 import { ServerType } from '@hono/node-server';
 import { ParsedEnvelope } from '../parser/index.ts';
-import { CLIHandlerOptions } from '../types/cli.ts';
+import { CLIHandlerOptions, CommandMeta } 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, allowedOrigins }: CLIHandlerOptions, onItem?: OnItemCallback): Promise<ServerType | undefined>;
+export declare const meta: CommandMeta;
+export declare function handler({ port, cmdArgs, basePath, filesToServe, format, allowedOrigins }: CLIHandlerOptions, onItem?: OnItemCallback): Promise<ServerType | undefined>;
+declare const _default: {
+    meta: CommandMeta;
+    handler: typeof handler;
+};
+export default _default;

package/dist/server/cli/tail.js

@@ -2,7 +2,7 @@
 !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");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "22ba8cd6-fd16-4260-968d-aa7a00ac6ae6", e._sentryDebugIdIdentifier = "sentry-dbid-22ba8cd6-fd16-4260-968d-aa7a00ac6ae6");
   } catch (e2) {
   }
 }();
@@ -38,6 +38,28 @@ const NAME_TO_TYPE_MAPPING = Object.freeze({
 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 meta = {
+  name: "tail",
+  short: `Tail Sentry events (types: ${Object.keys(NAME_TO_TYPE_MAPPING).join(", ")})`,
+  usage: "spotlight tail [types...] [options]",
+  long: `Stream Sentry events to your terminal in real-time.
+
+Available event types:
+  ${Object.keys(NAME_TO_TYPE_MAPPING).join(", ")}
+
+Magic words (to tail everything):
+  ${[...EVERYTHING_MAGIC_WORDS].join(", ")}
+
+Use -f/--format to change output format (human, logfmt, json, md).
+Connects to existing sidecar if running, otherwise starts a new one.`,
+  examples: [
+    "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       # Use JSON output format",
+    "spotlight tail traces -f logfmt    # Tail traces with logfmt format"
+  ]
+};
 const FORMATTERS = {
   md: formatters$3,
   logfmt: formatters$2,
@@ -49,7 +71,7 @@ const connectUpstream = async (port) => new Promise((resolve, reject) => {
   client.onerror = reject;
   client.onopen = () => resolve(client);
 });
-async function tail({ port, cmdArgs, basePath, filesToServe, format = "logfmt", allowedOrigins }, onItem) {
+async function handler({ 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)) {
@@ -104,10 +126,13 @@ async function tail({ port, cmdArgs, basePath, filesToServe, format = "logfmt",
   });
   return serverInstance;
 }
+const tail = { meta, handler };
 export {
   EVERYTHING_MAGIC_WORDS,
   NAME_TO_TYPE_MAPPING,
   SUPPORTED_TAIL_ARGS,
-  tail as default
+  tail as default,
+  handler,
+  meta
 };
 //# sourceMappingURL=tail.js.map

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

@@ -1 +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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"}
+{"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, Command, CommandMeta } 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\nexport const meta: CommandMeta = {\n  name: \"tail\",\n  short: `Tail Sentry events (types: ${Object.keys(NAME_TO_TYPE_MAPPING).join(\", \")})`,\n  usage: \"spotlight tail [types...] [options]\",\n  long: `Stream Sentry events to your terminal in real-time.\n\nAvailable event types:\n  ${Object.keys(NAME_TO_TYPE_MAPPING).join(\", \")}\n\nMagic words (to tail everything):\n  ${[...EVERYTHING_MAGIC_WORDS].join(\", \")}\n\nUse -f/--format to change output format (human, logfmt, json, md).\nConnects to existing sidecar if running, otherwise starts a new one.`,\n  examples: [\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       # Use JSON output format\",\n    \"spotlight tail traces -f logfmt    # Tail traces with logfmt format\",\n  ],\n};\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 async function handler(\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\nexport default { meta, handler } satisfies Command;\n"],"names":["mdFormatters","logfmtFormatters","jsonFormatters","humanFormatters"],"mappings":"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"}

package/dist/server/cli.d.ts

@@ -1,16 +1,18 @@
 import { FormatterType } from './formatters/types.ts';
-import { CLIHandler, CLIHandlerOptions } from './types/cli.ts';
+import { CLIHandlerOptions, Command } from './types/cli.ts';
 export type CLIArgs = {
     port: number;
     debug: boolean;
     help: boolean;
+    open: 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 const COMMANDS: Command[];
+export declare const CLI_CMD_MAP: Map<string | undefined, import('./types/cli.ts').CLIHandler>;
 export declare function main({ basePath, filesToServe, }?: {
     basePath?: CLIHandlerOptions["basePath"];
     filesToServe?: CLIHandlerOptions["filesToServe"];

package/dist/server/cli.js

@@ -2,7 +2,7 @@
 !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] = "2fc3f6e8-14bb-49cb-b7d3-76d936f1e359", e._sentryDebugIdIdentifier = "sentry-dbid-2fc3f6e8-14bb-49cb-b7d3-76d936f1e359");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "df0f70e6-e8df-4b3a-bb62-3651a132707e", e._sentryDebugIdIdentifier = "sentry-dbid-df0f70e6-e8df-4b3a-bb62-3651a132707e");
   } catch (e2) {
   }
 }();
@@ -46,6 +46,11 @@ const PARSE_ARGS_CONFIG = {
       type: "boolean",
       default: false
     },
+    open: {
+      type: "boolean",
+      short: "o",
+      default: false
+    },
     help: {
       type: "boolean",
       short: "h",
@@ -63,9 +68,10 @@ function parseCLIArgs() {
     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");
+  const firstPositional = preParse.tokens.find((token) => token.kind === "positional");
+  const isRunCommand = firstPositional?.value === "run";
+  if (isRunCommand && firstPositional) {
+    const cutOff = preParse.tokens.find((token) => token.index > firstPositional.index && token.kind === "positional");
     cmdArgs = cutOff ? args.splice(cutOff.index) : [];
   }
   const { values, positionals } = parseArgs({
@@ -73,7 +79,7 @@ function parseCLIArgs() {
     ...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;
+  const port = portInput != null ? Number(portInput) : isRunCommand ? 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");
@@ -98,6 +104,7 @@ function parseCLIArgs() {
   const result = {
     debug: values.debug,
     help: values.help,
+    open: values.open,
     format,
     port,
     cmd: positionals[0],
@@ -106,23 +113,21 @@ function parseCLIArgs() {
   };
   return result;
 }
-const CLI_CMD_MAP = /* @__PURE__ */ new Map([
+const COMMANDS = [run, tail, mcp, server];
+const CLI_CMD_MAP = new Map([
   ["help", showHelp],
-  ["mcp", mcp],
-  ["tail", tail],
-  ["run", run],
-  ["server", server],
-  [void 0, server]
+  ...COMMANDS.map((cmd) => [cmd.meta.name, cmd.handler]),
+  [void 0, server.handler]
 ]);
 async function main({
   basePath,
   filesToServe
 } = {}) {
-  let { cmd, cmdArgs, help, port, debug, format, allowedOrigins } = parseCLIArgs();
+  const { cmd, cmdArgs, help, port, debug, format, allowedOrigins, open } = parseCLIArgs();
   if (debug || process.env.SPOTLIGHT_DEBUG) {
     enableDebugLogging(true);
   }
-  const spotlightVersion = "4.7.2";
+  const spotlightVersion = "4.9.0";
   logger.info(`Spotlight by Sentry - v${spotlightVersion}`);
   metrics.count("cli.invocation", 1, {
     attributes: {
@@ -131,15 +136,18 @@ async function main({
       debug: String(debug)
     }
   });
-  if (help) {
-    cmd = "help";
-    cmdArgs = [];
+  if (help || cmd === "help") {
+    const targetCmd = cmd === "help" ? cmdArgs[0] : cmd;
+    return showHelp({
+      cmdArgs: targetCmd ? [targetCmd] : []
+    });
   }
   const handler = CLI_CMD_MAP.get(cmd) || showHelp;
-  return await handler({ cmd, cmdArgs, port, help, debug, format, basePath, filesToServe, allowedOrigins });
+  return await handler({ cmd, cmdArgs, port, help, debug, format, basePath, filesToServe, allowedOrigins, open });
 }
 export {
   CLI_CMD_MAP,
+  COMMANDS,
   main,
   parseCLIArgs
 };

package/dist/server/cli.js.map

@@ -1 +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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"}
+{"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 { CLIHandlerOptions, Command } 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    open: {\n      type: \"boolean\",\n      short: \"o\",\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  open: 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  // Only apply special handling for \"run\" if it's the actual command (first positional),\n  // not when it appears as an argument to another command like \"spotlight help run\"\n  const firstPositional = preParse.tokens.find(token => token.kind === \"positional\");\n  const isRunCommand = firstPositional?.value === \"run\";\n  if (isRunCommand && firstPositional) {\n    const cutOff = preParse.tokens.find(token => token.index > firstPositional.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) : isRunCommand ? 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    open: values.open 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}\n// Command registry - each command provides its own metadata\nexport const COMMANDS: Command[] = [run, tail, mcp, server];\n\n// Build command map from registry for fast lookup\nexport const CLI_CMD_MAP = new Map<string | undefined, Command[\"handler\"]>([\n  [\"help\", showHelp],\n  ...COMMANDS.map(cmd => [cmd.meta.name, cmd.handler] as [string, Command[\"handler\"]]),\n  [undefined, server.handler],\n]);\n\nexport async function main({\n  basePath,\n  filesToServe,\n}: { basePath?: CLIHandlerOptions[\"basePath\"]; filesToServe?: CLIHandlerOptions[\"filesToServe\"] } = {}) {\n  const { cmd, cmdArgs, help, port, debug, format, allowedOrigins, open } = 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  // Handle help: `spotlight --help`, `spotlight help`, `spotlight help <cmd>`, or `spotlight <cmd> --help`\n  if (help || cmd === \"help\") {\n    // If `spotlight <cmd> --help`, show help for that specific command\n    // If `spotlight help <cmd>`, cmdArgs[0] contains the command name\n    const targetCmd = cmd === \"help\" ? cmdArgs[0] : cmd;\n    return showHelp({\n      cmd: \"help\",\n      cmdArgs: targetCmd ? [targetCmd] : [],\n      port,\n      help: true,\n      debug,\n      format,\n      basePath,\n      filesToServe,\n      allowedOrigins,\n      open,\n    });\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, open });\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AAiBA,MAAM,oCAAoC;AAC1C,MAAM,oBAAoB;AAAA,EACxB,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,IAAA;AAAA,IAEX,OAAO;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,IAAA;AAAA,IAEX,QAAQ;AAAA,MACN,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,IAAA;AAAA,IAEX,kBAAkB;AAAA,MAChB,MAAM;AAAA,MACN,OAAO;AAAA,MACP,UAAU;AAAA,MACV,SAAS,CAAA;AAAA,IAAC;AAAA;AAAA,IAGZ,aAAa;AAAA,MACX,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAAA,IAEX,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,IAAA;AAAA,IAEX,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,SAAS;AAAA,IAAA;AAAA,EACX;AAAA,EAEF,kBAAkB;AAAA,EAClB,QAAQ;AACV;AAaO,SAAS,eAAwB;AACtC,QAAM,OAAO,MAAM,KAAK,QAAQ,IAAI,EAAE,MAAM,CAAC;AAC7C,QAAM,WAAW,UAAU;AAAA,IACzB,GAAG;AAAA,IACH,QAAQ;AAAA,IACR,QAAQ;AAAA,EAAA,CACT;AACD,MAAI,UAAgC;AAGpC,QAAM,kBAAkB,SAAS,OAAO,KAAK,CAAA,UAAS,MAAM,SAAS,YAAY;AACjF,QAAM,eAAe,iBAAiB,UAAU;AAChD,MAAI,gBAAgB,iBAAiB;AACnC,UAAM,SAAS,SAAS,OAAO,KAAK,CAAA,UAAS,MAAM,QAAQ,gBAAgB,SAAS,MAAM,SAAS,YAAY;AAC/G,cAAU,SAAS,KAAK,OAAO,OAAO,KAAK,IAAI,CAAA;AAAA,EACjD;AACA,QAAM,EAAE,QAAQ,YAAA,IAAgB,UAAU;AAAA,IACxC;AAAA,IACA,GAAG;AAAA,EAAA,CACJ;AAGD,QAAM,YAAY,YAAY,WAAW,KAAK,YAAY,KAAK,YAAY,CAAC,CAAC,IAAI,YAAY,MAAA,IAAU,OAAO;AAE9G,QAAM,OAAO,aAAa,OAAO,OAAO,SAAS,IAAI,eAAe,oCAAoC;AACxG,MAAI,OAAO,MAAM,IAAI,GAAG;AAEtB,YAAQ,MAAM,+BAA+B,SAAS,GAAG;AACzD,YAAQ,MAAM,iDAAiD;AAC/D,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,OAAO,KAAK,OAAO,OAAO;AAC5B,YAAQ,MAAM,eAAe,IAAI,gEAAgE;AACjG,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,MAAI,OAAO,WAAW,GAAG;AACvB,gBAAY,QAAQ,KAAK;AACzB,YAAQ,KAAK,uFAAuF;AAAA,EACtG;AAEA,QAAM,SAAS,OAAO;AACtB,MAAI,CAAC,qBAAqB,SAAS,MAAuB,GAAG;AAC3D,YAAQ,MAAM,0BAA0B,MAAM,GAAG;AACjD,YAAQ,MAAM,sBAAsB,qBAAqB,KAAK,IAAI,CAAC,EAAE;AACrE,YAAQ,KAAK,CAAC;AAAA,EAChB;AAGA,QAAM,qBAAqB,OAAO,gBAAgB;AAClD,QAAM,iBAAiB,mBAAmB,QAAQ,CAAA,WAAU,OAAO,MAAM,GAAG,EAAE,IAAI,CAAA,MAAK,EAAE,KAAA,CAAM,CAAC,EAAE,OAAO,OAAO;AAEhH,QAAM,SAAkB;AAAA,IACtB,OAAO,OAAO;AAAA,IACd,MAAM,OAAO;AAAA,IACb,MAAM,OAAO;AAAA,IACb;AAAA,IACA;AAAA,IACA,KAAK,YAAY,CAAC;AAAA,IAClB,SAAS,WAAW,YAAY,MAAM,CAAC;AAAA,IACvC;AAAA,EAAA;AAGF,SAAO;AACT;AAEO,MAAM,WAAsB,CAAC,KAAK,MAAM,KAAK,MAAM;AAGnD,MAAM,cAAc,IAAI,IAA4C;AAAA,EACzE,CAAC,QAAQ,QAAQ;AAAA,EACjB,GAAG,SAAS,IAAI,CAAA,QAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAiC;AAAA,EACnF,CAAC,QAAW,OAAO,OAAO;AAC5B,CAAC;AAED,eAAsB,KAAK;AAAA,EACzB;AAAA,EACA;AACF,IAAoG,IAAI;AACtG,QAAM,EAAE,KAAK,SAAS,MAAM,MAAM,OAAO,QAAQ,gBAAgB,KAAA,IAAS,aAAA;AAC1E,MAAI,SAAS,QAAQ,IAAI,iBAAiB;AACxC,uBAAmB,IAAI;AAAA,EACzB;AACA,QAAM,mBAAmB;AACzB,SAAO,KAAK,0BAA0B,gBAAgB,EAAE;AAExD,UAAQ,MAAM,kBAAkB,GAAG;AAAA,IACjC,YAAY;AAAA,MACV,SAAS,OAAO;AAAA,MAChB;AAAA,MACA,OAAO,OAAO,KAAK;AAAA,IAAA;AAAA,EACrB,CACD;AAGD,MAAI,QAAQ,QAAQ,QAAQ;AAG1B,UAAM,YAAY,QAAQ,SAAS,QAAQ,CAAC,IAAI;AAChD,WAAO,SAAS;AAAA,MAEd,SAAS,YAAY,CAAC,SAAS,IAAI,CAAA;AAAA,IASrC,CAAC;AAAA,EACH;AAEA,QAAM,UAAU,YAAY,IAAI,GAAG,KAAK;AAExC,SAAO,MAAM,QAAQ,EAAE,KAAK,SAAS,MAAM,MAAM,OAAO,QAAQ,UAAU,cAAc,gBAAgB,MAAM;AAChH;"}

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

@@ -1,5 +1,5 @@
 import { Envelope, EnvelopeItem } from '@sentry/core';
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { EventContainer } from '../../utils/index.ts';
 import { ErrorEventSchema } from '../schema.ts';
 export declare function formatErrorEnvelope(container: EventContainer): string[];

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

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../../../../src/server/formatters/md/errors.ts"],"sourcesContent":["import type { Envelope, EnvelopeItem } from \"@sentry/core\";\nimport type { z } from \"zod\";\nimport { type SentryErrorEvent, type SentryEvent, isErrorEvent } from \"../../parser/index.ts\";\nimport type { EventContainer } from \"../../utils/index.ts\";\nimport type { ErrorEventSchema } from \"../schema.ts\";\nimport { formatTimestamp } from \"../utils.ts\";\nimport { formatEventOutput } from \"./event.ts\";\n\nexport function formatErrorEnvelope(container: EventContainer) {\n  const processedEnvelope = container.getParsedEnvelope();\n\n  const {\n    envelope: [envelopeHeader, items],\n  } = processedEnvelope;\n\n  const formatted: string[] = [];\n  for (const item of items) {\n    const [{ type }, payload] = item;\n\n    if (type === \"event\" && isErrorEvent(payload as SentryEvent)) {\n      formatted.push(...formatError(payload, envelopeHeader));\n    }\n  }\n\n  return formatted;\n}\n\nexport function processErrorEvent(event: any): z.infer<typeof ErrorEventSchema> {\n  const entries: z.infer<typeof ErrorEventSchema>[\"entries\"] = [];\n\n  if (event.exception) {\n    entries.push({\n      type: \"exception\",\n      data: event.exception,\n    });\n  }\n\n  if (event.request) {\n    entries.push({\n      type: \"request\",\n      data: event.request,\n    });\n  }\n\n  if (event.breadcrumbs) {\n    entries.push({\n      type: \"breadcrumbs\",\n      data: event.breadcrumbs,\n    });\n  }\n\n  if (event.spans) {\n    entries.push({\n      type: \"spans\",\n      data: event.spans,\n    });\n  }\n\n  if (event.threads) {\n    entries.push({\n      type: \"threads\",\n      data: event.threads,\n    });\n  }\n\n  const message = typeof event.message === \"string\" ? event.message : (event.message?.formatted ?? \"\");\n\n  return {\n    message,\n    id: event.event_id ?? \"\",\n    type: \"error\" as const,\n    culprit: event.culprit ?? null,\n    tags: Object.entries(event.tags ?? {}).map(([key, value]) => ({\n      key,\n      value: String(value),\n    })),\n    dateCreated: formatTimestamp(event.timestamp),\n    title: message,\n    entries,\n    contexts: event.contexts as any,\n    platform: event.platform,\n  };\n}\n\n/**\n * Format an error event to markdown string\n */\nexport function formatError(payload: EnvelopeItem[1], _envelopeHeader: Envelope[0]): string[] {\n  const event = payload as SentryErrorEvent;\n  return [formatEventOutput(processErrorEvent(event))];\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAQO,SAAS,oBAAoB,WAA2B;AAC7D,QAAM,oBAAoB,UAAU,kBAAA;AAEpC,QAAM;AAAA,IACJ,UAAU,CAAC,gBAAgB,KAAK;AAAA,EAAA,IAC9B;AAEJ,QAAM,YAAsB,CAAA;AAC5B,aAAW,QAAQ,OAAO;AACxB,UAAM,CAAC,EAAE,QAAQ,OAAO,IAAI;AAE5B,QAAI,SAAS,WAAW,aAAa,OAAsB,GAAG;AAC5D,gBAAU,KAAK,GAAG,YAAY,OAAuB,CAAC;AAAA,IACxD;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,kBAAkB,OAA8C;AAC9E,QAAM,UAAuD,CAAA;AAE7D,MAAI,MAAM,WAAW;AACnB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,SAAS;AACjB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,aAAa;AACrB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,OAAO;AACf,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,SAAS;AACjB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,QAAM,UAAU,OAAO,MAAM,YAAY,WAAW,MAAM,UAAW,MAAM,SAAS,aAAa;AAEjG,SAAO;AAAA,IACL;AAAA,IACA,IAAI,MAAM,YAAY;AAAA,IACtB,MAAM;AAAA,IACN,SAAS,MAAM,WAAW;AAAA,IAC1B,MAAM,OAAO,QAAQ,MAAM,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;AAAA,MAC5D;AAAA,MACA,OAAO,OAAO,KAAK;AAAA,IAAA,EACnB;AAAA,IACF,aAAa,gBAAgB,MAAM,SAAS;AAAA,IAC5C,OAAO;AAAA,IACP;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,UAAU,MAAM;AAAA,EAAA;AAEpB;AAKO,SAAS,YAAY,SAA0B,iBAAwC;AAC5F,QAAM,QAAQ;AACd,SAAO,CAAC,kBAAkB,kBAAkB,KAAK,CAAC,CAAC;AACrD;"}
+{"version":3,"file":"errors.js","sources":["../../../../src/server/formatters/md/errors.ts"],"sourcesContent":["import type { Envelope, EnvelopeItem } from \"@sentry/core\";\nimport type { z } from \"zod/v3\";\nimport { type SentryErrorEvent, type SentryEvent, isErrorEvent } from \"../../parser/index.ts\";\nimport type { EventContainer } from \"../../utils/index.ts\";\nimport type { ErrorEventSchema } from \"../schema.ts\";\nimport { formatTimestamp } from \"../utils.ts\";\nimport { formatEventOutput } from \"./event.ts\";\n\nexport function formatErrorEnvelope(container: EventContainer) {\n  const processedEnvelope = container.getParsedEnvelope();\n\n  const {\n    envelope: [envelopeHeader, items],\n  } = processedEnvelope;\n\n  const formatted: string[] = [];\n  for (const item of items) {\n    const [{ type }, payload] = item;\n\n    if (type === \"event\" && isErrorEvent(payload as SentryEvent)) {\n      formatted.push(...formatError(payload, envelopeHeader));\n    }\n  }\n\n  return formatted;\n}\n\nexport function processErrorEvent(event: any): z.infer<typeof ErrorEventSchema> {\n  const entries: z.infer<typeof ErrorEventSchema>[\"entries\"] = [];\n\n  if (event.exception) {\n    entries.push({\n      type: \"exception\",\n      data: event.exception,\n    });\n  }\n\n  if (event.request) {\n    entries.push({\n      type: \"request\",\n      data: event.request,\n    });\n  }\n\n  if (event.breadcrumbs) {\n    entries.push({\n      type: \"breadcrumbs\",\n      data: event.breadcrumbs,\n    });\n  }\n\n  if (event.spans) {\n    entries.push({\n      type: \"spans\",\n      data: event.spans,\n    });\n  }\n\n  if (event.threads) {\n    entries.push({\n      type: \"threads\",\n      data: event.threads,\n    });\n  }\n\n  const message = typeof event.message === \"string\" ? event.message : (event.message?.formatted ?? \"\");\n\n  return {\n    message,\n    id: event.event_id ?? \"\",\n    type: \"error\" as const,\n    culprit: event.culprit ?? null,\n    tags: Object.entries(event.tags ?? {}).map(([key, value]) => ({\n      key,\n      value: String(value),\n    })),\n    dateCreated: formatTimestamp(event.timestamp),\n    title: message,\n    entries,\n    contexts: event.contexts as any,\n    platform: event.platform,\n  };\n}\n\n/**\n * Format an error event to markdown string\n */\nexport function formatError(payload: EnvelopeItem[1], _envelopeHeader: Envelope[0]): string[] {\n  const event = payload as SentryErrorEvent;\n  return [formatEventOutput(processErrorEvent(event))];\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAQO,SAAS,oBAAoB,WAA2B;AAC7D,QAAM,oBAAoB,UAAU,kBAAA;AAEpC,QAAM;AAAA,IACJ,UAAU,CAAC,gBAAgB,KAAK;AAAA,EAAA,IAC9B;AAEJ,QAAM,YAAsB,CAAA;AAC5B,aAAW,QAAQ,OAAO;AACxB,UAAM,CAAC,EAAE,QAAQ,OAAO,IAAI;AAE5B,QAAI,SAAS,WAAW,aAAa,OAAsB,GAAG;AAC5D,gBAAU,KAAK,GAAG,YAAY,OAAuB,CAAC;AAAA,IACxD;AAAA,EACF;AAEA,SAAO;AACT;AAEO,SAAS,kBAAkB,OAA8C;AAC9E,QAAM,UAAuD,CAAA;AAE7D,MAAI,MAAM,WAAW;AACnB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,SAAS;AACjB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,aAAa;AACrB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,OAAO;AACf,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,MAAI,MAAM,SAAS;AACjB,YAAQ,KAAK;AAAA,MACX,MAAM;AAAA,MACN,MAAM,MAAM;AAAA,IAAA,CACb;AAAA,EACH;AAEA,QAAM,UAAU,OAAO,MAAM,YAAY,WAAW,MAAM,UAAW,MAAM,SAAS,aAAa;AAEjG,SAAO;AAAA,IACL;AAAA,IACA,IAAI,MAAM,YAAY;AAAA,IACtB,MAAM;AAAA,IACN,SAAS,MAAM,WAAW;AAAA,IAC1B,MAAM,OAAO,QAAQ,MAAM,QAAQ,EAAE,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,OAAO;AAAA,MAC5D;AAAA,MACA,OAAO,OAAO,KAAK;AAAA,IAAA,EACnB;AAAA,IACF,aAAa,gBAAgB,MAAM,SAAS;AAAA,IAC5C,OAAO;AAAA,IACP;AAAA,IACA,UAAU,MAAM;AAAA,IAChB,UAAU,MAAM;AAAA,EAAA;AAEpB;AAKO,SAAS,YAAY,SAA0B,iBAAwC;AAC5F,QAAM,QAAQ;AACd,SAAO,CAAC,kBAAkB,kBAAkB,KAAK,CAAC,CAAC;AACrD;"}

package/dist/server/formatters/md/event.d.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod';
+import { z } from 'zod/v3';
 import { EventSchema } from '../schema.ts';
 export type Event = z.infer<typeof EventSchema>;
 /**