@agentunion/fastaun 0.2.13

package/dist/transport.js

@@ -0,0 +1,355 @@
+/**
+ * RPC 传输层
+ *
+ * 基于 WebSocket（ws 包）的 JSON-RPC 2.0 传输层。
+ * 与 Python SDK 的 RPCTransport 完全对齐：
+ * - connect → 接收初始 challenge
+ * - call → 请求/响应匹配
+ * - 事件路由 → EventDispatcher
+ */
+import WebSocket from 'ws';
+import * as crypto from 'node:crypto';
+import { ConnectionError, SerializationError, TimeoutError, mapRemoteError } from './errors.js';
+import { isJsonObject } from './types.js';
+/** 协议事件名映射 */
+const EVENT_NAME_MAP = {
+    'message.received': 'message.received',
+    'message.recalled': 'message.recalled',
+    'message.ack': 'message.ack',
+    'group.changed': 'group.changed',
+    'group.message_created': 'group.message_created',
+    'storage.object_changed': 'storage.object_changed',
+};
+/**
+ * WebSocket JSON-RPC 2.0 传输层
+ */
+export class RPCTransport {
+    _dispatcher;
+    _timeout;
+    _onDisconnect;
+    _verifySsl;
+    _ws = null;
+    _closed = true;
+    _challenge = null;
+    _pending = new Map();
+    _idCounter = 0;
+    constructor(opts) {
+        this._dispatcher = opts.eventDispatcher;
+        this._timeout = opts.timeout ?? 10_000;
+        this._onDisconnect = opts.onDisconnect ?? null;
+        this._verifySsl = opts.verifySsl ?? true;
+    }
+    /** 设置默认 RPC 超时（毫秒） */
+    setTimeout(timeout) {
+        this._timeout = timeout;
+    }
+    /** 获取上次连接的 challenge 消息 */
+    get challenge() {
+        return this._challenge;
+    }
+    /**
+     * 连接到 Gateway WebSocket 端点。
+     * 返回初始 challenge 消息（如果有）。
+     */
+    async connect(url) {
+        // ws 8.x+ 中 rejectUnauthorized 需通过 https.Agent 传递
+        let wsOpts = undefined;
+        if (!this._verifySsl) {
+            const https = await import('https');
+            wsOpts = { agent: new https.Agent({ rejectUnauthorized: false }) };
+        }
+        const ws = new WebSocket(url, wsOpts);
+        return this._connectWithWs(ws);
+    }
+    /**
+     * 内部：使用已创建的 WebSocket 实例完成握手。
+     * 握手阶段（open 后到首条消息处理完毕）如果发生 error 或解析失败，
+     * 会回滚 _ws / _closed，确保不留下半连接状态。
+     */
+    _connectWithWs(ws) {
+        return new Promise((resolve, reject) => {
+            let initialResolved = false;
+            /** 握手失败时回滚内部状态，避免半连接 */
+            const rollback = () => {
+                this._ws = null;
+                this._closed = true;
+                try {
+                    ws.close();
+                }
+                catch { /* noop */ }
+            };
+            /** 清理握手阶段的临时监听器 */
+            const cleanupHandshakeListeners = () => {
+                try {
+                    ws.removeListener('message', onFirstMessage);
+                }
+                catch { /* noop */ }
+                try {
+                    ws.removeListener('error', onHandshakeError);
+                }
+                catch { /* noop */ }
+                try {
+                    ws.removeListener('open', onOpen);
+                }
+                catch { /* noop */ }
+            };
+            let connectTimeout = null;
+            const onHandshakeError = (err) => {
+                if (!initialResolved) {
+                    initialResolved = true;
+                    if (connectTimeout)
+                        clearTimeout(connectTimeout);
+                    cleanupHandshakeListeners();
+                    rollback();
+                    reject(new ConnectionError(`websocket connect failed: ${err.message}`));
+                }
+            };
+            const onOpen = () => {
+                // 防止超时/错误已 rollback 后，迟到的 open 事件重新赋值 _ws 导致 zombie 连接
+                if (initialResolved)
+                    return;
+                this._ws = ws;
+                this._closed = false;
+                // 等待第一条消息作为 challenge
+            };
+            const onFirstMessage = (data) => {
+                if (!initialResolved) {
+                    // 第一条消息：尝试解析为 challenge
+                    initialResolved = true;
+                    if (connectTimeout)
+                        clearTimeout(connectTimeout);
+                    cleanupHandshakeListeners();
+                    try {
+                        const message = this._decodeMessage(data);
+                        if (message.method === 'challenge') {
+                            this._challenge = message;
+                            this._setupListeners(ws);
+                            resolve(message);
+                        }
+                        else {
+                            this._challenge = null;
+                            this._setupListeners(ws);
+                            // 非 challenge 消息，路由处理后返回 null
+                            this._routeMessage(message);
+                            resolve(null);
+                        }
+                    }
+                    catch (err) {
+                        // 握手消息解析失败：回滚状态，不留半连接
+                        rollback();
+                        reject(err instanceof Error ? err : new SerializationError(String(err)));
+                    }
+                    return;
+                }
+                // 后续消息由 _setupListeners 处理
+            };
+            ws.on('error', onHandshakeError);
+            ws.on('open', onOpen);
+            ws.on('message', onFirstMessage);
+            // 连接超时覆盖整个握手流程（open + 等待 challenge）。
+            // 不在 open 时清除，防止服务端沉默导致 Promise 永远不 resolve。
+            connectTimeout = setTimeout(() => {
+                if (!initialResolved) {
+                    initialResolved = true;
+                    cleanupHandshakeListeners();
+                    rollback();
+                    reject(new ConnectionError('websocket connect timeout'));
+                }
+            }, this._timeout);
+        });
+    }
+    /** 关闭连接 */
+    async close() {
+        this._closed = true;
+        // 取消所有待处理的 RPC
+        for (const [id, pending] of this._pending) {
+            clearTimeout(pending.timer);
+            pending.reject(new ConnectionError('transport closed'));
+        }
+        this._pending.clear();
+        if (this._ws) {
+            const ws = this._ws;
+            this._ws = null;
+            // M25: close() 返回前先移除路由相关的监听器，避免
+            // 超时强制 resolve 后，stale ws 仍把消息注入 _routeMessage 或
+            // 向 EventDispatcher 广播 connection.error。
+            try {
+                ws.removeAllListeners('message');
+            }
+            catch { /* noop */ }
+            try {
+                ws.removeAllListeners('error');
+            }
+            catch { /* noop */ }
+            return new Promise((resolve) => {
+                let settled = false;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    clearTimeout(timer);
+                    try {
+                        ws.removeAllListeners();
+                    }
+                    catch { /* noop */ }
+                    try {
+                        ws.terminate?.();
+                    }
+                    catch { /* noop */ }
+                    resolve();
+                };
+                ws.on('close', finish);
+                try {
+                    ws.close();
+                }
+                catch {
+                    finish();
+                    return;
+                }
+                // 超时强制解析，并在定时器触发时通过 terminate() 彻底清理残留 socket
+                const timer = setTimeout(finish, 3_000);
+            });
+        }
+    }
+    /**
+     * 发送 JSON-RPC 2.0 请求并等待响应。
+     */
+    async call(method, params, timeout) {
+        if (this._closed || !this._ws) {
+            throw new ConnectionError('transport not connected');
+        }
+        const rpcId = `rpc-${crypto.randomBytes(8).toString('hex')}`;
+        const effectiveTimeout = timeout ?? this._timeout;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pending.delete(rpcId);
+                reject(new TimeoutError(`rpc timeout: ${method}`, { retryable: true }));
+            }, effectiveTimeout);
+            this._pending.set(rpcId, {
+                resolve: (response) => {
+                    clearTimeout(timer);
+                    if (response.error !== undefined) {
+                        reject(mapRemoteError(response.error));
+                    }
+                    else if (response.result !== undefined) {
+                        resolve(response.result);
+                    }
+                    else {
+                        reject(new SerializationError(`rpc response missing result and error: ${method}`));
+                    }
+                },
+                reject: (err) => {
+                    clearTimeout(timer);
+                    reject(err);
+                },
+                timer,
+            });
+            const payload = JSON.stringify({
+                jsonrpc: '2.0',
+                id: rpcId,
+                method,
+                params: params ?? {},
+            });
+            try {
+                this._ws.send(payload);
+            }
+            catch (err) {
+                this._pending.delete(rpcId);
+                clearTimeout(timer);
+                reject(new ConnectionError(`failed to send rpc ${method}: ${err instanceof Error ? err.message : String(err)}`));
+            }
+        });
+    }
+    // ── 内部方法 ────────────────────────────────────────────
+    /** 设置 WebSocket 监听器（首条消息已处理后调用） */
+    _setupListeners(ws) {
+        ws.on('message', (data) => {
+            try {
+                const message = this._decodeMessage(data);
+                this._routeMessage(message);
+            }
+            catch (err) {
+                // 解析异常，发布错误事件
+                this._dispatcher.publish('connection.error', {
+                    error: err instanceof Error ? err : String(err),
+                });
+            }
+        });
+        ws.on('close', (code) => {
+            const wasClosed = this._closed;
+            this._closed = true;
+            if (!wasClosed && this._onDisconnect) {
+                const cb = this._onDisconnect;
+                Promise.resolve(cb(null, code)).catch(() => console.warn('[aun_core.transport] disconnect 回调异常'));
+            }
+        });
+        ws.on('error', (err) => {
+            if (!this._closed) {
+                this._dispatcher.publish('connection.error', { error: err });
+            }
+        });
+    }
+    /** 路由消息：RPC 响应 / challenge / 事件 / 通知 */
+    _routeMessage(message) {
+        // RPC 响应（有 id 字段）
+        if ('id' in message) {
+            const rpcId = String(message.id);
+            const pending = this._pending.get(rpcId);
+            if (pending) {
+                this._pending.delete(rpcId);
+                pending.resolve(message);
+            }
+            return;
+        }
+        const method = String(message.method ?? '');
+        // Challenge 消息
+        if (method === 'challenge') {
+            this._challenge = message;
+            this._dispatcher.publish('connection.challenge', message.params ?? {});
+            return;
+        }
+        // 事件消息（event/ 前缀）
+        if (method.startsWith('event/')) {
+            const protocolEvent = method.slice('event/'.length);
+            const sdkEvent = EVENT_NAME_MAP[protocolEvent] ?? protocolEvent;
+            // 发布为 _raw.{event}，由 AUNClient 处理后再发布用户可见的事件
+            this._dispatcher.publish(`_raw.${sdkEvent}`, message.params ?? {});
+            return;
+        }
+        // 其他通知
+        this._dispatcher.publish('notification', message);
+    }
+    /** 解码 WebSocket 消息为 JSON 对象 */
+    _decodeMessage(raw) {
+        if (isJsonObject(raw)) {
+            return raw;
+        }
+        let str;
+        if (Buffer.isBuffer(raw)) {
+            str = raw.toString('utf-8');
+        }
+        else if (Array.isArray(raw)) {
+            str = Buffer.concat(raw).toString('utf-8');
+        }
+        else if (raw instanceof ArrayBuffer) {
+            str = Buffer.from(raw).toString('utf-8');
+        }
+        else if (typeof raw === 'string') {
+            str = raw;
+        }
+        else {
+            throw new SerializationError(`unsupported websocket payload type: ${typeof raw}`);
+        }
+        try {
+            const parsed = JSON.parse(str);
+            if (!isJsonObject(parsed)) {
+                throw new SerializationError('invalid json payload');
+            }
+            return parsed;
+        }
+        catch {
+            throw new SerializationError('invalid json payload');
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * AUN SDK 核心类型定义
+ */
+/** JSON 原子值 */
+export type JsonPrimitive = string | number | boolean | null;
+/** JSON 对象 */
+export interface JsonObject {
+    [key: string]: JsonValue | undefined;
+}
+/** JSON 数组 */
+export interface JsonArray extends Array<JsonValue> {
+}
+/** JSON 值 */
+export type JsonValue = JsonPrimitive | JsonObject | JsonArray;
+/** P2P 投递模式 */
+export type DeliveryMode = 'fanout' | 'queue';
+/** 判断值是否为普通 JSON 对象 */
+export declare function isJsonObject(value: JsonValue | object | null | undefined): value is JsonObject;
+/** RPC 参数 */
+export interface RpcParams extends JsonObject {
+}
+/** RPC 返回值 */
+export type RpcResult = JsonValue;
+/** RPC 错误对象 */
+export interface RpcErrorObject extends JsonObject {
+    code?: number;
+    message?: string;
+    data?: JsonValue;
+}
+/** RPC 消息 */
+export interface RpcMessage extends JsonObject {
+    jsonrpc?: string;
+    id?: string | number | null;
+    method?: string;
+    params?: JsonObject;
+    result?: RpcResult;
+    error?: RpcErrorObject;
+}
+/** Gateway 条目 */
+export interface GatewayEntry extends JsonObject {
+    url?: string;
+    priority?: number;
+}
+/** Gateway 发现文档 */
+export interface GatewayDiscoveryDocument extends JsonObject {
+    gateways?: GatewayEntry[];
+}
+/** 身份密钥对记录 */
+export interface KeyPairRecord extends JsonObject {
+    private_key_pem?: string;
+    public_key_der_b64?: string;
+    curve?: string;
+}
+/** E2EE prekey 记录 */
+export interface PrekeyRecord extends JsonObject {
+    prekey_id?: string;
+    public_key?: string;
+    signature?: string;
+    private_key_pem?: string;
+    created_at?: number;
+    updated_at?: number;
+    expires_at?: number;
+}
+/** prekey 映射 */
+export type PrekeyMap = Record<string, PrekeyRecord>;
+/** 群组旧 epoch 记录 */
+export interface GroupOldEpochRecord extends JsonObject {
+    epoch?: number;
+    secret?: string;
+    commitment?: string;
+    member_aids?: string[];
+    epoch_chain?: string;
+    epoch_chain_unverified?: boolean;
+    epoch_chain_unverified_reason?: string;
+    pending_rotation_id?: string;
+    pending_created_at?: number;
+    secret_protection?: JsonObject;
+    created_at?: number;
+    updated_at?: number;
+    expires_at?: number;
+}
+/** 群组密钥状态 */
+export interface GroupSecretRecord extends JsonObject {
+    group_id?: string;
+    epoch?: number;
+    secret?: string;
+    commitment?: string;
+    member_aids?: string[];
+    epoch_chain?: string;
+    epoch_chain_unverified?: boolean;
+    epoch_chain_unverified_reason?: string;
+    pending_rotation_id?: string;
+    pending_created_at?: number;
+    updated_at?: number;
+    secret_protection?: JsonObject;
+    old_epochs?: GroupOldEpochRecord[];
+}
+/** metadata 记录 */
+export interface MetadataRecord extends JsonObject {
+    access_token?: string;
+    refresh_token?: string;
+    kite_token?: string;
+    e2ee_prekeys?: PrekeyMap;
+    e2ee_sessions?: JsonObject[];
+}
+/** 身份记录 */
+export interface IdentityRecord extends MetadataRecord, KeyPairRecord {
+    aid?: string;
+    cert?: string;
+    cert_pem?: string;
+    token?: string;
+    token_exp?: number;
+    expires_at?: number;
+}
+/** E2EE session 记录 */
+export interface SessionRecord extends JsonObject {
+    session_id?: string;
+    key?: string;
+    key_protection?: JsonObject;
+    peer_aid?: string;
+    created_at?: number;
+    updated_at?: number;
+    expires_at?: number;
+}
+/** SecretStore 加密记录 */
+export interface SecretRecord extends JsonObject {
+    scheme?: string;
+    name?: string;
+    persisted?: boolean;
+    nonce?: string;
+    ciphertext?: string;
+    tag?: string;
+    iv?: string;
+}
+/** 消息结构 */
+export interface Message extends JsonObject {
+    message_id?: string;
+    seq?: number;
+    from?: string;
+    to?: string;
+    type?: string;
+    payload?: JsonValue;
+    encrypted?: boolean;
+    delivery_mode?: DeliveryMode;
+    timestamp?: number;
+    e2ee?: JsonObject;
+    group_id?: string;
+    sender_aid?: string;
+    direction?: string;
+}
+/** 发送结果 */
+export interface SendResult extends JsonObject {
+    ok?: boolean;
+    message_id?: string;
+    seq?: number;
+    timestamp?: number;
+    status?: 'sent' | 'delivered' | 'duplicate';
+    delivery_mode?: DeliveryMode;
+}
+/** 确认结果 */
+export interface AckResult extends JsonObject {
+    success?: boolean;
+    ack_seq?: number;
+}
+/** 拉取结果 */
+export interface PullResult extends JsonObject {
+    messages?: Message[];
+    count?: number;
+    latest_seq?: number;
+}

package/dist/types.js

@@ -0,0 +1,12 @@
+/**
+ * AUN SDK 核心类型定义
+ */
+/** 判断值是否为普通 JSON 对象 */
+export function isJsonObject(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,uBAAuB;AACvB,MAAM,UAAU,YAAY,CAAC,KAA4C;IACvE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@agentunion/fastaun",
+  "version": "0.2.13",
+  "description": "AUN Protocol Core SDK for Node.js",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration/e2ee.test.ts",
+    "test:e2e": "vitest run tests/e2e/group-e2ee.test.ts",
+    "test:federation": "vitest run tests/integration/federation.test.ts tests/integration/federation-storage.test.ts",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "@vitest/coverage-v8": "^4.1.3",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  }
+}