@spotlightjs/spotlight 4.5.0 → 4.6.0

package/dist/server/routes/stream/index.js

@@ -0,0 +1,98 @@
+import { createWriteStream } from "node:fs";
+import { decompressBody, pushToSpotlightBuffer } from "../../sdk.js";
+import { SENTRY_CONTENT_TYPE } from "../../../shared/constants.js";
+import { Hono } from "hono";
+import { logger } from "../../logger.js";
+import { getBuffer } from "../../utils/getBuffer.js";
+import "../../parser/helpers.js";
+import "uuidv7";
+import "node:http";
+import "@sentry/node";
+import { logOutgoingEvent, logIncomingEvent } from "./debugLogging.js";
+import { streamSSE } from "./streaming.js";
+import { parseBrowserFromUserAgent } from "./userAgent.js";
+const router = new Hono().get("/stream", (ctx) => {
+  const buffer = getBuffer();
+  const useBase64 = ctx.req.query("base64") != null;
+  const base64Indicator = useBase64 ? ";base64" : "";
+  let clientId = ctx.req.query("client");
+  if (!clientId) {
+    const userAgent = ctx.req.header("User-Agent") || "unknown";
+    clientId = parseBrowserFromUserAgent(userAgent);
+  }
+  clientId = clientId.replace(/[^\w\s.\-/()]/g, "");
+  if (!clientId) clientId = "unknown";
+  return streamSSE(ctx, async (stream) => {
+    const lastEventId = ctx.req.header("Last-Event-ID");
+    const sub = buffer.subscribe((container) => {
+      logOutgoingEvent(container, clientId);
+      const parsedEnvelope = container.getParsedEnvelope();
+      if (parsedEnvelope) {
+        stream.writeSSE({
+          id: parsedEnvelope.envelope[0].__spotlight_envelope_id.toString(),
+          event: `${container.getContentType()}${base64Indicator}`,
+          data: JSON.stringify(parsedEnvelope.envelope)
+        });
+      }
+    }, lastEventId);
+    stream.onAbort(() => {
+      buffer.unsubscribe(sub);
+    });
+  });
+}).get("/envelope/:id", (ctx) => {
+  const buffer = getBuffer();
+  const envelopeId = ctx.req.param("id");
+  const container = buffer.read({ envelopeId });
+  if (container.length === 0) {
+    return ctx.notFound();
+  }
+  return ctx.body(new Uint8Array(container[0].getData()), 200, {
+    "Content-Type": container[0].getContentType(),
+    "Cache-Control": "no-cache",
+    "Content-Disposition": `attachment; filename="${envelopeId}.bin"`,
+    Connection: "keep-alive"
+  });
+}).on("POST", ["/stream", "/api/:id/envelope"], async (ctx) => {
+  let contentType = ctx.req.header("content-type")?.split(";")[0].toLocaleLowerCase();
+  if (ctx.req.query("sentry_client")?.startsWith("sentry.javascript.browser") && ctx.req.header("Origin")) {
+    contentType = SENTRY_CONTENT_TYPE;
+  }
+  const body = decompressBody(Buffer.from(await ctx.req.arrayBuffer()), ctx.req.header("Content-Encoding"));
+  const container = pushToSpotlightBuffer({
+    body,
+    spotlightBuffer: getBuffer(),
+    contentType,
+    userAgent: ctx.req.header("User-Agent")
+  });
+  if (container) {
+    logIncomingEvent(container);
+  } else {
+    logger.warn("No content type, skipping payload...");
+  }
+  const incomingPayload = ctx.get("incomingPayload");
+  if (process.env.SPOTLIGHT_CAPTURE || incomingPayload) {
+    const contentType2 = container?.getContentType();
+    const timestamp = BigInt(Date.now()) * 1000000n + process.hrtime.bigint() % 1000000n;
+    const filename = `${contentType2?.replace(/[^a-z0-9]/gi, "_") || "no_content_type"}-${timestamp}.txt`;
+    if (incomingPayload) {
+      incomingPayload(body.toString("binary"));
+    } else {
+      const stream = createWriteStream(filename);
+      stream.on("error", (err) => {
+        logger.error(`Failed to save data to ${filename}: ${err}`);
+        stream.destroy();
+      });
+      stream.end(body, () => {
+        logger.info(`🗃️ Saved data to ${filename}`);
+      });
+    }
+  }
+  return ctx.body(null, 200, {
+    "Cache-Control": "no-cache",
+    Connection: "keep-alive"
+  });
+});
+export {
+  router as default
+};
+//# sourceMappingURL=index.js.map

