raffel 0.1.2

package/dist/dx/logging/http-logging.int.test.js

@@ -0,0 +1,319 @@
+/**
+ * HTTP Request Logging Tests
+ */
+import { describe, it, expect, vi } from 'vitest';
+import { EventEmitter } from 'node:events';
+import { createHttpLoggingMiddleware, createDevLoggingMiddleware, createTinyLoggingMiddleware, createProductionHttpLoggingMiddleware, LOG_FORMATS, } from './index.js';
+// Create mock request/response
+function createMockRequest(overrides = {}) {
+    const req = new EventEmitter();
+    req.method = 'GET';
+    req.url = '/test';
+    req.httpVersionMajor = 1;
+    req.httpVersionMinor = 1;
+    req.headers = {
+        'user-agent': 'TestAgent/1.0',
+        host: 'localhost:3000',
+    };
+    req.socket = { remoteAddress: '127.0.0.1' };
+    Object.assign(req, overrides);
+    return req;
+}
+function createMockResponse() {
+    const res = new EventEmitter();
+    res.statusCode = 200;
+    res.getHeader = vi.fn().mockReturnValue(undefined);
+    Object.assign(res, {
+        getHeader: (name) => {
+            if (name === 'content-length')
+                return '532';
+            return undefined;
+        },
+    });
+    return res;
+}
+describe('HTTP Request Logging', () => {
+    describe('createHttpLoggingMiddleware', () => {
+        it('should log requests on response finish', async () => {
+            const logs = [];
+            const logger = { info: (msg) => logs.push(msg) };
+            const middleware = createHttpLoggingMiddleware({
+                format: 'tiny',
+                logger,
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            // Simulate response finish
+            res.emit('finish');
+            // Wait for async handlers
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+            expect(logs[0]).toContain('GET');
+            expect(logs[0]).toContain('/test');
+            expect(logs[0]).toContain('200');
+        });
+        it('should skip logging when skip function returns true', async () => {
+            const logs = [];
+            const logger = { info: (msg) => logs.push(msg) };
+            const middleware = createHttpLoggingMiddleware({
+                format: 'tiny',
+                logger,
+                skip: (req) => req.url?.startsWith('/health') ?? false,
+            });
+            const req = createMockRequest({ url: '/health' });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(0);
+        });
+        it('should not skip logging for non-matching requests', async () => {
+            const logs = [];
+            const logger = { info: (msg) => logs.push(msg) };
+            const middleware = createHttpLoggingMiddleware({
+                format: 'tiny',
+                logger,
+                skip: (req) => req.url?.startsWith('/health') ?? false,
+            });
+            const req = createMockRequest({ url: '/users' });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+        });
+        it('should log immediately when immediate is true', () => {
+            const logs = [];
+            const logger = { info: (msg) => logs.push(msg) };
+            const middleware = createHttpLoggingMiddleware({
+                format: 'tiny',
+                logger,
+                immediate: true,
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            // Should have logged immediately, before response finish
+            expect(logs.length).toBe(1);
+        });
+        it('should use error logger for 5xx status codes', async () => {
+            const logs = [];
+            const errors = [];
+            const logger = {
+                info: (msg) => logs.push(msg),
+                error: (msg) => errors.push(msg),
+            };
+            const middleware = createHttpLoggingMiddleware({
+                format: 'tiny',
+                logger,
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            res.statusCode = 500;
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(0);
+            expect(errors.length).toBe(1);
+        });
+        it('should include response time in logs', async () => {
+            const logs = [];
+            const logger = { info: (msg) => logs.push(msg) };
+            const middleware = createHttpLoggingMiddleware({
+                format: ':response-time ms',
+                logger,
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            // Add small delay to ensure measurable response time
+            await new Promise((r) => setTimeout(r, 10));
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+            expect(logs[0]).toMatch(/\d+\.\d+ ms/);
+        });
+    });
+    describe('Format tokens', () => {
+        it('should handle :method token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':method',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest({ method: 'POST' });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('POST');
+        });
+        it('should handle :url token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':url',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest({ url: '/api/users?page=1' });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('/api/users?page=1');
+        });
+        it('should handle :status token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':status',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            res.statusCode = 201;
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('201');
+        });
+        it('should handle :remote-addr token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':remote-addr',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('127.0.0.1');
+        });
+        it('should handle :remote-addr with x-forwarded-for', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':remote-addr',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest({
+                headers: { 'x-forwarded-for': '192.168.1.1, 10.0.0.1' },
+            });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('192.168.1.1');
+        });
+        it('should handle :user-agent token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':user-agent',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest({
+                headers: { 'user-agent': 'Mozilla/5.0' },
+            });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('Mozilla/5.0');
+        });
+        it('should handle :http-version token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':http-version',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('1.1');
+        });
+        it('should handle :req[header] token', async () => {
+            const logs = [];
+            const middleware = createHttpLoggingMiddleware({
+                format: ':req[host]',
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest({
+                headers: { host: 'api.example.com' },
+            });
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs[0]).toBe('api.example.com');
+        });
+    });
+    describe('Predefined formats', () => {
+        it('should have all expected predefined formats', () => {
+            expect(LOG_FORMATS.combined).toBeDefined();
+            expect(LOG_FORMATS.common).toBeDefined();
+            expect(LOG_FORMATS.dev).toBeDefined();
+            expect(LOG_FORMATS.tiny).toBeDefined();
+            expect(LOG_FORMATS.short).toBeDefined();
+        });
+    });
+    describe('createDevLoggingMiddleware', () => {
+        it('should use dev format', async () => {
+            const logs = [];
+            const middleware = createDevLoggingMiddleware({
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+            // Dev format: GET /test 200 X.XXX ms - 532
+            expect(logs[0]).toContain('GET');
+            expect(logs[0]).toContain('/test');
+            expect(logs[0]).toContain('ms');
+        });
+    });
+    describe('createTinyLoggingMiddleware', () => {
+        it('should use tiny format', async () => {
+            const logs = [];
+            const middleware = createTinyLoggingMiddleware({
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const req = createMockRequest();
+            const res = createMockResponse();
+            middleware(req, res, () => { });
+            res.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+            // Tiny format: GET /test 200 X.XXX ms
+            expect(logs[0]).toContain('GET');
+            expect(logs[0]).toContain('/test');
+            expect(logs[0]).toContain('200');
+            expect(logs[0]).toContain('ms');
+        });
+    });
+    describe('createProductionHttpLoggingMiddleware', () => {
+        it('should skip health endpoints by default', async () => {
+            const logs = [];
+            const middleware = createProductionHttpLoggingMiddleware({
+                logger: { info: (msg) => logs.push(msg) },
+            });
+            const healthReq = createMockRequest({ url: '/health' });
+            const healthRes = createMockResponse();
+            middleware(healthReq, healthRes, () => { });
+            healthRes.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(0);
+            // Non-health endpoint should be logged
+            const userReq = createMockRequest({ url: '/users' });
+            const userRes = createMockResponse();
+            middleware(userReq, userRes, () => { });
+            userRes.emit('finish');
+            await new Promise((r) => setTimeout(r, 10));
+            expect(logs.length).toBe(1);
+        });
+    });
+});
+//# sourceMappingURL=http-logging.int.test.js.map

package/dist/dx/logging/http-logging.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-logging.int.test.js","sourceRoot":"","sources":["../../../src/dx/logging/http-logging.int.test.ts"],"names":[],"mappings":"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"}

package/dist/dx/logging/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * HTTP Request Logging
+ *
+ * HTTP-level request/response logging middleware with industry-standard formats.
+ * Supports Apache combined, common, dev, tiny, and custom format strings.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { HttpLoggingConfig } from './types.js';
+export * from './types.js';
+export { LOG_FORMATS } from './formats.js';
+/**
+ * HTTP logging middleware type.
+ */
+export type HttpLoggingMiddleware = (req: IncomingMessage, res: ServerResponse, next: () => void) => void;
+/**
+ * Create HTTP request logging middleware.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with combined format
+ * const logging = createHttpLoggingMiddleware()
+ *
+ * // Development format with colors
+ * const logging = createHttpLoggingMiddleware({ format: 'dev' })
+ *
+ * // Skip health check requests
+ * const logging = createHttpLoggingMiddleware({
+ *   format: 'combined',
+ *   skip: (req) => req.url?.startsWith('/health') ?? false,
+ * })
+ *
+ * // Custom format
+ * const logging = createHttpLoggingMiddleware({
+ *   format: ':method :url :status - :response-time ms',
+ * })
+ *
+ * // Use with Node.js HTTP server
+ * const server = http.createServer((req, res) => {
+ *   logging(req, res, () => {
+ *     // Handle request
+ *   })
+ * })
+ * ```
+ */
+export declare function createHttpLoggingMiddleware(config?: HttpLoggingConfig): HttpLoggingMiddleware;
+/**
+ * Create a development logging middleware.
+ * Colored output with method, url, status, and response time.
+ *
+ * @example
+ * ```typescript
+ * const logging = createDevLoggingMiddleware()
+ * // Output: GET /users 200 15.234 ms - 532
+ * ```
+ */
+export declare function createDevLoggingMiddleware(options?: Pick<HttpLoggingConfig, 'skip' | 'logger'>): HttpLoggingMiddleware;
+/**
+ * Create a minimal logging middleware.
+ * Only logs method, url, status, and response time.
+ *
+ * @example
+ * ```typescript
+ * const logging = createTinyLoggingMiddleware()
+ * // Output: GET /users 200 15.234 ms
+ * ```
+ */
+export declare function createTinyLoggingMiddleware(options?: Pick<HttpLoggingConfig, 'skip' | 'logger'>): HttpLoggingMiddleware;
+/**
+ * Create a production-friendly logging middleware.
+ * Uses combined format and skips health check endpoints.
+ *
+ * @example
+ * ```typescript
+ * const logging = createProductionHttpLoggingMiddleware()
+ * ```
+ */
+export declare function createProductionHttpLoggingMiddleware(options?: Omit<HttpLoggingConfig, 'format'>): HttpLoggingMiddleware;
+/**
+ * Integrate HTTP logging middleware with Raffel HTTP adapter.
+ *
+ * Returns a function that wraps the adapter's request handler.
+ */
+export declare function withHttpLogging(config?: HttpLoggingConfig): <T extends (req: IncomingMessage, res: ServerResponse) => void>(handler: T) => T;
+//# sourceMappingURL=index.d.ts.map

package/dist/dx/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dx/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,YAAY,CAAA;AAG/D,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAmB1C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,IAAI,KACb,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,iBAAsB,GAAG,qBAAqB,CAwDjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAC1C,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,iBAAsB,IAGpD,CAAC,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,EAAE,SAAS,CAAC,KAAG,CAAC,CAOtF"}

package/dist/dx/logging/index.js

@@ -0,0 +1,164 @@
+/**
+ * HTTP Request Logging
+ *
+ * HTTP-level request/response logging middleware with industry-standard formats.
+ * Supports Apache combined, common, dev, tiny, and custom format strings.
+ */
+import { compileFormat, getFormatString } from './formats.js';
+export * from './types.js';
+export { LOG_FORMATS } from './formats.js';
+/**
+ * Default configuration.
+ */
+const DEFAULTS = {
+    format: 'combined',
+    immediate: false,
+    redactHeaders: ['authorization', 'cookie', 'set-cookie', 'x-api-key', 'x-auth-token'],
+};
+/**
+ * Default logger using console.
+ */
+const defaultLogger = {
+    info: (message) => console.log(message),
+    error: (message) => console.error(message),
+};
+/**
+ * Create HTTP request logging middleware.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with combined format
+ * const logging = createHttpLoggingMiddleware()
+ *
+ * // Development format with colors
+ * const logging = createHttpLoggingMiddleware({ format: 'dev' })
+ *
+ * // Skip health check requests
+ * const logging = createHttpLoggingMiddleware({
+ *   format: 'combined',
+ *   skip: (req) => req.url?.startsWith('/health') ?? false,
+ * })
+ *
+ * // Custom format
+ * const logging = createHttpLoggingMiddleware({
+ *   format: ':method :url :status - :response-time ms',
+ * })
+ *
+ * // Use with Node.js HTTP server
+ * const server = http.createServer((req, res) => {
+ *   logging(req, res, () => {
+ *     // Handle request
+ *   })
+ * })
+ * ```
+ */
+export function createHttpLoggingMiddleware(config = {}) {
+    const { format = DEFAULTS.format, skip, logger = defaultLogger, immediate = DEFAULTS.immediate, } = config;
+    // Determine if we should colorize (dev format or TTY)
+    const formatString = getFormatString(format);
+    const colorize = format === 'dev' || (process.stdout.isTTY && format === 'dev');
+    // Compile the format function
+    const formatFn = compileFormat(formatString, colorize);
+    return (req, res, next) => {
+        // Create logging context
+        const ctx = {
+            startTime: process.hrtime.bigint(),
+            startDate: new Date(),
+        };
+        // Check if we should skip this request
+        if (skip && skip(req, res)) {
+            next();
+            return;
+        }
+        // Log immediately if configured
+        if (immediate) {
+            const line = formatFn(req, res, ctx);
+            logger.info(line);
+            next();
+            return;
+        }
+        // Hook into response finish to log
+        const onFinished = () => {
+            res.removeListener('finish', onFinished);
+            res.removeListener('close', onFinished);
+            const line = formatFn(req, res, ctx);
+            // Use error log for 5xx status codes
+            if (res.statusCode >= 500 && logger.error) {
+                logger.error(line);
+            }
+            else {
+                logger.info(line);
+            }
+        };
+        res.on('finish', onFinished);
+        res.on('close', onFinished);
+        next();
+    };
+}
+/**
+ * Create a development logging middleware.
+ * Colored output with method, url, status, and response time.
+ *
+ * @example
+ * ```typescript
+ * const logging = createDevLoggingMiddleware()
+ * // Output: GET /users 200 15.234 ms - 532
+ * ```
+ */
+export function createDevLoggingMiddleware(options) {
+    return createHttpLoggingMiddleware({
+        ...options,
+        format: 'dev',
+    });
+}
+/**
+ * Create a minimal logging middleware.
+ * Only logs method, url, status, and response time.
+ *
+ * @example
+ * ```typescript
+ * const logging = createTinyLoggingMiddleware()
+ * // Output: GET /users 200 15.234 ms
+ * ```
+ */
+export function createTinyLoggingMiddleware(options) {
+    return createHttpLoggingMiddleware({
+        ...options,
+        format: 'tiny',
+    });
+}
+/**
+ * Create a production-friendly logging middleware.
+ * Uses combined format and skips health check endpoints.
+ *
+ * @example
+ * ```typescript
+ * const logging = createProductionHttpLoggingMiddleware()
+ * ```
+ */
+export function createProductionHttpLoggingMiddleware(options) {
+    return createHttpLoggingMiddleware({
+        ...options,
+        format: 'combined',
+        skip: options?.skip ?? ((req) => {
+            const url = req.url || '';
+            return url.startsWith('/health') || url.startsWith('/ready') || url.startsWith('/live');
+        }),
+    });
+}
+/**
+ * Integrate HTTP logging middleware with Raffel HTTP adapter.
+ *
+ * Returns a function that wraps the adapter's request handler.
+ */
+export function withHttpLogging(config = {}) {
+    const middleware = createHttpLoggingMiddleware(config);
+    return (handler) => {
+        return ((req, res) => {
+            middleware(req, res, () => {
+                handler(req, res);
+            });
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/dx/logging/index.js.map

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