@voidhash/mimic-effect 0.0.2 → 0.0.3

package/dist/PresenceManager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceManager.mjs","names":["docPresence: DocumentPresence","presences: Record<string, PresenceEntry>","layer: Layer.Layer<PresenceManagerTag>","layerDefault: Layer.Layer<PresenceManagerTag>"],"sources":["../src/PresenceManager.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Presence manager for ephemeral per-connection state.\n * Handles in-memory storage and broadcasting of presence updates.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as PubSub from \"effect/PubSub\";\nimport * as Ref from \"effect/Ref\";\nimport * as HashMap from \"effect/HashMap\";\nimport * as Context from \"effect/Context\";\nimport * as Scope from \"effect/Scope\";\nimport * as Stream from \"effect/Stream\";\nimport type { Presence } from \"@voidhash/mimic\";\n\n// =============================================================================\n// Presence Entry Types\n// =============================================================================\n\n/**\n * A presence entry stored in the manager.\n */\nexport interface PresenceEntry {\n  /** The presence data */\n  readonly data: unknown;\n  /** Optional user ID from authentication */\n  readonly userId?: string;\n}\n\n// =============================================================================\n// Presence Events\n// =============================================================================\n\n/**\n * Event emitted when a presence is updated.\n */\nexport interface PresenceUpdateEvent {\n  readonly type: \"presence_update\";\n  /** The connection ID of the user who updated */\n  readonly id: string;\n  /** The presence data */\n  readonly data: unknown;\n  /** Optional user ID from authentication */\n  readonly userId?: string;\n}\n\n/**\n * Event emitted when a presence is removed (user disconnected).\n */\nexport interface PresenceRemoveEvent {\n  readonly type: \"presence_remove\";\n  /** The connection ID of the user who disconnected */\n  readonly id: string;\n}\n\n/**\n * Union of all presence events.\n */\nexport type PresenceEvent = PresenceUpdateEvent | PresenceRemoveEvent;\n\n// =============================================================================\n// Presence Snapshot\n// =============================================================================\n\n/**\n * A snapshot of all presence entries for a document.\n */\nexport interface PresenceSnapshot {\n  /** Map of connectionId to presence entry */\n  readonly presences: Record<string, PresenceEntry>;\n}\n\n// =============================================================================\n// Document Presence Instance\n// =============================================================================\n\n/**\n * Per-document presence state.\n */\ninterface DocumentPresence {\n  /** Map of connectionId to presence entry */\n  readonly entries: Ref.Ref<HashMap.HashMap<string, PresenceEntry>>;\n  /** PubSub for broadcasting presence events */\n  readonly pubsub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Presence Manager Service\n// =============================================================================\n\n/**\n * Service interface for the PresenceManager.\n */\nexport interface PresenceManager {\n  /**\n   * Get a snapshot of all presences for a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot>;\n\n  /**\n   * Set/update presence for a connection.\n   * Broadcasts the update to all subscribers.\n   */\n  readonly set: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void>;\n\n  /**\n   * Remove presence for a connection (e.g., on disconnect).\n   * Broadcasts the removal to all subscribers.\n   */\n  readonly remove: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Returns a Stream of presence events.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<\n    Stream.Stream<PresenceEvent>,\n    never,\n    Scope.Scope\n  >;\n}\n\n/**\n * Context tag for PresenceManager.\n */\nexport class PresenceManagerTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/PresenceManager\"\n)<PresenceManagerTag, PresenceManager>() {}\n\n// =============================================================================\n// Presence Manager Implementation\n// =============================================================================\n\n/**\n * Create the PresenceManager service.\n */\nconst makePresenceManager = Effect.gen(function* () {\n  // Map of document ID to document presence state\n  const documents = yield* Ref.make(\n    HashMap.empty<string, DocumentPresence>()\n  );\n\n  // Get or create a document presence instance\n  const getOrCreateDocument = (\n    documentId: string\n  ): Effect.Effect<DocumentPresence> =>\n    Effect.gen(function* () {\n      const current = yield* Ref.get(documents);\n      const existing = HashMap.get(current, documentId);\n\n      if (existing._tag === \"Some\") {\n        return existing.value;\n      }\n\n      // Create new document presence\n      const entries = yield* Ref.make(\n        HashMap.empty<string, PresenceEntry>()\n      );\n      const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n\n      const docPresence: DocumentPresence = {\n        entries,\n        pubsub,\n      };\n\n      // Store in map\n      yield* Ref.update(documents, (map) =>\n        HashMap.set(map, documentId, docPresence)\n      );\n\n      return docPresence;\n    });\n\n  // Get snapshot of all presences for a document\n  const getSnapshot = (documentId: string): Effect.Effect<PresenceSnapshot> =>\n    Effect.gen(function* () {\n      const docPresence = yield* getOrCreateDocument(documentId);\n      const entriesMap = yield* Ref.get(docPresence.entries);\n\n      // Convert HashMap to Record\n      const presences: Record<string, PresenceEntry> = {};\n      for (const [id, entry] of entriesMap) {\n        presences[id] = entry;\n      }\n\n      return { presences };\n    });\n\n  // Set/update presence for a connection\n  const set = (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ): Effect.Effect<void> =>\n    Effect.gen(function* () {\n      const docPresence = yield* getOrCreateDocument(documentId);\n\n      // Update the entry\n      yield* Ref.update(docPresence.entries, (map) =>\n        HashMap.set(map, connectionId, entry)\n      );\n\n      // Broadcast the update\n      yield* PubSub.publish(docPresence.pubsub, {\n        type: \"presence_update\",\n        id: connectionId,\n        data: entry.data,\n        userId: entry.userId,\n      });\n    });\n\n  // Remove presence for a connection\n  const remove = (\n    documentId: string,\n    connectionId: string\n  ): Effect.Effect<void> =>\n    Effect.gen(function* () {\n      const current = yield* Ref.get(documents);\n      const existing = HashMap.get(current, documentId);\n\n      if (existing._tag === \"None\") {\n        return; // Document doesn't exist, nothing to remove\n      }\n\n      const docPresence = existing.value;\n\n      // Check if the connection has a presence\n      const entries = yield* Ref.get(docPresence.entries);\n      const hasEntry = HashMap.has(entries, connectionId);\n\n      if (!hasEntry) {\n        return; // No presence to remove\n      }\n\n      // Remove the entry\n      yield* Ref.update(docPresence.entries, (map) =>\n        HashMap.remove(map, connectionId)\n      );\n\n      // Broadcast the removal\n      yield* PubSub.publish(docPresence.pubsub, {\n        type: \"presence_remove\",\n        id: connectionId,\n      });\n    });\n\n  // Subscribe to presence events\n  const subscribe = (\n    documentId: string\n  ): Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope> =>\n    Effect.gen(function* () {\n      const docPresence = yield* getOrCreateDocument(documentId);\n\n      // Subscribe to the PubSub\n      const queue = yield* PubSub.subscribe(docPresence.pubsub);\n\n      // Convert queue to stream\n      return Stream.fromQueue(queue);\n    });\n\n  const manager: PresenceManager = {\n    getSnapshot,\n    set,\n    remove,\n    subscribe,\n  };\n\n  return manager;\n});\n\n/**\n * Layer that provides PresenceManager.\n */\nexport const layer: Layer.Layer<PresenceManagerTag> = Layer.effect(\n  PresenceManagerTag,\n  makePresenceManager\n);\n\n/**\n * Default layer that provides PresenceManager.\n * Uses the default priority for layer composition.\n */\nexport const layerDefault: Layer.Layer<PresenceManagerTag> = Layer.effectDiscard(\n  Effect.succeed(undefined)\n).pipe(Layer.provideMerge(layer));\n\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAwIA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,gDACD,EAAuC,CAAC;;;;AASzC,MAAM,sBAAsB,OAAO,IAAI,aAAa;CAElD,MAAM,YAAY,OAAO,IAAI,KAC3B,QAAQ,OAAiC,CAC1C;CAGD,MAAM,uBACJ,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,IAAI,UAAU;EACzC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AAEjD,MAAI,SAAS,SAAS,OACpB,QAAO,SAAS;EASlB,MAAMA,cAAgC;GACpC,SANc,OAAO,IAAI,KACzB,QAAQ,OAA8B,CACvC;GAKC,QAJa,OAAO,OAAO,WAA0B;GAKtD;AAGD,SAAO,IAAI,OAAO,YAAY,QAC5B,QAAQ,IAAI,KAAK,YAAY,YAAY,CAC1C;AAED,SAAO;GACP;CAGJ,MAAM,eAAe,eACnB,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,oBAAoB,WAAW;EAC1D,MAAM,aAAa,OAAO,IAAI,IAAI,YAAY,QAAQ;EAGtD,MAAMC,YAA2C,EAAE;AACnD,OAAK,MAAM,CAAC,IAAI,UAAU,WACxB,WAAU,MAAM;AAGlB,SAAO,EAAE,WAAW;GACpB;CAGJ,MAAM,OACJ,YACA,cACA,UAEA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,oBAAoB,WAAW;AAG1D,SAAO,IAAI,OAAO,YAAY,UAAU,QACtC,QAAQ,IAAI,KAAK,cAAc,MAAM,CACtC;AAGD,SAAO,OAAO,QAAQ,YAAY,QAAQ;GACxC,MAAM;GACN,IAAI;GACJ,MAAM,MAAM;GACZ,QAAQ,MAAM;GACf,CAAC;GACF;CAGJ,MAAM,UACJ,YACA,iBAEA,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,IAAI,UAAU;EACzC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AAEjD,MAAI,SAAS,SAAS,OACpB;EAGF,MAAM,cAAc,SAAS;EAG7B,MAAM,UAAU,OAAO,IAAI,IAAI,YAAY,QAAQ;AAGnD,MAAI,CAFa,QAAQ,IAAI,SAAS,aAAa,CAGjD;AAIF,SAAO,IAAI,OAAO,YAAY,UAAU,QACtC,QAAQ,OAAO,KAAK,aAAa,CAClC;AAGD,SAAO,OAAO,QAAQ,YAAY,QAAQ;GACxC,MAAM;GACN,IAAI;GACL,CAAC;GACF;CAGJ,MAAM,aACJ,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO,oBAAoB,WAAW;EAG1D,MAAM,QAAQ,OAAO,OAAO,UAAU,YAAY,OAAO;AAGzD,SAAO,OAAO,UAAU,MAAM;GAC9B;AASJ,QAPiC;EAC/B;EACA;EACA;EACA;EACD;EAGD;;;;AAKF,MAAaC,QAAyC,MAAM,OAC1D,oBACA,oBACD;;;;;AAMD,MAAaC,eAAgD,MAAM,cACjE,OAAO,QAAQ,OAAU,CAC1B,CAAC,KAAK,MAAM,aAAa,MAAM,CAAC"}

