@voidhash/mimic-effect 0.0.1 → 0.0.3

package/dist/MimicServer.mjs

@@ -0,0 +1,223 @@
+import { __export } from "./_virtual/rolldown_runtime.mjs";
+import { MimicServerConfigTag, layer as layer$1 } from "./MimicConfig.mjs";
+import { DocumentManagerTag, layer as layer$2 } from "./DocumentManager.mjs";
+import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
+import { PresenceManagerTag, layer as layer$3 } from "./PresenceManager.mjs";
+import { extractDocumentId, handleConnection, makeHandler } 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 * as Context from "effect/Context";
+import { SocketServer } from "@effect/platform/SocketServer";
+import { HttpLayerRouter, HttpServerRequest, HttpServerResponse } from "@effect/platform";
+
+//#region src/MimicServer.ts
+/**
+* @since 0.0.1
+* Mimic server layer composition.
+*/
+var MimicServer_exports = /* @__PURE__ */ __export({
+	MimicWebSocketHandler: () => MimicWebSocketHandler,
+	documentManagerLayer: () => documentManagerLayer,
+	handlerLayer: () => handlerLayer,
+	layer: () => layer,
+	layerHttpLayerRouter: () => layerHttpLayerRouter,
+	run: () => run
+});
+/**
+* Tag for the WebSocket handler function.
+*/
+var MimicWebSocketHandler = class extends Context.Tag("@voidhash/mimic-server-effect/MimicWebSocketHandler")() {};
+/**
+* Create a Mimic WebSocket handler layer.
+* 
+* This layer provides a handler function that can be used with any WebSocket server
+* implementation. The handler takes a socket and document ID and manages the
+* document synchronization.
+* 
+* By default, uses in-memory storage and no authentication.
+* Override these by providing MimicDataStorage and MimicAuthService layers.
+* 
+* @example
+* ```typescript
+* import { MimicServer, MimicAuthService } from "@voidhash/mimic-effect";
+* import { Primitive } from "@voidhash/mimic";
+* 
+* const TodoSchema = Primitive.Struct({
+*   title: Primitive.String(),
+*   completed: Primitive.Boolean(),
+* });
+* 
+* // Create the handler layer with defaults
+* const HandlerLayer = MimicServer.layer({
+*   basePath: "/mimic/todo",
+*   schema: TodoSchema
+* });
+* 
+* // Or with custom auth
+* const HandlerLayerWithAuth = MimicServer.layer({
+*   basePath: "/mimic/todo",
+*   schema: TodoSchema
+* }).pipe(
+*   Layer.provideMerge(MimicAuthService.layer({
+*     authHandler: (token) => ({ success: true, userId: "user-123" })
+*   }))
+* );
+* ```
+*/
+const layer = (options) => {
+	const configLayer = layer$1({
+		schema: options.schema,
+		maxTransactionHistory: options.maxTransactionHistory,
+		presence: options.presence
+	});
+	return Layer.merge(Layer.effect(MimicWebSocketHandler, makeHandler).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(configLayer)), layer$2.pipe(Layer.provide(configLayer))).pipe(Layer.provide(layerDefault), Layer.provide(layerDefault$1));
+};
+/**
+* Create the Mimic server handler layer.
+* This layer provides the WebSocket handler that can be used with any WebSocket server.
+*
+* @example
+* ```typescript
+* import { MimicServer } from "@voidhash/mimic-server-effect";
+* import { SocketServer } from "@effect/platform/SocketServer";
+* import { Primitive } from "@voidhash/mimic";
+*
+* // Define your document schema
+* const TodoSchema = Primitive.Struct({
+*   title: Primitive.String(),
+*   completed: Primitive.Boolean(),
+* });
+*
+* // Create the server layer
+* const serverLayer = MimicServer.handlerLayer({
+*   schema: TodoSchema,
+* });
+*
+* // Run with your socket server
+* Effect.gen(function* () {
+*   const handler = yield* MimicServer.MimicWebSocketHandler;
+*   const server = yield* SocketServer;
+*
+*   yield* server.run((socket) =>
+*     // Extract document ID from request and call handler
+*     handler(socket, "my-document-id")
+*   );
+* }).pipe(
+*   Effect.provide(serverLayer),
+*   Effect.provide(YourSocketServerLayer),
+* );
+* ```
+*/
+const handlerLayer = (options) => Layer.effect(MimicWebSocketHandler, makeHandler).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(layer$1(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
+/**
+* Create the document manager layer.
+*/
+const documentManagerLayer = (options) => layer$2.pipe(Layer.provide(layer$1(options)), Layer.provide(layerDefault), Layer.provide(layerDefault$1));
+/**
+* Run a Mimic WebSocket server with the provided handler.
+*
+* This is a helper that:
+* 1. Gets the WebSocket handler from context
+* 2. Runs the socket server with the handler
+*
+* Note: The document ID extraction from socket is implementation-specific.
+* You may need to customize this based on your socket server.
+*/
+const run = (extractDocumentId$1) => Effect.gen(function* () {
+	const handler = yield* MimicWebSocketHandler;
+	yield* (yield* SocketServer).run((socket) => Effect.gen(function* () {
+		yield* handler(socket, yield* extractDocumentId$1(socket));
+	}).pipe(Effect.catchAll((error) => Effect.logError("Connection error", error))));
+});
+/**
+* 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
+*/
+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 });
+	})));
+});
+/**
+* Create a Mimic server layer that integrates with HttpLayerRouter.
+*
+* 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:
+*
+* @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(),
+* });
+*
+* // Create the Mimic route layer with defaults
+* const MimicRoute = MimicServer.layerHttpLayerRouter({
+*   basePath: "/mimic/todo",
+*   schema: TodoSchema
+* });
+*
+* // 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 })
+*   })
+* });
+*
+* // Merge with other routes and serve
+* const AllRoutes = Layer.mergeAll(MimicRoute, OtherRoutes);
+* HttpLayerRouter.serve(AllRoutes).pipe(
+*   Layer.provide(BunHttpServer.layer({ port: 3000 })),
+*   Layer.launch,
+*   BunRuntime.runMain
+* );
+* ```
+*/
+const layerHttpLayerRouter = (options) => {
+	var _options$basePath, _options$authLayer, _options$storageLayer;
+	const wsPath = `${(_options$basePath = options.basePath) !== null && _options$basePath !== void 0 ? _options$basePath : "/mimic"}/doc/*`;
+	const configLayer = layer$1({
+		schema: options.schema,
+		maxTransactionHistory: options.maxTransactionHistory,
+		presence: options.presence
+	});
+	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 registerRoute = Effect.gen(function* () {
+		const router = yield* HttpLayerRouter.HttpRouter;
+		const handler = yield* makeMimicHandler;
+		yield* router.add("GET", wsPath, handler);
+	});
+	return Layer.scopedDiscard(registerRoute).pipe(Layer.provide(layer$2), Layer.provide(layer$3), Layer.provide(configLayer), Layer.provide(storageLayer), Layer.provide(authLayer));
+};
+
+//#endregion
+export { MimicServer_exports };
+//# sourceMappingURL=MimicServer.mjs.map

