raffel 0.1.2

package/dist/middleware/interceptors/dedup.js

@@ -0,0 +1,219 @@
+/**
+ * Request Deduplication Interceptor
+ *
+ * Coalesces identical in-flight requests to avoid duplicate work.
+ * When multiple requests with the same key are made simultaneously,
+ * only the first one executes - subsequent ones wait for and share the result.
+ *
+ * Features:
+ * - Automatic key generation based on procedure + payload hash
+ * - Custom key generators for complex scenarios
+ * - Safe method detection (only dedup idempotent operations)
+ * - Memory-efficient with automatic cleanup
+ */
+/**
+ * Simple hash function for payload
+ */
+function hashPayload(payload) {
+    if (payload === undefined || payload === null) {
+        return 'null';
+    }
+    try {
+        const str = JSON.stringify(payload);
+        // Simple djb2 hash
+        let hash = 5381;
+        for (let i = 0; i < str.length; i++) {
+            hash = ((hash << 5) + hash) ^ str.charCodeAt(i);
+        }
+        return (hash >>> 0).toString(36);
+    }
+    catch {
+        // If payload can't be stringified, use a random key (no dedup)
+        return Math.random().toString(36).slice(2);
+    }
+}
+/**
+ * Default key generator: procedure + payload hash
+ */
+function defaultKeyGenerator(envelope) {
+    return `${envelope.procedure}:${hashPayload(envelope.payload)}`;
+}
+/**
+ * Match a procedure name against glob patterns
+ */
+function matchProcedure(patterns, procedure) {
+    return patterns.some((pattern) => {
+        const regex = pattern
+            .replace(/[.+^${}()|[\]\\]/g, '\\$&')
+            .replace(/\*\*/g, '{{DOUBLE_STAR}}')
+            .replace(/\*/g, '[^.]*')
+            .replace(/{{DOUBLE_STAR}}/g, '.*');
+        return new RegExp(`^${regex}$`).test(procedure);
+    });
+}
+/**
+ * Create a request deduplication interceptor
+ *
+ * Coalesces identical in-flight requests to avoid duplicate work.
+ * Only the first request executes; subsequent identical requests
+ * wait for and share the result.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - dedup queries only
+ * const dedup = createDedupInterceptor()
+ *
+ * // Custom key generation
+ * const dedup = createDedupInterceptor({
+ *   keyGenerator: (envelope, ctx) => {
+ *     // Include user in key for user-specific caching
+ *     return `${ctx.auth?.principal}:${envelope.procedure}`
+ *   }
+ * })
+ *
+ * // With metrics
+ * const dedup = createDedupInterceptor({
+ *   onDedup: ({ procedure, waitingCount }) => {
+ *     metrics.increment('dedup.coalesced', { procedure })
+ *     metrics.gauge('dedup.waiting', waitingCount)
+ *   }
+ * })
+ *
+ * // Deduplicate specific procedures
+ * const dedup = createDedupInterceptor({
+ *   types: ['query', 'procedure'],
+ *   procedures: ['users.get', 'products.list', 'cache.**'],
+ * })
+ *
+ * server.use(dedup)
+ * ```
+ */
+export function createDedupInterceptor(config = {}) {
+    const { keyGenerator = defaultKeyGenerator, types = ['query'], procedures, excludeProcedures = [], ttlMs = 30000, onDedup, } = config;
+    const pending = new Map();
+    // Cleanup stale entries periodically
+    const cleanupInterval = setInterval(() => {
+        const now = Date.now();
+        for (const [key, record] of pending) {
+            if (now - record.timestamp > ttlMs) {
+                pending.delete(key);
+            }
+        }
+    }, ttlMs);
+    cleanupInterval.unref?.();
+    return async (envelope, ctx, next) => {
+        // Check if this type should be deduplicated
+        if (!types.includes(envelope.type)) {
+            return next();
+        }
+        // Check procedure patterns
+        if (procedures && procedures.length > 0) {
+            if (!matchProcedure(procedures, envelope.procedure)) {
+                return next();
+            }
+        }
+        // Check exclusions
+        if (excludeProcedures.length > 0) {
+            if (matchProcedure(excludeProcedures, envelope.procedure)) {
+                return next();
+            }
+        }
+        // Generate dedup key
+        const key = keyGenerator(envelope, ctx);
+        // Check for pending request
+        const existing = pending.get(key);
+        if (existing) {
+            existing.waitingCount++;
+            // Callback for metrics
+            if (onDedup) {
+                onDedup({
+                    key,
+                    procedure: envelope.procedure,
+                    requestId: ctx.requestId,
+                    waitingCount: existing.waitingCount,
+                });
+            }
+            // Wait for the existing request to complete
+            // Clone the result to prevent mutation issues
+            const result = await existing.promise;
+            return cloneResult(result);
+        }
+        // Create new pending request
+        const promise = next()
+            .then((result) => {
+            // Keep result briefly for late arrivals
+            setTimeout(() => pending.delete(key), 10);
+            return result;
+        })
+            .catch((error) => {
+            // Remove on error so next request can retry
+            pending.delete(key);
+            throw error;
+        });
+        pending.set(key, {
+            promise,
+            timestamp: Date.now(),
+            waitingCount: 0,
+        });
+        return promise;
+    };
+}
+/**
+ * Clone a result to prevent mutation between shared responses
+ */
+function cloneResult(result) {
+    if (result === null || result === undefined) {
+        return result;
+    }
+    if (typeof result !== 'object') {
+        return result;
+    }
+    // Handle arrays
+    if (Array.isArray(result)) {
+        return result.map(cloneResult);
+    }
+    // Handle plain objects
+    try {
+        return JSON.parse(JSON.stringify(result));
+    }
+    catch {
+        // If cloning fails, return as-is (might cause issues but better than crashing)
+        return result;
+    }
+}
+/**
+ * Create a deduplication interceptor for read-only procedures
+ *
+ * Convenience wrapper that only deduplicates queries and
+ * procedures matching common read patterns.
+ *
+ * @example
+ * ```typescript
+ * const dedup = createReadOnlyDedupInterceptor()
+ * server.use(dedup)
+ * ```
+ */
+export function createReadOnlyDedupInterceptor(config = {}) {
+    return createDedupInterceptor({
+        ...config,
+        types: ['query', 'procedure'],
+        procedures: [
+            '*.get',
+            '*.get*',
+            '*.find',
+            '*.find*',
+            '*.list',
+            '*.list*',
+            '*.search',
+            '*.search*',
+            '*.count',
+            '*.count*',
+            '*.exists',
+            '*.check*',
+            'read.**',
+            'query.**',
+            'fetch.**',
+        ],
+    });
+}
+//# sourceMappingURL=dedup.js.map

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

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

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

