@voidhash/mimic-effect 1.0.0-beta.1 → 1.0.0-beta.10

package/dist/MimicServerEngine.cjs

@@ -1,4 +1,7 @@
-const require_DocumentManager = require('./DocumentManager.cjs');
+const require_ColdStorage = require('./ColdStorage.cjs');
+const require_HotStorage = require('./HotStorage.cjs');
+const require_Metrics = require('./Metrics.cjs');
+const require_DocumentInstance = require('./DocumentInstance.cjs');
 const require_PresenceManager = require('./PresenceManager.cjs');
 let effect = require("effect");
 
@@ -19,11 +22,12 @@ 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;
+const DEFAULT_SNAPSHOT_IDLE_TIMEOUT = effect.Duration.seconds(30);
 /**
 * Resolve configuration with defaults
 */
 const resolveConfig = (config) => {
-	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2;
+	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2, _config$snapshot3;
 	return {
 		schema: config.schema,
 		initial: config.initial,
@@ -32,7 +36,8 @@ const resolveConfig = (config) => {
 		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
+			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,
+			idleTimeout: ((_config$snapshot3 = config.snapshot) === null || _config$snapshot3 === void 0 ? void 0 : _config$snapshot3.idleTimeout) ? effect.Duration.decode(config.snapshot.idleTimeout) : DEFAULT_SNAPSHOT_IDLE_TIMEOUT
 		}
 	};
 };
@@ -69,23 +74,99 @@ const resolveConfig = (config) => {
 */
 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 coldStorage = yield* require_ColdStorage.ColdStorageTag;
+		const hotStorage = yield* require_HotStorage.HotStorageTag;
 		const presenceManager = yield* require_PresenceManager.PresenceManagerTag;
+		const store = yield* effect.Ref.make(effect.HashMap.empty());
+		/**
+		* Get or create a document instance
+		*/
+		const getOrCreateDocument = effect.Effect.fn("engine.document.get-or-create")(function* (documentId) {
+			const current = yield* effect.Ref.get(store);
+			const existing = effect.HashMap.get(current, documentId);
+			if (existing._tag === "Some") {
+				yield* effect.Ref.set(existing.value.lastActivityTime, Date.now());
+				return existing.value.instance;
+			}
+			const instance = yield* require_DocumentInstance.DocumentInstance.make(documentId, {
+				schema: config.schema,
+				initial: config.initial,
+				maxTransactionHistory: resolvedConfig.maxTransactionHistory,
+				snapshot: resolvedConfig.snapshot
+			}, coldStorage, hotStorage);
+			const lastActivityTime = yield* effect.Ref.make(Date.now());
+			yield* effect.Ref.update(store, (map) => effect.HashMap.set(map, documentId, {
+				instance,
+				lastActivityTime
+			}));
+			return instance;
+		});
+		yield* effect.Effect.fn("engine.gc.start")(function* () {
+			yield* effect.Effect.fn("engine.gc.loop")(function* () {
+				const current = yield* effect.Ref.get(store);
+				const now = Date.now();
+				const maxIdleMs = effect.Duration.toMillis(resolvedConfig.maxIdleTime);
+				for (const [documentId, entry] of current) if (now - (yield* effect.Ref.get(entry.lastActivityTime)) >= maxIdleMs) {
+					yield* effect.Effect.catchAll(entry.instance.saveSnapshot(), (e) => effect.Effect.logError("Failed to save snapshot during eviction", {
+						documentId,
+						error: e
+					}));
+					yield* effect.Ref.update(store, (map) => effect.HashMap.remove(map, documentId));
+					yield* effect.Metric.increment(require_Metrics.documentsEvicted);
+					yield* effect.Metric.incrementBy(require_Metrics.documentsActive, -1);
+					yield* effect.Effect.logInfo("Document evicted due to idle timeout", { documentId });
+				}
+			})().pipe(effect.Effect.repeat(effect.Schedule.spaced("1 minute")), effect.Effect.fork);
+		})();
+		yield* effect.Effect.fn("engine.snapshot.fiber.start")(function* () {
+			const idleTimeoutMs = effect.Duration.toMillis(resolvedConfig.snapshot.idleTimeout);
+			if (idleTimeoutMs <= 0) return;
+			yield* effect.Effect.fn("engine.snapshot.loop")(function* () {
+				const current = yield* effect.Ref.get(store);
+				const now = Date.now();
+				for (const [documentId, entry] of current) {
+					if (now - (yield* effect.Ref.get(entry.lastActivityTime)) < idleTimeoutMs) continue;
+					if (!(yield* entry.instance.needsSnapshot())) continue;
+					yield* effect.Effect.catchAll(entry.instance.saveSnapshot(), (e) => effect.Effect.logWarning("Periodic snapshot save failed", {
+						documentId,
+						error: e
+					}));
+					yield* effect.Metric.increment(require_Metrics.storageIdleSnapshots);
+				}
+			})().pipe(effect.Effect.repeat(effect.Schedule.spaced("10 seconds")), effect.Effect.fork);
+		})();
+		yield* effect.Effect.addFinalizer(() => effect.Effect.fn("engine.shutdown")(function* () {
+			const current = yield* effect.Ref.get(store);
+			for (const [documentId, entry] of current) yield* effect.Effect.catchAll(entry.instance.saveSnapshot(), (e) => effect.Effect.logError("Failed to save snapshot during shutdown", {
+				documentId,
+				error: e
+			}));
+			yield* effect.Effect.logInfo("MimicServerEngine shutdown complete");
+		})());
 		return {
-			submit: (documentId, transaction) => documentManager.submit(documentId, transaction),
-			getSnapshot: (documentId) => documentManager.getSnapshot(documentId),
-			subscribe: (documentId) => documentManager.subscribe(documentId),
-			touch: (documentId) => documentManager.touch(documentId),
+			submit: (documentId, transaction) => effect.Effect.gen(function* () {
+				return yield* (yield* getOrCreateDocument(documentId)).submit(transaction);
+			}),
+			getSnapshot: (documentId) => effect.Effect.gen(function* () {
+				return (yield* getOrCreateDocument(documentId)).getSnapshot();
+			}),
+			subscribe: (documentId) => effect.Effect.gen(function* () {
+				const instance = yield* getOrCreateDocument(documentId);
+				return effect.Stream.fromPubSub(instance.pubsub);
+			}),
+			touch: (documentId) => effect.Effect.gen(function* () {
+				const current = yield* effect.Ref.get(store);
+				const existing = effect.HashMap.get(current, documentId);
+				if (existing._tag === "Some") yield* effect.Ref.set(existing.value.lastActivityTime, Date.now());
+			}),
 			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));
