@vestig/next 0.11.4 → 0.13.0

package/dist/wide-events/middleware.js

@@ -0,0 +1,160 @@
+import { NextResponse } from 'next/server';
+import { createCorrelationContext, createLogger, createTraceparent, createWideEvent, parseTraceparent, } from 'vestig';
+import { CORRELATION_HEADERS } from '../utils/headers';
+import { runWithWideEvent } from './context';
+const DEFAULT_OPTIONS = {
+    level: 'info',
+    enabled: true,
+    sanitize: 'default',
+    skipPaths: ['/_next', '/favicon.ico', '/api/vestig'],
+    requestIdHeader: CORRELATION_HEADERS.REQUEST_ID,
+    structured: true,
+};
+// Cached logger per middleware instance
+const loggerCache = new WeakMap();
+function getOrCreateLogger(options) {
+    const cached = loggerCache.get(options);
+    if (cached)
+        return cached;
+    const logger = createLogger({
+        level: options.level,
+        enabled: options.enabled,
+        sanitize: options.sanitize,
+        structured: options.structured,
+        tailSampling: options.tailSampling,
+    });
+    loggerCache.set(options, logger);
+    return logger;
+}
+/**
+ * Create wide event middleware for Next.js
+ *
+ * This middleware automatically creates a wide event for each request
+ * and populates it with HTTP context. The wide event is available
+ * throughout the request lifecycle via `getWideEvent()`.
+ *
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * import { createWideEventMiddleware } from '@vestig/next/wide-events'
+ *
+ * export const middleware = createWideEventMiddleware({
+ *   skipPaths: ['/health', '/metrics'],
+ *   tailSampling: {
+ *     enabled: true,
+ *     alwaysKeepStatuses: ['error'],
+ *     slowThresholdMs: 2000,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ *
+ * export const config = {
+ *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+ * }
+ * ```
+ */
+export function createWideEventMiddleware(options = {}) {
+    const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
+    return async function wideEventMiddleware(request) {
+        // Skip configured paths
+        const pathname = request.nextUrl.pathname;
+        const skipPaths = mergedOptions.skipPaths ?? DEFAULT_OPTIONS.skipPaths ?? [];
+        if (skipPaths.some((p) => pathname.startsWith(p))) {
+            return NextResponse.next();
+        }
+        const logger = getOrCreateLogger(mergedOptions);
+        const startTime = performance.now();
+        // Extract or generate correlation context
+        const requestIdHeader = mergedOptions.requestIdHeader ??
+            DEFAULT_OPTIONS.requestIdHeader ??
+            CORRELATION_HEADERS.REQUEST_ID;
+        const existingRequestId = request.headers.get(requestIdHeader) ?? undefined;
+        const traceparent = request.headers.get(CORRELATION_HEADERS.TRACEPARENT);
+        const parsed = traceparent ? parseTraceparent(traceparent) : null;
+        const ctx = createCorrelationContext({
+            requestId: existingRequestId,
+            traceId: parsed?.traceId,
+            spanId: parsed?.spanId,
+        });
+        // Create wide event for this request
+        const event = createWideEvent({
+            type: 'http.request',
+            context: {
+                requestId: ctx.requestId,
+                traceId: ctx.traceId,
+                spanId: ctx.spanId,
+            },
+        });
+        // Populate initial HTTP context
+        event.merge('http', {
+            method: request.method,
+            path: pathname,
+            search: request.nextUrl.search || undefined,
+            host: request.headers.get('host'),
+        });
+        // Add user context from headers if available
+        const userAgent = request.headers.get('user-agent');
+        const ip = request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??
+            request.headers.get('x-real-ip');
+        if (userAgent || ip) {
+            event.merge('client', {
+                userAgent: userAgent?.slice(0, 200),
+                ip,
+            });
+        }
+        // Create request context
+        const eventContext = {
+            event,
+            startTime,
+        };
+        // Run middleware with wide event context
+        // These are guaranteed to exist from createCorrelationContext
+        const requestId = ctx.requestId ?? '';
+        const traceId = ctx.traceId ?? '';
+        const spanId = ctx.spanId ?? '';
+        return runWithWideEvent(eventContext, () => {
+            // Create new headers with correlation IDs
+            const requestHeaders = new Headers(request.headers);
+            requestHeaders.set(CORRELATION_HEADERS.REQUEST_ID, requestId);
+            requestHeaders.set(CORRELATION_HEADERS.TRACE_ID, traceId);
+            requestHeaders.set(CORRELATION_HEADERS.SPAN_ID, spanId);
+            requestHeaders.set(CORRELATION_HEADERS.TRACEPARENT, createTraceparent(traceId, spanId));
+            // Create response with updated headers
+            const response = NextResponse.next({
+                request: {
+                    headers: requestHeaders,
+                },
+            });
+            // Add correlation headers to response
+            response.headers.set(CORRELATION_HEADERS.REQUEST_ID, requestId);
+            response.headers.set(CORRELATION_HEADERS.TRACE_ID, traceId);
+            // Complete the wide event
+            const duration = performance.now() - startTime;
+            // Add final timing
+            event.set('performance', 'duration_ms', duration);
+            // End and emit the wide event
+            const completedEvent = event.end({
+                status: 'success',
+                level: 'info',
+            });
+            // Emit through the logger (applies tail sampling if configured)
+            logger.emitWideEvent(completedEvent);
+            return response;
+        });
+    };
+}
+/**
+ * Pre-configured wide event middleware for direct export
+ *
+ * @example
+ * ```typescript
+ * // middleware.ts
+ * export { wideEventMiddleware as middleware } from '@vestig/next/wide-events'
+ *
+ * export const config = {
+ *   matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+ * }
+ * ```
+ */
+export const wideEventMiddleware = createWideEventMiddleware();
+//# sourceMappingURL=middleware.js.map