package/dist/WebSocketHandler.cjs

@@ -0,0 +1,366 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_MimicConfig = require('./MimicConfig.cjs');
+const require_DocumentManager = require('./DocumentManager.cjs');
+const require_MimicAuthService = require('./MimicAuthService.cjs');
+const require_PresenceManager = require('./PresenceManager.cjs');
+const require_errors = require('./errors.cjs');
+const require_objectSpread2 = require('./_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.cjs');
+let effect_Effect = require("effect/Effect");
+effect_Effect = require_rolldown_runtime.__toESM(effect_Effect);
+let effect_Stream = require("effect/Stream");
+effect_Stream = require_rolldown_runtime.__toESM(effect_Stream);
+let effect_Duration = require("effect/Duration");
+effect_Duration = require_rolldown_runtime.__toESM(effect_Duration);
+let effect_Fiber = require("effect/Fiber");
+effect_Fiber = require_rolldown_runtime.__toESM(effect_Fiber);
+let _voidhash_mimic = require("@voidhash/mimic");
+
+//#region src/WebSocketHandler.ts
+/**
+* @since 0.0.1
+* WebSocket connection handler using Effect Platform Socket API.
+*/
+var WebSocketHandler_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	extractDocumentId: () => extractDocumentId,
+	handleConnection: () => handleConnection,
+	makeHandler: () => makeHandler
+});
+/**
+* Extract document ID from URL path.
+* Expected format: /doc/{documentId}
+*/
+const extractDocumentId = (path) => {
+	const parts = path.replace(/^\/+/, "").split("/");
+	const docIndex = parts.lastIndexOf("doc");
+	const part = parts[docIndex + 1];
+	if (docIndex !== -1 && part) return effect_Effect.succeed(decodeURIComponent(part));
+	return effect_Effect.fail(new require_errors.MissingDocumentIdError({}));
+};
+/**
+* Decodes an encoded client message from the wire format.
+*/
+const decodeClientMessage = (encoded) => {
+	if (encoded.type === "submit") return {
+		type: "submit",
+		transaction: _voidhash_mimic.Transaction.decode(encoded.transaction)
+	};
+	return encoded;
+};
+/**
+* Encodes a server message for the wire format.
+*/
+const encodeServerMessageForWire = (message) => {
+	if (message.type === "transaction") return {
+		type: "transaction",
+		transaction: _voidhash_mimic.Transaction.encode(message.transaction),
+		version: message.version
+	};
+	return message;
+};
+const parseClientMessage = (data) => effect_Effect.try({
+	try: () => {
+		const text = typeof data === "string" ? data : new TextDecoder().decode(data);
+		return decodeClientMessage(JSON.parse(text));
+	},
+	catch: (cause) => new require_errors.MessageParseError({ cause })
+});
+const encodeServerMessage = (message) => JSON.stringify(encodeServerMessageForWire(message));
+/**
+* Handle a WebSocket connection for a document.
+*
+* @param socket - The Effect Platform Socket
+* @param path - The URL path (e.g., "/doc/my-document-id")
+* @returns An Effect that handles the connection lifecycle
+*/
+const handleConnection = (socket, path) => effect_Effect.gen(function* () {
+	const config = yield* require_MimicConfig.MimicServerConfigTag;
+	const authService = yield* require_MimicAuthService.MimicAuthServiceTag;
+	const documentManager = yield* require_DocumentManager.DocumentManagerTag;
+	const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+	const documentId = yield* extractDocumentId(path);
+	const connectionId = crypto.randomUUID();
+	let state = {
+		documentId,
+		connectionId,
+		authenticated: false
+	};
+	let hasPresence = false;
+	const write = yield* socket.writer;
+	const sendMessage = (message) => write(encodeServerMessage(message));
+	const sendPresenceSnapshot = effect_Effect.gen(function* () {
+		if (!config.presence) return;
+		yield* sendMessage({
+			type: "presence_snapshot",
+			selfId: connectionId,
+			presences: (yield* presenceManager.getSnapshot(documentId)).presences
+		});
+	});
+	const handleAuth = (token) => effect_Effect.gen(function* () {
+		const result = yield* authService.authenticate(token);
+		if (result.success) {
+			state = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, state), {}, {
+				authenticated: true,
+				userId: result.userId
+			});
+			yield* sendMessage({
+				type: "auth_result",
+				success: true
+			});
+			yield* sendPresenceSnapshot;
+		} else yield* sendMessage({
+			type: "auth_result",
+			success: false,
+			error: result.error
+		});
+	});
+	const handlePresenceSet = (data) => effect_Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!config.presence) return;
+		const validated = _voidhash_mimic.Presence.validateSafe(config.presence, data);
+		if (validated === void 0) {
+			yield* effect_Effect.logWarning("Invalid presence data received", {
+				connectionId,
+				data
+			});
+			return;
+		}
+		yield* presenceManager.set(documentId, connectionId, {
+			data: validated,
+			userId: state.userId
+		});
+		hasPresence = true;
+	});
+	const handlePresenceClear = effect_Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!config.presence) return;
+		yield* presenceManager.remove(documentId, connectionId);
+		hasPresence = false;
+	});
+	const handleMessage = (message) => effect_Effect.gen(function* () {
+		switch (message.type) {
+			case "auth":
+				yield* handleAuth(message.token);
+				break;
+			case "ping":
+				yield* sendMessage({ type: "pong" });
+				break;
+			case "submit":
+				if (!state.authenticated) {
+					yield* sendMessage({
+						type: "error",
+						transactionId: message.transaction.id,
+						reason: "Not authenticated"
+					});
+					return;
+				}
+				const submitResult = yield* documentManager.submit(documentId, message.transaction);
+				if (!submitResult.success) yield* sendMessage({
+					type: "error",
+					transactionId: message.transaction.id,
+					reason: submitResult.reason
+				});
+				break;
+			case "request_snapshot":
+				if (!state.authenticated) return;
+				yield* sendMessage(yield* effect_Effect.catchAll(documentManager.getSnapshot(documentId), () => effect_Effect.succeed({
+					type: "snapshot",
+					state: null,
+					version: 0
+				})));
+				break;
+			case "presence_set":
+				yield* handlePresenceSet(message.data);
+				break;
+			case "presence_clear":
+				yield* handlePresenceClear;
+				break;
+		}
+	});
+	const subscribeFiber = yield* effect_Effect.fork(effect_Effect.gen(function* () {
+		while (!state.authenticated) yield* effect_Effect.sleep(effect_Duration.millis(100));
+		const broadcastStream = yield* effect_Effect.catchAll(documentManager.subscribe(documentId), () => effect_Effect.succeed(effect_Stream.empty));
+		yield* effect_Stream.runForEach(broadcastStream, (broadcast) => sendMessage(broadcast));
+	}).pipe(effect_Effect.scoped));
+	const presenceFiber = yield* effect_Effect.fork(effect_Effect.gen(function* () {
+		if (!config.presence) return;
+		while (!state.authenticated) yield* effect_Effect.sleep(effect_Duration.millis(100));
+		const presenceStream = yield* presenceManager.subscribe(documentId);
+		yield* effect_Stream.runForEach(presenceStream, (event) => effect_Effect.gen(function* () {
+			if (event.id === connectionId) return;
+			if (event.type === "presence_update") yield* sendMessage({
+				type: "presence_update",
+				id: event.id,
+				data: event.data,
+				userId: event.userId
+			});
+			else if (event.type === "presence_remove") yield* sendMessage({
+				type: "presence_remove",
+				id: event.id
+			});
+		}));
+	}).pipe(effect_Effect.scoped));
+	yield* effect_Effect.addFinalizer(() => effect_Effect.gen(function* () {
+		yield* effect_Fiber.interrupt(subscribeFiber);
+		yield* effect_Fiber.interrupt(presenceFiber);
+		if (hasPresence && config.presence) yield* presenceManager.remove(documentId, connectionId);
+	}));
+	yield* socket.runRaw((data) => effect_Effect.gen(function* () {
+		yield* handleMessage(yield* parseClientMessage(data));
+	}).pipe(effect_Effect.catchAll((error) => effect_Effect.logError("Message handling error", error))));
+});
+/**
+* Create a handler function for the WebSocket server.
+* Returns a function that takes a socket and document ID.
+*/
+const makeHandler = effect_Effect.gen(function* () {
+	const config = yield* require_MimicConfig.MimicServerConfigTag;
+	const authService = yield* require_MimicAuthService.MimicAuthServiceTag;
+	const documentManager = yield* require_DocumentManager.DocumentManagerTag;
+	const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+	return (socket, documentId) => handleConnectionWithDocumentId(socket, documentId).pipe(effect_Effect.provideService(require_MimicConfig.MimicServerConfigTag, config), effect_Effect.provideService(require_MimicAuthService.MimicAuthServiceTag, authService), effect_Effect.provideService(require_DocumentManager.DocumentManagerTag, documentManager), effect_Effect.provideService(require_PresenceManager.PresenceManagerTag, presenceManager), effect_Effect.scoped);
+});
+/**
+* Handle a WebSocket connection for a document (using document ID directly).
+*/
+const handleConnectionWithDocumentId = (socket, documentId) => effect_Effect.gen(function* () {
+	const config = yield* require_MimicConfig.MimicServerConfigTag;
+	const authService = yield* require_MimicAuthService.MimicAuthServiceTag;
+	const documentManager = yield* require_DocumentManager.DocumentManagerTag;
+	const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+	const connectionId = crypto.randomUUID();
+	let state = {
+		documentId,
+		connectionId,
+		authenticated: false
+	};
+	let hasPresence = false;
+	const write = yield* socket.writer;
+	const sendMessage = (message) => write(encodeServerMessage(message));
+	const sendPresenceSnapshot = effect_Effect.gen(function* () {
+		if (!config.presence) return;
+		yield* sendMessage({
+			type: "presence_snapshot",
+			selfId: connectionId,
+			presences: (yield* presenceManager.getSnapshot(documentId)).presences
+		});
+	});
+	const handleAuth = (token) => effect_Effect.gen(function* () {
+		const result = yield* authService.authenticate(token);
+		if (result.success) {
+			state = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, state), {}, {
+				authenticated: true,
+				userId: result.userId
+			});
+			yield* sendMessage({
+				type: "auth_result",
+				success: true
+			});
+			yield* sendPresenceSnapshot;
+		} else yield* sendMessage({
+			type: "auth_result",
+			success: false,
+			error: result.error
+		});
+	});
+	const handlePresenceSet = (data) => effect_Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!config.presence) return;
+		const validated = _voidhash_mimic.Presence.validateSafe(config.presence, data);
+		if (validated === void 0) {
+			yield* effect_Effect.logWarning("Invalid presence data received", {
+				connectionId,
+				data
+			});
+			return;
+		}
+		yield* presenceManager.set(documentId, connectionId, {
+			data: validated,
+			userId: state.userId
+		});
+		hasPresence = true;
+	});
+	const handlePresenceClear = effect_Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!config.presence) return;
+		yield* presenceManager.remove(documentId, connectionId);
+		hasPresence = false;
+	});
+	const handleMessage = (message) => effect_Effect.gen(function* () {
+		switch (message.type) {
+			case "auth":
+				yield* handleAuth(message.token);
+				break;
+			case "ping":
+				yield* sendMessage({ type: "pong" });
+				break;
+			case "submit":
+				if (!state.authenticated) {
+					yield* sendMessage({
+						type: "error",
+						transactionId: message.transaction.id,
+						reason: "Not authenticated"
+					});
+					return;
+				}
+				const submitResult = yield* documentManager.submit(documentId, message.transaction);
+				if (!submitResult.success) yield* sendMessage({
+					type: "error",
+					transactionId: message.transaction.id,
+					reason: submitResult.reason
+				});
+				break;
+			case "request_snapshot":
+				if (!state.authenticated) return;
+				yield* sendMessage(yield* documentManager.getSnapshot(documentId));
+				break;
+			case "presence_set":
+				yield* handlePresenceSet(message.data);
+				break;
+			case "presence_clear":
+				yield* handlePresenceClear;
+				break;
+		}
+	});
+	const subscribeFiber = yield* effect_Effect.fork(effect_Effect.gen(function* () {
+		while (!state.authenticated) yield* effect_Effect.sleep(effect_Duration.millis(100));
+		const broadcastStream = yield* documentManager.subscribe(documentId);
+		yield* effect_Stream.runForEach(broadcastStream, (broadcast) => sendMessage(broadcast));
+	}).pipe(effect_Effect.scoped));
+	const presenceFiber = yield* effect_Effect.fork(effect_Effect.gen(function* () {
+		if (!config.presence) return;
+		while (!state.authenticated) yield* effect_Effect.sleep(effect_Duration.millis(100));
+		const presenceStream = yield* presenceManager.subscribe(documentId);
+		yield* effect_Stream.runForEach(presenceStream, (event) => effect_Effect.gen(function* () {
+			if (event.id === connectionId) return;
+			if (event.type === "presence_update") yield* sendMessage({
+				type: "presence_update",
+				id: event.id,
+				data: event.data,
+				userId: event.userId
+			});
+			else if (event.type === "presence_remove") yield* sendMessage({
+				type: "presence_remove",
+				id: event.id
+			});
+		}));
+	}).pipe(effect_Effect.scoped));
+	yield* effect_Effect.addFinalizer(() => effect_Effect.gen(function* () {
+		yield* effect_Fiber.interrupt(subscribeFiber);
+		yield* effect_Fiber.interrupt(presenceFiber);
+		if (hasPresence && config.presence) yield* presenceManager.remove(documentId, connectionId);
+	}));
+	yield* socket.runRaw((data) => effect_Effect.gen(function* () {
+		yield* handleMessage(yield* parseClientMessage(data));
+	}).pipe(effect_Effect.catchAll((error) => effect_Effect.logError("Message handling error", error))));
+});
+
+//#endregion
+Object.defineProperty(exports, 'WebSocketHandler_exports', {
+  enumerable: true,
+  get: function () {
+    return WebSocketHandler_exports;
+  }
+});
+exports.extractDocumentId = extractDocumentId;
+exports.handleConnection = handleConnection;
+exports.makeHandler = makeHandler;

