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

package/dist/DocumentManager.d.mts

@@ -1,19 +1,24 @@
-import { ServerBroadcast, SnapshotMessage, SubmitResult } from "./DocumentProtocol.mjs";
-import { MimicServerConfigTag } from "./MimicConfig.mjs";
-import { MimicDataStorageTag } from "./MimicDataStorage.mjs";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as Context from "effect/Context";
-import * as Stream from "effect/Stream";
+import { 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";
-import * as Scope from "effect/Scope";
 
 //#region src/DocumentManager.d.ts
-declare namespace DocumentManager_d_exports {
-  export { DocumentManager, DocumentManagerTag, layer };
-}
+
+/**
+ * Result of submitting a transaction
+ */
+type SubmitResult = {
+  readonly success: true;
+  readonly version: number;
+} | {
+  readonly success: false;
+  readonly reason: string;
+};
 /**
- * Service interface for the DocumentManager.
+ * Internal service for managing document lifecycle.
  */
 interface DocumentManager {
   /**
@@ -26,20 +31,29 @@ interface DocumentManager {
   readonly getSnapshot: (documentId: string) => Effect.Effect<SnapshotMessage>;
   /**
    * Subscribe to broadcasts for a document.
-   * Returns a Stream of server broadcasts.
    */
   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-server-effect/DocumentManager", DocumentManager>;
+declare const DocumentManagerTag_base: Context.TagClass<DocumentManagerTag, "@voidhash/mimic-effect/DocumentManager", DocumentManager>;
 /**
- * Context tag for 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>>;
 /**
- * Layer that provides DocumentManager.
- * Requires MimicServerConfigTag and MimicDataStorageTag.
+ * Context tag for DocumentManager configuration
  */
-declare const layer: Layer.Layer<DocumentManagerTag, never, MimicServerConfigTag | MimicDataStorageTag>;
+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 { DocumentManagerTag, DocumentManager_d_exports };
+export { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, SubmitResult };
 //# sourceMappingURL=DocumentManager.d.mts.map

package/dist/DocumentManager.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentManager.d.mts","names":[],"sources":["../src/DocumentManager.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UA2CiB,eAAA;EAAA;;;EAOV,SAAO,MAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,WAAA,EADG,WAAA,CAAY,WACf,EAAA,GAAP,MAAA,CAAO,MAAA,CAAO,YAAP,CAAA;EAOO;;;EASjB,SAAO,WAAA,EAAA,CAAA,UAAA,EAAA,MAAA,EAAA,GATJ,MAAA,CAAO,MASH,CATU,eASV,CAAA;EAEP;;;AAEH;8CALM,MAAA,CAAO,OACV,MAAA,CAAO,OAAO,yBAEd,KAAA,CAAM;;cAET;;AAKD;AA8KA;AACE,cA/KW,kBAAA,SAA2B,uBAAA,CA+KtC;;;;;cADW,OAAO,KAAA,CAAM,MACxB,2BAEA,uBAAuB"}
+{"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,61 +1,72 @@
-import { __export } from "./_virtual/rolldown_runtime.mjs";
-import { MimicServerConfigTag } from "./MimicConfig.mjs";
-import { MimicDataStorageTag } from "./MimicDataStorage.mjs";
-import * as Effect from "effect/Effect";
-import * as Layer from "effect/Layer";
-import * as PubSub from "effect/PubSub";
-import * as Ref from "effect/Ref";
-import * as HashMap from "effect/HashMap";
-import * as Context from "effect/Context";
-import * as Stream from "effect/Stream";
+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
 /**
-* @since 0.0.1
-* Document manager that handles multiple document instances.
+* @voidhash/mimic-effect - DocumentManager
+*
+* Internal service for managing document lifecycle, including:
+* - Document creation and restoration
+* - Transaction processing
+* - WAL management
+* - Snapshot scheduling
+* - Idle document GC
 */
-var DocumentManager_exports = /* @__PURE__ */ __export({
-	DocumentManagerTag: () => DocumentManagerTag,
-	layer: () => layer
-});
 /**
-* Context tag for DocumentManager.
+* Context tag for DocumentManager service
 */
-var DocumentManagerTag = class extends Context.Tag("@voidhash/mimic-server-effect/DocumentManager")() {};
+var DocumentManagerTag = class extends Context.Tag("@voidhash/mimic-effect/DocumentManager")() {};
 /**
-* Create the DocumentManager service.
+* Context tag for DocumentManager configuration
 */
-const makeDocumentManager = Effect.gen(function* () {
-	const config = yield* MimicServerConfigTag;
-	const storage = yield* MimicDataStorageTag;
-	const documents = yield* Ref.make(HashMap.empty());
-	const getOrCreateDocument = (documentId) => Effect.gen(function* () {
-		const current = yield* Ref.get(documents);
-		const existing = HashMap.get(current, documentId);
-		if (existing._tag === "Some") {
-			yield* Ref.update(existing.value.refCount, (n) => n + 1);
-			return existing.value;
-		}
-		const rawState = yield* Effect.catchAll(storage.load(documentId), () => Effect.succeed(void 0));
-		const initialState = rawState !== void 0 ? yield* storage.onLoad(rawState) : config.initial !== void 0 ? yield* config.initial({ documentId }) : void 0;
+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 serverDocument = ServerDocument.make({
+		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: (transactionMessage) => {
-				const currentState = serverDocument.get();
-				Effect.runFork(Effect.gen(function* () {
-					if (currentState !== void 0) {
-						const transformedState = yield* storage.onSave(currentState);
-						yield* Effect.catchAll(storage.save(documentId, transformedState), (error) => Effect.logError("Failed to save document", error));
-					}
-				}));
+			onBroadcast: (message) => {
 				Effect.runSync(PubSub.publish(pubsub, {
 					type: "transaction",
-					transaction: transactionMessage.transaction,
-					version: transactionMessage.version
+					transaction: message.transaction,
+					version: message.version
 				}));
 			},
 			onRejection: (transactionId, reason) => {
@@ -66,40 +77,151 @@ const makeDocumentManager = Effect.gen(function* () {
 				}));
 			}
 		});
+		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: serverDocument,
+			document,
 			pubsub,
-			refCount: yield* Ref.make(1)
+			lastSnapshotVersion,
+			lastSnapshotTime,
+			transactionsSinceSnapshot,
+			lastActivityTime
 		};
-		yield* Ref.update(documents, (map) => HashMap.set(map, documentId, instance));
+		if (storedDoc) yield* Metric.increment(documentsRestored);
+		else yield* Metric.increment(documentsCreated);
+		yield* Metric.incrementBy(documentsActive, 1);
 		return instance;
 	});
-	const submit = (documentId, transaction) => Effect.gen(function* () {
-		return (yield* getOrCreateDocument(documentId)).document.submit(transaction);
-	});
-	const getSnapshot = (documentId) => Effect.gen(function* () {
-		return (yield* getOrCreateDocument(documentId)).document.getSnapshot();
+	/**
+	* 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;
 	});
-	const subscribe = (documentId) => Effect.gen(function* () {
-		const instance = yield* getOrCreateDocument(documentId);
-		const queue = yield* PubSub.subscribe(instance.pubsub);
-		yield* Effect.addFinalizer(() => Effect.gen(function* () {
-			yield* Ref.updateAndGet(instance.refCount, (n) => n - 1);
+	/**
+	* 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
 		}));
-		return Stream.fromQueue(queue);
+		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,
-		getSnapshot,
-		subscribe
+		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());
+		})
 	};
-});
-/**
-* Layer that provides DocumentManager.
-* Requires MimicServerConfigTag and MimicDataStorageTag.
-*/
-const layer = Layer.effect(DocumentManagerTag, makeDocumentManager);
+}));
+const DocumentManager = {
+	Tag: DocumentManagerTag,
+	ConfigTag: DocumentManagerConfigTag,
+	layer
+};
 
 //#endregion
-export { DocumentManagerTag, DocumentManager_exports, layer };
+export { DocumentManager, DocumentManagerConfigTag, DocumentManagerTag, layer };
 //# sourceMappingURL=DocumentManager.mjs.map

package/dist/DocumentManager.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentManager.mjs","names":["instance: DocumentInstance","layer: Layer.Layer<\n  DocumentManagerTag,\n  never,\n  MimicServerConfigTag | MimicDataStorageTag\n>"],"sources":["../src/DocumentManager.ts"],"sourcesContent":["/**\n * @since 0.0.1\n * Document manager that handles multiple document instances.\n */\nimport * as Effect from \"effect/Effect\";\nimport * as Layer from \"effect/Layer\";\nimport * as PubSub from \"effect/PubSub\";\nimport * as Ref from \"effect/Ref\";\nimport * as HashMap from \"effect/HashMap\";\nimport * as Context from \"effect/Context\";\nimport * as Scope from \"effect/Scope\";\nimport * as Stream from \"effect/Stream\";\nimport type { Primitive, Transaction } from \"@voidhash/mimic\";\nimport { ServerDocument } from \"@voidhash/mimic/server\";\n\nimport * as Protocol from \"./DocumentProtocol.js\";\nimport { MimicServerConfigTag } from \"./MimicConfig.js\";\nimport { MimicDataStorageTag } from \"./MimicDataStorage.js\";\nimport { DocumentNotFoundError } from \"./errors.js\";\n\n// =============================================================================\n// Document Instance\n// =============================================================================\n\n/**\n * A managed document instance that holds state and manages subscribers.\n */\ninterface DocumentInstance {\n  /** The underlying ServerDocument */\n  readonly document: ServerDocument.ServerDocument<Primitive.AnyPrimitive>;\n  /** PubSub for broadcasting messages to subscribers */\n  readonly pubsub: PubSub.PubSub<Protocol.ServerBroadcast>;\n  /** Reference count for cleanup */\n  readonly refCount: Ref.Ref<number>;\n}\n\n// =============================================================================\n// Document Manager Service\n// =============================================================================\n\n/**\n * Service interface for the DocumentManager.\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<Protocol.SubmitResult>;\n\n  /**\n   * Get a snapshot of a document.\n   */\n  readonly getSnapshot: (\n    documentId: string\n  ) => Effect.Effect<Protocol.SnapshotMessage>;\n\n  /**\n   * Subscribe to broadcasts for a document.\n   * Returns a Stream of server broadcasts.\n   */\n  readonly subscribe: (\n    documentId: string\n  ) => Effect.Effect<\n    Stream.Stream<Protocol.ServerBroadcast>,\n    never,\n    Scope.Scope\n  >;\n}\n\n/**\n * Context tag for DocumentManager.\n */\nexport class DocumentManagerTag extends Context.Tag(\n  \"@voidhash/mimic-server-effect/DocumentManager\"\n)<DocumentManagerTag, DocumentManager>() {}\n\n// =============================================================================\n// Document Manager Implementation\n// =============================================================================\n\n/**\n * Create the DocumentManager service.\n */\nconst makeDocumentManager = Effect.gen(function* () {\n  const config = yield* MimicServerConfigTag;\n  const storage = yield* MimicDataStorageTag;\n  \n  // Map of document ID to document instance\n  const documents = yield* Ref.make(\n    HashMap.empty<string, DocumentInstance>()\n  );\n\n  // Get or create a document instance\n  const getOrCreateDocument = (\n    documentId: string\n  ): Effect.Effect<DocumentInstance> =>\n    Effect.gen(function* () {\n      const current = yield* Ref.get(documents);\n      const existing = HashMap.get(current, documentId);\n\n      if (existing._tag === \"Some\") {\n        // Increment ref count\n        yield* Ref.update(existing.value.refCount, (n) => n + 1);\n        return existing.value;\n      }\n\n      // Load initial state from storage\n      const rawState = yield* Effect.catchAll(\n        storage.load(documentId),\n        () => Effect.succeed(undefined)\n      );\n\n      // Transform loaded state with onLoad hook, or compute initial state for new docs\n      const initialState = rawState !== undefined\n        ? yield* storage.onLoad(rawState)\n        : config.initial !== undefined\n          ? yield* config.initial({ documentId })\n          : undefined;\n\n      // Create PubSub for broadcasting\n      const pubsub = yield* PubSub.unbounded<Protocol.ServerBroadcast>();\n\n      // Create ServerDocument with broadcast callback\n      const serverDocument = ServerDocument.make({\n        schema: config.schema,\n        initialState: initialState as Primitive.InferSetInput<typeof config.schema> | undefined,\n        maxTransactionHistory: config.maxTransactionHistory,\n        onBroadcast: (transactionMessage) => {\n          // Get current state and save to storage\n          const currentState = serverDocument.get();\n          \n          // Run save in background (fire-and-forget with error logging)\n          Effect.runFork(\n            Effect.gen(function* () {\n              if (currentState !== undefined) {\n                const transformedState = yield* storage.onSave(currentState);\n                yield* Effect.catchAll(\n                  storage.save(documentId, transformedState),\n                  (error) => Effect.logError(\"Failed to save document\", error)\n                );\n              }\n            })\n          );\n\n          // Broadcast to subscribers\n          Effect.runSync(\n            PubSub.publish(pubsub, {\n              type: \"transaction\",\n              transaction: transactionMessage.transaction as Protocol.Transaction,\n              version: transactionMessage.version,\n            })\n          );\n        },\n        onRejection: (transactionId, reason) => {\n          Effect.runSync(\n            PubSub.publish(pubsub, {\n              type: \"error\",\n              transactionId,\n              reason,\n            })\n          );\n        },\n      });\n\n      const refCount = yield* Ref.make(1);\n\n      const instance: DocumentInstance = {\n        document: serverDocument,\n        pubsub,\n        refCount,\n      };\n\n      // Store in map\n      yield* Ref.update(documents, (map) =>\n        HashMap.set(map, documentId, instance)\n      );\n\n      return instance;\n    });\n\n  // Submit a transaction\n  const submit = (\n    documentId: string,\n    transaction: Transaction.Transaction\n  ): Effect.Effect<Protocol.SubmitResult> =>\n    Effect.gen(function* () {\n      const instance = yield* getOrCreateDocument(documentId);\n      const result = instance.document.submit(transaction);\n      return result;\n    });\n\n  // Get a snapshot\n  const getSnapshot = (\n    documentId: string\n  ): Effect.Effect<Protocol.SnapshotMessage> =>\n    Effect.gen(function* () {\n      const instance = yield* getOrCreateDocument(documentId);\n      const snapshot = instance.document.getSnapshot();\n      return snapshot;\n    });\n\n  // Subscribe to broadcasts\n  const subscribe = (\n    documentId: string\n  ): Effect.Effect<\n    Stream.Stream<Protocol.ServerBroadcast>,\n    never,\n    Scope.Scope\n  > =>\n    Effect.gen(function* () {\n      const instance = yield* getOrCreateDocument(documentId);\n\n      // Subscribe to the PubSub\n      const queue = yield* PubSub.subscribe(instance.pubsub);\n\n      // Ensure cleanup on scope close\n      yield* Effect.addFinalizer(() =>\n        Effect.gen(function* () {\n          // Decrement ref count\n          const count = yield* Ref.updateAndGet(\n            instance.refCount,\n            (n) => n - 1\n          );\n\n          // If no more subscribers, we could clean up the document\n          // For now, we keep it alive (could add idle timeout)\n        })\n      );\n\n      // Convert queue to stream\n      return Stream.fromQueue(queue);\n    });\n\n  const manager: DocumentManager = {\n    submit,\n    getSnapshot,\n    subscribe,\n  };\n\n  return manager;\n});\n\n/**\n * Layer that provides DocumentManager.\n * Requires MimicServerConfigTag and MimicDataStorageTag.\n */\nexport const layer: Layer.Layer<\n  DocumentManagerTag,\n  never,\n  MimicServerConfigTag | MimicDataStorageTag\n> = Layer.effect(DocumentManagerTag, makeDocumentManager);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2EA,IAAa,qBAAb,cAAwC,QAAQ,IAC9C,gDACD,EAAuC,CAAC;;;;AASzC,MAAM,sBAAsB,OAAO,IAAI,aAAa;CAClD,MAAM,SAAS,OAAO;CACtB,MAAM,UAAU,OAAO;CAGvB,MAAM,YAAY,OAAO,IAAI,KAC3B,QAAQ,OAAiC,CAC1C;CAGD,MAAM,uBACJ,eAEA,OAAO,IAAI,aAAa;EACtB,MAAM,UAAU,OAAO,IAAI,IAAI,UAAU;EACzC,MAAM,WAAW,QAAQ,IAAI,SAAS,WAAW;AAEjD,MAAI,SAAS,SAAS,QAAQ;AAE5B,UAAO,IAAI,OAAO,SAAS,MAAM,WAAW,MAAM,IAAI,EAAE;AACxD,UAAO,SAAS;;EAIlB,MAAM,WAAW,OAAO,OAAO,SAC7B,QAAQ,KAAK,WAAW,QAClB,OAAO,QAAQ,OAAU,CAChC;EAGD,MAAM,eAAe,aAAa,SAC9B,OAAO,QAAQ,OAAO,SAAS,GAC/B,OAAO,YAAY,SACjB,OAAO,OAAO,QAAQ,EAAE,YAAY,CAAC,GACrC;EAGN,MAAM,SAAS,OAAO,OAAO,WAAqC;EAGlE,MAAM,iBAAiB,eAAe,KAAK;GACzC,QAAQ,OAAO;GACD;GACd,uBAAuB,OAAO;GAC9B,cAAc,uBAAuB;IAEnC,MAAM,eAAe,eAAe,KAAK;AAGzC,WAAO,QACL,OAAO,IAAI,aAAa;AACtB,SAAI,iBAAiB,QAAW;MAC9B,MAAM,mBAAmB,OAAO,QAAQ,OAAO,aAAa;AAC5D,aAAO,OAAO,SACZ,QAAQ,KAAK,YAAY,iBAAiB,GACzC,UAAU,OAAO,SAAS,2BAA2B,MAAM,CAC7D;;MAEH,CACH;AAGD,WAAO,QACL,OAAO,QAAQ,QAAQ;KACrB,MAAM;KACN,aAAa,mBAAmB;KAChC,SAAS,mBAAmB;KAC7B,CAAC,CACH;;GAEH,cAAc,eAAe,WAAW;AACtC,WAAO,QACL,OAAO,QAAQ,QAAQ;KACrB,MAAM;KACN;KACA;KACD,CAAC,CACH;;GAEJ,CAAC;EAIF,MAAMA,WAA6B;GACjC,UAAU;GACV;GACA,UALe,OAAO,IAAI,KAAK,EAAE;GAMlC;AAGD,SAAO,IAAI,OAAO,YAAY,QAC5B,QAAQ,IAAI,KAAK,YAAY,SAAS,CACvC;AAED,SAAO;GACP;CAGJ,MAAM,UACJ,YACA,gBAEA,OAAO,IAAI,aAAa;AAGtB,UAFiB,OAAO,oBAAoB,WAAW,EAC/B,SAAS,OAAO,YAAY;GAEpD;CAGJ,MAAM,eACJ,eAEA,OAAO,IAAI,aAAa;AAGtB,UAFiB,OAAO,oBAAoB,WAAW,EAC7B,SAAS,aAAa;GAEhD;CAGJ,MAAM,aACJ,eAMA,OAAO,IAAI,aAAa;EACtB,MAAM,WAAW,OAAO,oBAAoB,WAAW;EAGvD,MAAM,QAAQ,OAAO,OAAO,UAAU,SAAS,OAAO;AAGtD,SAAO,OAAO,mBACZ,OAAO,IAAI,aAAa;AAER,UAAO,IAAI,aACvB,SAAS,WACR,MAAM,IAAI,EACZ;IAID,CACH;AAGD,SAAO,OAAO,UAAU,MAAM;GAC9B;AAQJ,QANiC;EAC/B;EACA;EACA;EACD;EAGD;;;;;AAMF,MAAaC,QAIT,MAAM,OAAO,oBAAoB,oBAAoB"}
+{"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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"}

package/dist/Errors.cjs

@@ -0,0 +1,45 @@
+let effect = require("effect");
+
+//#region src/Errors.ts
+/**
+* @voidhash/mimic-effect - Error Types
+*
+* All error types used throughout the mimic-effect package.
+*/
+/**
+* Error when ColdStorage (snapshot storage) operations fail
+*/
+var ColdStorageError = class extends effect.Data.TaggedError("ColdStorageError") {};
+/**
+* Error when HotStorage (WAL storage) operations fail
+*/
+var HotStorageError = class extends effect.Data.TaggedError("HotStorageError") {};
+/**
+* Error when authentication fails (invalid token, expired, etc.)
+*/
+var AuthenticationError = class extends effect.Data.TaggedError("AuthenticationError") {};
+/**
+* Error when authorization fails (user doesn't have required permission)
+*/
+var AuthorizationError = class extends effect.Data.TaggedError("AuthorizationError") {};
+/**
+* Error when document ID is missing from WebSocket request path
+*/
+var MissingDocumentIdError = class extends effect.Data.TaggedError("MissingDocumentIdError") {};
+/**
+* Error when WebSocket message cannot be parsed
+*/
+var MessageParseError = class extends effect.Data.TaggedError("MessageParseError") {};
+/**
+* Error when a transaction is rejected by the document
+*/
+var TransactionRejectedError = class extends effect.Data.TaggedError("TransactionRejectedError") {};
+
+//#endregion
+exports.AuthenticationError = AuthenticationError;
+exports.AuthorizationError = AuthorizationError;
+exports.ColdStorageError = ColdStorageError;
+exports.HotStorageError = HotStorageError;
+exports.MessageParseError = MessageParseError;
+exports.MissingDocumentIdError = MissingDocumentIdError;
+exports.TransactionRejectedError = TransactionRejectedError;

package/dist/Errors.d.cts

@@ -0,0 +1,81 @@
+import * as effect_Types0 from "effect/Types";
+import * as effect_Cause0 from "effect/Cause";
+
+//#region src/Errors.d.ts
+declare const ColdStorageError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "ColdStorageError";
+} & Readonly<A>;
+/**
+ * Error when ColdStorage (snapshot storage) operations fail
+ */
+declare class ColdStorageError extends ColdStorageError_base<{
+  readonly documentId: string;
+  readonly operation: "load" | "save" | "delete";
+  readonly cause: unknown;
+}> {}
+declare const HotStorageError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "HotStorageError";
+} & Readonly<A>;
+/**
+ * Error when HotStorage (WAL storage) operations fail
+ */
+declare class HotStorageError extends HotStorageError_base<{
+  readonly documentId: string;
+  readonly operation: "append" | "getEntries" | "truncate";
+  readonly cause: unknown;
+}> {}
+declare const AuthenticationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "AuthenticationError";
+} & Readonly<A>;
+/**
+ * Error when authentication fails (invalid token, expired, etc.)
+ */
+declare class AuthenticationError extends AuthenticationError_base<{
+  readonly reason: string;
+}> {}
+declare const AuthorizationError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "AuthorizationError";
+} & Readonly<A>;
+/**
+ * Error when authorization fails (user doesn't have required permission)
+ */
+declare class AuthorizationError extends AuthorizationError_base<{
+  readonly reason: string;
+  readonly required: "read" | "write";
+  readonly actual: "read" | "write";
+}> {}
+declare const MissingDocumentIdError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "MissingDocumentIdError";
+} & Readonly<A>;
+/**
+ * Error when document ID is missing from WebSocket request path
+ */
+declare class MissingDocumentIdError extends MissingDocumentIdError_base<{
+  readonly path: string;
+}> {}
+declare const MessageParseError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "MessageParseError";
+} & Readonly<A>;
+/**
+ * Error when WebSocket message cannot be parsed
+ */
+declare class MessageParseError extends MessageParseError_base<{
+  readonly cause: unknown;
+}> {}
+declare const TransactionRejectedError_base: new <A extends Record<string, any> = {}>(args: effect_Types0.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }) => effect_Cause0.YieldableError & {
+  readonly _tag: "TransactionRejectedError";
+} & Readonly<A>;
+/**
+ * Error when a transaction is rejected by the document
+ */
+declare class TransactionRejectedError extends TransactionRejectedError_base<{
+  readonly transactionId: string;
+  readonly reason: string;
+}> {}
+/**
+ * Union of all mimic-effect errors
+ */
+type MimicError = ColdStorageError | HotStorageError | AuthenticationError | AuthorizationError | MissingDocumentIdError | MessageParseError | TransactionRejectedError;
+//#endregion
+export { AuthenticationError, AuthorizationError, ColdStorageError, HotStorageError, MessageParseError, MimicError, MissingDocumentIdError, TransactionRejectedError };
+//# sourceMappingURL=Errors.d.cts.map

