@nsky/rpc-bridge 0.0.1-beta

package/README.md

@@ -0,0 +1,83 @@
+# @nsky/rpc-bridge
+
+Transport-agnostic JSON-RPC 2.0 bridge for code that needs the same business API across Web Workers, browser extensions, Electron, and WebSocket-backed runtimes.
+
+## Quick Start
+
+```ts
+// 服务的接口定义（供客户端类型约束使用）
+export interface CryptoService {
+  encrypt(text: string): Promise<string>;
+  decrypt(text: string): Promise<string>;
+}
+
+// 纯净的服务实现（不依赖任何平台API）
+export class CryptoService {
+  async encrypt(text) {
+    // 模拟加密耗时任务
+    await new Promise<void>((resolve) => setTimeout(resolve, 1000));
+    return `[Encrypted:${text}]`;
+  }
+  async decrypt(cipher) {
+    return cipher.replace("[Encrypted:", "").replace("]", "");
+  }
+}
+```
+
+On the service side:
+
+```ts
+import { BridgeServer, WorkerTransport } from "@nsky/rpc-bridge";
+
+// 1.初始化适配器
+const transport = new WorkerTransport(self);
+
+// 2.启动 RPC 服务端
+const server = new BridgeServer(transport);
+
+// 3.注册服务
+server.registerService("CryptoService", new CryptoService());
+```
+
+On the client side:
+
+```ts
+import { BridgeClient, BridgeServer, WorkerTransport } from "@nsky/rpc-bridge";
+
+// 1. 初始化 Web Worker
+const worker = new Worker("worker.js");
+
+// 2. 初始化客户端适配器
+const client = new BridgeClient(new WorkerTransport(worker));
+
+// 3. 获取 CryptoService 代理
+const cryptoService = client.getService<CryptoService>("CryptoService");
+
+// 4. 像调用本地方法一样调用（实际上是跨线程异步调用）
+const result = await cryptoService.encrypt("Hello World");
+console.log(result);
+```
+
+## Transports
+
+- `WorkerTransport` wraps postMessage-style Worker endpoints.
+- `ChromeTransport` wraps `chrome.runtime.sendMessage` and `runtime.onMessage`.
+- `ElectronTransport` wraps Electron IPC channels.
+- `WebSocketTransport` serializes RPC messages over JSON WebSocket frames.
+
+All transports implement the same `RpcTransport` interface, so application code only swaps the adapter at initialization time.
+
+## JSON-RPC 2.0 Messages
+
+`BridgeClient` sends JSON-RPC 2.0 request objects:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "method": "CryptoService.encrypt",
+  "params": ["Hello World"],
+  "id": "request-1"
+}
+```
+
+`BridgeServer` returns JSON-RPC success and error responses, including standard error codes such as `-32600` for invalid requests and `-32601` for missing methods. Notifications omit `id` and do not receive responses.

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e={PARSE_ERROR:-32700,INVALID_REQUEST:-32600,METHOD_NOT_FOUND:-32601,INVALID_PARAMS:-32602,INTERNAL_ERROR:-32603,TIMEOUT:-32e3,UNAUTHORIZED:-32001,FORBIDDEN:-32002,NOT_FOUND:-32003};var t=class extends Error{code;data;constructor(e){super(e.message),this.name=`JsonRpcError`,this.code=e.code,this.data=e.data}};function n(e){return p(e)&&Object.hasOwn(e,`id`)&&v(e.id)&&(h(e)||g(e))}function r(e){return m(e)&&Object.hasOwn(e,`id`)&&v(e.id)}function i(e){return m(e)&&!Object.hasOwn(e,`id`)}function a(e,t,n,r){return{jsonrpc:`2.0`,method:`${e}.${t}`,params:n,id:r}}function o(e,t){return{jsonrpc:`2.0`,result:t===void 0?null:t,id:e}}function s(e,t,n,r){return{jsonrpc:`2.0`,error:r===void 0?{code:t,message:n}:{code:t,message:n,data:r},id:e}}function c(){let e=Math.random().toString(36).slice(2,11);return`${Date.now().toString(36)}-${e}`}function l(e){let t=e.lastIndexOf(`.`);if(!(t<=0||t===e.length-1))return{serviceName:e.slice(0,t),methodName:e.slice(t+1)}}function u(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function d(e){return e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:String(e)}function f(e){return new t(e)}function p(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&e.jsonrpc===`2.0`}function m(e){return p(e)&&typeof e.method==`string`&&(e.params===void 0||_(e.params))}function h(e){return p(e)&&Object.hasOwn(e,`result`)&&!Object.hasOwn(e,`error`)}function g(e){if(!p(e)||!Object.hasOwn(e,`error`))return!1;let t=e.error;return typeof t==`object`&&!!t&&!Array.isArray(t)&&typeof t.code==`number`&&typeof t.message==`string`}function _(e){return Array.isArray(e)||y(e)}function v(e){return typeof e==`string`||typeof e==`number`||e===null}function y(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.getPrototypeOf(e)===Object.prototype}var b=class{transport;idFactory;pendingRequests=new Map;timeoutMs;unsubscribe;constructor(e,t={}){this.transport=e,this.timeoutMs=t.timeoutMs??15e3,this.idFactory=t.idFactory??c;let r=this.transport.listen(e=>{n(e)&&this.resolveResponse(e)});this.unsubscribe=typeof r==`function`?r:void 0}get pendingCount(){return this.pendingRequests.size}getService(e){return new Proxy({},{get:(t,n)=>{if(!(typeof n!=`string`||n===`then`))return(...t)=>this.call(e,n,t)}})}destroy(e=`RPC client destroyed.`){this.unsubscribe?.();for(let[t,n]of this.pendingRequests)clearTimeout(n.timer),n.reject(Error(e)),this.pendingRequests.delete(t)}call(e,t,n){let r=this.idFactory();return new Promise((i,o)=>{let s=setTimeout(()=>{this.pendingRequests.delete(r),o(Error(`RPC request to ${e}.${t} timed out after ${this.timeoutMs}ms.`))},this.timeoutMs);this.pendingRequests.set(r,{serviceName:e,method:t,resolve:i,reject:o,timer:s}),this.transport.send(a(e,t,n,r))})}resolveResponse(e){if(e.id===null)return;let t=this.pendingRequests.get(e.id);if(t){if(clearTimeout(t.timer),this.pendingRequests.delete(e.id),e.error){t.reject(f(e.error));return}t.resolve(e.result)}}},x=class t{transport;services=new Map;unsubscribe;static ERR_INVALID_REQUEST=s(null,e.INVALID_REQUEST,`Invalid Request`);constructor(e){this.transport=e;let t=this.transport.listen(e=>{this.handleMessage(e)});this.unsubscribe=typeof t==`function`?t:void 0}registerService(e,t){this.services.set(e,t)}unregisterService(e){return this.services.delete(e)}destroy(){this.services.clear(),this.unsubscribe?.()}async handleMessage(e){if(Array.isArray(e)){await this.handleBatch(e);return}let t=await this.handleSingle(e);t&&await this.transport.send(t)}async handleBatch(e){if(e.length===0){await this.transport.send(t.ERR_INVALID_REQUEST);return}let n=(await Promise.all(e.map(e=>this.handleSingle(e)))).filter(e=>e!==void 0);n.length>0&&await this.transport.send(n)}async handleSingle(n){let a=r(n),c=i(n);if(!a&&!c)return t.ERR_INVALID_REQUEST;let f=a?n.id:void 0;try{let e=l(n.method);if(!e||n.method.startsWith(`rpc.`))return S(n.method,f);let t=this.services.get(e.serviceName);if(!t)return S(n.method,f);let r=t[e.methodName];if(typeof r!=`function`)return S(n.method,f);let i=await r(...u(n.params));return f===void 0?void 0:o(f,i)}catch(t){return f===void 0?void 0:s(f,e.INTERNAL_ERROR,`Internal error`,d(t))}}};function S(t,n){if(n!==void 0)return s(n,e.METHOD_NOT_FOUND,`Method not found`,{method:t})}var C=class{runtime;constructor(e=w()){if(!e?.runtime)throw Error(`Chrome runtime API is not available.`);this.runtime=e.runtime}send(e){this.runtime.sendMessage(e,()=>{this.runtime.lastError})}listen(e){let t=t=>{e(t)};return this.runtime.onMessage.addListener(t),()=>{this.runtime.onMessage.removeListener?.(t)}}};function w(){return globalThis.chrome}var T=class{ipc;channel;webContents;constructor(e,t={}){this.ipc=e,this.channel=t.channel??`rpc-channel`,this.webContents=t.webContents}send(e){if(this.webContents){this.webContents.send(this.channel,e);return}if(!this.ipc.send)throw Error(`Electron ipc sender is not available.`);this.ipc.send(this.channel,e)}listen(e){let t=(t,n)=>{e(n??t)};return this.ipc.on(this.channel,t),()=>{this.ipc.removeListener?.(this.channel,t)}}},E=class{socket;constructor(e){this.socket=e}send(e){this.socket.send(JSON.stringify(e))}listen(e){let t=t=>{e(typeof t.data==`string`?JSON.parse(t.data):t.data)};return this.socket.addEventListener(`message`,t),()=>{this.socket.removeEventListener?.(`message`,t)}}},D=class{target;options;constructor(e,t={}){this.target=e,this.options=t}send(e,t=this.options.transfer){if(t){this.target.postMessage(e,t);return}this.target.postMessage(e)}listen(e){let t=t=>{e(t.data)};if(this.target.addEventListener)return this.target.addEventListener(`message`,t),this.target.start?.(),()=>{this.target.removeEventListener?.(`message`,t)};let n=this.target.onmessage;return this.target.onmessage=e=>{n?.(e),t(e)},this.target.start?.(),()=>{this.target.onmessage=n}}};exports.BridgeClient=b,exports.BridgeServer=x,exports.ChromeTransport=C,exports.ElectronTransport=T,exports.RPCError=t,exports.RPC_ERROR_CODE=e,exports.RPC_VERSION=`2.0`,exports.WebSocketTransport=E,exports.WorkerTransport=D;

package/dist/index.d.cts

@@ -0,0 +1,187 @@
+//#region src/types.d.ts
+declare const RPC_VERSION = "2.0";
+/**
+ * 标准错误码
+ */
+declare const RPC_ERROR_CODE: {
+  readonly PARSE_ERROR: -32700;
+  readonly INVALID_REQUEST: -32600;
+  readonly METHOD_NOT_FOUND: -32601;
+  readonly INVALID_PARAMS: -32602;
+  readonly INTERNAL_ERROR: -32603;
+  readonly TIMEOUT: -32000;
+  readonly UNAUTHORIZED: -32001;
+  readonly FORBIDDEN: -32002;
+  readonly NOT_FOUND: -32003;
+};
+type RPCId = string | number | null;
+type RPCParams = readonly unknown[] | Record<string, unknown>;
+type RPCPayload = RPCMessage | readonly RPCMessage[];
+type RPCMessage = RPCRequest | RPCResponse | RPCNotification;
+interface RPCRequest {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly method: string;
+  readonly params?: RPCParams;
+  readonly id: RPCId;
+}
+interface RPCNotification {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly method: string;
+  readonly params?: RPCParams;
+}
+type RPCResponse = RPCSuccessResponse | RPCErrorResponse;
+interface RPCSuccessResponse {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly result: unknown;
+  readonly id: RPCId;
+}
+interface RPCErrorResponse {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly error: RPCErrorObject;
+  readonly id: RPCId;
+}
+interface RPCErrorObject {
+  readonly code: number;
+  readonly message: string;
+  readonly data?: unknown;
+}
+type RPCListener = (message: unknown) => void | Promise<void>;
+interface RPCTransport {
+  /**
+   * 发送 JSON-RPC 2.0 消息
+   * @param {RPCPayload} message
+   */
+  send(message: RPCPayload): void | Promise<void>;
+  /**
+   * 监听 JSON-RPC 2.0 消息
+   * @param {RPCListener} callback (message) => void
+   */
+  listen(callback: RPCListener): void | (() => void);
+}
+type RPCHandler = (...args: any[]) => any;
+type RPCService = object;
+type RPCServiceProxy<TService extends object> = { [TMethod in keyof TService as TService[TMethod] extends RPCHandler ? TMethod : never]: TService[TMethod] extends ((...args: infer TArgs) => infer TResult) ? (...args: TArgs) => Promise<Awaited<TResult>> : never };
+declare class RPCError extends Error {
+  readonly code: number;
+  readonly data: unknown;
+  constructor(error: RPCErrorObject);
+}
+//#endregion
+//#region src/client.d.ts
+interface BridgeClientOptions {
+  readonly timeoutMs?: number;
+  readonly idFactory?: () => Exclude<RPCId, null>;
+}
+declare class BridgeClient {
+  private readonly transport;
+  private readonly idFactory;
+  private readonly pendingRequests;
+  private readonly timeoutMs;
+  private readonly unsubscribe;
+  constructor(transport: RPCTransport, options?: BridgeClientOptions);
+  get pendingCount(): number;
+  getService<TService extends object = RPCService>(serviceName: string): RPCServiceProxy<TService>;
+  destroy(reason?: string): void;
+  private call;
+  private resolveResponse;
+}
+//#endregion
+//#region src/server.d.ts
+declare class BridgeServer {
+  private readonly transport;
+  private readonly services;
+  private readonly unsubscribe;
+  static readonly ERR_INVALID_REQUEST: RPCErrorResponse;
+  constructor(transport: RPCTransport);
+  registerService(name: string, service: RPCService): void;
+  unregisterService(name: string): boolean;
+  destroy(): void;
+  private handleMessage;
+  private handleBatch;
+  private handleSingle;
+}
+//#endregion
+//#region src/transports/chrome.d.ts
+interface ChromeRuntimeLastError {
+  readonly message?: string;
+}
+interface ChromeRuntimeMessageEvent {
+  addListener(listener: (message: unknown) => void): void;
+  removeListener?(listener: (message: unknown) => void): void;
+}
+interface ChromeRuntimeLike {
+  readonly lastError?: ChromeRuntimeLastError;
+  readonly onMessage: ChromeRuntimeMessageEvent;
+  sendMessage(message: unknown, callback?: () => void): void;
+}
+interface ChromeLike {
+  readonly runtime: ChromeRuntimeLike;
+}
+declare class ChromeTransport implements RPCTransport {
+  private readonly runtime;
+  constructor(chromeApi?: ChromeLike | undefined);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/electron.d.ts
+interface ElectronIpcLike {
+  send?(channel: string, message: RPCPayload): void;
+  on(channel: string, listener: (event: unknown, message?: RPCPayload) => void): void;
+  removeListener?(channel: string, listener: (event: unknown, message?: RPCPayload) => void): void;
+}
+interface ElectronWebContentsLike {
+  send(channel: string, message: RPCPayload): void;
+}
+interface ElectronTransportOptions {
+  readonly channel?: string;
+  readonly webContents?: ElectronWebContentsLike;
+}
+declare class ElectronTransport implements RPCTransport {
+  private readonly ipc;
+  private readonly channel;
+  private readonly webContents;
+  constructor(ipc: ElectronIpcLike, options?: ElectronTransportOptions);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/websocket.d.ts
+interface WebSocketMessageEvent {
+  readonly data: unknown;
+}
+interface WebSocketLike {
+  send(data: string): void;
+  addEventListener(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+  removeEventListener?(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+}
+declare class WebSocketTransport implements RPCTransport {
+  private readonly socket;
+  constructor(socket: WebSocketLike);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/worker.d.ts
+interface WorkerMessageEvent {
+  readonly data: unknown;
+}
+interface WorkerEndpoint {
+  onmessage?: ((event: WorkerMessageEvent) => void) | null;
+  postMessage(message: unknown, transfer?: readonly Transferable[]): void;
+  addEventListener?(type: "message", listener: (event: WorkerMessageEvent) => void): void;
+  removeEventListener?(type: "message", listener: (event: WorkerMessageEvent) => void): void;
+  start?(): void;
+}
+interface WorkerTransportOptions {
+  readonly transfer?: readonly Transferable[];
+}
+declare class WorkerTransport implements RPCTransport {
+  private readonly target;
+  private readonly options;
+  constructor(target: WorkerEndpoint, options?: WorkerTransportOptions);
+  send(message: RPCPayload, transfer?: readonly Transferable[] | undefined): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+export { BridgeClient, BridgeClientOptions, BridgeServer, ChromeLike, ChromeRuntimeLike, ChromeTransport, ElectronIpcLike, ElectronTransport, ElectronTransportOptions, ElectronWebContentsLike, RPCError, RPCErrorObject, RPCErrorResponse, RPCHandler, RPCId, RPCListener, RPCMessage, RPCNotification, RPCParams, RPCPayload, RPCRequest, RPCResponse, RPCService, RPCServiceProxy, RPCSuccessResponse, RPCTransport, RPC_ERROR_CODE, RPC_VERSION, WebSocketLike, WebSocketMessageEvent, WebSocketTransport, WorkerEndpoint, WorkerMessageEvent, WorkerTransport, WorkerTransportOptions };

package/dist/index.d.mts

@@ -0,0 +1,187 @@
+//#region src/types.d.ts
+declare const RPC_VERSION = "2.0";
+/**
+ * 标准错误码
+ */
+declare const RPC_ERROR_CODE: {
+  readonly PARSE_ERROR: -32700;
+  readonly INVALID_REQUEST: -32600;
+  readonly METHOD_NOT_FOUND: -32601;
+  readonly INVALID_PARAMS: -32602;
+  readonly INTERNAL_ERROR: -32603;
+  readonly TIMEOUT: -32000;
+  readonly UNAUTHORIZED: -32001;
+  readonly FORBIDDEN: -32002;
+  readonly NOT_FOUND: -32003;
+};
+type RPCId = string | number | null;
+type RPCParams = readonly unknown[] | Record<string, unknown>;
+type RPCPayload = RPCMessage | readonly RPCMessage[];
+type RPCMessage = RPCRequest | RPCResponse | RPCNotification;
+interface RPCRequest {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly method: string;
+  readonly params?: RPCParams;
+  readonly id: RPCId;
+}
+interface RPCNotification {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly method: string;
+  readonly params?: RPCParams;
+}
+type RPCResponse = RPCSuccessResponse | RPCErrorResponse;
+interface RPCSuccessResponse {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly result: unknown;
+  readonly id: RPCId;
+}
+interface RPCErrorResponse {
+  readonly jsonrpc: typeof RPC_VERSION;
+  readonly error: RPCErrorObject;
+  readonly id: RPCId;
+}
+interface RPCErrorObject {
+  readonly code: number;
+  readonly message: string;
+  readonly data?: unknown;
+}
+type RPCListener = (message: unknown) => void | Promise<void>;
+interface RPCTransport {
+  /**
+   * 发送 JSON-RPC 2.0 消息
+   * @param {RPCPayload} message
+   */
+  send(message: RPCPayload): void | Promise<void>;
+  /**
+   * 监听 JSON-RPC 2.0 消息
+   * @param {RPCListener} callback (message) => void
+   */
+  listen(callback: RPCListener): void | (() => void);
+}
+type RPCHandler = (...args: any[]) => any;
+type RPCService = object;
+type RPCServiceProxy<TService extends object> = { [TMethod in keyof TService as TService[TMethod] extends RPCHandler ? TMethod : never]: TService[TMethod] extends ((...args: infer TArgs) => infer TResult) ? (...args: TArgs) => Promise<Awaited<TResult>> : never };
+declare class RPCError extends Error {
+  readonly code: number;
+  readonly data: unknown;
+  constructor(error: RPCErrorObject);
+}
+//#endregion
+//#region src/client.d.ts
+interface BridgeClientOptions {
+  readonly timeoutMs?: number;
+  readonly idFactory?: () => Exclude<RPCId, null>;
+}
+declare class BridgeClient {
+  private readonly transport;
+  private readonly idFactory;
+  private readonly pendingRequests;
+  private readonly timeoutMs;
+  private readonly unsubscribe;
+  constructor(transport: RPCTransport, options?: BridgeClientOptions);
+  get pendingCount(): number;
+  getService<TService extends object = RPCService>(serviceName: string): RPCServiceProxy<TService>;
+  destroy(reason?: string): void;
+  private call;
+  private resolveResponse;
+}
+//#endregion
+//#region src/server.d.ts
+declare class BridgeServer {
+  private readonly transport;
+  private readonly services;
+  private readonly unsubscribe;
+  static readonly ERR_INVALID_REQUEST: RPCErrorResponse;
+  constructor(transport: RPCTransport);
+  registerService(name: string, service: RPCService): void;
+  unregisterService(name: string): boolean;
+  destroy(): void;
+  private handleMessage;
+  private handleBatch;
+  private handleSingle;
+}
+//#endregion
+//#region src/transports/chrome.d.ts
+interface ChromeRuntimeLastError {
+  readonly message?: string;
+}
+interface ChromeRuntimeMessageEvent {
+  addListener(listener: (message: unknown) => void): void;
+  removeListener?(listener: (message: unknown) => void): void;
+}
+interface ChromeRuntimeLike {
+  readonly lastError?: ChromeRuntimeLastError;
+  readonly onMessage: ChromeRuntimeMessageEvent;
+  sendMessage(message: unknown, callback?: () => void): void;
+}
+interface ChromeLike {
+  readonly runtime: ChromeRuntimeLike;
+}
+declare class ChromeTransport implements RPCTransport {
+  private readonly runtime;
+  constructor(chromeApi?: ChromeLike | undefined);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/electron.d.ts
+interface ElectronIpcLike {
+  send?(channel: string, message: RPCPayload): void;
+  on(channel: string, listener: (event: unknown, message?: RPCPayload) => void): void;
+  removeListener?(channel: string, listener: (event: unknown, message?: RPCPayload) => void): void;
+}
+interface ElectronWebContentsLike {
+  send(channel: string, message: RPCPayload): void;
+}
+interface ElectronTransportOptions {
+  readonly channel?: string;
+  readonly webContents?: ElectronWebContentsLike;
+}
+declare class ElectronTransport implements RPCTransport {
+  private readonly ipc;
+  private readonly channel;
+  private readonly webContents;
+  constructor(ipc: ElectronIpcLike, options?: ElectronTransportOptions);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/websocket.d.ts
+interface WebSocketMessageEvent {
+  readonly data: unknown;
+}
+interface WebSocketLike {
+  send(data: string): void;
+  addEventListener(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+  removeEventListener?(type: "message", listener: (event: WebSocketMessageEvent) => void): void;
+}
+declare class WebSocketTransport implements RPCTransport {
+  private readonly socket;
+  constructor(socket: WebSocketLike);
+  send(message: RPCPayload): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+//#region src/transports/worker.d.ts
+interface WorkerMessageEvent {
+  readonly data: unknown;
+}
+interface WorkerEndpoint {
+  onmessage?: ((event: WorkerMessageEvent) => void) | null;
+  postMessage(message: unknown, transfer?: readonly Transferable[]): void;
+  addEventListener?(type: "message", listener: (event: WorkerMessageEvent) => void): void;
+  removeEventListener?(type: "message", listener: (event: WorkerMessageEvent) => void): void;
+  start?(): void;
+}
+interface WorkerTransportOptions {
+  readonly transfer?: readonly Transferable[];
+}
+declare class WorkerTransport implements RPCTransport {
+  private readonly target;
+  private readonly options;
+  constructor(target: WorkerEndpoint, options?: WorkerTransportOptions);
+  send(message: RPCPayload, transfer?: readonly Transferable[] | undefined): void;
+  listen(callback: RPCListener): () => void;
+}
+//#endregion
+export { BridgeClient, BridgeClientOptions, BridgeServer, ChromeLike, ChromeRuntimeLike, ChromeTransport, ElectronIpcLike, ElectronTransport, ElectronTransportOptions, ElectronWebContentsLike, RPCError, RPCErrorObject, RPCErrorResponse, RPCHandler, RPCId, RPCListener, RPCMessage, RPCNotification, RPCParams, RPCPayload, RPCRequest, RPCResponse, RPCService, RPCServiceProxy, RPCSuccessResponse, RPCTransport, RPC_ERROR_CODE, RPC_VERSION, WebSocketLike, WebSocketMessageEvent, WebSocketTransport, WorkerEndpoint, WorkerMessageEvent, WorkerTransport, WorkerTransportOptions };

package/dist/index.mjs

@@ -0,0 +1 @@
+const e=`2.0`,t={PARSE_ERROR:-32700,INVALID_REQUEST:-32600,METHOD_NOT_FOUND:-32601,INVALID_PARAMS:-32602,INTERNAL_ERROR:-32603,TIMEOUT:-32e3,UNAUTHORIZED:-32001,FORBIDDEN:-32002,NOT_FOUND:-32003};var n=class extends Error{code;data;constructor(e){super(e.message),this.name=`JsonRpcError`,this.code=e.code,this.data=e.data}};function r(e){return m(e)&&Object.hasOwn(e,`id`)&&y(e.id)&&(g(e)||_(e))}function i(e){return h(e)&&Object.hasOwn(e,`id`)&&y(e.id)}function a(e){return h(e)&&!Object.hasOwn(e,`id`)}function o(e,t,n,r){return{jsonrpc:`2.0`,method:`${e}.${t}`,params:n,id:r}}function s(e,t){return{jsonrpc:`2.0`,result:t===void 0?null:t,id:e}}function c(e,t,n,r){return{jsonrpc:`2.0`,error:r===void 0?{code:t,message:n}:{code:t,message:n,data:r},id:e}}function l(){let e=Math.random().toString(36).slice(2,11);return`${Date.now().toString(36)}-${e}`}function u(e){let t=e.lastIndexOf(`.`);if(!(t<=0||t===e.length-1))return{serviceName:e.slice(0,t),methodName:e.slice(t+1)}}function d(e){return e===void 0?[]:Array.isArray(e)?e:[e]}function f(e){return e instanceof Error?{name:e.name,message:e.message,stack:e.stack}:String(e)}function p(e){return new n(e)}function m(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&e.jsonrpc===`2.0`}function h(e){return m(e)&&typeof e.method==`string`&&(e.params===void 0||v(e.params))}function g(e){return m(e)&&Object.hasOwn(e,`result`)&&!Object.hasOwn(e,`error`)}function _(e){if(!m(e)||!Object.hasOwn(e,`error`))return!1;let t=e.error;return typeof t==`object`&&!!t&&!Array.isArray(t)&&typeof t.code==`number`&&typeof t.message==`string`}function v(e){return Array.isArray(e)||b(e)}function y(e){return typeof e==`string`||typeof e==`number`||e===null}function b(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Object.getPrototypeOf(e)===Object.prototype}var x=class{transport;idFactory;pendingRequests=new Map;timeoutMs;unsubscribe;constructor(e,t={}){this.transport=e,this.timeoutMs=t.timeoutMs??15e3,this.idFactory=t.idFactory??l;let n=this.transport.listen(e=>{r(e)&&this.resolveResponse(e)});this.unsubscribe=typeof n==`function`?n:void 0}get pendingCount(){return this.pendingRequests.size}getService(e){return new Proxy({},{get:(t,n)=>{if(!(typeof n!=`string`||n===`then`))return(...t)=>this.call(e,n,t)}})}destroy(e=`RPC client destroyed.`){this.unsubscribe?.();for(let[t,n]of this.pendingRequests)clearTimeout(n.timer),n.reject(Error(e)),this.pendingRequests.delete(t)}call(e,t,n){let r=this.idFactory();return new Promise((i,a)=>{let s=setTimeout(()=>{this.pendingRequests.delete(r),a(Error(`RPC request to ${e}.${t} timed out after ${this.timeoutMs}ms.`))},this.timeoutMs);this.pendingRequests.set(r,{serviceName:e,method:t,resolve:i,reject:a,timer:s}),this.transport.send(o(e,t,n,r))})}resolveResponse(e){if(e.id===null)return;let t=this.pendingRequests.get(e.id);if(t){if(clearTimeout(t.timer),this.pendingRequests.delete(e.id),e.error){t.reject(p(e.error));return}t.resolve(e.result)}}},S=class e{transport;services=new Map;unsubscribe;static ERR_INVALID_REQUEST=c(null,t.INVALID_REQUEST,`Invalid Request`);constructor(e){this.transport=e;let t=this.transport.listen(e=>{this.handleMessage(e)});this.unsubscribe=typeof t==`function`?t:void 0}registerService(e,t){this.services.set(e,t)}unregisterService(e){return this.services.delete(e)}destroy(){this.services.clear(),this.unsubscribe?.()}async handleMessage(e){if(Array.isArray(e)){await this.handleBatch(e);return}let t=await this.handleSingle(e);t&&await this.transport.send(t)}async handleBatch(t){if(t.length===0){await this.transport.send(e.ERR_INVALID_REQUEST);return}let n=(await Promise.all(t.map(e=>this.handleSingle(e)))).filter(e=>e!==void 0);n.length>0&&await this.transport.send(n)}async handleSingle(n){let r=i(n),o=a(n);if(!r&&!o)return e.ERR_INVALID_REQUEST;let l=r?n.id:void 0;try{let e=u(n.method);if(!e||n.method.startsWith(`rpc.`))return C(n.method,l);let t=this.services.get(e.serviceName);if(!t)return C(n.method,l);let r=t[e.methodName];if(typeof r!=`function`)return C(n.method,l);let i=await r(...d(n.params));return l===void 0?void 0:s(l,i)}catch(e){return l===void 0?void 0:c(l,t.INTERNAL_ERROR,`Internal error`,f(e))}}};function C(e,n){if(n!==void 0)return c(n,t.METHOD_NOT_FOUND,`Method not found`,{method:e})}var w=class{runtime;constructor(e=T()){if(!e?.runtime)throw Error(`Chrome runtime API is not available.`);this.runtime=e.runtime}send(e){this.runtime.sendMessage(e,()=>{this.runtime.lastError})}listen(e){let t=t=>{e(t)};return this.runtime.onMessage.addListener(t),()=>{this.runtime.onMessage.removeListener?.(t)}}};function T(){return globalThis.chrome}var E=class{ipc;channel;webContents;constructor(e,t={}){this.ipc=e,this.channel=t.channel??`rpc-channel`,this.webContents=t.webContents}send(e){if(this.webContents){this.webContents.send(this.channel,e);return}if(!this.ipc.send)throw Error(`Electron ipc sender is not available.`);this.ipc.send(this.channel,e)}listen(e){let t=(t,n)=>{e(n??t)};return this.ipc.on(this.channel,t),()=>{this.ipc.removeListener?.(this.channel,t)}}},D=class{socket;constructor(e){this.socket=e}send(e){this.socket.send(JSON.stringify(e))}listen(e){let t=t=>{e(typeof t.data==`string`?JSON.parse(t.data):t.data)};return this.socket.addEventListener(`message`,t),()=>{this.socket.removeEventListener?.(`message`,t)}}},O=class{target;options;constructor(e,t={}){this.target=e,this.options=t}send(e,t=this.options.transfer){if(t){this.target.postMessage(e,t);return}this.target.postMessage(e)}listen(e){let t=t=>{e(t.data)};if(this.target.addEventListener)return this.target.addEventListener(`message`,t),this.target.start?.(),()=>{this.target.removeEventListener?.(`message`,t)};let n=this.target.onmessage;return this.target.onmessage=e=>{n?.(e),t(e)},this.target.start?.(),()=>{this.target.onmessage=n}}};export{x as BridgeClient,S as BridgeServer,w as ChromeTransport,E as ElectronTransport,n as RPCError,t as RPC_ERROR_CODE,e as RPC_VERSION,D as WebSocketTransport,O as WorkerTransport};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@nsky/rpc-bridge",
+  "version": "0.0.1-beta",
+  "description": "Transport-agnostic RPC bridge for workers, extensions, Electron, and WebSocket runtimes.",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "development": "./src/index.ts",
+      "production": "./src/index.ts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "pnpm exec tsdown",
+    "dev": "pnpm exec tsdown --watch",
+    "publint": "publint",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}