@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/logging/ConfigurableLoggerFactory.jsonld

@@ -0,0 +1,169 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld",
+    "https://linkedsoftwaredependencies.org/bundles/npm/global-logger-factory/^1.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory",
+      "@type": "Class",
+      "requireElement": "ConfigurableLoggerFactory",
+      "extends": [
+        "glf:dist/LoggerFactory.jsonld#LoggerFactory"
+      ],
+      "parameters": [
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_level",
+          "range": "xsd:string"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_fileName",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_maxSize",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_maxFiles",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_format",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:string",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_showLocation",
+          "range": {
+            "@type": "ParameterRangeUnion",
+            "parameterRangeElements": [
+              "xsd:boolean",
+              {
+                "@type": "ParameterRangeUndefined"
+              }
+            ]
+          }
+        }
+      ],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_level",
+          "memberFieldName": "level"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_fileName",
+          "memberFieldName": "fileName"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_maxSize",
+          "memberFieldName": "maxSize"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_maxFiles",
+          "memberFieldName": "maxFiles"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_showLocation",
+          "memberFieldName": "showLocation"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_fileTransport",
+          "memberFieldName": "fileTransport"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_constructor",
+          "memberFieldName": "constructor"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_clusterInfo",
+          "memberFieldName": "clusterInfo"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_createLogger",
+          "memberFieldName": "createLogger"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_createTransports",
+          "memberFieldName": "createTransports"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory__member_getFormat",
+          "memberFieldName": "getFormat"
+        }
+      ],
+      "constructorArguments": [
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_level"
+        },
+        {
+          "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options__constructorArgument",
+          "fields": [
+            {
+              "keyRaw": "fileName",
+              "value": {
+                "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_fileName"
+              }
+            },
+            {
+              "keyRaw": "maxSize",
+              "value": {
+                "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_maxSize"
+              }
+            },
+            {
+              "keyRaw": "maxFiles",
+              "value": {
+                "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_maxFiles"
+              }
+            },
+            {
+              "keyRaw": "format",
+              "value": {
+                "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_format"
+              }
+            },
+            {
+              "keyRaw": "showLocation",
+              "value": {
+                "@id": "undefineds:dist/logging/ConfigurableLoggerFactory.jsonld#ConfigurableLoggerFactory_options_showLocation"
+              }
+            }
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/logging/LogContext.d.ts

@@ -0,0 +1,5 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export interface LogContext {
+    requestId: string;
+}
+export declare const logContext: AsyncLocalStorage<LogContext>;

package/dist/logging/LogContext.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logContext = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+exports.logContext = new node_async_hooks_1.AsyncLocalStorage();
+//# sourceMappingURL=LogContext.js.map

package/dist/logging/LogContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogContext.js","sourceRoot":"","sources":["../../src/logging/LogContext.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAMxC,QAAA,UAAU,GAAG,IAAI,oCAAiB,EAAc,CAAC","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\n\nexport interface LogContext {\n  requestId: string;\n}\n\nexport const logContext = new AsyncLocalStorage<LogContext>();\n"]}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const supervisor_1 = require("./supervisor");
+const proxy_1 = require("./gateway/proxy");
+const port_finder_1 = require("./gateway/port-finder");
+const global_logger_factory_1 = require("global-logger-factory");
+const ConfigurableLoggerFactory_1 = require("./logging/ConfigurableLoggerFactory");
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const path_1 = __importDefault(require("path"));
+const fs_1 = __importDefault(require("fs"));
+// Placeholder for late initialization
+let logger = (0, global_logger_factory_1.getLoggerFor)('Main');
+// Load .env file manually
+function loadEnvFile(envPath) {
+    if (!fs_1.default.existsSync(envPath)) {
+        logger.warn(`Env file not found: ${envPath}`);
+        return;
+    }
+    const content = fs_1.default.readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIndex = trimmed.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        let value = trimmed.slice(eqIndex + 1).trim();
+        // Remove quotes
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (!process.env[key]) {
+            process.env[key] = value;
+        }
+    }
+}
+async function main() {
+    const argv = await (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .option('mode', { alias: 'm', type: 'string', choices: ['local', 'cloud'], description: 'Run mode' })
+        .option('config', { alias: 'c', type: 'string', description: 'Path to config file (overrides --mode)' })
+        .option('env', { alias: 'e', type: 'string', description: 'Path to .env file' })
+        .option('port', { alias: 'p', type: 'number', description: 'Gateway port', default: 3000 })
+        .option('host', { type: 'string', description: 'Gateway host', default: 'localhost' })
+        .help()
+        .parse();
+    // Load env file if specified
+    if (argv.env) {
+        loadEnvFile(argv.env);
+    }
+    // 初始化全局统一日志工厂
+    const loggerFactory = new ConfigurableLoggerFactory_1.ConfigurableLoggerFactory(process.env.CSS_LOGGING_LEVEL || 'info', {
+        fileName: './logs/xpod-%DATE%.log',
+        showLocation: true
+    });
+    (0, global_logger_factory_1.setGlobalLoggerFactory)(loggerFactory);
+    logger = (0, global_logger_factory_1.getLoggerFor)('Main');
+    // Main port: 命令行参数 > 环境变量 > 默认值 3000
+    const mainPort = argv.port !== 3000
+        ? argv.port
+        : parseInt(process.env.XPOD_PORT ?? process.env.PORT ?? '3000', 10);
+    // Determine config path: --config > --mode > default
+    let configPath;
+    if (argv.config) {
+        configPath = argv.config;
+    }
+    else if (argv.mode) {
+        configPath = `config/${argv.mode}.json`;
+    }
+    else {
+        configPath = 'config/local.json';
+    }
+    // 1. Determine Ports with auto-discovery
+    // Ensure CSS port search doesn't start exactly on the Main port
+    const cssStartPort = (mainPort === 3000 ? 3002 : 3000);
+    const cssPort = await (0, port_finder_1.getFreePort)(cssStartPort);
+    // API port starts after CSS port to avoid collision
+    const apiStartPort = cssPort + 1;
+    const apiPort = await (0, port_finder_1.getFreePort)(apiStartPort);
+    // 2. Determine Base URL (环境变量优先，否则用本地地址)
+    const baseUrl = process.env.CSS_BASE_URL || `http://${argv.host}:${mainPort}/`;
+    logger.info('Orchestration Plan:');
+    logger.info(`  - Main Entry: ${baseUrl} (${argv.host}:${mainPort})`);
+    logger.info(`  - CSS (internal): http://localhost:${cssPort}`);
+    logger.info(`  - API (internal): http://localhost:${apiPort}`);
+    const supervisor = new supervisor_1.Supervisor();
+    // Optimized CSS Binary Path
+    // Directly call the binary to avoid npx overhead and network risks
+    const cssBinary = path_1.default.resolve('node_modules/@solid/community-server/bin/server.js');
+    // Register CSS (Solid Server)
+    supervisor.register({
+        name: 'css',
+        command: 'node', // Direct node execution
+        args: [
+            cssBinary, // Path to bin/server.js
+            '-c', configPath,
+            '-m', '.',
+            '-p', cssPort.toString(),
+            '-b', baseUrl,
+        ],
+        env: {
+            ...process.env,
+            CSS_PORT: cssPort.toString(),
+            CSS_BASE_URL: baseUrl,
+        },
+    });
+    // Register API Server
+    supervisor.register({
+        name: 'api',
+        command: 'node',
+        args: ['dist/api/main.js'],
+        env: {
+            ...process.env,
+            API_PORT: apiPort.toString(),
+            XPOD_MAIN_PORT: mainPort.toString(),
+            CSS_INTERNAL_URL: `http://localhost:${cssPort}`,
+        },
+    });
+    // Start Gateway Proxy
+    const proxy = new proxy_1.GatewayProxy(mainPort, supervisor);
+    proxy.setTargets({
+        css: `http://localhost:${cssPort}`,
+        api: `http://localhost:${apiPort}`,
+    });
+    // Start processes
+    await supervisor.startAll();
+    proxy.start();
+    // Graceful shutdown
+    const shutdown = async (signal) => {
+        logger.info(`Received ${signal}, shutting down...`);
+        // Stop supervisor (CSS + API)
+        await supervisor.stopAll();
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    process.on('SIGINT', () => shutdown('SIGINT'));
+}
+main().catch((error) => {
+    logger.error(`Failed to start: ${error}`);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { Supervisor } from './supervisor';\nimport { GatewayProxy } from './gateway/proxy';\nimport { getFreePort } from './gateway/port-finder';\nimport { LocalTunnelProvider } from './tunnel/LocalTunnelProvider';\nimport { setGlobalLoggerFactory, getLoggerFor } from 'global-logger-factory';\nimport { ConfigurableLoggerFactory } from './logging/ConfigurableLoggerFactory';\nimport yargs from 'yargs';\nimport { hideBin } from 'yargs/helpers';\nimport path from 'path';\nimport fs from 'fs';\n\n// Placeholder for late initialization\nlet logger = getLoggerFor('Main');\n\n// Load .env file manually\nfunction loadEnvFile(envPath: string): void {\n  if (!fs.existsSync(envPath)) {\n    logger.warn(`Env file not found: ${envPath}`);\n    return;\n  }\n  const content = fs.readFileSync(envPath, 'utf-8');\n  for (const line of content.split('\\n')) {\n    const trimmed = line.trim();\n    if (!trimmed || trimmed.startsWith('#')) continue;\n    const eqIndex = trimmed.indexOf('=');\n    if (eqIndex === -1) continue;\n    const key = trimmed.slice(0, eqIndex).trim();\n    let value = trimmed.slice(eqIndex + 1).trim();\n    // Remove quotes\n    if ((value.startsWith('\"') && value.endsWith('\"')) ||\n        (value.startsWith(\"'\") && value.endsWith(\"'\"))) {\n      value = value.slice(1, -1);\n    }\n    if (!process.env[key]) {\n      process.env[key] = value;\n    }\n  }\n}\n\nasync function main() {\n  const argv = await yargs(hideBin(process.argv))\n    .option('mode', { alias: 'm', type: 'string', choices: ['local', 'cloud'], description: 'Run mode' })\n    .option('config', { alias: 'c', type: 'string', description: 'Path to config file (overrides --mode)' })\n    .option('env', { alias: 'e', type: 'string', description: 'Path to .env file' })\n    .option('port', { alias: 'p', type: 'number', description: 'Gateway port', default: 3000 })\n    .option('host', { type: 'string', description: 'Gateway host', default: 'localhost' })\n    .help()\n    .parse();\n\n  // Load env file if specified\n  if (argv.env) {\n    loadEnvFile(argv.env);\n  }\n\n  // 初始化全局统一日志工厂\n  const loggerFactory = new ConfigurableLoggerFactory(process.env.CSS_LOGGING_LEVEL || 'info', {\n    fileName: './logs/xpod-%DATE%.log',\n    showLocation: true\n  });\n  setGlobalLoggerFactory(loggerFactory);\n  logger = getLoggerFor('Main');\n\n  // Main port: 命令行参数 > 环境变量 > 默认值 3000\n  const mainPort = argv.port !== 3000 \n    ? argv.port as number \n    : parseInt(process.env.XPOD_PORT ?? process.env.PORT ?? '3000', 10);\n\n  // Determine config path: --config > --mode > default\n  let configPath: string;\n  if (argv.config) {\n    configPath = argv.config;\n  } else if (argv.mode) {\n    configPath = `config/${argv.mode}.json`;\n  } else {\n    configPath = 'config/local.json';\n  }\n  \n  // 1. Determine Ports with auto-discovery\n  // Ensure CSS port search doesn't start exactly on the Main port\n  const cssStartPort = (mainPort === 3000 ? 3002 : 3000);\n  const cssPort = await getFreePort(cssStartPort);\n\n  // API port starts after CSS port to avoid collision\n  const apiStartPort = cssPort + 1;\n  const apiPort = await getFreePort(apiStartPort);\n  \n  // 2. Determine Base URL (环境变量优先，否则用本地地址)\n  const baseUrl = process.env.CSS_BASE_URL || `http://${argv.host}:${mainPort}/`;\n\n  logger.info('Orchestration Plan:');\n  logger.info(`  - Main Entry: ${baseUrl} (${argv.host}:${mainPort})`);\n  logger.info(`  - CSS (internal): http://localhost:${cssPort}`);\n  logger.info(`  - API (internal): http://localhost:${apiPort}`);\n\n  const supervisor = new Supervisor();\n\n  // Optimized CSS Binary Path\n  // Directly call the binary to avoid npx overhead and network risks\n  const cssBinary = path.resolve('node_modules/@solid/community-server/bin/server.js');\n\n  // Register CSS (Solid Server)\n  supervisor.register({\n    name: 'css',\n    command: 'node', // Direct node execution\n    args: [\n      cssBinary, // Path to bin/server.js\n      '-c', configPath,\n      '-m', '.',\n      '-p', cssPort.toString(),\n      '-b', baseUrl,\n    ],\n    env: {\n      ...process.env,\n      CSS_PORT: cssPort.toString(),\n      CSS_BASE_URL: baseUrl,\n    },\n  });\n\n  // Register API Server\n  supervisor.register({\n    name: 'api',\n    command: 'node',\n    args: ['dist/api/main.js'],\n    env: {\n      ...process.env,\n      API_PORT: apiPort.toString(),\n      XPOD_MAIN_PORT: mainPort.toString(),\n      CSS_INTERNAL_URL: `http://localhost:${cssPort}`,\n    },\n  });\n\n  // Start Gateway Proxy\n  const proxy = new GatewayProxy(mainPort, supervisor);\n  \n  proxy.setTargets({\n    css: `http://localhost:${cssPort}`,\n    api: `http://localhost:${apiPort}`,\n  });\n  \n  // Start processes\n  await supervisor.startAll();\n  proxy.start();\n\n  // Graceful shutdown\n  const shutdown = async (signal: string): Promise<void> => {\n    logger.info(`Received ${signal}, shutting down...`);\n    \n    // Stop supervisor (CSS + API)\n    await supervisor.stopAll();\n    process.exit(0);\n  };\n\n  process.on('SIGTERM', () => shutdown('SIGTERM'));\n  process.on('SIGINT', () => shutdown('SIGINT'));\n}\n\nmain().catch((error) => {\n  logger.error(`Failed to start: ${error}`);\n  process.exit(1);\n});"]}

package/dist/network/LocalNetworkDetector.d.ts

@@ -0,0 +1,65 @@
+/**
+ * 局域网检测工具
+ *
+ * 通过比较 IP 地址判断两个节点是否在同一局域网
+ */
+/**
+ * 获取本机内网 IP 地址
+ */
+export declare function getLocalIPs(): {
+    ipv4: string[];
+    ipv6: string[];
+};
+/**
+ * 判断 IP 是否是内网地址
+ */
+export declare function isPrivateIP(ip: string): boolean;
+/**
+ * 从 IP 地址获取网段（简单实现，假设 /24）
+ */
+export declare function getNetworkPrefix(ip: string, prefixLength?: number): string;
+/**
+ * 判断两个 IP 是否在同一网段
+ */
+export declare function isSameNetwork(ip1: string, ip2: string, prefixLength?: number): boolean;
+/**
+ * 局域网节点信息
+ */
+export interface LocalNodeInfo {
+    nodeId: string;
+    privateIPs: string[];
+    publicIP?: string;
+}
+/**
+ * 局域网检测器
+ *
+ * Cloud 端使用，判断 Client 是否与 Local 在同一局域网
+ */
+export declare class LocalNetworkDetector {
+    /** 存储已注册的 Local 节点信息 */
+    private readonly nodes;
+    /**
+     * 注册 Local 节点信息（从心跳获取）
+     */
+    registerNode(nodeId: string, privateIPs: string[], publicIP?: string): void;
+    /**
+     * 移除节点
+     */
+    removeNode(nodeId: string): void;
+    /**
+     * 检测 Client 是否与指定 Local 在同一局域网
+     *
+     * 检测逻辑：
+     * 1. 比较公网 IP：如果相同，可能在同一 NAT 后
+     * 2. 比较内网 IP 网段：如果有重叠，很可能在同一局域网
+     */
+    detectSameNetwork(targetNodeId: string, clientPrivateIPs: string[], clientPublicIP?: string): {
+        isSameNetwork: boolean;
+        reason: string;
+        localIPs?: string[];
+    };
+    /**
+     * 获取节点信息
+     */
+    getNode(nodeId: string): LocalNodeInfo | undefined;
+}

package/dist/network/LocalNetworkDetector.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * 局域网检测工具
+ *
+ * 通过比较 IP 地址判断两个节点是否在同一局域网
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalNetworkDetector = void 0;
+exports.getLocalIPs = getLocalIPs;
+exports.isPrivateIP = isPrivateIP;
+exports.getNetworkPrefix = getNetworkPrefix;
+exports.isSameNetwork = isSameNetwork;
+const node_os_1 = require("node:os");
+/**
+ * 获取本机内网 IP 地址
+ */
+function getLocalIPs() {
+    const result = { ipv4: [], ipv6: [] };
+    const interfaces = (0, node_os_1.networkInterfaces)();
+    for (const [, addrs] of Object.entries(interfaces)) {
+        if (!addrs)
+            continue;
+        for (const addr of addrs) {
+            if (addr.internal)
+                continue; // 跳过 loopback
+            if (addr.family === 'IPv4') {
+                result.ipv4.push(addr.address);
+            }
+            else if (addr.family === 'IPv6' && !addr.address.startsWith('fe80')) {
+                // 跳过 link-local
+                result.ipv6.push(addr.address);
+            }
+        }
+    }
+    return result;
+}
+/**
+ * 判断 IP 是否是内网地址
+ */
+function isPrivateIP(ip) {
+    // IPv4 内网地址范围
+    const privateRanges = [
+        /^10\./, // 10.0.0.0/8
+        /^172\.(1[6-9]|2\d|3[01])\./, // 172.16.0.0/12
+        /^192\.168\./, // 192.168.0.0/16
+        /^169\.254\./, // Link-local
+    ];
+    // IPv6 内网地址
+    const privateV6Ranges = [
+        /^fc/i, // Unique local (fc00::/7)
+        /^fd/i, // Unique local (fd00::/8)
+    ];
+    for (const range of privateRanges) {
+        if (range.test(ip))
+            return true;
+    }
+    for (const range of privateV6Ranges) {
+        if (range.test(ip))
+            return true;
+    }
+    return false;
+}
+/**
+ * 从 IP 地址获取网段（简单实现，假设 /24）
+ */
+function getNetworkPrefix(ip, prefixLength = 24) {
+    const parts = ip.split('.');
+    if (parts.length !== 4)
+        return ip;
+    // 对于 /24，取前三段
+    if (prefixLength === 24) {
+        return `${parts[0]}.${parts[1]}.${parts[2]}.0/24`;
+    }
+    // 对于 /16，取前两段
+    if (prefixLength === 16) {
+        return `${parts[0]}.${parts[1]}.0.0/16`;
+    }
+    return ip;
+}
+/**
+ * 判断两个 IP 是否在同一网段
+ */
+function isSameNetwork(ip1, ip2, prefixLength = 24) {
+    return getNetworkPrefix(ip1, prefixLength) === getNetworkPrefix(ip2, prefixLength);
+}
+/**
+ * 局域网检测器
+ *
+ * Cloud 端使用，判断 Client 是否与 Local 在同一局域网
+ */
+class LocalNetworkDetector {
+    constructor() {
+        /** 存储已注册的 Local 节点信息 */
+        this.nodes = new Map();
+    }
+    /**
+     * 注册 Local 节点信息（从心跳获取）
+     */
+    registerNode(nodeId, privateIPs, publicIP) {
+        this.nodes.set(nodeId, { nodeId, privateIPs, publicIP });
+    }
+    /**
+     * 移除节点
+     */
+    removeNode(nodeId) {
+        this.nodes.delete(nodeId);
+    }
+    /**
+     * 检测 Client 是否与指定 Local 在同一局域网
+     *
+     * 检测逻辑：
+     * 1. 比较公网 IP：如果相同，可能在同一 NAT 后
+     * 2. 比较内网 IP 网段：如果有重叠，很可能在同一局域网
+     */
+    detectSameNetwork(targetNodeId, clientPrivateIPs, clientPublicIP) {
+        const node = this.nodes.get(targetNodeId);
+        if (!node) {
+            return { isSameNetwork: false, reason: 'Node not found' };
+        }
+        // 1. 检查公网 IP
+        if (clientPublicIP && node.publicIP && clientPublicIP === node.publicIP) {
+            // 公网 IP 相同，可能在同一 NAT 后面
+            // 进一步检查内网 IP
+            for (const clientIP of clientPrivateIPs) {
+                for (const nodeIP of node.privateIPs) {
+                    if (isSameNetwork(clientIP, nodeIP)) {
+                        return {
+                            isSameNetwork: true,
+                            reason: 'Same public IP and same private network',
+                            localIPs: node.privateIPs,
+                        };
+                    }
+                }
+            }
+            return {
+                isSameNetwork: false,
+                reason: 'Same public IP but different private networks (different NAT layers?)',
+            };
+        }
+        // 2. 只检查内网 IP（如果没有公网 IP 信息）
+        for (const clientIP of clientPrivateIPs) {
+            if (!isPrivateIP(clientIP))
+                continue;
+            for (const nodeIP of node.privateIPs) {
+                if (!isPrivateIP(nodeIP))
+                    continue;
+                if (isSameNetwork(clientIP, nodeIP)) {
+                    return {
+                        isSameNetwork: true,
+                        reason: 'Same private network segment',
+                        localIPs: node.privateIPs,
+                    };
+                }
+            }
+        }
+        return {
+            isSameNetwork: false,
+            reason: 'Different networks',
+        };
+    }
+    /**
+     * 获取节点信息
+     */
+    getNode(nodeId) {
+        return this.nodes.get(nodeId);
+    }
+}
+exports.LocalNetworkDetector = LocalNetworkDetector;
+// 测试
+if (require.main === module) {
+    console.log('Local IPs:', getLocalIPs());
+    const detector = new LocalNetworkDetector();
+    // 模拟 Local 节点注册
+    detector.registerNode('local-1', ['192.168.1.100', '10.0.0.5'], '1.2.3.4');
+    // 测试 1: 同一局域网的 Client
+    console.log('\nTest 1 - Same network:');
+    console.log(detector.detectSameNetwork('local-1', ['192.168.1.50'], '1.2.3.4'));
+    // 测试 2: 不同局域网的 Client
+    console.log('\nTest 2 - Different network:');
+    console.log(detector.detectSameNetwork('local-1', ['192.168.2.50'], '5.6.7.8'));
+    // 测试 3: 同一公网 IP 但不同内网网段
+    console.log('\nTest 3 - Same public IP, different private:');
+    console.log(detector.detectSameNetwork('local-1', ['172.16.0.50'], '1.2.3.4'));
+}
+//# sourceMappingURL=LocalNetworkDetector.js.map

package/dist/network/LocalNetworkDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalNetworkDetector.js","sourceRoot":"","sources":["../../src/network/LocalNetworkDetector.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 局域网检测工具\n *\n * 通过比较 IP 地址判断两个节点是否在同一局域网\n */\n\nimport { networkInterfaces } from 'node:os';\n\n/**\n * 获取本机内网 IP 地址\n */\nexport function getLocalIPs(): { ipv4: string[]; ipv6: string[] } {\n  const result = { ipv4: [] as string[], ipv6: [] as string[] };\n  const interfaces = networkInterfaces();\n\n  for (const [, addrs] of Object.entries(interfaces)) {\n    if (!addrs) continue;\n    for (const addr of addrs) {\n      if (addr.internal) continue; // 跳过 loopback\n\n      if (addr.family === 'IPv4') {\n        result.ipv4.push(addr.address);\n      } else if (addr.family === 'IPv6' && !addr.address.startsWith('fe80')) {\n        // 跳过 link-local\n        result.ipv6.push(addr.address);\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * 判断 IP 是否是内网地址\n */\nexport function isPrivateIP(ip: string): boolean {\n  // IPv4 内网地址范围\n  const privateRanges = [\n    /^10\\./,                    // 10.0.0.0/8\n    /^172\\.(1[6-9]|2\\d|3[01])\\./, // 172.16.0.0/12\n    /^192\\.168\\./,              // 192.168.0.0/16\n    /^169\\.254\\./,              // Link-local\n  ];\n\n  // IPv6 内网地址\n  const privateV6Ranges = [\n    /^fc/i,  // Unique local (fc00::/7)\n    /^fd/i,  // Unique local (fd00::/8)\n  ];\n\n  for (const range of privateRanges) {\n    if (range.test(ip)) return true;\n  }\n\n  for (const range of privateV6Ranges) {\n    if (range.test(ip)) return true;\n  }\n\n  return false;\n}\n\n/**\n * 从 IP 地址获取网段（简单实现，假设 /24）\n */\nexport function getNetworkPrefix(ip: string, prefixLength = 24): string {\n  const parts = ip.split('.');\n  if (parts.length !== 4) return ip;\n\n  // 对于 /24，取前三段\n  if (prefixLength === 24) {\n    return `${parts[0]}.${parts[1]}.${parts[2]}.0/24`;\n  }\n\n  // 对于 /16，取前两段\n  if (prefixLength === 16) {\n    return `${parts[0]}.${parts[1]}.0.0/16`;\n  }\n\n  return ip;\n}\n\n/**\n * 判断两个 IP 是否在同一网段\n */\nexport function isSameNetwork(ip1: string, ip2: string, prefixLength = 24): boolean {\n  return getNetworkPrefix(ip1, prefixLength) === getNetworkPrefix(ip2, prefixLength);\n}\n\n/**\n * 局域网节点信息\n */\nexport interface LocalNodeInfo {\n  nodeId: string;\n  privateIPs: string[];\n  publicIP?: string;\n}\n\n/**\n * 局域网检测器\n *\n * Cloud 端使用，判断 Client 是否与 Local 在同一局域网\n */\nexport class LocalNetworkDetector {\n  /** 存储已注册的 Local 节点信息 */\n  private readonly nodes = new Map<string, LocalNodeInfo>();\n\n  /**\n   * 注册 Local 节点信息（从心跳获取）\n   */\n  public registerNode(nodeId: string, privateIPs: string[], publicIP?: string): void {\n    this.nodes.set(nodeId, { nodeId, privateIPs, publicIP });\n  }\n\n  /**\n   * 移除节点\n   */\n  public removeNode(nodeId: string): void {\n    this.nodes.delete(nodeId);\n  }\n\n  /**\n   * 检测 Client 是否与指定 Local 在同一局域网\n   *\n   * 检测逻辑：\n   * 1. 比较公网 IP：如果相同，可能在同一 NAT 后\n   * 2. 比较内网 IP 网段：如果有重叠，很可能在同一局域网\n   */\n  public detectSameNetwork(\n    targetNodeId: string,\n    clientPrivateIPs: string[],\n    clientPublicIP?: string,\n  ): { isSameNetwork: boolean; reason: string; localIPs?: string[] } {\n    const node = this.nodes.get(targetNodeId);\n    if (!node) {\n      return { isSameNetwork: false, reason: 'Node not found' };\n    }\n\n    // 1. 检查公网 IP\n    if (clientPublicIP && node.publicIP && clientPublicIP === node.publicIP) {\n      // 公网 IP 相同，可能在同一 NAT 后面\n      // 进一步检查内网 IP\n      for (const clientIP of clientPrivateIPs) {\n        for (const nodeIP of node.privateIPs) {\n          if (isSameNetwork(clientIP, nodeIP)) {\n            return {\n              isSameNetwork: true,\n              reason: 'Same public IP and same private network',\n              localIPs: node.privateIPs,\n            };\n          }\n        }\n      }\n      return {\n        isSameNetwork: false,\n        reason: 'Same public IP but different private networks (different NAT layers?)',\n      };\n    }\n\n    // 2. 只检查内网 IP（如果没有公网 IP 信息）\n    for (const clientIP of clientPrivateIPs) {\n      if (!isPrivateIP(clientIP)) continue;\n\n      for (const nodeIP of node.privateIPs) {\n        if (!isPrivateIP(nodeIP)) continue;\n\n        if (isSameNetwork(clientIP, nodeIP)) {\n          return {\n            isSameNetwork: true,\n            reason: 'Same private network segment',\n            localIPs: node.privateIPs,\n          };\n        }\n      }\n    }\n\n    return {\n      isSameNetwork: false,\n      reason: 'Different networks',\n    };\n  }\n\n  /**\n   * 获取节点信息\n   */\n  public getNode(nodeId: string): LocalNodeInfo | undefined {\n    return this.nodes.get(nodeId);\n  }\n}\n\n// 测试\nif (require.main === module) {\n  console.log('Local IPs:', getLocalIPs());\n\n  const detector = new LocalNetworkDetector();\n\n  // 模拟 Local 节点注册\n  detector.registerNode('local-1', ['192.168.1.100', '10.0.0.5'], '1.2.3.4');\n\n  // 测试 1: 同一局域网的 Client\n  console.log('\\nTest 1 - Same network:');\n  console.log(detector.detectSameNetwork('local-1', ['192.168.1.50'], '1.2.3.4'));\n\n  // 测试 2: 不同局域网的 Client\n  console.log('\\nTest 2 - Different network:');\n  console.log(detector.detectSameNetwork('local-1', ['192.168.2.50'], '5.6.7.8'));\n\n  // 测试 3: 同一公网 IP 但不同内网网段\n  console.log('\\nTest 3 - Same public IP, different private:');\n  console.log(detector.detectSameNetwork('local-1', ['172.16.0.50'], '1.2.3.4'));\n}\n"]}

package/dist/network/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 网络工具模块
+ */
+export * from './LocalNetworkDetector';

package/dist/network/index.js

@@ -0,0 +1,21 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./LocalNetworkDetector"), exports);
+//# sourceMappingURL=index.js.map