@aigne/afs-did-space 1.12.0-beta.5

package/dist/transports/ws.cjs

@@ -0,0 +1,207 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_index = require('../packages/session/dist/index.cjs');
+let _aigne_afs = require("@aigne/afs");
+
+//#region src/transports/ws.ts
+const DEFAULT_NAMESPACE = "did-space-client";
+const DEFAULT_REQUEST_TIMEOUT = 3e4;
+const ALLOWED_WS_SCHEMES = new Set(["ws:", "wss:"]);
+function parseWsUrl(rawUrl) {
+	let parsed;
+	try {
+		parsed = new URL(rawUrl);
+	} catch {
+		throw new Error(`WsTransport: invalid URL: ${rawUrl}`);
+	}
+	if (!ALLOWED_WS_SCHEMES.has(parsed.protocol)) throw new Error(`WsTransport: only ws(s) is supported, got ${parsed.protocol} (URL: ${rawUrl})`);
+	const port = parsed.port ? Number(parsed.port) : parsed.protocol === "wss:" ? 443 : 80;
+	return {
+		host: parsed.hostname,
+		port
+	};
+}
+function mapWireError(code, message, path) {
+	switch (code) {
+		case "not_found": return new _aigne_afs.AFSNotFoundError(path, message);
+		case "conflict": return new _aigne_afs.AFSConflictError(path, {
+			cid: null,
+			mtime: null,
+			deviceId: null
+		});
+		case "compacted": return new _aigne_afs.AFSCompactedError(path, "0");
+		case "validation": return new _aigne_afs.AFSValidationError(message);
+		default: return /* @__PURE__ */ new Error(`WsTransport ${code}: ${message}`);
+	}
+}
+var WsTransport = class {
+	kind = "ws";
+	url;
+	token;
+	namespace;
+	requestTimeout;
+	ws = null;
+	rpc;
+	pendingBinary = new require_index.PendingBinaryBuffer();
+	subs = /* @__PURE__ */ new Map();
+	connected = false;
+	closed = false;
+	constructor(options) {
+		parseWsUrl(options.url);
+		this.url = options.url;
+		this.token = options.token;
+		this.namespace = options.namespace ?? DEFAULT_NAMESPACE;
+		this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
+		this.rpc = new require_index.RPCHandler({
+			startId: 1,
+			idIncrement: 2,
+			timeout: this.requestTimeout
+		});
+	}
+	async connect() {
+		if (this.closed) throw new Error("WsTransport: already closed");
+		if (this.connected) return;
+		const { host, port } = parseWsUrl(this.url);
+		const ws = new require_index.WebSocketClient({
+			host,
+			port,
+			authToken: this.token
+		});
+		await ws.connect();
+		this.ws = ws;
+		this.connected = true;
+		ws.on("frame", (frame) => this.handleFrame(frame));
+		ws.on("close", () => {
+			this.connected = false;
+			this.rpc.rejectAll(/* @__PURE__ */ new Error("WsTransport: connection closed"));
+			this.pendingBinary.clear();
+		});
+		ws.on("error", (err) => {
+			this.rpc.rejectAll(err);
+		});
+		await this.rpc.sendRequest(ws, "session.attach", {
+			version: require_index.PROTOCOL_VERSION,
+			namespace: this.namespace
+		});
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		this.connected = false;
+		this.subs.clear();
+		this.rpc.rejectAll(/* @__PURE__ */ new Error("WsTransport: closed"));
+		this.pendingBinary.clear();
+		if (this.ws) {
+			try {
+				await this.ws.close();
+			} catch {}
+			this.ws = null;
+		}
+	}
+	list(path, options) {
+		return this.afs("list", path, { options });
+	}
+	read(path, options) {
+		return this.afs("read", path, { options });
+	}
+	write(path, payload, options) {
+		return this.afs("write", path, {
+			payload,
+			options
+		});
+	}
+	delete(path, options) {
+		return this.afs("delete", path, { options });
+	}
+	stat(path, options) {
+		return this.afs("stat", path, { options });
+	}
+	search(path, query, options) {
+		return this.afs("search", path, {
+			query,
+			options
+		});
+	}
+	exec(path, args, options) {
+		return this.afs("exec", path, {
+			args,
+			options
+		});
+	}
+	explain(path, options) {
+		return this.afs("explain", path, { options });
+	}
+	async subscribe(path, onEvent) {
+		this.requireConnected();
+		const result = await this.rpc.sendRequest(this.ws, "afs.subscribe", { path });
+		if (!result?.subId) throw new Error("WsTransport: subscribe returned no subId");
+		this.subs.set(result.subId, {
+			subId: result.subId,
+			callback: onEvent
+		});
+		return async () => {
+			if (!this.subs.has(result.subId)) return;
+			this.subs.delete(result.subId);
+			if (this.connected && this.ws) try {
+				await this.rpc.sendRequest(this.ws, "afs.unsubscribe", { subId: result.subId });
+			} catch {}
+		};
+	}
+	async afs(op, path, extra) {
+		this.requireConnected();
+		try {
+			return await this.rpc.sendRequest(this.ws, `afs.${op}`, {
+				path,
+				...extra
+			}) ?? null;
+		} catch (err) {
+			if (err && typeof err === "object" && "code" in err && "message" in err && typeof err.code === "string") {
+				const code = err.code;
+				throw mapWireError(code, String(err.message), path);
+			}
+			throw err;
+		}
+	}
+	requireConnected() {
+		if (!this.connected || !this.ws) throw new Error("WsTransport: not connected (call connect() first or after close)");
+	}
+	handleFrame(frame) {
+		if (frame.type === require_index.FrameType.Binary) {
+			this.pendingBinary.set(frame.reqId, frame.payload);
+			return;
+		}
+		if (frame.type !== require_index.FrameType.JSON) return;
+		const binary = this.pendingBinary.take(frame.reqId);
+		let msg;
+		try {
+			msg = require_index.deserializeMessage(frame.payload);
+		} catch {
+			return;
+		}
+		if (msg.type === "response") {
+			const r = msg;
+			if (binary && r.result !== void 0) r.result = require_index.injectBinary(r.result, binary);
+			this.rpc.handleResponse(r);
+			return;
+		}
+		if (msg.type === "event") this.handleEvent(msg);
+	}
+	handleEvent(event) {
+		if (event.event !== "afs.event") return;
+		const data = event.data ?? {};
+		if (!data.subId || !data.event) return;
+		const sub = this.subs.get(data.subId);
+		if (!sub) return;
+		try {
+			sub.callback(data.event);
+		} catch {}
+	}
+};
+async function createWsTransport(options) {
+	const t = new WsTransport(options);
+	await t.connect();
+	return t;
+}
+
+//#endregion
+exports.WsTransport = WsTransport;
+exports.createWsTransport = createWsTransport;

