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

package/dist/DocumentManager.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DocumentManager.d.cts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AAgF0C,KApC9B,YAAA,GAoCqC;EAAM,SAAA,OAAA,EAAA,IAAA;EACtD,SAAA,OAAA,EAAA,MAAA;;;;;AASD;AAE2C;;UArC1B,eAAA;;;;EAoEJ,SAAA,MAAA,EAAA,CAAA,UAAyB,EAAA,MAAA,EAAA,WAAQ,EA9D7B,WAAA,CAAY,WAgEwC,EAAA,GA/D9D,MAAA,CAAO,MA+DuD,CA/DhD,YA+DgD,CAAA;EAwXxD;;;gDAlbmC,MAAA,CAAO,OAAO;;;;8CAOvD,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,yBAAyB,KAAA,CAAM;;;;;0CAMxB,MAAA,CAAO;;cAChD;;;;cASY,kBAAA,SAA2B,uBAAA;cAEG;;;;cA+B9B,wBAAA,SAAiC,6BAAA;cA0XjC"}

package/dist/DocumentManager.d.mts

@@ -1,59 +0,0 @@
-import { ResolvedConfig } from "./Types.mjs";
-import { ServerBroadcast, SnapshotMessage } from "./Protocol.mjs";
-import { ColdStorageTag } from "./ColdStorage.mjs";
-import { HotStorageTag } from "./HotStorage.mjs";
-import { Context, Effect, Layer, Scope, Stream } from "effect";
-import { Transaction } from "@voidhash/mimic";
-
-//#region src/DocumentManager.d.ts
-
-/**
- * Result of submitting a transaction
- */
-type SubmitResult = {
-  readonly success: true;
-  readonly version: number;
-} | {
-  readonly success: false;
-  readonly reason: string;
-};
-/**
- * Internal service for managing document lifecycle.
- */
-interface DocumentManager {
-  /**
-   * Submit a transaction to a document.
-   */
-  readonly submit: (documentId: string, transaction: Transaction.Transaction) => Effect.Effect<SubmitResult>;
-  /**
-   * Get a snapshot of a document.
-   */
-  readonly getSnapshot: (documentId: string) => Effect.Effect<SnapshotMessage>;
-  /**
-   * Subscribe to broadcasts for a document.
-   */
-  readonly subscribe: (documentId: string) => Effect.Effect<Stream.Stream<ServerBroadcast>, never, Scope.Scope>;
-  /**
-   * Touch a document to update its last activity time.
-   * Call this on any client activity to prevent idle GC.
-   */
-  readonly touch: (documentId: string) => Effect.Effect<void>;
-}
-declare const DocumentManagerTag_base: Context.TagClass<DocumentManagerTag, "@voidhash/mimic-effect/DocumentManager", DocumentManager>;
-/**
- * Context tag for DocumentManager service
- */
-declare class DocumentManagerTag extends DocumentManagerTag_base {}
-declare const DocumentManagerConfigTag_base: Context.TagClass<DocumentManagerConfigTag, "@voidhash/mimic-effect/DocumentManagerConfig", ResolvedConfig<Primitive.AnyPrimitive>>;
-/**
- * Context tag for DocumentManager configuration
- */
-declare class DocumentManagerConfigTag extends DocumentManagerConfigTag_base {}
-declare const DocumentManager: {
-  Tag: typeof DocumentManagerTag;
-  ConfigTag: typeof DocumentManagerConfigTag;
-  layer: Layer.Layer<DocumentManagerTag, never, ColdStorageTag | HotStorageTag | DocumentManagerConfigTag>;
-};
-//#endregion
-export { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, SubmitResult };
-//# sourceMappingURL=DocumentManager.d.mts.map

