@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/edge/EdgeNodeTunnelManager.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NoopEdgeNodeTunnelManager = exports.SimpleEdgeNodeTunnelManager = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+class SimpleEdgeNodeTunnelManager {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.entrypoints = this.normalizeEntrypoints(options.entrypoints);
+        this.enabled = options.enabled ?? this.entrypoints.length > 0;
+    }
+    async ensureConnectivity(nodeId, metadata) {
+        if (!this.enabled || this.entrypoints.length === 0) {
+            return undefined;
+        }
+        const reachability = this.extractRecord(metadata.reachability);
+        const tunnel = this.extractRecord(metadata.tunnel);
+        const redirectStatus = typeof reachability?.status === 'string' ? reachability.status : undefined;
+        const redirectHealthy = this.isRedirectHealthy(redirectStatus, reachability);
+        if (redirectHealthy) {
+            if (tunnel?.status === 'active') {
+                const next = { ...metadata, tunnel: { ...tunnel, status: 'standby', updatedAt: new Date().toISOString() } };
+                this.logger.debug(`节点 ${nodeId} 直连恢复，将隧道标记为 standby。`);
+                return next;
+            }
+            return undefined;
+        }
+        const entrypoint = this.selectEntrypoint(nodeId, tunnel);
+        if (!entrypoint) {
+            return undefined;
+        }
+        if (tunnel?.status === 'active' && tunnel.entrypoint === entrypoint) {
+            return undefined;
+        }
+        const nextTunnel = {
+            status: 'active',
+            entrypoint,
+            updatedAt: new Date().toISOString(),
+        };
+        this.logger.info(`节点 ${nodeId} 直连不可达，启用隧道入口 ${entrypoint}`);
+        return { ...metadata, tunnel: nextTunnel };
+    }
+    selectEntrypoint(nodeId, tunnel) {
+        if (tunnel?.entrypoint && typeof tunnel.entrypoint === 'string') {
+            return tunnel.entrypoint;
+        }
+        if (this.entrypoints.length === 1) {
+            return this.entrypoints[0];
+        }
+        const hash = this.hashString(nodeId);
+        const index = hash % this.entrypoints.length;
+        return this.entrypoints[index];
+    }
+    hashString(value) {
+        let hash = 0;
+        for (const char of value) {
+            hash = (hash << 5) - hash + char.charCodeAt(0);
+            hash |= 0;
+        }
+        return Math.abs(hash);
+    }
+    extractRecord(value) {
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        return value;
+    }
+    isRedirectHealthy(status, reachability) {
+        if (!status) {
+            return false;
+        }
+        const normalized = status.trim().toLowerCase();
+        if (normalized === 'redirect' || normalized === 'healthy') {
+            return true;
+        }
+        if (normalized === 'degraded' && typeof reachability?.lastSuccessAt === 'string') {
+            const last = new Date(reachability.lastSuccessAt);
+            const diff = Date.now() - last.getTime();
+            return Number.isFinite(diff) && diff < 60_000;
+        }
+        return false;
+    }
+    normalizeEntrypoints(input) {
+        if (!input) {
+            return [];
+        }
+        const list = Array.isArray(input) ? input : input.split(/[,\s]+/u);
+        return list
+            .map((value) => value.trim())
+            .filter((value) => value.length > 0);
+    }
+}
+exports.SimpleEdgeNodeTunnelManager = SimpleEdgeNodeTunnelManager;
+class NoopEdgeNodeTunnelManager {
+    async ensureConnectivity() {
+        return undefined;
+    }
+}
+exports.NoopEdgeNodeTunnelManager = NoopEdgeNodeTunnelManager;
+//# sourceMappingURL=EdgeNodeTunnelManager.js.map

