docs: update readme

Author: zxch3n

README.md

@@ -33,23 +33,8 @@ pnpm -r build
 
 2. Start a SimpleServer (Node.js)
 
-Create `examples/simple-server.ts`:
-
-```ts
-import { SimpleServer } from "loro-websocket/server";
-
-const server = new SimpleServer({ port: 8787 });
-server.start().then(() => {
-  // eslint-disable-next-line no-console
-  console.log("SimpleServer listening on ws://localhost:8787");
-});
-```
-
-Run it (Node 18+):
-
 ```bash
-node --loader ts-node/esm examples/simple-server.ts
-# or compile to JS first with your preferred setup
+pnpm dev-simple-server
 ```
 
 3. Connect a client and sync a Loro document

package.json

@@ -11,7 +11,8 @@
     "typecheck": "pnpm -r typecheck",
     "clean": "pnpm -r clean",
     "format": "prettier --write .",
-    "format:check": "prettier --check ."
+    "format:check": "prettier --check .",
+    "dev-simple-server": "pnpm --filter loro-websocket exec tsx src/server/bin.ts"
   },
   "devDependencies": {
     "@rslint/core": "^0.1.11",

packages/loro-adaptors/package.json

@@ -15,8 +15,20 @@
     "loro-protocol": "workspace:*"
   },
   "peerDependencies": {
+    "@loro-dev/flock": "^1.0.0",
     "loro-crdt": "^1.8.5",
-    "@loro-dev/flock": "^1.0.0"
+    "yjs": "*"
+  },
+  "peerDependenciesMeta": {
+    "@loro-dev/flock": {
+      "optional": true
+    },
+    "loro-crdt": {
+      "optional": true
+    },
+    "yjs": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

packages/loro-websocket/src/server/bin.ts

@@ -0,0 +1,21 @@
+import { SimpleServer } from "./simple-server";
+
+const DEFAULT_PORT = 8787;
+const rawPort = process.argv[2];
+const port =
+  rawPort !== undefined ? Number.parseInt(rawPort, 10) : DEFAULT_PORT;
+
+if (!Number.isSafeInteger(port) || port <= 0 || port > 65_535) {
+  const invalidValue = rawPort ?? "";
+  // eslint-disable-next-line no-console
+  console.error(
+    `Invalid port: "${invalidValue}". Provide a number between 1 and 65535.`
+  );
+  process.exit(1);
+}
+
+const server = new SimpleServer({ port });
+server.start().then(() => {
+  // eslint-disable-next-line no-console
+  console.log(`SimpleServer listening on ws://localhost:${port}`);
+});

packages/loro-websocket/src/server/index.test.ts

@@ -1,11 +1 @@
-export class LoroWebsocketServer {
-  started = false;
-
-  start(port: number): string {
-    // Placeholder implementation for basic setup
-    this.started = true;
-    return `listening:${port}`;
-  }
-}
-
 export { SimpleServer, type SimpleServerConfig } from "./simple-server";