package/dist/Errors.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Errors.d.cts","names":[],"sources":["../src/Errors.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAca,gBAAA,SAAyB;;;;;cAIjC;;;;;AAJL;AAIK,cAKQ,eAAA,SAAwB,oBALhC,CAAA;;;;;cASA;;;;;;cASQ,mBAAA,SAA4B;EAb5B,SAAA,MAAA,EAAA,MAAgB;AAIxB,CAAA,CAAA,CAAA;cAaA;;;;;;cAKQ,kBAAA,SAA2B;;;;;AALnC,cASA,2BATA,EAAA,IAAA,CAAA,gBAAA,CAAA,MAAA,EAAA,GAAA,CAAA,GAAA,CAAA,CAAA,CAAA,CAAA,IAAA,sBAAA,EAAA,EAAA,CAAA,CAAA,CAAA,SAAA,IAAA,GAAA,IAAA,GAAA,iBAAA,OAAA,KAAA,SAAA,MAAA,GAAA,KAAA,IAAA,IAAA,EAAA,CAAA,EAAA,EAAA,kCAAA;;;;;;cAkBQ,sBAAA,SAA+B;;;cAIvC;;;AAjBL;AAIK;;cAkBQ,iBAAA,SAA0B;;;cAElC;;;;;;cASQ,wBAAA,SAAiC;EApBjC,SAAA,aAAA,EAAA,MAAuB;EAI/B,SAAA,MAAA,EAAA,MAAA;;;;;KA8BO,UAAA,GACR,mBACA,kBACA,sBACA,qBACA,yBACA,oBACA"}