@voidhash/mimic-effect 0.0.2 → 0.0.4

package/dist/WebSocketHandler.cjs

@@ -0,0 +1,365 @@
+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 _voidhash_mimic = require("@voidhash/mimic");
+let effect_Fiber = require("effect/Fiber");
+effect_Fiber = require_rolldown_runtime.__toESM(effect_Fiber);
+
+//#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;

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 Scope from "effect/Scope";
+import * as Socket from "@effect/platform/Socket";
+
+//#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 Scope from "effect/Scope";
+import * as Socket from "@effect/platform/Socket";
+
+//#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"}