package/dist/MimicServer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MimicServer.mjs","names":["MimicConfig.layer","WebSocketHandler.makeHandler","DocumentManager.layer","PresenceManager.layer","InMemoryDataStorage.layerDefault","NoAuth.layerDefault","extractDocumentId","MimicConfig.MimicServerConfigTag","DocumentManager.DocumentManagerTag","PresenceManager.PresenceManagerTag","WebSocketHandler.extractDocumentId","WebSocketHandler.handleConnection","wsPath: PathInput"],"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// Handler Tag\n// =============================================================================\n\n/**\n * Tag for the WebSocket handler function.\n */\nexport class MimicWebSocketHandler extends Context.Tag(\n  \"@voidhash/mimic-server-effect/MimicWebSocketHandler\"\n)<\n  MimicWebSocketHandler,\n  (socket: Socket.Socket, documentId: string) => Effect.Effect<void, unknown>\n>() {}\n\n// =============================================================================\n// Layer Composition Options\n// =============================================================================\n\n/**\n * Options for creating a Mimic server layer.\n */\nexport interface MimicLayerOptions<TSchema extends Primitive.AnyPrimitive> {\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\n// =============================================================================\n// Layer Composition\n// =============================================================================\n\n/**\n * Create a Mimic WebSocket handler layer.\n * \n * This layer provides a handler function that can be used with any WebSocket server\n * implementation. The handler takes a socket and document ID and manages the\n * document synchronization.\n * \n * By default, uses in-memory storage and no authentication.\n * Override these by providing MimicDataStorage and MimicAuthService layers.\n * \n * @example\n * ```typescript\n * import { MimicServer, MimicAuthService } from \"@voidhash/mimic-effect\";\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 handler layer with defaults\n * const HandlerLayer = MimicServer.layer({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * });\n * \n * // Or with custom auth\n * const HandlerLayerWithAuth = MimicServer.layer({\n *   basePath: \"/mimic/todo\",\n *   schema: TodoSchema\n * }).pipe(\n *   Layer.provideMerge(MimicAuthService.layer({\n *     authHandler: (token) => ({ success: true, userId: \"user-123\" })\n *   }))\n * );\n * ```\n */\nexport const layer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicLayerOptions<TSchema>\n): Layer.Layer<MimicWebSocketHandler | DocumentManager.DocumentManagerTag> => {\n  const configLayer = MimicConfig.layer({\n    schema: options.schema,\n    maxTransactionHistory: options.maxTransactionHistory,\n    presence: options.presence,\n  });\n\n  return Layer.merge(\n    // Handler layer\n    Layer.effect(MimicWebSocketHandler, WebSocketHandler.makeHandler).pipe(\n      Layer.provide(DocumentManager.layer),\n      Layer.provide(PresenceManager.layer),\n      Layer.provide(configLayer)\n    ),\n    // Document manager layer\n    DocumentManager.layer.pipe(Layer.provide(configLayer))\n  ).pipe(\n    // Provide defaults if not overridden\n    Layer.provide(InMemoryDataStorage.layerDefault),\n    Layer.provide(NoAuth.layerDefault)\n  );\n};\n\n/**\n * Create the Mimic server handler layer.\n * This layer provides the WebSocket handler that can be used with any WebSocket server.\n *\n * @example\n * ```typescript\n * import { MimicServer } from \"@voidhash/mimic-server-effect\";\n * import { SocketServer } from \"@effect/platform/SocketServer\";\n * import { Primitive } from \"@voidhash/mimic\";\n *\n * // Define your document schema\n * const TodoSchema = Primitive.Struct({\n *   title: Primitive.String(),\n *   completed: Primitive.Boolean(),\n * });\n *\n * // Create the server layer\n * const serverLayer = MimicServer.handlerLayer({\n *   schema: TodoSchema,\n * });\n *\n * // Run with your socket server\n * Effect.gen(function* () {\n *   const handler = yield* MimicServer.MimicWebSocketHandler;\n *   const server = yield* SocketServer;\n *\n *   yield* server.run((socket) =>\n *     // Extract document ID from request and call handler\n *     handler(socket, \"my-document-id\")\n *   );\n * }).pipe(\n *   Effect.provide(serverLayer),\n *   Effect.provide(YourSocketServerLayer),\n * );\n * ```\n */\nexport const handlerLayer = <TSchema extends Primitive.AnyPrimitive>(\n  options: MimicConfig.MimicServerConfigOptions<TSchema>\n): Layer.Layer<MimicWebSocketHandler> =>\n  Layer.effect(MimicWebSocketHandler, WebSocketHandler.makeHandler).pipe(\n    Layer.provide(DocumentManager.layer),\n    Layer.provide(PresenceManager.layer),\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 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// Convenience Functions\n// =============================================================================\n\n/**\n * Run a Mimic WebSocket server with the provided handler.\n *\n * This is a helper that:\n * 1. Gets the WebSocket handler from context\n * 2. Runs the socket server with the handler\n *\n * Note: The document ID extraction from socket is implementation-specific.\n * You may need to customize this based on your socket server.\n */\nexport const run = (\n  extractDocumentId: (socket: Socket.Socket) => Effect.Effect<string>\n) =>\n  Effect.gen(function* () {\n    const handler = yield* MimicWebSocketHandler;\n    const server = yield* SocketServer;\n\n    yield* server.run((socket) =>\n      Effect.gen(function* () {\n        const documentId = yield* extractDocumentId(socket);\n        yield* handler(socket, documentId);\n      }).pipe(\n        Effect.catchAll((error) =>\n          Effect.logError(\"Connection error\", error)\n        )\n      )\n    );\n  });\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 * 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 = <TSchema extends Primitive.AnyPrimitive>(\n  options: 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  // 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\n  const configLayer = MimicConfig.layer({\n    schema: options.schema,\n    maxTransactionHistory: options.maxTransactionHistory,\n    presence: options.presence,\n  });\n\n  // Use provided layers or defaults\n  const authLayer = options.authLayer ?? NoAuth.layerDefault;\n  const storageLayer = options.storageLayer ?? InMemoryDataStorage.layerDefault;\n\n  // Create the route registration effect\n  const registerRoute = Effect.gen(function* () {\n    const router = yield* HttpLayerRouter.HttpRouter;\n    const handler = yield* makeMimicHandler;\n    yield* router.add(\"GET\", wsPath, handler);\n  });\n\n  // Build the layer with all dependencies\n  return Layer.scopedDiscard(registerRoute).pipe(\n    Layer.provide(DocumentManager.layer),\n    Layer.provide(PresenceManager.layer),\n    Layer.provide(configLayer),\n    Layer.provide(storageLayer),\n    Layer.provide(authLayer)\n  );\n};"],"mappings":"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"}

