@vestig/next 0.5.0 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # @vestig/next
 
-First-class structured logging for Next.js applications. Built on top of [vestig](https://github.com/your-repo/vestig), this package provides automatic request correlation, middleware integration, and seamless client/server logging.
+First-class structured logging for Next.js 15+ applications. Built on top of [vestig](https://github.com/Arakiss/vestig), this package provides automatic request correlation, middleware integration, and seamless client/server logging.
 
 ## Features
 

package/dist/__tests__/mocks/next-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next-server.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/next-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACjB,GACJ,eAAe,CAyCjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACR,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,eAAe,CAAA;QAC7B,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,MAAM,CAAA;KACtB,CAAA;IACD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,KAAK,EAAE,MAAM,eAAe,CAAA;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,OAAO,EAAE,OAAO,CAAA;IAChC,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY;IAO/C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY;IAM9C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAMrC,2BAA2B;IAG/C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,SAAM;IAM/C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAM1B,IAAI;IAIJ,IAAI;CAGV;AAED,UAAU,2BAA4B,SAAQ,gBAAgB;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACvC;AAED,wBAAgB,sBAAsB,CACrC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACjC,gBAAgB,CAIlB"}
+{"version":3,"file":"next-server.d.ts","sourceRoot":"","sources":["../../../src/__tests__/mocks/next-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CACjB,GACJ,eAAe,CAyCjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE;QACR,QAAQ,EAAE,MAAM,CAAA;QAChB,MAAM,EAAE,MAAM,CAAA;QACd,YAAY,EAAE,eAAe,CAAA;QAC7B,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,QAAQ,EAAE,MAAM,MAAM,CAAA;KACtB,CAAA;IACD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,MAAM,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC5B,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3B,KAAK,EAAE,MAAM,eAAe,CAAA;CAC5B;AAED;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,SAAgB,MAAM,EAAE,MAAM,CAAA;IAC9B,SAAgB,UAAU,EAAE,MAAM,CAAA;IAClC,SAAgB,OAAO,EAAE,OAAO,CAAA;IAChC,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY;IAO/C,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,YAAY;IAM9C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,GAMrC,2BAA2B;IAG/C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,MAAM,SAAM;IAM/C,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAM1B,IAAI;IAIJ,IAAI;CAGV;AAED,UAAU,2BAA4B,SAAQ,gBAAgB;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACvC;AAED,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,gBAAgB,CAI5F"}

package/dist/__tests__/mocks/next-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"next-server.js","sourceRoot":"","sources":["../../../src/__tests__/mocks/next-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACpC,GAAW,EACX,UAII,EAAE;IAEN,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IAElD,MAAM,OAAO,GAAG;QACf,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,GAAG;QACH,OAAO;QACP,OAAO,EAAE;YACR,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE;SACpC;QACD,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,SAAS;QACzC,GAAG,EAAE;YACJ,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI;SACZ;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAA;YACzD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACrE,OAAO,EAAE,CAAA;QACV,CAAC;QACD,IAAI,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,OAAO,CAAC,IAAI,CAAA;YACzD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;YACzE,OAAO,EAAE,CAAA;QACV,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,GAAG,EAAE,OAAO,CAAC;KAChD,CAAA;IAED,OAAO,OAA0B,CAAA;AAClC,CAAC;AAiCD;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACZ,MAAM,CAAQ;IACd,UAAU,CAAQ;IAClB,OAAO,CAAS;IACxB,KAAK,CAAS;IAEtB,YAAY,IAAc,EAAE,IAAmB;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,GAAG,CAAA;QACjC,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,CAAA;QAC1C,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAa,EAAE,IAAmB;QAC7C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACjD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QACxD,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAA6C;QACxD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAC5D,IAAI,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YAC/B,qEAAqE;YACrE,CAAC;YAAC,QAAwC,CAAC,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAA;QACrF,CAAC;QACD,OAAO,QAAuC,CAAA;IAC/C,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,GAAiB,EAAE,MAAM,GAAG,GAAG;QAC9C,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAA;QACvD,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;QAChD,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAiB;QAC/B,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAC5D,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAA;QAC5D,OAAO,QAAQ,CAAA;IAChB,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAA;IAClB,CAAC;IAED,KAAK,CAAC,IAAI;QACT,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAChF,CAAC;CACD;AAaD,MAAM,UAAU,sBAAsB,CACrC,SAAiC,EAAE;IAEnC,OAAO;QACN,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;KAC/B,CAAA;AACF,CAAC"}
+{"version":3,"file":"next-server.js","sourceRoot":"","sources":["../../../src/__tests__/mocks/next-server.ts"],"names":[],"mappings":"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"}

package/dist/client/error-boundary.d.ts

@@ -0,0 +1,80 @@
+import { type ErrorInfo, type ReactNode } from 'react';
+import type { LogEntry } from 'vestig';
+/**
+ * Breadcrumb entry for error context
+ */
+export interface Breadcrumb {
+    timestamp: string;
+    level: string;
+    message: string;
+    namespace?: string;
+}
+/**
+ * Props for VestigErrorBoundary
+ */
+export interface VestigErrorBoundaryProps {
+    children: ReactNode;
+    /** Custom fallback UI (string, ReactNode, or function) */
+    fallback?: ReactNode | ((error: Error, errorInfo: ErrorInfo) => ReactNode);
+    /** Callback when error is caught */
+    onError?: (error: Error, errorInfo: ErrorInfo) => void;
+    /** Maximum breadcrumbs to keep (default: 20) */
+    maxBreadcrumbs?: number;
+    /** Whether to reset error state on navigation (default: true) */
+    resetOnNavigation?: boolean;
+}
+/**
+ * Add a breadcrumb (called from logging hooks)
+ */
+export declare function addBreadcrumb(entry: Partial<LogEntry>): void;
+/**
+ * Get recent breadcrumbs
+ */
+export declare function getBreadcrumbs(): readonly Breadcrumb[];
+/**
+ * Clear all breadcrumbs
+ */
+export declare function clearBreadcrumbs(): void;
+/**
+ * Error boundary component that automatically logs errors to Vestig
+ *
+ * Features:
+ * - Automatic error logging with full stack trace
+ * - Breadcrumb trail of recent logs before error
+ * - Component stack for debugging
+ * - Customizable fallback UI
+ *
+ * @example
+ * ```tsx
+ * import { VestigErrorBoundary } from '@vestig/next/client'
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <VestigProvider>
+ *       <VestigErrorBoundary
+ *         fallback={<ErrorPage />}
+ *         onError={(error) => console.error('Caught:', error)}
+ *       >
+ *         {children}
+ *       </VestigErrorBoundary>
+ *     </VestigProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @example Custom fallback function
+ * ```tsx
+ * <VestigErrorBoundary
+ *   fallback={(error, errorInfo) => (
+ *     <div>
+ *       <h1>Error: {error.message}</h1>
+ *       <pre>{errorInfo.componentStack}</pre>
+ *     </div>
+ *   )}
+ * >
+ *   {children}
+ * </VestigErrorBoundary>
+ * ```
+ */
+export declare function VestigErrorBoundary(props: VestigErrorBoundaryProps): ReactNode;
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/client/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","sourceRoot":"","sources":["../../src/client/error-boundary.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,KAAK,EAAU,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAG9C;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,QAAQ,EAAE,SAAS,CAAA;IACnB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,SAAS,CAAC,CAAA;IAC1E,oCAAoC;IACpC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAA;IACtD,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAiBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAY5D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,SAAS,UAAU,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AA6ID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,wBAAwB,GAAG,SAAS,CAE9E"}

package/dist/client/error-boundary.js

@@ -0,0 +1,182 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component } from 'react';
+import { useVestigContext } from './provider';
+/**
+ * Breadcrumb storage (module-level for simplicity)
+ */
+const breadcrumbs = [];
+let maxBreadcrumbSize = 20;
+/**
+ * Add a breadcrumb (called from logging hooks)
+ */
+export function addBreadcrumb(entry) {
+    breadcrumbs.push({
+        timestamp: entry.timestamp ?? new Date().toISOString(),
+        level: entry.level ?? 'info',
+        message: entry.message ?? '',
+        namespace: entry.namespace,
+    });
+    // Trim to max size
+    while (breadcrumbs.length > maxBreadcrumbSize) {
+        breadcrumbs.shift();
+    }
+}
+/**
+ * Get recent breadcrumbs
+ */
+export function getBreadcrumbs() {
+    return breadcrumbs;
+}
+/**
+ * Clear all breadcrumbs
+ */
+export function clearBreadcrumbs() {
+    breadcrumbs.length = 0;
+}
+/**
+ * Inner error boundary class component
+ */
+class VestigErrorBoundaryInner extends Component {
+    constructor(props) {
+        super(props);
+        this.state = {
+            hasError: false,
+            error: null,
+            errorInfo: null,
+        };
+        // Update max breadcrumb size
+        if (props.maxBreadcrumbs !== undefined) {
+            maxBreadcrumbSize = props.maxBreadcrumbs;
+        }
+    }
+    static getDerivedStateFromError(error) {
+        return { hasError: true, error };
+    }
+    componentDidCatch(error, errorInfo) {
+        this.setState({ errorInfo });
+        // Log the error with vestig
+        if (this.props.logger) {
+            this.props.logger.error('React component error', {
+                error: {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                },
+                componentStack: errorInfo.componentStack,
+                breadcrumbs: getBreadcrumbs(),
+            });
+        }
+        // Call custom error handler
+        this.props.onError?.(error, errorInfo);
+    }
+    /**
+     * Reset error state
+     */
+    resetError = () => {
+        this.setState({
+            hasError: false,
+            error: null,
+            errorInfo: null,
+        });
+        clearBreadcrumbs();
+    };
+    render() {
+        const { hasError, error, errorInfo } = this.state;
+        const { children, fallback } = this.props;
+        if (hasError && error) {
+            // Render fallback UI
+            if (typeof fallback === 'function') {
+                return fallback(error, errorInfo);
+            }
+            if (fallback !== undefined) {
+                return fallback;
+            }
+            // Default fallback
+            return (_jsxs("div", { role: "alert", style: {
+                    padding: '20px',
+                    margin: '20px',
+                    backgroundColor: '#fee2e2',
+                    border: '1px solid #ef4444',
+                    borderRadius: '8px',
+                    fontFamily: 'system-ui, sans-serif',
+                }, children: [_jsx("h2", { style: { color: '#dc2626', marginTop: 0 }, children: "Something went wrong" }), _jsx("p", { style: { color: '#7f1d1d' }, children: error.message }), _jsx("button", { onClick: this.resetError, style: {
+                            padding: '8px 16px',
+                            backgroundColor: '#dc2626',
+                            color: 'white',
+                            border: 'none',
+                            borderRadius: '4px',
+                            cursor: 'pointer',
+                        }, children: "Try again" }), process.env.NODE_ENV === 'development' && error.stack && (_jsx("pre", { style: {
+                            marginTop: '16px',
+                            padding: '12px',
+                            backgroundColor: '#fecaca',
+                            borderRadius: '4px',
+                            fontSize: '12px',
+                            overflow: 'auto',
+                            whiteSpace: 'pre-wrap',
+                            wordBreak: 'break-word',
+                        }, children: error.stack }))] }));
+        }
+        return children;
+    }
+}
+/**
+ * Wrapper to inject logger from context
+ */
+function VestigErrorBoundaryWrapper(props) {
+    let logger = null;
+    try {
+        const context = useVestigContext();
+        logger = context.logger;
+    }
+    catch {
+        // VestigProvider not available, log will be skipped
+    }
+    return _jsx(VestigErrorBoundaryInner, { ...props, logger: logger });
+}
+/**
+ * Error boundary component that automatically logs errors to Vestig
+ *
+ * Features:
+ * - Automatic error logging with full stack trace
+ * - Breadcrumb trail of recent logs before error
+ * - Component stack for debugging
+ * - Customizable fallback UI
+ *
+ * @example
+ * ```tsx
+ * import { VestigErrorBoundary } from '@vestig/next/client'
+ *
+ * export default function Layout({ children }) {
+ *   return (
+ *     <VestigProvider>
+ *       <VestigErrorBoundary
+ *         fallback={<ErrorPage />}
+ *         onError={(error) => console.error('Caught:', error)}
+ *       >
+ *         {children}
+ *       </VestigErrorBoundary>
+ *     </VestigProvider>
+ *   )
+ * }
+ * ```
+ *
+ * @example Custom fallback function
+ * ```tsx
+ * <VestigErrorBoundary
+ *   fallback={(error, errorInfo) => (
+ *     <div>
+ *       <h1>Error: {error.message}</h1>
+ *       <pre>{errorInfo.componentStack}</pre>
+ *     </div>
+ *   )}
+ * >
+ *   {children}
+ * </VestigErrorBoundary>
+ * ```
+ */
+export function VestigErrorBoundary(props) {
+    return _jsx(VestigErrorBoundaryWrapper, { ...props });
+}
+//# sourceMappingURL=error-boundary.js.map

package/dist/client/error-boundary.js.map

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

package/dist/client/index.d.ts

@@ -1,4 +1,5 @@
 export { VestigProvider, useVestigContext, type VestigProviderProps } from './provider';
 export { useLogger, useCorrelationContext, useVestigConnection, useComponentLogger, useRenderLogger, } from './hooks';
-export { ClientHTTPTransport, createClientTransport, type ClientHTTPTransportConfig, } from './transport';
+export { VestigErrorBoundary, addBreadcrumb, getBreadcrumbs, clearBreadcrumbs, type VestigErrorBoundaryProps, type Breadcrumb, } from './error-boundary';
+export { ClientHTTPTransport, createClientTransport, type ClientHTTPTransportConfig, type OfflineQueueConfig, } from './transport';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGvF,OAAO,EACN,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,yBAAyB,GAC9B,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGvF,OAAO,EACN,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACN,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,KAAK,wBAAwB,EAC7B,KAAK,UAAU,GACf,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,GACvB,MAAM,aAAa,CAAA"}

package/dist/client/index.js

@@ -4,6 +4,8 @@
 export { VestigProvider, useVestigContext } from './provider';
 // Hooks
 export { useLogger, useCorrelationContext, useVestigConnection, useComponentLogger, useRenderLogger, } from './hooks';
+// Error Boundary
+export { VestigErrorBoundary, addBreadcrumb, getBreadcrumbs, clearBreadcrumbs, } from './error-boundary';
 // Transport (for advanced use cases)
 export { ClientHTTPTransport, createClientTransport, } from './transport';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,8CAA8C;AAE9C,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA4B,MAAM,YAAY,CAAA;AAEvF,QAAQ;AACR,OAAO,EACN,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA;AAEhB,qCAAqC;AACrC,OAAO,EACN,mBAAmB,EACnB,qBAAqB,GAErB,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,8CAA8C;AAE9C,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAA4B,MAAM,YAAY,CAAA;AAEvF,QAAQ;AACR,OAAO,EACN,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,GACf,MAAM,SAAS,CAAA;AAEhB,iBAAiB;AACjB,OAAO,EACN,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,gBAAgB,GAGhB,MAAM,kBAAkB,CAAA;AAEzB,qCAAqC;AACrC,OAAO,EACN,mBAAmB,EACnB,qBAAqB,GAGrB,MAAM,aAAa,CAAA"}

package/dist/client/transport.d.ts

@@ -1,4 +1,19 @@
 import type { LogEntry, Transport, TransportConfig } from 'vestig';
+/**
+ * Configuration for offline queue persistence
+ */
+export interface OfflineQueueConfig {
+    /** Enable offline queue persistence (default: true) */
+    enabled?: boolean;
+    /** localStorage key for persisted queue (default: 'vestig:offline-queue') */
+    storageKey?: string;
+    /** Maximum entries to persist (default: 1000) */
+    maxSize?: number;
+    /** Callback when queue is restored from storage */
+    onRestore?: (count: number) => void;
+    /** Callback when queue is persisted to storage */
+    onPersist?: (count: number) => void;
+}
 /**
  * Configuration for ClientHTTPTransport
  */
@@ -19,6 +34,8 @@ export interface ClientHTTPTransportConfig extends TransportConfig {
     onFlushError?: (error: Error) => void;
     /** Callback when logs are dropped */
     onDrop?: (count: number) => void;
+    /** Offline queue configuration for persistence */
+    offlineQueue?: OfflineQueueConfig;
 }
 /**
  * HTTP transport for client-side log batching
@@ -28,6 +45,7 @@ export interface ClientHTTPTransportConfig extends TransportConfig {
  * - Retry with exponential backoff
  * - Uses keepalive for beforeunload reliability
  * - Automatic page metadata enrichment
+ * - Offline queue persistence with localStorage
  */
 export declare class ClientHTTPTransport implements Transport {
     readonly name: string;
@@ -40,17 +58,41 @@ export declare class ClientHTTPTransport implements Transport {
     private onFlushSuccess?;
     private onFlushError?;
     private onDrop?;
+    private offlineEnabled;
+    private offlineStorageKey;
+    private offlineMaxSize;
+    private onOfflineRestore?;
+    private onOfflinePersist?;
     private buffer;
     private flushTimer;
     private isFlushing;
     private isDestroyed;
     private maxBufferSize;
+    private isOnline;
+    private boundOnlineHandler;
+    private boundOfflineHandler;
     constructor(config: ClientHTTPTransportConfig);
     init(): Promise<void>;
+    private handleOnline;
+    private handleOffline;
+    private restoreOfflineQueue;
+    private persistOfflineQueue;
     log(entry: LogEntry): void;
     flush(): Promise<void>;
     private sendWithRetry;
     destroy(): Promise<void>;
+    /**
+     * Get current online status
+     */
+    getOnlineStatus(): boolean;
+    /**
+     * Get current buffer size
+     */
+    getBufferSize(): number;
+    /**
+     * Manually trigger offline queue persistence
+     */
+    persistNow(): void;
 }
 /**
  * Create a client HTTP transport with default configuration

package/dist/client/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAElE;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,eAAe;IACjE,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAA;IACX,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,mCAAmC;IACnC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IACrC,qCAAqC;IACrC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAChC;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,SAAS;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAEhC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAY;IACnC,OAAO,CAAC,YAAY,CAAC,CAAwB;IAC7C,OAAO,CAAC,MAAM,CAAC,CAAyB;IAExC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAAM;gBAEf,MAAM,EAAE,yBAAyB;IAavC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,GAAG,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAiCpB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA6Bd,aAAa;IA+BrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAc9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,GAAE,OAAO,CAAC,yBAAyB,CAAM,GAC9C,mBAAmB,CAMrB"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/client/transport.ts"],"names":[],"mappings":"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"}

package/dist/client/transport.js

@@ -7,6 +7,7 @@
  * - Retry with exponential backoff
  * - Uses keepalive for beforeunload reliability
  * - Automatic page metadata enrichment
+ * - Offline queue persistence with localStorage
  */
 export class ClientHTTPTransport {
     name;
@@ -19,11 +20,20 @@ export class ClientHTTPTransport {
     onFlushSuccess;
     onFlushError;
     onDrop;
+    // Offline queue config
+    offlineEnabled;
+    offlineStorageKey;
+    offlineMaxSize;
+    onOfflineRestore;
+    onOfflinePersist;
     buffer = [];
     flushTimer = null;
     isFlushing = false;
     isDestroyed = false;
     maxBufferSize = 500;
+    isOnline = true;
+    boundOnlineHandler;
+    boundOfflineHandler;
     constructor(config) {
         this.name = config.name;
         this.config = { name: config.name, enabled: config.enabled ?? true };
@@ -35,13 +45,104 @@ export class ClientHTTPTransport {
         this.onFlushSuccess = config.onFlushSuccess;
         this.onFlushError = config.onFlushError;
         this.onDrop = config.onDrop;
+        // Offline queue settings
+        const offlineConfig = config.offlineQueue ?? {};
+        this.offlineEnabled = offlineConfig.enabled ?? true;
+        this.offlineStorageKey = offlineConfig.storageKey ?? 'vestig:offline-queue';
+        this.offlineMaxSize = offlineConfig.maxSize ?? 1000;
+        this.onOfflineRestore = offlineConfig.onRestore;
+        this.onOfflinePersist = offlineConfig.onPersist;
+        // Initialize network status (default to true if navigator.onLine is not available)
+        this.isOnline =
+            typeof navigator !== 'undefined' && navigator.onLine !== undefined ? navigator.onLine : true;
+        // Bind handlers for cleanup
+        this.boundOnlineHandler = this.handleOnline.bind(this);
+        this.boundOfflineHandler = this.handleOffline.bind(this);
     }
     async init() {
+        // Restore offline queue if any
+        if (this.offlineEnabled) {
+            this.restoreOfflineQueue();
+        }
+        // Listen for network status changes
+        if (typeof window !== 'undefined') {
+            window.addEventListener('online', this.boundOnlineHandler);
+            window.addEventListener('offline', this.boundOfflineHandler);
+        }
         // Start flush timer
         this.flushTimer = setInterval(() => {
             this.flush();
         }, this.flushInterval);
     }
+    handleOnline() {
+        this.isOnline = true;
+        // Attempt to flush when back online
+        this.flush();
+    }
+    handleOffline() {
+        this.isOnline = false;
+        // Persist current buffer to offline storage
+        if (this.offlineEnabled && this.buffer.length > 0) {
+            this.persistOfflineQueue();
+        }
+    }
+    restoreOfflineQueue() {
+        if (typeof localStorage === 'undefined')
+            return;
+        try {
+            const stored = localStorage.getItem(this.offlineStorageKey);
+            if (!stored)
+                return;
+            const entries = JSON.parse(stored);
+            if (!Array.isArray(entries) || entries.length === 0)
+                return;
+            // Add restored entries to the front of the buffer
+            this.buffer.unshift(...entries);
+            // Enforce max buffer size
+            if (this.buffer.length > this.maxBufferSize) {
+                const excess = this.buffer.length - this.maxBufferSize;
+                this.buffer.splice(this.maxBufferSize);
+                this.onDrop?.(excess);
+            }
+            // Clear stored queue
+            localStorage.removeItem(this.offlineStorageKey);
+            this.onOfflineRestore?.(entries.length);
+        }
+        catch {
+            // Silently ignore parsing errors
+        }
+    }
+    persistOfflineQueue() {
+        if (typeof localStorage === 'undefined')
+            return;
+        try {
+            // Merge existing stored entries with current buffer
+            let toStore = [...this.buffer];
+            const existingStored = localStorage.getItem(this.offlineStorageKey);
+            if (existingStored) {
+                try {
+                    const existing = JSON.parse(existingStored);
+                    if (Array.isArray(existing)) {
+                        toStore = [...existing, ...toStore];
+                    }
+                }
+                catch {
+                    // Ignore parse errors
+                }
+            }
+            // Enforce max size
+            if (toStore.length > this.offlineMaxSize) {
+                const excess = toStore.length - this.offlineMaxSize;
+                toStore = toStore.slice(excess);
+                this.onDrop?.(excess);
+            }
+            localStorage.setItem(this.offlineStorageKey, JSON.stringify(toStore));
+            this.onOfflinePersist?.(toStore.length);
+        }
+        catch {
+            // Silently ignore storage errors (quota exceeded, etc.)
+        }
+    }
     log(entry) {
         if (this.isDestroyed)
             return;
@@ -74,6 +175,13 @@ export class ClientHTTPTransport {
         if (this.isFlushing || this.buffer.length === 0 || this.isDestroyed) {
             return;
         }
+        // If offline, persist to storage instead of sending
+        if (!this.isOnline) {
+            if (this.offlineEnabled) {
+                this.persistOfflineQueue();
+            }
+            return;
+        }
         this.isFlushing = true;
         const entries = [...this.buffer];
         this.buffer = [];
@@ -90,6 +198,10 @@ export class ClientHTTPTransport {
                 this.buffer.splice(this.maxBufferSize);
                 this.onDrop?.(excess);
             }
+            // If send failed, might be network issue - persist to offline queue
+            if (this.offlineEnabled) {
+                this.persistOfflineQueue();
+            }
             this.onFlushError?.(error instanceof Error ? error : new Error(String(error)));
         }
         finally {
@@ -124,16 +236,45 @@ export class ClientHTTPTransport {
     }
     async destroy() {
         this.isDestroyed = true;
+        // Remove network event listeners
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('online', this.boundOnlineHandler);
+            window.removeEventListener('offline', this.boundOfflineHandler);
+        }
         if (this.flushTimer) {
             clearInterval(this.flushTimer);
             this.flushTimer = null;
         }
-        // Final flush attempt
-        if (this.buffer.length > 0) {
+        // Persist remaining buffer to offline storage
+        if (this.offlineEnabled && this.buffer.length > 0) {
+            this.persistOfflineQueue();
+        }
+        // Final flush attempt if online
+        if (this.buffer.length > 0 && this.isOnline) {
             this.isFlushing = false; // Reset to allow final flush
             await this.flush();
         }
     }
+    /**
+     * Get current online status
+     */
+    getOnlineStatus() {
+        return this.isOnline;
+    }
+    /**
+     * Get current buffer size
+     */
+    getBufferSize() {
+        return this.buffer.length;
+    }
+    /**
+     * Manually trigger offline queue persistence
+     */
+    persistNow() {
+        if (this.offlineEnabled) {
+            this.persistOfflineQueue();
+        }
+    }
 }
 /**
  * Create a client HTTP transport with default configuration