npm - @vestig/next - Versions diffs - 0.3.1 - Mend

@vestig/next 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (86) hide show

package/README.md +290 -0
package/dist/client/hooks.d.ts +95 -0
package/dist/client/hooks.d.ts.map +1 -0
package/dist/client/hooks.js +128 -0
package/dist/client/hooks.js.map +1 -0
package/dist/client/index.d.ts +4 -0
package/dist/client/index.d.ts.map +1 -0
package/dist/client/index.js +9 -0
package/dist/client/index.js.map +1 -0
package/dist/client/provider.d.ts +66 -0
package/dist/client/provider.d.ts.map +1 -0
package/dist/client/provider.js +126 -0
package/dist/client/provider.js.map +1 -0
package/dist/client/transport.d.ts +59 -0
package/dist/client/transport.d.ts.map +1 -0
package/dist/client/transport.js +148 -0
package/dist/client/transport.js.map +1 -0
package/dist/client.d.ts +43 -0
package/dist/client.d.ts.map +1 -0
package/dist/client.js +47 -0
package/dist/client.js.map +1 -0
package/dist/config/defaults.d.ts +10 -0
package/dist/config/defaults.d.ts.map +1 -0
package/dist/config/defaults.js +72 -0
package/dist/config/defaults.js.map +1 -0
package/dist/config/index.d.ts +116 -0
package/dist/config/index.d.ts.map +1 -0
package/dist/config/index.js +27 -0
package/dist/config/index.js.map +1 -0
package/dist/config/loader.d.ts +21 -0
package/dist/config/loader.d.ts.map +1 -0
package/dist/config/loader.js +31 -0
package/dist/config/loader.js.map +1 -0
package/dist/index.d.ts +42 -0
package/dist/index.d.ts.map +1 -0
package/dist/index.js +43 -0
package/dist/index.js.map +1 -0
package/dist/route/handler.d.ts +56 -0
package/dist/route/handler.d.ts.map +1 -0
package/dist/route/handler.js +250 -0
package/dist/route/handler.js.map +1 -0
package/dist/route/index.d.ts +2 -0
package/dist/route/index.d.ts.map +1 -0
package/dist/route/index.js +3 -0
package/dist/route/index.js.map +1 -0
package/dist/server/index.d.ts +5 -0
package/dist/server/index.d.ts.map +1 -0
package/dist/server/index.js +10 -0
package/dist/server/index.js.map +1 -0
package/dist/server/middleware.d.ts +108 -0
package/dist/server/middleware.d.ts.map +1 -0
package/dist/server/middleware.js +182 -0
package/dist/server/middleware.js.map +1 -0
package/dist/server/route-handler.d.ts +93 -0
package/dist/server/route-handler.d.ts.map +1 -0
package/dist/server/route-handler.js +160 -0
package/dist/server/route-handler.js.map +1 -0
package/dist/server/server-action.d.ts +74 -0
package/dist/server/server-action.d.ts.map +1 -0
package/dist/server/server-action.js +132 -0
package/dist/server/server-action.js.map +1 -0
package/dist/server/server-component.d.ts +87 -0
package/dist/server/server-component.d.ts.map +1 -0
package/dist/server/server-component.js +122 -0
package/dist/server/server-component.js.map +1 -0
package/dist/types.d.ts +80 -0
package/dist/types.d.ts.map +1 -0
package/dist/types.js +5 -0
package/dist/types.js.map +1 -0
package/dist/utils/headers.d.ts +38 -0
package/dist/utils/headers.d.ts.map +1 -0
package/dist/utils/headers.js +42 -0
package/dist/utils/headers.js.map +1 -0
package/dist/utils/index.d.ts +4 -0
package/dist/utils/index.d.ts.map +1 -0
package/dist/utils/index.js +4 -0
package/dist/utils/index.js.map +1 -0
package/dist/utils/metadata.d.ts +41 -0
package/dist/utils/metadata.d.ts.map +1 -0
package/dist/utils/metadata.js +46 -0
package/dist/utils/metadata.js.map +1 -0
package/dist/utils/timing.d.ts +31 -0
package/dist/utils/timing.d.ts.map +1 -0
package/dist/utils/timing.js +46 -0
package/dist/utils/timing.js.map +1 -0
package/package.json +88 -0

package/README.md ADDED Viewed

