browsertrack 0.0.1 → 0.1.1

package/dist/core/index.d.ts

@@ -0,0 +1,86 @@
+export { B as Breadcrumb, C as CaptureElementParams, a as CaptureElementResult, b as ClientCommand, c as ClientEventMessage, d as CommandResponse, e as CommandType, f as ConsoleEvent, g as ConsoleLevel, D as DOMRectJson, E as ElementContext, h as ElementStyleResult, i as ElementSummary, j as EventType, H as HelloMessage, N as NavigateParams, k as NavigationEvent, l as NetworkEvent, m as NoteStatus, n as NoteTarget, o as NoteType, p as NoteVerificationResult, O as OverflowCheckResult, P as PageStateResult, Q as QueryElementParams, q as QueryElementResult, R as RegionContext, r as ReloadParams, s as RuntimeErrorEvent, S as ScrollContext, V as ViewportContext, t as VisualNote } from '../notes-CBvN91Wf.js';
+export { I as Incident, a as IncidentOccurrence, b as IncidentSeverity, c as IncidentSource, d as IncidentStatus, P as ProbeResult, e as ProbeType, f as Project, S as Session, V as VerificationProbe, g as VerificationRecipe, h as VerificationResult } from '../projects-CY8ungMt.js';
+import { Rules } from '@visulima/redact';
+export { Rules, standardRules, redact as visulimaRedact } from '@visulima/redact';
+
+/**
+ * Error fingerprinting and normalization utilities
+ */
+interface FingerprintInput {
+    type: string;
+    message: string;
+    sourceFile?: string;
+    line?: number;
+    column?: number;
+    stack?: string;
+}
+/**
+ * Normalizes error messages by stripping dynamic content like UUIDs, timestamps,
+ * hex addresses, and file timestamps.
+ */
+declare function normalizeErrorMessage(message: string): string;
+/**
+ * Normalizes source filenames by removing origin and cache-busting query strings.
+ */
+declare function normalizeSourceFile(filename?: string): string;
+/**
+ * Extracts source location from stack if not explicitly provided
+ */
+declare function extractSourceFromStack(stack?: string): {
+    file: string;
+    line: number;
+    column?: number;
+} | null;
+/**
+ * Computes a deterministic fingerprint for an error
+ */
+declare function computeFingerprint(input: FingerprintInput): string;
+
+/**
+ * Security and Redaction Utilities powered by @visulima/redact
+ */
+declare const REDACTED_PLACEHOLDER = "[REDACTED]";
+declare const SENSITIVE_KEY_PATTERNS: RegExp[];
+declare const SENSITIVE_QUERY_PARAMS: string[];
+/**
+ * Developer security rules for @visulima/redact
+ */
+declare const BROWSER_SECURITY_RULES: Rules;
+
+/**
+ * Checks if a property name matches any sensitive pattern
+ */
+declare function isSensitiveKey(key: string): boolean;
+/**
+ * Redacts sensitive query parameters from a URL string
+ */
+declare function redactUrl(rawUrl: string): string;
+/**
+ * Redacts sensitive HTTP headers
+ */
+declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+/**
+ * Deeply redacts sensitive keys and payload data from an object or array,
+ * leveraging @visulima/redact rules combined with BrowserTrack URL/header sanitizers.
+ */
+declare function redactSensitiveData<T = any>(data: T, maxDepth?: number, currentDepth?: number): T;
+
+/**
+ * Semantic element selector generation and inspection
+ */
+interface SelectorOptions {
+    maxClasses?: number;
+    maxOuterHTMLLength?: number;
+    maxInnerTextLength?: number;
+}
+/**
+ * Builds a clean, human-readable semantic selector for a DOM element.
+ * Prioritizes data-testid/data-test, id, semantic tag + specific class, or concise parent path.
+ */
+declare function getSemanticSelector(element: HTMLElement | Element, options?: SelectorOptions): string;
+/**
+ * Truncates string to specified max length with ellipsis
+ */
+declare function truncate(str: string | undefined | null, maxLength?: number): string;
+
+export { BROWSER_SECURITY_RULES, type FingerprintInput, REDACTED_PLACEHOLDER, SENSITIVE_KEY_PATTERNS, SENSITIVE_QUERY_PARAMS, type SelectorOptions, computeFingerprint, extractSourceFromStack, getSemanticSelector, isSensitiveKey, normalizeErrorMessage, normalizeSourceFile, redactHeaders, redactSensitiveData, redactUrl, truncate };

