@spotlightjs/spotlight 4.5.1 → 4.6.0

package/dist/server/formatters/shared/data-builders.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build error event data object.
+ * Used by both logfmt and json formatters.
+ */
+export declare function buildErrorData(event: any): Record<string, any>;
+/**
+ * Build log event data object.
+ * Used by both logfmt and json formatters.
+ */
+export declare function buildLogData(log: any): Record<string, any>;
+/**
+ * Build trace/transaction event data object.
+ * Used by both logfmt and json formatters.
+ */
+export declare function buildTraceData(event: any): Record<string, any>;

package/dist/server/formatters/shared/data-builders.js

@@ -0,0 +1,120 @@
+import { formatTimestamp, mapFields, getDuration, mapSdkFields, mapTags } from "../utils.js";
+function buildErrorData(event) {
+  const data = {
+    timestamp: formatTimestamp(event.timestamp),
+    type: "error",
+    level: event.level || "error",
+    event_id: event.event_id
+  };
+  const message = event.message || event.logentry?.message;
+  if (message) {
+    data.message = message;
+  }
+  const exc = event.exception?.values?.[0];
+  if (exc) {
+    mapFields(exc, data, {
+      exception_type: "type",
+      exception_value: "value"
+    });
+    const frames = exc.stacktrace?.frames;
+    if (frames?.length) {
+      const frame = frames.find((f) => f.in_app) || frames[frames.length - 1];
+      mapFields(frame, data, {
+        filename: "filename",
+        lineno: "lineno",
+        colno: "colno",
+        function: "function"
+      });
+    }
+  }
+  const trace = event.contexts?.trace;
+  if (trace?.trace_id) {
+    mapFields(trace, data, {
+      trace_id: "trace_id",
+      span_id: "span_id"
+    });
+  }
+  mapFields(event, data, {
+    environment: "environment",
+    release: "release",
+    dist: "dist",
+    platform: "platform",
+    transaction: "transaction",
+    logger: "logger",
+    server_name: "server_name",
+    user_id: "user.id",
+    user_email: "user.email",
+    user_username: "user.username",
+    request_url: "request.url",
+    request_method: "request.method"
+  });
+  mapSdkFields(event, data);
+  if (event.breadcrumbs?.length) data.breadcrumb_length = event.breadcrumbs.length;
+  if (event.spans?.length) data.span_length = event.spans.length;
+  mapTags(event, data);
+  return data;
+}
+function buildLogData(log) {
+  const data = {
+    timestamp: formatTimestamp(log.timestamp),
+    type: "log",
+    level: log.level
+  };
+  mapFields(log, data, {
+    message: "body",
+    trace_id: "trace_id",
+    severity_number: "severity_number"
+  });
+  if (log.attributes) {
+    for (const [key, attr] of Object.entries(log.attributes)) {
+      data[key] = attr.value;
+    }
+  }
+  return data;
+}
+function buildTraceData(event) {
+  const data = {
+    timestamp: formatTimestamp(event.timestamp),
+    type: "trace",
+    event_id: event.event_id
+  };
+  const trace = event.contexts?.trace;
+  if (trace?.trace_id) {
+    mapFields(trace, data, {
+      trace_id: "trace_id",
+      span_id: "span_id",
+      parent_span_id: "parent_span_id",
+      op: "op",
+      status: "status",
+      description: "description"
+    });
+  }
+  const duration = getDuration(event.timestamp, event.start_timestamp);
+  if (duration !== void 0) {
+    data.duration_ms = duration;
+  }
+  if (event.spans?.length) data.span_count = event.spans.length;
+  mapFields(event, data, {
+    transaction: "transaction",
+    environment: "environment",
+    release: "release",
+    platform: "platform",
+    server_name: "server_name"
+  });
+  mapSdkFields(event, data);
+  if (event.measurements) {
+    for (const [key, measurement] of Object.entries(event.measurements)) {
+      if (measurement?.value !== void 0) {
+        data[`measurement.${key}`] = measurement.value;
+      }
+    }
+  }
+  mapTags(event, data);
+  return data;
+}
+export {
+  buildErrorData,
+  buildLogData,
+  buildTraceData
+};
+//# sourceMappingURL=data-builders.js.map

