@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/tunnel/SakuraFrpTunnelProvider.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * SakuraFRP Tunnel Provider
+ *
+ * 使用 SakuraFRP 提供隧道服务
+ * 用于没有公网 IP 的 Local 节点
+ *
+ * 需要用户在 SakuraFRP 控制台创建隧道并获取 Token
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SakuraFrpTunnelProvider = void 0;
+const node_child_process_1 = require("node:child_process");
+const global_logger_factory_1 = require("global-logger-factory");
+/**
+ * SakuraFRP Tunnel Provider
+ *
+ * 通过 frpc 客户端连接 SakuraFRP 服务
+ */
+class SakuraFrpTunnelProvider {
+    constructor(options) {
+        this.name = 'sakura-frp';
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.process = null;
+        this.status = {
+            running: false,
+            connected: false,
+        };
+        this.currentConfig = null;
+        this.managedByUs = false;
+        this.token = options.token;
+        this.frpcPath = options.frpcPath ?? 'frpc';
+        this.serverAddr = options.serverAddr;
+    }
+    /**
+     * Setup: 解析 Token 获取配置
+     */
+    async setup(_options) {
+        // SakuraFRP Token 格式通常包含隧道信息
+        // 这里返回基本配置，实际配置由 frpc 从 Token 获取
+        const config = {
+            subdomain: 'sakura',
+            provider: 'sakura-frp',
+            endpoint: '',
+            tunnelToken: this.token,
+        };
+        this.currentConfig = config;
+        return config;
+    }
+    /**
+     * 启动 frpc 客户端
+     */
+    async start(config) {
+        const actualConfig = config ?? {
+            subdomain: 'sakura',
+            provider: 'sakura-frp',
+            endpoint: '',
+            tunnelToken: this.token,
+        };
+        // 检测是否已经在运行
+        if (this.isFrpcRunning()) {
+            this.logger.info('frpc already running externally');
+            this.status = { running: true, connected: true };
+            this.currentConfig = actualConfig;
+            this.managedByUs = false;
+            return;
+        }
+        if (this.process) {
+            this.logger.info('Already running (managed by us)');
+            return;
+        }
+        const token = actualConfig.tunnelToken ?? this.token;
+        if (!token) {
+            throw new Error('SakuraFRP token is required');
+        }
+        this.logger.info('Starting SakuraFRP tunnel...');
+        this.status = { running: true, connected: false };
+        this.managedByUs = true;
+        // SakuraFRP 使用 frpc 客户端
+        // 命令格式: frpc -f <token>
+        const args = ['-f', token];
+        if (this.serverAddr) {
+            args.push('-s', this.serverAddr);
+        }
+        this.process = (0, node_child_process_1.spawn)(this.frpcPath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        this.process.stdout?.on('data', (data) => {
+            const output = data.toString().trim();
+            if (output) {
+                this.logger.info(`[frpc] ${output}`);
+                this.checkConnectionStatus(output);
+            }
+        });
+        this.process.stderr?.on('data', (data) => {
+            const output = data.toString().trim();
+            if (output) {
+                this.logger.warn(`[frpc] ${output}`);
+                this.checkConnectionStatus(output);
+            }
+        });
+        this.process.on('exit', (code) => {
+            this.logger.info(`frpc exited with code ${code}`);
+            this.status = { running: false, connected: false };
+            this.process = null;
+            this.managedByUs = false;
+        });
+        this.process.on('error', (error) => {
+            this.logger.error(`Failed to start frpc: ${error.message}`);
+            this.status = { running: false, connected: false, error: error.message };
+            this.process = null;
+            this.managedByUs = false;
+        });
+        this.currentConfig = actualConfig;
+        // 等待连接
+        await this.waitForConnection();
+    }
+    checkConnectionStatus(output) {
+        // 检测连接成功的关键字
+        if (output.includes('start proxy success') ||
+            output.includes('login to server success') ||
+            output.includes('tunnel running')) {
+            this.status.connected = true;
+            this.status.lastHeartbeat = new Date();
+            this.logger.info('SakuraFRP tunnel connected');
+        }
+        // 检测错误
+        if (output.includes('error') || output.includes('failed')) {
+            this.status.error = output;
+        }
+    }
+    /**
+     * 停止隧道
+     */
+    async stop() {
+        if (!this.managedByUs) {
+            this.logger.info('Not managed by us, skipping stop');
+            this.status = { running: false, connected: false };
+            return;
+        }
+        if (this.process) {
+            this.logger.info('Stopping SakuraFRP tunnel...');
+            this.process.kill('SIGTERM');
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    this.logger.info('Force killing frpc...');
+                    this.process?.kill('SIGKILL');
+                    resolve();
+                }, 5000);
+                this.process?.on('exit', () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+            this.process = null;
+            this.logger.info('SakuraFRP tunnel stopped');
+        }
+        this.status = { running: false, connected: false };
+        this.managedByUs = false;
+    }
+    getStatus() {
+        return { ...this.status };
+    }
+    getEndpoint() {
+        return this.currentConfig?.endpoint;
+    }
+    async cleanup(_config) {
+        await this.stop();
+        this.currentConfig = null;
+    }
+    /**
+     * 检测 frpc 是否已经在运行
+     */
+    isFrpcRunning() {
+        try {
+            if (process.platform === 'win32') {
+                (0, node_child_process_1.execSync)('tasklist /FI "IMAGENAME eq frpc.exe" | find "frpc"', {
+                    stdio: 'ignore',
+                });
+            }
+            else {
+                (0, node_child_process_1.execSync)('pgrep -x frpc', { stdio: 'ignore' });
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async waitForConnection(timeout = 30000) {
+        const start = Date.now();
+        while (Date.now() - start < timeout) {
+            if (this.status.connected) {
+                return;
+            }
+            if (!this.status.running && this.status.error) {
+                throw new Error(`SakuraFRP failed to start: ${this.status.error}`);
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        this.logger.warn('Connection timeout, tunnel may still be connecting...');
+    }
+    isManagedByUs() {
+        return this.managedByUs;
+    }
+}
+exports.SakuraFrpTunnelProvider = SakuraFrpTunnelProvider;
+//# sourceMappingURL=SakuraFrpTunnelProvider.js.map

package/dist/tunnel/SakuraFrpTunnelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SakuraFrpTunnelProvider.js","sourceRoot":"","sources":["../../src/tunnel/SakuraFrpTunnelProvider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SakuraFRP Tunnel Provider\n *\n * 使用 SakuraFRP 提供隧道服务\n * 用于没有公网 IP 的 Local 节点\n *\n * 需要用户在 SakuraFRP 控制台创建隧道并获取 Token\n */\n\nimport { spawn, execSync, type ChildProcess } from 'node:child_process';\nimport { getLoggerFor } from 'global-logger-factory';\nimport type {\n  TunnelProvider,\n  TunnelConfig,\n  TunnelSetupOptions,\n  TunnelStatus,\n} from './TunnelProvider';\n\n/**\n * SakuraFRP Tunnel Provider 配置\n */\nexport interface SakuraFrpTunnelProviderOptions {\n  /** SakuraFRP Token (从环境变量 SAKURA_TOKEN 获取) */\n  token: string;\n\n  /** frpc 可执行文件路径 (默认 'frpc') */\n  frpcPath?: string;\n\n  /** SakuraFRP 服务端地址 (如果需要自定义) */\n  serverAddr?: string;\n}\n\n/**\n * SakuraFRP Tunnel Provider\n *\n * 通过 frpc 客户端连接 SakuraFRP 服务\n */\nexport class SakuraFrpTunnelProvider implements TunnelProvider {\n  public readonly name = 'sakura-frp';\n  private readonly logger = getLoggerFor(this);\n\n  private readonly token: string;\n  private readonly frpcPath: string;\n  private readonly serverAddr?: string;\n\n  private process: ChildProcess | null = null;\n  private status: TunnelStatus = {\n    running: false,\n    connected: false,\n  };\n  private currentConfig: TunnelConfig | null = null;\n  private managedByUs = false;\n\n  constructor(options: SakuraFrpTunnelProviderOptions) {\n    this.token = options.token;\n    this.frpcPath = options.frpcPath ?? 'frpc';\n    this.serverAddr = options.serverAddr;\n  }\n\n  /**\n   * Setup: 解析 Token 获取配置\n   */\n  async setup(_options: TunnelSetupOptions): Promise<TunnelConfig> {\n    // SakuraFRP Token 格式通常包含隧道信息\n    // 这里返回基本配置，实际配置由 frpc 从 Token 获取\n    const config: TunnelConfig = {\n      subdomain: 'sakura',\n      provider: 'sakura-frp',\n      endpoint: '',\n      tunnelToken: this.token,\n    };\n\n    this.currentConfig = config;\n    return config;\n  }\n\n  /**\n   * 启动 frpc 客户端\n   */\n  async start(config?: TunnelConfig): Promise<void> {\n    const actualConfig = config ?? {\n      subdomain: 'sakura',\n      provider: 'sakura-frp' as const,\n      endpoint: '',\n      tunnelToken: this.token,\n    };\n\n    // 检测是否已经在运行\n    if (this.isFrpcRunning()) {\n      this.logger.info('frpc already running externally');\n      this.status = { running: true, connected: true };\n      this.currentConfig = actualConfig;\n      this.managedByUs = false;\n      return;\n    }\n\n    if (this.process) {\n      this.logger.info('Already running (managed by us)');\n      return;\n    }\n\n    const token = actualConfig.tunnelToken ?? this.token;\n    if (!token) {\n      throw new Error('SakuraFRP token is required');\n    }\n\n    this.logger.info('Starting SakuraFRP tunnel...');\n    this.status = { running: true, connected: false };\n    this.managedByUs = true;\n\n    // SakuraFRP 使用 frpc 客户端\n    // 命令格式: frpc -f <token>\n    const args = ['-f', token];\n    if (this.serverAddr) {\n      args.push('-s', this.serverAddr);\n    }\n\n    this.process = spawn(this.frpcPath, args, {\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    this.process.stdout?.on('data', (data: Buffer) => {\n      const output = data.toString().trim();\n      if (output) {\n        this.logger.info(`[frpc] ${output}`);\n        this.checkConnectionStatus(output);\n      }\n    });\n\n    this.process.stderr?.on('data', (data: Buffer) => {\n      const output = data.toString().trim();\n      if (output) {\n        this.logger.warn(`[frpc] ${output}`);\n        this.checkConnectionStatus(output);\n      }\n    });\n\n    this.process.on('exit', (code) => {\n      this.logger.info(`frpc exited with code ${code}`);\n      this.status = { running: false, connected: false };\n      this.process = null;\n      this.managedByUs = false;\n    });\n\n    this.process.on('error', (error) => {\n      this.logger.error(`Failed to start frpc: ${error.message}`);\n      this.status = { running: false, connected: false, error: error.message };\n      this.process = null;\n      this.managedByUs = false;\n    });\n\n    this.currentConfig = actualConfig;\n\n    // 等待连接\n    await this.waitForConnection();\n  }\n\n  private checkConnectionStatus(output: string): void {\n    // 检测连接成功的关键字\n    if (\n      output.includes('start proxy success') ||\n      output.includes('login to server success') ||\n      output.includes('tunnel running')\n    ) {\n      this.status.connected = true;\n      this.status.lastHeartbeat = new Date();\n      this.logger.info('SakuraFRP tunnel connected');\n    }\n\n    // 检测错误\n    if (output.includes('error') || output.includes('failed')) {\n      this.status.error = output;\n    }\n  }\n\n  /**\n   * 停止隧道\n   */\n  async stop(): Promise<void> {\n    if (!this.managedByUs) {\n      this.logger.info('Not managed by us, skipping stop');\n      this.status = { running: false, connected: false };\n      return;\n    }\n\n    if (this.process) {\n      this.logger.info('Stopping SakuraFRP tunnel...');\n      this.process.kill('SIGTERM');\n\n      await new Promise<void>((resolve) => {\n        const timeout = setTimeout(() => {\n          this.logger.info('Force killing frpc...');\n          this.process?.kill('SIGKILL');\n          resolve();\n        }, 5000);\n\n        this.process?.on('exit', () => {\n          clearTimeout(timeout);\n          resolve();\n        });\n      });\n\n      this.process = null;\n      this.logger.info('SakuraFRP tunnel stopped');\n    }\n\n    this.status = { running: false, connected: false };\n    this.managedByUs = false;\n  }\n\n  getStatus(): TunnelStatus {\n    return { ...this.status };\n  }\n\n  getEndpoint(): string | undefined {\n    return this.currentConfig?.endpoint;\n  }\n\n  async cleanup(_config: TunnelConfig): Promise<void> {\n    await this.stop();\n    this.currentConfig = null;\n  }\n\n  /**\n   * 检测 frpc 是否已经在运行\n   */\n  private isFrpcRunning(): boolean {\n    try {\n      if (process.platform === 'win32') {\n        execSync('tasklist /FI \"IMAGENAME eq frpc.exe\" | find \"frpc\"', {\n          stdio: 'ignore',\n        });\n      } else {\n        execSync('pgrep -x frpc', { stdio: 'ignore' });\n      }\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private async waitForConnection(timeout = 30000): Promise<void> {\n    const start = Date.now();\n\n    while (Date.now() - start < timeout) {\n      if (this.status.connected) {\n        return;\n      }\n\n      if (!this.status.running && this.status.error) {\n        throw new Error(`SakuraFRP failed to start: ${this.status.error}`);\n      }\n\n      await new Promise((r) => setTimeout(r, 500));\n    }\n\n    this.logger.warn('Connection timeout, tunnel may still be connecting...');\n  }\n\n  isManagedByUs(): boolean {\n    return this.managedByUs;\n  }\n}\n"]}

package/dist/tunnel/TunnelProvider.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Tunnel Provider Interface
+ *
+ * 抽象隧道服务，支持多种实现：
+ * - CloudflareTunnelProvider: Cloudflare Tunnel（阶段 1）
+ * - FrpTunnelProvider: FRP（阶段 2，自建或第三方）
+ */
+/**
+ * 隧道配置
+ */
+export interface TunnelConfig {
+    /** 子域名 (如 mynode，完整域名为 mynode.pods.undefieds.co) */
+    subdomain: string;
+    /** 隧道类型 */
+    provider: 'cloudflare' | 'frp' | 'sakura-frp';
+    /** 公网访问端点 (如 https://mynode.pods.undefieds.co) */
+    endpoint: string;
+    /** Cloudflare Tunnel Token (cloudflare 专用) */
+    tunnelToken?: string;
+    /** Cloudflare Tunnel ID (cloudflare 专用) */
+    tunnelId?: string;
+    /** FRP 服务器地址 (frp 专用) */
+    frpServer?: string;
+    /** FRP 服务器端口 (frp 专用) */
+    frpServerPort?: number;
+    /** FRP Token (frp 专用) */
+    frpToken?: string;
+    /** FRP 远程端口 (frp 专用) */
+    frpRemotePort?: number;
+}
+/**
+ * 隧道设置参数
+ */
+export interface TunnelSetupOptions {
+    /** 子域名 */
+    subdomain: string;
+    /** 本地服务端口 */
+    localPort: number;
+    /** 本地服务协议 */
+    localProtocol?: 'http' | 'https';
+}
+/**
+ * 隧道状态
+ */
+export interface TunnelStatus {
+    /** 是否正在运行 */
+    running: boolean;
+    /** 连接状态 */
+    connected: boolean;
+    /** 公网端点 */
+    endpoint?: string;
+    /** 错误信息 */
+    error?: string;
+    /** 最后心跳时间 */
+    lastHeartbeat?: Date;
+}
+/**
+ * 隧道 Provider 接口
+ */
+export interface TunnelProvider {
+    /** Provider 名称 */
+    readonly name: string;
+    /**
+     * 初始化隧道（注册、分配资源）
+     * @param options 设置参数
+     * @returns 隧道配置
+     */
+    setup(options: TunnelSetupOptions): Promise<TunnelConfig>;
+    /**
+     * 启动隧道客户端
+     * @param config 隧道配置
+     */
+    start(config: TunnelConfig): Promise<void>;
+    /**
+     * 停止隧道
+     */
+    stop(): Promise<void>;
+    /**
+     * 获取隧道状态
+     */
+    getStatus(): TunnelStatus;
+    /**
+     * 获取公网访问端点
+     */
+    getEndpoint(): string | undefined;
+    /**
+     * 清理资源（删除隧道、DNS 记录等）
+     * @param config 隧道配置
+     */
+    cleanup(config: TunnelConfig): Promise<void>;
+}

package/dist/tunnel/TunnelProvider.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Tunnel Provider Interface
+ *
+ * 抽象隧道服务，支持多种实现：
+ * - CloudflareTunnelProvider: Cloudflare Tunnel（阶段 1）
+ * - FrpTunnelProvider: FRP（阶段 2，自建或第三方）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TunnelProvider.js.map

package/dist/tunnel/TunnelProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TunnelProvider.js","sourceRoot":"","sources":["../../src/tunnel/TunnelProvider.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG","sourcesContent":["/**\n * Tunnel Provider Interface\n * \n * 抽象隧道服务，支持多种实现：\n * - CloudflareTunnelProvider: Cloudflare Tunnel（阶段 1）\n * - FrpTunnelProvider: FRP（阶段 2，自建或第三方）\n */\n\n/**\n * 隧道配置\n */\nexport interface TunnelConfig {\n  /** 子域名 (如 mynode，完整域名为 mynode.pods.undefieds.co) */\n  subdomain: string;\n\n  /** 隧道类型 */\n  provider: 'cloudflare' | 'frp' | 'sakura-frp';\n\n  /** 公网访问端点 (如 https://mynode.pods.undefieds.co) */\n  endpoint: string;\n\n  /** Cloudflare Tunnel Token (cloudflare 专用) */\n  tunnelToken?: string;\n\n  /** Cloudflare Tunnel ID (cloudflare 专用) */\n  tunnelId?: string;\n\n  /** FRP 服务器地址 (frp 专用) */\n  frpServer?: string;\n\n  /** FRP 服务器端口 (frp 专用) */\n  frpServerPort?: number;\n\n  /** FRP Token (frp 专用) */\n  frpToken?: string;\n\n  /** FRP 远程端口 (frp 专用) */\n  frpRemotePort?: number;\n}\n\n/**\n * 隧道设置参数\n */\nexport interface TunnelSetupOptions {\n  /** 子域名 */\n  subdomain: string;\n\n  /** 本地服务端口 */\n  localPort: number;\n\n  /** 本地服务协议 */\n  localProtocol?: 'http' | 'https';\n}\n\n/**\n * 隧道状态\n */\nexport interface TunnelStatus {\n  /** 是否正在运行 */\n  running: boolean;\n\n  /** 连接状态 */\n  connected: boolean;\n\n  /** 公网端点 */\n  endpoint?: string;\n\n  /** 错误信息 */\n  error?: string;\n\n  /** 最后心跳时间 */\n  lastHeartbeat?: Date;\n}\n\n/**\n * 隧道 Provider 接口\n */\nexport interface TunnelProvider {\n  /** Provider 名称 */\n  readonly name: string;\n\n  /**\n   * 初始化隧道（注册、分配资源）\n   * @param options 设置参数\n   * @returns 隧道配置\n   */\n  setup(options: TunnelSetupOptions): Promise<TunnelConfig>;\n\n  /**\n   * 启动隧道客户端\n   * @param config 隧道配置\n   */\n  start(config: TunnelConfig): Promise<void>;\n\n  /**\n   * 停止隧道\n   */\n  stop(): Promise<void>;\n\n  /**\n   * 获取隧道状态\n   */\n  getStatus(): TunnelStatus;\n\n  /**\n   * 获取公网访问端点\n   */\n  getEndpoint(): string | undefined;\n\n  /**\n   * 清理资源（删除隧道、DNS 记录等）\n   * @param config 隧道配置\n   */\n  cleanup(config: TunnelConfig): Promise<void>;\n}\n"]}

package/dist/tunnel/TunnelProvider.jsonld

@@ -0,0 +1,144 @@
+{
+  "@context": [
+    "https://linkedsoftwaredependencies.org/bundles/npm/@undefineds.co/xpod/^0.0.0/components/context.jsonld"
+  ],
+  "@id": "npmd:@undefineds.co/xpod",
+  "components": [
+    {
+      "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider",
+      "@type": "AbstractClass",
+      "requireElement": "TunnelProvider",
+      "comment": "隧道 Provider 接口",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_name",
+          "memberFieldName": "name"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_setup",
+          "memberFieldName": "setup"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_start",
+          "memberFieldName": "start"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_stop",
+          "memberFieldName": "stop"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_getStatus",
+          "memberFieldName": "getStatus"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_getEndpoint",
+          "memberFieldName": "getEndpoint"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelProvider__member_cleanup",
+          "memberFieldName": "cleanup"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig",
+      "@type": "AbstractClass",
+      "requireElement": "TunnelConfig",
+      "comment": "隧道配置",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_provider",
+          "memberFieldName": "provider"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_endpoint",
+          "memberFieldName": "endpoint"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_tunnelToken",
+          "memberFieldName": "tunnelToken"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_tunnelId",
+          "memberFieldName": "tunnelId"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_frpServer",
+          "memberFieldName": "frpServer"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_frpServerPort",
+          "memberFieldName": "frpServerPort"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_frpToken",
+          "memberFieldName": "frpToken"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelConfig__member_frpRemotePort",
+          "memberFieldName": "frpRemotePort"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelSetupOptions",
+      "@type": "AbstractClass",
+      "requireElement": "TunnelSetupOptions",
+      "comment": "隧道设置参数",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelSetupOptions__member_subdomain",
+          "memberFieldName": "subdomain"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelSetupOptions__member_localPort",
+          "memberFieldName": "localPort"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelSetupOptions__member_localProtocol",
+          "memberFieldName": "localProtocol"
+        }
+      ],
+      "constructorArguments": []
+    },
+    {
+      "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus",
+      "@type": "AbstractClass",
+      "requireElement": "TunnelStatus",
+      "comment": "隧道状态",
+      "parameters": [],
+      "memberFields": [
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus__member_running",
+          "memberFieldName": "running"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus__member_connected",
+          "memberFieldName": "connected"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus__member_endpoint",
+          "memberFieldName": "endpoint"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus__member_error",
+          "memberFieldName": "error"
+        },
+        {
+          "@id": "undefineds:dist/tunnel/TunnelProvider.jsonld#TunnelStatus__member_lastHeartbeat",
+          "memberFieldName": "lastHeartbeat"
+        }
+      ],
+      "constructorArguments": []
+    }
+  ]
+}

package/dist/tunnel/index.d.ts

@@ -0,0 +1,3 @@
+export type { TunnelProvider, TunnelConfig, TunnelSetupOptions, TunnelStatus, } from './TunnelProvider';
+export { CloudflareTunnelProvider, type CloudflareTunnelProviderOptions, } from './CloudflareTunnelProvider';
+export { LocalTunnelProvider, type LocalTunnelProviderOptions, } from './LocalTunnelProvider';

package/dist/tunnel/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalTunnelProvider = exports.CloudflareTunnelProvider = void 0;
+var CloudflareTunnelProvider_1 = require("./CloudflareTunnelProvider");
+Object.defineProperty(exports, "CloudflareTunnelProvider", { enumerable: true, get: function () { return CloudflareTunnelProvider_1.CloudflareTunnelProvider; } });
+var LocalTunnelProvider_1 = require("./LocalTunnelProvider");
+Object.defineProperty(exports, "LocalTunnelProvider", { enumerable: true, get: function () { return LocalTunnelProvider_1.LocalTunnelProvider; } });
+//# sourceMappingURL=index.js.map

package/dist/tunnel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tunnel/index.ts"],"names":[],"mappings":";;;AAOA,uEAGoC;AAFlC,oIAAA,wBAAwB,OAAA;AAI1B,6DAG+B;AAF7B,0HAAA,mBAAmB,OAAA","sourcesContent":["export type {\n  TunnelProvider,\n  TunnelConfig,\n  TunnelSetupOptions,\n  TunnelStatus,\n} from './TunnelProvider';\n\nexport {\n  CloudflareTunnelProvider,\n  type CloudflareTunnelProviderOptions,\n} from './CloudflareTunnelProvider';\n\nexport {\n  LocalTunnelProvider,\n  type LocalTunnelProviderOptions,\n} from './LocalTunnelProvider';\n"]}

package/dist/util/LockContext.d.ts

@@ -0,0 +1,3 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+export type LockState = Map<string, number>;
+export declare const lockContext: AsyncLocalStorage<LockState>;

package/dist/util/LockContext.js

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

package/dist/util/LockContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LockContext.js","sourceRoot":"","sources":["../../src/util/LockContext.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAIxC,QAAA,WAAW,GAAG,IAAI,oCAAiB,EAAa,CAAC","sourcesContent":["import { AsyncLocalStorage } from 'node:async_hooks';\n\nexport type LockState = Map<string, number>;\n\nexport const lockContext = new AsyncLocalStorage<LockState>();\n"]}

package/dist/util/ResourceStoreFetch.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ResourceStoreFetch - 将 ResourceStore 包装成 fetch 接口
+ *
+ * 用于在服务端内部访问 Pod 数据，绕过 HTTP 层和 DPoP 认证。
+ * drizzle-solid 可以直接使用这个 fetch 函数。
+ */
+import type { ResourceStore } from '@solid/community-server';
+/**
+ * 创建一个基于 ResourceStore 的 fetch 函数
+ */
+export declare function createResourceStoreFetch(resourceStore: ResourceStore): typeof fetch;