package/dist/core/index.js

@@ -0,0 +1,37 @@
+import {
+  BROWSER_SECURITY_RULES,
+  REDACTED_PLACEHOLDER,
+  SENSITIVE_KEY_PATTERNS,
+  SENSITIVE_QUERY_PARAMS,
+  computeFingerprint,
+  extractSourceFromStack,
+  getSemanticSelector,
+  isSensitiveKey,
+  normalizeErrorMessage,
+  normalizeSourceFile,
+  redactHeaders,
+  redactSensitiveData,
+  redactUrl,
+  standardRules,
+  truncate,
+  visulimaRedact
+} from "../chunk-6VA7GBAO.js";
+export {
+  BROWSER_SECURITY_RULES,
+  REDACTED_PLACEHOLDER,
+  SENSITIVE_KEY_PATTERNS,
+  SENSITIVE_QUERY_PARAMS,
+  computeFingerprint,
+  extractSourceFromStack,
+  getSemanticSelector,
+  isSensitiveKey,
+  normalizeErrorMessage,
+  normalizeSourceFile,
+  redactHeaders,
+  redactSensitiveData,
+  redactUrl,
+  standardRules,
+  truncate,
+  visulimaRedact
+};
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/daemon/index.d.ts

@@ -0,0 +1,58 @@
+import { S as StorageDB, b as ScreenshotStore, a as SessionManager, c as NotesEngine, V as VerificationEngine, N as NoteVerificationEngine } from '../engine-CeT9URuN.js';
+import { c as ClientEventMessage } from '../notes-CBvN91Wf.js';
+import { I as Incident } from '../projects-CY8ungMt.js';
+import http from 'node:http';
+import { WebSocketServer } from 'ws';
+
+interface DaemonConfig {
+    host: string;
+    port: number;
+    dataDir: string;
+    dbPath: string;
+    screenshotsDir: string;
+    maxEventsPerSession: number;
+    verbose: boolean;
+}
+declare function getDaemonConfig(overrides?: Partial<DaemonConfig>): DaemonConfig;
+
+declare class IncidentEngine {
+    private db;
+    private screenshotStore;
+    constructor(db: StorageDB, screenshotStore: ScreenshotStore);
+    processClientEvent(message: ClientEventMessage & {
+        screenshot?: string;
+    }): Incident | null;
+    private handleErrorEvent;
+}
+
+declare function createHttpHandler(db: StorageDB, sessionManager: SessionManager, baseScreenshotsDir: string): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+
+declare function setupWebSocketServer(wss: WebSocketServer, db: StorageDB, sessionManager: SessionManager, incidentEngine: IncidentEngine, notesEngine?: NotesEngine, maxEventsPerSession?: number, verbose?: boolean): void;
+
+declare class BrowserTrackDaemon {
+    config: DaemonConfig;
+    db: StorageDB;
+    screenshotStore: ScreenshotStore;
+    sessionManager: SessionManager;
+    incidentEngine: IncidentEngine;
+    notesEngine: NotesEngine;
+    verificationEngine: VerificationEngine;
+    noteVerificationEngine: NoteVerificationEngine;
+    private httpServer;
+    private wss;
+    private isRunning;
+    constructor(config?: Partial<DaemonConfig>);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): {
+        isRunning: boolean;
+        host: string;
+        port: number;
+        activeSessions: number;
+        dbPath: string;
+    };
+}
+
+declare function createDaemon(config?: Partial<DaemonConfig>): BrowserTrackDaemon;
+
+export { BrowserTrackDaemon, type DaemonConfig, IncidentEngine, NoteVerificationEngine, NotesEngine, ScreenshotStore, SessionManager, StorageDB, VerificationEngine, createDaemon, createHttpHandler, getDaemonConfig, setupWebSocketServer };