package/dist/server/formatters/shared/data-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-builders.js","sources":["../../../../src/server/formatters/shared/data-builders.ts"],"sourcesContent":["import { formatTimestamp, getDuration, mapFields, mapSdkFields, mapTags } from \"../utils.ts\";\n\n/**\n * Build error event data object.\n * Used by both logfmt and json formatters.\n */\nexport function buildErrorData(event: any): Record<string, any> {\n  const data: Record<string, any> = {\n    timestamp: formatTimestamp(event.timestamp),\n    type: \"error\",\n    level: event.level || \"error\",\n    event_id: event.event_id,\n  };\n\n  const message = event.message || event.logentry?.message;\n  if (message) {\n    data.message = message;\n  }\n\n  const exc = event.exception?.values?.[0];\n  if (exc) {\n    mapFields(exc, data, {\n      exception_type: \"type\",\n      exception_value: \"value\",\n    });\n\n    const frames = exc.stacktrace?.frames;\n    if (frames?.length) {\n      const frame = frames.find((f: any) => f.in_app) || frames[frames.length - 1];\n      mapFields(frame, data, {\n        filename: \"filename\",\n        lineno: \"lineno\",\n        colno: \"colno\",\n        function: \"function\",\n      });\n    }\n  }\n\n  const trace = event.contexts?.trace;\n  if (trace?.trace_id) {\n    mapFields(trace, data, {\n      trace_id: \"trace_id\",\n      span_id: \"span_id\",\n    });\n  }\n\n  mapFields(event, data, {\n    environment: \"environment\",\n    release: \"release\",\n    dist: \"dist\",\n    platform: \"platform\",\n    transaction: \"transaction\",\n    logger: \"logger\",\n    server_name: \"server_name\",\n    user_id: \"user.id\",\n    user_email: \"user.email\",\n    user_username: \"user.username\",\n    request_url: \"request.url\",\n    request_method: \"request.method\",\n  });\n\n  mapSdkFields(event, data);\n\n  if (event.breadcrumbs?.length) data.breadcrumb_length = event.breadcrumbs.length;\n  if (event.spans?.length) data.span_length = event.spans.length;\n  mapTags(event, data);\n\n  return data;\n}\n\n/**\n * Build log event data object.\n * Used by both logfmt and json formatters.\n */\nexport function buildLogData(log: any): Record<string, any> {\n  const data: Record<string, any> = {\n    timestamp: formatTimestamp(log.timestamp),\n    type: \"log\",\n    level: log.level,\n  };\n\n  mapFields(log, data, {\n    message: \"body\",\n    trace_id: \"trace_id\",\n    severity_number: \"severity_number\",\n  });\n\n  if (log.attributes) {\n    for (const [key, attr] of Object.entries(log.attributes)) {\n      data[key] = (attr as any).value;\n    }\n  }\n\n  return data;\n}\n\n/**\n * Build trace/transaction event data object.\n * Used by both logfmt and json formatters.\n */\nexport function buildTraceData(event: any): Record<string, any> {\n  const data: Record<string, any> = {\n    timestamp: formatTimestamp(event.timestamp),\n    type: \"trace\",\n    event_id: event.event_id,\n  };\n\n  const trace = event.contexts?.trace;\n  if (trace?.trace_id) {\n    mapFields(trace, data, {\n      trace_id: \"trace_id\",\n      span_id: \"span_id\",\n      parent_span_id: \"parent_span_id\",\n      op: \"op\",\n      status: \"status\",\n      description: \"description\",\n    });\n  }\n\n  const duration = getDuration(event.timestamp, event.start_timestamp);\n  if (duration !== undefined) {\n    data.duration_ms = duration;\n  }\n\n  if (event.spans?.length) data.span_count = event.spans.length;\n\n  mapFields(event, data, {\n    transaction: \"transaction\",\n    environment: \"environment\",\n    release: \"release\",\n    platform: \"platform\",\n    server_name: \"server_name\",\n  });\n\n  mapSdkFields(event, data);\n\n  if (event.measurements) {\n    for (const [key, measurement] of Object.entries(event.measurements)) {\n      if ((measurement as any)?.value !== undefined) {\n        data[`measurement.${key}`] = (measurement as any).value;\n      }\n    }\n  }\n\n  mapTags(event, data);\n\n  return data;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,33 @@
+import { Envelope } from '@sentry/core';
+import { SentryErrorEvent, SentryEvent, SentryLogEvent, SentryTransactionEvent } from '../parser/types.ts';
+/**
+ * Strongly-typed formatter functions (no type guards needed in implementation)
+ */
+export type ErrorFormatterFn = (event: SentryErrorEvent, envelopeHeader: Envelope[0]) => string[];
+export type LogFormatterFn = (event: SentryLogEvent, envelopeHeader: Envelope[0]) => string[];
+export type TraceFormatterFn = (event: SentryTransactionEvent, envelopeHeader: Envelope[0]) => string[];
+/**
+ * Registry entry that bundles the formatter with its type guard
+ */
+export type FormatterEntry<T extends SentryEvent> = {
+    typeGuard: (event: SentryEvent) => event is T;
+    format: (event: T, envelopeHeader: Envelope[0]) => string[];
+};
+/**
+ * The formatter registry structure - this IS the formatters object
+ */
+export type FormatterRegistry = {
+    event: FormatterEntry<SentryErrorEvent>;
+    log: FormatterEntry<SentryLogEvent>;
+    transaction: FormatterEntry<SentryTransactionEvent>;
+};
+/**
+ * Available formatter types.
+ * Add new formatters here as they are implemented.
+ */
+export type FormatterType = "md" | "logfmt" | "json" | "human";
+/**
+ * Runtime array of valid formatter types for validation.
+ * Keep in sync with FormatterType.
+ */
+export declare const AVAILABLE_FORMATTERS: readonly FormatterType[];

package/dist/server/formatters/types.js

@@ -0,0 +1,5 @@
+const AVAILABLE_FORMATTERS = ["md", "logfmt", "json", "human"];
+export {
+  AVAILABLE_FORMATTERS
+};
+//# sourceMappingURL=types.js.map

package/dist/server/formatters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../src/server/formatters/types.ts"],"sourcesContent":["import type { Envelope } from \"@sentry/core\";\nimport type { SentryErrorEvent, SentryEvent, SentryLogEvent, SentryTransactionEvent } from \"../parser/types.ts\";\n\n/**\n * Strongly-typed formatter functions (no type guards needed in implementation)\n */\nexport type ErrorFormatterFn = (event: SentryErrorEvent, envelopeHeader: Envelope[0]) => string[];\nexport type LogFormatterFn = (event: SentryLogEvent, envelopeHeader: Envelope[0]) => string[];\nexport type TraceFormatterFn = (event: SentryTransactionEvent, envelopeHeader: Envelope[0]) => string[];\n\n/**\n * Registry entry that bundles the formatter with its type guard\n */\nexport type FormatterEntry<T extends SentryEvent> = {\n  typeGuard: (event: SentryEvent) => event is T;\n  format: (event: T, envelopeHeader: Envelope[0]) => string[];\n};\n\n/**\n * The formatter registry structure - this IS the formatters object\n */\nexport type FormatterRegistry = {\n  event: FormatterEntry<SentryErrorEvent>;\n  log: FormatterEntry<SentryLogEvent>;\n  transaction: FormatterEntry<SentryTransactionEvent>;\n};\n\n/**\n * Available formatter types.\n * Add new formatters here as they are implemented.\n */\nexport type FormatterType = \"md\" | \"logfmt\" | \"json\" | \"human\";\n\n/**\n * Runtime array of valid formatter types for validation.\n * Keep in sync with FormatterType.\n */\nexport const AVAILABLE_FORMATTERS: readonly FormatterType[] = [\"md\", \"logfmt\", \"json\", \"human\"] as const;\n"],"names":[],"mappings":"AAqCO,MAAM,uBAAiD,CAAC,MAAM,UAAU,QAAQ,OAAO;"}

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

