@spotlightjs/spotlight 4.5.0 → 4.6.0

package/dist/server/cli/tail.js

@@ -0,0 +1,97 @@
+import { captureException } from "@sentry/core";
+import { EventSource } from "eventsource";
+import { SENTRY_CONTENT_TYPE } from "../../shared/constants.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 { 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" }, 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);
+    }
+  }
+  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 });
+  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 { 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\" }: 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  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 });\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,16 @@
+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[];
+};
+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,120 @@
+import { parseArgs } from "node:util";
+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";
+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"
+    },
+    // 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 result = {
+    debug: values.debug,
+    help: values.help,
+    format,
+    port,
+    cmd: positionals[0],
+    cmdArgs: cmdArgs ?? positionals.slice(1)
+  };
+  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 } = parseCLIArgs();
+  if (debug || process.env.SPOTLIGHT_DEBUG) {
+    enableDebugLogging(true);
+  }
+  const spotlightVersion = "4.6.0";
+  logger.info(`Spotlight by Sentry - v${spotlightVersion}`);
+  if (help) {
+    cmd = "help";
+    cmdArgs = [];
+  }
+  const handler = CLI_CMD_MAP.get(cmd) || showHelp;
+  return await handler({ cmd, cmdArgs, port, help, debug, format, basePath, filesToServe });
+}
+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 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    // 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};\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  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  };\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 } = 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  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 });\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,7 @@
+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,28 @@
+import { inferEnvelopeSource, formatLogLine } from "./utils.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,13 @@
+import { isTraceEvent, isLogEvent, isErrorEvent } from "../../parser/helpers.js";
+import { formatError } from "./errors.js";
+import { formatLog } from "./logs.js";
+import { formatTrace } from "./traces.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,23 @@
+import { inferEnvelopeSource, formatLogLine } from "./utils.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,29 @@
+import { getDuration } from "../utils.js";
+import { inferEnvelopeSource, formatLogLine } from "./utils.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;

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