package/dist/server/routes/stream/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../src/server/routes/stream/index.ts"],"sourcesContent":["import { createWriteStream } from \"node:fs\";\nimport { decompressBody, pushToSpotlightBuffer } from \"@spotlight/server/sdk.ts\";\nimport { SENTRY_CONTENT_TYPE } from \"@spotlight/shared/constants.ts\";\nimport { Hono } from \"hono\";\nimport { logger } from \"../../logger.ts\";\nimport type { HonoEnv } from \"../../types/env.ts\";\nimport { getBuffer } from \"../../utils/index.ts\";\nimport { logIncomingEvent, logOutgoingEvent } from \"./debugLogging.ts\";\nimport { streamSSE } from \"./streaming.ts\";\nimport { parseBrowserFromUserAgent } from \"./userAgent.ts\";\n\nconst router = new Hono<HonoEnv>()\n  .get(\"/stream\", ctx => {\n    const buffer = getBuffer();\n\n    const useBase64 = ctx.req.query(\"base64\") != null;\n    const base64Indicator = useBase64 ? \";base64\" : \"\";\n\n    // Capture client information for debug logging\n    let clientId = ctx.req.query(\"client\");\n    if (!clientId) {\n      // Fallback to parsing User-Agent if no client param\n      const userAgent = ctx.req.header(\"User-Agent\") || \"unknown\";\n      clientId = parseBrowserFromUserAgent(userAgent);\n    }\n    // Sanitize to prevent log injection - keep only safe printable characters\n    // Allow alphanumeric, spaces, dots, dashes, underscores, slashes, parentheses\n    clientId = clientId.replace(/[^\\w\\s.\\-/()]/g, \"\");\n    // Ensure we always have a non-empty clientId\n    if (!clientId) clientId = \"unknown\";\n\n    return streamSSE(ctx, async stream => {\n      // Check for Last-Event-ID header to support reconnection\n      const lastEventId = ctx.req.header(\"Last-Event-ID\");\n\n      // Subscribe to events, optionally starting from after the lastEventId\n      const sub = buffer.subscribe(container => {\n        logOutgoingEvent(container, clientId);\n\n        const parsedEnvelope = container.getParsedEnvelope();\n        if (parsedEnvelope) {\n          stream.writeSSE({\n            id: parsedEnvelope.envelope[0].__spotlight_envelope_id.toString(),\n            event: `${container.getContentType()}${base64Indicator}`,\n            data: JSON.stringify(parsedEnvelope.envelope),\n          });\n        }\n      }, lastEventId);\n\n      stream.onAbort(() => {\n        buffer.unsubscribe(sub);\n      });\n    });\n  })\n  .get(\"/envelope/:id\", ctx => {\n    const buffer = getBuffer();\n\n    const envelopeId = ctx.req.param(\"id\");\n    const container = buffer.read({ envelopeId });\n\n    if (container.length === 0) {\n      return ctx.notFound();\n    }\n\n    return ctx.body(new Uint8Array(container[0].getData()), 200, {\n      \"Content-Type\": container[0].getContentType(),\n      \"Cache-Control\": \"no-cache\",\n      \"Content-Disposition\": `attachment; filename=\"${envelopeId}.bin\"`,\n      Connection: \"keep-alive\",\n    });\n  })\n  .on(\"POST\", [\"/stream\", \"/api/:id/envelope\"], async ctx => {\n    let contentType = ctx.req.header(\"content-type\")?.split(\";\")[0].toLocaleLowerCase();\n    if (ctx.req.query(\"sentry_client\")?.startsWith(\"sentry.javascript.browser\") && ctx.req.header(\"Origin\")) {\n      // This is a correction we make as Sentry Browser SDK may send messages with text/plain to avoid CORS issues\n      contentType = SENTRY_CONTENT_TYPE;\n    }\n\n    // manually decompress body to use it below without another decompression\n    const body = decompressBody(Buffer.from(await ctx.req.arrayBuffer()), ctx.req.header(\"Content-Encoding\"));\n\n    const container = pushToSpotlightBuffer({\n      body,\n      spotlightBuffer: getBuffer(),\n      contentType,\n      userAgent: ctx.req.header(\"User-Agent\"),\n    });\n\n    if (container) {\n      // Log incoming event details when debug is enabled\n      logIncomingEvent(container);\n    } else {\n      logger.warn(\"No content type, skipping payload...\");\n    }\n\n    const incomingPayload = ctx.get(\"incomingPayload\");\n\n    if (process.env.SPOTLIGHT_CAPTURE || incomingPayload) {\n      const contentType = container?.getContentType();\n      const timestamp = BigInt(Date.now()) * 1_000_000n + (process.hrtime.bigint() % 1_000_000n);\n      const filename = `${contentType?.replace(/[^a-z0-9]/gi, \"_\") || \"no_content_type\"}-${timestamp}.txt`;\n\n      if (incomingPayload) {\n        incomingPayload(body.toString(\"binary\"));\n      } else {\n        const stream = createWriteStream(filename);\n        stream.on(\"error\", err => {\n          logger.error(`Failed to save data to ${filename}: ${err}`);\n          stream.destroy();\n        });\n        stream.end(body, () => {\n          logger.info(`🗃️ Saved data to ${filename}`);\n        });\n      }\n    }\n\n    // 204 would be more appropriate but returning 200 to match what /envelope returns\n    return ctx.body(null, 200, {\n      \"Cache-Control\": \"no-cache\",\n      Connection: \"keep-alive\",\n    });\n  });\n\nexport default router;\n"],"names":["contentType"],"mappings":"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"}

package/dist/server/routes/stream/streaming.d.ts

@@ -0,0 +1,3 @@
+import { Context } from 'hono';
+import { SSEStreamingApi } from 'hono/streaming';
+export declare const streamSSE: (c: Context, cb: (stream: SSEStreamingApi) => Promise<void>, onError?: (e: Error, stream: SSEStreamingApi) => Promise<void>) => Response;

package/dist/server/routes/stream/streaming.js

@@ -0,0 +1,26 @@
+import { captureException } from "@sentry/node";
+import { SSEStreamingApi } from "../../../node_modules/.pnpm/hono@4.10.3/node_modules/hono/dist/helper/streaming/sse.js";
+const run = async (stream, cb, onError) => {
+  try {
+    await cb(stream);
+  } catch (e) {
+    {
+      captureException(e, { extra: { context: "Unhandled error in SSE stream" } });
+    }
+  }
+};
+const streamSSE = (c, cb, onError) => {
+  const { readable, writable } = new TransformStream();
+  const stream = new SSEStreamingApi(writable, readable);
+  c.header("Transfer-Encoding", "chunked");
+  c.header("Content-Type", "text/event-stream");
+  c.header("Cache-Control", "no-cache");
+  c.header("Connection", "keep-alive");
+  stream.writeln("");
+  run(stream, cb);
+  return c.newResponse(stream.responseReadable);
+};
+export {
+  streamSSE
+};
+//# sourceMappingURL=streaming.js.map