package/dist/PresenceManager.cjs

@@ -0,0 +1,108 @@
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+let effect_Effect = require("effect/Effect");
+effect_Effect = require_rolldown_runtime.__toESM(effect_Effect);
+let effect_Layer = require("effect/Layer");
+effect_Layer = require_rolldown_runtime.__toESM(effect_Layer);
+let effect_Context = require("effect/Context");
+effect_Context = require_rolldown_runtime.__toESM(effect_Context);
+let effect_PubSub = require("effect/PubSub");
+effect_PubSub = require_rolldown_runtime.__toESM(effect_PubSub);
+let effect_Ref = require("effect/Ref");
+effect_Ref = require_rolldown_runtime.__toESM(effect_Ref);
+let effect_HashMap = require("effect/HashMap");
+effect_HashMap = require_rolldown_runtime.__toESM(effect_HashMap);
+let effect_Stream = require("effect/Stream");
+effect_Stream = require_rolldown_runtime.__toESM(effect_Stream);
+
+//#region src/PresenceManager.ts
+/**
+* @since 0.0.1
+* Presence manager for ephemeral per-connection state.
+* Handles in-memory storage and broadcasting of presence updates.
+*/
+var PresenceManager_exports = /* @__PURE__ */ require_rolldown_runtime.__export({
+	PresenceManagerTag: () => PresenceManagerTag,
+	layer: () => layer,
+	layerDefault: () => layerDefault
+});
+/**
+* Context tag for PresenceManager.
+*/
+var PresenceManagerTag = class extends effect_Context.Tag("@voidhash/mimic-server-effect/PresenceManager")() {};
+/**
+* Create the PresenceManager service.
+*/
+const makePresenceManager = effect_Effect.gen(function* () {
+	const documents = yield* effect_Ref.make(effect_HashMap.empty());
+	const getOrCreateDocument = (documentId) => effect_Effect.gen(function* () {
+		const current = yield* effect_Ref.get(documents);
+		const existing = effect_HashMap.get(current, documentId);
+		if (existing._tag === "Some") return existing.value;
+		const docPresence = {
+			entries: yield* effect_Ref.make(effect_HashMap.empty()),
+			pubsub: yield* effect_PubSub.unbounded()
+		};
+		yield* effect_Ref.update(documents, (map) => effect_HashMap.set(map, documentId, docPresence));
+		return docPresence;
+	});
+	const getSnapshot = (documentId) => effect_Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		const entriesMap = yield* effect_Ref.get(docPresence.entries);
+		const presences = {};
+		for (const [id, entry] of entriesMap) presences[id] = entry;
+		return { presences };
+	});
+	const set = (documentId, connectionId, entry) => effect_Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		yield* effect_Ref.update(docPresence.entries, (map) => effect_HashMap.set(map, connectionId, entry));
+		yield* effect_PubSub.publish(docPresence.pubsub, {
+			type: "presence_update",
+			id: connectionId,
+			data: entry.data,
+			userId: entry.userId
+		});
+	});
+	const remove = (documentId, connectionId) => effect_Effect.gen(function* () {
+		const current = yield* effect_Ref.get(documents);
+		const existing = effect_HashMap.get(current, documentId);
+		if (existing._tag === "None") return;
+		const docPresence = existing.value;
+		const entries = yield* effect_Ref.get(docPresence.entries);
+		if (!effect_HashMap.has(entries, connectionId)) return;
+		yield* effect_Ref.update(docPresence.entries, (map) => effect_HashMap.remove(map, connectionId));
+		yield* effect_PubSub.publish(docPresence.pubsub, {
+			type: "presence_remove",
+			id: connectionId
+		});
+	});
+	const subscribe = (documentId) => effect_Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		const queue = yield* effect_PubSub.subscribe(docPresence.pubsub);
+		return effect_Stream.fromQueue(queue);
+	});
+	return {
+		getSnapshot,
+		set,
+		remove,
+		subscribe
+	};
+});
+/**
+* Layer that provides PresenceManager.
+*/
+const layer = effect_Layer.effect(PresenceManagerTag, makePresenceManager);
+/**
+* Default layer that provides PresenceManager.
+* Uses the default priority for layer composition.
+*/
+const layerDefault = effect_Layer.effectDiscard(effect_Effect.succeed(void 0)).pipe(effect_Layer.provideMerge(layer));
+
+//#endregion
+exports.PresenceManagerTag = PresenceManagerTag;
+Object.defineProperty(exports, 'PresenceManager_exports', {
+  enumerable: true,
+  get: function () {
+    return PresenceManager_exports;
+  }
+});
+exports.layer = layer;