@@ -0,0 +1,25 @@
+/**
+ * Format a Sentry timestamp (in seconds) to ISO string.
+ * Sentry timestamps are Unix timestamps in seconds, so we multiply by 1000 to convert to milliseconds.
+ * Falls back to epoch (1970-01-01T00:00:00.000Z) if timestamp is missing/invalid.
+ */
+export declare function formatTimestamp(timestamp?: number): string;
+/**
+ * Get the duration in milliseconds between two Sentry timestamps.
+ * Accepts timestamps in seconds (as numbers or strings).
+ * Returns undefined if either timestamp is missing or invalid.
+ */
+export declare function getDuration(endTimestamp?: number | string, startTimestamp?: number | string): number | undefined;
+/**
+ * Map simple fields from source to data object.
+ * Only sets fields if the source value is truthy.
+ */
+export declare function mapFields(source: any, data: Record<string, any>, fieldMappings: Record<string, string>): void;
+/**
+ * Map SDK name and version fields
+ */
+export declare function mapSdkFields(source: any, data: Record<string, any>): void;
+/**
+ * Map tags directly to data object
+ */
+export declare function mapTags(source: any, data: Record<string, any>): void;

package/dist/server/formatters/utils.js

@@ -0,0 +1,46 @@
+function formatTimestamp(timestamp) {
+  const date = timestamp ? new Date(timestamp * 1e3) : /* @__PURE__ */ new Date(0);
+  return date.toISOString();
+}
+function getDuration(endTimestamp, startTimestamp) {
+  const end = typeof endTimestamp === "string" ? Number.parseFloat(endTimestamp) : endTimestamp;
+  const start = typeof startTimestamp === "string" ? Number.parseFloat(startTimestamp) : startTimestamp;
+  if (typeof end === "number" && typeof start === "number" && !Number.isNaN(end) && !Number.isNaN(start)) {
+    return Math.round((end - start) * 1e3);
+  }
+  return void 0;
+}
+function mapFields(source, data, fieldMappings) {
+  for (const [outputKey, sourcePath] of Object.entries(fieldMappings)) {
+    const value = getNestedValue(source, sourcePath);
+    if (value !== void 0 && value !== null) {
+      data[outputKey] = value;
+    }
+  }
+}
+function mapSdkFields(source, data) {
+  if (source.sdk?.name) {
+    data.sdk = source.sdk.name;
+    if (source.sdk.version) {
+      data.sdk_version = source.sdk.version;
+    }
+  }
+}
+function mapTags(source, data) {
+  if (source.tags) {
+    for (const [key, value] of Object.entries(source.tags)) {
+      data[key] = value;
+    }
+  }
+}
+function getNestedValue(obj, path) {
+  return path.split(".").reduce((current, key) => current?.[key], obj);
+}
+export {
+  formatTimestamp,
+  getDuration,
+  mapFields,
+  mapSdkFields,
+  mapTags
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sources":["../../../src/server/formatters/utils.ts"],"sourcesContent":["/**\n * Format a Sentry timestamp (in seconds) to ISO string.\n * Sentry timestamps are Unix timestamps in seconds, so we multiply by 1000 to convert to milliseconds.\n * Falls back to epoch (1970-01-01T00:00:00.000Z) if timestamp is missing/invalid.\n */\nexport function formatTimestamp(timestamp?: number): string {\n  const date = timestamp ? new Date(timestamp * 1000) : new Date(0);\n  return date.toISOString();\n}\n\n/**\n * Get the duration in milliseconds between two Sentry timestamps.\n * Accepts timestamps in seconds (as numbers or strings).\n * Returns undefined if either timestamp is missing or invalid.\n */\n\nexport function getDuration(endTimestamp?: number | string, startTimestamp?: number | string): number | undefined {\n  const end = typeof endTimestamp === \"string\" ? Number.parseFloat(endTimestamp) : endTimestamp;\n  const start = typeof startTimestamp === \"string\" ? Number.parseFloat(startTimestamp) : startTimestamp;\n\n  if (typeof end === \"number\" && typeof start === \"number\" && !Number.isNaN(end) && !Number.isNaN(start)) {\n    return Math.round((end - start) * 1000);\n  }\n\n  return undefined;\n}\n\n/**\n * Map simple fields from source to data object.\n * Only sets fields if the source value is truthy.\n */\nexport function mapFields(source: any, data: Record<string, any>, fieldMappings: Record<string, string>): void {\n  for (const [outputKey, sourcePath] of Object.entries(fieldMappings)) {\n    const value = getNestedValue(source, sourcePath);\n    if (value !== undefined && value !== null) {\n      data[outputKey] = value;\n    }\n  }\n}\n\n/**\n * Map SDK name and version fields\n */\nexport function mapSdkFields(source: any, data: Record<string, any>): void {\n  if (source.sdk?.name) {\n    data.sdk = source.sdk.name;\n    if (source.sdk.version) {\n      data.sdk_version = source.sdk.version;\n    }\n  }\n}\n\n/**\n * Map tags directly to data object\n */\nexport function mapTags(source: any, data: Record<string, any>): void {\n  if (source.tags) {\n    for (const [key, value] of Object.entries(source.tags)) {\n      data[key] = value;\n    }\n  }\n}\n\n/**\n * Get nested value from object using dot notation path\n */\nfunction getNestedValue(obj: any, path: string): any {\n  return path.split(\".\").reduce((current, key) => current?.[key], obj);\n}\n"],"names":[],"mappings":"AAKO,SAAS,gBAAgB,WAA4B;AAC1D,QAAM,OAAO,YAAY,IAAI,KAAK,YAAY,GAAI,IAAI,oBAAI,KAAK,CAAC;AAChE,SAAO,KAAK,YAAA;AACd;AAQO,SAAS,YAAY,cAAgC,gBAAsD;AAChH,QAAM,MAAM,OAAO,iBAAiB,WAAW,OAAO,WAAW,YAAY,IAAI;AACjF,QAAM,QAAQ,OAAO,mBAAmB,WAAW,OAAO,WAAW,cAAc,IAAI;AAEvF,MAAI,OAAO,QAAQ,YAAY,OAAO,UAAU,YAAY,CAAC,OAAO,MAAM,GAAG,KAAK,CAAC,OAAO,MAAM,KAAK,GAAG;AACtG,WAAO,KAAK,OAAO,MAAM,SAAS,GAAI;AAAA,EACxC;AAEA,SAAO;AACT;AAMO,SAAS,UAAU,QAAa,MAA2B,eAA6C;AAC7G,aAAW,CAAC,WAAW,UAAU,KAAK,OAAO,QAAQ,aAAa,GAAG;AACnE,UAAM,QAAQ,eAAe,QAAQ,UAAU;AAC/C,QAAI,UAAU,UAAa,UAAU,MAAM;AACzC,WAAK,SAAS,IAAI;AAAA,IACpB;AAAA,EACF;AACF;AAKO,SAAS,aAAa,QAAa,MAAiC;AACzE,MAAI,OAAO,KAAK,MAAM;AACpB,SAAK,MAAM,OAAO,IAAI;AACtB,QAAI,OAAO,IAAI,SAAS;AACtB,WAAK,cAAc,OAAO,IAAI;AAAA,IAChC;AAAA,EACF;AACF;AAKO,SAAS,QAAQ,QAAa,MAAiC;AACpE,MAAI,OAAO,MAAM;AACf,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,OAAO,IAAI,GAAG;AACtD,WAAK,GAAG,IAAI;AAAA,IACd;AAAA,EACF;AACF;AAKA,SAAS,eAAe,KAAU,MAAmB;AACnD,SAAO,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,SAAS,QAAQ,UAAU,GAAG,GAAG,GAAG;AACrE;"}

