raffel 0.1.2

package/dist/middleware/interceptors/fallback.js

@@ -0,0 +1,161 @@
+/**
+ * Fallback Interceptor
+ *
+ * Protocol-agnostic graceful degradation pattern.
+ * Returns a default response when the handler fails, preventing error propagation.
+ *
+ * Features:
+ * - Static fallback response
+ * - Dynamic fallback handler with access to error and context
+ * - Conditional fallback based on error type
+ * - Async fallback support
+ */
+/**
+ * Create a fallback interceptor for graceful degradation
+ *
+ * When the handler throws an error, the fallback interceptor catches it
+ * and returns a default response instead of propagating the error.
+ *
+ * @example
+ * ```typescript
+ * // Static fallback response
+ * const fallback = createFallbackInterceptor({
+ *   response: { id: 0, name: 'Guest', status: 'unavailable' }
+ * })
+ *
+ * // Dynamic fallback with error info
+ * const fallback = createFallbackInterceptor({
+ *   handler: (ctx, error) => ({
+ *     id: 0,
+ *     name: 'Guest',
+ *     errorReason: error.message
+ *   })
+ * })
+ *
+ * // Conditional fallback - only for specific errors
+ * const fallback = createFallbackInterceptor({
+ *   response: defaultUser,
+ *   when: (error) => error.code === 'SERVICE_UNAVAILABLE'
+ * })
+ *
+ * // Async fallback - fetch from cache
+ * const fallback = createFallbackInterceptor({
+ *   handler: async (ctx, error) => {
+ *     return await cache.get(`user:${ctx.input?.id}`) ?? defaultUser
+ *   }
+ * })
+ *
+ * server
+ *   .procedure('users.get')
+ *   .use(fallback)
+ *   .handler(...)
+ * ```
+ */
+export function createFallbackInterceptor(config) {
+    const { response, handler, when } = config;
+    // Validate config - must have response or handler
+    if (response === undefined && handler === undefined) {
+        throw new Error('Fallback interceptor requires either "response" or "handler" option');
+    }
+    return async (envelope, ctx, next) => {
+        try {
+            return await next();
+        }
+        catch (error) {
+            const err = error;
+            // Check if fallback should apply
+            if (when && !when(err)) {
+                // Condition not met, re-throw error
+                throw error;
+            }
+            // Use handler if provided, otherwise return static response
+            if (handler) {
+                return await handler(ctx, err);
+            }
+            return response;
+        }
+    };
+}
+/**
+ * Create a fallback interceptor with procedure-specific configurations
+ *
+ * @example
+ * ```typescript
+ * const fallback = createProcedureFallback({
+ *   default: { response: { status: 'unavailable' } },
+ *   procedures: {
+ *     'users.get': { response: { id: 0, name: 'Guest' } },
+ *     'config.get': { handler: async (ctx, err) => getDefaultConfig() },
+ *   }
+ * })
+ * ```
+ */
+export function createProcedureFallback(config) {
+    const { default: defaultConfig, procedures } = config;
+    // Create fallback interceptors for each configured procedure
+    const fallbacks = new Map();
+    // Default fallback if provided
+    const defaultFallback = defaultConfig
+        ? createFallbackInterceptor(defaultConfig)
+        : null;
+    return async (envelope, ctx, next) => {
+        const procedure = envelope.procedure;
+        // Check for exact match
+        if (procedures[procedure]) {
+            let fallback = fallbacks.get(procedure);
+            if (!fallback) {
+                fallback = createFallbackInterceptor(procedures[procedure]);
+                fallbacks.set(procedure, fallback);
+            }
+            return fallback(envelope, ctx, next);
+        }
+        // Check for pattern match
+        for (const [pattern, procedureConfig] of Object.entries(procedures)) {
+            const regex = pattern
+                .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+                .replace(/\*\*/g, '{{DOUBLE_STAR}}')
+                .replace(/\*/g, '[^.]*')
+                .replace(/{{DOUBLE_STAR}}/g, '.*');
+            if (new RegExp(`^${regex}$`).test(procedure)) {
+                let fallback = fallbacks.get(pattern);
+                if (!fallback) {
+                    fallback = createFallbackInterceptor(procedureConfig);
+                    fallbacks.set(pattern, fallback);
+                }
+                return fallback(envelope, ctx, next);
+            }
+        }
+        // Use default fallback if available
+        if (defaultFallback) {
+            return defaultFallback(envelope, ctx, next);
+        }
+        // No fallback configured for this procedure
+        return next();
+    };
+}
+/**
+ * Create a conditional fallback that combines circuit breaker awareness
+ *
+ * Useful when you want fallback behavior only when services are degraded.
+ *
+ * @example
+ * ```typescript
+ * const fallback = createCircuitAwareFallback({
+ *   response: cachedData,
+ *   // Only fallback for infrastructure errors
+ *   errorCodes: ['UNAVAILABLE', 'DEADLINE_EXCEEDED', 'INTERNAL_ERROR']
+ * })
+ * ```
+ */
+export function createCircuitAwareFallback(config) {
+    const { response, handler, errorCodes = ['UNAVAILABLE', 'DEADLINE_EXCEEDED', 'INTERNAL_ERROR'], } = config;
+    return createFallbackInterceptor({
+        response,
+        handler,
+        when: (error) => {
+            const code = error.code;
+            return code && errorCodes.includes(code);
+        },
+    });
+}
+//# sourceMappingURL=fallback.js.map