package/dist/wide-events/middleware.js.map

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

package/dist/wide-events/server-action.d.ts

@@ -0,0 +1,91 @@
+import { type LogLevel, type SanitizePreset, type TailSamplingConfig, createWideEvent } from 'vestig';
+/**
+ * Options for wide event server actions
+ */
+export interface WideEventActionOptions {
+    /** Action name (used as event type) */
+    name?: string;
+    /** Log level */
+    level?: LogLevel;
+    /** Enable/disable wide event emission */
+    enabled?: boolean;
+    /** PII sanitization preset */
+    sanitize?: SanitizePreset;
+    /** Use structured JSON output */
+    structured?: boolean;
+    /** Tail sampling configuration */
+    tailSampling?: TailSamplingConfig;
+}
+/**
+ * Context provided to wide event actions
+ */
+export interface WideEventActionContext {
+    /** The wide event builder for this action */
+    event: ReturnType<typeof createWideEvent>;
+}
+/**
+ * Server action handler type with wide event context
+ */
+export type WideEventServerAction<TInput, TResult> = (input: TInput, ctx: WideEventActionContext) => Promise<TResult>;
+/**
+ * Wrap a server action with wide event tracking.
+ *
+ * If called within an existing wide event context (e.g., from middleware),
+ * it will enrich that event. Otherwise, it creates a new wide event.
+ *
+ * @example
+ * ```typescript
+ * // app/actions/user.ts
+ * 'use server'
+ *
+ * import { withWideEvent } from '@vestig/next/wide-events'
+ *
+ * export const createUser = withWideEvent(
+ *   async (data: CreateUserInput, { event }) => {
+ *     event.set('action', 'type', 'user.create')
+ *     event.set('user', 'email', data.email)
+ *
+ *     const user = await db.users.create({ data })
+ *
+ *     event.set('user', 'id', user.id)
+ *     return user
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ * ```
+ */
+export declare function withWideEvent<TInput, TResult>(handler: WideEventServerAction<TInput, TResult>, options?: WideEventActionOptions): (input: TInput) => Promise<TResult>;
+/**
+ * Create a factory for wide event server actions with shared options.
+ *
+ * @example
+ * ```typescript
+ * // app/actions/index.ts
+ * import { createWideEventAction } from '@vestig/next/wide-events'
+ *
+ * const action = createWideEventAction({
+ *   tailSampling: {
+ *     enabled: true,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ *
+ * export const createUser = action(
+ *   async (data, { event }) => {
+ *     event.set('user', 'email', data.email)
+ *     return await db.users.create({ data })
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ *
+ * export const updateUser = action(
+ *   async ({ id, data }, { event }) => {
+ *     event.set('user', 'id', id)
+ *     return await db.users.update({ where: { id }, data })
+ *   },
+ *   { name: 'action.user.update' }
+ * )
+ * ```
+ */
+export declare function createWideEventAction(defaultOptions?: WideEventActionOptions): <TInput, TResult>(handler: WideEventServerAction<TInput, TResult>, options?: WideEventActionOptions) => ((input: TInput) => Promise<TResult>);
+//# sourceMappingURL=server-action.d.ts.map