package/dist/server/handlers/fileToServe.d.ts

@@ -0,0 +1,2 @@
+import { Handler } from 'hono';
+export declare function serveFilesHandler(filesToServe: Record<string, Buffer>): Handler;

package/dist/server/handlers/fileToServe.js

@@ -0,0 +1,27 @@
+import { extname } from "node:path";
+const extensionsToContentType = {
+  ".js": "text/javascript",
+  ".css": "text/css",
+  ".json": "application/json"
+};
+function serveFilesHandler(filesToServe) {
+  return (ctx) => {
+    let filePath = `${ctx.req.path || ctx.req.url}`;
+    if (filePath === "/" || filePath.startsWith("/telemetry")) {
+      filePath = "/index.html";
+    }
+    filePath = filePath.slice(1);
+    const extName = extname(filePath);
+    const contentType = extensionsToContentType[extName] ?? "text/html";
+    if (!Object.hasOwn(filesToServe, filePath) || !filesToServe[filePath]) {
+      return ctx.notFound();
+    }
+    ctx.header("Document-Policy", "js-profiling");
+    ctx.header("Content-Type", contentType);
+    return ctx.body(new Uint8Array(filesToServe[filePath]));
+  };
+}
+export {
+  serveFilesHandler
+};
+//# sourceMappingURL=fileToServe.js.map