package/dist/daemon/index.js

@@ -0,0 +1,32 @@
+import {
+  BrowserTrackDaemon,
+  IncidentEngine,
+  createDaemon,
+  createHttpHandler,
+  setupWebSocketServer
+} from "../chunk-SPCIROIU.js";
+import "../chunk-6VA7GBAO.js";
+import {
+  NoteVerificationEngine,
+  NotesEngine,
+  ScreenshotStore,
+  SessionManager,
+  StorageDB,
+  VerificationEngine,
+  getDaemonConfig
+} from "../chunk-ILRYKMME.js";
+export {
+  BrowserTrackDaemon,
+  IncidentEngine,
+  NoteVerificationEngine,
+  NotesEngine,
+  ScreenshotStore,
+  SessionManager,
+  StorageDB,
+  VerificationEngine,
+  createDaemon,
+  createHttpHandler,
+  getDaemonConfig,
+  setupWebSocketServer
+};
+//# sourceMappingURL=index.js.map

package/dist/daemon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/engine-CeT9URuN.d.ts

@@ -0,0 +1,161 @@
+import { B as Breadcrumb, i as ElementSummary, t as VisualNote, m as NoteStatus, p as NoteVerificationResult, d as CommandResponse, b as ClientCommand } from './notes-CBvN91Wf.js';
+import { f as Project, S as Session, I as Incident, d as IncidentStatus, b as IncidentSeverity, a as IncidentOccurrence, h as VerificationResult, g as VerificationRecipe } from './projects-CY8ungMt.js';
+import { WebSocket } from 'ws';
+
+declare class StorageDB {
+    private db;
+    constructor(dbPath: string);
+    private initTables;
+    upsertProject(project: {
+        id: string;
+        name: string;
+        origin: string;
+        path?: string;
+    }): Project;
+    getProject(idOrName: string): Project | null;
+    getProjectByOrigin(origin: string): Project | null;
+    listProjects(): Project[];
+    upsertSession(session: Session): void;
+    getSession(id: string): Session | null;
+    listSessions(projectId?: string, activeOnly?: boolean): Session[];
+    deactivateSession(id: string): void;
+    insertEvent(event: {
+        id: string;
+        sessionId: string;
+        eventType: string;
+        payload: any;
+        timestamp: number;
+        route?: string;
+        url?: string;
+    }): void;
+    pruneSessionEvents(sessionId: string, maxEvents?: number): void;
+    getEvents(options: {
+        sessionId?: string;
+        eventType?: string;
+        limit?: number;
+    }): any[];
+    findIncidentByFingerprint(fingerprint: string): Incident | null;
+    getIncident(id: string): Incident | null;
+    listIncidents(options?: {
+        projectId?: string;
+        status?: IncidentStatus;
+        severity?: IncidentSeverity;
+        limit?: number;
+    }): Incident[];
+    insertIncident(incident: Incident): void;
+    updateIncidentOccurrence(incidentId: string, update: {
+        sessionId: string;
+        lastSeen: string;
+        occurrences: number;
+        route: string;
+        breadcrumbs: Breadcrumb[];
+        lastElement?: ElementSummary;
+        stack?: string;
+    }): void;
+    updateIncidentStatus(id: string, status: IncidentStatus): void;
+    insertIncidentOccurrence(occurrence: IncidentOccurrence): void;
+    insertVerification(v: {
+        id: string;
+        incidentId: string;
+        status: IncidentStatus;
+        checks: any[];
+        beforeScreenshot?: string;
+        afterScreenshot?: string;
+        message?: string;
+        createdAt: string;
+    }): void;
+    getLatestVerification(incidentId: string): VerificationResult | null;
+    insertNote(note: VisualNote): void;
+    getNote(id: string): VisualNote | null;
+    listNotes(options?: {
+        projectId?: string;
+        status?: NoteStatus;
+        route?: string;
+        limit?: number;
+    }): VisualNote[];
+    deleteNote(id: string): void;
+    updateNoteStatus(id: string, status: NoteStatus): void;
+    updateNote(id: string, updates: Partial<VisualNote>): void;
+    insertNoteVerification(v: NoteVerificationResult): void;
+    getLatestNoteVerification(noteId: string): NoteVerificationResult | null;
+    clearAll(): void;
+    private mapIncidentRow;
+    private mapNoteRow;
+    close(): void;
+}
+
+declare class ScreenshotStore {
+    private baseDir;
+    constructor(baseDir: string);
+    saveScreenshot(projectId: string, incidentId: string, name: string, dataUrl: string): {
+        filePath: string;
+        format: string;
+    } | null;
+    getScreenshotPath(projectId: string, incidentId: string, name: string): string | null;
+}
+
+declare class SessionManager {
+    private activeSockets;
+    private db;
+    constructor(db: StorageDB);
+    registerSocket(sessionId: string, ws: WebSocket, origin: string, projectId: string): void;
+    unregisterSocket(sessionId: string): void;
+    handleCommandResponse(sessionId: string, response: CommandResponse): void;
+    sendCommand<T = any>(sessionId: string, command: ClientCommand<T>, timeoutMs?: number): Promise<CommandResponse>;
+    getActiveSessionForProject(projectId: string): Session | null;
+    getAnyActiveSession(): Session | null;
+    getActiveCount(): number;
+    broadcastToProject(projectId: string, message: any): void;
+    sendToSession(sessionId: string, message: any): void;
+}
+
+declare class NotesEngine {
+    private db;
+    private screenshotStore;
+    constructor(db: StorageDB, screenshotStore: ScreenshotStore);
+    createNoteFromClient(payload: {
+        sessionId: string;
+        noteType?: 'element' | 'region' | 'page';
+        message: string;
+        route?: string;
+        url?: string;
+        viewport?: {
+            width: number;
+            height: number;
+            devicePixelRatio: number;
+        };
+        scroll?: {
+            scrollX: number;
+            scrollY: number;
+        };
+        target?: any;
+        elementContext?: any;
+        region?: any;
+        screenshot?: string;
+        incidentId?: string;
+    }): VisualNote;
+    saveNoteScreenshot(projectId: string, noteId: string, name: string, dataUrl: string): string | null;
+}
+
+declare class NoteVerificationEngine {
+    private db;
+    private sessionManager;
+    private notesEngine;
+    constructor(db: StorageDB, sessionManager: SessionManager, notesEngine: NotesEngine);
+    verifyNote(noteId: string, options?: {
+        observationWindowMs?: number;
+    }): Promise<NoteVerificationResult>;
+    private recordNoteVerification;
+}
+
+declare class VerificationEngine {
+    private db;
+    private sessionManager;
+    private screenshotStore;
+    constructor(db: StorageDB, sessionManager: SessionManager, screenshotStore: ScreenshotStore);
+    verifyIncident(incidentId: string, recipe?: VerificationRecipe): Promise<VerificationResult>;
+    private evaluateProbe;
+    private recordVerification;
+}
+
+export { NoteVerificationEngine as N, StorageDB as S, VerificationEngine as V, SessionManager as a, ScreenshotStore as b, NotesEngine as c };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { B as Breadcrumb, C as CaptureElementParams, a as CaptureElementResult, b as ClientCommand, c as ClientEventMessage, d as CommandResponse, e as CommandType, f as ConsoleEvent, g as ConsoleLevel, D as DOMRectJson, E as ElementContext, h as ElementStyleResult, i as ElementSummary, j as EventType, H as HelloMessage, N as NavigateParams, k as NavigationEvent, l as NetworkEvent, m as NoteStatus, n as NoteTarget, o as NoteType, p as NoteVerificationResult, O as OverflowCheckResult, P as PageStateResult, Q as QueryElementParams, q as QueryElementResult, R as RegionContext, r as ReloadParams, s as RuntimeErrorEvent, S as ScrollContext, V as ViewportContext, t as VisualNote } from './notes-CBvN91Wf.js';
+export { I as Incident, a as IncidentOccurrence, b as IncidentSeverity, c as IncidentSource, d as IncidentStatus, P as ProbeResult, e as ProbeType, f as Project, S as Session, V as VerificationProbe, g as VerificationRecipe, h as VerificationResult } from './projects-CY8ungMt.js';
+export { BROWSER_SECURITY_RULES, FingerprintInput, REDACTED_PLACEHOLDER, SENSITIVE_KEY_PATTERNS, SENSITIVE_QUERY_PARAMS, SelectorOptions, computeFingerprint, extractSourceFromStack, getSemanticSelector, isSensitiveKey, normalizeErrorMessage, normalizeSourceFile, redactHeaders, redactSensitiveData, redactUrl, truncate } from './core/index.js';
+export { BrowserTrackClient, getClient, init as initClient } from './client/index.js';
+export { BrowserTrackDaemon, createDaemon } from './daemon/index.js';
+export { c as createMcpServer } from './server-Dd8NX2Mk.js';
+export { Rules, standardRules, redact as visulimaRedact } from '@visulima/redact';
+import './engine-CeT9URuN.js';
+import 'ws';
+import 'node:http';
+import '@modelcontextprotocol/sdk/server/index.js';