package/dist/WebSocketHandler.d.cts

@@ -0,0 +1,34 @@
+import { MimicServerConfigTag } from "./MimicConfig.cjs";
+import { DocumentManagerTag } from "./DocumentManager.cjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
+import { PresenceManagerTag } from "./PresenceManager.cjs";
+import { MessageParseError, MissingDocumentIdError } from "./errors.cjs";
+import * as Effect from "effect/Effect";
+import * as Socket from "@effect/platform/Socket";
+import * as Scope from "effect/Scope";
+
+//#region src/WebSocketHandler.d.ts
+declare namespace WebSocketHandler_d_exports {
+  export { extractDocumentId, handleConnection, makeHandler };
+}
+/**
+ * Extract document ID from URL path.
+ * Expected format: /doc/{documentId}
+ */
+declare const extractDocumentId: (path: string) => Effect.Effect<string, MissingDocumentIdError>;
+/**
+ * Handle a WebSocket connection for a document.
+ *
+ * @param socket - The Effect Platform Socket
+ * @param path - The URL path (e.g., "/doc/my-document-id")
+ * @returns An Effect that handles the connection lifecycle
+ */
+declare const handleConnection: (socket: Socket.Socket, path: string) => Effect.Effect<void, Socket.SocketError | MissingDocumentIdError | MessageParseError, MimicServerConfigTag | MimicAuthServiceTag | DocumentManagerTag | PresenceManagerTag | Scope.Scope>;
+/**
+ * Create a handler function for the WebSocket server.
+ * Returns a function that takes a socket and document ID.
+ */
+declare const makeHandler: Effect.Effect<(socket: Socket.Socket, documentId: string) => Effect.Effect<void, MessageParseError | Socket.SocketError, never>, never, DocumentManagerTag | MimicAuthServiceTag | MimicServerConfigTag | PresenceManagerTag>;
+//#endregion
+export { WebSocketHandler_d_exports };
+//# sourceMappingURL=WebSocketHandler.d.cts.map