package/dist/server/routes/stream/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sources":["../../../../src/server/routes/stream/streaming.ts"],"sourcesContent":["import { captureException } from \"@sentry/node\";\nimport type { Context } from \"hono\";\nimport { SSEStreamingApi } from \"hono/streaming\";\n\nconst run = async (\n  stream: SSEStreamingApi,\n  cb: (stream: SSEStreamingApi) => Promise<void>,\n  onError?: (e: Error, stream: SSEStreamingApi) => Promise<void>,\n): Promise<void> => {\n  try {\n    await cb(stream);\n  } catch (e) {\n    if (e instanceof Error && onError) {\n      await onError(e, stream);\n\n      await stream.writeSSE({\n        event: \"error\",\n        data: e.message,\n      });\n    } else {\n      captureException(e, { extra: { context: \"Unhandled error in SSE stream\" } });\n    }\n  }\n};\n\nexport const streamSSE = (\n  c: Context,\n  cb: (stream: SSEStreamingApi) => Promise<void>,\n  onError?: (e: Error, stream: SSEStreamingApi) => Promise<void>,\n): Response => {\n  const { readable, writable } = new TransformStream();\n  const stream = new SSEStreamingApi(writable, readable);\n\n  c.header(\"Transfer-Encoding\", \"chunked\");\n  c.header(\"Content-Type\", \"text/event-stream\");\n  c.header(\"Cache-Control\", \"no-cache\");\n  c.header(\"Connection\", \"keep-alive\");\n\n  // Send something in the body to trigger the `open` event\n  // This is mostly for Firefox -- see #376\n  stream.writeln(\"\");\n\n  run(stream, cb, onError);\n\n  return c.newResponse(stream.responseReadable);\n};\n"],"names":[],"mappings":";;AAIA,MAAM,MAAM,OACV,QACA,IACA,YACkB;AAClB,MAAI;AACF,UAAM,GAAG,MAAM;AAAA,EACjB,SAAS,GAAG;AAQH;AACL,uBAAiB,GAAG,EAAE,OAAO,EAAE,SAAS,gCAAA,GAAmC;AAAA,IAC7E;AAAA,EACF;AACF;AAEO,MAAM,YAAY,CACvB,GACA,IACA,YACa;AACb,QAAM,EAAE,UAAU,SAAA,IAAa,IAAI,gBAAA;AACnC,QAAM,SAAS,IAAI,gBAAgB,UAAU,QAAQ;AAErD,IAAE,OAAO,qBAAqB,SAAS;AACvC,IAAE,OAAO,gBAAgB,mBAAmB;AAC5C,IAAE,OAAO,iBAAiB,UAAU;AACpC,IAAE,OAAO,cAAc,YAAY;AAInC,SAAO,QAAQ,EAAE;AAEjB,MAAI,QAAQ,EAAW;AAEvB,SAAO,EAAE,YAAY,OAAO,gBAAgB;AAC9C;"}

package/dist/server/routes/stream/userAgent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Extracts browser name and major version from a User-Agent string
+ * Returns format like "Chrome/131" or "Firefox/122"
+ */
+export declare function parseBrowserFromUserAgent(userAgent: string): string;
+/**
+ * Builds a client identifier from browser info and optional hostname
+ * Format: clientName/version (metadata)
+ * Example: "ui/Chrome/131 (example.com)"
+ */
+export declare function buildClientIdentifier(clientName: string, userAgent?: string, hostname?: string): string;

package/dist/server/routes/stream/userAgent.js