package/dist/edge/EdgeNodeTunnelManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeTunnelManager.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeTunnelManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeTunnelManager } from './interfaces/EdgeNodeTunnelManager';\n\ninterface SimpleEdgeNodeTunnelManagerOptions {\n  /** 当直连失败时兜底的入口地址列表。 */\n  entrypoints?: string | string[] | null;\n  /** 是否默认启用隧道。 */\n  enabled?: boolean;\n}\n\nexport class SimpleEdgeNodeTunnelManager implements EdgeNodeTunnelManager {\n  private readonly logger = getLoggerFor(this);\n  private readonly entrypoints: string[];\n  private readonly enabled: boolean;\n\n  public constructor(options: SimpleEdgeNodeTunnelManagerOptions) {\n    this.entrypoints = this.normalizeEntrypoints(options.entrypoints);\n    this.enabled = options.enabled ?? this.entrypoints.length > 0;\n  }\n\n  public async ensureConnectivity(nodeId: string, metadata: Record<string, unknown>): Promise<Record<string, unknown> | undefined> {\n    if (!this.enabled || this.entrypoints.length === 0) {\n      return undefined;\n    }\n\n    const reachability = this.extractRecord((metadata as any).reachability);\n    const tunnel = this.extractRecord((metadata as any).tunnel);\n\n    const redirectStatus = typeof reachability?.status === 'string' ? reachability.status : undefined;\n    const redirectHealthy = this.isRedirectHealthy(redirectStatus, reachability);\n\n    if (redirectHealthy) {\n      if (tunnel?.status === 'active') {\n        const next = { ...metadata, tunnel: { ...tunnel, status: 'standby', updatedAt: new Date().toISOString() } };\n        this.logger.debug(`节点 ${nodeId} 直连恢复，将隧道标记为 standby。`);\n        return next;\n      }\n      return undefined;\n    }\n\n    const entrypoint = this.selectEntrypoint(nodeId, tunnel);\n    if (!entrypoint) {\n      return undefined;\n    }\n\n    if (tunnel?.status === 'active' && tunnel.entrypoint === entrypoint) {\n      return undefined;\n    }\n\n    const nextTunnel = {\n      status: 'active',\n      entrypoint,\n      updatedAt: new Date().toISOString(),\n    };\n    this.logger.info(`节点 ${nodeId} 直连不可达，启用隧道入口 ${entrypoint}`);\n    return { ...metadata, tunnel: nextTunnel };\n  }\n\n  private selectEntrypoint(nodeId: string, tunnel?: Record<string, unknown>): string | undefined {\n    if (tunnel?.entrypoint && typeof tunnel.entrypoint === 'string') {\n      return tunnel.entrypoint;\n    }\n    if (this.entrypoints.length === 1) {\n      return this.entrypoints[0];\n    }\n    const hash = this.hashString(nodeId);\n    const index = hash % this.entrypoints.length;\n    return this.entrypoints[index];\n  }\n\n  private hashString(value: string): number {\n    let hash = 0;\n    for (const char of value) {\n      hash = (hash << 5) - hash + char.charCodeAt(0);\n      hash |= 0;\n    }\n    return Math.abs(hash);\n  }\n\n  private extractRecord(value: unknown): Record<string, any> | undefined {\n    if (!value || typeof value !== 'object') {\n      return undefined;\n    }\n    return value as Record<string, any>;\n  }\n\n  private isRedirectHealthy(status?: string, reachability?: Record<string, unknown>): boolean {\n    if (!status) {\n      return false;\n    }\n    const normalized = status.trim().toLowerCase();\n    if (normalized === 'redirect' || normalized === 'healthy') {\n      return true;\n    }\n    if (normalized === 'degraded' && typeof reachability?.lastSuccessAt === 'string') {\n      const last = new Date(reachability.lastSuccessAt);\n      const diff = Date.now() - last.getTime();\n      return Number.isFinite(diff) && diff < 60_000;\n    }\n    return false;\n  }\n\n  private normalizeEntrypoints(input?: string | string[] | null): string[] {\n    if (!input) {\n      return [];\n    }\n    const list = Array.isArray(input) ? input : input.split(/[,\\s]+/u);\n    return list\n      .map((value) => value.trim())\n      .filter((value) => value.length > 0);\n  }\n}\n\nexport class NoopEdgeNodeTunnelManager implements EdgeNodeTunnelManager {\n  public async ensureConnectivity(): Promise<Record<string, unknown> | undefined> {\n    return undefined;\n  }\n}\n"]}

package/dist/edge/EdgeNodeTunnelManager.jsonld

