@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/edge/EdgeNodeCapabilityDetector.d.ts

@@ -0,0 +1,98 @@
+import { NodeCapabilities } from './EdgeNodeModeDetector';
+/**
+ * 网络地址检测结果
+ */
+export interface NetworkAddressInfo {
+    ipv4?: string;
+    ipv6?: string;
+    ipv4Public?: string;
+    ipv6Public?: string;
+    hasPublicIPv6: boolean;
+}
+/**
+ * 边缘节点能力检测器
+ * 负责检测和报告节点的各种能力信息
+ */
+export interface EdgeNodeCapabilityDetectorOptions {
+    /**
+     * 基础能力配置，可以通过配置文件或环境变量设置
+     */
+    baseCapabilities?: Partial<NodeCapabilities>;
+    /**
+     * 动态检测选项
+     */
+    dynamicDetection?: {
+        enableBandwidthTest?: boolean;
+        enableLocationDetection?: boolean;
+        enableNetworkDetection?: boolean;
+        bandwidthTestUrl?: string;
+        locationServiceUrl?: string;
+        ipv4ServiceUrl?: string;
+        ipv6ServiceUrl?: string;
+    };
+}
+export declare class EdgeNodeCapabilityDetector {
+    private readonly logger;
+    private readonly baseCapabilities;
+    private readonly dynamicDetection;
+    constructor(options?: EdgeNodeCapabilityDetectorOptions);
+    /**
+     * 检测并返回完整的节点能力信息
+     */
+    detectCapabilities(): Promise<NodeCapabilities>;
+    /**
+     * 检测Solid协议版本
+     */
+    private detectSolidProtocolVersion;
+    /**
+     * 检测存储后端类型
+     */
+    private detectStorageBackends;
+    /**
+     * 检测支持的认证方法
+     */
+    private detectAuthMethods;
+    /**
+     * 动态检测网络带宽（简化版本）
+     */
+    private detectBandwidth;
+    /**
+     * 动态检测地理位置信息
+     */
+    private detectLocation;
+    /**
+     * 将NodeCapabilities转换为字符串数组（用于向后兼容）
+     */
+    static capabilitiesToStringArray(capabilities: NodeCapabilities): string[];
+    /**
+     * 从字符串数组解析NodeCapabilities（用于向后兼容）
+     */
+    static parseCapabilitiesFromStringArray(capabilityStrings: string[]): Partial<NodeCapabilities>;
+    /**
+     * 检测网络地址信息（IPv4/IPv6）
+     */
+    detectNetworkAddresses(): Promise<NetworkAddressInfo>;
+    /**
+     * 判断是否为全球单播 IPv6 地址 (2xxx: 或 3xxx:)
+     */
+    private isGlobalIpv6;
+    /**
+     * 检测本地网卡地址
+     */
+    private detectLocalNetworkAddresses;
+    /**
+     * 通过外部服务检测公网 IPv4 地址
+     */
+    private detectPublicIPv4;
+    /**
+     * 通过外部服务检测公网 IPv6 地址
+     */
+    private detectPublicIPv6;
+    /**
+     * 测试 IPv6 地址是否可从外部访问
+     * @param ipv6 要测试的 IPv6 地址
+     * @param port 要测试的端口
+     * @param timeoutMs 超时时间（毫秒）
+     */
+    testIPv6Reachability(ipv6: string, port: number, timeoutMs?: number): Promise<boolean>;
+}

package/dist/edge/EdgeNodeCapabilityDetector.js