package/dist/PresenceManager.d.cts

@@ -0,0 +1,91 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+
+//#region src/PresenceManager.d.ts
+declare namespace PresenceManager_d_exports {
+  export { PresenceEntry, PresenceEvent, PresenceManager, PresenceManagerTag, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, layer, layerDefault };
+}
+/**
+ * A presence entry stored in the manager.
+ */
+interface PresenceEntry {
+  /** The presence data */
+  readonly data: unknown;
+  /** Optional user ID from authentication */
+  readonly userId?: string;
+}
+/**
+ * Event emitted when a presence is updated.
+ */
+interface PresenceUpdateEvent {
+  readonly type: "presence_update";
+  /** The connection ID of the user who updated */
+  readonly id: string;
+  /** The presence data */
+  readonly data: unknown;
+  /** Optional user ID from authentication */
+  readonly userId?: string;
+}
+/**
+ * Event emitted when a presence is removed (user disconnected).
+ */
+interface PresenceRemoveEvent {
+  readonly type: "presence_remove";
+  /** The connection ID of the user who disconnected */
+  readonly id: string;
+}
+/**
+ * Union of all presence events.
+ */
+type PresenceEvent = PresenceUpdateEvent | PresenceRemoveEvent;
+/**
+ * A snapshot of all presence entries for a document.
+ */
+interface PresenceSnapshot {
+  /** Map of connectionId to presence entry */
+  readonly presences: Record<string, PresenceEntry>;
+}
+/**
+ * Service interface for the PresenceManager.
+ */
+interface PresenceManager {
+  /**
+   * Get a snapshot of all presences for a document.
+   */
+  readonly getSnapshot: (documentId: string) => Effect.Effect<PresenceSnapshot>;
+  /**
+   * Set/update presence for a connection.
+   * Broadcasts the update to all subscribers.
+   */
+  readonly set: (documentId: string, connectionId: string, entry: PresenceEntry) => Effect.Effect<void>;
+  /**
+   * Remove presence for a connection (e.g., on disconnect).
+   * Broadcasts the removal to all subscribers.
+   */
+  readonly remove: (documentId: string, connectionId: string) => Effect.Effect<void>;
+  /**
+   * Subscribe to presence events for a document.
+   * Returns a Stream of presence events.
+   */
+  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;
+}
+declare const PresenceManagerTag_base: Context.TagClass<PresenceManagerTag, "@voidhash/mimic-server-effect/PresenceManager", PresenceManager>;
+/**
+ * Context tag for PresenceManager.
+ */
+declare class PresenceManagerTag extends PresenceManagerTag_base {}
+/**
+ * Layer that provides PresenceManager.
+ */
+declare const layer: Layer.Layer<PresenceManagerTag>;
+/**
+ * Default layer that provides PresenceManager.
+ * Uses the default priority for layer composition.
+ */
+declare const layerDefault: Layer.Layer<PresenceManagerTag>;
+//#endregion
+export { PresenceManagerTag, PresenceManager_d_exports };
+//# sourceMappingURL=PresenceManager.d.cts.map

