@voidhash/mimic-effect 0.0.9 → 1.0.0-beta.2

package/dist/MimicServer.mjs

@@ -1,119 +1,235 @@
-import { __export } from "./_virtual/rolldown_runtime.mjs";
-import { MimicServerConfigTag, layer } from "./MimicConfig.mjs";
-import { DocumentManagerTag, layer as layer$1 } from "./DocumentManager.mjs";
+import { MissingDocumentIdError } from "./Errors.mjs";
+import { connectionsActive, connectionsDuration, connectionsErrors, connectionsTotal } from "./Metrics.mjs";
+import { MimicServerEngineTag } from "./MimicServerEngine.mjs";
+import { authResultFailure, authResultSuccess, encodeServerMessage, errorMessage, parseClientMessage, pong, presenceRemoveMessage, presenceSnapshotMessage, presenceUpdateMessage, snapshotMessage } from "./Protocol.mjs";
 import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
-import { PresenceManagerTag, layer as layer$2 } from "./PresenceManager.mjs";
-import { extractDocumentId, handleConnection } from "./WebSocketHandler.mjs";
-import { layerDefault } from "./storage/InMemoryDataStorage.mjs";
-import { layerDefault as layerDefault$1 } from "./auth/NoAuth.mjs";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from "@effect/platform";
+import { Duration, Effect, Fiber, Layer, Metric, Stream } from "effect";
+import { Presence } from "@voidhash/mimic";
+import { HttpLayerRouter, HttpServerResponse } from "@effect/platform";
 
 //#region src/MimicServer.ts
 /**
-* @since 0.0.1
-* Mimic server layer composition.
+* @voidhash/mimic-effect - MimicServer
+*
+* WebSocket route layer for MimicServerEngine.
+* Creates routes compatible with HttpLayerRouter.
 */
-var MimicServer_exports = /* @__PURE__ */ __export({
-	documentManagerLayer: () => documentManagerLayer,
-	layerHttpLayerRouter: () => layerHttpLayerRouter
-});
+const DEFAULT_PATH = "/mimic";
+const DEFAULT_HEARTBEAT_INTERVAL = Duration.seconds(30);
+const DEFAULT_HEARTBEAT_TIMEOUT = Duration.seconds(10);
+/**
+* Resolve route configuration with defaults
+*/
+const resolveRouteConfig = (config) => {
+	var _config$path;
+	return {
+		path: (_config$path = config === null || config === void 0 ? void 0 : config.path) !== null && _config$path !== void 0 ? _config$path : DEFAULT_PATH,
+		heartbeatInterval: (config === null || config === void 0 ? void 0 : config.heartbeatInterval) ? Duration.decode(config.heartbeatInterval) : DEFAULT_HEARTBEAT_INTERVAL,
+		heartbeatTimeout: (config === null || config === void 0 ? void 0 : config.heartbeatTimeout) ? Duration.decode(config.heartbeatTimeout) : DEFAULT_HEARTBEAT_TIMEOUT
+	};
+};
 /**
-* Create the document manager layer.
+* Extract document ID from URL path.
+* Expected format: /basePath/doc/{documentId}
 */