+	})).pipe(effect.Layer.provide(require_PresenceManager.layer));
 };
 const MimicServerEngine = {
 	Tag: MimicServerEngineTag,

package/dist/MimicServerEngine.d.cts

@@ -1,14 +1,19 @@
 import { MimicServerEngineConfig, PresenceEntry, PresenceEvent, PresenceSnapshot, ResolvedConfig } from "./Types.cjs";
+import { ColdStorageError, HotStorageError } from "./Errors.cjs";
 import { ServerMessage } from "./Protocol.cjs";
 import { ColdStorageTag } from "./ColdStorage.cjs";
 import { HotStorageTag } from "./HotStorage.cjs";
 import { MimicAuthServiceTag } from "./MimicAuthService.cjs";
-import { SubmitResult } from "./DocumentManager.cjs";
+import { SubmitResult } from "./DocumentInstance.cjs";
 import { Context, Effect, Layer, Scope, Stream } from "effect";
 import { Primitive, Transaction } from "@voidhash/mimic";
 
 //#region src/MimicServerEngine.d.ts
 
+/**
+ * Error type for MimicServerEngine operations
+ */
+type MimicServerEngineError = ColdStorageError | HotStorageError;
 /**
  * MimicServerEngine service interface.
  *
@@ -19,21 +24,24 @@ interface MimicServerEngine {
   /**
    * Submit a transaction to a document.
    * Authorization is checked against the auth service.
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
-  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, never>;
+  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, MimicServerEngineError>;
   /**
    * Get document snapshot (current state and version).
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
   readonly getSnapshot: (documentId: string) => Effect.Effect<{
     state: unknown;
     version: number;
-  }, never>;
+  }, MimicServerEngineError>;
   /**
    * Subscribe to document broadcasts (transactions).
    * Returns a stream of server messages.
    * Requires a Scope for cleanup when the subscription ends.
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
-  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerMessage, never, never>, never, Scope.Scope>;
+  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerMessage, never, never>, MimicServerEngineError, Scope.Scope>;
   /**
    * Touch document to prevent idle garbage collection.
    */

package/dist/MimicServerEngine.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.d.cts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA6FW,UA5CM,iBAAA,CA4CN;EACJ;;;;EAgBiE,SAAM,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAtD7D,WAAA,CAAY,WAsDiD,EAAA,GArDvE,MAAA,CAAO,MAqDgE,CArDzD,YAqDyD,EAAA,KAAA,CAAA;EAAvE;;;EAM0B,SAAA,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GApD1B,MAAA,CAAO,MAoDmB,CAAA;IAChC,KAAA,EAAA,OAAA;;;;;AASD;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,EAAA,KAAA,EA5HkC,KAAA,CAAM,KA4HxC,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"}
+{"version":3,"file":"MimicServerEngine.d.cts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA0FqB,KAvCT,sBAAA,GAAyB,gBAuCT,GAvC4B,eAuC5B;;;;;;;AAoBjB,UA/CM,iBAAA,CA+CN;EACJ;;;;;EAgBA,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAxDG,WAAA,CAAY,WAwDf,EAAA,GAvDP,MAAA,CAAO,MAuDA,CAvDO,YAuDP,EAvDqB,sBAuDrB,CAAA;EAMoB;;;AACjC;gDAtDM,MAAA,CAAO;;;KAA4C;EA+D7C;AA+Tb;;;;;EArOE,SAAA,SAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA/IK,MAAA,CAAO,MA+IZ,CA/ImB,MAAA,CAAO,MA+I1B,CA/IiC,aA+IjC,EAAA,KAAA,EAAA,KAAA,CAAA,EA/IwE,sBA+IxE,EA/IgG,KAAA,CAAM,KA+ItG,CAAA;EAEA;;;EAHC,SAAM,KAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAzIiC,MAAA,CAAO,MAyIxC,CAAA,IAAA,EAAA,KAAA,CAAA;EAAK;;;wDAlIP,MAAA,CAAO,OAAO;;;;0EAQV,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;cA+T7B;;yBAxOwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}

package/dist/MimicServerEngine.d.mts

@@ -1,14 +1,19 @@
 import { MimicServerEngineConfig, PresenceEntry, PresenceEvent, PresenceSnapshot, ResolvedConfig } from "./Types.mjs";
+import { ColdStorageError, HotStorageError } from "./Errors.mjs";
 import { ServerMessage } from "./Protocol.mjs";
 import { ColdStorageTag } from "./ColdStorage.mjs";
 import { HotStorageTag } from "./HotStorage.mjs";
 import { MimicAuthServiceTag } from "./MimicAuthService.mjs";
-import { SubmitResult } from "./DocumentManager.mjs";
+import { SubmitResult } from "./DocumentInstance.mjs";
 import { Context, Effect, Layer, Scope, Stream } from "effect";
 import { Primitive, Transaction } from "@voidhash/mimic";
 
 //#region src/MimicServerEngine.d.ts
 
+/**
+ * Error type for MimicServerEngine operations
+ */
+type MimicServerEngineError = ColdStorageError | HotStorageError;
 /**
  * MimicServerEngine service interface.
  *
@@ -19,21 +24,24 @@ interface MimicServerEngine {
   /**
    * Submit a transaction to a document.
    * Authorization is checked against the auth service.
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
-  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, never>;
+  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult, MimicServerEngineError>;
   /**
    * Get document snapshot (current state and version).
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
   readonly getSnapshot: (documentId: string) => Effect.Effect<{
     state: unknown;
     version: number;
-  }, never>;
+  }, MimicServerEngineError>;
   /**
    * Subscribe to document broadcasts (transactions).
    * Returns a stream of server messages.
    * Requires a Scope for cleanup when the subscription ends.
+   * May fail with MimicServerEngineError if storage is unavailable.
    */
-  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerMessage, never, never>, never, Scope.Scope>;
+  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerMessage, never, never>, MimicServerEngineError, Scope.Scope>;
   /**
    * Touch document to prevent idle garbage collection.
    */

package/dist/MimicServerEngine.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.d.mts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;AA6FW,UA5CM,iBAAA,CA4CN;EACJ;;;;EAgBiE,SAAM,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAtD7D,WAAA,CAAY,WAsDiD,EAAA,GArDvE,MAAA,CAAO,MAqDgE,CArDzD,YAqDyD,EAAA,KAAA,CAAA;EAAvE;;;EAM0B,SAAA,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GApD1B,MAAA,CAAO,MAoDmB,CAAA;IAChC,KAAA,EAAA,OAAA;;;;;AASD;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,EAAA,KAAA,EA5HkC,KAAA,CAAM,KA4HxC,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"}
+{"version":3,"file":"MimicServerEngine.d.mts","names":[],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;AA0FqB,KAvCT,sBAAA,GAAyB,gBAuCT,GAvC4B,eAuC5B;;;;;;;AAoBjB,UA/CM,iBAAA,CA+CN;EACJ;;;;;EAgBA,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EAxDG,WAAA,CAAY,WAwDf,EAAA,GAvDP,MAAA,CAAO,MAuDA,CAvDO,YAuDP,EAvDqB,sBAuDrB,CAAA;EAMoB;;;AACjC;gDAtDM,MAAA,CAAO;;;KAA4C;EA+D7C;AA+Tb;;;;;EArOE,SAAA,SAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GA/IK,MAAA,CAAO,MA+IZ,CA/ImB,MAAA,CAAO,MA+I1B,CA/IiC,aA+IjC,EAAA,KAAA,EAAA,KAAA,CAAA,EA/IwE,sBA+IxE,EA/IgG,KAAA,CAAM,KA+ItG,CAAA;EAEA;;;EAHC,SAAM,KAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GAzIiC,MAAA,CAAO,MAyIxC,CAAA,IAAA,EAAA,KAAA,CAAA;EAAK;;;wDAlIP,MAAA,CAAO,OAAO;;;;0EAQV,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;cA+T7B;;yBAxOwB,SAAA,CAAU,sBACrC,wBAAwB,aAC/B,KAAA,CAAM,MACP,6BAEA,iBAAiB,gBAAgB"}

package/dist/MimicServerEngine.mjs

@@ -1,6 +1,9 @@
-import { DocumentManagerConfigTag, DocumentManagerTag, layer } from "./DocumentManager.mjs";
-import { PresenceManagerTag, layer as layer$1 } from "./PresenceManager.mjs";
-import { Context, Duration, Effect, Layer } from "effect";
+import { ColdStorageTag } from "./ColdStorage.mjs";
+import { HotStorageTag } from "./HotStorage.mjs";
+import { documentsActive, documentsEvicted, storageIdleSnapshots } from "./Metrics.mjs";
+import { DocumentInstance } from "./DocumentInstance.mjs";
+import { PresenceManagerTag, layer } from "./PresenceManager.mjs";
+import { Context, Duration, Effect, HashMap, Layer, Metric, Ref, Schedule, Stream } from "effect";
 
 //#region src/MimicServerEngine.ts
 /**
@@ -19,11 +22,12 @@ const DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);
 const DEFAULT_MAX_TRANSACTION_HISTORY = 1e3;
 const DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);
 const DEFAULT_SNAPSHOT_THRESHOLD = 100;
+const DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);
 /**
 * Resolve configuration with defaults
 */
 const resolveConfig = (config) => {
-	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2;
+	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2, _config$snapshot3;
 	return {
 		schema: config.schema,
 		initial: config.initial,
@@ -32,7 +36,8 @@ const resolveConfig = (config) => {
 		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) ? 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
+			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,
+			idleTimeout: ((_config$snapshot3 = config.snapshot) === null || _config$snapshot3 === void 0 ? void 0 : _config$snapshot3.idleTimeout) ? Duration.decode(config.snapshot.idleTimeout) : DEFAULT_SNAPSHOT_IDLE_TIMEOUT
 		}
 	};
 };
@@ -69,23 +74,99 @@ const resolveConfig = (config) => {
 */
 const make = (config) => {
 	const resolvedConfig = resolveConfig(config);
-	const configLayer = Layer.succeed(DocumentManagerConfigTag, resolvedConfig);
-	const internalLayers = Layer.mergeAll(layer.pipe(Layer.provide(configLayer)), layer$1);
 	return Layer.scoped(MimicServerEngineTag, Effect.gen(function* () {
-		const documentManager = yield* DocumentManagerTag;
+		const coldStorage = yield* ColdStorageTag;
+		const hotStorage = yield* HotStorageTag;
 		const presenceManager = yield* PresenceManagerTag;
+		const store = yield* Ref.make(HashMap.empty());
+		/**
+		* Get or create a document instance
+		*/
+		const getOrCreateDocument = Effect.fn("engine.document.get-or-create")(function* (documentId) {
+			const current = yield* Ref.get(store);
+			const existing = HashMap.get(current, documentId);
+			if (existing._tag === "Some") {
+				yield* Ref.set(existing.value.lastActivityTime, Date.now());
+				return existing.value.instance;
+			}
+			const instance = yield* DocumentInstance.make(documentId, {
+				schema: config.schema,
+				initial: config.initial,
+				maxTransactionHistory: resolvedConfig.maxTransactionHistory,
+				snapshot: resolvedConfig.snapshot
+			}, coldStorage, hotStorage);
+			const lastActivityTime = yield* Ref.make(Date.now());
+			yield* Ref.update(store, (map) => HashMap.set(map, documentId, {
+				instance,
+				lastActivityTime
+			}));
+			return instance;
+		});
+		yield* Effect.fn("engine.gc.start")(function* () {
+			yield* Effect.fn("engine.gc.loop")(function* () {
+				const current = yield* Ref.get(store);
+				const now = Date.now();
+				const maxIdleMs = Duration.toMillis(resolvedConfig.maxIdleTime);
+				for (const [documentId, entry] of current) if (now - (yield* Ref.get(entry.lastActivityTime)) >= maxIdleMs) {
+					yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) => Effect.logError("Failed to save snapshot during eviction", {
+						documentId,
+						error: e
+					}));
+					yield* Ref.update(store, (map) => HashMap.remove(map, documentId));
+					yield* Metric.increment(documentsEvicted);
+					yield* Metric.incrementBy(documentsActive, -1);
+					yield* Effect.logInfo("Document evicted due to idle timeout", { documentId });
+				}
+			})().pipe(Effect.repeat(Schedule.spaced("1 minute")), Effect.fork);
+		})();
+		yield* Effect.fn("engine.snapshot.fiber.start")(function* () {
+			const idleTimeoutMs = Duration.toMillis(resolvedConfig.snapshot.idleTimeout);
+			if (idleTimeoutMs <= 0) return;
+			yield* Effect.fn("engine.snapshot.loop")(function* () {
+				const current = yield* Ref.get(store);
+				const now = Date.now();
+				for (const [documentId, entry] of current) {
+					if (now - (yield* Ref.get(entry.lastActivityTime)) < idleTimeoutMs) continue;
+					if (!(yield* entry.instance.needsSnapshot())) continue;
+					yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) => Effect.logWarning("Periodic snapshot save failed", {
+						documentId,
+						error: e
+					}));
+					yield* Metric.increment(storageIdleSnapshots);
+				}
+			})().pipe(Effect.repeat(Schedule.spaced("10 seconds")), Effect.fork);
+		})();
+		yield* Effect.addFinalizer(() => Effect.fn("engine.shutdown")(function* () {
+			const current = yield* Ref.get(store);
+			for (const [documentId, entry] of current) yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) => Effect.logError("Failed to save snapshot during shutdown", {
+				documentId,
+				error: e
+			}));
+			yield* Effect.logInfo("MimicServerEngine shutdown complete");
+		})());
 		return {
-			submit: (documentId, transaction) => documentManager.submit(documentId, transaction),
-			getSnapshot: (documentId) => documentManager.getSnapshot(documentId),
-			subscribe: (documentId) => documentManager.subscribe(documentId),
-			touch: (documentId) => documentManager.touch(documentId),
+			submit: (documentId, transaction) => Effect.gen(function* () {
+				return yield* (yield* getOrCreateDocument(documentId)).submit(transaction);
+			}),
+			getSnapshot: (documentId) => Effect.gen(function* () {
+				return (yield* getOrCreateDocument(documentId)).getSnapshot();
+			}),
+			subscribe: (documentId) => Effect.gen(function* () {
+				const instance = yield* getOrCreateDocument(documentId);
+				return Stream.fromPubSub(instance.pubsub);
+			}),
+			touch: (documentId) => Effect.gen(function* () {
+				const current = yield* Ref.get(store);
+				const existing = HashMap.get(current, documentId);
+				if (existing._tag === "Some") yield* Ref.set(existing.value.lastActivityTime, Date.now());
+			}),
 			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(Layer.provide(internalLayers));
+	})).pipe(Layer.provide(layer));
 };
 const MimicServerEngine = {
 	Tag: MimicServerEngineTag,

package/dist/MimicServerEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServerEngine.mjs","names":["documentManagerLayer","presenceManagerLayer"],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicServerEngine\n *\n * Core document management service for Mimic real-time collaboration.\n * Handles document lifecycle, storage, presence, and transaction processing.\n *\n * This is the engine layer - for WebSocket routes, use MimicServer.layerHttpLayerRouter().\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  Layer,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type { Presence, Primitive, Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n  ResolvedConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag } from \"./ColdStorage\";\nimport { HotStorageTag } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport {\n  DocumentManagerTag,\n  DocumentManagerConfigTag,\n  layer as documentManagerLayer,\n  type SubmitResult,\n} from \"./DocumentManager\";\nimport {\n  PresenceManagerTag,\n  layer as presenceManagerLayer,\n} from \"./PresenceManager\";\n\n// =============================================================================\n// MimicServerEngine Interface\n// =============================================================================\n\n/**\n * MimicServerEngine service interface.\n *\n * Provides document management operations for Mimic collaboration.\n * Use MimicServer.layerHttpLayerRouter() to create WebSocket routes.\n */\nexport interface MimicServerEngine {\n  /**\n   * Submit a transaction to a document.\n   * Authorization is checked against the auth service.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, never>;\n\n  /**\n   * Get document snapshot (current state and version).\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<{ state: unknown; version: number }, never>;\n\n  /**\n   * Subscribe to document broadcasts (transactions).\n   * Returns a stream of server messages.\n   * Requires a Scope for cleanup when the subscription ends.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<Protocol.ServerMessage, never, never>, never, Scope.Scope>;\n\n  /**\n   * Touch document to prevent idle garbage collection.\n   */\n  readonly touch: (documentId: string) => Effect.Effect<void, never>;\n\n  /**\n   * Get presence snapshot for a document.\n   */\n  readonly getPresenceSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot, never>;\n\n  /**\n   * Set presence for a connection.\n   */\n  readonly setPresence: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Remove presence for a connection.\n   */\n  readonly removePresence: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Requires a Scope for cleanup when the subscription ends.\n   */\n  readonly subscribePresence: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent, never, never>, never, Scope.Scope>;\n\n  /**\n   * Resolved engine configuration.\n   * Used by route layer to access schema, presence config, etc.\n   */\n  readonly config: ResolvedConfig<Primitive.AnyPrimitive>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerEngine\n */\nexport class MimicServerEngineTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicServerEngine\"\n)<MimicServerEngineTag, MimicServerEngine>() {}\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\n\n/**\n * Resolve configuration with defaults\n */\nconst resolveConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): ResolvedConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n  },\n});\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicServerEngine layer.\n *\n * This creates the core document management service. To expose it via WebSocket,\n * use MimicServer.layerHttpLayerRouter().\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\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 */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag\n> => {\n  const resolvedConfig = resolveConfig(config);\n\n  // Create config layer for DocumentManager\n  const configLayer = Layer.succeed(\n    DocumentManagerConfigTag,\n    resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create internal layers\n  const internalLayers = Layer.mergeAll(\n    documentManagerLayer.pipe(Layer.provide(configLayer)),\n    presenceManagerLayer\n  );\n\n  return Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      const documentManager = yield* DocumentManagerTag;\n      const presenceManager = yield* PresenceManagerTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          documentManager.submit(documentId, transaction),\n\n        getSnapshot: (documentId) => documentManager.getSnapshot(documentId),\n\n        subscribe: (documentId) =>\n          documentManager.subscribe(documentId) as Effect.Effect<\n            Stream.Stream<Protocol.ServerMessage, never, never>,\n            never\n          >,\n\n        touch: (documentId) => documentManager.touch(documentId),\n\n        getPresenceSnapshot: (documentId) =>\n          presenceManager.getSnapshot(documentId),\n\n        setPresence: (documentId, connectionId, entry) =>\n          presenceManager.set(documentId, connectionId, entry),\n\n        removePresence: (documentId, connectionId) =>\n          presenceManager.remove(documentId, connectionId),\n\n        subscribePresence: (documentId) =>\n          presenceManager.subscribe(documentId),\n\n        config: resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  ).pipe(Layer.provide(internalLayers));\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicServerEngine = {\n  Tag: MimicServerEngineTag,\n  make,\n};\n\n// =============================================================================\n// Re-export SubmitResult type\n// =============================================================================\n\nexport type { SubmitResult };\n"],"mappings":";;;;;;;;;;;;;;;;AA8HA,IAAa,uBAAb,cAA0C,QAAQ,IAChD,2CACD,EAA2C,CAAC;AAM7C,MAAM,wBAAwB,SAAS,QAAQ,EAAE;AACjD,MAAM,kCAAkC;AACxC,MAAM,4BAA4B,SAAS,QAAQ,EAAE;AACrD,MAAM,6BAA6B;;;;AAKnC,MAAM,iBACJ,WAC4B;;QAAC;EAC7B,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,aAAa,OAAO,cAChB,SAAS,OAAO,OAAO,YAAY,GACnC;EACJ,gDACE,OAAO,8FAAyB;EAClC,UAAU;GACR,+BAAU,OAAO,8EAAU,YACvB,SAAS,OAAO,OAAO,SAAS,SAAS,GACzC;GACJ,oEACE,OAAO,gFAAU,6FAAwB;GAC5C;EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCD,MAAa,QACX,WAKG;CACH,MAAM,iBAAiB,cAAc,OAAO;CAG5C,MAAM,cAAc,MAAM,QACxB,0BACA,eACD;CAGD,MAAM,iBAAiB,MAAM,SAC3BA,MAAqB,KAAK,MAAM,QAAQ,YAAY,CAAC,EACrDC,QACD;AAED,QAAO,MAAM,OACX,sBACA,OAAO,IAAI,aAAa;EACtB,MAAM,kBAAkB,OAAO;EAC/B,MAAM,kBAAkB,OAAO;AA+B/B,SA7BkC;GAChC,SAAS,YAAY,gBACnB,gBAAgB,OAAO,YAAY,YAAY;GAEjD,cAAc,eAAe,gBAAgB,YAAY,WAAW;GAEpE,YAAY,eACV,gBAAgB,UAAU,WAAW;GAKvC,QAAQ,eAAe,gBAAgB,MAAM,WAAW;GAExD,sBAAsB,eACpB,gBAAgB,YAAY,WAAW;GAEzC,cAAc,YAAY,cAAc,UACtC,gBAAgB,IAAI,YAAY,cAAc,MAAM;GAEtD,iBAAiB,YAAY,iBAC3B,gBAAgB,OAAO,YAAY,aAAa;GAElD,oBAAoB,eAClB,gBAAgB,UAAU,WAAW;GAEvC,QAAQ;GACT;GAGD,CACH,CAAC,KAAK,MAAM,QAAQ,eAAe,CAAC;;AAOvC,MAAa,oBAAoB;CAC/B,KAAK;CACL;CACD"}
+{"version":3,"file":"MimicServerEngine.mjs","names":["Metrics.documentsEvicted","Metrics.documentsActive","Metrics.storageIdleSnapshots","presenceManagerLayer"],"sources":["../src/MimicServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicServerEngine\n *\n * Core document management service for Mimic real-time collaboration.\n * Handles document lifecycle, storage, presence, and transaction processing.\n *\n * This is the engine layer - for WebSocket routes, use MimicServer.layerHttpLayerRouter().\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  Ref,\n  Schedule,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type { Primitive, Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n  ResolvedConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag } from \"./ColdStorage\";\nimport { HotStorageTag } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport {\n  DocumentInstance,\n  type SubmitResult,\n  type DocumentInstance as DocumentInstanceType,\n} from \"./DocumentInstance\";\nimport {\n  PresenceManagerTag,\n  layer as presenceManagerLayer,\n} from \"./PresenceManager\";\nimport * as Metrics from \"./Metrics\";\nimport type { ColdStorageError, HotStorageError } from \"./Errors\";\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Error type for MimicServerEngine operations\n */\nexport type MimicServerEngineError = ColdStorageError | HotStorageError;\n\n// =============================================================================\n// MimicServerEngine Interface\n// =============================================================================\n\n/**\n * MimicServerEngine service interface.\n *\n * Provides document management operations for Mimic collaboration.\n * Use MimicServer.layerHttpLayerRouter() to create WebSocket routes.\n */\nexport interface MimicServerEngine {\n  /**\n   * Submit a transaction to a document.\n   * Authorization is checked against the auth service.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, MimicServerEngineError>;\n\n  /**\n   * Get document snapshot (current state and version).\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<{ state: unknown; version: number }, MimicServerEngineError>;\n\n  /**\n   * Subscribe to document broadcasts (transactions).\n   * Returns a stream of server messages.\n   * Requires a Scope for cleanup when the subscription ends.\n   * May fail with MimicServerEngineError if storage is unavailable.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<Protocol.ServerMessage, never, never>, MimicServerEngineError, Scope.Scope>;\n\n  /**\n   * Touch document to prevent idle garbage collection.\n   */\n  readonly touch: (documentId: string) => Effect.Effect<void, never>;\n\n  /**\n   * Get presence snapshot for a document.\n   */\n  readonly getPresenceSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot, never>;\n\n  /**\n   * Set presence for a connection.\n   */\n  readonly setPresence: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Remove presence for a connection.\n   */\n  readonly removePresence: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void, never>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Requires a Scope for cleanup when the subscription ends.\n   */\n  readonly subscribePresence: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent, never, never>, never, Scope.Scope>;\n\n  /**\n   * Resolved engine configuration.\n   * Used by route layer to access schema, presence config, etc.\n   */\n  readonly config: ResolvedConfig<Primitive.AnyPrimitive>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for MimicServerEngine\n */\nexport class MimicServerEngineTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicServerEngine\"\n)<MimicServerEngineTag, MimicServerEngine>() {}\n\n// =============================================================================\n// Default Configuration\n// =============================================================================\n\nconst DEFAULT_MAX_IDLE_TIME = Duration.minutes(5);\nconst DEFAULT_MAX_TRANSACTION_HISTORY = 1000;\nconst DEFAULT_SNAPSHOT_INTERVAL = Duration.minutes(5);\nconst DEFAULT_SNAPSHOT_THRESHOLD = 100;\nconst DEFAULT_SNAPSHOT_IDLE_TIMEOUT = Duration.seconds(30);\n\n/**\n * Resolve configuration with defaults\n */\nconst resolveConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): ResolvedConfig<TSchema> => ({\n  schema: config.schema,\n  initial: config.initial,\n  presence: config.presence,\n  maxIdleTime: config.maxIdleTime\n    ? Duration.decode(config.maxIdleTime)\n    : DEFAULT_MAX_IDLE_TIME,\n  maxTransactionHistory:\n    config.maxTransactionHistory ?? DEFAULT_MAX_TRANSACTION_HISTORY,\n  snapshot: {\n    interval: config.snapshot?.interval\n      ? Duration.decode(config.snapshot.interval)\n      : DEFAULT_SNAPSHOT_INTERVAL,\n    transactionThreshold:\n      config.snapshot?.transactionThreshold ?? DEFAULT_SNAPSHOT_THRESHOLD,\n    idleTimeout: config.snapshot?.idleTimeout\n      ? Duration.decode(config.snapshot.idleTimeout)\n      : DEFAULT_SNAPSHOT_IDLE_TIMEOUT,\n  },\n});\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Store entry for a document instance with last activity time\n */\ninterface StoreEntry<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceType<TSchema>;\n  readonly lastActivityTime: Ref.Ref<number>;\n}\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicServerEngine layer.\n *\n * This creates the core document management service. To expose it via WebSocket,\n * use MimicServer.layerHttpLayerRouter().\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\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 */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag\n> => {\n  const resolvedConfig = resolveConfig(config);\n\n  return Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n      const presenceManager = yield* PresenceManagerTag;\n\n      // Store: documentId -> StoreEntry\n      const store = yield* Ref.make(\n        HashMap.empty<string, StoreEntry<TSchema>>()\n      );\n\n      /**\n       * Get or create a document instance\n       */\n      const getOrCreateDocument = Effect.fn(\"engine.document.get-or-create\")(\n        function* (documentId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n\n          if (existing._tag === \"Some\") {\n            // Update activity time\n            yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            return existing.value.instance;\n          }\n\n          // Create new document instance\n          const instance = yield* DocumentInstance.make(\n            documentId,\n            {\n              schema: config.schema,\n              initial: config.initial,\n              maxTransactionHistory: resolvedConfig.maxTransactionHistory,\n              snapshot: resolvedConfig.snapshot,\n            },\n            coldStorage,\n            hotStorage\n          );\n\n          const lastActivityTime = yield* Ref.make(Date.now());\n\n          // Store it\n          yield* Ref.update(store, (map) =>\n            HashMap.set(map, documentId, { instance, lastActivityTime })\n          );\n\n          return instance;\n        }\n      );\n\n      /**\n       * Start background GC fiber\n       */\n      const startGCFiber = Effect.fn(\"engine.gc.start\")(function* () {\n        const gcLoop = Effect.fn(\"engine.gc.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n          const maxIdleMs = Duration.toMillis(resolvedConfig.maxIdleTime);\n\n          for (const [documentId, entry] of current) {\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            if (now - lastActivity >= maxIdleMs) {\n              // Save final snapshot before eviction (best effort)\n              yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n                Effect.logError(\"Failed to save snapshot during eviction\", {\n                  documentId,\n                  error: e,\n                })\n              );\n\n              // Remove from store\n              yield* Ref.update(store, (map) => HashMap.remove(map, documentId));\n\n              // Track eviction metrics\n              yield* Metric.increment(Metrics.documentsEvicted);\n              yield* Metric.incrementBy(Metrics.documentsActive, -1);\n\n              yield* Effect.logInfo(\"Document evicted due to idle timeout\", {\n                documentId,\n              });\n            }\n          }\n        });\n\n        // Run GC every minute\n        yield* gcLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"1 minute\")),\n          Effect.fork\n        );\n      });\n\n      // Start GC fiber\n      yield* startGCFiber();\n\n      /**\n       * Start background snapshot fiber for idle documents.\n       * This ensures documents with unsnapshot transactions get persisted\n       * even without new transaction activity.\n       */\n      const startSnapshotFiber = Effect.fn(\"engine.snapshot.fiber.start\")(function* () {\n        const idleTimeoutMs = Duration.toMillis(resolvedConfig.snapshot.idleTimeout);\n\n        // Skip if idle snapshots are disabled\n        if (idleTimeoutMs <= 0) {\n          return;\n        }\n\n        const snapshotLoop = Effect.fn(\"engine.snapshot.loop\")(function* () {\n          const current = yield* Ref.get(store);\n          const now = Date.now();\n\n          for (const [documentId, entry] of current) {\n            // Check if document has been idle long enough\n            const lastActivity = yield* Ref.get(entry.lastActivityTime);\n            const idleDuration = now - lastActivity;\n\n            if (idleDuration < idleTimeoutMs) {\n              // Document not idle long enough, skip\n              continue;\n            }\n\n            // Check if document has unsnapshot transactions\n            const needs = yield* entry.instance.needsSnapshot();\n            if (!needs) {\n              continue;\n            }\n\n            // Save snapshot (with error handling)\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logWarning(\"Periodic snapshot save failed\", {\n                documentId,\n                error: e,\n              })\n            );\n\n            // Track metric\n            yield* Metric.increment(Metrics.storageIdleSnapshots);\n          }\n        });\n\n        // Run snapshot check every 10 seconds\n        yield* snapshotLoop().pipe(\n          Effect.repeat(Schedule.spaced(\"10 seconds\")),\n          Effect.fork\n        );\n      });\n\n      // Start snapshot fiber\n      yield* startSnapshotFiber();\n\n      // Cleanup on shutdown\n      yield* Effect.addFinalizer(() =>\n        Effect.fn(\"engine.shutdown\")(function* () {\n          const current = yield* Ref.get(store);\n          for (const [documentId, entry] of current) {\n            // Best effort save - don't fail shutdown if storage is unavailable\n            yield* Effect.catchAll(entry.instance.saveSnapshot(), (e) =>\n              Effect.logError(\"Failed to save snapshot during shutdown\", {\n                documentId,\n                error: e,\n              })\n            );\n          }\n          yield* Effect.logInfo(\"MimicServerEngine shutdown complete\");\n        })()\n      );\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return yield* instance.submit(transaction);\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return instance.getSnapshot();\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const instance = yield* getOrCreateDocument(documentId);\n            return Stream.fromPubSub(instance.pubsub) as Stream.Stream<\n              Protocol.ServerMessage,\n              never,\n              never\n            >;\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const current = yield* Ref.get(store);\n            const existing = HashMap.get(current, documentId);\n            if (existing._tag === \"Some\") {\n              yield* Ref.set(existing.value.lastActivityTime, Date.now());\n            }\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          presenceManager.getSnapshot(documentId),\n\n        setPresence: (documentId, connectionId, entry) =>\n          presenceManager.set(documentId, connectionId, entry),\n\n        removePresence: (documentId, connectionId) =>\n          presenceManager.remove(documentId, connectionId),\n\n        subscribePresence: (documentId) =>\n          presenceManager.subscribe(documentId),\n\n        config: resolvedConfig as ResolvedConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  ).pipe(Layer.provide(presenceManagerLayer));\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicServerEngine = {\n  Tag: MimicServerEngineTag,\n  make,\n};\n\n// =============================================================================\n// Re-export SubmitResult type\n// =============================================================================\n\nexport type { SubmitResult };\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+IA,IAAa,uBAAb,cAA0C,QAAQ,IAChD,2CACD,EAA2C,CAAC;AAM7C,MAAM,wBAAwB,SAAS,QAAQ,EAAE;AACjD,MAAM,kCAAkC;AACxC,MAAM,4BAA4B,SAAS,QAAQ,EAAE;AACrD,MAAM,6BAA6B;AACnC,MAAM,gCAAgC,SAAS,QAAQ,GAAG;;;;AAK1D,MAAM,iBACJ,WAC4B;;QAAC;EAC7B,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,UAAU,OAAO;EACjB,aAAa,OAAO,cAChB,SAAS,OAAO,OAAO,YAAY,GACnC;EACJ,gDACE,OAAO,8FAAyB;EAClC,UAAU;GACR,+BAAU,OAAO,8EAAU,YACvB,SAAS,OAAO,OAAO,SAAS,SAAS,GACzC;GACJ,oEACE,OAAO,gFAAU,6FAAwB;GAC3C,mCAAa,OAAO,gFAAU,eAC1B,SAAS,OAAO,OAAO,SAAS,YAAY,GAC5C;GACL;EACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiDD,MAAa,QACX,WAKG;CACH,MAAM,iBAAiB,cAAc,OAAO;AAE5C,QAAO,MAAM,OACX,sBACA,OAAO,IAAI,aAAa;EACtB,MAAM,cAAc,OAAO;EAC3B,MAAM,aAAa,OAAO;EAC1B,MAAM,kBAAkB,OAAO;EAG/B,MAAM,QAAQ,OAAO,IAAI,KACvB,QAAQ,OAAoC,CAC7C;;;;EAKD,MAAM,sBAAsB,OAAO,GAAG,gCAAgC,CACpE,WAAW,YAAoB;GAC7B,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AAEjD,OAAI,SAAS,SAAS,QAAQ;AAE5B,WAAO,IAAI,IAAI,SAAS,MAAM,kBAAkB,KAAK,KAAK,CAAC;AAC3D,WAAO,SAAS,MAAM;;GAIxB,MAAM,WAAW,OAAO,iBAAiB,KACvC,YACA;IACE,QAAQ,OAAO;IACf,SAAS,OAAO;IAChB,uBAAuB,eAAe;IACtC,UAAU,eAAe;IAC1B,EACD,aACA,WACD;GAED,MAAM,mBAAmB,OAAO,IAAI,KAAK,KAAK,KAAK,CAAC;AAGpD,UAAO,IAAI,OAAO,QAAQ,QACxB,QAAQ,IAAI,KAAK,YAAY;IAAE;IAAU;IAAkB,CAAC,CAC7D;AAED,UAAO;IAEV;AA4CD,SAvCqB,OAAO,GAAG,kBAAkB,CAAC,aAAa;AAgC7D,UA/Be,OAAO,GAAG,iBAAiB,CAAC,aAAa;IACtD,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;IACrC,MAAM,MAAM,KAAK,KAAK;IACtB,MAAM,YAAY,SAAS,SAAS,eAAe,YAAY;AAE/D,SAAK,MAAM,CAAC,YAAY,UAAU,QAEhC,KAAI,OADiB,OAAO,IAAI,IAAI,MAAM,iBAAiB,KACjC,WAAW;AAEnC,YAAO,OAAO,SAAS,MAAM,SAAS,cAAc,GAAG,MACrD,OAAO,SAAS,2CAA2C;MACzD;MACA,OAAO;MACR,CAAC,CACH;AAGD,YAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,OAAO,KAAK,WAAW,CAAC;AAGlE,YAAO,OAAO,UAAUA,iBAAyB;AACjD,YAAO,OAAO,YAAYC,iBAAyB,GAAG;AAEtD,YAAO,OAAO,QAAQ,wCAAwC,EAC5D,YACD,CAAC;;KAGN,EAGa,CAAC,KACd,OAAO,OAAO,SAAS,OAAO,WAAW,CAAC,EAC1C,OAAO,KACR;IACD,EAGmB;AAwDrB,SAjD2B,OAAO,GAAG,8BAA8B,CAAC,aAAa;GAC/E,MAAM,gBAAgB,SAAS,SAAS,eAAe,SAAS,YAAY;AAG5E,OAAI,iBAAiB,EACnB;AAqCF,UAlCqB,OAAO,GAAG,uBAAuB,CAAC,aAAa;IAClE,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;IACrC,MAAM,MAAM,KAAK,KAAK;AAEtB,SAAK,MAAM,CAAC,YAAY,UAAU,SAAS;AAKzC,SAFqB,OADA,OAAO,IAAI,IAAI,MAAM,iBAAiB,IAGxC,cAEjB;AAKF,SAAI,EADU,OAAO,MAAM,SAAS,eAAe,EAEjD;AAIF,YAAO,OAAO,SAAS,MAAM,SAAS,cAAc,GAAG,MACrD,OAAO,WAAW,iCAAiC;MACjD;MACA,OAAO;MACR,CAAC,CACH;AAGD,YAAO,OAAO,UAAUC,qBAA6B;;KAEvD,EAGmB,CAAC,KACpB,OAAO,OAAO,SAAS,OAAO,aAAa,CAAC,EAC5C,OAAO,KACR;IACD,EAGyB;AAG3B,SAAO,OAAO,mBACZ,OAAO,GAAG,kBAAkB,CAAC,aAAa;GACxC,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;AACrC,QAAK,MAAM,CAAC,YAAY,UAAU,QAEhC,QAAO,OAAO,SAAS,MAAM,SAAS,cAAc,GAAG,MACrD,OAAO,SAAS,2CAA2C;IACzD;IACA,OAAO;IACR,CAAC,CACH;AAEH,UAAO,OAAO,QAAQ,sCAAsC;IAC5D,EAAE,CACL;AAiDD,SA/CkC;GAChC,SAAS,YAAY,gBACnB,OAAO,IAAI,aAAa;AAEtB,WAAO,QADU,OAAO,oBAAoB,WAAW,EAChC,OAAO,YAAY;KAC1C;GAEJ,cAAc,eACZ,OAAO,IAAI,aAAa;AAEtB,YADiB,OAAO,oBAAoB,WAAW,EACvC,aAAa;KAC7B;GAEJ,YAAY,eACV,OAAO,IAAI,aAAa;IACtB,MAAM,WAAW,OAAO,oBAAoB,WAAW;AACvD,WAAO,OAAO,WAAW,SAAS,OAAO;KAKzC;GAEJ,QAAQ,eACN,OAAO,IAAI,aAAa;IACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;IACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,QAAI,SAAS,SAAS,OACpB,QAAO,IAAI,IAAI,SAAS,MAAM,kBAAkB,KAAK,KAAK,CAAC;KAE7D;GAEJ,sBAAsB,eACpB,gBAAgB,YAAY,WAAW;GAEzC,cAAc,YAAY,cAAc,UACtC,gBAAgB,IAAI,YAAY,cAAc,MAAM;GAEtD,iBAAiB,YAAY,iBAC3B,gBAAgB,OAAO,YAAY,aAAa;GAElD,oBAAoB,eAClB,gBAAgB,UAAU,WAAW;GAEvC,QAAQ;GACT;GAGD,CACH,CAAC,KAAK,MAAM,QAAQC,MAAqB,CAAC;;AAO7C,MAAa,oBAAoB;CAC/B,KAAK;CACL;CACD"}

package/dist/PresenceManager.cjs

@@ -20,7 +20,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 	/**
 	* Get or create presence state for a document
 	*/
-	const getOrCreateDocumentState = (documentId) => effect.Effect.gen(function* () {
+	const getOrCreateDocumentState = effect.Effect.fn("presence.document-state.get-or-create")(function* (documentId) {
 		const current = yield* effect.Ref.get(store);
 		const existing = effect.HashMap.get(current, documentId);
 		if (existing._tag === "Some") return existing.value;
@@ -33,7 +33,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 		return state;
 	});
 	return {
-		getSnapshot: (documentId) => effect.Effect.gen(function* () {
+		getSnapshot: effect.Effect.fn("presence.snapshot.get")(function* (documentId) {
 			const current = yield* effect.Ref.get(store);
 			const existing = effect.HashMap.get(current, documentId);
 			if (existing._tag === "None") return { presences: {} };
@@ -41,7 +41,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			for (const [id, entry] of existing.value.presences) presences[id] = entry;
 			return { presences };
 		}),
-		set: (documentId, connectionId, entry) => effect.Effect.gen(function* () {
+		set: effect.Effect.fn("presence.set")(function* (documentId, connectionId, entry) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			yield* effect.Ref.update(store, (map) => {
 				const existing = effect.HashMap.get(map, documentId);
@@ -58,7 +58,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			};
 			yield* effect.PubSub.publish(state.pubsub, event);
 		}),
-		remove: (documentId, connectionId) => effect.Effect.gen(function* () {
+		remove: effect.Effect.fn("presence.remove")(function* (documentId, connectionId) {
 			const current = yield* effect.Ref.get(store);
 			const existing = effect.HashMap.get(current, documentId);
 			if (existing._tag === "None") return;
@@ -75,7 +75,7 @@ const layer = effect.Layer.effect(PresenceManagerTag, effect.Effect.gen(function
 			};
 			yield* effect.PubSub.publish(existing.value.pubsub, event);
 		}),
-		subscribe: (documentId) => effect.Effect.gen(function* () {
+		subscribe: effect.Effect.fn("presence.subscribe")(function* (documentId) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			return effect.Stream.fromPubSub(state.pubsub);
 		})

package/dist/PresenceManager.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.d.cts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EAoJa,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EAlLU,aAkLV,EAAA,GAjLM,MAAA,CAAO,MAiLb,CAAA,IAAA,CAAA;;;;iEAzKM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cAoJ3B"}
+{"version":3,"file":"PresenceManager.d.cts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EA8Ja,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EA5LU,aA4LV,EAAA,GA3LM,MAAA,CAAO,MA2Lb,CAAA,IAAA,CAAA;;;;iEAnLM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cA8J3B"}

package/dist/PresenceManager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.d.mts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EAoJa,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EAlLU,aAkLV,EAAA,GAjLM,MAAA,CAAO,MAiLb,CAAA,IAAA,CAAA;;;;iEAzKM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cAoJ3B"}
+{"version":3,"file":"PresenceManager.d.mts","names":[],"sources":["../src/PresenceManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAgEO,UA/BU,eAAA,CA+BH;EAAM;AACnB;;gDA1BM,MAAA,CAAO,OAAO;;;AAmCrB;EA8Ja,SAAA,GAAA,EAAA,CAAA,UAGZ,EAAA,MAAA,EAAA,YAAA,EAAA,MAAA,EAAA,KAAA,EA5LU,aA4LV,EAAA,GA3LM,MAAA,CAAO,MA2Lb,CAAA,IAAA,CAAA;;;;iEAnLM,MAAA,CAAO;;;;;8CAQP,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,uBAAuB,KAAA,CAAM;;cAC/D;;;;cASY,kBAAA,SAA2B,uBAAA;cA8J3B"}

package/dist/PresenceManager.mjs

@@ -20,7 +20,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 	/**
 	* Get or create presence state for a document
 	*/
-	const getOrCreateDocumentState = (documentId) => Effect.gen(function* () {
+	const getOrCreateDocumentState = Effect.fn("presence.document-state.get-or-create")(function* (documentId) {
 		const current = yield* Ref.get(store);
 		const existing = HashMap.get(current, documentId);
 		if (existing._tag === "Some") return existing.value;
@@ -33,7 +33,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 		return state;
 	});
 	return {
-		getSnapshot: (documentId) => Effect.gen(function* () {
+		getSnapshot: Effect.fn("presence.snapshot.get")(function* (documentId) {
 			const current = yield* Ref.get(store);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "None") return { presences: {} };
@@ -41,7 +41,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			for (const [id, entry] of existing.value.presences) presences[id] = entry;
 			return { presences };
 		}),
-		set: (documentId, connectionId, entry) => Effect.gen(function* () {
+		set: Effect.fn("presence.set")(function* (documentId, connectionId, entry) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			yield* Ref.update(store, (map) => {
 				const existing = HashMap.get(map, documentId);
@@ -58,7 +58,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			};
 			yield* PubSub.publish(state.pubsub, event);
 		}),
-		remove: (documentId, connectionId) => Effect.gen(function* () {
+		remove: Effect.fn("presence.remove")(function* (documentId, connectionId) {
 			const current = yield* Ref.get(store);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "None") return;
@@ -75,7 +75,7 @@ const layer = Layer.effect(PresenceManagerTag, Effect.gen(function* () {
 			};
 			yield* PubSub.publish(existing.value.pubsub, event);
 		}),
-		subscribe: (documentId) => Effect.gen(function* () {
+		subscribe: Effect.fn("presence.subscribe")(function* (documentId) {
 			const state = yield* getOrCreateDocumentState(documentId);
 			return Stream.fromPubSub(state.pubsub);
 		})

package/dist/PresenceManager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"PresenceManager.mjs","names":["layer: Layer.Layer<PresenceManagerTag>","state: DocumentPresenceState","presences: Record<string, PresenceEntry>","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent"],"sources":["../src/PresenceManager.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - PresenceManager\n *\n * Internal service for managing presence state per document.\n */\nimport {\n  Context,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type {\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n} from \"./Types\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// PresenceManager Interface\n// =============================================================================\n\n/**\n * Internal service for managing presence state per document.\n *\n * Presence is ephemeral state associated with connections, not persisted.\n * Each document has its own set of presences, keyed by connectionId.\n */\nexport interface PresenceManager {\n  /**\n   * Get snapshot of all presences for a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot>;\n\n  /**\n   * Set/update presence for a connection.\n   */\n  readonly set: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void>;\n\n  /**\n   * Remove presence for a connection (on disconnect).\n   */\n  readonly remove: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Returns a stream of presence update/remove events.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for PresenceManager service\n */\nexport class PresenceManagerTag extends Context.Tag(\n  \"@voidhash/mimic-effect/PresenceManager\"\n)<PresenceManagerTag, PresenceManager>() {}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Per-document presence state\n */\ninterface DocumentPresenceState {\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly pubsub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Layer Implementation\n// =============================================================================\n\n/**\n * Create the PresenceManager layer.\n */\nexport const layer: Layer.Layer<PresenceManagerTag> = Layer.effect(\n  PresenceManagerTag,\n  Effect.gen(function* () {\n    // Store: documentId -> DocumentPresenceState\n    const store = yield* Ref.make(\n      HashMap.empty<string, DocumentPresenceState>()\n    );\n\n    /**\n     * Get or create presence state for a document\n     */\n    const getOrCreateDocumentState = (\n      documentId: string\n    ): Effect.Effect<DocumentPresenceState> =>\n      Effect.gen(function* () {\n        const current = yield* Ref.get(store);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        // Create new state for this document\n        const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n        const state: DocumentPresenceState = {\n          presences: HashMap.empty(),\n          pubsub,\n        };\n\n        yield* Ref.update(store, (map) => HashMap.set(map, documentId, state));\n        return state;\n      });\n\n    return {\n      getSnapshot: (documentId) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") {\n            return { presences: {} };\n          }\n\n          // Convert HashMap to Record\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of existing.value.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }),\n\n      set: (documentId, connectionId, entry) =>\n        Effect.gen(function* () {\n          const state = yield* getOrCreateDocumentState(documentId);\n\n          // Update presence in store\n          yield* Ref.update(store, (map) => {\n            const existing = HashMap.get(map, documentId);\n            if (existing._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...existing.value,\n              presences: HashMap.set(\n                existing.value.presences,\n                connectionId,\n                entry\n              ),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.increment(Metrics.presenceUpdates);\n          yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n          // Broadcast update event\n          const event: PresenceEvent = {\n            type: \"presence_update\",\n            id: connectionId,\n            data: entry.data,\n            userId: entry.userId,\n          };\n          yield* PubSub.publish(state.pubsub, event);\n        }),\n\n      remove: (documentId, connectionId) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") return;\n\n          // Check if presence exists before removing\n          const hasPresence = HashMap.has(existing.value.presences, connectionId);\n          if (!hasPresence) return;\n\n          // Remove presence from store\n          yield* Ref.update(store, (map) => {\n            const docState = HashMap.get(map, documentId);\n            if (docState._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...docState.value,\n              presences: HashMap.remove(docState.value.presences, connectionId),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n          // Broadcast remove event\n          const event: PresenceEvent = {\n            type: \"presence_remove\",\n            id: connectionId,\n          };\n          yield* PubSub.publish(existing.value.pubsub, event);\n        }),\n\n      subscribe: (documentId) =>\n        Effect.gen(function* () {\n          const state = yield* getOrCreateDocumentState(documentId);\n          return Stream.fromPubSub(state.pubsub);\n        }),\n    };\n  })\n);\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const PresenceManager = {\n  Tag: PresenceManagerTag,\n  layer,\n};\n"],"mappings":";;;;;;;;;;;;;AA0EA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,yCACD,EAAuC,CAAC;;;;AAqBzC,MAAaA,QAAyC,MAAM,OAC1D,oBACA,OAAO,IAAI,aAAa;CAEtB,MAAM,QAAQ,OAAO,IAAI,KACvB,QAAQ,OAAsC,CAC/C;;;;CAKD,MAAM,4BACJ,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;EACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,MAAI,SAAS,SAAS,OACpB,QAAO,SAAS;EAIlB,MAAM,SAAS,OAAO,OAAO,WAA0B;EACvD,MAAMC,QAA+B;GACnC,WAAW,QAAQ,OAAO;GAC1B;GACD;AAED,SAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AACtE,SAAO;GACP;AAEJ,QAAO;EACL,cAAc,eACZ,OAAO,IAAI,aAAa;GACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OACpB,QAAO,EAAE,WAAW,EAAE,EAAE;GAI1B,MAAMC,YAA2C,EAAE;AACnD,QAAK,MAAM,CAAC,IAAI,UAAU,SAAS,MAAM,UACvC,WAAU,MAAM;AAElB,UAAO,EAAE,WAAW;IACpB;EAEJ,MAAM,YAAY,cAAc,UAC9B,OAAO,IAAI,aAAa;GACtB,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AAGzD,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,IACjB,SAAS,MAAM,WACf,cACA,MACD,IACD;KACF;AAGF,UAAO,OAAO,UAAUC,gBAAwB;AAChD,UAAO,OAAO,YAAYC,gBAAwB,EAAE;GAGpD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACJ,MAAM,MAAM;IACZ,QAAQ,MAAM;IACf;AACD,UAAO,OAAO,QAAQ,MAAM,QAAQ,MAAM;IAC1C;EAEJ,SAAS,YAAY,iBACnB,OAAO,IAAI,aAAa;GACtB,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OAAQ;AAI9B,OAAI,CADgB,QAAQ,IAAI,SAAS,MAAM,WAAW,aAAa,CACrD;AAGlB,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,OAAO,SAAS,MAAM,WAAW,aAAa,IACjE;KACF;AAGF,UAAO,OAAO,YAAYD,gBAAwB,GAAG;GAGrD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACL;AACD,UAAO,OAAO,QAAQ,SAAS,MAAM,QAAQ,MAAM;IACnD;EAEJ,YAAY,eACV,OAAO,IAAI,aAAa;GACtB,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AACzD,UAAO,OAAO,WAAW,MAAM,OAAO;IACtC;EACL;EACD,CACH;AAMD,MAAa,kBAAkB;CAC7B,KAAK;CACL;CACD"}
+{"version":3,"file":"PresenceManager.mjs","names":["layer: Layer.Layer<PresenceManagerTag>","state: DocumentPresenceState","presences: Record<string, PresenceEntry>","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent"],"sources":["../src/PresenceManager.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - PresenceManager\n *\n * Internal service for managing presence state per document.\n */\nimport {\n  Context,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Scope,\n  Stream,\n} from \"effect\";\nimport type {\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n} from \"./Types\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// PresenceManager Interface\n// =============================================================================\n\n/**\n * Internal service for managing presence state per document.\n *\n * Presence is ephemeral state associated with connections, not persisted.\n * Each document has its own set of presences, keyed by connectionId.\n */\nexport interface PresenceManager {\n  /**\n   * Get snapshot of all presences for a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<PresenceSnapshot>;\n\n  /**\n   * Set/update presence for a connection.\n   */\n  readonly set: (\n    documentId: string,\n    connectionId: string,\n    entry: PresenceEntry\n  ) => Effect.Effect<void>;\n\n  /**\n   * Remove presence for a connection (on disconnect).\n   */\n  readonly remove: (\n    documentId: string,\n    connectionId: string\n  ) => Effect.Effect<void>;\n\n  /**\n   * Subscribe to presence events for a document.\n   * Returns a stream of presence update/remove events.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<PresenceEvent>, never, Scope.Scope>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for PresenceManager service\n */\nexport class PresenceManagerTag extends Context.Tag(\n  \"@voidhash/mimic-effect/PresenceManager\"\n)<PresenceManagerTag, PresenceManager>() {}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Per-document presence state\n */\ninterface DocumentPresenceState {\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly pubsub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Layer Implementation\n// =============================================================================\n\n/**\n * Create the PresenceManager layer.\n */\nexport const layer: Layer.Layer<PresenceManagerTag> = Layer.effect(\n  PresenceManagerTag,\n  Effect.gen(function* () {\n    // Store: documentId -> DocumentPresenceState\n    const store = yield* Ref.make(\n      HashMap.empty<string, DocumentPresenceState>()\n    );\n\n    /**\n     * Get or create presence state for a document\n     */\n    const getOrCreateDocumentState = Effect.fn(\n      \"presence.document-state.get-or-create\"\n    )(function* (documentId: string) {\n      const current = yield* Ref.get(store);\n      const existing = HashMap.get(current, documentId);\n      if (existing._tag === \"Some\") {\n        return existing.value;\n      }\n\n      // Create new state for this document\n      const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n      const state: DocumentPresenceState = {\n        presences: HashMap.empty(),\n        pubsub,\n      };\n\n      yield* Ref.update(store, (map) => HashMap.set(map, documentId, state));\n      return state;\n    });\n\n    return {\n      getSnapshot: Effect.fn(\"presence.snapshot.get\")(\n        function* (documentId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") {\n            return { presences: {} };\n          }\n\n          // Convert HashMap to Record\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of existing.value.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }\n      ),\n\n      set: Effect.fn(\"presence.set\")(\n        function* (\n          documentId: string,\n          connectionId: string,\n          entry: PresenceEntry\n        ) {\n          const state = yield* getOrCreateDocumentState(documentId);\n\n          // Update presence in store\n          yield* Ref.update(store, (map) => {\n            const existing = HashMap.get(map, documentId);\n            if (existing._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...existing.value,\n              presences: HashMap.set(\n                existing.value.presences,\n                connectionId,\n                entry\n              ),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.increment(Metrics.presenceUpdates);\n          yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n          // Broadcast update event\n          const event: PresenceEvent = {\n            type: \"presence_update\",\n            id: connectionId,\n            data: entry.data,\n            userId: entry.userId,\n          };\n          yield* PubSub.publish(state.pubsub, event);\n        }\n      ),\n\n      remove: Effect.fn(\"presence.remove\")(\n        function* (documentId: string, connectionId: string) {\n          const current = yield* Ref.get(store);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"None\") return;\n\n          // Check if presence exists before removing\n          const hasPresence = HashMap.has(\n            existing.value.presences,\n            connectionId\n          );\n          if (!hasPresence) return;\n\n          // Remove presence from store\n          yield* Ref.update(store, (map) => {\n            const docState = HashMap.get(map, documentId);\n            if (docState._tag === \"None\") return map;\n            return HashMap.set(map, documentId, {\n              ...docState.value,\n              presences: HashMap.remove(docState.value.presences, connectionId),\n            });\n          });\n\n          // Track metrics\n          yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n          // Broadcast remove event\n          const event: PresenceEvent = {\n            type: \"presence_remove\",\n            id: connectionId,\n          };\n          yield* PubSub.publish(existing.value.pubsub, event);\n        }\n      ),\n\n      subscribe: Effect.fn(\"presence.subscribe\")(\n        function* (documentId: string) {\n          const state = yield* getOrCreateDocumentState(documentId);\n          return Stream.fromPubSub(state.pubsub);\n        }\n      ),\n    };\n  })\n);\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const PresenceManager = {\n  Tag: PresenceManagerTag,\n  layer,\n};\n"],"mappings":";;;;;;;;;;;;;AA0EA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,yCACD,EAAuC,CAAC;;;;AAqBzC,MAAaA,QAAyC,MAAM,OAC1D,oBACA,OAAO,IAAI,aAAa;CAEtB,MAAM,QAAQ,OAAO,IAAI,KACvB,QAAQ,OAAsC,CAC/C;;;;CAKD,MAAM,2BAA2B,OAAO,GACtC,wCACD,CAAC,WAAW,YAAoB;EAC/B,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;EACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,MAAI,SAAS,SAAS,OACpB,QAAO,SAAS;EAIlB,MAAM,SAAS,OAAO,OAAO,WAA0B;EACvD,MAAMC,QAA+B;GACnC,WAAW,QAAQ,OAAO;GAC1B;GACD;AAED,SAAO,IAAI,OAAO,QAAQ,QAAQ,QAAQ,IAAI,KAAK,YAAY,MAAM,CAAC;AACtE,SAAO;GACP;AAEF,QAAO;EACL,aAAa,OAAO,GAAG,wBAAwB,CAC7C,WAAW,YAAoB;GAC7B,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OACpB,QAAO,EAAE,WAAW,EAAE,EAAE;GAI1B,MAAMC,YAA2C,EAAE;AACnD,QAAK,MAAM,CAAC,IAAI,UAAU,SAAS,MAAM,UACvC,WAAU,MAAM;AAElB,UAAO,EAAE,WAAW;IAEvB;EAED,KAAK,OAAO,GAAG,eAAe,CAC5B,WACE,YACA,cACA,OACA;GACA,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AAGzD,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,IACjB,SAAS,MAAM,WACf,cACA,MACD,IACD;KACF;AAGF,UAAO,OAAO,UAAUC,gBAAwB;AAChD,UAAO,OAAO,YAAYC,gBAAwB,EAAE;GAGpD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACJ,MAAM,MAAM;IACZ,QAAQ,MAAM;IACf;AACD,UAAO,OAAO,QAAQ,MAAM,QAAQ,MAAM;IAE7C;EAED,QAAQ,OAAO,GAAG,kBAAkB,CAClC,WAAW,YAAoB,cAAsB;GACnD,MAAM,UAAU,OAAO,IAAI,IAAI,MAAM;GACrC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AACjD,OAAI,SAAS,SAAS,OAAQ;AAO9B,OAAI,CAJgB,QAAQ,IAC1B,SAAS,MAAM,WACf,aACD,CACiB;AAGlB,UAAO,IAAI,OAAO,QAAQ,QAAQ;IAChC,MAAM,WAAW,QAAQ,IAAI,KAAK,WAAW;AAC7C,QAAI,SAAS,SAAS,OAAQ,QAAO;AACrC,WAAO,QAAQ,IAAI,KAAK,8CACnB,SAAS,cACZ,WAAW,QAAQ,OAAO,SAAS,MAAM,WAAW,aAAa,IACjE;KACF;AAGF,UAAO,OAAO,YAAYD,gBAAwB,GAAG;GAGrD,MAAMC,QAAuB;IAC3B,MAAM;IACN,IAAI;IACL;AACD,UAAO,OAAO,QAAQ,SAAS,MAAM,QAAQ,MAAM;IAEtD;EAED,WAAW,OAAO,GAAG,qBAAqB,CACxC,WAAW,YAAoB;GAC7B,MAAM,QAAQ,OAAO,yBAAyB,WAAW;AACzD,UAAO,OAAO,WAAW,MAAM,OAAO;IAEzC;EACF;EACD,CACH;AAMD,MAAa,kBAAkB;CAC7B,KAAK;CACL;CACD"}