@angelitosystems/devtools-protocol 0.1.0

package/dist/index.cjs

@@ -0,0 +1,282 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_REDACT_KEYS: () => DEFAULT_REDACT_KEYS,
+  DEVTOOLS_EVENTS: () => DEVTOOLS_EVENTS,
+  MAX_CAPTURE_BYTES: () => MAX_CAPTURE_BYTES,
+  MAX_DEPTH: () => MAX_DEPTH,
+  PROTOCOL_VERSION: () => PROTOCOL_VERSION,
+  Redactor: () => Redactor,
+  buildEditorUrl: () => buildEditorUrl,
+  createMessage: () => createMessage,
+  cursorUrl: () => cursorUrl,
+  defaultRedactor: () => defaultRedactor,
+  detectPlatform: () => detectPlatform,
+  isDevToolsEventName: () => isDevToolsEventName,
+  parseMessage: () => parseMessage,
+  randomId: () => randomId,
+  redactText: () => redactText,
+  redactValue: () => redactValue,
+  vscodeUrl: () => vscodeUrl
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var PROTOCOL_VERSION = 1;
+
+// src/events.ts
+var DEVTOOLS_EVENTS = [
+  "project.connected",
+  "project.disconnected",
+  "request.started",
+  "request.completed",
+  "log.created",
+  "error.created",
+  "query.executed",
+  "websocket.connected",
+  "websocket.message",
+  "performance.updated",
+  "app.snapshot",
+  "client.hello",
+  "client.welcome",
+  "stream.pause",
+  "stream.resume",
+  "state.clear",
+  "state.snapshot",
+  "state.ack",
+  "error"
+];
+function isDevToolsEventName(name) {
+  return DEVTOOLS_EVENTS.includes(name);
+}
+function createMessage(event, payload, options) {
+  return {
+    v: PROTOCOL_VERSION,
+    id: options?.id ?? randomId(),
+    projectId: options?.projectId,
+    ts: options?.ts ?? Date.now(),
+    event,
+    payload
+  };
+}
+function randomId(prefix) {
+  const core = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID().replace(/-/g, "").slice(0, 16) : Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
+  return prefix ? `${prefix}_${core}` : core;
+}
+function parseMessage(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "object" && parsed !== null && "event" in parsed && "payload" in parsed && isDevToolsEventName(String(parsed.event))) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/redact.ts
+var DEFAULT_REDACT_KEYS = [
+  "password",
+  "token",
+  "access_token",
+  "accessToken",
+  "refresh_token",
+  "refreshToken",
+  "authorization",
+  "cookie",
+  "cookies",
+  "secret",
+  "apiKey",
+  "api_key",
+  "client_secret",
+  "clientSecret",
+  "private_key",
+  "privateKey",
+  "session",
+  "set-cookie"
+];
+var MAX_CAPTURE_BYTES = 4 * 1024;
+var MAX_DEPTH = 4;
+var DEFAULT_PLACEHOLDER = "[REDACTED]";
+var TRUNCATION_SUFFIX = "\u2026[truncated]";
+var Redactor = class {
+  deny;
+  allow;
+  placeholder;
+  maxBytes;
+  maxDepth;
+  constructor(options) {
+    this.deny = new Set([...DEFAULT_REDACT_KEYS, ...options?.redact ?? []].map(normalizeKey));
+    this.allow = new Set((options?.allow ?? []).map(normalizeKey));
+    this.placeholder = options?.placeholder ?? DEFAULT_PLACEHOLDER;
+    this.maxBytes = options?.maxBytes ?? MAX_CAPTURE_BYTES;
+    this.maxDepth = options?.maxDepth ?? MAX_DEPTH;
+  }
+  /** True when the given key is sensitive and not allowed. */
+  isSensitive(key) {
+    const normalized = normalizeKey(key);
+    if (this.allow.has(normalized)) return false;
+    if (this.deny.has(normalized)) return true;
+    for (const denied of this.deny) {
+      if (normalized.includes(denied)) return true;
+    }
+    return false;
+  }
+  /**
+   * Deep-copy a value while redacting sensitive keys, truncating oversized
+   * strings and enforcing depth limits. Circular references become '[Circular]'.
+   */
+  redact(value, depth = 0, seen = /* @__PURE__ */ new Set()) {
+    if (value === null || typeof value !== "object") {
+      return redactPrimitive(value);
+    }
+    if (seen.has(value)) return "[Circular]";
+    if (depth >= this.maxDepth) return "[MaxDepth]";
+    seen.add(value);
+    try {
+      if (Array.isArray(value)) {
+        return value.slice(0, 50).map((item) => this.redact(item, depth + 1, seen));
+      }
+      if (value instanceof Error) {
+        return { name: value.name, message: value.message };
+      }
+      if (value instanceof Date) return value.toISOString();
+      const out = {};
+      for (const [key, raw] of Object.entries(value)) {
+        out[key] = this.isSensitive(key) ? this.placeholder : this.redact(raw, depth + 1, seen);
+      }
+      return out;
+    } finally {
+      seen.delete(value);
+    }
+  }
+  /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */
+  redactString(text) {
+    let out = text;
+    for (const denied of this.deny) {
+      const camel = denied;
+      const pattern = new RegExp(`(${escapeRegExp(camel)}|${escapeRegExp(denied.replace(/[-_]/g, ""))})\\s*[=:]\\s*([^\\s,&;]+)`, "gi");
+      out = out.replace(pattern, `$1=${this.placeholder}`);
+    }
+    out = out.replace(/bearer\s+[a-z0-9._-]+/gi, `Bearer ${this.placeholder}`);
+    return out;
+  }
+  /** Serialize a value safely: redacted, size-capped, never throws. */
+  serialize(value) {
+    try {
+      const safe = this.redact(value);
+      const json = JSON.stringify(safe) ?? String(safe);
+      return truncateUtf8(json, this.maxBytes, TRUNCATION_SUFFIX);
+    } catch {
+      return "[Unserializable]";
+    }
+  }
+};
+var defaultRedactor = new Redactor();
+function redactValue(value) {
+  return defaultRedactor.redact(value);
+}
+function redactText(text) {
+  return defaultRedactor.redactString(text);
+}
+function redactPrimitive(value) {
+  if (typeof value === "string") return defaultRedactor.redactString(value);
+  if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
+  if (typeof value === "function") return "[Function]";
+  if (typeof value === "bigint") return value.toString() + "n";
+  return String(value);
+}
+function normalizeKey(key) {
+  return key.toLowerCase().replace(/[-_\s]/g, "");
+}
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function truncateUtf8(text, maxBytes, suffix) {
+  const buf = Buffer.from(text, "utf8");
+  if (buf.length <= maxBytes) return text;
+  const cut = Math.max(0, maxBytes - Buffer.byteLength(suffix, "utf8"));
+  return buf.subarray(0, cut).toString("utf8") + suffix;
+}
+
+// src/editor-urls.ts
+var EDITOR_SCHEMES = {
+  vscode: "vscode",
+  cursor: "cursor",
+  zed: "zed",
+  sublime: "subl"
+};
+function detectPlatform(platformGetter) {
+  try {
+    const platform = platformGetter ? platformGetter() : process.platform;
+    if (platform === "win32" || platform === "darwin" || platform === "linux") return platform;
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function encodeFilePath(absolutePath, platform) {
+  const normalized = platform === "win32" ? absolutePath.replace(/\\/g, "/") : absolutePath;
+  const withDrive = platform === "win32" && /^[A-Za-z]:\//.test(normalized) ? `/${normalized}` : normalized;
+  return withDrive.replace(/^\//, "").split("/").map((segment, index) => index === 0 && /^[A-Za-z]:$/.test(segment) ? segment : encodeURIComponent(segment)).join("/");
+}
+function buildEditorUrl(editor, file, platformGetter) {
+  const absolutePath = file.absolutePath ?? file.file;
+  if (!absolutePath) return null;
+  const platform = detectPlatform(platformGetter);
+  const scheme = EDITOR_SCHEMES[editor];
+  const path = encodeFilePath(absolutePath, platform);
+  const line = file.line ?? 1;
+  const column = file.column ?? 1;
+  if (editor === "sublime") {
+    return `subl://open?url=file://${path}&line=${line}&column=${column}`;
+  }
+  return `${scheme}://file/${path}:${line}:${column}`;
+}
+function vscodeUrl(file) {
+  return buildEditorUrl("vscode", file);
+}
+function cursorUrl(file) {
+  return buildEditorUrl("cursor", file);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_REDACT_KEYS,
+  DEVTOOLS_EVENTS,
+  MAX_CAPTURE_BYTES,
+  MAX_DEPTH,
+  PROTOCOL_VERSION,
+  Redactor,
+  buildEditorUrl,
+  createMessage,
+  cursorUrl,
+  defaultRedactor,
+  detectPlatform,
+  isDevToolsEventName,
+  parseMessage,
+  randomId,
+  redactText,
+  redactValue,
+  vscodeUrl
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/events.ts","../src/redact.ts","../src/editor-urls.ts"],"sourcesContent":["/**\n * @angelitosystems/devtools-protocol\n *\n * Typed WebSocket protocol shared by the NestJS DevTools SDK, server and dashboard.\n * Zero runtime dependencies — safe to embed in every tier.\n */\nexport * from './types';\nexport * from './events';\nexport * from './redact';\nexport * from './editor-urls';\n","/** Wire protocol version. Bump on breaking payload changes. */\nexport const PROTOCOL_VERSION = 1 as const;\n\n/** JSON-RPC-ish envelope shared by every message on the wire. */\nexport interface DevToolsMessage<T = unknown> {\n  /** Envelope format version. */\n  v: typeof PROTOCOL_VERSION;\n  /** Unique message id. */\n  id: string;\n  /** Originating project (absent for client->server handshake-less control traffic). */\n  projectId?: string;\n  /** Milliseconds since epoch. */\n  ts: number;\n  /** Event discriminator. */\n  event: DevToolsEventName;\n  /** Event payload. */\n  payload: T;\n}\n\n/** All event names supported by protocol v1. */\nexport type DevToolsEventName =\n  // lifecycle\n  | 'project.connected'\n  | 'project.disconnected'\n  // http\n  | 'request.started'\n  | 'request.completed'\n  // observability\n  | 'log.created'\n  | 'error.created'\n  | 'query.executed'\n  // realtime\n  | 'websocket.connected'\n  | 'websocket.message'\n  // perf\n  | 'performance.updated'\n  // application graph\n  | 'app.snapshot'\n  // control plane\n  | 'client.hello'\n  | 'client.welcome'\n  | 'stream.pause'\n  | 'stream.resume'\n  | 'state.clear'\n  | 'state.snapshot'\n  | 'state.ack'\n  | 'error';\n\n/** Union of every typed payload keyed by its event name. */\nexport interface DevToolsEventMap {\n  'project.connected': ProjectInfo;\n  'project.disconnected': { projectId: string; reason?: string };\n  'request.started': RequestStartedPayload;\n  'request.completed': RequestCompletedPayload;\n  'log.created': LogPayload;\n  'error.created': ErrorPayload;\n  'query.executed': QueryPayload;\n  'websocket.connected': GatewayConnectionPayload;\n  'websocket.message': GatewayMessagePayload;\n  'performance.updated': PerformanceSnapshot;\n  'app.snapshot': AppSnapshot;\n  'client.hello': ClientHello;\n  'client.welcome': { serverVersion: string; protocol: typeof PROTOCOL_VERSION };\n  'stream.pause': Record<string, never>;\n  'stream.resume': Record<string, never>;\n  'state.clear': { scope: 'logs' | 'requests' | 'errors' | 'queries' | 'all' };\n  'state.snapshot': StateSnapshot;\n  'state.ack': { ok: true };\n  error: { code: string; message: string };\n}\n\n/** Discriminated union of all wire messages. */\nexport type DevToolsEvent = {\n  [K in DevToolsEventName]: DevToolsMessage<DevToolsEventMap[K]>;\n}[DevToolsEventName];\n\n/** Metadata every NestJS application reports when it connects. */\nexport interface ProjectInfo {\n  projectId: string;\n  projectName: string;\n  environment: string;\n  hostname: string;\n  port: number | null;\n  pid: number;\n  runtime: string;\n  runtimeVersion: string;\n  nodeVersion: string;\n  nestjsVersion: string | null;\n  sdkVersion: string;\n}\n\n/** One timeline entry of a request (guard, interceptor, service call...). */\nexport interface TimelineSpan {\n  /** Logical layer, e.g. 'middleware' | 'guard' | 'interceptor' | 'pipe' | 'controller' | 'service' | 'database' | 'response'. */\n  layer: string;\n  /** Human label, e.g. 'JwtAuthGuard' or 'SELECT users'. */\n  label: string;\n  /** ms */\n  duration: number;\n  startedAt: number;\n  status?: 'ok' | 'error';\n  detail?: string;\n}\n\n/** Emitted the moment a request enters the SDK. */\nexport interface RequestStartedPayload {\n  requestId: string;\n  projectId: string;\n  method: string;\n  url: string;\n  route?: string;\n  httpVersion?: string;\n  headers: Record<string, string>;\n  query: Record<string, unknown>;\n  params?: Record<string, unknown>;\n  ip?: string;\n  userAgent?: string;\n  startedAt: number;\n}\n\n/** Emitted when the response finishes. */\nexport interface RequestCompletedPayload {\n  requestId: string;\n  projectId: string;\n  method: string;\n  url: string;\n  route?: string;\n  statusCode: number;\n  duration: number;\n  startedAt: number;\n  timeline: TimelineSpan[];\n  query?: Record<string, unknown>;\n  responsePreview?: string;\n  responseBody?: unknown;\n  requestBody?: unknown;\n  errored: boolean;\n}\n\n/** A captured console or logger entry. */\nexport interface LogPayload {\n  requestId?: string;\n  projectId: string;\n  level: LogLevel;\n  message: string;\n  arguments?: unknown[];\n  stack?: string;\n  source?: SourceLocation;\n  context?: string;\n  processId: number;\n  timestamp: number;\n}\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'verbose';\n\n/** File/line/column triple resolved from source maps when available. */\nexport interface SourceLocation {\n  file: string;\n  line: number;\n  column: number;\n  /** Absolute path when resolvable on the host machine. */\n  absolutePath?: string;\n  /** function name if the stack exposed one */\n  function?: string;\n}\n\n/** A captured exception with source mapping. */\nexport interface ErrorPayload {\n  requestId?: string;\n  projectId: string;\n  name: string;\n  message: string;\n  stack?: string;\n  source?: SourceLocation;\n  /** stable hash for grouping identical errors */\n  fingerprint: string;\n  context?: string;\n  request?: { method: string; url: string; statusCode?: number };\n  controller?: string;\n  service?: string;\n  timestamp: number;\n  /** server-side occurrence count for grouped errors */\n  occurrences?: number;\n}\n\n/** A captured database query. */\nexport interface QueryPayload {\n  requestId?: string;\n  projectId: string;\n  provider: 'prisma' | 'typeorm' | 'sequelize' | 'mikroorm' | 'other';\n  sql: string;\n  duration: number;\n  database?: string;\n  parameters?: unknown[];\n  timestamp: number;\n}\n\n/** Gateway-level connection snapshot. */\nexport interface GatewayConnectionPayload {\n  projectId: string;\n  gateway: string;\n  namespace: string;\n  connections: number;\n  timestamp: number;\n}\n\n/** Individual gateway event flow. */\nexport interface GatewayMessagePayload {\n  projectId: string;\n  gateway: string;\n  event: string;\n  direction: 'received' | 'sent';\n  payloadSize: number;\n  error?: string;\n  duration?: number;\n  requestId?: string;\n  timestamp: number;\n}\n\n/** Point-in-time process metrics. */\nexport interface PerformanceSnapshot {\n  projectId: string;\n  timestamp: number;\n  cpuPercent: number;\n  memoryUsedBytes: number;\n  memoryTotalBytes: number;\n  heapUsedBytes: number;\n  heapTotalBytes: number;\n  eventLoopLagMs: number;\n  activeRequests: number;\n  requestsPerSecond: number;\n  averageLatencyMs: number;\n  p95LatencyMs: number;\n  p99LatencyMs: number;\n  errorsPerSecond: number;\n  /** true when the process reports memory pressure */\n  memoryPressure?: boolean;\n}\n\n/** Static description of the NestJS application graph. */\nexport interface AppSnapshot {\n  projectId: string;\n  projectName: string;\n  modules: AppModuleNode[];\n  nestjsVersion: string | null;\n  capturedAt: number;\n}\n\n/** A module and its members in the application graph. */\nexport interface AppModuleNode {\n  name: string;\n  imports: string[];\n  controllers: AppMemberNode[];\n  providers: AppMemberNode[];\n  exports: string[];\n}\n\n/** A member (controller/provider/guard/pipe/...) inside a module. */\nexport interface AppMemberNode {\n  name: string;\n  type: 'controller' | 'provider' | 'guard' | 'interceptor' | 'pipe' | 'filter' | 'gateway';\n  routes?: string[];\n}\n\n/** What a dashboard/control client announces when it connects. */\nexport interface ClientHello {\n  kind: 'dashboard' | 'cli' | 'other';\n  name?: string;\n  version?: string;\n}\n\n/** Full server state handed to newly connected dashboards. */\nexport interface StateSnapshot {\n  projects: ProjectInfo[];\n  requests: RequestCompletedPayload[];\n  logs: LogPayload[];\n  errors: ErrorPayload[];\n  queries: QueryPayload[];\n  performance: Record<string, PerformanceSnapshot>;\n  apps: Record<string, AppSnapshot>;\n}\n","import type { DevToolsEventMap, DevToolsEventName, DevToolsMessage } from './types';\nimport { PROTOCOL_VERSION } from './types';\n\n/** Const array of every event name (runtime mirror of the type union). */\nexport const DEVTOOLS_EVENTS = [\n  'project.connected',\n  'project.disconnected',\n  'request.started',\n  'request.completed',\n  'log.created',\n  'error.created',\n  'query.executed',\n  'websocket.connected',\n  'websocket.message',\n  'performance.updated',\n  'app.snapshot',\n  'client.hello',\n  'client.welcome',\n  'stream.pause',\n  'stream.resume',\n  'state.clear',\n  'state.snapshot',\n  'state.ack',\n  'error',\n] as const satisfies readonly DevToolsEventName[];\n\n/** True when `name` is a known protocol event. */\nexport function isDevToolsEventName(name: string): name is DevToolsEventName {\n  return (DEVTOOLS_EVENTS as readonly string[]).includes(name);\n}\n\n/** Build a fully-typed wire message. */\nexport function createMessage<K extends DevToolsEventName>(\n  event: K,\n  payload: DevToolsEventMap[K],\n  options?: { projectId?: string; id?: string; ts?: number },\n): DevToolsMessage<DevToolsEventMap[K]> {\n  return {\n    v: PROTOCOL_VERSION,\n    id: options?.id ?? randomId(),\n    projectId: options?.projectId,\n    ts: options?.ts ?? Date.now(),\n    event,\n    payload,\n  };\n}\n\n/** Cheap collision-resistant id (no crypto dependency needed for wire correlation). */\nexport function randomId(prefix?: string): string {\n  const core =\n    typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n      ? crypto.randomUUID().replace(/-/g, '').slice(0, 16)\n      : Math.random().toString(36).slice(2, 10) + Date.now().toString(36);\n  return prefix ? `${prefix}_${core}` : core;\n}\n\n/** Type guard narrowing an unknown parsed frame into a DevToolsMessage. */\nexport function parseMessage(raw: string): DevToolsMessage | null {\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (\n      typeof parsed === 'object' &&\n      parsed !== null &&\n      'event' in parsed &&\n      'payload' in parsed &&\n      isDevToolsEventName(String((parsed as { event: unknown }).event))\n    ) {\n      return parsed as DevToolsMessage;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n","/** Default keys that are always redacted unless explicitly allowed. */\nexport const DEFAULT_REDACT_KEYS = [\n  'password',\n  'token',\n  'access_token',\n  'accessToken',\n  'refresh_token',\n  'refreshToken',\n  'authorization',\n  'cookie',\n  'cookies',\n  'secret',\n  'apiKey',\n  'api_key',\n  'client_secret',\n  'clientSecret',\n  'private_key',\n  'privateKey',\n  'session',\n  'set-cookie',\n] as const;\n\n/** Default capture ceilings shared by SDK and server. */\nexport const MAX_CAPTURE_BYTES = 4 * 1024;\nexport const MAX_DEPTH = 4;\n\n/** Options for deep redaction of arbitrary values. */\nexport interface RedactOptions {\n  /** Extra key names to redact (case-insensitive, partial match allowed). */\n  redact?: string[];\n  /** Keys that should never be redacted even if they look sensitive. */\n  allow?: string[];\n  /** Placeholder string used for redacted values. */\n  placeholder?: string;\n  /** Max serialized size before truncation. */\n  maxBytes?: number;\n  /** Max object depth. */\n  maxDepth?: number;\n}\n\nconst DEFAULT_PLACEHOLDER = '[REDACTED]';\nconst TRUNCATION_SUFFIX = '…[truncated]';\n\n/** Normalized set of denylist and allowlist key matchers. */\nexport class Redactor {\n  private readonly deny: Set<string>;\n  private readonly allow: Set<string>;\n  private readonly placeholder: string;\n  private readonly maxBytes: number;\n  private readonly maxDepth: number;\n\n  constructor(options?: RedactOptions) {\n    this.deny = new Set([...DEFAULT_REDACT_KEYS, ...(options?.redact ?? [])].map(normalizeKey));\n    this.allow = new Set((options?.allow ?? []).map(normalizeKey));\n    this.placeholder = options?.placeholder ?? DEFAULT_PLACEHOLDER;\n    this.maxBytes = options?.maxBytes ?? MAX_CAPTURE_BYTES;\n    this.maxDepth = options?.maxDepth ?? MAX_DEPTH;\n  }\n\n  /** True when the given key is sensitive and not allowed. */\n  isSensitive(key: string): boolean {\n    const normalized = normalizeKey(key);\n    if (this.allow.has(normalized)) return false;\n    if (this.deny.has(normalized)) return true;\n    // partial match: `userPassword`, `authTokenValue`, `x-api-key`...\n    for (const denied of this.deny) {\n      if (normalized.includes(denied)) return true;\n    }\n    return false;\n  }\n\n  /**\n   * Deep-copy a value while redacting sensitive keys, truncating oversized\n   * strings and enforcing depth limits. Circular references become '[Circular]'.\n   */\n  redact(value: unknown, depth = 0, seen = new Set<unknown>()): unknown {\n    if (value === null || typeof value !== 'object') {\n      return redactPrimitive(value);\n    }\n    if (seen.has(value)) return '[Circular]';\n    if (depth >= this.maxDepth) return '[MaxDepth]';\n\n    seen.add(value);\n    try {\n      if (Array.isArray(value)) {\n        return value.slice(0, 50).map((item) => this.redact(item, depth + 1, seen));\n      }\n      if (value instanceof Error) {\n        return { name: value.name, message: value.message };\n      }\n      if (value instanceof Date) return value.toISOString();\n\n      const out: Record<string, unknown> = {};\n      for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n        out[key] = this.isSensitive(key) ? this.placeholder : this.redact(raw, depth + 1, seen);\n      }\n      return out;\n    } finally {\n      seen.delete(value);\n    }\n  }\n\n  /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */\n  redactString(text: string): string {\n    let out = text;\n    for (const denied of this.deny) {\n      const camel = denied;\n      const pattern = new RegExp(`(${escapeRegExp(camel)}|${escapeRegExp(denied.replace(/[-_]/g, ''))})\\\\s*[=:]\\\\s*([^\\\\s,&;]+)`, 'gi');\n      out = out.replace(pattern, `$1=${this.placeholder}`);\n    }\n    out = out.replace(/bearer\\s+[a-z0-9._-]+/gi, `Bearer ${this.placeholder}`);\n    return out;\n  }\n\n  /** Serialize a value safely: redacted, size-capped, never throws. */\n  serialize(value: unknown): string {\n    try {\n      const safe = this.redact(value);\n      const json = JSON.stringify(safe) ?? String(safe);\n      return truncateUtf8(json, this.maxBytes, TRUNCATION_SUFFIX);\n    } catch {\n      return '[Unserializable]';\n    }\n  }\n}\n\n/** Shared default redactor instance for quick helpers. */\nexport const defaultRedactor = new Redactor();\n\n/** Convenience: deep-redact with the default policy. */\nexport function redactValue(value: unknown): unknown {\n  return defaultRedactor.redact(value);\n}\n\n/** Convenience: scrub a free-form string with the default policy. */\nexport function redactText(text: string): string {\n  return defaultRedactor.redactString(text);\n}\n\nfunction redactPrimitive(value: unknown): unknown {\n  if (typeof value === 'string') return defaultRedactor.redactString(value);\n  if (typeof value === 'number' || typeof value === 'boolean' || value === null) return value;\n  if (typeof value === 'function') return '[Function]';\n  if (typeof value === 'bigint') return value.toString() + 'n';\n  return String(value);\n}\n\nfunction normalizeKey(key: string): string {\n  return key.toLowerCase().replace(/[-_\\s]/g, '');\n}\n\nfunction escapeRegExp(text: string): string {\n  return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** UTF-8-safe truncation that never splits a multi-byte character. */\nfunction truncateUtf8(text: string, maxBytes: number, suffix: string): string {\n  const buf = Buffer.from(text, 'utf8');\n  if (buf.length <= maxBytes) return text;\n  const cut = Math.max(0, maxBytes - Buffer.byteLength(suffix, 'utf8'));\n  return buf.subarray(0, cut).toString('utf8') + suffix;\n}\n","/**\n * Deep links that open a file at a specific line/column in an editor.\n * Paths are generated for the OS the DevTools *server* runs on — never assume\n * Windows or POSIX layout; detect it at runtime.\n */\n\nexport type EditorKind = 'vscode' | 'cursor' | 'zed' | 'sublime';\n\nconst EDITOR_SCHEMES: Record<EditorKind, string> = {\n  vscode: 'vscode',\n  cursor: 'cursor',\n  zed: 'zed',\n  sublime: 'subl',\n};\n\n/** Returns 'win32' | 'darwin' | 'linux' | 'unknown' without touching process when unavailable. */\nexport function detectPlatform(platformGetter?: () => string): 'win32' | 'darwin' | 'linux' | 'unknown' {\n  try {\n    const platform = platformGetter ? platformGetter() : process.platform;\n    if (platform === 'win32' || platform === 'darwin' || platform === 'linux') return platform;\n    return 'unknown';\n  } catch {\n    return 'unknown';\n  }\n}\n\nfunction encodeFilePath(absolutePath: string, platform: string): string {\n  // VS Code expects forward slashes; keep drive letters like /C:/... on Windows.\n  const normalized = platform === 'win32' ? absolutePath.replace(/\\\\/g, '/') : absolutePath;\n  const withDrive = platform === 'win32' && /^[A-Za-z]:\\//.test(normalized) ? `/${normalized}` : normalized;\n  // the scheme already carries 'file/', so drop any leading slash;\n  // preserve the drive-letter colon (C:) which VS Code expects unencoded\n  return withDrive\n    .replace(/^\\//, '')\n    .split('/')\n    .map((segment, index) => (index === 0 && /^[A-Za-z]:$/.test(segment) ? segment : encodeURIComponent(segment)))\n    .join('/');\n}\n\n/**\n * Build an editor deep link such as:\n *   vscode://file/Users/me/app/src/users.service.ts:87:21\n */\nexport function buildEditorUrl(\n  editor: EditorKind,\n  file: { absolutePath?: string; file?: string; line?: number; column?: number },\n  platformGetter?: () => string,\n): string | null {\n  const absolutePath = file.absolutePath ?? file.file;\n  if (!absolutePath) return null;\n\n  const platform = detectPlatform(platformGetter);\n  const scheme = EDITOR_SCHEMES[editor];\n  const path = encodeFilePath(absolutePath, platform);\n  const line = file.line ?? 1;\n  const column = file.column ?? 1;\n\n  if (editor === 'sublime') {\n    return `subl://open?url=file://${path}&line=${line}&column=${column}`;\n  }\n  return `${scheme}://file/${path}:${line}:${column}`;\n}\n\n/** First available vscode:// link for a source location. */\nexport function vscodeUrl(file: { absolutePath?: string; file?: string; line?: number; column?: number }): string | null {\n  return buildEditorUrl('vscode', file);\n}\n\n/** First available cursor:// link for a source location. */\nexport function cursorUrl(file: { absolutePath?: string; file?: string; line?: number; column?: number }): string | null {\n  return buildEditorUrl('cursor', file);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,345 @@
+/** Wire protocol version. Bump on breaking payload changes. */
+declare const PROTOCOL_VERSION: 1;
+/** JSON-RPC-ish envelope shared by every message on the wire. */
+interface DevToolsMessage<T = unknown> {
+    /** Envelope format version. */
+    v: typeof PROTOCOL_VERSION;
+    /** Unique message id. */
+    id: string;
+    /** Originating project (absent for client->server handshake-less control traffic). */
+    projectId?: string;
+    /** Milliseconds since epoch. */
+    ts: number;
+    /** Event discriminator. */
+    event: DevToolsEventName;
+    /** Event payload. */
+    payload: T;
+}
+/** All event names supported by protocol v1. */
+type DevToolsEventName = 'project.connected' | 'project.disconnected' | 'request.started' | 'request.completed' | 'log.created' | 'error.created' | 'query.executed' | 'websocket.connected' | 'websocket.message' | 'performance.updated' | 'app.snapshot' | 'client.hello' | 'client.welcome' | 'stream.pause' | 'stream.resume' | 'state.clear' | 'state.snapshot' | 'state.ack' | 'error';
+/** Union of every typed payload keyed by its event name. */
+interface DevToolsEventMap {
+    'project.connected': ProjectInfo;
+    'project.disconnected': {
+        projectId: string;
+        reason?: string;
+    };
+    'request.started': RequestStartedPayload;
+    'request.completed': RequestCompletedPayload;
+    'log.created': LogPayload;
+    'error.created': ErrorPayload;
+    'query.executed': QueryPayload;
+    'websocket.connected': GatewayConnectionPayload;
+    'websocket.message': GatewayMessagePayload;
+    'performance.updated': PerformanceSnapshot;
+    'app.snapshot': AppSnapshot;
+    'client.hello': ClientHello;
+    'client.welcome': {
+        serverVersion: string;
+        protocol: typeof PROTOCOL_VERSION;
+    };
+    'stream.pause': Record<string, never>;
+    'stream.resume': Record<string, never>;
+    'state.clear': {
+        scope: 'logs' | 'requests' | 'errors' | 'queries' | 'all';
+    };
+    'state.snapshot': StateSnapshot;
+    'state.ack': {
+        ok: true;
+    };
+    error: {
+        code: string;
+        message: string;
+    };
+}
+/** Discriminated union of all wire messages. */
+type DevToolsEvent = {
+    [K in DevToolsEventName]: DevToolsMessage<DevToolsEventMap[K]>;
+}[DevToolsEventName];
+/** Metadata every NestJS application reports when it connects. */
+interface ProjectInfo {
+    projectId: string;
+    projectName: string;
+    environment: string;
+    hostname: string;
+    port: number | null;
+    pid: number;
+    runtime: string;
+    runtimeVersion: string;
+    nodeVersion: string;
+    nestjsVersion: string | null;
+    sdkVersion: string;
+}
+/** One timeline entry of a request (guard, interceptor, service call...). */
+interface TimelineSpan {
+    /** Logical layer, e.g. 'middleware' | 'guard' | 'interceptor' | 'pipe' | 'controller' | 'service' | 'database' | 'response'. */
+    layer: string;
+    /** Human label, e.g. 'JwtAuthGuard' or 'SELECT users'. */
+    label: string;
+    /** ms */
+    duration: number;
+    startedAt: number;
+    status?: 'ok' | 'error';
+    detail?: string;
+}
+/** Emitted the moment a request enters the SDK. */
+interface RequestStartedPayload {
+    requestId: string;
+    projectId: string;
+    method: string;
+    url: string;
+    route?: string;
+    httpVersion?: string;
+    headers: Record<string, string>;
+    query: Record<string, unknown>;
+    params?: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    startedAt: number;
+}
+/** Emitted when the response finishes. */
+interface RequestCompletedPayload {
+    requestId: string;
+    projectId: string;
+    method: string;
+    url: string;
+    route?: string;
+    statusCode: number;
+    duration: number;
+    startedAt: number;
+    timeline: TimelineSpan[];
+    query?: Record<string, unknown>;
+    responsePreview?: string;
+    responseBody?: unknown;
+    requestBody?: unknown;
+    errored: boolean;
+}
+/** A captured console or logger entry. */
+interface LogPayload {
+    requestId?: string;
+    projectId: string;
+    level: LogLevel;
+    message: string;
+    arguments?: unknown[];
+    stack?: string;
+    source?: SourceLocation;
+    context?: string;
+    processId: number;
+    timestamp: number;
+}
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'verbose';
+/** File/line/column triple resolved from source maps when available. */
+interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+    /** Absolute path when resolvable on the host machine. */
+    absolutePath?: string;
+    /** function name if the stack exposed one */
+    function?: string;
+}
+/** A captured exception with source mapping. */
+interface ErrorPayload {
+    requestId?: string;
+    projectId: string;
+    name: string;
+    message: string;
+    stack?: string;
+    source?: SourceLocation;
+    /** stable hash for grouping identical errors */
+    fingerprint: string;
+    context?: string;
+    request?: {
+        method: string;
+        url: string;
+        statusCode?: number;
+    };
+    controller?: string;
+    service?: string;
+    timestamp: number;
+    /** server-side occurrence count for grouped errors */
+    occurrences?: number;
+}
+/** A captured database query. */
+interface QueryPayload {
+    requestId?: string;
+    projectId: string;
+    provider: 'prisma' | 'typeorm' | 'sequelize' | 'mikroorm' | 'other';
+    sql: string;
+    duration: number;
+    database?: string;
+    parameters?: unknown[];
+    timestamp: number;
+}
+/** Gateway-level connection snapshot. */
+interface GatewayConnectionPayload {
+    projectId: string;
+    gateway: string;
+    namespace: string;
+    connections: number;
+    timestamp: number;
+}
+/** Individual gateway event flow. */
+interface GatewayMessagePayload {
+    projectId: string;
+    gateway: string;
+    event: string;
+    direction: 'received' | 'sent';
+    payloadSize: number;
+    error?: string;
+    duration?: number;
+    requestId?: string;
+    timestamp: number;
+}
+/** Point-in-time process metrics. */
+interface PerformanceSnapshot {
+    projectId: string;
+    timestamp: number;
+    cpuPercent: number;
+    memoryUsedBytes: number;
+    memoryTotalBytes: number;
+    heapUsedBytes: number;
+    heapTotalBytes: number;
+    eventLoopLagMs: number;
+    activeRequests: number;
+    requestsPerSecond: number;
+    averageLatencyMs: number;
+    p95LatencyMs: number;
+    p99LatencyMs: number;
+    errorsPerSecond: number;
+    /** true when the process reports memory pressure */
+    memoryPressure?: boolean;
+}
+/** Static description of the NestJS application graph. */
+interface AppSnapshot {
+    projectId: string;
+    projectName: string;
+    modules: AppModuleNode[];
+    nestjsVersion: string | null;
+    capturedAt: number;
+}
+/** A module and its members in the application graph. */
+interface AppModuleNode {
+    name: string;
+    imports: string[];
+    controllers: AppMemberNode[];
+    providers: AppMemberNode[];
+    exports: string[];
+}
+/** A member (controller/provider/guard/pipe/...) inside a module. */
+interface AppMemberNode {
+    name: string;
+    type: 'controller' | 'provider' | 'guard' | 'interceptor' | 'pipe' | 'filter' | 'gateway';
+    routes?: string[];
+}
+/** What a dashboard/control client announces when it connects. */
+interface ClientHello {
+    kind: 'dashboard' | 'cli' | 'other';
+    name?: string;
+    version?: string;
+}
+/** Full server state handed to newly connected dashboards. */
+interface StateSnapshot {
+    projects: ProjectInfo[];
+    requests: RequestCompletedPayload[];
+    logs: LogPayload[];
+    errors: ErrorPayload[];
+    queries: QueryPayload[];
+    performance: Record<string, PerformanceSnapshot>;
+    apps: Record<string, AppSnapshot>;
+}
+
+/** Const array of every event name (runtime mirror of the type union). */
+declare const DEVTOOLS_EVENTS: readonly ["project.connected", "project.disconnected", "request.started", "request.completed", "log.created", "error.created", "query.executed", "websocket.connected", "websocket.message", "performance.updated", "app.snapshot", "client.hello", "client.welcome", "stream.pause", "stream.resume", "state.clear", "state.snapshot", "state.ack", "error"];
+/** True when `name` is a known protocol event. */
+declare function isDevToolsEventName(name: string): name is DevToolsEventName;
+/** Build a fully-typed wire message. */
+declare function createMessage<K extends DevToolsEventName>(event: K, payload: DevToolsEventMap[K], options?: {
+    projectId?: string;
+    id?: string;
+    ts?: number;
+}): DevToolsMessage<DevToolsEventMap[K]>;
+/** Cheap collision-resistant id (no crypto dependency needed for wire correlation). */
+declare function randomId(prefix?: string): string;
+/** Type guard narrowing an unknown parsed frame into a DevToolsMessage. */
+declare function parseMessage(raw: string): DevToolsMessage | null;
+
+/** Default keys that are always redacted unless explicitly allowed. */
+declare const DEFAULT_REDACT_KEYS: readonly ["password", "token", "access_token", "accessToken", "refresh_token", "refreshToken", "authorization", "cookie", "cookies", "secret", "apiKey", "api_key", "client_secret", "clientSecret", "private_key", "privateKey", "session", "set-cookie"];
+/** Default capture ceilings shared by SDK and server. */
+declare const MAX_CAPTURE_BYTES: number;
+declare const MAX_DEPTH = 4;
+/** Options for deep redaction of arbitrary values. */
+interface RedactOptions {
+    /** Extra key names to redact (case-insensitive, partial match allowed). */
+    redact?: string[];
+    /** Keys that should never be redacted even if they look sensitive. */
+    allow?: string[];
+    /** Placeholder string used for redacted values. */
+    placeholder?: string;
+    /** Max serialized size before truncation. */
+    maxBytes?: number;
+    /** Max object depth. */
+    maxDepth?: number;
+}
+/** Normalized set of denylist and allowlist key matchers. */
+declare class Redactor {
+    private readonly deny;
+    private readonly allow;
+    private readonly placeholder;
+    private readonly maxBytes;
+    private readonly maxDepth;
+    constructor(options?: RedactOptions);
+    /** True when the given key is sensitive and not allowed. */
+    isSensitive(key: string): boolean;
+    /**
+     * Deep-copy a value while redacting sensitive keys, truncating oversized
+     * strings and enforcing depth limits. Circular references become '[Circular]'.
+     */
+    redact(value: unknown, depth?: number, seen?: Set<unknown>): unknown;
+    /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */
+    redactString(text: string): string;
+    /** Serialize a value safely: redacted, size-capped, never throws. */
+    serialize(value: unknown): string;
+}
+/** Shared default redactor instance for quick helpers. */
+declare const defaultRedactor: Redactor;
+/** Convenience: deep-redact with the default policy. */
+declare function redactValue(value: unknown): unknown;
+/** Convenience: scrub a free-form string with the default policy. */
+declare function redactText(text: string): string;
+
+/**
+ * Deep links that open a file at a specific line/column in an editor.
+ * Paths are generated for the OS the DevTools *server* runs on — never assume
+ * Windows or POSIX layout; detect it at runtime.
+ */
+type EditorKind = 'vscode' | 'cursor' | 'zed' | 'sublime';
+/** Returns 'win32' | 'darwin' | 'linux' | 'unknown' without touching process when unavailable. */
+declare function detectPlatform(platformGetter?: () => string): 'win32' | 'darwin' | 'linux' | 'unknown';
+/**
+ * Build an editor deep link such as:
+ *   vscode://file/Users/me/app/src/users.service.ts:87:21
+ */
+declare function buildEditorUrl(editor: EditorKind, file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}, platformGetter?: () => string): string | null;
+/** First available vscode:// link for a source location. */
+declare function vscodeUrl(file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}): string | null;
+/** First available cursor:// link for a source location. */
+declare function cursorUrl(file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}): string | null;
+
+export { type AppMemberNode, type AppModuleNode, type AppSnapshot, type ClientHello, DEFAULT_REDACT_KEYS, DEVTOOLS_EVENTS, type DevToolsEvent, type DevToolsEventMap, type DevToolsEventName, type DevToolsMessage, type EditorKind, type ErrorPayload, type GatewayConnectionPayload, type GatewayMessagePayload, type LogLevel, type LogPayload, MAX_CAPTURE_BYTES, MAX_DEPTH, PROTOCOL_VERSION, type PerformanceSnapshot, type ProjectInfo, type QueryPayload, type RedactOptions, Redactor, type RequestCompletedPayload, type RequestStartedPayload, type SourceLocation, type StateSnapshot, type TimelineSpan, buildEditorUrl, createMessage, cursorUrl, defaultRedactor, detectPlatform, isDevToolsEventName, parseMessage, randomId, redactText, redactValue, vscodeUrl };