package/dist/middleware/interceptors/fallback.js.map

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

package/dist/middleware/interceptors/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Protocol-Agnostic Interceptors
+ *
+ * These interceptors work across all Raffel transports (HTTP, WebSocket, TCP, JSON-RPC).
+ */
+export { createRateLimitInterceptor, createAuthRateLimiter, createTokenBucketLimiter, parseRateLimitHeaders, isRateLimitExceeded, calculateRateLimitDelay, } from './rate-limit.js';
+export type { ParsedRateLimitInfo, TokenBucketConfig } from './rate-limit.js';
+export { createRequestIdInterceptor, createPrefixedRequestIdInterceptor, createCorrelatedRequestIdInterceptor, } from './request-id.js';
+export { createLoggingInterceptor, createProductionLoggingInterceptor, createDebugLoggingInterceptor, redactSensitiveHeaders, } from './logging.js';
+export { createTimeoutInterceptor, createCascadingTimeoutInterceptor, createDeadlinePropagationInterceptor, setTimeoutPhase, getTimeoutPhase, getPhaseInfo, } from './timeout.js';
+export type { TimeoutPhase } from './timeout.js';
+export { createRetryInterceptor, createSelectiveRetryInterceptor, parseRetryAfter, } from './retry.js';
+export { createCircuitBreakerInterceptor, createProcedureCircuitBreaker, createCircuitBreakerManager, } from './circuit-breaker.js';
+export type { CircuitBreakerManager } from './circuit-breaker.js';
+export { createDedupInterceptor, createReadOnlyDedupInterceptor, } from './dedup.js';
+export type { DedupConfig } from './dedup.js';
+export { createSizeLimitInterceptor, createRequestSizeLimitInterceptor, createResponseSizeLimitInterceptor, SizeLimitPresets, } from './size-limit.js';
+export type { SizeLimitConfig } from './size-limit.js';
+export { createCacheInterceptor, createReadThroughCacheInterceptor, createMemoryCacheStore, createCacheInvalidator, CachePresets, } from './cache.js';
+export type { CacheEventContext, ExtendedCacheConfig } from './cache.js';
+export { createBulkheadInterceptor, createProcedureBulkhead, createBulkheadManager, } from './bulkhead.js';
+export type { BulkheadManager } from './bulkhead.js';
+export { createFallbackInterceptor, } from './fallback.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/interceptors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAG7E,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,wBAAwB,EACxB,kCAAkC,EAClC,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,wBAAwB,EACxB,iCAAiC,EACjC,oCAAoC,EACpC,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAGhD,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,eAAe,GAChB,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AAGjE,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AACxB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGtD,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGxE,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAGpD,OAAO,EACL,yBAAyB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/middleware/interceptors/index.js

