@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/http/EdgeNodeDirectDebugHttpHandler.jsonld

@@ -0,0 +1,151 @@
+{
+  "@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/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler",
+      "@type": "Class",
+      "requireElement": "EdgeNodeDirectDebugHttpHandler",
+      "extends": [
+        "css:dist/server/HttpHandler.jsonld#HttpHandler"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_identityDbUrl",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_edgeNodesEnabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_skipPrefixes",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": "xsd:string"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_nodeRepository",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/identity/drizzle/EdgeNodeRepository.jsonld#EdgeNodeRepository",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_nodeRepo",
+          "memberFieldName": "nodeRepo"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_skipPrefixes",
+          "memberFieldName": "skipPrefixes"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_resolve",
+          "memberFieldName": "resolve"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_shouldSkip",
+          "memberFieldName": "shouldSkip"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_resolveTarget",
+          "memberFieldName": "resolveTarget"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_extractUrl",
+          "memberFieldName": "extractUrl"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_parseUrl",
+          "memberFieldName": "parseUrl"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "edgeNodesEnabled",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_edgeNodesEnabled"
+              }
+            },
+            {
+              "keyRaw": "skipPrefixes",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_skipPrefixes"
+              }
+            },
+            {
+              "keyRaw": "nodeRepository",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeDirectDebugHttpHandler.jsonld#EdgeNodeDirectDebugHttpHandler_options_nodeRepository"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/http/EdgeNodeProxyHttpHandler.d.ts

@@ -0,0 +1,28 @@
+import { HttpHandler } from '@solid/community-server';
+import type { HttpHandlerInput } from '@solid/community-server';
+import { EdgeNodeRepository } from '../identity/drizzle/EdgeNodeRepository';
+interface EdgeNodeProxyHttpHandlerOptions {
+    identityDbUrl: string;
+    edgeNodesEnabled?: string | boolean;
+    repository?: EdgeNodeRepository;
+    fetchImpl?: any;
+}
+export declare class EdgeNodeProxyHttpHandler extends HttpHandler {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly repo;
+    private readonly enabled;
+    private readonly fetchImpl;
+    constructor(options: EdgeNodeProxyHttpHandlerOptions);
+    canHandle({ request }: HttpHandlerInput): Promise<void>;
+    handle({ request, response }: HttpHandlerInput): Promise<void>;
+    private forwardRequest;
+    private resolveUpstream;
+    private buildHeaders;
+    private readBody;
+    private extractHostname;
+    private writeOptions;
+    private parseUrl;
+    private normalizeBoolean;
+    private normalizeMode;
+}
+export {};

package/dist/http/EdgeNodeProxyHttpHandler.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeNodeProxyHttpHandler = 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 EdgeNodeRepository_1 = require("../identity/drizzle/EdgeNodeRepository");
+class EdgeNodeProxyHttpHandler extends community_server_1.HttpHandler {
+    constructor(options) {
+        super();
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.repo = options.repository ?? new EdgeNodeRepository_1.EdgeNodeRepository((0, db_1.getIdentityDatabase)(options.identityDbUrl));
+        this.enabled = this.normalizeBoolean(options.edgeNodesEnabled);
+        this.fetchImpl = options.fetchImpl ?? fetch;
+    }
+    async canHandle({ request }) {
+        if (!this.enabled) {
+            throw new community_server_2.NotImplementedHttpError('Edge proxy disabled.');
+        }
+        const hostname = this.extractHostname(request);
+        if (!hostname) {
+            throw new community_server_2.NotImplementedHttpError('Missing Host header.');
+        }
+        const node = await this.repo.findNodeBySubdomain(hostname);
+        const mode = this.normalizeMode(node?.accessMode);
+        if (!node || mode !== 'proxy') {
+            throw new community_server_2.NotImplementedHttpError('Not a proxy edge node request.');
+        }
+    }
+    async handle({ request, response }) {
+        if ((request.method ?? 'GET').toUpperCase() === 'OPTIONS') {
+            this.writeOptions(response);
+            return;
+        }
+        if ((request.method ?? 'GET').toUpperCase() === 'CONNECT') {
+            throw new community_server_2.MethodNotAllowedHttpError(['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']);
+        }
+        const hostname = this.extractHostname(request);
+        if (!hostname) {
+            throw new community_server_2.BadRequestHttpError('Host header required.');
+        }
+        const node = await this.repo.findNodeBySubdomain(hostname);
+        const mode = this.normalizeMode(node?.accessMode);
+        if (!node || mode !== 'proxy') {
+            throw new community_server_2.NotImplementedHttpError('Not a proxy edge node request.');
+        }
+        await this.forwardRequest(node, request, response);
+    }
+    async forwardRequest(node, request, response) {
+        const metadata = node.metadata ?? undefined;
+        const upstream = this.resolveUpstream(metadata);
+        if (!upstream) {
+            throw new community_server_2.InternalServerError('Edge node tunnel is not ready.');
+        }
+        const upstreamBase = new URL(upstream);
+        const originalUrl = this.parseUrl(request);
+        const target = new URL(originalUrl.pathname + originalUrl.search, upstreamBase);
+        target.hash = originalUrl.hash;
+        const body = await this.readBody(request);
+        const headers = this.buildHeaders(request, originalUrl, upstreamBase);
+        let upstreamResponse;
+        try {
+            upstreamResponse = await this.fetchImpl(target.toString(), {
+                method: (request.method ?? 'GET').toUpperCase(),
+                headers,
+                body: body?.length ? body : undefined,
+            });
+        }
+        catch (error) {
+            this.logger.error(`Proxy request to ${target.toString()} failed: ${error.message}`);
+            throw new community_server_2.InternalServerError('Failed to proxy edge node request.', { cause: error });
+        }
+        response.statusCode = upstreamResponse.status;
+        response.setHeader('X-Xpod-Edge-Node', node.nodeId);
+        upstreamResponse.headers.forEach((value, key) => {
+            if (key.toLowerCase() === 'transfer-encoding' && value === 'chunked') {
+                return;
+            }
+            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(`Edge proxy stream error: ${error.message}`);
+            response.destroy(error);
+        });
+        readable.pipe(response);
+    }
+    resolveUpstream(metadata) {
+        const tunnel = metadata?.tunnel;
+        if (tunnel && typeof tunnel === 'object') {
+            const entrypoint = tunnel.entrypoint;
+            if (typeof entrypoint === 'string' && entrypoint.trim().length > 0) {
+                return entrypoint;
+            }
+        }
+        if (typeof metadata?.publicAddress === 'string') {
+            return metadata.publicAddress;
+        }
+        return undefined;
+    }
+    buildHeaders(request, original, upstream) {
+        const headers = new Headers();
+        for (const [name, value] of Object.entries(request.headers)) {
+            if (value === undefined) {
+                continue;
+            }
+            if (name.toLowerCase() === 'host') {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                headers.set(name, value.join(','));
+            }
+            else {
+                headers.set(name, value);
+            }
+        }
+        headers.set('host', upstream.host);
+        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);
+        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;
+    }
+    readBody(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);
+        });
+    }
+    extractHostname(request) {
+        const hostHeader = request.headers.host ?? request.headers.Host;
+        if (typeof hostHeader !== 'string') {
+            return undefined;
+        }
+        const hostname = hostHeader.split(':')[0];
+        return hostname.trim().toLowerCase();
+    }
+    writeOptions(response) {
+        response.statusCode = 204;
+        response.setHeader('Allow', 'GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS');
+        response.end();
+    }
+    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() ?? 'http' : 'http';
+        const rawUrl = request.url ?? '/';
+        return new URL(rawUrl, `${scheme}://${hostHeader}`);
+    }
+    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;
+    }
+    normalizeMode(mode) {
+        if (!mode) {
+            return undefined;
+        }
+        const normalized = mode.trim().toLowerCase();
+        if (normalized === 'proxy') {
+            return 'proxy';
+        }
+        return undefined;
+    }
+}
+exports.EdgeNodeProxyHttpHandler = EdgeNodeProxyHttpHandler;
+//# sourceMappingURL=EdgeNodeProxyHttpHandler.js.map

package/dist/http/EdgeNodeProxyHttpHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeProxyHttpHandler.js","sourceRoot":"","sources":["../../src/http/EdgeNodeProxyHttpHandler.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  BadRequestHttpError,\n  InternalServerError,\n  MethodNotAllowedHttpError,\n  NotImplementedHttpError,\n  \n} from '@solid/community-server';\nimport { getIdentityDatabase } from '../identity/drizzle/db';\nimport { EdgeNodeRepository } from '../identity/drizzle/EdgeNodeRepository';\n\ninterface EdgeNodeProxyHttpHandlerOptions {\n  identityDbUrl: string;\n  edgeNodesEnabled?: string | boolean;\n  repository?: EdgeNodeRepository;\n  fetchImpl?: any;\n}\n\ninterface ProxyNode {\n  nodeId: string;\n  metadata?: Record<string, unknown> | null;\n}\n\nexport class EdgeNodeProxyHttpHandler extends HttpHandler {\n  protected readonly logger = getLoggerFor(this);\n  private readonly repo: EdgeNodeRepository;\n  private readonly enabled: boolean;\n  private readonly fetchImpl: any;\n\n  public constructor(options: EdgeNodeProxyHttpHandlerOptions) {\n    super();\n    this.repo = options.repository ?? new EdgeNodeRepository(getIdentityDatabase(options.identityDbUrl));\n    this.enabled = this.normalizeBoolean(options.edgeNodesEnabled);\n    this.fetchImpl = options.fetchImpl ?? fetch;\n  }\n\n  public override async canHandle({ request }: HttpHandlerInput): Promise<void> {\n    if (!this.enabled) {\n      throw new NotImplementedHttpError('Edge proxy disabled.');\n    }\n    const hostname = this.extractHostname(request);\n    if (!hostname) {\n      throw new NotImplementedHttpError('Missing Host header.');\n    }\n    const node = await this.repo.findNodeBySubdomain(hostname);\n    const mode = this.normalizeMode(node?.accessMode);\n    if (!node || mode !== 'proxy') {\n      throw new NotImplementedHttpError('Not a proxy edge node request.');\n    }\n  }\n\n  public override async handle({ request, response }: HttpHandlerInput): Promise<void> {\n    if ((request.method ?? 'GET').toUpperCase() === 'OPTIONS') {\n      this.writeOptions(response);\n      return;\n    }\n    if ((request.method ?? 'GET').toUpperCase() === 'CONNECT') {\n      throw new MethodNotAllowedHttpError([ 'GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS' ]);\n    }\n    const hostname = this.extractHostname(request);\n    if (!hostname) {\n      throw new BadRequestHttpError('Host header required.');\n    }\n    const node = await this.repo.findNodeBySubdomain(hostname);\n    const mode = this.normalizeMode(node?.accessMode);\n    if (!node || mode !== 'proxy') {\n      throw new NotImplementedHttpError('Not a proxy edge node request.');\n    }\n    await this.forwardRequest(node, request, response);\n  }\n\n  private async forwardRequest(node: ProxyNode, request: IncomingMessage, response: HttpResponse): Promise<void> {\n    const metadata = node.metadata ?? undefined;\n    const upstream = this.resolveUpstream(metadata);\n    if (!upstream) {\n      throw new InternalServerError('Edge node tunnel is not ready.');\n    }\n\n    const upstreamBase = new URL(upstream);\n    const originalUrl = this.parseUrl(request);\n    const target = new URL(originalUrl.pathname + originalUrl.search, upstreamBase);\n    target.hash = originalUrl.hash;\n\n    const body = await this.readBody(request);\n    const headers = this.buildHeaders(request, originalUrl, upstreamBase);\n\n    let upstreamResponse: Response;\n    try {\n      upstreamResponse = await this.fetchImpl(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: ${(error as Error).message}`);\n      throw new InternalServerError('Failed to proxy edge node request.', { cause: error });\n    }\n\n    response.statusCode = upstreamResponse.status;\n    response.setHeader('X-Xpod-Edge-Node', node.nodeId);\n    upstreamResponse.headers.forEach((value, key) => {\n      if (key.toLowerCase() === 'transfer-encoding' && value === 'chunked') {\n        return;\n      }\n      response.setHeader(key, value);\n    });\n\n    if (!upstreamResponse.body) {\n      response.end();\n      return;\n    }\n    const readable = Readable.from(upstreamResponse.body as any);\n    readable.on('error', (error) => {\n      this.logger.error(`Edge proxy stream error: ${(error as Error).message}`);\n      response.destroy(error as Error);\n    });\n    readable.pipe(response);\n  }\n\n  private resolveUpstream(metadata?: Record<string, unknown> | null): string | undefined {\n    const tunnel = metadata?.tunnel;\n    if (tunnel && typeof tunnel === 'object') {\n      const entrypoint = (tunnel as Record<string, unknown>).entrypoint;\n      if (typeof entrypoint === 'string' && entrypoint.trim().length > 0) {\n        return entrypoint;\n      }\n    }\n    if (typeof metadata?.publicAddress === 'string') {\n      return metadata.publicAddress;\n    }\n    return undefined;\n  }\n\n  private buildHeaders(request: IncomingMessage, original: URL, upstream: URL): Headers {\n    const headers = new Headers();\n    for (const [ name, value ] of Object.entries(request.headers)) {\n      if (value === undefined) {\n        continue;\n      }\n      if (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    headers.set('host', upstream.host);\n    headers.set('x-forwarded-host', original.host);\n    headers.set('x-forwarded-proto', original.protocol.replace(/:$/u, ''));\n    const port = original.port || (original.protocol === 'https:' ? '443' : '80');\n    headers.set('x-forwarded-port', port);\n    const remoteAddress = (request.socket as any)?.remoteAddress;\n    if (remoteAddress) {\n      const existing = headers.get('x-forwarded-for');\n      headers.set('x-forwarded-for', existing ? `${existing}, ${remoteAddress}` : remoteAddress);\n    }\n    return headers;\n  }\n\n  private readBody(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    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  private extractHostname(request: IncomingMessage): string | undefined {\n    const hostHeader = request.headers.host ?? request.headers.Host;\n    if (typeof hostHeader !== 'string') {\n      return undefined;\n    }\n    const hostname = hostHeader.split(':')[0];\n    return hostname.trim().toLowerCase();\n  }\n\n  private writeOptions(response: HttpResponse): void {\n    response.statusCode = 204;\n    response.setHeader('Allow', 'GET,HEAD,POST,PUT,PATCH,DELETE,OPTIONS');\n    response.end();\n  }\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() ?? 'http' : 'http';\n    const rawUrl = request.url ?? '/';\n    return new URL(rawUrl, `${scheme}://${hostHeader}`);\n  }\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  private normalizeMode(mode: string | undefined): 'proxy' | undefined {\n    if (!mode) {\n      return undefined;\n    }\n    const normalized = mode.trim().toLowerCase();\n    if (normalized === 'proxy') {\n      return 'proxy';\n    }\n    return undefined;\n  }\n}\n"]}

package/dist/http/EdgeNodeProxyHttpHandler.jsonld

@@ -0,0 +1,162 @@
+{
+  "@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/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler",
+      "@type": "Class",
+      "requireElement": "EdgeNodeProxyHttpHandler",
+      "extends": [
+        "css:dist/server/HttpHandler.jsonld#HttpHandler"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_identityDbUrl",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_edgeNodesEnabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_repository",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "undefineds:dist/identity/drizzle/EdgeNodeRepository.jsonld#EdgeNodeRepository",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_fetchImpl",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_logger",
+          "memberFieldName": "logger",
+          "range": {
+            "@type": "ParameterRangeWildcard"
+          }
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_repo",
+          "memberFieldName": "repo"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_fetchImpl",
+          "memberFieldName": "fetchImpl"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_canHandle",
+          "memberFieldName": "canHandle"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_handle",
+          "memberFieldName": "handle"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_forwardRequest",
+          "memberFieldName": "forwardRequest"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_resolveUpstream",
+          "memberFieldName": "resolveUpstream"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_buildHeaders",
+          "memberFieldName": "buildHeaders"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_readBody",
+          "memberFieldName": "readBody"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_extractHostname",
+          "memberFieldName": "extractHostname"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_writeOptions",
+          "memberFieldName": "writeOptions"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_parseUrl",
+          "memberFieldName": "parseUrl"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_normalizeBoolean",
+          "memberFieldName": "normalizeBoolean"
+        },
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler__member_normalizeMode",
+          "memberFieldName": "normalizeMode"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "identityDbUrl",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_identityDbUrl"
+              }
+            },
+            {
+              "keyRaw": "edgeNodesEnabled",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_edgeNodesEnabled"
+              }
+            },
+            {
+              "keyRaw": "repository",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_repository"
+              }
+            },
+            {
+              "keyRaw": "fetchImpl",
+              "value": {
+                "@id": "undefineds:dist/http/EdgeNodeProxyHttpHandler.jsonld#EdgeNodeProxyHttpHandler_options_fetchImpl"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/http/PodRoutingHttpHandler.d.ts

@@ -0,0 +1,64 @@
+import { HttpHandler } from '@solid/community-server';
+import type { HttpHandlerInput } from '@solid/community-server';
+import { PodLookupRepository } from '../identity/drizzle/PodLookupRepository';
+import { EdgeNodeRepository } from '../identity/drizzle/EdgeNodeRepository';
+interface PodRoutingHttpHandlerOptions {
+    identityDbUrl: string;
+    nodeId: string;
+    enabled?: boolean | string;
+    podLookupRepository?: PodLookupRepository;
+    edgeNodeRepository?: 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
+ */
+export declare class PodRoutingHttpHandler extends HttpHandler {
+    protected readonly logger: import("global-logger-factory").Logger<unknown>;
+    private readonly podLookupRepository;
+    private readonly edgeNodeRepository;
+    private readonly currentNodeId;
+    private readonly enabled;
+    constructor(options: PodRoutingHttpHandlerOptions);
+    canHandle({ request }: HttpHandlerInput): Promise<void>;
+    handle({ request, response }: HttpHandlerInput): Promise<void>;
+    /**
+     * Proxy request to target node.
+     */
+    private proxyRequest;
+    /**
+     * Resolve upstream endpoint from node info.
+     * For center nodes, prefer internal endpoint for intra-cluster communication.
+     */
+    private resolveUpstream;
+    /**
+     * Resolve upstream for center node using internal endpoint.
+     */
+    resolveUpstreamWithInternal(nodeId: string): Promise<string | undefined>;
+    /**
+     * Build headers for proxy request.
+     */
+    private buildProxyHeaders;
+    /**
+     * Read request body for proxy forwarding.
+     */
+    private readRequestBody;
+    /**
+     * Check if path is a system/internal path that should skip routing.
+     */
+    private isSystemPath;
+    /**
+     * Parse request URL.
+     */
+    private parseUrl;
+    /**
+     * Normalize boolean values from string/boolean.
+     */
+    private normalizeBoolean;
+}
+export {};