@relayplane/proxy 1.2.0 → 1.3.0

package/dist/middleware.js

@@ -0,0 +1,254 @@
+"use strict";
+/**
+ * RelayPlane Proxy Middleware
+ *
+ * Wraps provider requests: tries proxy first (when circuit is healthy),
+ * falls back to direct on failure. This is the key integration point.
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RelayPlaneMiddleware = void 0;
+const http = __importStar(require("node:http"));
+const circuit_breaker_js_1 = require("./circuit-breaker.js");
+const health_js_1 = require("./health.js");
+const relay_config_js_1 = require("./relay-config.js");
+const process_manager_js_1 = require("./process-manager.js");
+const stats_js_1 = require("./stats.js");
+const status_js_1 = require("./status.js");
+const logger_js_1 = require("./logger.js");
+class RelayPlaneMiddleware {
+    circuitBreaker;
+    stats;
+    statusReporter;
+    proxyUrl;
+    enabled;
+    autoStart;
+    logger;
+    probeInterval = null;
+    processManager = null;
+    constructor(configOrOpts) {
+        let config;
+        let pm;
+        let pmOpts;
+        let logger;
+        if (configOrOpts && 'config' in configOrOpts) {
+            const opts = configOrOpts;
+            config = opts.config;
+            pm = opts.processManager;
+            pmOpts = opts.processManagerOptions;
+            logger = opts.logger;
+        }
+        else {
+            config = configOrOpts;
+        }
+        const resolved = (0, relay_config_js_1.resolveConfig)(config);
+        this.enabled = resolved.enabled;
+        this.proxyUrl = resolved.proxyUrl;
+        this.autoStart = resolved.autoStart;
+        this.logger = logger ?? logger_js_1.defaultLogger;
+        this.circuitBreaker = new circuit_breaker_js_1.CircuitBreaker(resolved.circuitBreaker);
+        this.stats = new stats_js_1.StatsCollector();
+        // Set up process manager
+        if (pm) {
+            this.processManager = pm;
+        }
+        else if (this.autoStart && this.enabled) {
+            this.processManager = new process_manager_js_1.ProcessManager({
+                ...pmOpts,
+                circuitBreaker: this.circuitBreaker,
+            });
+        }
+        // Status reporter
+        this.statusReporter = new status_js_1.StatusReporter({
+            enabled: this.enabled,
+            proxyUrl: this.proxyUrl,
+            circuitBreaker: this.circuitBreaker,
+            statsCollector: this.stats,
+            processManager: this.processManager,
+        });
+        // Wire circuit breaker state changes → stats + logging + probing
+        this.circuitBreaker.on('stateChange', ({ from, to }) => {
+            this.stats.recordStateTransition(from, to);
+            if (to === 'OPEN') {
+                this.logger.error(`Circuit breaker tripped OPEN (was ${from})`);
+                this.startProbing();
+            }
+            else if (to === 'CLOSED') {
+                this.logger.info(`Circuit breaker recovered: ${from} → CLOSED`);
+                this.stopProbing();
+            }
+            else {
+                this.stopProbing();
+            }
+        });
+        // Wire process manager events
+        if (this.processManager) {
+            this.processManager.on('crash', ({ code, signal }) => {
+                this.statusReporter.incrementRestarts();
+                this.statusReporter.setLastError(`Process crashed (code=${code}, signal=${signal})`);
+            });
+            this.processManager.on('error', (err) => {
+                this.statusReporter.setLastError(err.message);
+            });
+        }
+        // Auto-start
+        if (this.processManager && this.autoStart && this.enabled) {
+            this.processManager.start();
+        }
+    }
+    getProcessManager() {
+        return this.processManager;
+    }
+    getStatus() {
+        return this.statusReporter.getStatus();
+    }
+    formatStatus() {
+        return this.statusReporter.formatStatus();
+    }
+    /**
+     * Route a request: proxy if healthy, direct otherwise.
+     */
+    async route(req, directSend) {
+        if (!this.enabled || !this.circuitBreaker.isHealthy()) {
+            const reason = !this.enabled ? 'proxy disabled' : 'circuit breaker OPEN';
+            this.logger.warn(`Falling back to direct: ${reason}`);
+            const start = Date.now();
+            const resp = await directSend(req);
+            this.stats.recordRequest({
+                timestamp: start,
+                latencyMs: Date.now() - start,
+                viaProxy: false,
+                success: resp.status < 500,
+            });
+            return resp;
+        }
+        const start = Date.now();
+        try {
+            const resp = await this.sendViaProxy(req);
+            this.circuitBreaker.recordSuccess();
+            this.stats.recordRequest({
+                timestamp: start,
+                latencyMs: Date.now() - start,
+                viaProxy: true,
+                success: true,
+            });
+            return resp;
+        }
+        catch (err) {
+            this.circuitBreaker.recordFailure();
+            const errMsg = err instanceof Error ? err.message : String(err);
+            this.logger.warn(`Falling back to direct: proxy error (${errMsg})`);
+            this.statusReporter.setLastError(errMsg);
+            const directStart = Date.now();
+            const resp = await directSend(req);
+            this.stats.recordRequest({
+                timestamp: start,
+                latencyMs: Date.now() - start,
+                viaProxy: false,
+                success: resp.status < 500,
+            });
+            return resp;
+        }
+    }
+    sendViaProxy(req) {
+        const url = new URL(req.path, this.proxyUrl);
+        const timeoutMs = this.circuitBreaker.requestTimeoutMs;
+        return new Promise((resolve, reject) => {
+            const proxyReq = http.request(url, {
+                method: req.method,
+                headers: req.headers,
+                timeout: timeoutMs,
+            }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    if (res.statusCode && res.statusCode >= 500) {
+                        reject(new Error(`Proxy returned ${res.statusCode}`));
+                        return;
+                    }
+                    const headers = {};
+                    for (const [k, v] of Object.entries(res.headers)) {
+                        if (typeof v === 'string')
+                            headers[k] = v;
+                    }
+                    resolve({ status: res.statusCode ?? 200, headers, body: data, viaProxy: true });
+                });
+            });
+            proxyReq.on('error', reject);
+            proxyReq.on('timeout', () => {
+                proxyReq.destroy();
+                reject(new Error('Proxy request timeout'));
+            });
+            if (req.body)
+                proxyReq.write(req.body);
+            proxyReq.end();
+        });
+    }
+    startProbing() {
+        this.stopProbing();
+        this.probeInterval = setInterval(async () => {
+            if (this.circuitBreaker.getState() !== 'OPEN') {
+                this.stopProbing();
+                return;
+            }
+            const ok = await (0, health_js_1.probeHealth)(this.proxyUrl);
+            if (ok) {
+                this.logger.info('Health probe succeeded, transitioning to HALF-OPEN');
+                this.circuitBreaker.recordSuccess();
+            }
+        }, 15_000);
+        if (this.probeInterval && typeof this.probeInterval === 'object' && 'unref' in this.probeInterval) {
+            this.probeInterval.unref();
+        }
+    }
+    stopProbing() {
+        if (this.probeInterval) {
+            clearInterval(this.probeInterval);
+            this.probeInterval = null;
+        }
+    }
+    destroy() {
+        this.stopProbing();
+        if (this.processManager) {
+            this.processManager.destroy();
+            this.processManager = null;
+        }
+        this.circuitBreaker.destroy();
+    }
+}
+exports.RelayPlaneMiddleware = RelayPlaneMiddleware;
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

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