@@ -0,0 +1,28 @@
+/**
+ * Protocol-Agnostic Interceptors
+ *
+ * These interceptors work across all Raffel transports (HTTP, WebSocket, TCP, JSON-RPC).
+ */
+// Rate Limiting
+export { createRateLimitInterceptor, createAuthRateLimiter, createTokenBucketLimiter, parseRateLimitHeaders, isRateLimitExceeded, calculateRateLimitDelay, } from './rate-limit.js';
+// Request ID
+export { createRequestIdInterceptor, createPrefixedRequestIdInterceptor, createCorrelatedRequestIdInterceptor, } from './request-id.js';
+// Logging
+export { createLoggingInterceptor, createProductionLoggingInterceptor, createDebugLoggingInterceptor, redactSensitiveHeaders, } from './logging.js';
+// Timeout
+export { createTimeoutInterceptor, createCascadingTimeoutInterceptor, createDeadlinePropagationInterceptor, setTimeoutPhase, getTimeoutPhase, getPhaseInfo, } from './timeout.js';
+// Retry
+export { createRetryInterceptor, createSelectiveRetryInterceptor, parseRetryAfter, } from './retry.js';
+// Circuit Breaker
+export { createCircuitBreakerInterceptor, createProcedureCircuitBreaker, createCircuitBreakerManager, } from './circuit-breaker.js';
+// Deduplication
+export { createDedupInterceptor, createReadOnlyDedupInterceptor, } from './dedup.js';
+// Size Limiting
+export { createSizeLimitInterceptor, createRequestSizeLimitInterceptor, createResponseSizeLimitInterceptor, SizeLimitPresets, } from './size-limit.js';
+// Cache
+export { createCacheInterceptor, createReadThroughCacheInterceptor, createMemoryCacheStore, createCacheInvalidator, CachePresets, } from './cache.js';
+// Bulkhead (Concurrency Limiter)
+export { createBulkheadInterceptor, createProcedureBulkhead, createBulkheadManager, } from './bulkhead.js';
+// Fallback Handler
+export { createFallbackInterceptor, } from './fallback.js';
+//# sourceMappingURL=index.js.map

package/dist/middleware/interceptors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/middleware/interceptors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,iBAAiB,CAAA;AAGxB,aAAa;AACb,OAAO,EACL,0BAA0B,EAC1B,kCAAkC,EAClC,oCAAoC,GACrC,MAAM,iBAAiB,CAAA;AAExB,UAAU;AACV,OAAO,EACL,wBAAwB,EACxB,kCAAkC,EAClC,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,UAAU;AACV,OAAO,EACL,wBAAwB,EACxB,iCAAiC,EACjC,oCAAoC,EACpC,eAAe,EACf,eAAe,EACf,YAAY,GACb,MAAM,cAAc,CAAA;AAGrB,QAAQ;AACR,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAC/B,eAAe,GAChB,MAAM,YAAY,CAAA;AAEnB,kBAAkB;AAClB,OAAO,EACL,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,sBAAsB,CAAA;AAG7B,gBAAgB;AAChB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAC/B,MAAM,YAAY,CAAA;AAGnB,gBAAgB;AAChB,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EACjC,kCAAkC,EAClC,gBAAgB,GACjB,MAAM,iBAAiB,CAAA;AAGxB,QAAQ;AACR,OAAO,EACL,sBAAsB,EACtB,iCAAiC,EACjC,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,GACb,MAAM,YAAY,CAAA;AAGnB,iCAAiC;AACjC,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,eAAe,CAAA;AAGtB,mBAAmB;AACnB,OAAO,EACL,yBAAyB,GAC1B,MAAM,eAAe,CAAA"}