@@ -0,0 +1,425 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdgeNodeCapabilityDetector = void 0;
+const os = __importStar(require("node:os"));
+const global_logger_factory_1 = require("global-logger-factory");
+class EdgeNodeCapabilityDetector {
+    constructor(options = {}) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.baseCapabilities = options.baseCapabilities ?? {};
+        this.dynamicDetection = {
+            enableBandwidthTest: false,
+            enableLocationDetection: false,
+            enableNetworkDetection: true,
+            ipv4ServiceUrl: 'https://4.ipw.cn/api/ip/myip?json',
+            ipv6ServiceUrl: 'https://6.ipw.cn/api/ip/myip?json',
+            ...options.dynamicDetection,
+        };
+    }
+    /**
+     * 检测并返回完整的节点能力信息
+     */
+    async detectCapabilities() {
+        const capabilities = {
+            ...this.baseCapabilities,
+        };
+        try {
+            // 检测固体协议版本
+            if (!capabilities.solidProtocolVersion) {
+                capabilities.solidProtocolVersion = this.detectSolidProtocolVersion();
+            }
+            // 检测存储后端
+            if (!capabilities.storageBackends) {
+                capabilities.storageBackends = this.detectStorageBackends();
+            }
+            // 检测认证方法
+            if (!capabilities.authMethods) {
+                capabilities.authMethods = this.detectAuthMethods();
+            }
+            // 动态检测带宽
+            if (this.dynamicDetection.enableBandwidthTest && !capabilities.maxBandwidth) {
+                capabilities.maxBandwidth = await this.detectBandwidth();
+            }
+            // 动态检测位置
+            if (this.dynamicDetection.enableLocationDetection && !capabilities.location) {
+                capabilities.location = await this.detectLocation();
+            }
+            this.logger.debug(`Node capabilities detected successfully: ${JSON.stringify(capabilities)}`);
+            return capabilities;
+        }
+        catch (error) {
+            this.logger.error(`Failed to detect node capabilities: ${error.message}`);
+            // 返回基础能力，即使检测失败
+            return capabilities;
+        }
+    }
+    /**
+     * 检测Solid协议版本
+     */
+    detectSolidProtocolVersion() {
+        // 这里可以根据实际使用的Community Solid Server版本来确定
+        // 或者从package.json中获取CSS版本
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const cssPackage = require('@solid/community-server/package.json');
+            return `solid-0.11-css-${cssPackage.version}`;
+        }
+        catch {
+            return 'solid-0.11';
+        }
+    }
+    /**
+     * 检测存储后端类型
+     */
+    detectStorageBackends() {
+        const backends = [];
+        // 检测文件系统后端
+        try {
+            const fs = require('fs');
+            if (fs.existsSync) {
+                backends.push('filesystem');
+            }
+        }
+        catch {
+            // 忽略检测失败
+        }
+        // 检测S3/MinIO后端（通过环境变量）
+        if (process.env.XPOD_STORAGE_S3_ENDPOINT || process.env.MINIO_ENDPOINT) {
+            backends.push('s3-compatible');
+        }
+        // 检测数据库后端
+        if (process.env.CSS_DATABASE_URL || process.env.POSTGRES_URL) {
+            backends.push('database');
+        }
+        return backends.length > 0 ? backends : ['filesystem'];
+    }
+    /**
+     * 检测支持的认证方法
+     */
+    detectAuthMethods() {
+        const methods = [];
+        // 基础认证方法
+        methods.push('webid', 'client-credentials');
+        // 检测是否支持OIDC
+        if (process.env.CSS_IDP_ENABLED !== 'false') {
+            methods.push('oidc');
+        }
+        // 检测是否支持UMA
+        if (process.env.CSS_UMA_ENABLED === 'true') {
+            methods.push('uma');
+        }
+        return methods;
+    }
+    /**
+     * 动态检测网络带宽（简化版本）
+     */
+    async detectBandwidth() {
+        if (!this.dynamicDetection.bandwidthTestUrl) {
+            return undefined;
+        }
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 10000); // 10秒超时
+            const startTime = Date.now();
+            const response = await fetch(this.dynamicDetection.bandwidthTestUrl, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                return undefined;
+            }
+            const data = await response.arrayBuffer();
+            const duration = (Date.now() - startTime) / 1000; // 转为秒
+            const sizeInBits = data.byteLength * 8;
+            const bandwidthBps = sizeInBits / duration;
+            // 返回Mbps，保留2位小数
+            return Math.round((bandwidthBps / 1_000_000) * 100) / 100;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 动态检测地理位置信息
+     */
+    async detectLocation() {
+        if (!this.dynamicDetection.locationServiceUrl) {
+            return undefined;
+        }
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000); // 5秒超时
+            const response = await fetch(this.dynamicDetection.locationServiceUrl, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                return undefined;
+            }
+            const data = await response.json();
+            // 假设返回的数据格式类似 ipinfo.io 或 geoip 服务
+            return {
+                country: data.country,
+                region: data.region ?? data.regionName,
+                coordinates: data.lat && data.lon ? {
+                    lat: Number(data.lat),
+                    lon: Number(data.lon),
+                } : undefined,
+            };
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * 将NodeCapabilities转换为字符串数组（用于向后兼容）
+     */
+    static capabilitiesToStringArray(capabilities) {
+        const result = [];
+        if (capabilities.solidProtocolVersion) {
+            result.push(`solid:${capabilities.solidProtocolVersion}`);
+        }
+        if (capabilities.storageBackends && capabilities.storageBackends.length > 0) {
+            result.push(...capabilities.storageBackends.map(backend => `storage:${backend}`));
+        }
+        if (capabilities.authMethods && capabilities.authMethods.length > 0) {
+            result.push(...capabilities.authMethods.map(method => `auth:${method}`));
+        }
+        if (capabilities.maxBandwidth !== undefined) {
+            result.push(`bandwidth:${capabilities.maxBandwidth}mbps`);
+        }
+        if (capabilities.location) {
+            if (capabilities.location.country) {
+                result.push(`location:${capabilities.location.country}`);
+            }
+            if (capabilities.location.region) {
+                result.push(`region:${capabilities.location.region}`);
+            }
+        }
+        return result;
+    }
+    /**
+     * 从字符串数组解析NodeCapabilities（用于向后兼容）
+     */
+    static parseCapabilitiesFromStringArray(capabilityStrings) {
+        const capabilities = {
+            storageBackends: [],
+            authMethods: [],
+        };
+        for (const capability of capabilityStrings) {
+            const [type, value] = capability.split(':', 2);
+            switch (type) {
+                case 'solid':
+                    capabilities.solidProtocolVersion = value;
+                    break;
+                case 'storage':
+                    if (value && capabilities.storageBackends) {
+                        capabilities.storageBackends.push(value);
+                    }
+                    break;
+                case 'auth':
+                    if (value && capabilities.authMethods) {
+                        capabilities.authMethods.push(value);
+                    }
+                    break;
+                case 'bandwidth':
+                    if (value.endsWith('mbps')) {
+                        const bandwidth = Number(value.slice(0, -4));
+                        if (!isNaN(bandwidth)) {
+                            capabilities.maxBandwidth = bandwidth;
+                        }
+                    }
+                    break;
+                case 'location':
+                    if (value) {
+                        capabilities.location = capabilities.location ?? {};
+                        capabilities.location.country = value;
+                    }
+                    break;
+                case 'region':
+                    if (value) {
+                        capabilities.location = capabilities.location ?? {};
+                        capabilities.location.region = value;
+                    }
+                    break;
+            }
+        }
+        // 清理空数组
+        if (capabilities.storageBackends?.length === 0) {
+            delete capabilities.storageBackends;
+        }
+        if (capabilities.authMethods?.length === 0) {
+            delete capabilities.authMethods;
+        }
+        return capabilities;
+    }
+    /**
+     * 检测网络地址信息（IPv4/IPv6）
+     */
+    async detectNetworkAddresses() {
+        const result = {
+            hasPublicIPv6: false,
+        };
+        // 1. 检测本地网卡地址
+        const localAddresses = this.detectLocalNetworkAddresses();
+        result.ipv4 = localAddresses.ipv4;
+        result.ipv6 = localAddresses.ipv6;
+        // 2. 通过外部服务检测公网地址
+        if (this.dynamicDetection.enableNetworkDetection) {
+            const [publicIPv4, publicIPv6] = await Promise.all([
+                this.detectPublicIPv4(),
+                this.detectPublicIPv6(),
+            ]);
+            result.ipv4Public = publicIPv4;
+            result.ipv6Public = publicIPv6;
+            // 如果外部探测失败，但本地网卡有全球 IPv6 地址，则作为 fallback
+            if (!result.ipv6Public && result.ipv6 && this.isGlobalIpv6(result.ipv6)) {
+                result.ipv6Public = result.ipv6;
+            }
+            result.hasPublicIPv6 = !!result.ipv6Public && result.ipv6Public.includes(':');
+        }
+        this.logger.debug(`Network addresses detected: ${JSON.stringify(result)}`);
+        return result;
+    }
+    /**
+     * 判断是否为全球单播 IPv6 地址 (2xxx: 或 3xxx:)
+     */
+    isGlobalIpv6(address) {
+        const firstChar = address.toLowerCase()[0];
+        return firstChar === '2' || firstChar === '3';
+    }
+    /**
+     * 检测本地网卡地址
+     */
+    detectLocalNetworkAddresses() {
+        const result = {};
+        const interfaces = os.networkInterfaces();
+        for (const name of Object.keys(interfaces)) {
+            const addrs = interfaces[name];
+            if (!addrs)
+                continue;
+            for (const addr of addrs) {
+                if (addr.internal)
+                    continue;
+                // 获取第一个非内部 IPv4 地址
+                if (addr.family === 'IPv4' && !result.ipv4) {
+                    result.ipv4 = addr.address;
+                }
+                // 获取第一个全局 IPv6 地址
+                if (addr.family === 'IPv6' && !result.ipv6) {
+                    const address = addr.address.toLowerCase();
+                    // 排除链路本地 (fe80:), 唯一本地 (fc00:, fd00:), 组播 (ff00:)
+                    if (!address.startsWith('fe80:') &&
+                        !address.startsWith('fc') &&
+                        !address.startsWith('fd') &&
+                        !address.startsWith('ff')) {
+                        result.ipv6 = addr.address;
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    /**
+     * 通过外部服务检测公网 IPv4 地址
+     */
+    async detectPublicIPv4() {
+        const url = this.dynamicDetection.ipv4ServiceUrl;
+        if (!url)
+            return undefined;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok)
+                return undefined;
+            const data = await response.json();
+            // 验证是 IPv4 格式
+            if (data.ip && /^\d{1,3}(\.\d{1,3}){3}$/.test(data.ip)) {
+                return data.ip;
+            }
+        }
+        catch {
+            this.logger.debug('Failed to detect public IPv4 address');
+        }
+        return undefined;
+    }
+    /**
+     * 通过外部服务检测公网 IPv6 地址
+     */
+    async detectPublicIPv6() {
+        const url = this.dynamicDetection.ipv6ServiceUrl;
+        if (!url)
+            return undefined;
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), 5000);
+            const response = await fetch(url, {
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok)
+                return undefined;
+            const data = await response.json();
+            // 验证是 IPv6 格式（包含冒号）
+            if (data.ip && data.ip.includes(':')) {
+                return data.ip;
+            }
+        }
+        catch {
+            this.logger.debug('Failed to detect public IPv6 address');
+        }
+        return undefined;
+    }
+    /**
+     * 测试 IPv6 地址是否可从外部访问
+     * @param ipv6 要测试的 IPv6 地址
+     * @param port 要测试的端口
+     * @param timeoutMs 超时时间（毫秒）
+     */
+    async testIPv6Reachability(ipv6, port, timeoutMs = 5000) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            // 尝试通过外部服务检测可达性
+            // 这里使用简单的 TCP 连接测试
+            const response = await fetch(`http://[${ipv6}]:${port}/`, {
+                method: 'HEAD',
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response.ok || response.status < 500;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.EdgeNodeCapabilityDetector = EdgeNodeCapabilityDetector;
+//# sourceMappingURL=EdgeNodeCapabilityDetector.js.map

package/dist/edge/EdgeNodeCapabilityDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeCapabilityDetector.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeCapabilityDetector.ts"],"names":[],"mappings":"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","sourcesContent":["import * as os from 'node:os';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { NodeCapabilities } from './EdgeNodeModeDetector';\n\n/**\n * 网络地址检测结果\n */\nexport interface NetworkAddressInfo {\n  ipv4?: string;\n  ipv6?: string;\n  ipv4Public?: string;\n  ipv6Public?: string;\n  hasPublicIPv6: boolean;\n}\n\n/**\n * 边缘节点能力检测器\n * 负责检测和报告节点的各种能力信息\n */\nexport interface EdgeNodeCapabilityDetectorOptions {\n  /**\n   * 基础能力配置，可以通过配置文件或环境变量设置\n   */\n  baseCapabilities?: Partial<NodeCapabilities>;\n  \n  /**\n   * 动态检测选项\n   */\n  dynamicDetection?: {\n    enableBandwidthTest?: boolean;\n    enableLocationDetection?: boolean;\n    enableNetworkDetection?: boolean;\n    bandwidthTestUrl?: string;\n    locationServiceUrl?: string;\n    ipv4ServiceUrl?: string;\n    ipv6ServiceUrl?: string;\n  };\n}\n\nexport class EdgeNodeCapabilityDetector {\n  private readonly logger = getLoggerFor(this);\n  private readonly baseCapabilities: Partial<NodeCapabilities>;\n  private readonly dynamicDetection: NonNullable<EdgeNodeCapabilityDetectorOptions['dynamicDetection']>;\n\n  public constructor(options: EdgeNodeCapabilityDetectorOptions = {}) {\n    this.baseCapabilities = options.baseCapabilities ?? {};\n    this.dynamicDetection = {\n      enableBandwidthTest: false,\n      enableLocationDetection: false,\n      enableNetworkDetection: true,\n      ipv4ServiceUrl: 'https://4.ipw.cn/api/ip/myip?json',\n      ipv6ServiceUrl: 'https://6.ipw.cn/api/ip/myip?json',\n      ...options.dynamicDetection,\n    };\n  }\n\n  /**\n   * 检测并返回完整的节点能力信息\n   */\n  public async detectCapabilities(): Promise<NodeCapabilities> {\n    const capabilities: NodeCapabilities = {\n      ...this.baseCapabilities,\n    };\n\n    try {\n      // 检测固体协议版本\n      if (!capabilities.solidProtocolVersion) {\n        capabilities.solidProtocolVersion = this.detectSolidProtocolVersion();\n      }\n\n      // 检测存储后端\n      if (!capabilities.storageBackends) {\n        capabilities.storageBackends = this.detectStorageBackends();\n      }\n\n      // 检测认证方法\n      if (!capabilities.authMethods) {\n        capabilities.authMethods = this.detectAuthMethods();\n      }\n\n      // 动态检测带宽\n      if (this.dynamicDetection.enableBandwidthTest && !capabilities.maxBandwidth) {\n        capabilities.maxBandwidth = await this.detectBandwidth();\n      }\n\n      // 动态检测位置\n      if (this.dynamicDetection.enableLocationDetection && !capabilities.location) {\n        capabilities.location = await this.detectLocation();\n      }\n\n      this.logger.debug(`Node capabilities detected successfully: ${JSON.stringify(capabilities)}`);\n      return capabilities;\n    } catch (error: unknown) {\n      this.logger.error(`Failed to detect node capabilities: ${(error as Error).message}`);\n      // 返回基础能力，即使检测失败\n      return capabilities;\n    }\n  }\n\n  /**\n   * 检测Solid协议版本\n   */\n  private detectSolidProtocolVersion(): string {\n    // 这里可以根据实际使用的Community Solid Server版本来确定\n    // 或者从package.json中获取CSS版本\n    try {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const cssPackage = require('@solid/community-server/package.json');\n      return `solid-0.11-css-${cssPackage.version}`;\n    } catch {\n      return 'solid-0.11';\n    }\n  }\n\n  /**\n   * 检测存储后端类型\n   */\n  private detectStorageBackends(): string[] {\n    const backends: string[] = [];\n\n    // 检测文件系统后端\n    try {\n      const fs = require('fs');\n      if (fs.existsSync) {\n        backends.push('filesystem');\n      }\n    } catch {\n      // 忽略检测失败\n    }\n\n    // 检测S3/MinIO后端（通过环境变量）\n    if (process.env.XPOD_STORAGE_S3_ENDPOINT || process.env.MINIO_ENDPOINT) {\n      backends.push('s3-compatible');\n    }\n\n    // 检测数据库后端\n    if (process.env.CSS_DATABASE_URL || process.env.POSTGRES_URL) {\n      backends.push('database');\n    }\n\n    return backends.length > 0 ? backends : ['filesystem'];\n  }\n\n  /**\n   * 检测支持的认证方法\n   */\n  private detectAuthMethods(): string[] {\n    const methods: string[] = [];\n\n    // 基础认证方法\n    methods.push('webid', 'client-credentials');\n\n    // 检测是否支持OIDC\n    if (process.env.CSS_IDP_ENABLED !== 'false') {\n      methods.push('oidc');\n    }\n\n    // 检测是否支持UMA\n    if (process.env.CSS_UMA_ENABLED === 'true') {\n      methods.push('uma');\n    }\n\n    return methods;\n  }\n\n  /**\n   * 动态检测网络带宽（简化版本）\n   */\n  private async detectBandwidth(): Promise<number | undefined> {\n    if (!this.dynamicDetection.bandwidthTestUrl) {\n      return undefined;\n    }\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), 10000); // 10秒超时\n\n      const startTime = Date.now();\n      const response = await fetch(this.dynamicDetection.bandwidthTestUrl, {\n        signal: controller.signal,\n      });\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        return undefined;\n      }\n\n      const data = await response.arrayBuffer();\n      const duration = (Date.now() - startTime) / 1000; // 转为秒\n      const sizeInBits = data.byteLength * 8;\n      const bandwidthBps = sizeInBits / duration;\n\n      // 返回Mbps，保留2位小数\n      return Math.round((bandwidthBps / 1_000_000) * 100) / 100;\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * 动态检测地理位置信息\n   */\n  private async detectLocation(): Promise<NodeCapabilities['location'] | undefined> {\n    if (!this.dynamicDetection.locationServiceUrl) {\n      return undefined;\n    }\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), 5000); // 5秒超时\n\n      const response = await fetch(this.dynamicDetection.locationServiceUrl, {\n        signal: controller.signal,\n      });\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        return undefined;\n      }\n\n      const data = await response.json() as { country?: string; region?: string; regionName?: string; lat?: number; lon?: number };\n      \n      // 假设返回的数据格式类似 ipinfo.io 或 geoip 服务\n      return {\n        country: data.country,\n        region: data.region ?? data.regionName,\n        coordinates: data.lat && data.lon ? {\n          lat: Number(data.lat),\n          lon: Number(data.lon),\n        } : undefined,\n      };\n    } catch {\n      return undefined;\n    }\n  }\n\n  /**\n   * 将NodeCapabilities转换为字符串数组（用于向后兼容）\n   */\n  public static capabilitiesToStringArray(capabilities: NodeCapabilities): string[] {\n    const result: string[] = [];\n\n    if (capabilities.solidProtocolVersion) {\n      result.push(`solid:${capabilities.solidProtocolVersion}`);\n    }\n\n    if (capabilities.storageBackends && capabilities.storageBackends.length > 0) {\n      result.push(...capabilities.storageBackends.map(backend => `storage:${backend}`));\n    }\n\n    if (capabilities.authMethods && capabilities.authMethods.length > 0) {\n      result.push(...capabilities.authMethods.map(method => `auth:${method}`));\n    }\n\n    if (capabilities.maxBandwidth !== undefined) {\n      result.push(`bandwidth:${capabilities.maxBandwidth}mbps`);\n    }\n\n    if (capabilities.location) {\n      if (capabilities.location.country) {\n        result.push(`location:${capabilities.location.country}`);\n      }\n      if (capabilities.location.region) {\n        result.push(`region:${capabilities.location.region}`);\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 从字符串数组解析NodeCapabilities（用于向后兼容）\n   */\n  public static parseCapabilitiesFromStringArray(capabilityStrings: string[]): Partial<NodeCapabilities> {\n    const capabilities: Partial<NodeCapabilities> = {\n      storageBackends: [],\n      authMethods: [],\n    };\n\n    for (const capability of capabilityStrings) {\n      const [type, value] = capability.split(':', 2);\n      \n      switch (type) {\n        case 'solid':\n          capabilities.solidProtocolVersion = value;\n          break;\n        case 'storage':\n          if (value && capabilities.storageBackends) {\n            capabilities.storageBackends.push(value);\n          }\n          break;\n        case 'auth':\n          if (value && capabilities.authMethods) {\n            capabilities.authMethods.push(value);\n          }\n          break;\n        case 'bandwidth':\n          if (value.endsWith('mbps')) {\n            const bandwidth = Number(value.slice(0, -4));\n            if (!isNaN(bandwidth)) {\n              capabilities.maxBandwidth = bandwidth;\n            }\n          }\n          break;\n        case 'location':\n          if (value) {\n            capabilities.location = capabilities.location ?? {};\n            capabilities.location.country = value;\n          }\n          break;\n        case 'region':\n          if (value) {\n            capabilities.location = capabilities.location ?? {};\n            capabilities.location.region = value;\n          }\n          break;\n      }\n    }\n\n    // 清理空数组\n    if (capabilities.storageBackends?.length === 0) {\n      delete capabilities.storageBackends;\n    }\n    if (capabilities.authMethods?.length === 0) {\n      delete capabilities.authMethods;\n    }\n\n    return capabilities;\n  }\n\n  /**\n   * 检测网络地址信息（IPv4/IPv6）\n   */\n  public async detectNetworkAddresses(): Promise<NetworkAddressInfo> {\n    const result: NetworkAddressInfo = {\n      hasPublicIPv6: false,\n    };\n\n    // 1. 检测本地网卡地址\n    const localAddresses = this.detectLocalNetworkAddresses();\n    result.ipv4 = localAddresses.ipv4;\n    result.ipv6 = localAddresses.ipv6;\n\n    // 2. 通过外部服务检测公网地址\n    if (this.dynamicDetection.enableNetworkDetection) {\n      const [publicIPv4, publicIPv6] = await Promise.all([\n        this.detectPublicIPv4(),\n        this.detectPublicIPv6(),\n      ]);\n      result.ipv4Public = publicIPv4;\n      result.ipv6Public = publicIPv6;\n      \n      // 如果外部探测失败，但本地网卡有全球 IPv6 地址，则作为 fallback\n      if (!result.ipv6Public && result.ipv6 && this.isGlobalIpv6(result.ipv6)) {\n        result.ipv6Public = result.ipv6;\n      }\n      \n      result.hasPublicIPv6 = !!result.ipv6Public && result.ipv6Public.includes(':');\n    }\n\n    this.logger.debug(`Network addresses detected: ${JSON.stringify(result)}`);\n    return result;\n  }\n\n  /**\n   * 判断是否为全球单播 IPv6 地址 (2xxx: 或 3xxx:)\n   */\n  private isGlobalIpv6(address: string): boolean {\n    const firstChar = address.toLowerCase()[0];\n    return firstChar === '2' || firstChar === '3';\n  }\n\n  /**\n   * 检测本地网卡地址\n   */\n  private detectLocalNetworkAddresses(): { ipv4?: string; ipv6?: string } {\n    const result: { ipv4?: string; ipv6?: string } = {};\n    const interfaces = os.networkInterfaces();\n\n    for (const name of Object.keys(interfaces)) {\n      const addrs = interfaces[name];\n      if (!addrs) continue;\n\n      for (const addr of addrs) {\n        if (addr.internal) continue;\n\n        // 获取第一个非内部 IPv4 地址\n        if (addr.family === 'IPv4' && !result.ipv4) {\n          result.ipv4 = addr.address;\n        }\n\n        // 获取第一个全局 IPv6 地址\n        if (addr.family === 'IPv6' && !result.ipv6) {\n          const address = addr.address.toLowerCase();\n          // 排除链路本地 (fe80:), 唯一本地 (fc00:, fd00:), 组播 (ff00:)\n          if (!address.startsWith('fe80:') && \n              !address.startsWith('fc') && \n              !address.startsWith('fd') &&\n              !address.startsWith('ff')) {\n            result.ipv6 = addr.address;\n          }\n        }\n      }\n    }\n\n    return result;\n  }\n\n  /**\n   * 通过外部服务检测公网 IPv4 地址\n   */\n  private async detectPublicIPv4(): Promise<string | undefined> {\n    const url = this.dynamicDetection.ipv4ServiceUrl;\n    if (!url) return undefined;\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), 5000);\n\n      const response = await fetch(url, {\n        signal: controller.signal,\n      });\n      clearTimeout(timeoutId);\n\n      if (!response.ok) return undefined;\n\n      const data = await response.json() as { ip: string };\n      // 验证是 IPv4 格式\n      if (data.ip && /^\\d{1,3}(\\.\\d{1,3}){3}$/.test(data.ip)) {\n        return data.ip;\n      }\n    } catch {\n      this.logger.debug('Failed to detect public IPv4 address');\n    }\n    return undefined;\n  }\n\n  /**\n   * 通过外部服务检测公网 IPv6 地址\n   */\n  private async detectPublicIPv6(): Promise<string | undefined> {\n    const url = this.dynamicDetection.ipv6ServiceUrl;\n    if (!url) return undefined;\n\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), 5000);\n\n      const response = await fetch(url, {\n        signal: controller.signal,\n      });\n      clearTimeout(timeoutId);\n\n      if (!response.ok) return undefined;\n\n      const data = await response.json() as { ip: string };\n      // 验证是 IPv6 格式（包含冒号）\n      if (data.ip && data.ip.includes(':')) {\n        return data.ip;\n      }\n    } catch {\n      this.logger.debug('Failed to detect public IPv6 address');\n    }\n    return undefined;\n  }\n\n  /**\n   * 测试 IPv6 地址是否可从外部访问\n   * @param ipv6 要测试的 IPv6 地址\n   * @param port 要测试的端口\n   * @param timeoutMs 超时时间（毫秒）\n   */\n  public async testIPv6Reachability(ipv6: string, port: number, timeoutMs = 5000): Promise<boolean> {\n    try {\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\n      // 尝试通过外部服务检测可达性\n      // 这里使用简单的 TCP 连接测试\n      const response = await fetch(`http://[${ipv6}]:${port}/`, {\n        method: 'HEAD',\n        signal: controller.signal,\n      });\n      clearTimeout(timeoutId);\n\n      return response.ok || response.status < 500;\n    } catch {\n      return false;\n    }\n  }\n}"]}

package/dist/edge/EdgeNodeCertificateProvisioner.d.ts

@@ -0,0 +1,3 @@
+export interface EdgeNodeCertificateProvisioner {
+    handleCertificateRequest(nodeId: string, metadata: Record<string, unknown>): Promise<void>;
+}

package/dist/edge/EdgeNodeCertificateProvisioner.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=EdgeNodeCertificateProvisioner.js.map

package/dist/edge/EdgeNodeCertificateProvisioner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeNodeCertificateProvisioner.js","sourceRoot":"","sources":["../../src/edge/EdgeNodeCertificateProvisioner.ts"],"names":[],"mappings":"","sourcesContent":["export interface EdgeNodeCertificateProvisioner {\n  handleCertificateRequest(nodeId: string, metadata: Record<string, unknown>): Promise<void>;\n}\n"]}

package/dist/edge/EdgeNodeCertificateProvisioner.jsonld

@@ -0,0 +1,21 @@
+{
+  "@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/EdgeNodeCertificateProvisioner.jsonld#EdgeNodeCertificateProvisioner",
+      "@type": "AbstractClass",
+      "requireElement": "EdgeNodeCertificateProvisioner",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/edge/EdgeNodeCertificateProvisioner.jsonld#EdgeNodeCertificateProvisioner__member_handleCertificateRequest",
+          "memberFieldName": "handleCertificateRequest"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/edge/EdgeNodeDnsCoordinator.d.ts

@@ -0,0 +1,38 @@
+import type { DnsProvider, DnsRecordTypeValue } from '../dns/DnsProvider';
+export interface EdgeNodeDnsCoordinatorOptions {
+    provider: DnsProvider;
+    /** 顶级域名，例如 `xpod.example`。 */
+    rootDomain?: string | null;
+    /**
+     * 默认记录类型，当目标地址无法识别时回退使用。
+     * 一般为 `A`（IPv4）或 `AAAA`（IPv6）。
+     */
+    defaultRecordType?: DnsRecordTypeValue;
+    /** TTL 秒数，缺省按供应商默认。 */
+    ttl?: number | string | null;
+    /**
+     * Cluster 的公网 IP 地址，用于 proxy 模式的 DNS 指向。
+     * 如果未设置，proxy 模式节点将跳过 DNS 同步。
+     */
+    clusterIp?: string | null;
+}
+export declare class EdgeNodeDnsCoordinator {
+    private readonly logger;
+    private readonly provider;
+    private readonly rootDomain?;
+    private readonly defaultRecordType;
+    private readonly ttl?;
+    private readonly clusterIp?;
+    private readonly enabled;
+    constructor(options: EdgeNodeDnsCoordinatorOptions);
+    synchronize(nodeId: string, metadata: Record<string, unknown>): Promise<void>;
+    private extractDnsHints;
+    private extractString;
+    private detectRecordType;
+    private normalizeRecordValue;
+    private extractHost;
+    private isIpv4;
+    private isIpv6;
+    private normalizeRootDomain;
+    private normalizeTtl;
+}