package/dist/PresenceManager.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceManager.d.cts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;UAsBiB,aAAA;;;;;;AAAjB;AAcA;AAaA;AASY,UAtBK,mBAAA,CAsBW;EASX,SAAA,IAAA,EAAA,iBAEoB;EAwBpB;EAMI,SAAA,EAAA,EAAA,MAAA;EAAd;EASI,SAAA,IAAA,EAAA,OAAA;EACJ;EASA,SAAO,MAAA,CAAA,EAAA,MAAA;;;;;AAQM,UA7EH,mBAAA,CA6EG;EAKnB,SAAA,IAAA,EAAA,iBAAA;;;;;AAKD;AAoJA;AASa,KA3OD,aAAA,GAAgB,mBA2OW,GA3OW,mBA2OZ;;;;UAlOrB,gBAAA;;sBAEK,eAAe;;;;;UAwBpB,eAAA;;;;gDAMV,MAAA,CAAO,OAAO;;;;;kEASV,kBACJ,MAAA,CAAO;;;;;iEASP,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,uBAEd,KAAA,CAAM;;cAET;;;;cAKY,kBAAA,SAA2B,uBAAA;;;;cAoJ3B,OAAO,KAAA,CAAM,MAAM;;;;;cASnB,cAAc,KAAA,CAAM,MAAM"}

