@vestig/next 0.6.0 → 0.8.0

package/dist/error/fingerprint.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Error Fingerprinting
+ *
+ * Generates unique fingerprints for errors to group similar errors together.
+ * Useful for error aggregation in monitoring systems.
+ *
+ * @packageDocumentation
+ */
+import type { FingerprintOptions, StackFrame } from './types';
+/**
+ * Generate a fingerprint for an error
+ *
+ * The fingerprint is designed to group similar errors together while
+ * distinguishing between genuinely different errors.
+ *
+ * @param error - The error to fingerprint
+ * @param frames - Parsed stack frames
+ * @param options - Fingerprinting options
+ * @returns A hex string fingerprint
+ *
+ * @example
+ * ```ts
+ * const fingerprint = generateFingerprint(error, frames)
+ * // 'a1b2c3d4e5f6g7h8'
+ * ```
+ */
+export declare function generateFingerprint(error: Error, frames: StackFrame[], options?: FingerprintOptions): string;
+/**
+ * Check if two errors have the same fingerprint
+ */
+export declare function isSameError(error1: {
+    fingerprint: string;
+}, error2: {
+    fingerprint: string;
+}): boolean;
+/**
+ * Group errors by fingerprint
+ */
+export declare function groupErrors<T extends {
+    fingerprint: string;
+}>(errors: T[]): Map<string, T[]>;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/error/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../src/error/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AA2E7D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAClC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,kBAAuB,GAC9B,MAAM,CAsCR;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAC/B,MAAM,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAU5F"}

package/dist/error/fingerprint.js

