feat: add new encoder option and deprecate old serializer (#67)

.changeset/five-olives-cheat.md

@@ -0,0 +1,5 @@
+---
+'async-call-rpc': minor
+---
+
+add new `encoder` option and deprecate old `serializer` option

.changeset/grumpy-phones-listen.md

@@ -0,0 +1,14 @@
+---
+'async-call-rpc': minor
+---
+
+`hint` added to the `CallbackBasedChannel.setup(jsonRPCHandlerCallback)` and `EventBasedChannel.on(listener)`.
+
+For an isomorphic instance of `AsyncCall` (used as both a server and a client),
+when a new message comes, it does not clear if to call `decodeRequest` or `decodeRespones`.
+
+This version introduce a new option `encoder` to replace `serialization`. `serialization` is always working in isomorphic way.
+
+- If `hint` is `"request"`, `(encoder as ServerEncoding).decodeRequest` will be called first, if this method does not exist, `(encoder as IsomorphicEncoder).decode` will be called.
+- If `hint` is `"response"`, `(encoder as ClientEncoding).decodeResponse` will be called first, if this method does not exist, `(encoder as IsomorphicEncoder).decode` will be called.
+- If `hint` does not present, only `encoder.decode` will be called.

.changeset/odd-scissors-admire.md

@@ -0,0 +1,5 @@
+---
+'async-call-rpc': minor
+---
+
+`BSON_Serialization` and `Msgpack_Serialization` is now deprecated

.changeset/smooth-ties-nail.md

@@ -0,0 +1,5 @@
+---
+"async-call-rpc": patch
+---
+
+Add Promise<void> into return signature of EventBasedChannel.send

.changeset/strange-readers-agree.md

@@ -0,0 +1,5 @@
+---
+'async-call-rpc': minor
+---
+
+expose JSON-RPC interfaces

.changeset/tidy-trains-bathe.md

@@ -0,0 +1,5 @@
+---
+'async-call-rpc': minor
+---
+
+new built-in `JSONEncoder` for the new encode option.

__tests__/DOMException.ts

@@ -4,9 +4,9 @@ import { expect, it } from 'vitest'
 
 it(
     'able to serialize DOMException',
-    withSnapshotDefault('DOMException', async (f) => {
+    withSnapshotDefault('DOMException', async ({ init }) => {
         await reproduceDOMException(false, async () => {
-            const server = f()
+            const server = init()
             const promise: Promise<never> = server.DOMException()
             try {
                 await promise
@@ -22,10 +22,10 @@ it(
 
 it(
     'able to recover from Error constructor with a bad implementation',
-    withSnapshotDefault('recover-error-with-bad-implementation', async (f) => {
+    withSnapshotDefault('recover-error-with-bad-implementation', async ({ init }) => {
         await reproduceError(() =>
             reproduceDOMException(true, async () => {
-                const server = f()
+                const server = init()
                 const promise = server.DOMException()
                 await expect(promise).rejects.toThrowError()
             }),

__tests__/__file_snapshots__/async-call-log-all.md

@@ -28,7 +28,7 @@ Array [
     "",
     Promise {},
     "color: gray; font-style: italic;",
-    [Function replay],
+    [Function anonymous],
 ]
 ```
 
@@ -79,7 +79,7 @@ Array [
     "",
     Promise {},
     "color: gray; font-style: italic;",
-    [Function replay],
+    [Function anonymous],
 ]
 ```
 

__tests__/__file_snapshots__/encode-isomorphic-full-hinted.md

@@ -0,0 +1,90 @@
+# Timeline
+
+## T=0 Log: testRunner/log
+
+```php
+Array [
+    "encodeRequest",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=1 Message: client => server
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "method": "undefined",
+    "params": Array [],
+}
+```
+
+## T=2 Log: testRunner/log
+
+```php
+Array [
+    "decodeRequest",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=3 Log: server/log
+
+```php
+Array [
+    "rpc.%cundefined%c(%c)
+%o %c@0",
+    "color: #d2c057",
+    "",
+    "",
+    Promise {},
+    "color: gray; font-style: italic;",
+]
+```
+
+## T=4 Log: testRunner/log
+
+```php
+Array [
+    "encodeResponse",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```
+
+## T=5 Message: server => client
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "result": undefined,
+}
+```
+
+## T=6 Log: testRunner/log
+
+```php
+Array [
+    "decodeResponse",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```

__tests__/__file_snapshots__/encode-isomorphic-full-not-hinted.md

@@ -0,0 +1,90 @@
+# Timeline
+
+## T=0 Log: testRunner/log
+
+```php
+Array [
+    "encodeRequest",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=1 Message: client => server
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "method": "undefined",
+    "params": Array [],
+}
+```
+
+## T=2 Log: testRunner/log
+
+```php
+Array [
+    "decode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=3 Log: server/log
+
+```php
+Array [
+    "rpc.%cundefined%c(%c)
+%o %c@0",
+    "color: #d2c057",
+    "",
+    "",
+    Promise {},
+    "color: gray; font-style: italic;",
+]
+```
+
+## T=4 Log: testRunner/log
+
+```php
+Array [
+    "encodeResponse",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```
+
+## T=5 Message: server => client
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "result": undefined,
+}
+```
+
+## T=6 Log: testRunner/log
+
+```php
+Array [
+    "decode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```

__tests__/__file_snapshots__/encode-isomorphic-hinted.md

@@ -0,0 +1,90 @@
+# Timeline
+
+## T=0 Log: testRunner/log
+
+```php
+Array [
+    "encode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=1 Message: client => server
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "method": "undefined",
+    "params": Array [],
+}
+```
+
+## T=2 Log: testRunner/log
+
+```php
+Array [
+    "decode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "method": "undefined",
+        "params": Array [],
+    },
+]
+```
+
+## T=3 Log: server/log
+
+```php
+Array [
+    "rpc.%cundefined%c(%c)
+%o %c@0",
+    "color: #d2c057",
+    "",
+    "",
+    Promise {},
+    "color: gray; font-style: italic;",
+]
+```
+
+## T=4 Log: testRunner/log
+
+```php
+Array [
+    "encode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```
+
+## T=5 Message: server => client
+
+```php
+Object {
+    "id": 0,
+    "jsonrpc": "2.0",
+    "result": undefined,
+}
+```
+
+## T=6 Log: testRunner/log
+
+```php
+Array [
+    "decode",
+    Object {
+        "id": 0,
+        "jsonrpc": "2.0",
+        "result": undefined,
+    },
+]
+```