@@ -0,0 +1,128 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager",
+      "@type": "Class",
+      "requireElement": "SimpleEdgeNodeTunnelManager",
+      "extends": [
+        "undefineds:dist/edge/interfaces/EdgeNodeTunnelManager.jsonld#EdgeNodeTunnelManager"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager_options_entrypoints",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeArray",
+                "parameterRangeValue": "xsd:string"
+              },
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "当直连失败时兜底的入口地址列表。"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager_options_enabled",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          },
+          "comment": "是否默认启用隧道。"
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_entrypoints",
+          "memberFieldName": "entrypoints"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_ensureConnectivity",
+          "memberFieldName": "ensureConnectivity"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_selectEntrypoint",
+          "memberFieldName": "selectEntrypoint"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_hashString",
+          "memberFieldName": "hashString"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_extractRecord",
+          "memberFieldName": "extractRecord"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_isRedirectHealthy",
+          "memberFieldName": "isRedirectHealthy"
+        },
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager__member_normalizeEntrypoints",
+          "memberFieldName": "normalizeEntrypoints"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "entrypoints",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager_options_entrypoints"
+              }
+            },
+            {
+              "keyRaw": "enabled",
+              "value": {
+                "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#SimpleEdgeNodeTunnelManager_options_enabled"
+              }
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#NoopEdgeNodeTunnelManager",
+      "@type": "Class",
+      "requireElement": "NoopEdgeNodeTunnelManager",
+      "extends": [
+        "undefineds:dist/edge/interfaces/EdgeNodeTunnelManager.jsonld#EdgeNodeTunnelManager"
+      ],
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeTunnelManager.jsonld#NoopEdgeNodeTunnelManager__member_ensureConnectivity",
+          "memberFieldName": "ensureConnectivity"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/FrpTunnelManager.d.ts

@@ -0,0 +1,30 @@
+import type { EdgeNodeTunnelManager } from './interfaces/EdgeNodeTunnelManager';
+interface FrpTunnelManagerOptions {
+    serverHost?: string | null;
+    serverPort?: number | string | null;
+    protocol?: string | null;
+    token?: string | null;
+}
+export declare class FrpTunnelManager implements EdgeNodeTunnelManager {
+    private readonly logger;
+    private readonly enabled;
+    private readonly serverHost?;
+    private readonly serverPort?;
+    private readonly protocol;
+    private readonly token?;
+    private readonly remotePortBase;
+    private readonly remotePortStep;
+    constructor(options: FrpTunnelManagerOptions);
+    ensureConnectivity(nodeId: string, metadata: Record<string, unknown>): Promise<Record<string, unknown> | undefined>;
+    private prepareTunnel;
+    private resolveRemotePort;
+    private resolveEntrypoint;
+    private buildConfig;
+    private extractRecord;
+    private extractTunnel;
+    private isRedirectHealthy;
+    private normalizeString;
+    private normalizeNumber;
+    private hashString;
+}
+export {};

package/dist/edge/FrpTunnelManager.js

@@ -0,0 +1,151 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrpTunnelManager = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+class FrpTunnelManager {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.remotePortBase = 20000;
+        this.remotePortStep = 17;
+        this.serverHost = this.normalizeString(options.serverHost);
+        this.serverPort = this.normalizeNumber(options.serverPort);
+        this.protocol = this.normalizeString(options.protocol)?.toLowerCase() ?? 'tcp';
+        this.token = this.normalizeString(options.token);
+        this.enabled = Boolean(this.serverHost && this.token);
+        if (!this.enabled) {
+            this.logger.info('FrpTunnelManager disabled：缺少 serverHost/token 或 domain/port 配置。');
+        }
+    }
+    async ensureConnectivity(nodeId, metadata) {
+        if (!this.enabled) {
+            return undefined;
+        }
+        const reachability = this.extractRecord(metadata.reachability);
+        const existing = this.extractTunnel(metadata.tunnel);
+        const directHealthy = this.isRedirectHealthy(reachability);
+        const prepared = this.prepareTunnel(nodeId, metadata, existing);
+        if (prepared.status === 'unreachable') {
+            this.logger.warn(`节点 ${nodeId} 隧道不可用：${prepared.reason ?? '未知原因'}`);
+            return { ...metadata, tunnel: prepared };
+        }
+        if (directHealthy) {
+            if (prepared.status !== 'standby') {
+                this.logger.debug(`节点 ${nodeId} 直连可用，保持隧道 standby。`);
+            }
+            prepared.status = 'standby';
+        }
+        else {
+            if (prepared.status !== 'active') {
+                this.logger.info(`节点 ${nodeId} 直连不可用，激活 frp 隧道 ${prepared.entrypoint ?? prepared.customDomain ?? ''}`);
+            }
+            prepared.status = 'active';
+        }
+        prepared.updatedAt = new Date().toISOString();
+        return { ...metadata, tunnel: prepared };
+    }
+    prepareTunnel(nodeId, metadata, existing) {
+        const next = existing ? { ...existing } : { type: 'frp' };
+        next.serverHost = this.serverHost;
+        next.serverPort = this.serverPort;
+        next.protocol = this.protocol;
+        next.token = this.token;
+        next.proxyName = existing?.proxyName ?? nodeId;
+        if (!this.serverHost || !this.serverPort || !this.token) {
+            next.status = 'unreachable';
+            next.reason = 'FRP server config missing';
+            return next;
+        }
+        next.remotePort = this.resolveRemotePort(nodeId, metadata, existing);
+        next.entrypoint = this.resolveEntrypoint(next);
+        next.config = this.buildConfig(next);
+        return next;
+    }
+    resolveRemotePort(nodeId, metadata, existing) {
+        if (existing?.remotePort) {
+            return existing.remotePort;
+        }
+        const hash = this.hashString(nodeId);
+        return this.remotePortBase + ((hash % 1000) * this.remotePortStep);
+    }
+    resolveEntrypoint(tunnel) {
+        if (tunnel.serverHost && tunnel.remotePort) {
+            return `https://${tunnel.serverHost}:${tunnel.remotePort}`;
+        }
+        return undefined;
+    }
+    buildConfig(tunnel) {
+        const config = {
+            serverHost: this.serverHost,
+            serverPort: this.serverPort,
+            protocol: this.protocol,
+            token: this.token,
+            proxyName: tunnel.proxyName,
+        };
+        if (!tunnel.entrypoint) {
+            config.error = 'FRP entrypoint not resolved';
+        }
+        if (tunnel.remotePort) {
+            config.remotePort = tunnel.remotePort;
+            config.type = this.protocol;
+        }
+        config.publicUrl = tunnel.entrypoint;
+        return config;
+    }
+    extractRecord(value) {
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        return value;
+    }
+    extractTunnel(value) {
+        if (!value || typeof value !== 'object') {
+            return undefined;
+        }
+        const record = value;
+        return { ...record };
+    }
+    isRedirectHealthy(reachability) {
+        if (!reachability) {
+            return false;
+        }
+        const status = typeof reachability.status === 'string' ? reachability.status.trim().toLowerCase() : undefined;
+        if (status === 'redirect' || status === 'healthy') {
+            return true;
+        }
+        if (status === 'degraded' && typeof reachability.lastSuccessAt === 'string') {
+            const last = new Date(reachability.lastSuccessAt);
+            const diff = Date.now() - last.getTime();
+            return Number.isFinite(diff) && diff < 60_000;
+        }
+        return false;
+    }
+    normalizeString(value) {
+        if (typeof value !== 'string') {
+            return undefined;
+        }
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    normalizeNumber(value) {
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number(value.trim());
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
+    hashString(input) {
+        let hash = 0;
+        for (const char of input) {
+            hash = (hash << 5) - hash + char.charCodeAt(0);
+            hash |= 0;
+        }
+        return Math.abs(hash);
+    }
+}
+exports.FrpTunnelManager = FrpTunnelManager;
+//# sourceMappingURL=FrpTunnelManager.js.map

package/dist/edge/FrpTunnelManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrpTunnelManager.js","sourceRoot":"","sources":["../../src/edge/FrpTunnelManager.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type { EdgeNodeTunnelManager } from './interfaces/EdgeNodeTunnelManager';\n\ninterface FrpTunnelManagerOptions {\n  serverHost?: string | null;\n  serverPort?: number | string | null;\n  protocol?: string | null;\n  token?: string | null;\n}\n\ninterface TunnelMetadata {\n  status?: string;\n  entrypoint?: string;\n  type?: string;\n  proxyName?: string;\n  remotePort?: number;\n  customDomain?: string;\n  serverHost?: string;\n  serverPort?: number;\n  protocol?: string;\n  token?: string;\n  updatedAt?: string;\n  config?: Record<string, unknown>;\n  reason?: string;\n}\n\nexport class FrpTunnelManager implements EdgeNodeTunnelManager {\n  private readonly logger = getLoggerFor(this);\n  private readonly enabled: boolean;\n  private readonly serverHost?: string;\n  private readonly serverPort?: number;\n  private readonly protocol: string;\n  private readonly token?: string;\n  private readonly remotePortBase = 20000;\n  private readonly remotePortStep = 17;\n\n  public constructor(options: FrpTunnelManagerOptions) {\n    this.serverHost = this.normalizeString(options.serverHost);\n    this.serverPort = this.normalizeNumber(options.serverPort);\n    this.protocol = this.normalizeString(options.protocol)?.toLowerCase() ?? 'tcp';\n    this.token = this.normalizeString(options.token);\n    this.enabled = Boolean(this.serverHost && this.token);\n    if (!this.enabled) {\n      this.logger.info('FrpTunnelManager disabled：缺少 serverHost/token 或 domain/port 配置。');\n    }\n  }\n\n  public async ensureConnectivity(nodeId: string, metadata: Record<string, unknown>): Promise<Record<string, unknown> | undefined> {\n    if (!this.enabled) {\n      return undefined;\n    }\n    const reachability = this.extractRecord(metadata.reachability);\n    const existing = this.extractTunnel(metadata.tunnel);\n    const directHealthy = this.isRedirectHealthy(reachability);\n\n    const prepared = this.prepareTunnel(nodeId, metadata, existing);\n\n    if (prepared.status === 'unreachable') {\n      this.logger.warn(`节点 ${nodeId} 隧道不可用：${prepared.reason ?? '未知原因'}`);\n      return { ...metadata, tunnel: prepared };\n    }\n\n    if (directHealthy) {\n      if (prepared.status !== 'standby') {\n        this.logger.debug(`节点 ${nodeId} 直连可用，保持隧道 standby。`);\n      }\n      prepared.status = 'standby';\n    } else {\n      if (prepared.status !== 'active') {\n        this.logger.info(`节点 ${nodeId} 直连不可用，激活 frp 隧道 ${prepared.entrypoint ?? prepared.customDomain ?? ''}`);\n      }\n      prepared.status = 'active';\n    }\n\n    prepared.updatedAt = new Date().toISOString();\n    return { ...metadata, tunnel: prepared };\n  }\n\n  private prepareTunnel(nodeId: string, metadata: Record<string, unknown>, existing?: TunnelMetadata): TunnelMetadata {\n    const next: TunnelMetadata = existing ? { ...existing } : { type: 'frp' };\n    next.serverHost = this.serverHost;\n    next.serverPort = this.serverPort;\n    next.protocol = this.protocol;\n    next.token = this.token;\n    next.proxyName = existing?.proxyName ?? nodeId;\n    if (!this.serverHost || !this.serverPort || !this.token) {\n      next.status = 'unreachable';\n      next.reason = 'FRP server config missing';\n      return next;\n    }\n    next.remotePort = this.resolveRemotePort(nodeId, metadata, existing);\n    next.entrypoint = this.resolveEntrypoint(next);\n    next.config = this.buildConfig(next);\n    return next;\n  }\n\n  private resolveRemotePort(nodeId: string, metadata: Record<string, unknown>, existing?: TunnelMetadata): number | undefined {\n    if (existing?.remotePort) {\n      return existing.remotePort;\n    }\n    const hash = this.hashString(nodeId);\n    return this.remotePortBase + ((hash % 1000) * this.remotePortStep);\n  }\n\n  private resolveEntrypoint(tunnel: TunnelMetadata): string | undefined {\n    if (tunnel.serverHost && tunnel.remotePort) {\n      return `https://${tunnel.serverHost}:${tunnel.remotePort}`;\n    }\n    return undefined;\n  }\n\n  private buildConfig(tunnel: TunnelMetadata): Record<string, unknown> {\n    const config: Record<string, unknown> = {\n      serverHost: this.serverHost,\n      serverPort: this.serverPort,\n      protocol: this.protocol,\n      token: this.token,\n      proxyName: tunnel.proxyName,\n    };\n    if (!tunnel.entrypoint) {\n      config.error = 'FRP entrypoint not resolved';\n    }\n    if (tunnel.remotePort) {\n      config.remotePort = tunnel.remotePort;\n      config.type = this.protocol;\n    }\n    config.publicUrl = tunnel.entrypoint;\n    return config;\n  }\n\n  private extractRecord(value: unknown): Record<string, any> | undefined {\n    if (!value || typeof value !== 'object') {\n      return undefined;\n    }\n    return value as Record<string, any>;\n  }\n\n  private extractTunnel(value: unknown): TunnelMetadata | undefined {\n    if (!value || typeof value !== 'object') {\n      return undefined;\n    }\n    const record = value as any;\n    return { ...record } as TunnelMetadata;\n  }\n\n  private isRedirectHealthy(reachability?: Record<string, unknown>): boolean {\n    if (!reachability) {\n      return false;\n    }\n    const status = typeof reachability.status === 'string' ? reachability.status.trim().toLowerCase() : undefined;\n    if (status === 'redirect' || status === 'healthy') {\n      return true;\n    }\n    if (status === 'degraded' && typeof reachability.lastSuccessAt === 'string') {\n      const last = new Date(reachability.lastSuccessAt);\n      const diff = Date.now() - last.getTime();\n      return Number.isFinite(diff) && diff < 60_000;\n    }\n    return false;\n  }\n\n  private normalizeString(value?: string | null): string | undefined {\n    if (typeof value !== 'string') {\n      return undefined;\n    }\n    const trimmed = value.trim();\n    return trimmed.length > 0 ? trimmed : undefined;\n  }\n\n  private normalizeNumber(value?: number | string | null): number | undefined {\n    if (typeof value === 'number' && Number.isFinite(value)) {\n      return value;\n    }\n    if (typeof value === 'string') {\n      const parsed = Number(value.trim());\n      if (Number.isFinite(parsed)) {\n        return parsed;\n      }\n    }\n    return undefined;\n  }\n\n  private hashString(input: string): number {\n    let hash = 0;\n    for (const char of input) {\n      hash = (hash << 5) - hash + char.charCodeAt(0);\n      hash |= 0;\n    }\n    return Math.abs(hash);\n  }\n}\n"]}

package/dist/edge/FrpTunnelManager.jsonld

@@ -0,0 +1,192 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager",
+      "@type": "Class",
+      "requireElement": "FrpTunnelManager",
+      "extends": [
+        "undefineds:dist/edge/interfaces/EdgeNodeTunnelManager.jsonld#EdgeNodeTunnelManager"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_serverHost",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_serverPort",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:number",
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_protocol",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_token",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeWildcard"
+              },
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_logger",
+          "memberFieldName": "logger"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_enabled",
+          "memberFieldName": "enabled"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_serverHost",
+          "memberFieldName": "serverHost"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_serverPort",
+          "memberFieldName": "serverPort"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_protocol",
+          "memberFieldName": "protocol"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_token",
+          "memberFieldName": "token"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_remotePortBase",
+          "memberFieldName": "remotePortBase"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_remotePortStep",
+          "memberFieldName": "remotePortStep"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_ensureConnectivity",
+          "memberFieldName": "ensureConnectivity"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_prepareTunnel",
+          "memberFieldName": "prepareTunnel"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_resolveRemotePort",
+          "memberFieldName": "resolveRemotePort"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_resolveEntrypoint",
+          "memberFieldName": "resolveEntrypoint"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_buildConfig",
+          "memberFieldName": "buildConfig"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_extractRecord",
+          "memberFieldName": "extractRecord"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_extractTunnel",
+          "memberFieldName": "extractTunnel"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_isRedirectHealthy",
+          "memberFieldName": "isRedirectHealthy"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_normalizeString",
+          "memberFieldName": "normalizeString"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_normalizeNumber",
+          "memberFieldName": "normalizeNumber"
+        },
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager__member_hashString",
+          "memberFieldName": "hashString"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "serverHost",
+              "value": {
+                "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_serverHost"
+              }
+            },
+            {
+              "keyRaw": "serverPort",
+              "value": {
+                "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_serverPort"
+              }
+            },
+            {
+              "keyRaw": "protocol",
+              "value": {
+                "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_protocol"
+              }
+            },
+            {
+              "keyRaw": "token",
+              "value": {
+                "@id": "undefineds:dist/edge/FrpTunnelManager.jsonld#FrpTunnelManager_options_token"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}