package/dist/server/handlers/fileToServe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileToServe.js","sources":["../../../src/server/handlers/fileToServe.ts"],"sourcesContent":["import { extname } from \"node:path\";\nimport type { Handler } from \"hono\";\n\nconst extensionsToContentType: Record<string, string | undefined> = {\n  \".js\": \"text/javascript\",\n  \".css\": \"text/css\",\n  \".json\": \"application/json\",\n};\n\nexport function serveFilesHandler(filesToServe: Record<string, Buffer>): Handler {\n  return ctx => {\n    let filePath = `${ctx.req.path || ctx.req.url}`;\n\n    // The `/telemetry` route is handled by the React app with the location\n    // router. This is kind of a hack to avoid a 404 when the user refreshes\n    // the page or directly navigates to `/telemetry`. Should probably find\n    // a better way to share routes from the UI to the server later on.\n    if (filePath === \"/\" || filePath.startsWith(\"/telemetry\")) {\n      filePath = \"/index.html\";\n    }\n\n    filePath = filePath.slice(1);\n\n    const extName = extname(filePath);\n    const contentType = extensionsToContentType[extName] ?? \"text/html\";\n\n    if (!Object.hasOwn(filesToServe, filePath) || !filesToServe[filePath]) {\n      return ctx.notFound();\n    }\n\n    // Enable profiling in browser\n    ctx.header(\"Document-Policy\", \"js-profiling\");\n    ctx.header(\"Content-Type\", contentType);\n\n    return ctx.body(new Uint8Array(filesToServe[filePath]));\n  };\n}\n"],"names":[],"mappings":";AAGA,MAAM,0BAA8D;AAAA,EAClE,OAAO;AAAA,EACP,QAAQ;AAAA,EACR,SAAS;AACX;AAEO,SAAS,kBAAkB,cAA+C;AAC/E,SAAO,CAAA,QAAO;AACZ,QAAI,WAAW,GAAG,IAAI,IAAI,QAAQ,IAAI,IAAI,GAAG;AAM7C,QAAI,aAAa,OAAO,SAAS,WAAW,YAAY,GAAG;AACzD,iBAAW;AAAA,IACb;AAEA,eAAW,SAAS,MAAM,CAAC;AAE3B,UAAM,UAAU,QAAQ,QAAQ;AAChC,UAAM,cAAc,wBAAwB,OAAO,KAAK;AAExD,QAAI,CAAC,OAAO,OAAO,cAAc,QAAQ,KAAK,CAAC,aAAa,QAAQ,GAAG;AACrE,aAAO,IAAI,SAAA;AAAA,IACb;AAGA,QAAI,OAAO,mBAAmB,cAAc;AAC5C,QAAI,OAAO,gBAAgB,WAAW;AAEtC,WAAO,IAAI,KAAK,IAAI,WAAW,aAAa,QAAQ,CAAC,CAAC;AAAA,EACxD;AACF;"}

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

@@ -0,0 +1 @@
+export * from './fileToServe.ts';

package/dist/server/logger.d.ts

@@ -0,0 +1,5 @@
+import { SidecarLogger } from './types/index.ts';
+export declare function activateLogger(logger: SidecarLogger): void;
+export declare function enableDebugLogging(debug: boolean): void;
+export declare function isDebugEnabled(): boolean;
+export declare const logger: SidecarLogger;

package/dist/server/logger.js

@@ -0,0 +1,31 @@
+const SPOTLIGHT_PREFIX = "🔎 [Spotlight]";
+const defaultLogger = {
+  info: (message) => console.error(SPOTLIGHT_PREFIX, message),
+  warn: (message) => console.error(SPOTLIGHT_PREFIX, message),
+  error: (message) => console.error(SPOTLIGHT_PREFIX, message),
+  debug: (message) => debugEnabled && console.error(SPOTLIGHT_PREFIX, message)
+};
+let injectedLogger = void 0;
+let debugEnabled = false;
+function activateLogger(logger2) {
+  injectedLogger = logger2;
+}
+function enableDebugLogging(debug) {
+  debugEnabled = debug;
+}
+function isDebugEnabled() {
+  return debugEnabled;
+}
+const logger = {
+  info: (message) => (injectedLogger || defaultLogger).info(message),
+  warn: (message) => (injectedLogger || defaultLogger).warn(message),
+  error: (message) => (injectedLogger || defaultLogger).error(message),
+  debug: (message) => (injectedLogger || defaultLogger).debug(message)
+};
+export {
+  activateLogger,
+  enableDebugLogging,
+  isDebugEnabled,
+  logger
+};
+//# sourceMappingURL=logger.js.map

package/dist/server/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../src/server/logger.ts"],"sourcesContent":["import type { SidecarLogger } from \"./types/index.ts\";\n\nconst SPOTLIGHT_PREFIX = \"🔎 [Spotlight]\";\n\nconst defaultLogger: SidecarLogger = {\n  info: message => console.error(SPOTLIGHT_PREFIX, message),\n  warn: message => console.error(SPOTLIGHT_PREFIX, message),\n  error: message => console.error(SPOTLIGHT_PREFIX, message),\n  debug: message => debugEnabled && console.error(SPOTLIGHT_PREFIX, message),\n};\n\nlet injectedLogger: SidecarLogger | undefined = undefined;\nlet debugEnabled = false;\n\nexport function activateLogger(logger: SidecarLogger): void {\n  injectedLogger = logger;\n}\n\nexport function enableDebugLogging(debug: boolean): void {\n  debugEnabled = debug;\n}\n\nexport function isDebugEnabled(): boolean {\n  return debugEnabled;\n}\n\nexport const logger: SidecarLogger = {\n  info: message => (injectedLogger || defaultLogger).info(message),\n  warn: message => (injectedLogger || defaultLogger).warn(message),\n  error: message => (injectedLogger || defaultLogger).error(message),\n  debug: message => (injectedLogger || defaultLogger).debug(message),\n};\n"],"names":["logger"],"mappings":"AAEA,MAAM,mBAAmB;AAEzB,MAAM,gBAA+B;AAAA,EACnC,MAAM,CAAA,YAAW,QAAQ,MAAM,kBAAkB,OAAO;AAAA,EACxD,MAAM,CAAA,YAAW,QAAQ,MAAM,kBAAkB,OAAO;AAAA,EACxD,OAAO,CAAA,YAAW,QAAQ,MAAM,kBAAkB,OAAO;AAAA,EACzD,OAAO,CAAA,YAAW,gBAAgB,QAAQ,MAAM,kBAAkB,OAAO;AAC3E;AAEA,IAAI,iBAA4C;AAChD,IAAI,eAAe;AAEZ,SAAS,eAAeA,SAA6B;AAC1D,mBAAiBA;AACnB;AAEO,SAAS,mBAAmB,OAAsB;AACvD,iBAAe;AACjB;AAEO,SAAS,iBAA0B;AACxC,SAAO;AACT;AAEO,MAAM,SAAwB;AAAA,EACnC,MAAM,CAAA,aAAY,kBAAkB,eAAe,KAAK,OAAO;AAAA,EAC/D,MAAM,CAAA,aAAY,kBAAkB,eAAe,KAAK,OAAO;AAAA,EAC/D,OAAO,CAAA,aAAY,kBAAkB,eAAe,MAAM,OAAO;AAAA,EACjE,OAAO,CAAA,aAAY,kBAAkB,eAAe,MAAM,OAAO;AACnE;"}