package/dist/middleware/interceptors/logging.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Logging Interceptor
+ *
+ * Protocol-agnostic request/response logging with support for
+ * structured logging, filtering, and performance metrics.
+ *
+ * Features:
+ * - Sensitive header redaction (Authorization, Cookie, etc.)
+ * - High-precision timing with hrtime
+ * - Memory-efficient timing with WeakMap
+ * - Glob pattern filtering
+ */
+import type { Interceptor } from '../../types/index.js';
+import type { LoggingConfig } from '../types.js';
+/**
+ * Redact sensitive values from metadata
+ */
+export declare function redactSensitiveHeaders(metadata: Record<string, string>, sensitiveHeaders?: string[]): Record<string, string>;
+/**
+ * Create a logging interceptor
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * const logging = createLoggingInterceptor()
+ *
+ * // With custom logger (e.g., pino)
+ * import pino from 'pino'
+ * const logger = pino()
+ *
+ * const logging = createLoggingInterceptor({
+ *   logger: logger,
+ *   level: 'info',
+ *   excludeProcedures: ['health.*', 'metrics.*'],
+ * })
+ *
+ * // Include payloads in debug mode
+ * const logging = createLoggingInterceptor({
+ *   includePayload: process.env.NODE_ENV === 'development',
+ *   includeResponse: process.env.NODE_ENV === 'development',
+ * })
+ *
+ * server.use(logging)
+ * ```
+ */
+export declare function createLoggingInterceptor(config?: LoggingConfig): Interceptor;
+/**
+ * Create a minimal logging interceptor for production
+ *
+ * Only logs errors and slow requests (> threshold).
+ */
+export declare function createProductionLoggingInterceptor(config?: {
+    slowThresholdMs?: number;
+    logger?: LoggingConfig['logger'];
+}): Interceptor;
+/**
+ * Create a debug logging interceptor
+ *
+ * Logs everything including payloads. Use only in development.
+ */
+export declare function createDebugLoggingInterceptor(logger?: LoggingConfig['logger']): Interceptor;
+//# sourceMappingURL=logging.d.ts.map

package/dist/middleware/interceptors/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,aAAa,CAAA;AAoClE;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,gBAAgB,GAAE,MAAM,EAA8B,GACrD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB;AAoDD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,aAAkB,GAAG,WAAW,CA2HhF;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,GAAE;IACzD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;CAC5B,GAAG,WAAW,CAyCnB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,WAAW,CAQ3F"}

package/dist/middleware/interceptors/logging.int.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Logging Interceptor Tests
+ */
+export {};
+//# sourceMappingURL=logging.int.test.d.ts.map

package/dist/middleware/interceptors/logging.int.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.int.test.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/logging.int.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/middleware/interceptors/logging.int.test.js