@@ -0,0 +1,25 @@
+function parseBrowserFromUserAgent(userAgent) {
+  if (!userAgent) return "unknown";
+  if (userAgent.includes("Chrome/") && !userAgent.includes("Edg/")) {
+    const match2 = userAgent.match(/Chrome\/([\d]+)/);
+    return match2 ? `Chrome/${match2[1]}` : "Chrome";
+  }
+  if (userAgent.includes("Firefox/")) {
+    const match2 = userAgent.match(/Firefox\/([\d]+)/);
+    return match2 ? `Firefox/${match2[1]}` : "Firefox";
+  }
+  if (userAgent.includes("Safari/") && !userAgent.includes("Chrome")) {
+    const match2 = userAgent.match(/Version\/([\d]+)/);
+    return match2 ? `Safari/${match2[1]}` : "Safari";
+  }
+  if (userAgent.includes("Edg/")) {
+    const match2 = userAgent.match(/Edg\/([\d]+)/);
+    return match2 ? `Edge/${match2[1]}` : "Edge";
+  }
+  const match = userAgent.match(/^([^\/\s\(]+)/);
+  return match ? match[1] : "unknown";
+}
+export {
+  parseBrowserFromUserAgent
+};
+//# sourceMappingURL=userAgent.js.map

package/dist/server/routes/stream/userAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userAgent.js","sources":["../../../../src/server/routes/stream/userAgent.ts"],"sourcesContent":["/**\n * Extracts browser name and major version from a User-Agent string\n * Returns format like \"Chrome/131\" or \"Firefox/122\"\n */\nexport function parseBrowserFromUserAgent(userAgent: string): string {\n  if (!userAgent) return \"unknown\";\n\n  // Check for Chrome (but not Edge which also contains Chrome)\n  if (userAgent.includes(\"Chrome/\") && !userAgent.includes(\"Edg/\")) {\n    const match = userAgent.match(/Chrome\\/([\\d]+)/);\n    return match ? `Chrome/${match[1]}` : \"Chrome\";\n  }\n\n  // Check for Firefox\n  if (userAgent.includes(\"Firefox/\")) {\n    const match = userAgent.match(/Firefox\\/([\\d]+)/);\n    return match ? `Firefox/${match[1]}` : \"Firefox\";\n  }\n\n  // Check for Safari (but not Chrome which also contains Safari)\n  if (userAgent.includes(\"Safari/\") && !userAgent.includes(\"Chrome\")) {\n    const match = userAgent.match(/Version\\/([\\d]+)/);\n    return match ? `Safari/${match[1]}` : \"Safari\";\n  }\n\n  // Check for Edge\n  if (userAgent.includes(\"Edg/\")) {\n    const match = userAgent.match(/Edg\\/([\\d]+)/);\n    return match ? `Edge/${match[1]}` : \"Edge\";\n  }\n\n  // Generic fallback - try to extract first meaningful part\n  const match = userAgent.match(/^([^\\/\\s\\(]+)/);\n  return match ? match[1] : \"unknown\";\n}\n\n/**\n * Builds a client identifier from browser info and optional hostname\n * Format: clientName/version (metadata)\n * Example: \"ui/Chrome/131 (example.com)\"\n */\nexport function buildClientIdentifier(clientName: string, userAgent?: string, hostname?: string): string {\n  let clientId = clientName;\n\n  if (userAgent) {\n    const browserInfo = parseBrowserFromUserAgent(userAgent);\n    if (browserInfo !== \"unknown\") {\n      clientId = `${clientName}/${browserInfo}`;\n    }\n  }\n\n  if (hostname && hostname !== \"localhost\") {\n    clientId += ` (${hostname})`;\n  }\n\n  return clientId;\n}\n"],"names":["match"],"mappings":"AAIO,SAAS,0BAA0B,WAA2B;AACnE,MAAI,CAAC,UAAW,QAAO;AAGvB,MAAI,UAAU,SAAS,SAAS,KAAK,CAAC,UAAU,SAAS,MAAM,GAAG;AAChE,UAAMA,SAAQ,UAAU,MAAM,iBAAiB;AAC/C,WAAOA,SAAQ,UAAUA,OAAM,CAAC,CAAC,KAAK;AAAA,EACxC;AAGA,MAAI,UAAU,SAAS,UAAU,GAAG;AAClC,UAAMA,SAAQ,UAAU,MAAM,kBAAkB;AAChD,WAAOA,SAAQ,WAAWA,OAAM,CAAC,CAAC,KAAK;AAAA,EACzC;AAGA,MAAI,UAAU,SAAS,SAAS,KAAK,CAAC,UAAU,SAAS,QAAQ,GAAG;AAClE,UAAMA,SAAQ,UAAU,MAAM,kBAAkB;AAChD,WAAOA,SAAQ,UAAUA,OAAM,CAAC,CAAC,KAAK;AAAA,EACxC;AAGA,MAAI,UAAU,SAAS,MAAM,GAAG;AAC9B,UAAMA,SAAQ,UAAU,MAAM,cAAc;AAC5C,WAAOA,SAAQ,QAAQA,OAAM,CAAC,CAAC,KAAK;AAAA,EACtC;AAGA,QAAM,QAAQ,UAAU,MAAM,eAAe;AAC7C,SAAO,QAAQ,MAAM,CAAC,IAAI;AAC5B;"}

package/dist/server/sdk.d.ts

@@ -0,0 +1,15 @@
+import { MessageBuffer } from './messageBuffer.ts';
+import { EventContainer } from './utils/eventContainer.ts';
+declare const decompressors: Record<"gzip" | "deflate" | "br", (buf: Buffer) => Buffer>;
+type ContentEncoding = keyof typeof decompressors;
+export declare function createSpotlightBuffer(): MessageBuffer<EventContainer>;
+type PushToSpotlightBufferOptions = {
+    spotlightBuffer: MessageBuffer<EventContainer>;
+    body: Buffer;
+    encoding?: ContentEncoding;
+    contentType?: string;
+    userAgent?: string;
+};
+export declare function pushToSpotlightBuffer(options: PushToSpotlightBufferOptions): EventContainer | undefined;
+export declare function decompressBody(body: Buffer, contentEncoding?: ContentEncoding): Buffer<ArrayBufferLike>;
+export {};

package/dist/server/sdk.js

@@ -0,0 +1,32 @@
+import { brotliDecompressSync, inflateSync, gunzipSync } from "node:zlib";
+import { MessageBuffer } from "./messageBuffer.js";
+import { EventContainer } from "./utils/eventContainer.js";
+const decompressors = {
+  gzip: gunzipSync,
+  deflate: inflateSync,
+  br: brotliDecompressSync
+};
+function createSpotlightBuffer() {
+  return new MessageBuffer();
+}
+function pushToSpotlightBuffer(options) {
+  const body = decompressBody(options.body, options.encoding);
+  const contentType = options.contentType?.split(";")[0].toLocaleLowerCase();
+  if (contentType) {
+    const container = new EventContainer(contentType, body, options.userAgent);
+    options.spotlightBuffer.put(container);
+    return container;
+  }
+}
+function decompressBody(body, contentEncoding) {
+  if (!contentEncoding) {
+    return body;
+  }
+  return decompressors[contentEncoding](body);
+}
+export {
+  createSpotlightBuffer,
+  decompressBody,
+  pushToSpotlightBuffer
+};
+//# sourceMappingURL=sdk.js.map