package/dist/wide-events/server-action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-action.d.ts","sourceRoot":"","sources":["../../src/wide-events/server-action.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,QAAQ,EAEb,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,eAAe,EACf,MAAM,QAAQ,CAAA;AAGf;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,kCAAkC;IAClC,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACjC;AAgCD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,6CAA6C;IAC7C,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,MAAM,EAAE,OAAO,IAAI,CACpD,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,sBAAsB,KACvB,OAAO,CAAC,OAAO,CAAC,CAAA;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAC5C,OAAO,EAAE,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,OAAO,GAAE,sBAA2B,GAClC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAmFrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,qBAAqB,CAAC,cAAc,GAAE,sBAA2B,IACxE,MAAM,EAAE,OAAO,EACtB,SAAS,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/C,UAAS,sBAA2B,KAClC,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAExC"}

package/dist/wide-events/server-action.js

@@ -0,0 +1,158 @@
+import { createLogger, createWideEvent, } from 'vestig';
+import { getWideEvent, runWithWideEventAsync } from './context';
+const DEFAULT_OPTIONS = {
+    level: 'info',
+    enabled: true,
+    sanitize: 'default',
+    structured: true,
+};
+// Cached logger
+let cachedLogger = null;
+function getOrCreateLogger(options) {
+    if (cachedLogger && options === DEFAULT_OPTIONS) {
+        return cachedLogger;
+    }
+    const logger = createLogger({
+        level: options.level,
+        enabled: options.enabled,
+        sanitize: options.sanitize,
+        structured: options.structured,
+        tailSampling: options.tailSampling,
+    });
+    if (options === DEFAULT_OPTIONS) {
+        cachedLogger = logger;
+    }
+    return logger;
+}
+/**
+ * Wrap a server action with wide event tracking.
+ *
+ * If called within an existing wide event context (e.g., from middleware),
+ * it will enrich that event. Otherwise, it creates a new wide event.
+ *
+ * @example
+ * ```typescript
+ * // app/actions/user.ts
+ * 'use server'
+ *
+ * import { withWideEvent } from '@vestig/next/wide-events'
+ *
+ * export const createUser = withWideEvent(
+ *   async (data: CreateUserInput, { event }) => {
+ *     event.set('action', 'type', 'user.create')
+ *     event.set('user', 'email', data.email)
+ *
+ *     const user = await db.users.create({ data })
+ *
+ *     event.set('user', 'id', user.id)
+ *     return user
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ * ```
+ */
+export function withWideEvent(handler, options = {}) {
+    const mergedOptions = { ...DEFAULT_OPTIONS, ...options };
+    return async (input) => {
+        const startTime = performance.now();
+        const logger = getOrCreateLogger(mergedOptions);
+        // Check if we're already in a wide event context
+        const existingEvent = getWideEvent();
+        if (existingEvent) {
+            // Enrich existing event with action context
+            const actionName = mergedOptions.name ?? 'server-action';
+            existingEvent.set('action', 'name', actionName);
+            existingEvent.set('action', 'start_ms', performance.now() - startTime);
+            try {
+                const result = await handler(input, { event: existingEvent });
+                existingEvent.set('action', 'duration_ms', performance.now() - startTime);
+                existingEvent.set('action', 'status', 'success');
+                return result;
+            }
+            catch (error) {
+                existingEvent.set('action', 'duration_ms', performance.now() - startTime);
+                existingEvent.set('action', 'status', 'error');
+                existingEvent.merge('error', {
+                    name: error instanceof Error ? error.name : 'Error',
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                throw error;
+            }
+        }
+        // Create new wide event for this action
+        const actionName = mergedOptions.name ?? 'server-action';
+        const event = createWideEvent({
+            type: actionName,
+        });
+        event.set('action', 'name', actionName);
+        const eventContext = {
+            event,
+            startTime,
+        };
+        return runWithWideEventAsync(eventContext, async () => {
+            try {
+                const result = await handler(input, { event });
+                // Complete and emit the wide event
+                const duration = performance.now() - startTime;
+                event.set('performance', 'duration_ms', duration);
+                const completedEvent = event.end({
+                    status: 'success',
+                    level: 'info',
+                });
+                logger.emitWideEvent(completedEvent);
+                return result;
+            }
+            catch (error) {
+                const duration = performance.now() - startTime;
+                event.set('performance', 'duration_ms', duration);
+                event.merge('error', {
+                    name: error instanceof Error ? error.name : 'Error',
+                    message: error instanceof Error ? error.message : String(error),
+                });
+                const completedEvent = event.end({
+                    status: 'error',
+                    error: error instanceof Error ? error : new Error(String(error)),
+                    level: 'error',
+                });
+                logger.emitWideEvent(completedEvent);
+                throw error;
+            }
+        });
+    };
+}
+/**
+ * Create a factory for wide event server actions with shared options.
+ *
+ * @example
+ * ```typescript
+ * // app/actions/index.ts
+ * import { createWideEventAction } from '@vestig/next/wide-events'
+ *
+ * const action = createWideEventAction({
+ *   tailSampling: {
+ *     enabled: true,
+ *     successSampleRate: 0.1,
+ *   },
+ * })
+ *
+ * export const createUser = action(
+ *   async (data, { event }) => {
+ *     event.set('user', 'email', data.email)
+ *     return await db.users.create({ data })
+ *   },
+ *   { name: 'action.user.create' }
+ * )
+ *
+ * export const updateUser = action(
+ *   async ({ id, data }, { event }) => {
+ *     event.set('user', 'id', id)
+ *     return await db.users.update({ where: { id }, data })
+ *   },
+ *   { name: 'action.user.update' }
+ * )
+ * ```
+ */
+export function createWideEventAction(defaultOptions = {}) {
+    return (handler, options = {}) => withWideEvent(handler, { ...defaultOptions, ...options });
+}
+//# sourceMappingURL=server-action.js.map

package/dist/wide-events/server-action.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vestig/next",
-	"version": "0.11.4",
+	"version": "0.13.0",
 	"description": "First-class Next.js 15+ integration for vestig logging library. Zero boilerplate, automatic request correlation, full type safety.",
 	"type": "module",
 	"main": "./dist/index.js",
@@ -45,6 +45,10 @@
 		"./db": {
 			"types": "./dist/db/index.d.ts",
 			"import": "./dist/db/index.js"
+		},
+		"./wide-events": {
+			"types": "./dist/wide-events/index.d.ts",
+			"import": "./dist/wide-events/index.js"
 		}
 	},
 	"files": ["dist"],
@@ -70,7 +74,10 @@
 		"typescript",
 		"request-correlation",
 		"tracing",
-		"observability"
+		"observability",
+		"wide-events",
+		"canonical-log-lines",
+		"tail-sampling"
 	],
 	"author": "Arakiss",
 	"license": "MIT",