Merge pull request #21 from jsonjoy-com/devex

Devex

src/__tests__/e2e/clients.ts

@@ -1,8 +1,8 @@
-import WebSocket from 'ws';
-import type {RpcCodec} from '../../common/codec/RpcCodec';
-import {RpcPersistentClient, WebSocketChannel} from '../../common';
 import {FetchRpcClient} from '../../common/rpc/client/FetchRpcClient';
 import {StreamingRpcClient} from '../../common';
+import WebSocket from 'ws';
+import {RpcPersistentClient, WebSocketChannel} from '../../common';
+import type {RpcCodec} from '../../common/codec/RpcCodec';
 
 export const setupRpcPersistentClient = (codec: RpcCodec) => {
   const port = +(process.env.PORT || 9999);

src/__tests__/e2e/demo-client.ts

@@ -4,8 +4,7 @@ import {RpcPersistentClient, StreamingRpcClient, WebSocketChannel} from '../../c
 import {FetchRpcClient} from '../../common/rpc/client/FetchRpcClient';
 
 const secure = true;
-const host = 'demo-iasd8921ondk0.jsonjoy.com';
-// const host = '127.0.0.1:8080';
+const host = 'api.jsonjoy.org';
 
 export const setupDemoServerPersistentClient = (codec: RpcCodec) => {
   const url = `ws${secure ? 's' : ''}://${host}/rx`;

src/browser/createBinaryClient.ts

@@ -0,0 +1,24 @@
+import {CborJsonValueCodec} from '@jsonjoy.com/json-pack/lib/codecs/cbor';
+import {Writer} from '@jsonjoy.com/util/lib/buffers/Writer';
+import {RpcCodec} from '../common/codec/RpcCodec';
+import {BinaryRpcMessageCodec} from '../common/codec/binary';
+import {createClient} from './createClient';
+
+/**
+ * Constructs a JSON Reactive RPC client.
+ *
+ * ```typescript
+ * const client = createBinaryClient('wss://api.host.com', 'token');
+ * ```
+ *
+ * @param url RPC endpoint.
+ * @param token Authentication token.
+ * @returns An RPC client.
+ */
+export const createBinaryClient = (url: string, token?: string) => {
+  const writer = new Writer(1024 * 4);
+  const msg = new BinaryRpcMessageCodec();
+  const req = new CborJsonValueCodec(writer);
+  const codec = new RpcCodec(msg, req, req);
+  return createClient(codec, url, token);
+};

src/browser/createClient.ts

@@ -0,0 +1,31 @@
+import {RpcPersistentClient} from '../common/rpc/RpcPersistentClient';
+import {WebSocketChannel} from '../common/channel/channel';
+import type {RpcCodec} from '../common/codec/RpcCodec';
+
+/**
+ * Constructs a {@link RpcPersistentClient} with the given codec.
+ *
+ * ```typescript
+ * const client = createRpcPersistentClient(codec, 'wss://api.host.com', 'token');
+ * ```
+ *
+ * @param codec RPC codec.
+ * @param url RPC endpoint.
+ * @param token Authentication token.
+ * @returns An RPC client.
+ */
+export const createClient = (codec: RpcCodec, url: string, token?: string) => {
+  const protocols: string[] = [codec.specifier()];
+  if (token) protocols.push(token);
+  const client = new RpcPersistentClient({
+    codec,
+    channel: {
+      newChannel: () =>
+        new WebSocketChannel({
+          newSocket: () => new WebSocket(url, protocols),
+        }),
+    },
+  });
+  client.start();
+  return client;
+};

src/browser/createJsonWsRpcClient.ts → src/browser/createJsonClient.ts

@@ -1,29 +1,20 @@
 import {JsonJsonValueCodec} from '@jsonjoy.com/json-pack/lib/codecs/json';
 import {Writer} from '@jsonjoy.com/util/lib/buffers/Writer';
-import {RpcPersistentClient, WebSocketChannel} from '../common';
 import {RpcCodec} from '../common/codec/RpcCodec';
 import {CompactRpcMessageCodec} from '../common/codec/compact';
+import {createClient} from './createClient';
 
 /**
  * Constructs a JSON Reactive RPC client.
+ *
  * @param url RPC endpoint.
  * @param token Authentication token.
  * @returns An RPC client.
  */
-export const createJsonWsRpcClient = (url: string, token: string) => {
+export const createJsonClient = (url: string, token?: string) => {
   const writer = new Writer(1024 * 4);
   const msg = new CompactRpcMessageCodec();
   const req = new JsonJsonValueCodec(writer);
   const codec = new RpcCodec(msg, req, req);
-  const client = new RpcPersistentClient({
-    codec,
-    channel: {
-      newChannel: () =>
-        new WebSocketChannel({
-          newSocket: () => new WebSocket(url, [codec.specifier(), token]),
-        }),
-    },
-  });
-  client.start();
-  return client;
+  return createClient(codec, url, token);
 };

src/browser/index.ts

@@ -0,0 +1,2 @@
+export {createClient} from './createClient';
+export {createBinaryClient} from './createBinaryClient';

src/server/http1/index.ts

@@ -0,0 +1,5 @@
+export type * from './types';
+export * from './context';
+export * from './Http1Server';
+export * from './RpcServer';
+export * from './util';

src/server/index.ts

@@ -1 +1,4 @@
-export * from './uws';
+export * from './context';
+export * from './errors';
+export * from './ws';
+export * from './http1';

src/server/ws/index.ts

@@ -0,0 +1,2 @@
+export * from './codec';
+export {WsServerConnection, WsServerConnectionSocket} from './server/WsServerConnection';