@playfast/reform-remote-node 1.1.0 → 1.1.2

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import type { Server } from 'node:http';
+import { WebSocketServer } from 'ws';
+import type { AnyScene } from '@playfast/reform/internal';
+export interface NodeWebSocketOptionsExternalApi {
+    readonly scene: AnyScene;
+    readonly port?: number;
+    readonly server?: Server;
+    readonly path?: string;
+}
+export interface NodeWebSocketServer {
+    readonly wss: WebSocketServer;
+    readonly stop: () => Promise<void>;
+}
+export declare const serveNodeWebSocket: (options: NodeWebSocketOptionsExternalApi) => NodeWebSocketServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAEvC,OAAO,EAAgB,eAAe,EAAE,MAAM,IAAI,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAQzD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAoDD,eAAO,MAAM,kBAAkB,GAC7B,SAAS,+BAA+B,KACvC,mBA4CF,CAAA"}

package/dist/index.js

@@ -0,0 +1,78 @@
+import { Option, Schema } from 'effect';
+import { WebSocketServer } from 'ws';
+import { serveShared, } from '@playfast/reform-remote';
+const WirePropSchema = Schema.Union(Schema.Struct({
+    _tag: Schema.Literal('Data'),
+    name: Schema.String,
+    value: Schema.Unknown,
+}), Schema.Struct({
+    _tag: Schema.Literal('Event'),
+    name: Schema.String,
+    handle: Schema.String,
+}));
+const WireNodeSchema = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    parentId: Schema.NullOr(Schema.String),
+    childIndex: Schema.Number,
+    slot: Schema.NullOr(Schema.String),
+    key: Schema.NullOr(Schema.String),
+    props: Schema.Array(WirePropSchema),
+});
+const WirePatchSchema = Schema.Union(Schema.Struct({ _tag: Schema.Literal('Upsert'), node: WireNodeSchema }), Schema.Struct({ _tag: Schema.Literal('Delete'), id: Schema.String }));
+const InvokeMessageJson = Schema.parseJson(Schema.Struct({
+    _tag: Schema.Literal('Invoke'),
+    handle: Schema.String,
+    payload: Schema.Unknown,
+}));
+const ServerMessageJson = Schema.parseJson(Schema.Union(Schema.Struct({
+    _tag: Schema.Literal('Snapshot'),
+    tree: Schema.Array(WireNodeSchema),
+}), Schema.Struct({
+    _tag: Schema.Literal('Patches'),
+    patches: Schema.Array(WirePatchSchema),
+})));
+const decodeInvokeMessage = Schema.decodeUnknownSync(InvokeMessageJson);
+const encodeServerMessage = Schema.encodeSync(ServerMessageJson);
+const parseInvoke = (frame) => decodeInvokeMessage(frame.toString());
+export const serveNodeWebSocket = (options) => {
+    const serverConfig = options.server !== undefined
+        ? { server: options.server, path: options.path }
+        : { port: options.port === undefined ? 0 : options.port, path: options.path };
+    const wss = new WebSocketServer(serverConfig);
+    const shared = serveShared({ scene: options.scene });
+    wss.on('connection', (socket) => {
+        const handlers = new Set();
+        const transport = {
+            send: (message) => void socket.send(encodeServerMessage(message)),
+            onMessage: (handler) => {
+                handlers.add(handler);
+                return () => void handlers.delete(handler);
+            },
+        };
+        socket.on('message', (frame) => {
+            const message = parseInvoke(frame);
+            handlers.forEach((handler) => handler(message));
+        });
+        const handle = shared.addClient(transport);
+        socket.on('close', () => handle.remove());
+    });
+    return {
+        wss,
+        stop: async () => {
+            await shared.dispose();
+            // `wss.close` waits for live sockets to drain.
+            wss.clients.forEach((client) => client.terminate());
+            await new Promise((resolve, reject) => {
+                wss.close((error) => (error === undefined ? resolve() : reject(error)));
+                // Bun's `ws` frees the port but never invokes that callback nor emits 'close',
+                // which would hang teardown forever. Both runtimes drop `address()` the moment
+                // the listener is gone, so that fact — not the signal — is what we settle on.
+                if (Option.isNone(Option.fromNullable(wss.address()))) {
+                    resolve();
+                }
+            });
+        },
+    };
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playfast/reform-remote-node",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Node WebSocket server adapter for reform-remote — serves a reform scene's UI over the `ws` package, one isolated runtime per connection.",
   "keywords": [
     "effect",
@@ -20,15 +20,26 @@
     "directory": "packages/reform-remote-node"
   },
   "files": [
+    "dist",
     "src",
     "README.md"
   ],
   "type": "module",
   "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
-    ".": "./src/index.ts",
-    "./*": "./src/*.ts"
+    ".": {
+      "playfast-src": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "playfast-src": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
   },
   "publishConfig": {
     "access": "public"
@@ -36,12 +47,13 @@
   "scripts": {
     "clean": "rm -rf dist .tsbuildinfo",
     "check": "tsc --noEmit",
-    "build": "tsc -p tsconfig.build.json",
+    "build": "rm -rf dist .tsbuildinfo && tsc -p tsconfig.build.json && bun ../../scripts/fix-esm-extensions.ts dist",
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "lint": "oxlint src",
-    "lint:fix": "oxlint --fix src"
+    "lint:fix": "oxlint --fix src",
+    "prepack": "bun run build"
   },
   "dependencies": {
     "ws": "^8.18.0"

package/src/index.ts

@@ -1,5 +1,5 @@
 import type { Server } from 'node:http'
-import { Schema } from 'effect'
+import { Option, Schema } from 'effect'
 import { type RawData, WebSocketServer } from 'ws'
 import type { AnyScene } from '@playfast/reform/internal'
 import {
@@ -106,9 +106,15 @@ export const serveNodeWebSocket = (
       await shared.dispose()
       // `wss.close` waits for live sockets to drain.
       wss.clients.forEach((client) => client.terminate())
-      await new Promise<void>((resolve, reject) =>
-        wss.close((error) => (error === undefined ? resolve() : reject(error))),
-      )
+      await new Promise<void>((resolve, reject) => {
+        wss.close((error) => (error === undefined ? resolve() : reject(error)))
+        // Bun's `ws` frees the port but never invokes that callback nor emits 'close',
+        // which would hang teardown forever. Both runtimes drop `address()` the moment
+        // the listener is gone, so that fact — not the signal — is what we settle on.
+        if (Option.isNone(Option.fromNullable(wss.address()))) {
+          resolve()
+        }
+      })
     },
   }
 }