package/dist/process-manager.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Process Manager for RelayPlane Proxy
+ *
+ * Spawns the proxy as a child process, monitors health,
+ * handles crashes with exponential backoff restarts.
+ *
+ * @packageDocumentation
+ */
+import { EventEmitter } from 'node:events';
+import { type CircuitBreaker } from './circuit-breaker.js';
+export interface ProcessManagerOptions {
+    /** Command to spawn (default: process.execPath) */
+    command?: string;
+    /** Arguments for the command (default: launcher path) */
+    args?: string[];
+    /** Environment variables for the child process */
+    env?: Record<string, string>;
+    /** Initial restart delay in ms (default: 60000) */
+    restartDelayMs?: number;
+    /** Max restart delay in ms (default: 300000 = 5 min) */
+    maxRestartDelayMs?: number;
+    /** Max restart attempts within the window (default: 5) */
+    maxRestartAttempts?: number;
+    /** Window for counting restart attempts in ms (default: 600000 = 10 min) */
+    restartWindowMs?: number;
+    /** Circuit breaker instance to mark OPEN on crash */
+    circuitBreaker?: CircuitBreaker;
+}
+export declare class ProcessManager extends EventEmitter {
+    private child;
+    private readonly command;
+    private readonly args;
+    private readonly env;
+    private readonly restartDelayMs;
+    private readonly maxRestartDelayMs;
+    private readonly maxRestartAttempts;
+    private readonly restartWindowMs;
+    private readonly circuitBreaker?;
+    private restartTimestamps;
+    private currentDelay;
+    private restartTimer;
+    private stopping;
+    private started;
+    constructor(opts?: ProcessManagerOptions);
+    /** Start the proxy child process. */
+    start(): void;
+    /** Stop the proxy child process. */
+    stop(): void;
+    /** Restart the proxy (stop then start). */
+    restart(): void;
+    /** Whether the child process is currently running. */
+    isRunning(): boolean;
+    /** Get the PID of the child process, or null if not running. */
+    getPid(): number | null;
+    /** Clean up resources. */
+    destroy(): void;
+    private spawnChild;
+    private scheduleRestart;
+    private clearRestartTimer;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../src/process-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,kDAAkD;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAyB;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAiB;IAEjD,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;gBAEZ,IAAI,GAAE,qBAA0B;IAa5C,qCAAqC;IACrC,KAAK,IAAI,IAAI;IAOb,oCAAoC;IACpC,IAAI,IAAI,IAAI;IAYZ,2CAA2C;IAC3C,OAAO,IAAI,IAAI;IAKf,sDAAsD;IACtD,SAAS,IAAI,OAAO;IAIpB,gEAAgE;IAChE,MAAM,IAAI,MAAM,GAAG,IAAI;IAIvB,0BAA0B;IAC1B,OAAO,IAAI,IAAI;IAKf,OAAO,CAAC,UAAU;IA4DlB,OAAO,CAAC,eAAe;IAmCvB,OAAO,CAAC,iBAAiB;CAQ1B"}

package/dist/process-manager.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Process Manager for RelayPlane Proxy
+ *
+ * Spawns the proxy as a child process, monitors health,
+ * handles crashes with exponential backoff restarts.
+ *
+ * @packageDocumentation
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProcessManager = void 0;
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+const node_events_1 = require("node:events");
+class ProcessManager extends node_events_1.EventEmitter {
+    child = null;
+    command;
+    args;
+    env;
+    restartDelayMs;
+    maxRestartDelayMs;
+    maxRestartAttempts;
+    restartWindowMs;
+    circuitBreaker;
+    restartTimestamps = [];
+    currentDelay;
+    restartTimer = null;
+    stopping = false;
+    started = false;
+    constructor(opts = {}) {
+        super();
+        this.command = opts.command ?? process.execPath;
+        this.args = opts.args ?? [node_path_1.default.join(__dirname, 'launcher.js')];
+        this.env = opts.env ?? {};
+        this.restartDelayMs = opts.restartDelayMs ?? 60_000;
+        this.maxRestartDelayMs = opts.maxRestartDelayMs ?? 300_000;
+        this.maxRestartAttempts = opts.maxRestartAttempts ?? 5;
+        this.restartWindowMs = opts.restartWindowMs ?? 600_000;
+        this.circuitBreaker = opts.circuitBreaker;
+        this.currentDelay = this.restartDelayMs;
+    }
+    /** Start the proxy child process. */
+    start() {
+        if (this.child)
+            return;
+        this.stopping = false;
+        this.started = true;
+        this.spawnChild();
+    }
+    /** Stop the proxy child process. */
+    stop() {
+        this.stopping = true;
+        this.started = false;
+        this.clearRestartTimer();
+        if (this.child) {
+            this.child.removeAllListeners();
+            this.child.kill('SIGTERM');
+            this.child = null;
+        }
+        this.emit('stopped');
+    }
+    /** Restart the proxy (stop then start). */
+    restart() {
+        this.stop();
+        this.start();
+    }
+    /** Whether the child process is currently running. */
+    isRunning() {
+        return this.child !== null && this.child.exitCode === null && !this.child.killed;
+    }
+    /** Get the PID of the child process, or null if not running. */
+    getPid() {
+        return this.child?.pid ?? null;
+    }
+    /** Clean up resources. */
+    destroy() {
+        this.stop();
+        this.removeAllListeners();
+    }
+    spawnChild() {
+        try {
+            const child = (0, node_child_process_1.spawn)(this.command, this.args, {
+                stdio: ['ignore', 'pipe', 'pipe'],
+                env: { ...process.env, ...this.env },
+            });
+            // Handle spawn error (command not found, etc.)
+            child.on('error', (err) => {
+                console.error(`[relayplane] Failed to spawn proxy: ${err.message}`);
+                this.child = null;
+                this.circuitBreaker?.recordFailure();
+                this.emit('error', err);
+                if (!this.stopping) {
+                    this.scheduleRestart();
+                }
+            });
+            // Pipe stdout with prefix
+            child.stdout?.on('data', (chunk) => {
+                const lines = chunk.toString().split('\n').filter(Boolean);
+                for (const line of lines) {
+                    console.log(`[relayplane] ${line}`);
+                }
+            });
+            // Pipe stderr with prefix
+            child.stderr?.on('data', (chunk) => {
+                const lines = chunk.toString().split('\n').filter(Boolean);
+                for (const line of lines) {
+                    console.error(`[relayplane] ${line}`);
+                }
+            });
+            // Handle exit
+            child.on('exit', (code, signal) => {
+                this.child = null;
+                if (this.stopping)
+                    return;
+                console.error(`[relayplane] Proxy exited (code=${code}, signal=${signal})`);
+                // Mark circuit breaker OPEN on crash
+                this.circuitBreaker?.recordFailure();
+                this.emit('crash', { code, signal });
+                this.scheduleRestart();
+            });
+            this.child = child;
+            this.emit('started', { pid: child.pid });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            console.error(`[relayplane] Failed to spawn proxy: ${error.message}`);
+            this.child = null;
+            this.circuitBreaker?.recordFailure();
+            this.emit('error', error);
+            if (!this.stopping) {
+                this.scheduleRestart();
+            }
+        }
+    }
+    scheduleRestart() {
+        if (this.stopping)
+            return;
+        const now = Date.now();
+        // Prune old timestamps outside the window
+        this.restartTimestamps = this.restartTimestamps.filter((t) => now - t < this.restartWindowMs);
+        if (this.restartTimestamps.length >= this.maxRestartAttempts) {
+            console.error(`[relayplane] Max restart attempts (${this.maxRestartAttempts}) reached within ${this.restartWindowMs / 1000}s window. Giving up.`);
+            this.emit('maxRestartsExceeded');
+            return;
+        }
+        this.restartTimestamps.push(now);
+        console.log(`[relayplane] Scheduling restart in ${this.currentDelay / 1000}s`);
+        this.restartTimer = setTimeout(() => {
+            this.restartTimer = null;
+            if (!this.stopping) {
+                this.spawnChild();
+            }
+        }, this.currentDelay);
+        if (this.restartTimer && typeof this.restartTimer === 'object' && 'unref' in this.restartTimer) {
+            this.restartTimer.unref();
+        }
+        // Exponential backoff
+        this.currentDelay = Math.min(this.currentDelay * 2, this.maxRestartDelayMs);
+    }
+    clearRestartTimer() {
+        if (this.restartTimer) {
+            clearTimeout(this.restartTimer);
+            this.restartTimer = null;
+        }
+        // Reset backoff on manual stop/restart
+        this.currentDelay = this.restartDelayMs;
+    }
+}
+exports.ProcessManager = ProcessManager;
+//# sourceMappingURL=process-manager.js.map

package/dist/process-manager.js.map

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

package/dist/relay-config.d.ts

@@ -0,0 +1,19 @@
+/**
+ * RelayPlane integration configuration types.
+ * @packageDocumentation
+ */
+export interface RelayPlaneConfig {
+    enabled: boolean;
+    /** Proxy URL (default: http://127.0.0.1:4100) */
+    proxyUrl?: string;
+    circuitBreaker?: {
+        failureThreshold?: number;
+        resetTimeoutMs?: number;
+        requestTimeoutMs?: number;
+    };
+    /** Auto-start proxy process (Phase 2, default: true) */
+    autoStart?: boolean;
+}
+export declare const DEFAULT_RELAY_CONFIG: Required<RelayPlaneConfig>;
+export declare function resolveConfig(partial?: Partial<RelayPlaneConfig>): Required<RelayPlaneConfig>;
+//# sourceMappingURL=relay-config.d.ts.map

package/dist/relay-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-config.d.ts","sourceRoot":"","sources":["../src/relay-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,gBAAgB,CAS3D,CAAC;AAEF,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,QAAQ,CAAC,gBAAgB,CAAC,CAW7F"}

package/dist/relay-config.js

@@ -0,0 +1,32 @@
+"use strict";
+/**
+ * RelayPlane integration configuration types.
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RELAY_CONFIG = void 0;
+exports.resolveConfig = resolveConfig;
+exports.DEFAULT_RELAY_CONFIG = {
+    enabled: false,
+    proxyUrl: 'http://127.0.0.1:4100',
+    circuitBreaker: {
+        failureThreshold: 3,
+        resetTimeoutMs: 30_000,
+        requestTimeoutMs: 3_000,
+    },
+    autoStart: true,
+};
+function resolveConfig(partial) {
+    if (!partial)
+        return { ...exports.DEFAULT_RELAY_CONFIG };
+    return {
+        enabled: partial.enabled ?? exports.DEFAULT_RELAY_CONFIG.enabled,
+        proxyUrl: partial.proxyUrl ?? exports.DEFAULT_RELAY_CONFIG.proxyUrl,
+        circuitBreaker: {
+            ...exports.DEFAULT_RELAY_CONFIG.circuitBreaker,
+            ...partial.circuitBreaker,
+        },
+        autoStart: partial.autoStart ?? exports.DEFAULT_RELAY_CONFIG.autoStart,
+    };
+}
+//# sourceMappingURL=relay-config.js.map

package/dist/relay-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-config.js","sourceRoot":"","sources":["../src/relay-config.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA0BH,sCAWC;AAtBY,QAAA,oBAAoB,GAA+B;IAC9D,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE,uBAAuB;IACjC,cAAc,EAAE;QACd,gBAAgB,EAAE,CAAC;QACnB,cAAc,EAAE,MAAM;QACtB,gBAAgB,EAAE,KAAK;KACxB;IACD,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,SAAgB,aAAa,CAAC,OAAmC;IAC/D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,GAAG,4BAAoB,EAAE,CAAC;IACjD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,4BAAoB,CAAC,OAAO;QACxD,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,4BAAoB,CAAC,QAAQ;QAC3D,cAAc,EAAE;YACd,GAAG,4BAAoB,CAAC,cAAc;YACtC,GAAG,OAAO,CAAC,cAAc;SAC1B;QACD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,4BAAoB,CAAC,SAAS;KAC/D,CAAC;AACJ,CAAC"}

package/dist/standalone-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standalone-proxy.d.ts","sourceRoot":"","sources":["../src/standalone-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,kBAAkB,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAqB9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQ/E,CAAC;AA+BF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAWjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAkBD,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B;AAcD,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,cAAc,EAAE,MAAM,CAAC;CACxB;AAmBD,KAAK,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AA6EpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAChD;AAqOD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe3D;AAuDD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,UAAU,CAiBrF;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAIlG;AAs0CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAk7B/E"}
+{"version":3,"file":"standalone-proxy.d.ts","sourceRoot":"","sources":["../src/standalone-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,kBAAkB,CAAC;AAI3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAqB9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQ/E,CAAC;AAiCF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAWjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAkBD,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B;AAcD,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,cAAc,EAAE,MAAM,CAAC;CACxB;AAmBD,KAAK,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AA6EpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAChD;AAqOD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe3D;AAuDD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,UAAU,CAiBrF;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAIlG;AAo1CD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAk9B/E"}