raffel 0.1.2

package/dist/middleware/compose.int.test.js

@@ -0,0 +1,238 @@
+/**
+ * Middleware Compose Tests
+ *
+ * Tests for middleware composition helpers.
+ */
+import { describe, it, expect } from 'vitest';
+import { compose, when, forProcedures, forPattern, except, branch, passthrough, } from './compose.js';
+import { createContext } from '../types/index.js';
+function createEnvelope(procedure) {
+    return {
+        id: `test-${Date.now()}`,
+        procedure,
+        payload: {},
+        type: 'request',
+        metadata: {},
+        context: createContext('test-id'),
+    };
+}
+function createTestContext() {
+    return createContext('test');
+}
+describe('compose', () => {
+    it('should return passthrough for empty interceptors', async () => {
+        const composed = compose();
+        const result = await composed(createEnvelope('test'), createTestContext(), async () => 'done');
+        expect(result).toBe('done');
+    });
+    it('should return single interceptor as-is', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('single');
+            return next();
+        };
+        const composed = compose(interceptor);
+        await composed(createEnvelope('test'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['single', 'handler']);
+    });
+    it('should compose interceptors left-to-right (first is outermost)', async () => {
+        const calls = [];
+        const first = async (_env, _ctx, next) => {
+            calls.push('first-before');
+            const result = await next();
+            calls.push('first-after');
+            return result;
+        };
+        const second = async (_env, _ctx, next) => {
+            calls.push('second-before');
+            const result = await next();
+            calls.push('second-after');
+            return result;
+        };
+        const third = async (_env, _ctx, next) => {
+            calls.push('third-before');
+            const result = await next();
+            calls.push('third-after');
+            return result;
+        };
+        // compose(first, second, third) means first runs first (outermost)
+        const composed = compose(first, second, third);
+        await composed(createEnvelope('test'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        // first wraps second wraps third wraps handler
+        expect(calls).toEqual([
+            'first-before',
+            'second-before',
+            'third-before',
+            'handler',
+            'third-after',
+            'second-after',
+            'first-after',
+        ]);
+    });
+});
+describe('when', () => {
+    it('should run interceptor when predicate is true', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const conditional = when((envelope) => envelope.procedure === 'target', interceptor);
+        await conditional(createEnvelope('target'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['interceptor', 'handler']);
+    });
+    it('should skip interceptor when predicate is false', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const conditional = when((envelope) => envelope.procedure === 'target', interceptor);
+        await conditional(createEnvelope('other'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['handler']);
+    });
+});
+describe('forProcedures', () => {
+    it('should run interceptor for matching procedures', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const filtered = forProcedures(['users.create', 'users.update'], interceptor);
+        await filtered(createEnvelope('users.create'), createTestContext(), async () => {
+            calls.push('handler1');
+            return 'done';
+        });
+        calls.length = 0;
+        await filtered(createEnvelope('users.delete'), createTestContext(), async () => {
+            calls.push('handler2');
+            return 'done';
+        });
+        expect(calls).toEqual(['handler2']);
+    });
+});
+describe('forPattern', () => {
+    it('should match wildcard patterns', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const filtered = forPattern('admin.*', interceptor);
+        await filtered(createEnvelope('admin.users'), createTestContext(), async () => {
+            calls.push('handler1');
+            return 'done';
+        });
+        expect(calls).toEqual(['interceptor', 'handler1']);
+        calls.length = 0;
+        await filtered(createEnvelope('users.list'), createTestContext(), async () => {
+            calls.push('handler2');
+            return 'done';
+        });
+        expect(calls).toEqual(['handler2']);
+    });
+    it('should match double wildcard patterns', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const filtered = forPattern('admin.**', interceptor);
+        await filtered(createEnvelope('admin.users.create'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['interceptor', 'handler']);
+    });
+    it('should not match partial patterns', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const filtered = forPattern('admin', interceptor);
+        await filtered(createEnvelope('admin.users'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        // Should NOT match because 'admin' !== 'admin.users'
+        expect(calls).toEqual(['handler']);
+    });
+});
+describe('except', () => {
+    it('should skip interceptor for excluded procedures', async () => {
+        const calls = [];
+        const interceptor = async (_env, _ctx, next) => {
+            calls.push('interceptor');
+            return next();
+        };
+        const filtered = except(['health.check', 'system.ping'], interceptor);
+        await filtered(createEnvelope('health.check'), createTestContext(), async () => {
+            calls.push('handler1');
+            return 'done';
+        });
+        expect(calls).toEqual(['handler1']);
+        calls.length = 0;
+        await filtered(createEnvelope('users.list'), createTestContext(), async () => {
+            calls.push('handler2');
+            return 'done';
+        });
+        expect(calls).toEqual(['interceptor', 'handler2']);
+    });
+});
+describe('branch', () => {
+    it('should run onTrue when predicate is true', async () => {
+        const calls = [];
+        const onTrue = async (_env, _ctx, next) => {
+            calls.push('onTrue');
+            return next();
+        };
+        const onFalse = async (_env, _ctx, next) => {
+            calls.push('onFalse');
+            return next();
+        };
+        const branched = branch((envelope) => envelope.procedure.startsWith('admin'), onTrue, onFalse);
+        await branched(createEnvelope('admin.users'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['onTrue', 'handler']);
+    });
+    it('should run onFalse when predicate is false', async () => {
+        const calls = [];
+        const onTrue = async (_env, _ctx, next) => {
+            calls.push('onTrue');
+            return next();
+        };
+        const onFalse = async (_env, _ctx, next) => {
+            calls.push('onFalse');
+            return next();
+        };
+        const branched = branch((envelope) => envelope.procedure.startsWith('admin'), onTrue, onFalse);
+        await branched(createEnvelope('users.list'), createTestContext(), async () => {
+            calls.push('handler');
+            return 'done';
+        });
+        expect(calls).toEqual(['onFalse', 'handler']);
+    });
+});
+describe('passthrough', () => {
+    it('should just call next', async () => {
+        const result = await passthrough(createEnvelope('test'), createTestContext(), async () => 'done');
+        expect(result).toBe('done');
+    });
+});
+//# sourceMappingURL=compose.int.test.js.map

package/dist/middleware/compose.int.test.js.map

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

package/dist/middleware/compose.js

@@ -0,0 +1,152 @@
+/**
+ * Middleware Composition Helpers
+ *
+ * Utilities for combining multiple interceptors.
+ */
+/**
+ * Compose multiple interceptors into one (left-to-right execution order)
+ *
+ * The first interceptor in the list will be the outermost (runs first).
+ * The last interceptor will be closest to the handler.
+ *
+ * @example
+ * ```typescript
+ * // auth runs first, then validation, then rateLimit
+ * const middleware = compose(auth, validation, rateLimit)
+ * ```
+ *
+ * @param interceptors - Interceptors to compose (left-to-right order)
+ * @returns A single composed interceptor
+ */
+export function compose(...interceptors) {
+    if (interceptors.length === 0) {
+        return (_envelope, _ctx, next) => next();
+    }
+    if (interceptors.length === 1) {
+        return interceptors[0];
+    }
+    return (envelope, ctx, next) => {
+        // Build chain from right to left
+        let chain = next;
+        for (let i = interceptors.length - 1; i >= 0; i--) {
+            const interceptor = interceptors[i];
+            const nextInChain = chain;
+            chain = () => interceptor(envelope, ctx, nextInChain);
+        }
+        return chain();
+    };
+}
+/**
+ * Create a conditional interceptor that only runs if predicate is true
+ *
+ * @example
+ * ```typescript
+ * const adminOnly = when(
+ *   (envelope) => envelope.procedure.startsWith('admin.'),
+ *   requireAdmin
+ * )
+ * ```
+ *
+ * @param predicate - Function that returns true if interceptor should run
+ * @param interceptor - Interceptor to conditionally run
+ * @returns A conditional interceptor
+ */
+export function when(predicate, interceptor) {
+    return (envelope, ctx, next) => {
+        if (predicate(envelope, ctx)) {
+            return interceptor(envelope, ctx, next);
+        }
+        return next();
+    };
+}
+/**
+ * Create an interceptor that only runs for specific procedures
+ *
+ * @example
+ * ```typescript
+ * const usersRateLimit = forProcedures(['users.create', 'users.update'], rateLimit)
+ * ```
+ *
+ * @param procedures - List of procedure names to match
+ * @param interceptor - Interceptor to run for matching procedures
+ * @returns A procedure-filtered interceptor
+ */
+export function forProcedures(procedures, interceptor) {
+    const procedureSet = new Set(procedures);
+    return when((envelope) => procedureSet.has(envelope.procedure), interceptor);
+}
+/**
+ * Create an interceptor that only runs for procedures matching a pattern
+ *
+ * @example
+ * ```typescript
+ * const adminRateLimit = forPattern('admin.*', strictRateLimit)
+ * ```
+ *
+ * @param pattern - Glob pattern (supports * and **)
+ * @param interceptor - Interceptor to run for matching procedures
+ * @returns A pattern-filtered interceptor
+ */
+export function forPattern(pattern, interceptor) {
+    const regex = patternToRegex(pattern);
+    return when((envelope) => regex.test(envelope.procedure), interceptor);
+}
+/**
+ * Create an interceptor that skips specific procedures
+ *
+ * @example
+ * ```typescript
+ * const authWithExclusions = except(['health.check', 'system.ping'], authMiddleware)
+ * ```
+ *
+ * @param procedures - List of procedure names to skip
+ * @param interceptor - Interceptor to run for non-matching procedures
+ * @returns An exclusion-filtered interceptor
+ */
+export function except(procedures, interceptor) {
+    const procedureSet = new Set(procedures);
+    return when((envelope) => !procedureSet.has(envelope.procedure), interceptor);
+}
+/**
+ * Create an interceptor that runs a different interceptor based on a condition
+ *
+ * @example
+ * ```typescript
+ * const rateLimiter = branch(
+ *   (envelope, ctx) => ctx.auth?.authenticated,
+ *   authenticatedRateLimit,  // 1000 req/min
+ *   anonymousRateLimit       // 100 req/min
+ * )
+ * ```
+ *
+ * @param predicate - Function to determine which branch to take
+ * @param onTrue - Interceptor to run if predicate is true
+ * @param onFalse - Interceptor to run if predicate is false
+ * @returns A branching interceptor
+ */
+export function branch(predicate, onTrue, onFalse) {
+    return (envelope, ctx, next) => {
+        if (predicate(envelope, ctx)) {
+            return onTrue(envelope, ctx, next);
+        }
+        return onFalse(envelope, ctx, next);
+    };
+}
+/**
+ * Create a no-op interceptor (passthrough)
+ *
+ * Useful as a placeholder or default value.
+ */
+export const passthrough = (_envelope, _ctx, next) => next();
+/**
+ * Convert a glob pattern to regex
+ */
+function patternToRegex(pattern) {
+    const escaped = pattern
+        .replace(/[.+^${}()|[\]\\]/g, '\\$&') // Escape special chars
+        .replace(/\*\*/g, '{{DOUBLE_STAR}}') // Temp placeholder for **
+        .replace(/\*/g, '[^.]*') // * = any chars except dot
+        .replace(/{{DOUBLE_STAR}}/g, '.*'); // ** = any chars including dot
+    return new RegExp(`^${escaped}$`);
+}
+//# sourceMappingURL=compose.js.map

package/dist/middleware/compose.js.map

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

package/dist/middleware/http/compression.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Compression Middleware
+ *
+ * HTTP-specific middleware for response compression.
+ * Supports gzip, deflate, and brotli encodings.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { CompressionConfig, CompressionEncoding } from '../types.js';
+/**
+ * Default compression configuration
+ */
+export declare const defaultCompressionConfig: CompressionConfig;
+/**
+ * Compression result
+ */
+export interface CompressionResult {
+    /** Compressed data */
+    data: Buffer;
+    /** Encoding used */
+    encoding: CompressionEncoding;
+    /** Original size */
+    originalSize: number;
+    /** Compressed size */
+    compressedSize: number;
+    /** Compression ratio (0-1, lower is better) */
+    ratio: number;
+}
+/**
+ * Compress a buffer if it meets the criteria
+ *
+ * @example
+ * ```typescript
+ * const body = Buffer.from(JSON.stringify(largeObject))
+ * const result = compressBuffer(body, 'application/json', 'gzip, deflate', {
+ *   threshold: 1024,
+ *   level: 6,
+ * })
+ *
+ * if (result) {
+ *   res.setHeader('Content-Encoding', result.encoding)
+ *   res.setHeader('Content-Length', result.compressedSize)
+ *   res.end(result.data)
+ * } else {
+ *   res.end(body)
+ * }
+ * ```
+ */
+export declare function compressBuffer(data: Buffer, contentType: string | undefined, acceptEncoding: string | undefined, config?: CompressionConfig): CompressionResult | null;
+/**
+ * Create a compression middleware that wraps response.end()
+ *
+ * This is a more invasive approach that intercepts the response.
+ * Use with caution and only when you control the full request lifecycle.
+ *
+ * @example
+ * ```typescript
+ * const compress = createCompressionMiddleware()
+ *
+ * function handleRequest(req, res) {
+ *   compress(req, res)
+ *
+ *   // Your normal response handling
+ *   res.setHeader('Content-Type', 'application/json')
+ *   res.end(JSON.stringify(data)) // Will be compressed automatically
+ * }
+ * ```
+ */
+export declare function createCompressionMiddleware(config?: CompressionConfig): (req: IncomingMessage, res: ServerResponse) => void;
+/**
+ * Compress a response body manually
+ *
+ * Use this for more control over when and how compression happens.
+ *
+ * @example
+ * ```typescript
+ * const body = JSON.stringify(largeData)
+ * const result = compressResponse(req, res, body, 'application/json')
+ *
+ * if (result.compressed) {
+ *   // Headers already set, just end
+ *   res.end(result.body)
+ * } else {
+ *   res.setHeader('Content-Type', 'application/json')
+ *   res.end(body)
+ * }
+ * ```
+ */
+export declare function compressResponse(req: IncomingMessage, res: ServerResponse, body: string | Buffer, contentType: string, config?: CompressionConfig): {
+    body: Buffer;
+    compressed: boolean;
+};
+//# sourceMappingURL=compression.d.ts.map

package/dist/middleware/http/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../../src/middleware/http/compression.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEzE;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,iBAetC,CAAA;AA0FD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,oBAAoB;IACpB,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,MAAM,GAAE,iBAA4C,GACnD,iBAAiB,GAAG,IAAI,CAuC1B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,GAAE,iBAA4C,GACnD,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CA8ErD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE,iBAA4C,GACnD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAmBvC"}