package/dist/PresenceManager.d.mts

@@ -0,0 +1,91 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as Stream from "effect/Stream";
+import * as Scope from "effect/Scope";
+
+//#region src/PresenceManager.d.ts
+declare namespace PresenceManager_d_exports {
+  export { PresenceEntry, PresenceEvent, PresenceManager, PresenceManagerTag, PresenceRemoveEvent, PresenceSnapshot, PresenceUpdateEvent, layer, layerDefault };
+}
+/**
+ * A presence entry stored in the manager.
+ */
+interface PresenceEntry {
+  /** The presence data */
+  readonly data: unknown;
+  /** Optional user ID from authentication */
+  readonly userId?: string;
+}
+/**
+ * Event emitted when a presence is updated.
+ */
+interface PresenceUpdateEvent {
+  readonly type: "presence_update";
+  /** The connection ID of the user who updated */
+  readonly id: string;
+  /** The presence data */
+  readonly data: unknown;
+  /** Optional user ID from authentication */
+  readonly userId?: string;
+}
+/**
+ * Event emitted when a presence is removed (user disconnected).
+ */
+interface PresenceRemoveEvent {
+  readonly type: "presence_remove";
+  /** The connection ID of the user who disconnected */
+  readonly id: string;
+}
+/**
+ * Union of all presence events.
+ */
+type PresenceEvent = PresenceUpdateEvent | PresenceRemoveEvent;
+/**
+ * A snapshot of all presence entries for a document.
+ */
+interface PresenceSnapshot {
+  /** Map of connectionId to presence entry */
+  readonly presences: Record<string, PresenceEntry>;
+}
+/**
+ * Service interface for the PresenceManager.
+ */
+interface PresenceManager {
+  /**
+   * Get a snapshot of all presences for a document.
+   */
+  readonly getSnapshot: (documentId: string) => Effect.Effect<PresenceSnapshot>;
+  /**
+   * Set/update presence for a connection.
+   * Broadcasts the update to all subscribers.
+   */
+  readonly set: (documentId: string, connectionId: string, entry: PresenceEntry) => Effect.Effect<void>;
+  /**
+   * Remove presence for a connection (e.g., on disconnect).
+   * Broadcasts the removal to all subscribers.
+   */
+  readonly remove: (documentId: string, connectionId: string) => Effect.Effect<void>;
+  /**
+   * Subscribe to presence events for a document.
+   * Returns a Stream of presence events.
+   */
+  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;
+}
+declare const PresenceManagerTag_base: Context.TagClass<PresenceManagerTag, "@voidhash/mimic-server-effect/PresenceManager", PresenceManager>;
+/**
+ * Context tag for PresenceManager.
+ */
+declare class PresenceManagerTag extends PresenceManagerTag_base {}
+/**
+ * Layer that provides PresenceManager.
+ */
+declare const layer: Layer.Layer<PresenceManagerTag>;
+/**
+ * Default layer that provides PresenceManager.
+ * Uses the default priority for layer composition.
+ */
+declare const layerDefault: Layer.Layer<PresenceManagerTag>;
+//#endregion
+export { PresenceManagerTag, PresenceManager_d_exports };
+//# sourceMappingURL=PresenceManager.d.mts.map

