threadforge 0.1.1 → 0.2.1

package/dist/core/EndpointResolver.js

@@ -0,0 +1,336 @@
+/**
+ * EndpointResolver
+ *
+ * Resolves service names to { host, port, remote } endpoints.
+ * Supports:
+ *   - Single endpoints (one instance per service)
+ *   - Multi-instance arrays (round-robin selection)
+ *   - Dynamic updates via set/remove (used by ServiceRegistry)
+ *   - Fallback from FORGE_SERVICE_ENDPOINTS to FORGE_SERVICE_PORTS
+ *   - C3: File fallback via FORGE_SERVICE_ENDPOINTS_FILE for large maps
+ */
+import { readFileSync } from "node:fs";
+/** Validate that an endpoint has the expected shape */
+function validateEndpoint(ep) {
+    if (!ep || typeof ep !== "object")
+        return false;
+    const obj = ep;
+    if (typeof obj.host !== "string" || !obj.host)
+        return false;
+    if (obj.port !== undefined && (typeof obj.port !== "number" || obj.port < 1 || obj.port > 65535))
+        return false;
+    return true;
+}
+export class EndpointResolver {
+    _endpoints;
+    _counters;
+    _strategies;
+    // P-10: Cache wrapped endpoint entries to avoid per-resolve() allocation
+    _wrappedCache;
+    // REG-H2/M1: Health status per endpoint (key: "host:port")
+    _healthStatus;
+    // REG-M2: Consecutive failure counts per endpoint for passive health checking
+    _failureCounts;
+    // REG-M2: Configurable threshold for marking endpoint unhealthy
+    _failureThreshold;
+    constructor() {
+        this._endpoints = new Map();
+        this._counters = new Map();
+        this._strategies = new Map();
+        this._wrappedCache = new Map();
+        this._healthStatus = new Map();
+        this._failureCounts = new Map();
+        this._failureThreshold = 3;
+    }
+    /**
+     * Set a routing strategy for a specific service.
+     * When set, resolve() delegates to the strategy's pick() method
+     * instead of using built-in round-robin.
+     *
+     * The strategy must implement pick(entries, callContext) where entries
+     * are wrapped as { key: "host:port", host, port, remote }.
+     */
+    setStrategy(serviceName, strategy) {
+        if (!strategy || typeof strategy.pick !== "function") {
+            throw new Error(`Strategy for "${serviceName}" must have a pick() method`);
+        }
+        this._strategies.set(serviceName, strategy);
+    }
+    /**
+     * Create an EndpointResolver from environment variables.
+     *
+     * Parses FORGE_SERVICE_ENDPOINTS first (full endpoint map with host/port/remote).
+     * Falls back to FORGE_SERVICE_PORTS (localhost-only port map) when endpoints
+     * aren't available.
+     */
+    static fromEnv() {
+        const resolver = new EndpointResolver();
+        // C3: Support file fallback for large endpoint maps (written by Supervisor)
+        let endpointsJson = process.env.FORGE_SERVICE_ENDPOINTS;
+        if (!endpointsJson && process.env.FORGE_SERVICE_ENDPOINTS_FILE) {
+            try {
+                endpointsJson = readFileSync(process.env.FORGE_SERVICE_ENDPOINTS_FILE, "utf8");
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error("[EndpointResolver] Failed to read FORGE_SERVICE_ENDPOINTS_FILE:", msg);
+            }
+        }
+        if (endpointsJson) {
+            try {
+                const parsed = JSON.parse(endpointsJson);
+                for (const [name, value] of Object.entries(parsed)) {
+                    if (Array.isArray(value)) {
+                        const valid = value.filter((ep) => validateEndpoint(ep));
+                        if (valid.length > 0)
+                            resolver._endpoints.set(name, valid);
+                    }
+                    else if (validateEndpoint(value)) {
+                        resolver._endpoints.set(name, [value]);
+                    }
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error("[EndpointResolver] Failed to parse FORGE_SERVICE_ENDPOINTS:", msg);
+            }
+        }
+        // Merge FORGE_SERVICE_PORTS as fallback for any services not in endpoints
+        const portsJson = process.env.FORGE_SERVICE_PORTS;
+        if (portsJson) {
+            try {
+                const ports = JSON.parse(portsJson);
+                for (const [name, port] of Object.entries(ports)) {
+                    const p = Number(port);
+                    if (!resolver._endpoints.has(name) && Number.isInteger(p) && p >= 1 && p <= 65535) {
+                        resolver._endpoints.set(name, [{ host: "127.0.0.1", port: p, remote: false }]);
+                    }
+                }
+            }
+            catch (e) {
+                const msg = e instanceof Error ? e.message : String(e);
+                console.error("[EndpointResolver] Failed to parse FORGE_SERVICE_PORTS:", msg);
+            }
+        }
+        return resolver;
+    }
+    /**
+     * Resolve an endpoint for a service.
+     * Delegates to a configured RoutingStrategy when available,
+     * otherwise round-robins across instances.
+     */
+    resolve(serviceName, callContext) {
+        const endpoints = this._endpoints.get(serviceName);
+        if (!endpoints || endpoints.length === 0)
+            return null;
+        // REG-H2: Filter out unhealthy/draining endpoints if health data is available
+        const healthy = this._healthStatus.size > 0
+            ? endpoints.filter(ep => {
+                const key = `${ep.host}:${ep.port}`;
+                const status = this._healthStatus.get(key);
+                return !status || (status !== 'unhealthy' && status !== 'draining');
+            })
+            : endpoints;
+        // Fall back to all endpoints if all are unhealthy (avoid total blackout)
+        const available = healthy.length > 0 ? healthy : endpoints;
+        if (available.length === 1)
+            return available[0];
+        // Delegate to configured strategy if present
+        const strategy = this._strategies.get(serviceName);
+        if (strategy) {
+            // P-10: Use cached wrapped entries to avoid per-call allocation
+            // REG-H2: Invalidate cache when health filtering changes the available set
+            let entries = this._wrappedCache.get(serviceName);
+            if (!entries || entries.length !== available.length) {
+                entries = available.map((ep) => ({
+                    key: `${ep.host}:${ep.port}`,
+                    host: ep.host,
+                    port: ep.port,
+                    remote: ep.remote,
+                }));
+                this._wrappedCache.set(serviceName, entries);
+            }
+            const picked = strategy.pick(entries, callContext);
+            if (picked) {
+                // Handle broadcast (returns array) — return all endpoints for fan-out
+                if (Array.isArray(picked)) {
+                    return picked.map((p) => ({ host: p.host, port: p.port, remote: p.remote }));
+                }
+                return { host: picked.host, port: picked.port, remote: picked.remote };
+            }
+            // Strategy returned null — fall through to round-robin
+        }
+        // Round-robin: read-then-write is atomic in single-threaded Node.js
+        // (no microtask or I/O can interleave between get and set)
+        const idx = this._counters.get(serviceName) ?? 0;
+        this._counters.set(serviceName, (idx + 1) % 1_000_000_000);
+        const endpoint = available[idx % available.length];
+        return endpoint;
+    }
+    /**
+     * Get all endpoints for a service (used for broadcast/event delivery).
+     */
+    all(serviceName) {
+        return (this._endpoints.get(serviceName) ?? []).map((e) => ({ ...e }));
+    }
+    /**
+     * Add or update an endpoint for a service.
+     * Used by dynamic registry discovery.
+     */
+    set(serviceName, endpoint) {
+        if (endpoint.port !== undefined &&
+            (!Number.isInteger(endpoint.port) || endpoint.port < 1 || endpoint.port > 65535)) {
+            throw new Error(`Invalid port for service "${serviceName}": ${endpoint.port}`);
+        }
+        const ep = { remote: true, ...endpoint };
+        const existing = this._endpoints.get(serviceName) ?? [];
+        // Replace if same host:port exists, otherwise append
+        const idx = existing.findIndex((e) => e.host === ep.host && e.port === ep.port);
+        if (idx !== -1) {
+            existing[idx] = ep;
+        }
+        else {
+            existing.push(ep);
+        }
+        this._endpoints.set(serviceName, existing);
+        // P-10: Invalidate wrapped cache when endpoints change
+        this._wrappedCache.delete(serviceName);
+    }
+    /**
+     * Remove a specific instance of a service.
+     * Used when a remote node goes down.
+     */
+    remove(serviceName, host, port) {
+        const existing = this._endpoints.get(serviceName);
+        if (!existing)
+            return;
+        const filtered = existing.filter((e) => !(e.host === host && e.port === port));
+        // P-10: Invalidate wrapped cache when endpoints change
+        this._wrappedCache.delete(serviceName);
+        if (filtered.length === 0) {
+            this._endpoints.delete(serviceName);
+            // CR-IPC-7: Clean up counter when all endpoints removed
+            this._counters.delete(serviceName);
+        }
+        else {
+            this._endpoints.set(serviceName, filtered);
+            // Let counter naturally wrap via modulo in resolve()
+        }
+    }
+    /**
+     * COR-C1: Acquire a pending slot for a resolved endpoint.
+     * Delegates to the service's routing strategy if it supports acquire().
+     * Must be paired with releaseEndpoint() in a finally block.
+     */
+    acquireEndpoint(serviceName, endpointKey) {
+        const strategy = this._strategies.get(serviceName);
+        if (strategy && typeof strategy.acquire === "function") {
+            strategy.acquire(endpointKey);
+        }
+    }
+    /**
+     * COR-C1: Release a pending slot for a resolved endpoint.
+     * Delegates to the service's routing strategy if it supports release().
+     */
+    releaseEndpoint(serviceName, endpointKey) {
+        const strategy = this._strategies.get(serviceName);
+        if (strategy && typeof strategy.release === "function") {
+            strategy.release(endpointKey);
+        }
+    }
+    /**
+     * REG-H2: Update health status for a specific endpoint.
+     * Called when the Supervisor pushes health updates or on connection failure feedback.
+     */
+    setHealthStatus(host, port, status) {
+        const key = `${host}:${port}`;
+        if (status === 'healthy') {
+            this._healthStatus.delete(key);
+        }
+        else {
+            this._healthStatus.set(key, status);
+        }
+        // Invalidate wrapped caches since health filtering may change available set
+        this._wrappedCache.clear();
+    }
+    /**
+     * REG-H2: Get the health status of a specific endpoint.
+     */
+    getHealthStatus(host, port) {
+        return this._healthStatus.get(`${host}:${port}`) ?? 'healthy';
+    }
+    /**
+     * REG-M2: Record a connection failure for an endpoint.
+     * After _failureThreshold consecutive failures, the endpoint is marked unhealthy.
+     * Returns the current consecutive failure count.
+     */
+    recordFailure(host, port) {
+        const key = `${host}:${port}`;
+        const count = (this._failureCounts.get(key) ?? 0) + 1;
+        this._failureCounts.set(key, count);
+        if (count >= this._failureThreshold) {
+            this.setHealthStatus(host, port, 'unhealthy');
+        }
+        return count;
+    }
+    /**
+     * REG-M2: Record a successful connection to an endpoint.
+     * Resets the consecutive failure counter and marks the endpoint healthy.
+     */
+    recordSuccess(host, port) {
+        const key = `${host}:${port}`;
+        if (this._failureCounts.has(key)) {
+            this._failureCounts.delete(key);
+            const status = this._healthStatus.get(key);
+            if (status === 'unhealthy') {
+                this.setHealthStatus(host, port, 'healthy');
+            }
+        }
+    }
+    /**
+     * Check if a service has any known endpoints.
+     */
+    has(serviceName) {
+        const eps = this._endpoints.get(serviceName);
+        return eps != null && eps.length > 0;
+    }
+    /**
+     * REG-H1: Apply a full endpoint map update (pushed from Supervisor).
+     * Merges new/updated endpoints and removes stale ones not present in the update.
+     * Only updates remote endpoints to avoid overwriting local colocated/UDS entries.
+     */
+    applyEndpointUpdate(endpointMap) {
+        if (!endpointMap || typeof endpointMap !== 'object')
+            return;
+        for (const [name, value] of Object.entries(endpointMap)) {
+            if (Array.isArray(value)) {
+                const valid = value.filter((ep) => validateEndpoint(ep));
+                if (valid.length > 0) {
+                    // Merge: replace remote entries, keep local ones
+                    const existing = this._endpoints.get(name) ?? [];
+                    const localEntries = existing.filter(e => !e.remote);
+                    const merged = [...localEntries, ...valid.filter(e => e.remote)];
+                    if (merged.length > 0) {
+                        this._endpoints.set(name, merged);
+                        this._wrappedCache.delete(name);
+                    }
+                }
+            }
+            else if (validateEndpoint(value)) {
+                const ep = value;
+                if (ep.remote) {
+                    const existing = this._endpoints.get(name) ?? [];
+                    const localEntries = existing.filter(e => !e.remote);
+                    this._endpoints.set(name, [...localEntries, ep]);
+                    this._wrappedCache.delete(name);
+                }
+                else if (!this._endpoints.has(name)) {
+                    // Only set non-remote if no existing entry
+                    this._endpoints.set(name, [ep]);
+                    this._wrappedCache.delete(name);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=EndpointResolver.js.map

package/dist/core/EndpointResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointResolver.js","sourceRoot":"","sources":["../../src/core/EndpointResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA2BvC,uDAAuD;AACvD,SAAS,gBAAgB,CAAC,EAAW;IACnC,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,GAAG,GAAG,EAA6B,CAAC;IAC1C,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/G,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,OAAO,gBAAgB;IACnB,UAAU,CAA0B;IACpC,SAAS,CAAsB;IAC/B,WAAW,CAA+B;IAClD,yEAAyE;IACjE,aAAa,CAA8B;IACnD,2DAA2D;IACnD,aAAa,CAAiE;IACtF,8EAA8E;IACtE,cAAc,CAAsB;IAC5C,gEAAgE;IACxD,iBAAiB,CAAS;IAElC;QACE,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,EAAE,CAAC;QAChC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,WAAW,CAAC,WAAmB,EAAE,QAAyB;QACxD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,iBAAiB,WAAW,6BAA6B,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,OAAO;QACZ,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;QAExC,4EAA4E;QAC5E,IAAI,aAAa,GAAuB,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC5E,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,CAAC;YAC/D,IAAI,CAAC;gBACH,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;YACjF,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,KAAK,CAAC,iEAAiE,EAAE,GAAG,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,MAAM,GAA4B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAClE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBACnD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAe,CAAC;wBAChF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;4BAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;oBAC7D,CAAC;yBAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;wBACnC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;oBACzC,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,KAAK,CAAC,6DAA6D,EAAE,GAAG,CAAC,CAAC;YACpF,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,MAAM,SAAS,GAAuB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QACtE,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,MAAM,KAAK,GAA4B,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAC7D,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACjD,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;oBACvB,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;wBAClF,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;oBACjF,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,CAAU,EAAE,CAAC;gBACpB,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,KAAK,CAAC,yDAAyD,EAAE,GAAG,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,WAAmB,EAAE,WAAqB;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEtD,8EAA8E;QAC9E,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC;YACzC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;gBACpB,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3C,OAAO,CAAC,MAAM,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,UAAU,CAAC,CAAC;YACtE,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAC;QAEd,yEAAyE;QACzE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QAE3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;QAEhD,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,QAAQ,EAAE,CAAC;YACb,gEAAgE;YAChE,2EAA2E;YAC3E,IAAI,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;gBACpD,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC/B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,EAAE;oBAC5B,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,MAAM,EAAE,EAAE,CAAC,MAAM;iBAClB,CAAC,CAAC,CAAC;gBACJ,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;YACnD,IAAI,MAAM,EAAE,CAAC;gBACX,sEAAsE;gBACtE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC1B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAC/E,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;YACzE,CAAC;YACD,uDAAuD;QACzD,CAAC;QAED,oEAAoE;QACpE,2DAA2D;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,WAAmB;QACrB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,WAAmB,EAAE,QAAuB;QAC9C,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;YAC3B,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,EAChF,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,6BAA6B,WAAW,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,EAAE,GAAa,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAExD,qDAAqD;QACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;QAChF,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAC3C,uDAAuD;QACvD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAmB,EAAE,IAAY,EAAE,IAAY;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ;YAAE,OAAO;QAEtB,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;QAC/E,uDAAuD;QACvD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;YACpC,wDAAwD;YACxD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC3C,qDAAqD;QACvD,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,WAAmB,EAAE,WAAmB;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACvD,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAmB,EAAE,WAAmB;QACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YACvD,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,IAAY,EAAE,IAAY,EAAE,MAAyD;QACnG,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QACD,4EAA4E;QAC5E,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY,EAAE,IAAY;QACxC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,IAAI,SAAS,CAAC;IAChE,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAY,EAAE,IAAY;QACtC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEpC,IAAI,KAAK,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACpC,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,IAAY,EAAE,IAAY;QACtC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC3C,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBAC3B,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,WAAmB;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7C,OAAO,GAAG,IAAI,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,mBAAmB,CAAC,WAAoC;QACtD,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;YAAE,OAAO;QAE5D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YACxD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,EAAW,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAe,CAAC;gBAChF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,iDAAiD;oBACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACjD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBACrD,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;oBACjE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;wBAClC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBAClC,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;gBACnC,MAAM,EAAE,GAAG,KAAiB,CAAC;gBAC7B,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;oBACd,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACjD,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;oBACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;oBACjD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAClC,CAAC;qBAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtC,2CAA2C;oBAC3C,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;oBAChC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/core/ForgeContext.d.ts

@@ -0,0 +1,221 @@
+import { type IncomingMessage, type Server, type ServerResponse } from "node:http";
+import type { Socket } from "node:net";
+import type { StaticMountInput } from "../frontend/StaticMountRegistry.js";
+import { StaticMountRegistry } from "../frontend/StaticMountRegistry.js";
+import type { EndpointResolver } from "./EndpointResolver.js";
+import { ForgeEndpoints, type ForgeEndpointResult, type ServiceInstance } from "./ForgeEndpoints.js";
+import { ForgeWebSocket, type WsOptions } from "./ForgeWebSocket.js";
+import { IngressProtection } from "./Ingress.js";
+import { Logger } from "./Logger.js";
+import { isPrivateNetwork, isTrustedProxy } from "./network-utils.js";
+import { PrometheusMetrics } from "./Prometheus.js";
+import { RequestContext } from "./RequestContext.js";
+import { Router } from "./Router.js";
+import { StaticFileServer } from "./StaticFileServer.js";
+import { WorkerChannelManager } from "./WorkerChannelManager.js";
+import { type ServiceMode as ServiceModeValue, type ServiceType as ServiceTypeValue } from "./config-enums.js";
+export { isPrivateNetwork, isTrustedProxy };
+export declare const NOT_HANDLED: unique symbol;
+interface ForgeRequest extends IncomingMessage {
+    body?: unknown;
+    ctx?: RequestContext;
+    auth?: Record<string, unknown> | null;
+    tenantId?: string | null;
+    projectId?: string | null;
+    userId?: string | null;
+    correlationId?: string;
+    params?: Record<string, string>;
+    query?: Record<string, string | string[]>;
+}
+interface ForgeResponse extends ServerResponse {
+    json?: (data: unknown, statusCode?: number) => void;
+    status?: (code: number) => ForgeResponse;
+    stream?: (statusCode?: number, headers?: Record<string, string>) => ForgeResponse;
+    _forgeTracked?: boolean;
+}
+interface IPCMessage {
+    type: string;
+    from?: string;
+    payload?: unknown;
+    requestId?: string;
+    timestamp?: number;
+    error?: string | null;
+    [key: string]: unknown;
+}
+interface WsHandlerEntry {
+    handler: WsHandler;
+    options: WsOptions;
+}
+type WsHandler = (ws: ForgeWebSocket, req: ForgeRequest) => void;
+interface WsPluginHook {
+    name: string;
+    onWsUpgrade?: (payload: Record<string, unknown>) => unknown | Promise<unknown>;
+    onWsConnect?: (payload: Record<string, unknown>) => unknown | Promise<unknown>;
+    onWsMessage?: (payload: Record<string, unknown>) => unknown | Promise<unknown>;
+    onWsClose?: (payload: Record<string, unknown>) => unknown | Promise<unknown>;
+    [key: string]: unknown;
+}
+interface WsPluginResult {
+    plugin: string;
+    ok: boolean;
+    result?: unknown;
+    error?: Error;
+}
+interface IngressConfig {
+    [key: string]: unknown;
+}
+interface ForgeContextOptions {
+    serviceName: string;
+    port: number;
+    workerId: number;
+    threadCount: number;
+    mode: ServiceModeValue;
+    serviceType?: ServiceTypeValue;
+    sendIPC: (msg: Record<string, unknown>) => void;
+    localSend?: ((target: string, payload: unknown) => boolean) | null;
+    localRequest?: ((target: string, payload: unknown) => Promise<unknown>) | null;
+    staticMounts?: StaticMountInput[];
+    ingress?: IngressConfig;
+    forgeProxy?: string | null;
+}
+/**
+ * ForgeContext
+ *
+ * Injected into every Service instance. Provides:
+ *  - HTTP router
+ *  - IPC messaging helpers (direct worker-to-worker when available)
+ *  - Metrics collection
+ *  - Structured logger
+ *  - Runtime metadata (service name, thread count, worker id, etc.)
+ */
+export declare class ForgeContext {
+    serviceName: string;
+    port: number;
+    workerId: number;
+    threadCount: number;
+    mode: ServiceModeValue;
+    serviceType: ServiceTypeValue;
+    router: Router<ForgeRequest, ForgeResponse>;
+    logger: Logger;
+    metrics: PrometheusMetrics;
+    channels: WorkerChannelManager;
+    ingress?: IngressProtection;
+    _sendIPC: (msg: Record<string, unknown>) => void;
+    _localSend: ((target: string, payload: unknown) => boolean) | null;
+    _localRequest: ((target: string, payload: unknown) => Promise<unknown>) | null;
+    _ingressConfig: IngressConfig;
+    _ingressApplied: boolean;
+    _forgeProxy: string | null;
+    _serviceInstance: ServiceInstance | null;
+    _servicePorts: Record<string, number>;
+    _endpointResolver: EndpointResolver | null;
+    _staticMounts: StaticMountInput[];
+    _staticRegistry: StaticMountRegistry;
+    _staticFileServer: StaticFileServer;
+    _forgeEndpoints: ForgeEndpoints<ForgeRequest, ForgeResponse>;
+    _wsConnections: Set<ForgeWebSocket>;
+    _wsPerIpCounts: Map<string, number>;
+    _wsMaxPerIp: number;
+    _wsPerIpCleanupTimer: ReturnType<typeof setInterval>;
+    _wsHandlers: Map<string, WsHandlerEntry>;
+    _wsPluginHooks: WsPluginHook[];
+    _server: Server | null;
+    _needsHttpServer: boolean;
+    _activeRequests: number;
+    _messageHandlers: Map<string, (msg: IPCMessage) => void>;
+    _onMessage?: (from: string, payload: unknown) => void;
+    _onRequest?: (from: string, payload: unknown) => unknown | Promise<unknown>;
+    _projectId?: string;
+    _projectSchema?: string | null;
+    _projectKeyPrefix?: string | null;
+    _emitEvent?: (eventName: string, data: unknown) => void;
+    constructor(options: ForgeContextOptions);
+    setStaticMounts(mounts?: StaticMountInput[]): void;
+    /**
+     * Send a message to another service.
+     *
+     * Resolution order:
+     *   1. Local dispatch (colocated service in same process) — zero overhead
+     *   2. Direct UDS connection — bypasses supervisor
+     *   3. Supervisor IPC fallback — only during startup
+     */
+    send(target: string, payload: unknown): Promise<void>;
+    /**
+     * Broadcast to all workers of a target service.
+     * Note: channels.broadcast delivers to all workers including local via UDS.
+     * We only use _localSend for colocated services that share this process
+     * (no UDS needed), then broadcast to remote workers via channels.
+     */
+    broadcast(target: string, payload: unknown): Promise<void>;
+    /**
+     * Send a request to another service and await a response.
+     *
+     * If the target is colocated, this is a direct async function call
+     * with zero serialization overhead.
+     */
+    request(target: string, payload: unknown, timeoutMs?: number): Promise<unknown>;
+    /**
+     * Start the HTTP server for this service.
+     */
+    startServer(): Promise<void>;
+    /**
+     * Route an incoming HTTP request.
+     * Creates a RequestContext that flows through the entire call chain.
+     */
+    _handleRequest(req: ForgeRequest, res: ForgeResponse, start: number): void;
+    /**
+     * Wire message/request handlers to both the direct channel manager
+     * AND the supervisor fallback IPC path.
+     */
+    _wireMessageHandlers(): void;
+    /**
+     * Handle an incoming IPC message from the supervisor.
+     * This is the FALLBACK path — only used during startup before
+     * direct MessagePorts are established, and for supervisor-level
+     * commands (health checks, shutdown, etc.)
+     */
+    _handleIPCMessage(msg: IPCMessage): void;
+    _isMethodAllowed(method: string | undefined): boolean;
+    _executeForgeEndpoint(res: ForgeResponse, rctx: RequestContext, handler: (...args: unknown[]) => unknown, method: string, { args, logPrefix }: {
+        args: unknown[];
+        logPrefix: string;
+    }): Promise<ForgeEndpointResult | null>;
+    /**
+     * Gracefully shut down.
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a WebSocket handler for a path.
+     *
+     *   ctx.ws('/ws', (socket, req) => {
+     *     socket.on('message', (data) => {
+     *       const msg = JSON.parse(data);
+     *       // req.ctx has the RequestContext with auth, correlationId
+     *       socket.send(JSON.stringify({ echo: msg }));
+     *     });
+     *   });
+     */
+    ws(path: string, handlerOrOptions: WsHandler | WsOptions, maybeHandler?: WsHandler): void;
+    /**
+     * Write a short HTTP response over a raw upgrade socket and close it.
+     */
+    _writeWsUpgradeError(socket: Socket, statusCode: number, reason: string, headers?: Record<string, string>): void;
+    /**
+     * Run websocket plugin hooks for a lifecycle stage.
+     */
+    _runWsPluginHooks(stage: "upgrade" | "connect" | "message" | "close", payload: Record<string, unknown>): Promise<WsPluginResult[]>;
+    /**
+     * Handle HTTP→WebSocket upgrade.
+     * Implements RFC 6455 handshake without external dependencies.
+     */
+    _handleWsUpgrade(req: ForgeRequest, socket: Socket, head: Buffer): Promise<void>;
+    _proxyWsUpgradeToDevServer(req: ForgeRequest, socket: Socket, head: Buffer, url: URL): Promise<boolean>;
+    /**
+     * Register this service with ForgeProxy.
+     * ForgeProxy then routes external traffic to us.
+     */
+    _registerWithForgeProxy(): Promise<void>;
+    _getHost(): string;
+}
+export { ForgeWebSocket };
+//# sourceMappingURL=ForgeContext.d.ts.map

package/dist/core/ForgeContext.d.ts.map

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