@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/http/PodRoutingHttpHandler.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PodRoutingHttpHandler = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const node_stream_1 = require("node:stream");
+const community_server_1 = require("@solid/community-server");
+const community_server_2 = require("@solid/community-server");
+const db_1 = require("../identity/drizzle/db");
+const PodLookupRepository_1 = require("../identity/drizzle/PodLookupRepository");
+const EdgeNodeRepository_1 = require("../identity/drizzle/EdgeNodeRepository");
+/**
+ * Pod Routing HTTP Handler - Routes requests to the correct node based on Pod location.
+ *
+ * For multi-node Center deployment:
+ * 1. Extract Pod ID from request URL
+ * 2. Look up Pod's nodeId from database
+ * 3. If Pod is on current node, pass through to next handler
+ * 4. If Pod is on another node, proxy the request
+ */
+class PodRoutingHttpHandler extends community_server_1.HttpHandler {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        const db = (0, db_1.getIdentityDatabase)(options.identityDbUrl);
+        this.podLookupRepository = options.podLookupRepository ?? new PodLookupRepository_1.PodLookupRepository(db);
+        this.edgeNodeRepository = options.edgeNodeRepository ?? new EdgeNodeRepository_1.EdgeNodeRepository(db);
+        this.currentNodeId = options.nodeId;
+        this.enabled = this.normalizeBoolean(options.enabled);
+        this.logger.info(`PodRoutingHttpHandler initialized: nodeId=${this.currentNodeId}, enabled=${this.enabled}`);
+    }
+    async canHandle({ request }) {
+        if (!this.enabled) {
+            throw new community_server_2.NotImplementedHttpError('Pod routing disabled.');
+        }
+        if (!this.currentNodeId) {
+            throw new community_server_2.NotImplementedHttpError('No nodeId configured, pod routing disabled.');
+        }
+        const url = this.parseUrl(request);
+        // Skip internal/system paths
+        if (this.isSystemPath(url.pathname)) {
+            throw new community_server_2.NotImplementedHttpError('System path, skip pod routing.');
+        }
+        // Look up Pod for this request
+        const pod = await this.podLookupRepository.findByResourceIdentifier(url.href);
+        if (!pod) {
+            throw new community_server_2.NotImplementedHttpError('No Pod found for this request.');
+        }
+        // If Pod has no nodeId, it's on current node (legacy/default)
+        if (!pod.nodeId) {
+            throw new community_server_2.NotImplementedHttpError('Pod has no nodeId, handle locally.');
+        }
+        // If Pod is on current node, pass through
+        if (pod.nodeId === this.currentNodeId) {
+            throw new community_server_2.NotImplementedHttpError('Pod is on current node, handle locally.');
+        }
+        // Pod is on another node, we need to proxy
+        this.logger.debug(`Pod ${pod.podId} is on node ${pod.nodeId}, need to proxy.`);
+    }
+    async handle({ request, response }) {
+        const url = this.parseUrl(request);
+        const pod = await this.podLookupRepository.findByResourceIdentifier(url.href);
+        if (!pod || !pod.nodeId) {
+            throw new community_server_2.InternalServerError('Pod lookup failed in handle phase.');
+        }
+        // Try to resolve upstream with internal endpoint support (for center-to-center)
+        const upstream = await this.resolveUpstreamWithInternal(pod.nodeId);
+        if (!upstream) {
+            throw new community_server_2.InternalServerError(`Target node ${pod.nodeId} has no reachable endpoint.`);
+        }
+        await this.proxyRequest(request, response, upstream, url);
+    }
+    /**
+     * Proxy request to target node.
+     */
+    async proxyRequest(request, response, upstream, originalUrl) {
+        const upstreamBase = new URL(upstream);
+        const target = new URL(originalUrl.pathname + originalUrl.search, upstreamBase);
+        target.hash = originalUrl.hash;
+        const body = await this.readRequestBody(request);
+        const headers = this.buildProxyHeaders(request, originalUrl, upstreamBase);
+        this.logger.debug(`Proxying to ${target.toString()}`);
+        let upstreamResponse;
+        try {
+            upstreamResponse = await fetch(target.toString(), {
+                method: (request.method ?? 'GET').toUpperCase(),
+                headers,
+                body: body?.length ? body : undefined,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Proxy request to ${target.toString()} failed: ${String(error)}`);
+            throw new community_server_2.InternalServerError('Failed to proxy request to target node.', { cause: error });
+        }
+        // Forward response
+        response.statusCode = upstreamResponse.status;
+        response.setHeader('X-Xpod-Proxied-From', this.currentNodeId);
+        upstreamResponse.headers.forEach((value, key) => {
+            if (key.toLowerCase() === 'transfer-encoding' && value === 'chunked') {
+                return; // Let Node.js handle chunking
+            }
+            response.setHeader(key, value);
+        });
+        if (!upstreamResponse.body) {
+            response.end();
+            return;
+        }
+        const readable = node_stream_1.Readable.from(upstreamResponse.body);
+        readable.on('error', (error) => {
+            this.logger.error(`Proxy stream error: ${String(error)}`);
+            response.destroy(error);
+        });
+        readable.pipe(response);
+    }
+    /**
+     * Resolve upstream endpoint from node info.
+     * For center nodes, prefer internal endpoint for intra-cluster communication.
+     */
+    resolveUpstream(nodeInfo) {
+        // Try public IP first (for edge nodes or external access)
+        if (nodeInfo.publicIp) {
+            const port = nodeInfo.publicPort && nodeInfo.publicPort !== 443 ? `:${nodeInfo.publicPort}` : '';
+            return `https://${nodeInfo.publicIp}${port}`;
+        }
+        // NOTE: Internal endpoint lookup is done via CenterNodeRegistrationService.getNodeInternalUrl()
+        // This method is kept simple - the handler should be injected with the registration service
+        // for full internal routing support.
+        return undefined;
+    }
+    /**
+     * Resolve upstream for center node using internal endpoint.
+     */
+    async resolveUpstreamWithInternal(nodeId) {
+        // First try to get center node internal endpoint
+        const centerNodes = await this.edgeNodeRepository.listCenterNodes();
+        const centerNode = centerNodes.find(n => n.nodeId === nodeId);
+        if (centerNode && centerNode.internalIp && centerNode.internalPort) {
+            return `http://${centerNode.internalIp}:${centerNode.internalPort}`;
+        }
+        // Fall back to public endpoint
+        const nodeInfo = await this.edgeNodeRepository.getNodeConnectivityInfo(nodeId);
+        if (!nodeInfo) {
+            return undefined;
+        }
+        return this.resolveUpstream(nodeInfo);
+    }
+    /**
+     * Build headers for proxy request.
+     */
+    buildProxyHeaders(request, original, upstream) {
+        const headers = new Headers();
+        // Forward original headers except host
+        for (const [name, value] of Object.entries(request.headers)) {
+            if (value === undefined || name.toLowerCase() === 'host') {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                headers.set(name, value.join(','));
+            }
+            else {
+                headers.set(name, value);
+            }
+        }
+        // Set proper target host
+        headers.set('host', upstream.host);
+        // Add forwarded headers
+        headers.set('x-forwarded-host', original.host);
+        headers.set('x-forwarded-proto', original.protocol.replace(/:$/u, ''));
+        const port = original.port || (original.protocol === 'https:' ? '443' : '80');
+        headers.set('x-forwarded-port', port);
+        // Add source node info
+        headers.set('x-xpod-source-node', this.currentNodeId);
+        // Add client IP if available
+        const remoteAddress = request.socket?.remoteAddress;
+        if (remoteAddress) {
+            const existing = headers.get('x-forwarded-for');
+            headers.set('x-forwarded-for', existing ? `${existing}, ${remoteAddress}` : remoteAddress);
+        }
+        return headers;
+    }
+    /**
+     * Read request body for proxy forwarding.
+     */
+    readRequestBody(request) {
+        const method = (request.method ?? 'GET').toUpperCase();
+        if (['GET', 'HEAD'].includes(method)) {
+            return Promise.resolve(undefined);
+        }
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            request.on('data', (chunk) => chunks.push(chunk));
+            request.on('end', () => resolve(Buffer.concat(chunks)));
+            request.on('error', reject);
+        });
+    }
+    /**
+     * Check if path is a system/internal path that should skip routing.
+     */
+    isSystemPath(pathname) {
+        const systemPaths = [
+            '/idp/',
+            '/.well-known/',
+            '/-/',
+            '/api/',
+        ];
+        return systemPaths.some(prefix => pathname.startsWith(prefix));
+    }
+    /**
+     * Parse request URL.
+     */
+    parseUrl(request) {
+        const hostHeader = request.headers.host ?? request.headers.Host ?? 'localhost';
+        const protoHeader = request.headers['x-forwarded-proto'] ?? request.headers['X-Forwarded-Proto'];
+        const protocol = Array.isArray(protoHeader) ? protoHeader[0] : protoHeader;
+        const scheme = typeof protocol === 'string' ? protocol.split(',')[0]?.trim() ?? 'https' : 'https';
+        const rawUrl = request.url ?? '/';
+        return new URL(rawUrl, `${scheme}://${hostHeader}`);
+    }
+    /**
+     * Normalize boolean values from string/boolean.
+     */
+    normalizeBoolean(value) {
+        if (typeof value === 'boolean') {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const normalized = value.trim().toLowerCase();
+            return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';
+        }
+        return false;
+    }
+}
+exports.PodRoutingHttpHandler = PodRoutingHttpHandler;
+//# sourceMappingURL=PodRoutingHttpHandler.js.map