package/dist/WebSocketHandler.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketHandler.d.cts","names":[],"sources":["../src/WebSocketHandler.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAyJa,cAAA,iBAEY,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAtB,MAAA,CAAO,MAAA,CAAA,MAAM,EAAS,sBAAT,CAAA;AAuEhB;;;;;;;AAM+C,cANlC,gBAMkC,EAAA,CAAA,MAAA,EALrC,MAAA,CAAO,MAK8B,EAAA,IAAA,EAAA,MAAA,EAAA,GAH5C,MAAA,CAAO,MAGqC,CAAA,IAAA,EAD7C,MAAA,CAAO,WACsC,GADxB,sBACwB,GADC,iBACD,EAA7C,oBAA6C,GAAtB,mBAAsB,GAAA,kBAAA,GAAqB,kBAArB,GAA0C,KAAA,CAAM,KAAhD,CAAA;;;;;AA2PlC,cAAA,WAcX,EAdsB,MAAA,CAAA,MActB,CAAA,CAAA,MAAA,EARgB,MAAA,CAAO,MAQvB,EAAA,UAAA,EAAA,MAAA,EAAA,GARiD,MAAA,CAAA,MAQjD,CAAA,IAAA,EARiD,iBAQjD,GARiD,MAAA,CAAA,WAQjD,EAAA,KAAA,CAAA,EAAA,KAAA,EARiD,kBAQjD,GARiD,mBAQjD,GARiD,oBAQjD,GARiD,kBAQjD,CAAA"}

