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

package/dist/MimicClusterServerEngine.mjs

@@ -1,11 +1,11 @@
 import { __require } from "./_virtual/rolldown_runtime.mjs";
 import { ColdStorageTag } from "./ColdStorage.mjs";
 import { HotStorageTag } from "./HotStorage.mjs";
-import { documentsActive, documentsCreated, documentsEvicted, documentsRestored, presenceActive, presenceUpdates, storageSnapshotLatency, storageSnapshots, storageWalAppends, transactionsLatency, transactionsProcessed, transactionsRejected } from "./Metrics.mjs";
+import { documentsActive, documentsEvicted, presenceActive, presenceUpdates, storageIdleSnapshots } from "./Metrics.mjs";
+import { DocumentInstance } from "./DocumentInstance.mjs";
 import { _objectSpread2 } from "./_virtual/_@oxc-project_runtime@0.103.0/helpers/objectSpread2.mjs";
 import { MimicServerEngineTag } from "./MimicServerEngine.mjs";
-import { Context, Duration, Effect, HashMap, Layer, Metric, PubSub, Ref, Schema, Stream } from "effect";
-import { ServerDocument } from "@voidhash/mimic/server";
+import { Context, Duration, Effect, HashMap, Layer, Metric, PubSub, Ref, Schedule, Schema, Stream } from "effect";
 import { Entity } from "@effect/cluster";
 import { Rpc } from "@effect/rpc";
 