package/dist/PresenceManager.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PresenceManager.d.mts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;UAsBiB,aAAA;;;;;;AAAjB;AAcA;AAaA;AASY,UAtBK,mBAAA,CAsBW;EASX,SAAA,IAAA,EAAA,iBAEoB;EAwBpB;EAMI,SAAA,EAAA,EAAA,MAAA;EAAd;EASI,SAAA,IAAA,EAAA,OAAA;EACJ;EASA,SAAO,MAAA,CAAA,EAAA,MAAA;;;;;AAQM,UA7EH,mBAAA,CA6EG;EAKnB,SAAA,IAAA,EAAA,iBAAA;;;;;AAKD;AAoJA;AASa,KA3OD,aAAA,GAAgB,mBA2OW,GA3OW,mBA2OZ;;;;UAlOrB,gBAAA;;sBAEK,eAAe;;;;;UAwBpB,eAAA;;;;gDAMV,MAAA,CAAO,OAAO;;;;;kEASV,kBACJ,MAAA,CAAO;;;;;iEASP,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,uBAEd,KAAA,CAAM;;cAET;;;;cAKY,kBAAA,SAA2B,uBAAA;;;;cAoJ3B,OAAO,KAAA,CAAM,MAAM;;;;;cASnB,cAAc,KAAA,CAAM,MAAM"}

