browsertrack 0.1.0 → 0.1.1

package/packages/core/dist/index.d.ts

@@ -1,317 +0,0 @@
-type EventType = 'runtime_error' | 'unhandled_rejection' | 'console' | 'fetch' | 'xhr' | 'navigation' | 'interaction';
-type ConsoleLevel = 'error' | 'warn' | 'info' | 'log' | 'debug';
-interface ElementSummary {
-    selector: string;
-    tag: string;
-    id?: string;
-    classes?: string[];
-    attributes?: Record<string, string>;
-    outerHTML?: string;
-    innerText?: string;
-    boundingRect?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-        top: number;
-        left: number;
-        bottom: number;
-        right: number;
-    };
-    visible: boolean;
-}
-interface Breadcrumb {
-    id?: string;
-    type: 'navigation' | 'click' | 'submit' | 'fetch' | 'xhr' | 'console' | 'error';
-    category?: string;
-    message: string;
-    timestamp: number;
-    level?: 'info' | 'warn' | 'error';
-    data?: Record<string, any>;
-    element?: ElementSummary;
-}
-interface NetworkEvent {
-    id?: string;
-    url: string;
-    method: string;
-    status?: number;
-    statusText?: string;
-    durationMs: number;
-    error?: string;
-    aborted?: boolean;
-    timestamp: number;
-    requestHeaders?: Record<string, string>;
-}
-interface RuntimeErrorEvent {
-    message: string;
-    stack?: string;
-    filename?: string;
-    lineno?: number;
-    colno?: number;
-    errorType: string;
-    timestamp: number;
-}
-interface ConsoleEvent {
-    level: ConsoleLevel;
-    message: string;
-    args?: any[];
-    stack?: string;
-    timestamp: number;
-}
-interface NavigationEvent {
-    from?: string;
-    to: string;
-    type: 'pushState' | 'replaceState' | 'popstate' | 'hashchange' | 'initial';
-    timestamp: number;
-}
-interface HelloMessage {
-    type: 'hello';
-    origin: string;
-    url: string;
-    title: string;
-    userAgent: string;
-    timestamp: number;
-    projectId?: string;
-}
-interface ClientEventMessage {
-    type: 'event';
-    sessionId: string;
-    eventType: EventType;
-    payload: RuntimeErrorEvent | ConsoleEvent | NetworkEvent | NavigationEvent | Breadcrumb;
-    breadcrumbs?: Breadcrumb[];
-    lastElement?: ElementSummary;
-    route?: string;
-    url: string;
-    title?: string;
-    timestamp: number;
-}
-
-type IncidentStatus = 'OPEN' | 'FIX_ATTEMPTED' | 'VERIFYING' | 'VERIFIED' | 'FAILED' | 'INCONCLUSIVE';
-type IncidentSeverity = 'error' | 'warn' | 'fatal';
-interface IncidentSource {
-    file: string;
-    line: number;
-    column?: number;
-}
-interface Incident {
-    id: string;
-    projectId: string;
-    sessionId: string;
-    type: string;
-    severity: IncidentSeverity;
-    message: string;
-    source: IncidentSource;
-    fingerprint: string;
-    route: string;
-    firstSeen: string;
-    lastSeen: string;
-    occurrences: number;
-    status: IncidentStatus;
-    stack?: string;
-    breadcrumbs: Breadcrumb[];
-    networkFailures: NetworkEvent[];
-    lastElement?: ElementSummary;
-    screenshots?: {
-        error?: string;
-        before?: string;
-        after?: string;
-    };
-}
-interface IncidentOccurrence {
-    id: string;
-    incidentId: string;
-    sessionId: string;
-    timestamp: string;
-    route: string;
-    url: string;
-    stack?: string;
-    breadcrumbs: Breadcrumb[];
-    lastElement?: ElementSummary;
-}
-
-type CommandType = 'reload' | 'navigate' | 'get_page_state' | 'query_element' | 'capture_element';
-interface ClientCommand<T = any> {
-    id: string;
-    type: CommandType;
-    params?: T;
-}
-interface ReloadParams {
-    force?: boolean;
-}
-interface NavigateParams {
-    url: string;
-}
-interface QueryElementParams {
-    selector: string;
-}
-interface CaptureElementParams {
-    selector?: string;
-}
-interface QueryElementResult {
-    exists: boolean;
-    visible?: boolean;
-    tag?: string;
-    id?: string;
-    classes?: string[];
-    boundingRect?: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-        top: number;
-        left: number;
-        bottom: number;
-        right: number;
-    };
-    innerText?: string;
-    outerHTML?: string;
-}
-interface PageStateResult {
-    url: string;
-    route: string;
-    title: string;
-    readyState: string;
-    activeElement?: ElementSummary;
-}
-interface CaptureElementResult {
-    dataUrl?: string;
-    format?: string;
-    width?: number;
-    height?: number;
-}
-interface CommandResponse<T = any> {
-    id: string;
-    ok: boolean;
-    result?: T;
-    error?: string;
-    reason?: string;
-}
-
-type ProbeType = 'element_exists' | 'element_visible' | 'text_contains' | 'route_is' | 'network_request_succeeded' | 'no_incident';
-interface VerificationProbe {
-    type: ProbeType;
-    selector?: string;
-    text?: string;
-    route?: string;
-    fingerprint?: string;
-    urlPattern?: string;
-    timeoutMs?: number;
-}
-interface VerificationRecipe {
-    route?: string;
-    targetSelector?: string;
-    expect?: VerificationProbe[];
-    observationWindowMs?: number;
-}
-interface ProbeResult {
-    type: ProbeType;
-    passed: boolean;
-    details?: string;
-}
-interface VerificationResult {
-    incidentId: string;
-    status: IncidentStatus;
-    checks: ProbeResult[];
-    screenshots?: {
-        before?: string;
-        after?: string;
-    };
-    timestamp: string;
-    message?: string;
-}
-
-interface Project {
-    id: string;
-    name: string;
-    origin: string;
-    path?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-interface Session {
-    id: string;
-    projectId: string;
-    origin: string;
-    url: string;
-    title: string;
-    userAgent: string;
-    connectedAt: string;
-    lastSeenAt: string;
-    active: boolean;
-}
-
-/**
- * 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
- */
-declare const SENSITIVE_KEY_PATTERNS: RegExp[];
-declare const SENSITIVE_QUERY_PARAMS: string[];
-declare const REDACTED_PLACEHOLDER = "[REDACTED]";
-/**
- * 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 from an object or array
- */
-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 { type Breadcrumb, type CaptureElementParams, type CaptureElementResult, type ClientCommand, type ClientEventMessage, type CommandResponse, type CommandType, type ConsoleEvent, type ConsoleLevel, type ElementSummary, type EventType, type FingerprintInput, type HelloMessage, type Incident, type IncidentOccurrence, type IncidentSeverity, type IncidentSource, type IncidentStatus, type NavigateParams, type NavigationEvent, type NetworkEvent, type PageStateResult, type ProbeResult, type ProbeType, type Project, type QueryElementParams, type QueryElementResult, REDACTED_PLACEHOLDER, type ReloadParams, type RuntimeErrorEvent, SENSITIVE_KEY_PATTERNS, SENSITIVE_QUERY_PARAMS, type SelectorOptions, type Session, type VerificationProbe, type VerificationRecipe, type VerificationResult, computeFingerprint, extractSourceFromStack, getSemanticSelector, isSensitiveKey, normalizeErrorMessage, normalizeSourceFile, redactHeaders, redactSensitiveData, redactUrl, truncate };

package/packages/core/dist/index.js

@@ -1,221 +0,0 @@
-// src/fingerprint.ts
-function normalizeErrorMessage(message) {
-  if (!message) return "unknown_error";
-  return message.trim().replace(/0x[0-9a-fA-F]+/g, "0x<HEX>").replace(/[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}/g, "<UUID>").replace(/\?[tv]=[\w.-]+/g, "").replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z?/g, "<TIMESTAMP>").replace(/#\d+/g, "#<ID>").replace(/\s+/g, " ");
-}
-function normalizeSourceFile(filename) {
-  if (!filename) return "unknown_source";
-  let cleaned = filename.trim();
-  try {
-    if (cleaned.startsWith("http://") || cleaned.startsWith("https://")) {
-      const url = new URL(cleaned);
-      cleaned = url.pathname;
-    }
-  } catch {
-    cleaned = cleaned.replace(/^https?:\/\/[^/]+/, "");
-  }
-  cleaned = cleaned.split("?")[0].split("#")[0];
-  cleaned = cleaned.replace(/\\/g, "/");
-  return cleaned || "unknown_source";
-}
-function extractSourceFromStack(stack) {
-  if (!stack) return null;
-  const lines = stack.split("\n");
-  for (const line of lines) {
-    const match = line.match(/(?:at\s+(?:.*?\s+\()?)?(https?:\/\/[^\s)]+|file:\/\/[^\s)]+|\/[^\s)]+):(\d+):(\d+)\)?/);
-    if (match) {
-      return {
-        file: normalizeSourceFile(match[1]),
-        line: parseInt(match[2], 10),
-        column: parseInt(match[3], 10)
-      };
-    }
-  }
-  return null;
-}
-function djb2Hash(str) {
-  let hash = 5381;
-  for (let i = 0; i < str.length; i++) {
-    hash = hash * 33 ^ str.charCodeAt(i);
-  }
-  return (hash >>> 0).toString(16).padStart(8, "0");
-}
-function computeFingerprint(input) {
-  const normType = (input.type || "Error").trim().toLowerCase();
-  const normMsg = normalizeErrorMessage(input.message);
-  let sourceFile = normalizeSourceFile(input.sourceFile);
-  let line = input.line || 0;
-  if ((sourceFile === "unknown_source" || line === 0) && input.stack) {
-    const extracted = extractSourceFromStack(input.stack);
-    if (extracted) {
-      sourceFile = extracted.file;
-      line = extracted.line;
-    }
-  }
-  const rawKey = `${normType}::${normMsg}::${sourceFile}::${line}`;
-  const hash = djb2Hash(rawKey);
-  return `fp_${hash}`;
-}
-
-// src/redaction.ts
-var SENSITIVE_KEY_PATTERNS = [
-  /^authorization$/i,
-  /^cookie$/i,
-  /^set-cookie$/i,
-  /password/i,
-  /token/i,
-  /secret/i,
-  /apikey/i,
-  /api_key/i,
-  /access_token/i,
-  /refresh_token/i,
-  /auth/i,
-  /credentials/i,
-  /private_key/i,
-  /ssn/i,
-  /credit_card/i,
-  /cvv/i
-];
-var SENSITIVE_QUERY_PARAMS = [
-  "token",
-  "auth",
-  "key",
-  "apikey",
-  "api_key",
-  "secret",
-  "password",
-  "access_token",
-  "refresh_token",
-  "code",
-  "signature"
-];
-var REDACTED_PLACEHOLDER = "[REDACTED]";
-function isSensitiveKey(key) {
-  if (!key) return false;
-  return SENSITIVE_KEY_PATTERNS.some((pattern) => pattern.test(key));
-}
-function redactUrl(rawUrl) {
-  if (!rawUrl) return rawUrl;
-  try {
-    const isRelative = !rawUrl.startsWith("http://") && !rawUrl.startsWith("https://") && !rawUrl.startsWith("ws://") && !rawUrl.startsWith("wss://");
-    const base = "http://localhost";
-    const parsed = new URL(rawUrl, base);
-    let changed = false;
-    for (const param of SENSITIVE_QUERY_PARAMS) {
-      if (parsed.searchParams.has(param)) {
-        parsed.searchParams.set(param, REDACTED_PLACEHOLDER);
-        changed = true;
-      }
-    }
-    for (const key of Array.from(parsed.searchParams.keys())) {
-      if (isSensitiveKey(key)) {
-        parsed.searchParams.set(key, REDACTED_PLACEHOLDER);
-        changed = true;
-      }
-    }
-    if (!changed) return rawUrl;
-    if (isRelative) {
-      return parsed.pathname + parsed.search + parsed.hash;
-    }
-    return parsed.toString();
-  } catch {
-    let safe = rawUrl;
-    for (const param of SENSITIVE_QUERY_PARAMS) {
-      const reg = new RegExp(`([?&]${param}=)[^&#]+`, "gi");
-      safe = safe.replace(reg, `$1${REDACTED_PLACEHOLDER}`);
-    }
-    return safe;
-  }
-}
-function redactHeaders(headers) {
-  if (!headers || typeof headers !== "object") return {};
-  const safe = {};
-  for (const [key, value] of Object.entries(headers)) {
-    if (isSensitiveKey(key)) {
-      safe[key] = REDACTED_PLACEHOLDER;
-    } else {
-      safe[key] = value;
-    }
-  }
-  return safe;
-}
-function redactSensitiveData(data, maxDepth = 4, currentDepth = 0) {
-  if (data === null || data === void 0) return data;
-  if (typeof data !== "object") return data;
-  if (currentDepth > maxDepth) return "[DEPTH_EXCEEDED]";
-  if (Array.isArray(data)) {
-    return data.map((item) => redactSensitiveData(item, maxDepth, currentDepth + 1));
-  }
-  const result = {};
-  for (const [key, value] of Object.entries(data)) {
-    if (isSensitiveKey(key)) {
-      result[key] = REDACTED_PLACEHOLDER;
-    } else if (typeof value === "string") {
-      if (value.startsWith("http://") || value.startsWith("https://") || value.includes("?")) {
-        result[key] = redactUrl(value);
-      } else {
-        result[key] = value;
-      }
-    } else if (typeof value === "object" && value !== null) {
-      result[key] = redactSensitiveData(value, maxDepth, currentDepth + 1);
-    } else {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-
-// src/selector.ts
-function getSemanticSelector(element, options = {}) {
-  if (!element || !element.tagName) return "unknown";
-  const maxClasses = options.maxClasses ?? 2;
-  const testId = element.getAttribute("data-testid") || element.getAttribute("data-test") || element.getAttribute("data-cy") || element.getAttribute("data-qa");
-  if (testId) {
-    return `[data-testid="${testId}"]`;
-  }
-  const id = element.id;
-  if (id && !/^[0-9]+$/.test(id) && !/[0-9a-f]{8}-[0-9a-f]{4}/i.test(id)) {
-    return `#${id}`;
-  }
-  const ariaLabel = element.getAttribute("aria-label");
-  if (ariaLabel && ariaLabel.length < 30) {
-    return `${element.tagName.toLowerCase()}[aria-label="${ariaLabel}"]`;
-  }
-  const nameAttr = element.getAttribute("name");
-  if (nameAttr) {
-    return `${element.tagName.toLowerCase()}[name="${nameAttr}"]`;
-  }
-  const tag = element.tagName.toLowerCase();
-  const classList = Array.from(element.classList || []).filter((c) => !c.startsWith("css-") && !c.startsWith("_") && !/^[a-z0-9]{5,}$/i.test(c)).slice(0, maxClasses);
-  if (classList.length > 0) {
-    const classStr = classList.map((c) => `.${c}`).join("");
-    return `${tag}${classStr}`;
-  }
-  if (element.parentElement && element.parentElement !== document.body && element.parentElement !== document.documentElement) {
-    const parentSelector = getSemanticSelector(element.parentElement, { maxClasses: 1 });
-    if (parentSelector && parentSelector !== "unknown" && !parentSelector.includes(">")) {
-      return `${parentSelector} > ${tag}`;
-    }
-  }
-  return tag;
-}
-function truncate(str, maxLength = 200) {
-  if (!str) return "";
-  if (str.length <= maxLength) return str;
-  return str.slice(0, maxLength) + "...";
-}
-export {
-  REDACTED_PLACEHOLDER,
-  SENSITIVE_KEY_PATTERNS,
-  SENSITIVE_QUERY_PARAMS,
-  computeFingerprint,
-  extractSourceFromStack,
-  getSemanticSelector,
-  isSensitiveKey,
-  normalizeErrorMessage,
-  normalizeSourceFile,
-  redactHeaders,
-  redactSensitiveData,
-  redactUrl,
-  truncate
-};