package/dist/DocumentManager.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"DocumentManager.d.mts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;AAgF0C,KApC9B,YAAA,GAoCqC;EAAM,SAAA,OAAA,EAAA,IAAA;EACtD,SAAA,OAAA,EAAA,MAAA;;;;;AASD;AAE2C;;UArC1B,eAAA;;;;EAoEJ,SAAA,MAAA,EAAA,CAAA,UAAyB,EAAA,MAAA,EAAA,WAAQ,EA9D7B,WAAA,CAAY,WAgEwC,EAAA,GA/D9D,MAAA,CAAO,MA+DuD,CA/DhD,YA+DgD,CAAA;EAwXxD;;;gDAlbmC,MAAA,CAAO,OAAO;;;;8CAOvD,MAAA,CAAO,OAAO,MAAA,CAAO,OAAO,yBAAyB,KAAA,CAAM;;;;;0CAMxB,MAAA,CAAO;;cAChD;;;;cASY,kBAAA,SAA2B,uBAAA;cAEG;;;;cA+B9B,wBAAA,SAAiC,6BAAA;cA0XjC"}

package/dist/DocumentManager.mjs

@@ -1,227 +0,0 @@
-import { ColdStorageTag } from "./ColdStorage.mjs";
-import { HotStorageTag } from "./HotStorage.mjs";
-import { documentsActive, documentsCreated, documentsEvicted, documentsRestored, storageSnapshotLatency, storageSnapshots, storageWalAppends, transactionsLatency, transactionsProcessed, transactionsRejected } from "./Metrics.mjs";
-import { Context, Duration, Effect, HashMap, Layer, Metric, PubSub, Ref, Schedule, Stream } from "effect";
-import { ServerDocument } from "@voidhash/mimic/server";
-
-//#region src/DocumentManager.ts
-/**
-* @voidhash/mimic-effect - DocumentManager
-*
-* Internal service for managing document lifecycle, including:
-* - Document creation and restoration
-* - Transaction processing
-* - WAL management
-* - Snapshot scheduling
-* - Idle document GC
-*/
-/**
-* Context tag for DocumentManager service
-*/
-var DocumentManagerTag = class extends Context.Tag("@voidhash/mimic-effect/DocumentManager")() {};
-/**
-* Context tag for DocumentManager configuration
-*/
-var DocumentManagerConfigTag = class extends Context.Tag("@voidhash/mimic-effect/DocumentManagerConfig")() {};
-/**
-* Create the DocumentManager layer.
-* Requires ColdStorage, HotStorage, and DocumentManagerConfig.
-*/
-const layer = Layer.scoped(DocumentManagerTag, Effect.gen(function* () {
-	const coldStorage = yield* ColdStorageTag;
-	const hotStorage = yield* HotStorageTag;
-	const config = yield* DocumentManagerConfigTag;
-	const store = yield* Ref.make(HashMap.empty());
-	const SCHEMA_VERSION = 1;
-	/**
-	* Compute initial state for a new document
-	*/
-	const computeInitialState = (documentId) => {
-		if (config.initial === void 0) return Effect.succeed(void 0);
-		if (typeof config.initial === "function") return config.initial({ documentId });
-		return Effect.succeed(config.initial);
-	};
-	/**
-	* Restore a document from storage
-	*/
-	const restoreDocument = (documentId) => Effect.gen(function* () {
-		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(documentId);
-		const pubsub = yield* PubSub.unbounded();
-		const lastSnapshotVersion = yield* Ref.make(initialVersion);
-		const lastSnapshotTime = yield* Ref.make(Date.now());
-		const transactionsSinceSnapshot = yield* Ref.make(0);
-		const lastActivityTime = yield* Ref.make(Date.now());
-		const document = ServerDocument.make({
-			schema: config.schema,
-			initialState,
-			initialVersion,
-			maxTransactionHistory: config.maxTransactionHistory,
-			onBroadcast: (message) => {
-				Effect.runSync(PubSub.publish(pubsub, {
-					type: "transaction",
-					transaction: message.transaction,
-					version: message.version
-				}));
-			},
-			onRejection: (transactionId, reason) => {
-				Effect.runSync(PubSub.publish(pubsub, {
-					type: "error",
-					transactionId,
-					reason
-				}));
-			}
-		});
-		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
-			});
-		}
-		const instance = {
-			document,
-			pubsub,
-			lastSnapshotVersion,
-			lastSnapshotTime,
-			transactionsSinceSnapshot,
-			lastActivityTime
-		};
-		if (storedDoc) yield* Metric.increment(documentsRestored);
-		else yield* Metric.increment(documentsCreated);
-		yield* Metric.incrementBy(documentsActive, 1);
-		return instance;
-	});
-	/**
-	* Get or create a document instance
-	*/
-	const getOrCreateDocument = (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());
-			return existing.value;
-		}
-		const instance = yield* restoreDocument(documentId);
-		yield* Ref.update(store, (map) => HashMap.set(map, documentId, instance));
-		return instance;
-	});
-	/**
-	* Save a snapshot to ColdStorage and truncate WAL
-	*/
-	const saveSnapshot = (documentId, instance) => Effect.gen(function* () {
-		const state = instance.document.get();
-		const version = instance.document.getVersion();
-		if (state === void 0) return;
-		const storedDoc = {
-			state,
-			version,
-			schemaVersion: SCHEMA_VERSION,
-			savedAt: Date.now()
-		};
-		const snapshotStartTime = Date.now();
-		yield* Effect.catchAll(coldStorage.save(documentId, storedDoc), (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", {
-			documentId,
-			error: e
-		}));
-		yield* Ref.set(instance.lastSnapshotVersion, version);
-		yield* Ref.set(instance.lastSnapshotTime, Date.now());
-		yield* Ref.set(instance.transactionsSinceSnapshot, 0);
-	});
-	/**
-	* Check if snapshot should be triggered
-	*/
-	const checkSnapshotTriggers = (documentId, instance) => Effect.gen(function* () {
-		const txCount = yield* Ref.get(instance.transactionsSinceSnapshot);
-		const lastTime = yield* Ref.get(instance.lastSnapshotTime);
-		const now = Date.now();
-		const intervalMs = Duration.toMillis(config.snapshot.interval);
-		if (txCount >= config.snapshot.transactionThreshold) {
-			yield* saveSnapshot(documentId, instance);
-			return;
-		}
-		if (now - lastTime >= intervalMs) {
-			yield* saveSnapshot(documentId, instance);
-			return;
-		}
-	});
-	yield* Effect.gen(function* () {
-		yield* Effect.gen(function* () {
-			const current = yield* Ref.get(store);
-			const now = Date.now();
-			const maxIdleMs = Duration.toMillis(config.maxIdleTime);
-			for (const [documentId, instance] of current) if (now - (yield* Ref.get(instance.lastActivityTime)) >= maxIdleMs) {
-				yield* saveSnapshot(documentId, instance);
-				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.addFinalizer(() => Effect.gen(function* () {
-		const current = yield* Ref.get(store);
-		for (const [documentId, instance] of current) yield* saveSnapshot(documentId, instance);
-		yield* Effect.logInfo("DocumentManager shutdown complete");
-	}));
-	return {
-		submit: (documentId, transaction) => Effect.gen(function* () {
-			const instance = yield* getOrCreateDocument(documentId);
-			const submitStartTime = Date.now();
-			const result = instance.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(instance.transactionsSinceSnapshot, (n) => n + 1);
-				yield* checkSnapshotTriggers(documentId, instance);
-			} else yield* Metric.increment(transactionsRejected);
-			return result;
-		}),
-		getSnapshot: (documentId) => Effect.gen(function* () {
-			return (yield* getOrCreateDocument(documentId)).document.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());
-		})
-	};
-}));
-const DocumentManager = {
-	Tag: DocumentManagerTag,
-	ConfigTag: DocumentManagerConfigTag,
-	layer
-};
-
-//#endregion
-export { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, layer };
-//# sourceMappingURL=DocumentManager.mjs.map