package/dist/server/main.d.ts

@@ -0,0 +1,6 @@
+import { Server } from 'node:http';
+import { SideCarOptions, StartServerOptions } from './types/index.ts';
+export declare function startServer(options: StartServerOptions): Promise<Server>;
+export declare function setupSpotlight({ port, logger: customLogger, basePath, filesToServe, incomingPayload, isStandalone }?: SideCarOptions): Promise<Server | undefined>;
+export declare function clearBuffer(): void;
+export declare function setShutdownHandlers(server: Server): void;

package/dist/server/main.js

@@ -0,0 +1,175 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { serve } from "@hono/node-server";
+import { addEventProcessor, startSpan, getTraceData, captureException } from "@sentry/node";
+import { Hono } from "hono";
+import { cors } from "../node_modules/.pnpm/hono@4.10.3/node_modules/hono/dist/middleware/cors/index.js";
+import { DEFAULT_PORT, SERVER_IDENTIFIER } from "./constants.js";
+import { serveFilesHandler } from "./handlers/fileToServe.js";
+import { activateLogger, logger } from "./logger.js";
+import router from "./routes/index.js";
+import { getBuffer } from "./utils/getBuffer.js";
+import "./parser/helpers.js";
+import "uuidv7";
+import { isValidPort, isSidecarRunning, logSpotlightUrl } from "./utils/extras.js";
+import { isAllowedOrigin } from "./utils/cors.js";
+let portInUseRetryTimeout = null;
+const MAX_RETRIES = 3;
+async function startServer(options) {
+  const { port, basePath } = options;
+  let filesToServe = options.filesToServe;
+  if (!filesToServe && basePath) {
+    try {
+      filesToServe = {
+        "index.html": readFileSync(join(basePath, "index.html")),
+        "assets/main.js": readFileSync(join(basePath, "assets/main.js"))
+      };
+    } catch {
+    }
+  }
+  const app = new Hono().use(
+    cors({
+      origin: (origin) => isAllowedOrigin(origin) ? origin : null
+    })
+  );
+  app.use(async (ctx, next) => {
+    ctx.header("X-Powered-By", SERVER_IDENTIFIER);
+    ctx.set("basePath", options.basePath);
+    ctx.set("incomingPayload", options.incomingPayload);
+    const host = ctx.req.header("Host") || "localhost";
+    const path = ctx.req.path;
+    await startSpan(
+      {
+        name: `HTTP ${ctx.req.method} ${path}`,
+        op: `sidecar.http.${ctx.req.method?.toLowerCase()}`,
+        forceTransaction: true,
+        attributes: {
+          "http.request.method": ctx.req.method,
+          "http.request.url": ctx.req.url,
+          "http.request.query": ctx.req.query().toString(),
+          "server.address": host,
+          "server.port": ctx.env.incoming.socket.localPort
+        }
+      },
+      async (span) => {
+        const traceData = getTraceData();
+        ctx.header(
+          "server-timing",
+          [
+            `sentryTrace;desc="${traceData["sentry-trace"]}"`,
+            `baggage;desc="${traceData.baggage}"`,
+            `sentrySpotlightPort;desc=${ctx.env.incoming.socket.localPort}`
+          ].join(", ")
+        );
+        if (path === "/mcp" || path === "/health") {
+          await next();
+        } else {
+          await startSpan({ name: "enableCORS", op: "sidecar.http.middleware.cors" }, () => next());
+        }
+        span.setAttribute("http.response.status_code", ctx.res.status);
+      }
+    );
+  }).route("/", router);
+  if (filesToServe) {
+    app.get("/*", serveFilesHandler(filesToServe));
+  }
+  let resolve;
+  let reject;
+  const promise = new Promise((res, rej) => {
+    resolve = res;
+    reject = rej;
+  });
+  const server = serve(
+    {
+      fetch: app.fetch,
+      port
+    },
+    () => {
+      const realPort = server.address().port;
+      logger.info(`Spotlight listening on ${realPort}`);
+      if (basePath) {
+        logSpotlightUrl(realPort);
+      }
+      resolve(server);
+    }
+  );
+  server.addListener("error", handleServerError);
+  let retries = 0;
+  function handleServerError(err) {
+    if ("code" in err && err.code === "EADDRINUSE") {
+      logger.info(`Port ${options.port} in use, retrying...`);
+      server.close();
+      retries++;
+      if (retries > MAX_RETRIES) {
+        reject(err);
+        return;
+      }
+      if (portInUseRetryTimeout) {
+        clearTimeout(portInUseRetryTimeout);
+      }
+      portInUseRetryTimeout = setTimeout(() => {
+        server.listen(options.port);
+      }, 5e3);
+      portInUseRetryTimeout.unref();
+    } else {
+      captureException(err);
+      reject(err);
+    }
+  }
+  return promise;
+}
+async function setupSpotlight({ port, logger: customLogger, basePath, filesToServe, incomingPayload, isStandalone } = {
+  port: DEFAULT_PORT
+}) {
+  if (!isStandalone) {
+    addEventProcessor((event) => event.spans?.some((span) => span.op?.startsWith("sidecar.")) ? null : event);
+  }
+  if (customLogger) {
+    activateLogger(customLogger);
+  }
+  if (port && !isValidPort(port)) {
+    throw new Error(`Invalid port number: ${port}. Must be between 1 and 65535, or 0 for automatic assignment.`);
+  }
+  if (port > 0 && await isSidecarRunning(port)) {
+    logger.info(`Spotlight is already running on port ${port}`);
+    const hasSpotlightUI = filesToServe && "index.html" in filesToServe || !filesToServe && basePath;
+    if (hasSpotlightUI) {
+      logSpotlightUrl(port);
+    }
+    return;
+  }
+  const serverInstance = await startServer({
+    port,
+    basePath,
+    filesToServe,
+    incomingPayload
+  });
+  setShutdownHandlers(serverInstance);
+  return serverInstance;
+}
+function clearBuffer() {
+  getBuffer().reset();
+}
+function setShutdownHandlers(server) {
+  let forceShutdown = false;
+  const shutdown = () => {
+    if (forceShutdown) {
+      logger.info("Bye.");
+      process.exit(0);
+    }
+    forceShutdown = true;
+    logger.info("Shutting down server gracefully...");
+    server.close();
+    server.closeAllConnections();
+    server.unref();
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+export {
+  clearBuffer,
+  setShutdownHandlers,
+  setupSpotlight,
+  startServer
+};
+//# sourceMappingURL=main.js.map

package/dist/server/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sources":["../../src/server/main.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport type { Server } from \"node:http\";\nimport type { AddressInfo } from \"node:net\";\nimport { join } from \"node:path\";\nimport { serve } from \"@hono/node-server\";\nimport { addEventProcessor, captureException, getTraceData, startSpan } from \"@sentry/node\";\nimport { Hono } from \"hono\";\nimport { cors } from \"hono/cors\";\nimport { DEFAULT_PORT, SERVER_IDENTIFIER } from \"./constants.ts\";\nimport { serveFilesHandler } from \"./handlers/index.ts\";\nimport { activateLogger, logger } from \"./logger.ts\";\nimport routes from \"./routes/index.ts\";\nimport type { HonoEnv, SideCarOptions, StartServerOptions } from \"./types/index.ts\";\nimport { getBuffer, isAllowedOrigin, isSidecarRunning, isValidPort, logSpotlightUrl } from \"./utils/index.ts\";\n\nlet portInUseRetryTimeout: NodeJS.Timeout | null = null;\n\nconst MAX_RETRIES = 3;\nexport async function startServer(options: StartServerOptions): Promise<Server> {\n  const { port, basePath } = options;\n  let filesToServe = options.filesToServe;\n  if (!filesToServe && basePath) {\n    try {\n      filesToServe = {\n        \"index.html\": readFileSync(join(basePath, \"index.html\")),\n        \"assets/main.js\": readFileSync(join(basePath, \"assets/main.js\")),\n      };\n    } catch {\n      // pass -- no UI\n    }\n  }\n\n  const app = new Hono<HonoEnv>().use(\n    cors({\n      origin: origin => (isAllowedOrigin(origin) ? origin : null),\n    }),\n  );\n\n  app\n    .use(async (ctx, next) => {\n      ctx.header(\"X-Powered-By\", SERVER_IDENTIFIER);\n\n      ctx.set(\"basePath\", options.basePath);\n      ctx.set(\"incomingPayload\", options.incomingPayload);\n\n      const host = ctx.req.header(\"Host\") || \"localhost\";\n      const path = ctx.req.path;\n      await startSpan(\n        {\n          name: `HTTP ${ctx.req.method} ${path}`,\n          op: `sidecar.http.${ctx.req.method?.toLowerCase()}`,\n          forceTransaction: true,\n          attributes: {\n            \"http.request.method\": ctx.req.method,\n            \"http.request.url\": ctx.req.url,\n            \"http.request.query\": ctx.req.query().toString(),\n            \"server.address\": host,\n            \"server.port\": ctx.env.incoming.socket.localPort,\n          },\n        },\n        async span => {\n          const traceData = getTraceData();\n          ctx.header(\n            \"server-timing\",\n            [\n              `sentryTrace;desc=\"${traceData[\"sentry-trace\"]}\"`,\n              `baggage;desc=\"${traceData.baggage}\"`,\n              `sentrySpotlightPort;desc=${ctx.env.incoming.socket.localPort}`,\n            ].join(\", \"),\n          );\n\n          if (path === \"/mcp\" || path === \"/health\") {\n            await next();\n          } else {\n            await startSpan({ name: \"enableCORS\", op: \"sidecar.http.middleware.cors\" }, () => next());\n          }\n\n          span.setAttribute(\"http.response.status_code\", ctx.res.status);\n        },\n      );\n    })\n    .route(\"/\", routes);\n\n  if (filesToServe) {\n    app.get(\"/*\", serveFilesHandler(filesToServe));\n  }\n\n  let resolve: (value: Server) => void;\n  let reject!: (err: Error) => void;\n  const promise = new Promise<Server>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n  const server = serve(\n    {\n      fetch: app.fetch,\n      port,\n    },\n    () => {\n      const realPort = (server.address() as AddressInfo).port;\n      logger.info(`Spotlight listening on ${realPort}`);\n      if (basePath) {\n        logSpotlightUrl(realPort);\n      }\n      resolve(server as Server);\n    },\n  );\n  server.addListener(\"error\", handleServerError);\n\n  let retries = 0;\n  function handleServerError(err: { code?: string }): void {\n    if (\"code\" in err && err.code === \"EADDRINUSE\") {\n      logger.info(`Port ${options.port} in use, retrying...`);\n      server.close();\n\n      retries++;\n      if (retries > MAX_RETRIES) {\n        reject(err as Error);\n        return;\n      }\n\n      if (portInUseRetryTimeout) {\n        clearTimeout(portInUseRetryTimeout);\n      }\n      portInUseRetryTimeout = setTimeout(() => {\n        server.listen(options.port);\n      }, 5000);\n      portInUseRetryTimeout.unref();\n    } else {\n      captureException(err);\n      reject(err as Error);\n    }\n  }\n\n  return promise;\n}\n\nexport async function setupSpotlight(\n  { port, logger: customLogger, basePath, filesToServe, incomingPayload, isStandalone }: SideCarOptions = {\n    port: DEFAULT_PORT,\n  },\n): Promise<Server | undefined> {\n  if (!isStandalone) {\n    addEventProcessor(event => (event.spans?.some(span => span.op?.startsWith(\"sidecar.\")) ? null : event));\n  }\n\n  if (customLogger) {\n    activateLogger(customLogger);\n  }\n\n  if (port && !isValidPort(port)) {\n    throw new Error(`Invalid port number: ${port}. Must be between 1 and 65535, or 0 for automatic assignment.`);\n  }\n\n  if (port > 0 && (await isSidecarRunning(port))) {\n    logger.info(`Spotlight is already running on port ${port}`);\n    const hasSpotlightUI = (filesToServe && \"index.html\" in filesToServe) || (!filesToServe && basePath);\n    if (hasSpotlightUI) {\n      logSpotlightUrl(port);\n    }\n    return;\n  }\n  const serverInstance = await startServer({\n    port,\n    basePath,\n    filesToServe,\n    incomingPayload,\n  });\n  setShutdownHandlers(serverInstance);\n  return serverInstance;\n}\n\nexport function clearBuffer(): void {\n  getBuffer().reset();\n}\n\nexport function setShutdownHandlers(server: Server): void {\n  let forceShutdown = false;\n  const shutdown = () => {\n    if (forceShutdown) {\n      logger.info(\"Bye.\");\n      process.exit(0);\n    }\n\n    forceShutdown = true;\n    logger.info(\"Shutting down server gracefully...\");\n    server.close();\n    server.closeAllConnections();\n    server.unref();\n  };\n\n  process.on(\"SIGINT\", shutdown);\n  process.on(\"SIGTERM\", shutdown);\n}\n"],"names":["routes"],"mappings":"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"}

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