package/dist/server/sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.js","sources":["../../src/server/sdk.ts"],"sourcesContent":["import { brotliDecompressSync, gunzipSync, inflateSync } from \"node:zlib\";\nimport { MessageBuffer } from \"./messageBuffer.ts\";\nimport { EventContainer } from \"./utils/eventContainer.ts\";\n\nconst decompressors: Record<\"gzip\" | \"deflate\" | \"br\", (buf: Buffer) => Buffer> = {\n  gzip: gunzipSync,\n  deflate: inflateSync,\n  br: brotliDecompressSync,\n};\ntype ContentEncoding = keyof typeof decompressors;\n\nexport function createSpotlightBuffer() {\n  return new MessageBuffer<EventContainer>();\n}\n\ntype PushToSpotlightBufferOptions = {\n  spotlightBuffer: MessageBuffer<EventContainer>;\n  body: Buffer;\n  encoding?: ContentEncoding;\n  contentType?: string;\n  userAgent?: string;\n};\n\nexport function pushToSpotlightBuffer(options: PushToSpotlightBufferOptions) {\n  const body = decompressBody(options.body, options.encoding);\n\n  const contentType = options.contentType?.split(\";\")[0].toLocaleLowerCase();\n\n  if (contentType) {\n    // Create event container and add to buffer\n    const container = new EventContainer(contentType, body, options.userAgent);\n\n    // Add to buffer - this will automatically trigger all subscribers\n    // including the onEnvelope callback if one is registered\n    options.spotlightBuffer.put(container);\n\n    return container;\n  }\n}\n\nexport function decompressBody(body: Buffer, contentEncoding?: ContentEncoding) {\n  if (!contentEncoding) {\n    return body;\n  }\n  return decompressors[contentEncoding](body);\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,gBAA4E;AAAA,EAChF,MAAM;AAAA,EACN,SAAS;AAAA,EACT,IAAI;AACN;AAGO,SAAS,wBAAwB;AACtC,SAAO,IAAI,cAAA;AACb;AAUO,SAAS,sBAAsB,SAAuC;AAC3E,QAAM,OAAO,eAAe,QAAQ,MAAM,QAAQ,QAAQ;AAE1D,QAAM,cAAc,QAAQ,aAAa,MAAM,GAAG,EAAE,CAAC,EAAE,kBAAA;AAEvD,MAAI,aAAa;AAEf,UAAM,YAAY,IAAI,eAAe,aAAa,MAAM,QAAQ,SAAS;AAIzE,YAAQ,gBAAgB,IAAI,SAAS;AAErC,WAAO;AAAA,EACT;AACF;AAEO,SAAS,eAAe,MAAc,iBAAmC;AAC9E,MAAI,CAAC,iBAAiB;AACpB,WAAO;AAAA,EACT;AACA,SAAO,cAAc,eAAe,EAAE,IAAI;AAC5C;"}

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

@@ -0,0 +1,14 @@
+import { FormatterType } from '../formatters/types.ts';
+import { SideCarOptions } from './utils.ts';
+export type CLIHandlerOptions = {
+    cmd?: string;
+    cmdArgs: string[];
+    port: SideCarOptions["port"];
+    help?: boolean;
+    debug?: boolean;
+    format?: FormatterType;
+    basePath?: SideCarOptions["basePath"];
+    filesToServe?: SideCarOptions["filesToServe"];
+};
+export type CLIHandlerReturnType = Promise<any> | any;
+export type CLIHandler = ((options: CLIHandlerOptions) => CLIHandlerReturnType) | (() => CLIHandlerReturnType);

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

@@ -0,0 +1,10 @@
+import { HttpBindings } from '@hono/node-server';
+import { IncomingPayloadCallback } from './utils.ts';
+export type HonoEnv = {
+    Bindings: HttpBindings;
+    Variables: {
+        contextId: string;
+        basePath?: string;
+        incomingPayload?: IncomingPayloadCallback;
+    };
+};

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

@@ -0,0 +1,2 @@
+export * from './env.ts';
+export * from './utils.ts';

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

@@ -0,0 +1,44 @@
+import { ParsedEnvelope } from '../parser/processEnvelope.ts';
+export type IncomingPayloadCallback = (body: string) => void;
+export type OnEnvelopeCallback = (envelope: ParsedEnvelope["envelope"]) => void;
+export type SidecarLogger = {
+    info: (message: any) => void;
+    warn: (message: any) => void;
+    error: (message: any) => void;
+    debug: (message: any) => void;
+};
+export type SideCarOptions = {
+    /**
+     * The port on which the sidecar should listen.
+     * Defaults to 8969.
+     */
+    port: number;
+    /**
+     * A logger that implements the SidecarLogger interface.
+     * Use this to inject your custom logger implementation.
+     *
+     * @default - a simple logger logging to the console.
+     */
+    logger?: SidecarLogger;
+    /**
+     * The base path from where the static files should be served.
+     */
+    basePath?: string;
+    filesToServe?: Record<string, Buffer>;
+    /**
+     * A callback that will be called with the incoming message.
+     * Helpful for debugging.
+     */
+    incomingPayload?: IncomingPayloadCallback;
+    /**
+     * A callback that will be called with the parsed envelope every
+     * time an envelope is received. This will me mainly used for the
+     * CLI for streaming data but can be used by other tools as well.
+     */
+    onEnvelope?: OnEnvelopeCallback;
+    isStandalone?: boolean;
+    stdioMCP?: boolean;
+};
+export type StartServerOptions = Pick<SideCarOptions, "basePath" | "filesToServe" | "incomingPayload"> & {
+    port: number;
+};

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

@@ -0,0 +1,12 @@
+/**
+ * Validates if an origin should be allowed to access the Sidecar.
+ *
+ * Allowed origins:
+ * - localhost with any port or protocol (http/https)
+ * - https://spotlightjs.com (HTTPS only, default port)
+ * - https://*.spotlightjs.com (HTTPS only, default port)
+ *
+ * @param origin - The origin to validate
+ * @returns true if the origin is allowed, false otherwise
+ */
+export declare function isAllowedOrigin(origin: string): boolean;

package/dist/server/utils/cors.js