package/dist/index.d.ts

@@ -0,0 +1,345 @@
+/** Wire protocol version. Bump on breaking payload changes. */
+declare const PROTOCOL_VERSION: 1;
+/** JSON-RPC-ish envelope shared by every message on the wire. */
+interface DevToolsMessage<T = unknown> {
+    /** Envelope format version. */
+    v: typeof PROTOCOL_VERSION;
+    /** Unique message id. */
+    id: string;
+    /** Originating project (absent for client->server handshake-less control traffic). */
+    projectId?: string;
+    /** Milliseconds since epoch. */
+    ts: number;
+    /** Event discriminator. */
+    event: DevToolsEventName;
+    /** Event payload. */
+    payload: T;
+}
+/** All event names supported by protocol v1. */
+type DevToolsEventName = 'project.connected' | 'project.disconnected' | 'request.started' | 'request.completed' | 'log.created' | 'error.created' | 'query.executed' | 'websocket.connected' | 'websocket.message' | 'performance.updated' | 'app.snapshot' | 'client.hello' | 'client.welcome' | 'stream.pause' | 'stream.resume' | 'state.clear' | 'state.snapshot' | 'state.ack' | 'error';
+/** Union of every typed payload keyed by its event name. */
+interface DevToolsEventMap {
+    'project.connected': ProjectInfo;
+    'project.disconnected': {
+        projectId: string;
+        reason?: string;
+    };
+    'request.started': RequestStartedPayload;
+    'request.completed': RequestCompletedPayload;
+    'log.created': LogPayload;
+    'error.created': ErrorPayload;
+    'query.executed': QueryPayload;
+    'websocket.connected': GatewayConnectionPayload;
+    'websocket.message': GatewayMessagePayload;
+    'performance.updated': PerformanceSnapshot;
+    'app.snapshot': AppSnapshot;
+    'client.hello': ClientHello;
+    'client.welcome': {
+        serverVersion: string;
+        protocol: typeof PROTOCOL_VERSION;
+    };
+    'stream.pause': Record<string, never>;
+    'stream.resume': Record<string, never>;
+    'state.clear': {
+        scope: 'logs' | 'requests' | 'errors' | 'queries' | 'all';
+    };
+    'state.snapshot': StateSnapshot;
+    'state.ack': {
+        ok: true;
+    };
+    error: {
+        code: string;
+        message: string;
+    };
+}
+/** Discriminated union of all wire messages. */
+type DevToolsEvent = {
+    [K in DevToolsEventName]: DevToolsMessage<DevToolsEventMap[K]>;
+}[DevToolsEventName];
+/** Metadata every NestJS application reports when it connects. */
+interface ProjectInfo {
+    projectId: string;
+    projectName: string;
+    environment: string;
+    hostname: string;
+    port: number | null;
+    pid: number;
+    runtime: string;
+    runtimeVersion: string;
+    nodeVersion: string;
+    nestjsVersion: string | null;
+    sdkVersion: string;
+}
+/** One timeline entry of a request (guard, interceptor, service call...). */
+interface TimelineSpan {
+    /** Logical layer, e.g. 'middleware' | 'guard' | 'interceptor' | 'pipe' | 'controller' | 'service' | 'database' | 'response'. */
+    layer: string;
+    /** Human label, e.g. 'JwtAuthGuard' or 'SELECT users'. */
+    label: string;
+    /** ms */
+    duration: number;
+    startedAt: number;
+    status?: 'ok' | 'error';
+    detail?: string;
+}
+/** Emitted the moment a request enters the SDK. */
+interface RequestStartedPayload {
+    requestId: string;
+    projectId: string;
+    method: string;
+    url: string;
+    route?: string;
+    httpVersion?: string;
+    headers: Record<string, string>;
+    query: Record<string, unknown>;
+    params?: Record<string, unknown>;
+    ip?: string;
+    userAgent?: string;
+    startedAt: number;
+}
+/** Emitted when the response finishes. */
+interface RequestCompletedPayload {
+    requestId: string;
+    projectId: string;
+    method: string;
+    url: string;
+    route?: string;
+    statusCode: number;
+    duration: number;
+    startedAt: number;
+    timeline: TimelineSpan[];
+    query?: Record<string, unknown>;
+    responsePreview?: string;
+    responseBody?: unknown;
+    requestBody?: unknown;
+    errored: boolean;
+}
+/** A captured console or logger entry. */
+interface LogPayload {
+    requestId?: string;
+    projectId: string;
+    level: LogLevel;
+    message: string;
+    arguments?: unknown[];
+    stack?: string;
+    source?: SourceLocation;
+    context?: string;
+    processId: number;
+    timestamp: number;
+}
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'verbose';
+/** File/line/column triple resolved from source maps when available. */
+interface SourceLocation {
+    file: string;
+    line: number;
+    column: number;
+    /** Absolute path when resolvable on the host machine. */
+    absolutePath?: string;
+    /** function name if the stack exposed one */
+    function?: string;
+}
+/** A captured exception with source mapping. */
+interface ErrorPayload {
+    requestId?: string;
+    projectId: string;
+    name: string;
+    message: string;
+    stack?: string;
+    source?: SourceLocation;
+    /** stable hash for grouping identical errors */
+    fingerprint: string;
+    context?: string;
+    request?: {
+        method: string;
+        url: string;
+        statusCode?: number;
+    };
+    controller?: string;
+    service?: string;
+    timestamp: number;
+    /** server-side occurrence count for grouped errors */
+    occurrences?: number;
+}
+/** A captured database query. */
+interface QueryPayload {
+    requestId?: string;
+    projectId: string;
+    provider: 'prisma' | 'typeorm' | 'sequelize' | 'mikroorm' | 'other';
+    sql: string;
+    duration: number;
+    database?: string;
+    parameters?: unknown[];
+    timestamp: number;
+}
+/** Gateway-level connection snapshot. */
+interface GatewayConnectionPayload {
+    projectId: string;
+    gateway: string;
+    namespace: string;
+    connections: number;
+    timestamp: number;
+}
+/** Individual gateway event flow. */
+interface GatewayMessagePayload {
+    projectId: string;
+    gateway: string;
+    event: string;
+    direction: 'received' | 'sent';
+    payloadSize: number;
+    error?: string;
+    duration?: number;
+    requestId?: string;
+    timestamp: number;
+}
+/** Point-in-time process metrics. */
+interface PerformanceSnapshot {
+    projectId: string;
+    timestamp: number;
+    cpuPercent: number;
+    memoryUsedBytes: number;
+    memoryTotalBytes: number;
+    heapUsedBytes: number;
+    heapTotalBytes: number;
+    eventLoopLagMs: number;
+    activeRequests: number;
+    requestsPerSecond: number;
+    averageLatencyMs: number;
+    p95LatencyMs: number;
+    p99LatencyMs: number;
+    errorsPerSecond: number;
+    /** true when the process reports memory pressure */
+    memoryPressure?: boolean;
+}
+/** Static description of the NestJS application graph. */
+interface AppSnapshot {
+    projectId: string;
+    projectName: string;
+    modules: AppModuleNode[];
+    nestjsVersion: string | null;
+    capturedAt: number;
+}
+/** A module and its members in the application graph. */
+interface AppModuleNode {
+    name: string;
+    imports: string[];
+    controllers: AppMemberNode[];
+    providers: AppMemberNode[];
+    exports: string[];
+}
+/** A member (controller/provider/guard/pipe/...) inside a module. */
+interface AppMemberNode {
+    name: string;
+    type: 'controller' | 'provider' | 'guard' | 'interceptor' | 'pipe' | 'filter' | 'gateway';
+    routes?: string[];
+}
+/** What a dashboard/control client announces when it connects. */
+interface ClientHello {
+    kind: 'dashboard' | 'cli' | 'other';
+    name?: string;
+    version?: string;
+}
+/** Full server state handed to newly connected dashboards. */
+interface StateSnapshot {
+    projects: ProjectInfo[];
+    requests: RequestCompletedPayload[];
+    logs: LogPayload[];
+    errors: ErrorPayload[];
+    queries: QueryPayload[];
+    performance: Record<string, PerformanceSnapshot>;
+    apps: Record<string, AppSnapshot>;
+}
+
+/** Const array of every event name (runtime mirror of the type union). */
+declare const DEVTOOLS_EVENTS: readonly ["project.connected", "project.disconnected", "request.started", "request.completed", "log.created", "error.created", "query.executed", "websocket.connected", "websocket.message", "performance.updated", "app.snapshot", "client.hello", "client.welcome", "stream.pause", "stream.resume", "state.clear", "state.snapshot", "state.ack", "error"];
+/** True when `name` is a known protocol event. */
+declare function isDevToolsEventName(name: string): name is DevToolsEventName;
+/** Build a fully-typed wire message. */
+declare function createMessage<K extends DevToolsEventName>(event: K, payload: DevToolsEventMap[K], options?: {
+    projectId?: string;
+    id?: string;
+    ts?: number;
+}): DevToolsMessage<DevToolsEventMap[K]>;
+/** Cheap collision-resistant id (no crypto dependency needed for wire correlation). */
+declare function randomId(prefix?: string): string;
+/** Type guard narrowing an unknown parsed frame into a DevToolsMessage. */
+declare function parseMessage(raw: string): DevToolsMessage | null;
+
+/** Default keys that are always redacted unless explicitly allowed. */
+declare const DEFAULT_REDACT_KEYS: readonly ["password", "token", "access_token", "accessToken", "refresh_token", "refreshToken", "authorization", "cookie", "cookies", "secret", "apiKey", "api_key", "client_secret", "clientSecret", "private_key", "privateKey", "session", "set-cookie"];
+/** Default capture ceilings shared by SDK and server. */
+declare const MAX_CAPTURE_BYTES: number;
+declare const MAX_DEPTH = 4;
+/** Options for deep redaction of arbitrary values. */
+interface RedactOptions {
+    /** Extra key names to redact (case-insensitive, partial match allowed). */
+    redact?: string[];
+    /** Keys that should never be redacted even if they look sensitive. */
+    allow?: string[];
+    /** Placeholder string used for redacted values. */
+    placeholder?: string;
+    /** Max serialized size before truncation. */
+    maxBytes?: number;
+    /** Max object depth. */
+    maxDepth?: number;
+}
+/** Normalized set of denylist and allowlist key matchers. */
+declare class Redactor {
+    private readonly deny;
+    private readonly allow;
+    private readonly placeholder;
+    private readonly maxBytes;
+    private readonly maxDepth;
+    constructor(options?: RedactOptions);
+    /** True when the given key is sensitive and not allowed. */
+    isSensitive(key: string): boolean;
+    /**
+     * Deep-copy a value while redacting sensitive keys, truncating oversized
+     * strings and enforcing depth limits. Circular references become '[Circular]'.
+     */
+    redact(value: unknown, depth?: number, seen?: Set<unknown>): unknown;
+    /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */
+    redactString(text: string): string;
+    /** Serialize a value safely: redacted, size-capped, never throws. */
+    serialize(value: unknown): string;
+}
+/** Shared default redactor instance for quick helpers. */
+declare const defaultRedactor: Redactor;
+/** Convenience: deep-redact with the default policy. */
+declare function redactValue(value: unknown): unknown;
+/** Convenience: scrub a free-form string with the default policy. */
+declare function redactText(text: string): string;
+
+/**
+ * Deep links that open a file at a specific line/column in an editor.
+ * Paths are generated for the OS the DevTools *server* runs on — never assume
+ * Windows or POSIX layout; detect it at runtime.
+ */
+type EditorKind = 'vscode' | 'cursor' | 'zed' | 'sublime';
+/** Returns 'win32' | 'darwin' | 'linux' | 'unknown' without touching process when unavailable. */
+declare function detectPlatform(platformGetter?: () => string): 'win32' | 'darwin' | 'linux' | 'unknown';
+/**
+ * Build an editor deep link such as:
+ *   vscode://file/Users/me/app/src/users.service.ts:87:21
+ */
+declare function buildEditorUrl(editor: EditorKind, file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}, platformGetter?: () => string): string | null;
+/** First available vscode:// link for a source location. */
+declare function vscodeUrl(file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}): string | null;
+/** First available cursor:// link for a source location. */
+declare function cursorUrl(file: {
+    absolutePath?: string;
+    file?: string;
+    line?: number;
+    column?: number;
+}): string | null;
+
+export { type AppMemberNode, type AppModuleNode, type AppSnapshot, type ClientHello, DEFAULT_REDACT_KEYS, DEVTOOLS_EVENTS, type DevToolsEvent, type DevToolsEventMap, type DevToolsEventName, type DevToolsMessage, type EditorKind, type ErrorPayload, type GatewayConnectionPayload, type GatewayMessagePayload, type LogLevel, type LogPayload, MAX_CAPTURE_BYTES, MAX_DEPTH, PROTOCOL_VERSION, type PerformanceSnapshot, type ProjectInfo, type QueryPayload, type RedactOptions, Redactor, type RequestCompletedPayload, type RequestStartedPayload, type SourceLocation, type StateSnapshot, type TimelineSpan, buildEditorUrl, createMessage, cursorUrl, defaultRedactor, detectPlatform, isDevToolsEventName, parseMessage, randomId, redactText, redactValue, vscodeUrl };

