@vorionsys/platform-core 0.1.0

package/dist/intent/response-middleware.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Response Middleware for Standardized API Envelopes
+ *
+ * Provides Fastify hooks and helpers for wrapping responses in the standard
+ * API envelope format, adding request context, and handling errors consistently.
+ *
+ * @packageDocumentation
+ */
+import type { FastifyInstance, FastifyRequest, FastifyReply, FastifyError } from 'fastify';
+import { type TraceContext } from '../common/trace.js';
+import { type HttpStatusCode } from './response.js';
+/** Header name for request ID tracking */
+export declare const REQUEST_ID_HEADER = "X-Request-ID";
+/**
+ * Extended request interface with trace context
+ */
+declare module 'fastify' {
+    interface FastifyRequest {
+        traceContext?: TraceContext;
+    }
+}
+/**
+ * Response context stored on request for middleware use
+ */
+export interface ResponseContext {
+    /** Unique request identifier */
+    requestId: string;
+    /** Trace ID from distributed tracing context */
+    traceId?: string | undefined;
+    /** Request start time for duration tracking */
+    startTime: number;
+}
+/**
+ * Augment FastifyRequest with response context
+ */
+declare module 'fastify' {
+    interface FastifyRequest {
+        responseContext?: ResponseContext;
+    }
+}
+/**
+ * Register response middleware hooks on a Fastify instance
+ *
+ * This middleware:
+ * 1. Adds request/trace context to each request
+ * 2. Provides a standardized error handler
+ * 3. Optionally wraps all responses in the standard envelope
+ *
+ * @param server - The Fastify instance
+ * @param options - Middleware configuration options
+ *
+ * @example
+ * ```typescript
+ * const server = Fastify();
+ * registerResponseMiddleware(server, { wrapAllResponses: false });
+ * ```
+ */
+export declare function registerResponseMiddleware(server: FastifyInstance, options?: {
+    /** Whether to automatically wrap all responses in the envelope (default: false) */
+    wrapAllResponses?: boolean;
+}): void;
+/**
+ * Create a standardized error handler for Fastify
+ *
+ * @param env - The environment (development, staging, production)
+ * @returns Fastify error handler function
+ */
+export declare function createStandardErrorHandler(env: string): (error: FastifyError, request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+/**
+ * Helper to send a standardized success response
+ *
+ * @param reply - Fastify reply object
+ * @param data - Response data
+ * @param status - HTTP status code (default: 200)
+ * @param request - Optional request for context
+ */
+export declare function sendSuccess<T>(reply: FastifyReply, data: T, status?: HttpStatusCode, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a standardized error response
+ *
+ * @param reply - Fastify reply object
+ * @param code - Error code
+ * @param message - Error message
+ * @param status - HTTP status code
+ * @param details - Optional error details
+ * @param request - Optional request for context
+ */
+export declare function sendError(reply: FastifyReply, code: string, message: string, status: HttpStatusCode, details?: Record<string, unknown>, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a paginated response
+ *
+ * @param reply - Fastify reply object
+ * @param items - Array of items
+ * @param pagination - Pagination information
+ * @param request - Optional request for context
+ */
+export declare function sendPaginated<T>(reply: FastifyReply, items: T[], pagination: {
+    page: number;
+    pageSize: number;
+    totalItems: number;
+}, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a cursor-paginated response
+ *
+ * @param reply - Fastify reply object
+ * @param items - Array of items
+ * @param cursor - Cursor pagination info
+ * @param request - Optional request for context
+ */
+export declare function sendCursorPaginated<T>(reply: FastifyReply, items: T[], cursor: {
+    nextCursor?: string | undefined;
+    prevCursor?: string | undefined;
+    hasMore: boolean;
+}, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a "not found" error response
+ *
+ * @param reply - Fastify reply object
+ * @param resourceType - Type of resource that was not found
+ * @param request - Optional request for context
+ */
+export declare function sendNotFound(reply: FastifyReply, resourceType: string, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a validation error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Validation error message
+ * @param errors - Validation error details
+ * @param request - Optional request for context
+ */
+export declare function sendValidationError(reply: FastifyReply, message: string, errors?: Record<string, unknown>, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a forbidden error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Forbidden error message
+ * @param request - Optional request for context
+ */
+export declare function sendForbidden(reply: FastifyReply, message?: string, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send an unauthorized error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Unauthorized error message
+ * @param request - Optional request for context
+ */
+export declare function sendUnauthorized(reply: FastifyReply, message?: string, request?: FastifyRequest): FastifyReply;
+/**
+ * Helper to send a conflict error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Conflict error message
+ * @param request - Optional request for context
+ */
+export declare function sendConflict(reply: FastifyReply, message: string, request?: FastifyRequest): FastifyReply;
+//# sourceMappingURL=response-middleware.d.ts.map

package/dist/intent/response-middleware.d.ts.map

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

package/dist/intent/response-middleware.js

@@ -0,0 +1,346 @@
+/**
+ * Response Middleware for Standardized API Envelopes
+ *
+ * Provides Fastify hooks and helpers for wrapping responses in the standard
+ * API envelope format, adding request context, and handling errors consistently.
+ *
+ * @packageDocumentation
+ */
+import { randomUUID } from 'node:crypto';
+import { getTraceContext } from '../common/trace.js';
+import { getConfig } from '../common/config.js';
+import { createLogger } from '../common/logger.js';
+import { isVorionError, RateLimitError, } from '../common/errors.js';
+import { errorResponseFromError, errorResponse, HttpStatus, } from './response.js';
+import { ZodError } from 'zod';
+const logger = createLogger({ component: 'response-middleware' });
+/** Header name for request ID tracking */
+export const REQUEST_ID_HEADER = 'X-Request-ID';
+/**
+ * Register response middleware hooks on a Fastify instance
+ *
+ * This middleware:
+ * 1. Adds request/trace context to each request
+ * 2. Provides a standardized error handler
+ * 3. Optionally wraps all responses in the standard envelope
+ *
+ * @param server - The Fastify instance
+ * @param options - Middleware configuration options
+ *
+ * @example
+ * ```typescript
+ * const server = Fastify();
+ * registerResponseMiddleware(server, { wrapAllResponses: false });
+ * ```
+ */
+export function registerResponseMiddleware(server, options) {
+    const config = getConfig();
+    // Decorate request with responseContext
+    server.decorateRequest('responseContext', null);
+    // Add response context to each request and set X-Request-ID header
+    server.addHook('onRequest', async (request, reply) => {
+        const traceContext = getTraceContext() ?? request.traceContext;
+        // Use incoming request ID or generate a new one
+        const requestId = request.headers[REQUEST_ID_HEADER.toLowerCase()] ?? randomUUID();
+        request.responseContext = {
+            requestId,
+            traceId: traceContext?.traceId,
+            startTime: Date.now(),
+        };
+        // Always set X-Request-ID header in response
+        reply.header(REQUEST_ID_HEADER, requestId);
+    });
+    // Optionally wrap all responses in standard envelope
+    if (options?.wrapAllResponses) {
+        server.addHook('onSend', async (request, _reply, payload) => {
+            // Skip if already an API response or if it's not JSON
+            if (typeof payload !== 'string') {
+                return payload;
+            }
+            try {
+                const parsed = JSON.parse(payload);
+                // Skip if already in envelope format
+                if ('success' in parsed && 'meta' in parsed) {
+                    return payload;
+                }
+                // Skip health/metrics endpoints
+                if (request.url === '/health' || request.url === '/ready' || request.url === '/metrics') {
+                    return payload;
+                }
+                // Wrap in envelope
+                const envelope = {
+                    success: true,
+                    data: parsed,
+                    meta: {
+                        requestId: request.responseContext?.requestId ?? randomUUID(),
+                        timestamp: new Date().toISOString(),
+                    },
+                };
+                return JSON.stringify(envelope);
+            }
+            catch {
+                // Not JSON, return as-is
+                return payload;
+            }
+        });
+    }
+    // Register the standardized error handler
+    server.setErrorHandler(createStandardErrorHandler(config.env));
+}
+/**
+ * Create a standardized error handler for Fastify
+ *
+ * @param env - The environment (development, staging, production)
+ * @returns Fastify error handler function
+ */
+export function createStandardErrorHandler(env) {
+    return async (error, request, reply) => {
+        const requestId = request.responseContext?.requestId ?? request.id;
+        const traceId = request.responseContext?.traceId ?? request.traceContext?.traceId;
+        // Handle Zod validation errors
+        // Use multiple checks to handle different Zod instances in dependency tree:
+        // 1. instanceof check for same Zod instance
+        // 2. Check for 'issues' array (canonical ZodError property)
+        // 3. Name check as fallback
+        const isZodError = error instanceof ZodError ||
+            (Array.isArray(error.issues) && typeof error.format === 'function') ||
+            (error.name === 'ZodError' && Array.isArray(error.errors));
+        if (isZodError) {
+            const zodError = error;
+            // Use issues (canonical) or errors (alias) - both work
+            const validationErrors = (zodError.issues || zodError.errors).map((e) => ({
+                path: e.path.join('.'),
+                message: e.message,
+                code: e.code,
+            }));
+            const response = errorResponse('VALIDATION_ERROR', 'Request validation failed', env !== 'production' ? { errors: validationErrors } : undefined, requestId);
+            if (traceId && response.error) {
+                response.error.traceId = traceId;
+            }
+            logger.warn({
+                requestId,
+                traceId,
+                validationErrors,
+                url: request.url,
+                method: request.method,
+            }, 'Validation error');
+            return reply.status(HttpStatus.BAD_REQUEST).send(response);
+        }
+        // Handle VorionError instances
+        if (isVorionError(error)) {
+            const { response, status } = errorResponseFromError(error, requestId);
+            if (traceId && response.error) {
+                response.error.traceId = traceId;
+            }
+            const logLevel = status >= 500 ? 'error' : 'warn';
+            logger[logLevel]({
+                requestId,
+                traceId,
+                errorCode: error.code,
+                errorName: error.name,
+                statusCode: status,
+                details: error.details,
+                url: request.url,
+                method: request.method,
+            }, error.message);
+            // Add Retry-After header for rate limit errors
+            if (error instanceof RateLimitError && error.retryAfter !== undefined) {
+                reply.header('Retry-After', error.retryAfter.toString());
+            }
+            return reply.status(status).send(response);
+        }
+        // Handle generic Fastify/HTTP errors
+        let status = error.statusCode ?? HttpStatus.INTERNAL_SERVER_ERROR;
+        let code = error.code ?? 'INTERNAL_ERROR';
+        let message = error.message;
+        // Map specific error codes
+        if (code === 'FST_JWT_NO_AUTHORIZATION_IN_HEADER') {
+            status = HttpStatus.UNAUTHORIZED;
+            code = 'UNAUTHORIZED';
+            message = 'Authorization header is missing';
+        }
+        else if (code === 'FST_JWT_AUTHORIZATION_TOKEN_INVALID') {
+            status = HttpStatus.UNAUTHORIZED;
+            code = 'TOKEN_INVALID';
+            message = 'Invalid authorization token';
+        }
+        else if (code === 'FST_JWT_AUTHORIZATION_TOKEN_EXPIRED') {
+            status = HttpStatus.UNAUTHORIZED;
+            code = 'TOKEN_EXPIRED';
+            message = 'Authorization token has expired';
+        }
+        else if (error.statusCode === 429) {
+            status = HttpStatus.TOO_MANY_REQUESTS;
+            code = 'RATE_LIMIT_EXCEEDED';
+            message = 'Too many requests, please try again later';
+        }
+        // Sanitize message for production
+        if (env === 'production' && status >= 500) {
+            message = 'An unexpected error occurred';
+        }
+        const response = errorResponse(code, message, undefined, requestId);
+        if (traceId && response.error) {
+            response.error.traceId = traceId;
+        }
+        const logLevel = status >= 500 ? 'error' : 'warn';
+        logger[logLevel]({
+            requestId,
+            traceId,
+            errorCode: code,
+            statusCode: status,
+            stack: env !== 'production' ? error.stack : undefined,
+            url: request.url,
+            method: request.method,
+        }, message);
+        return reply.status(status).send(response);
+    };
+}
+/**
+ * Helper to send a standardized success response
+ *
+ * @param reply - Fastify reply object
+ * @param data - Response data
+ * @param status - HTTP status code (default: 200)
+ * @param request - Optional request for context
+ */
+export function sendSuccess(reply, data, status = HttpStatus.OK, request) {
+    const requestId = request?.responseContext?.requestId ?? randomUUID();
+    const traceId = request?.responseContext?.traceId ?? request?.traceContext?.traceId;
+    const meta = {
+        requestId,
+        timestamp: new Date().toISOString(),
+    };
+    // Add trace ID to meta if available (for debugging correlation)
+    if (traceId) {
+        meta.traceId = traceId;
+    }
+    const response = {
+        success: true,
+        data,
+        meta,
+    };
+    return reply.status(status).send(response);
+}
+/**
+ * Helper to send a standardized error response
+ *
+ * @param reply - Fastify reply object
+ * @param code - Error code
+ * @param message - Error message
+ * @param status - HTTP status code
+ * @param details - Optional error details
+ * @param request - Optional request for context
+ */
+export function sendError(reply, code, message, status, details, request) {
+    const config = getConfig();
+    const requestId = request?.responseContext?.requestId ?? randomUUID();
+    const traceId = request?.responseContext?.traceId ?? request?.traceContext?.traceId;
+    const response = errorResponse(code, config.env === 'production' && status >= 500 ? 'An unexpected error occurred' : message, config.env !== 'production' ? details : undefined, requestId);
+    if (traceId && response.error) {
+        response.error.traceId = traceId;
+    }
+    return reply.status(status).send(response);
+}
+/**
+ * Helper to send a paginated response
+ *
+ * @param reply - Fastify reply object
+ * @param items - Array of items
+ * @param pagination - Pagination information
+ * @param request - Optional request for context
+ */
+export function sendPaginated(reply, items, pagination, request) {
+    const requestId = request?.responseContext?.requestId ?? randomUUID();
+    const totalPages = Math.ceil(pagination.totalItems / pagination.pageSize);
+    const response = {
+        success: true,
+        data: items,
+        meta: {
+            requestId,
+            timestamp: new Date().toISOString(),
+            pagination: {
+                page: pagination.page,
+                pageSize: pagination.pageSize,
+                totalItems: pagination.totalItems,
+                totalPages,
+            },
+        },
+    };
+    return reply.status(HttpStatus.OK).send(response);
+}
+/**
+ * Helper to send a cursor-paginated response
+ *
+ * @param reply - Fastify reply object
+ * @param items - Array of items
+ * @param cursor - Cursor pagination info
+ * @param request - Optional request for context
+ */
+export function sendCursorPaginated(reply, items, cursor, request) {
+    const requestId = request?.responseContext?.requestId ?? randomUUID();
+    const response = {
+        success: true,
+        data: items,
+        meta: {
+            requestId,
+            timestamp: new Date().toISOString(),
+            cursor: {
+                ...cursor,
+                count: items.length,
+            },
+        },
+    };
+    return reply.status(HttpStatus.OK).send(response);
+}
+/**
+ * Helper to send a "not found" error response
+ *
+ * @param reply - Fastify reply object
+ * @param resourceType - Type of resource that was not found
+ * @param request - Optional request for context
+ */
+export function sendNotFound(reply, resourceType, request) {
+    return sendError(reply, `${resourceType.toUpperCase().replace(/\s+/g, '_')}_NOT_FOUND`, `${resourceType} not found`, HttpStatus.NOT_FOUND, undefined, request);
+}
+/**
+ * Helper to send a validation error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Validation error message
+ * @param errors - Validation error details
+ * @param request - Optional request for context
+ */
+export function sendValidationError(reply, message, errors, request) {
+    return sendError(reply, 'VALIDATION_ERROR', message, HttpStatus.BAD_REQUEST, errors, request);
+}
+/**
+ * Helper to send a forbidden error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Forbidden error message
+ * @param request - Optional request for context
+ */
+export function sendForbidden(reply, message = 'You do not have permission to perform this action', request) {
+    return sendError(reply, 'FORBIDDEN', message, HttpStatus.FORBIDDEN, undefined, request);
+}
+/**
+ * Helper to send an unauthorized error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Unauthorized error message
+ * @param request - Optional request for context
+ */
+export function sendUnauthorized(reply, message = 'Authentication required', request) {
+    return sendError(reply, 'UNAUTHORIZED', message, HttpStatus.UNAUTHORIZED, undefined, request);
+}
+/**
+ * Helper to send a conflict error response
+ *
+ * @param reply - Fastify reply object
+ * @param message - Conflict error message
+ * @param request - Optional request for context
+ */
+export function sendConflict(reply, message, request) {
+    return sendError(reply, 'CONFLICT', message, HttpStatus.CONFLICT, undefined, request);
+}
+//# sourceMappingURL=response-middleware.js.map

package/dist/intent/response-middleware.js.map

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