@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/sdk/SignalingClientAdapter.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * SignalingClient 到 SignalingConnector 的适配器
+ *
+ * 将 SignalingClient 适配为 xpodFetch 需要的 SignalingConnector 接口
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SignalingClientAdapter = void 0;
+const SignalingClient_1 = require("../signaling/SignalingClient");
+/**
+ * SignalingClient 适配器
+ */
+class SignalingClientAdapter {
+    constructor(options) {
+        this.connected = false;
+        this.authenticated = false;
+        this.client = new SignalingClient_1.SignalingClient(options);
+        // 设置事件处理
+        this.client.on('connected', () => {
+            this.connected = true;
+        });
+        this.client.on('authenticated', () => {
+            this.authenticated = true;
+            this.authResolve?.();
+        });
+        this.client.on('authFailed', (error) => {
+            this.authReject?.(new Error(`Authentication failed: ${error}`));
+        });
+        this.client.on('disconnected', () => {
+            this.connected = false;
+            this.authenticated = false;
+        });
+        // RTC 消息处理
+        this.client.on('rtcAnswer', (message) => {
+            this.answerHandler?.(message.from, message.sessionId, message.sdp);
+        });
+        this.client.on('rtcIce', (message) => {
+            this.iceCandidateHandler?.(message.from, message.sessionId, message.candidate, message.sdpMid, message.sdpMLineIndex);
+        });
+        this.client.on('rtcClose', (message) => {
+            this.closeHandler?.(message.from, message.reason);
+        });
+    }
+    async connect() {
+        if (this.authenticated) {
+            return;
+        }
+        this.authPromise = new Promise((resolve, reject) => {
+            this.authResolve = resolve;
+            this.authReject = reject;
+        });
+        this.client.connect();
+        return this.authPromise;
+    }
+    disconnect() {
+        this.client.disconnect();
+        this.connected = false;
+        this.authenticated = false;
+    }
+    isConnected() {
+        return this.authenticated;
+    }
+    getSender() {
+        return {
+            sendOffer: (targetId, sdp, sessionId) => {
+                this.client.sendOffer(targetId, sdp, sessionId);
+            },
+            sendIceCandidate: (targetId, candidate, sessionId, sdpMid, sdpMLineIndex) => {
+                this.client.sendIceCandidate(targetId, candidate, sessionId, sdpMid, sdpMLineIndex);
+            },
+            sendClose: (targetId, sessionId, reason) => {
+                this.client.sendClose(targetId, sessionId, reason);
+            },
+        };
+    }
+    onAnswer(handler) {
+        this.answerHandler = handler;
+    }
+    onIceCandidate(handler) {
+        this.iceCandidateHandler = handler;
+    }
+    onClose(handler) {
+        this.closeHandler = handler;
+    }
+    /**
+     * 获取底层的 SignalingClient
+     */
+    getClient() {
+        return this.client;
+    }
+    /**
+     * 更新节点状态（用于心跳）
+     */
+    updateStatus(status) {
+        this.client.updateStatus(status);
+    }
+}
+exports.SignalingClientAdapter = SignalingClientAdapter;
+//# sourceMappingURL=SignalingClientAdapter.js.map