package/dist/http/PodRoutingHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PodRoutingHttpHandler.js","sourceRoot":"","sources":["../../src/http/PodRoutingHttpHandler.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingMessage } from 'node:http';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { Readable } from 'node:stream';\nimport { HttpHandler } from '@solid/community-server';\nimport type { HttpHandlerInput, HttpResponse } from '@solid/community-server';\nimport {\n  NotImplementedHttpError,\n  InternalServerError,\n  \n} from '@solid/community-server';\nimport { getIdentityDatabase } from '../identity/drizzle/db';\nimport { PodLookupRepository } from '../identity/drizzle/PodLookupRepository';\nimport { EdgeNodeRepository } from '../identity/drizzle/EdgeNodeRepository';\n\ninterface PodRoutingHttpHandlerOptions {\n  identityDbUrl: string;\n  nodeId: string;                    // Current node ID\n  enabled?: boolean | string;\n  podLookupRepository?: PodLookupRepository;\n  edgeNodeRepository?: EdgeNodeRepository;\n}\n\n/**\n * Pod Routing HTTP Handler - Routes requests to the correct node based on Pod location.\n * \n * For multi-node Center deployment:\n * 1. Extract Pod ID from request URL\n * 2. Look up Pod's nodeId from database\n * 3. If Pod is on current node, pass through to next handler\n * 4. If Pod is on another node, proxy the request\n */\nexport class PodRoutingHttpHandler extends HttpHandler {\n  protected readonly logger = getLoggerFor(this);\n  private readonly podLookupRepository: PodLookupRepository;\n  private readonly edgeNodeRepository: EdgeNodeRepository;\n  private readonly currentNodeId: string;\n  private readonly enabled: boolean;\n\n  public constructor(options: PodRoutingHttpHandlerOptions) {\n    super();\n    const db = getIdentityDatabase(options.identityDbUrl);\n    this.podLookupRepository = options.podLookupRepository ?? new PodLookupRepository(db);\n    this.edgeNodeRepository = options.edgeNodeRepository ?? new EdgeNodeRepository(db);\n    this.currentNodeId = options.nodeId;\n    this.enabled = this.normalizeBoolean(options.enabled);\n\n    this.logger.info(`PodRoutingHttpHandler initialized: nodeId=${this.currentNodeId}, enabled=${this.enabled}`);\n  }\n\n  public override async canHandle({ request }: HttpHandlerInput): Promise<void> {\n    if (!this.enabled) {\n      throw new NotImplementedHttpError('Pod routing disabled.');\n    }\n\n    if (!this.currentNodeId) {\n      throw new NotImplementedHttpError('No nodeId configured, pod routing disabled.');\n    }\n\n    const url = this.parseUrl(request);\n    \n    // Skip internal/system paths\n    if (this.isSystemPath(url.pathname)) {\n      throw new NotImplementedHttpError('System path, skip pod routing.');\n    }\n\n    // Look up Pod for this request\n    const pod = await this.podLookupRepository.findByResourceIdentifier(url.href);\n    if (!pod) {\n      throw new NotImplementedHttpError('No Pod found for this request.');\n    }\n\n    // If Pod has no nodeId, it's on current node (legacy/default)\n    if (!pod.nodeId) {\n      throw new NotImplementedHttpError('Pod has no nodeId, handle locally.');\n    }\n\n    // If Pod is on current node, pass through\n    if (pod.nodeId === this.currentNodeId) {\n      throw new NotImplementedHttpError('Pod is on current node, handle locally.');\n    }\n\n    // Pod is on another node, we need to proxy\n    this.logger.debug(`Pod ${pod.podId} is on node ${pod.nodeId}, need to proxy.`);\n  }\n\n  public override async handle({ request, response }: HttpHandlerInput): Promise<void> {\n    const url = this.parseUrl(request);\n    const pod = await this.podLookupRepository.findByResourceIdentifier(url.href);\n\n    if (!pod || !pod.nodeId) {\n      throw new InternalServerError('Pod lookup failed in handle phase.');\n    }\n\n    // Try to resolve upstream with internal endpoint support (for center-to-center)\n    const upstream = await this.resolveUpstreamWithInternal(pod.nodeId);\n    if (!upstream) {\n      throw new InternalServerError(`Target node ${pod.nodeId} has no reachable endpoint.`);\n    }\n\n    await this.proxyRequest(request, response, upstream, url);\n  }\n\n  /**\n   * Proxy request to target node.\n   */\n  private async proxyRequest(\n    request: IncomingMessage,\n    response: HttpResponse,\n    upstream: string,\n    originalUrl: URL,\n  ): Promise<void> {\n    const upstreamBase = new URL(upstream);\n    const target = new URL(originalUrl.pathname + originalUrl.search, upstreamBase);\n    target.hash = originalUrl.hash;\n\n    const body = await this.readRequestBody(request);\n    const headers = this.buildProxyHeaders(request, originalUrl, upstreamBase);\n\n    this.logger.debug(`Proxying to ${target.toString()}`);\n\n    let upstreamResponse: Response;\n    try {\n      upstreamResponse = await fetch(target.toString(), {\n        method: (request.method ?? 'GET').toUpperCase(),\n        headers,\n        body: body?.length ? body : undefined,\n      });\n    } catch (error: unknown) {\n      this.logger.error(`Proxy request to ${target.toString()} failed: ${String(error)}`);\n      throw new InternalServerError('Failed to proxy request to target node.', { cause: error });\n    }\n\n    // Forward response\n    response.statusCode = upstreamResponse.status;\n    response.setHeader('X-Xpod-Proxied-From', this.currentNodeId);\n\n    upstreamResponse.headers.forEach((value, key) => {\n      if (key.toLowerCase() === 'transfer-encoding' && value === 'chunked') {\n        return; // Let Node.js handle chunking\n      }\n      response.setHeader(key, value);\n    });\n\n    if (!upstreamResponse.body) {\n      response.end();\n      return;\n    }\n\n    const readable = Readable.from(upstreamResponse.body as unknown as AsyncIterable<Uint8Array>);\n    readable.on('error', (error) => {\n      this.logger.error(`Proxy stream error: ${String(error)}`);\n      response.destroy(error);\n    });\n    readable.pipe(response);\n  }\n\n  /**\n   * Resolve upstream endpoint from node info.\n   * For center nodes, prefer internal endpoint for intra-cluster communication.\n   */\n  private resolveUpstream(nodeInfo: {\n    publicIp?: string | null;\n    publicPort?: number | null;\n    nodeId: string;\n  }): string | undefined {\n    // Try public IP first (for edge nodes or external access)\n    if (nodeInfo.publicIp) {\n      const port = nodeInfo.publicPort && nodeInfo.publicPort !== 443 ? `:${nodeInfo.publicPort}` : '';\n      return `https://${nodeInfo.publicIp}${port}`;\n    }\n\n    // NOTE: Internal endpoint lookup is done via CenterNodeRegistrationService.getNodeInternalUrl()\n    // This method is kept simple - the handler should be injected with the registration service\n    // for full internal routing support.\n\n    return undefined;\n  }\n\n  /**\n   * Resolve upstream for center node using internal endpoint.\n   */\n  public async resolveUpstreamWithInternal(nodeId: string): Promise<string | undefined> {\n    // First try to get center node internal endpoint\n    const centerNodes = await this.edgeNodeRepository.listCenterNodes();\n    const centerNode = centerNodes.find(n => n.nodeId === nodeId);\n    \n    if (centerNode && centerNode.internalIp && centerNode.internalPort) {\n      return `http://${centerNode.internalIp}:${centerNode.internalPort}`;\n    }\n\n    // Fall back to public endpoint\n    const nodeInfo = await this.edgeNodeRepository.getNodeConnectivityInfo(nodeId);\n    if (!nodeInfo) {\n      return undefined;\n    }\n    return this.resolveUpstream(nodeInfo);\n  }\n\n  /**\n   * Build headers for proxy request.\n   */\n  private buildProxyHeaders(request: IncomingMessage, original: URL, upstream: URL): Headers {\n    const headers = new Headers();\n\n    // Forward original headers except host\n    for (const [name, value] of Object.entries(request.headers)) {\n      if (value === undefined || name.toLowerCase() === 'host') {\n        continue;\n      }\n      if (Array.isArray(value)) {\n        headers.set(name, value.join(','));\n      } else {\n        headers.set(name, value);\n      }\n    }\n\n    // Set proper target host\n    headers.set('host', upstream.host);\n\n    // Add forwarded headers\n    headers.set('x-forwarded-host', original.host);\n    headers.set('x-forwarded-proto', original.protocol.replace(/:$/u, ''));\n\n    const port = original.port || (original.protocol === 'https:' ? '443' : '80');\n    headers.set('x-forwarded-port', port);\n\n    // Add source node info\n    headers.set('x-xpod-source-node', this.currentNodeId);\n\n    // Add client IP if available\n    const remoteAddress = (request.socket as { remoteAddress?: string })?.remoteAddress;\n    if (remoteAddress) {\n      const existing = headers.get('x-forwarded-for');\n      headers.set('x-forwarded-for', existing ? `${existing}, ${remoteAddress}` : remoteAddress);\n    }\n\n    return headers;\n  }\n\n  /**\n   * Read request body for proxy forwarding.\n   */\n  private readRequestBody(request: IncomingMessage): Promise<Buffer | undefined> {\n    const method = (request.method ?? 'GET').toUpperCase();\n    if (['GET', 'HEAD'].includes(method)) {\n      return Promise.resolve(undefined);\n    }\n\n    return new Promise((resolve, reject) => {\n      const chunks: Buffer[] = [];\n      request.on('data', (chunk: Buffer) => chunks.push(chunk));\n      request.on('end', () => resolve(Buffer.concat(chunks)));\n      request.on('error', reject);\n    });\n  }\n\n  /**\n   * Check if path is a system/internal path that should skip routing.\n   */\n  private isSystemPath(pathname: string): boolean {\n    const systemPaths = [\n      '/idp/',\n      '/.well-known/',\n      '/-/',\n      '/api/',\n    ];\n    return systemPaths.some(prefix => pathname.startsWith(prefix));\n  }\n\n  /**\n   * Parse request URL.\n   */\n  private parseUrl(request: IncomingMessage): URL {\n    const hostHeader = request.headers.host ?? request.headers.Host ?? 'localhost';\n    const protoHeader = request.headers['x-forwarded-proto'] ?? request.headers['X-Forwarded-Proto'];\n    const protocol = Array.isArray(protoHeader) ? protoHeader[0] : protoHeader;\n    const scheme = typeof protocol === 'string' ? protocol.split(',')[0]?.trim() ?? 'https' : 'https';\n    const rawUrl = request.url ?? '/';\n    return new URL(rawUrl, `${scheme}://${hostHeader}`);\n  }\n\n  /**\n   * Normalize boolean values from string/boolean.\n   */\n  private normalizeBoolean(value?: string | boolean): boolean {\n    if (typeof value === 'boolean') {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const normalized = value.trim().toLowerCase();\n      return normalized === 'true' || normalized === '1' || normalized === 'yes' || normalized === 'on';\n    }\n    return false;\n  }\n}\n"]}

package/dist/http/PodRoutingHttpHandler.jsonld

@@ -0,0 +1,171 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/@solid/community-server/^8.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler",
+      "@type": "Class",
+      "requireElement": "PodRoutingHttpHandler",
+      "extends": [
+        "css:dist/server/HttpHandler.jsonld#HttpHandler"
+      ],
+      "comment": "Pod Routing HTTP Handler - Routes requests to the correct node based on Pod location.  For multi-node Center deployment: 1. Extract Pod ID from request URL 2. Look up Pod's nodeId from database 3. If Pod is on current node, pass through to next handler 4. If Pod is on another node, proxy the request",
+      "parameters": [
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_identityDbUrl",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_nodeId",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_enabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_podLookupRepository",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/identity/drizzle/PodLookupRepository.jsonld#PodLookupRepository",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_edgeNodeRepository",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/identity/drizzle/EdgeNodeRepository.jsonld#EdgeNodeRepository",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_podLookupRepository",
+          "memberFieldName": "podLookupRepository"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_edgeNodeRepository",
+          "memberFieldName": "edgeNodeRepository"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_currentNodeId",
+          "memberFieldName": "currentNodeId"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_proxyRequest",
+          "memberFieldName": "proxyRequest"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_resolveUpstream",
+          "memberFieldName": "resolveUpstream"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_resolveUpstreamWithInternal",
+          "memberFieldName": "resolveUpstreamWithInternal"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_buildProxyHeaders",
+          "memberFieldName": "buildProxyHeaders"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_readRequestBody",
+          "memberFieldName": "readRequestBody"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_isSystemPath",
+          "memberFieldName": "isSystemPath"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_parseUrl",
+          "memberFieldName": "parseUrl"
+        },
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "nodeId",
+              "value": {
+                "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_nodeId"
+              }
+            },
+            {
+              "keyRaw": "enabled",
+              "value": {
+                "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_enabled"
+              }
+            },
+            {
+              "keyRaw": "podLookupRepository",
+              "value": {
+                "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_podLookupRepository"
+              }
+            },
+            {
+              "keyRaw": "edgeNodeRepository",
+              "value": {
+                "@id": "undefineds:dist/http/PodRoutingHttpHandler.jsonld#PodRoutingHttpHandler_options_edgeNodeRepository"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/http/RequestIdHttpHandler.d.ts

@@ -0,0 +1,15 @@
+import { HttpHandler, type HttpHandlerInput } from '@solid/community-server';
+/**
+ * Middleware that manages Request IDs for tracing.
+ * 1. Checks for existing X-Request-ID in request headers.
+ * 2. If missing, generates a new UUID.
+ * 3. Sets the X-Request-ID in the response header.
+ * 4. Stores the ID in AsyncLocalStorage for logging context.
+ */
+export declare class RequestIdHttpHandler extends HttpHandler {
+    private readonly source;
+    constructor(source: HttpHandler);
+    canHandle(input: HttpHandlerInput): Promise<void>;
+    handle(input: HttpHandlerInput): Promise<void>;
+    private loggerForRequest;
+}

package/dist/http/RequestIdHttpHandler.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestIdHttpHandler = void 0;
+const community_server_1 = require("@solid/community-server");
+const global_logger_factory_1 = require("global-logger-factory");
+const LogContext_1 = require("../logging/LogContext");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+/**
+ * Middleware that manages Request IDs for tracing.
+ * 1. Checks for existing X-Request-ID in request headers.
+ * 2. If missing, generates a new UUID.
+ * 3. Sets the X-Request-ID in the response header.
+ * 4. Stores the ID in AsyncLocalStorage for logging context.
+ */
+class RequestIdHttpHandler extends community_server_1.HttpHandler {
+    constructor(source) {
+        super();
+        this.source = source;
+    }
+    async canHandle(input) {
+        await this.source.canHandle(input);
+    }
+    async handle(input) {
+        const headerId = input.request.headers['x-request-id'];
+        const requestId = Array.isArray(headerId) ? headerId[0] : headerId || node_crypto_1.default.randomUUID();
+        input.response.setHeader('X-Request-ID', requestId);
+        const logger = this.loggerForRequest(input);
+        await LogContext_1.logContext.run({ requestId }, async () => {
+            const started = Date.now();
+            let status = 500;
+            try {
+                await this.source.handle(input);
+                status = input.response.statusCode || 200;
+            }
+            catch (error) {
+                status = error instanceof Error ? error.statusCode ?? status : status;
+                logger.error(`${input.request.method} ${input.request.url} -> error ${status}: ${error instanceof Error ? error.message : String(error)}`);
+                throw error;
+            }
+            finally {
+                const ms = Date.now() - started;
+                if (status < 400) {
+                    logger.info(`${input.request.method} ${input.request.url} -> ${status} (${ms}ms)`);
+                }
+                else {
+                    logger.warn(`${input.request.method} ${input.request.url} -> ${status} (${ms}ms)`);
+                }
+            }
+        });
+    }
+    loggerForRequest(input) {
+        return (0, global_logger_factory_1.getLoggerFor)(this);
+    }
+}
+exports.RequestIdHttpHandler = RequestIdHttpHandler;
+//# sourceMappingURL=RequestIdHttpHandler.js.map

package/dist/http/RequestIdHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequestIdHttpHandler.js","sourceRoot":"","sources":["../../src/http/RequestIdHttpHandler.ts"],"names":[],"mappings":";;;;;;AAAA,8DAA6E;AAC7E,iEAAqD;AACrD,sDAAmD;AACnD,8DAAiC;AAEjC;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,8BAAW;IAGnD,YAAmB,MAAmB;QACpC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEe,KAAK,CAAC,SAAS,CAAC,KAAuB;QACrD,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAEe,KAAK,CAAC,MAAM,CAAC,KAAuB;QAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,qBAAM,CAAC,UAAU,EAAE,CAAC;QAE1F,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAE5C,MAAM,uBAAU,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC3B,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAChC,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,IAAI,GAAG,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAE,KAAa,CAAC,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;gBAC/E,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,aAAa,MAAM,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3I,MAAM,KAAK,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;gBAChC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;oBACjB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,MAAM,KAAK,EAAE,KAAK,CAAC,CAAC;gBACrF,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,OAAO,MAAM,KAAK,EAAE,KAAK,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,gBAAgB,CAAC,KAAuB;QAC9C,OAAO,IAAA,oCAAY,EAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;CACF;AA3CD,oDA2CC","sourcesContent":["import { HttpHandler, type HttpHandlerInput } from '@solid/community-server';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { logContext } from '../logging/LogContext';\nimport crypto from 'node:crypto';\n\n/**\n * Middleware that manages Request IDs for tracing.\n * 1. Checks for existing X-Request-ID in request headers.\n * 2. If missing, generates a new UUID.\n * 3. Sets the X-Request-ID in the response header.\n * 4. Stores the ID in AsyncLocalStorage for logging context.\n */\nexport class RequestIdHttpHandler extends HttpHandler {\n  private readonly source: HttpHandler;\n\n  public constructor(source: HttpHandler) {\n    super();\n    this.source = source;\n  }\n\n  public override async canHandle(input: HttpHandlerInput): Promise<void> {\n    await this.source.canHandle(input);\n  }\n\n  public override async handle(input: HttpHandlerInput): Promise<void> {\n    const headerId = input.request.headers['x-request-id'];\n    const requestId = Array.isArray(headerId) ? headerId[0] : headerId || crypto.randomUUID();\n    \n    input.response.setHeader('X-Request-ID', requestId);\n    const logger = this.loggerForRequest(input);\n\n    await logContext.run({ requestId }, async () => {\n      const started = Date.now();\n      let status = 500;\n      try {\n        await this.source.handle(input);\n        status = input.response.statusCode || 200;\n      } catch (error) {\n        status = error instanceof Error ? (error as any).statusCode ?? status : status;\n        logger.error(`${input.request.method} ${input.request.url} -> error ${status}: ${error instanceof Error ? error.message : String(error)}`);\n        throw error;\n      } finally {\n        const ms = Date.now() - started;\n        if (status < 400) {\n          logger.info(`${input.request.method} ${input.request.url} -> ${status} (${ms}ms)`);\n        } else {\n          logger.warn(`${input.request.method} ${input.request.url} -> ${status} (${ms}ms)`);\n        }\n      }\n    });\n  }\n\n  private loggerForRequest(input: HttpHandlerInput) {\n    return getLoggerFor(this);\n  }\n}\n"]}

package/dist/http/RouterHttpHandler.d.ts

@@ -0,0 +1,21 @@
+import { HttpHandler } from '@solid/community-server';
+import type { HttpHandlerInput } from '@solid/community-server';
+import { RouterHttpRoute } from './RouterHttpRoute';
+interface RouterHttpHandlerOptions {
+    routes: RouterHttpRoute[];
+    fallback: HttpHandler;
+}
+/**
+ * Routes requests by path prefix and forwards to the first matching handler.
+ * This stays in single-baseUrl mode and does not inspect the Host header.
+ */
+export declare class RouterHttpHandler extends HttpHandler {
+    private readonly routes;
+    private readonly fallback;
+    constructor(options: RouterHttpHandlerOptions);
+    canHandle(input: HttpHandlerInput): Promise<void>;
+    handle(input: HttpHandlerInput): Promise<void>;
+    private resolveHandler;
+    private parsePathname;
+}
+export {};

package/dist/http/RouterHttpHandler.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouterHttpHandler = void 0;
+const community_server_1 = require("@solid/community-server");
+/**
+ * Routes requests by path prefix and forwards to the first matching handler.
+ * This stays in single-baseUrl mode and does not inspect the Host header.
+ */
+class RouterHttpHandler extends community_server_1.HttpHandler {
+    constructor(options) {
+        super();
+        this.routes = options.routes.map((route) => {
+            const basePath = route.basePath.endsWith('/') ? route.basePath.slice(0, -1) : route.basePath;
+            return {
+                basePath,
+                basePathWithSlash: `${basePath}/`,
+                handler: route.handler,
+            };
+        });
+        this.fallback = options.fallback;
+    }
+    async canHandle(input) {
+        const handler = this.resolveHandler(input);
+        await handler.canHandle(input);
+    }
+    async handle(input) {
+        const handler = this.resolveHandler(input);
+        await handler.handle(input);
+    }
+    resolveHandler(input) {
+        const pathname = this.parsePathname(input);
+        for (const route of this.routes) {
+            if (pathname === route.basePath || pathname.startsWith(route.basePathWithSlash)) {
+                return route.handler;
+            }
+        }
+        return this.fallback;
+    }
+    parsePathname({ request }) {
+        const hostHeader = request.headers.host ?? request.headers.Host ?? 'localhost';
+        const protoHeader = request.headers['x-forwarded-proto'] ?? request.headers['X-Forwarded-Proto'];
+        const protocol = Array.isArray(protoHeader) ? protoHeader[0] : protoHeader;
+        const scheme = typeof protocol === 'string' ? protocol.split(',')[0]?.trim() ?? 'http' : 'http';
+        const rawUrl = request.url ?? '/';
+        return new URL(rawUrl, `${scheme}://${hostHeader}`).pathname;
+    }
+}
+exports.RouterHttpHandler = RouterHttpHandler;
+//# sourceMappingURL=RouterHttpHandler.js.map

package/dist/http/RouterHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RouterHttpHandler.js","sourceRoot":"","sources":["../../src/http/RouterHttpHandler.ts"],"names":[],"mappings":";;;AAAA,8DAAsD;AAStD;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,8BAAW;IAIhD,YAAmB,OAAiC;QAClD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAyE,EAAE;YAChH,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC7F,OAAO;gBACL,QAAQ;gBACR,iBAAiB,EAAE,GAAG,QAAQ,GAAG;gBACjC,OAAO,EAAE,KAAK,CAAC,OAAO;aACvB,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAEe,KAAK,CAAC,SAAS,CAAC,KAAuB;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IAEe,KAAK,CAAC,MAAM,CAAC,KAAuB;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAEO,cAAc,CAAC,KAAuB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,QAAQ,KAAK,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBAChF,OAAO,KAAK,CAAC,OAAO,CAAC;YACvB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAEO,aAAa,CAAC,EAAE,OAAO,EAAoB;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;QAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACjG,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAC3E,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAChG,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC;QAClC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,MAAM,MAAM,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC;IAC/D,CAAC;CACF;AA7CD,8CA6CC","sourcesContent":["import { HttpHandler } from '@solid/community-server';\nimport type { HttpHandlerInput } from '@solid/community-server';\nimport { RouterHttpRoute } from './RouterHttpRoute';\n\ninterface RouterHttpHandlerOptions {\n  routes: RouterHttpRoute[];\n  fallback: HttpHandler;\n}\n\n/**\n * Routes requests by path prefix and forwards to the first matching handler.\n * This stays in single-baseUrl mode and does not inspect the Host header.\n */\nexport class RouterHttpHandler extends HttpHandler {\n  private readonly routes: { basePath: string; basePathWithSlash: string; handler: HttpHandler }[];\n  private readonly fallback: HttpHandler;\n\n  public constructor(options: RouterHttpHandlerOptions) {\n    super();\n    this.routes = options.routes.map((route): { basePath: string; basePathWithSlash: string; handler: HttpHandler } => {\n      const basePath = route.basePath.endsWith('/') ? route.basePath.slice(0, -1) : route.basePath;\n      return {\n        basePath,\n        basePathWithSlash: `${basePath}/`,\n        handler: route.handler,\n      };\n    });\n    this.fallback = options.fallback;\n  }\n\n  public override async canHandle(input: HttpHandlerInput): Promise<void> {\n    const handler = this.resolveHandler(input);\n    await handler.canHandle(input);\n  }\n\n  public override async handle(input: HttpHandlerInput): Promise<void> {\n    const handler = this.resolveHandler(input);\n    await handler.handle(input);\n  }\n\n  private resolveHandler(input: HttpHandlerInput): HttpHandler {\n    const pathname = this.parsePathname(input);\n    for (const route of this.routes) {\n      if (pathname === route.basePath || pathname.startsWith(route.basePathWithSlash)) {\n        return route.handler;\n      }\n    }\n    return this.fallback;\n  }\n\n  private parsePathname({ request }: HttpHandlerInput): string {\n    const hostHeader = request.headers.host ?? request.headers.Host ?? 'localhost';\n    const protoHeader = request.headers['x-forwarded-proto'] ?? request.headers['X-Forwarded-Proto'];\n    const protocol = Array.isArray(protoHeader) ? protoHeader[0] : protoHeader;\n    const scheme = typeof protocol === 'string' ? protocol.split(',')[0]?.trim() ?? 'http' : 'http';\n    const rawUrl = request.url ?? '/';\n    return new URL(rawUrl, `${scheme}://${hostHeader}`).pathname;\n  }\n}\n"]}