browsertrack 0.0.1 → 0.1.0

package/dist/client/index.d.ts

@@ -0,0 +1,197 @@
+import { B as Breadcrumb, i as ElementSummary, b as ClientCommand, d as CommandResponse, t as VisualNote, R as RegionContext } from '../notes-CBvN91Wf.js';
+
+interface BrowserDiagClientOptions {
+    daemonUrl?: string;
+    projectId?: string;
+    maxBreadcrumbs?: number;
+    captureErrors?: boolean;
+    captureConsole?: boolean;
+    captureNetwork?: boolean;
+    captureNavigation?: boolean;
+    captureInteractions?: boolean;
+    onErrorScreenshot?: boolean;
+    notes?: {
+        enabled?: boolean;
+        shortcut?: string;
+        showBadges?: boolean;
+        maskSelectors?: string[];
+    };
+    debug?: boolean;
+}
+declare const DEFAULT_OPTIONS: Required<Omit<BrowserDiagClientOptions, 'notes'>> & {
+    notes: Required<NonNullable<BrowserDiagClientOptions['notes']>>;
+};
+
+declare class BrowserTrackClient {
+    options: Required<Omit<BrowserDiagClientOptions, 'notes'>> & {
+        notes: Required<NonNullable<BrowserDiagClientOptions['notes']>>;
+    };
+    private breadcrumbs;
+    private transport;
+    private screenshotDriver;
+    private commandHandler;
+    private inspector?;
+    private lastElement;
+    private currentRoute;
+    private cleanups;
+    private isInitialized;
+    constructor(options?: BrowserDiagClientOptions);
+    init(): this;
+    openNoteEditor(el?: HTMLElement, noteType?: 'element' | 'page'): void;
+    startRegionSelection(): void;
+    startElementSelection(): void;
+    setInspectMode(mode: 'element' | 'region' | 'page' | 'idle'): void;
+    createNote(targetEl: HTMLElement, message: string, noteType?: 'element' | 'page'): Promise<void>;
+    private handleRuntimeError;
+    private handleConsole;
+    private handleNetwork;
+    private handleNavigation;
+    private sendEvent;
+    getBreadcrumbs(): Breadcrumb[];
+    getLastElement(): ElementSummary | undefined;
+    destroy(): void;
+}
+
+declare class BreadcrumbBuffer {
+    private capacity;
+    private buffer;
+    constructor(capacity?: number);
+    add(breadcrumb: Omit<Breadcrumb, 'timestamp'> & {
+        timestamp?: number;
+    }): void;
+    getRecent(): Breadcrumb[];
+    clear(): void;
+}
+
+interface ScreenshotResult {
+    ok: boolean;
+    dataUrl?: string;
+    format?: 'webp' | 'png' | 'jpeg';
+    width?: number;
+    height?: number;
+    reason?: string;
+}
+interface ScreenshotDriver {
+    name: string;
+    captureElement(element: HTMLElement | Element): Promise<ScreenshotResult>;
+    captureSelector(selector: string): Promise<ScreenshotResult>;
+}
+
+/**
+ * Modern DOM snapshot driver using @zumer/snapdom with graceful fallbacks.
+ * Converts DOM subtrees and elements into WebP / PNG data URLs.
+ */
+declare class BrowserScriptScreenshotDriver implements ScreenshotDriver {
+    name: string;
+    captureSelector(selector: string): Promise<ScreenshotResult>;
+    captureElement(element: HTMLElement | Element): Promise<ScreenshotResult>;
+    private captureWithSvgFallback;
+}
+
+declare class ClientCommandHandler {
+    private screenshotDriver;
+    constructor(screenshotDriver: ScreenshotDriver);
+    executeCommand(command: ClientCommand): Promise<CommandResponse>;
+    private handleReload;
+    private handleNavigate;
+    private handleGetPageState;
+    private handleQueryElement;
+    private handleCaptureElement;
+    private handleCheckOverflow;
+    private handleGetElementRect;
+    private handleGetElementStyle;
+}
+
+interface TransportOptions {
+    url: string;
+    projectId?: string;
+    debug?: boolean;
+}
+declare class WebSocketTransport {
+    private wsUrl;
+    private projectId?;
+    private debug;
+    private ws;
+    private sessionId;
+    private queue;
+    private maxQueueSize;
+    private reconnectAttempts;
+    private maxReconnectDelay;
+    private reconnectTimer;
+    private commandHandler?;
+    private isDestroyed;
+    constructor(options: TransportOptions);
+    setCommandHandler(handler: ClientCommandHandler): void;
+    getSessionId(): string | null;
+    isConnected(): boolean;
+    connect(): void;
+    send(payload: any): void;
+    private enqueue;
+    private flushQueue;
+    private sendHello;
+    private scheduleReconnect;
+    destroy(): void;
+}
+
+type NoteInspectMode = 'element' | 'region' | 'page' | 'idle';
+interface InspectorOptions {
+    shortcut?: string;
+    maskSelectors?: string[];
+    showToolbar?: boolean;
+    onNoteCreated?: (note: Partial<VisualNote>) => void;
+}
+/**
+ * Isolated Visual Note Inspector rendering in Shadow DOM.
+ * Supports:
+ * 1. Element selection (hover highlight & click)
+ * 2. Region / Area selection (drag-and-drop rectangle on screen)
+ * 3. Whole page note
+ * 4. Floating quick dock / toolbar in bottom-right corner
+ */
+declare class NoteInspector {
+    private transport;
+    private screenshotDriver;
+    private options;
+    private container;
+    private shadowRoot;
+    private highlightOverlay;
+    private regionOverlay;
+    private regionBox;
+    private toolbarElement;
+    private modalOverlay;
+    private activeMode;
+    private hoveredElement;
+    private selectedElement;
+    private selectedRegion;
+    private isDraggingRegion;
+    private dragStartX;
+    private dragStartY;
+    private cleanups;
+    constructor(transport: WebSocketTransport, screenshotDriver: ScreenshotDriver, options?: InspectorOptions);
+    init(): void;
+    setMode(mode: NoteInspectMode): void;
+    private ensureContainer;
+    private createToolbar;
+    private updateToolbarState;
+    private setupListeners;
+    private showRegionOverlay;
+    private hideRegionOverlay;
+    private updateHighlight;
+    private hideHighlight;
+    openNoteEditor(el?: HTMLElement, noteType?: 'element' | 'page'): void;
+    openRegionNoteEditor(region: RegionContext): void;
+    private renderNoteModal;
+    saveVisualNote(targetEl: HTMLElement, message: string, noteType?: 'element' | 'page'): Promise<void>;
+    saveRegionVisualNote(region: RegionContext, message: string): Promise<void>;
+    private cropDataUrl;
+    private extractElementContext;
+    destroy(): void;
+}
+
+/**
+ * Initializes the BrowserTrack client.
+ */
+declare function init(options?: BrowserDiagClientOptions): BrowserTrackClient;
+declare function getClient(): BrowserTrackClient | null;
+
+export { BreadcrumbBuffer, type BrowserDiagClientOptions, BrowserScriptScreenshotDriver, BrowserTrackClient, DEFAULT_OPTIONS, type InspectorOptions, type NoteInspectMode, NoteInspector, type ScreenshotDriver, type ScreenshotResult, getClient, init };

package/dist/client/index.js

@@ -0,0 +1,20 @@
+import {
+  BreadcrumbBuffer,
+  BrowserScriptScreenshotDriver,
+  BrowserTrackClient,
+  DEFAULT_OPTIONS,
+  NoteInspector,
+  getClient,
+  init
+} from "../chunk-X7C5CHBO.js";
+import "../chunk-6A7FFDIB.js";
+export {
+  BreadcrumbBuffer,
+  BrowserScriptScreenshotDriver,
+  BrowserTrackClient,
+  DEFAULT_OPTIONS,
+  NoteInspector,
+  getClient,
+  init
+};
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

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