package/dist/index.js

@@ -0,0 +1,239 @@
+// src/types.ts
+var PROTOCOL_VERSION = 1;
+
+// src/events.ts
+var DEVTOOLS_EVENTS = [
+  "project.connected",
+  "project.disconnected",
+  "request.started",
+  "request.completed",
+  "log.created",
+  "error.created",
+  "query.executed",
+  "websocket.connected",
+  "websocket.message",
+  "performance.updated",
+  "app.snapshot",
+  "client.hello",
+  "client.welcome",
+  "stream.pause",
+  "stream.resume",
+  "state.clear",
+  "state.snapshot",
+  "state.ack",
+  "error"
+];
+function isDevToolsEventName(name) {
+  return DEVTOOLS_EVENTS.includes(name);
+}
+function createMessage(event, payload, options) {
+  return {
+    v: PROTOCOL_VERSION,
+    id: options?.id ?? randomId(),
+    projectId: options?.projectId,
+    ts: options?.ts ?? Date.now(),
+    event,
+    payload
+  };
+}
+function randomId(prefix) {
+  const core = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function" ? crypto.randomUUID().replace(/-/g, "").slice(0, 16) : Math.random().toString(36).slice(2, 10) + Date.now().toString(36);
+  return prefix ? `${prefix}_${core}` : core;
+}
+function parseMessage(raw) {
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "object" && parsed !== null && "event" in parsed && "payload" in parsed && isDevToolsEventName(String(parsed.event))) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+// src/redact.ts
+var DEFAULT_REDACT_KEYS = [
+  "password",
+  "token",
+  "access_token",
+  "accessToken",
+  "refresh_token",
+  "refreshToken",
+  "authorization",
+  "cookie",
+  "cookies",
+  "secret",
+  "apiKey",
+  "api_key",
+  "client_secret",
+  "clientSecret",
+  "private_key",
+  "privateKey",
+  "session",
+  "set-cookie"
+];
+var MAX_CAPTURE_BYTES = 4 * 1024;
+var MAX_DEPTH = 4;
+var DEFAULT_PLACEHOLDER = "[REDACTED]";
+var TRUNCATION_SUFFIX = "\u2026[truncated]";
+var Redactor = class {
+  deny;
+  allow;
+  placeholder;
+  maxBytes;
+  maxDepth;
+  constructor(options) {
+    this.deny = new Set([...DEFAULT_REDACT_KEYS, ...options?.redact ?? []].map(normalizeKey));
+    this.allow = new Set((options?.allow ?? []).map(normalizeKey));
+    this.placeholder = options?.placeholder ?? DEFAULT_PLACEHOLDER;
+    this.maxBytes = options?.maxBytes ?? MAX_CAPTURE_BYTES;
+    this.maxDepth = options?.maxDepth ?? MAX_DEPTH;
+  }
+  /** True when the given key is sensitive and not allowed. */
+  isSensitive(key) {
+    const normalized = normalizeKey(key);
+    if (this.allow.has(normalized)) return false;
+    if (this.deny.has(normalized)) return true;
+    for (const denied of this.deny) {
+      if (normalized.includes(denied)) return true;
+    }
+    return false;
+  }
+  /**
+   * Deep-copy a value while redacting sensitive keys, truncating oversized
+   * strings and enforcing depth limits. Circular references become '[Circular]'.
+   */
+  redact(value, depth = 0, seen = /* @__PURE__ */ new Set()) {
+    if (value === null || typeof value !== "object") {
+      return redactPrimitive(value);
+    }
+    if (seen.has(value)) return "[Circular]";
+    if (depth >= this.maxDepth) return "[MaxDepth]";
+    seen.add(value);
+    try {
+      if (Array.isArray(value)) {
+        return value.slice(0, 50).map((item) => this.redact(item, depth + 1, seen));
+      }
+      if (value instanceof Error) {
+        return { name: value.name, message: value.message };
+      }
+      if (value instanceof Date) return value.toISOString();
+      const out = {};
+      for (const [key, raw] of Object.entries(value)) {
+        out[key] = this.isSensitive(key) ? this.placeholder : this.redact(raw, depth + 1, seen);
+      }
+      return out;
+    } finally {
+      seen.delete(value);
+    }
+  }
+  /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */
+  redactString(text) {
+    let out = text;
+    for (const denied of this.deny) {
+      const camel = denied;
+      const pattern = new RegExp(`(${escapeRegExp(camel)}|${escapeRegExp(denied.replace(/[-_]/g, ""))})\\s*[=:]\\s*([^\\s,&;]+)`, "gi");
+      out = out.replace(pattern, `$1=${this.placeholder}`);
+    }
+    out = out.replace(/bearer\s+[a-z0-9._-]+/gi, `Bearer ${this.placeholder}`);
+    return out;
+  }
+  /** Serialize a value safely: redacted, size-capped, never throws. */
+  serialize(value) {
+    try {
+      const safe = this.redact(value);
+      const json = JSON.stringify(safe) ?? String(safe);
+      return truncateUtf8(json, this.maxBytes, TRUNCATION_SUFFIX);
+    } catch {
+      return "[Unserializable]";
+    }
+  }
+};
+var defaultRedactor = new Redactor();
+function redactValue(value) {
+  return defaultRedactor.redact(value);
+}
+function redactText(text) {
+  return defaultRedactor.redactString(text);
+}
+function redactPrimitive(value) {
+  if (typeof value === "string") return defaultRedactor.redactString(value);
+  if (typeof value === "number" || typeof value === "boolean" || value === null) return value;
+  if (typeof value === "function") return "[Function]";
+  if (typeof value === "bigint") return value.toString() + "n";
+  return String(value);
+}
+function normalizeKey(key) {
+  return key.toLowerCase().replace(/[-_\s]/g, "");
+}
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function truncateUtf8(text, maxBytes, suffix) {
+  const buf = Buffer.from(text, "utf8");
+  if (buf.length <= maxBytes) return text;
+  const cut = Math.max(0, maxBytes - Buffer.byteLength(suffix, "utf8"));
+  return buf.subarray(0, cut).toString("utf8") + suffix;
+}
+
+// src/editor-urls.ts
+var EDITOR_SCHEMES = {
+  vscode: "vscode",
+  cursor: "cursor",
+  zed: "zed",
+  sublime: "subl"
+};
+function detectPlatform(platformGetter) {
+  try {
+    const platform = platformGetter ? platformGetter() : process.platform;
+    if (platform === "win32" || platform === "darwin" || platform === "linux") return platform;
+    return "unknown";
+  } catch {
+    return "unknown";
+  }
+}
+function encodeFilePath(absolutePath, platform) {
+  const normalized = platform === "win32" ? absolutePath.replace(/\\/g, "/") : absolutePath;
+  const withDrive = platform === "win32" && /^[A-Za-z]:\//.test(normalized) ? `/${normalized}` : normalized;
+  return withDrive.replace(/^\//, "").split("/").map((segment, index) => index === 0 && /^[A-Za-z]:$/.test(segment) ? segment : encodeURIComponent(segment)).join("/");
+}
+function buildEditorUrl(editor, file, platformGetter) {
+  const absolutePath = file.absolutePath ?? file.file;
+  if (!absolutePath) return null;
+  const platform = detectPlatform(platformGetter);
+  const scheme = EDITOR_SCHEMES[editor];
+  const path = encodeFilePath(absolutePath, platform);
+  const line = file.line ?? 1;
+  const column = file.column ?? 1;
+  if (editor === "sublime") {
+    return `subl://open?url=file://${path}&line=${line}&column=${column}`;
+  }
+  return `${scheme}://file/${path}:${line}:${column}`;
+}
+function vscodeUrl(file) {
+  return buildEditorUrl("vscode", file);
+}
+function cursorUrl(file) {
+  return buildEditorUrl("cursor", file);
+}
+export {
+  DEFAULT_REDACT_KEYS,
+  DEVTOOLS_EVENTS,
+  MAX_CAPTURE_BYTES,
+  MAX_DEPTH,
+  PROTOCOL_VERSION,
+  Redactor,
+  buildEditorUrl,
+  createMessage,
+  cursorUrl,
+  defaultRedactor,
+  detectPlatform,
+  isDevToolsEventName,
+  parseMessage,
+  randomId,
+  redactText,
+  redactValue,
+  vscodeUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/events.ts","../src/redact.ts","../src/editor-urls.ts"],"sourcesContent":["/** Wire protocol version. Bump on breaking payload changes. */\nexport const PROTOCOL_VERSION = 1 as const;\n\n/** JSON-RPC-ish envelope shared by every message on the wire. */\nexport interface DevToolsMessage<T = unknown> {\n  /** Envelope format version. */\n  v: typeof PROTOCOL_VERSION;\n  /** Unique message id. */\n  id: string;\n  /** Originating project (absent for client->server handshake-less control traffic). */\n  projectId?: string;\n  /** Milliseconds since epoch. */\n  ts: number;\n  /** Event discriminator. */\n  event: DevToolsEventName;\n  /** Event payload. */\n  payload: T;\n}\n\n/** All event names supported by protocol v1. */\nexport type DevToolsEventName =\n  // lifecycle\n  | 'project.connected'\n  | 'project.disconnected'\n  // http\n  | 'request.started'\n  | 'request.completed'\n  // observability\n  | 'log.created'\n  | 'error.created'\n  | 'query.executed'\n  // realtime\n  | 'websocket.connected'\n  | 'websocket.message'\n  // perf\n  | 'performance.updated'\n  // application graph\n  | 'app.snapshot'\n  // control plane\n  | 'client.hello'\n  | 'client.welcome'\n  | 'stream.pause'\n  | 'stream.resume'\n  | 'state.clear'\n  | 'state.snapshot'\n  | 'state.ack'\n  | 'error';\n\n/** Union of every typed payload keyed by its event name. */\nexport interface DevToolsEventMap {\n  'project.connected': ProjectInfo;\n  'project.disconnected': { projectId: string; reason?: string };\n  'request.started': RequestStartedPayload;\n  'request.completed': RequestCompletedPayload;\n  'log.created': LogPayload;\n  'error.created': ErrorPayload;\n  'query.executed': QueryPayload;\n  'websocket.connected': GatewayConnectionPayload;\n  'websocket.message': GatewayMessagePayload;\n  'performance.updated': PerformanceSnapshot;\n  'app.snapshot': AppSnapshot;\n  'client.hello': ClientHello;\n  'client.welcome': { serverVersion: string; protocol: typeof PROTOCOL_VERSION };\n  'stream.pause': Record<string, never>;\n  'stream.resume': Record<string, never>;\n  'state.clear': { scope: 'logs' | 'requests' | 'errors' | 'queries' | 'all' };\n  'state.snapshot': StateSnapshot;\n  'state.ack': { ok: true };\n  error: { code: string; message: string };\n}\n\n/** Discriminated union of all wire messages. */\nexport type DevToolsEvent = {\n  [K in DevToolsEventName]: DevToolsMessage<DevToolsEventMap[K]>;\n}[DevToolsEventName];\n\n/** Metadata every NestJS application reports when it connects. */\nexport interface ProjectInfo {\n  projectId: string;\n  projectName: string;\n  environment: string;\n  hostname: string;\n  port: number | null;\n  pid: number;\n  runtime: string;\n  runtimeVersion: string;\n  nodeVersion: string;\n  nestjsVersion: string | null;\n  sdkVersion: string;\n}\n\n/** One timeline entry of a request (guard, interceptor, service call...). */\nexport interface TimelineSpan {\n  /** Logical layer, e.g. 'middleware' | 'guard' | 'interceptor' | 'pipe' | 'controller' | 'service' | 'database' | 'response'. */\n  layer: string;\n  /** Human label, e.g. 'JwtAuthGuard' or 'SELECT users'. */\n  label: string;\n  /** ms */\n  duration: number;\n  startedAt: number;\n  status?: 'ok' | 'error';\n  detail?: string;\n}\n\n/** Emitted the moment a request enters the SDK. */\nexport interface RequestStartedPayload {\n  requestId: string;\n  projectId: string;\n  method: string;\n  url: string;\n  route?: string;\n  httpVersion?: string;\n  headers: Record<string, string>;\n  query: Record<string, unknown>;\n  params?: Record<string, unknown>;\n  ip?: string;\n  userAgent?: string;\n  startedAt: number;\n}\n\n/** Emitted when the response finishes. */\nexport interface RequestCompletedPayload {\n  requestId: string;\n  projectId: string;\n  method: string;\n  url: string;\n  route?: string;\n  statusCode: number;\n  duration: number;\n  startedAt: number;\n  timeline: TimelineSpan[];\n  query?: Record<string, unknown>;\n  responsePreview?: string;\n  responseBody?: unknown;\n  requestBody?: unknown;\n  errored: boolean;\n}\n\n/** A captured console or logger entry. */\nexport interface LogPayload {\n  requestId?: string;\n  projectId: string;\n  level: LogLevel;\n  message: string;\n  arguments?: unknown[];\n  stack?: string;\n  source?: SourceLocation;\n  context?: string;\n  processId: number;\n  timestamp: number;\n}\n\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'verbose';\n\n/** File/line/column triple resolved from source maps when available. */\nexport interface SourceLocation {\n  file: string;\n  line: number;\n  column: number;\n  /** Absolute path when resolvable on the host machine. */\n  absolutePath?: string;\n  /** function name if the stack exposed one */\n  function?: string;\n}\n\n/** A captured exception with source mapping. */\nexport interface ErrorPayload {\n  requestId?: string;\n  projectId: string;\n  name: string;\n  message: string;\n  stack?: string;\n  source?: SourceLocation;\n  /** stable hash for grouping identical errors */\n  fingerprint: string;\n  context?: string;\n  request?: { method: string; url: string; statusCode?: number };\n  controller?: string;\n  service?: string;\n  timestamp: number;\n  /** server-side occurrence count for grouped errors */\n  occurrences?: number;\n}\n\n/** A captured database query. */\nexport interface QueryPayload {\n  requestId?: string;\n  projectId: string;\n  provider: 'prisma' | 'typeorm' | 'sequelize' | 'mikroorm' | 'other';\n  sql: string;\n  duration: number;\n  database?: string;\n  parameters?: unknown[];\n  timestamp: number;\n}\n\n/** Gateway-level connection snapshot. */\nexport interface GatewayConnectionPayload {\n  projectId: string;\n  gateway: string;\n  namespace: string;\n  connections: number;\n  timestamp: number;\n}\n\n/** Individual gateway event flow. */\nexport interface GatewayMessagePayload {\n  projectId: string;\n  gateway: string;\n  event: string;\n  direction: 'received' | 'sent';\n  payloadSize: number;\n  error?: string;\n  duration?: number;\n  requestId?: string;\n  timestamp: number;\n}\n\n/** Point-in-time process metrics. */\nexport interface PerformanceSnapshot {\n  projectId: string;\n  timestamp: number;\n  cpuPercent: number;\n  memoryUsedBytes: number;\n  memoryTotalBytes: number;\n  heapUsedBytes: number;\n  heapTotalBytes: number;\n  eventLoopLagMs: number;\n  activeRequests: number;\n  requestsPerSecond: number;\n  averageLatencyMs: number;\n  p95LatencyMs: number;\n  p99LatencyMs: number;\n  errorsPerSecond: number;\n  /** true when the process reports memory pressure */\n  memoryPressure?: boolean;\n}\n\n/** Static description of the NestJS application graph. */\nexport interface AppSnapshot {\n  projectId: string;\n  projectName: string;\n  modules: AppModuleNode[];\n  nestjsVersion: string | null;\n  capturedAt: number;\n}\n\n/** A module and its members in the application graph. */\nexport interface AppModuleNode {\n  name: string;\n  imports: string[];\n  controllers: AppMemberNode[];\n  providers: AppMemberNode[];\n  exports: string[];\n}\n\n/** A member (controller/provider/guard/pipe/...) inside a module. */\nexport interface AppMemberNode {\n  name: string;\n  type: 'controller' | 'provider' | 'guard' | 'interceptor' | 'pipe' | 'filter' | 'gateway';\n  routes?: string[];\n}\n\n/** What a dashboard/control client announces when it connects. */\nexport interface ClientHello {\n  kind: 'dashboard' | 'cli' | 'other';\n  name?: string;\n  version?: string;\n}\n\n/** Full server state handed to newly connected dashboards. */\nexport interface StateSnapshot {\n  projects: ProjectInfo[];\n  requests: RequestCompletedPayload[];\n  logs: LogPayload[];\n  errors: ErrorPayload[];\n  queries: QueryPayload[];\n  performance: Record<string, PerformanceSnapshot>;\n  apps: Record<string, AppSnapshot>;\n}\n","import type { DevToolsEventMap, DevToolsEventName, DevToolsMessage } from './types';\nimport { PROTOCOL_VERSION } from './types';\n\n/** Const array of every event name (runtime mirror of the type union). */\nexport const DEVTOOLS_EVENTS = [\n  'project.connected',\n  'project.disconnected',\n  'request.started',\n  'request.completed',\n  'log.created',\n  'error.created',\n  'query.executed',\n  'websocket.connected',\n  'websocket.message',\n  'performance.updated',\n  'app.snapshot',\n  'client.hello',\n  'client.welcome',\n  'stream.pause',\n  'stream.resume',\n  'state.clear',\n  'state.snapshot',\n  'state.ack',\n  'error',\n] as const satisfies readonly DevToolsEventName[];\n\n/** True when `name` is a known protocol event. */\nexport function isDevToolsEventName(name: string): name is DevToolsEventName {\n  return (DEVTOOLS_EVENTS as readonly string[]).includes(name);\n}\n\n/** Build a fully-typed wire message. */\nexport function createMessage<K extends DevToolsEventName>(\n  event: K,\n  payload: DevToolsEventMap[K],\n  options?: { projectId?: string; id?: string; ts?: number },\n): DevToolsMessage<DevToolsEventMap[K]> {\n  return {\n    v: PROTOCOL_VERSION,\n    id: options?.id ?? randomId(),\n    projectId: options?.projectId,\n    ts: options?.ts ?? Date.now(),\n    event,\n    payload,\n  };\n}\n\n/** Cheap collision-resistant id (no crypto dependency needed for wire correlation). */\nexport function randomId(prefix?: string): string {\n  const core =\n    typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function'\n      ? crypto.randomUUID().replace(/-/g, '').slice(0, 16)\n      : Math.random().toString(36).slice(2, 10) + Date.now().toString(36);\n  return prefix ? `${prefix}_${core}` : core;\n}\n\n/** Type guard narrowing an unknown parsed frame into a DevToolsMessage. */\nexport function parseMessage(raw: string): DevToolsMessage | null {\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    if (\n      typeof parsed === 'object' &&\n      parsed !== null &&\n      'event' in parsed &&\n      'payload' in parsed &&\n      isDevToolsEventName(String((parsed as { event: unknown }).event))\n    ) {\n      return parsed as DevToolsMessage;\n    }\n    return null;\n  } catch {\n    return null;\n  }\n}\n","/** Default keys that are always redacted unless explicitly allowed. */\nexport const DEFAULT_REDACT_KEYS = [\n  'password',\n  'token',\n  'access_token',\n  'accessToken',\n  'refresh_token',\n  'refreshToken',\n  'authorization',\n  'cookie',\n  'cookies',\n  'secret',\n  'apiKey',\n  'api_key',\n  'client_secret',\n  'clientSecret',\n  'private_key',\n  'privateKey',\n  'session',\n  'set-cookie',\n] as const;\n\n/** Default capture ceilings shared by SDK and server. */\nexport const MAX_CAPTURE_BYTES = 4 * 1024;\nexport const MAX_DEPTH = 4;\n\n/** Options for deep redaction of arbitrary values. */\nexport interface RedactOptions {\n  /** Extra key names to redact (case-insensitive, partial match allowed). */\n  redact?: string[];\n  /** Keys that should never be redacted even if they look sensitive. */\n  allow?: string[];\n  /** Placeholder string used for redacted values. */\n  placeholder?: string;\n  /** Max serialized size before truncation. */\n  maxBytes?: number;\n  /** Max object depth. */\n  maxDepth?: number;\n}\n\nconst DEFAULT_PLACEHOLDER = '[REDACTED]';\nconst TRUNCATION_SUFFIX = '…[truncated]';\n\n/** Normalized set of denylist and allowlist key matchers. */\nexport class Redactor {\n  private readonly deny: Set<string>;\n  private readonly allow: Set<string>;\n  private readonly placeholder: string;\n  private readonly maxBytes: number;\n  private readonly maxDepth: number;\n\n  constructor(options?: RedactOptions) {\n    this.deny = new Set([...DEFAULT_REDACT_KEYS, ...(options?.redact ?? [])].map(normalizeKey));\n    this.allow = new Set((options?.allow ?? []).map(normalizeKey));\n    this.placeholder = options?.placeholder ?? DEFAULT_PLACEHOLDER;\n    this.maxBytes = options?.maxBytes ?? MAX_CAPTURE_BYTES;\n    this.maxDepth = options?.maxDepth ?? MAX_DEPTH;\n  }\n\n  /** True when the given key is sensitive and not allowed. */\n  isSensitive(key: string): boolean {\n    const normalized = normalizeKey(key);\n    if (this.allow.has(normalized)) return false;\n    if (this.deny.has(normalized)) return true;\n    // partial match: `userPassword`, `authTokenValue`, `x-api-key`...\n    for (const denied of this.deny) {\n      if (normalized.includes(denied)) return true;\n    }\n    return false;\n  }\n\n  /**\n   * Deep-copy a value while redacting sensitive keys, truncating oversized\n   * strings and enforcing depth limits. Circular references become '[Circular]'.\n   */\n  redact(value: unknown, depth = 0, seen = new Set<unknown>()): unknown {\n    if (value === null || typeof value !== 'object') {\n      return redactPrimitive(value);\n    }\n    if (seen.has(value)) return '[Circular]';\n    if (depth >= this.maxDepth) return '[MaxDepth]';\n\n    seen.add(value);\n    try {\n      if (Array.isArray(value)) {\n        return value.slice(0, 50).map((item) => this.redact(item, depth + 1, seen));\n      }\n      if (value instanceof Error) {\n        return { name: value.name, message: value.message };\n      }\n      if (value instanceof Date) return value.toISOString();\n\n      const out: Record<string, unknown> = {};\n      for (const [key, raw] of Object.entries(value as Record<string, unknown>)) {\n        out[key] = this.isSensitive(key) ? this.placeholder : this.redact(raw, depth + 1, seen);\n      }\n      return out;\n    } finally {\n      seen.delete(value);\n    }\n  }\n\n  /** Redact sensitive substrings (key=value / key: value / bearer tokens) from free-form text. */\n  redactString(text: string): string {\n    let out = text;\n    for (const denied of this.deny) {\n      const camel = denied;\n      const pattern = new RegExp(`(${escapeRegExp(camel)}|${escapeRegExp(denied.replace(/[-_]/g, ''))})\\\\s*[=:]\\\\s*([^\\\\s,&;]+)`, 'gi');\n      out = out.replace(pattern, `$1=${this.placeholder}`);\n    }\n    out = out.replace(/bearer\\s+[a-z0-9._-]+/gi, `Bearer ${this.placeholder}`);\n    return out;\n  }\n\n  /** Serialize a value safely: redacted, size-capped, never throws. */\n  serialize(value: unknown): string {\n    try {\n      const safe = this.redact(value);\n      const json = JSON.stringify(safe) ?? String(safe);\n      return truncateUtf8(json, this.maxBytes, TRUNCATION_SUFFIX);\n    } catch {\n      return '[Unserializable]';\n    }\n  }\n}\n\n/** Shared default redactor instance for quick helpers. */\nexport const defaultRedactor = new Redactor();\n\n/** Convenience: deep-redact with the default policy. */\nexport function redactValue(value: unknown): unknown {\n  return defaultRedactor.redact(value);\n}\n\n/** Convenience: scrub a free-form string with the default policy. */\nexport function redactText(text: string): string {\n  return defaultRedactor.redactString(text);\n}\n\nfunction redactPrimitive(value: unknown): unknown {\n  if (typeof value === 'string') return defaultRedactor.redactString(value);\n  if (typeof value === 'number' || typeof value === 'boolean' || value === null) return value;\n  if (typeof value === 'function') return '[Function]';\n  if (typeof value === 'bigint') return value.toString() + 'n';\n  return String(value);\n}\n\nfunction normalizeKey(key: string): string {\n  return key.toLowerCase().replace(/[-_\\s]/g, '');\n}\n\nfunction escapeRegExp(text: string): string {\n  return text.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n}\n\n/** UTF-8-safe truncation that never splits a multi-byte character. */\nfunction truncateUtf8(text: string, maxBytes: number, suffix: string): string {\n  const buf = Buffer.from(text, 'utf8');\n  if (buf.length <= maxBytes) return text;\n  const cut = Math.max(0, maxBytes - Buffer.byteLength(suffix, 'utf8'));\n  return buf.subarray(0, cut).toString('utf8') + suffix;\n}\n","/**\n * Deep links that open a file at a specific line/column in an editor.\n * Paths are generated for the OS the DevTools *server* runs on — never assume\n * Windows or POSIX layout; detect it at runtime.\n */\n\nexport type EditorKind = 'vscode' | 'cursor' | 'zed' | 'sublime';\n\nconst EDITOR_SCHEMES: Record<EditorKind, string> = {\n  vscode: 'vscode',\n  cursor: 'cursor',\n  zed: 'zed',\n  sublime: 'subl',\n};\n\n/** Returns 'win32' | 'darwin' | 'linux' | 'unknown' without touching process when unavailable. */\nexport function detectPlatform(platformGetter?: () => string): 'win32' | 'darwin' | 'linux' | 'unknown' {\n  try {\n    const platform = platformGetter ? platformGetter() : process.platform;\n    if (platform === 'win32' || platform === 'darwin' || platform === 'linux') return platform;\n    return 'unknown';\n  } catch {\n    return 'unknown';\n  }\n}\n\nfunction encodeFilePath(absolutePath: string, platform: string): string {\n  // VS Code expects forward slashes; keep drive letters like /C:/... on Windows.\n  const normalized = platform === 'win32' ? absolutePath.replace(/\\\\/g, '/') : absolutePath;\n  const withDrive = platform === 'win32' && /^[A-Za-z]:\\//.test(normalized) ? `/${normalized}` : normalized;\n  // the scheme already carries 'file/', so drop any leading slash;\n  // preserve the drive-letter colon (C:) which VS Code expects unencoded\n  return withDrive\n    .replace(/^\\//, '')\n    .split('/')\n    .map((segment, index) => (index === 0 && /^[A-Za-z]:$/.test(segment) ? segment : encodeURIComponent(segment)))\n    .join('/');\n}\n\n/**\n * Build an editor deep link such as:\n *   vscode://file/Users/me/app/src/users.service.ts:87:21\n */\nexport function buildEditorUrl(\n  editor: EditorKind,\n  file: { absolutePath?: string; file?: string; line?: number; column?: number },\n  platformGetter?: () => string,\n): string | null {\n  const absolutePath = file.absolutePath ?? file.file;\n  if (!absolutePath) return null;\n\n  const platform = detectPlatform(platformGetter);\n  const scheme = EDITOR_SCHEMES[editor];\n  const path = encodeFilePath(absolutePath, platform);\n  const line = file.line ?? 1;\n  const column = file.column ?? 1;\n\n  if (editor === 'sublime') {\n    return `subl://open?url=file://${path}&line=${line}&column=${column}`;\n  }\n  return `${scheme}://file/${path}:${line}:${column}`;\n}\n\n/** First available vscode:// link for a source location. */\nexport function vscodeUrl(file: { absolutePath?: string; file?: string; line?: number; column?: number }): string | null {\n  return buildEditorUrl('vscode', file);\n}\n\n/** First available cursor:// link for a source location. */\nexport function cursorUrl(file: { absolutePath?: string; file?: string; line?: number; column?: number }): string | null {\n  return buildEditorUrl('cursor', file);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@angelitosystems/devtools-protocol",
+  "version": "0.1.0",
+  "description": "Typed WebSocket protocol shared by the NestJS DevTools SDK, server and dashboard.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --sourcemap",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.7.0"
+  }
+}