@@ -0,0 +1,113 @@
+import chalk from "chalk";
+import { parseBrowserFromUserAgent } from "../../routes/stream/userAgent.js";
+const SOURCE_TYPES = ["browser", "mobile", "server"];
+const LOG_LEVELS = ["error", "warning", "log", "info", "trace", "debug"];
+const SOURCE_COLORS = {
+  browser: chalk.yellow,
+  mobile: chalk.blue,
+  server: chalk.magenta
+};
+const LOG_LEVEL_COLORS = {
+  error: chalk.red.bold,
+  warning: chalk.hex("#FFA500"),
+  // Orange
+  log: chalk.white,
+  info: chalk.cyan,
+  trace: chalk.green,
+  debug: chalk.dim
+};
+function isBrowserUserAgent(userAgent) {
+  const parsed = parseBrowserFromUserAgent(userAgent);
+  return parsed !== "unknown" && (parsed.includes("Chrome") || parsed.includes("Firefox") || parsed.includes("Safari") || parsed.includes("Edge"));
+}
+function inferEnvelopeSource(envelopeHeader, event) {
+  const sdkName = envelopeHeader?.sdk?.name || "";
+  if (sdkName.includes("cocoa") || sdkName.includes("android") || sdkName.includes("react-native") || sdkName.includes("flutter") || sdkName.includes("capacitor") || sdkName.includes("cordova") || sdkName.includes("xamarin") || sdkName.includes("maui") || sdkName.includes("unity") || sdkName.includes("kotlin.kmp")) {
+    return "mobile";
+  }
+  const senderUserAgent = envelopeHeader.__spotlight_sender_user_agent;
+  if (senderUserAgent && typeof senderUserAgent === "string") {
+    if (isBrowserUserAgent(senderUserAgent)) {
+      return "browser";
+    }
+  }
+  if (event?.tags?.runtime === "browser") {
+    return "browser";
+  }
+  if (event?.contexts?.runtime?.name) {
+    return "server";
+  }
+  if (event?.server_name) {
+    return "server";
+  }
+  const platform = event?.platform;
+  if (platform === "node" || platform === "python" || platform === "ruby" || platform === "php" || platform === "java" || platform === "go" || platform === "rust" || platform === "perl" || platform === "elixir" || platform === "csharp" || platform === "dotnet") {
+    return "server";
+  }
+  if (sdkName.startsWith("sentry.javascript.") && !sdkName.includes("node") && !sdkName.includes("bun") && !sdkName.includes("deno") && !sdkName.includes("electron") && !sdkName.includes("serverless") && !sdkName.includes("cloudflare") && !sdkName.includes("vercel-edge") && !sdkName.includes("wasm") && !sdkName.includes("opentelemetry") && !sdkName.includes("nextjs") && !sdkName.includes("remix") && !sdkName.includes("gatsby") && !sdkName.includes("astro") && !sdkName.includes("nuxt") && !sdkName.includes("sveltekit") && !sdkName.includes("solidstart") && !sdkName.includes("nestjs") && !sdkName.includes("tanstackstart")) {
+    return "browser";
+  }
+  if (sdkName.includes("blazor.webassembly")) {
+    return "browser";
+  }
+  return "server";
+}
+function formatLocalTime(timestamp) {
+  let date;
+  if (!timestamp) {
+    date = /* @__PURE__ */ new Date();
+  } else if (typeof timestamp === "string") {
+    date = new Date(timestamp);
+  } else {
+    date = new Date(timestamp * 1e3);
+  }
+  if (Number.isNaN(date.getTime())) {
+    return "??:??:??";
+  }
+  const hours = date.getHours().toString().padStart(2, "0");
+  const minutes = date.getMinutes().toString().padStart(2, "0");
+  const seconds = date.getSeconds().toString().padStart(2, "0");
+  return `${hours}:${minutes}:${seconds}`;
+}
+function padLabel(label, width) {
+  return label.padEnd(width);
+}
+const SOURCE_WIDTH = Math.max(...SOURCE_TYPES.map((s) => `[${s.toUpperCase()}]`.length));
+const TYPE_WIDTH = Math.max(...LOG_LEVELS.map((l) => `[${l.toUpperCase()}]`.length));
+function colorizeTime(time) {
+  return chalk.gray(time);
+}
+function colorizeSource(source) {
+  const bracketed = `[${source}]`;
+  const padded = padLabel(bracketed, SOURCE_WIDTH);
+  const colorFn = SOURCE_COLORS[source] || chalk.white;
+  return colorFn(padded);
+}
+function colorizeType(type) {
+  const bracketed = `[${type.toUpperCase()}]`;
+  const padded = padLabel(bracketed, TYPE_WIDTH);
+  const colorFn = LOG_LEVEL_COLORS[type.toLowerCase()] || chalk.white;
+  return colorFn(padded);
+}
+function formatLogLine(timestamp, source, type, message) {
+  const time = colorizeTime(formatLocalTime(timestamp));
+  const coloredSource = colorizeSource(source);
+  const coloredType = colorizeType(type);
+  return `${time} ${coloredType} ${coloredSource} ${message}`;
+}
+export {
+  LOG_LEVELS,
+  LOG_LEVEL_COLORS,
+  SOURCE_COLORS,
+  SOURCE_TYPES,
+  SOURCE_WIDTH,
+  TYPE_WIDTH,
+  colorizeSource,
+  colorizeTime,
+  colorizeType,
+  formatLocalTime,
+  formatLogLine,
+  inferEnvelopeSource,
+  padLabel
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../../src/server/formatters/human/utils.ts"],"sourcesContent":["import type { Envelope } from \"@sentry/core\";\nimport chalk from \"chalk\";\nimport { parseBrowserFromUserAgent } from \"../../routes/stream/userAgent.ts\";\n\nexport const SOURCE_TYPES = [\"browser\", \"mobile\", \"server\"] as const;\nexport type SourceType = (typeof SOURCE_TYPES)[number];\n\nexport const LOG_LEVELS = [\"error\", \"warning\", \"log\", \"info\", \"trace\", \"debug\"] as const;\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport const SOURCE_COLORS: Record<SourceType, (text: string) => string> = {\n  browser: chalk.yellow,\n  mobile: chalk.blue,\n  server: chalk.magenta,\n};\n\nexport const LOG_LEVEL_COLORS: Record<LogLevel, (text: string) => string> = {\n  error: chalk.red.bold,\n  warning: chalk.hex(\"#FFA500\"), // Orange\n  log: chalk.white,\n  info: chalk.cyan,\n  trace: chalk.green,\n  debug: chalk.dim,\n};\n\n/**\n * Helper to detect if a User-Agent string is from a browser\n */\nfunction isBrowserUserAgent(userAgent: string): boolean {\n  const parsed = parseBrowserFromUserAgent(userAgent);\n  return (\n    parsed !== \"unknown\" &&\n    (parsed.includes(\"Chrome\") || parsed.includes(\"Firefox\") || parsed.includes(\"Safari\") || parsed.includes(\"Edge\"))\n  );\n}\n\n/**\n * Infer the source of an envelope as browser, mobile, or server using multiple signals\n * Priority order:\n * 1. Sender User-Agent (from HTTP request header)\n * 2. Platform & Runtime tags (from event payload)\n * 3. SDK name (fallback)\n *\n * Rules based on https://release-registry.services.sentry.io/sdks\n */\nexport function inferEnvelopeSource(envelopeHeader: Envelope[0], event?: any): SourceType {\n  const sdkName = envelopeHeader?.sdk?.name || \"\";\n\n  // 1. Mobile check (unchanged - already reliable from SDK name)\n  // Mobile: Native mobile platforms and frameworks\n  if (\n    sdkName.includes(\"cocoa\") ||\n    sdkName.includes(\"android\") ||\n    sdkName.includes(\"react-native\") ||\n    sdkName.includes(\"flutter\") ||\n    sdkName.includes(\"capacitor\") ||\n    sdkName.includes(\"cordova\") ||\n    sdkName.includes(\"xamarin\") ||\n    sdkName.includes(\"maui\") ||\n    sdkName.includes(\"unity\") ||\n    sdkName.includes(\"kotlin.kmp\")\n  ) {\n    return \"mobile\";\n  }\n\n  // 2. Sender User-Agent check\n  const senderUserAgent = (envelopeHeader as any).__spotlight_sender_user_agent;\n  if (senderUserAgent && typeof senderUserAgent === \"string\") {\n    if (isBrowserUserAgent(senderUserAgent)) {\n      return \"browser\";\n    }\n    // Server SDKs send server UAs like \"Node.js/*\", \"Python-urllib/*\", etc.\n    // If we have a non-browser UA, we continue to further checks\n  }\n\n  // 3. Runtime tags check\n  if (event?.tags?.runtime === \"browser\") {\n    return \"browser\";\n  }\n\n  // 4. Platform & server-specific signals\n  if (event?.contexts?.runtime?.name) {\n    // Runtime context (node, CPython, etc.) indicates server\n    return \"server\";\n  }\n\n  if (event?.server_name) {\n    // server_name is a server-specific field\n    return \"server\";\n  }\n\n  const platform = event?.platform;\n  if (\n    platform === \"node\" ||\n    platform === \"python\" ||\n    platform === \"ruby\" ||\n    platform === \"php\" ||\n    platform === \"java\" ||\n    platform === \"go\" ||\n    platform === \"rust\" ||\n    platform === \"perl\" ||\n    platform === \"elixir\" ||\n    platform === \"csharp\" ||\n    platform === \"dotnet\"\n  ) {\n    return \"server\";\n  }\n\n  // 5. SDK name check (existing logic as fallback)\n  // Browser: JavaScript frameworks/libraries (excluding server/native runtimes and meta-frameworks)\n  if (\n    sdkName.startsWith(\"sentry.javascript.\") &&\n    !sdkName.includes(\"node\") &&\n    !sdkName.includes(\"bun\") &&\n    !sdkName.includes(\"deno\") &&\n    !sdkName.includes(\"electron\") &&\n    !sdkName.includes(\"serverless\") &&\n    !sdkName.includes(\"cloudflare\") &&\n    !sdkName.includes(\"vercel-edge\") &&\n    !sdkName.includes(\"wasm\") &&\n    !sdkName.includes(\"opentelemetry\") &&\n    !sdkName.includes(\"nextjs\") &&\n    !sdkName.includes(\"remix\") &&\n    !sdkName.includes(\"gatsby\") &&\n    !sdkName.includes(\"astro\") &&\n    !sdkName.includes(\"nuxt\") &&\n    !sdkName.includes(\"sveltekit\") &&\n    !sdkName.includes(\"solidstart\") &&\n    !sdkName.includes(\"nestjs\") &&\n    !sdkName.includes(\"tanstackstart\")\n  ) {\n    return \"browser\";\n  }\n\n  // Special case: Blazor WebAssembly runs in browser\n  if (sdkName.includes(\"blazor.webassembly\")) {\n    return \"browser\";\n  }\n\n  // Server: Everything else (node, python, ruby, go, php, java, dotnet, etc.)\n  return \"server\";\n}\n\n/**\n * Format timestamp as local time HH:MM:SS\n */\nexport function formatLocalTime(timestamp?: number | string): string {\n  let date: Date;\n\n  if (!timestamp) {\n    date = new Date();\n  } else if (typeof timestamp === \"string\") {\n    // Handle ISO string format (e.g., \"2023-11-22T16:23:50.406684Z\")\n    date = new Date(timestamp);\n  } else {\n    // Handle Unix timestamp\n    date = new Date(timestamp * 1000);\n  }\n\n  if (Number.isNaN(date.getTime())) {\n    // placeholder with same width as valid timestamp for alignment in the logs\n    return \"??:??:??\";\n  }\n\n  const hours = date.getHours().toString().padStart(2, \"0\");\n  const minutes = date.getMinutes().toString().padStart(2, \"0\");\n  const seconds = date.getSeconds().toString().padStart(2, \"0\");\n  return `${hours}:${minutes}:${seconds}`;\n}\n\n/**\n * Padding helper for vertical alignment\n */\nexport function padLabel(label: string, width: number): string {\n  return label.padEnd(width);\n}\n\n// Constants for consistent padding (adding brackets)\nexport const SOURCE_WIDTH = Math.max(...SOURCE_TYPES.map(s => `[${s.toUpperCase()}]`.length));\nexport const TYPE_WIDTH = Math.max(...LOG_LEVELS.map(l => `[${l.toUpperCase()}]`.length));\n\n/**\n * Colorize time with dim gray\n */\nexport function colorizeTime(time: string): string {\n  return chalk.gray(time);\n}\n\n/**\n * Colorize source based on envelope source\n */\nexport function colorizeSource(source: string): string {\n  const bracketed = `[${source}]`;\n  const padded = padLabel(bracketed, SOURCE_WIDTH);\n  const colorFn = SOURCE_COLORS[source as SourceType] || chalk.white;\n  return colorFn(padded);\n}\n\n/**\n * Colorize event type\n */\nexport function colorizeType(type: string): string {\n  const bracketed = `[${type.toUpperCase()}]`;\n  const padded = padLabel(bracketed, TYPE_WIDTH);\n  const colorFn = LOG_LEVEL_COLORS[type.toLowerCase() as LogLevel] || chalk.white;\n  return colorFn(padded);\n}\n\n/**\n * Format a complete log line with proper alignment and colors\n */\nexport function formatLogLine(\n  timestamp: number | string | undefined,\n  source: SourceType,\n  type: string,\n  message: string,\n): string {\n  const time = colorizeTime(formatLocalTime(timestamp));\n  const coloredSource = colorizeSource(source);\n  const coloredType = colorizeType(type);\n\n  return `${time} ${coloredType} ${coloredSource} ${message}`;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import { Envelope, EnvelopeItem } from '@sentry/core';
+import { FormatterRegistry } from './types.ts';
+export * from './types.ts';
+export { formatters as mdFormatters } from './md/index.ts';
+export { formatters as logfmtFormatters } from './logfmt/index.ts';
+export { formatters as jsonFormatters } from './json/index.ts';
+export { formatters as humanFormatters } from './human/index.ts';
+/**
+ * Generic function to get a formatter from registry and apply it
+ */
+export declare function applyFormatter<K extends keyof FormatterRegistry>(registry: FormatterRegistry, eventType: K, payload: EnvelopeItem[1], envelopeHeader: Envelope[0]): string[];