@@ -22,6 +22,7 @@ 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);
 const DEFAULT_SHARD_GROUP = "mimic-documents";
 /**
 * Schema for encoded transaction (wire format)
@@ -100,7 +101,7 @@ const MimicDocumentEntity = Entity.make("MimicDocument", [
 */
 var MimicClusterConfigTag = class extends Context.Tag("@voidhash/mimic-effect/MimicClusterConfig")() {};
 const resolveClusterConfig = (config) => {
-	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2, _config$shardGroup;
+	var _config$maxTransactio, _config$snapshot, _config$snapshot$tran, _config$snapshot2, _config$snapshot3, _config$shardGroup;
 	return {
 		schema: config.schema,
 		initial: config.initial,
@@ -109,7 +110,8 @@ const resolveClusterConfig = (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
 		},
 		shardGroup: (_config$shardGroup = config.shardGroup) !== null && _config$shardGroup !== void 0 ? _config$shardGroup : DEFAULT_SHARD_GROUP
 	};
@@ -131,150 +133,53 @@ const encodeTransaction = (tx) => {
 /**
 * Create the entity handler for MimicDocument
 */
-const createEntityHandler = (config, coldStorage, hotStorage) => Effect.gen(function* () {
+const createEntityHandler = (config, coldStorage, hotStorage) => Effect.fn("cluster.entity.handler.create")(function* () {
 	const documentId = (yield* Entity.CurrentAddress).entityId;
-	const SCHEMA_VERSION = 1;
-	const computeInitialState = () => {
-		if (config.initial === void 0) return Effect.succeed(void 0);
-		if (typeof config.initial === "function") return config.initial({ documentId });
-		return Effect.succeed(config.initial);
-	};
-	const storedDoc = yield* Effect.catchAll(coldStorage.load(documentId), () => Effect.succeed(void 0));
-	let initialState;
-	let initialVersion = 0;
-	if (storedDoc) {
-		initialState = storedDoc.state;
-		initialVersion = storedDoc.version;
-	} else initialState = yield* computeInitialState();
-	const broadcastPubSub = yield* PubSub.unbounded();
+	const instance = yield* DocumentInstance.make(documentId, {
+		schema: config.schema,
+		initial: config.initial,
+		maxTransactionHistory: config.maxTransactionHistory,
+		snapshot: config.snapshot
+	}, coldStorage, hotStorage).pipe(Effect.orDie);
 	const presencePubSub = yield* PubSub.unbounded();
 	const stateRef = yield* Ref.make({
-		document: void 0,
-		broadcastPubSub,
+		instance,
 		presences: HashMap.empty(),
-		presencePubSub,
-		lastSnapshotVersion: initialVersion,
-		lastSnapshotTime: Date.now(),
-		transactionsSinceSnapshot: 0
-	});
-	const document = ServerDocument.make({
-		schema: config.schema,
-		initialState,
-		initialVersion,
-		maxTransactionHistory: config.maxTransactionHistory,
-		onBroadcast: (message) => {
-			Effect.runSync(PubSub.publish(broadcastPubSub, {
-				type: "transaction",
-				transaction: message.transaction,
-				version: message.version
-			}));
-		},
-		onRejection: (transactionId, reason) => {
-			Effect.runSync(PubSub.publish(broadcastPubSub, {
-				type: "error",
-				transactionId,
-				reason
-			}));
-		}
+		presencePubSub
 	});
-	yield* Ref.update(stateRef, (s) => _objectSpread2(_objectSpread2({}, s), {}, { document }));
-	const walEntries = yield* Effect.catchAll(hotStorage.getEntries(documentId, initialVersion), () => Effect.succeed([]));
-	for (const entry of walEntries) {
-		const result = document.submit(entry.transaction);
-		if (!result.success) yield* Effect.logWarning("Skipping corrupted WAL entry", {
-			documentId,
-			version: entry.version,
-			reason: result.reason
-		});
-	}
-	if (storedDoc) yield* Metric.increment(documentsRestored);
-	else yield* Metric.increment(documentsCreated);
-	yield* Metric.incrementBy(documentsActive, 1);
-	/**
-	* Save snapshot to ColdStorage
-	*/
-	const saveSnapshot = Effect.gen(function* () {
-		const state = yield* Ref.get(stateRef);
-		const docState = state.document.get();
-		const version = state.document.getVersion();
-		if (docState === void 0) return;
-		const storedDocument = {
-			state: docState,
-			version,
-			schemaVersion: SCHEMA_VERSION,
-			savedAt: Date.now()
-		};
-		const snapshotStartTime = Date.now();
-		yield* Effect.catchAll(coldStorage.save(documentId, storedDocument), (e) => Effect.logError("Failed to save snapshot", {
-			documentId,
-			error: e
-		}));
-		const snapshotDuration = Date.now() - snapshotStartTime;
-		yield* Metric.increment(storageSnapshots);
-		yield* Metric.update(storageSnapshotLatency, snapshotDuration);
-		yield* Effect.catchAll(hotStorage.truncate(documentId, version), (e) => Effect.logError("Failed to truncate WAL", {
+	yield* Effect.addFinalizer(() => Effect.fn("cluster.entity.finalize")(function* () {
+		yield* Effect.catchAll(instance.saveSnapshot(), (e) => Effect.logError("Failed to save snapshot during entity finalization", {
 			documentId,
 			error: e
 		}));
-		yield* Ref.update(stateRef, (s) => _objectSpread2(_objectSpread2({}, s), {}, {
-			lastSnapshotVersion: version,
-			lastSnapshotTime: Date.now(),
-			transactionsSinceSnapshot: 0
-		}));
-	});
-	/**
-	* Check if snapshot should be triggered
-	*/
-	const checkSnapshotTriggers = Effect.gen(function* () {
-		const state = yield* Ref.get(stateRef);
-		const now = Date.now();
-		const intervalMs = Duration.toMillis(config.snapshot.interval);
-		const threshold = config.snapshot.transactionThreshold;
-		if (state.transactionsSinceSnapshot >= threshold) {
-			yield* saveSnapshot;
-			return;
-		}
-		if (now - state.lastSnapshotTime >= intervalMs) {
-			yield* saveSnapshot;
-			return;
-		}
-	});
-	yield* Effect.addFinalizer(() => Effect.gen(function* () {
-		yield* saveSnapshot;
 		yield* Metric.incrementBy(documentsActive, -1);
 		yield* Metric.increment(documentsEvicted);
 		yield* Effect.logDebug("Entity finalized", { documentId });
-	}));
+	})());
+	if (Duration.toMillis(config.snapshot.idleTimeout) > 0) yield* Effect.fn("cluster.entity.snapshot.loop")(function* () {
+		if (yield* instance.needsSnapshot()) {
+			yield* Effect.catchAll(instance.saveSnapshot(), (e) => Effect.logWarning("Periodic snapshot failed in cluster entity", {
+				documentId,
+				error: e
+			}));
+			yield* Metric.increment(storageIdleSnapshots);
+		}
+	})().pipe(Effect.repeat(Schedule.spaced(config.snapshot.idleTimeout)), Effect.fork);
 	return {
-		Submit: Effect.fnUntraced(function* ({ payload }) {
-			const submitStartTime = Date.now();
-			const state = yield* Ref.get(stateRef);
+		Submit: Effect.fn("cluster.document.transaction.submit")(function* ({ payload }) {
 			const transaction = decodeTransaction(payload.transaction);
-			const result = state.document.submit(transaction);
-			const latency = Date.now() - submitStartTime;
-			yield* Metric.update(transactionsLatency, latency);
-			if (result.success) {
-				yield* Metric.increment(transactionsProcessed);
-				const walEntry = {
-					transaction,
-					version: result.version,
-					timestamp: Date.now()
-				};
-				yield* Effect.catchAll(hotStorage.append(documentId, walEntry), (e) => Effect.logError("Failed to append to WAL", {
-					documentId,
-					error: e
-				}));
-				yield* Metric.increment(storageWalAppends);
-				yield* Ref.update(stateRef, (s) => _objectSpread2(_objectSpread2({}, s), {}, { transactionsSinceSnapshot: s.transactionsSinceSnapshot + 1 }));
-				yield* checkSnapshotTriggers;
-			} else yield* Metric.increment(transactionsRejected);
-			return result;
+			return yield* instance.submit(transaction).pipe(Effect.catchAll((error) => Effect.succeed({
+				success: false,
+				reason: `Storage error: ${String(error)}`
+			})));
 		}),
-		GetSnapshot: Effect.fnUntraced(function* () {
-			return (yield* Ref.get(stateRef)).document.getSnapshot();
+		GetSnapshot: Effect.fn("cluster.document.snapshot.get")(function* () {
+			return instance.getSnapshot();
 		}),
-		Touch: Effect.fnUntraced(function* () {}),
-		SetPresence: Effect.fnUntraced(function* ({ payload }) {
+		Touch: Effect.fn("cluster.document.touch")(function* () {
+			yield* instance.touch();
+		}),
+		SetPresence: Effect.fn("cluster.presence.set")(function* ({ payload }) {
 			const { connectionId, entry } = payload;
 			yield* Ref.update(stateRef, (s) => _objectSpread2(_objectSpread2({}, s), {}, { presences: HashMap.set(s.presences, connectionId, entry) }));
 			yield* Metric.increment(presenceUpdates);
@@ -288,7 +193,7 @@ const createEntityHandler = (config, coldStorage, hotStorage) => Effect.gen(func
 			};
 			yield* PubSub.publish(state.presencePubSub, event);
 		}),
-		RemovePresence: Effect.fnUntraced(function* ({ payload }) {
+		RemovePresence: Effect.fn("cluster.presence.remove")(function* ({ payload }) {
 			const { connectionId } = payload;
 			const state = yield* Ref.get(stateRef);
 			if (!HashMap.has(state.presences, connectionId)) return;
@@ -300,20 +205,20 @@ const createEntityHandler = (config, coldStorage, hotStorage) => Effect.gen(func
 			};
 			yield* PubSub.publish(state.presencePubSub, event);
 		}),
-		GetPresenceSnapshot: Effect.fnUntraced(function* () {
+		GetPresenceSnapshot: Effect.fn("cluster.presence.snapshot.get")(function* () {
 			const state = yield* Ref.get(stateRef);
 			const presences = {};
 			for (const [id, entry] of state.presences) presences[id] = entry;
 			return { presences };
 		})
 	};
-});
+})();
 var SubscriptionStoreTag = class extends Context.Tag("@voidhash/mimic-effect/SubscriptionStore")() {};
-const subscriptionStoreLayer = Layer.effect(SubscriptionStoreTag, Effect.gen(function* () {
+const subscriptionStoreLayer = Layer.effect(SubscriptionStoreTag, Effect.fn("cluster.subscriptions.layer.create")(function* () {
 	const documentPubSubs = yield* Ref.make(HashMap.empty());
 	const presencePubSubs = yield* Ref.make(HashMap.empty());
 	return {
-		getOrCreatePubSub: (documentId) => Effect.gen(function* () {
+		getOrCreatePubSub: Effect.fn("cluster.subscriptions.pubsub.get-or-create")(function* (documentId) {
 			const current = yield* Ref.get(documentPubSubs);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "Some") return existing.value;
@@ -321,7 +226,7 @@ const subscriptionStoreLayer = Layer.effect(SubscriptionStoreTag, Effect.gen(fun
 			yield* Ref.update(documentPubSubs, (map) => HashMap.set(map, documentId, pubsub));
 			return pubsub;
 		}),
-		getOrCreatePresencePubSub: (documentId) => Effect.gen(function* () {
+		getOrCreatePresencePubSub: Effect.fn("cluster.subscriptions.presence-pubsub.get-or-create")(function* (documentId) {
 			const current = yield* Ref.get(presencePubSubs);
 			const existing = HashMap.get(current, documentId);
 			if (existing._tag === "Some") return existing.value;
@@ -330,7 +235,7 @@ const subscriptionStoreLayer = Layer.effect(SubscriptionStoreTag, Effect.gen(fun
 			return pubsub;
 		})
 	};
-}));
+})());
 /**
 * Create a MimicClusterServerEngine layer.
 *

package/dist/MimicClusterServerEngine.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"MimicClusterServerEngine.mjs","names":["initialState: Primitive.InferSetInput<TSchema> | undefined","Metrics.documentsRestored","Metrics.documentsCreated","Metrics.documentsActive","storedDocument: StoredDocument","Metrics.storageSnapshots","Metrics.storageSnapshotLatency","Metrics.documentsEvicted","Metrics.transactionsLatency","Metrics.transactionsProcessed","walEntry: WalEntry","Metrics.storageWalAppends","Metrics.transactionsRejected","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent","presences: Record<string, PresenceEntry>"],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicClusterServerEngine\n *\n * Clustered document management service using Effect Cluster for horizontal scaling.\n * Each document becomes a cluster Entity with automatic sharding, failover, and location-transparent routing.\n *\n * This is an alternative to MimicServerEngine for distributed deployments.\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  Option,\n  PubSub,\n  Ref,\n  Schema,\n  Scope,\n  Stream,\n} from \"effect\";\nimport { Entity, Sharding } from \"@effect/cluster\";\nimport { Rpc } from \"@effect/rpc\";\nimport type { Presence, Primitive, Transaction } from \"@voidhash/mimic\";\nimport { ServerDocument } from \"@voidhash/mimic/server\";\nimport type {\n  MimicClusterServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  PresenceSnapshot,\n  ResolvedClusterConfig,\n  StoredDocument,\n  WalEntry,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag, type ColdStorage } from \"./ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport { MimicServerEngineTag, type MimicServerEngine } from \"./MimicServerEngine\";\nimport type { SubmitResult } from \"./DocumentManager\";\nimport * as Metrics from \"./Metrics\";\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_SHARD_GROUP = \"mimic-documents\";\n\n// =============================================================================\n// RPC Schemas\n// =============================================================================\n\n/**\n * Schema for encoded transaction (wire format)\n */\nconst EncodedTransactionSchema = Schema.Struct({\n  id: Schema.String,\n  ops: Schema.Array(Schema.Unknown),\n});\n\n/**\n * Schema for submit result\n */\nconst SubmitResultSchema = Schema.Union(\n  Schema.Struct({\n    success: Schema.Literal(true),\n    version: Schema.Number,\n  }),\n  Schema.Struct({\n    success: Schema.Literal(false),\n    reason: Schema.String,\n  })\n);\n\n/**\n * Schema for snapshot response\n */\nconst SnapshotResponseSchema = Schema.Struct({\n  state: Schema.Unknown,\n  version: Schema.Number,\n});\n\n/**\n * Schema for presence entry\n */\nconst PresenceEntrySchema = Schema.Struct({\n  data: Schema.Unknown,\n  userId: Schema.optional(Schema.String),\n});\n\n/**\n * Schema for presence snapshot response\n */\nconst PresenceSnapshotResponseSchema = Schema.Struct({\n  presences: Schema.Record({ key: Schema.String, value: PresenceEntrySchema }),\n});\n\n/**\n * Schema for presence event\n */\nconst PresenceEventSchema = Schema.Union(\n  Schema.Struct({\n    type: Schema.Literal(\"presence_update\"),\n    id: Schema.String,\n    data: Schema.Unknown,\n    userId: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"presence_remove\"),\n    id: Schema.String,\n  })\n);\n\n/**\n * Schema for server message (for broadcasts)\n */\nconst ServerMessageSchema = Schema.Unknown;\n\n// =============================================================================\n// Mimic Document Entity Definition\n// =============================================================================\n\n/**\n * Define the Mimic Document Entity with its RPC protocol.\n * This entity handles document operations for a single documentId.\n */\nconst MimicDocumentEntity = Entity.make(\"MimicDocument\", [\n  // Submit a transaction\n  Rpc.make(\"Submit\", {\n    payload: { transaction: EncodedTransactionSchema },\n    success: SubmitResultSchema,\n  }),\n\n  // Get document snapshot\n  Rpc.make(\"GetSnapshot\", {\n    success: SnapshotResponseSchema,\n  }),\n\n  // Touch document to prevent idle GC\n  Rpc.make(\"Touch\", {\n    success: Schema.Void,\n  }),\n\n  // Set presence for a connection\n  Rpc.make(\"SetPresence\", {\n    payload: {\n      connectionId: Schema.String,\n      entry: PresenceEntrySchema,\n    },\n    success: Schema.Void,\n  }),\n\n  // Remove presence for a connection\n  Rpc.make(\"RemovePresence\", {\n    payload: { connectionId: Schema.String },\n    success: Schema.Void,\n  }),\n\n  // Get presence snapshot\n  Rpc.make(\"GetPresenceSnapshot\", {\n    success: PresenceSnapshotResponseSchema,\n  }),\n]);\n\n// =============================================================================\n// Entity State Types\n// =============================================================================\n\n/**\n * Document state managed by the entity\n */\ninterface EntityDocumentState<TSchema extends Primitive.AnyPrimitive> {\n  readonly document: ServerDocument.ServerDocument<TSchema>;\n  readonly broadcastPubSub: PubSub.PubSub<Protocol.ServerMessage>;\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly presencePubSub: PubSub.PubSub<PresenceEvent>;\n  readonly lastSnapshotVersion: number;\n  readonly lastSnapshotTime: number;\n  readonly transactionsSinceSnapshot: number;\n}\n\n// =============================================================================\n// Config Context Tag\n// =============================================================================\n\n/**\n * Context tag for cluster engine configuration\n */\nclass MimicClusterConfigTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicClusterConfig\"\n)<MimicClusterConfigTag, ResolvedClusterConfig<Primitive.AnyPrimitive>>() {}\n\n// =============================================================================\n// Resolve Configuration\n// =============================================================================\n\nconst resolveClusterConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): ResolvedClusterConfig<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  shardGroup: config.shardGroup ?? DEFAULT_SHARD_GROUP,\n});\n\n// =============================================================================\n// Helper to decode/encode transactions\n// =============================================================================\n\n/**\n * Decode an encoded transaction to a Transaction object\n */\nconst decodeTransaction = (\n  encoded: { id: string; ops: readonly unknown[] }\n): Transaction.Transaction => {\n  // Import Transaction dynamically to avoid circular deps\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.decode(encoded as Transaction.EncodedTransaction);\n};\n\n/**\n * Encode a Transaction to wire format\n */\nconst encodeTransaction = (\n  tx: Transaction.Transaction\n): { id: string; ops: readonly unknown[] } => {\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.encode(tx);\n};\n\n// =============================================================================\n// Entity Handler Factory\n// =============================================================================\n\n/**\n * Create the entity handler for MimicDocument\n */\nconst createEntityHandler = <TSchema extends Primitive.AnyPrimitive>(\n  config: ResolvedClusterConfig<TSchema>,\n  coldStorage: ColdStorage,\n  hotStorage: HotStorage\n) =>\n  Effect.gen(function* () {\n    // Get entity address to determine documentId\n    const address = yield* Entity.CurrentAddress;\n    const documentId = address.entityId;\n\n    // Current schema version (hard-coded to 1 for now)\n    const SCHEMA_VERSION = 1;\n\n    // Compute initial state\n    const computeInitialState = (): Effect.Effect<\n      Primitive.InferSetInput<TSchema> | undefined\n    > => {\n      if (config.initial === undefined) {\n        return Effect.succeed(undefined);\n      }\n\n      if (typeof config.initial === \"function\") {\n        return (\n          config.initial as (ctx: {\n            documentId: string;\n          }) => Effect.Effect<Primitive.InferSetInput<TSchema>>\n        )({ documentId });\n      }\n\n      return Effect.succeed(\n        config.initial as Primitive.InferSetInput<TSchema>\n      );\n    };\n\n    // Load snapshot from ColdStorage\n    const storedDoc = yield* Effect.catchAll(\n      coldStorage.load(documentId),\n      () => Effect.succeed(undefined)\n    );\n\n    let initialState: Primitive.InferSetInput<TSchema> | undefined;\n    let initialVersion = 0;\n\n    if (storedDoc) {\n      initialState =\n        storedDoc.state as Primitive.InferSetInput<TSchema>;\n      initialVersion = storedDoc.version;\n    } else {\n      initialState = yield* computeInitialState();\n    }\n\n    // Create PubSubs for broadcasting\n    const broadcastPubSub = yield* PubSub.unbounded<Protocol.ServerMessage>();\n    const presencePubSub = yield* PubSub.unbounded<PresenceEvent>();\n\n    // Create state ref\n    const stateRef = yield* Ref.make<EntityDocumentState<TSchema>>({\n      document: undefined as unknown as ServerDocument.ServerDocument<TSchema>,\n      broadcastPubSub,\n      presences: HashMap.empty(),\n      presencePubSub,\n      lastSnapshotVersion: initialVersion,\n      lastSnapshotTime: Date.now(),\n      transactionsSinceSnapshot: 0,\n    });\n\n    // Create ServerDocument with callbacks\n    const document = ServerDocument.make({\n      schema: config.schema,\n      initialState,\n      initialVersion,\n      maxTransactionHistory: config.maxTransactionHistory,\n      onBroadcast: (message: ServerDocument.TransactionMessage) => {\n        Effect.runSync(\n          PubSub.publish(broadcastPubSub, {\n            type: \"transaction\",\n            transaction: message.transaction,\n            version: message.version,\n          } as Protocol.ServerMessage)\n        );\n      },\n      onRejection: (transactionId: string, reason: string) => {\n        Effect.runSync(\n          PubSub.publish(broadcastPubSub, {\n            type: \"error\",\n            transactionId,\n            reason,\n          } as Protocol.ServerMessage)\n        );\n      },\n    });\n\n    // Update state with document\n    yield* Ref.update(stateRef, (s) => ({ ...s, document }));\n\n    // Replay WAL entries\n    const walEntries = yield* Effect.catchAll(\n      hotStorage.getEntries(documentId, initialVersion),\n      () => Effect.succeed([] as WalEntry[])\n    );\n\n    for (const entry of walEntries) {\n      const result = document.submit(entry.transaction);\n      if (!result.success) {\n        yield* Effect.logWarning(\"Skipping corrupted WAL entry\", {\n          documentId,\n          version: entry.version,\n          reason: result.reason,\n        });\n      }\n    }\n\n    // Track metrics\n    if (storedDoc) {\n      yield* Metric.increment(Metrics.documentsRestored);\n    } else {\n      yield* Metric.increment(Metrics.documentsCreated);\n    }\n    yield* Metric.incrementBy(Metrics.documentsActive, 1);\n\n    /**\n     * Save snapshot to ColdStorage\n     */\n    const saveSnapshot = Effect.gen(function* () {\n      const state = yield* Ref.get(stateRef);\n      const docState = state.document.get();\n      const version = state.document.getVersion();\n\n      if (docState === undefined) {\n        return;\n      }\n\n      const storedDocument: StoredDocument = {\n        state: docState,\n        version,\n        schemaVersion: SCHEMA_VERSION,\n        savedAt: Date.now(),\n      };\n\n      const snapshotStartTime = Date.now();\n\n      yield* Effect.catchAll(\n        coldStorage.save(documentId, storedDocument),\n        (e) =>\n          Effect.logError(\"Failed to save snapshot\", { documentId, error: e })\n      );\n\n      const snapshotDuration = Date.now() - snapshotStartTime;\n      yield* Metric.increment(Metrics.storageSnapshots);\n      yield* Metric.update(Metrics.storageSnapshotLatency, snapshotDuration);\n\n      yield* Effect.catchAll(hotStorage.truncate(documentId, version), (e) =>\n        Effect.logError(\"Failed to truncate WAL\", { documentId, error: e })\n      );\n\n      yield* Ref.update(stateRef, (s) => ({\n        ...s,\n        lastSnapshotVersion: version,\n        lastSnapshotTime: Date.now(),\n        transactionsSinceSnapshot: 0,\n      }));\n    });\n\n    /**\n     * Check if snapshot should be triggered\n     */\n    const checkSnapshotTriggers = Effect.gen(function* () {\n      const state = yield* Ref.get(stateRef);\n      const now = Date.now();\n\n      const intervalMs = Duration.toMillis(config.snapshot.interval);\n      const threshold = config.snapshot.transactionThreshold;\n\n      if (state.transactionsSinceSnapshot >= threshold) {\n        yield* saveSnapshot;\n        return;\n      }\n\n      if (now - state.lastSnapshotTime >= intervalMs) {\n        yield* saveSnapshot;\n        return;\n      }\n    });\n\n    // Cleanup on entity finalization\n    yield* Effect.addFinalizer(() =>\n      Effect.gen(function* () {\n        // Save final snapshot before entity is garbage collected\n        yield* saveSnapshot;\n        yield* Metric.incrementBy(Metrics.documentsActive, -1);\n        yield* Metric.increment(Metrics.documentsEvicted);\n        yield* Effect.logDebug(\"Entity finalized\", { documentId });\n      })\n    );\n\n    // Return RPC handlers\n    return {\n      Submit: Effect.fnUntraced(function* ({ payload }) {\n        const submitStartTime = Date.now();\n        const state = yield* Ref.get(stateRef);\n\n        // Decode transaction\n        const transaction = decodeTransaction(payload.transaction);\n\n        // Submit to ServerDocument\n        const result = state.document.submit(transaction);\n\n        // Track latency\n        const latency = Date.now() - submitStartTime;\n        yield* Metric.update(Metrics.transactionsLatency, latency);\n\n        if (result.success) {\n          yield* Metric.increment(Metrics.transactionsProcessed);\n\n          // Append to WAL\n          const walEntry: WalEntry = {\n            transaction,\n            version: result.version,\n            timestamp: Date.now(),\n          };\n\n          yield* Effect.catchAll(hotStorage.append(documentId, walEntry), (e) =>\n            Effect.logError(\"Failed to append to WAL\", {\n              documentId,\n              error: e,\n            })\n          );\n\n          yield* Metric.increment(Metrics.storageWalAppends);\n\n          // Increment transaction count\n          yield* Ref.update(stateRef, (s) => ({\n            ...s,\n            transactionsSinceSnapshot: s.transactionsSinceSnapshot + 1,\n          }));\n\n          // Check snapshot triggers\n          yield* checkSnapshotTriggers;\n        } else {\n          yield* Metric.increment(Metrics.transactionsRejected);\n        }\n\n        return result;\n      }),\n\n      GetSnapshot: Effect.fnUntraced(function* () {\n        const state = yield* Ref.get(stateRef);\n        return state.document.getSnapshot();\n      }),\n\n      Touch: Effect.fnUntraced(function* () {\n        // Entity touch is handled automatically by the cluster framework\n        // Just update last activity time conceptually\n        return void 0;\n      }),\n\n      SetPresence: Effect.fnUntraced(function* ({ payload }) {\n        const { connectionId, entry } = payload;\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.set(s.presences, connectionId, entry),\n        }));\n\n        yield* Metric.increment(Metrics.presenceUpdates);\n        yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n        const state = yield* Ref.get(stateRef);\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.presencePubSub, event);\n      }),\n\n      RemovePresence: Effect.fnUntraced(function* ({ payload }) {\n        const { connectionId } = payload;\n        const state = yield* Ref.get(stateRef);\n\n        if (!HashMap.has(state.presences, connectionId)) {\n          return;\n        }\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.remove(s.presences, connectionId),\n        }));\n\n        yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n        const event: PresenceEvent = {\n          type: \"presence_remove\",\n          id: connectionId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      GetPresenceSnapshot: Effect.fnUntraced(function* () {\n        const state = yield* Ref.get(stateRef);\n        const presences: Record<string, PresenceEntry> = {};\n        for (const [id, entry] of state.presences) {\n          presences[id] = entry;\n        }\n        return { presences };\n      }),\n    };\n  });\n\n// =============================================================================\n// Subscription Store (for managing subscriptions at the gateway level)\n// =============================================================================\n\n/**\n * Store for managing document subscriptions\n * This is needed because cluster entities don't support streaming directly\n */\ninterface SubscriptionStore {\n  readonly getOrCreatePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<Protocol.ServerMessage>>;\n  readonly getOrCreatePresencePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<PresenceEvent>>;\n}\n\nclass SubscriptionStoreTag extends Context.Tag(\n  \"@voidhash/mimic-effect/SubscriptionStore\"\n)<SubscriptionStoreTag, SubscriptionStore>() {}\n\nconst subscriptionStoreLayer = Layer.effect(\n  SubscriptionStoreTag,\n  Effect.gen(function* () {\n    const documentPubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<Protocol.ServerMessage>>()\n    );\n    const presencePubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<PresenceEvent>>()\n    );\n\n    return {\n      getOrCreatePubSub: (documentId: string) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(documentPubSubs);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"Some\") {\n            return existing.value;\n          }\n\n          const pubsub = yield* PubSub.unbounded<Protocol.ServerMessage>();\n          yield* Ref.update(documentPubSubs, (map) =>\n            HashMap.set(map, documentId, pubsub)\n          );\n          return pubsub;\n        }),\n\n      getOrCreatePresencePubSub: (documentId: string) =>\n        Effect.gen(function* () {\n          const current = yield* Ref.get(presencePubSubs);\n          const existing = HashMap.get(current, documentId);\n          if (existing._tag === \"Some\") {\n            return existing.value;\n          }\n\n          const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n          yield* Ref.update(presencePubSubs, (map) =>\n            HashMap.set(map, documentId, pubsub)\n          );\n          return pubsub;\n        }),\n    };\n  })\n);\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicClusterServerEngine layer.\n *\n * This creates a clustered document management service using Effect Cluster.\n * Each document becomes a cluster Entity with automatic sharding and failover.\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicClusterServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n *   shardGroup: \"documents\",\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together with cluster infrastructure\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.S3.make(...)),\n *   Layer.provide(HotStorage.Redis.make(...)),\n *   Layer.provide(MimicAuthService.make(...)),\n *   Layer.provide(ClusterInfrastructure),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag | Sharding.Sharding\n> => {\n  const resolvedConfig = resolveClusterConfig(config);\n\n  // Create config layer\n  const configLayer = Layer.succeed(\n    MimicClusterConfigTag,\n    resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create entity layer that registers with sharding\n  const entityLayer = MimicDocumentEntity.toLayer(\n    Effect.gen(function* () {\n      const clusterConfig = yield* MimicClusterConfigTag;\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n\n      return yield* createEntityHandler(\n        clusterConfig as ResolvedClusterConfig<TSchema>,\n        coldStorage,\n        hotStorage\n      );\n    }),\n    {\n      maxIdleTime: resolvedConfig.maxIdleTime,\n      concurrency: 1, // Sequential message processing per document\n      mailboxCapacity: 4096,\n    }\n  );\n\n  // Create the engine service\n  const engineLayer = Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      // Get entity client maker\n      const makeClient = yield* MimicDocumentEntity.client;\n\n      // Get subscription store\n      const subscriptionStore = yield* SubscriptionStoreTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            const encodedTx = encodeTransaction(transaction);\n            const result = yield* client.Submit({\n              transaction: encodedTx as { id: string; ops: unknown[] },\n            }).pipe(\n              Effect.catchAll((error) =>\n                Effect.succeed({\n                  success: false as const,\n                  reason: `Cluster error: ${String(error)}`,\n                })\n              )\n            );\n\n            // Broadcast to local subscribers if success\n            if (result.success) {\n              const pubsub =\n                yield* subscriptionStore.getOrCreatePubSub(documentId);\n              yield* PubSub.publish(pubsub, {\n                type: \"transaction\",\n                transaction,\n                version: result.version,\n              } as Protocol.ServerMessage);\n            }\n\n            return result;\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.Touch(undefined as void).pipe(Effect.orDie);\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetPresenceSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        setPresence: (documentId, connectionId, entry) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.SetPresence({ connectionId, entry }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_update\",\n              id: connectionId,\n              data: entry.data,\n              userId: entry.userId,\n            });\n          }),\n\n        removePresence: (documentId, connectionId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.RemovePresence({ connectionId }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_remove\",\n              id: connectionId,\n            });\n          }),\n\n        subscribePresence: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        config: resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  );\n\n  // Compose all layers\n  return Layer.mergeAll(entityLayer, engineLayer).pipe(\n    Layer.provideMerge(subscriptionStoreLayer),\n    Layer.provideMerge(configLayer)\n  );\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicClusterServerEngine = {\n  make,\n};\n"],"mappings":"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"}
+{"version":3,"file":"MimicClusterServerEngine.mjs","names":["Metrics.documentsActive","Metrics.documentsEvicted","Metrics.storageIdleSnapshots","Metrics.presenceUpdates","Metrics.presenceActive","event: PresenceEvent","presences: Record<string, PresenceEntry>"],"sources":["../src/MimicClusterServerEngine.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - MimicClusterServerEngine\n *\n * Clustered document management service using Effect Cluster for horizontal scaling.\n * Each document becomes a cluster Entity with automatic sharding, failover, and location-transparent routing.\n *\n * This is an alternative to MimicServerEngine for distributed deployments.\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Schedule,\n  Schema,\n  Stream,\n} from \"effect\";\nimport { Entity, Sharding } from \"@effect/cluster\";\nimport { Rpc } from \"@effect/rpc\";\nimport { type Primitive, type Transaction } from \"@voidhash/mimic\";\nimport type {\n  MimicClusterServerEngineConfig,\n  PresenceEntry,\n  PresenceEvent,\n  ResolvedClusterConfig,\n} from \"./Types\";\nimport type * as Protocol from \"./Protocol\";\nimport { ColdStorageTag, type ColdStorage } from \"./ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"./HotStorage\";\nimport { MimicAuthServiceTag } from \"./MimicAuthService\";\nimport { MimicServerEngineTag, type MimicServerEngine } from \"./MimicServerEngine\";\nimport {\n  DocumentInstance,\n  type DocumentInstance as DocumentInstanceInterface,\n} from \"./DocumentInstance\";\nimport * as Metrics from \"./Metrics\";\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);\nconst DEFAULT_SHARD_GROUP = \"mimic-documents\";\n\n// =============================================================================\n// RPC Schemas\n// =============================================================================\n\n/**\n * Schema for encoded transaction (wire format)\n */\nconst EncodedTransactionSchema = Schema.Struct({\n  id: Schema.String,\n  ops: Schema.Array(Schema.Unknown),\n});\n\n/**\n * Schema for submit result\n */\nconst SubmitResultSchema = Schema.Union(\n  Schema.Struct({\n    success: Schema.Literal(true),\n    version: Schema.Number,\n  }),\n  Schema.Struct({\n    success: Schema.Literal(false),\n    reason: Schema.String,\n  })\n);\n\n/**\n * Schema for snapshot response\n */\nconst SnapshotResponseSchema = Schema.Struct({\n  state: Schema.Unknown,\n  version: Schema.Number,\n});\n\n/**\n * Schema for presence entry\n */\nconst PresenceEntrySchema = Schema.Struct({\n  data: Schema.Unknown,\n  userId: Schema.optional(Schema.String),\n});\n\n/**\n * Schema for presence snapshot response\n */\nconst PresenceSnapshotResponseSchema = Schema.Struct({\n  presences: Schema.Record({ key: Schema.String, value: PresenceEntrySchema }),\n});\n\n/**\n * Schema for presence event\n */\nconst PresenceEventSchema = Schema.Union(\n  Schema.Struct({\n    type: Schema.Literal(\"presence_update\"),\n    id: Schema.String,\n    data: Schema.Unknown,\n    userId: Schema.optional(Schema.String),\n  }),\n  Schema.Struct({\n    type: Schema.Literal(\"presence_remove\"),\n    id: Schema.String,\n  })\n);\n\n/**\n * Schema for server message (for broadcasts)\n */\nconst ServerMessageSchema = Schema.Unknown;\n\n// =============================================================================\n// Mimic Document Entity Definition\n// =============================================================================\n\n/**\n * Define the Mimic Document Entity with its RPC protocol.\n * This entity handles document operations for a single documentId.\n */\nconst MimicDocumentEntity = Entity.make(\"MimicDocument\", [\n  // Submit a transaction\n  Rpc.make(\"Submit\", {\n    payload: { transaction: EncodedTransactionSchema },\n    success: SubmitResultSchema,\n  }),\n\n  // Get document snapshot\n  Rpc.make(\"GetSnapshot\", {\n    success: SnapshotResponseSchema,\n  }),\n\n  // Touch document to prevent idle GC\n  Rpc.make(\"Touch\", {\n    success: Schema.Void,\n  }),\n\n  // Set presence for a connection\n  Rpc.make(\"SetPresence\", {\n    payload: {\n      connectionId: Schema.String,\n      entry: PresenceEntrySchema,\n    },\n    success: Schema.Void,\n  }),\n\n  // Remove presence for a connection\n  Rpc.make(\"RemovePresence\", {\n    payload: { connectionId: Schema.String },\n    success: Schema.Void,\n  }),\n\n  // Get presence snapshot\n  Rpc.make(\"GetPresenceSnapshot\", {\n    success: PresenceSnapshotResponseSchema,\n  }),\n]);\n\n// =============================================================================\n// Entity State Types\n// =============================================================================\n\n/**\n * Entity state that wraps DocumentInstance and adds presence management\n */\ninterface EntityState<TSchema extends Primitive.AnyPrimitive> {\n  readonly instance: DocumentInstanceInterface<TSchema>;\n  readonly presences: HashMap.HashMap<string, PresenceEntry>;\n  readonly presencePubSub: PubSub.PubSub<PresenceEvent>;\n}\n\n// =============================================================================\n// Config Context Tag\n// =============================================================================\n\n/**\n * Context tag for cluster engine configuration\n */\nclass MimicClusterConfigTag extends Context.Tag(\n  \"@voidhash/mimic-effect/MimicClusterConfig\"\n)<MimicClusterConfigTag, ResolvedClusterConfig<Primitive.AnyPrimitive>>() {}\n\n// =============================================================================\n// Resolve Configuration\n// =============================================================================\n\nconst resolveClusterConfig = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): ResolvedClusterConfig<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  shardGroup: config.shardGroup ?? DEFAULT_SHARD_GROUP,\n});\n\n// =============================================================================\n// Helper to decode/encode transactions\n// =============================================================================\n\n/**\n * Decode an encoded transaction to a Transaction object\n */\nconst decodeTransaction = (\n  encoded: { id: string; ops: readonly unknown[] }\n): Transaction.Transaction => {\n  // Import Transaction dynamically to avoid circular deps\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.decode(encoded as Transaction.EncodedTransaction);\n};\n\n/**\n * Encode a Transaction to wire format\n */\nconst encodeTransaction = (\n  tx: Transaction.Transaction\n): { id: string; ops: readonly unknown[] } => {\n  const { Transaction } = require(\"@voidhash/mimic\");\n  return Transaction.encode(tx);\n};\n\n// =============================================================================\n// Entity Handler Factory\n// =============================================================================\n\n/**\n * Create the entity handler for MimicDocument\n */\nconst createEntityHandler = <TSchema extends Primitive.AnyPrimitive>(\n  config: ResolvedClusterConfig<TSchema>,\n  coldStorage: ColdStorage,\n  hotStorage: HotStorage\n) =>\n  Effect.fn(\"cluster.entity.handler.create\")(function* () {\n    // Get entity address to determine documentId\n    const address = yield* Entity.CurrentAddress;\n    const documentId = address.entityId;\n\n    // Create DocumentInstance (fatal if unavailable - entity cannot start)\n    const instance = yield* DocumentInstance.make(\n      documentId,\n      {\n        schema: config.schema,\n        initial: config.initial,\n        maxTransactionHistory: config.maxTransactionHistory,\n        snapshot: config.snapshot,\n      },\n      coldStorage,\n      hotStorage\n    ).pipe(Effect.orDie);\n\n    // Create presence PubSub and state ref\n    const presencePubSub = yield* PubSub.unbounded<PresenceEvent>();\n    const stateRef = yield* Ref.make<EntityState<TSchema>>({\n      instance,\n      presences: HashMap.empty(),\n      presencePubSub,\n    });\n\n    // Cleanup on entity finalization\n    yield* Effect.addFinalizer(() =>\n      Effect.fn(\"cluster.entity.finalize\")(function* () {\n        // Best effort save - don't fail shutdown if storage is unavailable\n        yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n          Effect.logError(\"Failed to save snapshot during entity finalization\", {\n            documentId,\n            error: e,\n          })\n        );\n        yield* Metric.incrementBy(Metrics.documentsActive, -1);\n        yield* Metric.increment(Metrics.documentsEvicted);\n        yield* Effect.logDebug(\"Entity finalized\", { documentId });\n      })()\n    );\n\n    // Start periodic snapshot fiber for this entity\n    const idleTimeoutMs = Duration.toMillis(config.snapshot.idleTimeout);\n    if (idleTimeoutMs > 0) {\n      const snapshotLoop = Effect.fn(\"cluster.entity.snapshot.loop\")(function* () {\n        const needs = yield* instance.needsSnapshot();\n        if (needs) {\n          yield* Effect.catchAll(instance.saveSnapshot(), (e) =>\n            Effect.logWarning(\"Periodic snapshot failed in cluster entity\", {\n              documentId,\n              error: e,\n            })\n          );\n          yield* Metric.increment(Metrics.storageIdleSnapshots);\n        }\n      });\n\n      // Run every idleTimeout\n      yield* snapshotLoop().pipe(\n        Effect.repeat(Schedule.spaced(config.snapshot.idleTimeout)),\n        Effect.fork\n      );\n    }\n\n    // Return RPC handlers\n    return {\n      Submit: Effect.fn(\"cluster.document.transaction.submit\")(function* ({\n        payload,\n      }) {\n        // Decode transaction\n        const transaction = decodeTransaction(payload.transaction);\n\n        // Use DocumentInstance's submit method, catching storage errors\n        return yield* instance.submit(transaction).pipe(\n          Effect.catchAll((error) =>\n            Effect.succeed({\n              success: false as const,\n              reason: `Storage error: ${String(error)}`,\n            })\n          )\n        );\n      }),\n\n      GetSnapshot: Effect.fn(\"cluster.document.snapshot.get\")(function* () {\n        return instance.getSnapshot();\n      }),\n\n      Touch: Effect.fn(\"cluster.document.touch\")(function* () {\n        yield* instance.touch();\n      }),\n\n      SetPresence: Effect.fn(\"cluster.presence.set\")(function* ({ payload }) {\n        const { connectionId, entry } = payload;\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.set(s.presences, connectionId, entry),\n        }));\n\n        yield* Metric.increment(Metrics.presenceUpdates);\n        yield* Metric.incrementBy(Metrics.presenceActive, 1);\n\n        const state = yield* Ref.get(stateRef);\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.presencePubSub, event);\n      }),\n\n      RemovePresence: Effect.fn(\"cluster.presence.remove\")(function* ({\n        payload,\n      }) {\n        const { connectionId } = payload;\n        const state = yield* Ref.get(stateRef);\n\n        if (!HashMap.has(state.presences, connectionId)) {\n          return;\n        }\n\n        yield* Ref.update(stateRef, (s) => ({\n          ...s,\n          presences: HashMap.remove(s.presences, connectionId),\n        }));\n\n        yield* Metric.incrementBy(Metrics.presenceActive, -1);\n\n        const event: PresenceEvent = {\n          type: \"presence_remove\",\n          id: connectionId,\n        };\n        yield* PubSub.publish(state.presencePubSub, event);\n      }),\n\n      GetPresenceSnapshot: Effect.fn(\"cluster.presence.snapshot.get\")(\n        function* () {\n          const state = yield* Ref.get(stateRef);\n          const presences: Record<string, PresenceEntry> = {};\n          for (const [id, entry] of state.presences) {\n            presences[id] = entry;\n          }\n          return { presences };\n        }\n      ),\n    };\n  })();\n\n// =============================================================================\n// Subscription Store (for managing subscriptions at the gateway level)\n// =============================================================================\n\n/**\n * Store for managing document subscriptions\n * This is needed because cluster entities don't support streaming directly\n */\ninterface SubscriptionStore {\n  readonly getOrCreatePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<Protocol.ServerMessage>>;\n  readonly getOrCreatePresencePubSub: (\n    documentId: string\n  ) => Effect.Effect<PubSub.PubSub<PresenceEvent>>;\n}\n\nclass SubscriptionStoreTag extends Context.Tag(\n  \"@voidhash/mimic-effect/SubscriptionStore\"\n)<SubscriptionStoreTag, SubscriptionStore>() {}\n\nconst subscriptionStoreLayer = Layer.effect(\n  SubscriptionStoreTag,\n  Effect.fn(\"cluster.subscriptions.layer.create\")(function* () {\n    const documentPubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<Protocol.ServerMessage>>()\n    );\n    const presencePubSubs = yield* Ref.make(\n      HashMap.empty<string, PubSub.PubSub<PresenceEvent>>()\n    );\n\n    return {\n      getOrCreatePubSub: Effect.fn(\n        \"cluster.subscriptions.pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(documentPubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<Protocol.ServerMessage>();\n        yield* Ref.update(documentPubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n\n      getOrCreatePresencePubSub: Effect.fn(\n        \"cluster.subscriptions.presence-pubsub.get-or-create\"\n      )(function* (documentId: string) {\n        const current = yield* Ref.get(presencePubSubs);\n        const existing = HashMap.get(current, documentId);\n        if (existing._tag === \"Some\") {\n          return existing.value;\n        }\n\n        const pubsub = yield* PubSub.unbounded<PresenceEvent>();\n        yield* Ref.update(presencePubSubs, (map) =>\n          HashMap.set(map, documentId, pubsub)\n        );\n        return pubsub;\n      }),\n    };\n  })()\n);\n\n// =============================================================================\n// Factory\n// =============================================================================\n\n/**\n * Create a MimicClusterServerEngine layer.\n *\n * This creates a clustered document management service using Effect Cluster.\n * Each document becomes a cluster Entity with automatic sharding and failover.\n *\n * @example\n * ```typescript\n * // 1. Create the engine\n * const Engine = MimicClusterServerEngine.make({\n *   schema: DocSchema,\n *   initial: { title: \"Untitled\" },\n *   presence: CursorPresence,\n *   maxIdleTime: \"5 minutes\",\n *   snapshot: { interval: \"5 minutes\", transactionThreshold: 100 },\n *   shardGroup: \"documents\",\n * })\n *\n * // 2. Create the WebSocket route\n * const MimicRoute = MimicServer.layerHttpLayerRouter({\n *   path: \"/mimic\",\n * })\n *\n * // 3. Wire together with cluster infrastructure\n * const MimicLive = MimicRoute.pipe(\n *   Layer.provide(Engine),\n *   Layer.provide(ColdStorage.S3.make(...)),\n *   Layer.provide(HotStorage.Redis.make(...)),\n *   Layer.provide(MimicAuthService.make(...)),\n *   Layer.provide(ClusterInfrastructure),\n * )\n * ```\n */\nexport const make = <TSchema extends Primitive.AnyPrimitive>(\n  config: MimicClusterServerEngineConfig<TSchema>\n): Layer.Layer<\n  MimicServerEngineTag,\n  never,\n  ColdStorageTag | HotStorageTag | MimicAuthServiceTag | Sharding.Sharding\n> => {\n  const resolvedConfig = resolveClusterConfig(config);\n\n  // Create config layer\n  const configLayer = Layer.succeed(\n    MimicClusterConfigTag,\n    resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>\n  );\n\n  // Create entity layer that registers with sharding\n  const entityLayer = MimicDocumentEntity.toLayer(\n    Effect.gen(function* () {\n      const clusterConfig = yield* MimicClusterConfigTag;\n      const coldStorage = yield* ColdStorageTag;\n      const hotStorage = yield* HotStorageTag;\n\n      return yield* createEntityHandler(\n        clusterConfig as ResolvedClusterConfig<TSchema>,\n        coldStorage,\n        hotStorage\n      );\n    }),\n    {\n      maxIdleTime: resolvedConfig.maxIdleTime,\n      concurrency: 1, // Sequential message processing per document\n      mailboxCapacity: 4096,\n    }\n  );\n\n  // Create the engine service\n  const engineLayer = Layer.scoped(\n    MimicServerEngineTag,\n    Effect.gen(function* () {\n      // Get entity client maker\n      const makeClient = yield* MimicDocumentEntity.client;\n\n      // Get subscription store\n      const subscriptionStore = yield* SubscriptionStoreTag;\n\n      const engine: MimicServerEngine = {\n        submit: (documentId, transaction) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            const encodedTx = encodeTransaction(transaction);\n            const result = yield* client.Submit({\n              transaction: encodedTx as { id: string; ops: unknown[] },\n            }).pipe(\n              Effect.catchAll((error) =>\n                Effect.succeed({\n                  success: false as const,\n                  reason: `Cluster error: ${String(error)}`,\n                })\n              )\n            );\n\n            // Broadcast to local subscribers if success\n            if (result.success) {\n              const pubsub =\n                yield* subscriptionStore.getOrCreatePubSub(documentId);\n              yield* PubSub.publish(pubsub, {\n                type: \"transaction\",\n                transaction,\n                version: result.version,\n              } as Protocol.ServerMessage);\n            }\n\n            return result;\n          }),\n\n        getSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        subscribe: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        touch: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.Touch(undefined as void).pipe(Effect.orDie);\n          }),\n\n        getPresenceSnapshot: (documentId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            return yield* client.GetPresenceSnapshot(undefined as void).pipe(Effect.orDie);\n          }),\n\n        setPresence: (documentId, connectionId, entry) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.SetPresence({ connectionId, entry }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_update\",\n              id: connectionId,\n              data: entry.data,\n              userId: entry.userId,\n            });\n          }),\n\n        removePresence: (documentId, connectionId) =>\n          Effect.gen(function* () {\n            const client = makeClient(documentId);\n            yield* client.RemovePresence({ connectionId }).pipe(Effect.orDie);\n\n            // Broadcast to local presence subscribers\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            yield* PubSub.publish(pubsub, {\n              type: \"presence_remove\",\n              id: connectionId,\n            });\n          }),\n\n        subscribePresence: (documentId) =>\n          Effect.gen(function* () {\n            const pubsub =\n              yield* subscriptionStore.getOrCreatePresencePubSub(documentId);\n            return Stream.fromPubSub(pubsub);\n          }),\n\n        config: resolvedConfig as ResolvedClusterConfig<Primitive.AnyPrimitive>,\n      };\n\n      return engine;\n    })\n  );\n\n  // Compose all layers\n  return Layer.mergeAll(entityLayer, engineLayer).pipe(\n    Layer.provideMerge(subscriptionStoreLayer),\n    Layer.provideMerge(configLayer)\n  );\n};\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const MimicClusterServerEngine = {\n  make,\n};\n"],"mappings":"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"}

package/dist/MimicServer.cjs

@@ -1,6 +1,6 @@
+const require_Errors = require('./Errors.cjs');
 const require_Metrics = require('./Metrics.cjs');
 const require_MimicServerEngine = require('./MimicServerEngine.cjs');
-const require_Errors = require('./Errors.cjs');
 const require_Protocol = require('./Protocol.cjs');
 const require_MimicAuthService = require('./MimicAuthService.cjs');
 let effect = require("effect");
@@ -42,7 +42,7 @@ const extractDocumentId = (path) => {
 /**
 * Handle a WebSocket connection for a document.
 */
-const handleWebSocketConnection = (socket, documentId, engine, authService, _routeConfig) => effect.Effect.gen(function* () {
+const handleWebSocketConnection = effect.Effect.fn("websocket.connection.handle")(function* (socket, documentId, engine, authService, _routeConfig) {
 	const connectionId = crypto.randomUUID();
 	const connectionStartTime = Date.now();
 	yield* effect.Metric.increment(require_Metrics.connectionsTotal);
@@ -55,30 +55,30 @@ const handleWebSocketConnection = (socket, documentId, engine, authService, _rou
 	};
 	const write = yield* socket.writer;
 	const sendMessage = (message) => write(require_Protocol.encodeServerMessage(message));
-	const sendPresenceSnapshot = effect.Effect.gen(function* () {
+	const sendPresenceSnapshot = effect.Effect.fn("presence.snapshot.send")(function* () {
 		if (!engine.config.presence) return;
 		const snapshot = yield* engine.getPresenceSnapshot(documentId);
 		yield* sendMessage(require_Protocol.presenceSnapshotMessage(connectionId, snapshot.presences));
 	});
-	const sendDocumentSnapshot = effect.Effect.gen(function* () {
+	const sendDocumentSnapshot = effect.Effect.fn("document.snapshot.send")(function* () {
 		const snapshot = yield* engine.getSnapshot(documentId);
 		yield* sendMessage(require_Protocol.snapshotMessage(snapshot.state, snapshot.version));
 	});
-	const handleAuth = (token) => effect.Effect.gen(function* () {
+	const handleAuth = effect.Effect.fn("auth.handle")(function* (token) {
 		const result = yield* effect.Effect.either(authService.authenticate(token, documentId));
 		if (result._tag === "Right") {
 			state.authenticated = true;
 			state.authContext = result.right;
 			yield* sendMessage(require_Protocol.authResultSuccess(result.right.userId, result.right.permission));
-			yield* sendDocumentSnapshot;
-			yield* sendPresenceSnapshot;
+			yield* sendDocumentSnapshot();
+			yield* sendPresenceSnapshot();
 		} else {
 			var _result$left$reason;
 			yield* effect.Metric.increment(require_Metrics.connectionsErrors);
 			yield* sendMessage(require_Protocol.authResultFailure((_result$left$reason = result.left.reason) !== null && _result$left$reason !== void 0 ? _result$left$reason : "Authentication failed"));
 		}
 	});
-	const handlePresenceSet = (data) => effect.Effect.gen(function* () {
+	const handlePresenceSet = effect.Effect.fn("presence.set.handle")(function* (data) {
 		if (!state.authenticated) return;
 		if (!state.authContext) return;
 		if (!engine.config.presence) return;
@@ -100,13 +100,13 @@ const handleWebSocketConnection = (socket, documentId, engine, authService, _rou
 		});
 		state.hasPresence = true;
 	});
-	const handlePresenceClear = effect.Effect.gen(function* () {
+	const handlePresenceClear = effect.Effect.fn("presence.clear.handle")(function* () {
 		if (!state.authenticated) return;
 		if (!engine.config.presence) return;
 		yield* engine.removePresence(documentId, connectionId);
 		state.hasPresence = false;
 	});
-	const handleMessage = (message) => effect.Effect.gen(function* () {
+	const handleMessage = effect.Effect.fn("message.handle")(function* (message) {
 		yield* engine.touch(documentId);
 		switch (message.type) {
 			case "auth":
@@ -137,16 +137,16 @@ const handleWebSocketConnection = (socket, documentId, engine, authService, _rou
 				yield* handlePresenceSet(message.data);
 				break;
 			case "presence_clear":
-				yield* handlePresenceClear;
+				yield* handlePresenceClear();
 				break;
 		}
 	});
-	const subscribeFiber = yield* effect.Effect.fork(effect.Effect.gen(function* () {
+	const subscribeFiber = yield* effect.Effect.fork(effect.Effect.fn("subscriptions.document.start")(function* () {
 		while (!state.authenticated) yield* effect.Effect.sleep(effect.Duration.millis(100));
 		const broadcastStream = yield* engine.subscribe(documentId);
 		yield* effect.Stream.runForEach(broadcastStream, (broadcast) => sendMessage(broadcast));
-	}).pipe(effect.Effect.scoped));
-	const presenceFiber = yield* effect.Effect.fork(effect.Effect.gen(function* () {
+	})().pipe(effect.Effect.scoped));
+	const presenceFiber = yield* effect.Effect.fork(effect.Effect.fn("subscriptions.presence.start")(function* () {
 		if (!engine.config.presence) return;
 		while (!state.authenticated) yield* effect.Effect.sleep(effect.Duration.millis(100));
 		const presenceStream = yield* engine.subscribePresence(documentId);
@@ -155,8 +155,8 @@ const handleWebSocketConnection = (socket, documentId, engine, authService, _rou
 			if (event.type === "presence_update") yield* sendMessage(require_Protocol.presenceUpdateMessage(event.id, event.data, event.userId));
 			else if (event.type === "presence_remove") yield* sendMessage(require_Protocol.presenceRemoveMessage(event.id));
 		}));
-	}).pipe(effect.Effect.scoped));
-	yield* effect.Effect.addFinalizer(() => effect.Effect.gen(function* () {
+	})().pipe(effect.Effect.scoped));
+	yield* effect.Effect.addFinalizer(() => effect.Effect.fn("connection.cleanup")(function* () {
 		const duration = Date.now() - connectionStartTime;
 		yield* effect.Fiber.interrupt(subscribeFiber);
 		yield* effect.Fiber.interrupt(presenceFiber);
@@ -168,10 +168,10 @@ const handleWebSocketConnection = (socket, documentId, engine, authService, _rou
 			documentId,
 			durationMs: duration
 		});
-	}));
-	yield* socket.runRaw((data) => effect.Effect.gen(function* () {
+	})());
+	yield* socket.runRaw((data) => effect.Effect.fn("message.process")(function* () {
 		yield* handleMessage(yield* require_Protocol.parseClientMessage(data));
-	}).pipe(effect.Effect.catchAll((error) => effect.Effect.logError("Message handling error", error))));
+	})().pipe(effect.Effect.catchAll((error) => effect.Effect.logError("Message handling error", error))));
 });
 /**
 * Create a route layer for MimicServerEngine.
@@ -218,7 +218,7 @@ const layerHttpLayerRouter = (options) => {
 		const router = yield* _effect_platform.HttpLayerRouter.HttpRouter;
 		const engine = yield* require_MimicServerEngine.MimicServerEngineTag;
 		const authService = yield* require_MimicAuthService.MimicAuthServiceTag;
-		const handler = (request) => effect.Effect.gen(function* () {
+		const handler = effect.Effect.fn("websocket.route.handler")(function* (request) {
 			const documentIdResult = yield* effect.Effect.either(extractDocumentId(request.url));
 			if (documentIdResult._tag === "Left") return _effect_platform.HttpServerResponse.text(`Missing document ID in path: ${request.url}`, { status: 400 });
 			const documentId = documentIdResult.right;

package/dist/MimicServer.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServer.d.cts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAmea;mCA7DD,2BAAsB,KAAA,CAAA,oBAAA,uBAAA,sBAAA,eAAA,CAAA,aAAA,eAAA,CAAA,iBAAA,iCAAA,CAAA,YAAA"}
+{"version":3,"file":"MimicServer.d.cts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cA2ea;mCA9DD,2BAAsB,KAAA,CAAA,oBAAA,uBAAA,sBAAA,eAAA,CAAA,aAAA,eAAA,CAAA,iBAAA,iCAAA,CAAA,YAAA"}

package/dist/MimicServer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"MimicServer.d.mts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cAmea;mCA7DD,2BAAsB,KAAA,CAAA,oBAAA,uBAAA,sBAAA,eAAA,CAAA,aAAA,eAAA,CAAA,iBAAA,iCAAA,CAAA,YAAA"}
+{"version":3,"file":"MimicServer.d.mts","names":[],"sources":["../src/MimicServer.ts"],"sourcesContent":[],"mappings":";;;;;;;;;cA2ea;mCA9DD,2BAAsB,KAAA,CAAA,oBAAA,uBAAA,sBAAA,eAAA,CAAA,aAAA,eAAA,CAAA,iBAAA,iCAAA,CAAA,YAAA"}