@furystack/rest-service 10.0.27 → 10.1.0

package/esm/header-processor.spec.js

@@ -0,0 +1,420 @@
+import { describe, expect, it } from 'vitest';
+import { HeaderProcessor } from './header-processor.js';
+describe('HeaderProcessor', () => {
+    const processor = new HeaderProcessor();
+    describe('filterHeaders', () => {
+        it('should filter out hop-by-hop headers', () => {
+            const headers = {
+                'content-type': 'application/json',
+                connection: 'keep-alive',
+                'keep-alive': 'timeout=5',
+                'x-custom-header': 'custom-value',
+                'transfer-encoding': 'chunked',
+            };
+            const filtered = processor.filterHeaders(headers);
+            expect(filtered['content-type']).toBe('application/json');
+            expect(filtered['x-custom-header']).toBe('custom-value');
+            expect(filtered.connection).toBeUndefined();
+            expect(filtered['keep-alive']).toBeUndefined();
+            expect(filtered['transfer-encoding']).toBeUndefined();
+        });
+        it('should preserve all non-hop-by-hop headers', () => {
+            const headers = {
+                'content-type': 'text/html',
+                'content-length': '1234',
+                authorization: 'Bearer token',
+                'x-custom-header': 'value',
+            };
+            const filtered = processor.filterHeaders(headers);
+            expect(filtered).toEqual(headers);
+        });
+        it('should handle empty headers object', () => {
+            const filtered = processor.filterHeaders({});
+            expect(filtered).toEqual({});
+        });
+    });
+    describe('processCookies', () => {
+        it('should parse cookies from request header', () => {
+            const req = {
+                headers: {
+                    cookie: 'sessionId=abc123; theme=dark; userId=456',
+                },
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual(['sessionId=abc123', 'theme=dark', 'userId=456']);
+        });
+        it('should return empty array when no cookies present', () => {
+            const req = {
+                headers: {},
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual([]);
+        });
+        it('should apply cookie transformer when provided', () => {
+            const req = {
+                headers: {
+                    cookie: 'oldCookie=value',
+                },
+            };
+            const transformer = (cookies) => [...cookies, 'newCookie=newValue'];
+            const cookies = processor.processCookies(req, transformer);
+            expect(cookies).toEqual(['oldCookie=value', 'newCookie=newValue']);
+        });
+        it('should trim cookie values', () => {
+            const req = {
+                headers: {
+                    cookie: ' cookie1=value1 ; cookie2=value2 ',
+                },
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual(['cookie1=value1', 'cookie2=value2']);
+        });
+    });
+    describe('buildForwardedHeaders', () => {
+        it('should build X-Forwarded-* headers', () => {
+            const req = {
+                headers: {
+                    'user-agent': 'test-agent',
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers.Host).toBe('target.com');
+            expect(headers['User-Agent']).toBe('test-agent');
+            expect(headers['X-Forwarded-For']).toBe('192.168.1.100');
+            expect(headers['X-Forwarded-Host']).toBe('source.com');
+            expect(headers['X-Forwarded-Proto']).toBe('http');
+        });
+        it('should chain X-Forwarded-For headers', () => {
+            const req = {
+                headers: {
+                    'x-forwarded-for': '10.0.0.1, 10.0.0.2',
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-For']).toBe('10.0.0.1, 10.0.0.2, 192.168.1.100');
+        });
+        it('should detect HTTPS from encrypted socket', () => {
+            const req = {
+                headers: {
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                    encrypted: true,
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-Proto']).toBe('https');
+        });
+        it('should use existing X-Forwarded-Proto if present', () => {
+            const req = {
+                headers: {
+                    'x-forwarded-proto': 'https',
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-Proto']).toBe('https');
+        });
+        it('should use default User-Agent when not provided', () => {
+            const req = {
+                headers: {
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['User-Agent']).toBe('FuryStack-Proxy/1.0');
+        });
+    });
+    describe('convertHeadersToRecord', () => {
+        it('should convert string headers', () => {
+            const headers = {
+                'content-type': 'application/json',
+                authorization: 'Bearer token',
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record).toEqual(headers);
+        });
+        it('should convert number headers to strings', () => {
+            const headers = {
+                'content-length': 1234,
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['content-length']).toBe('1234');
+        });
+        it('should join array headers with commas', () => {
+            const headers = {
+                'x-custom-header': ['value1', 'value2', 'value3'],
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['x-custom-header']).toBe('value1, value2, value3');
+        });
+        it('should skip undefined headers', () => {
+            const headers = {
+                'defined-header': 'value',
+                'undefined-header': undefined,
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['defined-header']).toBe('value');
+            expect(record['undefined-header']).toBeUndefined();
+        });
+        it('should exclude cookie header', () => {
+            const headers = {
+                'content-type': 'application/json',
+                cookie: 'sessionId=abc123',
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['content-type']).toBe('application/json');
+            expect(record.cookie).toBeUndefined();
+        });
+        it('should exclude hop-by-hop headers', () => {
+            const headers = {
+                'content-type': 'application/json',
+                connection: 'keep-alive',
+                'transfer-encoding': 'chunked',
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['content-type']).toBe('application/json');
+            expect(record.connection).toBeUndefined();
+            expect(record['transfer-encoding']).toBeUndefined();
+        });
+    });
+    describe('processRequestHeaders', () => {
+        it('should process all headers and return proxy-ready headers', () => {
+            const req = {
+                headers: {
+                    'content-type': 'application/json',
+                    'user-agent': 'test-agent',
+                    cookie: 'sessionId=abc123',
+                    connection: 'keep-alive',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const result = processor.processRequestHeaders(req, 'target.com');
+            expect(result.proxyHeaders['content-type']).toBe('application/json');
+            expect(result.proxyHeaders.Host).toBe('target.com');
+            expect(result.proxyHeaders['X-Forwarded-For']).toBe('192.168.1.100');
+            expect(result.proxyHeaders.Cookie).toBe('sessionId=abc123');
+            expect(result.proxyHeaders.connection).toBeUndefined();
+            expect(result.finalCookies).toEqual(['sessionId=abc123']);
+        });
+        it('should apply header transformer', () => {
+            const req = {
+                headers: {
+                    'content-type': 'application/json',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headerTransformer = () => ({
+                'x-custom-header': 'custom-value',
+            });
+            const result = processor.processRequestHeaders(req, 'target.com', {
+                headers: headerTransformer,
+            });
+            expect(result.proxyHeaders['x-custom-header']).toBe('custom-value');
+            expect(result.proxyHeaders['content-type']).toBeUndefined();
+        });
+        it('should apply cookie transformer', () => {
+            const req = {
+                headers: {
+                    cookie: 'oldCookie=value',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const cookieTransformer = (cookies) => [...cookies, 'newCookie=newValue'];
+            const result = processor.processRequestHeaders(req, 'target.com', {
+                cookies: cookieTransformer,
+            });
+            expect(result.proxyHeaders.Cookie).toBe('oldCookie=value; newCookie=newValue');
+            expect(result.finalCookies).toEqual(['oldCookie=value', 'newCookie=newValue']);
+        });
+        it('should not include Cookie header when no cookies present', () => {
+            const req = {
+                headers: {},
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const result = processor.processRequestHeaders(req, 'target.com');
+            expect(result.proxyHeaders.Cookie).toBeUndefined();
+            expect(result.finalCookies).toEqual([]);
+        });
+    });
+    describe('isHopByHopHeader', () => {
+        it('should identify hop-by-hop headers', () => {
+            expect(processor.isHopByHopHeader('connection')).toBe(true);
+            expect(processor.isHopByHopHeader('Connection')).toBe(true);
+            expect(processor.isHopByHopHeader('keep-alive')).toBe(true);
+            expect(processor.isHopByHopHeader('transfer-encoding')).toBe(true);
+            expect(processor.isHopByHopHeader('upgrade')).toBe(true);
+        });
+        it('should not identify regular headers as hop-by-hop', () => {
+            expect(processor.isHopByHopHeader('content-type')).toBe(false);
+            expect(processor.isHopByHopHeader('authorization')).toBe(false);
+            expect(processor.isHopByHopHeader('x-custom-header')).toBe(false);
+        });
+        it('should identify all standard hop-by-hop headers', () => {
+            expect(processor.isHopByHopHeader('proxy-authenticate')).toBe(true);
+            expect(processor.isHopByHopHeader('proxy-authorization')).toBe(true);
+            expect(processor.isHopByHopHeader('te')).toBe(true);
+            expect(processor.isHopByHopHeader('trailer')).toBe(true);
+        });
+    });
+    describe('Edge cases and complex scenarios', () => {
+        it('should handle empty cookie strings correctly', () => {
+            const req = {
+                headers: {
+                    cookie: '',
+                },
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual(['']);
+        });
+        it('should handle multiple semicolons in cookie string', () => {
+            const req = {
+                headers: {
+                    cookie: 'cookie1=value1;;cookie2=value2',
+                },
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual(['cookie1=value1', '', 'cookie2=value2']);
+        });
+        it('should handle cookies with special characters', () => {
+            const req = {
+                headers: {
+                    cookie: 'session=abc%3D123; token=Bearer%20xyz',
+                },
+            };
+            const cookies = processor.processCookies(req);
+            expect(cookies).toEqual(['session=abc%3D123', 'token=Bearer%20xyz']);
+        });
+        it('should handle missing remote address gracefully', () => {
+            const req = {
+                headers: {
+                    host: 'source.com',
+                },
+                socket: {},
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-For']).toBe('');
+        });
+        it('should handle very long X-Forwarded-For chains', () => {
+            const longChain = Array.from({ length: 20 }, (_, i) => `10.0.0.${i + 1}`).join(', ');
+            const req = {
+                headers: {
+                    'x-forwarded-for': longChain,
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-For']).toContain(longChain);
+            expect(headers['X-Forwarded-For']).toContain('192.168.1.100');
+        });
+        it('should handle mixed case header names', () => {
+            const headers = {
+                'Content-Type': 'application/json',
+                'X-Custom-Header': 'value',
+                CONNECTION: 'keep-alive',
+            };
+            const filtered = processor.filterHeaders(headers);
+            expect(filtered['Content-Type']).toBe('application/json');
+            expect(filtered['X-Custom-Header']).toBe('value');
+            expect(filtered.CONNECTION).toBeUndefined();
+        });
+        it('should handle empty array headers', () => {
+            const headers = {
+                'X-Empty-Array': [],
+            };
+            const record = processor.convertHeadersToRecord(headers);
+            expect(record['X-Empty-Array']).toBe('');
+        });
+        it('should preserve header order when processing', () => {
+            const req = {
+                headers: {
+                    'first-header': 'first',
+                    'second-header': 'second',
+                    'third-header': 'third',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const result = processor.processRequestHeaders(req, 'target.com');
+            expect(result.proxyHeaders['first-header']).toBe('first');
+            expect(result.proxyHeaders['second-header']).toBe('second');
+            expect(result.proxyHeaders['third-header']).toBe('third');
+        });
+        it('should handle X-Forwarded-For with whitespace variations', () => {
+            const req = {
+                headers: {
+                    'x-forwarded-for': '10.0.0.1 , 10.0.0.2,  10.0.0.3',
+                    host: 'source.com',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const headers = processor.buildForwardedHeaders(req, 'target.com');
+            expect(headers['X-Forwarded-For']).toBe('10.0.0.1, 10.0.0.2, 10.0.0.3, 192.168.1.100');
+        });
+        it('should handle cookie transformer returning empty array', () => {
+            const req = {
+                headers: {
+                    cookie: 'session=abc123',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const result = processor.processRequestHeaders(req, 'target.com', {
+                cookies: () => [],
+            });
+            expect(result.proxyHeaders.Cookie).toBeUndefined();
+            expect(result.finalCookies).toEqual([]);
+        });
+        it('should handle header transformer removing all headers', () => {
+            const req = {
+                headers: {
+                    'content-type': 'application/json',
+                    authorization: 'Bearer token',
+                },
+                socket: {
+                    remoteAddress: '192.168.1.100',
+                },
+            };
+            const result = processor.processRequestHeaders(req, 'target.com', {
+                headers: () => ({}),
+            });
+            // Should still have forwarded headers
+            expect(result.proxyHeaders.Host).toBe('target.com');
+            expect(result.proxyHeaders['X-Forwarded-For']).toBeTruthy();
+            // But not the original headers
+            expect(result.proxyHeaders['content-type']).toBeUndefined();
+            expect(result.proxyHeaders.authorization).toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=header-processor.spec.js.map

package/esm/header-processor.spec.js.map

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

package/esm/helpers.d.ts

@@ -1,9 +1,10 @@
 import type { User } from '@furystack/core';
 import type { Injector } from '@furystack/inject';
-import { HttpAuthenticationSettings } from './http-authentication-settings.js';
 import type { RestApi } from '@furystack/rest';
 import type { ImplementApiOptions } from './api-manager.js';
+import { HttpAuthenticationSettings } from './http-authentication-settings.js';
 import type { DefaultSession } from './models/default-session.js';
+import type { ProxyOptions } from './proxy-manager.js';
 import type { StaticServerOptions } from './static-server-manager.js';
 /**
  * Sets up the @furystack/rest-service with the provided settings
@@ -31,4 +32,71 @@ export declare const useHttpAuthentication: <TUser extends User, TSession extend
 export declare const useStaticFiles: (options: {
     injector: Injector;
 } & StaticServerOptions) => Promise<void>;
+/**
+ * Sets up a proxy server that forwards HTTP requests from a source URL to a target URL.
+ *
+ * The proxy acts as an intermediary, forwarding requests and responses while allowing
+ * transformation of headers, cookies, and paths. It returns 502 Bad Gateway on errors
+ * and emits 'onProxyFailed' events for monitoring.
+ *
+ * WebSocket connections can also be proxied by setting `enableWebsockets: true`, allowing
+ * bidirectional real-time communication through the proxy.
+ *
+ * @param options The settings for the proxy server
+ * @param options.injector The Injector instance
+ * @param options.sourceBaseUrl The base URL path to match for proxying (e.g., '/api', '/old').
+ *                               Can be specified with or without a trailing slash.
+ * @param options.targetBaseUrl The target server URL (must be a valid HTTP/HTTPS URL)
+ * @param options.pathRewrite Optional function to rewrite the path before forwarding.
+ *                            Receives the path after sourceBaseUrl, including leading slash and query string.
+ *                            Example: for 'GET /api/users?active=true' with sourceBaseUrl='/api',
+ *                            pathRewrite receives '/users?active=true'
+ * @param options.sourceHostName The hostname for the source server (optional, defaults to all interfaces)
+ * @param options.sourcePort The port for the source server
+ * @param options.headers Optional function to transform request headers.
+ *                        **Note**: Receives headers AFTER filtering hop-by-hop headers
+ *                        (Connection, Keep-Alive, Transfer-Encoding, Upgrade, etc.) for security
+ *                        and protocol compliance. The proxy automatically adds X-Forwarded-* headers.
+ *                        This transformation applies to both HTTP and WebSocket requests.
+ * @param options.cookies Optional function to transform request cookies (array of cookie strings)
+ * @param options.responseCookies Optional function to transform response Set-Cookie headers
+ * @param options.timeout Optional timeout in milliseconds for proxy requests (default: 30000).
+ *                        If exceeded, the request is aborted and 502 is returned.
+ *                        Applies to both HTTP and WebSocket upgrade requests.
+ * @param options.enableWebsockets Optional flag to enable WebSocket proxying (default: false).
+ *                                 When enabled, WebSocket upgrade requests will be forwarded to the target.
+ * @returns a promise that resolves when the proxy is set up
+ * @example
+ * ```ts
+ * // Basic HTTP proxy with timeout
+ * await useProxy({
+ *   injector,
+ *   sourceBaseUrl: '/api',
+ *   targetBaseUrl: 'https://api.example.com',
+ *   sourcePort: 3000,
+ *   timeout: 5000,
+ * })
+ *
+ * // Proxy with WebSocket support
+ * await useProxy({
+ *   injector,
+ *   sourceBaseUrl: '/ws',
+ *   targetBaseUrl: 'https://ws.example.com',
+ *   sourcePort: 3000,
+ *   enableWebsockets: true,
+ * })
+ *
+ * // Proxy with error monitoring (HTTP and WebSocket)
+ * const proxyManager = injector.getInstance(ProxyManager)
+ * proxyManager.subscribe('onProxyFailed', ({ from, to, error }) => {
+ *   console.error(`HTTP Proxy failed: ${from} -> ${to}`, error)
+ * })
+ * proxyManager.subscribe('onWebSocketProxyFailed', ({ from, to, error }) => {
+ *   console.error(`WebSocket Proxy failed: ${from} -> ${to}`, error)
+ * })
+ * ```
+ */
+export declare const useProxy: (options: {
+    injector: Injector;
+} & ProxyOptions) => Promise<void>;
 //# sourceMappingURL=helpers.d.ts.map

package/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAGrE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,OAAO,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC;;;EACpB,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,IAAI,EAAE,QAAQ,SAAS,cAAc,EACvF,UAAU,QAAQ,EAClB,WAAW,OAAO,CAAC,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,SACuD,CAAA;AAExH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,mBAAmB,kBAGnF,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAGrE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,OAAO,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC;;;EACpB,CAAA;AAE/D;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,IAAI,EAAE,QAAQ,SAAS,cAAc,EACvF,UAAU,QAAQ,EAClB,WAAW,OAAO,CAAC,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,SACuD,CAAA;AAExH;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,mBAAmB,kBAGnF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,YAAY,kBAGtE,CAAA"}

package/esm/helpers.js

@@ -1,5 +1,6 @@
-import { HttpAuthenticationSettings } from './http-authentication-settings.js';
 import { ApiManager } from './api-manager.js';
+import { HttpAuthenticationSettings } from './http-authentication-settings.js';
+import { ProxyManager } from './proxy-manager.js';
 import { StaticServerManager } from './static-server-manager.js';
 /**
  * Sets up the @furystack/rest-service with the provided settings
@@ -25,4 +26,72 @@ export const useStaticFiles = (options) => {
     const { injector, ...settings } = options;
     return injector.getInstance(StaticServerManager).addStaticSite(settings);
 };
+/**
+ * Sets up a proxy server that forwards HTTP requests from a source URL to a target URL.
+ *
+ * The proxy acts as an intermediary, forwarding requests and responses while allowing
+ * transformation of headers, cookies, and paths. It returns 502 Bad Gateway on errors
+ * and emits 'onProxyFailed' events for monitoring.
+ *
+ * WebSocket connections can also be proxied by setting `enableWebsockets: true`, allowing
+ * bidirectional real-time communication through the proxy.
+ *
+ * @param options The settings for the proxy server
+ * @param options.injector The Injector instance
+ * @param options.sourceBaseUrl The base URL path to match for proxying (e.g., '/api', '/old').
+ *                               Can be specified with or without a trailing slash.
+ * @param options.targetBaseUrl The target server URL (must be a valid HTTP/HTTPS URL)
+ * @param options.pathRewrite Optional function to rewrite the path before forwarding.
+ *                            Receives the path after sourceBaseUrl, including leading slash and query string.
+ *                            Example: for 'GET /api/users?active=true' with sourceBaseUrl='/api',
+ *                            pathRewrite receives '/users?active=true'
+ * @param options.sourceHostName The hostname for the source server (optional, defaults to all interfaces)
+ * @param options.sourcePort The port for the source server
+ * @param options.headers Optional function to transform request headers.
+ *                        **Note**: Receives headers AFTER filtering hop-by-hop headers
+ *                        (Connection, Keep-Alive, Transfer-Encoding, Upgrade, etc.) for security
+ *                        and protocol compliance. The proxy automatically adds X-Forwarded-* headers.
+ *                        This transformation applies to both HTTP and WebSocket requests.
+ * @param options.cookies Optional function to transform request cookies (array of cookie strings)
+ * @param options.responseCookies Optional function to transform response Set-Cookie headers
+ * @param options.timeout Optional timeout in milliseconds for proxy requests (default: 30000).
+ *                        If exceeded, the request is aborted and 502 is returned.
+ *                        Applies to both HTTP and WebSocket upgrade requests.
+ * @param options.enableWebsockets Optional flag to enable WebSocket proxying (default: false).
+ *                                 When enabled, WebSocket upgrade requests will be forwarded to the target.
+ * @returns a promise that resolves when the proxy is set up
+ * @example
+ * ```ts
+ * // Basic HTTP proxy with timeout
+ * await useProxy({
+ *   injector,
+ *   sourceBaseUrl: '/api',
+ *   targetBaseUrl: 'https://api.example.com',
+ *   sourcePort: 3000,
+ *   timeout: 5000,
+ * })
+ *
+ * // Proxy with WebSocket support
+ * await useProxy({
+ *   injector,
+ *   sourceBaseUrl: '/ws',
+ *   targetBaseUrl: 'https://ws.example.com',
+ *   sourcePort: 3000,
+ *   enableWebsockets: true,
+ * })
+ *
+ * // Proxy with error monitoring (HTTP and WebSocket)
+ * const proxyManager = injector.getInstance(ProxyManager)
+ * proxyManager.subscribe('onProxyFailed', ({ from, to, error }) => {
+ *   console.error(`HTTP Proxy failed: ${from} -> ${to}`, error)
+ * })
+ * proxyManager.subscribe('onWebSocketProxyFailed', ({ from, to, error }) => {
+ *   console.error(`WebSocket Proxy failed: ${from} -> ${to}`, error)
+ * })
+ * ```
+ */
+export const useProxy = (options) => {
+    const { injector, ...settings } = options;
+    return injector.getInstance(ProxyManager).addProxy(settings);
+};
 //# sourceMappingURL=helpers.js.map

package/esm/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAG9E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAqB,GAA2B,EAAE,EAAE,CACrF,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAkB,EAClB,QAA+D,EAC/D,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,0BAA0B,EAAE,EAAE,QAAQ,CAAC,EAAE,0BAA0B,CAAC,CAAA;AAExH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAqD,EAAE,EAAE;IACtF,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAA;IACzC,OAAO,QAAQ,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;AAC1E,CAAC,CAAA"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAEhE;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAqB,GAA2B,EAAE,EAAE,CACrF,MAAM,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,CAAA;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,QAAkB,EAClB,QAA+D,EAC/D,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,0BAA0B,EAAE,EAAE,QAAQ,CAAC,EAAE,0BAA0B,CAAC,CAAA;AAExH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAqD,EAAE,EAAE;IACtF,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAA;IACzC,OAAO,QAAQ,CAAC,WAAW,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAA;AAC1E,CAAC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,OAA8C,EAAE,EAAE;IACzE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAA;IACzC,OAAO,QAAQ,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC9D,CAAC,CAAA"}