@@ -0,0 +1,290 @@
+# @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.
+## Features
+- **Automatic Request Correlation** - requestId, traceId, and spanId propagated across all logs
+- **Middleware Integration** - Automatic request/response logging with timing
+- **Server Components** - `getLogger()` with React `cache()` for per-request loggers
+- **Route Handlers** - `withVestig()` wrapper with full context
+- **Server Actions** - `vestigAction()` for action logging
+- **Client Components** - `useLogger()` hook with automatic server sync
+- **PII Sanitization** - All vestig sanitization presets work seamlessly
+- **Edge Runtime Compatible** - Works in Edge middleware and Vercel Edge Functions
+## Installation
+```bash
+npm install @vestig/next vestig
+# or
+bun add @vestig/next vestig
+```
+## Quick Start
+### 1. Add Middleware
+```typescript
+// middleware.ts
+import { createVestigMiddleware } from '@vestig/next/middleware'
+export const middleware = createVestigMiddleware({
+  level: 'info',
+  skipPaths: ['/_next', '/favicon.ico'],
+})
+export const config = {
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}
+```
+### 2. Wrap Your Layout
+```typescript
+// app/layout.tsx
+import { VestigProvider } from '@vestig/next/client'
+import { getRequestContext } from '@vestig/next'
+export default async function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  const ctx = await getRequestContext()
+  return (
+    <html>
+      <body>
+        <VestigProvider initialContext={ctx} endpoint="/api/vestig" namespace="client">
+          {children}
+        </VestigProvider>
+      </body>
+    </html>
+  )
+}
+```
+### 3. Add the Vestig API Route (Optional)
+```typescript
+// app/api/vestig/route.ts
+import { createVestigHandler } from '@vestig/next/route'
+export const { GET, POST, DELETE } = createVestigHandler({
+  maxLogs: 500,
+  enableSSE: true,
+})
+```
+## Usage
+### Server Components
+```typescript
+// app/users/page.tsx
+import { getLogger, getRequestContext } from '@vestig/next'
+export default async function UsersPage() {
+  const log = await getLogger('users-page')
+  const ctx = await getRequestContext()
+  log.info('Rendering users page', { requestId: ctx.requestId })
+  const users = await fetchUsers()
+  log.debug('Users fetched', { count: users.length })
+  return <UserList users={users} />
+}
+```
+### Route Handlers
+```typescript
+// app/api/users/route.ts
+import { withVestig } from '@vestig/next'
+export const GET = withVestig(
+  async (request, { log, ctx, timing }) => {
+    log.debug('Fetching users from database')
+    const users = await db.users.findMany()
+    log.info('Users fetched', {
+      count: users.length,
+      duration: `${timing.elapsed().toFixed(2)}ms`,
+    })
+    return Response.json({
+      users,
+      meta: { requestId: ctx.requestId },
+    })
+  },
+  { namespace: 'api:users', level: 'debug' }
+)
+```
+### Client Components
+```typescript
+'use client'
+import { useLogger, useCorrelationContext } from '@vestig/next/client'
+export default function UserProfile() {
+  const log = useLogger('user-profile')
+  const ctx = useCorrelationContext()
+  useEffect(() => {
+    log.info('Profile loaded', { requestId: ctx.requestId })
+  }, [log, ctx.requestId])
+  const handleClick = () => {
+    log.info('Button clicked', {
+      email: 'user@example.com', // Auto-sanitized!
+    })
+  }
+  return <button onClick={handleClick}>Click me</button>
+}
+```
+### Server Actions
+```typescript
+// app/actions/user-actions.ts
+'use server'
+import { vestigAction } from '@vestig/next'
+export const createUser = vestigAction(
+  async (data: { name: string; email: string }, { log, ctx }) => {
+    log.debug('Validating user data')
+    const user = await db.users.create({ data })
+    log.info('User created', { userId: user.id })
+    return user
+  },
+  { namespace: 'actions:createUser' }
+)
+```
+## API Reference
+### Middleware
+#### `createVestigMiddleware(options)`
+Create a middleware with custom configuration.
+```typescript
+createVestigMiddleware({
+  level?: 'trace' | 'debug' | 'info' | 'warn' | 'error',
+  enabled?: boolean,
+  sanitize?: 'none' | 'minimal' | 'default' | 'gdpr' | 'hipaa' | 'pci-dss',
+  namespace?: string,
+  skipPaths?: string[],
+  timing?: boolean,
+  requestLogLevel?: LogLevel,
+  responseLogLevel?: LogLevel,
+})
+```
+### Server Components
+#### `getLogger(namespace?)`
+Get a request-scoped logger in Server Components.
+```typescript
+const log = await getLogger('my-component')
+log.info('Hello world')
+```
+#### `getRequestContext()`
+Get the correlation context from the current request.
+```typescript
+const ctx = await getRequestContext()
+// { requestId, traceId, spanId, ... }
+```
+### Route Handlers
+#### `withVestig(handler, options)`
+Wrap a route handler with automatic logging.
+```typescript
+export const GET = withVestig(
+  async (request, { log, ctx, timing, params }) => {
+    // Your handler logic
+    return Response.json({ data })
+  },
+  {
+    namespace?: string,
+    level?: LogLevel,
+    sanitize?: SanitizePreset,
+    logRequest?: boolean,
+    logResponse?: boolean,
+  }
+)
+```
+### Client Components
+#### `useLogger(namespace?)`
+Get a logger instance in Client Components. No `useMemo` needed - the hook returns a stable reference.
+```typescript
+const log = useLogger('my-component')
+```
+#### `useCorrelationContext()`
+Get the correlation context passed from the server.
+```typescript
+const ctx = useCorrelationContext()
+// { requestId, traceId, spanId }
+```
+### VestigProvider Props
+```typescript
+<VestigProvider
+  initialContext={ctx}    // From getRequestContext()
+  endpoint="/api/vestig"  // Where to send client logs
+  namespace="client"      // Base namespace for client logs
+  level="info"            // Minimum log level
+  sanitize="default"      // PII sanitization preset
+  batchSize={10}          // Batch size for HTTP transport
+  flushInterval={2000}    // Flush interval in ms
+>
+```
+## Log Levels
+All vestig log levels are supported:
+- `trace` - Most verbose, for detailed debugging
+- `debug` - Debug information
+- `info` - General information
+- `warn` - Warning messages
+- `error` - Error messages
+## PII Sanitization
+All vestig sanitization presets work automatically:
+- `none` - No sanitization
+- `minimal` - Passwords only
+- `default` - Passwords, credit cards, SSNs
+- `gdpr` - EU GDPR compliance
+- `hipaa` - Healthcare compliance
+- `pci-dss` - Payment card compliance
+## License
+MIT

