@voidhash/mimic-effect 1.0.0-beta.7 → 1.0.0-beta.8

package/dist/DocumentManager.mjs

@@ -1,297 +0,0 @@
-import { ColdStorageTag } from "./ColdStorage.mjs";
-import { HotStorageTag } from "./HotStorage.mjs";
-import { documentsActive, documentsCreated, documentsEvicted, documentsRestored, storageSnapshotLatency, storageSnapshots, storageVersionGaps, storageWalAppends, transactionsLatency, transactionsProcessed, transactionsRejected, walAppendFailures } from "./Metrics.mjs";
-import { Context, Duration, Effect, HashMap, Layer, Metric, PubSub, Ref, Schedule, Stream } from "effect";
-import { Document } from "@voidhash/mimic";
-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 = Effect.fn("document.restore")(function* (documentId) {
-		const storedDoc = yield* coldStorage.load(documentId);
-		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* hotStorage.getEntries(documentId, initialVersion);
-		if (walEntries.length > 0) {
-			const firstWalVersion = walEntries[0].version;
-			const expectedFirst = initialVersion + 1;
-			if (firstWalVersion !== expectedFirst) {
-				yield* Effect.logWarning("WAL version gap detected", {
-					documentId,
-					snapshotVersion: initialVersion,
-					firstWalVersion,
-					expectedFirst
-				});
-				yield* Metric.increment(storageVersionGaps);
-			}
-			for (let i = 1; i < walEntries.length; i++) {
-				const prev = walEntries[i - 1].version;
-				const curr = walEntries[i].version;
-				if (curr !== prev + 1) yield* Effect.logWarning("WAL internal gap detected", {
-					documentId,
-					previousVersion: prev,
-					currentVersion: curr
-				});
-			}
-		}
-		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 = Effect.fn("document.get-or-create")(function* (documentId) {
-		const current = yield* Ref.get(store);
-		const existing = HashMap.get(current, documentId);
-		if (existing._tag === "Some") {
-			yield* Ref.set(existing.value.lastActivityTime, Date.now());
-			return existing.value;
-		}
-		const instance = yield* restoreDocument(documentId);
-		yield* Ref.update(store, (map) => HashMap.set(map, documentId, instance));
-		return instance;
-	});
-	/**
-	* Save a snapshot to ColdStorage derived from WAL entries.
-	* This ensures snapshots are always based on durable WAL data.
-	* Idempotent: skips save if already snapshotted at target version.
-	* Truncate failures are non-fatal and will be retried on next snapshot.
-	*/
-	const saveSnapshot = Effect.fn("document.snapshot.save")(function* (documentId, instance, targetVersion) {
-		var _baseSnapshot$version;
-		if (targetVersion <= (yield* Ref.get(instance.lastSnapshotVersion))) return;
-		const snapshotStartTime = Date.now();
-		const baseSnapshot = yield* coldStorage.load(documentId);
-		const baseVersion = (_baseSnapshot$version = baseSnapshot === null || baseSnapshot === void 0 ? void 0 : baseSnapshot.version) !== null && _baseSnapshot$version !== void 0 ? _baseSnapshot$version : 0;
-		const baseState = baseSnapshot === null || baseSnapshot === void 0 ? void 0 : baseSnapshot.state;
-		const relevantEntries = (yield* hotStorage.getEntries(documentId, baseVersion)).filter((e) => e.version <= targetVersion);
-		if (relevantEntries.length === 0 && !baseSnapshot) return;
-		let snapshotState = baseState;
-		for (const entry of relevantEntries) {
-			const tempDoc = Document.make(config.schema, { initialState: snapshotState });
-			tempDoc.apply(entry.transaction.ops);
-			snapshotState = tempDoc.get();
-		}
-		if (snapshotState === void 0) return;
-		const snapshotVersion = relevantEntries.length > 0 ? relevantEntries[relevantEntries.length - 1].version : baseVersion;
-		if (snapshotVersion <= (yield* Ref.get(instance.lastSnapshotVersion))) return;
-		const storedDoc = {
-			state: snapshotState,
-			version: snapshotVersion,
-			schemaVersion: SCHEMA_VERSION,
-			savedAt: Date.now()
-		};
-		yield* coldStorage.save(documentId, storedDoc);
-		const snapshotDuration = Date.now() - snapshotStartTime;
-		yield* Metric.increment(storageSnapshots);
-		yield* Metric.update(storageSnapshotLatency, snapshotDuration);
-		yield* Ref.set(instance.lastSnapshotVersion, snapshotVersion);
-		yield* Ref.set(instance.lastSnapshotTime, Date.now());
-		yield* Ref.set(instance.transactionsSinceSnapshot, 0);
-		yield* Effect.catchAll(hotStorage.truncate(documentId, snapshotVersion), (e) => Effect.logWarning("WAL truncate failed - will retry on next snapshot", {
-			documentId,
-			version: snapshotVersion,
-			error: e
-		}));
-	});
-	/**
-	* Check if snapshot should be triggered
-	*/
-	const checkSnapshotTriggers = Effect.fn("document.snapshot.check-triggers")(function* (documentId, instance) {
-		const txCount = yield* Ref.get(instance.transactionsSinceSnapshot);
-		const lastTime = yield* Ref.get(instance.lastSnapshotTime);
-		const now = Date.now();
-		const currentVersion = instance.document.getVersion();
-		const intervalMs = Duration.toMillis(config.snapshot.interval);
-		if (txCount >= config.snapshot.transactionThreshold) {
-			yield* saveSnapshot(documentId, instance, currentVersion);
-			return;
-		}
-		if (now - lastTime >= intervalMs) {
-			yield* saveSnapshot(documentId, instance, currentVersion);
-			return;
-		}
-	});
-	yield* Effect.fn("document.gc.start")(function* () {
-		yield* Effect.fn("document.gc.loop")(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) {
-				const currentVersion = instance.document.getVersion();
-				yield* Effect.catchAll(saveSnapshot(documentId, instance, currentVersion), (e) => Effect.logError("Failed to save snapshot during eviction", {
-					documentId,
-					error: e
-				}));
-				yield* Ref.update(store, (map) => HashMap.remove(map, documentId));
-				yield* Metric.increment(documentsEvicted);
-				yield* Metric.incrementBy(documentsActive, -1);
-				yield* Effect.logInfo("Document evicted due to idle timeout", { documentId });
-			}
-		})().pipe(Effect.repeat(Schedule.spaced("1 minute")), Effect.fork);
-	})();
-	yield* Effect.addFinalizer(() => Effect.fn("document-manager.shutdown")(function* () {
-		const current = yield* Ref.get(store);
-		for (const [documentId, instance] of current) {
-			const currentVersion = instance.document.getVersion();
-			yield* Effect.catchAll(saveSnapshot(documentId, instance, currentVersion), (e) => Effect.logError("Failed to save snapshot during shutdown", {
-				documentId,
-				error: e
-			}));
-		}
-		yield* Effect.logInfo("DocumentManager shutdown complete");
-	})());
-	return {
-		submit: Effect.fn("document.transaction.submit")(function* (documentId, transaction) {
-			const instance = yield* getOrCreateDocument(documentId);
-			const submitStartTime = Date.now();
-			const validation = instance.document.validate(transaction);
-			if (!validation.valid) {
-				yield* Metric.increment(transactionsRejected);
-				const latency$1 = Date.now() - submitStartTime;
-				yield* Metric.update(transactionsLatency, latency$1);
-				return {
-					success: false,
-					reason: validation.reason
-				};
-			}
-			const walEntry = {
-				transaction,
-				version: validation.nextVersion,
-				timestamp: Date.now()
-			};
-			const appendResult = yield* Effect.either(hotStorage.appendWithCheck(documentId, walEntry, validation.nextVersion));
-			if (appendResult._tag === "Left") {
-				yield* Effect.logError("WAL append failed", {
-					documentId,
-					version: validation.nextVersion,
-					error: appendResult.left
-				});
-				yield* Metric.increment(walAppendFailures);
-				const latency$1 = Date.now() - submitStartTime;
-				yield* Metric.update(transactionsLatency, latency$1);
-				return {
-					success: false,
-					reason: "Storage unavailable. Please retry."
-				};
-			}
-			instance.document.apply(transaction);
-			const latency = Date.now() - submitStartTime;
-			yield* Metric.update(transactionsLatency, latency);
-			yield* Metric.increment(transactionsProcessed);
-			yield* Metric.increment(storageWalAppends);
-			yield* Ref.update(instance.transactionsSinceSnapshot, (n) => n + 1);
-			yield* checkSnapshotTriggers(documentId, instance);
-			return {
-				success: true,
-				version: validation.nextVersion
-			};
-		}),
-		getSnapshot: Effect.fn("document.snapshot.get")(function* (documentId) {
-			return (yield* getOrCreateDocument(documentId)).document.getSnapshot();
-		}),
-		subscribe: Effect.fn("document.subscribe")(function* (documentId) {
-			const instance = yield* getOrCreateDocument(documentId);
-			return Stream.fromPubSub(instance.pubsub);
-		}),
-		touch: Effect.fn("document.touch")(function* (documentId) {
-			const current = yield* Ref.get(store);
-			const existing = HashMap.get(current, documentId);
-			if (existing._tag === "Some") yield* Ref.set(existing.value.lastActivityTime, Date.now());
-		})
-	};
-}));
-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":["initialState: Primitive.InferSetInput<typeof config.schema> | undefined","Metrics.storageVersionGaps","instance: DocumentInstance<typeof config.schema>","Metrics.documentsRestored","Metrics.documentsCreated","Metrics.documentsActive","snapshotState: Primitive.InferState<typeof config.schema> | undefined","storedDoc: StoredDocument","Metrics.storageSnapshots","Metrics.storageSnapshotLatency","Metrics.documentsEvicted","Metrics.transactionsRejected","latency","Metrics.transactionsLatency","walEntry: WalEntry","Metrics.walAppendFailures","Metrics.transactionsProcessed","Metrics.storageWalAppends"],"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  HashMap,\n  Layer,\n  Metric,\n  PubSub,\n  Ref,\n  Schedule,\n  Scope,\n  Stream,\n} from \"effect\";\nimport { Document, Primitive, Transaction } from \"@voidhash/mimic\";\nimport { ServerDocument } from \"@voidhash/mimic/server\";\nimport type {\n  ResolvedConfig,\n  StoredDocument,\n  WalEntry,\n} from \"./Types\";\nimport type { SnapshotMessage, ServerBroadcast } from \"./Protocol\";\nimport { ColdStorageTag } from \"./ColdStorage\";\nimport { HotStorageTag } from \"./HotStorage\";\nimport { ColdStorageError, HotStorageError } from \"./Errors\";\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 * Error type for DocumentManager operations\n */\nexport type DocumentManagerError = ColdStorageError | HotStorageError;\n\n/**\n * Internal service for managing document lifecycle.\n */\nexport interface DocumentManager {\n  /**\n   * Submit a transaction to a document.\n   * May fail with ColdStorageError or HotStorageError if storage is unavailable.\n   */\n  readonly submit: (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ) => Effect.Effect<SubmitResult, DocumentManagerError>;\n\n  /**\n   * Get a snapshot of a document.\n   * May fail with ColdStorageError or HotStorageError if storage is unavailable.\n   */\n  readonly getSnapshot: (documentId: string) => Effect.Effect<SnapshotMessage, DocumentManagerError>;\n\n  /**\n   * Subscribe to broadcasts for a document.\n   * May fail with ColdStorageError or HotStorageError if storage is unavailable.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<Stream.Stream<ServerBroadcast>, DocumentManagerError, 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.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 = Effect.fn(\"document.restore\")(\n      function* (documentId: string) {\n        // 1. Load snapshot from ColdStorage (errors propagate - do not silently fallback)\n        const storedDoc = yield* coldStorage.load(documentId);\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 WAL entries (errors propagate - do not silently fallback)\n        const walEntries = yield* hotStorage.getEntries(documentId, initialVersion);\n\n        // 6. Verify WAL continuity (warning only, non-blocking)\n        if (walEntries.length > 0) {\n          const firstWalVersion = walEntries[0]!.version;\n          const expectedFirst = initialVersion + 1;\n\n          if (firstWalVersion !== expectedFirst) {\n            yield* Effect.logWarning(\"WAL version gap detected\", {\n              documentId,\n              snapshotVersion: initialVersion,\n              firstWalVersion,\n              expectedFirst,\n            });\n            yield* Metric.increment(Metrics.storageVersionGaps);\n          }\n\n          // Check internal gaps\n          for (let i = 1; i < walEntries.length; i++) {\n            const prev = walEntries[i - 1]!.version;\n            const curr = walEntries[i]!.version;\n            if (curr !== prev + 1) {\n              yield* Effect.logWarning(\"WAL internal gap detected\", {\n                documentId,\n                previousVersion: prev,\n                currentVersion: curr,\n              });\n            }\n          }\n        }\n\n        // 7. Replay WAL entries\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    /**\n     * Get or create a document instance\n     */\n    const getOrCreateDocument = Effect.fn(\"document.get-or-create\")(\n      function* (documentId: string) {\n        const current = yield* Ref.get(store);\n        const existing = HashMap.get(current, documentId);\n\n        if (existing._tag === \"Some\") {\n          // Update activity time\n          yield* Ref.set(existing.value.lastActivityTime, Date.now());\n          return existing.value 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    /**\n     * Save a snapshot to ColdStorage derived from WAL entries.\n     * This ensures snapshots are always based on durable WAL data.\n     * Idempotent: skips save if already snapshotted at target version.\n     * Truncate failures are non-fatal and will be retried on next snapshot.\n     */\n    const saveSnapshot = Effect.fn(\"document.snapshot.save\")(\n      function* (\n        documentId: string,\n        instance: DocumentInstance<typeof config.schema>,\n        targetVersion: number\n      ) {\n        const lastSnapshotVersion = yield* Ref.get(instance.lastSnapshotVersion);\n\n        // Idempotency check: skip if already snapshotted at this version\n        if (targetVersion <= lastSnapshotVersion) {\n          return;\n        }\n\n        const snapshotStartTime = Date.now();\n\n        // Load base snapshot from cold storage\n        const baseSnapshot = yield* coldStorage.load(documentId);\n        const baseVersion = baseSnapshot?.version ?? 0;\n        const baseState = baseSnapshot?.state as Primitive.InferState<typeof config.schema> | undefined;\n\n        // Load WAL entries from base to target\n        const walEntries = yield* hotStorage.getEntries(documentId, baseVersion);\n        const relevantEntries = walEntries.filter(e => e.version <= targetVersion);\n\n        if (relevantEntries.length === 0 && !baseSnapshot) {\n          // Nothing to snapshot\n          return;\n        }\n\n        // Rebuild state by replaying WAL on base\n        let snapshotState: Primitive.InferState<typeof config.schema> | undefined = baseState;\n        for (const entry of relevantEntries) {\n          // Create a temporary document to apply the transaction\n          const tempDoc = Document.make(config.schema, { initialState: snapshotState });\n          tempDoc.apply(entry.transaction.ops);\n          snapshotState = tempDoc.get();\n        }\n\n        if (snapshotState === undefined) {\n          return;\n        }\n\n        const snapshotVersion = relevantEntries.length > 0\n          ? relevantEntries[relevantEntries.length - 1]!.version\n          : baseVersion;\n\n        // Re-check before saving (in case another snapshot completed while we were working)\n        // This prevents a slower snapshot from overwriting a more recent one\n        const currentLastSnapshot = yield* Ref.get(instance.lastSnapshotVersion);\n        if (snapshotVersion <= currentLastSnapshot) {\n          return;\n        }\n\n        const storedDoc: StoredDocument = {\n          state: snapshotState,\n          version: snapshotVersion,\n          schemaVersion: SCHEMA_VERSION,\n          savedAt: Date.now(),\n        };\n\n        // Save to ColdStorage - let errors propagate\n        yield* coldStorage.save(documentId, storedDoc);\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        // Update tracking BEFORE truncate (for idempotency on retry)\n        yield* Ref.set(instance.lastSnapshotVersion, snapshotVersion);\n        yield* Ref.set(instance.lastSnapshotTime, Date.now());\n        yield* Ref.set(instance.transactionsSinceSnapshot, 0);\n\n        // Truncate WAL - non-fatal, will be retried on next snapshot\n        yield* Effect.catchAll(hotStorage.truncate(documentId, snapshotVersion), (e) =>\n          Effect.logWarning(\"WAL truncate failed - will retry on next snapshot\", {\n            documentId,\n            version: snapshotVersion,\n            error: e,\n          })\n        );\n      }\n    );\n\n    /**\n     * Check if snapshot should be triggered\n     */\n    const checkSnapshotTriggers = Effect.fn(\"document.snapshot.check-triggers\")(\n      function* (\n        documentId: string,\n        instance: DocumentInstance<typeof config.schema>\n      ) {\n        const txCount = yield* Ref.get(instance.transactionsSinceSnapshot);\n        const lastTime = yield* Ref.get(instance.lastSnapshotTime);\n        const now = Date.now();\n        const currentVersion = instance.document.getVersion();\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, currentVersion);\n          return;\n        }\n\n        // Check time interval\n        if (now - lastTime >= intervalMs) {\n          yield* saveSnapshot(documentId, instance, currentVersion);\n          return;\n        }\n      }\n    );\n\n    /**\n     * Start background GC fiber\n     */\n    const startGCFiber = Effect.fn(\"document.gc.start\")(function* () {\n      const gcLoop = Effect.fn(\"document.gc.loop\")(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 (best effort)\n            const currentVersion = instance.document.getVersion();\n            yield* Effect.catchAll(saveSnapshot(documentId, instance, currentVersion), (e) =>\n              Effect.logError(\"Failed to save snapshot during eviction\", {\n                documentId,\n                error: e,\n              })\n            );\n\n            // Remove from store\n            yield* Ref.update(store, (map) => HashMap.remove(map, documentId));\n\n            // Track eviction metrics\n            yield* Metric.increment(Metrics.documentsEvicted);\n            yield* Metric.incrementBy(Metrics.documentsActive, -1);\n\n            yield* Effect.logInfo(\"Document evicted due to idle timeout\", {\n              documentId,\n            });\n          }\n        }\n      });\n\n      // Run GC every minute\n      yield* gcLoop().pipe(\n        Effect.repeat(Schedule.spaced(\"1 minute\")),\n        Effect.fork\n      );\n    });\n\n    // Start GC fiber\n    yield* startGCFiber();\n\n    // Cleanup on shutdown\n    yield* Effect.addFinalizer(() =>\n      Effect.fn(\"document-manager.shutdown\")(function* () {\n        const current = yield* Ref.get(store);\n        for (const [documentId, instance] of current) {\n          // Best effort save - don't fail shutdown if storage is unavailable\n          const currentVersion = instance.document.getVersion();\n          yield* Effect.catchAll(saveSnapshot(documentId, instance, currentVersion), (e) =>\n            Effect.logError(\"Failed to save snapshot during shutdown\", {\n              documentId,\n              error: e,\n            })\n          );\n        }\n        yield* Effect.logInfo(\"DocumentManager shutdown complete\");\n      })()\n    );\n\n    return {\n      submit: Effect.fn(\"document.transaction.submit\")(\n        function* (documentId: string, transaction: Transaction.Transaction) {\n          const instance = yield* getOrCreateDocument(documentId);\n          const submitStartTime = Date.now();\n\n          // Phase 1: Validate (no side effects)\n          const validation = instance.document.validate(transaction);\n\n          if (!validation.valid) {\n            // Track rejection\n            yield* Metric.increment(Metrics.transactionsRejected);\n            const latency = Date.now() - submitStartTime;\n            yield* Metric.update(Metrics.transactionsLatency, latency);\n\n            return {\n              success: false as const,\n              reason: validation.reason,\n            };\n          }\n\n          // Phase 2: Append to WAL with gap check (BEFORE state mutation)\n          const walEntry: WalEntry = {\n            transaction,\n            version: validation.nextVersion,\n            timestamp: Date.now(),\n          };\n\n          const appendResult = yield* Effect.either(\n            hotStorage.appendWithCheck(documentId, walEntry, validation.nextVersion)\n          );\n\n          if (appendResult._tag === \"Left\") {\n            // WAL append failed - do NOT apply, state unchanged\n            yield* Effect.logError(\"WAL append failed\", {\n              documentId,\n              version: validation.nextVersion,\n              error: appendResult.left,\n            });\n            yield* Metric.increment(Metrics.walAppendFailures);\n\n            const latency = Date.now() - submitStartTime;\n            yield* Metric.update(Metrics.transactionsLatency, latency);\n\n            // Return failure - client must retry\n            return {\n              success: false as const,\n              reason: \"Storage unavailable. Please retry.\",\n            };\n          }\n\n          // Phase 3: Apply (state mutation + broadcast)\n          instance.document.apply(transaction);\n\n          // Track metrics\n          const latency = Date.now() - submitStartTime;\n          yield* Metric.update(Metrics.transactionsLatency, latency);\n          yield* Metric.increment(Metrics.transactionsProcessed);\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\n          return {\n            success: true as const,\n            version: validation.nextVersion,\n          };\n        }\n      ),\n\n      getSnapshot: Effect.fn(\"document.snapshot.get\")(\n        function* (documentId: string) {\n          const instance = yield* getOrCreateDocument(documentId);\n          return instance.document.getSnapshot();\n        }\n      ),\n\n      subscribe: Effect.fn(\"document.subscribe\")(\n        function* (documentId: string) {\n          const instance = yield* getOrCreateDocument(documentId);\n          return Stream.fromPubSub(instance.pubsub);\n        }\n      ),\n\n      touch: Effect.fn(\"document.touch\")(function* (documentId: string) {\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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"}