@@ -0,0 +1,3 @@
+import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const NO_ERRORS_CONTENT: CallToolResult;
+export declare const NO_LOGS_CONTENT: CallToolResult;

package/dist/server/mcp/constants.js

@@ -0,0 +1,79 @@
+const NO_ERRORS_CONTENT = {
+  content: [
+    {
+      type: "text",
+      text: `**No errors detected in Spotlight**
+
+**This means:**
+- Application is currently running without runtime failures
+- No crashes, exceptions, or critical issues in the recent timeframe
+- System appears stable at the moment
+
+**Next debugging steps:**
+
+1. **If user reports a specific issue:**
+   - Ask them to reproduce the problem (click the button, submit the form, navigate to the page)
+   - Run this tool again immediately after they reproduce it
+   - Errors will appear in real-time as they happen
+
+2. **If investigating existing code:**
+   - Check application logs separately
+   - Look for TODO comments, error handling gaps, or potential edge cases in the code
+   - Consider testing error scenarios (invalid inputs, network failures, etc.)
+
+3. **Proactive error detection:**
+   - Have user interact with recently changed features
+   - Test API endpoints or database operations that might be fragile
+   - Check pages/features mentioned in recent commits
+
+** Pro tip:** Absence of errors doesn't mean absence of bugs - it just means no runtime failures occurred recently. The issue might be logical errors, UI problems, or dormant bugs waiting for specific conditions.`
+    }
+  ]
+};
+const NO_LOGS_CONTENT = {
+  content: [
+    {
+      type: "text",
+      text: `**No logs detected in Spotlight**
+
+**This means:**
+- Application hasn't generated any log messages in the recent timeframe
+- No debug, info, warning, or trace messages were captured
+- Application might be idle or not actively processing requests
+
+**Next debugging steps:**
+
+1. **If investigating application behavior:**
+   - Have user interact with the application (navigate pages, submit forms, trigger features)
+   - Run this tool again after user activity to capture runtime logs
+   - Logs appear in real-time as your application executes
+
+2. **If checking for specific functionality:**
+   - Trigger the feature or workflow you're investigating
+   - Look for custom logging statements in your code
+   - Consider adding more logging to critical paths if needed
+
+3. **If monitoring general health:**
+   - Check that logging is properly configured in your application
+   - Verify that Spotlight is correctly capturing your log output
+   - Test with known log-generating actions (API calls, database operations)
+
+4. **Expand search timeframe:**
+   - Use a longer duration (300+ seconds) to capture older log entries
+   - Consider that some operations might generate logs less frequently
+
+**Log Levels to expect:**
+- **INFO**: General application flow and significant events
+- **WARN**: Potential issues or important notices
+- **DEBUG**: Detailed execution information
+- **ERROR**: Failures (also check search_errors tool)
+
+**Pro tip:** Absence of logs doesn't mean your application isn't working - it might just be running quietly. Many applications only log during significant events, errors, or when explicitly configured for verbose logging.`
+    }
+  ]
+};
+export {
+  NO_ERRORS_CONTENT,
+  NO_LOGS_CONTENT
+};
+//# sourceMappingURL=constants.js.map