package/dist/client/hooks.d.ts ADDED Viewed

@@ -0,0 +1,95 @@
+import type { LogContext, Logger } from 'vestig';
+/**
+ * Get a logger instance in client components
+ *
+ * Optionally create a child logger with a namespace.
+ * No need for useMemo - this hook handles it internally.
+ *
+ * @param namespace - Optional namespace for the logger
+ *
+ * @example
+ * ```typescript
+ * // components/UserForm.tsx
+ * 'use client'
+ *
+ * import { useLogger } from '@vestig/next/client'
+ *
+ * export function UserForm() {
+ *   const log = useLogger('user-form')
+ *
+ *   const handleSubmit = (data: FormData) => {
+ *     log.info('Form submitted', {
+ *       email: data.get('email'), // Will be sanitized
+ *     })
+ *   }
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>
+ * }
+ * ```
+ */
+export declare function useLogger(namespace?: string): Logger;
+/**
+ * Get the current correlation context
+ *
+ * Useful for passing IDs to external services or child components.
+ *
+ * @example
+ * ```typescript
+ * const ctx = useCorrelationContext()
+ * console.log(ctx.requestId) // "abc-123" or "client-xyz-456"
+ * ```
+ */
+export declare function useCorrelationContext(): LogContext;
+/**
+ * Check if client logging is connected to server
+ *
+ * @example
+ * ```typescript
+ * const isConnected = useVestigConnection()
+ * // Show indicator if logs are being sent successfully
+ * ```
+ */
+export declare function useVestigConnection(): boolean;
+/**
+ * Create a component-scoped logger with optional lifecycle logging
+ *
+ * @param componentName - Name of the component (used as namespace)
+ * @param options - Configuration options
+ *
+ * @example
+ * ```typescript
+ * function Dashboard() {
+ *   const log = useComponentLogger('Dashboard', { logLifecycle: true })
+ *   // Logs: "Component mounted" on mount
+ *   // Logs: "Component unmounting" on unmount
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export declare function useComponentLogger(componentName: string, options?: {
+    /** Log mount/unmount lifecycle events (default: false) */
+    logLifecycle?: boolean;
+    /** Additional context to include in all logs */
+    context?: Record<string, unknown>;
+}): Logger;
+/**
+ * Create a logger that tracks render count
+ *
+ * Useful for debugging performance issues.
+ *
+ * @example
+ * ```typescript
+ * function ExpensiveComponent() {
+ *   const { log, renderCount } = useRenderLogger('ExpensiveComponent')
+ *   // Logs render count on each render
+ *
+ *   return <div>Rendered {renderCount} times</div>
+ * }
+ * ```
+ */
+export declare function useRenderLogger(componentName: string): {
+    log: Logger;
+    renderCount: number;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/client/hooks.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAGhD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CAGlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CACjC,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;IACR,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5B,GACJ,MAAM,CAyBR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG;IACvD,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;CACnB,CAWA"}

package/dist/client/hooks.js ADDED Viewed

@@ -0,0 +1,128 @@
+'use client';
+import { useEffect, useMemo, useRef } from 'react';
+import { useVestigContext } from './provider';
+/**
+ * Get a logger instance in client components
+ *
+ * Optionally create a child logger with a namespace.
+ * No need for useMemo - this hook handles it internally.
+ *
+ * @param namespace - Optional namespace for the logger
+ *
+ * @example
+ * ```typescript
+ * // components/UserForm.tsx
+ * 'use client'
+ *
+ * import { useLogger } from '@vestig/next/client'
+ *
+ * export function UserForm() {
+ *   const log = useLogger('user-form')
+ *
+ *   const handleSubmit = (data: FormData) => {
+ *     log.info('Form submitted', {
+ *       email: data.get('email'), // Will be sanitized
+ *     })
+ *   }
+ *
+ *   return <form onSubmit={handleSubmit}>...</form>
+ * }
+ * ```
+ */
+export function useLogger(namespace) {
+    const { logger } = useVestigContext();
+    return useMemo(() => {
+        return namespace ? logger.child(namespace) : logger;
+    }, [logger, namespace]);
+}
+/**
+ * Get the current correlation context
+ *
+ * Useful for passing IDs to external services or child components.
+ *
+ * @example
+ * ```typescript
+ * const ctx = useCorrelationContext()
+ * console.log(ctx.requestId) // "abc-123" or "client-xyz-456"
+ * ```
+ */
+export function useCorrelationContext() {
+    const { context } = useVestigContext();
+    return context;
+}
+/**
+ * Check if client logging is connected to server
+ *
+ * @example
+ * ```typescript
+ * const isConnected = useVestigConnection()
+ * // Show indicator if logs are being sent successfully
+ * ```
+ */
+export function useVestigConnection() {
+    const { isConnected } = useVestigContext();
+    return isConnected;
+}
+/**
+ * Create a component-scoped logger with optional lifecycle logging
+ *
+ * @param componentName - Name of the component (used as namespace)
+ * @param options - Configuration options
+ *
+ * @example
+ * ```typescript
+ * function Dashboard() {
+ *   const log = useComponentLogger('Dashboard', { logLifecycle: true })
+ *   // Logs: "Component mounted" on mount
+ *   // Logs: "Component unmounting" on unmount
+ *
+ *   return <div>...</div>
+ * }
+ * ```
+ */
+export function useComponentLogger(componentName, options = {}) {
+    const { logger } = useVestigContext();
+    const { logLifecycle = false, context } = options;
+    const log = useMemo(() => {
+        return logger.child(componentName, context ? { context } : undefined);
+    }, [logger, componentName, context]);
+    // Track if this is initial mount
+    const isMounted = useRef(false);
+    useEffect(() => {
+        if (logLifecycle && !isMounted.current) {
+            log.debug('Component mounted');
+            isMounted.current = true;
+        }
+        return () => {
+            if (logLifecycle) {
+                log.debug('Component unmounting');
+            }
+        };
+    }, [log, logLifecycle]);
+    return log;
+}
+/**
+ * Create a logger that tracks render count
+ *
+ * Useful for debugging performance issues.
+ *
+ * @example
+ * ```typescript
+ * function ExpensiveComponent() {
+ *   const { log, renderCount } = useRenderLogger('ExpensiveComponent')
+ *   // Logs render count on each render
+ *
+ *   return <div>Rendered {renderCount} times</div>
+ * }
+ * ```
+ */
+export function useRenderLogger(componentName) {
+    const log = useLogger(componentName);
+    const renderCount = useRef(0);
+    renderCount.current += 1;
+    useEffect(() => {
+        log.trace('Component rendered', { renderCount: renderCount.current });
+    });
+    return { log, renderCount: renderCount.current };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/client/hooks.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAElD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,SAAS,CAAC,SAAkB;IAC3C,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAErC,OAAO,OAAO,CAAC,GAAG,EAAE;QACnB,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IACpD,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB;IACpC,MAAM,EAAE,OAAO,EAAE,GAAG,gBAAgB,EAAE,CAAA;IACtC,OAAO,OAAO,CAAA;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB;IAClC,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAC1C,OAAO,WAAW,CAAA;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CACjC,aAAqB,EACrB,UAKI,EAAE;IAEN,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAA;IACrC,MAAM,EAAE,YAAY,GAAG,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAA;IAEjD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;QACxB,OAAO,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IACtE,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC,CAAA;IAEpC,iCAAiC;IACjC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE/B,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,YAAY,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACxC,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;YAC9B,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;QACzB,CAAC;QAED,OAAO,GAAG,EAAE;YACX,IAAI,YAAY,EAAE,CAAC;gBAClB,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAA;YAClC,CAAC;QACF,CAAC,CAAA;IACF,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAA;IAEvB,OAAO,GAAG,CAAA;AACX,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,aAAqB;IAIpD,MAAM,GAAG,GAAG,SAAS,CAAC,aAAa,CAAC,CAAA;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;IAE7B,WAAW,CAAC,OAAO,IAAI,CAAC,CAAA;IAExB,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,WAAW,CAAC,OAAO,EAAE,CAAA;AACjD,CAAC"}

package/dist/client/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export { VestigProvider, useVestigContext, type VestigProviderProps } from './provider';
+export { useLogger, useCorrelationContext, useVestigConnection, useComponentLogger, useRenderLogger, } from './hooks';
+export { ClientHTTPTransport, createClientTransport, type ClientHTTPTransportConfig, } from './transport';
+//# sourceMappingURL=index.d.ts.map

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

	@@ -0,0 +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"}

package/dist/client/index.js ADDED Viewed

@@ -0,0 +1,9 @@
+'use client';
+// Client-side exports for @vestig/next/client
+// Provider
+export { VestigProvider, useVestigContext } from './provider';
+// Hooks
+export { useLogger, useCorrelationContext, useVestigConnection, useComponentLogger, useRenderLogger, } from './hooks';
+// Transport (for advanced use cases)
+export { ClientHTTPTransport, createClientTransport, } from './transport';
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map ADDED Viewed

	@@ -0,0 +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"}

package/dist/client/provider.d.ts ADDED Viewed

@@ -0,0 +1,66 @@
+import { type ReactNode } from 'react';
+import { type LogContext, type Logger } from 'vestig';
+/**
+ * Context value provided by VestigProvider
+ */
+interface VestigContextValue {
+    /** Logger instance */
+    logger: Logger;
+    /** Correlation context */
+    context: LogContext;
+    /** Whether client is connected to server */
+    isConnected: boolean;
+}
+/**
+ * Props for VestigProvider
+ */
+export interface VestigProviderProps {
+    children: ReactNode;
+    /** Initial correlation context (e.g., from server) */
+    initialContext?: LogContext;
+    /** Override endpoint URL (default: '/api/vestig') */
+    endpoint?: string;
+    /** Logger namespace (default: 'client') */
+    namespace?: string;
+    /** Additional static context */
+    context?: Record<string, unknown>;
+}
+/**
+ * Provider component for client-side vestig logging
+ *
+ * Provides:
+ * - Automatic log batching and sending to server
+ * - Request correlation with server
+ * - React context for accessing logger
+ *
+ * @example
+ * ```typescript
+ * // app/layout.tsx
+ * import { VestigProvider } from '@vestig/next/client'
+ * import { getRequestContext } from '@vestig/next'
+ *
+ * export default async function RootLayout({ children }) {
+ *   // Get server context for correlation
+ *   const ctx = await getRequestContext()
+ *
+ *   return (
+ *     <html>
+ *       <body>
+ *         <VestigProvider initialContext={ctx}>
+ *           {children}
+ *         </VestigProvider>
+ *       </body>
+ *     </html>
+ *   )
+ * }
+ * ```
+ */
+export declare function VestigProvider({ children, initialContext, endpoint, namespace, context: staticContext, }: VestigProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Get the full vestig context
+ *
+ * @throws Error if used outside VestigProvider
+ */
+export declare function useVestigContext(): VestigContextValue;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/client/provider.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/client/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,EACN,KAAK,SAAS,EAOd,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,MAAM,EAAgB,MAAM,QAAQ,CAAA;AAGnE;;GAEG;AACH,UAAU,kBAAkB;IAC3B,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,0BAA0B;IAC1B,OAAO,EAAE,UAAU,CAAA;IACnB,4CAA4C;IAC5C,WAAW,EAAE,OAAO,CAAA;CACpB;AAID;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC,QAAQ,EAAE,SAAS,CAAA;IACnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,UAAU,CAAA;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,cAAc,CAAC,EAC9B,QAAQ,EACR,cAAc,EACd,QAAwB,EACxB,SAAoB,EACpB,OAAO,EAAE,aAAa,GACtB,EAAE,mBAAmB,2CAyFrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,CAMrD"}