package/dist/WebSocketHandler.d.mts

@@ -0,0 +1,34 @@
+import { MimicServerConfigTag } from "./MimicConfig.mjs";
+import { DocumentManagerTag } from "./DocumentManager.mjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
+import { PresenceManagerTag } from "./PresenceManager.mjs";
+import { MessageParseError, MissingDocumentIdError } from "./errors.mjs";
+import * as Effect from "effect/Effect";
+import * as Socket from "@effect/platform/Socket";
+import * as Scope from "effect/Scope";
+
+//#region src/WebSocketHandler.d.ts
+declare namespace WebSocketHandler_d_exports {
+  export { extractDocumentId, handleConnection, makeHandler };
+}
+/**
+ * Extract document ID from URL path.
+ * Expected format: /doc/{documentId}
+ */
+declare const extractDocumentId: (path: string) => Effect.Effect<string, MissingDocumentIdError>;
+/**
+ * Handle a WebSocket connection for a document.
+ *
+ * @param socket - The Effect Platform Socket
+ * @param path - The URL path (e.g., "/doc/my-document-id")
+ * @returns An Effect that handles the connection lifecycle
+ */
+declare const handleConnection: (socket: Socket.Socket, path: string) => Effect.Effect<void, Socket.SocketError | MissingDocumentIdError | MessageParseError, MimicServerConfigTag | MimicAuthServiceTag | DocumentManagerTag | PresenceManagerTag | Scope.Scope>;
+/**
+ * Create a handler function for the WebSocket server.
+ * Returns a function that takes a socket and document ID.
+ */
+declare const makeHandler: Effect.Effect<(socket: Socket.Socket, documentId: string) => Effect.Effect<void, MessageParseError | Socket.SocketError, never>, never, DocumentManagerTag | MimicAuthServiceTag | MimicServerConfigTag | PresenceManagerTag>;
+//#endregion
+export { WebSocketHandler_d_exports };
+//# sourceMappingURL=WebSocketHandler.d.mts.map