package/dist/DocumentManager.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"DocumentManager.mjs","names":["layer: Layer.Layer<\n  DocumentManagerTag,\n  never,\n  ColdStorageTag | HotStorageTag | DocumentManagerConfigTag\n>","initialState: Primitive.InferSetInput<typeof config.schema> | undefined","instance: DocumentInstance<typeof config.schema>","Metrics.documentsRestored","Metrics.documentsCreated","Metrics.documentsActive","storedDoc: StoredDocument","Metrics.storageSnapshots","Metrics.storageSnapshotLatency","Metrics.documentsEvicted","Metrics.transactionsLatency","Metrics.transactionsProcessed","walEntry: WalEntry","Metrics.storageWalAppends","Metrics.transactionsRejected"],"sources":["../src/DocumentManager.ts"],"sourcesContent":["/**\n * @voidhash/mimic-effect - DocumentManager\n *\n * Internal service for managing document lifecycle, including:\n * - Document creation and restoration\n * - Transaction processing\n * - WAL management\n * - Snapshot scheduling\n * - Idle document GC\n */\nimport {\n  Context,\n  Duration,\n  Effect,\n  Fiber,\n  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Schedule,\n  Scope,\n  Stream,\n} from \"effect\";\nimport { Primitive, Transaction } from \"@voidhash/mimic\";\nimport { ServerDocument } from \"@voidhash/mimic/server\";\nimport type {\n  Initial,\n  ResolvedConfig,\n  StoredDocument,\n  WalEntry,\n} from \"./Types\";\nimport type { SnapshotMessage, ServerBroadcast } from \"./Protocol\";\nimport { ColdStorageTag, type ColdStorage } from \"./ColdStorage\";\nimport { HotStorageTag, type HotStorage } from \"./HotStorage\";\nimport * as Metrics from \"./Metrics\";\n\n// =============================================================================\n// Submit Result Types\n// =============================================================================\n\n/**\n * Result of submitting a transaction\n */\nexport type SubmitResult =\n  | { readonly success: true; readonly version: number }\n  | { readonly success: false; readonly reason: string };\n\n// =============================================================================\n// DocumentManager Interface\n// =============================================================================\n\n/**\n * Internal service for managing document lifecycle.\n */\nexport interface DocumentManager {\n  /**\n   * Submit a transaction to a document.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult>;\n\n  /**\n   * Get a snapshot of a document.\n   */\n  readonly getSnapshot: (documentId: string) => Effect.Effect<SnapshotMessage>;\n\n  /**\n   * Subscribe to broadcasts for a document.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<ServerBroadcast>, never, Scope.Scope>;\n\n  /**\n   * Touch a document to update its last activity time.\n   * Call this on any client activity to prevent idle GC.\n   */\n  readonly touch: (documentId: string) => Effect.Effect<void>;\n}\n\n// =============================================================================\n// Context Tag\n// =============================================================================\n\n/**\n * Context tag for DocumentManager service\n */\nexport class DocumentManagerTag extends Context.Tag(\n  \"@voidhash/mimic-effect/DocumentManager\"\n)<DocumentManagerTag, DocumentManager>() {}\n\n// =============================================================================\n// Internal Types\n// =============================================================================\n\n/**\n * Document instance state\n */\ninterface DocumentInstance<TSchema extends Primitive.AnyPrimitive> {\n  /** The underlying ServerDocument */\n  readonly document: ServerDocument.ServerDocument<TSchema>;\n  /** PubSub for broadcasting messages */\n  readonly pubsub: PubSub.PubSub<ServerBroadcast>;\n  /** Version at last snapshot */\n  readonly lastSnapshotVersion: Ref.Ref<number>;\n  /** Timestamp of last snapshot (ms) */\n  readonly lastSnapshotTime: Ref.Ref<number>;\n  /** Transactions since last snapshot */\n  readonly transactionsSinceSnapshot: Ref.Ref<number>;\n  /** Last activity timestamp (ms) */\n  readonly lastActivityTime: Ref.Ref<number>;\n}\n\n// =============================================================================\n// Config Context Tag\n// =============================================================================\n\n/**\n * Context tag for DocumentManager configuration\n */\nexport class DocumentManagerConfigTag extends Context.Tag(\n  \"@voidhash/mimic-effect/DocumentManagerConfig\"\n)<DocumentManagerConfigTag, ResolvedConfig<Primitive.AnyPrimitive>>() {}\n\n// =============================================================================\n// Layer Implementation\n// =============================================================================\n\n/**\n * Create the DocumentManager layer.\n * Requires ColdStorage, HotStorage, and DocumentManagerConfig.\n */\nexport const layer: Layer.Layer<\n  DocumentManagerTag,\n  never,\n  ColdStorageTag | HotStorageTag | DocumentManagerConfigTag\n> = Layer.scoped(\n  DocumentManagerTag,\n  Effect.gen(function* () {\n    const coldStorage = yield* ColdStorageTag;\n    const hotStorage = yield* HotStorageTag;\n    const config = yield* DocumentManagerConfigTag;\n\n    // Store: documentId -> DocumentInstance\n    const store = yield* Ref.make(\n      HashMap.empty<string, DocumentInstance<Primitive.AnyPrimitive>>()\n    );\n\n    // Current schema version (hard-coded to 1 for now)\n    const SCHEMA_VERSION = 1;\n\n    /**\n     * Compute initial state for a new document\n     */\n    const computeInitialState = (\n      documentId: string\n    ): Effect.Effect<Primitive.InferSetInput<typeof config.schema> | undefined> => {\n      if (config.initial === undefined) {\n        return Effect.succeed(undefined);\n      }\n\n      // Check if it's a function or static value\n      if (typeof config.initial === \"function\") {\n        return (config.initial as (ctx: { documentId: string }) => Effect.Effect<Primitive.InferSetInput<typeof config.schema>>)({ documentId });\n      }\n\n      return Effect.succeed(config.initial as Primitive.InferSetInput<typeof config.schema>);\n    };\n\n    /**\n     * Restore a document from storage\n     */\n    const restoreDocument = (\n      documentId: string\n    ): Effect.Effect<DocumentInstance<typeof config.schema>> =>\n      Effect.gen(function* () {\n        // 1. 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<typeof config.schema> | undefined;\n        let initialVersion = 0;\n\n        if (storedDoc) {\n          // Use stored state\n          initialState = storedDoc.state as Primitive.InferSetInput<typeof config.schema>;\n          initialVersion = storedDoc.version;\n        } else {\n          // Compute initial state\n          initialState = yield* computeInitialState(documentId);\n        }\n\n        // 2. Create PubSub for broadcasting\n        const pubsub = yield* PubSub.unbounded<ServerBroadcast>();\n\n        // 3. Create refs for tracking\n        const lastSnapshotVersion = yield* Ref.make(initialVersion);\n        const lastSnapshotTime = yield* Ref.make(Date.now());\n        const transactionsSinceSnapshot = yield* Ref.make(0);\n        const lastActivityTime = yield* Ref.make(Date.now());\n\n        // 4. 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            // This is called synchronously by ServerDocument\n            // We need to publish to PubSub\n            Effect.runSync(\n              PubSub.publish(pubsub, {\n                type: \"transaction\",\n                transaction: message.transaction,\n                version: message.version,\n              })\n            );\n          },\n          onRejection: (transactionId: string, reason: string) => {\n            Effect.runSync(\n              PubSub.publish(pubsub, {\n                type: \"error\",\n                transactionId,\n                reason,\n              })\n            );\n          },\n        });\n\n        // 5. Load and 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        const instance: DocumentInstance<typeof config.schema> = {\n          document,\n          pubsub,\n          lastSnapshotVersion,\n          lastSnapshotTime,\n          transactionsSinceSnapshot,\n          lastActivityTime,\n        };\n\n        // Track metrics - determine if restored or created\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        return instance;\n      });\n\n    /**\n     * Get or create a document instance\n     */\n    const getOrCreateDocument = (\n      documentId: string\n    ): Effect.Effect<DocumentInstance<typeof config.schema>> =>\n      Effect.gen(function* () {\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 as DocumentInstance<typeof config.schema>;\n        }\n\n        // Restore document\n        const instance = yield* restoreDocument(documentId);\n\n        // Store it\n        yield* Ref.update(store, (map) =>\n          HashMap.set(map, documentId, instance)\n        );\n\n        return instance;\n      });\n\n    /**\n     * Save a snapshot to ColdStorage and truncate WAL\n     */\n    const saveSnapshot = (\n      documentId: string,\n      instance: DocumentInstance<typeof config.schema>\n    ): Effect.Effect<void> =>\n      Effect.gen(function* () {\n        const state = instance.document.get();\n        const version = instance.document.getVersion();\n\n        if (state === undefined) {\n          return;\n        }\n\n        const storedDoc: StoredDocument = {\n          state,\n          version,\n          schemaVersion: SCHEMA_VERSION,\n          savedAt: Date.now(),\n        };\n\n        const snapshotStartTime = Date.now();\n\n        // Save to ColdStorage\n        yield* Effect.catchAll(coldStorage.save(documentId, storedDoc), (e) =>\n          Effect.logError(\"Failed to save snapshot\", { documentId, error: e })\n        );\n\n        // Track snapshot metrics\n        const snapshotDuration = Date.now() - snapshotStartTime;\n        yield* Metric.increment(Metrics.storageSnapshots);\n        yield* Metric.update(Metrics.storageSnapshotLatency, snapshotDuration);\n\n        // Truncate WAL\n        yield* Effect.catchAll(hotStorage.truncate(documentId, version), (e) =>\n          Effect.logError(\"Failed to truncate WAL\", { documentId, error: e })\n        );\n\n        // Update tracking\n        yield* Ref.set(instance.lastSnapshotVersion, version);\n        yield* Ref.set(instance.lastSnapshotTime, Date.now());\n        yield* Ref.set(instance.transactionsSinceSnapshot, 0);\n      });\n\n    /**\n     * Check if snapshot should be triggered\n     */\n    const checkSnapshotTriggers = (\n      documentId: string,\n      instance: DocumentInstance<typeof config.schema>\n    ): Effect.Effect<void> =>\n      Effect.gen(function* () {\n        const txCount = yield* Ref.get(instance.transactionsSinceSnapshot);\n        const lastTime = yield* Ref.get(instance.lastSnapshotTime);\n        const now = Date.now();\n\n        const intervalMs = Duration.toMillis(config.snapshot.interval);\n        const threshold = config.snapshot.transactionThreshold;\n\n        // Check transaction threshold\n        if (txCount >= threshold) {\n          yield* saveSnapshot(documentId, instance);\n          return;\n        }\n\n        // Check time interval\n        if (now - lastTime >= intervalMs) {\n          yield* saveSnapshot(documentId, instance);\n          return;\n        }\n      });\n\n    /**\n     * Start background GC fiber\n     */\n    const startGCFiber = Effect.gen(function* () {\n      const gcLoop = Effect.gen(function* () {\n        const current = yield* Ref.get(store);\n        const now = Date.now();\n        const maxIdleMs = Duration.toMillis(config.maxIdleTime);\n\n        for (const [documentId, instance] of current) {\n          const lastActivity = yield* Ref.get(instance.lastActivityTime);\n          if (now - lastActivity >= maxIdleMs) {\n            // Save final snapshot before eviction\n            yield* saveSnapshot(documentId, instance);\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    // Cleanup on shutdown\n    yield* Effect.addFinalizer(() =>\n      Effect.gen(function* () {\n        const current = yield* Ref.get(store);\n        for (const [documentId, instance] of current) {\n          yield* saveSnapshot(documentId, instance);\n        }\n        yield* Effect.logInfo(\"DocumentManager shutdown complete\");\n      })\n    );\n\n    return {\n      submit: (documentId, transaction) =>\n        Effect.gen(function* () {\n          const instance = yield* getOrCreateDocument(documentId);\n          const submitStartTime = Date.now();\n\n          // Submit to ServerDocument\n          const result = instance.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            // Track 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(\n              hotStorage.append(documentId, walEntry),\n              (e) =>\n                Effect.logError(\"Failed to append to WAL\", {\n                  documentId,\n                  error: e,\n                })\n            );\n\n            // Track WAL append\n            yield* Metric.increment(Metrics.storageWalAppends);\n\n            // Increment transaction count\n            yield* Ref.update(\n              instance.transactionsSinceSnapshot,\n              (n) => n + 1\n            );\n\n            // Check snapshot triggers\n            yield* checkSnapshotTriggers(documentId, instance);\n          } else {\n            // Track rejection\n            yield* Metric.increment(Metrics.transactionsRejected);\n          }\n\n          return result;\n        }),\n\n      getSnapshot: (documentId) =>\n        Effect.gen(function* () {\n          const instance = yield* getOrCreateDocument(documentId);\n          return instance.document.getSnapshot();\n        }),\n\n      subscribe: (documentId) =>\n        Effect.gen(function* () {\n          const instance = yield* getOrCreateDocument(documentId);\n          return Stream.fromPubSub(instance.pubsub);\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  })\n);\n\n// =============================================================================\n// Re-export namespace\n// =============================================================================\n\nexport const DocumentManager = {\n  Tag: DocumentManagerTag,\n  ConfigTag: DocumentManagerConfigTag,\n  layer,\n};\n"],"mappings":"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"}