package/dist/sdk/SignalingClientAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalingClientAdapter.js","sourceRoot":"","sources":["../../src/sdk/SignalingClientAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * SignalingClient 到 SignalingConnector 的适配器\n *\n * 将 SignalingClient 适配为 xpodFetch 需要的 SignalingConnector 接口\n */\n\nimport { SignalingClient, type SignalingClientOptions } from '../signaling/SignalingClient';\nimport type { SignalingConnector } from './xpodFetch';\nimport type { ClientSignalingSender } from '../webrtc/WebRTCClient';\n\n/**\n * SignalingClient 适配器\n */\nexport class SignalingClientAdapter implements SignalingConnector {\n  private readonly client: SignalingClient;\n  private answerHandler?: (nodeId: string, sessionId: string, sdp: string) => void;\n  private iceCandidateHandler?: (\n    nodeId: string,\n    sessionId: string,\n    candidate: string,\n    sdpMid?: string,\n    sdpMLineIndex?: number,\n  ) => void;\n  private closeHandler?: (nodeId: string, reason?: string) => void;\n\n  private connected = false;\n  private authenticated = false;\n  private authPromise?: Promise<void>;\n  private authResolve?: () => void;\n  private authReject?: (error: Error) => void;\n\n  public constructor(options: SignalingClientOptions) {\n    this.client = new SignalingClient(options);\n\n    // 设置事件处理\n    this.client.on('connected', () => {\n      this.connected = true;\n    });\n\n    this.client.on('authenticated', () => {\n      this.authenticated = true;\n      this.authResolve?.();\n    });\n\n    this.client.on('authFailed', (error) => {\n      this.authReject?.(new Error(`Authentication failed: ${error}`));\n    });\n\n    this.client.on('disconnected', () => {\n      this.connected = false;\n      this.authenticated = false;\n    });\n\n    // RTC 消息处理\n    this.client.on('rtcAnswer', (message) => {\n      this.answerHandler?.(message.from, message.sessionId, message.sdp);\n    });\n\n    this.client.on('rtcIce', (message) => {\n      this.iceCandidateHandler?.(\n        message.from,\n        message.sessionId,\n        message.candidate,\n        message.sdpMid,\n        message.sdpMLineIndex,\n      );\n    });\n\n    this.client.on('rtcClose', (message) => {\n      this.closeHandler?.(message.from, message.reason);\n    });\n  }\n\n  public async connect(): Promise<void> {\n    if (this.authenticated) {\n      return;\n    }\n\n    this.authPromise = new Promise((resolve, reject) => {\n      this.authResolve = resolve;\n      this.authReject = reject;\n    });\n\n    this.client.connect();\n\n    return this.authPromise;\n  }\n\n  public disconnect(): void {\n    this.client.disconnect();\n    this.connected = false;\n    this.authenticated = false;\n  }\n\n  public isConnected(): boolean {\n    return this.authenticated;\n  }\n\n  public getSender(): ClientSignalingSender {\n    return {\n      sendOffer: (targetId, sdp, sessionId): void => {\n        this.client.sendOffer(targetId, sdp, sessionId);\n      },\n      sendIceCandidate: (targetId, candidate, sessionId, sdpMid, sdpMLineIndex): void => {\n        this.client.sendIceCandidate(targetId, candidate, sessionId, sdpMid, sdpMLineIndex);\n      },\n      sendClose: (targetId, sessionId, reason): void => {\n        this.client.sendClose(targetId, sessionId, reason);\n      },\n    };\n  }\n\n  public onAnswer(handler: (nodeId: string, sessionId: string, sdp: string) => void): void {\n    this.answerHandler = handler;\n  }\n\n  public onIceCandidate(\n    handler: (\n      nodeId: string,\n      sessionId: string,\n      candidate: string,\n      sdpMid?: string,\n      sdpMLineIndex?: number,\n    ) => void,\n  ): void {\n    this.iceCandidateHandler = handler;\n  }\n\n  public onClose(handler: (nodeId: string, reason?: string) => void): void {\n    this.closeHandler = handler;\n  }\n\n  /**\n   * 获取底层的 SignalingClient\n   */\n  public getClient(): SignalingClient {\n    return this.client;\n  }\n\n  /**\n   * 更新节点状态（用于心跳）\n   */\n  public updateStatus(status: Parameters<SignalingClient['updateStatus']>[0]): void {\n    this.client.updateStatus(status);\n  }\n}\n"]}

package/dist/sdk/createFetch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * createFetch - 创建通过 WebRTC 连接 Local 节点的 fetch 函数
+ *
+ * 简化的 SDK 入口，只需要 Cloud 信令地址即可使用
+ */
+/**
+ * createFetch 配置选项
+ */
+export interface CreateFetchOptions {
+    /** Cloud 信令服务地址 */
+    signalingUrl: string;
+    /** 请求超时（毫秒），默认 30000 */
+    requestTimeout?: number;
+    /** 连接超时（毫秒），默认 30000 */
+    connectionTimeout?: number;
+}
+/**
+ * 创建 fetch 函数
+ *
+ * @param options - 配置选项
+ * @returns fetch 兼容的函数
+ */
+export declare function createFetch(options: CreateFetchOptions): typeof fetch;

package/dist/sdk/createFetch.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * createFetch - 创建通过 WebRTC 连接 Local 节点的 fetch 函数
+ *
+ * 简化的 SDK 入口，只需要 Cloud 信令地址即可使用
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFetch = createFetch;
+const SignalingClient_1 = require("../signaling/SignalingClient");
+const WebRTCClient_1 = require("../webrtc/WebRTCClient");
+const WeriftPeerConnectionFactory_1 = require("../webrtc/WeriftPeerConnectionFactory");
+/**
+ * 创建 fetch 函数
+ *
+ * @param options - 配置选项
+ * @returns fetch 兼容的函数
+ */
+function createFetch(options) {
+    const { signalingUrl, requestTimeout = 30000, connectionTimeout = 30000 } = options;
+    // 内部状态
+    const state = {
+        signalingClient: new SignalingClient_1.SignalingClient({
+            url: signalingUrl,
+            connectionType: 'client',
+        }),
+        webrtcClient: null,
+        iceServers: [],
+        initialized: false,
+        initPromise: null,
+        pendingConnections: new Map(),
+    };
+    /**
+     * 初始化连接
+     */
+    async function initialize() {
+        if (state.initialized)
+            return;
+        if (state.initPromise)
+            return state.initPromise;
+        state.initPromise = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                reject(new Error('Signaling connection timeout'));
+            }, connectionTimeout);
+            state.signalingClient.on('authenticated', (iceServers) => {
+                clearTimeout(timeout);
+                state.iceServers = iceServers || [];
+                // 创建 WebRTC client
+                const peerConnectionFactory = new WeriftPeerConnectionFactory_1.WeriftPeerConnectionFactory();
+                const signalingSender = {
+                    sendOffer: (targetId, sdp, sessionId) => {
+                        state.signalingClient.sendOffer(targetId, sdp, sessionId);
+                    },
+                    sendIceCandidate: (targetId, candidate, sessionId, sdpMid, sdpMLineIndex) => {
+                        state.signalingClient.sendIceCandidate(targetId, candidate, sessionId, sdpMid, sdpMLineIndex);
+                    },
+                    sendClose: (targetId, sessionId, reason) => {
+                        state.signalingClient.sendClose(targetId, sessionId, reason);
+                    },
+                };
+                state.webrtcClient = new WebRTCClient_1.WebRTCClient(peerConnectionFactory, signalingSender, { iceServers: state.iceServers }, requestTimeout);
+                // 设置 WebRTC 事件处理
+                setupWebRTCHandlers();
+                state.initialized = true;
+                resolve();
+            });
+            state.signalingClient.on('authFailed', (error) => {
+                clearTimeout(timeout);
+                reject(new Error(`Authentication failed: ${error}`));
+            });
+            state.signalingClient.on('error', (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            });
+            // 连接信令服务
+            state.signalingClient.connect();
+        });
+        return state.initPromise;
+    }
+    /**
+     * 设置 WebRTC 事件处理
+     */
+    function setupWebRTCHandlers() {
+        if (!state.webrtcClient)
+            return;
+        // 处理 RTC answer
+        state.signalingClient.on('rtcAnswer', (message) => {
+            state.webrtcClient?.handleAnswer(message.from, message.sessionId, message.sdp);
+        });
+        // 处理 ICE candidate
+        state.signalingClient.on('rtcIce', (message) => {
+            state.webrtcClient?.handleIceCandidate(message.from, message.sessionId, message.candidate, message.sdpMid, message.sdpMLineIndex);
+        });
+        // 处理连接关闭
+        state.signalingClient.on('rtcClose', (message) => {
+            state.webrtcClient?.handleClose(message.from, message.reason);
+        });
+        // 处理连接成功
+        state.webrtcClient.on('connected', (nodeId) => {
+            const pending = state.pendingConnections.get(nodeId);
+            if (pending) {
+                pending.resolve();
+                state.pendingConnections.delete(nodeId);
+            }
+        });
+        // 处理连接失败
+        state.webrtcClient.on('disconnected', (nodeId, reason) => {
+            const pending = state.pendingConnections.get(nodeId);
+            if (pending) {
+                pending.reject(new Error(`Connection failed: ${reason ?? 'unknown'}`));
+                state.pendingConnections.delete(nodeId);
+            }
+        });
+    }
+    /**
+     * 从 URL 提取 nodeId
+     * 例如: http://local-node-1.example.com/ -> local-node-1
+     */
+    function urlToNodeId(url) {
+        const parsedUrl = new URL(url);
+        // 提取 hostname 的第一部分作为 nodeId
+        // 例如: local-node-1.example.com -> local-node-1
+        const hostname = parsedUrl.hostname;
+        const firstDot = hostname.indexOf('.');
+        return firstDot > 0 ? hostname.substring(0, firstDot) : hostname;
+    }
+    /**
+     * 确保与目标节点的连接已建立
+     */
+    async function ensureConnected(nodeId) {
+        if (!state.webrtcClient) {
+            throw new Error('WebRTC client not initialized');
+        }
+        if (state.webrtcClient.isConnected(nodeId)) {
+            return;
+        }
+        // 检查是否有待处理的连接
+        const pending = state.pendingConnections.get(nodeId);
+        if (pending) {
+            return pending.promise;
+        }
+        // 创建新连接
+        let resolve;
+        let reject;
+        const promise = new Promise((res, rej) => {
+            resolve = res;
+            reject = rej;
+        });
+        const timeoutId = setTimeout(() => {
+            state.pendingConnections.delete(nodeId);
+            state.webrtcClient?.disconnect(nodeId);
+            reject(new Error(`Connection timeout to node ${nodeId}`));
+        }, connectionTimeout);
+        state.pendingConnections.set(nodeId, {
+            promise,
+            resolve: () => {
+                clearTimeout(timeoutId);
+                resolve();
+            },
+            reject: (error) => {
+                clearTimeout(timeoutId);
+                reject(error);
+            },
+        });
+        // 发起连接
+        try {
+            await state.webrtcClient.connect(nodeId);
+        }
+        catch (error) {
+            state.pendingConnections.delete(nodeId);
+            throw error;
+        }
+        return promise;
+    }
+    /**
+     * 将 WebRTC 响应转换为 Fetch Response
+     */
+    function toFetchResponse(response, url) {
+        let body = null;
+        if (response.body) {
+            if (typeof Buffer !== 'undefined') {
+                body = Buffer.from(response.body, 'base64');
+            }
+            else {
+                const binaryString = atob(response.body);
+                const bytes = new Uint8Array(binaryString.length);
+                for (let i = 0; i < binaryString.length; i++) {
+                    bytes[i] = binaryString.charCodeAt(i);
+                }
+                body = bytes.buffer;
+            }
+        }
+        const fetchResponse = new Response(body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers: new Headers(response.headers),
+        });
+        Object.defineProperty(fetchResponse, 'url', {
+            value: url,
+            writable: false,
+        });
+        return fetchResponse;
+    }
+    /**
+     * fetch 实现
+     */
+    return async function xpodFetch(input, init) {
+        // 确保已初始化
+        await initialize();
+        const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;
+        const nodeId = urlToNodeId(url);
+        // 确保连接已建立
+        await ensureConnected(nodeId);
+        // 解析请求
+        const method = init?.method ?? 'GET';
+        const parsedUrl = new URL(url);
+        const path = parsedUrl.pathname + parsedUrl.search;
+        // 处理请求头
+        const headers = {};
+        if (init?.headers) {
+            if (init.headers instanceof Headers) {
+                init.headers.forEach((value, key) => {
+                    headers[key] = value;
+                });
+            }
+            else if (Array.isArray(init.headers)) {
+                for (const [key, value] of init.headers) {
+                    headers[key] = value;
+                }
+            }
+            else {
+                Object.assign(headers, init.headers);
+            }
+        }
+        // 处理请求体
+        let body;
+        if (init?.body) {
+            if (typeof init.body === 'string') {
+                body = init.body;
+            }
+            else if (init.body instanceof ArrayBuffer) {
+                body = init.body;
+            }
+            else if (init.body instanceof Uint8Array) {
+                body = init.body.buffer;
+            }
+            else if (typeof Blob !== 'undefined' && init.body instanceof Blob) {
+                body = await init.body.arrayBuffer();
+            }
+            else {
+                body = String(init.body);
+            }
+        }
+        // 发送请求
+        const response = await state.webrtcClient.fetch(nodeId, method, path, headers, body);
+        return toFetchResponse(response, url);
+    };
+}
+//# sourceMappingURL=createFetch.js.map