package/dist/WebSocketHandler.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketHandler.d.mts","names":[],"sources":["../src/WebSocketHandler.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAyJa,cAAA,iBAEY,EAAA,CAAA,IAAA,EAAA,MAAA,EAAA,GAAtB,MAAA,CAAO,MAAA,CAAA,MAAM,EAAS,sBAAT,CAAA;AAuEhB;;;;;;;AAM+C,cANlC,gBAMkC,EAAA,CAAA,MAAA,EALrC,MAAA,CAAO,MAK8B,EAAA,IAAA,EAAA,MAAA,EAAA,GAH5C,MAAA,CAAO,MAGqC,CAAA,IAAA,EAD7C,MAAA,CAAO,WACsC,GADxB,sBACwB,GADC,iBACD,EAA7C,oBAA6C,GAAtB,mBAAsB,GAAA,kBAAA,GAAqB,kBAArB,GAA0C,KAAA,CAAM,KAAhD,CAAA;;;;;AA2PlC,cAAA,WAcX,EAdsB,MAAA,CAAA,MActB,CAAA,CAAA,MAAA,EARgB,MAAA,CAAO,MAQvB,EAAA,UAAA,EAAA,MAAA,EAAA,GARiD,MAAA,CAAA,MAQjD,CAAA,IAAA,EARiD,iBAQjD,GARiD,MAAA,CAAA,WAQjD,EAAA,KAAA,CAAA,EAAA,KAAA,EARiD,kBAQjD,GARiD,mBAQjD,GARiD,oBAQjD,GARiD,kBAQjD,CAAA"}