@@ -0,0 +1,135 @@
+/**
+ * Error Fingerprinting
+ *
+ * Generates unique fingerprints for errors to group similar errors together.
+ * Useful for error aggregation in monitoring systems.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Simple hash function for strings
+ * Uses djb2 algorithm for fast, consistent hashing
+ */
+function hashString(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');
+}
+/**
+ * Normalize a file path for consistent fingerprinting
+ * Removes dynamic parts like hashes, timestamps, query strings
+ */
+function normalizeFilePath(path) {
+    return (path
+        // Remove webpack chunk hashes
+        .replace(/\.[a-f0-9]{8,}\./, '.')
+        // Remove query strings
+        .replace(/\?.*$/, '')
+        // Remove line/column from paths
+        .replace(/:\d+:\d+$/, '')
+        // Normalize slashes
+        .replace(/\\/g, '/')
+        // Remove absolute path prefixes
+        .replace(/^.*\/node_modules\//, 'node_modules/')
+        .replace(/^.*\/(src|app|pages|components)\//, '$1/'));
+}
+/**
+ * Normalize function name for consistent fingerprinting
+ */
+function normalizeFunctionName(name) {
+    if (!name)
+        return '<anonymous>';
+    return (name
+        // Remove React component wrappers
+        .replace(/^(Object\.)?/, '')
+        // Remove module prefixes
+        .replace(/^exports\./, '')
+        // Remove async prefixes
+        .replace(/^async /, ''));
+}
+/**
+ * Extract key parts from an error message
+ * Removes dynamic values like IDs, timestamps, etc.
+ */
+function normalizeErrorMessage(message) {
+    return (message
+        // Remove UUIDs
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, '<UUID>')
+        // Remove numbers that look like IDs
+        .replace(/\b\d{5,}\b/g, '<ID>')
+        // Remove URLs
+        .replace(/https?:\/\/[^\s]+/g, '<URL>')
+        // Remove file paths
+        .replace(/\/[^\s:]+\.(js|ts|tsx|jsx)/g, '<FILE>')
+        // Remove quoted strings (might be dynamic)
+        .replace(/"[^"]{20,}"/g, '"<STRING>"')
+        .replace(/'[^']{20,}'/g, "'<STRING>'")
+        // Trim whitespace
+        .trim());
+}
+/**
+ * Generate a fingerprint for an error
+ *
+ * The fingerprint is designed to group similar errors together while
+ * distinguishing between genuinely different errors.
+ *
+ * @param error - The error to fingerprint
+ * @param frames - Parsed stack frames
+ * @param options - Fingerprinting options
+ * @returns A hex string fingerprint
+ *
+ * @example
+ * ```ts
+ * const fingerprint = generateFingerprint(error, frames)
+ * // 'a1b2c3d4e5f6g7h8'
+ * ```
+ */
+export function generateFingerprint(error, frames, options = {}) {
+    const { includeFilePaths = true, includeLineNumbers = false, maxFrames = 5 } = options;
+    const parts = [];
+    // 1. Error type/name
+    parts.push(error.name || 'Error');
+    // 2. Normalized error message
+    parts.push(normalizeErrorMessage(error.message));
+    // 3. Stack frames (focus on app code)
+    const appFrames = frames.filter((f) => f.isAppCode).slice(0, maxFrames);
+    // If no app frames, use first few frames
+    const relevantFrames = appFrames.length > 0 ? appFrames : frames.slice(0, maxFrames);
+    for (const frame of relevantFrames) {
+        const frameParts = [];
+        // Function name is most stable
+        frameParts.push(normalizeFunctionName(frame.functionName));
+        // File path (optional)
+        if (includeFilePaths && frame.fileName) {
+            frameParts.push(normalizeFilePath(frame.fileName));
+        }
+        // Line number (optional - less stable across builds)
+        if (includeLineNumbers && frame.lineNumber) {
+            frameParts.push(String(frame.lineNumber));
+        }
+        parts.push(frameParts.join(':'));
+    }
+    // Generate hash from combined parts
+    return hashString(parts.join('|'));
+}
+/**
+ * Check if two errors have the same fingerprint
+ */
+export function isSameError(error1, error2) {
+    return error1.fingerprint === error2.fingerprint;
+}
+/**
+ * Group errors by fingerprint
+ */
+export function groupErrors(errors) {
+    const groups = new Map();
+    for (const error of errors) {
+        const existing = groups.get(error.fingerprint) ?? [];
+        existing.push(error);
+        groups.set(error.fingerprint, existing);
+    }
+    return groups;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/error/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../src/error/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,SAAS,UAAU,CAAC,GAAW;IAC9B,IAAI,IAAI,GAAG,IAAI,CAAA;IACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;IACvC,CAAC;IACD,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAClD,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACtC,OAAO,CACN,IAAI;QACH,8BAA8B;SAC7B,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;QACjC,uBAAuB;SACtB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACrB,gCAAgC;SAC/B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,oBAAoB;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;QACpB,gCAAgC;SAC/B,OAAO,CAAC,qBAAqB,EAAE,eAAe,CAAC;SAC/C,OAAO,CAAC,mCAAmC,EAAE,KAAK,CAAC,CACrD,CAAA;AACF,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAAC,IAAwB;IACtD,IAAI,CAAC,IAAI;QAAE,OAAO,aAAa,CAAA;IAE/B,OAAO,CACN,IAAI;QACH,kCAAkC;SACjC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,yBAAyB;SACxB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;QAC1B,wBAAwB;SACvB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CACxB,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC7C,OAAO,CACN,OAAO;QACN,eAAe;SACd,OAAO,CAAC,gEAAgE,EAAE,QAAQ,CAAC;QACpF,oCAAoC;SACnC,OAAO,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,cAAc;SACb,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;QACvC,oBAAoB;SACnB,OAAO,CAAC,6BAA6B,EAAE,QAAQ,CAAC;QACjD,2CAA2C;SAC1C,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC;SACrC,OAAO,CAAC,cAAc,EAAE,YAAY,CAAC;QACtC,kBAAkB;SACjB,IAAI,EAAE,CACR,CAAA;AACF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CAClC,KAAY,EACZ,MAAoB,EACpB,UAA8B,EAAE;IAEhC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,kBAAkB,GAAG,KAAK,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,OAAO,CAAA;IAEtF,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,qBAAqB;IACrB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAA;IAEjC,8BAA8B;IAC9B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;IAEhD,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAEvE,yCAAyC;IACzC,MAAM,cAAc,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;IAEpF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACpC,MAAM,UAAU,GAAa,EAAE,CAAA;QAE/B,+BAA+B;QAC/B,UAAU,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAA;QAE1D,uBAAuB;QACvB,IAAI,gBAAgB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACxC,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QACnD,CAAC;QAED,qDAAqD;QACrD,IAAI,kBAAkB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5C,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAA;QAC1C,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACjC,CAAC;IAED,oCAAoC;IACpC,OAAO,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,MAA+B,EAC/B,MAA+B;IAE/B,OAAO,MAAM,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAAA;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAoC,MAAW;IACzE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAe,CAAA;IAErC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,CAAA;QACpD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACpB,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACxC,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC"}

package/dist/error/index.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @vestig/next/error - Enhanced Error Handling
+ *
+ * This module provides enhanced error handling for Next.js applications
+ * with rich development experience including:
+ *
+ * - **Stack trace parsing** with app code highlighting
+ * - **Breadcrumb trails** showing events before the error
+ * - **Error fingerprinting** for grouping similar errors
+ * - **React component tree** visualization
+ *
+ * @example Basic Usage
+ * ```tsx
+ * // app/layout.tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <EnhancedErrorBoundary>
+ *           {children}
+ *         </EnhancedErrorBoundary>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Breadcrumb Tracking
+ * ```tsx
+ * import { EnhancedErrorBoundary, setupClickTracking, setupFetchTracking } from '@vestig/next/error'
+ *
+ * // In a client component
+ * useEffect(() => {
+ *   const cleanupClick = setupClickTracking()
+ *   const cleanupFetch = setupFetchTracking()
+ *   return () => {
+ *     cleanupClick()
+ *     cleanupFetch()
+ *   }
+ * }, [])
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { EnhancedErrorBoundary } from './boundary';
+export { breadcrumbStore, addLogBreadcrumb, addNavigationBreadcrumb, addClickBreadcrumb, addInputBreadcrumb, addFetchBreadcrumb, addErrorBreadcrumb, addCustomBreadcrumb, setupClickTracking, setupFetchTracking, formatBreadcrumbs, getCategoryIcon, } from './breadcrumbs';
+export { parseStackTrace, parseComponentStack, getMostRelevantFrame, formatStackFrame, formatStackTrace, } from './stack-parser';
+export { generateFingerprint, isSameError, groupErrors, } from './fingerprint';
+export type { BreadcrumbCategory, Breadcrumb, StackFrame, EnhancedError, EnhancedErrorBoundaryProps, EnhancedErrorBoundaryState, FingerprintOptions, BreadcrumbStore, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAKH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAGlD,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GACf,MAAM,eAAe,CAAA;AAGtB,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,GACX,MAAM,eAAe,CAAA;AAGtB,YAAY,EACX,kBAAkB,EAClB,UAAU,EACV,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA"}

package/dist/error/index.js

@@ -0,0 +1,56 @@
+/**
+ * @vestig/next/error - Enhanced Error Handling
+ *
+ * This module provides enhanced error handling for Next.js applications
+ * with rich development experience including:
+ *
+ * - **Stack trace parsing** with app code highlighting
+ * - **Breadcrumb trails** showing events before the error
+ * - **Error fingerprinting** for grouping similar errors
+ * - **React component tree** visualization
+ *
+ * @example Basic Usage
+ * ```tsx
+ * // app/layout.tsx
+ * import { EnhancedErrorBoundary } from '@vestig/next/error'
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <EnhancedErrorBoundary>
+ *           {children}
+ *         </EnhancedErrorBoundary>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ *
+ * @example With Breadcrumb Tracking
+ * ```tsx
+ * import { EnhancedErrorBoundary, setupClickTracking, setupFetchTracking } from '@vestig/next/error'
+ *
+ * // In a client component
+ * useEffect(() => {
+ *   const cleanupClick = setupClickTracking()
+ *   const cleanupFetch = setupFetchTracking()
+ *   return () => {
+ *     cleanupClick()
+ *     cleanupFetch()
+ *   }
+ * }, [])
+ * ```
+ *
+ * @packageDocumentation
+ */
+'use client';
+// Main error boundary component
+export { EnhancedErrorBoundary } from './boundary';
+// Breadcrumb system
+export { breadcrumbStore, addLogBreadcrumb, addNavigationBreadcrumb, addClickBreadcrumb, addInputBreadcrumb, addFetchBreadcrumb, addErrorBreadcrumb, addCustomBreadcrumb, setupClickTracking, setupFetchTracking, formatBreadcrumbs, getCategoryIcon, } from './breadcrumbs';
+// Stack trace parsing
+export { parseStackTrace, parseComponentStack, getMostRelevantFrame, formatStackFrame, formatStackTrace, } from './stack-parser';
+// Error fingerprinting
+export { generateFingerprint, isSameError, groupErrors, } from './fingerprint';
+//# sourceMappingURL=index.js.map

package/dist/error/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/error/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,YAAY,CAAA;AAEZ,gCAAgC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AAElD,oBAAoB;AACpB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GACf,MAAM,eAAe,CAAA;AAEtB,sBAAsB;AACtB,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GAChB,MAAM,gBAAgB,CAAA;AAEvB,uBAAuB;AACvB,OAAO,EACN,mBAAmB,EACnB,WAAW,EACX,WAAW,GACX,MAAM,eAAe,CAAA"}

package/dist/error/stack-parser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Stack Trace Parser
+ *
+ * Parses JavaScript error stack traces into structured frames.
+ * Supports Chrome, Firefox, Safari, and Edge stack trace formats.
+ *
+ * @packageDocumentation
+ */
+import type { StackFrame } from './types';
+/**
+ * Parse an error stack trace into structured frames
+ *
+ * @param stack - The error.stack string
+ * @returns Array of parsed stack frames
+ *
+ * @example
+ * ```ts
+ * try {
+ *   throw new Error('Test')
+ * } catch (e) {
+ *   const frames = parseStackTrace(e.stack)
+ *   // [{ functionName: 'test', fileName: '/app/src/test.ts', lineNumber: 5, ... }]
+ * }
+ * ```
+ */
+export declare function parseStackTrace(stack: string | undefined): StackFrame[];
+/**
+ * Parse React component stack into readable format
+ */
+export declare function parseComponentStack(componentStack: string | undefined): string[];
+/**
+ * Get the most relevant stack frame (first app code frame)
+ */
+export declare function getMostRelevantFrame(frames: StackFrame[]): StackFrame | null;
+/**
+ * Format a stack frame for display
+ */
+export declare function formatStackFrame(frame: StackFrame): string;
+/**
+ * Format entire stack trace for display
+ */
+export declare function formatStackTrace(frames: StackFrame[]): string;
+//# sourceMappingURL=stack-parser.d.ts.map

package/dist/error/stack-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-parser.d.ts","sourceRoot":"","sources":["../../src/error/stack-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAkEzC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE,CAcvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAsBhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,GAAG,IAAI,CAW5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAqB1D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAE7D"}

package/dist/error/stack-parser.js

@@ -0,0 +1,166 @@
+/**
+ * Stack Trace Parser
+ *
+ * Parses JavaScript error stack traces into structured frames.
+ * Supports Chrome, Firefox, Safari, and Edge stack trace formats.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Regex patterns for different browser stack trace formats
+ */
+const CHROME_STACK_REGEX = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/;
+const FIREFOX_STACK_REGEX = /^(?:(.+)@)?(.+?):(\d+):(\d+)$/;
+const SAFARI_STACK_REGEX = /^(?:(.+)@)?(.+?):(\d+):(\d+)$/;
+/**
+ * Check if a file path is from node_modules
+ */
+function isNodeModulePath(path) {
+    return path.includes('node_modules') || path.includes('node:');
+}
+/**
+ * Check if a file path is from app source code
+ */
+function isAppCodePath(path) {
+    // Not from node_modules
+    if (isNodeModulePath(path))
+        return false;
+    // Common app directories
+    const appPatterns = ['/src/', '/app/', '/pages/', '/components/', '/lib/', '/utils/', '/hooks/'];
+    return appPatterns.some((pattern) => path.includes(pattern));
+}
+/**
+ * Parse a single stack frame line
+ */
+function parseStackLine(line) {
+    const trimmedLine = line.trim();
+    if (!trimmedLine || trimmedLine === 'Error')
+        return null;
+    // Try Chrome format first (most common)
+    let match = CHROME_STACK_REGEX.exec(trimmedLine);
+    if (match) {
+        const [, functionName, fileName, lineNumber, columnNumber] = match;
+        return {
+            functionName: functionName?.trim(),
+            fileName: fileName,
+            lineNumber: parseInt(lineNumber ?? '0', 10),
+            columnNumber: parseInt(columnNumber ?? '0', 10),
+            isNodeModule: isNodeModulePath(fileName ?? ''),
+            isAppCode: isAppCodePath(fileName ?? ''),
+        };
+    }
+    // Try Firefox/Safari format
+    match = FIREFOX_STACK_REGEX.exec(trimmedLine);
+    if (match) {
+        const [, functionName, fileName, lineNumber, columnNumber] = match;
+        return {
+            functionName: functionName?.trim(),
+            fileName: fileName,
+            lineNumber: parseInt(lineNumber ?? '0', 10),
+            columnNumber: parseInt(columnNumber ?? '0', 10),
+            isNodeModule: isNodeModulePath(fileName ?? ''),
+            isAppCode: isAppCodePath(fileName ?? ''),
+        };
+    }
+    return null;
+}
+/**
+ * Parse an error stack trace into structured frames
+ *
+ * @param stack - The error.stack string
+ * @returns Array of parsed stack frames
+ *
+ * @example
+ * ```ts
+ * try {
+ *   throw new Error('Test')
+ * } catch (e) {
+ *   const frames = parseStackTrace(e.stack)
+ *   // [{ functionName: 'test', fileName: '/app/src/test.ts', lineNumber: 5, ... }]
+ * }
+ * ```
+ */
+export function parseStackTrace(stack) {
+    if (!stack)
+        return [];
+    const lines = stack.split('\n');
+    const frames = [];
+    for (const line of lines) {
+        const frame = parseStackLine(line);
+        if (frame) {
+            frames.push(frame);
+        }
+    }
+    return frames;
+}
+/**
+ * Parse React component stack into readable format
+ */
+export function parseComponentStack(componentStack) {
+    if (!componentStack)
+        return [];
+    const lines = componentStack.split('\n');
+    const components = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        // Extract component name from "at ComponentName (file:line:col)"
+        const match = /^at\s+(\w+)/.exec(trimmed);
+        if (match?.[1]) {
+            components.push(match[1]);
+        }
+        else if (trimmed.startsWith('in ')) {
+            // Alternative format: "in ComponentName"
+            const componentName = trimmed.slice(3).split(' ')[0];
+            if (componentName)
+                components.push(componentName);
+        }
+    }
+    return components;
+}
+/**
+ * Get the most relevant stack frame (first app code frame)
+ */
+export function getMostRelevantFrame(frames) {
+    // First, try to find an app code frame
+    const appFrame = frames.find((f) => f.isAppCode);
+    if (appFrame)
+        return appFrame;
+    // Fall back to first non-node_modules frame
+    const nonModuleFrame = frames.find((f) => !f.isNodeModule);
+    if (nonModuleFrame)
+        return nonModuleFrame;
+    // Last resort: first frame
+    return frames[0] ?? null;
+}
+/**
+ * Format a stack frame for display
+ */
+export function formatStackFrame(frame) {
+    const parts = [];
+    if (frame.functionName) {
+        parts.push(frame.functionName);
+    }
+    else {
+        parts.push('<anonymous>');
+    }
+    if (frame.fileName) {
+        let location = frame.fileName;
+        if (frame.lineNumber) {
+            location += `:${frame.lineNumber}`;
+            if (frame.columnNumber) {
+                location += `:${frame.columnNumber}`;
+            }
+        }
+        parts.push(`(${location})`);
+    }
+    return parts.join(' ');
+}
+/**
+ * Format entire stack trace for display
+ */
+export function formatStackTrace(frames) {
+    return frames.map((frame, i) => `  at ${formatStackFrame(frame)}`).join('\n');
+}
+//# sourceMappingURL=stack-parser.js.map

package/dist/error/stack-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-parser.js","sourceRoot":"","sources":["../../src/error/stack-parser.ts"],"names":[],"mappings":"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"}

package/dist/error/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Error Types for Better Error DX
+ *
+ * Types for enhanced error handling with source maps,
+ * breadcrumbs, and fingerprinting.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Breadcrumb categories for filtering
+ */
+export type BreadcrumbCategory = 'log' | 'navigation' | 'click' | 'input' | 'fetch' | 'error' | 'custom';
+/**
+ * Enhanced breadcrumb with more context
+ */
+export interface Breadcrumb {
+    /** Unique ID */
+    id: string;
+    /** ISO timestamp */
+    timestamp: string;
+    /** Breadcrumb category */
+    category: BreadcrumbCategory;
+    /** Log level (for log breadcrumbs) */
+    level?: 'trace' | 'debug' | 'info' | 'warn' | 'error';
+    /** Human-readable message */
+    message: string;
+    /** Logger namespace */
+    namespace?: string;
+    /** Additional data */
+    data?: Record<string, unknown>;
+}
+/**
+ * Parsed stack frame from error stack trace
+ */
+export interface StackFrame {
+    /** Function name (if available) */
+    functionName?: string;
+    /** File path */
+    fileName?: string;
+    /** Line number (1-indexed) */
+    lineNumber?: number;
+    /** Column number (1-indexed) */
+    columnNumber?: number;
+    /** Whether this is from node_modules */
+    isNodeModule: boolean;
+    /** Whether this is from the app's source code */
+    isAppCode: boolean;
+    /** Source code context (if available via source maps) */
+    sourceContext?: {
+        /** Lines before the error line */
+        pre: string[];
+        /** The error line */
+        line: string;
+        /** Lines after the error line */
+        post: string[];
+    };
+}
+/**
+ * Enhanced error with parsed stack and fingerprint
+ */
+export interface EnhancedError {
+    /** Original error */
+    error: Error;
+    /** Error fingerprint for grouping */
+    fingerprint: string;
+    /** Parsed stack frames */
+    frames: StackFrame[];
+    /** React component stack */
+    componentStack?: string;
+    /** Breadcrumbs leading up to the error */
+    breadcrumbs: Breadcrumb[];
+    /** Timestamp when error occurred */
+    timestamp: string;
+    /** Browser/environment info */
+    environment: {
+        userAgent: string;
+        url: string;
+        pathname: string;
+    };
+}
+/**
+ * Props for enhanced error boundary
+ */
+export interface EnhancedErrorBoundaryProps {
+    children: React.ReactNode;
+    /**
+     * Custom fallback UI
+     */
+    fallback?: React.ReactNode | ((error: EnhancedError) => React.ReactNode);
+    /**
+     * Callback when error is caught
+     */
+    onError?: (error: EnhancedError) => void;
+    /**
+     * Maximum breadcrumbs to keep
+     * @default 50
+     */
+    maxBreadcrumbs?: number;
+    /**
+     * Show source code context in development
+     * @default true in development
+     */
+    showSourceContext?: boolean;
+    /**
+     * Show breadcrumbs in error UI
+     * @default true in development
+     */
+    showBreadcrumbs?: boolean;
+    /**
+     * Categories of breadcrumbs to capture
+     * @default all categories
+     */
+    breadcrumbCategories?: BreadcrumbCategory[];
+    /**
+     * Report errors to endpoint
+     */
+    reportEndpoint?: string;
+}
+/**
+ * State for enhanced error boundary
+ */
+export interface EnhancedErrorBoundaryState {
+    hasError: boolean;
+    enhancedError: EnhancedError | null;
+}
+/**
+ * Options for error fingerprinting
+ */
+export interface FingerprintOptions {
+    /** Include file paths in fingerprint */
+    includeFilePaths?: boolean;
+    /** Include line numbers in fingerprint */
+    includeLineNumbers?: boolean;
+    /** Maximum stack frames to consider */
+    maxFrames?: number;
+}
+/**
+ * Breadcrumb store interface
+ */
+export interface BreadcrumbStore {
+    /** Add a breadcrumb */
+    add: (breadcrumb: Omit<Breadcrumb, 'id' | 'timestamp'>) => void;
+    /** Get all breadcrumbs */
+    getAll: () => Breadcrumb[];
+    /** Get breadcrumbs by category */
+    getByCategory: (category: BreadcrumbCategory) => Breadcrumb[];
+    /** Clear all breadcrumbs */
+    clear: () => void;
+    /** Set maximum breadcrumbs */
+    setMaxSize: (size: number) => void;
+}
+//# sourceMappingURL=types.d.ts.map