package/dist/index.js

@@ -0,0 +1,56 @@
+import {
+  BrowserTrackClient,
+  getClient,
+  init
+} from "./chunk-SKCMT2DE.js";
+import {
+  BrowserTrackDaemon,
+  createDaemon
+} from "./chunk-SPCIROIU.js";
+import {
+  BROWSER_SECURITY_RULES,
+  REDACTED_PLACEHOLDER,
+  SENSITIVE_KEY_PATTERNS,
+  SENSITIVE_QUERY_PARAMS,
+  computeFingerprint,
+  extractSourceFromStack,
+  getSemanticSelector,
+  isSensitiveKey,
+  normalizeErrorMessage,
+  normalizeSourceFile,
+  redactHeaders,
+  redactSensitiveData,
+  redactUrl,
+  standardRules,
+  truncate,
+  visulimaRedact
+} from "./chunk-6VA7GBAO.js";
+import {
+  createMcpServer
+} from "./chunk-G2Y3CXCY.js";
+import "./chunk-ILRYKMME.js";
+export {
+  BROWSER_SECURITY_RULES,
+  BrowserTrackClient,
+  BrowserTrackDaemon,
+  REDACTED_PLACEHOLDER,
+  SENSITIVE_KEY_PATTERNS,
+  SENSITIVE_QUERY_PARAMS,
+  computeFingerprint,
+  createDaemon,
+  createMcpServer,
+  extractSourceFromStack,
+  getClient,
+  getSemanticSelector,
+  init as initClient,
+  isSensitiveKey,
+  normalizeErrorMessage,
+  normalizeSourceFile,
+  redactHeaders,
+  redactSensitiveData,
+  redactUrl,
+  standardRules,
+  truncate,
+  visulimaRedact
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/mcp/index.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export { M as McpContext, a as McpServerOptions, c as createMcpServer, h as handleToolCall } from '../server-Dd8NX2Mk.js';
+import '@modelcontextprotocol/sdk/server/index.js';
+import '../engine-CeT9URuN.js';
+import '../notes-CBvN91Wf.js';
+import '../projects-CY8ungMt.js';
+import 'ws';
+
+declare const TOOLS: Tool[];
+
+export { TOOLS };

package/dist/mcp/index.js

@@ -0,0 +1,12 @@
+import {
+  TOOLS,
+  createMcpServer,
+  handleToolCall
+} from "../chunk-G2Y3CXCY.js";
+import "../chunk-ILRYKMME.js";
+export {
+  TOOLS,
+  createMcpServer,
+  handleToolCall
+};
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}