@@ -0,0 +1,22 @@
+function isAllowedOrigin(origin) {
+  if (!origin) {
+    return false;
+  }
+  try {
+    const url = new URL(origin);
+    const hostname = url.hostname.toLowerCase();
+    if (hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]" || hostname === "::1") {
+      return true;
+    }
+    if (url.protocol !== "https:" || url.port !== "" && url.port !== "443") {
+      return false;
+    }
+    return hostname === "spotlightjs.com" || hostname.endsWith(".spotlightjs.com");
+  } catch {
+    return false;
+  }
+}
+export {
+  isAllowedOrigin
+};
+//# sourceMappingURL=cors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cors.js","sources":["../../../src/server/utils/cors.ts"],"sourcesContent":["/**\n * Validates if an origin should be allowed to access the Sidecar.\n *\n * Allowed origins:\n * - localhost with any port or protocol (http/https)\n * - https://spotlightjs.com (HTTPS only, default port)\n * - https://*.spotlightjs.com (HTTPS only, default port)\n *\n * @param origin - The origin to validate\n * @returns true if the origin is allowed, false otherwise\n */\nexport function isAllowedOrigin(origin: string): boolean {\n  if (!origin) {\n    return false;\n  }\n\n  try {\n    const url = new URL(origin);\n    const hostname = url.hostname.toLowerCase();\n\n    // Allow localhost with any port and protocol (http or https)\n    // Check both [::1] and ::1 formats for IPv6 localhost compatibility\n    if (hostname === \"localhost\" || hostname === \"127.0.0.1\" || hostname === \"[::1]\" || hostname === \"::1\") {\n      return true;\n    }\n\n    // Check for spotlightjs.com domains - must be HTTPS with default port\n    if (url.protocol !== \"https:\" || (url.port !== \"\" && url.port !== \"443\")) {\n      return false;\n    }\n\n    return hostname === \"spotlightjs.com\" || hostname.endsWith(\".spotlightjs.com\");\n  } catch {\n    // Invalid URL\n    return false;\n  }\n}\n"],"names":[],"mappings":"AAWO,SAAS,gBAAgB,QAAyB;AACvD,MAAI,CAAC,QAAQ;AACX,WAAO;AAAA,EACT;AAEA,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,MAAM;AAC1B,UAAM,WAAW,IAAI,SAAS,YAAA;AAI9B,QAAI,aAAa,eAAe,aAAa,eAAe,aAAa,WAAW,aAAa,OAAO;AACtG,aAAO;AAAA,IACT;AAGA,QAAI,IAAI,aAAa,YAAa,IAAI,SAAS,MAAM,IAAI,SAAS,OAAQ;AACxE,aAAO;AAAA,IACT;AAEA,WAAO,aAAa,qBAAqB,SAAS,SAAS,kBAAkB;AAAA,EAC/E,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;"}

package/dist/server/utils/docker-compose-parser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get compose files from COMPOSE_FILE environment variable
+ * Returns an array of file paths if the variable is set, null otherwise
+ */
+export declare function getComposeFilesFromEnv(): string[] | null;
+/**
+ * Find the compose file in the current directory by trying all combinations
+ * of base names and extensions.
+ */
+export declare function findComposeFile(): string | null;
+/**
+ * Find the override file for a given compose file.
+ * Docker Compose looks for an override file with the same base name and extension.
+ * For example: docker-compose.yml -> docker-compose.override.yml
+ */
+export declare function findOverrideFile(composeFile: string): string | null;
+/**
+ * Parse compose file and extract service names
+ */
+export declare function getDockerComposeServices(filePath: string): string[];

package/dist/server/utils/docker-compose-parser.js