package/dist/PresenceManager.mjs

@@ -0,0 +1,95 @@
+import { __export } from "./_virtual/rolldown_runtime.mjs";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Context from "effect/Context";
+import * as PubSub from "effect/PubSub";
+import * as Ref from "effect/Ref";
+import * as HashMap from "effect/HashMap";
+import * as Stream from "effect/Stream";
+
+//#region src/PresenceManager.ts
+/**
+* @since 0.0.1
+* Presence manager for ephemeral per-connection state.
+* Handles in-memory storage and broadcasting of presence updates.
+*/
+var PresenceManager_exports = /* @__PURE__ */ __export({
+	PresenceManagerTag: () => PresenceManagerTag,
+	layer: () => layer,
+	layerDefault: () => layerDefault
+});
+/**
+* Context tag for PresenceManager.
+*/
+var PresenceManagerTag = class extends Context.Tag("@voidhash/mimic-server-effect/PresenceManager")() {};
+/**
+* Create the PresenceManager service.
+*/
+const makePresenceManager = Effect.gen(function* () {
+	const documents = yield* Ref.make(HashMap.empty());
+	const getOrCreateDocument = (documentId) => Effect.gen(function* () {
+		const current = yield* Ref.get(documents);
+		const existing = HashMap.get(current, documentId);
+		if (existing._tag === "Some") return existing.value;
+		const docPresence = {
+			entries: yield* Ref.make(HashMap.empty()),
+			pubsub: yield* PubSub.unbounded()
+		};
+		yield* Ref.update(documents, (map) => HashMap.set(map, documentId, docPresence));
+		return docPresence;
+	});
+	const getSnapshot = (documentId) => Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		const entriesMap = yield* Ref.get(docPresence.entries);
+		const presences = {};
+		for (const [id, entry] of entriesMap) presences[id] = entry;
+		return { presences };
+	});
+	const set = (documentId, connectionId, entry) => Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		yield* Ref.update(docPresence.entries, (map) => HashMap.set(map, connectionId, entry));
+		yield* PubSub.publish(docPresence.pubsub, {
+			type: "presence_update",
+			id: connectionId,
+			data: entry.data,
+			userId: entry.userId
+		});
+	});
+	const remove = (documentId, connectionId) => Effect.gen(function* () {
+		const current = yield* Ref.get(documents);
+		const existing = HashMap.get(current, documentId);
+		if (existing._tag === "None") return;
+		const docPresence = existing.value;
+		const entries = yield* Ref.get(docPresence.entries);
+		if (!HashMap.has(entries, connectionId)) return;
+		yield* Ref.update(docPresence.entries, (map) => HashMap.remove(map, connectionId));
+		yield* PubSub.publish(docPresence.pubsub, {
+			type: "presence_remove",
+			id: connectionId
+		});
+	});
+	const subscribe = (documentId) => Effect.gen(function* () {
+		const docPresence = yield* getOrCreateDocument(documentId);
+		const queue = yield* PubSub.subscribe(docPresence.pubsub);
+		return Stream.fromQueue(queue);
+	});
+	return {
+		getSnapshot,
+		set,
+		remove,
+		subscribe
+	};
+});
+/**
+* Layer that provides PresenceManager.
+*/
+const layer = Layer.effect(PresenceManagerTag, makePresenceManager);
+/**
+* Default layer that provides PresenceManager.
+* Uses the default priority for layer composition.
+*/
+const layerDefault = Layer.effectDiscard(Effect.succeed(void 0)).pipe(Layer.provideMerge(layer));
+
+//#endregion
+export { PresenceManagerTag, PresenceManager_exports, layer };
+//# sourceMappingURL=PresenceManager.mjs.map