live-cursors 0.1.0

package/dist/websocket.mjs

@@ -0,0 +1,75 @@
+//#region src/transports/websocket.ts
+/**
+* Raw WebSocket transport. Cursor updates are disposable, so nothing is buffered
+* while the socket is down — the next pointer move takes over.
+*/
+function websocketTransport(options) {
+	const { url, room, protocols, reconnect = true, reconnectDelayMs = 500, maxDelayMs = 1e4, onError } = options;
+	const handlers = /* @__PURE__ */ new Set();
+	let socket = null;
+	let delay = reconnectDelayMs;
+	let retryTimer = null;
+	let closed = false;
+	function scheduleRetry() {
+		if (!reconnect || closed || retryTimer) return;
+		retryTimer = setTimeout(() => {
+			retryTimer = null;
+			delay = Math.min(delay * 2, maxDelayMs);
+			connect();
+		}, delay);
+	}
+	function connect() {
+		if (closed) return;
+		try {
+			const target = typeof url === "function" ? url() : url;
+			socket = protocols === void 0 ? new WebSocket(target) : new WebSocket(target, protocols);
+		} catch (error) {
+			onError?.(error);
+			scheduleRetry();
+			return;
+		}
+		socket.addEventListener("open", () => {
+			delay = reconnectDelayMs;
+		});
+		socket.addEventListener("message", (event) => {
+			let data = event.data;
+			if (typeof data === "string") try {
+				data = JSON.parse(data);
+			} catch {
+				return;
+			}
+			const senderId = typeof data === "object" && data !== null && typeof data.from === "string" ? data.from : void 0;
+			for (const handler of handlers) handler(data, senderId);
+		});
+		socket.addEventListener("close", () => {
+			socket = null;
+			scheduleRetry();
+		});
+		socket.addEventListener("error", (event) => {
+			onError?.(event);
+		});
+	}
+	connect();
+	return {
+		send(message) {
+			if (socket?.readyState !== WebSocket.OPEN) return;
+			socket.send(JSON.stringify(room === void 0 ? message : {
+				...message,
+				room
+			}));
+		},
+		onMessage(handler) {
+			handlers.add(handler);
+			return () => handlers.delete(handler);
+		},
+		close() {
+			closed = true;
+			if (retryTimer) clearTimeout(retryTimer);
+			handlers.clear();
+			socket?.close();
+			socket = null;
+		}
+	};
+}
+//#endregion
+export { websocketTransport };

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "live-cursors",
+  "type": "module",
+  "version": "0.1.0",
+  "packageManager": "pnpm@10.33.0",
+  "description": "Multiplayer cursors for any transport. Zero dependencies, no SaaS. Works over Laravel Echo, raw WebSocket, BroadcastChannel or your own channel.",
+  "license": "MIT",
+  "homepage": "https://github.com/qretro/live-cursors#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/qretro/live-cursors.git"
+  },
+  "bugs": "https://github.com/qretro/live-cursors/issues",
+  "keywords": [
+    "live-cursors",
+    "multiplayer",
+    "cursors",
+    "presence",
+    "collaborative",
+    "realtime",
+    "websocket",
+    "laravel-echo",
+    "vue",
+    "react"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./dom": "./dist/dom.mjs",
+    "./vue": "./dist/vue.mjs",
+    "./react": "./dist/react.mjs",
+    "./broadcast": "./dist/broadcast.mjs",
+    "./websocket": "./dist/websocket.mjs",
+    "./echo": "./dist/echo.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "check:pkg": "pnpm build && publint && attw --pack . --profile esm-only",
+    "play": "pnpm -F playground dev",
+    "demo:gif": "node scripts/record-demo.mjs",
+    "release": "pnpm test && pnpm check:pkg && bumpp",
+    "prepack": "pnpm build"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "vue": ">=3.4"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@antfu/eslint-config": "catalog:",
+    "@arethetypeswrong/cli": "catalog:",
+    "@eslint-react/eslint-plugin": "catalog:",
+    "@playwright/test": "catalog:",
+    "@types/node": "catalog:",
+    "@types/react": "catalog:",
+    "@types/ws": "catalog:",
+    "bumpp": "catalog:",
+    "eslint": "catalog:",
+    "eslint-plugin-react-hooks": "catalog:",
+    "eslint-plugin-react-refresh": "catalog:",
+    "happy-dom": "catalog:",
+    "publint": "catalog:",
+    "react": "catalog:",
+    "tsdown": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "vue": "catalog:",
+    "ws": "catalog:"
+  }
+}