package/dist/transports/ws.d.cts

@@ -0,0 +1,47 @@
+import { Transport, Unsubscribe } from "./types.cjs";
+import { AFSDeleteOptions, AFSDeleteResult, AFSEvent, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSExplainResult, AFSListOptions, AFSListResult, AFSReadOptions, AFSReadResult, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "@aigne/afs";
+
+//#region src/transports/ws.d.ts
+interface WsTransportOptions {
+  /** WebSocket URL of the DID Space server. */
+  url: string;
+  /** Bearer token. Sent inside the `bearer.<hex>` WebSocket subprotocol. */
+  token: string;
+  /** Session namespace for `session.attach`. Default: `"did-space-client"`. */
+  namespace?: string;
+  /** RPC request timeout (ms). Default: 30000. */
+  requestTimeout?: number;
+}
+declare class WsTransport implements Transport {
+  readonly kind: "ws";
+  private readonly url;
+  private readonly token;
+  private readonly namespace;
+  private readonly requestTimeout;
+  private ws;
+  private rpc;
+  private pendingBinary;
+  private subs;
+  private connected;
+  private closed;
+  constructor(options: WsTransportOptions);
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  write(path: string, payload: AFSWriteEntryPayload, options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
+  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
+  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  exec(path: string, args: Record<string, unknown>, options?: AFSExecOptions): Promise<AFSExecResult>;
+  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
+  subscribe(path: string, onEvent: (event: AFSEvent) => void): Promise<Unsubscribe>;
+  private afs;
+  private requireConnected;
+  private handleFrame;
+  private handleEvent;
+}
+declare function createWsTransport(options: WsTransportOptions): Promise<WsTransport>;
+//#endregion
+export { WsTransport, WsTransportOptions, createWsTransport };
+//# sourceMappingURL=ws.d.cts.map

package/dist/transports/ws.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.cts","names":[],"sources":["../../src/transports/ws.ts"],"mappings":";;;;UA2EiB,kBAAA;EAsJJ;EApJX,GAAA;EAwJ+B;EAtJ/B,KAAA;EAsJkD;EApJlD,SAAA;EAwJsD;EAtJtD,cAAA;AAAA;AAAA,cAmDW,WAAA,YAAuB,SAAA;EAAA,SACzB,IAAA;EAAA,iBAEQ,GAAA;EAAA,iBACA,KAAA;EAAA,iBACA,SAAA;EAAA,iBACA,cAAA;EAAA,QAET,EAAA;EAAA,QACA,GAAA;EAAA,QACA,aAAA;EAAA,QACA,IAAA;EAAA,QACA,SAAA;EAAA,QACA,MAAA;cAEI,OAAA,EAAS,kBAAA;EAef,OAAA,CAAA,GAAW,OAAA;EA2BX,KAAA,CAAA,GAAS,OAAA;EAsBf,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,KAAA,CACE,IAAA,UACA,OAAA,EAAS,oBAAA,EACT,OAAA,GAAU,eAAA,GACT,OAAA,CAAQ,cAAA;EAIX,MAAA,CAAO,IAAA,UAAc,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAI1D,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,MAAA,CAAO,IAAA,UAAc,KAAA,UAAe,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAIzE,IAAA,CACE,IAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,aAAA;EAIX,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAU,iBAAA,GAAoB,OAAA,CAAQ,gBAAA;EAItD,SAAA,CAAU,IAAA,UAAc,OAAA,GAAU,KAAA,EAAO,QAAA,YAAoB,OAAA,CAAQ,WAAA;EAAA,QA0B7D,GAAA;EAAA,QA0BN,gBAAA;EAAA,QAMA,WAAA;EAAA,QA6BA,WAAA;AAAA;AAAA,iBAqBY,iBAAA,CAAkB,OAAA,EAAS,kBAAA,GAAqB,OAAA,CAAQ,WAAA"}

package/dist/transports/ws.d.mts

@@ -0,0 +1,47 @@
+import { Transport, Unsubscribe } from "./types.mjs";
+import { AFSDeleteOptions, AFSDeleteResult, AFSEvent, AFSExecOptions, AFSExecResult, AFSExplainOptions, AFSExplainResult, AFSListOptions, AFSListResult, AFSReadOptions, AFSReadResult, AFSSearchOptions, AFSSearchResult, AFSStatOptions, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "@aigne/afs";
+
+//#region src/transports/ws.d.ts
+interface WsTransportOptions {
+  /** WebSocket URL of the DID Space server. */
+  url: string;
+  /** Bearer token. Sent inside the `bearer.<hex>` WebSocket subprotocol. */
+  token: string;
+  /** Session namespace for `session.attach`. Default: `"did-space-client"`. */
+  namespace?: string;
+  /** RPC request timeout (ms). Default: 30000. */
+  requestTimeout?: number;
+}
+declare class WsTransport implements Transport {
+  readonly kind: "ws";
+  private readonly url;
+  private readonly token;
+  private readonly namespace;
+  private readonly requestTimeout;
+  private ws;
+  private rpc;
+  private pendingBinary;
+  private subs;
+  private connected;
+  private closed;
+  constructor(options: WsTransportOptions);
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  write(path: string, payload: AFSWriteEntryPayload, options?: AFSWriteOptions): Promise<AFSWriteResult>;
+  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult>;
+  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult>;
+  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult>;
+  exec(path: string, args: Record<string, unknown>, options?: AFSExecOptions): Promise<AFSExecResult>;
+  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult>;
+  subscribe(path: string, onEvent: (event: AFSEvent) => void): Promise<Unsubscribe>;
+  private afs;
+  private requireConnected;
+  private handleFrame;
+  private handleEvent;
+}
+declare function createWsTransport(options: WsTransportOptions): Promise<WsTransport>;
+//#endregion
+export { WsTransport, WsTransportOptions, createWsTransport };
+//# sourceMappingURL=ws.d.mts.map

package/dist/transports/ws.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.d.mts","names":[],"sources":["../../src/transports/ws.ts"],"mappings":";;;;UA2EiB,kBAAA;EAsJJ;EApJX,GAAA;EAwJ+B;EAtJ/B,KAAA;EAsJkD;EApJlD,SAAA;EAwJsD;EAtJtD,cAAA;AAAA;AAAA,cAmDW,WAAA,YAAuB,SAAA;EAAA,SACzB,IAAA;EAAA,iBAEQ,GAAA;EAAA,iBACA,KAAA;EAAA,iBACA,SAAA;EAAA,iBACA,cAAA;EAAA,QAET,EAAA;EAAA,QACA,GAAA;EAAA,QACA,aAAA;EAAA,QACA,IAAA;EAAA,QACA,SAAA;EAAA,QACA,MAAA;cAEI,OAAA,EAAS,kBAAA;EAef,OAAA,CAAA,GAAW,OAAA;EA2BX,KAAA,CAAA,GAAS,OAAA;EAsBf,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,KAAA,CACE,IAAA,UACA,OAAA,EAAS,oBAAA,EACT,OAAA,GAAU,eAAA,GACT,OAAA,CAAQ,cAAA;EAIX,MAAA,CAAO,IAAA,UAAc,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAI1D,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EAItD,MAAA,CAAO,IAAA,UAAc,KAAA,UAAe,OAAA,GAAU,gBAAA,GAAmB,OAAA,CAAQ,eAAA;EAIzE,IAAA,CACE,IAAA,UACA,IAAA,EAAM,MAAA,mBACN,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,aAAA;EAIX,OAAA,CAAQ,IAAA,UAAc,OAAA,GAAU,iBAAA,GAAoB,OAAA,CAAQ,gBAAA;EAItD,SAAA,CAAU,IAAA,UAAc,OAAA,GAAU,KAAA,EAAO,QAAA,YAAoB,OAAA,CAAQ,WAAA;EAAA,QA0B7D,GAAA;EAAA,QA0BN,gBAAA;EAAA,QAMA,WAAA;EAAA,QA6BA,WAAA;AAAA;AAAA,iBAqBY,iBAAA,CAAkB,OAAA,EAAS,kBAAA,GAAqB,OAAA,CAAQ,WAAA"}

package/dist/transports/ws.mjs

@@ -0,0 +1,206 @@
+import { FrameType, PROTOCOL_VERSION, PendingBinaryBuffer, RPCHandler, WebSocketClient, deserializeMessage, injectBinary } from "../packages/session/dist/index.mjs";
+import { AFSCompactedError, AFSConflictError, AFSNotFoundError, AFSValidationError } from "@aigne/afs";
+
+//#region src/transports/ws.ts
+const DEFAULT_NAMESPACE = "did-space-client";
+const DEFAULT_REQUEST_TIMEOUT = 3e4;
+const ALLOWED_WS_SCHEMES = new Set(["ws:", "wss:"]);
+function parseWsUrl(rawUrl) {
+	let parsed;
+	try {
+		parsed = new URL(rawUrl);
+	} catch {
+		throw new Error(`WsTransport: invalid URL: ${rawUrl}`);
+	}
+	if (!ALLOWED_WS_SCHEMES.has(parsed.protocol)) throw new Error(`WsTransport: only ws(s) is supported, got ${parsed.protocol} (URL: ${rawUrl})`);
+	const port = parsed.port ? Number(parsed.port) : parsed.protocol === "wss:" ? 443 : 80;
+	return {
+		host: parsed.hostname,
+		port
+	};
+}
+function mapWireError(code, message, path) {
+	switch (code) {
+		case "not_found": return new AFSNotFoundError(path, message);
+		case "conflict": return new AFSConflictError(path, {
+			cid: null,
+			mtime: null,
+			deviceId: null
+		});
+		case "compacted": return new AFSCompactedError(path, "0");
+		case "validation": return new AFSValidationError(message);
+		default: return /* @__PURE__ */ new Error(`WsTransport ${code}: ${message}`);
+	}
+}
+var WsTransport = class {
+	kind = "ws";
+	url;
+	token;
+	namespace;
+	requestTimeout;
+	ws = null;
+	rpc;
+	pendingBinary = new PendingBinaryBuffer();
+	subs = /* @__PURE__ */ new Map();
+	connected = false;
+	closed = false;
+	constructor(options) {
+		parseWsUrl(options.url);
+		this.url = options.url;
+		this.token = options.token;
+		this.namespace = options.namespace ?? DEFAULT_NAMESPACE;
+		this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;
+		this.rpc = new RPCHandler({
+			startId: 1,
+			idIncrement: 2,
+			timeout: this.requestTimeout
+		});
+	}
+	async connect() {
+		if (this.closed) throw new Error("WsTransport: already closed");
+		if (this.connected) return;
+		const { host, port } = parseWsUrl(this.url);
+		const ws = new WebSocketClient({
+			host,
+			port,
+			authToken: this.token
+		});
+		await ws.connect();
+		this.ws = ws;
+		this.connected = true;
+		ws.on("frame", (frame) => this.handleFrame(frame));
+		ws.on("close", () => {
+			this.connected = false;
+			this.rpc.rejectAll(/* @__PURE__ */ new Error("WsTransport: connection closed"));
+			this.pendingBinary.clear();
+		});
+		ws.on("error", (err) => {
+			this.rpc.rejectAll(err);
+		});
+		await this.rpc.sendRequest(ws, "session.attach", {
+			version: PROTOCOL_VERSION,
+			namespace: this.namespace
+		});
+	}
+	async close() {
+		if (this.closed) return;
+		this.closed = true;
+		this.connected = false;
+		this.subs.clear();
+		this.rpc.rejectAll(/* @__PURE__ */ new Error("WsTransport: closed"));
+		this.pendingBinary.clear();
+		if (this.ws) {
+			try {
+				await this.ws.close();
+			} catch {}
+			this.ws = null;
+		}
+	}
+	list(path, options) {
+		return this.afs("list", path, { options });
+	}
+	read(path, options) {
+		return this.afs("read", path, { options });
+	}
+	write(path, payload, options) {
+		return this.afs("write", path, {
+			payload,
+			options
+		});
+	}
+	delete(path, options) {
+		return this.afs("delete", path, { options });
+	}
+	stat(path, options) {
+		return this.afs("stat", path, { options });
+	}
+	search(path, query, options) {
+		return this.afs("search", path, {
+			query,
+			options
+		});
+	}
+	exec(path, args, options) {
+		return this.afs("exec", path, {
+			args,
+			options
+		});
+	}
+	explain(path, options) {
+		return this.afs("explain", path, { options });
+	}
+	async subscribe(path, onEvent) {
+		this.requireConnected();
+		const result = await this.rpc.sendRequest(this.ws, "afs.subscribe", { path });
+		if (!result?.subId) throw new Error("WsTransport: subscribe returned no subId");
+		this.subs.set(result.subId, {
+			subId: result.subId,
+			callback: onEvent
+		});
+		return async () => {
+			if (!this.subs.has(result.subId)) return;
+			this.subs.delete(result.subId);
+			if (this.connected && this.ws) try {
+				await this.rpc.sendRequest(this.ws, "afs.unsubscribe", { subId: result.subId });
+			} catch {}
+		};
+	}
+	async afs(op, path, extra) {
+		this.requireConnected();
+		try {
+			return await this.rpc.sendRequest(this.ws, `afs.${op}`, {
+				path,
+				...extra
+			}) ?? null;
+		} catch (err) {
+			if (err && typeof err === "object" && "code" in err && "message" in err && typeof err.code === "string") {
+				const code = err.code;
+				throw mapWireError(code, String(err.message), path);
+			}
+			throw err;
+		}
+	}
+	requireConnected() {
+		if (!this.connected || !this.ws) throw new Error("WsTransport: not connected (call connect() first or after close)");
+	}
+	handleFrame(frame) {
+		if (frame.type === FrameType.Binary) {
+			this.pendingBinary.set(frame.reqId, frame.payload);
+			return;
+		}
+		if (frame.type !== FrameType.JSON) return;
+		const binary = this.pendingBinary.take(frame.reqId);
+		let msg;
+		try {
+			msg = deserializeMessage(frame.payload);
+		} catch {
+			return;
+		}
+		if (msg.type === "response") {
+			const r = msg;
+			if (binary && r.result !== void 0) r.result = injectBinary(r.result, binary);
+			this.rpc.handleResponse(r);
+			return;
+		}
+		if (msg.type === "event") this.handleEvent(msg);
+	}
+	handleEvent(event) {
+		if (event.event !== "afs.event") return;
+		const data = event.data ?? {};
+		if (!data.subId || !data.event) return;
+		const sub = this.subs.get(data.subId);
+		if (!sub) return;
+		try {
+			sub.callback(data.event);
+		} catch {}
+	}
+};
+async function createWsTransport(options) {
+	const t = new WsTransport(options);
+	await t.connect();
+	return t;
+}
+
+//#endregion
+export { WsTransport, createWsTransport };
+//# sourceMappingURL=ws.mjs.map

package/dist/transports/ws.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws.mjs","names":[],"sources":["../../src/transports/ws.ts"],"sourcesContent":["/**\n * WsTransport — DID Space transport over WebSocket via @aigne/afs-session.\n *\n * Wire layout:\n *\n *   1. Connect with `WebSocketClient` using a hex-encoded bearer\n *      subprotocol (`bearer.<hex>` — RFC 6455 token-safe). The mock\n *      cloud server and production WS gateway both speak this.\n *   2. Issue a `session.attach { version, namespace }` RPC to enter the\n *      AFS routing tier. Without `attached=true` the server rejects\n *      every `afs.*` request with `invalid_session`.\n *   3. Each AFS operation (`afs.list`, `afs.read`, …) is a single RPC\n *      with `{ path, options? }` params. Binary content roundtrips via\n *      the session sidecar frames (Frame.Binary / Frame.JSON pair —\n *      handled transparently by `extractBinary` / `injectBinary`).\n *   4. `subscribe(path, cb)` issues `afs.subscribe { path }` and listens\n *      for one-way `afs.event { subId, event }` notifications. The\n *      returned `Unsubscribe` issues `afs.unsubscribe { subId }`.\n *   5. `close()` disconnects the underlying WebSocket. RPCs in flight\n *      reject with the transport closure error.\n *\n * The transport is *thin* by design — it does not retry or buffer\n * across reconnects. Callers (`DIDSpaceClient`) layer reliability\n * concerns above.\n */\n\nimport type {\n  AFSDeleteOptions,\n  AFSDeleteResult,\n  AFSEvent,\n  AFSExecOptions,\n  AFSExecResult,\n  AFSExplainOptions,\n  AFSExplainResult,\n  AFSListOptions,\n  AFSListResult,\n  AFSReadOptions,\n  AFSReadResult,\n  AFSSearchOptions,\n  AFSSearchResult,\n  AFSStatOptions,\n  AFSStatResult,\n  AFSWriteEntryPayload,\n  AFSWriteOptions,\n  AFSWriteResult,\n} from \"@aigne/afs\";\nimport {\n  AFSCompactedError,\n  AFSConflictError,\n  AFSNotFoundError,\n  AFSValidationError,\n} from \"@aigne/afs\";\nimport {\n  deserializeMessage,\n  type Frame,\n  FrameType,\n  injectBinary,\n  PendingBinaryBuffer,\n  PROTOCOL_VERSION,\n  RPCHandler,\n  type Event as RpcEvent,\n  type Response as RpcResponse,\n  WebSocketClient,\n} from \"@aigne/afs-session\";\nimport type { Transport, Unsubscribe } from \"./types.js\";\n\n// ---------------------------------------------------------------------------\n// Options\n// ---------------------------------------------------------------------------\n\nconst DEFAULT_NAMESPACE = \"did-space-client\";\nconst DEFAULT_REQUEST_TIMEOUT = 30_000;\n\nconst ALLOWED_WS_SCHEMES = new Set([\"ws:\", \"wss:\"]);\n\nexport interface WsTransportOptions {\n  /** WebSocket URL of the DID Space server. */\n  url: string;\n  /** Bearer token. Sent inside the `bearer.<hex>` WebSocket subprotocol. */\n  token: string;\n  /** Session namespace for `session.attach`. Default: `\"did-space-client\"`. */\n  namespace?: string;\n  /** RPC request timeout (ms). Default: 30000. */\n  requestTimeout?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction parseWsUrl(rawUrl: string): { host: string; port: number } {\n  let parsed: URL;\n  try {\n    parsed = new URL(rawUrl);\n  } catch {\n    throw new Error(`WsTransport: invalid URL: ${rawUrl}`);\n  }\n  if (!ALLOWED_WS_SCHEMES.has(parsed.protocol)) {\n    throw new Error(\n      `WsTransport: only ws(s) is supported, got ${parsed.protocol} (URL: ${rawUrl})`,\n    );\n  }\n  const port = parsed.port ? Number(parsed.port) : parsed.protocol === \"wss:\" ? 443 : 80;\n  return { host: parsed.hostname, port };\n}\n\nfunction mapWireError(code: string, message: string, path: string): Error {\n  switch (code) {\n    case \"not_found\":\n      return new AFSNotFoundError(path, message);\n    case \"conflict\":\n      return new AFSConflictError(path, {\n        cid: null,\n        mtime: null,\n        deviceId: null,\n      });\n    case \"compacted\":\n      return new AFSCompactedError(path, \"0\");\n    case \"validation\":\n      return new AFSValidationError(message);\n    default:\n      return new Error(`WsTransport ${code}: ${message}`);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Transport\n// ---------------------------------------------------------------------------\n\ninterface SubscriptionState {\n  subId: string;\n  callback: (event: AFSEvent) => void;\n}\n\nexport class WsTransport implements Transport {\n  readonly kind = \"ws\" as const;\n\n  private readonly url: string;\n  private readonly token: string;\n  private readonly namespace: string;\n  private readonly requestTimeout: number;\n\n  private ws: WebSocketClient | null = null;\n  private rpc: RPCHandler;\n  private pendingBinary = new PendingBinaryBuffer();\n  private subs = new Map<string, SubscriptionState>();\n  private connected = false;\n  private closed = false;\n\n  constructor(options: WsTransportOptions) {\n    parseWsUrl(options.url);\n    this.url = options.url;\n    this.token = options.token;\n    this.namespace = options.namespace ?? DEFAULT_NAMESPACE;\n    this.requestTimeout = options.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT;\n    this.rpc = new RPCHandler({\n      startId: 1,\n      idIncrement: 2,\n      timeout: this.requestTimeout,\n    });\n  }\n\n  // ───── Lifecycle ─────────────────────────────────────────────────────────\n\n  async connect(): Promise<void> {\n    if (this.closed) throw new Error(\"WsTransport: already closed\");\n    if (this.connected) return;\n\n    const { host, port } = parseWsUrl(this.url);\n    const ws = new WebSocketClient({ host, port, authToken: this.token });\n    await ws.connect();\n    this.ws = ws;\n    this.connected = true;\n\n    ws.on(\"frame\", (frame: Frame) => this.handleFrame(frame));\n    ws.on(\"close\", () => {\n      this.connected = false;\n      this.rpc.rejectAll(new Error(\"WsTransport: connection closed\"));\n      this.pendingBinary.clear();\n    });\n    ws.on(\"error\", (err) => {\n      this.rpc.rejectAll(err);\n    });\n\n    // Attach to enter the AFS RPC tier.\n    await this.rpc.sendRequest(ws, \"session.attach\", {\n      version: PROTOCOL_VERSION,\n      namespace: this.namespace,\n    });\n  }\n\n  async close(): Promise<void> {\n    if (this.closed) return;\n    this.closed = true;\n    this.connected = false;\n\n    // Cancel local subscriptions; server-side will be cleaned up by close.\n    this.subs.clear();\n    this.rpc.rejectAll(new Error(\"WsTransport: closed\"));\n    this.pendingBinary.clear();\n\n    if (this.ws) {\n      try {\n        await this.ws.close();\n      } catch {\n        // Ignore — socket may already be down.\n      }\n      this.ws = null;\n    }\n  }\n\n  // ───── AFS surface ───────────────────────────────────────────────────────\n\n  list(path: string, options?: AFSListOptions): Promise<AFSListResult> {\n    return this.afs<AFSListResult>(\"list\", path, { options });\n  }\n\n  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult> {\n    return this.afs<AFSReadResult>(\"read\", path, { options });\n  }\n\n  write(\n    path: string,\n    payload: AFSWriteEntryPayload,\n    options?: AFSWriteOptions,\n  ): Promise<AFSWriteResult> {\n    return this.afs<AFSWriteResult>(\"write\", path, { payload, options });\n  }\n\n  delete(path: string, options?: AFSDeleteOptions): Promise<AFSDeleteResult> {\n    return this.afs<AFSDeleteResult>(\"delete\", path, { options });\n  }\n\n  stat(path: string, options?: AFSStatOptions): Promise<AFSStatResult> {\n    return this.afs<AFSStatResult>(\"stat\", path, { options });\n  }\n\n  search(path: string, query: string, options?: AFSSearchOptions): Promise<AFSSearchResult> {\n    return this.afs<AFSSearchResult>(\"search\", path, { query, options });\n  }\n\n  exec(\n    path: string,\n    args: Record<string, unknown>,\n    options?: AFSExecOptions,\n  ): Promise<AFSExecResult> {\n    return this.afs<AFSExecResult>(\"exec\", path, { args, options });\n  }\n\n  explain(path: string, options?: AFSExplainOptions): Promise<AFSExplainResult> {\n    return this.afs<AFSExplainResult>(\"explain\", path, { options });\n  }\n\n  async subscribe(path: string, onEvent: (event: AFSEvent) => void): Promise<Unsubscribe> {\n    this.requireConnected();\n    const result = (await this.rpc.sendRequest(this.ws!, \"afs.subscribe\", { path })) as {\n      subId: string;\n    };\n    if (!result?.subId) {\n      throw new Error(\"WsTransport: subscribe returned no subId\");\n    }\n    this.subs.set(result.subId, { subId: result.subId, callback: onEvent });\n    return async () => {\n      if (!this.subs.has(result.subId)) return;\n      this.subs.delete(result.subId);\n      // Best-effort — if the connection is gone, we already removed the\n      // local listener above and the server will clean up on close.\n      if (this.connected && this.ws) {\n        try {\n          await this.rpc.sendRequest(this.ws, \"afs.unsubscribe\", { subId: result.subId });\n        } catch {\n          /* swallow */\n        }\n      }\n    };\n  }\n\n  // ───── Internals ─────────────────────────────────────────────────────────\n\n  private async afs<T>(op: string, path: string, extra: Record<string, unknown>): Promise<T> {\n    this.requireConnected();\n    try {\n      const result = (await this.rpc.sendRequest(this.ws!, `afs.${op}`, {\n        path,\n        ...extra,\n      })) as T;\n      return result ?? (null as unknown as T);\n    } catch (err) {\n      // RPC errors arrive as `{ code, message }`; translate to the AFS\n      // typed errors so callers get one coherent error model.\n      if (\n        err &&\n        typeof err === \"object\" &&\n        \"code\" in err &&\n        \"message\" in err &&\n        typeof (err as { code: unknown }).code === \"string\"\n      ) {\n        const code = (err as { code: string }).code;\n        const message = String((err as { message: unknown }).message);\n        throw mapWireError(code, message, path);\n      }\n      throw err;\n    }\n  }\n\n  private requireConnected(): void {\n    if (!this.connected || !this.ws) {\n      throw new Error(\"WsTransport: not connected (call connect() first or after close)\");\n    }\n  }\n\n  private handleFrame(frame: Frame): void {\n    if (frame.type === FrameType.Binary) {\n      this.pendingBinary.set(frame.reqId, frame.payload);\n      return;\n    }\n    if (frame.type !== FrameType.JSON) return;\n\n    const binary = this.pendingBinary.take(frame.reqId);\n    let msg: ReturnType<typeof deserializeMessage>;\n    try {\n      msg = deserializeMessage(frame.payload);\n    } catch {\n      return;\n    }\n\n    if (msg.type === \"response\") {\n      const r = msg as RpcResponse;\n      if (binary && r.result !== undefined) {\n        r.result = injectBinary(r.result, binary);\n      }\n      this.rpc.handleResponse(r);\n      return;\n    }\n\n    if (msg.type === \"event\") {\n      this.handleEvent(msg as RpcEvent);\n    }\n  }\n\n  private handleEvent(event: RpcEvent): void {\n    if (event.event !== \"afs.event\") return;\n    const data = (event.data ?? {}) as { subId?: string; event?: AFSEvent };\n    if (!data.subId || !data.event) return;\n    const sub = this.subs.get(data.subId);\n    if (!sub) return;\n    try {\n      sub.callback(data.event);\n    } catch {\n      // Swallow — subscribers must not break the transport.\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Re-exports\n// ---------------------------------------------------------------------------\n\nexport type { Transport, Unsubscribe } from \"./types.js\";\n\n// Convenience: a connected transport you can pass straight to DIDSpaceClient.\nexport async function createWsTransport(options: WsTransportOptions): Promise<WsTransport> {\n  const t = new WsTransport(options);\n  await t.connect();\n  return t;\n}\n"],"mappings":";;;;AAsEA,MAAM,oBAAoB;AAC1B,MAAM,0BAA0B;AAEhC,MAAM,qBAAqB,IAAI,IAAI,CAAC,OAAO,OAAO,CAAC;AAiBnD,SAAS,WAAW,QAAgD;CAClE,IAAI;AACJ,KAAI;AACF,WAAS,IAAI,IAAI,OAAO;SAClB;AACN,QAAM,IAAI,MAAM,6BAA6B,SAAS;;AAExD,KAAI,CAAC,mBAAmB,IAAI,OAAO,SAAS,CAC1C,OAAM,IAAI,MACR,6CAA6C,OAAO,SAAS,SAAS,OAAO,GAC9E;CAEH,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK,GAAG,OAAO,aAAa,SAAS,MAAM;AACpF,QAAO;EAAE,MAAM,OAAO;EAAU;EAAM;;AAGxC,SAAS,aAAa,MAAc,SAAiB,MAAqB;AACxE,SAAQ,MAAR;EACE,KAAK,YACH,QAAO,IAAI,iBAAiB,MAAM,QAAQ;EAC5C,KAAK,WACH,QAAO,IAAI,iBAAiB,MAAM;GAChC,KAAK;GACL,OAAO;GACP,UAAU;GACX,CAAC;EACJ,KAAK,YACH,QAAO,IAAI,kBAAkB,MAAM,IAAI;EACzC,KAAK,aACH,QAAO,IAAI,mBAAmB,QAAQ;EACxC,QACE,wBAAO,IAAI,MAAM,eAAe,KAAK,IAAI,UAAU;;;AAazD,IAAa,cAAb,MAA8C;CAC5C,AAAS,OAAO;CAEhB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,AAAQ,KAA6B;CACrC,AAAQ;CACR,AAAQ,gBAAgB,IAAI,qBAAqB;CACjD,AAAQ,uBAAO,IAAI,KAAgC;CACnD,AAAQ,YAAY;CACpB,AAAQ,SAAS;CAEjB,YAAY,SAA6B;AACvC,aAAW,QAAQ,IAAI;AACvB,OAAK,MAAM,QAAQ;AACnB,OAAK,QAAQ,QAAQ;AACrB,OAAK,YAAY,QAAQ,aAAa;AACtC,OAAK,iBAAiB,QAAQ,kBAAkB;AAChD,OAAK,MAAM,IAAI,WAAW;GACxB,SAAS;GACT,aAAa;GACb,SAAS,KAAK;GACf,CAAC;;CAKJ,MAAM,UAAyB;AAC7B,MAAI,KAAK,OAAQ,OAAM,IAAI,MAAM,8BAA8B;AAC/D,MAAI,KAAK,UAAW;EAEpB,MAAM,EAAE,MAAM,SAAS,WAAW,KAAK,IAAI;EAC3C,MAAM,KAAK,IAAI,gBAAgB;GAAE;GAAM;GAAM,WAAW,KAAK;GAAO,CAAC;AACrE,QAAM,GAAG,SAAS;AAClB,OAAK,KAAK;AACV,OAAK,YAAY;AAEjB,KAAG,GAAG,UAAU,UAAiB,KAAK,YAAY,MAAM,CAAC;AACzD,KAAG,GAAG,eAAe;AACnB,QAAK,YAAY;AACjB,QAAK,IAAI,0BAAU,IAAI,MAAM,iCAAiC,CAAC;AAC/D,QAAK,cAAc,OAAO;IAC1B;AACF,KAAG,GAAG,UAAU,QAAQ;AACtB,QAAK,IAAI,UAAU,IAAI;IACvB;AAGF,QAAM,KAAK,IAAI,YAAY,IAAI,kBAAkB;GAC/C,SAAS;GACT,WAAW,KAAK;GACjB,CAAC;;CAGJ,MAAM,QAAuB;AAC3B,MAAI,KAAK,OAAQ;AACjB,OAAK,SAAS;AACd,OAAK,YAAY;AAGjB,OAAK,KAAK,OAAO;AACjB,OAAK,IAAI,0BAAU,IAAI,MAAM,sBAAsB,CAAC;AACpD,OAAK,cAAc,OAAO;AAE1B,MAAI,KAAK,IAAI;AACX,OAAI;AACF,UAAM,KAAK,GAAG,OAAO;WACf;AAGR,QAAK,KAAK;;;CAMd,KAAK,MAAc,SAAkD;AACnE,SAAO,KAAK,IAAmB,QAAQ,MAAM,EAAE,SAAS,CAAC;;CAG3D,KAAK,MAAc,SAAkD;AACnE,SAAO,KAAK,IAAmB,QAAQ,MAAM,EAAE,SAAS,CAAC;;CAG3D,MACE,MACA,SACA,SACyB;AACzB,SAAO,KAAK,IAAoB,SAAS,MAAM;GAAE;GAAS;GAAS,CAAC;;CAGtE,OAAO,MAAc,SAAsD;AACzE,SAAO,KAAK,IAAqB,UAAU,MAAM,EAAE,SAAS,CAAC;;CAG/D,KAAK,MAAc,SAAkD;AACnE,SAAO,KAAK,IAAmB,QAAQ,MAAM,EAAE,SAAS,CAAC;;CAG3D,OAAO,MAAc,OAAe,SAAsD;AACxF,SAAO,KAAK,IAAqB,UAAU,MAAM;GAAE;GAAO;GAAS,CAAC;;CAGtE,KACE,MACA,MACA,SACwB;AACxB,SAAO,KAAK,IAAmB,QAAQ,MAAM;GAAE;GAAM;GAAS,CAAC;;CAGjE,QAAQ,MAAc,SAAwD;AAC5E,SAAO,KAAK,IAAsB,WAAW,MAAM,EAAE,SAAS,CAAC;;CAGjE,MAAM,UAAU,MAAc,SAA0D;AACtF,OAAK,kBAAkB;EACvB,MAAM,SAAU,MAAM,KAAK,IAAI,YAAY,KAAK,IAAK,iBAAiB,EAAE,MAAM,CAAC;AAG/E,MAAI,CAAC,QAAQ,MACX,OAAM,IAAI,MAAM,2CAA2C;AAE7D,OAAK,KAAK,IAAI,OAAO,OAAO;GAAE,OAAO,OAAO;GAAO,UAAU;GAAS,CAAC;AACvE,SAAO,YAAY;AACjB,OAAI,CAAC,KAAK,KAAK,IAAI,OAAO,MAAM,CAAE;AAClC,QAAK,KAAK,OAAO,OAAO,MAAM;AAG9B,OAAI,KAAK,aAAa,KAAK,GACzB,KAAI;AACF,UAAM,KAAK,IAAI,YAAY,KAAK,IAAI,mBAAmB,EAAE,OAAO,OAAO,OAAO,CAAC;WACzE;;;CASd,MAAc,IAAO,IAAY,MAAc,OAA4C;AACzF,OAAK,kBAAkB;AACvB,MAAI;AAKF,UAJgB,MAAM,KAAK,IAAI,YAAY,KAAK,IAAK,OAAO,MAAM;IAChE;IACA,GAAG;IACJ,CAAC,IACgB;WACX,KAAK;AAGZ,OACE,OACA,OAAO,QAAQ,YACf,UAAU,OACV,aAAa,OACb,OAAQ,IAA0B,SAAS,UAC3C;IACA,MAAM,OAAQ,IAAyB;AAEvC,UAAM,aAAa,MADH,OAAQ,IAA6B,QAAQ,EAC3B,KAAK;;AAEzC,SAAM;;;CAIV,AAAQ,mBAAyB;AAC/B,MAAI,CAAC,KAAK,aAAa,CAAC,KAAK,GAC3B,OAAM,IAAI,MAAM,mEAAmE;;CAIvF,AAAQ,YAAY,OAAoB;AACtC,MAAI,MAAM,SAAS,UAAU,QAAQ;AACnC,QAAK,cAAc,IAAI,MAAM,OAAO,MAAM,QAAQ;AAClD;;AAEF,MAAI,MAAM,SAAS,UAAU,KAAM;EAEnC,MAAM,SAAS,KAAK,cAAc,KAAK,MAAM,MAAM;EACnD,IAAI;AACJ,MAAI;AACF,SAAM,mBAAmB,MAAM,QAAQ;UACjC;AACN;;AAGF,MAAI,IAAI,SAAS,YAAY;GAC3B,MAAM,IAAI;AACV,OAAI,UAAU,EAAE,WAAW,OACzB,GAAE,SAAS,aAAa,EAAE,QAAQ,OAAO;AAE3C,QAAK,IAAI,eAAe,EAAE;AAC1B;;AAGF,MAAI,IAAI,SAAS,QACf,MAAK,YAAY,IAAgB;;CAIrC,AAAQ,YAAY,OAAuB;AACzC,MAAI,MAAM,UAAU,YAAa;EACjC,MAAM,OAAQ,MAAM,QAAQ,EAAE;AAC9B,MAAI,CAAC,KAAK,SAAS,CAAC,KAAK,MAAO;EAChC,MAAM,MAAM,KAAK,KAAK,IAAI,KAAK,MAAM;AACrC,MAAI,CAAC,IAAK;AACV,MAAI;AACF,OAAI,SAAS,KAAK,MAAM;UAClB;;;AAaZ,eAAsB,kBAAkB,SAAmD;CACzF,MAAM,IAAI,IAAI,YAAY,QAAQ;AAClC,OAAM,EAAE,SAAS;AACjB,QAAO"}