kkrpc 0.2.1 → 0.2.2

package/README.md

@@ -58,6 +58,34 @@ class RPCChannel<
 > {}
 ```
 
+## Serialization
+
+kkrpc supports two serialization formats for message transmission:
+
+- `json`: Standard JSON serialization
+- `superjson`: Enhanced JSON serialization with support for more data types like Date, Map, Set, BigInt, and Uint8Array (default since v0.2.0)
+
+You can specify the serialization format when creating a new RPCChannel:
+
+```ts
+// Using default serialization (superjson)
+const rpc = new RPCChannel(io, { expose: apiImplementation })
+
+// Explicitly using superjson serialization (recommended for clarity)
+const rpc = new RPCChannel(io, {
+	expose: apiImplementation,
+	serialization: { version: "superjson" }
+})
+
+// Using standard JSON serialization (for backward compatibility)
+const rpc = new RPCChannel(io, {
+	expose: apiImplementation,
+	serialization: { version: "json" }
+})
+```
+
+For backward compatibility, the receiving side will automatically detect the serialization format so older clients can communicate with newer servers and vice versa.
+
 ## Examples
 
 Below are simple examples.

package/dist/browser-mod.cjs

@@ -39,10 +39,8 @@ __export(browser_mod_exports, {
   WorkerChildIO: () => WorkerChildIO,
   WorkerParentIO: () => WorkerParentIO,
   deserializeMessage: () => deserializeMessage,
-  deserializeResponse: () => deserializeResponse,
   generateUUID: () => generateUUID,
-  serializeMessage: () => serializeMessage,
-  serializeResponse: () => serializeResponse
+  serializeMessage: () => serializeMessage
 });
 module.exports = __toCommonJS(browser_mod_exports);
 
@@ -369,30 +367,39 @@ var import_node_buffer = require("buffer");
 
 // src/serialization.ts
 var import_superjson = __toESM(require("superjson"), 1);
-function serializeMessage(message) {
-  return import_superjson.default.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
 }
-function deserializeMessage(message) {
-  return new Promise((resolve, reject) => {
-    try {
-      const parsed = import_superjson.default.parse(message);
-      resolve(parsed);
-    } catch (error) {
-      console.error("failed to parse message", typeof message, message, error);
-      reject(error);
-    }
-  });
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
 }
-function serializeResponse(response) {
-  return import_superjson.default.stringify(response) + "\n";
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : import_superjson.default.stringify(msgWithVersion) + "\n";
 }
-function deserializeResponse(response) {
+function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = import_superjson.default.parse(response);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = import_superjson.default.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
-      console.error("failed to parse response", response);
+      console.error("failed to parse message", typeof message, message, error);
       reject(error);
     }
   });
@@ -408,6 +415,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -416,6 +424,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -462,7 +471,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -512,7 +521,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -586,7 +595,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -615,7 +624,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -630,7 +639,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls
@@ -681,8 +690,6 @@ var RPCChannel = class {
   WorkerChildIO,
   WorkerParentIO,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 });

package/dist/browser-mod.d.cts

@@ -1,7 +1,7 @@
-export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-CRNRbu3f.cjs';
-export { ChromeBackgroundIO, ChromeContentIO, Message, Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse } from './chrome.cjs';
-import { D as DestroyableIoInterface } from './channel-D6ZClufP.cjs';
-export { I as IoInterface, R as RPCChannel } from './channel-D6ZClufP.cjs';
+export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-ohph68oo.cjs';
+export { ChromeBackgroundIO, ChromeContentIO, generateUUID } from './chrome.cjs';
+import { D as DestroyableIoInterface } from './channel-C01VCxab.cjs';
+export { I as IoInterface, M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.cjs';
 import '@tauri-apps/plugin-shell';
 import 'node:buffer';
 

package/dist/browser-mod.d.ts

@@ -1,7 +1,7 @@
-export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-PdcZTVUI.js';
-export { ChromeBackgroundIO, ChromeContentIO, Message, Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse } from './chrome.js';
-import { D as DestroyableIoInterface } from './channel-D6ZClufP.js';
-export { I as IoInterface, R as RPCChannel } from './channel-D6ZClufP.js';
+export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-pC0wuvjw.js';
+export { ChromeBackgroundIO, ChromeContentIO, generateUUID } from './chrome.js';
+import { D as DestroyableIoInterface } from './channel-C01VCxab.js';
+export { I as IoInterface, M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.js';
 import '@tauri-apps/plugin-shell';
 import 'node:buffer';
 

package/dist/browser-mod.js

@@ -10,11 +10,9 @@ import {
 import {
   RPCChannel,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
-} from "./chunk-ZSSFWNSX.js";
+  serializeMessage
+} from "./chunk-YIQVRWAJ.js";
 
 // src/adapters/iframe.ts
 var DESTROY_SIGNAL = "__DESTROY__";
@@ -159,8 +157,6 @@ export {
   WorkerChildIO,
   WorkerParentIO,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 };

package/dist/{channel-D6ZClufP.d.cts → channel-C01VCxab.d.cts}

@@ -21,6 +21,38 @@ interface DestroyableIoInterface extends IoInterface {
     signalDestroy(): void;
 }
 
+/**
+ * This file contains the serialization and deserialization functions for the RPC protocol.
+ */
+interface Message<T = any> {
+    id: string;
+    method: string;
+    args: T;
+    type: "request" | "response" | "callback";
+    callbackIds?: string[];
+    version?: "json" | "superjson";
+}
+interface Response<T = any> {
+    result?: T;
+    error?: string;
+}
+interface SerializationOptions {
+    version?: "json" | "superjson";
+}
+/**
+ * Serialize a message with superjson (supports all data types supported by superjson)
+ * @param message - The message to serialize, an object of any shape
+ * @param options - Serialization options, default to use superjson
+ * @returns The serialized message
+ */
+declare function serializeMessage<T>(message: Message<T>, options?: SerializationOptions): string;
+/**
+ * Deserialize a message with superjson (supports all data types supported by superjson)
+ * @param message - The serialized message
+ * @returns The deserialized message
+ */
+declare function deserializeMessage<T>(message: string): Promise<Message<T>>;
+
 /**
  * A bidirectional Stdio IPC channel in RPC style.
  * This allows 2 JS/TS processes to call each other's API like using libraries in RPC style,
@@ -34,8 +66,10 @@ declare class RPCChannel<LocalAPI extends Record<string, any>, RemoteAPI extends
     private count;
     private messageStr;
     private apiImplementation?;
+    private serializationOptions;
     constructor(io: Io, options?: {
         expose?: LocalAPI;
+        serialization?: SerializationOptions;
     });
     /**
      * Exposes a local API implementation that can be called remotely
@@ -125,4 +159,4 @@ declare class RPCChannel<LocalAPI extends Record<string, any>, RemoteAPI extends
     freeCallbacks(): void;
 }
 
-export { type DestroyableIoInterface as D, type IoInterface as I, RPCChannel as R };
+export { type DestroyableIoInterface as D, type IoInterface as I, type Message as M, RPCChannel as R, type SerializationOptions as S, type Response as a, deserializeMessage as d, serializeMessage as s };

package/dist/{channel-D6ZClufP.d.ts → channel-C01VCxab.d.ts}

@@ -21,6 +21,38 @@ interface DestroyableIoInterface extends IoInterface {
     signalDestroy(): void;
 }
 
+/**
+ * This file contains the serialization and deserialization functions for the RPC protocol.
+ */
+interface Message<T = any> {
+    id: string;
+    method: string;
+    args: T;
+    type: "request" | "response" | "callback";
+    callbackIds?: string[];
+    version?: "json" | "superjson";
+}
+interface Response<T = any> {
+    result?: T;
+    error?: string;
+}
+interface SerializationOptions {
+    version?: "json" | "superjson";
+}
+/**
+ * Serialize a message with superjson (supports all data types supported by superjson)
+ * @param message - The message to serialize, an object of any shape
+ * @param options - Serialization options, default to use superjson
+ * @returns The serialized message
+ */
+declare function serializeMessage<T>(message: Message<T>, options?: SerializationOptions): string;
+/**
+ * Deserialize a message with superjson (supports all data types supported by superjson)
+ * @param message - The serialized message
+ * @returns The deserialized message
+ */
+declare function deserializeMessage<T>(message: string): Promise<Message<T>>;
+
 /**
  * A bidirectional Stdio IPC channel in RPC style.
  * This allows 2 JS/TS processes to call each other's API like using libraries in RPC style,
@@ -34,8 +66,10 @@ declare class RPCChannel<LocalAPI extends Record<string, any>, RemoteAPI extends
     private count;
     private messageStr;
     private apiImplementation?;
+    private serializationOptions;
     constructor(io: Io, options?: {
         expose?: LocalAPI;
+        serialization?: SerializationOptions;
     });
     /**
      * Exposes a local API implementation that can be called remotely
@@ -125,4 +159,4 @@ declare class RPCChannel<LocalAPI extends Record<string, any>, RemoteAPI extends
     freeCallbacks(): void;
 }
 
-export { type DestroyableIoInterface as D, type IoInterface as I, RPCChannel as R };
+export { type DestroyableIoInterface as D, type IoInterface as I, type Message as M, RPCChannel as R, type SerializationOptions as S, type Response as a, deserializeMessage as d, serializeMessage as s };

package/dist/chrome.cjs

@@ -34,10 +34,8 @@ __export(chrome_exports, {
   ChromeContentIO: () => ChromeContentIO,
   RPCChannel: () => RPCChannel,
   deserializeMessage: () => deserializeMessage,
-  deserializeResponse: () => deserializeResponse,
   generateUUID: () => generateUUID,
-  serializeMessage: () => serializeMessage,
-  serializeResponse: () => serializeResponse
+  serializeMessage: () => serializeMessage
 });
 module.exports = __toCommonJS(chrome_exports);
 
@@ -126,30 +124,39 @@ var import_node_buffer = require("buffer");
 
 // src/serialization.ts
 var import_superjson = __toESM(require("superjson"), 1);
-function serializeMessage(message) {
-  return import_superjson.default.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
 }
-function deserializeMessage(message) {
-  return new Promise((resolve, reject) => {
-    try {
-      const parsed = import_superjson.default.parse(message);
-      resolve(parsed);
-    } catch (error) {
-      console.error("failed to parse message", typeof message, message, error);
-      reject(error);
-    }
-  });
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
 }
-function serializeResponse(response) {
-  return import_superjson.default.stringify(response) + "\n";
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : import_superjson.default.stringify(msgWithVersion) + "\n";
 }
-function deserializeResponse(response) {
+function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = import_superjson.default.parse(response);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = import_superjson.default.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
-      console.error("failed to parse response", response);
+      console.error("failed to parse message", typeof message, message, error);
       reject(error);
     }
   });
@@ -165,6 +172,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -173,6 +181,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -219,7 +228,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -269,7 +278,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -343,7 +352,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -372,7 +381,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -387,7 +396,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls
@@ -433,8 +442,6 @@ var RPCChannel = class {
   ChromeContentIO,
   RPCChannel,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 });

package/dist/chrome.d.cts

@@ -1,5 +1,5 @@
-import { D as DestroyableIoInterface } from './channel-D6ZClufP.cjs';
-export { I as IoInterface, R as RPCChannel } from './channel-D6ZClufP.cjs';
+import { D as DestroyableIoInterface } from './channel-C01VCxab.cjs';
+export { I as IoInterface, M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.cjs';
 import 'node:buffer';
 
 /**
@@ -40,43 +40,4 @@ declare class ChromeContentIO implements DestroyableIoInterface {
  */
 declare function generateUUID(): string;
 
-/**
- * This file contains the serialization and deserialization functions for the RPC protocol.
- */
-interface Message<T = any> {
-    id: string;
-    method: string;
-    args: T;
-    type: "request" | "response" | "callback";
-    callbackIds?: string[];
-}
-interface Response<T = any> {
-    result?: T;
-    error?: string;
-}
-/**
- * Serialize a message with superjson (supports all data types supported by superjson)
- * @param message - The message to serialize, an object of any shape
- * @returns The serialized message
- */
-declare function serializeMessage<T>(message: Message<T>): string;
-/**
- * Deserialize a message with superjson (supports all data types supported by superjson)
- * @param message - The serialized message
- * @returns The deserialized message
- */
-declare function deserializeMessage<T>(message: string): Promise<Message<T>>;
-/**
- * Serialize a response with JSON (only supports primitive types)
- * @param response - The response to serialize, an object of primitive types
- * @returns The serialized response
- */
-declare function serializeResponse<T>(response: Response<T>): string;
-/**
- * Deserialize a response with superjson (supports all data types supported by superjson)
- * @param response - The serialized response
- * @returns The deserialized response
- */
-declare function deserializeResponse<T>(response: string): Promise<Response<T>>;
-
-export { ChromeBackgroundIO, ChromeContentIO, DestroyableIoInterface, type Message, type Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse };
+export { ChromeBackgroundIO, ChromeContentIO, DestroyableIoInterface, generateUUID };

package/dist/chrome.d.ts

@@ -1,5 +1,5 @@
-import { D as DestroyableIoInterface } from './channel-D6ZClufP.js';
-export { I as IoInterface, R as RPCChannel } from './channel-D6ZClufP.js';
+import { D as DestroyableIoInterface } from './channel-C01VCxab.js';
+export { I as IoInterface, M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.js';
 import 'node:buffer';
 
 /**
@@ -40,43 +40,4 @@ declare class ChromeContentIO implements DestroyableIoInterface {
  */
 declare function generateUUID(): string;
 
-/**
- * This file contains the serialization and deserialization functions for the RPC protocol.
- */
-interface Message<T = any> {
-    id: string;
-    method: string;
-    args: T;
-    type: "request" | "response" | "callback";
-    callbackIds?: string[];
-}
-interface Response<T = any> {
-    result?: T;
-    error?: string;
-}
-/**
- * Serialize a message with superjson (supports all data types supported by superjson)
- * @param message - The message to serialize, an object of any shape
- * @returns The serialized message
- */
-declare function serializeMessage<T>(message: Message<T>): string;
-/**
- * Deserialize a message with superjson (supports all data types supported by superjson)
- * @param message - The serialized message
- * @returns The deserialized message
- */
-declare function deserializeMessage<T>(message: string): Promise<Message<T>>;
-/**
- * Serialize a response with JSON (only supports primitive types)
- * @param response - The response to serialize, an object of primitive types
- * @returns The serialized response
- */
-declare function serializeResponse<T>(response: Response<T>): string;
-/**
- * Deserialize a response with superjson (supports all data types supported by superjson)
- * @param response - The serialized response
- * @returns The deserialized response
- */
-declare function deserializeResponse<T>(response: string): Promise<Response<T>>;
-
-export { ChromeBackgroundIO, ChromeContentIO, DestroyableIoInterface, type Message, type Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse };
+export { ChromeBackgroundIO, ChromeContentIO, DestroyableIoInterface, generateUUID };

package/dist/chrome.js

@@ -5,18 +5,14 @@ import {
 import {
   RPCChannel,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
-} from "./chunk-ZSSFWNSX.js";
+  serializeMessage
+} from "./chunk-YIQVRWAJ.js";
 export {
   ChromeBackgroundIO,
   ChromeContentIO,
   RPCChannel,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 };

package/dist/{chunk-ZSSFWNSX.js → chunk-YIQVRWAJ.js}

@@ -1,29 +1,38 @@
 // src/serialization.ts
 import superjson from "superjson";
-function serializeMessage(message) {
-  return superjson.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
 }
-function deserializeMessage(message) {
-  return new Promise((resolve, reject) => {
-    try {
-      const parsed = superjson.parse(message);
-      resolve(parsed);
-    } catch (error) {
-      console.error("failed to parse message", typeof message, message, error);
-      reject(error);
-    }
-  });
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
 }
-function serializeResponse(response) {
-  return superjson.stringify(response) + "\n";
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : superjson.stringify(msgWithVersion) + "\n";
 }
-function deserializeResponse(response) {
+function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = superjson.parse(response);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = superjson.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
-      console.error("failed to parse response", response);
+      console.error("failed to parse message", typeof message, message, error);
       reject(error);
     }
   });
@@ -39,6 +48,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -47,6 +57,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -93,7 +104,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -143,7 +154,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -217,7 +228,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -246,7 +257,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -261,7 +272,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls
@@ -305,8 +316,6 @@ var RPCChannel = class {
 export {
   serializeMessage,
   deserializeMessage,
-  serializeResponse,
-  deserializeResponse,
   generateUUID,
   RPCChannel
 };

package/dist/deno-mod.cjs

@@ -61,14 +61,37 @@ var DenoIo = class {
 
 // src/serialization.ts
 var import_superjson = __toESM(require("superjson"), 1);
-function serializeMessage(message) {
-  return import_superjson.default.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
+}
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
+}
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : import_superjson.default.stringify(msgWithVersion) + "\n";
 }
 function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = import_superjson.default.parse(message);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = import_superjson.default.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
       console.error("failed to parse message", typeof message, message, error);
       reject(error);
@@ -86,6 +109,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -94,6 +118,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -140,7 +165,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -190,7 +215,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -264,7 +289,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -293,7 +318,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -308,7 +333,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls

package/dist/deno-mod.d.cts

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer';
-import { I as IoInterface } from './channel-D6ZClufP.cjs';
-export { R as RPCChannel } from './channel-D6ZClufP.cjs';
+import { I as IoInterface } from './channel-C01VCxab.cjs';
+export { R as RPCChannel } from './channel-C01VCxab.cjs';
 
 /**
  * Stdio implementation for Deno

package/dist/deno-mod.d.ts

@@ -1,6 +1,6 @@
 import { Buffer } from 'node:buffer';
-import { I as IoInterface } from './channel-D6ZClufP.js';
-export { R as RPCChannel } from './channel-D6ZClufP.js';
+import { I as IoInterface } from './channel-C01VCxab.js';
+export { R as RPCChannel } from './channel-C01VCxab.js';
 
 /**
  * Stdio implementation for Deno

package/dist/deno-mod.js

@@ -3,7 +3,7 @@ import {
 } from "./chunk-GRCUBSPR.js";
 import {
   RPCChannel
-} from "./chunk-ZSSFWNSX.js";
+} from "./chunk-YIQVRWAJ.js";
 export {
   DenoIo,
   RPCChannel

package/dist/{http-CvGfNM3D.d.cts → http-D0k1TiAJ.d.cts}

@@ -1,4 +1,4 @@
-import { I as IoInterface } from './channel-D6ZClufP.cjs';
+import { I as IoInterface } from './channel-C01VCxab.cjs';
 
 interface HTTPClientOptions {
     url: string;

package/dist/{http-Bz7mwStC.d.ts → http-D6N0U5-p.d.ts}

@@ -1,4 +1,4 @@
-import { I as IoInterface } from './channel-D6ZClufP.js';
+import { I as IoInterface } from './channel-C01VCxab.js';
 
 interface HTTPClientOptions {
     url: string;

package/dist/http.cjs

@@ -130,14 +130,37 @@ var HTTPServerIO = class {
 
 // src/serialization.ts
 var import_superjson2 = __toESM(require("superjson"), 1);
-function serializeMessage(message) {
-  return import_superjson2.default.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
+}
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
+}
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : import_superjson2.default.stringify(msgWithVersion) + "\n";
 }
 function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = import_superjson2.default.parse(message);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = import_superjson2.default.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
       console.error("failed to parse message", typeof message, message, error);
       reject(error);
@@ -155,6 +178,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -163,6 +187,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -209,7 +234,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -259,7 +284,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -333,7 +358,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -362,7 +387,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -377,7 +402,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls

package/dist/http.d.cts

@@ -1,5 +1,5 @@
-import { R as RPCChannel, I as IoInterface } from './channel-D6ZClufP.cjs';
-export { H as HTTPClientIO, a as HTTPServerIO } from './http-CvGfNM3D.cjs';
+import { R as RPCChannel, I as IoInterface } from './channel-C01VCxab.cjs';
+export { H as HTTPClientIO, a as HTTPServerIO } from './http-D0k1TiAJ.cjs';
 import 'node:buffer';
 
 declare function createHttpClient<API extends Record<string, any>>(url: string): {

package/dist/http.d.ts

@@ -1,5 +1,5 @@
-import { R as RPCChannel, I as IoInterface } from './channel-D6ZClufP.js';
-export { H as HTTPClientIO, a as HTTPServerIO } from './http-Bz7mwStC.js';
+import { R as RPCChannel, I as IoInterface } from './channel-C01VCxab.js';
+export { H as HTTPClientIO, a as HTTPServerIO } from './http-D6N0U5-p.js';
 import 'node:buffer';
 
 declare function createHttpClient<API extends Record<string, any>>(url: string): {

package/dist/http.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-SZGZ2RBM.js";
 import {
   RPCChannel
-} from "./chunk-ZSSFWNSX.js";
+} from "./chunk-YIQVRWAJ.js";
 
 // http.ts
 function createHttpClient(url) {

package/dist/mod.cjs

@@ -44,10 +44,8 @@ __export(mod_exports, {
   WorkerChildIO: () => WorkerChildIO,
   WorkerParentIO: () => WorkerParentIO,
   deserializeMessage: () => deserializeMessage,
-  deserializeResponse: () => deserializeResponse,
   generateUUID: () => generateUUID,
-  serializeMessage: () => serializeMessage,
-  serializeResponse: () => serializeResponse
+  serializeMessage: () => serializeMessage
 });
 module.exports = __toCommonJS(mod_exports);
 
@@ -503,30 +501,39 @@ var TauriShellStdio = class {
 
 // src/serialization.ts
 var import_superjson2 = __toESM(require("superjson"), 1);
-function serializeMessage(message) {
-  return import_superjson2.default.stringify(message) + "\n";
+function replacer(key, value) {
+  if (value instanceof Uint8Array) {
+    return {
+      type: "Uint8Array",
+      data: Array.from(value)
+      // Convert to regular array
+    };
+  }
+  return value;
 }
-function deserializeMessage(message) {
-  return new Promise((resolve, reject) => {
-    try {
-      const parsed = import_superjson2.default.parse(message);
-      resolve(parsed);
-    } catch (error) {
-      console.error("failed to parse message", typeof message, message, error);
-      reject(error);
-    }
-  });
+function reviver(key, value) {
+  if (value && value.type === "Uint8Array" && Array.isArray(value.data)) {
+    return new Uint8Array(value.data);
+  }
+  return value;
 }
-function serializeResponse(response) {
-  return import_superjson2.default.stringify(response) + "\n";
+function serializeMessage(message, options = {}) {
+  const version = options.version || "superjson";
+  const msgWithVersion = { ...message, version };
+  return version === "json" ? JSON.stringify(msgWithVersion, replacer) + "\n" : import_superjson2.default.stringify(msgWithVersion) + "\n";
 }
-function deserializeResponse(response) {
+function deserializeMessage(message) {
   return new Promise((resolve, reject) => {
     try {
-      const parsed = import_superjson2.default.parse(response);
-      resolve(parsed);
+      if (message.startsWith('{"json":')) {
+        const parsed = import_superjson2.default.parse(message);
+        resolve(parsed);
+      } else {
+        const parsed = JSON.parse(message, reviver);
+        resolve(parsed);
+      }
     } catch (error) {
-      console.error("failed to parse response", response);
+      console.error("failed to parse message", typeof message, message, error);
       reject(error);
     }
   });
@@ -542,6 +549,7 @@ var RPCChannel = class {
   constructor(io, options) {
     this.io = io;
     this.apiImplementation = options?.expose;
+    this.serializationOptions = options?.serialization || {};
     this.listen();
   }
   pendingRequests = {};
@@ -550,6 +558,7 @@ var RPCChannel = class {
   count = 0;
   messageStr = "";
   apiImplementation;
+  serializationOptions;
   /**
    * Exposes a local API implementation that can be called remotely
    * @param api The local API implementation to expose
@@ -596,7 +605,7 @@ var RPCChannel = class {
   /**
    * Handles a single message string by parsing and routing it
    * @param messageStr The message string to handle
-   * @private 
+   * @private
    */
   async handleMessageStr(messageStr) {
     this.count++;
@@ -646,7 +655,7 @@ var RPCChannel = class {
         type: "request",
         callbackIds: callbackIds.length > 0 ? callbackIds : void 0
       };
-      this.io.write(serializeMessage(message));
+      this.io.write(serializeMessage(message, this.serializationOptions));
     });
   }
   /**
@@ -720,7 +729,7 @@ var RPCChannel = class {
       args,
       type: "callback"
     };
-    this.io.write(serializeMessage(message));
+    this.io.write(serializeMessage(message, this.serializationOptions));
   }
   /**
    * Handles callback invocations received from the remote endpoint
@@ -749,7 +758,7 @@ var RPCChannel = class {
       args: { result },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Sends an error response back to the remote endpoint
@@ -764,7 +773,7 @@ var RPCChannel = class {
       args: { error },
       type: "response"
     };
-    this.io.write(serializeMessage(response));
+    this.io.write(serializeMessage(response, this.serializationOptions));
   }
   /**
    * Creates a nested proxy object for chaining remote method calls
@@ -844,8 +853,6 @@ var DenoIo = class {
   WorkerChildIO,
   WorkerParentIO,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 });

package/dist/mod.d.cts

@@ -1,10 +1,10 @@
-export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-CRNRbu3f.cjs';
-export { ChromeBackgroundIO, ChromeContentIO, Message, Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse } from './chrome.cjs';
+export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-ohph68oo.cjs';
+export { ChromeBackgroundIO, ChromeContentIO, generateUUID } from './chrome.cjs';
 import { Buffer } from 'node:buffer';
-import { I as IoInterface, D as DestroyableIoInterface } from './channel-D6ZClufP.cjs';
-export { R as RPCChannel } from './channel-D6ZClufP.cjs';
+import { I as IoInterface, D as DestroyableIoInterface } from './channel-C01VCxab.cjs';
+export { M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.cjs';
 import { Readable, Writable } from 'node:stream';
-export { H as HTTPClientIO, a as HTTPServerIO } from './http-CvGfNM3D.cjs';
+export { H as HTTPClientIO, a as HTTPServerIO } from './http-D0k1TiAJ.cjs';
 export { DenoIo } from './deno-mod.cjs';
 import '@tauri-apps/plugin-shell';
 

package/dist/mod.d.ts

@@ -1,10 +1,10 @@
-export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-PdcZTVUI.js';
-export { ChromeBackgroundIO, ChromeContentIO, Message, Response, deserializeMessage, deserializeResponse, generateUUID, serializeMessage, serializeResponse } from './chrome.js';
+export { T as TauriShellStdio, a as WorkerChildIO, W as WorkerParentIO } from './tauri-pC0wuvjw.js';
+export { ChromeBackgroundIO, ChromeContentIO, generateUUID } from './chrome.js';
 import { Buffer } from 'node:buffer';
-import { I as IoInterface, D as DestroyableIoInterface } from './channel-D6ZClufP.js';
-export { R as RPCChannel } from './channel-D6ZClufP.js';
+import { I as IoInterface, D as DestroyableIoInterface } from './channel-C01VCxab.js';
+export { M as Message, R as RPCChannel, a as Response, S as SerializationOptions, d as deserializeMessage, s as serializeMessage } from './channel-C01VCxab.js';
 import { Readable, Writable } from 'node:stream';
-export { H as HTTPClientIO, a as HTTPServerIO } from './http-Bz7mwStC.js';
+export { H as HTTPClientIO, a as HTTPServerIO } from './http-D6N0U5-p.js';
 export { DenoIo } from './deno-mod.js';
 import '@tauri-apps/plugin-shell';
 

package/dist/mod.js

@@ -17,11 +17,9 @@ import {
 import {
   RPCChannel,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
-} from "./chunk-ZSSFWNSX.js";
+  serializeMessage
+} from "./chunk-YIQVRWAJ.js";
 
 // src/adapters/bun.ts
 import { Buffer } from "node:buffer";
@@ -206,8 +204,6 @@ export {
   WorkerChildIO,
   WorkerParentIO,
   deserializeMessage,
-  deserializeResponse,
   generateUUID,
-  serializeMessage,
-  serializeResponse
+  serializeMessage
 };

package/dist/{tauri-CRNRbu3f.d.cts → tauri-ohph68oo.d.cts}

@@ -1,4 +1,4 @@
-import { D as DestroyableIoInterface, I as IoInterface } from './channel-D6ZClufP.cjs';
+import { D as DestroyableIoInterface, I as IoInterface } from './channel-C01VCxab.cjs';
 import { EventEmitter, OutputEvents, Child } from '@tauri-apps/plugin-shell';
 
 declare class WorkerParentIO implements DestroyableIoInterface {

package/dist/{tauri-PdcZTVUI.d.ts → tauri-pC0wuvjw.d.ts}

@@ -1,4 +1,4 @@
-import { D as DestroyableIoInterface, I as IoInterface } from './channel-D6ZClufP.js';
+import { D as DestroyableIoInterface, I as IoInterface } from './channel-C01VCxab.js';
 import { EventEmitter, OutputEvents, Child } from '@tauri-apps/plugin-shell';
 
 declare class WorkerParentIO implements DestroyableIoInterface {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "kkrpc",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"type": "module",
 	"repository": {
 		"type": "git",