next-ws 2.2.18 → 2.2.19

package/README.md

@@ -25,6 +25,7 @@
 - [📦 Installation](#-installation)
 - [🚀 Usage](#-usage)
 - [🌀 Examples](#-examples)
+- [🔒 HTTPS and `wss://`](#-https-and-wss)
 
 ## 📦 Installation
 
@@ -97,3 +98,27 @@ You can now connect to your WebSocket server, send it a message and receive the
 ### Chat Room
 
 See the [chat room example](https://github.com/k0d13/next-ws/tree/main/examples/chat-room).
+
+### WebSocket Proxy
+
+Forward connections to another WebSocket server, using a catch-all route to keep the rest of the path. See the [websocket proxy example](https://github.com/k0d13/next-ws/tree/main/examples/websocket-proxy).
+
+## 🔒 HTTPS and `wss://`
+
+Next WS doesn't handle TLS itself. It listens for upgrade requests on the same HTTP server that Next.js uses, so `wss://` works whenever that server is reachable over HTTPS.
+
+**Reverse proxy (recommended):** terminate TLS in nginx, Caddy or your load balancer and forward to `next start` over plain HTTP. Make sure the proxy forwards the `Upgrade` and `Connection` headers.
+
+**Custom server:** create an HTTPS server with your certificate and hand it to Next WS. See the [custom server example](https://github.com/k0d13/next-ws/tree/main/examples/custom-server) for the full setup.
+
+```ts
+import { readFileSync } from 'node:fs';
+import { createServer } from 'node:https';
+import { setHttpServer } from 'next-ws/server';
+
+const httpsServer = createServer({
+  key: readFileSync('key.pem'),
+  cert: readFileSync('cert.pem'),
+});
+setHttpServer(httpsServer);
+```

package/dist/cli.cjs

@@ -27,7 +27,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var import_minimist = __toESM(require("minimist"));
 
 // package.json
-var version = "2.2.18";
+var version = "2.2.19";
 
 // src/commands/helpers/define.ts
 function defineCommandGroup(definition) {
@@ -80,8 +80,37 @@ Options:
 }
 
 // src/patches/helpers/next.ts
-var import_promises = require("fs/promises");
+var import_promises3 = require("fs/promises");
 var import_node_path = require("path");
+
+// src/patches/helpers/fs.ts
+var import_node_crypto = require("crypto");
+var import_promises = require("fs/promises");
+var import_promises2 = require("timers/promises");
+async function writeFileAtomic(path, data) {
+  const temporary = `${path}.${process.pid}.${(0, import_node_crypto.randomBytes)(4).toString("hex")}.tmp`;
+  try {
+    await (0, import_promises.writeFile)(temporary, data);
+    await renameWithRetry(temporary, path);
+  } catch (error2) {
+    await (0, import_promises.rm)(temporary, { force: true });
+    throw error2;
+  }
+}
+async function renameWithRetry(from, to) {
+  for (let attempt = 1; ; attempt++) {
+    try {
+      return await (0, import_promises.rename)(from, to);
+    } catch (error2) {
+      const code = error2.code;
+      const busy = code === "EPERM" || code === "EACCES" || code === "EBUSY";
+      if (!busy || attempt >= 20) throw error2;
+      await (0, import_promises2.setTimeout)(attempt * 25);
+    }
+  }
+}
+
+// src/patches/helpers/next.ts
 function resolveNextWsDirectory() {
   const id = (
     //
@@ -98,16 +127,16 @@ function resolveNextDirectory() {
 }
 async function getInstalledNextVersion() {
   const id = (0, import_node_path.join)(resolveNextDirectory(), "package.json");
-  const pkg = await (0, import_promises.readFile)(id, "utf8").then(JSON.parse);
+  const pkg = await (0, import_promises3.readFile)(id, "utf8").then(JSON.parse);
   return String(pkg.version.split("-")[0]);
 }
 async function readTrace() {
   const id = (0, import_node_path.join)(resolveNextDirectory(), ".next-ws-trace.json");
-  return (0, import_promises.readFile)(id, "utf-8").then(JSON.parse).catch(() => null);
+  return (0, import_promises3.readFile)(id, "utf-8").then(JSON.parse).catch(() => null);
 }
 async function writeTrace(trace) {
   const id = (0, import_node_path.join)(resolveNextDirectory(), ".next-ws-trace.json");
-  await (0, import_promises.writeFile)(id, JSON.stringify(trace, null, 2));
+  await writeFileAtomic(id, JSON.stringify(trace, null, 2));
 }
 
 // src/patches/patch-1.ts
@@ -115,7 +144,7 @@ var import_node_path3 = require("path");
 var import_jscodeshift = __toESM(require("jscodeshift"));
 
 // src/patches/helpers/define.ts
-var import_promises2 = require("fs/promises");
+var import_promises4 = require("fs/promises");
 var import_node_path2 = require("path");
 
 // src/commands/helpers/console.ts
@@ -697,8 +726,8 @@ function definePatchStep(definition) {
     },
     async execute() {
       debug(`Applying '${this.title}' to '${this.path}'`);
-      const code = await (0, import_promises2.readFile)(this.path, "utf8").then((code2) => this.transform(code2));
-      await (0, import_promises2.writeFile)(this.path, code);
+      const code = await (0, import_promises4.readFile)(this.path, "utf8").then((code2) => this.transform(code2));
+      await writeFileAtomic(this.path, code);
     }
   };
 }
@@ -843,7 +872,7 @@ var patchCookies2 = definePatchStep({
 });
 var patch_2_default = definePatch({
   name: "patch-2",
-  versions: ">=15.0.0 <=16.4.1",
+  versions: ">=15.0.0 <=16.4.2",
   steps: [
     patchNextNodeServer,
     patchRouterServer,

package/dist/client/index.cjs

@@ -43,22 +43,21 @@ var WebSocketContext = (0, import_react.createContext)(null);
 WebSocketContext.displayName = "WebSocketContext";
 var WebSocketConsumer = WebSocketContext.Consumer;
 function WebSocketProvider(p) {
-  const clientRef = (0, import_react.useRef)(null);
+  const [client, setClient] = (0, import_react.useState)(null);
+  const protocols = Array.isArray(p.protocols) ? p.protocols.join(",") : p.protocols;
   (0, import_react.useEffect)(() => {
-    if (typeof window === "undefined") return;
-    if (clientRef.current) {
-      clientRef.current.close();
-      clientRef.current = null;
-    }
-    const client = new WebSocket(p.url, p.protocols);
-    if (p.binaryType) client.binaryType = p.binaryType;
-    clientRef.current = client;
+    const client2 = new WebSocket(
+      p.url,
+      protocols ? protocols.split(",") : void 0
+    );
+    if (p.binaryType) client2.binaryType = p.binaryType;
+    setClient(client2);
     return () => {
-      client.close();
-      clientRef.current = null;
+      client2.close();
+      setClient(null);
     };
-  }, [p.url, p.protocols, p.binaryType]);
-  return /* @__PURE__ */ import_react.default.createElement(WebSocketContext.Provider, { value: clientRef.current }, p.children);
+  }, [p.url, protocols, p.binaryType]);
+  return /* @__PURE__ */ import_react.default.createElement(WebSocketContext.Provider, { value: client }, p.children);
 }
 function useWebSocket() {
   const context = (0, import_react.useContext)(WebSocketContext);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-ws",
-  "version": "2.2.18",
+  "version": "2.2.19",
   "description": "Add support for WebSockets in the Next.js app directory",
   "license": "MIT",
   "keywords": [
@@ -60,7 +60,7 @@
     "chalk": "^5.6.2",
     "husky": "^9.1.7",
     "ioredis": "^5.10.0",
-    "next": "16.4.1",
+    "next": "16.4.2",
     "pinst": "^3.0.0",
     "react": "19.1.1",
     "react-dom": "19.1.1",