@@ -0,0 +1,94 @@
+/**
+ * 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
+ */
+import type { Interceptor, Context } from '../../types/index.js';
+import type { FallbackConfig } from '../types.js';
+/**
+ * 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 declare function createFallbackInterceptor<TOutput = unknown>(config: FallbackConfig<TOutput>): Interceptor;
+/**
+ * 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 declare function createProcedureFallback<TDefault = unknown>(config: {
+    default?: FallbackConfig<TDefault>;
+    procedures: Record<string, FallbackConfig<unknown>>;
+}): Interceptor;
+/**
+ * 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 declare function createCircuitAwareFallback<TOutput = unknown>(config: {
+    response?: TOutput;
+    handler?: (ctx: Context, error: Error) => TOutput | Promise<TOutput>;
+    errorCodes?: string[];
+}): Interceptor;
+//# sourceMappingURL=fallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/middleware/interceptors/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAY,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,GAAG,OAAO,EACzD,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,GAC9B,WAAW,CA4Bb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,GAAG,OAAO,EAAE,MAAM,EAAE;IAClE,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAA;IAClC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAA;CACpD,GAAG,WAAW,CAkDd;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB,GAAG,WAAW,CAed"}

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

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

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

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

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

@@ -0,0 +1,211 @@
+/**
+ * Fallback Interceptor Tests
+ */
+import { describe, it, expect } from 'vitest';
+import { createFallbackInterceptor, createProcedureFallback, createCircuitAwareFallback, } from './fallback.js';
+import { createContext } from '../../types/index.js';
+import { RaffelError } from '../../core/router.js';
+function createEnvelope(procedure) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        payload: {},
+        type: 'request',
+        metadata: {},
+        context: createContext('test-id'),
+    };
+}
+function createTestContext() {
+    return createContext('test');
+}
+describe('createFallbackInterceptor', () => {
+    it('should throw if neither response nor handler is provided', () => {
+        expect(() => createFallbackInterceptor({})).toThrow('Fallback interceptor requires either "response" or "handler" option');
+    });
+    it('should return handler result on success', async () => {
+        const fallback = createFallbackInterceptor({
+            response: { status: 'fallback' },
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => ({ status: 'success' }));
+        expect(result).toEqual({ status: 'success' });
+    });
+    it('should return static response on error', async () => {
+        const fallback = createFallbackInterceptor({
+            response: { id: 0, name: 'Guest' },
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new Error('Service down');
+        });
+        expect(result).toEqual({ id: 0, name: 'Guest' });
+    });
+    it('should call handler function on error', async () => {
+        const fallback = createFallbackInterceptor({
+            handler: (ctx, error) => ({
+                id: 0,
+                name: 'Guest',
+                errorReason: error.message,
+            }),
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new Error('Database timeout');
+        });
+        expect(result).toEqual({
+            id: 0,
+            name: 'Guest',
+            errorReason: 'Database timeout',
+        });
+    });
+    it('should support async handler function', async () => {
+        const fallback = createFallbackInterceptor({
+            handler: async (_ctx, error) => {
+                await new Promise(resolve => setTimeout(resolve, 10));
+                return { fromCache: true, error: error.message };
+            },
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(result).toEqual({ fromCache: true, error: 'Failed' });
+    });
+    it('should apply fallback only when condition is true', async () => {
+        const fallback = createFallbackInterceptor({
+            response: { status: 'unavailable' },
+            when: (error) => error.code === 'SERVICE_UNAVAILABLE',
+        });
+        // Should fallback for SERVICE_UNAVAILABLE
+        const result1 = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('SERVICE_UNAVAILABLE', 'Service down');
+        });
+        expect(result1).toEqual({ status: 'unavailable' });
+        // Should NOT fallback for other errors
+        await expect(fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('VALIDATION_ERROR', 'Bad input');
+        })).rejects.toThrow('Bad input');
+    });
+    it('should re-throw when condition returns false', async () => {
+        const fallback = createFallbackInterceptor({
+            response: { status: 'unavailable' },
+            when: (error) => error.message.includes('timeout'),
+        });
+        await expect(fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new Error('validation failed');
+        })).rejects.toThrow('validation failed');
+    });
+    it('should prefer handler over response when both provided', async () => {
+        const fallback = createFallbackInterceptor({
+            response: { source: 'static' },
+            handler: () => ({ source: 'handler' }),
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new Error('Fail');
+        });
+        expect(result).toEqual({ source: 'handler' });
+    });
+});
+describe('createProcedureFallback', () => {
+    it('should use procedure-specific fallback', async () => {
+        const fallback = createProcedureFallback({
+            procedures: {
+                'users.get': { response: { id: 0, name: 'Guest' } },
+                'config.get': { response: { theme: 'default' } },
+            },
+        });
+        const userResult = await fallback(createEnvelope('users.get'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(userResult).toEqual({ id: 0, name: 'Guest' });
+        const configResult = await fallback(createEnvelope('config.get'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(configResult).toEqual({ theme: 'default' });
+    });
+    it('should use default fallback for unconfigured procedures', async () => {
+        const fallback = createProcedureFallback({
+            default: { response: { status: 'unavailable' } },
+            procedures: {
+                'specific.procedure': { response: { status: 'specific-fallback' } },
+            },
+        });
+        const result = await fallback(createEnvelope('other.procedure'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(result).toEqual({ status: 'unavailable' });
+    });
+    it('should pass through if no fallback configured', async () => {
+        const fallback = createProcedureFallback({
+            procedures: {
+                'specific.procedure': { response: { status: 'specific-fallback' } },
+            },
+        });
+        // No default, no matching procedure - error should propagate
+        await expect(fallback(createEnvelope('other.procedure'), createTestContext(), async () => {
+            throw new Error('No fallback');
+        })).rejects.toThrow('No fallback');
+    });
+    it('should match patterns', async () => {
+        const fallback = createProcedureFallback({
+            procedures: {
+                'users.*': { response: { id: 0, type: 'user' } },
+                'orders.**': { response: { orderId: null, type: 'order' } },
+            },
+        });
+        const userResult = await fallback(createEnvelope('users.get'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(userResult).toEqual({ id: 0, type: 'user' });
+        const orderResult = await fallback(createEnvelope('orders.details.get'), createTestContext(), async () => {
+            throw new Error('Failed');
+        });
+        expect(orderResult).toEqual({ orderId: null, type: 'order' });
+    });
+});
+describe('createCircuitAwareFallback', () => {
+    it('should fallback only for specified error codes', async () => {
+        const fallback = createCircuitAwareFallback({
+            response: { status: 'degraded' },
+            errorCodes: ['UNAVAILABLE', 'DEADLINE_EXCEEDED'],
+        });
+        // Should fallback for UNAVAILABLE
+        const result1 = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('UNAVAILABLE', 'Service down');
+        });
+        expect(result1).toEqual({ status: 'degraded' });
+        // Should fallback for DEADLINE_EXCEEDED
+        const result2 = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('DEADLINE_EXCEEDED', 'Timeout');
+        });
+        expect(result2).toEqual({ status: 'degraded' });
+        // Should NOT fallback for other codes
+        await expect(fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('INVALID_ARGUMENT', 'Bad input');
+        })).rejects.toThrow('Bad input');
+    });
+    it('should use default error codes if not specified', async () => {
+        const fallback = createCircuitAwareFallback({
+            response: { status: 'degraded' },
+            // Uses default codes: UNAVAILABLE, DEADLINE_EXCEEDED, INTERNAL_ERROR
+        });
+        // INTERNAL_ERROR should trigger fallback
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('INTERNAL_ERROR', 'Something broke');
+        });
+        expect(result).toEqual({ status: 'degraded' });
+    });
+    it('should support handler function', async () => {
+        const fallback = createCircuitAwareFallback({
+            handler: (ctx, error) => ({
+                degraded: true,
+                reason: error.message,
+            }),
+            errorCodes: ['UNAVAILABLE'],
+        });
+        const result = await fallback(createEnvelope('test'), createTestContext(), async () => {
+            throw new RaffelError('UNAVAILABLE', 'API unreachable');
+        });
+        expect(result).toEqual({
+            degraded: true,
+            reason: 'API unreachable',
+        });
+    });
+});
+//# sourceMappingURL=fallback.int.test.js.map

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

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