package/dist/sdk/createFetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFetch.js","sourceRoot":"","sources":["../../src/sdk/createFetch.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * createFetch - 创建通过 WebRTC 连接 Local 节点的 fetch 函数\n *\n * 简化的 SDK 入口，只需要 Cloud 信令地址即可使用\n */\n\nimport { SignalingClient } from '../signaling/SignalingClient';\nimport { WebRTCClient, type ClientSignalingSender } from '../webrtc/WebRTCClient';\nimport { WeriftPeerConnectionFactory } from '../webrtc/WeriftPeerConnectionFactory';\nimport type { WebRTCHttpResponse } from '../webrtc/types';\nimport type { RTCIceServer } from '../signaling/types';\n\n/**\n * createFetch 配置选项\n */\nexport interface CreateFetchOptions {\n  /** Cloud 信令服务地址 */\n  signalingUrl: string;\n  /** 请求超时（毫秒），默认 30000 */\n  requestTimeout?: number;\n  /** 连接超时（毫秒），默认 30000 */\n  connectionTimeout?: number;\n}\n\n/**\n * 内部状态管理\n */\ninterface FetchState {\n  signalingClient: SignalingClient;\n  webrtcClient: WebRTCClient | null;\n  iceServers: RTCIceServer[];\n  initialized: boolean;\n  initPromise: Promise<void> | null;\n  pendingConnections: Map<string, {\n    promise: Promise<void>;\n    resolve: () => void;\n    reject: (error: Error) => void;\n  }>;\n}\n\n/**\n * 创建 fetch 函数\n *\n * @param options - 配置选项\n * @returns fetch 兼容的函数\n */\nexport function createFetch(options: CreateFetchOptions): typeof fetch {\n  const { signalingUrl, requestTimeout = 30000, connectionTimeout = 30000 } = options;\n\n  // 内部状态\n  const state: FetchState = {\n    signalingClient: new SignalingClient({\n      url: signalingUrl,\n      connectionType: 'client',\n    }),\n    webrtcClient: null,\n    iceServers: [],\n    initialized: false,\n    initPromise: null,\n    pendingConnections: new Map(),\n  };\n\n  /**\n   * 初始化连接\n   */\n  async function initialize(): Promise<void> {\n    if (state.initialized) return;\n    if (state.initPromise) return state.initPromise;\n\n    state.initPromise = new Promise<void>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        reject(new Error('Signaling connection timeout'));\n      }, connectionTimeout);\n\n      state.signalingClient.on('authenticated', (iceServers) => {\n        clearTimeout(timeout);\n        state.iceServers = iceServers || [];\n\n        // 创建 WebRTC client\n        const peerConnectionFactory = new WeriftPeerConnectionFactory();\n        const signalingSender: ClientSignalingSender = {\n          sendOffer: (targetId, sdp, sessionId) => {\n            state.signalingClient.sendOffer(targetId, sdp, sessionId);\n          },\n          sendIceCandidate: (targetId, candidate, sessionId, sdpMid, sdpMLineIndex) => {\n            state.signalingClient.sendIceCandidate(targetId, candidate, sessionId, sdpMid, sdpMLineIndex);\n          },\n          sendClose: (targetId, sessionId, reason) => {\n            state.signalingClient.sendClose(targetId, sessionId, reason);\n          },\n        };\n\n        state.webrtcClient = new WebRTCClient(\n          peerConnectionFactory,\n          signalingSender,\n          { iceServers: state.iceServers },\n          requestTimeout,\n        );\n\n        // 设置 WebRTC 事件处理\n        setupWebRTCHandlers();\n\n        state.initialized = true;\n        resolve();\n      });\n\n      state.signalingClient.on('authFailed', (error) => {\n        clearTimeout(timeout);\n        reject(new Error(`Authentication failed: ${error}`));\n      });\n\n      state.signalingClient.on('error', (error) => {\n        clearTimeout(timeout);\n        reject(error);\n      });\n\n      // 连接信令服务\n      state.signalingClient.connect();\n    });\n\n    return state.initPromise;\n  }\n\n  /**\n   * 设置 WebRTC 事件处理\n   */\n  function setupWebRTCHandlers(): void {\n    if (!state.webrtcClient) return;\n\n    // 处理 RTC answer\n    state.signalingClient.on('rtcAnswer', (message) => {\n      state.webrtcClient?.handleAnswer(message.from, message.sessionId, message.sdp);\n    });\n\n    // 处理 ICE candidate\n    state.signalingClient.on('rtcIce', (message) => {\n      state.webrtcClient?.handleIceCandidate(\n        message.from,\n        message.sessionId,\n        message.candidate,\n        message.sdpMid,\n        message.sdpMLineIndex,\n      );\n    });\n\n    // 处理连接关闭\n    state.signalingClient.on('rtcClose', (message) => {\n      state.webrtcClient?.handleClose(message.from, message.reason);\n    });\n\n    // 处理连接成功\n    state.webrtcClient.on('connected', (nodeId) => {\n      const pending = state.pendingConnections.get(nodeId);\n      if (pending) {\n        pending.resolve();\n        state.pendingConnections.delete(nodeId);\n      }\n    });\n\n    // 处理连接失败\n    state.webrtcClient.on('disconnected', (nodeId, reason) => {\n      const pending = state.pendingConnections.get(nodeId);\n      if (pending) {\n        pending.reject(new Error(`Connection failed: ${reason ?? 'unknown'}`));\n        state.pendingConnections.delete(nodeId);\n      }\n    });\n  }\n\n  /**\n   * 从 URL 提取 nodeId\n   * 例如: http://local-node-1.example.com/ -> local-node-1\n   */\n  function urlToNodeId(url: string): string {\n    const parsedUrl = new URL(url);\n    // 提取 hostname 的第一部分作为 nodeId\n    // 例如: local-node-1.example.com -> local-node-1\n    const hostname = parsedUrl.hostname;\n    const firstDot = hostname.indexOf('.');\n    return firstDot > 0 ? hostname.substring(0, firstDot) : hostname;\n  }\n\n  /**\n   * 确保与目标节点的连接已建立\n   */\n  async function ensureConnected(nodeId: string): Promise<void> {\n    if (!state.webrtcClient) {\n      throw new Error('WebRTC client not initialized');\n    }\n\n    if (state.webrtcClient.isConnected(nodeId)) {\n      return;\n    }\n\n    // 检查是否有待处理的连接\n    const pending = state.pendingConnections.get(nodeId);\n    if (pending) {\n      return pending.promise;\n    }\n\n    // 创建新连接\n    let resolve: () => void;\n    let reject: (error: Error) => void;\n\n    const promise = new Promise<void>((res, rej) => {\n      resolve = res;\n      reject = rej;\n    });\n\n    const timeoutId = setTimeout(() => {\n      state.pendingConnections.delete(nodeId);\n      state.webrtcClient?.disconnect(nodeId);\n      reject!(new Error(`Connection timeout to node ${nodeId}`));\n    }, connectionTimeout);\n\n    state.pendingConnections.set(nodeId, {\n      promise,\n      resolve: () => {\n        clearTimeout(timeoutId);\n        resolve!();\n      },\n      reject: (error) => {\n        clearTimeout(timeoutId);\n        reject!(error);\n      },\n    });\n\n    // 发起连接\n    try {\n      await state.webrtcClient.connect(nodeId);\n    } catch (error) {\n      state.pendingConnections.delete(nodeId);\n      throw error;\n    }\n\n    return promise;\n  }\n\n  /**\n   * 将 WebRTC 响应转换为 Fetch Response\n   */\n  function toFetchResponse(response: WebRTCHttpResponse, url: string): Response {\n    let body: ArrayBuffer | null = null;\n    if (response.body) {\n      if (typeof Buffer !== 'undefined') {\n        body = Buffer.from(response.body, 'base64');\n      } else {\n        const binaryString = atob(response.body);\n        const bytes = new Uint8Array(binaryString.length);\n        for (let i = 0; i < binaryString.length; i++) {\n          bytes[i] = binaryString.charCodeAt(i);\n        }\n        body = bytes.buffer;\n      }\n    }\n\n    const fetchResponse = new Response(body, {\n      status: response.status,\n      statusText: response.statusText,\n      headers: new Headers(response.headers),\n    });\n\n    Object.defineProperty(fetchResponse, 'url', {\n      value: url,\n      writable: false,\n    });\n\n    return fetchResponse;\n  }\n\n  /**\n   * fetch 实现\n   */\n  return async function xpodFetch(\n    input: string | URL | Request,\n    init?: RequestInit,\n  ): Promise<Response> {\n    // 确保已初始化\n    await initialize();\n\n    const url = typeof input === 'string' ? input : input instanceof URL ? input.href : input.url;\n    const nodeId = urlToNodeId(url);\n\n    // 确保连接已建立\n    await ensureConnected(nodeId);\n\n    // 解析请求\n    const method = init?.method ?? 'GET';\n    const parsedUrl = new URL(url);\n    const path = parsedUrl.pathname + parsedUrl.search;\n\n    // 处理请求头\n    const headers: Record<string, string> = {};\n    if (init?.headers) {\n      if (init.headers instanceof Headers) {\n        init.headers.forEach((value, key) => {\n          headers[key] = value;\n        });\n      } else if (Array.isArray(init.headers)) {\n        for (const [key, value] of init.headers) {\n          headers[key] = value;\n        }\n      } else {\n        Object.assign(headers, init.headers);\n      }\n    }\n\n    // 处理请求体\n    let body: ArrayBuffer | string | undefined;\n    if (init?.body) {\n      if (typeof init.body === 'string') {\n        body = init.body;\n      } else if (init.body instanceof ArrayBuffer) {\n        body = init.body;\n      } else if (init.body instanceof Uint8Array) {\n        body = init.body.buffer as ArrayBuffer;\n      } else if (typeof Blob !== 'undefined' && init.body instanceof Blob) {\n        body = await init.body.arrayBuffer();\n      } else {\n        body = String(init.body);\n      }\n    }\n\n    // 发送请求\n    const response = await state.webrtcClient!.fetch(nodeId, method, path, headers, body);\n\n    return toFetchResponse(response, url);\n  };\n}\n"]}

package/dist/sdk/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * xpod SDK
+ *
+ * 提供 createFetch 函数，用于创建通过 WebRTC 连接 Local 节点的 fetch
+ *
+ * 使用示例：
+ * ```typescript
+ * import { createFetch } from 'xpod/sdk';
+ * import { Session } from '@inrupt/solid-client-authn-browser';
+ *
+ * // 创建 fetch，只需要 Cloud 信令地址
+ * const xpodFetch = createFetch({
+ *   signalingUrl: 'ws://cloud.example.com/ws/signaling',
+ * });
+ *
+ * // 创建 session 时传入
+ * const session = new Session({ fetch: xpodFetch });
+ *
+ * // 登录到 Local 节点（请求通过 WebRTC 转发）
+ * await session.login({
+ *   oidcIssuer: 'http://local-1.example.com/',
+ *   redirectUrl: window.location.href,
+ * });
+ *
+ * // 访问资源（也通过 WebRTC）
+ * const response = await session.fetch('http://local-1.example.com/pod/resource');
+ * ```
+ */
+export { createFetch, type CreateFetchOptions } from './createFetch';

package/dist/sdk/index.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * xpod SDK
+ *
+ * 提供 createFetch 函数，用于创建通过 WebRTC 连接 Local 节点的 fetch
+ *
+ * 使用示例：
+ * ```typescript
+ * import { createFetch } from 'xpod/sdk';
+ * import { Session } from '@inrupt/solid-client-authn-browser';
+ *
+ * // 创建 fetch，只需要 Cloud 信令地址
+ * const xpodFetch = createFetch({
+ *   signalingUrl: 'ws://cloud.example.com/ws/signaling',
+ * });
+ *
+ * // 创建 session 时传入
+ * const session = new Session({ fetch: xpodFetch });
+ *
+ * // 登录到 Local 节点（请求通过 WebRTC 转发）
+ * await session.login({
+ *   oidcIssuer: 'http://local-1.example.com/',
+ *   redirectUrl: window.location.href,
+ * });
+ *
+ * // 访问资源（也通过 WebRTC）
+ * const response = await session.fetch('http://local-1.example.com/pod/resource');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFetch = void 0;
+var createFetch_1 = require("./createFetch");
+Object.defineProperty(exports, "createFetch", { enumerable: true, get: function () { return createFetch_1.createFetch; } });
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAEH,6CAAqE;AAA5D,0GAAA,WAAW,OAAA","sourcesContent":["/**\n * xpod SDK\n *\n * 提供 createFetch 函数，用于创建通过 WebRTC 连接 Local 节点的 fetch\n *\n * 使用示例：\n * ```typescript\n * import { createFetch } from 'xpod/sdk';\n * import { Session } from '@inrupt/solid-client-authn-browser';\n *\n * // 创建 fetch，只需要 Cloud 信令地址\n * const xpodFetch = createFetch({\n *   signalingUrl: 'ws://cloud.example.com/ws/signaling',\n * });\n *\n * // 创建 session 时传入\n * const session = new Session({ fetch: xpodFetch });\n *\n * // 登录到 Local 节点（请求通过 WebRTC 转发）\n * await session.login({\n *   oidcIssuer: 'http://local-1.example.com/',\n *   redirectUrl: window.location.href,\n * });\n *\n * // 访问资源（也通过 WebRTC）\n * const response = await session.fetch('http://local-1.example.com/pod/resource');\n * ```\n */\n\nexport { createFetch, type CreateFetchOptions } from './createFetch';\n"]}

package/dist/sdk/xpodFetch.d.ts

@@ -0,0 +1,112 @@
+/**
+ * xpodFetch SDK
+ *
+ * 提供 fetch 兼容的 API，通过 WebRTC 连接 Local 节点
+ * 可与 Inrupt Solid SDK 集成
+ */
+import type { WebRTCConfig, PeerConnectionFactory } from '../webrtc/types';
+import { WebRTCClient, type ClientSignalingSender } from '../webrtc/WebRTCClient';
+/**
+ * 信令连接器接口
+ */
+export interface SignalingConnector {
+    /**
+     * 连接到信令服务器
+     */
+    connect(): Promise<void>;
+    /**
+     * 断开信令连接
+     */
+    disconnect(): void;
+    /**
+     * 检查是否已连接
+     */
+    isConnected(): boolean;
+    /**
+     * 获取信令发送器
+     */
+    getSender(): ClientSignalingSender;
+    /**
+     * 设置 RTC answer 处理器
+     */
+    onAnswer(handler: (nodeId: string, sessionId: string, sdp: string) => void): void;
+    /**
+     * 设置 ICE candidate 处理器
+     */
+    onIceCandidate(handler: (nodeId: string, sessionId: string, candidate: string, sdpMid?: string, sdpMLineIndex?: number) => void): void;
+    /**
+     * 设置 RTC close 处理器
+     */
+    onClose(handler: (nodeId: string, reason?: string) => void): void;
+}
+/**
+ * xpodFetch 配置
+ */
+export interface XpodFetchOptions {
+    /** 信令连接器 */
+    signalingConnector: SignalingConnector;
+    /** PeerConnection 工厂 */
+    peerConnectionFactory: PeerConnectionFactory;
+    /** WebRTC 配置 */
+    rtcConfig: WebRTCConfig;
+    /** 请求超时（毫秒） */
+    requestTimeout?: number;
+    /** 连接超时（毫秒） */
+    connectionTimeout?: number;
+    /** URL 到 nodeId 的映射函数 */
+    urlToNodeId: (url: string) => string | undefined;
+    /** 回退到普通 fetch（当无法使用 WebRTC 时） */
+    fallbackFetch?: typeof fetch;
+}
+/**
+ * xpodFetch 类
+ *
+ * 提供 fetch 兼容的 API，自动通过 WebRTC 连接 Local 节点
+ */
+export declare class XpodFetch {
+    private readonly signalingConnector;
+    private readonly webrtcClient;
+    private readonly urlToNodeId;
+    private readonly fallbackFetch?;
+    private readonly connectionTimeout;
+    /** 待处理的连接 */
+    private readonly pendingConnections;
+    constructor(options: XpodFetchOptions);
+    /**
+     * 初始化（连接信令服务器）
+     */
+    initialize(): Promise<void>;
+    /**
+     * 关闭连接
+     */
+    close(): void;
+    /**
+     * 创建 fetch 函数
+     *
+     * 返回一个可以与 Inrupt SDK 集成的 fetch 函数
+     */
+    createFetch(): typeof fetch;
+    /**
+     * 获取 WebRTC 客户端
+     */
+    getWebRTCClient(): WebRTCClient;
+    /**
+     * 检查是否已连接到指定节点
+     */
+    isConnectedToNode(nodeId: string): boolean;
+    /**
+     * 手动连接到指定节点
+     */
+    connectToNode(nodeId: string): Promise<void>;
+    /**
+     * 断开与指定节点的连接
+     */
+    disconnectFromNode(nodeId: string): void;
+    private setupSignalingHandlers;
+    private ensureConnected;
+    private toFetchResponse;
+}
+/**
+ * 创建 xpodFetch 实例的便捷函数
+ */
+export declare function createXpodFetch(options: XpodFetchOptions): XpodFetch;