@@ -0,0 +1,144 @@
+/**
+ * Logging Interceptor Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { createLoggingInterceptor, createProductionLoggingInterceptor, createDebugLoggingInterceptor, } from './logging.js';
+import { createContext } from '../../types/index.js';
+function createEnvelope(procedure, payload = {}) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        payload,
+        type: 'request',
+        metadata: {},
+        context: createContext('test-id'),
+    };
+}
+function createTestContext() {
+    return createContext('test');
+}
+function createMockLogger() {
+    const logs = [];
+    return {
+        logs,
+        logger: {
+            trace: (data, msg) => logs.push({ level: 'trace', message: msg, data }),
+            info: (data, msg) => logs.push({ level: 'info', message: msg, data }),
+            error: (data, msg) => logs.push({ level: 'error', message: msg, data }),
+            debug: (data, msg) => logs.push({ level: 'debug', message: msg, data }),
+            warn: (data, msg) => logs.push({ level: 'warn', message: msg, data }),
+        }
+    };
+}
+describe('createLoggingInterceptor', () => {
+    it('should log requests and responses', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+        });
+        await interceptor(createEnvelope('test.procedure'), createTestContext(), async () => 'result');
+        expect(logs.length).toBeGreaterThanOrEqual(1);
+        expect(logs.some(l => l.message?.includes('test.procedure'))).toBe(true);
+    });
+    it('should log errors', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+        });
+        await expect(interceptor(createEnvelope('test.procedure'), createTestContext(), async () => {
+            throw new Error('Test error');
+        })).rejects.toThrow('Test error');
+        expect(logs.some(l => l.level === 'error')).toBe(true);
+    });
+    it('should skip excluded procedures', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+            excludeProcedures: ['health.check', 'system.ping'],
+        });
+        await interceptor(createEnvelope('health.check'), createTestContext(), async () => 'ok');
+        expect(logs.length).toBe(0);
+    });
+    it('should include payload when configured', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+            includePayload: true,
+        });
+        const payload = { name: 'test', email: 'test@example.com' };
+        await interceptor(createEnvelope('test', payload), createTestContext(), async () => 'ok');
+        expect(logs.some(l => {
+            const data = l.data;
+            return data?.payload !== undefined;
+        })).toBe(true);
+    });
+    it('should include response when configured', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+            includeResponse: true,
+        });
+        await interceptor(createEnvelope('test'), createTestContext(), async () => ({ result: 'success' }));
+        expect(logs.some(l => {
+            const data = l.data;
+            return data?.response !== undefined;
+        })).toBe(true);
+    });
+    it('should apply custom filter', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+            filter: ({ envelope }) => envelope.procedure.startsWith('important'),
+        });
+        await interceptor(createEnvelope('important.action'), createTestContext(), async () => 'ok');
+        expect(logs.length).toBeGreaterThan(0);
+        logs.length = 0;
+        await interceptor(createEnvelope('other.action'), createTestContext(), async () => 'ok');
+        expect(logs.length).toBe(0);
+    });
+    it('should track duration', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createLoggingInterceptor({
+            logger,
+        });
+        await interceptor(createEnvelope('test'), createTestContext(), async () => {
+            await new Promise(resolve => setTimeout(resolve, 10));
+            return 'ok';
+        });
+        expect(logs.some(l => {
+            const data = l.data;
+            return typeof data?.duration === 'number';
+        })).toBe(true);
+    });
+});
+describe('createProductionLoggingInterceptor', () => {
+    it('should only log errors and slow requests', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createProductionLoggingInterceptor({
+            slowThresholdMs: 50,
+            logger,
+        });
+        // Fast request should not be logged
+        await interceptor(createEnvelope('test.fast'), createTestContext(), async () => 'ok');
+        expect(logs.length).toBe(0);
+        // Error should be logged
+        logs.length = 0;
+        await expect(interceptor(createEnvelope('test.error'), createTestContext(), async () => {
+            throw new Error('Test error');
+        })).rejects.toThrow('Test error');
+        expect(logs.some(l => l.level === 'error')).toBe(true);
+    });
+});
+describe('createDebugLoggingInterceptor', () => {
+    it('should include full request and response details', async () => {
+        const { logs, logger } = createMockLogger();
+        const interceptor = createDebugLoggingInterceptor(logger);
+        await interceptor(createEnvelope('test', { input: 'data' }), createTestContext(), async () => ({ output: 'result' }));
+        // Debug logging should include both payload and response
+        expect(logs.some(l => {
+            const data = l.data;
+            return data?.payload !== undefined || data?.response !== undefined;
+        })).toBe(true);
+    });
+});
+//# sourceMappingURL=logging.int.test.js.map

package/dist/middleware/interceptors/logging.int.test.js.map

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