@@ -0,0 +1,61 @@
+import { accessSync, constants, readFileSync } from "node:fs";
+import { delimiter } from "node:path";
+import { parse } from "yaml";
+import { logger } from "../logger.js";
+const COMPOSE_FILE_BASE_NAMES = ["docker-compose", "compose"];
+const COMPOSE_FILE_EXTENSIONS = [".yml", ".yaml"];
+function getComposeFilesFromEnv() {
+  const composeFileEnv = process.env.COMPOSE_FILE;
+  if (!composeFileEnv) {
+    return null;
+  }
+  const files = composeFileEnv.split(delimiter).map((f) => f.trim()).filter(Boolean);
+  return files.length > 0 ? files : null;
+}
+function findComposeFile() {
+  for (const baseName of COMPOSE_FILE_BASE_NAMES) {
+    for (const ext of COMPOSE_FILE_EXTENSIONS) {
+      const fileName = `${baseName}${ext}`;
+      try {
+        accessSync(fileName, constants.R_OK);
+        return fileName;
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function findOverrideFile(composeFile) {
+  const ext = composeFile.endsWith(".yaml") ? ".yaml" : ".yml";
+  const baseName = composeFile.replace(/\.(yaml|yml)$/, "");
+  const overrideFile = `${baseName}.override${ext}`;
+  try {
+    accessSync(overrideFile, constants.R_OK);
+    return overrideFile;
+  } catch {
+    return null;
+  }
+}
+function getDockerComposeServices(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    const parsed = parse(content);
+    if (!parsed || typeof parsed !== "object" || !("services" in parsed)) {
+      logger.error(`Invalid compose file: ${filePath} - missing 'services' key`);
+      return [];
+    }
+    const services = parsed.services;
+    return Object.keys(services);
+  } catch (error) {
+    logger.error(`Failed to parse compose file: ${filePath}`);
+    logger.error(error);
+    return [];
+  }
+}
+export {
+  findComposeFile,
+  findOverrideFile,
+  getComposeFilesFromEnv,
+  getDockerComposeServices
+};
+//# sourceMappingURL=docker-compose-parser.js.map

package/dist/server/utils/docker-compose-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-compose-parser.js","sources":["../../../src/server/utils/docker-compose-parser.ts"],"sourcesContent":["import { constants, accessSync, readFileSync } from \"node:fs\";\nimport { delimiter } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { logger } from \"../logger.ts\";\n\nconst COMPOSE_FILE_BASE_NAMES = [\"docker-compose\", \"compose\"] as const;\nconst COMPOSE_FILE_EXTENSIONS = [\".yml\", \".yaml\"] as const;\n\n/**\n * Get compose files from COMPOSE_FILE environment variable\n * Returns an array of file paths if the variable is set, null otherwise\n */\nexport function getComposeFilesFromEnv(): string[] | null {\n  const composeFileEnv = process.env.COMPOSE_FILE;\n  if (!composeFileEnv) {\n    return null;\n  }\n\n  // Split by platform-specific path delimiter (: on Unix, ; on Windows)\n  const files = composeFileEnv\n    .split(delimiter)\n    .map(f => f.trim())\n    .filter(Boolean);\n\n  return files.length > 0 ? files : null;\n}\n\n/**\n * Find the compose file in the current directory by trying all combinations\n * of base names and extensions.\n */\nexport function findComposeFile(): string | null {\n  for (const baseName of COMPOSE_FILE_BASE_NAMES) {\n    for (const ext of COMPOSE_FILE_EXTENSIONS) {\n      const fileName = `${baseName}${ext}`;\n      try {\n        accessSync(fileName, constants.R_OK);\n        return fileName;\n      } catch {\n        // File doesn't exist or isn't readable, continue searching\n      }\n    }\n  }\n  return null;\n}\n\n/**\n * Find the override file for a given compose file.\n * Docker Compose looks for an override file with the same base name and extension.\n * For example: docker-compose.yml -> docker-compose.override.yml\n */\nexport function findOverrideFile(composeFile: string): string | null {\n  // Extract extension from the original file to maintain consistency\n  const ext = composeFile.endsWith(\".yaml\") ? \".yaml\" : \".yml\";\n  const baseName = composeFile.replace(/\\.(yaml|yml)$/, \"\");\n  const overrideFile = `${baseName}.override${ext}`;\n\n  try {\n    accessSync(overrideFile, constants.R_OK);\n    return overrideFile;\n  } catch {\n    // File doesn't exist or isn't readable\n    return null;\n  }\n}\n\n/**\n * Parse compose file and extract service names\n */\nexport function getDockerComposeServices(filePath: string): string[] {\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    const parsed = parseYaml(content);\n\n    if (!parsed || typeof parsed !== \"object\" || !(\"services\" in parsed)) {\n      logger.error(`Invalid compose file: ${filePath} - missing 'services' key`);\n      return [];\n    }\n\n    const services = parsed.services as Record<string, unknown>;\n    return Object.keys(services);\n  } catch (error) {\n    logger.error(`Failed to parse compose file: ${filePath}`);\n    logger.error(error);\n    return [];\n  }\n}\n"],"names":["parseYaml"],"mappings":";;;;AAKA,MAAM,0BAA0B,CAAC,kBAAkB,SAAS;AAC5D,MAAM,0BAA0B,CAAC,QAAQ,OAAO;AAMzC,SAAS,yBAA0C;AACxD,QAAM,iBAAiB,QAAQ,IAAI;AACnC,MAAI,CAAC,gBAAgB;AACnB,WAAO;AAAA,EACT;AAGA,QAAM,QAAQ,eACX,MAAM,SAAS,EACf,IAAI,CAAA,MAAK,EAAE,KAAA,CAAM,EACjB,OAAO,OAAO;AAEjB,SAAO,MAAM,SAAS,IAAI,QAAQ;AACpC;AAMO,SAAS,kBAAiC;AAC/C,aAAW,YAAY,yBAAyB;AAC9C,eAAW,OAAO,yBAAyB;AACzC,YAAM,WAAW,GAAG,QAAQ,GAAG,GAAG;AAClC,UAAI;AACF,mBAAW,UAAU,UAAU,IAAI;AACnC,eAAO;AAAA,MACT,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,iBAAiB,aAAoC;AAEnE,QAAM,MAAM,YAAY,SAAS,OAAO,IAAI,UAAU;AACtD,QAAM,WAAW,YAAY,QAAQ,iBAAiB,EAAE;AACxD,QAAM,eAAe,GAAG,QAAQ,YAAY,GAAG;AAE/C,MAAI;AACF,eAAW,cAAc,UAAU,IAAI;AACvC,WAAO;AAAA,EACT,QAAQ;AAEN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,yBAAyB,UAA4B;AACnE,MAAI;AACF,UAAM,UAAU,aAAa,UAAU,OAAO;AAC9C,UAAM,SAASA,MAAU,OAAO;AAEhC,QAAI,CAAC,UAAU,OAAO,WAAW,YAAY,EAAE,cAAc,SAAS;AACpE,aAAO,MAAM,yBAAyB,QAAQ,2BAA2B;AACzE,aAAO,CAAA;AAAA,IACT;AAEA,UAAM,WAAW,OAAO;AACxB,WAAO,OAAO,KAAK,QAAQ;AAAA,EAC7B,SAAS,OAAO;AACd,WAAO,MAAM,iCAAiC,QAAQ,EAAE;AACxD,WAAO,MAAM,KAAK;AAClB,WAAO,CAAA;AAAA,EACT;AACF;"}

package/dist/server/utils/docker-compose.d.ts

@@ -0,0 +1,30 @@
+export declare const DOCKER_MIN_VERSION = "20.10.0";
+export declare const DOCKER_HOST_INTERNAL = "host.docker.internal";
+export declare const DOCKER_HOST_GATEWAY = "host-gateway";
+interface DockerComposeConfig {
+    composeFiles: string[];
+    command: string[];
+    serviceNames: string[];
+}
+/**
+ * Detect if Docker is installed and check its version
+ */
+export declare function detectDocker(): {
+    version: string;
+    valid: boolean;
+} | null;
+/**
+ * Build the Docker Compose command with Spotlight environment injection
+ */
+export declare function buildDockerComposeCommand(config: DockerComposeConfig): {
+    cmdArgs: string[];
+    stdin: string;
+};
+/**
+ * Detect and configure Docker Compose
+ *
+ * This function orchestrates the detection of Docker, Docker Compose,
+ * compose files, and services to build a complete configuration.
+ */
+export declare function detectDockerCompose(): DockerComposeConfig | null;
+export {};

package/dist/server/utils/docker-compose.js

@@ -0,0 +1,131 @@
+import { execSync } from "node:child_process";
+import semver from "../../node_modules/.pnpm/semver@7.7.3/node_modules/semver/index.js";
+import { stringify } from "yaml";
+import { logger } from "../logger.js";
+import { getComposeFilesFromEnv, findComposeFile, findOverrideFile, getDockerComposeServices } from "./docker-compose-parser.js";
+const DOCKER_MIN_VERSION = "20.10.0";
+const DOCKER_HOST_INTERNAL = "host.docker.internal";
+const DOCKER_HOST_GATEWAY = "host-gateway";
+function tryExec(command) {
+  try {
+    return execSync(command, { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+  } catch {
+    return null;
+  }
+}
+function detectDocker() {
+  const version = tryExec("docker --version");
+  if (!version) {
+    return null;
+  }
+  const match = version.match(/Docker version ([\d.]+)/);
+  if (!match) {
+    return null;
+  }
+  const versionNumber = match[1];
+  const valid = semver.gte(versionNumber, DOCKER_MIN_VERSION);
+  return { version: versionNumber, valid };
+}
+function detectComposeCommand() {
+  const composePluginVersion = tryExec("docker compose version --short");
+  const composeStandaloneVersion = tryExec("docker-compose version --short");
+  if (!composePluginVersion && !composeStandaloneVersion) {
+    return null;
+  }
+  if (!composePluginVersion) {
+    return { command: ["docker-compose"], version: composeStandaloneVersion };
+  }
+  if (!composeStandaloneVersion) {
+    return { command: ["docker", "compose"], version: composePluginVersion };
+  }
+  const pluginVer = composePluginVersion.replace(/^v/, "");
+  const standaloneVer = composeStandaloneVersion.replace(/^v/, "");
+  if (semver.gt(standaloneVer, pluginVer)) {
+    return { command: ["docker-compose"], version: composeStandaloneVersion };
+  }
+  return { command: ["docker", "compose"], version: composePluginVersion };
+}
+function generateSpotlightOverrideYaml(serviceNames) {
+  const services = {};
+  for (const serviceName of serviceNames) {
+    services[serviceName] = {
+      environment: ["SENTRY_SPOTLIGHT", "NEXT_PUBLIC_SENTRY_SPOTLIGHT", "SENTRY_TRACES_SAMPLE_RATE"],
+      extra_hosts: [`${DOCKER_HOST_INTERNAL}:${DOCKER_HOST_GATEWAY}`]
+    };
+  }
+  return stringify({ services });
+}
+function buildDockerComposeCommand(config) {
+  const cmdArgs = [...config.command];
+  for (const file of config.composeFiles) {
+    cmdArgs.push("-f", file);
+  }
+  cmdArgs.push("-f", "-");
+  cmdArgs.push("up");
+  const stdin = generateSpotlightOverrideYaml(config.serviceNames);
+  return { cmdArgs, stdin };
+}
+function detectDockerCompose() {
+  const docker = detectDocker();
+  if (!docker) {
+    logger.debug("Docker is not installed or not in PATH");
+    return null;
+  }
+  if (!docker.valid) {
+    logger.error(`Docker version ${docker.version} does not meet the minimum required version ${DOCKER_MIN_VERSION}`);
+    return null;
+  }
+  logger.debug(`Detected Docker version ${docker.version}`);
+  const compose = detectComposeCommand();
+  if (!compose) {
+    logger.debug("Docker Compose is not installed or not in PATH");
+    return null;
+  }
+  logger.debug(`Detected Docker Compose version ${compose.version} (${compose.command.join(" ")})`);
+  const composeFilesFromEnv = getComposeFilesFromEnv();
+  let composeFiles;
+  if (composeFilesFromEnv) {
+    composeFiles = composeFilesFromEnv;
+    logger.debug(`Using COMPOSE_FILE environment variable: ${composeFiles.join(", ")}`);
+  } else {
+    const composeFile = findComposeFile();
+    if (!composeFile) {
+      logger.debug("No compose file found in current directory");
+      return null;
+    }
+    logger.debug(`Found compose file: ${composeFile}`);
+    composeFiles = [composeFile];
+    const overrideFile = findOverrideFile(composeFile);
+    if (overrideFile) {
+      logger.debug(`Found override file: ${overrideFile}`);
+      composeFiles.push(overrideFile);
+    }
+  }
+  const serviceNamesSet = /* @__PURE__ */ new Set();
+  for (const file of composeFiles) {
+    const services = getDockerComposeServices(file);
+    for (const service of services) {
+      serviceNamesSet.add(service);
+    }
+  }
+  const serviceNames = Array.from(serviceNamesSet);
+  if (serviceNames.length === 0) {
+    logger.debug("No services found in compose file(s)");
+    return null;
+  }
+  logger.debug(`Found ${serviceNames.length} service(s): ${serviceNames.join(", ")}`);
+  return {
+    composeFiles,
+    command: compose.command,
+    serviceNames
+  };
+}
+export {
+  DOCKER_HOST_GATEWAY,
+  DOCKER_HOST_INTERNAL,
+  DOCKER_MIN_VERSION,
+  buildDockerComposeCommand,
+  detectDocker,
+  detectDockerCompose
+};
+//# sourceMappingURL=docker-compose.js.map