-const documentManagerLayer = (options) => layer$1.pipe(Layer.provide(layer(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
+const extractDocumentId = (path) => {
+	const parts = path.replace(/^\/+/, "").split("/");
+	const docIndex = parts.lastIndexOf("doc");
+	const part = parts[docIndex + 1];
+	if (docIndex !== -1 && part) return Effect.succeed(decodeURIComponent(part));
+	return Effect.fail(new MissingDocumentIdError({ path }));
+};
 /**
-* Create the HTTP handler effect for WebSocket upgrade.
-* This handler:
-* 1. Extracts the document ID from the URL path
-* 2. Upgrades the HTTP connection to WebSocket
-* 3. Delegates to the WebSocketHandler for document sync
+* Handle a WebSocket connection for a document.
 */
-const makeMimicHandler = Effect.gen(function* () {
-	const config = yield* MimicServerConfigTag;
-	const authService = yield* MimicAuthServiceTag;
-	const documentManager = yield* DocumentManagerTag;
-	const presenceManager = yield* PresenceManagerTag;
-	return Effect.gen(function* () {
-		const request = yield* HttpServerRequest.HttpServerRequest;
-		yield* extractDocumentId(request.url);
-		const socket = yield* request.upgrade;
-		yield* handleConnection(socket, request.url).pipe(Effect.provideService(MimicServerConfigTag, config), Effect.provideService(MimicAuthServiceTag, authService), Effect.provideService(DocumentManagerTag, documentManager), Effect.provideService(PresenceManagerTag, presenceManager), Effect.scoped, Effect.catchAll((error) => Effect.logError("WebSocket connection error", error)));
-		return HttpServerResponse.empty();
-	}).pipe(Effect.catchAll((error) => Effect.gen(function* () {
-		yield* Effect.logWarning("WebSocket upgrade failed", error);
-		return HttpServerResponse.text("WebSocket upgrade failed", { status: 400 });
-	})));
+const handleWebSocketConnection = (socket, documentId, engine, authService, _routeConfig) => Effect.gen(function* () {
+	const connectionId = crypto.randomUUID();
+	const connectionStartTime = Date.now();
+	yield* Metric.increment(connectionsTotal);
+	yield* Metric.incrementBy(connectionsActive, 1);
+	const state = {
+		documentId,
+		connectionId,
+		authenticated: false,
+		hasPresence: false
+	};
+	const write = yield* socket.writer;
+	const sendMessage = (message) => write(encodeServerMessage(message));
+	const sendPresenceSnapshot = Effect.gen(function* () {
+		if (!engine.config.presence) return;
+		const snapshot = yield* engine.getPresenceSnapshot(documentId);
+		yield* sendMessage(presenceSnapshotMessage(connectionId, snapshot.presences));
+	});
+	const sendDocumentSnapshot = Effect.gen(function* () {
+		const snapshot = yield* engine.getSnapshot(documentId);
+		yield* sendMessage(snapshotMessage(snapshot.state, snapshot.version));
+	});
+	const handleAuth = (token) => Effect.gen(function* () {
+		const result = yield* Effect.either(authService.authenticate(token, documentId));
+		if (result._tag === "Right") {
+			state.authenticated = true;
+			state.authContext = result.right;
+			yield* sendMessage(authResultSuccess(result.right.userId, result.right.permission));
+			yield* sendDocumentSnapshot;
+			yield* sendPresenceSnapshot;
+		} else {
+			var _result$left$reason;
+			yield* Metric.increment(connectionsErrors);
+			yield* sendMessage(authResultFailure((_result$left$reason = result.left.reason) !== null && _result$left$reason !== void 0 ? _result$left$reason : "Authentication failed"));
+		}
+	});
+	const handlePresenceSet = (data) => Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!state.authContext) return;
+		if (!engine.config.presence) return;
+		if (state.authContext.permission !== "write") {
+			yield* Effect.logWarning("Presence set rejected - read-only user", { connectionId });
+			return;
+		}
+		const validated = Presence.validateSafe(engine.config.presence, data);
+		if (validated === void 0) {
+			yield* Effect.logWarning("Invalid presence data received", {
+				connectionId,
+				data
+			});
+			return;
+		}
+		yield* engine.setPresence(documentId, connectionId, {
+			data: validated,
+			userId: state.authContext.userId
+		});
+		state.hasPresence = true;
+	});
+	const handlePresenceClear = Effect.gen(function* () {
+		if (!state.authenticated) return;
+		if (!engine.config.presence) return;
+		yield* engine.removePresence(documentId, connectionId);
+		state.hasPresence = false;
+	});
+	const handleMessage = (message) => Effect.gen(function* () {
+		yield* engine.touch(documentId);
+		switch (message.type) {
+			case "auth":
+				yield* handleAuth(message.token);
+				break;
+			case "ping":
+				yield* sendMessage(pong());
+				break;
+			case "submit":
+				var _state$authContext;
+				if (!state.authenticated) {
+					yield* sendMessage(errorMessage(message.transaction.id, "Not authenticated"));
+					return;
+				}
+				if (((_state$authContext = state.authContext) === null || _state$authContext === void 0 ? void 0 : _state$authContext.permission) !== "write") {
+					yield* sendMessage(errorMessage(message.transaction.id, "Write permission required"));
+					return;
+				}
+				const submitResult = yield* engine.submit(documentId, message.transaction);
+				if (!submitResult.success) yield* sendMessage(errorMessage(message.transaction.id, submitResult.reason));
+				break;
+			case "request_snapshot":
+				if (!state.authenticated) return;
+				const snapshot = yield* engine.getSnapshot(documentId);
+				yield* sendMessage(snapshotMessage(snapshot.state, snapshot.version));
+				break;
+			case "presence_set":
+				yield* handlePresenceSet(message.data);
+				break;
+			case "presence_clear":
+				yield* handlePresenceClear;
+				break;
+		}
+	});
+	const subscribeFiber = yield* Effect.fork(Effect.gen(function* () {
+		while (!state.authenticated) yield* Effect.sleep(Duration.millis(100));
+		const broadcastStream = yield* engine.subscribe(documentId);
+		yield* Stream.runForEach(broadcastStream, (broadcast) => sendMessage(broadcast));
+	}).pipe(Effect.scoped));
+	const presenceFiber = yield* Effect.fork(Effect.gen(function* () {
+		if (!engine.config.presence) return;
+		while (!state.authenticated) yield* Effect.sleep(Duration.millis(100));
+		const presenceStream = yield* engine.subscribePresence(documentId);
+		yield* Stream.runForEach(presenceStream, (event) => Effect.gen(function* () {
+			if (event.id === connectionId) return;
+			if (event.type === "presence_update") yield* sendMessage(presenceUpdateMessage(event.id, event.data, event.userId));
+			else if (event.type === "presence_remove") yield* sendMessage(presenceRemoveMessage(event.id));
+		}));
+	}).pipe(Effect.scoped));
+	yield* Effect.addFinalizer(() => Effect.gen(function* () {
+		const duration = Date.now() - connectionStartTime;
+		yield* Fiber.interrupt(subscribeFiber);
+		yield* Fiber.interrupt(presenceFiber);
+		if (state.hasPresence && engine.config.presence) yield* engine.removePresence(documentId, connectionId);
+		yield* Metric.incrementBy(connectionsActive, -1);
+		yield* Metric.update(connectionsDuration, duration);
+		yield* Effect.logDebug("WebSocket connection closed", {
+			connectionId,
+			documentId,
+			durationMs: duration
+		});
+	}));
+	yield* socket.runRaw((data) => Effect.gen(function* () {
+		yield* handleMessage(yield* parseClientMessage(data));
+	}).pipe(Effect.catchAll((error) => Effect.logError("Message handling error", error))));
 });
 /**
-* Create a Mimic server layer that integrates with HttpLayerRouter.
+* Create a route layer for MimicServerEngine.
 *
-* This function creates a layer that:
-* 1. Registers a WebSocket route at the specified base path
-* 2. Handles WebSocket upgrades for document sync
-* 3. Provides all required dependencies (config, auth, storage, document manager)
-*
-* By default, uses in-memory storage and no authentication.
-* To override these defaults, provide custom layers before the defaults:
+* This creates a WebSocket route that connects to the engine.
+* Use Layer.mergeAll to compose with other routes.
 *
 * @example
 * ```typescript
-* import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
-* import { HttpLayerRouter } from "@effect/platform";
-* import { Primitive } from "@voidhash/mimic";
-*
-* const TodoSchema = Primitive.Struct({
-*   title: Primitive.String(),
-*   completed: Primitive.Boolean(),
-* });
+* // 1. Create the engine
+* const Engine = MimicServerEngine.make({
+*   schema: DocSchema,
+*   initial: { title: "Untitled" },
+* })
 *
-* // Create the Mimic route layer with defaults
+* // 2. Create the WebSocket route
 * const MimicRoute = MimicServer.layerHttpLayerRouter({
-*   basePath: "/mimic/todo",
-*   schema: TodoSchema
-* });
+*   path: "/mimic",
+* })
+*
+* // 3. Wire together
+* const MimicLive = MimicRoute.pipe(
+*   Layer.provide(Engine),
+*   Layer.provide(ColdStorage.InMemory.make()),
+*   Layer.provide(HotStorage.InMemory.make()),
+*   Layer.provide(MimicAuthService.NoAuth.make()),
+* )
 *
-* // Or with custom auth - use Layer.provide to inject before defaults
-* const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({
-*   basePath: "/mimic/todo",
-*   schema: TodoSchema,
-*   authLayer: MimicAuthService.layer({
-*     authHandler: (token) => ({ success: true, userId: token })
-*   })
-* });
+* // 4. Compose with other routes
+* const AllRoutes = Layer.mergeAll(MimicLive, DocsRoute, OtherRoutes)
 *
-* // Merge with other routes and serve
-* const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);
+* // 5. Serve
 * HttpLayerRouter.serve(AllRoutes).pipe(
-*   Layer.provide(BunHttpServer.layer({ port: 3000 })),
+*   Layer.provide(NodeHttpServer.layer(createServer, { port: 3000 })),
 *   Layer.launch,
-*   BunRuntime.runMain
-* );
+*   NodeRuntime.runMain
+* )
 * ```
 */
-const layerHttpLayerRouter = (optionsEf) => {
-	return Layer.unwrapScoped(Effect.gen(function* () {
-		var _options$basePath, _options$authLayer, _options$storageLayer;
-		const options = yield* optionsEf;
-		const wsPath = `${(_options$basePath = options.basePath) !== null && _options$basePath !== void 0 ? _options$basePath : "/mimic"}/doc/*`;
-		const configLayer = layer({
-			schema: options.schema,
-			maxTransactionHistory: options.maxTransactionHistory,
-			presence: options.presence,
-			initial: options.initial
+const layerHttpLayerRouter = (options) => {
+	const routeConfig = resolveRouteConfig(options);
+	const routePath = `${routeConfig.path}/doc/:documentId`;
+	return Layer.scopedDiscard(Effect.gen(function* () {
+		const router = yield* HttpLayerRouter.HttpRouter;
+		const engine = yield* MimicServerEngineTag;
+		const authService = yield* MimicAuthServiceTag;
+		const handler = (request) => Effect.gen(function* () {
+			const documentIdResult = yield* Effect.either(extractDocumentId(request.url));
+			if (documentIdResult._tag === "Left") return HttpServerResponse.text(`Missing document ID in path: ${request.url}`, { status: 400 });
+			const documentId = documentIdResult.right;
+			yield* handleWebSocketConnection(yield* request.upgrade, documentId, engine, authService, routeConfig).pipe(Effect.scoped, Effect.catchAll((error) => Effect.logError("WebSocket connection error", error)));
+			return HttpServerResponse.empty();
 		});
-		const authLayer = (_options$authLayer = options.authLayer) !== null && _options$authLayer !== void 0 ? _options$authLayer : layerDefault$1;
-		const storageLayer = (_options$storageLayer = options.storageLayer) !== null && _options$storageLayer !== void 0 ? _options$storageLayer : layerDefault;
-		const depsLayer = Layer.mergeAll(configLayer, authLayer, storageLayer);
-		return Layer.scopedDiscard(Effect.gen(function* () {
-			const router = yield* HttpLayerRouter.HttpRouter;
-			const handler = yield* makeMimicHandler;
-			yield* router.add("GET", wsPath, handler);
-		})).pipe(Layer.provide(layer$1), Layer.provide(layer$2), Layer.provide(depsLayer));
+		yield* router.add("GET", routePath, handler);
 	}));
 };
+const MimicServer = { layerHttpLayerRouter };
 
 //#endregion
-export { MimicServer_exports };
+export { MimicServer };
 //# sourceMappingURL=MimicServer.mjs.map

package/dist/MimicServer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServer.mjs","names":["MimicConfig.layer","InMemoryDataStorage.layerDefault","NoAuth.layerDefault","MimicConfig.MimicServerConfigTag","DocumentManager.DocumentManagerTag","PresenceManager.PresenceManagerTag","WebSocketHandler.extractDocumentId","WebSocketHandler.handleConnection","wsPath: PathInput","DocumentManager.layer","PresenceManager.layer"],"sources":["../src/MimicServer.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Mimic server layer composition.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as Context from \"effect/Context\";\nimport type * as Socket from \"@effect/platform/Socket\";\nimport { SocketServer } from \"@effect/platform/SocketServer\";\nimport type { Primitive, Presence } from \"@voidhash/mimic\";\n\nimport * as DocumentManager from \"./DocumentManager.js\";\nimport * as WebSocketHandler from \"./WebSocketHandler.js\";\nimport * as MimicConfig from \"./MimicConfig.js\";\nimport { MimicDataStorageTag } from \"./MimicDataStorage.js\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService.js\";\nimport * as PresenceManager from \"./PresenceManager.js\";\nimport * as InMemoryDataStorage from \"./storage/InMemoryDataStorage.js\";\nimport * as NoAuth from \"./auth/NoAuth.js\";\nimport { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from \"@effect/platform\";\nimport { PathInput } from \"@effect/platform/HttpRouter\";\n\n// =============================================================================\n// Layer Composition Options\n// =============================================================================\n\n/**\n * Options for creating a Mimic server layer.\n */\nexport interface MimicLayerOptions<\n  TSchema extends Primitive.AnyPrimitive,\n> {\n  /**\n   * Base path for document routes (used for path matching).\n   * @example \"/mimic/todo\" - documents accessed at \"/mimic/todo/:documentId\"\n   */\n  readonly basePath?: PathInput;\n  /**\n   * The schema defining the document structure.\n   */\n  readonly schema: TSchema;\n  /**\n   * Maximum number of processed transaction IDs to track for deduplication.\n   * @default 1000\n   */\n  readonly maxTransactionHistory?: number;\n  /**\n   * Optional presence schema for ephemeral per-user data.\n   * When provided, enables presence features on WebSocket connections.\n   */\n  readonly presence?: Presence.AnyPresence;\n  /**\n   * Initial state for new documents.\n   * Can be either:\n   * - A plain object with the initial state values\n   * - A function that receives context (with documentId) and returns an Effect producing the initial state\n   *\n   * When using a function that requires Effect services (has R requirements),\n   * you must also provide `initialLayer` to supply those dependencies.\n   *\n   * Type-safe: required fields (without defaults) must be provided,\n   * while optional fields and fields with defaults can be omitted.\n   *\n   * @default undefined (documents start empty or use schema defaults)\n   */\n  readonly initial?: Primitive.InferSetInput<TSchema> | MimicConfig.InitialFn<TSchema>;\n}\n\n\n/**\n * Create the document manager layer.\n */\nexport const documentManagerLayer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicConfig.MimicServerConfigOptions<TSchema>\n): Layer.Layer<DocumentManager.DocumentManagerTag> =>\n  DocumentManager.layer.pipe(\n    Layer.provide(MimicConfig.layer(options)),\n    // Provide defaults\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n\n/**\n * Create the HTTP handler effect for WebSocket upgrade.\n * This handler:\n * 1. Extracts the document ID from the URL path\n * 2. Upgrades the HTTP connection to WebSocket\n * 3. Delegates to the WebSocketHandler for document sync\n */\nconst makeMimicHandler = Effect.gen(function* () {\n  const config = yield* MimicConfig.MimicServerConfigTag;\n  const authService = yield* MimicAuthServiceTag;\n  const documentManager = yield* DocumentManager.DocumentManagerTag;\n  const presenceManager = yield* PresenceManager.PresenceManagerTag;\n\n  return Effect.gen(function* () {\n    const request = yield* HttpServerRequest.HttpServerRequest;\n\n    // Extract document ID from the URL path\n    // Expected format: /basePath/doc/{documentId}\n    const documentId = yield* WebSocketHandler.extractDocumentId(request.url);\n\n    // Upgrade to WebSocket\n    const socket = yield* request.upgrade;\n\n    // Handle the WebSocket connection\n    yield* WebSocketHandler.handleConnection(socket, request.url).pipe(\n      Effect.provideService(MimicConfig.MimicServerConfigTag, config),\n      Effect.provideService(MimicAuthServiceTag, authService),\n      Effect.provideService(DocumentManager.DocumentManagerTag, documentManager),\n      Effect.provideService(PresenceManager.PresenceManagerTag, presenceManager),\n      Effect.scoped,\n      Effect.catchAll((error) =>\n        Effect.logError(\"WebSocket connection error\", error)\n      )\n    );\n\n    // Return empty response - the WebSocket upgrade handles the connection\n    return HttpServerResponse.empty();\n  }).pipe(\n    Effect.catchAll((error) =>\n      Effect.gen(function* () {\n        yield* Effect.logWarning(\"WebSocket upgrade failed\", error);\n        return HttpServerResponse.text(\"WebSocket upgrade failed\", {\n          status: 400,\n        });\n      })\n    )\n  );\n});\n\n\n\n/**\n * Options for layerHttpLayerRouter including optional custom layers.\n */\nexport interface MimicLayerRouterOptions<TSchema extends Primitive.AnyPrimitive>\n  extends MimicLayerOptions<TSchema> {\n  /** Custom auth layer. Defaults to NoAuth (all connections allowed). */\n  readonly authLayer?: Layer.Layer<MimicAuthServiceTag>;\n  /** Custom storage layer. Defaults to InMemoryDataStorage. */\n  readonly storageLayer?: Layer.Layer<MimicDataStorageTag>;\n}\n\n/**\n * Create a Mimic server layer that integrates with HttpLayerRouter.\n *\n * This function creates a layer that:\n * 1. Registers a WebSocket route at the specified base path\n * 2. Handles WebSocket upgrades for document sync\n * 3. Provides all required dependencies (config, auth, storage, document manager)\n *\n * By default, uses in-memory storage and no authentication.\n * To override these defaults, provide custom layers before the defaults:\n *\n * @example\n * ```typescript\n * import { MimicServer, MimicAuthService } from \"@voidhash/mimic-effect\";\n * import { HttpLayerRouter } from \"@effect/platform\";\n * import { Primitive } from \"@voidhash/mimic\";\n *\n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n *\n * // Create the Mimic route layer with defaults\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * });\n *\n * // Or with custom auth - use Layer.provide to inject before defaults\n * const MimicRouteWithAuth = MimicServer.layerHttpLayerRouter({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema,\n *   authLayer: MimicAuthService.layer({\n *     authHandler: (token) => ({ success: true, userId: token })\n *   })\n * });\n *\n * // Merge with other routes and serve\n * const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);\n * HttpLayerRouter.serve(AllRoutes).pipe(\n *   Layer.provide(BunHttpServer.layer({ port: 3000 })),\n *   Layer.launch,\n *   BunRuntime.runMain\n * );\n * ```\n */\nexport const layerHttpLayerRouter = <\n  TSchema extends Primitive.AnyPrimitive,\n  TError,\n  TRequirements\n>(\n  optionsEf: Effect.Effect<MimicLayerRouterOptions<TSchema>, TError, TRequirements>\n): Layer.Layer<never, TError, TRequirements | HttpLayerRouter.HttpRouter> => {\n  return Layer.unwrapScoped(\n    Effect.gen(function* () {\n      const options = yield* optionsEf;\n\n      // Build the base path pattern for WebSocket routes\n      // Append /doc/* to match /basePath/doc/{documentId}\n      const basePath = options.basePath ?? \"/mimic\";\n      const wsPath: PathInput = `${basePath}/doc/*` as PathInput;\n\n      // Create the config layer with properly typed initial function\n      const configLayer = MimicConfig.layer<TSchema>({\n        schema: options.schema,\n        maxTransactionHistory: options.maxTransactionHistory,\n        presence: options.presence,\n        initial: options.initial,\n      });\n\n      // Use provided layers or defaults\n      const authLayer = options.authLayer ?? NoAuth.layerDefault;\n      const storageLayer = options.storageLayer ?? InMemoryDataStorage.layerDefault;\n\n      // Combine all dependency layers\n      const depsLayer = Layer.mergeAll(configLayer, authLayer, storageLayer);\n\n      // Create the route registration layer\n      const routeLayer = Layer.scopedDiscard(\n        Effect.gen(function* () {\n          const router = yield* HttpLayerRouter.HttpRouter;\n          const handler = yield* makeMimicHandler;\n          yield* router.add(\"GET\", wsPath, handler);\n        })\n      );\n\n      // Build the complete layer with all dependencies provided\n      return routeLayer.pipe(\n        Layer.provide(DocumentManager.layer),\n        Layer.provide(PresenceManager.layer),\n        Layer.provide(depsLayer),\n      );\n    })\n  );\n};"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAwEA,MAAa,wBACX,oBAEsB,KACpB,MAAM,QAAQA,MAAkB,QAAQ,CAAC,EAEzC,MAAM,QAAQC,aAAiC,EAC/C,MAAM,QAAQC,eAAoB,CACnC;;;;;;;;AASH,MAAM,mBAAmB,OAAO,IAAI,aAAa;CAC/C,MAAM,SAAS,OAAOC;CACtB,MAAM,cAAc,OAAO;CAC3B,MAAM,kBAAkB,OAAOC;CAC/B,MAAM,kBAAkB,OAAOC;AAE/B,QAAO,OAAO,IAAI,aAAa;EAC7B,MAAM,UAAU,OAAO,kBAAkB;AAItB,SAAOC,kBAAmC,QAAQ,IAAI;EAGzE,MAAM,SAAS,OAAO,QAAQ;AAG9B,SAAOC,iBAAkC,QAAQ,QAAQ,IAAI,CAAC,KAC5D,OAAO,eAAeJ,sBAAkC,OAAO,EAC/D,OAAO,eAAe,qBAAqB,YAAY,EACvD,OAAO,eAAeC,oBAAoC,gBAAgB,EAC1E,OAAO,eAAeC,oBAAoC,gBAAgB,EAC1E,OAAO,QACP,OAAO,UAAU,UACf,OAAO,SAAS,8BAA8B,MAAM,CACrD,CACF;AAGD,SAAO,mBAAmB,OAAO;GACjC,CAAC,KACD,OAAO,UAAU,UACf,OAAO,IAAI,aAAa;AACtB,SAAO,OAAO,WAAW,4BAA4B,MAAM;AAC3D,SAAO,mBAAmB,KAAK,4BAA4B,EACzD,QAAQ,KACT,CAAC;GACF,CACH,CACF;EACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DF,MAAa,wBAKX,cAC2E;AAC3E,QAAO,MAAM,aACX,OAAO,IAAI,aAAa;;EACtB,MAAM,UAAU,OAAO;EAKvB,MAAMG,SAAoB,wBADT,QAAQ,yEAAY,SACC;EAGtC,MAAM,cAAcR,MAA2B;GAC7C,QAAQ,QAAQ;GAChB,uBAAuB,QAAQ;GAC/B,UAAU,QAAQ;GAClB,SAAS,QAAQ;GAClB,CAAC;EAGF,MAAM,kCAAY,QAAQ,4EAAaE;EACvC,MAAM,wCAAe,QAAQ,qFAAgBD;EAG7C,MAAM,YAAY,MAAM,SAAS,aAAa,WAAW,aAAa;AAYtE,SATmB,MAAM,cACvB,OAAO,IAAI,aAAa;GACtB,MAAM,SAAS,OAAO,gBAAgB;GACtC,MAAM,UAAU,OAAO;AACvB,UAAO,OAAO,IAAI,OAAO,QAAQ,QAAQ;IACzC,CACH,CAGiB,KAChB,MAAM,QAAQQ,QAAsB,EACpC,MAAM,QAAQC,QAAsB,EACpC,MAAM,QAAQ,UAAU,CACzB;GACD,CACH"}
+{"version":3,"file":"MimicServer.mjs","names":["Metrics.connectionsTotal","Metrics.connectionsActive","state: ConnectionState","Protocol.encodeServerMessage","Protocol.presenceSnapshotMessage","Protocol.snapshotMessage","Protocol.authResultSuccess","Metrics.connectionsErrors","Protocol.authResultFailure","Protocol.pong","Protocol.errorMessage","Protocol.presenceUpdateMessage","Protocol.presenceRemoveMessage","Metrics.connectionsDuration","Protocol.parseClientMessage"],"sources":["../src/MimicServer.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicServer\n *\n * WebSocket route layer for MimicServerEngine.\n * Creates routes compatible with HttpLayerRouter.\n */\nimport {\n  Duration,\n  Effect,\n  Fiber,\n  Layer,\n  Metric,\n  Scope,\n  Stream,\n} from \"effect\";\nimport {\n  HttpLayerRouter,\n  HttpServerRequest,\n  HttpServerResponse,\n} from \"@effect/platform\";\nimport type * as Socket from \"@effect/platform/Socket\";\nimport { Presence } from \"@voidhash/mimic\";\nimport type { MimicServerRouteConfig, ResolvedRouteConfig } from \"./Types\";\nimport * as Protocol from \"./Protocol\";\nimport { MissingDocumentIdError } from \"./Errors\";\nimport { MimicServerEngineTag, type MimicServerEngine } from \"./MimicServerEngine\";\nimport { MimicAuthServiceTag, type MimicAuthService } from \"./MimicAuthService\";\nimport * as Metrics from \"./Metrics\";\nimport type { AuthContext } from \"./Types\";\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_PATH = \"/mimic\";\nconst DEFAULT_HEARTBEAT_INTERVAL = Duration.seconds(30);\nconst DEFAULT_HEARTBEAT_TIMEOUT = Duration.seconds(10);\n\n/**\n * Resolve route configuration with defaults\n */\nconst resolveRouteConfig = (\n  config?: MimicServerRouteConfig\n): ResolvedRouteConfig => ({\n  path: config?.path ?? DEFAULT_PATH,\n  heartbeatInterval: config?.heartbeatInterval\n    ? Duration.decode(config.heartbeatInterval)\n    : DEFAULT_HEARTBEAT_INTERVAL,\n  heartbeatTimeout: config?.heartbeatTimeout\n    ? Duration.decode(config.heartbeatTimeout)\n    : DEFAULT_HEARTBEAT_TIMEOUT,\n});\n\n// =============================================================================\n// URL Path Parsing\n// =============================================================================\n\n/**\n * Extract document ID from URL path.\n * Expected format: /basePath/doc/{documentId}\n */\nconst extractDocumentId = (\n  path: string\n): Effect.Effect<string, MissingDocumentIdError> => {\n  // Remove leading slash and split\n  const parts = path.replace(/^\\/+/, \"\").split(\"/\");\n\n  // Find the last occurrence of 'doc' in the path\n  const docIndex = parts.lastIndexOf(\"doc\");\n  const part = parts[docIndex + 1];\n  if (docIndex !== -1 && part) {\n    return Effect.succeed(decodeURIComponent(part));\n  }\n  return Effect.fail(new MissingDocumentIdError({ path }));\n};\n\n// =============================================================================\n// Connection State\n// =============================================================================\n\ninterface ConnectionState {\n  readonly documentId: string;\n  readonly connectionId: string;\n  authenticated: boolean;\n  authContext?: AuthContext;\n  hasPresence: boolean;\n}\n\n// =============================================================================\n// WebSocket Connection Handler\n// =============================================================================\n\n/**\n * Handle a WebSocket connection for a document.\n */\nconst handleWebSocketConnection = (\n  socket: Socket.Socket,\n  documentId: string,\n  engine: MimicServerEngine,\n  authService: MimicAuthService,\n  _routeConfig: ResolvedRouteConfig\n): Effect.Effect<void, Socket.SocketError, Scope.Scope> =>\n  Effect.gen(function* () {\n    const connectionId = crypto.randomUUID();\n    const connectionStartTime = Date.now();\n\n    // Track connection metrics\n    yield* Metric.increment(Metrics.connectionsTotal);\n    yield* Metric.incrementBy(Metrics.connectionsActive, 1);\n\n    // Track connection state (mutable for simplicity)\n    const state: ConnectionState = {\n      documentId,\n      connectionId,\n      authenticated: false,\n      hasPresence: false,\n    };\n\n    // Get the socket writer\n    const write = yield* socket.writer;\n\n    // Helper to send a message to the client\n    const sendMessage = (message: Protocol.ServerMessage) =>\n      write(Protocol.encodeServerMessage(message));\n\n    // Send presence snapshot after auth\n    const sendPresenceSnapshot = Effect.gen(function* () {\n      if (!engine.config.presence) return;\n\n      const snapshot = yield* engine.getPresenceSnapshot(documentId);\n      yield* sendMessage(\n        Protocol.presenceSnapshotMessage(connectionId, snapshot.presences)\n      );\n    });\n\n    // Send document snapshot after auth\n    const sendDocumentSnapshot = Effect.gen(function* () {\n      const snapshot = yield* engine.getSnapshot(documentId);\n      yield* sendMessage(\n        Protocol.snapshotMessage(snapshot.state, snapshot.version)\n      );\n    });\n\n    // Handle authentication\n    const handleAuth = (token: string) =>\n      Effect.gen(function* () {\n        const result = yield* Effect.either(\n          authService.authenticate(token, documentId)\n        );\n\n        if (result._tag === \"Right\") {\n          state.authenticated = true;\n          state.authContext = result.right;\n\n          yield* sendMessage(\n            Protocol.authResultSuccess(\n              result.right.userId,\n              result.right.permission\n            )\n          );\n\n          // Send document snapshot after successful auth\n          yield* sendDocumentSnapshot;\n\n          // Send presence snapshot after successful auth\n          yield* sendPresenceSnapshot;\n        } else {\n          yield* Metric.increment(Metrics.connectionsErrors);\n          yield* sendMessage(\n            Protocol.authResultFailure(\n              result.left.reason ?? \"Authentication failed\"\n            )\n          );\n        }\n      });\n\n    // Handle presence set\n    const handlePresenceSet = (data: unknown) =>\n      Effect.gen(function* () {\n        if (!state.authenticated) return;\n        if (!state.authContext) return;\n        if (!engine.config.presence) return;\n\n        // Check write permission\n        if (state.authContext.permission !== \"write\") {\n          yield* Effect.logWarning(\"Presence set rejected - read-only user\", {\n            connectionId,\n          });\n          return;\n        }\n\n        // Validate presence data against schema\n        const validated = Presence.validateSafe(engine.config.presence, data);\n        if (validated === undefined) {\n          yield* Effect.logWarning(\"Invalid presence data received\", {\n            connectionId,\n            data,\n          });\n          return;\n        }\n\n        // Store in engine\n        yield* engine.setPresence(documentId, connectionId, {\n          data: validated,\n          userId: state.authContext.userId,\n        });\n\n        state.hasPresence = true;\n      });\n\n    // Handle presence clear\n    const handlePresenceClear = Effect.gen(function* () {\n      if (!state.authenticated) return;\n      if (!engine.config.presence) return;\n\n      yield* engine.removePresence(documentId, connectionId);\n      state.hasPresence = false;\n    });\n\n    // Handle a client message\n    const handleMessage = (message: Protocol.ClientMessage) =>\n      Effect.gen(function* () {\n        // Touch document on any activity (prevents idle GC)\n        yield* engine.touch(documentId);\n\n        switch (message.type) {\n          case \"auth\":\n            yield* handleAuth(message.token);\n            break;\n\n          case \"ping\":\n            yield* sendMessage(Protocol.pong());\n            break;\n\n          case \"submit\":\n            if (!state.authenticated) {\n              yield* sendMessage(\n                Protocol.errorMessage(\n                  message.transaction.id,\n                  \"Not authenticated\"\n                )\n              );\n              return;\n            }\n\n            // Check write permission\n            if (state.authContext?.permission !== \"write\") {\n              yield* sendMessage(\n                Protocol.errorMessage(\n                  message.transaction.id,\n                  \"Write permission required\"\n                )\n              );\n              return;\n            }\n\n            // Submit to the engine\n            const submitResult = yield* engine.submit(\n              documentId,\n              message.transaction\n            );\n\n            // If rejected, send error (success is broadcast to all)\n            if (!submitResult.success) {\n              yield* sendMessage(\n                Protocol.errorMessage(message.transaction.id, submitResult.reason)\n              );\n            }\n            break;\n\n          case \"request_snapshot\":\n            if (!state.authenticated) {\n              return;\n            }\n            const snapshot = yield* engine.getSnapshot(documentId);\n            yield* sendMessage(\n              Protocol.snapshotMessage(snapshot.state, snapshot.version)\n            );\n            break;\n\n          case \"presence_set\":\n            yield* handlePresenceSet(message.data);\n            break;\n\n          case \"presence_clear\":\n            yield* handlePresenceClear;\n            break;\n        }\n      });\n\n    // Subscribe to document broadcasts\n    const subscribeFiber = yield* Effect.fork(\n      Effect.gen(function* () {\n        // Wait until authenticated before subscribing\n        while (!state.authenticated) {\n          yield* Effect.sleep(Duration.millis(100));\n        }\n\n        // Subscribe to the document\n        const broadcastStream = yield* engine.subscribe(documentId);\n\n        // Forward broadcasts to the WebSocket\n        yield* Stream.runForEach(broadcastStream, (broadcast) =>\n          sendMessage(broadcast as Protocol.ServerMessage)\n        );\n      }).pipe(Effect.scoped)\n    );\n\n    // Subscribe to presence events (if presence is enabled)\n    const presenceFiber = yield* Effect.fork(\n      Effect.gen(function* () {\n        if (!engine.config.presence) return;\n\n        // Wait until authenticated before subscribing\n        while (!state.authenticated) {\n          yield* Effect.sleep(Duration.millis(100));\n        }\n\n        // Subscribe to presence events\n        const presenceStream = yield* engine.subscribePresence(documentId);\n\n        // Forward presence events to the WebSocket, filtering out our own events (no-echo)\n        yield* Stream.runForEach(presenceStream, (event) =>\n          Effect.gen(function* () {\n            // Don't echo our own presence events\n            if (event.id === connectionId) return;\n\n            if (event.type === \"presence_update\") {\n              yield* sendMessage(\n                Protocol.presenceUpdateMessage(event.id, event.data, event.userId)\n              );\n            } else if (event.type === \"presence_remove\") {\n              yield* sendMessage(Protocol.presenceRemoveMessage(event.id));\n            }\n          })\n        );\n      }).pipe(Effect.scoped)\n    );\n\n    // Ensure cleanup on disconnect\n    yield* Effect.addFinalizer(() =>\n      Effect.gen(function* () {\n        // Calculate connection duration\n        const duration = Date.now() - connectionStartTime;\n\n        // Interrupt the subscribe fibers\n        yield* Fiber.interrupt(subscribeFiber);\n        yield* Fiber.interrupt(presenceFiber);\n\n        // Remove presence if we had any\n        if (state.hasPresence && engine.config.presence) {\n          yield* engine.removePresence(documentId, connectionId);\n        }\n\n        // Update connection metrics\n        yield* Metric.incrementBy(Metrics.connectionsActive, -1);\n        yield* Metric.update(Metrics.connectionsDuration, duration);\n\n        yield* Effect.logDebug(\"WebSocket connection closed\", {\n          connectionId,\n          documentId,\n          durationMs: duration,\n        });\n      })\n    );\n\n    // Process incoming messages\n    yield* socket.runRaw((data) =>\n      Effect.gen(function* () {\n        const message = yield* Protocol.parseClientMessage(data);\n        yield* handleMessage(message);\n      }).pipe(\n        Effect.catchAll((error) =>\n          Effect.logError(\"Message handling error\", error)\n        )\n      )\n    );\n  });\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a route layer for MimicServerEngine.\n *\n * This creates a WebSocket route that connects to the engine.\n * Use Layer.mergeAll to compose with other routes.\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.InMemory.make()),\n *   Layer.provide(HotStorage.InMemory.make()),\n *   Layer.provide(MimicAuthService.NoAuth.make()),\n * )\n *\n * // 4. Compose with other routes\n * const AllRoutes = Layer.mergeAll(MimicLive, DocsRoute, OtherRoutes)\n *\n * // 5. Serve\n * HttpLayerRouter.serve(AllRoutes).pipe(\n *   Layer.provide(NodeHttpServer.layer(createServer, { port: 3000 })),\n *   Layer.launch,\n *   NodeRuntime.runMain\n * )\n * ```\n */\nexport const layerHttpLayerRouter = (\n  options?: MimicServerRouteConfig\n) => {\n  const routeConfig = resolveRouteConfig(options);\n\n  // Build the route path pattern: {path}/doc/:documentId\n  const routePath =\n    `${routeConfig.path}/doc/:documentId` as HttpLayerRouter.PathInput;\n\n  return Layer.scopedDiscard(\n    Effect.gen(function* () {\n      const router = yield* HttpLayerRouter.HttpRouter;\n      // Capture engine and auth service at layer creation time\n      const engine = yield* MimicServerEngineTag;\n      const authService = yield* MimicAuthServiceTag;\n\n      // Create the handler that receives the request\n      // Engine and authService are captured in closure, not yielded per-request\n      const handler = (request: HttpServerRequest.HttpServerRequest) =>\n        Effect.gen(function* () {\n          // Extract document ID from path\n          const documentIdResult = yield* Effect.either(\n            extractDocumentId(request.url)\n          );\n          if (documentIdResult._tag === \"Left\") {\n            return HttpServerResponse.text(\n              `Missing document ID in path: ${request.url}`,\n              { status: 400 }\n            );\n          }\n          const documentId = documentIdResult.right;\n\n          // Upgrade to WebSocket\n          const socket = yield* request.upgrade;\n\n          // Handle the WebSocket connection\n          yield* handleWebSocketConnection(\n            socket,\n            documentId,\n            engine,\n            authService,\n            routeConfig\n          ).pipe(\n            Effect.scoped,\n            Effect.catchAll((error) =>\n              Effect.logError(\"WebSocket connection error\", error)\n            )\n          );\n\n          // Return empty response - the WebSocket upgrade handles the connection\n          return HttpServerResponse.empty();\n        });\n\n      yield* router.add(\"GET\", routePath, handler);\n    })\n  );\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicServer = {\n  layerHttpLayerRouter,\n};\n\n// =============================================================================\n// Re-export types\n// =============================================================================\n\nexport type { MimicServerRouteConfig };\n"],"mappings":";;;;;;;;;;;;;;;;AAkCA,MAAM,eAAe;AACrB,MAAM,6BAA6B,SAAS,QAAQ,GAAG;AACvD,MAAM,4BAA4B,SAAS,QAAQ,GAAG;;;;AAKtD,MAAM,sBACJ,WACwB;;QAAC;EACzB,sEAAM,OAAQ,2DAAQ;EACtB,oEAAmB,OAAQ,qBACvB,SAAS,OAAO,OAAO,kBAAkB,GACzC;EACJ,mEAAkB,OAAQ,oBACtB,SAAS,OAAO,OAAO,iBAAiB,GACxC;EACL;;;;;;AAUD,MAAM,qBACJ,SACkD;CAElD,MAAM,QAAQ,KAAK,QAAQ,QAAQ,GAAG,CAAC,MAAM,IAAI;CAGjD,MAAM,WAAW,MAAM,YAAY,MAAM;CACzC,MAAM,OAAO,MAAM,WAAW;AAC9B,KAAI,aAAa,MAAM,KACrB,QAAO,OAAO,QAAQ,mBAAmB,KAAK,CAAC;AAEjD,QAAO,OAAO,KAAK,IAAI,uBAAuB,EAAE,MAAM,CAAC,CAAC;;;;;AAsB1D,MAAM,6BACJ,QACA,YACA,QACA,aACA,iBAEA,OAAO,IAAI,aAAa;CACtB,MAAM,eAAe,OAAO,YAAY;CACxC,MAAM,sBAAsB,KAAK,KAAK;AAGtC,QAAO,OAAO,UAAUA,iBAAyB;AACjD,QAAO,OAAO,YAAYC,mBAA2B,EAAE;CAGvD,MAAMC,QAAyB;EAC7B;EACA;EACA,eAAe;EACf,aAAa;EACd;CAGD,MAAM,QAAQ,OAAO,OAAO;CAG5B,MAAM,eAAe,YACnB,MAAMC,oBAA6B,QAAQ,CAAC;CAG9C,MAAM,uBAAuB,OAAO,IAAI,aAAa;AACnD,MAAI,CAAC,OAAO,OAAO,SAAU;EAE7B,MAAM,WAAW,OAAO,OAAO,oBAAoB,WAAW;AAC9D,SAAO,YACLC,wBAAiC,cAAc,SAAS,UAAU,CACnE;GACD;CAGF,MAAM,uBAAuB,OAAO,IAAI,aAAa;EACnD,MAAM,WAAW,OAAO,OAAO,YAAY,WAAW;AACtD,SAAO,YACLC,gBAAyB,SAAS,OAAO,SAAS,QAAQ,CAC3D;GACD;CAGF,MAAM,cAAc,UAClB,OAAO,IAAI,aAAa;EACtB,MAAM,SAAS,OAAO,OAAO,OAC3B,YAAY,aAAa,OAAO,WAAW,CAC5C;AAED,MAAI,OAAO,SAAS,SAAS;AAC3B,SAAM,gBAAgB;AACtB,SAAM,cAAc,OAAO;AAE3B,UAAO,YACLC,kBACE,OAAO,MAAM,QACb,OAAO,MAAM,WACd,CACF;AAGD,UAAO;AAGP,UAAO;SACF;;AACL,UAAO,OAAO,UAAUC,kBAA0B;AAClD,UAAO,YACLC,yCACE,OAAO,KAAK,2EAAU,wBACvB,CACF;;GAEH;CAGJ,MAAM,qBAAqB,SACzB,OAAO,IAAI,aAAa;AACtB,MAAI,CAAC,MAAM,cAAe;AAC1B,MAAI,CAAC,MAAM,YAAa;AACxB,MAAI,CAAC,OAAO,OAAO,SAAU;AAG7B,MAAI,MAAM,YAAY,eAAe,SAAS;AAC5C,UAAO,OAAO,WAAW,0CAA0C,EACjE,cACD,CAAC;AACF;;EAIF,MAAM,YAAY,SAAS,aAAa,OAAO,OAAO,UAAU,KAAK;AACrE,MAAI,cAAc,QAAW;AAC3B,UAAO,OAAO,WAAW,kCAAkC;IACzD;IACA;IACD,CAAC;AACF;;AAIF,SAAO,OAAO,YAAY,YAAY,cAAc;GAClD,MAAM;GACN,QAAQ,MAAM,YAAY;GAC3B,CAAC;AAEF,QAAM,cAAc;GACpB;CAGJ,MAAM,sBAAsB,OAAO,IAAI,aAAa;AAClD,MAAI,CAAC,MAAM,cAAe;AAC1B,MAAI,CAAC,OAAO,OAAO,SAAU;AAE7B,SAAO,OAAO,eAAe,YAAY,aAAa;AACtD,QAAM,cAAc;GACpB;CAGF,MAAM,iBAAiB,YACrB,OAAO,IAAI,aAAa;AAEtB,SAAO,OAAO,MAAM,WAAW;AAE/B,UAAQ,QAAQ,MAAhB;GACE,KAAK;AACH,WAAO,WAAW,QAAQ,MAAM;AAChC;GAEF,KAAK;AACH,WAAO,YAAYC,MAAe,CAAC;AACnC;GAEF,KAAK;;AACH,QAAI,CAAC,MAAM,eAAe;AACxB,YAAO,YACLC,aACE,QAAQ,YAAY,IACpB,oBACD,CACF;AACD;;AAIF,+BAAI,MAAM,qFAAa,gBAAe,SAAS;AAC7C,YAAO,YACLA,aACE,QAAQ,YAAY,IACpB,4BACD,CACF;AACD;;IAIF,MAAM,eAAe,OAAO,OAAO,OACjC,YACA,QAAQ,YACT;AAGD,QAAI,CAAC,aAAa,QAChB,QAAO,YACLA,aAAsB,QAAQ,YAAY,IAAI,aAAa,OAAO,CACnE;AAEH;GAEF,KAAK;AACH,QAAI,CAAC,MAAM,cACT;IAEF,MAAM,WAAW,OAAO,OAAO,YAAY,WAAW;AACtD,WAAO,YACLL,gBAAyB,SAAS,OAAO,SAAS,QAAQ,CAC3D;AACD;GAEF,KAAK;AACH,WAAO,kBAAkB,QAAQ,KAAK;AACtC;GAEF,KAAK;AACH,WAAO;AACP;;GAEJ;CAGJ,MAAM,iBAAiB,OAAO,OAAO,KACnC,OAAO,IAAI,aAAa;AAEtB,SAAO,CAAC,MAAM,cACZ,QAAO,OAAO,MAAM,SAAS,OAAO,IAAI,CAAC;EAI3C,MAAM,kBAAkB,OAAO,OAAO,UAAU,WAAW;AAG3D,SAAO,OAAO,WAAW,kBAAkB,cACzC,YAAY,UAAoC,CACjD;GACD,CAAC,KAAK,OAAO,OAAO,CACvB;CAGD,MAAM,gBAAgB,OAAO,OAAO,KAClC,OAAO,IAAI,aAAa;AACtB,MAAI,CAAC,OAAO,OAAO,SAAU;AAG7B,SAAO,CAAC,MAAM,cACZ,QAAO,OAAO,MAAM,SAAS,OAAO,IAAI,CAAC;EAI3C,MAAM,iBAAiB,OAAO,OAAO,kBAAkB,WAAW;AAGlE,SAAO,OAAO,WAAW,iBAAiB,UACxC,OAAO,IAAI,aAAa;AAEtB,OAAI,MAAM,OAAO,aAAc;AAE/B,OAAI,MAAM,SAAS,kBACjB,QAAO,YACLM,sBAA+B,MAAM,IAAI,MAAM,MAAM,MAAM,OAAO,CACnE;YACQ,MAAM,SAAS,kBACxB,QAAO,YAAYC,sBAA+B,MAAM,GAAG,CAAC;IAE9D,CACH;GACD,CAAC,KAAK,OAAO,OAAO,CACvB;AAGD,QAAO,OAAO,mBACZ,OAAO,IAAI,aAAa;EAEtB,MAAM,WAAW,KAAK,KAAK,GAAG;AAG9B,SAAO,MAAM,UAAU,eAAe;AACtC,SAAO,MAAM,UAAU,cAAc;AAGrC,MAAI,MAAM,eAAe,OAAO,OAAO,SACrC,QAAO,OAAO,eAAe,YAAY,aAAa;AAIxD,SAAO,OAAO,YAAYX,mBAA2B,GAAG;AACxD,SAAO,OAAO,OAAOY,qBAA6B,SAAS;AAE3D,SAAO,OAAO,SAAS,+BAA+B;GACpD;GACA;GACA,YAAY;GACb,CAAC;GACF,CACH;AAGD,QAAO,OAAO,QAAQ,SACpB,OAAO,IAAI,aAAa;AAEtB,SAAO,cADS,OAAOC,mBAA4B,KAAK,CAC3B;GAC7B,CAAC,KACD,OAAO,UAAU,UACf,OAAO,SAAS,0BAA0B,MAAM,CACjD,CACF,CACF;EACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4CJ,MAAa,wBACX,YACG;CACH,MAAM,cAAc,mBAAmB,QAAQ;CAG/C,MAAM,YACJ,GAAG,YAAY,KAAK;AAEtB,QAAO,MAAM,cACX,OAAO,IAAI,aAAa;EACtB,MAAM,SAAS,OAAO,gBAAgB;EAEtC,MAAM,SAAS,OAAO;EACtB,MAAM,cAAc,OAAO;EAI3B,MAAM,WAAW,YACf,OAAO,IAAI,aAAa;GAEtB,MAAM,mBAAmB,OAAO,OAAO,OACrC,kBAAkB,QAAQ,IAAI,CAC/B;AACD,OAAI,iBAAiB,SAAS,OAC5B,QAAO,mBAAmB,KACxB,gCAAgC,QAAQ,OACxC,EAAE,QAAQ,KAAK,CAChB;GAEH,MAAM,aAAa,iBAAiB;AAMpC,UAAO,0BAHQ,OAAO,QAAQ,SAK5B,YACA,QACA,aACA,YACD,CAAC,KACA,OAAO,QACP,OAAO,UAAU,UACf,OAAO,SAAS,8BAA8B,MAAM,CACrD,CACF;AAGD,UAAO,mBAAmB,OAAO;IACjC;AAEJ,SAAO,OAAO,IAAI,OAAO,WAAW,QAAQ;GAC5C,CACH;;AAOH,MAAa,cAAc,EACzB,sBACD"}

package/dist/MimicServerEngine.cjs

@@ -0,0 +1,97 @@
+const require_DocumentManager = require('./DocumentManager.cjs');
+const require_PresenceManager = require('./PresenceManager.cjs');
+let effect = require("effect");
+
+//#region src/MimicServerEngine.ts
+/**
+* @voidhash/mimic-effect - MimicServerEngine
+*
+* Core document management service for Mimic real-time collaboration.
+* Handles document lifecycle, storage, presence, and transaction processing.
+*
+* This is the engine layer - for WebSocket routes, use MimicServer.layerHttpLayerRouter().
+*/
+/**
+* Context tag for MimicServerEngine
+*/
+var MimicServerEngineTag = class extends effect.Context.Tag("@voidhash/mimic-effect/MimicServerEngine")() {};
+const DEFAULT_MAX_IDLE_TIME = effect.Duration.minutes(5);
+const DEFAULT_MAX_TRANSACTION_HISTORY = 1e3;
+const DEFAULT_SNAPSHOT_INTERVAL = effect.Duration.minutes(5);
+const DEFAULT_SNAPSHOT_THRESHOLD = 100;
+/**
+* Resolve configuration with defaults
+*/
+const resolveConfig = (config) => {
+	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2;
+	return {
+		schema: config.schema,
+		initial: config.initial,
+		presence: config.presence,
+		maxIdleTime: config.maxIdleTime ? effect.Duration.decode(config.maxIdleTime) : DEFAULT_MAX_IDLE_TIME,
+		maxTransactionHistory: (_config$maxTransactio = config.maxTransactionHistory) !== null && _config$maxTransactio !== void 0 ? _config$maxTransactio : DEFAULT_MAX_TRANSACTION_HISTORY,
+		snapshot: {
+			interval: ((_config$snapshot = config.snapshot) === null || _config$snapshot === void 0 ? void 0 : _config$snapshot.interval) ? effect.Duration.decode(config.snapshot.interval) : DEFAULT_SNAPSHOT_INTERVAL,
+			transactionThreshold: (_config$snapshot$tran = (_config$snapshot2 = config.snapshot) === null || _config$snapshot2 === void 0 ? void 0 : _config$snapshot2.transactionThreshold) !== null && _config$snapshot$tran !== void 0 ? _config$snapshot$tran : DEFAULT_SNAPSHOT_THRESHOLD
+		}
+	};
+};
+/**
+* Create a MimicServerEngine layer.
+*
+* This creates the core document management service. To expose it via WebSocket,
+* use MimicServer.layerHttpLayerRouter().
+*
+* @example
+* ```typescript
+* // 1. Create the engine
+* const Engine = MimicServerEngine.make({
+*   schema: DocSchema,
+*   initial: { title: "Untitled" },
+*   presence: CursorPresence,
+*   maxIdleTime: "5 minutes",
+*   snapshot: { interval: "5 minutes", transactionThreshold: 100 },
+* })
+*
+* // 2. Create the WebSocket route
+* const MimicRoute = MimicServer.layerHttpLayerRouter({
+*   path: "/mimic",
+* })
+*
+* // 3. Wire together
+* const MimicLive = MimicRoute.pipe(
+*   Layer.provide(Engine),
+*   Layer.provide(ColdStorage.InMemory.make()),
+*   Layer.provide(HotStorage.InMemory.make()),
+*   Layer.provide(MimicAuthService.NoAuth.make()),
+* )
+* ```
+*/
+const make = (config) => {
+	const resolvedConfig = resolveConfig(config);
+	const configLayer = effect.Layer.succeed(require_DocumentManager.DocumentManagerConfigTag, resolvedConfig);
+	const internalLayers = effect.Layer.mergeAll(require_DocumentManager.layer.pipe(effect.Layer.provide(configLayer)), require_PresenceManager.layer);
+	return effect.Layer.scoped(MimicServerEngineTag, effect.Effect.gen(function* () {
+		const documentManager = yield* require_DocumentManager.DocumentManagerTag;
+		const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+		return {
+			submit: (documentId, transaction) => documentManager.submit(documentId, transaction),
+			getSnapshot: (documentId) => documentManager.getSnapshot(documentId),
+			subscribe: (documentId) => documentManager.subscribe(documentId),
+			touch: (documentId) => documentManager.touch(documentId),
+			getPresenceSnapshot: (documentId) => presenceManager.getSnapshot(documentId),
+			setPresence: (documentId, connectionId, entry) => presenceManager.set(documentId, connectionId, entry),
+			removePresence: (documentId, connectionId) => presenceManager.remove(documentId, connectionId),
+			subscribePresence: (documentId) => presenceManager.subscribe(documentId),
+			config: resolvedConfig
+		};
+	})).pipe(effect.Layer.provide(internalLayers));
+};
+const MimicServerEngine = {
+	Tag: MimicServerEngineTag,
+	make
+};
+
+//#endregion
+exports.MimicServerEngine = MimicServerEngine;
+exports.MimicServerEngineTag = MimicServerEngineTag;

package/dist/MimicServerEngine.d.cts

@@ -0,0 +1,78 @@
+import { MimicServerEngineConfig, PresenceEntry, PresenceEvent, PresenceSnapshot, ResolvedConfig } from "./Types.cjs";
+import { ServerMessage } from "./Protocol.cjs";
+import { ColdStorageTag } from "./ColdStorage.cjs";
+import { HotStorageTag } from "./HotStorage.cjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
+import { DocumentManagerError, SubmitResult } from "./DocumentManager.cjs";
+import { Context, Effect, Layer, Scope, Stream } from "effect";
+import { Primitive, Transaction } from "@voidhash/mimic";
+
+//#region src/MimicServerEngine.d.ts
+
+/**
+ * MimicServerEngine service interface.
+ *
+ * Provides document management operations for Mimic collaboration.
+ * Use MimicServer.layerHttpLayerRouter() to create WebSocket routes.
+ */
+interface MimicServerEngine {
+  /**
+   * Submit a transaction to a document.
+   * Authorization is checked against the auth service.
+   * May fail with DocumentManagerError if storage is unavailable.
+   */
+  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, DocumentManagerError>;
+  /**
+   * Get document snapshot (current state and version).
+   * May fail with DocumentManagerError if storage is unavailable.
+   */
+  readonly getSnapshot: (documentId: string) => Effect.Effect<{
+    state: unknown;
+    version: number;
+  }, DocumentManagerError>;
+  /**
+   * Subscribe to document broadcasts (transactions).
+   * Returns a stream of server messages.
+   * Requires a Scope for cleanup when the subscription ends.
+   * May fail with DocumentManagerError if storage is unavailable.
+   */
+  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerMessage, never, never>, DocumentManagerError, Scope.Scope>;
+  /**
+   * Touch document to prevent idle garbage collection.
+   */
+  readonly touch: (documentId: string) => Effect.Effect<void, never>;
+  /**
+   * Get presence snapshot for a document.
+   */
+  readonly getPresenceSnapshot: (documentId: string) => Effect.Effect<PresenceSnapshot, never>;
+  /**
+   * Set presence for a connection.
+   */
+  readonly setPresence: (documentId: string, connectionId: string, entry: PresenceEntry) => Effect.Effect<void, never>;
+  /**
+   * Remove presence for a connection.
+   */
+  readonly removePresence: (documentId: string, connectionId: string) => Effect.Effect<void, never>;
+  /**
+   * Subscribe to presence events for a document.
+   * Requires a Scope for cleanup when the subscription ends.
+   */
+  readonly subscribePresence: (documentId: string) => Effect.Effect<Stream.Stream<PresenceEvent, never, never>, never, Scope.Scope>;
+  /**
+   * Resolved engine configuration.
+   * Used by route layer to access schema, presence config, etc.
+   */
+  readonly config: ResolvedConfig<Primitive.AnyPrimitive>;
+}
+declare const MimicServerEngineTag_base: Context.TagClass<MimicServerEngineTag, "@voidhash/mimic-effect/MimicServerEngine", MimicServerEngine>;
+/**
+ * Context tag for MimicServerEngine
+ */
+declare class MimicServerEngineTag extends MimicServerEngineTag_base {}
+declare const MimicServerEngine: {
+  Tag: typeof MimicServerEngineTag;
+  make: <TSchema extends Primitive.AnyPrimitive>(config: MimicServerEngineConfig<TSchema>) => Layer.Layer<MimicServerEngineTag, never, ColdStorageTag | HotStorageTag | MimicAuthServiceTag>;
+};
+//#endregion
+export { MimicServerEngine, MimicServerEngineTag };
+//# sourceMappingURL=MimicServerEngine.d.cts.map

package/dist/MimicServerEngine.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicServerEngine.d.cts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AAkF0C,UAhCzB,iBAAA,CAgCgC;EAO5B;;;;;EAyBc,SAAA,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAxDlB,WAAA,CAAY,WAwDM,EAAA,GAvD5B,MAAA,CAAO,MAuDqB,CAvDd,YAuDc,EAvDA,oBAuDA,CAAA;EAAd;;;;EAMF,SAAA,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GArDZ,MAAA,CAAO,MAqDK,CAAA;IAAc,KAAA,EAAA,OAAA;IAChC,OAAA,EAAA,MAAA;KAtDyD;;;;AA+D1D;AAwIA;;EAjEqC,SAAU,SAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA5HxC,MAAA,CAAO,MA4HiC,CA5H1B,MAAA,CAAO,MA4HmB,CA5HZ,aA4HY,EAAA,KAAA,EAAA,KAAA,CAAA,EA5H2B,oBA4H3B,EA5HiD,KAAA,CAAM,KA4HvD,CAAA;EACb;;;EAIhC,SAAA,KAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA5HwC,MAAA,CAAO,MA4H/C,CAAA,IAAA,EAAA,KAAA,CAAA;EAAiB;;;EAHL,SAAA,mBAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAlHP,MAAA,CAAO,MAkHA,CAlHO,gBAkHP,EAAA,KAAA,CAAA;;;;0EA1GH,kBACJ,MAAA,CAAO;;;;yEAQP,MAAA,CAAO;;;;;sDAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,qCAAqC,KAAA,CAAM;;;;;mBAM3D,eAAe,SAAA,CAAU;;cAC3C;;;;cASY,oBAAA,SAA6B,yBAAA;cAwI7B;;yBAjEwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}